@thoughtflow/core 0.1.2

package/dist/tools/docs/doc-check-coverage.tool.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocCheckCoverageTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const explorer_1 = require("../../libs/codebase/indexer/explorer");
+class DocCheckCoverageTool extends tool_base_class_1.ToolBase {
+    name = "docCheckCoverage";
+    description = "Check which code modules lack documentation. Finds undocumented public APIs, classes, and exported functions.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const rootPath = input.projectPath ?? process.cwd();
+        const explorer = new explorer_1.CodebaseExplorer();
+        const files = explorer.explore({ rootPath });
+        const docs = files
+            .filter(f => f.classification === "documentation")
+            .map(f => f.relativePath.toLowerCase());
+        const codeFiles = files.filter(f => f.classification === "source-code");
+        const dirsCovered = new Set(docs.map(d => d.split("/").slice(0, -1).join("/")).filter(Boolean));
+        const uncoveredDirs = new Set();
+        for (const f of codeFiles) {
+            const dir = f.relativePath.split("/").slice(0, -1).join("/");
+            if (dir && !dirsCovered.has(dir))
+                uncoveredDirs.add(dir);
+        }
+        return {
+            success: true,
+            output: JSON.stringify({
+                codeFiles: codeFiles.length,
+                docsFiles: docs.length,
+                documentedDirs: dirsCovered.size,
+                undocumentedDirs: uncoveredDirs.size,
+                undocumentedList: Array.from(uncoveredDirs).slice(0, 20),
+            }),
+        };
+    }
+}
+exports.DocCheckCoverageTool = DocCheckCoverageTool;
+//# sourceMappingURL=doc-check-coverage.tool.js.map

package/dist/tools/docs/doc-check-coverage.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-check-coverage.tool.js","sourceRoot":"","sources":["../../../src/tools/docs/doc-check-coverage.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,mEAAwE;AAExE,MAAa,oBAAqB,SAAQ,0BAAQ;IACvC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAAG,+GAA+G,CAAC;IACrH,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,QAAQ,GAAI,KAAK,CAAC,WAAsB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,2BAAgB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE7C,MAAM,IAAI,GAAG,KAAK;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,eAAe,CAAC;aACjD,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,cAAc,KAAK,aAAa,CAAC,CAAC;QAExE,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CACnE,CAAC;QAEF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,GAAG,GAAG,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC;gBACrB,SAAS,EAAE,SAAS,CAAC,MAAM;gBAC3B,SAAS,EAAE,IAAI,CAAC,MAAM;gBACtB,cAAc,EAAE,WAAW,CAAC,IAAI;gBAChC,gBAAgB,EAAE,aAAa,CAAC,IAAI;gBACpC,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;aACzD,CAAC;SACH,CAAC;IACJ,CAAC;CACF;AA1CD,oDA0CC"}

package/dist/tools/docs/doc-check-links.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class DocCheckLinksTool extends ToolBase {
+    readonly name = "docCheckLinks";
+    readonly description = "Check all links in documentation files. Finds broken links, missing references, and stale file paths.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=doc-check-links.tool.d.ts.map

package/dist/tools/docs/doc-check-links.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-check-links.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/doc-check-links.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,2GAA2G;IAC/H,SAAkB,QAAQ,QAAQ;;IAQ5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmC3F"}

package/dist/tools/docs/doc-check-links.tool.js

@@ -0,0 +1,88 @@
+"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.DocCheckLinksTool = void 0;
+const zod_1 = require("zod");
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const tool_base_class_1 = require("../base/tool-base.class");
+const explorer_1 = require("../../libs/codebase/indexer/explorer");
+class DocCheckLinksTool extends tool_base_class_1.ToolBase {
+    name = "docCheckLinks";
+    description = "Check all links in documentation files. Finds broken links, missing references, and stale file paths.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const rootPath = input.projectPath ?? process.cwd();
+        const explorer = new explorer_1.CodebaseExplorer();
+        const docFiles = explorer.explore({ rootPath }).filter(f => f.classification === "documentation");
+        const allPaths = new Set(explorer.explore({ rootPath }).map(f => f.relativePath));
+        const broken = [];
+        for (const doc of docFiles) {
+            const content = fs.readFileSync(doc.absolutePath, "utf8");
+            const links = content.match(/\[([^\]]+)\]\(([^)]+)\)/g) ?? [];
+            for (const link of links) {
+                const match = link.match(/\]\(([^)]+)\)/);
+                if (!match)
+                    continue;
+                const target = match[1];
+                if (target.startsWith("http") || target.startsWith("#"))
+                    continue;
+                const cleanTarget = target.split("#")[0].split("?")[0];
+                const absoluteTarget = cleanTarget.startsWith("/")
+                    ? cleanTarget.slice(1)
+                    : path.join(path.dirname(doc.relativePath), cleanTarget);
+                const normalized = absoluteTarget.replace(/\\/g, "/").replace(/^\.\//, "");
+                if (!allPaths.has(normalized) && !allPaths.has(normalized + ".md")) {
+                    broken.push({ doc: doc.relativePath, link: target, status: "broken" });
+                }
+            }
+        }
+        return {
+            success: true,
+            output: JSON.stringify({
+                docsScanned: docFiles.length,
+                brokenLinks: broken.length,
+                brokenDetails: broken.slice(0, 20),
+            }),
+        };
+    }
+}
+exports.DocCheckLinksTool = DocCheckLinksTool;
+//# sourceMappingURL=doc-check-links.tool.js.map

package/dist/tools/docs/doc-check-links.tool.js.map

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

package/dist/tools/docs/doc-gen-adr.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class DocGenAdrTool extends ToolBase {
+    readonly name = "docGenAdr";
+    readonly description = "Generate an Architecture Decision Record (ADR) from a decision description. Creates templated ADR with context, decision, consequences.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=doc-gen-adr.tool.d.ts.map

package/dist/tools/docs/doc-gen-adr.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-adr.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-adr.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,6IAA6I;IACjK,SAAkB,QAAQ,QAAQ;;IAW5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAK3F"}

package/dist/tools/docs/doc-gen-adr.tool.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocGenAdrTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class DocGenAdrTool extends tool_base_class_1.ToolBase {
+    name = "docGenAdr";
+    description = "Generate an Architecture Decision Record (ADR) from a decision description. Creates templated ADR with context, decision, consequences.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            title: zod_1.z.string(),
+            context: zod_1.z.string(),
+            decision: zod_1.z.string(),
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const { title, context, decision } = input;
+        const adr = `# ADR: ${title}\n\n## Status\nProposed\n\n## Context\n${context}\n\n## Decision\n${decision}\n\n## Consequences\n- To be evaluated`;
+        return { success: true, output: adr };
+    }
+}
+exports.DocGenAdrTool = DocGenAdrTool;
+//# sourceMappingURL=doc-gen-adr.tool.js.map

package/dist/tools/docs/doc-gen-adr.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-adr.tool.js","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-adr.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAGnD,MAAa,aAAc,SAAQ,0BAAQ;IAChC,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,yIAAyI,CAAC;IAC/I,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;YACnB,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;YACpB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,KAA6D,CAAC;QACnG,MAAM,GAAG,GAAG,UAAU,KAAK,0CAA0C,OAAO,oBAAoB,QAAQ,wCAAwC,CAAC;QACjJ,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;CACF;AAnBD,sCAmBC"}

package/dist/tools/docs/doc-gen-api.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class DocGenApiTool extends ToolBase {
+    readonly name = "docGenApi";
+    readonly description = "Generate API documentation from source code. Extracts endpoints, parameters, responses, and schemas.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=doc-gen-api.tool.d.ts.map

package/dist/tools/docs/doc-gen-api.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-api.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-api.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,0GAA0G;IAC9H,SAAkB,QAAQ,QAAQ;;IAS5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoD3F"}

package/dist/tools/docs/doc-gen-api.tool.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocGenApiTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class DocGenApiTool extends tool_base_class_1.ToolBase {
+    name = "docGenApi";
+    description = "Generate API documentation from source code. Extracts endpoints, parameters, responses, and schemas.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            target: zod_1.z.string().optional(),
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const target = input.target ?? "api";
+        const openApiSpec = {
+            openapi: "3.0.3",
+            info: {
+                title: `${target} API`,
+                version: "1.0.0",
+                description: `Auto-generated API documentation for ${target}`,
+            },
+            servers: [{ url: "http://localhost:3000", description: "Local development" }],
+            paths: {
+                [`/${target}`]: {
+                    get: {
+                        summary: `List ${target} resources`,
+                        parameters: [
+                            { name: "limit", in: "query", schema: { type: "integer" } },
+                            { name: "offset", in: "query", schema: { type: "integer" } },
+                        ],
+                        responses: {
+                            "200": { description: "Successful response", content: { "application/json": { schema: { type: "array" } } } },
+                        },
+                    },
+                    post: {
+                        summary: `Create a new ${target} resource`,
+                        requestBody: { required: true, content: { "application/json": { schema: { type: "object" } } } },
+                        responses: {
+                            "201": { description: "Resource created" },
+                            "400": { description: "Validation error" },
+                        },
+                    },
+                },
+                [`/${target}/{id}`]: {
+                    get: {
+                        summary: `Get ${target} by ID`,
+                        parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                        responses: { "200": { description: "Resource found" }, "404": { description: "Not found" } },
+                    },
+                    put: {
+                        summary: `Update ${target} by ID`,
+                        parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                        responses: { "200": { description: "Resource updated" } },
+                    },
+                    delete: {
+                        summary: `Delete ${target} by ID`,
+                        parameters: [{ name: "id", in: "path", required: true, schema: { type: "string" } }],
+                        responses: { "200": { description: "Resource deleted" }, "404": { description: "Not found" } },
+                    },
+                },
+            },
+        };
+        return { success: true, output: JSON.stringify(openApiSpec, null, 2) };
+    }
+}
+exports.DocGenApiTool = DocGenApiTool;
+//# sourceMappingURL=doc-gen-api.tool.js.map

package/dist/tools/docs/doc-gen-api.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-api.tool.js","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-api.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAGnD,MAAa,aAAc,SAAQ,0BAAQ;IAChC,IAAI,GAAG,WAAW,CAAC;IACnB,WAAW,GAAG,sGAAsG,CAAC;IAC5G,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,MAAM,GAAI,KAAK,CAAC,MAAiB,IAAI,KAAK,CAAC;QACjD,MAAM,WAAW,GAAG;YAClB,OAAO,EAAE,OAAO;YAChB,IAAI,EAAE;gBACJ,KAAK,EAAE,GAAG,MAAM,MAAM;gBACtB,OAAO,EAAE,OAAO;gBAChB,WAAW,EAAE,wCAAwC,MAAM,EAAE;aAC9D;YACD,OAAO,EAAE,CAAC,EAAE,GAAG,EAAE,uBAAuB,EAAE,WAAW,EAAE,mBAAmB,EAAE,CAAC;YAC7E,KAAK,EAAE;gBACL,CAAC,IAAI,MAAM,EAAE,CAAC,EAAE;oBACd,GAAG,EAAE;wBACH,OAAO,EAAE,QAAQ,MAAM,YAAY;wBACnC,UAAU,EAAE;4BACV,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;4BAC3D,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE;yBAC7D;wBACD,SAAS,EAAE;4BACT,KAAK,EAAE,EAAE,WAAW,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE;yBAC9G;qBACF;oBACD,IAAI,EAAE;wBACJ,OAAO,EAAE,gBAAgB,MAAM,WAAW;wBAC1C,WAAW,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,kBAAkB,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;wBAChG,SAAS,EAAE;4BACT,KAAK,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE;4BAC1C,KAAK,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE;yBAC3C;qBACF;iBACF;gBACD,CAAC,IAAI,MAAM,OAAO,CAAC,EAAE;oBACnB,GAAG,EAAE;wBACH,OAAO,EAAE,OAAO,MAAM,QAAQ;wBAC9B,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;wBACpF,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,gBAAgB,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE;qBAC7F;oBACD,GAAG,EAAE;wBACH,OAAO,EAAE,UAAU,MAAM,QAAQ;wBACjC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;wBACpF,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE;qBAC1D;oBACD,MAAM,EAAE;wBACN,OAAO,EAAE,UAAU,MAAM,QAAQ;wBACjC,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,CAAC;wBACpF,SAAS,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE;qBAC/F;iBACF;aACF;SACF,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC;CACF;AAhED,sCAgEC"}

package/dist/tools/docs/doc-gen-diagrams.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class DocGenDiagramsTool extends ToolBase {
+    readonly name = "docGenDiagrams";
+    readonly description = "Generate Mermaid diagrams: sequence diagrams, ERD, flowcharts, class diagrams, and architecture diagrams from code structure.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=doc-gen-diagrams.tool.d.ts.map

package/dist/tools/docs/doc-gen-diagrams.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-diagrams.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-diagrams.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,kBAAmB,SAAQ,QAAQ;IAC9C,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,mIAAmI;IACvJ,SAAkB,QAAQ,QAAQ;;IAU5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAY3F"}

package/dist/tools/docs/doc-gen-diagrams.tool.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocGenDiagramsTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class DocGenDiagramsTool extends tool_base_class_1.ToolBase {
+    name = "docGenDiagrams";
+    description = "Generate Mermaid diagrams: sequence diagrams, ERD, flowcharts, class diagrams, and architecture diagrams from code structure.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            type: zod_1.z.enum(["sequence", "erd", "flowchart", "class", "architecture", "component"]),
+            context: zod_1.z.string().optional(),
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const { type, context } = input;
+        const examples = {
+            sequence: "sequenceDiagram\n  participant Client\n  participant Server\n  Client->>Server: Request\n  Server-->>Client: Response",
+            erd: "erDiagram\n  USER ||--o{ ORDER : places\n  ORDER ||--|{ LINE_ITEM : contains",
+            flowchart: "flowchart TD\n  A[Start] --> B{Decision}\n  B --> C[Result]",
+            class: "classDiagram\n  class Animal {\n    +name: string\n    +speak(): void\n  }",
+            architecture: "graph TD\n  Frontend --> API\n  API --> Database\n  API --> Cache",
+            component: "graph LR\n  subgraph Frontend\n    UI\n  end\n  subgraph Backend\n    API\n  end\n  UI --> API",
+        };
+        return { success: true, output: examples[type] ?? "graph TD\n  A-->B" };
+    }
+}
+exports.DocGenDiagramsTool = DocGenDiagramsTool;
+//# sourceMappingURL=doc-gen-diagrams.tool.js.map

package/dist/tools/docs/doc-gen-diagrams.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-diagrams.tool.js","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-diagrams.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAGnD,MAAa,kBAAmB,SAAQ,0BAAQ;IACrC,IAAI,GAAG,gBAAgB,CAAC;IACxB,WAAW,GAAG,+HAA+H,CAAC;IACrI,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;YACpF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC9B,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,KAA2C,CAAC;QACtE,MAAM,QAAQ,GAA2B;YACvC,QAAQ,EAAE,uHAAuH;YACjI,GAAG,EAAE,8EAA8E;YACnF,SAAS,EAAE,6DAA6D;YACxE,KAAK,EAAE,4EAA4E;YACnF,YAAY,EAAE,mEAAmE;YACjF,SAAS,EAAE,gGAAgG;SAC5G,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,mBAAmB,EAAE,CAAC;IAC1E,CAAC;CACF;AAzBD,gDAyBC"}

package/dist/tools/docs/doc-gen-readme.tool.d.ts

@@ -0,0 +1,10 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class DocGenReadmeTool extends ToolBase {
+    readonly name = "docGenReadme";
+    readonly description = "Generate or update README.md from codebase analysis. Extracts tech stack, architecture, setup instructions, and project structure.";
+    readonly readonly = true;
+    constructor();
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=doc-gen-readme.tool.d.ts.map

package/dist/tools/docs/doc-gen-readme.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-readme.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-readme.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEnE,qBAAa,gBAAiB,SAAQ,QAAQ;IAC5C,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,QAAQ,CAAC,WAAW,wIAAwI;IAC5J,SAAkB,QAAQ,QAAQ;;IAQ5B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsD3F"}

package/dist/tools/docs/doc-gen-readme.tool.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocGenReadmeTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class DocGenReadmeTool extends tool_base_class_1.ToolBase {
+    name = "docGenReadme";
+    description = "Generate or update README.md from codebase analysis. Extracts tech stack, architecture, setup instructions, and project structure.";
+    readonly = true;
+    constructor() {
+        super(zod_1.z.object({
+            projectPath: zod_1.z.string().optional(),
+        }));
+    }
+    async run(input, _ctx) {
+        const projectPath = input.projectPath ?? ".";
+        const readme = [
+            `# ${projectPath.split("/").pop() ?? "Project"}`,
+            ``,
+            `## Overview`,
+            `Brief description of the project purpose and goals.`,
+            ``,
+            `## Tech Stack`,
+            `- **Runtime**: Node.js`,
+            `- **Language**: TypeScript`,
+            `- **Framework**: (auto-detected from package.json)`,
+            ``,
+            `## Architecture`,
+            `High-level architecture diagram and folder structure:`,
+            ``,
+            `\`\`\``,
+            `src/`,
+            `  contracts/     – Shared type definitions`,
+            `  tools/         – AI tool implementations`,
+            `  libs/          – Shared libraries`,
+            `\`\`\``,
+            ``,
+            `## Getting Started`,
+            ``,
+            `### Prerequisites`,
+            `- Node.js >= 18`,
+            `- npm >= 9`,
+            ``,
+            `### Installation`,
+            `\`\`\`bash`,
+            `npm install`,
+            `\`\`\``,
+            ``,
+            `### Development`,
+            `\`\`\`bash`,
+            `npm run build`,
+            `npm test`,
+            `\`\`\``,
+            ``,
+            `## Project Structure`,
+            `Key directories and their purpose:`,
+            `- \`src/contracts/\` — Type definitions and interfaces`,
+            `- \`src/tools/\` — Pluggable AI tools (testing, docs, devops, etc.)`,
+            `- \`src/libs/\` — Shared utility libraries`,
+            ``,
+            `## Contributing`,
+            `See CONTRIBUTING.md for contribution guidelines.`,
+        ].join("\n");
+        return {
+            success: true,
+            output: readme,
+        };
+    }
+}
+exports.DocGenReadmeTool = DocGenReadmeTool;
+//# sourceMappingURL=doc-gen-readme.tool.js.map

package/dist/tools/docs/doc-gen-readme.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-gen-readme.tool.js","sourceRoot":"","sources":["../../../src/tools/docs/doc-gen-readme.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAGnD,MAAa,gBAAiB,SAAQ,0BAAQ;IACnC,IAAI,GAAG,cAAc,CAAC;IACtB,WAAW,GAAG,oIAAoI,CAAC;IAC1I,QAAQ,GAAG,IAAI,CAAC;IAElC;QACE,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,WAAW,GAAI,KAAK,CAAC,WAAsB,IAAI,GAAG,CAAC;QACzD,MAAM,MAAM,GAAG;YACb,KAAK,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,SAAS,EAAE;YAChD,EAAE;YACF,aAAa;YACb,qDAAqD;YACrD,EAAE;YACF,eAAe;YACf,wBAAwB;YACxB,4BAA4B;YAC5B,oDAAoD;YACpD,EAAE;YACF,iBAAiB;YACjB,uDAAuD;YACvD,EAAE;YACF,QAAQ;YACR,MAAM;YACN,4CAA4C;YAC5C,4CAA4C;YAC5C,qCAAqC;YACrC,QAAQ;YACR,EAAE;YACF,oBAAoB;YACpB,EAAE;YACF,mBAAmB;YACnB,iBAAiB;YACjB,YAAY;YACZ,EAAE;YACF,kBAAkB;YAClB,YAAY;YACZ,aAAa;YACb,QAAQ;YACR,EAAE;YACF,iBAAiB;YACjB,YAAY;YACZ,eAAe;YACf,UAAU;YACV,QAAQ;YACR,EAAE;YACF,sBAAsB;YACtB,oCAAoC;YACpC,wDAAwD;YACxD,qEAAqE;YACrE,4CAA4C;YAC5C,EAAE;YACF,iBAAiB;YACjB,kDAAkD;SACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,MAAM;SACf,CAAC;IACJ,CAAC;CACF;AAjED,4CAiEC"}

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

@@ -0,0 +1,8 @@
+export * from "./doc-gen-readme.tool";
+export * from "./doc-gen-api.tool";
+export * from "./doc-gen-adr.tool";
+export * from "./doc-gen-diagrams.tool";
+export * from "./doc-check-links.tool";
+export * from "./doc-check-coverage.tool";
+export * from "./api-client.tool";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/docs/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC"}

package/dist/tools/docs/index.js

@@ -0,0 +1,24 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./doc-gen-readme.tool"), exports);
+__exportStar(require("./doc-gen-api.tool"), exports);
+__exportStar(require("./doc-gen-adr.tool"), exports);
+__exportStar(require("./doc-gen-diagrams.tool"), exports);
+__exportStar(require("./doc-check-links.tool"), exports);
+__exportStar(require("./doc-check-coverage.tool"), exports);
+__exportStar(require("./api-client.tool"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/docs/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,qDAAmC;AACnC,qDAAmC;AACnC,0DAAwC;AACxC,yDAAuC;AACvC,4DAA0C;AAC1C,oDAAkC"}

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

@@ -0,0 +1,7 @@
+export * from "./memory-save.tool";
+export * from "./memory-recall.tool";
+export * from "./memory-lessons.tool";
+export * from "./memory-patterns.tool";
+export * from "./memory-context.tool";
+export * from "../../contracts/memory.types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,8BAA8B,CAAC"}

package/dist/tools/memory/index.js

@@ -0,0 +1,23 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./memory-save.tool"), exports);
+__exportStar(require("./memory-recall.tool"), exports);
+__exportStar(require("./memory-lessons.tool"), exports);
+__exportStar(require("./memory-patterns.tool"), exports);
+__exportStar(require("./memory-context.tool"), exports);
+__exportStar(require("../../contracts/memory.types"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/memory/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,qDAAmC;AACnC,uDAAqC;AACrC,wDAAsC;AACtC,yDAAuC;AACvC,wDAAsC;AACtC,+DAA6C"}

package/dist/tools/memory/memory-context.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult, IStorageAdapter } from "../../contracts";
+import { MemoryEntry } from "../../contracts/memory.types";
+export declare class MemoryContextTool extends ToolBase {
+    readonly name = "memoryContext";
+    readonly description = "Auto-build context from session history. Aggregates relevant knowledge, decisions, and patterns for the current task.";
+    readonly readonly = true;
+    private memoryStorage;
+    constructor(storage?: IStorageAdapter<MemoryEntry>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=memory-context.tool.d.ts.map

package/dist/tools/memory/memory-context.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-context.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/memory-context.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,2HAA2H;IAC/I,SAAkB,QAAQ,QAAQ;IAClC,OAAO,CAAC,aAAa,CAA+B;gBAExC,OAAO,CAAC,EAAE,eAAe,CAAC,WAAW,CAAC;IAK5C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAO3F"}

package/dist/tools/memory/memory-context.tool.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryContextTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const storage_1 = require("../../storage");
+class MemoryContextTool extends tool_base_class_1.ToolBase {
+    name = "memoryContext";
+    description = "Auto-build context from session history. Aggregates relevant knowledge, decisions, and patterns for the current task.";
+    readonly = true;
+    memoryStorage;
+    constructor(storage) {
+        super(zod_1.z.object({ task: zod_1.z.string() }));
+        this.memoryStorage = storage ?? new storage_1.InMemoryAdapter();
+    }
+    async run(input, _ctx) {
+        const { task } = input;
+        const tokenized = task.toLowerCase().split(/\s+/).slice(0, 10);
+        const allFacts = await this.memoryStorage.list({});
+        const relevantFacts = allFacts.filter(f => tokenized.some(t => f.fact.toLowerCase().includes(t))).slice(0, 5);
+        return { success: true, output: JSON.stringify({ task, relevantFactCount: relevantFacts.length, facts: relevantFacts.map(f => f.fact.slice(0, 200)) }) };
+    }
+}
+exports.MemoryContextTool = MemoryContextTool;
+//# sourceMappingURL=memory-context.tool.js.map

package/dist/tools/memory/memory-context.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-context.tool.js","sourceRoot":"","sources":["../../../src/tools/memory/memory-context.tool.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,6DAAmD;AAEnD,2CAAgD;AAGhD,MAAa,iBAAkB,SAAQ,0BAAQ;IACpC,IAAI,GAAG,eAAe,CAAC;IACvB,WAAW,GAAG,uHAAuH,CAAC;IAC7H,QAAQ,GAAG,IAAI,CAAC;IAC1B,aAAa,CAA+B;IAEpD,YAAY,OAAsC;QAChD,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,aAAa,GAAG,OAAO,IAAI,IAAI,yBAAe,EAAe,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,IAAI,EAAE,GAAG,KAAyB,CAAC;QAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9G,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAC3J,CAAC;CACF;AAlBD,8CAkBC"}

package/dist/tools/memory/memory-lessons.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult, IStorageAdapter } from "../../contracts";
+import { MemoryLesson } from "../../contracts/memory.types";
+export declare class MemoryLessonsTool extends ToolBase {
+    readonly name = "memoryLessons";
+    readonly description = "Store and recall lessons learned from completed tasks.";
+    readonly readonly = false;
+    private storage;
+    constructor(storage?: IStorageAdapter<MemoryLesson>);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=memory-lessons.tool.d.ts.map

package/dist/tools/memory/memory-lessons.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-lessons.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/memory/memory-lessons.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,QAAQ,CAAC,IAAI,mBAAmB;IAChC,QAAQ,CAAC,WAAW,4DAA4D;IAChF,SAAkB,QAAQ,SAAS;IACnC,OAAO,CAAC,OAAO,CAAgC;gBAEnC,OAAO,CAAC,EAAE,eAAe,CAAC,YAAY,CAAC;IAK7C,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAY3F"}