@kortix/sdk 0.13.4 → 0.13.7

package/dist/react/use-opencode-sessions/shared.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/shared.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,CAAC,CAuBJ;AAgBD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAC/C,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,YAAY,2BAA2B,CAAC;AAiBrD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE3E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/E;AAKD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,IAAI,MAAM,CAEjG;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAC"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/shared.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC;AAMD,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE;IAChC,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,GAAG,CAAC,CAuBJ;AAgBD,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAC/C,eAAO,MAAM,WAAW,0BAA0B,CAAC;AACnD,eAAO,MAAM,YAAY,2BAA2B,CAAC;AAiBrD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAE3E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAE/E;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,EAAE,CAEpD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,SAAS,CAGpF;AAKD,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,IAAI,MAAM,CAEjG;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAGjE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,WAAW,CAAC"}

package/dist/react/use-opencode-sessions/shared.js

@@ -90,6 +90,37 @@ export function getLSCache(family, scope) {
 export function setLSCache(family, value, scope) {
     cacheByFamily[family]?.set(scope ?? activeServerKey(), value);
 }
+// ============================================================================
+// Helper: shape guard for runtime LIST endpoints
+// ============================================================================
+/**
+ * Coerce a runtime list response to an array.
+ *
+ * The OpenCode REST types say `GET /command`, `GET /agent`, … return an array,
+ * but the value that actually arrives does not always agree: a daemon or proxy
+ * that answers a list route with an object body hands the caller a TRUTHY
+ * non-array. Consumers iterate the list (`for…of`, `.find`, `.some`,
+ * `.filter`), so that value does not degrade — it throws
+ * `TypeError: <x> is not iterable` inside a render and takes the whole session
+ * view down with it (dev, 2026-08-23). Normalize at the seam so an unexpected
+ * body reads as "no items" instead.
+ *
+ * This is the list-level twin of `detectCommandFromText`'s per-item
+ * `typeof cmd.template !== 'string'` guard in `apps/web`.
+ */
+export function asRuntimeList(value) {
+    return Array.isArray(value) ? value : [];
+}
+/**
+ * Read a localStorage-cached list for `placeholderData`. A cached value that is
+ * not an array reads as a MISS (`undefined`), exactly like a legacy-shaped
+ * entry — the query then simply refetches instead of painting a corrupt
+ * placeholder into the render.
+ */
+export function cachedRuntimeList(family, scope) {
+    const cached = getLSCache(family, scope);
+    return Array.isArray(cached) ? cached : undefined;
+}
 const PROJECT_SESSION_UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
 export function canQueryOpenCodeSession(sessionId) {
     return !!sessionId && !PROJECT_SESSION_UUID_RE.test(sessionId);

package/dist/react/use-opencode-sessions/shared.js.map

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

package/dist/react/use-opencode-sessions/vcs.d.ts

@@ -0,0 +1,28 @@
+import type { VcsFileDiff } from '@opencode-ai/sdk/v2/client';
+export type { VcsFileDiff };
+/**
+ * Which set of changes `/vcs/diff` describes.
+ *
+ * - `git` — the WORKING TREE only. Goes to zero the moment the agent commits.
+ * - `branch` — the working tree PLUS every commit this branch carries over the
+ *   repository's default branch. This is the "what has this version changed
+ *   that is not in main yet" set, and it is the one the Changes surface means.
+ */
+export type VcsDiffMode = 'git' | 'branch';
+/**
+ * The session's file changes, as ONE array with ONE query key.
+ *
+ * Every Changes surface (the tab badge, the header chip, the diff panel) must
+ * read this hook. React Query dedupes by key, so they cannot disagree: a badge
+ * reading "32" above a body reading "no changes yet" is not possible when both
+ * derive from the same cache entry.
+ *
+ * `session.diff` — the endpoint the diff panel used to read — answers a
+ * different question ("what did THIS user message change"), which is why a
+ * fresh session with no user message returned `[]` while `git status` reported
+ * a dirty tree.
+ */
+export declare function useOpenCodeVcsDiff(mode?: VcsDiffMode, options?: {
+    enabled?: boolean;
+}): import("@tanstack/react-query").UseQueryResult<NoInfer<VcsFileDiff[]>, Error>;
+//# sourceMappingURL=vcs.d.ts.map

package/dist/react/use-opencode-sessions/vcs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcs.d.ts","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/vcs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAS9D,YAAY,EAAE,WAAW,EAAE,CAAC;AAE5B;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,WAAsB,EAC5B,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,iFAsBhC"}

package/dist/react/use-opencode-sessions/vcs.js

@@ -0,0 +1,42 @@
+'use client';
+import { useQuery } from '@tanstack/react-query';
+import { getClient } from '../../core/runtime/client.js';
+import { useCurrentRuntime } from '../use-current-runtime.js';
+import { opencodeKeys, useOpenCodeRuntimeReady } from './keys.js';
+import { unwrap } from './shared.js';
+/**
+ * The session's file changes, as ONE array with ONE query key.
+ *
+ * Every Changes surface (the tab badge, the header chip, the diff panel) must
+ * read this hook. React Query dedupes by key, so they cannot disagree: a badge
+ * reading "32" above a body reading "no changes yet" is not possible when both
+ * derive from the same cache entry.
+ *
+ * `session.diff` — the endpoint the diff panel used to read — answers a
+ * different question ("what did THIS user message change"), which is why a
+ * fresh session with no user message returned `[]` while `git status` reported
+ * a dirty tree.
+ */
+export function useOpenCodeVcsDiff(mode = 'branch', options) {
+    const runtimeReady = useOpenCodeRuntimeReady();
+    // Subscribe to the active sandbox so the key recomputes the instant the
+    // runtime switches — session A's diff must never paint under session B.
+    const serverId = useCurrentRuntime((s) => s.sandboxId) ?? undefined;
+    return useQuery({
+        queryKey: opencodeKeys.vcsDiff(mode, serverId),
+        queryFn: async () => {
+            const client = getClient();
+            const result = await client.vcs.diff({ mode });
+            const data = unwrap(result);
+            return Array.isArray(data) ? data : [];
+        },
+        enabled: runtimeReady && options?.enabled !== false,
+        // Agent edits arrive as SSE events that invalidate `vcsDiffAll()`, so the
+        // panel does not depend on a poll; this only bounds refetch churn from
+        // remounts while a turn is running.
+        staleTime: 30_000,
+        gcTime: 5 * 60_000,
+        refetchOnWindowFocus: false,
+    });
+}
+//# sourceMappingURL=vcs.js.map

package/dist/react/use-opencode-sessions/vcs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vcs.js","sourceRoot":"","sources":["../../../src/react/use-opencode-sessions/vcs.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAIjD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAgBlC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAoB,QAAQ,EAC5B,OAA+B;IAE/B,MAAM,YAAY,GAAG,uBAAuB,EAAE,CAAC;IAC/C,wEAAwE;IACxE,wEAAwE;IACxE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC;IACpE,OAAO,QAAQ,CAAgB;QAC7B,QAAQ,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;QAC9C,OAAO,EAAE,KAAK,IAAI,EAAE;YAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;YAC3B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,CAAC;QACD,OAAO,EAAE,YAAY,IAAI,OAAO,EAAE,OAAO,KAAK,KAAK;QACnD,0EAA0E;QAC1E,uEAAuE;QACvE,oCAAoC;QACpC,SAAS,EAAE,MAAM;QACjB,MAAM,EAAE,CAAC,GAAG,MAAM;QAClB,oBAAoB,EAAE,KAAK;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/dist/react/use-poll-owner.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Does THIS component own the polling cadence for `scope`?
+ *
+ * TanStack schedules `refetchInterval` per OBSERVER, so N components mounting
+ * one query polled it N times over. Give the interval to the owner and `false`
+ * to everyone else: they all read the same cache entry, so an answer still
+ * reaches every one of them — only the scheduling is exclusive. See
+ * `core/session/poll-owner.ts` for the rules and the measurements.
+ *
+ * `enabled` is not a convenience. An observer that is not going to poll must
+ * not hold the cadence, or the session stops being polled at all.
+ */
+export declare function usePollOwner(scope: string, enabled?: boolean): boolean;
+//# sourceMappingURL=use-poll-owner.d.ts.map

package/dist/react/use-poll-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-poll-owner.d.ts","sourceRoot":"","sources":["../../src/react/use-poll-owner.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,OAAO,CAmBnE"}

package/dist/react/use-poll-owner.js

@@ -0,0 +1,32 @@
+'use client';
+import { useEffect, useId, useSyncExternalStore } from 'react';
+import { claimPoller, isPollOwner, releasePoller, subscribePollOwner, } from '../core/session/poll-owner.js';
+/**
+ * Does THIS component own the polling cadence for `scope`?
+ *
+ * TanStack schedules `refetchInterval` per OBSERVER, so N components mounting
+ * one query polled it N times over. Give the interval to the owner and `false`
+ * to everyone else: they all read the same cache entry, so an answer still
+ * reaches every one of them — only the scheduling is exclusive. See
+ * `core/session/poll-owner.ts` for the rules and the measurements.
+ *
+ * `enabled` is not a convenience. An observer that is not going to poll must
+ * not hold the cadence, or the session stops being polled at all.
+ */
+export function usePollOwner(scope, enabled = true) {
+    // Stable for the life of this component instance, and unique across
+    // instances — which is exactly the identity a claim needs.
+    const id = useId();
+    const active = enabled && !!scope;
+    useEffect(() => {
+        if (!active)
+            return;
+        claimPoller(scope, id);
+        return () => releasePoller(scope, id);
+    }, [active, scope, id]);
+    return useSyncExternalStore((onChange) => (active ? subscribePollOwner(scope, onChange) : () => { }), () => active && isPollOwner(scope, id), 
+    // On the server nothing polls, and rendering "not the owner" everywhere is
+    // the honest answer: no timer exists to own.
+    () => false);
+}
+//# sourceMappingURL=use-poll-owner.js.map

package/dist/react/use-poll-owner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-poll-owner.js","sourceRoot":"","sources":["../../src/react/use-poll-owner.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,oBAAoB,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EACL,WAAW,EACX,WAAW,EACX,aAAa,EACb,kBAAkB,GACnB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,OAAO,GAAG,IAAI;IACxD,oEAAoE;IACpE,2DAA2D;IAC3D,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,CAAC,KAAK,CAAC;IAElC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvB,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAExB,OAAO,oBAAoB,CACzB,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,EACvE,GAAG,EAAE,CAAC,MAAM,IAAI,WAAW,CAAC,KAAK,EAAE,EAAE,CAAC;IACtC,2EAA2E;IAC3E,6CAA6C;IAC7C,GAAG,EAAE,CAAC,KAAK,CACZ,CAAC;AACJ,CAAC"}

package/dist/react/use-project-llm-gateway.d.ts

@@ -0,0 +1,27 @@
+import { type ProjectDetail } from '../core/rest/projects-client/index.js';
+/**
+ * Pure predicate: the project's effective `llm_gateway` flag from a
+ * `getProjectDetail` response. `experimental` is the full effective flag map
+ * (explicit project choice over platform default, AND-gated on operator
+ * availability) — the same field `useOpenCodeProviders` forks provider
+ * loading on, so every gateway-gated query in this package answers from ONE
+ * source and can never disagree with the provider mode.
+ */
+export declare function projectDetailLlmGatewayEnabled(detail: ProjectDetail | undefined): boolean;
+/**
+ * The project's `llm_gateway` flag, for gating gateway-only queries
+ * (`/model-defaults`, `/model-picker`, gateway routing policy — all of which
+ * answer `404 llm_gateway_disabled` when the flag is off).
+ *
+ * `known` is false until the detail read settles: a gateway-only query must
+ * hold (not fire-and-404) while the answer is loading, and a caller that
+ * renders alternate native UI should wait for `known` before committing.
+ *
+ * Shares `qk.project.detail(id)` with every other detail reader, so this adds
+ * no request on pages that already load the project shell.
+ */
+export declare function useProjectLlmGatewayEnabled(projectId: string | null | undefined): {
+    enabled: boolean;
+    known: boolean;
+};
+//# sourceMappingURL=use-project-llm-gateway.d.ts.map

package/dist/react/use-project-llm-gateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-llm-gateway.d.ts","sourceRoot":"","sources":["../../src/react/use-project-llm-gateway.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIpF;;;;;;;GAOG;AACH,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAEzF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG;IACjF,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB,CAWA"}

package/dist/react/use-project-llm-gateway.js

@@ -0,0 +1,41 @@
+'use client';
+import { useQuery } from '@tanstack/react-query';
+import { getProjectDetail } from '../core/rest/projects-client/index.js';
+import { contract } from './query-contracts.js';
+import { qk } from './query-keys.js';
+/**
+ * Pure predicate: the project's effective `llm_gateway` flag from a
+ * `getProjectDetail` response. `experimental` is the full effective flag map
+ * (explicit project choice over platform default, AND-gated on operator
+ * availability) — the same field `useOpenCodeProviders` forks provider
+ * loading on, so every gateway-gated query in this package answers from ONE
+ * source and can never disagree with the provider mode.
+ */
+export function projectDetailLlmGatewayEnabled(detail) {
+    return detail?.project?.experimental?.llm_gateway === true;
+}
+/**
+ * The project's `llm_gateway` flag, for gating gateway-only queries
+ * (`/model-defaults`, `/model-picker`, gateway routing policy — all of which
+ * answer `404 llm_gateway_disabled` when the flag is off).
+ *
+ * `known` is false until the detail read settles: a gateway-only query must
+ * hold (not fire-and-404) while the answer is loading, and a caller that
+ * renders alternate native UI should wait for `known` before committing.
+ *
+ * Shares `qk.project.detail(id)` with every other detail reader, so this adds
+ * no request on pages that already load the project shell.
+ */
+export function useProjectLlmGatewayEnabled(projectId) {
+    const detailQuery = useQuery({
+        queryKey: qk.project.detail(projectId ?? ''),
+        queryFn: () => getProjectDetail(projectId),
+        enabled: !!projectId,
+        ...contract('config'),
+    });
+    return {
+        enabled: !!projectId && projectDetailLlmGatewayEnabled(detailQuery.data),
+        known: !projectId || detailQuery.isSuccess,
+    };
+}
+//# sourceMappingURL=use-project-llm-gateway.js.map

package/dist/react/use-project-llm-gateway.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-project-llm-gateway.js","sourceRoot":"","sources":["../../src/react/use-project-llm-gateway.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAsB,MAAM,8BAA8B,CAAC;AACpF,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAElC;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAAC,MAAiC;IAC9E,OAAO,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,KAAK,IAAI,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CAAC,SAAoC;IAI9E,MAAM,WAAW,GAAG,QAAQ,CAAC;QAC3B,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAC5C,OAAO,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,SAAmB,CAAC;QACpD,OAAO,EAAE,CAAC,CAAC,SAAS;QACpB,GAAG,QAAQ,CAAC,QAAQ,CAAC;KACtB,CAAC,CAAC;IACH,OAAO;QACL,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,8BAA8B,CAAC,WAAW,CAAC,IAAI,CAAC;QACxE,KAAK,EAAE,CAAC,SAAS,IAAI,WAAW,CAAC,SAAS;KAC3C,CAAC;AACJ,CAAC"}

package/dist/react/use-project-models.d.ts

@@ -1,3 +1,4 @@
+import type { ProjectLlmCatalogResponse } from '../core/rest/projects-client/index.js';
 import { type FlatModel } from './model-flatten.js';
 /**
  * Server-side model list for a project — the model parallel to
@@ -6,5 +7,13 @@ import { type FlatModel } from './model-flatten.js';
  * with correct provider/model ids. Works before any sandbox runtime exists and
  * avoids transferring or scanning the complete runtime models.dev catalog.
  */
+/**
+ * The raw `/model-picker` response for a project — the API's live catalog
+ * record per wire model (`reasoning_options`, `temperature`, `limit`, …), for
+ * a capability-gated control that needs more than the flattened list carries.
+ * Same query key + fetcher as `useProjectModels`, so both read one cache
+ * entry and one invalidation reaches both.
+ */
+export declare function useProjectModelPickerCatalog(projectId: string | null | undefined): ProjectLlmCatalogResponse | undefined;
 export declare function useProjectModels(projectId: string | null | undefined): FlatModel[];
 //# sourceMappingURL=use-project-models.d.ts.map

package/dist/react/use-project-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-project-models.d.ts","sourceRoot":"","sources":["../../src/react/use-project-models.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAKhE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAAE,CAalF"}
+{"version":3,"file":"use-project-models.d.ts","sourceRoot":"","sources":["../../src/react/use-project-models.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC9E,OAAO,EAAE,KAAK,SAAS,EAAiB,MAAM,iBAAiB,CAAC;AAMhE;;;;;;GAMG;AACH;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACnC,yBAAyB,GAAG,SAAS,CAUvC;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,SAAS,EAAE,CAiBlF"}

package/dist/react/use-project-models.js

@@ -6,6 +6,7 @@ import { flattenModels } from './model-flatten.js';
 import { projectLlmCatalogToProviderList } from './provider-selection.js';
 import { contract } from './query-contracts.js';
 import { qk } from './query-keys.js';
+import { useProjectLlmGatewayEnabled } from './use-project-llm-gateway.js';
 /**
  * Server-side model list for a project — the model parallel to
  * `useVisibleAgents({ projectId })`. Reads the compact, connection-aware picker
@@ -13,7 +14,29 @@ import { qk } from './query-keys.js';
  * with correct provider/model ids. Works before any sandbox runtime exists and
  * avoids transferring or scanning the complete runtime models.dev catalog.
  */
+/**
+ * The raw `/model-picker` response for a project — the API's live catalog
+ * record per wire model (`reasoning_options`, `temperature`, `limit`, …), for
+ * a capability-gated control that needs more than the flattened list carries.
+ * Same query key + fetcher as `useProjectModels`, so both read one cache
+ * entry and one invalidation reaches both.
+ */
+export function useProjectModelPickerCatalog(projectId) {
+    const gateway = useProjectLlmGatewayEnabled(projectId);
+    const { data } = useQuery({
+        queryKey: qk.project.modelPicker(projectId ?? ''),
+        queryFn: () => getProjectModelPicker(projectId),
+        enabled: !!projectId && gateway.enabled,
+        ...contract('config'),
+        retry: false,
+    });
+    return data;
+}
 export function useProjectModels(projectId) {
+    // `/model-picker` is a gateway route: with the project's llm_gateway flag
+    // off it answers 404 llm_gateway_disabled — never fetch. Native projects
+    // read models from the session runtime (`useOpenCodeProviders`).
+    const gateway = useProjectLlmGatewayEnabled(projectId);
     const { data } = useQuery({
         // Shared with `useModelEnablement` (same fetcher) and the routing-policy
         // save's invalidation (`gateway-routing.tsx`) — all three must key on the
@@ -21,7 +44,7 @@ export function useProjectModels(projectId) {
         // fails to reach this reader (see that member's doc comment).
         queryKey: qk.project.modelPicker(projectId ?? ''),
         queryFn: () => getProjectModelPicker(projectId),
-        enabled: !!projectId,
+        enabled: !!projectId && gateway.enabled,
         ...contract('config'),
         retry: false,
     });

package/dist/react/use-project-models.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-project-models.js","sourceRoot":"","sources":["../../src/react/use-project-models.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAoC;IACnE,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QACxB,yEAAyE;QACzE,0EAA0E;QAC1E,qEAAqE;QACrE,8DAA8D;QAC9D,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,SAAmB,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,SAAS;QACpB,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACnG,CAAC"}
+{"version":3,"file":"use-project-models.js","sourceRoot":"","sources":["../../src/react/use-project-models.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAkB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,2BAA2B,EAAE,MAAM,2BAA2B,CAAC;AAExE;;;;;;GAMG;AACH;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAC1C,SAAoC;IAEpC,MAAM,OAAO,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QACxB,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,SAAmB,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO;QACvC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAoC;IACnE,0EAA0E;IAC1E,yEAAyE;IACzE,iEAAiE;IACjE,MAAM,OAAO,GAAG,2BAA2B,CAAC,SAAS,CAAC,CAAC;IACvD,MAAM,EAAE,IAAI,EAAE,GAAG,QAAQ,CAAC;QACxB,yEAAyE;QACzE,0EAA0E;QAC1E,qEAAqE;QACrE,8DAA8D;QAC9D,QAAQ,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,SAAS,IAAI,EAAE,CAAC;QACjD,OAAO,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,SAAmB,CAAC;QACzD,OAAO,EAAE,CAAC,CAAC,SAAS,IAAI,OAAO,CAAC,OAAO;QACvC,GAAG,QAAQ,CAAC,QAAQ,CAAC;QACrB,KAAK,EAAE,KAAK;KACb,CAAC,CAAC;IACH,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;AACnG,CAAC"}

package/dist/react/use-runtime-reconnect.d.ts

@@ -72,6 +72,17 @@ export declare function shouldCountProbeFailure(input: {
     lastRuntimeEvidenceAt: number | null;
     nowMs: number;
 }): boolean;
+/**
+ * The one genuine runtime error a health body can carry.
+ *
+ * A cold boot answers `{status:'starting', reason:'schema not ready'}` (503) —
+ * `reason`/`message`/`status` are routine PROGRESS, not failures. Treating them
+ * as `store.runtimeError` painted a terminal "OpenCode runtime is not ready"
+ * card over a session that was simply booting (RC-1). Only `boot_error` — set
+ * by the daemon when a boot actually failed — is an error worth surfacing;
+ * everything else is null.
+ */
+export declare function runtimeErrorFromHealth(health: SessionHealthResponse | null): string | null;
 /** Statuses whose HTTP response itself signals "nothing is home" — no threshold needed. */
 export declare function isImmediateOfflineStatus(status: number): boolean;
 /**

package/dist/react/use-runtime-reconnect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-runtime-reconnect.d.ts","sourceRoot":"","sources":["../../src/react/use-runtime-reconnect.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAQL,KAAK,uBAAuB,EAC7B,MAAM,4CAA4C,CAAC;AAGpD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,0CAA0C;AAC1C,eAAO,MAAM,cAAc,QAAS,CAAC;AAMrC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,GAAG,EAAE,MAAM,GACV,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACrB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAIV;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CA0BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,EACrB,gBAAgB,EAAE,OAAO,GACxB,uBAAuB,GAAG,IAAI,CAOhC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAQ9F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,SAyKlC"}
+{"version":3,"file":"use-runtime-reconnect.d.ts","sourceRoot":"","sources":["../../src/react/use-runtime-reconnect.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,qBAAqB,EAC3B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAQL,KAAK,uBAAuB,EAC7B,MAAM,4CAA4C,CAAC;AAGpD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAE1C,0CAA0C;AAC1C,eAAO,MAAM,cAAc,QAAS,CAAC;AAMrC,eAAO,MAAM,YAAY,MAAM,CAAC;AAChC,eAAO,MAAM,gBAAgB,OAAQ,CAAC;AAEtC,eAAO,MAAM,aAAa,QAAS,CAAC;AAEpC;;;;;;;;GAQG;AACH,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,qBAAqB,EAAE,MAAM,GAAG,IAAI,EACpC,GAAG,EAAE,MAAM,GACV,OAAO,CAGT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACrB,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAIV;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAE1F;AAED,2FAA2F;AAC3F,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9E;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,GACtB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,GACzD;IACE,IAAI,EAAE,SAAS,CAAC;IAChB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mEAAmE;IACnE,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC;IACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B,GACD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;CAAE,CAAC;AAE9D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb;;;;;;OAMG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CA0BzE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,OAAO,EACrB,gBAAgB,EAAE,OAAO,GACxB,uBAAuB,GAAG,IAAI,CAOhC;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,MAAM,CAQ9F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,SA0LlC"}

package/dist/react/use-runtime-reconnect.js

@@ -87,6 +87,19 @@ export function shouldCountProbeFailure(input) {
         return false;
     return true;
 }
+/**
+ * The one genuine runtime error a health body can carry.
+ *
+ * A cold boot answers `{status:'starting', reason:'schema not ready'}` (503) —
+ * `reason`/`message`/`status` are routine PROGRESS, not failures. Treating them
+ * as `store.runtimeError` painted a terminal "OpenCode runtime is not ready"
+ * card over a session that was simply booting (RC-1). Only `boot_error` — set
+ * by the daemon when a boot actually failed — is an error worth surfacing;
+ * everything else is null.
+ */
+export function runtimeErrorFromHealth(health) {
+    return health?.boot_error ?? null;
+}
 /** Statuses whose HTTP response itself signals "nothing is home" — no threshold needed. */
 export function isImmediateOfflineStatus(status) {
     return status === 502 || status === 503 || status === 504;
@@ -251,8 +264,23 @@ export function useRuntimeReconnect() {
                     }
                     case 'booting': {
                         resetSandboxFail();
-                        setSandboxStatus('connected');
-                        setOpenCodeHealth(false, outcome.health?.version, outcome.health?.boot_error ?? outcome.health?.message ?? outcome.health?.reason ?? null);
+                        // A 503 the proxy attributes to `control_plane` was answered from
+                        // the session row without dialling the box: the sandbox is PARKED
+                        // (stopped/queued), not "OpenCode booting behind a live proxy". It
+                        // resumes only on the next SEND, so it must not be reported as
+                        // `connected`, and its stall clock must stay off (RC-3) — otherwise
+                        // the idle session escalates to "taking longer than usual" forever.
+                        const parked = result.hop === 'control_plane';
+                        if (parked) {
+                            setOpenCodeHealth(false, outcome.health?.version, null, { parked: true });
+                        }
+                        else {
+                            setSandboxStatus('connected');
+                            // Only a real `boot_error` is an error; the routine boot `reason`
+                            // ("schema not ready") is progress and must not paint a terminal
+                            // card (RC-1). See `runtimeErrorFromHealth`.
+                            setOpenCodeHealth(false, outcome.health?.version, runtimeErrorFromHealth(outcome.health));
+                        }
                         break;
                     }
                     case 'failure': {
@@ -264,7 +292,10 @@ export function useRuntimeReconnect() {
                     case 'healthy': {
                         resetSandboxFail();
                         setSandboxStatus('connected');
-                        setOpenCodeHealth(isRuntimeReady(outcome.health), outcome.health?.version, outcome.health?.boot_error ?? outcome.health?.message ?? outcome.health?.reason ?? null);
+                        // Same rule as the booting branch: a `200` that is not yet ready
+                        // still carries only routine progress in `reason`/`message`; only a
+                        // real `boot_error` is an error (RC-1).
+                        setOpenCodeHealth(isRuntimeReady(outcome.health), outcome.health?.version, runtimeErrorFromHealth(outcome.health));
                         break;
                     }
                 }

package/dist/react/use-runtime-reconnect.js.map

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

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

@@ -23,8 +23,19 @@ export declare const SESSION_PROMPTS_POLL_MS = 1000;
 /** The floor for an EMPTY list. Slow enough to be free, fast enough that a
  *  prompt handed back by the server appears while the user is still looking. */
 export declare const SESSION_PROMPTS_IDLE_POLL_MS = 15000;
-/** The cadence for a list of `count` prompts. Pure, so the floor is testable. */
-export declare function sessionPromptsPollMs(count: number, pollMs?: number): number;
+/**
+ * The cadence for a list of `count` prompts. Pure, so the floor is testable.
+ *
+ * `believedPending` is what this TAB thinks is in flight — the row
+ * `notePromptAccepted` recorded when `POST .../prompts` returned, before any
+ * list read could see it. It counts toward the cadence because the belief is an
+ * observation with a life (`INBOX_OBSERVATION_MAX_MS`) and only a list read
+ * refreshes it: a first read that landed before the row existed answered zero,
+ * locked the cadence to the 15s idle floor, and let a 10s belief die under a
+ * prompt that was still queued. The list length alone cannot close that hole,
+ * because at that instant the list is honestly empty.
+ */
+export declare function sessionPromptsPollMs(count: number, pollMs?: number, believedPending?: number): number;
 /**
  * Feed one reading of the list into the working projection.
  *
@@ -35,7 +46,22 @@ export declare function sessionPromptsPollMs(count: number, pollMs?: number): nu
  * — swapping Stop back to Send while the user's prompt was still queued. The
  * stamp is the instant the read was ISSUED, for the same reason `/turn`'s is.
  */
-export declare function noteInboxObservation(sessionId: string, prompts: readonly SessionPrompt[], atMs: number): void;
+export declare function noteInboxObservation(sessionId: string, prompts: readonly SessionPrompt[], atMs: number, serverAtMs?: number): void;
+/**
+ * Apply one server inbox snapshot to both projections, with one freshness rule.
+ *
+ * A direct read and the session stream can settle out of order. Updating the
+ * working projection through `noteInboxObservation` already rejected an older
+ * answer, but updating the React Query cache did not. That split let an old
+ * empty control frame hide a prompt that a newer POST/read had confirmed.
+ *
+ * `atMs` is this tab's clock (age); `serverAtMs` is the server's `observed_at`
+ * (ordering). Snapshots that both carry a server stamp rank on the server clock
+ * alone — `inboxObservationSupersedes` — so a read issued before a POST can
+ * never erase the row the POST confirmed, and a client clock ±10 minutes off
+ * changes nothing.
+ */
+export declare function applyInboxObservation(sessionId: string, cached: readonly SessionPrompt[] | undefined, prompts: readonly SessionPrompt[], atMs: number, serverAtMs?: number): SessionPrompt[];
 export declare const OPTIMISTIC_PROMPT_PREFIX = "optimistic:";
 /** Is this row the tab's own echo, not yet confirmed by the server? */
 export declare function isOptimisticSessionPrompt(prompt: Pick<SessionPrompt, 'prompt_id'>): boolean;
@@ -57,6 +83,30 @@ export declare function removeOptimisticPrompt(prompts: readonly SessionPrompt[]
  * its submission yet (the POST is still in flight).
  */
 export declare function reconcileOptimisticPrompts(cached: readonly SessionPrompt[] | undefined, server: readonly SessionPrompt[]): SessionPrompt[];
+/**
+ * One read of a session's inbox — and the refusal that keeps a project-scoped
+ * URL from ever being built for a session that has no project.
+ *
+ * Not every session has one. A sub-session (the "Agent · general: …" panel
+ * `SubSessionModal` opens over the transcript) is a local OpenCode child:
+ * `SessionChat` renders it with a `sessionId` and nothing else — no project id,
+ * no project session id — and there is no server-side inbox to read. Both ids
+ * are then genuinely `undefined`, and `listSessionPrompts` interpolates them
+ * into its path as the literal text: `GET
+ * /projects/undefined/sessions/undefined/prompts` → 400 `Invalid session id`,
+ * which the host's `onError` sink turns into a red toast beside a sub-agent
+ * that is streaming perfectly.
+ *
+ * The hook's `enabled` flag does not stop it on its own. `enabled` governs
+ * react-query's SCHEDULING; `QueryObserver.refetch()` goes straight to
+ * `query.fetch()` with no `enabled` check, and `session-chat.tsx` refetches the
+ * inbox on every new user bubble — exactly what a streaming sub-agent produces.
+ * So the refusal belongs here, on the read itself.
+ *
+ * `cached` is this tab's current rows: with no project there is nothing to
+ * reconcile against, and the optimistic rows already on screen stay on screen.
+ */
+export declare function readSessionPromptsInbox(projectId: string | undefined, sessionId: string | undefined, cached: readonly SessionPrompt[] | undefined): Promise<SessionPrompt[]>;
 export interface UseSessionPromptsResult {
     prompts: SessionPrompt[];
     isLoading: boolean;

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

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