@aexol/spectral 0.9.176 → 0.9.178

package/dist/server/agent-bridge.d.ts

@@ -186,6 +186,16 @@ export declare class AgentBridge {
     private promptReject?;
     /** Per-turn tool execution backstop timer (see TOOL_EXECUTION_TIMEOUT_MS). */
     private toolExecutionTimer?;
+    /**
+     * Number of in-flight `subagent` tool calls. While >0 the parent prompt
+     * inactivity watchdog is paused: the parent is legitimately waiting on the
+     * child agent, and the child carries its own independent deadline
+     * (SPECTRAL_SUBAGENT_TIMEOUT_MS). Pausing (rather than just bumping on
+     * progress events) prevents a silent subagent phase — a long LLM thinking
+     * stretch or a quiet build/test — from tripping the parent watchdog and
+     * aborting the whole prompt mid-delegation.
+     */
+    private activeSubagents;
     /** Current model's credit rates (from availableAgentModels), used for token_usage. */
     private activeCreditRates;
     private memoryPhase;
@@ -393,6 +403,16 @@ export declare class AgentBridge {
      * streaming tool output is never killed by the inactivity timeout.
      */
     private bumpPromptActivity;
+    /** Arm a fresh inactivity watchdog timeout (used by bump/resume paths). */
+    private schedulePromptActivityTimeout;
+    /**
+     * Pause the parent inactivity watchdog while a subagent tool is running.
+     * Idempotent per active subagent: the watchdog stays cleared until the last
+     * in-flight subagent finishes.
+     */
+    private pausePromptActivityForSubagent;
+    /** Re-arm the inactivity watchdog once no subagents remain in flight. */
+    private resumePromptActivityAfterSubagent;
     private clearPromptTimers;
     /**
      * Start the per-turn tool execution backstop. Only the first

package/dist/server/agent-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-bridge.d.ts","sourceRoot":"","sources":["../../src/server/agent-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAaH,OAAO,EAQL,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAC;AAatC,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,8BAA8B,CAAC;AAatC,OAAO,EACL,kBAAkB,IAAI,yBAAyB,EAEhD,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAI3E,UAAU,4BAA4B;IACpC,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;AAkBD,sEAAsE;AACtE,MAAM,MAAM,oBAAoB,GAAG,OAAO,yBAAyB,CAAC;AAmCpE,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qFAAqF;IACrF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,GAAG,EAAE,MAAM,CAAC;IACZ,qFAAqF;IACrF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,IAAI,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACnC;;;;;OAKG;IACH,0BAA0B,EAAE,CAAC,GAAG,EAAE;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;QACpB,6EAA6E;QAC7E,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,KAAK,IAAI,CAAC;IACX;;;OAGG;IACH,yBAAyB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,WAAW,EAAE,CAAC;IACxB;;;;OAIG;IACH,cAAc,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC9C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,oBAAoB,CAAC;IAC1C;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAklBD,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,iCAAiC,CAAqB;IAC9D,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,OAAO,CAAC,CAA0B;IAC1C,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAqB;IACjC;;;;;OAKG;IACH,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC;;;;OAIG;IACH,OAAO,CAAC,aAAa,CAAC,CAAiB;IACvC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB,CAAC,CAAS;IAEpC,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,YAAY,CAAC,CAAuB;IAC5C,8EAA8E;IAC9E,OAAO,CAAC,kBAAkB,CAAC,CAAgC;IAC3D,sFAAsF;IACtF,OAAO,CAAC,iBAAiB,CAMT;IAChB,OAAO,CAAC,WAAW,CACuD;IAC1E,OAAO,CAAC,mBAAmB,CAA+B;IAC1D;;;;OAIG;IACH,OAAO,CAAC,cAAc,CAAuB;IAC7C,OAAO,CAAC,cAAc,CAAC,CAA2B;IAClD,OAAO,CAAC,mBAAmB,CAAC,CAAgC;gBAEhD,IAAI,EAAE,kBAAkB;IAIpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA2X5B,OAAO,CAAC,4BAA4B;IAWpC;;;;;OAKG;YACW,qBAAqB;IAcnC;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3C;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAmC3B,OAAO,CAAC,sBAAsB;YAahB,oBAAoB;IAoBlC;;;;;;;;;;;;OAYG;IACH;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,0BAA0B;IA+GlC;;;;;;;;;;;;;;;OAeG;IACH;;;;;;;;OAQG;IACH,wBAAwB,IAAI,MAAM,GAAG,SAAS;IAI9C;;;;OAIG;IACH,eAAe,IACX;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GACxE,SAAS;IAIb,gBAAgB,IAAI,KAAK,CAAC;QACxB,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;IAgBF,iBAAiB,IAAI;QACnB,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;IAYD,OAAO,CAAC,iBAAiB;IAmCnB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC;IA2DpE;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,iCAAiC;IAkBzC;;;;;;OAMG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAoBpD;;;;;;;;;OASG;IACH,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI;IAI7D;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgDrE;;;;;;;;OAQG;YACW,iBAAiB;IAwB/B;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,0BAA0B;IAiBlC;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;IAY1B,OAAO,CAAC,iBAAiB;IAQzB;;;;;OAKG;IACH,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,uBAAuB;IAMzB,OAAO,CACX,OAAO,CAAC,EAAE,MAAM,GAAG,4BAA4B,GAC9C,OAAO,CAAC,gBAAgB,CAAC;IAY5B,OAAO,IAAI,IAAI;IA6Bf;;;;;OAKG;IACH,OAAO,CAAC,aAAa;IAqBrB;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAwD9B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;CAggBzC"}
+{"version":3,"file":"agent-bridge.d.ts","sourceRoot":"","sources":["../../src/server/agent-bridge.ts"],"names":[],"mappings":"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"}

package/dist/server/agent-bridge.js

@@ -570,8 +570,13 @@ const PROMPT_INACTIVITY_TIMEOUT_MS = Number(process.env.SPECTRAL_PROMPT_INACTIVI
  * though those chunks no longer reset the inactivity watchdog, this timer
  * provides an absolute backstop per tool invocation.
  *
- * Default 60 minutes (raised from 30 — long builds/subagents were hitting it),
+ * Default 60 minutes (raised from 30 — long builds were hitting it),
  * overridable via `SPECTRAL_TOOL_EXECUTION_TIMEOUT_MS`.
+ *
+ * The `subagent` tool is exempt: it carries its own independent deadline
+ * (`SPECTRAL_SUBAGENT_TIMEOUT_MS`, default 4h) and streams progress events
+ * that keep the inactivity watchdog fed, so the per-tool backstop must not
+ * kill a long-running subagent mid-delegation.
  * On expiry it forces a prompt reject (same abort path as the inactivity
  * watchdog) with a descriptive message.
  */
@@ -609,6 +614,16 @@ export class AgentBridge {
     promptReject;
     /** Per-turn tool execution backstop timer (see TOOL_EXECUTION_TIMEOUT_MS). */
     toolExecutionTimer;
+    /**
+     * Number of in-flight `subagent` tool calls. While >0 the parent prompt
+     * inactivity watchdog is paused: the parent is legitimately waiting on the
+     * child agent, and the child carries its own independent deadline
+     * (SPECTRAL_SUBAGENT_TIMEOUT_MS). Pausing (rather than just bumping on
+     * progress events) prevents a silent subagent phase — a long LLM thinking
+     * stretch or a quiet build/test — from tripping the parent watchdog and
+     * aborting the whole prompt mid-delegation.
+     */
+    activeSubagents = 0;
     /** Current model's credit rates (from availableAgentModels), used for token_usage. */
     activeCreditRates = null;
     memoryPhase = "idle";
@@ -1530,10 +1545,33 @@ export class AgentBridge {
         if (!this.promptActivityTimer)
             return;
         clearTimeout(this.promptActivityTimer);
-        this.promptActivityTimer = setTimeout(() => {
+        this.promptActivityTimer = this.schedulePromptActivityTimeout();
+    }
+    /** Arm a fresh inactivity watchdog timeout (used by bump/resume paths). */
+    schedulePromptActivityTimeout() {
+        return setTimeout(() => {
             this.promptReject?.(new Error(`Agent prompt inactive for ${PROMPT_INACTIVITY_TIMEOUT_MS / 1000}s`));
         }, PROMPT_INACTIVITY_TIMEOUT_MS);
     }
+    /**
+     * Pause the parent inactivity watchdog while a subagent tool is running.
+     * Idempotent per active subagent: the watchdog stays cleared until the last
+     * in-flight subagent finishes.
+     */
+    pausePromptActivityForSubagent() {
+        this.activeSubagents += 1;
+        if (this.promptActivityTimer) {
+            clearTimeout(this.promptActivityTimer);
+            this.promptActivityTimer = undefined;
+        }
+    }
+    /** Re-arm the inactivity watchdog once no subagents remain in flight. */
+    resumePromptActivityAfterSubagent() {
+        this.activeSubagents = Math.max(0, this.activeSubagents - 1);
+        if (this.activeSubagents === 0 && this.promptReject) {
+            this.promptActivityTimer = this.schedulePromptActivityTimeout();
+        }
+    }
     clearPromptTimers() {
         if (this.promptActivityTimer) {
             clearTimeout(this.promptActivityTimer);
@@ -1541,6 +1579,7 @@ export class AgentBridge {
         }
         this.clearToolExecutionTimer();
         this.promptReject = undefined;
+        this.activeSubagents = 0;
     }
     /**
      * Start the per-turn tool execution backstop. Only the first
@@ -1777,9 +1816,22 @@ export class AgentBridge {
                 return;
             }
             case "tool_execution_start": {
-                this.startToolExecutionTimer();
+                // Subagents are exempt from the per-tool execution backstop: they run
+                // with their own independent deadline (SPECTRAL_SUBAGENT_TIMEOUT_MS,
+                // default 4h) and stream subagent_progress/subagent_tool_progress
+                // events that already reset the inactivity watchdog. Applying the
+                // shared TOOL_EXECUTION_TIMEOUT_MS ceiling here would abort a
+                // legitimately long-running subagent (and its parent prompt) with a
+                // bare "aborted" result.
+                if (ev.toolName !== "subagent") {
+                    this.startToolExecutionTimer();
+                }
                 // Emit subagent_start for subagent tool invocations (Option B frontend panels).
                 if (ev.toolName === "subagent") {
+                    // The parent prompt is now waiting on the child agent. Pause the
+                    // inactivity watchdog until the subagent finishes so a silent
+                    // subagent phase cannot abort the parent mid-delegation.
+                    this.pausePromptActivityForSubagent();
                     const args = ev.args;
                     const mode = args?.chain?.length > 0
                         ? "chain"
@@ -1874,9 +1926,18 @@ export class AgentBridge {
                 return;
             }
             case "tool_execution_end": {
-                this.clearToolExecutionTimer();
+                // Subagents don't arm the per-tool backstop (see tool_execution_start),
+                // so they must not clear it either — otherwise a subagent ending while
+                // a non-subagent tool is still running would drop that tool's ceiling.
+                if (ev.toolName !== "subagent") {
+                    this.clearToolExecutionTimer();
+                }
                 // Emit subagent_end for subagent tool completions.
                 if (ev.toolName === "subagent") {
+                    // Re-arm the parent inactivity watchdog once the last subagent
+                    // finishes. The subagent's own timeout already governed the child;
+                    // the parent resumes normal silence-based protection from here.
+                    this.resumePromptActivityAfterSubagent();
                     const result = ev.result;
                     const details = result?.details;
                     if (details?.results && details.results.length > 0) {

package/dist/server/error-humanizer.d.ts

@@ -7,7 +7,9 @@
  *
  * This module converts any caught error into a short, safe, user-facing
  * string. Raw errors are still logged server-side at the catch sites; this
- * helper only controls the user-facing message.
+ * helper only controls the user-facing message. Unknown, non-transient errors
+ * keep a sanitized version of their underlying cause so the UI can show what
+ * actually happened instead of only a generic fallback.
  */
 /**
  * Classification regex reused from agent-loop.ts (retry classification).
@@ -22,10 +24,13 @@ export declare const PROVIDER_ERROR_PATTERNS: RegExp;
  *  1. Rate limit / 429 / overloaded / 529 / "too many requests" /
  *     "temporarily rate-limited" → "Rate limit reached. Please try again in a moment."
  *  2. timeout / econnreset / "fetch failed" / network → "Network error. Please try again."
- *  3. Any other Error or non-Error value → "Something went wrong. Please try again."
+ *  3. Any other Error / string → a sanitized, concise version of the underlying
+ *     cause. Non-string/non-Error values (or values whose cause is empty after
+ *     sanitization) → "Something went wrong. Please try again."
  *
- * Never leaks raw messages, JSON blobs, or internal identifiers (org_...,
- * user_id, provider_name, is_byok, upstream model names).
+ * The sanitizer still strips JSON blobs, stack frames, URLs, absolute paths,
+ * and internal identifiers (org_..., user_id, provider_name, is_byok,
+ * upstream model names).
  */
 export declare function humanizeProviderError(err: unknown): string;
 //# sourceMappingURL=error-humanizer.d.ts.map

package/dist/server/error-humanizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-humanizer.d.ts","sourceRoot":"","sources":["../../src/server/error-humanizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QACsN,CAAC;AAoC3P;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAa1D"}
+{"version":3,"file":"error-humanizer.d.ts","sourceRoot":"","sources":["../../src/server/error-humanizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,QACsN,CAAC;AAqC3P;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAa1D"}

package/dist/server/error-humanizer.js

@@ -7,7 +7,9 @@
  *
  * This module converts any caught error into a short, safe, user-facing
  * string. Raw errors are still logged server-side at the catch sites; this
- * helper only controls the user-facing message.
+ * helper only controls the user-facing message. Unknown, non-transient errors
+ * keep a sanitized version of their underlying cause so the UI can show what
+ * actually happened instead of only a generic fallback.
  */
 /**
  * Classification regex reused from agent-loop.ts (retry classification).
@@ -18,6 +20,7 @@ export const PROVIDER_ERROR_PATTERNS = /rate.?limit|429|overloaded|529|timeout|n
 const RATE_LIMIT_MESSAGE = "Rate limit reached. Please try again in a moment.";
 const NETWORK_ERROR_MESSAGE = "Network error. Please try again.";
 const GENERIC_MESSAGE = "Something went wrong. Please try again.";
+const MAX_USER_ERROR_LENGTH = 240;
 /**
  * Coerce any caught value into a single string suitable for regex matching,
  * without ever returning it to the user. This is only used internally for
@@ -57,10 +60,13 @@ function toErrorString(err) {
  *  1. Rate limit / 429 / overloaded / 529 / "too many requests" /
  *     "temporarily rate-limited" → "Rate limit reached. Please try again in a moment."
  *  2. timeout / econnreset / "fetch failed" / network → "Network error. Please try again."
- *  3. Any other Error or non-Error value → "Something went wrong. Please try again."
+ *  3. Any other Error / string → a sanitized, concise version of the underlying
+ *     cause. Non-string/non-Error values (or values whose cause is empty after
+ *     sanitization) → "Something went wrong. Please try again."
  *
- * Never leaks raw messages, JSON blobs, or internal identifiers (org_...,
- * user_id, provider_name, is_byok, upstream model names).
+ * The sanitizer still strips JSON blobs, stack frames, URLs, absolute paths,
+ * and internal identifiers (org_..., user_id, provider_name, is_byok,
+ * upstream model names).
  */
 export function humanizeProviderError(err) {
     const text = toErrorString(err);
@@ -73,5 +79,69 @@ export function humanizeProviderError(err) {
     if (PROVIDER_ERROR_PATTERNS.test(text)) {
         return NETWORK_ERROR_MESSAGE;
     }
-    return GENERIC_MESSAGE;
+    return extractSafeErrorCause(err) || GENERIC_MESSAGE;
+}
+/**
+ * Extract the deepest, non-empty, human-readable cause from an Error/string
+ * and remove anything that could leak internal identifiers, credentials,
+ * JSON payloads, stack frames, URLs, or absolute filesystem paths.
+ *
+ * Non-Error, non-string values intentionally have no safe textual cause and
+ * fall back to the generic message.
+ */
+function extractSafeErrorCause(err) {
+    if (err instanceof Error) {
+        const parts = [];
+        let current = err;
+        while (current instanceof Error) {
+            const sanitized = sanitizeErrorCause(current.message);
+            if (sanitized)
+                parts.push(sanitized);
+            current = current.cause;
+        }
+        // Some SDKs attach a non-Error cause (usually a string or parsed JSON).
+        if (typeof current === "string") {
+            const sanitized = sanitizeErrorCause(current);
+            if (sanitized)
+                parts.push(sanitized);
+        }
+        return parts.length > 0 ? parts[parts.length - 1] : "";
+    }
+    if (typeof err === "string")
+        return sanitizeErrorCause(err);
+    return "";
+}
+function sanitizeErrorCause(raw) {
+    if (!raw)
+        return "";
+    let text = raw;
+    // Remove whole JSON payloads. Raw provider errors often wrap the cause in a
+    // JSON blob carrying org ids, provider names, and model names.
+    text = text.replace(/\{[\s\S]*\}/g, " ");
+    text = text.replace(/\[[\s\S]*\]/g, " ");
+    // Remove URLs (may embed signed tokens).
+    text = text.replace(/\bhttps?:\/\/\S+/gi, " ");
+    // Remove absolute filesystem paths (POSIX and Windows).
+    text = text.replace(/(?:^|[\s("'])\/[\w.@-]+(?:\/[\w.@-]+)*/g, " ");
+    text = text.replace(/(?:^|[\s("'])[A-Za-z]:[\\/][^\s]*/g, " ");
+    // Remove internal identifiers and sensitive key/value metadata. Key/value
+    // metadata is stripped first so an identifier inside a value is consumed
+    // with the key rather than leaving a dangling key that then eats the next
+    // word in the message.
+    text = text.replace(/\b(?:provider_name|user_id|is_byok|api[_-]?key|authorization|secret|token)\s*[:=]\s*[^\s,;]+/gi, " ");
+    text = text.replace(/\bmodel\s*[:=]\s*[^\s,;]+/gi, " ");
+    text = text.replace(/\borg_[A-Za-z0-9_-]+\b/gi, " ");
+    // Remove stack-trace frames (multi-line Error messages).
+    text = text.replace(/^\s+at\s+[^\n]*/gm, " ");
+    // Remove ANSI escape sequences and normalize whitespace/punctuation noise.
+    text = text
+        .replace(/\u001b\[[0-9;]*m/g, " ")
+        .replace(/\s+/g, " ")
+        .replace(/\s*([,;:])\s*(?=[,;:.])/g, "")
+        .trim();
+    if (!text)
+        return "";
+    if (text.length <= MAX_USER_ERROR_LENGTH)
+        return text;
+    return `${text.slice(0, MAX_USER_ERROR_LENGTH - 1).trimEnd()}…`;
 }

package/package.json

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