@wirecat/cli-core 0.466.0 → 0.468.0

package/dist/cli/messenger/report.js

@@ -17,6 +17,14 @@ const EVENT_FIELDS = [
     "error_code",
     "provider_error",
     "code",
+    "level",
+    "transport",
+    "attempt",
+    "wait_ms",
+    "method",
+    "endpoint_template",
+    "status",
+    "dropped",
 ];
 /**
  * **Everything a report holds is already free of content** — the doctor, the run log and the send
@@ -38,7 +46,7 @@ export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new
         },
         run: chosen
             ? {
-                metadata: maskedRun(chosen.metadata, program),
+                metadata: maskedRun(chosen.metadata, label, program),
                 events: readEvents(chosen.dir).map(eventOf(label, eventFields)),
             }
             : null,
@@ -46,8 +54,43 @@ export const buildReport = ({ doctor, runsDir, runId, command, sends, now = new
     };
     return JSON.parse(hideHome(JSON.stringify(report), home));
 };
-// A report leaves the machine, so it masks the typed words as `record_input: false` would.
-const maskedRun = (metadata, program = new Command()) => metadata.argv ? { ...metadata, argv: maskArgv(program, metadata.argv).argv } : metadata;
+/**
+ * A report leaves the machine, so it masks the typed words as `record_input: false` would, and every id that ties it
+ * to a session, a connection, a trace, an app or a chat becomes a label, as the events' ids do.
+ */
+const maskedRun = (metadata, label, program = new Command()) => {
+    const { agent, mcp, partial, traceId } = metadata;
+    return {
+        ...metadata,
+        ...(metadata.argv ? { argv: maskArgv(program, metadata.argv).argv } : {}),
+        ...(traceId ? { traceId: label(traceId) } : {}),
+        ...(agent
+            ? {
+                agent: {
+                    ...agent,
+                    session_id: agent.session_id === null ? null : label(agent.session_id),
+                    ...(agent.client
+                        ? { client: { ...agent.client, ...(agent.client.id ? { id: label(agent.client.id) } : {}) } }
+                        : {}),
+                },
+            }
+            : {}),
+        ...(mcp
+            ? {
+                mcp: {
+                    ...mcp,
+                    ...(mcp.request_id ? { request_id: label(mcp.request_id) } : {}),
+                    ...(mcp.connection_id ? { connection_id: label(mcp.connection_id) } : {}),
+                },
+            }
+            : {}),
+        ...(partial
+            ? {
+                partial: { ...partial, failures: partial.failures.map((failure) => ({ ...failure, id: label(failure.id) })) },
+            }
+            : {}),
+    };
+};
 /**
  * Every field of a journal line that names a chat, a message or a write. A send's `operationId` is
  * its `sendId`, so one left raw would undo the other's label.
@@ -105,6 +148,8 @@ const RECORDED_ID_FIELDS = new Set([
 const eventOf = (label, fields) => (event) => {
     const kept = Object.fromEntries(Object.entries(event)
         .filter(([key]) => (fields === "recorded" ? RECORDED_FIELDS.has(key) : EVENT_FIELDS.includes(key)))
+        // A line from before records were nested holds pino's numeric `level`, not the request's layer.
+        .filter(([key, value]) => key !== "level" || typeof value === "string")
         .map(([key, value]) => [
         key,
         fields === "recorded" && RECORDED_ID_FIELDS.has(key) && value !== undefined && value !== null

package/dist/cli/program.d.ts

@@ -13,7 +13,7 @@ export interface ProgramDefinition {
         permissionKey?: (path: readonly string[]) => string | null | undefined;
         /** A CLI's own keys (`commandPermissions`), from `settingsFor`: its commands are refused by them before they run. */
         permissions?: CommandPermissions | undefined;
-        resolveSettings: (flags?: GlobalFlags, options?: ResolveOptions) => Pick<Settings, "profile" | "keepFailedRuns" | "keepRunsForDays" | "skillHint"> & Partial<Pick<Settings, "recordInput" | "permissions" | "permissionSources" | "configPath" | "savedPermissions" | "sources">>;
+        resolveSettings: (flags?: GlobalFlags, options?: ResolveOptions) => Pick<Settings, "profile" | "keepFailedRuns" | "keepRunsForDays" | "skillHint"> & Partial<Pick<Settings, "recordInput" | "keepSuccessfulRunsForDays" | "permissions" | "permissionSources" | "configPath" | "savedPermissions" | "sources">>;
     };
     configure?: (program: Command) => void;
     /** The tool's pitch and "what you can do" lines on `--help` and a bare run. */

package/dist/cli/program.js

@@ -31,7 +31,7 @@ import { commandWords, isProfileName, liftProfile, sampleCommand, takesProfile,
 import { absolutePaths, relayTarget } from "./relay-route.js";
 import { NoProfileHere, namedProfile, settingsFor, } from "./settings.js";
 import { assertSharedContracts } from "./shared-contracts.js";
-import { commandAt, lineOf, withLines } from "./steps.js";
+import { commandAt, failureSteps, lineOf, withLines } 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.
@@ -69,8 +69,8 @@ export const createProgram = ({ app, commands, configure, firstScreen }, { out,
         .option("--full", `${found} 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, with the command as typed and secrets hidden; record_input false leaves the typed words out")
-        .option("--no-record", "do not keep it, whatever the configuration says")
+        .option("--record", "keep this run even where the config says record false; record_input false leaves the typed words out")
+        .option("--no-record", "do not keep this run, even if it fails")
         .showHelpAfterError();
     for (const command of mounted)
         program.addCommand(command);
@@ -617,7 +617,8 @@ const keepFailure = async (failure, { definition, program, rest, argv, profile,
             program,
             argv,
             env,
-            recordInput: settings ? settings.recordInput !== false : false,
+            recordInput: settings ? (settings.recordInput ?? true) : false,
+            caller: options.agent?.caller,
         }),
         // Settings that did not load never accepted the word, which may be a refused name or somebody's words.
         profile: settings ? namedProfile(settings) : undefined,
@@ -628,6 +629,9 @@ const keepFailure = async (failure, { definition, program, rest, argv, profile,
         streams: options.streams ?? processStreams,
         env,
         ...(settings ? { keepDays: settings.keepRunsForDays } : {}),
+        ...(settings?.keepSuccessfulRunsForDays === undefined
+            ? {}
+            : { keepSuccessDays: settings.keepSuccessfulRunsForDays }),
     }, async () => {
         throw failure;
     }).catch(() => { });
@@ -655,11 +659,14 @@ const failed = ({ app }, program, rest, error, settled, debug) => {
         ? new CliError(told.code, told.message, { ...told.details, settlement_failed: true })
         : told;
     const effects = judgedEffects(path ? metaOf(commandAt(program, path) ?? program).effects : undefined);
-    const object = errorObjectOf(failure, {
+    const built = errorObjectOf(failure, {
         ...failureContext(app.errors),
         targets: judgedTargets(program),
         ...(effects ? { effects } : {}),
     });
+    const { next: _named, ...said } = built.error;
+    const steps = failureSteps(program, built.error);
+    const object = { ...built, error: { ...said, ...(steps.length > 0 ? { next: steps } : {}) } };
     showInputFields(object, (path && commandAt(program, path)) || program);
     const command = path || app.command;
     return {

package/dist/cli/settings.d.ts

@@ -2,12 +2,20 @@ import { CliError } from "@wirecat/cli-base";
 import * as v from "valibot";
 import { type AISettings } from "../analysis/settings.js";
 import { type AppIdentity } from "../ports/app.js";
+import type { RecordInput } from "../runs/run-context.js";
 import { type Level, type PermissionKey } from "../sends/permissions.js";
 import { type ConfigIssue } from "./config-issues.js";
 import type { CommandPermissions } from "./permission-keys.js";
 export declare const plain: (rule: string) => (issue: v.BaseIssue<unknown>) => string;
 export declare const count: v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>;
 export declare const flag: v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>;
+/** `record_input`: true, false, or "failed" — the words typed kept only in a run that failed. */
+export declare const recordInputSetting: v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"failed", undefined>], (issue: v.BaseIssue<unknown>) => string>;
+/**
+ * Settings about messages, senders and bots. A CLI that is not a messenger reads none of them, so it neither lists nor
+ * takes them; a file that still has one is read as before.
+ */
+export declare const MESSENGER_ONLY_SETTINGS: readonly string[];
 /**
  * **What one messenger adds to the file**, merged into the one strict schema — a field an adapter
  * reads but the schema did not know would be refused as unknown. Each entry must be optional.
@@ -102,15 +110,21 @@ export interface Settings extends AISettings {
      * differently on purpose — milliseconds in the file, a duration with a unit on the command line.
      */
     commandTimeoutMs: number | undefined;
+    /** Every run is kept unless the config says `record: false` or the command says `--no-record`. */
     record: boolean;
     /**
-     * A run record keeps the words typed, secrets hidden; off masks every value that may be content. Optional so a CLI
-     * with settings of its own need not return it: left out, the words are kept.
+     * A run record keeps the words typed, secrets hidden; off masks every value that may be content; `"failed"` keeps
+     * them only in a run that failed. Optional so a CLI with settings of its own need not return it: left out, the words
+     * are kept.
      */
-    recordInput?: boolean;
-    /** A failed run is kept even unrecorded, unless recording was turned off by name. */
+    recordInput?: RecordInput;
+    /** A failed run is kept even unrecorded, unless `--no-record` turned recording off for this command. */
     keepFailedRuns: boolean;
     keepRunsForDays: number;
+    /** Successful runs go sooner than failed ones. Optional so a CLI with settings of its own need not return it. */
+    keepSuccessfulRunsForDays?: number;
+    /** The runs folder's size limit, in megabytes. */
+    runsSizeLimitMb?: number;
     /** The variable that made this process read-only, above every level and flag (`<PREFIX>_READ_ONLY`). */
     readOnlyLock?: string;
     /**
@@ -276,8 +290,10 @@ export declare const settingsFor: <T extends object = Record<never, never>>(app:
             color: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
             sender_colors: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
             record: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
-            record_input: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
+            record_input: v.OptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"failed", undefined>], (issue: v.BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
             permissions: v.OptionalSchema<v.RecordSchema<v.GenericSchema<string>, v.PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: v.PicklistIssue) => string>, (issue: v.BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 0, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
@@ -350,8 +366,10 @@ export declare const settingsFor: <T extends object = Record<never, never>>(app:
             color: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
             sender_colors: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
             record: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
-            record_input: v.OptionalSchema<v.BooleanSchema<(issue: v.BaseIssue<unknown>) => string>, undefined>;
+            record_input: v.OptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"failed", undefined>], (issue: v.BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
             permissions: v.OptionalSchema<v.RecordSchema<v.GenericSchema<string>, v.PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: v.PicklistIssue) => string>, (issue: v.BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 1, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<(issue: v.BaseIssue<unknown>) => string>, v.IntegerAction<number, (issue: v.BaseIssue<unknown>) => string>, v.MinValueAction<number, 0, (issue: v.BaseIssue<unknown>) => string>]>, undefined>;

package/dist/cli/settings.js

@@ -5,6 +5,7 @@ import { AI_ENTRIES, resolveAISettings } from "../analysis/settings.js";
 import { parseDuration } from "../domain/duration.js";
 import { DEFAULT_RERANK_MODEL, RERANK_MODELS } from "../embeddings/models.js";
 import { envName, readOnlyLockOf } from "../ports/app.js";
+import { KEEP_SUCCESSFUL_RUNS_FOR_DAYS, RUNS_SIZE_LIMIT_MB } from "../runs/run.js";
 import { assertOverridesTighten, CEILING_KEY, COMMAND_PATH_KEY, LEVELS, layerPermissions, permissionOverrides, RESOURCE_KEY, RESOURCES, } from "../sends/permissions.js";
 import { storePath } from "../store/path.js";
 import { sharedConfigPath } from "../store/shared-config.js";
@@ -33,6 +34,8 @@ export const count = v.pipe(v.number(wholeNumber), v.integer(wholeNumber), v.min
 const zeroOrMore = plain("has to be a whole number, 0 or more");
 const countOrZero = v.pipe(v.number(zeroOrMore), v.integer(zeroOrMore), v.minValue(0, zeroOrMore));
 export const flag = v.boolean(plain("has to be true or false"));
+/** `record_input`: true, false, or "failed" — the words typed kept only in a run that failed. */
+export const recordInputSetting = v.union([v.boolean(), v.literal("failed")], plain('has to be true, false or "failed"'));
 const wholeOrZero = (text, name) => {
     const value = Number(text);
     if (!Number.isInteger(value) || value < 0)
@@ -58,8 +61,10 @@ const SHARED_PROFILE_ENTRIES = {
     color: v.optional(flag),
     sender_colors: v.optional(flag),
     record: v.optional(flag),
-    record_input: v.optional(flag),
+    record_input: v.optional(recordInputSetting),
     keep_runs_for_days: v.optional(count),
+    keep_successful_runs_for_days: v.optional(count),
+    runs_size_limit_mb: v.optional(count),
     permissions: v.optional(permissionLevels),
     sends_per_hour: v.optional(count),
     requests_per_minute: v.optional(countOrZero),
@@ -77,6 +82,17 @@ const SHARED_PROFILE_ENTRIES = {
 const BOT_ONLY_ENTRIES = {
     read_other_bots: v.optional(v.union([flag, v.array(v.string(), plain("has to be a list of profile names"))], plain("has to be true, false or a list of profile names"))),
 };
+/**
+ * Settings about messages, senders and bots. A CLI that is not a messenger reads none of them, so it neither lists nor
+ * takes them; a file that still has one is read as before.
+ */
+export const MESSENGER_ONLY_SETTINGS = [
+    "sender_colors",
+    "sends_per_hour",
+    "transcribe_with",
+    "search_catch_up",
+    "read_other_bots",
+];
 /** One program, one version: whether to look for a newer one is not a per-profile matter. */
 const SHARED_DEFAULTS_ONLY = {
     update_check: v.optional(flag),
@@ -146,7 +162,7 @@ export const settingsFor = (app, extension = {}) => {
     const schema = strictOf(configEntries);
     const defaultsOnlyKeys = Object.keys(defaultsOnly);
     const botOnlyKeys = Object.keys(BOT_ONLY_ENTRIES);
-    const allSettings = [...Object.keys(profileEntries), ...botOnlyKeys, ...defaultsOnlyKeys];
+    const allSettings = [...Object.keys(profileEntries), ...botOnlyKeys, ...defaultsOnlyKeys].filter((setting) => app.messenger !== false || !MESSENGER_ONLY_SETTINGS.includes(setting));
     const PROFILE = envName(app, "PROFILE");
     const PROFILE_LOCK = envName(app, "PROFILE_LOCK");
     const TIMEOUT = envName(app, "TIMEOUT");
@@ -232,7 +248,7 @@ export const settingsFor = (app, extension = {}) => {
         const fromLayers = (key, fallback, only = layers) => first(only.map(([from, scope]) => [from, scope?.[key]]), fallback);
         const kindLayers = layers.filter(([from]) => from.startsWith(`config file: ${kind}.`));
         const limit = flags.limit === undefined ? fromLayers("limit", DEFAULT_LIMIT) : { value: flags.limit, from: "flag" };
-        const record = flags.record === undefined ? fromLayers("record", false) : { value: flags.record, from: "flag" };
+        const record = flags.record === undefined ? fromLayers("record", true) : { value: flags.record, from: "flag" };
         const timeoutMs = fromLayers("timeout_ms", undefined);
         const color = fromLayers("color", undefined);
         const senderColors = fromLayers("sender_colors", false);
@@ -241,6 +257,8 @@ export const settingsFor = (app, extension = {}) => {
         const searchReranker = fromLayers("search_reranker", DEFAULT_RERANK_MODEL);
         const recordInput = fromLayers("record_input", true);
         const keepRunsForDays = fromLayers("keep_runs_for_days", DEFAULT_KEEP_RUNS_FOR_DAYS);
+        const keepSuccessfulRunsForDays = fromLayers("keep_successful_runs_for_days", KEEP_SUCCESSFUL_RUNS_FOR_DAYS);
+        const runsSizeLimitMb = fromLayers("runs_size_limit_mb", RUNS_SIZE_LIMIT_MB);
         // Set where an agent runs unattended; the config file and `--permission` cannot undo it.
         const readOnlyLock = readOnlyLockOf(app, env);
         // A bot has no hourly limit unless the bot section gives it one: a bot that answers people is
@@ -297,8 +315,10 @@ export const settingsFor = (app, extension = {}) => {
                 : (extension.parseDuration ?? parseDuration)(timeout.value, timeout.from === TIMEOUT ? TIMEOUT : "--timeout"),
             record: record.value,
             recordInput: recordInput.value,
-            keepFailedRuns: record.value || record.from === "default",
+            keepFailedRuns: record.value || record.from !== "flag",
             keepRunsForDays: keepRunsForDays.value,
+            keepSuccessfulRunsForDays: keepSuccessfulRunsForDays.value,
+            runsSizeLimitMb: runsSizeLimitMb.value,
             ...(readOnlyLock ? { readOnlyLock } : {}),
             permissions: permissions.levels,
             permissionSources: permissions.sources,
@@ -326,6 +346,8 @@ export const settingsFor = (app, extension = {}) => {
                 record: record.from,
                 recordInput: recordInput.from,
                 keepRunsForDays: keepRunsForDays.from,
+                keepSuccessfulRunsForDays: keepSuccessfulRunsForDays.from,
+                runsSizeLimitMb: runsSizeLimitMb.from,
                 sendsPerHour: sendsPerHour.from,
                 requestsPerMinute: requestsPerMinute.from,
                 readOtherBots: readOtherBots.from,

package/dist/cli/shared-command-exports.d.ts

@@ -79,8 +79,10 @@ export declare const configCommand: (app: import("./entry.js").AppIdentity, conf
             color: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sender_colors: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             record: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
-            record_input: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
+            record_input: import("valibot").OptionalSchema<import("valibot").UnionSchema<[import("valibot").BooleanSchema<undefined>, import("valibot").LiteralSchema<"failed", undefined>], (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             permissions: import("valibot").OptionalSchema<import("valibot").RecordSchema<import("valibot").GenericSchema<string>, import("valibot").PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: import("valibot").PicklistIssue) => string>, (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 0, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
@@ -153,8 +155,10 @@ export declare const configCommand: (app: import("./entry.js").AppIdentity, conf
             color: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sender_colors: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             record: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
-            record_input: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
+            record_input: import("valibot").OptionalSchema<import("valibot").UnionSchema<[import("valibot").BooleanSchema<undefined>, import("valibot").LiteralSchema<"failed", undefined>], (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             permissions: import("valibot").OptionalSchema<import("valibot").RecordSchema<import("valibot").GenericSchema<string>, import("valibot").PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: import("valibot").PicklistIssue) => string>, (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 0, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
@@ -283,8 +287,10 @@ export declare const completeCommand: (messenger: import("./index.js").Messenger
             color: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sender_colors: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             record: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
-            record_input: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
+            record_input: import("valibot").OptionalSchema<import("valibot").UnionSchema<[import("valibot").BooleanSchema<undefined>, import("valibot").LiteralSchema<"failed", undefined>], (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             permissions: import("valibot").OptionalSchema<import("valibot").RecordSchema<import("valibot").GenericSchema<string>, import("valibot").PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: import("valibot").PicklistIssue) => string>, (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 0, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
@@ -357,8 +363,10 @@ export declare const completeCommand: (messenger: import("./index.js").Messenger
             color: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sender_colors: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             record: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
-            record_input: import("valibot").OptionalSchema<import("valibot").BooleanSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
+            record_input: import("valibot").OptionalSchema<import("valibot").UnionSchema<[import("valibot").BooleanSchema<undefined>, import("valibot").LiteralSchema<"failed", undefined>], (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             keep_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            keep_successful_runs_for_days: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
+            runs_size_limit_mb: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             permissions: import("valibot").OptionalSchema<import("valibot").RecordSchema<import("valibot").GenericSchema<string>, import("valibot").PicklistSchema<readonly ["deny", "readonly", "ask", "allow"], (issue: import("valibot").PicklistIssue) => string>, (issue: import("valibot").BaseIssue<unknown>) => string>, undefined>;
             sends_per_hour: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 1, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;
             requests_per_minute: import("valibot").OptionalSchema<import("valibot").SchemaWithPipe<readonly [import("valibot").NumberSchema<(issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").IntegerAction<number, (issue: import("valibot").BaseIssue<unknown>) => string>, import("valibot").MinValueAction<number, 0, (issue: import("valibot").BaseIssue<unknown>) => string>]>, undefined>;

package/dist/cli/skill-command.js

@@ -14,7 +14,7 @@ export const skillCommand = (app, skill) => {
         // cli-base prints each answer bare; the envelope is cli-core's.
         const renderer = { ...output.renderer, result: (value) => printItem(output, value) };
         return { ...output, renderer, ...(env ? { env } : {}) };
-    }, SHARED_SKILLS);
+    }, app.messenger === false ? {} : SHARED_SKILLS);
     // An installed skill is instructions every later agent follows.
     const install = command.commands.find((sub) => sub.name() === "install");
     if (install) {
@@ -23,10 +23,18 @@ export const skillCommand = (app, skill) => {
     }
     const show = command.commands.find((sub) => sub.name() === "show");
     if (show)
-        annotate(show, { examples: [`${app.command} skill show`, `${app.command} skill show follow-ups`] });
+        annotate(show, {
+            examples: [
+                `${app.command} skill show`,
+                ...(app.messenger === false ? [] : [`${app.command} skill show follow-ups`]),
+            ],
+        });
     return command;
 };
-/** Skills this package ships for every CLI on it, printed by `skill show <name>`: `skills/` beside `dist/` and `src/`. */
+/**
+ * Skills this package ships for the messenger CLIs, printed by `skill show <name>`: `skills/` beside `dist/` and `src/`.
+ * Both work on chats, so a CLI without them offers neither.
+ */
 const SHARED_SKILLS = {
     "follow-ups": new URL("../../skills/follow-ups/SKILL.md", import.meta.url),
     "link-conversations": new URL("../../skills/link-conversations/SKILL.md", import.meta.url),

package/dist/cli/steps.d.ts

@@ -35,6 +35,15 @@ type Targets = NonNullable<StepInput["targets"]>;
  * remotely.
  */
 export declare const runnable: (root: Command, steps: readonly NextStep[] | undefined) => NextStep[];
+/**
+ * The step a failure names, where its reason has one and this CLI has the command: a model that is not downloaded
+ * names its download only in a CLI with `models`. A step the error already carries is kept, also only if runnable.
+ */
+export declare const failureSteps: (root: Command, error: {
+    reason?: string;
+    details?: Record<string, unknown>;
+    next?: readonly NextStep[];
+}) => NextStep[];
 /** Each command step judged by its command's effects: safe to run unasked only when it writes nothing remotely. */
 export declare const withSafety: (steps: readonly NextStep[], targets: Targets) => NextStep[];
 /** Each command step with `line`, the whole command to type — only the CLI knows the profile, so MCP gets none. */

package/dist/cli/steps.js

@@ -1,4 +1,5 @@
 import { STEPS as BASE_STEPS, defineSteps, MAX_NEXT_STEPS, stepOf, writes, } from "@wirecat/cli-base/standards";
+import { IMAGE_MODELS } from "../images/picture/models.js";
 import { typedCommand } from "../runs/scope.js";
 import { judgedTargets } from "./effects.js";
 /**
@@ -245,6 +246,21 @@ export const commandAt = (root, path) => {
 export const runnable = (root, steps) => withSafety((steps ?? [])
     .filter((step) => step.kind === "user_action" || commandAt(root, step.command) !== undefined)
     .slice(0, MAX_NEXT_STEPS), judgedTargets(root));
+/**
+ * The step a failure names, where its reason has one and this CLI has the command: a model that is not downloaded
+ * names its download only in a CLI with `models`. A step the error already carries is kept, also only if runnable.
+ */
+export const failureSteps = (root, error) => {
+    const model = error.details?.model;
+    const own = error.reason === "model.not-downloaded" && typeof model === "string"
+        ? [
+            nextStep(IMAGE_MODELS.some((one) => one.id === model) ? "models.download-image" : "models.download", {
+                args: { model },
+            }),
+        ]
+        : [];
+    return runnable(root, [...(error.next ?? []), ...own]);
+};
 /** Each command step judged by its command's effects: safe to run unasked only when it writes nothing remotely. */
 export const withSafety = (steps, targets) => steps.map((step) => {
     if (step.kind === "user_action")

package/dist/cli/store-settings.d.ts

@@ -1,6 +1,12 @@
 import type { AppIdentity } from "../ports/app.js";
 /** Settings of the store file, not of a profile: the store is one file for every profile, tg and MAX. */
 export declare const STORE_SETTINGS: string[];
+/**
+ * The store settings a CLI offers. Phone countries, task rules and account groups belong to messages; a CLI that is
+ * not a messenger would change them for tg and MAX without reading them itself.
+ */
+export declare const storeSettingsOf: (app: Pick<AppIdentity, "messenger">) => string[];
+export declare const offersStoreSetting: (app: Pick<AppIdentity, "messenger">, setting: string) => boolean;
 export declare const isStoreSetting: (setting: string) => boolean;
 export declare const changeStoreSetting: (app: AppIdentity, env: NodeJS.ProcessEnv, setting: string, value: string | undefined) => Promise<{
     result: {

package/dist/cli/store-settings.js

@@ -29,6 +29,12 @@ export const STORE_SETTINGS = [
     FIRST_PASS,
 ];
 const GROUP_PREFIX = `${ACCOUNT_GROUPS_SETTING}.`;
+/**
+ * The store settings a CLI offers. Phone countries, task rules and account groups belong to messages; a CLI that is
+ * not a messenger would change them for tg and MAX without reading them itself.
+ */
+export const storeSettingsOf = (app) => app.messenger === false ? Object.keys(SCRIPTS) : [...STORE_SETTINGS, `${GROUP_PREFIX}<name>`];
+export const offersStoreSetting = (app, setting) => app.messenger !== false || setting in SCRIPTS;
 export const isStoreSetting = (setting) => setting in SCRIPTS ||
     setting === PHONE_COUNTRIES ||
     setting === TASK_CATEGORIES ||

package/dist/entities/index.d.ts

@@ -6312,7 +6312,20 @@ export declare const ENTITIES: {
             readonly kind: v.StringSchema<undefined>;
             readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+        readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly tool: v.StringSchema<undefined>;
+            readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly error: v.OptionalSchema<v.StrictObjectSchema<{
             readonly class: v.StringSchema<undefined>;
             readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6375,7 +6388,20 @@ export declare const ENTITIES: {
             readonly kind: v.StringSchema<undefined>;
             readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+        readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly tool: v.StringSchema<undefined>;
+            readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly error: v.OptionalSchema<v.StrictObjectSchema<{
             readonly class: v.StringSchema<undefined>;
             readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -6437,7 +6463,20 @@ export declare const ENTITIES: {
             readonly kind: v.StringSchema<undefined>;
             readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
             readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+            readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+                readonly name: v.StringSchema<undefined>;
+                readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+                readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            }, undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+        readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly tool: v.StringSchema<undefined>;
+            readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
         }, undefined>, undefined>;
+        readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
         readonly error: v.OptionalSchema<v.StrictObjectSchema<{
             readonly class: v.StringSchema<undefined>;
             readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;

package/dist/entities/recorded-run.d.ts

@@ -35,7 +35,20 @@ export declare const recordedRun: v.StrictObjectSchema<{
         readonly kind: v.StringSchema<undefined>;
         readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+    readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly tool: v.StringSchema<undefined>;
+        readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly error: v.OptionalSchema<v.StrictObjectSchema<{
         readonly class: v.StringSchema<undefined>;
         readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -98,7 +111,20 @@ export declare const runDetails: v.StrictObjectSchema<{
         readonly kind: v.StringSchema<undefined>;
         readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+    readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly tool: v.StringSchema<undefined>;
+        readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly error: v.OptionalSchema<v.StrictObjectSchema<{
         readonly class: v.StringSchema<undefined>;
         readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
@@ -160,7 +186,20 @@ export declare const runHit: v.StrictObjectSchema<{
         readonly kind: v.StringSchema<undefined>;
         readonly session_id: v.NullableSchema<v.StringSchema<undefined>, undefined>;
         readonly from_chat: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
+        readonly client: v.OptionalSchema<v.StrictObjectSchema<{
+            readonly name: v.StringSchema<undefined>;
+            readonly version: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+            readonly id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+    }, undefined>, undefined>;
+    readonly via: v.OptionalSchema<v.PicklistSchema<["cli", "mcp-stdio", "mcp-http", "desktop"], undefined>, undefined>;
+    readonly mcp: v.OptionalSchema<v.StrictObjectSchema<{
+        readonly tool: v.StringSchema<undefined>;
+        readonly request_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly connection_id: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        readonly proxied: v.OptionalSchema<v.LiteralSchema<true, undefined>, undefined>;
     }, undefined>, undefined>;
+    readonly events_dropped: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 0, undefined>]>, undefined>;
     readonly error: v.OptionalSchema<v.StrictObjectSchema<{
         readonly class: v.StringSchema<undefined>;
         readonly code: v.OptionalSchema<v.StringSchema<undefined>, undefined>;