agent-world 0.12.2 → 0.13.0

package/README.md

@@ -355,6 +355,21 @@ HITL options for skill activation:
 - `yes_in_session`: approve this `skill_id` in the current world/chat session
 - `no`: decline
 
+### human_intervention_request (Generic Human Input)
+
+`human_intervention_request` lets the model ask a human question, present options, and optionally require explicit confirmation.
+The tool is options-only (no free-text mode).
+
+Option example:
+
+```json
+{
+  "question": "Choose deployment strategy",
+  "options": ["Blue/Green", "Canary", "Rolling"],
+  "requireConfirmation": true
+}
+```
+
 ## Experimental Features
 
 - **MCP Support** - *Currently in experiment* - Model Context Protocol integration for tools like search and code execution. e.g.,

package/dist/cli/hitl.d.ts

@@ -11,9 +11,10 @@
  *
  * Implementation Notes:
  * - Parser accepts generic event payloads and rejects incomplete requests.
- * - Fallback defaults to explicit `no` when available, otherwise first option.
+ * - Option fallback defaults to explicit `no` when available, otherwise first option.
  *
  * Recent Changes:
+ * - 2026-02-20: Enforced options-only HITL parsing in CLI helpers.
  * - 2026-02-14: Added initial helper module for CLI HITL response flow support.
  */
 export interface HitlOptionPayload {
@@ -26,8 +27,11 @@ export interface HitlOptionRequestPayload {
     title: string;
     message: string;
     chatId: string | null;
+    mode: 'option';
     options: HitlOptionPayload[];
     defaultOptionId: string;
 }
+export type HitlPromptRequestPayload = HitlOptionRequestPayload;
+export declare function parseHitlPromptRequest(eventData: unknown): HitlPromptRequestPayload | null;
 export declare function parseHitlOptionRequest(eventData: unknown): HitlOptionRequestPayload | null;
 export declare function resolveHitlOptionSelectionInput(options: HitlOptionPayload[], rawInput: string, fallbackOptionId: string): string | null;

package/dist/cli/hitl.js

@@ -11,12 +11,13 @@
  *
  * Implementation Notes:
  * - Parser accepts generic event payloads and rejects incomplete requests.
- * - Fallback defaults to explicit `no` when available, otherwise first option.
+ * - Option fallback defaults to explicit `no` when available, otherwise first option.
  *
  * Recent Changes:
+ * - 2026-02-20: Enforced options-only HITL parsing in CLI helpers.
  * - 2026-02-14: Added initial helper module for CLI HITL response flow support.
  */
-export function parseHitlOptionRequest(eventData) {
+export function parseHitlPromptRequest(eventData) {
     if (!eventData || typeof eventData !== 'object') {
         return null;
     }
@@ -24,7 +25,8 @@ export function parseHitlOptionRequest(eventData) {
     const content = payload.content && typeof payload.content === 'object'
         ? payload.content
         : null;
-    if (!content || String(content.eventType || '').trim() !== 'hitl-option-request') {
+    const eventType = String(content?.eventType || '').trim();
+    if (!content || eventType !== 'hitl-option-request') {
         return null;
     }
     const requestId = String(content.requestId || '').trim();
@@ -57,10 +59,14 @@ export function parseHitlOptionRequest(eventData) {
         title: String(content.title || 'Approval required').trim() || 'Approval required',
         message: String(content.message || '').trim(),
         chatId: payload.chatId ? String(payload.chatId) : null,
+        mode: 'option',
         options,
         defaultOptionId
     };
 }
+export function parseHitlOptionRequest(eventData) {
+    return parseHitlPromptRequest(eventData);
+}
 export function resolveHitlOptionSelectionInput(options, rawInput, fallbackOptionId) {
     const normalizedInput = String(rawInput || '').trim();
     if (!normalizedInput) {

package/dist/cli/index.js

@@ -13,6 +13,7 @@
  * - Work with loaded world without importing (uses external storage path)
  *
  * Changes:
+ * - 2026-02-20: Enforced options-only HITL handling in interactive and pipeline modes.
  * - 2026-02-14: Added interactive + pipeline HITL option response handling for generic approval requests.
  * - 2026-02-11: Fixed tool-stream timeout: extendTimeout() resets idle timeout on streaming data
  * - 2026-02-11: Pipeline mode now listens for tool-stream SSE events to extend timeout
@@ -76,14 +77,14 @@ import path from 'path';
 import { fileURLToPath } from 'url';
 import { program } from 'commander';
 import readline from 'readline';
-import { listWorlds, subscribeWorld, submitWorldOptionResponse, createCategoryLogger, LLMProvider, enableStreaming, disableStreaming } from '../core/index.js';
+import { listWorlds, subscribeWorld, submitWorldHitlResponse, createCategoryLogger, LLMProvider, enableStreaming, disableStreaming } from '../core/index.js';
 import { EventType } from '../core/types.js';
 import { getDefaultRootPath } from '../core/storage/storage-factory.js';
 import { processCLIInput, displayChatMessages } from './commands.js';
 import { createStreamingState, handleWorldEventWithStreaming, handleToolEvents, } from './stream.js';
 import { configureLLMProvider } from '../core/llm-config.js';
 import { createStatusLineManager, log as statusLog, } from './display.js';
-import { parseHitlOptionRequest, resolveHitlOptionSelectionInput, } from './hitl.js';
+import { parseHitlPromptRequest, resolveHitlOptionSelectionInput, } from './hitl.js';
 // Create CLI category logger after logger auto-initialization
 const logger = createCategoryLogger('cli');
 function createGlobalState() {
@@ -456,18 +457,18 @@ function attachCLIListeners(world, streaming, globalState, activityMonitor, stat
     }
     // System events
     const systemListener = (eventData) => {
-        const hitlRequest = parseHitlOptionRequest(eventData);
+        const hitlRequest = parseHitlPromptRequest(eventData);
         if (hitlRequest) {
             hitlPromptChain = hitlPromptChain
                 .then(async () => {
                 if (streaming && globalState && rl && statusLine) {
                     globalState.hitlPromptActive = true;
                     try {
-                        const selectedOptionId = await promptHitlOptionSelection(hitlRequest, statusLine, rl);
-                        const result = submitWorldOptionResponse({
+                        const result = submitWorldHitlResponse({
                             worldId: world.id,
                             requestId: hitlRequest.requestId,
-                            optionId: selectedOptionId
+                            optionId: await promptHitlOptionSelection(hitlRequest, statusLine, rl),
+                            chatId: hitlRequest.chatId,
                         });
                         if (!result.accepted) {
                             statusLine.pause();
@@ -476,7 +477,7 @@ function attachCLIListeners(world, streaming, globalState, activityMonitor, stat
                             return;
                         }
                         statusLine.pause();
-                        console.log(green(`Approved option: ${selectedOptionId}`));
+                        console.log(green('Submitted HITL option response.'));
                         statusLine.resume();
                         return;
                     }
@@ -485,10 +486,11 @@ function attachCLIListeners(world, streaming, globalState, activityMonitor, stat
                     }
                 }
                 // Pipeline/non-interactive mode: auto-respond with default option to avoid blocking.
-                const result = submitWorldOptionResponse({
+                const result = submitWorldHitlResponse({
                     worldId: world.id,
                     requestId: hitlRequest.requestId,
-                    optionId: hitlRequest.defaultOptionId
+                    optionId: hitlRequest.defaultOptionId,
+                    chatId: hitlRequest.chatId,
                 });
                 if (!result.accepted) {
                     console.error(boldRed(`Failed to auto-respond HITL request: ${result.reason || 'unknown error'}`));

package/dist/core/activity-tracker.d.ts

@@ -8,8 +8,18 @@ export interface WorldActivityEventPayload {
     timestamp: string;
     source?: string;
     activeSources: string[];
+    activeChatIds: string[];
     queue: ReturnType<typeof getLLMQueueStatus>;
     messageId: string;
 }
-export declare function beginWorldActivity(world: World, source?: string): () => void;
-export declare function trackWorldActivity<T>(world: World, operation: () => Promise<T>, source?: string): Promise<T>;
+export declare function beginWorldActivity(world: World, source?: string, chatId?: string): () => void;
+/**
+ * Returns the set of chatIds currently being actively processed in this world.
+ * Useful for parallel-chat monitoring and targeted mutation guards.
+ */
+export declare function getActiveProcessingChatIds(world: World): ReadonlySet<string>;
+/**
+ * Returns true if the given chatId has at least one active processing operation.
+ */
+export declare function isChatProcessing(world: World, chatId: string): boolean;
+export declare function trackWorldActivity<T>(world: World, operation: () => Promise<T>, source?: string, chatId?: string): Promise<T>;

package/dist/core/activity-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"activity-tracker.d.ts","sourceRoot":"","sources":["../../core/activity-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AASrD,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AA8CD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CA0C5E;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAcZ"}
+{"version":3,"file":"activity-tracker.d.ts","sourceRoot":"","sources":["../../core/activity-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAUrD,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,cAAc,GAAG,MAAM,CAAC;AAEhF,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;IAC5C,SAAS,EAAE,MAAM,CAAC;CACnB;AAiDD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,IAAI,CAyD7F;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAAC,MAAM,CAAC,CAI5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAItE;AAED,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/core/activity-tracker.js

@@ -11,19 +11,22 @@ function getActivityState(world) {
     const initial = {
         pendingOperations: 0,
         lastActivityId: 0,
-        activeSources: new Map()
+        activeSources: new Map(),
+        activeChatOps: new Map()
     };
     world[stateKey] = initial;
     return initial;
 }
 function emitActivityEvent(world, type, pendingOperations, activityId, source) {
+    const activityState = getActivityState(world);
     const payload = {
         type,
         pendingOperations,
         activityId,
         timestamp: new Date().toISOString(),
         source,
-        activeSources: Array.from(getActivityState(world).activeSources.keys()),
+        activeSources: Array.from(activityState.activeSources.keys()),
+        activeChatIds: Array.from(activityState.activeChatOps.keys()),
         queue: getLLMQueueStatus(),
         messageId: nanoid(10) // Generate unique ID for event persistence
     };
@@ -33,12 +36,16 @@ function emitActivityEvent(world, type, pendingOperations, activityId, source) {
     world.eventEmitter.emit('world', payload);
     world.eventEmitter.emit(type, payload);
 }
-export function beginWorldActivity(world, source) {
+export function beginWorldActivity(world, source, chatId) {
     const activityState = getActivityState(world);
     activityState.pendingOperations += 1;
     if (source) {
         activityState.activeSources.set(source, (activityState.activeSources.get(source) ?? 0) + 1);
     }
+    // Track chat-level operation counts for parallel-chat visibility
+    if (chatId) {
+        activityState.activeChatOps.set(chatId, (activityState.activeChatOps.get(chatId) ?? 0) + 1);
+    }
     // Increment activityId when starting first operation
     if (activityState.pendingOperations === 1) {
         activityState.lastActivityId += 1;
@@ -62,6 +69,16 @@ export function beginWorldActivity(world, source) {
                 state.activeSources.set(source, currentCount - 1);
             }
         }
+        // Decrement chat-level operation count
+        if (chatId) {
+            const chatCount = state.activeChatOps.get(chatId) ?? 0;
+            if (chatCount <= 1) {
+                state.activeChatOps.delete(chatId);
+            }
+            else {
+                state.activeChatOps.set(chatId, chatCount - 1);
+            }
+        }
         // Emit idle when all operations complete, otherwise response-end
         if (state.pendingOperations === 0) {
             emitActivityEvent(world, 'idle', 0, currentActivityId, source);
@@ -71,8 +88,27 @@ export function beginWorldActivity(world, source) {
         }
     };
 }
-export async function trackWorldActivity(world, operation, source) {
-    const end = beginWorldActivity(world, source);
+/**
+ * Returns the set of chatIds currently being actively processed in this world.
+ * Useful for parallel-chat monitoring and targeted mutation guards.
+ */
+export function getActiveProcessingChatIds(world) {
+    const state = world[stateKey];
+    if (!state)
+        return new Set();
+    return new Set(state.activeChatOps.keys());
+}
+/**
+ * Returns true if the given chatId has at least one active processing operation.
+ */
+export function isChatProcessing(world, chatId) {
+    const state = world[stateKey];
+    if (!state)
+        return false;
+    return (state.activeChatOps.get(chatId) ?? 0) > 0;
+}
+export async function trackWorldActivity(world, operation, source, chatId) {
+    const end = beginWorldActivity(world, source, chatId);
     try {
         return await operation();
     }

package/dist/core/activity-tracker.js.map

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

package/dist/core/create-agent-tool.d.ts

@@ -1,40 +1,38 @@
 /**
- * Create Agent Tool Module - Built-in tool for approval-gated agent creation.
+ * Create Agent Tool Module - Built-in tool for approval-gated agent creation
  *
  * Purpose:
- * - Provide a deterministic `create_agent` built-in tool that creates agents after explicit user approval.
+ * - Expose a built-in `create_agent` tool that creates one new agent after explicit user approval.
  *
  * Key Features:
- * - Requires `name` and supports optional `autoReply`, `role`, and `nextAgent` arguments.
- * - Enforces a mandatory HITL approval check before creating any agent.
- * - Inherits provider/model from world-level `chatLLMProvider` / `chatLLMModel` when configured.
- * - Generates a stable system prompt template for new agents.
- * - Returns structured JSON payloads for success, denial, and error outcomes.
+ * - Requires `name` and supports optional `autoReply`, `role`, and `nextAgent` inputs.
+ * - Enforces HITL approval with deterministic deny/timeout handling before persistence.
+ * - Generates deterministic system prompt text for multi-agent routing.
+ * - Uses world-level chat provider/model settings with deterministic fallbacks.
  *
- * Notes on Implementation:
- * - Uses `requestWorldOption` for approval (no custom approval protocol).
- * - Uses core `createAgent` manager API to preserve existing persistence and CRUD event behavior.
- * - Applies deterministic defaults when world-level provider/model are not configured.
+ * Implementation Notes:
+ * - Uses manager-level `createAgent` as the persistence boundary.
+ * - Returns deterministic JSON-string payloads for success, denial, and errors.
+ * - Keeps runtime contract canonical (`autoReply`, `nextAgent`) while aliases are handled upstream.
  *
  * Recent Changes:
- * - 2026-02-19: Initial implementation of approval-gated `create_agent` built-in tool.
+ * - 2026-02-20: Added post-create HITL informational confirmation (`Agent <name> has been created`) with `refreshAfterDismiss` metadata set to true.
+ * - 2026-02-20: Pre-claim agent creation slot before approval dialog to prevent parallel-call race where both calls pass approval before either calls createAgent.
+ * - 2026-02-20: Updated tool create path to allow manager-level create during the current in-flight world processing turn.
+ * - 2026-02-20: Updated `create_agent` default behavior so omitted `autoReply` resolves to `false`.
+ * - 2026-02-20: Added initial built-in `create_agent` tool implementation with mandatory approval gate.
  */
+import { type World } from './types.js';
+type CreateAgentToolArgs = {
+    name?: unknown;
+    autoReply?: unknown;
+    role?: unknown;
+    nextAgent?: unknown;
+};
 type CreateAgentToolContext = {
-    world?: {
-        id?: string;
-        currentChatId?: string | null;
-        chatLLMProvider?: string | null;
-        chatLLMModel?: string | null;
-        eventEmitter?: unknown;
-    } | null;
+    world?: World;
     chatId?: string | null;
 };
-type CreateAgentToolArgs = {
-    name: string;
-    autoReply?: boolean;
-    role?: string;
-    nextAgent?: string;
-};
 export declare function createCreateAgentToolDefinition(): {
     description: string;
     parameters: {

package/dist/core/create-agent-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-agent-tool.d.ts","sourceRoot":"","sources":["../../core/create-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAcH,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAwEF,wBAAgB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;oBA2BrB,mBAAmB,gBAAgB,MAAM,oBAAoB,MAAM,YAAY,sBAAsB;EAmG9H"}
+{"version":3,"file":"create-agent-tool.d.ts","sourceRoot":"","sources":["../../core/create-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH,OAAO,EAAkD,KAAK,KAAK,EAAE,MAAM,YAAY,CAAC;AAUxF,KAAK,mBAAmB,GAAG;IACzB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAkKF,wBAAgB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;oBA2BrB,mBAAmB,gBAAgB,MAAM,oBAAoB,MAAM,YAAY,sBAAsB;EAwJ9H"}