ai 3.0.12 → 3.0.14

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

@@ -0,0 +1,742 @@
+// ai-model-specification/errors/api-call-error.ts
+var APICallError = class extends Error {
+  constructor({
+    message,
+    url,
+    requestBodyValues,
+    statusCode,
+    responseBody,
+    cause,
+    isRetryable = statusCode != null && (statusCode === 408 || // request timeout
+    statusCode === 409 || // conflict
+    statusCode === 429 || // too many requests
+    statusCode >= 500),
+    // server error
+    data
+  }) {
+    super(message);
+    this.name = "AI_APICallError";
+    this.url = url;
+    this.requestBodyValues = requestBodyValues;
+    this.statusCode = statusCode;
+    this.responseBody = responseBody;
+    this.cause = cause;
+    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,
+      message: this.message,
+      url: this.url,
+      requestBodyValues: this.requestBodyValues,
+      statusCode: this.statusCode,
+      responseBody: this.responseBody,
+      cause: this.cause,
+      isRetryable: this.isRetryable,
+      data: this.data
+    };
+  }
+};
+
+// 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;
+  }
+  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,
+      stack: this.stack,
+      parameter: this.parameter,
+      value: this.value
+    };
+  }
+};
+
+// ai-model-specification/errors/invalid-data-content-error.ts
+var InvalidDataContentError = class extends Error {
+  constructor({
+    content,
+    message = `Invalid data content. Expected a string, Uint8Array, ArrayBuffer, or Buffer, but got ${typeof content}.`
+  }) {
+    super(message);
+    this.name = "AI_InvalidDataContentError";
+    this.content = content;
+  }
+  static isInvalidDataContentError(error) {
+    return error instanceof Error && error.name === "AI_InvalidDataContentError" && error.content != null;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      content: this.content
+    };
+  }
+};
+
+// 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;
+  }
+  static isInvalidPromptError(error) {
+    return error instanceof Error && error.name === "AI_InvalidPromptError" && prompt != null;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      prompt: this.prompt
+    };
+  }
+};
+
+// ai-model-specification/errors/invalid-response-data-error.ts
+var InvalidResponseDataError = class extends Error {
+  constructor({
+    data,
+    message = `Invalid response data: ${JSON.stringify(data)}.`
+  }) {
+    super(message);
+    this.name = "AI_InvalidResponseDataError";
+    this.data = data;
+  }
+  static isInvalidResponseDataError(error) {
+    return error instanceof Error && error.name === "AI_InvalidResponseDataError" && error.data != null;
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack,
+      data: this.data
+    };
+  }
+};
+
+// ai-model-specification/util/generate-id.ts
+import { customAlphabet } from "nanoid/non-secure";
+var generateId = customAlphabet(
+  "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz",
+  7
+);
+
+// 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;
+  }
+  return JSON.stringify(error);
+}
+
+// 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
+    };
+  }
+};
+
+// ai-model-specification/util/load-api-key.ts
+function loadApiKey({
+  apiKey,
+  environmentVariableName,
+  apiKeyParameterName = "apiKey",
+  description
+}) {
+  if (typeof apiKey === "string") {
+    return apiKey;
+  }
+  if (apiKey != null) {
+    throw new LoadAPIKeyError({
+      message: `${description} API key must be a string.`
+    });
+  }
+  if (typeof process === "undefined") {
+    throw new LoadAPIKeyError({
+      message: `${description} API key is missing. Pass it using the '${apiKeyParameterName}' parameter. Environment variables is not supported in this environment.`
+    });
+  }
+  apiKey = process.env[environmentVariableName];
+  if (apiKey == null) {
+    throw new LoadAPIKeyError({
+      message: `${description} API key is missing. Pass it using the '${apiKeyParameterName}' parameter or the ${environmentVariableName} environment variable.`
+    });
+  }
+  if (typeof apiKey !== "string") {
+    throw new LoadAPIKeyError({
+      message: `${description} API key must be a string. The value of the ${environmentVariableName} environment variable is not a string.`
+    });
+  }
+  return apiKey;
+}
+
+// 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,
+  schema
+}) {
+  try {
+    return schema.parse(value);
+  } catch (error) {
+    throw new TypeValidationError({ value, cause: error });
+  }
+}
+function safeValidateTypes({
+  value,
+  schema
+}) {
+  try {
+    const validationResult = schema.safeParse(value);
+    if (validationResult.success) {
+      return {
+        success: true,
+        value: validationResult.data
+      };
+    }
+    return {
+      success: false,
+      error: new TypeValidationError({
+        value,
+        cause: validationResult.error
+      })
+    };
+  } catch (error) {
+    return {
+      success: false,
+      error: TypeValidationError.isTypeValidationError(error) ? error : new TypeValidationError({ value, cause: error })
+    };
+  }
+}
+
+// ai-model-specification/util/parse-json.ts
+function parseJSON({
+  text,
+  schema
+}) {
+  try {
+    const value = SecureJSON.parse(text);
+    if (schema == null) {
+      return value;
+    }
+    return validateTypes({ value, schema });
+  } catch (error) {
+    if (JSONParseError.isJSONParseError(error) || TypeValidationError.isTypeValidationError(error)) {
+      throw error;
+    }
+    throw new JSONParseError({ text, cause: error });
+  }
+}
+function safeParseJSON({
+  text,
+  schema
+}) {
+  try {
+    const value = SecureJSON.parse(text);
+    if (schema == null) {
+      return {
+        success: true,
+        value
+      };
+    }
+    return safeValidateTypes({ value, schema });
+  } catch (error) {
+    return {
+      success: false,
+      error: JSONParseError.isJSONParseError(error) ? error : new JSONParseError({ text, cause: error })
+    };
+  }
+}
+function isParseableJson(input) {
+  try {
+    SecureJSON.parse(input);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+
+// ai-model-specification/util/post-to-api.ts
+var postJsonToApi = async ({
+  url,
+  headers,
+  body,
+  failedResponseHandler,
+  successfulResponseHandler,
+  abortSignal
+}) => postToApi({
+  url,
+  headers: {
+    ...headers,
+    "Content-Type": "application/json"
+  },
+  body: {
+    content: JSON.stringify(body),
+    values: body
+  },
+  failedResponseHandler,
+  successfulResponseHandler,
+  abortSignal
+});
+var postToApi = async ({
+  url,
+  headers = {},
+  body,
+  successfulResponseHandler,
+  failedResponseHandler,
+  abortSignal
+}) => {
+  try {
+    const definedHeaders = Object.fromEntries(
+      Object.entries(headers).filter(([_key, value]) => value != null)
+    );
+    const response = await fetch(url, {
+      method: "POST",
+      headers: definedHeaders,
+      body: body.content,
+      signal: abortSignal
+    });
+    if (!response.ok) {
+      try {
+        throw await failedResponseHandler({
+          response,
+          url,
+          requestBodyValues: body.values
+        });
+      } catch (error) {
+        if (error instanceof Error) {
+          if (error.name === "AbortError" || APICallError.isAPICallError(error)) {
+            throw error;
+          }
+        }
+        throw new APICallError({
+          message: "Failed to process error response",
+          cause: error,
+          statusCode: response.status,
+          url,
+          requestBodyValues: body.values
+        });
+      }
+    }
+    try {
+      return await successfulResponseHandler({
+        response,
+        url,
+        requestBodyValues: body.values
+      });
+    } catch (error) {
+      if (error instanceof Error) {
+        if (error.name === "AbortError" || APICallError.isAPICallError(error)) {
+          throw error;
+        }
+      }
+      throw new APICallError({
+        message: "Failed to process successful response",
+        cause: error,
+        statusCode: response.status,
+        url,
+        requestBodyValues: body.values
+      });
+    }
+  } catch (error) {
+    if (error instanceof Error) {
+      if (error.name === "AbortError") {
+        throw error;
+      }
+    }
+    if (error instanceof TypeError && error.message === "fetch failed") {
+      const cause = error.cause;
+      if (cause != null) {
+        throw new APICallError({
+          message: `Cannot connect to API: ${cause.message}`,
+          cause,
+          url,
+          requestBodyValues: body.values,
+          isRetryable: true
+          // retry when network error
+        });
+      }
+    }
+    throw error;
+  }
+};
+
+// ai-model-specification/util/response-handler.ts
+import {
+  EventSourceParserStream
+} from "eventsource-parser/stream";
+
+// ai-model-specification/errors/no-response-body-error.ts
+var NoResponseBodyError = class extends Error {
+  constructor({ message = "No response body" } = {}) {
+    super(message);
+    this.name = "AI_NoResponseBodyError";
+  }
+  static isNoResponseBodyError(error) {
+    return error instanceof Error && error.name === "AI_NoResponseBodyError";
+  }
+  toJSON() {
+    return {
+      name: this.name,
+      message: this.message,
+      stack: this.stack
+    };
+  }
+};
+
+// ai-model-specification/util/response-handler.ts
+var createJsonErrorResponseHandler = ({
+  errorSchema,
+  errorToMessage,
+  isRetryable
+}) => async ({ response, url, requestBodyValues }) => {
+  const responseBody = await response.text();
+  if (responseBody.trim() === "") {
+    return new APICallError({
+      message: response.statusText,
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseBody,
+      isRetryable: isRetryable == null ? void 0 : isRetryable(response)
+    });
+  }
+  try {
+    const parsedError = parseJSON({
+      text: responseBody,
+      schema: errorSchema
+    });
+    return new APICallError({
+      message: errorToMessage(parsedError),
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseBody,
+      data: parsedError,
+      isRetryable: isRetryable == null ? void 0 : isRetryable(response, parsedError)
+    });
+  } catch (parseError) {
+    return new APICallError({
+      message: response.statusText,
+      url,
+      requestBodyValues,
+      statusCode: response.status,
+      responseBody,
+      isRetryable: isRetryable == null ? void 0 : isRetryable(response)
+    });
+  }
+};
+var createEventSourceResponseHandler = (chunkSchema) => async ({ response }) => {
+  if (response.body == null) {
+    throw new NoResponseBodyError();
+  }
+  return response.body.pipeThrough(new TextDecoderStream()).pipeThrough(new EventSourceParserStream()).pipeThrough(
+    new TransformStream({
+      transform({ data }, controller) {
+        if (data === "[DONE]") {
+          return;
+        }
+        controller.enqueue(
+          safeParseJSON({
+            text: data,
+            schema: chunkSchema
+          })
+        );
+      }
+    })
+  );
+};
+var createJsonResponseHandler = (responseSchema) => async ({ response, url, requestBodyValues }) => {
+  const responseBody = await response.text();
+  const parsedResult = safeParseJSON({
+    text: responseBody,
+    schema: responseSchema
+  });
+  if (!parsedResult.success) {
+    throw new APICallError({
+      message: "Invalid JSON response",
+      cause: parsedResult.error,
+      statusCode: response.status,
+      responseBody,
+      url,
+      requestBodyValues
+    });
+  }
+  return parsedResult.value;
+};
+
+// ai-model-specification/util/scale.ts
+function scale({
+  inputMin = 0,
+  inputMax = 1,
+  outputMin,
+  outputMax,
+  value
+}) {
+  if (value === void 0) {
+    return void 0;
+  }
+  const inputRange = inputMax - inputMin;
+  const outputRange = outputMax - outputMin;
+  return (value - inputMin) * outputRange / inputRange + outputMin;
+}
+
+// ai-model-specification/util/uint8-utils.ts
+function convertBase64ToUint8Array(base64String) {
+  const base64Url = base64String.replace(/-/g, "+").replace(/_/g, "/");
+  const latin1string = globalThis.atob(base64Url);
+  return Uint8Array.from(latin1string, (byte) => byte.codePointAt(0));
+}
+function convertUint8ArrayToBase64(array) {
+  let latin1string = "";
+  for (let i = 0; i < array.length; i++) {
+    latin1string += String.fromCodePoint(array[i]);
+  }
+  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 {
+  APICallError,
+  InvalidArgumentError,
+  InvalidDataContentError,
+  InvalidPromptError,
+  InvalidResponseDataError,
+  InvalidToolArgumentsError,
+  JSONParseError,
+  LoadAPIKeyError,
+  NoResponseBodyError,
+  NoSuchToolError,
+  NoTextGeneratedError,
+  RetryError,
+  TypeValidationError,
+  UnsupportedFunctionalityError,
+  convertBase64ToUint8Array,
+  convertUint8ArrayToBase64,
+  createEventSourceResponseHandler,
+  createJsonErrorResponseHandler,
+  createJsonResponseHandler,
+  generateId,
+  getErrorMessage,
+  isParseableJson,
+  loadApiKey,
+  parseJSON,
+  postJsonToApi,
+  postToApi,
+  safeParseJSON,
+  safeValidateTypes,
+  scale,
+  validateTypes
+};
+//# sourceMappingURL=index.mjs.map