@promptbook/cli 0.112.0-91 → 0.112.0-93

package/src/version.ts

@@ -16,11 +16,11 @@ export const BOOK_LANGUAGE_VERSION: string_semantic_version = '2.0.0';
  * @generated
  * @see https://github.com/webgptorg/promptbook
  */
-export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-91';
+export const PROMPTBOOK_ENGINE_VERSION: string_promptbook_version = '0.112.0-93';
 
 /**
  * Represents the version string of the Promptbook engine.
- * It follows semantic versioning (e.g., `0.112.0-90`).
+ * It follows semantic versioning (e.g., `0.112.0-92`).
  *
  * @generated
  */

package/src/versions.txt

@@ -1127,4 +1127,5 @@
 0.112.0-88
 0.112.0-89
 0.112.0-90
-0.112.0-91
+0.112.0-92
+0.112.0-93

package/umd/index.umd.js

@@ -60,7 +60,7 @@
      * @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
@@ -1721,51 +1721,51 @@
     // 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 = 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 = 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 = 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.spaceTrim(`
@@ -1782,7 +1782,7 @@
     /**
      * 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.spaceTrim(`
@@ -1810,10 +1810,10 @@
         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
 
     /**
@@ -1872,7 +1872,7 @@
     /**
      * 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);
@@ -1892,12 +1892,12 @@
             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__default["default"].green('Promptbook agent configuration initialized.'));
@@ -1927,10 +1927,10 @@
     function printInitializationStatusLine$2(relativePath, status) {
         console.info(colors__default["default"].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.
      *
@@ -1954,7 +1954,7 @@
             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
 
     /**
@@ -2132,7 +2132,7 @@
     /**
      * 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, {
@@ -2147,19 +2147,19 @@
     /**
      * 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;
@@ -2184,7 +2184,7 @@
             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);
@@ -2205,11 +2205,11 @@
             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.
      *
@@ -2236,11 +2236,11 @@
             },
         });
     }
-    // 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.
      *
@@ -2266,11 +2266,11 @@
             },
         });
     }
-    // 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.
      *
@@ -2295,13 +2295,13 @@
             },
         });
     }
-    // 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
@@ -2311,9 +2311,9 @@
      *
      * @private internal function of `promptbookCli`
      */
-    function $initializeAgentCommand(program) {
-        const agentCommand = program.command('agent');
-        agentCommand.description(_spaceTrim.spaceTrim(`
+    function $initializeAgentFolderCommand(program) {
+        const agentFolderCommand = program.command('agent-folder');
+        agentFolderCommand.description(_spaceTrim.spaceTrim(`
             Non-coding agent utilities backed by repository message files
 
             Subcommands:
@@ -2322,17 +2322,17 @@
             - 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__default["default"].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
 
     /**
@@ -4828,7 +4828,7 @@
     // 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 {
@@ -5676,7 +5676,7 @@
         throw new NotAllowed(_spaceTrim.spaceTrim(`
             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:
@@ -33345,9 +33345,9 @@
                 \`\`\`
 
                 ### 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.
             `));
     }
     /**
@@ -34525,7 +34525,7 @@
     }
 
     /**
-     * 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';
 
@@ -34558,7 +34558,7 @@
      */
     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));
@@ -34731,7 +34731,7 @@
         };
     }
     /**
-     * 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 || '');
@@ -35065,7 +35065,7 @@
     }
 
     /**
-     * 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) {
@@ -35192,7 +35192,7 @@
     }
 
     /**
-     * Validates cross-flag constraints for `ptbk agent` runs.
+     * Validates cross-flag constraints for `ptbk agent-folder` runs.
      */
     function validateAgentRunOptions(options) {
         if (!options.agentName) {
@@ -35527,7 +35527,7 @@
     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);
@@ -35628,7 +35628,7 @@
                         continue;
                     }
                     await handleAgentWatchError({
-                        commandDisplayName: 'ptbk agent run-multiple',
+                        commandDisplayName: 'ptbk agent-folder run-multiple',
                         logDirectoryPath: controls.watchErrorLogDirectoryPath || rootPath,
                         error: tickResult.reason,
                     });
@@ -35636,7 +35636,7 @@
             }
             catch (error) {
                 await handleAgentWatchError({
-                    commandDisplayName: 'ptbk agent run-multiple',
+                    commandDisplayName: 'ptbk agent-folder run-multiple',
                     logDirectoryPath: controls.watchErrorLogDirectoryPath || rootPath,
                     error,
                 });
@@ -51073,7 +51073,7 @@
         $initializeListScrapersCommand(program);
         $initializeStartAgentsServerCommand(program);
         $initializeStartPipelinesServerCommand(program);
-        $initializeAgentCommand(program);
+        $initializeAgentFolderCommand(program);
         $initializeAgentsServerCommand(program);
         $initializeCoderCommand(program);
         $deprecateTopLevelCommands(program);
@@ -61171,7 +61171,7 @@
     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));
@@ -61202,7 +61202,7 @@
             }
             catch (error) {
                 await handleAgentWatchError({
-                    commandDisplayName: 'ptbk agent run-agent',
+                    commandDisplayName: 'ptbk agent-folder run-agent',
                     logDirectoryPath: projectPath,
                     error,
                 });