ai 7.0.0-beta.109 → 7.0.0-beta.111

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/CHANGELOG.md +27 -0
  2. package/README.md +1 -1
  3. package/dist/index.d.ts +74 -26
  4. package/dist/index.js +143 -110
  5. package/dist/index.js.map +1 -1
  6. package/dist/internal/index.d.ts +11 -10
  7. package/dist/internal/index.js +8 -27
  8. package/dist/internal/index.js.map +1 -1
  9. package/dist/test/index.js +6 -6
  10. package/dist/test/index.js.map +1 -1
  11. package/docs/02-foundations/02-providers-and-models.mdx +1 -1
  12. package/docs/02-foundations/03-prompts.mdx +1 -1
  13. package/docs/02-getting-started/09-coding-agents.mdx +2 -2
  14. package/docs/03-ai-sdk-core/05-generating-text.mdx +1 -1
  15. package/docs/03-ai-sdk-core/30-embeddings.mdx +2 -2
  16. package/docs/03-ai-sdk-core/35-image-generation.mdx +3 -3
  17. package/docs/03-ai-sdk-core/38-video-generation.mdx +1 -1
  18. package/docs/03-ai-sdk-core/60-telemetry.mdx +32 -32
  19. package/docs/03-ai-sdk-core/65-devtools.mdx +3 -3
  20. package/docs/04-ai-sdk-ui/02-chatbot.mdx +1 -1
  21. package/docs/07-reference/01-ai-sdk-core/01-generate-text.mdx +3 -3
  22. package/docs/07-reference/01-ai-sdk-core/02-stream-text.mdx +3 -3
  23. package/docs/07-reference/01-ai-sdk-core/05-embed.mdx +3 -3
  24. package/docs/07-reference/01-ai-sdk-core/06-embed-many.mdx +3 -3
  25. package/docs/07-reference/01-ai-sdk-core/06-rerank.mdx +3 -3
  26. package/docs/07-reference/01-ai-sdk-core/16-tool-loop-agent.mdx +2 -2
  27. package/docs/07-reference/04-ai-sdk-workflow/01-workflow-agent.mdx +2 -2
  28. package/docs/08-migration-guides/23-migration-guide-7-0.mdx +57 -15
  29. package/package.json +3 -3
  30. package/src/agent/tool-loop-agent-settings.ts +10 -1
  31. package/src/agent/tool-loop-agent.ts +2 -2
  32. package/src/embed/embed-many.ts +11 -3
  33. package/src/embed/embed.ts +11 -3
  34. package/src/generate-image/generate-image.ts +18 -17
  35. package/src/generate-object/generate-object.ts +10 -3
  36. package/src/generate-object/stream-object.ts +10 -3
  37. package/src/generate-text/create-execute-tools-transformation.ts +2 -2
  38. package/src/generate-text/execute-tool-call.ts +36 -39
  39. package/src/generate-text/generate-text.ts +31 -22
  40. package/src/generate-text/is-tool-approval-needed.ts +15 -9
  41. package/src/generate-text/stream-text.ts +11 -3
  42. package/src/generate-text/validate-tool-context.ts +34 -0
  43. package/src/generate-video/generate-video.ts +17 -16
  44. package/src/global.ts +3 -3
  45. package/src/middleware/wrap-embedding-model.ts +3 -3
  46. package/src/middleware/wrap-image-model.ts +3 -3
  47. package/src/middleware/wrap-language-model.ts +13 -8
  48. package/src/rerank/rerank.ts +11 -3
  49. package/src/telemetry/create-unified-telemetry.ts +14 -15
  50. package/src/telemetry/index.ts +2 -2
  51. package/src/telemetry/telemetry-options.ts +2 -2
  52. package/src/telemetry/{telemetry-integration-registry.ts → telemetry-registry.ts} +3 -5
  53. package/src/telemetry/{telemetry-integration.ts → telemetry.ts} +1 -1
  54. package/src/test/mock-language-model-v2.ts +3 -3
  55. package/src/test/mock-language-model-v3.ts +3 -3
  56. package/src/test/mock-language-model-v4.ts +3 -3
  57. package/src/ui/validate-ui-messages.ts +9 -0
  58. package/src/util/create-stitchable-stream.ts +1 -1
  59. package/src/util/download/download-function.ts +1 -1
  60. package/src/util/merge-abort-signals.ts +17 -35
  61. package/src/util/notify.ts +8 -6
  62. package/src/util/retry-with-exponential-backoff.ts +2 -2
package/CHANGELOG.md CHANGED
@@ -1,5 +1,32 @@
1
1
  # ai
2
2
 
3
+ ## 7.0.0-beta.111
4
+
5
+ ### Major Changes
6
+
7
+ - 1949571: feat(ai): make experimental_telemetry stable
8
+ - 6542d93: feat(ai): change naming nomenclature for `*TelemetryIntegration` to `*Telemetry`
9
+
10
+ ### Patch Changes
11
+
12
+ - f319fde: feat(ai): validate tool context against contextSchema at runtime
13
+
14
+ Tool execution and approval callbacks now validate each tool's `toolsContext` entry against its `contextSchema`. Invalid tool context now throws `TypeValidationError` with tool-context validation metadata in `error.context`.
15
+
16
+ - 511902c: skip validation for tool parts in terminal states when tool schema is no longer registered
17
+ - 2e98477: fix: retain stack traces on async errors
18
+ - 876fd3e: fix(ai): limit tool execution time duration to actual tool execution
19
+ - f32c750: refactoring(ai): simplify mergeAbortSignals
20
+ - Updated dependencies [2e98477]
21
+ - @ai-sdk/provider-utils@5.0.0-beta.26
22
+ - @ai-sdk/gateway@4.0.0-beta.62
23
+
24
+ ## 7.0.0-beta.110
25
+
26
+ ### Patch Changes
27
+
28
+ - 72cb801: feat(ai): concurrent event notification
29
+
3
30
  ## 7.0.0-beta.109
4
31
 
5
32
  ### Patch Changes
package/README.md CHANGED
@@ -24,7 +24,7 @@ npx skills add vercel/ai
24
24
 
25
25
  ## Unified Provider Architecture
26
26
 
27
- The AI SDK provides a [unified API](https://ai-sdk.dev/docs/foundations/providers-and-models) to interact with model providers like [OpenAI](https://ai-sdk.dev/providers/ai-sdk-providers/openai), [Anthropic](https://ai-sdk.dev/providers/ai-sdk-providers/anthropic), [Google](https://ai-sdk.dev/providers/ai-sdk-providers/google-generative-ai), and [more](https://ai-sdk.dev/providers/ai-sdk-providers).
27
+ The AI SDK provides a [unified API](https://ai-sdk.dev/docs/foundations/providers-and-models) to interact with model providers like [OpenAI](https://ai-sdk.dev/providers/ai-sdk-providers/openai), [Anthropic](https://ai-sdk.dev/providers/ai-sdk-providers/anthropic), [Google](https://ai-sdk.dev/providers/ai-sdk-providers/google), and [more](https://ai-sdk.dev/providers/ai-sdk-providers).
28
28
 
29
29
  By default, the AI SDK uses the [Vercel AI Gateway](https://vercel.com/docs/ai-gateway) to give you access to all major providers out of the box. Just pass a model string for any supported model:
30
30
 
package/dist/index.d.ts CHANGED
@@ -2853,7 +2853,7 @@ interface RerankFinishEvent {
2853
2853
  * Implement this interface to create custom telemetry integrations.
2854
2854
  * Methods can be sync or return a PromiseLike.
2855
2855
  */
2856
- interface TelemetryIntegration {
2856
+ interface Telemetry {
2857
2857
  /**
2858
2858
  * Called when an operation begins. Fired for text generation
2859
2859
  * (generateText/streamText), object generation (generateObject/streamObject),
@@ -2997,7 +2997,7 @@ type TelemetryOptions = {
2997
2997
  * When provided, these integrations will take precedence over the globally registered
2998
2998
  * integrations for this call.
2999
2999
  */
3000
- integrations?: Arrayable<TelemetryIntegration>;
3000
+ integrations?: Arrayable<Telemetry>;
3001
3001
  };
3002
3002
 
3003
3003
  /**
@@ -3324,7 +3324,7 @@ type StreamTextOnStepStartCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONT
3324
3324
  * @returns
3325
3325
  * A result object for accessing different stream types and additional information.
3326
3326
  */
3327
- declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, timeout, headers, stopWhen, output, toolNeedsApproval, experimental_telemetry: telemetry, prepareStep, providerOptions, activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError, onFinish, onAbort, onStepFinish, experimental_onStart: onStart, experimental_onStepStart: onStepStart, experimental_onToolExecutionStart: onToolExecutionStart, experimental_onToolExecutionEnd: onToolExecutionEnd, runtimeContext, toolsContext, experimental_include: include, _internal: { now, generateId, generateCallId, }, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
3327
+ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>({ model, tools, toolChoice, system, prompt, messages, maxRetries, abortSignal, timeout, headers, stopWhen, output, toolNeedsApproval, experimental_telemetry, telemetry, prepareStep, providerOptions, activeTools, experimental_repairToolCall: repairToolCall, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError, onFinish, onAbort, onStepFinish, experimental_onStart: onStart, experimental_onStepStart: onStepStart, experimental_onToolExecutionStart: onToolExecutionStart, experimental_onToolExecutionEnd: onToolExecutionEnd, runtimeContext, toolsContext, experimental_include: include, _internal: { now, generateId, generateCallId, }, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
3328
3328
  /**
3329
3329
  * The language model to use.
3330
3330
  */
@@ -3341,7 +3341,13 @@ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Conte
3341
3341
  */
3342
3342
  stopWhen?: Arrayable<StopCondition<NoInfer<TOOLS>, RUNTIME_CONTEXT>>;
3343
3343
  /**
3344
- * Optional telemetry configuration (experimental).
3344
+ * Optional telemetry configuration.
3345
+ */
3346
+ telemetry?: TelemetryOptions;
3347
+ /**
3348
+ * Optional telemetry configuration.
3349
+ *
3350
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
3345
3351
  */
3346
3352
  experimental_telemetry?: TelemetryOptions;
3347
3353
  /**
@@ -3773,7 +3779,13 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
3773
3779
  */
3774
3780
  stopWhen?: Arrayable<StopCondition<NoInfer<TOOLS>, RUNTIME_CONTEXT>>;
3775
3781
  /**
3776
- * Optional telemetry configuration (experimental).
3782
+ * Optional telemetry configuration.
3783
+ */
3784
+ telemetry?: TelemetryOptions;
3785
+ /**
3786
+ * Optional telemetry configuration.
3787
+ *
3788
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
3777
3789
  */
3778
3790
  experimental_telemetry?: TelemetryOptions;
3779
3791
  /**
@@ -3856,9 +3868,9 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
3856
3868
  *
3857
3869
  * You can use this to have templates based on call options.
3858
3870
  */
3859
- prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'onStepFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'headers' | 'instructions' | 'stopWhen' | 'experimental_telemetry' | 'activeTools' | 'toolNeedsApproval' | 'providerOptions' | 'experimental_download' | 'runtimeContext' | '_internal'> & {
3871
+ prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'onStepFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'headers' | 'instructions' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolNeedsApproval' | 'providerOptions' | 'experimental_download' | 'runtimeContext' | '_internal'> & {
3860
3872
  toolsContext: InferToolSetContext<TOOLS>;
3861
- }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'headers' | 'instructions' | 'stopWhen' | 'experimental_telemetry' | 'activeTools' | 'toolNeedsApproval' | 'providerOptions' | 'experimental_download' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
3873
+ }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'headers' | 'instructions' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolNeedsApproval' | 'providerOptions' | 'experimental_download' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
3862
3874
  toolsContext: InferToolSetContext<TOOLS>;
3863
3875
  }>;
3864
3876
  };
@@ -4124,7 +4136,7 @@ type GenerateTextOnFinishCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTE
4124
4136
  * @returns
4125
4137
  * A result object that contains the generated text, the results of the tool calls, and additional information.
4126
4138
  */
4127
- declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string>>({ model: modelArg, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen, output, toolNeedsApproval, experimental_telemetry: telemetry, providerOptions, activeTools, prepareStep, experimental_repairToolCall: repairToolCall, experimental_download: download, runtimeContext, toolsContext, experimental_include: include, _internal: { generateId, generateCallId, }, experimental_onStart: onStart, experimental_onStepStart: onStepStart, experimental_onToolExecutionStart: onToolExecutionStart, experimental_onToolExecutionEnd: onToolExecutionEnd, onStepFinish, onFinish, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
4139
+ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string>>({ model: modelArg, tools, toolChoice, system, prompt, messages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen, output, toolNeedsApproval, experimental_telemetry, telemetry, providerOptions, activeTools, prepareStep, experimental_repairToolCall: repairToolCall, experimental_download: download, runtimeContext, toolsContext, experimental_include: include, _internal: { generateId, generateCallId, }, experimental_onStart: onStart, experimental_onStepStart: onStepStart, experimental_onToolExecutionStart: onToolExecutionStart, experimental_onToolExecutionEnd: onToolExecutionEnd, onStepFinish, onFinish, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
4128
4140
  /**
4129
4141
  * The language model to use.
4130
4142
  */
@@ -4141,7 +4153,13 @@ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Con
4141
4153
  */
4142
4154
  stopWhen?: Arrayable<StopCondition<NoInfer<TOOLS>, RUNTIME_CONTEXT>>;
4143
4155
  /**
4144
- * Optional telemetry configuration (experimental).
4156
+ * Optional telemetry configuration.
4157
+ */
4158
+ telemetry?: TelemetryOptions;
4159
+ /**
4160
+ * Optional telemetry configuration.
4161
+ *
4162
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
4145
4163
  */
4146
4164
  experimental_telemetry?: TelemetryOptions;
4147
4165
  /**
@@ -5282,7 +5300,7 @@ interface EmbedResult {
5282
5300
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
5283
5301
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
5284
5302
  *
5285
- * @param experimental_telemetry - Optional telemetry configuration (experimental).
5303
+ * @param telemetry - Optional telemetry configuration.
5286
5304
  *
5287
5305
  * @param providerOptions - Additional provider-specific options. They are passed through
5288
5306
  * to the provider from the AI SDK and enable provider-specific
@@ -5290,7 +5308,7 @@ interface EmbedResult {
5290
5308
  *
5291
5309
  * @returns A result object that contains the embedding, the value, and additional information.
5292
5310
  */
5293
- declare function embed({ model: modelArg, value, providerOptions, maxRetries: maxRetriesArg, abortSignal, headers, experimental_telemetry: telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
5311
+ declare function embed({ model: modelArg, value, providerOptions, maxRetries: maxRetriesArg, abortSignal, headers, experimental_telemetry, telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
5294
5312
  /**
5295
5313
  * The embedding model to use.
5296
5314
  */
@@ -5321,7 +5339,13 @@ declare function embed({ model: modelArg, value, providerOptions, maxRetries: ma
5321
5339
  */
5322
5340
  providerOptions?: ProviderOptions;
5323
5341
  /**
5324
- * Optional telemetry configuration (experimental).
5342
+ * Optional telemetry configuration.
5343
+ */
5344
+ telemetry?: TelemetryOptions;
5345
+ /**
5346
+ * Optional telemetry configuration.
5347
+ *
5348
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
5325
5349
  */
5326
5350
  experimental_telemetry?: TelemetryOptions;
5327
5351
  /**
@@ -5398,7 +5422,7 @@ interface EmbedManyResult {
5398
5422
  *
5399
5423
  * @param maxParallelCalls - Maximum number of concurrent requests. Default: Infinity.
5400
5424
  *
5401
- * @param experimental_telemetry - Optional telemetry configuration (experimental).
5425
+ * @param telemetry - Optional telemetry configuration.
5402
5426
  *
5403
5427
  * @param providerOptions - Additional provider-specific options. They are passed through
5404
5428
  * to the provider from the AI SDK and enable provider-specific
@@ -5406,7 +5430,7 @@ interface EmbedManyResult {
5406
5430
  *
5407
5431
  * @returns A result object that contains the embeddings, the value, and additional information.
5408
5432
  */
5409
- declare function embedMany({ model: modelArg, values, maxParallelCalls, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry: telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
5433
+ declare function embedMany({ model: modelArg, values, maxParallelCalls, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry, telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
5410
5434
  /**
5411
5435
  * The embedding model to use.
5412
5436
  */
@@ -5431,7 +5455,13 @@ declare function embedMany({ model: modelArg, values, maxParallelCalls, maxRetri
5431
5455
  */
5432
5456
  headers?: Record<string, string>;
5433
5457
  /**
5434
- * Optional telemetry configuration (experimental).
5458
+ * Optional telemetry configuration.
5459
+ */
5460
+ telemetry?: TelemetryOptions;
5461
+ /**
5462
+ * Optional telemetry configuration.
5463
+ *
5464
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
5435
5465
  */
5436
5466
  experimental_telemetry?: TelemetryOptions;
5437
5467
  /**
@@ -6017,7 +6047,7 @@ type RepairTextFunction = (options: {
6017
6047
  * @param experimental_repairText - A function that attempts to repair the raw output of the model
6018
6048
  * to enable JSON parsing.
6019
6049
  *
6020
- * @param experimental_telemetry - Optional telemetry configuration (experimental).
6050
+ * @param telemetry - Optional telemetry configuration.
6021
6051
  *
6022
6052
  * @param providerOptions - Additional provider-specific options. They are passed through
6023
6053
  * to the provider from the AI SDK and enable provider-specific
@@ -6068,7 +6098,13 @@ declare function generateObject<SCHEMA extends FlexibleSchema<unknown> = Flexibl
6068
6098
  */
6069
6099
  experimental_repairText?: RepairTextFunction;
6070
6100
  /**
6071
- * Optional telemetry configuration (experimental).
6101
+ * Optional telemetry configuration.
6102
+ */
6103
+ telemetry?: TelemetryOptions;
6104
+ /**
6105
+ * Optional telemetry configuration.
6106
+ *
6107
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
6072
6108
  */
6073
6109
  experimental_telemetry?: TelemetryOptions;
6074
6110
  /**
@@ -6390,7 +6426,7 @@ type StreamObjectOnFinishCallback<RESULT> = (event: {
6390
6426
  * - 'enum': The output is an enum.
6391
6427
  * - 'no-schema': The output is not a schema.
6392
6428
  *
6393
- * @param experimental_telemetry - Optional telemetry configuration (experimental).
6429
+ * @param telemetry - Optional telemetry configuration.
6394
6430
  *
6395
6431
  * @param providerOptions - Additional provider-specific options. They are passed through
6396
6432
  * to the provider from the AI SDK and enable provider-specific
@@ -6436,7 +6472,13 @@ declare function streamObject<SCHEMA extends FlexibleSchema<unknown> = FlexibleS
6436
6472
  */
6437
6473
  experimental_repairText?: RepairTextFunction;
6438
6474
  /**
6439
- * Optional telemetry configuration (experimental).
6475
+ * Optional telemetry configuration.
6476
+ */
6477
+ telemetry?: TelemetryOptions;
6478
+ /**
6479
+ * Optional telemetry configuration.
6480
+ *
6481
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
6440
6482
  */
6441
6483
  experimental_telemetry?: TelemetryOptions;
6442
6484
  /**
@@ -7102,11 +7144,11 @@ interface RerankResult<VALUE> {
7102
7144
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
7103
7145
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
7104
7146
  * @param providerOptions - Additional provider-specific options.
7105
- * @param experimental_telemetry - Optional telemetry configuration (experimental).
7147
+ * @param telemetry - Optional telemetry configuration.
7106
7148
  *
7107
7149
  * @returns A result object that contains the reranked documents, the reranked indices, and additional information.
7108
7150
  */
7109
- declare function rerank<VALUE extends JSONObject | string>({ model: modelArg, documents, query, topN, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry: telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
7151
+ declare function rerank<VALUE extends JSONObject | string>({ model: modelArg, documents, query, topN, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry, telemetry, experimental_onStart: onStart, experimental_onFinish: onFinish, _internal: { generateCallId }, }: {
7110
7152
  /**
7111
7153
  * The reranking model to use.
7112
7154
  */
@@ -7139,7 +7181,13 @@ declare function rerank<VALUE extends JSONObject | string>({ model: modelArg, do
7139
7181
  */
7140
7182
  headers?: Record<string, string>;
7141
7183
  /**
7142
- * Optional telemetry configuration (experimental).
7184
+ * Optional telemetry configuration.
7185
+ */
7186
+ telemetry?: TelemetryOptions;
7187
+ /**
7188
+ * Optional telemetry configuration.
7189
+ *
7190
+ * @deprecated Use `telemetry` instead. This alias will be removed in a future major release.
7143
7191
  */
7144
7192
  experimental_telemetry?: TelemetryOptions;
7145
7193
  /**
@@ -7169,7 +7217,7 @@ declare function rerank<VALUE extends JSONObject | string>({ model: modelArg, do
7169
7217
  /**
7170
7218
  * Registers one or more telemetry integrations globally.
7171
7219
  */
7172
- declare function registerTelemetryIntegration(...integrations: TelemetryIntegration[]): void;
7220
+ declare function registerTelemetry(...integrations: Telemetry[]): void;
7173
7221
 
7174
7222
  /**
7175
7223
  * Creates a Response object from a text stream.
@@ -7389,10 +7437,10 @@ declare global {
7389
7437
  * Integrations registered here receive lifecycle events (onStart, onStepStart,
7390
7438
  * etc.) from every `generateText`, `streamText`, and similar call.
7391
7439
  *
7392
- * Prefer using `registerTelemetryIntegration()` from `'ai'` instead of
7440
+ * Prefer using `registerTelemetry()` from `'ai'` instead of
7393
7441
  * assigning this directly.
7394
7442
  */
7395
- var AI_SDK_TELEMETRY_INTEGRATIONS: TelemetryIntegration[] | undefined;
7443
+ var AI_SDK_TELEMETRY_INTEGRATIONS: Telemetry[] | undefined;
7396
7444
  }
7397
7445
 
7398
- export { AbstractChat, Agent, AgentCallParameters, AgentStreamParameters, AsyncIterableStream, CallSettings, CallWarning, ChatAddToolApproveResponseFunction, ChatAddToolOutputFunction, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, ContentPart, CreateUIMessage, CustomContentUIPart, DataUIPart, DeepPartial, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DirectChatTransportOptions, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedFinishEvent, EmbedManyResult, EmbedOnFinishEvent, EmbedOnStartEvent, EmbedResult, EmbedStartEvent, Embedding, EmbeddingModel, EmbeddingModelMiddleware, EmbeddingModelUsage, ErrorHandler, ToolLoopAgent as Experimental_Agent, ToolLoopAgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, InferAgentUIMessage as Experimental_InferAgentUIMessage, LanguageModelStreamPart as Experimental_LanguageModelStreamPart, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, FileUIPart, FinishReason, GenerateImageResult, GenerateObjectResult, GenerateTextOnFinishCallback, GenerateTextOnStartCallback, GenerateTextOnStepFinishCallback, GenerateTextOnStepStartCallback, GenerateTextResult, GenerateVideoPrompt, GenerateVideoResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageModelMiddleware, ImageModelProviderMetadata, ImageModelResponseMetadata, ImageModelUsage, InferAgentUIMessage, InferCompleteOutput as InferGenerateOutput, InferPartialOutput as InferStreamOutput, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolInputError, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelCallOptions, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LogWarningsFunction, MessageConversionError, MissingToolResultsError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchProviderError, NoSuchToolError, NoTranscriptGeneratedError, NoVideoGeneratedError, ObjectOnFinishEvent, ObjectOnStartEvent, ObjectOnStepFinishEvent, ObjectOnStepStartEvent, ObjectStreamPart, OnChunkEvent, OnFinishEvent, OnStartEvent, OnStepFinishEvent, OnStepStartEvent, OnToolExecutionEndCallback, OnToolExecutionStartCallback, output as Output, Output as OutputInterface, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderReference, ProviderRegistryProvider, ReasoningFileOutput, ReasoningFileUIPart, ReasoningOutput, ReasoningUIPart, RepairTextFunction, RequestOptions, RerankFinishEvent, RerankOnFinishEvent, RerankOnStartEvent, RerankResult, RerankStartEvent, RerankingModel, RetryError, SafeValidateUIMessagesResult, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, StaticToolCall, StaticToolError, StaticToolOutputDenied, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStartCallback, StreamTextOnStepFinishCallback, StreamTextOnStepStartCallback, StreamTextResult, StreamTextTransform, TelemetryIntegration, TelemetryOptions, TextStreamChatTransport, TextStreamPart, TextUIPart, TimeoutConfiguration, ToolApprovalRequestOutput, ToolCallNotFoundForApprovalError, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolExecutionEndEvent, ToolExecutionStartEvent, ToolLoopAgent, ToolLoopAgentOnFinishCallback, ToolLoopAgentOnStartCallback, ToolLoopAgentOnStepFinishCallback, ToolLoopAgentOnStepStartCallback, ToolLoopAgentSettings, ToolNeedsApprovalConfiguration, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TypedToolCall, TypedToolError, TypedToolOutputDenied, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamError, UIMessageStreamOnFinishCallback, UIMessageStreamOnStepFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UploadFileResult, UploadSkillResult, UseCompletionOptions, Warning, addToolInputExamplesMiddleware, assistantModelMessageSchema, callCompletionApi, consumeStream, convertDataContentToBase64String, convertFileListToFileUIParts, convertToModelMessages, cosineSimilarity, createAgentUIStream, createAgentUIStreamResponse, createDownload, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultEmbeddingSettingsMiddleware, defaultSettingsMiddleware, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, filterActiveTools as experimental_filterActiveTools, experimental_generateImage, generateSpeech as experimental_generateSpeech, experimental_generateVideo, streamLanguageModelCall as experimental_streamLanguageModelCall, transcribe as experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, generateImage, generateObject, generateText, getChunkTimeoutMs, getStaticToolName, getStepTimeoutMs, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, getToolTimeoutMs, getTotalTimeoutMs, hasToolCall, isCustomContentUIPart, isDataUIPart, isDeepEqualData, isDynamicToolUIPart, isFileUIPart, isLoopFinished, isReasoningFileUIPart, isReasoningUIPart, isStaticToolUIPart, isStepCount, isTextUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetryIntegration, rerank, safeValidateUIMessages, simulateReadableStream, simulateStreamingMiddleware, smoothStream, isStepCount as stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel, wrapProvider };
7446
+ export { AbstractChat, Agent, AgentCallParameters, AgentStreamParameters, AsyncIterableStream, CallSettings, CallWarning, ChatAddToolApproveResponseFunction, ChatAddToolOutputFunction, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, ContentPart, CreateUIMessage, CustomContentUIPart, DataUIPart, DeepPartial, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DirectChatTransportOptions, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedFinishEvent, EmbedManyResult, EmbedOnFinishEvent, EmbedOnStartEvent, EmbedResult, EmbedStartEvent, Embedding, EmbeddingModel, EmbeddingModelMiddleware, EmbeddingModelUsage, ErrorHandler, ToolLoopAgent as Experimental_Agent, ToolLoopAgentSettings as Experimental_AgentSettings, DownloadFunction as Experimental_DownloadFunction, Experimental_GenerateImageResult, GeneratedFile as Experimental_GeneratedImage, InferAgentUIMessage as Experimental_InferAgentUIMessage, LanguageModelStreamPart as Experimental_LanguageModelStreamPart, LogWarningsFunction as Experimental_LogWarningsFunction, SpeechResult as Experimental_SpeechResult, TranscriptionResult as Experimental_TranscriptionResult, FileUIPart, FinishReason, GenerateImageResult, GenerateObjectResult, GenerateTextOnFinishCallback, GenerateTextOnStartCallback, GenerateTextOnStepFinishCallback, GenerateTextOnStepStartCallback, GenerateTextResult, GenerateVideoPrompt, GenerateVideoResult, GeneratedAudioFile, GeneratedFile, HttpChatTransport, HttpChatTransportInitOptions, ImageModel, ImageModelMiddleware, ImageModelProviderMetadata, ImageModelResponseMetadata, ImageModelUsage, InferAgentUIMessage, InferCompleteOutput as InferGenerateOutput, InferPartialOutput as InferStreamOutput, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolInputError, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelCallOptions, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LogWarningsFunction, MessageConversionError, MissingToolResultsError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchProviderError, NoSuchToolError, NoTranscriptGeneratedError, NoVideoGeneratedError, ObjectOnFinishEvent, ObjectOnStartEvent, ObjectOnStepFinishEvent, ObjectOnStepStartEvent, ObjectStreamPart, OnChunkEvent, OnFinishEvent, OnStartEvent, OnStepFinishEvent, OnStepStartEvent, OnToolExecutionEndCallback, OnToolExecutionStartCallback, output as Output, Output as OutputInterface, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderReference, ProviderRegistryProvider, ReasoningFileOutput, ReasoningFileUIPart, ReasoningOutput, ReasoningUIPart, RepairTextFunction, RequestOptions, RerankFinishEvent, RerankOnFinishEvent, RerankOnStartEvent, RerankResult, RerankStartEvent, RerankingModel, RetryError, SafeValidateUIMessagesResult, SerialJobExecutor, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, StaticToolCall, StaticToolError, StaticToolOutputDenied, StaticToolResult, StepResult, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStartCallback, StreamTextOnStepFinishCallback, StreamTextOnStepStartCallback, StreamTextResult, StreamTextTransform, Telemetry, TelemetryOptions, TextStreamChatTransport, TextStreamPart, TextUIPart, TimeoutConfiguration, ToolApprovalRequestOutput, ToolCallNotFoundForApprovalError, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolExecutionEndEvent, ToolExecutionStartEvent, ToolLoopAgent, ToolLoopAgentOnFinishCallback, ToolLoopAgentOnStartCallback, ToolLoopAgentOnStepFinishCallback, ToolLoopAgentOnStepStartCallback, ToolLoopAgentSettings, ToolNeedsApprovalConfiguration, ToolUIPart, TranscriptionModel, TranscriptionModelResponseMetadata, TypedToolCall, TypedToolError, TypedToolOutputDenied, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamError, UIMessageStreamOnFinishCallback, UIMessageStreamOnStepFinishCallback, UIMessageStreamOptions, UIMessageStreamWriter, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedModelVersionError, UploadFileResult, UploadSkillResult, UseCompletionOptions, Warning, addToolInputExamplesMiddleware, assistantModelMessageSchema, callCompletionApi, consumeStream, convertDataContentToBase64String, convertFileListToFileUIParts, convertToModelMessages, cosineSimilarity, createAgentUIStream, createAgentUIStreamResponse, createDownload, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultEmbeddingSettingsMiddleware, defaultSettingsMiddleware, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, filterActiveTools as experimental_filterActiveTools, experimental_generateImage, generateSpeech as experimental_generateSpeech, experimental_generateVideo, streamLanguageModelCall as experimental_streamLanguageModelCall, transcribe as experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, generateImage, generateObject, generateText, getChunkTimeoutMs, getStaticToolName, getStepTimeoutMs, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, getToolTimeoutMs, getTotalTimeoutMs, hasToolCall, isCustomContentUIPart, isDataUIPart, isDeepEqualData, isDynamicToolUIPart, isFileUIPart, isLoopFinished, isReasoningFileUIPart, isReasoningUIPart, isStaticToolUIPart, isStepCount, isTextUIPart, isToolUIPart, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetry, rerank, safeValidateUIMessages, simulateReadableStream, simulateStreamingMiddleware, smoothStream, isStepCount as stepCountIs, streamObject, streamText, systemModelMessageSchema, toolModelMessageSchema, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel, wrapProvider };