@promptbook/cli 0.114.0-3 → 0.114.0-4

package/umd/src/book-2.0/agent-source/AgentBasicInformation.d.ts

@@ -31,13 +31,13 @@ export type BookParameter = {
 };
 /**
  * Capability of the agent
- * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+ * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
  */
 export type AgentCapability = {
     /**
      * The type of the capability
      */
-    type: 'browser' | 'search-engine' | 'knowledge' | 'timeout' | 'time' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'email' | 'popup' | 'privacy' | 'project' | 'calendar' | 'wallet';
+    type: 'knowledge' | 'user-location' | 'inheritance' | 'import' | 'image-generator' | 'team' | 'popup' | 'privacy' | 'project' | 'calendar';
     /**
      * The label to display for this capability
      */
@@ -122,7 +122,7 @@ export type AgentBasicInformation = {
     parameters: Array<BookParameter>;
     /**
      * Capabilities of the agent
-     * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+     * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
      */
     capabilities: Array<AgentCapability>;
     /**

package/umd/src/cli/cli-commands/coder/boilerplateCount.d.ts

@@ -0,0 +1,52 @@
+/**
+ * How many prompt boilerplate files are generated and how many prompts each of them contains.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export type BoilerplateCount = {
+    /**
+     * Number of generated prompt boilerplate files.
+     */
+    readonly filesCount: number;
+    /**
+     * Number of prompts written into each generated file.
+     *
+     * Note: More than one prompt per file is an advanced option - each prompt is one separate
+     *       coding task separated by `---` and tagged with its own fresh emoji tag.
+     */
+    readonly promptsPerFileCount: number;
+};
+/**
+ * Number of prompt boilerplate files and prompts per file used when `--count` is not provided.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const DEFAULT_BOILERPLATE_COUNT: BoilerplateCount;
+/**
+ * Formats one boilerplate count back into the `N*M` notation of the `--count` option.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function formatBoilerplateCount({ filesCount, promptsPerFileCount }: BoilerplateCount): string;
+/**
+ * Default value of the `--count` option rendered in the `N*M` notation, for example `5*1`.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const DEFAULT_BOILERPLATE_COUNT_OPTION_VALUE: string;
+/**
+ * Description of the `--count` option shared by all commands which generate prompt boilerplates.
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare const BOILERPLATE_COUNT_OPTION_DESCRIPTION: string;
+/**
+ * Parses the `--count` option value into the number of files and the number of prompts in each of them.
+ *
+ * Both notations are supported:
+ * - `N` and `N*1` => N files with one prompt each
+ * - `N*M` => N files with M prompts each
+ *
+ * @private internal utility of `ptbk coder`
+ */
+export declare function parseBoilerplateCount(countOption: string): BoilerplateCount;

package/umd/src/cli/cli-commands/coder/generate-boilerplates.d.ts

@@ -1,5 +1,6 @@
 import type { Command as Program } from 'commander';
 import type { $side_effect } from '../../../utils/organization/$side_effect';
+import type { BoilerplateCount } from './boilerplateCount';
 /**
  * Initializes `coder generate-boilerplates` command for Promptbook CLI utilities
  *
@@ -13,8 +14,8 @@ export declare function $initializeCoderGenerateBoilerplatesCommand(program: Pro
  *
  * @private internal function of `generatePromptBoilerplate` command
  */
-export declare function generatePromptBoilerplate({ projectPath, filesCount, templateOption, }: {
+export declare function generatePromptBoilerplate({ projectPath, boilerplateCount, templateOption, }: {
     readonly projectPath: string;
-    readonly filesCount: number;
+    readonly boilerplateCount: BoilerplateCount;
     readonly templateOption?: string;
 }): Promise<void>;

package/umd/src/commitments/{COMPONENT/COMPONENT.d.ts → META_FULLNAME/META_FULLNAME.d.ts}

@@ -1,16 +1,19 @@
 import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
 import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
- * COMPONENT commitment definition
+ * META FULLNAME commitment definition
  *
- * The COMPONENT commitment defines a UI component that the agent can render in the chat.
+ * The `META FULLNAME` commitment sets the full display name of the agent, which can differ
+ * from the agent name on the first line of the agent source, for example when the agent
+ * should be presented with academic titles.
+ * This commitment is metadata-only and does not modify model requirements.
  *
  * @private [🪔] Maybe export the commitments through some package
  */
-export declare class ComponentCommitmentDefinition extends BaseCommitmentDefinition<'COMPONENT'> {
+export declare class MetaFullnameCommitmentDefinition extends BaseCommitmentDefinition<'META FULLNAME'> {
     constructor();
     /**
-     * Short one-line description of COMPONENT.
+     * Short one-line description of META FULLNAME.
      */
     get description(): string;
     /**
@@ -18,7 +21,7 @@ export declare class ComponentCommitmentDefinition extends BaseCommitmentDefinit
      */
     get icon(): string;
     /**
-     * Markdown documentation for COMPONENT commitment.
+     * Markdown documentation for META FULLNAME commitment.
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;

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

@@ -0,0 +1,32 @@
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * META ID commitment definition
+ *
+ * The `META ID` commitment carries the permanent id of the agent when an agent source is moved
+ * between systems. It is a low-level commitment which is normally written and stripped by the
+ * persistence layer instead of being written by hand.
+ * This commitment is metadata-only and does not modify model requirements.
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class MetaIdCommitmentDefinition extends BaseCommitmentDefinition<'META ID'> {
+    constructor();
+    /**
+     * Short one-line description of META ID.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * `META ID` is written by the persistence layer, not by agent authors.
+     */
+    get isLowLevel(): boolean;
+    /**
+     * Markdown documentation for META ID commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+}

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

@@ -1,6 +1,5 @@
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
 import { ClosedCommitmentDefinition } from './CLOSED/CLOSED';
-import { ComponentCommitmentDefinition } from './COMPONENT/COMPONENT';
 import { DeleteCommitmentDefinition } from './DELETE/DELETE';
 import { DictionaryCommitmentDefinition } from './DICTIONARY/DICTIONARY';
 import { FormatCommitmentDefinition } from './FORMAT/FORMAT';
@@ -9,19 +8,20 @@ import { GoalCommitmentDefinition } from './GOAL/GOAL';
 import { ImportCommitmentDefinition } from './IMPORT/IMPORT';
 import { KnowledgeCommitmentDefinition } from './KNOWLEDGE/KNOWLEDGE';
 import { LanguageCommitmentDefinition } from './LANGUAGE/LANGUAGE';
-import { MemoryCommitmentDefinition } from './MEMORY/MEMORY';
 import { AgentMessageCommitmentDefinition } from './MESSAGE/AgentMessageCommitmentDefinition';
 import { InitialMessageCommitmentDefinition } from './MESSAGE/InitialMessageCommitmentDefinition';
 import { InternalMessageCommitmentDefinition } from './MESSAGE/InternalMessageCommitmentDefinition';
 import { MessageCommitmentDefinition } from './MESSAGE/MESSAGE';
 import { UserMessageCommitmentDefinition } from './MESSAGE/UserMessageCommitmentDefinition';
 import { MessageSuffixCommitmentDefinition } from './MESSAGE_SUFFIX/MESSAGE_SUFFIX';
-import { MetaCommitmentDefinition } from './META/META';
 import { MetaAvatarCommitmentDefinition } from './META_AVATAR/META_AVATAR';
 import { MetaColorCommitmentDefinition } from './META_COLOR/META_COLOR';
+import { MetaDescriptionCommitmentDefinition } from './META_DESCRIPTION/META_DESCRIPTION';
 import { MetaDomainCommitmentDefinition } from './META_DOMAIN/META_DOMAIN';
 import { MetaDisclaimerCommitmentDefinition } from './META_DISCLAIMER/META_DISCLAIMER';
 import { MetaFontCommitmentDefinition } from './META_FONT/META_FONT';
+import { MetaFullnameCommitmentDefinition } from './META_FULLNAME/META_FULLNAME';
+import { MetaIdCommitmentDefinition } from './META_ID/META_ID';
 import { MetaImageCommitmentDefinition } from './META_IMAGE/META_IMAGE';
 import { MetaInputPlaceholderCommitmentDefinition } from './META_INPUT_PLACEHOLDER/META_INPUT_PLACEHOLDER';
 import { MetaLinkCommitmentDefinition } from './META_LINK/META_LINK';
@@ -38,21 +38,13 @@ import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
 import { TeamCommitmentDefinition } from './TEAM/TEAM';
 import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
-import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
 import { UseCalendarCommitmentDefinition } from './USE_CALENDAR/USE_CALENDAR';
-import { UseDeepSearchCommitmentDefinition } from './USE_DEEPSEARCH/USE_DEEPSEARCH';
-import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
 import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
 import { UsePopupCommitmentDefinition } from './USE_POPUP/USE_POPUP';
 import { UsePrivacyCommitmentDefinition } from './USE_PRIVACY/USE_PRIVACY';
 import { UseProjectCommitmentDefinition } from './USE_PROJECT/USE_PROJECT';
-import { UseSearchEngineCommitmentDefinition } from './USE_SEARCH_ENGINE/USE_SEARCH_ENGINE';
-import { UseSpawnCommitmentDefinition } from './USE_SPAWN/USE_SPAWN';
-import { UseTimeoutCommitmentDefinition } from './USE_TIMEOUT/USE_TIMEOUT';
-import { UseTimeCommitmentDefinition } from './USE_TIME/USE_TIME';
 import { UseUserLocationCommitmentDefinition } from './USE_USER_LOCATION/USE_USER_LOCATION';
-import { WalletCommitmentDefinition } from './WALLET/WALLET';
 import { WritingRulesCommitmentDefinition } from './WRITING_RULES/WRITING_RULES';
 import { WritingSampleCommitmentDefinition } from './WRITING_SAMPLE/WRITING_SAMPLE';
 import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplementedCommitmentDefinition';
@@ -63,4 +55,4 @@ import { NotYetImplementedCommitmentDefinition } from './_base/NotYetImplemented
  *
  * @private Use functions to access commitments instead of this array directly
  */
-export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaThinkingMessageCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, WalletCommitmentDefinition, WalletCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseDeepSearchCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseSpawnCommitmentDefinition, UseTimeoutCommitmentDefinition, UseTimeCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UseEmailCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, WritingSampleCommitmentDefinition, WritingRulesCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaAvatarCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaDomainCommitmentDefinition, MetaDescriptionCommitmentDefinition, MetaDisclaimerCommitmentDefinition, MetaFullnameCommitmentDefinition, MetaIdCommitmentDefinition, MetaInputPlaceholderCommitmentDefinition, MetaThinkingMessageCommitmentDefinition, MetaVisibilityCommitmentDefinition, MetaVoiceCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, InternalMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageSuffixCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseUserLocationCommitmentDefinition, UseCalendarCommitmentDefinition, UsePopupCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UsePrivacyCommitmentDefinition, UseProjectCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];

package/umd/src/llm-providers/agent/Agent.d.ts

@@ -45,7 +45,7 @@ export declare class Agent extends AgentLlmExecutionTools implements LlmExecutio
     links: Array<string_agent_url>;
     /**
      * Capabilities of the agent
-     * This is parsed from commitments like USE BROWSER, USE SEARCH ENGINE, KNOWLEDGE, etc.
+     * This is parsed from commitments like USE CALENDAR, USE PROJECT, KNOWLEDGE, etc.
      */
     capabilities: Array<AgentCapability>;
     /**

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

@@ -73,7 +73,7 @@ export declare class OpenAiAgentKitExecutionToolsToolBuilder {
      */
     private normalizeAgentKitToolParameters;
     /**
-     * Creates the native Agent SDK tool used for `USE DEEPSEARCH`.
+     * Creates the native Agent SDK tool used for the DeepSearch capability.
      */
     private createDeepSearchAgentKitTool;
     /**

package/umd/src/{commitments/USE_BROWSER → scrapers/_common/utils}/fetchUrlContent.d.ts

@@ -8,12 +8,11 @@
  * 4. Returns the scraped markdown content
  *
  * WARNING: This function should NOT be used directly in browser environments.
- * For browser environments, use fetchUrlContentViaBrowser which proxies through
- * the Agents Server API endpoint at /api/scrape
+ * For browser environments, proxy the request through the Agents Server API endpoint at /api/scrape
  *
  * @param url The URL to fetch and scrape
  * @returns Markdown content from the URL
  *
- * @private internal utility for USE BROWSER commitment
+ * @private internal scraping utility
  */
 export declare function fetchUrlContent(url: string): Promise<string>;

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.114.0-2`).
+ * It follows semantic versioning (e.g., `0.114.0-3`).
  *
  * @generated
  */

package/apps/agents-server/src/tools/configureTimeoutToolRuntimeAdapterForServer.ts

@@ -1,381 +0,0 @@
-import {
-    setTimeoutToolRuntimeAdapter,
-    type TimeoutToolListItem,
-    type TimeoutToolRuntimeAdapter,
-    type TimeoutToolRuntimeContext,
-} from '../../../../src/commitments/USE_TIMEOUT/USE_TIMEOUT';
-import {
-    cancelAllActiveAgentScopedUserChatTimeouts,
-    cancelScheduledUserChatTimeout,
-    getAgentScopedUserChatTimeout,
-    listAgentUserChatTimeouts,
-    notifyUserChatTimeoutScheduleChanged,
-    pauseAllActiveAgentScopedUserChatTimeouts,
-    resumeAllPausedAgentScopedUserChatTimeouts,
-    scheduleThreadScopedUserChatTimeout,
-    updateAgentScopedUserChatTimeout,
-} from '../utils/userChatTimeout';
-
-/**
- * Maximum number of timeouts returned in one `list_timeouts` runtime call.
- *
- * @private internal timeout adapter constant
- */
-const MAX_LISTED_TIMEOUTS_LIMIT = 100;
-
-/**
- * Shared timeout runtime adapter bound to the Agents Server durable chat infrastructure.
- *
- * @private internal singleton for server tool providers
- */
-const timeoutToolRuntimeAdapter: TimeoutToolRuntimeAdapter = {
-    async scheduleTimeout(
-        args: {
-            milliseconds: number;
-            message?: string;
-        },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        timeoutId: string;
-        dueAt: string;
-    }> {
-        const chatId = requireTimeoutScopeField(runtimeContext.chatId, 'chat');
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-        const timeout = await scheduleThreadScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            chatId,
-            durationMs: args.milliseconds,
-            message: normalizeTimeoutMessage(args.message),
-            parameters: runtimeContext.promptParameters,
-        });
-
-        return {
-            timeoutId: timeout.timeoutId,
-            dueAt: timeout.dueAt,
-        };
-    },
-    async cancelTimeout(
-        args:
-            | {
-                  timeoutId: string;
-              }
-            | {
-                  allActive: true;
-              },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        status: 'cancelled' | 'cancelled_all' | 'not_found';
-        timeoutId?: string;
-        dueAt?: string;
-        cancelledCount?: number;
-        cancelledTimeoutIds?: Array<string>;
-        hasMore?: boolean;
-    }> {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-
-        if ('allActive' in args && args.allActive) {
-            const bulkCancellationSummary = await cancelAllActiveAgentScopedUserChatTimeouts({
-                userId,
-                agentPermanentId,
-            });
-
-            return {
-                status: 'cancelled_all',
-                cancelledCount: bulkCancellationSummary.updatedCount,
-                cancelledTimeoutIds: bulkCancellationSummary.timeoutIds,
-                hasMore: bulkCancellationSummary.hasMore,
-            };
-        }
-
-        if (!('timeoutId' in args)) {
-            return {
-                status: 'not_found',
-            };
-        }
-
-        const timeoutId = args.timeoutId;
-
-        const existingTimeout = await getAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-        });
-
-        if (!existingTimeout) {
-            return {
-                timeoutId,
-                status: 'not_found',
-            };
-        }
-
-        const cancelledTimeout = await cancelScheduledUserChatTimeout(timeoutId);
-
-        if (!cancelledTimeout) {
-            return {
-                timeoutId,
-                status: 'not_found',
-            };
-        }
-
-        return {
-            timeoutId: cancelledTimeout.timeoutId,
-            dueAt: cancelledTimeout.dueAt,
-            status: 'cancelled',
-        };
-    },
-    async listTimeouts(
-        args: {
-            includeFinished: boolean;
-            limit: number;
-        },
-        runtimeContext: TimeoutToolRuntimeContext,
-    ): Promise<{
-        items: Array<TimeoutToolListItem>;
-        total: number;
-    }> {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-        const limit = normalizeTimeoutListLimit(args.limit);
-        const statuses = args.includeFinished ? undefined : (['QUEUED', 'RUNNING'] as const);
-        const listedTimeouts = await listAgentUserChatTimeouts({
-            userId,
-            agentPermanentId,
-            limit,
-            ...(statuses ? { statuses } : {}),
-        });
-
-        return {
-            items: listedTimeouts.map(mapTimeoutRecordToToolListItem),
-            total: listedTimeouts.length,
-        };
-    },
-    async 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;
-          }
-    > {
-        const userId = requireTimeoutScopeField(runtimeContext.userId, 'user');
-        const agentPermanentId = requireTimeoutScopeField(runtimeContext.agentId, 'agent');
-
-        if ('allActive' in args && args.allActive) {
-            const bulkSummary = args.paused
-                ? await pauseAllActiveAgentScopedUserChatTimeouts({
-                      userId,
-                      agentPermanentId,
-                  })
-                : await resumeAllPausedAgentScopedUserChatTimeouts({
-                      userId,
-                      agentPermanentId,
-                  });
-
-            return {
-                status: 'updated_all',
-                updatedCount: bulkSummary.updatedCount,
-                matchedCount: bulkSummary.matchedCount,
-                updatedTimeoutIds: bulkSummary.timeoutIds,
-                hasMore: bulkSummary.hasMore,
-            };
-        }
-
-        if (!('timeoutId' in args) || !('patch' in args)) {
-            return {
-                status: 'not_found',
-                timeoutId: '',
-            };
-        }
-
-        const timeoutId = args.timeoutId;
-        const timeoutPatch = args.patch;
-
-        const existingTimeout = await getAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-        });
-
-        if (!existingTimeout) {
-            return {
-                status: 'not_found',
-                timeoutId,
-            };
-        }
-
-        if (isFinishedTimeoutStatus(existingTimeout.status)) {
-            return {
-                status: 'conflict',
-                timeoutId,
-                reason: 'finished',
-            };
-        }
-
-        if (existingTimeout.status === 'RUNNING') {
-            return {
-                status: 'conflict',
-                timeoutId,
-                reason: 'running',
-            };
-        }
-
-        const updatedTimeout = await updateAgentScopedUserChatTimeout({
-            userId,
-            agentPermanentId,
-            timeoutId,
-            patch: {
-                ...(timeoutPatch.dueAt !== undefined ? { dueAt: timeoutPatch.dueAt } : {}),
-                ...(timeoutPatch.extendByMs !== undefined ? { extendByMs: timeoutPatch.extendByMs } : {}),
-                ...(timeoutPatch.recurrenceIntervalMs !== undefined
-                    ? { recurrenceIntervalMs: timeoutPatch.recurrenceIntervalMs }
-                    : {}),
-                ...(timeoutPatch.message !== undefined
-                    ? { message: normalizeTimeoutMessage(timeoutPatch.message) || null }
-                    : {}),
-                ...(timeoutPatch.parameters !== undefined ? { parameters: timeoutPatch.parameters } : {}),
-                ...(timeoutPatch.paused !== undefined
-                    ? { pausedAt: timeoutPatch.paused ? new Date().toISOString() : null }
-                    : {}),
-            },
-        });
-
-        if (!updatedTimeout) {
-            return {
-                status: 'not_found',
-                timeoutId,
-            };
-        }
-
-        notifyUserChatTimeoutScheduleChanged(updatedTimeout);
-
-        return {
-            status: 'updated',
-            timeout: mapTimeoutRecordToToolListItem(updatedTimeout),
-        };
-    },
-};
-
-/**
- * Installs the Agents Server timeout runtime adapter into the `USE TIMEOUT` commitment layer.
- *
- * @private internal utility for server tool providers
- */
-export function configureTimeoutToolRuntimeAdapterForServer(): void {
-    setTimeoutToolRuntimeAdapter(timeoutToolRuntimeAdapter);
-}
-
-/**
- * Trims optional timeout follow-up message text before persistence.
- *
- * @private internal utility for timeout tool adapters
- */
-function normalizeTimeoutMessage(value: unknown): string | undefined {
-    if (typeof value !== 'string') {
-        return undefined;
-    }
-
-    const normalizedValue = value.trim();
-    return normalizedValue || undefined;
-}
-
-/**
- * Ensures one required timeout scope field is available in runtime context.
- *
- * @private internal utility for timeout tool adapters
- */
-function requireTimeoutScopeField<TValue>(
-    value: TValue | undefined,
-    fieldName: 'chat' | 'user' | 'agent',
-): TValue {
-    if (value === undefined || value === null) {
-        throw new Error(`Timeouts are unavailable because ${fieldName} scope context is missing.`);
-    }
-
-    if (typeof value === 'string' && value.length === 0) {
-        throw new Error(`Timeouts are unavailable because ${fieldName} scope context is missing.`);
-    }
-
-    return value;
-}
-
-/**
- * Clamps requested timeout-list limits to the supported adapter range.
- *
- * @private internal utility for timeout tool adapters
- */
-function normalizeTimeoutListLimit(value: number): number {
-    if (!Number.isFinite(value)) {
-        return MAX_LISTED_TIMEOUTS_LIMIT;
-    }
-
-    return Math.max(1, Math.min(MAX_LISTED_TIMEOUTS_LIMIT, Math.floor(value)));
-}
-
-/**
- * Maps one stored timeout record into one `USE TIMEOUT` list item.
- *
- * @private internal utility for timeout tool adapters
- */
-function mapTimeoutRecordToToolListItem(timeout: {
-    timeoutId: string;
-    chatId: string;
-    status: TimeoutToolListItem['status'];
-    dueAt: string;
-    pausedAt: string | null;
-    message: string | null;
-    recurrenceIntervalMs: number | null;
-}): TimeoutToolListItem {
-    return {
-        timeoutId: timeout.timeoutId,
-        chatId: timeout.chatId,
-        status: timeout.status,
-        dueAt: timeout.dueAt,
-        paused: Boolean(timeout.pausedAt),
-        message: timeout.message,
-        recurrenceIntervalMs: timeout.recurrenceIntervalMs,
-    };
-}
-
-/**
- * Returns `true` when one timeout has reached a terminal state.
- *
- * @private internal utility for timeout tool adapters
- */
-function isFinishedTimeoutStatus(status: TimeoutToolListItem['status']): boolean {
-    return status === 'COMPLETED' || status === 'FAILED' || status === 'CANCELLED';
-}