@dexto/core 1.5.7 → 1.6.0

package/dist/image/index.d.ts

@@ -1,53 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

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

package/dist/image/types.d.ts

@@ -1,246 +0,0 @@
-/**
- * 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;
-    /**
-     * Bundled plugin paths.
-     * Absolute paths to plugin directories containing .dexto-plugin or .claude-plugin manifests.
-     * These plugins are automatically discovered alongside user/project plugins.
-     *
-     * Example:
-     * ```typescript
-     * import { PLUGIN_PATH as planToolsPluginPath } from '@dexto/tools-plan';
-     *
-     * bundledPlugins: [planToolsPluginPath]
-     * ```
-     */
-    bundledPlugins?: 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;
-    /** Bundled plugin paths (absolute paths to plugin directories) */
-    bundledPlugins?: 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

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