Class ClientContext

Context used by clients to call agent-side ACP methods.

connectWith passes a ClientContext to the callback. Client handlers also receive one as ctx.agent when they need to call back into the agent.

Hierarchy

AcpContext
- ClientContext

Index

Accessors

Methods

buildSession request notify

Accessors

requestId

get requestId(): JsonRpcId | undefined
JSON-RPC id of the request currently being handled.

This is undefined for notification handlers and for contexts created outside an inbound request, such as connect(...) and connectWith(...).

Returns JsonRpcId | undefined
Inherited from AcpContext.requestId
- Defined in v1/acp.ts:254

Methods

buildSession

buildSession(cwd: string): SessionBuilder
Creates a builder for starting and observing an ACP session.

Pass a string for the common case where only cwd is needed, or pass a full NewSessionRequest when you need MCP servers, _meta, or additional session fields.
Parameters
- cwd: string
Returns SessionBuilder
- Defined in v1/acp.ts:405
buildSession(request: NewSessionRequest): SessionBuilder
Creates a builder for starting and observing an ACP session.

Pass a string for the common case where only cwd is needed, or pass a full NewSessionRequest when you need MCP servers, _meta, or additional session fields.
Parameters
- request: NewSessionRequest
Returns SessionBuilder
- Defined in v1/acp.ts:406

request

request<Method extends AgentRequestMethod>(
    method: Method,
    params: AgentRequestParamsByMethod[Method],
    options?: SendRequestOptions,
): Promise<AgentRequestResponsesByMethod[Method]>
Sends a request to the agent by ACP method name.

Built-in method literals infer their params and response types. Custom methods can specify their response and params types with generics.
Type Parameters
- Method extends AgentRequestMethod
Parameters
- method: Method
- params: AgentRequestParamsByMethod[Method]
- Optionaloptions: SendRequestOptions
Returns Promise<AgentRequestResponsesByMethod[Method]>
- Defined in v1/acp.ts:453
request<Response = unknown, Params = unknown>(
    method: string,
    params?: Params,
    options?: SendRequestOptions,
): Promise<Response>
Sends a request to the agent by ACP method name.

Built-in method literals infer their params and response types. Custom methods can specify their response and params types with generics.
Type Parameters
- Response = unknown
- Params = unknown
Parameters
- method: string
- Optionalparams: Params
- Optionaloptions: SendRequestOptions
Returns Promise<Response>
- Defined in v1/acp.ts:458

notify

notify<Method extends "session/cancel">(
method: Method,
params: AgentNotificationParamsByMethod[Method],
): Promise<void>
Sends a notification to the agent by ACP method name.

Built-in method literals infer their params type. Custom notifications can specify their params type with a generic.
Type Parameters
- Method extends "session/cancel"
Parameters
- method: Method
- params: AgentNotificationParamsByMethod[Method]
Returns Promise<void>
- Defined in v1/acp.ts:479
notify<Params = unknown>(method: string, params?: Params): Promise<void>
Sends a notification to the agent by ACP method name.

Built-in method literals infer their params type. Custom notifications can specify their params type with a generic.
Type Parameters
- Params = unknown
Parameters
- method: string
- Optionalparams: Params
Returns Promise<void>
- Defined in v1/acp.ts:483