@aexol/spectral 0.9.210 → 0.9.212

package/dist/server/offload-gc.js

@@ -0,0 +1,111 @@
+/**
+ * Garbage collection for large-result offload files.
+ *
+ * Offloads live under `<configDir>/offloads/<sessionId>/*.log`. This sweep
+ * removes per-session directories older than `SPECTRAL_OFFLOAD_TTL_DAYS`
+ * (default 7) and, when the total still exceeds `SPECTRAL_OFFLOAD_MAX_MB`
+ * (default 500), evicts the oldest sessions first.
+ *
+ * Best-effort and synchronous: callers fire-and-forget it during preflight.
+ */
+import { existsSync, readdirSync, rmSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { getConfigDir } from "../config.js";
+import { envPositiveInt } from "../sdk/coding-agent/core/tools/offload.js";
+export const DEFAULT_OFFLOAD_TTL_DAYS = 7;
+export const DEFAULT_OFFLOAD_MAX_MB = 500;
+export function getOffloadTtlMs() {
+    const days = envPositiveInt("SPECTRAL_OFFLOAD_TTL_DAYS", DEFAULT_OFFLOAD_TTL_DAYS);
+    return days * 24 * 60 * 60 * 1000;
+}
+export function getOffloadMaxBytes() {
+    const mb = envPositiveInt("SPECTRAL_OFFLOAD_MAX_MB", DEFAULT_OFFLOAD_MAX_MB);
+    return mb * 1024 * 1024;
+}
+function dirSizeBytes(dir) {
+    let total = 0;
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return 0;
+    }
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        try {
+            if (entry.isDirectory())
+                total += dirSizeBytes(full);
+            else if (entry.isFile())
+                total += statSync(full).size;
+        }
+        catch {
+            // Skip unreadable entries — GC is best-effort.
+        }
+    }
+    return total;
+}
+/** Remove stale/over-budget offload directories. Never throws. */
+export function sweepOffloads(root) {
+    const result = { removedSessions: 0, removedBytes: 0 };
+    let base;
+    try {
+        base = root ?? join(getConfigDir(), "offloads");
+    }
+    catch {
+        return result;
+    }
+    if (!existsSync(base))
+        return result;
+    let sessionDirs;
+    try {
+        sessionDirs = readdirSync(base);
+    }
+    catch {
+        return result;
+    }
+    const ttlMs = getOffloadTtlMs();
+    const now = Date.now();
+    const removeDir = (dir) => {
+        try {
+            result.removedBytes += dirSizeBytes(dir);
+            rmSync(dir, { recursive: true, force: true });
+            result.removedSessions++;
+        }
+        catch {
+            // Best-effort.
+        }
+    };
+    // Pass 1: TTL expiry by directory mtime.
+    const survivors = [];
+    for (const name of sessionDirs) {
+        const dir = join(base, name);
+        let stat;
+        try {
+            stat = statSync(dir);
+            if (!stat.isDirectory())
+                continue;
+        }
+        catch {
+            continue;
+        }
+        if (now - stat.mtimeMs > ttlMs)
+            removeDir(dir);
+        else
+            survivors.push({ dir, mtime: stat.mtimeMs, size: dirSizeBytes(dir) });
+    }
+    // Pass 2: total-size budget, oldest first.
+    let total = survivors.reduce((sum, s) => sum + s.size, 0);
+    const maxBytes = getOffloadMaxBytes();
+    if (total <= maxBytes)
+        return result;
+    survivors.sort((a, b) => a.mtime - b.mtime);
+    for (const s of survivors) {
+        if (total <= maxBytes)
+            break;
+        const before = s.size;
+        removeDir(s.dir);
+        total -= before;
+    }
+    return result;
+}

package/dist/server/session-stream.d.ts

@@ -471,6 +471,8 @@ export declare class SessionStreamManager {
     private scheduleIntervalTick;
     private clearIntervalTimer;
     private clearCurrentTurnSilenceTimer;
+    /** Clear subagent-in-flight bookkeeping (used by the silence safety net). */
+    private resetSubagentTracking;
     private armCurrentTurnSilenceTimer;
     private handleCurrentTurnSilenceTimeout;
     private intervalTick;

package/dist/server/session-stream.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAIH,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA4BjD,OAAO,KAAK,EACV,eAAe,EACf,sBAAsB,EAEtB,WAAW,EACX,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,wBAAwB,EAGzB,MAAM,WAAW,CAAC;AA6BnB;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAAC;IAC/B,wEAAwE;IACxE,MAAM,IAAI,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,IAAI,IAAI,CAAC;IAChB;;;;;OAKG;IACH,OAAO,CAAC,CACN,OAAO,CAAC,EAAE,MAAM,GAAG,uBAAuB,GACzC,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IACpC;;;OAGG;IACH,kBAAkB,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACtD;;;;;;MAME;IACF,QAAQ,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE;;;;;OAKG;IACH,qBAAqB,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/D,oBAAoB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;OAKG;IACH,wBAAwB,CAAC,IAAI,MAAM,GAAG,SAAS,CAAC;IAChD;;;;OAIG;IACH,eAAe,CAAC,IACZ;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACxE,SAAS,CAAC;IACd,mDAAmD;IACnD,WAAW,CAAC,IAAI,OAAO,CAAC;IACxB,mEAAmE;IACnE,UAAU,CAAC,IAAI,OAAO,CAAC;IACvB,2EAA2E;IAC3E,MAAM,CAAC,IAAI,OAAO,CAAC;IACnB,gBAAgB,CAAC,IAAI,KAAK,CAAC;QACzB,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC,CAAC;IACH,iBAAiB,CAAC,IAAI;QACpB,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;QACtE,QAAQ,EAAE;YACR,QAAQ,EAAE,OAAO,CAAC;YAClB,UAAU,EAAE,OAAO,CAAC;YACpB,UAAU,EAAE,OAAO,CAAC;YACpB,MAAM,EAAE,OAAO,CAAC;SACjB,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACpC;AAED,iDAAiD;AACjD,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,kBAAkB,KAAK,UAAU,CAAC;AAiCrE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B;AAghBD,KAAK,wBAAwB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;AAEhE,UAAU,oBAAqB,SAAQ,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC;IAC1E,UAAU,EAAE,wBAAwB,CAAC;CACtC;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC3B,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;IACtE,QAAQ,EAAE;QACR,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,OAAO,CAAC;QACpB,UAAU,EAAE,OAAO,CAAC;QACpB,MAAM,EAAE,OAAO,CAAC;KACjB,CAAC;IACF,WAAW,EAAE;QACX,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,YAAY,EAAE;QACZ,cAAc,EAAE,MAAM,CAAC;QACvB,eAAe,EAAE,MAAM,CAAC;QACxB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;IACF,UAAU,EAAE;QACV,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE;QACR,2BAA2B,EAAE,MAAM,CAAC;QACpC,yBAAyB,EAAE,MAAM,CAAC;QAClC,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AA6GD,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,WAAW,EAAE,sBAAsB,GAAG,IAAI,CAAC;IAC3C,4FAA4F;IAC5F,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB;;qEAEiE;IACjE,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wGAAwG;IACxG,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,yFAAyF;IACzF,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,UAAU,EAAE,OAAO,CAAC;IACpB,gEAAgE;IAChE,QAAQ,EAAE,YAAY,CAAC;IACvB,2DAA2D;IAC3D,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,YAAY,CAAC;IACpB;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;;OAMG;IACH,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AA8BD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,gFAAgF;IAChF,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAiC;IACpE,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA2B;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2C;IACrE,OAAO,CAAC,QAAQ,CAAC,yBAAyB,CAAyD;IACnG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoC;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA4C;IAC3E,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAG/B;IACJ,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,2BAA2B;IA8C7C;;;;;;;OAOG;IACH,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpD;;;;;;;;;;;;;OAaG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,YAAY,CAAC;IA2BxB;uDACmD;YACrC,UAAU;IA0BxB;;gBAEY;IACZ,OAAO,CAAC,cAAc;IAStB,mEAAmE;IACnE,OAAO,CAAC,iBAAiB;IAgEzB;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,IAAI;IAOvD,6EAA6E;IAC7E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIzC;;;;;OAKG;IACH,uBAAuB,IAAI,GAAG,CAAC,MAAM,CAAC;IAOtC,mFAAmF;IACnF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlC,mFAAmF;IACnF,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIxD;;;;OAIG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,CAAC;IAOhC;;;;;OAKG;IACG,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAU5C;;;;;;OAMG;IACH,wBAAwB,CACtB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,IAAI;IAOP,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,mBAAmB;IAuE9D,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,wBAAwB;YA8DtD,wBAAwB;IA0FhC,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACG,MAAM,CACV,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,eAAe,EAAE,EAC1B,eAAe,CAAC,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC;IAuQhB;;;OAGG;IACH,OAAO,IAAI,IAAI;IA2Bf,sEAAsE;IACtE,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;OASG;IACH,eAAe,IAAI,MAAM;IAQzB;;;;;;;;OAQG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAkEnC;;;;;;;OAOG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAiC7C;;;;;OAKG;IACH,qBAAqB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAM1D;;;;;;;;OAQG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,OAAO,EACf,cAAc,CAAC,EAAE,MAAM,EACvB,aAAa,CAAC,EAAE,MAAM,EACtB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI;IAoBP;;;;;OAKG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,oBAAoB,EAC5B,eAAe,EAAE,MAAM,GACtB,IAAI;IAiBP;;;;OAIG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO3C,oDAAoD;IACpD,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAUrC,kEAAkE;IAClE,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAG3C,OAAO,CAAC,wBAAwB;IAWhC,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,4BAA4B;IAMpC,OAAO,CAAC,0BAA0B;IAMlC,OAAO,CAAC,+BAA+B;IAqCvC,OAAO,CAAC,YAAY;IAyCpB;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IA0C1B,qFAAqF;IACrF,OAAO,CAAC,eAAe;YA6BT,qBAAqB;IAwCnC,OAAO,CAAC,YAAY;IAmOpB,OAAO,CAAC,iBAAiB;IAoazB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,WAAW;IAGnB,yEAAyE;IACzE,OAAO,CAAC,YAAY;IAQpB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,cAAc;IAUtB;;;;;;;;OAQG;IACH,OAAO,CAAC,iBAAiB;IA+BzB,OAAO,CAAC,SAAS;IAqBjB;;;;OAIG;IACH,qBAAqB,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAM/C;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAoBvC;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;CA+BzB"}
+{"version":3,"file":"session-stream.d.ts","sourceRoot":"","sources":["../../src/server/session-stream.ts"],"names":[],"mappings":"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"}

package/dist/server/session-stream.js

@@ -84,8 +84,68 @@ const MAX_LOOP_ITERATIONS = 100;
 // `stream.currentTurn` stays non-null forever. On reconnect, `session_ready`
 // then reports `currentTurn != null`, so landing shows a phantom "streaming"
 // status. This timer clears the stale turn and emits a synthetic `agent_end`
-// after 5 minutes of silence on streaming-meaningful events.
-const CURRENT_TURN_SILENCE_TIMEOUT_MS = 30 * 60 * 1000;
+// after 30 minutes of silence on streaming-meaningful events.
+//
+// Configurable via `SPECTRAL_TURN_SILENCE_TIMEOUT_MS`:
+//   * unset / empty / not-a-number / negative -> 30 minutes (default)
+//   * `0` -> DISABLED, the timer is never armed (official opt-out)
+//   * a positive fraction (e.g. `0.5`) is rounded UP to 1ms so it can never
+//     accidentally disable the safety net
+//   * anything larger than Node's max delay is clamped (see below)
+const DEFAULT_TURN_SILENCE_TIMEOUT_MS = 30 * 60 * 1000;
+/**
+ * Node emits `TimeoutOverflowWarning` and fires immediately for delays above
+ * this value, so anything larger is clamped to it.
+ */
+const MAX_TIMEOUT_DELAY_MS = 2_147_483_647;
+/**
+ * Upper bound on how many times the silence timer may be re-armed instead of
+ * closing the turn while a subagent is still running. Guards against a
+ * counter stuck at >0 forever (e.g. a `subagent_end` that never arrives after
+ * a crash) turning the safety net off permanently.
+ * `SPECTRAL_TURN_SILENCE_MAX_REARM=0` means unlimited re-arms.
+ */
+const DEFAULT_TURN_SILENCE_MAX_REARM = 8;
+/**
+ * Sanity clamp for `SPECTRAL_TURN_SILENCE_MAX_REARM`. Even with the shortest
+ * useful timeout this is days of silence, so a typo like `1e10` cannot keep a
+ * hung turn open effectively forever.
+ */
+const MAX_TURN_SILENCE_MAX_REARM = 1000;
+function resolveTurnSilenceTimeoutMs() {
+    const raw = process.env.SPECTRAL_TURN_SILENCE_TIMEOUT_MS;
+    if (raw === undefined || raw.trim() === "") {
+        return DEFAULT_TURN_SILENCE_TIMEOUT_MS;
+    }
+    const parsed = Number(raw);
+    // `0` is the documented way to switch the safety net off entirely.
+    if (parsed === 0)
+        return 0;
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return DEFAULT_TURN_SILENCE_TIMEOUT_MS;
+    }
+    // `Math.max(1, ...)`: a fractional value such as `0.5` must floor to 1ms,
+    // not to 0 — flooring to 0 would silently switch the safety net off.
+    return Math.min(Math.max(1, Math.floor(parsed)), MAX_TIMEOUT_DELAY_MS);
+}
+function resolveTurnSilenceMaxRearm() {
+    const raw = process.env.SPECTRAL_TURN_SILENCE_MAX_REARM;
+    // Empty / whitespace-only must NOT fall through to `Number(...)`, which
+    // coerces `""` to `0` and would therefore mean "unlimited re-arms" —
+    // i.e. the original "phantom streaming forever" bug.
+    if (raw === undefined || raw.trim() === "") {
+        return DEFAULT_TURN_SILENCE_MAX_REARM;
+    }
+    const parsed = Number(raw);
+    // `0` is the documented way to allow unlimited re-arms (opt-out of the
+    // re-arm budget).
+    if (parsed === 0)
+        return 0;
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return DEFAULT_TURN_SILENCE_MAX_REARM;
+    }
+    return Math.min(Math.max(1, Math.floor(parsed)), MAX_TURN_SILENCE_MAX_REARM);
+}
 // Streaming-meaningful events that reset the silence timer while a turn is
 // active. Mirrors Fix C on the landing side, but EXCLUDES `token_usage`
 // (arrives post-turn) and excludes terminal/control events handled by their
@@ -102,7 +162,17 @@ const STREAMING_MEANINGFUL_EVENT_TYPES = new Set([
     "tool_result",
     "message_end",
     "subagent_start",
+    // WARNING: `subagent_progress` only resets the timer if it is ALSO
+    // replayable. The re-arm below lives inside `if (isReplayable(event))`,
+    // and `subagent_progress` is deliberately live-only (see `isReplayable`),
+    // so this entry is currently inert — `subagent_tool_progress` is the
+    // subagent heartbeat that actually works. Do not rely on this entry until
+    // the re-arm is hoisted out of the `isReplayable` gate.
     "subagent_progress",
+    // `subagent_tool_progress` is the only live signal a subagent emits while
+    // it sits inside one long tool call (bash build/test). Without it a busy
+    // but "quiet" subagent looks like silence and the turn gets closed.
+    "subagent_tool_progress",
     "subagent_end",
 ]);
 /**
@@ -1207,6 +1277,9 @@ export class SessionStreamManager {
         // next-turn events (including the upcoming `message_start`) are not
         // rejected. The fence is re-armed if this turn later closes.
         stream.closedTurnGeneration = null;
+        // Fresh run: drop any subagent tracking left over from a previous turn
+        // that ended without a matching `subagent_end`.
+        this.resetSubagentTracking(stream);
         // New logical run. This is the only place `busy` transitions
         // false -> true (loop iterations and auto-dequeue also go through
         // `prompt()`). Retries/continuations do NOT bump the generation.
@@ -1324,6 +1397,9 @@ export class SessionStreamManager {
         // the synthetic agent_end below isn't later double-emitted by a stale
         // timer.
         this.clearCurrentTurnSilenceTimer(stream);
+        // The bridge is being torn down, so no `subagent_end` will arrive for any
+        // subagent that is still running. Drop the tracking state.
+        this.resetSubagentTracking(stream);
         // Dispose the agent bridge immediately — this tears down spectral's session and
         // unsubscribe. The bridge's own event handler is detached; no further
         // events will flow. We broadcast agent_end ourselves below.
@@ -1523,11 +1599,21 @@ export class SessionStreamManager {
             stream.currentTurnSilenceTimer = null;
         }
     }
+    /** Clear subagent-in-flight bookkeeping (used by the silence safety net). */
+    resetSubagentTracking(stream) {
+        stream.activeSubagentToolCallIds.clear();
+        stream.currentTurnSilenceRearmCount = 0;
+    }
     armCurrentTurnSilenceTimer(stream) {
         this.clearCurrentTurnSilenceTimer(stream);
+        const timeoutMs = resolveTurnSilenceTimeoutMs();
+        // `0` (or any disabled value) means the safety net is switched off: never
+        // arm the timer at all.
+        if (timeoutMs <= 0)
+            return;
         stream.currentTurnSilenceTimer = setTimeout(() => {
             this.handleCurrentTurnSilenceTimeout(stream);
-        }, CURRENT_TURN_SILENCE_TIMEOUT_MS);
+        }, timeoutMs);
     }
     handleCurrentTurnSilenceTimeout(stream) {
         stream.currentTurnSilenceTimer = null;
@@ -1538,8 +1624,36 @@ export class SessionStreamManager {
         if (stream.currentTurn == null)
             return;
         const sessionId = stream.sessionId;
+        const maxRearm = resolveTurnSilenceMaxRearm();
+        // Set when the re-arm budget is exhausted while subagents are still
+        // tracked in flight: the turn is closed anyway and the UI needs a
+        // distinguishable signal (see the `error` broadcast below).
+        let stuckSubagentCount = 0;
+        // A subagent is still running. Closing the turn now would flush the
+        // buffer and set `closedTurnGeneration`, which silently discards every
+        // replayable event the subagent emits afterwards (`subagent_end`,
+        // `tool_result`, `message_end`) while it keeps burning tokens. Re-arm
+        // instead, up to a bounded number of times.
+        if (stream.activeSubagentToolCallIds.size > 0) {
+            const unlimited = maxRearm === 0;
+            if (unlimited || stream.currentTurnSilenceRearmCount < maxRearm) {
+                stream.currentTurnSilenceRearmCount += 1;
+                console.warn(`[session-stream] currentTurn silence timeout deferred: ` +
+                    `${stream.activeSubagentToolCallIds.size} subagent(s) still active ` +
+                    `in session ${sessionId}, re-arming ` +
+                    `(${stream.currentTurnSilenceRearmCount}/${unlimited ? "unlimited" : maxRearm})`);
+                this.armCurrentTurnSilenceTimer(stream);
+                return;
+            }
+            stuckSubagentCount = stream.activeSubagentToolCallIds.size;
+            console.warn(`[session-stream] currentTurn silence timeout reached max re-arms ` +
+                `(${maxRearm}) with ${stream.activeSubagentToolCallIds.size} ` +
+                `subagent(s) still active in session ${sessionId}; ` +
+                `closing the turn anyway`);
+        }
+        stream.currentTurnSilenceRearmCount = 0;
         console.warn(`[session-stream] currentTurn silence timeout fired ` +
-            `(${CURRENT_TURN_SILENCE_TIMEOUT_MS / 1000}s without a ` +
+            `(${resolveTurnSilenceTimeoutMs() / 1000}s without a ` +
             `streaming-meaningful event), emitting synthetic agent_end ` +
             `for session ${sessionId}`);
         const finishedTurn = stream.currentTurn;
@@ -1547,6 +1661,22 @@ export class SessionStreamManager {
         stream.lastFlushedEventCount = 0;
         stream.currentTurn = null;
         stream.closedTurnGeneration = stream.bridgeTurnGeneration;
+        // Distinguish "gave up on a still-running subagent" from a clean
+        // synthetic `agent_end`: without this the UI sees an ordinary turn end
+        // and the subagent's result (which is dropped on the
+        // `closedTurnGeneration` fence) disappears without any explanation.
+        if (stuckSubagentCount > 0) {
+            console.warn(`[session-stream] turn silence timeout exhausted after ${maxRearm} ` +
+                `re-arm(s) while ${stuckSubagentCount} subagent(s) were still ` +
+                `active in session ${sessionId}; their remaining events will be ` +
+                `dropped on the closed-turn fence`);
+            this.broadcast(stream, {
+                type: "error",
+                message: `Turn silence timeout exhausted after ${maxRearm} re-arm(s) while ` +
+                    `${stuckSubagentCount} subagent(s) were still active. The turn was ` +
+                    `closed and any result they emit from now on will be discarded.`,
+            });
+        }
         // Reuse the normal broadcast path so relay subscribers (landing
         // WebSocket clients) receive agent_end and stop showing "streaming".
         this.broadcast(stream, { type: "agent_end" });
@@ -1706,6 +1836,8 @@ export class SessionStreamManager {
             currentTurn: null,
             bridgeTurnGeneration: 0,
             closedTurnGeneration: null,
+            activeSubagentToolCallIds: new Set(),
+            currentTurnSilenceRearmCount: 0,
             runState: {
                 runId: "",
                 generation: 0,
@@ -1889,6 +2021,24 @@ export class SessionStreamManager {
         if (dcpLiteEvent) {
             stream.lastDcpEvent = dcpLiteEvent;
         }
+        // Track in-flight subagents (tracked BEFORE the `closedTurnGeneration`
+        // fence below so a late `subagent_end` can still clear the counter).
+        // The silence timer uses this to avoid closing a turn out from under a
+        // still-working subagent.
+        if (event.type === "subagent_start") {
+            // Runtime payloads from the SDK are not typechecked. Without this guard
+            // a `toolCallId` of `undefined`/`""` would leave the set size pinned at
+            // 1 forever (the matching `subagent_end` could never delete it), which
+            // permanently disables the silence safety net for the whole session.
+            if (event.toolCallId) {
+                stream.activeSubagentToolCallIds.add(event.toolCallId);
+            }
+        }
+        else if (event.type === "subagent_end") {
+            if (event.toolCallId) {
+                stream.activeSubagentToolCallIds.delete(event.toolCallId);
+            }
+        }
         // Buffer replayable events into the in-flight turn. We intentionally
         // accept events even if currentTurn is null (rare race: spectral emits before
         // prompt() opened the turn), in which case we open one defensively so
@@ -1957,11 +2107,12 @@ export class SessionStreamManager {
                     BATCH_FLUSH_INTERVAL) {
                 this.flushInFlightTurn(stream);
             }
-            // Fix E: reset the 5-min silence timer whenever a
-            // streaming-meaningful event arrives while a turn is active. As long
-            // as the LLM keeps streaming (even slowly), the timer keeps resetting.
-            // `token_usage` is intentionally excluded (arrives post-turn and would
-            // prevent cleanup of a hung turn).
+            // Fix E: reset the turn silence timer (default 30 minutes, see
+            // `SPECTRAL_TURN_SILENCE_TIMEOUT_MS` / `resolveTurnSilenceTimeoutMs`)
+            // whenever a streaming-meaningful event arrives while a turn is
+            // active. As long as the LLM keeps streaming (even slowly), the timer
+            // keeps resetting. `token_usage` is intentionally excluded (arrives
+            // post-turn and would prevent cleanup of a hung turn).
             if (stream.currentTurn &&
                 STREAMING_MEANINGFUL_EVENT_TYPES.has(event.type)) {
                 this.armCurrentTurnSilenceTimer(stream);
@@ -2137,6 +2288,9 @@ export class SessionStreamManager {
             // Fix E: natural agent_end arrived — cancel the safety-net timer so we
             // don't double-emit.
             this.clearCurrentTurnSilenceTimer(stream);
+            // Defensive: a `subagent_end` may never arrive (crashed subagent), so
+            // never let the counter stay >0 into the next turn.
+            this.resetSubagentTracking(stream);
             // Keep the run busy across the agent_end -> continuation gap when the
             // SDK signals it will re-enter the loop (retry, length continuation,
             // compact-and-retry). The deferred settle below re-resolves the final
@@ -2249,6 +2403,9 @@ export class SessionStreamManager {
             // Fix E: error terminates the turn — cancel the safety-net timer so we
             // don't double-emit.
             this.clearCurrentTurnSilenceTimer(stream);
+            // Defensive: same as agent_end — a failed turn can leave subagents
+            // without a matching `subagent_end`.
+            this.resetSubagentTracking(stream);
             this.runTurnCleanup(failedTurn);
             this.settleRunState(stream);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aexol/spectral",
-  "version": "0.9.210",
+  "version": "0.9.212",
   "description": "AI coding agent for Aexol with relay-based browser access.",
   "type": "module",
   "private": false,