@dorokuma/herdsman 0.6.0

package/dist/src/daemon/process-manager.js

@@ -0,0 +1,178 @@
+import { spawn } from "node:child_process";
+import { closeSync, existsSync, mkdirSync, openSync, readFileSync, rmSync, writeFileSync, } from "node:fs";
+import { createConnection } from "node:net";
+import { dirname } from "node:path";
+export function readDaemonRuntimeRecord(path) {
+    if (!existsSync(path)) {
+        return undefined;
+    }
+    try {
+        const value = JSON.parse(readFileSync(path, "utf8"));
+        if (value.version !== 1 ||
+            typeof value.dbPath !== "string" ||
+            typeof value.homeDir !== "string" ||
+            typeof value.logPath !== "string" ||
+            typeof value.pid !== "number" ||
+            typeof value.pidPath !== "string" ||
+            typeof value.socketPath !== "string" ||
+            typeof value.startedAt !== "string") {
+            return undefined;
+        }
+        return value;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function writeDaemonRuntimeRecord(path, record) {
+    mkdirSync(dirname(path), { mode: 0o700, recursive: true });
+    writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, { mode: 0o600 });
+}
+export async function prepareDaemonSocketPath(input) {
+    mkdirSync(dirname(input.socketPath), { mode: 0o700, recursive: true });
+    if (!existsSync(input.socketPath)) {
+        return;
+    }
+    const connectSocket = input.deps?.connectSocket ?? defaultConnectSocket;
+    if (await connectSocket(input.socketPath)) {
+        throw new Error(`Herdsman daemon socket is already reachable: ${input.socketPath}`);
+    }
+    rmSync(input.socketPath, { force: true });
+}
+export async function getDaemonStatus(input) {
+    const processIsRunning = input.deps?.isProcessRunning ?? isProcessRunning;
+    const connectSocket = input.deps?.connectSocket ?? defaultConnectSocket;
+    if (!existsSync(input.pidPath)) {
+        if (await connectSocket(input.socketPath)) {
+            return {
+                pidPath: input.pidPath,
+                socketPath: input.socketPath,
+                socketReachable: true,
+                state: "orphaned",
+            };
+        }
+        return { pidPath: input.pidPath, socketPath: input.socketPath, state: "stopped" };
+    }
+    const pid = Number(readFileSync(input.pidPath, "utf8").trim());
+    if (!Number.isInteger(pid) || pid <= 0 || !processIsRunning(pid)) {
+        if (await connectSocket(input.socketPath)) {
+            return {
+                pidPath: input.pidPath,
+                socketPath: input.socketPath,
+                socketReachable: true,
+                stalePid: pid,
+                state: "orphaned",
+            };
+        }
+        return {
+            pidPath: input.pidPath,
+            socketPath: input.socketPath,
+            stalePid: pid,
+            state: "stopped",
+        };
+    }
+    return {
+        pid,
+        pidPath: input.pidPath,
+        socketPath: input.socketPath,
+        socketReachable: await connectSocket(input.socketPath),
+        state: "running",
+    };
+}
+export async function startDaemonProcess(input) {
+    const status = await getDaemonStatus({
+        ...(input.deps !== undefined ? { deps: input.deps } : {}),
+        pidPath: input.pidPath,
+        socketPath: input.socketPath,
+    });
+    if (status.state === "running") {
+        throw new Error(`Herdsman daemon is already running with pid ${status.pid}`);
+    }
+    if (status.state === "orphaned") {
+        throw new Error(`Herdsman daemon socket is reachable but its PID is stale: ${status.socketPath}`);
+    }
+    mkdirSync(dirname(input.pidPath), { mode: 0o700, recursive: true });
+    mkdirSync(dirname(input.logPath), { mode: 0o700, recursive: true });
+    if (status.state === "stopped" && status.stalePid !== undefined) {
+        rmSync(input.pidPath, { force: true });
+    }
+    const logFd = openSync(input.logPath, "a", 0o600);
+    let child;
+    try {
+        child = (input.deps?.spawnProcess ?? spawnDaemonProcess)(input.nodePath, [input.entrypointPath], {
+            detached: true,
+            env: input.env,
+            stdio: ["ignore", logFd, logFd],
+        });
+    }
+    finally {
+        closeSync(logFd);
+    }
+    if (!child.pid) {
+        throw new Error("Failed to start Herdsman daemon: child pid was not assigned");
+    }
+    child.unref();
+    writeFileSync(input.pidPath, `${child.pid}\n`, { mode: 0o600 });
+    writeDaemonRuntimeRecord(input.runtimeRecordPath, {
+        ...input.runtimeRecord,
+        pid: child.pid,
+        startedAt: new Date().toISOString(),
+        version: 1,
+    });
+    return { pid: child.pid };
+}
+export async function stopDaemonProcess(input) {
+    const deps = input.deps ?? {};
+    const status = await getDaemonStatus({
+        deps,
+        pidPath: input.pidPath,
+        socketPath: input.socketPath,
+    });
+    if (status.state === "stopped") {
+        rmSync(input.pidPath, { force: true });
+        return { alreadyStopped: true };
+    }
+    if (status.state === "orphaned") {
+        throw new Error(`Herdsman daemon socket is reachable but its PID is stale: ${status.socketPath}`);
+    }
+    const killProcess = deps.killProcess ?? ((pid, signal) => process.kill(pid, signal));
+    const processIsRunning = deps.isProcessRunning ?? isProcessRunning;
+    const waitMs = deps.waitMs ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+    killProcess(status.pid, "SIGTERM");
+    const deadline = Date.now() + input.timeoutMs;
+    while (Date.now() < deadline) {
+        if (!processIsRunning(status.pid)) {
+            rmSync(input.pidPath, { force: true });
+            return { alreadyStopped: false, pid: status.pid };
+        }
+        await waitMs(50);
+    }
+    throw new Error(`Timed out waiting for Herdsman daemon pid ${status.pid} to stop`);
+}
+function spawnDaemonProcess(command, args, options) {
+    const child = spawn(command, args, options);
+    return { pid: child.pid, unref: () => child.unref() };
+}
+export function isProcessRunning(pid, probe = process.kill) {
+    try {
+        probe(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return typeof error === "object" && error !== null && "code" in error && error.code === "EPERM";
+    }
+}
+function defaultConnectSocket(socketPath) {
+    return new Promise((resolve) => {
+        const socket = createConnection(socketPath);
+        const done = (value) => {
+            socket.removeAllListeners();
+            socket.destroy();
+            resolve(value);
+        };
+        socket.once("connect", () => done(true));
+        socket.once("error", () => done(false));
+        socket.setTimeout(200, () => done(false));
+    });
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/src/daemon/process-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.js","sourceRoot":"","sources":["../../../src/daemon/process-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EACL,SAAS,EACT,UAAU,EACV,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,aAAa,GACd,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgDpC,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAiC,CAAC;QACrF,IACE,KAAK,CAAC,OAAO,KAAK,CAAC;YACnB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;YAChC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YACjC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YACjC,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ;YAC7B,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;YACjC,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ;YACpC,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EACnC,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAA4B,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,MAA2B;IAChF,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAG7C;IACC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,OAAO;IACT,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,IAAI,oBAAoB,CAAC;IACxE,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAIrC;IACC,MAAM,gBAAgB,GAAG,KAAK,CAAC,IAAI,EAAE,gBAAgB,IAAI,gBAAgB,CAAC;IAC1E,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,EAAE,aAAa,IAAI,oBAAoB,CAAC;IAExE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,eAAe,EAAE,IAAI;gBACrB,KAAK,EAAE,UAAU;aAClB,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACpF,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;QACjE,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,eAAe,EAAE,IAAI;gBACrB,QAAQ,EAAE,GAAG;gBACb,KAAK,EAAE,UAAU;aAClB,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,QAAQ,EAAE,GAAG;YACb,KAAK,EAAE,SAAS;SACjB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG;QACH,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,eAAe,EAAE,MAAM,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC;QACtD,KAAK,EAAE,SAAS;KACjB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,KAUxC;IACC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,+CAA+C,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,CAAC,UAAU,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAChE,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,IAAI,KAAiD,CAAC;IACtD,IAAI,CAAC;QACH,KAAK,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,YAAY,IAAI,kBAAkB,CAAC,CACtD,KAAK,CAAC,QAAQ,EACd,CAAC,KAAK,CAAC,cAAc,CAAC,EACtB;YACE,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,KAAK,CAAC,GAAG;YACd,KAAK,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,KAAK,CAAC;SAChC,CACF,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAChE,wBAAwB,CAAC,KAAK,CAAC,iBAAiB,EAAE;QAChD,GAAG,KAAK,CAAC,aAAa;QACtB,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,CAAC;KACX,CAAC,CAAC;IACH,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAKvC;IACC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;QACnC,IAAI;QACJ,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC,CAAC;IACH,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,CAAC,UAAU,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IACrF,MAAM,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,IAAI,gBAAgB,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAEhG,WAAW,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC;IAC9C,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,CAAC;QACD,MAAM,MAAM,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,6CAA6C,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,kBAAkB,CACzB,OAAe,EACf,IAAc,EACd,OAA0C;IAE1C,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;AACxD,CAAC;AAID,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,QAAsB,OAAO,CAAC,IAAI;IAC9E,IAAI,CAAC;QACH,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;IAClG,CAAC;AACH,CAAC;AAED,SAAS,oBAAoB,CAAC,UAAkB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE;YAC9B,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/daemon/service.d.ts

@@ -0,0 +1,5 @@
+export declare function runObservabilityDaemonService(input?: {
+    environment?: NodeJS.ProcessEnv | undefined;
+}): Promise<void>;
+export declare function resolveMigrationsFolder(startDir: string): string;
+//# sourceMappingURL=service.d.ts.map

package/dist/src/daemon/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/daemon/service.ts"],"names":[],"mappings":"AAsBA,wBAAsB,6BAA6B,CACjD,KAAK,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,SAAS,CAAA;CAAO,GAC1D,OAAO,CAAC,IAAI,CAAC,CAgEf;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAahE"}

package/dist/src/daemon/service.js

@@ -0,0 +1,104 @@
+import { existsSync, mkdirSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { env, exit } from "node:process";
+import { fileURLToPath } from "node:url";
+import { createAgentHistoryService } from "../agent-history/service.js";
+import { resolveRuntime } from "../config/runtime.js";
+import { AgentContextSnapshotStore } from "../db/agent-context-snapshots.js";
+import { AgentEventStore } from "../db/agent-events.js";
+import { AgentHistoryCacheStore } from "../db/agent-history-cache.js";
+import { AgentOrchestratorScopeStore } from "../db/agent-orchestrator-scopes.js";
+import { AgentStore } from "../db/agents.js";
+import { applyMigrations } from "../db/apply-migrations.js";
+import { openSqlite } from "../db/client.js";
+import { HerdrSessionStore } from "../db/herdr-sessions.js";
+import { HerdrWorkspaceStore } from "../db/herdr-workspaces.js";
+import { createHerdrSessionListRunner } from "../herdr/session-list.js";
+import { AgentContextService } from "../observability/agent-context-service.js";
+import { AgentIndexService } from "../observability/agent-index-service.js";
+import { AgentOrchestratorService } from "../observability/agent-orchestrator-service.js";
+import { HerdrSessionWatchManager } from "./herdr-session-watch-manager.js";
+import { ObservabilityRpcServer } from "./observability-server.js";
+export async function runObservabilityDaemonService(input = {}) {
+    const runtime = resolveRuntime({ environment: input.environment });
+    applyEnvironment(runtime.environment);
+    mkdirSync(dirname(runtime.paths.dbPath), { recursive: true });
+    mkdirSync(dirname(runtime.paths.socketPath), { recursive: true });
+    const { sqlite } = openSqlite(runtime.paths.dbPath);
+    applyMigrations(sqlite, {
+        migrationsFolder: resolveMigrationsFolder(dirname(fileURLToPath(import.meta.url))),
+    });
+    const herdrSessions = new HerdrSessionStore(sqlite);
+    const herdrWorkspaces = new HerdrWorkspaceStore(sqlite);
+    const agents = new AgentStore(sqlite);
+    const agentEvents = new AgentEventStore(sqlite);
+    const agentHistoryCache = new AgentHistoryCacheStore(sqlite);
+    const agentContextSnapshots = new AgentContextSnapshotStore(sqlite);
+    const agentOrchestratorScopes = new AgentOrchestratorScopeStore(sqlite);
+    const history = createAgentHistoryService({ cache: agentHistoryCache });
+    const context = new AgentContextService({
+        history,
+        stores: { agentContextSnapshots, agents },
+    });
+    const daemonServices = { context, history };
+    const orchestrator = new AgentOrchestratorService({
+        agentEvents,
+        agents,
+        scopes: agentOrchestratorScopes,
+    });
+    const index = new AgentIndexService({
+        context: daemonServices.context,
+        stores: { agentEvents, agentHistoryCache, agents, herdrSessions, herdrWorkspaces },
+    });
+    const server = new ObservabilityRpcServer({
+        context: daemonServices.context,
+        history: daemonServices.history,
+        orchestrator,
+        registerPiSessionRef: (registration) => index.registerPiSessionRef(registration),
+        socketPath: runtime.paths.socketPath,
+        stores: { agentEvents, agents, herdrSessions, herdrWorkspaces },
+    });
+    const watchManager = new HerdrSessionWatchManager({
+        agents,
+        herdrSessions,
+        index,
+        onAgentContextChanged: (scope) => server.publishAgentContext(scope),
+        onAgentEvent: (event) => server.publishAgentEvent(event),
+        onAgentIndexRefreshed: (refreshed) => server.reconcileAgentLocations(refreshed),
+        sessionList: createHerdrSessionListRunner({ env: runtime.environment }),
+    });
+    await server.start();
+    await watchManager.start();
+    console.log(`Herdsman daemon listening on ${runtime.paths.socketPath}`);
+    const stop = async () => {
+        await watchManager.stop();
+        await server.stop();
+        sqlite.close();
+        exit(0);
+    };
+    process.once("SIGINT", stop);
+    process.once("SIGTERM", stop);
+}
+export function resolveMigrationsFolder(startDir) {
+    let current = resolve(startDir);
+    while (true) {
+        const migrationsFolder = resolve(current, "drizzle");
+        if (existsSync(resolve(migrationsFolder, "meta", "_journal.json"))) {
+            return migrationsFolder;
+        }
+        const parent = dirname(current);
+        if (parent === current) {
+            throw new Error(`Cannot find Herdsman migrations above ${startDir}`);
+        }
+        current = parent;
+    }
+}
+function applyEnvironment(environment) {
+    for (const [key, value] of Object.entries(environment)) {
+        if (value === undefined)
+            delete env[key];
+        else
+            env[key] = value;
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/src/daemon/service.js.map

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

package/dist/src/db/agent-context-snapshots.d.ts

@@ -0,0 +1,11 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { AgentContextSnapshotRecord } from "../observability/contracts.js";
+export declare class AgentContextSnapshotStore {
+    #private;
+    constructor(sqlite: DatabaseSync);
+    get(agentId: string): AgentContextSnapshotRecord | undefined;
+    listByAgentIds(agentIds: string[]): AgentContextSnapshotRecord[];
+    put(input: Omit<AgentContextSnapshotRecord, "updatedAt">): AgentContextSnapshotRecord;
+    delete(agentId: string): void;
+}
+//# sourceMappingURL=agent-context-snapshots.d.ts.map

package/dist/src/db/agent-context-snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-context-snapshots.d.ts","sourceRoot":"","sources":["../../../src/db/agent-context-snapshots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,0BAA0B,EAG3B,MAAM,8BAA8B,CAAC;AAatC,qBAAa,yBAAyB;;gBAGxB,MAAM,EAAE,YAAY;IAIhC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,GAAG,SAAS;IAO5D,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,0BAA0B,EAAE;IAShE,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,0BAA0B,EAAE,WAAW,CAAC,GAAG,0BAA0B;IAqCrF,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAG9B"}

package/dist/src/db/agent-context-snapshots.js

@@ -0,0 +1,129 @@
+export class AgentContextSnapshotStore {
+    #sqlite;
+    constructor(sqlite) {
+        this.#sqlite = sqlite;
+    }
+    get(agentId) {
+        const row = this.#sqlite
+            .prepare("select * from agent_context_snapshots where agent_id = ?")
+            .get(agentId);
+        return row ? mapSnapshot(row) : undefined;
+    }
+    listByAgentIds(agentIds) {
+        if (agentIds.length === 0)
+            return [];
+        const placeholders = agentIds.map(() => "?").join(", ");
+        const rows = this.#sqlite
+            .prepare(`select * from agent_context_snapshots where agent_id in (${placeholders})`)
+            .all(...agentIds);
+        return rows.map(mapSnapshot);
+    }
+    put(input) {
+        if ((input.historyRef === null) !== (input.sourceFingerprint === null)) {
+            throw new Error("Agent context history ref and source fingerprint must both be null or non-null");
+        }
+        const previous = this.get(input.agentId);
+        const now = Math.max(Date.now(), (previous?.updatedAt.getTime() ?? -Infinity) + 1);
+        this.#sqlite
+            .prepare(`insert into agent_context_snapshots
+         (agent_id, compact_history_json, history_ref_json, pane_revision, source_path, source_mtime_ms, source_size, updated_at)
+         values (?, ?, ?, ?, ?, ?, ?, ?)
+         on conflict(agent_id) do update set
+           compact_history_json = excluded.compact_history_json,
+           history_ref_json = excluded.history_ref_json,
+           pane_revision = excluded.pane_revision,
+           source_path = excluded.source_path,
+           source_mtime_ms = excluded.source_mtime_ms,
+           source_size = excluded.source_size,
+           updated_at = excluded.updated_at`)
+            .run(input.agentId, JSON.stringify(input.compactHistory), input.historyRef === null ? null : JSON.stringify(input.historyRef), input.paneRevision, input.sourceFingerprint?.path ?? null, input.sourceFingerprint?.mtimeMs ?? null, input.sourceFingerprint?.size ?? null, now);
+        const snapshot = this.get(input.agentId);
+        if (!snapshot)
+            throw new Error("Agent context snapshot write failed");
+        return snapshot;
+    }
+    delete(agentId) {
+        this.#sqlite.prepare("delete from agent_context_snapshots where agent_id = ?").run(agentId);
+    }
+}
+function mapSnapshot(row) {
+    const sourceFingerprint = mapSourceFingerprint(row);
+    const historyRef = row.history_ref_json === null ? null : parseHistoryRef(row.history_ref_json);
+    if ((historyRef === null) !== (sourceFingerprint === null)) {
+        throw new Error("Stored agent context history ref and source fingerprint are inconsistent");
+    }
+    return {
+        agentId: row.agent_id,
+        compactHistory: parseCompactHistory(row.compact_history_json),
+        historyRef,
+        paneRevision: row.pane_revision,
+        sourceFingerprint,
+        updatedAt: new Date(row.updated_at),
+    };
+}
+function mapSourceFingerprint(row) {
+    const values = [row.source_path, row.source_mtime_ms, row.source_size];
+    if (values.every((value) => value === null))
+        return null;
+    if (typeof row.source_path !== "string" ||
+        typeof row.source_mtime_ms !== "number" ||
+        typeof row.source_size !== "number") {
+        throw new Error("Stored agent context source fingerprint is invalid");
+    }
+    return { mtimeMs: row.source_mtime_ms, path: row.source_path, size: row.source_size };
+}
+function parseCompactHistory(value) {
+    const parsed = parseJson(value, "compact history");
+    if (!hasNullableHistoryRef(parsed.historyRef) ||
+        !hasNullableExcerpt(parsed.lastAssistantMessage) ||
+        !hasNullableToolResult(parsed.lastToolResult) ||
+        !hasNullableExcerpt(parsed.lastUserMessage) ||
+        typeof parsed.messageCount !== "number" ||
+        !hasNullableString(parsed.source) ||
+        !hasNullableString(parsed.updatedAt)) {
+        throw new Error("Stored agent context compact history is invalid");
+    }
+    return parsed;
+}
+function parseHistoryRef(value) {
+    const parsed = parseJson(value, "history ref");
+    if ((parsed.kind !== "agent_session" && parsed.kind !== "discovered_file") ||
+        typeof parsed.source !== "string" ||
+        typeof parsed.value !== "string" ||
+        !(parsed.path === undefined || typeof parsed.path === "string")) {
+        throw new Error("Stored agent context history ref is invalid");
+    }
+    return parsed;
+}
+function parseJson(value, label) {
+    try {
+        const parsed = JSON.parse(value);
+        if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+            throw new Error();
+        }
+        return parsed;
+    }
+    catch {
+        throw new Error(`Stored agent context ${label} is invalid`);
+    }
+}
+function hasNullableHistoryRef(value) {
+    return value === null || (typeof value === "object" && value !== null);
+}
+function hasNullableExcerpt(value) {
+    if (value === null)
+        return true;
+    if (typeof value !== "object" || value === null)
+        return false;
+    const excerpt = value;
+    return (typeof excerpt.ref === "string" &&
+        typeof excerpt.text === "string" &&
+        hasNullableString(excerpt.timestamp));
+}
+function hasNullableToolResult(value) {
+    return value === null || (typeof value === "object" && value !== null);
+}
+function hasNullableString(value) {
+    return value === null || typeof value === "string";
+}
+//# sourceMappingURL=agent-context-snapshots.js.map

package/dist/src/db/agent-context-snapshots.js.map

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

package/dist/src/db/agent-events.d.ts

@@ -0,0 +1,54 @@
+import type { DatabaseSync } from "node:sqlite";
+import type { AgentEventRecord, AgentEventType, AgentQueryScope, CompactAgentHistory } from "../observability/contracts.js";
+type AgentEventRow = {
+    agent_id: string | null;
+    compact_history_json: string | null;
+    created_at: number;
+    herdr_session_name: string;
+    id: number;
+    idempotency_key: string | null;
+    pane_id: string | null;
+    pane_generation: string | null;
+    payload_json: string;
+    deliverable: 0 | 1;
+    terminal_id: string | null;
+    type: AgentEventType;
+    workspace_id: string | null;
+};
+export declare class AgentEventStore {
+    #private;
+    constructor(sqlite: DatabaseSync);
+    append(input: {
+        agentId?: string | null;
+        compactHistory?: CompactAgentHistory | null;
+        herdrSessionName: string;
+        idempotencyKey?: string | null;
+        paneId?: string | null;
+        paneGeneration?: string | null;
+        payload: unknown;
+        terminalId?: string | null;
+        type: AgentEventType;
+        workspaceId?: string | null;
+    }): AgentEventRecord;
+    invalidatePane(input: {
+        herdrSessionName: string;
+        paneId: string;
+        paneGeneration?: string | null;
+    }): void;
+    latestStatusTransition(agentId: string, herdrSessionName: string): AgentEventRecord | undefined;
+    listAfter(input: AgentQueryScope & {
+        afterEventId?: number;
+        limit?: number;
+    }): AgentEventRecord[];
+    nextDeliverableAfter(input: {
+        afterEventId: number;
+        herdrSessionName: string;
+        ownerTerminalId: string;
+        workspaceId: string;
+    }): AgentEventRecord | undefined;
+    latestEventId(scope?: AgentQueryScope): number;
+    get(id: number): AgentEventRecord;
+}
+export declare function mapAgentEvent(row: AgentEventRow): AgentEventRecord;
+export {};
+//# sourceMappingURL=agent-events.d.ts.map

package/dist/src/db/agent-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-events.d.ts","sourceRoot":"","sources":["../../../src/db/agent-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAEtC,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oBAAoB,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,CAAC,GAAG,CAAC,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,cAAc,CAAC;IACrB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,qBAAa,eAAe;;gBAGd,MAAM,EAAE,YAAY;IAIhC,MAAM,CAAC,KAAK,EAAE;QACZ,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,cAAc,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;QAC5C,gBAAgB,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC/B,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,IAAI,EAAE,cAAc,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,GAAG,gBAAgB;IAgCpB,cAAc,CAAC,KAAK,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI;IAUzG,sBAAsB,CACpB,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,MAAM,GACvB,gBAAgB,GAAG,SAAS;IAW/B,SAAS,CACP,KAAK,EAAE,eAAe,GAAG;QAAE,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACjE,gBAAgB,EAAE;IAkBrB,oBAAoB,CAAC,KAAK,EAAE;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;KACrB,GAAG,gBAAgB,GAAG,SAAS;IA2BhC,aAAa,CAAC,KAAK,GAAE,eAAoB,GAAG,MAAM;IAkBlD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB;CAOlC;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,gBAAgB,CAclE"}

package/dist/src/db/agent-events.js

@@ -0,0 +1,124 @@
+export class AgentEventStore {
+    #sqlite;
+    constructor(sqlite) {
+        this.#sqlite = sqlite;
+    }
+    append(input) {
+        const existing = input.idempotencyKey
+            ? this.#sqlite
+                .prepare("select * from agent_events where herdr_session_name = ? and idempotency_key = ?")
+                .get(input.herdrSessionName, input.idempotencyKey)
+            : undefined;
+        if (existing)
+            return mapAgentEvent(existing);
+        const result = this.#sqlite
+            .prepare(`insert into agent_events
+         (herdr_session_name, agent_id, pane_id, pane_generation, workspace_id, terminal_id, type, payload_json, compact_history_json, idempotency_key, deliverable, created_at)
+         values (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 1, ?)`)
+            .run(input.herdrSessionName, input.agentId ?? null, input.paneId ?? null, input.paneGeneration ?? null, input.workspaceId ?? null, input.terminalId ?? null, input.type, JSON.stringify(input.payload), input.compactHistory ? JSON.stringify(input.compactHistory) : null, input.idempotencyKey ?? null, Date.now());
+        return this.get(Number(result.lastInsertRowid));
+    }
+    invalidatePane(input) {
+        this.#sqlite
+            .prepare(`update agent_events set deliverable = 0
+         where herdr_session_name = ? and pane_id = ?
+           and (? is null or pane_generation = ? or pane_generation is null)`)
+            .run(input.herdrSessionName, input.paneId, input.paneGeneration ?? null, input.paneGeneration ?? null);
+    }
+    latestStatusTransition(agentId, herdrSessionName) {
+        const row = this.#sqlite
+            .prepare(`select * from agent_events
+         where agent_id = ? and herdr_session_name = ? and type = 'agent.status.changed'
+         order by id desc limit 1`)
+            .get(agentId, herdrSessionName);
+        return row ? mapAgentEvent(row) : undefined;
+    }
+    listAfter(input) {
+        const clauses = ["id > ?"];
+        const params = [input.afterEventId ?? 0];
+        if (input.herdrSessionName) {
+            clauses.push("herdr_session_name = ?");
+            params.push(input.herdrSessionName);
+        }
+        if (input.workspaceId) {
+            clauses.push("workspace_id = ?");
+            params.push(input.workspaceId);
+        }
+        const limit = input.limit ?? 100;
+        const rows = this.#sqlite
+            .prepare(`select * from agent_events where ${clauses.join(" and ")} order by id asc limit ?`)
+            .all(...params, limit);
+        return rows.map(mapAgentEvent);
+    }
+    nextDeliverableAfter(input) {
+        const row = this.#sqlite
+            .prepare(`select * from agent_events
+         where id > ?
+           and deliverable = 1
+           and herdr_session_name = ?
+           and workspace_id = ?
+           and terminal_id is not null
+           and terminal_id != ?
+           and agent_id is not null
+           and exists (
+             select 1 from agents
+             where agents.id = agent_events.agent_id
+               and agents.herdr_session_name = agent_events.herdr_session_name
+               and agents.workspace_id = agent_events.workspace_id
+               and agents.pane_id = agent_events.pane_id
+           )
+         order by id asc
+         limit 1`)
+            .get(input.afterEventId, input.herdrSessionName, input.workspaceId, input.ownerTerminalId);
+        return row ? mapAgentEvent(row) : undefined;
+    }
+    latestEventId(scope = {}) {
+        const clauses = [];
+        const params = [];
+        if (scope.herdrSessionName) {
+            clauses.push("herdr_session_name = ?");
+            params.push(scope.herdrSessionName);
+        }
+        if (scope.workspaceId) {
+            clauses.push("workspace_id = ?");
+            params.push(scope.workspaceId);
+        }
+        const where = clauses.length > 0 ? ` where ${clauses.join(" and ")}` : "";
+        const row = this.#sqlite
+            .prepare(`select max(id) as id from agent_events${where}`)
+            .get(...params);
+        return row?.id ?? 0;
+    }
+    get(id) {
+        const row = this.#sqlite.prepare("select * from agent_events where id = ?").get(id);
+        if (!row)
+            throw new Error(`Agent event not found: ${id}`);
+        return mapAgentEvent(row);
+    }
+}
+export function mapAgentEvent(row) {
+    return {
+        agentId: row.agent_id,
+        compactHistory: parseJson(row.compact_history_json),
+        createdAt: new Date(row.created_at),
+        herdrSessionName: row.herdr_session_name,
+        id: row.id,
+        paneId: row.pane_id,
+        paneGeneration: row.pane_generation,
+        payload: parseJson(row.payload_json) ?? {},
+        terminalId: row.terminal_id,
+        type: row.type,
+        workspaceId: row.workspace_id,
+    };
+}
+function parseJson(value) {
+    if (!value)
+        return null;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=agent-events.js.map