@wirecat/cli-core 0.20.0 → 0.262.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/cli/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE5E,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,CAAA;AAE/C,eAAO,MAAM,YAAY,UAAW;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,KAAG,eAqE/F,CAAA"}

package/dist/cli/recovery.js

@@ -0,0 +1,70 @@
+export const withRecovery = (error) => {
+    const wait = Number(error.retry_after_ms);
+    const rate = error.code === "rate_limited" || error.status === 429;
+    const actions = [];
+    if (rate) {
+        actions.push({
+            type: "wait",
+            message: "Wait before retrying; do not immediately repeat requests.",
+            ...(Number.isFinite(wait) && wait >= 0 ? { afterMs: wait } : {}),
+        });
+        actions.push({ type: "retry", message: "Resume the unfinished items after the provider's wait." });
+    }
+    else {
+        const setting = typeof error.setting === "string"
+            ? error.setting
+            : error.message.match(/MESSAGING_[A-Z_]+|--(?:max-output-bytes|timeout|max-input-bytes)/)?.[0];
+        if (setting)
+            actions.push({ type: "configure", setting, message: `Check or increase ${setting}, then retry the failed item.` });
+        else if (/already exists/i.test(error.message))
+            actions.push({
+                type: "check",
+                message: "Choose another output folder/name or skip the existing file; it was not overwritten.",
+            });
+        else if (error.code === "ENOSPC")
+            actions.push({ type: "check", message: "Free disk space or choose another output folder before resuming." });
+        else if (error.code === "cancelled")
+            actions.push({ type: "retry", message: "Resume unfinished read items when ready; completed work is retained." });
+        else if (error.limitSource === "local" && /size limit|too.large|exceeds/i.test(error.message))
+            actions.push({
+                type: "check",
+                message: "Split the document or use another reader; local decompression/text budgets remain separate from the configurable file-size budget.",
+            });
+        else if (error.status === 413 || /too.large|exceeds|size limit/i.test(error.message))
+            actions.push({
+                type: "check",
+                message: "Use a smaller file, lower image resolution or split the input; provider limits cannot be raised in local settings.",
+            });
+        else if (error.code === "authentication_error")
+            actions.push({
+                type: "check",
+                message: "Check the selected account/profile and reconnect or sign in before resuming.",
+            });
+        else if (error.code === "permission_error")
+            actions.push({ type: "check", message: "Check the selected profile's permissions and access to this item." });
+        else if (error.code === "timeout" || error.code === "network_error")
+            actions.push({
+                type: "check",
+                message: "Check connectivity and timeout settings, then retry unfinished read operations.",
+            });
+        else if (error.code === "not_found")
+            actions.push({
+                type: "check",
+                message: "Check the item ID or path; it may have been removed or may need downloading again.",
+            });
+        else if (error.code === "outcome_unknown")
+            actions.push({
+                type: "check",
+                message: "Verify whether the operation completed before retrying; replay could duplicate a write.",
+            });
+        else
+            actions.push({ type: "check", message: "Check the reported input or provider error before retrying." });
+        actions.push({ type: "skip", message: "Skip this item and continue independent work." });
+    }
+    return {
+        ...error,
+        retryable: typeof error.retryable === "boolean" ? error.retryable : rate,
+        actions: Array.isArray(error.actions) ? error.actions : actions,
+    };
+};
+//# sourceMappingURL=recovery.js.map

package/dist/cli/recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.js","sourceRoot":"","sources":["../../src/cli/recovery.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAgE,EAAmB,EAAE;IAChH,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAA;IACzC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,CAAA;IAClE,MAAM,OAAO,GAAqB,EAAE,CAAA;IACpC,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,2DAA2D;YACpE,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACjE,CAAC,CAAA;QACF,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,wDAAwD,EAAE,CAAC,CAAA;IACpG,CAAC;SAAM,CAAC;QACN,MAAM,OAAO,GACX,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YAC/B,CAAC,CAAC,KAAK,CAAC,OAAO;YACf,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,kEAAkE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAClG,IAAI,OAAO;YACT,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,qBAAqB,OAAO,+BAA+B,EAAE,CAAC,CAAA;aAC/G,IAAI,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,sFAAsF;aAChG,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAC9B,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,kEAAkE,EAAE,CAAC,CAAA;aACzG,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YACjC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,sEAAsE,EAAE,CAAC,CAAA;aAC7G,IAAI,KAAK,CAAC,WAAW,KAAK,OAAO,IAAI,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAC3F,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EACL,oIAAoI;aACvI,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,+BAA+B,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;YAClF,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EACL,oHAAoH;aACvH,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB;YAC5C,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,8EAA8E;aACxF,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,IAAI,KAAK,kBAAkB;YACxC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,mEAAmE,EAAE,CAAC,CAAA;aAC1G,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe;YACjE,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,iFAAiF;aAC3F,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;YACjC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,oFAAoF;aAC9F,CAAC,CAAA;aACC,IAAI,KAAK,CAAC,IAAI,KAAK,iBAAiB;YACvC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,yFAAyF;aACnG,CAAC,CAAA;;YACC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,6DAA6D,EAAE,CAAC,CAAA;QAC5G,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,+CAA+C,EAAE,CAAC,CAAA;IAC1F,CAAC;IACD,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE,OAAO,KAAK,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QACxE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,OAA4B,CAAC,CAAC,CAAC,OAAO;KACtF,CAAA;AACH,CAAC,CAAA"}

package/dist/cli/registry-keys.d.ts

@@ -0,0 +1,8 @@
+import { type AppIdentity } from "./app.js";
+/**
+ * Combot's key for CAS, where the owner keeps one: the keyring account `registries:cas` under the
+ * app's own service, `<PREFIX>_CAS_API_KEY`, or a 0600 file — as the AI providers' keys are. CAS
+ * answers without one for now; never printed, never in an error.
+ */
+export declare const casKey: (app: AppIdentity, env?: NodeJS.ProcessEnv) => string | undefined;
+//# sourceMappingURL=registry-keys.d.ts.map

package/dist/cli/registry-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-keys.d.ts","sourceRoot":"","sources":["../../src/cli/registry-keys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,WAAW,EAAW,MAAM,UAAU,CAAA;AAEpD;;;;GAIG;AACH,eAAO,MAAM,MAAM,QAAS,WAAW,QAAO,MAAM,CAAC,UAAU,KAAiB,MAAM,GAAG,SAUxF,CAAA"}

package/dist/cli/registry-keys.js

@@ -0,0 +1,19 @@
+import { Credentials, pathsAreOverridden, resolvePaths } from "@wirecat/cli-base";
+import { envName } from "./app.js";
+/**
+ * Combot's key for CAS, where the owner keeps one: the keyring account `registries:cas` under the
+ * app's own service, `<PREFIX>_CAS_API_KEY`, or a 0600 file — as the AI providers' keys are. CAS
+ * answers without one for now; never printed, never in an error.
+ */
+export const casKey = (app, env = process.env) => {
+    const where = { appName: app.appName, prefix: app.envPrefix, env };
+    return new Credentials({
+        configDir: resolvePaths(where).config,
+        service: app.appName,
+        envVar: envName(app, "CAS_API_KEY"),
+        isolated: pathsAreOverridden(where),
+        env,
+        warn: (message) => process.stderr.write(`${message}\n`),
+    }).read("registries:cas")?.secret;
+};
+//# sourceMappingURL=registry-keys.js.map

package/dist/cli/registry-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-keys.js","sourceRoot":"","sources":["../../src/cli/registry-keys.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AACjF,OAAO,EAAoB,OAAO,EAAE,MAAM,UAAU,CAAA;AAEpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAgB,EAAE,GAAG,GAAsB,OAAO,CAAC,GAAG,EAAsB,EAAE;IACnG,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,SAAS,EAAE,GAAG,EAAE,CAAA;IAClE,OAAO,IAAI,WAAW,CAAC;QACrB,SAAS,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,MAAM;QACrC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,aAAa,CAAC;QACnC,QAAQ,EAAE,kBAAkB,CAAC,KAAK,CAAC;QACnC,GAAG;QACH,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC;KACxD,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAA;AACnC,CAAC,CAAA"}

package/dist/cli/result-fields.d.ts

@@ -0,0 +1,3 @@
+export { fieldsOf } from "@wirecat/cli-base";
+export declare const projectFields: (value: unknown, fields: readonly string[]) => unknown;
+//# sourceMappingURL=result-fields.d.ts.map

package/dist/cli/result-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-fields.d.ts","sourceRoot":"","sources":["../../src/cli/result-fields.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAK5C,eAAO,MAAM,aAAa,UAAW,OAAO,UAAU,SAAS,MAAM,EAAE,KAAG,OACsB,CAAA"}

package/dist/cli/result-fields.js

@@ -0,0 +1,6 @@
+import { projectFields as coreProjectFields } from "@wirecat/cli-base";
+export { fieldsOf } from "@wirecat/cli-base";
+/** cli-base keeps `operation_id` and `send_id`; this package's results still say `operationId` and `sendId`. */
+const CORRELATION = ["operationId", "sendId"];
+export const projectFields = (value, fields) => coreProjectFields(value, [...fields, ...CORRELATION.filter((name) => !fields.includes(name))]);
+//# sourceMappingURL=result-fields.js.map

package/dist/cli/result-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-fields.js","sourceRoot":"","sources":["../../src/cli/result-fields.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAE5C,gHAAgH;AAChH,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAA;AAE7C,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,MAAyB,EAAW,EAAE,CAClF,iBAAiB,CAAC,KAAK,EAAE,CAAC,GAAG,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA"}

package/dist/cli/runs/command.d.ts

@@ -0,0 +1,5 @@
+import { Command } from "commander";
+import type { AppIdentity } from "../app.js";
+/** Reading the log is not itself worth recording, so **nothing here starts a run**. */
+export declare const runsCommand: (app: AppIdentity) => Command;
+//# sourceMappingURL=command.d.ts.map

package/dist/cli/runs/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/cli/runs/command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAM5C,uFAAuF;AACvF,eAAO,MAAM,WAAW,QAAS,WAAW,KAAG,OA0E9C,CAAA"}

package/dist/cli/runs/command.js

@@ -0,0 +1,75 @@
+import { CliError } from "@wirecat/cli-base";
+import { Command, Option } from "commander";
+import { environmentOf, outputFor } from "../context.js";
+import { positiveCount, renderPage } from "../paging.js";
+import { findRun, listRuns, readEvents, runsDirFor } from "./run.js";
+import { searchRuns } from "./search.js";
+/** Reading the log is not itself worth recording, so **nothing here starts a run**. */
+export const runsCommand = (app) => {
+    const command = new Command("runs").description("recorded runs — what this tool did, and when");
+    const dir = (from) => runsDirFor(app, environmentOf(from).env ?? process.env);
+    const runOrRefuse = (from, id) => {
+        const found = findRun(dir(from), id);
+        if (!found)
+            throw new CliError("not_found", `no recorded run "${id}" — \`${app.command} runs list\` shows them`);
+        return found;
+    };
+    command
+        .command("list")
+        .description("recorded runs, newest first")
+        .option("--limit <n>", "how many to show", positiveCount("--limit"), 20)
+        .action(function () {
+        const { limit } = this.opts();
+        const output = outputFor(this);
+        const { renderer } = output;
+        const runs = listRuns(dir(this), { atLeast: limit + 1 });
+        renderPage({ ...output, settings: { page: 1, limit, all: false } }, { items: runs.slice(0, limit), hasMore: runs.length > limit }, undefined, () => "more recorded runs — increase `--limit` to show them");
+        if (runs.length === 0)
+            renderer.note("nothing recorded — a run is kept with `--record`, or when it fails");
+    });
+    command
+        .command("show")
+        .argument("<run-id>", `an id from \`${app.command} runs list\``)
+        .description("one run: what it was, how it ended and what went wrong; -v for every event")
+        .action(function (id) {
+        const { renderer } = outputFor(this);
+        const found = runOrRefuse(this, id);
+        const events = readEvents(found.dir).map(readable);
+        const all = (this.optsWithGlobals().verbose ?? 0) > 0;
+        const shown = all ? events : events.filter(notable);
+        renderer.result({ ...found.metadata, directory: found.dir, eventCount: events.length, events: shown });
+        if (shown.length < events.length)
+            renderer.note(`${events.length - shown.length} more events — \`${app.command} runs show ${id} -v\` shows them all`);
+    });
+    command
+        .command("search")
+        .description("search recorded diagnostic metadata and events; no message contents")
+        .argument("[query]", "case-insensitive literal diagnostic text")
+        .addOption(new Option("--status <status>", "run outcome").choices(["success", "failed", "partial", "running"]))
+        .option("--error-code <code>", "one stable error code")
+        .option("--operation <name>", "one operation, such as messages.download")
+        .option("--profile <name>", "one recorded profile")
+        .option("--since-time <time>", "runs starting on or after an ISO time or 2h / 1d ago")
+        .option("--limit <n>", "matches per page, at most 100", positiveCount("--limit"), 20)
+        .option("--page <n>", "result page", positiveCount("--page"), 1)
+        .action(function (query) {
+        outputFor(this).renderer.result(searchRuns(dir(this), {
+            ...this.opts(),
+            since: this.opts().sinceTime,
+            ...(query === undefined ? {} : { query }),
+        }));
+    });
+    command
+        .command("path")
+        .argument("<run-id>", `an id from \`${app.command} runs list\``)
+        .description("the directory holding one run")
+        .action(function (id) {
+        outputFor(this).renderer.result({ path: runOrRefuse(this, id).dir });
+    });
+    return command;
+};
+/** What went wrong, and nothing that went right. */
+const notable = (event) => event.outcome === "error" || event.event === "warning" || event.event === "crash";
+/** Drops what the logger puts on every line and `show` already prints once above the events. */
+const readable = ({ level, runId, command, profile, ...event }) => event;
+//# sourceMappingURL=command.js.map

package/dist/cli/runs/command.js.map

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

package/dist/cli/runs/events.d.ts

@@ -0,0 +1,61 @@
+/**
+ * One operation against the messenger, as both sinks see it: `--trace` renders it, a recorded run
+ * writes it as a line of JSON.
+ *
+ * ⚠ **Nothing here may carry content.** An operation name, an id, a count, a duration and an error
+ * code are safe. A chat title, a name, a message body, a phone number or a token are not — not
+ * truncated and not hashed. The adapter builds `ids` and `counts` from fields it names, never by
+ * copying a request, and never from what the person typed: a typed chat is often a title.
+ */
+export interface RequestEvent {
+    event: "request" | "response";
+    /** Ours, not the messenger's: `messages.send`. */
+    operation: string;
+    /** A frame protocol's own numbering (max-cli's personal protocol); an HTTP API says `status` instead. */
+    opcode?: number;
+    seq?: number;
+    status?: number;
+    /** The size of what went out or came back. */
+    bytes?: number;
+    ids?: Record<string, string>;
+    /** How many things, per field: `{ messages: 3 }`. */
+    counts?: Record<string, number>;
+    durationMs?: number;
+    outcome?: "ok" | "error";
+    /** cli-base's code — `timeout`, `provider_error`. Never the message: a messenger quotes our payload. */
+    errorCode?: string;
+    /** The messenger's own name for a refusal, when it is shaped like one (`providerErrorKey`). */
+    providerError?: string;
+}
+/** Something the client noticed and went on without. A code, never the sentence. */
+export interface WarningEvent {
+    event: "warning";
+    code: string;
+    operation?: string;
+    /** Field paths and types for an answer of an unexpected shape — built without the values. */
+    detail?: string;
+}
+/** A read answered locally, without asking the messenger, and why. */
+export interface CacheEvent {
+    event: "cache";
+    operation: string;
+    reason: string;
+    ids?: Record<string, string>;
+    counts?: Record<string, number>;
+    /** How old the kept answer was. */
+    ageMs?: number;
+}
+export type DiagnosticEvent = RequestEvent | CacheEvent | WarningEvent;
+export type EventSink = (event: DiagnosticEvent) => void;
+/** `FLOOD_WAIT`, `PEER_ID_INVALID`, `login.token` — or nothing. A sentence is dropped, not trimmed. */
+export declare const providerErrorKey: (value: unknown) => string | undefined;
+/**
+ * The line a person reads. `→` is what we asked, `←` what came back.
+ *
+ * ```text
+ * → messages.list    chat 777
+ * ← messages.list    chat 777  118ms  3 messages
+ * ```
+ */
+export declare const renderEvent: (event: DiagnosticEvent) => string;
+//# sourceMappingURL=events.d.ts.map

package/dist/cli/runs/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/cli/runs/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,GAAG,UAAU,CAAA;IAC7B,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAA;IACjB,yGAAyG;IACzG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8CAA8C;IAC9C,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAA;IACxB,wGAAwG;IACxG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,MAAM,CAAA;CACvB;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,SAAS,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,eAAe,GAAG,YAAY,GAAG,UAAU,GAAG,YAAY,CAAA;AAEtE,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;AAExD,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,UAAW,OAAO,KAAG,MAAM,GAAG,SACoC,CAAA;AAE/F;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,UAAW,eAAe,KAAG,MA2BpD,CAAA"}

package/dist/cli/runs/events.js

@@ -0,0 +1,52 @@
+/** `FLOOD_WAIT`, `PEER_ID_INVALID`, `login.token` — or nothing. A sentence is dropped, not trimmed. */
+export const providerErrorKey = (value) => typeof value === "string" && /^[A-Za-z][A-Za-z0-9._-]{0,63}$/.test(value) ? value : undefined;
+/**
+ * The line a person reads. `→` is what we asked, `←` what came back.
+ *
+ * ```text
+ * → messages.list    chat 777
+ * ← messages.list    chat 777  118ms  3 messages
+ * ```
+ */
+export const renderEvent = (event) => {
+    if (event.event === "warning") {
+        return [`${MARK.warning} ${(event.operation ?? "").padEnd(16)} ${event.code}`, event.detail]
+            .filter(Boolean)
+            .join("  ");
+    }
+    const parts = [];
+    if (event.event === "cache") {
+        parts.push(event.reason);
+        if (event.ageMs !== undefined)
+            parts.push(`cached ${age(event.ageMs)}`);
+    }
+    else {
+        if (event.opcode !== undefined)
+            parts.push(`op ${event.opcode}`, `seq ${event.seq}`);
+        if (event.status !== undefined)
+            parts.push(`${event.status}`);
+    }
+    if (event.ids)
+        for (const [name, value] of Object.entries(event.ids))
+            parts.push(`${name} ${value}`);
+    if (event.event !== "cache") {
+        if (event.durationMs !== undefined)
+            parts.push(`${event.durationMs}ms`);
+        if (event.bytes !== undefined)
+            parts.push(size(event.bytes));
+    }
+    if (event.counts)
+        for (const [field, count] of Object.entries(event.counts))
+            parts.push(`${count} ${field}`);
+    if (event.event !== "cache") {
+        if (event.errorCode)
+            parts.push(event.errorCode);
+        if (event.providerError)
+            parts.push(event.providerError);
+    }
+    return `${MARK[event.event]} ${event.operation.padEnd(16)} ${parts.join("  ")}`.trimEnd();
+};
+const MARK = { request: "→", response: "←", cache: "•", warning: "!" };
+const age = (ms) => (ms < 1000 ? `${ms}ms` : `${Math.round(ms / 1000)}s`);
+const size = (bytes) => (bytes < 1000 ? `${bytes} B` : `${(bytes / 1000).toFixed(1)} kB`);
+//# sourceMappingURL=events.js.map

package/dist/cli/runs/events.js.map

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

package/dist/cli/runs/recording.d.ts

@@ -0,0 +1,51 @@
+import { type RenderFormat, type Streams } from "@wirecat/cli-base";
+import type { AppIdentity } from "../app.js";
+import { type EventSink } from "./events.js";
+export interface RecordingOptions {
+    app: AppIdentity;
+    /** As typed, without the arguments: `chats list`. It names the run directory. */
+    command: string;
+    profile: string;
+    record: boolean;
+    /** Keep the run if it fails, even though `record` is off. */
+    keepFailed: boolean;
+    trace: boolean;
+    /** Diagnostics follow the data stream: text for a person, one JSON object per line otherwise. */
+    format: RenderFormat;
+    streams?: Streams;
+    env?: NodeJS.ProcessEnv;
+    runsDir?: string;
+    keepDays?: number;
+    now?: () => Date;
+}
+/**
+ * Runs one command with the diagnostics turned on, and **finalizes on every path**.
+ *
+ * `--trace` shows each event as it happens and keeps nothing, `--record` keeps it and shows
+ * nothing. It is a wrapper rather than three lines in each command because the failure it prevents
+ * is the quiet one: a run directory left saying `running` because the command threw on the way out.
+ */
+export declare const recorded: <T>(options: RecordingOptions, body: (events: EventSink) => Promise<T>) => Promise<T>;
+export interface Recording {
+    /** Given now, before the run is kept or not, so whatever the command writes can name it. */
+    runId: string;
+    events: EventSink;
+    succeed: (answer?: unknown) => Promise<void>;
+    /** Marks the error as dealt with, so the program's last catch does not keep it a second time. */
+    fail: (error: unknown) => Promise<void>;
+}
+/** `recorded` in two halves, for a caller that starts a run before its command and ends it after (max-cli's `max bot`). */
+export declare const startRecording: (options: RecordingOptions) => Recording;
+export declare const wasSettled: (error: unknown) => boolean;
+/**
+ * Where a crash happened, not what it said: the class and up to ten frames as `function file:line`,
+ * paths cut to what follows `dist/` or `src/`. **Never `message`** — it can hold whatever the
+ * failing line was handling.
+ */
+export declare const crashOf: (error: unknown) => {
+    event: "crash";
+    errorName: string;
+    frames: string[];
+};
+export declare const partialOutcome: (answer: unknown) => import("./run.js").RunMetadata["partial"];
+//# sourceMappingURL=recording.d.ts.map

package/dist/cli/runs/recording.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording.d.ts","sourceRoot":"","sources":["../../../src/cli/runs/recording.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,OAAO,EAAwB,KAAK,SAAS,EAAiC,MAAM,aAAa,CAAA;AAIjG,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,WAAW,CAAA;IAChB,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,6DAA6D;IAC7D,UAAU,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,iGAAiG;IACjG,MAAM,EAAE,YAAY,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,IAAI,CAAA;CACjB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAU,CAAC,WAAW,gBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CAU/G,CAAA;AAED,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5C,iGAAiG;IACjG,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACxC;AAED,2HAA2H;AAC3H,eAAO,MAAM,cAAc,YAAa,gBAAgB,KAAG,SA6D1D,CAAA;AAKD,eAAO,MAAM,UAAU,UAAW,OAAO,KAAG,OAA4E,CAAA;AAqBxH;;;;GAIG;AACH,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAc7F,CAAA;AAED,eAAO,MAAM,cAAc,WAAY,OAAO,KAAG,OAAO,UAAU,EAAE,WAAW,CAAC,SAAS,CAyBxF,CAAA"}

package/dist/cli/runs/recording.js

@@ -0,0 +1,152 @@
+import { processStreams } from "@wirecat/cli-base";
+import { isCliFailure } from "../failures.js";
+import { providerErrorKey, renderEvent } from "./events.js";
+import { newRunId, runsDirFor, startRun } from "./run.js";
+import { inRun } from "./scope.js";
+/**
+ * Runs one command with the diagnostics turned on, and **finalizes on every path**.
+ *
+ * `--trace` shows each event as it happens and keeps nothing, `--record` keeps it and shows
+ * nothing. It is a wrapper rather than three lines in each command because the failure it prevents
+ * is the quiet one: a run directory left saying `running` because the command threw on the way out.
+ */
+export const recorded = async (options, body) => {
+    const recording = startRecording(options);
+    try {
+        const answer = await inRun({ runId: recording.runId, command: options.command }, () => body(recording.events));
+        await recording.succeed(answer);
+        return answer;
+    }
+    catch (error) {
+        await recording.fail(error);
+        throw error;
+    }
+};
+/** `recorded` in two halves, for a caller that starts a run before its command and ends it after (max-cli's `max bot`). */
+export const startRecording = (options) => {
+    const streams = options.streams ?? processStreams;
+    const now = options.now ?? (() => new Date());
+    const startedAt = now();
+    const runId = newRunId(startedAt, options.command);
+    const open = (extra = {}) => startRun({
+        runsDir: options.runsDir ?? runsDirFor(options.app, options.env),
+        runId,
+        command: options.command,
+        profile: options.profile,
+        service: options.app.command,
+        cliVersion: options.app.version,
+        // The operation has happened or is under way, and failing the command now invites a retry
+        // that sends twice.
+        onError: (error) => {
+            const warning = `this run is not recorded past this point: ${error.message}`;
+            streams.diagnostic(options.format === "pretty" ? warning : JSON.stringify({ warning }));
+        },
+        ...(options.keepDays === undefined ? {} : { keepDays: options.keepDays }),
+        now,
+        ...extra,
+    });
+    const run = options.record ? open({ startedAt }) : undefined;
+    // Unrecorded, the newest events are held until the outcome is known, so a failure can still be kept.
+    const held = !run && options.keepFailed ? [] : undefined;
+    let requests = 0;
+    const events = (event) => {
+        if (event.event === "request")
+            requests += 1;
+        if (options.trace)
+            streams.diagnostic(options.format === "pretty" ? renderEvent(event) : JSON.stringify(event));
+        if (run)
+            logEvent(run, event);
+        if (held) {
+            held.push(event);
+            if (held.length > HELD_AT_MOST)
+                held.shift();
+        }
+    };
+    return {
+        runId,
+        events,
+        succeed: async (answer) => {
+            const partial = partialOutcome(answer);
+            const kept = run ?? (partial && held ? keep(open({ startedAt }), held) : undefined);
+            await kept?.finish(partial ? "partial" : "success", { requests, ...(partial ? { partial } : {}) });
+        },
+        fail: async (error) => {
+            const failed = run ?? (held ? keep(open({ startedAt }), held) : undefined);
+            if (failed) {
+                if (!isCliFailure(error))
+                    failed.logger.error(crashOf(error));
+                await failed.finish("failed", {
+                    requests,
+                    ...outcomeOf(error),
+                    ...(run ? {} : { keptBecauseFailed: true }),
+                });
+            }
+            if (typeof error === "object" && error !== null)
+                settled.add(error);
+        },
+    };
+};
+/** Failures a run already dealt with — kept, or not kept by the owner's choice. `run()`'s last catch skips them. */
+const settled = new WeakSet();
+export const wasSettled = (error) => typeof error === "object" && error !== null && settled.has(error);
+const HELD_AT_MOST = 500;
+const keep = (run, events) => {
+    for (const event of events)
+        logEvent(run, event);
+    return run;
+};
+const logEvent = (run, event) => {
+    if (event.event === "warning")
+        run.logger.warn(event);
+    else if (event.event !== "cache" && event.outcome === "error")
+        run.logger.error(event);
+    else
+        run.logger.info(event);
+};
+const outcomeOf = (error) => {
+    if (!isCliFailure(error))
+        return { errorCode: "generic_failure" };
+    const providerError = providerErrorKey(error.details?.providerError);
+    return { errorCode: error.code, ...(providerError ? { providerError } : {}) };
+};
+/**
+ * Where a crash happened, not what it said: the class and up to ten frames as `function file:line`,
+ * paths cut to what follows `dist/` or `src/`. **Never `message`** — it can hold whatever the
+ * failing line was handling.
+ */
+export const crashOf = (error) => {
+    const stack = error instanceof Error && typeof error.stack === "string" ? error.stack : "";
+    const frames = stack
+        .split("\n")
+        .filter((line) => line.trimStart().startsWith("at "))
+        .slice(0, 10)
+        .map((line) => {
+        const match = /^\s*at (?:(.+?) \()?(.+?):(\d+):\d+\)?$/.exec(line);
+        if (!match)
+            return "?";
+        const [, fn, path = "", lineNumber] = match;
+        const file = /(?:^|\/)(?:dist|src)\/(.+)$/.exec(path)?.[1] ?? path.split("/").at(-1);
+        return `${fn ?? "<anonymous>"} ${file}:${lineNumber}`;
+    });
+    return { event: "crash", errorName: error instanceof Error ? error.name : typeof error, frames };
+};
+export const partialOutcome = (answer) => {
+    if (!answer || typeof answer !== "object")
+        return undefined;
+    const body = answer;
+    if (body.batch?.failed)
+        return {
+            failed: body.batch.failed,
+            ...(body.batch.stopReason ? { stopReason: body.batch.stopReason } : {}),
+            failures: (body.batch.failures ?? []).map((failure) => ({
+                id: failure.id,
+                stage: failure.stage,
+                errorCode: failure.error.code,
+                ...(failure.attachment === undefined ? {} : { attachment: failure.attachment }),
+            })),
+        };
+    if (body.issue)
+        return { failed: 1, failures: [{ id: body.chat ?? "history", stage: "history", errorCode: body.issue.code }] };
+    return undefined;
+};
+//# sourceMappingURL=recording.js.map

package/dist/cli/runs/recording.js.map

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