@kortix/sdk 0.9.98

package/dist/state/event-stream.js

@@ -0,0 +1,424 @@
+/**
+ * Framework-free SSE event-stream machine, extracted verbatim (same constants,
+ * same branch order, same semantics) from the connect/reconnect loop that used
+ * to live inline inside `react/use-opencode-events/index.ts`'s `useEffect`.
+ *
+ * Zero imports of `react`, `react-query`, or any `react/*` module — this file
+ * can run in any JS host (a worker, a CLI, a non-React UI). Everything that
+ * depended on React Query in the original hook (cache writes, toasts, ref
+ * lookups) stays in the React wrapper and reaches this module only through the
+ * injected `onEvent` / `onGapRehydrate` callbacks.
+ *
+ * Owns: connecting to the opencode SSE endpoint (with a connect timeout), the
+ * idle heartbeat watchdog, event coalescing + 16ms flush batching, gap
+ * detection on reconnect, the exponential-backoff reconnect loop (fast 250ms
+ * resume after an eventful stream, capped exponential backoff otherwise), and
+ * the give-up "parked" terminal state for streams pointed at dead sandboxes
+ * (see `maxConsecutiveHardFailures`/`onParked`).
+ */
+import { getSupabaseAccessToken, invalidateTokenCache } from '../platform/auth.js';
+import { logger } from '../platform/logger.js';
+const realTimers = {
+    now: () => Date.now(),
+    setTimeout: (handler, timeoutMs) => setTimeout(handler, timeoutMs),
+    clearTimeout: (handle) => clearTimeout(handle),
+};
+// ---- Tunables ----
+const COALESCE_FLUSH_MS = 16;
+const YIELD_INTERVAL_MS = 8;
+/**
+ * Idle watchdog budget for an ESTABLISHED stream. The server currently emits
+ * NO idle keepalive frames, so a healthy-but-quiet session produces genuinely
+ * long silent stretches — a budget below the real idle gap makes the watchdog
+ * kill perfectly healthy connections on a timer (the old 15s value guaranteed
+ * a kill every 15s of quiet, by design). 60s keeps the watchdog able to catch
+ * genuinely dead sockets while tolerating normal idle. When the server ships
+ * `: keepalive` comment frames this can come back down toward 2× the
+ * keepalive cadence. Configurable per-stream via
+ * `OpenEventStreamOptions.heartbeatTimeoutMs`.
+ */
+const HEARTBEAT_MS = 60_000;
+const GAP_REHYDRATE_MS = 5_000;
+const FAST_RECONNECT_DELAY_MS = 250;
+const BASE_RECONNECT_DELAY_MS = 1000;
+const MAX_RECONNECT_DELAY_MS = 30_000;
+const MAX_BACKOFF_EXPONENT = 5;
+const SSE_DEFAULT_RETRY_DELAY_MS = 3000;
+const SSE_MAX_RETRY_DELAY_MS = 30_000;
+const CONNECT_TIMEOUT_MS = 20_000;
+/** An event-less attempt that dies faster than this is a "hard failure" —
+ *  the fast-503 signature of a dead sandbox — even when the error carries no
+ *  HTTP status (edge-generated failures surface as opaque network/CORS
+ *  errors). See `maxConsecutiveHardFailures`. */
+const HARD_FAILURE_WINDOW_MS = 2_000;
+const MAX_CONSECUTIVE_HARD_FAILURES = 8;
+/**
+ * Coalescing keys — determines which events can replace earlier ones in the
+ * same 16ms flush batch.
+ *
+ * NOTE: message.part.updated is intentionally NOT coalesced. While the server
+ * sends full part state each time, coalescing can cause a stale snapshot to be
+ * the sole survivor of a batch. When that stale snapshot is processed before
+ * any deltas, it inserts the part with wrong/partial text (prefix-growth guard
+ * can't help — nothing to compare against). The upsertPart prefix-growth guard
+ * efficiently rejects stale snapshots with a no-op return, so processing every
+ * snapshot has minimal cost.
+ */
+function getCoalesceKey(event) {
+    if (event.type === 'session.status') {
+        return `session.status:${event.properties.sessionID}`;
+    }
+    if (event.type === 'lsp.updated')
+        return 'lsp.updated';
+    return undefined;
+}
+/**
+ * A promise that resolves the moment `signal` fires 'abort' (or immediately,
+ * if it's already aborted), plus a `cleanup` to remove the listener when it
+ * loses a race. Used to make an in-flight `iterator.next()` read abortable:
+ * without this, a parked read (server stops sending, no error, no close)
+ * would never let a fired heartbeat/abort be observed, since nothing wakes
+ * the pending read.
+ */
+function onceAborted(signal) {
+    if (signal.aborted)
+        return { promise: Promise.resolve(), cleanup: () => { } };
+    let handler = () => { };
+    const promise = new Promise((resolve) => {
+        handler = () => resolve();
+        signal.addEventListener('abort', handler, { once: true });
+    });
+    return { promise, cleanup: () => signal.removeEventListener('abort', handler) };
+}
+/**
+ * Connects to the opencode SSE event stream and keeps it alive: heartbeat
+ * watchdog, event coalescing + batched flush, gap-triggered rehydrate signal,
+ * and exponential-backoff reconnect. Framework-free — safe to call from any
+ * host (the React wrapper calls this once per effect run; a non-React host can
+ * call it directly).
+ */
+export function openEventStream(opts) {
+    const { client, onEvent, onGapRehydrate, onParked, signal: externalSignal } = opts;
+    const t = opts.timers ?? realTimers;
+    const connectTimeoutMs = opts.connectTimeoutMs ?? CONNECT_TIMEOUT_MS;
+    const heartbeatTimeoutMs = opts.heartbeatTimeoutMs ?? HEARTBEAT_MS;
+    const maxConsecutiveHardFailures = opts.maxConsecutiveHardFailures ?? MAX_CONSECUTIVE_HARD_FAILURES;
+    const abortController = new AbortController();
+    const onExternalAbort = () => abortController.abort();
+    if (externalSignal) {
+        if (externalSignal.aborted)
+            abortController.abort();
+        else
+            externalSignal.addEventListener('abort', onExternalAbort, { once: true });
+    }
+    // Track last stream activity (connect or event) to gate reconnect hydration.
+    // Using only "last event" causes hydrate storms when the server rotates
+    // idle SSE connections that carried no events.
+    let lastStreamActivityTime = t.now();
+    // Event coalescing queue (like the SolidJS reference)
+    let queue = [];
+    let flushTimer;
+    let lastFlush = 0;
+    // Coalescing map — replaces earlier events of the same key
+    const coalesced = new Map();
+    const flush = () => {
+        if (flushTimer)
+            t.clearTimeout(flushTimer);
+        flushTimer = undefined;
+        if (queue.length === 0)
+            return;
+        const events = queue;
+        queue = [];
+        coalesced.clear();
+        lastFlush = t.now();
+        lastStreamActivityTime = t.now();
+        for (const item of events) {
+            if (!item)
+                continue;
+            try {
+                onEvent(item.event);
+            }
+            catch (e) {
+                // A single event handler must never break the stream OR crash the
+                // host. e.g. a handler calls getClient() before the sandbox URL is
+                // pinned (during a session switch) — that throw used to escape to the
+                // route error boundary. Swallow + log; the next events + retries
+                // recover.
+                console.warn('[opencode-events] event handler threw, skipping', e);
+            }
+        }
+    };
+    const schedule = () => {
+        if (flushTimer)
+            return;
+        const elapsed = t.now() - lastFlush;
+        flushTimer = t.setTimeout(flush, Math.max(0, COALESCE_FLUSH_MS - elapsed));
+    };
+    // Consume the stream in the background with automatic retry
+    (async () => {
+        let retryCount = 0;
+        // Consecutive hard-failure streak — see `maxConsecutiveHardFailures`.
+        // Survives across attempts; reset by any attempt that delivered events
+        // or that failed slowly without an HTTP status.
+        let consecutiveHardFailures = 0;
+        while (!abortController.signal.aborted) {
+            let streamHadEvents = false;
+            let stableConnection = false;
+            let heartbeatTimer;
+            let connectTimer;
+            // What this attempt died to (null = clean end), plus when it started —
+            // both feed the hard-failure classification below the try block.
+            let attemptError = null;
+            const attemptStartedAt = t.now();
+            // Per-attempt controller passed to the SSE client. Aborting it is what
+            // actually cancels the underlying network reader — the vendor client
+            // only cancels on the signal IT was handed. It aborts when EITHER the
+            // heartbeat fires OR the outer controller aborts (linked below), so a
+            // heartbeat-forced reconnect tears the old connection down instead of
+            // leaving it parked/leaking while a new one opens.
+            const attemptAbort = new AbortController();
+            const outerLink = onceAborted(abortController.signal);
+            outerLink.promise.then(() => attemptAbort.abort());
+            try {
+                // Race the connect call itself against `connectTimeoutMs`. A
+                // black-holed proxy can swallow this request with no error, no data,
+                // and no close — the heartbeat watchdog below only starts once this
+                // resolves, so it can't rescue a hung connect. On timeout, abort this
+                // attempt (cancels the underlying request, same as any other
+                // reconnect) and reject so it falls into the catch block below and
+                // retries through the normal backoff path, exactly like any other
+                // connect failure.
+                const result = await new Promise((resolve, reject) => {
+                    let settled = false;
+                    connectTimer = t.setTimeout(() => {
+                        if (settled)
+                            return;
+                        settled = true;
+                        logger.warn('SSE connect timed out, forcing reconnect', { connectTimeoutMs });
+                        attemptAbort.abort();
+                        reject(new Error(`SSE connect timed out after ${connectTimeoutMs}ms`));
+                    }, connectTimeoutMs);
+                    client.global
+                        .event({
+                        signal: attemptAbort.signal,
+                        sseDefaultRetryDelay: SSE_DEFAULT_RETRY_DELAY_MS,
+                        sseMaxRetryDelay: SSE_MAX_RETRY_DELAY_MS,
+                    })
+                        .then((value) => {
+                        if (settled)
+                            return;
+                        settled = true;
+                        t.clearTimeout(connectTimer);
+                        resolve(value);
+                    }, (err) => {
+                        if (settled)
+                            return;
+                        settled = true;
+                        t.clearTimeout(connectTimer);
+                        reject(err);
+                    });
+                });
+                const { stream } = result;
+                lastStreamActivityTime = t.now();
+                // Heartbeat timeout — if no events arrive within the idle budget
+                // (default 60s, see HEARTBEAT_MS for why), abort and reconnect. This
+                // is the ONLY recovery mechanism we need on an established stream —
+                // replaces the stall watchdog, reconciler, and visibility handler.
+                const resetHeartbeat = () => {
+                    t.clearTimeout(heartbeatTimer);
+                    heartbeatTimer = t.setTimeout(() => {
+                        logger.warn('SSE heartbeat timeout, forcing reconnect');
+                        attemptAbort.abort();
+                    }, heartbeatTimeoutMs);
+                };
+                resetHeartbeat();
+                // Consume stream: queue + coalesce + 16ms flush + yield every 8ms.
+                //
+                // The read itself has to be abortable, not just checked between
+                // reads. If the underlying `.next()` parks (server stops sending, no
+                // error, no close), a plain `for await` never yields control back to
+                // this loop body, so a heartbeat/abort that fires while parked would
+                // never actually be observed. Race each read against the
+                // heartbeat/abort signals instead — whichever settles first wins.
+                let yieldedAt = t.now();
+                const iterator = stream[Symbol.asyncIterator]();
+                while (!attemptAbort.signal.aborted) {
+                    const nextOutcome = iterator.next().then((result) => ({ kind: 'next', result }), (error) => ({ kind: 'error', error }));
+                    const abortWatch = onceAborted(attemptAbort.signal);
+                    const outcome = await Promise.race([
+                        nextOutcome,
+                        abortWatch.promise.then(() => ({ kind: 'aborted' })),
+                    ]);
+                    abortWatch.cleanup();
+                    if (outcome.kind === 'aborted')
+                        break;
+                    if (outcome.kind === 'error')
+                        throw outcome.error;
+                    if (outcome.result.done)
+                        break;
+                    streamHadEvents = true;
+                    resetHeartbeat();
+                    const raw = outcome.result.value;
+                    const e = (raw && typeof raw === 'object' && 'payload' in raw ? raw.payload : raw);
+                    if (!e?.type)
+                        continue;
+                    const ck = getCoalesceKey(e);
+                    if (ck) {
+                        const existing = coalesced.get(ck);
+                        if (existing !== undefined) {
+                            queue[existing] = undefined;
+                        }
+                        coalesced.set(ck, queue.length);
+                    }
+                    queue.push({ type: e.type, event: e });
+                    schedule();
+                    if (t.now() - yieldedAt < YIELD_INTERVAL_MS)
+                        continue;
+                    yieldedAt = t.now();
+                    await new Promise((resolve) => t.setTimeout(resolve, 0));
+                }
+                // Healthy stream ONLY if it actually delivered events. There used to
+                // be a time-based OR-branch here ("or stayed open >10s") — that was a
+                // prod reconnect storm: anything that kills idle connections on a
+                // period ABOVE that threshold (our own heartbeat watchdog, an idle
+                // proxy timeout, server-side rotation) made every idle disconnect
+                // look "stable", which reset retryCount and locked the loop into the
+                // 250ms fast-reconnect path forever (~236 reconnects/hour/stream).
+                // An idle disconnect — watchdog-triggered or natural — must ride the
+                // exponential backoff (1s → 30s cap) instead; the moment a
+                // reconnected stream delivers a real event, backoff resets and the
+                // fast path returns. Missed-while-waiting events are covered by the
+                // gap-rehydrate signal below.
+                stableConnection = streamHadEvents;
+            }
+            catch (err) {
+                if (abortController.signal.aborted)
+                    break;
+                attemptError = err;
+                const errStr = String(err);
+                const isAuthError = errStr.includes('401') ||
+                    errStr.includes('403') ||
+                    errStr.includes('Unauthorized') ||
+                    errStr.includes('Token refresh failed');
+                logger.error('SSE event stream error', {
+                    error: errStr,
+                    retryCount,
+                    isAuthError,
+                });
+                // On auth errors, invalidate the token cache and fetch a fresh token.
+                // This ensures all callers (SSE, health check, SDK) immediately use
+                // the refreshed token instead of serving stale cached ones for 30s.
+                if (isAuthError) {
+                    try {
+                        invalidateTokenCache();
+                        await getSupabaseAccessToken();
+                        logger.info('SSE: refreshed auth token after auth error');
+                    }
+                    catch (refreshErr) {
+                        logger.error('SSE: failed to refresh auth token', {
+                            error: String(refreshErr),
+                        });
+                    }
+                }
+            }
+            finally {
+                t.clearTimeout(heartbeatTimer);
+                t.clearTimeout(connectTimer);
+                // Release the reader/connection if we left the loop for any reason
+                // other than an already-fired abort (e.g. stream `done`, or a thrown
+                // error), and detach the outer-abort listener so it can't accumulate
+                // across reconnects.
+                attemptAbort.abort();
+                outerLink.cleanup();
+                flush();
+            }
+            // Stream ended or errored — reconnect with exponential backoff.
+            // ERR_INCOMPLETE_CHUNKED_ENCODING is normal when the server closes the
+            // SSE connection between response cycles. Minimum 1s delay even on
+            // first retry to avoid reconnection storms when the server is flapping
+            // (connect → immediate disconnect loops).
+            if (abortController.signal.aborted)
+                break;
+            // ── Give-up (park) check — the "dead sandbox" terminal state. ────────
+            // A stream pointed at an archived/stopped session's sandbox otherwise
+            // retries FOREVER: the proxy 503s every `/global/event` connect, and
+            // prod showed continuous 503 loops from several dead sandboxes at once.
+            // Classify this attempt: a HARD failure delivered zero events AND
+            // either carried an HTTP-level status (the vendor client wraps non-2xx
+            // as `Error` with `cause: { status }` — see @opencode-ai/sdk's
+            // error-interceptor) or died within HARD_FAILURE_WINDOW_MS (edge 503s
+            // surface as opaque network/CORS errors with no status attached).
+            // Slow failures without a status (a black-holed connect that hit the
+            // 20s connect timeout) and anything that streamed a real event reset
+            // the streak. After `maxConsecutiveHardFailures` in a row — spread
+            // over ~2 minutes by the exponential backoff below — park for good.
+            const attemptDurationMs = t.now() - attemptStartedAt;
+            const httpStatus = attemptError?.cause?.status;
+            const isHardFailure = !streamHadEvents &&
+                ((typeof httpStatus === 'number' && httpStatus >= 400) ||
+                    attemptDurationMs < HARD_FAILURE_WINDOW_MS);
+            consecutiveHardFailures = isHardFailure ? consecutiveHardFailures + 1 : 0;
+            if (consecutiveHardFailures >= maxConsecutiveHardFailures) {
+                logger.error('SSE event stream parked — giving up after consecutive hard failures', {
+                    consecutiveFailures: consecutiveHardFailures,
+                    lastError: String(attemptError),
+                });
+                try {
+                    onParked?.({ consecutiveFailures: consecutiveHardFailures, lastError: attemptError });
+                }
+                catch (parkedHandlerErr) {
+                    // A host's park handler must never crash the (already-terminal)
+                    // stream machine.
+                    console.warn('[opencode-events] onParked handler threw', parkedHandlerErr);
+                }
+                break;
+            }
+            // Re-hydrate messages for loaded sessions when the SSE gap was
+            // significant (>5s). Events missed during the gap (e.g. streaming
+            // assistant response) would never arrive, leaving the UI stale until
+            // the user manually refreshes.
+            const gap = t.now() - lastStreamActivityTime;
+            if (gap > GAP_REHYDRATE_MS) {
+                onGapRehydrate?.(gap);
+            }
+            if (stableConnection) {
+                // Fast reconnect after healthy streams so live streaming resumes
+                // immediately.
+                retryCount = 0;
+            }
+            else {
+                retryCount++;
+                if (retryCount > 1) {
+                    logger.warn('SSE event stream reconnecting', { retryCount });
+                }
+            }
+            const delay = stableConnection
+                ? FAST_RECONNECT_DELAY_MS
+                : Math.min(BASE_RECONNECT_DELAY_MS * 2 ** Math.min(retryCount - 1, MAX_BACKOFF_EXPONENT), MAX_RECONNECT_DELAY_MS);
+            await new Promise((resolve) => {
+                const timer = t.setTimeout(resolve, delay);
+                const onAbort = () => {
+                    t.clearTimeout(timer);
+                    resolve();
+                };
+                abortController.signal.addEventListener('abort', onAbort, { once: true });
+            });
+        }
+    })();
+    return {
+        close: () => {
+            abortController.abort();
+            if (externalSignal)
+                externalSignal.removeEventListener('abort', onExternalAbort);
+            if (flushTimer)
+                t.clearTimeout(flushTimer);
+        },
+    };
+}
+// The curated chat-event union built on top of this stream's `OpenCodeEvent` —
+// re-exported here (additive only) so a host that imports the SSE primitive
+// from this subpath (`@kortix/sdk/event-stream`) can reach the chat-narrowing
+// helpers from the same import without a second subpath. Canonical definition
+// lives in `./chat-events.ts`.
+export { heartbeatGapEvent, narrowChatEvent, } from './chat-events.js';
+//# sourceMappingURL=event-stream.js.map

package/dist/state/event-stream.js.map

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

package/dist/state/idb-sync-cache.d.ts

@@ -0,0 +1,18 @@
+/**
+ * IndexedDB persistence layer for the sync store.
+ * Provides instant session data on cold loads (stale-while-revalidate).
+ *
+ * Schema: one object store "sessions" keyed by cacheKey, each entry holds
+ * { cacheKey, userId, sessionId, messages, parts, updatedAt }.
+ */
+export declare function saveSessionToIDB(sessionId: string, messages: any[], parts: Record<string, any[]>): Promise<void>;
+export declare function flushIDBWrites(): Promise<void>;
+export declare function loadSessionFromIDB(sessionId: string): Promise<{
+    messages: any[];
+    parts: Record<string, any[]>;
+} | null>;
+export declare function loadAllSessionIdsFromIDB(): Promise<string[]>;
+export declare function deleteSessionFromIDB(sessionId: string): Promise<void>;
+export declare function clearSessionIDBCache(): Promise<void>;
+export declare function pruneIDBCache(): Promise<void>;
+//# sourceMappingURL=idb-sync-cache.d.ts.map

package/dist/state/idb-sync-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idb-sync-cache.d.ts","sourceRoot":"","sources":["../../src/state/idb-sync-cache.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuGH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,GAAG,EAAE,EACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CASf;AAED,wBAAgB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAK9C;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,GAAG,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;CAAE,GAAG,IAAI,CAAC,CAuBnE;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBlE;AAED,wBAAsB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW3E;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAa1D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CA0BnD"}