Expand description
Session-scoped artifact metadata.
Large tool outputs are written under the owning session directory and saved sessions keep a durable metadata index for resume/listing flows.
Structs§
Enums§
Constants§
Functions§
- artifact_
id_ for_ tool_ call - artifact_
sessions_ root - The root every session artifact is written under. Readers that serve
artifacts by a recorded reference resolve through this same function, so
a configured Runtime
sessions_dircan never point a read at a different tree than the writer used. - format_
artifact_ relative_ path - format_
byte_ size - is_
valid_ session_ id - open_
session_ relative - The same confined session directory for mutable sidecars and immutable artifacts. The saved-session owner remains responsible for session state.
- record_
tool_ output_ artifact - record_
tool_ output_ artifact_ with_ size - session_
artifact_ absolute_ path - The recorded spelling of a session artifact path: for receipts, metadata
and display, not for opening. It is built from the state root as spelled
(a user may have relocated that root behind a link), so an opener must go
through
open_session_relativeinstead of this value; readers that do consume it compare canonicalized forms. - session_
artifact_ relative_ path - write_
session_ artifact - write_
session_ artifact_ bytes - Write arbitrary fetched bytes into a session artifact with a validated extension. Media fetches use this after magic-byte validation.
- write_
session_ artifact_ immutable - write_
session_ artifact_ immutable_ from_ reader - write_
session_ relative_ immutable - Publish immutable session-owned bytes without replacing an earlier handle. A duplicate replay with identical bytes is idempotent; a different payload for the same relative path fails closed.