pi-forge 1.2.4 → 1.3.0

package/dist/server/processes/manager.js

@@ -0,0 +1,370 @@
+import { spawn } from "node:child_process";
+import { rm } from "node:fs/promises";
+import { randomBytes } from "node:crypto";
+import { join } from "node:path";
+import { config } from "../config.js";
+import { scrubbedEnv } from "../pty-manager.js";
+import { LogChannel, processLogDir } from "./log-store.js";
+import { buildMatchEvent, compileWatches, evaluateWatches } from "./watches.js";
+import { LIVE_STATUSES, } from "./types.js";
+/**
+ * Per-session background process manager. One instance per
+ * sessionId; `createManagerForSession` lazily constructs and
+ * registers. On session dispose the registry calls
+ * `disposeManagerForSession` which SIGTERMs every live process,
+ * waits briefly for graceful exit, escalates to SIGKILL, then
+ * removes the session's log directory.
+ *
+ * State is in-memory only by deliberate choice (matches
+ * `@aliou/pi-processes`): a server restart drops everything;
+ * the OS may leak the actual children if pi-forge crashes mid-
+ * lifecycle, same as the plugin.
+ */
+const GRACE_MS = 5_000;
+const SIGKILL_TIMEOUT_MS = 2_000;
+class ProcessManagerRegistry {
+    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 {
+                // best-effort fanout — listener errors must not break the 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 process bound to this 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` so the command can use shell
+        // features (pipes, &&, env expansion). Scrubbed env matches
+        // the terminal + quick-actions posture: no pi-forge / provider
+        // secrets leak to the child.
+        const child = spawn("/bin/sh", ["-c", command], {
+            cwd,
+            env: scrubbedEnv(),
+            stdio: ["pipe", "pipe", "pipe"],
+            // detached=false on purpose — when pi-forge exits, the OS
+            // sends SIGTERM to the process group via the parent's death,
+            // matching the plugin's behavior. detached=true would orphan
+            // processes; we want them tied to our lifetime.
+            detached: false,
+        });
+        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) => {
+            // Spawn failure path — child never came up. Surface as a
+            // failed exit so the agent gets a clean result.
+            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";
+            // Notify BEFORE async log cleanup so the UI updates
+            // immediately. Log dispose runs in the background.
+            this.notify({ type: "process_ended", sessionId, info });
+            this.notify({ type: "processes_changed", sessionId });
+            void this.finalize(managed);
+        });
+        child.on("close", (code, signal) => {
+            info.endTime = Date.now();
+            info.exitCode = typeof code === "number" ? code : null;
+            // `killSent` is set when WE called .kill() (via the `process
+            // kill` tool); `signal` is non-null when the child died from
+            // any signal (ours or external). Both contribute to "wasKilled"
+            // for the status display, but only the EXTERNAL case (signal
+            // present, killSent absent) triggers an `alertOnKill` —
+            // alerting the agent that it killed something is redundant
+            // and noisy.
+            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;
+            }
+            // Notify BEFORE flushing logs. The old order awaited
+            // stdout.dispose() + stderr.dispose() FIRST and only
+            // fanned out the status change after — for any process
+            // with non-trivial output, that gated the UI update on
+            // a multi-tick filesystem flush and made Kill feel
+            // broken (status visibly stuck on "terminating" until
+            // the flush finished). Status flip is what the user
+            // needs to see; log cleanup is bookkeeping.
+            this.notify({ type: "process_ended", sessionId, info });
+            this.notify({ type: "processes_changed", sessionId });
+            // Agent-alert events. The three alertOn* flags were captured
+            // at start() time; honor them now. Order chosen so a single
+            // outcome only fires one alert — a failure isn't ALSO a "non-
+            // success" alert, etc.
+            if (killedExternally && info.alertOnKill) {
+                this.notify({ type: "process_alert", sessionId, info, reason: "killed" });
+            }
+            else if (!wasKilled && info.exitCode === 0 && info.alertOnSuccess) {
+                this.notify({ type: "process_alert", sessionId, info, reason: "success" });
+            }
+            else if (!wasKilled && info.exitCode !== 0 && info.alertOnFailure) {
+                this.notify({ type: "process_alert", sessionId, info, reason: "failure" });
+            }
+            void this.finalize(managed);
+        });
+        this.notify({ type: "process_started", sessionId, info });
+        this.notify({ type: "processes_changed", sessionId });
+        return cloneInfo(info);
+    }
+    /**
+     * Async log-cleanup tail. Lifecycle notification fires
+     * synchronously from the close/error handler that called this;
+     * this method just flushes and closes the on-disk log streams
+     * so a slow filesystem can't delay the UI update.
+     */
+    async finalize(managed) {
+        await managed.stdout.dispose();
+        await managed.stderr.dispose();
+    }
+    /** List every process for this session, newest-first. */
+    list(sessionId) {
+        const s = this.bySession.get(sessionId);
+        if (s === undefined)
+            return [];
+        return [...s.processes.values()]
+            .map((m) => cloneInfo(m.info))
+            .sort((a, b) => b.startTime - a.startTime);
+    }
+    /** Recent tail of stdout/stderr for a single process. */
+    output(sessionId, id, tail = 200) {
+        const m = this.getManaged(sessionId, id);
+        if (m === undefined)
+            return undefined;
+        return {
+            stdout: m.stdout.tail(tail),
+            stderr: m.stderr.tail(tail),
+            status: m.info.status,
+        };
+    }
+    logFiles(sessionId, id) {
+        const m = this.getManaged(sessionId, id);
+        if (m === undefined)
+            return undefined;
+        return { stdoutFile: m.info.stdoutFile, stderrFile: m.info.stderrFile };
+    }
+    /**
+     * Kill a process. SIGTERM, 5 s grace, then SIGKILL. Resolves
+     * once we've initiated the signal — the `process_ended` event
+     * fans out async when the OS reports close. The promise's
+     * resolved value tells the caller what happened immediately
+     * (process_already_dead, signal_sent, etc.).
+     */
+    async kill(sessionId, id) {
+        const m = this.getManaged(sessionId, id);
+        if (m === undefined) {
+            return { ok: false, info: undefined, reason: "not_found" };
+        }
+        if (!LIVE_STATUSES.has(m.info.status)) {
+            // Already exited — return success with the final info so the
+            // caller can render a clean result instead of an error.
+            return { ok: true, info: cloneInfo(m.info) };
+        }
+        try {
+            m.killSent = "SIGTERM";
+            m.info.status = "terminating";
+            this.notify({ type: "processes_changed", sessionId });
+            m.child.kill("SIGTERM");
+            m.killTimer = setTimeout(() => {
+                if (!LIVE_STATUSES.has(m.info.status))
+                    return;
+                m.info.status = "terminate_timeout";
+                m.killSent = "SIGKILL";
+                this.notify({ type: "processes_changed", sessionId });
+                try {
+                    m.child.kill("SIGKILL");
+                }
+                catch {
+                    // ignore
+                }
+                // Last-resort timeout — if SIGKILL still doesn't move the
+                // process (zombie / kernel state), wait one more beat then
+                // report timeout to the caller. The OS WILL eventually
+                // close the streams; we just can't wait forever.
+                setTimeout(() => {
+                    // no-op — the close handler will mark the final state
+                }, SIGKILL_TIMEOUT_MS).unref();
+            }, GRACE_MS);
+            return { ok: true, info: cloneInfo(m.info) };
+        }
+        catch (err) {
+            void err;
+            return { ok: false, info: cloneInfo(m.info), reason: "error" };
+        }
+    }
+    /** Pipe input to a live process's stdin. `end:true` closes the stream. */
+    async write(sessionId, id, input, end) {
+        const m = this.getManaged(sessionId, id);
+        if (m === undefined)
+            return { ok: false, reason: "not_found" };
+        if (!LIVE_STATUSES.has(m.info.status)) {
+            return { ok: false, reason: "process_exited" };
+        }
+        const stdin = m.child.stdin;
+        if (stdin === null || stdin.writableEnded) {
+            return { ok: false, reason: "stdin_closed" };
+        }
+        return await new Promise((resolve) => {
+            stdin.write(input, (err) => {
+                if (err !== null && err !== undefined) {
+                    resolve({ ok: false, reason: "write_error" });
+                    return;
+                }
+                if (end) {
+                    stdin.end(() => resolve({ ok: true }));
+                }
+                else {
+                    resolve({ ok: true });
+                }
+            });
+        });
+    }
+    /** Drop all FINISHED processes for the session. Live ones stay. */
+    clear(sessionId) {
+        const s = this.bySession.get(sessionId);
+        if (s === undefined)
+            return 0;
+        let count = 0;
+        for (const [id, m] of s.processes) {
+            if (!LIVE_STATUSES.has(m.info.status)) {
+                s.processes.delete(id);
+                count += 1;
+            }
+        }
+        if (count > 0)
+            this.notify({ type: "processes_changed", sessionId });
+        return count;
+    }
+    /**
+     * Dispose every process for this session: SIGTERM, brief wait,
+     * SIGKILL. Then unlink the session's entire log directory.
+     * Called from session-registry.disposeSession.
+     */
+    async disposeSession(sessionId) {
+        const s = this.bySession.get(sessionId);
+        if (s === undefined)
+            return;
+        const live = [...s.processes.values()].filter((m) => LIVE_STATUSES.has(m.info.status));
+        for (const m of live) {
+            try {
+                m.killSent = "SIGTERM";
+                m.child.kill("SIGTERM");
+            }
+            catch {
+                // ignore
+            }
+        }
+        if (live.length > 0) {
+            await new Promise((resolve) => setTimeout(resolve, GRACE_MS).unref());
+            for (const m of live) {
+                if (LIVE_STATUSES.has(m.info.status)) {
+                    try {
+                        m.child.kill("SIGKILL");
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+            }
+        }
+        // Best-effort log cleanup. A failure here (e.g. EBUSY on
+        // Windows) just leaves the files on disk — harmless, the
+        // session dir will be cleaned up by deleteColdSession's
+        // cascade.
+        const logRoot = join(config.forgeDataDir, "processes", sessionId);
+        await rm(logRoot, { recursive: true, force: true }).catch(() => undefined);
+        this.bySession.delete(sessionId);
+    }
+    /**
+     * Test-only: nuke everything WITHOUT signalling children. Use
+     * between integration test cases that spawn real processes;
+     * combine with explicit dispose for the cleanup of children
+     * the test actually started.
+     */
+    _resetForTests() {
+        this.bySession.clear();
+        // listeners intentionally NOT cleared — the SSE bridge's
+        // subscription is process-lifetime.
+    }
+    getManaged(sessionId, id) {
+        return this.bySession.get(sessionId)?.processes.get(id);
+    }
+}
+function cloneInfo(info) {
+    return { ...info };
+}
+/** Singleton — one registry per process. */
+export const processManager = new ProcessManagerRegistry();
+//# 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/prompt-strings.js

@@ -0,0 +1,43 @@
+/**
+ * Prompt snippet + guidelines + tool description for the `process`
+ * tool.
+ *
+ * ─────────────────────────────────────────────────────────────────
+ * Adapted from @aliou/pi-processes (MIT).
+ * Copyright (c) aliou.
+ * https://github.com/aliou/pi-processes
+ * ─────────────────────────────────────────────────────────────────
+ *
+ * The wording is preserved because it's been tuned against real
+ * model behavior — rules like "avoid &, nohup, disown, or setsid
+ * when the process tool fits" steer the model toward the right
+ * primitive. The reducer, lifecycle, log handling, UI, and SSE
+ * wiring are pi-forge's own.
+ */
+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.",
+    "Use the pi-forge process tool's notify flags (alertOnSuccess / alertOnFailure / alertOnKill) and logWatches when you need to react to events without polling.",
+];
+export const TOOL_DESCRIPTION = `Manage background processes. Actions:
+- start: Run command in background (requires 'name' and 'command')
+  - alertOnSuccess (default: false): Get a turn to react when process completes successfully
+  - 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: You DON'T need to poll or wait for processes. Notifications arrive automatically based on your preferences. Start processes and continue with other work — you'll be informed if something requires attention.
+
+Note: User always sees process updates in the UI. The notify flags control whether YOU (the agent) get a turn to react (e.g. check results, fix code, restart).`;
+//# 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,0EAA0E;IAC1E,+JAA+J;CAChK,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;gKAkBgI,CAAC"}