Module agent 

Structs

RetainedContextSnapshot

Provider-facing context captured at a trim boundary. This remains attached to the internal turn event so the serial RPC consumer can persist it before forwarding the public trim notice without borrowing the live agent again.

ToolArtifact

Structured metadata for a tool that produced a file artifact (e.g. deliver_file). Carried on TurnEvent::ToolResult so a channel attaches the file from typed fields instead of parsing a text trailer out of the free-form output string. Trailer parsing let a crafted filename forge the delivered path (arbitrary-file-read / confused-deputy class).

Enums

BudgetWarningPeriod

The cost-limit period a TurnEvent::BudgetWarning refers to.

TokenCountSource

Provenance of a token count carried on a history-trim event. Lets clients distinguish provider-reported usage from a local estimate and from a mix of the two (the reported-budget trim path scales an estimate to a provider-reported figure).

TurnEvent