@promptbook/cli 0.112.0-113 → 0.112.0-115

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

@@ -0,0 +1,4 @@
+/**
+ * Prints one live shell output chunk to the terminal when console mirroring is enabled.
+ */
+export declare function printLiveScriptChunk(chunk: string, source: 'stdout' | 'stderr', shouldPrintLiveOutput: boolean): void;

package/esm/src/cli/cli-commands/agent/agentCliOptions.d.ts

@@ -1,3 +1,4 @@
+import type { Command as Program } from 'commander';
 import type { NormalizedPromptRunnerSelectionCliOptions, PromptRunnerSelectionCliOptions } from '../common/promptRunnerCliOptions';
 /**
  * Commander option bag shared by `ptbk agent` subcommands.
@@ -9,12 +10,20 @@ export type AgentCommandCliOptions = PromptRunnerSelectionCliOptions & {
     readonly context?: string;
     readonly message?: string;
 };
+/**
+ * Normalized shared options used by local `ptbk agent` subcommands.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+export type NormalizedAgentCommandRunnerOptions = NormalizedPromptRunnerSelectionCliOptions & {
+    readonly isVerbose: boolean;
+};
 /**
  * Normalizes shared runner flags for local agent subcommands.
  *
  * @private internal utility of `ptbk agent`
  */
-export declare function normalizeAgentCommandRunnerOptions(cliOptions: AgentCommandCliOptions): NormalizedPromptRunnerSelectionCliOptions;
+export declare function normalizeAgentCommandRunnerOptions(cliOptions: AgentCommandCliOptions, command: Program): NormalizedAgentCommandRunnerOptions;
 /**
  * Returns the required agent book path from Commander options.
  *

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

package/package.json

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

package/src/book-3.0/LiteAgent.ts

@@ -1,4 +1,10 @@
-import { Agent as AgentFromKit, fileSearchTool, run, setDefaultOpenAIClient, setDefaultOpenAIKey } from '@openai/agents';
+import {
+    Agent as AgentFromKit,
+    fileSearchTool,
+    run,
+    setDefaultOpenAIClient,
+    setDefaultOpenAIKey,
+} from '@openai/agents';
 import { readFile } from 'fs/promises';
 import { basename, resolve } from 'path';
 import { fileURLToPath } from 'url';
@@ -108,11 +114,7 @@ export class LiteAgent {
 
         const result = await run(
             preparedAgent.agent,
-            createLiteAgentPromptText(
-                normalizedMessage,
-                options.context,
-                preparedAgent.modelRequirements.promptSuffix,
-            ),
+            createLiteAgentPromptText(normalizedMessage, options.context, preparedAgent.modelRequirements.promptSuffix),
             options.signal ? { signal: options.signal } : undefined,
         );
 
@@ -187,9 +189,10 @@ export class LiteAgent {
                       agentKitModelName: resolvedModelName,
                   })
                 : null;
-        const agentTools = toolBuilder?.buildAgentKitTools({
-            tools: modelRequirements.tools ? [...modelRequirements.tools] : undefined,
-        }) || [];
+        const agentTools =
+            toolBuilder?.buildAgentKitTools({
+                tools: modelRequirements.tools ? [...modelRequirements.tools] : undefined,
+            }) || [];
         const normalizedKnowledgeSources = await normalizeLiteAgentKnowledgeSources(
             modelRequirements.knowledgeSources || [],
             resolvedSource.sourceDirectoryPath,
@@ -427,7 +430,9 @@ async function convertLiteAgentLocalKnowledgeSourceToDataUrl(
     const fileName = basename(absolutePath);
     const mimeType = resolveLiteAgentKnowledgeSourceMimeType(fileName);
 
-    return `data:${mimeType};name=${encodeURIComponent(fileName)};base64,${fileContent.toString('base64')}` as string_knowledge_source_link;
+    return `data:${mimeType};name=${encodeURIComponent(fileName)};base64,${fileContent.toString(
+        'base64',
+    )}` as string_knowledge_source_link;
 }
 
 /**

package/src/cli/cli-commands/agent/agentCliOptions.ts

@@ -1,3 +1,6 @@
+import type {
+    Command as Program /* <- Note: [🔸] Using Program because Command is misleading name */,
+} from 'commander';
 import { NotAllowed } from '../../../errors/NotAllowed';
 import type {
     NormalizedPromptRunnerSelectionCliOptions,
@@ -16,6 +19,15 @@ export type AgentCommandCliOptions = PromptRunnerSelectionCliOptions & {
     readonly message?: string;
 };
 
+/**
+ * Normalized shared options used by local `ptbk agent` subcommands.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+export type NormalizedAgentCommandRunnerOptions = NormalizedPromptRunnerSelectionCliOptions & {
+    readonly isVerbose: boolean;
+};
+
 /**
  * Normalizes shared runner flags for local agent subcommands.
  *
@@ -23,10 +35,14 @@ export type AgentCommandCliOptions = PromptRunnerSelectionCliOptions & {
  */
 export function normalizeAgentCommandRunnerOptions(
     cliOptions: AgentCommandCliOptions,
-): NormalizedPromptRunnerSelectionCliOptions {
-    return normalizePromptRunnerSelectionCliOptions(cliOptions, {
-        isAgentRequired: true,
-    });
+    command: Program,
+): NormalizedAgentCommandRunnerOptions {
+    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`
@@ -61,3 +77,16 @@ export function resolveRequiredAgentMessage(cliOptions: AgentCommandCliOptions):
 
     return message;
 }
+
+/**
+ * Resolves the inherited `--verbose` flag from the current Commander command chain.
+ *
+ * @private internal utility of `ptbk agent`
+ */
+function resolveCommandVerboseOption(command: Program): boolean {
+    const globalOptions = command.optsWithGlobals() as {
+        readonly verbose?: boolean;
+    };
+
+    return globalOptions.verbose ?? false;
+}

package/src/cli/cli-commands/agent/chat.ts

@@ -35,9 +35,9 @@ export function $initializeAgentChatCommand(program: Program): $side_effect {
     command.option('--context <context-or-file>', 'Append extra context either inline or from a file path');
 
     command.action(
-        handleActionErrors(async (cliOptions) => {
+        handleActionErrors(async (cliOptions, commandProgram) => {
             const options = cliOptions as AgentCommandCliOptions;
-            const runnerOptions = normalizeAgentCommandRunnerOptions(options);
+            const runnerOptions = normalizeAgentCommandRunnerOptions(options, commandProgram as Program);
             const { runAgentChat } = await import('../../../../scripts/run-agent-chat/runAgentChat');
 
             await runAgentChat({

package/src/cli/cli-commands/agent/exec.ts

@@ -40,9 +40,9 @@ export function $initializeAgentExecCommand(program: Program): $side_effect {
     command.option('--context <context-or-file>', 'Append extra context either inline or from a file path');
 
     command.action(
-        handleActionErrors(async (cliOptions) => {
+        handleActionErrors(async (cliOptions, commandProgram) => {
             const options = cliOptions as AgentCommandCliOptions;
-            const runnerOptions = normalizeAgentCommandRunnerOptions(options);
+            const runnerOptions = normalizeAgentCommandRunnerOptions(options, commandProgram as Program);
             const { runAgentExec } = await import('../../../../scripts/run-agent-chat/runAgentExec');
 
             await runAgentExec({

package/src/cli/cli-commands/agent.ts

@@ -42,4 +42,3 @@ export function $initializeAgentCommand(program: Program): $side_effect {
 
 // 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
-