@neta-art/cohub 2.3.0 → 2.5.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { a as normalizeWebsocketUrl, c as resolveVoiceInputWebsocketUrl, i as normalizeVoiceInputWebsocketUrl, l as resolveWebsocketUrl, n as CohubEnvironment, o as resolveApiBaseUrl, r as normalizeBaseUrl, s as resolveCohubEnvironment, t as COHUB_ENVIRONMENTS } from "./chunks/environment.js";
 import { C as ContentBlock, _ as SessionForkRecord, b as SessionTurnIndexItem, c as createWebsocketClient, f as RealtimeServerEvent, h as MessageRecord, l as ChannelEnvelope, r as WebsocketClient, u as LabelAssignmentsUpdatedEvent, x as SessionTurnRecord, y as SessionTurnSegmentRecord } from "./chunks/websocket.js";
 import { a as VoiceInputCreateOptions, i as VoiceInputClientOptions, l as createVoiceInputClient, n as VoiceInputCallbacks, o as VoiceInputEvent, r as VoiceInputClient, t as VoiceApi } from "./chunks/voice-input.js";
-import { $ as parseAssistantMessageCommit, $n as ResourceLabelsResponse, $r as SpaceInvitation, $t as CanvasDocumentRecord, A as TasksApi, Ai as decodeGenerationPolicy, An as LabelListItem, Ar as SpaceEnvInput, At as BillingCatalog, B as GenerationStreamCommitEvent, Bi as CohubClientOptions, Bn as PromptAccessMode, Br as SpaceFsPreparingFile, Bt as BillingPaymentStatus, C as WorkStatus, Ci as ListGenerationModelsResponse, Cn as InvitationDetail, Cr as SpaceCommerceProductBenefitBinding, Ct as ApiError, D as WorkVisibility, Di as GenerationPolicy, Dn as LabelAssignmentListItem, Dr as SpaceConfigResponse, Dt as BillingBalanceActivityKind, E as WorkVersionRecord, Ei as GenerationParameterConstraint, En as JsonValue, Er as SpaceConfigInput, Et as BillingBalanceActivity, F as SpaceEventName, Fi as normalizeGenerationPolicy, Fn as MeResponse, Fr as SpaceFsEncoding, Ft as BillingCreditExpiryGroup, G as GenerationStreamLifecycleEvent, Gn as ReferenceAggregateGroupBy, Gr as SpaceFsUploadDestination, Gt as BillingProductKind, H as GenerationStreamEvent, Hi as HttpError, Hn as PromptTemplateCatalogResponse, Hr as SpaceFsReadFilesInput, Ht as BillingProductBillingInterval, I as SpacesApi, Ii as parseGenerationPolicyFromEnv, In as ModelCatalogEntry, Ir as SpaceFsEntry, It as BillingCreditGrantStatus, J as GenerationStreamSubscribeOptions, Jn as ReferenceKind, Jr as SpaceFsUploadPlanEntry, Jt as BillingSubscriptionHistoryList, K as GenerationStreamOutOfSyncEvent, Kn as ReferenceAggregateResponse, Kr as SpaceFsUploadEntry, Kt as BillingProductPricing, L as WebSocketConnectionState, Li as GenerationContentBlock, Ln as PatchResourceLabelsInput, Lr as SpaceFsFileKind, Lt as BillingCreditStatus, M as SessionSubscriptionHandlers, Mi as filterGenerationDeclarationsByPolicy, Mn as LabelResourceType, Mr as SpaceFsCompleteUploadResponse, Mt as BillingCheckoutActionState, N as SpaceChannelBindingRecord, Ni as findGenerationModelPolicy, Nn as LabelScopeType, Nr as SpaceFsCreateUploadInput, Nt as BillingCheckoutResult, O as WorksApi, Oi as GenerationPolicyError, On as LabelAssignmentPageInfo, Or as SpaceCreateResponse, Ot as BillingBalanceActivityList, P as SpaceClient, Pi as getAllowedGenerationModelIds, Pn as LabelSource, Pr as SpaceFsCreateUploadResponse, Pt as BillingConversionIntent, Q as createSessionGenerationStreamClient, Qn as ReferenceResourceType, Qr as SpaceFsWriteFileInput, Qt as CanvasCreateInput, R as PublicInviteApi, Ri as ChannelConfig, Rn as PatchResourceLabelsResponse, Rr as SpaceFsFileResponse, Rt as BillingCreditUnit, S as WorkSessionResponse, Si as GenerationTaskResult, Sn as GlobalSearchType, Sr as SpaceCommerceProduct, St as AcceptInvitationResponse, T as WorkUpdateInput, Ti as GenerationModelPolicy, Tn as JsonPrimitive, Tr as SpaceConfig, Tt as BillingAccessWarning, U as GenerationStreamFinalizedEvent, Ui as HttpTransport, Un as PublicUserProfile, Ur as SpaceFsReadFilesResponse, Ut as BillingProductCreditBenefit, V as GenerationStreamErrorEvent, Vi as Fetch, Vn as PromptTemplateCatalogEntry, Vr as SpaceFsReadFilesError, Vt as BillingPluginStatus, W as GenerationStreamIntermediateMessage, Wi as RawHttpResponse, Wn as ReferenceAggregateGroup, Wr as SpaceFsTreeResponse, Wt as BillingProductDisplay, X as GenerationStreamTurnUpdatedEvent, Xn as ReferenceQueryableType, Xr as SpaceFsUploadProgress, Xt as BillingSubscriptionSummary, Y as GenerationStreamSubscriptionHandlers, Yn as ReferenceQueryResponse, Yr as SpaceFsUploadPlanEntryInput, Yt as BillingSubscriptionHistoryStatus, Z as SessionGenerationStreamClient, Zn as ReferenceRecord, Zr as SpaceFsUploadResponse, Zt as CanvasBootstrapResponse, _ as WorkPresentationMeta, _i as TaskRunRecord, _n as ExploreSection, _r as SpaceCommerceBenefit, _t as PromptsApi, a as WorkCommerceCreditConsumeResponse, ai as SpacePresenceUser, an as CheckpointRecord, ar as SessionRecord, at as createSessionPatchReducer, b as WorkRecord, bi as CreateGenerationTaskRequest, bn as GlobalSearchResponse, br as SpaceCommerceFeatureBenefit, bt as CronJobsApi, c as WorkCommerceEntitlementsResponse, ci as SpaceRole, cn as CreateSpaceInput, cr as SessionTurnSignedUrlsResponse, ct as ReferencesApi, d as WorkCommercePurchaseResponse, di as SpaceSandboxProvider, dn as CreateSpacePromptResponse, dr as SessionTurnsPaginatedResponse, dt as CreatePublicAssetUploadResponse, ei as SpaceListItem, en as CanvasNodeInput, er as SendMessageCronJobPayload, et as SessionPatchApplyInput, f as WorkAuthorizeResponse, fi as SpaceSessionsResponse, fn as CreateSpaceSessionInput, fr as SpaceAccess, ft as PublicAssetMimeType, g as WorkMeta, gi as TaskRunDetailResponse, gn as CursorPageInfo, gr as SpaceCheckpointDetailResponse, gt as UploadPublicAssetInput, h as WorkGetResponse, hi as SpaceUsageSummary, hn as CronJobUpdatePatch, hr as SpaceChannelBindingInput, ht as UploadChatImageAttachmentInput, i as WorkCommerceCheckoutStatus, ii as SpacePresenceSnapshot, in as Channel, ir as SessionMessagesResponse, it as SessionPatchStatus, j as SessionEventName, ji as encodeGenerationPolicy, jn as LabelRecord, jr as SpaceFsCompleteUploadInput, jt as BillingCatalogProduct, k as UserApi, ki as assertGenerationRequestAllowedByPolicy, kn as LabelAssignmentRecord, kr as SpaceDefaultResponse, kt as BillingBalanceActivityStatus, l as WorkCommerceOrder, li as SpaceSandboxAutoDestroyPolicy, ln as CreateSpaceModInput, lr as SessionTurnStreamSnapshotResponse, lt as SearchApi, m as WorkDetailResponse, mi as SpaceUsageResponse, mn as CronJobRecord, mr as SpaceBootstrapSource, mt as PublicAssetsApi, n as createHttpClient, ni as SpaceMeta, nn as CanvasSemanticOp, nr as SessionMessageResponse, nt as SessionPatchReducer, o as WorkCommerceCreditConsumeStatus, oi as SpacePublicProfile, on as CreateInvitationInput, or as SessionTurnIndexResponse, ot as SessionAccessApi, p as WorkCreateInput, pi as SpaceUsageHourlyStat, pn as CronJobPayload, pr as SpaceAccessPolicy, pt as PublicAssetPurpose, q as GenerationStreamStateEvent, qn as ReferenceDirection, qr as SpaceFsUploadError, qt as BillingRedemptionResult, r as WorkCommerceApi, ri as SpaceModListItem, rn as CanvasTransactionInput, rr as SessionMessagesPaginatedResponse, rt as SessionPatchState, s as WorkCommerceEntitlement, si as SpaceRecord, sn as CreateInvitationResponse, sr as SessionTurnResponse, st as ReferenceResourceSelector, t as CohubHttpClient, ti as SpaceMember, tn as CanvasNodeRecord, tr as SessionBindingRecord, tt as SessionPatchApplyResult, u as WorkCommerceProductResolveResponse, ui as SpaceSandboxConfig, un as CreateSpacePromptInput, ur as SessionTurnWindowResponse, ut as CreatePublicAssetUploadInput, v as WorkPublicOwnerRecord, vi as UserProfile, vn as ExploreSpaceItem, vr as SpaceCommerceBuyerProfile, vt as ModelsApi, w as WorkTargetType, wi as PublicGenerationDeclaration, wn as JsonObject, wr as SpaceCommerceProductCreditBenefit, wt as BatchUserProfilesResponse, x as WorkResolveResponse, xi as CreateGenerationTaskResponse, xn as GlobalSearchResult, xr as SpaceCommerceOrder, xt as ChannelsApi, y as WorkPublicSpaceRecord, yi as UserRulesResponse, yn as ExploreSpacesResponse, yr as SpaceCommerceCreditsBenefit, yt as GenerationsApi, z as AssistantMessageCommit, zi as DiscordChannelConfig, zn as Permission, zr as SpaceFsMoveInput, zt as BillingHistoryPagination } from "./chunks/http.js";
+import { $ as parseAssistantMessageCommit, $i as GenerationContentBlock, $n as PatchResourceLabelsInput, $r as SpaceFsFileKind, $t as BillingCreditStatus, A as TasksApi, Ai as SpaceUsageResponse, An as CronJobRecord, Ar as SpaceBootstrapSource, At as WorkRuntimeCheckoutState, B as GenerationStreamCommitEvent, Bi as PublicGenerationDeclaration, Bn as JsonObject, Br as SpaceCommerceProductCreditBenefit, Bt as BatchUserProfilesResponse, C as WorkStatus, Ci as SpaceRecord, Cn as CreateInvitationResponse, Cr as SessionTurnResponse, Ct as Fetch, D as WorkVisibility, Di as SpaceSandboxProvider, Dn as CreateSpacePromptResponse, Dr as SessionTurnsPaginatedResponse, Dt as ParentBridgeTransport, E as WorkVersionRecord, Ei as SpaceSandboxConfig, En as CreateSpacePromptInput, Er as SessionTurnWindowResponse, Et as RawHttpResponse, F as SpaceEventName, Fi as UserRulesResponse, Fn as ExploreSpacesResponse, Fr as SpaceCommerceCreditsBenefit, Ft as WorkRuntimeTransport, G as GenerationStreamLifecycleEvent, Gi as assertGenerationRequestAllowedByPolicy, Gn as LabelAssignmentRecord, Gr as SpaceDefaultResponse, Gt as BillingBalanceActivityStatus, H as GenerationStreamEvent, Hi as GenerationParameterConstraint, Hn as JsonValue, Hr as SpaceConfigInput, Ht as BillingBalanceActivity, I as SpacesApi, Ii as CreateGenerationTaskRequest, In as GlobalSearchResponse, Ir as SpaceCommerceFeatureBenefit, It as createWorkRuntime, J as GenerationStreamSubscribeOptions, Ji as filterGenerationDeclarationsByPolicy, Jn as LabelResourceType, Jr as SpaceFsCompleteUploadResponse, Jt as BillingCheckoutActionState, K as GenerationStreamOutOfSyncEvent, Ki as decodeGenerationPolicy, Kn as LabelListItem, Kr as SpaceEnvInput, Kt as BillingCatalog, L as WebSocketConnectionState, Li as CreateGenerationTaskResponse, Ln as GlobalSearchResult, Lr as SpaceCommerceOrder, Lt as resolveWorkTransport, M as SessionSubscriptionHandlers, Mi as TaskRunDetailResponse, Mn as CursorPageInfo, Mr as SpaceCheckpointDetailResponse, Mt as WorkRuntimeContext, N as SpaceChannelBindingRecord, Ni as TaskRunRecord, Nn as ExploreSection, Nr as SpaceCommerceBenefit, Nt as WorkRuntimeModeConfig, O as WorksApi, Oi as SpaceSessionsResponse, On as CreateSpaceSessionInput, Or as SpaceAccess, Ot as PopupBrokerTransport, P as SpaceClient, Pi as UserProfile, Pn as ExploreSpaceItem, Pr as SpaceCommerceBuyerProfile, Pt as WorkRuntimeRequestOptions, Q as createSessionGenerationStreamClient, Qi as parseGenerationPolicyFromEnv, Qn as ModelCatalogEntry, Qr as SpaceFsEntry, Qt as BillingCreditGrantStatus, R as PublicInviteApi, Ri as GenerationTaskResult, Rn as GlobalSearchType, Rr as SpaceCommerceProduct, Rt as AcceptInvitationResponse, S as WorkSessionResponse, Si as SpacePublicProfile, Sn as CreateInvitationInput, Sr as SessionTurnIndexResponse, St as CohubClientOptions, T as WorkUpdateInput, Ti as SpaceSandboxAutoDestroyPolicy, Tn as CreateSpaceModInput, Tr as SessionTurnStreamSnapshotResponse, Tt as HttpTransport, U as GenerationStreamFinalizedEvent, Ui as GenerationPolicy, Un as LabelAssignmentListItem, Ur as SpaceConfigResponse, Ut as BillingBalanceActivityKind, V as GenerationStreamErrorEvent, Vi as GenerationModelPolicy, Vn as JsonPrimitive, Vr as SpaceConfig, Vt as BillingAccessWarning, W as GenerationStreamIntermediateMessage, Wi as GenerationPolicyError, Wn as LabelAssignmentPageInfo, Wr as SpaceCreateResponse, Wt as BillingBalanceActivityList, X as GenerationStreamTurnUpdatedEvent, Xi as getAllowedGenerationModelIds, Xn as LabelSource, Xr as SpaceFsCreateUploadResponse, Xt as BillingConversionIntent, Y as GenerationStreamSubscriptionHandlers, Yi as findGenerationModelPolicy, Yn as LabelScopeType, Yr as SpaceFsCreateUploadInput, Yt as BillingCheckoutResult, Z as SessionGenerationStreamClient, Zi as normalizeGenerationPolicy, Zn as MeResponse, Zr as SpaceFsEncoding, Zt as BillingCreditExpiryGroup, _ as WorkPresentationMeta, _i as SpaceMember, _n as CanvasNodeRecord, _r as SessionBindingRecord, _t as PromptsApi, a as WorkCommerceCreditConsumeResponse, ai as SpaceFsReadFilesResponse, an as BillingProductCreditBenefit, ar as PublicUserProfile, at as createSessionPatchReducer, b as WorkRecord, bi as SpacePresenceSnapshot, bn as Channel, br as SessionMessagesResponse, bt as CronJobsApi, c as WorkCommerceEntitlementsResponse, ci as SpaceFsUploadEntry, cn as BillingProductPricing, cr as ReferenceAggregateResponse, ct as ReferencesApi, d as WorkCommercePurchaseResponse, di as SpaceFsUploadPlanEntryInput, dn as BillingSubscriptionHistoryStatus, dr as ReferenceQueryResponse, dt as CreatePublicAssetUploadResponse, ea as ChannelConfig, ei as SpaceFsFileResponse, en as BillingCreditUnit, er as PatchResourceLabelsResponse, et as SessionPatchApplyInput, f as WorkAuthorizeResponse, fi as SpaceFsUploadProgress, fn as BillingSubscriptionSummary, fr as ReferenceQueryableType, ft as PublicAssetMimeType, g as WorkMeta, gi as SpaceListItem, gn as CanvasNodeInput, gr as SendMessageCronJobPayload, gt as UploadPublicAssetInput, h as WorkGetResponse, hi as SpaceInvitation, hn as CanvasDocumentRecord, hr as ResourceLabelsResponse, ht as UploadChatImageAttachmentInput, i as WorkCommerceCheckoutStatus, ii as SpaceFsReadFilesInput, in as BillingProductBillingInterval, ir as PromptTemplateCatalogResponse, it as SessionPatchStatus, j as SessionEventName, ji as SpaceUsageSummary, jn as CronJobUpdatePatch, jr as SpaceChannelBindingInput, jt as WorkRuntimeCheckoutStatus, k as UserApi, ki as SpaceUsageHourlyStat, kn as CronJobPayload, kr as SpaceAccessPolicy, kt as WorkRuntimeApi, l as WorkCommerceOrder, li as SpaceFsUploadError, ln as BillingRedemptionResult, lr as ReferenceDirection, lt as SearchApi, m as WorkDetailResponse, mi as SpaceFsWriteFileInput, mn as CanvasCreateInput, mr as ReferenceResourceType, mt as PublicAssetsApi, n as createHttpClient, ni as SpaceFsPreparingFile, nn as BillingPaymentStatus, nr as PromptAccessMode, nt as SessionPatchReducer, o as WorkCommerceCreditConsumeStatus, oi as SpaceFsTreeResponse, on as BillingProductDisplay, or as ReferenceAggregateGroup, ot as SessionAccessApi, p as WorkCreateInput, pi as SpaceFsUploadResponse, pn as CanvasBootstrapResponse, pr as ReferenceRecord, pt as PublicAssetPurpose, q as GenerationStreamStateEvent, qi as encodeGenerationPolicy, qn as LabelRecord, qr as SpaceFsCompleteUploadInput, qt as BillingCatalogProduct, r as WorkCommerceApi, ri as SpaceFsReadFilesError, rn as BillingPluginStatus, rr as PromptTemplateCatalogEntry, rt as SessionPatchState, s as WorkCommerceEntitlement, si as SpaceFsUploadDestination, sn as BillingProductKind, sr as ReferenceAggregateGroupBy, st as ReferenceResourceSelector, t as CohubHttpClient, ta as DiscordChannelConfig, ti as SpaceFsMoveInput, tn as BillingHistoryPagination, tr as Permission, tt as SessionPatchApplyResult, u as WorkCommerceProductResolveResponse, ui as SpaceFsUploadPlanEntry, un as BillingSubscriptionHistoryList, ur as ReferenceKind, ut as CreatePublicAssetUploadInput, v as WorkPublicOwnerRecord, vi as SpaceMeta, vn as CanvasSemanticOp, vr as SessionMessageResponse, vt as ModelsApi, w as WorkTargetType, wi as SpaceRole, wn as CreateSpaceInput, wr as SessionTurnSignedUrlsResponse, wt as HttpError, x as WorkResolveResponse, xi as SpacePresenceUser, xn as CheckpointRecord, xr as SessionRecord, xt as ChannelsApi, y as WorkPublicSpaceRecord, yi as SpaceModListItem, yn as CanvasTransactionInput, yr as SessionMessagesPaginatedResponse, yt as GenerationsApi, z as AssistantMessageCommit, zi as ListGenerationModelsResponse, zn as InvitationDetail, zr as SpaceCommerceProductBenefitBinding, zt as ApiError } from "./chunks/http.js";
 
 //#region src/apis/billing.d.ts
 declare class BillingApi {
@@ -52,56 +52,6 @@ declare class BillingApi {
   }>;
 }
 //#endregion
-//#region src/work-runtime.d.ts
-type WorkRuntimeContext = {
-  work: {
-    id: string;
-    slug: string;
-    url?: string | null;
-  };
-  space: {
-    id: string;
-    name?: string | null;
-  };
-  viewer?: {
-    userUuid: string;
-  } | null;
-  permissions?: {
-    scopes: Permission[];
-    workScopes: Permission[];
-    viewerScopes: Permission[];
-  };
-};
-type WorkRuntimeCheckoutStatus = "success" | "failed" | "cancel" | null;
-type WorkRuntimeCheckoutState = {
-  status: WorkRuntimeCheckoutStatus;
-  orderId: string | null;
-};
-declare class WorkRuntimeApi {
-  private token;
-  context(): Promise<WorkRuntimeContext | null>;
-  getAccessToken(options?: {
-    forceRefresh?: boolean;
-  }): Promise<string | null>;
-  requestAuthorization(input: {
-    scopes: Permission[];
-    reason?: string;
-  }): Promise<boolean>;
-  purchase(input: {
-    productKey: string;
-  }): Promise<{
-    providerKey: string | null;
-    checkoutUrl: string | null;
-    checkoutUsable: boolean;
-    status: string | null;
-    message: string | null;
-    orderId: string;
-    productKey: string;
-  } | null>;
-  checkoutState(): Promise<WorkRuntimeCheckoutState | null>;
-}
-declare const createWorkRuntime: () => WorkRuntimeApi;
-//#endregion
 //#region src/apis/explore.d.ts
 declare class ExploreApi {
   private readonly transport;
@@ -186,9 +136,119 @@ declare class CohubClient {
 }
 declare const createCohubClient: (options?: CohubClientOptions) => CohubClient;
 //#endregion
+//#region src/work-bridge-core.d.ts
+/**
+ * The subset of a work record the bridge host needs to answer bridge messages.
+ * Matches what the iframe host (WorkSurface) and the broker page both have on
+ * hand after loading the work.
+ */
+type WorkBridgeCoreWork = Pick<WorkRecord, "id" | "spaceId" | "slug" | "userUuid" | "workScopes" | "allowedViewerScopes">;
+/**
+ * A pending authorize request surfaced to the UI as a consent dialog.
+ */
+type WorkAuthorizeRequest = {
+  requestId: string;
+  scopes: Permission[];
+  reason?: string;
+};
+/**
+ * A pending purchase request surfaced to the UI as a checkout confirmation.
+ */
+type WorkPurchaseRequest = {
+  requestId: string;
+  productKey: string;
+};
+/**
+ * Reactive dialog state managed by the core. The host (Svelte or React)
+ * subscribes via {@link WorkBridgeCoreConfig.onStateChange} and mirrors these
+ * fields into its own reactive primitives.
+ */
+type WorkBridgeDialogState = {
+  authOpen: boolean;
+  pendingAuth: WorkAuthorizeRequest | null;
+  authError: string | null;
+  authSaving: boolean;
+  purchaseOpen: boolean;
+  pendingPurchase: WorkPurchaseRequest | null;
+  purchaseError: string | null;
+  purchaseSaving: boolean;
+};
+/**
+ * Resolves the current user's Cohub API access token. The core uses this to
+ * mint work session / authorization tokens via the Cohub API.
+ */
+type WorkBridgeGetAccessToken = (options?: {
+  forceRefresh?: boolean;
+}) => Promise<string | null>;
+/**
+ * Resolves the current viewer's user UUID (or null when unauthenticated).
+ * Used for ownership checks and silent re-authorization cache lookups.
+ */
+type WorkBridgeGetViewerUuid = () => Promise<string | null>;
+/**
+ * Requests the host to start a sign-in flow, redirecting back to the given
+ * path afterward. The core calls this when an API request fails due to missing
+ * authentication.
+ */
+type WorkBridgeRequestSignIn = (redirectPath: string) => Promise<void>;
+/**
+ * Configuration injected by the caller. The core is transport-agnostic: how a
+ * reply is delivered back to the work (iframe postMessage vs opener
+ * postMessage) and how the current checkout state is read (page URL) are the
+ * caller's responsibility, so the same core serves both bridge and broker
+ * hosts. Auth dependencies (token resolution, viewer identity, sign-in) are
+ * also injected so the core stays free of any framework's store/auth plumbing.
+ */
+type WorkBridgeCoreConfig = {
+  work: WorkBridgeCoreWork; /** True when running as a background chat surface (owner auto-authorizes). */
+  isBackground?: boolean; /** Base origin for Cohub API requests (e.g. "https://cohub.run"). */
+  apiOrigin: string; /** Sends a reply payload back to the work runtime. */
+  reply: (requestId: string, payload: Record<string, unknown>) => void; /** Reads the current checkout state (typically derived from the page URL). */
+  getCheckoutState: () => WorkRuntimeCheckoutState; /** Resolves the current user's Cohub access token. */
+  getAccessToken: WorkBridgeGetAccessToken; /** Resolves the current viewer's user UUID. */
+  getViewerUuid: WorkBridgeGetViewerUuid; /** Starts a sign-in flow with a post-login redirect path. */
+  requestSignIn: WorkBridgeRequestSignIn; /** Called whenever the dialog state changes, for reactive UI binding. */
+  onStateChange?: (state: WorkBridgeDialogState) => void;
+};
+type WorkBridgeCore = {
+  /** Returns a snapshot of the current dialog state. */getState: () => WorkBridgeDialogState; /** Processes an inbound bridge message (already source/origin-validated). */
+  handleMessage: (event: MessageEvent) => Promise<void>; /** Confirm/cancel handlers for the authorize dialog. */
+  confirmAuth: () => Promise<void>;
+  cancelAuth: () => void; /** Confirm/cancel handlers for the purchase dialog. */
+  confirmPurchase: () => Promise<void>;
+  cancelPurchase: () => void;
+};
+/**
+ * Framework-agnostic work bridge host core — message handling, work session
+ * token minting, authorization (with silent re-grant cache), and
+ * purchase/checkout flow — without any rendering or reactive primitives.
+ *
+ * Both the Cohub iframe host (WorkSurface, Svelte) and the standalone broker
+ * page compose this with their own transport-specific reply and auth
+ * dependencies. External hosts (e.g. Neta-Studio in React) can do the same.
+ */
+declare function createWorkBridgeCore(config: WorkBridgeCoreConfig): WorkBridgeCore;
+//#endregion
+//#region src/work-grant-cache.d.ts
+/**
+ * Returns true when the viewer has previously granted every requested scope
+ * for this work, allowing a silent re-authorization.
+ */
+declare function hasGrantedWorkScopes(userUuid: string | null | undefined, workId: string, scopes: readonly Permission[]): boolean;
+/**
+ * Records the granted scopes for a work, merged with any previously granted
+ * scopes so a growing permission set stays covered.
+ */
+declare function setGrantedWorkScopes(userUuid: string | null | undefined, workId: string, scopes: readonly Permission[]): void;
+/**
+ * Clears cached grants. Pass a workId to clear a single work, or omit it to
+ * clear every cached grant for the user (used on sign-out).
+ */
+declare function clearGrantedWorkScopes(userUuid: string | null | undefined, workId?: string): void;
+//#endregion
 //#region src/http-error.d.ts
 declare function isHttpErrorCode(error: unknown, code: string): error is HttpError & {
   code: string;
 };
 //#endregion
-export { AcceptInvitationResponse, ApiError, type AssistantMessageCommit, BatchUserProfilesResponse, BillingAccessWarning, BillingApi, BillingBalanceActivity, BillingBalanceActivityKind, BillingBalanceActivityList, BillingBalanceActivityStatus, BillingCatalog, BillingCatalogProduct, BillingCheckoutActionState, BillingCheckoutResult, BillingConversionIntent, BillingCreditExpiryGroup, BillingCreditGrantStatus, BillingCreditStatus, BillingCreditUnit, BillingHistoryPagination, BillingPaymentStatus, BillingPluginStatus, BillingProductBillingInterval, BillingProductCreditBenefit, BillingProductDisplay, BillingProductKind, BillingProductPricing, BillingRedemptionResult, BillingSubscriptionHistoryList, BillingSubscriptionHistoryStatus, BillingSubscriptionSummary, COHUB_ENVIRONMENTS, CanvasBootstrapResponse, CanvasCreateInput, CanvasDocumentRecord, CanvasNodeInput, CanvasNodeRecord, CanvasSemanticOp, CanvasTransactionInput, Channel, type ChannelConfig, type ChannelEnvelope, CheckpointRecord, CohubClient, type CohubClientOptions, type CohubEnvironment, CohubHttpClient, type ContentBlock, type CreateGenerationTaskRequest, type CreateGenerationTaskResponse, CreateInvitationInput, CreateInvitationResponse, type CreatePublicAssetUploadInput, type CreatePublicAssetUploadResponse, CreateSpaceInput, CreateSpaceModInput, CreateSpacePromptInput, CreateSpacePromptResponse, CreateSpaceSessionInput, CronJobPayload, CronJobRecord, CronJobUpdatePatch, CursorPageInfo, type DiscordChannelConfig, ExploreSection, ExploreSpaceItem, ExploreSpacesResponse, type Fetch, type GenerationContentBlock, type GenerationModelPolicy, type GenerationParameterConstraint, type GenerationPolicy, GenerationPolicyError, type GenerationStreamCommitEvent, type GenerationStreamErrorEvent, type GenerationStreamEvent, type GenerationStreamFinalizedEvent, type GenerationStreamIntermediateMessage, type GenerationStreamLifecycleEvent, type GenerationStreamOutOfSyncEvent, type GenerationStreamStateEvent, type GenerationStreamSubscribeOptions, type GenerationStreamSubscriptionHandlers, type GenerationStreamTurnUpdatedEvent, type GenerationTaskResult, GlobalSearchResponse, GlobalSearchResult, GlobalSearchType, HttpError, InvitationDetail, JsonObject, JsonPrimitive, JsonValue, LabelAssignmentListItem, LabelAssignmentPageInfo, LabelAssignmentRecord, type LabelAssignmentsUpdatedEvent, LabelListItem, LabelRecord, LabelResourceType, LabelScopeType, LabelSource, type ListGenerationModelsResponse, MeResponse, type MessageRecord, ModelCatalogEntry, PatchResourceLabelsInput, PatchResourceLabelsResponse, Permission, PromptAccessMode, PromptTemplateCatalogEntry, PromptTemplateCatalogResponse, type PublicAssetMimeType, type PublicAssetPurpose, type PublicGenerationDeclaration, PublicUserProfile, type RawHttpResponse, type RealtimeServerEvent, ReferenceAggregateGroup, ReferenceAggregateGroupBy, ReferenceAggregateResponse, ReferenceDirection, ReferenceKind, ReferenceQueryResponse, ReferenceQueryableType, ReferenceRecord, type ReferenceResourceSelector, ReferenceResourceType, ReferencesApi, ResourceLabelsResponse, SendMessageCronJobPayload, SessionBindingRecord, type SessionEventName, type SessionForkRecord, SessionGenerationStreamClient, SessionMessageResponse, SessionMessagesPaginatedResponse, SessionMessagesResponse, type SessionPatchApplyInput, type SessionPatchApplyResult, SessionPatchReducer, type SessionPatchState, type SessionPatchStatus, SessionRecord, type SessionSubscriptionHandlers, type SessionTurnIndexItem, SessionTurnIndexResponse, type SessionTurnRecord, SessionTurnResponse, type SessionTurnSegmentRecord, SessionTurnSignedUrlsResponse, SessionTurnStreamSnapshotResponse, SessionTurnWindowResponse, SessionTurnsPaginatedResponse, SpaceAccess, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, type SpaceChannelBindingRecord, SpaceCheckpointDetailResponse, SpaceCommerceBenefit, SpaceCommerceBuyerProfile, SpaceCommerceCreditsBenefit, SpaceCommerceFeatureBenefit, SpaceCommerceOrder, SpaceCommerceProduct, SpaceCommerceProductBenefitBinding, SpaceCommerceProductCreditBenefit, SpaceConfig, SpaceConfigInput, SpaceConfigResponse, SpaceCreateResponse, SpaceDefaultResponse, SpaceEnvInput, type SpaceEventName, SpaceFsCompleteUploadInput, SpaceFsCompleteUploadResponse, SpaceFsCreateUploadInput, SpaceFsCreateUploadResponse, SpaceFsEncoding, SpaceFsEntry, SpaceFsFileKind, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsPreparingFile, SpaceFsReadFilesError, SpaceFsReadFilesInput, SpaceFsReadFilesResponse, SpaceFsTreeResponse, SpaceFsUploadDestination, SpaceFsUploadEntry, SpaceFsUploadError, SpaceFsUploadPlanEntry, SpaceFsUploadPlanEntryInput, SpaceFsUploadProgress, SpaceFsUploadResponse, SpaceFsWriteFileInput, SpaceInvitation, SpaceListItem, SpaceMember, SpaceMeta, SpaceModListItem, SpacePresenceSnapshot, SpacePresenceUser, SpacePublicProfile, SpaceRecord, SpaceRole, SpaceSandboxAutoDestroyPolicy, SpaceSandboxConfig, SpaceSandboxProvider, SpaceSessionsResponse, SpaceUsageHourlyStat, SpaceUsageResponse, SpaceUsageSummary, TaskRunDetailResponse, TaskRunRecord, type UploadChatImageAttachmentInput, type UploadPublicAssetInput, UserProfile, UserRulesResponse, UsersApi, VoiceApi, type VoiceInputCallbacks, VoiceInputClient, type VoiceInputClientOptions, type VoiceInputCreateOptions, type VoiceInputEvent, type WebSocketConnectionState, WebsocketClient, type WorkAuthorizeResponse, WorkCommerceApi, type WorkCommerceCheckoutStatus, type WorkCommerceCreditConsumeResponse, type WorkCommerceCreditConsumeStatus, type WorkCommerceEntitlement, type WorkCommerceEntitlementsResponse, type WorkCommerceOrder, type WorkCommerceProductResolveResponse, type WorkCommercePurchaseResponse, type WorkCreateInput, type WorkDetailResponse, type WorkGetResponse, type WorkMeta, type WorkPresentationMeta, type WorkPublicOwnerRecord, type WorkPublicSpaceRecord, type WorkRecord, type WorkResolveResponse, WorkRuntimeApi, type WorkRuntimeCheckoutState, type WorkRuntimeCheckoutStatus, type WorkRuntimeContext, type WorkSessionResponse, type WorkStatus, type WorkTargetType, type WorkUpdateInput, type WorkVersionRecord, type WorkVisibility, WorksApi, assertGenerationRequestAllowedByPolicy, createCohubClient, createHttpClient, createSessionGenerationStreamClient, createSessionPatchReducer, createVoiceInputClient, createWebsocketClient, createWorkRuntime, decodeGenerationPolicy, encodeGenerationPolicy, filterGenerationDeclarationsByPolicy, findGenerationModelPolicy, getAllowedGenerationModelIds, isHttpErrorCode, normalizeBaseUrl, normalizeGenerationPolicy, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, parseAssistantMessageCommit, parseGenerationPolicyFromEnv, resolveApiBaseUrl, resolveCohubEnvironment, resolveVoiceInputWebsocketUrl, resolveWebsocketUrl };
+export { AcceptInvitationResponse, ApiError, type AssistantMessageCommit, BatchUserProfilesResponse, BillingAccessWarning, BillingApi, BillingBalanceActivity, BillingBalanceActivityKind, BillingBalanceActivityList, BillingBalanceActivityStatus, BillingCatalog, BillingCatalogProduct, BillingCheckoutActionState, BillingCheckoutResult, BillingConversionIntent, BillingCreditExpiryGroup, BillingCreditGrantStatus, BillingCreditStatus, BillingCreditUnit, BillingHistoryPagination, BillingPaymentStatus, BillingPluginStatus, BillingProductBillingInterval, BillingProductCreditBenefit, BillingProductDisplay, BillingProductKind, BillingProductPricing, BillingRedemptionResult, BillingSubscriptionHistoryList, BillingSubscriptionHistoryStatus, BillingSubscriptionSummary, COHUB_ENVIRONMENTS, CanvasBootstrapResponse, CanvasCreateInput, CanvasDocumentRecord, CanvasNodeInput, CanvasNodeRecord, CanvasSemanticOp, CanvasTransactionInput, Channel, type ChannelConfig, type ChannelEnvelope, CheckpointRecord, CohubClient, type CohubClientOptions, type CohubEnvironment, CohubHttpClient, type ContentBlock, type CreateGenerationTaskRequest, type CreateGenerationTaskResponse, CreateInvitationInput, CreateInvitationResponse, type CreatePublicAssetUploadInput, type CreatePublicAssetUploadResponse, CreateSpaceInput, CreateSpaceModInput, CreateSpacePromptInput, CreateSpacePromptResponse, CreateSpaceSessionInput, CronJobPayload, CronJobRecord, CronJobUpdatePatch, CursorPageInfo, type DiscordChannelConfig, ExploreSection, ExploreSpaceItem, ExploreSpacesResponse, type Fetch, type GenerationContentBlock, type GenerationModelPolicy, type GenerationParameterConstraint, type GenerationPolicy, GenerationPolicyError, type GenerationStreamCommitEvent, type GenerationStreamErrorEvent, type GenerationStreamEvent, type GenerationStreamFinalizedEvent, type GenerationStreamIntermediateMessage, type GenerationStreamLifecycleEvent, type GenerationStreamOutOfSyncEvent, type GenerationStreamStateEvent, type GenerationStreamSubscribeOptions, type GenerationStreamSubscriptionHandlers, type GenerationStreamTurnUpdatedEvent, type GenerationTaskResult, GlobalSearchResponse, GlobalSearchResult, GlobalSearchType, HttpError, InvitationDetail, JsonObject, JsonPrimitive, JsonValue, LabelAssignmentListItem, LabelAssignmentPageInfo, LabelAssignmentRecord, type LabelAssignmentsUpdatedEvent, LabelListItem, LabelRecord, LabelResourceType, LabelScopeType, LabelSource, type ListGenerationModelsResponse, MeResponse, type MessageRecord, ModelCatalogEntry, ParentBridgeTransport, PatchResourceLabelsInput, PatchResourceLabelsResponse, Permission, PopupBrokerTransport, PromptAccessMode, PromptTemplateCatalogEntry, PromptTemplateCatalogResponse, type PublicAssetMimeType, type PublicAssetPurpose, type PublicGenerationDeclaration, PublicUserProfile, type RawHttpResponse, type RealtimeServerEvent, ReferenceAggregateGroup, ReferenceAggregateGroupBy, ReferenceAggregateResponse, ReferenceDirection, ReferenceKind, ReferenceQueryResponse, ReferenceQueryableType, ReferenceRecord, type ReferenceResourceSelector, ReferenceResourceType, ReferencesApi, ResourceLabelsResponse, SendMessageCronJobPayload, SessionBindingRecord, type SessionEventName, type SessionForkRecord, SessionGenerationStreamClient, SessionMessageResponse, SessionMessagesPaginatedResponse, SessionMessagesResponse, type SessionPatchApplyInput, type SessionPatchApplyResult, SessionPatchReducer, type SessionPatchState, type SessionPatchStatus, SessionRecord, type SessionSubscriptionHandlers, type SessionTurnIndexItem, SessionTurnIndexResponse, type SessionTurnRecord, SessionTurnResponse, type SessionTurnSegmentRecord, SessionTurnSignedUrlsResponse, SessionTurnStreamSnapshotResponse, SessionTurnWindowResponse, SessionTurnsPaginatedResponse, SpaceAccess, SpaceAccessPolicy, SpaceBootstrapSource, SpaceChannelBindingInput, type SpaceChannelBindingRecord, SpaceCheckpointDetailResponse, SpaceCommerceBenefit, SpaceCommerceBuyerProfile, SpaceCommerceCreditsBenefit, SpaceCommerceFeatureBenefit, SpaceCommerceOrder, SpaceCommerceProduct, SpaceCommerceProductBenefitBinding, SpaceCommerceProductCreditBenefit, SpaceConfig, SpaceConfigInput, SpaceConfigResponse, SpaceCreateResponse, SpaceDefaultResponse, SpaceEnvInput, type SpaceEventName, SpaceFsCompleteUploadInput, SpaceFsCompleteUploadResponse, SpaceFsCreateUploadInput, SpaceFsCreateUploadResponse, SpaceFsEncoding, SpaceFsEntry, SpaceFsFileKind, SpaceFsFileResponse, SpaceFsMoveInput, SpaceFsPreparingFile, SpaceFsReadFilesError, SpaceFsReadFilesInput, SpaceFsReadFilesResponse, SpaceFsTreeResponse, SpaceFsUploadDestination, SpaceFsUploadEntry, SpaceFsUploadError, SpaceFsUploadPlanEntry, SpaceFsUploadPlanEntryInput, SpaceFsUploadProgress, SpaceFsUploadResponse, SpaceFsWriteFileInput, SpaceInvitation, SpaceListItem, SpaceMember, SpaceMeta, SpaceModListItem, SpacePresenceSnapshot, SpacePresenceUser, SpacePublicProfile, SpaceRecord, SpaceRole, SpaceSandboxAutoDestroyPolicy, SpaceSandboxConfig, SpaceSandboxProvider, SpaceSessionsResponse, SpaceUsageHourlyStat, SpaceUsageResponse, SpaceUsageSummary, TaskRunDetailResponse, TaskRunRecord, type UploadChatImageAttachmentInput, type UploadPublicAssetInput, UserProfile, UserRulesResponse, UsersApi, VoiceApi, type VoiceInputCallbacks, VoiceInputClient, type VoiceInputClientOptions, type VoiceInputCreateOptions, type VoiceInputEvent, type WebSocketConnectionState, WebsocketClient, type WorkAuthorizeRequest, type WorkAuthorizeResponse, type WorkBridgeCore, type WorkBridgeCoreConfig, type WorkBridgeCoreWork, type WorkBridgeDialogState, type WorkBridgeGetAccessToken, type WorkBridgeGetViewerUuid, type WorkBridgeRequestSignIn, WorkCommerceApi, type WorkCommerceCheckoutStatus, type WorkCommerceCreditConsumeResponse, type WorkCommerceCreditConsumeStatus, type WorkCommerceEntitlement, type WorkCommerceEntitlementsResponse, type WorkCommerceOrder, type WorkCommerceProductResolveResponse, type WorkCommercePurchaseResponse, type WorkCreateInput, type WorkDetailResponse, type WorkGetResponse, type WorkMeta, type WorkPresentationMeta, type WorkPublicOwnerRecord, type WorkPublicSpaceRecord, type WorkPurchaseRequest, type WorkRecord, type WorkResolveResponse, WorkRuntimeApi, type WorkRuntimeCheckoutState, type WorkRuntimeCheckoutStatus, type WorkRuntimeContext, type WorkRuntimeModeConfig, type WorkRuntimeRequestOptions, type WorkRuntimeTransport, type WorkSessionResponse, type WorkStatus, type WorkTargetType, type WorkUpdateInput, type WorkVersionRecord, type WorkVisibility, WorksApi, assertGenerationRequestAllowedByPolicy, clearGrantedWorkScopes, createCohubClient, createHttpClient, createSessionGenerationStreamClient, createSessionPatchReducer, createVoiceInputClient, createWebsocketClient, createWorkBridgeCore, createWorkRuntime, decodeGenerationPolicy, encodeGenerationPolicy, filterGenerationDeclarationsByPolicy, findGenerationModelPolicy, getAllowedGenerationModelIds, hasGrantedWorkScopes, isHttpErrorCode, normalizeBaseUrl, normalizeGenerationPolicy, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, parseAssistantMessageCommit, parseGenerationPolicyFromEnv, resolveApiBaseUrl, resolveCohubEnvironment, resolveVoiceInputWebsocketUrl, resolveWebsocketUrl, resolveWorkTransport, setGrantedWorkScopes };