agent-world 0.11.1 → 0.12.0

package/dist/core/logger.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Logger Module - High-Performance Cross-Platform Logging with Pino
+ *
+ * Features:
+ * - High-performance structured logging powered by Pino
+ * - Pretty-printing in development with pino-pretty
+ * - JSON structured output in production for log aggregation
+ * - Hierarchical category-specific loggers with independent levels
+ * - Auto-initialization with environment variables on module load
+ * - Configuration-driven setup with level filtering
+ * - Environment variable support for per-category log levels (e.g., LOG_CORE_DB=debug)
+ * - Backward compatible API with previous console-based logger
+ *
+ * Categories: Dot-separated hierarchies (e.g., "core.db", "api.handler.users")
+ * Usage: Auto-initialized on import → createCategoryLogger(category, bindings?)
+ *
+ * Environment Variable Support:
+ *   - Set per-category log level with LOG_{CATEGORY} (e.g., LOG_CORE_DB=debug)
+ *   - Category name normalization: dots preserved for hierarchy, other non-alphanumeric characters become dots
+ *   - Hierarchical resolution: most-specific match wins (e.g., LOG_CORE_DB > LOG_CORE > LOG_LEVEL)
+ *   - Any LOG_{CATEGORY} variable is supported dynamically (no fixed list)
+ *   - These override global LOG_LEVEL and config.categoryLevels
+ *   - LOG_LEVEL sets the global default if no category override is present
+ *
+ * Auto-Initialization:
+ *   - Logger automatically scans environment variables when module is imported
+ *   - No manual initialization required for basic usage
+ *   - initializeLogger() can still be used to override settings
+ *
+ * Implementation: Pino-based structured logging with performance optimizations
+ * - Development: Pretty-printed colored output via pino-pretty
+ * - Production: JSON structured logs for log aggregation systems
+ */
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error';
+export interface Logger {
+    trace: (msg: any, ...args: any[]) => void;
+    debug: (msg: any, ...args: any[]) => void;
+    info: (msg: any, ...args: any[]) => void;
+    warn: (msg: any, ...args: any[]) => void;
+    error: (msg: any, ...args: any[]) => void;
+    child: (bindings: Record<string, any>) => Logger;
+    level: LogLevel;
+}
+export declare function addLogStreamCallback(callback: (logEvent: import('./subscription.js').LogStreamEvent) => void): () => void;
+export interface LoggerConfig {
+    globalLevel?: LogLevel;
+    categoryLevels?: Record<string, LogLevel>;
+}
+export declare function initializeLogger(config?: LoggerConfig): void;
+export declare function createCategoryLogger(category: string, bindings?: Record<string, any>): Logger;
+export declare function getCategoryLogLevel(category: string): LogLevel;
+export declare function shouldLogForCategory(messageLevel: LogLevel, category: string): boolean;
+export declare const logger: Logger;
+export declare const loggers: {
+    storage: Logger;
+    'storage.migration': Logger;
+    'storage.query': Logger;
+    'storage.memory': Logger;
+    'storage.init': Logger;
+    mcp: Logger;
+    'mcp.lifecycle': Logger;
+    'mcp.connection': Logger;
+    'mcp.tools': Logger;
+    'mcp.execution': Logger;
+    llm: Logger;
+    'llm.openai': Logger;
+    'llm.anthropic': Logger;
+    'llm.google': Logger;
+    chat: Logger;
+    'chat.session': Logger;
+    world: Logger;
+    'world.lifecycle': Logger;
+    'world.subscription': Logger;
+    'world.activity': Logger;
+    agent: Logger;
+    'agent.lifecycle': Logger;
+    events: Logger;
+    'events.publish': Logger;
+    'events.agent': Logger;
+    'events.response': Logger;
+    'events.memory': Logger;
+    api: Logger;
+    server: Logger;
+    cli: Logger;
+    ws: Logger;
+};
+export default logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../core/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAOH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAwErE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1C,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzC,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,MAAM,CAAC;IACjD,KAAK,EAAE,QAAQ,CAAC;CACjB;AA2HD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,OAAO,mBAAmB,EAAE,cAAc,KAAK,IAAI,GAAG,MAAM,IAAI,CAGzH;AAiCD,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;CAC3C;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,GAAE,YAAiB,GAAG,IAAI,CA4ChE;AAGD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAkB7F;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAE9D;AAED,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtF;AAGD,eAAO,MAAM,MAAM,QAAuB,CAAC;AAG3C,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6CnB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/core/logger.js

@@ -0,0 +1,358 @@
+/**
+ * Logger Module - High-Performance Cross-Platform Logging with Pino
+ *
+ * Features:
+ * - High-performance structured logging powered by Pino
+ * - Pretty-printing in development with pino-pretty
+ * - JSON structured output in production for log aggregation
+ * - Hierarchical category-specific loggers with independent levels
+ * - Auto-initialization with environment variables on module load
+ * - Configuration-driven setup with level filtering
+ * - Environment variable support for per-category log levels (e.g., LOG_CORE_DB=debug)
+ * - Backward compatible API with previous console-based logger
+ *
+ * Categories: Dot-separated hierarchies (e.g., "core.db", "api.handler.users")
+ * Usage: Auto-initialized on import → createCategoryLogger(category, bindings?)
+ *
+ * Environment Variable Support:
+ *   - Set per-category log level with LOG_{CATEGORY} (e.g., LOG_CORE_DB=debug)
+ *   - Category name normalization: dots preserved for hierarchy, other non-alphanumeric characters become dots
+ *   - Hierarchical resolution: most-specific match wins (e.g., LOG_CORE_DB > LOG_CORE > LOG_LEVEL)
+ *   - Any LOG_{CATEGORY} variable is supported dynamically (no fixed list)
+ *   - These override global LOG_LEVEL and config.categoryLevels
+ *   - LOG_LEVEL sets the global default if no category override is present
+ *
+ * Auto-Initialization:
+ *   - Logger automatically scans environment variables when module is imported
+ *   - No manual initialization required for basic usage
+ *   - initializeLogger() can still be used to override settings
+ *
+ * Implementation: Pino-based structured logging with performance optimizations
+ * - Development: Pretty-printed colored output via pino-pretty
+ * - Production: JSON structured logs for log aggregation systems
+ */
+// Load environment variables from .env file
+import dotenv from 'dotenv';
+import pino from 'pino';
+dotenv.config({ quiet: true });
+const LOG_LEVELS = {
+    trace: 10, debug: 20, info: 30, warn: 40, error: 50
+};
+function shouldLog(messageLevel, currentLevel) {
+    return LOG_LEVELS[messageLevel] >= LOG_LEVELS[currentLevel];
+}
+// Normalize category keys for consistent lookup across environment variables and function calls
+// Preserves dots for hierarchy, converts other non-alphanumeric characters to dots
+function normalizeCategoryKey(raw) {
+    if (!raw)
+        return '';
+    if (raw === 'default')
+        return 'default';
+    return raw
+        .toLowerCase()
+        .replace(/[^a-z0-9.]+/g, '.') // Replace any non-alphanumeric (except dots) with dots
+        .replace(/\.+/g, '.') // Collapse multiple dots into single dot
+        .replace(/^\.|\.$/g, ''); // Trim leading/trailing dots
+}
+// Pino logger configuration
+const pinoOptions = {
+    level: 'trace', // Set to trace to let our wrapper handle filtering
+    formatters: {
+        level: (label) => {
+            return { level: label.toUpperCase() };
+        },
+    },
+    timestamp: pino.stdTimeFunctions.isoTime,
+    ...(typeof process !== 'undefined' && process.env.NODE_ENV !== 'production' ? {
+        transport: {
+            target: 'pino-pretty',
+            options: {
+                colorize: true,
+                ignore: 'pid,hostname',
+                translateTime: 'SYS:standard',
+            },
+        },
+    } : {}),
+};
+const pinoLogger = pino(pinoOptions);
+// Get effective log level for a category using hierarchical resolution
+// Walks from most-specific to least-specific, checking environment variables
+// e.g., for "core.db.connection": LOG_CORE_DB_CONNECTION > LOG_CORE_DB > LOG_CORE > LOG_LEVEL
+function getEffectiveLevelForCategory(category) {
+    const normalizedCategory = normalizeCategoryKey(category);
+    if (!normalizedCategory)
+        return globalLevel;
+    // Check for exact match first
+    if (categoryLevels[normalizedCategory]) {
+        return categoryLevels[normalizedCategory];
+    }
+    // Walk hierarchy from most-specific to least-specific
+    const parts = normalizedCategory.split('.');
+    for (let i = parts.length - 1; i > 0; i--) {
+        const parentCategory = parts.slice(0, i).join('.');
+        if (categoryLevels[parentCategory]) {
+            return categoryLevels[parentCategory];
+        }
+    }
+    // Fall back to global level
+    return globalLevel;
+}
+// Pino-based logger implementation with log streaming support
+function createSimpleLogger(category, level = 'error', bindings) {
+    const childBindings = { ...(category ? { category: category.toUpperCase() } : {}), ...bindings };
+    const childLogger = Object.keys(childBindings).length > 0 ? pinoLogger.child(childBindings) : pinoLogger;
+    return {
+        trace: (msg, ...args) => {
+            if (shouldLog('trace', level)) {
+                if (args.length > 0) {
+                    childLogger.trace({ args }, msg);
+                }
+                else {
+                    childLogger.trace(msg);
+                }
+                // Emit log event for streaming
+                if (category) {
+                    emitLogEvent('trace', category, msg, args.length > 0 ? args[0] : undefined);
+                }
+            }
+        },
+        debug: (msg, ...args) => {
+            if (shouldLog('debug', level)) {
+                if (args.length > 0) {
+                    childLogger.debug({ args }, msg);
+                }
+                else {
+                    childLogger.debug(msg);
+                }
+                // Emit log event for streaming
+                if (category) {
+                    emitLogEvent('debug', category, msg, args.length > 0 ? args[0] : undefined);
+                }
+            }
+        },
+        info: (msg, ...args) => {
+            if (shouldLog('info', level)) {
+                if (args.length > 0) {
+                    childLogger.info({ args }, msg);
+                }
+                else {
+                    childLogger.info(msg);
+                }
+                // Emit log event for streaming
+                if (category) {
+                    emitLogEvent('info', category, msg, args.length > 0 ? args[0] : undefined);
+                }
+            }
+        },
+        warn: (msg, ...args) => {
+            if (shouldLog('warn', level)) {
+                if (args.length > 0) {
+                    childLogger.warn({ args }, msg);
+                }
+                else {
+                    childLogger.warn(msg);
+                }
+                // Emit log event for streaming
+                if (category) {
+                    emitLogEvent('warn', category, msg, args.length > 0 ? args[0] : undefined);
+                }
+            }
+        },
+        error: (msg, ...args) => {
+            if (shouldLog('error', level)) {
+                if (args.length > 0) {
+                    childLogger.error({ args }, msg);
+                }
+                else {
+                    childLogger.error(msg);
+                }
+                // Emit log event for streaming
+                if (category) {
+                    emitLogEvent('error', category, msg, args.length > 0 ? args[0] : undefined);
+                }
+            }
+        },
+        child: (childBindings) => {
+            // Create a new logger with merged bindings
+            return createSimpleLogger(category, level, { ...bindings, ...childBindings });
+        },
+        level
+    };
+}
+// Global state
+let globalLevel = 'error';
+const categoryLevels = {};
+const categoryLoggers = {};
+// Auto-initialize logger with environment variables when module loads
+function autoInitializeLogger() {
+    // Set global level from environment
+    const envGlobalLevel = (typeof process !== 'undefined' && process.env && process.env.LOG_LEVEL) ? process.env.LOG_LEVEL.toLowerCase() : undefined;
+    globalLevel = (envGlobalLevel && LOG_LEVELS[envGlobalLevel]) ? envGlobalLevel : 'error';
+    // Dynamically scan environment for LOG_{CATEGORY} variables
+    // Convert underscores to dots for hierarchy (e.g., LOG_CORE_DB -> core.db)
+    if (typeof process !== 'undefined' && process.env) {
+        const env = process.env;
+        Object.keys(env).forEach(key => {
+            if (key.startsWith('LOG_') && key !== 'LOG_LEVEL') {
+                // Convert LOG_CORE_DB to core.db (underscores to dots for hierarchy)
+                const categoryRaw = key.slice(4).toLowerCase().replace(/_/g, '.');
+                const cat = normalizeCategoryKey(categoryRaw);
+                const val = env[key];
+                if (val && LOG_LEVELS[val.toLowerCase()]) {
+                    categoryLevels[cat] = val.toLowerCase();
+                }
+            }
+        });
+    }
+}
+// Auto-initialize when module loads
+autoInitializeLogger();
+// Add startup diagnostic logging (only when not in production)
+if (typeof process !== 'undefined' && process.env.NODE_ENV !== 'production') {
+    if (Object.keys(categoryLevels).length > 0) {
+        console.info(`[LOGGER] Category levels:`, Object.keys(categoryLevels).sort());
+    }
+}
+// Log streaming callback management
+const logStreamCallbacks = new Set();
+export function addLogStreamCallback(callback) {
+    logStreamCallbacks.add(callback);
+    return () => logStreamCallbacks.delete(callback);
+}
+// Check if a log event should be streamed based on configuration
+function shouldStreamLogEvent(level, category) {
+    // Always stream all logs when there are callbacks - no configuration checks
+    return logStreamCallbacks.size > 0;
+}
+// Emit log event to all registered callbacks
+function emitLogEvent(level, category, message, data) {
+    if (!shouldStreamLogEvent(level, category)) {
+        return;
+    }
+    const logEvent = {
+        level,
+        category,
+        message: typeof message === 'string' ? message : JSON.stringify(message),
+        timestamp: new Date().toISOString(),
+        data,
+        messageId: `log-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`
+    };
+    logStreamCallbacks.forEach(callback => {
+        try {
+            callback(logEvent);
+        }
+        catch (error) {
+            // Prevent log streaming errors from breaking the logger
+            console.error('Log streaming callback error:', error);
+        }
+    });
+}
+// Simple synchronous logger initialization
+export function initializeLogger(config = {}) {
+    // Override global level if provided in config
+    if (config.globalLevel) {
+        globalLevel = config.globalLevel;
+    }
+    // Override category levels if provided in config
+    if (config.categoryLevels) {
+        Object.assign(categoryLevels, config.categoryLevels);
+    }
+    // Re-scan environment variables to ensure they take precedence
+    // Convert underscores to dots for hierarchy (e.g., LOG_CORE_DB -> core.db)
+    if (typeof process !== 'undefined' && process.env) {
+        const env = process.env;
+        Object.keys(env).forEach(key => {
+            if (key.startsWith('LOG_') && key !== 'LOG_LEVEL') {
+                // Convert LOG_CORE_DB to core.db (underscores to dots for hierarchy)
+                const categoryRaw = key.slice(4).toLowerCase().replace(/_/g, '.');
+                const cat = normalizeCategoryKey(categoryRaw);
+                const val = env[key];
+                if (val && LOG_LEVELS[val.toLowerCase()]) {
+                    categoryLevels[cat] = val.toLowerCase();
+                }
+            }
+        });
+    }
+    // Migrate existing categoryLoggers to normalized keys
+    const existingLoggers = { ...categoryLoggers };
+    Object.keys(existingLoggers).forEach(oldKey => {
+        const normalizedKey = normalizeCategoryKey(oldKey);
+        if (normalizedKey !== oldKey && !categoryLoggers[normalizedKey]) {
+            // Move logger to normalized key
+            categoryLoggers[normalizedKey] = existingLoggers[oldKey];
+            delete categoryLoggers[oldKey];
+        }
+    });
+    // Update existing category loggers
+    Object.keys(categoryLoggers).forEach(category => {
+        const level = getEffectiveLevelForCategory(category);
+        categoryLoggers[category] = createSimpleLogger(category, level);
+    });
+}
+// Category logger management
+export function createCategoryLogger(category, bindings) {
+    const normalizedCategory = normalizeCategoryKey(category);
+    // Check if we already have a cached logger for this exact category (without additional bindings)
+    if (!bindings && categoryLoggers[normalizedCategory]) {
+        return categoryLoggers[normalizedCategory];
+    }
+    // Use hierarchical resolution to get the effective level
+    const level = getEffectiveLevelForCategory(normalizedCategory);
+    const logger = createSimpleLogger(normalizedCategory, level, bindings);
+    // Only cache loggers without additional bindings
+    if (!bindings) {
+        categoryLoggers[normalizedCategory] = logger;
+    }
+    return logger;
+}
+export function getCategoryLogLevel(category) {
+    return getEffectiveLevelForCategory(category);
+}
+export function shouldLogForCategory(messageLevel, category) {
+    return shouldLog(messageLevel, getCategoryLogLevel(category));
+}
+// Default logger instance
+export const logger = createSimpleLogger();
+// Pre-created category loggers for common use cases - scenario-based naming
+export const loggers = {
+    // Storage operations
+    storage: createCategoryLogger('storage'),
+    'storage.migration': createCategoryLogger('storage.migration'),
+    'storage.query': createCategoryLogger('storage.query'),
+    'storage.memory': createCategoryLogger('storage.memory'),
+    'storage.init': createCategoryLogger('storage.init'),
+    // MCP operations
+    mcp: createCategoryLogger('mcp'),
+    'mcp.lifecycle': createCategoryLogger('mcp.lifecycle'),
+    'mcp.connection': createCategoryLogger('mcp.connection'),
+    'mcp.tools': createCategoryLogger('mcp.tools'),
+    'mcp.execution': createCategoryLogger('mcp.execution'),
+    // LLM operations
+    llm: createCategoryLogger('llm'),
+    'llm.openai': createCategoryLogger('llm.openai'),
+    'llm.anthropic': createCategoryLogger('llm.anthropic'),
+    'llm.google': createCategoryLogger('llm.google'),
+    // Chat operations
+    chat: createCategoryLogger('chat'),
+    'chat.session': createCategoryLogger('chat.session'),
+    // World/Agent operations
+    world: createCategoryLogger('world'),
+    'world.lifecycle': createCategoryLogger('world.lifecycle'),
+    'world.subscription': createCategoryLogger('world.subscription'),
+    'world.activity': createCategoryLogger('world.activity'),
+    agent: createCategoryLogger('agent'),
+    'agent.lifecycle': createCategoryLogger('agent.lifecycle'),
+    // Event operations
+    events: createCategoryLogger('events'),
+    'events.publish': createCategoryLogger('events.publish'),
+    'events.agent': createCategoryLogger('events.agent'),
+    'events.response': createCategoryLogger('events.response'),
+    'events.memory': createCategoryLogger('events.memory'),
+    // Infrastructure
+    api: createCategoryLogger('api'),
+    server: createCategoryLogger('server'),
+    cli: createCategoryLogger('cli'),
+    ws: createCategoryLogger('ws'),
+};
+export default logger;
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

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

package/dist/core/managers.d.ts

@@ -0,0 +1,131 @@
+import type { World, CreateWorldParams, UpdateWorldParams, Agent, CreateAgentParams, UpdateAgentParams, AgentMessage, Chat, UpdateChatParams, RemovalResult, EditErrorLog } from './types.js';
+/**
+ * Create new world with configuration and automatically create a new chat
+ */
+export declare function createWorld(params: CreateWorldParams): Promise<World | null>;
+/**
+ * Update world configuration
+ */
+export declare function updateWorld(worldId: string, updates: UpdateWorldParams): Promise<World | null>;
+/**
+ * Set the raw .env-style variables text for a world
+ */
+export declare function setWorldVariablesText(worldId: string, variablesText: string): Promise<World | null>;
+/**
+ * Get the raw .env-style variables text for a world
+ */
+export declare function getWorldVariablesText(worldId: string): Promise<string>;
+/**
+ * Get parsed environment map from world variables text
+ */
+export declare function getWorldEnvMap(worldId: string): Promise<Record<string, string>>;
+/**
+ * Get a single env value from world variables text
+ */
+export declare function getWorldEnvValue(worldId: string, key: string): Promise<string | undefined>;
+/**
+ * Delete world and all associated data
+ */
+export declare function deleteWorld(worldId: string): Promise<boolean>;
+/**
+ * Get all world IDs and basic information
+ */
+export declare function listWorlds(): Promise<World[]>;
+/**
+ * Get world configuration and create runtime instance, creating a new chat if none exist
+ */
+export declare function getWorld(worldId: string): Promise<World | null>;
+/**
+ * Create new agent with configuration and system prompt
+ */
+export declare function createAgent(worldId: string, params: CreateAgentParams, options?: {
+    allowWhileProcessing?: boolean;
+}): Promise<Agent>;
+/**
+ * Load agent by ID with full configuration and memory
+ */
+export declare function getAgent(worldId: string, agentId: string): Promise<Agent | null>;
+/**
+ * Update agent configuration and/or memory
+ */
+export declare function updateAgent(worldId: string, agentId: string, updates: UpdateAgentParams): Promise<Agent | null>;
+/**
+ * Delete agent and all associated data
+ */
+export declare function deleteAgent(worldId: string, agentId: string): Promise<boolean>;
+/**
+ * Get all agent IDs and basic information
+ */
+export declare function listAgents(worldId: string): Promise<Agent[]>;
+/**
+ * Add messages to agent memory
+ */
+export declare function updateAgentMemory(worldId: string, agentId: string, messages: AgentMessage[]): Promise<Agent | null>;
+/**
+ * Clear agent memory and reset LLM call count
+ */
+export declare function clearAgentMemory(worldId: string, agentId: string): Promise<Agent | null>;
+/**
+ * Create a new chat and optionally set it as current for a world
+ */
+export declare function newChat(worldId: string): Promise<World | null>;
+/**
+ * Create a branched chat from a source chat up to (and including) the provided message.
+ */
+export declare function branchChatFromMessage(worldId: string, sourceChatId: string, messageId: string): Promise<{
+    world: World;
+    newChatId: string;
+    copiedMessageCount: number;
+}>;
+export declare function listChats(worldId: string): Promise<Chat[]>;
+export declare function updateChat(worldId: string, chatId: string, updates: UpdateChatParams): Promise<Chat | null>;
+export declare function deleteChat(worldId: string, chatId: string): Promise<boolean>;
+export declare function restoreChat(worldId: string, chatId: string): Promise<World | null>;
+export declare function getMemory(worldId: string, chatId?: string | null): Promise<AgentMessage[] | null>;
+/**
+ * Migrate messages to include messageId for user message edit feature
+ * Automatically detects storage type and handles both file and SQL storage
+ * Idempotent - safe to run multiple times
+ *
+ * @param worldId - World ID to migrate messages for
+ * @returns Number of messages migrated
+ */
+export declare function migrateMessageIds(worldId: string): Promise<number>;
+/**
+ * Remove a message and all subsequent messages from all agents in a world
+ * Used for user message editing feature
+ *
+ * @param worldId - World ID
+ * @param messageId - ID of the message to remove (and all after it)
+ * @param chatId - Chat ID to filter messages
+ * @returns RemovalResult with per-agent removal details
+ */
+export declare function removeMessagesFrom(worldId: string, messageId: string, chatId: string): Promise<RemovalResult>;
+/**
+ * Edit a user message by removing it and all subsequent messages, then resubmitting with new content
+ * Combines removal and resubmission in a single operation with comprehensive error tracking
+ *
+ * @param worldId - World ID
+ * @param messageId - ID of the message to edit
+ * @param newContent - New message content
+ * @param chatId - Chat ID for the message
+ * @returns RemovalResult with removal and resubmission details
+ */
+export declare function editUserMessage(worldId: string, messageId: string, newContent: string, chatId: string, targetWorld?: World): Promise<RemovalResult>;
+/**
+ * Log an error from a message edit operation for troubleshooting and retry
+ * Stores errors in data/worlds/{worldName}/edit-errors.json
+ * Keeps only the last 100 errors
+ *
+ * @param worldId - World ID
+ * @param errorLog - EditErrorLog to persist
+ */
+export declare function logEditError(worldId: string, errorLog: EditErrorLog): Promise<void>;
+/**
+ * Get edit error logs for a world
+ *
+ * @param worldId - World ID
+ * @returns Array of EditErrorLog entries
+ */
+export declare function getEditErrors(worldId: string): Promise<EditErrorLog[]>;
+//# sourceMappingURL=managers.d.ts.map

package/dist/core/managers.d.ts.map

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