@jinn-network/client 0.1.9 → 0.2.0

package/dist/daemon/loop-heartbeat.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Loop heartbeat helper (#1043, follow-up to the #1038 wedge).
+ *
+ * Each long-running daemon loop records a standardized "last tick" heartbeat at
+ * the end of every iteration. The watchdog (watchdog-loop.ts) reads these rows
+ * to detect a loop whose last tick has gone stale (frozen mid-iteration / RPC
+ * wedge). The heartbeat is a NEW namespaced config row written ALONGSIDE the
+ * pre-existing `last_*_tick_at` rows (which other surfaces — e.g.
+ * gather-status.ts — already read); nothing here renames or replaces those.
+ *
+ * The stored value is `Date.now()` (wall-clock ms) as a string, so the watchdog
+ * can compute staleness with a single subtraction and no Date parsing.
+ */
+import type { Store } from '../store/store.js';
+/** Config-key namespace for per-loop heartbeats. */
+export declare const LOOP_HEARTBEAT_PREFIX = "loop_heartbeat:";
+/**
+ * The nine canonical long-running loops the watchdog supervises, with their
+ * default poll intervals and (for the for-await polling loops) a staleness
+ * floor. The two for-await adapter loops (engine-watcher, delivery-watcher)
+ * heartbeat at the poll-cycle tail inside the mech adapter so an
+ * idle-but-polling loop never looks stale. Checkpointing remains in
+ * FleetStateStore; eviction-check and harvest use this observability Store.
+ *
+ * This registry is the single source of truth: LOOP_NAMES, the LoopName union,
+ * and the daemon's watchdog registrations are all derived from it. Order is
+ * load-bearing (LOOP_NAMES preserves it).
+ */
+export declare const LOOP_REGISTRY: readonly [{
+    readonly name: "creator";
+    readonly intervalMs: 5000;
+}, {
+    readonly name: "engine-tick";
+    readonly intervalMs: 5000;
+}, {
+    readonly name: "engine-watcher";
+    readonly intervalMs: 5000;
+    readonly floorMs: number;
+}, {
+    readonly name: "delivery-watcher";
+    readonly intervalMs: 5000;
+    readonly floorMs: number;
+}, {
+    readonly name: "reward-claim";
+    readonly intervalMs: 5000;
+}, {
+    readonly name: "balance-topup";
+    readonly intervalMs: 5000;
+}, {
+    readonly name: "eviction-check";
+    readonly intervalMs: 60000;
+}, {
+    readonly name: "harvest";
+    readonly intervalMs: number;
+}, {
+    readonly name: "peer-sync";
+    readonly intervalMs: 60000;
+}];
+export declare const LOOP_NAMES: ("creator" | "harvest" | "engine-tick" | "engine-watcher" | "delivery-watcher" | "reward-claim" | "balance-topup" | "eviction-check" | "peer-sync")[];
+export type LoopName = (typeof LOOP_REGISTRY)[number]['name'];
+/** The config-row key for a given loop's heartbeat. */
+export declare function loopHeartbeatKey(name: LoopName): string;
+/** Stamp the loop's heartbeat with the current wall-clock ms. */
+export declare function recordLoopTick(store: Store, name: LoopName): void;
+/**
+ * Read a loop's last heartbeat as wall-clock ms, or `null` if it has never
+ * ticked or the stored value is not a finite number.
+ */
+export declare function getLoopTick(store: Store, name: LoopName): number | null;
+/**
+ * Shared tick/heartbeat/error/stop skeleton for the supervised while+sleep
+ * loops (#1578). Reproduces the per-loop body that each loop previously
+ * inlined: run tick, route any throw (custom onError or a default
+ * `tick_error`/`failed` event), run afterTick, stamp the heartbeat, then sleep
+ * — plain or raced against a stopPromise.
+ *
+ * The two for-await polling loops (engine-watcher, delivery-watcher) are NOT
+ * routed through here: their heartbeat is stamped inside the mech adapter so an
+ * idle-but-polling loop stays fresh. They only carry a LOOP_REGISTRY entry.
+ *
+ * The `intervalMs <= 0` disable guard is intentionally NOT here — it stays in
+ * each caller's run() (reward-claim / balance-topup).
+ */
+export interface RunLoopOptions {
+    name: LoopName;
+    store: Store;
+    tick: () => Promise<void>;
+    intervalMs: number | (() => number);
+    stopSignal: () => boolean;
+    stopPromise?: Promise<void>;
+    onError?: (err: unknown) => void;
+    emitSource: string;
+    afterTick?: () => void;
+}
+export declare function runLoop(opts: RunLoopOptions): Promise<void>;

package/dist/daemon/loop-heartbeat.js

@@ -0,0 +1,80 @@
+import { emitEvent } from '../observability/emit-event.js';
+/** Config-key namespace for per-loop heartbeats. */
+export const LOOP_HEARTBEAT_PREFIX = 'loop_heartbeat:';
+/**
+ * The nine canonical long-running loops the watchdog supervises, with their
+ * default poll intervals and (for the for-await polling loops) a staleness
+ * floor. The two for-await adapter loops (engine-watcher, delivery-watcher)
+ * heartbeat at the poll-cycle tail inside the mech adapter so an
+ * idle-but-polling loop never looks stale. Checkpointing remains in
+ * FleetStateStore; eviction-check and harvest use this observability Store.
+ *
+ * This registry is the single source of truth: LOOP_NAMES, the LoopName union,
+ * and the daemon's watchdog registrations are all derived from it. Order is
+ * load-bearing (LOOP_NAMES preserves it).
+ */
+export const LOOP_REGISTRY = [
+    { name: 'creator', intervalMs: 5000 },
+    { name: 'engine-tick', intervalMs: 5000 },
+    { name: 'engine-watcher', intervalMs: 5000, floorMs: 5 * 60_000 },
+    { name: 'delivery-watcher', intervalMs: 5000, floorMs: 5 * 60_000 },
+    { name: 'reward-claim', intervalMs: 5000 },
+    { name: 'balance-topup', intervalMs: 5000 },
+    { name: 'eviction-check', intervalMs: 60_000 },
+    // Commit-echo harvest loop (task-creator v0). Interval mirrors the config
+    // default (config.ts `harvest.intervalMs`); the daemon only registers it
+    // with the watchdog when config.harvest is enabled with repos.
+    { name: 'harvest', intervalMs: 60 * 60 * 1000 },
+    { name: 'peer-sync', intervalMs: 60_000 },
+];
+export const LOOP_NAMES = LOOP_REGISTRY.map(r => r.name);
+/** The config-row key for a given loop's heartbeat. */
+export function loopHeartbeatKey(name) {
+    return `${LOOP_HEARTBEAT_PREFIX}${name}`;
+}
+/** Stamp the loop's heartbeat with the current wall-clock ms. */
+export function recordLoopTick(store, name) {
+    store.setConfigValue(loopHeartbeatKey(name), Date.now().toString());
+}
+/**
+ * Read a loop's last heartbeat as wall-clock ms, or `null` if it has never
+ * ticked or the stored value is not a finite number.
+ */
+export function getLoopTick(store, name) {
+    const raw = store.getConfigValue(loopHeartbeatKey(name));
+    if (raw === null)
+        return null;
+    const ms = Number(raw);
+    return Number.isFinite(ms) ? ms : null;
+}
+export async function runLoop(opts) {
+    while (!opts.stopSignal()) {
+        try {
+            await opts.tick();
+        }
+        catch (err) {
+            if (opts.onError) {
+                opts.onError(err);
+            }
+            else {
+                emitEvent(opts.store, {
+                    kind: 'tick_error',
+                    outcome: 'failed',
+                    detail: err instanceof Error ? err.message : String(err),
+                }, opts.emitSource);
+            }
+        }
+        opts.afterTick?.();
+        recordLoopTick(opts.store, opts.name);
+        if (opts.stopSignal())
+            break;
+        const delay = typeof opts.intervalMs === 'function' ? opts.intervalMs() : opts.intervalMs;
+        if (opts.stopPromise) {
+            await Promise.race([new Promise(r => setTimeout(r, delay)), opts.stopPromise]);
+        }
+        else {
+            await new Promise(r => setTimeout(r, delay));
+        }
+    }
+}
+//# sourceMappingURL=loop-heartbeat.js.map

package/dist/daemon/loop-heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-heartbeat.js","sourceRoot":"","sources":["../../src/daemon/loop-heartbeat.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,oDAAoD;AACpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,iBAAiB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE;IACrC,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE;IACzC,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE;IACjE,EAAE,IAAI,EAAE,kBAAkB,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,GAAG,MAAM,EAAE;IACnE,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE;IAC1C,EAAE,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,IAAI,EAAE;IAC3C,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAE;IAC9C,0EAA0E;IAC1E,yEAAyE;IACzE,+DAA+D;IAC/D,EAAE,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE;IAC/C,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE;CACjC,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAIzD,uDAAuD;AACvD,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC7C,OAAO,GAAG,qBAAqB,GAAG,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,KAAY,EAAE,IAAc;IACzD,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,IAAc;IACtD,MAAM,GAAG,GAAG,KAAK,CAAC,cAAc,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AA4BD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBACjB,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE;oBACpB,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,QAAQ;oBACjB,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACzD,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QACD,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC;QACnB,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,IAAI,CAAC,UAAU,EAAE;YAAE,MAAM;QAC7B,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,UAAU,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAC1F,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC;QACjF,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/{api/peers.js → daemon/peer-sync.js}

@@ -6,6 +6,7 @@
  */
 import { createHash } from 'node:crypto';
 import { signRequestWithErc8128, } from '../auth/erc8128.js';
+import { recordLoopTick } from './loop-heartbeat.js';
 export class PeerSync {
     stopped = false;
     peers;
@@ -37,6 +38,7 @@ export class PeerSync {
             if (count > 0) {
                 console.log(`[peers] Synced ${count} remote artifacts`);
             }
+            recordLoopTick(this.store, 'peer-sync'); // #1043 loop watchdog
             await new Promise(r => setTimeout(r, this.syncIntervalMs));
         }
     }
@@ -106,4 +108,4 @@ export class PeerSync {
         return data.content;
     }
 }
-//# sourceMappingURL=peers.js.map
+//# sourceMappingURL=peer-sync.js.map

package/dist/daemon/peer-sync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"peer-sync.js","sourceRoot":"","sources":["../../src/daemon/peer-sync.ts"],"names":[],"mappings":"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"}

package/dist/daemon/reward-claim-loop.js

@@ -9,6 +9,7 @@
 import { listStolasClaimTargets, tickStolasDistributorClaims, } from '../earning/stolas-claim.js';
 import { emitEvent } from '../observability/emit-event.js';
 import { displayFleetServiceIndex } from '../earning/fleet-display-index.js';
+import { runLoop } from './loop-heartbeat.js';
 export async function runRewardClaimOnce(cfg) {
     const state = await cfg.store.load(cfg.chain);
     const targets = listStolasClaimTargets(state.services);
@@ -70,21 +71,38 @@ export class RewardClaimLoop {
         if (this.config.intervalMs <= 0) {
             return;
         }
-        while (!this.stopped) {
-            try {
-                await this.runOnce();
+        const jinnStore = this.config.jinnStore;
+        if (!jinnStore) {
+            // Without a Store there is no heartbeat surface; keep the minimal inline
+            // loop so runLoop's always-stamp behavior can't fire without a store.
+            while (!this.stopped) {
+                try {
+                    await this.runOnce();
+                }
+                catch (err) {
+                    console.debug('[reward-claim] Tick failed (non-fatal):', err instanceof Error ? err.message : err);
+                }
+                await new Promise(r => setTimeout(r, this.config.intervalMs));
             }
-            catch (err) {
-                console.error('[reward-claim] Tick failed (non-fatal):', err instanceof Error ? err.message : err);
-                this.config.jinnStore && emitEvent(this.config.jinnStore, {
+            return;
+        }
+        await runLoop({
+            name: 'reward-claim',
+            store: jinnStore,
+            tick: () => this.runOnce(),
+            intervalMs: this.config.intervalMs,
+            stopSignal: () => this.stopped,
+            emitSource: 'reward-claim',
+            onError: (err) => {
+                console.debug('[reward-claim] Tick failed (non-fatal):', err instanceof Error ? err.message : err);
+                emitEvent(jinnStore, {
                     kind: 'tick_error',
                     outcome: 'failed',
                     detail: err instanceof Error ? err.message : String(err),
                 }, 'reward-claim');
-            }
-            this.config.jinnStore?.setConfigValue('last_reward_claim_tick_at', new Date().toISOString());
-            await new Promise(r => setTimeout(r, this.config.intervalMs));
-        }
+            },
+            afterTick: () => jinnStore.setConfigValue('last_reward_claim_tick_at', new Date().toISOString()),
+        });
     }
 }
 //# sourceMappingURL=reward-claim-loop.js.map

package/dist/daemon/reward-claim-loop.js.map

@@ -1 +1 @@
-{"version":3,"file":"reward-claim-loop.js","sourceRoot":"","sources":["../../src/daemon/reward-claim-loop.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reward-claim-loop.js","sourceRoot":"","sources":["../../src/daemon/reward-claim-loop.ts"],"names":[],"mappings":"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"}

package/dist/daemon/skip-log-dedup.d.ts

@@ -49,7 +49,7 @@ export declare class SkipLogDeduper {
      *
      * `now` is injectable for deterministic tests; defaults to `Date.now()`.
      */
-    recordSkip(taskId: string, reason: string, now?: number): void;
+    recordSkip(taskId: string, reason: string, now?: number): boolean;
     /**
      * Returns true when this `(taskId, reason)` pair has not been logged yet
      * (or the previous reason for this `taskId` was different). Returns false

package/dist/daemon/skip-log-dedup.js

@@ -58,6 +58,8 @@ export class SkipLogDeduper {
      * `now` is injectable for deterministic tests; defaults to `Date.now()`.
      */
     recordSkip(taskId, reason, now = Date.now()) {
+        const previous = this.entriesByTaskId.get(taskId);
+        const shouldLog = previous?.reason !== reason;
         // Delete-then-set so the entry moves to the end of insertion order, keeping
         // actively-skipped tasks away from the FIFO eviction front.
         this.entriesByTaskId.delete(taskId);
@@ -69,6 +71,7 @@ export class SkipLogDeduper {
                 this.entriesByTaskId.delete(oldestKey);
             }
         }
+        return shouldLog;
     }
     /**
      * Returns true when this `(taskId, reason)` pair has not been logged yet

package/dist/daemon/skip-log-dedup.js.map

@@ -1 +1 @@
-{"version":3,"file":"skip-log-dedup.js","sourceRoot":"","sources":["../../src/daemon/skip-log-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAS1C,MAAM,OAAO,cAAc;IACjB,eAAe,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtC,UAAU,CAAS;IACnB,YAAY,CAAS;IAEtC,YAAY,UAAU,GAAG,IAAI,EAAE,YAAY,GAAG,mBAAmB;QAC/D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,MAAc,EAAE,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACjE,4EAA4E;QAC5E,4DAA4D;QAC5D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,4DAA4D;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC3D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAc,EAAE,MAAc;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YAChC,uEAAuE;YACvE,0EAA0E;YAC1E,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,mEAAmE;QACnE,0EAA0E;QAC1E,0BAA0B;QAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"skip-log-dedup.js","sourceRoot":"","sources":["../../src/daemon/skip-log-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAS1C,MAAM,OAAO,cAAc;IACjB,eAAe,GAAG,IAAI,GAAG,EAAqB,CAAC;IACtC,UAAU,CAAS;IACnB,YAAY,CAAS;IAEtC,YAAY,UAAU,GAAG,IAAI,EAAE,YAAY,GAAG,mBAAmB;QAC/D,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;IAChD,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,CAAC;IACpD,CAAC;IAED;;;;;;OAMG;IACH,UAAU,CAAC,MAAc,EAAE,MAAc,EAAE,MAAc,IAAI,CAAC,GAAG,EAAE;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;QAC9C,4EAA4E;QAC5E,4DAA4D;QAC5D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,eAAe,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAChD,4DAA4D;YAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YAC3D,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;gBAC5B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAC,MAAc,EAAE,MAAc;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,IAAI,QAAQ,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;YAChC,uEAAuE;YACvE,0EAA0E;YAC1E,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YAC3C,OAAO,KAAK,CAAC;QACf,CAAC;QACD,mEAAmE;QACnE,0EAA0E;QAC1E,0BAA0B;QAC1B,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAc;QACnB,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACtC,CAAC;CACF"}

package/dist/daemon/spend-cap-gate.d.ts

@@ -5,12 +5,6 @@
  * See docs/superpowers/specs/2026-05-21-per-credential-spend-budget-design.md.
  */
 import type { GateLogger } from './gate-logger.js';
-/**
- * Whether today's spend has reached or exceeded the cap. The single source of
- * the cap predicate — shared by the gate and the `/v1/status` spend block so
- * the two surfaces cannot disagree.
- */
-export declare function isOverSpendCap(spentTodayUsd: number, capUsd: number): boolean;
 /**
  * Decide whether a claim may proceed for a credential given today's spend.
  * Mirrors `gateClaimByReadiness`. `newlyPaused` is true only on the first skip

package/dist/daemon/spend-cap-gate.js

@@ -1,13 +1,6 @@
+import { isOverSpendCap } from '../spend/spend-cap.js';
 /** Per-credential paused state, so the warn/info logs fire once per transition. */
 const lastPausedByCredential = new Map();
-/**
- * Whether today's spend has reached or exceeded the cap. The single source of
- * the cap predicate — shared by the gate and the `/v1/status` spend block so
- * the two surfaces cannot disagree.
- */
-export function isOverSpendCap(spentTodayUsd, capUsd) {
-    return spentTodayUsd >= capUsd;
-}
 /**
  * Decide whether a claim may proceed for a credential given today's spend.
  * Mirrors `gateClaimByReadiness`. `newlyPaused` is true only on the first skip

package/dist/daemon/spend-cap-gate.js.map

@@ -1 +1 @@
-{"version":3,"file":"spend-cap-gate.js","sourceRoot":"","sources":["../../src/daemon/spend-cap-gate.ts"],"names":[],"mappings":"AAQA,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,aAAqB,EAAE,MAAc;IAClE,OAAO,aAAa,IAAI,MAAM,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAEzE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,mCAAmC,CAAC,CAAC;QACxF,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GACV,+BAA+B,IAAI,CAAC,YAAY,GAAG;QACnD,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B;IAC5C,sBAAsB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}
+{"version":3,"file":"spend-cap-gate.js","sourceRoot":"","sources":["../../src/daemon/spend-cap-gate.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,mFAAmF;AACnF,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAmB,CAAC;AAE1D;;;;GAIG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAKnC;IACC,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,SAAS,GAAG,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,KAAK,CAAC;IAEzE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,mCAAmC,CAAC,CAAC;QACxF,CAAC;QACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GACV,+BAA+B,IAAI,CAAC,YAAY,GAAG;QACnD,KAAK,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IACrE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,MAAM,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACpD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;AAC7D,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,8BAA8B;IAC5C,sBAAsB,CAAC,KAAK,EAAE,CAAC;AACjC,CAAC"}

package/dist/daemon/watchdog-loop.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Loop watchdog supervisor (#1043, follow-up to the #1038 4.5h RPC wedge).
+ *
+ * A synchronous, network-free loop. On each tick it reads every registered
+ * loop's heartbeat (loop-heartbeat.ts → getLoopTick) and compares its age
+ * against a per-loop threshold. When a loop is stale it ALWAYS loud-logs and
+ * emits a structured `loop_watchdog_stale` event; the process-exit recovery is
+ * separately gated behind `autoRestart` (default OFF — the locked Option A
+ * decision). v1 therefore always *detects + surfaces*; the non-zero exit is
+ * opt-in.
+ *
+ * IDEMPOTENCY (AC#3, the anchor for "designed, not assumed"): the only
+ * recovery action is a non-zero `process.exit`. There is NO new mid-flight
+ * re-execution path inside any loop. Recovery flows entirely through the
+ * EXISTING idempotent boot path:
+ *
+ *   process.exit(WATCHDOG_EXIT_CODE)
+ *     → Railway restartPolicyType="ON_FAILURE", maxRetries=10
+ *       (deploy/railway-*-operator/railway.toml)
+ *     → fresh process boots, recoverInFlight() re-drives in-flight tasks
+ *       (TaskEngine.recoverInFlight) and the stale-pidfile path clears a dead
+ *       lock (src/preflight/pidfile-liveness.ts) — both already idempotent.
+ *
+ * So restarting a wedged daemon cannot double-claim, double-deliver, or
+ * double-pay: it re-enters the same boot reconciliation a crash would.
+ */
+import type { Store } from '../store/store.js';
+import { type LoopName } from './loop-heartbeat.js';
+/**
+ * Non-zero exit code the watchdog uses for its auto-restart. Distinct from
+ * main.ts's graceful `process.exit(0)` so Railway's ON_FAILURE policy treats a
+ * watchdog restart as a failure (and a clean operator-requested stop as not).
+ */
+export declare const WATCHDOG_EXIT_CODE = 13;
+export interface WatchdogLoopRegistration {
+    /** Loop heartbeat name. */
+    name: LoopName;
+    /** The loop's nominal iteration interval (ms). */
+    intervalMs: number;
+    /**
+     * Optional floor (ms) for the staleness threshold. The for-await adapter
+     * loops set this generously (~5 min) because a single RPC wedge can stall a
+     * poll far longer than `stalenessFactor * pollIntervalMs`.
+     */
+    floorMs?: number;
+}
+export interface WatchdogLoopConfig {
+    store: Store;
+    loops: WatchdogLoopRegistration[];
+    /** Stale when age > stalenessFactor * intervalMs (floored by floorMs). */
+    stalenessFactor?: number;
+    /** How often the watchdog itself ticks (ms). */
+    checkIntervalMs?: number;
+    /** When true, a stale loop triggers onStale (the process-exit recovery). */
+    autoRestart?: boolean;
+    /**
+     * Recovery action invoked once per stale episode when autoRestart is on.
+     * Optional — defaults to the production process-exit handler. Tests inject a
+     * spy. Kept off DaemonConfig so the config surface stays free of functions.
+     */
+    onStale?: (name: string) => void;
+    /** Gate: the watchdog only checks while this returns true (running, not draining). */
+    isActive: () => boolean;
+    /** Clock seam for tests. Defaults to Date.now. */
+    now?: () => number;
+}
+export declare class WatchdogLoop {
+    private readonly config;
+    private stopped;
+    private stopResolve?;
+    private readonly stopPromise;
+    private readonly stalenessFactor;
+    private readonly checkIntervalMs;
+    private readonly autoRestart;
+    private readonly onStale;
+    private readonly now;
+    /** Loops currently in a reported-stale episode (fire-once gate). */
+    private readonly reportedStale;
+    constructor(config: WatchdogLoopConfig);
+    run(): Promise<void>;
+    stop(): void;
+    /** One supervision pass. Synchronous + network-free. */
+    check(): void;
+}

package/dist/daemon/watchdog-loop.js

@@ -0,0 +1,91 @@
+import { getLoopTick } from './loop-heartbeat.js';
+import { emitStructured } from '../events/emitter.js';
+/**
+ * Non-zero exit code the watchdog uses for its auto-restart. Distinct from
+ * main.ts's graceful `process.exit(0)` so Railway's ON_FAILURE policy treats a
+ * watchdog restart as a failure (and a clean operator-requested stop as not).
+ */
+export const WATCHDOG_EXIT_CODE = 13;
+/** Default recovery: loud-log then non-zero exit (Railway restarts us). */
+function defaultOnStale(name) {
+    console.error(`[watchdog] auto-restarting via non-zero exit (loop=${name}, code=${WATCHDOG_EXIT_CODE})`);
+    process.exit(WATCHDOG_EXIT_CODE);
+}
+export class WatchdogLoop {
+    config;
+    stopped = false;
+    stopResolve;
+    stopPromise;
+    stalenessFactor;
+    checkIntervalMs;
+    autoRestart;
+    onStale;
+    now;
+    /** Loops currently in a reported-stale episode (fire-once gate). */
+    reportedStale = new Set();
+    constructor(config) {
+        this.config = config;
+        this.stalenessFactor = config.stalenessFactor ?? 6;
+        this.checkIntervalMs = config.checkIntervalMs ?? 30_000;
+        this.autoRestart = config.autoRestart ?? false;
+        this.onStale = config.onStale ?? defaultOnStale;
+        this.now = config.now ?? (() => Date.now());
+        this.stopPromise = new Promise((resolve) => {
+            this.stopResolve = resolve;
+        });
+    }
+    async run() {
+        while (!this.stopped) {
+            if (this.config.isActive()) {
+                this.check();
+            }
+            await Promise.race([
+                new Promise((r) => setTimeout(r, this.checkIntervalMs)),
+                this.stopPromise,
+            ]);
+        }
+    }
+    stop() {
+        this.stopped = true;
+        this.stopResolve?.();
+    }
+    /** One supervision pass. Synchronous + network-free. */
+    check() {
+        const now = this.now();
+        for (const reg of this.config.loops) {
+            const last = getLoopTick(this.config.store, reg.name);
+            if (last === null)
+                continue; // never ticked — nothing to judge yet
+            const threshold = Math.max(this.stalenessFactor * reg.intervalMs, reg.floorMs ?? 0);
+            const ageMs = now - last;
+            if (ageMs > threshold) {
+                // Fire-once per episode: skip if already reported and not yet recovered.
+                if (this.reportedStale.has(reg.name))
+                    continue;
+                this.reportedStale.add(reg.name);
+                const message = `[watchdog] loop '${reg.name}' is stale: last tick ${ageMs}ms ago ` +
+                    `(threshold ${threshold}ms)`;
+                console.error(message);
+                emitStructured({
+                    kind: 'error',
+                    message,
+                    errorCode: 'loop_watchdog_stale',
+                    details: {
+                        loopName: reg.name,
+                        lastTickAt: last,
+                        ageMs,
+                        thresholdMs: threshold,
+                    },
+                });
+                if (this.autoRestart) {
+                    this.onStale(reg.name);
+                }
+            }
+            else {
+                // Heartbeat advanced back under threshold → re-arm for next episode.
+                this.reportedStale.delete(reg.name);
+            }
+        }
+    }
+}
+//# sourceMappingURL=watchdog-loop.js.map

package/dist/daemon/watchdog-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watchdog-loop.js","sourceRoot":"","sources":["../../src/daemon/watchdog-loop.ts"],"names":[],"mappings":"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"}