Skip to content

Documentation / @agentick/client / ToolConfirmations

Class: ToolConfirmations ​

Defined in: client/src/tool-confirmations.ts:22

Manages tool confirmation lifecycle with a configurable policy.

Incoming confirmations are evaluated by the ConfirmationPolicy:

  • "approve" / "deny" — auto-resolved, never surfaced to consumer.
  • "prompt" (default) — stored as pending for consumer to resolve.

Standalone: Self-subscribes to tool confirmations by default. Composed: Pass subscribe: false and call handleConfirmation() from a parent controller (e.g. ChatSession).

Constructors ​

Constructor ​

new ToolConfirmations(client, options?): ToolConfirmations

Defined in: client/src/tool-confirmations.ts:30

Parameters ​

client ​

AgentickClient

options? ​

ToolConfirmationsOptions = {}

Returns ​

ToolConfirmations

Accessors ​

pending ​

Get Signature ​

get pending(): ToolConfirmationState | null

Defined in: client/src/tool-confirmations.ts:46

Returns ​

ToolConfirmationState | null


state ​

Get Signature ​

get state(): ToolConfirmationsState

Defined in: client/src/tool-confirmations.ts:42

Returns ​

ToolConfirmationsState

Methods ​

destroy() ​

destroy(): void

Defined in: client/src/tool-confirmations.ts:97

Returns ​

void


handleConfirmation() ​

handleConfirmation(request, respond): void

Defined in: client/src/tool-confirmations.ts:54

Handle an incoming tool confirmation. Called automatically when self-subscribing, or manually by a parent controller.

Parameters ​

request ​

ToolConfirmationRequest

respond ​

(response) => void

Returns ​

void


onStateChange() ​

onStateChange(listener): () => void

Defined in: client/src/tool-confirmations.ts:92

Parameters ​

listener ​

() => void

Returns ​

(): void

Returns ​

void


respond() ​

respond(response): void

Defined in: client/src/tool-confirmations.ts:84

Parameters ​

response ​

ToolConfirmationResponse

Returns ​

void

Released under the ISC License.