@dexto/core 1.1.10 → 1.2.0

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

@@ -1,17 +0,0 @@
-import { InternalMessage } from '../../context/types.cjs';
-import '../../llm/types.cjs';
-
-/**
- * Session-scoped conversation history provider.
- * Each instance is tied to a specific session and manages only that session's messages.
- */
-interface IConversationHistoryProvider {
-    /** Load the full message history for this session */
-    getHistory(): Promise<InternalMessage[]>;
-    /** Append a message to this session's history */
-    saveMessage(message: InternalMessage): Promise<void>;
-    /** Clear all messages for this session */
-    clearHistory(): Promise<void>;
-}
-
-export type { IConversationHistoryProvider };

package/dist/session/index.d.cts

@@ -1,53 +0,0 @@
-export { ChatSession } from './chat-session.cjs';
-export { SessionManager, SessionMetadata } from './session-manager.cjs';
-export { SessionErrorCode } from './error-codes.cjs';
-export { SessionError } from './errors.cjs';
-import '../context/manager.cjs';
-import '../llm/formatters/types.cjs';
-import '../context/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 '../systemPrompt/manager.cjs';
-import '../systemPrompt/schemas.cjs';
-import './history/types.cjs';
-import '../llm/schemas.cjs';
-import '../llm/services/types.cjs';
-import 'ai';
-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 '../tools/schemas.cjs';
-import '../tools/confirmation/types.cjs';
-import '../tools/confirmation/allowed-tools-provider/types.cjs';
-import '../agent/state-manager.cjs';
-import '../agent/schemas.cjs';
-import '../events/index.cjs';
-import 'events';
-import '../storage/backend/types.cjs';
-import '../storage/backend/cache-backend.cjs';
-import '../storage/schemas.cjs';
-import '../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 '../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/session/schemas.d.cts

@@ -1,16 +0,0 @@
-import { z } from 'zod';
-
-declare const SessionConfigSchema: z.ZodObject<{
-    maxSessions: z.ZodDefault<z.ZodNumber>;
-    sessionTTL: z.ZodDefault<z.ZodNumber>;
-}, "strict", z.ZodTypeAny, {
-    maxSessions: number;
-    sessionTTL: number;
-}, {
-    maxSessions?: number | undefined;
-    sessionTTL?: number | undefined;
-}>;
-type SessionConfig = z.input<typeof SessionConfigSchema>;
-type ValidatedSessionConfig = z.output<typeof SessionConfigSchema>;
-
-export { type SessionConfig, SessionConfigSchema, type ValidatedSessionConfig };

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

@@ -1,219 +0,0 @@
-import { ChatSession } from './chat-session.cjs';
-import { PromptManager } from '../systemPrompt/manager.cjs';
-import { ToolManager } from '../tools/tool-manager.cjs';
-import { AgentEventBus } from '../events/index.cjs';
-import { AgentStateManager } from '../agent/state-manager.cjs';
-import { ValidatedLLMConfig } from '../llm/schemas.cjs';
-import { StorageBackends } from '../storage/backend/types.cjs';
-import '../context/manager.cjs';
-import '../llm/formatters/types.cjs';
-import '../context/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 '../llm/services/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 'events';
-import '../agent/schemas.cjs';
-import '../storage/backend/cache-backend.cjs';
-import '../storage/schemas.cjs';
-
-interface SessionMetadata {
-    createdAt: number;
-    lastActivity: number;
-    messageCount: number;
-}
-interface SessionManagerConfig {
-    maxSessions?: number;
-    sessionTTL?: number;
-}
-interface SessionData {
-    id: string;
-    userId?: string;
-    createdAt: number;
-    lastActivity: number;
-    messageCount: number;
-    metadata?: Record<string, any>;
-}
-/**
- * Manages multiple chat sessions within a Dexto agent.
- *
- * The SessionManager is responsible for:
- * - Creating and managing multiple isolated chat sessions
- * - Enforcing session limits and TTL policies
- * - Cleaning up expired sessions
- * - Providing session lifecycle management
- * - Persisting session data using the simplified storage backends
- */
-declare class SessionManager {
-    private services;
-    private sessions;
-    private readonly maxSessions;
-    private readonly sessionTTL;
-    private initialized;
-    private cleanupInterval?;
-    private initializationPromise;
-    private readonly pendingCreations;
-    constructor(services: {
-        stateManager: AgentStateManager;
-        promptManager: PromptManager;
-        toolManager: ToolManager;
-        agentEventBus: AgentEventBus;
-        storage: StorageBackends;
-    }, config?: SessionManagerConfig);
-    /**
-     * Initialize the SessionManager with persistent storage.
-     * This must be called before using any session operations.
-     */
-    init(): Promise<void>;
-    /**
-     * Restore sessions from persistent storage on startup.
-     * This allows sessions to survive application restarts.
-     */
-    private restoreSessionsFromStorage;
-    /**
-     * Ensures the SessionManager is initialized before operations.
-     */
-    private ensureInitialized;
-    /**
-     * Creates a new chat session or returns an existing one.
-     *
-     * @param sessionId Optional session ID. If not provided, a UUID will be generated.
-     * @returns The created or existing ChatSession
-     * @throws Error if maximum sessions limit is reached
-     */
-    createSession(sessionId?: string): Promise<ChatSession>;
-    /**
-     * Internal method that handles the actual session creation logic.
-     * This method implements atomic session creation to prevent race conditions.
-     */
-    private createSessionInternal;
-    /**
-     * Gets or creates the default session.
-     * This is used for backward compatibility with single-session operations.
-     *
-     * @returns The default ChatSession (creates one if it doesn't exist)
-     */
-    getDefaultSession(): Promise<ChatSession>;
-    /**
-     * Retrieves an existing session by ID.
-     *
-     * @param sessionId The session ID to retrieve
-     * @param restoreFromStorage Whether to restore from storage if not in memory (default: true)
-     * @returns The ChatSession if found, undefined otherwise
-     */
-    getSession(sessionId: string, restoreFromStorage?: boolean): Promise<ChatSession | undefined>;
-    /**
-     * Ends a session by removing it from memory without deleting conversation history.
-     * Used for cleanup, agent shutdown, and session expiry.
-     *
-     * @param sessionId The session ID to end
-     */
-    endSession(sessionId: string): Promise<void>;
-    /**
-     * Deletes a session and its conversation history, removing everything from memory and storage.
-     * Used for user-initiated permanent deletion.
-     *
-     * @param sessionId The session ID to delete
-     */
-    deleteSession(sessionId: string): Promise<void>;
-    /**
-     * Resets the conversation history for a session while keeping the session alive.
-     *
-     * @param sessionId The session ID to reset
-     * @throws Error if session doesn't exist
-     */
-    resetSession(sessionId: string): Promise<void>;
-    /**
-     * Lists all active session IDs.
-     *
-     * @returns Array of active session IDs
-     */
-    listSessions(): Promise<string[]>;
-    /**
-     * Gets metadata for a specific session.
-     *
-     * @param sessionId The session ID
-     * @returns Session metadata if found, undefined otherwise
-     */
-    getSessionMetadata(sessionId: string): Promise<SessionMetadata | undefined>;
-    /**
-     * Get the global session manager configuration.
-     */
-    getConfig(): SessionManagerConfig;
-    /**
-     * Updates the last activity timestamp for a session.
-     */
-    private updateSessionActivity;
-    /**
-     * Increments the message count for a session.
-     */
-    incrementMessageCount(sessionId: string): Promise<void>;
-    /**
-     * Cleans up expired sessions from memory only, preserving chat history in storage.
-     * This allows inactive sessions to be garbage collected while keeping conversations restorable.
-     */
-    private cleanupExpiredSessions;
-    /**
-     * Switch LLM for all sessions.
-     * @param newLLMConfig The new LLM configuration to apply
-     * @returns Result object with success message and any warnings
-     */
-    switchLLMForAllSessions(newLLMConfig: ValidatedLLMConfig): Promise<{
-        message: string;
-        warnings: string[];
-    }>;
-    /**
-     * Switch LLM for a specific session.
-     * @param newLLMConfig The new LLM configuration to apply
-     * @param sessionId The session ID to switch LLM for
-     * @returns Result object with success message and any warnings
-     */
-    switchLLMForSpecificSession(newLLMConfig: ValidatedLLMConfig, sessionId: string): Promise<{
-        message: string;
-        warnings: string[];
-    }>;
-    /**
-     * Switch LLM for the default session.
-     * @param newLLMConfig The new LLM configuration to apply
-     * @returns Result object with success message and any warnings
-     */
-    switchLLMForDefaultSession(newLLMConfig: ValidatedLLMConfig): Promise<{
-        message: string;
-        warnings: string[];
-    }>;
-    /**
-     * Get session statistics for monitoring and debugging.
-     */
-    getSessionStats(): Promise<{
-        totalSessions: number;
-        inMemorySessions: number;
-        maxSessions: number;
-        sessionTTL: number;
-    }>;
-    /**
-     * Cleanup all sessions and resources.
-     * This should be called when shutting down the application.
-     */
-    cleanup(): Promise<void>;
-}
-
-export { type SessionData, SessionManager, type SessionManagerConfig, type SessionMetadata };

package/dist/storage/backend/cache-backend.d.ts

@@ -1,15 +0,0 @@
-/**
- * Fast, ephemeral storage for temporary data and performance optimization.
- * Supports TTL for automatic cleanup of temporary data.
- */
-interface CacheBackend {
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    delete(key: string): Promise<void>;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-}
-
-export type { CacheBackend };

package/dist/storage/backend/database-backend.d.ts

@@ -1,19 +0,0 @@
-/**
- * Persistent, reliable storage for important data with list operations for message history.
- * Data survives restarts and supports enumeration for settings management.
- */
-interface DatabaseBackend {
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix: string): Promise<string[]>;
-    append<T>(key: string, item: T): Promise<void>;
-    /** Get a range of items in chronological order (oldest first, matching insertion order) */
-    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-}
-
-export type { DatabaseBackend };

package/dist/storage/backend/memory-backend.d.cts

@@ -1,34 +0,0 @@
-import { CacheBackend } from './cache-backend.cjs';
-import { DatabaseBackend } from './database-backend.cjs';
-
-/**
- * In-memory storage backend for development and testing.
- * Implements both CacheBackend and DatabaseBackend interfaces.
- * Data is lost when the process restarts.
- */
-declare class MemoryBackend implements CacheBackend, DatabaseBackend {
-    private data;
-    private lists;
-    private ttls;
-    private connected;
-    constructor();
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix: string): Promise<string[]>;
-    append<T>(key: string, item: T): Promise<void>;
-    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
-    private checkConnection;
-    private checkTTL;
-    clear(): Promise<void>;
-    dump(): Promise<{
-        data: Record<string, any>;
-        lists: Record<string, any[]>;
-    }>;
-}
-
-export { MemoryBackend };

package/dist/storage/backend/postgres-backend.d.cts

@@ -1,37 +0,0 @@
-import { PoolClient } from 'pg';
-import { DatabaseBackend } from './database-backend.cjs';
-import { PostgresBackendConfig } from '../schemas.cjs';
-import 'zod';
-
-/**
- * PostgreSQL storage backend for production database operations.
- * Implements the DatabaseBackend interface with connection pooling and JSONB support.
- * EXPERIMENTAL - NOT FULLY TESTED YET
- */
-declare class PostgresBackend implements DatabaseBackend {
-    private config;
-    private pool;
-    private connected;
-    constructor(config: PostgresBackendConfig);
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix: string): Promise<string[]>;
-    append<T>(key: string, item: T): Promise<void>;
-    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
-    private createTables;
-    private checkConnection;
-    transaction<T>(callback: (client: PoolClient) => Promise<T>): Promise<T>;
-    getStats(): Promise<{
-        kvCount: number;
-        listCount: number;
-        totalSize: string;
-    }>;
-    vacuum(): Promise<void>;
-}
-
-export { PostgresBackend };

package/dist/storage/backend/redis-backend.d.cts

@@ -1,36 +0,0 @@
-import { CacheBackend } from './cache-backend.cjs';
-import { RedisBackendConfig } from '../schemas.cjs';
-import 'zod';
-
-/**
- * Redis storage backend for production cache operations.
- * Implements the CacheBackend interface with connection pooling and optimizations.
- * EXPERIMENTAL - NOT FULLY TESTED YET
- */
-declare class RedisBackend implements CacheBackend {
-    private config;
-    private redis;
-    private connected;
-    constructor(config: RedisBackendConfig);
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    delete(key: string): Promise<void>;
-    mget<T>(keys: string[]): Promise<(T | undefined)[]>;
-    mset<T>(entries: [string, T][]): Promise<void>;
-    exists(key: string): Promise<boolean>;
-    expire(key: string, ttlSeconds: number): Promise<void>;
-    increment(key: string, by?: number): Promise<number>;
-    decrement(key: string, by?: number): Promise<number>;
-    append<T>(key: string, item: T): Promise<void>;
-    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
-    list(prefix: string): Promise<string[]>;
-    private checkConnection;
-    flushdb(): Promise<void>;
-    info(): Promise<string>;
-}
-
-export { RedisBackend };

package/dist/storage/backend/sqlite-backend.d.ts

@@ -1,35 +0,0 @@
-import { DatabaseBackend } from './database-backend.js';
-import { SqliteBackendConfig } from '../schemas.js';
-import 'zod';
-
-/**
- * SQLite storage backend for local development and production.
- * Implements the DatabaseBackend interface with proper schema and connection handling.
- */
-declare class SQLiteBackend implements DatabaseBackend {
-    private db;
-    private dbPath;
-    private config;
-    constructor(config: SqliteBackendConfig);
-    private resolveDefaultPath;
-    private initializeTables;
-    connect(): Promise<void>;
-    disconnect(): Promise<void>;
-    isConnected(): boolean;
-    getBackendType(): string;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T): Promise<void>;
-    delete(key: string): Promise<void>;
-    list(prefix: string): Promise<string[]>;
-    append<T>(key: string, item: T): Promise<void>;
-    getRange<T>(key: string, start: number, count: number): Promise<T[]>;
-    private checkConnection;
-    vacuum(): Promise<void>;
-    getStats(): Promise<{
-        kvCount: number;
-        listCount: number;
-        dbSize: number;
-    }>;
-}
-
-export { SQLiteBackend };

package/dist/storage/backend/types.d.cts

@@ -1,14 +0,0 @@
-import { CacheBackend } from './cache-backend.cjs';
-import { DatabaseBackend } from './database-backend.cjs';
-export { BackendConfig, InMemoryBackendConfig, PostgresBackendConfig, RedisBackendConfig, SqliteBackendConfig, StorageConfig, ValidatedStorageConfig } from '../schemas.cjs';
-import 'zod';
-
-/**
- * Collection of storage backends for different use cases
- */
-interface StorageBackends {
-    cache: CacheBackend;
-    database: DatabaseBackend;
-}
-
-export { CacheBackend, DatabaseBackend, type StorageBackends };

package/dist/storage/backend/types.d.ts

@@ -1,14 +0,0 @@
-import { CacheBackend } from './cache-backend.js';
-import { DatabaseBackend } from './database-backend.js';
-export { BackendConfig, InMemoryBackendConfig, PostgresBackendConfig, RedisBackendConfig, SqliteBackendConfig, StorageConfig, ValidatedStorageConfig } from '../schemas.js';
-import 'zod';
-
-/**
- * Collection of storage backends for different use cases
- */
-interface StorageBackends {
-    cache: CacheBackend;
-    database: DatabaseBackend;
-}
-
-export { CacheBackend, DatabaseBackend, type StorageBackends };

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

@@ -1,14 +0,0 @@
-/**
- * Storage-specific error codes
- * Includes database, file system, and persistence errors
- */
-declare enum StorageErrorCode {
-    CONNECTION_FAILED = "storage_connection_failed",
-    CONNECTION_CONFIG_MISSING = "storage_connection_config_missing",
-    READ_FAILED = "storage_read_failed",
-    WRITE_FAILED = "storage_write_failed",
-    DELETE_FAILED = "storage_delete_failed",
-    MIGRATION_FAILED = "storage_migration_failed"
-}
-
-export { StorageErrorCode };

package/dist/storage/errors.d.cts

@@ -1,63 +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 '../session/error-codes.cjs';
-import './error-codes.cjs';
-import '../systemPrompt/error-codes.cjs';
-import '../tools/error-codes.cjs';
-import '../preferences/error-codes.cjs';
-import '../agent/registry/error-codes.cjs';
-
-/**
- * Storage error factory with typed methods for creating storage-specific errors
- * Each method creates a properly typed DextoRuntimeError with STORAGE scope
- */
-declare class StorageError {
-    /**
-     * Connection failed error
-     */
-    static connectionFailed(reason: string, config?: Record<string, unknown>): DextoRuntimeError<{
-        reason: string;
-        config: Record<string, unknown> | undefined;
-    }>;
-    /**
-     * Backend not connected error
-     */
-    static notConnected(backendType: string): DextoRuntimeError<{
-        backendType: string;
-    }>;
-    /**
-     * Read operation failed
-     */
-    static readFailed(operation: string, reason: string, details?: Record<string, unknown>): DextoRuntimeError<{
-        operation: string;
-        reason: string;
-    }>;
-    /**
-     * Write operation failed
-     */
-    static writeFailed(operation: string, reason: string, details?: Record<string, unknown>): DextoRuntimeError<{
-        operation: string;
-        reason: string;
-    }>;
-    /**
-     * Delete operation failed
-     */
-    static deleteFailed(operation: string, reason: string, details?: Record<string, unknown>): DextoRuntimeError<{
-        operation: string;
-        reason: string;
-    }>;
-    /**
-     * Migration failed error
-     */
-    static migrationFailed(reason: string, details?: Record<string, unknown>): DextoRuntimeError<{
-        reason: string;
-    }>;
-}
-
-export { StorageError };

package/dist/storage/index.d.cts

@@ -1,7 +0,0 @@
-export { StorageManager, createStorageBackends } from './storage-manager.cjs';
-export { StorageBackends } from './backend/types.cjs';
-export { MemoryBackend } from './backend/memory-backend.cjs';
-export { CacheBackend } from './backend/cache-backend.cjs';
-export { DatabaseBackend } from './backend/database-backend.cjs';
-export { BackendConfig, StorageConfig, ValidatedStorageConfig } from './schemas.cjs';
-import 'zod';