@kynver-app/runtime 0.1.112 → 0.1.117

package/dist/daemon-heartbeat.d.ts

@@ -0,0 +1,20 @@
+export interface DaemonHeartbeat {
+    observedAt: string;
+    pid: number;
+    runId: string;
+    agentOsId: string;
+}
+export declare function daemonHeartbeatPath(agentOsId: string): string;
+/** Best-effort atomic write (temp + rename). Never throws. */
+export declare function writeDaemonHeartbeat(input: {
+    agentOsId: string;
+    runId: string;
+    now?: Date;
+}): void;
+export declare function readDaemonHeartbeat(agentOsId: string): DaemonHeartbeat | null;
+/**
+ * True when the heartbeat indicates a hung daemon. A missing heartbeat is NOT
+ * stale — a freshly spawned child has not written one yet; the keeper grants a
+ * startup grace window instead.
+ */
+export declare function isDaemonHeartbeatStale(beat: DaemonHeartbeat | null, stallMs: number, nowMs?: number): boolean;

package/dist/daemon-keeper.d.ts

@@ -0,0 +1,21 @@
+export declare function resolveKeeperStallMs(flag: string | boolean | undefined, env?: NodeJS.ProcessEnv): number;
+/**
+ * Supervision is the DEFAULT for `kynver daemon`. Opt out only when an
+ * external supervisor (systemd, pm2, container restart policy) already owns
+ * restarts: `--no-supervise`, `--supervised false`, or
+ * `KYNVER_DAEMON_SUPERVISED=0|false|no|off`. The keeper's own child carries
+ * the internal `--keeper-child` flag so it can never recurse into a second
+ * keeper. `--supervised` stays accepted as a no-op for back-compat.
+ */
+export declare function shouldRunDaemonKeeper(args: Record<string, string | boolean>, env?: NodeJS.ProcessEnv): boolean;
+/** Exponential backoff with cap; resets to base after a healthy stretch. */
+export declare function nextKeeperBackoffMs(consecutiveFailures: number, base?: number, cap?: number): number;
+/** True when the child ran long enough to count as healthy (resets backoff). */
+export declare function keeperRunWasHealthy(startedAtMs: number, endedAtMs: number, healthyMs?: number): boolean;
+/**
+ * Rebuild the child argv: original daemon args minus keeper-only flags, plus
+ * the internal `--keeper-child` marker that prevents keeper recursion now
+ * that supervision is the default.
+ */
+export declare function buildKeeperChildArgv(argv: readonly string[]): string[];
+export declare function runDaemonKeeper(args: Record<string, string | boolean>, rawArgv?: readonly string[]): Promise<void>;

package/dist/device-login.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Run the device-authorization login flow. Returns `{ ok, apiKey }`. Prints
+ * progress to the console. Does not exit the process (the caller decides).
+ */
+export declare function runDeviceLogin(args: Record<string, string | boolean>): Promise<{
+    ok: boolean;
+    apiKey?: string;
+}>;