@thoughtflow/core 0.1.2

package/dist/tools/workspace/http-request.tool.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpRequestTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+class HttpRequestTool extends tool_base_class_1.ToolBase {
+    name = "httpRequest";
+    description = "Make an HTTP request and return the status code + response body. " +
+        "Use this to test REST API endpoints (GET, POST, PUT, DELETE, PATCH). " +
+        "Returns: status code, response body (truncated at 4000 chars), response time ms.";
+    /** GET requests are read-only; POST/PUT/DELETE/PATCH may mutate server state. */
+    isReadOnly(input) {
+        const method = input["method"] ?? "GET";
+        return method === "GET";
+    }
+    constructor() {
+        super(zod_1.z.object({
+            method: zod_1.z
+                .enum(["GET", "POST", "PUT", "DELETE", "PATCH"])
+                .default("GET")
+                .describe("HTTP method"),
+            url: zod_1.z.string().describe("Full URL, e.g. http://localhost:3333/todos"),
+            body: zod_1.z
+                .union([zod_1.z.string(), zod_1.z.record(zod_1.z.unknown())])
+                .optional()
+                .describe('Request body: pass as JSON string "{\"title\":\"Buy milk\"}" or as object {"title":"Buy milk"}'),
+            headers: zod_1.z
+                .record(zod_1.z.string())
+                .optional()
+                .describe("Optional extra headers as object, e.g. {\"Authorization\": \"Bearer token\"}"),
+        }));
+    }
+    async run(input, _ctx) {
+        const { method, url, body, headers } = input;
+        const httpMethod = method ?? "GET";
+        const t0 = Date.now();
+        // Validate URL scheme
+        if (!url.startsWith("http://") && !url.startsWith("https://")) {
+            return { success: false, error: "URL must start with http:// or https://" };
+        }
+        try {
+            const reqHeaders = {
+                "Content-Type": "application/json",
+                ...(headers ?? {}),
+            };
+            const reqInit = {
+                method: httpMethod,
+                headers: reqHeaders,
+                signal: AbortSignal.timeout(10000),
+            };
+            if (body && ["POST", "PUT", "PATCH"].includes(httpMethod)) {
+                if (typeof body === "object") {
+                    // Body passed as object — serialize to JSON
+                    reqInit.body = JSON.stringify(body);
+                }
+                else {
+                    // Body passed as string — validate JSON
+                    try {
+                        JSON.parse(body);
+                    }
+                    catch {
+                        return { success: false, error: "body is not valid JSON" };
+                    }
+                    reqInit.body = body;
+                }
+            }
+            const response = await fetch(url, reqInit);
+            const ms = Date.now() - t0;
+            let responseText = "";
+            const contentType = response.headers.get("content-type") ?? "";
+            try {
+                responseText = await response.text();
+                // Pretty-print JSON
+                if (contentType.includes("application/json")) {
+                    responseText = JSON.stringify(JSON.parse(responseText), null, 2);
+                }
+            }
+            catch {
+                responseText = "(could not read response body)";
+            }
+            // Truncate large responses
+            const truncated = responseText.length > 4000
+                ? responseText.slice(0, 4000) + `\n...(truncated from ${responseText.length} chars)`
+                : responseText;
+            const ok = response.status >= 200 && response.status < 300;
+            const summary = `${httpMethod} ${url}\n` +
+                `Status: ${response.status} ${response.statusText}  (${ms}ms)\n` +
+                `Body:\n${truncated}`;
+            return { success: ok, output: summary, error: ok ? undefined : `HTTP ${response.status}` };
+        }
+        catch (err) {
+            const ms = Date.now() - t0;
+            const msg = err instanceof Error ? err.message : String(err);
+            return {
+                success: false,
+                error: `Request failed after ${ms}ms: ${msg}`,
+            };
+        }
+    }
+}
+exports.HttpRequestTool = HttpRequestTool;
+//# sourceMappingURL=http-request.tool.js.map

package/dist/tools/workspace/http-request.tool.js.map

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

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

@@ -0,0 +1,29 @@
+export * from "./batch-write-files.tool";
+export * from "./browser.tool";
+export * from "./vision-browser.tool";
+export * from "./list-tasks.tool";
+export * from "./get-task.tool";
+export * from "./search-code.tool";
+export * from "./read-file.tool";
+export * from "./write-file.tool";
+export * from "./edit-file.tool";
+export * from "./multi-file-patch.tool";
+export * from "./run-tsc.tool";
+export * from "./terminal-run.tool";
+export * from "./list-dir.tool";
+export * from "./grep.tool";
+export * from "./find-files.tool";
+export * from "./git.tool";
+export * from "./docker.tool";
+export * from "./process-manager.tool";
+export * from "./http-request.tool";
+export * from "./analyze-project.tool";
+export * from "./project-context.tool";
+export * from "./knowledge.tool";
+export * from "./store.tool";
+export * from "./plan.tool";
+export * from "./project-scanner.tool";
+export * from "./codebase-research.tool";
+export * from "./safe-edit-policy.tool";
+export * from "./pipeline-run.tool";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/tools/workspace/index.js

@@ -0,0 +1,45 @@
+"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("./batch-write-files.tool"), exports);
+__exportStar(require("./browser.tool"), exports);
+__exportStar(require("./vision-browser.tool"), exports);
+__exportStar(require("./list-tasks.tool"), exports);
+__exportStar(require("./get-task.tool"), exports);
+__exportStar(require("./search-code.tool"), exports);
+__exportStar(require("./read-file.tool"), exports);
+__exportStar(require("./write-file.tool"), exports);
+__exportStar(require("./edit-file.tool"), exports);
+__exportStar(require("./multi-file-patch.tool"), exports);
+__exportStar(require("./run-tsc.tool"), exports);
+__exportStar(require("./terminal-run.tool"), exports);
+__exportStar(require("./list-dir.tool"), exports);
+__exportStar(require("./grep.tool"), exports);
+__exportStar(require("./find-files.tool"), exports);
+__exportStar(require("./git.tool"), exports);
+__exportStar(require("./docker.tool"), exports);
+__exportStar(require("./process-manager.tool"), exports);
+__exportStar(require("./http-request.tool"), exports);
+__exportStar(require("./analyze-project.tool"), exports);
+__exportStar(require("./project-context.tool"), exports);
+__exportStar(require("./knowledge.tool"), exports);
+__exportStar(require("./store.tool"), exports);
+__exportStar(require("./plan.tool"), exports);
+__exportStar(require("./project-scanner.tool"), exports);
+__exportStar(require("./codebase-research.tool"), exports);
+__exportStar(require("./safe-edit-policy.tool"), exports);
+__exportStar(require("./pipeline-run.tool"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/workspace/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,iDAA+B;AAC/B,wDAAsC;AACtC,oDAAkC;AAClC,kDAAgC;AAChC,qDAAmC;AACnC,mDAAiC;AACjC,oDAAkC;AAClC,mDAAiC;AACjC,0DAAwC;AACxC,iDAA+B;AAC/B,sDAAoC;AACpC,kDAAgC;AAChC,8CAA4B;AAC5B,oDAAkC;AAClC,6CAA2B;AAC3B,gDAA8B;AAC9B,yDAAuC;AACvC,sDAAoC;AACpC,yDAAuC;AACvC,yDAAuC;AACvC,mDAAiC;AACjC,+CAA6B;AAC7B,8CAA4B;AAC5B,yDAAuC;AACvC,2DAAyC;AACzC,0DAAwC;AACxC,sDAAoC"}

package/dist/tools/workspace/knowledge.tool.d.ts

@@ -0,0 +1,25 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+import { IStorageAdapter, KnowledgeEntry } from "../../contracts/storage.types";
+export declare class KnowledgeTool extends ToolBase {
+    readonly name = "knowledge";
+    readonly description: string;
+    isReadOnly(input: Record<string, unknown>): boolean;
+    private readonly storage;
+    constructor(rootDir?: string, storage?: IStorageAdapter<KnowledgeEntry>);
+    run(input: Record<string, unknown>, ctx: ToolContext): Promise<ToolExecutionResult>;
+    private write;
+    private update;
+    private del;
+    private read;
+    private list;
+    private search;
+    /**
+     * Dump content of entries, optionally filtered by category/tags.
+     * Respects a character budget (maxChars, default 4000).
+     * When the total content exceeds the budget, entries are proportionally
+     * truncated and marked with "[…truncated, use read(id) for full]".
+     */
+    private dump;
+}
+//# sourceMappingURL=knowledge.tool.d.ts.map

package/dist/tools/workspace/knowledge.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/knowledge.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,eAAe,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAWhF,qBAAa,aAAc,SAAQ,QAAQ;IACzC,QAAQ,CAAC,IAAI,eAAe;IAC5B,QAAQ,CAAC,WAAW,SASyD;IAEpE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAE9C,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,CAAC,cAAc,CAAC;IA8BjE,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;YAgB3E,KAAK;YAsBL,MAAM;YAeN,GAAG;YAWH,IAAI;YASJ,IAAI;YA6BJ,MAAM;IA2BpB;;;;;OAKG;YACW,IAAI;CAsEnB"}

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

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KnowledgeTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const in_memory_adapter_1 = require("../../storage/in-memory.adapter");
+const json_file_adapter_1 = require("../../storage/json-file.adapter");
+const node_path_1 = require("node:path");
+const node_fs_1 = require("node:fs");
+const KNOWLEDGE_ACTIONS = ["write", "update", "delete", "read", "list", "search", "dump"];
+const READ_ONLY_ACTIONS = new Set(["read", "list", "search", "dump"]);
+class KnowledgeTool extends tool_base_class_1.ToolBase {
+    name = "knowledge";
+    description = "Accumulate and query knowledge entries during long tasks. " +
+        "write: store a new entry with title, content, category, tags. " +
+        "update: modify content or tags by id. " +
+        "delete: remove entry by id. " +
+        "read: fetch entry by id. " +
+        "list: list entries (titles only), optionally filtered by category or sessionId. " +
+        "search: full-text search in title+content, filter by tags (AND), category, date range. " +
+        "dump: return FULL content of entries filtered by category (or all if no category). " +
+        "Use dump instead of list+read when you need content of multiple entries.";
+    isReadOnly(input) {
+        return READ_ONLY_ACTIONS.has(input["action"] ?? "");
+    }
+    storage;
+    constructor(rootDir, storage) {
+        super(zod_1.z.object({
+            action: zod_1.z.enum(KNOWLEDGE_ACTIONS).describe("write | update | delete | read | list | search"),
+            // write
+            title: zod_1.z.string().optional().describe("Entry title (required for write)"),
+            content: zod_1.z.string().optional().describe("Entry content (required for write or update)"),
+            category: zod_1.z.string().optional().describe("Category string, freeform (required for write)"),
+            tags: zod_1.z.array(zod_1.z.string()).optional().describe("Tags array"),
+            // update / read / delete
+            id: zod_1.z.string().optional().describe("Entry id (required for read, update, delete)"),
+            // list
+            sessionId: zod_1.z.string().optional().describe("Filter by conversation session id"),
+            limit: zod_1.z.number().int().optional().describe("Max number of results to return"),
+            offset: zod_1.z.number().int().optional().describe("Skip first N results"),
+            // search
+            query: zod_1.z.string().optional().describe("Full-text search query (case-insensitive, searches title and content)"),
+            from: zod_1.z.string().optional().describe("ISO date string — entries created on or after this date"),
+            to: zod_1.z.string().optional().describe("ISO date string — entries created on or before this date"),
+            orderBy: zod_1.z.string().optional().describe("Field to order results by (e.g. 'createdAt')"),
+            order: zod_1.z.enum(["asc", "desc"]).optional().describe("Sort direction"),
+            // dump
+            maxChars: zod_1.z.number().int().optional().describe("Max total output chars for dump (default 4000). Content is proportionally truncated if exceeded."),
+        }));
+        this.storage = storage ?? (rootDir ? createFileStorage(rootDir) : new in_memory_adapter_1.InMemoryAdapter());
+    }
+    async run(input, ctx) {
+        const action = input["action"];
+        switch (action) {
+            case "write": return this.write(input, ctx);
+            case "update": return this.update(input);
+            case "delete": return this.del(input);
+            case "read": return this.read(input);
+            case "list": return this.list(input);
+            case "search": return this.search(input);
+            case "dump": return this.dump(input);
+            default:
+                return { success: false, error: `Unknown action: ${action}` };
+        }
+    }
+    async write(input, ctx) {
+        const { title, content, category, tags, sessionId } = input;
+        if (!title)
+            return { success: false, error: "write: 'title' is required" };
+        if (!content)
+            return { success: false, error: "write: 'content' is required" };
+        if (!category)
+            return { success: false, error: "write: 'category' is required" };
+        const now = new Date().toISOString();
+        const entry = await this.storage.create({
+            sessionId: sessionId ?? ctx.sessionId ?? ctx.conversationId,
+            category,
+            title,
+            content,
+            tags: tags ?? [],
+            createdAt: now,
+            updatedAt: now,
+        });
+        return { success: true, output: `Knowledge entry created: ${entry.id}`, data: entry };
+    }
+    async update(input) {
+        const { id, content, tags } = input;
+        if (!id)
+            return { success: false, error: "update: 'id' is required" };
+        const existing = await this.storage.read(id);
+        if (!existing)
+            return { success: false, error: `update: entry '${id}' not found` };
+        const patch = { updatedAt: new Date().toISOString() };
+        if (content !== undefined)
+            patch.content = content;
+        if (tags !== undefined)
+            patch.tags = tags;
+        const updated = await this.storage.update(id, patch);
+        return { success: true, output: `Knowledge entry updated: ${id}`, data: updated };
+    }
+    async del(input) {
+        const id = input["id"];
+        if (!id)
+            return { success: false, error: "delete: 'id' is required" };
+        const existing = await this.storage.read(id);
+        if (!existing)
+            return { success: false, error: `delete: entry '${id}' not found` };
+        await this.storage.delete(id);
+        return { success: true, output: `Knowledge entry deleted: ${id}` };
+    }
+    async read(input) {
+        const id = input["id"];
+        if (!id)
+            return { success: false, error: "read: 'id' is required" };
+        const entry = await this.storage.read(id);
+        if (!entry)
+            return { success: false, error: `read: entry '${id}' not found` };
+        return { success: true, output: `${entry.title}\n${entry.content}`, data: entry };
+    }
+    async list(input) {
+        const { category, sessionId, limit, offset, orderBy, order } = input;
+        const filter = {};
+        if (category)
+            filter.category = category;
+        if (sessionId)
+            filter.sessionId = sessionId;
+        const entries = await this.storage.list({
+            filter,
+            limit,
+            offset,
+            orderBy: orderBy,
+            order,
+        });
+        const summary = entries
+            .map((e) => `[${e.id}] ${e.category}/${e.title} (tags: ${e.tags.join(",") || "none"})`)
+            .join("\n");
+        return {
+            success: true,
+            output: summary || "No entries found.",
+            data: { entries, count: entries.length },
+        };
+    }
+    async search(input) {
+        const { query, tags, category, sessionId, from, to, limit, offset } = input;
+        const entries = await this.storage.search({
+            query,
+            tags,
+            category,
+            sessionId,
+            from: from ? new Date(from) : undefined,
+            to: to ? new Date(to) : undefined,
+            limit,
+            offset,
+        });
+        const summary = entries
+            .map((e) => `[${e.id}] ${e.category}/${e.title}`)
+            .join("\n");
+        return {
+            success: true,
+            output: summary || "No matching entries.",
+            data: { entries, count: entries.length },
+        };
+    }
+    /**
+     * Dump content of entries, optionally filtered by category/tags.
+     * Respects a character budget (maxChars, default 4000).
+     * When the total content exceeds the budget, entries are proportionally
+     * truncated and marked with "[…truncated, use read(id) for full]".
+     */
+    async dump(input) {
+        const { category, tags, limit, maxChars } = input;
+        const budget = Math.max(500, maxChars ?? 4000);
+        const filter = {};
+        if (category)
+            filter.category = category;
+        let entries = await this.storage.list({
+            filter,
+            limit: limit ?? 100,
+            orderBy: "createdAt",
+            order: "asc",
+        });
+        // Tag filtering (AND — all tags must match)
+        if (tags && tags.length > 0) {
+            entries = entries.filter((e) => tags.every((t) => e.tags.includes(t)));
+        }
+        if (entries.length === 0) {
+            return {
+                success: true,
+                output: category
+                    ? `No entries in category '${category}'.`
+                    : "No entries found.",
+                data: { entries: [], count: 0 },
+            };
+        }
+        // Calculate header overhead per entry ("## title [category]\n" + "---\n")
+        const headerSizes = entries.map((e) => `## ${e.title} [${e.category}]\n`.length);
+        const separatorSize = 5; // "---\n\n"
+        const totalHeaderOverhead = headerSizes.reduce((a, b) => a + b, 0) + separatorSize * (entries.length - 1);
+        const contentBudget = budget - totalHeaderOverhead;
+        let blocks;
+        const totalContentSize = entries.reduce((a, e) => a + e.content.length, 0);
+        if (totalContentSize <= contentBudget || contentBudget <= 0) {
+            // Everything fits — return full content
+            blocks = entries.map((e) => `## ${e.title} [${e.category}]\n${e.content}`);
+        }
+        else {
+            // Proportional truncation: each entry gets budget share proportional to its content size
+            const truncatedIds = [];
+            blocks = entries.map((e) => {
+                const share = Math.max(80, Math.floor((e.content.length / totalContentSize) * contentBudget));
+                if (e.content.length <= share) {
+                    return `## ${e.title} [${e.category}]\n${e.content}`;
+                }
+                truncatedIds.push(e.id);
+                const cut = e.content.slice(0, share);
+                return `## ${e.title} [${e.category}] (id:${e.id})\n${cut}\n[…truncated, use read(id) for full]`;
+            });
+        }
+        const output = blocks.join("\n---\n");
+        const prefix = `${entries.length} entries${category ? ` in '${category}'` : ""}:\n\n`;
+        return {
+            success: true,
+            output: `${prefix}${output}`,
+            data: { entries, count: entries.length },
+        };
+    }
+}
+exports.KnowledgeTool = KnowledgeTool;
+function createFileStorage(rootDir) {
+    const filePath = (0, node_path_1.resolve)(rootDir, ".thoughtflow", "knowledge.json");
+    const dir = (0, node_path_1.dirname)(filePath);
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    return new json_file_adapter_1.JsonFileAdapter({ filePath });
+}
+//# sourceMappingURL=knowledge.tool.js.map

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

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

package/dist/tools/workspace/list-dir.tool.d.ts

@@ -0,0 +1,14 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export declare class ListDirTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "listDir";
+    readonly readonly = true;
+    readonly description: string;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private buildTree;
+    private renderTree;
+    private fmtSize;
+}
+//# sourceMappingURL=list-dir.tool.d.ts.map

package/dist/tools/workspace/list-dir.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-dir.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/list-dir.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAUnE,qBAAa,WAAY,SAAQ,QAAQ;IAO3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,QAAQ,CAAC,IAAI,aAAa;IAC1B,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAE2E;gBAElE,OAAO,EAAE,MAAM;IAOtC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkB1F,OAAO,CAAC,SAAS;IA8BjB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,OAAO;CAKhB"}

package/dist/tools/workspace/list-dir.tool.js

@@ -0,0 +1,136 @@
+"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.ListDirTool = 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 ListDirTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "listDir";
+    readonly = true;
+    description = "Lists the directory tree of a path in the project. " +
+        "Useful for understanding the architecture and module layout before reading specific files.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            path: zod_1.z.string().optional().describe("Directory path relative to project root. Defaults to root."),
+            depth: zod_1.z.number().optional().describe("How deep to recurse. Default 2."),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const { path: relPath = ".", depth = 2 } = 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: `Path not found: ${relPath}. Hint: try list_dir with "." to see root directories, or check sub-project paths (e.g. backend/, frontend/).` };
+        }
+        const tree = this.buildTree(fullPath, Math.min(depth, 5));
+        const text = this.renderTree(tree, "");
+        return { success: true, output: `${relPath}/\n${text}` };
+    }
+    buildTree(dir, depth) {
+        if (depth === 0)
+            return [];
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return [];
+        }
+        const SKIP = new Set(["node_modules", "dist", ".git", ".idea", "coverage"]);
+        const nodes = [];
+        for (const entry of entries.sort((a, b) => {
+            const aIsDir = a.isDirectory() ? 0 : 1;
+            const bIsDir = b.isDirectory() ? 0 : 1;
+            return aIsDir - bIsDir || a.name.localeCompare(b.name);
+        })) {
+            if (SKIP.has(entry.name))
+                continue;
+            if (entry.name.startsWith("."))
+                continue;
+            const fullPath = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                nodes.push({ name: entry.name, type: "dir", children: this.buildTree(fullPath, depth - 1) });
+            }
+            else {
+                const size = (() => {
+                    try {
+                        return fs.statSync(fullPath).size;
+                    }
+                    catch {
+                        return 0;
+                    }
+                })();
+                nodes.push({ name: entry.name, type: "file", size });
+            }
+        }
+        return nodes;
+    }
+    renderTree(nodes, prefix) {
+        const lines = [];
+        for (let i = 0; i < nodes.length; i++) {
+            const node = nodes[i];
+            const isLast = i === nodes.length - 1;
+            const connector = isLast ? "└── " : "├── ";
+            const childPrefix = isLast ? "    " : "│   ";
+            if (node.type === "dir") {
+                lines.push(`${prefix}${connector}${node.name}/`);
+                if (node.children?.length) {
+                    lines.push(this.renderTree(node.children, prefix + childPrefix));
+                }
+            }
+            else {
+                const sizeStr = node.size !== undefined ? ` (${this.fmtSize(node.size)})` : "";
+                lines.push(`${prefix}${connector}${node.name}${sizeStr}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    fmtSize(bytes) {
+        if (bytes < 1024)
+            return `${bytes}B`;
+        if (bytes < 1024 * 1024)
+            return `${(bytes / 1024).toFixed(1)}KB`;
+        return `${(bytes / 1024 / 1024).toFixed(1)}MB`;
+    }
+}
+exports.ListDirTool = ListDirTool;
+//# sourceMappingURL=list-dir.tool.js.map

package/dist/tools/workspace/list-dir.tool.js.map

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