@promptbook/utils 0.114.0-1 → 0.114.0-3

package/README.md

@@ -807,26 +807,27 @@ ptbk coder verify
 | ------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --- | ------ | ---- | ----- | ------------------------------------------------------------------------ |
 | `ptbk coder init`                     | Creates `prompts/`, `prompts/done/`, the project-generic template files materialized in `prompts/templates/` (currently `common.md`), and a starter `AGENTS.md`; ensures `.env` contains `CODING_AGENT_GIT_NAME`, `CODING_AGENT_GIT_EMAIL`, and `CODING_AGENT_GIT_SIGNING_KEY`; adds helper coder scripts to `package.json`; ensures `.gitignore` contains `/.promptbook`; and configures `.vscode/settings.json` to save pasted prompt images into `prompts/screenshots/`. |
 | `ptbk coder generate-boilerplates`    | Creates new prompt markdown files with fresh emoji tags so you can quickly fill in coding tasks; `--template` accepts either a built-in alias or a markdown file path relative to the project root.                                                                                                                                                                                                                                                                         |
-| `ptbk coder run`                      | Picks the next ready prompt, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.                                                                                                                                                                  |
+| `ptbk coder run`                      | Picks the next ready prompt, can run tests before coding to stop or repair pre-existing failures, appends optional context, runs it through the selected coding agent, can optionally verify each attempt with a shell test command and feed failing output back for retries, then marks success or failure, commits the result, and pushes only when `--auto-push` is enabled.                                                                                             |
 | `ptbk coder find-refactor-candidates` | Scans the repository for oversized or overpacked files and writes prompt files for likely refactors; `--level <xlow                                                                                                                                                                                                                                                                                                                                                         | low | medium | high | xhigh | extreme>` ranges from a very benevolent scan to a very aggressive sweep. |
 | `ptbk coder verify`                   | Walks through completed prompts, archives truly finished work, and adds follow-up repair prompts for unfinished results.                                                                                                                                                                                                                                                                                                                                                    |
 
 #### Most useful `ptbk coder run` flags
 
-| Flag                       | Purpose                                                                                            |
-| -------------------------- | -------------------------------------------------------------------------------------------------- |
-| `--harness <name>`         | Selects the coding harness.                                                                        |
-| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`. |
-| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                 |
-| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.   |
-| `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                       |
-| `--no-auto`                | Waits for user confirmation before each prompt instead of running automatically through the queue. |
-| `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                             |
-| `--priority <n>`           | Runs only prompts at or above the given priority.                                                  |
-| `--dry-run`                | Prints which prompts are ready instead of executing them.                                          |
-| `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                     |
-| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                               |
-| `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                              |
+| Flag                       | Purpose                                                                                                                                                                                |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `--harness <name>`         | Selects the coding harness.                                                                                                                                                            |
+| `--model <model>`          | Chooses the runner model; required for `openai-codex` and `gemini`, optional for `github-copilot`.                                                                                     |
+| `--context <text-or-file>` | Appends extra instructions inline or from a file like `AGENTS.md`.                                                                                                                     |
+| `--test <command>`         | Runs a verification command after each prompt attempt and feeds failing output back for retries.                                                                                       |
+| `--test-before <mode>`     | Runs tests before coding: `no` (default), `yes-and-fail` (stop with results), or `yes-and-fix` (create one repair prompt first); defaults to `npm test` when enabled without `--test`. |
+| `--thinking-level <level>` | Sets reasoning effort for supported runners.                                                                                                                                           |
+| `--no-auto`                | Waits for user confirmation before each prompt instead of running automatically through the queue.                                                                                     |
+| `--ignore-git-changes`     | Disables the clean-working-tree guard.                                                                                                                                                 |
+| `--priority <n>`           | Runs only prompts at or above the given priority.                                                                                                                                      |
+| `--dry-run`                | Prints which prompts are ready instead of executing them.                                                                                                                              |
+| `--allow-credits`          | Lets OpenAI Codex spend credits when required.                                                                                                                                         |
+| `--auto-push`              | Pushes each successful coding-agent commit to the configured remote.                                                                                                                   |
+| `--auto-migrate`           | Runs testing-server database migrations after each successful prompt.                                                                                                                  |
 
 #### Typical usage pattern
 

package/esm/index.es.js

@@ -17,7 +17,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.114.0-1';
+const PROMPTBOOK_ENGINE_VERSION = '0.114.0-3';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name

package/esm/src/book-2.0/book-language-documentation/BookLanguageManualDictionary.d.ts

@@ -86,9 +86,7 @@ export type BookLanguageManualDictionary = {
     readonly metadataLabels: {
         readonly bookLanguageVersion: string;
         readonly generatedAt: string;
-        readonly commitmentGroups: string;
-        readonly implementedCommitments: string;
-        readonly placeholderCommitments: string;
+        readonly commitmentCount: string;
     };
     /**
      * Heading of the table of contents.
@@ -128,7 +126,6 @@ export type BookLanguageManualDictionary = {
     readonly primitivesSections: {
         readonly coreSyntax: BookLanguageManualChapter;
         readonly references: BookLanguageManualChapter;
-        readonly keywordsTitle: string;
     };
     /**
      * Suffixes distinguishing a server-specific catalog from the portable one.
@@ -141,18 +138,7 @@ export type BookLanguageManualDictionary = {
      * Labels used in every commitment catalog entry.
      */
     readonly commitmentLabels: {
-        readonly status: string;
         readonly aliases: string;
-        readonly semantics: string;
-        readonly typeSchema: string;
-        readonly blockSchema: string;
-        readonly lowLevelNotice: string;
-        readonly usage: string;
-        readonly usageOccurrence: string;
-        readonly usageOccurrences: string;
-        readonly statusImplemented: string;
-        readonly statusPlaceholder: string;
-        readonly noAliases: string;
     };
     /**
      * Labels used by end-to-end example sections.

package/esm/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.d.ts

@@ -16,7 +16,7 @@ export type BookLanguageManualCommitmentGroups = {
      */
     readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
     /**
-     * Low-level and unfinished commitments documented in their own closing chapter.
+     * Low-level commitments documented in their own closing chapter.
      */
     readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 };

package/esm/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.d.ts

@@ -10,10 +10,6 @@ export type RenderCommitmentCatalogSectionOptions = {
      * Grouped commitment definition with aliases.
      */
     readonly groupedCommitment: BookLanguageManualCommitmentGroup;
-    /**
-     * Number of uses across the selected server agents.
-     */
-    readonly usageCount: number;
     /**
      * Translated labels of the manual.
      */

package/esm/src/book-components/Chat/utils/$provideServerDomWindow.d.ts

@@ -0,0 +1,11 @@
+import type { WindowLike as DomWindowLike } from 'dompurify';
+/**
+ * Provides a DOM `window` for runtimes which do not have one, for example Node.js during server-side rendering
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it creates and caches one shared DOM window
+ *
+ * @returns DOM window which can back a DOM-dependent library like `DOMPurify`
+ * @throws {EnvironmentMismatchError} When the current runtime can not create a DOM window
+ * @private utility of `renderMarkdown`
+ */
+export declare function $provideServerDomWindow(): DomWindowLike;

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

@@ -25,6 +25,13 @@ export type MarkdownInlineReference = {
      * Link target for the rendered reference.
      */
     readonly href: string;
+    /**
+     * Markdown link destination prefixes that should render as this reference as well.
+     *
+     * This supports legacy links such as an Agents Server project file URL while keeping
+     * `reference` as the canonical `[[project]]` token.
+     */
+    readonly sourceHrefPrefixes?: ReadonlyArray<string>;
     /**
      * Optional hover title for the rendered reference.
      */

package/esm/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.d.ts

@@ -18,6 +18,12 @@ export declare const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = "PTBK_AGENTS_SE
  * @private internal constant of `buildAgentsServer`
  */
 export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION";
+/**
+ * Environment variable that disables throwaway webpack filesystem caches for CLI-owned production builds.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV = "PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE";
 /**
  * Adds dependency-resolution environment required by the materialized Agents Server runtime.
  *
@@ -25,4 +31,5 @@ export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENT
  */
 export declare function createAgentsServerRuntimeEnvironment(environment: NodeJS.ProcessEnv, nodeModulesPath: string, options?: {
     readonly isNextValidationIgnored?: boolean;
+    readonly isWebpackFilesystemCacheDisabled?: boolean;
 }): NodeJS.ProcessEnv;

package/esm/src/cli/cli-commands/coder/agentCodingFile.d.ts

@@ -1,3 +1,4 @@
+import { string_markdown } from '../../../types/typeAliases';
 /**
  * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
  *
@@ -9,6 +10,4 @@ export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
  *
  * @private internal utility of `ptbk coder`
  */
-export declare function getDefaultCoderAgentCodingFileContent({ packageJsonScripts, }: {
-    readonly packageJsonScripts: Readonly<Record<string, string>>;
-}): string;
+export declare function getDefaultCoderAgentCodingFileContent(): string_markdown;

package/esm/src/cli/cli-commands/coder/ping.d.ts

@@ -0,0 +1,10 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `coder ping` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeCoderPingCommand(program: Program): $side_effect;

package/esm/src/cli/cli-commands/coder/ping.test.d.ts

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

package/esm/src/cli/cli-commands/coder.d.ts

@@ -9,6 +9,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents
+ * - ping: Test one harness and model with a tiny dummy prompt
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags
  *

package/esm/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts

@@ -0,0 +1,34 @@
+import type { Command as Program } from 'commander';
+import type { CoderGitSyncOptions } from '../../../../scripts/run-codex-prompts/git/coderGitSync';
+export type { CoderGitSyncOptions };
+/**
+ * Commander option bag for the shared `ptbk coder` git synchronization flags.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type CoderGitSyncCliOptions = {
+    readonly commit: boolean;
+    readonly autoPush: boolean;
+    readonly autoPull: boolean;
+};
+/**
+ * Description block shared by the `ptbk coder` commands which can synchronize their changes with git.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const CODER_GIT_SYNC_DESCRIPTION: string;
+/**
+ * Registers the shared `--commit`, `--auto-push` and `--auto-pull` flags on a `ptbk coder` command.
+ *
+ * Note: Unlike `ptbk coder run`, which commits by default and opts out through `--no-commit`,
+ *       these commands never touch git unless the flags are used explicitly.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function addCoderGitSyncOptions(command: Program): void;
+/**
+ * Converts the Commander git synchronization flags into normalized git synchronization options.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function normalizeCoderGitSyncCliOptions(cliOptions: CoderGitSyncCliOptions): CoderGitSyncOptions;

package/esm/src/cli/cli-commands/common/coderGitSyncCliOptions.test.d.ts

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

package/esm/src/cli/common/loadPromptsModule.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="prompts" />
+/**
+ * Loads the interactive terminal prompt library (`prompts`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast - most commands never ask the user
+ *       anything interactively
+ *
+ * @private internal utility of Promptbook CLI
+ */
+export declare const loadPromptsModule: () => Promise<{
+    default: typeof import("prompts");
+    inject: typeof import("prompts").inject;
+    override: typeof import("prompts").override;
+    prompt: any;
+    prompts: typeof import("prompts").prompts;
+}>;

package/esm/src/llm-providers/anthropic-claude/AnthropicClaudeExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import Anthropic from '@anthropic-ai/sdk';
+import type Anthropic from '@anthropic-ai/sdk';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';

package/esm/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import { OpenAIClient } from '@azure/openai';
+import type { OpenAIClient } from '@azure/openai';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';

package/esm/src/llm-providers/openai/OpenAiAgentKitExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import { Agent as AgentFromKit } from '@openai/agents';
+import type { Agent as AgentFromKit } from '@openai/agents';
 import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ModelRequirements } from '../../types/ModelRequirements';

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

@@ -38,7 +38,7 @@ export declare class OpenAiAgentKitExecutionToolsToolBuilder {
     buildAgentKitTools(options: {
         readonly tools?: ModelRequirements['tools'];
         readonly vectorStoreId?: string;
-    }): Array<AgentKitTool>;
+    }): Promise<Array<AgentKitTool>>;
     /**
      * Resolves the stored Promptbook tool result for one AgentKit tool call.
      */

package/esm/src/llm-providers/openai/OpenAiAssistantExecutionToolsStreamRunner.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_date_iso8601, string_token } from '../../types/string_token';

package/esm/src/llm-providers/openai/OpenAiAssistantExecutionToolsToolRunner.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ScriptExecutionTools } from '../../execution/ScriptExecutionTools';
 import type { Prompt } from '../../types/Prompt';

package/esm/src/llm-providers/openai/OpenAiCompatibleNonChatPromptCaller.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { CompletionPromptResult, EmbeddingPromptResult, ImagePromptResult } from '../../execution/PromptResult';
 import type { Usage } from '../../execution/Usage';

package/esm/src/llm-providers/openai/OpenAiCompatibleRequestManager.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 /**
  * Manages OpenAI-compatible client creation plus shared retry and rate-limit behavior.

package/esm/src/llm-providers/openai/utils/callOpenAiCompatibleChatModel.d.ts

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { AvailableModel } from '../../../execution/AvailableModel';
 import type { ChatPromptResult } from '../../../execution/PromptResult';
 import type { Usage } from '../../../execution/Usage';

package/esm/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/esm/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/esm/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/esm/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-2`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/utils",
-    "version": "0.114.0-1",
+    "version": "0.114.0-3",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/umd/index.umd.js

@@ -23,7 +23,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-1';
+    const PROMPTBOOK_ENGINE_VERSION = '0.114.0-3';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name

package/umd/src/book-2.0/book-language-documentation/BookLanguageManualDictionary.d.ts

@@ -86,9 +86,7 @@ export type BookLanguageManualDictionary = {
     readonly metadataLabels: {
         readonly bookLanguageVersion: string;
         readonly generatedAt: string;
-        readonly commitmentGroups: string;
-        readonly implementedCommitments: string;
-        readonly placeholderCommitments: string;
+        readonly commitmentCount: string;
     };
     /**
      * Heading of the table of contents.
@@ -128,7 +126,6 @@ export type BookLanguageManualDictionary = {
     readonly primitivesSections: {
         readonly coreSyntax: BookLanguageManualChapter;
         readonly references: BookLanguageManualChapter;
-        readonly keywordsTitle: string;
     };
     /**
      * Suffixes distinguishing a server-specific catalog from the portable one.
@@ -141,18 +138,7 @@ export type BookLanguageManualDictionary = {
      * Labels used in every commitment catalog entry.
      */
     readonly commitmentLabels: {
-        readonly status: string;
         readonly aliases: string;
-        readonly semantics: string;
-        readonly typeSchema: string;
-        readonly blockSchema: string;
-        readonly lowLevelNotice: string;
-        readonly usage: string;
-        readonly usageOccurrence: string;
-        readonly usageOccurrences: string;
-        readonly statusImplemented: string;
-        readonly statusPlaceholder: string;
-        readonly noAliases: string;
     };
     /**
      * Labels used by end-to-end example sections.

package/umd/src/book-2.0/book-language-documentation/getBookLanguageManualCommitmentGroups.d.ts

@@ -16,7 +16,7 @@ export type BookLanguageManualCommitmentGroups = {
      */
     readonly documented: ReadonlyArray<BookLanguageManualCommitmentGroup>;
     /**
-     * Low-level and unfinished commitments documented in their own closing chapter.
+     * Low-level commitments documented in their own closing chapter.
      */
     readonly lowLevel: ReadonlyArray<BookLanguageManualCommitmentGroup>;
 };

package/umd/src/book-2.0/book-language-documentation/renderCommitmentCatalogSection.d.ts

@@ -10,10 +10,6 @@ export type RenderCommitmentCatalogSectionOptions = {
      * Grouped commitment definition with aliases.
      */
     readonly groupedCommitment: BookLanguageManualCommitmentGroup;
-    /**
-     * Number of uses across the selected server agents.
-     */
-    readonly usageCount: number;
     /**
      * Translated labels of the manual.
      */

package/umd/src/book-components/Chat/utils/$provideServerDomWindow.d.ts

@@ -0,0 +1,11 @@
+import type { WindowLike as DomWindowLike } from 'dompurify';
+/**
+ * Provides a DOM `window` for runtimes which do not have one, for example Node.js during server-side rendering
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it creates and caches one shared DOM window
+ *
+ * @returns DOM window which can back a DOM-dependent library like `DOMPurify`
+ * @throws {EnvironmentMismatchError} When the current runtime can not create a DOM window
+ * @private utility of `renderMarkdown`
+ */
+export declare function $provideServerDomWindow(): DomWindowLike;

package/umd/src/book-components/Chat/utils/renderMarkdown.d.ts

@@ -25,6 +25,13 @@ export type MarkdownInlineReference = {
      * Link target for the rendered reference.
      */
     readonly href: string;
+    /**
+     * Markdown link destination prefixes that should render as this reference as well.
+     *
+     * This supports legacy links such as an Agents Server project file URL while keeping
+     * `reference` as the canonical `[[project]]` token.
+     */
+    readonly sourceHrefPrefixes?: ReadonlyArray<string>;
     /**
      * Optional hover title for the rendered reference.
      */

package/umd/src/cli/cli-commands/agents-server/buildAgentsServer/createAgentsServerRuntimeEnvironment.d.ts

@@ -18,6 +18,12 @@ export declare const PTBK_AGENTS_SERVER_BUILD_WORKER_COUNT_ENV = "PTBK_AGENTS_SE
  * @private internal constant of `buildAgentsServer`
  */
 export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION";
+/**
+ * Environment variable that disables throwaway webpack filesystem caches for CLI-owned production builds.
+ *
+ * @private internal constant of `buildAgentsServer`
+ */
+export declare const PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE_ENV = "PTBK_AGENTS_SERVER_DISABLE_WEBPACK_FILESYSTEM_CACHE";
 /**
  * Adds dependency-resolution environment required by the materialized Agents Server runtime.
  *
@@ -25,4 +31,5 @@ export declare const PTBK_AGENTS_SERVER_IGNORE_NEXT_VALIDATION_ENV = "PTBK_AGENT
  */
 export declare function createAgentsServerRuntimeEnvironment(environment: NodeJS.ProcessEnv, nodeModulesPath: string, options?: {
     readonly isNextValidationIgnored?: boolean;
+    readonly isWebpackFilesystemCacheDisabled?: boolean;
 }): NodeJS.ProcessEnv;

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

@@ -1,3 +1,4 @@
+import { string_markdown } from '../../../types/typeAliases';
 /**
  * Relative path to the Promptbook Coder quick-reference file initialized in project roots.
  *
@@ -9,6 +10,4 @@ export declare const AGENT_CODING_FILE_PATH = "AGENT_CODING.md";
  *
  * @private internal utility of `ptbk coder`
  */
-export declare function getDefaultCoderAgentCodingFileContent({ packageJsonScripts, }: {
-    readonly packageJsonScripts: Readonly<Record<string, string>>;
-}): string;
+export declare function getDefaultCoderAgentCodingFileContent(): string_markdown;

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

@@ -0,0 +1,10 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `coder ping` command for Promptbook CLI utilities
+ *
+ * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeCoderPingCommand(program: Program): $side_effect;

package/umd/src/cli/cli-commands/coder/ping.test.d.ts

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

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

@@ -9,6 +9,7 @@ import type { $side_effect } from '../../utils/organization/$side_effect';
  * - generate-boilerplates: Generate prompt boilerplate files
  * - find-refactor-candidates: Find files that need refactoring
  * - run: Run coding prompts with AI agents
+ * - ping: Test one harness and model with a tiny dummy prompt
  * - verify: Verify completed prompts
  * - find-fresh-emoji-tags: Find unused emoji tags
  *

package/umd/src/cli/cli-commands/common/coderGitSyncCliOptions.d.ts

@@ -0,0 +1,34 @@
+import type { Command as Program } from 'commander';
+import type { CoderGitSyncOptions } from '../../../../scripts/run-codex-prompts/git/coderGitSync';
+export type { CoderGitSyncOptions };
+/**
+ * Commander option bag for the shared `ptbk coder` git synchronization flags.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type CoderGitSyncCliOptions = {
+    readonly commit: boolean;
+    readonly autoPush: boolean;
+    readonly autoPull: boolean;
+};
+/**
+ * Description block shared by the `ptbk coder` commands which can synchronize their changes with git.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const CODER_GIT_SYNC_DESCRIPTION: string;
+/**
+ * Registers the shared `--commit`, `--auto-push` and `--auto-pull` flags on a `ptbk coder` command.
+ *
+ * Note: Unlike `ptbk coder run`, which commits by default and opts out through `--no-commit`,
+ *       these commands never touch git unless the flags are used explicitly.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function addCoderGitSyncOptions(command: Program): void;
+/**
+ * Converts the Commander git synchronization flags into normalized git synchronization options.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function normalizeCoderGitSyncCliOptions(cliOptions: CoderGitSyncCliOptions): CoderGitSyncOptions;

package/umd/src/cli/cli-commands/common/coderGitSyncCliOptions.test.d.ts

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

package/umd/src/cli/common/loadPromptsModule.d.ts

@@ -0,0 +1,16 @@
+/// <reference types="prompts" />
+/**
+ * Loads the interactive terminal prompt library (`prompts`) on demand
+ *
+ * Note: [🐌] Loaded lazily to keep the startup of the `ptbk` CLI utility fast - most commands never ask the user
+ *       anything interactively
+ *
+ * @private internal utility of Promptbook CLI
+ */
+export declare const loadPromptsModule: () => Promise<{
+    default: typeof import("prompts");
+    inject: typeof import("prompts").inject;
+    override: typeof import("prompts").override;
+    prompt: any;
+    prompts: typeof import("prompts").prompts;
+}>;

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

@@ -1,4 +1,4 @@
-import Anthropic from '@anthropic-ai/sdk';
+import type Anthropic from '@anthropic-ai/sdk';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';

package/umd/src/llm-providers/azure-openai/AzureOpenAiExecutionTools.d.ts

@@ -1,4 +1,4 @@
-import { OpenAIClient } from '@azure/openai';
+import type { OpenAIClient } from '@azure/openai';
 import type { ChatParticipant } from '../../book-components/Chat/types/ChatParticipant';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { LlmExecutionTools } from '../../execution/LlmExecutionTools';

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

@@ -1,4 +1,4 @@
-import { Agent as AgentFromKit } from '@openai/agents';
+import type { Agent as AgentFromKit } from '@openai/agents';
 import type { CallChatModelStreamOptions, LlmExecutionTools } from '../../execution/LlmExecutionTools';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ModelRequirements } from '../../types/ModelRequirements';

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

@@ -38,7 +38,7 @@ export declare class OpenAiAgentKitExecutionToolsToolBuilder {
     buildAgentKitTools(options: {
         readonly tools?: ModelRequirements['tools'];
         readonly vectorStoreId?: string;
-    }): Array<AgentKitTool>;
+    }): Promise<Array<AgentKitTool>>;
     /**
      * Resolves the stored Promptbook tool result for one AgentKit tool call.
      */

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

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { Prompt } from '../../types/Prompt';
 import type { string_date_iso8601, string_token } from '../../types/string_token';

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

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { ChatPromptResult } from '../../execution/PromptResult';
 import type { ScriptExecutionTools } from '../../execution/ScriptExecutionTools';
 import type { Prompt } from '../../types/Prompt';

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

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { AvailableModel } from '../../execution/AvailableModel';
 import type { CompletionPromptResult, EmbeddingPromptResult, ImagePromptResult } from '../../execution/PromptResult';
 import type { Usage } from '../../execution/Usage';

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

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { OpenAiCompatibleExecutionToolsNonProxiedOptions } from './OpenAiCompatibleExecutionToolsOptions';
 /**
  * Manages OpenAI-compatible client creation plus shared retry and rate-limit behavior.

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

@@ -1,4 +1,4 @@
-import OpenAI from 'openai';
+import type OpenAI from 'openai';
 import type { AvailableModel } from '../../../execution/AvailableModel';
 import type { ChatPromptResult } from '../../../execution/PromptResult';
 import type { Usage } from '../../../execution/Usage';

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