@thoughtflow/core 0.1.2

package/dist/tools/workspace/docker.tool.js

@@ -0,0 +1,235 @@
+"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.DockerTool = void 0;
+const zod_1 = require("zod");
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const tool_base_class_1 = require("../base/tool-base.class");
+const execAsync = (0, util_1.promisify)(child_process_1.exec);
+const DOCKER_ACTIONS = [
+    "ps",
+    "logs",
+    "exec",
+    "run",
+    "build",
+    "compose_ps",
+    "compose_up",
+    "compose_down",
+];
+/** Destructive operations that are never allowed. */
+const BLACKLISTED_FRAGMENTS = [
+    "system prune",
+    "volume rm",
+    "volume prune",
+    "image prune",
+    "container prune",
+    "network prune",
+    "--all", // e.g. `docker system prune --all`
+    "-a", // combined with prune patterns
+];
+function isBlacklisted(fragment) {
+    const lower = fragment.toLowerCase();
+    return BLACKLISTED_FRAGMENTS.some(b => lower.includes(b.toLowerCase()));
+}
+const READ_ONLY_DOCKER_ACTIONS = new Set(["ps", "logs", "compose_ps"]);
+class DockerTool extends tool_base_class_1.ToolBase {
+    name = "docker";
+    description = "Interact with Docker or Podman containers. " +
+        "Read: ps (list containers), logs (show container logs), compose_ps (list compose services). " +
+        "Execute: exec (run command inside container), run (start a one-off container). " +
+        "Build/deploy: build (build image), compose_up (start services), compose_down (stop services). " +
+        "Auto-detects podman vs docker unless overridden in config.";
+    readonly = false;
+    /** ps/logs/compose_ps are read-only; exec/run/build/compose_up/compose_down mutate state. */
+    isReadOnly(input) {
+        return READ_ONLY_DOCKER_ACTIONS.has(input["action"] ?? "");
+    }
+    cfg;
+    rootDir;
+    resolvedBinary = null;
+    constructor(rootDir, config = {}) {
+        super(zod_1.z.object({
+            action: zod_1.z
+                .enum(DOCKER_ACTIONS)
+                .describe("Action: ps | logs | exec | run | build | compose_ps | compose_up | compose_down"),
+            container: zod_1.z
+                .string()
+                .optional()
+                .describe("Container name or ID. Required for: logs, exec. Optional for: run (image name)."),
+            command: zod_1.z
+                .string()
+                .optional()
+                .describe("Command to run inside container (exec), or image + args for run. " +
+                "For build: optional build args. For compose_up/compose_down: optional service names."),
+            tail: zod_1.z
+                .number()
+                .optional()
+                .describe("Lines to tail for 'logs' action (default 100)."),
+            detach: zod_1.z
+                .boolean()
+                .optional()
+                .describe("For 'run': run in detached mode (default true)."),
+            noCache: zod_1.z
+                .boolean()
+                .optional()
+                .describe("For 'build': pass --no-cache (default false)."),
+            tag: zod_1.z
+                .string()
+                .optional()
+                .describe("For 'build': image tag, e.g. myapp:latest."),
+        }));
+        this.rootDir = rootDir;
+        this.cfg = config;
+    }
+    // ── Binary resolution ──────────────────────────────────────────────────────
+    async getBinary() {
+        if (this.resolvedBinary)
+            return this.resolvedBinary;
+        if (this.cfg.binary) {
+            this.resolvedBinary = this.cfg.binary;
+            return this.resolvedBinary;
+        }
+        // Auto-detect: prefer podman
+        try {
+            await execAsync("podman --version", { cwd: this.rootDir });
+            this.resolvedBinary = "podman";
+            return "podman";
+        }
+        catch {
+            this.resolvedBinary = "docker";
+            return "docker";
+        }
+    }
+    // ── run() ─────────────────────────────────────────────────────────────────
+    async run(input, _ctx) {
+        const { action, container, command, tail, detach, noCache, tag } = input;
+        // Blacklist check on any user-supplied string arguments
+        for (const userArg of [container, command, tag].filter(Boolean)) {
+            if (isBlacklisted(userArg)) {
+                return { success: false, error: `DockerTool: Blocked dangerous argument: "${userArg}"` };
+            }
+            // Prevent shell injection (covers $() command substitution, backticks, and other metacharacters)
+            if (/[;&|`$()]/.test(userArg)) {
+                return { success: false, error: `DockerTool: Shell metacharacters not allowed in args.` };
+            }
+        }
+        const bin = await this.getBinary();
+        const composeDir = this.cfg.composeDir
+            ? path.resolve(this.rootDir, this.cfg.composeDir)
+            : this.rootDir;
+        let cmd;
+        switch (action) {
+            // ── Read-only ────────────────────────────────────────────────────────
+            case "ps":
+                cmd = `${bin} ps --format "table {{.Names}}\\t{{.Status}}\\t{{.Ports}}"`;
+                break;
+            case "logs":
+                if (!container?.trim()) {
+                    return { success: false, error: "logs requires container name" };
+                }
+                cmd = `${bin} logs ${JSON.stringify(container)} --tail ${tail ?? 100}`;
+                break;
+            case "compose_ps":
+                cmd = `${bin} compose ps`;
+                break;
+            // ── Mutating ─────────────────────────────────────────────────────────
+            case "exec":
+                if (!container?.trim())
+                    return { success: false, error: "exec requires container name" };
+                if (!command?.trim())
+                    return { success: false, error: "exec requires a command" };
+                cmd = `${bin} exec ${JSON.stringify(container)} sh -c ${JSON.stringify(command)}`;
+                break;
+            case "run": {
+                if (!container?.trim())
+                    return { success: false, error: "run requires image name in 'container'" };
+                if (command && /[^\w\s\-_./=:@]/.test(command)) {
+                    return { success: false, error: "DockerTool: Command contains unsafe characters." };
+                }
+                const runFlags = detach !== false ? "-d" : "";
+                const extraCmd = command?.trim() ? ` ${command}` : "";
+                cmd = `${bin} run --rm ${runFlags} ${JSON.stringify(container)}${extraCmd}`.trim();
+                break;
+            }
+            case "build": {
+                if (command && /[^\w\s\-_./=:@]/.test(command)) {
+                    return { success: false, error: "DockerTool: Command contains unsafe characters." };
+                }
+                const tagFlag = tag?.trim() ? ` -t ${JSON.stringify(tag)}` : "";
+                const cacheFlag = noCache ? " --no-cache" : "";
+                const buildArgs = command?.trim() ? ` ${command}` : "";
+                cmd = `${bin} build${tagFlag}${cacheFlag}${buildArgs} .`;
+                break;
+            }
+            case "compose_up": {
+                if (command && /[^\w\s\-_./=:@]/.test(command)) {
+                    return { success: false, error: "DockerTool: Command contains unsafe characters." };
+                }
+                const services = command?.trim() ? ` ${command}` : "";
+                cmd = `${bin} compose up -d${services}`;
+                break;
+            }
+            case "compose_down": {
+                if (command && /[^\w\s\-_./=:@]/.test(command)) {
+                    return { success: false, error: "DockerTool: Command contains unsafe characters." };
+                }
+                const services = command?.trim() ? ` ${command}` : "";
+                cmd = `${bin} compose down${services}`;
+                break;
+            }
+        }
+        try {
+            const { stdout, stderr } = await execAsync(cmd, {
+                cwd: ["compose_ps", "compose_up", "compose_down"].includes(action) ? composeDir : this.rootDir,
+                maxBuffer: 1024 * 1024,
+            });
+            const out = [stdout, stderr].filter(s => s?.trim()).join("\n").trim();
+            return { success: true, output: out || "(no output)" };
+        }
+        catch (err) {
+            const e = err;
+            const combined = [e.stdout, e.stderr].filter(s => s?.trim()).join("\n").trim();
+            return {
+                success: false,
+                error: combined || e.message || `exit code ${e.code}`,
+                output: combined || "",
+            };
+        }
+    }
+}
+exports.DockerTool = DockerTool;
+//# sourceMappingURL=docker.tool.js.map

package/dist/tools/workspace/docker.tool.js.map

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

package/dist/tools/workspace/edit-file.tool.d.ts

@@ -0,0 +1,32 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+/**
+ * EditFileTool — surgical find-and-replace without rewriting the whole file.
+ *
+ * Supports two block formats: batch-write blocks and inline patches.
+ *
+ * SEARCH/REPLACE — exact text replacement (preferred):
+ *   <<<<<<< SEARCH
+ *   exact old content (include 3+ surrounding lines for uniqueness)
+ *   =======
+ *   exact new content
+ *   >>>>>>> REPLACE
+ *
+ * LINE_RANGE — replace by line numbers (when exact match is fragile):
+ *   <<<<<<< LINES 12-18
+ *   new content replacing those lines
+ *   >>>>>>> REPLACE
+ *
+ * Multiple blocks apply atomically in order.
+ */
+export declare class EditFileTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "editFile";
+    readonly readonly = false;
+    readonly description: string;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private parseBlocks;
+    private countOccurrences;
+}
+//# sourceMappingURL=edit-file.tool.d.ts.map

package/dist/tools/workspace/edit-file.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edit-file.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/edit-file.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,YAAa,SAAQ,QAAQ;IAmB5B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAlBpC,QAAQ,CAAC,IAAI,cAAc;IAC3B,SAAkB,QAAQ,SAAS;IACnC,QAAQ,CAAC,WAAW,SAcuD;gBAE9C,OAAO,EAAE,MAAM;IAOtC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2E1F,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,gBAAgB;CASzB"}

package/dist/tools/workspace/edit-file.tool.js

@@ -0,0 +1,172 @@
+"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.EditFileTool = void 0;
+const zod_1 = require("zod");
+const fs = __importStar(require("fs"));
+const tool_base_class_1 = require("../base/tool-base.class");
+const path_utils_1 = require("../base/path-utils");
+/**
+ * EditFileTool — surgical find-and-replace without rewriting the whole file.
+ *
+ * Supports two block formats: batch-write blocks and inline patches.
+ *
+ * SEARCH/REPLACE — exact text replacement (preferred):
+ *   <<<<<<< SEARCH
+ *   exact old content (include 3+ surrounding lines for uniqueness)
+ *   =======
+ *   exact new content
+ *   >>>>>>> REPLACE
+ *
+ * LINE_RANGE — replace by line numbers (when exact match is fragile):
+ *   <<<<<<< LINES 12-18
+ *   new content replacing those lines
+ *   >>>>>>> REPLACE
+ *
+ * Multiple blocks apply atomically in order.
+ */
+class EditFileTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "editFile";
+    readonly = false;
+    description = "Edit an existing file using SEARCH/REPLACE or LINE_RANGE blocks — code is written as plain text, no JSON escaping needed.\n" +
+        "Use for: any modification to existing files (fix bugs, add features, refactor).\n" +
+        "Use batch_write_files only for scaffolding brand-new files.\n\n" +
+        "SEARCH/REPLACE block (exact text replacement — preferred):\n" +
+        "<<<<<<< SEARCH\n" +
+        "exact old content (include 3+ surrounding lines for uniqueness)\n" +
+        "=======\n" +
+        "exact new content\n" +
+        ">>>>>>> REPLACE\n\n" +
+        "LINE_RANGE block (line-number replacement):\n" +
+        "<<<<<<< LINES start-end\n" +
+        "new content replacing those lines\n" +
+        ">>>>>>> REPLACE\n\n" +
+        "Rules: multiple blocks apply in order; SEARCH must match exactly once.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            path: zod_1.z.string().describe("File path relative to project root, e.g. src/services/auth.service.ts"),
+            blocks: zod_1.z.string().describe("One or more SEARCH/REPLACE or LINE_RANGE blocks"),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const { path: relPath, blocks } = input;
+        const fullPath = (0, path_utils_1.resolveSafePath)(this.rootDir, relPath);
+        if (!fullPath) {
+            return { success: false, error: "Path traversal not allowed." };
+        }
+        if (!fs.existsSync(fullPath)) {
+            return { success: false, error: `File not found: ${relPath}. Use write_file to create new files.` };
+        }
+        let content = fs.readFileSync(fullPath, "utf8");
+        const parsed = this.parseBlocks(blocks);
+        if (parsed.length === 0) {
+            return { success: false, error: "No valid SEARCH/REPLACE or LINE_RANGE blocks found in input." };
+        }
+        const appliedBlocks = [];
+        const errors = [];
+        for (const block of parsed) {
+            if (block.type === "search_replace") {
+                const occurrences = this.countOccurrences(content, block.search);
+                if (occurrences === 0) {
+                    errors.push(`SEARCH block not found in ${relPath}:\n  "${block.search.slice(0, 80).replace(/\n/g, "↵")}"`);
+                    continue;
+                }
+                if (occurrences > 1) {
+                    errors.push(`SEARCH block matches ${occurrences} locations in ${relPath} — add more context to make it unique.`);
+                    continue;
+                }
+                content = content.replace(block.search, block.replace);
+                const diff = `<<<<<<< SEARCH\n${block.search}\n=======\n${block.replace}\n>>>>>>>`;
+                appliedBlocks.push({
+                    summary: `SEARCH/REPLACE (${block.search.split("\n").length} → ${block.replace.split("\n").length} lines)`,
+                    diff,
+                });
+            }
+            else if (block.type === "line_range") {
+                const lines = content.split("\n");
+                const start = block.start - 1; // 0-based
+                const end = block.end; // exclusive
+                if (start < 0 || end > lines.length || start >= end) {
+                    errors.push(`LINE_RANGE ${block.start}-${block.end} is out of bounds (file has ${lines.length} lines).`);
+                    continue;
+                }
+                lines.splice(start, end - start, ...block.replace.split("\n"));
+                content = lines.join("\n");
+                appliedBlocks.push({
+                    summary: `LINES ${block.start}-${block.end} replaced`,
+                    diff: `<<<<<<< LINES ${block.start}-${block.end}\n${block.replace}\n>>>>>>>`,
+                });
+            }
+        }
+        if (errors.length > 0 && appliedBlocks.length === 0) {
+            return { success: false, error: errors.join("\n") };
+        }
+        fs.writeFileSync(fullPath, content, "utf8");
+        const summary = appliedBlocks.map(b => `  ✓ ${b.summary}\n${b.diff}`).join("\n");
+        const warn = errors.length ? `\n\nWarnings:\n${errors.map(e => `  ⚠ ${e}`).join("\n")}` : "";
+        return {
+            success: true,
+            output: `Edited ${relPath} — ${appliedBlocks.length} block(s) applied:\n${summary}${warn}`,
+        };
+    }
+    // ── Block parser ──────────────────────────────────────────────────────────
+    parseBlocks(input) {
+        const blocks = [];
+        // Match all block pairs — tolerate 3-9 marker chars (LLMs often produce 5 or 6 instead of 7)
+        const SEARCH_RE = /<{3,9} SEARCH\n([\s\S]*?)\n?={3,9}\n([\s\S]*?)\n?>{3,9} REPLACE/g;
+        const LINES_RE = /<{3,9} LINES (\d+)-(\d+)\n([\s\S]*?)\n?>{3,9} REPLACE/g;
+        let m;
+        while ((m = SEARCH_RE.exec(input)) !== null) {
+            blocks.push({ type: "search_replace", search: m[1], replace: m[2] });
+        }
+        while ((m = LINES_RE.exec(input)) !== null) {
+            blocks.push({ type: "line_range", start: parseInt(m[1], 10), end: parseInt(m[2], 10), replace: m[3] });
+        }
+        return blocks;
+    }
+    countOccurrences(content, search) {
+        let count = 0;
+        let pos = 0;
+        while ((pos = content.indexOf(search, pos)) !== -1) {
+            count++;
+            pos += search.length;
+        }
+        return count;
+    }
+}
+exports.EditFileTool = EditFileTool;
+//# sourceMappingURL=edit-file.tool.js.map

package/dist/tools/workspace/edit-file.tool.js.map

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

package/dist/tools/workspace/find-files.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class FindFilesTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "findFiles";
+    readonly readonly = true;
+    readonly description: string;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private globMatch;
+}
+//# sourceMappingURL=find-files.tool.d.ts.map

package/dist/tools/workspace/find-files.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-files.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/find-files.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGnE,qBAAa,aAAc,SAAQ,QAAQ;IAQ7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,IAAI,eAAe;IAC5B,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAG+B;gBAEtB,OAAO,EAAE,MAAM;IAOtC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAgD1F,OAAO,CAAC,SAAS;CAiBlB"}

package/dist/tools/workspace/find-files.tool.js

@@ -0,0 +1,120 @@
+"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.FindFilesTool = void 0;
+const zod_1 = require("zod");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const tool_base_class_1 = require("../base/tool-base.class");
+const path_utils_1 = require("../base/path-utils");
+class FindFilesTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "findFiles";
+    readonly = true;
+    description = "Find files by NAME or PATH GLOB. Returns matching file paths. " +
+        "Use when you want to find files whose names match a pattern (e.g. '*.module.ts', 'context*.ts', '**/*.test.ts'). " +
+        "For searching file CONTENTS, use grep instead.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            pattern: zod_1.z.string().describe("Glob pattern for file names/paths, e.g. '*.module.ts', '**/*.test.ts', 'context*.ts'"),
+            path: zod_1.z.string().optional().describe("Subdirectory to search in, relative to project root. Defaults to project root."),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const { pattern, path: subPath = "." } = input;
+        const searchRoot = (0, path_utils_1.resolveSafePath)(this.rootDir, subPath);
+        if (!searchRoot) {
+            return { success: false, error: "Path traversal not allowed." };
+        }
+        if (!fs.existsSync(searchRoot)) {
+            return { success: false, error: `Path not found: ${subPath}. Hint: use list_dir to browse available directories. The path may be inside a sub-project (e.g. backend/, frontend/).` };
+        }
+        const found = [];
+        const walk = (dir) => {
+            if (found.length >= 300)
+                return;
+            let entries;
+            try {
+                entries = fs.readdirSync(dir, { withFileTypes: true });
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (found.length >= 300)
+                    break;
+                const full = path.join(dir, entry.name);
+                const rel = path.relative(this.rootDir, full);
+                if (entry.isDirectory()) {
+                    if (entry.name === "node_modules" || entry.name === "dist" || entry.name === ".git")
+                        continue;
+                    walk(full);
+                }
+                else if (entry.isFile()) {
+                    if (this.globMatch(pattern, rel) || this.globMatch(pattern, entry.name)) {
+                        found.push(rel);
+                    }
+                }
+            }
+        };
+        walk(searchRoot);
+        if (!found.length) {
+            return { success: true, output: `No files matching "${pattern}"${subPath !== "." ? ` in ${subPath}` : ""}.` };
+        }
+        return {
+            success: true,
+            output: `${found.length} file(s) matching "${pattern}":\n\n${found.join("\n")}`,
+        };
+    }
+    globMatch(glob, filePath) {
+        const normGlob = glob.replace(/\\/g, "/");
+        const normPath = filePath.replace(/\\/g, "/");
+        const escaped = normGlob
+            .replace(/[.*+^${}()|[\]\\]/g, "\\$&")
+            .replace(/\\\*\\\*/g, "@@DOUBLESTAR@@")
+            .replace(/\\\*/g, "[^/]*")
+            .replace(/@@DOUBLESTAR@@/g, ".*")
+            .replace(/\?/g, "[^/]");
+        try {
+            return new RegExp(`^${escaped}$`).test(normPath);
+        }
+        catch {
+            return normPath.includes(normGlob);
+        }
+    }
+}
+exports.FindFilesTool = FindFilesTool;
+//# sourceMappingURL=find-files.tool.js.map

package/dist/tools/workspace/find-files.tool.js.map

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

package/dist/tools/workspace/get-task.tool.d.ts

@@ -0,0 +1,12 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+import { TaskDb } from "./list-tasks.tool";
+export declare class GetTaskTool extends ToolBase {
+    private readonly db;
+    readonly name = "getTask";
+    readonly readonly = true;
+    readonly description = "Gets detailed information about a specific task by its ID (e.g. T002).";
+    constructor(db: TaskDb);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=get-task.tool.d.ts.map

package/dist/tools/workspace/get-task.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-task.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/get-task.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,qBAAa,WAAY,SAAQ,QAAQ;IAM3B,OAAO,CAAC,QAAQ,CAAC,EAAE;IAL/B,QAAQ,CAAC,IAAI,aAAa;IAC1B,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,4EACuD;gBAE9C,EAAE,EAAE,MAAM;IAMjC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAa3F"}