@promptbook/cli 0.114.0-1 → 0.114.0-3

package/esm/scripts/run-codex-prompts/common/runGoScript/scriptExecutionLog.d.ts

@@ -2,6 +2,13 @@
  * Environment variable read by the shell wrapper to tee live output into the temporary runtime log file.
  */
 export declare const PTBK_CODER_LOG_FILE_ENV_NAME = "PTBK_CODER_LOG_FILE";
+/**
+ * Log line which separates the raw script input from the raw script output of one execution section.
+ *
+ * Readers of a runtime log split on this marker to look only at what the harness really produced,
+ * without the generated script and the prompt it embeds.
+ */
+export declare const SCRIPT_EXECUTION_LOG_RAW_OUTPUT_MARKER = "--- raw output ---";
 /**
  * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
  */

package/esm/scripts/run-codex-prompts/git/coderGitSync.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Automatic git synchronization of the project changes made by one `ptbk coder` command.
+ *
+ * Note: This is the single place where pulling, committing and pushing of `ptbk coder` project changes is
+ *       implemented, every command which offers `--commit`, `--auto-push` and `--auto-pull` reuses it.
+ */
+export type CoderGitSyncOptions = {
+    /**
+     * Commit the changes made by the command.
+     */
+    readonly isCommitEnabled: boolean;
+    /**
+     * Push the created commit to the remote repository.
+     */
+    readonly isAutoPushEnabled: boolean;
+    /**
+     * Pull the latest changes from the remote repository before the command changes anything.
+     */
+    readonly isAutoPullEnabled: boolean;
+};
+/**
+ * Git synchronization which leaves the repository completely untouched.
+ *
+ * Note: This is the default for every command and helper which supports the git synchronization.
+ */
+export declare const DISABLED_CODER_GIT_SYNC_OPTIONS: CoderGitSyncOptions;
+/**
+ * Pulls the latest repository changes before a `ptbk coder` command changes the project.
+ */
+export declare function $pullCoderChanges(options: {
+    readonly gitSync: CoderGitSyncOptions;
+    readonly projectPath?: string;
+}): Promise<void>;
+/**
+ * Commits - and when requested also pushes - the changes one `ptbk coder` command has just made.
+ *
+ * Note: A repository without any change is left alone instead of creating an empty commit.
+ */
+export declare function $commitCoderChanges(options: {
+    readonly gitSync: CoderGitSyncOptions;
+    readonly commitMessage: string;
+    readonly projectPath?: string;
+}): Promise<void>;

package/esm/scripts/run-codex-prompts/git/commitChanges.d.ts

@@ -4,6 +4,9 @@
  * `options.includePaths` can restrict staging, `options.onlyPaths` can restrict the commit pathspec,
  * `options.excludePaths` can keep temporary artifacts out of the created commit and
  * `options.isEmptyCommitAllowed` keeps a round without any file change from failing.
+ *
+ * Note: The temporary commit message file is written inside the project, so it is always excluded from the commit
+ *       itself for projects which do not keep the Promptbook temporary directory out of version control.
  */
 export declare function commitChanges(message: string, options?: {
     autoPush?: boolean;

package/esm/scripts/run-codex-prompts/main/resolvePromptRunner.d.ts

@@ -7,6 +7,13 @@ type RunnerMetadata = {
     runnerName: string;
     modelName?: string;
 };
+/**
+ * Subset of `RunOptions` which decides which prompt runner is created and how it is labeled.
+ *
+ * Commands that only need one configured harness — such as `ptbk coder ping` — pass just these
+ * fields instead of assembling a complete `RunOptions` for a run they never start.
+ */
+export type PromptRunnerSelectionOptions = Pick<RunOptions, 'agentName' | 'model' | 'thinkingLevel' | 'allowCredits' | 'isVerbose' | 'isMachineReadableProgressEnabled'>;
 /**
  * Resolved runner setup used by `runCodexPrompts`.
  */
@@ -20,5 +27,5 @@ type PromptRunnerResolution = {
  *
  * @private function of runCodexPrompts
  */
-export declare function resolvePromptRunner(options: RunOptions): PromptRunnerResolution;
+export declare function resolvePromptRunner(options: PromptRunnerSelectionOptions): PromptRunnerResolution;
 export {};

package/esm/scripts/run-codex-prompts/ping/buildCoderPingPrompt.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Marker the pinged harness is asked to prefix its answer with, so the reply can be recognized
+ * in the raw runner output of every supported harness.
+ *
+ * Note: The marker must stay free of regular-expression metacharacters, because
+ *       `extractCoderPingAnswer` builds its pattern from it.
+ */
+export declare const CODER_PING_ANSWER_MARKER = "PTBK-CODER-PING-ANSWER";
+/**
+ * Answer a working harness and model returns for the dummy work of `ptbk coder ping`.
+ */
+export declare const CODER_PING_EXPECTED_ANSWER: string;
+/**
+ * Builds the dummy prompt sent by `ptbk coder ping`.
+ *
+ * The work is intentionally the smallest possible one that still reaches the model: it spends a
+ * negligible amount of the harness quota, it needs no tool and it explicitly forbids touching the
+ * project, so a ping leaves the project exactly as it was.
+ */
+export declare function buildCoderPingPrompt(): string;

package/esm/scripts/run-codex-prompts/ping/extractCoderPingAnswer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Extracts the answer of a pinged harness from the runtime log of its runner shell.
+ *
+ * Only the raw output of the last execution is searched, so the answer marker contained in the
+ * prompt of the raw input is never mistaken for the answer of the harness.
+ *
+ * @returns The answer of the harness, or `null` when the harness produced no recognizable answer
+ */
+export declare function extractCoderPingAnswer(runtimeLog: string): string | null;

package/esm/scripts/run-codex-prompts/ping/pingCoderHarness.d.ts

@@ -0,0 +1,23 @@
+import type { PromptRunnerSelectionOptions } from '../main/resolvePromptRunner';
+import type { CoderPingResult } from './CoderPingResult';
+/**
+ * Options for one `ptbk coder ping` round trip.
+ */
+export type PingCoderHarnessOptions = PromptRunnerSelectionOptions & {
+    /**
+     * Project the harness is started in. Defaults to the current working directory.
+     */
+    readonly projectPath?: string;
+    /**
+     * Mirrors the live harness output to the terminal instead of only reporting the compact result.
+     */
+    readonly shouldPrintLiveOutput?: boolean;
+};
+/**
+ * Sends one tiny dummy prompt through the selected harness and model and measures the round trip.
+ *
+ * The ping reuses the very same runner the coding queue uses, so it really exercises the configured
+ * harness, model, thinking level and authentication — including the retry behavior on rate limits.
+ * Both temporary artifacts it creates are removed again, so the project is left as it was.
+ */
+export declare function pingCoderHarness(options: PingCoderHarnessOptions): Promise<CoderPingResult>;

package/esm/scripts/run-codex-prompts/ping/printCoderPingResult.d.ts

@@ -0,0 +1,5 @@
+import type { CoderPingResult } from './CoderPingResult';
+/**
+ * Prints the compact summary of one finished `ptbk coder ping`.
+ */
+export declare function printCoderPingResult(result: CoderPingResult): void;

package/esm/scripts/run-codex-prompts/prompts/findNextTodoPrompt.d.ts

@@ -1,7 +1,8 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSelection } from './types/PromptSelection';
+import type { PromptRunnerIdentity } from './isPromptCompatibleWithRunner';
 import type { PriorityFilter } from './priorityFilter';
 /**
  * Selects the next runnable prompt based on priority.
  */
-export declare function findNextTodoPrompt(files: PromptFile[], priorityFilter?: PriorityFilter): PromptSelection | undefined;
+export declare function findNextTodoPrompt(files: PromptFile[], priorityFilter?: PriorityFilter, promptRunnerIdentity?: PromptRunnerIdentity): PromptSelection | undefined;

package/esm/scripts/run-codex-prompts/prompts/isPromptCompatibleWithRunner.d.ts

@@ -0,0 +1,27 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Names of the harness and model currently selected for a coder run.
+ */
+export type PromptRunnerIdentity = {
+    /**
+     * Stable harness identifier, for example `github-copilot`.
+     */
+    readonly harnessName?: string;
+    /**
+     * Effective model identifier, for example `gpt-5.5`.
+     */
+    readonly modelName?: string;
+};
+/**
+ * Checks whether a prompt is unrestricted or matches the selected harness/model.
+ *
+ * A prompt status line can contain one or more backtick-delimited model or harness
+ * names. Matching is intentionally based on normalized substrings so a token such as
+ * `gpt` selects any `gpt-*` model and `opus` selects a `claude-opus-*` model.
+ */
+export declare function isPromptCompatibleWithRunner(file: PromptFile, section: PromptSection, promptRunnerIdentity?: PromptRunnerIdentity): boolean;
+/**
+ * Extracts model and harness tokens from a prompt status line.
+ */
+export declare function extractPromptRunnerTokens(statusLine: string): string[];

package/esm/scripts/run-codex-prompts/prompts/listRunnablePrompts.d.ts

@@ -1,7 +1,8 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSelection } from './types/PromptSelection';
+import { type PromptRunnerIdentity } from './isPromptCompatibleWithRunner';
 import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists todo prompts that are ready to run (no authoring placeholders).
  */
-export declare function listRunnablePrompts(files: PromptFile[], priorityFilter?: PriorityFilter): PromptSelection[];
+export declare function listRunnablePrompts(files: PromptFile[], priorityFilter?: PriorityFilter, promptRunnerIdentity?: PromptRunnerIdentity): PromptSelection[];

package/esm/scripts/run-codex-prompts/prompts/listUpcomingTasks.d.ts

@@ -1,7 +1,8 @@
 import type { PromptFile } from './types/PromptFile';
 import type { UpcomingTask } from './types/UpcomingTask';
+import type { PromptRunnerIdentity } from './isPromptCompatibleWithRunner';
 import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists upcoming tasks that are ready to run (no authoring placeholders).
  */
-export declare function listUpcomingTasks(files: PromptFile[], priorityFilter?: PriorityFilter): UpcomingTask[];
+export declare function listUpcomingTasks(files: PromptFile[], priorityFilter?: PriorityFilter, promptRunnerIdentity?: PromptRunnerIdentity): UpcomingTask[];

package/esm/scripts/run-codex-prompts/prompts/replacePromptTodoStatusLine.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Replaces the complete todo status line while preserving its indentation.
+ *
+ * The complete line is replaced because a todo status can contain a required
+ * model/harness token in addition to priority markers.
+ */
+export declare function replacePromptTodoStatusLine(line: string, replacementStatusLine: string): string;

package/esm/scripts/run-codex-prompts/testing/TestBeforeMode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Modes supported by `ptbk coder run --test-before`.
+ */
+export declare const TEST_BEFORE_MODE_VALUES: readonly ["no", "yes-and-fail", "yes-and-fix"];
+/**
+ * Behavior requested for the pre-coding verification run.
+ */
+export type TestBeforeMode = (typeof TEST_BEFORE_MODE_VALUES)[number];
+/**
+ * Default verification command used when a pre-coding mode is enabled without an explicit `--test` command.
+ */
+export declare const DEFAULT_CODER_TEST_COMMAND = "npm test";
+/**
+ * Checks whether a value is a supported `--test-before` mode.
+ */
+export declare function isTestBeforeMode(value: string): value is TestBeforeMode;

package/esm/scripts/run-codex-prompts/testing/createTestBeforeRepairPrompt.d.ts

@@ -0,0 +1,9 @@
+import type { PromptSelection } from '../prompts/types/PromptSelection';
+/**
+ * Creates the one queue prompt used to repair a pre-existing test failure.
+ */
+export declare function createTestBeforeRepairPrompt(options: {
+    readonly projectPath: string;
+    readonly testCommand: string;
+    readonly testOutput: string;
+}): Promise<PromptSelection>;

package/esm/scripts/run-codex-prompts/testing/limitTestOutput.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Limits test output while keeping the end of the output, where test runners usually print the failure summary.
+ */
+export declare function limitTestOutput(testOutput: string): string;

package/esm/scripts/run-codex-prompts/testing/runPromptTestCommand.d.ts

@@ -1,7 +1,7 @@
 /**
  * Options for running one verification command after a coding attempt.
  */
-type RunPromptTestCommandOptions = {
+export type RunPromptTestCommandOptions = {
     command: string;
     projectPath: string;
     scriptPath: string;
@@ -12,4 +12,3 @@ type RunPromptTestCommandOptions = {
  * Runs the configured verification command inside the project root and returns its output.
  */
 export declare function runPromptTestCommand(options: RunPromptTestCommandOptions): Promise<string>;
-export {};

package/esm/scripts/run-codex-prompts/testing/runTestBefore.d.ts

@@ -0,0 +1,24 @@
+import type { WaitForCoderRunPauseCheckpoint } from '../common/CoderRunPauseCheckpoint';
+import { runPromptTestCommand } from './runPromptTestCommand';
+/**
+ * Result of the verification command executed before coding starts.
+ */
+export type TestBeforeResult = {
+    /**
+     * Whether the verification command completed successfully.
+     */
+    readonly isPassed: boolean;
+    /**
+     * Combined output produced by the verification command.
+     */
+    readonly testOutput: string;
+};
+/**
+ * Runs the configured verification command before the first coding prompt.
+ */
+export declare function runTestBefore(options: {
+    readonly testCommand: string;
+    readonly projectPath: string;
+    readonly waitForPauseCheckpoint?: WaitForCoderRunPauseCheckpoint;
+    readonly runPromptTestCommandExecutor?: typeof runPromptTestCommand;
+}): Promise<TestBeforeResult>;

package/esm/scripts/run-codex-prompts/ui/buildRunUiFrameShared.d.ts

@@ -67,6 +67,7 @@ export declare function buildControlPills(options: {
  * Builds the coder-run control pills shown in the footer box.
  */
 export declare function buildCoderRunControlPills(options: {
+    readonly phase: CoderRunPhase;
     readonly pauseControl: string;
     readonly pendingEnterLabel: string | undefined;
     readonly isEndAfterCurrentPromptRequested: boolean;

package/esm/scripts/verify-prompts/verify-prompts.d.ts

@@ -1,3 +1,4 @@
+import type { CoderGitSyncOptions } from '../run-codex-prompts/git/coderGitSync';
 import type { PromptFile } from '../run-codex-prompts/prompts/types/PromptFile';
 /**
  * Options supported by the prompt verification helper.
@@ -11,6 +12,10 @@ export type VerifyPromptsOptions = {
      * Ignore prompt files whose filename or first prompt line contains one of the provided values.
      */
     readonly ignore?: ReadonlyArray<string>;
+    /**
+     * Automatic git synchronization applied around each single verification.
+     */
+    readonly gitSync?: CoderGitSyncOptions;
 };
 /**
  * Starts the verification loop and exits when no `[ ]` prompts remain.

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';