@promptbook/google 0.112.0-72 → 0.112.0-79

package/umd/src/book-components/Chat/save/react/reactSaveFormatDefinition.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/agentProjectPaths.d.ts

@@ -4,6 +4,12 @@
  * @private internal utility of `ptbk agent`
  */
 export declare const AGENT_BOOK_FILE_PATH = "agent.book";
+/**
+ * Relative path to local knowledge files initialized by `ptbk agent init`.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+export declare const AGENT_KNOWLEDGE_DIRECTORY_PATH = "knowledge";
 /**
  * Relative path to the message queue root initialized by `ptbk agent init`.
  *
@@ -23,19 +29,13 @@ export declare const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH: string;
  */
 export declare const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH: string;
 /**
- * Relative path to local knowledge files referenced by the default agent prompt.
- *
- * @private internal utility of `ptbk agent`
- */
-export declare const AGENT_KNOWLEDGE_DIRECTORY_PATH = "knowledge";
-/**
- * Relative path to local agent documentation initialized by `ptbk agent init`.
+ * Relative path to generated local agent documentation initialized by `ptbk agent init`.
  *
  * @private internal utility of `ptbk agent`
  */
 export declare const AGENT_DOCS_DIRECTORY_PATH = "docs";
 /**
- * Relative path to the local Book language manual used by the coding runner prompt.
+ * Relative path to the local Book language manual initialized by `ptbk agent init`.
  *
  * @private internal utility of `ptbk agent`
  */

package/umd/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/umd/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 executionMode: 'once' | 'watch';
     readonly configureCommand?: (command: Program) => void;
     readonly loadExecutor: () => Promise<(runOptions: ReturnType<typeof createAgentRunOptionsFromCliOptions>) => Promise<unknown>>;
 };

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

@@ -0,0 +1,56 @@
+/// <reference types="node" />
+/**
+ * Inputs controlling one cached Agents Server production build.
+ *
+ * @private internal type of `ptbk agents-server`
+ */
+type EnsureAgentsServerBuildOptions = {
+    readonly appPath?: string;
+    readonly environment?: NodeJS.ProcessEnv;
+    readonly isBuildForced?: boolean;
+    readonly onBuildEvent?: (event: string) => void;
+    readonly onBuildOutput?: (chunk: string) => void;
+};
+/**
+ * Paths needed after the Agents Server production build is ready.
+ *
+ * @private internal type of `ptbk agents-server`
+ */
+export type AgentsServerBuildArtifacts = {
+    readonly appPath: string;
+    readonly nextCliPath: string;
+};
+/**
+ * Input paths required to validate or update the cached Agents Server build.
+ *
+ * @private internal type of `ptbk agents-server`
+ */
+type AgentsServerBuildCacheOptions = {
+    readonly appPath: string;
+    readonly environment?: NodeJS.ProcessEnv;
+};
+/**
+ * Ensures that the local Agents Server production build exists and matches its source fingerprint.
+ *
+ * @private internal utility of `ptbk agents-server`
+ */
+export declare function ensureAgentsServerBuild(options?: EnsureAgentsServerBuildOptions): Promise<AgentsServerBuildArtifacts>;
+/**
+ * Returns true when the production build marker and source fingerprint still match.
+ *
+ * @private internal utility of `ptbk agents-server`
+ */
+export declare function isAgentsServerBuildCacheCurrent(options: AgentsServerBuildCacheOptions): Promise<boolean>;
+/**
+ * Persists the source fingerprint for the just-created production build.
+ *
+ * @private internal utility of `ptbk agents-server`
+ */
+export declare function writeAgentsServerBuildCache(options: AgentsServerBuildCacheOptions): Promise<void>;
+/**
+ * Finds the Agents Server app in a source checkout or generated CLI package.
+ *
+ * @private internal utility of `ptbk agents-server`
+ */
+export declare function resolveAgentsServerAppPath(): Promise<string>;
+export {};

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

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

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

@@ -0,0 +1,7 @@
+import { type EnsureProjectEnvFileResult } from '../common/projectInitialization';
+/**
+ * Ensures `.env` contains all required Agents Server configuration entries.
+ *
+ * @private internal utility of `ptbk agents-server init`
+ */
+export declare function ensureAgentsServerEnvFile(projectPath: string): Promise<EnsureProjectEnvFileResult>;

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

@@ -0,0 +1,7 @@
+import { type ProjectInitializationStatus } from '../common/projectInitialization';
+/**
+ * Ensures `.gitignore` excludes local Agents Server runtime artifacts.
+ *
+ * @private internal utility of `ptbk agents-server init`
+ */
+export declare function ensureAgentsServerGitignoreFile(projectPath: string): Promise<ProjectInitializationStatus>;

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

@@ -0,0 +1,9 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+export { initializeAgentsServerProjectConfiguration } from './initializeAgentsServerProjectConfiguration';
+/**
+ * Initializes `agents-server init` command for Promptbook CLI utilities.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAgentsServerInitCommand(program: Program): $side_effect;

package/umd/src/cli/cli-commands/agents-server/init.test.d.ts

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

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

@@ -0,0 +1,17 @@
+import type { ProjectInitializationStatus } from '../common/projectInitialization';
+/**
+ * Result summary returned after Agents Server configuration initialization.
+ *
+ * @private internal utility of `ptbk agents-server init`
+ */
+export type AgentsServerInitializationSummary = {
+    readonly envFileStatus: ProjectInitializationStatus;
+    readonly gitignoreFileStatus: ProjectInitializationStatus;
+    readonly initializedEnvVariableNames: ReadonlyArray<string>;
+};
+/**
+ * Creates or updates local Agents Server configuration files in the current project.
+ *
+ * @private internal utility of `ptbk agents-server init`
+ */
+export declare function initializeAgentsServerProjectConfiguration(projectPath: string): Promise<AgentsServerInitializationSummary>;

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

@@ -0,0 +1,7 @@
+import type { AgentsServerInitializationSummary } from './initializeAgentsServerProjectConfiguration';
+/**
+ * Prints a readable summary of local Agents Server configuration initialization.
+ *
+ * @private internal utility of `ptbk agents-server init`
+ */
+export declare function printAgentsServerInitializationSummary(summary: AgentsServerInitializationSummary): void;

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

@@ -0,0 +1,14 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../../utils/organization/$side_effect';
+/**
+ * Initializes `agents-server start` command for Promptbook CLI utilities.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAgentsServerStartCommand(program: Program): $side_effect;
+/**
+ * Initializes `agents-server build` command for Promptbook CLI utilities.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAgentsServerBuildCommand(program: Program): $side_effect;

package/umd/src/cli/cli-commands/agents-server/run.test.d.ts

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

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

@@ -0,0 +1,23 @@
+import type { ThinkingLevel } from '../coder/ThinkingLevel';
+import type { PromptRunnerAgentName } from '../common/promptRunnerCliOptions';
+import type { number_port } from '../../../types/number_positive';
+/**
+ * Options required to start the foreground Agents Server service group.
+ *
+ * @private internal type of `ptbk agents-server`
+ */
+export type StartAgentsServerOptions = {
+    readonly port: number_port;
+    readonly agentName: PromptRunnerAgentName;
+    readonly model?: string;
+    readonly noUi: boolean;
+    readonly thinkingLevel?: ThinkingLevel;
+    readonly allowCredits: boolean;
+    readonly isBuildForced: boolean;
+};
+/**
+ * Starts the Agents Server web app and local coding-agent queue workers in the foreground.
+ *
+ * @private internal utility of `ptbk agents-server`
+ */
+export declare function startAgentsServer(options: StartAgentsServerOptions): Promise<void>;

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

@@ -0,0 +1,8 @@
+import type { Command as Program } from 'commander';
+import type { $side_effect } from '../../utils/organization/$side_effect';
+/**
+ * Initializes `agents-server` command with subcommands for Promptbook CLI utilities.
+ *
+ * @private internal function of `promptbookCli`
+ */
+export declare function $initializeAgentsServerCommand(program: Program): $side_effect;

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/common/projectInitialization.d.ts

@@ -0,0 +1,65 @@
+/**
+ * File status returned by project configuration bootstrapping helpers.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export type ProjectInitializationStatus = 'created' | 'updated' | 'unchanged';
+/**
+ * Minimal environment variable descriptor used for additive `.env` initialization.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export type ProjectEnvVariableDefinition = {
+    readonly name: string;
+};
+/**
+ * Result of one additive `.env` initialization attempt.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export type EnsureProjectEnvFileResult = {
+    readonly envFileStatus: ProjectInitializationStatus;
+    readonly initializedEnvVariableNames: ReadonlyArray<string>;
+};
+/**
+ * Options required to append missing variables into a project `.env`.
+ */
+type EnsureProjectEnvFileOptions<TEnvVariable extends ProjectEnvVariableDefinition> = {
+    readonly projectPath: string;
+    readonly emptyFileContent: string;
+    readonly envVariables: ReadonlyArray<TEnvVariable>;
+    readonly buildMissingEnvVariablesBlock: (envVariables: ReadonlyArray<TEnvVariable>) => string;
+};
+/**
+ * Options required to append missing rules into a project `.gitignore`.
+ */
+type EnsureProjectGitignoreFileOptions = {
+    readonly projectPath: string;
+    readonly blockHeader: string;
+    readonly rules: ReadonlyArray<string>;
+};
+/**
+ * Ensures `.env` exists and appends only still-missing variable definitions.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function ensureProjectEnvFile<TEnvVariable extends ProjectEnvVariableDefinition>({ projectPath, emptyFileContent, envVariables, buildMissingEnvVariablesBlock, }: EnsureProjectEnvFileOptions<TEnvVariable>): Promise<EnsureProjectEnvFileResult>;
+/**
+ * Ensures `.gitignore` contains all required project initialization rules.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function ensureProjectGitignoreFile({ projectPath, blockHeader, rules, }: EnsureProjectGitignoreFileOptions): Promise<ProjectInitializationStatus>;
+/**
+ * Reads one text file when it exists, otherwise returns `undefined`.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function readTextFileIfExists(path: string): Promise<string | undefined>;
+/**
+ * Appends one text block to existing file content while preserving readable newlines.
+ *
+ * @private internal utility of Promptbook CLI project initialization
+ */
+export declare function appendBlock(currentContent: string, blockToAppend: string): string;
+export {};

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

@@ -6,6 +6,24 @@ import type { ThinkingLevel } from '../coder/ThinkingLevel';
  * @private internal utility of `promptbookCli`
  */
 export declare const PROMPT_RUNNER_AGENT_NAMES: readonly ["openai-codex", "github-copilot", "cline", "claude-code", "opencode", "gemini"];
+/**
+ * Environment variable used as the default runner identifier when `--agent` is omitted.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const PTBK_AGENT_ENV = "PTBK_AGENT";
+/**
+ * Environment variable used as the default runner model when `--model` is omitted.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const PTBK_MODEL_ENV = "PTBK_MODEL";
+/**
+ * Environment variable used as the default runner thinking level when `--thinking-level` is omitted.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare const PTBK_THINKING_LEVEL_ENV = "PTBK_THINKING_LEVEL";
 /**
  * Runner identifier supported by Promptbook CLI agent orchestration commands.
  *
@@ -29,6 +47,12 @@ export type PromptRunnerCliOptions = {
     readonly autoPush: boolean;
     readonly autoPull: boolean;
 };
+/**
+ * Commander option bag for runner selection plus terminal/runtime switches shared with server orchestration.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type PromptRunnerSelectionCliOptions = Pick<PromptRunnerCliOptions, 'agent' | 'model' | 'ui' | 'thinkingLevel' | 'allowCredits'>;
 /**
  * Normalized runner options used by runner-backed CLI commands.
  *
@@ -46,6 +70,12 @@ export type NormalizedPromptRunnerCliOptions = {
     readonly autoPush: boolean;
     readonly autoPull: boolean;
 };
+/**
+ * Normalized runner selection plus terminal/runtime switches shared with server orchestration.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export type NormalizedPromptRunnerSelectionCliOptions = Pick<NormalizedPromptRunnerCliOptions, 'agentName' | 'model' | 'noUi' | 'thinkingLevel' | 'allowCredits'>;
 /**
  * Description block shared by runner-backed CLI commands.
  *
@@ -70,6 +100,12 @@ export declare const PROMPT_RUNNER_MODEL_OPTION_DESCRIPTION: string;
  * @private internal utility of `promptbookCli`
  */
 export declare function addPromptRunnerSelectionOptions(command: Program): void;
+/**
+ * Registers shared runner terminal/runtime flags on a command.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function addPromptRunnerRuntimeOptions(command: Program): void;
 /**
  * Registers shared runner execution flags on a command.
  *
@@ -84,3 +120,11 @@ export declare function addPromptRunnerExecutionOptions(command: Program): void;
 export declare function normalizePromptRunnerCliOptions(cliOptions: PromptRunnerCliOptions, options: {
     readonly isAgentRequired: boolean;
 }): NormalizedPromptRunnerCliOptions;
+/**
+ * Converts Commander runner selection/runtime flags into the normalized runner shape.
+ *
+ * @private internal utility of `promptbookCli`
+ */
+export declare function normalizePromptRunnerSelectionCliOptions(cliOptions: PromptRunnerSelectionCliOptions, options: {
+    readonly isAgentRequired: boolean;
+}): NormalizedPromptRunnerSelectionCliOptions;

package/umd/src/cli/common/$deprecateCliCommand.d.ts

@@ -0,0 +1,8 @@
+import { Command } from 'commander';
+import type { $side_effect } from '../../utils/organization/$side_effect';
+/**
+ * Marks one CLI command as deprecated while keeping it available for existing callers.
+ *
+ * @private utility of CLI
+ */
+export declare function $deprecateCliCommand(command: Command, deprecationMessage: string): $side_effect;

package/umd/src/cli/common/$deprecateCliCommand.test.d.ts

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

package/umd/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/umd/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/umd/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/umd/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/umd/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/umd/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/umd/src/conversion/pipelineJsonToString.test.d.ts

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

package/umd/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/umd/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/umd/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;

package/umd/src/execution/resolveTaskTldr.d.ts

@@ -0,0 +1,32 @@
+import type { number_percent } from '../types/number_percent';
+import type { chococake } from '../utils/organization/really_any';
+import type { task_status } from './ExecutionTask';
+/**
+ * Shared type for task TLDR information.
+ *
+ * @private internal type of `ExecutionTask`
+ */
+type TaskTldrInfo = {
+    readonly percent: number_percent;
+    readonly message: string;
+};
+/**
+ * Snapshot of the mutable task state needed to resolve the fallback TLDR.
+ *
+ * @private internal type of `ExecutionTask`
+ */
+type ResolveTaskTldrOptions = {
+    readonly customTldr: TaskTldrInfo | null;
+    readonly currentValue: chococake;
+    readonly status: task_status;
+    readonly createdAt: Date;
+    readonly errors: ReadonlyArray<Error>;
+    readonly warnings: ReadonlyArray<Error>;
+};
+/**
+ * Resolves the short task summary shown in the UI.
+ *
+ * @private internal helper function of `ExecutionTask`
+ */
+export declare function resolveTaskTldr(options: ResolveTaskTldrOptions): TaskTldrInfo;
+export {};