Module session 

Agent sessions (ACP) methods + supporting types.

Ported from packages/core/src/agent-os.ts (session methods), agent-session-types.ts (session/mode/config/capability/permission types), and agents.ts (AgentType, AgentConfig).

ACP = JSON-RPC 2.0 over stdio. Sessions are referenced by string ID and return JSON-serializable data only. JSON-RPC errors are NOT Rust Err; methods that issue requests return a JsonRpcResponse whose error field may be set.

Structs

AgentCapabilities

Agent capabilities (all optional booleans + prompt capabilities + extras).

AgentInfo

Agent info ({ name; title?; version?; [k]: unknown }).

AgentRegistryEntry

A registry agent entry from list_agents.

ConfigAllowedValue

An allowed value for a config option.

CreateSessionOptions

Options for create_session.

PermissionRequest

A permission request delivered to a subscriber. Carries a Clone-able one-shot responder.

PermissionResponder

A Clone-able one-shot responder for a permission request.

PromptCapabilities

Prompt capabilities sub-object.

PromptResult

Result of prompt.

ResumeSessionOptions

Options for resume_session. Mirrors the durability-dependent fields the sidecar fallback tier needs to re-launch the adapter, plus the transcript pointer.

ResumeSessionResult

Result of resume_session. session_id is the live ACP session id in the fresh VM: equal to the requested id for native loads, or a freshly assigned id for the fallback tier — the caller (e.g. the actor) remaps external -> live. mode is "native" or "fallback".

SessionConfigOption

A session config option.

SessionId

The id returned by create_session.

SessionInfo

In-memory session registry entry summary.

SessionInitData

Initial hydration data for a session.

SessionMode

A single session mode ({ id; name?; label?; description?; [k]: unknown }).

SessionModeState

Session mode state ({ currentModeId; availableModes }).

Enums

McpServerConfig

MCP server config used by create_session.

PermissionReply

A permission reply.

Type Aliases

PermissionRequestStream

PermissionRequestSubscription

SessionEventStream

SessionEventSubscription