@promptbook/remote-server 0.105.0-12 → 0.105.0-15

package/esm/typings/src/_packages/core.index.d.ts

@@ -75,6 +75,11 @@ import { MODEL_TRUST_LEVELS } from '../constants';
 import { MODEL_ORDERS } from '../constants';
 import { ORDER_OF_PIPELINE_JSON } from '../constants';
 import { RESERVED_PARAMETER_NAMES } from '../constants';
+import { LIMITS } from '../constants';
+import { TIME_INTERVALS } from '../constants';
+import { NETWORK_LIMITS } from '../constants';
+import { COLOR_CONSTANTS } from '../constants';
+import { HTTP_STATUS_CODES } from '../constants';
 import { compilePipeline } from '../conversion/compilePipeline';
 import { parsePipeline } from '../conversion/parsePipeline';
 import { pipelineJsonToString } from '../conversion/pipelineJsonToString';
@@ -275,6 +280,11 @@ export { MODEL_TRUST_LEVELS };
 export { MODEL_ORDERS };
 export { ORDER_OF_PIPELINE_JSON };
 export { RESERVED_PARAMETER_NAMES };
+export { LIMITS };
+export { TIME_INTERVALS };
+export { NETWORK_LIMITS };
+export { COLOR_CONSTANTS };
+export { HTTP_STATUS_CODES };
 export { compilePipeline };
 export { parsePipeline };
 export { pipelineJsonToString };

package/esm/typings/src/_packages/types.index.d.ts

@@ -17,6 +17,7 @@ import type { MockedChatDelayConfig } from '../book-components/Chat/MockedChat/M
 import type { MockedChatProps } from '../book-components/Chat/MockedChat/MockedChat';
 import type { ChatSaveFormatDefinition } from '../book-components/Chat/save/_common/ChatSaveFormatDefinition';
 import type { string_chat_format_name } from '../book-components/Chat/save/_common/string_chat_format_name';
+import type { ChatToolCall } from '../book-components/Chat/types/ChatMessage';
 import type { ChatMessage } from '../book-components/Chat/types/ChatMessage';
 import type { ChatParticipant } from '../book-components/Chat/types/ChatParticipant';
 import type { MessageButton } from '../book-components/Chat/utils/parseMessageButtons';
@@ -213,6 +214,7 @@ import type { SpeechRecognitionStartOptions } from '../types/SpeechRecognition';
 import type { SpeechRecognitionState } from '../types/SpeechRecognition';
 import type { SpeechRecognitionEvent } from '../types/SpeechRecognition';
 import type { TaskType } from '../types/TaskType';
+import type { ToolCall } from '../types/ToolCall';
 import type { string_char_emoji } from '../types/typeAliasEmoji';
 import type { string_business_category_name } from '../types/typeAliases';
 import type { string_model_name } from '../types/typeAliases';
@@ -397,6 +399,7 @@ export type { MockedChatDelayConfig };
 export type { MockedChatProps };
 export type { ChatSaveFormatDefinition };
 export type { string_chat_format_name };
+export type { ChatToolCall };
 export type { ChatMessage };
 export type { ChatParticipant };
 export type { MessageButton };
@@ -593,6 +596,7 @@ export type { SpeechRecognitionStartOptions };
 export type { SpeechRecognitionState };
 export type { SpeechRecognitionEvent };
 export type { TaskType };
+export type { ToolCall };
 export type { string_char_emoji };
 export type { string_business_category_name };
 export type { string_model_name };

package/esm/typings/src/book-components/Chat/Chat/ChatMessageItem.d.ts

@@ -1,6 +1,5 @@
 /// <reference types="react" />
 import type { id } from '../../../types/typeAliases';
-import type { TODO_any } from '../../../utils/organization/TODO_any';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
 import type { ChatProps } from './ChatProps';
@@ -42,16 +41,12 @@ type ChatMessageItemProps = Pick<ChatProps, 'onMessage' | 'participants'> & {
     /**
      * Called when a tool call chiplet is clicked.
      */
-    onToolCallClick?: (toolCall: {
-        name: string;
-        arguments?: TODO_any;
-        result?: TODO_any;
-    }) => void;
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
 };
 /**
  * Renders a single chat message item with avatar, content, buttons, and rating.
  *
  * @private internal subcomponent of `<Chat>` component
  */
-export declare const ChatMessageItem: import("react").MemoExoticComponent<({ message, participant, participants, isLastMessage, onMessage, setExpandedMessageId, isExpanded, currentRating, handleRating, mode, isCopyButtonEnabled, isFeedbackEnabled, onCopy, onCreateAgent, toolTitles, onToolCallClick, }: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
+export declare const ChatMessageItem: import("react").MemoExoticComponent<(props: ChatMessageItemProps) => import("react/jsx-runtime").JSX.Element>;
 export {};

package/esm/typings/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -3,7 +3,6 @@ import type { Promisable } from 'type-fest';
 import { Color } from '../../../_packages/color.index';
 import { SpeechRecognition } from '../../../types/SpeechRecognition';
 import { string_color } from '../../../types/typeAliases';
-import type { TODO_any } from '../../../utils/organization/TODO_any';
 import type { string_chat_format_name } from '../save/_common/string_chat_format_name';
 import type { ChatMessage } from '../types/ChatMessage';
 import type { ChatParticipant } from '../types/ChatParticipant';
@@ -198,11 +197,7 @@ export type ChatProps = {
     /**
      * Called when a tool call chiplet is clicked.
      */
-    onToolCallClick?: (toolCall: {
-        name: string;
-        arguments?: TODO_any;
-        result?: TODO_any;
-    }) => void;
+    onToolCallClick?: (toolCall: NonNullable<ChatMessage['toolCalls']>[number]) => void;
     /**
      * Visual style of the chat component
      */

package/esm/typings/src/book-components/Chat/Chat/ClockIcon.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Renders a nice clock icon with a specific time.
+ *
+ * @private internal subcomponent of `<Chat>` component
+ */
+export declare function ClockIcon({ date, size }: {
+    date: Date;
+    size?: number;
+}): import("react/jsx-runtime").JSX.Element;

package/esm/typings/src/book-components/Chat/types/ChatMessage.d.ts

@@ -1,6 +1,7 @@
 import { Message } from '../../../types/Message';
+import type { ToolCall } from '../../../types/ToolCall';
 import type { id, string_markdown } from '../../../types/typeAliases';
-import type { TODO_any } from '../../../utils/organization/TODO_any';
+export type ChatToolCall = ToolCall;
 /**
  * Represents a single message within a chat interface.
  *
@@ -37,45 +38,17 @@ export type ChatMessage = Omit<Message<id>, 'direction' | 'recipients' | 'thread
     /**
      * Optional tool calls made during the execution
      */
-    readonly ongoingToolCalls?: ReadonlyArray<{
-        /**
-         * Name of the tool
-         */
-        readonly name: string;
-        /**
-         * Arguments for the tool call
-         */
-        readonly arguments?: string | Record<string, TODO_any>;
-        /**
-         * Result of the tool call
-         */
-        readonly result?: TODO_any;
-        /**
-         * Raw tool call from the model
-         */
-        readonly rawToolCall?: TODO_any;
-    }>;
+    readonly ongoingToolCalls?: ReadonlyArray<ChatToolCall>;
+    /**
+     * Optional tool calls used to produce this message.
+     */
+    readonly toolCalls?: ReadonlyArray<ChatToolCall>;
     /**
      * Optional tool calls that have been completed
+     *
+     * @deprecated Use `toolCalls` instead.
      */
-    readonly completedToolCalls?: ReadonlyArray<{
-        /**
-         * Name of the tool
-         */
-        readonly name: string;
-        /**
-         * Arguments for the tool call
-         */
-        readonly arguments?: string | Record<string, TODO_any>;
-        /**
-         * Result of the tool call
-         */
-        readonly result?: TODO_any;
-        /**
-         * Raw tool call from the model
-         */
-        readonly rawToolCall?: TODO_any;
-    }>;
+    readonly completedToolCalls?: ReadonlyArray<ChatToolCall>;
     /**
      * Optional file attachments
      */

package/esm/typings/src/book-components/Chat/utils/getToolCallChipletText.d.ts

@@ -1,4 +1,4 @@
-import type { TODO_any } from '../../../utils/organization/TODO_any';
+import type { ToolCall } from '../../../types/ToolCall';
 /**
  * Utility to format tool call information for user-friendly display.
  */
@@ -16,7 +16,4 @@ export declare const TOOL_TITLES: Record<string, {
  *
  * @private [🧠] Maybe public?
  */
-export declare function getToolCallChipletText(toolCall: {
-    name: string;
-    arguments?: string | Record<string, TODO_any>;
-}): string;
+export declare function getToolCallChipletText(toolCall: ToolCall): string;

package/esm/typings/src/book-components/Chat/utils/toolCallParsing.d.ts

@@ -0,0 +1,41 @@
+import type { ToolCall } from '../../../types/ToolCall';
+import type { TODO_any } from '../../../utils/organization/TODO_any';
+/**
+ * @@@
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function parseToolCallArguments(toolCall: Pick<ToolCall, 'arguments'>): Record<string, TODO_any>;
+/**
+ * @@@
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function parseToolCallResult(result: ToolCall['result']): TODO_any;
+type SearchResultsExtraction = {
+    results: Array<TODO_any>;
+    rawText: string | null;
+};
+/**
+ * @@@
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function extractSearchResults(resultRaw: TODO_any): SearchResultsExtraction;
+/**
+ * @@@
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function getToolCallTimestamp(toolCall: Pick<ToolCall, 'createdAt'>): Date | null;
+/**
+ * @@@
+ *
+ * @private utility of `<Chat/>` component
+ */
+export declare function getToolCallResultDate(result: ToolCall['result']): Date | null;
+export {};
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ *         <- TODO: But maybe split into multiple files later?
+ */

package/esm/typings/src/commitments/USE_SEARCH_ENGINE/USE_SEARCH_ENGINE.d.ts

@@ -21,6 +21,7 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  */
 export declare class UseSearchEngineCommitmentDefinition extends BaseCommitmentDefinition<'USE SEARCH ENGINE'> {
     constructor();
+    get requiresContent(): boolean;
     /**
      * Short one-line description of USE SEARCH ENGINE.
      */

package/esm/typings/src/commitments/USE_TIME/USE_TIME.d.ts

@@ -11,12 +11,14 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
  *
  * ```book
  * USE TIME
+ * USE TIME Prefer the user's local timezone.
  * ```
  *
  * @private [🪔] Maybe export the commitments through some package
  */
 export declare class UseTimeCommitmentDefinition extends BaseCommitmentDefinition<'USE TIME'> {
     constructor();
+    get requiresContent(): boolean;
     /**
      * Short one-line description of USE TIME.
      */

package/esm/typings/src/commitments/_base/formatOptionalInstructionBlock.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @@@
+ *
+ * @private utility for commitments
+ */
+export declare function formatOptionalInstructionBlock(label: string, content: string): string;

package/esm/typings/src/constants.d.ts

@@ -71,6 +71,131 @@ export declare const RESERVED_PARAMETER_RESTRICTED: string;
  * @public exported from `@promptbook/core`
  */
 export declare const RESERVED_PARAMETER_NAMES: readonly ["content", "context", "knowledge", "examples", "modelName", "currentDate"];
+/**
+ * Limits for IDs, names, and other strings
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const LIMITS: {
+    /**
+     * Minimum length of a name (e.g. agent name, persona name)
+     */
+    readonly NAME_MIN_LENGTH: 3;
+    /**
+     * Recommended maximum length of a name
+     */
+    readonly NAME_MAX_LENGTH: 20;
+    /**
+     * Maximum length of a short description or a hash
+     */
+    readonly SHORT_TEXT_MAX_LENGTH: 30;
+    /**
+     * Gone
+     */
+    readonly GONE: 410;
+    /**
+     * Gateway timeout
+     */
+    readonly GATEWAY_TIMEOUT: 504;
+    /**
+     * Too many requests
+     */
+    readonly TOO_MANY_REQUESTS: 429;
+    /**
+     * Maximum length of a file path segment
+     */
+    readonly FILE_PATH_SEGMENT_MAX_LENGTH: 8;
+    /**
+     * Default length of a short name (e.g. for default agent names)
+     */
+    readonly SHORT_NAME_LENGTH: 6;
+};
+/**
+ * Common time intervals in milliseconds
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const TIME_INTERVALS: {
+    /**
+     * One second in milliseconds
+     */
+    readonly SECOND: 1000;
+    /**
+     * Two seconds in milliseconds
+     */
+    readonly TWO_SECONDS: 2000;
+    /**
+     * One minute in milliseconds
+     */
+    readonly MINUTE: 60000;
+    /**
+     * Thirty seconds in milliseconds
+     */
+    readonly THIRTY_SECONDS: 30000;
+    /**
+     * Five seconds in milliseconds
+     */
+    readonly FIVE_SECONDS: 5000;
+};
+/**
+ * Common ports and network limits
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const NETWORK_LIMITS: {
+    /**
+     * Maximum valid port number
+     */
+    readonly MAX_PORT: 65535;
+};
+/**
+ * Common color and image constants
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const COLOR_CONSTANTS: {
+    /**
+     * Maximum value for a color channel (0-255)
+     */
+    readonly MAX_CHANNEL_VALUE: 255;
+    /**
+     * Number of possible colors in 24-bit color (0xFFFFFF)
+     */
+    readonly MAX_24BIT_COLOR: 16777215;
+    /**
+     * Base for hexadecimal strings
+     */
+    readonly HEX_BASE: 16;
+    /**
+     * Length of a hex color without alpha (e.g. "FF0000")
+     */
+    readonly HEX_COLOR_LENGTH: 6;
+    /**
+     * Full circle in degrees
+     */
+    readonly FULL_CIRCLE_DEGREES: 360;
+    /**
+     * Half circle in degrees
+     */
+    readonly HALF_CIRCLE_DEGREES: 180;
+};
+/**
+ * HTTP Status Codes
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const HTTP_STATUS_CODES: {
+    readonly OK: 200;
+    readonly CREATED: 201;
+    readonly BAD_REQUEST: 400;
+    readonly UNAUTHORIZED: 401;
+    readonly NOT_FOUND: 404;
+    readonly INTERNAL_SERVER_ERROR: 500;
+    readonly BAD_GATEWAY: 502;
+    readonly SERVICE_UNAVAILABLE: 503;
+    readonly GATEWAY_TIMEOUT: 504;
+    readonly TOO_MANY_REQUESTS: 429;
+};
 /**
  * Note: [💞] Ignore a discrepancy between file name and entity name
  */

package/esm/typings/src/execution/PromptResult.d.ts

@@ -1,5 +1,5 @@
+import type { ToolCall } from '../types/ToolCall';
 import type { string_date_iso8601, string_model_name, string_prompt } from '../types/typeAliases';
-import type { TODO_any } from '../utils/organization/TODO_any';
 import type { TODO_object } from '../utils/organization/TODO_object';
 import type { EmbeddingVector } from './EmbeddingVector';
 import type { Usage } from './Usage';
@@ -26,24 +26,7 @@ export type ChatPromptResult = CommonPromptResult & {
     /**
      * Optional tool calls made during the execution
      */
-    readonly toolCalls?: ReadonlyArray<{
-        /**
-         * Name of the tool
-         */
-        readonly name: string;
-        /**
-         * Arguments of the tool call
-         */
-        readonly arguments: string;
-        /**
-         * Result of the tool call
-         */
-        readonly result: string;
-        /**
-         * Raw tool call from the model
-         */
-        readonly rawToolCall: TODO_any;
-    }>;
+    readonly toolCalls?: ReadonlyArray<ToolCall>;
 };
 /**
  * Image prompt result

package/esm/typings/src/types/ToolCall.d.ts

@@ -0,0 +1,37 @@
+import type { string_date_iso8601 } from './typeAliases';
+import type { TODO_any } from '../utils/organization/TODO_any';
+/**
+ * Represents a single tool call with its inputs, outputs, and timing.
+ *
+ * Note: This is fully serializable as JSON.
+ */
+export type ToolCall = {
+    /**
+     * Name of the tool.
+     */
+    readonly name: string;
+    /**
+     * Arguments for the tool call.
+     */
+    readonly arguments?: string | Record<string, TODO_any>;
+    /**
+     * Result of the tool call.
+     */
+    readonly result?: TODO_any;
+    /**
+     * Raw tool call payload from the model.
+     */
+    readonly rawToolCall?: TODO_any;
+    /**
+     * Timestamp when the tool call was initiated.
+     */
+    readonly createdAt?: string_date_iso8601;
+    /**
+     * Errors thrown during tool execution.
+     */
+    readonly errors?: ReadonlyArray<TODO_any>;
+    /**
+     * Warnings reported during tool execution.
+     */
+    readonly warnings?: ReadonlyArray<TODO_any>;
+};

package/esm/typings/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.105.0-11`).
+ * It follows semantic versioning (e.g., `0.105.0-14`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/remote-server",
-    "version": "0.105.0-12",
+    "version": "0.105.0-15",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,
@@ -95,7 +95,7 @@
     "module": "./esm/index.es.js",
     "typings": "./esm/typings/src/_packages/remote-server.index.d.ts",
     "peerDependencies": {
-        "@promptbook/core": "0.105.0-12"
+        "@promptbook/core": "0.105.0-15"
     },
     "dependencies": {
         "colors": "1.4.0",
@@ -103,6 +103,7 @@
         "crypto-js": "4.2.0",
         "express": "4.21.2",
         "express-openapi-validator": "5.4.9",
+        "moment": "2.30.1",
         "papaparse": "5.4.1",
         "react": "18.2.0",
         "rxjs": "7.8.2",

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('path'), require('child_process'), require('colors'), require('spacetrim'), require('waitasecond'), require('express'), require('express-openapi-validator'), require('http'), require('socket.io'), require('swagger-ui-express'), require('crypto'), require('fs/promises'), require('rxjs'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('papaparse'), require('react'), require('react-dom/server')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'path', 'child_process', 'colors', 'spacetrim', 'waitasecond', 'express', 'express-openapi-validator', 'http', 'socket.io', 'swagger-ui-express', 'crypto', 'fs/promises', 'rxjs', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'papaparse', 'react', 'react-dom/server'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.path, global.child_process, global.colors, global.spaceTrim$1, global.waitasecond, global.express, global.OpenApiValidator, global.http, global.socket_io, global.swaggerUi, global.crypto, global.promises, global.rxjs, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.papaparse, global.react, global.server));
-})(this, (function (exports, path, child_process, colors, spaceTrim$1, waitasecond, express, OpenApiValidator, http, socket_io, swaggerUi, crypto, promises, rxjs, hexEncoder, sha256, cryptoJs, mimeTypes, papaparse, react, server) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('path'), require('child_process'), require('colors'), require('spacetrim'), require('waitasecond'), require('express'), require('express-openapi-validator'), require('http'), require('socket.io'), require('swagger-ui-express'), require('crypto'), require('fs/promises'), require('rxjs'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('crypto-js'), require('mime-types'), require('papaparse'), require('moment'), require('react'), require('react-dom/server')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'path', 'child_process', 'colors', 'spacetrim', 'waitasecond', 'express', 'express-openapi-validator', 'http', 'socket.io', 'swagger-ui-express', 'crypto', 'fs/promises', 'rxjs', 'crypto-js/enc-hex', 'crypto-js/sha256', 'crypto-js', 'mime-types', 'papaparse', 'moment', 'react', 'react-dom/server'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-remote-server"] = {}, global.path, global.child_process, global.colors, global.spaceTrim$1, global.waitasecond, global.express, global.OpenApiValidator, global.http, global.socket_io, global.swaggerUi, global.crypto, global.promises, global.rxjs, global.hexEncoder, global.sha256, global.cryptoJs, global.mimeTypes, global.papaparse, global.moment, global.react, global.server));
+})(this, (function (exports, path, child_process, colors, spaceTrim$1, waitasecond, express, OpenApiValidator, http, socket_io, swaggerUi, crypto, promises, rxjs, hexEncoder, sha256, cryptoJs, mimeTypes, papaparse, moment, react, server) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -32,6 +32,7 @@
     var swaggerUi__default = /*#__PURE__*/_interopDefaultLegacy(swaggerUi);
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
+    var moment__default = /*#__PURE__*/_interopDefaultLegacy(moment);
 
     // ⚠️ WARNING: This code has been generated so that any manual changes will be overwritten
     /**
@@ -47,7 +48,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-12';
+    const PROMPTBOOK_ENGINE_VERSION = '0.105.0-15';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -11769,6 +11770,25 @@
         }
     }
 
+    /**
+     * @@@
+     *
+     * @private utility for commitments
+     */
+    function formatOptionalInstructionBlock(label, content) {
+        const trimmedContent = spaceTrim$1.spaceTrim(content);
+        if (!trimmedContent) {
+            return '';
+        }
+        return spaceTrim$1.spaceTrim((block) => `
+        - ${label}:
+            ${block(trimmedContent
+        .split('\n')
+        .map((line) => `- ${line}`)
+        .join('\n'))}
+    `);
+    }
+
     /**
      * USE SEARCH ENGINE commitment definition
      *
@@ -11790,6 +11810,9 @@
         constructor() {
             super('USE SEARCH ENGINE', ['USE SEARCH']);
         }
+        get requiresContent() {
+            return false;
+        }
         /**
          * Short one-line description of USE SEARCH ENGINE.
          */
@@ -11838,6 +11861,7 @@
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
+            const extraInstructions = formatOptionalInstructionBlock('Search instructions', content);
             // Get existing tools array or create new one
             const existingTools = requirements.tools || [];
             // Add 'web_search' to tools if not already present
@@ -11896,13 +11920,14 @@
                     ...requirements.metadata,
                     useSearchEngine: content || true,
                 },
-            }, spaceTrim$1.spaceTrim(`
-                Tools:
-                You have access to the web search engine via the tool "web_search".
-                Use it to find up-to-date information or facts that you don't know.
-                When you need to know some information from the internet, use the tool provided to you.
-                Do not make up information when you can search for it.
-                Do not tell the user you cannot search for information, YOU CAN.
+            }, spaceTrim$1.spaceTrim((block) => `
+                    Tool:
+                    - You have access to the web search engine via the tool "web_search".
+                    - Use it to find up-to-date information or facts that you don't know.
+                    - When you need to know some information from the internet, use the tool provided to you.
+                    - Do not make up information when you can search for it.
+                    - Do not tell the user you cannot search for information, YOU CAN.
+                    ${block(extraInstructions)}
             `));
         }
         /**
@@ -11954,6 +11979,7 @@
      *
      * ```book
      * USE TIME
+     * USE TIME Prefer the user's local timezone.
      * ```
      *
      * @private [🪔] Maybe export the commitments through some package
@@ -11962,6 +11988,9 @@
         constructor() {
             super('USE TIME', ['CURRENT TIME', 'TIME', 'DATE']);
         }
+        get requiresContent() {
+            return false;
+        }
         /**
          * Short one-line description of USE TIME.
          */
@@ -11988,6 +12017,7 @@
             - This tool won't receive any input.
             - It outputs the current date and time as an ISO 8601 string.
             - Allows the agent to answer questions about the current time or date.
+            - The content following \`USE TIME\` is an arbitrary text that the agent should know (e.g. timezone preference).
 
             ## Examples
 
@@ -11997,9 +12027,17 @@
             PERSONA You are a helpful assistant who knows the current time.
             USE TIME
             \`\`\`
+
+            \`\`\`book
+            Travel Assistant
+
+            PERSONA You help travelers with planning.
+            USE TIME Prefer the user's local timezone.
+            \`\`\`
         `);
         }
         applyToAgentModelRequirements(requirements, content) {
+            const extraInstructions = formatOptionalInstructionBlock('Time instructions', content);
             // Get existing tools array or create new one
             const existingTools = requirements.tools || [];
             // Add 'get_current_time' to tools if not already present
@@ -12030,13 +12068,12 @@
                 metadata: {
                     ...requirements.metadata,
                 },
-            }, spaceTrim$1.spaceTrim(`
-                Tool:
-                You have access to the current date and time via the tool "get_current_time".
-                Use it to answer questions about the current date and time.
-                When you need to know the current date or time, use the tool provided to you.
-                Do not make up the current date or time; always use the tool to get accurate information.
-            `));
+            }, spaceTrim$1.spaceTrim((block) => `
+                    Time and date context:
+                    - It is ${moment__default["default"]().format('MMMM YYYY')} now.
+                    - If you need more precise current time information, use the tool "get_current_time".
+                    ${block(extraInstructions)}
+                `));
         }
         /**
          * Gets human-readable titles for tool functions provided by this commitment.