@dexto/core 1.1.4 → 1.1.6

package/dist/llm/error-codes.cjs

@@ -0,0 +1,48 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var error_codes_exports = {};
+__export(error_codes_exports, {
+  LLMErrorCode: () => LLMErrorCode
+});
+module.exports = __toCommonJS(error_codes_exports);
+var LLMErrorCode = /* @__PURE__ */ ((LLMErrorCode2) => {
+  LLMErrorCode2["API_KEY_MISSING"] = "llm_api_key_missing";
+  LLMErrorCode2["API_KEY_INVALID"] = "llm_api_key_invalid";
+  LLMErrorCode2["API_KEY_CANDIDATE_MISSING"] = "llm_api_key_candidate_missing";
+  LLMErrorCode2["BASE_URL_MISSING"] = "llm_base_url_missing";
+  LLMErrorCode2["BASE_URL_INVALID"] = "llm_base_url_invalid";
+  LLMErrorCode2["MODEL_INCOMPATIBLE"] = "llm_model_incompatible";
+  LLMErrorCode2["MODEL_UNKNOWN"] = "llm_model_unknown";
+  LLMErrorCode2["PROVIDER_UNSUPPORTED"] = "llm_provider_unsupported";
+  LLMErrorCode2["ROUTER_UNSUPPORTED"] = "llm_router_unsupported";
+  LLMErrorCode2["INPUT_FILE_UNSUPPORTED"] = "llm_input_file_unsupported";
+  LLMErrorCode2["INPUT_IMAGE_UNSUPPORTED"] = "llm_input_image_unsupported";
+  LLMErrorCode2["INPUT_TEXT_INVALID"] = "llm_input_text_invalid";
+  LLMErrorCode2["TOKENS_EXCEEDED"] = "llm_tokens_exceeded";
+  LLMErrorCode2["RATE_LIMIT_EXCEEDED"] = "llm_rate_limit_exceeded";
+  LLMErrorCode2["SWITCH_FAILED"] = "llm_switch_failed";
+  LLMErrorCode2["GENERATION_FAILED"] = "llm_generation_failed";
+  LLMErrorCode2["SWITCH_INPUT_MISSING"] = "llm_switch_input_missing";
+  LLMErrorCode2["REQUEST_INVALID_SCHEMA"] = "llm_request_invalid_schema";
+  return LLMErrorCode2;
+})(LLMErrorCode || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LLMErrorCode
+});

package/dist/llm/error-codes.d.cts

@@ -0,0 +1,26 @@
+/**
+ * LLM-specific error codes
+ * Includes configuration, validation, and runtime errors for LLM operations
+ */
+declare enum LLMErrorCode {
+    API_KEY_MISSING = "llm_api_key_missing",
+    API_KEY_INVALID = "llm_api_key_invalid",// Too short, wrong format
+    API_KEY_CANDIDATE_MISSING = "llm_api_key_candidate_missing",
+    BASE_URL_MISSING = "llm_base_url_missing",
+    BASE_URL_INVALID = "llm_base_url_invalid",
+    MODEL_INCOMPATIBLE = "llm_model_incompatible",
+    MODEL_UNKNOWN = "llm_model_unknown",
+    PROVIDER_UNSUPPORTED = "llm_provider_unsupported",
+    ROUTER_UNSUPPORTED = "llm_router_unsupported",
+    INPUT_FILE_UNSUPPORTED = "llm_input_file_unsupported",
+    INPUT_IMAGE_UNSUPPORTED = "llm_input_image_unsupported",
+    INPUT_TEXT_INVALID = "llm_input_text_invalid",
+    TOKENS_EXCEEDED = "llm_tokens_exceeded",
+    RATE_LIMIT_EXCEEDED = "llm_rate_limit_exceeded",
+    SWITCH_FAILED = "llm_switch_failed",
+    GENERATION_FAILED = "llm_generation_failed",
+    SWITCH_INPUT_MISSING = "llm_switch_input_missing",// At least model or provider must be specified
+    REQUEST_INVALID_SCHEMA = "llm_request_invalid_schema"
+}
+
+export { LLMErrorCode };

package/dist/llm/error-codes.d.ts

@@ -0,0 +1,26 @@
+/**
+ * LLM-specific error codes
+ * Includes configuration, validation, and runtime errors for LLM operations
+ */
+declare enum LLMErrorCode {
+    API_KEY_MISSING = "llm_api_key_missing",
+    API_KEY_INVALID = "llm_api_key_invalid",// Too short, wrong format
+    API_KEY_CANDIDATE_MISSING = "llm_api_key_candidate_missing",
+    BASE_URL_MISSING = "llm_base_url_missing",
+    BASE_URL_INVALID = "llm_base_url_invalid",
+    MODEL_INCOMPATIBLE = "llm_model_incompatible",
+    MODEL_UNKNOWN = "llm_model_unknown",
+    PROVIDER_UNSUPPORTED = "llm_provider_unsupported",
+    ROUTER_UNSUPPORTED = "llm_router_unsupported",
+    INPUT_FILE_UNSUPPORTED = "llm_input_file_unsupported",
+    INPUT_IMAGE_UNSUPPORTED = "llm_input_image_unsupported",
+    INPUT_TEXT_INVALID = "llm_input_text_invalid",
+    TOKENS_EXCEEDED = "llm_tokens_exceeded",
+    RATE_LIMIT_EXCEEDED = "llm_rate_limit_exceeded",
+    SWITCH_FAILED = "llm_switch_failed",
+    GENERATION_FAILED = "llm_generation_failed",
+    SWITCH_INPUT_MISSING = "llm_switch_input_missing",// At least model or provider must be specified
+    REQUEST_INVALID_SCHEMA = "llm_request_invalid_schema"
+}
+
+export { LLMErrorCode };

package/dist/llm/error-codes.js

@@ -0,0 +1,24 @@
+var LLMErrorCode = /* @__PURE__ */ ((LLMErrorCode2) => {
+  LLMErrorCode2["API_KEY_MISSING"] = "llm_api_key_missing";
+  LLMErrorCode2["API_KEY_INVALID"] = "llm_api_key_invalid";
+  LLMErrorCode2["API_KEY_CANDIDATE_MISSING"] = "llm_api_key_candidate_missing";
+  LLMErrorCode2["BASE_URL_MISSING"] = "llm_base_url_missing";
+  LLMErrorCode2["BASE_URL_INVALID"] = "llm_base_url_invalid";
+  LLMErrorCode2["MODEL_INCOMPATIBLE"] = "llm_model_incompatible";
+  LLMErrorCode2["MODEL_UNKNOWN"] = "llm_model_unknown";
+  LLMErrorCode2["PROVIDER_UNSUPPORTED"] = "llm_provider_unsupported";
+  LLMErrorCode2["ROUTER_UNSUPPORTED"] = "llm_router_unsupported";
+  LLMErrorCode2["INPUT_FILE_UNSUPPORTED"] = "llm_input_file_unsupported";
+  LLMErrorCode2["INPUT_IMAGE_UNSUPPORTED"] = "llm_input_image_unsupported";
+  LLMErrorCode2["INPUT_TEXT_INVALID"] = "llm_input_text_invalid";
+  LLMErrorCode2["TOKENS_EXCEEDED"] = "llm_tokens_exceeded";
+  LLMErrorCode2["RATE_LIMIT_EXCEEDED"] = "llm_rate_limit_exceeded";
+  LLMErrorCode2["SWITCH_FAILED"] = "llm_switch_failed";
+  LLMErrorCode2["GENERATION_FAILED"] = "llm_generation_failed";
+  LLMErrorCode2["SWITCH_INPUT_MISSING"] = "llm_switch_input_missing";
+  LLMErrorCode2["REQUEST_INVALID_SCHEMA"] = "llm_request_invalid_schema";
+  return LLMErrorCode2;
+})(LLMErrorCode || {});
+export {
+  LLMErrorCode
+};

package/dist/llm/errors.cjs

@@ -0,0 +1,108 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var errors_exports = {};
+__export(errors_exports, {
+  LLMError: () => LLMError
+});
+module.exports = __toCommonJS(errors_exports);
+var import_DextoRuntimeError = require("../errors/DextoRuntimeError.js");
+var import_types = require("../errors/types.cjs");
+var import_types2 = require("../errors/types.js");
+var import_error_codes = require("./error-codes.js");
+var import_registry = require("./registry.js");
+class LLMError {
+  // Runtime model/provider lookup errors
+  static unknownModel(provider, model) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.MODEL_UNKNOWN,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `Unknown model '${model}' for provider '${provider}'`,
+      { provider, model }
+    );
+  }
+  static baseUrlMissing(provider) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.BASE_URL_MISSING,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `Provider '${provider}' requires a baseURL (set config.baseURL or OPENAI_BASE_URL environment variable)`,
+      { provider }
+    );
+  }
+  static modelProviderUnknown(model) {
+    const availableProviders = (0, import_registry.getSupportedProviders)();
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.MODEL_UNKNOWN,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `Unknown model '${model}' - could not infer provider. Available providers: ${availableProviders.join(", ")}`,
+      { model, availableProviders },
+      "Specify the provider explicitly or use a recognized model name"
+    );
+  }
+  static unsupportedRouter(router, provider) {
+    const supportedRouters = (0, import_registry.getSupportedRoutersForProvider)(provider).map((r) => r);
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.ROUTER_UNSUPPORTED,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `Router '${router}' not supported for provider '${provider}'. Supported: ${supportedRouters.join(", ")}`,
+      { router, provider, supportedRouters }
+    );
+  }
+  // Runtime service errors
+  static rateLimitExceeded(provider, retryAfter) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.RATE_LIMIT_EXCEEDED,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.RATE_LIMIT,
+      `Rate limit exceeded for ${provider}`,
+      {
+        details: { provider, retryAfter },
+        recovery: retryAfter ? `Wait ${retryAfter} seconds before retrying` : "Wait before retrying or upgrade your plan"
+      }
+    );
+  }
+  // Runtime operation errors
+  static generationFailed(error, provider, model) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.GENERATION_FAILED,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.THIRD_PARTY,
+      `Generation failed: ${error}`,
+      { details: { error, provider, model } }
+    );
+  }
+  // Switch operation errors (runtime checks not covered by Zod)
+  static switchInputMissing() {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.SWITCH_INPUT_MISSING,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      "At least model or provider must be specified for LLM switch",
+      {},
+      "Provide either a model name, provider, or both"
+    );
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LLMError
+});

package/dist/llm/errors.d.cts

@@ -0,0 +1,58 @@
+import { DextoRuntimeError } from '../errors/DextoRuntimeError.cjs';
+import { LLMProvider, LLMRouter } from './types.cjs';
+import '../errors/DextoBaseError.cjs';
+import '../errors/types.cjs';
+import '../agent/error-codes.cjs';
+import '../config/error-codes.cjs';
+import '../context/error-codes.cjs';
+import './error-codes.cjs';
+import '../mcp/error-codes.cjs';
+import '../session/error-codes.cjs';
+import '../storage/error-codes.cjs';
+import '../systemPrompt/error-codes.cjs';
+import '../tools/error-codes.cjs';
+import '../preferences/error-codes.cjs';
+import '../agent/registry/error-codes.cjs';
+
+/**
+ * LLM runtime error factory methods
+ * Creates properly typed errors for LLM runtime operations
+ *
+ * Note: Validation errors (missing API keys, invalid models, etc.) are handled
+ * by DextoValidationError through Zod schema validation
+ */
+declare class LLMError {
+    static unknownModel(provider: LLMProvider, model: string): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
+    }>;
+    static baseUrlMissing(provider: LLMProvider): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    }>;
+    static modelProviderUnknown(model: string): DextoRuntimeError<{
+        model: string;
+        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere")[];
+    }>;
+    static unsupportedRouter(router: LLMRouter, provider: LLMProvider): DextoRuntimeError<{
+        router: "vercel" | "in-built";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        supportedRouters: ("vercel" | "in-built")[];
+    }>;
+    static rateLimitExceeded(provider: LLMProvider, retryAfter?: number): DextoRuntimeError<{
+        details: {
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            retryAfter: number | undefined;
+        };
+        recovery: string;
+    }>;
+    static generationFailed(error: string, provider: LLMProvider, model: string): DextoRuntimeError<{
+        details: {
+            error: string;
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            model: string;
+        };
+    }>;
+    static switchInputMissing(): DextoRuntimeError<{}>;
+}
+
+export { LLMError };

package/dist/llm/errors.d.ts

@@ -0,0 +1,58 @@
+import { DextoRuntimeError } from '../errors/DextoRuntimeError.js';
+import { LLMProvider, LLMRouter } from './types.js';
+import '../errors/DextoBaseError.js';
+import '../errors/types.js';
+import '../agent/error-codes.js';
+import '../config/error-codes.js';
+import '../context/error-codes.js';
+import './error-codes.js';
+import '../mcp/error-codes.js';
+import '../session/error-codes.js';
+import '../storage/error-codes.js';
+import '../systemPrompt/error-codes.js';
+import '../tools/error-codes.js';
+import '../preferences/error-codes.js';
+import '../agent/registry/error-codes.js';
+
+/**
+ * LLM runtime error factory methods
+ * Creates properly typed errors for LLM runtime operations
+ *
+ * Note: Validation errors (missing API keys, invalid models, etc.) are handled
+ * by DextoValidationError through Zod schema validation
+ */
+declare class LLMError {
+    static unknownModel(provider: LLMProvider, model: string): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        model: string;
+    }>;
+    static baseUrlMissing(provider: LLMProvider): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+    }>;
+    static modelProviderUnknown(model: string): DextoRuntimeError<{
+        model: string;
+        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere")[];
+    }>;
+    static unsupportedRouter(router: LLMRouter, provider: LLMProvider): DextoRuntimeError<{
+        router: "vercel" | "in-built";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        supportedRouters: ("vercel" | "in-built")[];
+    }>;
+    static rateLimitExceeded(provider: LLMProvider, retryAfter?: number): DextoRuntimeError<{
+        details: {
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            retryAfter: number | undefined;
+        };
+        recovery: string;
+    }>;
+    static generationFailed(error: string, provider: LLMProvider, model: string): DextoRuntimeError<{
+        details: {
+            error: string;
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            model: string;
+        };
+    }>;
+    static switchInputMissing(): DextoRuntimeError<{}>;
+}
+
+export { LLMError };

package/dist/llm/errors.js

@@ -0,0 +1,84 @@
+import { DextoRuntimeError } from "../errors/DextoRuntimeError.js";
+import { ErrorScope } from "../errors/types.js";
+import { ErrorType } from "../errors/types.js";
+import { LLMErrorCode } from "./error-codes.js";
+import { getSupportedProviders, getSupportedRoutersForProvider } from "./registry.js";
+class LLMError {
+  // Runtime model/provider lookup errors
+  static unknownModel(provider, model) {
+    return new DextoRuntimeError(
+      LLMErrorCode.MODEL_UNKNOWN,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `Unknown model '${model}' for provider '${provider}'`,
+      { provider, model }
+    );
+  }
+  static baseUrlMissing(provider) {
+    return new DextoRuntimeError(
+      LLMErrorCode.BASE_URL_MISSING,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `Provider '${provider}' requires a baseURL (set config.baseURL or OPENAI_BASE_URL environment variable)`,
+      { provider }
+    );
+  }
+  static modelProviderUnknown(model) {
+    const availableProviders = getSupportedProviders();
+    return new DextoRuntimeError(
+      LLMErrorCode.MODEL_UNKNOWN,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `Unknown model '${model}' - could not infer provider. Available providers: ${availableProviders.join(", ")}`,
+      { model, availableProviders },
+      "Specify the provider explicitly or use a recognized model name"
+    );
+  }
+  static unsupportedRouter(router, provider) {
+    const supportedRouters = getSupportedRoutersForProvider(provider).map((r) => r);
+    return new DextoRuntimeError(
+      LLMErrorCode.ROUTER_UNSUPPORTED,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      `Router '${router}' not supported for provider '${provider}'. Supported: ${supportedRouters.join(", ")}`,
+      { router, provider, supportedRouters }
+    );
+  }
+  // Runtime service errors
+  static rateLimitExceeded(provider, retryAfter) {
+    return new DextoRuntimeError(
+      LLMErrorCode.RATE_LIMIT_EXCEEDED,
+      ErrorScope.LLM,
+      ErrorType.RATE_LIMIT,
+      `Rate limit exceeded for ${provider}`,
+      {
+        details: { provider, retryAfter },
+        recovery: retryAfter ? `Wait ${retryAfter} seconds before retrying` : "Wait before retrying or upgrade your plan"
+      }
+    );
+  }
+  // Runtime operation errors
+  static generationFailed(error, provider, model) {
+    return new DextoRuntimeError(
+      LLMErrorCode.GENERATION_FAILED,
+      ErrorScope.LLM,
+      ErrorType.THIRD_PARTY,
+      `Generation failed: ${error}`,
+      { details: { error, provider, model } }
+    );
+  }
+  // Switch operation errors (runtime checks not covered by Zod)
+  static switchInputMissing() {
+    return new DextoRuntimeError(
+      LLMErrorCode.SWITCH_INPUT_MISSING,
+      ErrorScope.LLM,
+      ErrorType.USER,
+      "At least model or provider must be specified for LLM switch",
+      {},
+      "Provide either a model name, provider, or both"
+    );
+  }
+}
+export {
+  LLMError
+};