@thoughtflow/core 0.1.2

package/dist/tools/workspace/batch-write-files.tool.js

@@ -0,0 +1,97 @@
+"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.BatchWriteFilesTool = 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 BatchWriteFilesTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "batchWriteFiles";
+    readonly = false;
+    description = "Writes multiple new files to the project workspace in a single call. " +
+        "Each entry has a relative 'path' and 'content' string. " +
+        "Creates parent directories automatically.\n\n" +
+        "Use for: scaffolding new files (package.json, new modules, boilerplate).\n" +
+        "Do NOT use for: editing existing files — use edit_file instead (it only sends the changed lines and avoids JSON escaping issues with complex content).\n" +
+        "Rule: if content contains many quotes, backslashes, or template literals, write a single short file at a time to avoid JSON escaping errors.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            files: zod_1.z
+                .array(zod_1.z.object({
+                path: zod_1.z.string().describe("File path relative to project root, e.g. src/app.module.ts"),
+                content: zod_1.z.string().describe("Full text content to write into the file"),
+            }))
+                .min(1)
+                .describe("Array of files to write. All are written atomically."),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const { files } = input;
+        const written = [];
+        const errors = [];
+        for (const file of files) {
+            const fullPath = (0, path_utils_1.resolveSafePath)(this.rootDir, file.path);
+            if (!fullPath) {
+                errors.push(`✗ ${file.path}: path traversal not allowed`);
+                continue;
+            }
+            try {
+                fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+                fs.writeFileSync(fullPath, file.content, "utf8");
+                const lines = file.content.split("\n").length;
+                const contentPreview = file.content.length > 200
+                    ? file.content.slice(0, 200).replace(/\n$/, "\n...")
+                    : file.content;
+                written.push(`✓ ${file.path} (${lines} lines, ${file.content.length} bytes)\n${contentPreview}`);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                errors.push(`✗ ${file.path}: ${msg}`);
+            }
+        }
+        const summary = `Written ${written.length}/${files.length} files:\n${[...written, ...errors].join("\n")}`;
+        return {
+            success: errors.length === 0,
+            output: summary,
+            ...(errors.length > 0 && { error: `${errors.length} file(s) failed to write` }),
+        };
+    }
+}
+exports.BatchWriteFilesTool = BatchWriteFilesTool;
+//# sourceMappingURL=batch-write-files.tool.js.map

package/dist/tools/workspace/batch-write-files.tool.js.map

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

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

@@ -0,0 +1,24 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+/**
+ * BrowserTool — Playwright-backed browser automation (Faza 8 stub).
+ *
+ * Playwright is loaded lazily on the first run() call so that registering
+ * this tool does NOT require Playwright to be installed. If Playwright is
+ * missing, run() returns `success: false` with a helpful install message.
+ *
+ * Note: Full implementation planned in Faza 8. Currently returns an
+ * informative "not yet implemented" error for all actions.
+ */
+export declare class BrowserTool extends ToolBase {
+    readonly name = "browser";
+    readonly description: string;
+    /** Read-only actions: navigate/get_text/screenshot/get_dom/extract */
+    isReadOnly(input: Record<string, unknown>): boolean;
+    constructor();
+    private browser;
+    private page;
+    private getPage;
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=browser.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"browser.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/browser.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAwBnE;;;;;;;;;GASG;AACH,qBAAa,WAAY,SAAQ,QAAQ;IACvC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,WAAW,SAIwD;IAE5E,sEAAsE;IAC7D,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;;IAqB5D,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,IAAI,CAA0C;YAExC,OAAO;IAYf,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAsG3F"}

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

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const BROWSER_ACTIONS = [
+    "navigate",
+    "get_text",
+    "screenshot",
+    "get_dom",
+    "extract",
+    "click",
+    "type",
+    "select",
+    "close",
+];
+const READ_ONLY_BROWSER_ACTIONS = new Set([
+    "navigate",
+    "get_text",
+    "screenshot",
+    "get_dom",
+    "extract",
+]);
+/**
+ * BrowserTool — Playwright-backed browser automation (Faza 8 stub).
+ *
+ * Playwright is loaded lazily on the first run() call so that registering
+ * this tool does NOT require Playwright to be installed. If Playwright is
+ * missing, run() returns `success: false` with a helpful install message.
+ *
+ * Note: Full implementation planned in Faza 8. Currently returns an
+ * informative "not yet implemented" error for all actions.
+ */
+class BrowserTool extends tool_base_class_1.ToolBase {
+    name = "browser";
+    description = "Headless browser automation with Playwright (Chromium). " +
+        "Read: navigate, get_text, screenshot (vision only), get_dom, extract. " +
+        "Write: click, type, select, close. " +
+        "Playwright is loaded on first use — no install required at import time.";
+    /** Read-only actions: navigate/get_text/screenshot/get_dom/extract */
+    isReadOnly(input) {
+        return READ_ONLY_BROWSER_ACTIONS.has(input["action"] ?? "navigate");
+    }
+    constructor() {
+        super(zod_1.z.object({
+            action: zod_1.z
+                .enum(BROWSER_ACTIONS)
+                .describe("Browser action to perform"),
+            url: zod_1.z.string().optional().describe("URL to navigate to (for navigate action)"),
+            selector: zod_1.z.string().optional().describe("CSS selector (for click/type/select/extract/get_dom)"),
+            text: zod_1.z.string().optional().describe("Text to type (for type action)"),
+            value: zod_1.z.string().optional().describe("Option value to select (for select action)"),
+            fields: zod_1.z.array(zod_1.z.string()).optional().describe("Fields to extract from rows (for extract action)"),
+            waitFor: zod_1.z.number().optional().describe("Max ms to wait for page load (default: 5000)"),
+        }));
+    }
+    // Shared browser instance (reused across calls)
+    browser = null;
+    page = null;
+    async getPage() {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { chromium } = require("playwright");
+        if (!this.browser || !this.browser.isConnected()) {
+            this.browser = await chromium.launch({ headless: true });
+        }
+        if (!this.page || this.page.isClosed()) {
+            this.page = await this.browser.newPage();
+        }
+        return this.page;
+    }
+    async run(input, _ctx) {
+        // Lazy-load Playwright on first use (optional peer dependency)
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports
+            require("playwright");
+        }
+        catch {
+            return {
+                success: false,
+                error: "Playwright is not installed. Run: npm install playwright && npx playwright install chromium",
+            };
+        }
+        const action = input["action"] ?? "navigate";
+        const waitFor = input["waitFor"] ?? 5000;
+        try {
+            const page = await this.getPage();
+            switch (action) {
+                case "navigate": {
+                    const url = input["url"];
+                    if (!url)
+                        return { success: false, error: "url is required for navigate" };
+                    await page.goto(url, { waitUntil: "domcontentloaded", timeout: waitFor });
+                    const title = await page.title();
+                    return { success: true, output: JSON.stringify({ title, url: page.url() }) };
+                }
+                case "get_text": {
+                    const selector = input["selector"] ?? "body";
+                    const text = await page.locator(selector).first().innerText({ timeout: waitFor });
+                    return { success: true, output: text.trim() };
+                }
+                case "get_dom": {
+                    const selector = input["selector"] ?? "body";
+                    const html = await page.locator(selector).first().innerHTML({ timeout: waitFor });
+                    return { success: true, output: html };
+                }
+                case "extract": {
+                    const selector = input["selector"];
+                    const fields = input["fields"] ?? [];
+                    if (!selector)
+                        return { success: false, error: "selector is required for extract" };
+                    const rows = await page.locator(selector).all();
+                    const results = [];
+                    for (const row of rows) {
+                        if (fields.length === 0) {
+                            results.push({ text: (await row.innerText()).trim() });
+                        }
+                        else {
+                            const obj = {};
+                            for (const field of fields) {
+                                const el = row.locator(`[class*="${field}"], [data-${field}], .${field}`).first();
+                                obj[field] = (await el.innerText().catch(() => "")).trim();
+                            }
+                            results.push(obj);
+                        }
+                    }
+                    return { success: true, output: JSON.stringify(results) };
+                }
+                case "click": {
+                    const selector = input["selector"];
+                    if (!selector)
+                        return { success: false, error: "selector is required for click" };
+                    await page.locator(selector).first().click({ timeout: waitFor });
+                    return { success: true, output: `Clicked: ${selector}` };
+                }
+                case "type": {
+                    const selector = input["selector"];
+                    const text = input["text"];
+                    if (!selector || text === undefined)
+                        return { success: false, error: "selector and text required for type" };
+                    await page.locator(selector).first().fill(text, { timeout: waitFor });
+                    return { success: true, output: `Typed into ${selector}` };
+                }
+                case "select": {
+                    const selector = input["selector"];
+                    const value = input["value"];
+                    if (!selector || !value)
+                        return { success: false, error: "selector and value required for select" };
+                    await page.locator(selector).first().selectOption(value, { timeout: waitFor });
+                    return { success: true, output: `Selected ${value} in ${selector}` };
+                }
+                case "screenshot": {
+                    const buf = await page.screenshot({ type: "png" });
+                    return { success: true, output: `screenshot:base64:${buf.toString("base64")}` };
+                }
+                case "close": {
+                    await this.page?.close();
+                    this.page = null;
+                    return { success: true, output: "Browser page closed" };
+                }
+                default:
+                    return { success: false, error: `Unknown action: ${action}` };
+            }
+        }
+        catch (err) {
+            return { success: false, error: String(err instanceof Error ? err.message : err) };
+        }
+    }
+}
+exports.BrowserTool = BrowserTool;
+//# sourceMappingURL=browser.tool.js.map

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

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

package/dist/tools/workspace/codebase-research.tool.d.ts

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

package/dist/tools/workspace/codebase-research.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-research.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/codebase-research.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAMnE,qBAAa,oBAAqB,SAAQ,QAAQ;IAQpC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAGiE;gBAExD,OAAO,EAAE,MAAM;IActC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAuE3F"}

package/dist/tools/workspace/codebase-research.tool.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodebaseResearchTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const codebase_index_class_1 = require("../../libs/codebase-index.class");
+const dependency_analyzer_class_1 = require("../../libs/task-flow/dependency-analyzer.class");
+const ACTIONS = ["search", "dependencies", "duplicates", "stats"];
+class CodebaseResearchTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "codebaseResearch";
+    readonly = true;
+    description = "Task-flow helper over CodebaseIndex and dependency analysis. " +
+        "search: code/path/symbol search. dependencies: build import graph for provided files. " +
+        "duplicates: check whether proposed symbols already exist. stats: index metadata.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            action: zod_1.z.enum(ACTIONS),
+            query: zod_1.z.string().optional(),
+            mode: zod_1.z.enum(["hybrid", "content", "path", "symbol"]).optional(),
+            files: zod_1.z.array(zod_1.z.string()).optional(),
+            symbols: zod_1.z.array(zod_1.z.string()).optional(),
+            limit: zod_1.z.number().int().min(1).max(200).optional(),
+            reindex: zod_1.z.boolean().optional(),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const action = input["action"];
+        const index = codebase_index_class_1.CodebaseIndex.forRoot(this.rootDir);
+        if (!index.isIndexed() || input["reindex"] === true) {
+            index.rebuild();
+        }
+        if (action === "stats") {
+            return {
+                success: true,
+                output: JSON.stringify(index.getStats()),
+            };
+        }
+        if (action === "search") {
+            const query = String(input["query"] ?? "").trim();
+            const mode = input["mode"] ?? "hybrid";
+            const limit = Number(input["limit"] ?? 20);
+            const hits = index.search({
+                query: query || undefined,
+                mode,
+                limit,
+                offset: 0,
+            });
+            return {
+                success: true,
+                output: JSON.stringify({ count: hits.length, hits }),
+            };
+        }
+        if (action === "dependencies") {
+            const files = input["files"] ?? [];
+            if (files.length === 0) {
+                return { success: false, error: "dependencies action requires non-empty 'files'" };
+            }
+            const analyzer = new dependency_analyzer_class_1.DependencyAnalyzer();
+            const report = analyzer.analyzeFromFiles(this.rootDir, files);
+            return {
+                success: true,
+                output: JSON.stringify(report),
+            };
+        }
+        const symbols = input["symbols"] ?? [];
+        if (symbols.length === 0) {
+            return { success: false, error: "duplicates action requires non-empty 'symbols'" };
+        }
+        const duplicates = {};
+        for (const symbol of symbols) {
+            const hits = index.search({
+                query: symbol,
+                mode: "symbol",
+                limit: 50,
+                offset: 0,
+            });
+            if (hits.length > 0) {
+                duplicates[symbol] = hits;
+            }
+        }
+        return {
+            success: true,
+            output: JSON.stringify({ duplicateCount: Object.keys(duplicates).length, duplicates }),
+        };
+    }
+}
+exports.CodebaseResearchTool = CodebaseResearchTool;
+//# sourceMappingURL=codebase-research.tool.js.map

package/dist/tools/workspace/codebase-research.tool.js.map

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

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

@@ -0,0 +1,29 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+/** Configuration for DockerTool. */
+export interface DockerToolConfig {
+    /**
+     * Binary to use. If not set, auto-detects: tries `podman` first, falls back to `docker`.
+     * Set explicitly to "podman" or "docker" to skip detection.
+     */
+    binary?: "podman" | "docker";
+    /**
+     * Working directory for compose commands (defaults to rootDir).
+     * Useful when docker-compose.yml is in a subdirectory.
+     */
+    composeDir?: string;
+}
+export declare class DockerTool extends ToolBase {
+    readonly name = "docker";
+    readonly description: string;
+    readonly readonly = false;
+    /** ps/logs/compose_ps are read-only; exec/run/build/compose_up/compose_down mutate state. */
+    isReadOnly(input: Record<string, unknown>): boolean;
+    private readonly cfg;
+    private readonly rootDir;
+    private resolvedBinary;
+    constructor(rootDir: string, config?: DockerToolConfig);
+    private getBinary;
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=docker.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"docker.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/docker.tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAkCnE,oCAAoC;AACpC,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC7B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,qBAAa,UAAW,SAAQ,QAAQ;IACtC,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,WAAW,SAK2C;IAC/D,SAAkB,QAAQ,SAAS;IAEnC,6FAA6F;IACpF,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmB;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,cAAc,CAAuB;gBAEjC,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,gBAAqB;YA6C5C,SAAS;IAmBjB,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,mBAAmB,CAAC;CA+GhC"}