Module attachments

Structs§

AttachmentReclamationReport: Outcome of a host-invoked unreferenced-attachment reclamation sweep.
FileAttachmentStore
InMemoryAttachmentStore
NoopAttachmentManifest: No-op AttachmentManifest for ephemeral facades: records nothing, imposes no boundary guard (holds_ref returns true), and exposes no refs. The backend is the sole source of truth for these runtimes.
SessionAttachmentStore: The concrete, session-bound facade over a flat AttachmentStore backend — the only attachment surface the runtime and its consumers ever see.
StoredAttachment
StoredBlobRef: One blob enumerated by AttachmentStore::list. Feeds mark-and-sweep GC: the sweeper pairs each blob’s id against the live root set and uses last_modified_epoch_ms to apply the write grace period. Backends that cannot report a modification time leave it None, and the sweep treats such blobs as always past the grace window.

AttachmentRootSet: A source of the live attachment root set: every attachment ref (intent or committed) across ALL sessions a store factory owns. Intents count as refs, so an in-flight write is never mistaken for garbage.
AttachmentStore: A flat, content-addressed blob store: host-supplied dumb infrastructure.

content_id
reclaim_unreferenced_attachments: Mark-and-sweep GC for attachment blobs — the host-invocable counterpart to StoreMaintenance::gc_unreachable for attachment payloads.
resolve_llm_request_attachments