"""Reference shape only. Shows a tool result as a count plus an S3 key. It does not call AWS, and it does not reproduce the 17 November 2026 AWS token or latency figures. """ from dataclasses import dataclass @dataclass(frozen=True) class ArtifactRef: key: str item_count: int def page_for_model(ref: ArtifactRef) -> dict[str, int | str]: if ref.item_count < 0: raise ValueError("item_count must be zero or greater") if not ref.key: raise ValueError("key is required") return {"item_count": ref.item_count, "artifact_key": ref.key}