agent-world 0.13.0 → 0.15.0

package/dist/core/hitl-tool.js

@@ -2,12 +2,11 @@
  * HITL Request Tool Module - Built-in tool for generic human-in-the-loop input
  *
  * Purpose:
- * - Expose a built-in `human_intervention_request` tool that lets the model ask questions, offer options, and require explicit confirmation.
+ * - Expose a built-in `human_intervention_request` tool that lets the model ask questions and offer options.
  *
  * Key Features:
  * - Supports option-only response mode for deterministic user selection.
  * - Uses existing world-scoped HITL option runtime.
- * - Supports explicit confirmation/cancel flow with deterministic timeout behavior.
  * - Returns structured JSON payloads for stable downstream model parsing.
  *
  * Implementation Notes:
@@ -16,14 +15,15 @@
  * - Tool execution requires world context; no external side effects beyond HITL events.
  *
  * Recent Changes:
+ * - 2026-03-06: Removed `world.currentChatId` fallback from HITL approval routing; interactive requests now require explicit `context.chatId`.
+ * - 2026-02-28: Added shorthand default-option resolution so values like "No" can map to a single matching option label.
+ * - 2026-02-27: Removed built-in post-selection confirmation stage and removed deprecated confirmation parameters from the tool contract.
  * - 2026-02-20: Removed free-text mode from `human_intervention_request`; tool now enforces options-only interactions.
  * - 2026-02-20: Added initial built-in `human_intervention_request` tool implementation.
  */
 import { requestWorldOption } from './hitl.js';
 const MODE_OPTION = 'option';
-const CONFIRM_OPTION_ID = 'confirm';
-const CANCEL_OPTION_ID = 'cancel';
-const DEFAULT_TIMEOUT_MESSAGE = 'HITL request timed out before user confirmation.';
+const DEFAULT_TIMEOUT_MESSAGE = 'HITL request timed out before user selection.';
 function stringifyResult(payload) {
     return JSON.stringify(payload);
 }
@@ -60,18 +60,42 @@ function normalizeTimeoutMs(value) {
     }
     return Math.floor(parsed);
 }
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function resolveDefaultOptionLabel(options, defaultOption) {
+    const normalizedDefaultOption = defaultOption.trim().toLowerCase();
+    if (!normalizedDefaultOption) {
+        return { matchedOption: null, error: null };
+    }
+    const explicitMatch = options.find((option) => option.toLowerCase() === normalizedDefaultOption);
+    if (explicitMatch) {
+        return { matchedOption: explicitMatch, error: null };
+    }
+    const shorthandPattern = new RegExp(`^${escapeRegExp(normalizedDefaultOption)}(?:\\b|[\\s,;:()\\-])`, 'i');
+    const shorthandMatches = options.filter((option) => shorthandPattern.test(option));
+    if (shorthandMatches.length === 1) {
+        return { matchedOption: shorthandMatches[0], error: null };
+    }
+    if (shorthandMatches.length > 1) {
+        return {
+            matchedOption: null,
+            error: `defaultOption '${defaultOption}' is ambiguous across provided options.`,
+        };
+    }
+    return {
+        matchedOption: null,
+        error: `defaultOption '${defaultOption}' does not match any provided option.`,
+    };
+}
 function validateAndNormalizeArgs(args) {
     const question = normalizeQuestion(args.question);
     if (!question) {
         return { valid: false, error: 'Missing required parameter: question' };
     }
     const options = normalizeOptionList(args.options);
-    const requireConfirmation = args.requireConfirmation === true;
-    const confirmationMessage = typeof args.confirmationMessage === 'string' && args.confirmationMessage.trim()
-        ? args.confirmationMessage.trim()
-        : null;
     const timeoutMs = normalizeTimeoutMs(args.timeoutMs);
-    const defaultOption = typeof args.defaultOption === 'string' && args.defaultOption.trim()
+    const rawDefaultOption = typeof args.defaultOption === 'string' && args.defaultOption.trim()
         ? args.defaultOption.trim()
         : null;
     const metadata = args.metadata && typeof args.metadata === 'object'
@@ -83,24 +107,22 @@ function validateAndNormalizeArgs(args) {
             error: 'HITL request requires at least one option.',
         };
     }
-    if (defaultOption && options.length > 0) {
-        const hasDefaultOption = options.some((option) => option.toLowerCase() === defaultOption.toLowerCase());
-        if (!hasDefaultOption) {
-            return {
-                valid: false,
-                error: `defaultOption '${defaultOption}' does not match any provided option.`,
-            };
-        }
+    const resolvedDefaultOption = rawDefaultOption
+        ? resolveDefaultOptionLabel(options, rawDefaultOption)
+        : { matchedOption: null, error: null };
+    if (resolvedDefaultOption.error) {
+        return {
+            valid: false,
+            error: resolvedDefaultOption.error,
+        };
     }
     return {
         valid: true,
         args: {
             question,
             options,
-            requireConfirmation,
-            confirmationMessage,
             timeoutMs,
-            defaultOption,
+            defaultOption: resolvedDefaultOption.matchedOption,
             metadata,
         },
     };
@@ -119,7 +141,7 @@ function buildOptionPromptOptions(optionLabels) {
     }));
 }
 async function requestPrimaryResolution(options) {
-    const { world, chatId, args } = options;
+    const { world, chatId, args, agentName } = options;
     const promptOptions = buildOptionPromptOptions(args.options);
     const optionResolution = await requestWorldOption(world, {
         title: 'Human input required',
@@ -132,7 +154,11 @@ async function requestPrimaryResolution(options) {
             ...(args.metadata || {}),
             tool: 'human_intervention_request',
             mode: MODE_OPTION,
+            ...(typeof options.toolCallId === 'string' && options.toolCallId.trim()
+                ? { toolCallId: options.toolCallId.trim() }
+                : {}),
         },
+        agentName: agentName || null,
     });
     const selectedOption = promptOptions.find((option) => option.id === optionResolution.optionId)?.label || null;
     return {
@@ -141,38 +167,6 @@ async function requestPrimaryResolution(options) {
         source: optionResolution.source,
     };
 }
-function buildConfirmationSummary(resolution) {
-    return `Selected option: ${resolution.selectedOption ?? ''}`;
-}
-async function requestConfirmation(options) {
-    const confirmation = await requestWorldOption(options.world, {
-        title: 'Confirm response',
-        message: [
-            options.question,
-            '',
-            buildConfirmationSummary(options.resolution),
-            '',
-            options.confirmationMessage || 'Please confirm to continue.',
-        ].join('\n'),
-        chatId: options.chatId,
-        timeoutMs: options.timeoutMs ?? undefined,
-        defaultOptionId: CANCEL_OPTION_ID,
-        options: [
-            { id: CONFIRM_OPTION_ID, label: 'Confirm', description: 'Use this response and continue.' },
-            { id: CANCEL_OPTION_ID, label: 'Cancel', description: 'Cancel this HITL request.' },
-        ],
-        metadata: {
-            ...(options.metadata || {}),
-            tool: 'human_intervention_request',
-            mode: 'confirmation',
-            requestId: options.resolution.requestId,
-        },
-    });
-    if (confirmation.optionId === CONFIRM_OPTION_ID) {
-        return { confirmed: true, source: confirmation.source };
-    }
-    return { confirmed: false, source: confirmation.source };
-}
 function buildFinalResult(options) {
     const ok = options.status === 'confirmed';
     return stringifyResult({
@@ -187,7 +181,7 @@ function buildFinalResult(options) {
 }
 export function createHitlToolDefinition() {
     return {
-        description: 'Ask a human a question, offer choices, and optionally require confirmation before returning the result.',
+        description: 'Ask a human a question and offer choices; returns after a single option selection.',
         parameters: {
             type: 'object',
             properties: {
@@ -200,14 +194,6 @@ export function createHitlToolDefinition() {
                     items: { type: 'string' },
                     description: 'Required list of selectable options.',
                 },
-                requireConfirmation: {
-                    type: 'boolean',
-                    description: 'When true, human must explicitly confirm before completion.',
-                },
-                confirmationMessage: {
-                    type: 'string',
-                    description: 'Optional extra text shown in confirmation prompt.',
-                },
                 timeoutMs: {
                     type: 'number',
                     description: 'Optional timeout for HITL prompts in milliseconds.',
@@ -247,36 +233,28 @@ export function createHitlToolDefinition() {
                     message: 'human_intervention_request requires a valid world context.',
                 });
             }
-            const chatId = context?.chatId ?? world.currentChatId ?? null;
+            const chatId = typeof context?.chatId === 'string' && context.chatId.trim()
+                ? context.chatId.trim()
+                : null;
+            const agentName = context?.agentName || null;
+            if (!chatId) {
+                return buildFinalResult({
+                    requestId: '',
+                    selectedOption: null,
+                    status: 'error',
+                    source: 'system',
+                    message: 'human_intervention_request requires an explicit chatId in the tool execution context.',
+                });
+            }
             try {
                 const primaryResolution = await requestPrimaryResolution({
                     world,
                     chatId,
                     args: normalized.args,
+                    agentName,
+                    toolCallId: context.toolCallId,
                 });
-                if (normalized.args.requireConfirmation) {
-                    const confirmation = await requestConfirmation({
-                        world,
-                        chatId,
-                        question: normalized.args.question,
-                        resolution: primaryResolution,
-                        timeoutMs: normalized.args.timeoutMs,
-                        confirmationMessage: normalized.args.confirmationMessage,
-                        metadata: normalized.args.metadata,
-                    });
-                    if (!confirmation.confirmed) {
-                        return buildFinalResult({
-                            requestId: primaryResolution.requestId,
-                            selectedOption: primaryResolution.selectedOption,
-                            status: confirmation.source === 'timeout' ? 'timeout' : 'canceled',
-                            source: confirmation.source,
-                            message: confirmation.source === 'timeout'
-                                ? DEFAULT_TIMEOUT_MESSAGE
-                                : 'HITL request was canceled.',
-                        });
-                    }
-                }
-                else if (primaryResolution.source === 'timeout') {
+                if (primaryResolution.source === 'timeout') {
                     return buildFinalResult({
                         requestId: primaryResolution.requestId,
                         selectedOption: primaryResolution.selectedOption,
@@ -289,7 +267,7 @@ export function createHitlToolDefinition() {
                     requestId: primaryResolution.requestId,
                     selectedOption: primaryResolution.selectedOption,
                     status: 'confirmed',
-                    source: 'user',
+                    source: primaryResolution.source,
                 });
             }
             catch (error) {

package/dist/core/hitl-tool.js.map

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

package/dist/core/hitl.d.ts

@@ -5,21 +5,28 @@
  * - 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 { type World } from './types.js';
+import { type AgentMessage, type World } from './types.js';
 export interface HitlOption {
     id: string;
     label: string;
@@ -34,6 +41,7 @@ export interface HitlOptionRequest {
     timeoutMs?: number;
     defaultOptionId?: string;
     metadata?: Record<string, unknown>;
+    agentName?: string | null;
 }
 export interface HitlOptionResolution {
     requestId: string;
@@ -49,7 +57,55 @@ export type HitlResponseResolution = {
     optionId: string;
     source: 'user' | 'timeout';
 };
+interface PendingHitlOptionRequest {
+    worldId: string;
+    requestId: string;
+    chatId: string | null;
+    optionIds: Set<string>;
+    sequence: number;
+    prompt: {
+        requestId: string;
+        title: string;
+        message: string;
+        options: HitlOption[];
+        defaultOptionId: string;
+        metadata: Record<string, unknown> | null;
+        agentName: string | null;
+        toolName: string;
+        toolCallId: string;
+    };
+    metadata: Record<string, unknown> | null;
+    resolve: (resolution: HitlResponseResolution) => void;
+}
+/**
+ * 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 declare function clearPendingHitlRequestsForChat(worldId: string, chatId: string | null): void;
 export declare function requestWorldOption(world: World, request: HitlOptionRequest): Promise<HitlOptionResolution>;
+export declare function listPendingHitlPromptEventsFromMessages(messages: AgentMessage[], chatId?: string | null): Array<{
+    chatId: string | null;
+    prompt: {
+        requestId: string;
+        title: string;
+        message: string;
+        options: Array<{
+            id: string;
+            label: string;
+        }>;
+        defaultOptionId: string;
+        metadata: Record<string, unknown> | null;
+        agentName: string | null;
+        toolName: string;
+        toolCallId: string;
+    };
+}>;
+export declare function replayPendingHitlRequests(world: World, chatId?: string | null): number;
+export declare function listPendingHitlPromptEvents(world: World, chatId?: string | null): Array<{
+    chatId: string | null;
+    prompt: PendingHitlOptionRequest['prompt'];
+}>;
 export declare function submitWorldOptionResponse(params: {
     worldId: string;
     requestId: string;
@@ -71,3 +127,4 @@ export declare function submitWorldHitlResponse(params: {
     metadata?: Record<string, unknown> | null;
 };
 export declare function clearHitlStateForTests(): void;
+export {};

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

@@ -1 +1 @@
-{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../core/hitl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,KAAK,KAAK,EAAyB,MAAM,YAAY,CAAC;AAG/D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B;AAED,MAAM,MAAM,sBAAsB,GAAG;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B,CAAC;AAqGF,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,KAAK,EACZ,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CA0E/B;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAEpF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;CAAE,CAqCpF;AAED,wBAAgB,sBAAsB,IAAI,IAAI,CAO7C"}
+{"version":3,"file":"hitl.d.ts","sourceRoot":"","sources":["../../core/hitl.ts"],"names":[],"mappings":"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"}