@promptbook/utils 0.112.0-12 → 0.112.0-15

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/execution/createPipelineExecutor/30-executeFormatSubvalues.d.ts

@@ -1,6 +1,6 @@
 import type { PartialDeep, Promisable } from 'type-fest';
-import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { LlmCall } from '../../types/LlmCall';
+import type { TODO_any } from '../../utils/organization/TODO_any';
 import type { PipelineExecutorResult } from '../PipelineExecutorResult';
 import type { ExecuteAttemptsOptions } from './40-executeAttempts';
 /**

package/umd/src/llm-providers/anthropic-claude/anthropic-claude-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Anthropic Claude models with pricing
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://docs.anthropic.com/en/docs/models-overview
  * @public exported from `@promptbook/anthropic-claude`

package/umd/src/llm-providers/deepseek/deepseek-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Deepseek models with descriptions
  *
- * Note: Synced with official API docs at 2025-08-20
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://www.deepseek.com/models
  * @public exported from `@promptbook/deepseek`

package/umd/src/llm-providers/google/google-models.d.ts

@@ -3,7 +3,7 @@ import type { number_usd } from '../../types/typeAliases';
 /**
  * List of available Google models with descriptions
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://ai.google.dev/models/gemini
  * @public exported from `@promptbook/google`

package/umd/src/llm-providers/openai/openai-models.d.ts

@@ -2,7 +2,7 @@ import type { AvailableModel } from '../../execution/AvailableModel';
 /**
  * List of available OpenAI models with pricing
  *
- * Note: Synced with official API docs at 2025-11-19
+ * Note: Synced with official API docs at 2026-03-22
  *
  * @see https://platform.openai.com/docs/models/
  * @see https://openai.com/api/pricing/

package/umd/src/scrapers/_boilerplate/BoilerplateScraper.d.ts

@@ -3,8 +3,7 @@ import type { KnowledgePiecePreparedJson } from '../../pipeline/PipelineJson/Kno
 import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
 import type { Converter } from '../_common/Converter';
 import type { ScraperAndConverterMetadata } from '../_common/register/ScraperAndConverterMetadata';
-import type { Scraper } from '../_common/Scraper';
-import type { ScraperSourceHandler } from '../_common/Scraper';
+import type { Scraper, ScraperSourceHandler } from '../_common/Scraper';
 import type { ScraperIntermediateSource } from '../_common/ScraperIntermediateSource';
 /**
  * Scraper of @@ files

package/umd/src/scrapers/document/DocumentScraper.d.ts

@@ -3,8 +3,7 @@ import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
 import type { Converter } from '../_common/Converter';
 import type { ScraperAndConverterMetadata } from '../_common/register/ScraperAndConverterMetadata';
-import type { Scraper } from '../_common/Scraper';
-import type { ScraperSourceHandler } from '../_common/Scraper';
+import type { Scraper, ScraperSourceHandler } from '../_common/Scraper';
 import type { ScraperIntermediateSource } from '../_common/ScraperIntermediateSource';
 /**
  * Scraper of .docx and .odt files

package/umd/src/scrapers/document-legacy/LegacyDocumentScraper.d.ts

@@ -3,8 +3,7 @@ import type { ExecutionTools } from '../../execution/ExecutionTools';
 import type { PrepareAndScrapeOptions } from '../../prepare/PrepareAndScrapeOptions';
 import type { Converter } from '../_common/Converter';
 import type { ScraperAndConverterMetadata } from '../_common/register/ScraperAndConverterMetadata';
-import type { Scraper } from '../_common/Scraper';
-import type { ScraperSourceHandler } from '../_common/Scraper';
+import type { Scraper, ScraperSourceHandler } from '../_common/Scraper';
 import type { ScraperIntermediateSource } from '../_common/ScraperIntermediateSource';
 /**
  * Scraper for old document files (like .doc and .rtf)

package/umd/src/scripting/javascript/postprocessing-functions.d.ts

@@ -1,4 +1,4 @@
-import spaceTrim from 'spacetrim';
+import { spaceTrim } from 'spacetrim';
 import { extractBlock } from '../../postprocessing/utils/extractBlock';
 import { prettifyMarkdown } from '../../utils/markdown/prettifyMarkdown';
 import { trimCodeBlock } from '../../utils/markdown/trimCodeBlock';

package/umd/src/utils/parameters/mapAvailableToExpectedParameters.d.ts

@@ -1,5 +1,4 @@
-import type { string_parameter_name } from '../../types/typeAliases';
-import type { string_parameter_value } from '../../types/typeAliases';
+import type { string_parameter_name, string_parameter_value } from '../../types/typeAliases';
 /**
  * Options for mapping available parameters to expected parameters in a pipeline task.
  */

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-14`).
  *
  * @generated
  */