Module advanced 

Server- and host-facing contract types.

These types are not needed by a typical in-process agent. They form the authoritative boundary that agent-server / agent-service-host build on: per-turn outcome and summary contracts, the durable continuation envelope, the audit-record protocol, the listen/erased tool plumbing, and the worker-context reconstruction factory.

They are grouped here so that agent_sdk:: autocomplete and the docs.rs front page stay dominated by the newcomer-facing surface (see prelude). Everything here remains a stable, public re-export — moving a name into advanced is a path change, not a removal.

Structs

AgentContinuation

Continuation state that allows resuming the agent loop.

AuditProvenance

Provider / model provenance for an audit record.

ContinuationEnvelope

Versioned wrapper around AgentContinuation.

HostDependencies

Runtime dependencies created by the host when a worker is started.

ListenExecutionContext

Context captured for listen/execute tools while awaiting confirmation.

LocalEventAuthority

Default event authority for local/CLI execution.

ToolAuditRecord

Single authoritative audit record for one tool-call lifecycle event.

ToolAuditRecordParams

Arguments for building a ToolAuditRecord via ToolAuditRecord::new.

TurnSummary

Structured server-facing outcome metadata for a single turn.

Enums

ErasedToolStatus

Type-erased status for the agent loop.

ListenStopReason

Reason for stopping a listen session.

ListenToolUpdate

Update emitted from a listen() stream.

ToolAuditOutcome

Lifecycle outcome for a single tool call.

TurnOutcome

Outcome of running a single turn.

Constants

CONTINUATION_VERSION

Current envelope version.

Traits

ErasedAsyncTool

Type-erased async tool trait for registry storage.

ErasedListenTool

Type-erased listen/execute tool trait for registry storage.

ErasedTool

Type-erased tool trait for registry storage.

EventAuthority

Authority that governs how events are wrapped in envelopes.

ExecutionContextFactory

Abstraction for how hosts build a crate::tools::ToolContext from durable seeds and fresh runtime dependencies.

ListenExecuteTool

A tool whose runtime has two phases: