agent-world 0.11.1 → 0.12.0

package/dist/core/storage/world-storage.js

@@ -0,0 +1,378 @@
+/**
+ * World Storage Module - File I/O Operations for World Data and Chat Operations
+ *
+ * Logger Category: storage.query
+ * Purpose: World and chat data file I/O operations
+ *
+ * Enable with: LOG_STORAGE_QUERY=debug npm run server
+ *
+ * What you'll see:
+ * - World config saves and loads
+ * - Chat data operations
+ * - Memory aggregation queries
+ * - File operation errors
+ *
+ * Features:
+ * - World configuration persistence to config.json with flattened structure
+ * - Complete chat operations with file-based storage (chats directory)
+ * - Cross-agent memory aggregation for world-level chat sessions
+ * - Kebab-case directory naming from world names
+ * - Clean separation of storage data from runtime objects
+ * - Handles World serialization without EventEmitter and agents Map
+ * - Complete isolation from other internal modules
+ * - Explicit rootPath parameter handling (no environment variables)
+ * - Cascade deletion for data integrity (world → agents/chats, chat → messages)
+ *
+ * Core Functions:
+ * - saveWorld: Save world config.json with flat structure (excludes runtime properties: eventEmitter, agents, chats, eventStorage, _eventPersistenceCleanup)
+ * - loadWorld: Load world configuration from file
+ * - deleteWorld: Remove world directory and all contents (cascades to agents and chats)
+ * - listWorlds: Scan and load all worlds in root directory
+ * - worldExists: Check if world directory exists
+ *
+ * Changes:
+ * - 2026-02-13: Added compare-and-set chat title helper (`updateChatNameIfCurrent`) for safer concurrent title commits.
+ * - 2025-11-01: Explicitly exclude runtime properties (eventEmitter, agents, chats, eventStorage, _eventPersistenceCleanup) from saveWorld
+ * - getWorldDir: Get world directory path
+ * - ensureWorldDirectory: Create world directory structure
+ *
+ * Chat Functions:
+ * - saveChatData: Save complete chat data with metadata and content
+ * - loadChatData: Load complete chat data with Date reconstruction
+ * - deleteChatData: Remove chat files and cascade delete associated messages from agent memory
+ * - listChatHistories: List all chat metadata for a world
+ * - updateChatData: Update existing chat with partial data
+ * - getMemory: Aggregate memory across all agents for chat sessions
+ *
+ * Version: 2.1.0 - Added cascade deletion for chat operations
+ * Date: 2025-10-30
+ * Version: 2.2.0 - Updated to structured logging (storage.query)
+ * Date: 2025-10-31
+ */
+import { promises as fs } from 'fs';
+import * as path from 'path';
+import { toKebabCase } from '../utils.js';
+import { createCategoryLogger } from '../logger.js';
+import { listAgents, loadAgent, deleteMemoryByChatId } from './agent-storage.js';
+const logger = createCategoryLogger('storage.query');
+// Extract readdir and exists from fs for convenience
+const { readdir, access } = fs;
+const exists = async (path) => {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
+/**
+ * File utility functions
+ */
+async function writeJsonFile(filePath, data) {
+    await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf8');
+}
+async function readJsonFile(filePath) {
+    const content = await fs.readFile(filePath, 'utf8');
+    return JSON.parse(content);
+}
+/**
+ * World directory and file path utilities
+ */
+export function getWorldDir(rootPath, worldId) {
+    const normalizedWorldId = toKebabCase(worldId);
+    return path.join(rootPath, normalizedWorldId);
+}
+export async function ensureWorldDirectory(root, worldId) {
+    const worldDir = getWorldDir(root, worldId);
+    await fs.mkdir(worldDir, { recursive: true });
+}
+/**
+ * Check if world exists on disk
+ */
+export async function worldExists(root, worldId) {
+    try {
+        const worldDir = getWorldDir(root, worldId);
+        const configPath = path.join(worldDir, 'config.json');
+        await fs.access(configPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Save world to disk
+ */
+export async function saveWorld(root, worldData) {
+    await ensureWorldDirectory(root, worldData.id);
+    const worldDir = getWorldDir(root, worldData.id);
+    const configPath = path.join(worldDir, 'config.json');
+    const mcpConfigPath = path.join(worldDir, 'mcp.json');
+    // Exclude runtime properties and mcpConfig from config.json
+    const { mcpConfig, eventEmitter, agents, chats, eventStorage, _eventPersistenceCleanup, ...configData } = worldData;
+    // Save main config without runtime properties
+    await writeJsonFile(configPath, configData);
+    // Save mcpConfig to separate file if it exists
+    if (mcpConfig !== undefined && mcpConfig !== null) {
+        try {
+            // Validate that mcpConfig is valid JSON
+            const parsedConfig = JSON.parse(mcpConfig);
+            await writeJsonFile(mcpConfigPath, parsedConfig);
+        }
+        catch (error) {
+            // If mcpConfig is not valid JSON, save it as-is (could be a string)
+            await writeJsonFile(mcpConfigPath, { config: mcpConfig });
+        }
+    }
+    else {
+        // Remove mcp.json if mcpConfig is null/undefined
+        try {
+            await fs.unlink(mcpConfigPath);
+        }
+        catch {
+            // File might not exist, ignore error
+        }
+    }
+}
+/**
+ * Load world from disk
+ */
+export async function loadWorld(root, worldId) {
+    try {
+        const worldDir = getWorldDir(root, worldId);
+        const configPath = path.join(worldDir, 'config.json');
+        const mcpConfigPath = path.join(worldDir, 'mcp.json');
+        const worldData = await readJsonFile(configPath);
+        // Reconstruct Date objects
+        if (worldData.createdAt)
+            worldData.createdAt = new Date(worldData.createdAt);
+        if (worldData.lastUpdated)
+            worldData.lastUpdated = new Date(worldData.lastUpdated);
+        // Load mcpConfig from separate file if it exists
+        try {
+            const mcpData = await readJsonFile(mcpConfigPath);
+            // If mcpData has a 'config' field, it was stored as a wrapped string
+            if (mcpData && typeof mcpData === 'object' && 'config' in mcpData) {
+                worldData.mcpConfig = mcpData.config;
+            }
+            else {
+                // Otherwise, stringify the JSON object
+                worldData.mcpConfig = JSON.stringify(mcpData);
+            }
+        }
+        catch {
+            // mcp.json doesn't exist or can't be read, set to null for backward compatibility
+            worldData.mcpConfig = null;
+        }
+        return worldData;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Delete world from disk
+ */
+export async function deleteWorld(root, worldId) {
+    try {
+        const worldDir = getWorldDir(root, worldId);
+        await fs.rm(worldDir, { recursive: true, force: true });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List all worlds in root directory
+ */
+export async function listWorlds(root) {
+    try {
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        const worlds = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const worldData = await loadWorld(root, entry.name);
+                if (worldData) {
+                    worlds.push(worldData);
+                }
+            }
+        }
+        return worlds.sort((a, b) => new Date(b.lastUpdated).getTime() - new Date(a.lastUpdated).getTime());
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Chat directory and file path utilities
+ */
+export function getChatDir(rootPath, worldId) {
+    const worldDir = getWorldDir(rootPath, worldId);
+    return path.join(worldDir, 'chats');
+}
+export function getChatFilePath(rootPath, worldId, chatId) {
+    const chatDir = getChatDir(rootPath, worldId);
+    return path.join(chatDir, `${chatId}.json`);
+}
+export async function ensureChatDirectory(rootPath, worldId) {
+    const chatDir = getChatDir(rootPath, worldId);
+    await fs.mkdir(chatDir, { recursive: true });
+}
+/**
+ * Save chat data (metadata + content) to disk
+ */
+export async function saveChatData(rootPath, worldId, chatData) {
+    await ensureChatDirectory(rootPath, worldId);
+    // Save the complete ChatData object
+    const chatPath = getChatFilePath(rootPath, worldId, chatData.id);
+    await writeJsonFile(chatPath, chatData);
+}
+/**
+ * Load chat data (metadata + content) from disk
+ */
+export async function loadChatData(rootPath, worldId, chatId) {
+    try {
+        const chatPath = getChatFilePath(rootPath, worldId, chatId);
+        const chatData = await readJsonFile(chatPath);
+        // Reconstruct Date objects
+        if (chatData.createdAt)
+            chatData.createdAt = new Date(chatData.createdAt);
+        if (chatData.updatedAt)
+            chatData.updatedAt = new Date(chatData.updatedAt);
+        return chatData;
+    }
+    catch (error) {
+        logger.error('Failed to load chat data', {
+            error: error instanceof Error ? error.message : String(error),
+            worldId,
+            chatId
+        });
+        return null;
+    }
+}
+/**
+ * Update chat data on disk
+ */
+export async function updateChatData(rootPath, worldId, chatId, updates) {
+    const chatData = await loadChatData(rootPath, worldId, chatId);
+    if (!chatData)
+        return null;
+    // Apply updates to metadata
+    if (updates.name !== undefined)
+        chatData.name = updates.name;
+    if (updates.description !== undefined)
+        chatData.description = updates.description;
+    // Update timestamps
+    chatData.updatedAt = new Date();
+    await saveChatData(rootPath, worldId, chatData);
+    return chatData;
+}
+/**
+ * Compare-and-set chat name on disk.
+ * Updates name only when the current name exactly matches expectedName.
+ */
+export async function updateChatNameIfCurrent(rootPath, worldId, chatId, expectedName, nextName) {
+    const chatData = await loadChatData(rootPath, worldId, chatId);
+    if (!chatData)
+        return false;
+    if (chatData.name !== expectedName)
+        return false;
+    chatData.name = nextName;
+    chatData.updatedAt = new Date();
+    await saveChatData(rootPath, worldId, chatData);
+    return true;
+}
+/**
+ * Delete chat data from disk with cascade deletion of associated messages
+ */
+export async function deleteChatData(rootPath, worldId, chatId) {
+    try {
+        // Delete the chat file
+        const chatPath = getChatFilePath(rootPath, worldId, chatId);
+        await fs.unlink(chatPath);
+        // Cascade delete: Remove all agent memory messages with this chatId
+        await deleteMemoryByChatId(rootPath, worldId, chatId);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * List chat histories (metadata only)
+ */
+export async function listChatHistories(rootPath, worldId) {
+    try {
+        const chatDir = getChatDir(rootPath, worldId);
+        if (!await exists(chatDir)) {
+            return [];
+        }
+        const files = await readdir(chatDir);
+        const chatFiles = files.filter((file) => file.endsWith('.json'));
+        const chats = [];
+        for (const file of chatFiles) {
+            const chatId = file.replace('.json', '');
+            const chatData = await loadChatData(rootPath, worldId, chatId);
+            if (chatData) {
+                // Extract just the metadata
+                const chatInfo = {
+                    id: chatData.id,
+                    worldId: worldId,
+                    name: chatData.name,
+                    description: chatData.description,
+                    createdAt: chatData.createdAt,
+                    updatedAt: chatData.updatedAt,
+                    messageCount: chatData.messageCount,
+                };
+                chats.push(chatInfo);
+            }
+        }
+        return chats.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+    }
+    catch (error) {
+        logger.error('Failed to list chat histories', {
+            error: error instanceof Error ? error.message : String(error),
+            worldId
+        });
+        return [];
+    }
+}
+/**
+ * Get aggregated memory across all agents for a given chat
+ * Filters messages by chatId and includes agentId for proper message attribution
+ */
+export async function getMemory(rootPath, worldId, chatId) {
+    try {
+        const agents = await listAgents(rootPath, worldId);
+        const messages = [];
+        for (const agent of agents) {
+            const fullAgent = await loadAgent(rootPath, worldId, agent.id);
+            const mem = fullAgent?.memory || [];
+            for (const m of mem) {
+                if (!chatId || m.chatId === chatId) {
+                    // Ensure agentId is included in the message
+                    const messageWithAgentId = { ...m, agentId: agent.id };
+                    messages.push(messageWithAgentId);
+                }
+            }
+        }
+        // Sort by createdAt ascending
+        messages.sort((a, b) => {
+            const at = a.createdAt ? new Date(a.createdAt).getTime() : 0;
+            const bt = b.createdAt ? new Date(b.createdAt).getTime() : 0;
+            return at - bt;
+        });
+        return messages;
+    }
+    catch (error) {
+        logger.error('Failed to get aggregated memory', {
+            error: error instanceof Error ? error.message : String(error),
+            worldId,
+            chatId
+        });
+        return [];
+    }
+}
+//# sourceMappingURL=world-storage.js.map

package/dist/core/storage/world-storage.js.map

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

package/dist/core/subscription.d.ts

@@ -0,0 +1,43 @@
+/**
+ * World Subscription Runtime
+ *
+ * Features:
+ * - Manages world lifecycle subscriptions and realtime event forwarding.
+ * - Registers message/world/sse/system listeners for subscribed clients.
+ * - Tracks active world runtimes for core operations that need the live emitter.
+ *
+ * Implementation Notes:
+ * - Keeps forwarding listeners optional based on client callback capabilities.
+ * - Uses world-id keyed runtime tracking with safe register/unregister semantics.
+ *
+ * Recent Changes:
+ * - 2026-02-14: Added active runtime world tracking and `getActiveSubscribedWorld()` for core edit-message resubmission to publish on live emitters.
+ */
+import { World } from './types.js';
+import { type LogLevel } from './logger.js';
+export interface LogStreamEvent {
+    level: LogLevel;
+    category: string;
+    message: string;
+    timestamp: string;
+    data?: any;
+    messageId: string;
+}
+export interface ClientConnection {
+    isOpen: boolean;
+    onWorldEvent?: (eventType: string, eventData: any) => void;
+    onError?: (error: string) => void;
+    onLog?: (logEvent: LogStreamEvent) => void;
+}
+export interface WorldSubscription {
+    world: World;
+    unsubscribe: () => Promise<void>;
+    refresh: () => Promise<World>;
+    destroy: () => Promise<void>;
+}
+export declare function getActiveSubscribedWorld(worldIdentifier: string): World | null;
+export declare function startWorld(world: World, client: ClientConnection): Promise<WorldSubscription>;
+export declare function subscribeWorld(worldIdentifier: string, client: ClientConnection): Promise<WorldSubscription | null>;
+export declare function setupWorldEventListeners(world: World, client: ClientConnection): Map<string, (...args: any[]) => void>;
+export declare function cleanupWorldSubscription(world: World, worldEventListeners: Map<string, (...args: any[]) => void>): Promise<void>;
+//# sourceMappingURL=subscription.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscription.d.ts","sourceRoot":"","sources":["../../core/subscription.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAwB,KAAK,QAAQ,EAAwB,MAAM,aAAa,CAAC;AAYxF,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,KAAK,IAAI,CAAC;IAC3D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;CAC5C;AAGD,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC;IACb,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAwBD,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,GAAG,KAAK,GAAG,IAAI,CAW9E;AAGD,wBAAsB,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwFnG;AAGD,wBAAsB,cAAc,CAClC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmCnC;AAGD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAiDtH;AAGD,wBAAsB,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAetI"}

package/dist/core/subscription.js

@@ -0,0 +1,227 @@
+/**
+ * World Subscription Runtime
+ *
+ * Features:
+ * - Manages world lifecycle subscriptions and realtime event forwarding.
+ * - Registers message/world/sse/system listeners for subscribed clients.
+ * - Tracks active world runtimes for core operations that need the live emitter.
+ *
+ * Implementation Notes:
+ * - Keeps forwarding listeners optional based on client callback capabilities.
+ * - Uses world-id keyed runtime tracking with safe register/unregister semantics.
+ *
+ * Recent Changes:
+ * - 2026-02-14: Added active runtime world tracking and `getActiveSubscribedWorld()` for core edit-message resubmission to publish on live emitters.
+ */
+import { getWorld } from './managers.js';
+import { createCategoryLogger, addLogStreamCallback } from './logger.js';
+import { subscribeAgentToMessages, subscribeWorldToMessages } from './events/index.js';
+function toKebabCase(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
+}
+// Create subscription category logger (part of core functionality)
+const logger = createCategoryLogger('world.subscription');
+const activeSubscribedWorlds = new Map();
+function registerActiveSubscribedWorld(world) {
+    const worldId = String(world?.id || '').trim();
+    if (!worldId)
+        return;
+    const existing = activeSubscribedWorlds.get(worldId) ?? new Set();
+    existing.add(world);
+    activeSubscribedWorlds.set(worldId, existing);
+}
+function unregisterActiveSubscribedWorld(world) {
+    const worldId = String(world?.id || '').trim();
+    if (!worldId)
+        return;
+    const existing = activeSubscribedWorlds.get(worldId);
+    if (!existing)
+        return;
+    existing.delete(world);
+    if (existing.size === 0) {
+        activeSubscribedWorlds.delete(worldId);
+    }
+}
+export function getActiveSubscribedWorld(worldIdentifier) {
+    const resolvedWorldId = toKebabCase(String(worldIdentifier || '').trim());
+    if (!resolvedWorldId)
+        return null;
+    const activeWorldSet = activeSubscribedWorlds.get(resolvedWorldId);
+    if (!activeWorldSet || activeWorldSet.size === 0)
+        return null;
+    for (const world of activeWorldSet.values()) {
+        return world;
+    }
+    return null;
+}
+// Start world with event listeners - extracted from subscribeWorld
+export async function startWorld(world, client) {
+    // Only set up forwarding listeners when the client actually wants them.
+    let worldEventListeners = new Map();
+    if (client && (client.onWorldEvent || client.onLog)) {
+        worldEventListeners = setupWorldEventListeners(world, client);
+    }
+    let currentWorld = world;
+    registerActiveSubscribedWorld(currentWorld);
+    // Subscribe all loaded agents to world messages (moved from getFullWorld)
+    for (const agent of currentWorld.agents.values()) {
+        subscribeAgentToMessages(currentWorld, agent);
+    }
+    subscribeWorldToMessages(currentWorld);
+    // Helper function to destroy current world instance
+    const destroyCurrentWorld = async () => {
+        if (currentWorld) {
+            unregisterActiveSubscribedWorld(currentWorld);
+            // Clean up all event listeners
+            await cleanupWorldSubscription(currentWorld, worldEventListeners);
+            // Remove all listeners from the EventEmitter to prevent memory leaks
+            currentWorld.eventEmitter.removeAllListeners();
+            // Clear agents map references
+            currentWorld.agents.clear();
+            logger.debug('World instance destroyed', { worldId: currentWorld.id });
+        }
+    };
+    // Return subscription object with cleanup methods
+    return {
+        get world() {
+            if (!currentWorld) {
+                throw new Error('World subscription has been destroyed');
+            }
+            return currentWorld;
+        },
+        unsubscribe: async () => {
+            await destroyCurrentWorld();
+            currentWorld = null;
+        },
+        destroy: async () => {
+            await destroyCurrentWorld();
+            currentWorld = null;
+        },
+        refresh: async () => {
+            const worldId = currentWorld?.id || '';
+            logger.debug('Refreshing world subscription', { worldId });
+            // Destroy the old world instance completely
+            await destroyCurrentWorld();
+            // Create a completely new world instance
+            const refreshedWorld = await getWorld(worldId);
+            if (!refreshedWorld) {
+                throw new Error(`Failed to refresh world: ${worldId}`);
+            }
+            // Update current references
+            currentWorld = refreshedWorld;
+            registerActiveSubscribedWorld(currentWorld);
+            // Set up new event listeners on the fresh world only if client wants forwarding
+            if (client && (client.onWorldEvent || client.onLog)) {
+                worldEventListeners = setupWorldEventListeners(currentWorld, client);
+            }
+            else {
+                worldEventListeners = new Map();
+            }
+            // Subscribe all loaded agents to world messages (moved from getFullWorld)
+            for (const agent of currentWorld.agents.values()) {
+                subscribeAgentToMessages(currentWorld, agent);
+            }
+            logger.debug('World subscription refreshed', {
+                worldId: currentWorld.id,
+                agentCount: currentWorld.agents.size
+            });
+            return currentWorld;
+        }
+    };
+}
+// World subscription management
+export async function subscribeWorld(worldIdentifier, client) {
+    try {
+        // Load world using core manager (convert to kebab-case internally)
+        const worldId = toKebabCase(worldIdentifier);
+        const currentWorld = await getWorld(worldId);
+        if (!currentWorld) {
+            if (client.onError) {
+                client.onError(`World not found: ${worldIdentifier}`);
+            }
+            return null;
+        }
+        // MCP servers will be started on-demand in getMCPToolsForWorld()
+        if (currentWorld.mcpConfig) {
+            logger.debug(`World ${worldId} has MCP config - servers will start on-demand`);
+        }
+        // Use startWorld function to create the subscription
+        const subscription = await startWorld(currentWorld, client);
+        // MCP servers use connection pooling and will be cleaned up automatically
+        // when the Express app shuts down
+        return subscription;
+    }
+    catch (error) {
+        logger.error('World subscription failed', {
+            worldIdentifier,
+            error: error instanceof Error ? error.message : error
+        });
+        if (client.onError) {
+            client.onError(`Failed to subscribe to world: ${error instanceof Error ? error.message : error}`);
+        }
+        return null;
+    }
+}
+// Set up event listeners for world events with client connection forwarding
+export function setupWorldEventListeners(world, client) {
+    const listeners = new Map();
+    // System events
+    const systemListener = (eventData) => {
+        if (client.onWorldEvent) {
+            client.onWorldEvent('system', eventData);
+        }
+    };
+    world.eventEmitter.on('system', systemListener);
+    listeners.set('system', systemListener);
+    // Message events
+    const messageListener = (eventData) => {
+        if (client.onWorldEvent) {
+            client.onWorldEvent('message', eventData);
+        }
+    };
+    world.eventEmitter.on('message', messageListener);
+    listeners.set('message', messageListener);
+    // SSE events
+    const sseListener = (eventData) => {
+        if (client.onWorldEvent) {
+            client.onWorldEvent('sse', eventData);
+        }
+    };
+    world.eventEmitter.on('sse', sseListener);
+    listeners.set('sse', sseListener);
+    // World events (includes activity tracking)
+    // Note: 'world' channel receives WorldActivityEventPayload for activity tracking
+    const worldActivityListener = (eventData) => {
+        if (client.onWorldEvent) {
+            client.onWorldEvent('world', eventData);
+        }
+    };
+    world.eventEmitter.on('world', worldActivityListener);
+    listeners.set('world', worldActivityListener);
+    // Log streaming - set up if client has onLog callback
+    if (client.onLog) {
+        const logUnsubscribe = addLogStreamCallback((logEvent) => {
+            client.onLog(logEvent);
+        });
+        listeners.set('logStream', logUnsubscribe);
+    }
+    return listeners;
+}
+// Clean up world subscription and event listeners
+export async function cleanupWorldSubscription(world, worldEventListeners) {
+    try {
+        // Remove all event listeners
+        for (const [eventType, listener] of worldEventListeners.entries()) {
+            world.eventEmitter.removeListener(eventType, listener);
+        }
+        worldEventListeners.clear();
+        logger.debug('World subscription cleanup completed', { worldId: world.id });
+    }
+    catch (error) {
+        logger.error('World subscription cleanup failed', {
+            worldId: world.id,
+            error: error instanceof Error ? error.message : error
+        });
+    }
+}
+//# sourceMappingURL=subscription.js.map