Crate cookie_agent_engine 

The transport-free single-conversation cookie agent runtime.

Modules

actor

Long-lived per-session mailbox actors.

delegation_events

Durable delegation state projected from parent-session events.

events

Buffered/durable session event logs and ephemeral tool-output hubs.

grant_journal

Durable exact tree-grant invalidations committed before mutations execute.

permissions

Permission evaluation over immutable prepared-operation manifests.

session

Session directories, projections, and rebuildable metadata caches.

Structs

AgentMessageHandle

The send_message result contract: success means the message is durably accepted (ProducerMessageAccepted persisted in the recipient’s event log), not that the recipient has consumed it.

AgentMessageInvocation

Immutable arguments for one send_message tool invocation. The sender triple is engine-derived tool context, never model arguments.

ApprovalRespondFailure

Atomic, secret-safe rejection details produced by the serialized approval transaction.

ArtifactReadPage

DelegateAwait

A delegate wait that cancels its child if its consumer abandons the wait.

DelegateHandle

Stable child identity returned to the delegate tool provider.

DelegateInvocation

Immutable arguments for one delegate-tool invocation.

Engine

Cloneable in-process engine handle. It contains no transport concerns and is safe for tool providers to call while their parent call is executing.

EngineOptions

McpRegistry

McpServerStatus

PersistedToolResult

PluginRegistry

PluginStatus

PreparedSerializationKey

PreparedTool

ProgressSink

PromptSection

One labeled system-prompt section contributed by a tool provider.

PublishedRuntime

Exact executable and wire state published as one atomic value.

SessionToolContext

SkillInvocation

StdinWrite

ToolCall

ToolCompletion

Completion supplies output once, or explicitly finalizes already accepted deltas.

ToolExecutionContext

ToolPreparationContext

ToolProgress

ToolSpec

ToolStdin

TurnAgentContext

Immutable harness context captured for one tool preparation/execution batch.

Enums

AgentRecipientState

Recipient state observed at send time. Delivery mode is never coerced: the requested mode stays effective in every state (safe-boundary admission covers running recipients, claim-at-start covers queued ones, and the post-send producer reconcile wakes idle or finished ones).

AttachmentGate

EngineError

EngineEvent

EngineHistoryView

Selects the history projection returned by Engine::get_history.

McpServerState

PluginState

SubagentScope

Stable send_message:<code> error strings carried by EngineError::Messaging. The tool layer surfaces them verbatim so sending models can react predictably (retry, back off, or give up). The addressable set a reference resolves against. send_message reaches every peer in the tree; the subagent-result/cancel/resume tools only reach the caller’s own direct children, matching their ownership checks.

ToolConcurrency

Declares whether calls to a tool may overlap with sibling calls from one model turn.

ToolError

ToolResultTruncationPolicy

Constants

MESSAGE_DISABLED

Stable send_message:<code> error codes carried by EngineError::Messaging. The tool layer surfaces these strings verbatim so sending models can react predictably (retry, give up, or report).

MESSAGE_ENGINE_SHUTDOWN

MESSAGE_INBOX_FULL

MESSAGE_INFLIGHT_FULL

MESSAGE_INVALID_ARGUMENTS

MESSAGE_INVALID_BODY

MESSAGE_MAX_HOPS_EXCEEDED

MESSAGE_NOT_TREE_PEER

MESSAGE_SELF_SEND

MESSAGE_UNKNOWN_SESSION

Traits

PreparedExecutor

ToolProvider

Functions

approved_media_type

attachment_gate_error

gate_attachment