Skip to content
Source
Sign inSign up
TanStack/ai
Open History to see the last commit

ToolCallStartEvent.md

77 lines1.7 KB

1---
2id: ToolCallStartEvent
3title: ToolCallStartEvent
4---
5​
6# Interface: ToolCallStartEvent
7​
8Defined in: [packages/typescript/ai/src/types.ts:992](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L992)
9​
10Emitted when a tool call starts.
11​
12@ag-ui/core provides: `toolCallId`, `toolCallName`, `parentMessageId?`
13TanStack AI adds: `model?`, `toolName` (deprecated alias), `index?`, `metadata?`
14​
15## Extends
16​
17- `ToolCallStartEvent`
18​
19## Indexable
20​
21```ts
22[k: string]: unknown
23```
24​
25## Properties
26​
27### index?
28​
29```ts
30optional index: number;
31```
32​
33Defined in: [packages/typescript/ai/src/types.ts:1001](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1001)
34​
35Index for parallel tool calls
36​
37***
38​
39### metadata?
40​
41```ts
42optional metadata: Record<string, unknown>;
43```
44​
45Defined in: [packages/typescript/ai/src/types.ts:1006](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L1006)
46​
47Provider-specific metadata to carry into the ToolCall.
48Untyped at the event layer because events flow through a discriminated
49union that does not survive generics; adapters cast it to their typed
50`TToolCallMetadata` shape when emitting.
51​
52***
53​
54### model?
55​
56```ts
57optional model: string;
58```
59​
60Defined in: [packages/typescript/ai/src/types.ts:994](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L994)
61​
62Model identifier for multi-model support
63​
64***
65​
66### ~~toolName~~
67​
68```ts
69toolName: string;
70```
71​
72Defined in: [packages/typescript/ai/src/types.ts:999](https://github.com/TanStack/ai/blob/main/packages/typescript/ai/src/types.ts#L999)
73​
74#### Deprecated
75​
76Use `toolCallName` instead (from @ag-ui/core spec).
77Kept for backward compatibility.