ai 6.0.33 → 6.0.35

package/src/error/no-image-generated-error.ts

@@ -0,0 +1,39 @@
+import { AISDKError } from '@ai-sdk/provider';
+import { ImageModelResponseMetadata } from '../types/image-model-response-metadata';
+
+const name = 'AI_NoImageGeneratedError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+Thrown when no image could be generated. This can have multiple causes:
+
+- The model failed to generate a response.
+- The model generated a response that could not be parsed.
+ */
+export class NoImageGeneratedError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  /**
+The response metadata for each call.
+   */
+  readonly responses: Array<ImageModelResponseMetadata> | undefined;
+
+  constructor({
+    message = 'No image generated.',
+    cause,
+    responses,
+  }: {
+    message?: string;
+    cause?: Error;
+    responses?: Array<ImageModelResponseMetadata>;
+  }) {
+    super({ name, message, cause });
+
+    this.responses = responses;
+  }
+
+  static isInstance(error: unknown): error is NoImageGeneratedError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/no-object-generated-error.ts

@@ -0,0 +1,70 @@
+import { AISDKError } from '@ai-sdk/provider';
+import { FinishReason } from '../types/language-model';
+import { LanguageModelResponseMetadata } from '../types/language-model-response-metadata';
+import { LanguageModelUsage } from '../types/usage';
+
+const name = 'AI_NoObjectGeneratedError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+Thrown when no object could be generated. This can have several causes:
+
+- The model failed to generate a response.
+- The model generated a response that could not be parsed.
+- The model generated a response that could not be validated against the schema.
+
+The error contains the following properties:
+
+- `text`: The text that was generated by the model. This can be the raw text or the tool call text, depending on the model.
+ */
+export class NoObjectGeneratedError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  /**
+  The text that was generated by the model. This can be the raw text or the tool call text, depending on the model.
+   */
+  readonly text: string | undefined;
+
+  /**
+  The response metadata.
+   */
+  readonly response: LanguageModelResponseMetadata | undefined;
+
+  /**
+  The usage of the model.
+   */
+  readonly usage: LanguageModelUsage | undefined;
+
+  /**
+  Reason why the model finished generating a response.
+   */
+  readonly finishReason: FinishReason | undefined;
+
+  constructor({
+    message = 'No object generated.',
+    cause,
+    text,
+    response,
+    usage,
+    finishReason,
+  }: {
+    message?: string;
+    cause?: Error;
+    text?: string;
+    response: LanguageModelResponseMetadata;
+    usage: LanguageModelUsage;
+    finishReason: FinishReason;
+  }) {
+    super({ name, message, cause });
+
+    this.text = text;
+    this.response = response;
+    this.usage = usage;
+    this.finishReason = finishReason;
+  }
+
+  static isInstance(error: unknown): error is NoObjectGeneratedError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/no-output-generated-error.ts

@@ -0,0 +1,26 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+const name = 'AI_NoOutputGeneratedError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+Thrown when no LLM output was generated, e.g. because of errors.
+ */
+export class NoOutputGeneratedError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  constructor({
+    message = 'No output generated.',
+    cause,
+  }: {
+    message?: string;
+    cause?: Error;
+  } = {}) {
+    super({ name, message, cause });
+  }
+
+  static isInstance(error: unknown): error is NoOutputGeneratedError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/no-speech-generated-error.ts

@@ -0,0 +1,18 @@
+import { AISDKError } from '@ai-sdk/provider';
+import { SpeechModelResponseMetadata } from '../types/speech-model-response-metadata';
+
+/**
+Error that is thrown when no speech audio was generated.
+ */
+export class NoSpeechGeneratedError extends AISDKError {
+  readonly responses: Array<SpeechModelResponseMetadata>;
+
+  constructor(options: { responses: Array<SpeechModelResponseMetadata> }) {
+    super({
+      name: 'AI_NoSpeechGeneratedError',
+      message: 'No speech audio generated.',
+    });
+
+    this.responses = options.responses;
+  }
+}

package/src/error/no-such-tool-error.ts

@@ -0,0 +1,35 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+const name = 'AI_NoSuchToolError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+export class NoSuchToolError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  readonly toolName: string;
+  readonly availableTools: string[] | undefined;
+
+  constructor({
+    toolName,
+    availableTools = undefined,
+    message = `Model tried to call unavailable tool '${toolName}'. ${
+      availableTools === undefined
+        ? 'No tools are available.'
+        : `Available tools: ${availableTools.join(', ')}.`
+    }`,
+  }: {
+    toolName: string;
+    availableTools?: string[] | undefined;
+    message?: string;
+  }) {
+    super({ name, message });
+
+    this.toolName = toolName;
+    this.availableTools = availableTools;
+  }
+
+  static isInstance(error: unknown): error is NoSuchToolError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/no-transcript-generated-error.ts

@@ -0,0 +1,20 @@
+import { AISDKError } from '@ai-sdk/provider';
+import { TranscriptionModelResponseMetadata } from '../types/transcription-model-response-metadata';
+
+/**
+Error that is thrown when no transcript was generated.
+ */
+export class NoTranscriptGeneratedError extends AISDKError {
+  readonly responses: Array<TranscriptionModelResponseMetadata>;
+
+  constructor(options: {
+    responses: Array<TranscriptionModelResponseMetadata>;
+  }) {
+    super({
+      name: 'AI_NoTranscriptGeneratedError',
+      message: 'No transcript generated.',
+    });
+
+    this.responses = options.responses;
+  }
+}

package/src/error/tool-call-not-found-for-approval-error.ts

@@ -0,0 +1,32 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+const name = 'AI_ToolCallNotFoundForApprovalError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+export class ToolCallNotFoundForApprovalError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  readonly toolCallId: string;
+  readonly approvalId: string;
+
+  constructor({
+    toolCallId,
+    approvalId,
+  }: {
+    toolCallId: string;
+    approvalId: string;
+  }) {
+    super({
+      name,
+      message: `Tool call "${toolCallId}" not found for approval request "${approvalId}".`,
+    });
+
+    this.toolCallId = toolCallId;
+    this.approvalId = approvalId;
+  }
+
+  static isInstance(error: unknown): error is ToolCallNotFoundForApprovalError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/tool-call-repair-error.ts

@@ -0,0 +1,30 @@
+import { AISDKError, getErrorMessage } from '@ai-sdk/provider';
+import { InvalidToolInputError } from './invalid-tool-input-error';
+import { NoSuchToolError } from './no-such-tool-error';
+
+const name = 'AI_ToolCallRepairError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+export class ToolCallRepairError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  readonly originalError: NoSuchToolError | InvalidToolInputError;
+
+  constructor({
+    cause,
+    originalError,
+    message = `Error repairing tool call: ${getErrorMessage(cause)}`,
+  }: {
+    message?: string;
+    cause: unknown;
+    originalError: NoSuchToolError | InvalidToolInputError;
+  }) {
+    super({ name, message, cause });
+    this.originalError = originalError;
+  }
+
+  static isInstance(error: unknown): error is ToolCallRepairError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/ui-message-stream-error.ts

@@ -0,0 +1,48 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+const name = 'AI_UIMessageStreamError';
+const marker = `vercel.ai.error.${name}`;
+const symbol = Symbol.for(marker);
+
+/**
+ * Error thrown when a UI message stream contains invalid or out-of-sequence chunks.
+ *
+ * This typically occurs when:
+ * - A delta chunk is received without a corresponding start chunk
+ * - An end chunk is received without a corresponding start chunk
+ * - A tool invocation is not found for the given toolCallId
+ *
+ * @see https://ai-sdk.dev/docs/reference/ai-sdk-errors/ai-ui-message-stream-error
+ */
+export class UIMessageStreamError extends AISDKError {
+  private readonly [symbol] = true; // used in isInstance
+
+  /**
+   * The type of chunk that caused the error (e.g., 'text-delta', 'reasoning-end').
+   */
+  readonly chunkType: string;
+
+  /**
+   * The ID associated with the failing chunk (part ID or toolCallId).
+   */
+  readonly chunkId: string;
+
+  constructor({
+    chunkType,
+    chunkId,
+    message,
+  }: {
+    chunkType: string;
+    chunkId: string;
+    message: string;
+  }) {
+    super({ name, message });
+
+    this.chunkType = chunkType;
+    this.chunkId = chunkId;
+  }
+
+  static isInstance(error: unknown): error is UIMessageStreamError {
+    return AISDKError.hasMarker(error, marker);
+  }
+}

package/src/error/unsupported-model-version-error.ts

@@ -0,0 +1,23 @@
+import { AISDKError } from '@ai-sdk/provider';
+
+/**
+Error that is thrown when a model with an unsupported version is used.
+ */
+export class UnsupportedModelVersionError extends AISDKError {
+  readonly version: string;
+  readonly provider: string;
+  readonly modelId: string;
+
+  constructor(options: { version: string; provider: string; modelId: string }) {
+    super({
+      name: 'AI_UnsupportedModelVersionError',
+      message:
+        `Unsupported model version ${options.version} for provider "${options.provider}" and model "${options.modelId}". ` +
+        `AI SDK 5 only supports models that implement specification version "v2".`,
+    });
+
+    this.version = options.version;
+    this.provider = options.provider;
+    this.modelId = options.modelId;
+  }
+}

package/src/error/verify-no-object-generated-error.ts

@@ -0,0 +1,27 @@
+import { expect } from 'vitest';
+
+import {
+  FinishReason,
+  LanguageModelResponseMetadata,
+  LanguageModelUsage,
+} from '../types';
+import { NoObjectGeneratedError } from './no-object-generated-error';
+
+export function verifyNoObjectGeneratedError(
+  error: unknown,
+  expected: {
+    message: string;
+    response: LanguageModelResponseMetadata & {
+      body?: string;
+    };
+    usage: LanguageModelUsage;
+    finishReason: FinishReason;
+  },
+) {
+  expect(NoObjectGeneratedError.isInstance(error)).toBeTruthy();
+  const noObjectGeneratedError = error as NoObjectGeneratedError;
+  expect(noObjectGeneratedError.message).toEqual(expected.message);
+  expect(noObjectGeneratedError.response).toEqual(expected.response);
+  expect(noObjectGeneratedError.usage).toEqual(expected.usage);
+  expect(noObjectGeneratedError.finishReason).toEqual(expected.finishReason);
+}

package/src/generate-image/generate-image-result.ts

@@ -0,0 +1,42 @@
+import { GeneratedFile } from '../generate-text';
+import { ImageModelProviderMetadata } from '../types/image-model';
+import { ImageModelResponseMetadata } from '../types/image-model-response-metadata';
+import { ImageModelUsage } from '../types/usage';
+import { Warning } from '../types/warning';
+
+/**
+The result of a `generateImage` call.
+It contains the images and additional information.
+ */
+export interface GenerateImageResult {
+  /**
+The first image that was generated.
+   */
+  readonly image: GeneratedFile;
+
+  /**
+The images that were generated.
+     */
+  readonly images: Array<GeneratedFile>;
+
+  /**
+Warnings for the call, e.g. unsupported settings.
+     */
+  readonly warnings: Array<Warning>;
+
+  /**
+Response metadata from the provider. There may be multiple responses if we made multiple calls to the model.
+   */
+  readonly responses: Array<ImageModelResponseMetadata>;
+
+  /**
+   * Provider-specific metadata. They are passed through from the provider to the AI SDK and enable provider-specific
+   * results that can be fully encapsulated in the provider.
+   */
+  readonly providerMetadata: ImageModelProviderMetadata;
+
+  /**
+  Combined token usage across all underlying provider calls for this image generation.
+   */
+  readonly usage: ImageModelUsage;
+}