@dexto/core 1.1.10 → 1.2.0

package/dist/agent/state-manager.d.cts

@@ -1,97 +0,0 @@
-import { ValidatedAgentConfig } from './schemas.cjs';
-import { ValidatedLLMConfig } from '../llm/schemas.cjs';
-import { ValidatedMcpServerConfig } from '../mcp/schemas.cjs';
-import { AgentEventBus } from '../events/index.cjs';
-import 'zod';
-import '../llm/types.cjs';
-import 'events';
-
-/**
- * Session-specific overrides that can differ from the global configuration
- */
-interface SessionOverride {
-    /** Override LLM config for this session - must be a complete validated config */
-    llm?: ValidatedLLMConfig;
-}
-/**
- * Manages the runtime configuration of the agent.
- *
- * This class handles dynamic configuration changes that occur during agent execution.
- *
- * Key responsibilities:
- * 1. Track runtime changes separate from static config baseline
- * 2. Support session-specific overrides for LLM settings
- * 3. Dynamic MCP server management (add/remove servers at runtime)
- * 4. Export modified state back to config format
- * 5. Provide change tracking and validation capabilities
- * 6. Maintain effective configuration for each session
- */
-declare class AgentStateManager {
-    private agentEventBus;
-    private runtimeConfig;
-    private readonly baselineConfig;
-    private sessionOverrides;
-    /**
-     * Initialize AgentStateManager from a validated static configuration.
-     *
-     * @param staticConfig The validated configuration from DextoAgent
-     * @param agentEventBus The agent event bus for emitting state change events
-     */
-    constructor(staticConfig: ValidatedAgentConfig, agentEventBus: AgentEventBus);
-    /**
-     * Get runtime configuration for a session (includes session overrides if sessionId provided)
-     */
-    getRuntimeConfig(sessionId?: string): Readonly<ValidatedAgentConfig>;
-    /**
-     * Update the LLM configuration (globally or for a specific session)
-     *
-     * This method is a pure state updater - it assumes the input has already been validated
-     * by the caller (typically DextoAgent.switchLLM). The ValidatedLLMConfig branded type
-     * ensures validation has occurred.
-     */
-    updateLLM(validatedConfig: ValidatedLLMConfig, sessionId?: string): void;
-    /**
-     * Add or update an MCP server configuration at runtime.
-     *
-     * This method is a pure state updater - it assumes the input has already been validated
-     * by the caller (typically DextoAgent.connectMcpServer). The ValidatedMcpServerConfig
-     * branded type ensures validation has occurred.
-     */
-    addMcpServer(serverName: string, validatedConfig: ValidatedMcpServerConfig): void;
-    /**
-     * Remove an MCP server configuration at runtime.
-     */
-    removeMcpServer(serverName: string): void;
-    /**
-     * Set a session-specific override
-     */
-    private setSessionOverride;
-    /**
-     * Get a session override (internal helper)
-     */
-    private getSessionOverride;
-    /**
-     * Clear session-specific overrides
-     */
-    clearSessionOverride(sessionId: string): void;
-    /**
-     * Clear all session overrides (private helper for resetToBaseline)
-     */
-    private clearAllSessionOverrides;
-    /**
-     * Export current runtime state as config.
-     * This allows users to save their runtime modifications as a new agent config.
-     */
-    exportAsConfig(): ValidatedAgentConfig;
-    /**
-     * Reset runtime state back to baseline configuration
-     */
-    resetToBaseline(): void;
-    /**
-     * Get the current effective LLM configuration for a session.
-     * **Use this for session-specific LLM config** (includes session overrides).
-     */
-    getLLMConfig(sessionId?: string): Readonly<ValidatedLLMConfig>;
-}
-
-export { AgentStateManager, type SessionOverride };

package/dist/config/agent-resolver.d.cts

@@ -1,15 +0,0 @@
-/**
- * Resolve agent path with preference integration
- * @param nameOrPath Optional agent name or explicit path
- * @param autoInstall Whether to automatically install missing agents from registry (default: true)
- * @param injectPreferences Whether to inject preferences during auto-installation (default: true)
- * @returns Resolved absolute path to agent config
- * @throws DextoRuntimeError for any resolution failures
- */
-declare function resolveAgentPath(nameOrPath?: string, autoInstall?: boolean, injectPreferences?: boolean): Promise<string>;
-/**
- * Update default agent preference
- */
-declare function updateDefaultAgentPreference(agentName: string): Promise<void>;
-
-export { resolveAgentPath, updateDefaultAgentPreference };

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

@@ -1,17 +0,0 @@
-/**
- * Config-specific error codes
- * Includes file operations, parsing, and validation errors for configuration management
- */
-declare enum ConfigErrorCode {
-    FILE_NOT_FOUND = "config_file_not_found",
-    FILE_READ_ERROR = "config_file_read_error",
-    FILE_WRITE_ERROR = "config_file_write_error",
-    PARSE_ERROR = "config_parse_error",
-    NO_PROJECT_DEFAULT = "config_no_project_default",
-    NO_GLOBAL_PREFERENCES = "config_no_global_preferences",
-    SETUP_INCOMPLETE = "config_setup_incomplete",
-    BUNDLED_NOT_FOUND = "config_bundled_not_found",
-    UNKNOWN_CONTEXT = "config_unknown_context"
-}
-
-export { ConfigErrorCode };

package/dist/config/errors.d.cts

@@ -1,49 +0,0 @@
-import { DextoRuntimeError } from '../errors/DextoRuntimeError.cjs';
-import '../errors/DextoBaseError.cjs';
-import '../errors/types.cjs';
-import '../agent/error-codes.cjs';
-import './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';
-
-/**
- * Config runtime error factory methods
- * Creates properly typed errors for configuration operations
- */
-declare class ConfigError {
-    static fileNotFound(configPath: string): DextoRuntimeError<{
-        configPath: string;
-    }>;
-    static fileReadError(configPath: string, cause: string): DextoRuntimeError<{
-        configPath: string;
-        cause: string;
-    }>;
-    static fileWriteError(configPath: string, cause: string): DextoRuntimeError<{
-        configPath: string;
-        cause: string;
-    }>;
-    static parseError(configPath: string, cause: string): DextoRuntimeError<{
-        configPath: string;
-        cause: string;
-    }>;
-    static noProjectDefault(projectPath: string): DextoRuntimeError<{
-        projectPath: string;
-    }>;
-    static noGlobalPreferences(): DextoRuntimeError<{}>;
-    static setupIncomplete(): DextoRuntimeError<{}>;
-    static bundledNotFound(bundledPath: string): DextoRuntimeError<{
-        path: string;
-    }>;
-    static unknownContext(context: string): DextoRuntimeError<{
-        context: string;
-    }>;
-}
-
-export { ConfigError };

package/dist/config/index.d.cts

@@ -1,7 +0,0 @@
-export { loadAgentConfig } from './loader.cjs';
-export { LLMOverrides, writeConfigFile, writeLLMPreferences, writePreferencesToAgent } from './writer.cjs';
-export { resolveAgentPath, updateDefaultAgentPreference } from './agent-resolver.cjs';
-import '../agent/schemas.cjs';
-import 'zod';
-import '../llm/types.cjs';
-import '../preferences/schemas.cjs';

package/dist/config/loader.d.cts

@@ -1,19 +0,0 @@
-import { AgentConfig } from '../agent/schemas.cjs';
-import 'zod';
-
-/**
- * Asynchronously loads and processes an agent configuration file.
- * This function handles file reading, YAML parsing, and template variable expansion.
- * Environment variable expansion is handled by the Zod schema during validation.
- *
- * Note: Path resolution should be done before calling this function using resolveConfigPath().
- *
- * @param configPath - Path to the configuration file (absolute or relative)
- * @returns A Promise that resolves to the parsed `AgentConfig` object with template variables expanded
- * @throws {ConfigError} with FILE_NOT_FOUND if the configuration file does not exist
- * @throws {ConfigError} with FILE_READ_ERROR if file read fails (e.g., permissions issues)
- * @throws {ConfigError} with PARSE_ERROR if the content is not valid YAML or template expansion fails
- */
-declare function loadAgentConfig(configPath: string): Promise<AgentConfig>;
-
-export { loadAgentConfig };

package/dist/config/writer.d.cts

@@ -1,38 +0,0 @@
-import { LLMProvider } from '../llm/types.cjs';
-import { GlobalPreferences } from '../preferences/schemas.cjs';
-import { AgentConfig } from '../agent/schemas.cjs';
-import 'zod';
-
-interface LLMOverrides {
-    provider?: LLMProvider;
-    model?: string;
-    apiKey?: string;
-}
-/**
- * Asynchronously writes the given agent configuration object to a YAML file.
- * This function handles the serialization of the config object to YAML format
- * and writes it to the specified file path.
- *
- * @param configPath - Path where the configuration file should be written (absolute or relative)
- * @param config - The `AgentConfig` object to be written to the file
- * @returns A Promise that resolves when the file has been successfully written
- * @throws {ConfigError} with FILE_WRITE_ERROR if an error occurs during YAML stringification or file writing
- */
-declare function writeConfigFile(configPath: string, config: AgentConfig): Promise<void>;
-/**
- * Write global LLM preferences to an agent config file
- * @param configPath Absolute path to agent configuration file
- * @param preferences Global preferences to write
- * @param overrides Optional CLI overrides
- * @throws DextoRuntimeError for write failures
- */
-declare function writeLLMPreferences(configPath: string, preferences: GlobalPreferences, overrides?: LLMOverrides): Promise<void>;
-/**
- * Write preferences to an installed agent (file or directory)
- * @param installedPath Path to installed agent file or directory
- * @param preferences Global preferences to write
- * @param overrides Optional CLI overrides
- */
-declare function writePreferencesToAgent(installedPath: string, preferences: GlobalPreferences, overrides?: LLMOverrides): Promise<void>;
-
-export { type LLMOverrides, writeConfigFile, writeLLMPreferences, writePreferencesToAgent };

package/dist/context/compression/middle-removal.d.cts

@@ -1,48 +0,0 @@
-import { ITokenizer } from '../../llm/tokenizer/types.cjs';
-import { InternalMessage } from '../types.cjs';
-import { ICompressionStrategy } from './types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Configuration options for the MiddleRemovalStrategy.
- */
-interface MiddleRemovalStrategyOptions {
-    /**
-     * The number of messages to preserve at the beginning of the history.
-     * @default 4
-     */
-    preserveStart?: number;
-    /**
-     * The number of messages to preserve at the end of the history.
-     * @default 5
-     */
-    preserveEnd?: number;
-}
-/**
- * Implements a compression strategy that removes messages from the middle of the
- * conversation history, preserving a configurable number of messages at the
- * beginning and end. It prioritizes removing the oldest messages within the
- * removable middle section first.
- */
-declare class MiddleRemovalStrategy implements ICompressionStrategy {
-    private readonly preserveStart;
-    private readonly preserveEnd;
-    /**
-     * Creates an instance of MiddleRemovalStrategy.
-     *
-     * @param options Configuration options for preserving messages.
-     */
-    constructor(options?: MiddleRemovalStrategyOptions);
-    /**
-     * Compresses the history by removing messages from the middle if the total
-     * token count exceeds the specified maximum.
-     *
-     * @param history The current conversation history.
-     * @param tokenizer The tokenizer used to calculate message tokens.
-     * @param maxHistoryTokens The maximum number of tokens allowed *for the history messages*.
-     * @returns The potentially compressed message history.
-     */
-    compress(history: InternalMessage[], tokenizer: ITokenizer, maxHistoryTokens: number): InternalMessage[];
-}
-
-export { MiddleRemovalStrategy, type MiddleRemovalStrategyOptions };

package/dist/context/compression/oldest-removal.d.cts

@@ -1,43 +0,0 @@
-import { ITokenizer } from '../../llm/tokenizer/types.cjs';
-import { InternalMessage } from '../types.cjs';
-import { ICompressionStrategy } from './types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Configuration options for the OldestRemovalStrategy.
- */
-interface OldestRemovalStrategyOptions {
-    /**
-     * The minimum number of messages to preserve at the end of the history.
-     * The strategy will not remove messages if doing so would reduce the
-     * history length below this number.
-     * @default 4
-     */
-    minMessagesToKeep?: number;
-}
-/**
- * Implements a compression strategy that removes the oldest messages (from the
- * beginning of the history array) until the token count is within the limit.
- * Ensures a minimum number of recent messages are always preserved.
- */
-declare class OldestRemovalStrategy implements ICompressionStrategy {
-    private readonly minMessagesToKeep;
-    /**
-     * Creates an instance of OldestRemovalStrategy.
-     *
-     * @param options Configuration options for preserving messages.
-     */
-    constructor(options?: OldestRemovalStrategyOptions);
-    /**
-     * Compresses the history by removing the oldest messages if the total
-     * token count exceeds the specified maximum, while respecting minMessagesToKeep.
-     *
-     * @param history The current conversation history.
-     * @param tokenizer The tokenizer used to calculate message tokens.
-     * @param maxHistoryTokens The maximum number of tokens allowed *for the history messages*.
-     * @returns The potentially compressed message history.
-     */
-    compress(history: InternalMessage[], tokenizer: ITokenizer, maxHistoryTokens: number): InternalMessage[];
-}
-
-export { OldestRemovalStrategy, type OldestRemovalStrategyOptions };

package/dist/context/compression/types.d.cts

@@ -1,21 +0,0 @@
-import { InternalMessage } from '../types.cjs';
-import { ITokenizer } from '../../llm/tokenizer/types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Defines the contract for a strategy used to compress a conversation history
- * to fit within a maximum token limit.
- */
-interface ICompressionStrategy {
-    /**
-     * Compresses the provided message history.
-     *
-     * @param history The current conversation history.
-     * @param tokenizer The tokenizer used to calculate message tokens.
-     * @param maxInputTokens The maximum number of tokens allowed in the history.
-     * @returns The potentially compressed message history.
-     */
-    compress(history: InternalMessage[], tokenizer: ITokenizer, maxInputTokens: number): InternalMessage[];
-}
-
-export type { ICompressionStrategy };

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

@@ -1,19 +0,0 @@
-/**
- * Context-specific error codes
- * Includes initialization, message validation, token processing, and formatting errors
- */
-declare enum ContextErrorCode {
-    MESSAGE_ROLE_MISSING = "context_message_role_missing",
-    MESSAGE_CONTENT_EMPTY = "context_message_content_empty",
-    USER_MESSAGE_CONTENT_INVALID = "context_user_message_content_invalid",
-    ASSISTANT_MESSAGE_CONTENT_OR_TOOLS_REQUIRED = "context_assistant_message_content_or_tools_required",
-    ASSISTANT_MESSAGE_TOOL_CALLS_INVALID = "context_assistant_message_tool_calls_invalid",
-    TOOL_MESSAGE_FIELDS_MISSING = "context_tool_message_fields_missing",
-    TOOL_CALL_ID_NAME_REQUIRED = "context_tool_call_id_name_required",
-    SYSTEM_MESSAGE_CONTENT_INVALID = "context_system_message_content_invalid",
-    TOKEN_COUNT_FAILED = "context_token_count_failed",
-    PRESERVE_VALUES_NEGATIVE = "context_preserve_values_negative",
-    MIN_MESSAGES_NEGATIVE = "context_min_messages_negative"
-}
-
-export { ContextErrorCode };

package/dist/context/errors.d.cts

@@ -1,36 +0,0 @@
-import { DextoRuntimeError } from '../errors/DextoRuntimeError.cjs';
-import '../errors/DextoBaseError.cjs';
-import '../errors/types.cjs';
-import '../agent/error-codes.cjs';
-import '../config/error-codes.cjs';
-import './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';
-
-/**
- * Context runtime error factory methods
- * Creates properly typed errors for context management operations
- */
-declare class ContextError {
-    static messageRoleMissing(): DextoRuntimeError<{}>;
-    static userMessageContentInvalid(): DextoRuntimeError<{}>;
-    static assistantMessageContentOrToolsRequired(): DextoRuntimeError<{}>;
-    static assistantMessageToolCallsInvalid(): DextoRuntimeError<{}>;
-    static toolMessageFieldsMissing(): DextoRuntimeError<{}>;
-    static systemMessageContentInvalid(): DextoRuntimeError<{}>;
-    static userMessageContentEmpty(): DextoRuntimeError<{}>;
-    static toolCallIdNameRequired(): DextoRuntimeError<{}>;
-    static preserveValuesNegative(): DextoRuntimeError<{}>;
-    static tokenCountFailed(cause: string): DextoRuntimeError<{
-        cause: string;
-    }>;
-    static minMessagesNegative(): DextoRuntimeError<{}>;
-}
-
-export { ContextError };

package/dist/context/index.d.cts

@@ -1,19 +0,0 @@
-export { ContextManager } from './manager.cjs';
-export { FileData, FilePart, ImageData, ImagePart, InternalMessage, TextPart } from './types.cjs';
-import '../llm/formatters/types.cjs';
-import '../llm/types.cjs';
-import '../llm/tokenizer/types.cjs';
-import './compression/types.cjs';
-import '../systemPrompt/types.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 '../systemPrompt/manager.cjs';
-import '../systemPrompt/schemas.cjs';
-import '../session/history/types.cjs';
-import '../llm/schemas.cjs';