@promptbook/cli 0.112.0-44 → 0.112.0-45

package/esm/scripts/run-codex-prompts/common/CoderRunTimer.d.ts

@@ -0,0 +1,31 @@
+import moment from 'moment';
+/**
+ * Tracks active coder-run time while excluding pauses and user-confirmation waits.
+ */
+export declare class CoderRunTimer {
+    private readonly startTime;
+    /**
+     * Total milliseconds spent in paused state across the run.
+     */
+    private pausedMs;
+    /**
+     * Timestamp when the timer was last paused, or `undefined` when active.
+     */
+    private pausedSince;
+    /**
+     * Creates a timer anchored at the provided start time.
+     */
+    constructor(startTime: moment.Moment, isPausedInitially?: boolean);
+    /**
+     * Pauses active-time tracking until `resume()` is called.
+     */
+    pause(): void;
+    /**
+     * Resumes active-time tracking after a pause.
+     */
+    resume(): void;
+    /**
+     * Returns the currently accumulated active duration.
+     */
+    getElapsedDuration(): moment.Duration;
+}

package/esm/scripts/run-codex-prompts/common/buildCoderRunProgressSnapshot.d.ts

@@ -0,0 +1,23 @@
+import moment from 'moment';
+import type { PromptStats } from '../prompts/types/PromptStats';
+/**
+ * Shared progress metrics used by both coder-run terminal UIs.
+ */
+export type CoderRunProgressSnapshot = {
+    readonly totalPrompts: number;
+    readonly sessionDone: number;
+    readonly sessionRemaining: number;
+    readonly sessionTotal: number;
+    readonly currentPromptIndex: number;
+    readonly skippedPrompts: number;
+    readonly toBeWrittenPrompts: number;
+    readonly percentage: number;
+    readonly elapsedText: string;
+    readonly estimatedTotalText: string;
+    readonly estimatedLabel: string;
+    readonly isEstimatedTotalKnown: boolean;
+};
+/**
+ * Builds a session-scoped progress snapshot from prompt stats and elapsed active time.
+ */
+export declare function buildCoderRunProgressSnapshot(stats: PromptStats, elapsedDuration: moment.Duration, initialDone: number): CoderRunProgressSnapshot;

package/esm/scripts/run-codex-prompts/common/cliProgressDisplay.d.ts

@@ -4,7 +4,7 @@ import type { PromptStats } from '../prompts/types/PromptStats';
  * Compact CLI progress display that stays pinned at the top of the terminal.
  */
 export declare class CliProgressDisplay {
-    private readonly startTime;
+    private readonly minimumPriority;
     private stats;
     /**
      * Initial number of completed prompts when the session started.
@@ -12,16 +12,25 @@ export declare class CliProgressDisplay {
      */
     private initialDone;
     private readonly isInteractive;
+    private readonly timer;
     private isHeaderReserved;
     private interval;
     /**
      * Creates a new display that uses the provided start time when computing estimates.
      */
-    constructor(startTime: moment.Moment);
+    constructor(startTime: moment.Moment, minimumPriority: number);
     /**
      * Updates the progress statistics shown in the header.
      */
     update(stats: PromptStats): void;
+    /**
+     * Pauses the active timer while the runner is waiting for user input.
+     */
+    pauseTimer(): void;
+    /**
+     * Resumes the active timer after a pause.
+     */
+    resumeTimer(): void;
     /**
      * Stops the automatic refresh cycle and renders the final header once more.
      */
@@ -35,7 +44,7 @@ export declare class CliProgressDisplay {
      */
     private reserveHeaderLine;
     /**
-     * Builds the coloured progress text padded to the terminal width.
+     * Builds the colored progress text padded to the terminal width.
      */
-    private buildProgressLine;
+    private buildProgressLines;
 }

package/esm/scripts/run-codex-prompts/common/progressFormatting.d.ts

@@ -0,0 +1,16 @@
+import moment from 'moment';
+/**
+ * Calendar formats used when displaying the estimated completion time.
+ */
+export declare const ESTIMATED_DONE_CALENDAR_FORMATS: {
+    sameDay: string;
+    nextDay: string;
+    nextWeek: string;
+    lastDay: string;
+    lastWeek: string;
+    sameElse: string;
+};
+/**
+ * Formats a duration into a compact string such as "3h 12m" or "45s".
+ */
+export declare function formatDurationBrief(duration: moment.Duration): string;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScript.d.ts

@@ -1,5 +1,5 @@
 import type { RunGoScriptOptions } from './RunGoScriptOptions';
 /**
- * Creates a temporary script file, runs it, and cleans it up immediately unless a round tracker defers that cleanup.
+ * Creates a temporary script file, runs it, and cleans it up unless preservation is requested or the run fails.
  */
 export declare function $runGoScript(options: RunGoScriptOptions): Promise<void>;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScriptUntilMarkerIdle.d.ts

@@ -1,6 +1,6 @@
 import type { RunGoScriptUntilMarkerIdleOptions } from './RunGoScriptUntilMarkerIdleOptions';
 /**
- * Creates a temporary script file, runs it, waits for a completion marker and idle time, and defers cleanup when a round tracker is provided.
+ * Creates a temporary script file, runs it, waits for a completion marker and idle time, and cleans it up unless preservation is requested or the run fails.
  * Returns the captured output for post-processing.
  */
 export declare function $runGoScriptUntilMarkerIdle(options: RunGoScriptUntilMarkerIdleOptions): Promise<string>;

package/esm/scripts/run-codex-prompts/common/runGoScript/$runGoScriptWithOutput.d.ts

@@ -1,5 +1,5 @@
 import type { RunGoScriptOptions } from './RunGoScriptOptions';
 /**
- * Creates a temporary script file, runs it, captures output, and cleans it up immediately unless a round tracker defers that cleanup.
+ * Creates a temporary script file, runs it, captures output, and cleans it up unless preservation is requested or the run fails.
  */
 export declare function $runGoScriptWithOutput(options: RunGoScriptOptions): Promise<string>;

package/esm/scripts/run-codex-prompts/common/runGoScript/shouldDeleteTemporaryArtifact.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Decides whether one temporary prompt artifact should be deleted after a round finishes.
+ */
+export declare function shouldDeleteTemporaryArtifact({ preserveArtifactsOnSuccess, hasFailed, }: {
+    preserveArtifactsOnSuccess?: boolean;
+    hasFailed: boolean;
+}): boolean;

package/esm/scripts/run-codex-prompts/common/runGoScript/withPromptRuntimeLog.d.ts

@@ -1,5 +1,6 @@
-import type { PromptRoundArtifacts } from './PromptRoundArtifacts';
 /**
- * Runs one prompt-processing round with a dedicated temporary runtime log file and optionally defers cleanup to the round tracker.
+ * Runs one prompt-processing round with a dedicated temporary runtime log file that is cleaned up only after successful non-preserved runs.
  */
-export declare function withPromptRuntimeLog<T>(scriptPath: string, handler: (logPath: string) => Promise<T>, promptRoundArtifacts?: PromptRoundArtifacts): Promise<T>;
+export declare function withPromptRuntimeLog<T>(scriptPath: string, handler: (logPath: string) => Promise<T>, options?: {
+    preserveArtifactsOnSuccess?: boolean;
+}): Promise<T>;

package/esm/scripts/run-codex-prompts/common/runGoScript/withTempScript.d.ts

@@ -1,5 +1,5 @@
 import type { RunGoScriptOptions } from './RunGoScriptOptions';
 /**
- * Creates a temporary script file, runs a handler, and either cleans it up immediately or defers cleanup to the round tracker.
+ * Creates a temporary script file, runs a handler, and cleans it up unless preservation is requested or the run fails.
  */
 export declare function withTempScript<T>(options: RunGoScriptOptions, handler: (scriptPath: string) => Promise<T>): Promise<T>;

package/esm/scripts/run-codex-prompts/testing/runPromptTestCommand.d.ts

@@ -6,6 +6,7 @@ type RunPromptTestCommandOptions = {
     projectPath: string;
     scriptPath: string;
     logPath?: string;
+    preserveArtifactsOnSuccess?: boolean;
 };
 /**
  * Runs the configured verification command inside the project root and returns its output.

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

@@ -1,13 +1,14 @@
 /// <reference types="node" />
 import { EventEmitter } from 'events';
 import moment from 'moment';
+import { type CoderRunProgressSnapshot } from '../common/buildCoderRunProgressSnapshot';
 import type { PromptStats } from '../prompts/types/PromptStats';
 /**
  * Execution phase of the coder run process.
  *
  * @private internal type of coder run UI
  */
-export type CoderRunPhase = 'initializing' | 'loading' | 'running' | 'verifying' | 'paused' | 'done' | 'error';
+export type CoderRunPhase = 'initializing' | 'loading' | 'running' | 'verifying' | 'waiting' | 'paused' | 'done' | 'error';
 /**
  * Configuration display data for the coder run UI header.
  *
@@ -22,19 +23,11 @@ export type CoderRunConfig = {
     readonly testCommand?: string;
 };
 /**
- * Computed progress snapshot for the coder run UI.
+ * Re-exported shared progress snapshot type used by the coder run UI.
  *
  * @private internal type of coder run UI
  */
-export type CoderRunProgressSnapshot = {
-    readonly totalPrompts: number;
-    readonly sessionDone: number;
-    readonly sessionTotal: number;
-    readonly percentage: number;
-    readonly elapsedText: string;
-    readonly estimatedTotalText: string;
-    readonly estimatedLabel: string;
-};
+export type { CoderRunProgressSnapshot };
 /**
  * Reactive state manager for the coder run terminal UI.
  *
@@ -48,21 +41,15 @@ export declare class CoderRunUiState extends EventEmitter {
     currentPromptLabel: string;
     currentAttempt: number;
     maxAttempts: number;
+    detailLines: string[];
+    pendingEnterLabel: string | undefined;
     agentOutputLines: string[];
     phase: CoderRunPhase;
     statusMessage: string;
     errors: string[];
     private stats;
-    private readonly startTime;
+    private readonly timer;
     private initialDone;
-    /**
-     * Total milliseconds the timer was paused/waiting (excluded from elapsed display).
-     */
-    private pausedMs;
-    /**
-     * Timestamp when the timer was last paused, or `undefined` when running.
-     */
-    private pausedSince;
     constructor(startTime: moment.Moment);
     /**
      * Pauses the elapsed timer (e.g. while waiting for user input or paused state).
@@ -104,6 +91,14 @@ export declare class CoderRunUiState extends EventEmitter {
      * Updates the status message line beneath the current prompt label.
      */
     setStatusMessage(message: string): void;
+    /**
+     * Replaces the contextual detail lines shown beneath the current prompt status.
+     */
+    setDetailLines(detailLines: string[]): void;
+    /**
+     * Sets or clears the Enter-key action label shown in the controls panel.
+     */
+    setPendingEnterLabel(pendingEnterLabel: string | undefined): void;
     /**
      * Appends an error message to the error list shown in the UI.
      */

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

@@ -0,0 +1,28 @@
+import type { CoderRunConfig, CoderRunPhase, CoderRunProgressSnapshot } from './CoderRunUiState';
+/**
+ * Shared pause-state shape between the renderer and the frame builder.
+ */
+export type CoderRunPauseState = 'RUNNING' | 'PAUSING' | 'PAUSED';
+/**
+ * Snapshot consumed by the pure coder-run frame builder.
+ */
+export type BuildCoderRunUiFrameOptions = {
+    readonly terminalWidth: number;
+    readonly spinner: string;
+    readonly pauseState: CoderRunPauseState;
+    readonly config: CoderRunConfig;
+    readonly phase: CoderRunPhase;
+    readonly currentPromptLabel: string;
+    readonly currentAttempt: number;
+    readonly maxAttempts: number;
+    readonly statusMessage: string;
+    readonly detailLines: readonly string[];
+    readonly pendingEnterLabel?: string;
+    readonly agentOutputLines: readonly string[];
+    readonly errors: readonly string[];
+    readonly progress: CoderRunProgressSnapshot;
+};
+/**
+ * Builds the complete boxed terminal frame for the rich `ptbk coder run` UI.
+ */
+export declare function buildCoderRunUiFrame(options: BuildCoderRunUiFrameOptions): string[];

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

@@ -12,6 +12,8 @@ export type CoderRunUiHandle = {
     startCapturingAgentOutput(): void;
     /** Disables console interception so normal logging resumes. */
     stopCapturingAgentOutput(): void;
+    /** Waits for Enter without leaving the rich terminal UI. */
+    waitForEnter(actionLabel: string): Promise<void>;
     /** Tears down the UI and restores original console methods. */
     cleanup(): void;
 };

package/esm/src/avatars/Avatar.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarProps } from './types/AvatarVisualDefinition';
+/**
+ * Canvas-based deterministic avatar component.
+ *
+ * @private shared component for in-repository avatar previews
+ */
+export declare function Avatar(props: AvatarProps): import("react/jsx-runtime").JSX.Element;

package/esm/src/avatars/avatarRenderingUtils.d.ts

@@ -0,0 +1,117 @@
+import type { AgentBasicInformation } from '../book-2.0/agent-source/AgentBasicInformation';
+import type { string_color } from '../types/typeAliases';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarPalette } from './types/AvatarVisualDefinition';
+/**
+ * Default square size used by avatar renderers.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare const DEFAULT_AVATAR_SIZE = 192;
+/**
+ * Normalizes arbitrary agent colors into a stable non-empty color list.
+ *
+ * @param colors Raw color list.
+ * @returns Stable list of usable colors.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function normalizeAvatarColors(colors: ReadonlyArray<string_color>): ReadonlyArray<string_color>;
+/**
+ * Normalizes the avatar input so visuals can rely on consistent data.
+ *
+ * @param avatarDefinition Raw avatar input.
+ * @returns Normalized avatar definition.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function normalizeAvatarDefinition(avatarDefinition: AvatarDefinition): AvatarDefinition;
+/**
+ * Extracts avatar colors from the flexible `META COLOR` agent field.
+ *
+ * @param colorValue Raw `META COLOR` value.
+ * @returns Parsed avatar colors.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function parseAvatarColors(colorValue: string | undefined): ReadonlyArray<string_color>;
+/**
+ * Creates a reusable avatar definition from parsed agent information.
+ *
+ * @param agentBasicInformation Parsed agent information.
+ * @returns Avatar definition ready for canvas rendering.
+ *
+ * @private shared helper for app-level avatar previews
+ */
+export declare function createAvatarDefinitionFromAgentBasicInformation(agentBasicInformation: Pick<AgentBasicInformation, 'agentName' | 'agentHash' | 'meta'>): AvatarDefinition;
+/**
+ * Creates the shared derived palette used by every avatar visual.
+ *
+ * @param avatarDefinition Stable avatar definition.
+ * @returns Derived palette.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function createAvatarPalette(avatarDefinition: AvatarDefinition): AvatarPalette;
+/**
+ * Draws the common rounded background frame used by most visuals.
+ *
+ * @param context Canvas 2D context.
+ * @param size Canvas size in CSS pixels.
+ * @param palette Derived avatar palette.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function drawAvatarFrame(context: CanvasRenderingContext2D, size: number, palette: AvatarPalette): void;
+/**
+ * Creates a rounded rectangle path on the current canvas context.
+ *
+ * @param context Canvas 2D context.
+ * @param x Left coordinate.
+ * @param y Top coordinate.
+ * @param width Rectangle width.
+ * @param height Rectangle height.
+ * @param radius Corner radius.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function createRoundedRectPath(context: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number): void;
+/**
+ * Creates a stable pseudo-random number generator from a string seed.
+ *
+ * @param seedSource String seed.
+ * @returns Generator producing values in `[0, 1)`.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function createSeededRandom(seedSource: string): () => number;
+/**
+ * Creates a deterministic random factory scoped to the avatar definition.
+ *
+ * @param avatarDefinition Stable avatar definition.
+ * @returns Random factory that can be re-seeded per visual part.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function createAvatarRandomFactory(avatarDefinition: AvatarDefinition): (salt: string) => () => number;
+/**
+ * Clears and scales the canvas for crisp avatar rendering on high DPI displays.
+ *
+ * @param canvas Canvas element to prepare.
+ * @param context Canvas 2D context.
+ * @param size Canvas size in CSS pixels.
+ * @param devicePixelRatio Device pixel ratio.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function prepareAvatarCanvas(canvas: HTMLCanvasElement, context: CanvasRenderingContext2D, size: number, devicePixelRatio: number): void;
+/**
+ * Picks one deterministic element from a non-empty collection.
+ *
+ * @param items Candidate items.
+ * @param random Seeded random generator.
+ * @returns Picked item.
+ *
+ * @private utility of the avatar rendering system
+ */
+export declare function pickRandomItem<T>(items: ReadonlyArray<T>, random: () => number): T;

package/esm/src/avatars/index.d.ts

@@ -0,0 +1,6 @@
+export { Avatar } from './Avatar';
+export { renderAvatarVisual } from './renderAvatarVisual';
+export { createAvatarDefinitionFromAgentBasicInformation } from './avatarRenderingUtils';
+export { AVATAR_VISUALS, getAvatarVisualById } from './visuals/avatarVisualRegistry';
+export type { AvatarDefinition } from './types/AvatarDefinition';
+export type { AvatarPalette, AvatarProps, AvatarVisual, AvatarVisualDefinition, AvatarVisualId, AvatarVisualRenderContext, RenderAvatarVisualOptions, } from './types/AvatarVisualDefinition';

package/esm/src/avatars/renderAvatarVisual.d.ts

@@ -0,0 +1,9 @@
+import type { RenderAvatarVisualOptions } from './types/AvatarVisualDefinition';
+/**
+ * Renders one deterministic avatar frame into the provided canvas.
+ *
+ * @param options Rendering options.
+ *
+ * @private shared helper for canvas avatar rendering
+ */
+export declare function renderAvatarVisual(options: RenderAvatarVisualOptions): void;

package/esm/src/avatars/types/AvatarDefinition.d.ts

@@ -0,0 +1,20 @@
+import type { string_agent_hash, string_agent_name, string_color } from '../../types/typeAliases';
+/**
+ * Normalized identity payload used by all canvas avatar visuals.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarDefinition = {
+    /**
+     * Human-readable name of the agent.
+     */
+    readonly agentName: string_agent_name;
+    /**
+     * Stable hash of the agent.
+     */
+    readonly agentHash: string_agent_hash;
+    /**
+     * Ordered list of agent colors used to derive a palette.
+     */
+    readonly colors: ReadonlyArray<string_color>;
+};

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

@@ -0,0 +1,96 @@
+import type { string_color, string_css_class } from '../../types/typeAliases';
+import type { AvatarDefinition } from './AvatarDefinition';
+/**
+ * Supported built-in avatar visual identifiers.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualId = 'pixel-art' | 'octopus' | 'minecraft';
+/**
+ * Derived color palette used by avatar visuals.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarPalette = {
+    readonly background: string_color;
+    readonly backgroundSecondary: string_color;
+    readonly primary: string_color;
+    readonly secondary: string_color;
+    readonly accent: string_color;
+    readonly highlight: string_color;
+    readonly shadow: string_color;
+    readonly ink: string_color;
+};
+/**
+ * Rendering context forwarded to a single avatar visual.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualRenderContext = {
+    readonly canvas: HTMLCanvasElement;
+    readonly context: CanvasRenderingContext2D;
+    readonly size: number;
+    readonly devicePixelRatio: number;
+    readonly timeMs: number;
+    readonly avatarDefinition: AvatarDefinition;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+};
+/**
+ * Signature of one canvas-based avatar visual renderer.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisual = (context: AvatarVisualRenderContext) => void;
+/**
+ * Metadata and renderer for one built-in avatar visual.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualDefinition = {
+    readonly id: AvatarVisualId;
+    readonly title: string;
+    readonly description: string;
+    readonly isAnimated: boolean;
+    readonly render: AvatarVisual;
+};
+/**
+ * Props of the shared `<Avatar/>` component.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarProps = {
+    /**
+     * Stable visual identity for the rendered avatar.
+     */
+    readonly avatarDefinition: AvatarDefinition;
+    /**
+     * Selected visual style.
+     */
+    readonly visualId: AvatarVisualId;
+    /**
+     * Output size in CSS pixels.
+     */
+    readonly size?: number;
+    /**
+     * Optional canvas title.
+     */
+    readonly title?: string;
+    /**
+     * Optional CSS class name applied to the canvas.
+     */
+    readonly className?: string_css_class;
+};
+/**
+ * Low-level rendering options for a single canvas frame.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type RenderAvatarVisualOptions = {
+    readonly canvas: HTMLCanvasElement;
+    readonly avatarDefinition: AvatarDefinition;
+    readonly visualId: AvatarVisualId;
+    readonly size: number;
+    readonly timeMs: number;
+    readonly devicePixelRatio?: number;
+};

package/esm/src/avatars/visuals/avatarVisualRegistry.d.ts

@@ -0,0 +1,16 @@
+import type { AvatarVisualDefinition, AvatarVisualId } from '../types/AvatarVisualDefinition';
+/**
+ * Built-in avatar visuals available to the app.
+ *
+ * @private shared registry for the avatar rendering system
+ */
+export declare const AVATAR_VISUALS: ReadonlyArray<AvatarVisualDefinition>;
+/**
+ * Returns one avatar visual by its identifier.
+ *
+ * @param visualId Requested visual identifier.
+ * @returns Matching visual definition.
+ *
+ * @private shared registry for the avatar rendering system
+ */
+export declare function getAvatarVisualById(visualId: AvatarVisualId): AvatarVisualDefinition;

package/esm/src/avatars/visuals/minecraftAvatarVisual.d.ts

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

package/esm/src/avatars/visuals/octopusAvatarVisual.d.ts

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

package/esm/src/avatars/visuals/pixelArtAvatarVisual.d.ts

@@ -0,0 +1,7 @@
+import type { AvatarVisualDefinition } from '../types/AvatarVisualDefinition';
+/**
+ * Pixel-art avatar visual.
+ *
+ * @private built-in avatar visual
+ */
+export declare const pixelArtAvatarVisual: AvatarVisualDefinition;

package/esm/src/commitments/STYLE/STYLE.d.ts

@@ -3,8 +3,8 @@ import { BaseCommitmentDefinition } from '../_base/BaseCommitmentDefinition';
 /**
  * STYLE commitment definition
  *
- * The STYLE commitment defines how the agent should format and present its responses.
- * This includes tone, writing style, formatting preferences, and communication patterns.
+ * Deprecated legacy writing-style commitment kept for backward compatibility.
+ * New books should prefer `WRITING RULES` for writing-only constraints.
  *
  * Example usage in agent source:
  *
@@ -21,6 +21,13 @@ export declare class StyleCommitmentDefinition extends BaseCommitmentDefinition<
      * Short one-line description of STYLE.
      */
     get description(): string;
+    /**
+     * Optional UI/docs-only deprecation metadata.
+     */
+    get deprecation(): {
+        readonly message: "Use `WRITING RULES` for writing-only constraints such as tone, length, formatting, or emoji usage.";
+        readonly replacedBy: readonly ["WRITING RULES"];
+    };
     /**
      * Icon for this commitment.
      */

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-44",
+    "version": "0.112.0-45",
     "description": "Promptbook: Turn your company's scattered knowledge into AI ready books",
     "private": false,
     "sideEffects": false,