Type Alias: ToolExecutionContext<TContext>

type ToolExecutionContext<TContext> = RuntimeContextField<TContext> & object;

type ToolExecutionContext<TContext> = RuntimeContextField<TContext> & object;

Defined in: packages/ai/src/types.ts:489

Context passed to tool execute functions, providing capabilities like emitting custom events during execution.

Type Declaration

emitCustomEvent()

emitCustomEvent: (eventName, value) => void;

emitCustomEvent: (eventName, value) => void;

Emit a custom event during tool execution. Events are streamed to the client in real-time as AG-UI CUSTOM events.

Parameters

eventName

string

Name of the custom event

value

Record<string, any>

Event payload value

Returns

void

Example

const tool = toolDefinition({ ... }).server(async (args, context) => {
  context?.emitCustomEvent('progress', { step: 1, total: 3 })
  // ... do work ...
  context?.emitCustomEvent('progress', { step: 2, total: 3 })
  // ... do more work ...
  return result
})

const tool = toolDefinition({ ... }).server(async (args, context) => {
  context?.emitCustomEvent('progress', { step: 1, total: 3 })
  // ... do work ...
  context?.emitCustomEvent('progress', { step: 2, total: 3 })
  // ... do more work ...
  return result
})

toolCallId?

optional toolCallId: string;

optional toolCallId: string;

The ID of the tool call being executed

Type Parameters

TContext

TContext = unknown

ToolExecutionContext

Type Alias: ToolExecutionContext<TContext>#

Type Declaration#

emitCustomEvent()#

Parameters#

eventName#

value#

Returns#

Example#

toolCallId?#

Type Parameters#

TContext#