ExperimentalExperimental
Connects this agent app to a transport stream.
Experimental
Connects this agent app directly to a client app.
This is useful for tests and in-process examples that do not need a transport.
Experimental
Connects this agent app to a stream or client app for the lifetime of op.
The callback receives an AgentContext for calling client-side methods.
When op resolves or rejects, the connection is closed.
Experimental
Registers a handler that runs when this agent app opens a connection.
Use this for connection-scoped work that needs to call client-side ACP
methods outside an inbound request handler, or to set up per-connection
state that the request handlers use. Requests and notifications sent
through connection.client wait until initialize has completed.
Handlers are called synchronously in registration order and are not awaited. A handler that throws or rejects closes the connection. When they are called depends on who opens the connection:
connect(...) and connectWith(...) call them before the connection
handles its first inbound message, and so does
AgentProtocolRouter.connect when it routes to this app. Only the
work a handler does before its first await is guaranteed to come first.AcpServer calls them after the client has completed
initialize. Request handlers, including initialize, can run before
them.Experimental
Registers a request handler by ACP method name.
Built-in method literals infer their params and response types from
method. Pass a parser as the second argument to register custom extension
methods.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a request handler by ACP method name.
Built-in method literals infer their params and response types from
method. Pass a parser as the second argument to register custom extension
methods.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a request handler by ACP method name.
Built-in method literals infer their params and response types from
method. Pass a parser as the second argument to register custom extension
methods.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a request handler by ACP method name.
Built-in method literals infer their params and response types from
method. Pass a parser as the second argument to register custom extension
methods.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a notification handler by ACP method name.
Built-in method literals infer their params type from method. Pass a
parser as the second argument to register custom extension notifications.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a notification handler by ACP method name.
Built-in method literals infer their params type from method. Pass a
parser as the second argument to register custom extension notifications.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a notification handler by ACP method name.
Built-in method literals infer their params type from method. Pass a
parser as the second argument to register custom extension notifications.
Use "*" without a parser for a raw fallback after normal dispatch.
Experimental
Registers a notification handler by ACP method name.
Built-in method literals infer their params type from method. Pass a
parser as the second argument to register custom extension notifications.
Use "*" without a parser for a raw fallback after normal dispatch.
Agent-side app builder for the experimental draft ACP v2 API.
Methods on this class register typed request or notification handlers and return
this, so apps can be built with a fluent chain. Handler params are parsed with the generated ACP schemas before your handler runs, and thrown errors are converted to JSON-RPC errors by the connection layer.