Skip to main content

Module agent_threads

Module agent_threads 

Source
Expand description

Shared validation for the three host-owned agent-thread stores. Storage revisions cover every status write; history revisions do not.

Structs§

CanonicalRawSegment
One named byte stream retained exactly as represented by the trusted host. A receipt’s secret_projection metadata distinguishes a projected view.
CanonicalSecretProjection
Finite host projection applied before canonical acquisition. This describes a projected view, not a claim that arbitrary secret encodings were removed.
CanonicalToolReceipt
Immutable pre-format tool result retained by the trusted host. Complete describes this represented view; secret_projection may report omitted raw streams, so completeness does not imply lossless original acquisition.
PersistedAgentThread
A thread plus its optimistic-concurrency token. Revisions start at zero.

Enums§

AgentThreadStoreError
Portable store failures. Database transport/transaction errors remain errors too, and never imply that an interrupted write did not commit.
CanonicalReceiptCompleteness
Why a canonical payload is unavailable. Missing bytes are never fabricated.
CanonicalReceiptSource
Trusted-host execution path that produced a canonical receipt.
CanonicalReceiptStoreError

Constants§

MAX_CANONICAL_RECEIPT_BYTES
Maximum retained payload for one canonical tool receipt.
MAX_CANONICAL_RUN_BYTES
Maximum retained canonical tool payload across one run.

Functions§

has_ambiguous_legacy_tool_outcomes
Historical MCP/graph responses have no reliable execution certainty. A legacy boolean failure is definite only when trusted native-only admission ownership identifies that exact invocation. Tool names are not correlation. This reads history without migrating it or granting replay authority.