@beeuni/sdk 0.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,62 @@
+export * from './use-prompt-attachments.js';
+export * from './use-project-starter-suggestions.js';
+export { useConnectorSetup, useConnectorLinkInfo, type ConnectorSetupOptions, type ConnectorSetupPhase, type ConnectorPopupOpener, } from './connector-setup.js';
+export { useConnectorQuery, type ConnectorQueryOptions } from './use-connector-query.js';
+export { resetIdentityState } from './reset-identity-state.js';
+export * from './opencode.js';
+export { useRuntimeSupports } from './use-runtime-supports.js';
+export { useSessionStreamConnected } from './use-session-stream.js';
+export { answerQuestion, answerPermission, rejectQuestion, classifySendError, type BeeuniSendError, type BeeuniSendErrorConnector, type BeeuniSendErrorKind, type SendState, } from './use-session.js';
+export { BillingError, RequestTooLargeError, parseBillingError, isBillingError, formatBillingErrorForUI, type BillingErrorUI, } from '../core/http/api/errors.js';
+export { openEventStream, type EventStreamClient, type EventStreamConnectionState, type EventStreamHandle, type EventStreamTimers, type OpenCodeEvent, type RuntimeEvent, type OpenEventStreamOptions, } from '../core/stream/event-stream.js';
+export * from './use-beeuni-master.js';
+export { useSessionSend, beginOptimisticSend, markOptimisticSendDispatched, markOptimisticSendInboxBacked, abandonOptimisticSend, recoverFromSendFailure, sendAndRecover, sendWithReceipt, stopWithReceipt, STOP_HOLD_DEADLINE_MS, applyOptimisticAbort, replayStartStash, type OpenCodeMessagesClient, type RuntimeMessagesClient, type SendWithReceiptArgs, type StopWithReceiptOptions, 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 { useAccounts, useProjects, accountsQueryOptions, projectsQueryOptions, type AccountsKey, type ProjectsKey, type UseAccountsOptions, type UseProjectsOptions, } from './use-accounts.js';
+export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
+export { useAccountSecretResources, useSessionProviderSecretPools } from './use-provider-secrets.js';
+export { useProjectTriggers, projectTriggersKey, useProjectTriggerEventTypes, useProjectTriggerEventApps, projectTriggerEventAppsKey, projectTriggerEventTypesKey, } from './use-project-triggers.js';
+export { useProjectReminders, useSessionReminders } from './use-reminders.js';
+export { useSessionMessageAuthors } from './use-session-message-authors.js';
+export { useSessionModelUsage } from './use-session-model-usage.js';
+export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
+export { useGatewayRoutingPolicy, gatewayRoutingPolicyKey } from './use-gateway-routing-policy.js';
+export { useProjectApps, useAppDeployments, useAppDeployment, useAppMachines, useAppVolumes, useAppVolumeSnapshots, appMachinesKey, appVolumesKey, useAppAccess, projectAppsKey, appDeploymentsKey, appDeploymentKey, } from './use-project-apps.js';
+export { NoCompactionModelError } from './use-opencode-sessions/no-compaction-model-error.js';
+export * from './use-admin-accounts.js';
+export * from './use-admin-role.js';
+export * from './use-admin-projects.js';
+export * from './use-admin-analytics.js';
+export * from './use-admin-activity-analytics.js';
+export * from './use-admin-feedback.js';
+export * from './use-system-status.js';
+export * from './use-ops-overview.js';
+export * from './use-admin-billing.js';
+export * from './use-impersonation.js';
+export * from './use-teams-installations.js';
+export * from './use-tunnel.js';
+export * from './use-admin-sandboxes.js';
+export * from './use-authenticated-preview-url.js';
+export * from './use-static-file-preview.js';
+export * from './run-pty-command.js';
+export * from './runtime-actions.js';
+export { useCan, useCans, usePermissionsFor, invalidatePermissionProbes, permissionProbeKey, permissionProbeBatchKey, type CanResult, type CanTarget, type CanOptions, } from './use-can.js';
+export * from './query-keys.js';
+export { fileContentKeys, binaryBlobKeys, fileListKeys, gitStatusKeys } from './file-keys.js';
+export * from './query-contracts.js';
+export * from './use-project-name.js';
+export * from './use-project-session.js';
+export * from './use-session-participants.js';
+export * from './use-project-sessions.js';
+export * from './use-sessions-needing-input.js';
+export * from './use-notifications.js';
+export * from './session-cache-write.js';
+export * from './invalidate-project.js';
+export * from './use-feature-flag.js';
+export * from './use-project-files.js';
+export { useBeeuniViewer, fetchBeeuniViewer, SignInWithBeeuni, beeuniSignInHref, beeuniSignOutHref, BEEUNI_AUTH_DEFAULT_BASE_PATH, type BeeuniViewerInfo, type BeeuniViewerState, type SignInWithBeeuniProps, } from './sign-in-with-beeuni.js';
+export { useBeeuniAppViewer, type BeeuniAppViewerState, } from './use-beeuni-app-viewer.js';
+export { useModelAccess } from './use-model-access.js';
+export { formatMegabytes, useSandboxImage } from './use-sandbox-image.js';
+export { GATEWAY_LOGS_PAGE_SIZE, useGatewayOverview, useGatewaySeries, useGatewayBreakdown, useGatewaySessions, useGatewayErrors, useGatewayLogs, useGatewayLog, useGatewayBudgets, useSetGatewayBudget, useDeleteGatewayBudget, useGatewayKeys, useCreateGatewayKey, useRevokeGatewayKey, } from './use-project-gateway.js';
+export * from './use-admin-providers.js';

package/dist/react/index.js

@@ -0,0 +1,63 @@
+'use client';
+export * from './use-prompt-attachments.js';
+export * from './use-project-starter-suggestions.js';
+export { useConnectorSetup, useConnectorLinkInfo, } from './connector-setup.js';
+export { useConnectorQuery } from './use-connector-query.js';
+export { resetIdentityState } from './reset-identity-state.js';
+export * from './opencode.js';
+export { useRuntimeSupports } from './use-runtime-supports.js';
+export { useSessionStreamConnected } from './use-session-stream.js';
+export { answerQuestion, answerPermission, rejectQuestion, classifySendError, } from './use-session.js';
+export { BillingError, RequestTooLargeError, parseBillingError, isBillingError, formatBillingErrorForUI, } from '../core/http/api/errors.js';
+export { openEventStream, } from '../core/stream/event-stream.js';
+export * from './use-beeuni-master.js';
+export { useSessionSend, beginOptimisticSend, markOptimisticSendDispatched, markOptimisticSendInboxBacked, abandonOptimisticSend, recoverFromSendFailure, sendAndRecover, sendWithReceipt, stopWithReceipt, STOP_HOLD_DEADLINE_MS, applyOptimisticAbort, replayStartStash, } from './use-session-send.js';
+export { useChatTurns, renderParts } from './chat/index.js';
+export { useAccounts, useProjects, accountsQueryOptions, projectsQueryOptions, } from './use-accounts.js';
+export { useProjectSecrets, projectSecretsKey } from './use-project-secrets.js';
+export { useAccountSecretResources, useSessionProviderSecretPools } from './use-provider-secrets.js';
+export { useProjectTriggers, projectTriggersKey, useProjectTriggerEventTypes, useProjectTriggerEventApps, projectTriggerEventAppsKey, projectTriggerEventTypesKey, } from './use-project-triggers.js';
+export { useProjectReminders, useSessionReminders } from './use-reminders.js';
+export { useSessionMessageAuthors } from './use-session-message-authors.js';
+export { useSessionModelUsage } from './use-session-model-usage.js';
+export { useChangeRequests, changeRequestsKey } from './use-change-requests.js';
+export { useGatewayRoutingPolicy, gatewayRoutingPolicyKey } from './use-gateway-routing-policy.js';
+export { useProjectApps, useAppDeployments, useAppDeployment, useAppMachines, useAppVolumes, useAppVolumeSnapshots, appMachinesKey, appVolumesKey, useAppAccess, projectAppsKey, appDeploymentsKey, appDeploymentKey, } from './use-project-apps.js';
+export { NoCompactionModelError } from './use-opencode-sessions/no-compaction-model-error.js';
+export * from './use-admin-accounts.js';
+export * from './use-admin-role.js';
+export * from './use-admin-projects.js';
+export * from './use-admin-analytics.js';
+export * from './use-admin-activity-analytics.js';
+export * from './use-admin-feedback.js';
+export * from './use-system-status.js';
+export * from './use-ops-overview.js';
+export * from './use-admin-billing.js';
+export * from './use-impersonation.js';
+export * from './use-teams-installations.js';
+export * from './use-tunnel.js';
+export * from './use-admin-sandboxes.js';
+export * from './use-authenticated-preview-url.js';
+export * from './use-static-file-preview.js';
+export * from './run-pty-command.js';
+export * from './runtime-actions.js';
+export { useCan, useCans, usePermissionsFor, invalidatePermissionProbes, permissionProbeKey, permissionProbeBatchKey, } from './use-can.js';
+export * from './query-keys.js';
+export { fileContentKeys, binaryBlobKeys, fileListKeys, gitStatusKeys } from './file-keys.js';
+export * from './query-contracts.js';
+export * from './use-project-name.js';
+export * from './use-project-session.js';
+export * from './use-session-participants.js';
+export * from './use-project-sessions.js';
+export * from './use-sessions-needing-input.js';
+export * from './use-notifications.js';
+export * from './session-cache-write.js';
+export * from './invalidate-project.js';
+export * from './use-feature-flag.js';
+export * from './use-project-files.js';
+export { useBeeuniViewer, fetchBeeuniViewer, SignInWithBeeuni, beeuniSignInHref, beeuniSignOutHref, BEEUNI_AUTH_DEFAULT_BASE_PATH, } from './sign-in-with-beeuni.js';
+export { useBeeuniAppViewer, } from './use-beeuni-app-viewer.js';
+export { useModelAccess } from './use-model-access.js';
+export { formatMegabytes, useSandboxImage } from './use-sandbox-image.js';
+export { GATEWAY_LOGS_PAGE_SIZE, useGatewayOverview, useGatewaySeries, useGatewayBreakdown, useGatewaySessions, useGatewayErrors, useGatewayLogs, useGatewayLog, useGatewayBudgets, useSetGatewayBudget, useDeleteGatewayBudget, useGatewayKeys, useCreateGatewayKey, useRevokeGatewayKey, } from './use-project-gateway.js';
+export * from './use-admin-providers.js';

package/dist/react/initial-session-pin.d.ts

@@ -0,0 +1,14 @@
+interface SessionPinSources {
+    startPin?: string | null;
+    initialPin?: string | null;
+    persistedPin?: string | null;
+}
+export declare function resolveSessionPin({ startPin, initialPin, persistedPin, }: SessionPinSources): string | null;
+export declare function sessionPinStorageKey(projectId: string, sessionId: string): string;
+export declare function readPersistedSessionPin(projectId: string, sessionId: string): string | null;
+export declare function writePersistedSessionPin(projectId: string, sessionId: string, opencodeSessionId: string | null | undefined): void;
+export declare function resolvePersistedPin(input: {
+    networkPin?: string | null;
+    cachedPin?: string | null;
+}): string | null;
+export {};

package/dist/react/initial-session-pin.js

@@ -0,0 +1,28 @@
+export function resolveSessionPin({ startPin, initialPin, persistedPin, }) {
+    return startPin ?? initialPin ?? persistedPin ?? null;
+}
+export function sessionPinStorageKey(projectId, sessionId) {
+    return `beeuni:pin:${projectId}/${sessionId}`;
+}
+export function readPersistedSessionPin(projectId, sessionId) {
+    if (!projectId || !sessionId)
+        return null;
+    try {
+        return localStorage.getItem(sessionPinStorageKey(projectId, sessionId)) || null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writePersistedSessionPin(projectId, sessionId, opencodeSessionId) {
+    if (!projectId || !sessionId || !opencodeSessionId)
+        return;
+    try {
+        localStorage.setItem(sessionPinStorageKey(projectId, sessionId), opencodeSessionId);
+    }
+    catch {
+    }
+}
+export function resolvePersistedPin(input) {
+    return input.networkPin ?? input.cachedPin ?? null;
+}

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

@@ -0,0 +1,22 @@
+import type { QueryClient, QueryKey } from '@tanstack/react-query';
+export declare function invalidateProject(qc: QueryClient, projectId: string): Promise<void>;
+export declare function invalidateProjectIdentity(qc: QueryClient, projectId: string): Promise<void>;
+type ProjectsListEntry = {
+    project_id: string;
+    name: string;
+};
+type ProjectDetailEntry = {
+    project?: {
+        name?: string;
+    };
+};
+export interface ProjectNameSnapshot {
+    detail: ProjectDetailEntry | undefined;
+    lists: Array<{
+        queryKey: QueryKey;
+        data: ProjectsListEntry[] | undefined;
+    }>;
+}
+export declare function writeProjectNameOptimistically(qc: QueryClient, projectId: string, name: string): ProjectNameSnapshot;
+export declare function restoreProjectName(qc: QueryClient, projectId: string, snapshot: ProjectNameSnapshot): void;
+export {};

package/dist/react/invalidate-project.js

@@ -0,0 +1,26 @@
+import { qk } from './query-keys.js';
+export async function invalidateProject(qc, projectId) {
+    await qc.invalidateQueries({ queryKey: qk.project.scope(projectId) });
+}
+export async function invalidateProjectIdentity(qc, projectId) {
+    await Promise.all([
+        qc.invalidateQueries({ queryKey: qk.projects.scope() }),
+        qc.invalidateQueries({ queryKey: qk.project.detail(projectId) }),
+    ]);
+}
+export function writeProjectNameOptimistically(qc, projectId, name) {
+    const lists = qc.getQueriesData({ queryKey: qk.projects.scope() });
+    const snapshot = {
+        detail: qc.getQueryData(qk.project.detail(projectId)),
+        lists: lists.map(([queryKey, data]) => ({ queryKey, data })),
+    };
+    qc.setQueriesData({ queryKey: qk.projects.scope() }, (prev) => prev?.map((p) => (p.project_id === projectId ? { ...p, name } : p)));
+    qc.setQueryData(qk.project.detail(projectId), (prev) => prev?.project ? { ...prev, project: { ...prev.project, name } } : prev);
+    return snapshot;
+}
+export function restoreProjectName(qc, projectId, snapshot) {
+    for (const { queryKey, data } of snapshot.lists) {
+        qc.setQueryData(queryKey, data);
+    }
+    qc.setQueryData(qk.project.detail(projectId), snapshot.detail);
+}

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

@@ -0,0 +1 @@
+export * from '../core/models/model-flatten.js';

package/dist/react/model-flatten.js

@@ -0,0 +1 @@
+export * from '../core/models/model-flatten.js';

package/dist/react/opencode.d.ts

@@ -0,0 +1,43 @@
+export { BeeuniProjectProvider, useBeeuniRouteProjectId } 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-model-defaults.js';
+export * from './use-model-enablement.js';
+export * from './use-session-model-selection.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, useRuntimePendingStore, } from '../browser/stores/opencode-pending-store.js';
+export { useSandboxConnectionStore, type SandboxConnectionStatus, } from '../browser/stores/sandbox-connection-store.js';
+export { requestRuntimeReconnect, useSandboxConnectionStore as useRuntimeConnectionStore, } from '../browser/stores/sandbox-connection-store.js';
+export { useServerStore as useRuntimeStore } from '../browser/stores/server-store.js';
+export { useSyncStore as useSessionStateStore } from '../browser/stores/sync-store.js';
+export * from './use-session-prefetch.js';
+export { prefetchSessionStart } from './prefetch-session-start.js';
+export { prefetchSessionOpen } from './prefetch-session-open.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, isOfferedModel, type FlatModel } from './model-flatten.js';
+export { GATEWAY_PROVIDER_IDS, LLM_PROVIDER_CREDENTIALS, connectedGatewayProviderIdsFromSecretNames, filterToGatewayProviders, applyEnablementToProviderList, filterToNativeProviders, mergeProjectSecretConnectedProviders, mergeProviderLists, normalizeProviderList, projectLlmCatalogToProviderList, providerListHasGateway, providerListHasModels, } from './provider-selection.js';
+export { useProjectModelPickerCatalog, useProjectModels } from './use-project-models.js';
+export { useProjectConfig } from './use-project-config.js';
+export type { ProjectConfigSummary } from '../core/rest/projects-client/index.js';
+export { useSession, type SessionPhase, type UseSessionResult, type UseSessionOptions, } from './use-session.js';
+export { useSessionMessages, type SessionMessagesOptions, type SessionMessagesSource, } from './use-session-messages.js';
+export { useSessionPicks, type SessionPicks } from './use-session-picks.js';
+export { useSessionPrompts, sessionPromptsPollMs, startSessionWithPrompt, isOptimisticSessionPrompt, optimisticSessionPrompt, applyOptimisticPrompt, settleOptimisticPrompt, removeOptimisticPrompt, reconcileOptimisticPrompts, OPTIMISTIC_PROMPT_PREFIX, SESSION_PROMPTS_POLL_MS, SESSION_PROMPTS_IDLE_POLL_MS, type StartSessionWithPromptAdapters, type UseSessionPromptsResult, } from './use-session-prompts.js';
+export { readSessionAudit } from './use-session-audit.js';
+export { useSessionWorkingStore } from '../browser/stores/session-working-store.js';
+export { useSessionTurnOutcome, useSessionWorking, workingPollMs, buildWorkingInputs, WORKING_POLL_ACTIVE_MS, WORKING_POLL_IDLE_MS, type SessionTurnObservation, type UseSessionWorkingOptions, } from './use-session-working.js';
+export { useRuntimePhase, type RuntimePhase } from './use-runtime-phase.js';
+export { useRuntimeBootStalled, RUNTIME_BOOT_STALL_MS } from './use-runtime-boot-stalled.js';
+export { useWakeEscalation, type UseWakeEscalationInput, type WakeEscalationView, } from './use-wake-escalation.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';

package/dist/react/opencode.js

@@ -0,0 +1,43 @@
+'use client';
+export { BeeuniProjectProvider, useBeeuniRouteProjectId } 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-model-defaults.js';
+export * from './use-model-enablement.js';
+export * from './use-session-model-selection.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, useRuntimePendingStore, } from '../browser/stores/opencode-pending-store.js';
+export { useSandboxConnectionStore, } from '../browser/stores/sandbox-connection-store.js';
+export { requestRuntimeReconnect, useSandboxConnectionStore as useRuntimeConnectionStore, } from '../browser/stores/sandbox-connection-store.js';
+export { useServerStore as useRuntimeStore } from '../browser/stores/server-store.js';
+export { useSyncStore as useSessionStateStore } from '../browser/stores/sync-store.js';
+export * from './use-session-prefetch.js';
+export { prefetchSessionStart } from './prefetch-session-start.js';
+export { prefetchSessionOpen } from './prefetch-session-open.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, isOfferedModel } from './model-flatten.js';
+export { GATEWAY_PROVIDER_IDS, LLM_PROVIDER_CREDENTIALS, connectedGatewayProviderIdsFromSecretNames, filterToGatewayProviders, applyEnablementToProviderList, filterToNativeProviders, mergeProjectSecretConnectedProviders, mergeProviderLists, normalizeProviderList, projectLlmCatalogToProviderList, providerListHasGateway, providerListHasModels, } from './provider-selection.js';
+export { useProjectModelPickerCatalog, useProjectModels } from './use-project-models.js';
+export { useProjectConfig } from './use-project-config.js';
+export { useSession, } from './use-session.js';
+export { useSessionMessages, } from './use-session-messages.js';
+export { useSessionPicks } from './use-session-picks.js';
+export { useSessionPrompts, sessionPromptsPollMs, startSessionWithPrompt, isOptimisticSessionPrompt, optimisticSessionPrompt, applyOptimisticPrompt, settleOptimisticPrompt, removeOptimisticPrompt, reconcileOptimisticPrompts, OPTIMISTIC_PROMPT_PREFIX, SESSION_PROMPTS_POLL_MS, SESSION_PROMPTS_IDLE_POLL_MS, } from './use-session-prompts.js';
+export { readSessionAudit } from './use-session-audit.js';
+export { useSessionWorkingStore } from '../browser/stores/session-working-store.js';
+export { useSessionTurnOutcome, useSessionWorking, workingPollMs, buildWorkingInputs, WORKING_POLL_ACTIVE_MS, WORKING_POLL_IDLE_MS, } from './use-session-working.js';
+export { useRuntimePhase } from './use-runtime-phase.js';
+export { useRuntimeBootStalled, RUNTIME_BOOT_STALL_MS } from './use-runtime-boot-stalled.js';
+export { useWakeEscalation, } from './use-wake-escalation.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';

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

@@ -0,0 +1,5 @@
+import type { QueryClient } from '@tanstack/react-query';
+export declare function prefetchedSessionCount(): number;
+export declare function resetSessionOpenPrefetches(): void;
+export declare function prefetchSessionOpen(queryClient: QueryClient, projectId: string, sessionId: string): Promise<void>;
+export declare function seedModelDefaultsFromOpenBundle(queryClient: QueryClient, projectId: string, sessionId: string): void;

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

@@ -0,0 +1,48 @@
+'use client';
+import { claimOpenBundle, openSessionBundle } from '../core/session/open-bundle.js';
+import { readProjectSessionRow } from '../core/session/project-session-read.js';
+import { contract } from './query-contracts.js';
+import { qk } from './query-keys.js';
+const PREFETCH_WINDOW_MS = 30_000;
+const lastPrefetchAt = new Map();
+const PREFETCH_LEDGER_PRUNE_AT = 200;
+export function prefetchedSessionCount() {
+    return lastPrefetchAt.size;
+}
+export function resetSessionOpenPrefetches() {
+    lastPrefetchAt.clear();
+}
+export function prefetchSessionOpen(queryClient, projectId, sessionId) {
+    if (!projectId || !sessionId)
+        return Promise.resolve();
+    const scope = `${projectId}/${sessionId}`;
+    const nowMs = Date.now();
+    const previous = lastPrefetchAt.get(scope);
+    if (previous !== undefined && nowMs - previous < PREFETCH_WINDOW_MS)
+        return Promise.resolve();
+    if (lastPrefetchAt.size >= PREFETCH_LEDGER_PRUNE_AT) {
+        for (const [key, at] of lastPrefetchAt) {
+            if (nowMs - at >= PREFETCH_WINDOW_MS)
+                lastPrefetchAt.delete(key);
+        }
+    }
+    lastPrefetchAt.set(scope, nowMs);
+    openSessionBundle(projectId, sessionId);
+    const queryKey = qk.project.session(projectId, sessionId);
+    return queryClient.prefetchQuery({
+        queryKey,
+        queryFn: () => readProjectSessionRow(projectId, sessionId, {
+            bundle: queryClient.getQueryData(queryKey) === undefined,
+        }),
+        staleTime: contract('inventory').staleTime,
+    });
+}
+export function seedModelDefaultsFromOpenBundle(queryClient, projectId, sessionId) {
+    void claimOpenBundle(projectId, sessionId)?.then((bundle) => {
+        const key = ['model-defaults', projectId];
+        if (!bundle?.models?.known || queryClient.getQueryData(key) !== undefined)
+            return;
+        const { known: _known, ...defaults } = bundle.models;
+        queryClient.setQueryData(key, defaults);
+    });
+}

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

@@ -0,0 +1,2 @@
+import type { QueryClient } from '@tanstack/react-query';
+export declare function prefetchSessionStart(queryClient: QueryClient, projectId: string, sessionId: string): Promise<void>;

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

@@ -0,0 +1,9 @@
+'use client';
+import { sessionStartKey, startProjectSession } from '../core/rest/projects-client/index.js';
+export function prefetchSessionStart(queryClient, projectId, sessionId) {
+    return queryClient.prefetchQuery({
+        queryKey: sessionStartKey(projectId, sessionId),
+        queryFn: () => startProjectSession(projectId, sessionId),
+        staleTime: 0,
+    });
+}

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

@@ -0,0 +1,9 @@
+import type { QueryClient } from '@tanstack/react-query';
+type RefreshProjectProviderStateOptions = {
+    removeProjectScopedCache?: boolean;
+    expectProviderId?: string;
+};
+export declare function providerConnectedInSecrets(secrets: unknown, expectedProviderId: string): boolean;
+export declare function invalidateProjectProviderQueries(queryClient: QueryClient, projectId: string): void;
+export declare function refreshProjectProviderState(queryClient: QueryClient, projectId: string, opts?: RefreshProjectProviderStateOptions): void;
+export {};

package/dist/react/provider-refresh.js

@@ -0,0 +1,72 @@
+'use client';
+import { listProjectSecrets } from '../core/rest/projects-client/index.js';
+import { connectedGatewayProviderIdsFromSecretNames } from './provider-selection.js';
+import { configKeys } from './use-opencode-config.js';
+import { runtimeKeys } from './use-opencode-sessions/index.js';
+import { qk } from './query-keys.js';
+const CONVERGE_POLL_MS = 2_500;
+const CONVERGE_DEADLINE_MS = 45_000;
+export function providerConnectedInSecrets(secrets, expectedProviderId) {
+    const items = Array.isArray(secrets)
+        ? secrets
+        : (secrets?.items ?? []);
+    const names = new Set();
+    for (const item of items) {
+        if (item && typeof item.name === 'string') {
+            names.add(item.name);
+        }
+    }
+    return connectedGatewayProviderIdsFromSecretNames(names).has(expectedProviderId);
+}
+function invalidateProviderQueries(queryClient, projectId, supersede) {
+    const projectProviderKey = ['project-providers', projectId];
+    const fetchOptions = supersede ? undefined : { cancelRefetch: false };
+    void queryClient.invalidateQueries({ queryKey: qk.project.modelPicker(projectId), refetchType: 'all' }, fetchOptions);
+    void queryClient.invalidateQueries({ queryKey: projectProviderKey }, fetchOptions);
+    void queryClient.invalidateQueries({ queryKey: qk.project.secrets(projectId) }, fetchOptions);
+    void queryClient.refetchQueries({ queryKey: qk.project.secrets(projectId), type: 'all' }, fetchOptions);
+    void queryClient.refetchQueries({ queryKey: projectProviderKey, type: 'all' }, fetchOptions);
+    void queryClient.invalidateQueries({ queryKey: runtimeKeys.providers() }, fetchOptions);
+    void queryClient.invalidateQueries({ queryKey: configKeys.all }, fetchOptions);
+}
+export function invalidateProjectProviderQueries(queryClient, projectId) {
+    invalidateProviderQueries(queryClient, projectId, false);
+}
+export function refreshProjectProviderState(queryClient, projectId, opts = {}) {
+    const projectProviderKey = ['project-providers', projectId];
+    if (opts.removeProjectScopedCache) {
+        queryClient.removeQueries({ queryKey: projectProviderKey });
+    }
+    invalidateProviderQueries(queryClient, projectId, true);
+    if (typeof window === 'undefined')
+        return;
+    const expected = opts.expectProviderId;
+    if (!expected) {
+        for (const delay of [500, 1500, 3000, 6000]) {
+            window.setTimeout(() => invalidateProviderQueries(queryClient, projectId, false), delay);
+        }
+        return;
+    }
+    const startedAt = Date.now();
+    const poll = async () => {
+        let connected = false;
+        try {
+            const secrets = await queryClient.fetchQuery({
+                queryKey: qk.project.secrets(projectId),
+                queryFn: () => listProjectSecrets(projectId),
+                staleTime: 0,
+            });
+            connected = providerConnectedInSecrets(secrets, expected);
+        }
+        catch {
+        }
+        if (connected) {
+            invalidateProviderQueries(queryClient, projectId, false);
+            return;
+        }
+        if (Date.now() - startedAt >= CONVERGE_DEADLINE_MS)
+            return;
+        window.setTimeout(() => void poll(), CONVERGE_POLL_MS);
+    };
+    window.setTimeout(() => void poll(), CONVERGE_POLL_MS);
+}

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

@@ -0,0 +1 @@
+export * from '../core/models/provider-selection.js';

package/dist/react/provider-selection.js

@@ -0,0 +1 @@
+export * from '../core/models/provider-selection.js';

package/dist/react/pty-query-state.d.ts

@@ -0,0 +1,2 @@
+export declare function isPtyQueryEnabled(serverUrl: string, enabled?: boolean): boolean;
+export declare function resolvePtyServerUrl(explicitUrl: string | undefined, activeUrl: string): string;

package/dist/react/pty-query-state.js

@@ -0,0 +1,6 @@
+export function isPtyQueryEnabled(serverUrl, enabled = true) {
+    return enabled && serverUrl.length > 0;
+}
+export function resolvePtyServerUrl(explicitUrl, activeUrl) {
+    return explicitUrl || activeUrl;
+}

package/dist/react/query-contracts.d.ts

@@ -0,0 +1,49 @@
+export type FreshnessTier = 'live' | 'config' | 'inventory' | 'volatile' | 'directory';
+declare function errorSelfHealRefetchInterval(query: {
+    state: {
+        status: string;
+        data?: unknown;
+        errorUpdateCount: number;
+    };
+}): number | false;
+export declare function contract(tier: FreshnessTier): {
+    refetchInterval: number | typeof errorSelfHealRefetchInterval;
+    refetchIntervalInBackground?: boolean | undefined;
+    refetchOnWindowFocus?: "always" | undefined;
+    refetchOnReconnect?: "always" | undefined;
+    staleTime: number;
+    gcTime: number;
+    refetchOnMount: true;
+};
+export declare const FRESHNESS: {
+    readonly projectsList: "inventory";
+    readonly projectSummary: "config";
+    readonly projectDetail: "config";
+    readonly projectConfig: "config";
+    readonly session: "inventory";
+    readonly sessions: "inventory";
+    readonly messages: "live";
+    readonly connectors: "directory";
+    readonly connectorConfig: "config";
+    readonly connectorOAuth2Discovery: "config";
+    readonly secrets: "config";
+    readonly apps: "inventory";
+    readonly appDeployments: "inventory";
+    readonly policies: "config";
+    readonly executorPolicies: "config";
+    readonly access: "inventory";
+    readonly accessRequests: "inventory";
+    readonly pendingInvites: "inventory";
+    readonly groupGrants: "inventory";
+    readonly resourceGrants: "inventory";
+    readonly files: "config";
+    readonly fileSource: "config";
+    readonly branches: "config";
+    readonly sandboxes: "config";
+    readonly sandboxTemplates: "config";
+    readonly snapshots: "config";
+    readonly modelPicker: "config";
+    readonly gateway: "inventory";
+    readonly triggers: "config";
+};
+export {};

package/dist/react/query-contracts.js

@@ -0,0 +1,63 @@
+const GC_TIME = 30 * 60 * 1000;
+const TIERS = {
+    live: { staleTime: Infinity },
+    config: { staleTime: 60_000 },
+    inventory: { staleTime: 30_000 },
+    volatile: { staleTime: 5_000 },
+    directory: { staleTime: 10_000 },
+};
+const ERROR_SELF_HEAL_BASE_MS = 2_000;
+const ERROR_SELF_HEAL_CAP_MS = 30_000;
+function errorSelfHealRefetchInterval(query) {
+    const { status, data, errorUpdateCount } = query.state;
+    if (status !== 'error' || data !== undefined)
+        return false;
+    return Math.min(ERROR_SELF_HEAL_BASE_MS * 2 ** Math.max(0, errorUpdateCount - 1), ERROR_SELF_HEAL_CAP_MS);
+}
+export function contract(tier) {
+    return {
+        staleTime: TIERS[tier].staleTime,
+        gcTime: GC_TIME,
+        refetchOnMount: true,
+        refetchInterval: errorSelfHealRefetchInterval,
+        ...(tier === 'directory'
+            ? {
+                refetchInterval: 10_000,
+                refetchIntervalInBackground: false,
+                refetchOnWindowFocus: 'always',
+                refetchOnReconnect: 'always',
+            }
+            : {}),
+    };
+}
+export const FRESHNESS = {
+    projectsList: 'inventory',
+    projectSummary: 'config',
+    projectDetail: 'config',
+    projectConfig: 'config',
+    session: 'inventory',
+    sessions: 'inventory',
+    messages: 'live',
+    connectors: 'directory',
+    connectorConfig: 'config',
+    connectorOAuth2Discovery: 'config',
+    secrets: 'config',
+    apps: 'inventory',
+    appDeployments: 'inventory',
+    policies: 'config',
+    executorPolicies: 'config',
+    access: 'inventory',
+    accessRequests: 'inventory',
+    pendingInvites: 'inventory',
+    groupGrants: 'inventory',
+    resourceGrants: 'inventory',
+    files: 'config',
+    fileSource: 'config',
+    branches: 'config',
+    sandboxes: 'config',
+    sandboxTemplates: 'config',
+    snapshots: 'config',
+    modelPicker: 'config',
+    gateway: 'inventory',
+    triggers: 'config',
+};