@beeuni/sdk 0.1.0 → 0.2.0

package/dist/index.js

@@ -22,8 +22,6 @@ export * from './core/http/authenticated-request.js';
 export * from './core/http/config.js';
 export * from './core/http/feature-flags.js';
 export * from './core/http/fresh-sessions.js';
-export * from './core/http/impersonation.js';
-export * from './core/http/instance-routes.js';
 export * from './core/http/runtime-errors.js';
 export * from './core/rest/platform-client/index.js';
 export * from './core/rest/projects-client/index.js';
@@ -33,6 +31,8 @@ export * from './core/attachments/prompt-attachments.js';
 export * from './core/runtime/client.js';
 export * from './core/runtime/attachment-part.js';
 export * from './core/session/index.js';
+export * from './core/session-log/index.js';
+export * from './core/warm-session-pool.js';
 export { createHttpSessionSyncController, loadHttpSessionHistory, } from './core/session-sync/session-sync-controller.js';
 export * from './core/session-sync/saved-copy-store.js';
 export { isEmptyConversation, savedCopyEmptyRoot, } from './core/session-sync/saved-transcript.js';

package/dist/internal/connector-catalog.d.ts

@@ -0,0 +1,47 @@
+export interface PipedreamApp {
+    slug: string;
+    name: string;
+    description: string | null;
+    imgSrc: string | null;
+    authType: string | null;
+    categories: string[];
+    hasActions: boolean;
+    hasTriggers: boolean;
+    featuredWeight: number;
+    directId?: string | null;
+}
+export interface PipedreamCategory {
+    key: string;
+    label: string;
+    count: number;
+}
+export interface PipedreamCatalogQuery {
+    q?: string;
+    category?: string;
+    cursor?: string;
+    limit?: number;
+}
+export interface PipedreamCatalogPage {
+    apps: PipedreamApp[];
+    categories: PipedreamCategory[];
+    total?: number;
+    nextCursor?: string;
+    hasMore: boolean;
+    indexReady?: boolean;
+    excludedNoActions?: number;
+}
+export declare function listPipedreamApps(projectId: string, qOrQuery?: string | PipedreamCatalogQuery, cursor?: string): Promise<PipedreamCatalogPage>;
+export interface PipedreamSection {
+    key: string;
+    label: string;
+    total: number;
+    apps: PipedreamApp[];
+}
+export declare function listPipedreamSections(projectId: string, opts?: {
+    perCategory?: number;
+    maxCategories?: number;
+}): Promise<{
+    sections: PipedreamSection[];
+    categories: PipedreamCategory[];
+    indexReady?: boolean;
+}>;

package/dist/internal/connector-catalog.js

@@ -0,0 +1,27 @@
+import { backendApi } from '../core/http/api-client.js';
+import { unwrap } from '../core/rest/projects-client/shared.js';
+export async function listPipedreamApps(projectId, qOrQuery, cursor) {
+    const query = typeof qOrQuery === 'string' || qOrQuery === undefined
+        ? { ...(qOrQuery ? { q: qOrQuery } : {}), ...(cursor ? { cursor } : {}) }
+        : qOrQuery;
+    const params = new URLSearchParams();
+    if (query.q)
+        params.set('q', query.q);
+    if (query.category)
+        params.set('category', query.category);
+    if (query.cursor)
+        params.set('cursor', query.cursor);
+    if (query.limit)
+        params.set('limit', String(query.limit));
+    const qs = params.toString();
+    return unwrap(await backendApi.get(`/connectors/projects/${projectId}/pipedream/apps${qs ? `?${qs}` : ''}`));
+}
+export async function listPipedreamSections(projectId, opts) {
+    const params = new URLSearchParams();
+    if (opts?.perCategory)
+        params.set('perCategory', String(opts.perCategory));
+    if (opts?.maxCategories)
+        params.set('maxCategories', String(opts.maxCategories));
+    const qs = params.toString();
+    return unwrap(await backendApi.get(`/connectors/projects/${projectId}/pipedream/sections${qs ? `?${qs}` : ''}`));
+}

package/dist/internal/host-configuration.d.ts

@@ -0,0 +1,22 @@
+import { type SsoProvider as PublicSsoProvider } from '../core/rest/projects-client/iam-sso.js';
+import type { GitHubRepository } from '../core/rest/projects-client/github.js';
+export type HostSsoProvider = PublicSsoProvider & {
+    supabase_sso_provider_id: string;
+};
+export declare function getHostSsoProvider(accountId: string): Promise<HostSsoProvider | null>;
+export declare function upsertSsoProvider(accountId: string, input: {
+    supabase_sso_provider_id: string;
+    name: string;
+    primary_domain: string;
+    group_claim_name?: string;
+    auto_create_members?: boolean;
+    auto_provision_groups?: boolean;
+    enforce_sso?: boolean;
+}): Promise<HostSsoProvider>;
+export declare function listManagedGitRepositories(options?: {
+    search?: string;
+    limit?: number;
+}): Promise<{
+    owner: string;
+    repositories: GitHubRepository[];
+}>;

package/dist/internal/host-configuration.js

@@ -0,0 +1,28 @@
+import { backendApi } from '../core/http/api-client.js';
+import { getSsoProvider as readSsoProvider } from '../core/rest/projects-client/iam-sso.js';
+export async function getHostSsoProvider(accountId) {
+    return await readSsoProvider(accountId);
+}
+export async function upsertSsoProvider(accountId, input) {
+    const response = await backendApi.put(`/accounts/${accountId}/iam/sso/provider`, input, { showErrors: false });
+    if (response.error)
+        throw response.error;
+    if (!response.data)
+        throw new Error('SSO configuration could not be saved');
+    return response.data.provider;
+}
+export async function listManagedGitRepositories(options) {
+    const params = new URLSearchParams();
+    const search = options?.search?.trim();
+    if (search)
+        params.set('search', search);
+    if (options?.limit !== undefined)
+        params.set('limit', String(options.limit));
+    const query = params.toString();
+    const response = await backendApi.get(`/projects/git/backend/repositories${query ? `?${query}` : ''}`, { showErrors: false });
+    if (response.error)
+        throw response.error;
+    if (!response.data)
+        throw new Error('Repositories could not be loaded');
+    return response.data;
+}

package/dist/internal/platform-admin-react.d.ts

@@ -0,0 +1,12 @@
+export * from '../react/use-admin-accounts.js';
+export * from '../react/use-admin-role.js';
+export * from '../react/use-admin-projects.js';
+export * from '../react/use-admin-analytics.js';
+export * from '../react/use-admin-activity-analytics.js';
+export * from '../react/use-admin-feedback.js';
+export * from '../react/use-system-status.js';
+export * from '../react/use-ops-overview.js';
+export * from '../react/use-admin-billing.js';
+export * from '../react/use-impersonation.js';
+export * from '../react/use-admin-sandboxes.js';
+export * from '../react/use-admin-providers.js';

package/dist/internal/platform-admin-react.js

@@ -0,0 +1,13 @@
+'use client';
+export * from '../react/use-admin-accounts.js';
+export * from '../react/use-admin-role.js';
+export * from '../react/use-admin-projects.js';
+export * from '../react/use-admin-analytics.js';
+export * from '../react/use-admin-activity-analytics.js';
+export * from '../react/use-admin-feedback.js';
+export * from '../react/use-system-status.js';
+export * from '../react/use-ops-overview.js';
+export * from '../react/use-admin-billing.js';
+export * from '../react/use-impersonation.js';
+export * from '../react/use-admin-sandboxes.js';
+export * from '../react/use-admin-providers.js';

package/dist/internal/platform-admin.d.ts

@@ -0,0 +1,9 @@
+export * from './host-configuration.js';
+export * from '../core/rest/platform-client/github-app.js';
+export * from '../core/rest/projects-client/admin-providers.js';
+export * from '../core/http/impersonation.js';
+export * from '../core/http/instance-routes.js';
+export { isAdminBypassEnabled, setAdminBypass } from '../core/http/transport.js';
+export { getAdminRole, type AdminRole } from '../core/rest/projects-client/account-lifecycle.js';
+export { getMaintenanceConfig, setMaintenanceConfig, openStressTestStream, getUserRolesWithToken, } from '../core/rest/platform-client/host-boundary.js';
+export { getSandboxUpdateStatus, triggerSandboxUpdate, resetSandboxUpdateStatus, cancelSandboxUpdate, DESTRUCTIVE_PHASES, isDestructivePhase, type SandboxUpdateResult, type SandboxUpdateStatus, type UpdatePhase, } from '../core/rest/platform-client/updates.js';

package/dist/internal/platform-admin.js

@@ -0,0 +1,9 @@
+export * from './host-configuration.js';
+export * from '../core/rest/platform-client/github-app.js';
+export * from '../core/rest/projects-client/admin-providers.js';
+export * from '../core/http/impersonation.js';
+export * from '../core/http/instance-routes.js';
+export { isAdminBypassEnabled, setAdminBypass } from '../core/http/transport.js';
+export { getAdminRole } from '../core/rest/projects-client/account-lifecycle.js';
+export { getMaintenanceConfig, setMaintenanceConfig, openStressTestStream, getUserRolesWithToken, } from '../core/rest/platform-client/host-boundary.js';
+export { getSandboxUpdateStatus, triggerSandboxUpdate, resetSandboxUpdateStatus, cancelSandboxUpdate, DESTRUCTIVE_PHASES, isDestructivePhase, } from '../core/rest/platform-client/updates.js';

package/dist/react/index.d.ts

@@ -1,5 +1,4 @@
 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';
@@ -23,19 +22,8 @@ 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';
@@ -59,4 +47,3 @@ export { useBeeuniAppViewer, type BeeuniAppViewerState, } from './use-beeuni-app
 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

@@ -1,6 +1,5 @@
 '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';
@@ -24,19 +23,8 @@ 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';
@@ -60,4 +48,3 @@ 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/opencode.d.ts

@@ -30,6 +30,7 @@ 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 { useSessionLog, useSessionLogThread } from './use-session-log.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';

package/dist/react/opencode.js

@@ -30,6 +30,7 @@ export { useProjectModelPickerCatalog, useProjectModels } from './use-project-mo
 export { useProjectConfig } from './use-project-config.js';
 export { useSession, } from './use-session.js';
 export { useSessionMessages, } from './use-session-messages.js';
+export { useSessionLog, useSessionLogThread } from './use-session-log.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';

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

@@ -30,7 +30,6 @@ export declare const qk: {
         readonly session: (projectId: string, sessionId: string) => readonly ["kx", "drives", "session", string, string];
     };
     readonly project: {
-        readonly starterSuggestions: (id: string) => readonly ["kx", "project", string, "starter-suggestions"];
         readonly scope: (id: string) => readonly ["kx", "project", string];
         readonly needsInput: (id: string) => readonly ["kx", "project", string, "needs-input"];
         readonly summary: (id: string) => readonly ["kx", "project", string, "summary"];

package/dist/react/query-keys.js

@@ -42,7 +42,6 @@ export const qk = {
         session: (projectId, sessionId) => [...qk.drives.scope(), 'session', projectId, sessionId],
     },
     project: {
-        starterSuggestions: (id) => [...qk.project.scope(id), 'starter-suggestions'],
         scope: (id) => ['kx', 'project', id],
         needsInput: (id) => [...qk.project.scope(id), 'needs-input'],
         summary: (id) => [...qk.project.scope(id), 'summary'],

package/dist/react/session-transcript-subscription.js

@@ -1,5 +1,6 @@
 'use client';
 import { getSessionCacheOwnership, resolveSessionCacheOwnerScope, sessionCacheOwnerScopesConflict, } from '../browser/session-sync/session-cache-ownership.js';
+import { sessionLogRowsFor } from '../core/session-log/v1-view.js';
 import { useCurrentRuntime } from './use-current-runtime.js';
 export function useReadableSessionId(sessionId, beeuniSessionScope) {
     const runtimeScope = useCurrentRuntime((state) => state.sandboxId) ?? 'none';
@@ -9,7 +10,8 @@ export function useReadableSessionId(sessionId, beeuniSessionScope) {
     return cacheBelongsToAnotherRuntime ? '' : sessionId;
 }
 export function selectSessionRows(state, sessionId) {
-    return state.buildSessionMessages(sessionId, state.messages[sessionId], state.parts);
+    const rows = state.buildSessionMessages(sessionId, state.messages[sessionId], state.parts);
+    return sessionLogRowsFor(state.sessionLogs, sessionId, rows);
 }
 const toolSignatures = new WeakMap();
 function toolSignature(parts) {

package/dist/react/sign-in-with-beeuni.d.ts

@@ -51,6 +51,7 @@ export declare function SignInWithBeeuni({ basePath, returnTo, children, ...rest
     referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
     id?: string | undefined | undefined;
     content?: string | undefined | undefined;
+    rev?: string | undefined | undefined;
     role?: import("react").AriaRole | undefined;
     dir?: string | undefined | undefined;
     download?: any;
@@ -86,7 +87,6 @@ export declare function SignInWithBeeuni({ basePath, returnTo, children, ...rest
     inlist?: any;
     property?: string | undefined | undefined;
     rel?: string | undefined | undefined;
-    rev?: string | undefined | undefined;
     typeof?: string | undefined | undefined;
     vocab?: string | undefined | undefined;
     autoCorrect?: string | undefined | undefined;

package/dist/react/use-admin-providers.d.ts

@@ -1,7 +1,7 @@
 import { type AdminBootModePolicy } from '../core/rest/projects-client/admin-providers.js';
-export declare function useAdminProviderDistribution(): import("@tanstack/react-query").UseQueryResult<import("../index.js").AdminProviderDistribution, Error>;
-export declare function useAdminProviderSandboxes(): import("@tanstack/react-query").UseQueryResult<import("../index.js").AdminProviderSandboxesResponse, Error>;
-export declare function useAdminProviderAnalytics(days: number, enabled: boolean): import("@tanstack/react-query").UseQueryResult<import("../index.js").AdminProviderAnalytics, Error>;
+export declare function useAdminProviderDistribution(): import("@tanstack/react-query").UseQueryResult<import("../internal/platform-admin.js").AdminProviderDistribution, Error>;
+export declare function useAdminProviderSandboxes(): import("@tanstack/react-query").UseQueryResult<import("../internal/platform-admin.js").AdminProviderSandboxesResponse, Error>;
+export declare function useAdminProviderAnalytics(days: number, enabled: boolean): import("@tanstack/react-query").UseQueryResult<import("../internal/platform-admin.js").AdminProviderAnalytics, Error>;
 export declare function useAdminProviderFallback(): import("@tanstack/react-query").UseQueryResult<{
     enabled: boolean;
 }, Error>;
@@ -16,5 +16,5 @@ export interface AdminProviderMigrationVariables {
 export declare function useSetAdminProviderDistribution(options?: AdminProviderMutationOptions): import("@tanstack/react-query").UseMutationResult<unknown, Error, Record<string, number>, unknown>;
 export declare function useMigrateAdminSandboxProvider(options?: AdminProviderMutationOptions): import("@tanstack/react-query").UseMutationResult<unknown, Error, AdminProviderMigrationVariables, unknown>;
 export declare function useSetAdminProviderFallback(options?: AdminProviderMutationOptions): import("@tanstack/react-query").UseMutationResult<unknown, Error, boolean, unknown>;
-export declare function useAdminBootModes(): import("@tanstack/react-query").UseQueryResult<import("../index.js").AdminBootModes, Error>;
-export declare function useSetAdminBootModes(options?: AdminProviderMutationOptions): import("@tanstack/react-query").UseMutationResult<import("../index.js").AdminBootModes, Error, AdminBootModePolicy, unknown>;
+export declare function useAdminBootModes(): import("@tanstack/react-query").UseQueryResult<import("../internal/platform-admin.js").AdminBootModes, Error>;
+export declare function useSetAdminBootModes(options?: AdminProviderMutationOptions): import("@tanstack/react-query").UseMutationResult<import("../internal/platform-admin.js").AdminBootModes, Error, AdminBootModePolicy, unknown>;

package/dist/react/use-opencode-events/handle-event.d.ts

@@ -20,4 +20,5 @@ export declare function createEventHandler(deps: {
     reconcileSessionTail?: (sessionID: string, reason: SessionSyncReason) => Promise<void>;
     userPartsGraceMs?: number;
     projectId?: string | null;
+    sessionId?: string | null;
 }): (event: RuntimeEvent) => void;

package/dist/react/use-opencode-events/handle-event.js

@@ -44,6 +44,11 @@ export function createEventHandler(deps) {
         const statusBeforeEvent = sessionID
             ? useSyncStore.getState().sessionStatus[sessionID]
             : undefined;
+        if (event.type.startsWith('log.')) {
+            if (deps.sessionId)
+                useSyncStore.getState().applySessionLogEvent(deps.sessionId, event);
+            return;
+        }
         deps.applySyncEvent(event);
         if (event.type.startsWith('message.'))
             handleMessageEvent(event, ctx);

package/dist/react/use-opencode-events/index.js

@@ -101,6 +101,7 @@ export function useRuntimeEventStream(options = {}) {
             fetchLspDiagnosticsDebounced,
             reconcileSessionTail: reconcileSessionTailFromRegistry,
             projectId,
+            sessionId: options.projectId && options.sessionId ? options.sessionId : null,
         });
         const hydrate = (options) => hydrateCore({
             client,

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

@@ -1,6 +1,6 @@
 'use client';
 import { useEffect, useRef } from 'react';
-import { getSupabaseAccessToken } from '../core/http/auth.js';
+import { getAuthToken } from '../core/http/auth.js';
 import { CONNECTION_FAULT_GRACE_MS, getSessionHealth, isRuntimeReady, } from '../core/session/index.js';
 import { incrementSandboxFail, markInitialCheckDone, resetForServerSwitch, resetSandboxFail, setRuntimeHealth, setRuntimeCapabilities, setSandboxStatus, useSandboxConnectionStore, } from '../browser/stores/sandbox-connection-store.js';
 import { useServerStore } from '../browser/stores/server-store.js';
@@ -109,7 +109,7 @@ export function useRuntimeReconnect() {
                     scheduleNext();
                     return;
                 }
-                token = await getSupabaseAccessToken();
+                token = await getAuthToken();
                 if (!token) {
                     scheduleNext();
                     return;

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

@@ -0,0 +1,15 @@
+import { type SessionControlStreamOptions } from '../core/session/control-stream.js';
+import { type LoadSessionLogPage, type SessionLogDialect } from '../core/session-log/source.js';
+import type { SessionLog, SessionLogThread } from '../core/session-log/types.js';
+import { type SessionMessagesSource } from './use-session-messages.js';
+export declare function useSessionLog(session: SessionMessagesSource): (SessionLog & {
+    source: 'v1' | 'v2';
+}) | null;
+export declare function useSessionLogThread(session: SessionMessagesSource, threadId?: string | null): SessionLogThread | null;
+export declare function useSessionLogSync(projectId: string, sessionId: string, options: {
+    enabled: boolean;
+    loader?: LoadSessionLogPage | null;
+    joinStream?: (options: SessionControlStreamOptions) => {
+        close: () => void;
+    };
+}): SessionLogDialect;

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

@@ -0,0 +1,134 @@
+'use client';
+import { useEffect, useMemo, useRef, useState } from 'react';
+import { useSandboxConnectionStore } from '../browser/stores/sandbox-connection-store.js';
+import { useSyncStore } from '../browser/stores/sync-store.js';
+import { openSessionStream } from '../core/session/control-stream.js';
+import { savedSessionLogCopies } from '../core/session-log/saved-log.js';
+import { isV1Thread, sessionLogOfV1Rows } from '../core/session-log/v1-view.js';
+import { fetchFirstSessionLogPage, loadSessionLogPage, negotiateSessionLog, } from '../core/session-log/source.js';
+import { currentSavedCopyStore } from '../core/session-sync/saved-copy-store.js';
+import { selectSessionLog, selectSessionLogThread } from '../core/session-log/store.js';
+import { useFeatureFlag } from './use-feature-flag.js';
+import { useSessionMessages } from './use-session-messages.js';
+const sourced = new WeakMap();
+const withSource = (log, source) => {
+    let out = sourced.get(log);
+    if (!out)
+        sourced.set(log, (out = { ...log, source }));
+    return out;
+};
+function useV1SessionLog(session, threadId) {
+    const native = threadId || session.runtimeSessionId || session.opencodeSessionId || null;
+    const rows = useSessionMessages({ ...session, runtimeSessionId: native });
+    return useMemo(() => (native && rows.length ? sessionLogOfV1Rows(session.sessionId, native, rows) : null), [session.sessionId, native, rows]);
+}
+export function useSessionLog(session) {
+    const v2 = useSyncStore((state) => {
+        const log = state.sessionLogs[session.sessionId];
+        return log ? selectSessionLog(log) : null;
+    });
+    const v1 = useV1SessionLog(session);
+    return v2 ? withSource(v2, 'v2') : v1 ? withSource(v1, 'v1') : null;
+}
+export function useSessionLogThread(session, threadId) {
+    const v2 = useSyncStore((state) => {
+        const log = state.sessionLogs[session.sessionId];
+        return log ? selectSessionLogThread(log, threadId) : undefined;
+    });
+    const v1 = useV1SessionLog(session, threadId);
+    return v2 !== undefined ? v2 : (v1?.threads[0] ?? null);
+}
+const pageThreadIsV1 = (page) => isV1Thread(page.threads.find((t) => t.thread_id === page.thread_id));
+export function useSessionLogSync(projectId, sessionId, options) {
+    const loader = options.loader === undefined ? loadSessionLogPage : options.loader;
+    const joinStream = options.joinStream ?? openSessionStream;
+    const active = options.enabled && !!loader && !!projectId && !!sessionId;
+    const live = useSandboxConnectionStore((state) => state.runtimeCapabilities);
+    const served = useRef(null);
+    const key = `${projectId}/${sessionId}`;
+    if (live?.includes('session.log.v2'))
+        served.current = key;
+    const capabilities = served.current === key ? ['session.log.v2'] : live;
+    const flag = useFeatureFlag(active ? projectId : null, 'session_log').enabled;
+    const negotiated = active ? negotiateSessionLog({ capabilities, flag, loader }) : 'v1';
+    const [refusedKey, setRefusedKey] = useState(null);
+    const dialect = negotiated === 'v2' && refusedKey !== key ? 'v2' : 'v1';
+    useEffect(() => {
+        if (negotiated !== 'v2' || !loader)
+            return;
+        const controller = new AbortController();
+        const store = useSyncStore.getState;
+        const copies = savedSessionLogCopies(currentSavedCopyStore());
+        let stream = null;
+        let stopped = false;
+        let busy = false;
+        let lastEnded;
+        const join = (options) => {
+            stream?.close();
+            stream = joinStream({ projectId, sessionId, ...options });
+        };
+        const load = async () => {
+            const page = await fetchFirstSessionLogPage(loader, projectId, sessionId, controller.signal);
+            if (stopped)
+                return null;
+            if (page && pageThreadIsV1(page)) {
+                store().applySessionLogPage(sessionId, page);
+                void copies?.write(projectId, sessionId, page);
+            }
+            return page;
+        };
+        const onReconnect = (run) => {
+            let connected = true;
+            return (up) => {
+                if (up && !connected)
+                    run();
+                connected = up;
+            };
+        };
+        const attempt = async () => {
+            if (busy || stopped)
+                return;
+            busy = true;
+            const page = await load();
+            busy = false;
+            if (stopped)
+                return;
+            if (page && pageThreadIsV1(page)) {
+                setRefusedKey(null);
+                join({ schema: 'v2', onConnectionChange: onReconnect(() => void load()), onRuntimeResync: () => void load() });
+                return;
+            }
+            store().dropSessionLog(sessionId);
+            setRefusedKey(`${projectId}/${sessionId}`);
+            if (page)
+                return;
+            join({
+                onControl: (frame) => {
+                    if (frame.type !== 'beeuni.control.turn')
+                        return;
+                    const ended = frame.payload?.last_ended?.turn_token ?? null;
+                    const seen = lastEnded;
+                    lastEnded = ended;
+                    if (seen !== undefined && ended !== seen)
+                        void attempt();
+                },
+                onConnectionChange: onReconnect(() => void attempt()),
+            });
+        };
+        void (async () => {
+            const saved = await Promise.resolve(copies?.read(projectId, sessionId) ?? null).catch(() => null);
+            if (stopped)
+                return;
+            if (saved && pageThreadIsV1(saved) && !store().sessionLogs[sessionId])
+                store().applySessionLogPage(sessionId, saved);
+            await attempt();
+        })();
+        return () => {
+            stopped = true;
+            controller.abort();
+            stream?.close();
+            store().dropSessionLog(sessionId);
+        };
+    }, [negotiated, loader, joinStream, projectId, sessionId]);
+    return dialect;
+}

package/dist/react/use-session.js

@@ -42,6 +42,7 @@ import { useRuntimePhase } from './use-runtime-phase.js';
 import { useSessionPicks } from './use-session-picks.js';
 import { derivePhase } from './use-session-phase.js';
 import { isEmptyConversation, resolveSavedTranscript } from '../core/session-sync/saved-transcript.js';
+import { useSessionLogSync } from './use-session-log.js';
 import { useSessionSync } from './use-session-sync.js';
 import { selectTranscriptShapeKey } from './session-transcript-subscription.js';
 import { useSessionStartGiveUp } from './use-session-start-give-up.js';
@@ -549,6 +550,7 @@ export function useSession(projectId, sessionId, options = {}) {
     }, [startEnabled, switchedBoxId, refetchStart]);
     useRuntimeEventStream({ enabled: switched, projectId, sessionId });
     const transcriptHistoryEnabled = startEnabled && chatEngine;
+    useSessionLogSync(projectId, sessionId, { enabled: transcriptHistoryEnabled });
     const transcriptHistory = useSessionTranscriptHistory(projectId, sessionId, transcriptHistoryEnabled);
     const canonicalSession = useCanonicalRuntimeSession({
         projectId,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@beeuni/sdk",
-  "version": "0.1.0",
-  "description": "Official Beeuni frontend TypeScript SDK — one typed client for the Beeuni API. Unifies project/session lifecycle and live agent streaming behind a single ergonomic Session handle, so web, mobile, and white-label apps never touch the raw HTTP API or OpenCode semantics.",
+  "version": "0.2.0",
+  "description": "Official Beeuni TypeScript SDK. Connect your product to Beeuni Computer with typed projects, sessions, tools, files, and live agent streaming.",
   "type": "module",
   "license": "Elastic-2.0",
   "homepage": "https://www.beeuni.ai/docs",
@@ -14,7 +14,7 @@
   ],
   "sideEffects": false,
   "dependencies": {
-    "@beeuni/llm-catalog": "0.1.0",
+    "@beeuni/llm-catalog": "0.2.0",
     "zustand": "^5.0.3"
   },
   "peerDependencies": {
@@ -72,6 +72,18 @@
       "types": "./dist/internal/managed-storage.d.ts",
       "import": "./dist/internal/managed-storage.js"
     },
+    "./internal/connector-catalog": {
+      "types": "./dist/internal/connector-catalog.d.ts",
+      "import": "./dist/internal/connector-catalog.js"
+    },
+    "./internal/platform-admin": {
+      "types": "./dist/internal/platform-admin.d.ts",
+      "import": "./dist/internal/platform-admin.js"
+    },
+    "./internal/platform-admin-react": {
+      "types": "./dist/internal/platform-admin-react.d.ts",
+      "import": "./dist/internal/platform-admin-react.js"
+    },
     "./opencode-client": {
       "types": "./dist/deprecated/opencode-client.d.ts",
       "import": "./dist/deprecated/opencode-client.js"
@@ -100,10 +112,6 @@
       "types": "./dist/deprecated/fresh-sessions.d.ts",
       "import": "./dist/deprecated/fresh-sessions.js"
     },
-    "./instance-routes": {
-      "types": "./dist/deprecated/instance-routes.d.ts",
-      "import": "./dist/deprecated/instance-routes.js"
-    },
     "./opencode-errors": {
       "types": "./dist/deprecated/opencode-errors.d.ts",
       "import": "./dist/deprecated/opencode-errors.js"