agent-world 0.11.1 → 0.12.0

package/dist/core/storage/legacy-migrations.js

@@ -0,0 +1,295 @@
+/**
+ * Legacy Migration Bridge (v0-7)
+ *
+ * Purpose: Handles migration from TypeScript-based migrations to SQL-based migrations
+ *
+ * Features:
+ * - Detects databases using old migration system (PRAGMA user_version only)
+ * - Applies appropriate schema updates based on current version
+ * - Syncs state to new migration tracking system
+ * - Ensures smooth transition with zero data loss
+ *
+ * Supported Legacy Versions:
+ * - v0: Base schema or unversioned database
+ * - v1-7: Various column additions and features
+ *
+ * After running legacy migrations, database will be at v7 and ready for new SQL migrations (v8+)
+ *
+ * Implementation:
+ * - 2025-11-02: Initial implementation for migration system transition
+ */
+import { promisify } from 'util';
+import { createCategoryLogger } from '../logger.js';
+const logger = createCategoryLogger('storage.migration');
+/**
+ * Check if database is using legacy migration system
+ * Legacy databases have PRAGMA user_version but no schema_migrations table
+ */
+export async function isLegacyDatabase(db) {
+    const get = promisify(db.get.bind(db));
+    try {
+        // Check if schema_migrations table exists
+        const result = await get("SELECT name FROM sqlite_master WHERE type='table' AND name='schema_migrations'");
+        // If schema_migrations exists, it's using the new system
+        if (result) {
+            return false;
+        }
+        // Check if database has any tables (might be fresh database)
+        const tableCheck = await get("SELECT name FROM sqlite_master WHERE type='table' LIMIT 1");
+        // If no tables, it's a fresh database (not legacy)
+        if (!tableCheck) {
+            return false;
+        }
+        // Has tables but no schema_migrations = legacy database
+        return true;
+    }
+    catch (error) {
+        logger.error('Error checking legacy database status', {
+            error: error instanceof Error ? error.message : String(error)
+        });
+        return false;
+    }
+}
+/**
+ * Get current version from PRAGMA user_version
+ */
+export async function getLegacyVersion(db) {
+    const get = promisify(db.get.bind(db));
+    try {
+        const result = await get("PRAGMA user_version");
+        return result.user_version;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Apply legacy migrations to bring database from v0-7 to v7
+ * This replicates the old TypeScript migration logic
+ */
+export async function applyLegacyMigrations(db) {
+    const run = promisify(db.run.bind(db));
+    const get = promisify(db.get.bind(db));
+    const all = promisify(db.all.bind(db));
+    const currentVersion = await getLegacyVersion(db);
+    logger.info('Applying legacy migrations', {
+        fromVersion: currentVersion,
+        toVersion: 7
+    });
+    // Version 0: Initial setup
+    if (currentVersion === 0) {
+        // Check if tables exist (existing unversioned database)
+        const tableCheck = await get("SELECT name FROM sqlite_master WHERE type='table' AND name='agent_memory'");
+        if (tableCheck) {
+            // Existing database - check what columns it has and add missing ones
+            logger.info('Migrating unversioned database', { version: 0 });
+            try {
+                const memoryColumns = await all("PRAGMA table_info(agent_memory)");
+                const hasChatId = memoryColumns?.some((col) => col.name === 'chat_id');
+                if (!hasChatId) {
+                    logger.info('Adding column to agent_memory', { column: 'chat_id' });
+                    await run(`ALTER TABLE agent_memory ADD COLUMN chat_id TEXT`);
+                    await run(`CREATE INDEX IF NOT EXISTS idx_agent_memory_chat_id ON agent_memory(chat_id)`);
+                }
+                const worldColumns = await all("PRAGMA table_info(worlds)");
+                const hasLLMProvider = worldColumns?.some((col) => col.name === 'chat_llm_provider');
+                const hasLLMModel = worldColumns?.some((col) => col.name === 'chat_llm_model');
+                const hasCurrentChatId = worldColumns?.some((col) => col.name === 'current_chat_id');
+                if (!hasLLMProvider) {
+                    logger.info('Adding column to worlds', { column: 'chat_llm_provider' });
+                    await run(`ALTER TABLE worlds ADD COLUMN chat_llm_provider TEXT`);
+                }
+                if (!hasLLMModel) {
+                    logger.info('Adding column to worlds', { column: 'chat_llm_model' });
+                    await run(`ALTER TABLE worlds ADD COLUMN chat_llm_model TEXT`);
+                }
+                if (!hasCurrentChatId) {
+                    logger.info('Adding column to worlds', { column: 'current_chat_id' });
+                    await run(`ALTER TABLE worlds ADD COLUMN current_chat_id TEXT`);
+                }
+                await run(`PRAGMA user_version = 4`);
+            }
+            catch (error) {
+                logger.warn('Legacy migration warning', {
+                    error: error instanceof Error ? error.message : String(error)
+                });
+                await run(`PRAGMA user_version = 4`);
+            }
+        }
+        // If no tables, skip - let the new system handle it
+    }
+    // Version 1 → 2: Add chat_id column
+    const version = await getLegacyVersion(db);
+    if (version === 1) {
+        logger.info('Migrating v1 → v2', { feature: 'chat_id column' });
+        try {
+            await run(`ALTER TABLE agent_memory ADD COLUMN chat_id TEXT`);
+            await run(`CREATE INDEX IF NOT EXISTS idx_agent_memory_chat_id ON agent_memory(chat_id)`);
+            await run(`PRAGMA user_version = 2`);
+        }
+        catch (error) {
+            logger.warn('Column might already exist', { column: 'chat_id' });
+        }
+    }
+    // Version 2 → 3: Add LLM provider/model columns
+    const version2 = await getLegacyVersion(db);
+    if (version2 < 3) {
+        logger.info('Migrating to v3', { feature: 'LLM provider/model columns' });
+        try {
+            const worldColumns = await all("PRAGMA table_info(worlds)");
+            const hasLLMProvider = worldColumns?.some((col) => col.name === 'chat_llm_provider');
+            const hasLLMModel = worldColumns?.some((col) => col.name === 'chat_llm_model');
+            if (!hasLLMProvider) {
+                await run(`ALTER TABLE worlds ADD COLUMN chat_llm_provider TEXT`);
+            }
+            if (!hasLLMModel) {
+                await run(`ALTER TABLE worlds ADD COLUMN chat_llm_model TEXT`);
+            }
+            await run(`PRAGMA user_version = 3`);
+        }
+        catch (error) {
+            logger.warn('Legacy migration warning', { version: 3 });
+            await run(`PRAGMA user_version = 3`);
+        }
+    }
+    // Version 3 → 4: Add current_chat_id column
+    const version3 = await getLegacyVersion(db);
+    if (version3 < 4) {
+        logger.info('Migrating to v4', { feature: 'current_chat_id column' });
+        try {
+            const worldColumns = await all("PRAGMA table_info(worlds)");
+            const hasCurrentChatId = worldColumns?.some((col) => col.name === 'current_chat_id');
+            if (!hasCurrentChatId) {
+                await run(`ALTER TABLE worlds ADD COLUMN current_chat_id TEXT`);
+            }
+            await run(`PRAGMA user_version = 4`);
+        }
+        catch (error) {
+            logger.warn('Legacy migration warning', { version: 4 });
+            await run(`PRAGMA user_version = 4`);
+        }
+    }
+    // Version 4 → 5: Add mcp_config column
+    const version4 = await getLegacyVersion(db);
+    if (version4 < 5) {
+        logger.info('Migrating to v5', { feature: 'mcp_config column' });
+        try {
+            const worldColumns = await all("PRAGMA table_info(worlds)");
+            const hasMcpConfig = worldColumns?.some((col) => col.name === 'mcp_config');
+            if (!hasMcpConfig) {
+                await run(`ALTER TABLE worlds ADD COLUMN mcp_config TEXT`);
+            }
+            await run(`PRAGMA user_version = 5`);
+        }
+        catch (error) {
+            logger.warn('Legacy migration warning', { version: 5 });
+            await run(`PRAGMA user_version = 5`);
+        }
+    }
+    // Version 5 → 6: Add message_id column
+    const version5 = await getLegacyVersion(db);
+    if (version5 < 6) {
+        logger.info('Migrating to v6', { feature: 'message_id column' });
+        try {
+            const memoryColumns = await all("PRAGMA table_info(agent_memory)");
+            const hasMessageId = memoryColumns?.some((col) => col.name === 'message_id');
+            if (!hasMessageId) {
+                await run(`ALTER TABLE agent_memory ADD COLUMN message_id TEXT`);
+                await run(`CREATE INDEX IF NOT EXISTS idx_agent_memory_message_id ON agent_memory(message_id)`);
+            }
+            await run(`PRAGMA user_version = 6`);
+        }
+        catch (error) {
+            logger.warn('Legacy migration warning', { version: 6 });
+            await run(`PRAGMA user_version = 6`);
+        }
+    }
+    // Version 6 → 7: Add reply_to_message_id column
+    const version6 = await getLegacyVersion(db);
+    if (version6 < 7) {
+        logger.info('Migrating to v7', { feature: 'reply_to_message_id column' });
+        try {
+            const memoryColumns = await all("PRAGMA table_info(agent_memory)");
+            const hasReplyToMessageId = memoryColumns?.some((col) => col.name === 'reply_to_message_id');
+            if (!hasReplyToMessageId) {
+                await run(`ALTER TABLE agent_memory ADD COLUMN reply_to_message_id TEXT`);
+                await run(`CREATE INDEX IF NOT EXISTS idx_agent_memory_reply_to_message_id ON agent_memory(reply_to_message_id)`);
+            }
+            await run(`PRAGMA user_version = 7`);
+        }
+        catch (error) {
+            logger.warn('Legacy migration warning', { version: 7 });
+            await run(`PRAGMA user_version = 7`);
+        }
+    }
+    const finalVersion = await getLegacyVersion(db);
+    logger.info('Legacy migrations completed', {
+        fromVersion: currentVersion,
+        toVersion: finalVersion
+    });
+}
+/**
+ * Sync legacy database to new migration tracking system
+ * Creates schema_migrations table and records that v1-7 have been applied
+ */
+export async function syncToNewMigrationSystem(db) {
+    const run = (sql, params) => {
+        return new Promise((resolve, reject) => {
+            db.run(sql, params || [], (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    };
+    logger.info('Syncing legacy database to new migration system');
+    // Create schema_migrations table
+    await run(`
+    CREATE TABLE IF NOT EXISTS schema_migrations (
+      version INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      applied_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
+    )
+  `);
+    // Record that legacy migrations have been applied
+    // These represent the state at v7
+    const legacyMigrations = [
+        { version: 1, name: 'legacy_base_schema' },
+        { version: 2, name: 'legacy_add_chat_id' },
+        { version: 3, name: 'legacy_add_llm_config' },
+        { version: 4, name: 'legacy_add_current_chat_id' },
+        { version: 5, name: 'legacy_add_mcp_config' },
+        { version: 6, name: 'legacy_add_message_id' },
+        { version: 7, name: 'legacy_add_reply_to_message_id' }
+    ];
+    for (const migration of legacyMigrations) {
+        try {
+            await run("INSERT OR IGNORE INTO schema_migrations (version, name) VALUES (?, ?)", [migration.version, migration.name]);
+        }
+        catch (error) {
+            logger.warn('Could not record legacy migration', {
+                version: migration.version,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    logger.info('Legacy database synced to new system');
+}
+/**
+ * Main function to handle legacy migration and sync
+ */
+export async function migrateLegacyDatabase(db) {
+    const isLegacy = await isLegacyDatabase(db);
+    if (!isLegacy) {
+        logger.info('Database is not legacy, skipping legacy migration');
+        return;
+    }
+    logger.info('Detected legacy database, applying migrations');
+    // Apply legacy migrations to bring to v7
+    await applyLegacyMigrations(db);
+    // Sync to new migration tracking system
+    await syncToNewMigrationSystem(db);
+    logger.info('Legacy database migration complete, ready for new SQL migrations');
+}
+//# sourceMappingURL=legacy-migrations.js.map

package/dist/core/storage/legacy-migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-migrations.js","sourceRoot":"","sources":["../../../core/storage/legacy-migrations.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/memory-storage.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Memory Storage Implementation
+ *
+ * Logger Category: storage.memory
+ * Purpose: In-memory storage operations for tests and browser environments
+ *
+ * Enable with: LOG_STORAGE_MEMORY=debug npm run server
+ *
+ * What you'll see:
+ * - World/agent/chat CRUD operations
+ * - Memory operations and queries
+ * - Data validation errors
+ *
+ * In-memory storage backend for unit tests, browser environments, and development.
+ * Provides full StorageAPI compatibility with data persistence during runtime session.
+ *
+ * Features:
+ * - Full StorageAPI implementation using in-memory Maps
+ * - No external dependencies or file system access required
+ * - Suitable for unit tests, browser environments, and development
+ * - Complete chat lifecycle management with parent-child relationships
+ * - Cross-agent memory aggregation for world-level contexts
+ * - Data integrity through cascade deletion
+ * - Runtime property exclusion: eventEmitter, agents, chats, eventStorage are not persisted
+ *
+ * Changes:
+ * - 2026-02-13: Added compare-and-set chat title update helper (`updateChatNameIfCurrent`) for race-safe title commits.
+ * - 2025-11-01: Exclude runtime properties from saveWorld to prevent storing EventEmitter and Map instances
+ * - Batch operations with atomic-like behavior
+ * - Memory archiving and cleanup operations
+ * - Data validation and integrity checks
+ * - Compatible agentId inclusion in getMemory for export functionality
+ *
+ * Implementation:
+ * - Uses nested Maps for hierarchical data organization
+ * - Maintains separate stores for worlds, agents, chats, and archived memory
+ * - Deep cloning for data isolation and immutability
+ * - Proper error handling with meaningful error messages
+ * - ID-based lookups with existence validation
+ * - Ensures getMemory includes agentId for message source identification
+ *
+ * Changes:
+ * - 2025-08-07: Initial implementation for non-Node environments
+ * - 2025-08-09: Added agentId to getMemory response for storage compatibility
+ * - 2025-10-31: Updated to structured logging (storage.memory category)
+ */
+import type { StorageAPI, World, Agent, Chat, UpdateChatParams, WorldChat, AgentMessage } from '../types.js';
+/**
+ * Memory-based storage implementation
+ */
+export declare class MemoryStorage implements StorageAPI {
+    private worlds;
+    private agents;
+    private chats;
+    private worldChats;
+    private archivedMemory;
+    saveWorld(worldData: World): Promise<void>;
+    loadWorld(worldId: string): Promise<World | null>;
+    deleteWorld(worldId: string): Promise<boolean>;
+    listWorlds(): Promise<World[]>;
+    worldExists(worldId: string): Promise<boolean>;
+    getMemory(worldId: string, chatId: string): Promise<AgentMessage[]>;
+    saveAgent(worldId: string, agent: Agent): Promise<void>;
+    loadAgent(worldId: string, agentId: string): Promise<Agent | null>;
+    loadAgentWithRetry(worldId: string, agentId: string, options?: any): Promise<Agent | null>;
+    deleteAgent(worldId: string, agentId: string): Promise<boolean>;
+    listAgents(worldId: string): Promise<Agent[]>;
+    agentExists(worldId: string, agentId: string): Promise<boolean>;
+    saveAgentMemory(worldId: string, agentId: string, memory: AgentMessage[]): Promise<void>;
+    archiveMemory(worldId: string, agentId: string, memory: AgentMessage[]): Promise<void>;
+    deleteMemoryByChatId(worldId: string, chatId: string): Promise<number>;
+    saveAgentsBatch(worldId: string, agents: Agent[]): Promise<void>;
+    loadAgentsBatch(worldId: string, agentIds: string[]): Promise<Agent[]>;
+    saveChatData(worldId: string, chat: Chat): Promise<void>;
+    loadChatData(worldId: string, chatId: string): Promise<Chat | null>;
+    deleteChatData(worldId: string, chatId: string): Promise<boolean>;
+    listChats(worldId: string): Promise<Chat[]>;
+    updateChatData(worldId: string, chatId: string, updates: UpdateChatParams): Promise<Chat | null>;
+    updateChatNameIfCurrent(worldId: string, chatId: string, expectedName: string, nextName: string): Promise<boolean>;
+    saveWorldChat(worldId: string, chatId: string, chat: WorldChat): Promise<void>;
+    loadWorldChat(worldId: string, chatId: string): Promise<WorldChat | null>;
+    loadWorldChatFull(worldId: string, chatId: string): Promise<WorldChat | null>;
+    restoreFromWorldChat(worldId: string, chat: WorldChat): Promise<boolean>;
+    validateIntegrity(worldId: string, agentId?: string): Promise<boolean>;
+    repairData(worldId: string, agentId?: string): Promise<boolean>;
+    /**
+     * Clear all stored data - useful for test cleanup
+     */
+    clear(): Promise<void>;
+    /**
+     * Get storage statistics - useful for debugging
+     */
+    getStats(): {
+        worlds: number;
+        totalAgents: number;
+        totalChats: number;
+        totalWorldChats: number;
+        totalArchivedMemory: number;
+    };
+}
+/**
+ * Create a new memory storage instance
+ */
+export declare function createMemoryStorage(): StorageAPI;
+//# sourceMappingURL=memory-storage.d.ts.map

package/dist/core/storage/memory-storage.d.ts.map

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