Expand description
Artifact spill storage and the shared inline output budget.
Re-exported from agent_sdk_tools::artifacts.
Structs§
- Artifact
Quota Exceeded - Typed admission failure: the per-thread artifact byte quota cannot admit the payload. Downcast this from an error chain to distinguish a durable resource-limit rejection from transient I/O failures.
- Artifact
Retention Policy - Deterministic per-thread expiry and quota policy.
- Artifact
Retention Snapshot - Durable liveness and reference snapshot supplied by the host.
- Artifact
Storage - Process-wide multiplexer handing out one
ArtifactStoreper active thread. - Artifact
Store - Per-thread spill store for oversized tool output.
- Artifact
Sweep Fence - Existing artifact directories fenced before the host reads durable liveness.
- Artifact
Sweep Report - Observable outcome of one artifact retention sweep.
- Artifact
Thread Retention - Per-thread facts that make artifacts ineligible for retention.
- Saved
Artifact - A spilled artifact: its store-local ID and the backing file.
Constants§
- ARTIFACT_
URI_ SCHEME - URI scheme under which spilled artifacts are addressable.
- DEFAULT_
INLINE_ OUTPUT_ BUDGET_ BYTES - A tool result whose output plus serialized auxiliary payload exceeds this many bytes is spilled to the artifact store.
Functions§
- artifact_
footer - The recovery footer spliced into a capped inline result.
- artifact_
thread_ key - Stable directory key used by
ArtifactStorageand host retention snapshots. - artifact_
uri - Recovery URI for a spilled artifact.
- canonical_
inline_ output_ matches - Compare a legacy inline spill boundary with the durable artifact without buffering or scanning the artifact body.
- canonical_
streamed_ inline_ output_ matches - Compare the bounded output produced by
cap_inline_from_windowswith its durable artifact while reading only bounded head and tail windows. - cap_
inline_ from_ windows - Render already-captured head and tail windows with the canonical footer.
- cap_
inline_ output - Bounded inline replacement for an over-budget output: head + elision
marker + tail + recovery footer, all within
budgetbytes. - enforce_
inline_ budget - Enforce the shared tool-result payload budget with a truthful bounded fail-closed result when lossless artifact persistence is unavailable.