Tool Execution Notifications

Notifications about the lifecycle of tool runs, including start, approval, progress, and completion. Subscribe to monitor and intervene in tool usage.

`NOTIFICATION_TOOL_EXECUTION_INITIATED`

Tool execution started.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_INITIATED",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution started",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

`NOTIFICATION_TOOL_EXECUTION_IN_PROGRESS`

Tool execution in progress.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_IN_PROGRESS",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution in progress",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_REQUIRED`

Tool execution requires approval.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_APPROVAL_REQUIRED",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution requires approval",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ACCEPTED`

Tool execution approved.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_APPROVAL_ACCEPTED",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution approved",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_DENIED`

Tool execution denied.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_APPROVAL_DENIED",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution denied",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ABORTED`

Tool execution aborted with feedback.

{
  "type": "NOTIFICATION_TOOL_EXECUTION_APPROVAL_ABORTED",
  "eventId": "evt_1",
  "threadId": "thread_456",
  "requestId": "req_1",
  "eventMessage": {
    "agent": null,
    "content": "tool execution aborted with feedback",
    "collaborationId": null,
    "activeAssistantCollaborationRequired": null,
    "toolExecutionApprovalRequest": null,
    "timestamp": "2025-08-12T00:00:00"
  }
}

API Reference

Session Thread APIs

Stream Events

`NOTIFICATION_TOOL_EXECUTION_INITIATED`

`NOTIFICATION_TOOL_EXECUTION_IN_PROGRESS`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_REQUIRED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ACCEPTED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_DENIED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ABORTED`

​NOTIFICATION_TOOL_EXECUTION_INITIATED

​NOTIFICATION_TOOL_EXECUTION_IN_PROGRESS

​NOTIFICATION_TOOL_EXECUTION_APPROVAL_REQUIRED

​NOTIFICATION_TOOL_EXECUTION_APPROVAL_ACCEPTED

​NOTIFICATION_TOOL_EXECUTION_APPROVAL_DENIED

​NOTIFICATION_TOOL_EXECUTION_APPROVAL_ABORTED

`NOTIFICATION_TOOL_EXECUTION_INITIATED`

`NOTIFICATION_TOOL_EXECUTION_IN_PROGRESS`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_REQUIRED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ACCEPTED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_DENIED`

`NOTIFICATION_TOOL_EXECUTION_APPROVAL_ABORTED`