@promptbook/documents 0.112.0-12 → 0.112.0-13

package/esm/index.es.js

@@ -26,7 +26,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @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

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/documents",
-    "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,
@@ -98,7 +98,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/documents.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.112.0-12"
+        "@promptbook/core": "0.112.0-13"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -25,7 +25,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

package/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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
  */