@wirecat/cli-core 0.20.0 → 0.262.0

package/dist/cli/commands-command.js

@@ -0,0 +1,86 @@
+import { CliError, EXIT_CODES, GENERIC_FAILURE } from "@wirecat/cli-base";
+import { describeOptions, describeProgram, flatten } from "@wirecat/cli-base/commands";
+import { CRASH_CODE } from "@wirecat/cli-base/standards";
+import { Command } from "commander";
+import { commandContract, findCommand } from "./command-contract.js";
+import { outputFor } from "./context.js";
+import { rootOf } from "./profile.js";
+/**
+ * The major version of the JSON every command prints. The output types live in this package, so the
+ * contract is this package's: raise it with a major version, when a field is removed or renamed.
+ */
+export const CONTRACT = 1;
+/**
+ * The discovery surface an agent reads instead of `--help`. It opens no store, no session and no
+ * settings file: which commands exist does not depend on whether this machine has logged in.
+ */
+export const commandsCommand = (app) => {
+    const command = new Command("commands")
+        .description("commands, options and exit codes as JSON — inspect one command path per call")
+        .argument("[path...]", "one command path, for example: search messages; inspect other groups in separate calls")
+        .action(function (path) {
+        const root = rootOf(this);
+        const { renderer, format } = outputFor(this);
+        const all = describeProgram(root);
+        const scoped = path.length > 0 ? scopeOf(root, all, path) : undefined;
+        const commands = scoped ? [scoped.command] : all;
+        if (format === "pretty") {
+            renderer.result(flatten(commands).map(({ usage, summary, description, mutates, state }) => ({
+                command: usage,
+                description: summary ?? description,
+                writes: mutates ? "yes" : "",
+                ...(state ? { state } : {}),
+            })));
+            return;
+        }
+        renderer.result({
+            cli: app.command,
+            version: app.version,
+            contract: CONTRACT,
+            description: root.description(),
+            global_options: describeOptions(root),
+            ...(scoped ? { scope: scoped.command.path, inherited_options: scoped.inheritedOptions } : {}),
+            commands,
+            exit_codes: { ok: 0, [CRASH_CODE]: GENERIC_FAILURE, ...EXIT_CODES },
+        });
+    });
+    command.addCommand(new Command("schema")
+        .description("one command's argv and result schemas, effects, permissions and retry guidance")
+        .argument("<path...>", "one command path, for example: stats messages show")
+        .action(function (path) {
+        const { renderer } = outputFor(this);
+        renderer.result({
+            cli: app.command,
+            version: app.version,
+            contract: CONTRACT,
+            ...commandContract(findCommand(rootOf(this), path)),
+        });
+    }));
+    return command;
+};
+const scopeOf = (root, all, path) => {
+    let parent = root;
+    let available = all;
+    let selected;
+    const inheritedOptions = [];
+    for (const word of path) {
+        const child = parent.commands.find((command) => command.name() === word || command.aliases().includes(word));
+        const described = child && available.find(({ name }) => name === child.name());
+        if (!child || !described) {
+            const prefix = selected?.path ?? [];
+            const choices = available.map(({ name }) => name);
+            throw new CliError("validation_error", `unknown command path "${path.join(" ")}" — inspect \`${[root.name(), "commands", ...prefix, "--json"].join(" ")}\`; ` +
+                (choices.length ? `available here: ${choices.join(", ")}. ` : "this command has no subcommands. ") +
+                `Give one command path per call, not a list of groups: \`${root.name()} commands messages --json\` ` +
+                `and \`${root.name()} commands chats --json\` are separate calls`, { path, at: word, available: choices });
+        }
+        if (selected && selected.options.length > 0) {
+            inheritedOptions.push({ path: selected.path, options: [...selected.options] });
+        }
+        selected = described;
+        parent = child;
+        available = described.commands;
+    }
+    return { command: selected, inheritedOptions };
+};
+//# sourceMappingURL=commands-command.js.map

package/dist/cli/commands-command.js.map

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

package/dist/cli/config-command.d.ts

@@ -0,0 +1,17 @@
+import { Command } from "commander";
+import { type AppIdentity } from "./app.js";
+import { type PermissionKeyOf } from "./permission-keys.js";
+import { type Configuration } from "./settings.js";
+/**
+ * The settings in force and where each came from, and changing them. Printed whole: no field the
+ * configuration accepts can hold a secret — the schema has nowhere to put one.
+ */
+export declare const configCommand: (app: AppIdentity, config: Configuration, { permissionKey }?: {
+    permissionKey?: PermissionKeyOf;
+}) => Command;
+/**
+ * A key no command or write is checked against would be saved and do nothing (BUG-137) — whether it
+ * comes as `permissions.<key>` or inside a whole `permissions` object.
+ */
+export declare const refuseUnknownKey: (command: Command, setting: string, value: string, permissionKey?: PermissionKeyOf) => void;
+//# sourceMappingURL=config-command.d.ts.map

package/dist/cli/config-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-command.d.ts","sourceRoot":"","sources":["../../src/cli/config-command.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,UAAU,CAAA;AAEpD,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE7F,OAAO,EAAE,KAAK,aAAa,EAAuC,MAAM,eAAe,CAAA;AAGvF;;;GAGG;AACH,eAAO,MAAM,aAAa,QACnB,WAAW,UACR,aAAa,sBACF;IAAE,aAAa,CAAC,EAAE,eAAe,CAAA;CAAE,KACrD,OA0JF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,YAClB,OAAO,WACP,MAAM,SACR,MAAM,kBACG,eAAe,KAC9B,IAiBF,CAAA"}

package/dist/cli/config-command.js

@@ -0,0 +1,185 @@
+import { CliError, configFilePath, loadConfigFile, pathsAreOverridden, resolvePaths, saveConfigFile, } from "@wirecat/cli-base";
+import { annotate } from "@wirecat/cli-base/commands";
+import { Command } from "commander";
+import * as v from "valibot";
+import { envName } from "./app.js";
+import { baseContext } from "./context.js";
+import { knownBeside, knownPermissionKeys } from "./permission-keys.js";
+import { hasPermissionConfig, migratePermissionConfig } from "./permission-migration.js";
+import { fromFile, NONE_NAMED } from "./settings.js";
+import { changeStoreSetting, isStoreSetting, STORE_SETTINGS, storeSettings } from "./store-settings.js";
+/**
+ * The settings in force and where each came from, and changing them. Printed whole: no field the
+ * configuration accepts can hold a secret — the schema has nowhere to put one.
+ */
+export const configCommand = (app, config, { permissionKey } = {}) => {
+    const command = new Command("config").description("the settings in force, and where each one came from");
+    command.addCommand(annotate(new Command("migrate"), { mutates: true, local: true })
+        .description("replace legacy access settings with permissions, preserving this file's effective levels")
+        .option("--dry-run", "show the migration without writing the file")
+        .action(function () {
+        const { renderer, env } = baseContext(this, (flags, options) => config.resolveSettings(flags, { ...options, needsProfile: false }));
+        const dryRun = this.opts().dryRun === true;
+        if (!dryRun && env[envName(app, "PROFILE_LOCK")])
+            throw new CliError("permission_error", "config migrate changes every profile — run outside the profile lock");
+        const path = configFilePath(resolvePaths({ appName: app.appName, prefix: app.envPrefix, env }).config);
+        const migrated = migratePermissionConfig(loadConfigFile(path, config.schema, () => ({ profiles: {} })));
+        if (migrated.changed) {
+            const checked = v.safeParse(config.schema, migrated.config);
+            if (!checked.success)
+                throw new CliError("configuration_error", "the migrated configuration is not valid — the file was not changed");
+            if (!dryRun)
+                saveConfigFile(path, checked.output);
+        }
+        renderer.result({ configFile: path, changed: migrated.changed, dryRun, changes: migrated.changes });
+    }));
+    command
+        .command("show")
+        .description("the profile, the profiles that exist, and each setting with where it came from")
+        .option("--bot", "the settings a bot command on this profile gets, rather than the personal account's")
+        .action(async function () {
+        const bot = this.opts().bot === true;
+        const { settings, renderer, env } = baseContext(this, (flags, options) => config.resolveSettings(flags, { ...options, needsProfile: false, ...(bot ? { kind: "bot" } : {}) }));
+        const overridden = pathsAreOverridden({ appName: app.appName, prefix: app.envPrefix, env });
+        renderer.result({
+            profile: settings.sources.profile === NONE_NAMED ? null : settings.profile,
+            profileFrom: settings.sources.profile,
+            profiles: settings.profilesHere,
+            configFile: settings.configPath,
+            configFound: settings.configFound,
+            pathsOverridden: overridden,
+            settings: [...config.allSettings, "commandTimeoutMs"]
+                .filter((setting) => bot || setting !== "readOtherBots")
+                .map((setting) => sourced(settings, setting, config.schema)),
+            storeSettings: await storeSettings(env),
+        });
+        if (overridden) {
+            renderer.note(`${envName(app, "CONFIG_DIR")}, ${envName(app, "STATE_DIR")} or ${envName(app, "CACHE_DIR")} is set — ` +
+                "a profile's keyring entry is not the usual one, so a session made without them reads as none");
+        }
+    });
+    for (const action of ["set", "unset"]) {
+        const sub = annotate(command.command(action), { mutates: true, local: true })
+            .argument("<setting>", `one of: ${[...config.allSettings, ...STORE_SETTINGS, "accountGroups.<name>"].join(", ")}`)
+            .option("--defaults", "change what every profile gets, rather than this profile")
+            .option("--personal", "only for personal accounts — the personal section of the file")
+            .option("--bot", "only for bots — the bot section of the file");
+        if (action === "set")
+            sub
+                .argument("<value>", "a number, true or false, or for allow a list like send,reaction; for a group tg:work,max:Alice,email:me@x")
+                .description("save a setting to the configuration file");
+        else
+            sub.description("remove a setting from the configuration file");
+        sub.action(async function (setting, given) {
+            const { defaults: everyone, personal, bot, } = this.opts();
+            const { settings, renderer, env } = baseContext(this, (flags, options) => config.resolveSettings(flags, {
+                ...options,
+                needsProfile: !everyone && setting !== "defaultProfile" && !isStoreSetting(setting),
+            }));
+            if (isStoreSetting(setting)) {
+                if (everyone || personal || bot)
+                    throw new CliError("validation_error", `${setting} is store-wide — --defaults, --personal and --bot do not apply`);
+                const lock = envName(app, "PROFILE_LOCK");
+                if (env[lock]) {
+                    throw new CliError("permission_error", `this process is locked to profile ${settings.profile} (${lock}) — ${setting} changes every profile, tg and MAX`);
+                }
+                const { result, note } = await changeStoreSetting(app, env, setting, action === "set" ? String(given) : undefined);
+                renderer.result(result);
+                renderer.note(note);
+                return;
+            }
+            const defaults = everyone === true;
+            if (setting === "defaultProfile" && (defaults || personal || bot))
+                throw new CliError("validation_error", "defaultProfile is one for the whole file — drop --defaults, --personal and --bot");
+            if (personal && bot)
+                throw new CliError("validation_error", "--personal and --bot name different sections; use one");
+            const kind = bot ? "bot" : personal ? "personal" : undefined;
+            const lock = envName(app, "PROFILE_LOCK");
+            if ((defaults || setting === "defaultProfile") && env[lock]) {
+                // The defaults are every other profile's settings too, and defaultProfile picks one of them.
+                throw new CliError("permission_error", `this process is locked to profile ${settings.profile} (${lock}) — ${setting === "defaultProfile" ? setting : "--defaults"} changes other profiles`);
+            }
+            if (["readOnly", "allow", "mcpTools"].includes(setting) &&
+                hasPermissionConfig(loadConfigFile(settings.configPath, config.schema, () => ({ profiles: {} })))) {
+                throw new CliError("validation_error", `${setting} is a legacy setting — use permissions instead; config migrate --dry-run previews the translation`);
+            }
+            if (action === "set")
+                refuseUnknownKey(this, setting, String(given), permissionKey);
+            const saved = config.changeSetting(settings.configPath, {
+                profile: defaults || setting === "defaultProfile" ? undefined : settings.profile,
+                setting,
+                value: action === "set" ? String(given) : undefined,
+                kind,
+            });
+            renderer.result({
+                configFile: settings.configPath,
+                scope: setting === "defaultProfile" ? "defaultProfile" : scopeOf(kind, defaults ? undefined : settings.profile),
+                setting,
+                value: saved,
+            });
+        });
+    }
+    return command;
+};
+/**
+ * A key no command or write is checked against would be saved and do nothing (BUG-137) — whether it
+ * comes as `permissions.<key>` or inside a whole `permissions` object.
+ */
+export const refuseUnknownKey = (command, setting, value, permissionKey) => {
+    const keys = setting.startsWith("permissions.")
+        ? [setting.slice("permissions.".length)]
+        : setting === "permissions"
+            ? objectKeys(value)
+            : [];
+    if (keys.length === 0)
+        return;
+    const known = knownPermissionKeys(command, permissionKey);
+    for (const key of keys) {
+        if (known.has(key))
+            continue;
+        const beside = knownBeside(key, known);
+        throw new CliError("validation_error", `permissions.${key} names no command` +
+            (beside.length > 0 ? ` — the known ones there are ${beside.join(", ")}` : ""));
+    }
+};
+/** The keys of a `permissions` object given whole; anything else is left to the schema to refuse. */
+const objectKeys = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? Object.keys(parsed) : [];
+    }
+    catch {
+        return [];
+    }
+};
+const scopeOf = (kind, profile) => [kind, profile === undefined ? "defaults" : `profiles.${profile}`].filter(Boolean).join(".");
+/** A shared setting from what was resolved; a messenger's own from the file, where it lives. */
+const sourced = (settings, setting, schema) => {
+    if (setting === "defaultProfile") {
+        const named = loadConfigFile(settings.configPath, schema, () => ({ profiles: {} })).defaultProfile;
+        return { setting, value: named ?? null, from: named === undefined ? "default" : "config file" };
+    }
+    if (setting === "models") {
+        return {
+            setting,
+            value: settings.models ?? {},
+            from: "resolved per purpose",
+            sources: Object.fromEntries(Object.entries(settings.sources).filter(([key]) => key.startsWith("models."))),
+        };
+    }
+    // Every layer adds to `permissions`, so the nearest layer's object alone is not what holds.
+    if (setting === "permissions") {
+        const from = Object.keys(settings.permissions).length > 0 ? "config file" : "default";
+        return { setting, value: settings.permissions, from, sources: settings.permissionSources };
+    }
+    if (setting in settings.sources) {
+        const value = settings[setting];
+        // No list is every action, and `null` would read as none.
+        return { setting, value: setting === "allow" ? (value ?? "all") : (value ?? null), from: settings.sources[setting] };
+    }
+    const { value, from } = fromFile(settings, setting, UNLISTED_DEFAULTS[setting] ?? null);
+    return { setting, value, from };
+};
+/** Settings read where they are used rather than in `resolveSettings`, and what an unset one means there. */
+const UNLISTED_DEFAULTS = { transcribeWith: "auto" };
+//# sourceMappingURL=config-command.js.map

package/dist/cli/config-command.js.map

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

package/dist/cli/context.d.ts

@@ -0,0 +1,65 @@
+import { type Renderer, type RenderFormat, type Streams } from "@wirecat/cli-base";
+import type { Command } from "commander";
+import type { OpenRecognizer } from "../speech/transcribe.js";
+import type { AppIdentity } from "./app.js";
+import { type Closeable } from "./deadline.js";
+import type { EventSink } from "./runs/events.js";
+import type { GlobalFlags, ResolveOptions, Settings } from "./settings.js";
+/** What every CLI's commands write to, when it is not the real terminal. A CLI adds its own fields. */
+export interface BaseEnvironment {
+    streams?: Streams;
+    /** Whether a person is looking. Defaults to whether stdout is a terminal. */
+    tty?: boolean;
+    env?: NodeJS.ProcessEnv;
+    /** Ends a long-running command — `watch` — in place of Ctrl-C; tests hand one in. */
+    commandSignal?: AbortSignal;
+    signal?: AbortSignal;
+    trackCloseable?: (closeable: Closeable) => void;
+    /** Where a command reads text it was not given as an argument. */
+    stdin?: NodeJS.ReadableStream & {
+        isTTY?: boolean;
+    };
+    /** The owner's answer to a question, or `null` with nobody at a terminal; tests hand one in. */
+    answer?: (question: string) => Promise<string | null> | string | null;
+    /** Set by `run()`; a command's run is recorded only when it is known whose run it is. */
+    app?: AppIdentity;
+    /** The local speech recognizer in place of the downloaded model; tests hand one in. */
+    recognizer?: OpenRecognizer;
+}
+export declare const provide: (program: Command, environment: BaseEnvironment) => void;
+export declare const environmentOf: <E extends BaseEnvironment = BaseEnvironment>(command: Command) => E;
+/** For the commands that print but never need settings or a connection. */
+export declare const outputFor: (command: Command) => {
+    format: "json" | "jsonl" | "pretty";
+    color: boolean;
+    streams: Streams;
+    renderer: Renderer;
+};
+export interface BaseContext {
+    settings: Settings;
+    renderer: Renderer;
+    format: RenderFormat;
+    /** Whether the human view may use colour — for views that print their own text. */
+    color: boolean;
+    streams: Streams;
+    env: NodeJS.ProcessEnv;
+    /**
+     * Runs the body inside `--timeout`, closing whatever was tracked when it expires, and records it
+     * when `--record` asks or it fails. Whatever holds the process open — a connection — must be
+     * tracked **before** it can block, or a timed-out command reports the timeout and then hangs.
+     */
+    /**
+     * `unbounded` is for a command that ends itself at `--timeout` — `watch` — rather than failing there.
+     * `name` names the run when one command runs many — each MCP tool call is its own run.
+     */
+    run: <T>(body: (events: EventSink) => Promise<T>, options?: {
+        unbounded?: boolean;
+        name?: string;
+    }) => Promise<T>;
+    track: (closeable: Closeable) => void;
+}
+type Resolve = (flags: GlobalFlags, options?: ResolveOptions) => Settings;
+/** Everything a command needs that no messenger decides, resolved once. */
+export declare const baseContext: (command: Command, resolveSettings: Resolve) => BaseContext;
+export {};
+//# sourceMappingURL=context.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/cli/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAC3C,OAAO,EAAE,KAAK,SAAS,EAAgB,MAAM,eAAe,CAAA;AAG5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE1E,uGAAuG;AACvG,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,6EAA6E;IAC7E,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,qFAAqF;IACrF,aAAa,CAAC,EAAE,WAAW,CAAA;IAC3B,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAA;IAC/C,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;IACnD,gGAAgG;IAChG,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAA;IACrE,yFAAyF;IACzF,GAAG,CAAC,EAAE,WAAW,CAAA;IACjB,uFAAuF;IACvF,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAID,eAAO,MAAM,OAAO,YAAa,OAAO,eAAe,eAAe,KAAG,IAExE,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,CAAC,SAAS,eAAe,GAAG,eAAe,WAAW,OAAO,KAAG,CAC9C,CAAA;AAEhD,2EAA2E;AAC3E,eAAO,MAAM,SAAS,YAAa,OAAO;;;;;CAQzC,CAAA;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,QAAQ,CAAA;IAClB,QAAQ,EAAE,QAAQ,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;IACpB,mFAAmF;IACnF,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;IAChB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAA;IACtB;;;;OAIG;IACH;;;OAGG;IACH,GAAG,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;IACjH,KAAK,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAA;CACtC;AAED,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,cAAc,KAAK,QAAQ,CAAA;AAOzE,2EAA2E;AAC3E,eAAO,MAAM,WAAW,YAAa,OAAO,mBAAmB,OAAO,KAAG,WAoDxE,CAAA"}

package/dist/cli/context.js

@@ -0,0 +1,78 @@
+import { CliError } from "@wirecat/cli-base";
+import { resolveOutput } from "../output.js";
+import { withDeadline } from "./deadline.js";
+import { withAbort } from "./execution.js";
+import { rootOf } from "./profile.js";
+import { recorded } from "./runs/recording.js";
+const environments = new WeakMap();
+export const provide = (program, environment) => {
+    environments.set(program, environment);
+};
+export const environmentOf = (command) => (environments.get(rootOf(command)) ?? {});
+/** For the commands that print but never need settings or a connection. */
+export const outputFor = (command) => {
+    const { streams, tty, env } = environmentOf(command);
+    return resolveOutput({
+        ...command.optsWithGlobals(),
+        ...(streams ? { streams } : {}),
+        ...(env ? { env } : {}),
+        ...(tty === undefined ? {} : { tty }),
+    });
+};
+const detailOf = ({ brief, full }) => {
+    if (brief && full)
+        throw new CliError("validation_error", "--brief and --full ask for opposite things — pick one");
+    return brief ? { hitDetail: "brief" } : full ? { hitDetail: "full" } : {};
+};
+/** Everything a command needs that no messenger decides, resolved once. */
+export const baseContext = (command, resolveSettings) => {
+    const environment = environmentOf(command);
+    const env = environment.env ?? process.env;
+    const settings = resolveSettings(command.optsWithGlobals(), { env });
+    const { renderer, format, color, streams } = resolveOutput({
+        ...settings,
+        env,
+        ...detailOf(command.optsWithGlobals()),
+        ...(command.optsWithGlobals().fields
+            ? { fields: command.optsWithGlobals().fields }
+            : {}),
+        ...(environment.streams ? { streams: environment.streams } : {}),
+        ...(environment.tty === undefined ? {} : { tty: environment.tty }),
+    });
+    const closeables = [];
+    return {
+        settings,
+        renderer,
+        format,
+        color,
+        streams,
+        env,
+        // The deadline inside the record, so a timeout finishes the run as failed rather than leaving it running.
+        run: (body, { unbounded = false, name } = {}) => environment.app
+            ? recorded({
+                app: environment.app,
+                command: name ?? commandPath(command),
+                profile: settings.profile,
+                record: settings.record,
+                keepFailed: settings.keepFailedRuns,
+                trace: settings.trace,
+                keepDays: settings.keepRunsForDays,
+                format,
+                streams,
+                env,
+            }, (events) => withAbort(environment.commandSignal, () => withDeadline(unbounded ? undefined : settings.commandTimeoutMs, closeables, () => body(events))))
+            : withAbort(environment.commandSignal, () => withDeadline(unbounded ? undefined : settings.commandTimeoutMs, closeables, () => body(() => { }))),
+        track: (closeable) => {
+            closeables.push(closeable);
+            environment.trackCloseable?.(closeable);
+        },
+    };
+};
+/** `messages send` — the words that name commands, never the arguments: those can be a message. */
+const commandPath = (command) => {
+    const words = [];
+    for (let current = command; current?.parent; current = current.parent)
+        words.unshift(current.name());
+    return words.join(" ");
+};
+//# sourceMappingURL=context.js.map

package/dist/cli/context.js.map

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

package/dist/cli/deadline.d.ts

@@ -0,0 +1,25 @@
+/** Anything holding something that would keep the process alive — a messenger connection is one. */
+export interface Closeable {
+    close(): Promise<void>;
+}
+/**
+ * Stops the whole command at `ms`, and **closes what it was holding on the way out**.
+ *
+ * ⚠ The closing is the part that matters, and it is what a plain `Promise.race` does not do.
+ * Racing only decides which answer is printed; the losing work carries on, and an open WebSocket
+ * keeps Node alive — so a command that reported a timeout would then sit there, which is worse
+ * than the wait it was cutting short. A test covers exactly that, by
+ * taking the closing away and watching what is left behind.
+ *
+ * A connection closed with a request still in flight must reject that request, not strand it —
+ * that is what lets the body unwind through its own `finally` rather than hanging underneath this.
+ *
+ * ⚠ **It bounds everything, not only what talks to the network.** A local search never opens a
+ * socket at all and still has to fit the budget: an agent handing out thirty seconds does not
+ * know which commands are the networked ones, and a bound that quietly did not apply to some of
+ * them would be worse than no bound.
+ *
+ * Without a bound there is no timer and no race: the ordinary path is exactly what it was.
+ */
+export declare const withDeadline: <T>(ms: number | undefined, closeables: Closeable[], body: () => Promise<T>) => Promise<T>;
+//# sourceMappingURL=deadline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.d.ts","sourceRoot":"","sources":["../../src/cli/deadline.ts"],"names":[],"mappings":"AAGA,oGAAoG;AACpG,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,MAC9B,MAAM,GAAG,SAAS,cACV,SAAS,EAAE,QACjB,MAAM,OAAO,CAAC,CAAC,CAAC,KACrB,OAAO,CAAC,CAAC,CAkCX,CAAA"}

package/dist/cli/deadline.js

@@ -0,0 +1,55 @@
+import { CliError } from "@wirecat/cli-base";
+import { stopWrites, withWriteScope } from "../sends/guarded.js";
+/**
+ * Stops the whole command at `ms`, and **closes what it was holding on the way out**.
+ *
+ * ⚠ The closing is the part that matters, and it is what a plain `Promise.race` does not do.
+ * Racing only decides which answer is printed; the losing work carries on, and an open WebSocket
+ * keeps Node alive — so a command that reported a timeout would then sit there, which is worse
+ * than the wait it was cutting short. A test covers exactly that, by
+ * taking the closing away and watching what is left behind.
+ *
+ * A connection closed with a request still in flight must reject that request, not strand it —
+ * that is what lets the body unwind through its own `finally` rather than hanging underneath this.
+ *
+ * ⚠ **It bounds everything, not only what talks to the network.** A local search never opens a
+ * socket at all and still has to fit the budget: an agent handing out thirty seconds does not
+ * know which commands are the networked ones, and a bound that quietly did not apply to some of
+ * them would be worse than no bound.
+ *
+ * Without a bound there is no timer and no race: the ordinary path is exactly what it was.
+ */
+export const withDeadline = async (ms, closeables, body) => {
+    if (ms === undefined)
+        return body();
+    let timer;
+    let timedOut;
+    const writes = new Set();
+    const expired = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            const pending = [...writes];
+            const cut = pending.filter((write) => !write.preparing);
+            timedOut =
+                cut.length > 0
+                    ? new CliError("outcome_unknown", `\`--timeout\` ended the command after ${ms}ms with ${cut.length === 1 ? "a write" : `${cut.length} writes`} ` +
+                        "in flight; the messenger may or may not have carried it out — check before repeating it", { operation_ids: cut.map((write) => write.operationId), retryable: false })
+                    : new CliError("timeout", `the command did not finish within ${ms}ms — \`--timeout\` ended it`);
+            stopWrites(writes, timedOut);
+            // Sockets first, then the message: the rejection is what the person reads, and the closing
+            // is what lets the process actually end once they have read it.
+            void Promise.allSettled(closeables.map((closeable) => closeable.close())).then(() => reject(timedOut));
+        }, ms);
+    });
+    try {
+        return await Promise.race([withWriteScope(writes, body), expired]);
+    }
+    catch (error) {
+        // Closing rejects the body's own request, and that rejection arrives first.
+        throw timedOut ?? error;
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+};
+//# sourceMappingURL=deadline.js.map

package/dist/cli/deadline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deadline.js","sourceRoot":"","sources":["../../src/cli/deadline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAsB,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAOpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,EAAsB,EACtB,UAAuB,EACvB,IAAsB,EACV,EAAE;IACd,IAAI,EAAE,KAAK,SAAS;QAAE,OAAO,IAAI,EAAE,CAAA;IAEnC,IAAI,KAAiC,CAAA;IACrC,IAAI,QAA8B,CAAA;IAClC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAiB,CAAA;IACvC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YACtB,MAAM,OAAO,GAAG,CAAC,GAAG,MAAM,CAAC,CAAA;YAC3B,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACvD,QAAQ;gBACN,GAAG,CAAC,MAAM,GAAG,CAAC;oBACZ,CAAC,CAAC,IAAI,QAAQ,CACV,iBAAiB,EACjB,yCAAyC,EAAE,WAAW,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,MAAM,SAAS,GAAG;wBAC5G,yFAAyF,EAC3F,EAAE,aAAa,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAC3E;oBACH,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,qCAAqC,EAAE,6BAA6B,CAAC,CAAA;YACnG,UAAU,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;YAC5B,2FAA2F;YAC3F,gEAAgE;YAChE,KAAK,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;QACxG,CAAC,EAAE,EAAE,CAAC,CAAA;IACR,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAA;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4EAA4E;QAC5E,MAAM,QAAQ,IAAI,KAAK,CAAA;IACzB,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAA;IAChC,CAAC;AACH,CAAC,CAAA"}

package/dist/cli/default-config.d.ts

@@ -0,0 +1,13 @@
+export declare const DEFAULT_CONFIG: {
+    defaults: {
+        limit: number;
+        keepRunsForDays: number;
+        sendsPerHour: number;
+        updateCheck: boolean;
+        skillHint: boolean;
+    };
+    profiles: {};
+};
+/** Publish a complete starter file without replacing a concurrent first run or the owner's settings. */
+export declare function ensureDefaultConfig(path: string): void;
+//# sourceMappingURL=default-config.d.ts.map

package/dist/cli/default-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.d.ts","sourceRoot":"","sources":["../../src/cli/default-config.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc;IACzB,QAAQ;QAAI,KAAK;QAAM,eAAe;QAAM,YAAY;QAAM,WAAW;QAAQ,SAAS;;IAC1F,QAAQ;CACT,CAAA;AAED,wGAAwG;AACxG,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAgBtD"}

package/dist/cli/default-config.js

@@ -0,0 +1,29 @@
+import { existsSync, linkSync, mkdirSync, mkdtempSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+export const DEFAULT_CONFIG = {
+    defaults: { limit: 20, keepRunsForDays: 30, sendsPerHour: 30, updateCheck: true, skillHint: true },
+    profiles: {},
+};
+/** Publish a complete starter file without replacing a concurrent first run or the owner's settings. */
+export function ensureDefaultConfig(path) {
+    if (existsSync(path))
+        return;
+    const directory = dirname(path);
+    mkdirSync(directory, { recursive: true, mode: 0o700 });
+    const temporary = mkdtempSync(join(directory, ".config-"));
+    const candidate = join(temporary, "config.json");
+    try {
+        writeFileSync(candidate, `${JSON.stringify(DEFAULT_CONFIG, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+        try {
+            linkSync(candidate, path);
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+        }
+    }
+    finally {
+        rmSync(temporary, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=default-config.js.map

package/dist/cli/default-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-config.js","sourceRoot":"","sources":["../../src/cli/default-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC7F,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEzC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,QAAQ,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE;IAClG,QAAQ,EAAE,EAAE;CACb,CAAA;AAED,wGAAwG;AACxG,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAM;IAC5B,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACtD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAA;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;IAChD,IAAI,CAAC;QACH,aAAa,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QACrG,IAAI,CAAC;YACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC3B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,KAAK,CAAA;QACrE,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACrD,CAAC;AACH,CAAC"}