@promptbook/cli 0.112.0-71 → 0.112.0-73

package/umd/scripts/run-agent-messages/main/agentIgnorePatterns.d.ts

@@ -0,0 +1,33 @@
+import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
+/**
+ * Prefix used by external runner repositories whose names carry the stable agent id.
+ */
+export declare const AGENT_RUNNER_REPOSITORY_PREFIX = "agent-";
+/**
+ * Agent identity fields tested by `ptbk agent run-multiple --ignore`.
+ */
+export type AgentIgnoreIdentity = {
+    readonly agentName?: string;
+    readonly normalizedAgentName?: string;
+    readonly agentId?: string;
+    readonly repositoryName?: string;
+};
+/**
+ * Case-insensitive wildcard matcher for `ptbk agent run-multiple --ignore`.
+ */
+export type AgentIgnoreMatcher = {
+    readonly isEnabled: boolean;
+    readonly isIgnored: (identity: AgentIgnoreIdentity) => boolean;
+};
+/**
+ * Creates a case-insensitive matcher for agent ignore patterns.
+ */
+export declare function createAgentIgnoreMatcher(ignorePatterns: readonly string[] | undefined): AgentIgnoreMatcher;
+/**
+ * Builds ignore identity fields from an agent source book.
+ */
+export declare function createAgentIgnoreIdentityFromAgentSource(agentSource: string_book): AgentIgnoreIdentity;
+/**
+ * Extracts the stable id part from canonical `agent-<id>` runner repository names.
+ */
+export declare function resolveAgentIdFromRepositoryName(repositoryName: string): string | undefined;

package/umd/scripts/run-agent-messages/main/synchronizeGithubAgentRunnerRepositories.d.ts

@@ -1,3 +1,4 @@
+import { type AgentIgnoreMatcher } from './agentIgnorePatterns';
 /**
  * Environment variable carrying the GitHub token used to discover and clone agent repositories.
  */
@@ -11,6 +12,7 @@ export declare const PROMPTBOOK_AGENT_RUNNER_GITHUB_OWNER_ENV = "PROMPTBOOK_AGEN
  */
 export type GithubAgentRunnerRepositoriesSynchronizationResult = {
     readonly clonedRepositoryNames: ReadonlyArray<string>;
+    readonly ignoredRepositoryNames?: ReadonlyArray<string>;
     readonly owner?: string;
     readonly synchronizedAt?: number;
 };
@@ -24,4 +26,6 @@ export declare function loadAgentRunnerGithubConfiguration(): {
 /**
  * Clones missing `agent-*` repositories from the configured GitHub owner into the direct child directories of `rootPath`.
  */
-export declare function synchronizeGithubAgentRunnerRepositories(rootPath: string): Promise<GithubAgentRunnerRepositoriesSynchronizationResult>;
+export declare function synchronizeGithubAgentRunnerRepositories(rootPath: string, options?: {
+    readonly ignoreMatcher?: AgentIgnoreMatcher;
+}): Promise<GithubAgentRunnerRepositoriesSynchronizationResult>;

package/umd/scripts/run-agent-messages/main/tickAgentMessages.d.ts

@@ -1,4 +1,6 @@
+import type { PromptStats } from '../../run-codex-prompts/prompts/types/PromptStats';
 import { type CoderRunUiHandle } from '../../run-codex-prompts/ui/renderCoderRunUi';
+import type { AgentRunMessagePreviewSection, AgentRunStatusTableRow } from '../../run-codex-prompts/ui/buildCoderRunUiFrame';
 import type { AgentRunOptions } from '../AgentRunOptions';
 import type { AgentMessageFile } from '../messages/AgentMessageFile';
 import { type FinishedAgentMessageFile } from '../messages/moveAgentMessageToFinished';
@@ -16,7 +18,26 @@ export type AgentTickResult = {
  */
 export type TickAgentMessagesOptions = {
     readonly isQuietWhenIdle?: boolean;
+    readonly projectPath?: string;
     readonly uiHandle?: CoderRunUiHandle;
+    readonly uiPresentation?: AgentTickUiPresentation;
+};
+/**
+ * Optional rich UI presentation overrides used by shared multi-agent sessions.
+ */
+export type AgentTickUiPresentation = {
+    readonly isSharedDashboard?: boolean;
+    readonly sessionAgentName?: string;
+    readonly agentStatusLines?: readonly string[];
+    readonly agentStatusTableRows?: readonly AgentRunStatusTableRow[];
+    readonly messagePreviewLines?: readonly string[];
+    readonly messagePreviewSections?: readonly AgentRunMessagePreviewSection[];
+    readonly progressStats?: PromptStats;
+    readonly completedAgentStatusLines?: readonly string[];
+    readonly completedAgentStatusTableRows?: readonly AgentRunStatusTableRow[];
+    readonly completedMessagePreviewLines?: readonly string[];
+    readonly completedMessagePreviewSections?: readonly AgentRunMessagePreviewSection[];
+    readonly completedProgressStats?: PromptStats;
 };
 /**
  * Answers one queued `.book` message thread and moves it to `messages/finished`.

package/umd/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts

@@ -1,4 +1,4 @@
 /**
  * Builds the prompt sent to the selected coding runner for one queued user-thread book.
  */
-export declare function buildAgentMessagePrompt(messageRelativePath: string): string;
+export declare function buildAgentMessagePrompt(messageRelativePath: string, agentSystemMessage: string): string;

package/umd/scripts/run-agent-messages/ui/agentRunUiConstants.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Shared idle placeholder rendered in the rich `ptbk agent` terminal UI.
+ */
+export declare const WAITING_FOR_MESSAGE_LABEL = "Waiting for the message";

package/umd/scripts/run-agent-messages/ui/loadAgentRunUiMetadata.d.ts

@@ -6,14 +6,39 @@ export type AgentRunUiMetadata = {
     readonly localAgentName: string;
     readonly latestUserMessageLines: readonly string[];
 };
+/**
+ * Local agent identity rendered in the rich `ptbk agent run` dashboard.
+ */
+export type AgentRunUiIdentity = {
+    readonly localAgentName: string;
+    readonly normalizedAgentName?: string;
+    readonly agentId?: string;
+    readonly localAgentUrl?: string;
+};
+/**
+ * Preview of one queued `.book` thread used by the rich terminal UI.
+ */
+export type AgentRunQueuedMessagePreview = {
+    readonly queuedMessage: AgentMessageFile;
+    readonly latestUserMessageLines: readonly string[];
+    readonly latestUserMessageSummary: string;
+};
 /**
  * Reads the local agent title and latest queued user message for the rich agent dashboard.
  */
 export declare function loadAgentRunUiMetadata(projectPath: string, queuedMessage: AgentMessageFile): Promise<AgentRunUiMetadata>;
+/**
+ * Reads and summarizes the latest queued user message from one thread book.
+ */
+export declare function loadAgentRunQueuedMessagePreview(queuedMessage: AgentMessageFile): Promise<AgentRunQueuedMessagePreview>;
 /**
  * Reads the local `agent.book` title and falls back to a stable generic name when unavailable.
  */
 export declare function readLocalAgentName(projectPath: string): Promise<string>;
+/**
+ * Reads the local `agent.book` identity and falls back to stable defaults when unavailable.
+ */
+export declare function readLocalAgentUiIdentity(projectPath: string): Promise<AgentRunUiIdentity>;
 /**
  * Extracts the latest `MESSAGE @User` block while preserving the original line breaks.
  */

package/umd/scripts/run-codex-prompts/common/runGoScript/buildTemporaryPromptScriptPath.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Options used to build one Promptbook-owned temporary shell script path.
+ */
+type BuildTemporaryPromptScriptPathOptions = {
+    readonly projectPath: string;
+    readonly scriptDirectoryName: string;
+    readonly sourceFileName: string;
+    readonly suffix?: string;
+};
+/**
+ * Builds a normalized temporary shell script path for prompt runners.
+ */
+export declare function buildTemporaryPromptScriptPath(options: BuildTemporaryPromptScriptPathOptions): string;
+export {};

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

@@ -7,4 +7,5 @@ export declare function commitChanges(message: string, options?: {
     autoPush?: boolean;
     includePaths?: ReadonlyArray<string>;
     excludePaths?: ReadonlyArray<string>;
+    projectPath?: string;
 }): Promise<void>;

package/umd/scripts/run-codex-prompts/git/pullLatestChanges.d.ts

@@ -1,4 +1,4 @@
 /**
  * Pulls the latest repository changes before the next prompt starts.
  */
-export declare function pullLatestChanges(): Promise<void>;
+export declare function pullLatestChanges(projectPath?: string): Promise<void>;

package/umd/scripts/run-codex-prompts/prompts/buildScriptPath.d.ts

@@ -1,6 +1,6 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
 /**
- * Builds the script path for a prompt section.
+ * Builds the temporary script path for a prompt section.
  */
-export declare function buildScriptPath(file: PromptFile, section: PromptSection): string;
+export declare function buildScriptPath(file: PromptFile, section: PromptSection, projectPath?: string): string;

package/umd/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts

@@ -2,6 +2,7 @@
 import { EventEmitter } from 'events';
 import moment from 'moment';
 import { type CoderRunProgressSnapshot } from '../common/buildCoderRunProgressSnapshot';
+import type { AgentRunMessagePreviewSection, AgentRunStatusTableRow } from './buildCoderRunUiFrame';
 import type { PromptStats } from '../prompts/types/PromptStats';
 /**
  * Execution phase of the coder run process.
@@ -40,10 +41,14 @@ export type { CoderRunProgressSnapshot };
 export declare class CoderRunUiState extends EventEmitter {
     config: CoderRunConfig;
     currentPromptLabel: string;
+    currentScriptPaths: string[];
     currentAttempt: number;
     maxAttempts: number;
     detailLines: string[];
     messagePreviewLines: string[];
+    messagePreviewSections: AgentRunMessagePreviewSection[];
+    agentStatusLines: string[];
+    agentStatusTableRows: AgentRunStatusTableRow[];
     pendingEnterLabel: string | undefined;
     agentOutputLines: string[];
     phase: CoderRunPhase;
@@ -77,6 +82,14 @@ export declare class CoderRunUiState extends EventEmitter {
      * Sets the label of the prompt currently being processed and resets per-prompt state.
      */
     setCurrentPrompt(label: string): void;
+    /**
+     * Sets the temporary shell script currently used by the active prompt.
+     */
+    setCurrentScriptPath(scriptPath: string | undefined): void;
+    /**
+     * Sets multiple temporary shell scripts used by a shared multi-agent session.
+     */
+    setCurrentScriptPaths(scriptPaths: readonly string[]): void;
     /**
      * Updates the current retry attempt number.
      */
@@ -101,6 +114,18 @@ export declare class CoderRunUiState extends EventEmitter {
      * Replaces the exact user-message preview lines shown in agent-specific panels.
      */
     setMessagePreviewLines(messagePreviewLines: string[]): void;
+    /**
+     * Replaces the structured user-message panels shown in agent-specific dashboards.
+     */
+    setMessagePreviewSections(messagePreviewSections: AgentRunMessagePreviewSection[]): void;
+    /**
+     * Replaces agent status rows shown by agent-specific terminal frames.
+     */
+    setAgentStatusLines(agentStatusLines: string[]): void;
+    /**
+     * Replaces structured agent status rows shown by agent-specific terminal frames.
+     */
+    setAgentStatusTableRows(agentStatusTableRows: AgentRunStatusTableRow[]): void;
     /**
      * Sets or clears the Enter-key action label shown in the controls panel.
      */

package/umd/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts

@@ -15,16 +15,35 @@ export type BuildCoderRunUiFrameOptions = {
     readonly config: CoderRunConfig;
     readonly phase: CoderRunPhase;
     readonly currentPromptLabel: string;
+    readonly currentScriptPaths?: readonly string[];
     readonly currentAttempt: number;
     readonly maxAttempts: number;
     readonly statusMessage: string;
     readonly detailLines: readonly string[];
     readonly messagePreviewLines?: readonly string[];
+    readonly messagePreviewSections?: readonly AgentRunMessagePreviewSection[];
+    readonly agentStatusLines?: readonly string[];
+    readonly agentStatusTableRows?: readonly AgentRunStatusTableRow[];
     readonly pendingEnterLabel?: string;
     readonly agentOutputLines: readonly string[];
     readonly errors: readonly string[];
     readonly progress: CoderRunProgressSnapshot;
 };
+/**
+ * Structured row rendered in the agent-run `Agents` table.
+ */
+export type AgentRunStatusTableRow = {
+    readonly status: 'Idle' | 'Answering';
+    readonly agentName: string;
+    readonly url: string;
+};
+/**
+ * Structured user-message panel rendered by the agent-run dashboard.
+ */
+export type AgentRunMessagePreviewSection = {
+    readonly title: string;
+    readonly messagePreviewLines: readonly string[];
+};
 /**
  * Builds the complete boxed terminal frame for the rich `ptbk coder run` UI.
  */

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

@@ -35,6 +35,10 @@ export declare function renderBox(title: string, lines: readonly string[], total
  * Builds one aligned labeled line inside the session box.
  */
 export declare function buildLabeledSessionLine(label: string, value: string, bodyWidth: number): string;
+/**
+ * Builds session rows with clickable links to active temporary runner shell scripts.
+ */
+export declare function buildScriptPathSessionRows(scriptPaths: readonly string[], bodyWidth: number): readonly SessionRow[];
 /**
  * Builds the colored phase badge shown in the session box.
  */

package/umd/src/book-3.0/Book.d.ts

@@ -24,6 +24,12 @@ export declare class Book {
     private constructor();
     stringify(): string_book;
     getMessages(): ReadonlyArray<ChatMessage>;
+    /**
+     * Gets the newest parsed chat message written by the given sender.
+     *
+     * @public exported from `@promptbook/core`
+     */
+    getLatestMessageBySender(sender: string): ChatMessage | null;
 }
 type Commitment = {
     type: string;

package/umd/src/book-components/Chat/save/_common/chatExportRendering.d.ts

@@ -0,0 +1,28 @@
+import type { ChatParticipant } from '../../types/ChatParticipant';
+/**
+ * Minimal participant visuals needed by chat exports.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export type ChatExportParticipantVisuals = {
+    readonly displayName: string;
+    readonly accentColor: string;
+};
+/**
+ * Formats exported timestamps into a compact human-readable label.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function formatChatExportTimestamp(value?: string | Date): string;
+/**
+ * Builds a participant lookup indexed by both raw and upper-cased names.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function buildChatExportParticipantMap(participants: ReadonlyArray<ChatParticipant>): ReadonlyMap<string, ChatParticipant>;
+/**
+ * Resolves the display label and accent color for one message sender.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function resolveChatExportParticipantVisuals(participants: ReadonlyMap<string, ChatParticipant>, sender: string): ChatExportParticipantVisuals;

package/umd/src/book-components/Chat/save/_common/getPromptbookExportBranding.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Promptbook branding metadata embedded into standalone chat exports.
+ */
+type PromptbookExportBranding = {
+    readonly productName: string;
+    readonly creatorTool: string;
+    readonly metadataSummary: string;
+    readonly keywords: ReadonlyArray<string>;
+    readonly commentLines: ReadonlyArray<string>;
+    readonly detailLines: ReadonlyArray<string>;
+};
+/**
+ * Builds shared Promptbook export branding for standalone save formats.
+ *
+ * @private internal utility of chat save format definitions
+ */
+export declare function getPromptbookExportBranding(): PromptbookExportBranding;
+export {};

package/umd/src/book-components/Chat/save/html/htmlSaveFormatDefinition.d.ts

@@ -7,7 +7,7 @@ import type { ChatParticipant } from '../../types/ChatParticipant';
  */
 export declare const htmlSaveFormatDefinition: {
     readonly formatName: "html";
-    readonly label: "Html";
+    readonly label: "HTML";
     readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly ChatMessage[];

package/umd/src/book-components/Chat/save/html/htmlSaveFormatDefinition.test.d.ts

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

package/umd/src/book-components/Chat/save/index.d.ts

@@ -26,7 +26,7 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
 }, {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];
@@ -35,7 +35,7 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly fileExtension: "md";
 }, {
     readonly formatName: "html";
-    readonly label: "Html";
+    readonly label: "HTML";
     readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
@@ -55,8 +55,8 @@ export declare const CHAT_SAVE_FORMATS: readonly [{
     readonly fileExtension: "jsx";
 }, {
     readonly formatName: "pdf";
-    readonly label: "Pdf";
-    readonly getContent: ({ messages, participants }: {
+    readonly label: "PDF";
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../types/ChatParticipant").ChatParticipant[];

package/umd/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.d.ts

@@ -6,7 +6,7 @@
 export declare const mdSaveFormatDefinition: {
     readonly formatName: "md";
     readonly label: "Markdown";
-    readonly getContent: ({ messages }: {
+    readonly getContent: ({ messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];

package/umd/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.test.d.ts

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

package/umd/src/book-components/Chat/save/pdf/buildChatPdf.d.ts

@@ -1,12 +1,13 @@
 import type { ChatMessage } from '../../types/ChatMessage';
 import type { ChatParticipant } from '../../types/ChatParticipant';
 /**
- * Creates a minimal PDF representation of the provided chat.
+ * Builds a polished PDF representation of the provided chat.
  *
+ * @param title - Title used in the PDF heading and metadata.
  * @param messages - Messages that should be included in the PDF export.
  * @param participants - Optional participant metadata to resolve sender names.
  * @returns Binary data for the generated PDF file.
  *
  * @private Internal helper used by `pdfSaveFormatDefinition`.
  */
-export declare function buildChatPdf(messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;
+export declare function buildChatPdf(title: string, messages: ReadonlyArray<ChatMessage>, participants?: ReadonlyArray<ChatParticipant>): Uint8Array;

package/umd/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.d.ts

@@ -5,8 +5,8 @@
  */
 export declare const pdfSaveFormatDefinition: {
     readonly formatName: "pdf";
-    readonly label: "Pdf";
-    readonly getContent: ({ messages, participants }: {
+    readonly label: "PDF";
+    readonly getContent: ({ title, messages, participants }: {
         readonly title: string;
         readonly messages: readonly import("../../types/ChatMessage").ChatMessage[];
         readonly participants: readonly import("../../types/ChatParticipant").ChatParticipant[];

package/umd/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.test.d.ts

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

package/umd/src/book-components/Chat/save/react/reactSaveFormatDefinition.test.d.ts

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

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

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

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

@@ -0,0 +1,26 @@
+import type { string_html, string_markdown } from '../../../types/string_markdown';
+/**
+ * Options for markdown rendering.
+ */
+type RenderMarkdownOptions = {
+    readonly citationReferenceClassName?: string;
+};
+/**
+ * Convert markdown content to HTML.
+ *
+ * @param markdown - The markdown content to convert.
+ * @returns HTML string ready for rendering.
+ *
+ * @private internal utility of chat components and exports
+ */
+export declare function renderMarkdown(markdown: string_markdown, options?: RenderMarkdownOptions): string_html;
+/**
+ * Detects whether text appears to contain markdown syntax.
+ *
+ * @param markdown - The text to inspect.
+ * @returns Whether the text contains known markdown markers.
+ *
+ * @private internal utility of chat components and exports
+ */
+export declare function isMarkdownContent(markdown: string_markdown): boolean;
+export {};

package/umd/src/cli/cli-commands/agent/agentRunCliOptions.d.ts

@@ -4,10 +4,22 @@ import type { NormalizedPromptRunnerCliOptions, PromptRunnerCliOptions } from '.
  *
  * @private internal utility of `ptbk agent`
  */
-export type AgentRunCliOptions = PromptRunnerCliOptions;
+export type AgentRunCliOptions = PromptRunnerCliOptions & {
+    readonly autoClone?: boolean;
+    readonly ignore?: string | readonly string[];
+};
+/**
+ * Normalized options passed from `ptbk agent` CLI commands to the message runner.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+export type NormalizedAgentRunCliOptions = NormalizedPromptRunnerCliOptions & {
+    readonly autoClone: boolean;
+    readonly ignorePatterns: readonly string[];
+};
 /**
  * Converts Commander options into the `scripts/run-agent-messages` option shape.
  *
  * @private internal utility of `ptbk agent`
  */
-export declare function createAgentRunOptionsFromCliOptions(cliOptions: AgentRunCliOptions): NormalizedPromptRunnerCliOptions;
+export declare function createAgentRunOptionsFromCliOptions(cliOptions: AgentRunCliOptions): NormalizedAgentRunCliOptions;

package/umd/src/cli/cli-commands/agent/initializeAgentRunnerCommand.d.ts

@@ -11,6 +11,8 @@ type InitializeAgentRunnerCommandOptions = {
     readonly aliases?: ReadonlyArray<string>;
     readonly summary: string;
     readonly featureLines: ReadonlyArray<string>;
+    readonly isExitingOnSuccess?: boolean;
+    readonly configureCommand?: (command: Program) => void;
     readonly loadExecutor: () => Promise<(runOptions: ReturnType<typeof createAgentRunOptionsFromCliOptions>) => Promise<unknown>>;
 };
 /**

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

@@ -4,12 +4,17 @@ import type { Command as Program } from 'commander';
  */
 type actionCallbackFunction = Parameters<Program['action']>[0];
 /**
- * Wraps action to handle error console logging and exit process with error code
+ * Options controlling CLI process-exit behavior after one command action finishes.
  *
- * @param action Action to be wrapped in error handling
- * @returns Wrapped action
+ * @private internal helper type for CLI commands
+ */
+type HandleActionErrorsOptions = {
+    readonly isExitingOnSuccess?: boolean;
+};
+/**
+ * Wraps action to handle error console logging and exit process with error code.
  *
  * @private internal helper function for CLI commands
  */
-export declare function handleActionErrors(action: actionCallbackFunction): actionCallbackFunction;
+export declare function handleActionErrors(action: actionCallbackFunction, options?: HandleActionErrorsOptions): actionCallbackFunction;
 export {};

package/umd/src/cli/cli-commands/run/prepareRunCommandResources.d.ts

@@ -0,0 +1,20 @@
+import type { PipelineExecutor } from '../../../execution/PipelineExecutor';
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { PrepareAndScrapeOptions } from '../../../prepare/PrepareAndScrapeOptions';
+import type { RunCommandCliOptions } from './runCommandAction';
+/**
+ * Prepares the tools, pipeline, and executor required to run one `ptbk run` invocation.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function prepareRunCommandResources(options: {
+    readonly pipelineSource?: string;
+    readonly cliOptions: RunCommandCliOptions;
+    readonly prepareAndScrapeOptions: Pick<PrepareAndScrapeOptions, 'isVerbose'> & {
+        readonly isCacheReloaded: boolean;
+    };
+    readonly logStage: (stage: string) => void;
+}): Promise<{
+    readonly pipeline: PipelineJson;
+    readonly pipelineExecutor: PipelineExecutor;
+}>;

package/umd/src/cli/cli-commands/run/resolveRunInputParameters.d.ts

@@ -0,0 +1,12 @@
+import type { PipelineJson } from '../../../pipeline/PipelineJson/PipelineJson';
+import type { string_parameter_name, string_parameter_value } from '../../../types/string_name';
+/**
+ * Resolves all missing input parameters while keeping the current interactive and non-interactive behavior.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function resolveRunInputParameters(options: {
+    readonly pipeline: PipelineJson;
+    readonly inputParameters: Record<string_parameter_name, string_parameter_value>;
+    readonly isInteractive: boolean;
+}): Promise<Record<string_parameter_name, string_parameter_value>>;

package/umd/src/cli/cli-commands/run/runCommandAction.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CLI options consumed by the `run` command action.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export type RunCommandCliOptions = {
+    readonly reload: boolean;
+    readonly interactive: boolean;
+    readonly formfactor: boolean;
+    readonly json?: string;
+    readonly verbose: boolean;
+    readonly saveReport?: string;
+    readonly provider: string;
+    readonly remoteServerUrl: string;
+};
+/**
+ * Runs the whole `ptbk run` flow as a top-down orchestration of focused steps.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function runCommandAction(pipelineSource: string | undefined, cliOptions: RunCommandCliOptions): Promise<void | never>;

package/umd/src/cli/cli-commands/run/runPipelineExecution.d.ts

@@ -0,0 +1,14 @@
+import type { PipelineExecutor } from '../../../execution/PipelineExecutor';
+import type { string_parameter_name, string_parameter_value } from '../../../types/string_name';
+/**
+ * Executes the pipeline, persists any requested report, and prints the final CLI output.
+ *
+ * @private internal utility of `$initializeRunCommand`
+ */
+export declare function runPipelineExecution(options: {
+    readonly pipelineExecutor: PipelineExecutor;
+    readonly inputParameters: Record<string_parameter_name, string_parameter_value>;
+    readonly isVerbose: boolean;
+    readonly json?: string;
+    readonly saveReport?: string;
+}): Promise<void>;

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

@@ -1,4 +1,4 @@
-import type { Command as Program } from 'commander';
+import { Command as Program } from 'commander';
 import type { $side_effect } from '../../utils/organization/$side_effect';
 /**
  * Initializes `run` command for Promptbook CLI utilities

package/umd/src/conversion/parsePipeline/applyPipelineHead.d.ts

@@ -0,0 +1,8 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { MarkdownSection } from '../../utils/markdown/parseMarkdownSection';
+/**
+ * Applies the pipeline head title, description, and head-level commands.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function applyPipelineHead(pipelineHead: MarkdownSection, $pipelineJson: $PipelineJson): void;

package/umd/src/conversion/parsePipeline/createInitialPipelineJson.d.ts

@@ -0,0 +1,8 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { PipelineString } from '../../pipeline/PipelineString';
+/**
+ * Creates the mutable pipeline JSON structure used throughout parsing.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function createInitialPipelineJson(pipelineString: PipelineString): $PipelineJson;