opencode-supertask 0.1.26 → 0.1.27

package/dist/daemon/pm2-supervisor.d.ts

@@ -0,0 +1,3 @@
+declare function superviseOnce(pm2Path: string, env?: NodeJS.ProcessEnv): boolean;
+
+export { superviseOnce };

package/dist/daemon/pm2-supervisor.js

@@ -0,0 +1,145 @@
+// src/daemon/pm2-supervisor.ts
+import { spawnSync } from "child_process";
+import { readFileSync } from "fs";
+import { homedir } from "os";
+import { join, resolve } from "path";
+
+// src/daemon/management-lock.ts
+import { Database } from "bun:sqlite";
+import { mkdirSync } from "fs";
+import { dirname } from "path";
+var ManagementLockBusyError = class extends Error {
+  constructor() {
+    super("Gateway management lock is busy");
+    this.name = "ManagementLockBusyError";
+  }
+};
+function isBusyError(error) {
+  if (!(error instanceof Error)) return false;
+  const code = error.code;
+  return code === "SQLITE_BUSY" || /database is locked/i.test(error.message);
+}
+function withExclusiveManagementLock(path, timeoutMs, action) {
+  mkdirSync(dirname(path), { recursive: true });
+  const database = new Database(path, { create: true });
+  const normalizedTimeout = Number.isFinite(timeoutMs) && timeoutMs >= 0 ? Math.floor(timeoutMs) : 0;
+  database.exec(`PRAGMA busy_timeout = ${normalizedTimeout}`);
+  try {
+    try {
+      database.exec("BEGIN IMMEDIATE");
+    } catch (error) {
+      if (isBusyError(error)) throw new ManagementLockBusyError();
+      throw error;
+    }
+    try {
+      const result = action();
+      database.exec("COMMIT");
+      return result;
+    } catch (error) {
+      try {
+        database.exec("ROLLBACK");
+      } catch {
+      }
+      throw error;
+    }
+  } finally {
+    database.close();
+  }
+}
+
+// src/daemon/pm2-supervisor.ts
+var PROCESS_NAME = "supertask-gateway";
+var POLL_INTERVAL_MS = 5e3;
+function pm2Home(env) {
+  const home = resolve(env.HOME || homedir());
+  return env.PM2_HOME ? resolve(env.PM2_HOME) : join(home, ".pm2");
+}
+function managementLockPaths(env) {
+  const canonical = join(pm2Home(env), "supertask-gateway.manage.sqlite");
+  const legacy = env.SUPERTASK_PM2_MANAGEMENT_LOCK ? resolve(env.SUPERTASK_PM2_MANAGEMENT_LOCK) : canonical;
+  return [canonical, ...[legacy].filter((path) => path !== canonical).sort()];
+}
+function withManagementLocks(paths, timeoutMs, action, index = 0) {
+  const path = paths[index];
+  if (!path) return action();
+  return withExclusiveManagementLock(
+    path,
+    timeoutMs,
+    () => withManagementLocks(paths, timeoutMs, action, index + 1)
+  );
+}
+function commandTimeoutMs(env) {
+  const configured = Number(
+    env.SUPERTASK_PM2_SUPERVISOR_COMMAND_TIMEOUT_MS ?? env.SUPERTASK_PM2_COMMAND_TIMEOUT_MS ?? 15e3
+  );
+  return Number.isFinite(configured) && configured > 0 ? configured : 15e3;
+}
+function dumpContainsGateway(env) {
+  try {
+    const parsed = JSON.parse(readFileSync(join(pm2Home(env), "dump.pm2"), "utf8"));
+    if (!Array.isArray(parsed)) return null;
+    return parsed.some((item) => item.name === PROCESS_NAME);
+  } catch (error) {
+    return error.code === "ENOENT" ? false : null;
+  }
+}
+function superviseUnlocked(pm2Path, env) {
+  const list = spawnSync(pm2Path, ["jlist"], {
+    encoding: "utf8",
+    env,
+    stdio: ["ignore", "pipe", "pipe"],
+    timeout: commandTimeoutMs(env),
+    killSignal: "SIGKILL"
+  });
+  if (list.status !== 0 || list.error) return false;
+  let parsed;
+  try {
+    parsed = JSON.parse(list.stdout);
+  } catch {
+    return false;
+  }
+  if (!Array.isArray(parsed)) return false;
+  const gateway = parsed.find((item) => item.name === PROCESS_NAME);
+  if (!gateway) {
+    const savedGateway = dumpContainsGateway(env);
+    if (savedGateway !== true) return savedGateway === false;
+    const resurrect = spawnSync(pm2Path, ["resurrect"], {
+      env,
+      stdio: "inherit",
+      timeout: commandTimeoutMs(env),
+      killSignal: "SIGKILL"
+    });
+    return resurrect.status === 0 && !resurrect.error;
+  }
+  const status = gateway.pm2_env?.status;
+  return status === "online" || status === "launching" || status === "waiting restart" || status === "stopping" || status === "stopped" || status === "errored";
+}
+function superviseOnce(pm2Path, env = process.env) {
+  try {
+    return withManagementLocks(
+      managementLockPaths(env),
+      0,
+      () => superviseUnlocked(pm2Path, env)
+    );
+  } catch (error) {
+    if (error instanceof ManagementLockBusyError) return true;
+    return false;
+  }
+}
+function run() {
+  const pm2Path = Bun.argv[2];
+  if (!pm2Path) throw new Error("pm2 supervisor requires an absolute pm2 executable path");
+  superviseOnce(pm2Path);
+  const timer = setInterval(() => superviseOnce(pm2Path), POLL_INTERVAL_MS);
+  const shutdown = () => {
+    clearInterval(timer);
+    process.exit(0);
+  };
+  process.once("SIGTERM", shutdown);
+  process.once("SIGINT", shutdown);
+}
+if (import.meta.main) run();
+export {
+  superviseOnce
+};
+//# sourceMappingURL=pm2-supervisor.js.map

package/dist/daemon/pm2-supervisor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/daemon/pm2-supervisor.ts","../../src/daemon/management-lock.ts"],"sourcesContent":["import { spawnSync } from 'child_process';\nimport { readFileSync } from 'fs';\nimport { homedir } from 'os';\nimport { join, resolve } from 'path';\nimport { ManagementLockBusyError, withExclusiveManagementLock } from './management-lock';\n\nconst PROCESS_NAME = 'supertask-gateway';\nconst POLL_INTERVAL_MS = 5_000;\n\ninterface Pm2ProcessSnapshot {\n    name?: unknown;\n    pm2_env?: { status?: unknown };\n}\n\nfunction pm2Home(env: NodeJS.ProcessEnv): string {\n    const home = resolve(env.HOME || homedir());\n    return env.PM2_HOME ? resolve(env.PM2_HOME) : join(home, '.pm2');\n}\n\nfunction managementLockPaths(env: NodeJS.ProcessEnv): string[] {\n    const canonical = join(pm2Home(env), 'supertask-gateway.manage.sqlite');\n    const legacy = env.SUPERTASK_PM2_MANAGEMENT_LOCK\n        ? resolve(env.SUPERTASK_PM2_MANAGEMENT_LOCK)\n        : canonical;\n    return [canonical, ...[legacy].filter((path) => path !== canonical).sort()];\n}\n\nfunction withManagementLocks<T>(\n    paths: string[],\n    timeoutMs: number,\n    action: () => T,\n    index = 0,\n): T {\n    const path = paths[index];\n    if (!path) return action();\n    return withExclusiveManagementLock(\n        path,\n        timeoutMs,\n        () => withManagementLocks(paths, timeoutMs, action, index + 1),\n    );\n}\n\nfunction commandTimeoutMs(env: NodeJS.ProcessEnv): number {\n    const configured = Number(\n        env.SUPERTASK_PM2_SUPERVISOR_COMMAND_TIMEOUT_MS\n        ?? env.SUPERTASK_PM2_COMMAND_TIMEOUT_MS\n        ?? 15_000,\n    );\n    return Number.isFinite(configured) && configured > 0 ? configured : 15_000;\n}\n\nfunction dumpContainsGateway(env: NodeJS.ProcessEnv): boolean | null {\n    try {\n        const parsed = JSON.parse(readFileSync(join(pm2Home(env), 'dump.pm2'), 'utf8')) as unknown;\n        if (!Array.isArray(parsed)) return null;\n        return (parsed as Pm2ProcessSnapshot[]).some((item) => item.name === PROCESS_NAME);\n    } catch (error) {\n        return (error as NodeJS.ErrnoException).code === 'ENOENT' ? false : null;\n    }\n}\n\nfunction superviseUnlocked(pm2Path: string, env: NodeJS.ProcessEnv): boolean {\n    const list = spawnSync(pm2Path, ['jlist'], {\n        encoding: 'utf8',\n        env,\n        stdio: ['ignore', 'pipe', 'pipe'],\n        timeout: commandTimeoutMs(env),\n        killSignal: 'SIGKILL',\n    });\n    if (list.status !== 0 || list.error) return false;\n\n    let parsed: unknown;\n    try {\n        parsed = JSON.parse(list.stdout) as unknown;\n    } catch {\n        return false;\n    }\n    if (!Array.isArray(parsed)) return false;\n\n    const gateway = (parsed as Pm2ProcessSnapshot[]).find((item) => item.name === PROCESS_NAME);\n    if (!gateway) {\n        const savedGateway = dumpContainsGateway(env);\n        if (savedGateway !== true) return savedGateway === false;\n        const resurrect = spawnSync(pm2Path, ['resurrect'], {\n            env,\n            stdio: 'inherit',\n            timeout: commandTimeoutMs(env),\n            killSignal: 'SIGKILL',\n        });\n        return resurrect.status === 0 && !resurrect.error;\n    }\n\n    const status = gateway.pm2_env?.status;\n    return status === 'online'\n        || status === 'launching'\n        || status === 'waiting restart'\n        || status === 'stopping'\n        || status === 'stopped'\n        || status === 'errored';\n}\n\nexport function superviseOnce(pm2Path: string, env: NodeJS.ProcessEnv = process.env): boolean {\n    try {\n        return withManagementLocks(\n            managementLockPaths(env),\n            0,\n            () => superviseUnlocked(pm2Path, env),\n        );\n    } catch (error) {\n        if (error instanceof ManagementLockBusyError) return true;\n        return false;\n    }\n}\n\nfunction run(): void {\n    const pm2Path = Bun.argv[2];\n    if (!pm2Path) throw new Error('pm2 supervisor requires an absolute pm2 executable path');\n\n    superviseOnce(pm2Path);\n    const timer = setInterval(() => superviseOnce(pm2Path), POLL_INTERVAL_MS);\n    const shutdown = () => {\n        clearInterval(timer);\n        process.exit(0);\n    };\n    process.once('SIGTERM', shutdown);\n    process.once('SIGINT', shutdown);\n}\n\nif (import.meta.main) run();\n","import { Database } from 'bun:sqlite';\nimport { mkdirSync } from 'fs';\nimport { dirname } from 'path';\n\nexport class ManagementLockBusyError extends Error {\n    constructor() {\n        super('Gateway management lock is busy');\n        this.name = 'ManagementLockBusyError';\n    }\n}\n\nfunction isBusyError(error: unknown): boolean {\n    if (!(error instanceof Error)) return false;\n    const code = (error as Error & { code?: string }).code;\n    return code === 'SQLITE_BUSY' || /database is locked/i.test(error.message);\n}\n\n/**\n * Serializes PM2 lifecycle changes with an OS-backed SQLite write lock.\n * The transaction is held for the complete action and is released by SQLite\n * automatically if the owning process exits or is killed.\n */\nexport function withExclusiveManagementLock<T>(\n    path: string,\n    timeoutMs: number,\n    action: () => T,\n): T {\n    mkdirSync(dirname(path), { recursive: true });\n    const database = new Database(path, { create: true });\n    const normalizedTimeout = Number.isFinite(timeoutMs) && timeoutMs >= 0\n        ? Math.floor(timeoutMs)\n        : 0;\n    database.exec(`PRAGMA busy_timeout = ${normalizedTimeout}`);\n\n    try {\n        try {\n            database.exec('BEGIN IMMEDIATE');\n        } catch (error) {\n            if (isBusyError(error)) throw new ManagementLockBusyError();\n            throw error;\n        }\n\n        try {\n            const result = action();\n            database.exec('COMMIT');\n            return result;\n        } catch (error) {\n            try {\n                database.exec('ROLLBACK');\n            } catch {}\n            throw error;\n        }\n    } finally {\n        database.close();\n    }\n}\n"],"mappings":"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","names":[]}

package/dist/gateway/index.d.ts

@@ -1,5 +1,12 @@
+interface GatewayShutdownFailure {
+    step: string;
+    error: string;
+}
+declare function runGatewayShutdownStep(failures: GatewayShutdownFailure[], step: string, operation: () => void | Promise<void>): Promise<void>;
+declare function resolveGatewayShutdownExitCode(requestedExitCode: number, failures: GatewayShutdownFailure[]): number;
 declare function acquireLock(): boolean;
 declare function releaseLock(): void;
+declare function updateLockHeartbeat(): boolean;
 declare function main(): Promise<void>;
 
-export { acquireLock, main, releaseLock };
+export { type GatewayShutdownFailure, acquireLock, main, releaseLock, resolveGatewayShutdownExitCode, runGatewayShutdownStep, updateLockHeartbeat };