@kortix/sdk 0.9.98

package/dist/react/use-session-sync.js

@@ -0,0 +1,375 @@
+"use client";
+import { useEffect, useRef } from "react";
+import { getClient } from "../opencode/client.js";
+import { useSyncStore, } from "../state/sync-store.js";
+import { useSandboxConnectionStore } from "../state/sandbox-connection-store.js";
+import { loadSessionFromIDB, saveSessionToIDB } from "../state/idb-sync-cache.js";
+import { canQueryOpenCodeSession } from "./use-opencode-sessions/index.js";
+const EMPTY_MESSAGES = [];
+const EMPTY_DIFFS = [];
+const EMPTY_TODOS = [];
+const IDLE_STATUS = { type: "idle" };
+const MESSAGE_POLL_INTERVAL_MS = 10_000;
+const NETWORK_REVALIDATE_COOLDOWN_MS = 60_000;
+/**
+ * Build MessageWithParts[] with reference caching.
+ * Returns the same array reference if nothing relevant changed.
+ * This is a module-level cache keyed by sessionId so multiple components
+ * using the same sessionId share the cache (e.g. SessionLayout + SessionChat).
+ */
+const MESSAGE_CACHE_MAX = 20;
+const messageCache = new Map();
+const inFlightInitialLoads = new Map();
+const lastNetworkLoadAttemptAt = new Map();
+const pollInFlightSessions = new Set();
+function markNetworkLoadAttempt(sessionId) {
+    lastNetworkLoadAttemptAt.delete(sessionId);
+    lastNetworkLoadAttemptAt.set(sessionId, Date.now());
+    if (lastNetworkLoadAttemptAt.size > MESSAGE_CACHE_MAX) {
+        const oldest = lastNetworkLoadAttemptAt.keys().next().value;
+        if (oldest)
+            lastNetworkLoadAttemptAt.delete(oldest);
+    }
+}
+function touchMessageCache(sessionId) {
+    const entry = messageCache.get(sessionId);
+    if (entry) {
+        messageCache.delete(sessionId);
+        messageCache.set(sessionId, entry);
+    }
+    if (messageCache.size > MESSAGE_CACHE_MAX) {
+        const oldest = messageCache.keys().next().value;
+        if (oldest)
+            messageCache.delete(oldest);
+    }
+}
+function buildMessages(sessionId, msgs, parts) {
+    if (!msgs || msgs.length === 0)
+        return EMPTY_MESSAGES;
+    const cached = messageCache.get(sessionId);
+    if (cached && cached.msgs === msgs) {
+        // Same message array — check if any part arrays changed
+        let same = cached.partRefs.length === msgs.length;
+        if (same) {
+            for (let i = 0; i < msgs.length; i++) {
+                if (parts[msgs[i].id] !== cached.partRefs[i]) {
+                    same = false;
+                    break;
+                }
+            }
+        }
+        if (same)
+            return cached.result;
+    }
+    // Rebuild
+    const partRefs = [];
+    const result = [];
+    for (const info of msgs) {
+        const pa = parts[info.id];
+        partRefs.push(pa);
+        result.push({ info, parts: pa ?? [] });
+    }
+    messageCache.set(sessionId, { msgs, partRefs, result });
+    touchMessageCache(sessionId);
+    return result;
+}
+/**
+ * Single hook that provides all session data from the sync store.
+ * Replaces: useOpenCodeMessages + useOpenCodeSessionStatusStore + useOpenCodePendingStore
+ *
+ * On first access, fetches messages from the server and populates the store.
+ * After that, SSE events keep the store updated in real time.
+ */
+export function useSessionSync(sessionId) {
+    const fetchedRef = useRef(null);
+    const runtimeHealthy = useSandboxConnectionStore((s) => s.healthy === true);
+    // Fetch messages on first access (or session change).
+    // On failure, retries with backoff (500ms, 1s, 2s) up to 3 times.
+    // Without retry, a transient failure (server not ready on page refresh)
+    // permanently prevents messages from loading because fetchedRef blocks re-fetch.
+    useEffect(() => {
+        if (!canQueryOpenCodeSession(sessionId))
+            return;
+        // Guard against duplicate concurrent fetches for the same session.
+        if (fetchedRef.current === sessionId)
+            return;
+        fetchedRef.current = sessionId;
+        // NOTE: We intentionally do NOT skip the fetch when the store already
+        // has messages from SSE. SSE only delivers events from the connection
+        // point forward — it doesn't replay history. If the agent is actively
+        // streaming when the user navigates to a session, SSE stub messages
+        // would be the only messages in the store, missing the full thread
+        // history. Always fetch and let hydrate() merge safely.
+        let cancelled = false;
+        // Phase 2: Hydrate from IndexedDB cache FIRST for instant display.
+        // Server fetch still runs in background to revalidate.
+        const hydrateFromCache = async () => {
+            const existing = useSyncStore.getState().messages[sessionId];
+            if (existing && existing.length > 0)
+                return;
+            try {
+                const cached = await loadSessionFromIDB(sessionId);
+                if (cancelled)
+                    return;
+                if (cached && cached.messages.length > 0) {
+                    const current = useSyncStore.getState().messages[sessionId];
+                    if (!current || current.length === 0) {
+                        useSyncStore.getState().hydrate(sessionId, cached.messages.map((info) => ({
+                            info,
+                            parts: cached.parts[info.id] ?? [],
+                        })));
+                    }
+                }
+            }
+            catch {
+                // IDB unavailable — fall through to network fetch
+            }
+        };
+        hydrateFromCache();
+        if (!runtimeHealthy) {
+            fetchedRef.current = null;
+            return () => {
+                cancelled = true;
+                messageCache.delete(sessionId);
+            };
+        }
+        const existingMessages = useSyncStore.getState().messages[sessionId];
+        const lastNetworkLoad = lastNetworkLoadAttemptAt.get(sessionId) ?? 0;
+        if (existingMessages &&
+            existingMessages.length > 0 &&
+            Date.now() - lastNetworkLoad < NETWORK_REVALIDATE_COOLDOWN_MS) {
+            return () => {
+                cancelled = true;
+                fetchedRef.current = null;
+                messageCache.delete(sessionId);
+            };
+        }
+        // IMPORTANT: do NOT short-circuit hydrate on `cancelled`. The
+        // store is keyed by sessionID — writing into it is always safe
+        // even if this effect's component has unmounted. Strict Mode
+        // fires effect → cleanup (cancelled=true) → effect, and the
+        // in-flight dedup map below would otherwise drop the only fetch
+        // because the cancelled first run bails before hydrating.
+        const fetchWithRetry = async (attempt = 0) => {
+            try {
+                const res = await getClient().session.messages({
+                    sessionID: sessionId,
+                });
+                const data = res.data ?? [];
+                if (data.length === 0) {
+                    const freshState = useSyncStore.getState();
+                    const existingMsgs = freshState.messages[sessionId];
+                    if (existingMsgs && existingMsgs.length > 0) {
+                        return;
+                    }
+                    // Mark session as loaded (empty) immediately so
+                    // isLoading becomes false — no extra round-trip.
+                    // If the session is busy (agent running), SSE events
+                    // will deliver messages as they arrive.
+                    freshState.clearSession(sessionId);
+                    return;
+                }
+                if (res.data) {
+                    useSyncStore.getState().hydrate(sessionId, res.data);
+                    // Persist to IDB for next cold load
+                    const state = useSyncStore.getState();
+                    const msgs = state.messages[sessionId] ?? [];
+                    if (msgs.length > 0) {
+                        saveSessionToIDB(sessionId, msgs, state.parts);
+                    }
+                }
+            }
+            catch {
+                // Stop retrying ONLY if the effect has been torn down
+                // (no live consumer wants this data anymore). Don't gate
+                // the success-path hydrate on `cancelled` — see comment
+                // above the function.
+                if (cancelled)
+                    return;
+                if (attempt < 3) {
+                    const delay = 500 * 2 ** attempt;
+                    setTimeout(() => fetchWithRetry(attempt + 1), delay);
+                }
+                else {
+                    // All retries exhausted — unblock the UI by marking
+                    // the session as loaded (empty). Without this,
+                    // isLoading stays true forever on cold boot when the
+                    // sandbox isn't ready yet.
+                    fetchedRef.current = null;
+                    const state = useSyncStore.getState();
+                    if (!(sessionId in state.messages)) {
+                        state.clearSession(sessionId);
+                    }
+                }
+            }
+        };
+        const startFetch = () => {
+            const loadPromise = fetchWithRetry().finally(() => {
+                markNetworkLoadAttempt(sessionId);
+                inFlightInitialLoads.delete(sessionId);
+            });
+            inFlightInitialLoads.set(sessionId, loadPromise);
+            return loadPromise;
+        };
+        const existingLoad = inFlightInitialLoads.get(sessionId);
+        if (existingLoad) {
+            // A prior mount fired the fetch. In Strict Mode that prior run
+            // may have been cancelled mid-flight and skipped hydrate.
+            // Await it, then verify the store actually has data — re-fire
+            // if it doesn't.
+            existingLoad
+                .catch(() => {
+                // Error handling is already performed by the owner.
+            })
+                .then(() => {
+                if (cancelled)
+                    return;
+                const after = useSyncStore.getState().messages[sessionId];
+                if (after === undefined && !inFlightInitialLoads.has(sessionId)) {
+                    startFetch();
+                }
+            });
+        }
+        else {
+            startFetch();
+        }
+        return () => {
+            cancelled = true;
+            // Allow a future real remount/navigation to fetch again while still
+            // relying on the module-level in-flight map to dedupe Strict Mode.
+            fetchedRef.current = null;
+            // Evict stale cache entry to prevent unbounded memory growth
+            messageCache.delete(sessionId);
+        };
+    }, [sessionId, runtimeHealthy]);
+    // ── Polling fallback ──
+    // When the session is busy, SSE should deliver streaming events. But if
+    // SSE is broken (502, ERR_QUIC_PROTOCOL_ERROR, etc.), no events arrive
+    // and the UI is stuck on "Considering next steps..." forever. As a
+    // fallback, poll for messages while the session is busy.
+    // The poll stops as soon as the session goes idle or the component unmounts.
+    const pollTimerRef = useRef(null);
+    const lastPartCountRef = useRef(0);
+    const pollInFlightRef = useRef(false);
+    useEffect(() => {
+        if (!sessionId)
+            return;
+        if (!runtimeHealthy) {
+            if (pollTimerRef.current) {
+                clearInterval(pollTimerRef.current);
+                pollTimerRef.current = null;
+            }
+            return;
+        }
+        const state = useSyncStore.getState();
+        const currentStatus = state.sessionStatus[sessionId];
+        const isBusyNow = currentStatus?.type === "busy" || currentStatus?.type === "retry";
+        if (isBusyNow) {
+            // Start polling if not already active
+            if (!pollTimerRef.current) {
+                // Track part count to detect SSE liveness — if parts are
+                // growing between polls, SSE is working and we skip the fetch.
+                const countParts = () => {
+                    const s = useSyncStore.getState();
+                    const msgs = s.messages[sessionId] ?? [];
+                    let count = 0;
+                    for (const m of msgs) {
+                        const parts = s.parts[m.id];
+                        if (parts)
+                            count += parts.length;
+                    }
+                    return count;
+                };
+                lastPartCountRef.current = countParts();
+                pollTimerRef.current = setInterval(async () => {
+                    const s = useSyncStore.getState();
+                    const st = s.sessionStatus[sessionId];
+                    if (st?.type !== "busy" && st?.type !== "retry") {
+                        // Session went idle — stop polling
+                        if (pollTimerRef.current) {
+                            clearInterval(pollTimerRef.current);
+                            pollTimerRef.current = null;
+                        }
+                        return;
+                    }
+                    // Skip fetch if SSE is delivering data (part count grew)
+                    const currentCount = countParts();
+                    if (currentCount > lastPartCountRef.current) {
+                        lastPartCountRef.current = currentCount;
+                        return;
+                    }
+                    if (pollInFlightRef.current || pollInFlightSessions.has(sessionId))
+                        return;
+                    // SSE appears stalled — fetch messages AND session status
+                    pollInFlightRef.current = true;
+                    pollInFlightSessions.add(sessionId);
+                    try {
+                        const [msgRes, statusRes] = await Promise.all([
+                            getClient().session.messages({ sessionID: sessionId }),
+                            getClient().session.status().catch(() => null),
+                        ]);
+                        if (msgRes.data) {
+                            useSyncStore.getState().hydrate(sessionId, msgRes.data);
+                        }
+                        // Update session status from server — without this,
+                        // a dead SSE means session.idle never arrives and the
+                        // UI stays stuck on "busy" forever.
+                        if (statusRes?.data) {
+                            const statuses = statusRes.data;
+                            const serverStatus = statuses[sessionId];
+                            if (serverStatus) {
+                                useSyncStore.getState().setStatus(sessionId, serverStatus);
+                            }
+                            else {
+                                // Session not in busy statuses map → it's idle
+                                useSyncStore.getState().setStatus(sessionId, { type: "idle" });
+                            }
+                        }
+                    }
+                    catch {
+                        // Silently ignore — will retry on next interval
+                    }
+                    finally {
+                        pollInFlightRef.current = false;
+                        pollInFlightSessions.delete(sessionId);
+                        lastPartCountRef.current = countParts();
+                    }
+                }, MESSAGE_POLL_INTERVAL_MS);
+            }
+        }
+        else {
+            // Session is idle — stop polling
+            if (pollTimerRef.current) {
+                clearInterval(pollTimerRef.current);
+                pollTimerRef.current = null;
+            }
+        }
+    });
+    // Cleanup polling on unmount
+    useEffect(() => {
+        return () => {
+            if (pollTimerRef.current) {
+                clearInterval(pollTimerRef.current);
+                pollTimerRef.current = null;
+            }
+        };
+    }, []);
+    // Single selector that derives MessageWithParts[] with reference caching.
+    // The buildMessages function returns the same array reference if nothing
+    // relevant to this session changed — preventing unnecessary re-renders.
+    const messages = useSyncStore((s) => buildMessages(sessionId, s.messages[sessionId], s.parts));
+    const status = useSyncStore((s) => s.sessionStatus[sessionId] ?? IDLE_STATUS);
+    const diffs = useSyncStore((s) => s.diffs[sessionId]);
+    const todos = useSyncStore((s) => s.todos[sessionId]);
+    const isBusy = status?.type === "busy" || status?.type === "retry";
+    const isLoading = !useSyncStore((s) => sessionId in s.messages);
+    return {
+        messages,
+        status,
+        isBusy,
+        isLoading,
+        diffs: diffs ?? EMPTY_DIFFS,
+        todos: todos ?? EMPTY_TODOS,
+    };
+}
+//# sourceMappingURL=use-session-sync.js.map

package/dist/react/use-session-sync.js.map

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

package/dist/react/use-session.d.ts

@@ -0,0 +1,171 @@
+import { BillingError } from '../platform/api/errors.js';
+import type { ModelKey } from './use-model-store.js';
+/** Coarse session lifecycle for the host's top-level gating. */
+export type SessionPhase = 'starting' | 'ready' | 'error';
+/**
+ * Whether the `/start` poll should retry. A 404 on a freshly-minted session is
+ * the optimistic create-vs-start race (the create POST hasn't landed yet), so
+ * retry it for the grace window; a 404 on any other (non-fresh) session is a
+ * genuinely-missing/no-access session and is terminal at once. Other terminal
+ * SessionStartErrors never retry; transient transport failures retry a few times.
+ */
+export declare function shouldRetrySessionStart(failureCount: number, error: unknown, sessionId: string): boolean;
+/** Discriminant for `KortixSendError` — what kind of failure interrupted a send. */
+export type KortixSendErrorKind = 'billing' | 'runtime-not-ready' | 'runtime-error';
+/** Typed failure surfaced by `send` (via `sendError`) and thrown by
+ * `answerQuestion`/`rejectQuestion`/`answerPermission`. */
+export interface KortixSendError {
+    kind: KortixSendErrorKind;
+    /** Human-readable message, already formatted for display. */
+    message: string;
+    /** Present when `kind === 'billing'` — the parsed 402 detail. */
+    billing?: BillingError;
+    /** The original thrown value, for callers that want more detail. */
+    cause: unknown;
+}
+/** Classify a thrown/rejected error from a send or a permission/question reply
+ * into a `KortixSendError`. Pure — safe to unit test without a runtime. */
+export declare function classifySendError(error: unknown): KortixSendError;
+/** The optimistic-send + last-error state `send` drives. Modeled as a small
+ * reducer-ish pair of pure helpers so the transition logic is unit-testable
+ * without rendering the hook. */
+export interface SendState {
+    /** Pending optimistic message text, or null. */
+    pending: string | null;
+    /** Last send failure, or null. Reset on every new `send` call. */
+    sendError: KortixSendError | null;
+}
+/** New state when a send is kicked off — always clears any previous error. */
+export declare function sendStateOnStart(text: string): SendState;
+/** New state when a send fails — drops the optimistic message and classifies
+ * the error. */
+export declare function sendStateOnError(error: unknown): SendState;
+/**
+ * Answer an agent question through the session's runtime and drop it from
+ * local pending state — but only once the server has actually accepted the
+ * reply. On failure the question stays pending and a `KortixSendError` is
+ * thrown.
+ */
+export declare function answerQuestion(requestId: string, answers: string[][]): Promise<void>;
+/** Reject an agent question through the session's runtime (see `answerQuestion`). */
+export declare function rejectQuestion(requestId: string): Promise<void>;
+/** Answer an agent permission request through the session's runtime (see `answerQuestion`). */
+export declare function answerPermission(requestId: string, reply: 'once' | 'always' | 'reject', message?: string): Promise<void>;
+export interface UseSessionOptions {
+    /** Long-poll budget (ms) the client requests on `/start`; the server clamps it. */
+    waitMs?: number;
+    /**
+     * Replay a stashed first message (prompt + model + agent from the "new session"
+     * screen) once the runtime is ready and the thread is empty. Default true. Hosts
+     * with their own first-message hand-off (e.g. apps/web) set this false.
+     */
+    replayStartStash?: boolean;
+    /**
+     * Gate the whole hook (the /start poll + switch + SSE). Default true. Set false
+     * to hold off until a precondition is met (e.g. a billing gate resolves) — mirrors
+     * a query `enabled` flag.
+     */
+    enabled?: boolean;
+    /**
+     * Mount the chat-consumption engine — `useSessionSync` (messages/status/diffs/
+     * todos, including its 10s busy-poll SSE-stall fallback) and `useQuestionSelfHeal`
+     * (the 2s missed-`question.asked` self-heal poll) — on top of the boot/lifecycle
+     * machinery every host needs. Default true.
+     *
+     * Set this false when the host mounts its OWN chat surface for the same
+     * `(projectId, sessionId)` (e.g. apps/web's `SessionChat`, which has its own
+     * `useSessionSync` + `useQuestionSelfHeal`): with two callers of `useSession`
+     * alive for the same session — this hook (for boot/lifecycle) and the host's
+     * chat component — leaving it `true` would double-mount both pollers, running
+     * the question self-heal poll twice and the busy-poll fallback at ~2x cadence
+     * for no benefit, since nothing reads this hook's chat fields anyway.
+     *
+     * When `false`: `messages`/`diffs`/`todos` are empty arrays, `status` is the
+     * idle status, `isBusy`/`isLoading` are `false`, `questions`/`permissions` stay
+     * live (populated by SSE via the still-active event stream, just without the
+     * self-heal poll backstop), and `replayStartStash` is force-disabled (it reads
+     * the now-empty chat state, so it would never fire correctly). Everything the
+     * boot/lifecycle fields need — `start`/`switch`/`runtimePhase`/`sandbox`/`stage`/
+     * `opencodeSessionId` — is unaffected.
+     */
+    chatEngine?: boolean;
+}
+export declare function useSession(projectId: string, sessionId: string, options?: UseSessionOptions): {
+    projectId: string;
+    sessionId: string;
+    /** Canonical OpenCode root id, or null while resolving. */
+    opencodeSessionId: string | null;
+    messages: import("../state/sync-store.js").MessageWithParts[];
+    status: import("@opencode-ai/sdk/v2/types").SessionStatus;
+    questions: import("@opencode-ai/sdk/v2/types").QuestionRequest[];
+    permissions: import("@opencode-ai/sdk/v2/types").PermissionRequest[];
+    diffs: (Omit<import("@opencode-ai/sdk/v2/types").SnapshotFileDiff, "patch"> & {
+        patch?: string;
+        before?: string;
+        after?: string;
+    })[];
+    todos: import("@opencode-ai/sdk/v2/types").Todo[];
+    phase: SessionPhase;
+    /** Raw /start stage (provisioning|starting|ready|stopped|failed), for boot UI. */
+    stage: import("../platform/projects-client/index.js").SessionStartStage | null;
+    /** The serialized session_sandboxes row from /start (status, metadata, ids), or null. */
+    sandbox: import("../platform/projects-client/index.js").ProjectSessionSandbox | null;
+    /** True once the runtime is switched in and ready (equivalent to phase==='ready'). */
+    switched: boolean;
+    /** Whether polling /start again can still make progress (false = terminal). */
+    retriable: boolean;
+    /** Terminal /start failure, for hosts to render instead of spinning forever. */
+    startError: import("../platform/projects-client/index.js").SessionStartError | null;
+    /** Granular boot phase (connecting|booting|ready|unreachable) for detailed UI. */
+    runtimePhase: import("./use-runtime-phase.js").RuntimePhase;
+    isBusy: boolean;
+    isLoading: boolean;
+    isError: boolean;
+    /** Whether there are open interactive prompts (questions/permissions). */
+    hasPending: boolean;
+    /** Latest /start reason (e.g. 'runtime_waking'), surfaced for boot/error UI. */
+    reason: string | null;
+    /** Pending optimistic message text, or null. */
+    pending: string | null;
+    /** True while the current `send` mutation is in flight. */
+    isSending: boolean;
+    /** Last `send` failure, typed (billing / runtime-not-ready / runtime-error),
+     * or null. Reset on every new `send` call. */
+    sendError: KortixSendError | null;
+    models: import("./model-flatten.js").FlatModel[];
+    agents: import("@opencode-ai/sdk/v2/types").Agent[];
+    defaultAgent: string | null;
+    commands: {
+        name: string;
+        path: string;
+        description: string | null;
+    }[];
+    picks: import("./use-session-picks.js").SessionPicks;
+    send: (text: string, override?: {
+        model?: ModelKey | null;
+        agent?: string | null;
+        variant?: string | null;
+    }) => void;
+    cancel: () => void;
+    runCommand: (command: string, args: string) => void;
+    /** Answer an agent question through the server and drop it from pending
+     * state on success; throws a `KortixSendError` and leaves it pending on
+     * failure. */
+    answerQuestion: typeof answerQuestion;
+    /** Reject an agent question through the server (see `answerQuestion`). */
+    rejectQuestion: typeof rejectQuestion;
+    /** Answer an agent permission request through the server (see `answerQuestion`). */
+    answerPermission: typeof answerPermission;
+    /** @deprecated Drops the question from local state WITHOUT replying to the
+     * server — the agent run stays blocked waiting on it. Use `answerQuestion`
+     * / `rejectQuestion` instead. */
+    removeQuestion: (requestId: string) => void;
+    /** @deprecated Drops the permission request from local state WITHOUT
+     * replying to the server — the agent run stays blocked waiting on it. Use
+     * `answerPermission` instead. */
+    removePermission: (requestId: string) => void;
+    /** Force a re-poll of /start (e.g. a Retry button on the boot screen). */
+    retry: () => void;
+};
+export type UseSessionResult = ReturnType<typeof useSession>;
+//# sourceMappingURL=use-session.d.ts.map

package/dist/react/use-session.d.ts.map

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