pi-kot 0.1.39 → 0.1.41

package/dist/server/processes/log-store.d.ts

@@ -0,0 +1,24 @@
+export declare const ROLLING_LINES_CAP = 200;
+export declare function processLogDir(baseDir: string, sessionId: string, processId: string): string;
+/**
+ * Manages an on-disk append-only log file alongside an in-memory
+ * rolling line tail for fast output retrieval.
+ */
+export declare class LogChannel {
+    readonly filePath: string;
+    private stream;
+    private pendingInit;
+    private lineRemainder;
+    private readonly lines;
+    constructor(filePath: string);
+    private ensureStream;
+    append(chunk: Buffer, onLine?: (line: string) => void): void;
+    private pushLine;
+    tail(count?: number): string[];
+    close(): Promise<void>;
+}
+/**
+ * Read the tail of a log file directly from disk (fallback/utility).
+ */
+export declare function readTailFromFile(filePath: string, maxLines?: number): Promise<string[]>;
+//# sourceMappingURL=log-store.d.ts.map

package/dist/server/processes/log-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-store.d.ts","sourceRoot":"","sources":["../../src/processes/log-store.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE3F;AAED;;;GAGG;AACH,qBAAa,UAAU;aAMO,QAAQ,EAAE,MAAM;IAL5C,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,aAAa,CAAM;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IAEtC,YAA4B,QAAQ,EAAE,MAAM,EAAI;YAElC,YAAY;IAY1B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAY3D;IAED,OAAO,CAAC,QAAQ;IAOhB,IAAI,CAAC,KAAK,GAAE,MAA0B,GAAG,MAAM,EAAE,CAMhD;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAW3B;CACF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAWlG"}

package/dist/server/processes/log-store.js

@@ -0,0 +1,86 @@
+import { createWriteStream } from "node:fs";
+import { mkdir, readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+export const ROLLING_LINES_CAP = 200;
+export function processLogDir(baseDir, sessionId, processId) {
+    return join(baseDir, "processes", sessionId, processId);
+}
+/**
+ * Manages an on-disk append-only log file alongside an in-memory
+ * rolling line tail for fast output retrieval.
+ */
+export class LogChannel {
+    filePath;
+    stream = null;
+    pendingInit = null;
+    lineRemainder = "";
+    lines = [];
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    async ensureStream() {
+        if (this.stream !== null)
+            return this.stream;
+        if (this.pendingInit === null) {
+            this.pendingInit = (async () => {
+                await mkdir(dirname(this.filePath), { recursive: true });
+                this.stream = createWriteStream(this.filePath, { flags: "a", encoding: "utf8" });
+            })();
+        }
+        await this.pendingInit;
+        return this.stream;
+    }
+    append(chunk, onLine) {
+        const text = chunk.toString("utf8");
+        void this.ensureStream().then((s) => s.write(text));
+        const combined = this.lineRemainder + text;
+        const parts = combined.split("\n");
+        this.lineRemainder = parts.pop() ?? "";
+        for (const line of parts) {
+            this.pushLine(line);
+            onLine?.(line);
+        }
+    }
+    pushLine(line) {
+        this.lines.push(line);
+        if (this.lines.length > ROLLING_LINES_CAP) {
+            this.lines.shift();
+        }
+    }
+    tail(count = ROLLING_LINES_CAP) {
+        const res = [...this.lines];
+        if (this.lineRemainder.length > 0) {
+            res.push(this.lineRemainder);
+        }
+        return res.slice(-count);
+    }
+    async close() {
+        if (this.lineRemainder.length > 0) {
+            this.pushLine(this.lineRemainder);
+            this.lineRemainder = "";
+        }
+        if (this.stream !== null) {
+            await new Promise((resolve) => {
+                this.stream.end(() => resolve());
+            });
+            this.stream = null;
+        }
+    }
+}
+/**
+ * Read the tail of a log file directly from disk (fallback/utility).
+ */
+export async function readTailFromFile(filePath, maxLines = 200) {
+    try {
+        const content = await readFile(filePath, "utf8");
+        const lines = content.split("\n");
+        if (lines.length > 0 && lines[lines.length - 1] === "") {
+            lines.pop();
+        }
+        return lines.slice(-maxLines);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=log-store.js.map

package/dist/server/processes/log-store.js.map

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

package/dist/server/processes/manager.d.ts

@@ -0,0 +1,56 @@
+import { type KillResult, type ManagerEvent, type ProcessInfo, type ProcessStatus, type StartOptions, type WriteResult } from "./types.js";
+type Listener = (event: ManagerEvent) => void;
+export declare class ProcessManager {
+    private readonly bySession;
+    private readonly listeners;
+    subscribe(fn: Listener): () => void;
+    private notify;
+    private getOrCreateSession;
+    /**
+     * Spawn a new background process bound to a session.
+     */
+    start(sessionId: string, name: string, command: string, cwd: string, opts?: StartOptions): ProcessInfo;
+    private finalize;
+    /**
+     * List all processes for a session.
+     */
+    list(sessionId: string): ProcessInfo[];
+    /**
+     * Get a single process info by ID.
+     */
+    get(sessionId: string, id: string): ProcessInfo | undefined;
+    /**
+     * Get recent stdout/stderr output lines for a process.
+     */
+    getOutput(sessionId: string, id: string, lineCount?: number): {
+        stdout: string[];
+        stderr: string[];
+        status: ProcessStatus;
+    } | undefined;
+    /**
+     * Get on-disk log file paths for a process.
+     */
+    getLogFiles(sessionId: string, id: string): {
+        stdoutFile: string;
+        stderrFile: string;
+    } | undefined;
+    /**
+     * Terminate a process: SIGTERM -> wait GRACE_MS -> SIGKILL.
+     */
+    kill(sessionId: string, id: string): Promise<KillResult>;
+    /**
+     * Write to process stdin.
+     */
+    write(sessionId: string, id: string, input: string, end?: boolean): WriteResult;
+    /**
+     * Remove finished / exited / killed processes from the session state.
+     */
+    clearFinished(sessionId: string): number;
+    /**
+     * Kill all processes and clean up when a session is disposed.
+     */
+    disposeSession(sessionId: string): Promise<void>;
+}
+export declare const processManager: ProcessManager;
+export {};
+//# sourceMappingURL=manager.d.ts.map

package/dist/server/processes/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/processes/manager.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EACjB,MAAM,YAAY,CAAC;AAoBpB,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAW9C,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAKlC;IAED,OAAO,CAAC,MAAM;IAUd,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,YAAiB,GACtB,WAAW,CAyIb;YAEa,QAAQ;IAQtB;;OAEG;IACH,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAMrC;IAED;;OAEG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAE1D;IAED;;OAEG;IACH,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,EACV,SAAS,GAAE,MAAY,GACtB;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,GAAG,SAAS,CAQ3E;IAED;;OAEG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,MAAM,GACT;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAOxD;IAED;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2D7D;IAED;;OAEG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,GAAE,OAAe,GAAG,WAAW,CAoBrF;IAED;;OAEG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAgBvC;IAED;;OAEG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrD;CACF;AAED,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/dist/server/processes/manager.js

@@ -0,0 +1,343 @@
+import { spawn } from "node:child_process";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+import { config } from "../config.js";
+import { LogChannel, processLogDir } from "./log-store.js";
+import { buildMatchEvent, compileWatches, evaluateWatches } from "./watches.js";
+import { LIVE_STATUSES, } from "./types.js";
+const GRACE_MS = 5_000;
+const SIGKILL_TIMEOUT_MS = 2_000;
+function sanitizeEnvironment(extra = {}) {
+    const env = { ...process.env, ...extra };
+    // Clean sensitive server credentials from child process environment
+    delete env.API_KEY;
+    delete env.UI_PASSWORD;
+    delete env.JWT_SECRET;
+    return env;
+}
+export class ProcessManager {
+    bySession = new Map();
+    listeners = new Set();
+    subscribe(fn) {
+        this.listeners.add(fn);
+        return () => {
+            this.listeners.delete(fn);
+        };
+    }
+    notify(event) {
+        for (const fn of this.listeners) {
+            try {
+                fn(event);
+            }
+            catch {
+                // Listener errors must not crash manager
+            }
+        }
+    }
+    getOrCreateSession(sessionId) {
+        let s = this.bySession.get(sessionId);
+        if (s === undefined) {
+            s = { sessionId, processes: new Map() };
+            this.bySession.set(sessionId, s);
+        }
+        return s;
+    }
+    /**
+     * Spawn a new background process bound to a session.
+     */
+    start(sessionId, name, command, cwd, opts = {}) {
+        const session = this.getOrCreateSession(sessionId);
+        const id = randomBytes(4).toString("hex");
+        const logDir = processLogDir(config.forgeDataDir, sessionId, id);
+        const stdoutFile = join(logDir, "stdout.log");
+        const stderrFile = join(logDir, "stderr.log");
+        // Spawn under `/bin/sh -c` with detached: true so kill(-pid) kills the whole process group
+        const child = spawn("/bin/sh", ["-c", command], {
+            cwd,
+            env: sanitizeEnvironment(opts.toolEnv),
+            stdio: ["pipe", "pipe", "pipe"],
+            detached: true,
+        });
+        const info = {
+            id,
+            name,
+            pid: child.pid ?? -1,
+            command,
+            cwd,
+            startTime: Date.now(),
+            endTime: null,
+            status: "running",
+            exitCode: null,
+            success: null,
+            stdoutFile,
+            stderrFile,
+            alertOnSuccess: opts.alertOnSuccess === true,
+            alertOnFailure: opts.alertOnFailure !== false, // default true
+            alertOnKill: opts.alertOnKill === true,
+        };
+        const managed = {
+            info,
+            child,
+            stdout: new LogChannel(stdoutFile),
+            stderr: new LogChannel(stderrFile),
+            watches: compileWatches(opts.logWatches),
+            killSent: null,
+            killTimer: null,
+        };
+        session.processes.set(id, managed);
+        const wireUp = (source) => {
+            const stream = source === "stdout" ? child.stdout : child.stderr;
+            const channel = source === "stdout" ? managed.stdout : managed.stderr;
+            stream.on("data", (chunk) => {
+                channel.append(chunk, (line) => {
+                    const hits = evaluateWatches(managed.watches, source, line);
+                    for (const w of hits) {
+                        this.notify({
+                            type: "process_watch_matched",
+                            sessionId,
+                            match: buildMatchEvent(w, id, name, command, source, line),
+                        });
+                    }
+                });
+                this.notify({ type: "process_output_changed", sessionId, id });
+            });
+        };
+        wireUp("stdout");
+        wireUp("stderr");
+        child.on("error", (err) => {
+            const text = `[spawn error] ${err.message}\n`;
+            managed.stderr.append(Buffer.from(text, "utf8"));
+            info.endTime = Date.now();
+            info.exitCode = -1;
+            info.success = false;
+            info.status = "exited";
+            this.notify({ type: "process_ended", sessionId, info });
+            this.notify({ type: "processes_changed", sessionId });
+            if (info.alertOnFailure) {
+                this.notify({
+                    type: "process_alert",
+                    sessionId,
+                    info,
+                    reason: "failure",
+                });
+            }
+            void this.finalize(managed);
+        });
+        child.on("close", (code, signal) => {
+            info.endTime = Date.now();
+            info.exitCode = typeof code === "number" ? code : null;
+            const killedByUs = managed.killSent !== null;
+            const killedExternally = !killedByUs && signal !== null;
+            const wasKilled = killedByUs || killedExternally;
+            info.status = wasKilled ? "killed" : "exited";
+            info.success = info.exitCode === 0 && !wasKilled;
+            if (managed.killTimer !== null) {
+                clearTimeout(managed.killTimer);
+                managed.killTimer = null;
+            }
+            this.notify({ type: "process_ended", sessionId, info });
+            this.notify({ type: "processes_changed", sessionId });
+            // Determine alert notifications
+            if (info.success && info.alertOnSuccess) {
+                this.notify({
+                    type: "process_alert",
+                    sessionId,
+                    info,
+                    reason: "success",
+                });
+            }
+            else if (!info.success && !wasKilled && info.alertOnFailure) {
+                this.notify({
+                    type: "process_alert",
+                    sessionId,
+                    info,
+                    reason: "failure",
+                });
+            }
+            else if (killedExternally && info.alertOnKill) {
+                this.notify({
+                    type: "process_alert",
+                    sessionId,
+                    info,
+                    reason: "killed",
+                });
+            }
+            void this.finalize(managed);
+        });
+        this.notify({ type: "process_started", sessionId, info });
+        this.notify({ type: "processes_changed", sessionId });
+        return info;
+    }
+    async finalize(managed) {
+        try {
+            await Promise.all([managed.stdout.close(), managed.stderr.close()]);
+        }
+        catch {
+            // best-effort
+        }
+    }
+    /**
+     * List all processes for a session.
+     */
+    list(sessionId) {
+        const session = this.bySession.get(sessionId);
+        if (!session)
+            return [];
+        return Array.from(session.processes.values())
+            .map((m) => ({ ...m.info }))
+            .sort((a, b) => b.startTime - a.startTime);
+    }
+    /**
+     * Get a single process info by ID.
+     */
+    get(sessionId, id) {
+        return this.bySession.get(sessionId)?.processes.get(id)?.info;
+    }
+    /**
+     * Get recent stdout/stderr output lines for a process.
+     */
+    getOutput(sessionId, id, lineCount = 200) {
+        const managed = this.bySession.get(sessionId)?.processes.get(id);
+        if (!managed)
+            return undefined;
+        return {
+            stdout: managed.stdout.tail(lineCount),
+            stderr: managed.stderr.tail(lineCount),
+            status: managed.info.status,
+        };
+    }
+    /**
+     * Get on-disk log file paths for a process.
+     */
+    getLogFiles(sessionId, id) {
+        const managed = this.bySession.get(sessionId)?.processes.get(id);
+        if (!managed)
+            return undefined;
+        return {
+            stdoutFile: managed.info.stdoutFile,
+            stderrFile: managed.info.stderrFile,
+        };
+    }
+    /**
+     * Terminate a process: SIGTERM -> wait GRACE_MS -> SIGKILL.
+     */
+    async kill(sessionId, id) {
+        const managed = this.bySession.get(sessionId)?.processes.get(id);
+        if (!managed)
+            return { ok: false, info: undefined, reason: "not_found" };
+        if (!LIVE_STATUSES.has(managed.info.status)) {
+            return { ok: true, info: managed.info };
+        }
+        managed.info.status = "terminating";
+        managed.killSent = "SIGTERM";
+        this.notify({ type: "processes_changed", sessionId });
+        const sendSignal = (sig) => {
+            const pid = managed.child.pid;
+            if (pid === undefined)
+                return;
+            try {
+                // Signal the whole process group (detached process)
+                process.kill(-pid, sig);
+            }
+            catch {
+                try {
+                    managed.child.kill(sig);
+                }
+                catch {
+                    // already exited
+                }
+            }
+        };
+        sendSignal("SIGTERM");
+        return new Promise((resolve) => {
+            let resolved = false;
+            const finish = (result) => {
+                if (resolved)
+                    return;
+                resolved = true;
+                if (managed.killTimer !== null) {
+                    clearTimeout(managed.killTimer);
+                    managed.killTimer = null;
+                }
+                resolve(result);
+            };
+            managed.child.once("close", () => {
+                finish({ ok: true, info: managed.info });
+            });
+            managed.killTimer = setTimeout(() => {
+                if (!LIVE_STATUSES.has(managed.info.status))
+                    return;
+                managed.info.status = "terminate_timeout";
+                managed.killSent = "SIGKILL";
+                this.notify({ type: "processes_changed", sessionId });
+                sendSignal("SIGKILL");
+                managed.killTimer = setTimeout(() => {
+                    finish({ ok: false, info: managed.info, reason: "timeout" });
+                }, SIGKILL_TIMEOUT_MS);
+            }, GRACE_MS);
+        });
+    }
+    /**
+     * Write to process stdin.
+     */
+    write(sessionId, id, input, end = false) {
+        const managed = this.bySession.get(sessionId)?.processes.get(id);
+        if (!managed)
+            return { ok: false, reason: "not_found" };
+        if (!LIVE_STATUSES.has(managed.info.status)) {
+            return { ok: false, reason: "process_exited" };
+        }
+        const stdin = managed.child.stdin;
+        if (!stdin || stdin.destroyed || stdin.writableEnded) {
+            return { ok: false, reason: "stdin_closed" };
+        }
+        try {
+            stdin.write(input);
+            if (end)
+                stdin.end();
+            return { ok: true };
+        }
+        catch {
+            return { ok: false, reason: "write_error" };
+        }
+    }
+    /**
+     * Remove finished / exited / killed processes from the session state.
+     */
+    clearFinished(sessionId) {
+        const session = this.bySession.get(sessionId);
+        if (!session)
+            return 0;
+        let cleared = 0;
+        for (const [id, proc] of session.processes.entries()) {
+            if (!LIVE_STATUSES.has(proc.info.status)) {
+                session.processes.delete(id);
+                cleared++;
+            }
+        }
+        if (cleared > 0) {
+            this.notify({ type: "processes_changed", sessionId });
+        }
+        return cleared;
+    }
+    /**
+     * Kill all processes and clean up when a session is disposed.
+     */
+    async disposeSession(sessionId) {
+        const session = this.bySession.get(sessionId);
+        if (!session)
+            return;
+        const liveProcesses = Array.from(session.processes.values()).filter((p) => LIVE_STATUSES.has(p.info.status));
+        await Promise.all(liveProcesses.map(async (proc) => {
+            try {
+                await this.kill(sessionId, proc.info.id);
+            }
+            catch {
+                // best-effort cleanup
+            }
+        }));
+        this.bySession.delete(sessionId);
+    }
+}
+export const processManager = new ProcessManager();
+//# sourceMappingURL=manager.js.map

package/dist/server/processes/manager.js.map

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

package/dist/server/processes/processes.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=processes.test.d.ts.map

package/dist/server/processes/processes.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processes.test.d.ts","sourceRoot":"","sources":["../../src/processes/processes.test.ts"],"names":[],"mappings":""}

package/dist/server/processes/processes.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, afterEach } from "vitest";
+import { processManager } from "./manager.js";
+import { createProcessTool } from "./tool.js";
+const TEST_SESSION = "test-session-" + Date.now();
+describe("Background Process Manager", () => {
+    afterEach(async () => {
+        await processManager.disposeSession(TEST_SESSION);
+    });
+    it("starts, lists, and kills a process", async () => {
+        const info = processManager.start(TEST_SESSION, "test-echo", "node -e 'setInterval(() => console.log(\"hello\"), 100)'", process.cwd());
+        expect(info.id).toBeDefined();
+        expect(info.status).toBe("running");
+        expect(info.pid).toBeGreaterThan(0);
+        const list = processManager.list(TEST_SESSION);
+        expect(list.length).toBe(1);
+        expect(list[0].id).toBe(info.id);
+        // Wait a brief moment for output
+        await new Promise((r) => setTimeout(r, 250));
+        const out = processManager.getOutput(TEST_SESSION, info.id);
+        expect(out).toBeDefined();
+        expect(out?.stdout.some((line) => line.includes("hello"))).toBe(true);
+        const killRes = await processManager.kill(TEST_SESSION, info.id);
+        expect(killRes.ok).toBe(true);
+        // After kill, status should update to killed or exited
+        const updated = processManager.get(TEST_SESSION, info.id);
+        expect(["killed", "exited"]).toContain(updated?.status);
+    });
+    it("writes to stdin and receives response", async () => {
+        const info = processManager.start(TEST_SESSION, "test-stdin", "node -e 'process.stdin.on(\"data\", d => console.log(\"echo:\" + d.toString().trim()))'", process.cwd());
+        await new Promise((r) => setTimeout(r, 100));
+        const writeRes = processManager.write(TEST_SESSION, info.id, "pi-kot\n");
+        expect(writeRes.ok).toBe(true);
+        await new Promise((r) => setTimeout(r, 200));
+        const out = processManager.getOutput(TEST_SESSION, info.id);
+        expect(out?.stdout.some((line) => line.includes("echo:pi-kot"))).toBe(true);
+        await processManager.kill(TEST_SESSION, info.id);
+    });
+    it("triggers logWatches regex matches", async () => {
+        const matchedLines = [];
+        const unsubscribe = processManager.subscribe((ev) => {
+            if (ev.type === "process_watch_matched") {
+                matchedLines.push(ev.match.line);
+            }
+        });
+        const info = processManager.start(TEST_SESSION, "test-watch", "node -e 'console.log(\"READY: server started\"); setInterval(() => {}, 100)'", process.cwd(), {
+            logWatches: [{ pattern: "READY: .*" }],
+        });
+        await new Promise((r) => setTimeout(r, 300));
+        expect(matchedLines.length).toBeGreaterThanOrEqual(1);
+        expect(matchedLines[0]).toContain("READY: server started");
+        unsubscribe();
+        await processManager.kill(TEST_SESSION, info.id);
+    });
+    it("clears finished processes", async () => {
+        const info = processManager.start(TEST_SESSION, "quick-exit", "node -e 'process.exit(0)'", process.cwd());
+        await new Promise((r) => setTimeout(r, 200));
+        const cleared = processManager.clearFinished(TEST_SESSION);
+        expect(cleared).toBe(1);
+        const list = processManager.list(TEST_SESSION);
+        expect(list.length).toBe(0);
+    });
+    it("executes through createProcessTool wrapper", async () => {
+        const tool = createProcessTool(TEST_SESSION, process.cwd());
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const execTool = tool.execute;
+        const startRes = await execTool("call-1", {
+            action: "start",
+            name: "tool-test",
+            command: "node -e 'console.log(\"from-tool\"); setInterval(() => {}, 100)'",
+        });
+        expect(startRes.details.success).toBe(true);
+        const procId = startRes.details.process.id;
+        await new Promise((r) => setTimeout(r, 200));
+        const listRes = await execTool("call-2", { action: "list" });
+        expect(listRes.details.success).toBe(true);
+        expect(listRes.details.processes.length).toBe(1);
+        const outRes = await execTool("call-3", { action: "output", id: procId });
+        expect(outRes.details.success).toBe(true);
+        const firstContent = outRes.content[0];
+        expect(firstContent.text).toContain("from-tool");
+        const killRes = await execTool("call-4", { action: "kill", id: procId });
+        expect(killRes.details.success).toBe(true);
+    });
+});
+//# sourceMappingURL=processes.test.js.map

package/dist/server/processes/processes.test.js.map

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