@promptbook/fake-llm 0.105.0-8 → 0.105.0

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

@@ -0,0 +1,48 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USE EMAIL commitment definition
+ *
+ * The `USE EMAIL` commitment enables the agent to send emails.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE EMAIL
+ * USE EMAIL Write always formal and polite emails, always greet.
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseEmailCommitmentDefinition extends BaseCommitmentDefinition<'USE EMAIL'> {
+    constructor();
+    get requiresContent(): boolean;
+    /**
+     * Short one-line description of USE EMAIL.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE EMAIL commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets the `send_email` tool function implementation.
+     *
+     * Note: [??] This function has implementation both for browser and node, this is the proxied one for browser.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/USE_EMAIL/resolveSendEmailToolForNode.d.ts

@@ -0,0 +1,11 @@
+import type { ToolFunction } from '../../_packages/types.index';
+/**
+ * Resolves the server-side implementation of the send_email tool for Node.js environments.
+ *
+ * This uses a lazy require so the core package can still load even if the Agents Server
+ * module is unavailable. When the server tool cannot be resolved, a fallback implementation
+ * throws a helpful error message.
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function resolveSendEmailToolForNode(): ToolFunction;

package/esm/typings/src/commitments/USE_EMAIL/sendEmailViaBrowser.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Client-side safe wrapper for sending emails.
+ *
+ * This function proxies requests to the Agents Server API endpoint for email queuing,
+ * making it safe to use in browser environments.
+ *
+ * @param args Email payload containing recipients, subject, and body
+ * @param agentsServerUrl The base URL of the agents server (defaults to current origin)
+ * @returns Result string from the server-side send_email tool
+ *
+ * @private internal utility for USE EMAIL commitment
+ */
+export declare function sendEmailViaBrowser(args: {
+    to: string[];
+    cc?: string[];
+    subject: string;
+    body: string;
+}, agentsServerUrl?: string): Promise<string>;

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

@@ -0,0 +1,46 @@
+import { string_javascript_name } from '../../_packages/types.index';
+import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
+import { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
+import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
+/**
+ * USE IMAGE GENERATOR commitment definition
+ *
+ * The `USE IMAGE GENERATOR` commitment indicates that the agent should utilize an image generation tool
+ * to create images based on text prompts.
+ *
+ * Example usage in agent source:
+ *
+ * ```book
+ * USE IMAGE GENERATOR
+ * USE IMAGE GENERATOR Create realistic images of nature
+ * ```
+ *
+ * @private [🪔] Maybe export the commitments through some package
+ */
+export declare class UseImageGeneratorCommitmentDefinition extends BaseCommitmentDefinition<'USE IMAGE GENERATOR' | 'USE IMAGE GENERATION' | 'IMAGE GENERATOR' | 'IMAGE GENERATION' | 'USE IMAGE'> {
+    constructor(type?: 'USE IMAGE GENERATOR' | 'USE IMAGE GENERATION' | 'IMAGE GENERATOR' | 'IMAGE GENERATION' | 'USE IMAGE');
+    /**
+     * Short one-line description of USE IMAGE GENERATOR.
+     */
+    get description(): string;
+    /**
+     * Icon for this commitment.
+     */
+    get icon(): string;
+    /**
+     * Markdown documentation for USE IMAGE GENERATOR commitment.
+     */
+    get documentation(): string;
+    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
+    /**
+     * Gets the `generate_image` tool function implementation.
+     */
+    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+}
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR.test.d.ts

@@ -0,0 +1 @@
+export {};

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.
      */
@@ -34,6 +35,10 @@ export declare class UseSearchEngineCommitmentDefinition extends BaseCommitmentD
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
     /**
      * Gets the `web_search` tool function implementation.
      */

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

@@ -0,0 +1 @@
+export {};

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.
      */
@@ -30,6 +32,10 @@ export declare class UseTimeCommitmentDefinition extends BaseCommitmentDefinitio
      */
     get documentation(): string;
     applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
     /**
      * Gets the `get_current_time` tool function implementation.
      */

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

@@ -69,4 +69,10 @@ export declare abstract class BaseCommitmentDefinition<TBookCommitment extends s
      * When the `applyToAgentModelRequirements` adds tools to the requirements, this method should return the corresponding function definitions.
      */
     getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment
+     *
+     * This is used in the UI to show a user-friendly name instead of the technical function name.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
 }

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

@@ -58,4 +58,10 @@ export type CommitmentDefinition = {
      * When the `applyToAgentModelRequirements` adds tools to the requirements, this method should return the corresponding function definitions.
      */
     getToolFunctions(): Record<string_javascript_name, ToolFunction>;
+    /**
+     * Gets human-readable titles for tool functions provided by this commitment
+     *
+     * This is used in the UI to show a user-friendly name instead of the technical function name.
+     */
+    getToolTitles(): Record<string_javascript_name, string>;
 };

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/commitments/_common/commitmentToolFunctions.d.ts

@@ -0,0 +1,26 @@
+import { ToolFunction } from '../../_packages/types.index';
+import { string_javascript_name } from '../../types/typeAliases';
+/**
+ * Map of tool functions keyed by function name.
+ *
+ * @private internal helper for commitment tool registry
+ */
+export type CommitmentToolFunctions = Record<string_javascript_name, ToolFunction>;
+/**
+ * Collects tool functions from all commitment definitions.
+ *
+ * @returns Map of tool function implementations.
+ * @private internal helper for commitment tool registry
+ */
+export declare function collectCommitmentToolFunctions(): CommitmentToolFunctions;
+/**
+ * Creates a proxy that resolves tool functions on demand.
+ *
+ * @param getFunctions - Provider of current tool functions.
+ * @returns Proxy exposing tool functions as properties.
+ * @private internal helper for commitment tool registry
+ */
+export declare function createToolFunctionsProxy(getFunctions: () => CommitmentToolFunctions): CommitmentToolFunctions;
+/**
+ * Note: [💞] Ignore a discrepancy between file name and entity name
+ */

package/esm/typings/src/commitments/_common/getAllCommitmentDefinitions.d.ts

@@ -0,0 +1,8 @@
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Gets all available commitment definitions
+ * @returns Array of all commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentDefinitions(): ReadonlyArray<CommitmentDefinition>;

package/esm/typings/src/commitments/_common/getAllCommitmentTypes.d.ts

@@ -0,0 +1,8 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Gets all available commitment types
+ * @returns Array of all commitment types
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForBrowser.d.ts

@@ -0,0 +1,9 @@
+import type { CommitmentToolFunctions } from './commitmentToolFunctions';
+/**
+ * Gets all function implementations provided by all commitments
+ *
+ * Note: This function is intended for browser use, there is also equivalent `getAllCommitmentsToolFunctionsForNode` for server use
+ *
+ * @public exported from `@promptbook/browser`
+ */
+export declare function getAllCommitmentsToolFunctionsForBrowser(): CommitmentToolFunctions;

package/esm/typings/src/commitments/_common/getAllCommitmentsToolFunctionsForNode.d.ts

@@ -0,0 +1,13 @@
+import { type CommitmentToolFunctions } from './commitmentToolFunctions';
+/**
+ * Gets all function implementations provided by all commitments
+ *
+ * Note: This function is intended for server use, there is also equivalent `getAllCommitmentsToolFunctionsForBrowser` for browser use
+ *
+ * @public exported from `@promptbook/node`
+ */
+export declare function getAllCommitmentsToolFunctionsForNode(): CommitmentToolFunctions;
+/**
+ * Note: [??] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [??] Unite `xxxForServer` and `xxxForNode` naming
+ */

package/esm/typings/src/commitments/_common/getAllCommitmentsToolTitles.d.ts

@@ -0,0 +1,7 @@
+import { string_javascript_name } from '../../types/typeAliases';
+/**
+ * Gets all tool titles provided by all commitments
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getAllCommitmentsToolTitles(): Record<string_javascript_name, string>;

package/esm/typings/src/commitments/_common/getCommitmentDefinition.d.ts

@@ -0,0 +1,10 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+import type { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Gets a commitment definition by its type
+ * @param type The commitment type to look up
+ * @returns The commitment definition or null if not found
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getCommitmentDefinition(type: BookCommitment): CommitmentDefinition | null;

package/esm/typings/src/commitments/_common/getGroupedCommitmentDefinitions.d.ts

@@ -0,0 +1,17 @@
+import { CommitmentDefinition } from '../_base/CommitmentDefinition';
+/**
+ * Grouped commitment definition
+ */
+type GroupedCommitmentDefinition = {
+    primary: CommitmentDefinition;
+    aliases: string[];
+};
+/**
+ * Gets all commitment definitions grouped by their aliases
+ *
+ * @returns Array of grouped commitment definitions
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function getGroupedCommitmentDefinitions(): ReadonlyArray<GroupedCommitmentDefinition>;
+export {};

package/esm/typings/src/commitments/_common/isCommitmentSupported.d.ts

@@ -0,0 +1,9 @@
+import type { BookCommitment } from '../_base/BookCommitment';
+/**
+ * Checks if a commitment type is supported
+ * @param type The commitment type to check
+ * @returns True if the commitment type is supported
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare function isCommitmentSupported(type: BookCommitment): boolean;

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

@@ -1,7 +1,3 @@
-import type { BookCommitment } from './_base/BookCommitment';
-import type { CommitmentDefinition } from './_base/CommitmentDefinition';
-import { ToolFunction } from '../scripting/javascript/JavascriptExecutionToolsOptions';
-import { string_javascript_name } from '../types/typeAliases';
 import { ActionCommitmentDefinition } from './ACTION/ACTION';
 import { ClosedCommitmentDefinition } from './CLOSED/CLOSED';
 import { ComponentCommitmentDefinition } from './COMPONENT/COMPONENT';
@@ -31,8 +27,12 @@ import { RuleCommitmentDefinition } from './RULE/RULE';
 import { SampleCommitmentDefinition } from './SAMPLE/SAMPLE';
 import { ScenarioCommitmentDefinition } from './SCENARIO/SCENARIO';
 import { StyleCommitmentDefinition } from './STYLE/STYLE';
+import { TeamCommitmentDefinition } from './TEAM/TEAM';
+import { TemplateCommitmentDefinition } from './TEMPLATE/TEMPLATE';
 import { UseCommitmentDefinition } from './USE/USE';
 import { UseBrowserCommitmentDefinition } from './USE_BROWSER/USE_BROWSER';
+import { UseEmailCommitmentDefinition } from './USE_EMAIL/USE_EMAIL';
+import { UseImageGeneratorCommitmentDefinition } from './USE_IMAGE_GENERATOR/USE_IMAGE_GENERATOR';
 import { UseMcpCommitmentDefinition } from './USE_MCP/USE_MCP';
 import { UseSearchEngineCommitmentDefinition } from './USE_SEARCH_ENGINE/USE_SEARCH_ENGINE';
 import { UseTimeCommitmentDefinition } from './USE_TIME/USE_TIME';
@@ -44,60 +44,7 @@ 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, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
-/**
- * Gets a commitment definition by its type
- * @param type The commitment type to look up
- * @returns The commitment definition or null if not found
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getCommitmentDefinition(type: BookCommitment): CommitmentDefinition | null;
-/**
- * Gets all available commitment definitions
- * @returns Array of all commitment definitions
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentDefinitions(): ReadonlyArray<CommitmentDefinition>;
-/**
- * Gets all available commitment types
- * @returns Array of all commitment types
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentTypes(): ReadonlyArray<BookCommitment>;
-/**
- * Checks if a commitment type is supported
- * @param type The commitment type to check
- * @returns True if the commitment type is supported
- *
- * @public exported from `@promptbook/core`
- */
-export declare function isCommitmentSupported(type: BookCommitment): boolean;
-/**
- * Grouped commitment definition
- *
- * @public exported from `@promptbook/core`
- */
-export type GroupedCommitmentDefinition = {
-    primary: CommitmentDefinition;
-    aliases: string[];
-};
-/**
- * Gets all commitment definitions grouped by their aliases
- *
- * @returns Array of grouped commitment definitions
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getGroupedCommitmentDefinitions(): ReadonlyArray<GroupedCommitmentDefinition>;
-/**
- * Gets all function implementations provided by all commitments
- *
- * @public exported from `@promptbook/core`
- */
-export declare function getAllCommitmentsToolFunctions(): Record<string_javascript_name, ToolFunction>;
+export declare const COMMITMENT_REGISTRY: readonly [PersonaCommitmentDefinition, PersonaCommitmentDefinition, KnowledgeCommitmentDefinition, MemoryCommitmentDefinition, MemoryCommitmentDefinition, StyleCommitmentDefinition, StyleCommitmentDefinition, RuleCommitmentDefinition, RuleCommitmentDefinition, LanguageCommitmentDefinition, LanguageCommitmentDefinition, SampleCommitmentDefinition, SampleCommitmentDefinition, FormatCommitmentDefinition, FormatCommitmentDefinition, TemplateCommitmentDefinition, TemplateCommitmentDefinition, FromCommitmentDefinition, ImportCommitmentDefinition, ImportCommitmentDefinition, ModelCommitmentDefinition, ModelCommitmentDefinition, ActionCommitmentDefinition, ActionCommitmentDefinition, ComponentCommitmentDefinition, MetaImageCommitmentDefinition, MetaColorCommitmentDefinition, MetaFontCommitmentDefinition, MetaLinkCommitmentDefinition, MetaCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, NoteCommitmentDefinition, GoalCommitmentDefinition, GoalCommitmentDefinition, InitialMessageCommitmentDefinition, UserMessageCommitmentDefinition, AgentMessageCommitmentDefinition, MessageCommitmentDefinition, MessageCommitmentDefinition, ScenarioCommitmentDefinition, ScenarioCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DeleteCommitmentDefinition, DictionaryCommitmentDefinition, OpenCommitmentDefinition, ClosedCommitmentDefinition, TeamCommitmentDefinition, UseBrowserCommitmentDefinition, UseSearchEngineCommitmentDefinition, UseTimeCommitmentDefinition, UseEmailCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseImageGeneratorCommitmentDefinition, UseMcpCommitmentDefinition, UseCommitmentDefinition, NotYetImplementedCommitmentDefinition<"EXPECT">, NotYetImplementedCommitmentDefinition<"BEHAVIOUR">, NotYetImplementedCommitmentDefinition<"BEHAVIOURS">, NotYetImplementedCommitmentDefinition<"AVOID">, NotYetImplementedCommitmentDefinition<"AVOIDANCE">, NotYetImplementedCommitmentDefinition<"CONTEXT">];
 /**
  * TODO: [🧠] Maybe create through standardized $register
  * Note: [💞] Ignore a discrepancy between file name and entity name

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

@@ -214,6 +214,12 @@ export declare const DEFAULT_INTERMEDIATE_FILES_STRATEGY: IntermediateFilesStrat
  * @public exported from `@promptbook/core`
  */
 export declare const DEFAULT_MAX_PARALLEL_COUNT = 5;
+/**
+ * The maximum number of concurrent uploads
+ *
+ * @public exported from `@promptbook/core`
+ */
+export declare const DEFAULT_MAX_CONCURRENT_UPLOADS = 5;
 /**
  * The maximum depth to which recursion can occur
  *

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

@@ -71,6 +71,135 @@ 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: {
+    /**
+     * Hundred milliseconds
+     */
+    readonly HUNDRED_MILLISECONDS: 100;
+    /**
+     * 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/executables/$provideExecutablesForNode.d.ts

@@ -9,4 +9,5 @@ export declare function $provideExecutablesForNode(options?: PrepareAndScrapeOpt
 /**
  * TODO: [🧠] Allow to override the executables without need to call `locatePandoc` / `locateLibreoffice` in case of provided
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */

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

@@ -1,8 +1,5 @@
 import type { ModelVariant } from '../types/ModelVariant';
-import type { number_usd } from '../types/typeAliases';
-import type { string_model_description } from '../types/typeAliases';
-import type { string_model_name } from '../types/typeAliases';
-import type { string_title } from '../types/typeAliases';
+import type { number_usd, string_model_description, string_model_name, string_title, string_url } from '../types/typeAliases';
 /**
  * Represents a model that can be used for prompt execution
  */
@@ -40,6 +37,10 @@ export type AvailableModel = {
         readonly prompt: number_usd;
         readonly output: number_usd;
     };
+    /**
+     * URL to the model (or provider) documentation
+     */
+    readonly documentationUrl?: string_url;
     /**
      * If the model is deprecated, it should not be used for new tasks
      */

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/execution/createPipelineExecutor/10-executePipeline.d.ts

@@ -1,8 +1,8 @@
 import type { PartialDeep, Promisable, ReadonlyDeep } from 'type-fest';
 import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { LlmCall } from '../../types/LlmCall';
 import type { InputParameters } from '../../types/typeAliases';
 import type { PipelineExecutorResult } from '../PipelineExecutorResult';
-import type { LlmCall } from '../../types/LlmCall';
 import type { CreatePipelineExecutorOptions } from './00-CreatePipelineExecutorOptions';
 /**
  * Options for executing an entire pipeline, including input parameters, pipeline context, and progress callbacks.

package/esm/typings/src/execution/utils/$provideExecutionToolsForNode.d.ts

@@ -10,4 +10,5 @@ import type { ExecutionTools } from '../ExecutionTools';
 export declare function $provideExecutionToolsForNode(options?: PrepareAndScrapeOptions): Promise<ExecutionTools>;
 /**
  * Note: [🟢] Code in this file should never be never released in packages that could be imported into browser environment
+ * TODO: [🏓] Unite `xxxForServer` and `xxxForNode` naming
  */