@wirecat/cli-core 0.20.0 → 0.263.0

package/dist/cli/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../src/cli/profile.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,eAAO,MAAM,eAAe,YAAY,CAAA;AAExC,6FAA6F;AAC7F,eAAO,MAAM,WAAW,YAAa,MAAM,KAAG,MAAuB,CAAA;AASrE,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,MASnD,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,YAAa,OAAO,KAAG,GAAG,CAAC,MAAM,CAC2C,CAAA;AAErG;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAU,MAAM,EAAE,SAAS,GAAG,CAAC,MAAM,CAAC,KAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAIlG,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,YAAa,MAAM,SAAS,GAAG,CAAC,MAAM,CAAC,WAAW,MAAM,KAAG,IASxF,CAAA;AAED,6DAA6D;AAC7D,eAAO,MAAM,MAAM,YAAa,OAAO,KAAG,OAIzC,CAAA"}

package/dist/cli/profile.js

@@ -0,0 +1,53 @@
+import { CliError } from "@wirecat/cli-base";
+export const DEFAULT_PROFILE = "default";
+/** How the command line names this profile: always the first word, since none is assumed. */
+export const asFirstWord = (profile) => `${profile} `;
+/**
+ * A profile name becomes a file name and a keyring account, and the first word on the command line
+ * is the profile — so a mistyped path arrives here as a name, and `a/../b` would write a file
+ * somewhere nobody would think to look.
+ */
+const PLAIN_NAME = /^[A-Za-z0-9][A-Za-z0-9._-]*$/;
+export const usableProfileName = (profile) => {
+    if (!PLAIN_NAME.test(profile)) {
+        throw new CliError("validation_error", `"${profile}" cannot be a profile name — letters, digits, dot, dash and underscore only, ` +
+            "starting with a letter or a digit");
+    }
+    return profile;
+};
+/**
+ * Every word that means a command at the top level. Taken off the built program rather than
+ * written out, because a list written out goes stale the day a command is added — and `help` is in
+ * it without being in `program.commands`.
+ */
+export const commandWords = (program) => new Set(["help", ...program.commands.flatMap((command) => [command.name(), ...command.aliases()])]);
+/**
+ * **The first word is the profile unless it names a command.** `tg personal chats list`, and
+ * `tg chats list` on the default profile, with no flag in either. An option is never a profile, so
+ * `tg --json chats list` still works.
+ */
+export const liftProfile = (argv, words) => {
+    const [first, ...rest] = argv;
+    if (first === undefined || first.startsWith("-") || words.has(first))
+        return { rest: argv };
+    return { profile: first, rest };
+};
+/**
+ * Refused at creation, which is the only moment it can still be explained: a profile named after a
+ * command could never be selected, because `tg chats` has to mean the command.
+ */
+export const refuseCommandName = (profile, words, command) => {
+    if (words.has(profile)) {
+        throw new CliError("validation_error", `"${profile}" is a command, so \`${command} ${profile} …\` would always mean the command and never ` +
+            "this profile. Pick a name that is not one of: " +
+            [...words].sort().join(", "));
+    }
+};
+/** The root of the command tree, from anywhere inside it. */
+export const rootOf = (command) => {
+    let root = command;
+    while (root.parent)
+        root = root.parent;
+    return root;
+};
+//# sourceMappingURL=profile.js.map

package/dist/cli/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/cli/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAG5C,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS,CAAA;AAExC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,GAAG,OAAO,GAAG,CAAA;AAErE;;;;GAIG;AACH,MAAM,UAAU,GAAG,8BAA8B,CAAA;AAEjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAU,EAAE;IAC3D,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,IAAI,OAAO,+EAA+E;YACxF,mCAAmC,CACtC,CAAA;IACH,CAAC;IACD,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAgB,EAAe,EAAE,CAC5D,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;AAErG;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAc,EAAE,KAAkB,EAAwC,EAAE;IACtG,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAA;IAC7B,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IAC3F,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;AACjC,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,KAAkB,EAAE,OAAe,EAAQ,EAAE;IAC9F,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,kBAAkB,EAClB,IAAI,OAAO,wBAAwB,OAAO,IAAI,OAAO,+CAA+C;YAClG,gDAAgD;YAChD,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/B,CAAA;IACH,CAAC;AACH,CAAC,CAAA;AAED,6DAA6D;AAC7D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,OAAgB,EAAW,EAAE;IAClD,IAAI,IAAI,GAAG,OAAO,CAAA;IAClB,OAAO,IAAI,CAAC,MAAM;QAAE,IAAI,GAAG,IAAI,CAAC,MAAM,CAAA;IACtC,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}

package/dist/cli/program.d.ts

@@ -0,0 +1,33 @@
+import { Command } from "commander";
+import { type AppIdentity } from "./app.js";
+import { type BaseEnvironment } from "./context.js";
+import { type GlobalFlags, type ResolveOptions, type Settings } from "./settings.js";
+export interface ProgramDefinition {
+    app: AppIdentity;
+    /** One resource per command, one action per subcommand. Built fresh for every program. */
+    commands: () => Command[];
+    /** The CLI's own settings, for keeping a failure that happened before its command could; plain ones without. */
+    configuration?: {
+        resolveSettings: (flags?: GlobalFlags, options?: ResolveOptions) => Pick<Settings, "profile" | "keepFailedRuns" | "keepRunsForDays" | "skillHint">;
+    };
+    configure?: (program: Command) => void;
+    prepare?: (program: Command, environment: RunOptions) => void | Promise<void>;
+    onFailure?: (error: unknown, program: Command) => void | Promise<void>;
+}
+export interface ProgramOptions {
+    /** Where `--version` and `--help` write. Injected so a test reads them instead of the terminal. */
+    out?: (text: string) => void;
+    err?: (text: string) => void;
+}
+/**
+ * The command tree, built fresh on each call. Commander is global state by default —
+ * `exitOverride` and the write hooks turn it into a value a test can drive.
+ */
+export declare const createProgram: ({ app, commands, configure }: ProgramDefinition, { out, err }?: ProgramOptions) => Command;
+export type RunOptions = BaseEnvironment & Record<string, unknown>;
+/**
+ * Runs the program and **returns an exit code instead of throwing**. A stack trace is not an error
+ * message: it tells a script nothing it can branch on, and exits 1 for every kind of failure alike.
+ */
+export declare const run: (argv: string[], definition: ProgramDefinition, options?: RunOptions) => Promise<number>;
+//# sourceMappingURL=program.d.ts.map

package/dist/cli/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,UAAU,CAAA;AAEpD,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,cAAc,CAAA;AASvE,OAAO,EAAE,KAAK,WAAW,EAAiB,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAe,MAAM,eAAe,CAAA;AAGhH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,WAAW,CAAA;IAChB,0FAA0F;IAC1F,QAAQ,EAAE,MAAM,OAAO,EAAE,CAAA;IACzB,gHAAgH;IAChH,aAAa,CAAC,EAAE;QACd,eAAe,EAAE,CACf,KAAK,CAAC,EAAE,WAAW,EACnB,OAAO,CAAC,EAAE,cAAc,KACrB,IAAI,CAAC,QAAQ,EAAE,SAAS,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,CAAC,CAAA;KACpF,CAAA;IACD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC7E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvE;AAED,MAAM,WAAW,cAAc;IAC7B,mGAAmG;IACnG,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,iCACM,iBAAiB,iBACjC,cAAc,KAC3B,OAgDF,CAAA;AAOD,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElE;;;GAGG;AACH,eAAO,MAAM,GAAG,SAAgB,MAAM,EAAE,cAAc,iBAAiB,YAAW,UAAU,KAAQ,OAAO,CAAC,MAAM,CAyLjH,CAAA"}

package/dist/cli/program.js

@@ -0,0 +1,359 @@
+import { join } from "node:path";
+import { CliError, errorObjectOf, errorRecordOf, exitCodeFor, exitCodeOfError, processStreams, renderError, resolvePaths, } from "@wirecat/cli-base";
+import { skillHint } from "@wirecat/cli-base/skill";
+import { Command } from "commander";
+import { envName } from "./app.js";
+import { commandPathOf } from "./command-contract.js";
+import { outputFor, provide } from "./context.js";
+import { byteCount, DEFAULT_COMMAND_MS, DEFAULT_OUTPUT_BYTES, execution } from "./execution.js";
+import { isCliFailure, isCommanderFailure } from "./failures.js";
+import { MAX_BUFFERED_INPUT, provideInputPolicy } from "./input-policy.js";
+import { checkJson, liftJson } from "./json-fields.js";
+import { PreviewComplete, preview } from "./preview.js";
+import { commandWords, liftProfile } from "./profile.js";
+import { failureContext } from "./reasons.js";
+import { recorded, wasSettled } from "./runs/recording.js";
+import { parseDuration, settingsFor } from "./settings.js";
+import { commandAt } from "./steps.js";
+/**
+ * The command tree, built fresh on each call. Commander is global state by default —
+ * `exitOverride` and the write hooks turn it into a value a test can drive.
+ */
+export const createProgram = ({ app, commands, configure }, { out, err } = {}) => {
+    const program = new Command();
+    program
+        .name(app.command)
+        .usage("[profile] [options] <command>")
+        .description(`${app.description}\n\n` +
+        `The first word is the profile whenever it is not a command — \`${app.command} personal chats list\`.\n` +
+        `\`${app.envPrefix}_PROFILE\` says the same thing for a whole shell session, and \`defaultProfile\` in the config file for good.\n` +
+        "No profile is assumed: without one, a command that uses an account stops and lists the profiles here.")
+        .version(app.version, "-V, --version")
+        .option("-v, --verbose", "more detail in what is shown: -v ids, -vv everything we know", (_, level) => level + 1, 0)
+        .option("--json", "machine-readable output: one JSON value on stdout; --json=id,text keeps only those fields")
+        .option("--jsonl", "machine-readable output: one JSON object per line, for streaming and jq")
+        .option("--quiet", "diagnostics off; a failure is still said")
+        .option("--trace", "the connection's own log lines on stderr — never message content")
+        .option("--debug", "on a failure, its whole record — cause and stack — in place of the short line")
+        .option("--timeout <duration>", "give up on the whole command after this — 30s, 2m, 500ms")
+        .option("--offline", "answer from what was recorded and never connect; fails if nothing was")
+        .option("--no-input", "never prompt or open interactive login; piped input remains available")
+        .option("--max-input-bytes <bytes>", "maximum buffered input bytes (default: 16777216)")
+        .option("--max-output-bytes <bytes>", "maximum machine output bytes (default: 4194304; 0 disables)")
+        .option("--brief", "found messages and mail as reference, title, time, sender and excerpt only")
+        .option("--full", "found messages and mail with their whole text and every provider field")
+        .option("--dry-run", "preview parsed arguments and permissions before running the action")
+        .option("--yes", "go ahead without the question an ask level puts before a write")
+        .option("--record", "keep this run — ids and timings, never message content")
+        .option("--no-record", "do not keep it, whatever the configuration says")
+        .showHelpAfterError();
+    for (const command of commands())
+        program.addCommand(command);
+    configure?.(program);
+    // Depth-first: Commander does not pass `configureOutput` down to a command added with
+    // `addCommand`, so `tg messages --help` would write to the real terminal.
+    if (out || err) {
+        forEachCommand(program, (command) => command.configureOutput({ writeOut: (text) => out?.(text), writeErr: (text) => err?.(text) }));
+    }
+    return program;
+};
+const forEachCommand = (command, apply) => {
+    apply(command);
+    for (const child of command.commands)
+        forEachCommand(child, apply);
+};
+/**
+ * Runs the program and **returns an exit code instead of throwing**. A stack trace is not an error
+ * message: it tells a script nothing it can branch on, and exits 1 for every kind of failure alike.
+ */
+export const run = async (argv, definition, options = {}) => {
+    const streams = options.streams ?? processStreams;
+    const delimiter = argv.indexOf("--");
+    const flags = argv.slice(0, delimiter < 0 ? undefined : delimiter);
+    const machine = flags.some((word) => word === "--json" || word.startsWith("--json=") || word === "--jsonl");
+    const debug = flags.includes("--debug");
+    const reporting = machine ? { ...options, tty: false } : options;
+    const control = execution(streams, { maxOutputBytes: 0 });
+    let restoreInput;
+    let signalExit;
+    // Ctrl-C or `kill` is how a command that listens until stopped ends: still aborted, but exit 0.
+    let listens = false;
+    const interrupted = (signal) => {
+        signalExit = listens ? 0 : signal === "SIGINT" ? 130 : 143;
+        control.abort(new CliError("cancelled", `command interrupted by ${signal}`, { reason: signal, retryable: false }));
+    };
+    const sigint = () => interrupted("SIGINT");
+    const sigterm = () => interrupted("SIGTERM");
+    const pipeError = (error) => {
+        if (error.code === "EPIPE") {
+            signalExit = 0;
+            control.abort(error);
+        }
+    };
+    const externalAbort = () => control.abort(new CliError("cancelled", "command cancelled", { retryable: false }));
+    const { command } = definition.app;
+    // Commander's own error lines are replaced by ours; its help for a missing subcommand is kept for a person.
+    let help = "";
+    const program = createProgram(definition, {
+        out: (text) => control.streams.data(text.replace(/\n$/, "")),
+        err: (text) => {
+            help += text;
+        },
+    });
+    const environment = {
+        ...options,
+        streams: control.streams,
+        signal: options.signal ? AbortSignal.any([control.signal, options.signal]) : control.signal,
+        commandSignal: control.signal,
+        trackCloseable: control.trackCloseable,
+        app: definition.app,
+    };
+    provide(program, environment);
+    program.hook("preAction", async (_root, action) => {
+        const flags = action.optsWithGlobals();
+        const commandEnv = options.env ?? process.env;
+        const headless = machine || flags.input === false || Boolean(commandEnv.CI) || (options.tty ?? process.stdout.isTTY) !== true;
+        checkJson(action, requested, !flags.jsonl && (options.tty ?? process.stdout.isTTY) === true);
+        control.configure({
+            ...(flags.fields === undefined ? {} : { fields: flags.fields }),
+            maxOutputBytes: flags.maxOutputBytes === undefined
+                ? machine || (options.tty ?? process.stdout.isTTY) !== true
+                    ? DEFAULT_OUTPUT_BYTES
+                    : 0
+                : byteCount(flags.maxOutputBytes, "--max-output-bytes", true),
+        });
+        restoreInput = provideInputPolicy(options.stdin ?? process.stdin, {
+            noInput: headless,
+            maxBytes: flags.maxInputBytes === undefined ? MAX_BUFFERED_INPUT : byteCount(flags.maxInputBytes, "--max-input-bytes"),
+            signal: control.signal,
+        });
+        if (flags.input === false || (headless && !options.answer))
+            environment.answer = () => null;
+        const localPreview = action.options.some((option) => option.long === "--dry-run");
+        if (flags.dryRun && localPreview)
+            action.setOptionValue("dryRun", true);
+        const path = commandPathOf(action);
+        const persistent = ["watch", "serve", "mcp"].includes(path[0] ?? "") ||
+            path.includes("mcp") ||
+            (path[0] === "bot" && path[1] === "watch");
+        listens = persistent;
+        const interactiveLogin = !headless && (path[0] === "setup" || (path[0] === "session" && path[1] === "start"));
+        const timeout = flags.timeout ?? (commandEnv[envName(definition.app, "TIMEOUT")]?.trim() || undefined);
+        // A background fetch was asked to outlive the shell; only an explicit --timeout bounds it.
+        const job = commandEnv[envName(definition.app, "BACKFILL_JOB")] !== undefined;
+        control.start(timeout === undefined
+            ? persistent || interactiveLogin || job
+                ? undefined
+                : DEFAULT_COMMAND_MS
+            : persistent
+                ? undefined
+                : parseDuration(timeout, flags.timeout === undefined ? envName(definition.app, "TIMEOUT") : "--timeout"));
+        process.on("SIGINT", sigint).on("SIGTERM", sigterm);
+        if (!options.streams) {
+            process.stdout.on("error", pipeError);
+            process.stderr.on("error", pipeError);
+        }
+        const cooperative = persistent || (path[0] === "messages" && path[1] === "sync");
+        if (!cooperative)
+            options.signal?.addEventListener("abort", externalAbort, { once: true });
+        if (!cooperative && options.signal?.aborted) {
+            externalAbort();
+            throw control.failure();
+        }
+        if (flags.dryRun && !localPreview) {
+            const resolved = (definition.configuration ?? settingsFor(definition.app)).resolveSettings(flags, {
+                kind: path[0] === "bot" ? "bot" : "personal",
+                env: options.env ?? process.env,
+            });
+            const permissions = "permissions" in resolved ? resolved.permissions : {};
+            outputFor(action).renderer.result(preview(action, permissions));
+            throw new PreviewComplete();
+        }
+        await definition.prepare?.(program, environment);
+        if (control.signal.aborted)
+            throw control.failure();
+    });
+    // Depth-first: a subcommand left with the default behaviour kills the process from inside a test.
+    forEachCommand(program, (child) => child.exitOverride());
+    // Before commander, not inside it: commander has no hook that runs before it decides which
+    // subcommand it is looking at.
+    const { profile, rest: lifted } = liftProfile(argv, commandWords(program));
+    if (profile !== undefined)
+        program.setOptionValue("profile", profile);
+    const requested = liftJson(lifted, (words) => commandAt(program, commandPath(program, words)));
+    const rest = requested.argv;
+    if (requested.fields !== undefined)
+        program.setOptionValue("fields", requested.fields);
+    // A bare word with nothing after it would make commander print help **on stdout**, which breaks
+    // the one contract this program has and says nothing about why.
+    if (profile !== undefined && rest.length === 0) {
+        const message = `"${profile}" is not a command, so it was read as a profile name — and no command followed it. ` +
+            `Run \`${command} --help\` for the commands, or \`${command} ${profile} account show\` if "${profile}" is your profile.`;
+        const failure = new CliError("validation_error", message, { param: "profile" });
+        const settled = await settleFailure(failure, { definition, program, rest, profile, options });
+        return report(streams, reporting, failed(definition, program, rest, failure, settled, debug));
+    }
+    try {
+        await control.race(() => program.parseAsync(rest, { from: "user" }));
+        const code = process.exitCode === undefined ? 0 : Number(process.exitCode);
+        const hint = code === 0 && rest[0] !== "commands" && !rest.includes("--quiet") ? hintFor(definition, rest, options) : undefined;
+        if (hint)
+            streams.diagnostic(hint);
+        return code;
+    }
+    catch (caught) {
+        const error = control.failure() ?? caught;
+        if (error instanceof PreviewComplete)
+            return 0;
+        if (signalExit === 0)
+            return 0;
+        if (isCommanderFailure(error)) {
+            if (error.exitCode === 0)
+                return 0;
+            let message = error.message.replace(/^error: /, "");
+            if (error.code === "commander.help") {
+                if (reporting.tty ?? process.stdout.isTTY === true) {
+                    streams.diagnostic(help.replace(/\n$/, ""));
+                    return exitCodeFor("validation_error");
+                }
+                message = `give a command — run \`${command} --help\` for the commands`;
+            }
+            if (profile !== undefined &&
+                error.code === "commander.unknownCommand" &&
+                rest[0] !== undefined &&
+                !commandWords(program).has(rest[0])) {
+                message += ` "${profile}" is not a command, so it was read as a profile name — which left "${rest[0]}" to be one.`;
+            }
+            const failure = new CliError("validation_error", message);
+            const settled = await settleFailure(failure, { definition, program, rest, profile, options });
+            return report(streams, reporting, failed(definition, program, rest, failure, settled, debug));
+        }
+        const settled = await settleFailure(error, { definition, program, rest, profile, options });
+        const exit = report(streams, reporting, failed(definition, program, rest, error, settled, debug));
+        return signalExit ?? exit;
+    }
+    finally {
+        restoreInput?.();
+        options.signal?.removeEventListener("abort", externalAbort);
+        process.off("SIGINT", sigint).off("SIGTERM", sigterm);
+        if (!options.streams) {
+            process.stdout.off("error", pipeError);
+            process.stderr.off("error", pipeError);
+        }
+        await control.finish();
+    }
+};
+/** The update notice's state file, so both daily lines share one file per CLI. */
+const hintFor = ({ app, configuration }, argv, options) => {
+    const env = options.env ?? process.env;
+    let enabled;
+    try {
+        enabled = (configuration ?? settingsFor(app)).resolveSettings({}, { env, needsProfile: false }).skillHint;
+    }
+    catch {
+        return undefined;
+    }
+    const statePath = join(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).state, "update-check.json");
+    return skillHint({ app, argv, env, statePath, enabled });
+};
+const settleFailure = async (failure, state) => {
+    let timer;
+    let settlementFailed;
+    try {
+        const settle = (async () => {
+            try {
+                await state.definition.onFailure?.(failure, state.program);
+            }
+            catch {
+                settlementFailed = true;
+            }
+            await keepFailure(failure, state);
+        })();
+        await Promise.race([
+            settle,
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new Error("failure settlement deadline")), 1000);
+            }),
+        ]);
+        return settlementFailed ? { settlementFailed } : {};
+    }
+    catch {
+        return { settlementFailed: true };
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+};
+/**
+ * **Every failure is kept as a run** — a usage error, a configuration that will not load, a command
+ * that never opens a run — unless recording was turned off. One its own run already kept is skipped.
+ * Only the command's words are named, never its arguments: those can be a message.
+ */
+const keepFailure = async (failure, { definition, program, rest, profile, options }) => {
+    if (wasSettled(failure))
+        return;
+    const env = options.env ?? process.env;
+    const path = commandPath(program, program.args.length > 0 ? program.args : rest);
+    const { resolveSettings } = definition.configuration ?? settingsFor(definition.app);
+    let settings;
+    try {
+        settings = resolveSettings({ ...program.opts(), ...(profile === undefined ? {} : { profile }) }, { env, kind: path.split(" ")[0] === "bot" ? "bot" : "personal", needsProfile: false });
+    }
+    catch {
+        // A configuration that will not load is a failure worth keeping too; the flags are all there is to go on.
+    }
+    await recorded({
+        app: definition.app,
+        command: path || definition.app.command,
+        profile: settings?.profile ?? profile ?? "default",
+        record: false,
+        keepFailed: settings?.keepFailedRuns ?? !rest.includes("--no-record"),
+        trace: false,
+        format: "json",
+        streams: options.streams ?? processStreams,
+        env,
+        ...(settings ? { keepDays: settings.keepRunsForDays } : {}),
+    }, async () => {
+        throw failure;
+    }).catch(() => { });
+};
+/** `messages list` from `messages list 111 --limit 5`: the words that name commands, up to the first that does not. */
+const commandPath = (program, rest) => {
+    const words = [];
+    let current = program;
+    for (const token of rest) {
+        if (token.startsWith("-"))
+            continue;
+        const next = current.commands.find((one) => one.name() === token || one.aliases().includes(token));
+        if (!next)
+            break;
+        words.push(token);
+        current = next;
+    }
+    return words.join(" ");
+};
+const failed = ({ app }, program, rest, error, settled, debug) => {
+    const failure = settled.settlementFailed && isCliFailure(error)
+        ? new CliError(error.code, error.message, { ...error.details, settlement_failed: true })
+        : error;
+    const object = errorObjectOf(failure, failureContext(app.errors));
+    const command = commandPath(program, program.args.length > 0 ? program.args : rest) || app.command;
+    return {
+        object,
+        cli: app.command,
+        ...(debug
+            ? { record: errorRecordOf(failure, object, { command, service: app.command, version: app.version }) }
+            : {}),
+    };
+};
+/**
+ * **A failure never reaches stdout.** It goes to stderr — as JSON when nobody is watching, because
+ * an exit code says which kind of thing went wrong and nothing about which chat or how long to wait.
+ */
+const report = (streams, options, { object, record, cli }) => {
+    const interactive = options.tty ?? process.stdout.isTTY === true;
+    streams.diagnostic(renderError(object, { cli, interactive, ...(record ? { record } : {}) }));
+    return exitCodeOfError(object);
+};
+//# sourceMappingURL=program.js.map

package/dist/cli/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"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"}

package/dist/cli/reasons.d.ts

@@ -0,0 +1,17 @@
+import type { FailureContext } from "@wirecat/cli-base";
+import type { ErrorReason } from "@wirecat/cli-base/standards";
+/** Every reason this package raises; cli-base's own are known to the handler already. */
+export declare const REASONS: ErrorReason[];
+/**
+ * Detail keys an error from this package may carry, until each is registered on its own reason. Not `cause`:
+ * that can hold a provider's or SQLite's raw text.
+ */
+export declare const DETAILS: readonly ["allowed", "alternative", "arguments", "at", "available", "batch", "budget", "built", "candidates", "chat", "chat_id", "cli", "complete", "emitted_bytes", "exact", "forum", "guide", "hint", "id", "index", "kind", "limit", "limit_source", "max_bytes", "name", "operation_id", "operation_ids", "partial_output", "path", "permission", "person_ids", "previous_chat_id", "profiles", "provider_error", "provider", "recovery", "reference", "remembered", "retry_at", "runtime", "saved", "scheduled_for", "script", "send_id", "sent", "settlement_failed", "span", "sqlite", "stage", "standing", "state", "stderr", "term", "total", "upgraded", "wanted"];
+/** What a CLI adds to the shared registry: its own reasons, and the detail keys its adapters raise. */
+export interface AppErrors {
+    reasons?: readonly ErrorReason[];
+    details?: readonly string[];
+}
+/** The registry every error handler reads — the CLI's, MCP's and the meeting tools' — so none drops an app's keys. */
+export declare const failureContext: (errors?: AppErrors) => FailureContext;
+//# sourceMappingURL=reasons.d.ts.map

package/dist/cli/reasons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasons.d.ts","sourceRoot":"","sources":["../../src/cli/reasons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAwD9D,yFAAyF;AACzF,eAAO,MAAM,OAAO,EAAE,WAAW,EAG/B,CAAA;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,YAClB,SAAS,EACT,aAAa,EACb,WAAW,EACX,IAAI,EACJ,WAAW,EACX,OAAO,EACP,QAAQ,EACR,OAAO,EACP,YAAY,EACZ,MAAM,EACN,SAAS,EACT,KAAK,EACL,UAAU,EACV,eAAe,EACf,OAAO,EACP,OAAO,EACP,OAAO,EACP,MAAM,EACN,IAAI,EACJ,OAAO,EACP,MAAM,EACN,OAAO,EACP,cAAc,EACd,WAAW,EACX,MAAM,EACN,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,SAAS,EACT,OAAO,EACP,eAAe,EACf,QAAQ,EACR,SAAS,EACT,MAAM,EACN,mBAAmB,EACnB,MAAM,EACN,QAAQ,EACR,OAAO,EACP,UAAU,EACV,OAAO,EACP,QAAQ,EACR,MAAM,EACN,OAAO,EACP,UAAU,EACV,QAAQ,CACA,CAAA;AAEV,uGAAuG;AACvG,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAA;IAChC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC5B;AAKD,sHAAsH;AACtH,eAAO,MAAM,cAAc,YAAa,SAAS,KAAG,cAYnD,CAAA"}