@dexto/core 1.3.0 → 1.5.0

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.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.browser.cjs

@@ -19,24 +19,31 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_browser_exports = {};
 __export(index_browser_exports, {
   ALLOWED_TOOLS_STORAGE_TYPES: () => import_schemas3.ALLOWED_TOOLS_STORAGE_TYPES,
-  ApprovalStatus: () => import_types3.ApprovalStatus,
-  ApprovalType: () => import_types3.ApprovalType,
+  ApprovalStatus: () => import_types4.ApprovalStatus,
+  ApprovalType: () => import_types4.ApprovalType,
   CACHE_TYPES: () => import_schemas2.CACHE_TYPES,
   DATABASE_TYPES: () => import_schemas2.DATABASE_TYPES,
   DEFAULT_ALLOWED_TOOLS_STORAGE: () => import_schemas3.DEFAULT_ALLOWED_TOOLS_STORAGE,
   DEFAULT_MCP_CONNECTION_MODE: () => import_schemas.DEFAULT_MCP_CONNECTION_MODE,
   DEFAULT_TOOL_CONFIRMATION_MODE: () => import_schemas3.DEFAULT_TOOL_CONFIRMATION_MODE,
-  DenialReason: () => import_types3.DenialReason,
+  DenialReason: () => import_types4.DenialReason,
   ErrorScope: () => import_types.ErrorScope,
   ErrorType: () => import_types.ErrorType,
-  LLM_PROVIDERS: () => import_types2.LLM_PROVIDERS,
-  LLM_ROUTERS: () => import_types2.LLM_ROUTERS,
+  LLM_PROVIDERS: () => import_types3.LLM_PROVIDERS,
   MCP_CONNECTION_MODES: () => import_schemas.MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES: () => import_schemas.MCP_SERVER_TYPES,
   PROMPT_GENERATOR_SOURCES: () => import_registry.PROMPT_GENERATOR_SOURCES,
   TOOL_CONFIRMATION_MODES: () => import_schemas3.TOOL_CONFIRMATION_MODES,
   getFileMediaKind: () => import_media_helpers.getFileMediaKind,
   getResourceKind: () => import_media_helpers.getResourceKind,
+  isAssistantMessage: () => import_types2.isAssistantMessage,
+  isFilePart: () => import_types2.isFilePart,
+  isImagePart: () => import_types2.isImagePart,
+  isSystemMessage: () => import_types2.isSystemMessage,
+  isTextPart: () => import_types2.isTextPart,
+  isToolMessage: () => import_types2.isToolMessage,
+  isUIResourcePart: () => import_types2.isUIResourcePart,
+  isUserMessage: () => import_types2.isUserMessage,
   parseResourceReferences: () => import_reference_parser.parseResourceReferences,
   resolveResourceReferences: () => import_reference_parser.resolveResourceReferences,
   toError: () => import_error_conversion.toError,
@@ -46,12 +53,13 @@ module.exports = __toCommonJS(index_browser_exports);
 var import_error_conversion = require("./utils/error-conversion.js");
 var import_result = require("./utils/result.js");
 var import_types = require("./errors/types.js");
+var import_types2 = require("./context/types.js");
 var import_media_helpers = require("./context/media-helpers.js");
-var import_types2 = require("./llm/types.js");
+var import_types3 = require("./llm/types.js");
 var import_schemas = require("./mcp/schemas.js");
 var import_schemas2 = require("./storage/schemas.js");
 var import_schemas3 = require("./tools/schemas.js");
-var import_types3 = require("./approval/types.js");
+var import_types4 = require("./approval/types.js");
 var import_registry = require("./systemPrompt/registry.js");
 var import_reference_parser = require("./resources/reference-parser.js");
 // Annotate the CommonJS export names for ESM import in node:
@@ -68,13 +76,20 @@ var import_reference_parser = require("./resources/reference-parser.js");
   ErrorScope,
   ErrorType,
   LLM_PROVIDERS,
-  LLM_ROUTERS,
   MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES,
   PROMPT_GENERATOR_SOURCES,
   TOOL_CONFIRMATION_MODES,
   getFileMediaKind,
   getResourceKind,
+  isAssistantMessage,
+  isFilePart,
+  isImagePart,
+  isSystemMessage,
+  isTextPart,
+  isToolMessage,
+  isUIResourcePart,
+  isUserMessage,
   parseResourceReferences,
   resolveResourceReferences,
   toError,

package/dist/index.browser.d.ts

@@ -2,10 +2,11 @@ export { toError } from './utils/error-conversion.js';
 export { zodToIssues } from './utils/result.js';
 export { ErrorScope, ErrorType } from './errors/types.js';
 export type { Issue, Severity, DextoErrorCode } from './errors/types.js';
-export type { InternalMessage, TextPart, FilePart, ImageData, FileData } from './context/types.js';
+export type { InternalMessage, SystemMessage, UserMessage, AssistantMessage, ToolMessage, TextPart, FilePart, ImageData, FileData, UIResourcePart, ContentPart, ToolCall, ToolApprovalStatus, } from './context/types.js';
+export { isSystemMessage, isUserMessage, isAssistantMessage, isToolMessage, isTextPart, isImagePart, isFilePart, isUIResourcePart, } from './context/types.js';
 export { getFileMediaKind, getResourceKind } from './context/media-helpers.js';
-export type { LLMProvider, LLMRouter } from './llm/types.js';
-export { LLM_PROVIDERS, LLM_ROUTERS } from './llm/types.js';
+export type { LLMProvider } from './llm/types.js';
+export { LLM_PROVIDERS } from './llm/types.js';
 export type { McpServerType, McpConnectionMode } from './mcp/schemas.js';
 export { MCP_SERVER_TYPES, MCP_CONNECTION_MODES, DEFAULT_MCP_CONNECTION_MODE, } from './mcp/schemas.js';
 export type { CacheType, DatabaseType } from './storage/schemas.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAInG,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/E,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG5D,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EACH,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGvF,YAAY,EACR,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.browser.d.ts","sourceRoot":"","sources":["../src/index.browser.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAG1D,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAGzE,YAAY,EACR,eAAe,EACf,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,cAAc,EACd,WAAW,EACX,QAAQ,EACR,kBAAkB,GACrB,MAAM,oBAAoB,CAAC;AAI5B,OAAO,EACH,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,UAAU,EACV,WAAW,EACX,UAAU,EACV,gBAAgB,GACnB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAG/E,YAAY,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EACH,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,GAC9B,MAAM,kBAAkB,CAAC;AAG1B,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGnE,YAAY,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AACxF,OAAO,EACH,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,GAChC,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACjF,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,YAAY,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAG5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAGvF,YAAY,EACR,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGxE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAKxD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EACH,uBAAuB,EACvB,yBAAyB,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/index.browser.js

@@ -1,9 +1,19 @@
-import "./chunk-C6A6W6XS.js";
+import "./chunk-PTJYTZNU.js";
 import { toError } from "./utils/error-conversion.js";
 import { zodToIssues } from "./utils/result.js";
 import { ErrorScope, ErrorType } from "./errors/types.js";
+import {
+  isSystemMessage,
+  isUserMessage,
+  isAssistantMessage,
+  isToolMessage,
+  isTextPart,
+  isImagePart,
+  isFilePart,
+  isUIResourcePart
+} from "./context/types.js";
 import { getFileMediaKind, getResourceKind } from "./context/media-helpers.js";
-import { LLM_PROVIDERS, LLM_ROUTERS } from "./llm/types.js";
+import { LLM_PROVIDERS } from "./llm/types.js";
 import {
   MCP_SERVER_TYPES,
   MCP_CONNECTION_MODES,
@@ -35,13 +45,20 @@ export {
   ErrorScope,
   ErrorType,
   LLM_PROVIDERS,
-  LLM_ROUTERS,
   MCP_CONNECTION_MODES,
   MCP_SERVER_TYPES,
   PROMPT_GENERATOR_SOURCES,
   TOOL_CONFIRMATION_MODES,
   getFileMediaKind,
   getResourceKind,
+  isAssistantMessage,
+  isFilePart,
+  isImagePart,
+  isSystemMessage,
+  isTextPart,
+  isToolMessage,
+  isUIResourcePart,
+  isUserMessage,
   parseResourceReferences,
   resolveResourceReferences,
   toError,

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

@@ -1,4 +1,4 @@
-import "./chunk-C6A6W6XS.js";
+import "./chunk-PTJYTZNU.js";
 export * from "./agent/index.js";
 export * from "./errors/index.js";
 export * from "./events/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,10 +27,10 @@ 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";
-  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";

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

@@ -8,10 +8,10 @@ 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",
-    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",

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;IACjD,kBAAkB,2BAA2B;IAG7C,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

@@ -1,14 +1,14 @@
-import "../chunk-C6A6W6XS.js";
+import "../chunk-PTJYTZNU.js";
 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["CONFIG_MISSING"] = "llm_config_missing";
   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";

package/dist/llm/errors.cjs

@@ -46,25 +46,49 @@ class LLMError {
       { provider }
     );
   }
-  static modelProviderUnknown(model) {
+  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(
-      import_error_codes.LLMErrorCode.MODEL_UNKNOWN,
+      import_error_codes.LLMErrorCode.PROVIDER_UNSUPPORTED,
       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"
+      `Provider '${provider}' is not supported. Available providers: ${availableProviders.join(", ")}`,
+      { provider, availableProviders }
     );
   }
-  static unsupportedRouter(router, provider) {
-    const supportedRouters = (0, import_registry.getSupportedRoutersForProvider)(provider).map((r) => r);
+  /**
+   * 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.ROUTER_UNSUPPORTED,
+      import_error_codes.LLMErrorCode.API_KEY_MISSING,
       import_types.ErrorScope.LLM,
       import_types2.ErrorType.USER,
-      `Router '${router}' not supported for provider '${provider}'. Supported: ${supportedRouters.join(", ")}`,
-      { router, provider, supportedRouters }
+      `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(
+      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"
     );
   }
   // Runtime service errors