kagent-ts 0.1.3 → 0.1.5

package/dist/tools/builtin/remember.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remember.js","sourceRoot":"","sources":["../../../src/tools/builtin/remember.ts"],"names":[],"mappings":";;AAYA,gDAiEC;AAzED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,aAA4B;IAC7D,OAAO;QACL,IAAI,EAAE,UAAU;QAChB,WAAW,EACT,yEAAyE;YACzE,wEAAwE;YACxE,0EAA0E;YAC1E,mDAAmD;QACrD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,qDAAqD;wBACrD,oEAAoE;iBACvE;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC;oBACzB,WAAW,EACT,uDAAuD;wBACvD,oEAAoE;iBACvE;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,8DAA8D;wBAC9D,6CAA6C;iBAChD;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,sEAAsE;wBACtE,sEAAsE;wBACtE,uEAAuE;wBACvE,0CAA0C;iBAC7C;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC;SACrD;QAED,KAAK,CAAC,OAAO,CAAC,MAA+B;YAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC9C,MAAM,OAAO,GAAI,MAAM,CAAC,IAAe,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5D,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAEpD,IAAI,CAAC,IAAI;gBAAE,OAAO,8CAA8C,CAAC;YACjE,IAAI,CAAC,WAAW;gBAAE,OAAO,sDAAsD,CAAC;YAChF,IAAI,CAAC,OAAO;gBAAE,OAAO,+CAA+C,CAAC;YACrE,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3C,OAAO,0EAA0E,IAAI,IAAI,CAAC;YAC5F,CAAC;YAED,8DAA8D;YAC9D,4DAA4D;YAC5D,MAAM,QAAQ,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACzC,aAAa,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAqB,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;YAE/E,OAAO,QAAQ;gBACb,CAAC,CAAC,WAAW,IAAI,yBAAyB;gBAC1C,CAAC,CAAC,WAAW,IAAI,gCAAgC,aAAa,CAAC,KAAK,YAAY,CAAC;QACrF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/skill.d.ts

@@ -0,0 +1,14 @@
+import { Tool } from "../types";
+import type { SkillManager } from "../../skills/skill-manager";
+/**
+ * Create a Skill tool that allows the LLM to activate / deactivate skills
+ * on demand during the agent loop.
+ *
+ * Factory pattern matching `createListSubagentsTool` / `createSpawnSubagentTool`.
+ *
+ * @param skillManager  The agent's SkillManager for skill state management.
+ * @param onSkillChanged  Callback invoked after a skill is activated or
+ *                        deactivated so the agent can rebuild its system prompt.
+ */
+export declare function createSkillTool(skillManager: SkillManager, onSkillChanged: () => void): Tool;
+//# sourceMappingURL=skill.d.ts.map

package/dist/tools/builtin/skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,MAAM,IAAI,GACzB,IAAI,CA8DN"}

package/dist/tools/builtin/skill.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSkillTool = createSkillTool;
+/**
+ * Create a Skill tool that allows the LLM to activate / deactivate skills
+ * on demand during the agent loop.
+ *
+ * Factory pattern matching `createListSubagentsTool` / `createSpawnSubagentTool`.
+ *
+ * @param skillManager  The agent's SkillManager for skill state management.
+ * @param onSkillChanged  Callback invoked after a skill is activated or
+ *                        deactivated so the agent can rebuild its system prompt.
+ */
+function createSkillTool(skillManager, onSkillChanged) {
+    return {
+        name: "skill",
+        description: "Activate or deactivate a skill. Skills provide specialized domain " +
+            "knowledge and capabilities. Use this tool when a task requires " +
+            "expertise in a specific domain. Call with action 'activate' to load " +
+            "a skill (the default), or 'deactivate' to unload it.",
+        parameters: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The name of the skill to activate or deactivate.",
+                },
+                action: {
+                    type: "string",
+                    enum: ["activate", "deactivate"],
+                    description: "Whether to activate (load) or deactivate (unload) the skill. Default: 'activate'.",
+                },
+            },
+            required: ["name"],
+        },
+        async execute(params) {
+            const skillName = String(params.name ?? "");
+            const action = params.action || "activate";
+            if (!skillManager.has(skillName)) {
+                const available = skillManager
+                    .getAll()
+                    .map((s) => s.name)
+                    .join(", ");
+                return `Unknown skill: "${skillName}". Available skills: ${available || "none"}.`;
+            }
+            if (action === "deactivate") {
+                const wasActive = skillManager.deactivate(skillName);
+                if (wasActive) {
+                    onSkillChanged();
+                    return `Skill "${skillName}" deactivated.`;
+                }
+                return `Skill "${skillName}" is not currently active.`;
+            }
+            // activate (default)
+            if (skillManager.isActive(skillName)) {
+                return `Skill "${skillName}" is already active.`;
+            }
+            try {
+                skillManager.activate(skillName);
+                onSkillChanged();
+                const skill = skillManager.get(skillName);
+                return `Skill "${skillName}" activated successfully: ${skill?.description ?? ""}`;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return `Error activating skill "${skillName}": ${message}`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=skill.js.map

package/dist/tools/builtin/skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill.js","sourceRoot":"","sources":["../../../src/tools/builtin/skill.ts"],"names":[],"mappings":";;AAaA,0CAiEC;AA3ED;;;;;;;;;GASG;AACH,SAAgB,eAAe,CAC7B,YAA0B,EAC1B,cAA0B;IAE1B,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EACT,oEAAoE;YACpE,iEAAiE;YACjE,sEAAsE;YACtE,sDAAsD;QACxD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,CAAC,UAAU,EAAE,YAAY,CAAC;oBAChC,WAAW,EACT,mFAAmF;iBACtF;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QAED,KAAK,CAAC,OAAO,CAAC,MAA+B;YAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAI,MAAM,CAAC,MAAiB,IAAI,UAAU,CAAC;YAEvD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACjC,MAAM,SAAS,GAAG,YAAY;qBAC3B,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,mBAAmB,SAAS,wBAAwB,SAAS,IAAI,MAAM,GAAG,CAAC;YACpF,CAAC;YAED,IAAI,MAAM,KAAK,YAAY,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;gBACrD,IAAI,SAAS,EAAE,CAAC;oBACd,cAAc,EAAE,CAAC;oBACjB,OAAO,UAAU,SAAS,gBAAgB,CAAC;gBAC7C,CAAC;gBACD,OAAO,UAAU,SAAS,4BAA4B,CAAC;YACzD,CAAC;YAED,qBAAqB;YACrB,IAAI,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;gBACrC,OAAO,UAAU,SAAS,sBAAsB,CAAC;YACnD,CAAC;YAED,IAAI,CAAC;gBACH,YAAY,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACjC,cAAc,EAAE,CAAC;gBACjB,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC1C,OAAO,UAAU,SAAS,6BAA6B,KAAK,EAAE,WAAW,IAAI,EAAE,EAAE,CAAC;YACpF,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,2BAA2B,SAAS,MAAM,OAAO,EAAE,CAAC;YAC7D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/spawn-subagent.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from "../types";
+import type { SubAgentManager } from "../../subagent/subagent-manager";
+/**
+ * Factory: create a `spawn_subagent` tool bound to a SubAgentManager instance.
+ */
+export declare function createSpawnSubagentTool(manager: SubAgentManager): Tool;
+//# sourceMappingURL=spawn-subagent.d.ts.map

package/dist/tools/builtin/spawn-subagent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-subagent.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/spawn-subagent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAsCtE"}

package/dist/tools/builtin/spawn-subagent.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSpawnSubagentTool = createSpawnSubagentTool;
+/**
+ * Factory: create a `spawn_subagent` tool bound to a SubAgentManager instance.
+ */
+function createSpawnSubagentTool(manager) {
+    return {
+        name: "spawn_subagent",
+        description: "Spawn an asynchronous sub-agent to handle a task. " +
+            "The sub-agent runs in the background; its result will appear " +
+            "as a new user message enclosed in <subagent-result> tags once it completes. " +
+            "Call list_subagents first to see available sub-agents and pick the right one.",
+        parameters: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Name of the sub-agent to spawn. Call list_subagents first to see available names.",
+                },
+                input: {
+                    type: "string",
+                    description: "Task description / instructions for the sub-agent.",
+                },
+            },
+            required: ["name", "input"],
+        },
+        async execute(params) {
+            const name = String(params.name ?? "");
+            const input = String(params.input ?? "");
+            try {
+                const runId = manager.spawn(name, input);
+                return (`Sub-agent "${name}" spawned successfully. Run ID: ${runId}. ` +
+                    `It will report back when finished.`);
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                return `Error spawning sub-agent "${name}": ${message}`;
+            }
+        },
+    };
+}
+//# sourceMappingURL=spawn-subagent.js.map

package/dist/tools/builtin/spawn-subagent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-subagent.js","sourceRoot":"","sources":["../../../src/tools/builtin/spawn-subagent.ts"],"names":[],"mappings":";;AAMA,0DAsCC;AAzCD;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAAwB;IAC9D,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,oDAAoD;YACpD,+DAA+D;YAC/D,8EAA8E;YAC9E,+EAA+E;QACjF,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,mFAAmF;iBACjG;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,oDAAoD;iBAClE;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;SAC5B;QAED,KAAK,CAAC,OAAO,CAAC,MAA+B;YAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACzC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBACzC,OAAO,CACL,cAAc,IAAI,mCAAmC,KAAK,IAAI;oBAC9D,oCAAoC,CACrC,CAAC;YACJ,CAAC;YAAC,OAAO,GAAY,EAAE,CAAC;gBACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjE,OAAO,6BAA6B,IAAI,MAAM,OAAO,EAAE,CAAC;YAC1D,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/web-fetch.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from "../types";
+export declare const WebFetchTool: Tool;
+//# sourceMappingURL=web-fetch.d.ts.map

package/dist/tools/builtin/web-fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/web-fetch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAyBhC,eAAO,MAAM,YAAY,EAAE,IAwF1B,CAAC"}

package/dist/tools/builtin/web-fetch.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebFetchTool = void 0;
+const boundaries_1 = require("../../security/boundaries");
+const MAX_CHARS = 100_000;
+const TIMEOUT_MS = 15_000;
+/**
+ * Strip HTML tags from text (simple regex-based approach — sufficient for
+ * extracting readable content from most pages).
+ */
+function stripHtml(html) {
+    return html
+        .replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "")
+        .replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&amp;/g, "&")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">")
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, " ")
+        .replace(/\n\s*\n\s*\n/g, "\n\n")
+        .slice(0, MAX_CHARS);
+}
+exports.WebFetchTool = {
+    name: "web_fetch",
+    description: "Fetch a web page by URL and return its content as markdown-formatted text. " +
+        "Use this to retrieve documentation, API responses, or any web resource. " +
+        "The content is stripped of HTML tags and limited to 100,000 characters. " +
+        "This is a read-only operation — no files or system state are modified.",
+    parameters: {
+        type: "object",
+        properties: {
+            url: {
+                type: "string",
+                description: "The full URL to fetch (must start with http:// or https://).",
+            },
+            maxChars: {
+                type: "number",
+                description: "Maximum characters to return (default: 100,000).",
+            },
+        },
+        required: ["url"],
+    },
+    async execute(args) {
+        const url = String(args.url ?? "");
+        const maxChars = typeof args.maxChars === "number" ? Math.min(args.maxChars, MAX_CHARS) : MAX_CHARS;
+        // Validate URL
+        let parsedUrl;
+        try {
+            parsedUrl = new URL(url);
+        }
+        catch {
+            return `Error: Invalid URL "${url}". Make sure the URL starts with http:// or https://.`;
+        }
+        if (!["http:", "https:"].includes(parsedUrl.protocol)) {
+            return `Error: Unsupported protocol "${parsedUrl.protocol}". Only HTTP and HTTPS are supported.`;
+        }
+        // Fetch with timeout
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const response = await fetch(url, {
+                headers: {
+                    "User-Agent": "kagent-ts/1.0 (web_fetch tool)",
+                    Accept: "text/html, application/xhtml+xml, text/plain",
+                },
+                signal: controller.signal,
+                redirect: "follow",
+            });
+            clearTimeout(timeout);
+            if (!response.ok) {
+                return `Error: HTTP ${response.status} ${response.statusText} when fetching "${url}".`;
+            }
+            const contentType = response.headers.get("content-type") ?? "";
+            const raw = await response.text();
+            // Extract title
+            const titleMatch = raw.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+            const title = titleMatch ? titleMatch[1].trim() : parsedUrl.hostname;
+            // Strip HTML to get readable text
+            const text = stripHtml(raw);
+            const content = text.length > maxChars
+                ? text.slice(0, maxChars) + `\n\n(Truncated — ${(text.length / 1024).toFixed(1)} KB total, showing first ${(maxChars / 1024).toFixed(1)} KB)`
+                : text;
+            const contentTypeNote = contentType.includes("text/html") ? "" : `\nContent-Type: ${contentType}`;
+            // Scan for prompt-injection signatures in the fetched content
+            const injectionPatterns = (0, boundaries_1.detectInjectionSignatures)(content);
+            const warning = (0, boundaries_1.buildInjectionWarning)(injectionPatterns, `web_fetch:${url}`);
+            return `${warning}# ${title}\n\nURL: ${url}${contentTypeNote}\n\n${content}`;
+        }
+        catch (err) {
+            clearTimeout(timeout);
+            const message = err instanceof Error ? err.message : String(err);
+            if (err instanceof DOMException || (err instanceof Error && err.name === "AbortError")) {
+                return `Error: Request timed out after ${TIMEOUT_MS / 1000}s for URL "${url}".`;
+            }
+            return `Error fetching "${url}": ${message}`;
+        }
+    },
+};
+//# sourceMappingURL=web-fetch.js.map

package/dist/tools/builtin/web-fetch.js.map

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

package/dist/tools/builtin/write-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/write-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,IAgD3B,CAAC"}
+{"version":3,"file":"write-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/write-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,IAiD3B,CAAC"}

package/dist/tools/builtin/write-file.js

@@ -85,5 +85,6 @@ exports.WriteFileTool = {
             return `Error writing file "${resolvedPath}": ${message}`;
         }
     },
+    requireApproval: true,
 };
 //# sourceMappingURL=write-file.js.map

package/dist/tools/builtin/write-file.js.map

@@ -1 +1 @@
-{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/builtin/write-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAG7B;;;;;;GAMG;AACU,QAAA,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,iEAAiE;QACjE,6EAA6E;IAC/E,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAmB,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QAEvC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,gDAAgD,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,+BAA+B,CAAC;QACzC,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvC,aAAa;YACb,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;YAEzD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACvC,OAAO,sBAAsB,IAAI,CAAC,IAAI,aAAa,YAAY,EAAE,CAAC;QACpE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,uBAAuB,YAAY,MAAM,OAAO,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;CACF,CAAC"}
+{"version":3,"file":"write-file.js","sourceRoot":"","sources":["../../../src/tools/builtin/write-file.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,2CAA6B;AAG7B;;;;;;GAMG;AACU,QAAA,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EACT,iEAAiE;QACjE,6EAA6E;IAC/E,UAAU,EAAE;QACV,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,SAAS,EAAE;gBACT,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,qCAAqC;aACnD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+BAA+B;aAC7C;SACF;QACD,QAAQ,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;KACnC;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAmB,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAiB,CAAC;QAEvC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,gDAAgD,CAAC;QAC1D,CAAC;QACD,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YAC9C,OAAO,+BAA+B,CAAC;QACzC,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAE5C,IAAI,CAAC;YACH,sCAAsC;YACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;YACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAEvC,aAAa;YACb,EAAE,CAAC,aAAa,CAAC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;YAEzD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;YACvC,OAAO,sBAAsB,IAAI,CAAC,IAAI,aAAa,YAAY,EAAE,CAAC;QACpE,CAAC;QAAC,OAAO,GAAY,EAAE,CAAC;YACtB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACjE,OAAO,uBAAuB,YAAY,MAAM,OAAO,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;IACD,eAAe,EAAE,IAAI;CACtB,CAAC"}

package/dist/tools/circuit-breaker.d.ts

@@ -16,15 +16,18 @@ export interface CircuitBreakerConfig {
  * Circuit breaker that tracks consecutive failures for a single tool.
  *
  * States:
- * - CLOSED: Normal operation — executions are allowed.
- * - OPEN:   All retries exhausted — subsequent calls are blocked
- *           without attempting execution.
+ * - CLOSED:    Normal operation — no failures, executions are allowed.
+ * - HALF_OPEN: Degraded operation — failures have occurred but retries
+ *              remain. Tool calls are still allowed, but the caller
+ *              should proceed with caution.
+ * - OPEN:      All retries exhausted — subsequent calls are blocked
+ *              without attempting execution.
  *
- * Flow:
- *   1st failure → 2 retries remaining → LLM should analyze the error and retry
- *   2nd failure → 1 retry remaining
+ * Flow (with retryCount = 2):
+ *   1st failure → HALF_OPEN, 1 retry remaining → LLM should analyze and retry
+ *   2nd failure → HALF_OPEN, 0 retries remaining → last chance
  *   3rd failure → circuit OPENS → LLM must try a different approach
- *   Success → failure count resets to zero
+ *   Success     → circuit returns to CLOSED, failure count resets
  */
 export declare class CircuitBreaker {
     private toolName;
@@ -33,7 +36,9 @@ export declare class CircuitBreaker {
     private _state;
     constructor(config: CircuitBreakerConfig);
     /**
-     * Whether the circuit is closed and the tool can be called.
+     * Whether the tool can be called.
+     * Returns true in CLOSED (normal) and HALF_OPEN (degraded) states.
+     * Only returns false when the circuit is fully OPEN.
      */
     get isAvailable(): boolean;
     /**
@@ -55,12 +60,16 @@ export declare class CircuitBreaker {
     get effectiveThreshold(): number;
     /**
      * Record a successful tool execution — resets failure count
-     * and closes the circuit if it was open.
+     * and closes the circuit.
      */
     recordSuccess(): void;
     /**
      * Record a failed tool execution.
-     * If all retries are exhausted, the circuit opens.
+     *
+     * State transitions:
+     * - CLOSED    → HALF_OPEN (first failure, retries remain)
+     * - HALF_OPEN → HALF_OPEN (still have retries) or OPEN (retries exhausted)
+     * - OPEN      → stays OPEN (should not normally be called in this state)
      *
      * @returns The updated number of retries remaining (0 means the circuit opened).
      */

package/dist/tools/circuit-breaker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/tools/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAqC;gBAEvC,MAAM,EAAE,oBAAoB;IAKxC;;OAEG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;OAKG;IACH,aAAa,IAAI,MAAM;IASvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS,IAAI,aAAa;CAS3B"}
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../src/tools/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,MAAM,CAAqC;gBAEvC,MAAM,EAAE,oBAAoB;IAKxC;;;;OAIG;IACH,IAAI,WAAW,IAAI,OAAO,CAEzB;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,YAAY,CAExB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED;;;OAGG;IACH,aAAa,IAAI,IAAI;IAKrB;;;;;;;;;OASG;IACH,aAAa,IAAI,MAAM;IAWvB;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,SAAS,IAAI,aAAa;CAS3B"}

package/dist/tools/circuit-breaker.js

@@ -6,15 +6,18 @@ const types_1 = require("./types");
  * Circuit breaker that tracks consecutive failures for a single tool.
  *
  * States:
- * - CLOSED: Normal operation — executions are allowed.
- * - OPEN:   All retries exhausted — subsequent calls are blocked
- *           without attempting execution.
+ * - CLOSED:    Normal operation — no failures, executions are allowed.
+ * - HALF_OPEN: Degraded operation — failures have occurred but retries
+ *              remain. Tool calls are still allowed, but the caller
+ *              should proceed with caution.
+ * - OPEN:      All retries exhausted — subsequent calls are blocked
+ *              without attempting execution.
  *
- * Flow:
- *   1st failure → 2 retries remaining → LLM should analyze the error and retry
- *   2nd failure → 1 retry remaining
+ * Flow (with retryCount = 2):
+ *   1st failure → HALF_OPEN, 1 retry remaining → LLM should analyze and retry
+ *   2nd failure → HALF_OPEN, 0 retries remaining → last chance
  *   3rd failure → circuit OPENS → LLM must try a different approach
- *   Success → failure count resets to zero
+ *   Success     → circuit returns to CLOSED, failure count resets
  */
 class CircuitBreaker {
     toolName;
@@ -26,10 +29,12 @@ class CircuitBreaker {
         this.retryCount = config.retryCount ?? 2;
     }
     /**
-     * Whether the circuit is closed and the tool can be called.
+     * Whether the tool can be called.
+     * Returns true in CLOSED (normal) and HALF_OPEN (degraded) states.
+     * Only returns false when the circuit is fully OPEN.
      */
     get isAvailable() {
-        return this._state === types_1.BreakerState.CLOSED;
+        return this._state === types_1.BreakerState.CLOSED || this._state === types_1.BreakerState.HALF_OPEN;
     }
     /**
      * Current breaker state.
@@ -58,7 +63,7 @@ class CircuitBreaker {
     }
     /**
      * Record a successful tool execution — resets failure count
-     * and closes the circuit if it was open.
+     * and closes the circuit.
      */
     recordSuccess() {
         this.failureCount = 0;
@@ -66,7 +71,11 @@ class CircuitBreaker {
     }
     /**
      * Record a failed tool execution.
-     * If all retries are exhausted, the circuit opens.
+     *
+     * State transitions:
+     * - CLOSED    → HALF_OPEN (first failure, retries remain)
+     * - HALF_OPEN → HALF_OPEN (still have retries) or OPEN (retries exhausted)
+     * - OPEN      → stays OPEN (should not normally be called in this state)
      *
      * @returns The updated number of retries remaining (0 means the circuit opened).
      */
@@ -76,6 +85,8 @@ class CircuitBreaker {
             this._state = types_1.BreakerState.OPEN;
             return 0;
         }
+        // First failure or still within retry budget — enter/remain HALF_OPEN
+        this._state = types_1.BreakerState.HALF_OPEN;
         return this.retriesRemaining;
     }
     /**

package/dist/tools/circuit-breaker.js.map

@@ -1 +1 @@
-{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/tools/circuit-breaker.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAiBtD;;;;;;;;;;;;;GAaG;AACH,MAAa,cAAc;IACjB,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,YAAY,GAAG,CAAC,CAAC;IACjB,MAAM,GAAiB,oBAAY,CAAC,MAAM,CAAC;IAEnD,YAAY,MAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,oBAAY,CAAC,MAAM,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,IAAI,CAAC;YAChC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;YACzC,SAAS,EAAE,IAAI,CAAC,WAAW;SAC5B,CAAC;IACJ,CAAC;CACF;AA3FD,wCA2FC"}
+{"version":3,"file":"circuit-breaker.js","sourceRoot":"","sources":["../../src/tools/circuit-breaker.ts"],"names":[],"mappings":";;;AAAA,mCAAsD;AAiBtD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,cAAc;IACjB,QAAQ,CAAS;IACjB,UAAU,CAAS;IACnB,YAAY,GAAG,CAAC,CAAC;IACjB,MAAM,GAAiB,oBAAY,CAAC,MAAM,CAAC;IAEnD,YAAY,MAA4B;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QAChC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED;;;;OAIG;IACH,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,MAAM,KAAK,oBAAY,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,KAAK,oBAAY,CAAC,SAAS,CAAC;IACvF,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;;OAGG;IACH,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,aAAa;QACX,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED;;;;;;;;;OASG;IACH,aAAa;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACxC,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,IAAI,CAAC;YAChC,OAAO,CAAC,CAAC;QACX,CAAC;QACD,sEAAsE;QACtE,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,SAAS,CAAC;QACrC,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,oBAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO;YACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,MAAM;YAClB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,gBAAgB,EAAE,IAAI,CAAC,kBAAkB;YACzC,SAAS,EAAE,IAAI,CAAC,WAAW;SAC5B,CAAC;IACJ,CAAC;CACF;AAnGD,wCAmGC"}

package/dist/tools/error-tracker.d.ts

@@ -1,31 +1,29 @@
-import { ToolErrorTrace, ErrorTraceSummary } from "./types";
 /**
- * Configuration for the ToolErrorTracker.
+ * ToolErrorTracker — in-memory tracker for tool failure chains within a session.
+ *
+ * Provides real-time visibility into which tools are failing and why,
+ * so the LLM can query error state via `list_errors` and the agent can
+ * attach LLM analysis to active traces.
+ *
+ * This is NOT a persistence layer. For cross-session learning and
+ * structured error diagnosis, use the ErrorNotebook (错题本) via
+ * ReflectionHook — it runs a post-execution LLM reflection that
+ * categorises mistakes and injects lessons into future sessions.
  */
-export interface ErrorTrackerConfig {
-    /**
-     * Directory where trace files are stored.
-     * Defaults to `.error-traces` relative to the working directory.
-     */
-    storageDir?: string;
-    /**
-     * Whether to persist traces to disk immediately.
-     * Defaults to true.
-     */
-    persistImmediately?: boolean;
-}
+import { ToolErrorTrace, ErrorTraceSummary } from "./types";
 /**
  * Categorize a tool error based on its message content.
  * Helps developers quickly identify common failure patterns.
  */
 export declare function categorizeError(error: string): string;
 /**
- * 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:
@@ -35,15 +33,12 @@ export declare function categorizeError(error: string): string;
  * 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}.
  */
 export declare class ToolErrorTracker {
     private traces;
     private activeTraceByTool;
-    private storageDir;
-    private persistImmediately;
-    constructor(config?: ErrorTrackerConfig);
     /**
      * Record a tool execution failure.
      *
@@ -54,19 +49,13 @@ export declare class ToolErrorTracker {
      *
      * @returns The trace ID for the chain this failure belongs to.
      */
-    recordFailure(toolName: string, args: Record<string, unknown>, error: string, retriesRemaining: number): string;
+    recordFailure(toolName: string, args: Record<string, unknown>, error: string, retriesRemaining: number, breakerState?: string): string;
     /**
      * 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: string, traceId: string, resolution?: string): void;
     /**
      * 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: string, analysis: string): void;
     /**
@@ -82,30 +71,25 @@ export declare class ToolErrorTracker {
      */
     getActiveTraceId(toolName: string): string | undefined;
     /**
-     * Get the total number of traces recorded.
+     * Get all currently active (unresolved) traces.
      */
-    get traceCount(): number;
+    getActiveTraces(): Array<{
+        toolName: string;
+        traceId: string;
+    }>;
     /**
-     * Persist all traces to disk immediately.
+     * Get the total number of traces recorded in this session.
      */
-    persistAll(): void;
-    /**
-     * Load traces from disk (e.g., on startup to resume monitoring).
-     */
-    loadFromDisk(): void;
+    get traceCount(): number;
     /**
-     * Generate a human-readable markdown report of all traces.
+     * Generate an in-memory markdown report of all traces for the current session.
      */
     generateMarkdownReport(): string;
     /**
-     * Delete all stored traces.
+     * Clear all in-memory traces.
      */
-    clearAll(): void;
+    clear(): void;
     private createTrace;
-    private persistTrace;
-    private ensureStorageDir;
-    private writeTraceFile;
-    private writeIndexFile;
     private formatEventType;
 }
 //# sourceMappingURL=error-tracker.d.ts.map

package/dist/tools/error-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-tracker.d.ts","sourceRoot":"","sources":["../../src/tools/error-tracker.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,cAAc,EAEd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAoDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BrD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,kBAAkB,CAAU;gBAExB,MAAM,CAAC,EAAE,kBAAkB;IAOvC;;;;;;;;;OASG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,GACvB,MAAM;IA6CT;;;;;;OAMG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAsBP;;;;OAIG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA4BvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD;;OAEG;IACH,eAAe,IAAI,iBAAiB,EAAE;IAyBtC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAID;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;OAEG;IACH,YAAY,IAAI,IAAI;IAyBpB;;OAEG;IACH,sBAAsB,IAAI,MAAM;IA4DhC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAoBhB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,cAAc;IAoBtB,OAAO,CAAC,eAAe;CAkBxB"}
+{"version":3,"file":"error-tracker.d.ts","sourceRoot":"","sources":["../../src/tools/error-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EACL,cAAc,EAEd,iBAAiB,EAClB,MAAM,SAAS,CAAC;AAoDjB;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA6BrD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAA0C;IACxD,OAAO,CAAC,iBAAiB,CAAkC;IAI3D;;;;;;;;;OASG;IACH,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,MAAM,EACxB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM;IAmDT;;OAEG;IACH,cAAc,CACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,GAClB,IAAI;IAoBP;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA2BvD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIrD;;OAEG;IACH,eAAe,IAAI,iBAAiB,EAAE;IAyBtC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAItD;;OAEG;IACH,eAAe,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAW/D;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAID;;OAEG;IACH,sBAAsB,IAAI,MAAM;IA6DhC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,eAAe;CAoBxB"}