@promptbook/cli 0.112.0-65 → 0.112.0-66

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

@@ -0,0 +1,4 @@
+/**
+ * Builds a compact centered initials banner for `ptbk agent run`.
+ */
+export declare function buildAgentRunInitialsVisual(agentName: string, totalWidth: number): readonly string[];

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

@@ -0,0 +1,5 @@
+import type { BuildCoderRunUiFrameOptions } from '../../run-codex-prompts/ui/buildCoderRunUiFrame';
+/**
+ * Builds the complete boxed terminal frame for the rich `ptbk agent run` UI.
+ */
+export declare function buildAgentRunUiFrame(options: BuildCoderRunUiFrameOptions): string[];

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

@@ -0,0 +1,16 @@
+import type { AgentMessageFile } from '../messages/AgentMessageFile';
+/**
+ * Local metadata rendered in the rich `ptbk agent run` dashboard.
+ */
+export type AgentRunUiMetadata = {
+    readonly localAgentName: string;
+    readonly latestUserMessageLines: readonly 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>;
+/**
+ * Extracts the latest `MESSAGE @User` block while preserving the original line breaks.
+ */
+export declare function extractLatestUserMessageLines(messageContent: string): readonly string[];

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

@@ -16,6 +16,7 @@ export type CoderRunPhase = 'initializing' | 'loading' | 'running' | 'verifying'
  */
 export type CoderRunConfig = {
     readonly agentName: string;
+    readonly localAgentName?: string;
     readonly modelName?: string;
     readonly thinkingLevel?: string;
     readonly context?: string;
@@ -42,6 +43,7 @@ export declare class CoderRunUiState extends EventEmitter {
     currentAttempt: number;
     maxAttempts: number;
     detailLines: string[];
+    messagePreviewLines: string[];
     pendingEnterLabel: string | undefined;
     agentOutputLines: string[];
     phase: CoderRunPhase;
@@ -95,6 +97,10 @@ export declare class CoderRunUiState extends EventEmitter {
      * Replaces the contextual detail lines shown beneath the current prompt status.
      */
     setDetailLines(detailLines: string[]): void;
+    /**
+     * Replaces the exact user-message preview lines shown in agent-specific panels.
+     */
+    setMessagePreviewLines(messagePreviewLines: string[]): void;
     /**
      * Sets or clears the Enter-key action label shown in the controls panel.
      */

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

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

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

@@ -0,0 +1,49 @@
+import type { CoderRunPauseState } from '../common/waitForPause';
+import type { CoderRunPhase } from './CoderRunUiState';
+/**
+ * Maximum number of output lines reserved for agent output in the UI.
+ */
+export declare const MAX_VISIBLE_OUTPUT_LINES = 8;
+/**
+ * Visible width reserved for aligned labels in the session box.
+ */
+export declare const SESSION_LABEL_WIDTH = 8;
+/**
+ * One structured row rendered inside the session box.
+ */
+export type SessionRow = {
+    readonly label: string;
+    readonly value: string;
+};
+/**
+ * Shared copy and colors derived from the current pause lifecycle state.
+ */
+export type PausePresentation = {
+    readonly badge: string;
+    readonly stateMessage: string;
+    readonly pauseControl: string;
+};
+/**
+ * Builds the fixed-height live output section so streaming updates do not keep resizing the frame.
+ */
+export declare function buildVisibleOutputLines(agentOutputLines: readonly string[]): readonly string[];
+/**
+ * Renders a framed box with a colored title and padded body lines.
+ */
+export declare function renderBox(title: string, lines: readonly string[], totalWidth: number, colorizeTitle: (text: string) => string): string[];
+/**
+ * Builds one aligned labeled line inside the session box.
+ */
+export declare function buildLabeledSessionLine(label: string, value: string, bodyWidth: number): string;
+/**
+ * Builds the colored phase badge shown in the session box.
+ */
+export declare function buildPausePresentation(phase: CoderRunPhase, pauseState: CoderRunPauseState, statusMessage: string): PausePresentation;
+/**
+ * Builds the progress bar shown in the session box.
+ */
+export declare function buildProgressBar(percentage: number, availableWidth: number, label: string): string;
+/**
+ * Builds the control pills shown in the footer box.
+ */
+export declare function buildControlPills(pauseControl: string, pendingEnterLabel: string | undefined): readonly string[];

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

@@ -1,4 +1,5 @@
 import moment from 'moment';
+import { type BuildCoderRunUiFrameOptions } from './buildCoderRunUiFrame';
 import { CoderRunUiState } from './CoderRunUiState';
 /**
  * Handle returned by `renderCoderRunUi` that exposes the state and lifecycle controls.
@@ -30,4 +31,6 @@ export type CoderRunUiHandle = {
  *
  * @private internal entry point of coder run UI
  */
-export declare function renderCoderRunUi(startTime: moment.Moment): CoderRunUiHandle;
+export declare function renderCoderRunUi(startTime: moment.Moment, options?: {
+    readonly buildFrameLines?: (options: BuildCoderRunUiFrameOptions) => string[];
+}): CoderRunUiHandle;

package/umd/src/avatars/types/AvatarVisualDefinition.d.ts

@@ -6,7 +6,7 @@ import type { AvatarDefinition } from './AvatarDefinition';
  *
  * @private shared contract for the avatar rendering system
  */
-export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'fractal' | 'orb';
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'octopus2' | 'octopus3' | 'ascii-octopus' | 'minecraft' | 'minecraft2' | 'fractal' | 'orb';
 /**
  * Derived color palette used by avatar visuals.
  *

package/umd/src/avatars/visuals/minecraft2AvatarVisual.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Minecraft 3D 2 avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+export declare const minecraft2AvatarVisual: AvatarVisualDefinition;

package/umd/src/avatars/visuals/minecraftAvatarVisualShared.d.ts

@@ -0,0 +1,48 @@
+import type { AvatarPalette } from '../types/AvatarVisualDefinition';
+/**
+ * One Minecraft-style pixel texture sampled on a cuboid face.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftTexture = ReadonlyArray<ReadonlyArray<string>>;
+/**
+ * Full six-face texture pack for one rendered cuboid.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export type MinecraftCuboidTextures = {
+    readonly front: MinecraftTexture;
+    readonly back: MinecraftTexture;
+    readonly left: MinecraftTexture;
+    readonly right: MinecraftTexture;
+    readonly top: MinecraftTexture;
+    readonly bottom: MinecraftTexture;
+};
+/**
+ * Shared subset of avatar colors used by the Minecraft avatar helpers.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+type MinecraftTexturePalette = Pick<AvatarPalette, 'primary' | 'secondary' | 'accent' | 'highlight' | 'ink' | 'shadow'>;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style head cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @param hasHeadband Whether the generated avatar should include a colored headband.
+ * @returns Head cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftHeadTextures(random: () => number, palette: MinecraftTexturePalette, hasHeadband: boolean): MinecraftCuboidTextures;
+/**
+ * Builds the seeded six-face texture pack used by the Minecraft-style torso cuboid.
+ *
+ * @param random Seeded random generator.
+ * @param palette Derived avatar palette.
+ * @returns Torso cuboid textures.
+ *
+ * @private helper of the Minecraft avatar visuals
+ */
+export declare function createMinecraftTorsoTextures(random: () => number, palette: MinecraftTexturePalette): MinecraftCuboidTextures;
+export {};

package/umd/src/cli/cli-commands/coder/ensureCoderGitignoreFile.d.ts

@@ -1,6 +1,6 @@
 import type { InitializationStatus } from './boilerplateTemplates';
 /**
- * Ensures `.gitignore` contains the standalone Promptbook coder temp and cache entries.
+ * Ensures `.gitignore` contains the shared Promptbook working-directory entry.
  *
  * @private function of `initializeCoderProjectConfiguration`
  */

package/umd/src/config.d.ts

@@ -270,7 +270,7 @@ export declare const DEFAULT_AGENTS_DIRNAME = "./agents";
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-cache";
+export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME: string;
 /**
  * Where to store the cache of executions for promptbook CLI
  *
@@ -278,7 +278,7 @@ export declare const DEFAULT_DOWNLOAD_CACHE_DIRNAME = "./.promptbook/download-ca
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-cache";
+export declare const DEFAULT_EXECUTION_CACHE_DIRNAME: string;
 /**
  * Where to store the scrape cache
  *
@@ -286,7 +286,7 @@ export declare const DEFAULT_EXECUTION_CACHE_DIRNAME = "./.promptbook/execution-
  *
  * @public exported from `@promptbook/core`
  */
-export declare const DEFAULT_SCRAPE_CACHE_DIRNAME = "./.promptbook/scrape-cache";
+export declare const DEFAULT_SCRAPE_CACHE_DIRNAME: string;
 /**
  * Id of application for the CLI when using remote server
  *

package/umd/src/utils/files/getPromptbookTempPath.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Builds one project-relative path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one absolute filesystem path inside the shared Promptbook working directory for a project root.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function resolvePromptbookTempPath(projectPath: string, ...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one POSIX path fragment inside the shared Promptbook working directory for globs and generated text files.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempPosixPath(...pathSegments: ReadonlyArray<string>): string;
+/**
+ * Builds one rooted `.gitignore` rule targeting a path inside the shared Promptbook working directory.
+ *
+ * @private internal utility for Promptbook-owned temp files
+ */
+export declare function getPromptbookTempGitignoreRule(...pathSegments: ReadonlyArray<string>): string;

package/umd/src/utils/files/getPromptbookTempPath.test.d.ts

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

package/umd/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-64`).
+ * It follows semantic versioning (e.g., `0.112.0-65`).
  *
  * @generated
  */