kagent-ts 0.1.3 → 0.1.5

package/dist/tools/error-tracker.js

@@ -1,51 +1,7 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ToolErrorTracker = void 0;
 exports.categorizeError = categorizeError;
-/**
- * ToolErrorTracker — records the complete lifecycle of tool failures
- * and persists them as structured documents for developer review.
- *
- * Each "trace" captures one error chain: first failure → retries →
- * LLM analysis → resolution or circuit-open. Traces are stored as
- * individual JSON files in a designated directory (.error-traces/)
- * so developers can inspect, aggregate, and learn from them.
- */
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
 /**
  * Generates a short unique trace ID.
  */
@@ -85,7 +41,7 @@ function sanitizeArgs(args) {
     return sanitized;
 }
 /**
- * Limit error message length to avoid huge trace files.
+ * Limit error message length to avoid huge trace objects.
  */
 function truncateError(error, maxLen = 500) {
     if (error.length <= maxLen)
@@ -125,12 +81,13 @@ function categorizeError(error) {
     return "unknown";
 }
 /**
- * ToolErrorTracker records the complete lifecycle of tool failures.
+ * ToolErrorTracker records the lifecycle of tool failures in memory
+ * for the duration of a session.
  *
  * Usage:
  * ```ts
- * const tracker = new ToolErrorTracker({ storageDir: ".error-traces" });
- * const registry = new ToolRegistry({ errorTracker: tracker });
+ * const tracker = new ToolErrorTracker();
+ * const registry = new ToolRegistry(2, tracker);
  * ```
  *
  * Lifecycle of a trace:
@@ -140,18 +97,12 @@ function categorizeError(error) {
  * 4. Recovery       → `recordRecovery()` marks the trace as resolved
  * 5. Circuit open   → `recordFailure()` marks the trace as unresolved
  *
- * All traces are persisted as individual JSON files in the storage
- * directory, plus an index file for quick browsing.
+ * For cross-session persistence and LLM-powered error diagnosis,
+ * use {@link import('../reflection/error-notebook').ErrorNotebook}.
  */
 class ToolErrorTracker {
     traces = new Map();
     activeTraceByTool = new Map();
-    storageDir;
-    persistImmediately;
-    constructor(config) {
-        this.storageDir = config?.storageDir ?? ".error-traces";
-        this.persistImmediately = config?.persistImmediately ?? true;
-    }
     // ─── Event Recording ────────────────────────────────────────────────────
     /**
      * Record a tool execution failure.
@@ -163,17 +114,15 @@ class ToolErrorTracker {
      *
      * @returns The trace ID for the chain this failure belongs to.
      */
-    recordFailure(toolName, args, error, retriesRemaining) {
+    recordFailure(toolName, args, error, retriesRemaining, breakerState) {
         const existingTraceId = this.activeTraceByTool.get(toolName);
         let trace;
         if (existingTraceId) {
-            // Append to existing trace
             const existing = this.traces.get(existingTraceId);
             if (existing && !existing.resolved) {
                 trace = existing;
             }
             else {
-                // Existing trace is resolved/closed — start a new one
                 trace = this.createTrace(toolName, args);
             }
         }
@@ -181,8 +130,13 @@ class ToolErrorTracker {
             trace = this.createTrace(toolName, args);
         }
         const attemptNumber = trace.events.filter((e) => e.type === "failure" || e.type === "retry").length + 1;
+        const eventType = retriesRemaining > 0
+            ? "failure"
+            : breakerState === "half_open"
+                ? "circuit_half_open"
+                : "circuit_open";
         const event = {
-            type: retriesRemaining > 0 ? "failure" : "circuit_open",
+            type: eventType,
             timestamp: nowISO(),
             error: truncateError(error),
             attemptNumber,
@@ -191,21 +145,18 @@ class ToolErrorTracker {
         };
         trace.events.push(event);
         trace.updatedAt = nowISO();
-        if (retriesRemaining === 0) {
-            // Circuit just opened — trace is done, unresolved
+        // Only close the trace when the circuit is fully OPEN, not when
+        // retriesRemaining === 0 but the breaker is still HALF_OPEN (recovery
+        // is still possible in that state).
+        if (breakerState === "open") {
             trace.resolved = false;
             this.activeTraceByTool.delete(toolName);
         }
         this.traces.set(trace.traceId, trace);
-        this.persistTrace(trace.traceId);
         return trace.traceId;
     }
     /**
      * Record a tool recovery (successful execution after previous failures).
-     *
-     * @param toolName The tool that recovered.
-     * @param traceId  The trace ID for this failure chain.
-     * @param resolution Optional description of how it was resolved.
      */
     recordRecovery(toolName, traceId, resolution) {
         const trace = this.traces.get(traceId);
@@ -223,12 +174,9 @@ class ToolErrorTracker {
         trace.updatedAt = nowISO();
         this.traces.set(traceId, trace);
         this.activeTraceByTool.delete(toolName);
-        this.persistTrace(traceId);
     }
     /**
      * Attach LLM analysis to the latest failure/retry event in a trace.
-     *
-     * Called by the agent after the LLM has reasoned about a tool error.
      */
     recordAnalysis(traceId, analysis) {
         const trace = this.traces.get(traceId);
@@ -251,7 +199,6 @@ class ToolErrorTracker {
         trace.events.push(analysisEvent);
         trace.updatedAt = nowISO();
         this.traces.set(traceId, trace);
-        this.persistTrace(traceId);
     }
     // ─── Query ───────────────────────────────────────────────────────────────
     /**
@@ -288,51 +235,27 @@ class ToolErrorTracker {
         return this.activeTraceByTool.get(toolName);
     }
     /**
-     * Get the total number of traces recorded.
-     */
-    get traceCount() {
-        return this.traces.size;
-    }
-    // ─── Persistence ─────────────────────────────────────────────────────────
-    /**
-     * Persist all traces to disk immediately.
+     * Get all currently active (unresolved) traces.
      */
-    persistAll() {
-        this.ensureStorageDir();
-        for (const traceId of this.traces.keys()) {
-            this.writeTraceFile(traceId);
+    getActiveTraces() {
+        const result = [];
+        for (const [toolName, traceId] of this.activeTraceByTool) {
+            const trace = this.traces.get(traceId);
+            if (trace && !trace.resolved) {
+                result.push({ toolName, traceId });
+            }
         }
-        this.writeIndexFile();
+        return result;
     }
     /**
-     * Load traces from disk (e.g., on startup to resume monitoring).
+     * Get the total number of traces recorded in this session.
      */
-    loadFromDisk() {
-        this.ensureStorageDir();
-        const dir = this.storageDir;
-        if (!fs.existsSync(dir))
-            return;
-        const files = fs.readdirSync(dir);
-        for (const file of files) {
-            if (!file.startsWith("trace_") || !file.endsWith(".json"))
-                continue;
-            if (file === "traces.json")
-                continue; // skip index
-            try {
-                const content = fs.readFileSync(path.join(dir, file), "utf-8");
-                const trace = JSON.parse(content);
-                this.traces.set(trace.traceId, trace);
-                if (!trace.resolved) {
-                    this.activeTraceByTool.set(trace.toolName, trace.traceId);
-                }
-            }
-            catch {
-                // Skip corrupted files
-            }
-        }
+    get traceCount() {
+        return this.traces.size;
     }
+    // ─── Report ──────────────────────────────────────────────────────────────
     /**
-     * Generate a human-readable markdown report of all traces.
+     * Generate an in-memory markdown report of all traces for the current session.
      */
     generateMarkdownReport() {
         const summaries = this.getAllSummaries();
@@ -356,7 +279,6 @@ class ToolErrorTracker {
             report += `- **Created:** ${summary.createdAt}\n`;
             report += `- **Status:** ${summary.resolved ? "✅ Resolved" : "❌ Unresolved"}\n`;
             report += `- **Attempts:** ${summary.errorCount}\n\n`;
-            // Events table
             report += `| # | Type | Timestamp | Error / Analysis |\n`;
             report += `|---|------|-----------|------------------|\n`;
             let eventNum = 0;
@@ -374,6 +296,9 @@ class ToolErrorTracker {
                 else if (event.type === "recovery") {
                     detail = event.resolution ?? "Recovered";
                 }
+                else if (event.type === "circuit_half_open") {
+                    detail = `Circuit degraded (half-open) after ${event.attemptNumber} attempt(s) — next failure will open the circuit`;
+                }
                 else if (event.type === "circuit_open") {
                     detail = `Circuit opened after ${event.attemptNumber} attempts`;
                 }
@@ -387,25 +312,11 @@ class ToolErrorTracker {
         return report;
     }
     /**
-     * Delete all stored traces.
+     * Clear all in-memory traces.
      */
-    clearAll() {
+    clear() {
         this.traces.clear();
         this.activeTraceByTool.clear();
-        const dir = this.storageDir;
-        if (fs.existsSync(dir)) {
-            const files = fs.readdirSync(dir);
-            for (const file of files) {
-                if (file.endsWith(".json")) {
-                    try {
-                        fs.unlinkSync(path.join(dir, file));
-                    }
-                    catch {
-                        // ignore
-                    }
-                }
-            }
-        }
     }
     // ─── Private Helpers ─────────────────────────────────────────────────────
     createTrace(toolName, args) {
@@ -424,36 +335,6 @@ class ToolErrorTracker {
         this.activeTraceByTool.set(toolName, traceId);
         return trace;
     }
-    persistTrace(traceId) {
-        if (!this.persistImmediately)
-            return;
-        this.ensureStorageDir();
-        this.writeTraceFile(traceId);
-        this.writeIndexFile();
-    }
-    ensureStorageDir() {
-        if (!fs.existsSync(this.storageDir)) {
-            fs.mkdirSync(this.storageDir, { recursive: true });
-        }
-    }
-    writeTraceFile(traceId) {
-        const trace = this.traces.get(traceId);
-        if (!trace)
-            return;
-        const filePath = path.join(this.storageDir, `${traceId}.json`);
-        fs.writeFileSync(filePath, JSON.stringify(trace, null, 2), "utf-8");
-    }
-    writeIndexFile() {
-        const summaries = this.getAllSummaries();
-        const filePath = path.join(this.storageDir, "traces.json");
-        fs.writeFileSync(filePath, JSON.stringify({
-            totalTraces: summaries.length,
-            resolvedCount: summaries.filter((s) => s.resolved).length,
-            openCount: summaries.filter((s) => !s.resolved).length,
-            updatedAt: nowISO(),
-            traces: summaries,
-        }, null, 2), "utf-8");
-    }
     formatEventType(type) {
         switch (type) {
             case "failure":
@@ -462,6 +343,8 @@ class ToolErrorTracker {
                 return "🟡 Retry";
             case "recovery":
                 return "🟢 Recovery";
+            case "circuit_half_open":
+                return "⚠️ Circuit Half-Open";
             case "circuit_open":
                 return "⛔ Circuit Open";
             case "analysis":

package/dist/tools/error-tracker.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-tracker.js","sourceRoot":"","sources":["../../src/tools/error-tracker.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error-tracker.js","sourceRoot":"","sources":["../../src/tools/error-tracker.ts"],"names":[],"mappings":"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"}

package/dist/tools/tool-filter.d.ts

@@ -0,0 +1,70 @@
+import { Tool } from "./types";
+/**
+ * A tool filter decides whether a given tool should be included.
+ *
+ * Pass a filter to a sub-agent definition so you can restrict which
+ * tools the sub-agent can access without editing the main agent's
+ * ToolRegistry.
+ *
+ * Built-in factories (`allowlist`, `denylist`, `pattern`) cover common
+ * cases; implement this interface directly for custom logic.
+ */
+export interface ToolFilter {
+    /** Human-readable name shown in debug/log output. */
+    readonly name: string;
+    /** Return `true` to include the tool, `false` to exclude. */
+    filter(tool: Tool): boolean;
+}
+/**
+ * Only allow tools whose name is in the provided list.
+ *
+ * @example
+ * ```ts
+ * const filter = allowlist(["read_file", "grep", "glob"]);
+ * ```
+ */
+export declare function allowlist(...names: string[]): ToolFilter;
+/**
+ * Allow all tools EXCEPT those whose name is in the provided list.
+ * Useful for removing dangerous or unnecessary tools from sub-agents.
+ *
+ * @example
+ * ```ts
+ * const filter = denylist("spawn_subagent", "list_subagents");
+ * ```
+ */
+export declare function denylist(...names: string[]): ToolFilter;
+/**
+ * Include only tools whose name matches a regex pattern.
+ *
+ * @example
+ * ```ts
+ * const filter = pattern(/^(read|write|edit)_/);  // file-system tools only
+ * ```
+ */
+export declare function pattern(regex: RegExp): ToolFilter;
+/**
+ * Combine multiple filters with AND logic — a tool must pass ALL filters.
+ *
+ * @example
+ * ```ts
+ * // Allow file tools, but exclude write
+ * const filter = all(pattern(/^(read|write|edit)_/), denylist("write_file"));
+ * ```
+ */
+export declare function all(...filters: ToolFilter[]): ToolFilter;
+/**
+ * Combine multiple filters with OR logic — a tool must pass AT LEAST ONE filter.
+ *
+ * @example
+ * ```ts
+ * // Allow read_file or exact grep match
+ * const filter = any(allowlist("read_file"), allowlist("grep"));
+ * ```
+ */
+export declare function any(...filters: ToolFilter[]): ToolFilter;
+/**
+ * Apply a filter to a tool array and return the filtered subset.
+ */
+export declare function filterTools(tools: Tool[], filter: ToolFilter): Tool[];
+//# sourceMappingURL=tool-filter.d.ts.map

package/dist/tools/tool-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-filter.d.ts","sourceRoot":"","sources":["../../src/tools/tool-filter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAI/B;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC;CAC7B;AAID;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAMxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,UAAU,CAMvD;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAKjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAKxD;AAED;;;;;;;;GAQG;AACH,wBAAgB,GAAG,CAAC,GAAG,OAAO,EAAE,UAAU,EAAE,GAAG,UAAU,CAKxD;AAID;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,CAErE"}

package/dist/tools/tool-filter.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allowlist = allowlist;
+exports.denylist = denylist;
+exports.pattern = pattern;
+exports.all = all;
+exports.any = any;
+exports.filterTools = filterTools;
+// ─── Built-in Filters ────────────────────────────────────────────────────────
+/**
+ * Only allow tools whose name is in the provided list.
+ *
+ * @example
+ * ```ts
+ * const filter = allowlist(["read_file", "grep", "glob"]);
+ * ```
+ */
+function allowlist(...names) {
+    const set = new Set(names);
+    return {
+        name: `allowlist(${names.join(", ")})`,
+        filter: (tool) => set.has(tool.name),
+    };
+}
+/**
+ * Allow all tools EXCEPT those whose name is in the provided list.
+ * Useful for removing dangerous or unnecessary tools from sub-agents.
+ *
+ * @example
+ * ```ts
+ * const filter = denylist("spawn_subagent", "list_subagents");
+ * ```
+ */
+function denylist(...names) {
+    const set = new Set(names);
+    return {
+        name: `denylist(${names.join(", ")})`,
+        filter: (tool) => !set.has(tool.name),
+    };
+}
+/**
+ * Include only tools whose name matches a regex pattern.
+ *
+ * @example
+ * ```ts
+ * const filter = pattern(/^(read|write|edit)_/);  // file-system tools only
+ * ```
+ */
+function pattern(regex) {
+    return {
+        name: `pattern(/${regex.source}/${regex.flags})`,
+        filter: (tool) => regex.test(tool.name),
+    };
+}
+/**
+ * Combine multiple filters with AND logic — a tool must pass ALL filters.
+ *
+ * @example
+ * ```ts
+ * // Allow file tools, but exclude write
+ * const filter = all(pattern(/^(read|write|edit)_/), denylist("write_file"));
+ * ```
+ */
+function all(...filters) {
+    return {
+        name: `all(${filters.map((f) => f.name).join(", ")})`,
+        filter: (tool) => filters.every((f) => f.filter(tool)),
+    };
+}
+/**
+ * Combine multiple filters with OR logic — a tool must pass AT LEAST ONE filter.
+ *
+ * @example
+ * ```ts
+ * // Allow read_file or exact grep match
+ * const filter = any(allowlist("read_file"), allowlist("grep"));
+ * ```
+ */
+function any(...filters) {
+    return {
+        name: `any(${filters.map((f) => f.name).join(", ")})`,
+        filter: (tool) => filters.some((f) => f.filter(tool)),
+    };
+}
+// ─── Helper ──────────────────────────────────────────────────────────────────
+/**
+ * Apply a filter to a tool array and return the filtered subset.
+ */
+function filterTools(tools, filter) {
+    return tools.filter((t) => filter.filter(t));
+}
+//# sourceMappingURL=tool-filter.js.map

package/dist/tools/tool-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-filter.js","sourceRoot":"","sources":["../../src/tools/tool-filter.ts"],"names":[],"mappings":";;AAgCA,8BAMC;AAWD,4BAMC;AAUD,0BAKC;AAWD,kBAKC;AAWD,kBAKC;AAOD,kCAEC;AAzFD,gFAAgF;AAEhF;;;;;;;GAOG;AACH,SAAgB,SAAS,CAAC,GAAG,KAAe;IAC1C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO;QACL,IAAI,EAAE,aAAa,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACtC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;KACrC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,QAAQ,CAAC,GAAG,KAAe;IACzC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO;QACL,IAAI,EAAE,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;KACtC,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,OAAO,CAAC,KAAa;IACnC,OAAO;QACL,IAAI,EAAE,YAAY,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,KAAK,GAAG;QAChD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,GAAG,CAAC,GAAG,OAAqB;IAC1C,OAAO;QACL,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,SAAgB,GAAG,CAAC,GAAG,OAAqB;IAC1C,OAAO;QACL,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACrD,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;KACtD,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF;;GAEG;AACH,SAAgB,WAAW,CAAC,KAAa,EAAE,MAAkB;IAC3D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/C,CAAC"}

package/dist/tools/tool-output-truncator.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Truncator for tool outputs that exceed a byte threshold.
+ *
+ * When a tool returns a very large result it fills the context window
+ * and wastes tokens. This component saves the full result to disk and
+ * returns a short preview + a file path, so the LLM can decide whether
+ * to read the full content via the normal file-reading tools.
+ */
+export declare class ToolOutputTruncator {
+    private maxBytes;
+    private keepBytes;
+    private outputDir;
+    /**
+     * @param maxBytes   Outputs larger than this are truncated (0 = off).
+     * @param keepBytes  How many bytes to keep from the start of the output
+     *                   when truncating.
+     * @param outputDir  Directory where full outputs are saved.
+     */
+    constructor(maxBytes?: number, keepBytes?: number, outputDir?: string);
+    /**
+     * Whether truncation is active (maxBytes > 0).
+     */
+    get enabled(): boolean;
+    /**
+     * Truncate a tool result string if it exceeds the configured threshold.
+     *
+     * - If the result is within `maxBytes`, returns it unchanged.
+     * - Otherwise saves the full output to disk and returns the first
+     *   `keepBytes` bytes + a marker pointing to the saved file.
+     *
+     * @param toolName  Name of the tool that produced this result.
+     * @param result    The raw result string from tool execution.
+     */
+    truncate(toolName: string, result: string): string;
+}
+//# sourceMappingURL=tool-output-truncator.d.ts.map

package/dist/tools/tool-output-truncator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-output-truncator.d.ts","sourceRoot":"","sources":["../../src/tools/tool-output-truncator.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAS;IAE1B;;;;;OAKG;gBAED,QAAQ,GAAE,MAAU,EACpB,SAAS,GAAE,MAAa,EACxB,SAAS,CAAC,EAAE,MAAM;IAOpB;;OAEG;IACH,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;;;;;;OASG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;CA6BnD"}