tool_poll

tool_poll is a built-in tool that retrieves the status and result of an async tool execution. Agents call it after dispatching an async tool to check whether the background job has completed.

Parameters

// tool_poll parameters
{
  taskId: string  // UUID returned by the async tool call
}

Response shape

{
  taskId: string
  status: 'running' | 'done' | 'error'
  toolName: string
  result?: unknown      // present when status === 'done'
  errorMessage?: string // present when status === 'error'
  createdAt: string
  updatedAt: string
}

Typical agent pattern

1. Agent calls heavy_analysis({ dataset: "q4-sales" }) and receives { taskId: "abc-123", status: "running" }
2. Agent continues with other work
3. Agent calls tool_poll({ taskId: "abc-123" }) and receives { status: "done", result: {...} }