@promptbook/node 0.114.0-0 → 0.114.0-10

package/umd/src/llm-providers/openai/utils/loadOpenAiAgentsModule.d.ts

@@ -0,0 +1,203 @@
+/// <reference types="node" />
+/**
+ * Loads the OpenAI AgentKit SDK (`@openai/agents`) on demand
+ *
+ * Note: [🐌] The AgentKit SDK is one of the heaviest dependencies of Promptbook, loading it eagerly would slow down
+ *       every single run of the `ptbk` CLI utility even when no AgentKit agent is used
+ *
+ * @private internal utility of `@promptbook/openai`
+ */
+export declare const loadOpenAiAgentsModule: () => Promise<{
+    default: typeof import("@openai/agents");
+    applyPatchTool: typeof import("@openai/agents").applyPatchTool;
+    shellTool: typeof import("@openai/agents").shellTool;
+    realtime: typeof import("@openai/agents-realtime");
+    RuntimeEventEmitter: typeof import("events");
+    Agent: typeof import("@openai/agents").Agent;
+    AgentsError: typeof import("@openai/agents").AgentsError;
+    GuardrailExecutionError: typeof import("@openai/agents").GuardrailExecutionError;
+    InputGuardrailTripwireTriggered: typeof import("@openai/agents").InputGuardrailTripwireTriggered;
+    MaxTurnsExceededError: typeof import("@openai/agents").MaxTurnsExceededError;
+    ModelBehaviorError: typeof import("@openai/agents").ModelBehaviorError;
+    OutputGuardrailTripwireTriggered: typeof import("@openai/agents").OutputGuardrailTripwireTriggered;
+    ToolInputGuardrailTripwireTriggered: typeof import("@openai/agents").ToolInputGuardrailTripwireTriggered;
+    ToolOutputGuardrailTripwireTriggered: typeof import("@openai/agents").ToolOutputGuardrailTripwireTriggered;
+    ToolCallError: typeof import("@openai/agents").ToolCallError;
+    ToolTimeoutError: typeof import("@openai/agents").ToolTimeoutError;
+    UserError: typeof import("@openai/agents").UserError;
+    SystemError: typeof import("@openai/agents").SystemError;
+    RunAgentUpdatedStreamEvent: typeof import("@openai/agents").RunAgentUpdatedStreamEvent;
+    RunRawModelStreamEvent: typeof import("@openai/agents").RunRawModelStreamEvent;
+    RunItemStreamEvent: typeof import("@openai/agents").RunItemStreamEvent;
+    defineOutputGuardrail: typeof import("@openai/agents").defineOutputGuardrail;
+    ToolGuardrailFunctionOutputFactory: {
+        allow(outputInfo?: any): import("@openai/agents").ToolGuardrailFunctionOutput;
+        rejectContent(message: string, outputInfo?: any): import("@openai/agents").ToolGuardrailFunctionOutput;
+        throwException(outputInfo?: any): import("@openai/agents").ToolGuardrailFunctionOutput;
+    };
+    defineToolInputGuardrail: typeof import("@openai/agents").defineToolInputGuardrail;
+    defineToolOutputGuardrail: typeof import("@openai/agents").defineToolOutputGuardrail;
+    resolveToolInputGuardrails: typeof import("@openai/agents").resolveToolInputGuardrails;
+    resolveToolOutputGuardrails: typeof import("@openai/agents").resolveToolOutputGuardrails;
+    getHandoff: typeof import("@openai/agents").getHandoff;
+    getTransferMessage: typeof import("@openai/agents").getTransferMessage;
+    Handoff: typeof import("@openai/agents").Handoff;
+    handoff: typeof import("@openai/agents").handoff;
+    assistant: typeof import("@openai/agents").assistant;
+    system: typeof import("@openai/agents").system;
+    user: typeof import("@openai/agents").user;
+    extractAllTextOutput: typeof import("@openai/agents").extractAllTextOutput;
+    RunHandoffCallItem: typeof import("@openai/agents").RunHandoffCallItem;
+    RunHandoffOutputItem: typeof import("@openai/agents").RunHandoffOutputItem;
+    RunMessageOutputItem: typeof import("@openai/agents").RunMessageOutputItem;
+    RunReasoningItem: typeof import("@openai/agents").RunReasoningItem;
+    RunToolApprovalItem: typeof import("@openai/agents").RunToolApprovalItem;
+    RunToolCallItem: typeof import("@openai/agents").RunToolCallItem;
+    RunToolCallOutputItem: typeof import("@openai/agents").RunToolCallOutputItem;
+    AgentHooks: typeof import("@openai/agents").AgentHooks;
+    getLogger: typeof import("@openai/agents").getLogger;
+    applyDiff: typeof import("@openai/agents").applyDiff;
+    getAllMcpTools: typeof import("@openai/agents").getAllMcpTools;
+    invalidateServerToolsCache: typeof import("@openai/agents").invalidateServerToolsCache;
+    mcpToFunctionTool: typeof import("@openai/agents").mcpToFunctionTool;
+    MCPServerStdio: typeof import("@openai/agents").MCPServerStdio;
+    MCPServerStreamableHttp: typeof import("@openai/agents").MCPServerStreamableHttp;
+    MCPServerSSE: typeof import("@openai/agents").MCPServerSSE;
+    MCPServers: typeof import("@openai/agents").MCPServers;
+    connectMcpServers: typeof import("@openai/agents").connectMcpServers;
+    createMCPToolStaticFilter: typeof import("@openai/agents").createMCPToolStaticFilter;
+    OPENAI_DEFAULT_MODEL_ENV_VARIABLE_NAME: "OPENAI_DEFAULT_MODEL";
+    gpt5ReasoningSettingsRequired: typeof import("@openai/agents").gpt5ReasoningSettingsRequired;
+    getDefaultModel: typeof import("@openai/agents").getDefaultModel;
+    getDefaultModelSettings: typeof import("@openai/agents").getDefaultModelSettings;
+    isGpt5Default: typeof import("@openai/agents").isGpt5Default;
+    setDefaultModelProvider: typeof import("@openai/agents").setDefaultModelProvider;
+    RunResult: typeof import("@openai/agents").RunResult;
+    StreamedRunResult: typeof import("@openai/agents").StreamedRunResult;
+    run: typeof import("@openai/agents").run;
+    Runner: typeof import("@openai/agents").Runner;
+    RunContext: typeof import("@openai/agents").RunContext;
+    RunState: typeof import("@openai/agents").RunState;
+    computerTool: typeof import("@openai/agents").computerTool;
+    hostedMcpTool: typeof import("@openai/agents").hostedMcpTool;
+    tool: typeof import("@openai/agents").tool;
+    invokeFunctionTool: typeof import("@openai/agents").invokeFunctionTool;
+    getGlobalTraceProvider: typeof import("@openai/agents").getGlobalTraceProvider;
+    TraceProvider: typeof import("@openai/agents").TraceProvider;
+    runToolInputGuardrails: typeof import("@openai/agents").runToolInputGuardrails;
+    runToolOutputGuardrails: typeof import("@openai/agents").runToolOutputGuardrails;
+    RequestUsage: typeof import("@openai/agents").RequestUsage;
+    Usage: typeof import("@openai/agents").Usage;
+    isOpenAIResponsesCompactionAwareSession: typeof import("@openai/agents").isOpenAIResponsesCompactionAwareSession;
+    MemorySession: typeof import("@openai/agents").MemorySession;
+    protocol: typeof import("@openai/agents-core/dist/types/protocol");
+    addTraceProcessor(processor: import("@openai/agents").TracingProcessor): void;
+    setTraceProcessors(processors: import("@openai/agents").TracingProcessor[]): void;
+    setTracingDisabled(disabled: boolean): void;
+    startTraceExportLoop(): void;
+    getCurrentSpan: typeof import("@openai/agents").getCurrentSpan;
+    getCurrentTrace: typeof import("@openai/agents").getCurrentTrace;
+    getOrCreateTrace: typeof import("@openai/agents").getOrCreateTrace;
+    resetCurrentSpan: typeof import("@openai/agents").resetCurrentSpan;
+    setCurrentSpan: typeof import("@openai/agents").setCurrentSpan;
+    withTrace: typeof import("@openai/agents").withTrace;
+    BatchTraceProcessor: typeof import("@openai/agents").BatchTraceProcessor;
+    ConsoleSpanExporter: typeof import("@openai/agents").ConsoleSpanExporter;
+    NoopSpan: typeof import("@openai/agents").NoopSpan;
+    Span: typeof import("@openai/agents").Span;
+    NoopTrace: typeof import("@openai/agents").NoopTrace;
+    Trace: typeof import("@openai/agents").Trace;
+    generateGroupId: typeof import("@openai/agents").generateGroupId;
+    generateSpanId: typeof import("@openai/agents").generateSpanId;
+    generateTraceId: typeof import("@openai/agents").generateTraceId;
+    createResponseSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").ResponseSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").ResponseSpanData>;
+    createAgentSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").AgentSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").AgentSpanData>;
+    createFunctionSpan(options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").FunctionSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").FunctionSpanData>;
+    createHandoffSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").HandoffSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").HandoffSpanData>;
+    createGenerationSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").GenerationSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").GenerationSpanData>;
+    createCustomSpan(options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").CustomSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").CustomSpanData>;
+    createGuardrailSpan(options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").GuardrailSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").GuardrailSpanData>;
+    createTranscriptionSpan(options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").TranscriptionSpanData>> & {
+        data: {
+            input: {
+                data: string;
+                format: (string & {}) | "pcm";
+            };
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").TranscriptionSpanData>;
+    createSpeechSpan(options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").SpeechSpanData>> & {
+        data: {
+            output: {
+                data: string;
+                format: (string & {}) | "pcm";
+            };
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").SpeechSpanData>;
+    createSpeechGroupSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").SpeechGroupSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").SpeechGroupSpanData>;
+    createMCPListToolsSpan(options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").MCPListToolsSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined): import("@openai/agents").Span<import("@openai/agents").MCPListToolsSpanData>;
+    withResponseSpan: <TOutput>(fn: (span: import("@openai/agents").Span<import("@openai/agents").ResponseSpanData>) => Promise<TOutput>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").ResponseSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput>;
+    withAgentSpan: <TOutput_1>(fn: (span: import("@openai/agents").Span<import("@openai/agents").AgentSpanData>) => Promise<TOutput_1>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").AgentSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_1>;
+    withFunctionSpan: <TOutput_2>(fn: (span: import("@openai/agents").Span<import("@openai/agents").FunctionSpanData>) => Promise<TOutput_2>, options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").FunctionSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_2>;
+    withHandoffSpan: <TOutput_3>(fn: (span: import("@openai/agents").Span<import("@openai/agents").HandoffSpanData>) => Promise<TOutput_3>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").HandoffSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_3>;
+    withGenerationSpan: <TOutput_4>(fn: (span: import("@openai/agents").Span<import("@openai/agents").GenerationSpanData>) => Promise<TOutput_4>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").GenerationSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_4>;
+    withCustomSpan: <TOutput_5>(fn: (span: import("@openai/agents").Span<import("@openai/agents").CustomSpanData>) => Promise<TOutput_5>, options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").CustomSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_5>;
+    withGuardrailSpan: <TOutput_6>(fn: (span: import("@openai/agents").Span<import("@openai/agents").GuardrailSpanData>) => Promise<TOutput_6>, options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").GuardrailSpanData>> & {
+        data: {
+            name: string;
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_6>;
+    withTranscriptionSpan: <TOutput_7>(fn: (span: import("@openai/agents").Span<import("@openai/agents").TranscriptionSpanData>) => Promise<TOutput_7>, options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").TranscriptionSpanData>> & {
+        data: {
+            input: {
+                data: string;
+                format: (string & {}) | "pcm";
+            };
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_7>;
+    withSpeechSpan: <TOutput_8>(fn: (span: import("@openai/agents").Span<import("@openai/agents").SpeechSpanData>) => Promise<TOutput_8>, options: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").SpeechSpanData>> & {
+        data: {
+            output: {
+                data: string;
+                format: (string & {}) | "pcm";
+            };
+        };
+    }, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_8>;
+    withSpeechGroupSpan: <TOutput_9>(fn: (span: import("@openai/agents").Span<import("@openai/agents").SpeechGroupSpanData>) => Promise<TOutput_9>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").SpeechGroupSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_9>;
+    withMCPListToolsSpan: <TOutput_10>(fn: (span: import("@openai/agents").Span<import("@openai/agents").MCPListToolsSpanData>) => Promise<TOutput_10>, options?: import("@openai/agents-core/types").DeepPartial<import("@openai/agents-core/dist/tracing/provider").CreateSpanOptions<import("@openai/agents").MCPListToolsSpanData>> | undefined, parent?: import("@openai/agents").Trace | import("@openai/agents").Span<any> | undefined) => Promise<TOutput_10>;
+    OpenAIProvider: typeof import("@openai/agents").OpenAIProvider;
+    OpenAIResponsesModel: typeof import("@openai/agents").OpenAIResponsesModel;
+    OpenAIChatCompletionsModel: typeof import("@openai/agents").OpenAIChatCompletionsModel;
+    setDefaultOpenAIClient: typeof import("@openai/agents").setDefaultOpenAIClient;
+    setOpenAIAPI: typeof import("@openai/agents").setOpenAIAPI;
+    setDefaultOpenAIKey: typeof import("@openai/agents").setDefaultOpenAIKey;
+    setTracingExportApiKey: typeof import("@openai/agents").setTracingExportApiKey;
+    setDefaultOpenAITracingExporter: typeof import("@openai/agents").setDefaultOpenAITracingExporter;
+    OpenAITracingExporter: typeof import("@openai/agents").OpenAITracingExporter;
+    webSearchTool: typeof import("@openai/agents").webSearchTool;
+    fileSearchTool: typeof import("@openai/agents").fileSearchTool;
+    codeInterpreterTool: typeof import("@openai/agents").codeInterpreterTool;
+    imageGenerationTool: typeof import("@openai/agents").imageGenerationTool;
+    OpenAIConversationsSession: typeof import("@openai/agents").OpenAIConversationsSession;
+    startOpenAIConversationsSession: typeof import("@openai/agents").startOpenAIConversationsSession;
+    OpenAIResponsesCompactionSession: typeof import("@openai/agents").OpenAIResponsesCompactionSession;
+}>;

package/umd/src/llm-providers/openai/utils/uploadFilesToOpenAi.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 /**
  * Uploads files to OpenAI and returns their IDs
  *

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/utils/agent-message-runtime/resolveAgentMessageRuntimeActivity.d.ts

@@ -5,9 +5,9 @@
  * Claude Code `--output-format stream-json`) into a live runtime log file next to the queued
  * message. This helper extracts the most recent natural-language assistant narration so the
  * durable chat can show what the agent is doing right now instead of a generic thinking
- * placeholder. Only plain assistant text is surfaced; raw tool payloads, JSON envelopes and
- * other technical details are intentionally ignored, and harnesses that do not stream
- * structured text simply resolve to `null` so the caller keeps its existing behavior.
+ * placeholder. Only concrete, safe activity is surfaced; raw tool payloads, JSON envelopes,
+ * and private reasoning are intentionally ignored. When no concrete activity is known, this
+ * resolves to `null` so the caller keeps the browser's rotating generic thinking state.
  *
  * @param logText - Raw runtime log content.
  * @returns Latest human-readable activity snippet, or `null` when none can be resolved.

package/umd/src/utils/agents/terminalAgentAvatarVisual.d.ts

@@ -75,9 +75,12 @@ export type CreateTerminalAgentAvatarVisualOptions = {
      */
     readonly colorDepth?: AsciiArtColorDepth;
     /**
-     * Platform-specific canvas factory used to rasterize the visual.
+     * Platform-specific canvas factory used to rasterize pixel-based visuals.
+     *
+     * Character-based visuals such as `AsciiOctopus` paint the terminal grid directly, so they
+     * render without any canvas; a pixel-based visual renders an empty frame when it is missing.
      */
-    readonly createCanvas: CreateCanvasForAsciiArt;
+    readonly createCanvas?: CreateCanvasForAsciiArt;
 };
 /**
  * Resolves the built-in avatar visual selected for terminal rendering of one agent source.

package/umd/src/utils/ascii-art/convertImageDataToAsciiArt.d.ts

@@ -62,6 +62,12 @@ export type ConvertImageDataToAsciiArtOptions = {
      */
     readonly alphaThreshold?: number;
 };
+/**
+ * Default alpha channel value below which a cell is rendered as terminal background.
+ *
+ * @private within the repository
+ */
+export declare const DEFAULT_ALPHA_THRESHOLD = 32;
 /**
  * Converts raw RGBA image pixels into colored ASCII art for ANSI terminals.
  *

package/umd/src/utils/ascii-art/createAnsiColorCode.d.ts

@@ -0,0 +1,46 @@
+import type { AsciiArtColorDepth } from './convertImageDataToAsciiArt';
+/**
+ * ANSI escape sequence that resets all colors and attributes.
+ *
+ * @private within the repository
+ */
+export declare const ANSI_RESET = "\u001B[0m";
+/**
+ * One opaque 24-bit color which should be written into an ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export type AnsiRgbColor = {
+    /**
+     * Red channel in the range `[0, 255]`.
+     */
+    readonly red: number;
+    /**
+     * Green channel in the range `[0, 255]`.
+     */
+    readonly green: number;
+    /**
+     * Blue channel in the range `[0, 255]`.
+     */
+    readonly blue: number;
+};
+/**
+ * Creates the ANSI escape code that sets the foreground color of following characters.
+ *
+ * @param color Color painted onto the characters.
+ * @param colorDepth Color depth supported by the target terminal.
+ * @returns ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export declare function createAnsiForegroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;
+/**
+ * Creates the ANSI escape code that sets the background color of following characters.
+ *
+ * @param color Color painted behind the characters.
+ * @param colorDepth Color depth supported by the target terminal.
+ * @returns ANSI escape sequence.
+ *
+ * @private within the repository
+ */
+export declare function createAnsiBackgroundColorCode(color: AnsiRgbColor, colorDepth: AsciiArtColorDepth): string;

package/umd/src/utils/misc/createLazyModuleLoader.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Creates a loader which imports one module on the first call and reuses the very same module afterwards
+ *
+ * Note: [🐌] Heavy third-party dependencies are imported lazily to keep the startup of the Promptbook CLI fast.
+ *       A statically imported dependency is loaded every single time the bundle is loaded, even when the running
+ *       command never touches it. A lazily imported dependency is loaded only when the feature is really used.
+ *
+ * @example
+ * const loadJsdomModule = createLazyModuleLoader(() => import('jsdom'));
+ * const { JSDOM } = await loadJsdomModule();
+ *
+ * @private internal utility of Promptbook
+ */
+export declare function createLazyModuleLoader<TModule>(importModule: () => Promise<TModule>): () => Promise<TModule>;

package/umd/src/utils/misc/debounce.d.ts

@@ -1,7 +1,9 @@
 import type { TODO_any } from '../organization/TODO_any';
 /**
- * Handles debounce.
+ * Creates a debounced function that runs after calls have been quiet for the given delay.
  *
  * @public exported from `@promptbook/utils`
  */
-export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): (...args: Parameters<T>) => void;
+export declare function debounce<T extends (...args: TODO_any[]) => void>(fn: T, delay: number): ((...args: Parameters<T>) => void) & {
+    cancel: () => void;
+};

package/umd/src/utils/misc/debounce.test.d.ts

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

package/umd/src/version.d.ts

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.113.1-0`).
+ * It follows semantic versioning (e.g., `0.114.0-9`).
  *
  * @generated
  */

package/esm/src/cli/cli-commands/common/harness/extractHarnessVersionFromOutput.d.ts

@@ -1,11 +0,0 @@
-/**
- * Extracts the version from the raw output of a harness `--version` command.
- *
- * Harness CLIs print their version in many shapes, for example `2.1.199 (Claude Code)`,
- * `codex-cli 0.144.4`, `GitHub Copilot CLI 1.0.61.` or after unrelated deprecation warning lines,
- * so the first version-looking token of the first matching line wins.
- *
- * @returns The parsed version or `null` when the output contains no version
- * @private internal utility of `promptbookCli`
- */
-export declare function extractHarnessVersionFromOutput(output: string): string | null;

package/esm/src/cli/cli-commands/common/harness/isHarnessVersionOutdated.d.ts

@@ -1,9 +0,0 @@
-/**
- * Compares the installed harness version with the newest version published to npm.
- *
- * Only the numeric `major.minor.patch` segments are compared and pre-release suffixes are ignored,
- * so a harness installed from a pre-release build of the newest version is not reported as outdated.
- *
- * @private internal utility of `promptbookCli`
- */
-export declare function isHarnessVersionOutdated(installedVersion: string, latestVersion: string): boolean;

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

@@ -1,48 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
-export type { MemoryToolRecord, MemoryToolRuntimeAdapter, MemoryToolRuntimeContext } from './MemoryToolRuntimeAdapter';
-export { setMemoryToolRuntimeAdapter } from './setMemoryToolRuntimeAdapter';
-/**
- * MEMORY commitment definition
- *
- * The MEMORY commitment is similar to KNOWLEDGE but has a focus on remembering past
- * interactions and user preferences. It helps the agent maintain context about the
- * user's history, preferences, and previous conversations.
- *
- * Example usage in agent source:
- *
- * ```book
- * MEMORY User prefers detailed technical explanations
- * MEMORY Previously worked on React projects
- * MEMORY Timezone: UTC-5 (Eastern Time)
- * ```
- *
- * @private [🪔] Maybe export the commitments through some package
- */
-export declare class MemoryCommitmentDefinition extends BaseCommitmentDefinition<'MEMORY' | 'MEMORIES'> {
-    constructor(type?: 'MEMORY' | 'MEMORIES');
-    get requiresContent(): boolean;
-    /**
-     * Short one-line description of MEMORY.
-     */
-    get description(): string;
-    /**
-     * Icon for this commitment.
-     */
-    get icon(): string;
-    /**
-     * Markdown documentation for MEMORY commitment.
-     */
-    get documentation(): string;
-    applyToAgentModelRequirements(requirements: AgentModelRequirements, content: string): AgentModelRequirements;
-    /**
-     * Gets human-readable titles for MEMORY tool functions.
-     */
-    getToolTitles(): Record<string_javascript_name, string>;
-    /**
-     * Gets MEMORY tool function implementations.
-     */
-    getToolFunctions(): Record<string_javascript_name, ToolFunction>;
-}

package/esm/src/commitments/MEMORY/MemoryToolNames.d.ts

@@ -1,11 +0,0 @@
-/**
- * Names of tools used by the MEMORY commitment.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare const MemoryToolNames: {
-    readonly retrieve: string;
-    readonly store: string;
-    readonly update: string;
-    readonly delete: string;
-};

package/esm/src/commitments/MEMORY/MemoryToolRuntimeAdapter.d.ts

@@ -1,149 +0,0 @@
-import type { TODO_any } from '../../utils/organization/TODO_any';
-/**
- * Tool arguments for retrieving memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type RetrieveMemoryToolArgs = {
-    query?: string;
-    limit?: number;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for storing memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type StoreMemoryToolArgs = {
-    content?: string;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for updating memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type UpdateMemoryToolArgs = {
-    memoryId?: string;
-    content?: string;
-    isGlobal?: boolean;
-    [key: string]: TODO_any;
-};
-/**
- * Tool arguments for deleting memory.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type DeleteMemoryToolArgs = {
-    memoryId?: string;
-    [key: string]: TODO_any;
-};
-/**
- * Memory record returned by runtime adapters.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRecord = {
-    id?: string;
-    content: string;
-    isGlobal: boolean;
-    createdAt?: string;
-    updatedAt?: string;
-};
-/**
- * Runtime context for MEMORY tools resolved from hidden tool arguments.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRuntimeContext = {
-    readonly enabled: boolean;
-    readonly userId?: number;
-    readonly username?: string;
-    readonly agentId?: string;
-    readonly agentName?: string;
-    readonly isTeamConversation: boolean;
-    readonly isPrivateMode: boolean;
-};
-/**
- * Result payload returned by retrieve memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type RetrieveMemoryToolResult = {
-    action: 'retrieve';
-    status: 'ok' | 'disabled' | 'error';
-    query?: string;
-    memories: MemoryToolRecord[];
-    message?: string;
-};
-/**
- * Result payload returned by store memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type StoreMemoryToolResult = {
-    action: 'store';
-    status: 'stored' | 'disabled' | 'error';
-    memory?: MemoryToolRecord;
-    message?: string;
-};
-/**
- * Result payload returned by update memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type UpdateMemoryToolResult = {
-    action: 'update';
-    status: 'updated' | 'disabled' | 'error';
-    memory?: MemoryToolRecord;
-    message?: string;
-};
-/**
- * Result payload returned by delete memory tool.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type DeleteMemoryToolResult = {
-    action: 'delete';
-    status: 'deleted' | 'disabled' | 'error';
-    memoryId?: string;
-    message?: string;
-};
-/**
- * Union of all MEMORY tool actions.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolAction = RetrieveMemoryToolResult['action'] | StoreMemoryToolResult['action'] | UpdateMemoryToolResult['action'] | DeleteMemoryToolResult['action'];
-/**
- * Union of all MEMORY tool result payloads.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolResult = RetrieveMemoryToolResult | StoreMemoryToolResult | UpdateMemoryToolResult | DeleteMemoryToolResult;
-/**
- * Runtime adapter interface used by MEMORY tools.
- *
- * @private type of MemoryCommitmentDefinition
- */
-export type MemoryToolRuntimeAdapter = {
-    retrieveMemories(args: {
-        query?: string;
-        limit?: number;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord[]>;
-    storeMemory(args: {
-        content: string;
-        isGlobal: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    updateMemory(args: {
-        memoryId: string;
-        content: string;
-        isGlobal?: boolean;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<MemoryToolRecord>;
-    deleteMemory(args: {
-        memoryId: string;
-    }, runtimeContext: MemoryToolRuntimeContext): Promise<{
-        id?: string;
-    }>;
-};

package/esm/src/commitments/MEMORY/createMemorySystemMessage.d.ts

@@ -1,6 +0,0 @@
-/**
- * Builds the MEMORY instruction block appended to the system message.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemorySystemMessage(extraInstructions: string): string;

package/esm/src/commitments/MEMORY/createMemoryToolFunctions.d.ts

@@ -1,8 +0,0 @@
-import type { ToolFunction } from '../../scripting/javascript/JavascriptExecutionToolsOptions';
-import type { string_javascript_name } from '../../types/string_person_fullname';
-/**
- * Gets MEMORY tool function implementations.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemoryToolFunctions(): Record<string_javascript_name, ToolFunction>;

package/esm/src/commitments/MEMORY/createMemoryTools.d.ts

@@ -1,14 +0,0 @@
-import type { AgentModelRequirements } from '../../book-2.0/agent-source/AgentModelRequirements';
-/**
- * Concrete type of tool definitions in `AgentModelRequirements`.
- *
- * @private type of MemoryCommitmentDefinition
- */
-type AgentModelTools = NonNullable<AgentModelRequirements['tools']>;
-/**
- * Creates MEMORY tool definitions while preserving already-registered tools.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function createMemoryTools(existingTools: AgentModelRequirements['tools']): AgentModelTools;
-export {};

package/esm/src/commitments/MEMORY/getMemoryCommitmentDocumentation.d.ts

@@ -1,6 +0,0 @@
-/**
- * Markdown documentation for MEMORY commitment.
- *
- * @private function of MemoryCommitmentDefinition
- */
-export declare function getMemoryCommitmentDocumentation(type: 'MEMORY' | 'MEMORIES'): string;