@dexto/core 1.1.10 → 1.2.0

package/dist/tools/types.d.cts

@@ -1,66 +0,0 @@
-import { JSONSchema7 } from 'json-schema';
-import { ZodSchema } from 'zod';
-
-/**
- * Context passed to tool execution
- */
-interface ToolExecutionContext {
-    /** Session ID if available */
-    sessionId?: string | undefined;
-}
-/**
- * Internal tool interface - for tools implemented within Dexto
- */
-interface InternalTool {
-    /** Unique identifier for the tool */
-    id: string;
-    /** Human-readable description of what the tool does */
-    description: string;
-    /** Zod schema defining the input parameters */
-    inputSchema: ZodSchema;
-    /** The actual function that executes the tool - input is validated by Zod before execution */
-    execute: (input: unknown, context?: ToolExecutionContext) => Promise<unknown> | unknown;
-}
-/**
- * Standard tool set interface - used by AI/LLM services
- * Each tool entry contains JSON Schema parameters
- */
-interface ToolSet {
-    [key: string]: {
-        name?: string;
-        description?: string;
-        parameters: JSONSchema7;
-    };
-}
-/**
- * Tool execution result
- */
-interface ToolResult {
-    success: boolean;
-    data?: any;
-    error?: string;
-    metadata?: {
-        type: string;
-        mimeType?: string;
-    };
-}
-/**
- * Tool call representation
- */
-interface ToolCall {
-    id: string;
-    toolName: string;
-    input: any;
-    output?: any;
-    error?: string;
-    duration?: number;
-}
-/**
- * Interface for any provider of tools
- */
-interface ToolProvider {
-    getTools(): Promise<ToolSet>;
-    callTool(toolName: string, args: Record<string, unknown>): Promise<unknown>;
-}
-
-export type { InternalTool, ToolCall, ToolExecutionContext, ToolProvider, ToolResult, ToolSet };

package/dist/utils/api-key-resolver.d.cts

@@ -1,23 +0,0 @@
-import { LLMProvider } from '../llm/types.cjs';
-
-/**
- * Utility for resolving API keys from environment variables.
- * This consolidates the API key resolution logic used across CLI and core components.
- */
-declare const PROVIDER_API_KEY_MAP: Record<LLMProvider, string[]>;
-/**
- * Resolves API key for a given provider from environment variables.
- *
- * @param provider The LLM provider
- * @returns Resolved API key or undefined if not found
- */
-declare function resolveApiKeyForProvider(provider: LLMProvider): string | undefined;
-/**
- * Gets the primary environment variable name for a provider (for display/error messages).
- *
- * @param provider The LLM provider
- * @returns Primary environment variable name
- */
-declare function getPrimaryApiKeyEnvVar(provider: LLMProvider): string;
-
-export { PROVIDER_API_KEY_MAP, getPrimaryApiKeyEnvVar, resolveApiKeyForProvider };

package/dist/utils/api-key-store.d.cts

@@ -1,26 +0,0 @@
-import { LLMProvider } from '../llm/types.cjs';
-
-/**
- * Save provider API key to the correct .env and make it immediately available in-process.
- * Never returns the key; only metadata for callers to display.
- */
-declare function saveProviderApiKey(provider: LLMProvider, apiKey: string, startPath?: string): Promise<{
-    envVar: string;
-    targetEnvPath: string;
-}>;
-/**
- * Get key presence and primary env var name for a provider.
- */
-declare function getProviderKeyStatus(provider: LLMProvider): {
-    hasApiKey: boolean;
-    envVar: string;
-};
-/**
- * List key presence across all known providers.
- */
-declare function listProviderKeyStatus(): Record<string, {
-    hasApiKey: boolean;
-    envVar: string;
-}>;
-
-export { getProviderKeyStatus, listProviderKeyStatus, saveProviderApiKey };

package/dist/utils/env.d.cts

@@ -1,29 +0,0 @@
-/**
- * Multi-layer environment variable loading with context awareness.
- * Loads environment variables in priority order:
- * 1. Shell environment (highest priority)
- * 2. Project .env (if in dexto project)
- * 3. Global ~/.dexto/.env (fallback)
- *
- * @param startPath Starting directory for project detection
- * @returns Combined environment variables object
- */
-declare function loadEnvironmentVariables(startPath?: string): Promise<Record<string, string>>;
-/**
- * Apply layered environment loading to process.env.
- * This replaces the simple dotenv.config() with multi-layer loading.
- * Should be called at CLI startup before any schema validation.
- *
- * @param startPath Starting directory for project detection
- */
-declare function applyLayeredEnvironmentLoading(startPath?: string): Promise<void>;
-/**
- * Core logic to update an .env file with Dexto environment variables.
- * This is the shared implementation used by both project and interactive env file updates.
- *
- * @param envFilePath - Absolute path to the .env file to update
- * @param updates - Object containing environment variable updates
- */
-declare function updateEnvFile(envFilePath: string, updates: Record<string, string>): Promise<void>;
-
-export { applyLayeredEnvironmentLoading, loadEnvironmentVariables, updateEnvFile };

package/dist/utils/error-conversion.d.cts

@@ -1,13 +0,0 @@
-/**
- * Utility functions for converting various error types to proper Error instances
- * with meaningful messages instead of "[object Object]"
- */
-/**
- * Converts any error value to an Error instance with a meaningful message
- *
- * @param error - The error value to convert (can be Error, object, string, etc.)
- * @returns Error instance with extracted or serialized message
- */
-declare function toError(error: unknown): Error;
-
-export { toError };

package/dist/utils/execution-context.d.cts

@@ -1,21 +0,0 @@
-type ExecutionContext = 'dexto-source' | 'dexto-project' | 'global-cli';
-/**
- * Find dexto source root directory
- * @param startPath Starting directory path
- * @returns Dexto source root directory or null if not found
- */
-declare function findDextoSourceRoot(startPath?: string): string | null;
-/**
- * Find dexto project root directory (projects using dexto as dependency)
- * @param startPath Starting directory path
- * @returns Dexto project root directory or null if not found
- */
-declare function findDextoProjectRoot(startPath?: string): string | null;
-/**
- * Detect current execution context - standardized across codebase
- * @param startPath Starting directory path (defaults to process.cwd())
- * @returns Execution context
- */
-declare function getExecutionContext(startPath?: string): ExecutionContext;
-
-export { type ExecutionContext, findDextoProjectRoot, findDextoSourceRoot, getExecutionContext };

package/dist/utils/fs-walk.d.cts

@@ -1,9 +0,0 @@
-/**
- * Generic directory walker that searches up the directory tree
- * @param startPath Starting directory path
- * @param predicate Function that returns true when the desired condition is found
- * @returns The directory path where the condition was met, or null if not found
- */
-declare function walkUpDirectories(startPath: string, predicate: (dirPath: string) => boolean): string | null;
-
-export { walkUpDirectories };

package/dist/utils/index.d.cts

@@ -1,63 +0,0 @@
-export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript } from './path.cjs';
-export { AgentServices, createAgentServices } from './service-initializer.cjs';
-export { PROVIDER_API_KEY_MAP, getPrimaryApiKeyEnvVar, resolveApiKeyForProvider } from './api-key-resolver.cjs';
-export { getZodTypeFromProperty, jsonSchemaToZodShape } from './zod-schema-converter.cjs';
-export { EnvExpandedString, NonEmptyEnvExpandedString, NonEmptyTrimmed, OptionalURL, RequiredEnvURL, Result, fail, hasErrors, ok, splitIssues, zodToIssues } from './result.cjs';
-export { toError } from './error-conversion.cjs';
-export { getPort } from './port-utils.cjs';
-export { applyLayeredEnvironmentLoading, loadEnvironmentVariables, updateEnvFile } from './env.cjs';
-export { ExecutionContext, findDextoProjectRoot, findDextoSourceRoot, getExecutionContext } from './execution-context.cjs';
-export { walkUpDirectories } from './fs-walk.cjs';
-export { redactSensitiveData } from './redactor.cjs';
-export { getProviderKeyStatus, listProviderKeyStatus, saveProviderApiKey } from './api-key-store.cjs';
-import '../mcp/manager.cjs';
-import '../mcp/schemas.cjs';
-import 'zod';
-import '../mcp/types.cjs';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '../tools/types.cjs';
-import 'json-schema';
-import '@modelcontextprotocol/sdk/types.js';
-import '../tools/tool-manager.cjs';
-import '../tools/internal-tools/registry.cjs';
-import '../search/search-service.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../search/types.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';
-import '../tools/schemas.cjs';
-import '../tools/confirmation/types.cjs';
-import '../tools/confirmation/allowed-tools-provider/types.cjs';
-import '../systemPrompt/manager.cjs';
-import '../systemPrompt/schemas.cjs';
-import '../systemPrompt/types.cjs';
-import '../agent/state-manager.cjs';
-import '../agent/schemas.cjs';
-import '../llm/schemas.cjs';
-import '../events/index.cjs';
-import 'events';
-import '../storage/backend/types.cjs';
-import '../storage/backend/cache-backend.cjs';
-import '../storage/schemas.cjs';
-import '../session/session-manager.cjs';
-import '../session/chat-session.cjs';
-import '../context/manager.cjs';
-import '../llm/formatters/types.cjs';
-import '../llm/tokenizer/types.cjs';
-import '../context/compression/types.cjs';
-import '../session/history/types.cjs';
-import '../llm/services/types.cjs';
-import 'ai';
-import '../storage/storage-manager.cjs';
-import '../errors/types.cjs';
-import '../agent/error-codes.cjs';
-import '../config/error-codes.cjs';
-import '../context/error-codes.cjs';
-import '../llm/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';

package/dist/utils/path.d.cts

@@ -1,54 +0,0 @@
-/**
- * Standard path resolver for logs/db/config/anything in dexto projects
- * @param type Path type (logs, database, config, etc.)
- * @param filename Optional filename to append
- * @param startPath Starting directory for project detection
- * @returns Absolute path to the requested location
- */
-declare function getDextoPath(type: string, filename?: string, startPath?: string): string;
-/**
- * Global path resolver that ALWAYS returns paths in the user's home directory
- * Used for agent registry and other global-only resources that should not be project-relative
- * @param type Path type (agents, cache, etc.)
- * @param filename Optional filename to append
- * @returns Absolute path to the global location (~/.dexto/...)
- */
-declare function getDextoGlobalPath(type: string, filename?: string): string;
-/**
- * Copy entire directory recursively
- * @param src Source directory path
- * @param dest Destination directory path
- */
-declare function copyDirectory(src: string, dest: string): Promise<void>;
-/**
- * Check if string looks like a file path vs registry name
- * @param str String to check
- * @returns True if looks like a path, false if looks like a registry name
- */
-declare function isPath(str: string): boolean;
-/**
- * Find package root (for other utilities)
- * @param startPath Starting directory path
- * @returns Directory containing package.json or null
- */
-declare function findPackageRoot(startPath?: string): string | null;
-/**
- * Resolve bundled script paths for MCP servers
- * @param scriptPath Relative script path
- * @returns Absolute path to bundled script
- */
-declare function resolveBundledScript(scriptPath: string): string;
-/**
- * Ensure ~/.dexto directory exists for global storage
- */
-declare function ensureDextoGlobalDirectory(): Promise<void>;
-/**
- * Get the appropriate .env file path for saving API keys.
- * Uses the same project detection logic as other dexto paths.
- *
- * @param startPath Starting directory for project detection
- * @returns Absolute path to .env file for saving
- */
-declare function getDextoEnvPath(startPath?: string): string;
-
-export { copyDirectory, ensureDextoGlobalDirectory, findPackageRoot, getDextoEnvPath, getDextoGlobalPath, getDextoPath, isPath, resolveBundledScript };

package/dist/utils/port-utils.d.cts

@@ -1,11 +0,0 @@
-/**
- * Parse an environment variable as a port number, with validation.
- * @param envVar - the string value from process.env
- * @param defaultPort - fallback port if envVar is undefined
- * @param varName - the name of the environment variable (used in error messages)
- * @returns a valid port number
- * @throws if envVar is set but not a valid port number
- */
-declare function getPort(envVar: string | undefined, defaultPort: number, varName: string): number;
-
-export { getPort };

package/dist/utils/port-utils.spec.d.cts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/utils/port-utils.spec.d.ts

@@ -1,2 +0,0 @@
-
-export {  }

package/dist/utils/redactor.d.cts

@@ -1,18 +0,0 @@
-/**
- * Utility to redact sensitive information from objects, arrays, and strings.
- * - Redacts by field name (e.g., apiKey, token, password, etc.)
- * - Redacts by value pattern (e.g., OpenAI keys, Bearer tokens, emails)
- * - Handles deeply nested structures and circular references
- * - Recursive and preserves structure
- * - Easy to extend
- */
-/**
- * Redacts sensitive data from an object, array, or string.
- * Handles circular references gracefully.
- * @param input - The data to redact
- * @param seen - Internal set to track circular references
- * @returns The redacted data
- */
-declare function redactSensitiveData(input: unknown, seen?: WeakSet<object>): unknown;
-
-export { redactSensitiveData };

package/dist/utils/result.d.cts

@@ -1,180 +0,0 @@
-import { ZodError, z } from 'zod';
-import { Issue } from '../errors/types.cjs';
-import '../agent/error-codes.cjs';
-import '../config/error-codes.cjs';
-import '../context/error-codes.cjs';
-import '../llm/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';
-
-/** Trim and require non-empty after trim */
-declare const NonEmptyTrimmed: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-declare const OptionalURL: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>, string | undefined, string>>;
-declare const EnvExpandedString: (env?: Record<string, string | undefined>) => z.ZodEffects<z.ZodString, string, string>;
-declare const NonEmptyEnvExpandedString: (env?: Record<string, string | undefined>) => z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-declare const RequiredEnvURL: (env?: Record<string, string | undefined>) => z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-/**
- * A discriminated union result type that can be either successful or failed
- * Provides type safety by ensuring data is only available on success
- * @param T - The type of the data on success
- * @param C - The type of the context for issues
- */
-type Result<T, C = unknown> = {
-    ok: true;
-    data: T;
-    issues: Issue<C>[];
-} | {
-    ok: false;
-    issues: Issue<C>[];
-};
-/**
- * Create a successful result with validated data and optional warnings.
- *
- * **Usage Guidelines:**
- * - Use for operations that completed successfully, even with warnings
- * - Include warnings for non-blocking issues (API key too short, fallback model used, etc.)
- * - DextoAgent methods should prefer this over throwing exceptions
- * - API layer maps this to 2xx status codes
- *
- * @param data - The successfully validated/processed data
- * @param issues - Optional warnings or informational issues (defaults to empty array)
- * @returns A successful Result with ok: true
- *
- * @example
- * ```typescript
- * // Success with no warnings
- * return ok(validatedConfig);
- *
- * // Success with warnings
- * return ok(validatedConfig, [
- *   { code: 'llm_short_api_key', message: 'API key seems short', severity: 'warning', context: {} }
- * ]);
- * ```
- */
-declare const ok: <T, C = unknown>(data: T, issues?: Issue<C>[]) => Result<T, C>;
-/**
- * Create a failed result with blocking errors that prevent operation completion.
- *
- * **Usage Guidelines:**
- * - Use for validation failures, business rule violations, or any error that should stop execution
- * - Do NOT mix with exceptions - choose Result pattern OR throwing, not both
- * - API layer maps this to 4xx status codes (user/validation errors)
- * - Issues should have severity: 'error' for blocking problems
- *
- * @param issues - Array of error issues that caused the failure (must not be empty)
- * @returns A failed Result with ok: false and no data
- *
- * @example
- * ```typescript
- * // Validation failure
- * return fail([
- *   {
- *     code: LLMErrorCode.SWITCH_INPUT_MISSING,
- *     message: 'At least model or provider must be specified',
- *     severity: 'error',
- *     context: {}
- *   }
- * ]);
- *
- * // Multiple validation errors
- * return fail([
- *   { code: 'missing_api_key', message: 'API key required', severity: 'error', context: {} },
- *   { code: 'invalid_model', message: 'Model not supported', severity: 'error', context: {} }
- * ]);
- * ```
- */
-declare const fail: <T = never, C = unknown>(issues: Issue<C>[]) => Result<T, C>;
-/**
- * Check if a list of issues contains any blocking errors (non-warning severity).
- *
- * **Usage Guidelines:**
- * - Use to determine if a Result should be ok: false
- * - Warnings don't count as errors - operations can succeed with warnings
- * - Useful in validation functions to decide success vs failure
- *
- * @param issues - Array of issues to check
- * @returns true if any issue has severity other than 'warning', false otherwise
- *
- * @example
- * ```typescript
- * const issues = [
- *   { severity: 'warning', message: 'API key seems short' },
- *   { severity: 'error', message: 'Model not found' }
- * ];
- *
- * if (hasErrors(issues)) {
- *   return fail(issues); // Contains errors, operation fails
- * } else {
- *   return ok(data, issues); // Only warnings, operation succeeds
- * }
- * ```
- */
-declare function hasErrors<C>(issues: Issue<C>[]): boolean;
-/**
- * Separate issues into errors (blocking) and warnings (non-blocking) for different handling.
- *
- * **Usage Guidelines:**
- * - Use when you need to handle errors and warnings differently
- * - Errors should block operation, warnings should be logged/reported but allow success
- * - Useful in API responses to show both what failed and what succeeded with caveats
- *
- * @param issues - Array of mixed issues to categorize
- * @returns Object with separate arrays for errors and warnings
- *
- * @example
- * ```typescript
- * const { errors, warnings } = splitIssues(allIssues);
- *
- * if (errors.length > 0) {
- *   logger.error('Validation failed:', errors);
- *   return fail(errors);
- * }
- *
- * if (warnings.length > 0) {
- *   logger.warn('Validation succeeded with warnings:', warnings);
- * }
- *
- * return ok(data, warnings);
- * ```
- */
-declare function splitIssues<C>(issues: Issue<C>[]): {
-    errors: Issue<C>[];
-    warnings: Issue<C>[];
-};
-/**
- * Convert Zod validation errors to standardized Issue format for Result pattern.
- *
- * **Usage Guidelines:**
- * - Use in schema validation functions to convert Zod errors to our Issue format
- * - Allows custom error codes via Zod's params.code field in custom refinements
- * - Falls back to SCHEMA_VALIDATION code for standard Zod validation errors
- * - Typically used with severity: 'error' for blocking validation failures
- *
- * @param err - ZodError from failed schema validation
- * @param severity - Issue severity level (defaults to 'error')
- * @returns Array of Issues in our standardized format
- *
- * @example
- * ```typescript
- * // In a validation function
- * const result = MySchema.safeParse(data);
- * if (!result.success) {
- *   const issues = zodToIssues(result.error);
- *   return fail(issues);
- * }
- *
- * // Custom error codes in Zod schema
- * const schema = z.string().refine(val => val.length > 0, {
- *   message: 'Field is required',
- *   params: { code: LLMErrorCode.API_KEY_MISSING }
- * });
- * ```
- */
-declare function zodToIssues<C = unknown>(err: ZodError, severity?: 'error' | 'warning'): Issue<C>[];
-
-export { EnvExpandedString, NonEmptyEnvExpandedString, NonEmptyTrimmed, OptionalURL, RequiredEnvURL, type Result, fail, hasErrors, ok, splitIssues, zodToIssues };

package/dist/utils/safe-stringify.d.cts

@@ -1,7 +0,0 @@
-/**
- * Safe stringify that handles circular references, BigInt, and limits output size
- * Also redacts sensitive data to prevent PII leaks in error messages
- */
-declare function safeStringify(value: unknown, maxLen?: number): string;
-
-export { safeStringify };

package/dist/utils/schema.d.cts

@@ -1,6 +0,0 @@
-/**
- * Convert Zod schema to JSON Schema format for tool parameters
- */
-declare function convertZodSchemaToJsonSchema(zodSchema: any): any;
-
-export { convertZodSchemaToJsonSchema };

package/dist/utils/service-initializer.d.cts

@@ -1,63 +0,0 @@
-import { MCPManager } from '../mcp/manager.cjs';
-import { ToolManager } from '../tools/tool-manager.cjs';
-import { PromptManager } from '../systemPrompt/manager.cjs';
-import { AgentStateManager } from '../agent/state-manager.cjs';
-import { StorageBackends } from '../storage/backend/types.cjs';
-import { AgentEventBus } from '../events/index.cjs';
-import { SessionManager } from '../session/session-manager.cjs';
-import { SearchService } from '../search/search-service.cjs';
-import { StorageManager } from '../storage/storage-manager.cjs';
-import { ValidatedAgentConfig } from '../agent/schemas.cjs';
-import '../mcp/schemas.cjs';
-import 'zod';
-import '../mcp/types.cjs';
-import '@modelcontextprotocol/sdk/client/index.js';
-import '../tools/types.cjs';
-import 'json-schema';
-import '@modelcontextprotocol/sdk/types.js';
-import '../tools/internal-tools/registry.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../search/types.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';
-import '../tools/schemas.cjs';
-import '../tools/confirmation/types.cjs';
-import '../tools/confirmation/allowed-tools-provider/types.cjs';
-import '../systemPrompt/schemas.cjs';
-import '../systemPrompt/types.cjs';
-import '../llm/schemas.cjs';
-import 'events';
-import '../storage/backend/cache-backend.cjs';
-import '../storage/schemas.cjs';
-import '../session/chat-session.cjs';
-import '../context/manager.cjs';
-import '../llm/formatters/types.cjs';
-import '../llm/tokenizer/types.cjs';
-import '../context/compression/types.cjs';
-import '../session/history/types.cjs';
-import '../llm/services/types.cjs';
-import 'ai';
-
-/**
- * Type for the core agent services returned by createAgentServices
- */
-type AgentServices = {
-    mcpManager: MCPManager;
-    toolManager: ToolManager;
-    promptManager: PromptManager;
-    agentEventBus: AgentEventBus;
-    stateManager: AgentStateManager;
-    sessionManager: SessionManager;
-    searchService: SearchService;
-    storage: StorageBackends;
-    storageManager?: StorageManager;
-};
-/**
- * Initializes all agent services from a validated configuration.
- * @param config The validated agent configuration object
- * @param configPath Optional path to the config file (for relative path resolution)
- * @returns All the initialized services required for a Dexto agent
- */
-declare function createAgentServices(config: ValidatedAgentConfig, configPath?: string): Promise<AgentServices>;
-
-export { type AgentServices, createAgentServices };

package/dist/utils/user-info.d.cts

@@ -1,3 +0,0 @@
-declare function getUserId(): string;
-
-export { getUserId };

package/dist/utils/zod-schema-converter.d.cts

@@ -1,13 +0,0 @@
-import { z } from 'zod';
-
-/**
- * Converts a JSON Schema object to a Zod raw shape.
- * This is a simplified converter that handles common MCP tool schemas.
- */
-declare function jsonSchemaToZodShape(jsonSchema: any): z.ZodRawShape;
-/**
- * Helper function to get a Zod type from a property schema
- */
-declare function getZodTypeFromProperty(propSchema: any): z.ZodTypeAny;
-
-export { getZodTypeFromProperty, jsonSchemaToZodShape };