@aexol/spectral 0.9.210 → 0.9.212

package/dist/memory/tool-output-compressor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAEX,gBAAgB,EAIhB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,EAAE,gBAEvC,CAAC;AAgsBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AA8BD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,8BAA8B,CAElG;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1E;AAkDD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAC7F,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAC7C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAYvG;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAkCN"}
+{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAEX,gBAAgB,EAIhB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAQ5C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,EAAE,gBAEvC,CAAC;AAgsBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AA8BD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,8BAA8B,CAElG;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1E;AAgGD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAC7F,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAC7C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAYvG;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAmCN"}

package/dist/memory/tool-output-compressor.js

@@ -29,6 +29,7 @@
  */
 import { DEFAULT_COMPACTION_POLICY, } from "../sdk/coding-agent/core/compaction/policy.js";
 import { debugLog } from "./debug-log.js";
+import { isAlreadyOffloaded, offloadLargeResult } from "../sdk/coding-agent/core/tools/offload.js";
 export const DEFAULT_COMPRESSOR_CONFIG = {
     ...DEFAULT_COMPACTION_POLICY.toolOutputCompressor,
 };
@@ -672,6 +673,55 @@ function resolveCompressorConfig(ctx) {
     const manager = ctx.settingsManager;
     return manager?.getCompactionPolicy?.().toolOutputCompressor ?? DEFAULT_COMPRESSOR_CONFIG;
 }
+// ============================================================================
+// Large-result offload fallback
+// ============================================================================
+/**
+ * Fallback offload for tool types without native preview+file handling.
+ *
+ * - Skips read/bash (they already compress natively) and anything already
+ *   carrying a `Full output:` footer (notably the bash offload path).
+ * - Skips error results and non-text/binary content.
+ * - Persists the full text via `offloadLargeResult()` and swaps the event
+ *   text for preview + footer. Small results pass through untouched.
+ *
+ * The `tool_result` hook carries no session id, so offloads land under the
+ * shared `offloads/shared/` namespace.
+ */
+function maybeOffloadLargeResult(event) {
+    if (event.toolName === "read" || event.toolName === "bash")
+        return undefined;
+    if (event.isError)
+        return undefined;
+    const texts = event.content.filter((c) => c.type === "text" && typeof c.text === "string");
+    if (texts.length === 0)
+        return undefined;
+    const original = texts.map((c) => c.text).join("\n");
+    if (!original || original.includes("\0"))
+        return undefined;
+    if (isAlreadyOffloaded(original))
+        return undefined;
+    let offloaded;
+    try {
+        offloaded = offloadLargeResult(original, event.toolName, "shared");
+    }
+    catch {
+        return undefined;
+    }
+    if (!offloaded.fullOutputPath || !offloaded.truncation)
+        return undefined;
+    return {
+        content: [
+            ...event.content.filter((c) => c.type !== "text"),
+            { type: "text", text: offloaded.preview },
+        ],
+        details: {
+            ...(typeof event.details === "object" && event.details !== null ? event.details : {}),
+            fullOutputPath: offloaded.fullOutputPath,
+            offloadTruncation: offloaded.truncation,
+        },
+    };
+}
 function compressedContentResult(runtime, event, toolName, original, compressed) {
     if (!compressed || compressed === original)
         return undefined;
@@ -734,7 +784,8 @@ export function registerToolOutputCompressor(ext, runtime) {
             const compressed = compressBashOutput(event, config);
             return compressedContentResult(runtime, event, "bash", original, compressed);
         }
-        // Unknown tool types: do nothing
-        return;
+        // All other tool types (web_fetch, browser_*, seo_*, pdf_*, …): fall back
+        // to large-result offloading so no truncated output is ever lost.
+        return maybeOffloadLargeResult(_event);
     });
 }

package/dist/relay/client.d.ts

@@ -122,6 +122,17 @@ export declare class RelayClient extends EventEmitter {
     /** Guards the async window of `scheduleReconnect` (health check). */
     private reconnectInFlight;
     constructor(opts: RelayClientOptions);
+    /**
+     * Emit a non-fatal error without being able to crash the host process.
+     *
+     * The `error` event is documented as non-fatal (parse failure, transport
+     * noise, send failure), but a bare `this.emit("error", ...)` on a Node
+     * EventEmitter THROWS when no listener is registered. Embeddings that
+     * never subscribe to `error` (SDK consumers, `serve` running in silent
+     * mode, ad-hoc clients in tests) would die on the first transport hiccup
+     * instead of logging it. When a listener exists, behaviour is unchanged.
+     */
+    private emitError;
     /** Open the connection. Idempotent — calling twice is a no-op. */
     connect(): void;
     /**

package/dist/relay/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,SAAS,MAAM,IAAI,CAAC;AAsC3B,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,SAAS,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB;;OAEG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,2DAA2D;IAC3D,WAAW,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AASD,qBAAa,WAAY,SAAQ,YAAY;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0B;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+C;IAE3E,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,gBAAgB,CAAK;IAC7B,mEAAmE;IACnE,OAAO,CAAC,UAAU,CAAK;IACvB,qEAAqE;IACrE,OAAO,CAAC,sBAAsB,CAAK;IACnC,mEAAmE;IACnE,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,SAAS,CAAgB;IACjC,2FAA2F;IAC3F,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,SAAS,CAA+B;IAChD,iFAAiF;IACjF,OAAO,CAAC,UAAU,CAAS;IAE3B,qEAAqE;IACrE,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,kBAAkB,CAA+B;IACzD,OAAO,CAAC,gBAAgB,CAAS;IACjC,qEAAqE;IACrE,OAAO,CAAC,iBAAiB,CAAS;gBAEtB,IAAI,EAAE,kBAAkB;IAYpC,kEAAkE;IAClE,OAAO,IAAI,IAAI;IAMf;;;;;;;OAOG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,OAAO;IAQzC;;;OAGG;IACH,OAAO,IAAI,IAAI;IA6Bf,OAAO,CAAC,UAAU;IAwFlB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAgCtB,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,WAAW;IAiCnB,OAAO,CAAC,iBAAiB;IAQzB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAqDtB,OAAO,CAAC,eAAe;IAOvB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAgBtB;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA+GxB;;;;;OAKG;YACW,WAAW;YA8BX,iBAAiB;CAyDhC"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/relay/client.ts"],"names":[],"mappings":"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"}

package/dist/relay/client.js

@@ -124,6 +124,24 @@ export class RelayClient extends EventEmitter {
         this.exit = opts.exit ?? ((code) => process.exit(code));
         this.runtimeInfo = opts.runtimeInfo;
     }
+    /**
+     * Emit a non-fatal error without being able to crash the host process.
+     *
+     * The `error` event is documented as non-fatal (parse failure, transport
+     * noise, send failure), but a bare `this.emit("error", ...)` on a Node
+     * EventEmitter THROWS when no listener is registered. Embeddings that
+     * never subscribe to `error` (SDK consumers, `serve` running in silent
+     * mode, ad-hoc clients in tests) would die on the first transport hiccup
+     * instead of logging it. When a listener exists, behaviour is unchanged.
+     */
+    emitError(err) {
+        if (this.listenerCount("error") > 0) {
+            this.emit("error", err);
+            return;
+        }
+        const msg = err instanceof Error ? err.message : String(err);
+        this.logger.warn(`Relay error: ${msg}`);
+    }
     /** Open the connection. Idempotent — calling twice is a no-op. */
     connect() {
         if (this.disposed)
@@ -213,7 +231,7 @@ export class RelayClient extends EventEmitter {
                 parsed = JSON.parse(data.toString());
             }
             catch (err) {
-                this.emit("error", err);
+                this.emitError(err);
                 return;
             }
             // Heartbeat: reply pong inline, do NOT propagate.
@@ -257,7 +275,7 @@ export class RelayClient extends EventEmitter {
             // `ws` emits 'error' before 'close'. Reconnect is driven from the
             // `close` handler (or `forceReconnect` for suspected-dead sockets);
             // scheduling it here would double-schedule.
-            this.emit("error", err);
+            this.emitError(err);
         });
         ws.on("close", (code, reason) => {
             this.handleDisconnect(ws, code, reason?.toString() ?? "");
@@ -312,7 +330,7 @@ export class RelayClient extends EventEmitter {
                     clearTimeout(this.heartbeatPongTimer);
                     this.heartbeatPongTimer = null;
                 }
-                this.emit("error", err);
+                this.emitError(err);
                 this.forceReconnect("heartbeat-error");
             }
         }, HEARTBEAT_INTERVAL_MS);
@@ -428,7 +446,7 @@ export class RelayClient extends EventEmitter {
                     clearTimeout(this.sendTimer);
                     this.sendTimer = null;
                 }
-                this.emit("error", err);
+                this.emitError(err);
                 this.forceReconnect("send-error");
             }
         }
@@ -456,7 +474,7 @@ export class RelayClient extends EventEmitter {
             ws.terminate();
         }
         catch (err) {
-            this.emit("error", err);
+            this.emitError(err);
         }
         this.handleDisconnect(ws, 1006, reason);
     }
@@ -641,7 +659,7 @@ export class RelayClient extends EventEmitter {
                     // A synchronous throw from the WebSocket constructor (DNS, bad
                     // URL, etc.) must not kill the daemon — log it and re-schedule
                     // so the backoff continues forever.
-                    this.emit("error", err);
+                    this.emitError(err);
                     void this.scheduleReconnect().catch(() => { });
                 }
             }, delay);

package/dist/relay/history-projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"history-projection.d.ts","sourceRoot":"","sources":["../../src/relay/history-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,QAAa,CAAC;AAEpD,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAoMhF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAwC9D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAMtF"}
+{"version":3,"file":"history-projection.d.ts","sourceRoot":"","sources":["../../src/relay/history-projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,8EAA8E;AAC9E,eAAO,MAAM,yBAAyB,QAAa,CAAC;AAEpD,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB,iDAAiD,CAAC;AAwMhF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAwC9D;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,EAAE,CAMtF"}

package/dist/relay/history-projection.js

@@ -72,6 +72,13 @@ function projectToolResult(event) {
             compactDetails.status = details.status;
         if ("mode" in details)
             compactDetails.mode = details.mode;
+        // Preserve offload pointers so the agent can re-read full outputs.
+        if ("fullOutputPath" in details)
+            compactDetails.fullOutputPath = details.fullOutputPath;
+        if ("offloadTruncation" in details)
+            compactDetails.offloadTruncation = details.offloadTruncation;
+        if ("truncation" in details)
+            compactDetails.truncation = truncateStrings(details.truncation);
         projectedResult = { ...result, details: compactDetails };
     }
     if (typeof projectedResult.content === "string") {

package/dist/sdk/coding-agent/core/tools/offload.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Large-result offloading for tool outputs.
+ *
+ * Goal: no truncated tool result is ever lost. The full output goes to a
+ * file under `<configDir>/offloads/<sessionId>/`, and only a head+tail
+ * preview plus a footer (path + re-read instructions) enters the LLM context.
+ * The agent can then page through the file with `read` (offset/limit) or
+ * `bash` (sed/head/tail).
+ *
+ * This is the generic version of the pattern pioneered by the bash tool
+ * (preview + `Full output: <path>` footer). Small results pass through
+ * untouched — no file, no overhead. Binary-looking content (NUL bytes) is
+ * never offloaded.
+ */
+/** Default byte threshold above which a result is offloaded to disk. */
+export declare const DEFAULT_OFFLOAD_BYTES: number;
+/** Default line threshold above which a result is offloaded to disk. */
+export declare const DEFAULT_OFFLOAD_LINES = 2000;
+/** Preview head size (lines kept from the start). */
+export declare const PREVIEW_HEAD_LINES = 100;
+/** Preview tail size (lines kept from the end). */
+export declare const PREVIEW_TAIL_LINES = 100;
+/** Emergency byte cap for previews (head+tail can still be huge with long lines). */
+export declare const PREVIEW_MAX_BYTES: number;
+/** Marker identifying an already-offloaded result (bash tool compat). */
+export declare const OFFLOAD_MARKER = "Full output:";
+/** Anchored marker check: only a real `Full output: <path>.log` footer counts. */
+export declare const OFFLOAD_PATH_RE: RegExp;
+/**
+ * Parse a positive-int env override. Returns `fallback` when the variable is
+ * unset, unparseable, zero, or negative — a non-positive budget would
+ * otherwise disable offloading/GC entirely, so it is treated as "not set".
+ */
+export declare function envPositiveInt(name: string, fallback: number): number;
+/** Effective byte limit (override via `SPECTRAL_OFFLOAD_BYTES`). */
+export declare function getOffloadByteLimit(): number;
+/** Effective line limit (override via `SPECTRAL_OFFLOAD_LINES`). */
+export declare function getOffloadLineLimit(): number;
+export interface OffloadTruncation {
+    originalBytes: number;
+    shownBytes: number;
+    headLines: number;
+    tailLines: number;
+    omittedLines: number;
+    totalLines: number;
+    fullOutputPath: string;
+}
+export interface OffloadResult {
+    /** Model-facing text: full original for small results, preview+footer for large ones. */
+    preview: string;
+    /** Absolute path of the persisted full output, or null when nothing was written. */
+    fullOutputPath: string | null;
+    /** Truncation metadata, or null when nothing was offloaded. */
+    truncation: OffloadTruncation | null;
+}
+export declare function countLines(text: string): number;
+/** Marker for results that were already offloaded (or produced by the bash tool). */
+export declare function isAlreadyOffloaded(text: string): boolean;
+/**
+ * Whether `text` is large enough to deserve offloading.
+ * Binary-looking content (NUL bytes) is never offloaded.
+ */
+export declare function shouldOffload(text: string): boolean;
+export interface PreviewResult {
+    preview: string;
+    headLines: number;
+    tailLines: number;
+    omittedLines: number;
+    totalLines: number;
+}
+/**
+ * Build a head+tail preview. Never cuts in the middle of a line (except via
+ * the emergency byte cap below); the gap is replaced with a
+ * `[... N lines omitted ...]` marker. When head+tail itself exceeds
+ * `PREVIEW_MAX_BYTES` (e.g. a single giant line), the preview is cut
+ * mid-line with a `[... N bytes omitted ...]` marker so the LLM context
+ * never receives an unbounded preview.
+ */
+export declare function buildPreview(text: string, headLines?: number, tailLines?: number): PreviewResult;
+export interface OffloadFooterOptions {
+    headLines?: number;
+    tailLines?: number;
+    totalLines?: number;
+}
+/**
+ * Single-line footer appended to a preview. Carries the full-output path plus
+ * a copy-pasteable re-read hint for the agent.
+ */
+export declare function formatOffloadFooter(path: string, shown: number, total: number, opts?: OffloadFooterOptions): string;
+/**
+ * Resolve (and create) the offload file path for a tool result:
+ * `<configDir>/offloads/<sessionId>/<tool>-<timestamp>-<rand>.log`.
+ * Honors `SPECTRAL_CONFIG_DIR` via `getConfigDir()`.
+ */
+export declare function resolveOffloadPath(sessionId: string, toolName: string): string;
+/**
+ * Offload `text` to disk when it exceeds the size thresholds.
+ * Small (or binary, or already-offloaded) results are returned unchanged
+ * with `fullOutputPath: null` — no file, no overhead.
+ */
+export declare function offloadLargeResult(text: string, toolName: string, sessionId: string): OffloadResult;
+//# sourceMappingURL=offload.d.ts.map

package/dist/sdk/coding-agent/core/tools/offload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offload.d.ts","sourceRoot":"","sources":["../../../../../src/sdk/coding-agent/core/tools/offload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAQH,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAC/C,wEAAwE;AACxE,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C,qDAAqD;AACrD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,mDAAmD;AACnD,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,qFAAqF;AACrF,eAAO,MAAM,iBAAiB,QAAoB,CAAC;AACnD,yEAAyE;AACzE,eAAO,MAAM,cAAc,iBAAiB,CAAC;AAC7C,kFAAkF;AAClF,eAAO,MAAM,eAAe,QAA0B,CAAC;AAEvD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAKrE;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,oEAAoE;AACpE,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC7B,yFAAyF;IACzF,OAAO,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+DAA+D;IAC/D,UAAU,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACrC;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,qFAAqF;AACrF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKnD;AAED,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAA2B,EACtC,SAAS,GAAE,MAA2B,GACpC,aAAa,CAmBf;AAmCD,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,oBAAyB,GAC7B,MAAM,CAiBR;AAOD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,aAAa,CA6BnG"}

package/dist/sdk/coding-agent/core/tools/offload.js

@@ -0,0 +1,207 @@
+/**
+ * Large-result offloading for tool outputs.
+ *
+ * Goal: no truncated tool result is ever lost. The full output goes to a
+ * file under `<configDir>/offloads/<sessionId>/`, and only a head+tail
+ * preview plus a footer (path + re-read instructions) enters the LLM context.
+ * The agent can then page through the file with `read` (offset/limit) or
+ * `bash` (sed/head/tail).
+ *
+ * This is the generic version of the pattern pioneered by the bash tool
+ * (preview + `Full output: <path>` footer). Small results pass through
+ * untouched — no file, no overhead. Binary-looking content (NUL bytes) is
+ * never offloaded.
+ */
+import { randomBytes } from "node:crypto";
+import { mkdirSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { getConfigDir } from "../../../../config.js";
+import { DEFAULT_MAX_BYTES } from "./truncate.js";
+/** Default byte threshold above which a result is offloaded to disk. */
+export const DEFAULT_OFFLOAD_BYTES = 50 * 1024; // 50KB
+/** Default line threshold above which a result is offloaded to disk. */
+export const DEFAULT_OFFLOAD_LINES = 2000;
+/** Preview head size (lines kept from the start). */
+export const PREVIEW_HEAD_LINES = 100;
+/** Preview tail size (lines kept from the end). */
+export const PREVIEW_TAIL_LINES = 100;
+/** Emergency byte cap for previews (head+tail can still be huge with long lines). */
+export const PREVIEW_MAX_BYTES = DEFAULT_MAX_BYTES;
+/** Marker identifying an already-offloaded result (bash tool compat). */
+export const OFFLOAD_MARKER = "Full output:";
+/** Anchored marker check: only a real `Full output: <path>.log` footer counts. */
+export const OFFLOAD_PATH_RE = /Full output: \S+\.log/;
+/**
+ * Parse a positive-int env override. Returns `fallback` when the variable is
+ * unset, unparseable, zero, or negative — a non-positive budget would
+ * otherwise disable offloading/GC entirely, so it is treated as "not set".
+ */
+export function envPositiveInt(name, fallback) {
+    const raw = process.env[name];
+    if (!raw)
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+/** Effective byte limit (override via `SPECTRAL_OFFLOAD_BYTES`). */
+export function getOffloadByteLimit() {
+    return envPositiveInt("SPECTRAL_OFFLOAD_BYTES", DEFAULT_OFFLOAD_BYTES);
+}
+/** Effective line limit (override via `SPECTRAL_OFFLOAD_LINES`). */
+export function getOffloadLineLimit() {
+    return envPositiveInt("SPECTRAL_OFFLOAD_LINES", DEFAULT_OFFLOAD_LINES);
+}
+export function countLines(text) {
+    if (text.length === 0)
+        return 0;
+    const lines = text.split("\n");
+    // A trailing newline does not start a new line.
+    return text.endsWith("\n") ? lines.length - 1 : lines.length;
+}
+/** Marker for results that were already offloaded (or produced by the bash tool). */
+export function isAlreadyOffloaded(text) {
+    return OFFLOAD_PATH_RE.test(text);
+}
+/**
+ * Whether `text` is large enough to deserve offloading.
+ * Binary-looking content (NUL bytes) is never offloaded.
+ */
+export function shouldOffload(text) {
+    if (!text || text.includes("\0"))
+        return false;
+    if (isAlreadyOffloaded(text))
+        return false;
+    if (Buffer.byteLength(text, "utf-8") > getOffloadByteLimit())
+        return true;
+    return countLines(text) > getOffloadLineLimit();
+}
+/**
+ * Build a head+tail preview. Never cuts in the middle of a line (except via
+ * the emergency byte cap below); the gap is replaced with a
+ * `[... N lines omitted ...]` marker. When head+tail itself exceeds
+ * `PREVIEW_MAX_BYTES` (e.g. a single giant line), the preview is cut
+ * mid-line with a `[... N bytes omitted ...]` marker so the LLM context
+ * never receives an unbounded preview.
+ */
+export function buildPreview(text, headLines = PREVIEW_HEAD_LINES, tailLines = PREVIEW_TAIL_LINES) {
+    const rawLines = text.split("\n");
+    // Drop the phantom empty element from a trailing newline.
+    const lines = text.endsWith("\n") && rawLines.length > 0 ? rawLines.slice(0, -1) : rawLines;
+    const totalLines = lines.length;
+    if (totalLines <= headLines + tailLines) {
+        return capPreviewBytes(text, {
+            preview: text,
+            headLines: totalLines,
+            tailLines: 0,
+            omittedLines: 0,
+            totalLines,
+        });
+    }
+    const head = lines.slice(0, headLines);
+    const tail = lines.slice(totalLines - tailLines);
+    const omittedLines = totalLines - headLines - tailLines;
+    const preview = [...head, `[... ${omittedLines} lines omitted ...]`, ...tail].join("\n");
+    return capPreviewBytes(preview, { preview, headLines, tailLines, omittedLines, totalLines });
+}
+/**
+ * Emergency byte cap for previews. Long-line blobs (e.g. minified JSON on a
+ * single line) can make head+tail previews arbitrarily large; cut them
+ * mid-line with a byte-omitted marker. UTF-8 safe via Buffer slicing.
+ */
+function capPreviewBytes(textOrResult, fallback) {
+    const text = typeof textOrResult === "string" ? textOrResult : textOrResult.preview;
+    const base = typeof textOrResult === "string"
+        ? fallback
+        : {
+            preview: textOrResult.preview,
+            headLines: textOrResult.headLines,
+            tailLines: textOrResult.tailLines,
+            omittedLines: textOrResult.omittedLines,
+            totalLines: textOrResult.totalLines,
+        };
+    if (Buffer.byteLength(text, "utf-8") <= PREVIEW_MAX_BYTES) {
+        return { ...base, preview: text };
+    }
+    const buf = Buffer.from(text, "utf-8");
+    // Leave room for the marker; walk back to a UTF-8 char boundary.
+    const markerReserve = 64;
+    let end = Math.max(0, PREVIEW_MAX_BYTES - markerReserve);
+    while (end > 0 && end < buf.length && (buf[end] & 0xc0) === 0x80)
+        end--;
+    const omitted = buf.length - end;
+    const preview = buf.subarray(0, end).toString("utf-8") + `\n[... ${omitted} bytes omitted ...]`;
+    return { ...base, preview };
+}
+/**
+ * Single-line footer appended to a preview. Carries the full-output path plus
+ * a copy-pasteable re-read hint for the agent.
+ */
+export function formatOffloadFooter(path, shown, total, opts = {}) {
+    const headLines = opts.headLines ?? PREVIEW_HEAD_LINES;
+    const tailLines = opts.tailLines ?? PREVIEW_TAIL_LINES;
+    // Guard against inconsistent callers (e.g. byte-counted `shown` on a
+    // line-based total): never claim to show more than exists.
+    const safeShown = Math.min(shown, total);
+    const safeTotal = Math.max(total, 0);
+    let readHint;
+    if (opts.totalLines !== undefined && opts.totalLines > headLines + tailLines) {
+        const tailStart = opts.totalLines - tailLines + 1;
+        readHint =
+            `Read with: sed -n '1,${headLines}p' ${path} | head -c ${DEFAULT_MAX_BYTES} ` +
+                `or sed -n '${tailStart},${opts.totalLines}p' ${path} | head -c ${DEFAULT_MAX_BYTES}`;
+    }
+    else {
+        readHint = `Read with: sed -n '1,${headLines}p' ${path} | head -c ${DEFAULT_MAX_BYTES}`;
+    }
+    return `[Truncated: showing ${safeShown} of ${safeTotal} bytes. Full output: ${path}. ${readHint}]`;
+}
+function sanitizeSegment(segment) {
+    const cleaned = segment.replace(/[^a-zA-Z0-9_-]/g, "_").slice(0, 64);
+    return cleaned || "shared";
+}
+/**
+ * Resolve (and create) the offload file path for a tool result:
+ * `<configDir>/offloads/<sessionId>/<tool>-<timestamp>-<rand>.log`.
+ * Honors `SPECTRAL_CONFIG_DIR` via `getConfigDir()`.
+ */
+export function resolveOffloadPath(sessionId, toolName) {
+    const dir = join(getConfigDir(), "offloads", sanitizeSegment(sessionId));
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const stamp = `${Date.now()}-${randomBytes(4).toString("hex")}`;
+    return join(dir, `${sanitizeSegment(toolName)}-${stamp}.log`);
+}
+/**
+ * Offload `text` to disk when it exceeds the size thresholds.
+ * Small (or binary, or already-offloaded) results are returned unchanged
+ * with `fullOutputPath: null` — no file, no overhead.
+ */
+export function offloadLargeResult(text, toolName, sessionId) {
+    if (!shouldOffload(text)) {
+        return { preview: text, fullOutputPath: null, truncation: null };
+    }
+    const originalBytes = Buffer.byteLength(text, "utf-8");
+    const { preview, headLines, tailLines, omittedLines, totalLines } = buildPreview(text);
+    const fullOutputPath = resolveOffloadPath(sessionId, toolName);
+    // Owner-only: offloads may contain secrets (headers, tokens, page bodies).
+    writeFileSync(fullOutputPath, text, { encoding: "utf-8", mode: 0o600 });
+    // `shown` is measured on the actually displayed preview text.
+    const footer = formatOffloadFooter(fullOutputPath, Buffer.byteLength(preview, "utf-8"), originalBytes, {
+        headLines,
+        tailLines,
+        totalLines,
+    });
+    const previewWithFooter = `${preview}\n${footer}`;
+    return {
+        preview: previewWithFooter,
+        fullOutputPath,
+        truncation: {
+            originalBytes,
+            shownBytes: Buffer.byteLength(previewWithFooter, "utf-8"),
+            headLines,
+            tailLines,
+            omittedLines,
+            totalLines,
+            fullOutputPath,
+        },
+    };
+}

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":"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"}
+{"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

@@ -446,6 +446,13 @@ function parseWireToolEvents(eventsJsonl) {
  * images and other rich results.
  */
 const MAX_REHYDRATED_TEXT = 100_000;
+/**
+ * Ceiling for blocks that already carry an offload footer (`Full output:`).
+ * These blocks are a bounded preview + a re-readable path, so cutting them
+ * with the generic limit would destroy the footer. Keep them whole up to
+ * this size; larger ones lose their middle but keep head + footer.
+ */
+const MAX_REHYDRATED_OFFLOAD_TEXT = 200_000;
 function sanitizeRehydratedBlock(block) {
     // Tool-result image blocks are not accepted by every provider; the raw
     // result remains in events_jsonl for the UI, while the model gets a compact reference.
@@ -460,6 +467,20 @@ function sanitizeRehydratedBlock(block) {
     // Truncate oversized text blocks to prevent context overflow.
     if (block.type !== "text")
         return block;
+    if (block.text.includes("Full output:")) {
+        if (block.text.length <= MAX_REHYDRATED_OFFLOAD_TEXT)
+            return block;
+        // Keep the head (preview) and the tail (offload footer), drop the middle.
+        const keepHead = Math.floor(MAX_REHYDRATED_OFFLOAD_TEXT * 0.7);
+        const keepTail = MAX_REHYDRATED_OFFLOAD_TEXT - keepHead;
+        const omitted = block.text.length - keepHead - keepTail;
+        return {
+            ...block,
+            text: block.text.slice(0, keepHead) +
+                `\n\n[... ${omitted.toLocaleString()} bytes omitted from rehydrated offload preview ...]\n\n` +
+                block.text.slice(block.text.length - keepTail),
+        };
+    }
     if (block.text.length <= MAX_REHYDRATED_TEXT)
         return block;
     const omitted = block.text.length - MAX_REHYDRATED_TEXT;

package/dist/server/offload-gc.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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.
+ */
+export declare const DEFAULT_OFFLOAD_TTL_DAYS = 7;
+export declare const DEFAULT_OFFLOAD_MAX_MB = 500;
+export declare function getOffloadTtlMs(): number;
+export declare function getOffloadMaxBytes(): number;
+export interface OffloadSweepResult {
+    removedSessions: number;
+    removedBytes: number;
+}
+/** Remove stale/over-budget offload directories. Never throws. */
+export declare function sweepOffloads(root?: string): OffloadSweepResult;
+//# sourceMappingURL=offload-gc.d.ts.map

package/dist/server/offload-gc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offload-gc.d.ts","sourceRoot":"","sources":["../../src/server/offload-gc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAsBD,MAAM,WAAW,kBAAkB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAoD/D"}