ai 4.1.44 → 4.1.46

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.
package/dist/index.d.ts CHANGED
@@ -2,13 +2,61 @@ import { IDGenerator } from '@ai-sdk/provider-utils';
2
2
  export { CoreToolCall, CoreToolResult, IDGenerator, ToolCall, ToolResult, createIdGenerator, generateId } from '@ai-sdk/provider-utils';
3
3
  import { DataStreamString, Message, Schema, DeepPartial, JSONValue as JSONValue$1, AssistantMessage, DataMessage } from '@ai-sdk/ui-utils';
4
4
  export { AssistantMessage, AssistantStatus, Attachment, ChatRequest, ChatRequestOptions, CreateMessage, DataMessage, DataStreamPart, DeepPartial, IdGenerator, JSONValue, Message, RequestOptions, Schema, ToolInvocation, UIMessage, UseAssistantOptions, formatAssistantStreamPart, formatDataStreamPart, jsonSchema, parseAssistantStreamPart, parseDataStreamPart, processDataStream, processTextStream, zodSchema } from '@ai-sdk/ui-utils';
5
- import { JSONValue, EmbeddingModelV1, EmbeddingModelV1Embedding, ImageModelV1, ImageModelV1CallWarning, LanguageModelV1, LanguageModelV1FinishReason, LanguageModelV1LogProbs, LanguageModelV1CallWarning, LanguageModelV1Source, LanguageModelV1ProviderMetadata, JSONParseError, TypeValidationError, LanguageModelV1CallOptions, AISDKError, LanguageModelV1FunctionToolCall, JSONSchema7, ProviderV1, NoSuchModelError } from '@ai-sdk/provider';
5
+ import { LanguageModelV1, LanguageModelV1FinishReason, LanguageModelV1LogProbs, LanguageModelV1CallWarning, LanguageModelV1Source, JSONValue, EmbeddingModelV1, EmbeddingModelV1Embedding, ImageModelV1, ImageModelV1CallWarning, LanguageModelV1ProviderMetadata, JSONParseError, TypeValidationError, LanguageModelV1CallOptions, AISDKError, LanguageModelV1FunctionToolCall, JSONSchema7, ProviderV1, NoSuchModelError } from '@ai-sdk/provider';
6
6
  export { AISDKError, APICallError, EmptyResponseBodyError, InvalidPromptError, InvalidResponseDataError, JSONParseError, LanguageModelV1, LanguageModelV1CallOptions, LanguageModelV1Prompt, LanguageModelV1StreamPart, LoadAPIKeyError, NoContentGeneratedError, NoSuchModelError, TypeValidationError, UnsupportedFunctionalityError } from '@ai-sdk/provider';
7
7
  import { ServerResponse } from 'node:http';
8
8
  import { AttributeValue, Tracer } from '@opentelemetry/api';
9
9
  import { z } from 'zod';
10
10
  import { ServerResponse as ServerResponse$1 } from 'http';
11
11
 
12
+ /**
13
+ Language model that is used by the AI SDK Core functions.
14
+ */
15
+ type LanguageModel = LanguageModelV1;
16
+ /**
17
+ Reason why a language model finished generating a response.
18
+
19
+ Can be one of the following:
20
+ - `stop`: model generated stop sequence
21
+ - `length`: model generated maximum number of tokens
22
+ - `content-filter`: content filter violation stopped the model
23
+ - `tool-calls`: model triggered tool calls
24
+ - `error`: model stopped because of an error
25
+ - `other`: model stopped for other reasons
26
+ */
27
+ type FinishReason = LanguageModelV1FinishReason;
28
+ /**
29
+ Log probabilities for each token and its top log probabilities.
30
+
31
+ @deprecated Will become a provider extension in the future.
32
+ */
33
+ type LogProbs = LanguageModelV1LogProbs;
34
+ /**
35
+ Warning from the model provider for this call. The call will proceed, but e.g.
36
+ some settings might not be supported, which can lead to suboptimal results.
37
+ */
38
+ type CallWarning = LanguageModelV1CallWarning;
39
+ /**
40
+ A source that has been used as input to generate the response.
41
+ */
42
+ type Source = LanguageModelV1Source;
43
+ /**
44
+ Tool choice for the generation. It supports the following settings:
45
+
46
+ - `auto` (default): the model can choose whether and which tools to call.
47
+ - `required`: the model must call a tool. It can choose which tool to call.
48
+ - `none`: the model must not call tools
49
+ - `{ type: 'tool', toolName: string (typed) }`: the model must call the specified tool
50
+ */
51
+ type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
52
+ type: 'tool';
53
+ toolName: keyof TOOLS;
54
+ };
55
+ /**
56
+ * @deprecated Use `ToolChoice` instead.
57
+ */
58
+ type CoreToolChoice<TOOLS extends Record<string, unknown>> = ToolChoice<TOOLS>;
59
+
12
60
  interface DataStreamWriter {
13
61
  /**
14
62
  * Appends a data part to the stream.
@@ -22,6 +70,10 @@ interface DataStreamWriter {
22
70
  * Appends a message annotation to the stream.
23
71
  */
24
72
  writeMessageAnnotation(value: JSONValue): void;
73
+ /**
74
+ * Appends a source part to the stream.
75
+ */
76
+ writeSource(source: Source): void;
25
77
  /**
26
78
  * Merges the contents of another stream to this stream.
27
79
  */
@@ -119,54 +171,6 @@ type ImageModelResponseMetadata = {
119
171
  headers?: Record<string, string>;
120
172
  };
121
173
 
122
- /**
123
- Language model that is used by the AI SDK Core functions.
124
- */
125
- type LanguageModel = LanguageModelV1;
126
- /**
127
- Reason why a language model finished generating a response.
128
-
129
- Can be one of the following:
130
- - `stop`: model generated stop sequence
131
- - `length`: model generated maximum number of tokens
132
- - `content-filter`: content filter violation stopped the model
133
- - `tool-calls`: model triggered tool calls
134
- - `error`: model stopped because of an error
135
- - `other`: model stopped for other reasons
136
- */
137
- type FinishReason = LanguageModelV1FinishReason;
138
- /**
139
- Log probabilities for each token and its top log probabilities.
140
-
141
- @deprecated Will become a provider extension in the future.
142
- */
143
- type LogProbs = LanguageModelV1LogProbs;
144
- /**
145
- Warning from the model provider for this call. The call will proceed, but e.g.
146
- some settings might not be supported, which can lead to suboptimal results.
147
- */
148
- type CallWarning = LanguageModelV1CallWarning;
149
- /**
150
- A source that has been used as input to generate the response.
151
- */
152
- type Source = LanguageModelV1Source;
153
- /**
154
- Tool choice for the generation. It supports the following settings:
155
-
156
- - `auto` (default): the model can choose whether and which tools to call.
157
- - `required`: the model must call a tool. It can choose which tool to call.
158
- - `none`: the model must not call tools
159
- - `{ type: 'tool', toolName: string (typed) }`: the model must call the specified tool
160
- */
161
- type ToolChoice<TOOLS extends Record<string, unknown>> = 'auto' | 'none' | 'required' | {
162
- type: 'tool';
163
- toolName: keyof TOOLS;
164
- };
165
- /**
166
- * @deprecated Use `ToolChoice` instead.
167
- */
168
- type CoreToolChoice<TOOLS extends Record<string, unknown>> = ToolChoice<TOOLS>;
169
-
170
174
  type LanguageModelRequestMetadata = {
171
175
  /**
172
176
  Raw request HTTP body that was sent to the provider API as a string (JSON should be stringified).
@@ -682,6 +686,50 @@ interface FilePart {
682
686
  */
683
687
  experimental_providerMetadata?: ProviderMetadata;
684
688
  }
689
+ /**
690
+ * Reasoning content part of a prompt. It contains a reasoning.
691
+ */
692
+ interface ReasoningPart {
693
+ type: 'reasoning';
694
+ /**
695
+ The reasoning text.
696
+ */
697
+ text: string;
698
+ /**
699
+ An optional signature for verifying that the reasoning originated from the model.
700
+ */
701
+ signature?: string;
702
+ /**
703
+ Additional provider-specific metadata. They are passed through
704
+ to the provider from the AI SDK and enable provider-specific
705
+ functionality that can be fully encapsulated in the provider.
706
+ */
707
+ providerOptions?: ProviderOptions;
708
+ /**
709
+ @deprecated Use `providerOptions` instead.
710
+ */
711
+ experimental_providerMetadata?: ProviderMetadata;
712
+ }
713
+ /**
714
+ Redacted reasoning content part of a prompt.
715
+ */
716
+ interface RedactedReasoningPart {
717
+ type: 'redacted-reasoning';
718
+ /**
719
+ Redacted reasoning data.
720
+ */
721
+ data: string;
722
+ /**
723
+ Additional provider-specific metadata. They are passed through
724
+ to the provider from the AI SDK and enable provider-specific
725
+ functionality that can be fully encapsulated in the provider.
726
+ */
727
+ providerOptions?: ProviderOptions;
728
+ /**
729
+ @deprecated Use `providerOptions` instead.
730
+ */
731
+ experimental_providerMetadata?: ProviderMetadata;
732
+ }
685
733
  /**
686
734
  Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
687
735
  */
@@ -812,7 +860,7 @@ declare const coreAssistantMessageSchema: z.ZodType<CoreAssistantMessage>;
812
860
  /**
813
861
  Content of an assistant message. It can be a string or an array of text and tool call parts.
814
862
  */
815
- type AssistantContent = string | Array<TextPart | ToolCallPart>;
863
+ type AssistantContent = string | Array<TextPart | ReasoningPart | RedactedReasoningPart | ToolCallPart>;
816
864
  /**
817
865
  A tool message. It contains the result of one or more tool calls.
818
866
  */
@@ -1525,6 +1573,15 @@ declare function appendClientMessage({ messages, message, }: {
1525
1573
  message: Message;
1526
1574
  }): Message[];
1527
1575
 
1576
+ type ReasoningDetail = {
1577
+ type: 'text';
1578
+ text: string;
1579
+ signature?: string;
1580
+ } | {
1581
+ type: 'redacted';
1582
+ data: string;
1583
+ };
1584
+
1528
1585
  type Parameters = z.ZodTypeAny | Schema<any>;
1529
1586
  type inferParameters<PARAMETERS extends Parameters> = PARAMETERS extends Schema<any> ? PARAMETERS['_type'] : PARAMETERS extends z.ZodTypeAny ? z.infer<PARAMETERS> : never;
1530
1587
  interface ToolExecutionOptions {
@@ -1714,6 +1771,7 @@ type StepResult<TOOLS extends ToolSet> = {
1714
1771
  The reasoning that was generated during the generation.
1715
1772
  */
1716
1773
  readonly reasoning: string | undefined;
1774
+ readonly reasoningDetails: Array<ReasoningDetail>;
1717
1775
  /**
1718
1776
  The sources that were used to generate the text.
1719
1777
  */
@@ -1821,6 +1879,10 @@ interface GenerateTextResult<TOOLS extends ToolSet, OUTPUT> {
1821
1879
  */
1822
1880
  readonly reasoning: string | undefined;
1823
1881
  /**
1882
+ The full reasoning that the model has generated.
1883
+ */
1884
+ readonly reasoningDetails: Array<ReasoningDetail>;
1885
+ /**
1824
1886
  Sources that have been used as input to generate the response.
1825
1887
  For multi-step generation, the sources are accumulated from all steps.
1826
1888
  */
@@ -1929,9 +1991,9 @@ declare namespace output {
1929
1991
  };
1930
1992
  }
1931
1993
 
1932
- declare const symbol$d: unique symbol;
1994
+ declare const symbol$e: unique symbol;
1933
1995
  declare class InvalidToolArgumentsError extends AISDKError {
1934
- private readonly [symbol$d];
1996
+ private readonly [symbol$e];
1935
1997
  readonly toolName: string;
1936
1998
  readonly toolArgs: string;
1937
1999
  constructor({ toolArgs, toolName, cause, message, }: {
@@ -1943,9 +2005,9 @@ declare class InvalidToolArgumentsError extends AISDKError {
1943
2005
  static isInstance(error: unknown): error is InvalidToolArgumentsError;
1944
2006
  }
1945
2007
 
1946
- declare const symbol$c: unique symbol;
2008
+ declare const symbol$d: unique symbol;
1947
2009
  declare class NoSuchToolError extends AISDKError {
1948
- private readonly [symbol$c];
2010
+ private readonly [symbol$d];
1949
2011
  readonly toolName: string;
1950
2012
  readonly availableTools: string[] | undefined;
1951
2013
  constructor({ toolName, availableTools, message, }: {
@@ -2189,6 +2251,12 @@ interface StreamTextResult<TOOLS extends ToolSet, PARTIAL_OUTPUT> {
2189
2251
  */
2190
2252
  readonly reasoning: Promise<string | undefined>;
2191
2253
  /**
2254
+ The full reasoning that the model has generated.
2255
+
2256
+ Resolved when the response is finished.
2257
+ */
2258
+ readonly reasoningDetails: Promise<Array<ReasoningDetail>>;
2259
+ /**
2192
2260
  The tool calls that have been executed in the last step.
2193
2261
 
2194
2262
  Resolved when the response is finished.
@@ -2327,6 +2395,12 @@ type TextStreamPart<TOOLS extends ToolSet> = {
2327
2395
  } | {
2328
2396
  type: 'reasoning';
2329
2397
  textDelta: string;
2398
+ } | {
2399
+ type: 'reasoning-signature';
2400
+ signature: string;
2401
+ } | {
2402
+ type: 'redacted-reasoning';
2403
+ data: string;
2330
2404
  } | {
2331
2405
  type: 'source';
2332
2406
  source: Source;
@@ -2729,9 +2803,9 @@ declare function customProvider<LANGUAGE_MODELS extends Record<string, LanguageM
2729
2803
  declare const experimental_customProvider: typeof customProvider;
2730
2804
  type ExtractModelId<MODELS extends Record<string, unknown>> = Extract<keyof MODELS, string>;
2731
2805
 
2732
- declare const symbol$b: unique symbol;
2806
+ declare const symbol$c: unique symbol;
2733
2807
  declare class NoSuchProviderError extends NoSuchModelError {
2734
- private readonly [symbol$b];
2808
+ private readonly [symbol$c];
2735
2809
  readonly providerId: string;
2736
2810
  readonly availableProviders: string[];
2737
2811
  constructor({ modelId, modelType, providerId, availableProviders, message, }: {
@@ -2785,9 +2859,9 @@ declare function simulateReadableStream<T>({ chunks, initialDelayInMs, chunkDela
2785
2859
  };
2786
2860
  }): ReadableStream<T>;
2787
2861
 
2788
- declare const symbol$a: unique symbol;
2862
+ declare const symbol$b: unique symbol;
2789
2863
  declare class InvalidArgumentError extends AISDKError {
2790
- private readonly [symbol$a];
2864
+ private readonly [symbol$b];
2791
2865
  readonly parameter: string;
2792
2866
  readonly value: unknown;
2793
2867
  constructor({ parameter, value, message, }: {
@@ -2798,6 +2872,61 @@ declare class InvalidArgumentError extends AISDKError {
2798
2872
  static isInstance(error: unknown): error is InvalidArgumentError;
2799
2873
  }
2800
2874
 
2875
+ type SingleRequestTextStreamPart<TOOLS extends ToolSet> = {
2876
+ type: 'text-delta';
2877
+ textDelta: string;
2878
+ } | {
2879
+ type: 'reasoning';
2880
+ textDelta: string;
2881
+ } | {
2882
+ type: 'reasoning-signature';
2883
+ signature: string;
2884
+ } | {
2885
+ type: 'redacted-reasoning';
2886
+ data: string;
2887
+ } | {
2888
+ type: 'source';
2889
+ source: Source;
2890
+ } | ({
2891
+ type: 'tool-call';
2892
+ } & ToolCallUnion<TOOLS>) | {
2893
+ type: 'tool-call-streaming-start';
2894
+ toolCallId: string;
2895
+ toolName: string;
2896
+ } | {
2897
+ type: 'tool-call-delta';
2898
+ toolCallId: string;
2899
+ toolName: string;
2900
+ argsTextDelta: string;
2901
+ } | ({
2902
+ type: 'tool-result';
2903
+ } & ToolResultUnion<TOOLS>) | {
2904
+ type: 'response-metadata';
2905
+ id?: string;
2906
+ timestamp?: Date;
2907
+ modelId?: string;
2908
+ } | {
2909
+ type: 'finish';
2910
+ finishReason: FinishReason;
2911
+ logprobs?: LogProbs;
2912
+ usage: LanguageModelUsage;
2913
+ experimental_providerMetadata?: ProviderMetadata;
2914
+ } | {
2915
+ type: 'error';
2916
+ error: unknown;
2917
+ };
2918
+
2919
+ declare const symbol$a: unique symbol;
2920
+ declare class InvalidStreamPartError extends AISDKError {
2921
+ private readonly [symbol$a];
2922
+ readonly chunk: SingleRequestTextStreamPart<any>;
2923
+ constructor({ chunk, message, }: {
2924
+ chunk: SingleRequestTextStreamPart<any>;
2925
+ message: string;
2926
+ });
2927
+ static isInstance(error: unknown): error is InvalidStreamPartError;
2928
+ }
2929
+
2801
2930
  declare const symbol$9: unique symbol;
2802
2931
  /**
2803
2932
  Thrown when no image could be generated. This can have multiple causes:
@@ -3093,4 +3222,4 @@ declare namespace llamaindexAdapter {
3093
3222
  };
3094
3223
  }
3095
3224
 
3096
- export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, CoreToolCallUnion, CoreToolChoice, CoreToolMessage, CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamOptions, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LanguageModelV1Middleware, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RepairTextFunction, RetryError, StepResult, StreamData, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, Tool, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolCallUnion, ToolChoice, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, ToolResultUnion, ToolSet, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, customProvider, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, extractReasoningMiddleware, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool, wrapLanguageModel };
3225
+ export { AssistantContent, AssistantResponse, CallWarning, CoreAssistantMessage, CoreMessage, CoreSystemMessage, CoreTool, CoreToolCallUnion, CoreToolChoice, CoreToolMessage, CoreToolResultUnion, CoreUserMessage, DataContent, DataStreamOptions, DataStreamWriter, DownloadError, EmbedManyResult, EmbedResult, Embedding, EmbeddingModel, EmbeddingModelUsage, GenerateImageResult as Experimental_GenerateImageResult, GeneratedImage as Experimental_GeneratedImage, Experimental_LanguageModelV1Middleware, FilePart, FinishReason, GenerateObjectResult, GenerateTextOnStepFinishCallback, GenerateTextResult, ImageModel, ImageGenerationWarning as ImageModelCallWarning, ImageModelResponseMetadata, ImagePart, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidStreamPartError, InvalidToolArgumentsError, langchainAdapter as LangChainAdapter, LanguageModel, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LanguageModelV1Middleware, llamaindexAdapter as LlamaIndexAdapter, LogProbs, MessageConversionError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputSpecifiedError, NoSuchProviderError, NoSuchToolError, ObjectStreamPart, output as Output, Provider, ProviderMetadata, RepairTextFunction, RetryError, StepResult, StreamData, StreamObjectOnFinishCallback, StreamObjectResult, StreamTextOnChunkCallback, StreamTextOnErrorCallback, StreamTextOnFinishCallback, StreamTextOnStepFinishCallback, StreamTextResult, StreamTextTransform, TelemetrySettings, TextPart, TextStreamPart, Tool, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolCallUnion, ToolChoice, ToolContent, ToolExecutionError, ToolExecutionOptions, ToolResultPart, ToolResultUnion, ToolSet, UserContent, appendClientMessage, appendResponseMessages, convertToCoreMessages, coreAssistantMessageSchema, coreMessageSchema, coreSystemMessageSchema, coreToolMessageSchema, coreUserMessageSchema, cosineSimilarity, createDataStream, createDataStreamResponse, customProvider, embed, embedMany, experimental_createProviderRegistry, experimental_customProvider, generateImage as experimental_generateImage, experimental_wrapLanguageModel, extractReasoningMiddleware, generateObject, generateText, pipeDataStreamToResponse, simulateReadableStream, smoothStream, streamObject, streamText, tool, wrapLanguageModel };