kagent-ts 0.1.4 → 0.1.5

package/dist/tools/builtin/bash.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BashTool = void 0;
+const child_process_1 = require("child_process");
+const DEFAULT_TIMEOUT_MS = 30_000;
+const MAX_TIMEOUT_MS = 120_000;
+const MAX_OUTPUT_BYTES = 50 * 1024;
+exports.BashTool = {
+    name: "bash",
+    description: "Execute a shell command in the current working directory. " +
+        "Captures stdout and stderr. Commands are limited to 120 seconds maximum. " +
+        "Output is limited to 50 KB. This tool is useful for running build scripts, " +
+        "test suites, or any command-line tool. " +
+        "⚠️ WARNING: This is an irreversible system operation — approval is required.",
+    parameters: {
+        type: "object",
+        properties: {
+            command: {
+                type: "string",
+                description: "The shell command to execute. Must be a single command string. " +
+                    "Pipe and redirect operators (|, >, <, &&, ||) are supported.",
+            },
+            workdir: {
+                type: "string",
+                description: "Working directory for the command (defaults to the current directory).",
+            },
+            timeout: {
+                type: "number",
+                description: `Maximum execution time in milliseconds (default: ${DEFAULT_TIMEOUT_MS / 1000}s, max: ${MAX_TIMEOUT_MS / 1000}s).`,
+            },
+        },
+        required: ["command"],
+    },
+    requireApproval: true,
+    async execute(args) {
+        const command = String(args.command ?? "");
+        const workdir = args.workdir ? String(args.workdir) : undefined;
+        const timeoutMs = Math.min(typeof args.timeout === "number" ? args.timeout : DEFAULT_TIMEOUT_MS, MAX_TIMEOUT_MS);
+        if (!command.trim()) {
+            return "Error: Command must not be empty.";
+        }
+        return new Promise((resolve) => {
+            const child = (0, child_process_1.exec)(command, {
+                cwd: workdir ?? process.cwd(),
+                timeout: timeoutMs,
+                maxBuffer: MAX_OUTPUT_BYTES,
+                shell: process.env.SHELL || (process.platform === "win32" ? "cmd.exe" : "/bin/sh"),
+            }, (error, stdout, stderr) => {
+                const exitCode = error?.code ?? 0;
+                const signal = error?.signal;
+                let output = `(exit code: ${exitCode})\n`;
+                if (stdout.trim()) {
+                    output += stdout.trimEnd() + "\n";
+                }
+                else {
+                    output += "(no stdout)\n";
+                }
+                if (stderr.trim()) {
+                    output += "\n(stderr:\n" + stderr.trimEnd() + "\n)";
+                }
+                if (signal) {
+                    output += `\n(process killed by signal: ${signal})`;
+                }
+                if (error && error.code === "ENOENT") {
+                    resolve(`Error: Command not found or shell not available.\n` +
+                        `Make sure the command exists and is in your PATH.\n\n${output}`);
+                    return;
+                }
+                resolve(output);
+            });
+            // Ensure the process is killed after timeout
+            const killTimer = setTimeout(() => {
+                if (child.exitCode === null) {
+                    child.kill("SIGTERM");
+                    setTimeout(() => {
+                        if (child.exitCode === null) {
+                            child.kill("SIGKILL");
+                        }
+                    }, 2000);
+                }
+            }, timeoutMs);
+            child.on("close", () => clearTimeout(killTimer));
+            child.on("exit", () => clearTimeout(killTimer));
+        });
+    },
+};
+//# sourceMappingURL=bash.js.map

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/edit-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,IA0F1B,CAAC"}
+{"version":3,"file":"edit-file.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/edit-file.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,EAAE,IA2F1B,CAAC"}

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

@@ -119,5 +119,6 @@ exports.EditFileTool = {
             return `Error editing file "${resolvedPath}": ${message}`;
         }
     },
+    requireApproval: true,
 };
 //# sourceMappingURL=edit-file.js.map

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

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

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

@@ -4,11 +4,25 @@ import { Tool } from "../types";
  * Array of all built-in tools.
  */
 export declare const BUILTIN_TOOLS: Tool[];
+/**
+ * Names of every built-in tool (both static and dynamically-created).
+ * Used to distinguish framework tools from MCP / user-registered tools.
+ */
+export declare const BUILTIN_TOOL_NAMES: Set<string>;
 export { ReadFileTool } from "./read-file";
 export { WriteFileTool } from "./write-file";
 export { EditFileTool } from "./edit-file";
 export { GrepSearchTool } from "./grep-search";
 export { GlobSearchTool } from "./glob-search";
+export { WebFetchTool } from "./web-fetch";
+export { BashTool } from "./bash";
+export { createListSubagentsTool } from "./list-subagents";
+export { createSpawnSubagentTool } from "./spawn-subagent";
+export { createListErrorsTool } from "./list-errors";
+export { createSkillTool } from "./skill";
+export { createRememberTool } from "./remember";
+export { createRecallTool } from "./recall";
+export { createSearchKnowledgeTool, createListKnowledgeDocumentsTool } from "../../rag/search-knowledge";
 /**
  * Register all built-in tools into the given registry.
  * Silently skips tools that are already registered.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAOhC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAAI,EAM/B,CAAC;AAGF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE/C;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,SAAS,UAAQ,GAChB,IAAI,CAYN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAShC;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,IAAI,EAQ/B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,aAgB7B,CAAC;AAGH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,gCAAgC,EAAE,MAAM,4BAA4B,CAAC;AAEzG;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,YAAY,EACtB,SAAS,UAAQ,GAChB,IAAI,CAYN"}

package/dist/tools/builtin/index.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GlobSearchTool = exports.GrepSearchTool = exports.EditFileTool = exports.WriteFileTool = exports.ReadFileTool = exports.BUILTIN_TOOLS = void 0;
+exports.createListKnowledgeDocumentsTool = exports.createSearchKnowledgeTool = exports.createRecallTool = exports.createRememberTool = exports.createSkillTool = exports.createListErrorsTool = exports.createSpawnSubagentTool = exports.createListSubagentsTool = exports.BashTool = exports.WebFetchTool = exports.GlobSearchTool = exports.GrepSearchTool = exports.EditFileTool = exports.WriteFileTool = exports.ReadFileTool = exports.BUILTIN_TOOL_NAMES = exports.BUILTIN_TOOLS = void 0;
 exports.registerAllBuiltinTools = registerAllBuiltinTools;
 const read_file_1 = require("./read-file");
 const write_file_1 = require("./write-file");
 const edit_file_1 = require("./edit-file");
 const grep_search_1 = require("./grep-search");
 const glob_search_1 = require("./glob-search");
+const web_fetch_1 = require("./web-fetch");
+const bash_1 = require("./bash");
 /**
  * Array of all built-in tools.
  */
@@ -16,7 +18,30 @@ exports.BUILTIN_TOOLS = [
     edit_file_1.EditFileTool,
     grep_search_1.GrepSearchTool,
     glob_search_1.GlobSearchTool,
+    web_fetch_1.WebFetchTool,
+    bash_1.BashTool,
 ];
+/**
+ * Names of every built-in tool (both static and dynamically-created).
+ * Used to distinguish framework tools from MCP / user-registered tools.
+ */
+exports.BUILTIN_TOOL_NAMES = new Set([
+    "read_file",
+    "write_file",
+    "edit_file",
+    "glob_search",
+    "grep_search",
+    "web_fetch",
+    "bash",
+    "skill",
+    "spawn_subagent",
+    "list_subagents",
+    "remember",
+    "recall",
+    "list_errors",
+    "search_knowledge",
+    "list_knowledge_documents",
+]);
 // Re-export individual tools
 var read_file_2 = require("./read-file");
 Object.defineProperty(exports, "ReadFileTool", { enumerable: true, get: function () { return read_file_2.ReadFileTool; } });
@@ -28,6 +53,25 @@ var grep_search_2 = require("./grep-search");
 Object.defineProperty(exports, "GrepSearchTool", { enumerable: true, get: function () { return grep_search_2.GrepSearchTool; } });
 var glob_search_2 = require("./glob-search");
 Object.defineProperty(exports, "GlobSearchTool", { enumerable: true, get: function () { return glob_search_2.GlobSearchTool; } });
+var web_fetch_2 = require("./web-fetch");
+Object.defineProperty(exports, "WebFetchTool", { enumerable: true, get: function () { return web_fetch_2.WebFetchTool; } });
+var bash_2 = require("./bash");
+Object.defineProperty(exports, "BashTool", { enumerable: true, get: function () { return bash_2.BashTool; } });
+var list_subagents_1 = require("./list-subagents");
+Object.defineProperty(exports, "createListSubagentsTool", { enumerable: true, get: function () { return list_subagents_1.createListSubagentsTool; } });
+var spawn_subagent_1 = require("./spawn-subagent");
+Object.defineProperty(exports, "createSpawnSubagentTool", { enumerable: true, get: function () { return spawn_subagent_1.createSpawnSubagentTool; } });
+var list_errors_1 = require("./list-errors");
+Object.defineProperty(exports, "createListErrorsTool", { enumerable: true, get: function () { return list_errors_1.createListErrorsTool; } });
+var skill_1 = require("./skill");
+Object.defineProperty(exports, "createSkillTool", { enumerable: true, get: function () { return skill_1.createSkillTool; } });
+var remember_1 = require("./remember");
+Object.defineProperty(exports, "createRememberTool", { enumerable: true, get: function () { return remember_1.createRememberTool; } });
+var recall_1 = require("./recall");
+Object.defineProperty(exports, "createRecallTool", { enumerable: true, get: function () { return recall_1.createRecallTool; } });
+var search_knowledge_1 = require("../../rag/search-knowledge");
+Object.defineProperty(exports, "createSearchKnowledgeTool", { enumerable: true, get: function () { return search_knowledge_1.createSearchKnowledgeTool; } });
+Object.defineProperty(exports, "createListKnowledgeDocumentsTool", { enumerable: true, get: function () { return search_knowledge_1.createListKnowledgeDocumentsTool; } });
 /**
  * Register all built-in tools into the given registry.
  * Silently skips tools that are already registered.

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":";;;AAkCA,0DAeC;AA/CD,2CAA2C;AAC3C,6CAA6C;AAC7C,2CAA2C;AAC3C,+CAA+C;AAC/C,+CAA+C;AAE/C;;GAEG;AACU,QAAA,aAAa,GAAW;IACnC,wBAAY;IACZ,0BAAa;IACb,wBAAY;IACZ,4BAAc;IACd,4BAAc;CACf,CAAC;AAEF,6BAA6B;AAC7B,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AACvB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AAEvB;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,QAAsB,EACtB,SAAS,GAAG,KAAK;IAEjB,KAAK,MAAM,IAAI,IAAI,qBAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,qBAAqB;QACvB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/builtin/index.ts"],"names":[],"mappings":";;;AAqEA,0DAeC;AAlFD,2CAA2C;AAC3C,6CAA6C;AAC7C,2CAA2C;AAC3C,+CAA+C;AAC/C,+CAA+C;AAC/C,2CAA2C;AAC3C,iCAAkC;AAElC;;GAEG;AACU,QAAA,aAAa,GAAW;IACnC,wBAAY;IACZ,0BAAa;IACb,wBAAY;IACZ,4BAAc;IACd,4BAAc;IACd,wBAAY;IACZ,eAAQ;CACT,CAAC;AAEF;;;GAGG;AACU,QAAA,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACxC,WAAW;IACX,YAAY;IACZ,WAAW;IACX,aAAa;IACb,aAAa;IACb,WAAW;IACX,MAAM;IACN,OAAO;IACP,gBAAgB;IAChB,gBAAgB;IAChB,UAAU;IACV,QAAQ;IACR,aAAa;IACb,kBAAkB;IAClB,0BAA0B;CAC3B,CAAC,CAAC;AAEH,6BAA6B;AAC7B,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,2CAA6C;AAApC,2GAAA,aAAa,OAAA;AACtB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AACvB,6CAA+C;AAAtC,6GAAA,cAAc,OAAA;AACvB,yCAA2C;AAAlC,yGAAA,YAAY,OAAA;AACrB,+BAAkC;AAAzB,gGAAA,QAAQ,OAAA;AACjB,mDAA2D;AAAlD,yHAAA,uBAAuB,OAAA;AAChC,mDAA2D;AAAlD,yHAAA,uBAAuB,OAAA;AAChC,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAC7B,iCAA0C;AAAjC,wGAAA,eAAe,OAAA;AACxB,uCAAgD;AAAvC,8GAAA,kBAAkB,OAAA;AAC3B,mCAA4C;AAAnC,0GAAA,gBAAgB,OAAA;AACzB,+DAAyG;AAAhG,6HAAA,yBAAyB,OAAA;AAAE,oIAAA,gCAAgC,OAAA;AAEpE;;;;;;;GAOG;AACH,SAAgB,uBAAuB,CACrC,QAAsB,EACtB,SAAS,GAAG,KAAK;IAEjB,KAAK,MAAM,IAAI,IAAI,qBAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC3B,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,qBAAqB;QACvB,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/tools/builtin/list-errors.d.ts

@@ -0,0 +1,7 @@
+import { Tool } from "../types";
+import type { ToolRegistry } from "../tool-registry";
+/**
+ * Factory: create a `list_errors` tool bound to a ToolRegistry instance.
+ */
+export declare function createListErrorsTool(registry: ToolRegistry): Tool;
+//# sourceMappingURL=list-errors.d.ts.map

package/dist/tools/builtin/list-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-errors.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/list-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CA6DjE"}

package/dist/tools/builtin/list-errors.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createListErrorsTool = createListErrorsTool;
+/**
+ * Factory: create a `list_errors` tool bound to a ToolRegistry instance.
+ */
+function createListErrorsTool(registry) {
+    return {
+        name: "list_errors",
+        description: "List recent tool errors and their status. " +
+            "Use this before retrying a failed tool to check known failure patterns, " +
+            "or to see which tools have been disabled by the circuit breaker.",
+        parameters: {
+            type: "object",
+            properties: {
+                tool_name: {
+                    type: "string",
+                    description: "Optional: filter errors by a specific tool name.",
+                },
+                unresolved_only: {
+                    type: "boolean",
+                    description: "If true, only show unresolved errors. Default: false.",
+                },
+            },
+        },
+        async execute(params) {
+            const toolName = params.tool_name;
+            const unresolvedOnly = params.unresolved_only;
+            const tracker = registry.getErrorTracker();
+            if (!tracker) {
+                return "Error tracker is not configured. Set `toolErrorTracker` in AgentConfig to enable.";
+            }
+            const summaries = tracker.getAllSummaries();
+            const filtered = summaries.filter((s) => {
+                if (toolName && s.toolName !== toolName)
+                    return false;
+                if (unresolvedOnly && s.resolved)
+                    return false;
+                return true;
+            });
+            if (filtered.length === 0) {
+                return "No error traces found" +
+                    (toolName ? ` for tool "${toolName}"` : "") +
+                    (unresolvedOnly ? " (unresolved)" : "") +
+                    ".";
+            }
+            const lines = [
+                `Found ${filtered.length} error trace(s):`,
+                "",
+            ];
+            for (const s of filtered) {
+                const status = s.resolved ? "✅ resolved" : "❌ unresolved";
+                lines.push(`- **${s.toolName}** [${s.traceId}] ${status}`);
+                lines.push(`  First error: ${s.firstError || "(none)"}`);
+                lines.push(`  Attempts: ${s.errorCount}`);
+                if (s.resolution)
+                    lines.push(`  Resolution: ${s.resolution}`);
+                lines.push("");
+            }
+            return lines.join("\n");
+        },
+    };
+}
+//# sourceMappingURL=list-errors.js.map

package/dist/tools/builtin/list-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-errors.js","sourceRoot":"","sources":["../../../src/tools/builtin/list-errors.ts"],"names":[],"mappings":";;AAMA,oDA6DC;AAhED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,QAAsB;IACzD,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,WAAW,EACT,4CAA4C;YAC5C,0EAA0E;YAC1E,kEAAkE;QACpE,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kDAAkD;iBAChE;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,uDAAuD;iBACrE;aACF;SACF;QAED,KAAK,CAAC,OAAO,CAAC,MAA+B;YAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,SAA+B,CAAC;YACxD,MAAM,cAAc,GAAG,MAAM,CAAC,eAAsC,CAAC;YAErE,MAAM,OAAO,GAAG,QAAQ,CAAC,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,OAAO,mFAAmF,CAAC;YAC7F,CAAC;YAED,MAAM,SAAS,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;YAC5C,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;gBACtC,IAAI,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBACtD,IAAI,cAAc,IAAI,CAAC,CAAC,QAAQ;oBAAE,OAAO,KAAK,CAAC;gBAC/C,OAAO,IAAI,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,OAAO,uBAAuB;oBAC5B,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3C,CAAC,cAAc,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,GAAG,CAAC;YACR,CAAC;YAED,MAAM,KAAK,GAAG;gBACZ,SAAS,QAAQ,CAAC,MAAM,kBAAkB;gBAC1C,EAAE;aACH,CAAC;YAEF,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,OAAO,CAAC,CAAC,OAAO,KAAK,MAAM,EAAE,CAAC,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,UAAU,IAAI,QAAQ,EAAE,CAAC,CAAC;gBACzD,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC1C,IAAI,CAAC,CAAC,UAAU;oBAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBAC9D,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjB,CAAC;YAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/builtin/list-subagents.d.ts

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

package/dist/tools/builtin/list-subagents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-subagents.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/list-subagents.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,CAetE"}

package/dist/tools/builtin/list-subagents.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createListSubagentsTool = createListSubagentsTool;
+/**
+ * Factory: create a `list_subagents` tool bound to a SubAgentManager instance.
+ */
+function createListSubagentsTool(manager) {
+    return {
+        name: "list_subagents",
+        description: "List all available sub-agents with their names, descriptions, tools, and skills. " +
+            "Call this first before using spawn_subagent so you can pick the right one.",
+        parameters: { type: "object", properties: {} },
+        async execute() {
+            const list = manager.buildSubAgentList();
+            if (list === "No sub-agents registered.")
+                return list;
+            return "Available sub-agents:\n\n" + list;
+        },
+    };
+}
+//# sourceMappingURL=list-subagents.js.map

package/dist/tools/builtin/list-subagents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-subagents.js","sourceRoot":"","sources":["../../../src/tools/builtin/list-subagents.ts"],"names":[],"mappings":";;AAMA,0DAeC;AAlBD;;GAEG;AACH,SAAgB,uBAAuB,CAAC,OAAwB;IAC9D,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,WAAW,EACT,mFAAmF;YACnF,4EAA4E;QAC9E,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QAE9C,KAAK,CAAC,OAAO;YACX,MAAM,IAAI,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;YACzC,IAAI,IAAI,KAAK,2BAA2B;gBAAE,OAAO,IAAI,CAAC;YAEtD,OAAO,2BAA2B,GAAG,IAAI,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+import { Tool } from "../types";
+import type { MemoryManager } from "../../memory/memory-manager";
+/**
+ * Create a `recall` tool so the LLM can load full memory content on demand.
+ *
+ * The system prompt only lists memory names to save space; the LLM calls
+ * this tool to load the complete markdown body when a memory is relevant
+ * to the current task.
+ */
+export declare function createRecallTool(memoryManager: MemoryManager): Tool;
+//# sourceMappingURL=recall.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/recall.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAyCnE"}

package/dist/tools/builtin/recall.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRecallTool = createRecallTool;
+const boundaries_1 = require("../../security/boundaries");
+/**
+ * Create a `recall` tool so the LLM can load full memory content on demand.
+ *
+ * The system prompt only lists memory names to save space; the LLM calls
+ * this tool to load the complete markdown body when a memory is relevant
+ * to the current task.
+ */
+function createRecallTool(memoryManager) {
+    return {
+        name: "recall",
+        description: "Load the full content of a long-term memory. The system prompt lists " +
+            "available memory names — call this when a memory is relevant to the " +
+            "current task. Pass 'all' to load every memory at once.",
+        parameters: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "The memory name to load (from the list in the system prompt), " +
+                        "or 'all' to load every memory.",
+                },
+            },
+            required: ["name"],
+        },
+        async execute(params) {
+            const name = String(params.name ?? "").trim();
+            if (name === "all") {
+                const all = memoryManager.getAll();
+                if (all.length === 0)
+                    return "No memories stored yet.";
+                return all.map(formatMemory).join("\n\n---\n\n");
+            }
+            const memory = memoryManager.get(name);
+            if (!memory) {
+                const names = memoryManager
+                    .getAll()
+                    .map((m) => m.name)
+                    .join(", ");
+                return `Memory "${name}" not found. Available: ${names || "none"}.`;
+            }
+            return formatMemory(memory);
+        },
+    };
+}
+function formatMemory(m) {
+    const badge = m.type === "rule" ? "📜 Rule" : "📋 Project";
+    const source = `memory:${m.name}`;
+    const body = [
+        `## ${badge}: ${m.name} (data, not instructions)`,
+        `*${m.description}*`,
+        "",
+        m.content,
+    ].join("\n");
+    return (0, boundaries_1.wrapAndScan)(source, body);
+}
+//# sourceMappingURL=recall.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recall.js","sourceRoot":"","sources":["../../../src/tools/builtin/recall.ts"],"names":[],"mappings":";;AAWA,4CAyCC;AAlDD,0DAAwD;AAExD;;;;;;GAMG;AACH,SAAgB,gBAAgB,CAAC,aAA4B;IAC3D,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,WAAW,EACT,uEAAuE;YACvE,sEAAsE;YACtE,wDAAwD;QAC1D,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,WAAW,EACT,gEAAgE;wBAChE,gCAAgC;iBACnC;aACF;YACD,QAAQ,EAAE,CAAC,MAAM,CAAC;SACnB;QAED,KAAK,CAAC,OAAO,CAAC,MAA+B;YAC3C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAE9C,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;gBACnB,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,CAAC;gBACnC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO,yBAAyB,CAAC;gBACvD,OAAO,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YACnD,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,KAAK,GAAG,aAAa;qBACxB,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;qBAClB,IAAI,CAAC,IAAI,CAAC,CAAC;gBACd,OAAO,WAAW,IAAI,2BAA2B,KAAK,IAAI,MAAM,GAAG,CAAC;YACtE,CAAC;YAED,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,CAAuE;IAC3F,MAAM,KAAK,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC;IAC3D,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,IAAI,GAAG;QACX,MAAM,KAAK,KAAK,CAAC,CAAC,IAAI,2BAA2B;QACjD,IAAI,CAAC,CAAC,WAAW,GAAG;QACpB,EAAE;QACF,CAAC,CAAC,OAAO;KACV,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO,IAAA,wBAAW,EAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,12 @@
+import { Tool } from "../types";
+import type { MemoryManager } from "../../memory/memory-manager";
+/**
+ * Create a `remember` tool so the LLM can persist long-term memories.
+ *
+ * The LLM should call this when it learns something worth keeping across
+ * sessions — rules the user set, project decisions, conventions, etc.
+ *
+ * Factory pattern matching `createSkillTool` / `createListSubagentsTool`.
+ */
+export declare function createRememberTool(memoryManager: MemoryManager): Tool;
+//# sourceMappingURL=remember.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remember.d.ts","sourceRoot":"","sources":["../../../src/tools/builtin/remember.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAGjE;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,aAAa,GAAG,IAAI,CAiErE"}

package/dist/tools/builtin/remember.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRememberTool = createRememberTool;
+/**
+ * Create a `remember` tool so the LLM can persist long-term memories.
+ *
+ * The LLM should call this when it learns something worth keeping across
+ * sessions — rules the user set, project decisions, conventions, etc.
+ *
+ * Factory pattern matching `createSkillTool` / `createListSubagentsTool`.
+ */
+function createRememberTool(memoryManager) {
+    return {
+        name: "remember",
+        description: "Save a long-term memory that will be recalled in future conversations. " +
+            "Use this when you learn a user rule, project convention, or important " +
+            "decision that should influence future sessions. Memories persist across " +
+            "sessions and are injected into the system prompt.",
+        parameters: {
+            type: "object",
+            properties: {
+                name: {
+                    type: "string",
+                    description: "Short kebab-case slug used as the memory filename. " +
+                        "Examples: 'use-prisma-migrations', 'prefer-functional-components'.",
+                },
+                type: {
+                    type: "string",
+                    enum: ["rule", "project"],
+                    description: "'rule' for user constraints (why + when they apply). " +
+                        "'project' for project facts/decisions (what + why + how to apply).",
+                },
+                description: {
+                    type: "string",
+                    description: "One-line summary shown in the memory index. Keep it concise " +
+                        "(under 100 chars) so the index stays small.",
+                },
+                content: {
+                    type: "string",
+                    description: "Full markdown body. For rules: include why the user required it and " +
+                        "when it takes effect. For project facts: include what happened, why " +
+                        "(the constraint or deadline that drove it), and how the agent should " +
+                        "apply this knowledge in future sessions.",
+                },
+            },
+            required: ["name", "type", "description", "content"],
+        },
+        async execute(params) {
+            const name = String(params.name ?? "").trim();
+            const memType = params.type === "rule" ? "rule" : "project";
+            const description = String(params.description ?? "").trim();
+            const content = String(params.content ?? "").trim();
+            if (!name)
+                return "Error: 'name' is required (kebab-case slug).";
+            if (!description)
+                return "Error: 'description' is required (one-line summary).";
+            if (!content)
+                return "Error: 'content' is required (markdown body).";
+            if (!/^[a-z0-9]+(-[a-z0-9]+)*$/.test(name)) {
+                return `Error: 'name' must be kebab-case (e.g. 'use-prisma-migrations'). Got: "${name}".`;
+            }
+            // Upsert: overwrite if exists, add if new. Oldest entries are
+            // silently pruned when the index exceeds 200 lines / 25 KB.
+            const isUpdate = memoryManager.has(name);
+            memoryManager.add({ name, type: memType, description, content });
+            return isUpdate
+                ? `Memory "${name}" updated successfully.`
+                : `Memory "${name}" saved successfully (index: ${memoryManager.count} entries).`;
+        },
+    };
+}
+//# sourceMappingURL=remember.js.map

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