@promptbook/cli 0.112.0-115 → 0.112.0-118

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('mime-types'), require('papaparse'), require('@openai/agents'), require('openai'), require('typescript'), require('ignore'), require('readline'), require('url'), require('events'), 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', 'mime-types', 'papaparse', '@openai/agents', 'openai', 'typescript', 'ignore', 'readline', 'url', 'events', '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.mimeTypes, global.papaparse, global.agents, global.OpenAI, global.ts, global.ignore, global.readline, global.url, global.events, 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, mimeTypes, papaparse, agents, OpenAI, ts, ignore, readline, url, events, pg) { 'use strict';
+    (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.mimeTypes, global.papaparse, global.agents, global.OpenAI, global.ts, global.ignore, global.readline, global.url, global.events, 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, mimeTypes, papaparse, agents, OpenAI, ts, ignore, readline, url, events, pg) { 'use strict';
 
     function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
 
@@ -34,6 +34,8 @@
     var hexEncoder__default = /*#__PURE__*/_interopDefaultLegacy(hexEncoder);
     var sha256__default = /*#__PURE__*/_interopDefaultLegacy(sha256);
     var JSZip__default = /*#__PURE__*/_interopDefaultLegacy(JSZip);
+    var CryptoJS__default = /*#__PURE__*/_interopDefaultLegacy(CryptoJS);
+    var showdown__default = /*#__PURE__*/_interopDefaultLegacy(showdown);
     var glob__default = /*#__PURE__*/_interopDefaultLegacy(glob);
     var http__default = /*#__PURE__*/_interopDefaultLegacy(http);
     var express__default = /*#__PURE__*/_interopDefaultLegacy(express);
@@ -41,6 +43,7 @@
     var swaggerUi__default = /*#__PURE__*/_interopDefaultLegacy(swaggerUi);
     var Anthropic__default = /*#__PURE__*/_interopDefaultLegacy(Anthropic);
     var Bottleneck__default = /*#__PURE__*/_interopDefaultLegacy(Bottleneck);
+    var papaparse__default = /*#__PURE__*/_interopDefaultLegacy(papaparse);
     var OpenAI__default = /*#__PURE__*/_interopDefaultLegacy(OpenAI);
     var ts__namespace = /*#__PURE__*/_interopNamespace(ts);
     var ignore__default = /*#__PURE__*/_interopDefaultLegacy(ignore);
@@ -60,7 +63,7 @@
      * @generated
      * @see https://github.com/webgptorg/promptbook
      */
-    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-115';
+    const PROMPTBOOK_ENGINE_VERSION = '0.112.0-118';
     /**
      * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
      * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1742,12 +1745,13 @@
     }
     // 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
     /**
-     * Runner identifiers supported by Promptbook CLI agent orchestration commands.
+     * All CLI harness names supported by `CliAgent` and `ptbk agent exec`.
      *
-     * @private internal utility of `promptbookCli`
+     * @public exported from `@promptbook/node`
      */
-    const PROMPT_RUNNER_HARNESS_NAMES = [
+    const CLI_AGENT_HARNESS_NAMES = [
         'openai-codex',
         'github-copilot',
         'cline',
@@ -1756,23 +1760,33 @@
         'gemini',
     ];
     /**
-     * Environment variable used as the default runner identifier when `--harness` is omitted.
+     * Environment variable used as the default runner identifier when `--harness` is omitted or not set in `CliAgent`.
      *
-     * @private internal utility of `promptbookCli`
+     * Set this to one of the harness names (`openai-codex`, `github-copilot`, `cline`, `claude-code`, `opencode`, `gemini`)
+     * so that `CliAgent` and `ptbk agent exec` can run without an explicit `harness` option.
+     *
+     * @public exported from `@promptbook/node`
      */
     const PTBK_HARNESS_ENV = 'PTBK_HARNESS';
     /**
-     * Environment variable used as the default runner model when `--model` is omitted.
+     * Environment variable used as the default runner model when `--model` is omitted or not set in `CliAgent`.
      *
-     * @private internal utility of `promptbookCli`
+     * @public exported from `@promptbook/node`
      */
     const PTBK_MODEL_ENV = 'PTBK_MODEL';
     /**
-     * Environment variable used as the default runner thinking level when `--thinking-level` is omitted.
+     * Environment variable used as the default thinking level when `--thinking-level` is omitted or not set in `CliAgent`.
      *
-     * @private internal utility of `promptbookCli`
+     * @public exported from `@promptbook/node`
      */
     const PTBK_THINKING_LEVEL_ENV = 'PTBK_THINKING_LEVEL';
+
+    /**
+     * Runner identifiers supported by Promptbook CLI agent orchestration commands.
+     *
+     * @private internal utility of `promptbookCli`
+     */
+    const PROMPT_RUNNER_HARNESS_NAMES = CLI_AGENT_HARNESS_NAMES;
     /**
      * Description block shared by runner-backed CLI commands.
      *
@@ -2056,42 +2070,44 @@
     // Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent.ts) should never be published outside of `@promptbook/cli`
     // Note: [💞] Ignore a discrepancy between file name and entity name
 
+    // Note: [💞] Ignore a discrepancy between file name and entity name
     /**
-     * Relative path to the local agent source initialized by `ptbk agent-folder init`.
+     * Relative path to the local agent source used by the agent folder convention.
      *
-     * @private internal utility of `ptbk agent-folder`
+     * @public exported from `@promptbook/node`
      */
     const AGENT_BOOK_FILE_PATH = 'agent.book';
     /**
-     * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
+     * Relative path to the message queue root used by the agent folder convention.
      *
-     * @private internal utility of `ptbk agent-folder`
-     */
-    const AGENT_KNOWLEDGE_DIRECTORY_PATH = 'knowledge';
-    /**
-     * Relative path to the message queue root initialized by `ptbk agent-folder init`.
-     *
-     * @private internal utility of `ptbk agent-folder`
+     * @public exported from `@promptbook/node`
      */
     const AGENT_MESSAGES_DIRECTORY_PATH = 'messages';
     /**
-     * Relative path to queued user messages consumed by `ptbk agent-folder run-once`.
+     * Relative path to queued user messages consumed by the agent runner.
      *
-     * @private internal utility of `ptbk agent-folder`
+     * @public exported from `@promptbook/node`
      */
     const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH = path.join(AGENT_MESSAGES_DIRECTORY_PATH, 'queued');
     /**
-     * Relative path to answered messages written by `ptbk agent-folder run-once`.
+     * Relative path to answered messages written by the agent runner.
      *
-     * @private internal utility of `ptbk agent-folder`
+     * @public exported from `@promptbook/node`
      */
     const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH = path.join(AGENT_MESSAGES_DIRECTORY_PATH, 'finished');
     /**
      * Relative path to messages that the agent runner stopped retrying.
      *
-     * @private internal utility of `ptbk agent-folder`
+     * @public exported from `@promptbook/node`
      */
     const AGENT_FAILED_MESSAGES_DIRECTORY_PATH = path.join(AGENT_MESSAGES_DIRECTORY_PATH, 'failed');
+
+    /**
+     * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
+     *
+     * @private internal utility of `ptbk agent-folder`
+     */
+    const AGENT_KNOWLEDGE_DIRECTORY_PATH = 'knowledge';
     /**
      * Relative path to generated local agent documentation initialized by `ptbk agent-folder init`.
      *
@@ -5124,6 +5140,7 @@
             noUi: options.noUi,
             thinkingLevel: options.thinkingLevel,
             waitForUser: false,
+            waitBetweenPrompts: 0,
             noCommit: options.noCommit,
             ignoreGitChanges: options.ignoreGitChanges,
             normalizeLineEndings: options.normalizeLineEndings,
@@ -6111,7 +6128,7 @@
      * @public exported from `@promptbook/utils`
      */
     function computeHash(value) {
-        return cryptoJs.SHA256(hexEncoder__default["default"].parse(_spaceTrim.spaceTrim(valueToString(value)))).toString( /* hex */);
+        return CryptoJS__default["default"].SHA256(hexEncoder__default["default"].parse(_spaceTrim.spaceTrim(valueToString(value)))).toString( /* hex */);
     }
     // TODO: [🥬][🥬] Use this ACRY
 
@@ -10816,21 +10833,22 @@
      * @private helper of `fractalAvatarVisual`
      */
     function drawDragonCurveLayer(context, points, options) {
-        const { size, primaryColor, secondaryColor, tertiaryColor, shadowColor, strokeWidth, timeMs, layerIndex } = options;
+        const { primaryColor, secondaryColor, tertiaryColor, shadowColor, strokeWidth, timeMs, layerIndex } = options;
         const firstPoint = points[0];
         const lastPoint = points[points.length - 1];
         const ribbonGradient = context.createLinearGradient(firstPoint.x, firstPoint.y, lastPoint.x, lastPoint.y);
         ribbonGradient.addColorStop(0, `${primaryColor}f2`);
         ribbonGradient.addColorStop(0.5, `${secondaryColor}e6`);
         ribbonGradient.addColorStop(1, `${tertiaryColor}f2`);
+        // Approximate the blurred shadow stroke with a wider semi-transparent stroke instead of
+        // context.filter blur, which triggers a costly software rasterization pass every frame.
         context.save();
         context.beginPath();
         tracePolyline(context, points);
-        context.strokeStyle = `${shadowColor}82`;
-        context.lineWidth = strokeWidth * 1.8;
+        context.strokeStyle = `${shadowColor}48`;
+        context.lineWidth = strokeWidth * 4.5;
         context.lineJoin = 'round';
         context.lineCap = 'round';
-        context.filter = `blur(${size * 0.022}px)`;
         context.stroke();
         context.restore();
         context.beginPath();
@@ -11414,11 +11432,23 @@
      * @private helper of `minecraft2AvatarVisual`
      */
     function drawMinecraftShadow(context, size, palette, interaction, timeMs) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.03;
+        const cy = size * 0.85 + Math.sin(timeMs / 880) * size * 0.01;
+        const rx = size * (0.16 + interaction.intensity * 0.015);
+        const ry = size * 0.055;
+        // Radial gradient approximates the blurry ellipse shadow without context.filter blur.
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.02}px)`;
+        context.translate(cx, cy);
+        context.scale(1, ry / rx);
+        const blurRadius = rx * 1.4;
+        const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+        shadowGradient.addColorStop(0, `${palette.shadow}7a`);
+        shadowGradient.addColorStop(0.45, `${palette.shadow}44`);
+        shadowGradient.addColorStop(0.8, `${palette.shadow}1a`);
+        shadowGradient.addColorStop(1, `${palette.shadow}00`);
+        context.fillStyle = shadowGradient;
         context.beginPath();
-        context.ellipse(size * 0.5 + interaction.gazeX * size * 0.03, size * 0.85 + Math.sin(timeMs / 880) * size * 0.01, size * (0.16 + interaction.intensity * 0.015), size * 0.055, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -11642,13 +11672,27 @@
             spotlight.addColorStop(1, `${palette.highlight}00`);
             context.fillStyle = spotlight;
             context.fillRect(0, 0, size, size);
-            context.save();
-            context.fillStyle = 'rgba(0, 0, 0, 0.22)';
-            context.filter = `blur(${size * 0.018}px)`;
-            context.beginPath();
-            context.ellipse(size * 0.5, size * 0.86, size * 0.2, size * 0.06, 0, 0, Math.PI * 2);
-            context.fill();
-            context.restore();
+            {
+                // Radial gradient approximates the blurry ellipse shadow without context.filter blur.
+                const cx = size * 0.5;
+                const cy = size * 0.86;
+                const rx = size * 0.2;
+                const ry = size * 0.06;
+                const blurRadius = rx * 1.4;
+                const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+                shadowGradient.addColorStop(0, 'rgba(0,0,0,0.28)');
+                shadowGradient.addColorStop(0.45, 'rgba(0,0,0,0.14)');
+                shadowGradient.addColorStop(0.8, 'rgba(0,0,0,0.05)');
+                shadowGradient.addColorStop(1, 'rgba(0,0,0,0)');
+                context.save();
+                context.translate(cx, cy);
+                context.scale(1, ry / rx);
+                context.fillStyle = shadowGradient;
+                context.beginPath();
+                context.arc(0, 0, blurRadius, 0, Math.PI * 2);
+                context.fill();
+                context.restore();
+            }
             drawVoxelCuboid(context, {
                 x: bodyX,
                 y: bodyY,
@@ -12700,6 +12744,35 @@
         y: -0.62,
         z: 0.94,
     });
+    /**
+     * Cache keyed by the `createRandom` factory reference (stable per mounted `<Avatar/>`).
+     *
+     * @private helper of `octopus3dAvatarVisual`
+     */
+    const octopus3dStableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and caching for subsequent frames.
+     *
+     * @private helper of `octopus3dAvatarVisual`
+     */
+    function getOctopus3dStableState(createRandom) {
+        const cached = octopus3dStableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const animationRandom = createRandom('octopus3d-animation-profile');
+        const eyeRandom = createRandom('octopus3d-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.6;
+        const rightEyePhaseOffset = eyeRandom() * 0.6;
+        const state = {
+            morphologyProfile: createOctopus3MorphologyProfile(createRandom),
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+        };
+        octopus3dStableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Proper 3D Octopus visual built from projected organic meshes and tentacles.
      *
@@ -12712,10 +12785,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d-animation-profile');
-            const eyeRandom = createRandom('octopus3d-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset } = getOctopus3dStableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.56;
             const bob = Math.sin(timeMs / 920 + animationPhase) * size * 0.014;
@@ -12812,12 +12882,12 @@
                 x: -faceEyeSpacing,
                 y: faceEyeYOffset,
                 z: resolveEllipsoidSurfaceDepth(mantleRadiusX, mantleRadiusY, mantleRadiusZ, -faceEyeSpacing, faceEyeYOffset),
-            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.6, interaction, morphologyProfile.face.eyeStyle);
+            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicEye(context, {
                 x: faceEyeSpacing,
                 y: faceEyeYOffset,
                 z: resolveEllipsoidSurfaceDepth(mantleRadiusX, mantleRadiusY, mantleRadiusZ, faceEyeSpacing, faceEyeYOffset),
-            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.7 + eyeRandom() * 0.6, interaction, morphologyProfile.face.eyeStyle);
+            }, faceEyeRadiusX, faceEyeRadiusY, mantleCenter, headPitch, headYaw, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.7 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 {
                     x: -mouthHalfWidth,
@@ -12861,14 +12931,28 @@
     /**
      * Draws the soft ground shadow below the octopus.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3dAvatarVisual`
      */
     function drawOctopus3dShadow(context, size, palette, interaction, timeMs) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.04;
+        const cy = size * 0.87 + Math.sin(timeMs / 920) * size * 0.008;
+        const rx = size * (0.18 + interaction.intensity * 0.02);
+        const ry = size * 0.06;
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.022}px)`;
+        context.translate(cx, cy);
+        context.scale(1, ry / rx);
+        const blurRadius = rx * 1.4;
+        const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+        shadowGradient.addColorStop(0, `${palette.shadow}7a`);
+        shadowGradient.addColorStop(0.45, `${palette.shadow}44`);
+        shadowGradient.addColorStop(0.8, `${palette.shadow}1a`);
+        shadowGradient.addColorStop(1, `${palette.shadow}00`);
+        context.fillStyle = shadowGradient;
         context.beginPath();
-        context.ellipse(size * 0.5 + interaction.gazeX * size * 0.04, size * 0.87 + Math.sin(timeMs / 920) * size * 0.008, size * (0.18 + interaction.intensity * 0.02), size * 0.06, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -13099,6 +13183,35 @@
         y: -0.6,
         z: 0.98,
     });
+    /**
+     * Cache keyed by the `createRandom` factory reference (stable per mounted `<Avatar/>`).
+     *
+     * @private helper of `octopus3d2AvatarVisual`
+     */
+    const octopus3d2StableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and caching for subsequent frames.
+     *
+     * @private helper of `octopus3d2AvatarVisual`
+     */
+    function getOctopus3d2StableState(createRandom) {
+        const cached = octopus3d2StableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const animationRandom = createRandom('octopus3d2-animation-profile');
+        const eyeRandom = createRandom('octopus3d2-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.7;
+        const rightEyePhaseOffset = eyeRandom() * 0.7;
+        const state = {
+            morphologyProfile: createOctopus3MorphologyProfile(createRandom),
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+        };
+        octopus3d2StableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Octopus 3D 2 avatar visual.
      *
@@ -13111,10 +13224,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d2-animation-profile');
-            const eyeRandom = createRandom('octopus3d2-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset } = getOctopus3d2StableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.575;
             const bob = Math.sin(timeMs / 940 + animationPhase) * size * 0.013;
@@ -13167,8 +13277,8 @@
             const rightEyeLocalCenter = sampleBlobbyOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude);
             const eyeRadiusX = size * morphologyProfile.face.eyeRadiusXRatio * 0.78;
             const eyeRadiusY = eyeRadiusX * morphologyProfile.face.eyeHeightRatio * 0.92;
-            drawProjectedOrganicEye(context, leftEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
-            drawProjectedOrganicEye(context, rightEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.9 + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, leftEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, rightEyeLocalCenter, eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.9 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 sampleBlobbyOctopusSurfacePoint(surfaceOptions, mouthLatitude, mouthCenterLongitude - mouthHalfLongitude),
                 sampleBlobbyOctopusSurfacePoint(surfaceOptions, mouthCurveLatitude, mouthCenterLongitude),
@@ -13197,14 +13307,28 @@
     /**
      * Draws the soft floor shadow that anchors the single mesh in the frame.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3d2AvatarVisual`
      */
     function drawBlobbyOctopusShadow(context, size, palette, interaction, timeMs, morphologyProfile) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.045;
+        const cy = size * 0.88 + Math.sin(timeMs / 940) * size * 0.008;
+        const rx = size * (0.18 + (morphologyProfile.body.horizontalStretch - 1) * 0.04 + interaction.intensity * 0.018);
+        const ry = size * 0.062;
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.024}px)`;
+        context.translate(cx, cy);
+        context.scale(1, ry / rx);
+        const blurRadius = rx * 1.4;
+        const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+        shadowGradient.addColorStop(0, `${palette.shadow}7a`);
+        shadowGradient.addColorStop(0.45, `${palette.shadow}44`);
+        shadowGradient.addColorStop(0.8, `${palette.shadow}1a`);
+        shadowGradient.addColorStop(1, `${palette.shadow}00`);
+        context.fillStyle = shadowGradient;
         context.beginPath();
-        context.ellipse(size * 0.5 + interaction.gazeX * size * 0.045, size * 0.88 + Math.sin(timeMs / 940) * size * 0.008, size * (0.18 + (morphologyProfile.body.horizontalStretch - 1) * 0.04 + interaction.intensity * 0.018), size * 0.062, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -13360,6 +13484,40 @@
      * @private helper of `octopus3d3AvatarVisual`
      */
     const OCTOPUS_TENTACLE_COUNT = 8;
+    /**
+     * Cache keyed by the `createRandom` factory reference, which is stable for the lifetime of one
+     * mounted `<Avatar/>` component (created inside `resolveAvatarRenderDefinition` and held in a
+     * React `useMemo`).  Using a `WeakMap` ensures the entry is collected when the component unmounts.
+     *
+     * @private helper of `octopus3d3AvatarVisual`
+     */
+    const stableStateCache = new WeakMap();
+    /**
+     * Returns the stable per-avatar state, computing it on first access and returning the cached
+     * result on every subsequent call within the same `<Avatar/>` mount.
+     *
+     * @private helper of `octopus3d3AvatarVisual`
+     */
+    function getOctopus3d3StableState(createRandom) {
+        const cached = stableStateCache.get(createRandom);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
+        const animationRandom = createRandom('octopus3d3-animation-profile');
+        const eyeRandom = createRandom('octopus3d3-eye-profile');
+        const leftEyePhaseOffset = eyeRandom() * 0.7;
+        const rightEyePhaseOffset = eyeRandom() * 0.7;
+        const state = {
+            morphologyProfile,
+            animationPhase: animationRandom() * Math.PI * 2,
+            leftEyePhaseOffset,
+            rightEyePhaseOffset,
+            tentacleProfiles: createContinuousTentacleProfiles(createRandom, morphologyProfile),
+        };
+        stableStateCache.set(createRandom, state);
+        return state;
+    }
     /**
      * Octopus 3D 3 avatar visual.
      *
@@ -13372,11 +13530,7 @@
         isAnimated: true,
         supportsPointerTracking: true,
         render({ context, size, palette, createRandom, timeMs, interaction }) {
-            const morphologyProfile = createOctopus3MorphologyProfile(createRandom);
-            const animationRandom = createRandom('octopus3d3-animation-profile');
-            const eyeRandom = createRandom('octopus3d3-eye-profile');
-            const animationPhase = animationRandom() * Math.PI * 2;
-            const tentacleProfiles = createContinuousTentacleProfiles(createRandom, morphologyProfile);
+            const { morphologyProfile, animationPhase, leftEyePhaseOffset, rightEyePhaseOffset, tentacleProfiles } = getOctopus3d3StableState(createRandom);
             const sceneCenterX = size * 0.5;
             const sceneCenterY = size * 0.535;
             const bob = Math.sin(timeMs / 960 + animationPhase) * size * 0.012;
@@ -13453,8 +13607,8 @@
                 size,
                 palette,
             });
-            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, -eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
-            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.85 + eyeRandom() * 0.7, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, -eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + leftEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
+            drawProjectedOrganicEye(context, sampleContinuousOctopusSurfacePoint(surfaceOptions, eyeLatitude, eyeLongitude), eyeRadiusX, eyeRadiusY, meshCenter, rotationX, rotationY, sceneCenterX, sceneCenterY, size, palette, timeMs, animationPhase + 0.85 + rightEyePhaseOffset, interaction, morphologyProfile.face.eyeStyle);
             drawProjectedOrganicMouth(context, [
                 sampleContinuousOctopusSurfacePoint(surfaceOptions, mouthLatitude, mouthCenterLongitude - mouthHalfLongitude),
                 sampleContinuousOctopusSurfacePoint(surfaceOptions, mouthCurveLatitude, mouthCenterLongitude),
@@ -13505,14 +13659,30 @@
     /**
      * Draws the soft lower shadow that anchors the octopus in the avatar frame.
      *
+     * Uses a scaled radial gradient instead of `context.filter = 'blur()'` to approximate the
+     * blurry ellipse without triggering a costly software rasterization pass on every frame.
+     *
      * @private helper of `octopus3d3AvatarVisual`
      */
     function drawContinuousOctopusShadow(context, size, palette, interaction, timeMs, morphologyProfile) {
+        const cx = size * 0.5 + interaction.gazeX * size * 0.045;
+        const cy = size * 0.9 + Math.sin(timeMs / 980) * size * 0.007;
+        const rx = size * (0.19 + morphologyProfile.tentacles.rootSpreadScale * 0.022 + interaction.intensity * 0.02);
+        const ry = size * 0.06;
+        // Scale the context so that drawing a circle produces the correct ellipse aspect ratio,
+        // then fill with a radial gradient that approximates the blurry edge without context.filter.
         context.save();
-        context.fillStyle = `${palette.shadow}66`;
-        context.filter = `blur(${size * 0.025}px)`;
+        context.translate(cx, cy);
+        context.scale(1, ry / rx);
+        const blurRadius = rx * 1.4;
+        const shadowGradient = context.createRadialGradient(0, 0, 0, 0, 0, blurRadius);
+        shadowGradient.addColorStop(0, `${palette.shadow}7a`);
+        shadowGradient.addColorStop(0.45, `${palette.shadow}44`);
+        shadowGradient.addColorStop(0.8, `${palette.shadow}1a`);
+        shadowGradient.addColorStop(1, `${palette.shadow}00`);
+        context.fillStyle = shadowGradient;
         context.beginPath();
-        context.ellipse(size * 0.5 + interaction.gazeX * size * 0.045, size * 0.9 + Math.sin(timeMs / 980) * size * 0.007, size * (0.19 + morphologyProfile.tentacles.rootSpreadScale * 0.022 + interaction.intensity * 0.02), size * 0.06, 0, 0, Math.PI * 2);
+        context.arc(0, 0, blurRadius, 0, Math.PI * 2);
         context.fill();
         context.restore();
     }
@@ -22117,7 +22287,7 @@
      * @private internal helper function
      */
     function $randomToken(randomness) {
-        return crypto.randomBytes(randomness).toString('hex');
+        return CryptoJS__default["default"].lib.WordArray.random(randomness).toString(CryptoJS__default["default"].enc.Hex);
     }
     // TODO: [🤶] Maybe export through `@promptbook/utils` or `@promptbook/random` package
     // TODO: Maybe use nanoid instead https://github.com/ai/nanoid
@@ -28421,7 +28591,7 @@
             askForApproval: 'never',
             allowCredits: options.allowCredits,
         });
-        if (!options.allowCredits) {
+        if (!options.allowCredits && options.isVerbose === true) {
             console.info(colors__default["default"].gray('OpenAI Codex credit spending is disabled. Use `--allow-credits` to explicitly opt in.'));
         }
         return createRunnerResolution(options, runner, actualRunnerModel);
@@ -28737,14 +28907,50 @@
      * Builds the prompt sent to the selected coding runner for one queued user-thread book.
      */
     function buildAgentMessagePrompt(messageRelativePath, agentSystemMessage) {
-        const taskPrompt = _spaceTrim.spaceTrim(`
-            Answer 1 user question
+        return _spaceTrim.spaceTrim((block) => `
+                # Answer 1 user question
 
-            -   Read \`${messageRelativePath}\` and answer the most recent \`MESSAGE @User\`
-            -   Only change the queued message file by appending one new \`MESSAGE @Agent\` block
-            -   Do not modify any other file in the repository
-        `);
-        return `${taskPrompt}\n\n**This is how you should behave:**\n\n${agentSystemMessage.trim()}`;
+                -   Read \`${messageRelativePath}\` and answer the most recent \`MESSAGE @User\`
+                -   Only change the queued message file by appending one new \`MESSAGE @Agent\` block
+                -   Do not modify any other file in the repository
+
+                ## Rules for the answering
+
+                ## Formatting
+
+                - You can use Markdown formatting in the messages like **bold** or *italic*
+
+                ## Sources and citations
+
+                Mark sources and citations like this "【https://example.com/document123.pdf 】"
+
+                At the same time, you can write sources naturally in the text of the answers
+
+                For example:
+
+                > According to paragraph §745b, the fee can be waived for a person over 65 years old. 【https://praha13.cz/2026/paragraph-745.doc】
+
+                - "paragraph §745b" fits naturally in the text.
+                - "【https://praha13.cz/2026/paragraph-745.doc】" The exact format of the quote is important for further processing of the answer.
+                - The "【" and "】" symbols are used to mark the source and will be parsed, inside should be valid URL used as a source for the answer.
+
+                ## Quick buttons
+
+                If there is a meaningful follow-up procedure, use quick buttons at the end of the answer:
+
+                \`\`\`
+                How big is the contract you are posting?
+
+                [Up to 50,000 CZK](?message=We are posting an order up to 50,000 CZK)
+                [Up to 100,000 CZK](?message=We are posting an order up to 100,000 CZK)
+                [Over 100,000 CZK](?message=We are posting an order over 100,000 CZK)
+                \`\`\`
+
+
+                ## This is how you should behave
+
+                ${block(agentSystemMessage)}
+            `);
     }
 
     /**
@@ -31358,7 +31564,7 @@
      * @public exported from `@promptbook/editable`
      */
     function knowledgeSourceContentToName(knowledgeSourceContent) {
-        const hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(JSON.stringify(knowledgeSourceContent)))
+        const hash = CryptoJS__default["default"].SHA256(hexEncoder__default["default"].parse(JSON.stringify(knowledgeSourceContent)))
             //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
             .toString( /* hex */)
             .substring(0, 20);
@@ -32206,7 +32412,7 @@
             console.warn('CSV string contains carriage return characters, but in the CSV settings the `newline` setting does not include them. Autohealing the CSV string.');
             value = value.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
         }
-        const csv = papaparse.parse(value, settings);
+        const csv = papaparse__default["default"].parse(value, settings);
         return csv;
     }
 
@@ -32291,10 +32497,10 @@
                                 i > index ? { ...row, [outputParameterName]: PENDING_VALUE_PLACEHOLDER } : row,
                             );
                             */
-                            await onProgress(papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
+                            await onProgress(papaparse__default["default"].unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS }));
                         }
                     }
-                    return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                    return papaparse__default["default"].unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
                 },
             },
             {
@@ -32322,7 +32528,7 @@
                             return /* not await */ mapCallback({ [key]: value }, index, array.length);
                         }));
                     }));
-                    return papaparse.unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
+                    return papaparse__default["default"].unparse(mappedData, { ...settings, ...MANDATORY_CSV_SETTINGS });
                 },
             },
         ],
@@ -35889,7 +36095,9 @@
      * @private internal utility of `Book`
      */
     function parseCommitmentHeader(line) {
-        const match = /^([A-Z][A-Z0-9]*(?: [A-Z0-9]+)*)(?:\s+(.*))?$/u.exec(line);
+        // Require at least 2 characters in the first keyword word to avoid treating common
+        // single-letter words (e.g. "V" in Czech, "I" or "A" in English) as commitment headers.
+        const match = /^([A-Z][A-Z0-9]+(?: [A-Z0-9]+)*)(?:\s+(.*))?$/u.exec(line);
         if (!match) {
             return null;
         }
@@ -39303,6 +39511,57 @@
     // Note: [🟡] Code for CLI command [init](src/cli/cli-commands/coder/init.ts) should never be published outside of `@promptbook/cli`
     // Note: [💞] Ignore a discrepancy between file name and entity name
 
+    /**
+     * Pattern that matches durations like "1h", "30m", "5s", "1h30m", "1h30m5s".
+     */
+    const DURATION_PATTERN = /^(?:(\d+)h)?(?:(\d+)m(?:in)?)?(?:(\d+)s)?$/;
+    /**
+     * Parses a human-readable duration string into milliseconds.
+     *
+     * Supported formats: `Xh`, `Xm`, `Xs`, and combinations like `1h30m`, `1h30m5s`.
+     *
+     * @returns Duration in milliseconds
+     * @throws When the string does not match any supported format
+     *
+     * @private internal utility of `ptbk coder run`
+     */
+    function parseDuration(durationString) {
+        var _a, _b, _c;
+        const trimmed = durationString.trim();
+        if (!trimmed) {
+            throw new Error(`Invalid duration: empty string. Expected a format like "1h", "30m", "5s", or combinations like "1h30m".`);
+        }
+        const match = trimmed.match(DURATION_PATTERN);
+        if (!match || (match[1] === undefined && match[2] === undefined && match[3] === undefined)) {
+            throw new Error(`Invalid duration: "${durationString}". Expected a format like "1h", "30m", "5s", or combinations like "1h30m5s".`);
+        }
+        const hours = parseInt((_a = match[1]) !== null && _a !== void 0 ? _a : '0', 10);
+        const minutes = parseInt((_b = match[2]) !== null && _b !== void 0 ? _b : '0', 10);
+        const seconds = parseInt((_c = match[3]) !== null && _c !== void 0 ? _c : '0', 10);
+        return (hours * 3600 + minutes * 60 + seconds) * 1000;
+    }
+    /**
+     * Formats a duration in milliseconds into a compact human-readable string.
+     *
+     * Examples: `3600000` → `"1h"`, `90000` → `"1m 30s"`, `5000` → `"5s"`.
+     *
+     * @private internal utility of `ptbk coder run`
+     */
+    function formatDurationMs(ms) {
+        const totalSeconds = Math.ceil(ms / 1000);
+        const hours = Math.floor(totalSeconds / 3600);
+        const minutes = Math.floor((totalSeconds % 3600) / 60);
+        const seconds = totalSeconds % 60;
+        const parts = [];
+        if (hours > 0)
+            parts.push(`${hours}h`);
+        if (minutes > 0)
+            parts.push(`${minutes}m`);
+        if (seconds > 0 || parts.length === 0)
+            parts.push(`${seconds}s`);
+        return parts.join(' ');
+    }
+
     /**
      * Initializes `coder run` command for Promptbook CLI utilities
      *
@@ -39335,7 +39594,13 @@
         command.option('--preserve-logs', 'Keep generated temp prompt/log artifacts after successful rounds for debugging and analytics', false);
         addPromptRunnerExecutionOptions(command);
         command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 0);
-        command.option('--no-wait', 'Skip user prompts between processing');
+        command.option('--wait [duration]', _spaceTrim.spaceTrim(`
+            Wait between prompt rounds.
+            Without a value (default): waits for user confirmation before each prompt (interactive mode).
+            With a duration like 1h, 30m, 5s: waits that long between prompts to avoid hitting rate limits of the harness.
+        `), true);
+        // Note: --no-wait disables the default interactive wait-for-user behaviour
+        command.option('--no-wait', 'Skip all waiting between prompts and run non-interactively');
         command.option('--auto-migrate', 'Run testing-server database migrations automatically after each successfully processed prompt');
         command.option('--allow-destructive-auto-migrate', 'Allow auto-migrate even when heuristic SQL safety check flags destructive pending migrations');
         command.action(handleActionErrors(async (cliOptions) => {
@@ -39344,10 +39609,23 @@
             const runnerOptions = normalizePromptRunnerCliOptions(cliOptions, {
                 isAgentRequired: !dryRun,
             });
+            // [1] Parse the --wait option:
+            //   true (default or --wait without value): wait for user confirmation
+            //   false (--no-wait): no waiting at all
+            //   string (--wait 1h): wait that long between prompt rounds
+            let waitForUser = false;
+            let waitBetweenPrompts = 0;
+            if (wait === true) {
+                waitForUser = true;
+            }
+            else if (typeof wait === 'string' && wait !== '') {
+                waitBetweenPrompts = parseDuration(wait);
+            }
             // Convert commander options to RunOptions format
             const runOptions = {
                 dryRun,
-                waitForUser: wait,
+                waitForUser,
+                waitBetweenPrompts,
                 noCommit: runnerOptions.noCommit,
                 ignoreGitChanges: runnerOptions.ignoreGitChanges,
                 agentName: runnerOptions.agentName,
@@ -45338,7 +45616,7 @@
         const { filename: sourceFilename, url } = source;
         const { rootDirname, cacheDirname, intermediateFilesStrategy, extension, isVerbose } = options;
         // TODO: [👬] DRY
-        const hash = cryptoJs.SHA256(
+        const hash = CryptoJS__default["default"].SHA256(
         //    <- TODO: [🥬] Encapsulate sha256 to some private utility function
         hexEncoder__default["default"].parse(sourceFilename || url || 'untitled'))
             .toString( /* hex */)
@@ -45429,7 +45707,7 @@
      * @private utility of `WebsiteScraper`
      */
     function createShowdownConverter() {
-        return new showdown.Converter({
+        return new showdown__default["default"].Converter({
             flavor: 'github',
             /*
             > import showdownHighlight from 'showdown-highlight';
@@ -62790,10 +63068,12 @@
             noUi: options.noUi,
             thinkingLevel: options.thinkingLevel,
             waitForUser: false,
+            waitBetweenPrompts: 0,
             noCommit: true,
             ignoreGitChanges: true,
             normalizeLineEndings: false,
             allowCredits: options.allowCredits,
+            isVerbose: options.isVerbose,
             autoMigrate: false,
             allowDestructiveAutoMigrate: false,
             autoPush: false,
@@ -64826,7 +65106,7 @@
      * Computes one stable hash from a JSON-serializable value.
      */
     function computeJsonHash$1(value) {
-        return cryptoJs.SHA256(JSON.stringify(value)).toString();
+        return CryptoJS__default["default"].SHA256(JSON.stringify(value)).toString();
     }
     /**
      * Handles OpenAI AgentKit-backed executions for `AgentLlmExecutionTools`.
@@ -64984,7 +65264,7 @@
      * Computes one stable hash from a JSON-serializable value.
      */
     function computeJsonHash(value) {
-        return cryptoJs.SHA256(JSON.stringify(value)).toString();
+        return CryptoJS__default["default"].SHA256(JSON.stringify(value)).toString();
     }
     /**
      * Removes assistant-managed requirements before the prompt is executed via OpenAI Assistants.
@@ -65786,7 +66066,7 @@
          * Returns a virtual model name representing the agent behavior.
          */
         get modelName() {
-            const hash = cryptoJs.SHA256(hexEncoder__default["default"].parse(this.options.agentSource)).toString( /* hex */);
+            const hash = CryptoJS__default["default"].SHA256(hexEncoder__default["default"].parse(this.options.agentSource)).toString( /* hex */);
             const agentId = hash.substring(0, 10);
             return (normalizeToKebabCase(this.title) + '-' + agentId);
         }
@@ -68323,7 +68603,7 @@
     /**
      * CLI usage text for this script.
      */
-    const USAGE = 'Usage: run-codex-prompts [--dry-run] [--harness <harness-name>] [--model <model>] [--context <context-or-file>] [--test <test-command...>] [--preserve-logs] [--no-ui] [--thinking-level <thinking-level>] [--priority <minimum-priority>] [--allow-credits] [--auto-migrate] [--allow-destructive-auto-migrate] [--no-wait] [--no-commit] [--ignore-git-changes] [--no-normalize-line-endings] [--auto-push] [--auto-pull]';
+    const USAGE = 'Usage: run-codex-prompts [--dry-run] [--harness <harness-name>] [--model <model>] [--context <context-or-file>] [--test <test-command...>] [--preserve-logs] [--no-ui] [--thinking-level <thinking-level>] [--priority <minimum-priority>] [--allow-credits] [--auto-migrate] [--allow-destructive-auto-migrate] [--wait [duration]] [--no-wait] [--no-commit] [--ignore-git-changes] [--no-normalize-line-endings] [--auto-push] [--auto-pull]';
     /**
      * Top-level flags supported by this command.
      */
@@ -68340,6 +68620,7 @@
         '--allow-credits',
         '--auto-migrate',
         '--allow-destructive-auto-migrate',
+        '--wait',
         '--no-wait',
         '--no-commit',
         '--ignore-git-changes',
@@ -68378,6 +68659,22 @@
         const allowDestructiveAutoMigrate = args.includes('--allow-destructive-auto-migrate');
         const autoPush = args.includes('--auto-push');
         const autoPull = args.includes('--auto-pull');
+        // [1] Parse --wait [duration]:
+        //   absent or --no-wait: no waiting
+        //   --wait (no value): wait for user confirmation
+        //   --wait 1h: wait 1h between prompt rounds to avoid rate limits
+        const waitOptionalValue = readOptionalOptionValue(args, '--wait');
+        let waitForUser = false;
+        let waitBetweenPrompts = 0;
+        if (waitOptionalValue === null) {
+            // --wait present without a duration value: interactive mode
+            waitForUser = true;
+        }
+        else if (waitOptionalValue !== undefined) {
+            // --wait <duration>: time-based wait between rounds
+            waitBetweenPrompts = parseDuration(waitOptionalValue);
+        }
+        // --no-wait (or no flag): both waitForUser and waitBetweenPrompts remain false/0
         let thinkingLevel;
         if (hasTestCommandFlag && testCommand === undefined) {
             exitWithUsageError('Missing value for --test. Use a shell command such as `npm run test` and quote it when it contains top-level CLI flags.');
@@ -68396,7 +68693,8 @@
         }
         return {
             dryRun,
-            waitForUser: !args.includes('--no-wait'),
+            waitForUser,
+            waitBetweenPrompts,
             noCommit,
             ignoreGitChanges,
             normalizeLineEndings,
@@ -68415,6 +68713,23 @@
             priority,
         };
     }
+    /**
+     * Reads an optional value for a flag that may appear with or without a following value.
+     *
+     * Returns `undefined` when the flag is absent, `null` when the flag is present but has no value
+     * (the next token is another flag or the end of args), and the value string otherwise.
+     */
+    function readOptionalOptionValue(args, flag) {
+        if (!args.includes(flag)) {
+            return undefined;
+        }
+        const index = args.indexOf(flag);
+        const nextArg = args[index + 1];
+        if (nextArg === undefined || nextArg.startsWith('-')) {
+            return null;
+        }
+        return nextArg;
+    }
     /**
      * Reads a value of a CLI option that follows a given flag.
      */
@@ -70870,6 +71185,7 @@
             initializeRunUi(uiHandle, runner.name, actualRunnerModel, options);
             let hasShownUpcomingTasks = false;
             let hasWaitedForStart = false;
+            let hasRunAtLeastOneRound = false;
             while (just(true)) {
                 if (options.autoPull && !options.dryRun) {
                     await waitForRequestedPause({
@@ -70905,6 +71221,16 @@
                 }
                 const nextPrompt = promptQueueSnapshot.nextPrompt;
                 const promptLabel = buildPromptLabelForDisplay(nextPrompt.file, nextPrompt.section);
+                // Wait between prompt rounds (skipped for the first round)
+                if (hasRunAtLeastOneRound) {
+                    await waitBetweenPromptRoundsIfNeeded({
+                        options,
+                        isRichUiEnabled,
+                        progressDisplay,
+                        uiHandle,
+                    });
+                }
+                hasRunAtLeastOneRound = true;
                 hasWaitedForStart = await waitForPromptConfirmationIfNeeded({
                     options,
                     nextPrompt,
@@ -71140,6 +71466,39 @@
         uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
         return true;
     }
+    /**
+     * Countdown update interval for the between-rounds wait display.
+     */
+    const WAIT_COUNTDOWN_UPDATE_INTERVAL_MS = 30000;
+    /**
+     * Waits the configured time between prompt rounds to avoid hitting harness rate limits.
+     * Does nothing when `waitBetweenPrompts` is zero.
+     */
+    async function waitBetweenPromptRoundsIfNeeded(options) {
+        const { options: runOptions, isRichUiEnabled, progressDisplay, uiHandle } = options;
+        const { waitBetweenPrompts } = runOptions;
+        if (waitBetweenPrompts <= 0) {
+            return;
+        }
+        progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.pauseTimer();
+        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.pauseTimer();
+        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setPhase('waiting');
+        let remaining = waitBetweenPrompts;
+        while (remaining > 0) {
+            const statusMessage = `Waiting ${formatDurationMs(remaining)} before next prompt to avoid rate limits...`;
+            if (!isRichUiEnabled) {
+                console.info(colors__default["default"].gray(statusMessage));
+            }
+            else {
+                uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.setStatusMessage(statusMessage);
+            }
+            const sleepMs = Math.min(WAIT_COUNTDOWN_UPDATE_INTERVAL_MS, remaining);
+            await new Promise((resolve) => setTimeout(resolve, sleepMs));
+            remaining -= sleepMs;
+        }
+        progressDisplay === null || progressDisplay === void 0 ? void 0 : progressDisplay.resumeTimer();
+        uiHandle === null || uiHandle === void 0 ? void 0 : uiHandle.state.resumeTimer();
+    }
     /**
      * Stops active displays and prints the git identity tip for real runs.
      */