@kortix/sdk 0.9.98

package/dist/react/provider-refresh.d.ts

@@ -0,0 +1,7 @@
+import type { QueryClient } from '@tanstack/react-query';
+type RefreshProjectProviderStateOptions = {
+    removeProjectScopedCache?: boolean;
+};
+export declare function refreshProjectProviderState(queryClient: QueryClient, projectId: string, opts?: RefreshProjectProviderStateOptions): void;
+export {};
+//# sourceMappingURL=provider-refresh.d.ts.map

package/dist/react/provider-refresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-refresh.d.ts","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAKzD,KAAK,kCAAkC,GAAG;IACxC,wBAAwB,CAAC,EAAE,OAAO,CAAC;CACpC,CAAC;AAEF,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,kCAAuC,GAC5C,IAAI,CAuBN"}

package/dist/react/provider-refresh.js

@@ -0,0 +1,28 @@
+'use client';
+import { configKeys } from './use-opencode-config.js';
+import { clearProjectProviderCache, opencodeKeys } from './use-opencode-sessions/index.js';
+export function refreshProjectProviderState(queryClient, projectId, opts = {}) {
+    const projectProviderKey = ['project-providers', projectId];
+    clearProjectProviderCache(projectId);
+    if (opts.removeProjectScopedCache) {
+        queryClient.removeQueries({ queryKey: projectProviderKey });
+    }
+    queryClient.invalidateQueries({ queryKey: projectProviderKey });
+    queryClient.invalidateQueries({ queryKey: ['project-secrets', projectId] });
+    queryClient.invalidateQueries({ queryKey: opencodeKeys.providers() });
+    queryClient.invalidateQueries({ queryKey: configKeys.all });
+    // Saving provider credentials hot-pushes env vars into active sandboxes and
+    // restarts OpenCode. A single immediate refetch can race that restart and
+    // accept the old native provider list as final, so follow up a few times.
+    if (typeof window === 'undefined')
+        return;
+    for (const delay of [500, 1500, 3000, 6000]) {
+        window.setTimeout(() => {
+            void queryClient.invalidateQueries({ queryKey: projectProviderKey });
+            void queryClient.invalidateQueries({ queryKey: ['project-secrets', projectId] });
+            void queryClient.refetchQueries({ queryKey: ['project-secrets', projectId], type: 'all' });
+            void queryClient.refetchQueries({ queryKey: projectProviderKey, type: 'active' });
+        }, delay);
+    }
+}
+//# sourceMappingURL=provider-refresh.js.map

package/dist/react/provider-refresh.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-refresh.js","sourceRoot":"","sources":["../../src/react/provider-refresh.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAIb,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMlF,MAAM,UAAU,2BAA2B,CACzC,WAAwB,EACxB,SAAiB,EACjB,OAA2C,EAAE;IAE7C,MAAM,kBAAkB,GAAG,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;IAC5D,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAClC,WAAW,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAC9D,CAAC;IACD,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAChE,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC5E,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACtE,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC;IAE5D,4EAA4E;IAC5E,0EAA0E;IAC1E,0EAA0E;IAC1E,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE;YACrB,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACrE,KAAK,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;YACjF,KAAK,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YAC3F,KAAK,WAAW,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpF,CAAC,EAAE,KAAK,CAAC,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/react/provider-selection.d.ts

@@ -0,0 +1,31 @@
+import type { ProviderListResponse as SdkProviderListResponse } from '@opencode-ai/sdk/v2/client';
+import type { ProjectLlmCatalogResponse } from '../platform/projects-client/index.js';
+export type ProviderListResponse = SdkProviderListResponse;
+/**
+ * Provider → credential env-var mapping, derived from the shared models.dev
+ * catalog. Mirrors the `{ id, envVars }` projection of the web's `LLM_PROVIDERS`
+ * (which is itself built from the same catalog), so connection inference is
+ * identical without depending on the web-only provider-modal catalog module.
+ */
+export declare const LLM_PROVIDER_CREDENTIALS: Array<{
+    id: string;
+    envVars: string[];
+}>;
+export declare const GATEWAY_PROVIDER_IDS: Set<string>;
+export declare function normalizeProviderList(providers: ProviderListResponse): ProviderListResponse;
+/**
+ * True when a provider-list response actually carries usable models — i.e. at
+ * least one CONNECTED provider that exposes >=1 model. A response failing this
+ * is a transient boot state, not a real answer.
+ */
+export declare function providerListHasModels(providers: ProviderListResponse | undefined): boolean;
+export declare function providerListHasGateway(providers: ProviderListResponse | undefined): boolean;
+export declare function filterToGatewayProviders(providers: ProviderListResponse): ProviderListResponse;
+export declare function filterToNativeProviders(providers: ProviderListResponse): ProviderListResponse;
+export declare function mergeProjectSecretConnectedProviders(providers: ProviderListResponse, secretNames: Set<string>, providerCredentials: Array<{
+    id: string;
+    envVars: string[];
+}>): ProviderListResponse;
+export declare function connectedGatewayProviderIdsFromSecretNames(secretNames: Set<string>): Set<string>;
+export declare function projectLlmCatalogToProviderList(catalog: ProjectLlmCatalogResponse): ProviderListResponse;
+//# sourceMappingURL=provider-selection.d.ts.map

package/dist/react/provider-selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-selection.d.ts","sourceRoot":"","sources":["../../src/react/provider-selection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,IAAI,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAGlG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG,uBAAuB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAIzE,CAAC;AAIN,eAAO,MAAM,oBAAoB,aAAsB,CAAC;AAGxD,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,oBAAoB,GAC9B,oBAAoB,CAiCtB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAY1F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,OAAO,CAM3F;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,GAAG,oBAAoB,CAS9F;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,oBAAoB,GAAG,oBAAoB,CAS7F;AAED,wBAAgB,oCAAoC,CAClD,SAAS,EAAE,oBAAoB,EAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,EACxB,mBAAmB,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,GAC5D,oBAAoB,CAwBtB;AAED,wBAAgB,0CAA0C,CACxD,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,GACvB,GAAG,CAAC,MAAM,CAAC,CAcb;AAED,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,yBAAyB,GACjC,oBAAoB,CAYtB"}

package/dist/react/provider-selection.js

@@ -0,0 +1,135 @@
+import { CATALOG } from '@kortix/llm-catalog';
+/**
+ * Provider → credential env-var mapping, derived from the shared models.dev
+ * catalog. Mirrors the `{ id, envVars }` projection of the web's `LLM_PROVIDERS`
+ * (which is itself built from the same catalog), so connection inference is
+ * identical without depending on the web-only provider-modal catalog module.
+ */
+export const LLM_PROVIDER_CREDENTIALS = CATALOG.providers.map((provider) => ({
+    id: provider.id,
+    envVars: provider.env ?? [],
+}));
+// In gateway mode OpenCode must see Kortix as the single LLM provider. Native
+// providers, including OpenCode Zen, belong only to native mode.
+export const GATEWAY_PROVIDER_IDS = new Set(['kortix']);
+const NATIVE_EXCLUDED_PROVIDER_IDS = new Set(['kortix']);
+export function normalizeProviderList(providers) {
+    const modernAll = Array.isArray(providers.all) ? providers.all : [];
+    const modernConnected = Array.isArray(providers.connected) ? providers.connected : [];
+    if (modernAll.length > 0 || modernConnected.length > 0) {
+        return {
+            ...providers,
+            all: modernAll,
+            connected: modernConnected,
+        };
+    }
+    // Legacy responses carried providers under `.providers` instead of `.all` —
+    // not part of the modern `ProviderListResponse` type, so duck-type via
+    // `unknown` rather than assume that (long-gone) legacy shape is still real.
+    const maybeLegacy = providers.providers;
+    const legacyProviders = Array.isArray(maybeLegacy)
+        ? maybeLegacy
+        : [];
+    if (legacyProviders.length === 0) {
+        return {
+            ...providers,
+            all: [],
+            connected: [],
+        };
+    }
+    return {
+        ...providers,
+        all: legacyProviders,
+        connected: legacyProviders.map((provider) => provider.id),
+    };
+}
+/**
+ * True when a provider-list response actually carries usable models — i.e. at
+ * least one CONNECTED provider that exposes >=1 model. A response failing this
+ * is a transient boot state, not a real answer.
+ */
+export function providerListHasModels(providers) {
+    if (!providers)
+        return false;
+    const normalized = normalizeProviderList(providers);
+    const all = Array.isArray(normalized.all) ? normalized.all : [];
+    const connected = Array.isArray(normalized.connected) ? normalized.connected : [];
+    if (connected.length === 0)
+        return false;
+    return all.some((p) => connected.includes(p.id) &&
+        p.models &&
+        Object.keys(p.models).length > 0);
+}
+export function providerListHasGateway(providers) {
+    if (!providers)
+        return false;
+    const normalized = normalizeProviderList(providers);
+    const all = Array.isArray(normalized.all) ? normalized.all : [];
+    const connected = Array.isArray(normalized.connected) ? normalized.connected : [];
+    return connected.includes('kortix') || all.some((p) => p.id === 'kortix');
+}
+export function filterToGatewayProviders(providers) {
+    const normalized = normalizeProviderList(providers);
+    const all = Array.isArray(normalized.all) ? normalized.all : [];
+    const connected = Array.isArray(normalized.connected) ? normalized.connected : [];
+    return {
+        ...normalized,
+        all: all.filter((p) => GATEWAY_PROVIDER_IDS.has(p.id)),
+        connected: connected.filter((id) => GATEWAY_PROVIDER_IDS.has(id)),
+    };
+}
+export function filterToNativeProviders(providers) {
+    const normalized = normalizeProviderList(providers);
+    const all = Array.isArray(normalized.all) ? normalized.all : [];
+    const connected = Array.isArray(normalized.connected) ? normalized.connected : [];
+    return {
+        ...normalized,
+        all: all.filter((p) => !NATIVE_EXCLUDED_PROVIDER_IDS.has(p.id)),
+        connected: connected.filter((id) => !NATIVE_EXCLUDED_PROVIDER_IDS.has(id)),
+    };
+}
+export function mergeProjectSecretConnectedProviders(providers, secretNames, providerCredentials) {
+    const normalized = normalizeProviderList(providers);
+    const all = Array.isArray(normalized.all) ? normalized.all : [];
+    const allIds = new Set(all.map((provider) => provider.id));
+    const connected = new Set(Array.isArray(normalized.connected) ? normalized.connected : []);
+    for (const provider of providerCredentials) {
+        if (allIds.has(provider.id) &&
+            provider.envVars.length > 0 &&
+            provider.envVars.every((envVar) => secretNames.has(envVar))) {
+            connected.add(provider.id);
+        }
+    }
+    if (allIds.has('codex') &&
+        (secretNames.has('CODEX_AUTH_JSON') || secretNames.has('OPENCODE_AUTH_JSON'))) {
+        connected.add('codex');
+    }
+    return { ...normalized, connected: [...connected] };
+}
+export function connectedGatewayProviderIdsFromSecretNames(secretNames) {
+    const ids = new Set();
+    for (const provider of LLM_PROVIDER_CREDENTIALS) {
+        if (provider.envVars.length > 0 &&
+            provider.envVars.every((envVar) => secretNames.has(envVar))) {
+            ids.add(provider.id);
+        }
+    }
+    if (secretNames.has('CODEX_AUTH_JSON') || secretNames.has('OPENCODE_AUTH_JSON')) {
+        ids.add('codex');
+    }
+    return ids;
+}
+export function projectLlmCatalogToProviderList(catalog) {
+    const models = catalog.models ?? {};
+    return {
+        default: { kortix: models.auto ? 'auto' : (Object.keys(models)[0] ?? 'auto') },
+        connected: ['kortix'],
+        all: [{
+                id: 'kortix',
+                name: 'Kortix',
+                source: 'gateway',
+                models,
+            }],
+    };
+}
+//# sourceMappingURL=provider-selection.js.map

package/dist/react/provider-selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-selection.js","sourceRoot":"","sources":["../../src/react/provider-selection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAM9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnC,EAAE,EAAE,QAAQ,CAAC,EAAE;IACf,OAAO,EAAE,QAAQ,CAAC,GAAG,IAAI,EAAE;CAC5B,CAAC,CAAC,CAAC;AAEN,8EAA8E;AAC9E,iEAAiE;AACjE,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AACxD,MAAM,4BAA4B,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEzD,MAAM,UAAU,qBAAqB,CACnC,SAA+B;IAE/B,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IACtF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO;YACL,GAAG,SAAS;YACZ,GAAG,EAAE,SAAS;YACd,SAAS,EAAE,eAAe;SAC3B,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,MAAM,WAAW,GAAI,SAAgD,CAAC,SAAS,CAAC;IAChF,MAAM,eAAe,GAA4D,KAAK,CAAC,OAAO,CAC5F,WAAW,CACZ;QACC,CAAC,CAAC,WAAW;QACb,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,GAAG,SAAS;YACZ,GAAG,EAAE,EAAE;YACP,SAAS,EAAE,EAAE;SACd,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,SAAS;QACZ,GAAG,EAAE,eAAe;QACpB,SAAS,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;KAClC,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAA2C;IAC/E,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,GAAG,CAAC,IAAI,CACb,CAAC,CAAC,EAAE,EAAE,CACJ,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QACxB,CAAC,CAAC,MAAM;QACR,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,SAA2C;IAChF,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,SAA+B;IACtE,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO;QACL,GAAG,UAAU;QACb,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtD,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,SAA+B;IACrE,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,OAAO;QACL,GAAG,UAAU;QACb,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC/D,SAAS,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,4BAA4B,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,SAA+B,EAC/B,WAAwB,EACxB,mBAA6D;IAE7D,MAAM,UAAU,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAE3F,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,IACE,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvB,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC3B,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC3D,CAAC;YACD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IACE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QACnB,CAAC,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC,EAC7E,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,GAAG,UAAU,EAAE,SAAS,EAAE,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,0CAA0C,CACxD,WAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,QAAQ,IAAI,wBAAwB,EAAE,CAAC;QAChD,IACE,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;YAC3B,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAC3D,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,WAAW,CAAC,GAAG,CAAC,iBAAiB,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,+BAA+B,CAC7C,OAAkC;IAElC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC;IACpC,OAAO;QACL,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE;QAC9E,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,GAAG,EAAE,CAAC;gBACJ,EAAE,EAAE,QAAQ;gBACZ,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,SAAS;gBACjB,MAAM;aACP,CAAC;KACgC,CAAC;AACvC,CAAC"}

package/dist/react/route-project.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from 'react';
+export declare function KortixProjectProvider(props: {
+    projectId: string | null;
+    children?: ReactNode;
+}): ReactNode;
+export declare function useKortixRouteProjectId(): string | null;
+//# sourceMappingURL=route-project.d.ts.map

package/dist/react/route-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-project.d.ts","sourceRoot":"","sources":["../../src/react/route-project.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAA4C,MAAM,OAAO,CAAC;AAajF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB,GAAG,SAAS,CAEZ;AAED,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD"}

package/dist/react/route-project.js

@@ -0,0 +1,19 @@
+'use client';
+import { createContext, createElement, useContext } from 'react';
+/**
+ * The route-scoped project id, injected by the host instead of read from a
+ * router. The SDK is router-agnostic: a Next host derives the id from
+ * `useParams()` and mounts `KortixProjectProvider` once near its root; native
+ * or CLI-driven hosts pass whatever their navigation state says. Hooks that
+ * need "the project the user is looking at" (`useOpenCodeProviders`,
+ * `useOpenCodeLocal`) read it via `useKortixRouteProjectId`, which yields
+ * `null` outside a project scope — the same as a non-project route.
+ */
+const KortixProjectContext = createContext(null);
+export function KortixProjectProvider(props) {
+    return createElement(KortixProjectContext.Provider, { value: props.projectId }, props.children);
+}
+export function useKortixRouteProjectId() {
+    return useContext(KortixProjectContext);
+}
+//# sourceMappingURL=route-project.js.map

package/dist/react/route-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-project.js","sourceRoot":"","sources":["../../src/react/route-project.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAkB,aAAa,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAEjF;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG,aAAa,CAAgB,IAAI,CAAC,CAAC;AAEhE,MAAM,UAAU,qBAAqB,CAAC,KAGrC;IACC,OAAO,aAAa,CAAC,oBAAoB,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,UAAU,CAAC,oBAAoB,CAAC,CAAC;AAC1C,CAAC"}

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

@@ -0,0 +1,56 @@
+/**
+ * Hand-off between a host's "new session" screen and the session workbench. The
+ * new-session UI collects {prompt, model, agent, variant} but the session
+ * runtime doesn't exist yet, so we stash them under the new session id;
+ * `useSession` replays them as the first message once the runtime is ready —
+ * that's how the chosen model/agent/variant apply to the opening turn. Owned by
+ * the SDK so the producer (new-session screen) and consumer (`useSession`)
+ * share one contract.
+ */
+import type { PromptPart } from './use-opencode-sessions/keys.js';
+export interface StartStash {
+    prompt: string;
+    model: {
+        providerID: string;
+        modelID: string;
+    } | null;
+    agent: string | null;
+    variant?: string | null;
+}
+export declare function startStashKey(sessionId: string): string;
+export declare function writeStartStash(sessionId: string, stash: StartStash): void;
+export declare function readStartStash(sessionId: string): StartStash | null;
+export declare function clearStartStash(sessionId: string): void;
+/**
+ * Migrate a stash — canonical or legacy shape — from one session-id namespace
+ * to another. Producers sometimes stash under an id that isn't the eventual
+ * OpenCode session id (e.g. a project's route id, before the canonical
+ * session exists); once a later render resolves the real id, this hands the
+ * stash off. Reads the source via {@link readStartStash} (so it understands
+ * both the canonical JSON shape and the bare-prompt legacy shape at
+ * `fromSessionId`), writes the canonical shape at `toSessionId` — skipping the
+ * write if `toSessionId` already has a stash — and always clears the source
+ * (both its canonical and legacy keys), whether or not there was anything to
+ * migrate.
+ */
+export declare function migrateStash(fromSessionId: string, toSessionId: string): void;
+/**
+ * Migrate a differently-keyed legacy hand-off (bare prompt string + optional
+ * `{agent,model,variant}` JSON options, each under their own arbitrary key)
+ * onto the canonical stash for `toSessionId`. Used by producers that predate
+ * this module and stash under arbitrary raw keys rather than a session-id
+ * namespace `readStartStash` can resolve on its own — prefer {@link
+ * migrateStash} for any producer that already writes under a session id via
+ * `writeStartStash`. The source keys are always cleared, whether or not there
+ * was anything to migrate.
+ */
+export declare function migrateLegacyStash(fromPromptKey: string, fromOptionsKey: string, toSessionId: string): void;
+export declare function forkDraftKey(sessionId: string): string;
+/** Stash a fork's prompt parts for the forked session to pick up as a draft.
+ * No-ops when there's nothing to stash. */
+export declare function writeForkDraft(sessionId: string, prompt: PromptPart[]): void;
+/** Read back a stashed fork draft, if any. Does not clear it — call
+ * `clearForkDraft` once consumed. */
+export declare function readForkDraft(sessionId: string): PromptPart[] | null;
+export declare function clearForkDraft(sessionId: string): void;
+//# sourceMappingURL=session-start-stash.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-start-stash.d.ts","sourceRoot":"","sources":["../../src/react/session-start-stash.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAI1E;AAkED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAQnE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAU7E;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,IAAI,CAwBN;AAaD,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;2CAC2C;AAC3C,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAK5E;AAED;qCACqC;AACrC,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,IAAI,CAQpE;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAItD"}

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

@@ -0,0 +1,202 @@
+export function startStashKey(sessionId) {
+    return `kortix:start:${sessionId}`;
+}
+export function writeStartStash(sessionId, stash) {
+    try {
+        sessionStorage.setItem(startStashKey(sessionId), JSON.stringify(stash));
+    }
+    catch { }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Legacy hand-off shape (pre-dates this module). apps/web had several
+// independent "new session" producers (dashboard, project workspace, legacy
+// composer) that stash a bare prompt string under `opencode_pending_prompt:<id>`
+// plus an optional `{ agent, model, variant }` JSON blob under
+// `opencode_pending_options:<id>` — instead of one JSON stash. Those call sites
+// are unchanged (out of scope for this migration); `readStartStash` /
+// `clearStartStash` understand both shapes so every existing producer keeps
+// working through the one shared contract.
+// ─────────────────────────────────────────────────────────────────────────────
+function legacyPromptKey(sessionId) {
+    return `opencode_pending_prompt:${sessionId}`;
+}
+function legacyOptionsKey(sessionId) {
+    return `opencode_pending_options:${sessionId}`;
+}
+function parseLegacyModel(value) {
+    if (!value)
+        return null;
+    if (typeof value === 'object') {
+        const obj = value;
+        if (typeof obj.providerID === 'string' && typeof obj.modelID === 'string') {
+            return { providerID: obj.providerID, modelID: obj.modelID };
+        }
+        return null;
+    }
+    if (typeof value === 'string') {
+        const idx = value.indexOf('/');
+        if (idx > 0 && idx < value.length - 1) {
+            return { providerID: value.slice(0, idx), modelID: value.slice(idx + 1) };
+        }
+    }
+    return null;
+}
+function readLegacyStash(sessionId) {
+    try {
+        const prompt = sessionStorage.getItem(legacyPromptKey(sessionId));
+        if (!prompt)
+            return null;
+        let agent = null;
+        let model = null;
+        let variant = null;
+        const raw = sessionStorage.getItem(legacyOptionsKey(sessionId));
+        if (raw) {
+            const parsed = JSON.parse(raw);
+            if (parsed?.agent)
+                agent = parsed.agent;
+            if (parsed?.model)
+                model = parseLegacyModel(parsed.model);
+            if (parsed?.variant)
+                variant = parsed.variant;
+        }
+        return { prompt, model, agent, variant };
+    }
+    catch {
+        return null;
+    }
+}
+function clearLegacyStash(sessionId) {
+    try {
+        sessionStorage.removeItem(legacyPromptKey(sessionId));
+        sessionStorage.removeItem(legacyOptionsKey(sessionId));
+    }
+    catch { }
+}
+export function readStartStash(sessionId) {
+    try {
+        const raw = sessionStorage.getItem(startStashKey(sessionId));
+        if (raw)
+            return JSON.parse(raw);
+    }
+    catch {
+        // fall through to the legacy shape
+    }
+    return readLegacyStash(sessionId);
+}
+export function clearStartStash(sessionId) {
+    try {
+        sessionStorage.removeItem(startStashKey(sessionId));
+    }
+    catch { }
+    clearLegacyStash(sessionId);
+}
+/**
+ * Migrate a stash — canonical or legacy shape — from one session-id namespace
+ * to another. Producers sometimes stash under an id that isn't the eventual
+ * OpenCode session id (e.g. a project's route id, before the canonical
+ * session exists); once a later render resolves the real id, this hands the
+ * stash off. Reads the source via {@link readStartStash} (so it understands
+ * both the canonical JSON shape and the bare-prompt legacy shape at
+ * `fromSessionId`), writes the canonical shape at `toSessionId` — skipping the
+ * write if `toSessionId` already has a stash — and always clears the source
+ * (both its canonical and legacy keys), whether or not there was anything to
+ * migrate.
+ */
+export function migrateStash(fromSessionId, toSessionId) {
+    if (fromSessionId === toSessionId)
+        return;
+    try {
+        if (!readStartStash(toSessionId)) {
+            const stash = readStartStash(fromSessionId);
+            if (stash)
+                writeStartStash(toSessionId, stash);
+        }
+    }
+    finally {
+        clearStartStash(fromSessionId);
+    }
+}
+/**
+ * Migrate a differently-keyed legacy hand-off (bare prompt string + optional
+ * `{agent,model,variant}` JSON options, each under their own arbitrary key)
+ * onto the canonical stash for `toSessionId`. Used by producers that predate
+ * this module and stash under arbitrary raw keys rather than a session-id
+ * namespace `readStartStash` can resolve on its own — prefer {@link
+ * migrateStash} for any producer that already writes under a session id via
+ * `writeStartStash`. The source keys are always cleared, whether or not there
+ * was anything to migrate.
+ */
+export function migrateLegacyStash(fromPromptKey, fromOptionsKey, toSessionId) {
+    try {
+        const prompt = sessionStorage.getItem(fromPromptKey);
+        if (prompt && !readStartStash(toSessionId)) {
+            let agent = null;
+            let model = null;
+            let variant = null;
+            const raw = sessionStorage.getItem(fromOptionsKey);
+            if (raw) {
+                const parsed = JSON.parse(raw);
+                if (parsed?.agent)
+                    agent = parsed.agent;
+                if (parsed?.model)
+                    model = parseLegacyModel(parsed.model);
+                if (parsed?.variant)
+                    variant = parsed.variant;
+            }
+            writeStartStash(toSessionId, { prompt, model, agent, variant });
+        }
+    }
+    catch {
+        // ignore — worst case the hand-off is dropped, never a crash
+    }
+    finally {
+        try {
+            sessionStorage.removeItem(fromPromptKey);
+            sessionStorage.removeItem(fromOptionsKey);
+        }
+        catch { }
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Fork-draft stash. A sibling hand-off to the start-stash above, but for the
+// "fork this message" flow: apps/web's session-chat stashes the forked
+// message's parts (text + file refs) under the NEW forked session's id so its
+// composer can pick them up as a pre-filled draft once it mounts. Previously
+// apps/web/session-chat.tsx and session-chat-input.tsx each independently
+// redefined the same `opencode_fork_prompt:<id>` key — unified here so both
+// (and any future host) share one contract. The storage key is unchanged for
+// back-compat with anything already stashed under it.
+// ─────────────────────────────────────────────────────────────────────────────
+export function forkDraftKey(sessionId) {
+    return `opencode_fork_prompt:${sessionId}`;
+}
+/** Stash a fork's prompt parts for the forked session to pick up as a draft.
+ * No-ops when there's nothing to stash. */
+export function writeForkDraft(sessionId, prompt) {
+    if (prompt.length === 0)
+        return;
+    try {
+        sessionStorage.setItem(forkDraftKey(sessionId), JSON.stringify(prompt));
+    }
+    catch { }
+}
+/** Read back a stashed fork draft, if any. Does not clear it — call
+ * `clearForkDraft` once consumed. */
+export function readForkDraft(sessionId) {
+    try {
+        const raw = sessionStorage.getItem(forkDraftKey(sessionId));
+        if (!raw)
+            return null;
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export function clearForkDraft(sessionId) {
+    try {
+        sessionStorage.removeItem(forkDraftKey(sessionId));
+    }
+    catch { }
+}
+//# sourceMappingURL=session-start-stash.js.map

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

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

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

@@ -0,0 +1,35 @@
+import { type Session } from './use-opencode-sessions/index.js';
+/**
+ * OpenCode ↔ Kortix session mapping — READ side.
+ *
+ * The mapping is now fully SERVER-OWNED: `POST /sessions/:id/start` (see
+ * openSession in apps/api) resolves + persists the canonical OpenCode root and
+ * returns the pin in its payload. This hook no longer creates/heals the pin from
+ * the client (the old client-side `ensure-opencode` mutation caused the
+ * "session replaced / data lost" drift). It just surfaces the pin:
+ *   1. the value /start handed us this render (`pinFromStart`), else
+ *   2. the persisted pin on the Kortix session row (`getProjectSession`).
+ *
+ * The OpenCode session list is still read (read-only) for ?oc deep-links and
+ * sidebar sub-session rendering.
+ */
+/** Back-compat no-op: the pin is server-owned now, so there's no client guard to
+ *  clear. Kept exported because the session page still calls it on teardown. */
+export declare function clearOpencodeEnsureGuard(): void;
+export interface CanonicalOpenCodeSession {
+    /** The authoritative pinned root id (server-managed), or null while resolving. */
+    rootSessionId: string | null;
+    /** The sandbox's live OpenCode session list (read-only) for ?oc + UI. */
+    sessions: Session[];
+    isLoading: boolean;
+    isError: boolean;
+    listed: boolean;
+    error: unknown;
+}
+export declare function useCanonicalOpenCodeSession(params: {
+    projectId: string;
+    sessionId: string;
+    /** The pin POST /start resolved server-side this render (preferred source). */
+    pinFromStart?: string | null;
+}): CanonicalOpenCodeSession;
+//# sourceMappingURL=use-canonical-opencode-session.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"use-canonical-opencode-session.d.ts","sourceRoot":"","sources":["../../src/react/use-canonical-opencode-session.ts"],"names":[],"mappings":"AAMA,OAAO,EAAuB,KAAK,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AAEH;gFACgF;AAChF,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,MAAM,WAAW,wBAAwB;IACvC,kFAAkF;IAClF,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yEAAyE;IACzE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,wBAAwB,CA6B3B"}

package/dist/react/use-canonical-opencode-session.js

@@ -0,0 +1,52 @@
+'use client';
+import { useQuery } from '@tanstack/react-query';
+import { getProjectSession } from '../platform/projects-client/index.js';
+import { useOpenCodeSessions } from './use-opencode-sessions/index.js';
+/**
+ * OpenCode ↔ Kortix session mapping — READ side.
+ *
+ * The mapping is now fully SERVER-OWNED: `POST /sessions/:id/start` (see
+ * openSession in apps/api) resolves + persists the canonical OpenCode root and
+ * returns the pin in its payload. This hook no longer creates/heals the pin from
+ * the client (the old client-side `ensure-opencode` mutation caused the
+ * "session replaced / data lost" drift). It just surfaces the pin:
+ *   1. the value /start handed us this render (`pinFromStart`), else
+ *   2. the persisted pin on the Kortix session row (`getProjectSession`).
+ *
+ * The OpenCode session list is still read (read-only) for ?oc deep-links and
+ * sidebar sub-session rendering.
+ */
+/** Back-compat no-op: the pin is server-owned now, so there's no client guard to
+ *  clear. Kept exported because the session page still calls it on teardown. */
+export function clearOpencodeEnsureGuard() {
+    /* no-op */
+}
+export function useCanonicalOpenCodeSession(params) {
+    const { projectId, sessionId, pinFromStart } = params;
+    const sessionsQuery = useOpenCodeSessions();
+    // The Kortix session row carries the authoritative, server-managed pin — used
+    // as a fallback when /start's value isn't in this render's props yet.
+    // The /start pin is authoritative on open, so only fall back to the persisted
+    // row pin when /start didn't hand us one THIS render — i.e. a deep-link refresh
+    // (no /start in flight yet) or the idle-stopped 'starting' window where the box
+    // reads active but the pin isn't resolved (pinFromStart null → query still runs).
+    // On a warm start pinFromStart is always present, so this saves a redundant
+    // round-trip that otherwise contends for connections during boot.
+    const projectSessionQuery = useQuery({
+        queryKey: ['project-session', projectId, sessionId],
+        queryFn: () => getProjectSession(projectId, sessionId, { showErrors: false }),
+        enabled: !!projectId && !!sessionId && !pinFromStart,
+        staleTime: 10_000,
+    });
+    const pin = projectSessionQuery.data?.opencode_session_id ?? null;
+    const rootSessionId = pinFromStart ?? pin ?? null;
+    return {
+        rootSessionId,
+        sessions: sessionsQuery.data ?? [],
+        isLoading: sessionsQuery.isLoading,
+        isError: sessionsQuery.isError,
+        listed: sessionsQuery.isSuccess,
+        error: sessionsQuery.error ?? null,
+    };
+}
+//# sourceMappingURL=use-canonical-opencode-session.js.map

package/dist/react/use-canonical-opencode-session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-canonical-opencode-session.js","sourceRoot":"","sources":["../../src/react/use-canonical-opencode-session.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAgB,MAAM,yBAAyB,CAAC;AAE5E;;;;;;;;;;;;;GAaG;AAEH;gFACgF;AAChF,MAAM,UAAU,wBAAwB;IACtC,WAAW;AACb,CAAC;AAaD,MAAM,UAAU,2BAA2B,CAAC,MAK3C;IACC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;IACtD,MAAM,aAAa,GAAG,mBAAmB,EAAE,CAAC;IAE5C,8EAA8E;IAC9E,sEAAsE;IACtE,8EAA8E;IAC9E,gFAAgF;IAChF,gFAAgF;IAChF,kFAAkF;IAClF,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,mBAAmB,GAAG,QAAQ,CAAC;QACnC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC;QACnD,OAAO,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC7E,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,YAAY;QACpD,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;IACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,IAAI,IAAI,CAAC;IAClE,MAAM,aAAa,GAAG,YAAY,IAAI,GAAG,IAAI,IAAI,CAAC;IAElD,OAAO;QACL,aAAa;QACb,QAAQ,EAAE,aAAa,CAAC,IAAI,IAAI,EAAE;QAClC,SAAS,EAAE,aAAa,CAAC,SAAS;QAClC,OAAO,EAAE,aAAa,CAAC,OAAO;QAC9B,MAAM,EAAE,aAAa,CAAC,SAAS;QAC/B,KAAK,EAAE,aAAa,CAAC,KAAK,IAAI,IAAI;KACnC,CAAC;AACJ,CAAC"}