ai 3.1.0-canary.2 → 3.1.0-canary.4

package/ai-model-specification/dist/index.mjs

@@ -1,30 +1,5 @@
-// ai-model-specification/errors/ai-invalid-argument-error.ts
-var AI_InvalidArgumentError = class extends Error {
-  // readonly learnMore =
-  //   'https://sdk.vercel.com/docs/ai/errors/ai_invalid_argument_error';
-  constructor({
-    parameter,
-    value,
-    message
-  }) {
-    super(`Invalid argument for parameter ${parameter}: ${message}`);
-    this.name = "AI_InvalidArgumentError";
-    this.parameter = parameter;
-    this.value = value;
-  }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      stack: this.stack,
-      parameter: this.parameter,
-      value: this.value
-    };
-  }
-};
-
 // ai-model-specification/errors/api-call-error.ts
-var ApiCallError = class extends Error {
+var APICallError = class extends Error {
   constructor({
     message,
     url,
@@ -32,11 +7,15 @@ var ApiCallError = class extends Error {
     statusCode,
     responseBody,
     cause,
-    isRetryable = statusCode != null && (statusCode === 429 || statusCode >= 500),
+    isRetryable = statusCode != null && (statusCode === 408 || // request timeout
+    statusCode === 409 || // conflict
+    statusCode === 429 || // too many requests
+    statusCode >= 500),
+    // server error
     data
   }) {
     super(message);
-    this.name = "ApiCallError";
+    this.name = "AI_APICallError";
     this.url = url;
     this.requestBodyValues = requestBodyValues;
     this.statusCode = statusCode;
@@ -45,6 +24,9 @@ var ApiCallError = class extends Error {
     this.isRetryable = isRetryable;
     this.data = data;
   }
+  static isAPICallError(error) {
+    return error instanceof Error && error.name === "AI_APICallError" && typeof error.url === "string" && typeof error.requestBodyValues === "object" && (error.statusCode == null || typeof error.statusCode === "number") && (error.responseBody == null || typeof error.responseBody === "string") && (error.cause == null || typeof error.cause === "object") && typeof error.isRetryable === "boolean" && (error.data == null || typeof error.data === "object");
+  }
   toJSON() {
     return {
       name: this.name,
@@ -60,115 +42,79 @@ var ApiCallError = class extends Error {
   }
 };
 
-// ai-model-specification/util/get-error-message.ts
-function getErrorMessage(error) {
-  if (error == null) {
-    return "unknown error";
-  }
-  if (typeof error === "string") {
-    return error;
-  }
-  if (error instanceof Error) {
-    return error.message;
+// ai-model-specification/errors/invalid-argument-error.ts
+var InvalidArgumentError = class extends Error {
+  constructor({
+    parameter,
+    value,
+    message
+  }) {
+    super(`Invalid argument for parameter ${parameter}: ${message}`);
+    this.name = "AI_InvalidArgumentError";
+    this.parameter = parameter;
+    this.value = value;
   }
-  return JSON.stringify(error);
-}
-
-// ai-model-specification/errors/json-parse-error.ts
-var JSONParseError = class extends Error {
-  constructor({ text, cause }) {
-    super(
-      `JSON parsing failed: Text: ${text}.
-Error message: ${getErrorMessage(cause)}`
-    );
-    this.name = "JSONParseError";
-    this.cause = cause;
-    this.text = text;
+  static isInvalidArgumentError(error) {
+    return error instanceof Error && error.name === "AI_InvalidArgumentError" && typeof error.parameter === "string" && typeof error.value === "string";
   }
   toJSON() {
     return {
       name: this.name,
       message: this.message,
-      cause: this.cause,
       stack: this.stack,
-      valueText: this.text
+      parameter: this.parameter,
+      value: this.value
     };
   }
 };
 
-// ai-model-specification/errors/load-api-key-error.ts
-var LoadAPIKeyError = class extends Error {
-  constructor({ message }) {
-    super(message);
-    this.name = "LoadAPIKeyError";
-  }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message
-    };
+// ai-model-specification/errors/invalid-prompt-error.ts
+var InvalidPromptError = class extends Error {
+  constructor({ prompt: prompt2, message }) {
+    super(`Invalid prompt: ${message}`);
+    this.name = "AI_InvalidPromptError";
+    this.prompt = prompt2;
   }
-};
-
-// ai-model-specification/errors/no-object-generated-error.ts
-var NoTextGeneratedError = class extends Error {
-  constructor() {
-    super(`No text generated.`);
-    this.name = "NoTextGeneratedError";
+  static isInvalidPromptError(error) {
+    return error instanceof Error && error.name === "AI_InvalidPromptError" && prompt != null;
   }
   toJSON() {
     return {
       name: this.name,
-      cause: this.cause,
       message: this.message,
-      stack: this.stack
+      stack: this.stack,
+      prompt: this.prompt
     };
   }
 };
 
-// ai-model-specification/errors/type-validation-error.ts
-var TypeValidationError = class extends Error {
-  constructor({ value, cause }) {
-    super(
-      `Type validation failed: Value: ${JSON.stringify(value)}.
-Error message: ${getErrorMessage(cause)}`
-    );
-    this.name = "TypeValidationError";
-    this.cause = cause;
-    this.value = value;
+// ai-model-specification/util/get-error-message.ts
+function getErrorMessage(error) {
+  if (error == null) {
+    return "unknown error";
   }
-  toJSON() {
-    return {
-      name: this.name,
-      message: this.message,
-      cause: this.cause,
-      stack: this.stack,
-      value: this.value
-    };
+  if (typeof error === "string") {
+    return error;
   }
-};
+  if (error instanceof Error) {
+    return error.message;
+  }
+  return JSON.stringify(error);
+}
 
-// ai-model-specification/errors/unsupported-functionality-error.ts
-var UnsupportedFunctionalityError = class extends Error {
-  constructor({
-    provider,
-    functionality
-  }) {
-    super(
-      `Functionality not supported by the provider. Provider: ${provider}.
-Functionality: ${functionality}`
-    );
-    this.name = "UnsupportedFunctionalityError";
-    this.provider = provider;
-    this.functionality = functionality;
+// ai-model-specification/errors/load-api-key-error.ts
+var LoadAPIKeyError = class extends Error {
+  constructor({ message }) {
+    super(message);
+    this.name = "AI_LoadAPIKeyError";
+  }
+  static isLoadAPIKeyError(error) {
+    return error instanceof Error && error.name === "AI_LoadAPIKeyError";
   }
   toJSON() {
     return {
       name: this.name,
-      message: this.message,
-      stack: this.stack,
-      provider: this.provider,
-      functionality: this.functionality
+      message: this.message
     };
   }
 };
@@ -200,6 +146,56 @@ function loadApiKey({
 // ai-model-specification/util/parse-json.ts
 import SecureJSON from "secure-json-parse";
 
+// ai-model-specification/errors/json-parse-error.ts
+var JSONParseError = class extends Error {
+  constructor({ text, cause }) {
+    super(
+      `JSON parsing failed: Text: ${text}.
+Error message: ${getErrorMessage(cause)}`
+    );
+    this.name = "AI_JSONParseError";
+    this.cause = cause;
+    this.text = text;
+  }
+  static isJSONParseError(error) {
+    return error instanceof Error && error.name === "AI_JSONParseError" && typeof error.text === "string" && typeof error.cause === "string";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      cause: this.cause,
+      stack: this.stack,
+      valueText: this.text
+    };
+  }
+};
+
+// ai-model-specification/errors/type-validation-error.ts
+var TypeValidationError = class extends Error {
+  constructor({ value, cause }) {
+    super(
+      `Type validation failed: Value: ${JSON.stringify(value)}.
+Error message: ${getErrorMessage(cause)}`
+    );
+    this.name = "AI_TypeValidationError";
+    this.cause = cause;
+    this.value = value;
+  }
+  static isTypeValidationError(error) {
+    return error instanceof Error && error.name === "AI_TypeValidationError" && typeof error.value === "string" && typeof error.cause === "string";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      cause: this.cause,
+      stack: this.stack,
+      value: this.value
+    };
+  }
+};
+
 // ai-model-specification/util/validate-types.ts
 function validateTypes({
   value,
@@ -233,7 +229,7 @@ function safeValidateTypes({
   } catch (error) {
     return {
       success: false,
-      error: error instanceof TypeValidationError ? error : new TypeValidationError({ value, cause: error })
+      error: TypeValidationError.isTypeValidationError(error) ? error : new TypeValidationError({ value, cause: error })
     };
   }
 }
@@ -250,7 +246,7 @@ function parseJSON({
     }
     return validateTypes({ value, schema });
   } catch (error) {
-    if (error instanceof JSONParseError || error instanceof TypeValidationError) {
+    if (JSONParseError.isJSONParseError(error) || TypeValidationError.isTypeValidationError(error)) {
       throw error;
     }
     throw new JSONParseError({ text, cause: error });
@@ -272,7 +268,7 @@ function safeParseJSON({
   } catch (error) {
     return {
       success: false,
-      error: error instanceof JSONParseError ? error : new JSONParseError({ text, cause: error })
+      error: JSONParseError.isJSONParseError(error) ? error : new JSONParseError({ text, cause: error })
     };
   }
 }
@@ -296,8 +292,8 @@ var postJsonToApi = async ({
 }) => postToApi({
   url,
   headers: {
-    "Content-Type": "application/json",
-    ...headers
+    ...headers,
+    "Content-Type": "application/json"
   },
   body: {
     content: JSON.stringify(body),
@@ -316,9 +312,12 @@ var postToApi = async ({
   abortSignal
 }) => {
   try {
+    const definedHeaders = Object.fromEntries(
+      Object.entries(headers).filter(([_key, value]) => value != null)
+    );
     const response = await fetch(url, {
       method: "POST",
-      headers,
+      headers: definedHeaders,
       body: body.content,
       signal: abortSignal
     });
@@ -331,11 +330,11 @@ var postToApi = async ({
         });
       } catch (error) {
         if (error instanceof Error) {
-          if (error.name === "AbortError" || error instanceof ApiCallError) {
+          if (error.name === "AbortError" || APICallError.isAPICallError(error)) {
             throw error;
           }
         }
-        throw new ApiCallError({
+        throw new APICallError({
           message: "Failed to process error response",
           cause: error,
           statusCode: response.status,
@@ -352,11 +351,11 @@ var postToApi = async ({
       });
     } catch (error) {
       if (error instanceof Error) {
-        if (error.name === "AbortError" || error instanceof ApiCallError) {
+        if (error.name === "AbortError" || APICallError.isAPICallError(error)) {
           throw error;
         }
       }
-      throw new ApiCallError({
+      throw new APICallError({
         message: "Failed to process successful response",
         cause: error,
         statusCode: response.status,
@@ -373,12 +372,13 @@ var postToApi = async ({
     if (error instanceof TypeError && error.message === "fetch failed") {
       const cause = error.cause;
       if (cause != null) {
-        throw new ApiCallError({
+        throw new APICallError({
           message: `Cannot connect to API: ${cause.message}`,
           cause,
           url,
           requestBodyValues: body.values,
           isRetryable: true
+          // retry when network error
         });
       }
     }
@@ -397,7 +397,7 @@ var createJsonErrorResponseHandler = ({
 }) => async ({ response, url, requestBodyValues }) => {
   const responseBody = await response.text();
   if (responseBody.trim() === "") {
-    return new ApiCallError({
+    return new APICallError({
       message: response.statusText,
       url,
       requestBodyValues,
@@ -411,7 +411,7 @@ var createJsonErrorResponseHandler = ({
       text: responseBody,
       schema: errorSchema
     });
-    return new ApiCallError({
+    return new APICallError({
       message: errorToMessage(parsedError),
       url,
       requestBodyValues,
@@ -421,7 +421,7 @@ var createJsonErrorResponseHandler = ({
       isRetryable: isRetryable == null ? void 0 : isRetryable(response, parsedError)
     });
   } catch (parseError) {
-    return new ApiCallError({
+    return new APICallError({
       message: response.statusText,
       url,
       requestBodyValues,
@@ -459,7 +459,7 @@ var createJsonResponseHandler = (responseSchema) => async ({ response, url, requ
     schema: responseSchema
   });
   if (!parsedResult.success) {
-    throw new ApiCallError({
+    throw new APICallError({
       message: "Invalid JSON response",
       cause: parsedResult.error,
       statusCode: response.status,
@@ -500,12 +500,141 @@ function convertUint8ArrayToBase64(array) {
   }
   return globalThis.btoa(latin1string);
 }
+
+// ai-model-specification/errors/invalid-tool-arguments-error.ts
+var InvalidToolArgumentsError = class extends Error {
+  constructor({
+    toolArgs,
+    toolName,
+    cause,
+    message = `Invalid arguments for tool ${toolName}: ${getErrorMessage(
+      cause
+    )}`
+  }) {
+    super(message);
+    this.name = "AI_InvalidToolArgumentsError";
+    this.toolArgs = toolArgs;
+    this.toolName = toolName;
+    this.cause = cause;
+  }
+  static isInvalidToolArgumentsError(error) {
+    return error instanceof Error && error.name === "AI_InvalidToolArgumentsError" && typeof error.toolName === "string" && typeof error.toolArgs === "string";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      cause: this.cause,
+      stack: this.stack,
+      toolName: this.toolName,
+      toolArgs: this.toolArgs
+    };
+  }
+};
+
+// ai-model-specification/errors/no-object-generated-error.ts
+var NoTextGeneratedError = class extends Error {
+  constructor() {
+    super(`No text generated.`);
+    this.name = "AI_NoTextGeneratedError";
+  }
+  static isNoTextGeneratedError(error) {
+    return error instanceof Error && error.name === "AI_NoTextGeneratedError";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      cause: this.cause,
+      message: this.message,
+      stack: this.stack
+    };
+  }
+};
+
+// ai-model-specification/errors/no-such-tool-error.ts
+var NoSuchToolError = class extends Error {
+  constructor({ message, toolName }) {
+    super(message);
+    this.name = "AI_NoSuchToolError";
+    this.toolName = toolName;
+  }
+  static isNoSuchToolError(error) {
+    return error instanceof Error && error.name === "AI_NoSuchToolError" && typeof error.toolName === "string";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      toolName: this.toolName
+    };
+  }
+};
+
+// ai-model-specification/errors/retry-error.ts
+var RetryError = class extends Error {
+  constructor({
+    message,
+    reason,
+    errors
+  }) {
+    super(message);
+    this.name = "AI_RetryError";
+    this.reason = reason;
+    this.errors = errors;
+    this.lastError = errors[errors.length - 1];
+  }
+  static isRetryError(error) {
+    return error instanceof Error && error.name === "AI_RetryError" && typeof error.reason === "string" && Array.isArray(error.errors);
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      reason: this.reason,
+      lastError: this.lastError,
+      errors: this.errors
+    };
+  }
+};
+
+// ai-model-specification/errors/unsupported-functionality-error.ts
+var UnsupportedFunctionalityError = class extends Error {
+  constructor({
+    provider,
+    functionality
+  }) {
+    super(
+      `Functionality not supported by the provider. Provider: ${provider}.
+Functionality: ${functionality}`
+    );
+    this.name = "AI_UnsupportedFunctionalityError";
+    this.provider = provider;
+    this.functionality = functionality;
+  }
+  static isUnsupportedFunctionalityError(error) {
+    return error instanceof Error && error.name === "AI_UnsupportedFunctionalityError" && typeof error.provider === "string" && typeof error.functionality === "string";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      provider: this.provider,
+      functionality: this.functionality
+    };
+  }
+};
 export {
-  AI_InvalidArgumentError,
-  ApiCallError,
+  APICallError,
+  InvalidArgumentError,
+  InvalidPromptError,
+  InvalidToolArgumentsError,
   JSONParseError,
   LoadAPIKeyError,
+  NoSuchToolError,
   NoTextGeneratedError,
+  RetryError,
   TypeValidationError,
   UnsupportedFunctionalityError,
   convertBase64ToUint8Array,
@@ -513,6 +642,7 @@ export {
   createEventSourceResponseHandler,
   createJsonErrorResponseHandler,
   createJsonResponseHandler,
+  getErrorMessage,
   isParseableJson,
   loadApiKey,
   parseJSON,