@alpacakit/agents 0.1.0-beta.20 → 0.1.0-beta.21

package/dist/internal/controlled-process/supervisor-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-model.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/supervisor-model.ts"],"names":[],"mappings":"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"}

package/dist/internal/controlled-process/supervisor-model.js

@@ -0,0 +1 @@
+export {};

package/dist/internal/controlled-process/supervisor-platform.d.ts

@@ -0,0 +1,16 @@
+import type { ControlledProcessPlatform, ShimProcessId, SupervisorBootId } from "./model.js";
+import type { ProcessProbe, ProcessSignalResult } from "./supervisor-model.js";
+export interface SupervisorPlatformAdapter {
+    readonly platform: ControlledProcessPlatform;
+    readonly uid: number;
+    bootId(): Promise<SupervisorBootId>;
+    probeGroup(pid: ShimProcessId): ProcessProbe;
+    signalGroup(pid: ShimProcessId, signal: "SIGTERM" | "SIGKILL"): ProcessSignalResult;
+}
+export declare function createSupervisorPlatformAdapter(): SupervisorPlatformAdapter;
+export declare function requireSupportedPlatform(platform: NodeJS.Platform): ControlledProcessPlatform;
+export declare function parseLinuxBootId(value: string): SupervisorBootId;
+export declare function parseMacOsBootTime(value: string): SupervisorBootId;
+export declare function probeProcessGroup(pid: ShimProcessId): ProcessProbe;
+export declare function signalProcessGroup(pid: ShimProcessId, signal: "SIGTERM" | "SIGKILL"): ProcessSignalResult;
+//# sourceMappingURL=supervisor-platform.d.ts.map

package/dist/internal/controlled-process/supervisor-platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-platform.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/supervisor-platform.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,yBAAyB,EACzB,aAAa,EACb,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAY/E,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACpC,UAAU,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,WAAW,CACT,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,SAAS,GAAG,SAAS,GAC5B,mBAAmB,CAAC;CACxB;AAED,wBAAgB,+BAA+B,IAAI,yBAAyB,CAa3E;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,QAAQ,GACxB,yBAAyB,CAK3B;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAIhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAWlE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAgBlE;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,aAAa,EAClB,MAAM,EAAE,SAAS,GAAG,SAAS,GAC5B,mBAAmB,CAgBrB"}

package/dist/internal/controlled-process/supervisor-platform.js

@@ -0,0 +1,104 @@
+import { execFile } from "node:child_process";
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import { supervisorBootIdSchema } from "./schema.js";
+import { PROCESS_PROBE_KIND, PROCESS_SIGNAL_RESULT_KIND, } from "./supervisor-values.js";
+const LINUX_BOOT_ID_PATH = "/proc/sys/kernel/random/boot_id";
+const MACOS_SYSCTL_PATH = "/usr/sbin/sysctl";
+const MACOS_BOOT_TIME_KEY = "kern.boottime";
+const MACOS_BOOT_TIME_PATTERN = /sec\s*=\s*(\d+),\s*usec\s*=\s*(\d+)/u;
+const UUID_SEPARATOR_PATTERN = /-/gu;
+export function createSupervisorPlatformAdapter() {
+    const platform = requireSupportedPlatform(process.platform);
+    const uid = process.getuid?.();
+    if (uid === undefined) {
+        throw new Error("Supervisor requires a real POSIX uid.");
+    }
+    return {
+        platform,
+        uid,
+        bootId: () => readPlatformBootId(platform),
+        probeGroup: probeProcessGroup,
+        signalGroup: signalProcessGroup,
+    };
+}
+export function requireSupportedPlatform(platform) {
+    if (platform !== "darwin" && platform !== "linux") {
+        throw new Error(`Unsupported supervisor platform: ${platform}`);
+    }
+    return platform;
+}
+export function parseLinuxBootId(value) {
+    return supervisorBootIdSchema.parse(value.trim().toLowerCase().replace(UUID_SEPARATOR_PATTERN, ""));
+}
+export function parseMacOsBootTime(value) {
+    const match = MACOS_BOOT_TIME_PATTERN.exec(value);
+    if (match?.[1] === undefined || match[2] === undefined) {
+        throw new Error("macOS boot time response is invalid.");
+    }
+    return supervisorBootIdSchema.parse(createHash("sha256")
+        .update(`darwin:${match[1]}:${match[2]}`)
+        .digest("hex")
+        .slice(0, 32));
+}
+export function probeProcessGroup(pid) {
+    try {
+        process.kill(-pid, 0);
+        return { kind: PROCESS_PROBE_KIND.alive };
+    }
+    catch (error) {
+        if (isErrno(error, "ESRCH")) {
+            return { kind: PROCESS_PROBE_KIND.absent };
+        }
+        if (isErrno(error, "EPERM")) {
+            return { kind: PROCESS_PROBE_KIND.denied };
+        }
+        return {
+            kind: PROCESS_PROBE_KIND.failed,
+            code: errnoCode(error),
+        };
+    }
+}
+export function signalProcessGroup(pid, signal) {
+    try {
+        process.kill(-pid, signal);
+        return { kind: PROCESS_SIGNAL_RESULT_KIND.sent };
+    }
+    catch (error) {
+        if (isErrno(error, "ESRCH")) {
+            return { kind: PROCESS_SIGNAL_RESULT_KIND.absent };
+        }
+        if (isErrno(error, "EPERM")) {
+            return { kind: PROCESS_SIGNAL_RESULT_KIND.denied };
+        }
+        return {
+            kind: PROCESS_SIGNAL_RESULT_KIND.failed,
+            code: errnoCode(error),
+        };
+    }
+}
+async function readPlatformBootId(platform) {
+    if (platform === "linux") {
+        return parseLinuxBootId(await readFile(LINUX_BOOT_ID_PATH, "utf8"));
+    }
+    return parseMacOsBootTime(await execFileText(MACOS_SYSCTL_PATH, ["-n", MACOS_BOOT_TIME_KEY]));
+}
+function execFileText(command, args) {
+    return new Promise((resolve, reject) => {
+        execFile(command, [...args], { encoding: "utf8" }, (error, stdout) => {
+            if (error !== null) {
+                reject(error);
+                return;
+            }
+            resolve(stdout);
+        });
+    });
+}
+function isErrno(error, code) {
+    return error instanceof Error && "code" in error && error.code === code;
+}
+function errnoCode(error) {
+    return error instanceof Error && "code" in error
+        ? String(error.code)
+        : "UNKNOWN";
+}

package/dist/internal/controlled-process/supervisor-runtime.d.ts

@@ -0,0 +1,11 @@
+import type { Writable } from "node:stream";
+import { SupervisorCoordinator } from "./supervisor-coordinator.js";
+import { SupervisorSocketServer } from "./supervisor-transport.js";
+type SupervisorRuntimeDependencies = {
+    writeShimAck(control: Writable): Promise<void>;
+    persistInitialRecord?(coordinator: SupervisorCoordinator): Promise<void>;
+    finalizeSupervisorSocket?(server: SupervisorSocketServer): ReturnType<SupervisorSocketServer["finalize"]>;
+};
+export declare function runControlledProcessSupervisor(dependencies?: SupervisorRuntimeDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=supervisor-runtime.d.ts.map

package/dist/internal/controlled-process/supervisor-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor-runtime.d.ts","sourceRoot":"","sources":["../../../src/internal/controlled-process/supervisor-runtime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAY,QAAQ,EAAE,MAAM,aAAa,CAAC;AA4BtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAcpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAqCnE,KAAK,6BAA6B,GAAG;IACnC,YAAY,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,oBAAoB,CAAC,CAAC,WAAW,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,wBAAwB,CAAC,CACvB,MAAM,EAAE,sBAAsB,GAC7B,UAAU,CAAC,sBAAsB,CAAC,UAAU,CAAC,CAAC,CAAC;CACnD,CAAC;AAaF,wBAAsB,8BAA8B,CAClD,YAAY,GAAE,6BAA+D,GAC5E,OAAO,CAAC,IAAI,CAAC,CA6Bf"}