acp

Jun 2, 2026

Changes in this version

type Client

+ func (c *Client) PromptStream(ctx context.Context, prompt string, onEvent func(tool.ACPPromptEvent)) (*tool.ACPPromptResult, error)

type RequestPermissionOutcome

+ func (o *RequestPermissionOutcome) UnmarshalJSON(data []byte) error

+ func (o RequestPermissionOutcome) MarshalJSON() ([]byte, error)

Jun 1, 2026

Changes in this version

+ var KnownAgents = []AgentDef

+ type AgentDef struct

+ ACPCommand []string

+ Binaries []string

+ Description string

+ Name string

+ Title string

+ type ApprovalHandler func(ctx context.Context, toolName string, input string) permission.Decision

+ type Client struct

+ func NewClient(agent DiscoveredAgent, workingDir string, policy permission.PermissionPolicy, ...) *Client

+ func (c *Client) Capabilities() AgentCapabilities

+ func (c *Client) Close() error

+ func (c *Client) Description() string

+ func (c *Client) EnsureReady(ctx context.Context) error

+ func (c *Client) Name() string

+ func (c *Client) NewSession(ctx context.Context, cwd string) error

+ func (c *Client) Prompt(ctx context.Context, prompt string) (*tool.ACPPromptResult, error)

+ func (c *Client) SetApprovalHandler(h ApprovalHandler)

+ func (c *Client) SetPermissionHandler(h PermissionHandler)

+ func (c *Client) SetWorkingDir(dir string)

+ func (c *Client) Start(ctx context.Context) error

+ func (c *Client) Title() string

+ type ClientManager struct

+ func NewClientManager(workingDir string, policy permission.PermissionPolicy, ...) *ClientManager

+ func (m *ClientManager) AgentInfo(name string) (title, description string, ok bool)

+ func (m *ClientManager) Available() []string

+ func (m *ClientManager) CloseAll()

+ func (m *ClientManager) Get(ctx context.Context, name string) (tool.ACPAgentClient, error)

+ func (m *ClientManager) SetApprovalHandler(h ApprovalHandler)

+ func (m *ClientManager) SetPermissionHandler(h PermissionHandler)

+ func (m *ClientManager) SetWorkingDir(dir string)

+ type DiscoveredAgent struct

+ Def AgentDef

+ Path string

+ func Discover() []DiscoveredAgent

+ type ErrAgentNotFound struct

+ func (e ErrAgentNotFound) Error() string

type NewSessionRequest

+ func (r NewSessionRequest) MarshalJSON() ([]byte, error)

+ type PermissionHandler func(ctx context.Context, req RequestPermissionRequest) (RequestPermissionResponse, error)

+ type PromptCompleteNotification struct

+ Meta json.RawMessage

+ Response PromptResponse

+ SessionID string

+ type PromptResult struct

+ StopReason StopReason

+ Text string

+ ToolCalls []ToolCallSummary

+ type ToolCallSummary struct

+ Name string

+ Status string

+ Title string

Apr 27, 2026

Changes in this version

type Session

+ func (s *Session) HasMessages() bool

+ func (s *Session) ReplaceConversation(msgs []Message)

Apr 27, 2026

Changes in this version

+ const ProtocolVersion

+ const UpdateAgentMessageChunk

+ const UpdatePlan

+ const UpdateToolCall

+ const UpdateToolCallUpdate

+ const UpdateUserMessageChunk

type AgentCapabilities

+ Meta json.RawMessage

+ SessionCapabilities *SessionCapabilities

type AgentLoop

+ func (al *AgentLoop) RestoreConversation(messages []Message)

+ type Annotations struct

+ Audience []string

+ LastModified string

+ Meta json.RawMessage

+ Priority float64

type AuthEnvVar

+ Meta json.RawMessage

type AuthMethod

+ Meta json.RawMessage

+ type AuthenticateRequest struct

+ AuthMethodID string

+ Meta json.RawMessage

+ type AuthenticateResponse struct

+ Meta json.RawMessage

+ type AvailableCommand struct

+ Description string

+ Input interface{}

+ Meta json.RawMessage

+ Name string

+ type AvailableCommandsUpdate struct

+ AvailableCommands []AvailableCommand

+ Meta json.RawMessage

+ SessionID string

+ type BlobResourceContents struct

+ Blob string

+ MIMEType string

+ Meta json.RawMessage

+ URI string

+ type CancelNotification struct

+ Meta json.RawMessage

+ SessionID string

type ClientCapabilities

+ Meta json.RawMessage

+ type CloseSessionRequest struct

+ Meta json.RawMessage

+ SessionID string

+ type CloseSessionResponse struct

+ Meta json.RawMessage

+ type ConfigOptionUpdate struct

+ ConfigOptions []SessionConfigOption

+ Meta json.RawMessage

+ SessionID string

type ContentBlock

+ AudioData string

+ AudioMIME string

+ AudioURL string

+ Meta json.RawMessage

+ Resource *EmbeddedResource

+ URI string

+ type CreateTerminalRequest struct

+ CWD string

+ Command string

+ Env []EnvVariable

+ Meta json.RawMessage

+ type CreateTerminalResponse struct

+ Meta json.RawMessage

+ TerminalID string

+ type CurrentModeUpdate struct

+ Meta json.RawMessage

+ Mode SessionModeId

+ SessionID string

+ type Diff struct

+ Meta json.RawMessage

+ NewText string

+ OldText string

+ Path string

+ type EmbeddedResource struct

+ Blob *BlobResourceContents

+ Meta json.RawMessage

+ Text *TextResourceContents

type EnvVariable

+ Meta json.RawMessage

+ type ExtNotification struct

+ Meta json.RawMessage

+ Method string

+ Params json.RawMessage

+ type ExtRequest struct

+ ID RequestID

+ Meta json.RawMessage

+ Method string

+ Params json.RawMessage

+ type ExtResponse struct

+ Meta json.RawMessage

+ Result interface{}

type HTTPHeader

+ Meta json.RawMessage

type ImplementationInfo

+ Meta json.RawMessage

+ type InitializeRequest struct

+ ClientCapabilities ClientCapabilities

+ ClientInfo *ImplementationInfo

+ Meta json.RawMessage

+ ProtocolVersion int

+ type InitializeResponse struct

+ AgentCapabilities AgentCapabilities

+ AgentInfo ImplementationInfo

+ AuthMethods []AuthMethod

+ Meta json.RawMessage

+ ProtocolVersion int

+ type KillTerminalRequest struct

+ Meta json.RawMessage

+ TerminalID string

+ type KillTerminalResponse struct

+ Meta json.RawMessage

+ type ListSessionsRequest struct

+ CWD string

+ Cursor string

+ Meta json.RawMessage

+ type ListSessionsResponse struct

+ Meta json.RawMessage

+ NextCursor string

+ Sessions []SessionInfo

+ type LoadSessionRequest struct

+ Meta json.RawMessage

+ SessionID string

+ type LoadSessionResponse struct

+ Messages []Message

+ Meta json.RawMessage

+ SessionID string

type MCPCapabilities

+ Meta json.RawMessage

type MCPServer

+ Meta json.RawMessage

+ type NewSessionRequest struct

+ CWD string

+ MCPServers []MCPServer

+ Meta json.RawMessage

+ type NewSessionResponse struct

+ ConfigOptions []SessionConfigOption

+ Meta json.RawMessage

+ Modes *SessionModeState

+ SessionID string

+ type PermissionOption struct

+ Kind PermissionOptionKind

+ Meta json.RawMessage

+ Name string

+ OptionID PermissionOptionId

+ type PermissionOptionId = string

+ type PermissionOptionKind string

+ const PermissionOptionAllowAlways

+ const PermissionOptionAllowOnce

+ const PermissionOptionRejectAlways

+ const PermissionOptionRejectOnce

+ type Plan struct

+ Entries []PlanEntry

+ Meta json.RawMessage

+ type PlanEntry struct

+ Content string

+ Meta json.RawMessage

+ Priority PlanEntryPriority

+ Status PlanEntryStatus

+ type PlanEntryPriority string

+ const PlanEntryPriorityHigh

+ const PlanEntryPriorityLow

+ const PlanEntryPriorityMedium

+ type PlanEntryStatus string

+ const PlanEntryStatusCompleted

+ const PlanEntryStatusFailed

+ const PlanEntryStatusInProgress

+ const PlanEntryStatusPending

type PromptCapabilities

+ Meta json.RawMessage

+ type PromptRequest struct

+ Meta json.RawMessage

+ Prompt []ContentBlock

+ SessionID string

+ type PromptResponse struct

+ Meta json.RawMessage

+ StopReason StopReason

+ type ReadTextFileRequest struct

+ Meta json.RawMessage

+ Path string

+ type ReadTextFileResponse struct

+ Content string

+ Meta json.RawMessage

+ type ReleaseTerminalRequest struct

+ Meta json.RawMessage

+ TerminalID string

+ type ReleaseTerminalResponse struct

+ Meta json.RawMessage

+ type RequestID = interface

+ type RequestPermissionOutcome struct

+ Outcome string

+ SelectedOption *SelectedPermissionOutcome

+ type RequestPermissionRequest struct

+ Meta json.RawMessage

+ Options []PermissionOption

+ SessionID string

+ ToolCall *ToolCallUpdate

+ type RequestPermissionResponse struct

+ Meta json.RawMessage

+ Outcome RequestPermissionOutcome

+ type ResumeSessionRequest struct

+ CWD string

+ MCPServers []MCPServer

+ Meta json.RawMessage

+ SessionID string

+ type ResumeSessionResponse struct

+ ConfigOptions []SessionConfigOption

+ Meta json.RawMessage

+ Modes *SessionModeState

+ type SelectedPermissionOutcome struct

+ Meta json.RawMessage

+ OptionID PermissionOptionId

type Session

+ func (s *Session) SaveDir() string

+ func (s *Session) SetSaveDir(dir string)

+ type SessionCapabilities struct

+ Close *SessionCloseCapabilities

+ List *SessionListCapabilities

+ Meta json.RawMessage

+ Resume *SessionResumeCapabilities

+ type SessionCloseCapabilities struct

+ Meta json.RawMessage

+ type SessionConfigGroupId = string

+ type SessionConfigId = string

+ type SessionConfigOption struct

+ Category string

+ CurrentValue SessionConfigValueId

+ Description string

+ ID SessionConfigId

+ Meta json.RawMessage

+ Name string

+ Options SessionConfigSelectOptions

+ Type string

+ type SessionConfigSelectGroup struct

+ ID SessionConfigGroupId

+ Meta json.RawMessage

+ Name string

+ Options []SessionConfigSelectOption

+ type SessionConfigSelectOption struct

+ GroupID SessionConfigGroupId

+ ID SessionConfigValueId

+ Meta json.RawMessage

+ Name string

+ type SessionConfigSelectOptions []interface

+ type SessionConfigValueId = string

+ type SessionInfo struct

+ CWD string

+ CreatedAt string

+ Meta json.RawMessage

+ SessionID string

+ Title string

+ UpdatedAt string

+ type SessionInfoUpdate struct

+ Meta json.RawMessage

+ SessionID string

+ Title string

+ type SessionListCapabilities struct

+ Meta json.RawMessage

+ type SessionMode struct

+ Description string

+ ID SessionModeId

+ Meta json.RawMessage

+ Name string

+ type SessionModeId = string

+ type SessionModeState struct

+ Current SessionModeId

+ Modes []SessionMode

+ type SessionNotification struct

+ Meta json.RawMessage

+ SessionID string

+ Update SessionUpdate

+ type SessionResumeCapabilities struct

+ Meta json.RawMessage

type SessionUpdate

+ Kind ToolKind

+ Locations []ToolCallLocation

+ Meta json.RawMessage

+ Plan *Plan

+ RawInput json.RawMessage

+ RawOutput json.RawMessage

+ Status ToolCallStatus

+ Title string

+ ToolCallID string

+ Type string

+ type SetSessionConfigOptionRequest struct

+ ConfigID SessionConfigId

+ Meta json.RawMessage

+ SessionID string

+ Value SessionConfigValueId

+ type SetSessionConfigOptionResponse struct

+ ConfigOptions []SessionConfigOption

+ Meta json.RawMessage

+ type SetSessionModeRequest struct

+ Meta json.RawMessage

+ Mode SessionModeId

+ SessionID string

+ type SetSessionModeResponse struct

+ Meta json.RawMessage

+ type StopReason string

+ const StopReasonCancelled

+ const StopReasonEndTurn

+ const StopReasonError

+ const StopReasonMaxTokens

+ const StopReasonMaxTurns

+ const StopReasonToolUse

+ type TerminalExitStatus struct

+ ExitCode *int

+ Meta json.RawMessage

+ Signal string

+ type TerminalOutputRequest struct

+ Meta json.RawMessage

+ TerminalID string

+ type TerminalOutputResponse struct

+ ExitStatus *TerminalExitStatus

+ Meta json.RawMessage

+ Output string

+ Truncated bool

+ type TextResourceContents struct

+ Meta json.RawMessage

+ Text string

+ URI string

+ type ToolCallContent struct

+ Diff *Diff

+ Meta json.RawMessage

+ TerminalID string

+ Text string

+ Type string

+ type ToolCallContentEntry struct

+ Content *ContentBlock

+ Meta json.RawMessage

+ NewText string

+ OldText string

+ Path string

+ TerminalID string

+ Type string

+ type ToolCallId = string

+ type ToolCallLocation struct

+ Line *int

+ Meta json.RawMessage

+ Path string

+ type ToolCallStatus string

+ const ToolCallStatusCompleted

+ const ToolCallStatusFailed

+ const ToolCallStatusInProgress

+ const ToolCallStatusPending

type ToolCallUpdate

+ Locations []ToolCallLocation

+ Meta json.RawMessage

+ type ToolKind string

+ const ToolKindBrowser

+ const ToolKindEdit

+ const ToolKindExecute

+ const ToolKindOther

+ const ToolKindRead

+ const ToolKindSearch

+ const ToolKindThink

+ type WaitForTerminalExitRequest struct

+ Meta json.RawMessage

+ TerminalID string

+ type WaitForTerminalExitResponse struct

+ ExitStatus TerminalExitStatus

+ Meta json.RawMessage

+ type WriteTextFileRequest struct

+ Content string

+ Meta json.RawMessage

+ Path string

+ type WriteTextFileResponse struct

+ Meta json.RawMessage

Apr 25, 2026

Changes in this version

+ const ErrCodeInternalError

+ const ErrCodeInvalidParams

+ const ErrCodeInvalidRequest

+ const ErrCodeMethodNotFound

+ const ErrCodeParseError

+ type AgentCapabilities struct

+ LoadSession bool

+ MCPCapabilities *MCPCapabilities

+ PromptCapabilities *PromptCapabilities

+ type AgentLoop struct

+ func NewAgentLoop(cfg *config.Config, registry *tool.Registry, transport *Transport, ...) *AgentLoop

+ func (al *AgentLoop) ExecutePrompt(ctx context.Context, prompt []ContentBlock) error

+ func (al *AgentLoop) ReadFile(ctx context.Context, path string) (string, error)

+ func (al *AgentLoop) RequestPermission(ctx context.Context, req PermissionRequest) (bool, error)

+ func (al *AgentLoop) SetMode(mode string)

+ func (al *AgentLoop) Stop()

+ func (al *AgentLoop) WriteFile(ctx context.Context, path, content string) error

+ type AuthCapabilities struct

+ Terminal bool

+ type AuthEnvVar struct

+ Label string

+ Name string

+ Optional *bool

+ Secret *bool

+ type AuthHandler struct

+ func NewAuthHandler(transport *Transport, sessionID string) *AuthHandler

+ func (ah *AuthHandler) HandleAgentAuth(ctx context.Context) error

+ func (ah *AuthHandler) HandleEnvVarAuth(vars []AuthEnvVar) error

+ type AuthMethod struct

+ Args []string

+ Description string

+ Env map[string]string

+ ID string

+ Link string

+ Name string

+ Type string

+ Vars []AuthEnvVar

+ type AuthenticateParams struct

+ AuthMethodID string

+ type AuthenticateResult struct

+ type ClientCapabilities struct

+ Auth *AuthCapabilities

+ FS *FSCapability

+ Terminal bool

+ type ContentBlock struct

+ ImageData string

+ ImageMIME string

+ ImageURL string

+ Input json.RawMessage

+ IsError bool

+ Output string

+ Text string

+ ToolID string

+ ToolName string

+ Type string

+ type DeviceCodeResponse struct

+ DeviceCode string

+ ExpiresIn int

+ Interval int

+ UserCode string

+ VerificationURI string

+ type DeviceTokenResponse struct

+ AccessToken string

+ Error string

+ Scope string

+ TokenType string

+ type EnvVariable struct

+ Name string

+ Value string

+ type FSCapability struct

+ ReadTextFile bool

+ WriteTextFile bool

+ type FSReadTextFileParams struct

+ Path string

+ type FSReadTextFileResult struct

+ Content string

+ type FSWriteTextFileParams struct

+ Content string

+ Path string

+ type FSWriteTextFileResult struct

+ type HTTPHeader struct

+ Name string

+ Value string

+ type Handler struct

+ func NewHandler(cfg *config.Config, registry *tool.Registry, transport *Transport, ...) *Handler

+ func (h *Handler) Run(ctx context.Context) error

+ type ImplementationInfo struct

+ Name string

+ Title string

+ Version string

+ type InitializeParams struct

+ ClientCapabilities ClientCapabilities

+ ClientInfo *ImplementationInfo

+ ProtocolVersion int

+ type InitializeResult struct

+ AgentCapabilities AgentCapabilities

+ AgentInfo ImplementationInfo

+ AuthMethods []AuthMethod

+ ProtocolVersion int

+ type JSONRPCError struct

+ Code int

+ Data interface{}

+ Message string

+ type JSONRPCNotification struct

+ JSONRPC string

+ Method string

+ Params json.RawMessage

+ type JSONRPCRequest struct

+ ID *int

+ JSONRPC string

+ Method string

+ Params json.RawMessage

+ type JSONRPCResponse struct

+ Error *JSONRPCError

+ ID *int

+ JSONRPC string

+ RawResult json.RawMessage

+ Result interface{}

+ type MCPCapabilities struct

+ HTTP bool

+ SSE bool

+ type MCPManager struct

+ func NewMCPManager(registry *tool.Registry) *MCPManager

+ func (m *MCPManager) Close() error

+ func (m *MCPManager) ConnectServers(ctx context.Context, servers []MCPServer) error

+ type MCPServer struct

+ Args []string

+ Command string

+ Env []EnvVariable

+ Headers []HTTPHeader

+ Name string

+ Type string

+ URL string

+ type Message struct

+ Content []ContentBlock

+ Role string

+ type PermissionRequest struct

+ Command string

+ Description string

+ Path string

+ Type string

+ type PermissionRequestParams struct

+ Request PermissionRequest

+ SessionID string

+ type PermissionResponseParams struct

+ Approved bool

+ SessionID string

+ type PromptCapabilities struct

+ Audio bool

+ EmbeddedContext bool

+ Image bool

+ type Session struct

+ CWD string

+ Cancel func()

+ CreatedAt time.Time

+ ID string

+ MCPServers []MCPServer

+ func LoadSession(dir, id string) (*Session, error)

+ func NewSession(cwd string, mcpServers []MCPServer) *Session

+ func (s *Session) AddMessage(role string, content []ContentBlock)

+ func (s *Session) DoCancel()

+ func (s *Session) Messages() []Message

+ func (s *Session) Save(dir string) error

+ func (s *Session) SetCancel(cancel func())

+ type SessionCancelParams struct

+ SessionID string

+ type SessionData struct

+ CWD string

+ CreatedAt time.Time

+ ID string

+ MCPServers []MCPServer

+ Messages []Message

+ UpdatedAt time.Time

+ type SessionLoadParams struct

+ SessionID string

+ type SessionLoadResult struct

+ Messages []Message

+ SessionID string

+ type SessionNewParams struct

+ CWD string

+ MCPServers []MCPServer

+ type SessionNewResult struct

+ SessionID string

+ type SessionPromptParams struct

+ Prompt []ContentBlock

+ SessionID string

+ type SessionPromptResult struct

+ type SessionSetModeParams struct

+ Mode string

+ SessionID string

+ type SessionSetModeResult struct

+ type SessionUpdate struct

+ Content *ContentBlock

+ SessionUpdateType string

+ ToolCall *ToolCallUpdate

+ type SessionUpdateParams struct

+ SessionID string

+ Update SessionUpdate

+ type TerminalCreateParams struct

+ CWD string

+ Command string

+ Env map[string]string

+ type TerminalCreateResult struct

+ TerminalID string

+ type TerminalOutputParams struct

+ Data string

+ ExitCode *int

+ TerminalID string

+ type ToolCallUpdate struct

+ Content *ContentBlock

+ Kind string

+ RawInput string

+ RawOutput string

+ Status string

+ Title string

+ ToolCallID string

+ type Transport struct

+ Scanner *bufio.Scanner

+ Writer io.Writer

+ func NewTransport(r io.Reader, w io.Writer) *Transport

+ func (t *Transport) CloseWriter() error

+ func (t *Transport) DeliverResponse(resp *JSONRPCResponse)

+ func (t *Transport) ReadAnyMessage() (*JSONRPCRequest, *JSONRPCResponse, error)

+ func (t *Transport) ReadMessage() (*JSONRPCRequest, error)

+ func (t *Transport) ReadRaw() ([]byte, error)

+ func (t *Transport) SendRequest(method string, params interface{}, timeout time.Duration) (json.RawMessage, error)

+ func (t *Transport) WriteError(id int, code int, msg string) error

+ func (t *Transport) WriteErrorNilID(code int, msg string) error

+ func (t *Transport) WriteNotification(method string, params interface{}) error

+ func (t *Transport) WriteRaw(data []byte) error

+ func (t *Transport) WriteResponse(id int, result interface{}) error