@prismer/runtime 1.9.1 → 1.9.6

package/dist/heartbeat-loop-H2LAI3V5.mjs

@@ -1,95 +0,0 @@
-import {
-  loadPublishedRegistry
-} from "./chunk-POWV475F.mjs";
-import "./chunk-BJTO5JO5.mjs";
-
-// src/agents/heartbeat-loop.ts
-function startHeartbeatLoop(opts) {
-  const intervalMs = opts.intervalMs ?? 3e4;
-  const offlineProtectMs = opts.offlineProtectMs ?? 5 * 6e4;
-  const fetchImpl = opts.fetchImpl ?? fetch;
-  const statusFor = opts.statusFor ?? (() => "online");
-  let running = true;
-  let consecutiveFailures = 0;
-  let lastSuccessAt = 0;
-  let timer = null;
-  async function tick() {
-    if (!running) return;
-    let agents;
-    try {
-      agents = loadPublishedRegistry(opts.registryFile);
-    } catch (err) {
-      console.error("[heartbeat] failed to load registry:", err.message);
-      return;
-    }
-    if (agents.length === 0) return;
-    const body = {
-      daemonId: opts.daemonId,
-      agents: agents.map((a) => ({
-        cloudAgentId: a.cloudAgentId,
-        status: statusFor(a)
-      }))
-    };
-    try {
-      const resp = await fetchImpl(`${opts.cloudApiBase}/api/im/me/agents/heartbeat`, {
-        method: "POST",
-        headers: {
-          "Content-Type": "application/json",
-          Authorization: `Bearer ${opts.apiKey}`
-        },
-        body: JSON.stringify(body)
-      });
-      if (!resp.ok) {
-        consecutiveFailures++;
-        let text = "";
-        try {
-          text = (await resp.text()).slice(0, 200);
-        } catch {
-        }
-        if (consecutiveFailures % 10 === 1) {
-          console.warn(`[heartbeat] tick failed ${consecutiveFailures}\xD7 (HTTP ${resp.status}): ${text}`);
-        }
-        if (consecutiveFailures * intervalMs > offlineProtectMs) {
-        }
-        return;
-      }
-      consecutiveFailures = 0;
-      lastSuccessAt = Date.now();
-    } catch (err) {
-      consecutiveFailures++;
-      if (consecutiveFailures % 10 === 1) {
-        console.warn("[heartbeat] tick failed (network):", err.message);
-      }
-    }
-  }
-  function schedule() {
-    if (!running) return;
-    timer = setTimeout(async () => {
-      await tick();
-      schedule();
-    }, intervalMs);
-    if (timer && typeof timer.unref === "function") {
-      timer.unref();
-    }
-  }
-  if (opts.fireImmediately !== false) {
-    void tick();
-  }
-  schedule();
-  return {
-    stop() {
-      running = false;
-      if (timer) {
-        clearTimeout(timer);
-        timer = null;
-      }
-    },
-    consecutiveFailures: () => consecutiveFailures,
-    lastSuccessAt: () => lastSuccessAt,
-    tick
-  };
-}
-export {
-  startHeartbeatLoop
-};
-//# sourceMappingURL=heartbeat-loop-H2LAI3V5.mjs.map

package/dist/heartbeat-loop-H2LAI3V5.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/agents/heartbeat-loop.ts"],"sourcesContent":["/**\n * Prismer Runtime — Background heartbeat loop (Sprint A2.3, D3 liveness).\n *\n * For every agent in `~/.prismer/published-agents.toml`, send a single\n * bulk heartbeat to cloud every `intervalMs` (default 30s). Cloud's\n * sweep job marks agents offline after `heartbeatTimeoutMs` (default 90s)\n * of silence — so 3 missed beats == offline.\n *\n * Design notes:\n *\n *   • Bulk in one HTTP call per tick so 5 agents = 1 request, not 5.\n *   • Best-effort: a 4xx/5xx or network error is logged but never throws\n *     up the call stack — the loop just retries on the next tick. The\n *     daemon itself stays alive even if cloud is unreachable.\n *   • Local \"offline protection\": if cloud has been unreachable for\n *     more than `offlineProtectMs`, we keep the daemon's local view\n *     of the world (don't surface the cloud-side `offline` to local\n *     consumers). This is policy that the supervisor can read via\n *     `consecutiveFailures`.\n *   • Stop is cooperative — the loop checks `running` between ticks.\n */\n\nimport {\n  loadPublishedRegistry,\n  type PublishedAgent,\n} from './published-registry.js';\n\nexport interface HeartbeatLoopOptions {\n  apiKey: string;\n  daemonId: string;\n  cloudApiBase: string;\n  /** Tick interval in ms. Default 30_000. */\n  intervalMs?: number;\n  /** ms after which we treat the cloud as durably unreachable. Default 5*60_000. */\n  offlineProtectMs?: number;\n  /** Override fetch (tests). */\n  fetchImpl?: typeof fetch;\n  /** Override registry path (tests). */\n  registryFile?: string;\n  /** Status reporter — defaults to \"online\" for everything. Override to surface\n   *  per-agent crashes from the supervisor. */\n  statusFor?: (agent: PublishedAgent) => 'online' | 'busy' | 'idle' | 'crashed';\n  /** Fire the first tick synchronously on start. Default true (production:\n   *  don't make the user wait `intervalMs` to see initial liveness). Tests\n   *  set this to false so they can drive ticks deterministically. */\n  fireImmediately?: boolean;\n}\n\nexport interface HeartbeatLoopHandle {\n  stop(): void;\n  /** Number of consecutive ticks where the cloud round-trip failed. */\n  consecutiveFailures(): number;\n  /** Last successful tick timestamp (ms epoch), or 0 if never. */\n  lastSuccessAt(): number;\n  /** Trigger one tick immediately (test helper / manual flush). */\n  tick(): Promise<void>;\n}\n\ninterface HeartbeatRequest {\n  cloudAgentId: string;\n  status: 'online' | 'busy' | 'idle' | 'crashed';\n  load?: number;\n}\n\nexport function startHeartbeatLoop(opts: HeartbeatLoopOptions): HeartbeatLoopHandle {\n  const intervalMs = opts.intervalMs ?? 30_000;\n  const offlineProtectMs = opts.offlineProtectMs ?? 5 * 60_000;\n  const fetchImpl = opts.fetchImpl ?? fetch;\n  const statusFor = opts.statusFor ?? (() => 'online' as const);\n\n  let running = true;\n  let consecutiveFailures = 0;\n  let lastSuccessAt = 0;\n  let timer: ReturnType<typeof setTimeout> | null = null;\n\n  async function tick(): Promise<void> {\n    if (!running) return;\n\n    let agents: PublishedAgent[];\n    try {\n      agents = loadPublishedRegistry(opts.registryFile);\n    } catch (err) {\n      // Registry corruption shouldn't take the daemon down.\n      console.error('[heartbeat] failed to load registry:', (err as Error).message);\n      return;\n    }\n\n    if (agents.length === 0) return;\n\n    const body: { daemonId: string; agents: HeartbeatRequest[] } = {\n      daemonId: opts.daemonId,\n      agents: agents.map((a) => ({\n        cloudAgentId: a.cloudAgentId,\n        status: statusFor(a),\n      })),\n    };\n\n    try {\n      const resp = await fetchImpl(`${opts.cloudApiBase}/api/im/me/agents/heartbeat`, {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          Authorization: `Bearer ${opts.apiKey}`,\n        },\n        body: JSON.stringify(body),\n      });\n      if (!resp.ok) {\n        consecutiveFailures++;\n        // Read the body for the log but do not let parse errors propagate.\n        let text = '';\n        try {\n          text = (await resp.text()).slice(0, 200);\n        } catch {\n          /* ignore */\n        }\n        if (consecutiveFailures % 10 === 1) {\n          // Log every 1st, 11th, 21st failure to avoid log spam during\n          // sustained outages while still surfacing the issue.\n          console.warn(`[heartbeat] tick failed ${consecutiveFailures}× (HTTP ${resp.status}): ${text}`);\n        }\n        if (consecutiveFailures * intervalMs > offlineProtectMs) {\n          // Past the protection window — let the supervisor decide whether\n          // to flip local state. We don't take action ourselves so the\n          // daemon stays useful for LAN-only consumers.\n        }\n        return;\n      }\n      consecutiveFailures = 0;\n      lastSuccessAt = Date.now();\n    } catch (err) {\n      consecutiveFailures++;\n      if (consecutiveFailures % 10 === 1) {\n        console.warn('[heartbeat] tick failed (network):', (err as Error).message);\n      }\n    }\n  }\n\n  function schedule(): void {\n    if (!running) return;\n    timer = setTimeout(async () => {\n      await tick();\n      schedule();\n    }, intervalMs);\n    // Don't keep the event loop alive just for the heartbeat — daemon\n    // stops when its other resources stop.\n    if (timer && typeof (timer as any).unref === 'function') {\n      (timer as any).unref();\n    }\n  }\n\n  if (opts.fireImmediately !== false) {\n    // Fire one tick immediately so we don't wait `intervalMs` on startup.\n    void tick();\n  }\n  schedule();\n\n  return {\n    stop() {\n      running = false;\n      if (timer) {\n        clearTimeout(timer);\n        timer = null;\n      }\n    },\n    consecutiveFailures: () => consecutiveFailures,\n    lastSuccessAt: () => lastSuccessAt,\n    tick,\n  };\n}\n"],"mappings":";;;;;;AAgEO,SAAS,mBAAmB,MAAiD;AAClF,QAAM,aAAa,KAAK,cAAc;AACtC,QAAM,mBAAmB,KAAK,oBAAoB,IAAI;AACtD,QAAM,YAAY,KAAK,aAAa;AACpC,QAAM,YAAY,KAAK,cAAc,MAAM;AAE3C,MAAI,UAAU;AACd,MAAI,sBAAsB;AAC1B,MAAI,gBAAgB;AACpB,MAAI,QAA8C;AAElD,iBAAe,OAAsB;AACnC,QAAI,CAAC,QAAS;AAEd,QAAI;AACJ,QAAI;AACF,eAAS,sBAAsB,KAAK,YAAY;AAAA,IAClD,SAAS,KAAK;AAEZ,cAAQ,MAAM,wCAAyC,IAAc,OAAO;AAC5E;AAAA,IACF;AAEA,QAAI,OAAO,WAAW,EAAG;AAEzB,UAAM,OAAyD;AAAA,MAC7D,UAAU,KAAK;AAAA,MACf,QAAQ,OAAO,IAAI,CAAC,OAAO;AAAA,QACzB,cAAc,EAAE;AAAA,QAChB,QAAQ,UAAU,CAAC;AAAA,MACrB,EAAE;AAAA,IACJ;AAEA,QAAI;AACF,YAAM,OAAO,MAAM,UAAU,GAAG,KAAK,YAAY,+BAA+B;AAAA,QAC9E,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,eAAe,UAAU,KAAK,MAAM;AAAA,QACtC;AAAA,QACA,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AACD,UAAI,CAAC,KAAK,IAAI;AACZ;AAEA,YAAI,OAAO;AACX,YAAI;AACF,kBAAQ,MAAM,KAAK,KAAK,GAAG,MAAM,GAAG,GAAG;AAAA,QACzC,QAAQ;AAAA,QAER;AACA,YAAI,sBAAsB,OAAO,GAAG;AAGlC,kBAAQ,KAAK,2BAA2B,mBAAmB,cAAW,KAAK,MAAM,MAAM,IAAI,EAAE;AAAA,QAC/F;AACA,YAAI,sBAAsB,aAAa,kBAAkB;AAAA,QAIzD;AACA;AAAA,MACF;AACA,4BAAsB;AACtB,sBAAgB,KAAK,IAAI;AAAA,IAC3B,SAAS,KAAK;AACZ;AACA,UAAI,sBAAsB,OAAO,GAAG;AAClC,gBAAQ,KAAK,sCAAuC,IAAc,OAAO;AAAA,MAC3E;AAAA,IACF;AAAA,EACF;AAEA,WAAS,WAAiB;AACxB,QAAI,CAAC,QAAS;AACd,YAAQ,WAAW,YAAY;AAC7B,YAAM,KAAK;AACX,eAAS;AAAA,IACX,GAAG,UAAU;AAGb,QAAI,SAAS,OAAQ,MAAc,UAAU,YAAY;AACvD,MAAC,MAAc,MAAM;AAAA,IACvB;AAAA,EACF;AAEA,MAAI,KAAK,oBAAoB,OAAO;AAElC,SAAK,KAAK;AAAA,EACZ;AACA,WAAS;AAET,SAAO;AAAA,IACL,OAAO;AACL,gBAAU;AACV,UAAI,OAAO;AACT,qBAAa,KAAK;AAClB,gBAAQ;AAAA,MACV;AAAA,IACF;AAAA,IACA,qBAAqB,MAAM;AAAA,IAC3B,eAAe,MAAM;AAAA,IACrB;AAAA,EACF;AACF;","names":[]}