@promptbook/documents 0.112.0-20 → 0.112.0-22

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-20';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-22';
 /**
  * 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/book-components/Chat/MockedChat/MockedChat.d.ts

@@ -75,6 +75,26 @@ export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'on
      * @default true
      */
     isPausable?: boolean;
+    /**
+     * Optional absolute offsets (in milliseconds) for each message.
+     *
+     * When provided, playback waits according to these deterministic offsets
+     * instead of random delay heuristics.
+     */
+    readonly messageOffsetsMs?: ReadonlyArray<number>;
+    /**
+     * When true, messages typed in the input are appended only in local UI state.
+     *
+     * This is useful for demo/recording flows where user interaction should not
+     * mutate the persisted mocked-chat preset.
+     *
+     * @default false
+     */
+    readonly appendMessagesLocallyOnSend?: boolean;
+    /**
+     * Optional callback invoked whenever one full simulation run completes.
+     */
+    onSimulationComplete?(): void;
 };
 /**
  * MockedChat component that shows the same chat as Chat but emulates ongoing discussion

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

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

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

@@ -16,6 +16,23 @@ export type SetTimeoutToolArgs = {
  */
 export type CancelTimeoutToolArgs = {
     timeoutId?: string;
+    allActive?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for updating one timeout or pausing/resuming all active queued timeouts.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type UpdateTimeoutToolArgs = {
+    timeoutId?: string;
+    allActive?: boolean;
+    dueAt?: string;
+    extendByMs?: number;
+    recurrenceIntervalMs?: number | null;
+    message?: string | null;
+    parameters?: Record<string, unknown>;
+    paused?: boolean;
     [key: string]: TODO_any;
 };
 /**
@@ -80,9 +97,30 @@ export type SetTimeoutToolResult = {
  */
 export type CancelTimeoutToolResult = {
     action: 'cancel';
-    status: 'cancelled' | 'not_found' | 'disabled' | 'error';
+    status: 'cancelled' | 'cancelled_all' | 'not_found' | 'disabled' | 'error';
     timeoutId?: string;
     dueAt?: string;
+    cancelledCount?: number;
+    cancelledTimeoutIds?: Array<string>;
+    hasMore?: boolean;
+    message?: string;
+};
+/**
+ * Result payload returned by `update_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type UpdateTimeoutToolResult = {
+    action: 'update';
+    status: 'updated' | 'updated_all' | 'not_found' | 'conflict' | 'disabled' | 'error';
+    timeoutId?: string;
+    dueAt?: string;
+    paused?: boolean;
+    recurrenceIntervalMs?: number | null;
+    updatedCount?: number;
+    matchedCount?: number;
+    updatedTimeoutIds?: Array<string>;
+    hasMore?: boolean;
     message?: string;
 };
 /**
@@ -102,13 +140,13 @@ export type ListTimeoutsToolResult = {
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'] | ListTimeoutsToolResult['action'];
+export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'] | ListTimeoutsToolResult['action'] | UpdateTimeoutToolResult['action'];
 /**
  * Union of all `USE TIMEOUT` tool results.
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult | ListTimeoutsToolResult;
+export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult | ListTimeoutsToolResult | UpdateTimeoutToolResult;
 /**
  * Runtime adapter used by `USE TIMEOUT` tools.
  *
@@ -124,10 +162,15 @@ export type TimeoutToolRuntimeAdapter = {
     }>;
     cancelTimeout(args: {
         timeoutId: string;
+    } | {
+        allActive: true;
     }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
-        timeoutId: string;
+        status: 'cancelled' | 'cancelled_all' | 'not_found';
+        timeoutId?: string;
         dueAt?: string;
-        status: 'cancelled' | 'not_found';
+        cancelledCount?: number;
+        cancelledTimeoutIds?: Array<string>;
+        hasMore?: boolean;
     }>;
     listTimeouts(args: {
         includeFinished: boolean;
@@ -136,4 +179,34 @@ export type TimeoutToolRuntimeAdapter = {
         items: Array<TimeoutToolListItem>;
         total: number;
     }>;
+    updateTimeout(args: {
+        timeoutId: string;
+        patch: {
+            dueAt?: string;
+            extendByMs?: number;
+            recurrenceIntervalMs?: number | null;
+            message?: string | null;
+            parameters?: Record<string, unknown>;
+            paused?: boolean;
+        };
+    } | {
+        allActive: true;
+        paused: boolean;
+    }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
+        status: 'updated';
+        timeout: TimeoutToolListItem;
+    } | {
+        status: 'not_found';
+        timeoutId: string;
+    } | {
+        status: 'conflict';
+        timeoutId: string;
+        reason: 'finished' | 'running';
+    } | {
+        status: 'updated_all';
+        updatedCount: number;
+        matchedCount: number;
+        updatedTimeoutIds: Array<string>;
+        hasMore?: boolean;
+    }>;
 };

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

@@ -3,7 +3,7 @@ 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, ListTimeoutsToolResult, SetTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
+export type { CancelTimeoutToolResult, ListTimeoutsToolResult, SetTimeoutToolResult, UpdateTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
 /**
  * `USE TIMEOUT` commitment definition.
  *

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

@@ -1,4 +1,4 @@
-import type { CancelTimeoutToolArgs, ListTimeoutsToolArgs, SetTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
+import type { CancelTimeoutToolArgs, ListTimeoutsToolArgs, SetTimeoutToolArgs, UpdateTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
 /**
  * Parsed arguments for `set_timeout`.
  *
@@ -15,6 +15,8 @@ type ParsedSetTimeoutToolArgs = {
  */
 type ParsedCancelTimeoutToolArgs = {
     timeoutId: string;
+} | {
+    allActive: true;
 };
 /**
  * Parsed arguments for `list_timeouts`.
@@ -25,6 +27,31 @@ type ParsedListTimeoutsToolArgs = {
     includeFinished: boolean;
     limit: number;
 };
+/**
+ * Parsed patch payload for `update_timeout` single-timeout updates.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedUpdateTimeoutToolPatch = {
+    dueAt?: string;
+    extendByMs?: number;
+    recurrenceIntervalMs?: number | null;
+    message?: string | null;
+    parameters?: Record<string, unknown>;
+    paused?: boolean;
+};
+/**
+ * Parsed arguments for `update_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedUpdateTimeoutToolArgs = {
+    timeoutId: string;
+    patch: ParsedUpdateTimeoutToolPatch;
+} | {
+    allActive: true;
+    paused: boolean;
+};
 /**
  * Parses and validates `USE TIMEOUT` tool arguments.
  *
@@ -43,5 +70,9 @@ export declare const parseTimeoutToolArgs: {
      * Parses `list_timeouts` input.
      */
     list(args: ListTimeoutsToolArgs): ParsedListTimeoutsToolArgs;
+    /**
+     * Parses `update_timeout` input.
+     */
+    update(args: UpdateTimeoutToolArgs): ParsedUpdateTimeoutToolArgs;
 };
 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-19`).
+ * It follows semantic versioning (e.g., `0.112.0-21`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/documents",
-    "version": "0.112.0-20",
+    "version": "0.112.0-22",
     "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-20"
+        "@promptbook/core": "0.112.0-22"
     },
     "dependencies": {
         "colors": "1.4.0",

package/umd/index.umd.js

@@ -24,7 +24,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-20';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-22';
     /**
      * 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/book-components/Chat/MockedChat/MockedChat.d.ts

@@ -75,6 +75,26 @@ export type MockedChatProps = Omit<ChatProps, 'onReset' | /*'onMessage' | */ 'on
      * @default true
      */
     isPausable?: boolean;
+    /**
+     * Optional absolute offsets (in milliseconds) for each message.
+     *
+     * When provided, playback waits according to these deterministic offsets
+     * instead of random delay heuristics.
+     */
+    readonly messageOffsetsMs?: ReadonlyArray<number>;
+    /**
+     * When true, messages typed in the input are appended only in local UI state.
+     *
+     * This is useful for demo/recording flows where user interaction should not
+     * mutate the persisted mocked-chat preset.
+     *
+     * @default false
+     */
+    readonly appendMessagesLocallyOnSend?: boolean;
+    /**
+     * Optional callback invoked whenever one full simulation run completes.
+     */
+    onSimulationComplete?(): void;
 };
 /**
  * MockedChat component that shows the same chat as Chat but emulates ongoing discussion

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

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

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

@@ -16,6 +16,23 @@ export type SetTimeoutToolArgs = {
  */
 export type CancelTimeoutToolArgs = {
     timeoutId?: string;
+    allActive?: boolean;
+    [key: string]: TODO_any;
+};
+/**
+ * Tool arguments for updating one timeout or pausing/resuming all active queued timeouts.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type UpdateTimeoutToolArgs = {
+    timeoutId?: string;
+    allActive?: boolean;
+    dueAt?: string;
+    extendByMs?: number;
+    recurrenceIntervalMs?: number | null;
+    message?: string | null;
+    parameters?: Record<string, unknown>;
+    paused?: boolean;
     [key: string]: TODO_any;
 };
 /**
@@ -80,9 +97,30 @@ export type SetTimeoutToolResult = {
  */
 export type CancelTimeoutToolResult = {
     action: 'cancel';
-    status: 'cancelled' | 'not_found' | 'disabled' | 'error';
+    status: 'cancelled' | 'cancelled_all' | 'not_found' | 'disabled' | 'error';
     timeoutId?: string;
     dueAt?: string;
+    cancelledCount?: number;
+    cancelledTimeoutIds?: Array<string>;
+    hasMore?: boolean;
+    message?: string;
+};
+/**
+ * Result payload returned by `update_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+export type UpdateTimeoutToolResult = {
+    action: 'update';
+    status: 'updated' | 'updated_all' | 'not_found' | 'conflict' | 'disabled' | 'error';
+    timeoutId?: string;
+    dueAt?: string;
+    paused?: boolean;
+    recurrenceIntervalMs?: number | null;
+    updatedCount?: number;
+    matchedCount?: number;
+    updatedTimeoutIds?: Array<string>;
+    hasMore?: boolean;
     message?: string;
 };
 /**
@@ -102,13 +140,13 @@ export type ListTimeoutsToolResult = {
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'] | ListTimeoutsToolResult['action'];
+export type TimeoutToolAction = SetTimeoutToolResult['action'] | CancelTimeoutToolResult['action'] | ListTimeoutsToolResult['action'] | UpdateTimeoutToolResult['action'];
 /**
  * Union of all `USE TIMEOUT` tool results.
  *
  * @private type of UseTimeoutCommitmentDefinition
  */
-export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult | ListTimeoutsToolResult;
+export type TimeoutToolResult = SetTimeoutToolResult | CancelTimeoutToolResult | ListTimeoutsToolResult | UpdateTimeoutToolResult;
 /**
  * Runtime adapter used by `USE TIMEOUT` tools.
  *
@@ -124,10 +162,15 @@ export type TimeoutToolRuntimeAdapter = {
     }>;
     cancelTimeout(args: {
         timeoutId: string;
+    } | {
+        allActive: true;
     }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
-        timeoutId: string;
+        status: 'cancelled' | 'cancelled_all' | 'not_found';
+        timeoutId?: string;
         dueAt?: string;
-        status: 'cancelled' | 'not_found';
+        cancelledCount?: number;
+        cancelledTimeoutIds?: Array<string>;
+        hasMore?: boolean;
     }>;
     listTimeouts(args: {
         includeFinished: boolean;
@@ -136,4 +179,34 @@ export type TimeoutToolRuntimeAdapter = {
         items: Array<TimeoutToolListItem>;
         total: number;
     }>;
+    updateTimeout(args: {
+        timeoutId: string;
+        patch: {
+            dueAt?: string;
+            extendByMs?: number;
+            recurrenceIntervalMs?: number | null;
+            message?: string | null;
+            parameters?: Record<string, unknown>;
+            paused?: boolean;
+        };
+    } | {
+        allActive: true;
+        paused: boolean;
+    }, runtimeContext: TimeoutToolRuntimeContext): Promise<{
+        status: 'updated';
+        timeout: TimeoutToolListItem;
+    } | {
+        status: 'not_found';
+        timeoutId: string;
+    } | {
+        status: 'conflict';
+        timeoutId: string;
+        reason: 'finished' | 'running';
+    } | {
+        status: 'updated_all';
+        updatedCount: number;
+        matchedCount: number;
+        updatedTimeoutIds: Array<string>;
+        hasMore?: boolean;
+    }>;
 };

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

@@ -3,7 +3,7 @@ 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, ListTimeoutsToolResult, SetTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
+export type { CancelTimeoutToolResult, ListTimeoutsToolResult, SetTimeoutToolResult, UpdateTimeoutToolResult, TimeoutToolListItem, TimeoutToolRuntimeAdapter, TimeoutToolRuntimeContext, } from './TimeoutToolRuntimeAdapter';
 /**
  * `USE TIMEOUT` commitment definition.
  *

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

@@ -1,4 +1,4 @@
-import type { CancelTimeoutToolArgs, ListTimeoutsToolArgs, SetTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
+import type { CancelTimeoutToolArgs, ListTimeoutsToolArgs, SetTimeoutToolArgs, UpdateTimeoutToolArgs } from './TimeoutToolRuntimeAdapter';
 /**
  * Parsed arguments for `set_timeout`.
  *
@@ -15,6 +15,8 @@ type ParsedSetTimeoutToolArgs = {
  */
 type ParsedCancelTimeoutToolArgs = {
     timeoutId: string;
+} | {
+    allActive: true;
 };
 /**
  * Parsed arguments for `list_timeouts`.
@@ -25,6 +27,31 @@ type ParsedListTimeoutsToolArgs = {
     includeFinished: boolean;
     limit: number;
 };
+/**
+ * Parsed patch payload for `update_timeout` single-timeout updates.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedUpdateTimeoutToolPatch = {
+    dueAt?: string;
+    extendByMs?: number;
+    recurrenceIntervalMs?: number | null;
+    message?: string | null;
+    parameters?: Record<string, unknown>;
+    paused?: boolean;
+};
+/**
+ * Parsed arguments for `update_timeout`.
+ *
+ * @private type of UseTimeoutCommitmentDefinition
+ */
+type ParsedUpdateTimeoutToolArgs = {
+    timeoutId: string;
+    patch: ParsedUpdateTimeoutToolPatch;
+} | {
+    allActive: true;
+    paused: boolean;
+};
 /**
  * Parses and validates `USE TIMEOUT` tool arguments.
  *
@@ -43,5 +70,9 @@ export declare const parseTimeoutToolArgs: {
      * Parses `list_timeouts` input.
      */
     list(args: ListTimeoutsToolArgs): ParsedListTimeoutsToolArgs;
+    /**
+     * Parses `update_timeout` input.
+     */
+    update(args: UpdateTimeoutToolArgs): ParsedUpdateTimeoutToolArgs;
 };
 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-19`).
+ * It follows semantic versioning (e.g., `0.112.0-21`).
  *
  * @generated
  */