@promptbook/cli 0.112.0-72 → 0.112.0-73

package/esm/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/esm/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/esm/scripts/run-agent-messages/main/tickAgentMessages.d.ts

@@ -1,5 +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';
@@ -17,6 +18,7 @@ export type AgentTickResult = {
  */
 export type TickAgentMessagesOptions = {
     readonly isQuietWhenIdle?: boolean;
+    readonly projectPath?: string;
     readonly uiHandle?: CoderRunUiHandle;
     readonly uiPresentation?: AgentTickUiPresentation;
 };
@@ -24,12 +26,17 @@ export type TickAgentMessagesOptions = {
  * 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;
 };
 /**

package/esm/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/esm/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/esm/scripts/run-agent-messages/ui/loadAgentRunUiMetadata.d.ts

@@ -6,6 +6,15 @@ 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.
  */
@@ -26,6 +35,10 @@ export declare function loadAgentRunQueuedMessagePreview(queuedMessage: AgentMes
  * 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/esm/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/esm/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/esm/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/esm/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/esm/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,11 +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;
@@ -78,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.
      */
@@ -102,10 +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/esm/scripts/run-codex-prompts/ui/buildCoderRunUiFrame.d.ts

@@ -15,17 +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/esm/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/esm/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/esm/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/esm/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/esm/src/book-components/Chat/save/html/htmlSaveFormatDefinition.test.d.ts

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

package/esm/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/esm/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/esm/src/book-components/Chat/save/markdown/mdSaveFormatDefinition.test.d.ts

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

package/esm/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/esm/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/esm/src/book-components/Chat/save/pdf/pdfSaveFormatDefinition.test.d.ts

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

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

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

package/esm/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/esm/src/cli/cli-commands/agent/agentRunCliOptions.d.ts

@@ -6,6 +6,7 @@ import type { NormalizedPromptRunnerCliOptions, PromptRunnerCliOptions } from '.
  */
 export type AgentRunCliOptions = PromptRunnerCliOptions & {
     readonly autoClone?: boolean;
+    readonly ignore?: string | readonly string[];
 };
 /**
  * Normalized options passed from `ptbk agent` CLI commands to the message runner.
@@ -14,6 +15,7 @@ export type AgentRunCliOptions = PromptRunnerCliOptions & {
  */
 export type NormalizedAgentRunCliOptions = NormalizedPromptRunnerCliOptions & {
     readonly autoClone: boolean;
+    readonly ignorePatterns: readonly string[];
 };
 /**
  * Converts Commander options into the `scripts/run-agent-messages` option shape.

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

@@ -11,6 +11,7 @@ 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/esm/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/esm/src/conversion/pipelineJsonToString/appendMarkdownBlock.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Appends one markdown block to an existing markdown document.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function appendMarkdownBlock(pipelineString: string_markdown, markdownBlock: string_markdown): string_markdown;

package/esm/src/conversion/pipelineJsonToString/createPipelineCommands.d.ts

@@ -0,0 +1,7 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Collects pipeline-level commands in the existing serialization order.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createPipelineCommands(pipelineJson: PipelineJson): Array<string>;

package/esm/src/conversion/pipelineJsonToString/createPipelineIntroduction.d.ts

@@ -0,0 +1,8 @@
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Creates the initial markdown heading and description of a pipeline.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createPipelineIntroduction(pipelineJson: PipelineJson): string_markdown;

package/esm/src/conversion/pipelineJsonToString/createTaskSerialization.d.ts

@@ -0,0 +1,23 @@
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+/**
+ * Code fence language used when stringifying a pipeline task.
+ *
+ * @private internal type of `createTaskSerialization`
+ */
+type PipelineTaskContentLanguage = 'markdown' | 'text' | 'javascript' | 'typescript' | 'python' | '';
+/**
+ * All derived serialization details needed to render one task section.
+ *
+ * @private internal type of `createTaskSerialization`
+ */
+type TaskSerialization = {
+    readonly commands: Array<string>;
+    readonly contentLanguage: PipelineTaskContentLanguage;
+};
+/**
+ * Collects all task-specific serialization details.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function createTaskSerialization(task: TaskJson): TaskSerialization;
+export {};

package/esm/src/conversion/pipelineJsonToString/stringifyCommands.d.ts

@@ -0,0 +1,7 @@
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Renders commands as markdown bullet items.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function stringifyCommands(commands: ReadonlyArray<string>): string_markdown;

package/esm/src/conversion/pipelineJsonToString/stringifyTask.d.ts

@@ -0,0 +1,8 @@
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { string_markdown } from '../../types/string_markdown';
+/**
+ * Stringifies one task section of the pipeline.
+ *
+ * @private internal utility of `pipelineJsonToString`
+ */
+export declare function stringifyTask(task: TaskJson): string_markdown;

package/esm/src/conversion/pipelineJsonToString.test.d.ts

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

package/esm/src/execution/createPipelineExecutor/executeSingleAttempt.d.ts

@@ -0,0 +1,31 @@
+import type { string_parameter_name } from '../../types/string_name';
+import type { LlmExecutionTools } from '../LlmExecutionTools';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+import type { ExecuteAttemptsOptions } from './40-executeAttempts';
+/**
+ * Executes one loop iteration, from joker resolution or task execution through validation.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function executeSingleAttempt(options: {
+    /**
+     * Metadata describing the current loop iteration.
+     */
+    readonly attempt: {
+        readonly attemptIndex: number;
+        readonly isJokerAttempt: boolean;
+        readonly jokerParameterName?: string_parameter_name;
+    };
+    /**
+     * Immutable executor options shared across all attempts.
+     */
+    readonly options: ExecuteAttemptsOptions;
+    /**
+     * Narrowed LLM execution tools for prompt tasks.
+     */
+    readonly llmTools: LlmExecutionTools;
+    /**
+     * Mutable per-task state accumulated across attempts.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): Promise<void>;

package/esm/src/execution/createPipelineExecutor/handleAttemptFailure.d.ts

@@ -0,0 +1,40 @@
+import type { PartialDeep, Promisable } from 'type-fest';
+import { ExpectError } from '../../errors/ExpectError';
+import type { PipelineExecutorResult } from '../PipelineExecutorResult';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+/**
+ * Stores one failed attempt, reports the expectation error, and throws the aggregated retry error after the final
+ * regular attempt.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function handleAttemptFailure(options: {
+    /**
+     * Expectation error raised by the current attempt.
+     */
+    readonly error: ExpectError;
+    /**
+     * Zero-based attempt index for the current execution loop.
+     */
+    readonly attemptIndex: number;
+    /**
+     * Maximum number of attempts for the current task type.
+     */
+    readonly maxAttempts: number;
+    /**
+     * Maximum number of model execution attempts for prompt tasks.
+     */
+    readonly maxExecutionAttempts: number;
+    /**
+     * Callback invoked with partial progress updates.
+     */
+    onProgress(newOngoingResult: PartialDeep<PipelineExecutorResult>): Promisable<void>;
+    /**
+     * String identifier for the pipeline, used for error reporting.
+     */
+    readonly pipelineIdentification: string;
+    /**
+     * Mutable per-task execution state.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): void;