@aexol/spectral 0.9.209 → 0.9.211

package/dist/commands/serve.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAYlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAYrE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwiBlF;AA+DD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc5E"}
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/commands/serve.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAwBH,OAAO,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAYlE,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAmB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAarE;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAazD;AAED,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CA6B9D;AAED,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6EAA6E;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,qBAAqB,CAAC,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC;CAC/E;AAED,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,KAAK,EAAE,YAAY,CAAC;IACpB,wDAAwD;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAojBlF;AA+DD;;;GAGG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAc5E"}

package/dist/commands/serve.js

@@ -48,6 +48,7 @@ import { gracefulShutdown } from "../server/shutdown.js";
 import { getLiveMcpState } from "../mcp/state-getter.js";
 import { preflightSqlite, SessionStore } from "../server/storage.js";
 import { DevProcessRegistry } from "../server/dev-process-registry.js";
+import { sweepOffloads } from "../server/offload-gc.js";
 /** Default backend base URL when neither env nor override is set. */
 const DEFAULT_BACKEND_URL = "https://api.aexol.ai";
 import { getVersion } from "../version.js";
@@ -133,9 +134,21 @@ export async function runServe(opts = {}) {
         process.stderr.write(`✗ ${preflight.error}\n`);
         process.exit(1);
     }
+    // Pre-flight: sweep stale large-result offload files (fire-and-forget).
     const store = new SessionStore(dbPath);
     const devProcessRegistry = new DevProcessRegistry(getAgentDir());
     devProcessRegistry.reconcile();
+    // GC for stale large-result offload files. Deferred via setImmediate so it
+    // never blocks server startup; sweepOffloads() never throws, but the guard
+    // stays so a failed sweep can never take down serving.
+    setImmediate(() => {
+        try {
+            sweepOffloads();
+        }
+        catch {
+            // Best-effort.
+        }
+    });
     // Mutable holder for the meta-event publisher. Bound below once we
     // have both `relay` (the send target) and `registration.record.machineId`
     // (the canonical machineId the backend uses to fan out). The manager

package/dist/extensions/browser/tools/console.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/console.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CAyDhF"}
+{"version":3,"file":"console.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/console.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIvD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CA2EhF"}

package/dist/extensions/browser/tools/console.js

@@ -1,6 +1,7 @@
 /**
  * Console messages tool: browser_console_messages.
  */
+import { offloadLargeResult } from "../../../sdk/coding-agent/core/tools/offload.js";
 export function registerConsoleTools(ext, bs) {
     const consoleTool = {
         name: "browser_console_messages",
@@ -30,12 +31,31 @@ export function registerConsoleTools(ext, bs) {
                 }
                 const lines = messages.map((m) => `[${m.type.padEnd(7)}] ${m.text.slice(0, 300)}`);
                 const text = lines.join("\n");
+                // Small console dumps pass through untouched; large ones become
+                // preview + offload footer (fallback keeps the legacy cap).
+                let displayText = text;
+                let fullOutputPath;
+                let offloadTruncation;
+                try {
+                    const offloaded = offloadLargeResult(text, "browser_console_messages", "shared");
+                    displayText = offloaded.preview;
+                    if (offloaded.fullOutputPath && offloaded.truncation) {
+                        fullOutputPath = offloaded.fullOutputPath;
+                        offloadTruncation = offloaded.truncation;
+                    }
+                }
+                catch {
+                    displayText = text.length > 20_000 ? text.slice(0, 20_000) + "\n\n[truncated]" : text;
+                }
                 return {
                     content: [{
                             type: "text",
-                            text: text.length > 20_000 ? text.slice(0, 20_000) + "\n\n[truncated]" : text,
+                            text: displayText,
                         }],
-                    details: {},
+                    details: {
+                        ...(fullOutputPath ? { fullOutputPath } : {}),
+                        ...(offloadTruncation ? { offloadTruncation } : {}),
+                    },
                 };
             }
             catch (err) {

package/dist/extensions/browser/tools/evaluate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CA0GjF"}
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/evaluate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAuBvD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CAkHjF"}

package/dist/extensions/browser/tools/evaluate.js

@@ -1,6 +1,22 @@
 /**
  * Evaluate tools: browser_evaluate, browser_run_code_unsafe.
  */
+import { offloadLargeResult, } from "../../../sdk/coding-agent/core/tools/offload.js";
+function offloadBrowserText(text, toolName) {
+    try {
+        const offloaded = offloadLargeResult(text, toolName, "shared");
+        if (!offloaded.fullOutputPath || !offloaded.truncation)
+            return { text };
+        return {
+            text: offloaded.preview,
+            fullOutputPath: offloaded.fullOutputPath,
+            offloadTruncation: offloaded.truncation,
+        };
+    }
+    catch {
+        return { text: text.length > 50000 ? text.slice(0, 50000) + "\n\n[truncated]" : text };
+    }
+}
 export function registerEvaluateTools(ext, bs) {
     const evaluateTool = {
         name: "browser_evaluate",
@@ -34,12 +50,16 @@ export function registerEvaluateTools(ext, bs) {
                 const text = typeof result === "string"
                     ? result
                     : JSON.stringify(result, null, 2);
+                const offloaded = offloadBrowserText(text, "browser_evaluate");
                 return {
                     content: [{
                             type: "text",
-                            text: text.length > 50000 ? text.slice(0, 50000) + "\n\n[truncated]" : text,
+                            text: offloaded.text,
                         }],
-                    details: {},
+                    details: {
+                        ...(offloaded.fullOutputPath ? { fullOutputPath: offloaded.fullOutputPath } : {}),
+                        ...(offloaded.offloadTruncation ? { offloadTruncation: offloaded.offloadTruncation } : {}),
+                    },
                 };
             }
             catch (err) {
@@ -79,12 +99,16 @@ export function registerEvaluateTools(ext, bs) {
                 const text = typeof result === "string"
                     ? result
                     : JSON.stringify(result, null, 2);
+                const offloaded = offloadBrowserText(text, "browser_run_code_unsafe");
                 return {
                     content: [{
                             type: "text",
-                            text: text.length > 50000 ? text.slice(0, 50000) + "\n\n[truncated]" : text,
+                            text: offloaded.text,
                         }],
-                    details: {},
+                    details: {
+                        ...(offloaded.fullOutputPath ? { fullOutputPath: offloaded.fullOutputPath } : {}),
+                        ...(offloaded.offloadTruncation ? { offloadTruncation: offloaded.offloadTruncation } : {}),
+                    },
                 };
             }
             catch (err) {

package/dist/extensions/browser/tools/network.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CAwHhF"}
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../../../src/extensions/browser/tools/network.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAwBvD,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,EAAE,cAAc,GAAG,IAAI,CA4HhF"}

package/dist/extensions/browser/tools/network.js

@@ -1,6 +1,22 @@
 /**
  * Network tools: browser_network_requests, browser_network_request.
  */
+import { offloadLargeResult, } from "../../../sdk/coding-agent/core/tools/offload.js";
+function offloadBrowserText(text, toolName, legacyLimit) {
+    try {
+        const offloaded = offloadLargeResult(text, toolName, "shared");
+        if (!offloaded.fullOutputPath || !offloaded.truncation)
+            return { text };
+        return {
+            text: offloaded.preview,
+            fullOutputPath: offloaded.fullOutputPath,
+            offloadTruncation: offloaded.truncation,
+        };
+    }
+    catch {
+        return { text: text.length > legacyLimit ? text.slice(0, legacyLimit) + "\n\n[truncated]" : text };
+    }
+}
 export function registerNetworkTools(ext, bs) {
     const networkRequestsTool = {
         name: "browser_network_requests",
@@ -90,12 +106,16 @@ export function registerNetworkTools(ext, bs) {
                     }
                 }
                 const text = lines.join("\n");
+                const offloaded = offloadBrowserText(text, "browser_network_request", 50_000);
                 return {
                     content: [{
                             type: "text",
-                            text: text.length > 50_000 ? text.slice(0, 50_000) + "\n\n[truncated]" : text,
+                            text: offloaded.text,
                         }],
-                    details: {},
+                    details: {
+                        ...(offloaded.fullOutputPath ? { fullOutputPath: offloaded.fullOutputPath } : {}),
+                        ...(offloaded.offloadTruncation ? { offloadTruncation: offloaded.offloadTruncation } : {}),
+                    },
                 };
             }
             catch (err) {

package/dist/extensions/seo/tools/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/tools/fetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CA0I7E"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/seo/tools/fetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAyC9C,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,GAAG,IAAI,CAqK7E"}

package/dist/extensions/seo/tools/fetch.js

@@ -1,6 +1,33 @@
 import { fetchPage } from "../utils/fetcher.js";
 import { renderPage, isRendererAvailable } from "../utils/renderer.js";
-import { errorResult, textResult, truncate } from "./helpers.js";
+import { countLines, offloadLargeResult } from "../../../sdk/coding-agent/core/tools/offload.js";
+import { errorResult, textResult } from "./helpers.js";
+/**
+ * Offload one large text field via the shared offload module (shared
+ * thresholds, head+tail preview + footer, owner-only file permissions).
+ * `shown` is always counted from the actually displayed preview text.
+ */
+function tryOffloadSeoContent(content, toolName, sessionId) {
+    if (!content)
+        return { text: "" };
+    let offloaded;
+    try {
+        offloaded = offloadLargeResult(content, toolName, sessionId);
+    }
+    catch {
+        return { text: content };
+    }
+    if (!offloaded.fullOutputPath || !offloaded.truncation) {
+        return { text: content };
+    }
+    return {
+        text: offloaded.preview,
+        fullOutputPath: offloaded.fullOutputPath,
+        offloadTruncation: offloaded.truncation,
+        shownLines: countLines(offloaded.preview),
+        totalLines: countLines(content),
+    };
+}
 export function registerFetchTools(ext, config) {
     const fetchTool = {
         name: "seo_fetch",
@@ -24,7 +51,7 @@ export function registerFetchTools(ext, config) {
             },
             required: ["url"],
         },
-        async execute(_toolCallId, params) {
+        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
             const { url, userAgent, timeout, followRedirects } = params;
             try {
                 const result = await fetchPage(url, config, {
@@ -35,18 +62,26 @@ export function registerFetchTools(ext, config) {
                 if (result.error) {
                     return errorResult(`Fetch failed: ${result.error}`, { result });
                 }
+                const sessionId = ctx
+                    ?.sessionManager?.getSessionId?.() ?? "shared";
+                const offloaded = tryOffloadSeoContent(result.content, "seo_fetch", sessionId);
                 const summary = `✓ Fetched: ${result.finalUrl}\n` +
                     `Status: ${result.statusCode} ${result.statusText}\n` +
                     `Redirects: ${result.redirectChain.length}\n` +
                     `Content-Length: ${result.contentLengthBytes} bytes\n` +
-                    `Headers: ${Object.keys(result.headers).join(", ")}`;
+                    `Headers: ${Object.keys(result.headers).join(", ")}` +
+                    (offloaded.fullOutputPath ? `\nFull output: ${offloaded.fullOutputPath}` : "");
                 return textResult(summary, {
                     url: result.url,
                     finalUrl: result.finalUrl,
                     statusCode: result.statusCode,
-                    content: truncate(result.content, 50_000),
+                    content: offloaded.text,
                     headers: result.headers,
                     redirectChain: result.redirectChain,
+                    ...(offloaded.fullOutputPath ? { fullOutputPath: offloaded.fullOutputPath } : {}),
+                    ...(offloaded.offloadTruncation ? { offloadTruncation: offloaded.offloadTruncation } : {}),
+                    ...(offloaded.shownLines !== undefined ? { shownLines: offloaded.shownLines } : {}),
+                    ...(offloaded.totalLines !== undefined ? { totalLines: offloaded.totalLines } : {}),
                 });
             }
             catch (err) {
@@ -83,7 +118,7 @@ export function registerFetchTools(ext, config) {
             },
             required: ["url"],
         },
-        async execute(_toolCallId, params) {
+        async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
             const { url, viewport, captureA11y, captureConsole, timeout } = params;
             const available = await isRendererAvailable();
             if (!available) {
@@ -96,21 +131,37 @@ export function registerFetchTools(ext, config) {
                     captureConsole,
                     timeout,
                 });
+                const sessionId = ctx
+                    ?.sessionManager?.getSessionId?.() ?? "shared";
+                const contentOffload = tryOffloadSeoContent(result.content, "seo_render", sessionId);
+                const rawOffload = tryOffloadSeoContent(result.rawContent, "seo_render", sessionId);
+                const offloadNote = contentOffload.fullOutputPath || rawOffload.fullOutputPath
+                    ? `\nFull output: ${[contentOffload.fullOutputPath, rawOffload.fullOutputPath].filter(Boolean).join(", ")}`
+                    : "";
                 const summary = `✓ Rendered: ${result.finalUrl}\n` +
                     `Status: ${result.statusCode}\n` +
                     `SPA: ${result.isSpa}\n` +
                     `Render time: ${result.renderMs}ms\n` +
-                    `Console errors: ${result.consoleErrors.length}`;
+                    `Console errors: ${result.consoleErrors.length}` + offloadNote;
+                // Keep BOTH offload paths — content and rawContent are independent
+                // fields and each may need re-reading.
+                const fullOutputPaths = [contentOffload.fullOutputPath, rawOffload.fullOutputPath].filter((p) => Boolean(p));
                 return textResult(summary, {
                     url: result.url,
                     finalUrl: result.finalUrl,
                     statusCode: result.statusCode,
-                    content: truncate(result.content, 50_000),
-                    rawContent: truncate(result.rawContent, 20_000),
+                    content: contentOffload.text,
+                    rawContent: rawOffload.text,
                     isSpa: result.isSpa,
                     consoleErrors: result.consoleErrors,
                     renderMs: result.renderMs,
                     accessibilityTree: result.accessibilityTree,
+                    ...(fullOutputPaths.length > 0
+                        ? { fullOutputPath: fullOutputPaths[0], fullOutputPaths }
+                        : {}),
+                    ...(contentOffload.offloadTruncation
+                        ? { offloadTruncation: contentOffload.offloadTruncation }
+                        : {}),
                 });
             }
             catch (err) {

package/dist/extensions/web/tools/fetch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/web/tools/fetch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmB,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AA+BxG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CA2D5D"}
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../../../src/extensions/web/tools/fetch.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAmB,YAAY,EAAkB,MAAM,oCAAoC,CAAC;AAgCxG,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAwE5D"}

package/dist/extensions/web/tools/fetch.js

@@ -2,11 +2,9 @@
  * web_fetch tool definition.
  */
 import { Type } from "typebox";
-import { truncateTail } from "../../../sdk/coding-agent/core/tools/truncate.js";
+import { isAlreadyOffloaded, offloadLargeResult, } from "../../../sdk/coding-agent/core/tools/offload.js";
 import { fetchWebPage, WebFetchError } from "../utils/fetcher.js";
 import { convertContent } from "../utils/parser.js";
-const MAX_OUTPUT_LINES = 4000;
-const MAX_OUTPUT_BYTES = 200 * 1024; // 200 KB
 const webFetchSchema = Type.Object({
     url: Type.String({
         description: "The URL to fetch. Must begin with http:// or https://.",
@@ -32,7 +30,7 @@ export function registerWebFetchTool(ext) {
             "Supports HTTP/HTTPS only and rejects binary content.",
         promptSnippet: "`web_fetch { url, format?, timeout? }` — fetch a web page as markdown/text/HTML/JSON",
         parameters: webFetchSchema,
-        async execute(_toolCallId, params, signal, _onUpdate, _ctx) {
+        async execute(_toolCallId, params, signal, _onUpdate, ctx) {
             const { url, format = "markdown", timeout = 30 } = params;
             try {
                 const fetchResult = await fetchWebPage(url, {
@@ -40,19 +38,33 @@ export function registerWebFetchTool(ext) {
                     signal,
                 });
                 const converted = await convertContent(fetchResult.content, format);
-                const truncation = truncateTail(converted, {
-                    maxLines: MAX_OUTPUT_LINES,
-                    maxBytes: MAX_OUTPUT_BYTES,
-                });
-                const output = truncation.content;
-                const truncationNotice = truncation.truncated
-                    ? `\n\n[Output truncated: exceeded ${truncation.truncatedBy === "bytes" ? `${MAX_OUTPUT_BYTES} bytes` : `${MAX_OUTPUT_LINES} lines`}. Original size: ${truncation.totalBytes} bytes, ${truncation.totalLines} lines.]`
-                    : "";
+                // Single truncation system: offloadLargeResult decides by its own
+                // byte/line thresholds and builds the head+tail preview + footer.
+                // The full content is passed directly — no pre-truncation here.
+                let fullOutputPath;
+                let output = converted;
+                let offloadTruncation;
+                if (!isAlreadyOffloaded(converted)) {
+                    try {
+                        const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "shared";
+                        const offloaded = offloadLargeResult(converted, "web_fetch", sessionId);
+                        output = offloaded.preview;
+                        if (offloaded.fullOutputPath) {
+                            fullOutputPath = offloaded.fullOutputPath;
+                            offloadTruncation = offloaded.truncation ?? undefined;
+                        }
+                    }
+                    catch {
+                        // Best-effort — serve the full content when offload fails.
+                        output = converted;
+                    }
+                }
+                const truncated = fullOutputPath !== undefined;
                 return {
                     content: [
                         {
                             type: "text",
-                            text: `✓ Fetched ${fetchResult.finalUrl}\nContent-Type: ${fetchResult.contentType || "unknown"}\nFormat: ${format}\nSize: ${fetchResult.contentLengthBytes} bytes${truncationNotice}\n\n${output}`,
+                            text: `✓ Fetched ${fetchResult.finalUrl}\nContent-Type: ${fetchResult.contentType || "unknown"}\nFormat: ${format}\nSize: ${fetchResult.contentLengthBytes} bytes\n\n${output}`,
                         },
                     ],
                     details: {
@@ -61,8 +73,9 @@ export function registerWebFetchTool(ext) {
                         contentType: fetchResult.contentType,
                         format,
                         output,
-                        truncated: truncation.truncated,
-                        truncatedBy: truncation.truncatedBy,
+                        truncated,
+                        ...(fullOutputPath ? { fullOutputPath } : {}),
+                        ...(offloadTruncation ? { offloadTruncation } : {}),
                     },
                 };
             }

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/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":"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;AAG3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,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;AAiBD,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,qEAAqE;IACrE,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC;;;;;;;;;;;OAWG;IACH,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACtE;AAqkBD,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;;;;;;;;OAQG;IACH,OAAO,CAAC,eAAe,CAAK;IAC5B,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;IAC5D;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB,CAO5B;gBAEQ,IAAI,EAAE,kBAAkB;IAIpC;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA0X5B,OAAO,CAAC,4BAA4B;IAQpC;;;;;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;IA6ElC;;;;;;;;;;;;;;;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,mDAAmD;IACnD,WAAW,IAAI,OAAO;IAItB,mEAAmE;IACnE,UAAU,IAAI,OAAO;IAIrB,2EAA2E;IAC3E,MAAM,IAAI,OAAO;IAIjB,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;;;;;;;;;;;;OAYG;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;IAM1B,2EAA2E;IAC3E,OAAO,CAAC,6BAA6B;IAUrC;;;;OAIG;IACH,OAAO,CAAC,8BAA8B;IAQtC,yEAAyE;IACzE,OAAO,CAAC,iCAAiC;IAOzC,OAAO,CAAC,iBAAiB;IAazB;;;;;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;;;;;;;;OAQG;IACH,OAAO,CAAC,6BAA6B;IAiCrC;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAiB7B,uEAAuE;IACvE,OAAO,CAAC,wBAAwB;IAMhC;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,sBAAsB;IAwD9B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,EAAE,iBAAiB,GAAG,IAAI;CAskBzC"}

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"}

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/package.json

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