agent-world 0.11.1 → 0.12.0

package/dist/core/storage/eventStorage/index.js

@@ -0,0 +1,31 @@
+/**
+ * Event Storage Factory
+ *
+ * Exports factory functions and types for creating event storage backends.
+ * Provides a simple API to create the appropriate storage backend based on configuration.
+ *
+ * Supported Backends:
+ * - SQLite: Production-ready persistent storage with transactions and foreign keys
+ * - Memory: Fast in-memory storage for tests and development
+ * - File: File-backed JSONL storage for simple persistence needs
+ *
+ * Usage:
+ * ```typescript
+ * import { createMemoryEventStorage } from './storage/eventStorage';
+ * const storage = createMemoryEventStorage();
+ *
+ * import { createSQLiteEventStorage } from './storage/eventStorage';
+ * const storage = await createSQLiteEventStorage(db);
+ *
+ * import { createFileEventStorage } from './storage/eventStorage';
+ * const storage = createFileEventStorage({ baseDir: './data/events' });
+ * ```
+ */
+// Export factory functions
+export { createSQLiteEventStorage } from './sqliteEventStorage.js';
+export { createMemoryEventStorage } from './memoryEventStorage.js';
+export { createFileEventStorage } from './fileEventStorage.js';
+// Export classes for direct instantiation if needed
+export { MemoryEventStorage } from './memoryEventStorage.js';
+export { FileEventStorage } from './fileEventStorage.js';
+//# sourceMappingURL=index.js.map

package/dist/core/storage/eventStorage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../core/storage/eventStorage/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AASH,2BAA2B;AAC3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,oDAAoD;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/core/storage/eventStorage/memoryEventStorage.d.ts

@@ -0,0 +1,87 @@
+/**
+ * In-Memory Event Storage Implementation
+ *
+ * Map-based event storage for tests and development environments.
+ * Provides fast, in-memory event storage with support for sequence ordering and efficient queries.
+ *
+ * Features:
+ * - Fast Map-based storage organized by worldId and chatId
+ * - Automatic sequence number generation per world/chat
+ * - Support for time-based and sequence-based pagination
+ * - Event type filtering
+ * - Duplicate event ID handling (silently ignores duplicates)
+ * - No external dependencies
+ * - Suitable for unit tests and browser environments
+ *
+ * Implementation:
+ * - Uses nested Maps for hierarchical organization: worldId -> chatId -> events[]
+ * - Maintains sequence counters per world/chat combination
+ * - Deep cloning for data isolation
+ * - Efficient queries with Array methods
+ * - Checks for duplicate IDs before insertion (matches SQLite INSERT OR IGNORE behavior)
+ *
+ * Changes:
+ * - 2025-11-03: Added duplicate event ID detection to prevent constraint violations
+ */
+import type { EventStorage, StoredEvent, GetEventsOptions } from './types.js';
+/**
+ * In-memory event storage implementation
+ */
+export declare class MemoryEventStorage implements EventStorage {
+    private events;
+    private seqCounters;
+    /**
+     * Get the next sequence number for a world/chat context
+     */
+    private getNextSeq;
+    /**
+     * Get or create events array for a world/chat context
+     */
+    private getEventsArray;
+    /**
+     * Save a single event
+     */
+    saveEvent(event: StoredEvent): Promise<void>;
+    /**
+     * Save multiple events in batch
+     */
+    saveEvents(events: StoredEvent[]): Promise<void>;
+    /**
+     * Get events for a specific world and chat with filtering
+     */
+    getEventsByWorldAndChat(worldId: string, chatId: string | null, options?: GetEventsOptions): Promise<StoredEvent[]>;
+    /**
+     * Delete all events for a specific world and chat
+     */
+    deleteEventsByWorldAndChat(worldId: string, chatId: string | null): Promise<number>;
+    /**
+     * Delete all events for a specific world (all chats)
+     */
+    deleteEventsByWorld(worldId: string): Promise<number>;
+    /**
+     * Get the latest sequence number for a world/chat context
+     * Returns 0 if no events exist
+     */
+    getLatestSeq(worldId: string, chatId: string | null): Promise<number>;
+    /**
+     * Get events within a specific sequence range (inclusive)
+     */
+    getEventRange(worldId: string, chatId: string | null, fromSeq: number, toSeq: number): Promise<StoredEvent[]>;
+    /**
+     * Clear all events (useful for testing)
+     */
+    clear(): Promise<void>;
+    /**
+     * Get storage statistics (useful for debugging)
+     */
+    getStats(): {
+        totalContexts: number;
+        totalEvents: number;
+        eventsByContext: Map<string, number>;
+    };
+}
+/**
+ * Create a new in-memory event storage instance
+ */
+export declare function createMemoryEventStorage(): EventStorage;
+//# sourceMappingURL=memoryEventStorage.d.ts.map

package/dist/core/storage/eventStorage/memoryEventStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryEventStorage.d.ts","sourceRoot":"","sources":["../../../../core/storage/eventStorage/memoryEventStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAkC9E;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IAErD,OAAO,CAAC,MAAM,CAAoC;IAGlD,OAAO,CAAC,WAAW,CAA6B;IAEhD;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBlD;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtD;;OAEG;IACG,uBAAuB,CAC3B,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,WAAW,EAAE,CAAC;IA4CzB;;OAEG;IACG,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAezF;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB3D;;;OAGG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC;IAK3E;;OAEG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,EAAE,CAAC;IAuBzB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACH,QAAQ,IAAI;QACV,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACtC;CAgBF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,YAAY,CAEvD"}

package/dist/core/storage/eventStorage/memoryEventStorage.js

@@ -0,0 +1,244 @@
+/**
+ * In-Memory Event Storage Implementation
+ *
+ * Map-based event storage for tests and development environments.
+ * Provides fast, in-memory event storage with support for sequence ordering and efficient queries.
+ *
+ * Features:
+ * - Fast Map-based storage organized by worldId and chatId
+ * - Automatic sequence number generation per world/chat
+ * - Support for time-based and sequence-based pagination
+ * - Event type filtering
+ * - Duplicate event ID handling (silently ignores duplicates)
+ * - No external dependencies
+ * - Suitable for unit tests and browser environments
+ *
+ * Implementation:
+ * - Uses nested Maps for hierarchical organization: worldId -> chatId -> events[]
+ * - Maintains sequence counters per world/chat combination
+ * - Deep cloning for data isolation
+ * - Efficient queries with Array methods
+ * - Checks for duplicate IDs before insertion (matches SQLite INSERT OR IGNORE behavior)
+ *
+ * Changes:
+ * - 2025-11-03: Added duplicate event ID detection to prevent constraint violations
+ */
+/**
+ * Generate a composite key for world/chat combination
+ */
+function getContextKey(worldId, chatId) {
+    return `${worldId}:${chatId ?? 'null'}`;
+}
+/**
+ * Deep clone utility for data isolation
+ */
+function deepClone(obj) {
+    if (obj === null || typeof obj !== 'object') {
+        return obj;
+    }
+    if (obj instanceof Date) {
+        return new Date(obj.getTime());
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(item => deepClone(item));
+    }
+    const clonedObj = {};
+    for (const key in obj) {
+        if (Object.prototype.hasOwnProperty.call(obj, key)) {
+            clonedObj[key] = deepClone(obj[key]);
+        }
+    }
+    return clonedObj;
+}
+/**
+ * In-memory event storage implementation
+ */
+export class MemoryEventStorage {
+    // Map of contextKey -> events array
+    events = new Map();
+    // Map of contextKey -> next sequence number
+    seqCounters = new Map();
+    /**
+     * Get the next sequence number for a world/chat context
+     */
+    getNextSeq(worldId, chatId) {
+        const key = getContextKey(worldId, chatId);
+        const current = this.seqCounters.get(key) || 0;
+        const next = current + 1;
+        this.seqCounters.set(key, next);
+        return next;
+    }
+    /**
+     * Get or create events array for a world/chat context
+     */
+    getEventsArray(worldId, chatId) {
+        const key = getContextKey(worldId, chatId);
+        if (!this.events.has(key)) {
+            this.events.set(key, []);
+        }
+        return this.events.get(key);
+    }
+    /**
+     * Save a single event
+     */
+    async saveEvent(event) {
+        const eventsArray = this.getEventsArray(event.worldId, event.chatId);
+        // Check for duplicate ID - skip if already exists
+        const existingEvent = eventsArray.find(e => e.id === event.id);
+        if (existingEvent) {
+            // Silently ignore duplicate event ID (matches SQLite INSERT OR IGNORE behavior)
+            return;
+        }
+        // Auto-generate sequence number if not provided
+        const seq = event.seq ?? this.getNextSeq(event.worldId, event.chatId);
+        const storedEvent = {
+            ...deepClone(event),
+            seq
+        };
+        eventsArray.push(storedEvent);
+    }
+    /**
+     * Save multiple events in batch
+     */
+    async saveEvents(events) {
+        for (const event of events) {
+            await this.saveEvent(event);
+        }
+    }
+    /**
+     * Get events for a specific world and chat with filtering
+     */
+    async getEventsByWorldAndChat(worldId, chatId, options = {}) {
+        const eventsArray = this.getEventsArray(worldId, chatId);
+        // Start with all events for this context
+        let filtered = eventsArray.slice();
+        // Apply filters
+        if (options.sinceSeq !== undefined) {
+            filtered = filtered.filter(e => (e.seq ?? 0) > options.sinceSeq);
+        }
+        if (options.sinceTime !== undefined) {
+            filtered = filtered.filter(e => e.createdAt > options.sinceTime);
+        }
+        if (options.types && options.types.length > 0) {
+            const typeSet = new Set(options.types);
+            filtered = filtered.filter(e => typeSet.has(e.type));
+        }
+        // Sort by sequence and time
+        filtered.sort((a, b) => {
+            const seqA = a.seq ?? 0;
+            const seqB = b.seq ?? 0;
+            if (seqA !== seqB) {
+                return seqA - seqB;
+            }
+            return a.createdAt.getTime() - b.createdAt.getTime();
+        });
+        // Apply order (reverse if desc)
+        if (options.order === 'desc') {
+            filtered.reverse();
+        }
+        // Apply limit
+        if (options.limit && options.limit > 0) {
+            filtered = filtered.slice(0, options.limit);
+        }
+        // Return deep clones to prevent external mutations
+        return filtered.map(e => deepClone(e));
+    }
+    /**
+     * Delete all events for a specific world and chat
+     */
+    async deleteEventsByWorldAndChat(worldId, chatId) {
+        const key = getContextKey(worldId, chatId);
+        const eventsArray = this.events.get(key);
+        if (!eventsArray) {
+            return 0;
+        }
+        const count = eventsArray.length;
+        this.events.delete(key);
+        this.seqCounters.delete(key);
+        return count;
+    }
+    /**
+     * Delete all events for a specific world (all chats)
+     */
+    async deleteEventsByWorld(worldId) {
+        let totalDeleted = 0;
+        // Find all keys that start with this worldId
+        const keysToDelete = [];
+        for (const key of this.events.keys()) {
+            if (key.startsWith(`${worldId}:`)) {
+                keysToDelete.push(key);
+            }
+        }
+        // Delete events and count
+        for (const key of keysToDelete) {
+            const eventsArray = this.events.get(key);
+            if (eventsArray) {
+                totalDeleted += eventsArray.length;
+            }
+            this.events.delete(key);
+            this.seqCounters.delete(key);
+        }
+        return totalDeleted;
+    }
+    /**
+     * Get the latest sequence number for a world/chat context
+     * Returns 0 if no events exist
+     */
+    async getLatestSeq(worldId, chatId) {
+        const key = getContextKey(worldId, chatId);
+        return this.seqCounters.get(key) || 0;
+    }
+    /**
+     * Get events within a specific sequence range (inclusive)
+     */
+    async getEventRange(worldId, chatId, fromSeq, toSeq) {
+        const eventsArray = this.getEventsArray(worldId, chatId);
+        // Filter by sequence range
+        const filtered = eventsArray.filter(e => {
+            const seq = e.seq ?? 0;
+            return seq >= fromSeq && seq <= toSeq;
+        });
+        // Sort by sequence and time
+        filtered.sort((a, b) => {
+            const seqA = a.seq ?? 0;
+            const seqB = b.seq ?? 0;
+            if (seqA !== seqB) {
+                return seqA - seqB;
+            }
+            return a.createdAt.getTime() - b.createdAt.getTime();
+        });
+        // Return deep clones
+        return filtered.map(e => deepClone(e));
+    }
+    /**
+     * Clear all events (useful for testing)
+     */
+    async clear() {
+        this.events.clear();
+        this.seqCounters.clear();
+    }
+    /**
+     * Get storage statistics (useful for debugging)
+     */
+    getStats() {
+        const eventsByContext = new Map();
+        let totalEvents = 0;
+        for (const [key, eventsArray] of this.events.entries()) {
+            const count = eventsArray.length;
+            eventsByContext.set(key, count);
+            totalEvents += count;
+        }
+        return {
+            totalContexts: this.events.size,
+            totalEvents,
+            eventsByContext
+        };
+    }
+}
+/**
+ * Create a new in-memory event storage instance
+ */
+export function createMemoryEventStorage() {
+    return new MemoryEventStorage();
+}
+//# sourceMappingURL=memoryEventStorage.js.map

package/dist/core/storage/eventStorage/memoryEventStorage.js.map

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

package/dist/core/storage/eventStorage/sqliteEventStorage.d.ts

@@ -0,0 +1,45 @@
+/**
+ * SQLite Event Storage Implementation
+ *
+ * Implements EventStorage interface using SQLite database with the repository's existing DB client pattern.
+ * Uses parameterized SQL queries and transactions for data integrity and performance.
+ *
+ * Features:
+ * - Parameterized SQL queries to prevent SQL injection
+ * - Transaction support for batch operations
+ * - Automatic sequence number generation per world/chat using MAX(seq) + 1
+ * - Cascade delete via foreign keys to worlds/chats tables
+ * - Efficient querying with indexed columns
+ * - JSON storage for payload and metadata
+ * - Duplicate event ID handling with INSERT OR IGNORE
+ *
+ * Cascade Delete Behavior:
+ * - Foreign keys ensure events are deleted when their parent world is deleted
+ * - Foreign keys ensure events are deleted when their parent chat is deleted
+ * - PRAGMA foreign_keys = ON must be enabled (done in sqlite-schema.ts)
+ *
+ * Implementation Notes:
+ * - Uses sqlite3 Database from the existing schema pattern
+ * - Follows the promisify pattern used in sqlite-storage.ts
+ * - Supports both time-based and sequence-based pagination
+ * - Auto-increments sequence number using COALESCE(MAX(seq), 0) + 1
+ * - No separate sequence tracking table needed (removed event_sequences)
+ * - Uses INSERT OR IGNORE to prevent UNIQUE constraint violations from duplicate event IDs
+ *   (can occur due to retries, multiple listeners, or error recovery)
+ *
+ * Changes:
+ * - 2025-11-09: CRITICAL FIX - Let AUTOINCREMENT handle seq, don't set manually (was causing INSERT failures)
+ * - 2025-11-03: Added INSERT OR IGNORE to handle duplicate event IDs gracefully
+ * - 2025-11-06: Removed event_sequences table, use MAX(seq) + 1 for auto-increment
+ */
+import type { Database } from 'sqlite3';
+import type { EventStorage } from './types.js';
+export interface SQLiteEventStorageContext {
+    db: Database;
+    isInitialized: boolean;
+}
+/**
+ * Create SQLite event storage context
+ */
+export declare function createSQLiteEventStorage(db: Database): Promise<EventStorage>;
+//# sourceMappingURL=sqliteEventStorage.d.ts.map

package/dist/core/storage/eventStorage/sqliteEventStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteEventStorage.d.ts","sourceRoot":"","sources":["../../../../core/storage/eventStorage/sqliteEventStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,OAAO,KAAK,EAAE,YAAY,EAAiC,MAAM,YAAY,CAAC;AAG9E,MAAM,WAAW,yBAAyB;IACxC,EAAE,EAAE,QAAQ,CAAC;IACb,aAAa,EAAE,OAAO,CAAC;CACxB;AAsCD;;GAEG;AACH,wBAAsB,wBAAwB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBlF"}