@thoughtflow/core 0.1.2

package/dist/tools/workspace/terminal-run.tool.js

@@ -0,0 +1,122 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalRunTool = void 0;
+const zod_1 = require("zod");
+const child_process_1 = require("child_process");
+const tool_base_class_1 = require("../base/tool-base.class");
+/**
+ * Dangerous commands that must never be executed.
+ * Mirrors the COMMAND_BLACKLIST from internal constants.
+ */
+const COMMAND_BLACKLIST = [
+    "rm -rf /",
+    "rm -rf /*",
+    "mkfs",
+    "dd if=",
+    ":(){:|:&};:",
+    "chmod -R 777 /",
+    "insmod",
+    "rmmod",
+    "modprobe",
+    "shutdown",
+    "reboot",
+    "halt",
+    "poweroff",
+    "init 0",
+    "init 6",
+    // Additional safety entries
+    "sudo",
+    "su ",
+    "su\t",
+    "$(",
+    "`",
+    "{",
+    // File readers — use readFile tool instead
+    "cat ",
+    "head ",
+    "tail ",
+    "less ",
+    "more ",
+    // File searchers — use grep tool instead
+    "rg ",
+    "ack ",
+    "ag ",
+    "pt ",
+];
+class TerminalRunTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "terminalRun";
+    readonly = false;
+    description = "Execute a shell command in the project workspace directory. " +
+        "Use for: npm install, npm run build, npm test, npx tsc, node scripts, etc. " +
+        "Returns combined stdout+stderr. Non-zero exit codes are reported as errors.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            command: zod_1.z.string().describe("Shell command to execute, e.g. 'npm run build', 'npx tsc --noEmit', 'node dist/main.js'"),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, ctx) {
+        const { command } = input;
+        // Security: check blacklist
+        const lc = command.toLowerCase();
+        for (const blocked of COMMAND_BLACKLIST) {
+            if (lc.includes(blocked.toLowerCase())) {
+                return { success: false, error: `Command blocked: "${blocked}" is not allowed.` };
+            }
+        }
+        // Security: block destructive rm on absolute paths (any flag combination)
+        const rmMatch = command.match(/\brm\s+(.*?)\s+\//);
+        if (rmMatch) {
+            const flags = rmMatch[1];
+            const hasRecursive = /(?:^|\s)-[rR]/.test(flags) || /--recursive/.test(flags);
+            const hasForce = /(?:^|\s)-f\b/.test(flags) || /--force/.test(flags);
+            if (hasRecursive && hasForce) {
+                return { success: false, error: "Destructive rm on absolute path is not allowed." };
+            }
+        }
+        return new Promise((resolve) => {
+            const proc = (0, child_process_1.spawn)("sh", ["-c", command], {
+                cwd: this.rootDir,
+                env: { ...process.env },
+            });
+            const chunks = [];
+            let exitCode = 0;
+            const TIMEOUT = 60_000; // 60s — prevents agent from hanging on network issues
+            const timer = setTimeout(() => {
+                proc.kill("SIGTERM");
+                const combined = chunks.join("").trim();
+                resolve({ success: false, error: `Command timed out after ${TIMEOUT / 1000}s`, output: combined || "" });
+            }, TIMEOUT);
+            const onData = (data) => {
+                const text = data.toString();
+                chunks.push(text);
+                // Emit each chunk live as a STREAMING progress event
+                ctx.emitProgress?.(text, { status: "STREAMING" });
+            };
+            proc.stdout.on("data", onData);
+            proc.stderr.on("data", onData);
+            proc.on("close", (code) => {
+                clearTimeout(timer);
+                exitCode = code ?? 0;
+                const combined = chunks.join("").trim();
+                if (exitCode === 0) {
+                    resolve({ success: true, output: combined || "(no output)" });
+                }
+                else {
+                    resolve({
+                        success: false,
+                        error: combined || `exited with code ${exitCode}`,
+                        output: combined || "",
+                    });
+                }
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timer);
+                resolve({ success: false, error: err.message });
+            });
+        });
+    }
+}
+exports.TerminalRunTool = TerminalRunTool;
+//# sourceMappingURL=terminal-run.tool.js.map

package/dist/tools/workspace/terminal-run.tool.js.map

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

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

@@ -0,0 +1,32 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+import { LlmAdapter } from "../../contracts";
+/**
+ * VisionBrowserTool — navigates to a URL, optionally interacts with the page,
+ * takes a screenshot, and analyzes it using a vision-capable LLM.
+ *
+ * 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.
+ *
+ * The tool is self-contained: it calls the vision LLM directly rather than
+ * routing images through the conversation pipeline.
+ */
+export declare class VisionBrowserTool extends ToolBase {
+    private readonly visionAdapter;
+    private readonly defaultModel;
+    private readonly rootDir?;
+    readonly name = "visionBrowser";
+    readonly description: string;
+    readonly namespace = "web";
+    readonly tags: string[];
+    readonly readonly = true;
+    constructor(visionAdapter: LlmAdapter, defaultModel?: string, rootDir?: string | undefined);
+    private browser;
+    private page;
+    private getPage;
+    private closePage;
+    closeBrowser(): Promise<void>;
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+}
+//# sourceMappingURL=vision-browser.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vision-browser.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/vision-browser.tool.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAClD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C;;;;;;;;;;GAUG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAiB3C,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;IAlB3B,QAAQ,CAAC,IAAI,mBAAkB;IAC/B,QAAQ,CAAC,WAAW,SASqD;IACzE,QAAQ,CAAC,SAAS,SAAQ;IAC1B,QAAQ,CAAC,IAAI,WAAsB;IACnC,QAAQ,CAAC,QAAQ,QAAO;gBAGL,aAAa,EAAE,UAAU,EACzB,YAAY,GAAE,MAAqB,EACnC,OAAO,CAAC,EAAE,MAAM,YAAA;IA2CnC,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,IAAI,CAAyC;YAEvC,OAAO;YAYP,SAAS;IAKjB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAmL3F"}

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

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VisionBrowserTool = void 0;
+const zod_1 = require("zod");
+const tool_base_class_1 = require("../base/tool-base.class");
+const message_utils_1 = require("../../libs/message-utils");
+/**
+ * VisionBrowserTool — navigates to a URL, optionally interacts with the page,
+ * takes a screenshot, and analyzes it using a vision-capable LLM.
+ *
+ * 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.
+ *
+ * The tool is self-contained: it calls the vision LLM directly rather than
+ * routing images through the conversation pipeline.
+ */
+class VisionBrowserTool extends tool_base_class_1.ToolBase {
+    visionAdapter;
+    defaultModel;
+    rootDir;
+    name = "visionBrowser";
+    description = "Visual web page analysis using headless browser screenshots and a vision LLM. " +
+        "Provide exactly one of: url (navigate), html (inline HTML string), or htmlFile (path to .html file). " +
+        "Optionally performs interactions (click, type, scroll, wait) before capturing the screenshot. " +
+        "Supports custom HTTP headers for auth/access, cookies for session state, " +
+        "waitForSelector for slow-loading pages, and waitForResponse for API-dependent pages. " +
+        "Analyzes it according to the provided prompt using a vision-capable model. " +
+        "Use this tool when you need to visually inspect a rendered web page — checking layout, " +
+        "colors, visibility of elements, UI correctness, or any visual property that cannot " +
+        "be determined from DOM text alone. Playwright is loaded on first use.";
+    namespace = "web";
+    tags = ["read", "analyze"];
+    readonly = true;
+    constructor(visionAdapter, defaultModel = "gemma3:12b", rootDir) {
+        super(zod_1.z.object({
+            url: zod_1.z.string().optional().describe("URL of the page to analyze"),
+            html: zod_1.z.string().optional().describe("Raw HTML string to render"),
+            htmlFile: zod_1.z.string().optional().describe("Path to a .html file to render"),
+            prompt: zod_1.z.string().describe("What to check/analyze on the rendered page"),
+            model: zod_1.z.string().optional().describe("Vision model name override"),
+            width: zod_1.z.number().optional().default(1280),
+            height: zod_1.z.number().optional().default(800),
+            fullPage: zod_1.z.boolean().optional().default(false),
+            waitFor: zod_1.z.number().optional().default(3000).describe("ms to wait after load"),
+            // ── New: auth & slow-page resilience ──
+            headers: zod_1.z.record(zod_1.z.string(), zod_1.z.string()).optional()
+                .describe("Custom HTTP headers (e.g. Authorization, Cookie, X-Auth-Token) for access-protected pages. Only applies with url navigation."),
+            cookies: zod_1.z.array(zod_1.z.object({
+                name: zod_1.z.string(),
+                value: zod_1.z.string(),
+                domain: zod_1.z.string().optional(),
+                path: zod_1.z.string().optional().default("/"),
+                httpOnly: zod_1.z.boolean().optional(),
+                secure: zod_1.z.boolean().optional(),
+                sameSite: zod_1.z.enum(["Strict", "Lax", "None"]).optional(),
+            })).optional().describe("Cookies to set before navigation (for session/auth state). Only applies with url navigation."),
+            waitForSelector: zod_1.z.string().optional()
+                .describe("CSS selector to wait for before taking screenshot (for slow-loading pages). " +
+                "If the element does not appear within maxWaitMs, proceeds anyway."),
+            waitForResponse: zod_1.z.string().optional()
+                .describe("URL pattern (glob substring or regex) to wait for a matching network response. " +
+                "Useful for pages that depend on API calls completing. Only applies with url navigation."),
+            maxWaitMs: zod_1.z.number().optional().default(30000)
+                .describe("Maximum ms to wait for waitForSelector or waitForResponse (default 30s)"),
+            selector: zod_1.z.string().optional().describe("CSS selector - screenshot only this element"),
+            actions: zod_1.z.array(zod_1.z.object({
+                action: zod_1.z.enum(["click", "type", "scroll", "wait"]),
+                selector: zod_1.z.string().optional(),
+                value: zod_1.z.string().optional(),
+            })).optional().describe("Interactions to perform before screenshot"),
+        }));
+        this.visionAdapter = visionAdapter;
+        this.defaultModel = defaultModel;
+        this.rootDir = rootDir;
+    }
+    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 closePage() {
+        await this.page?.close();
+        this.page = null;
+    }
+    async closeBrowser() {
+        await this.closePage();
+        await this.browser?.close();
+        this.browser = null;
+    }
+    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 url = input["url"];
+        const html = input["html"];
+        const htmlFile = input["htmlFile"];
+        const prompt = input["prompt"];
+        const model = input["model"];
+        const width = input["width"] ?? 1280;
+        const height = input["height"] ?? 800;
+        const fullPage = input["fullPage"] ?? false;
+        const waitFor = input["waitFor"] ?? 3000;
+        const selector = input["selector"];
+        const headers = input["headers"];
+        const cookies = input["cookies"];
+        const waitForSelector = input["waitForSelector"];
+        const waitForResponse = input["waitForResponse"];
+        const maxWaitMs = input["maxWaitMs"] ?? 30000;
+        const actions = input["actions"];
+        const sources = [url, html, htmlFile].filter(Boolean);
+        if (sources.length === 0)
+            return { success: false, error: "One of url, html, or htmlFile is required" };
+        if (sources.length > 1)
+            return { success: false, error: "Provide exactly one of: url, html, or htmlFile" };
+        if (!prompt)
+            return { success: false, error: "prompt is required" };
+        try {
+            const page = await this.getPage();
+            await page.setViewportSize({ width, height });
+            // Set custom headers if provided (for auth, etc.)
+            if (headers && url) {
+                await page.setExtraHTTPHeaders(headers);
+            }
+            // Set cookies if provided
+            if (cookies && cookies.length > 0) {
+                const cookieParams = cookies.map((c) => ({
+                    name: c.name,
+                    value: c.value,
+                    domain: c.domain,
+                    path: c.path ?? "/",
+                    httpOnly: c.httpOnly ?? false,
+                    secure: c.secure ?? false,
+                    sameSite: c.sameSite,
+                }));
+                // If url-based navigation, set cookies before navigating
+                if (url) {
+                    try {
+                        await page.context().addCookies(cookieParams);
+                    }
+                    catch {
+                        // Some cookie params may be rejected by browser — non-fatal
+                    }
+                }
+            }
+            // Set up response waiting before navigation (if requested)
+            let responsePromise;
+            if (waitForResponse && url) {
+                let responsePattern;
+                try {
+                    responsePattern = new RegExp(waitForResponse);
+                }
+                catch {
+                    return { success: false, error: `Invalid waitForResponse pattern: ${waitForResponse}. Must be a valid regex or simple string.` };
+                }
+                responsePromise = page.waitForResponse((resp) => responsePattern.test(resp.url()), { timeout: maxWaitMs }).then(() => { }).catch(() => {
+                    // Timeout on response wait is non-fatal
+                });
+            }
+            if (html) {
+                await page.setContent(html, { waitUntil: "networkidle" });
+            }
+            else if (htmlFile) {
+                const { resolve, isAbsolute } = require("path");
+                const fs = require("fs");
+                const resolvedPath = isAbsolute(htmlFile) || !this.rootDir
+                    ? htmlFile
+                    : resolve(this.rootDir, htmlFile);
+                if (!fs.existsSync(resolvedPath))
+                    return { success: false, error: `File not found: ${resolvedPath}` };
+                const fileContent = fs.readFileSync(resolvedPath, "utf-8");
+                await page.setContent(fileContent, { waitUntil: "networkidle" });
+            }
+            else if (url) {
+                await page.goto(url, { waitUntil: "networkidle" });
+            }
+            // Wait for specific selector if provided (slow-page resilience)
+            if (waitForSelector) {
+                try {
+                    await page.waitForSelector(waitForSelector, { timeout: maxWaitMs, state: "visible" });
+                }
+                catch {
+                    // Selector didn't appear — non-fatal, proceed with screenshot anyway
+                }
+            }
+            // Wait for response if we set it up
+            if (responsePromise) {
+                await responsePromise;
+            }
+            // Standard wait
+            await page.waitForTimeout(waitFor);
+            // Perform interactions
+            if (actions) {
+                for (const act of actions) {
+                    switch (act.action) {
+                        case "click": {
+                            if (!act.selector)
+                                break;
+                            try {
+                                await page.click(act.selector, { timeout: 5000 });
+                            }
+                            catch {
+                                // Click failure is non-fatal
+                            }
+                            break;
+                        }
+                        case "type": {
+                            if (!act.selector || act.value === undefined)
+                                break;
+                            try {
+                                await page.type(act.selector, act.value);
+                            }
+                            catch {
+                                // Type failure is non-fatal
+                            }
+                            break;
+                        }
+                        case "scroll": {
+                            const amount = parseInt(act.value ?? "") || 500;
+                            await page.evaluate((px) => window.scrollBy(0, px), amount);
+                            break;
+                        }
+                        case "wait": {
+                            const ms = parseInt(act.value ?? "") || 1000;
+                            await page.waitForTimeout(ms);
+                            break;
+                        }
+                    }
+                }
+            }
+            let buf;
+            if (selector) {
+                const el = page.locator(selector).first();
+                buf = await el.screenshot({ type: "png" });
+            }
+            else {
+                buf = await page.screenshot({ type: "png", fullPage });
+            }
+            const base64Data = buf.toString("base64");
+            const visionMessage = (0, message_utils_1.buildUserVisionMessage)(prompt, base64Data);
+            const response = await this.visionAdapter.chat({
+                model: model || this.defaultModel,
+                messages: [visionMessage],
+                tools: [],
+            });
+            return { success: true, output: response.message.content };
+        }
+        catch (err) {
+            return { success: false, error: String(err instanceof Error ? err.message : err) };
+        }
+    }
+}
+exports.VisionBrowserTool = VisionBrowserTool;
+//# sourceMappingURL=vision-browser.tool.js.map

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/write-file.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,SAAS;IACnC,QAAQ,CAAC,WAAW,SAGsB;gBAEb,OAAO,EAAE,MAAM;IAOtC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAwB3F"}

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

@@ -0,0 +1,77 @@
+"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.WriteFileTool = 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 WriteFileTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "writeFile";
+    readonly = false;
+    description = "Creates or overwrites a file with the given content. " +
+        "Provide the path relative to the project root. " +
+        "Creates parent directories as needed.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            path: zod_1.z.string().describe("File path relative to project root, e.g. src/utils/helper.ts"),
+            content: zod_1.z.string().describe("Full file content to write"),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const { path: relPath, content } = input;
+        const fullPath = (0, path_utils_1.resolveSafePath)(this.rootDir, relPath);
+        if (!fullPath) {
+            return { success: false, error: "Path traversal not allowed." };
+        }
+        const existed = fs.existsSync(fullPath);
+        const oldContent = existed ? fs.readFileSync(fullPath, "utf8") : null;
+        fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+        fs.writeFileSync(fullPath, content, "utf8");
+        const lines = content.split("\n").length;
+        const diff = existed && oldContent !== null
+            ? `<<<<<<< ORIGINAL\n${oldContent}\n=======\n${content}\n>>>>>>>`
+            : content;
+        return {
+            success: true,
+            output: `${existed ? "Overwritten" : "Written"}: ${relPath} (${lines} lines, ${content.length} bytes)\n\n${diff}`,
+        };
+    }
+}
+exports.WriteFileTool = WriteFileTool;
+//# sourceMappingURL=write-file.tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"write-file.tool.js","sourceRoot":"","sources":["../../../src/tools/workspace/write-file.tool.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6BAAwB;AACxB,uCAAyB;AACzB,2CAA6B;AAC7B,6DAAmD;AAEnD,mDAAqD;AAErD,MAAa,aAAc,SAAQ,0BAAQ;IAQZ;IAPpB,IAAI,GAAG,WAAW,CAAC;IACV,QAAQ,GAAG,KAAK,CAAC;IAC1B,WAAW,GAClB,uDAAuD;QACvD,iDAAiD;QACjD,uCAAuC,CAAC;IAE1C,YAA6B,OAAe;QAC1C,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;YACb,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8DAA8D,CAAC;YACzF,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;SAC3D,CAAC,CAAC,CAAC;QAJuB,YAAO,GAAP,OAAO,CAAQ;IAK5C,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,KAA8B,EAAE,IAAiB;QACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAA0C,CAAC;QAE9E,MAAM,QAAQ,GAAG,IAAA,4BAAe,EAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAEtE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAE5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACzC,MAAM,IAAI,GAAG,OAAO,IAAI,UAAU,KAAK,IAAI;YACzC,CAAC,CAAC,qBAAqB,UAAU,cAAc,OAAO,WAAW;YACjE,CAAC,CAAC,OAAO,CAAC;QAEZ,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,KAAK,OAAO,KAAK,KAAK,WAAW,OAAO,CAAC,MAAM,cAAc,IAAI,EAAE;SAClH,CAAC;IACJ,CAAC;CACF;AAvCD,sCAuCC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@thoughtflow/core",
+  "version": "0.1.2",
+  "description": "TypeScript framework for building autonomous AI agents with LLM tool-calling, streaming, plugins, skills, and workspace automation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zgaduj/thoughtflow.git"
+  },
+  "author": "Patryk Tyszko (https://tyszko.dev)",
+  "homepage": "https://github.com/zgaduj/thoughtflow",
+  "bugs": {
+    "url": "https://github.com/zgaduj/thoughtflow/issues"
+  },
+  "keywords": [
+    "ai-agents",
+    "llm",
+    "typescript",
+    "framework",
+    "tool-calling",
+    "autonomous-agents"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "jest --runInBand",
+    "test:unit": "jest tests/unit --runInBand --forceExit",
+    "test:coverage": "jest --runInBand --coverage --forceExit",
+    "test:watch": "jest --watch",
+    "publish:release": "bash scripts/publish.sh"
+  },
+  "engines": {
+    "bun": ">=1.2.0",
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@ast-grep/napi": "^0.42.1",
+    "@huggingface/transformers": "^4.2.0",
+    "@lancedb/lancedb": "^0.27.2",
+    "better-sqlite3": "^11.10.0",
+    "playwright": "^1.59.1",
+    "rxjs": "^7.8.1",
+    "ts-morph": "^27.0.2",
+    "zod": "^3.24.3"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.59.1",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/bun": "^1.3.14",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^20.17.30",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.6",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}