@kortix/sdk 0.9.98

package/dist/platform/ui.js

@@ -0,0 +1,22 @@
+import { platformConfig } from './config.js';
+/**
+ * UI side-effect sink. The SDK fires these during event handling; the host wires
+ * them to its real toast / OS-notification surfaces via `configureKortix`. No
+ * UI components live in the SDK — these just forward to injected callbacks.
+ */
+export function infoToast(message, options) {
+    platformConfig().onToast?.('info', message, options);
+}
+export function notifyTaskComplete(sessionId, sessionTitle) {
+    platformConfig().onNotify?.({ kind: 'task-complete', sessionId, sessionTitle });
+}
+export function notifySessionError(sessionId, errorTitle, sessionTitle) {
+    platformConfig().onNotify?.({ kind: 'session-error', sessionId, errorTitle, sessionTitle });
+}
+export function notifyQuestion(sessionId, questionText, sessionTitle) {
+    platformConfig().onNotify?.({ kind: 'question', sessionId, questionText, sessionTitle });
+}
+export function notifyPermissionRequest(sessionId, toolName, sessionTitle) {
+    platformConfig().onNotify?.({ kind: 'permission', sessionId, toolName, sessionTitle });
+}
+//# sourceMappingURL=ui.js.map

package/dist/platform/ui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.js","sourceRoot":"","sources":["../../src/platform/ui.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE1C;;;;GAIG;AAEH,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,OAAiB;IAC1D,cAAc,EAAE,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,YAAqB;IACzE,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,UAAkB,EAClB,YAAqB;IAErB,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC,CAAC;AAC9F,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,YAAoB,EACpB,YAAqB;IAErB,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,CAAC,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,QAAgB,EAChB,YAAqB;IAErB,cAAc,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;AACzF,CAAC"}

package/dist/react/chat/index.d.ts

@@ -0,0 +1,3 @@
+export { useChatTurns, type TurnView } from './use-chat-turns.js';
+export { renderParts, type PartRenderers } from './render-parts.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/chat/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/react/chat/index.js

@@ -0,0 +1,7 @@
+'use client';
+// Headless chat bindings — `classifyTurn`/`classifyPart`-driven view models
+// for building custom chat UIs on top of `@kortix/sdk`. Re-exported from the
+// main `@kortix/sdk/react` barrel; no separate subpath needed.
+export { useChatTurns } from './use-chat-turns.js';
+export { renderParts } from './render-parts.js';
+//# sourceMappingURL=index.js.map

package/dist/react/chat/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/chat/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,4EAA4E;AAC5E,6EAA6E;AAC7E,+DAA+D;AAC/D,OAAO,EAAE,YAAY,EAAiB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAsB,MAAM,gBAAgB,CAAC"}

package/dist/react/chat/render-parts.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Generic, compile-time-exhaustive part -> T dispatcher.
+ *
+ * No React import — `T` is typically `ReactNode`, but this file stays
+ * framework-free (same reasoning as `classifyPart` itself) so a host isn't
+ * forced through React to use it. It lives under `react/chat/` because that's
+ * where the rest of the chat-rendering surface is, not because it needs React.
+ *
+ * `PartRenderers<T>` requires a renderer for every `ClassifiedPart['kind']`
+ * (an optional `fallback` covers `'unknown'`-only handling, or lets a host
+ * opt out of exhaustiveness during a migration) — TypeScript itself enforces
+ * that a host's switch-equivalent covers every part kind, closing the
+ * "silently drops subtask/patch/snapshot/agent/retry/compaction" bug class at
+ * the CALL site the same way `classifyPart` closes it at the classification
+ * site.
+ */
+import type { ClassifiedPart } from '../../turns/index.js';
+type PartOfKind<K extends ClassifiedPart['kind']> = Extract<ClassifiedPart, {
+    kind: K;
+}>;
+export type PartRenderers<T> = {
+    [K in ClassifiedPart['kind']]: (part: PartOfKind<K>) => T;
+} & {
+    /** Escape hatch: if provided, used instead of throwing for any kind whose
+     *  dedicated renderer is missing (only reachable if a caller constructs a
+     *  `PartRenderers<T>` with `Partial<...>` and casts — the type normally
+     *  requires every kind). */
+    fallback?: (part: ClassifiedPart) => T;
+};
+/**
+ * Render every classified part with its matching renderer, in order.
+ * Throws if a part's kind has no renderer AND no `fallback` was given —
+ * this should be unreachable given `PartRenderers<T>`'s type (every kind is
+ * required), so hitting it means the renderers object was built unsafely
+ * (e.g. via `as PartRenderers<T>`).
+ */
+export declare function renderParts<T>(parts: ClassifiedPart[], renderers: PartRenderers<T>): T[];
+export {};
+//# sourceMappingURL=render-parts.d.ts.map

package/dist/react/chat/render-parts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-parts.d.ts","sourceRoot":"","sources":["../../../src/react/chat/render-parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,KAAK,UAAU,CAAC,CAAC,SAAS,cAAc,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,cAAc,EAAE;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAAC,CAAC;AAEzF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI;KAC5B,CAAC,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;CAC1D,GAAG;IACF;;;gCAG4B;IAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAOxF"}

package/dist/react/chat/render-parts.js

@@ -0,0 +1,34 @@
+/**
+ * Generic, compile-time-exhaustive part -> T dispatcher.
+ *
+ * No React import — `T` is typically `ReactNode`, but this file stays
+ * framework-free (same reasoning as `classifyPart` itself) so a host isn't
+ * forced through React to use it. It lives under `react/chat/` because that's
+ * where the rest of the chat-rendering surface is, not because it needs React.
+ *
+ * `PartRenderers<T>` requires a renderer for every `ClassifiedPart['kind']`
+ * (an optional `fallback` covers `'unknown'`-only handling, or lets a host
+ * opt out of exhaustiveness during a migration) — TypeScript itself enforces
+ * that a host's switch-equivalent covers every part kind, closing the
+ * "silently drops subtask/patch/snapshot/agent/retry/compaction" bug class at
+ * the CALL site the same way `classifyPart` closes it at the classification
+ * site.
+ */
+/**
+ * Render every classified part with its matching renderer, in order.
+ * Throws if a part's kind has no renderer AND no `fallback` was given —
+ * this should be unreachable given `PartRenderers<T>`'s type (every kind is
+ * required), so hitting it means the renderers object was built unsafely
+ * (e.g. via `as PartRenderers<T>`).
+ */
+export function renderParts(parts, renderers) {
+    return parts.map((part) => {
+        const renderer = renderers[part.kind];
+        if (renderer)
+            return renderer(part);
+        if (renderers.fallback)
+            return renderers.fallback(part);
+        throw new Error(`renderParts: no renderer registered for part kind "${part.kind}"`);
+    });
+}
+//# sourceMappingURL=render-parts.js.map

package/dist/react/chat/render-parts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-parts.js","sourceRoot":"","sources":["../../../src/react/chat/render-parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAgBH;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAI,KAAuB,EAAE,SAA2B;IACjF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAA2C,CAAC;QAChF,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,SAAS,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,sDAAsD,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/react/chat/use-chat-turns.d.ts

@@ -0,0 +1,19 @@
+import type { ClassifiedPart, TurnError } from '../../turns/index.js';
+import type { MessageWithParts } from '../use-opencode-sessions/index.js';
+export interface TurnView {
+    /** The original message this view was classified from — kept around so a
+     *  host can still read `message.info.role`, `.id`, etc. without a second
+     *  lookup. */
+    message: MessageWithParts;
+    parts: ClassifiedPart[];
+    error?: TurnError;
+    isEmpty: boolean;
+}
+/**
+ * Classify every message in a session's message list into a `TurnView`.
+ * One `TurnView` per message (NOT per user/assistant turn-group — pair with
+ * `groupMessagesIntoTurns` from `@kortix/sdk/turns` first if a host wants
+ * grouped turns instead of a flat per-message list).
+ */
+export declare function useChatTurns(messages: MessageWithParts[]): TurnView[];
+//# sourceMappingURL=use-chat-turns.d.ts.map

package/dist/react/chat/use-chat-turns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-turns.d.ts","sourceRoot":"","sources":["../../../src/react/chat/use-chat-turns.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAEjE,MAAM,WAAW,QAAQ;IACvB;;kBAEc;IACd,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,QAAQ,EAAE,CASrE"}

package/dist/react/chat/use-chat-turns.js

@@ -0,0 +1,27 @@
+'use client';
+/**
+ * Headless React binding over `classifyTurn` (`@kortix/sdk/turns`) — the
+ * memoized, ready-to-render view model for a session's message list.
+ *
+ * Deliberately dumb: it holds no state of its own and renders nothing. A host
+ * passes it the same `messages` array `useSession()` returns; it hands back
+ * one `TurnView` per message, recomputed only when the `messages` reference
+ * changes (React Query / the sync store already give a stable reference
+ * between renders when nothing changed, so this is cheap in the steady
+ * state).
+ */
+import { useMemo } from 'react';
+import { classifyTurn } from '../../turns/index.js';
+/**
+ * Classify every message in a session's message list into a `TurnView`.
+ * One `TurnView` per message (NOT per user/assistant turn-group — pair with
+ * `groupMessagesIntoTurns` from `@kortix/sdk/turns` first if a host wants
+ * grouped turns instead of a flat per-message list).
+ */
+export function useChatTurns(messages) {
+    return useMemo(() => messages.map((message) => {
+        const { parts, error, isEmpty } = classifyTurn(message);
+        return { message, parts, error, isEmpty };
+    }), [messages]);
+}
+//# sourceMappingURL=use-chat-turns.js.map

package/dist/react/chat/use-chat-turns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-chat-turns.js","sourceRoot":"","sources":["../../../src/react/chat/use-chat-turns.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEhC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAa3C;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,QAA4B;IACvD,OAAO,OAAO,CACZ,GAAG,EAAE,CACH,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACvB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QACxD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC,EACJ,CAAC,QAAQ,CAAC,CACX,CAAC;AACJ,CAAC"}

package/dist/react/file-keys.d.ts

@@ -0,0 +1,18 @@
+/**
+ * React Query key factories for the workspace file/git caches. They live in the
+ * SDK so the live event stream can invalidate them when files change; the
+ * actual file-fetching hooks stay in the host app and import these keys.
+ */
+export declare const fileContentKeys: {
+    all: readonly ["opencode-files", "content"];
+    file: (serverUrl: string, filePath: string) => readonly ["opencode-files", "content", string, string];
+};
+export declare const fileListKeys: {
+    all: readonly ["opencode-files", "list"];
+    dir: (serverUrl: string, dirPath: string) => readonly ["opencode-files", "list", string, string];
+};
+export declare const gitStatusKeys: {
+    all: readonly ["opencode-files", "git-status"];
+    status: (serverUrl: string) => readonly ["opencode-files", "git-status", string];
+};
+//# sourceMappingURL=file-keys.d.ts.map

package/dist/react/file-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keys.d.ts","sourceRoot":"","sources":["../../src/react/file-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,eAAe;;sBAER,MAAM,YAAY,MAAM;CAE3C,CAAC;AAEF,eAAO,MAAM,YAAY;;qBAEN,MAAM,WAAW,MAAM;CAEzC,CAAC;AAEF,eAAO,MAAM,aAAa;;wBAEJ,MAAM;CAC3B,CAAC"}

package/dist/react/file-keys.js

@@ -0,0 +1,18 @@
+/**
+ * React Query key factories for the workspace file/git caches. They live in the
+ * SDK so the live event stream can invalidate them when files change; the
+ * actual file-fetching hooks stay in the host app and import these keys.
+ */
+export const fileContentKeys = {
+    all: ['opencode-files', 'content'],
+    file: (serverUrl, filePath) => ['opencode-files', 'content', serverUrl, filePath],
+};
+export const fileListKeys = {
+    all: ['opencode-files', 'list'],
+    dir: (serverUrl, dirPath) => ['opencode-files', 'list', serverUrl, dirPath],
+};
+export const gitStatusKeys = {
+    all: ['opencode-files', 'git-status'],
+    status: (serverUrl) => ['opencode-files', 'git-status', serverUrl],
+};
+//# sourceMappingURL=file-keys.js.map

package/dist/react/file-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keys.js","sourceRoot":"","sources":["../../src/react/file-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,GAAG,EAAE,CAAC,gBAAgB,EAAE,SAAS,CAAU;IAC3C,IAAI,EAAE,CAAC,SAAiB,EAAE,QAAgB,EAAE,EAAE,CAC5C,CAAC,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAU;CAC9D,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,CAAC,gBAAgB,EAAE,MAAM,CAAU;IACxC,GAAG,EAAE,CAAC,SAAiB,EAAE,OAAe,EAAE,EAAE,CAC1C,CAAC,gBAAgB,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAU;CAC1D,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,GAAG,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAU;IAC9C,MAAM,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,gBAAgB,EAAE,YAAY,EAAE,SAAS,CAAU;CACpF,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,12 @@
+export * from './opencode.js';
+export { answerQuestion, answerPermission, rejectQuestion, classifySendError, type KortixSendError, type KortixSendErrorKind, type SendState, } from './use-session.js';
+export { BillingError, RequestTooLargeError, parseBillingError, isBillingError, formatBillingErrorForUI, type BillingErrorUI, } from '../platform/api/errors.js';
+export { forkDraftKey, writeForkDraft, readForkDraft, clearForkDraft, } from './session-start-stash.js';
+export { openEventStream, type EventStreamClient, type EventStreamHandle, type EventStreamTimers, type OpenCodeEvent, type OpenEventStreamOptions, } from '../state/event-stream.js';
+export * from './use-kortix-master.js';
+export { useSessionSend, beginOptimisticSend, abandonOptimisticSend, recoverFromSendFailure, sendAndRecover, applyOptimisticAbort, replayStartStash, type OpenCodeMessagesClient, type SendRecoveryOptions, type SendAndRecoverArgs, type SendAndRecoverResult, type StashReplayTimerHandle, type StashReplayTimers, type PreparedStashSend, type StartStashReplayOptions, type StartStashReplayHandle, type UseSessionSendOptions, type SendCallOptions, type UseSessionSendResult, } from './use-session-send.js';
+export { useChatTurns, type TurnView, renderParts, type PartRenderers } from './chat/index.js';
+export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
+export { useProjectTriggers, projectTriggersKey } from './use-project-triggers.js';
+export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAC;AAI3B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,SAAS,GACf,MAAM,eAAe,CAAC;AAKvB,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,KAAK,cAAc,GACpB,MAAM,wBAAwB,CAAC;AAKhC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EACL,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAC;AAO/B,cAAc,qBAAqB,CAAC;AAMpC,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAOtF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,49 @@
+'use client';
+// @kortix/sdk/react — the complete OpenCode React hook surface, relocated
+// verbatim from apps/web (every useOpenCode* hook, query-key factory, provider,
+// and type). This is the single source of truth the web UI binds to.
+export * from './opencode.js';
+// `useSession`'s reply/error-classification surface — not (yet) re-exported by
+// `./opencode`'s explicit barrel list, so re-exported directly here.
+export { answerQuestion, answerPermission, rejectQuestion, classifySendError, } from './use-session.js';
+// The billing/API error classes + helpers, relocated from apps/web's
+// `lib/api/errors.ts` (byte-for-byte duplicate of `platform/api/errors.ts`) —
+// hosts import the one SDK copy instead of keeping a parallel fork in sync.
+export { BillingError, RequestTooLargeError, parseBillingError, isBillingError, formatBillingErrorForUI, } from '../platform/api/errors.js';
+// Fork-draft stash — see `session-start-stash.ts` for the full contract. Not
+// (yet) re-exported by `./opencode`'s explicit barrel list, so re-exported
+// directly here (same reasoning as the start-stash exports it lives beside).
+export { forkDraftKey, writeForkDraft, readForkDraft, clearForkDraft, } from './session-start-stash.js';
+// The framework-free SSE event-stream primitive that `useOpenCodeEventStream`
+// (exported above via `./opencode`) wraps. Re-exported here too so a host
+// already importing from `@kortix/sdk/react` can build its own binding
+// (e.g. a non-QueryClient consumer) without a second import from
+// `@kortix/sdk/event-stream`.
+export { openEventStream, } from '../state/event-stream.js';
+// The kortix-master React Query layer (tasks/tickets/projects/milestones/
+// credentials/sandbox-services) relocated from apps/web's six
+// `apps/web/src/hooks/{kortix/*,use-sandbox-services}.ts` files — see
+// `use-kortix-master.ts` for the full contract, including the injectable
+// `KortixMasterIdentity` seam that replaces web's direct `useAuth()` calls.
+export * from './use-kortix-master.js';
+// The send / stash-replay / error-recovery core extracted from apps/web's
+// `session-chat.tsx` — see `use-session-send.ts` for the full contract. Not
+// (yet) re-exported by `./opencode`'s explicit barrel list, so re-exported
+// directly here (same reasoning as the other direct re-exports above).
+export { useSessionSend, beginOptimisticSend, abandonOptimisticSend, recoverFromSendFailure, sendAndRecover, applyOptimisticAbort, replayStartStash, } from './use-session-send.js';
+// The headless chat kit — `useChatTurns` (memoized `classifyTurn` over a
+// message list) + `renderParts` (compile-time-exhaustive part -> T
+// dispatcher). Framework-free classification lives in `@kortix/sdk/turns`;
+// this is the thin React binding over it. Kept inside the `react` barrel
+// rather than a new `@kortix/sdk/react/chat` subpath — no package.json
+// exports-map change needed to reach it.
+export { useChatTurns, renderParts } from './chat/index.js';
+// Domain hooks — thin React Query bindings over `projects-client` CRUD
+// surfaces (secrets, triggers, change requests) that previously had no
+// SDK-owned hook (only the client fn). Each owns its own query key + the
+// mutations a settings/workbench screen actually needs, with invalidation
+// wired so writes reflect without a manual refetch.
+export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
+export { useProjectTriggers, projectTriggersKey } from './use-project-triggers.js';
+export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,0EAA0E;AAC1E,gFAAgF;AAChF,qEAAqE;AACrE,cAAc,YAAY,CAAC;AAE3B,+EAA+E;AAC/E,qEAAqE;AACrE,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,GAIlB,MAAM,eAAe,CAAC;AAEvB,qEAAqE;AACrE,8EAA8E;AAC9E,4EAA4E;AAC5E,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,GAExB,MAAM,wBAAwB,CAAC;AAEhC,6EAA6E;AAC7E,2EAA2E;AAC3E,6EAA6E;AAC7E,OAAO,EACL,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,GACf,MAAM,uBAAuB,CAAC;AAE/B,8EAA8E;AAC9E,0EAA0E;AAC1E,uEAAuE;AACvE,iEAAiE;AACjE,8BAA8B;AAC9B,OAAO,EACL,eAAe,GAMhB,MAAM,uBAAuB,CAAC;AAE/B,0EAA0E;AAC1E,8DAA8D;AAC9D,sEAAsE;AACtE,yEAAyE;AACzE,4EAA4E;AAC5E,cAAc,qBAAqB,CAAC;AAEpC,0EAA0E;AAC1E,4EAA4E;AAC5E,2EAA2E;AAC3E,uEAAuE;AACvE,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,qBAAqB,EACrB,sBAAsB,EACtB,cAAc,EACd,oBAAoB,EACpB,gBAAgB,GAajB,MAAM,oBAAoB,CAAC;AAE5B,yEAAyE;AACzE,mEAAmE;AACnE,2EAA2E;AAC3E,yEAAyE;AACzE,uEAAuE;AACvE,yCAAyC;AACzC,OAAO,EAAE,YAAY,EAAiB,WAAW,EAAsB,MAAM,QAAQ,CAAC;AAEtF,uEAAuE;AACvE,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,oDAAoD;AACpD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/react/model-flatten.d.ts

@@ -0,0 +1,33 @@
+import { type ProviderListResponse } from './use-opencode-sessions/index.js';
+/**
+ * Flat model list + the flattening logic (relocated from web's session-chat-input —
+ * it's data, not UI). Used by the model/agent resolution hooks.
+ */
+export interface FlatModel {
+    providerID: string;
+    providerName: string;
+    modelID: string;
+    modelName: string;
+    variants?: Record<string, Record<string, unknown>>;
+    /** Capabilities extracted from the provider API response */
+    capabilities?: {
+        reasoning?: boolean;
+        vision?: boolean;
+        toolcall?: boolean;
+    };
+    /** Context window size in tokens */
+    contextWindow?: number;
+    /** ISO date string for release date */
+    releaseDate?: string;
+    /** Model family (used for "latest" logic) */
+    family?: string;
+    /** Cost per token (input/output) */
+    cost?: {
+        input: number;
+        output: number;
+    };
+    /** Provider source (env, api, config, custom) */
+    providerSource?: string;
+}
+export declare function flattenModels(providers: ProviderListResponse | undefined): FlatModel[];
+//# sourceMappingURL=model-flatten.d.ts.map

package/dist/react/model-flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-flatten.d.ts","sourceRoot":"","sources":["../../src/react/model-flatten.ts"],"names":[],"mappings":"AACA,OAAO,EAAwB,KAAK,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AA6B1F;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,4DAA4D;IAC5D,YAAY,CAAC,EAAE;QACb,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,oCAAoC;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,CAAC,EAAE;QACL,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,SAAS,EAAE,CAiDtF"}

package/dist/react/model-flatten.js

@@ -0,0 +1,59 @@
+import { GATEWAY_PROVIDER_IDS } from './use-opencode-sessions/index.js';
+function hasCapabilities(model) {
+    return 'capabilities' in model && model.capabilities != null;
+}
+export function flattenModels(providers) {
+    if (!providers)
+        return [];
+    const all = Array.isArray(providers.all) ? providers.all : [];
+    const connected = Array.isArray(providers.connected) ? providers.connected : [];
+    const result = [];
+    for (const p of all) {
+        if (!connected.includes(p.id))
+            continue;
+        // Defense in depth: the provider list is already source-filtered to the
+        // gateway, but never render a native (bypass) provider even if one slips in.
+        if (!GATEWAY_PROVIDER_IDS.has(p.id))
+            continue;
+        for (const [modelID, model] of Object.entries(p.models)) {
+            // Narrow `model` itself (not a copy) so the loose-shape-only fields
+            // (`reasoning`, `tool_call`, `modalities`) are safe to read below.
+            let capabilities;
+            if (hasCapabilities(model)) {
+                const caps = model.capabilities;
+                capabilities = {
+                    reasoning: caps.reasoning ?? false,
+                    vision: caps.input?.image ?? false,
+                    toolcall: caps.toolcall ?? false,
+                };
+            }
+            else {
+                capabilities = {
+                    reasoning: model.reasoning ?? false,
+                    vision: model.modalities?.input?.includes('image') ?? false,
+                    toolcall: model.tool_call ?? false,
+                };
+            }
+            result.push({
+                providerID: p.id,
+                providerName: p.name,
+                modelID,
+                modelName: (model.name || modelID).replace('(latest)', '').trim(),
+                variants: model.variants,
+                capabilities,
+                contextWindow: model.limit?.context,
+                releaseDate: model.release_date,
+                family: model.family,
+                cost: model.cost
+                    ? {
+                        input: model.cost.input ?? 0,
+                        output: model.cost.output ?? 0,
+                    }
+                    : undefined,
+                providerSource: p.source,
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=model-flatten.js.map

package/dist/react/model-flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-flatten.js","sourceRoot":"","sources":["../../src/react/model-flatten.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAA6B,MAAM,yBAAyB,CAAC;AAyB1F,SAAS,eAAe,CAAC,KAAiB;IACxC,OAAO,cAAc,IAAI,KAAK,IAAI,KAAK,CAAC,YAAY,IAAI,IAAI,CAAC;AAC/D,CAAC;AAiCD,MAAM,UAAU,aAAa,CAAC,SAA2C;IACvE,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAChF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,SAAS;QACxC,wEAAwE;QACxE,6EAA6E;QAC7E,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,SAAS;QAC9C,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAgC,EAAE,CAAC;YACvF,oEAAoE;YACpE,mEAAmE;YACnE,IAAI,YAAuC,CAAC;YAC5C,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,CAAC;gBAChC,YAAY,GAAG;oBACb,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,KAAK;oBAClC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,IAAI,KAAK;oBAClC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,KAAK;iBACjC,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,YAAY,GAAG;oBACb,SAAS,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;oBACnC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK;oBAC3D,QAAQ,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;iBACnC,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU,EAAE,CAAC,CAAC,EAAE;gBAChB,YAAY,EAAE,CAAC,CAAC,IAAI;gBACpB,OAAO;gBACP,SAAS,EAAE,CAAC,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE;gBACjE,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,YAAY;gBACZ,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO;gBACnC,WAAW,EAAE,KAAK,CAAC,YAAY;gBAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;oBACd,CAAC,CAAC;wBACE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;wBAC5B,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;qBAC/B;oBACH,CAAC,CAAC,SAAS;gBACb,cAAc,EAAE,CAAC,CAAC,MAAM;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/react/opencode.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @kortix/sdk/react — OpenCode React hook surface.
+ *
+ * Barrel re-exporting EVERY hook, query-key factory, provider, and type from
+ * the ported `use-opencode-*` / `use-*` hook modules. The web UI imports these
+ * by exact name + return shape, so this file is the public contract — keep it
+ * exhaustive and in parity with the source hooks.
+ *
+ * The 4 cross-module duplicates (`McpStatus`, `useOpenCodeMcpStatus`,
+ * `ModelKey`, `useVisibleAgents`) are same-symbol re-exports (the secondary
+ * module re-exports the primary's binding), so the overlapping `export *`
+ * statements resolve to a single declaration with no ambiguity.
+ */
+export { KortixProjectProvider, useKortixRouteProjectId } from './route-project.js';
+export * from './use-opencode-sessions/index.js';
+export * from './use-opencode-events/index.js';
+export * from './use-opencode-local.js';
+export * from './use-opencode-mcp.js';
+export * from './use-opencode-pty.js';
+export * from './use-opencode-config.js';
+export * from './use-model-store.js';
+export * from './use-session-sync.js';
+export * from './use-runtime-reconnect.js';
+export { useOpenCodePendingStore } from '../state/opencode-pending-store.js';
+export { useSandboxConnectionStore, type SandboxConnectionStatus, } from '../state/sandbox-connection-store.js';
+export * from './use-session-prefetch.js';
+export { prefetchSessionStart } from './prefetch-session-start.js';
+export * from './use-canonical-opencode-session.js';
+export * from './use-gateway-catalog-sync.js';
+export * from './use-visible-agents.js';
+export * from './provider-refresh.js';
+export { flattenModels, type FlatModel } from './model-flatten.js';
+export { projectLlmCatalogToProviderList } from './provider-selection.js';
+export { useProjectModels } from './use-project-models.js';
+export { useProjectConfig } from './use-project-config.js';
+export type { ProjectConfigSummary } from '../platform/projects-client/index.js';
+export { useSession, type SessionPhase, type UseSessionResult, type UseSessionOptions, } from './use-session.js';
+export { useSessionPicks, type SessionPicks } from './use-session-picks.js';
+export { useRuntimePhase, type RuntimePhase } from './use-runtime-phase.js';
+export { useQuestionSelfHeal, hasRunningQuestionTool, type UseQuestionSelfHealOptions, } from './use-question-self-heal.js';
+export { usePermissionSelfHeal, findPermissionBlockedCandidate, hasActiveNonQuestionTool, type UsePermissionSelfHealOptions, } from './use-permission-self-heal.js';
+export { startStashKey, writeStartStash, readStartStash, clearStartStash, migrateStash, migrateLegacyStash, type StartStash, } from './session-start-stash.js';
+//# sourceMappingURL=opencode.d.ts.map

package/dist/react/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../src/react/opencode.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAsBH,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACjF,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AAsBnC,cAAc,yBAAyB,CAAC;AAKxC,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,yBAAyB,EACzB,KAAK,uBAAuB,GAC7B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AAGvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AAKnC,OAAO,EAAE,aAAa,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAQxE,OAAO,EACL,UAAU,EACV,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,GACvB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,KAAK,0BAA0B,GAChC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,EACxB,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,EAClB,KAAK,UAAU,GAChB,MAAM,uBAAuB,CAAC"}

package/dist/react/opencode.js

@@ -0,0 +1,100 @@
+'use client';
+/**
+ * @kortix/sdk/react — OpenCode React hook surface.
+ *
+ * Barrel re-exporting EVERY hook, query-key factory, provider, and type from
+ * the ported `use-opencode-*` / `use-*` hook modules. The web UI imports these
+ * by exact name + return shape, so this file is the public contract — keep it
+ * exhaustive and in parity with the source hooks.
+ *
+ * The 4 cross-module duplicates (`McpStatus`, `useOpenCodeMcpStatus`,
+ * `ModelKey`, `useVisibleAgents`) are same-symbol re-exports (the secondary
+ * module re-exports the primary's binding), so the overlapping `export *`
+ * statements resolve to a single declaration with no ambiguity.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// FINAL PUBLIC SURFACE (Phase 7). A new host should reach a session through ONE
+// hook — `useSession(projectId, sessionId)` — plus the pre-runtime capability
+// hooks (`useProjectModels` / `useVisibleAgents` / `useProjectConfig`) and the
+// primitives (`useSessionPicks` / `useRuntimePhase` / start-stash). The golden
+// reference (apps/whitelabel-demo) imports ONLY that surface — no `server-store`,
+// no `OpenCodeEventStreamProvider`, no `useCanonicalOpenCodeSession`, no raw
+// stores, no `getClient`.
+//
+// The lower-level exports below (`OpenCodeEventStreamProvider`,
+// `useCanonicalOpenCodeSession`, the sandbox-connection / sync / pending stores,
+// the per-sandbox session hooks) are now INTERNAL plumbing that `useSession`
+// composes. They remain exported ONLY because apps/web still consumes them
+// directly through its not-yet-migrated file/terminal/git hooks; once that
+// migration lands they come out of the public surface. New hosts: do not import
+// them — use `useSession`.
+// ─────────────────────────────────────────────────────────────────────────────
+// Router-agnostic route scope: the host injects "the project the user is
+// looking at" here (Next hosts derive it from useParams once, near the root);
+// `useOpenCodeProviders`/`useOpenCodeLocal` resolve it via this context.
+export { KortixProjectProvider, useKortixRouteProjectId } from './route-project.js';
+export * from './use-opencode-sessions/index.js';
+export * from './use-opencode-events/index.js';
+export * from './use-opencode-local.js';
+export * from './use-opencode-mcp.js';
+export * from './use-opencode-pty.js';
+export * from './use-opencode-config.js';
+export * from './use-model-store.js';
+export * from './use-session-sync.js';
+// Runtime health has three independent layers, each covering a failure mode
+// the others can't see — do not collapse them:
+//   1. Boot readiness is server-truth: `useSession`'s /start resolves
+//      `stage==='ready'` only once the backend reached the daemon and OpenCode
+//      answered, and seeds that straight into the connection store. No client
+//      poll is needed (or trustworthy) to *establish* the first connection.
+//   2. In-stream stalls are covered by the SSE heartbeat in
+//      `state/event-stream.ts` (`openEventStream`) — a 15s watchdog that
+//      forces a reconnect if no event arrives, so a stream that goes quiet
+//      recovers on its own.
+//   3. Neither of those promptly detects the runtime dying *mid-session* or a
+//      network partition: a dead sandbox's SSE connection can hang rather than
+//      error, and the heartbeat only fires once its own timeout elapses. That
+//      gap is what `useRuntimeReconnect` (`./use-runtime-reconnect`) closes —
+//      an independent liveness probe (`getSessionHealth`/`isRuntimeReady`)
+//      polled on its own cadence and written into the same connection store,
+//      so the reconnect/offline UI reacts even when the SSE stream itself
+//      never surfaces an error. The tradeoff: while healthy it only polls
+//      every 30s (`POLL_CONNECTED`), so a mid-session death can take up to
+//      ~30s to surface — traded against not hammering a healthy sandbox with a
+//      tight poll forever.
+export * from './use-runtime-reconnect.js';
+// The live pending-request store. The SSE event stream writes agent QUESTIONS
+// and PERMISSION requests here (keyed by request id, each carrying sessionID);
+// `useSessionSync` does NOT surface them, so a host that renders interactive
+// prompts must read them from this store.
+export { useOpenCodePendingStore } from '../state/opencode-pending-store.js';
+export { useSandboxConnectionStore, } from '../state/sandbox-connection-store.js';
+export * from './use-session-prefetch.js';
+// Relocated from `platform/projects-client/session-sandbox` — it types against
+// react-query's QueryClient, which the framework-free REST layer must not.
+export { prefetchSessionStart } from './prefetch-session-start.js';
+export * from './use-canonical-opencode-session.js';
+export * from './use-gateway-catalog-sync.js';
+export * from './use-visible-agents.js';
+export * from './provider-refresh.js';
+// Runtime-free model catalog → selectable model list. Lets a host build a model
+// picker BEFORE a session runtime exists (e.g. on a "new session" screen) by
+// feeding `project(id).llmCatalog()` through these, with correct provider/model
+// ids — no guessing the gateway-vs-BYOK key format.
+export { flattenModels } from './model-flatten.js';
+export { projectLlmCatalogToProviderList } from './provider-selection.js';
+export { useProjectModels } from './use-project-models.js';
+export { useProjectConfig } from './use-project-config.js';
+// ── The one-hook session surface ─────────────────────────────────────────────
+// `useSession(projectId, sessionId)` collapses the entire runtime dance (start →
+// switch → health → SSE → id-resolution → message sync) into a single hook so a
+// host never touches the sandbox. The primitives below are what it composes —
+// also exported standalone for hosts that want the pieces (a model picker, a boot
+// pill, the new-session hand-off) without a full session.
+export { useSession, } from './use-session.js';
+export { useSessionPicks } from './use-session-picks.js';
+export { useRuntimePhase } from './use-runtime-phase.js';
+export { useQuestionSelfHeal, hasRunningQuestionTool, } from './use-question-self-heal.js';
+export { usePermissionSelfHeal, findPermissionBlockedCandidate, hasActiveNonQuestionTool, } from './use-permission-self-heal.js';
+export { startStashKey, writeStartStash, readStartStash, clearStartStash, migrateStash, migrateLegacyStash, } from './session-start-stash.js';
+//# sourceMappingURL=opencode.js.map

package/dist/react/opencode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.js","sourceRoot":"","sources":["../../src/react/opencode.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;GAYG;AAEH,gFAAgF;AAChF,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,+EAA+E;AAC/E,kFAAkF;AAClF,6EAA6E;AAC7E,0BAA0B;AAC1B,EAAE;AACF,gEAAgE;AAChE,iFAAiF;AACjF,6EAA6E;AAC7E,2EAA2E;AAC3E,2EAA2E;AAC3E,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAChF,yEAAyE;AACzE,8EAA8E;AAC9E,yEAAyE;AACzE,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACjF,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,4EAA4E;AAC5E,+CAA+C;AAC/C,sEAAsE;AACtE,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,4DAA4D;AAC5D,yEAAyE;AACzE,2EAA2E;AAC3E,4BAA4B;AAC5B,8EAA8E;AAC9E,+EAA+E;AAC/E,8EAA8E;AAC9E,8EAA8E;AAC9E,2EAA2E;AAC3E,6EAA6E;AAC7E,0EAA0E;AAC1E,0EAA0E;AAC1E,2EAA2E;AAC3E,+EAA+E;AAC/E,2BAA2B;AAC3B,cAAc,yBAAyB,CAAC;AACxC,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,0CAA0C;AAC1C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EACL,yBAAyB,GAE1B,MAAM,mCAAmC,CAAC;AAC3C,cAAc,wBAAwB,CAAC;AACvC,+EAA+E;AAC/E,2EAA2E;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,gFAAgF;AAChF,6EAA6E;AAC7E,gFAAgF;AAChF,oDAAoD;AACpD,OAAO,EAAE,aAAa,EAAkB,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAC9E,kFAAkF;AAClF,0DAA0D;AAC1D,OAAO,EACL,UAAU,GAIX,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,eAAe,EAAqB,MAAM,qBAAqB,CAAC;AACzE,OAAO,EACL,mBAAmB,EACnB,sBAAsB,GAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,qBAAqB,EACrB,8BAA8B,EAC9B,wBAAwB,GAEzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,aAAa,EACb,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,EACZ,kBAAkB,GAEnB,MAAM,uBAAuB,CAAC"}

package/dist/react/prefetch-session-start.d.ts

@@ -0,0 +1,10 @@
+import type { QueryClient } from '@tanstack/react-query';
+/**
+ * Begin the session runtime boot DURING the route transition (before the session
+ * page mounts), so provisioning overlaps navigation instead of starting after the
+ * page paints. Idempotent + fire-and-forget: React Query dedupes against the
+ * session page's own query (same key), and `/start` is idempotent server-side.
+ * Also warms the route bundle. Use at every createProjectSession→navigate site.
+ */
+export declare function prefetchSessionStart(queryClient: QueryClient, projectId: string, sessionId: string): void;
+//# sourceMappingURL=prefetch-session-start.d.ts.map

package/dist/react/prefetch-session-start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-session-start.d.ts","sourceRoot":"","sources":["../../src/react/prefetch-session-start.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,IAAI,CAMN"}

package/dist/react/prefetch-session-start.js

@@ -0,0 +1,17 @@
+'use client';
+import { sessionStartKey, startProjectSession } from '../platform/projects-client/index.js';
+/**
+ * Begin the session runtime boot DURING the route transition (before the session
+ * page mounts), so provisioning overlaps navigation instead of starting after the
+ * page paints. Idempotent + fire-and-forget: React Query dedupes against the
+ * session page's own query (same key), and `/start` is idempotent server-side.
+ * Also warms the route bundle. Use at every createProjectSession→navigate site.
+ */
+export function prefetchSessionStart(queryClient, projectId, sessionId) {
+    void queryClient.prefetchQuery({
+        queryKey: sessionStartKey(projectId, sessionId),
+        queryFn: () => startProjectSession(projectId, sessionId),
+        staleTime: 0,
+    });
+}
+//# sourceMappingURL=prefetch-session-start.js.map

package/dist/react/prefetch-session-start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefetch-session-start.js","sourceRoot":"","sources":["../../src/react/prefetch-session-start.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAEnF;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,WAAwB,EACxB,SAAiB,EACjB,SAAiB;IAEjB,KAAK,WAAW,CAAC,aAAa,CAAC;QAC7B,QAAQ,EAAE,eAAe,CAAC,SAAS,EAAE,SAAS,CAAC;QAC/C,OAAO,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC;QACxD,SAAS,EAAE,CAAC;KACb,CAAC,CAAC;AACL,CAAC"}