agent-relay 9.2.1 → 9.2.2

package/dist/cli/lib/reflex-capture.js

@@ -0,0 +1,128 @@
+/**
+ * Reflex in-process cloud capture.
+ *
+ * When Reflex is enabled (`agent-relay reflex on`), the long-running
+ * `agent-relay up` host periodically syncs local agent history into the ai-hist
+ * DB and pushes new records to relayhistory-cloud — no launchd/cron, no CLI the
+ * user runs by hand, and **no subprocess**. Mirrors the telemetry client: an
+ * unref'd timer that never blocks the event loop, plus a best-effort final
+ * flush on shutdown.
+ *
+ * The work runs in-process through the `ai-hist-native` napi addon
+ * (`syncAndPush()`), which ships as a per-platform optional-dependency package
+ * so a plain `agent-relay` install works with no extra setup. Everything is a
+ * silent no-op when the addon is unavailable or the user isn't authenticated.
+ */
+import { isReflexEnabled } from '@agent-relay/config';
+const DEFAULT_INTERVAL_MS = 5 * 60_000;
+const DEFAULT_INITIAL_DELAY_MS = 30_000;
+/** Lazily load the `ai-hist-native` napi addon; null when it isn't installed. */
+async function loadNative() {
+    // Non-literal spec keeps the native addon out of the esbuild bundle; it
+    // resolves from node_modules (the per-platform optional dep) at runtime.
+    const spec = 'ai-hist-native';
+    let mod;
+    try {
+        mod = (await import(spec));
+    }
+    catch (err) {
+        // Not installed for this platform → a clean no-op. Anything else (ABI
+        // mismatch, missing system lib, addon init failure) is a real problem —
+        // rethrow so the caller logs it instead of silently doing nothing.
+        const code = err?.code;
+        if (code === 'ERR_MODULE_NOT_FOUND' || code === 'MODULE_NOT_FOUND') {
+            return null;
+        }
+        throw err;
+    }
+    const fn = mod.syncAndPush ?? mod.default?.syncAndPush;
+    return typeof fn === 'function' ? { syncAndPush: fn } : null;
+}
+/**
+ * Sync local agent history into the ai-hist DB and push new records to
+ * relayhistory-cloud, **in-process** via the native addon — no subprocess. This
+ * is what makes `reflex on` "just work": no separate ai-hist install, no CLI.
+ * Resolves null when the addon is unavailable or the user isn't authenticated.
+ */
+export async function reflexSyncAndPush(opts = {}) {
+    const native = opts.native !== undefined ? opts.native : await loadNative();
+    if (!native)
+        return null;
+    const result = await native.syncAndPush();
+    if (!result.authenticated)
+        return null; // not logged in yet
+    return { sent: result.sent, accepted: result.accepted };
+}
+function withDefaults(overrides) {
+    return {
+        isEnabled: isReflexEnabled,
+        push: () => reflexSyncAndPush(),
+        log: (message) => console.error(message),
+        intervalMs: DEFAULT_INTERVAL_MS,
+        initialDelayMs: DEFAULT_INITIAL_DELAY_MS,
+        ...overrides,
+    };
+}
+export function startReflexCapture(overrides = {}) {
+    const deps = withDefaults(overrides);
+    let stopped = false;
+    // Dedup concurrent ticks: a slow push must not overlap the next interval.
+    let inFlight = null;
+    // The recurring interval starts only after the first (delayed) push.
+    let timer = null;
+    const tick = () => {
+        if (inFlight)
+            return inFlight;
+        // Re-check enablement every tick so `agent-relay reflex off` (or `on`)
+        // takes effect immediately in an already-running `agent-relay up`, without
+        // restarting the host.
+        if (!deps.isEnabled())
+            return Promise.resolve();
+        inFlight = (async () => {
+            try {
+                const result = await deps.push();
+                if (result && result.sent > 0) {
+                    deps.log(`[reflex] synced ${result.sent} record(s) to relayhistory-cloud`);
+                }
+            }
+            catch (err) {
+                deps.log(`[reflex] cloud sync failed: ${err instanceof Error ? err.message : String(err)}`);
+            }
+            finally {
+                inFlight = null;
+            }
+        })();
+        return inFlight;
+    };
+    const kickoff = setTimeout(() => {
+        if (stopped)
+            return;
+        void tick();
+        // Start the interval only now, so the first push can never fire before
+        // initialDelayMs regardless of how small intervalMs is.
+        timer = setInterval(() => {
+            if (!stopped)
+                void tick();
+        }, deps.intervalMs);
+        // Don't keep the process alive just for the capture timer.
+        timer.unref?.();
+    }, deps.initialDelayMs);
+    kickoff.unref?.();
+    return {
+        stop: async () => {
+            stopped = true;
+            clearTimeout(kickoff);
+            if (timer)
+                clearInterval(timer);
+            // Let an in-flight push finish, then flush one final batch (a no-op if
+            // Reflex was disabled in the meantime — tick() re-checks).
+            if (inFlight) {
+                await inFlight;
+            }
+            else {
+                await tick();
+            }
+        },
+    };
+}
+//# sourceMappingURL=reflex-capture.js.map

package/dist/cli/lib/reflex-capture.js.map

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