@dexto/core 1.4.0 → 1.5.1

package/dist/image/define-image.js

@@ -0,0 +1,121 @@
+import "../chunk-PTJYTZNU.js";
+function defineImage(definition) {
+  if (!definition.name) {
+    throw new Error("Image definition must have a name");
+  }
+  if (!definition.version) {
+    throw new Error("Image definition must have a version");
+  }
+  if (!definition.description) {
+    throw new Error("Image definition must have a description");
+  }
+  for (const [category, config] of Object.entries(definition.providers)) {
+    if (!config) continue;
+    if (!config.providers && !config.register) {
+      throw new Error(
+        `Provider category '${category}' must have either 'providers' array or 'register' function`
+      );
+    }
+  }
+  return definition;
+}
+function defineProviderCategory(config) {
+  if (!config.providers && !config.register) {
+    throw new Error("Provider category must have either providers or register function");
+  }
+  return config;
+}
+function validateImageDefinition(definition) {
+  if (!definition.name || typeof definition.name !== "string") {
+    throw new Error("Image name must be a non-empty string");
+  }
+  if (!definition.version || typeof definition.version !== "string") {
+    throw new Error("Image version must be a non-empty string");
+  }
+  if (!definition.description || typeof definition.description !== "string") {
+    throw new Error("Image description must be a non-empty string");
+  }
+  const versionRegex = /^\d+\.\d+\.\d+(-[a-zA-Z0-9.-]+)?$/;
+  if (!versionRegex.test(definition.version)) {
+    throw new Error(
+      `Image version '${definition.version}' is not valid semver. Expected format: x.y.z`
+    );
+  }
+  const validTargets = [
+    "local-development",
+    "cloud-production",
+    "edge-serverless",
+    "embedded-iot",
+    "enterprise",
+    "custom"
+  ];
+  if (definition.target && !validTargets.includes(definition.target)) {
+    throw new Error(
+      `Invalid target '${definition.target}'. Valid targets: ${validTargets.join(", ")}`
+    );
+  }
+  const hasProviders = definition.providers && Object.values(definition.providers).some((config) => config !== void 0);
+  if (!hasProviders && !definition.extends) {
+    throw new Error(
+      "Image must either define at least one provider category or extend a base image"
+    );
+  }
+  for (const [category, config] of Object.entries(definition.providers)) {
+    if (!config) continue;
+    if (!config.providers && !config.register) {
+      throw new Error(
+        `Provider category '${category}' must have either 'providers' array or 'register' function`
+      );
+    }
+    if (config.providers && !Array.isArray(config.providers)) {
+      throw new Error(`Provider category '${category}' providers must be an array`);
+    }
+    if (config.register && typeof config.register !== "function") {
+      throw new Error(`Provider category '${category}' register must be a function`);
+    }
+  }
+  const validConstraints = [
+    "filesystem-required",
+    "network-required",
+    "offline-capable",
+    "serverless-compatible",
+    "cold-start-optimized",
+    "low-memory",
+    "edge-compatible",
+    "browser-compatible"
+  ];
+  if (definition.constraints) {
+    if (!Array.isArray(definition.constraints)) {
+      throw new Error("Image constraints must be an array");
+    }
+    for (const constraint of definition.constraints) {
+      if (!validConstraints.includes(constraint)) {
+        throw new Error(
+          `Invalid constraint '${constraint}'. Valid constraints: ${validConstraints.join(", ")}`
+        );
+      }
+    }
+  }
+  if (definition.utils) {
+    for (const [name, path] of Object.entries(definition.utils)) {
+      if (typeof path !== "string") {
+        throw new Error(`Utility '${name}' path must be a string`);
+      }
+      if (!path.startsWith("./")) {
+        throw new Error(
+          `Utility '${name}' path must be relative (start with './'). Got: ${path}`
+        );
+      }
+    }
+  }
+  if (definition.extends) {
+    if (typeof definition.extends !== "string") {
+      throw new Error("Image extends must be a string (parent image name)");
+    }
+  }
+}
+export {
+  defineImage,
+  defineProviderCategory,
+  validateImageDefinition
+};

package/dist/image/index.cjs

@@ -0,0 +1,32 @@
+"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 image_exports = {};
+__export(image_exports, {
+  defineImage: () => import_define_image.defineImage,
+  defineProviderCategory: () => import_define_image.defineProviderCategory,
+  validateImageDefinition: () => import_define_image.validateImageDefinition
+});
+module.exports = __toCommonJS(image_exports);
+var import_define_image = require("./define-image.js");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineImage,
+  defineProviderCategory,
+  validateImageDefinition
+});

package/dist/image/index.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Base Image Infrastructure
+ *
+ * Provides types and helpers for defining Dexto base images.
+ * Base images are pre-configured backend surfaces that bundle providers,
+ * utilities, and defaults for specific deployment targets.
+ *
+ * @example Creating a base image
+ * ```typescript
+ * // dexto.image.ts
+ * import { defineImage } from '@dexto/core';
+ *
+ * export default defineImage({
+ *   name: 'local',
+ *   version: '1.0.0',
+ *   description: 'Local development base image',
+ *   target: 'local-development',
+ *
+ *   providers: {
+ *     blobStore: {
+ *       providers: [localBlobProvider],
+ *     },
+ *     database: {
+ *       register: async () => {
+ *         const { sqliteProvider } = await import('./providers/database.js');
+ *         databaseRegistry.register(sqliteProvider);
+ *       },
+ *     },
+ *   },
+ *
+ *   defaults: {
+ *     storage: {
+ *       blob: { type: 'local', storePath: './data/blobs' },
+ *       database: { type: 'sqlite', path: './data/agent.db' },
+ *     },
+ *   },
+ *
+ *   constraints: ['filesystem-required', 'offline-capable'],
+ * });
+ * ```
+ *
+ * @example Using a base image
+ * ```typescript
+ * // my-app/src/index.ts
+ * import { createAgent, enrichConfigForLocal } from '@dexto/image-local';
+ *
+ * const config = enrichConfigForLocal(rawConfig);
+ * const agent = createAgent(config); // Providers already registered!
+ * ```
+ */
+export type { ImageProvider, ProviderMetadata, ProviderRegistrationFn, ProviderCategoryConfig, ImageDefinition, ImageTarget, ImageConstraint, ImageDefaults, ImageMetadata, ImageBuildResult, ImageBuildOptions, } from './types.js';
+export { defineImage, defineProviderCategory, validateImageDefinition } from './define-image.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/image/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/image/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAGH,YAAY,EACR,aAAa,EACb,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,WAAW,EACX,eAAe,EACf,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,iBAAiB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/image/index.js

@@ -0,0 +1,7 @@
+import "../chunk-PTJYTZNU.js";
+import { defineImage, defineProviderCategory, validateImageDefinition } from "./define-image.js";
+export {
+  defineImage,
+  defineProviderCategory,
+  validateImageDefinition
+};

package/dist/image/types.cjs

@@ -0,0 +1,16 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/dist/image/types.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Dexto Base Image Definition
+ *
+ * Base images are pre-configured backend surfaces that bundle providers,
+ * utilities, and defaults for specific deployment targets.
+ *
+ * Like Alpine Linux or Ubuntu, but for AI agents.
+ */
+import type { z } from 'zod';
+/**
+ * Generic provider interface that all provider types should extend.
+ * Provides common structure for type-safe provider registration.
+ *
+ * Note: This is a simplified interface for image definitions.
+ * Actual provider implementations should use the specific provider
+ * interfaces from their respective modules (e.g., BlobStoreProvider).
+ */
+export interface ImageProvider<TType extends string = string> {
+    /** Unique type identifier for this provider (e.g., 'sqlite', 'local', 's3') */
+    type: TType;
+    /** Zod schema for validating provider configuration */
+    configSchema: z.ZodType<any>;
+    /** Factory function to create provider instance */
+    create: (config: any, deps: any) => any;
+    /** Optional metadata about the provider */
+    metadata?: ProviderMetadata;
+}
+/**
+ * Metadata about a provider's characteristics and requirements
+ */
+export interface ProviderMetadata {
+    /** Human-readable display name */
+    displayName?: string;
+    /** Brief description of what this provider does */
+    description?: string;
+    /** Whether this provider requires network connectivity */
+    requiresNetwork?: boolean;
+    /** Whether this provider requires filesystem access */
+    requiresFilesystem?: boolean;
+    /** Persistence level of storage providers */
+    persistenceLevel?: 'ephemeral' | 'persistent';
+    /** Platforms this provider is compatible with */
+    platforms?: ('node' | 'browser' | 'edge' | 'worker')[];
+}
+/**
+ * Registry function that registers providers on module initialization.
+ * Called automatically when the image is imported.
+ */
+export type ProviderRegistrationFn = () => void | Promise<void>;
+/**
+ * Configuration for a single provider category in an image.
+ * Supports both direct provider objects and registration functions.
+ */
+export interface ProviderCategoryConfig {
+    /** Direct provider objects to register */
+    providers?: ImageProvider[];
+    /** Registration function for complex initialization */
+    register?: ProviderRegistrationFn;
+}
+/**
+ * Complete image definition structure.
+ * This is what dexto.image.ts exports.
+ */
+export interface ImageDefinition {
+    /** Unique name for this image (e.g., 'local', 'cloud', 'edge') */
+    name: string;
+    /** Semantic version of this image */
+    version: string;
+    /** Brief description of this image's purpose and target environment */
+    description: string;
+    /** Target deployment environment (for documentation and validation) */
+    target?: ImageTarget;
+    /**
+     * Provider categories to register.
+     * Each category can include direct providers or a registration function.
+     */
+    providers: {
+        /** Blob storage providers (e.g., local filesystem, S3, R2) */
+        blobStore?: ProviderCategoryConfig;
+        /** Database providers (e.g., SQLite, PostgreSQL, D1) */
+        database?: ProviderCategoryConfig;
+        /** Cache providers (e.g., in-memory, Redis, KV) */
+        cache?: ProviderCategoryConfig;
+        /** Custom tool providers (e.g., datetime helpers, API integrations) */
+        customTools?: ProviderCategoryConfig;
+        /** Plugin providers (e.g., audit logging, content filtering) */
+        plugins?: ProviderCategoryConfig;
+        /** Compression strategy providers (e.g., sliding window, summarization) */
+        compression?: ProviderCategoryConfig;
+    };
+    /**
+     * Default configuration values.
+     * Used when agent config doesn't specify values.
+     * Merged with agent config during agent creation.
+     */
+    defaults?: ImageDefaults;
+    /**
+     * Runtime constraints this image requires.
+     * Used for validation and error messages.
+     */
+    constraints?: ImageConstraint[];
+    /**
+     * Utilities exported by this image.
+     * Maps utility name to file path (relative to image root).
+     *
+     * Example:
+     * {
+     *   configEnrichment: './utils/config.js',
+     *   lifecycle: './utils/lifecycle.js'
+     * }
+     */
+    utils?: Record<string, string>;
+    /**
+     * Selective named exports from packages.
+     * Allows re-exporting specific types and values from dependencies.
+     *
+     * Example:
+     * {
+     *   '@dexto/core': ['logger', 'createAgentCard', 'type DextoAgent'],
+     *   '@dexto/utils': ['formatDate', 'parseConfig']
+     * }
+     */
+    exports?: Record<string, string[]>;
+    /**
+     * Parent image to extend (for image inheritance).
+     * Optional: enables creating specialized images from base images.
+     */
+    extends?: string;
+}
+/**
+ * Target deployment environments for images.
+ * Helps users choose the right image for their use case.
+ */
+export type ImageTarget = 'local-development' | 'cloud-production' | 'edge-serverless' | 'embedded-iot' | 'enterprise' | 'custom';
+/**
+ * Runtime constraints that an image requires.
+ * Used for validation and helpful error messages.
+ */
+export type ImageConstraint = 'filesystem-required' | 'network-required' | 'offline-capable' | 'serverless-compatible' | 'cold-start-optimized' | 'low-memory' | 'edge-compatible' | 'browser-compatible';
+/**
+ * Default configuration values provided by an image.
+ * These are used when agent config doesn't specify values.
+ */
+export interface ImageDefaults {
+    /** Default storage configuration */
+    storage?: {
+        database?: {
+            type: string;
+            [key: string]: any;
+        };
+        blob?: {
+            type: string;
+            [key: string]: any;
+        };
+        cache?: {
+            type: string;
+            [key: string]: any;
+        };
+    };
+    /** Default logging configuration */
+    logging?: {
+        level?: 'debug' | 'info' | 'warn' | 'error';
+        fileLogging?: boolean;
+        [key: string]: any;
+    };
+    /** Default LLM configuration */
+    llm?: {
+        provider?: string;
+        model?: string;
+        [key: string]: any;
+    };
+    /** Default tool configuration */
+    tools?: {
+        internalTools?: string[];
+        [key: string]: any;
+    };
+    /** Other default values */
+    [key: string]: any;
+}
+/**
+ * Metadata about a built image (generated by bundler).
+ * Included in the compiled image output.
+ */
+export interface ImageMetadata {
+    /** Image name */
+    name: string;
+    /** Image version */
+    version: string;
+    /** Description */
+    description: string;
+    /** Target environment */
+    target?: ImageTarget;
+    /** Runtime constraints */
+    constraints: ImageConstraint[];
+    /** Build timestamp */
+    builtAt: string;
+    /** Core version this image was built for */
+    coreVersion: string;
+    /** Base image this extends (if any) */
+    extends?: string;
+}
+/**
+ * Result of building an image.
+ * Contains the generated code and metadata.
+ */
+export interface ImageBuildResult {
+    /** Generated JavaScript code for the image entry point */
+    code: string;
+    /** Generated TypeScript definitions */
+    types: string;
+    /** Image metadata */
+    metadata: ImageMetadata;
+    /** Warnings encountered during build */
+    warnings?: string[];
+}
+/**
+ * Options for building an image.
+ */
+export interface ImageBuildOptions {
+    /** Path to dexto.image.ts file */
+    imagePath: string;
+    /** Output directory for built image */
+    outDir: string;
+    /** Whether to generate source maps */
+    sourcemap?: boolean;
+    /** Whether to minify output */
+    minify?: boolean;
+    /** Additional validation rules */
+    strict?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/image/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/image/types.ts"],"names":[],"mappings":"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"}

package/dist/index.cjs

@@ -43,6 +43,8 @@ __reExport(index_exports, require("./approval/index.js"), module.exports);
 __reExport(index_exports, require("./memory/index.js"), module.exports);
 __reExport(index_exports, require("./plugins/index.js"), module.exports);
 __reExport(index_exports, require("./telemetry/index.js"), module.exports);
+__reExport(index_exports, require("./providers/index.js"), module.exports);
+__reExport(index_exports, require("./image/index.js"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   getFileMediaKind,
@@ -65,5 +67,7 @@ __reExport(index_exports, require("./telemetry/index.js"), module.exports);
   ...require("./approval/index.js"),
   ...require("./memory/index.js"),
   ...require("./plugins/index.js"),
-  ...require("./telemetry/index.js")
+  ...require("./telemetry/index.js"),
+  ...require("./providers/index.js"),
+  ...require("./image/index.js")
 });

package/dist/index.d.ts

@@ -40,4 +40,6 @@ export * from './approval/index.js';
 export * from './memory/index.js';
 export * from './plugins/index.js';
 export * from './telemetry/index.js';
+export * from './providers/index.js';
+export * from './image/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,kBAAkB,CAAC;AAUjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,cAAc,kBAAkB,CAAC;AAUjC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,mBAAmB,CAAC;AAGlC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,yBAAyB,CAAC;AAGxC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,oBAAoB,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGvE,cAAc,oBAAoB,CAAC;AAGnC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -19,6 +19,8 @@ export * from "./approval/index.js";
 export * from "./memory/index.js";
 export * from "./plugins/index.js";
 export * from "./telemetry/index.js";
+export * from "./providers/index.js";
+export * from "./image/index.js";
 export {
   getFileMediaKind,
   getResourceKind

package/dist/llm/error-codes.cjs

@@ -27,6 +27,7 @@ var LLMErrorCode = /* @__PURE__ */ ((LLMErrorCode2) => {
   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["CONFIG_MISSING"] = "llm_config_missing";
   LLMErrorCode2["MODEL_INCOMPATIBLE"] = "llm_model_incompatible";
   LLMErrorCode2["MODEL_UNKNOWN"] = "llm_model_unknown";
   LLMErrorCode2["PROVIDER_UNSUPPORTED"] = "llm_provider_unsupported";

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

@@ -8,6 +8,7 @@ export declare enum LLMErrorCode {
     API_KEY_CANDIDATE_MISSING = "llm_api_key_candidate_missing",
     BASE_URL_MISSING = "llm_base_url_missing",
     BASE_URL_INVALID = "llm_base_url_invalid",
+    CONFIG_MISSING = "llm_config_missing",// Required config (e.g., GOOGLE_VERTEX_PROJECT)
     MODEL_INCOMPATIBLE = "llm_model_incompatible",
     MODEL_UNKNOWN = "llm_model_unknown",
     PROVIDER_UNSUPPORTED = "llm_provider_unsupported",

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

@@ -1 +1 @@
-{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/llm/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,YAAY;IAEpB,eAAe,wBAAwB;IACvC,eAAe,wBAAwB,CAAE,0BAA0B;IACnE,yBAAyB,kCAAkC;IAC3D,gBAAgB,yBAAyB;IACzC,gBAAgB,yBAAyB;IAGzC,kBAAkB,2BAA2B;IAC7C,aAAa,sBAAsB;IACnC,oBAAoB,6BAA6B;IAGjD,sBAAsB,+BAA+B;IACrD,uBAAuB,gCAAgC;IACvD,kBAAkB,2BAA2B;IAG7C,eAAe,wBAAwB;IACvC,mBAAmB,4BAA4B;IAG/C,aAAa,sBAAsB;IACnC,iBAAiB,0BAA0B;IAG3C,oBAAoB,6BAA6B,CAAE,+CAA+C;IAGlG,sBAAsB,+BAA+B;CACxD"}
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/llm/error-codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,oBAAY,YAAY;IAEpB,eAAe,wBAAwB;IACvC,eAAe,wBAAwB,CAAE,0BAA0B;IACnE,yBAAyB,kCAAkC;IAC3D,gBAAgB,yBAAyB;IACzC,gBAAgB,yBAAyB;IACzC,cAAc,uBAAuB,CAAE,gDAAgD;IAGvF,kBAAkB,2BAA2B;IAC7C,aAAa,sBAAsB;IACnC,oBAAoB,6BAA6B;IAGjD,sBAAsB,+BAA+B;IACrD,uBAAuB,gCAAgC;IACvD,kBAAkB,2BAA2B;IAG7C,eAAe,wBAAwB;IACvC,mBAAmB,4BAA4B;IAG/C,aAAa,sBAAsB;IACnC,iBAAiB,0BAA0B;IAG3C,oBAAoB,6BAA6B,CAAE,+CAA+C;IAGlG,sBAAsB,+BAA+B;CACxD"}

package/dist/llm/error-codes.js

@@ -5,6 +5,7 @@ var LLMErrorCode = /* @__PURE__ */ ((LLMErrorCode2) => {
   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["CONFIG_MISSING"] = "llm_config_missing";
   LLMErrorCode2["MODEL_INCOMPATIBLE"] = "llm_model_incompatible";
   LLMErrorCode2["MODEL_UNKNOWN"] = "llm_model_unknown";
   LLMErrorCode2["PROVIDER_UNSUPPORTED"] = "llm_provider_unsupported";

package/dist/llm/errors.cjs

@@ -46,6 +46,15 @@ class LLMError {
       { provider }
     );
   }
+  static missingConfig(provider, configName) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.CONFIG_MISSING,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `Provider '${provider}' requires ${configName}`,
+      { provider, configName }
+    );
+  }
   static unsupportedProvider(provider) {
     const availableProviders = (0, import_registry.getSupportedProviders)();
     return new import_DextoRuntimeError.DextoRuntimeError(
@@ -56,6 +65,21 @@ class LLMError {
       { provider, availableProviders }
     );
   }
+  /**
+   * Runtime error when API key is missing for a provider that requires it.
+   * This occurs when relaxed validation allowed the app to start without an API key,
+   * and the user then tries to use the LLM functionality.
+   */
+  static apiKeyMissing(provider, envVar) {
+    return new import_DextoRuntimeError.DextoRuntimeError(
+      import_error_codes.LLMErrorCode.API_KEY_MISSING,
+      import_types.ErrorScope.LLM,
+      import_types2.ErrorType.USER,
+      `API key required for provider '${provider}'`,
+      { provider, envVar },
+      `Set the ${envVar} environment variable or configure it in Settings`
+    );
+  }
   static modelProviderUnknown(model) {
     const availableProviders = (0, import_registry.getSupportedProviders)();
     return new import_DextoRuntimeError.DextoRuntimeError(

package/dist/llm/errors.d.ts

@@ -9,23 +9,36 @@ import type { LLMProvider } from './types.js';
  */
 export declare class LLMError {
     static unknownModel(provider: LLMProvider, model: string): DextoRuntimeError<{
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
         model: string;
     }>;
     static baseUrlMissing(provider: LLMProvider): DextoRuntimeError<{
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+    }>;
+    static missingConfig(provider: LLMProvider, configName: string): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        configName: string;
     }>;
     static unsupportedProvider(provider: string): DextoRuntimeError<{
         provider: string;
-        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere")[];
+        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama")[];
+    }>;
+    /**
+     * Runtime error when API key is missing for a provider that requires it.
+     * This occurs when relaxed validation allowed the app to start without an API key,
+     * and the user then tries to use the LLM functionality.
+     */
+    static apiKeyMissing(provider: LLMProvider, envVar: string): DextoRuntimeError<{
+        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
+        envVar: string;
     }>;
     static modelProviderUnknown(model: string): DextoRuntimeError<{
         model: string;
-        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere")[];
+        availableProviders: ("openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama")[];
     }>;
     static rateLimitExceeded(provider: LLMProvider, retryAfter?: number): DextoRuntimeError<{
         details: {
-            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
             retryAfter: number | undefined;
         };
         recovery: string;
@@ -33,7 +46,7 @@ export declare class LLMError {
     static generationFailed(error: string, provider: LLMProvider, model: string): DextoRuntimeError<{
         details: {
             error: string;
-            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
+            provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere" | "openrouter" | "litellm" | "glama" | "vertex" | "bedrock" | "local" | "ollama";
             model: string;
         };
     }>;

package/dist/llm/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEjB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM;;;;IAUxD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW;;;IAU3C,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM;;;;IAW3C,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM;;;;IAczC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM;;;;;;;IAgBnE,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM;;;;;;;IAW3E,MAAM,CAAC,kBAAkB;CAU5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/llm/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAMnE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,qBAAa,QAAQ;IAEjB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM;;;;IAUxD,MAAM,CAAC,cAAc,CAAC,QAAQ,EAAE,WAAW;;;IAU3C,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM;;;;IAU9D,MAAM,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM;;;;IAW3C;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM;;;;IAW1D,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,MAAM;;;;IAczC,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM;;;;;;;IAgBnE,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM;;;;;;;IAW3E,MAAM,CAAC,kBAAkB;CAU5B"}