@pushary/agent-hooks 0.89.3 → 0.89.5

package/dist/chunk-TRQ46MXR.js

@@ -0,0 +1,648 @@
+import {
+  needsShell,
+  spawnClaude
+} from "./chunk-XHKBHWLX.js";
+import {
+  resolveGlobalBinary
+} from "./chunk-PZA7G4CN.js";
+import {
+  getMachineId
+} from "./chunk-2HYPZLYY.js";
+import {
+  pusharyDir
+} from "./chunk-V37ZXMH3.js";
+import {
+  getPackageVersion
+} from "./chunk-DINDL2CF.js";
+import {
+  readJsonSafe,
+  writeFileAtomic,
+  writeJsonAtomic
+} from "./chunk-6MTNS63X.js";
+import {
+  getApiKey
+} from "./chunk-2UMNXADU.js";
+
+// src/daemon-lifecycle.ts
+import { dirname, join, win32 as win32Path } from "path";
+import { existsSync, mkdirSync, realpathSync, renameSync, unlinkSync, writeFileSync } from "fs";
+import { createHash, randomUUID } from "crypto";
+import { homedir } from "os";
+import { execFileSync } from "child_process";
+var daemonNeedsHandoff = (status) => status.kind === "version-mismatch" || status.kind === "configuration-mismatch" || status.kind === "unresponsive" && status.processAlive === true;
+var daemonServiceManagerAvailable = (options = {}) => {
+  const platform = options.platform ?? process.platform;
+  const run = options.run ?? ((command, args) => {
+    execFileSync(command, [...args], { stdio: "ignore", windowsHide: true });
+  });
+  try {
+    if (platform === "darwin") {
+      const uid = options.uid ?? process.getuid?.();
+      if (uid === void 0) return false;
+      run("launchctl", ["print", `gui/${uid}`]);
+      return true;
+    }
+    if (platform === "linux") {
+      run("systemctl", ["--user", "show-environment"]);
+      return true;
+    }
+    if (platform === "win32") {
+      run("sc.exe", ["query", "Schedule"]);
+      return true;
+    }
+    return false;
+  } catch {
+    return false;
+  }
+};
+var statePath = (dir) => join(dir, "daemon-state.json");
+var lockPath = (dir) => join(dir, "daemon.lock");
+var targetPath = (dir) => join(dir, "daemon-target.json");
+var DAEMON_LEASE_RENEW_INTERVAL_MS = 3e4;
+var LOCAL_LEASE_TIMEOUT_MS = DAEMON_LEASE_RENEW_INTERVAL_MS * 3;
+var buildDaemonLaunch = (input) => input.siblingEntry ? { command: input.execPath, args: [input.siblingEntry], shell: false } : {
+  command: input.daemonBinary,
+  args: [],
+  shell: needsShell(input.daemonBinary, input.platform ?? process.platform)
+};
+var xml = (value) => value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+var systemdQuote = (value) => `"${value.replaceAll("%", "%%").replaceAll("\\", "\\\\").replaceAll('"', '\\"')}"`;
+var buildDaemonService = (input) => {
+  if (input.platform === "darwin") {
+    if (!Number.isInteger(input.uid) || input.uid < 0) return null;
+    const label = "com.pushary.daemon";
+    const domain = `gui/${input.uid}`;
+    const target = `${domain}/${label}`;
+    const definitionPath = join(input.homeDir, "Library", "LaunchAgents", `${label}.plist`);
+    const contents = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${label}</string>
+  <key>ProgramArguments</key>
+  <array><string>${xml(input.execPath)}</string><string>${xml(input.daemonEntry)}</string></array>
+  <key>WorkingDirectory</key><string>${xml(input.homeDir)}</string>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${xml(input.pathEnv)}</string></dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><dict><key>SuccessfulExit</key><false/></dict>
+  <key>ThrottleInterval</key><integer>10</integer>
+  <key>StandardOutPath</key><string>${xml(join(input.stateDir, "daemon.log"))}</string>
+  <key>StandardErrorPath</key><string>${xml(join(input.stateDir, "daemon-error.log"))}</string>
+</dict>
+</plist>
+`;
+    const bootstrap = { command: "launchctl", args: ["bootstrap", domain, definitionPath] };
+    return {
+      definitionPath,
+      contents,
+      install: [
+        { command: "launchctl", args: ["bootout", domain, definitionPath], ignoreFailure: true },
+        bootstrap,
+        { command: "launchctl", args: ["enable", target] },
+        { command: "launchctl", args: ["kickstart", "-k", target] }
+      ],
+      start: [{ command: "launchctl", args: ["kickstart", "-k", target] }],
+      stop: [{ command: "launchctl", args: ["kill", "SIGTERM", target], ignoreFailure: true }],
+      uninstall: [{ command: "launchctl", args: ["bootout", domain, definitionPath], ignoreFailure: true }],
+      registrationProbe: { command: "launchctl", args: ["print", target] }
+    };
+  }
+  if (input.platform === "linux") {
+    const unit = "pushary-daemon.service";
+    const definitionPath = join(input.homeDir, ".config", "systemd", "user", unit);
+    const contents = `[Unit]
+Description=Pushary phone-to-agent daemon
+After=network-online.target
+
+[Service]
+Type=simple
+ExecStart=${systemdQuote(input.execPath)} ${systemdQuote(input.daemonEntry)}
+WorkingDirectory=${systemdQuote(input.homeDir)}
+Environment=${systemdQuote(`PATH=${input.pathEnv}`)}
+Restart=on-failure
+RestartSec=10
+
+[Install]
+WantedBy=default.target
+`;
+    return {
+      definitionPath,
+      contents,
+      install: [
+        { command: "systemctl", args: ["--user", "daemon-reload"] },
+        { command: "systemctl", args: ["--user", "enable", "--now", unit] }
+      ],
+      start: [{ command: "systemctl", args: ["--user", "start", unit] }],
+      stop: [{ command: "systemctl", args: ["--user", "stop", unit], ignoreFailure: true }],
+      uninstall: [
+        { command: "systemctl", args: ["--user", "disable", "--now", unit], ignoreFailure: true }
+      ],
+      registrationProbe: { command: "systemctl", args: ["--user", "is-enabled", unit] },
+      reloadAfterUninstall: { command: "systemctl", args: ["--user", "daemon-reload"] }
+    };
+  }
+  if (input.platform === "win32") {
+    const taskName = "Pushary Daemon";
+    const definitionPath = win32Path.join(input.stateDir, "pushary-daemon-task.xml");
+    const contents = `<?xml version="1.0" encoding="UTF-8"?>
+<Task version="1.4" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo><Description>Pushary phone-to-agent daemon</Description></RegistrationInfo>
+  <Triggers><LogonTrigger><Enabled>true</Enabled></LogonTrigger></Triggers>
+  <Principals><Principal id="Author"><LogonType>InteractiveToken</LogonType><RunLevel>LeastPrivilege</RunLevel></Principal></Principals>
+  <Settings>
+    <MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy>
+    <StartWhenAvailable>true</StartWhenAvailable>
+    <DisallowStartIfOnBatteries>false</DisallowStartIfOnBatteries>
+    <StopIfGoingOnBatteries>false</StopIfGoingOnBatteries>
+    <ExecutionTimeLimit>PT0S</ExecutionTimeLimit>
+    <RestartOnFailure><Interval>PT1M</Interval><Count>999</Count></RestartOnFailure>
+  </Settings>
+  <Actions Context="Author">
+    <Exec>
+      <Command>${xml(input.execPath)}</Command>
+      <Arguments>&quot;${xml(input.daemonEntry)}&quot;</Arguments>
+      <WorkingDirectory>${xml(input.homeDir)}</WorkingDirectory>
+    </Exec>
+  </Actions>
+</Task>
+`;
+    return {
+      definitionPath,
+      contents,
+      install: [
+        { command: "schtasks.exe", args: ["/Create", "/TN", taskName, "/XML", definitionPath, "/F"] },
+        { command: "schtasks.exe", args: ["/Run", "/TN", taskName] }
+      ],
+      start: [{ command: "schtasks.exe", args: ["/Run", "/TN", taskName] }],
+      stop: [{ command: "schtasks.exe", args: ["/End", "/TN", taskName], ignoreFailure: true }],
+      uninstall: [{ command: "schtasks.exe", args: ["/Delete", "/TN", taskName, "/F"], ignoreFailure: true }],
+      registrationProbe: { command: "schtasks.exe", args: ["/Query", "/TN", taskName] }
+    };
+  }
+  return null;
+};
+var resolveDaemonServiceDefinition = (options = {}) => {
+  const platform = options.platform ?? process.platform;
+  const exists = options.entryExists ?? existsSync;
+  const globalBinary = options.globalBinary ?? resolveGlobalBinary("pushary-daemon");
+  let daemonEntry = options.daemonEntry;
+  if (!daemonEntry && globalBinary) {
+    if (platform === "win32") {
+      const globalRoot = win32Path.dirname(globalBinary);
+      const candidate = win32Path.join(
+        globalRoot,
+        "node_modules",
+        "@pushary",
+        "agent-hooks",
+        "dist",
+        "bin",
+        "pushary-daemon.js"
+      );
+      if (exists(candidate)) daemonEntry = candidate;
+    } else {
+      try {
+        const candidate = (options.realpath ?? realpathSync)(globalBinary);
+        if (exists(candidate)) daemonEntry = candidate;
+      } catch {
+      }
+    }
+  }
+  if (!daemonEntry || !exists(daemonEntry)) return null;
+  const homeDir = options.homeDir ?? homedir();
+  return buildDaemonService({
+    platform,
+    homeDir,
+    stateDir: options.stateDir ?? pusharyDir(),
+    execPath: options.execPath ?? process.execPath,
+    daemonEntry,
+    pathEnv: options.pathEnv ?? process.env.PATH ?? "",
+    uid: options.uid ?? process.getuid?.()
+  });
+};
+var applyDaemonService = (action, definition, options = {}) => {
+  const run = options.run ?? ((command, args) => {
+    execFileSync(command, [...args], { stdio: "ignore", windowsHide: true });
+  });
+  try {
+    if (action === "install") writeFileAtomic(definition.definitionPath, definition.contents, 384);
+    const steps = action === "uninstall" ? [...definition.stop, ...definition.uninstall] : definition[action];
+    for (const step of steps) {
+      try {
+        run(step.command, step.args);
+      } catch (err) {
+        if (!step.ignoreFailure) throw err;
+      }
+    }
+    if (action === "uninstall") {
+      let registered = false;
+      try {
+        run(definition.registrationProbe.command, definition.registrationProbe.args);
+        registered = true;
+      } catch {
+      }
+      if (registered) throw new Error("Native background service remains registered");
+      safeUnlink(definition.definitionPath);
+      const reload = definition.reloadAfterUninstall;
+      if (reload) run(reload.command, reload.args);
+    }
+    return { kind: "ok" };
+  } catch (err) {
+    return { kind: "failed", detail: err instanceof Error ? err.message : String(err) };
+  }
+};
+var DAEMON_ACTIONS = /* @__PURE__ */ new Set([
+  "install",
+  "start",
+  "stop",
+  "restart",
+  "status",
+  "uninstall",
+  "foreground"
+]);
+var parseDaemonAction = (argv) => {
+  const args = argv[0] === "daemon" ? argv.slice(1) : argv;
+  const action = args[0] ?? "foreground";
+  return DAEMON_ACTIONS.has(action) ? action : null;
+};
+var manageDaemonService = (action, options = {}) => {
+  const definition = action === "uninstall" ? buildDaemonService({
+    platform: options.platform ?? process.platform,
+    homeDir: options.homeDir ?? homedir(),
+    stateDir: options.stateDir ?? pusharyDir(),
+    execPath: options.execPath ?? process.execPath,
+    daemonEntry: options.daemonEntry ?? process.execPath,
+    pathEnv: options.pathEnv ?? process.env.PATH ?? "",
+    uid: options.uid ?? process.getuid?.()
+  }) : resolveDaemonServiceDefinition(options);
+  if (!definition) {
+    return {
+      kind: "unavailable",
+      detail: "Could not find the globally installed daemon entry. Run Pushary setup again."
+    };
+  }
+  if (action === "uninstall" && !daemonServiceManagerAvailable(options)) {
+    return { kind: "failed", detail: "Native background-service manager is unavailable" };
+  }
+  return applyDaemonService(action, definition, { run: options.run });
+};
+var hasDaemonServiceDefinition = (options = {}) => {
+  const definition = buildDaemonService({
+    platform: options.platform ?? process.platform,
+    homeDir: options.homeDir ?? homedir(),
+    stateDir: options.stateDir ?? pusharyDir(),
+    execPath: options.execPath ?? process.execPath,
+    daemonEntry: options.daemonEntry ?? process.execPath,
+    pathEnv: options.pathEnv ?? process.env.PATH ?? "",
+    uid: options.uid ?? process.getuid?.()
+  });
+  return definition !== null && existsSync(definition.definitionPath);
+};
+var spawnDetachedDaemon = (plan, options = {}) => {
+  const spawnImpl = options.spawnImpl ?? spawnClaude;
+  const child = spawnImpl(plan.command, plan.args, {
+    detached: true,
+    stdio: "ignore",
+    windowsHide: true,
+    shell: plan.shell
+  });
+  child.once?.("error", () => {
+  });
+  child.unref();
+  return typeof child.pid === "number" ? child.pid : null;
+};
+var processIsAlive = (pid) => {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return err.code === "EPERM";
+  }
+};
+var isString = (value) => typeof value === "string" && value.length > 0;
+var isTimestamp = (value) => isString(value) && Number.isFinite(Date.parse(value));
+var currentConfigurationId = () => {
+  try {
+    return createHash("sha256").update(getApiKey()).digest("hex").slice(0, 16);
+  } catch {
+    return null;
+  }
+};
+var parseDaemonState = (value) => {
+  if (typeof value !== "object" || value === null) return null;
+  const state = value;
+  if (!isString(state.instanceId) || !Number.isInteger(state.pid) || state.pid <= 0 || !isString(state.version) || !(state.configurationId === void 0 || state.configurationId === null || isString(state.configurationId)) || !isString(state.machineId) || !isTimestamp(state.startedAt) || !isTimestamp(state.updatedAt) || !(state.lastSuccessfulHeartbeatAt === null || isTimestamp(state.lastSuccessfulHeartbeatAt))) return null;
+  return {
+    instanceId: state.instanceId,
+    pid: state.pid,
+    version: state.version,
+    configurationId: state.configurationId ?? null,
+    machineId: state.machineId,
+    startedAt: state.startedAt,
+    updatedAt: state.updatedAt,
+    lastSuccessfulHeartbeatAt: state.lastSuccessfulHeartbeatAt
+  };
+};
+var parseLockOwner = (value) => {
+  if (typeof value !== "object" || value === null) return null;
+  const owner = value;
+  return isString(owner.instanceId) && Number.isInteger(owner.pid) && owner.pid > 0 ? { instanceId: owner.instanceId, pid: owner.pid } : null;
+};
+var readDaemonStatus = (options = {}) => {
+  const dir = options.dir ?? pusharyDir();
+  const installedVersion = options.installedVersion ?? getPackageVersion();
+  const state = readJsonSafe(statePath(dir));
+  if (state.kind === "missing") {
+    return {
+      kind: "absent",
+      installedVersion,
+      machineId: null,
+      pid: null,
+      processAlive: null,
+      daemonVersion: null,
+      startedAt: null,
+      updatedAt: null,
+      lastSuccessfulHeartbeatAt: null
+    };
+  }
+  const value = state.kind === "ok" ? parseDaemonState(state.value) : null;
+  if (value) {
+    const alive = (options.isProcessAlive ?? processIsAlive)(value.pid);
+    const fresh = (options.now ?? Date.now)() - Date.parse(value.updatedAt) <= LOCAL_LEASE_TIMEOUT_MS;
+    const expectedConfigurationId = options.configurationId === void 0 ? currentConfigurationId() : options.configurationId;
+    return {
+      kind: !alive || !fresh ? "unresponsive" : value.version !== installedVersion ? "version-mismatch" : expectedConfigurationId !== null && value.configurationId !== null && value.configurationId !== expectedConfigurationId ? "configuration-mismatch" : "running",
+      installedVersion,
+      machineId: value.machineId,
+      pid: value.pid,
+      processAlive: alive,
+      daemonVersion: value.version,
+      startedAt: value.startedAt,
+      updatedAt: value.updatedAt,
+      lastSuccessfulHeartbeatAt: value.lastSuccessfulHeartbeatAt
+    };
+  }
+  return {
+    kind: "invalid",
+    installedVersion,
+    machineId: null,
+    pid: null,
+    processAlive: null,
+    daemonVersion: null,
+    startedAt: null,
+    updatedAt: null,
+    lastSuccessfulHeartbeatAt: null
+  };
+};
+var safeUnlink = (path) => {
+  try {
+    unlinkSync(path);
+  } catch (err) {
+    if (err.code !== "ENOENT") throw err;
+  }
+};
+var requestDaemonVersion = (version, options = {}) => {
+  const dir = options.dir ?? pusharyDir();
+  const now = options.now ?? Date.now;
+  writeJsonAtomic(targetPath(dir), { version, requestedAt: new Date(now()).toISOString() }, 384);
+};
+var acquireDaemonLease = (options = {}) => {
+  const dir = options.dir ?? pusharyDir();
+  const installedVersion = options.installedVersion ?? getPackageVersion();
+  const machineId = options.machineId ?? getMachineId();
+  const pid = options.pid ?? process.pid;
+  const now = options.now ?? Date.now;
+  const instanceId = randomUUID();
+  const startedAt = new Date(now()).toISOString();
+  const writeLock = () => {
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(lockPath(dir), JSON.stringify({ instanceId, pid }), { flag: "wx", mode: 384 });
+  };
+  try {
+    writeLock();
+  } catch (err) {
+    if (err.code !== "EEXIST") {
+      return { kind: "unavailable", detail: err instanceof Error ? err.message : String(err) };
+    }
+    const status = readDaemonStatus(options);
+    if (status.kind === "running" || status.kind === "version-mismatch" || status.kind === "configuration-mismatch") {
+      return { kind: "already-running", status };
+    }
+    const lock = readJsonSafe(lockPath(dir));
+    const owner = lock.kind === "ok" ? parseLockOwner(lock.value) : null;
+    if (!owner) return { kind: "unavailable", detail: "daemon lock is invalid" };
+    if ((options.isProcessAlive ?? processIsAlive)(owner.pid)) {
+      return { kind: "unavailable", detail: "daemon owner is still running or starting" };
+    }
+    const stale = join(dir, `daemon.lock.${instanceId}.stale`);
+    let ownsReplacement = false;
+    try {
+      renameSync(lockPath(dir), stale);
+      writeLock();
+      ownsReplacement = true;
+      safeUnlink(statePath(dir));
+      safeUnlink(stale);
+    } catch (retryError) {
+      if (ownsReplacement) safeUnlink(lockPath(dir));
+      try {
+        safeUnlink(stale);
+      } catch {
+      }
+      return { kind: "unavailable", detail: retryError instanceof Error ? retryError.message : String(retryError) };
+    }
+  }
+  const state = {
+    instanceId,
+    pid,
+    version: installedVersion,
+    configurationId: options.configurationId === void 0 ? currentConfigurationId() : options.configurationId,
+    machineId,
+    startedAt,
+    updatedAt: startedAt,
+    lastSuccessfulHeartbeatAt: null
+  };
+  try {
+    writeJsonAtomic(statePath(dir), state, 384);
+  } catch (err) {
+    safeUnlink(lockPath(dir));
+    return { kind: "unavailable", detail: err instanceof Error ? err.message : String(err) };
+  }
+  let currentState = state;
+  const isOwner = () => {
+    const owner = readJsonSafe(lockPath(dir));
+    return owner.kind === "ok" && owner.value.instanceId === instanceId;
+  };
+  const updateState = (next) => {
+    if (!isOwner()) return;
+    try {
+      writeJsonAtomic(statePath(dir), next, 384);
+      currentState = next;
+    } catch {
+    }
+  };
+  return {
+    kind: "acquired",
+    lease: {
+      isOwner,
+      renew: (at = now()) => {
+        updateState({ ...currentState, updatedAt: new Date(at).toISOString() });
+      },
+      recordSuccessfulHeartbeat: (at = now()) => {
+        const timestamp = new Date(at).toISOString();
+        updateState({
+          ...currentState,
+          updatedAt: timestamp,
+          lastSuccessfulHeartbeatAt: timestamp
+        });
+      },
+      shouldYield: () => {
+        if (!isOwner()) return true;
+        const target = readJsonSafe(targetPath(dir));
+        return target.kind === "ok" && (typeof target.value.version === "string" && target.value.version !== installedVersion || isTimestamp(target.value.requestedAt) && Date.parse(target.value.requestedAt) > Date.parse(startedAt));
+      },
+      release: () => {
+        if (!isOwner()) return;
+        safeUnlink(statePath(dir));
+        safeUnlink(lockPath(dir));
+      }
+    }
+  };
+};
+var hasConfiguration = () => {
+  try {
+    getApiKey();
+    return true;
+  } catch {
+    return false;
+  }
+};
+var wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+var requestDaemonHandoff = async (initial, options = {}) => {
+  const now = options.now ?? Date.now;
+  const requestedAt = Math.max(
+    now(),
+    initial.startedAt === null ? 0 : Date.parse(initial.startedAt) + 1
+  );
+  requestDaemonVersion(options.installedVersion ?? initial.installedVersion, {
+    dir: options.dir,
+    now: () => requestedAt
+  });
+  if (initial.pid === null || initial.processAlive !== true) return initial;
+  const sleep = options.sleep ?? wait;
+  const pollIntervalMs = options.pollIntervalMs ?? 50;
+  const attempts = Math.max(1, Math.ceil((options.waitTimeoutMs ?? 5e3) / pollIntervalMs));
+  let status = initial;
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    await sleep(pollIntervalMs);
+    status = readDaemonStatus(options);
+    if (status.pid !== initial.pid || status.processAlive !== true) break;
+  }
+  return status;
+};
+var stopDaemonRunning = async (options = {}) => {
+  const dir = options.dir ?? pusharyDir();
+  const initial = readDaemonStatus(options);
+  if (initial.pid === null || initial.processAlive !== true) {
+    safeUnlink(statePath(dir));
+    safeUnlink(lockPath(dir));
+    return { kind: "absent" };
+  }
+  let status;
+  try {
+    status = await requestDaemonHandoff(initial, options);
+  } catch (err) {
+    return { kind: "unavailable", detail: err instanceof Error ? err.message : String(err) };
+  }
+  if (status.pid === initial.pid && status.processAlive === true) {
+    return { kind: "unavailable", detail: "daemon did not stop" };
+  }
+  safeUnlink(statePath(dir));
+  safeUnlink(lockPath(dir));
+  return { kind: "stopped" };
+};
+var disableDaemonService = async (options = {}) => {
+  const platform = options.platform ?? process.platform;
+  const supported = ["darwin", "linux", "win32"].includes(platform);
+  const managerAvailable = supported && daemonServiceManagerAvailable(options);
+  const definitionPresent = supported && hasDaemonServiceDefinition(options);
+  const service = definitionPresent && !managerAvailable ? { kind: "failed", detail: "Native background-service manager is unavailable" } : managerAvailable ? manageDaemonService("uninstall", options) : { kind: "ok" };
+  const stopped = await stopDaemonRunning(options);
+  const failures = [
+    service.kind === "ok" ? null : service.detail,
+    stopped.kind === "unavailable" ? stopped.detail : null
+  ].filter((detail) => detail !== null);
+  return failures.length > 0 ? { kind: "failed", detail: failures.join("; ") } : { kind: "ok" };
+};
+var replaceDaemonService = async (options = {}) => {
+  const stopped = await stopDaemonRunning(options);
+  return stopped.kind === "unavailable" ? stopped : manageDaemonService("install", options);
+};
+var launchInstalledDaemon = (options) => {
+  const entryExists = options.entryExists ?? existsSync;
+  const argvEntry = process.argv[1];
+  const candidate = options.daemonEntry !== void 0 ? options.daemonEntry : argvEntry ? join(dirname(argvEntry), "pushary-daemon.js") : null;
+  const siblingEntry = candidate && entryExists(candidate) ? candidate : null;
+  const platform = options.platform ?? process.platform;
+  const daemonBinary = options.daemonBinary ?? resolveGlobalBinary("pushary-daemon") ?? (platform === "win32" ? "pushary-daemon.cmd" : "pushary-daemon");
+  const plan = buildDaemonLaunch({
+    siblingEntry,
+    execPath: options.execPath ?? process.execPath,
+    daemonBinary,
+    platform
+  });
+  spawnDetachedDaemon(plan, { spawnImpl: options.spawnImpl });
+};
+var ensureDaemonRunning = async (options = {}) => {
+  const initial = readDaemonStatus(options);
+  if (!(options.configured ?? hasConfiguration)()) {
+    return { kind: "not-configured", status: initial, detail: "Pushary is not configured on this machine" };
+  }
+  if (initial.kind === "running") return { kind: "running", status: initial };
+  let handoffStatus;
+  try {
+    handoffStatus = await requestDaemonHandoff(initial, options);
+  } catch (err) {
+    return {
+      kind: "unavailable",
+      status: initial,
+      detail: err instanceof Error ? err.message : String(err)
+    };
+  }
+  const sleep = options.sleep ?? wait;
+  const pollIntervalMs = options.pollIntervalMs ?? 50;
+  const attempts = Math.max(1, Math.ceil((options.waitTimeoutMs ?? 5e3) / pollIntervalMs));
+  if (handoffStatus.kind === "running") return { kind: "running", status: handoffStatus };
+  if (daemonNeedsHandoff(handoffStatus)) {
+    return { kind: "unavailable", status: handoffStatus, detail: "unhealthy daemon did not yield" };
+  }
+  try {
+    (options.spawnDaemon ?? (() => launchInstalledDaemon(options)))();
+  } catch (err) {
+    return {
+      kind: "unavailable",
+      status: initial,
+      detail: err instanceof Error ? err.message : String(err)
+    };
+  }
+  let status = initial;
+  for (let attempt = 0; attempt < attempts; attempt++) {
+    status = readDaemonStatus(options);
+    if (status.kind === "running") return { kind: "started", status };
+    await sleep(pollIntervalMs);
+  }
+  return { kind: "unavailable", status, detail: `daemon did not become healthy (${status.kind})` };
+};
+
+export {
+  daemonServiceManagerAvailable,
+  DAEMON_LEASE_RENEW_INTERVAL_MS,
+  parseDaemonAction,
+  manageDaemonService,
+  hasDaemonServiceDefinition,
+  readDaemonStatus,
+  acquireDaemonLease,
+  requestDaemonHandoff,
+  stopDaemonRunning,
+  disableDaemonService,
+  replaceDaemonService,
+  ensureDaemonRunning
+};

package/dist/{chunk-VKVHY5HD.js → chunk-V37ZXMH3.js}

@@ -1,6 +1,3 @@
-import {
-  canonicalJson
-} from "./chunk-GIRT7677.js";
 import {
   HOOK_BUDGETS,
   HOOK_LOCATOR_BINARY
@@ -10,6 +7,16 @@ import {
 import { createHash } from "crypto";
 import { homedir } from "os";
 import { join } from "path";
+
+// src/canonical-json.ts
+var canonicalJson = (value) => {
+  if (value === null || typeof value !== "object") return JSON.stringify(value);
+  if (Array.isArray(value)) return "[" + value.map(canonicalJson).join(",") + "]";
+  const record = value;
+  return "{" + Object.keys(record).sort().map((key) => JSON.stringify(key) + ":" + canonicalJson(record[key])).join(",") + "}";
+};
+
+// src/codex-config.ts
 var CODEX_HOOK_BINARY = "pushary-codex-hook";
 var codexHome = () => codexHomeFrom(homedir());
 var codexHomeFrom = (home) => process.env.CODEX_HOME?.trim() || join(home, ".codex");
@@ -263,6 +270,7 @@ var geminiMd = () => join2(homedir2(), ".gemini", "GEMINI.md");
 var pusharyConfigFile = () => join2(homedir2(), ".pushary", "config.json");
 
 export {
+  canonicalJson,
   CODEX_HOOK_BINARY,
   codexHome,
   codexHomeFrom,

package/dist/{chunk-MHBC2XUP.js → chunk-VP7SDXYG.js}

@@ -1,6 +1,6 @@
 import {
   getMachineId
-} from "./chunk-RN3NOEJF.js";
+} from "./chunk-2HYPZLYY.js";
 import {
   getPackageVersion
 } from "./chunk-DINDL2CF.js";

package/dist/{chunk-B7JE4XHD.js → chunk-WQGMUIDW.js}

@@ -1,6 +1,6 @@
 import {
   readConfigFileKey
-} from "./chunk-LALHWDWL.js";
+} from "./chunk-L3YUHEB6.js";
 
 // src/bell/fleet.ts
 import { closeSync, constants, futimesSync, lstatSync, mkdirSync, openSync, readdirSync, unlinkSync } from "fs";