@promptbook/cli 0.112.0-91 → 0.112.0-93

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-91';
+const PROMPTBOOK_ENGINE_VERSION = '0.112.0-93';
 /**
  * TODO: string_promptbook_version should be constrained to the all versions of Promptbook engine
  * Note: [💞] Ignore a discrepancy between file name and entity name
@@ -1719,51 +1719,51 @@ function $initializeAboutCommand(program) {
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Relative path to the local agent source initialized by `ptbk agent init`.
+ * Relative path to the local agent source initialized by `ptbk agent-folder init`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_BOOK_FILE_PATH = 'agent.book';
 /**
- * Relative path to local knowledge files initialized by `ptbk agent init`.
+ * Relative path to local knowledge files initialized by `ptbk agent-folder init`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_KNOWLEDGE_DIRECTORY_PATH = 'knowledge';
 /**
- * Relative path to the message queue root initialized by `ptbk agent init`.
+ * Relative path to the message queue root initialized by `ptbk agent-folder init`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_MESSAGES_DIRECTORY_PATH = 'messages';
 /**
- * Relative path to queued user messages consumed by `ptbk agent run-once`.
+ * Relative path to queued user messages consumed by `ptbk agent-folder run-once`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_QUEUED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'queued');
 /**
- * Relative path to answered messages written by `ptbk agent run-once`.
+ * Relative path to answered messages written by `ptbk agent-folder run-once`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_FINISHED_MESSAGES_DIRECTORY_PATH = join(AGENT_MESSAGES_DIRECTORY_PATH, 'finished');
 /**
- * Relative path to generated local agent documentation initialized by `ptbk agent init`.
+ * Relative path to generated local agent documentation initialized by `ptbk agent-folder init`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_DOCS_DIRECTORY_PATH = 'docs';
 /**
- * Relative path to the local Book language manual initialized by `ptbk agent init`.
+ * Relative path to the local Book language manual initialized by `ptbk agent-folder init`.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 const AGENT_BOOK_LANGUAGE_MANUAL_FILE_PATH = join(AGENT_DOCS_DIRECTORY_PATH, 'book-language-manual.md');
 /**
  * Returns the default local agent book content.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 function getDefaultAgentBookContent() {
     return spaceTrim$1(`
@@ -1780,7 +1780,7 @@ function getDefaultAgentBookContent() {
 /**
  * Returns the default local Book language manual content.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 function getDefaultBookLanguageManualContent() {
     return spaceTrim$1(`
@@ -1808,10 +1808,10 @@ function getDefaultBookLanguageManualContent() {
         CLOSED
         \`\`\`
 
-        For \`ptbk agent\`, the CLI compiles \`agent.book\` into the coding-runner instructions, and the runner edits only the queued message file by appending an answer that starts with \`MESSAGE @Agent\`.
+        For \`ptbk agent-folder\`, the CLI compiles \`agent.book\` into the coding-runner instructions, and the runner edits only the queued message file by appending an answer that starts with \`MESSAGE @Agent\`.
     `);
 }
-// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent/agentProjectPaths.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent-folder/agentProjectPaths.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and exported helper names
 
 /**
@@ -1870,7 +1870,7 @@ async function isExistingDirectory(path) {
 /**
  * Creates local agent queue, knowledge, and instruction files in the current project.
  *
- * @private internal utility of `ptbk agent init`
+ * @private internal utility of `ptbk agent-folder init`
  */
 async function initializeAgentProjectConfiguration(projectPath) {
     const messagesDirectoryStatus = await ensureDirectory(projectPath, AGENT_MESSAGES_DIRECTORY_PATH);
@@ -1890,12 +1890,12 @@ async function initializeAgentProjectConfiguration(projectPath) {
         bookLanguageManualFileStatus,
     };
 }
-// Note: [🟡] Code for CLI command [agent init](src/cli/cli-commands/agent/initializeAgentProjectConfiguration.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent init](src/cli/cli-commands/agent-folder/initializeAgentProjectConfiguration.ts) should never be published outside of `@promptbook/cli`
 
 /**
  * Prints a readable summary of initialized local agent files.
  *
- * @private internal utility of `ptbk agent init`
+ * @private internal utility of `ptbk agent-folder init`
  */
 function printAgentInitializationSummary(summary) {
     console.info(colors.green('Promptbook agent configuration initialized.'));
@@ -1925,10 +1925,10 @@ function formatInitializationStatus$2(status) {
 function printInitializationStatusLine$2(relativePath, status) {
     console.info(colors.gray(`✔ ${relativePath.replace(/\\/gu, '/')}: ${formatInitializationStatus$2(status)}`));
 }
-// Note: [🟡] Code for CLI command [agent init](src/cli/cli-commands/agent/printAgentInitializationSummary.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent init](src/cli/cli-commands/agent-folder/printAgentInitializationSummary.ts) should never be published outside of `@promptbook/cli`
 
 /**
- * Initializes `agent init` command for Promptbook CLI utilities.
+ * Initializes `agent-folder init` command for Promptbook CLI utilities.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
  *
@@ -1952,7 +1952,7 @@ function $initializeAgentInitCommand(program) {
         printAgentInitializationSummary(summary);
     }));
 }
-// Note: [🟡] Code for CLI command [init](src/cli/cli-commands/agent/init.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [init](src/cli/cli-commands/agent-folder/init.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
@@ -2130,7 +2130,7 @@ function isPromptRunnerAgentName(agent) {
 /**
  * Converts Commander options into the `scripts/run-agent-messages` option shape.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 function createAgentRunOptionsFromCliOptions(cliOptions) {
     const runnerOptions = normalizePromptRunnerCliOptions(cliOptions, {
@@ -2145,19 +2145,19 @@ function createAgentRunOptionsFromCliOptions(cliOptions) {
 /**
  * Normalizes one or more `--ignore` option values into a stable pattern list.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 function normalizeAgentIgnorePatterns(ignore) {
     const patterns = Array.isArray(ignore) ? ignore : ignore ? [ignore] : [];
     return patterns.map((pattern) => pattern.trim()).filter((pattern) => pattern.length > 0);
 }
-// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent/agentRunCliOptions.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent-folder/agentRunCliOptions.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and exported helper names
 
 /**
- * Registers one runner-backed `ptbk agent` subcommand with the shared option and error handling flow.
+ * Registers one runner-backed `ptbk agent-folder` subcommand with the shared option and error handling flow.
  *
- * @private internal utility of `ptbk agent`
+ * @private internal utility of `ptbk agent-folder`
  */
 function $initializeAgentRunnerCommand(program, options) {
     var _a;
@@ -2182,7 +2182,7 @@ function $initializeAgentRunnerCommand(program, options) {
         if (options.executionMode === 'watch') {
             const { runPersistentAgentWatch } = await Promise.resolve().then(function () { return runPersistentAgentWatch$1; });
             await runPersistentAgentWatch({
-                commandDisplayName: `ptbk agent ${options.commandName}`,
+                commandDisplayName: `ptbk agent-folder ${options.commandName}`,
                 logDirectoryPath: process.cwd(),
                 runWatch: async () => {
                     await execute(runOptions);
@@ -2203,11 +2203,11 @@ function $initializeAgentRunnerCommand(program, options) {
         isExitingOnSuccess: options.executionMode === 'once',
     }));
 }
-// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent/initializeAgentRunnerCommand.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent-folder/initializeAgentRunnerCommand.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Initializes `agent run-multiple` command for Promptbook CLI utilities.
+ * Initializes `agent-folder run-multiple` command for Promptbook CLI utilities.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
  *
@@ -2234,11 +2234,11 @@ function $initializeAgentRunMultipleCommand(program) {
         },
     });
 }
-// Note: [🟡] Code for CLI command [run-multiple](src/cli/cli-commands/agent/runMultiple.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [run-multiple](src/cli/cli-commands/agent-folder/runMultiple.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Initializes `agent run` command for Promptbook CLI utilities.
+ * Initializes `agent-folder run` command for Promptbook CLI utilities.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
  *
@@ -2264,11 +2264,11 @@ function $initializeAgentRunCommand(program) {
         },
     });
 }
-// Note: [🟡] Code for CLI command [run](src/cli/cli-commands/agent/run.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [run](src/cli/cli-commands/agent-folder/run.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Initializes `agent tick` command for Promptbook CLI utilities.
+ * Initializes `agent-folder tick` command for Promptbook CLI utilities.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it registers a command in the CLI.
  *
@@ -2293,13 +2293,13 @@ function $initializeAgentTickCommand(program) {
         },
     });
 }
-// Note: [🟡] Code for CLI command [tick](src/cli/cli-commands/agent/tick.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [tick](src/cli/cli-commands/agent-folder/tick.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Initializes `agent` command with subcommands for Promptbook CLI utilities.
+ * Initializes `agent-folder` command with subcommands for Promptbook CLI utilities.
  *
- * The agent command provides utilities for repository-backed message queues:
+ * The agent-folder command provides utilities for repository-backed message queues:
  * - init: Initialize local agent queue and instruction files
  * - run-once (alias: tick): Answer one queued message and exit
  * - run-agent (alias: run): Watch one queue and answer messages one by one
@@ -2309,9 +2309,9 @@ function $initializeAgentTickCommand(program) {
  *
  * @private internal function of `promptbookCli`
  */
-function $initializeAgentCommand(program) {
-    const agentCommand = program.command('agent');
-    agentCommand.description(spaceTrim$1(`
+function $initializeAgentFolderCommand(program) {
+    const agentFolderCommand = program.command('agent-folder');
+    agentFolderCommand.description(spaceTrim$1(`
             Non-coding agent utilities backed by repository message files
 
             Subcommands:
@@ -2320,17 +2320,17 @@ function $initializeAgentCommand(program) {
             - run-agent (alias: run): Watch one queue and answer messages one by one
             - run-multiple: Watch direct child agent repositories in one shared session
         `));
-    $initializeAgentInitCommand(agentCommand);
-    $initializeAgentTickCommand(agentCommand);
-    $initializeAgentRunCommand(agentCommand);
-    $initializeAgentRunMultipleCommand(agentCommand);
-    agentCommand.action(() => {
+    $initializeAgentInitCommand(agentFolderCommand);
+    $initializeAgentTickCommand(agentFolderCommand);
+    $initializeAgentRunCommand(agentFolderCommand);
+    $initializeAgentRunMultipleCommand(agentFolderCommand);
+    agentFolderCommand.action(() => {
         console.info(colors.yellow('Please specify a subcommand.'));
         console.info('');
-        agentCommand.help();
+        agentFolderCommand.help();
     });
 }
-// Note: [🟡] Code for CLI command [agent](src/cli/cli-commands/agent.ts) should never be published outside of `@promptbook/cli`
+// Note: [🟡] Code for CLI command [agent-folder](src/cli/cli-commands/agent-folder.ts) should never be published outside of `@promptbook/cli`
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
@@ -4826,7 +4826,7 @@ function renderCoderRunUi(startTime, options = {}) {
 // Note: [💞] Ignore a discrepancy between file name and entity name
 
 /**
- * Converts `ptbk agent` options into the shared runner option shape.
+ * Converts `ptbk agent-folder` options into the shared runner option shape.
  */
 function createCoderRunOptionsForAgent(options) {
     return {
@@ -5674,7 +5674,7 @@ async function ensureWorkingTreeCleanForAgentQueue(projectPath) {
     throw new NotAllowed(spaceTrim$1(`
             Git working tree has changes outside of \`${normalizeGitPath(AGENT_QUEUED_MESSAGES_DIRECTORY_PATH)}/\`.
 
-            Please commit or stash unrelated changes before running \`ptbk agent\`
+            Please commit or stash unrelated changes before running \`ptbk agent-folder\`
             OR run with \`--ignore-git-changes\`.
 
             Unrelated changed files:
@@ -33343,9 +33343,9 @@ function normalizeGitHubCopilotRunnerError(error) {
                 \`\`\`
 
                 ### What to check
-                - Update to the newest \`ptbk\` package so \`ptbk agent run\` uses the compiled agent-system-message prompt shape.
+                - Update to the newest \`ptbk\` package so \`ptbk agent-folder run\` uses the compiled agent-system-message prompt shape.
                 - Keep the local agent instructions in \`agent.book\` reasonably compact.
-                - If needed, compare with the local source runner (\`ts-node src/cli/test/ptbk.ts agent run ...\`), which bypasses stale published bundles.
+                - If needed, compare with the local source runner (\`ts-node src/cli/test/ptbk.ts agent-folder run ...\`), which bypasses stale published bundles.
             `));
 }
 /**
@@ -34523,7 +34523,7 @@ function normalizeAgentBannerName(agentName) {
 }
 
 /**
- * Shared idle placeholder rendered in the rich `ptbk agent` terminal UI.
+ * Shared idle placeholder rendered in the rich `ptbk agent-folder` terminal UI.
  */
 const WAITING_FOR_MESSAGE_LABEL = 'Waiting for the message';
 
@@ -34556,7 +34556,7 @@ const MAX_AGENT_URL_COLUMN_WIDTH = 30;
  */
 const AGENT_URL_COLUMN_RATIO = 0.38;
 /**
- * Builds the complete boxed terminal frame for the rich `ptbk agent run` UI.
+ * Builds the complete boxed terminal frame for the rich `ptbk agent-folder run` UI.
  */
 function buildAgentRunUiFrame(options) {
     const totalWidth = Math.max(MIN_FRAME_WIDTH, Math.min(options.terminalWidth, MAX_FRAME_WIDTH));
@@ -34729,7 +34729,7 @@ function countAgentStatuses(options) {
     };
 }
 /**
- * Parses the multi-agent session label used by `ptbk agent run-multiple`.
+ * Parses the multi-agent session label used by `ptbk agent-folder run-multiple`.
  */
 function parseMultiAgentSessionCount(localAgentName) {
     const match = /^(\d+) Agents?(?:\s+·\s+\d+ ignored)?$/u.exec(localAgentName || '');
@@ -35063,7 +35063,7 @@ function summarizeUserMessageLines(messageLines) {
 }
 
 /**
- * Creates and seeds the persistent rich terminal UI used by `ptbk agent run`.
+ * Creates and seeds the persistent rich terminal UI used by `ptbk agent-folder run`.
  */
 async function initializeAgentRunUi(projectPath, options, queueSnapshot) {
     if (options.noUi || !process.stdout.isTTY) {
@@ -35190,7 +35190,7 @@ function normalizeAgentWatchError(error) {
 }
 
 /**
- * Validates cross-flag constraints for `ptbk agent` runs.
+ * Validates cross-flag constraints for `ptbk agent-folder` runs.
  */
 function validateAgentRunOptions(options) {
     if (!options.agentName) {
@@ -35525,7 +35525,7 @@ const LEGACY_STATUS_WIDTH = 9;
 async function runMultipleAgentMessages(options, controls = {}) {
     var _a;
     validateAgentRunOptions(options);
-    validateAgentWatchOptions('ptbk agent run-multiple', options);
+    validateAgentWatchOptions('ptbk agent-folder run-multiple', options);
     const rootPath = process.cwd();
     const shouldContinue = controls.shouldContinue || (() => just(true));
     const ignoreMatcher = createAgentIgnoreMatcher(options.ignorePatterns);
@@ -35626,7 +35626,7 @@ async function runMultipleAgentMessages(options, controls = {}) {
                     continue;
                 }
                 await handleAgentWatchError({
-                    commandDisplayName: 'ptbk agent run-multiple',
+                    commandDisplayName: 'ptbk agent-folder run-multiple',
                     logDirectoryPath: controls.watchErrorLogDirectoryPath || rootPath,
                     error: tickResult.reason,
                 });
@@ -35634,7 +35634,7 @@ async function runMultipleAgentMessages(options, controls = {}) {
         }
         catch (error) {
             await handleAgentWatchError({
-                commandDisplayName: 'ptbk agent run-multiple',
+                commandDisplayName: 'ptbk agent-folder run-multiple',
                 logDirectoryPath: controls.watchErrorLogDirectoryPath || rootPath,
                 error,
             });
@@ -51071,7 +51071,7 @@ async function promptbookCli() {
     $initializeListScrapersCommand(program);
     $initializeStartAgentsServerCommand(program);
     $initializeStartPipelinesServerCommand(program);
-    $initializeAgentCommand(program);
+    $initializeAgentFolderCommand(program);
     $initializeAgentsServerCommand(program);
     $initializeCoderCommand(program);
     $deprecateTopLevelCommands(program);
@@ -61169,7 +61169,7 @@ const AGENT_IDLE_AUTO_PULL_INTERVAL_MS = 30000;
 async function runAgentMessages(options, controls = {}) {
     var _a;
     validateAgentRunOptions(options);
-    validateAgentWatchOptions('ptbk agent run-agent', options);
+    validateAgentWatchOptions('ptbk agent-folder run-agent', options);
     const projectPath = process.cwd();
     let autoPullTimestamp = options.autoPull ? Date.now() : undefined;
     const shouldContinue = controls.shouldContinue || (() => just(true));
@@ -61200,7 +61200,7 @@ async function runAgentMessages(options, controls = {}) {
         }
         catch (error) {
             await handleAgentWatchError({
-                commandDisplayName: 'ptbk agent run-agent',
+                commandDisplayName: 'ptbk agent-folder run-agent',
                 logDirectoryPath: projectPath,
                 error,
             });