@promptbook/cli 0.112.0-132 → 0.112.0-134

package/src/version.ts

@@ -16,11 +16,11 @@ export const BOOK_LANGUAGE_VERSION: string_semantic_version = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-132';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-134';
 
 /**
  * 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
  */

package/src/versions.txt

@@ -1159,3 +1159,5 @@
 0.112.0-128
 0.112.0-131
 0.112.0-132
+0.112.0-133
+0.112.0-134

package/umd/index.umd.js

@@ -1,8 +1,8 @@
 (function (global, factory) {
-    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('fs/promises'), require('path'), require('child_process'), require('crypto'), require('fs'), require('dotenv'), require('moment'), require('waitasecond'), require('prompts'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('socket.io-client'), require('jszip'), require('@mozilla/readability'), require('jsdom'), require('crypto-js'), require('showdown'), require('glob-promise'), require('http'), require('express'), require('socket.io'), require('express-openapi-validator'), require('swagger-ui-express'), require('react'), require('react-dom/server'), require('@anthropic-ai/sdk'), require('bottleneck'), require('@azure/openai'), require('rxjs'), require('@openai/agents'), require('openai'), require('typescript'), require('ignore'), require('readline'), require('events'), require('mime-types'), require('papaparse'), require('url'), require('pg'), require('@supabase/supabase-js')) :
-    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'fs/promises', 'path', 'child_process', 'crypto', 'fs', 'dotenv', 'moment', 'waitasecond', 'prompts', 'crypto-js/enc-hex', 'crypto-js/sha256', 'socket.io-client', 'jszip', '@mozilla/readability', 'jsdom', 'crypto-js', 'showdown', 'glob-promise', 'http', 'express', 'socket.io', 'express-openapi-validator', 'swagger-ui-express', 'react', 'react-dom/server', '@anthropic-ai/sdk', 'bottleneck', '@azure/openai', 'rxjs', '@openai/agents', 'openai', 'typescript', 'ignore', 'readline', 'events', 'mime-types', 'papaparse', 'url', 'pg', '@supabase/supabase-js'], factory) :
-    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global._spaceTrim, global.promises, global.path, global.child_process, global.crypto, global.fs, global.dotenv, global.moment, global.waitasecond, global.prompts, global.hexEncoder, global.sha256, global.socket_ioClient, global.JSZip, global.readability, global.jsdom, global.CryptoJS, global.showdown, global.glob, global.http, global.express, global.socket_io, global.OpenApiValidator, global.swaggerUi, global.react, global.server, global.Anthropic, global.Bottleneck, global.openai, global.rxjs, global.agents, global.OpenAI, global.ts, global.ignore, global.readline, global.events, global.mimeTypes, global.papaparse, global.url, global.pg));
-})(this, (function (exports, colors, commander, _spaceTrim, promises, path, child_process, crypto, fs, dotenv, moment, waitasecond, prompts, hexEncoder, sha256, socket_ioClient, JSZip, readability, jsdom, CryptoJS, showdown, glob, http, express, socket_io, OpenApiValidator, swaggerUi, react, server, Anthropic, Bottleneck, openai, rxjs, agents, OpenAI, ts, ignore, readline, events, mimeTypes, papaparse, url, pg) { 'use strict';
+    typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports, require('colors'), require('commander'), require('spacetrim'), require('fs/promises'), require('path'), require('child_process'), require('crypto'), require('fs'), require('dotenv'), require('moment'), require('waitasecond'), require('prompts'), require('crypto-js/enc-hex'), require('crypto-js/sha256'), require('socket.io-client'), require('jszip'), require('@mozilla/readability'), require('jsdom'), require('crypto-js'), require('showdown'), require('glob-promise'), require('http'), require('express'), require('socket.io'), require('express-openapi-validator'), require('swagger-ui-express'), require('react'), require('react-dom/server'), require('@anthropic-ai/sdk'), require('bottleneck'), require('@azure/openai'), require('rxjs'), require('@openai/agents'), require('openai'), require('typescript'), require('ignore'), require('readline'), require('events'), require('os'), require('mime-types'), require('papaparse'), require('url'), require('pg'), require('@supabase/supabase-js')) :
+    typeof define === 'function' && define.amd ? define(['exports', 'colors', 'commander', 'spacetrim', 'fs/promises', 'path', 'child_process', 'crypto', 'fs', 'dotenv', 'moment', 'waitasecond', 'prompts', 'crypto-js/enc-hex', 'crypto-js/sha256', 'socket.io-client', 'jszip', '@mozilla/readability', 'jsdom', 'crypto-js', 'showdown', 'glob-promise', 'http', 'express', 'socket.io', 'express-openapi-validator', 'swagger-ui-express', 'react', 'react-dom/server', '@anthropic-ai/sdk', 'bottleneck', '@azure/openai', 'rxjs', '@openai/agents', 'openai', 'typescript', 'ignore', 'readline', 'events', 'os', 'mime-types', 'papaparse', 'url', 'pg', '@supabase/supabase-js'], factory) :
+    (global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["promptbook-cli"] = {}, global.colors, global.commander, global._spaceTrim, global.promises, global.path, global.child_process, global.crypto, global.fs, global.dotenv, global.moment, global.waitasecond, global.prompts, global.hexEncoder, global.sha256, global.socket_ioClient, global.JSZip, global.readability, global.jsdom, global.CryptoJS, global.showdown, global.glob, global.http, global.express, global.socket_io, global.OpenApiValidator, global.swaggerUi, global.react, global.server, global.Anthropic, global.Bottleneck, global.openai, global.rxjs, global.agents, global.OpenAI, global.ts, global.ignore, global.readline, global.events, global.os, global.mimeTypes, global.papaparse, global.url, global.pg));
+})(this, (function (exports, colors, commander, _spaceTrim, promises, path, child_process, crypto, fs, dotenv, moment, waitasecond, prompts, hexEncoder, sha256, socket_ioClient, JSZip, readability, jsdom, CryptoJS, showdown, glob, http, express, socket_io, OpenApiValidator, swaggerUi, react, server, Anthropic, Bottleneck, openai, rxjs, agents, OpenAI, ts, ignore, readline, events, os, mimeTypes, papaparse, url, pg) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -63,7 +63,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-132';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-134';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1723,28 +1723,6 @@
     // TODO: [🗽] Unite branding and make single place for it
     // Note: [💞] Ignore a discrepancy between file name and entity name
 
-    /**
-     * Supported thinking-level CLI values for coding-agent runners with configurable reasoning effort.
-     *
-     * @private internal shared utility of `ptbk coder run`
-     */
-    const THINKING_LEVEL_VALUES = ['low', 'medium', 'high', 'xhigh'];
-    /**
-     * Parses and validates an optional thinking-level option value.
-     *
-     * @private internal shared utility of `ptbk coder run`
-     */
-    function parseThinkingLevel(thinkingLevelValue) {
-        if (thinkingLevelValue === undefined) {
-            return undefined;
-        }
-        if (THINKING_LEVEL_VALUES.includes(thinkingLevelValue)) {
-            return thinkingLevelValue;
-        }
-        throw new Error(`Invalid thinking level "${thinkingLevelValue}". Use one of: ${THINKING_LEVEL_VALUES.join(', ')}.`);
-    }
-    // Note: [🟡] Code for CLI command [run](src/cli/cli-commands/coder/run.ts) should never be published outside of `@promptbook/cli`
-
     // Note: [💞] Ignore a discrepancy between file name and entity name
     /**
      * All CLI harness names supported by `CliAgent` and `ptbk agent exec`.
@@ -1759,6 +1737,12 @@
         'opencode',
         'gemini',
     ];
+    /**
+     * All supported thinking-level values for CLI coding-agent runners.
+     *
+     * @public exported from `@promptbook/node`
+     */
+    const CLI_AGENT_THINKING_LEVEL_VALUES = ['low', 'medium', 'high', 'xhigh', 'max'];
     /**
      * Environment variable used as the default runner identifier when `--harness` is omitted or not set in `CliAgent`.
      *
@@ -1781,6 +1765,28 @@
      */
     const PTBK_THINKING_LEVEL_ENV = 'PTBK_THINKING_LEVEL';
 
+    /**
+     * Supported thinking-level CLI values for coding-agent runners with configurable reasoning effort.
+     *
+     * @private internal shared utility of `ptbk coder run`
+     */
+    const THINKING_LEVEL_VALUES = CLI_AGENT_THINKING_LEVEL_VALUES;
+    /**
+     * Parses and validates an optional thinking-level option value.
+     *
+     * @private internal shared utility of `ptbk coder run`
+     */
+    function parseThinkingLevel(thinkingLevelValue) {
+        if (thinkingLevelValue === undefined) {
+            return undefined;
+        }
+        if (THINKING_LEVEL_VALUES.includes(thinkingLevelValue)) {
+            return thinkingLevelValue;
+        }
+        throw new Error(`Invalid thinking level "${thinkingLevelValue}". Use one of: ${THINKING_LEVEL_VALUES.join(', ')}.`);
+    }
+    // Note: [🟡] Code for CLI command [run](src/cli/cli-commands/coder/run.ts) should never be published outside of `@promptbook/cli`
+
     /**
      * Runner identifiers supported by Promptbook CLI agent orchestration commands.
      *
@@ -4566,14 +4572,16 @@
 
     /**
      * 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`).
      */
     const ESTIMATED_DONE_CALENDAR_FORMATS = {
-        sameDay: '[Today] h:mm',
-        nextDay: '[Tomorrow] h:mm',
-        nextWeek: 'dddd h:mm',
-        lastDay: '[Yesterday] h:mm',
-        lastWeek: 'dddd h:mm',
-        sameElse: 'MMM D h:mm',
+        sameDay: '[Today] HH:mm',
+        nextDay: '[Tomorrow] HH:mm',
+        nextWeek: 'dddd HH:mm',
+        lastDay: '[Yesterday] HH:mm',
+        lastWeek: 'dddd HH:mm',
+        sameElse: 'MMM D HH:mm',
     };
     /**
      * Formats a duration into a compact string such as "3h 12m" or "45s".
@@ -4601,8 +4609,12 @@
 
     /**
      * 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.
      */
-    function buildCoderRunProgressSnapshot(stats, elapsedDuration, initialDone) {
+    function buildCoderRunProgressSnapshot(stats, elapsedDuration, initialDone, cachedAveragePromptDurationMs) {
         const totalPrompts = stats.done + stats.forAgent + stats.toBeWritten;
         const sessionDone = Math.max(0, stats.done - initialDone);
         const sessionRemaining = stats.forAgent;
@@ -4610,12 +4622,22 @@
         const currentPromptIndex = sessionTotal > 0 ? Math.min(sessionDone + 1, sessionTotal) : 0;
         const percentage = sessionTotal > 0 ? Math.round((sessionDone / sessionTotal) * 100) : 0;
         const elapsedText = formatDurationBrief(elapsedDuration);
+        const elapsedMs = elapsedDuration.asMilliseconds();
         let estimatedTotalText = 'estimating...';
         let estimatedLabel = 'after first completion';
         let isEstimatedTotalKnown = false;
+        let estimatedTotalMs;
         if (sessionTotal > 0 && sessionDone > 0) {
-            const estimatedTotalMs = (elapsedDuration.asMilliseconds() * sessionTotal) / sessionDone;
-            const estimatedRemainingMs = Math.max(0, estimatedTotalMs - elapsedDuration.asMilliseconds());
+            estimatedTotalMs = (elapsedMs * sessionTotal) / sessionDone;
+        }
+        else if (sessionTotal > 0 &&
+            cachedAveragePromptDurationMs !== undefined &&
+            cachedAveragePromptDurationMs > 0) {
+            const projectedRemainingMs = sessionRemaining * cachedAveragePromptDurationMs;
+            estimatedTotalMs = elapsedMs + projectedRemainingMs;
+        }
+        if (estimatedTotalMs !== undefined) {
+            const estimatedRemainingMs = Math.max(0, estimatedTotalMs - elapsedMs);
             const estimatedTotalDuration = moment__default["default"].duration(estimatedTotalMs);
             const estimatedCompletion = moment__default["default"]().add(estimatedRemainingMs, 'milliseconds');
             estimatedTotalText = formatDurationBrief(estimatedTotalDuration);
@@ -4749,12 +4771,21 @@
             this.stats = stats;
             this.emitChange();
         }
+        /**
+         * 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) {
+            this.cachedAveragePromptDurationMs = cachedAveragePromptDurationMs;
+            this.emitChange();
+        }
         /**
          * Computes a progress snapshot on demand so elapsed time ticks with periodic re-renders.
          */
         getProgress() {
             var _a;
-            return buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done);
+            return buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done, this.cachedAveragePromptDurationMs);
         }
         /**
          * Sets the label of the prompt currently being processed and resets per-prompt state.
@@ -27461,17 +27492,21 @@
         });
     }
 
+    /**
+     * Base delimiter used for passing large prompts through stdin.
+     */
+    const CLAUDE_PROMPT_DELIMITER = 'CLAUDE_PROMPT';
     /**
      * Builds the shell script that runs Claude Code with the prompt and coding context.
      */
     function buildClaudeScript(options) {
-        const delimiter = 'CLAUDE_PROMPT';
+        const THINKING_LEVEL_ARGUMENT = options.thinkingLevel ? ` --effort ${options.thinkingLevel}` : '';
         return spaceTrim((block) => `
-            claude --allowedTools "Bash,Read,Edit,Write" --output-format json --print <<'${delimiter}'
+            claude --allowedTools "Bash,Read,Edit,Write"${THINKING_LEVEL_ARGUMENT} --output-format json --print <<'${CLAUDE_PROMPT_DELIMITER}'
 
             ${block(options.prompt)}
 
-            ${delimiter}
+            ${CLAUDE_PROMPT_DELIMITER}
         `);
     }
 
@@ -27607,7 +27642,8 @@
         /**
          * Creates a new Claude Code runner.
          */
-        constructor() {
+        constructor(options = {}) {
+            this.options = options;
             this.name = 'claude-code';
         }
         /**
@@ -27616,6 +27652,7 @@
         async runPrompt(options) {
             const scriptContent = buildClaudeScript({
                 prompt: options.prompt,
+                thinkingLevel: this.options.thinkingLevel,
             });
             const output = await $runGoScriptWithOutput({
                 scriptPath: options.scriptPath,
@@ -28788,7 +28825,9 @@
             }), actualRunnerModel);
         }
         if (agentName === 'claude-code') {
-            return createRunnerResolution(options, new ClaudeCodeRunner());
+            return createRunnerResolution(options, new ClaudeCodeRunner({
+                thinkingLevel: options.thinkingLevel,
+            }));
         }
         if (agentName === 'opencode') {
             return createRunnerResolution(options, new OpencodeRunner({
@@ -37862,7 +37901,7 @@
      *
      * @private internal constant of `ptbk agents-server`
      */
-    const USER_CHAT_JOB_WORKER_POLL_INTERVAL_MS = 2000;
+    const USER_CHAT_JOB_WORKER_POLL_INTERVAL_MS = 10000;
     /**
      * Number of identical worker failures suppressed before logging a repeated summary.
      *
@@ -69687,6 +69726,15 @@
             this.render();
             this.interval = setInterval(() => this.render(), PROGRESS_REFRESH_INTERVAL_MS);
         }
+        /**
+         * 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) {
+            this.cachedAveragePromptDurationMs = cachedAveragePromptDurationMs;
+            this.render();
+        }
         /**
          * Updates the progress statistics shown in the header.
          */
@@ -69757,7 +69805,7 @@
          */
         buildProgressLines() {
             var _a, _b;
-            const snapshot = buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done);
+            const snapshot = buildCoderRunProgressSnapshot(this.stats, this.timer.getElapsedDuration(), (_a = this.initialDone) !== null && _a !== void 0 ? _a : this.stats.done, this.cachedAveragePromptDurationMs);
             const columns = Math.max(40, (_b = process.stdout.columns) !== null && _b !== void 0 ? _b : 80);
             const workingLine = snapshot.sessionTotal > 0
                 ? [
@@ -69815,6 +69863,118 @@
         return `${count} prompt${count === 1 ? '' : 's'}`;
     }
 
+    /**
+     * Sub-directory of the OS temp folder where per-config estimate caches are stored.
+     *
+     * @private internal constant of `coderRunEstimateCache`
+     */
+    const ESTIMATE_CACHE_DIRECTORY_NAME = 'ptbk-coder-estimates';
+    /**
+     * Absolute path to the directory where estimate caches are persisted.
+     *
+     * @private internal utility of `coderRunEstimateCache`
+     */
+    function getEstimateCacheDirectory() {
+        return path.join(os.tmpdir(), ESTIMATE_CACHE_DIRECTORY_NAME);
+    }
+    /**
+     * Sanitizes a single identifier component so that it is safe to use as a filename segment.
+     *
+     * @private internal utility of `coderRunEstimateCache`
+     */
+    function sanitizeFileNameSegment(value) {
+        return value.replace(/[^a-zA-Z0-9._-]/g, '_');
+    }
+    /**
+     * Builds the cache filename for a given runner configuration.
+     *
+     * @private internal utility of `coderRunEstimateCache`
+     */
+    function buildEstimateCacheFileName(key) {
+        var _a, _b;
+        const harnessSegment = sanitizeFileNameSegment(key.harness);
+        const modelSegment = sanitizeFileNameSegment((_a = key.model) !== null && _a !== void 0 ? _a : 'default');
+        const thinkingLevelSegment = sanitizeFileNameSegment((_b = key.thinkingLevel) !== null && _b !== void 0 ? _b : 'default');
+        return `${harnessSegment}__${modelSegment}__${thinkingLevelSegment}.json`;
+    }
+    /**
+     * Reads the previously persisted cache entry for a configuration if available.
+     *
+     * @private internal utility of `coderRunEstimateCache`
+     */
+    async function readEstimateCacheEntry(filePath) {
+        try {
+            const content = await fs.promises.readFile(filePath, 'utf-8');
+            const parsed = JSON.parse(content);
+            if (typeof parsed.averagePromptDurationMs !== 'number' ||
+                !Number.isFinite(parsed.averagePromptDurationMs) ||
+                parsed.averagePromptDurationMs <= 0 ||
+                typeof parsed.sampleCount !== 'number' ||
+                !Number.isFinite(parsed.sampleCount) ||
+                parsed.sampleCount <= 0) {
+                return undefined;
+            }
+            return {
+                averagePromptDurationMs: parsed.averagePromptDurationMs,
+                sampleCount: parsed.sampleCount,
+                updatedAt: typeof parsed.updatedAt === 'string' ? parsed.updatedAt : new Date().toISOString(),
+            };
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    /**
+     * 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
+     */
+    async function loadCachedAveragePromptDurationMs(key) {
+        const filePath = path.join(getEstimateCacheDirectory(), buildEstimateCacheFileName(key));
+        const entry = await readEstimateCacheEntry(filePath);
+        return entry === null || entry === void 0 ? void 0 : entry.averagePromptDurationMs;
+    }
+    /**
+     * 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
+     */
+    async function recordPromptDurationSample(key, promptDurationMs) {
+        var _a, _b;
+        if (!Number.isFinite(promptDurationMs) || promptDurationMs <= 0) {
+            return;
+        }
+        try {
+            const cacheDirectory = getEstimateCacheDirectory();
+            await fs.promises.mkdir(cacheDirectory, { recursive: true });
+            const filePath = path.join(cacheDirectory, buildEstimateCacheFileName(key));
+            const previousEntry = await readEstimateCacheEntry(filePath);
+            const previousSampleCount = (_a = previousEntry === null || previousEntry === void 0 ? void 0 : previousEntry.sampleCount) !== null && _a !== void 0 ? _a : 0;
+            const previousTotalMs = ((_b = previousEntry === null || previousEntry === void 0 ? void 0 : previousEntry.averagePromptDurationMs) !== null && _b !== void 0 ? _b : 0) * previousSampleCount;
+            const nextSampleCount = previousSampleCount + 1;
+            const nextAveragePromptDurationMs = (previousTotalMs + promptDurationMs) / nextSampleCount;
+            const nextEntry = {
+                averagePromptDurationMs: nextAveragePromptDurationMs,
+                sampleCount: nextSampleCount,
+                updatedAt: new Date().toISOString(),
+            };
+            await fs.promises.writeFile(filePath, JSON.stringify(nextEntry, null, 4), 'utf-8');
+        }
+        catch (_c) {
+            // Note: Persisting the estimate cache is best-effort. Failures must not affect the current run.
+        }
+    }
+    // Note: [🟡] Code in this file is only used from `@promptbook/cli` orchestration scripts and is not shipped to other consumers.
+
     /**
      * Reads an optional agent `.book` file and compiles its system message for injection into coder prompts.
      *
@@ -71782,6 +71942,11 @@
         markPromptDone(nextPrompt.file, nextPrompt.section, result.usage, runnerMetadata.runnerName, runnerMetadata.modelName, promptExecutionStartedDate, result.attemptCount);
         await writePromptFile(nextPrompt.file);
         await normalizeLineEndingsForCurrentRound(runOptions, roundChangedFilesSnapshot);
+        await recordPromptDurationInEstimateCache({
+            options: runOptions,
+            runnerMetadata,
+            promptExecutionStartedDate,
+        });
         if (!runOptions.noCommit) {
             await waitForCommitConfirmationIfNeeded({
                 options: runOptions,
@@ -71883,6 +72048,24 @@
             logger: console,
         });
     }
+    /**
+     * Persists the duration of one successful prompt round into the per-config estimate cache so the
+     * next `ptbk coder run` / `ptbk coder server` invocation can show a meaningful completion estimate
+     * before its own first prompt has finished.
+     */
+    async function recordPromptDurationInEstimateCache(options) {
+        var _a;
+        const { options: runOptions, runnerMetadata, promptExecutionStartedDate } = options;
+        if (!runOptions.agentName) {
+            return;
+        }
+        const promptDurationMs = moment__default["default"]().diff(promptExecutionStartedDate);
+        await recordPromptDurationSample({
+            harness: runOptions.agentName,
+            model: (_a = runnerMetadata.modelName) !== null && _a !== void 0 ? _a : runOptions.model,
+            thinkingLevel: runOptions.thinkingLevel,
+        }, promptDurationMs);
+    }
     /**
      * Normalizes line endings in files modified during the current coding round.
      */
@@ -71932,6 +72115,12 @@
             const { runner, actualRunnerModel, runnerMetadata } = resolvePromptRunner(options);
             console.info(colors__default["default"].green(`Running prompts with ${runner.name}`));
             initializeRunUi(uiHandle, runner.name, actualRunnerModel, options);
+            await seedCachedAveragePromptDuration({
+                options,
+                actualRunnerModel,
+                progressDisplay,
+                uiHandle,
+            });
             let hasShownUpcomingTasks = false;
             let hasWaitedForStart = false;
             let previousRoundStartTime;
@@ -72293,6 +72482,27 @@
         progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.resumeTimer();
         uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
     }
+    /**
+     * Loads the cached average prompt duration for the current runner configuration and seeds both
+     * progress displays with it so estimates are shown immediately, even before the first prompt of
+     * the current session completes.
+     */
+    async function seedCachedAveragePromptDuration(options) {
+        const { options: runOptions, actualRunnerModel, progressDisplay, uiHandle } = options;
+        if (!runOptions.agentName) {
+            return;
+        }
+        const cachedAveragePromptDurationMs = await loadCachedAveragePromptDurationMs({
+            harness: runOptions.agentName,
+            model: actualRunnerModel !== null && actualRunnerModel !== void 0 ? actualRunnerModel : runOptions.model,
+            thinkingLevel: runOptions.thinkingLevel,
+        });
+        if (cachedAveragePromptDurationMs === undefined) {
+            return;
+        }
+        progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.setCachedAveragePromptDurationMs(cachedAveragePromptDurationMs);
+        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setCachedAveragePromptDurationMs(cachedAveragePromptDurationMs);
+    }
     /**
      * Stops active displays and prints the git identity tip for real runs.
      */