agent-world 0.11.1 → 0.12.0

package/dist/core/events/publishers.js

@@ -0,0 +1,272 @@
+/**
+ * Event Publishers - Event Emission Functions
+ *
+ * Purpose: Functions that emit events to World.eventEmitter
+ * Features:
+ * - Message publishing with chat session management
+ * - SSE event publishing for streaming
+ * - Tool event publishing for agent behaviors
+ * - CRUD event publishing for configuration changes
+ *
+ * Implementation Notes:
+ * - Uses parseMessageContent to preserve enhanced tool-result protocol support
+ * - Emits events synchronously through world-scoped EventEmitter channels
+ *
+ * Recent Changes:
+ * - 2026-02-13: Added optional explicit `chatId` override for `publishEvent` to preserve session context across async flows.
+ * - 2026-02-13: Added chat-scoped tool-event propagation (`chatId`) so realtime tool updates remain session-isolated.
+ * - 2026-02-11: Fixed publishSSE to include toolName and stream fields for tool-stream events
+ * - 2026-02-08: Added core-level sender normalization for consistent user-role detection
+ * - 2026-02-08: Removed legacy manual tool-result publishing helper from event API
+ *
+ * All functions emit events synchronously and return immediately
+ */
+import { EventType } from '../types.js';
+import { generateId } from '../utils.js';
+import { parseMessageContent } from '../message-prep.js';
+import { createCategoryLogger } from '../logger.js';
+const loggerPublish = createCategoryLogger('events.publish');
+const loggerMemory = createCategoryLogger('events.memory');
+// Global streaming control
+let globalStreamingEnabled = true;
+export function enableStreaming() { globalStreamingEnabled = true; }
+export function disableStreaming() { globalStreamingEnabled = false; }
+export function isStreamingEnabled() { return globalStreamingEnabled; }
+/**
+ * Normalize sender values so role/persistence logic remains consistent across clients.
+ * Examples:
+ * - "HUMAN", "user", "User42" => "human"
+ * - "SYSTEM" => "system"
+ * - Agent IDs remain unchanged.
+ */
+export function normalizeSender(sender) {
+    const trimmed = String(sender ?? '').trim();
+    if (!trimmed)
+        return 'human';
+    const lower = trimmed.toLowerCase();
+    if (lower === 'human' || lower.startsWith('user'))
+        return 'human';
+    if (lower === 'system')
+        return 'system';
+    if (lower === 'world')
+        return 'world';
+    return trimmed;
+}
+/**
+ * Publish CRUD event for agent, chat, or world configuration changes
+ * Allows subscribed clients to receive real-time updates for all CRUD operations
+ *
+ * Note: CRUD events are entity-level by default (`chatId: null`), but chat-scoped
+ * CRUD updates can pass an explicit `chatId` when downstream consumers need context.
+ */
+export function publishCRUDEvent(world, operation, entityType, entityId, entityData, chatId) {
+    const event = {
+        operation,
+        entityType,
+        entityId,
+        entityData: operation === 'delete' ? null : entityData,
+        timestamp: new Date(),
+        chatId: chatId ?? null
+    };
+    world.eventEmitter.emit(EventType.CRUD, event);
+    loggerPublish.debug('CRUD event published', {
+        worldId: world.id,
+        operation,
+        entityType,
+        entityId
+    });
+}
+/**
+ * Publish event to a specific channel using World.eventEmitter
+ */
+export function publishEvent(world, type, content, chatId) {
+    const targetChatId = chatId !== undefined ? chatId : (world.currentChatId || null);
+    const event = {
+        content,
+        timestamp: new Date(),
+        messageId: generateId(),
+        chatId: targetChatId
+    };
+    world.eventEmitter.emit(type, event);
+}
+/**
+ * Message publishing using World.eventEmitter with chat session management
+ * Parses enhanced string protocol and automatically prepends @mention if agentId detected
+ * Returns the messageEvent so callers can access the generated messageId
+ *
+ * @param chatId - Optional chat ID. If not provided, uses world.currentChatId
+ * @param replyToMessageId - Optional parent message ID for threading
+ */
+export function publishMessage(world, content, sender, chatId, replyToMessageId) {
+    const messageId = generateId();
+    const targetChatId = chatId !== undefined ? chatId : world.currentChatId;
+    const normalizedSender = normalizeSender(sender);
+    loggerMemory.debug('[publishMessage] ENTRY', {
+        sender,
+        normalizedSender,
+        chatId,
+        contentPreview: content.substring(0, 200),
+        messageId
+    });
+    // Parse enhanced string protocol to extract targetAgentId
+    const { message: parsedMsg, targetAgentId } = parseMessageContent(content, 'user');
+    loggerMemory.debug('[publishMessage] After parseMessageContent', {
+        parsedRole: parsedMsg.role,
+        targetAgentId,
+        toolCallId: parsedMsg.role === 'tool' ? parsedMsg.tool_call_id : undefined
+    });
+    // For tool messages, don't prepend @mention - send the parsed content directly
+    let finalContent = content;
+    if (targetAgentId && parsedMsg.role === 'tool') {
+        // Tool messages: Use the tool_call_id to route, not @mentions
+        // Keep the enhanced protocol format for agent handler to parse
+        loggerMemory.debug('[publishMessage] Tool result message detected', {
+            agentId: targetAgentId,
+            toolCallId: parsedMsg.tool_call_id,
+            messageId
+        });
+    }
+    else if (targetAgentId) {
+        // Regular messages: Prepend @mention
+        finalContent = `@${targetAgentId}, ${content}`;
+        loggerMemory.debug('[publishMessage] Prepended @mention from enhanced protocol', {
+            agentId: targetAgentId,
+            messageId
+        });
+    }
+    // Determine role based on sender and message type
+    let role;
+    if (parsedMsg.role === 'tool') {
+        role = 'tool';
+    }
+    else if (normalizedSender === 'human' || normalizedSender.startsWith('user')) {
+        role = 'user';
+    }
+    else {
+        // Agent senders get role 'assistant'
+        role = 'assistant';
+    }
+    const messageEvent = {
+        content: finalContent,
+        sender: normalizedSender,
+        role,
+        timestamp: new Date(),
+        messageId,
+        chatId: targetChatId,
+        replyToMessageId
+    };
+    loggerMemory.debug('[publishMessage] Generated messageId', {
+        messageId,
+        sender: normalizedSender,
+        role,
+        worldId: world.id,
+        chatId: targetChatId,
+        hasAgentId: !!targetAgentId,
+        contentPreview: finalContent.substring(0, 50)
+    });
+    loggerMemory.debug('[publishMessage] Emitting message event', {
+        messageId,
+        sender: normalizedSender,
+        role,
+        chatId: targetChatId,
+        contentPreview: finalContent.substring(0, 100)
+    });
+    world.eventEmitter.emit('message', messageEvent);
+    loggerMemory.debug('[publishMessage] Message event emitted', { messageId });
+    return messageEvent;
+}
+/**
+ * Message publishing with pre-generated messageId
+ * Used when messageId needs to be known before publishing (e.g., for agent responses)
+ *
+ * @param chatId - Optional chat ID. If not provided, uses world.currentChatId
+ * @param replyToMessageId - Optional parent message ID for threading
+ */
+export function publishMessageWithId(world, content, sender, messageId, chatId, replyToMessageId) {
+    const targetChatId = chatId !== undefined ? chatId : world.currentChatId;
+    const normalizedSender = normalizeSender(sender);
+    const messageEvent = {
+        content,
+        sender: normalizedSender,
+        timestamp: new Date(),
+        messageId,
+        chatId: targetChatId,
+        replyToMessageId
+    };
+    world.eventEmitter.emit('message', messageEvent);
+    return messageEvent;
+}
+/**
+ * Subscribe to message events
+ */
+export function subscribeToMessages(world, handler) {
+    // Wrap async handlers to catch and log errors
+    // This ensures async operations complete even if errors occur
+    const wrappedHandler = (event) => {
+        try {
+            const result = handler(event);
+            if (result instanceof Promise) {
+                result.catch(error => {
+                    loggerPublish.error('Async message handler error', {
+                        worldId: world.id,
+                        messageId: event.messageId,
+                        sender: event.sender,
+                        error: error instanceof Error ? error.message : error,
+                        stack: error instanceof Error ? error.stack : undefined
+                    });
+                });
+            }
+        }
+        catch (error) {
+            loggerPublish.error('Sync message handler error', {
+                worldId: world.id,
+                messageId: event.messageId,
+                sender: event.sender,
+                error: error instanceof Error ? error.message : error,
+                stack: error instanceof Error ? error.stack : undefined
+            });
+        }
+    };
+    world.eventEmitter.on('message', wrappedHandler);
+    return () => world.eventEmitter.off('message', wrappedHandler);
+}
+/**
+ * SSE events using World.eventEmitter (for LLM streaming)
+ */
+export function publishSSE(world, data) {
+    const sseEvent = {
+        agentName: data.agentName,
+        type: data.type,
+        content: data.content,
+        error: data.error,
+        messageId: data.messageId || generateId(),
+        chatId: data.chatId !== undefined ? data.chatId : (world.currentChatId ?? null),
+        usage: data.usage,
+        logEvent: data.logEvent,
+        tool_calls: data.tool_calls,
+        toolName: data.toolName,
+        stream: data.stream
+    };
+    world.eventEmitter.emit('sse', sseEvent);
+}
+/**
+ * Tool events using World.eventEmitter (for agent behavioral events)
+ */
+export function publishToolEvent(world, data) {
+    const toolEvent = {
+        agentName: data.agentName,
+        type: data.type,
+        messageId: data.messageId || generateId(),
+        chatId: data.chatId !== undefined ? data.chatId : (world.currentChatId ?? null),
+        toolExecution: data.toolExecution
+    };
+    world.eventEmitter.emit('world', toolEvent);
+}
+/**
+ * SSE subscription using World.eventEmitter
+ */
+export function subscribeToSSE(world, handler) {
+    world.eventEmitter.on('sse', handler);
+    return () => world.eventEmitter.off('sse', handler);
+}
+//# sourceMappingURL=publishers.js.map

package/dist/core/events/publishers.js.map

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

package/dist/core/events/subscribers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Subscribers Module
+ *
+ * Provides event subscription handlers for agents and world.
+ * Handles message routing, tool result processing, and world activity tracking.
+ *
+ * Features:
+ * - Agent message subscription with automatic response processing
+ * - Tool message subscription with security checks
+ * - World message subscription for title generation (idle and no-activity user-message fallback)
+ * - World activity listener for chat title updates on idle
+ * - In-flight title generation guard to avoid duplicate concurrent updates per chat
+ *
+ * Dependencies (Layer 6):
+ * - types.ts (Layer 1)
+ * - publishers.ts (Layer 3)
+ * - persistence.ts, memory-manager.ts (Layer 4)
+ * - orchestrator.ts (Layer 5)
+ * - utils.ts, logger.ts
+ * - storage (runtime)
+ *
+ * Changes:
+ * - 2026-02-19: Moved chat-title update notifications from `system` to chat `crud` update events.
+ * - 2026-02-13: Added no-activity user-message fallback title scheduling to cover edited chats with no agent response.
+ * - 2026-02-13: Switched title commit path to compare-and-set storage update to avoid concurrent overwrite races.
+ * - 2026-02-13: Added conditional commit checks and in-flight dedupe for idle title updates.
+ * - 2026-02-13: Made idle title updates chat-scoped with captured `targetChatId` to prevent cross-session renames.
+ * - 2026-02-08: Removed legacy manual tool-intervention request handling from message subscription
+ * - 2025-11-09: Extracted from events.ts for modular architecture
+ */
+import type { World, Agent } from '../types.js';
+/**
+ * Agent subscription with automatic message processing
+ */
+export declare function subscribeAgentToMessages(world: World, agent: Agent): () => void;
+/**
+ * Subscribe world to messages with cleanup function
+ */
+export declare function subscribeWorldToMessages(world: World): () => void;
+/**
+ * Setup world activity listener for chat title updates
+ * Triggers title generation when world becomes idle (pendingOperations === 0)
+ */
+export declare function setupWorldActivityListener(world: World): () => void;
+//# sourceMappingURL=subscribers.d.ts.map

package/dist/core/events/subscribers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribers.d.ts","sourceRoot":"","sources":["../../../core/events/subscribers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,KAAK,EACL,KAAK,EAGN,MAAM,aAAa,CAAC;AA6LrB;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,GAAG,MAAM,IAAI,CAqE/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,IAAI,CAWjE;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,IAAI,CAyBnE"}

package/dist/core/events/subscribers.js

@@ -0,0 +1,288 @@
+/**
+ * Subscribers Module
+ *
+ * Provides event subscription handlers for agents and world.
+ * Handles message routing, tool result processing, and world activity tracking.
+ *
+ * Features:
+ * - Agent message subscription with automatic response processing
+ * - Tool message subscription with security checks
+ * - World message subscription for title generation (idle and no-activity user-message fallback)
+ * - World activity listener for chat title updates on idle
+ * - In-flight title generation guard to avoid duplicate concurrent updates per chat
+ *
+ * Dependencies (Layer 6):
+ * - types.ts (Layer 1)
+ * - publishers.ts (Layer 3)
+ * - persistence.ts, memory-manager.ts (Layer 4)
+ * - orchestrator.ts (Layer 5)
+ * - utils.ts, logger.ts
+ * - storage (runtime)
+ *
+ * Changes:
+ * - 2026-02-19: Moved chat-title update notifications from `system` to chat `crud` update events.
+ * - 2026-02-13: Added no-activity user-message fallback title scheduling to cover edited chats with no agent response.
+ * - 2026-02-13: Switched title commit path to compare-and-set storage update to avoid concurrent overwrite races.
+ * - 2026-02-13: Added conditional commit checks and in-flight dedupe for idle title updates.
+ * - 2026-02-13: Made idle title updates chat-scoped with captured `targetChatId` to prevent cross-session renames.
+ * - 2026-02-08: Removed legacy manual tool-intervention request handling from message subscription
+ * - 2025-11-09: Extracted from events.ts for modular architecture
+ */
+import { parseMessageContent } from '../message-prep.js';
+import { extractParagraphBeginningMentions } from '../utils.js';
+import { createCategoryLogger } from '../logger.js';
+import { createStorageWithWrappers } from '../storage/storage-factory.js';
+import { publishCRUDEvent, subscribeToMessages } from './publishers.js';
+import { saveIncomingMessageToMemory, resetLLMCallCountIfNeeded, generateChatTitleFromMessages } from './memory-manager.js';
+import { processAgentMessage, shouldAgentRespond } from './orchestrator.js';
+import { isDefaultChatTitle, NEW_CHAT_TITLE } from '../chat-constants.js';
+const loggerAgent = createCategoryLogger('agent');
+const loggerChatTitle = createCategoryLogger('chattitle');
+const titleGenerationInFlight = new Set();
+const titleGenerationTimers = new Map();
+// Storage wrapper instance - initialized lazily
+let storageWrappers = null;
+async function getStorageWrappers() {
+    if (!storageWrappers) {
+        storageWrappers = await createStorageWithWrappers();
+    }
+    return storageWrappers;
+}
+function getTitleGenerationKey(worldId, chatId) {
+    return `${worldId}:${chatId}`;
+}
+function isHumanSender(sender) {
+    const normalized = String(sender ?? '').trim().toLowerCase();
+    return normalized === 'human' || normalized.startsWith('user');
+}
+function toMentionToken(value) {
+    return String(value || '')
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+function resolveWorldMainAgentMention(world) {
+    const raw = String(world.mainAgent || '').trim();
+    if (!raw)
+        return null;
+    const normalized = toMentionToken(raw);
+    if (!normalized)
+        return null;
+    if (world.agents.has(normalized))
+        return normalized;
+    for (const agent of world.agents.values()) {
+        if (toMentionToken(agent.id) === normalized || toMentionToken(agent.name) === normalized) {
+            return agent.id;
+        }
+    }
+    return null;
+}
+function applyMainAgentMentionRouting(world, messageEvent) {
+    if (!isHumanSender(messageEvent.sender)) {
+        return messageEvent;
+    }
+    const mainAgent = resolveWorldMainAgentMention(world);
+    if (!mainAgent) {
+        return messageEvent;
+    }
+    const mentions = extractParagraphBeginningMentions(messageEvent.content || '');
+    if (mentions.length > 0) {
+        return messageEvent;
+    }
+    return {
+        ...messageEvent,
+        content: `@${mainAgent} ${messageEvent.content || ''}`.trim()
+    };
+}
+function scheduleNoActivityTitleUpdate(world, chatId, content) {
+    const key = getTitleGenerationKey(world.id, chatId);
+    const existingTimer = titleGenerationTimers.get(key);
+    if (existingTimer) {
+        clearTimeout(existingTimer);
+    }
+    const timer = setTimeout(async () => {
+        titleGenerationTimers.delete(key);
+        if (world.isProcessing) {
+            return;
+        }
+        await tryGenerateAndApplyTitle(world, chatId, content, 'message-no-activity');
+    }, 120);
+    titleGenerationTimers.set(key, timer);
+}
+async function commitChatTitleIfDefault(world, chatId, nextTitle) {
+    const storage = await getStorageWrappers();
+    if (typeof storage.updateChatNameIfCurrent === 'function') {
+        return storage.updateChatNameIfCurrent(world.id, chatId, NEW_CHAT_TITLE, nextTitle);
+    }
+    // Legacy fallback when storage backend does not provide compare-and-set helper.
+    const persistedChat = await storage.loadChatData(world.id, chatId);
+    if (!persistedChat || !isDefaultChatTitle(persistedChat.name)) {
+        return false;
+    }
+    const updated = await storage.updateChatData(world.id, chatId, { name: nextTitle });
+    return !!updated;
+}
+async function tryGenerateAndApplyTitle(world, targetChatId, content, source) {
+    const inFlightKey = getTitleGenerationKey(world.id, targetChatId);
+    if (titleGenerationInFlight.has(inFlightKey)) {
+        loggerChatTitle.debug('Skipping title update because generation is already in flight', {
+            worldId: world.id,
+            chatId: targetChatId,
+            source
+        });
+        return;
+    }
+    const chat = world.chats.get(targetChatId);
+    if (!chat || !isDefaultChatTitle(chat.name)) {
+        return;
+    }
+    titleGenerationInFlight.add(inFlightKey);
+    try {
+        const title = await generateChatTitleFromMessages(world, content, targetChatId);
+        if (!title) {
+            return;
+        }
+        // Re-check in-memory state before commit.
+        const currentChat = world.chats.get(targetChatId);
+        if (!currentChat || !isDefaultChatTitle(currentChat.name)) {
+            loggerChatTitle.debug('Skipping title commit because in-memory chat title is no longer default', {
+                worldId: world.id,
+                chatId: targetChatId,
+                source,
+                currentName: currentChat?.name
+            });
+            return;
+        }
+        const committed = await commitChatTitleIfDefault(world, targetChatId, title);
+        if (!committed) {
+            loggerChatTitle.debug('Skipping title commit because persisted chat title no longer matches default', {
+                worldId: world.id,
+                chatId: targetChatId,
+                source
+            });
+            return;
+        }
+        currentChat.name = title;
+        publishCRUDEvent(world, 'update', 'chat', targetChatId, {
+            id: targetChatId,
+            name: title,
+            source
+        }, targetChatId);
+    }
+    finally {
+        titleGenerationInFlight.delete(inFlightKey);
+    }
+}
+/**
+ * Agent subscription with automatic message processing
+ */
+export function subscribeAgentToMessages(world, agent) {
+    const handler = async (messageEvent) => {
+        const routedMessageEvent = applyMainAgentMentionRouting(world, messageEvent);
+        loggerAgent.debug('[subscribeAgentToMessages] ENTRY - Agent received message', {
+            agentId: agent.id,
+            sender: routedMessageEvent.sender,
+            messageId: routedMessageEvent.messageId,
+            contentPreview: routedMessageEvent.content?.substring(0, 200)
+        });
+        if (!routedMessageEvent.messageId) {
+            loggerAgent.error('Received message WITHOUT messageId', {
+                agentId: agent.id,
+                sender: routedMessageEvent.sender,
+                worldId: world.id
+            });
+        }
+        // Check if this is a tool result message
+        // Parse enhanced format first to detect tool messages
+        const { message: parsedMessage, targetAgentId } = parseMessageContent(routedMessageEvent.content, 'user');
+        loggerAgent.debug('[subscribeAgentToMessages] After parseMessageContent', {
+            agentId: agent.id,
+            parsedRole: parsedMessage.role,
+            targetAgentId,
+            toolCallId: parsedMessage.role === 'tool' ? parsedMessage.tool_call_id : undefined,
+            isToolMessage: parsedMessage.role === 'tool' && !!parsedMessage.tool_call_id
+        });
+        // Tool messages are now handled by subscribeAgentToToolMessages (separate handler)
+        // This keeps the message handler focused on user/assistant/system messages only
+        if (parsedMessage.role === 'tool') {
+            loggerAgent.debug('[subscribeAgentToMessages] Skipping tool message - handled by tool handler', {
+                agentId: agent.id,
+                toolCallId: parsedMessage.tool_call_id
+            });
+            return;
+        }
+        // Skip messages from this agent itself
+        if (routedMessageEvent.sender === agent.id) {
+            loggerAgent.debug('Skipping own message in handler', { agentId: agent.id, sender: routedMessageEvent.sender });
+            return;
+        }
+        // Reset LLM call count if needed (for human/system messages)
+        await resetLLMCallCountIfNeeded(world, agent, routedMessageEvent);
+        // Process message if agent should respond
+        loggerAgent.debug('Checking if agent should respond', { agentId: agent.id, sender: routedMessageEvent.sender });
+        const shouldRespond = await shouldAgentRespond(world, agent, routedMessageEvent);
+        if (shouldRespond) {
+            // Save incoming messages to agent memory only when they plan to respond
+            await saveIncomingMessageToMemory(world, agent, routedMessageEvent);
+            loggerAgent.debug('Agent will respond - processing message', { agentId: agent.id, sender: routedMessageEvent.sender });
+            await processAgentMessage(world, agent, routedMessageEvent);
+        }
+        else {
+            loggerAgent.debug('Agent will NOT respond - skipping memory save and SSE publishing', {
+                agentId: agent.id,
+                sender: routedMessageEvent.sender
+            });
+        }
+    };
+    return subscribeToMessages(world, handler);
+}
+/**
+ * Subscribe world to messages with cleanup function
+ */
+export function subscribeWorldToMessages(world) {
+    return subscribeToMessages(world, async (event) => {
+        const targetChatId = event.chatId ?? world.currentChatId ?? null;
+        if (!targetChatId)
+            return;
+        if (!isHumanSender(event.sender))
+            return;
+        const chat = world.chats.get(targetChatId);
+        if (!chat || !isDefaultChatTitle(chat.name))
+            return;
+        scheduleNoActivityTitleUpdate(world, targetChatId, event.content || '');
+    });
+}
+/**
+ * Setup world activity listener for chat title updates
+ * Triggers title generation when world becomes idle (pendingOperations === 0)
+ */
+export function setupWorldActivityListener(world) {
+    const handler = async (event) => {
+        // Only update title when world becomes idle (all agents done)
+        if (event.type === 'idle' && event.pendingOperations === 0) {
+            const targetChatId = world.currentChatId;
+            if (!targetChatId)
+                return;
+            try {
+                await tryGenerateAndApplyTitle(world, targetChatId, '', 'idle');
+            }
+            catch (err) {
+                loggerChatTitle.warn('Activity-based title update failed', { error: err instanceof Error ? err.message : err });
+            }
+        }
+    };
+    world.eventEmitter.on('world', handler);
+    return () => {
+        world.eventEmitter.off('world', handler);
+        for (const [key, timer] of titleGenerationTimers.entries()) {
+            if (!key.startsWith(`${world.id}:`)) {
+                continue;
+            }
+            clearTimeout(timer);
+            titleGenerationTimers.delete(key);
+        }
+    };
+}
+//# sourceMappingURL=subscribers.js.map

package/dist/core/events/subscribers.js.map

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

package/dist/core/events/tool-bridge-logging.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Tool Bridge Logging Utilities
+ *
+ * Purpose:
+ * Shared LLM↔tool debug logging helpers used by both orchestrator and
+ * memory-manager to trace request/result/error handoff payloads.
+ *
+ * Key Features:
+ * - Console-level bridge logs gated by `LOG_LLM_TOOL_BRIDGE` env var
+ * - Simplified output showing only type, tool name, and truncated content (100-200 chars)
+ * - Safe JSON serialization with fallback to `String()`
+ *
+ * Implementation Notes:
+ * - Extracted from orchestrator.ts and memory-manager.ts to eliminate duplication
+ * - Filters verbose metadata, keeps only essential debugging fields
+ *
+ * Changes:
+ * - 2026-02-16: Extracted shared tool-bridge logging utilities from orchestrator
+ *   and memory-manager into a dedicated module.
+ * - 2026-02-17: Simplified logToolBridge to show only type, tool name, and truncated
+ *   content/args/result (100-300 chars max) for better debugging ergonomics. Removed
+ *   worldId, agentId, chatId, hopCount, retryCount and other verbose metadata.
+ */
+export declare function safeSerializeForConsole(value: unknown): string;
+export declare function isToolBridgeLoggingEnabled(): boolean;
+export declare function logToolBridge(direction: string, payload: unknown): void;
+export declare function getToolResultPreview(value: unknown): string;
+//# sourceMappingURL=tool-bridge-logging.d.ts.map

package/dist/core/events/tool-bridge-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-bridge-logging.d.ts","sourceRoot":"","sources":["../../../core/events/tool-bridge-logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAM9D;AAED,wBAAgB,0BAA0B,IAAI,OAAO,CAQpD;AAcD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA6BvE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAU3D"}