@indigoai-us/hq-cloud 6.15.77 → 6.15.79

package/dist/sync/child-process-sync-worker.test.js

@@ -0,0 +1,262 @@
+import { execFileSync, fork, spawn } from "node:child_process";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { afterEach, beforeAll, describe, expect, it } from "vitest";
+import { DefaultParallelSyncCoordinator } from "./parallel-sync-coordinator.js";
+import { ChildProcessSyncWorkerAdapter } from "./child-process-sync-worker.js";
+import { StateStore } from "./state-store.js";
+import { toWorkerExecuteMessage } from "./sync-worker-port.js";
+const repoRoot = path.resolve(import.meta.dirname, "../..");
+const workerScript = path.join(repoRoot, "dist/bin/sync-runner-worker.js");
+const adapters = [];
+const roots = [];
+beforeAll(() => {
+    execFileSync("pnpm", ["run", "build"], { cwd: repoRoot, stdio: "pipe" });
+}, 120_000);
+afterEach(async () => {
+    await Promise.all(adapters.splice(0).map((adapter) => adapter.shutdown()));
+    for (const root of roots.splice(0))
+        fs.rmSync(root, { recursive: true, force: true });
+});
+function worker(workerClass, env = {}, onProgress, options = {}) {
+    const adapter = new ChildProcessSyncWorkerAdapter({
+        workerClass,
+        workerScript: options.workerScript ?? workerScript,
+        env: { HQ_SYNC_WORKER_TEST_MODE: "1", ...env },
+        maxRestarts: options.maxRestarts,
+        readyTimeoutMs: options.readyTimeoutMs,
+        restartBackoffMs: options.restartBackoffMs ?? 10,
+        shutdownGraceMs: 100,
+        onProgress,
+    });
+    adapters.push(adapter);
+    return adapter;
+}
+function slice(id, pathName = `notes/${id}`) {
+    return {
+        id,
+        signal: new AbortController().signal,
+        work: { class: "realtime", source: "watcher", direction: "push", paths: [pathName], causality: `cause-${id}` },
+        paths: [{ canonicalPath: pathName, targetUid: "target-personal", areaId: "root:notes", epoch: Number(id.replace(/\D/g, "")) || 1 }],
+    };
+}
+function temporaryRoot() {
+    const root = fs.mkdtempSync(path.join(os.tmpdir(), "hq-child-worker-"));
+    roots.push(root);
+    return root;
+}
+function waitFor(predicate, timeoutMs = 2_000) {
+    const deadline = Date.now() + timeoutMs;
+    return new Promise((resolve, reject) => {
+        const tick = () => {
+            if (predicate())
+                return resolve();
+            if (Date.now() >= deadline)
+                return reject(new Error("timed out waiting for child process state"));
+            setTimeout(tick, 10);
+        };
+        tick();
+    });
+}
+function isAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function forkWorker() {
+    return fork(workerScript, [], { env: { ...process.env, HQ_SYNC_WORKER_TEST_MODE: "1" }, stdio: ["ignore", "ignore", "ignore", "ipc"] });
+}
+function workerFixture(source) {
+    const script = path.join(temporaryRoot(), "fixture.cjs");
+    fs.writeFileSync(script, source);
+    return script;
+}
+function waitForReady(child) {
+    return new Promise((resolve, reject) => {
+        child.once("error", reject);
+        child.on("message", (message) => {
+            if (typeof message === "object" && message !== null && message.type === "ready") {
+                resolve(message);
+            }
+        });
+    });
+}
+function waitForOutcome(child, requestId) {
+    return new Promise((resolve, reject) => {
+        const onMessage = (message) => {
+            if (typeof message !== "object" || message === null)
+                return;
+            const value = message;
+            if (value.type !== "outcome" || value.requestId !== requestId || value.outcome === undefined)
+                return;
+            child.removeListener("message", onMessage);
+            child.removeListener("error", onError);
+            resolve({ outcome: value.outcome });
+        };
+        const onError = (error) => {
+            child.removeListener("message", onMessage);
+            reject(error);
+        };
+        child.on("message", onMessage);
+        child.once("error", onError);
+    });
+}
+describe("ChildProcessSyncWorkerAdapter", () => {
+    it("starts isolated realtime and chore processes", async () => {
+        const realtime = worker("realtime");
+        const chore = worker("chore");
+        const [realtimeIdentity, choreIdentity] = await Promise.all([realtime.start(), chore.start()]);
+        expect(realtimeIdentity.pid).not.toBe(choreIdentity.pid);
+        expect(realtimeIdentity.moduleStateId).not.toBe(choreIdentity.moduleStateId);
+        await expect(realtime.execute(slice("1"))).resolves.toMatchObject({ paths: [{ status: "durable", epoch: 1 }] });
+        await expect(chore.execute(slice("2"))).resolves.toMatchObject({ paths: [{ status: "durable", epoch: 2 }] });
+    });
+    it("keeps the parent heartbeat and realtime process responsive while a chore parks", async () => {
+        let parked = false;
+        const chore = worker("chore", { HQ_SYNC_WORKER_TEST_PARK: "1" }, () => { parked = true; });
+        const realtime = worker("realtime");
+        const parkedWork = chore.execute(slice("3"));
+        await waitFor(() => parked);
+        const heartbeat = await new Promise((resolve) => setTimeout(() => resolve(Date.now()), 20));
+        const started = Date.now();
+        await expect(realtime.execute(slice("4"))).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        expect(Date.now() - started).toBeLessThan(500);
+        expect(heartbeat).toBeGreaterThan(0);
+        void parkedWork.catch(() => undefined);
+    });
+    it("returns a cancelled outcome without dispatching work aborted during child readiness", async () => {
+        const capture = path.join(temporaryRoot(), "dispatches.ndjson");
+        const delayedWorker = workerFixture([
+            "const fs=require('node:fs');",
+            "setTimeout(()=>process.send?.({protocol:1,type:'ready',pid:process.pid,moduleStateId:'delayed'}),60);",
+            "process.on('message',(message)=>{if(message.type!=='execute')return;fs.appendFileSync(process.env.HQ_CAPTURE_PATH,JSON.stringify(message)+'\\n');process.send?.({protocol:1,type:'outcome',requestId:message.requestId,outcome:{paths:message.slice.paths.map((path)=>({path:path.canonicalPath,epoch:path.epoch,status:'durable'}))}});});",
+            "setInterval(()=>undefined,1_000);",
+        ].join(""));
+        const adapter = worker("realtime", { HQ_CAPTURE_PATH: capture }, undefined, { workerScript: delayedWorker });
+        const controller = new AbortController();
+        const pending = adapter.execute({ ...slice("cancelled-during-ready"), signal: controller.signal });
+        controller.abort();
+        await expect(pending).resolves.toMatchObject({ paths: [{ status: "retryable", reason: "worker cancelled before dispatch" }] });
+        expect(fs.existsSync(capture)).toBe(false);
+    });
+    it("fails a child startup that times out or sends an invalid protocol handshake", async () => {
+        const pidPath = path.join(temporaryRoot(), "handshake.pid");
+        const silentWorker = workerFixture([
+            "require('node:fs').writeFileSync(process.env.HQ_PID_PATH,String(process.pid));",
+            "setInterval(()=>undefined,1_000);",
+        ].join(""));
+        const silent = worker("realtime", { HQ_PID_PATH: pidPath }, undefined, { workerScript: silentWorker, readyTimeoutMs: 50 });
+        await expect(silent.start()).rejects.toThrow("worker protocol handshake timed out after 50ms");
+        const silentPid = Number(fs.readFileSync(pidPath, "utf8"));
+        await waitFor(() => !isAlive(silentPid));
+        for (const message of [
+            "{protocol:2,type:'ready',pid:process.pid,moduleStateId:'wrong-version'}",
+            "{protocol:1,type:'ready',pid:process.pid}",
+        ]) {
+            const invalidWorker = workerFixture(`process.send?.(${message});setInterval(()=>undefined,1_000);`);
+            const invalid = worker("realtime", {}, undefined, { workerScript: invalidWorker, readyTimeoutMs: 500 });
+            await expect(invalid.start()).rejects.toThrow("invalid ready message or protocol version skew (expected protocol 1)");
+        }
+    });
+    it.each(["pre-mutation", "post-mutation", "pre-result"])("treats SIGKILL at %s as retryable rather than implicit success", async (phase) => {
+        const crashing = worker("realtime", { HQ_SYNC_WORKER_TEST_CRASH_PHASE: phase });
+        const coordinator = new DefaultParallelSyncCoordinator({
+            realtimeWorker: crashing,
+            choreWorker: worker("chore"),
+            identifyPath: () => ({ targetUid: "target-personal", areaId: "root:notes" }),
+            planChorePaths: () => [],
+        });
+        await expect(coordinator.submit({ class: "realtime", source: "watcher", direction: "push", paths: ["notes/kill"], causality: `kill-${phase}` }))
+            .resolves.toMatchObject({ paths: [{ status: "retryable" }] });
+        expect(coordinator.inspect().leases).toEqual([]);
+        await coordinator.shutdown();
+    });
+    it("exits when its IPC parent disconnects and when that parent dies", async () => {
+        const direct = forkWorker();
+        const directReady = await waitForReady(direct);
+        direct.disconnect();
+        await waitFor(() => !isAlive(directReady.pid));
+        const parent = spawn(process.execPath, ["-e", [
+                "const {fork}=require('node:child_process');",
+                "const child=fork(process.env.HQ_WORKER_SCRIPT,[],{env:{...process.env,HQ_SYNC_WORKER_TEST_MODE:'1'},stdio:['ignore','pipe','pipe','ipc']});",
+                "child.once('message',(message)=>{console.log(message.pid);process.exit(0);});",
+            ].join("")], { env: { ...process.env, HQ_WORKER_SCRIPT: workerScript }, stdio: ["ignore", "pipe", "pipe"] });
+        const pid = await new Promise((resolve, reject) => {
+            let stdout = "";
+            parent.stdout.on("data", (chunk) => { stdout += chunk.toString("utf8"); });
+            parent.once("error", reject);
+            parent.once("exit", () => resolve(Number(stdout.trim())));
+        });
+        expect(Number.isSafeInteger(pid)).toBe(true);
+        await waitFor(() => !isAlive(pid));
+    });
+    it("removes a dead child append lock through the existing PID stale-lock protocol", async () => {
+        const root = temporaryRoot();
+        const store = StateStore.open({
+            rootDir: root,
+            scopeId: "worker-lock-cleanup",
+            initialState: { values: [] },
+            reduce: (state, record) => ({ values: [...state.values, String(record.payload)] }),
+        });
+        const lockPath = path.join(store.stateDir, "append.lock");
+        const crashing = worker("chore", { HQ_SYNC_WORKER_TEST_LOCK_PATH: lockPath, HQ_SYNC_WORKER_TEST_CRASH_PHASE: "pre-result" });
+        await expect(crashing.execute(slice("5"))).rejects.toThrow("worker exited before outcome");
+        expect(fs.existsSync(lockPath)).toBe(true);
+        store.append(1, "recovered");
+        expect(fs.existsSync(lockPath)).toBe(false);
+    });
+    it("restarts within its bound, drains high-volume IPC, and leaves no child orphan", async () => {
+        const capture = path.join(temporaryRoot(), "messages.ndjson");
+        const adapter = worker("realtime", { HQ_SYNC_WORKER_TEST_CAPTURE_PATH: capture });
+        const first = await adapter.start();
+        process.kill(first.pid, "SIGKILL");
+        await waitFor(() => adapter.inspect()?.pid !== undefined && adapter.inspect()?.pid !== first.pid);
+        const outcomes = await Promise.all(Array.from({ length: 512 }, (_, index) => adapter.execute(slice(`load-${index + 10}`))));
+        expect(outcomes).toHaveLength(512);
+        expect(outcomes.every((outcome) => outcome.paths[0]?.status === "durable")).toBe(true);
+        const messages = fs.readFileSync(capture, "utf8");
+        expect(messages).toContain('"target-personal"');
+        expect(messages).toContain('"epoch"');
+        expect(messages).not.toContain("env-only-secret");
+        const finalPid = adapter.inspect().pid;
+        await adapter.shutdown();
+        await waitFor(() => !isAlive(finalPid));
+    });
+    it("applies restart backoff and exhaustion to queued work after a crash", async () => {
+        const adapter = worker("realtime", {}, undefined, { maxRestarts: 1, restartBackoffMs: 100 });
+        const first = await adapter.start();
+        process.kill(first.pid, "SIGKILL");
+        await waitFor(() => adapter.inspect() === undefined);
+        const queued = adapter.execute(slice("backoff"));
+        await new Promise((resolve) => setTimeout(resolve, 25));
+        expect(adapter.inspect()).toBeUndefined();
+        await expect(queued).resolves.toMatchObject({ paths: [{ status: "durable" }] });
+        const restarted = adapter.inspect();
+        process.kill(restarted.pid, "SIGKILL");
+        await waitFor(() => adapter.inspect() === undefined);
+        await expect(adapter.execute(slice("exhausted"))).rejects.toThrow("worker restart limit exhausted after 1 restart(s)");
+    });
+    it("ignores late cancellation for a completed request ID", async () => {
+        const direct = forkWorker();
+        const ready = await waitForReady(direct);
+        try {
+            const first = toWorkerExecuteMessage(slice("reused-id"));
+            direct.send(first);
+            await expect(waitForOutcome(direct, first.requestId)).resolves.toMatchObject({ outcome: { paths: [{ status: "durable" }] } });
+            direct.send({ protocol: 1, type: "cancel", requestId: first.requestId });
+            const repeated = toWorkerExecuteMessage(slice("reused-id"));
+            direct.send(repeated);
+            await expect(waitForOutcome(direct, repeated.requestId)).resolves.toMatchObject({ outcome: { paths: [{ status: "durable" }] } });
+        }
+        finally {
+            direct.disconnect();
+            await waitFor(() => !isAlive(ready.pid));
+        }
+    });
+});
+//# sourceMappingURL=child-process-sync-worker.test.js.map

package/dist/sync/child-process-sync-worker.test.js.map

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

package/dist/sync/event-sync.d.ts

@@ -150,6 +150,12 @@ export interface StartEventSyncOptions {
     now?: () => number;
     /** Clock seam for deferred publish cleanup tests. */
     clock?: Clock;
+    /** Test seam for event-sync startup retry scheduling. */
+    retryInitialMs?: number;
+    /** Test seam for the capped event-sync startup retry delay. */
+    retryMaxMs?: number;
+    /** Test seam for full-jitter event-sync startup retries. */
+    retryRandom?: () => number;
     /** Override the per-path trailing-publish interval. */
     publishMinIntervalMs?: number;
     /** Existing runner state directory for restart-durable publish suppression. */
@@ -174,6 +180,9 @@ export interface EventSyncHandles {
     /** Tear down transport + receiver (runner shutdown path). */
     dispose: () => Promise<void>;
 }
+/** Startup retry defaults: full jitter over a 30s → 10min exponential cap. */
+export declare const DEFAULT_EVENT_SYNC_RETRY_INITIAL_MS = 30000;
+export declare const DEFAULT_EVENT_SYNC_RETRY_MAX_MS: number;
 /** Every v2 signal has identical correctness semantics: schedule one drain. */
 export type RealtimeDrainSignal = "watcher" | "wake" | "high-water" | "reconnect" | "retry";
 export interface UnifiedRealtimeSchedulerOptions {
@@ -207,10 +216,11 @@ export interface UnifiedRealtimeScheduler {
  */
 export declare function createUnifiedRealtimeScheduler(options: UnifiedRealtimeSchedulerOptions): UnifiedRealtimeScheduler;
 /**
- * Bring up the publish + receive legs. Returns `null` (poll-only degradation)
- * on ANY startup failure — subscribe 5xx, tenant resolution failure, etc. —
- * after logging the reason. The caller treats `null` as "today's behavior".
+ * Bring up the publish + receive legs. A failed initial subscribe deliberately
+ * keeps the watch runner poll-only, but returns an offline handle that retries
+ * the complete startup sequence forever. Once it succeeds, the same handle
+ * forwards publishes and disposes the live legs just like an immediate start.
  */
-export declare function startEventSync(opts: StartEventSyncOptions): Promise<EventSyncHandles | null>;
+export declare function startEventSync(opts: StartEventSyncOptions): Promise<EventSyncHandles>;
 export {};
 //# sourceMappingURL=event-sync.d.ts.map

package/dist/sync/event-sync.d.ts.map

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

package/dist/sync/event-sync.js

@@ -32,7 +32,7 @@
 import { SQSClient, ReceiveMessageCommand, DeleteMessageCommand, ChangeMessageVisibilityCommand, } from "@aws-sdk/client-sqs";
 import { HttpPushTransport } from "./push-transport.js";
 import { SqsPushReceiver, RealtimeWakeReceiver, } from "./push-receiver.js";
-import { PushEventEmitter } from "../watcher.js";
+import { PushEventEmitter, systemClock, } from "../watcher.js";
 import { emitCloudTelemetry, } from "../telemetry-events.js";
 import { createSyncLatencyMetricPublisher, } from "./metrics.js";
 import { isEventSyncLocallyDisabled } from "./feature-flags.js";
@@ -246,6 +246,9 @@ export function createRefreshingSqsClient(opts) {
         changeMessageVisibility: (args) => withRetry(() => inner.changeMessageVisibility(args)),
     };
 }
+/** Startup retry defaults: full jitter over a 30s → 10min exponential cap. */
+export const DEFAULT_EVENT_SYNC_RETRY_INITIAL_MS = 30_000;
+export const DEFAULT_EVENT_SYNC_RETRY_MAX_MS = 10 * 60_000;
 /**
  * Coalesces all v2 notifications into a single drain bit.  The cursor carried
  * by a wake is intentionally ignored: duplicate, stale, and reordered wakes
@@ -394,35 +397,48 @@ export function createUnifiedRealtimeScheduler(options) {
         },
     };
 }
-/**
- * Bring up the publish + receive legs. Returns `null` (poll-only degradation)
- * on ANY startup failure — subscribe 5xx, tenant resolution failure, etc. —
- * after logging the reason. The caller treats `null` as "today's behavior".
- */
-export async function startEventSync(opts) {
+/** Build the real publish + receive legs once a subscribe attempt succeeds. */
+async function startLiveEventSync(opts) {
     const log = opts.log ?? ((m) => console.error(m));
+    const tenantId = await opts.resolveTenantId();
+    const deviceId = opts.deviceId;
+    // The subscription response is the authenticated legacy inventory/grant.
+    // No email, environment, tenant, or queued hint can reach the live path
+    // without this server-issued queue and credential material.
+    const subscribe = opts.subscribe ??
+        ((dev) => subscribeSyncReceive({
+            apiUrl: opts.apiUrl,
+            authToken: opts.authToken,
+            deviceId: dev,
+        }));
+    const initial = await subscribe(deviceId);
+    const syncBatchFn = opts.syncBatchFn ?? (opts.syncFn
+        ? async ({ events, signal }) => {
+            for (const event of events)
+                await opts.syncFn({ event, signal });
+        }
+        : null);
+    if (!syncBatchFn) {
+        throw new Error("event-sync: syncBatchFn is required");
+    }
+    // ── publish leg (US-017) ──
+    const transport = opts.transport ??
+        new HttpPushTransport({
+            apiUrl: opts.apiUrl,
+            pushPath: "/v1/sync/push",
+            authToken: opts.authToken,
+        });
     try {
-        const tenantId = await opts.resolveTenantId();
-        const deviceId = opts.deviceId;
-        // The subscription response is the authenticated legacy inventory/grant.
-        // No email, environment, tenant, or queued hint can reach the live path
-        // without this server-issued queue and credential material.
-        const subscribe = opts.subscribe ??
-            ((dev) => subscribeSyncReceive({
-                apiUrl: opts.apiUrl,
-                authToken: opts.authToken,
-                deviceId: dev,
-            }));
-        const initial = await subscribe(deviceId);
-        // ── publish leg (US-017) ──
-        const transport = opts.transport ??
-            new HttpPushTransport({
-                apiUrl: opts.apiUrl,
-                pushPath: "/v1/sync/push",
-                authToken: opts.authToken,
-            });
         await transport.start();
-        const emitter = new PushEventEmitter({
+    }
+    catch (startupError) {
+        await transport.dispose().catch(() => undefined);
+        throw startupError;
+    }
+    let emitter = null;
+    let receiver = null;
+    try {
+        emitter = new PushEventEmitter({
             originTenantId: tenantId,
             originDeviceId: deviceId,
             transport,
@@ -446,15 +462,6 @@ export async function startEventSync(opts) {
             initialPublishedContentHashes: opts.initialPublishedContentHashes,
         });
         // ── receive leg (US-018) ──
-        const syncBatchFn = opts.syncBatchFn ?? (opts.syncFn
-            ? async ({ events, signal }) => {
-                for (const event of events)
-                    await opts.syncFn({ event, signal });
-            }
-            : null);
-        if (!syncBatchFn) {
-            throw new Error("event-sync: syncBatchFn is required");
-        }
         const publishMetric = initial.cloudWatch
             ? createSyncLatencyMetricPublisher(initial.cloudWatch)
             : async () => undefined;
@@ -464,7 +471,7 @@ export async function startEventSync(opts) {
             buildSqs: opts.buildSqs,
             now: opts.now,
         });
-        const receiver = new SqsPushReceiver({
+        receiver = new SqsPushReceiver({
             tenantId,
             queueUrl: initial.queueUrl,
             sqs,
@@ -476,30 +483,54 @@ export async function startEventSync(opts) {
             onReceiveActivity: opts.onReceiveActivity,
         });
         await receiver.start();
-        log(`event-sync: live (tenant=${tenantId} device=${deviceId} queue=${initial.queueUrl})`);
-        void emitCloudTelemetry(opts.telemetryClient, {
-            eventName: "event_sync_live",
-            source: "event-sync",
-            properties: {
-                deviceId,
-                startupResult: "live",
-                receiveState: "enabled",
-                publishState: "enabled",
-            },
-        }, { claims: opts.telemetryClaims });
-        return {
-            publishBatch: (batch) => void emitter.emitForBatch(batch),
-            receiver,
-            ownDeviceId: deviceId,
-            dispose: async () => {
-                await receiver.dispose().catch(() => undefined);
-                emitter.dispose();
-                await transport.dispose().catch(() => undefined);
-            },
-        };
     }
-    catch (err) {
-        log(`event-sync: startup failed, continuing poll-only: ${err instanceof Error ? err.message : String(err)}`);
+    catch (startupError) {
+        await receiver?.dispose().catch(() => undefined);
+        emitter?.dispose();
+        await transport.dispose().catch(() => undefined);
+        throw startupError;
+    }
+    if (!emitter || !receiver) {
+        throw new Error("event-sync: live startup completed without handles");
+    }
+    log(`event-sync: live (tenant=${tenantId} device=${deviceId} queue=${initial.queueUrl})`);
+    void emitCloudTelemetry(opts.telemetryClient, {
+        eventName: "event_sync_live",
+        source: "event-sync",
+        properties: {
+            deviceId,
+            startupResult: "live",
+            receiveState: "enabled",
+            publishState: "enabled",
+        },
+    }, { claims: opts.telemetryClaims });
+    return {
+        publishBatch: (batch) => void emitter.emitForBatch(batch),
+        receiver,
+        ownDeviceId: deviceId,
+        dispose: async () => {
+            await receiver.dispose().catch(() => undefined);
+            emitter.dispose();
+            await transport.dispose().catch(() => undefined);
+        },
+    };
+}
+function describeStartupError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+/**
+ * Bring up the publish + receive legs. A failed initial subscribe deliberately
+ * keeps the watch runner poll-only, but returns an offline handle that retries
+ * the complete startup sequence forever. Once it succeeds, the same handle
+ * forwards publishes and disposes the live legs just like an immediate start.
+ */
+export async function startEventSync(opts) {
+    const log = opts.log ?? ((m) => console.error(m));
+    try {
+        return await startLiveEventSync(opts);
+    }
+    catch (error) {
+        log(`event-sync: startup failed, continuing poll-only: ${describeStartupError(error)}`);
         void emitCloudTelemetry(opts.telemetryClient, {
             eventName: "event_sync_live",
             source: "event-sync",
@@ -510,7 +541,92 @@ export async function startEventSync(opts) {
                 publishState: "disabled",
             },
         }, { claims: opts.telemetryClaims });
-        return null;
+        const clock = opts.clock ?? systemClock;
+        const initialDelayMs = opts.retryInitialMs ?? DEFAULT_EVENT_SYNC_RETRY_INITIAL_MS;
+        const maxDelayMs = opts.retryMaxMs ?? DEFAULT_EVENT_SYNC_RETRY_MAX_MS;
+        if (!Number.isSafeInteger(initialDelayMs) || initialDelayMs < 0) {
+            throw new Error("event-sync: retryInitialMs must be a non-negative safe integer");
+        }
+        if (!Number.isSafeInteger(maxDelayMs) || maxDelayMs < initialDelayMs) {
+            throw new Error("event-sync: retryMaxMs must be a safe integer no smaller than retryInitialMs");
+        }
+        let disposed = false;
+        let live = null;
+        let retryTimer = null;
+        let retryAttempt = null;
+        let disposePromise = null;
+        let failures = 0;
+        const jitteredDelay = () => {
+            const ceiling = Math.min(maxDelayMs, initialDelayMs * 2 ** failures);
+            const random = Math.min(1, Math.max(0, (opts.retryRandom ?? Math.random)()));
+            return Math.floor(ceiling * random);
+        };
+        const retry = async () => {
+            if (disposed || live)
+                return;
+            try {
+                const handles = await startLiveEventSync(opts);
+                if (disposed) {
+                    await handles.dispose();
+                    return;
+                }
+                live = handles;
+            }
+            catch (retryError) {
+                scheduleRetry(retryError);
+            }
+        };
+        const scheduleRetry = (retryError, initial = false) => {
+            if (disposed || live || retryTimer !== null)
+                return;
+            const delayMs = jitteredDelay();
+            failures += 1;
+            log(`event-sync: startup retry ${initial ? "scheduled" : "failed"} (attempt=${failures} reason=${describeStartupError(retryError)}); next retry in ${delayMs}ms`);
+            retryTimer = clock.setTimeout(() => {
+                retryTimer = null;
+                const attempt = retry();
+                retryAttempt = attempt;
+                void attempt.then(() => {
+                    if (retryAttempt === attempt)
+                        retryAttempt = null;
+                }, () => {
+                    if (retryAttempt === attempt)
+                        retryAttempt = null;
+                });
+            }, delayMs);
+            retryTimer.unref?.();
+        };
+        scheduleRetry(error, true);
+        const dispose = async () => {
+            if (disposePromise !== null)
+                return disposePromise;
+            disposed = true;
+            disposePromise = (async () => {
+                if (retryTimer !== null)
+                    clock.clearTimeout(retryTimer);
+                retryTimer = null;
+                await retryAttempt;
+                const active = live;
+                live = null;
+                if (active)
+                    await active.dispose();
+            })();
+            return disposePromise;
+        };
+        return {
+            publishBatch: (batch) => live?.publishBatch(batch),
+            receiver: {
+                start: async () => {
+                    await live?.receiver.start();
+                },
+                dispose,
+                get connected() {
+                    return live?.receiver.connected ?? false;
+                },
+            },
+            ownDeviceId: opts.deviceId,
+            dispose,
+        };
     }
 }
 //# sourceMappingURL=event-sync.js.map