@thoughtflow/core 0.1.2

package/dist/tools/workspace/process-manager.tool.js

@@ -0,0 +1,227 @@
+"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.ProcessManagerTool = void 0;
+const zod_1 = require("zod");
+const path = __importStar(require("path"));
+const net = __importStar(require("net"));
+const child_process_1 = require("child_process");
+const tool_base_class_1 = require("../base/tool-base.class");
+/**
+ * Shared registry of background processes — one per tool instance.
+ * Stored on the instance so demo cleanup can call tool.killAll().
+ */
+class ProcessManagerTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "processManager";
+    description = "Manage long-running background processes (e.g. dev servers). " +
+        "Actions: start — spawn a command in background and return its PID; " +
+        "wait_ready — wait until a TCP port is accepting connections (call after start); " +
+        "stop — kill a process by PID; " +
+        "list — show all running managed processes; " +
+        "logs — show recent stdout/stderr for a PID.";
+    /** list / logs / wait_ready are read-only; start / stop mutate process state. */
+    isReadOnly(input) {
+        const action = input["action"];
+        return action === "list" || action === "logs" || action === "wait_ready";
+    }
+    procs = new Map();
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            action: zod_1.z
+                .enum(["start", "stop", "list", "logs", "wait_ready"])
+                .describe("start | stop | list | logs | wait_ready"),
+            command: zod_1.z
+                .string()
+                .optional()
+                .describe("Shell command to run in background (required for 'start')"),
+            pid: zod_1.z
+                .number()
+                .optional()
+                .describe("PID to stop or get logs for (required for 'stop' and 'logs')"),
+            port: zod_1.z
+                .number()
+                .optional()
+                .describe("TCP port to poll for readiness (required for 'wait_ready')"),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, ctx) {
+        const { action, command, pid, port } = input;
+        switch (action) {
+            case "start":
+                return this.startProcess(command, ctx);
+            case "wait_ready":
+                return this.waitReady(port);
+            case "stop":
+                return this.stopProcess(pid);
+            case "list":
+                return this.listProcesses();
+            case "logs":
+                return this.getProcessLogs(pid);
+        }
+    }
+    // ─── start ────────────────────────────────────────────────────────────────
+    startProcess(command, ctx) {
+        if (!command?.trim()) {
+            return {
+                success: false,
+                error: "start requires a command. Usage: processManager with { action: 'start', command: 'node server.js' }",
+            };
+        }
+        const root = path.resolve(this.rootDir);
+        const outputLines = [];
+        const proc = (0, child_process_1.spawn)("sh", ["-c", command], {
+            cwd: root,
+            env: { ...process.env },
+            detached: false,
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        if (proc.pid == null) {
+            return { success: false, error: "Failed to spawn process (no PID)" };
+        }
+        const pid = proc.pid;
+        const onData = (data) => {
+            const text = data.toString();
+            // Keep last 200 lines
+            const incoming = text.split("\n");
+            outputLines.push(...incoming);
+            if (outputLines.length > 200)
+                outputLines.splice(0, outputLines.length - 200);
+            // Stream live via emitProgress
+            ctx.emitProgress?.(text, { pid, status: "STREAMING" });
+        };
+        proc.stdout?.on("data", onData);
+        proc.stderr?.on("data", onData);
+        proc.on("exit", (code) => {
+            const managed = this.procs.get(pid);
+            if (managed) {
+                const msg = `Process ${pid} exited with code ${code}`;
+                managed.outputLines.push(msg);
+                ctx.emitProgress?.(msg, { pid, status: "STREAMING" });
+                this.procs.delete(pid);
+            }
+        });
+        this.procs.set(pid, {
+            pid,
+            command,
+            startedAt: new Date().toISOString(),
+            proc,
+            outputLines,
+        });
+        return {
+            success: true,
+            output: `Started: PID ${pid}  command: ${command}`,
+        };
+    }
+    // ─── wait_ready ──────────────────────────────────────────────────────────────
+    waitReady(port) {
+        if (port == null)
+            return Promise.resolve({ success: false, error: "wait_ready requires a 'port' field. Example: { action: 'wait_ready', port: 6581 }" });
+        return new Promise((resolve) => {
+            const deadline = Date.now() + 5000;
+            const attempt = () => {
+                const sock = net.createConnection({ port, host: "127.0.0.1" });
+                sock.once("connect", () => {
+                    sock.destroy();
+                    resolve({ success: true, output: `Port ${port} is ready.` });
+                });
+                sock.once("error", () => {
+                    sock.destroy();
+                    if (Date.now() < deadline) {
+                        sock.removeAllListeners();
+                        setTimeout(attempt, 150);
+                    }
+                    else {
+                        resolve({ success: false, error: `Port ${port} not available after 5s` });
+                    }
+                });
+            };
+            attempt();
+        });
+    }
+    // ─── stop ─────────────────────────────────────────────────────────────────
+    stopProcess(pid) {
+        if (pid == null)
+            return { success: false, error: "stop requires a 'pid' field (number). Use 'list' action first to find the PID. Example: { action: 'stop', pid: 12345 }" };
+        const managed = this.procs.get(pid);
+        if (!managed) {
+            return { success: false, error: `No managed process with PID ${pid}` };
+        }
+        try {
+            // Kill the process group to also kill child processes
+            process.kill(-managed.proc.pid, "SIGTERM");
+        }
+        catch {
+            try {
+                managed.proc.kill("SIGTERM");
+            }
+            catch { /* already dead */ }
+        }
+        this.procs.delete(pid);
+        return { success: true, output: `Stopped PID ${pid} (${managed.command})` };
+    }
+    // ─── list ─────────────────────────────────────────────────────────────────
+    listProcesses() {
+        if (this.procs.size === 0) {
+            return { success: true, output: "No managed processes running." };
+        }
+        const lines = [...this.procs.values()].map((p) => `PID ${p.pid}  started ${p.startedAt}  cmd: ${p.command}`);
+        return { success: true, output: lines.join("\n") };
+    }
+    // ─── logs ─────────────────────────────────────────────────────────────────
+    getProcessLogs(pid) {
+        if (pid == null)
+            return { success: false, error: "logs requires a 'pid' field (number). Use 'list' action first to find the PID. Example: { action: 'logs', pid: 12345 }" };
+        const managed = this.procs.get(pid);
+        if (!managed) {
+            return { success: false, error: `No managed process with PID ${pid}` };
+        }
+        const last = managed.outputLines.slice(-50).join("\n");
+        return { success: true, output: last || "(no output yet)" };
+    }
+    // ─── cleanup (called by demo on exit) ─────────────────────────────────────
+    killAll() {
+        for (const [pid, managed] of this.procs) {
+            try {
+                managed.proc.kill("SIGTERM");
+            }
+            catch { /* ignore */ }
+            this.procs.delete(pid);
+        }
+    }
+}
+exports.ProcessManagerTool = ProcessManagerTool;
+//# sourceMappingURL=process-manager.tool.js.map

package/dist/tools/workspace/process-manager.tool.js.map

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

package/dist/tools/workspace/project-context.tool.d.ts

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

package/dist/tools/workspace/project-context.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-context.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/project-context.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAgBnE,qBAAa,kBAAmB,SAAQ,QAAQ;IASlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IARpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAIoD;gBAE3C,OAAO,EAAE,MAAM;IAStC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC;CA+D3F"}

package/dist/tools/workspace/project-context.tool.js

@@ -0,0 +1,124 @@
+"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.ProjectContextTool = 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");
+/** Convention / context files searched in order. */
+const CONTEXT_FILES = [
+    "CLAUDE.md",
+    "AGENTS.md",
+    "COPILOT.md",
+    "copilot-instructions.md",
+    ".cursorrules",
+    "README.md",
+];
+const ACTIONS = ["scan", "conventions", "list"];
+class ProjectContextTool extends tool_base_class_1.ToolBase {
+    rootDir;
+    name = "projectContext";
+    readonly = true;
+    description = "Read project conventions and guidelines from well-known documentation files " +
+        "(CLAUDE.md, AGENTS.md, COPILOT.md, copilot-instructions.md, .cursorrules, README.md). " +
+        "Actions: 'scan' = check which files exist; 'conventions' = concatenate content of all found files; " +
+        "'list' = same as scan but returns a simple list of found filenames.";
+    constructor(rootDir) {
+        super(zod_1.z.object({
+            action: zod_1.z.enum(ACTIONS).describe("'scan' = list found files with sizes; 'conventions' = full content; 'list' = filenames only"),
+            path: zod_1.z.string().optional().describe("Subdirectory to search in (relative to rootDir). Defaults to rootDir."),
+        }));
+        this.rootDir = rootDir;
+    }
+    async run(input, _ctx) {
+        const action = input["action"] ?? "scan";
+        const relPath = input["path"] ?? ".";
+        const searchRoot = (0, path_utils_1.resolveSafePath)(this.rootDir, relPath);
+        if (!searchRoot) {
+            return { success: false, error: "Path traversal not allowed." };
+        }
+        if (!fs.existsSync(searchRoot)) {
+            return { success: false, error: `Directory not found: ${relPath}` };
+        }
+        // Collect found files with content
+        const found = [];
+        for (const filename of CONTEXT_FILES) {
+            const fullPath = path.join(searchRoot, filename);
+            if (fs.existsSync(fullPath)) {
+                try {
+                    const content = fs.readFileSync(fullPath, "utf-8");
+                    found.push({ file: filename, content });
+                }
+                catch {
+                    // unreadable — skip silently
+                }
+            }
+        }
+        if (found.length === 0) {
+            return {
+                success: true,
+                output: "No convention files found.",
+                data: { found: [], files: [] },
+            };
+        }
+        if (action === "list") {
+            const files = found.map((f) => f.file);
+            return {
+                success: true,
+                output: files.join("\n"),
+                data: { files },
+            };
+        }
+        if (action === "scan") {
+            const lines = found.map((f) => `${f.file} (${f.content.length} chars, ${f.content.split("\n").length} lines)`);
+            return {
+                success: true,
+                output: lines.join("\n"),
+                data: { found: found.map((f) => ({ file: f.file, size: f.content.length })) },
+            };
+        }
+        // action === "conventions" — concatenate all
+        const sections = found.map((f) => `${"=".repeat(60)}\n# ${f.file}\n${"=".repeat(60)}\n${f.content}`);
+        return {
+            success: true,
+            output: sections.join("\n\n"),
+            data: { files: found.map((f) => f.file) },
+        };
+    }
+}
+exports.ProjectContextTool = ProjectContextTool;
+//# sourceMappingURL=project-context.tool.js.map

package/dist/tools/workspace/project-context.tool.js.map

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

package/dist/tools/workspace/project-scanner.tool.d.ts

@@ -0,0 +1,56 @@
+import { ToolBase } from "../base/tool-base.class";
+import { ToolContext, ToolExecutionResult } from "../../contracts";
+export type TechCategory = "language" | "framework" | "database" | "infra" | "testing" | "build";
+export interface TechRule {
+    id: string;
+    name: string;
+    category: TechCategory;
+    /** Files whose existence signals this tech (relative to scanned dir). */
+    fileMarkers: string[];
+    /** Directories whose existence signals this tech. */
+    dirMarkers: string[];
+    /** package.json / composer.json dependency names that signal this tech. */
+    packageDeps?: string[];
+    /** Directories to skip when this tech is detected. */
+    ignoreDirs: string[];
+    /** Important files worth reading (only shown when they exist). */
+    keyFiles: string[];
+    /** Glob patterns for find_files exploration. */
+    explorePatterns: string[];
+    /** Short actionable hints for the LLM. */
+    hints: string[];
+}
+export interface MonorepoRule {
+    id: string;
+    name: string;
+    /** Files in root that indicate this monorepo tool. */
+    fileMarkers: string[];
+    /** Conventional sub-dirs that contain sub-projects (e.g. apps, libs). */
+    workspaceDirs: string[];
+    ignoreDirs: string[];
+    hints: string[];
+}
+export declare const TECH_RULES: TechRule[];
+export declare const MONOREPO_RULES: MonorepoRule[];
+export declare class ProjectScannerTool extends ToolBase {
+    private readonly rootDir;
+    readonly name = "projectScanner";
+    readonly readonly = true;
+    readonly description: string;
+    constructor(rootDir: string);
+    run(input: Record<string, unknown>, _ctx: ToolContext): Promise<ToolExecutionResult>;
+    private scan;
+    private scanWorkspaceDir;
+    /**
+     * Fallback: scan top-level dirs that have their own config file
+     * (looks like independent projects grouped in a directory).
+     */
+    private detectPlainSubProjects;
+    private detectTechs;
+    private detectByExtension;
+    private readPackageJson;
+    private readDeps;
+    private format;
+    private formatSection;
+}
+//# sourceMappingURL=project-scanner.tool.d.ts.map

package/dist/tools/workspace/project-scanner.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-scanner.tool.d.ts","sourceRoot":"","sources":["../../../src/tools/workspace/project-scanner.tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AASnE,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,WAAW,GACX,UAAU,GACV,OAAO,GACP,SAAS,GACT,OAAO,CAAC;AAEZ,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,yEAAyE;IACzE,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qDAAqD;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sDAAsD;IACtD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gDAAgD;IAChD,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,0CAA0C;IAC1C,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,yEAAyE;IACzE,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAQD,eAAO,MAAM,UAAU,EAAE,QAAQ,EAqiBhC,CAAC;AAMF,eAAO,MAAM,cAAc,EAAE,YAAY,EA4CxC,CAAC;AA8BF,qBAAa,kBAAmB,SAAQ,QAAQ;IAWlC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAVpC,QAAQ,CAAC,IAAI,oBAAoB;IACjC,SAAkB,QAAQ,QAAQ;IAClC,QAAQ,CAAC,WAAW,SAM4B;gBAEnB,OAAO,EAAE,MAAM;IAatC,GAAG,CACP,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,OAAO,CAAC,IAAI;IAiDZ,OAAO,CAAC,gBAAgB;IA2BxB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IA0C9B,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,iBAAiB;IAqBzB,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,QAAQ;IAsChB,OAAO,CAAC,MAAM;IAmDd,OAAO,CAAC,aAAa;CAiDtB"}