@promptbook/cli 0.112.0-127 → 0.112.0-129

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

@@ -0,0 +1,27 @@
+import type { CoderRunUiHandle } from '../ui/renderCoderRunUi';
+/**
+ * Distinct kinds of wait shown by the run loop so the UI can label them clearly.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export type CoderRunWaitKind = 'after-prompt' | 'between-prompts' | 'after-error';
+/**
+ * Returns the human-readable status message used for one wait kind.
+ *
+ * @private internal utility of `sleepWithCountdown`
+ */
+export declare function describeCoderRunWait(waitKind: CoderRunWaitKind, remainingMs: number, totalMs?: number): string;
+/**
+ * Sleeps the requested duration while refreshing the status message on a UI handle and the plain console.
+ *
+ * The wait kind is shown in the UI status so the user can distinguish `--wait-after-prompt`,
+ * `--wait-between-prompts`, and `--wait-after-error` waits at a glance.
+ *
+ * @public exported from `@promptbook/cli`
+ */
+export declare function sleepWithCountdown(options: {
+    durationMs: number;
+    waitKind: CoderRunWaitKind;
+    isRichUiEnabled: boolean;
+    uiHandle?: CoderRunUiHandle;
+}): Promise<void>;

package/esm/src/cli/cli-commands/coder/waitOptions.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Default wait duration applied before retrying a prompt round after an error (10 minutes).
+ *
+ * @private internal constant of `ptbk coder` wait handling
+ */
+export declare const DEFAULT_WAIT_AFTER_ERROR_MS: number;
+/**
+ * Parses an optional Commander duration string and returns the resolved milliseconds.
+ *
+ * Returns `defaultMs` when the flag was not provided or was provided without a non-empty value.
+ *
+ * @private internal utility of `ptbk coder` wait handling
+ */
+export declare function parseOptionalWaitDuration(value: string | undefined, defaultMs: number): number;

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@promptbook/cli",
-    "version": "0.112.0-127",
+    "version": "0.112.0-129",
     "description": "Promptbook: Create persistent AI agents that turn your company's scattered knowledge into action",
     "private": false,
     "sideEffects": false,

package/src/cli/cli-commands/coder/run.ts

@@ -11,7 +11,10 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
-import { parseDuration } from '../../../../scripts/run-codex-prompts/common/parseDuration';
+import {
+    DEFAULT_WAIT_AFTER_ERROR_MS,
+    parseOptionalWaitDuration,
+} from './waitOptions';
 
 /**
  * Initializes `coder run` command for Promptbook CLI utilities
@@ -63,10 +66,25 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
     addPromptRunnerExecutionOptions(command);
     command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 0);
     command.option(
-        '--wait <duration>',
+        '--wait-after-prompt <duration>',
+        spaceTrim(`
+            Wait this long after each prompt has been implemented, verified and committed before starting the next prompt.
+            Accepts durations like 1h, 30m, 5s. Defaults to 0 (no wait).
+        `),
+    );
+    command.option(
+        '--wait-between-prompts <duration>',
+        spaceTrim(`
+            Pace prompts so that each next prompt starts at least this long after the previous one began.
+            If the previous prompt already took longer than this, the next prompt starts immediately.
+            Accepts durations like 1h, 30m, 5s. Defaults to 0 (no pacing).
+        `),
+    );
+    command.option(
+        '--wait-after-error <duration>',
         spaceTrim(`
-            Wait this long between prompt rounds to avoid hitting rate limits of the harness.
-            Accepts durations like 1h, 30m, 5s.
+            Wait this long before retrying a prompt after an error occurs (up to 3 retries before giving up).
+            Accepts durations like 1h, 30m, 5s. Defaults to 10m.
         `),
     );
     // Note: --no-auto disables the default auto behaviour and waits for user confirmation before each prompt
@@ -92,7 +110,9 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 test,
                 preserveLogs,
                 priority,
-                wait,
+                waitAfterPrompt: waitAfterPromptValue,
+                waitBetweenPrompts: waitBetweenPromptsValue,
+                waitAfterError: waitAfterErrorValue,
                 auto,
                 autoMigrate,
                 allowDestructiveAutoMigrate,
@@ -103,7 +123,9 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 readonly test?: string | string[];
                 readonly preserveLogs: boolean;
                 readonly priority: number;
-                readonly wait?: string;
+                readonly waitAfterPrompt?: string;
+                readonly waitBetweenPrompts?: string;
+                readonly waitAfterError?: string;
                 readonly auto: boolean;
                 readonly autoMigrate: boolean;
                 readonly allowDestructiveAutoMigrate: boolean;
@@ -114,18 +136,24 @@ export function $initializeCoderRunCommand(program: Program): $side_effect {
                 isAgentRequired: !dryRun,
             });
 
-            // [1] Parse the --wait and --no-auto options:
-            //   default: run automatically through the queue (no waiting)
+            // [1] Parse the wait options and --no-auto:
+            //   default: run automatically through the queue (no waiting between prompts)
             //   --no-auto: wait for user confirmation before each prompt (interactive mode)
-            //   --wait <duration>: wait that long between prompt rounds to avoid rate limits
+            //   --wait-after-prompt: pause after a successful round before starting the next prompt
+            //   --wait-between-prompts: pace from start of one prompt to start of next
+            //   --wait-after-error: wait before retrying after an error (default 10m)
             const waitForUser = !auto;
-            const waitBetweenPrompts = typeof wait === 'string' && wait !== '' ? parseDuration(wait) : 0;
+            const waitAfterPrompt = parseOptionalWaitDuration(waitAfterPromptValue, 0);
+            const waitBetweenPrompts = parseOptionalWaitDuration(waitBetweenPromptsValue, 0);
+            const waitAfterError = parseOptionalWaitDuration(waitAfterErrorValue, DEFAULT_WAIT_AFTER_ERROR_MS);
 
             // Convert commander options to RunOptions format
             const runOptions = {
                 dryRun,
                 waitForUser,
+                waitAfterPrompt,
                 waitBetweenPrompts,
+                waitAfterError,
                 noCommit: runnerOptions.noCommit,
                 ignoreGitChanges: runnerOptions.ignoreGitChanges,
                 agentName: runnerOptions.agentName,

package/src/cli/cli-commands/coder/server.ts

@@ -15,7 +15,7 @@ import {
     normalizePromptRunnerCliOptions,
     PROMPT_RUNNER_DESCRIPTION,
 } from '../common/promptRunnerCliOptions';
-import { parseDuration } from '../../../../scripts/run-codex-prompts/common/parseDuration';
+import { DEFAULT_WAIT_AFTER_ERROR_MS, parseOptionalWaitDuration } from './waitOptions';
 
 /**
  * Default port used by `ptbk coder server`.
@@ -79,10 +79,25 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
     addPromptRunnerExecutionOptions(command);
     command.option('--priority <minimum-priority>', 'Filter prompts by minimum priority level', parseIntOption, 0);
     command.option(
-        '--wait <duration>',
+        '--wait-after-prompt <duration>',
         spaceTrim(`
-            Wait this long between prompt rounds to avoid hitting rate limits of the harness.
-            Accepts durations like 1h, 30m, 5s.
+            Wait this long after each prompt has been implemented, verified and committed before starting the next prompt.
+            Accepts durations like 1h, 30m, 5s. Defaults to 0 (no wait).
+        `),
+    );
+    command.option(
+        '--wait-between-prompts <duration>',
+        spaceTrim(`
+            Pace prompts so that each next prompt starts at least this long after the previous one began.
+            If the previous prompt already took longer than this, the next prompt starts immediately.
+            Accepts durations like 1h, 30m, 5s. Defaults to 0 (no pacing).
+        `),
+    );
+    command.option(
+        '--wait-after-error <duration>',
+        spaceTrim(`
+            Wait this long before retrying a prompt after an error occurs (up to 3 retries before giving up).
+            Accepts durations like 1h, 30m, 5s. Defaults to 10m.
         `),
     );
     command.option(
@@ -108,7 +123,9 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 test,
                 preserveLogs,
                 priority,
-                wait,
+                waitAfterPrompt: waitAfterPromptValue,
+                waitBetweenPrompts: waitBetweenPromptsValue,
+                waitAfterError: waitAfterErrorValue,
                 auto,
                 autoMigrate,
                 allowDestructiveAutoMigrate,
@@ -120,7 +137,9 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 readonly test?: string | string[];
                 readonly preserveLogs: boolean;
                 readonly priority: number;
-                readonly wait?: string;
+                readonly waitAfterPrompt?: string;
+                readonly waitBetweenPrompts?: string;
+                readonly waitAfterError?: string;
                 readonly auto: boolean;
                 readonly autoMigrate: boolean;
                 readonly allowDestructiveAutoMigrate: boolean;
@@ -132,15 +151,19 @@ export function $initializeCoderServerCommand(program: Program): $side_effect {
                 isAgentRequired: !dryRun,
             });
 
-            // [1] Parse the --wait and --no-auto options (same logic as `coder run`)
+            // [1] Parse the wait options and --no-auto (same logic as `coder run`)
             const waitForUser = !auto;
-            const waitBetweenPrompts = typeof wait === 'string' && wait !== '' ? parseDuration(wait) : 0;
+            const waitAfterPrompt = parseOptionalWaitDuration(waitAfterPromptValue, 0);
+            const waitBetweenPrompts = parseOptionalWaitDuration(waitBetweenPromptsValue, 0);
+            const waitAfterError = parseOptionalWaitDuration(waitAfterErrorValue, DEFAULT_WAIT_AFTER_ERROR_MS);
 
             const runOptions = {
                 port,
                 dryRun,
                 waitForUser,
+                waitAfterPrompt,
                 waitBetweenPrompts,
+                waitAfterError,
                 noCommit: runnerOptions.noCommit,
                 ignoreGitChanges: runnerOptions.ignoreGitChanges,
                 agentName: runnerOptions.agentName,

package/src/cli/cli-commands/coder/waitOptions.ts

@@ -0,0 +1,24 @@
+import { parseDuration } from '../../../../scripts/run-codex-prompts/common/parseDuration';
+
+/**
+ * Default wait duration applied before retrying a prompt round after an error (10 minutes).
+ *
+ * @private internal constant of `ptbk coder` wait handling
+ */
+export const DEFAULT_WAIT_AFTER_ERROR_MS = 10 * 60 * 1000;
+
+/**
+ * Parses an optional Commander duration string and returns the resolved milliseconds.
+ *
+ * Returns `defaultMs` when the flag was not provided or was provided without a non-empty value.
+ *
+ * @private internal utility of `ptbk coder` wait handling
+ */
+export function parseOptionalWaitDuration(value: string | undefined, defaultMs: number): number {
+    if (typeof value !== 'string' || value === '') {
+        return defaultMs;
+    }
+    return parseDuration(value);
+}
+
+// Note: [💞] Ignore a discrepancy between file name and entity name