@promptbook/core 0.112.0-12 → 0.112.0-13

package/esm/src/commitments/USE_BROWSER/resolveRunBrowserToolForNode.d.ts

@@ -2,7 +2,7 @@ import type { ToolFunction } from '../../_packages/types.index';
 /**
  * Resolves the server-side implementation of the `run_browser` tool for Node.js environments.
  *
- * This uses lazy `require` to keep the core package decoupled from Agents Server internals.
+ * This uses fully lazy resolution to keep CLI startup independent from optional browser tooling.
  * When the server tool cannot be resolved, the fallback implementation throws a helpful error.
  *
  * @private internal utility for USE BROWSER commitment

package/esm/src/commitments/USE_TIMEOUT/TimeoutToolNames.d.ts

@@ -6,4 +6,5 @@
 export declare const TimeoutToolNames: {
     readonly set: string;
     readonly cancel: string;
+    readonly list: string;
 };

package/esm/src/commitments/USE_TIMEOUT/TimeoutToolRuntimeAdapter.d.ts

@@ -18,6 +18,16 @@ export type CancelTimeoutToolArgs = {
     timeoutId?: string;
     [key: string]: TODO_any;
 };
+/**
+ * Tool arguments for listing scoped timeouts.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type ListTimeoutsToolArgs = {
+    includeFinished?: boolean;
+    limit?: number;
+    [key: string]: TODO_any;
+};
 /**
  * Runtime context available to `USE TIMEOUT` tools.
  *
@@ -31,6 +41,26 @@ export type TimeoutToolRuntimeContext = {
     readonly agentName?: string;
     readonly promptParameters: Record<string, string>;
 };
+/**
+ * Lifecycle status exposed by `list_timeouts`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolListItemStatus = 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'CANCELLED';
+/**
+ * One timeout row exposed by `list_timeouts`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type TimeoutToolListItem = {
+    timeoutId: string;
+    chatId: string;
+    status: TimeoutToolListItemStatus;
+    dueAt: string;
+    paused: boolean;
+    message?: string | null;
+    recurrenceIntervalMs?: number | null;
+};
 /**
  * Result payload returned by `set_timeout`.
  *
@@ -55,18 +85,30 @@ export type CancelTimeoutToolResult = {
     dueAt?: string;
     message?: string;
 };
+/**
+ * Result payload returned by `list_timeouts`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type ListTimeoutsToolResult = {
+    action: 'list';
+    status: 'listed' | 'disabled' | 'error';
+    items?: Array<TimeoutToolListItem>;
+    total?: number;
+    message?: string;
+};
 /**
  * Union of all `USE TIMEOUT` tool actions.
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'];
+export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'] | ListTimeoutsToolResult['action'];
 /**
  * Union of all `USE TIMEOUT` tool results.
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult;
+export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult | ListTimeoutsToolResult;
 /**
  * Runtime adapter used by `USE TIMEOUT` tools.
  *
@@ -87,4 +129,11 @@ export type TimeoutToolRuntimeAdapter = {
         dueAt?: string;
         status: 'cancelled' | 'not_found';
     }>;
+    listTimeouts(args: {
+        includeFinished: boolean;
+        limit: number;
+    }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
+        items: Array<TimeoutToolListItem>;
+        total: number;
+    }>;
 };

package/esm/src/commitments/USE_TIMEOUT/USE_TIMEOUT.d.ts

@@ -3,11 +3,11 @@ import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentMo
 import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 export { setTimeoutToolRuntimeAdapter } from './setTimeoutToolRuntimeAdapter';
-export type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
+export type { CancelTimeoutToolResult, ListTimeoutsToolResult, SetTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
 /**
  * `USE TIMEOUT` commitment definition.
  *
- * The `USE TIMEOUT` commitment enables thread-scoped timers that wake the same chat later.
+ * The `USE TIMEOUT` commitment enables timeout wake-ups and scoped timeout management.
  *
  * @private [🪔] Maybe export the commitments through some package
  */

package/esm/src/commitments/USE_TIMEOUT/getTimeoutToolRuntimeAdapterOrDisabledResult.d.ts

@@ -1,4 +1,4 @@
-import type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolAction, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext } from './TimeoutToolRuntimeAdapter';
+import type { TimeoutToolAction, TimeoutToolResult, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext } from './TimeoutToolRuntimeAdapter';
 /**
  * Return type of timeout adapter resolution helper.
  *
@@ -6,7 +6,7 @@ import type { CancelTimeoutToolResult, SetTimeoutToolResult, TimeoutToolAction,
  */
 type TimeoutToolRuntimeAdapterResolution = {
     adapter: TimeoutToolRuntimeAdapter | null;
-    disabledResult: SetTimeoutToolResult | CancelTimeoutToolResult | null;
+    disabledResult: TimeoutToolResult | null;
 };
 /**
  * Resolves the runtime adapter for timeout tools or returns disabled payload when unavailable.

package/esm/src/commitments/USE_TIMEOUT/parseTimeoutToolArgs.d.ts

@@ -1,4 +1,4 @@
-import type { CancelTimeoutToolArgs, SetTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
+import type { CancelTimeoutToolArgs, ListTimeoutsToolArgs, SetTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
 /**
  * Parsed arguments for `set_timeout`.
  *
@@ -16,6 +16,15 @@ type ParsedSetTimeoutToolArgs = {
 type ParsedCancelTimeoutToolArgs = {
     timeoutId: string;
 };
+/**
+ * Parsed arguments for `list_timeouts`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedListTimeoutsToolArgs = {
+    includeFinished: boolean;
+    limit: number;
+};
 /**
  * Parses and validates `USE TIMEOUT` tool arguments.
  *
@@ -30,5 +39,9 @@ export declare const parseTimeoutToolArgs: {
      * Parses `cancel_timeout` input.
      */
     cancel(args: CancelTimeoutToolArgs): ParsedCancelTimeoutToolArgs;
+    /**
+     * Parses `list_timeouts` input.
+     */
+    list(args: ListTimeoutsToolArgs): ParsedListTimeoutsToolArgs;
 };
 export {};

package/esm/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-11`).
+ * It follows semantic versioning (e.g., `0.112.0-12`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/core",
-    "version": "0.112.0-12",
+    "version": "0.112.0-13",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -28,7 +28,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-12';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-13';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -19795,9 +19795,9 @@
         return spaceTrim$1.spaceTrim((block) => `
             Timeout scheduling:
             - Use "set_timeout" to wake this same chat thread in the future.
-            - Timers are thread-scoped, not global for the whole agent.
+            - Use "list_timeouts" to review timeouts across all chats for the same user+agent scope.
+            - "cancel_timeout" accepts a timeout id from any chat in this same user+agent scope.
             - When one timeout elapses, you will receive a new user-like message that explicitly says it is a timeout wake-up and includes the \`timeoutId\`.
-            - Use "cancel_timeout" when a previously scheduled timeout is no longer relevant.
             - Do not claim a timer was set or cancelled unless the tool confirms it.
             ${block(extraInstructions)}
         `);
@@ -19858,13 +19858,6 @@
      * @private internal utility of USE TIMEOUT
      */
     function createDisabledTimeoutResult(action, message) {
-        if (action === 'set') {
-            return {
-                action,
-                status: 'disabled',
-                message,
-            };
-        }
         return {
             action,
             status: 'disabled',
@@ -19891,6 +19884,18 @@
         }
     }
 
+    /**
+     * Default number of rows returned by `list_timeouts`.
+     *
+     * @private internal USE TIMEOUT constant
+     */
+    const DEFAULT_LIST_TIMEOUTS_LIMIT = 20;
+    /**
+     * Hard cap for `list_timeouts` page size.
+     *
+     * @private internal USE TIMEOUT constant
+     */
+    const MAX_LIST_TIMEOUTS_LIMIT = 100;
     /**
      * Parses and validates `USE TIMEOUT` tool arguments.
      *
@@ -19925,6 +19930,31 @@
             }
             return { timeoutId };
         },
+        /**
+         * Parses `list_timeouts` input.
+         */
+        list(args) {
+            if (args.includeFinished !== undefined && typeof args.includeFinished !== 'boolean') {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim(`
+                    Timeout \`includeFinished\` must be a boolean when provided.
+                `));
+            }
+            const parsedLimit = args.limit === undefined ? DEFAULT_LIST_TIMEOUTS_LIMIT : Math.floor(Number(args.limit));
+            if (!Number.isFinite(parsedLimit) || parsedLimit <= 0) {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim(`
+                    Timeout \`limit\` must be a positive number.
+                `));
+            }
+            if (parsedLimit > MAX_LIST_TIMEOUTS_LIMIT) {
+                throw new PipelineExecutionError(spaceTrim$1.spaceTrim(`
+                    Timeout \`limit\` must be at most \`${MAX_LIST_TIMEOUTS_LIMIT}\`.
+                `));
+            }
+            return {
+                includeFinished: args.includeFinished === true,
+                limit: parsedLimit,
+            };
+        },
     };
 
     /**
@@ -19935,6 +19965,7 @@
     const TimeoutToolNames = {
         set: 'set_timeout',
         cancel: 'cancel_timeout',
+        list: 'list_timeouts',
     };
 
     /**
@@ -20034,6 +20065,35 @@
                     return JSON.stringify(result);
                 }
             },
+            async [TimeoutToolNames.list](args) {
+                const runtimeContext = resolveTimeoutRuntimeContext(args);
+                const { adapter, disabledResult } = getTimeoutToolRuntimeAdapterOrDisabledResult('list', runtimeContext);
+                if (!adapter || disabledResult) {
+                    return JSON.stringify(disabledResult);
+                }
+                try {
+                    const parsedArgs = parseTimeoutToolArgs.list(args);
+                    const listedTimeouts = await adapter.listTimeouts(parsedArgs, runtimeContext);
+                    const result = {
+                        action: 'list',
+                        status: 'listed',
+                        items: listedTimeouts.items,
+                        total: listedTimeouts.total,
+                    };
+                    return createToolExecutionEnvelope({
+                        assistantMessage: listedTimeouts.total === 1 ? 'Found 1 timeout.' : `Found ${listedTimeouts.total} timeouts.`,
+                        toolResult: result,
+                    });
+                }
+                catch (error) {
+                    const result = {
+                        action: 'list',
+                        status: 'error',
+                        message: error instanceof Error ? error.message : String(error),
+                    };
+                    return JSON.stringify(result);
+                }
+            },
         };
     }
 
@@ -20067,26 +20127,45 @@
         if (!tools.some((tool) => tool.name === TimeoutToolNames.cancel)) {
             tools.push({
                 name: TimeoutToolNames.cancel,
-                description: 'Cancel one previously scheduled timeout in the current chat thread.',
+                description: 'Cancel one previously scheduled timeout within the same user+agent scope, even if it was set in another chat.',
                 parameters: {
                     type: 'object',
                     properties: {
                         timeoutId: {
                             type: 'string',
-                            description: 'Identifier returned earlier by `set_timeout`.',
+                            description: 'Identifier returned earlier by `set_timeout` or `list_timeouts`.',
                         },
                     },
                     required: ['timeoutId'],
                 },
             });
         }
+        if (!tools.some((tool) => tool.name === TimeoutToolNames.list)) {
+            tools.push({
+                name: TimeoutToolNames.list,
+                description: 'List scheduled timeouts across all chats for this same user+agent scope so they can be reviewed or cancelled.',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        includeFinished: {
+                            type: 'boolean',
+                            description: 'When true, include completed, failed, and cancelled rows in addition to active timeouts.',
+                        },
+                        limit: {
+                            type: 'number',
+                            description: 'Maximum number of rows to return (default 20, max 100).',
+                        },
+                    },
+                },
+            });
+        }
         return tools;
     }
 
     /**
      * `USE TIMEOUT` commitment definition.
      *
-     * The `USE TIMEOUT` commitment enables thread-scoped timers that wake the same chat later.
+     * The `USE TIMEOUT` commitment enables timeout wake-ups and scoped timeout management.
      *
      * @private [🪔] Maybe export the commitments through some package
      */
@@ -20101,7 +20180,7 @@
          * Short one-line description of `USE TIMEOUT`.
          */
         get description() {
-            return 'Enable thread-scoped timers that can wake the same chat in the future.';
+            return 'Enable timeout wake-ups plus scoped timeout listing/cancellation across chats.';
         }
         /**
          * Icon for this commitment.
@@ -20116,14 +20195,15 @@
             return spaceTrim$1.spaceTrim(`
             # USE TIMEOUT
 
-            Enables the agent to schedule thread-scoped timeout wake-ups.
+            Enables timeout wake-ups and timeout management for the same user+agent scope.
 
             ## Key aspects
 
             - The agent uses \`set_timeout\` to schedule a future wake-up in the same chat thread.
             - The tool returns immediately while the timeout is stored and executed by the runtime later.
             - The wake-up arrives as a new user-like timeout message in the same conversation.
-            - The agent can cancel an existing timeout by \`timeoutId\` via \`cancel_timeout\`.
+            - The agent can inspect known timeouts via \`list_timeouts\`.
+            - The agent can cancel an existing timeout by \`timeoutId\` via \`cancel_timeout\`, including timeouts created in another chat.
             - Commitment content is treated as optional timeout policy instructions.
 
             ## Examples
@@ -20152,6 +20232,7 @@
             return {
                 [TimeoutToolNames.set]: 'Set timer',
                 [TimeoutToolNames.cancel]: 'Cancel timer',
+                [TimeoutToolNames.list]: 'List timers',
             };
         }
         /**