mia-code 0.2.0 → 0.3.0

package/references/acp/schema.md

@@ -0,0 +1,3171 @@
+> ## Documentation Index
+> Fetch the complete documentation index at: https://agentclientprotocol.com/llms.txt
+> Use this file to discover all available pages before exploring further.
+
+# Schema
+
+> Schema definitions for the Agent Client Protocol
+
+## Agent
+
+Defines the interface that all ACP-compliant agents must implement.
+
+Agents are programs that use generative AI to autonomously modify code. They handle
+requests from clients and execute tasks using language models and tools.
+
+### <span class="font-mono">authenticate</span>
+
+Authenticates the client using the specified authentication method.
+
+Called when the agent requires authentication before allowing session creation.
+The client provides the authentication method ID that was advertised during initialization.
+
+After successful authentication, the client can proceed to create sessions with
+`new_session` without receiving an `auth_required` error.
+
+See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
+
+#### <span class="font-mono">AuthenticateRequest</span>
+
+Request parameters for the authenticate method.
+
+Specifies which authentication method to use.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="methodId" type={"string"} required>
+  The ID of the authentication method to use.
+  Must be one of the methods advertised in the initialize response.
+</ResponseField>
+
+#### <span class="font-mono">AuthenticateResponse</span>
+
+Response to the `authenticate` method.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+### <span class="font-mono">initialize</span>
+
+Establishes the connection with a client and negotiates protocol capabilities.
+
+This method is called once at the beginning of the connection to:
+
+* Negotiate the protocol version to use
+* Exchange capability information between client and agent
+* Determine available authentication methods
+
+The agent should respond with its supported protocol version and capabilities.
+
+See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
+
+#### <span class="font-mono">InitializeRequest</span>
+
+Request parameters for the initialize method.
+
+Sent by the client to establish connection and negotiate capabilities.
+
+See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="clientCapabilities" type={<a href="#clientcapabilities">ClientCapabilities</a>}>
+  Capabilities supported by the client.
+
+  * Default: `{"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false}`
+</ResponseField>
+
+<ResponseField name="clientInfo" type={<><span><a href="#implementation">Implementation</a></span><span> | null</span></>}>
+  Information about the Client name and version sent to the Agent.
+
+  Note: in future versions of the protocol, this will be required.
+</ResponseField>
+
+<ResponseField name="protocolVersion" type={<a href="#protocolversion">ProtocolVersion</a>} required>
+  The latest protocol version supported by the client.
+</ResponseField>
+
+#### <span class="font-mono">InitializeResponse</span>
+
+Response to the `initialize` method.
+
+Contains the negotiated protocol version and agent capabilities.
+
+See protocol docs: [Initialization](https://agentclientprotocol.com/protocol/initialization)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="agentCapabilities" type={<a href="#agentcapabilities">AgentCapabilities</a>}>
+  Capabilities supported by the agent.
+
+  * Default: `{"loadSession":false,"mcpCapabilities":{"http":false,"sse":false},"promptCapabilities":{"audio":false,"embeddedContext":false,"image":false},"sessionCapabilities":{}}`
+</ResponseField>
+
+<ResponseField name="agentInfo" type={<><span><a href="#implementation">Implementation</a></span><span> | null</span></>}>
+  Information about the Agent name and version sent to the Client.
+
+  Note: in future versions of the protocol, this will be required.
+</ResponseField>
+
+<ResponseField name="authMethods" type={<a href="#authmethod">AuthMethod[]</a>}>
+  Authentication methods supported by the agent.
+
+  * Default: `[]`
+</ResponseField>
+
+<ResponseField name="protocolVersion" type={<a href="#protocolversion">ProtocolVersion</a>} required>
+  The protocol version the client specified if supported by the agent,
+  or the latest protocol version supported by the agent.
+
+  The client should disconnect, if it doesn't support this version.
+</ResponseField>
+
+<a id="session-cancel" />
+
+### <span class="font-mono">session/cancel</span>
+
+Cancels ongoing operations for a session.
+
+This is a notification sent by the client to cancel an ongoing prompt turn.
+
+Upon receiving this notification, the Agent SHOULD:
+
+* Stop all language model requests as soon as possible
+* Abort all tool call invocations in progress
+* Send any pending `session/update` notifications
+* Respond to the original `session/prompt` request with `StopReason::Cancelled`
+
+See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/prompt-turn#cancellation)
+
+#### <span class="font-mono">CancelNotification</span>
+
+Notification to cancel ongoing operations for a session.
+
+See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/prompt-turn#cancellation)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The ID of the session to cancel operations for.
+</ResponseField>
+
+<a id="session-load" />
+
+### <span class="font-mono">session/load</span>
+
+Loads an existing session to resume a previous conversation.
+
+This method is only available if the agent advertises the `loadSession` capability.
+
+The agent should:
+
+* Restore the session context and conversation history
+* Connect to the specified MCP servers
+* Stream the entire conversation history back to the client via notifications
+
+See protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)
+
+#### <span class="font-mono">LoadSessionRequest</span>
+
+Request parameters for loading an existing session.
+
+Only available if the Agent supports the `loadSession` capability.
+
+See protocol docs: [Loading Sessions](https://agentclientprotocol.com/protocol/session-setup#loading-sessions)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="cwd" type={"string"} required>
+  The working directory for this session.
+</ResponseField>
+
+<ResponseField name="mcpServers" type={<a href="#mcpserver">McpServer[]</a>} required>
+  List of MCP servers to connect to for this session.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The ID of the session to load.
+</ResponseField>
+
+#### <span class="font-mono">LoadSessionResponse</span>
+
+Response from loading an existing session.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="modes" type={<><span><a href="#sessionmodestate">SessionModeState</a></span><span> | null</span></>}>
+  Initial mode state if supported by the Agent
+
+  See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+</ResponseField>
+
+<a id="session-new" />
+
+### <span class="font-mono">session/new</span>
+
+Creates a new conversation session with the agent.
+
+Sessions represent independent conversation contexts with their own history and state.
+
+The agent should:
+
+* Create a new session context
+* Connect to any specified MCP servers
+* Return a unique session ID for future requests
+
+May return an `auth_required` error if the agent requires authentication.
+
+See protocol docs: [Session Setup](https://agentclientprotocol.com/protocol/session-setup)
+
+#### <span class="font-mono">NewSessionRequest</span>
+
+Request parameters for creating a new session.
+
+See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="cwd" type={"string"} required>
+  The working directory for this session. Must be an absolute path.
+</ResponseField>
+
+<ResponseField name="mcpServers" type={<a href="#mcpserver">McpServer[]</a>} required>
+  List of MCP (Model Context Protocol) servers the agent should connect to.
+</ResponseField>
+
+#### <span class="font-mono">NewSessionResponse</span>
+
+Response from creating a new session.
+
+See protocol docs: [Creating a Session](https://agentclientprotocol.com/protocol/session-setup#creating-a-session)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="modes" type={<><span><a href="#sessionmodestate">SessionModeState</a></span><span> | null</span></>}>
+  Initial mode state if supported by the Agent
+
+  See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  Unique identifier for the created session.
+
+  Used in all subsequent requests for this conversation.
+</ResponseField>
+
+<a id="session-prompt" />
+
+### <span class="font-mono">session/prompt</span>
+
+Processes a user prompt within a session.
+
+This method handles the whole lifecycle of a prompt:
+
+* Receives user messages with optional context (files, images, etc.)
+* Processes the prompt using language models
+* Reports language model content and tool calls to the Clients
+* Requests permission to run tools
+* Executes any requested tool calls
+* Returns when the turn is complete with a stop reason
+
+See protocol docs: [Prompt Turn](https://agentclientprotocol.com/protocol/prompt-turn)
+
+#### <span class="font-mono">PromptRequest</span>
+
+Request parameters for sending a user prompt to the agent.
+
+Contains the user's message and any additional context.
+
+See protocol docs: [User Message](https://agentclientprotocol.com/protocol/prompt-turn#1-user-message)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="prompt" type={<a href="#contentblock">ContentBlock[]</a>} required>
+  The blocks of content that compose the user's message.
+
+  As a baseline, the Agent MUST support `ContentBlock::Text` and `ContentBlock::ResourceLink`,
+  while other variants are optionally enabled via `PromptCapabilities`.
+
+  The Client MUST adapt its interface according to `PromptCapabilities`.
+
+  The client MAY include referenced pieces of context as either
+  `ContentBlock::Resource` or `ContentBlock::ResourceLink`.
+
+  When available, `ContentBlock::Resource` is preferred
+  as it avoids extra round-trips and allows the message to include
+  pieces of context from sources the agent may not have access to.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The ID of the session to send this user message to
+</ResponseField>
+
+#### <span class="font-mono">PromptResponse</span>
+
+Response from processing a user prompt.
+
+See protocol docs: [Check for Completion](https://agentclientprotocol.com/protocol/prompt-turn#4-check-for-completion)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="stopReason" type={<a href="#stopreason">StopReason</a>} required>
+  Indicates why the agent stopped processing the turn.
+</ResponseField>
+
+<a id="session-set_mode" />
+
+### <span class="font-mono">session/set\_mode</span>
+
+Sets the current mode for a session.
+
+Allows switching between different agent modes (e.g., "ask", "architect", "code")
+that affect system prompts, tool availability, and permission behaviors.
+
+The mode must be one of the modes advertised in `availableModes` during session
+creation or loading. Agents may also change modes autonomously and notify the
+client via `current_mode_update` notifications.
+
+This method can be called at any time during a session, whether the Agent is
+idle or actively generating a response.
+
+See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+
+#### <span class="font-mono">SetSessionModeRequest</span>
+
+Request parameters for setting a session mode.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="modeId" type={<a href="#sessionmodeid">SessionModeId</a>} required>
+  The ID of the mode to set.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The ID of the session to set the mode for.
+</ResponseField>
+
+#### <span class="font-mono">SetSessionModeResponse</span>
+
+Response to `session/set_mode` method.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"} />
+
+## Client
+
+Defines the interface that ACP-compliant clients must implement.
+
+Clients are typically code editors (IDEs, text editors) that provide the interface
+between users and AI agents. They manage the environment, handle user interactions,
+and control access to resources.
+
+<a id="fs-read_text_file" />
+
+### <span class="font-mono">fs/read\_text\_file</span>
+
+Reads content from a text file in the client's file system.
+
+Only available if the client advertises the `fs.readTextFile` capability.
+Allows the agent to access file contents within the client's environment.
+
+See protocol docs: [Client](https://agentclientprotocol.com/protocol/overview#client)
+
+#### <span class="font-mono">ReadTextFileRequest</span>
+
+Request to read content from a text file.
+
+Only available if the client supports the `fs.readTextFile` capability.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="limit" type={"integer | null"}>
+  Maximum number of lines to read.
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="line" type={"integer | null"}>
+  Line number to start reading from (1-based).
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="path" type={"string"} required>
+  Absolute path to the file to read.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+#### <span class="font-mono">ReadTextFileResponse</span>
+
+Response containing the contents of a text file.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={"string"} required />
+
+<a id="fs-write_text_file" />
+
+### <span class="font-mono">fs/write\_text\_file</span>
+
+Writes content to a text file in the client's file system.
+
+Only available if the client advertises the `fs.writeTextFile` capability.
+Allows the agent to create or modify files within the client's environment.
+
+See protocol docs: [Client](https://agentclientprotocol.com/protocol/overview#client)
+
+#### <span class="font-mono">WriteTextFileRequest</span>
+
+Request to write content to a text file.
+
+Only available if the client supports the `fs.writeTextFile` capability.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={"string"} required>
+  The text content to write to the file.
+</ResponseField>
+
+<ResponseField name="path" type={"string"} required>
+  Absolute path to the file to write.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+#### <span class="font-mono">WriteTextFileResponse</span>
+
+Response to `fs/write_text_file`
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<a id="session-request_permission" />
+
+### <span class="font-mono">session/request\_permission</span>
+
+Requests permission from the user for a tool call operation.
+
+Called by the agent when it needs user authorization before executing
+a potentially sensitive operation. The client should present the options
+to the user and return their decision.
+
+If the client cancels the prompt turn via `session/cancel`, it MUST
+respond to this request with `RequestPermissionOutcome::Cancelled`.
+
+See protocol docs: [Requesting Permission](https://agentclientprotocol.com/protocol/tool-calls#requesting-permission)
+
+#### <span class="font-mono">RequestPermissionRequest</span>
+
+Request for user permission to execute a tool call.
+
+Sent when the agent needs authorization before performing a sensitive operation.
+
+See protocol docs: [Requesting Permission](https://agentclientprotocol.com/protocol/tool-calls#requesting-permission)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="options" type={<a href="#permissionoption">PermissionOption[]</a>} required>
+  Available permission options for the user to choose from.
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+<ResponseField name="toolCall" type={<a href="#toolcallupdate">ToolCallUpdate</a>} required>
+  Details about the tool call requiring permission.
+</ResponseField>
+
+#### <span class="font-mono">RequestPermissionResponse</span>
+
+Response to a permission request.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="outcome" type={<a href="#requestpermissionoutcome">RequestPermissionOutcome</a>} required>
+  The user's decision on the permission request.
+</ResponseField>
+
+<a id="session-update" />
+
+### <span class="font-mono">session/update</span>
+
+Handles session update notifications from the agent.
+
+This is a notification endpoint (no response expected) that receives
+real-time updates about session progress, including message chunks,
+tool calls, and execution plans.
+
+Note: Clients SHOULD continue accepting tool call updates even after
+sending a `session/cancel` notification, as the agent may send final
+updates before responding with the cancelled stop reason.
+
+See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-turn#3-agent-reports-output)
+
+#### <span class="font-mono">SessionNotification</span>
+
+Notification containing a session update from the agent.
+
+Used to stream real-time progress and results during prompt processing.
+
+See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-turn#3-agent-reports-output)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The ID of the session this update pertains to.
+</ResponseField>
+
+<ResponseField name="update" type={<a href="#sessionupdate">SessionUpdate</a>} required>
+  The actual update content.
+</ResponseField>
+
+<a id="terminal-create" />
+
+### <span class="font-mono">terminal/create</span>
+
+Executes a command in a new terminal
+
+Only available if the `terminal` Client capability is set to `true`.
+
+Returns a `TerminalId` that can be used with other terminal methods
+to get the current output, wait for exit, and kill the command.
+
+The `TerminalId` can also be used to embed the terminal in a tool call
+by using the `ToolCallContent::Terminal` variant.
+
+The Agent is responsible for releasing the terminal by using the `terminal/release`
+method.
+
+See protocol docs: [Terminals](https://agentclientprotocol.com/protocol/terminals)
+
+#### <span class="font-mono">CreateTerminalRequest</span>
+
+Request to create a new terminal and execute a command.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="args" type={<><span>"string"</span><span>[]</span></>}>
+  Array of command arguments.
+</ResponseField>
+
+<ResponseField name="command" type={"string"} required>
+  The command to execute.
+</ResponseField>
+
+<ResponseField name="cwd" type={"string | null"}>
+  Working directory for the command (absolute path).
+</ResponseField>
+
+<ResponseField name="env" type={<a href="#envvariable">EnvVariable[]</a>}>
+  Environment variables for the command.
+</ResponseField>
+
+<ResponseField name="outputByteLimit" type={"integer | null"}>
+  Maximum number of output bytes to retain.
+
+  When the limit is exceeded, the Client truncates from the beginning of the output
+  to stay within the limit.
+
+  The Client MUST ensure truncation happens at a character boundary to maintain valid
+  string output, even if this means the retained output is slightly less than the
+  specified limit.
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+#### <span class="font-mono">CreateTerminalResponse</span>
+
+Response containing the ID of the created terminal.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required>
+  The unique identifier for the created terminal.
+</ResponseField>
+
+<a id="terminal-kill" />
+
+### <span class="font-mono">terminal/kill</span>
+
+Kills the terminal command without releasing the terminal
+
+While `terminal/release` will also kill the command, this method will keep
+the `TerminalId` valid so it can be used with other methods.
+
+This method can be helpful when implementing command timeouts which terminate
+the command as soon as elapsed, and then get the final output so it can be sent
+to the model.
+
+Note: `terminal/release` when `TerminalId` is no longer needed.
+
+See protocol docs: [Terminals](https://agentclientprotocol.com/protocol/terminals)
+
+#### <span class="font-mono">KillTerminalCommandRequest</span>
+
+Request to kill a terminal command without releasing the terminal.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required>
+  The ID of the terminal to kill.
+</ResponseField>
+
+#### <span class="font-mono">KillTerminalCommandResponse</span>
+
+Response to terminal/kill command method
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<a id="terminal-output" />
+
+### <span class="font-mono">terminal/output</span>
+
+Gets the terminal output and exit status
+
+Returns the current content in the terminal without waiting for the command to exit.
+If the command has already exited, the exit status is included.
+
+See protocol docs: [Terminals](https://agentclientprotocol.com/protocol/terminals)
+
+#### <span class="font-mono">TerminalOutputRequest</span>
+
+Request to get the current output and status of a terminal.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required>
+  The ID of the terminal to get output from.
+</ResponseField>
+
+#### <span class="font-mono">TerminalOutputResponse</span>
+
+Response containing the terminal output and exit status.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="exitStatus" type={<><span><a href="#terminalexitstatus">TerminalExitStatus</a></span><span> | null</span></>}>
+  Exit status if the command has completed.
+</ResponseField>
+
+<ResponseField name="output" type={"string"} required>
+  The terminal output captured so far.
+</ResponseField>
+
+<ResponseField name="truncated" type={"boolean"} required>
+  Whether the output was truncated due to byte limits.
+</ResponseField>
+
+<a id="terminal-release" />
+
+### <span class="font-mono">terminal/release</span>
+
+Releases a terminal
+
+The command is killed if it hasn't exited yet. Use `terminal/wait_for_exit`
+to wait for the command to exit before releasing the terminal.
+
+After release, the `TerminalId` can no longer be used with other `terminal/*` methods,
+but tool calls that already contain it, continue to display its output.
+
+The `terminal/kill` method can be used to terminate the command without releasing
+the terminal, allowing the Agent to call `terminal/output` and other methods.
+
+See protocol docs: [Terminals](https://agentclientprotocol.com/protocol/terminals)
+
+#### <span class="font-mono">ReleaseTerminalRequest</span>
+
+Request to release a terminal and free its resources.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required>
+  The ID of the terminal to release.
+</ResponseField>
+
+#### <span class="font-mono">ReleaseTerminalResponse</span>
+
+Response to terminal/release method
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<a id="terminal-wait_for_exit" />
+
+### <span class="font-mono">terminal/wait\_for\_exit</span>
+
+Waits for the terminal command to exit and return its exit status
+
+See protocol docs: [Terminals](https://agentclientprotocol.com/protocol/terminals)
+
+#### <span class="font-mono">WaitForTerminalExitRequest</span>
+
+Request to wait for a terminal command to exit.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="sessionId" type={<a href="#sessionid">SessionId</a>} required>
+  The session ID for this request.
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required>
+  The ID of the terminal to wait for.
+</ResponseField>
+
+#### <span class="font-mono">WaitForTerminalExitResponse</span>
+
+Response containing the exit status of a terminal command.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="exitCode" type={"integer | null"}>
+  The process exit code (may be null if terminated by signal).
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="signal" type={"string | null"}>
+  The signal that terminated the process (may be null if exited normally).
+</ResponseField>
+
+## <span class="font-mono">AgentCapabilities</span>
+
+Capabilities supported by the agent.
+
+Advertised during initialization to inform the client about
+available features and content types.
+
+See protocol docs: [Agent Capabilities](https://agentclientprotocol.com/protocol/initialization#agent-capabilities)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="loadSession" type={"boolean"}>
+  Whether the agent supports `session/load`.
+
+  * Default: `false`
+</ResponseField>
+
+<ResponseField name="mcpCapabilities" type={<a href="#mcpcapabilities">McpCapabilities</a>}>
+  MCP capabilities supported by the agent.
+
+  * Default: `{"http":false,"sse":false}`
+</ResponseField>
+
+<ResponseField name="promptCapabilities" type={<a href="#promptcapabilities">PromptCapabilities</a>}>
+  Prompt capabilities supported by the agent.
+
+  * Default: `{"audio":false,"embeddedContext":false,"image":false}`
+</ResponseField>
+
+<ResponseField name="sessionCapabilities" type={<a href="#sessioncapabilities">SessionCapabilities</a>}>
+  * Default: `{}`
+</ResponseField>
+
+## <span class="font-mono">Annotations</span>
+
+Optional annotations for the client. The client can use annotations to inform how objects are used or displayed
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="audience" type={<><span><a href="#role">Role[]</a></span><span> | null</span></>} />
+
+<ResponseField name="lastModified" type={"string | null"} />
+
+<ResponseField name="priority" type={"number | null"} />
+
+## <span class="font-mono">AudioContent</span>
+
+Audio provided to or from an LLM.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+<ResponseField name="data" type={"string"} required />
+
+<ResponseField name="mimeType" type={"string"} required />
+
+## <span class="font-mono">AuthMethod</span>
+
+Describes an available authentication method.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="description" type={"string | null"}>
+  Optional description providing more details about this authentication method.
+</ResponseField>
+
+<ResponseField name="id" type={"string"} required>
+  Unique identifier for this authentication method.
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Human-readable name of the authentication method.
+</ResponseField>
+
+## <span class="font-mono">AvailableCommand</span>
+
+Information about a command.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="description" type={"string"} required>
+  Human-readable description of what the command does.
+</ResponseField>
+
+<ResponseField name="input" type={<><span><a href="#availablecommandinput">AvailableCommandInput</a></span><span> | null</span></>}>
+  Input for the command if required
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Command name (e.g., `create_plan`, `research_codebase`).
+</ResponseField>
+
+## <span class="font-mono">AvailableCommandInput</span>
+
+The input specification for a command.
+
+**Type:** Union
+
+<ResponseField name="unstructured">
+  All text that was typed after the command name is provided as input.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="hint" type={"string"} required>
+      A hint to display when the input hasn't been provided yet
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">AvailableCommandsUpdate</span>
+
+Available commands are ready or have changed
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="availableCommands" type={<a href="#availablecommand">AvailableCommand[]</a>} required>
+  Commands the agent can execute
+</ResponseField>
+
+## <span class="font-mono">BlobResourceContents</span>
+
+Binary resource contents.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="blob" type={"string"} required />
+
+<ResponseField name="mimeType" type={"string | null"} />
+
+<ResponseField name="uri" type={"string"} required />
+
+## <span class="font-mono">ClientCapabilities</span>
+
+Capabilities supported by the client.
+
+Advertised during initialization to inform the agent about
+available features and methods.
+
+See protocol docs: [Client Capabilities](https://agentclientprotocol.com/protocol/initialization#client-capabilities)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="fs" type={<a href="#filesystemcapability">FileSystemCapability</a>}>
+  File system capabilities supported by the client.
+  Determines which file operations the agent can request.
+
+  * Default: `{"readTextFile":false,"writeTextFile":false}`
+</ResponseField>
+
+<ResponseField name="terminal" type={"boolean"}>
+  Whether the Client support all `terminal/*` methods.
+
+  * Default: `false`
+</ResponseField>
+
+## <span class="font-mono">Content</span>
+
+Standard content block (text, images, resources).
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+  The actual content block.
+</ResponseField>
+
+## <span class="font-mono">ContentBlock</span>
+
+Content blocks represent displayable information in the Agent Client Protocol.
+
+They provide a structured way to handle various types of user-facing content—whether
+it's text from language models, images for analysis, or embedded resources for context.
+
+Content blocks appear in:
+
+* User prompts sent via `session/prompt`
+* Language model output streamed through `session/update` notifications
+* Progress updates and results from tool calls
+
+This structure is compatible with the Model Context Protocol (MCP), enabling
+agents to seamlessly forward content from MCP tool outputs without transformation.
+
+See protocol docs: [Content](https://agentclientprotocol.com/protocol/content)
+
+**Type:** Union
+
+<ResponseField name="text" type="object">
+  Text content. May be plain text or formatted with Markdown.
+
+  All agents MUST support text content blocks in prompts.
+  Clients SHOULD render this text as Markdown.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+    <ResponseField name="text" type={"string"} required />
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="image" type="object">
+  Images for visual context or analysis.
+
+  Requires the `image` prompt capability when included in prompts.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+    <ResponseField name="data" type={"string"} required />
+
+    <ResponseField name="mimeType" type={"string"} required />
+
+    <ResponseField name="type" type={"string"} required />
+
+    <ResponseField name="uri" type={"string | null"} />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="audio" type="object">
+  Audio data for transcription or analysis.
+
+  Requires the `audio` prompt capability when included in prompts.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+    <ResponseField name="data" type={"string"} required />
+
+    <ResponseField name="mimeType" type={"string"} required />
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="resource_link" type="object">
+  References to resources that the agent can access.
+
+  All agents MUST support resource links in prompts.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+    <ResponseField name="description" type={"string | null"} />
+
+    <ResponseField name="mimeType" type={"string | null"} />
+
+    <ResponseField name="name" type={"string"} required />
+
+    <ResponseField name="size" type={"integer | null"} />
+
+    <ResponseField name="title" type={"string | null"} />
+
+    <ResponseField name="type" type={"string"} required />
+
+    <ResponseField name="uri" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="resource" type="object">
+  Complete resource contents embedded directly in the message.
+
+  Preferred for including context as it avoids extra round-trips.
+
+  Requires the `embeddedContext` prompt capability when included in prompts.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+    <ResponseField name="resource" type={<a href="#embeddedresourceresource">EmbeddedResourceResource</a>} required />
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">ContentChunk</span>
+
+A streamed item of content
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+  A single item of content
+</ResponseField>
+
+## <span class="font-mono">CurrentModeUpdate</span>
+
+The current mode of the session has changed
+
+See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="currentModeId" type={<a href="#sessionmodeid">SessionModeId</a>} required>
+  The ID of the current mode
+</ResponseField>
+
+## <span class="font-mono">Diff</span>
+
+A diff representing file modifications.
+
+Shows changes to files in a format suitable for display in the client UI.
+
+See protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="newText" type={"string"} required>
+  The new content after modification.
+</ResponseField>
+
+<ResponseField name="oldText" type={"string | null"}>
+  The original content (None for new files).
+</ResponseField>
+
+<ResponseField name="path" type={"string"} required>
+  The file path being modified.
+</ResponseField>
+
+## <span class="font-mono">EmbeddedResource</span>
+
+The contents of a resource, embedded into a prompt or tool call result.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+<ResponseField name="resource" type={<a href="#embeddedresourceresource">EmbeddedResourceResource</a>} required />
+
+## <span class="font-mono">EmbeddedResourceResource</span>
+
+Resource content that can be embedded in a message.
+
+**Type:** Union
+
+<ResponseField name="TextResourceContents">
+  {""}
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="mimeType" type={"string | null"} />
+
+    <ResponseField name="text" type={"string"} required />
+
+    <ResponseField name="uri" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="BlobResourceContents">
+  {""}
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="blob" type={"string"} required />
+
+    <ResponseField name="mimeType" type={"string | null"} />
+
+    <ResponseField name="uri" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">EnvVariable</span>
+
+An environment variable to set when launching an MCP server.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  The name of the environment variable.
+</ResponseField>
+
+<ResponseField name="value" type={"string"} required>
+  The value to set for the environment variable.
+</ResponseField>
+
+## <span class="font-mono">Error</span>
+
+JSON-RPC error object.
+
+Represents an error that occurred during method execution, following the
+JSON-RPC 2.0 error object specification with optional additional data.
+
+See protocol docs: [JSON-RPC Error Object](https://www.jsonrpc.org/specification#error_object)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="code" type={<a href="#errorcode">ErrorCode</a>} required>
+  A number indicating the error type that occurred. This must be an integer as
+  defined in the JSON-RPC specification.
+</ResponseField>
+
+<ResponseField name="data" type={"object"}>
+  Optional primitive or structured value that contains additional information
+  about the error. This may include debugging information or context-specific
+  details.
+</ResponseField>
+
+<ResponseField name="message" type={"string"} required>
+  A string providing a short description of the error. The message should be
+  limited to a concise single sentence.
+</ResponseField>
+
+## <span class="font-mono">ErrorCode</span>
+
+Predefined error codes for common JSON-RPC and ACP-specific errors.
+
+These codes follow the JSON-RPC 2.0 specification for standard errors
+and use the reserved range (-32000 to -32099) for protocol-specific errors.
+
+**Type:** Union
+
+<ResponseField name="-32700" type="int32">
+  **Parse error**: Invalid JSON was received by the server. An error occurred on
+  the server while parsing the JSON text.
+</ResponseField>
+
+<ResponseField name="-32600" type="int32">
+  **Invalid request**: The JSON sent is not a valid Request object.
+</ResponseField>
+
+<ResponseField name="-32601" type="int32">
+  **Method not found**: The method does not exist or is not available.
+</ResponseField>
+
+<ResponseField name="-32602" type="int32">
+  **Invalid params**: Invalid method parameter(s).
+</ResponseField>
+
+<ResponseField name="-32603" type="int32">
+  **Internal error**: Internal JSON-RPC error. Reserved for
+  implementation-defined server errors.
+</ResponseField>
+
+<ResponseField name="-32000" type="int32">
+  **Authentication required**: Authentication is required before this operation
+  can be performed.
+</ResponseField>
+
+<ResponseField name="-32002" type="int32">
+  **Resource not found**: A given resource, such as a file, was not found.
+</ResponseField>
+
+<ResponseField name="Other" type="int32">
+  Other undefined error code.
+</ResponseField>
+
+## <span class="font-mono">ExtNotification</span>
+
+Allows the Agent to send an arbitrary notification that is not part of the ACP spec.
+Extension notifications provide a way to send one-way messages for custom functionality
+while maintaining protocol compatibility.
+
+See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+
+## <span class="font-mono">ExtRequest</span>
+
+Allows for sending an arbitrary request that is not part of the ACP spec.
+Extension methods provide a way to add custom functionality while maintaining
+protocol compatibility.
+
+See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+
+## <span class="font-mono">ExtResponse</span>
+
+Allows for sending an arbitrary response to an `ExtRequest` that is not part of the ACP spec.
+Extension methods provide a way to add custom functionality while maintaining
+protocol compatibility.
+
+See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+
+## <span class="font-mono">FileSystemCapability</span>
+
+Filesystem capabilities supported by the client.
+File system capabilities that a client may support.
+
+See protocol docs: [FileSystem](https://agentclientprotocol.com/protocol/initialization#filesystem)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="readTextFile" type={"boolean"}>
+  Whether the Client supports `fs/read_text_file` requests.
+
+  * Default: `false`
+</ResponseField>
+
+<ResponseField name="writeTextFile" type={"boolean"}>
+  Whether the Client supports `fs/write_text_file` requests.
+
+  * Default: `false`
+</ResponseField>
+
+## <span class="font-mono">HttpHeader</span>
+
+An HTTP header to set when making requests to the MCP server.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  The name of the HTTP header.
+</ResponseField>
+
+<ResponseField name="value" type={"string"} required>
+  The value to set for the HTTP header.
+</ResponseField>
+
+## <span class="font-mono">ImageContent</span>
+
+An image provided to or from an LLM.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+<ResponseField name="data" type={"string"} required />
+
+<ResponseField name="mimeType" type={"string"} required />
+
+<ResponseField name="uri" type={"string | null"} />
+
+## <span class="font-mono">Implementation</span>
+
+Metadata about the implementation of the client or agent.
+Describes the name and version of an MCP implementation, with an optional
+title for UI representation.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Intended for programmatic or logical use, but can be used as a display
+  name fallback if title isn’t present.
+</ResponseField>
+
+<ResponseField name="title" type={"string | null"}>
+  Intended for UI and end-user contexts — optimized to be human-readable
+  and easily understood.
+
+  If not provided, the name should be used for display.
+</ResponseField>
+
+<ResponseField name="version" type={"string"} required>
+  Version of the implementation. Can be displayed to the user or used
+  for debugging or metrics purposes. (e.g. "1.0.0").
+</ResponseField>
+
+## <span class="font-mono">McpCapabilities</span>
+
+MCP capabilities supported by the agent
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="http" type={"boolean"}>
+  Agent supports `McpServer::Http`.
+
+  * Default: `false`
+</ResponseField>
+
+<ResponseField name="sse" type={"boolean"}>
+  Agent supports `McpServer::Sse`.
+
+  * Default: `false`
+</ResponseField>
+
+## <span class="font-mono">McpServer</span>
+
+Configuration for connecting to an MCP (Model Context Protocol) server.
+
+MCP servers provide tools and context that the agent can use when
+processing prompts.
+
+See protocol docs: [MCP Servers](https://agentclientprotocol.com/protocol/session-setup#mcp-servers)
+
+**Type:** Union
+
+<ResponseField name="http" type="object">
+  HTTP transport configuration
+
+  Only available when the Agent capabilities indicate `mcp_capabilities.http` is `true`.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="headers" type={<a href="#httpheader">HttpHeader[]</a>} required>
+      HTTP headers to set when making requests to the MCP server.
+    </ResponseField>
+
+    <ResponseField name="name" type={"string"} required>
+      Human-readable name identifying this MCP server.
+    </ResponseField>
+
+    <ResponseField name="type" type={"string"} required />
+
+    <ResponseField name="url" type={"string"} required>
+      URL to the MCP server.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="sse" type="object">
+  SSE transport configuration
+
+  Only available when the Agent capabilities indicate `mcp_capabilities.sse` is `true`.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="headers" type={<a href="#httpheader">HttpHeader[]</a>} required>
+      HTTP headers to set when making requests to the MCP server.
+    </ResponseField>
+
+    <ResponseField name="name" type={"string"} required>
+      Human-readable name identifying this MCP server.
+    </ResponseField>
+
+    <ResponseField name="type" type={"string"} required />
+
+    <ResponseField name="url" type={"string"} required>
+      URL to the MCP server.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="stdio">
+  Stdio transport configuration
+
+  All Agents MUST support this transport.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="args" type={<><span>"string"</span><span>[]</span></>} required>
+      Command-line arguments to pass to the MCP server.
+    </ResponseField>
+
+    <ResponseField name="command" type={"string"} required>
+      Path to the MCP server executable.
+    </ResponseField>
+
+    <ResponseField name="env" type={<a href="#envvariable">EnvVariable[]</a>} required>
+      Environment variables to set when launching the MCP server.
+    </ResponseField>
+
+    <ResponseField name="name" type={"string"} required>
+      Human-readable name identifying this MCP server.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">McpServerHttp</span>
+
+HTTP transport configuration for MCP.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="headers" type={<a href="#httpheader">HttpHeader[]</a>} required>
+  HTTP headers to set when making requests to the MCP server.
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Human-readable name identifying this MCP server.
+</ResponseField>
+
+<ResponseField name="url" type={"string"} required>
+  URL to the MCP server.
+</ResponseField>
+
+## <span class="font-mono">McpServerSse</span>
+
+SSE transport configuration for MCP.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="headers" type={<a href="#httpheader">HttpHeader[]</a>} required>
+  HTTP headers to set when making requests to the MCP server.
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Human-readable name identifying this MCP server.
+</ResponseField>
+
+<ResponseField name="url" type={"string"} required>
+  URL to the MCP server.
+</ResponseField>
+
+## <span class="font-mono">McpServerStdio</span>
+
+Stdio transport configuration for MCP.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="args" type={<><span>"string"</span><span>[]</span></>} required>
+  Command-line arguments to pass to the MCP server.
+</ResponseField>
+
+<ResponseField name="command" type={"string"} required>
+  Path to the MCP server executable.
+</ResponseField>
+
+<ResponseField name="env" type={<a href="#envvariable">EnvVariable[]</a>} required>
+  Environment variables to set when launching the MCP server.
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Human-readable name identifying this MCP server.
+</ResponseField>
+
+## <span class="font-mono">PermissionOption</span>
+
+An option presented to the user when requesting permission.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="kind" type={<a href="#permissionoptionkind">PermissionOptionKind</a>} required>
+  Hint about the nature of this permission option.
+</ResponseField>
+
+<ResponseField name="name" type={"string"} required>
+  Human-readable label to display to the user.
+</ResponseField>
+
+<ResponseField name="optionId" type={<a href="#permissionoptionid">PermissionOptionId</a>} required>
+  Unique identifier for this permission option.
+</ResponseField>
+
+## <span class="font-mono">PermissionOptionId</span>
+
+Unique identifier for a permission option.
+
+**Type:** `string`
+
+## <span class="font-mono">PermissionOptionKind</span>
+
+The type of permission option being presented to the user.
+
+Helps clients choose appropriate icons and UI treatment.
+
+**Type:** Union
+
+<ResponseField name="allow_once" type="string">
+  Allow this operation only this time.
+</ResponseField>
+
+<ResponseField name="allow_always" type="string">
+  Allow this operation and remember the choice.
+</ResponseField>
+
+<ResponseField name="reject_once" type="string">
+  Reject this operation only this time.
+</ResponseField>
+
+<ResponseField name="reject_always" type="string">
+  Reject this operation and remember the choice.
+</ResponseField>
+
+## <span class="font-mono">Plan</span>
+
+An execution plan for accomplishing complex tasks.
+
+Plans consist of multiple entries representing individual tasks or goals.
+Agents report plans to clients to provide visibility into their execution strategy.
+Plans can evolve during execution as the agent discovers new requirements or completes tasks.
+
+See protocol docs: [Agent Plan](https://agentclientprotocol.com/protocol/agent-plan)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="entries" type={<a href="#planentry">PlanEntry[]</a>} required>
+  The list of tasks to be accomplished.
+
+  When updating a plan, the agent must send a complete list of all entries
+  with their current status. The client replaces the entire plan with each update.
+</ResponseField>
+
+## <span class="font-mono">PlanEntry</span>
+
+A single entry in the execution plan.
+
+Represents a task or goal that the assistant intends to accomplish
+as part of fulfilling the user's request.
+See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={"string"} required>
+  Human-readable description of what this task aims to accomplish.
+</ResponseField>
+
+<ResponseField name="priority" type={<a href="#planentrypriority">PlanEntryPriority</a>} required>
+  The relative importance of this task.
+  Used to indicate which tasks are most critical to the overall goal.
+</ResponseField>
+
+<ResponseField name="status" type={<a href="#planentrystatus">PlanEntryStatus</a>} required>
+  Current execution status of this task.
+</ResponseField>
+
+## <span class="font-mono">PlanEntryPriority</span>
+
+Priority levels for plan entries.
+
+Used to indicate the relative importance or urgency of different
+tasks in the execution plan.
+See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+
+**Type:** Union
+
+<ResponseField name="high" type="string">
+  High priority task - critical to the overall goal.
+</ResponseField>
+
+<ResponseField name="medium" type="string">
+  Medium priority task - important but not critical.
+</ResponseField>
+
+<ResponseField name="low" type="string">
+  Low priority task - nice to have but not essential.
+</ResponseField>
+
+## <span class="font-mono">PlanEntryStatus</span>
+
+Status of a plan entry in the execution flow.
+
+Tracks the lifecycle of each task from planning through completion.
+See protocol docs: [Plan Entries](https://agentclientprotocol.com/protocol/agent-plan#plan-entries)
+
+**Type:** Union
+
+<ResponseField name="pending" type="string">
+  The task has not started yet.
+</ResponseField>
+
+<ResponseField name="in_progress" type="string">
+  The task is currently being worked on.
+</ResponseField>
+
+<ResponseField name="completed" type="string">
+  The task has been successfully completed.
+</ResponseField>
+
+## <span class="font-mono">PromptCapabilities</span>
+
+Prompt capabilities supported by the agent in `session/prompt` requests.
+
+Baseline agent functionality requires support for `ContentBlock::Text`
+and `ContentBlock::ResourceLink` in prompt requests.
+
+Other variants must be explicitly opted in to.
+Capabilities for different types of content in prompt requests.
+
+Indicates which content types beyond the baseline (text and resource links)
+the agent can process.
+
+See protocol docs: [Prompt Capabilities](https://agentclientprotocol.com/protocol/initialization#prompt-capabilities)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="audio" type={"boolean"}>
+  Agent supports `ContentBlock::Audio`.
+
+  * Default: `false`
+</ResponseField>
+
+<ResponseField name="embeddedContext" type={"boolean"}>
+  Agent supports embedded context in `session/prompt` requests.
+
+  When enabled, the Client is allowed to include `ContentBlock::Resource`
+  in prompt requests for pieces of context that are referenced in the message.
+
+  * Default: `false`
+</ResponseField>
+
+<ResponseField name="image" type={"boolean"}>
+  Agent supports `ContentBlock::Image`.
+
+  * Default: `false`
+</ResponseField>
+
+## <span class="font-mono">ProtocolVersion</span>
+
+Protocol version identifier.
+
+This version is only bumped for breaking changes.
+Non-breaking changes should be introduced via capabilities.
+
+**Type:** `integer (uint16)`
+
+| Constraint | Value   |
+| ---------- | ------- |
+| Minimum    | `0`     |
+| Maximum    | `65535` |
+
+## <span class="font-mono">RequestId</span>
+
+JSON RPC Request Id
+
+An identifier established by the Client that MUST contain a String, Number, or NULL value if included. If it is not included it is assumed to be a notification. The value SHOULD normally not be Null \[1] and Numbers SHOULD NOT contain fractional parts \[2]
+
+The Server MUST reply with the same value in the Response object if included. This member is used to correlate the context between the two objects.
+
+\[1] The use of Null as a value for the id member in a Request object is discouraged, because this specification uses a value of Null for Responses with an unknown id. Also, because JSON-RPC 1.0 uses an id value of Null for Notifications this could cause confusion in handling.
+
+\[2] Fractional parts may be problematic, since many decimal fractions cannot be represented exactly as binary fractions.
+
+**Type:** Union
+
+<ResponseField name="null" type="null">
+  {""}
+</ResponseField>
+
+<ResponseField name="Number" type="int64">
+  {""}
+</ResponseField>
+
+<ResponseField name="Str" type="string">
+  {""}
+</ResponseField>
+
+## <span class="font-mono">RequestPermissionOutcome</span>
+
+The outcome of a permission request.
+
+**Type:** Union
+
+<ResponseField name="cancelled" type="object">
+  The prompt turn was cancelled before the user responded.
+
+  When a client sends a `session/cancel` notification to cancel an ongoing
+  prompt turn, it MUST respond to all pending `session/request_permission`
+  requests with this `Cancelled` outcome.
+
+  See protocol docs: [Cancellation](https://agentclientprotocol.com/protocol/prompt-turn#cancellation)
+
+  <Expandable title="Properties">
+    <ResponseField name="outcome" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="selected" type="object">
+  The user selected one of the provided options.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="optionId" type={<a href="#permissionoptionid">PermissionOptionId</a>} required>
+      The ID of the option the user selected.
+    </ResponseField>
+
+    <ResponseField name="outcome" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">ResourceLink</span>
+
+A resource that the server is capable of reading, included in a prompt or tool call result.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+<ResponseField name="description" type={"string | null"} />
+
+<ResponseField name="mimeType" type={"string | null"} />
+
+<ResponseField name="name" type={"string"} required />
+
+<ResponseField name="size" type={"integer | null"} />
+
+<ResponseField name="title" type={"string | null"} />
+
+<ResponseField name="uri" type={"string"} required />
+
+## <span class="font-mono">Role</span>
+
+The sender or recipient of messages and data in a conversation.
+
+**Type:** Enumeration
+
+| Value         |
+| ------------- |
+| `"assistant"` |
+| `"user"`      |
+
+## <span class="font-mono">SelectedPermissionOutcome</span>
+
+The user selected one of the provided options.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="optionId" type={<a href="#permissionoptionid">PermissionOptionId</a>} required>
+  The ID of the option the user selected.
+</ResponseField>
+
+## <span class="font-mono">SessionCapabilities</span>
+
+Session capabilities supported by the agent.
+
+As a baseline, all Agents **MUST** support `session/new`, `session/prompt`, `session/cancel`, and `session/update`.
+
+Optionally, they **MAY** support other session methods and notifications by specifying additional capabilities.
+
+Note: `session/load` is still handled by the top-level `load_session` capability. This will be unified in future versions of the protocol.
+
+See protocol docs: [Session Capabilities](https://agentclientprotocol.com/protocol/initialization#session-capabilities)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+## <span class="font-mono">SessionId</span>
+
+A unique identifier for a conversation session between a client and agent.
+
+Sessions maintain their own context, conversation history, and state,
+allowing multiple independent interactions with the same agent.
+
+See protocol docs: [Session ID](https://agentclientprotocol.com/protocol/session-setup#session-id)
+
+**Type:** `string`
+
+## <span class="font-mono">SessionMode</span>
+
+A mode the agent can operate in.
+
+See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="description" type={"string | null"} />
+
+<ResponseField name="id" type={<a href="#sessionmodeid">SessionModeId</a>} required />
+
+<ResponseField name="name" type={"string"} required />
+
+## <span class="font-mono">SessionModeId</span>
+
+Unique identifier for a Session Mode.
+
+**Type:** `string`
+
+## <span class="font-mono">SessionModeState</span>
+
+The set of modes and the one currently active.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="availableModes" type={<a href="#sessionmode">SessionMode[]</a>} required>
+  The set of modes that the Agent can operate in
+</ResponseField>
+
+<ResponseField name="currentModeId" type={<a href="#sessionmodeid">SessionModeId</a>} required>
+  The current mode the Agent is in.
+</ResponseField>
+
+## <span class="font-mono">SessionUpdate</span>
+
+Different types of updates that can be sent during session processing.
+
+These updates provide real-time feedback about the agent's progress.
+
+See protocol docs: [Agent Reports Output](https://agentclientprotocol.com/protocol/prompt-turn#3-agent-reports-output)
+
+**Type:** Union
+
+<ResponseField name="user_message_chunk" type="object">
+  A chunk of the user's message being streamed.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+      A single item of content
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="agent_message_chunk" type="object">
+  A chunk of the agent's response being streamed.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+      A single item of content
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="agent_thought_chunk" type="object">
+  A chunk of the agent's internal reasoning being streamed.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+      A single item of content
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="tool_call" type="object">
+  Notification that a new tool call has been initiated.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<a href="#toolcallcontent">ToolCallContent[]</a>}>
+      Content produced by the tool call.
+    </ResponseField>
+
+    <ResponseField name="kind" type={<a href="#toolkind">ToolKind</a>}>
+      The category of tool being invoked.
+      Helps clients choose appropriate icons and UI treatment.
+    </ResponseField>
+
+    <ResponseField name="locations" type={<a href="#toolcalllocation">ToolCallLocation[]</a>}>
+      File locations affected by this tool call.
+      Enables "follow-along" features in clients.
+    </ResponseField>
+
+    <ResponseField name="rawInput" type={"object"}>
+      Raw input parameters sent to the tool.
+    </ResponseField>
+
+    <ResponseField name="rawOutput" type={"object"}>
+      Raw output returned by the tool.
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+
+    <ResponseField name="status" type={<a href="#toolcallstatus">ToolCallStatus</a>}>
+      Current execution status of the tool call.
+    </ResponseField>
+
+    <ResponseField name="title" type={"string"} required>
+      Human-readable title describing what the tool is doing.
+    </ResponseField>
+
+    <ResponseField name="toolCallId" type={<a href="#toolcallid">ToolCallId</a>} required>
+      Unique identifier for this tool call within the session.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="tool_call_update" type="object">
+  Update on the status or results of a tool call.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<><span><a href="#toolcallcontent">ToolCallContent[]</a></span><span> | null</span></>}>
+      Replace the content collection.
+    </ResponseField>
+
+    <ResponseField name="kind" type={<><span><a href="#toolkind">ToolKind</a></span><span> | null</span></>}>
+      Update the tool kind.
+    </ResponseField>
+
+    <ResponseField name="locations" type={<><span><a href="#toolcalllocation">ToolCallLocation[]</a></span><span> | null</span></>}>
+      Replace the locations collection.
+    </ResponseField>
+
+    <ResponseField name="rawInput" type={"object"}>
+      Update the raw input.
+    </ResponseField>
+
+    <ResponseField name="rawOutput" type={"object"}>
+      Update the raw output.
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+
+    <ResponseField name="status" type={<><span><a href="#toolcallstatus">ToolCallStatus</a></span><span> | null</span></>}>
+      Update the execution status.
+    </ResponseField>
+
+    <ResponseField name="title" type={"string | null"}>
+      Update the human-readable title.
+    </ResponseField>
+
+    <ResponseField name="toolCallId" type={<a href="#toolcallid">ToolCallId</a>} required>
+      The ID of the tool call being updated.
+    </ResponseField>
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="plan" type="object">
+  The agent's execution plan for complex tasks.
+  See protocol docs: [Agent Plan](https://agentclientprotocol.com/protocol/agent-plan)
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="entries" type={<a href="#planentry">PlanEntry[]</a>} required>
+      The list of tasks to be accomplished.
+
+      When updating a plan, the agent must send a complete list of all entries
+      with their current status. The client replaces the entire plan with each update.
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="available_commands_update" type="object">
+  Available commands are ready or have changed
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="availableCommands" type={<a href="#availablecommand">AvailableCommand[]</a>} required>
+      Commands the agent can execute
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="current_mode_update" type="object">
+  The current mode of the session has changed
+
+  See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="currentModeId" type={<a href="#sessionmodeid">SessionModeId</a>} required>
+      The ID of the current mode
+    </ResponseField>
+
+    <ResponseField name="sessionUpdate" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">StopReason</span>
+
+Reasons why an agent stops processing a prompt turn.
+
+See protocol docs: [Stop Reasons](https://agentclientprotocol.com/protocol/prompt-turn#stop-reasons)
+
+**Type:** Union
+
+<ResponseField name="end_turn" type="string">
+  The turn ended successfully.
+</ResponseField>
+
+<ResponseField name="max_tokens" type="string">
+  The turn ended because the agent reached the maximum number of tokens.
+</ResponseField>
+
+<ResponseField name="max_turn_requests" type="string">
+  The turn ended because the agent reached the maximum number of allowed agent
+  requests between user turns.
+</ResponseField>
+
+<ResponseField name="refusal" type="string">
+  The turn ended because the agent refused to continue. The user prompt and
+  everything that comes after it won't be included in the next prompt, so this
+  should be reflected in the UI.
+</ResponseField>
+
+<ResponseField name="cancelled" type="string">
+  The turn was cancelled by the client via `session/cancel`.
+
+  This stop reason MUST be returned when the client sends a `session/cancel`
+  notification, even if the cancellation causes exceptions in underlying operations.
+  Agents should catch these exceptions and return this semantically meaningful
+  response to confirm successful cancellation.
+</ResponseField>
+
+## <span class="font-mono">Terminal</span>
+
+Embed a terminal created with `terminal/create` by its id.
+
+The terminal must be added before calling `terminal/release`.
+
+See protocol docs: [Terminal](https://agentclientprotocol.com/protocol/terminals)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="terminalId" type={"string"} required />
+
+## <span class="font-mono">TerminalExitStatus</span>
+
+Exit status of a terminal command.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="exitCode" type={"integer | null"}>
+  The process exit code (may be null if terminated by signal).
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="signal" type={"string | null"}>
+  The signal that terminated the process (may be null if exited normally).
+</ResponseField>
+
+## <span class="font-mono">TextContent</span>
+
+Text provided to or from an LLM.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="annotations" type={<><span><a href="#annotations">Annotations</a></span><span> | null</span></>} />
+
+<ResponseField name="text" type={"string"} required />
+
+## <span class="font-mono">TextResourceContents</span>
+
+Text-based resource contents.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="mimeType" type={"string | null"} />
+
+<ResponseField name="text" type={"string"} required />
+
+<ResponseField name="uri" type={"string"} required />
+
+## <span class="font-mono">ToolCall</span>
+
+Represents a tool call that the language model has requested.
+
+Tool calls are actions that the agent executes on behalf of the language model,
+such as reading files, executing code, or fetching data from external sources.
+
+See protocol docs: [Tool Calls](https://agentclientprotocol.com/protocol/tool-calls)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={<a href="#toolcallcontent">ToolCallContent[]</a>}>
+  Content produced by the tool call.
+</ResponseField>
+
+<ResponseField name="kind" type={<a href="#toolkind">ToolKind</a>}>
+  The category of tool being invoked.
+  Helps clients choose appropriate icons and UI treatment.
+</ResponseField>
+
+<ResponseField name="locations" type={<a href="#toolcalllocation">ToolCallLocation[]</a>}>
+  File locations affected by this tool call.
+  Enables "follow-along" features in clients.
+</ResponseField>
+
+<ResponseField name="rawInput" type={"object"}>
+  Raw input parameters sent to the tool.
+</ResponseField>
+
+<ResponseField name="rawOutput" type={"object"}>
+  Raw output returned by the tool.
+</ResponseField>
+
+<ResponseField name="status" type={<a href="#toolcallstatus">ToolCallStatus</a>}>
+  Current execution status of the tool call.
+</ResponseField>
+
+<ResponseField name="title" type={"string"} required>
+  Human-readable title describing what the tool is doing.
+</ResponseField>
+
+<ResponseField name="toolCallId" type={<a href="#toolcallid">ToolCallId</a>} required>
+  Unique identifier for this tool call within the session.
+</ResponseField>
+
+## <span class="font-mono">ToolCallContent</span>
+
+Content produced by a tool call.
+
+Tool calls can produce different types of content including
+standard content blocks (text, images) or file diffs.
+
+See protocol docs: [Content](https://agentclientprotocol.com/protocol/tool-calls#content)
+
+**Type:** Union
+
+<ResponseField name="content" type="object">
+  Standard content block (text, images, resources).
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="content" type={<a href="#contentblock">ContentBlock</a>} required>
+      The actual content block.
+    </ResponseField>
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="diff" type="object">
+  File modification shown as a diff.
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="newText" type={"string"} required>
+      The new content after modification.
+    </ResponseField>
+
+    <ResponseField name="oldText" type={"string | null"}>
+      The original content (None for new files).
+    </ResponseField>
+
+    <ResponseField name="path" type={"string"} required>
+      The file path being modified.
+    </ResponseField>
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+<ResponseField name="terminal" type="object">
+  Embed a terminal created with `terminal/create` by its id.
+
+  The terminal must be added before calling `terminal/release`.
+
+  See protocol docs: [Terminal](https://agentclientprotocol.com/protocol/terminals)
+
+  <Expandable title="Properties">
+    <ResponseField name="_meta" type={"object | null"}>
+      The \_meta property is reserved by ACP to allow clients and agents to attach additional
+      metadata to their interactions. Implementations MUST NOT make assumptions about values at
+      these keys.
+
+      See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+    </ResponseField>
+
+    <ResponseField name="terminalId" type={"string"} required />
+
+    <ResponseField name="type" type={"string"} required />
+  </Expandable>
+</ResponseField>
+
+## <span class="font-mono">ToolCallId</span>
+
+Unique identifier for a tool call within a session.
+
+**Type:** `string`
+
+## <span class="font-mono">ToolCallLocation</span>
+
+A file location being accessed or modified by a tool.
+
+Enables clients to implement "follow-along" features that track
+which files the agent is working with in real-time.
+
+See protocol docs: [Following the Agent](https://agentclientprotocol.com/protocol/tool-calls#following-the-agent)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="line" type={"integer | null"}>
+  Optional line number within the file.
+
+  * Minimum: `0`
+</ResponseField>
+
+<ResponseField name="path" type={"string"} required>
+  The file path being accessed or modified.
+</ResponseField>
+
+## <span class="font-mono">ToolCallStatus</span>
+
+Execution status of a tool call.
+
+Tool calls progress through different statuses during their lifecycle.
+
+See protocol docs: [Status](https://agentclientprotocol.com/protocol/tool-calls#status)
+
+**Type:** Union
+
+<ResponseField name="pending" type="string">
+  The tool call hasn't started running yet because the input is either streaming
+  or we're awaiting approval.
+</ResponseField>
+
+<ResponseField name="in_progress" type="string">
+  The tool call is currently running.
+</ResponseField>
+
+<ResponseField name="completed" type="string">
+  The tool call completed successfully.
+</ResponseField>
+
+<ResponseField name="failed" type="string">
+  The tool call failed with an error.
+</ResponseField>
+
+## <span class="font-mono">ToolCallUpdate</span>
+
+An update to an existing tool call.
+
+Used to report progress and results as tools execute. All fields except
+the tool call ID are optional - only changed fields need to be included.
+
+See protocol docs: [Updating](https://agentclientprotocol.com/protocol/tool-calls#updating)
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="content" type={<><span><a href="#toolcallcontent">ToolCallContent[]</a></span><span> | null</span></>}>
+  Replace the content collection.
+</ResponseField>
+
+<ResponseField name="kind" type={<><span><a href="#toolkind">ToolKind</a></span><span> | null</span></>}>
+  Update the tool kind.
+</ResponseField>
+
+<ResponseField name="locations" type={<><span><a href="#toolcalllocation">ToolCallLocation[]</a></span><span> | null</span></>}>
+  Replace the locations collection.
+</ResponseField>
+
+<ResponseField name="rawInput" type={"object"}>
+  Update the raw input.
+</ResponseField>
+
+<ResponseField name="rawOutput" type={"object"}>
+  Update the raw output.
+</ResponseField>
+
+<ResponseField name="status" type={<><span><a href="#toolcallstatus">ToolCallStatus</a></span><span> | null</span></>}>
+  Update the execution status.
+</ResponseField>
+
+<ResponseField name="title" type={"string | null"}>
+  Update the human-readable title.
+</ResponseField>
+
+<ResponseField name="toolCallId" type={<a href="#toolcallid">ToolCallId</a>} required>
+  The ID of the tool call being updated.
+</ResponseField>
+
+## <span class="font-mono">ToolKind</span>
+
+Categories of tools that can be invoked.
+
+Tool kinds help clients choose appropriate icons and optimize how they
+display tool execution progress.
+
+See protocol docs: [Creating](https://agentclientprotocol.com/protocol/tool-calls#creating)
+
+**Type:** Union
+
+<ResponseField name="read" type="string">
+  Reading files or data.
+</ResponseField>
+
+<ResponseField name="edit" type="string">
+  Modifying files or content.
+</ResponseField>
+
+<ResponseField name="delete" type="string">
+  Removing files or data.
+</ResponseField>
+
+<ResponseField name="move" type="string">
+  Moving or renaming files.
+</ResponseField>
+
+<ResponseField name="search" type="string">
+  Searching for information.
+</ResponseField>
+
+<ResponseField name="execute" type="string">
+  Running commands or code.
+</ResponseField>
+
+<ResponseField name="think" type="string">
+  Internal reasoning or planning.
+</ResponseField>
+
+<ResponseField name="fetch" type="string">
+  Retrieving external data.
+</ResponseField>
+
+<ResponseField name="switch_mode" type="string">
+  Switching the current session mode.
+</ResponseField>
+
+<ResponseField name="other" type="string">
+  Other tool types (default).
+</ResponseField>
+
+## <span class="font-mono">UnstructuredCommandInput</span>
+
+All text that was typed after the command name is provided as input.
+
+**Type:** Object
+
+**Properties:**
+
+<ResponseField name="_meta" type={"object | null"}>
+  The \_meta property is reserved by ACP to allow clients and agents to attach additional
+  metadata to their interactions. Implementations MUST NOT make assumptions about values at
+  these keys.
+
+  See protocol docs: [Extensibility](https://agentclientprotocol.com/protocol/extensibility)
+</ResponseField>
+
+<ResponseField name="hint" type={"string"} required>
+  A hint to display when the input hasn't been provided yet
+</ResponseField>