@promptbook/fake-llm 0.112.0-71 → 0.112.0-73

package/esm/index.es.js

@@ -20,7 +20,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-71';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-73';
 /**
  * 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-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/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/getToolCallChipletInfo.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

@@ -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/esm/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/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/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/esm/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/esm/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/esm/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/esm/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/esm/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/esm/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;

package/esm/src/conversion/parsePipeline/createUniqueSectionNameResolver.d.ts

@@ -0,0 +1,14 @@
+import type { string_name } from '../../types/string_name';
+import type { MarkdownSection } from '../../utils/markdown/parseMarkdownSection';
+/**
+ * Resolves a unique task name for one parsed markdown section title.
+ *
+ * @private internal type of `parsePipeline`
+ */
+export type UniqueSectionNameResolver = (title: string) => string_name;
+/**
+ * Creates stable unique task names for duplicate section titles.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function createUniqueSectionNameResolver(pipelineSections: ReadonlyArray<MarkdownSection>): UniqueSectionNameResolver;

package/esm/src/conversion/parsePipeline/defineParameter.d.ts

@@ -0,0 +1,8 @@
+import type { ParameterCommand } from '../../commands/PARAMETER/ParameterCommand';
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+/**
+ * Merges one parameter declaration into the mutable pipeline parameter list.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function defineParameter($pipelineJson: $PipelineJson, parameterCommand: Omit<ParameterCommand, 'type'>): void;

package/esm/src/conversion/parsePipeline/extractPipelineDescription.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Extracts the plain-text description from a head or task section body.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function extractPipelineDescription(sectionContent: string): string | undefined;

package/esm/src/conversion/parsePipeline/finalizeParsedPipeline.d.ts

@@ -0,0 +1,8 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { PipelineJson } from '../../pipeline/PipelineJson/PipelineJson';
+/**
+ * Applies postprocessing and exports the parsed pipeline JSON.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function finalizeParsedPipeline($pipelineJson: $PipelineJson): PipelineJson;

package/esm/src/conversion/parsePipeline/getPipelineIdentification.d.ts

@@ -0,0 +1,7 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+/**
+ * Builds a short file/url identification block for parse errors.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function getPipelineIdentification($pipelineJson: $PipelineJson): string;

package/esm/src/conversion/parsePipeline/parsePreparedPipelineSections.d.ts

@@ -0,0 +1,18 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { MarkdownSection } from '../../utils/markdown/parseMarkdownSection';
+import type { PipelineString } from '../../pipeline/PipelineString';
+/**
+ * Parsed markdown structure split into the pipeline head and task sections.
+ *
+ * @private internal type of `parsePipeline`
+ */
+export type ParsedPipelineSections = {
+    readonly pipelineHead: MarkdownSection;
+    readonly pipelineSections: ReadonlyArray<MarkdownSection>;
+};
+/**
+ * Splits the prepared markdown into the pipeline head and task sections.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function parsePreparedPipelineSections(pipelineString: PipelineString, $pipelineJson: $PipelineJson): ParsedPipelineSections;

package/esm/src/conversion/parsePipeline/preparePipelineString.d.ts

@@ -0,0 +1,8 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { PipelineString } from '../../pipeline/PipelineString';
+/**
+ * Removes shebang/comments and normalizes markdown into a parseable pipeline form.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function preparePipelineString(pipelineString: PipelineString, $pipelineJson: $PipelineJson): PipelineString;

package/esm/src/conversion/parsePipeline/processPipelineSection.d.ts

@@ -0,0 +1,9 @@
+import type { $PipelineJson } from '../../commands/_common/types/CommandParser';
+import type { MarkdownSection } from '../../utils/markdown/parseMarkdownSection';
+import type { UniqueSectionNameResolver } from './createUniqueSectionNameResolver';
+/**
+ * Parses, applies, and persists one h2 task section.
+ *
+ * @private internal utility of `parsePipeline`
+ */
+export declare function processPipelineSection(pipelineSection: MarkdownSection, $pipelineJson: $PipelineJson, getUniqueSectionName: UniqueSectionNameResolver): void;

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;

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

@@ -0,0 +1,34 @@
+import type { Promisable, ReadonlyDeep, WritableDeep } from 'type-fest';
+import type { TaskJson } from '../../pipeline/PipelineJson/TaskJson';
+import type { LlmCall } from '../../types/LlmCall';
+import type { ExecutionReportJson } from '../execution-report/ExecutionReportJson';
+import type { $OngoingTaskResult } from './$OngoingTaskResult';
+/**
+ * Appends the prompt execution report for prompt-task attempts.
+ *
+ * @private function of `executeAttempts`
+ */
+export declare function reportPromptExecution(options: {
+    /**
+     * Metadata describing the current loop iteration.
+     */
+    readonly attempt: {
+        readonly isJokerAttempt: boolean;
+    };
+    /**
+     * Task currently being executed.
+     */
+    readonly task: ReadonlyDeep<TaskJson>;
+    /**
+     * Mutable execution report object to append prompt execution data to.
+     */
+    readonly $executionReport: WritableDeep<ExecutionReportJson>;
+    /**
+     * Optional callback invoked with each LLM call.
+     */
+    logLlmCall?(llmCall: LlmCall): Promisable<void>;
+    /**
+     * Mutable per-task execution state.
+     */
+    readonly $ongoingTaskResult: $OngoingTaskResult;
+}): void;