@indigoai-us/hq-cli 5.345.173 → 5.345.175

package/dist/lib/bot/runtime/types.js

@@ -19,6 +19,14 @@ export class RuntimeError extends Error {
      * must never decide what went wrong; only the message may.
      */
     excerptIsOutputTail;
+    /** How long the runtime process lived, in ms, when known. */
+    durationMs;
+    /** True when stdout carried at least one stream event (`system`, `assistant`, `result`): the turn started. */
+    sawStreamEvent;
+    /** Crash evidence for the bot log: the binary spawned, full stderr and the head of stdout (bounded). */
+    binaryPath;
+    stderrFull;
+    stdoutHead;
     constructor(message, stderrExcerpt, exitCode, opts = {}) {
         super(message);
         this.stderrExcerpt = stderrExcerpt;
@@ -27,6 +35,11 @@ export class RuntimeError extends Error {
         this.started = opts.started ?? true;
         this.aborted = opts.aborted ?? false;
         this.excerptIsOutputTail = opts.excerptIsOutputTail ?? false;
+        this.durationMs = opts.durationMs;
+        this.sawStreamEvent = opts.sawStreamEvent ?? false;
+        this.binaryPath = opts.binaryPath;
+        this.stderrFull = opts.stderrFull;
+        this.stdoutHead = opts.stdoutHead;
     }
 }
 /**

package/dist/lib/bot/runtime-failure.d.ts

@@ -27,16 +27,27 @@ export type RuntimeFailureClass =
  | "transient"
 /** The tool is not installed (or not on PATH) on this computer. */
  | "not-installed"
+/** The tool's process exited before the turn started (e.g. Bun's "error: ... (Unexpected)"). A restart heals it. */
+ | "runtime-crashed"
 /** Anything else. Neutral copy; never blames the sign-in. */
  | "unknown";
-/** The four classes that get a repair card in the DM. */
-export type RuntimeRepairClass = Extract<RuntimeFailureClass, "signed-out" | "cli-outdated" | "model-unsupported" | "transient">;
+/** The classes that get a repair card in the DM. */
+export type RuntimeRepairClass = Extract<RuntimeFailureClass, "signed-out" | "cli-outdated" | "model-unsupported" | "transient" | "runtime-crashed">;
 /** The one thing the person can do about it. The desktop maps each to a button. */
-export type RuntimeRepairAction = "signIn" | "update" | "switchModel" | "tryAgain";
+export type RuntimeRepairAction = "signIn" | "update" | "switchModel" | "tryAgain" | "restart";
 export declare const RUNTIME_REPAIR_ACTIONS: Record<RuntimeRepairClass, RuntimeRepairAction>;
 export declare function isRuntimeRepairClass(cls: RuntimeFailureClass): cls is RuntimeRepairClass;
 /** Sort a runtime's failure text into one class. Order matters: most specific first. */
 export declare function classifyRuntimeFailure(text: string | undefined | null): RuntimeFailureClass;
+export declare function isBunProcessError(text: string | undefined | null): boolean;
+/** A process that exits non-zero this soon, with no stream event, never started its turn. */
+export declare const RUNTIME_CRASH_MAX_MS = 5000;
+/**
+ * True when the coding tool's process exited before the turn started: a
+ * non-zero exit code, not stopped by the owner, no stream event on stdout,
+ * and either Bun's process error shape on stderr or a life under 5 s.
+ */
+export declare function isRuntimeCrash(err: unknown): boolean;
 /**
  * Class of a failed turn's error. A RuntimeError's excerpt (the runtime's own
  * reported error: failureReason, turn.failed, stderr) is the better evidence;
@@ -57,11 +68,11 @@ export type RuntimeFailureContext = "kickoff" | "message";
  */
 export declare function runtimeFailureReason(cls: RuntimeFailureClass, runtime: BotRuntimeId | string): string;
 /** The one next step, as a full sentence. */
-export declare function runtimeFailureNextStep(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, context?: RuntimeFailureContext): string;
+export declare function runtimeFailureNextStep(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, context?: RuntimeFailureContext, botName?: string): string;
 /** "My Codex app is out of date. Update Codex, then send me any message." */
-export declare function runtimeFailureText(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, context?: RuntimeFailureContext): string;
+export declare function runtimeFailureText(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, context?: RuntimeFailureContext, botName?: string): string;
 /** A failure after the model started (and maybe posted part of the answer). */
-export declare function runtimeDidNotFinishText(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, progressPosted: boolean): string;
+export declare function runtimeDidNotFinishText(cls: RuntimeFailureClass, runtime: BotRuntimeId | string, progressPosted: boolean, botName?: string): string;
 /**
  * The machine-readable repair payload a failure DM carries. The DM transport
  * (POST /v1/notify/dm) stores structured data only in `richContent`

package/dist/lib/bot/runtime-failure.js

@@ -21,6 +21,7 @@ export const RUNTIME_REPAIR_ACTIONS = {
     "cli-outdated": "update",
     "model-unsupported": "switchModel",
     transient: "tryAgain",
+    "runtime-crashed": "restart",
 };
 export function isRuntimeRepairClass(cls) {
     return cls in RUNTIME_REPAIR_ACTIONS;
@@ -61,6 +62,38 @@ export function classifyRuntimeFailure(text) {
         return "transient";
     return "unknown";
 }
+/**
+ * Bun's process-level error line (Claude Code is a Bun-compiled binary):
+ * "error: An unknown error occurred (Unexpected)". The excerpt joins stderr
+ * lines with " | ", so each segment is checked on its own.
+ */
+const BUN_PROCESS_ERROR = /^error: .+ \((?:Unexpected|[A-Z][A-Za-z]+)\)\s*$/m;
+export function isBunProcessError(text) {
+    return (text ?? "")
+        .split(/\n| \| /)
+        .some((segment) => BUN_PROCESS_ERROR.test(segment.trim()));
+}
+/** A process that exits non-zero this soon, with no stream event, never started its turn. */
+export const RUNTIME_CRASH_MAX_MS = 5_000;
+function bunShaped(e) {
+    return (isBunProcessError(typeof e.stderrExcerpt === "string" ? e.stderrExcerpt : "") ||
+        isBunProcessError(typeof e.stderrFull === "string" ? e.stderrFull : ""));
+}
+/**
+ * True when the coding tool's process exited before the turn started: a
+ * non-zero exit code, not stopped by the owner, no stream event on stdout,
+ * and either Bun's process error shape on stderr or a life under 5 s.
+ */
+export function isRuntimeCrash(err) {
+    if (!err || typeof err !== "object" || !("stderrExcerpt" in err))
+        return false;
+    const e = err;
+    if (typeof e.exitCode !== "number" || e.exitCode === 0)
+        return false;
+    if (e.aborted === true || e.sawStreamEvent === true)
+        return false;
+    return bunShaped(e) || (typeof e.durationMs === "number" && e.durationMs < RUNTIME_CRASH_MAX_MS);
+}
 /**
  * Class of a failed turn's error. A RuntimeError's excerpt (the runtime's own
  * reported error: failureReason, turn.failed, stderr) is the better evidence;
@@ -73,12 +106,20 @@ export function classifyRuntimeError(err) {
     if (err && typeof err === "object" && "stderrExcerpt" in err) {
         const e = err;
         const message = typeof e.message === "string" ? e.message : "";
-        if (e.excerptIsOutputTail === true)
-            return classifyRuntimeFailure(message);
+        const crashed = isRuntimeCrash(err);
+        // Bun's own process error is the most specific evidence there is.
+        if (crashed && bunShaped(err))
+            return "runtime-crashed";
+        if (e.excerptIsOutputTail === true) {
+            const fromTailMessage = classifyRuntimeFailure(message);
+            return fromTailMessage === "unknown" && crashed ? "runtime-crashed" : fromTailMessage;
+        }
         const fromExcerpt = classifyRuntimeFailure(typeof e.stderrExcerpt === "string" ? e.stderrExcerpt : "");
         if (fromExcerpt !== "unknown")
             return fromExcerpt;
-        return classifyRuntimeFailure(message);
+        const fromMessage = classifyRuntimeFailure(message);
+        // A quick exit with no known cause: the process died before the turn.
+        return fromMessage === "unknown" && crashed ? "runtime-crashed" : fromMessage;
     }
     return classifyRuntimeFailure(err instanceof Error ? err.message : String(err ?? ""));
 }
@@ -106,14 +147,18 @@ export function runtimeFailureReason(cls, runtime) {
             return `${tool} is busy or out of reach right now`;
         case "not-installed":
             return `${tool} isn't installed on this computer`;
+        case "runtime-crashed":
+            return `my ${tool} process could not start`;
         default:
             return `${tool} stopped with an error`;
     }
 }
 /** The one next step, as a full sentence. */
-export function runtimeFailureNextStep(cls, runtime, context = "message") {
+export function runtimeFailureNextStep(cls, runtime, context = "message", botName) {
     const tool = runtimeDisplayName(runtime);
     switch (cls) {
+        case "runtime-crashed":
+            return `Press "Heal bot" in HQ, or run: hq bot restart ${botName ?? "<bot>"}`;
         case "signed-out":
             return `Use "Sign in to ${tool}" in HQ, then send me any message.`;
         case "cli-outdated":
@@ -136,12 +181,12 @@ function capitalize(s) {
     return s ? s[0].toUpperCase() + s.slice(1) : s;
 }
 /** "My Codex app is out of date. Update Codex, then send me any message." */
-export function runtimeFailureText(cls, runtime, context = "message") {
-    return `${capitalize(runtimeFailureReason(cls, runtime))}. ${runtimeFailureNextStep(cls, runtime, context)}`;
+export function runtimeFailureText(cls, runtime, context = "message", botName) {
+    return `${capitalize(runtimeFailureReason(cls, runtime))}. ${runtimeFailureNextStep(cls, runtime, context, botName)}`;
 }
 /** A failure after the model started (and maybe posted part of the answer). */
-export function runtimeDidNotFinishText(cls, runtime, progressPosted) {
-    return `I didn't finish that. ${runtimeFailureText(cls, runtime)}${progressPosted ? " The messages above show how far I got." : ""}`;
+export function runtimeDidNotFinishText(cls, runtime, progressPosted, botName) {
+    return `I didn't finish that. ${runtimeFailureText(cls, runtime, "message", botName)}${progressPosted ? " The messages above show how far I got." : ""}`;
 }
 export function runtimeRepairBlock(args) {
     return {
@@ -177,7 +222,7 @@ export function withRetrySuggestion(text) {
  * press.
  */
 export function runtimeRepairNotice(args) {
-    const text = args.text ?? runtimeFailureText(args.cls, args.runtime, args.context);
+    const text = args.text ?? runtimeFailureText(args.cls, args.runtime, args.context, args.botName);
     if (!isRuntimeRepairClass(args.cls))
         return { cls: args.cls, text };
     return {

package/dist/lib/bot/status.d.ts

@@ -55,6 +55,16 @@ export interface BotStatusFile {
         to: string;
         at: string;
     } | null;
+    /**
+     * The last time the coding tool's process exited before its turn started
+     * (runtime-crashed): when, exit code, how long it lived, and its stderr.
+     */
+    lastCrash?: {
+        at: string;
+        code: number | null;
+        durationMs?: number;
+        stderr: string;
+    };
     /**
      * Set while the bot holds its model turns after FAILURE_LIMIT failures in a
      * window (it used to exit instead, and a bot that exited could neither load

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.345.173",
+  "version": "5.345.175",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -114,11 +114,11 @@
     "*.{ts,tsx,mts,cts,js,jsx,mjs,cjs}": "eslint --cache --no-error-on-unmatched-pattern"
   },
   "optionalDependencies": {
-    "@indigoai-us/hq-hook-win32-x64": "5.345.173",
-    "@indigoai-us/hq-hook-win32-arm64": "5.345.173",
-    "@indigoai-us/hq-hook-darwin-x64": "5.345.173",
-    "@indigoai-us/hq-hook-darwin-arm64": "5.345.173",
-    "@indigoai-us/hq-hook-linux-x64": "5.345.173",
-    "@indigoai-us/hq-hook-linux-arm64": "5.345.173"
+    "@indigoai-us/hq-hook-win32-x64": "5.345.175",
+    "@indigoai-us/hq-hook-win32-arm64": "5.345.175",
+    "@indigoai-us/hq-hook-darwin-x64": "5.345.175",
+    "@indigoai-us/hq-hook-darwin-arm64": "5.345.175",
+    "@indigoai-us/hq-hook-linux-x64": "5.345.175",
+    "@indigoai-us/hq-hook-linux-arm64": "5.345.175"
   }
 }