pi-kot 0.1.39 → 0.1.40

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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"}

package/dist/server/processes/prompt-strings.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompt snippets and guidelines for the background process tool.
+ */
+export declare const PROMPT_SNIPPET = "Manage background processes without blocking the conversation";
+export declare const PROMPT_GUIDELINES: string[];
+export declare const TOOL_DESCRIPTION = "Manage background processes. Actions:\n- start: Run command in background (requires 'name' and 'command')\n  - alertOnSuccess (default: false): Show an informational notification on clean completion; does not wake the agent\n  - alertOnFailure (default: true): Get a turn to react when process crashes/fails\n  - alertOnKill (default: false): Get a turn to react if killed by external signal (killing via tool never triggers a turn)\n  - logWatches (optional): Runtime output watches that trigger immediate alerts while running\n    - pattern: regex string to match per output line\n    - stream: stdout | stderr | both (default both)\n    - repeat: false by default (single-fire). Set true for repeat alerts\n- list: Show all managed processes with their IDs and names\n- output: Get recent stdout/stderr (requires 'id')\n- logs: Get log file paths to inspect with read tool (requires 'id')\n- kill: Terminate a process (requires 'id')\n- clear: Remove all finished processes from the list\n- write: Write to process stdin (requires 'id' and 'input', optional 'end' to close stdin)\n\nImportant: Use bash when you need a command's result before continuing in the current turn. Use process for asynchronous/background work only. You DON'T need to poll or wait for processes. Do not repeatedly call list/output after start just to check whether the process has completed. Start processes and continue other work.";
+//# sourceMappingURL=prompt-strings.d.ts.map

package/dist/server/processes/prompt-strings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-strings.d.ts","sourceRoot":"","sources":["../../src/processes/prompt-strings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAO,MAAM,cAAc,kEAAkE,CAAC;AAE9F,eAAO,MAAM,iBAAiB,EAAE,MAAM,EAKrC,CAAC;AAEF,eAAO,MAAM,gBAAgB,w4CAgByS,CAAC"}

package/dist/server/processes/prompt-strings.js

@@ -0,0 +1,28 @@
+/**
+ * Prompt snippets and guidelines for the background process tool.
+ */
+export const PROMPT_SNIPPET = "Manage background processes without blocking the conversation";
+export const PROMPT_GUIDELINES = [
+    "Use the process tool for long-running commands such as dev servers, test watchers, build watchers, and log tails instead of bash.",
+    "Avoid shell background patterns such as &, nohup, disown, or setsid when the process tool fits.",
+    "After starting a process, continue other work instead of waiting for it. Do not repeatedly call list/output just to see whether it has finished.",
+    "Use bash instead when you need a command's result before continuing. Use process notify flags/logWatches only for asynchronous follow-up, especially failures or specific output patterns.",
+];
+export const TOOL_DESCRIPTION = `Manage background processes. Actions:
+- start: Run command in background (requires 'name' and 'command')
+  - alertOnSuccess (default: false): Show an informational notification on clean completion; does not wake the agent
+  - alertOnFailure (default: true): Get a turn to react when process crashes/fails
+  - alertOnKill (default: false): Get a turn to react if killed by external signal (killing via tool never triggers a turn)
+  - logWatches (optional): Runtime output watches that trigger immediate alerts while running
+    - pattern: regex string to match per output line
+    - stream: stdout | stderr | both (default both)
+    - repeat: false by default (single-fire). Set true for repeat alerts
+- list: Show all managed processes with their IDs and names
+- output: Get recent stdout/stderr (requires 'id')
+- logs: Get log file paths to inspect with read tool (requires 'id')
+- kill: Terminate a process (requires 'id')
+- clear: Remove all finished processes from the list
+- write: Write to process stdin (requires 'id' and 'input', optional 'end' to close stdin)
+
+Important: Use bash when you need a command's result before continuing in the current turn. Use process for asynchronous/background work only. You DON'T need to poll or wait for processes. Do not repeatedly call list/output after start just to check whether the process has completed. Start processes and continue other work.`;
+//# sourceMappingURL=prompt-strings.js.map

package/dist/server/processes/prompt-strings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-strings.js","sourceRoot":"","sources":["../../src/processes/prompt-strings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,+DAA+D,CAAC;AAE9F,MAAM,CAAC,MAAM,iBAAiB,GAAa;IACzC,mIAAmI;IACnI,iGAAiG;IACjG,kJAAkJ;IAClJ,4LAA4L;CAC7L,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;sUAgBsS,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { ToolDefinition } from "@earendil-works/pi-coding-agent";
+export declare function createProcessTool(sessionId: string, workspacePath: string): ToolDefinition;
+//# sourceMappingURL=tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../../src/processes/tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAyFtE,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,cAAc,CAsH1F"}