Skip to main content

​
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.

​
authenticate

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

​
AuthenticateRequest

Request parameters for the authenticate method. Specifies which authentication method to use. Type: Object Properties:
​
_meta
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
​
methodId
string
required
The ID of the authentication method to use. Must be one of the methods advertised in the initialize response.

​
AuthenticateResponse

Response to the authenticate method. Type: Object Properties:
​
_meta
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

​
initialize

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

​
InitializeRequest

Request parameters for the initialize method. Sent by the client to establish connection and negotiate capabilities. See protocol docs: Initialization Type: Object Properties:
​
_meta
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
​
clientCapabilities
Capabilities supported by the client.
  • Default: {"fs":{"readTextFile":false,"writeTextFile":false},"terminal":false}
​
clientInfo
Information about the Client name and version sent to the Agent.Note: in future versions of the protocol, this will be required.
​
protocolVersion
required
The latest protocol version supported by the client.

​
InitializeResponse

Response to the initialize method. Contains the negotiated protocol version and agent capabilities. See protocol docs: Initialization Type: Object Properties:
​
_meta
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
​
agentCapabilities
Capabilities supported by the agent.
  • Default: {"loadSession":false,"mcpCapabilities":{"http":false,"sse":false},"promptCapabilities":{"audio":false,"embeddedContext":false,"image":false},"sessionCapabilities":{}}
​
agentInfo
Information about the Agent name and version sent to the Client.Note: in future versions of the protocol, this will be required.
​
authMethods
Authentication methods supported by the agent.
  • Default: []
​
protocolVersion
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.

​
session/cancel

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

​
CancelNotification

Notification to cancel ongoing operations for a session. See protocol docs: Cancellation Type: Object Properties:
​
_meta
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
​
sessionId
required
The ID of the session to cancel operations for.

​
session/fork

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Forks an existing session to create a new independent session. This method is only available if the agent advertises the session.fork capability. The agent should create a new session with the same conversation context as the original, allowing operations like generating summaries without affecting the original session’s history.

​
ForkSessionRequest

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Request parameters for forking an existing session. Creates a new session based on the context of an existing one, allowing operations like generating summaries without affecting the original session’s history. Only available if the Agent supports the session.fork capability. Type: Object Properties:
​
_meta
object
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
​
sessionId
required
The ID of the session to fork.

​
ForkSessionResponse

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Response from forking an existing session. Type: Object Properties:
​
_meta
object
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
​
models
UNSTABLEThis capability is not part of the spec yet, and may be removed or changed at any point.Initial model state if supported by the Agent
​
modes
Initial mode state if supported by the AgentSee protocol docs: Session Modes
​
sessionId
required
Unique identifier for the newly created forked session.

​
session/list

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Lists existing sessions known to the agent. This method is only available if the agent advertises the listSessions capability. The agent should return metadata about sessions with optional filtering and pagination support.

​
ListSessionsRequest

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Request parameters for listing existing sessions. Only available if the Agent supports the listSessions capability. Type: Object Properties:
​
_meta
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
​
cursor
string | null
Opaque cursor token from a previous response’s nextCursor field for cursor-based pagination
​
cwd
string | null
Filter sessions by working directory. Must be an absolute path.

​
ListSessionsResponse

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Response from listing sessions. Type: Object Properties:
​
_meta
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
​
nextCursor
string | null
Opaque cursor token. If present, pass this in the next request’s cursor parameter to fetch the next page. If absent, there are no more results.
​
sessions
required
Array of session information objects

​
session/load

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

​
LoadSessionRequest

Request parameters for loading an existing session. Only available if the Agent supports the loadSession capability. See protocol docs: Loading Sessions Type: Object Properties:
​
_meta
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
​
cwd
string
required
The working directory for this session.
​
mcpServers
required
List of MCP servers to connect to for this session.
​
sessionId
required
The ID of the session to load.

​
LoadSessionResponse

Response from loading an existing session. Type: Object Properties:
​
_meta
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
​
models
UNSTABLEThis capability is not part of the spec yet, and may be removed or changed at any point.Initial model state if supported by the Agent
​
modes
Initial mode state if supported by the AgentSee protocol docs: Session Modes

​
session/new

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

​
NewSessionRequest

Request parameters for creating a new session. See protocol docs: Creating a Session Type: Object Properties:
​
_meta
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
​
cwd
string
required
The working directory for this session. Must be an absolute path.
​
mcpServers
required
List of MCP (Model Context Protocol) servers the agent should connect to.

​
NewSessionResponse

Response from creating a new session. See protocol docs: Creating a Session Type: Object Properties:
​
_meta
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
​
models
UNSTABLEThis capability is not part of the spec yet, and may be removed or changed at any point.Initial model state if supported by the Agent
​
modes
Initial mode state if supported by the AgentSee protocol docs: Session Modes
​
sessionId
required
Unique identifier for the created session.Used in all subsequent requests for this conversation.

​
session/prompt

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

​
PromptRequest

Request parameters for sending a user prompt to the agent. Contains the user’s message and any additional context. See protocol docs: User Message Type: Object Properties:
​
_meta
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
​
prompt
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.
​
sessionId
required
The ID of the session to send this user message to

​
PromptResponse

Response from processing a user prompt. See protocol docs: Check for Completion Type: Object Properties:
​
_meta
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
​
stopReason
required
Indicates why the agent stopped processing the turn.

​
session/set_mode

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

​
SetSessionModeRequest

Request parameters for setting a session mode. Type: Object Properties:
​
_meta
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
​
modeId
required
The ID of the mode to set.
​
sessionId
required
The ID of the session to set the mode for.

​
SetSessionModeResponse

Response to session/set_mode method. Type: Object Properties:
​
_meta
object | null

​
session/set_model

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Select a model for a given session.

​
SetSessionModelRequest

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Request parameters for setting a session model. Type: Object Properties:
​
_meta
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
​
modelId
required
The ID of the model to set.
​
sessionId
required
The ID of the session to set the model for.

​
SetSessionModelResponse

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Response to session/set_model method. Type: Object Properties:
​
_meta
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

​
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.

​
fs/read_text_file

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

​
ReadTextFileRequest

Request to read content from a text file. Only available if the client supports the fs.readTextFile capability. Type: Object Properties:
​
_meta
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
​
limit
integer | null
Maximum number of lines to read.
  • Minimum: 0
​
line
integer | null
Line number to start reading from (1-based).
  • Minimum: 0
​
path
string
required
Absolute path to the file to read.
​
sessionId
required
The session ID for this request.

​
ReadTextFileResponse

Response containing the contents of a text file. Type: Object Properties:
​
_meta
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
​
content
string
required

​
fs/write_text_file

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

​
WriteTextFileRequest

Request to write content to a text file. Only available if the client supports the fs.writeTextFile capability. Type: Object Properties:
​
_meta
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
​
content
string
required
The text content to write to the file.
​
path
string
required
Absolute path to the file to write.
​
sessionId
required
The session ID for this request.

​
WriteTextFileResponse

Response to fs/write_text_file Type: Object Properties:
​
_meta
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

​
session/request_permission

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

​
RequestPermissionRequest

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 Type: Object Properties:
​
_meta
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
​
options
required
Available permission options for the user to choose from.
​
sessionId
required
The session ID for this request.
​
toolCall
required
Details about the tool call requiring permission.

​
RequestPermissionResponse

Response to a permission request. Type: Object Properties:
​
_meta
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
​
outcome
required
The user’s decision on the permission request.

​
session/update

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

​
SessionNotification

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 Type: Object Properties:
​
_meta
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
​
sessionId
required
The ID of the session this update pertains to.
​
update
required
The actual update content.

​
terminal/create

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

​
CreateTerminalRequest

Request to create a new terminal and execute a command. Type: Object Properties:
​
_meta
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
​
args
Array of command arguments.
​
command
string
required
The command to execute.
​
cwd
string | null
Working directory for the command (absolute path).
​
env
Environment variables for the command.
​
outputByteLimit
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
​
sessionId
required
The session ID for this request.

​
CreateTerminalResponse

Response containing the ID of the created terminal. Type: Object Properties:
​
_meta
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
​
terminalId
string
required
The unique identifier for the created terminal.

​
terminal/kill

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

​
KillTerminalCommandRequest

Request to kill a terminal command without releasing the terminal. Type: Object Properties:
​
_meta
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
​
sessionId
required
The session ID for this request.
​
terminalId
string
required
The ID of the terminal to kill.

​
KillTerminalCommandResponse

Response to terminal/kill command method Type: Object Properties:
​
_meta
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

​
terminal/output

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

​
TerminalOutputRequest

Request to get the current output and status of a terminal. Type: Object Properties:
​
_meta
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
​
sessionId
required
The session ID for this request.
​
terminalId
string
required
The ID of the terminal to get output from.

​
TerminalOutputResponse

Response containing the terminal output and exit status. Type: Object Properties:
​
_meta
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
​
exitStatus
Exit status if the command has completed.
​
output
string
required
The terminal output captured so far.
​
truncated
boolean
required
Whether the output was truncated due to byte limits.

​
terminal/release

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

​
ReleaseTerminalRequest

Request to release a terminal and free its resources. Type: Object Properties:
​
_meta
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
​
sessionId
required
The session ID for this request.
​
terminalId
string
required
The ID of the terminal to release.

​
ReleaseTerminalResponse

Response to terminal/release method Type: Object Properties:
​
_meta
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

​
terminal/wait_for_exit

Waits for the terminal command to exit and return its exit status See protocol docs: Terminals

​
WaitForTerminalExitRequest

Request to wait for a terminal command to exit. Type: Object Properties:
​
_meta
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
​
sessionId
required
The session ID for this request.
​
terminalId
string
required
The ID of the terminal to wait for.

​
WaitForTerminalExitResponse

Response containing the exit status of a terminal command. Type: Object Properties:
​
_meta
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
​
exitCode
integer | null
The process exit code (may be null if terminated by signal).
  • Minimum: 0
​
signal
string | null
The signal that terminated the process (may be null if exited normally).

​
AgentCapabilities

Capabilities supported by the agent. Advertised during initialization to inform the client about available features and content types. See protocol docs: Agent Capabilities Type: Object Properties:
​
_meta
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
​
loadSession
boolean
Whether the agent supports session/load.
  • Default: false
​
mcpCapabilities
MCP capabilities supported by the agent.
  • Default: {"http":false,"sse":false}
​
promptCapabilities
Prompt capabilities supported by the agent.
  • Default: {"audio":false,"embeddedContext":false,"image":false}
​
sessionCapabilities
  • Default: {}

​
Annotations

Optional annotations for the client. The client can use annotations to inform how objects are used or displayed Type: Object Properties:
​
_meta
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
​
audience
array | null
​
lastModified
string | null
​
priority
number | null

​
AudioContent

Audio provided to or from an LLM. Type: Object Properties:
​
_meta
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
​
annotations
​
data
string
required
​
mimeType
string
required

​
AuthMethod

Describes an available authentication method. Type: Object Properties:
​
_meta
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
​
description
string | null
Optional description providing more details about this authentication method.
​
id
string
required
Unique identifier for this authentication method.
​
name
string
required
Human-readable name of the authentication method.

​
AvailableCommand

Information about a command. Type: Object Properties:
​
_meta
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
​
description
string
required
Human-readable description of what the command does.
​
input
Input for the command if required
​
name
string
required
Command name (e.g., create_plan, research_codebase).

​
AvailableCommandInput

The input specification for a command. Type: Union
​
Variant
All text that was typed after the command name is provided as input.

​
AvailableCommandsUpdate

Available commands are ready or have changed Type: Object Properties:
​
_meta
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
​
availableCommands
required
Commands the agent can execute

​
BlobResourceContents

Binary resource contents. Type: Object Properties:
​
_meta
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
​
blob
string
required
​
mimeType
string | null
​
uri
string
required

​
ClientCapabilities

Capabilities supported by the client. Advertised during initialization to inform the agent about available features and methods. See protocol docs: Client Capabilities Type: Object Properties:
​
_meta
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
​
fs
File system capabilities supported by the client. Determines which file operations the agent can request.
  • Default: {"readTextFile":false,"writeTextFile":false}
​
terminal
boolean
Whether the Client support all terminal/* methods.
  • Default: false

​
Content

Standard content block (text, images, resources). Type: Object Properties:
​
_meta
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
​
content
required
The actual content block.

​
ContentBlock

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 Type: Union
​
text
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.
​
image
object
Images for visual context or analysis.Requires the image prompt capability when included in prompts.
​
audio
object
Audio data for transcription or analysis.Requires the audio prompt capability when included in prompts.
​
resource_link
object
References to resources that the agent can access.All agents MUST support resource links in prompts.
​
resource
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.

​
ContentChunk

A streamed item of content Type: Object Properties:
​
_meta
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
​
content
required
A single item of content

​
CurrentModeUpdate

The current mode of the session has changed See protocol docs: Session Modes Type: Object Properties:
​
_meta
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
​
currentModeId
required
The ID of the current mode

​
Diff

A diff representing file modifications. Shows changes to files in a format suitable for display in the client UI. See protocol docs: Content Type: Object Properties:
​
_meta
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
​
newText
string
required
The new content after modification.
​
oldText
string | null
The original content (None for new files).
​
path
string
required
The file path being modified.

​
EmbeddedResource

The contents of a resource, embedded into a prompt or tool call result. Type: Object Properties:
​
_meta
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
​
annotations
​
resource
required

​
EmbeddedResourceResource

Resource content that can be embedded in a message. Type: Union
​
TextResourceContents
​
BlobResourceContents

​
EnvVariable

An environment variable to set when launching an MCP server. Type: Object Properties:
​
_meta
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
​
name
string
required
The name of the environment variable.
​
value
string
required
The value to set for the environment variable.

​
Error

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 Type: Object Properties:
​
code
required
A number indicating the error type that occurred. This must be an integer as defined in the JSON-RPC specification.
​
data
object
Optional primitive or structured value that contains additional information about the error. This may include debugging information or context-specific details.
​
message
string
required
A string providing a short description of the error. The message should be limited to a concise single sentence.

​
ErrorCode

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
​
-32700
int32
Parse error: Invalid JSON was received by the server. An error occurred on the server while parsing the JSON text.
​
-32600
int32
Invalid request: The JSON sent is not a valid Request object.
​
-32601
int32
Method not found: The method does not exist or is not available.
​
-32602
int32
Invalid params: Invalid method parameter(s).
​
-32603
int32
Internal error: Internal JSON-RPC error. Reserved for implementation-defined server errors.
​
-32000
int32
Authentication required: Authentication is required before this operation can be performed.
​
-32002
int32
Resource not found: A given resource, such as a file, was not found.
​
integer
int32
Other undefined error code.

​
ExtNotification

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

​
ExtRequest

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

​
ExtResponse

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

​
FileSystemCapability

Filesystem capabilities supported by the client. File system capabilities that a client may support. See protocol docs: FileSystem Type: Object Properties:
​
_meta
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
​
readTextFile
boolean
Whether the Client supports fs/read_text_file requests.
  • Default: false
​
writeTextFile
boolean
Whether the Client supports fs/write_text_file requests.
  • Default: false

​
HttpHeader

An HTTP header to set when making requests to the MCP server. Type: Object Properties:
​
_meta
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
​
name
string
required
The name of the HTTP header.
​
value
string
required
The value to set for the HTTP header.

​
ImageContent

An image provided to or from an LLM. Type: Object Properties:
​
_meta
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
​
annotations
​
data
string
required
​
mimeType
string
required
​
uri
string | null

​
Implementation

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:
​
_meta
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
​
name
string
required
Intended for programmatic or logical use, but can be used as a display name fallback if title isn’t present.
​
title
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.
​
version
string
required
Version of the implementation. Can be displayed to the user or used for debugging or metrics purposes. (e.g. “1.0.0”).

​
McpCapabilities

MCP capabilities supported by the agent Type: Object Properties:
​
_meta
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
​
http
boolean
Agent supports McpServer::Http.
  • Default: false
​
sse
boolean
Agent supports McpServer::Sse.
  • Default: false

​
McpServer

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 Type: Union
​
http
object
HTTP transport configurationOnly available when the Agent capabilities indicate mcp_capabilities.http is true.
​
sse
object
SSE transport configurationOnly available when the Agent capabilities indicate mcp_capabilities.sse is true.
​
Variant
Stdio transport configurationAll Agents MUST support this transport.

​
McpServerHttp

HTTP transport configuration for MCP. Type: Object Properties:
​
_meta
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
​
headers
required
HTTP headers to set when making requests to the MCP server.
​
name
string
required
Human-readable name identifying this MCP server.
​
url
string
required
URL to the MCP server.

​
McpServerSse

SSE transport configuration for MCP. Type: Object Properties:
​
_meta
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
​
headers
required
HTTP headers to set when making requests to the MCP server.
​
name
string
required
Human-readable name identifying this MCP server.
​
url
string
required
URL to the MCP server.

​
McpServerStdio

Stdio transport configuration for MCP. Type: Object Properties:
​
_meta
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
​
args
required
Command-line arguments to pass to the MCP server.
​
command
string
required
Path to the MCP server executable.
​
env
required
Environment variables to set when launching the MCP server.
​
name
string
required
Human-readable name identifying this MCP server.

​
ModelId

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. A unique identifier for a model. Type: string

​
ModelInfo

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Information about a selectable model. Type: Object Properties:
​
_meta
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
​
description
string | null
Optional description of the model.
​
modelId
required
Unique identifier for the model.
​
name
string
required
Human-readable name of the model.

​
PermissionOption

An option presented to the user when requesting permission. Type: Object Properties:
​
_meta
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
​
kind
required
Hint about the nature of this permission option.
​
name
string
required
Human-readable label to display to the user.
​
optionId
required
Unique identifier for this permission option.

​
PermissionOptionId

Unique identifier for a permission option. Type: string

​
PermissionOptionKind

The type of permission option being presented to the user. Helps clients choose appropriate icons and UI treatment. Type: Union
​
allow_once
string
Allow this operation only this time.
​
allow_always
string
Allow this operation and remember the choice.
​
reject_once
string
Reject this operation only this time.
​
reject_always
string
Reject this operation and remember the choice.

​
Plan

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 Type: Object Properties:
​
_meta
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
​
entries
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.

​
PlanEntry

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 Type: Object Properties:
​
_meta
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
​
content
string
required
Human-readable description of what this task aims to accomplish.
​
priority
required
The relative importance of this task. Used to indicate which tasks are most critical to the overall goal.
​
status
required
Current execution status of this task.

​
PlanEntryPriority

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 Type: Union
​
high
string
High priority task - critical to the overall goal.
​
medium
string
Medium priority task - important but not critical.
​
low
string
Low priority task - nice to have but not essential.

​
PlanEntryStatus

Status of a plan entry in the execution flow. Tracks the lifecycle of each task from planning through completion. See protocol docs: Plan Entries Type: Union
​
pending
string
The task has not started yet.
​
in_progress
string
The task is currently being worked on.
​
completed
string
The task has been successfully completed.

​
PromptCapabilities

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 Type: Object Properties:
​
_meta
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
​
audio
boolean
Agent supports ContentBlock::Audio.
  • Default: false
​
embeddedContext
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
​
image
boolean
Agent supports ContentBlock::Image.
  • Default: false

​
ProtocolVersion

Protocol version identifier. This version is only bumped for breaking changes. Non-breaking changes should be introduced via capabilities. Type: integer (uint16)
ConstraintValue
Minimum0
Maximum65535

​
RequestId

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

​
RequestPermissionOutcome

The outcome of a permission request. Type: Union
​
cancelled
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
​
selected
object
The user selected one of the provided options.
A resource that the server is capable of reading, included in a prompt or tool call result. Type: Object Properties:
​
_meta
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
​
annotations
​
description
string | null
​
mimeType
string | null
​
name
string
required
​
size
integer | null
​
title
string | null
​
uri
string
required

​
Role

The sender or recipient of messages and data in a conversation. Type: Enumeration
Value
"assistant"
"user"

​
SelectedPermissionOutcome

The user selected one of the provided options. Type: Object Properties:
​
_meta
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
​
optionId
required
The ID of the option the user selected.

​
SessionCapabilities

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 Type: Object Properties:
​
_meta
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
​
fork
UNSTABLEThis capability is not part of the spec yet, and may be removed or changed at any point.Whether the agent supports session/fork.
​
list
UNSTABLEThis capability is not part of the spec yet, and may be removed or changed at any point.Whether the agent supports session/list.

​
SessionForkCapabilities

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Capabilities for the session/fork method. By supplying \{\} it means that the agent supports forking of sessions. Type: Object Properties:
​
_meta
object
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

​
SessionId

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 Type: string

​
SessionInfo

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. Information about a session returned by session/list Type: Object Properties:
​
_meta
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
​
cwd
string
required
The working directory for this session. Must be an absolute path.
​
sessionId
required
Unique identifier for the session
​
title
string | null
Human-readable title for the session
​
updatedAt
string | null
ISO 8601 timestamp of last activity

​
SessionListCapabilities

Capabilities for the session/list method. By supplying \{\} it means that the agent supports listing of sessions. Further capabilities can be added in the future for other means of filtering or searching the list. Type: Object Properties:
​
_meta
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

​
SessionMode

A mode the agent can operate in. See protocol docs: Session Modes Type: Object Properties:
​
_meta
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
​
description
string | null
​
id
required
​
name
string
required

​
SessionModeId

Unique identifier for a Session Mode. Type: string

​
SessionModeState

The set of modes and the one currently active. Type: Object Properties:
​
_meta
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
​
availableModes
required
The set of modes that the Agent can operate in
​
currentModeId
required
The current mode the Agent is in.

​
SessionModelState

UNSTABLE This capability is not part of the spec yet, and may be removed or changed at any point. The set of models and the one currently active. Type: Object Properties:
​
_meta
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
​
availableModels
required
The set of models that the Agent can use
​
currentModelId
required
The current model the Agent is in.

​
SessionUpdate

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 Type: Union
​
user_message_chunk
object
A chunk of the user’s message being streamed.
​
agent_message_chunk
object
A chunk of the agent’s response being streamed.
​
agent_thought_chunk
object
A chunk of the agent’s internal reasoning being streamed.
​
tool_call
object
Notification that a new tool call has been initiated.
​
tool_call_update
object
Update on the status or results of a tool call.
​
plan
object
The agent’s execution plan for complex tasks. See protocol docs: Agent Plan
​
available_commands_update
object
Available commands are ready or have changed
​
current_mode_update
object
The current mode of the session has changedSee protocol docs: Session Modes

​
StopReason

Reasons why an agent stops processing a prompt turn. See protocol docs: Stop Reasons Type: Union
​
end_turn
string
The turn ended successfully.
​
max_tokens
string
The turn ended because the agent reached the maximum number of tokens.
​
max_turn_requests
string
The turn ended because the agent reached the maximum number of allowed agent requests between user turns.
​
refusal
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.
​
cancelled
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.

​
Terminal

Embed a terminal created with terminal/create by its id. The terminal must be added before calling terminal/release. See protocol docs: Terminal Type: Object Properties:
​
_meta
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
​
terminalId
string
required

​
TerminalExitStatus

Exit status of a terminal command. Type: Object Properties:
​
_meta
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
​
exitCode
integer | null
The process exit code (may be null if terminated by signal).
  • Minimum: 0
​
signal
string | null
The signal that terminated the process (may be null if exited normally).

​
TextContent

Text provided to or from an LLM. Type: Object Properties:
​
_meta
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
​
annotations
​
text
string
required

​
TextResourceContents

Text-based resource contents. Type: Object Properties:
​
_meta
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
​
mimeType
string | null
​
text
string
required
​
uri
string
required

​
ToolCall

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 Type: Object Properties:
​
_meta
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
​
content
Content produced by the tool call.
​
kind
The category of tool being invoked. Helps clients choose appropriate icons and UI treatment.
​
locations
File locations affected by this tool call. Enables “follow-along” features in clients.
​
rawInput
object
Raw input parameters sent to the tool.
​
rawOutput
object
Raw output returned by the tool.
​
status
Current execution status of the tool call.
​
title
string
required
Human-readable title describing what the tool is doing.
​
toolCallId
required
Unique identifier for this tool call within the session.

​
ToolCallContent

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 Type: Union
​
content
object
Standard content block (text, images, resources).
​
diff
object
File modification shown as a diff.
​
terminal
object
Embed a terminal created with terminal/create by its id.The terminal must be added before calling terminal/release.See protocol docs: Terminal

​
ToolCallId

Unique identifier for a tool call within a session. Type: string

​
ToolCallLocation

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 Type: Object Properties:
​
_meta
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
​
line
integer | null
Optional line number within the file.
  • Minimum: 0
​
path
string
required
The file path being accessed or modified.

​
ToolCallStatus

Execution status of a tool call. Tool calls progress through different statuses during their lifecycle. See protocol docs: Status Type: Union
​
pending
string
The tool call hasn’t started running yet because the input is either streaming or we’re awaiting approval.
​
in_progress
string
The tool call is currently running.
​
completed
string
The tool call completed successfully.
​
failed
string
The tool call failed with an error.

​
ToolCallUpdate

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 Type: Object Properties:
​
_meta
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
​
content
array | null
Replace the content collection.
​
kind
Update the tool kind.
​
locations
array | null
Replace the locations collection.
​
rawInput
object
Update the raw input.
​
rawOutput
object
Update the raw output.
​
status
Update the execution status.
​
title
string | null
Update the human-readable title.
​
toolCallId
required
The ID of the tool call being updated.

​
ToolKind

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 Type: Union
​
read
string
Reading files or data.
​
edit
string
Modifying files or content.
​
delete
string
Removing files or data.
​
move
string
Moving or renaming files.
​
search
string
Searching for information.
​
execute
string
Running commands or code.
​
think
string
Internal reasoning or planning.
​
fetch
string
Retrieving external data.
​
switch_mode
string
Switching the current session mode.
​
other
string
Other tool types (default).

​
UnstructuredCommandInput

All text that was typed after the command name is provided as input. Type: Object Properties:
​
_meta
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
​
hint
string
required
A hint to display when the input hasn’t been provided yet