Open History to see the last commit
1---
2id: ProviderExecutedToolMetadata
3title: ProviderExecutedToolMetadata
4---
5
6# Interface: ProviderExecutedToolMetadata
7
8Defined in: [packages/ai/src/types.ts:178](https://github.com/TanStack/ai/blob/main/packages/ai/src/types.ts#L178)
9
10Convention for tool-call `metadata` that marks a call as **provider-executed**
11— run by the provider's own infrastructure (e.g. Anthropic `web_search` /
12`web_fetch` server tools) rather than by the agent loop. Adapters set
13`providerExecuted: true` so that:
14
151. The agent loop never tries to execute the call client-side (see
16 [isProviderExecutedToolCall](../functions/isProviderExecutedToolCall.md) usage in the chat engine), and
172. The adapter can stash the raw provider result alongside it so the call —
18 and its evidence — round-trips into the next turn's request.
19
20Provider-specific payloads live under a namespaced key (e.g. `anthropic`),
21keeping this convention opaque to the framework core. The index signature
22preserves those per-adapter fields.
23
24## Indexable
25
26```ts
27[key: string]: unknown
28```
29
30## Properties
31
32### providerExecuted?
33
34```ts
35optional providerExecuted: boolean;
36```
37
38Defined in: [packages/ai/src/types.ts:179](https://github.com/TanStack/ai/blob/main/packages/ai/src/types.ts#L179)