agent-world 0.13.0 → 0.15.0

package/dist/core/hitl.js

@@ -5,23 +5,32 @@
  * - Provide a world-scoped request/response flow for option-based HITL prompts.
  *
  * Key Features:
- * - Emits structured system events for option prompts (`hitl-option-request`).
+ * - Emits structured tool-progress events carrying HITL prompt payloads.
  * - Resolves pending requests when renderer/API submits an option response.
- * - Supports deterministic timeout fallback for option requests.
+ * - Exposes unresolved option prompts through a deterministic read model.
  * - Maintains pending request map for validation and lifecycle cleanup.
  *
  * Implementation Notes:
  * - Requests are keyed by `(worldId, requestId)` to avoid cross-world collisions.
- * - Timeout fallback defaults to `no` when available, otherwise first option.
+ * - Prompt read model is deterministic and scoped by `(worldId, chatId)`.
  * - Runtime is in-memory and process-local by design.
  *
  * Recent Changes:
+ * - 2026-03-12: Relaxed the hard `requestId === toolCallId` invariant so durable approval prompts can keep distinct request and owning-tool identities.
+ * - 2026-03-06: Removed `world.currentChatId` fallback from HITL option requests; interactive requests now require explicit `chatId`.
+ * - 2026-02-26: Replaced direct `[hitl]` console traces with categorized structured logger events (`hitl`) for env-controlled filtering.
+ * - 2026-02-25: Added HITL runtime trace logs for request emission, replay, and resolution lifecycle diagnostics.
+ * - 2026-02-24: Removed HITL `system` event emission/replay and switched to tool-progress prompt payloads.
+ * - 2026-02-24: Added `listPendingHitlPromptEvents` to expose scoped pending HITL prompt payloads for web chat-switch replay.
+ * - 2026-02-24: Removed timeout auto-resolution and added deterministic replay helpers for unresolved HITL requests.
  * - 2026-02-20: Enforced global options-only HITL runtime by removing input-mode request/response paths.
  * - 2026-02-14: Added initial generic HITL option request/response runtime.
  */
+import { createCategoryLogger } from './logger.js';
 import { generateId } from './utils.js';
-const DEFAULT_TIMEOUT_MS = 120_000;
 const pendingHitlRequests = new Map();
+let pendingRequestSequence = 0;
+const loggerHitl = createCategoryLogger('hitl');
 function getPendingKey(worldId, requestId) {
     return `${worldId}::${requestId}`;
 }
@@ -54,27 +63,99 @@ function resolveDefaultOptionId(options, preferredDefaultOptionId) {
     }
     return options[0]?.id || 'no';
 }
-function normalizeWorldChatId(world, chatId) {
-    if (chatId !== undefined) {
-        const normalized = chatId ? String(chatId).trim() : '';
-        return normalized || null;
+function normalizeExplicitChatId(chatId) {
+    if (chatId === undefined || chatId === null) {
+        return null;
     }
-    return world.currentChatId ?? null;
-}
-function normalizeTimeoutMs(timeoutMs) {
-    const timeoutMsRaw = Number(timeoutMs ?? DEFAULT_TIMEOUT_MS);
-    return Number.isFinite(timeoutMsRaw) && timeoutMsRaw > 0
-        ? Math.floor(timeoutMsRaw)
-        : DEFAULT_TIMEOUT_MS;
+    const normalized = String(chatId).trim();
+    return normalized || null;
 }
 function resolvePendingRequest(params) {
     const { pendingKey, pending, resolution } = params;
     pendingHitlRequests.delete(pendingKey);
-    if (pending.timeoutHandle) {
-        clearTimeout(pending.timeoutHandle);
-    }
     pending.resolve(resolution);
 }
+function normalizeChatId(chatId) {
+    if (chatId === undefined || chatId === null) {
+        return null;
+    }
+    const normalized = String(chatId).trim();
+    return normalized || null;
+}
+function resolveHitlAgentName(world, requestedAgentName) {
+    const explicit = String(requestedAgentName || '').trim();
+    if (explicit) {
+        return explicit;
+    }
+    const worldMainAgent = String(world?.mainAgent || '').trim();
+    if (worldMainAgent) {
+        return worldMainAgent;
+    }
+    return null;
+}
+function emitPendingRequest(world, pending) {
+    const metadata = pending.prompt.metadata || null;
+    const toolExecutionMetadata = {
+        ...(metadata && typeof metadata === 'object' ? metadata : {}),
+        hitlPrompt: {
+            requestId: pending.prompt.requestId,
+            title: pending.prompt.title,
+            message: pending.prompt.message,
+            options: pending.prompt.options,
+            defaultOptionId: pending.prompt.defaultOptionId,
+            metadata,
+            agentName: pending.prompt.agentName,
+            chatId: pending.chatId,
+        },
+    };
+    world.eventEmitter.emit('world', {
+        agentName: pending.prompt.agentName || 'system',
+        type: 'tool-progress',
+        messageId: pending.prompt.toolCallId,
+        chatId: pending.chatId,
+        toolExecution: {
+            toolName: pending.prompt.toolName,
+            toolCallId: pending.prompt.toolCallId,
+            metadata: toolExecutionMetadata,
+        },
+    });
+    loggerHitl.debug('HITL pending request emitted', {
+        worldId: world.id,
+        chatId: pending.chatId || null,
+        requestId: pending.prompt.requestId,
+        toolName: pending.prompt.toolName,
+        toolCallId: pending.prompt.toolCallId,
+    });
+}
+function getSortedPendingRequestsForScope(worldId, chatId) {
+    const normalizedChatId = normalizeChatId(chatId);
+    const scoped = [...pendingHitlRequests.values()].filter((pending) => {
+        if (pending.worldId !== worldId) {
+            return false;
+        }
+        if (normalizedChatId === null) {
+            return true;
+        }
+        return pending.chatId === normalizedChatId;
+    });
+    scoped.sort((left, right) => left.sequence - right.sequence);
+    return scoped;
+}
+/**
+ * Remove all pending HITL requests scoped to a specific chat.
+ * Called during edit+resubmit so orphaned requests from aborted processing
+ * do not block the activity tracker or leak into subscription replays.
+ */
+export function clearPendingHitlRequestsForChat(worldId, chatId) {
+    const normalizedChatId = normalizeChatId(chatId);
+    for (const [key, pending] of pendingHitlRequests) {
+        if (pending.worldId !== worldId)
+            continue;
+        if (normalizedChatId !== null && pending.chatId !== normalizedChatId)
+            continue;
+        pendingHitlRequests.delete(key);
+    }
+}
 function validateResponseScope(pending, chatId) {
     if (chatId === undefined) {
         return { valid: true };
@@ -97,20 +178,45 @@ export async function requestWorldOption(world, request) {
     if (!worldId) {
         throw new Error('Cannot request HITL option without a valid world ID.');
     }
-    const requestId = String(request.requestId || '').trim() || generateId();
-    const chatId = normalizeWorldChatId(world, request.chatId);
-    const timeoutMs = normalizeTimeoutMs(request.timeoutMs);
+    const requestMetadata = request.metadata && typeof request.metadata === 'object'
+        ? request.metadata
+        : null;
+    const explicitRequestId = String(request.requestId || '').trim();
+    const requestedToolCallId = requestMetadata && typeof requestMetadata.toolCallId === 'string'
+        ? String(requestMetadata.toolCallId).trim()
+        : '';
+    const requestId = explicitRequestId || requestedToolCallId || generateId();
+    const toolCallId = requestedToolCallId || requestId;
+    const chatId = normalizeExplicitChatId(request.chatId);
+    if (!chatId) {
+        throw new Error('HITL option request requires an explicit chatId.');
+    }
     const defaultOptionId = resolveDefaultOptionId(normalizedOptions, request.defaultOptionId);
     const pendingKey = getPendingKey(worldId, requestId);
+    const sequence = ++pendingRequestSequence;
+    const requestedToolName = requestMetadata && typeof requestMetadata.tool === 'string'
+        ? String(requestMetadata.tool).trim()
+        : '';
+    const prompt = {
+        requestId,
+        title: String(request.title || '').trim(),
+        message: String(request.message || '').trim(),
+        options: normalizedOptions,
+        defaultOptionId,
+        metadata: requestMetadata,
+        agentName: resolveHitlAgentName(world, request.agentName),
+        toolName: requestedToolName || 'human_intervention_request',
+        toolCallId,
+    };
     return await new Promise((resolve) => {
         const pending = {
             worldId,
             requestId,
             chatId,
             optionIds: new Set(normalizedOptions.map((option) => option.id)),
-            defaultOptionId,
-            metadata: request.metadata || null,
-            timeoutHandle: null,
+            sequence,
+            prompt,
+            metadata: requestMetadata,
             resolve: (resolution) => {
                 resolve({
                     requestId: resolution.requestId,
@@ -121,41 +227,174 @@ export async function requestWorldOption(world, request) {
                 });
             },
         };
-        pending.timeoutHandle = setTimeout(() => {
-            const timeoutPending = pendingHitlRequests.get(pendingKey);
-            if (!timeoutPending) {
-                return;
+        pendingHitlRequests.set(pendingKey, pending);
+        loggerHitl.debug('HITL request queued', {
+            worldId,
+            chatId: chatId || null,
+            requestId,
+            optionCount: normalizedOptions.length,
+        });
+        emitPendingRequest(world, pending);
+    });
+}
+function parseToolCallArguments(raw) {
+    if (typeof raw !== 'string' || !raw.trim()) {
+        return null;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+function normalizeOptionsFromToolArgs(args) {
+    const options = Array.isArray(args.options) ? args.options : [];
+    const normalized = [];
+    const seen = new Set();
+    for (let index = 0; index < options.length; index += 1) {
+        const rawOption = options[index];
+        if (rawOption && typeof rawOption === 'object' && !Array.isArray(rawOption)) {
+            const label = String(rawOption.label || '').trim();
+            const id = String(rawOption.id || '').trim();
+            if (!label || !id) {
+                continue;
+            }
+            const dedupeKey = id.toLowerCase();
+            if (seen.has(dedupeKey)) {
+                continue;
             }
-            resolvePendingRequest({
-                pendingKey,
-                pending: timeoutPending,
-                resolution: {
-                    requestId,
-                    worldId,
-                    chatId,
-                    optionId: timeoutPending.defaultOptionId,
-                    source: 'timeout',
+            seen.add(dedupeKey);
+            normalized.push({ id, label });
+            continue;
+        }
+        const label = String(rawOption || '').trim();
+        if (!label) {
+            continue;
+        }
+        const dedupeKey = label.toLowerCase();
+        if (seen.has(dedupeKey)) {
+            continue;
+        }
+        seen.add(dedupeKey);
+        normalized.push({
+            id: `opt_${normalized.length + 1}`,
+            label,
+        });
+    }
+    return normalized;
+}
+function resolveDefaultOptionFromToolArgs(normalizedOptions, args) {
+    const defaultOptionId = String(args.defaultOptionId || '').trim();
+    if (defaultOptionId) {
+        const explicitById = normalizedOptions.find((option) => option.id === defaultOptionId);
+        if (explicitById) {
+            return explicitById.id;
+        }
+    }
+    const defaultOptionLabel = String(args.defaultOption || '').trim().toLowerCase();
+    if (defaultOptionLabel) {
+        const explicit = normalizedOptions.find((option) => option.label.toLowerCase() === defaultOptionLabel);
+        if (explicit) {
+            return explicit.id;
+        }
+    }
+    return normalizedOptions.find((option) => option.id === 'no')?.id || normalizedOptions[0]?.id || 'opt_1';
+}
+export function listPendingHitlPromptEventsFromMessages(messages, chatId) {
+    const allMessages = Array.isArray(messages) ? messages : [];
+    const resolvedToolCallIds = new Set();
+    for (const message of allMessages) {
+        if (message?.role !== 'tool') {
+            continue;
+        }
+        const toolCallId = String(message?.tool_call_id || '').trim();
+        if (!toolCallId) {
+            continue;
+        }
+        resolvedToolCallIds.add(toolCallId);
+    }
+    const unresolvedById = new Map();
+    for (const message of allMessages) {
+        if (message?.role !== 'assistant' || !Array.isArray(message?.tool_calls)) {
+            continue;
+        }
+        for (const toolCall of message.tool_calls) {
+            const toolName = String(toolCall?.function?.name || '').trim();
+            const toolCallId = String(toolCall?.id || '').trim();
+            if (!toolCallId || toolName !== 'human_intervention_request') {
+                continue;
+            }
+            if (resolvedToolCallIds.has(toolCallId) || unresolvedById.has(toolCallId)) {
+                continue;
+            }
+            const args = parseToolCallArguments(toolCall?.function?.arguments);
+            if (!args) {
+                continue;
+            }
+            const options = normalizeOptionsFromToolArgs(args);
+            if (options.length === 0) {
+                continue;
+            }
+            const messageChatId = message?.chatId ? String(message.chatId) : null;
+            const normalizedChatId = messageChatId || (chatId ? String(chatId) : null);
+            const metadata = args.metadata && typeof args.metadata === 'object' && !Array.isArray(args.metadata)
+                ? args.metadata
+                : null;
+            const metadataToolCallId = metadata && typeof metadata.toolCallId === 'string'
+                ? String(metadata.toolCallId).trim()
+                : '';
+            const metadataToolName = metadata && typeof metadata.tool === 'string'
+                ? String(metadata.tool).trim()
+                : '';
+            unresolvedById.set(toolCallId, {
+                chatId: normalizedChatId,
+                prompt: {
+                    requestId: toolCallId,
+                    title: String(args.title || 'Human input required').trim() || 'Human input required',
+                    message: String(args.question || args.prompt || '').trim(),
+                    options,
+                    defaultOptionId: resolveDefaultOptionFromToolArgs(options, args),
+                    metadata,
+                    agentName: String(message?.sender || '').trim() || null,
+                    toolName: metadataToolName || toolName,
+                    toolCallId: metadataToolCallId || toolCallId,
                 },
             });
-        }, timeoutMs);
-        pendingHitlRequests.set(pendingKey, pending);
-        const event = {
-            messageId: generateId(),
-            timestamp: new Date(),
-            chatId,
-            content: {
-                eventType: 'hitl-option-request',
-                requestId,
-                title: String(request.title || '').trim(),
-                message: String(request.message || '').trim(),
-                options: normalizedOptions,
-                defaultOptionId,
-                timeoutMs,
-                metadata: request.metadata || null,
-            },
-        };
-        world.eventEmitter.emit('system', event);
+        }
+    }
+    return [...unresolvedById.values()];
+}
+export function replayPendingHitlRequests(world, chatId) {
+    const worldId = String(world?.id || '').trim();
+    if (!worldId) {
+        return 0;
+    }
+    const pendingForScope = getSortedPendingRequestsForScope(worldId, chatId);
+    loggerHitl.debug('HITL pending requests replayed', {
+        worldId,
+        chatId: chatId || null,
+        count: pendingForScope.length,
     });
+    for (const pending of pendingForScope) {
+        emitPendingRequest(world, pending);
+    }
+    return pendingForScope.length;
+}
+export function listPendingHitlPromptEvents(world, chatId) {
+    const worldId = String(world?.id || '').trim();
+    if (!worldId) {
+        return [];
+    }
+    const pendingForScope = getSortedPendingRequestsForScope(worldId, chatId);
+    return pendingForScope.map((pending) => ({
+        chatId: pending.chatId,
+        prompt: pending.prompt,
+    }));
 }
 export function submitWorldOptionResponse(params) {
     return submitWorldHitlResponse(params);
@@ -165,18 +404,41 @@ export function submitWorldHitlResponse(params) {
     const requestId = String(params.requestId || '').trim();
     const optionId = String(params.optionId || '').trim();
     if (!worldId || !requestId || !optionId) {
+        loggerHitl.warn('HITL response rejected: invalid payload', {
+            worldId: worldId || null,
+            requestId: requestId || null,
+            optionId: optionId || null,
+        });
         return { accepted: false, reason: 'worldId, requestId, and optionId are required.' };
     }
     const pendingKey = getPendingKey(worldId, requestId);
     const pending = pendingHitlRequests.get(pendingKey);
     if (!pending) {
+        loggerHitl.warn('HITL response rejected: request missing', {
+            worldId,
+            requestId,
+            optionId,
+        });
         return { accepted: false, reason: `No pending HITL request found for requestId '${requestId}'.` };
     }
     const scopeValidation = validateResponseScope(pending, params.chatId);
     if (!scopeValidation.valid) {
+        loggerHitl.warn('HITL response rejected: scope mismatch', {
+            worldId,
+            requestId,
+            optionId,
+            reason: scopeValidation.reason,
+            expectedChatId: pending.chatId,
+            providedChatId: params.chatId ?? null,
+        });
         return { accepted: false, reason: scopeValidation.reason };
     }
     if (!pending.optionIds.has(optionId)) {
+        loggerHitl.warn('HITL response rejected: invalid option', {
+            worldId,
+            requestId,
+            optionId,
+        });
         return { accepted: false, reason: `Invalid option '${optionId}' for requestId '${requestId}'.` };
     }
     resolvePendingRequest({
@@ -190,13 +452,15 @@ export function submitWorldHitlResponse(params) {
             source: 'user',
         },
     });
+    loggerHitl.debug('HITL response accepted', {
+        worldId,
+        chatId: pending.chatId || null,
+        requestId,
+        optionId,
+    });
     return { accepted: true, metadata: pending.metadata };
 }
 export function clearHitlStateForTests() {
-    for (const pending of pendingHitlRequests.values()) {
-        if (pending.timeoutHandle) {
-            clearTimeout(pending.timeoutHandle);
-        }
-    }
     pendingHitlRequests.clear();
+    pendingRequestSequence = 0;
 }

package/dist/core/hitl.js.map

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

package/dist/core/index.d.ts

@@ -18,7 +18,7 @@
  * - Agent Management: getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory
  * - Chat Management: createChatData, getChatData, restoreWorldChat
  * - Event System: publishMessage, enableStreaming, disableStreaming
- * - Core Types: World, Agent, AgentMessage, WorldChat, ChatData, WorldInfo, LLMProvider, LoggerConfig, LogLevel
+ * - Core Types: World, Agent, AgentMessage, ChatData, WorldInfo, LLMProvider, LoggerConfig, LogLevel
  * - Utilities: logger, createCategoryLogger, loggers, generateId, toKebabCase
  * - Subscription System: subscribeWorld, ClientConnection (for server API)
  *
@@ -31,6 +31,7 @@
  * - Internal utilities: initializeLogger, getCategoryLogLevel
  *
  * Recent Changes:
+ * - 2026-03-10: Renamed queue-backed ingress to `enqueueAndProcessUserTurn` and exported explicit `dispatchImmediateChatMessage` for non-user sends.
  * - 2026-02-20: Enforced options-only HITL exports by removing input-mode helpers from public core surface.
  * - 2026-02-14: Exported generic HITL option request/response APIs for world-scoped user approval flows.
  * - 2026-02-14: Exported `waitForInitialSkillSync` to allow callers to await startup skill-registry auto-sync completion.
@@ -39,21 +40,24 @@
  *
  * Version: 3.1.0
  */
-export { createWorld, getWorld, updateWorld, setWorldVariablesText, getWorldVariablesText, getWorldEnvMap, getWorldEnvValue, deleteWorld, listWorlds, getMemory, migrateMessageIds, removeMessagesFrom, editUserMessage, logEditError, getEditErrors } from './managers.js';
+export { createWorld, getWorld, updateWorld, setWorldVariablesText, getWorldVariablesText, getWorldEnvMap, getWorldEnvValue, deleteWorld, listWorlds, getMemory, migrateMessageIds, removeMessagesFrom, editUserMessage, logEditError, getEditErrors, addToQueue, enqueueAndProcessUserTurn, dispatchImmediateChatMessage, recoverQueueSendingMessages, getQueueMessages, removeFromQueue, pauseChatQueue, resumeChatQueue, stopChatQueue, clearChatQueue, retryQueueMessage } from './managers.js';
 export { exportWorldToMarkdown, exportChatToMarkdown, } from './export.js';
 export { createAgent, getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory, } from './managers.js';
 export { clearToolsCache } from './mcp-server-registry.js';
-export { skillRegistry, syncSkills, waitForInitialSkillSync, getSkills, getSkillsForSystemPrompt, getSkill, getSkillSourceScope, clearSkillsForTests, type SkillRegistryEntry, type SkillSourceScope, type SkillScopeFilterOptions, type SyncSkillsOptions, type SyncSkillsResult, } from './skill-registry.js';
-export { requestWorldOption, submitWorldHitlResponse, submitWorldOptionResponse, clearHitlStateForTests, type HitlOption, type HitlOptionRequest, type HitlOptionResolution, type HitlResponseResolution, } from './hitl.js';
+export { skillRegistry, syncSkills, waitForInitialSkillSync, getSkills, getSkillsForSystemPrompt, getSkill, getSkillSourceScope, getSkillSourcePath, clearSkillsForTests, type SkillRegistryEntry, type SkillSourceScope, type SkillScopeFilterOptions, type SyncSkillsOptions, type SyncSkillsResult, } from './skill-registry.js';
+export { requestWorldOption, replayPendingHitlRequests, listPendingHitlPromptEvents, listPendingHitlPromptEventsFromMessages, submitWorldHitlResponse, submitWorldOptionResponse, clearHitlStateForTests, type HitlOption, type HitlOptionRequest, type HitlOptionResolution, type HitlResponseResolution, } from './hitl.js';
 export { executeShellCommand, getExecutionHistory, clearExecutionHistory, stopShellCommandsForChat, getProcessExecution, listProcessExecutions, cancelProcessExecution, deleteProcessExecution, subscribeProcessExecutionStatus, clearProcessExecutionStateForTests, type CommandExecutionResult } from './shell-cmd-tool.js';
 export { stopMessageProcessing, type StopMessageProcessingResult } from './message-processing-control.js';
-export { newChat, branchChatFromMessage, listChats, updateChat, deleteChat, restoreChat } from './managers.js';
+export { isValidCronExpression, startHeartbeat, stopHeartbeat, type HeartbeatHandle, } from './heartbeat.js';
+export { GitHubWorldImportError, stageGitHubWorldFromShorthand, type GitHubWorldImportErrorCode, type ResolvedGitHubWorldSource, type StagedGitHubWorldResult, } from './storage/github-world-import.js';
+export { newChat, branchChatFromMessage, listChats, updateChat, deleteChat, restoreChat, activateChatWithSnapshot } from './managers.js';
 export { enableStreaming, disableStreaming, publishMessage, publishMessageWithId, } from './events/index.js';
-export { beginWorldActivity, trackWorldActivity, getActiveProcessingChatIds, isChatProcessing, type WorldActivityEventPayload, type WorldActivityEventType, } from './activity-tracker.js';
-export { type World, type Agent, type Chat, type AgentMessage, type RemovalResult, type EditErrorLog, LLMProvider, EventType, type LLMResponse } from './types.js';
+export { beginWorldActivity, trackWorldActivity, getActiveProcessingChatIds, getActiveAgentNames, isChatProcessing, type WorldActivityEventPayload, type WorldActivityEventType, } from './activity-tracker.js';
+export { type World, type Agent, type Chat, type AgentMessage, type RemovalResult, type EditErrorLog, type QueuedMessage, type QueueMessageStatus, LLMProvider, EventType, type LLMResponse } from './types.js';
 export { configureLLMProvider, validateProviderConfig, isProviderConfigured, getConfiguredProviders, clearAllConfiguration, getConfigurationStatus, type BaseLLMConfig, type OpenAIConfig, type AnthropicConfig, type GoogleConfig, type AzureConfig, type XAIConfig, type OpenAICompatibleConfig, type OllamaConfig, type ProviderConfigMap, type ProviderConfig, } from './llm-config.js';
 export { type LoggerConfig, type LogLevel, logger, createCategoryLogger, loggers, addLogStreamCallback } from './logger.js';
 export { type ClientConnection, subscribeWorld } from './subscription.js';
+export { createWorldRuntimeKey, startWorldRuntime, getWorldRuntime, releaseWorldRuntime, getWorldRuntimeByKey, listWorldRuntimeSnapshots, stopWorldRuntime, stopWorldRuntimesByWorldId, stopAllWorldRuntimes, type StartedWorldRuntime, type WorldRuntimeSnapshot, type WorldRuntimeStorageContext, } from './world-registry.js';
 export { getDefaultRootPath } from './storage/storage-factory.js';
 export { runMigrations, getMigrationStatus, needsMigration, type MigrationContext, type MigrationFile } from './storage/migration-runner.js';
 export declare const VERSION = "0.5.0";

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

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

package/dist/core/index.js

@@ -18,7 +18,7 @@
  * - Agent Management: getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory
  * - Chat Management: createChatData, getChatData, restoreWorldChat
  * - Event System: publishMessage, enableStreaming, disableStreaming
- * - Core Types: World, Agent, AgentMessage, WorldChat, ChatData, WorldInfo, LLMProvider, LoggerConfig, LogLevel
+ * - Core Types: World, Agent, AgentMessage, ChatData, WorldInfo, LLMProvider, LoggerConfig, LogLevel
  * - Utilities: logger, createCategoryLogger, loggers, generateId, toKebabCase
  * - Subscription System: subscribeWorld, ClientConnection (for server API)
  *
@@ -31,6 +31,7 @@
  * - Internal utilities: initializeLogger, getCategoryLogLevel
  *
  * Recent Changes:
+ * - 2026-03-10: Renamed queue-backed ingress to `enqueueAndProcessUserTurn` and exported explicit `dispatchImmediateChatMessage` for non-user sends.
  * - 2026-02-20: Enforced options-only HITL exports by removing input-mode helpers from public core surface.
  * - 2026-02-14: Exported generic HITL option request/response APIs for world-scoped user approval flows.
  * - 2026-02-14: Exported `waitForInitialSkillSync` to allow callers to await startup skill-registry auto-sync completion.
@@ -40,22 +41,24 @@
  * Version: 3.1.0
  */
 // === WORLD MANAGEMENT ===
-export { createWorld, getWorld, updateWorld, setWorldVariablesText, getWorldVariablesText, getWorldEnvMap, getWorldEnvValue, deleteWorld, listWorlds, getMemory, migrateMessageIds, removeMessagesFrom, editUserMessage, logEditError, getEditErrors } from './managers.js';
+export { createWorld, getWorld, updateWorld, setWorldVariablesText, getWorldVariablesText, getWorldEnvMap, getWorldEnvValue, deleteWorld, listWorlds, getMemory, migrateMessageIds, removeMessagesFrom, editUserMessage, logEditError, getEditErrors, addToQueue, enqueueAndProcessUserTurn, dispatchImmediateChatMessage, recoverQueueSendingMessages, getQueueMessages, removeFromQueue, pauseChatQueue, resumeChatQueue, stopChatQueue, clearChatQueue, retryQueueMessage } from './managers.js';
 export { exportWorldToMarkdown, exportChatToMarkdown, } from './export.js';
 // === AGENT MANAGEMENT ===
 export { createAgent, getAgent, updateAgent, deleteAgent, listAgents, clearAgentMemory, } from './managers.js';
 // === MCP MANAGEMENT ===
 export { clearToolsCache } from './mcp-server-registry.js';
-export { skillRegistry, syncSkills, waitForInitialSkillSync, getSkills, getSkillsForSystemPrompt, getSkill, getSkillSourceScope, clearSkillsForTests, } from './skill-registry.js';
-export { requestWorldOption, submitWorldHitlResponse, submitWorldOptionResponse, clearHitlStateForTests, } from './hitl.js';
+export { skillRegistry, syncSkills, waitForInitialSkillSync, getSkills, getSkillsForSystemPrompt, getSkill, getSkillSourceScope, getSkillSourcePath, clearSkillsForTests, } from './skill-registry.js';
+export { requestWorldOption, replayPendingHitlRequests, listPendingHitlPromptEvents, listPendingHitlPromptEventsFromMessages, submitWorldHitlResponse, submitWorldOptionResponse, clearHitlStateForTests, } from './hitl.js';
 // === SHELL COMMAND TOOL ===
 export { executeShellCommand, getExecutionHistory, clearExecutionHistory, stopShellCommandsForChat, getProcessExecution, listProcessExecutions, cancelProcessExecution, deleteProcessExecution, subscribeProcessExecutionStatus, clearProcessExecutionStateForTests } from './shell-cmd-tool.js';
 export { stopMessageProcessing } from './message-processing-control.js';
+export { isValidCronExpression, startHeartbeat, stopHeartbeat, } from './heartbeat.js';
+export { GitHubWorldImportError, stageGitHubWorldFromShorthand, } from './storage/github-world-import.js';
 // === CHAT MANAGEMENT ===
-export { newChat, branchChatFromMessage, listChats, updateChat, deleteChat, restoreChat } from './managers.js';
+export { newChat, branchChatFromMessage, listChats, updateChat, deleteChat, restoreChat, activateChatWithSnapshot } from './managers.js';
 // === EVENT SYSTEM ===
 export { enableStreaming, disableStreaming, publishMessage, publishMessageWithId, } from './events/index.js';
-export { beginWorldActivity, trackWorldActivity, getActiveProcessingChatIds, isChatProcessing, } from './activity-tracker.js';
+export { beginWorldActivity, trackWorldActivity, getActiveProcessingChatIds, getActiveAgentNames, isChatProcessing, } from './activity-tracker.js';
 // LLM Provider enum (needed for agent configuration)
 export { LLMProvider, EventType } from './types.js';
 // === LLM PROVIDER CONFIGURATION ===
@@ -64,6 +67,7 @@ export { configureLLMProvider, validateProviderConfig, isProviderConfigured, get
 export { logger, createCategoryLogger, loggers, addLogStreamCallback } from './logger.js';
 // === SUBSCRIPTION SYSTEM ===
 export { subscribeWorld } from './subscription.js';
+export { createWorldRuntimeKey, startWorldRuntime, getWorldRuntime, releaseWorldRuntime, getWorldRuntimeByKey, listWorldRuntimeSnapshots, stopWorldRuntime, stopWorldRuntimesByWorldId, stopAllWorldRuntimes, } from './world-registry.js';
 export { getDefaultRootPath } from './storage/storage-factory.js';
 // === MIGRATION SYSTEM (for advanced usage) ===
 export { runMigrations, getMigrationStatus, needsMigration } from './storage/migration-runner.js';