@promptbook/cli 0.112.0-113 → 0.112.0-114

package/esm/index.es.js

@@ -58,7 +58,7 @@ const BOOK_LANGUAGE_VERSION = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-const PROMPTBOOK_ENGINE_VERSION = '0.112.0-113';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-114';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1908,10 +1908,13 @@ class NotAllowed extends Error {
  *
  * @private internal utility of `ptbk agent`
  */
-function normalizeAgentCommandRunnerOptions(cliOptions) {
-    return normalizePromptRunnerSelectionCliOptions(cliOptions, {
-        isAgentRequired: true,
-    });
+function normalizeAgentCommandRunnerOptions(cliOptions, command) {
+    return {
+        ...normalizePromptRunnerSelectionCliOptions(cliOptions, {
+            isAgentRequired: true,
+        }),
+        isVerbose: resolveCommandVerboseOption(command),
+    };
 }
 // Note: [🟡] Code for CLI command options [agent](src/cli/cli-commands/agent/agentCliOptions.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and exported helper names
@@ -1941,6 +1944,16 @@ function resolveRequiredAgentMessage(cliOptions) {
     }
     return message;
 }
+/**
+ * Resolves the inherited `--verbose` flag from the current Commander command chain.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+function resolveCommandVerboseOption(command) {
+    var _a;
+    const globalOptions = command.optsWithGlobals();
+    return (_a = globalOptions.verbose) !== null && _a !== void 0 ? _a : false;
+}
 
 /**
  * Initializes `agent chat` command for Promptbook CLI utilities.
@@ -1960,9 +1973,9 @@ function $initializeAgentChatCommand(program) {
     addPromptRunnerSelectionOptions(command);
     addPromptRunnerRuntimeOptions(command);
     command.option('--context <context-or-file>', 'Append extra context either inline or from a file path');
-    command.action(handleActionErrors(async (cliOptions) => {
+    command.action(handleActionErrors(async (cliOptions, commandProgram) => {
         const options = cliOptions;
-        const runnerOptions = normalizeAgentCommandRunnerOptions(options);
+        const runnerOptions = normalizeAgentCommandRunnerOptions(options, commandProgram);
         const { runAgentChat } = await Promise.resolve().then(function () { return runAgentChat$1; });
         await runAgentChat({
             agentPath: resolveRequiredAgentPath(options),
@@ -1994,9 +2007,9 @@ function $initializeAgentExecCommand(program) {
     addPromptRunnerSelectionOptions(command);
     addPromptRunnerRuntimeOptions(command);
     command.option('--context <context-or-file>', 'Append extra context either inline or from a file path');
-    command.action(handleActionErrors(async (cliOptions) => {
+    command.action(handleActionErrors(async (cliOptions, commandProgram) => {
         const options = cliOptions;
-        const runnerOptions = normalizeAgentCommandRunnerOptions(options);
+        const runnerOptions = normalizeAgentCommandRunnerOptions(options, commandProgram);
         const { runAgentExec } = await Promise.resolve().then(function () { return runAgentExec$1; });
         await runAgentExec({
             agentPath: resolveRequiredAgentPath(options),
@@ -26935,13 +26948,31 @@ function describeTempScriptKind(scriptPath) {
     return scriptPath.toLowerCase().endsWith('.test.sh') ? 'test shell' : 'runner shell';
 }
 
+/**
+ * Prints one live shell output chunk to the terminal when console mirroring is enabled.
+ */
+function printLiveScriptChunk(chunk, source, shouldPrintLiveOutput) {
+    if (!shouldPrintLiveOutput) {
+        return;
+    }
+    if (source === 'stderr') {
+        if (chunk.trim()) {
+            console.warn(chunk);
+        }
+        return;
+    }
+    console.info(chunk);
+}
+
 /**
  * Runs one temporary bash script, optionally mirroring its raw input/output into a live runtime log file.
  */
 async function runBashScriptWithOutput(options) {
+    var _a;
     await appendScriptExecutionLogStart(options);
     const bashExecution = buildLoggedBashExecution(options.scriptPath, options.logPath);
     const scriptPathPosix = toPosixPath(options.scriptPath);
+    const shouldPrintLiveOutput = (_a = options.shouldPrintLiveOutput) !== null && _a !== void 0 ? _a : true;
     return await new Promise((resolve, reject) => {
         const commandProcess = spawn('bash', bashExecution.args, {
             env: bashExecution.env ? { ...process.env, ...bashExecution.env } : process.env,
@@ -26985,14 +27016,12 @@ async function runBashScriptWithOutput(options) {
         commandProcess.stdout.on('data', (stdout) => {
             const chunk = stdout.toString();
             output += chunk;
-            console.info(chunk);
+            printLiveScriptChunk(chunk, 'stdout', shouldPrintLiveOutput);
         });
         commandProcess.stderr.on('data', (stderr) => {
             const chunk = stderr.toString();
             output += chunk;
-            if (chunk.trim()) {
-                console.warn(chunk);
-            }
+            printLiveScriptChunk(chunk, 'stderr', shouldPrintLiveOutput);
         });
         /**
          * Handles process exit and resolves or rejects accordingly.
@@ -27212,6 +27241,7 @@ class ClaudeCodeRunner {
             scriptPath: options.scriptPath,
             scriptContent,
             logPath: options.logPath,
+            shouldPrintLiveOutput: options.shouldPrintLiveOutput,
             preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         const usage = parseClaudeCodeJsonOutput(output);
@@ -27276,6 +27306,7 @@ class ClineRunner {
                 scriptPath: options.scriptPath,
                 scriptContent,
                 logPath: options.logPath,
+                shouldPrintLiveOutput: options.shouldPrintLiveOutput,
                 preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
             return { usage: UNCERTAIN_USAGE };
@@ -27419,6 +27450,7 @@ class GeminiRunner {
             scriptPath: options.scriptPath,
             scriptContent,
             logPath: options.logPath,
+            shouldPrintLiveOutput: options.shouldPrintLiveOutput,
             preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
         });
         const usage = parseGeminiUsageFromOutput(output, options.prompt, this.options.model);
@@ -27486,6 +27518,7 @@ class GitHubCopilotRunner {
                 scriptPath: options.scriptPath,
                 scriptContent,
                 logPath: options.logPath,
+                shouldPrintLiveOutput: options.shouldPrintLiveOutput,
                 preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
         }
@@ -27559,8 +27592,10 @@ function buildCommandFailureMessage(scriptPathPosix, code, fullOutput) {
  * Returns the captured output.
  */
 async function runScriptUntilMarkerIdle(options) {
+    var _a;
     const { scriptPath, completionLineMatcher, idleTimeoutMs } = options;
     const scriptPathPosix = toPosixPath(scriptPath);
+    const shouldPrintLiveOutput = (_a = options.shouldPrintLiveOutput) !== null && _a !== void 0 ? _a : true;
     await appendScriptExecutionLogStart(options);
     const bashExecution = buildLoggedBashExecution(scriptPath, options.logPath);
     return await new Promise((resolve, reject) => {
@@ -27644,14 +27679,7 @@ async function runScriptUntilMarkerIdle(options) {
         const handleChunk = (chunk, source) => {
             var _a, _b;
             fullOutput += chunk;
-            if (source === 'stderr') {
-                if (chunk.trim()) {
-                    console.warn(chunk);
-                }
-            }
-            else {
-                console.info(chunk);
-            }
+            printLiveScriptChunk(chunk, source, shouldPrintLiveOutput);
             if (source === 'stdout') {
                 stdoutBuffer += chunk;
                 const lines = stdoutBuffer.split(/\r?\n/);
@@ -27711,6 +27739,7 @@ async function $runGoScriptUntilMarkerIdle(options) {
             completionLineMatcher: options.completionLineMatcher,
             idleTimeoutMs: options.idleTimeoutMs,
             logPath: options.logPath,
+            shouldPrintLiveOutput: options.shouldPrintLiveOutput,
         });
     });
 }
@@ -28117,7 +28146,7 @@ class OpenAiCodexRunner {
      * Runs the Codex prompt in a temporary script and waits for completion output.
      */
     async runPrompt(options) {
-        var _a;
+        var _a, _b;
         const scriptContent = buildCodexScript({
             prompt: options.prompt,
             projectPath: options.projectPath,
@@ -28143,6 +28172,7 @@ class OpenAiCodexRunner {
                     completionLineMatcher: CODEX_COMPLETION_LINE,
                     idleTimeoutMs: CODEX_COMPLETION_IDLE_MS,
                     logPath: options.logPath,
+                    shouldPrintLiveOutput: options.shouldPrintLiveOutput,
                     preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
                 });
                 this.rateLimitBackoff.reset();
@@ -28161,7 +28191,9 @@ class OpenAiCodexRunner {
                 const retryAt = new Date(Date.now() + delayMs).toISOString();
                 const retryIndex = this.rateLimitBackoff.retryCount;
                 const summary = extractFailureSummary(details);
-                console.warn(colors.yellow(`[codex] Rate limit/quota detected (${summary}). Retry #${retryIndex} in ${formatDelay(delayMs)} at ${retryAt}.`));
+                if ((_b = options.shouldPrintLiveOutput) !== null && _b !== void 0 ? _b : true) {
+                    console.warn(colors.yellow(`[codex] Rate limit/quota detected (${summary}). Retry #${retryIndex} in ${formatDelay(delayMs)} at ${retryAt}.`));
+                }
                 await waitForRetryDelay(delayMs, options);
             }
         }
@@ -28296,6 +28328,7 @@ class OpencodeRunner {
                 scriptPath: options.scriptPath,
                 scriptContent,
                 logPath: options.logPath,
+                shouldPrintLiveOutput: options.shouldPrintLiveOutput,
                 preserveArtifactsOnSuccess: options.preserveArtifactsOnSuccess,
             });
         }
@@ -62656,6 +62689,7 @@ async function executeAgentChatTurn(options) {
             scriptPath,
             projectPath: workspacePath,
             logPath,
+            shouldPrintLiveOutput: options.isVerbose,
             preserveArtifactsOnSuccess: false,
         });
     }, { preserveArtifactsOnSuccess: false });
@@ -62822,7 +62856,9 @@ async function runAgentChat(options) {
         agentPath: options.agentPath,
     });
     const messages = [];
-    console.info(colors.gray('Type "exit" or "quit" to end the chat.'));
+    if (options.isVerbose) {
+        console.info(colors.gray('Type "exit" or "quit" to end the chat.'));
+    }
     while (true) {
         const response = await prompts({
             type: 'text',