bdy 1.25.2-stage → 1.25.2

package/distTs/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.2-stage",
+  "version": "1.25.2",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",

package/distTs/src/cliCommand.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const output_1 = __importDefault(require("./output"));
+const cliError_1 = __importDefault(require("./cliError"));
+const texts_1 = require("./texts");
+/** Command documentation shared by terminal help and machine discovery. */
+class CliCommand extends commander_1.Command {
+    agentStatus;
+    agentInstalled;
+    agentId;
+    agentStandalone;
+    currentVersion;
+    latestVersion;
+    env;
+    hideVersionUpdate;
+    agentPort;
+    skipPre = false;
+    defaultErrorFormat = 'text';
+    metadata;
+    constructor(name, metadata = {}) {
+        super(name);
+        this.metadata = metadata;
+    }
+    addOption(option) {
+        if (option.long === '--format' && !option.argChoices) {
+            const choices = option.flags.match(/<([^>]+)>/)?.[1].split('|');
+            if (choices?.every((value) => ['text', 'json', 'jsonl'].includes(value)))
+                option.choices(choices);
+        }
+        return super.addOption(option);
+    }
+    parseOptions(args) {
+        output_1.default.errorFormat = this.defaultErrorFormat;
+        const formatOption = this.options.find((option) => option.long === '--format');
+        if (formatOption && this.defaultErrorFormat === 'text') {
+            // Let Commander handle option syntax without running our parsers, hooks
+            // or actions. Even if a required value is missing, earlier format values
+            // are available before the real parser reports the error.
+            const probe = new commander_1.Command()
+                .exitOverride()
+                .configureOutput({ writeErr: () => { } });
+            for (const option of this.options)
+                probe.option(option.flags);
+            try {
+                probe.parseOptions(args);
+            }
+            catch (err) {
+                if (!(err instanceof commander_1.CommanderError))
+                    throw err;
+            }
+            const format = probe.opts().format;
+            if (formatOption.argChoices?.includes(format) &&
+                (format === 'json' || format === 'jsonl'))
+                output_1.default.errorFormat = format;
+        }
+        this.showSuggestionAfterError(output_1.default.errorFormat === 'text');
+        return super.parseOptions(args);
+    }
+    error(message, options) {
+        if (output_1.default.errorFormat === 'text')
+            return super.error(message, options);
+        const path = [this.name()];
+        for (let command = this.parent; command; command = command.parent)
+            path.unshift(command.name());
+        output_1.default.exitError(new cliError_1.default(options?.code === 'commander.unknownCommand'
+            ? 'unknown_command'
+            : 'usage_error', message.replace(/^error: /, '').trim(), (0, texts_1.TXT_CLI_USAGE_HINT)(path.join(' '))));
+    }
+    get requiredScopes() {
+        return this.metadata.requiredScopes ?? null;
+    }
+    get examples() {
+        return this.metadata.examples ?? [];
+    }
+}
+exports.default = CliCommand;

package/distTs/src/cliError.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class CliError extends Error {
+    code;
+    hint;
+    constructor(code, message, hint = null, options) {
+        super(message, options);
+        this.code = code;
+        this.hint = hint;
+        this.name = 'CliError';
+    }
+    static details(error) {
+        if (error instanceof CliError) {
+            return { code: error.code, message: error.message, hint: error.hint };
+        }
+        const { code, syscall } = error ?? {};
+        const missingFile = code === 'ENOENT' &&
+            [
+                'open',
+                'stat',
+                'lstat',
+                'access',
+                'scandir',
+                'readlink',
+                'realpath',
+            ].includes(syscall ?? '');
+        return {
+            code: missingFile ? 'file_not_found' : 'command_failed',
+            message: error instanceof Error ? error.message : String(error),
+            hint: null,
+        };
+    }
+}
+exports.default = CliError;

package/distTs/src/command/discover.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const discovery_1 = require("../discovery");
+const output_1 = __importDefault(require("../output"));
+const cliError_1 = __importDefault(require("../cliError"));
+const texts_1 = require("../texts");
+const utils_1 = require("../utils");
+const commandDiscover = (0, utils_1.newCommand)('discover', texts_1.DESC_COMMAND_DISCOVER, {
+    requiredScopes: [],
+    examples: texts_1.EXAMPLE_DISCOVER,
+    helpText: texts_1.HELP_COMMAND_DISCOVER,
+});
+commandDiscover.skipPre = true;
+commandDiscover.defaultErrorFormat = 'json';
+commandDiscover.showSuggestionAfterError(false);
+commandDiscover.argument('[command...]', texts_1.OPTION_DISCOVER_COMMAND);
+commandDiscover.option('--full', texts_1.OPTION_DISCOVER_FULL);
+commandDiscover.action((path, options, command) => {
+    const result = (0, discovery_1.discoverCommands)(command.parent, path, (0, utils_1.getVersion)(), options.full);
+    if (result.error) {
+        const { code, message, hint } = result.error;
+        output_1.default.writeError(new cliError_1.default(code, message, hint), 'json');
+        process.exitCode = 1;
+    }
+    else {
+        output_1.default.json(result);
+    }
+});
+exports.default = commandDiscover;

package/distTs/src/command/sandbox/finishExec.js

@@ -0,0 +1,34 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.finishExec = finishExec;
+const output_1 = __importDefault(require("../../output"));
+const utils_1 = require("../../utils");
+const texts_1 = require("../../texts");
+async function finishExec(client, workspace, sandboxId, identifier, commandId, follow, jsonl) {
+    const body = await client.streamSandboxCommandLogs(workspace, sandboxId, commandId, follow);
+    await output_1.default.streamCommandLogs(body, jsonl);
+    const cmdExit = await client.getSandboxCommand(workspace, sandboxId, commandId);
+    if (jsonl) {
+        output_1.default.json({
+            type: 'exit',
+            status: cmdExit.status,
+            exit_code: cmdExit.exit_code ?? null,
+        });
+        if ([utils_1.SANDBOX_EXEC_STATUS.SUCCESSFUL, utils_1.SANDBOX_EXEC_STATUS.INPROGRESS].includes(cmdExit.status)) {
+            output_1.default.exitNormal();
+        }
+        output_1.default.exitCode(1);
+    }
+    if (cmdExit.status === utils_1.SANDBOX_EXEC_STATUS.SUCCESSFUL) {
+        output_1.default.exitSuccess((0, texts_1.TXT_SANDBOX_EXEC_SUCCESS)(identifier, commandId));
+    }
+    else if (cmdExit.status === utils_1.SANDBOX_EXEC_STATUS.INPROGRESS) {
+        output_1.default.exitNormal((0, texts_1.TXT_SANDBOX_EXEC_INPROGRESS)(identifier, commandId));
+    }
+    else {
+        output_1.default.exitError((0, texts_1.TXT_SANDBOX_EXEC_FAILED)(identifier, commandId));
+    }
+}

package/distTs/src/discovery.js

@@ -0,0 +1,119 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverCommands = exports.describeCommand = void 0;
+const cliCommand_1 = __importDefault(require("./cliCommand"));
+const texts_1 = require("./texts");
+const sortedChildren = (command) => command
+    .createHelp()
+    .visibleCommands(command)
+    // Commander may append a synthetic help command. Only expose registered commands.
+    .filter((child) => command.commands.includes(child))
+    .sort((a, b) => (a.name() < b.name() ? -1 : a.name() > b.name() ? 1 : 0));
+const commandPath = (command) => command.parent
+    ? `${commandPath(command.parent)} ${command.name()}`
+    : command.name() || 'bdy';
+const optionInfo = (option) => {
+    const value = option.flags.match(/[<[]([^>\]]+)[>\]]/)?.[1] ?? null;
+    // These are static documentation, never resolved values from opts(), env or config.
+    const env = option.envVar ??
+        option.description.match(/Can be set via variable:\s*([A-Z][A-Z0-9_]*)/)?.[1] ??
+        null;
+    const documentedDefault = option.description.match(/Default:\s*(.+)$/)?.[1] ?? null;
+    const choices = option.argChoices ??
+        (value &&
+            /^[A-Za-z][A-Za-z0-9_-]*(?:\|[A-Za-z][A-Za-z0-9_-]*)+$/.test(value)
+            ? value.split('|')
+            : null);
+    return {
+        flags: option.flags,
+        short: option.short ?? null,
+        long: option.long ?? null,
+        description: option.description,
+        required: option.mandatory,
+        value: value
+            ? {
+                name: value,
+                required: option.required,
+                variadic: !!option.variadic,
+            }
+            : null,
+        negated: option.negate,
+        choices,
+        default: option.defaultValue ?? null,
+        documented_default: documentedDefault,
+        env,
+    };
+};
+const describeCommand = (command) => ({
+    command: commandPath(command),
+    aliases: command.aliases(),
+    description: command.description(),
+    usage: `${commandPath(command)} ${command.usage()}`.trim(),
+    arguments: command.registeredArguments.map((argument) => ({
+        name: argument.name(),
+        description: argument.description,
+        required: argument.required,
+        variadic: argument.variadic,
+        choices: argument.argChoices ?? null,
+        default: argument.defaultValue ?? null,
+    })),
+    options: command
+        .createHelp()
+        .visibleOptions(command)
+        .filter((option) => option.long !== '--help')
+        .map(optionInfo),
+    required_scopes: command instanceof cliCommand_1.default ? command.requiredScopes : null,
+    examples: command instanceof cliCommand_1.default ? command.examples : [],
+});
+exports.describeCommand = describeCommand;
+const describeTree = (command) => ({
+    ...(0, exports.describeCommand)(command),
+    subcommands: sortedChildren(command).map(describeTree),
+});
+const summarizeTree = (command) => [
+    {
+        command: commandPath(command),
+        description: command.description(),
+    },
+    ...sortedChildren(command).flatMap(summarizeTree),
+];
+const discoverCommands = (program, path, version, full = false) => {
+    let selected = program;
+    const selectedPath = [];
+    for (const part of path) {
+        const child = sortedChildren(selected).find((command) => command.name() === part || command.aliases().includes(part));
+        if (!child)
+            return {
+                error: {
+                    code: 'unknown_command',
+                    message: (0, texts_1.ERR_DISCOVER_UNKNOWN_COMMAND)(part, commandPath(selected)),
+                    hint: (0, texts_1.TXT_DISCOVER_COMMAND_HINT)(selectedPath),
+                },
+            };
+        selected = child;
+        selectedPath.push(child.name());
+    }
+    const commands = selected === program ? sortedChildren(program) : [selected];
+    const includeDetails = full || (selected !== program && sortedChildren(selected).length === 0);
+    return {
+        schema_version: 1,
+        cli_version: version,
+        // Root flags must precede the subcommand; keep them separate from local options.
+        ...(includeDetails
+            ? {
+                global_options: program
+                    .createHelp()
+                    .visibleOptions(program)
+                    .map(optionInfo),
+            }
+            : {}),
+        commands: includeDetails
+            ? commands.map(describeTree)
+            : commands.flatMap(summarizeTree),
+        tips: texts_1.DISCOVERY_TIPS,
+    };
+};
+exports.discoverCommands = discoverCommands;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "bdy",
   "preferGlobal": false,
-  "version": "1.25.2-stage",
+  "version": "1.25.2",
   "type": "commonjs",
   "license": "MIT",
   "homepage": "https://buddy.works/docs/cli",