ai 7.0.127 → 7.0.128

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 (72) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/dist/index.d.ts +213 -153
  3. package/dist/index.d.ts.map +1 -1
  4. package/dist/index.js +239 -178
  5. package/dist/index.js.map +1 -1
  6. package/dist/internal/index.d.ts +278 -68
  7. package/dist/internal/index.d.ts.map +1 -1
  8. package/dist/internal/index.js +340 -61
  9. package/dist/internal/index.js.map +1 -1
  10. package/dist/test/index.d.ts +25 -17
  11. package/dist/test/index.d.ts.map +1 -1
  12. package/dist/test/index.js +27 -21
  13. package/dist/test/index.js.map +1 -1
  14. package/docs/02-getting-started/03-nextjs-pages-router.mdx +1 -1
  15. package/docs/02-getting-started/07-expo.mdx +1 -1
  16. package/docs/03-agents/07-workflow-agent.mdx +80 -12
  17. package/docs/03-ai-sdk-core/16-mcp-tools.mdx +44 -0
  18. package/docs/03-ai-sdk-core/{32-evaluation.mdx → 32-decisions.mdx} +49 -49
  19. package/docs/03-ai-sdk-core/35-image-generation.mdx +1 -1
  20. package/docs/03-ai-sdk-core/45-provider-management.mdx +8 -8
  21. package/docs/03-ai-sdk-core/60-telemetry.mdx +40 -31
  22. package/docs/03-ai-sdk-core/65-lifecycle-callbacks.mdx +21 -22
  23. package/docs/03-ai-sdk-harnesses/08-terminal-ui.mdx +2 -2
  24. package/docs/06-advanced/09-multistep-interfaces.mdx +1 -1
  25. package/docs/07-reference/01-ai-sdk-core/14-decide.mdx +74 -0
  26. package/docs/07-reference/01-ai-sdk-core/23-create-mcp-client.mdx +58 -4
  27. package/docs/07-reference/01-ai-sdk-core/40-provider-registry.mdx +11 -11
  28. package/docs/07-reference/01-ai-sdk-core/42-custom-provider.mdx +9 -9
  29. package/docs/07-reference/01-ai-sdk-core/66-extract-reasoning-middleware.mdx +24 -8
  30. package/docs/07-reference/02-ai-sdk-ui/32-prune-messages.mdx +1 -1
  31. package/docs/07-reference/03-ai-sdk-rsc/01-stream-ui.mdx +1 -0
  32. package/docs/07-reference/04-ai-sdk-workflow/01-workflow-agent.mdx +39 -2
  33. package/docs/07-reference/05-ai-sdk-errors/ai-decision-unsupported-question-type-error.mdx +31 -0
  34. package/docs/07-reference/05-ai-sdk-errors/ai-no-such-model-error.mdx +3 -3
  35. package/docs/07-reference/05-ai-sdk-errors/ai-no-such-provider-error.mdx +3 -3
  36. package/docs/08-migration-guides/23-migration-guide-7-0.mdx +1 -1
  37. package/docs/08-migration-guides/29-migration-guide-4-0.mdx +1 -1
  38. package/docs/09-troubleshooting/05-tool-invocation-missing-result.mdx +2 -2
  39. package/package.json +12 -12
  40. package/src/decide/decide-events.ts +129 -0
  41. package/src/{evaluate/evaluate.ts → decide/decide.ts} +36 -38
  42. package/src/decide/decision-provider.ts +11 -0
  43. package/src/decide/decision-result.ts +39 -0
  44. package/src/decide/index.ts +64 -0
  45. package/src/{evaluate → decide}/restricted-telemetry-dispatcher.ts +7 -7
  46. package/src/{evaluate/validate-evaluation.ts → decide/validate-decision.ts} +9 -9
  47. package/src/error/index.ts +10 -1
  48. package/src/generate-speech/generated-audio-file.ts +5 -4
  49. package/src/generate-text/default-generate-text-result.ts +127 -0
  50. package/src/generate-text/generate-text.ts +2 -122
  51. package/src/global.ts +1 -1
  52. package/src/index.ts +1 -1
  53. package/src/middleware/extract-reasoning-middleware.ts +25 -6
  54. package/src/model/resolve-model.ts +45 -14
  55. package/src/registry/custom-provider.ts +38 -26
  56. package/src/registry/index.ts +13 -1
  57. package/src/registry/no-such-provider-error.ts +2 -0
  58. package/src/registry/provider-registry.ts +56 -29
  59. package/src/telemetry/create-telemetry-dispatcher.ts +17 -5
  60. package/src/telemetry/telemetry.ts +35 -19
  61. package/src/telemetry/tracing-channel.ts +1 -1
  62. package/src/test/decision-mock-model-v4.ts +35 -0
  63. package/src/transcribe/transcribe.ts +1 -1
  64. package/src/ui/chat.ts +9 -1
  65. package/src/ui/process-ui-message-stream.ts +21 -0
  66. package/docs/07-reference/01-ai-sdk-core/14-evaluate.mdx +0 -74
  67. package/docs/07-reference/05-ai-sdk-errors/ai-evaluation-unsupported-question-type-error.mdx +0 -31
  68. package/src/evaluate/evaluate-events.ts +0 -131
  69. package/src/evaluate/evaluation-provider.ts +0 -6
  70. package/src/evaluate/evaluation-result.ts +0 -39
  71. package/src/evaluate/index.ts +0 -13
  72. package/src/test/evaluation-mock-model-v4.ts +0 -27
@@ -1,5 +1,5 @@
1
1
  import {
2
- type Experimental_EvaluationModelV4 as EvaluationModelV4,
2
+ type Experimental_DecisionModelV4 as DecisionModelV4,
3
3
  type EmbeddingModelV4,
4
4
  type Experimental_VideoModelV3,
5
5
  type Experimental_VideoModelV4,
@@ -14,8 +14,12 @@ import {
14
14
  type SpeechModelV4,
15
15
  type TranscriptionModelV4,
16
16
  } from '@ai-sdk/provider';
17
- import type { EvaluationProvider } from '../evaluate/evaluation-provider';
18
- import { resolveEvaluationModel } from '../model/resolve-model';
17
+ import type { DecisionModel } from '../decide/decision-result';
18
+ import type { DecisionProvider } from '../decide/decision-provider';
19
+ import {
20
+ resolveDecisionModel,
21
+ asEvaluationModel,
22
+ } from '../model/resolve-model';
19
23
  import { wrapImageModel } from '../middleware/wrap-image-model';
20
24
  import { wrapLanguageModel } from '../middleware/wrap-language-model';
21
25
  import { asProviderV4 } from '../model/as-provider-v4';
@@ -38,7 +42,7 @@ type RegistryModelType =
38
42
  | 'speechModel'
39
43
  | 'rerankingModel'
40
44
  | 'videoModel'
41
- | 'evaluationModel';
45
+ | 'decisionModel';
42
46
 
43
47
  type ProviderVideoModelIdentifier<PROVIDER> = PROVIDER extends {
44
48
  videoModel: (...args: infer ARGS) => unknown;
@@ -46,28 +50,40 @@ type ProviderVideoModelIdentifier<PROVIDER> = PROVIDER extends {
46
50
  ? ExtractLiteralUnion<ARGS[0]>
47
51
  : never;
48
52
 
49
- type ProviderEvaluationModelIdentifier<PROVIDER> = PROVIDER extends {
50
- evaluationModel: (...args: infer ARGS) => unknown;
53
+ type ProviderDecisionModelIdentifier<PROVIDER> = PROVIDER extends {
54
+ decisionModel: (...args: infer ARGS) => unknown;
51
55
  }
52
56
  ? ExtractLiteralUnion<ARGS[0]>
53
- : never;
57
+ : PROVIDER extends { evaluationModel: (...args: infer ARGS) => unknown }
58
+ ? ExtractLiteralUnion<ARGS[0]>
59
+ : never;
54
60
 
55
- /** Registry with experimental evaluation access, separate from the stable interface. */
56
- export type EvaluationProviderRegistry<
61
+ /** Registry with experimental decision access, separate from the stable interface. */
62
+ export type DecisionProviderRegistry<
57
63
  PROVIDERS extends Record<string, ProviderV4 | ProviderV3> = Record<
58
64
  string,
59
65
  ProviderV4 | ProviderV3
60
66
  >,
61
67
  SEPARATOR extends string = ':',
62
68
  > = ProviderRegistryProvider<PROVIDERS, SEPARATOR> & {
69
+ decisionModel<KEY extends keyof PROVIDERS>(
70
+ id: KEY extends string
71
+ ? `${KEY & string}${SEPARATOR}${ProviderDecisionModelIdentifier<PROVIDERS[KEY]>}`
72
+ : never,
73
+ ): DecisionModelV4;
74
+ decisionModel<KEY extends keyof PROVIDERS>(
75
+ id: KEY extends string ? `${KEY & string}${SEPARATOR}${string}` : never,
76
+ ): DecisionModelV4;
77
+ /** @deprecated Use `decisionModel` instead. */
63
78
  evaluationModel<KEY extends keyof PROVIDERS>(
64
79
  id: KEY extends string
65
- ? `${KEY & string}${SEPARATOR}${ProviderEvaluationModelIdentifier<PROVIDERS[KEY]>}`
80
+ ? `${KEY & string}${SEPARATOR}${ProviderDecisionModelIdentifier<PROVIDERS[KEY]>}`
66
81
  : never,
67
- ): EvaluationModelV4;
82
+ ): DecisionModelV4 & { doEvaluate: DecisionModelV4['doDecide'] };
83
+ /** @deprecated Use `decisionModel` instead. */
68
84
  evaluationModel<KEY extends keyof PROVIDERS>(
69
85
  id: KEY extends string ? `${KEY & string}${SEPARATOR}${string}` : never,
70
- ): EvaluationModelV4;
86
+ ): DecisionModelV4 & { doEvaluate: DecisionModelV4['doDecide'] };
71
87
  };
72
88
 
73
89
  export interface ProviderRegistryProvider<
@@ -178,7 +194,7 @@ export function createProviderRegistry<
178
194
  | LanguageModelMiddleware[];
179
195
  imageModelMiddleware?: ImageModelMiddleware | ImageModelMiddleware[];
180
196
  } = {},
181
- ): EvaluationProviderRegistry<PROVIDERS, SEPARATOR> {
197
+ ): DecisionProviderRegistry<PROVIDERS, SEPARATOR> {
182
198
  const registry = new DefaultProviderRegistry<PROVIDERS, SEPARATOR>({
183
199
  separator,
184
200
  languageModelMiddleware,
@@ -206,12 +222,12 @@ class DefaultProviderRegistry<
206
222
  >
207
223
  implements
208
224
  ProviderRegistryProvider<PROVIDERS, SEPARATOR>,
209
- EvaluationProviderRegistry<PROVIDERS, SEPARATOR>
225
+ DecisionProviderRegistry<PROVIDERS, SEPARATOR>
210
226
  {
211
227
  private providers: Partial<
212
228
  Record<
213
229
  keyof PROVIDERS,
214
- ProviderV4 & ProviderWithOptionalVideoModel & EvaluationProvider
230
+ ProviderV4 & ProviderWithOptionalVideoModel & DecisionProvider
215
231
  >
216
232
  > = Object.create(null);
217
233
  private separator: SEPARATOR;
@@ -248,9 +264,10 @@ class DefaultProviderRegistry<
248
264
  provider as ProviderWithOptionalVideoModel
249
265
  ).videoModel?.bind(provider);
250
266
 
251
- const evaluationModel = (
252
- provider as EvaluationProvider
253
- ).evaluationModel?.bind(provider);
267
+ const decisionProvider = provider as DecisionProvider;
268
+ const decisionModel = (
269
+ decisionProvider.decisionModel ?? decisionProvider.evaluationModel
270
+ )?.bind(provider);
254
271
 
255
272
  const registeredProvider =
256
273
  videoModel == null
@@ -261,9 +278,9 @@ class DefaultProviderRegistry<
261
278
  asVideoModelV4(videoModel(modelId)),
262
279
  });
263
280
 
264
- // Keep v4 instances intact. Adapted providers need the original evaluation receiver.
265
- if (registeredProvider !== provider && evaluationModel != null) {
266
- Object.assign(registeredProvider, { evaluationModel });
281
+ // Keep v4 instances intact. Adapted providers need the original decision receiver.
282
+ if (registeredProvider !== provider && decisionModel != null) {
283
+ Object.assign(registeredProvider, { decisionModel });
267
284
  }
268
285
  this.providers[id] = registeredProvider;
269
286
  }
@@ -271,7 +288,7 @@ class DefaultProviderRegistry<
271
288
  private getProvider(
272
289
  id: string,
273
290
  modelType: RegistryModelType,
274
- ): ProviderV4 & ProviderWithOptionalVideoModel & EvaluationProvider {
291
+ ): ProviderV4 & ProviderWithOptionalVideoModel & DecisionProvider {
275
292
  const provider = this.providers[id as keyof PROVIDERS];
276
293
 
277
294
  if (provider == null) {
@@ -427,18 +444,28 @@ class DefaultProviderRegistry<
427
444
  return asVideoModelV4(model);
428
445
  }
429
446
 
430
- evaluationModel<KEY extends keyof PROVIDERS>(
447
+ decisionModel<KEY extends keyof PROVIDERS>(
431
448
  id: `${KEY & string}${SEPARATOR}${string}`,
432
- ): EvaluationModelV4 {
433
- const [providerId, modelId] = this.splitId(id, 'evaluationModel');
434
- const provider = this.getProvider(providerId, 'evaluationModel');
435
- const model = provider.evaluationModel?.(modelId);
449
+ ): DecisionModelV4 {
450
+ const [providerId, modelId] = this.splitId(id, 'decisionModel');
451
+ const provider = this.getProvider(providerId, 'decisionModel');
452
+ const factory:
453
+ | ((modelId: string) => Exclude<DecisionModel, string>)
454
+ | undefined = provider.decisionModel ?? provider.evaluationModel;
455
+ const model = factory?.call(provider, modelId);
436
456
 
437
457
  if (model == null) {
438
- throw new NoSuchModelError({ modelId: id, modelType: 'evaluationModel' });
458
+ throw new NoSuchModelError({ modelId: id, modelType: 'decisionModel' });
439
459
  }
440
460
 
441
- return resolveEvaluationModel(model);
461
+ return resolveDecisionModel(model);
462
+ }
463
+
464
+ /** @deprecated Use `decisionModel` instead. */
465
+ evaluationModel<KEY extends keyof PROVIDERS>(
466
+ id: `${KEY & string}${SEPARATOR}${string}`,
467
+ ) {
468
+ return asEvaluationModel(this.decisionModel(id));
442
469
  }
443
470
 
444
471
  files<KEY extends keyof PROVIDERS>(id: KEY & string): FilesV4 {
@@ -142,10 +142,18 @@ export function createTelemetryDispatcher({
142
142
 
143
143
  const mergeTelemetryCallback = <KEY extends TelemetryCallbackKey>(
144
144
  key: KEY,
145
+ deprecatedKey?: keyof Telemetry,
145
146
  ): Callback<TelemetryEvent<KEY>> | undefined => {
146
147
  const integrationCallbacks = (
147
148
  integrations
148
- .map(integration => integration[key]?.bind(integration))
149
+ .map(integration => {
150
+ const callback =
151
+ integration[key] ??
152
+ (deprecatedKey == null ? undefined : integration[deprecatedKey]);
153
+ return typeof callback === 'function'
154
+ ? callback.bind(integration)
155
+ : undefined;
156
+ })
149
157
  .filter(Boolean) as Array<
150
158
  Callback<InferTelemetryEvent<TelemetryEvent<KEY>>>
151
159
  >
@@ -222,16 +230,20 @@ export function createTelemetryDispatcher({
222
230
  onEmbedEnd: mergeTelemetryCallback('onEmbedEnd'),
223
231
  onRerankStart: mergeTelemetryCallback('onRerankStart'),
224
232
  onRerankEnd: mergeTelemetryCallback('onRerankEnd'),
225
- experimental_onEvaluateStart: mergeTelemetryCallback(
233
+ experimental_onDecideStart: mergeTelemetryCallback(
234
+ 'experimental_onDecideStart',
226
235
  'experimental_onEvaluateStart',
227
236
  ),
228
- experimental_onEvaluationModelCallStart: mergeTelemetryCallback(
237
+ experimental_onDecisionModelCallStart: mergeTelemetryCallback(
238
+ 'experimental_onDecisionModelCallStart',
229
239
  'experimental_onEvaluationModelCallStart',
230
240
  ),
231
- experimental_onEvaluationModelCallEnd: mergeTelemetryCallback(
241
+ experimental_onDecisionModelCallEnd: mergeTelemetryCallback(
242
+ 'experimental_onDecisionModelCallEnd',
232
243
  'experimental_onEvaluationModelCallEnd',
233
244
  ),
234
- experimental_onEvaluateEnd: mergeTelemetryCallback(
245
+ experimental_onDecideEnd: mergeTelemetryCallback(
246
+ 'experimental_onDecideEnd',
235
247
  'experimental_onEvaluateEnd',
236
248
  ),
237
249
  experimental_onStreamTranscriptionStart: mergeTelemetryCallback(
@@ -6,11 +6,11 @@ import type {
6
6
  EmbeddingModelCallStartEvent,
7
7
  } from '../embed/embed-events';
8
8
  import type {
9
- EvaluateEndEvent,
10
- EvaluateStartEvent,
11
- EvaluationModelCallEndEvent,
12
- EvaluationModelCallStartEvent,
13
- } from '../evaluate/evaluate-events';
9
+ DecideEndEvent,
10
+ DecideStartEvent,
11
+ DecisionModelCallEndEvent,
12
+ DecisionModelCallStartEvent,
13
+ } from '../decide/decide-events';
14
14
  import type {
15
15
  GenerateObjectEndEvent,
16
16
  GenerateObjectStartEvent,
@@ -116,10 +116,10 @@ export interface TelemetryDispatcher {
116
116
  onEmbedEnd?: Callback<EmbeddingModelCallEndEvent>;
117
117
  onRerankStart?: Callback<RerankingModelCallStartEvent>;
118
118
  onRerankEnd?: Callback<RerankingModelCallEndEvent>;
119
- experimental_onEvaluateStart?: Callback<EvaluateStartEvent>;
120
- experimental_onEvaluationModelCallStart?: Callback<EvaluationModelCallStartEvent>;
121
- experimental_onEvaluationModelCallEnd?: Callback<EvaluationModelCallEndEvent>;
122
- experimental_onEvaluateEnd?: Callback<EvaluateEndEvent>;
119
+ experimental_onDecideStart?: Callback<DecideStartEvent>;
120
+ experimental_onDecisionModelCallStart?: Callback<DecisionModelCallStartEvent>;
121
+ experimental_onDecisionModelCallEnd?: Callback<DecisionModelCallEndEvent>;
122
+ experimental_onDecideEnd?: Callback<DecideEndEvent>;
123
123
  experimental_onStreamTranscriptionStart?: Callback<StreamTranscriptionStartEvent>;
124
124
  experimental_onStreamTranscriptionEnd?: Callback<StreamTranscriptionEndEvent>;
125
125
  onEnd?: Callback<OperationEndEvent>;
@@ -245,29 +245,45 @@ export interface Telemetry {
245
245
  */
246
246
  onRerankEnd?: Callback<InferTelemetryEvent<RerankingModelCallEndEvent>>;
247
247
 
248
- /** Called when an experimental evaluation operation begins. */
248
+ /** @deprecated Use `experimental_onDecideStart` instead. */
249
249
  experimental_onEvaluateStart?: Callback<
250
- InferTelemetryEvent<EvaluateStartEvent>
250
+ InferTelemetryEvent<DecideStartEvent>
251
251
  >;
252
252
 
253
+ /** @deprecated Use `experimental_onDecisionModelCallStart` instead. */
254
+ experimental_onEvaluationModelCallStart?: Callback<
255
+ InferTelemetryEvent<DecisionModelCallStartEvent>
256
+ >;
257
+
258
+ /** @deprecated Use `experimental_onDecisionModelCallEnd` instead. */
259
+ experimental_onEvaluationModelCallEnd?: Callback<
260
+ InferTelemetryEvent<DecisionModelCallEndEvent>
261
+ >;
262
+
263
+ /** @deprecated Use `experimental_onDecideEnd` instead. */
264
+ experimental_onEvaluateEnd?: Callback<InferTelemetryEvent<DecideEndEvent>>;
265
+
266
+ /** Called when an experimental decision operation begins. */
267
+ experimental_onDecideStart?: Callback<InferTelemetryEvent<DecideStartEvent>>;
268
+
253
269
  /**
254
- * Called immediately before an experimental evaluation model call begins.
270
+ * Called immediately before an experimental decision model call begins.
255
271
  * The logical model call includes any provider retries.
256
272
  */
257
- experimental_onEvaluationModelCallStart?: Callback<
258
- InferTelemetryEvent<EvaluationModelCallStartEvent>
273
+ experimental_onDecisionModelCallStart?: Callback<
274
+ InferTelemetryEvent<DecisionModelCallStartEvent>
259
275
  >;
260
276
 
261
277
  /**
262
- * Called after an experimental evaluation model response has been validated.
278
+ * Called after an experimental decision model response has been validated.
263
279
  * The logical model call includes any provider retries.
264
280
  */
265
- experimental_onEvaluationModelCallEnd?: Callback<
266
- InferTelemetryEvent<EvaluationModelCallEndEvent>
281
+ experimental_onDecisionModelCallEnd?: Callback<
282
+ InferTelemetryEvent<DecisionModelCallEndEvent>
267
283
  >;
268
284
 
269
- /** Called when an experimental evaluation operation completes. */
270
- experimental_onEvaluateEnd?: Callback<InferTelemetryEvent<EvaluateEndEvent>>;
285
+ /** Called when an experimental decision operation completes. */
286
+ experimental_onDecideEnd?: Callback<InferTelemetryEvent<DecideEndEvent>>;
271
287
 
272
288
  /** Called when an experimental streaming transcription operation begins. */
273
289
  experimental_onStreamTranscriptionStart?: Callback<
@@ -12,7 +12,7 @@ export type TelemetryTracingEventType =
12
12
  | 'generateSpeech'
13
13
  | 'transcribe'
14
14
  | 'streamTranscribe'
15
- | 'experimental_evaluate';
15
+ | 'experimental_decide';
16
16
 
17
17
  export type TelemetryTracingChannelMessage<EVENT = unknown> = {
18
18
  readonly type: TelemetryTracingEventType;
@@ -0,0 +1,35 @@
1
+ import type { Experimental_DecisionModelV4 as DecisionModelV4 } from '@ai-sdk/provider';
2
+ import { notImplemented } from './not-implemented';
3
+
4
+ export class DecisionMockModelV4 implements DecisionModelV4 {
5
+ readonly specificationVersion = 'v4';
6
+ readonly provider: string;
7
+ readonly modelId: string;
8
+ readonly supportedQuestionTypes: DecisionModelV4['supportedQuestionTypes'];
9
+ doDecide: DecisionModelV4['doDecide'];
10
+
11
+ /** @deprecated Use `doDecide` instead. */
12
+ doEvaluate(options: Parameters<DecisionModelV4['doDecide']>[0]) {
13
+ return this.doDecide(options);
14
+ }
15
+
16
+ constructor({
17
+ provider = 'mock-provider',
18
+ modelId = 'mock-model-id',
19
+ supportedQuestionTypes = ['choice', 'score', 'boolean'],
20
+ doDecide,
21
+ doEvaluate,
22
+ }: {
23
+ provider?: string;
24
+ modelId?: string;
25
+ supportedQuestionTypes?: DecisionModelV4['supportedQuestionTypes'];
26
+ doDecide?: DecisionModelV4['doDecide'];
27
+ /** @deprecated Use `doDecide` instead. */
28
+ doEvaluate?: DecisionModelV4['doDecide'];
29
+ } = {}) {
30
+ this.provider = provider;
31
+ this.modelId = modelId;
32
+ this.supportedQuestionTypes = supportedQuestionTypes;
33
+ this.doDecide = doDecide ?? doEvaluate ?? notImplemented;
34
+ }
35
+ }
@@ -256,7 +256,7 @@ export async function transcribe({
256
256
  model: resolvedModel.modelId,
257
257
  });
258
258
 
259
- if (!result.text) {
259
+ if (result.text == null) {
260
260
  throw new NoTranscriptGeneratedError({
261
261
  responses: [result.response],
262
262
  });
package/src/ui/chat.ts CHANGED
@@ -849,11 +849,18 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
849
849
  responseMessageIndex === -1
850
850
  ? lastMessage
851
851
  : this.state.messages[responseMessageIndex];
852
+ // the continued stream can start with either
853
+ // 1) input deltas
854
+ // 2) or the result of an answered tool approval request
855
+ // Keep the tool part so in case 2, those chunks can find their tool call
852
856
  const resumableResponseMessage =
853
857
  trigger === 'resume-stream' &&
854
858
  responseMessage?.role === 'assistant' &&
855
859
  responseMessage.parts.some(
856
- part => isToolUIPart(part) && part.state === 'input-streaming',
860
+ part =>
861
+ isToolUIPart(part) &&
862
+ (part.state === 'input-streaming' ||
863
+ part.state === 'approval-responded'),
857
864
  )
858
865
  ? this.state.snapshot(responseMessage)
859
866
  : undefined;
@@ -952,6 +959,7 @@ export abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
952
959
  await consumeStream({
953
960
  stream: processUIMessageStream({
954
961
  stream,
962
+ resetStateOnMessageIdChange: trigger === 'resume-stream',
955
963
  onToolCall: this.onToolCall,
956
964
  onData: this.onData,
957
965
  messageMetadataSchema: this.messageMetadataSchema,
@@ -120,6 +120,7 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
120
120
  onError,
121
121
  onToolCall,
122
122
  onData,
123
+ resetStateOnMessageIdChange = false,
123
124
  }: {
124
125
  // input stream is not fully typed yet:
125
126
  stream: ReadableStream<UIMessageChunk>;
@@ -136,6 +137,8 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
136
137
  }) => Promise<void>,
137
138
  ) => Promise<void>;
138
139
  onError: ErrorHandler;
140
+ // During resume, a different message ID identifies a separate response.
141
+ resetStateOnMessageIdChange?: boolean;
139
142
  }): ReadableStream<InferUIMessageChunk<UI_MESSAGE>> {
140
143
  return stream.pipeThrough(
141
144
  new TransformStream<UIMessageChunk, InferUIMessageChunk<UI_MESSAGE>>({
@@ -953,6 +956,24 @@ export function processUIMessageStream<UI_MESSAGE extends UIMessage>({
953
956
  }
954
957
 
955
958
  case 'start': {
959
+ if (
960
+ resetStateOnMessageIdChange &&
961
+ chunk.messageId != null &&
962
+ chunk.messageId !== state.message.id
963
+ ) {
964
+ // Start the separate response with empty parts and metadata.
965
+ // Reset the active-part maps too, so earlier chunks stay with
966
+ // the previous response. Keep the state object for its callers.
967
+ Object.assign(
968
+ state,
969
+ createStreamingUIMessageState({
970
+ lastMessage: undefined,
971
+ messageId: chunk.messageId,
972
+ }),
973
+ { finishReason: undefined },
974
+ );
975
+ }
976
+
956
977
  if (chunk.messageId != null) {
957
978
  state.message.id = chunk.messageId;
958
979
  }
@@ -1,74 +0,0 @@
1
- ---
2
- title: experimental_evaluate
3
- description: Evaluate typed questions against shared state with an evaluation model.
4
- ---
5
-
6
- # `experimental_evaluate()`
7
-
8
- ```ts
9
- import { experimental_evaluate } from 'ai';
10
- ```
11
-
12
- Evaluates a nonempty map of `choice`, `score`, and `boolean` questions against one
13
- state. See [Evaluation](/docs/ai-sdk-core/evaluation) for examples and semantics.
14
-
15
- ## Parameters
16
-
17
- | Parameter | Type | Description |
18
- | ----------------- | -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
19
- | `model` | `Experimental_EvaluationModel` | Required experimental v4 model instance or a string ID resolved by Gateway or an explicitly configured evaluation-capable default provider. |
20
- | `state` | `string \| object \| array` | Required JSON-compatible shared state. |
21
- | `questions` | `Record<string, Experimental_EvaluationQuestion>` | Required nonempty question map. |
22
- | `maxRetries` | `number` | Nonnegative integer; defaults to 2. |
23
- | `abortSignal` | `AbortSignal` | Cancels evaluation. |
24
- | `headers` | `Record<string, string>` | Additional HTTP headers. |
25
- | `providerOptions` | `ProviderOptions` | Provider-specific options. |
26
- | `telemetry` | `TelemetryOptions` | Telemetry configuration, including per-call integrations, input/output recording, and a function ID. |
27
- | `runtimeContext` | `Record<string, unknown>` | Context available to lifecycle callbacks and selectively included in telemetry with `telemetry.includeRuntimeContext`. |
28
- | `onStart` | `(event: Experimental_EvaluateStartEvent) => void` | Called when the evaluation operation begins. |
29
- | `onEnd` | `(event: Experimental_EvaluateEndEvent) => void` | Called when the evaluation operation completes successfully. |
30
-
31
- See [Lifecycle Callbacks](/docs/ai-sdk-core/lifecycle-callbacks#experimental_evaluate)
32
- for the complete `onStart` and `onEnd` event fields.
33
-
34
- ## Result
35
-
36
- Returns `Promise<Experimental_EvaluationResult<QUESTIONS>>`:
37
-
38
- - `answers`: One typed answer per question ID, with literal Choice option inference.
39
- - `usage`: `inputTokens`, `outputTokens`, and `totalTokens`, each possibly undefined.
40
- - `warnings`: Provider warnings, also passed to the SDK warning logger.
41
- - `rounding`: Optional provider-declared decimal precision for probabilities and scores.
42
- - `providerMetadata`: Optional provider-specific metadata.
43
- - `response`: Timestamp, model ID, and optional response ID, headers, and body.
44
-
45
- ## Provider specification
46
-
47
- `Experimental_EvaluationModelV4` is exported from `@ai-sdk/provider` and declares
48
- `specificationVersion: 'v4'`, `provider`, `modelId`, `supportedQuestionTypes`, and
49
- `doEvaluate(options)`. Evaluation is isolated from stable `ProviderV4`.
50
-
51
- The public core types are `Experimental_EvaluationModel`,
52
- `Experimental_EvaluationQuestion`, `Experimental_EvaluationAnswer`, and
53
- `Experimental_EvaluationResult`. All evaluation-specific classes use the
54
- `Evaluation` prefix, with `Experimental_` aliases at package boundaries.
55
-
56
- ## Errors
57
-
58
- Unsupported types throw `Experimental_EvaluationUnsupportedQuestionTypeError`
59
- before provider I/O. Invalid inputs throw `InvalidArgumentError`; malformed
60
- answers throw `InvalidResponseDataError`. Invalid answers are not retried.
61
- Neither partial results nor missing probability synthesis are supported.
62
-
63
- ## Model resolution
64
-
65
- Use `registry.evaluationModel('provider:model')` or
66
- `customProvider({ evaluationModels: { alias: model } }).evaluationModel('alias')`
67
- to resolve models. Strings passed directly to `experimental_evaluate` use
68
- `globalThis.AI_SDK_DEFAULT_PROVIDER.evaluationModel(id)`, when available. Evaluation
69
- never implicitly falls back to Gateway.
70
-
71
- Resolution errors use the existing `NoSuchModelError` and `NoSuchProviderError`
72
- classes with `modelType: 'evaluationModel'`. Model instances and resolved models
73
- must implement v4; other versions throw `UnsupportedModelVersionError`.
74
- See [model resolution examples](/docs/ai-sdk-core/evaluation#model-aliases-and-registries).
@@ -1,31 +0,0 @@
1
- ---
2
- title: AI_EvaluationUnsupportedQuestionTypeError
3
- description: Identify an evaluation question type that a model does not support.
4
- ---
5
-
6
- # AI_EvaluationUnsupportedQuestionTypeError
7
-
8
- This experimental error identifies a question whose type is unsupported by an
9
- evaluation model. It is exported from `ai` and `@ai-sdk/provider` as
10
- `Experimental_EvaluationUnsupportedQuestionTypeError`.
11
-
12
- ## Properties
13
-
14
- - `questionId`: The ID of the unsupported question.
15
- - `questionType`: The requested question type.
16
- - `provider`: The provider of the evaluation model.
17
- - `modelId`: The evaluation model ID.
18
- - `message`: A description of the unsupported question and model. Providers can
19
- supply a custom message.
20
-
21
- ## Checking for this Error
22
-
23
- Use the marker-based `isInstance` check, which works across package copies:
24
-
25
- ```typescript
26
- import { Experimental_EvaluationUnsupportedQuestionTypeError as EvaluationUnsupportedQuestionTypeError } from 'ai';
27
-
28
- if (EvaluationUnsupportedQuestionTypeError.isInstance(error)) {
29
- console.log(error.questionId, error.questionType, error.modelId);
30
- }
31
- ```