@asermax/tachikoma 2.0.0

package/dist/extensions/detached-processes/repository.d.ts

@@ -0,0 +1,33 @@
+import type { AppDatabase } from "../../db/index.ts";
+import { type DetachedProcessRecord, type ProcessStatus } from "./schema.ts";
+export interface NewDetachedProcess {
+    id: string;
+    name: string;
+    command: string;
+    cwd: string;
+    pid: number;
+    stdoutPath: string;
+    stderrPath: string;
+    memoryLimitMb: number | null;
+    startedAt: Date;
+}
+export declare class ProcessRepository {
+    private readonly db;
+    constructor(db: AppDatabase);
+    create(values: NewDetachedProcess): DetachedProcessRecord;
+    get(id: string): DetachedProcessRecord | null;
+    listByStatus(status: ProcessStatus): DetachedProcessRecord[];
+    listRunning(): DetachedProcessRecord[];
+    listExited(): DetachedProcessRecord[];
+    /**
+     * Set stopReason before signalling. Caller must clearStopReason if signal
+     * delivery fails, so a future natural exit is not incorrectly suppressed.
+     */
+    markStopInitiated(id: string): void;
+    clearStopReason(id: string): void;
+    /**
+     * Conditionally transition a record from running to exited. Returns true if
+     * this caller won the race; false when another reconciler already did.
+     */
+    reconcileToExited(id: string, exitedAt: Date, exitCode: number | null): boolean;
+}

package/dist/extensions/detached-processes/repository.js

@@ -0,0 +1,62 @@
+import { and, eq } from "drizzle-orm";
+import { detachedProcesses, STOP_REASON_AGENT_STOPPED, } from "./schema.js";
+export class ProcessRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    create(values) {
+        return this.db
+            .insert(detachedProcesses)
+            .values({ ...values, status: "running" })
+            .returning()
+            .get();
+    }
+    get(id) {
+        return (this.db.select().from(detachedProcesses).where(eq(detachedProcesses.id, id)).get() ?? null);
+    }
+    listByStatus(status) {
+        return this.db
+            .select()
+            .from(detachedProcesses)
+            .where(eq(detachedProcesses.status, status))
+            .all();
+    }
+    listRunning() {
+        return this.listByStatus("running");
+    }
+    listExited() {
+        return this.listByStatus("exited");
+    }
+    /**
+     * Set stopReason before signalling. Caller must clearStopReason if signal
+     * delivery fails, so a future natural exit is not incorrectly suppressed.
+     */
+    markStopInitiated(id) {
+        this.db
+            .update(detachedProcesses)
+            .set({ stopReason: STOP_REASON_AGENT_STOPPED })
+            .where(eq(detachedProcesses.id, id))
+            .run();
+    }
+    clearStopReason(id) {
+        this.db
+            .update(detachedProcesses)
+            .set({ stopReason: null })
+            .where(eq(detachedProcesses.id, id))
+            .run();
+    }
+    /**
+     * Conditionally transition a record from running to exited. Returns true if
+     * this caller won the race; false when another reconciler already did.
+     */
+    reconcileToExited(id, exitedAt, exitCode) {
+        return (this.db
+            .update(detachedProcesses)
+            .set({ status: "exited", exitedAt, exitCode })
+            .where(and(eq(detachedProcesses.id, id), eq(detachedProcesses.status, "running")))
+            .returning()
+            .all().length > 0);
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/extensions/detached-processes/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/extensions/detached-processes/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,aAAa,CAAC;AAGtC,OAAO,EAEL,iBAAiB,EAEjB,yBAAyB,GAC1B,MAAM,aAAa,CAAC;AAcrB,MAAM,OAAO,iBAAiB;IACX,EAAE,CAAc;IAEjC,YAAY,EAAe;QACzB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAA0B;QAC/B,OAAO,IAAI,CAAC,EAAE;aACX,MAAM,CAAC,iBAAiB,CAAC;aACzB,MAAM,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;aACxC,SAAS,EAAE;aACX,GAAG,EAAE,CAAC;IACX,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,CACL,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,IAAI,CAC3F,CAAC;IACJ,CAAC;IAED,YAAY,CAAC,MAAqB;QAChC,OAAO,IAAI,CAAC,EAAE;aACX,MAAM,EAAE;aACR,IAAI,CAAC,iBAAiB,CAAC;aACvB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;aAC3C,GAAG,EAAE,CAAC;IACX,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,EAAU;QAC1B,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,iBAAiB,CAAC;aACzB,GAAG,CAAC,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAAC;aAC9C,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;aACnC,GAAG,EAAE,CAAC;IACX,CAAC;IAED,eAAe,CAAC,EAAU;QACxB,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,iBAAiB,CAAC;aACzB,GAAG,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;aACzB,KAAK,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;aACnC,GAAG,EAAE,CAAC;IACX,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,EAAU,EAAE,QAAc,EAAE,QAAuB;QACnE,OAAO,CACL,IAAI,CAAC,EAAE;aACJ,MAAM,CAAC,iBAAiB,CAAC;aACzB,GAAG,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;aAC7C,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,iBAAiB,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;aACjF,SAAS,EAAE;aACX,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,CACpB,CAAC;IACJ,CAAC;CACF"}

package/dist/extensions/detached-processes/schema.d.ts

@@ -0,0 +1,252 @@
+export declare const PROCESS_STATUSES: {
+    readonly running: "running";
+    readonly exited: "exited";
+};
+export type ProcessStatus = keyof typeof PROCESS_STATUSES;
+export declare const STOP_REASON_AGENT_STOPPED = "agent_stopped";
+export declare const detachedProcesses: import("drizzle-orm/sqlite-core").SQLiteTableWithColumns<{
+    name: "detached_processes";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "id";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        name: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "name";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        command: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "command";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        cwd: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "cwd";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        pid: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "pid";
+            tableName: "detached_processes";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        status: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "status";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: "running" | "exited";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+            $type: "running" | "exited";
+        }>;
+        exitCode: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "exit_code";
+            tableName: "detached_processes";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stopReason: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stop_reason";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        stdoutPath: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stdout_path";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        stderrPath: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "stderr_path";
+            tableName: "detached_processes";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        memoryLimitMb: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "memory_limit_mb";
+            tableName: "detached_processes";
+            dataType: "number";
+            columnType: "SQLiteInteger";
+            data: number;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        startedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "started_at";
+            tableName: "detached_processes";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        exitedAt: import("drizzle-orm/sqlite-core").SQLiteColumn<{
+            name: "exited_at";
+            tableName: "detached_processes";
+            dataType: "date";
+            columnType: "SQLiteTimestamp";
+            data: Date;
+            driverParam: number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "sqlite";
+}>;
+export type DetachedProcessRecord = typeof detachedProcesses.$inferSelect;

package/dist/extensions/detached-processes/schema.js

@@ -0,0 +1,23 @@
+import { index, integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+export const PROCESS_STATUSES = {
+    running: "running",
+    exited: "exited",
+};
+export const STOP_REASON_AGENT_STOPPED = "agent_stopped";
+export const detachedProcesses = sqliteTable("detached_processes", {
+    id: text("id").primaryKey(),
+    name: text("name").notNull(),
+    command: text("command").notNull(),
+    cwd: text("cwd").notNull(),
+    pid: integer("pid").notNull(),
+    status: text("status").$type().notNull(),
+    exitCode: integer("exit_code"),
+    stopReason: text("stop_reason"),
+    stdoutPath: text("stdout_path").notNull(),
+    stderrPath: text("stderr_path").notNull(),
+    // Recorded only when a limit was actually applied at spawn time.
+    memoryLimitMb: integer("memory_limit_mb"),
+    startedAt: integer("started_at", { mode: "timestamp" }).notNull(),
+    exitedAt: integer("exited_at", { mode: "timestamp" }),
+}, (table) => [index("ix_detached_processes_status").on(table.status)]);
+//# sourceMappingURL=schema.js.map

package/dist/extensions/detached-processes/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/extensions/detached-processes/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE5E,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,QAAQ;CACR,CAAC;AAIX,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAC1C,oBAAoB,EACpB;IACE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE;IAC3B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE;IAC5B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE;IAClC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC1B,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE;IAC7B,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,EAAiB,CAAC,OAAO,EAAE;IACvD,QAAQ,EAAE,OAAO,CAAC,WAAW,CAAC;IAC9B,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;IAC/B,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,OAAO,EAAE;IACzC,iEAAiE;IACjE,aAAa,EAAE,OAAO,CAAC,iBAAiB,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;IACjE,QAAQ,EAAE,OAAO,CAAC,WAAW,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;CACtD,EACD,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CACpE,CAAC"}

package/dist/extensions/detached-processes/spawn.d.ts

@@ -0,0 +1,40 @@
+import type { Logger } from "../../log.ts";
+import type { ProcessLimiter } from "./limits.ts";
+import type { ProcessRepository } from "./repository.ts";
+import type { DetachedProcessRecord } from "./schema.ts";
+export interface SpawnDeps {
+    repository: ProcessRepository;
+    limiter: ProcessLimiter;
+    /** Root directory holding one subdirectory per process id. */
+    processesDir: string;
+    log: Logger;
+    now?: () => Date;
+}
+export interface SpawnOptions {
+    name: string;
+    command: string;
+    cwd?: string | null;
+    env?: Record<string, string> | null;
+    memoryLimitMb?: number | null;
+}
+export declare const processDir: (processesDir: string, id: string) => string;
+export declare const exitCodePath: (processesDir: string, id: string) => string;
+/**
+ * Liveness via signal 0. EPERM means the pid exists but belongs to another
+ * user, so it still counts as alive. No create-time check — see reconcile.ts
+ * for why pid reuse is acceptable here.
+ */
+export declare const isAlive: (pid: number) => boolean;
+/**
+ * Spawn a detached shell command with stdout/stderr captured to files and
+ * persist the record. The exit-code sidecar file lets reconciliation recover
+ * the code while this host process is alive; after a restart the child is
+ * reparented and the code is unknowable (null).
+ */
+export declare const spawnProcess: (deps: SpawnDeps, options: SpawnOptions) => Promise<DetachedProcessRecord>;
+export interface TerminateOptions {
+    signal?: NodeJS.Signals;
+    /** Seconds to wait before escalating to SIGKILL; 0 = signal and return. */
+    graceSeconds?: number;
+}
+export declare const terminate: (record: Pick<DetachedProcessRecord, "pid">, log: Logger, { signal, graceSeconds }?: TerminateOptions) => Promise<void>;

package/dist/extensions/detached-processes/spawn.js

@@ -0,0 +1,137 @@
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { closeSync, openSync, writeFileSync } from "node:fs";
+import { mkdir } from "node:fs/promises";
+import { constants } from "node:os";
+import { join } from "node:path";
+import { setTimeout as sleep } from "node:timers/promises";
+export const processDir = (processesDir, id) => join(processesDir, id);
+export const exitCodePath = (processesDir, id) => join(processDir(processesDir, id), "exit-code");
+/**
+ * Liveness via signal 0. EPERM means the pid exists but belongs to another
+ * user, so it still counts as alive. No create-time check — see reconcile.ts
+ * for why pid reuse is acceptable here.
+ */
+export const isAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code === "EPERM";
+    }
+};
+const signalExitCode = (signal) => {
+    const number = constants.signals[signal];
+    return number != null ? 128 + number : null;
+};
+/**
+ * Spawn a detached shell command with stdout/stderr captured to files and
+ * persist the record. The exit-code sidecar file lets reconciliation recover
+ * the code while this host process is alive; after a restart the child is
+ * reparented and the code is unknowable (null).
+ */
+export const spawnProcess = async (deps, options) => {
+    const { repository, limiter, processesDir, log } = deps;
+    const now = deps.now ?? (() => new Date());
+    if (options.name.trim() === "")
+        throw new Error("name must not be empty or whitespace");
+    if (options.command.trim() === "")
+        throw new Error("command must not be empty or whitespace");
+    const id = randomUUID();
+    const dir = processDir(processesDir, id);
+    await mkdir(dir, { recursive: true });
+    const stdoutPath = join(dir, "stdout.log");
+    const stderrPath = join(dir, "stderr.log");
+    const sidecarPath = exitCodePath(processesDir, id);
+    const stdoutFd = openSync(stdoutPath, "a");
+    const stderrFd = openSync(stderrPath, "a");
+    const wrapped = limiter.wrap(options.command, options.memoryLimitMb ?? null);
+    const cwd = options.cwd ?? process.cwd();
+    let child;
+    try {
+        child = spawn(wrapped.file, wrapped.args, {
+            cwd,
+            env: { ...process.env, ...(options.env ?? {}) },
+            detached: true,
+            stdio: ["ignore", stdoutFd, stderrFd],
+        });
+        await new Promise((resolve, reject) => {
+            child.once("spawn", resolve);
+            child.once("error", reject);
+        });
+    }
+    finally {
+        // The child holds its own copies of the output descriptors.
+        closeSync(stdoutFd);
+        closeSync(stderrFd);
+    }
+    if (child.pid == null)
+        throw new Error("spawned child has no pid");
+    const pid = child.pid;
+    child.on("error", (error) => {
+        log.error({ pid, err: error }, "detached child emitted an error");
+    });
+    child.on("exit", (code, signal) => {
+        const value = code ?? (signal != null ? signalExitCode(signal) : null);
+        try {
+            writeFileSync(sidecarPath, value != null ? String(value) : "");
+        }
+        catch (error) {
+            log.warn({ pid, err: error }, "failed to write exit-code sidecar");
+        }
+    });
+    child.unref();
+    try {
+        return repository.create({
+            id,
+            name: options.name,
+            command: options.command,
+            cwd,
+            pid,
+            stdoutPath,
+            stderrPath,
+            memoryLimitMb: wrapped.limited ? (options.memoryLimitMb ?? null) : null,
+            startedAt: now(),
+        });
+    }
+    catch (error) {
+        log.error({ pid, err: error }, "db write failed after spawn — killing process group");
+        killGroup(pid, "SIGKILL");
+        throw error;
+    }
+};
+const killGroup = (pid, signal) => {
+    try {
+        // detached:true makes the child a process group leader, so -pid reaches
+        // the whole tree (wrapper + descendants).
+        process.kill(-pid, signal);
+        return "sent";
+    }
+    catch (error) {
+        if (error.code === "ESRCH")
+            return "gone";
+        throw error;
+    }
+};
+export const terminate = async (record, log, { signal = "SIGTERM", graceSeconds = 10 } = {}) => {
+    if (killGroup(record.pid, signal) === "gone")
+        return;
+    if (graceSeconds <= 0)
+        return;
+    const pollMs = 100;
+    for (let elapsed = 0; elapsed < graceSeconds * 1000; elapsed += pollMs) {
+        if (!isAlive(record.pid))
+            return;
+        await sleep(pollMs);
+    }
+    log.warn({ pid: record.pid, graceSeconds }, "process still alive after grace — sending SIGKILL");
+    if (killGroup(record.pid, "SIGKILL") === "gone")
+        return;
+    for (let attempt = 0; attempt < 10; attempt += 1) {
+        if (!isAlive(record.pid))
+            return;
+        await sleep(pollMs);
+    }
+};
+//# sourceMappingURL=spawn.js.map

package/dist/extensions/detached-processes/spawn.js.map

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

package/dist/extensions/detached-processes/tools.d.ts

@@ -0,0 +1,41 @@
+import { type ExtensionFactory } from "@earendil-works/pi-coding-agent";
+import { type Static, Type } from "typebox";
+import type { Logger } from "../../log.ts";
+import type { ProcessLimiter } from "./limits.ts";
+import { type ProcessNotification } from "./reconcile.ts";
+import type { ProcessRepository } from "./repository.ts";
+export interface ProcessToolDeps {
+    repository: ProcessRepository;
+    limiter: ProcessLimiter;
+    processesDir: string;
+    notify: (notification: ProcessNotification) => void;
+    defaultMemoryLimitMb: number | null;
+    log: Logger;
+    now?: () => Date;
+}
+export declare const DispatchProcessParams: Type.TObject<{
+    name: Type.TString;
+    command: Type.TString;
+    cwd: Type.TOptional<Type.TString>;
+    env: Type.TOptional<Type.TRecord<"^.*$", Type.TString>>;
+    memory_limit_mb: Type.TOptional<Type.TNumber>;
+}>;
+export declare const QueryProcessParams: Type.TObject<{
+    process_id: Type.TOptional<Type.TString>;
+    archived: Type.TOptional<Type.TBoolean>;
+}>;
+export declare const ReadProcessOutputParams: Type.TObject<{
+    process_id: Type.TString;
+    stream: Type.TOptional<Type.TUnsafe<"stdout" | "stderr">>;
+}>;
+export declare const TerminateProcessParams: Type.TObject<{
+    process_id: Type.TString;
+    signal: Type.TOptional<Type.TString>;
+    grace_seconds: Type.TOptional<Type.TNumber>;
+}>;
+export declare const handleDispatchProcess: (deps: ProcessToolDeps, args: Static<typeof DispatchProcessParams>) => Promise<string>;
+export declare const handleQueryProcess: (deps: ProcessToolDeps, args: Static<typeof QueryProcessParams>) => Promise<string>;
+export declare const handleReadProcessOutput: (deps: ProcessToolDeps, args: Static<typeof ReadProcessOutputParams>) => Promise<string>;
+export declare const handleTerminateProcess: (deps: ProcessToolDeps, args: Static<typeof TerminateProcessParams>) => Promise<string>;
+/** pi extension factory exposing the detached process management tools to the agent. */
+export declare const createProcessToolsFactory: (deps: ProcessToolDeps) => ExtensionFactory;