ProviderExecutedToolMetadata

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

Convention for tool-call metadata that marks a call as provider-executed — run by the provider's own infrastructure (e.g. Anthropic web_search / web_fetch server tools) rather than by the agent loop. Adapters set providerExecuted: true so that:

The agent loop never tries to execute the call client-side (see isProviderExecutedToolCall usage in the chat engine), and
The adapter can stash the raw provider result alongside it so the call — and its evidence — round-trips into the next turn's request.

Provider-specific payloads live under a namespaced key (e.g. anthropic), keeping this convention opaque to the framework core. The index signature preserves those per-adapter fields. sources is the normalized list of links a web search used, shared across providers.

Indexable

ts

[key: string]: unknown

Properties

providerExecuted?

ts

optional providerExecuted?: boolean;

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

sources?

ts

optional sources?: ProviderExecutedToolSource[];

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

Next@tanstack/ai