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.