@promptbook/cli 0.112.0-71 → 0.112.0-72

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

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

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

@@ -6,10 +6,22 @@ export type AgentRunUiMetadata = {
     readonly localAgentName: string;
     readonly latestUserMessageLines: readonly 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.
  */

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

@@ -44,6 +44,7 @@ export declare class CoderRunUiState extends EventEmitter {
     maxAttempts: number;
     detailLines: string[];
     messagePreviewLines: string[];
+    agentStatusLines: string[];
     pendingEnterLabel: string | undefined;
     agentOutputLines: string[];
     phase: CoderRunPhase;
@@ -101,6 +102,10 @@ export declare class CoderRunUiState extends EventEmitter {
      * Replaces the exact user-message preview lines shown in agent-specific panels.
      */
     setMessagePreviewLines(messagePreviewLines: string[]): void;
+    /**
+     * Replaces agent status rows shown by agent-specific terminal frames.
+     */
+    setAgentStatusLines(agentStatusLines: string[]): void;
     /**
      * Sets or clears the Enter-key action label shown in the controls panel.
      */

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

@@ -20,6 +20,7 @@ export type BuildCoderRunUiFrameOptions = {
     readonly statusMessage: string;
     readonly detailLines: readonly string[];
     readonly messagePreviewLines?: readonly string[];
+    readonly agentStatusLines?: readonly string[];
     readonly pendingEnterLabel?: string;
     readonly agentOutputLines: readonly string[];
     readonly errors: readonly string[];

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/utils/getToolCallChipletInfo.test.d.ts

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

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

@@ -4,10 +4,20 @@ import type { NormalizedPromptRunnerCliOptions, PromptRunnerCliOptions } from '.
  *
  * @private internal utility of `ptbk agent`
  */
-export type AgentRunCliOptions = PromptRunnerCliOptions;
+export type AgentRunCliOptions = PromptRunnerCliOptions & {
+    readonly autoClone?: boolean;
+};
+/**
+ * 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;
+};
 /**
  * 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,7 @@ type InitializeAgentRunnerCommandOptions = {
     readonly aliases?: ReadonlyArray<string>;
     readonly summary: string;
     readonly featureLines: ReadonlyArray<string>;
+    readonly configureCommand?: (command: Program) => void;
     readonly loadExecutor: () => Promise<(runOptions: ReturnType<typeof createAgentRunOptionsFromCliOptions>) => Promise<unknown>>;
 };
 /**

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

@@ -15,7 +15,7 @@ export declare const BOOK_LANGUAGE_VERSION: string_semantic_version;
 export declare const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version;
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-70`).
+ * It follows semantic versioning (e.g., `0.112.0-71`).
  *
  * @generated
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-71",
+    "version": "0.112.0-72",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,