Interface NewSessionRequest

Creates a new conversation session with the agent.

Sessions represent independent conversation contexts with their own history and state.

The agent should:

May return an auth_required error if the agent requires authentication.

See protocol docs: Session Setup

interface NewSessionRequest {
    _meta?: { [k: string]: unknown };
    cwd: string;
    mcpServers: McpServer[];
}

Properties

_meta?: { [k: string]: unknown }

Extension point for implementations

cwd: string

The working directory for this session. Must be an absolute path.

mcpServers: McpServer[]

List of MCP (Model Context Protocol) servers the agent should connect to.