protocol

type AgentAuthCapabilities struct {
	// Whether the agent supports the logout method.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports the logout method.
	Logout *LogoutCapabilities `json:"logout,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AgentCapabilities struct {
	// Authentication-related capabilities supported by the agent.
	Auth *AgentAuthCapabilities `json:"auth,omitempty"`
	// Whether the agent supports `session/load`.
	LoadSession bool `json:"loadSession,omitempty"`
	// MCP capabilities supported by the agent.
	McpCapabilities *McpCapabilities `json:"mcpCapabilities,omitempty"`
	// Prompt capabilities supported by the agent.
	PromptCapabilities *PromptCapabilities `json:"promptCapabilities,omitempty"`
	// Session lifecycle and prompt capabilities advertised by the agent.
	SessionCapabilities *SessionCapabilities `json:"sessionCapabilities,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AgentConn struct {
	// contains filtered or unexported fields
}

type Annotations struct {
	// Intended recipients for this content, such as the user or assistant.
	Audience []Role `json:"audience,omitempty"`
	// Timestamp indicating when the underlying resource was last modified.
	LastModified *string `json:"lastModified,omitempty"`
	// Relative importance of this content when clients choose what to surface.
	Priority *float64 `json:"priority,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AsyncCallResult struct {
	Facts CallResult
	Err   error
}

type AudioContent struct {
	// Optional annotations that help clients decide how to display or route this content.
	Annotations *Annotations `json:"annotations,omitempty"`
	// Base64-encoded media payload.
	Data string `json:"data"`
	// MIME type describing the encoded media payload.
	MimeType string `json:"mimeType"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AuthMethod = AuthMethodAgent

type AuthMethodAgent struct {
	// Optional description providing more details about this authentication method.
	Description *string `json:"description,omitempty"`
	// Unique identifier for this authentication method.
	ID AuthMethodID `json:"id"`
	// Human-readable name of the authentication method.
	Name string `json:"name"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AuthMethodID string

type AuthenticateRequest struct {
	// The ID of the authentication method to use.
	// Must be one of the methods advertised in the initialize response.
	MethodID AuthMethodID `json:"methodId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AuthenticateResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AvailableCommand struct {
	// Human-readable description of what the command does.
	Description string `json:"description"`
	// Input for the command if required
	Input *AvailableCommandInput `json:"input,omitempty"`
	// Command name (e.g., `create_plan`, `research_codebase`).
	Name string `json:"name"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type AvailableCommandInput = UnstructuredCommandInput

type AvailableCommandsUpdate struct {
	// Commands the agent can execute
	AvailableCommands []AvailableCommand `json:"availableCommands"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type BlobResourceContents struct {
	// Base64-encoded bytes for a binary resource payload.
	Blob string `json:"blob"`
	// MIME type describing the encoded media payload.
	MimeType *string `json:"mimeType,omitempty"`
	// URI associated with this resource or media payload.
	URI string `json:"uri"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type BooleanConfigOptionCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CallHandle struct {
	// contains filtered or unexported fields
}

type CallResult struct {
	WriteAdmitted    bool
	ResponseSequence uint64
	ReceiveSequence  uint64
}

type CancelNotification struct {
	// The ID of the session to cancel operations for.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ClientCapabilities struct {
	// File system capabilities supported by the client.
	// Determines which file operations the agent can request.
	Fs *FileSystemCapabilities `json:"fs,omitempty"`
	// Session-related capabilities supported by the client.
	//
	// Optional. Omitted or `null` both mean the client does not advertise any
	// session-related extensions.
	Session *ClientSessionCapabilities `json:"session,omitempty"`
	// Whether the Client support all `terminal/*` methods.
	Terminal bool `json:"terminal,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ClientConn struct {
	// contains filtered or unexported fields
}

type ClientSessionCapabilities struct {
	// Config option capabilities supported by the client.
	//
	// Omitted or `null` both mean the client does not advertise support for any
	// config option extensions.
	ConfigOptions *SessionConfigOptionsCapabilities `json:"configOptions,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CloseSessionRequest struct {
	// The ID of the session to close.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CloseSessionResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ConfigOptionUpdate struct {
	// The full set of configuration options and their current values.
	ConfigOptions []SessionConfigOption `json:"configOptions"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Conn struct {
	// contains filtered or unexported fields
}

type ConnClosedError struct {
	// contains filtered or unexported fields
}

type ConnOptions struct {
	// ExtIDBase sets the starting id minted for extension-traffic calls (the
	// id space used internally for outgoing calls other than the ones Call
	// mints — see callExt). Zero means "use the default base of 1". This
	// exists so a later typed layer can mint extension-traffic ids from a
	// caller-chosen range without ever colliding with Call's id space, which
	// always starts at 1<<32 regardless of this option.
	ExtIDBase int64
}

type Content struct {
	// The actual content block.
	Content ContentBlock `json:"content"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ContentBlock struct {
	// 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.
	Text *TextContent `json:"-"`
	// Images for visual context or analysis.
	//
	// Requires the `image` prompt capability when included in prompts.
	Image *ImageContent `json:"-"`
	// Audio data for transcription or analysis.
	//
	// Requires the `audio` prompt capability when included in prompts.
	Audio *AudioContent `json:"-"`
	// References to resources that the agent can access.
	//
	// All agents MUST support resource links in prompts.
	ResourceLink *ResourceLink `json:"-"`
	// 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.
	Resource *EmbeddedResource `json:"-"`
}

type ContentChunk struct {
	// A single item of content
	Content ContentBlock `json:"content"`
	// A unique identifier for the message this chunk belongs to.
	//
	// All chunks belonging to the same message share the same `messageId`.
	// A change in `messageId` indicates a new message has started.
	MessageID *MessageID `json:"messageId,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Cost struct {
	// Total cumulative cost for session.
	Amount float64 `json:"amount"`
	// ISO 4217 currency code (e.g., "USD", "EUR").
	Currency string `json:"currency"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CreateTerminalRequest struct {
	// Array of command arguments.
	Args []string `json:"args,omitempty"`
	// The command to execute.
	Command string `json:"command"`
	// Working directory for the command. Must be an absolute path.
	Cwd *string `json:"cwd,omitempty"`
	// Environment variables for the command.
	Env []EnvVariable `json:"env,omitempty"`
	// 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.
	OutputByteLimit *uint64 `json:"outputByteLimit,omitempty"`
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CreateTerminalResponse struct {
	// The unique identifier for the created terminal.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type CurrentModeUpdate struct {
	// The ID of the current mode
	CurrentModeID SessionModeID `json:"currentModeId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type DeleteSessionRequest struct {
	// The ID of the session to delete.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type DeleteSessionResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Diff struct {
	// The new content after modification.
	NewText string `json:"newText"`
	// The original content (None for new files).
	OldText *string `json:"oldText,omitempty"`
	// The absolute file path being modified.
	Path string `json:"path"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type EmbeddedResource struct {
	// Optional annotations that help clients decide how to display or route this content.
	Annotations *Annotations `json:"annotations,omitempty"`
	// Embedded resource payload, either text or binary data.
	Resource EmbeddedResourceResource `json:"resource"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type EmbeddedResourceResource struct {
	// Text resource contents embedded directly in the message.
	TextResourceContents *TextResourceContents `json:"-"`
	// Binary resource contents embedded directly in the message.
	BlobResourceContents *BlobResourceContents `json:"-"`
}

type EnvVariable struct {
	// The name of the environment variable.
	Name string `json:"name"`
	// The value to set for the environment variable.
	Value string `json:"value"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Envelope struct {
	Request      *Request
	Response     *Response
	Notification *Notification
}

type Error struct {
	// Code is the JSON-RPC error code. See the ErrorCode constants in
	// types_gen.go (generated from the pinned schema's ErrorCode $def).
	Code ErrorCode `json:"code"`
	// Message is a short, single-sentence description of the error.
	Message string `json:"message"`
	// Data is optional, caller-whitelisted additional context. It is never
	// populated automatically from an internal cause.
	Data json.RawMessage `json:"data,omitempty"`
}

type ErrorCode int32

type Fault struct {
	Code    ErrorCode
	Message string
	Data    json.RawMessage
	// contains filtered or unexported fields
}

type FileSystemCapabilities struct {
	// Whether the Client supports `fs/read_text_file` requests.
	ReadTextFile bool `json:"readTextFile,omitempty"`
	// Whether the Client supports `fs/write_text_file` requests.
	WriteTextFile bool `json:"writeTextFile,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type FrameReader struct {
	// contains filtered or unexported fields
}

type FrameTooLargeError struct {
	// Limit is the byte limit that was exceeded (always MaxMessageBytes).
	Limit int
}

type HTTPHeader struct {
	// The name of the HTTP header.
	Name string `json:"name"`
	// The value to set for the HTTP header.
	Value string `json:"value"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type HandlerFunc func(ctx context.Context, method string, params json.RawMessage) (any, error)

type ID struct {
	// contains filtered or unexported fields
}

type ImageContent struct {
	// Optional annotations that help clients decide how to display or route this content.
	Annotations *Annotations `json:"annotations,omitempty"`
	// Base64-encoded media payload.
	Data string `json:"data"`
	// MIME type describing the encoded media payload.
	MimeType string `json:"mimeType"`
	// URI associated with this resource or media payload.
	URI *string `json:"uri,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Implementation struct {
	// Intended for programmatic or logical use, but can be used as a display
	// name fallback if title isn’t present.
	Name string `json:"name"`
	// 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.
	Title *string `json:"title,omitempty"`
	// Version of the implementation. Can be displayed to the user or used
	// for debugging or metrics purposes. (e.g. "1.0.0").
	Version string `json:"version"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type InitializeRequest struct {
	// Capabilities supported by the client.
	ClientCapabilities *ClientCapabilities `json:"clientCapabilities,omitempty"`
	// Information about the Client name and version sent to the Agent.
	//
	// Note: in future versions of the protocol, this will be required.
	ClientInfo *Implementation `json:"clientInfo,omitempty"`
	// The latest protocol version supported by the client.
	ProtocolVersion ProtocolVersion `json:"protocolVersion"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type InitializeResponse struct {
	// Capabilities supported by the agent.
	AgentCapabilities *AgentCapabilities `json:"agentCapabilities,omitempty"`
	// Information about the Agent name and version sent to the Client.
	//
	// Note: in future versions of the protocol, this will be required.
	AgentInfo *Implementation `json:"agentInfo,omitempty"`
	// Authentication methods supported by the agent.
	AuthMethods []AuthMethod `json:"authMethods,omitempty"`
	// 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.
	ProtocolVersion ProtocolVersion `json:"protocolVersion"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type InvalidFrameError struct {
	Reason string
}

type Issue struct {
	Kind IssueKind
}

type IssueKind string

type KillTerminalRequest struct {
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// The ID of the terminal to kill.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type KillTerminalResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Kind uint8

type ListSessionsRequest struct {
	// Opaque cursor token from a previous response's nextCursor field for cursor-based pagination
	Cursor *string `json:"cursor,omitempty"`
	// Filter sessions by working directory. Must be an absolute path.
	Cwd *string `json:"cwd,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ListSessionsResponse struct {
	// 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.
	NextCursor *string `json:"nextCursor,omitempty"`
	// Array of session information objects
	Sessions []SessionInfo `json:"sessions"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type LoadSessionRequest struct {
	// Additional workspace roots to activate for this session. Each path must be absolute.
	//
	// When omitted or empty, no additional roots are activated. When non-empty,
	// this is the complete resulting additional-root list for the loaded
	// session. It may differ from any previously used or reported list as long as
	// the request `cwd` matches the session's `cwd`.
	AdditionalDirectories []string `json:"additionalDirectories,omitempty"`
	// The working directory for this session. Must be an absolute path.
	Cwd string `json:"cwd"`
	// List of MCP servers to connect to for this session.
	McpServers []McpServer `json:"mcpServers"`
	// The ID of the session to load.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type LoadSessionResponse struct {
	// Initial session configuration options if supported by the Agent.
	ConfigOptions []SessionConfigOption `json:"configOptions,omitempty"`
	// Initial mode state if supported by the Agent
	//
	// See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
	Modes *SessionModeState `json:"modes,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type LogoutCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type LogoutRequest struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type LogoutResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type McpCapabilities struct {
	// Agent supports [`McpServer::Http`].
	HTTP bool `json:"http,omitempty"`
	// Agent supports [`McpServer::Sse`].
	Sse bool `json:"sse,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type McpServer struct {
	// HTTP transport configuration
	//
	// Only available when the Agent capabilities indicate `mcp_capabilities.http` is `true`.
	HTTP *McpServerHTTP `json:"-"`
	// SSE transport configuration
	//
	// Only available when the Agent capabilities indicate `mcp_capabilities.sse` is `true`.
	Sse *McpServerSse `json:"-"`
	// Stdio transport configuration
	//
	// All Agents MUST support this transport.
	Stdio *McpServerStdio `json:"-"`
}

type McpServerHTTP struct {
	// HTTP headers to set when making requests to the MCP server.
	Headers []HTTPHeader `json:"headers"`
	// Human-readable name identifying this MCP server.
	Name string `json:"name"`
	// URL to the MCP server.
	URL string `json:"url"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type McpServerSse struct {
	// HTTP headers to set when making requests to the MCP server.
	Headers []HTTPHeader `json:"headers"`
	// Human-readable name identifying this MCP server.
	Name string `json:"name"`
	// URL to the MCP server.
	URL string `json:"url"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type McpServerStdio struct {
	// Command-line arguments to pass to the MCP server.
	Args []string `json:"args"`
	// Absolute path to the MCP server executable.
	Command string `json:"command"`
	// Environment variables to set when launching the MCP server.
	Env []EnvVariable `json:"env"`
	// Human-readable name identifying this MCP server.
	Name string `json:"name"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type MessageID string

type Method string

type NewSessionRequest struct {
	// Additional workspace roots for this session. Each path must be absolute.
	//
	// These expand the session's filesystem scope without changing `cwd`, which
	// remains the base for relative paths. When omitted or empty, no
	// additional roots are activated for the new session.
	AdditionalDirectories []string `json:"additionalDirectories,omitempty"`
	// The working directory for this session. Must be an absolute path.
	Cwd string `json:"cwd"`
	// List of MCP (Model Context Protocol) servers the agent should connect to.
	McpServers []McpServer `json:"mcpServers"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type NewSessionResponse struct {
	// Initial session configuration options if supported by the Agent.
	ConfigOptions []SessionConfigOption `json:"configOptions,omitempty"`
	// Initial mode state if supported by the Agent
	//
	// See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
	Modes *SessionModeState `json:"modes,omitempty"`
	// Unique identifier for the created session.
	//
	// Used in all subsequent requests for this conversation.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Notification struct {
	Method string
	Params json.RawMessage

	// ReceiveSequence is stamped only on inbound notifications by Conn's
	// single read loop and is never serialized onto the wire.
	ReceiveSequence uint64
}

type NotifyFunc func(ctx context.Context, method string, params json.RawMessage)

type NotifyWithSequenceFunc func(ctx context.Context, method string, params json.RawMessage, receiveSequence uint64)

type PermissionOption struct {
	// Hint about the nature of this permission option.
	Kind PermissionOptionKind `json:"kind"`
	// Human-readable label to display to the user.
	Name string `json:"name"`
	// Unique identifier for this permission option.
	OptionID PermissionOptionID `json:"optionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type PermissionOptionID string

type PermissionOptionKind string

type Plan struct {
	// 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.
	Entries []PlanEntry `json:"entries"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type PlanEntry struct {
	// Human-readable description of what this task aims to accomplish.
	Content string `json:"content"`
	// The relative importance of this task.
	// Used to indicate which tasks are most critical to the overall goal.
	Priority PlanEntryPriority `json:"priority"`
	// Current execution status of this task.
	Status PlanEntryStatus `json:"status"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type PlanEntryPriority string

type PlanEntryStatus string

type PromptCapabilities struct {
	// Agent supports [`ContentBlock::Audio`].
	Audio bool `json:"audio,omitempty"`
	// 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.
	EmbeddedContext bool `json:"embeddedContext,omitempty"`
	// Agent supports [`ContentBlock::Image`].
	Image bool `json:"image,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type PromptRequest struct {
	// 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.
	Prompt []ContentBlock `json:"prompt"`
	// The ID of the session to send this user message to
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type PromptResponse struct {
	// Indicates why the agent stopped processing the turn.
	StopReason StopReason `json:"stopReason"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ProtocolVersion uint16

type ReadTextFileRequest struct {
	// Maximum number of lines to read.
	Limit *uint32 `json:"limit,omitempty"`
	// Line number to start reading from (1-based).
	Line *uint32 `json:"line,omitempty"`
	// Absolute path to the file to read.
	Path string `json:"path"`
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ReadTextFileResponse struct {
	// Content payload returned by this response.
	Content string `json:"content"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ReceiveSequenceOverflowError struct{}

type ReleaseTerminalRequest struct {
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// The ID of the terminal to release.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ReleaseTerminalResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Request struct {
	ID     ID
	Method string
	Params json.RawMessage
}

type RequestPermissionOutcome struct {
	// 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)
	Cancelled *struct{} `json:"-"`
	// The user selected one of the provided options.
	Selected *SelectedPermissionOutcome `json:"-"`
}

type RequestPermissionRequest struct {
	// Available permission options for the user to choose from.
	Options []PermissionOption `json:"options"`
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// Details about the tool call requiring permission.
	ToolCall ToolCallUpdate `json:"toolCall"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type RequestPermissionResponse struct {
	// The user's decision on the permission request.
	Outcome RequestPermissionOutcome `json:"outcome"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ResourceLink struct {
	// Optional annotations that help clients decide how to display or route this content.
	Annotations *Annotations `json:"annotations,omitempty"`
	// Optional human-readable details shown with this protocol object.
	Description *string `json:"description,omitempty"`
	// MIME type describing the encoded media payload.
	MimeType *string `json:"mimeType,omitempty"`
	// Human-readable name shown for this protocol object.
	Name string `json:"name"`
	// Optional size of the linked resource in bytes, if known.
	Size *int64 `json:"size,omitempty"`
	// Optional display title for end-user UI.
	Title *string `json:"title,omitempty"`
	// URI associated with this resource or media payload.
	URI string `json:"uri"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Response struct {
	ID     ID
	Result json.RawMessage
	Error  *Error

	// ReceiveSequence is stamped only on inbound responses by Conn's single
	// read loop. It is intentionally omitted from JSON-RPC marshaling: this is
	// a local observation fact, never wire data.
	ReceiveSequence uint64
}

type ResumeSessionRequest struct {
	// Additional workspace roots to activate for this session. Each path must be absolute.
	//
	// When omitted or empty, no additional roots are activated. When non-empty,
	// this is the complete resulting additional-root list for the resumed
	// session. It may differ from any previously used or reported list as long as
	// the request `cwd` matches the session's `cwd`.
	AdditionalDirectories []string `json:"additionalDirectories,omitempty"`
	// The working directory for this session. Must be an absolute path.
	Cwd string `json:"cwd"`
	// List of MCP servers to connect to for this session.
	McpServers []McpServer `json:"mcpServers,omitempty"`
	// The ID of the session to resume.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ResumeSessionResponse struct {
	// Initial session configuration options if supported by the Agent.
	ConfigOptions []SessionConfigOption `json:"configOptions,omitempty"`
	// Initial mode state if supported by the Agent
	//
	// See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
	Modes *SessionModeState `json:"modes,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Role string

type SelectedPermissionOutcome struct {
	// The ID of the option the user selected.
	OptionID PermissionOptionID `json:"optionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SendResult = WriteResult

type SessionAdditionalDirectoriesCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionCapabilities struct {
	// Whether the agent supports `additionalDirectories` on supported session lifecycle requests.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports `additionalDirectories` on
	// supported session lifecycle requests.
	//
	// Agents that also support `session/list` may return
	// `SessionInfo.additionalDirectories` to report the complete ordered
	// additional-root list associated with a listed session.
	AdditionalDirectories *SessionAdditionalDirectoriesCapabilities `json:"additionalDirectories,omitempty"`
	// Whether the agent supports `session/close`.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports closing sessions.
	Close *SessionCloseCapabilities `json:"close,omitempty"`
	// Whether the agent supports `session/delete`.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports deleting sessions from `session/list`.
	Delete *SessionDeleteCapabilities `json:"delete,omitempty"`
	// Whether the agent supports `session/list`.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports listing sessions.
	List *SessionListCapabilities `json:"list,omitempty"`
	// Whether the agent supports `session/resume`.
	//
	// Optional. Omitted or `null` both mean the agent does not advertise support.
	// Supplying `{}` means the agent supports resuming sessions.
	Resume *SessionResumeCapabilities `json:"resume,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionCloseCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionConfigBoolean struct {
	// The current value of the boolean option.
	CurrentValue bool `json:"currentValue"`
}

type SessionConfigGroupID string

type SessionConfigID string

type SessionConfigOption struct {
	// Optional semantic category for this option (UX only).
	Category *SessionConfigOptionCategory `json:"category,omitempty"`
	// Optional description for the Client to display to the user.
	Description *string `json:"description,omitempty"`
	// Unique identifier for the configuration option.
	ID SessionConfigID `json:"id"`
	// Human-readable label for the option.
	Name string `json:"name"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
	// Single-value selector (dropdown).
	Select *SessionConfigSelect `json:"-"`
	// Boolean on/off toggle.
	Boolean *SessionConfigBoolean `json:"-"`
}

type SessionConfigOptionCategory string

type SessionConfigOptionsCapabilities struct {
	// Whether the client supports boolean session configuration options.
	//
	// Optional. Omitted or `null` both mean the client does not advertise support.
	// Supplying `{}` means agents may include `type: "boolean"` entries in
	// `configOptions`, and the client may send `session/set_config_option`
	// requests with `type: "boolean"` and a boolean `value`.
	Boolean *BooleanConfigOptionCapabilities `json:"boolean,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionConfigSelect struct {
	// The currently selected value.
	CurrentValue SessionConfigValueID `json:"currentValue"`
	// The set of selectable options.
	Options SessionConfigSelectOptions `json:"options"`
}

type SessionConfigSelectGroup struct {
	// Unique identifier for this group.
	Group SessionConfigGroupID `json:"group"`
	// Human-readable label for this group.
	Name string `json:"name"`
	// The set of option values in this group.
	Options []SessionConfigSelectOption `json:"options"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionConfigSelectOption struct {
	// Optional description for this option value.
	Description *string `json:"description,omitempty"`
	// Human-readable label for this option value.
	Name string `json:"name"`
	// Unique identifier for this option value.
	Value SessionConfigValueID `json:"value"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionConfigSelectOptions struct {
	// A flat list of options with no grouping.
	Ungrouped []SessionConfigSelectOption `json:"-"`
	// A list of options grouped under headers.
	Grouped []SessionConfigSelectGroup `json:"-"`
}

type SessionConfigValueID string

type SessionDeleteCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionID string

type SessionInfo struct {
	// Additional workspace roots reported for this session. Each path must be absolute.
	//
	// When present, this is the complete ordered additional-root list reported
	// by the Agent. Omitted and empty values are equivalent: the response
	// reports no additional roots.
	AdditionalDirectories []string `json:"additionalDirectories,omitempty"`
	// The working directory for this session. Must be an absolute path.
	Cwd string `json:"cwd"`
	// Unique identifier for the session
	SessionID SessionID `json:"sessionId"`
	// Human-readable title for the session
	Title *string `json:"title,omitempty"`
	// ISO 8601 timestamp of last activity
	UpdatedAt *string `json:"updatedAt,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionInfoUpdate struct {
	// Human-readable title for the session. Set to null to clear.
	Title *string `json:"title,omitempty"`
	// ISO 8601 timestamp of last activity. Set to null to clear.
	UpdatedAt *string `json:"updatedAt,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionListCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionMode struct {
	// Optional human-readable details shown with this protocol object.
	Description *string `json:"description,omitempty"`
	// Stable identifier used to refer to this protocol object in later messages.
	ID SessionModeID `json:"id"`
	// Human-readable name shown for this protocol object.
	Name string `json:"name"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionModeID string

type SessionModeState struct {
	// The set of modes that the Agent can operate in
	AvailableModes []SessionMode `json:"availableModes"`
	// The current mode the Agent is in.
	CurrentModeID SessionModeID `json:"currentModeId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionNotification struct {
	// The ID of the session this update pertains to.
	SessionID SessionID `json:"sessionId"`
	// The actual update content.
	Update SessionUpdate `json:"update"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionResumeCapabilities struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SessionUpdate struct {
	// A chunk of the user's message being streamed.
	UserMessageChunk *ContentChunk `json:"-"`
	// A chunk of the agent's response being streamed.
	AgentMessageChunk *ContentChunk `json:"-"`
	// A chunk of the agent's internal reasoning being streamed.
	AgentThoughtChunk *ContentChunk `json:"-"`
	// Notification that a new tool call has been initiated.
	ToolCall *ToolCall `json:"-"`
	// Update on the status or results of a tool call.
	ToolCallUpdate *ToolCallUpdate `json:"-"`
	// The agent's execution plan for complex tasks.
	// See protocol docs: [Agent Plan](https://agentclientprotocol.com/protocol/agent-plan)
	Plan *Plan `json:"-"`
	// Available commands are ready or have changed
	AvailableCommandsUpdate *AvailableCommandsUpdate `json:"-"`
	// The current mode of the session has changed
	//
	// See protocol docs: [Session Modes](https://agentclientprotocol.com/protocol/session-modes)
	CurrentModeUpdate *CurrentModeUpdate `json:"-"`
	// Session configuration options have been updated.
	ConfigOptionUpdate *ConfigOptionUpdate `json:"-"`
	// Session metadata has been updated (title, timestamps, custom metadata)
	SessionInfoUpdate *SessionInfoUpdate `json:"-"`
	// Context window and cost update for the session.
	UsageUpdate *UsageUpdate `json:"-"`
}

type SetSessionConfigOptionRequest struct {
	// The ID of the configuration option to set.
	ConfigID SessionConfigID `json:"configId"`
	// The ID of the session to set the configuration option for.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
	// A boolean value (`type: "boolean"`).
	Boolean *bool `json:"-"`
	// A [`SessionConfigValueId`] string value.
	//
	// This is the default when `type` is absent on the wire. Unknown `type`
	// values with string payloads also gracefully deserialize into this
	// variant.
	ValueID *SessionConfigValueID `json:"-"`
}

type SetSessionConfigOptionResponse struct {
	// The full set of configuration options and their current values.
	ConfigOptions []SessionConfigOption `json:"configOptions"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SetSessionModeRequest struct {
	// The ID of the mode to set.
	ModeID SessionModeID `json:"modeId"`
	// The ID of the session to set the mode for.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type SetSessionModeResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type StopReason string

type Terminal struct {
	// Identifier of the terminal instance to embed in the content stream.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type TerminalExitStatus struct {
	// The process exit code (may be null if terminated by signal).
	ExitCode *uint32 `json:"exitCode,omitempty"`
	// The signal that terminated the process (may be null if exited normally).
	Signal *string `json:"signal,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type TerminalHandle struct {
	// contains filtered or unexported fields
}

type TerminalID string

type TerminalOutputRequest struct {
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// The ID of the terminal to get output from.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type TerminalOutputResponse struct {
	// Exit status if the command has completed.
	ExitStatus *TerminalExitStatus `json:"exitStatus,omitempty"`
	// The terminal output captured so far.
	Output string `json:"output"`
	// Whether the output was truncated due to byte limits.
	Truncated bool `json:"truncated"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type TextContent struct {
	// Optional annotations that help clients decide how to display or route this content.
	Annotations *Annotations `json:"annotations,omitempty"`
	// Text payload carried by this content block.
	Text string `json:"text"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type TextResourceContents struct {
	// MIME type describing the encoded media payload.
	MimeType *string `json:"mimeType,omitempty"`
	// Text payload carried by this content block.
	Text string `json:"text"`
	// URI associated with this resource or media payload.
	URI string `json:"uri"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ToolCall struct {
	// Content produced by the tool call.
	Content []ToolCallContent `json:"content,omitempty"`
	// The category of tool being invoked.
	// Helps clients choose appropriate icons and UI treatment.
	Kind *ToolKind `json:"kind,omitempty"`
	// File locations affected by this tool call.
	// Enables "follow-along" features in clients.
	Locations []ToolCallLocation `json:"locations,omitempty"`
	// Raw input parameters sent to the tool.
	RawInput json.RawMessage `json:"rawInput,omitempty"`
	// Raw output returned by the tool.
	RawOutput json.RawMessage `json:"rawOutput,omitempty"`
	// Current execution status of the tool call.
	Status *ToolCallStatus `json:"status,omitempty"`
	// Human-readable title describing what the tool is doing.
	Title string `json:"title"`
	// Unique identifier for this tool call within the session.
	ToolCallID ToolCallID `json:"toolCallId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ToolCallContent struct {
	// Standard content block (text, images, resources).
	Content *Content `json:"-"`
	// File modification shown as a diff.
	Diff *Diff `json:"-"`
	// 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)
	Terminal *Terminal `json:"-"`
}

type ToolCallID string

type ToolCallLocation struct {
	// Optional line number within the file.
	Line *uint32 `json:"line,omitempty"`
	// The absolute file path being accessed or modified.
	Path string `json:"path"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ToolCallStatus string

type ToolCallUpdate struct {
	// Replace the content collection.
	Content []ToolCallContent `json:"content,omitempty"`
	// Update the tool kind.
	Kind *ToolKind `json:"kind,omitempty"`
	// Replace the locations collection.
	Locations []ToolCallLocation `json:"locations,omitempty"`
	// Update the raw input.
	RawInput json.RawMessage `json:"rawInput,omitempty"`
	// Update the raw output.
	RawOutput json.RawMessage `json:"rawOutput,omitempty"`
	// Update the execution status.
	Status *ToolCallStatus `json:"status,omitempty"`
	// Update the human-readable title.
	Title *string `json:"title,omitempty"`
	// The ID of the tool call being updated.
	ToolCallID ToolCallID `json:"toolCallId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ToolKind string

type TruncatedFrameError struct {
	// Read is the number of content bytes read on the truncated trailing
	// line before EOF.
	Read int
}

type UnstructuredCommandInput struct {
	// A hint to display when the input hasn't been provided yet
	Hint string `json:"hint"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type UsageUpdate struct {
	// Cumulative session cost (optional).
	Cost *Cost `json:"cost,omitempty"`
	// Total context window size in tokens.
	Size uint64 `json:"size"`
	// Tokens currently in context.
	Used uint64 `json:"used"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type ValidationError struct {
	Issues []Issue
}

type WaitForTerminalExitRequest struct {
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// The ID of the terminal to wait for.
	TerminalID TerminalID `json:"terminalId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type WaitForTerminalExitResponse struct {
	// The process exit code (may be null if terminated by signal).
	ExitCode *uint32 `json:"exitCode,omitempty"`
	// The signal that terminated the process (may be null if exited normally).
	Signal *string `json:"signal,omitempty"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type WriteResult struct {
	WriteAdmitted bool
}

type WriteTextFileRequest struct {
	// The text content to write to the file.
	Content string `json:"content"`
	// Absolute path to the file to write.
	Path string `json:"path"`
	// The session ID for this request.
	SessionID SessionID `json:"sessionId"`
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type WriteTextFileResponse struct {
	// 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)
	Meta json.RawMessage `json:"_meta,omitempty"`
}

type Writer struct {
	// contains filtered or unexported fields
}

type WriterClosedError struct {
	// contains filtered or unexported fields
}