@promptbook/cli 0.112.0-132 → 0.112.0-134

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

@@ -19,5 +19,9 @@ export type CoderRunProgressSnapshot = {
 };
 /**
  * Builds a session-scoped progress snapshot from prompt stats and elapsed active time.
+ *
+ * When the current session has not finished any prompt yet but a `cachedAveragePromptDurationMs` is
+ * provided (loaded from the per-config estimate cache stored in the temp folder), the snapshot uses
+ * that historical average to project the remaining work instead of waiting for the first completion.
  */
-export declare function buildCoderRunProgressSnapshot(stats: PromptStats, elapsedDuration: moment.Duration, initialDone: number): CoderRunProgressSnapshot;
+export declare function buildCoderRunProgressSnapshot(stats: PromptStats, elapsedDuration: moment.Duration, initialDone: number, cachedAveragePromptDurationMs?: number): CoderRunProgressSnapshot;

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

@@ -15,10 +15,17 @@ export declare class CliProgressDisplay {
     private readonly timer;
     private isHeaderReserved;
     private interval;
+    private cachedAveragePromptDurationMs;
     /**
      * Creates a new display that uses the provided start time when computing estimates.
      */
     constructor(startTime: moment.Moment, minimumPriority: number);
+    /**
+     * Sets the cached average prompt duration (in milliseconds) loaded from the temp-folder estimate cache.
+     *
+     * Used to project completion estimates before the first prompt of the current session finishes.
+     */
+    setCachedAveragePromptDurationMs(cachedAveragePromptDurationMs: number | undefined): void;
     /**
      * Updates the progress statistics shown in the header.
      */

package/umd/scripts/run-codex-prompts/common/coderRunEstimateCache.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Cache key used to uniquely identify the average prompt duration for a given runner configuration.
+ *
+ * @private internal type of `coderRunEstimateCache`
+ */
+export type CoderRunEstimateCacheKey = {
+    readonly harness: string;
+    readonly model?: string;
+    readonly thinkingLevel?: string;
+};
+/**
+ * Loads the cached average prompt duration for the given runner configuration.
+ *
+ * Returns `undefined` when no usable cache entry exists. Cache failures must never break the run, so this
+ * function swallows IO and parsing errors instead of throwing.
+ *
+ * @public exported for use by the coder run progress displays
+ */
+export declare function loadCachedAveragePromptDurationMs(key: CoderRunEstimateCacheKey): Promise<number | undefined>;
+/**
+ * Records a new prompt-duration sample for the given runner configuration into the temp folder cache.
+ *
+ * Updates a running average so future `ptbk coder run` / `ptbk coder server` invocations can show
+ * meaningful estimates immediately, before the first prompt of the new session has completed.
+ *
+ * Cache failures are swallowed because the next-run estimate is best-effort and must not affect the
+ * current run.
+ *
+ * @public exported for use by the prompt round finalizer
+ */
+export declare function recordPromptDurationSample(key: CoderRunEstimateCacheKey, promptDurationMs: number): Promise<void>;

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

@@ -1,6 +1,8 @@
 import moment from 'moment';
 /**
  * Calendar formats used when displaying the estimated completion time.
+ *
+ * Uses 24-hour format (`HH:mm`) so estimates are unambiguous (for example `17:30` instead of `5:30`).
  */
 export declare const ESTIMATED_DONE_CALENDAR_FORMATS: {
     sameDay: string;

package/umd/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeRunner.d.ts

@@ -1,15 +1,17 @@
 import type { PromptRunOptions } from '../types/PromptRunOptions';
 import type { PromptRunResult } from '../types/PromptRunResult';
 import type { PromptRunner } from '../types/PromptRunner';
+import type { ClaudeCodeRunnerOptions } from './ClaudeCodeRunnerOptions';
 /**
  * Runs prompts via the Claude Code CLI.
  */
 export declare class ClaudeCodeRunner implements PromptRunner {
+    private readonly options;
     readonly name = "claude-code";
     /**
      * Creates a new Claude Code runner.
      */
-    constructor();
+    constructor(options?: ClaudeCodeRunnerOptions);
     /**
      * Runs the prompt using Claude Code and parses usage output.
      */

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

@@ -58,6 +58,7 @@ export declare class CoderRunUiState extends EventEmitter {
     private stats;
     private readonly timer;
     private initialDone;
+    private cachedAveragePromptDurationMs;
     constructor(startTime: moment.Moment);
     /**
      * Pauses the elapsed timer (e.g. while waiting for user input or paused state).
@@ -75,6 +76,12 @@ export declare class CoderRunUiState extends EventEmitter {
      * Feeds new prompt statistics from the main loop so the progress bar updates.
      */
     updateProgress(stats: PromptStats): void;
+    /**
+     * Sets the cached average prompt duration (in milliseconds) loaded from the temp-folder estimate cache.
+     *
+     * Used to project completion estimates before the first prompt of the current session finishes.
+     */
+    setCachedAveragePromptDurationMs(cachedAveragePromptDurationMs: number | undefined): void;
     /**
      * Computes a progress snapshot on demand so elapsed time ticks with periodic re-renders.
      */

package/umd/src/book-3.0/cliAgentEnv.d.ts

@@ -9,7 +9,7 @@ export declare const CLI_AGENT_HARNESS_NAMES: readonly ["openai-codex", "github-
  *
  * @public exported from `@promptbook/node`
  */
-export declare const CLI_AGENT_THINKING_LEVEL_VALUES: readonly ["low", "medium", "high", "xhigh"];
+export declare const CLI_AGENT_THINKING_LEVEL_VALUES: readonly ["low", "medium", "high", "xhigh", "max"];
 /**
  * Environment variable used as the default runner identifier when `--harness` is omitted or not set in `CliAgent`.
  *

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

@@ -3,7 +3,7 @@
  *
  * @private internal shared utility of `ptbk coder run`
  */
-export declare const THINKING_LEVEL_VALUES: readonly ["low", "medium", "high", "xhigh"];
+export declare const THINKING_LEVEL_VALUES: readonly ["low", "medium", "high", "xhigh", "max"];
 /**
  * Supported reasoning effort values for coding-agent runners with configurable thinking levels.
  *

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