@dexto/core 1.1.10 → 1.2.0

package/dist/preferences/loader.d.cts

@@ -1,45 +0,0 @@
-import { LLMProvider } from '../llm/types.cjs';
-import { GlobalPreferences } from './schemas.cjs';
-import 'zod';
-
-/**
- * Load global preferences from ~/.dexto/preferences.yml
- * @returns Global preferences object
- * @throws DextoRuntimeError if file not found or corrupted
- * @throws DextoValidationError if preferences are invalid
- */
-declare function loadGlobalPreferences(): Promise<GlobalPreferences>;
-/**
- * Save global preferences to ~/.dexto/preferences.yml
- * @param preferences Validated preferences object
- * @throws DextoRuntimeError if write fails
- */
-declare function saveGlobalPreferences(preferences: GlobalPreferences): Promise<void>;
-/**
- * Check if global preferences exist (for first-time detection)
- * @returns true if preferences.yml exists
- */
-declare function globalPreferencesExist(): boolean;
-/**
- * Get global preferences file path
- * @returns Absolute path to preferences.yml
- */
-declare function getGlobalPreferencesPath(): string;
-/**
- * Create initial preferences from setup data
- * @param provider Selected LLM provider
- * @param model Selected model
- * @param apiKeyVar Environment variable name for API key
- * @param defaultAgent Optional default agent name
- */
-declare function createInitialPreferences(provider: LLMProvider, model: string, apiKeyVar: string, defaultAgent?: string): GlobalPreferences;
-/**
- * Update specific preference sections
- * @param updates Partial preference updates
- * @returns Updated preferences object
- * @throws DextoRuntimeError if load/save fails
- * @throws DextoValidationError if merged preferences are invalid
- */
-declare function updateGlobalPreferences(updates: Partial<GlobalPreferences>): Promise<GlobalPreferences>;
-
-export { createInitialPreferences, getGlobalPreferencesPath, globalPreferencesExist, loadGlobalPreferences, saveGlobalPreferences, updateGlobalPreferences };

package/dist/preferences/schemas.d.cts

@@ -1,104 +0,0 @@
-import { z } from 'zod';
-
-declare const PreferenceLLMSchema: z.ZodEffects<z.ZodObject<{
-    provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
-    model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-    apiKey: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    apiKey: string;
-    model: string;
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-}, {
-    apiKey: string;
-    model: string;
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-}>, {
-    apiKey: string;
-    model: string;
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-}, {
-    apiKey: string;
-    model: string;
-    provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-}>;
-declare const PreferenceDefaultsSchema: z.ZodObject<{
-    defaultAgent: z.ZodString;
-}, "strict", z.ZodTypeAny, {
-    defaultAgent: string;
-}, {
-    defaultAgent: string;
-}>;
-declare const PreferenceSetupSchema: z.ZodObject<{
-    completed: z.ZodDefault<z.ZodBoolean>;
-}, "strict", z.ZodTypeAny, {
-    completed: boolean;
-}, {
-    completed?: boolean | undefined;
-}>;
-declare const GlobalPreferencesSchema: z.ZodObject<{
-    llm: z.ZodEffects<z.ZodObject<{
-        provider: z.ZodEnum<["openai", "openai-compatible", "anthropic", "google", "groq", "xai", "cohere"]>;
-        model: z.ZodEffects<z.ZodEffects<z.ZodString, string, string>, string, string>;
-        apiKey: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    }, {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    }>, {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    }, {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    }>;
-    defaults: z.ZodObject<{
-        defaultAgent: z.ZodString;
-    }, "strict", z.ZodTypeAny, {
-        defaultAgent: string;
-    }, {
-        defaultAgent: string;
-    }>;
-    setup: z.ZodDefault<z.ZodObject<{
-        completed: z.ZodDefault<z.ZodBoolean>;
-    }, "strict", z.ZodTypeAny, {
-        completed: boolean;
-    }, {
-        completed?: boolean | undefined;
-    }>>;
-}, "strict", z.ZodTypeAny, {
-    llm: {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    };
-    defaults: {
-        defaultAgent: string;
-    };
-    setup: {
-        completed: boolean;
-    };
-}, {
-    llm: {
-        apiKey: string;
-        model: string;
-        provider: "openai" | "openai-compatible" | "anthropic" | "google" | "groq" | "xai" | "cohere";
-    };
-    defaults: {
-        defaultAgent: string;
-    };
-    setup?: {
-        completed?: boolean | undefined;
-    } | undefined;
-}>;
-type PreferenceLLM = z.output<typeof PreferenceLLMSchema>;
-type PreferenceDefaults = z.output<typeof PreferenceDefaultsSchema>;
-type PreferenceSetup = z.output<typeof PreferenceSetupSchema>;
-type GlobalPreferences = z.output<typeof GlobalPreferencesSchema>;
-
-export { type GlobalPreferences, GlobalPreferencesSchema, type PreferenceDefaults, PreferenceDefaultsSchema, type PreferenceLLM, PreferenceLLMSchema, type PreferenceSetup, PreferenceSetupSchema };

package/dist/search/index.d.cts

@@ -1,5 +0,0 @@
-export { SearchService } from './search-service.cjs';
-export { SearchOptions, SearchResponse, SearchResult, SessionSearchResponse, SessionSearchResult } from './types.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';

package/dist/search/search-service.d.cts

@@ -1,47 +0,0 @@
-import { DatabaseBackend } from '../storage/backend/database-backend.cjs';
-import { SearchOptions, SearchResponse, SessionSearchResponse } from './types.cjs';
-import '../context/types.cjs';
-import '../llm/types.cjs';
-
-/**
- * Service for searching through conversation history
- * TODO: remove duplicate stuff related to session manager instead of directly using DB
- */
-declare class SearchService {
-    private database;
-    constructor(database: DatabaseBackend);
-    /**
-     * Search for messages across all sessions or within a specific session
-     */
-    searchMessages(query: string, options?: SearchOptions): Promise<SearchResponse>;
-    /**
-     * Search for sessions that contain the query
-     */
-    searchSessions(query: string): Promise<SessionSearchResponse>;
-    /**
-     * Search for messages within a specific session
-     */
-    private searchInSession;
-    /**
-     * Extract searchable text from a message
-     */
-    private extractSearchableText;
-    /**
-     * Get context around a match for preview
-     */
-    private getContext;
-    /**
-     * Sort search results by relevance
-     */
-    private sortResults;
-    /**
-     * Get all session IDs
-     */
-    private getSessionIds;
-    /**
-     * Get session metadata
-     */
-    private getSessionMetadata;
-}
-
-export { SearchService };

package/dist/search/types.d.cts

@@ -1,78 +0,0 @@
-import { InternalMessage } from '../context/types.cjs';
-import '../llm/types.cjs';
-
-/**
- * Options for searching messages
- */
-interface SearchOptions {
-    /** Limit search to a specific session */
-    sessionId?: string;
-    /** Filter by message role */
-    role?: 'user' | 'assistant' | 'system' | 'tool';
-    /** Maximum number of results to return */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-}
-/**
- * Result of a message search
- */
-interface SearchResult {
-    /** Session ID where the message was found */
-    sessionId: string;
-    /** The message that matched the search */
-    message: InternalMessage;
-    /** The specific text that matched the search query */
-    matchedText: string;
-    /** Context around the match for preview */
-    context: string;
-    /** Index of the message within the session */
-    messageIndex: number;
-}
-/**
- * Result of a session search
- */
-interface SessionSearchResult {
-    /** Session ID */
-    sessionId: string;
-    /** Number of messages that matched in this session */
-    matchCount: number;
-    /** Preview of the first matching message */
-    firstMatch: SearchResult;
-    /** Session metadata */
-    metadata: {
-        createdAt: number;
-        lastActivity: number;
-        messageCount: number;
-    };
-}
-/**
- * Response format for search API
- */
-interface SearchResponse {
-    /** Array of search results */
-    results: SearchResult[];
-    /** Total number of results available */
-    total: number;
-    /** Whether there are more results beyond the current page */
-    hasMore: boolean;
-    /** Query that was searched */
-    query: string;
-    /** Options used for the search */
-    options: SearchOptions;
-}
-/**
- * Response format for session search API
- */
-interface SessionSearchResponse {
-    /** Array of session search results */
-    results: SessionSearchResult[];
-    /** Total number of sessions with matches */
-    total: number;
-    /** Whether there are more results beyond the current page */
-    hasMore: boolean;
-    /** Query that was searched */
-    query: string;
-}
-
-export type { SearchOptions, SearchResponse, SearchResult, SessionSearchResponse, SessionSearchResult };

package/dist/session/chat-session.d.cts

@@ -1,284 +0,0 @@
-import { ContextManager } from '../context/manager.cjs';
-import { InternalMessage } from '../context/types.cjs';
-import { ILLMService } from '../llm/services/types.cjs';
-import { PromptManager } from '../systemPrompt/manager.cjs';
-import { ToolManager } from '../tools/tool-manager.cjs';
-import { ValidatedLLMConfig } from '../llm/schemas.cjs';
-import { AgentStateManager } from '../agent/state-manager.cjs';
-import { StorageBackends } from '../storage/backend/types.cjs';
-import { SessionEventBus, AgentEventBus } from '../events/index.cjs';
-import '../llm/formatters/types.cjs';
-import '../llm/types.cjs';
-import '../llm/tokenizer/types.cjs';
-import '../context/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 './history/types.cjs';
-import 'ai';
-import '../systemPrompt/schemas.cjs';
-import '../tools/internal-tools/registry.cjs';
-import '../search/search-service.cjs';
-import '../storage/backend/database-backend.cjs';
-import '../search/types.cjs';
-import '../tools/schemas.cjs';
-import '../tools/confirmation/types.cjs';
-import '../tools/confirmation/allowed-tools-provider/types.cjs';
-import '../agent/schemas.cjs';
-import '../storage/backend/cache-backend.cjs';
-import '../storage/schemas.cjs';
-import 'events';
-
-/**
- * Represents an isolated conversation session within a Dexto agent.
- *
- * ChatSession provides session-level isolation for conversations, allowing multiple
- * independent chat contexts to exist within a single DextoAgent instance. Each session
- * maintains its own conversation history, message management, and event handling.
- *
- * ## Architecture
- *
- * The ChatSession acts as a lightweight wrapper around core Dexto services, providing
- * session-specific instances of:
- * - **ContextManager**: Handles conversation history and message formatting
- * - **LLMService**: Manages AI model interactions and tool execution
- * - **TypedEventEmitter**: Provides session-scoped event handling
- *
- * ## Event Handling
- *
- * Each session has its own event bus that emits standard Dexto events:
- * - `llmservice:*` events (thinking, toolCall, response, etc.)
- *
- * Session events are forwarded to the global agent event bus with session prefixes.
- *
- * ## Usage Example
- *
- * ```typescript
- * // Create a new session
- * const session = agent.createSession('user-123');
- *
- * // Listen for session events
- * session.eventBus.on('llmservice:response', (payload) => {
- *   console.log('Session response:', payload.content);
- * });
- *
- * // Run a conversation turn
- * const response = await session.run('Hello, how are you?');
- *
- * // Reset session history
- * await session.reset();
- * ```
- *
- * @see {@link SessionManager} for session lifecycle management
- * @see {@link ContextManager} for conversation history management
- * @see {@link ILLMService} for AI model interaction interface
- */
-declare class ChatSession {
-    private services;
-    readonly id: string;
-    /**
-     * Session-scoped event emitter for handling conversation events.
-     *
-     * This is a session-local SessionEventBus instance that forwards events
-     * to the global agent event bus.
-     *
-     * Events emitted include:
-     * - `llmservice:thinking` - AI model is processing
-     * - `llmservice:toolCall` - Tool execution requested
-     * - `llmservice:response` - Final response generated
-     */
-    readonly eventBus: SessionEventBus;
-    /**
-     * History provider that persists conversation messages.
-     * Shared across LLM switches to maintain conversation continuity.
-     */
-    private historyProvider;
-    /**
-     * Handles AI model interactions, tool execution, and response generation for this session.
-     *
-     * Each session has its own LLMService instance that uses the session's
-     * ContextManager and event bus.
-     */
-    private llmService;
-    /**
-     * Map of event forwarder functions for cleanup.
-     * Stores the bound functions so they can be removed from the event bus.
-     */
-    private forwarders;
-    /**
-     * AbortController for the currently running turn, if any.
-     * Calling cancel() aborts the in-flight LLM request and tool execution checks.
-     */
-    private currentRunController;
-    /**
-     * Creates a new ChatSession instance.
-     *
-     * Each session creates its own isolated services:
-     * - ConversationHistoryProvider (with session-specific storage, shared across LLM switches)
-     * - LLMService (creates its own properly-typed ContextManager internally)
-     * - SessionEventBus (session-local event handling with forwarding)
-     *
-     * @param services - The shared services from the agent (state manager, prompt, client managers, etc.)
-     * @param id - Unique identifier for this session
-     */
-    constructor(services: {
-        stateManager: AgentStateManager;
-        promptManager: PromptManager;
-        toolManager: ToolManager;
-        agentEventBus: AgentEventBus;
-        storage: StorageBackends;
-    }, id: string);
-    /**
-     * Initialize the session services asynchronously.
-     * This must be called after construction to set up the storage-backed services.
-     */
-    init(): Promise<void>;
-    /**
-     * Sets up event forwarding from session bus to global agent bus.
-     *
-     * All session events are automatically forwarded to the global bus with the same
-     * event names, but with session context added to the payload. This allows the app
-     * layer to continue listening to standard events while having access to session
-     * information when needed.
-     */
-    private setupEventForwarding;
-    /**
-     * Initializes session-specific services.
-     */
-    private initializeServices;
-    /**
-     * Processes user input through the session's LLM service and returns the response.
-     *
-     * This method:
-     * 1. Takes user input (text, optionally with image or file data)
-     * 2. Passes it to the LLM service for processing
-     * 3. Returns the AI's response text
-     *
-     * The method handles both text-only and multimodal input (text + images/files).
-     * Tool calls and conversation management are handled internally by the LLM service.
-     *
-     * @param input - The user's text input
-     * @param imageDataInput - Optional image data for multimodal input
-     * @param fileDataInput - Optional file data for file input
-     * @param stream - Optional flag to enable streaming responses
-     * @returns Promise that resolves to the AI's response text
-     *
-     * @example
-     * ```typescript
-     * const response = await session.run('What is the weather like today?');
-     * console.log(response); // "I'll check the weather for you..."
-     * ```
-     */
-    run(input: string, imageDataInput?: {
-        image: string;
-        mimeType: string;
-    }, fileDataInput?: {
-        data: string;
-        mimeType: string;
-        filename?: string;
-    }, stream?: boolean): Promise<string>;
-    /**
-     * Retrieves the complete conversation history for this session.
-     *
-     * Returns a read-only copy of all messages in the conversation, including:
-     * - User messages
-     * - Assistant responses
-     * - Tool call results
-     * - System messages
-     *
-     * The history is formatted as internal messages and may include multimodal
-     * content (text and images).
-     *
-     * @returns Promise that resolves to a read-only array of conversation messages in chronological order
-     *
-     * @example
-     * ```typescript
-     * const history = await session.getHistory();
-     * console.log(`Conversation has ${history.length} messages`);
-     * history.forEach(msg => console.log(`${msg.role}: ${msg.content}`));
-     * ```
-     */
-    getHistory(): Promise<InternalMessage[]>;
-    /**
-     * Reset the conversation history for this session.
-     *
-     * This method:
-     * 1. Clears all messages from the session's conversation history
-     * 2. Removes persisted history from the storage provider
-     * 3. Emits a `dexto:conversationReset` event with session context
-     *
-     * The system prompt and session configuration remain unchanged.
-     * Only the conversation messages are cleared.
-     *
-     * @returns Promise that resolves when the reset is complete
-     *
-     * @example
-     * ```typescript
-     * await session.reset();
-     * console.log('Conversation history cleared');
-     * ```
-     *
-     * @see {@link ContextManager.resetConversation} for the underlying implementation
-     */
-    reset(): Promise<void>;
-    /**
-     * Gets the session's ContextManager instance.
-     *
-     * @returns The ContextManager for this session
-     */
-    getContextManager(): ContextManager<unknown>;
-    /**
-     * Gets the session's LLMService instance.
-     *
-     * @returns The LLMService for this session
-     */
-    getLLMService(): ILLMService;
-    /**
-     * Switches the LLM service for this session while preserving conversation history.
-     *
-     * This method creates a new LLM service with the specified configuration and router,
-     * while maintaining the existing ContextManager and conversation history. This allows
-     * users to change AI models mid-conversation without losing context.
-     *
-     * @param newLLMConfig The new LLM configuration to use (includes router)
-     *
-     * @example
-     * ```typescript
-     * // Switch from Claude to GPT-4 while keeping conversation history
-     * session.switchLLM({
-     *   provider: 'openai',
-     *   model: 'gpt-4',
-     *   apiKey: process.env.OPENAI_API_KEY,
-     *   router: 'in-built'
-     * });
-     * ```
-     */
-    switchLLM(newLLMConfig: ValidatedLLMConfig): Promise<void>;
-    /**
-     * Cleanup the session and its in-memory resources.
-     * This method should be called when the session is being removed from memory.
-     * Chat history is preserved in storage and can be restored later.
-     */
-    cleanup(): Promise<void>;
-    /**
-     * Cleans up listeners and other resources to prevent memory leaks.
-     *
-     * This method should be called when the session is being discarded to ensure
-     * that event listeners are properly removed from the global event bus.
-     * Without this cleanup, sessions would remain in memory due to listener references.
-     */
-    dispose(): void;
-    /**
-     * Cancel the currently running turn for this session, if any.
-     * Returns true if a run was in progress and was signaled to abort.
-     */
-    cancel(): boolean;
-}
-
-export { ChatSession };

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

@@ -1,13 +0,0 @@
-/**
- * Session-specific error codes
- * Includes session lifecycle, management, and state errors
- */
-declare enum SessionErrorCode {
-    SESSION_NOT_FOUND = "session_not_found",
-    SESSION_INITIALIZATION_FAILED = "session_initialization_failed",
-    SESSION_MAX_SESSIONS_EXCEEDED = "session_max_sessions_exceeded",
-    SESSION_STORAGE_FAILED = "session_storage_failed",
-    SESSION_RESET_FAILED = "session_reset_failed"
-}
-
-export { SessionErrorCode };

package/dist/session/errors.d.cts

@@ -1,58 +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 '../context/error-codes.cjs';
-import '../llm/error-codes.cjs';
-import '../mcp/error-codes.cjs';
-import './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';
-
-/**
- * Session error factory with typed methods for creating session-specific errors
- * Each method creates a properly typed DextoError with SESSION scope
- */
-declare class SessionError {
-    /**
-     * Session not found
-     */
-    static notFound(sessionId: string): DextoRuntimeError<{
-        sessionId: string;
-    }>;
-    /**
-     * Session initialization failed
-     */
-    static initializationFailed(sessionId: string, reason: string): DextoRuntimeError<{
-        sessionId: string;
-        reason: string;
-    }>;
-    /**
-     * Maximum number of sessions exceeded
-     */
-    static maxSessionsExceeded(currentCount: number, maxSessions: number): DextoRuntimeError<{
-        currentCount: number;
-        maxSessions: number;
-    }>;
-    /**
-     * Session storage failed
-     */
-    static storageFailed(sessionId: string, operation: string, reason: string): DextoRuntimeError<{
-        sessionId: string;
-        operation: string;
-        reason: string;
-    }>;
-    /**
-     * Session reset failed
-     */
-    static resetFailed(sessionId: string, reason: string): DextoRuntimeError<{
-        sessionId: string;
-        reason: string;
-    }>;
-}
-
-export { SessionError };

package/dist/session/history/database.d.cts

@@ -1,28 +0,0 @@
-import { DatabaseBackend } from '../../storage/backend/database-backend.cjs';
-import { InternalMessage } from '../../context/types.cjs';
-import { IConversationHistoryProvider } from './types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * History provider that works directly with DatabaseBackend.
- * Handles message-specific operations and key formatting internally.
- *
- * TODO: Add in-memory caching to reduce database queries.
- * Cache should be invalidated on writes and persist across LLM switches.
- * Consider caching strategy:
- * - Load cache on first getHistory() call
- * - Update cache optimistically on saveMessage()
- * - Clear cache on clearHistory()
- * This will significantly improve performance for sessions with many messages.
- */
-declare class DatabaseHistoryProvider implements IConversationHistoryProvider {
-    private sessionId;
-    private database;
-    constructor(sessionId: string, database: DatabaseBackend);
-    getHistory(): Promise<InternalMessage[]>;
-    saveMessage(message: InternalMessage): Promise<void>;
-    clearHistory(): Promise<void>;
-    private getMessagesKey;
-}
-
-export { DatabaseHistoryProvider };

package/dist/session/history/factory.d.cts

@@ -1,11 +0,0 @@
-import { IConversationHistoryProvider } from './types.cjs';
-import { DatabaseBackend } from '../../storage/backend/database-backend.cjs';
-import '../../context/types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Create a history provider directly with database backend
- */
-declare function createDatabaseHistoryProvider(database: DatabaseBackend, sessionId: string): IConversationHistoryProvider;
-
-export { createDatabaseHistoryProvider };