@neta-art/cohub 4.8.0 → 5.0.0

package/README.md

@@ -216,7 +216,7 @@ A **Work** is a published, shareable web page hosted by Cohub. When a viewer
 opens a Work, it runs inside a Cohub-managed runtime that provides short-lived
 access tokens — no API keys required.
 
-Three runtime-only APIs are available **exclusively inside a published Work**:
+Four runtime-only APIs are available **exclusively inside a published Work**:
 
 - `client.context()` — returns Work identity, Space identity, and current
   permission scopes. Returns `null` outside a Work runtime.
@@ -224,6 +224,8 @@ Three runtime-only APIs are available **exclusively inside a published Work**:
   and caches a token with the approved scopes.
 - `client.work.commerce.*` — entitlement checks, credit consumption,
   purchases.
+- `client.work.realtime.*` — temporary rooms, typed events, presence, and
+  membership.
 
 ### Quick start (inside a Work)
 
@@ -259,6 +261,45 @@ lets you send a prompt but does NOT let you read the reply — that needs
 `session.view` (a work scope). Similarly, `generation.create` lets you create
 a generation task, but polling its result needs `taskrun.view` (a work scope).
 
+### Realtime rooms
+
+Work runtime rooms are generic, temporary event channels. The SDK does not
+know the Work's business events; define their names and payload types in the
+Work itself.
+
+```ts
+type Events = {
+  "shared.state.updated": { value: number };
+  "activity.submitted": { itemId: string };
+};
+
+const room = await client.work.realtime.createRoom<Events>({
+  code: "TEAM-ALPHA", // optional; generated when omitted
+  maxParticipants: 64,
+  expiresInSeconds: 2 * 60 * 60,
+});
+
+const stop = room.subscribe("shared.state.updated", (event) => {
+  console.log(event.sequence, event.data.value, event.self);
+});
+
+await room.publish("shared.state.updated", { value: 42 });
+await room.setPresence({ status: "active" });
+await room.leave();
+stop();
+```
+
+`expiresInSeconds` is an absolute lifetime from server-side room creation. It
+never extends on publish, presence, or heartbeat. The maximum lifetime is
+24 hours. Room events are live and ordered while connected, with publish ACKs
+and sequence-gap detection; events missed during a disconnect are not replayed.
+
+For high-frequency traffic such as input frames, `room.send(type, data)` skips
+the per-event ACK that would otherwise cap throughput at one round trip per
+event; failures surface through `room.onSendError`. Every connection is its own
+participant by default; create the room with `seatPerUser: true` to give each
+viewer a single seat instead.
+
 For the complete API-to-scope mapping, initialization recipe, capability
 recipes, a full working example, and a pitfalls checklist, see the
 **[Work Runtime Guide](./docs/work-runtime-guide.md)**.

package/dist/chunks/http.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateSpacePromptInput, $i as SessionForkRecord, $n as SpaceFsTreeResponse, Ar as SpaceUsageResponse, At as ModelCatalogEntry, Br as ChannelHealth, Cn as SpaceCommerceBenefit, Di as BoardCapabilities, Dn as SpaceCommerceOrder, Ei as BoardBootstrap, Er as SpaceTurnAuthorFilter, Et as LabelResourceType, Fn as SpaceCreateResponse, Fr as UserRulesResponse, Gt as ReferenceDirection, Hi as BoardPlaybackSnapshot, Hn as SpaceFsCreateUploadResponse, In as SpaceDefaultResponse, It as PromptTemplateCatalogResponse, J as ClaimReferralResponse, Jn as SpaceFsMoveInput, Jt as ReferenceQueryableType, K as CheckpointDiffSummary, Ki as BoardTransaction, Kt as ReferenceKind, Ln as SpaceEnvInput, Lt as PublicReferral, Mn as SpaceConfigInput, Mr as TaskRunDetailResponse, Mt as PatchResourceLabelsResponse, Ni as BoardInspectInput, Nn as SpaceConfigResponse, Nr as TaskRunRecord, Nt as Permission, On as SpaceCommerceProduct, Pn as SpaceConfigUpdateResponse, Pr as UserProfile, Qi as MessageRecord, Qn as SpaceFsReadFilesResponse, R as Channel, Rn as SpaceFsCompleteUploadInput, Rr as UserSessionsResponse, Rt as PublicUserPageResponse, Sn as SpaceCheckpointDetailResponse, St as LabelItemsResponse, Tr as SpaceSessionsResponse, Ut as ReferenceAggregateGroupBy, V as CheckpointDiffFileResponse, Vn as SpaceFsCreateUploadInput, Wt as ReferenceAggregateResponse, X as CreateInvitationResponse, Y as CreateInvitationInput, Yn as SpaceFsPreparingFile, Z as CreateSpaceInput, Zi as SpacePublicEndpoints, Zt as ReferralDashboard, _r as SpacePresenceSnapshot, a as WebsocketClientOptions, an as SessionMessageResponse, at as CursorPageInfo, bi as BoardAwarenessUpdate, br as SpaceRecord, ci as BoardTransactionAppliedEvent$1, cn as SessionRecord, d as BatchUserProfilesResponse, da as SpaceCompletionResult, di as RealtimePatchOperation, dn as SessionTurnSignedUrlsResponse, et as CreateSpacePromptResponse, fa as SpaceCompletionStreamEvent, fn as SessionTurnStreamSnapshotResponse, fr as SpaceMember, ft as GlobalSearchResponse, gn as SkillCatalogResponse, gr as SpacePendingDiffSummary, ha as ContentBlock, hi as SessionTurnPatchEvent, hr as SpacePendingDiffFileResponse, ht as InvitationDetail, ii as GenerationModelDeclaration, it as CronJobUpdatePatch, jt as PatchResourceLabelsInput, ki as BoardCreateInput, kn as SpaceCommerceProductBenefitBinding, kt as MeResponse, l as AcceptInvitationResponse, la as CreateSpaceCompletionInput, ln as SessionTurnIndexResponse, lr as SpaceInvitationListResponse, ma as BillingPayload, mn as SessionTurnsPaginatedResponse, mr as SpaceModListItem, mt as GlobalSearchType, na as SessionTurnRecord, oi as BoardAwarenessUpdatedEvent$1, on as SessionMessagesPaginatedResponse, or as SpaceFsUploadResponse, pa as Usage, pn as SessionTurnWindowResponse, q as CheckpointRecord, qi as BoardValidationResult, qn as SpaceFsFileResponse, qt as ReferenceQueryResponse, r as WebsocketClient, ra as SpaceTurnsResponse, ri as GenerationContentBlock, rt as CronJobRecord, s as WebsocketEventPayload, si as BoardPlaybackChangedEvent$1, sn as SessionMessagesResponse, sr as SpaceFsWriteFileInput, tt as CreateSpaceSessionInput, un as SessionTurnResponse, wi as WorkContentKind, wn as SpaceCommerceBuyerProfile, wt as LabelListItem, xi as WorkArtifactDescriptor, xr as SpaceRole, xt as LabelAssignmentRecord, ya as RequestSource, yn as SpaceAccessPolicy, yr as SpacePublicProfile, zi as BoardPlaybackCommand, zn as SpaceFsCompleteUploadResponse, zr as ChannelConfig } from "./websocket.js";
+import { $ as CreateSpacePromptInput, $n as SpaceFsTreeResponse, Ai as BoardCapabilities, Ar as SpaceUsageResponse, At as Permission, Br as ChannelHealth, Bt as ReferenceAggregateGroupBy, Ci as BoardAwarenessUpdate, Cn as SpaceCommerceBenefit, Ct as LabelResourceType, Di as WorkContentKind, Dn as SpaceCommerceOrder, Dt as ModelCatalogEntry, Er as SpaceTurnAuthorFilter, Et as MeResponse, Fn as SpaceCreateResponse, Fr as UserRulesResponse, Ft as PublicUserPageResponse, Gi as BoardPlaybackSnapshot, Gt as ReferenceQueryableType, Hi as BoardPlaybackCommand, Hn as SpaceFsCreateUploadResponse, Ht as ReferenceDirection, Ii as BoardInspectInput, In as SpaceDefaultResponse, J as ClaimReferralResponse, Jn as SpaceFsMoveInput, Jt as ReferralDashboard, K as CheckpointDiffSummary, Ln as SpaceEnvInput, Mi as BoardCreateInput, Mn as SpaceConfigInput, Mr as TaskRunDetailResponse, Nn as SpaceConfigResponse, Nr as TaskRunRecord, Nt as PromptTemplateCatalogResponse, On as SpaceCommerceProduct, Ot as PatchResourceLabelsInput, Pn as SpaceConfigUpdateResponse, Pr as UserProfile, Pt as PublicReferral, Qn as SpaceFsReadFilesResponse, R as Channel, Rn as SpaceFsCompleteUploadInput, Rr as UserSessionsResponse, Sa as RequestSource, Sn as SpaceCheckpointDetailResponse, Tr as SpaceSessionsResponse, Ut as ReferenceKind, V as CheckpointDiffFileResponse, Vn as SpaceFsCreateUploadInput, Vt as ReferenceAggregateResponse, Wt as ReferenceQueryResponse, X as CreateInvitationResponse, Xi as BoardValidationResult, Y as CreateInvitationInput, Yi as BoardTransaction, Yn as SpaceFsPreparingFile, Z as CreateSpaceInput, _a as BillingPayload, _r as SpacePresenceSnapshot, a as WebsocketClientOptions, aa as SessionTurnRecord, an as SessionRecord, at as CursorPageInfo, br as SpaceRecord, ci as BoardTransactionAppliedEvent$1, cn as SessionTurnSignedUrlsResponse, d as BatchUserProfilesResponse, di as RealtimePatchOperation, dn as SessionTurnsPaginatedResponse, dt as GlobalSearchType, ea as SpacePublicEndpoints, et as CreateSpacePromptResponse, fa as CreateSpaceCompletionInput, fr as SpaceMember, ft as InvitationDetail, ga as Usage, gn as SpaceAccessPolicy, gr as SpacePendingDiffSummary, ha as SpaceCompletionStreamEvent, hr as SpacePendingDiffFileResponse, ii as GenerationModelDeclaration, in as SessionMessagesResponse, it as CronJobUpdatePatch, ki as BoardBootstrap, kn as SpaceCommerceProductBenefitBinding, kt as PatchResourceLabelsResponse, l as AcceptInvitationResponse, ln as SessionTurnStreamSnapshotResponse, lr as SpaceInvitationListResponse, lt as GlobalSearchResponse, ma as SpaceCompletionResult, mr as SpaceModListItem, na as SessionForkRecord, nn as SessionMessageResponse, oa as SpaceTurnsResponse, oi as BoardAwarenessUpdatedEvent$1, on as SessionTurnIndexResponse, or as SpaceFsUploadResponse, pn as SkillCatalogResponse, q as CheckpointRecord, qn as SpaceFsFileResponse, r as WebsocketClient, ri as GenerationContentBlock, rn as SessionMessagesPaginatedResponse, rt as CronJobRecord, s as WebsocketEventPayload, si as BoardPlaybackChangedEvent$1, sn as SessionTurnResponse, sr as SpaceFsWriteFileInput, ta as MessageRecord, tt as CreateSpaceSessionInput, un as SessionTurnWindowResponse, va as ContentBlock, vi as SessionTurnPatchEvent, vt as LabelAssignmentRecord, wi as WorkArtifactDescriptor, wn as SpaceCommerceBuyerProfile, xr as SpaceRole, xt as LabelListItem, yr as SpacePublicProfile, yt as LabelItemsResponse, zn as SpaceFsCompleteUploadResponse, zr as ChannelConfig } from "./websocket.js";
 import { n as CohubEnvironment } from "./environment.js";
 import { a as VoiceInputCreateOptions } from "./voice-input.js";
 //#region ../protocol/dist/model/status.d.ts
@@ -921,7 +921,7 @@ declare class SpacesApi {
   getDefault(customFetch?: Fetch): Promise<SpaceDefaultResponse>;
   get(spaceId: string, customFetch?: Fetch): Promise<SpaceRecord>;
   getBySlug(username: string, slug: string, customFetch?: Fetch): Promise<SpaceRecord>;
-  create(input?: CreateSpaceInput, headers?: Record<string, string>): Promise<SpaceCreateResponse>;
+  create(input: CreateSpaceInput, headers?: Record<string, string>): Promise<SpaceCreateResponse>;
 }
 declare class SpaceFilesApi {
   private readonly transport;

package/dist/chunks/http.js

@@ -1,4 +1,4 @@
-import { b as getRealtimeBoardRoom, n as HttpTransport, t as HttpError, x as getRealtimeSpaceRoom } from "./transport.js";
+import { C as getRealtimeBoardRoom, n as HttpTransport, t as HttpError, w as getRealtimeSpaceRoom } from "./transport.js";
 import { a as resolveApiBaseUrl } from "./environment.js";
 //#region src/apis/channels.ts
 var ChannelsApi = class {
@@ -1546,7 +1546,7 @@ var SpacesApi = class {
 				...headers,
 				"Content-Type": "application/json"
 			},
-			body: JSON.stringify(input ?? {})
+			body: JSON.stringify(input)
 		});
 	}
 };

package/dist/chunks/transport.js

@@ -3,6 +3,11 @@ import { a as resolveApiBaseUrl } from "./environment.js";
 const WS_COMPACT_STREAM_CAPABILITY = "session.compact_stream.v1";
 const WS_ROOM_SUBSCRIPTION_CAPABILITY = "realtime.rooms.v1";
 const WS_BOARD_AWARENESS_CAPABILITY = "board.awareness.v1";
+const WS_REALTIME_ROOM_CAPABILITY = "realtime.room.v1";
+/** Accepted room event names. Shared so a client can reject one before sending. */
+const REALTIME_ROOM_EVENT_NAME_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,63}$/;
+/** Maximum encoded size of a room event payload. */
+const REALTIME_ROOM_MAX_PAYLOAD_BYTES = 16 * 1024;
 const getRealtimeSpaceRoom = (spaceId) => `space:${spaceId}`;
 const getRealtimeBoardRoom = (boardId) => `board:${boardId}`;
 const parseRealtimeRoom = (room) => {
@@ -12,7 +17,7 @@ const parseRealtimeRoom = (room) => {
 	const kind = trimmed.slice(0, separatorIndex);
 	const id = trimmed.slice(separatorIndex + 1).trim();
 	if (!id) return null;
-	if (kind !== "space" && kind !== "user" && kind !== "board") return null;
+	if (kind !== "space" && kind !== "user" && kind !== "board" && kind !== "room") return null;
 	return {
 		kind,
 		id
@@ -304,4 +309,4 @@ var HttpTransport = class {
 	}
 };
 //#endregion
-export { normalizeRealtimeRooms as C, getSessionTurnPatchStreamKey as S, WS_BOARD_AWARENESS_CAPABILITY as _, COHUB_SOURCE_HEADER as a, getRealtimeBoardRoom as b, hasRequestSourceIdentity as c, mergeRequestSourceIntoMeta as d, normalizeRequestSource as f, resolveRequestSourceChannel as g, requestSourceToHeaders as h, sanitizeAccessToken as i, isRequestSourceEmpty as l, readRequestSourceFromEnv as m, HttpTransport as n, COHUB_SOURCE_HEADER_NAMES as o, parseRequestSourceFromHeaders as p, joinApiUrl as r, REQUEST_SOURCE_VIA_MAX_LENGTH as s, HttpError as t, isRequestSourceUuid as u, WS_COMPACT_STREAM_CAPABILITY as v, getRealtimeSpaceRoom as x, WS_ROOM_SUBSCRIPTION_CAPABILITY as y };
+export { getRealtimeBoardRoom as C, normalizeRealtimeRooms as E, WS_ROOM_SUBSCRIPTION_CAPABILITY as S, getSessionTurnPatchStreamKey as T, REALTIME_ROOM_EVENT_NAME_PATTERN as _, COHUB_SOURCE_HEADER as a, WS_COMPACT_STREAM_CAPABILITY as b, hasRequestSourceIdentity as c, mergeRequestSourceIntoMeta as d, normalizeRequestSource as f, resolveRequestSourceChannel as g, requestSourceToHeaders as h, sanitizeAccessToken as i, isRequestSourceEmpty as l, readRequestSourceFromEnv as m, HttpTransport as n, COHUB_SOURCE_HEADER_NAMES as o, parseRequestSourceFromHeaders as p, joinApiUrl as r, REQUEST_SOURCE_VIA_MAX_LENGTH as s, HttpError as t, isRequestSourceUuid as u, REALTIME_ROOM_MAX_PAYLOAD_BYTES as v, getRealtimeSpaceRoom as w, WS_REALTIME_ROOM_CAPABILITY as x, WS_BOARD_AWARENESS_CAPABILITY as y };

package/dist/chunks/websocket.d.ts

@@ -1277,19 +1277,156 @@ type BoardAwarenessGesture = z.infer<typeof BoardAwarenessGestureSchema>;
 type BoardAwarenessUpdate = z.infer<typeof BoardAwarenessUpdateSchema>;
 //#endregion
 //#region ../protocol/dist/realtime/types.d.ts
-type RealtimeRoom = `space:${string}` | `user:${string}` | `board:${string}`;
+type RealtimeRoom = `space:${string}` | `user:${string}` | `board:${string}` | `room:${string}`;
 type RealtimeEnvelope = {
   id: string;
   timestamp: number;
-  domain: "system" | "session" | "space" | "label";
+  domain: "system" | "session" | "space" | "label" | "room";
   type: string;
   requestId?: string | null;
   spaceId?: string | null;
   sessionId?: string | null;
+  roomId?: string | null;
   rooms?: RealtimeRoom[];
   payload: Record<string, unknown>;
 };
 type ChannelEnvelope = RealtimeEnvelope;
+type RealtimeRoomDescriptor = {
+  id: string;
+  code: string;
+  createdAt: string;
+  expiresAt: string;
+  maxParticipants: number;
+  /**
+   * When true a viewer holds at most one seat: rejoining from another tab, or
+   * after an unclean disconnect, takes over the existing seat instead of
+   * consuming a second one. Default false, which gives every connection its own
+   * seat (two tabs are two participants).
+   */
+  seatPerUser: boolean;
+};
+type RealtimeRoomMember = {
+  participantId: string;
+  joinedAt: string;
+  presence: Record<string, unknown> | null;
+  /**
+   * Opaque, stable per room and viewer. Connections of the same viewer share it,
+   * so an application can group or de-duplicate participants without seeing the
+   * underlying account id.
+   */
+  userKey?: string;
+};
+type RealtimeRoomEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.event";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  rooms: RealtimeRoom[];
+  payload: {
+    roomId: string;
+    sequence: number;
+    event: string;
+    data: unknown;
+    clientEventId: string | null;
+    sender: {
+      participantId: string;
+    };
+  };
+};
+type RealtimeRoomJoinedEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.joined";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  rooms: RealtimeRoom[];
+  payload: {
+    room: RealtimeRoomDescriptor;
+    participantId: string;
+    members: RealtimeRoomMember[];
+    sequence: number;
+  };
+};
+type RealtimeRoomMemberChangedEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.member.joined" | "realtime.room.member.left";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  rooms: RealtimeRoom[];
+  payload: {
+    roomId: string;
+    sequence: number;
+    member: RealtimeRoomMember;
+  };
+};
+type RealtimeRoomPresenceUpdatedEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.presence.updated";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  rooms: RealtimeRoom[];
+  payload: {
+    roomId: string;
+    sequence: number;
+    member: RealtimeRoomMember;
+  };
+};
+type RealtimeRoomRequestEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.request.ok";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  roomId?: string | null;
+  payload: {
+    roomId: string;
+    sequence?: number;
+    eventId?: string | null;
+    clientEventId?: string | null;
+  };
+};
+type RealtimeRoomRequestErrorEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.request.error";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  roomId?: string | null;
+  payload: {
+    roomId: string;
+    code: string;
+    message: string;
+  };
+};
+type RealtimeRoomClosedEvent = {
+  id: string;
+  timestamp: number;
+  domain: "room";
+  type: "realtime.room.closed";
+  requestId?: string | null;
+  spaceId?: null;
+  sessionId?: null;
+  rooms: RealtimeRoom[];
+  payload: {
+    roomId: string;
+    reason: "expired" | "left" | "revoked" | "superseded";
+  };
+};
 type SystemReadyEvent = {
   id: string;
   timestamp: number;
@@ -1313,6 +1450,7 @@ type SystemAuthOkEvent = {
   payload: {
     connectionId: string;
     user: Record<string, unknown>;
+    capabilities?: string[];
   };
 };
 type SystemRequestErrorEvent = {
@@ -1791,7 +1929,7 @@ type LabelAssignmentsUpdatedEvent = {
     affectedLabelIds: string[];
   };
 };
-type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SystemSubscribeOkEvent | SystemSubscribeErrorEvent | SessionCreatedEvent | SessionUpdatedEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnCreatedEvent | SessionTurnPatchEvent | SessionTurnErrorEvent | SessionTurnLifecycleEvent | SessionTurnUpdatedEvent | SessionTurnFinalizedEvent | SessionTurnNotifyEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent | SpacePortsChangedEvent | SpacePresenceUpdatedEvent | BoardTransactionAppliedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent | WorkVersionPublishedEvent | TaskCreatedEvent | TaskUpdatedEvent | LabelAssignmentsUpdatedEvent;
+type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SystemSubscribeOkEvent | SystemSubscribeErrorEvent | SessionCreatedEvent | SessionUpdatedEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnCreatedEvent | SessionTurnPatchEvent | SessionTurnErrorEvent | SessionTurnLifecycleEvent | SessionTurnUpdatedEvent | SessionTurnFinalizedEvent | SessionTurnNotifyEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent | SpacePortsChangedEvent | SpacePresenceUpdatedEvent | BoardTransactionAppliedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent | WorkVersionPublishedEvent | TaskCreatedEvent | TaskUpdatedEvent | LabelAssignmentsUpdatedEvent | RealtimeRoomEvent | RealtimeRoomJoinedEvent | RealtimeRoomMemberChangedEvent | RealtimeRoomPresenceUpdatedEvent | RealtimeRoomRequestEvent | RealtimeRoomRequestErrorEvent | RealtimeRoomClosedEvent;
 //#endregion
 //#region ../../node_modules/.pnpm/@neta-art+generation@0.1.18/node_modules/@neta-art/generation/dist/builtins-8R5iZQ10.d.ts
 //#region src/types.d.ts
@@ -2618,12 +2756,37 @@ type SpaceSandboxConfig = {
 type SpaceConfig = {
   sandbox?: SpaceSandboxConfig;
 };
+type SpaceBootstrapSource = {
+  type: "blank";
+} | {
+  type: "git_repo";
+  repoUrl: string;
+  ref?: string | null;
+} | {
+  type: "checkpoint";
+  checkpointId: string;
+};
+type SpaceBootstrapStatus = "pending" | "running" | "ready" | "failed";
+type SpaceBootstrapStage = "prepare" | "import" | "checkpoint_restore" | "finalize";
+type SpaceBootstrapMeta = {
+  source: SpaceBootstrapSource;
+  status: SpaceBootstrapStatus;
+  stage: SpaceBootstrapStage | null;
+  taskRunId: string | null;
+  errorMessage: string | null;
+  errorCode?: string | null;
+  startedAt: string | null;
+  finishedAt: string | null;
+  stageTimings?: Record<string, number>;
+  initialCheckpointTaskRunId?: string | null;
+};
 type SpacePublicProfile = {
   avatarUrl: string | null;
 };
 type SpaceMeta = JsonObject & {
   config?: SpaceConfig;
   extraEnv?: SpaceEnvInput[];
+  bootstrap?: SpaceBootstrapMeta;
   publicProfile?: Partial<SpacePublicProfile> | null;
 };
 type SpaceRecord = {
@@ -2654,16 +2817,6 @@ type SpaceRecord = {
   /** Whether the viewer has pinned this space (only present in list responses). */
   isPinned?: boolean;
 };
-type SpaceBootstrapSource = {
-  type: "blank";
-} | {
-  type: "git_repo";
-  repoUrl?: string;
-  ref?: string | null;
-} | {
-  type: "checkpoint";
-  checkpointId: string;
-};
 type SpaceConfigInput = {
   sandbox?: {
     provider?: SpaceSandboxProvider;
@@ -2678,7 +2831,7 @@ type CreateSpaceModInput = {
   enabled?: boolean;
 };
 type CreateSpaceInput = {
-  name?: string;
+  name: string;
   slug?: string | null;
   description?: string | null;
   source?: string;
@@ -3204,40 +3357,6 @@ type SpaceModListItem = {
   modSpaceName: string | null;
   modSpaceDescription: string | null;
 };
-/**
- * Public-safe DTO for Explore spaces.
- * Only contains fields safe for unauthenticated product rendering.
- */
-type ExploreSpaceItem = {
-  id: string;
-  slug: string | null;
-  title: string;
-  summary: string | null;
-  spaceUrl: string;
-  avatarUrl: string | null;
-  avatarAlt: string | null;
-  ownerDisplayName: string | null;
-  ownerAvatarUrl: string | null;
-  ownerUsername: string | null;
-  category: string | null;
-  tags: string[];
-  saveCount: number;
-  forkCount: number;
-  updatedAt: string | null;
-  accessLabel: "public" | "sign-in-required" | "unknown";
-  latestSaveLabel: string | null;
-};
-type ExploreSection = {
-  key: string;
-  title: string | null;
-  subtitle: string | null;
-  description: string | null;
-  spaces: ExploreSpaceItem[];
-};
-type ExploreSpacesResponse = {
-  sections: ExploreSection[];
-  spaces: ExploreSpaceItem[];
-};
 type Permission = "space.view" | "space.edit" | "space.label.view" | "space.label.manage" | "space.label.assign" | "session.view" | "session.edit" | "session.prompt.readonly" | "session.prompt.fullaccess" | "generation.create" | "file.view" | "file.view.filtered" | "file.edit" | "checkpoint.view" | "checkpoint.edit" | "member.view" | "member.manage" | "references.view" | "channel.view" | "channel.manage" | "cronjob.view" | "cronjob.manage" | "taskrun.view" | "sandbox.view" | "sandbox.manage" | "mod.view" | "mod.manage" | "user.space.list" | "user.session.list" | "user.usage.read";
 type SpaceAccess = {
   role: SpaceRole | null;
@@ -3474,6 +3593,7 @@ type WebsocketClientEvents = {
   auth: {
     connectionId: string;
     user: Record<string, unknown>;
+    capabilities: string[];
   };
   messageAccepted: {
     requestId?: string | null;
@@ -3537,8 +3657,10 @@ declare class WebsocketClient {
   private readonly compactStreamContexts;
   private readonly patchStreamBuffers;
   private readonly roomSubscriptions;
+  private readonly serverCapabilities;
   state: WebsocketClientState;
   connectionId: string | null;
+  supportsCapability(capability: string): boolean;
   private readonly listeners;
   constructor(options?: WebsocketClientOptions);
   on<K extends keyof WebsocketClientEvents>(type: K, handler: EventHandler<WebsocketClientEvents[K]>): () => void;
@@ -3559,6 +3681,27 @@ declare class WebsocketClient {
     update: BoardAwarenessUpdate;
     requestId?: string;
   }): Promise<void>;
+  joinRealtimeRoom(input: {
+    roomId: string;
+    ticket: string;
+    requestId?: string;
+  }): Promise<void>;
+  publishRealtimeRoom(input: {
+    roomId: string;
+    event: string;
+    data: unknown;
+    clientEventId?: string;
+    requestId?: string;
+  }): Promise<void>;
+  leaveRealtimeRoom(input: {
+    roomId: string;
+    requestId?: string;
+  }): Promise<void>;
+  updateRealtimeRoomPresence(input: {
+    roomId: string;
+    presence: Record<string, unknown> | null;
+    requestId?: string;
+  }): Promise<void>;
   sendMessage(input: {
     spaceId: string;
     sessionId: string;
@@ -3596,4 +3739,4 @@ declare class WebsocketClient {
 }
 declare const createWebsocketClient: (options?: WebsocketClientOptions) => WebsocketClient;
 //#endregion
-export { CreateSpacePromptInput as $, SessionForkRecord as $i, SpaceFsTreeResponse as $n, findGenerationModelPolicy as $r, ReferralReward as $t, BillingProductDisplay as A, BoardDeleteReason as Ai, SpaceCommerceProductCreditBenefit as An, SpaceUsageResponse as Ar, ModelCatalogEntry as At, CheckpointDiffFile as B, BoardPlaybackPolicy as Bi, SpaceFsCreateDirectoryInput as Bn, ChannelHealth as Br, PublicUserSpaceItem as Bt, BillingCreditStatus as C, isRequestSourceUuid as Ca, WorkBoardAsset as Ci, SpaceCommerceBenefit as Cn, SpaceSandboxConfig as Cr, LabelItemsSessionFork as Ct, BillingPluginStatus as D, readRequestSourceFromEnv as Da, BoardCapabilities as Di, SpaceCommerceOrder as Dn, SpaceTurnListItem as Dr, LabelScopeType as Dt, BillingPaymentStatus as E, parseRequestSourceFromHeaders as Ea, BoardBootstrap as Ei, SpaceCommerceFeatureBenefit as En, SpaceTurnAuthorFilter as Er, LabelResourceType as Et, BillingSubscriptionHistoryList as F, BoardManifest as Fi, SpaceCreateResponse as Fn, UserRulesResponse as Fr, PromptTemplateCatalogEntry as Ft, CheckpointDiffStatus as G, BoardTarget as Gi, SpaceFsEntry as Gn, GenerationModelPolicy as Gr, ReferenceDirection as Gt, CheckpointDiffPatchKind as H, BoardPlaybackSnapshot as Hi, SpaceFsCreateUploadResponse as Hn, ChannelRuntimeState as Hr, ReferenceAggregateGroup as Ht, BillingSubscriptionHistoryStatus as I, BoardNodeInput as Ii, SpaceDefaultResponse as In, UserSessionListItem as Ir, PromptTemplateCatalogResponse as It, ClaimReferralResponse as J, parseBoardPlaybackPolicy as Ji, SpaceFsMoveInput as Jn, GenerationPolicyError as Jr, ReferenceQueryableType as Jt, CheckpointDiffSummary as K, BoardTransaction as Ki, SpaceFsFileKind as Kn, GenerationParameterConstraint as Kr, ReferenceKind as Kt, BillingSubscriptionSummary as L, BoardNodeRecord as Li, SpaceEnvInput as Ln, UserSessionSpaceSummary as Lr, PublicReferral as Lt, BillingProductPricing as M, BoardEffect as Mi, SpaceConfigInput as Mn, TaskRunDetailResponse as Mr, PatchResourceLabelsResponse as Mt, BillingRedemptionResult as N, BoardInspectInput as Ni, SpaceConfigResponse as Nn, TaskRunRecord as Nr, Permission as Nt, BillingProductBillingInterval as O, requestSourceToHeaders as Oa, BoardClip as Oi, SpaceCommerceProduct as On, SpaceTurnsResponse as Or, LabelSource as Ot, BillingResponsePayload as P, BoardKeyframe as Pi, SpaceConfigUpdateResponse as Pn, UserProfile as Pr, PromptAccessMode as Pt, CreateSpaceModInput as Q, MessageRecord as Qi, SpaceFsReadFilesResponse as Qn, filterGenerationDeclarationsByPolicy as Qr, ReferralListItem as Qt, Channel as R, BoardOperation as Ri, SpaceFsCompleteUploadInput as Rn, UserSessionsResponse as Rr, PublicUserPageResponse as Rt, BillingCreditGrantStatus as S, isRequestSourceEmpty as Sa, WorkBoardArtifactManifest as Si, SpaceCheckpointDetailResponse as Sn, SpaceSandboxAutoDestroyPolicy as Sr, LabelItemsResponse as St, BillingHistoryPagination as T, normalizeRequestSource as Ta, BoardAssetRef as Ti, SpaceCommerceCreditsBenefit as Tn, SpaceSessionsResponse as Tr, LabelRecord as Tt, CheckpointDiffPatchLine as U, BoardRecord as Ui, SpaceFsDeleteNodeInput as Un, DiscordChannelConfig as Ur, ReferenceAggregateGroupBy as Ut, CheckpointDiffFileResponse as V, BoardPlaybackPolicySchema as Vi, SpaceFsCreateUploadInput as Vn, ChannelHealthReasonCode as Vr, PublicUserWorkItem as Vt, CheckpointDiffStats as W, BoardSequence as Wi, SpaceFsEncoding as Wn, FeishuChannelConfig as Wr, ReferenceAggregateResponse as Wt, CreateInvitationResponse as X, BoardRenderCost as Xi, SpaceFsReadFilesError as Xn, decodeGenerationPolicy as Xr, ReferenceResourceType as Xt, CreateInvitationInput as Y, BoardCapability as Yi, SpaceFsPreparingFile as Yn, assertGenerationRequestAllowedByPolicy as Yr, ReferenceRecord as Yt, CreateSpaceInput as Z, SpacePublicEndpoints as Zi, SpaceFsReadFilesInput as Zn, encodeGenerationPolicy as Zr, ReferralDashboard as Zt, BillingCatalogProduct as _, COHUB_SOURCE_HEADER_NAMES as _a, BoardAwarenessGesture as _i, SkillCatalogSource as _n, SpacePresenceSnapshot as _r, JsonPrimitive as _t, WebsocketClientOptions as a, CompletionMessage as aa, GenerationResult as ai, SessionMessageResponse as an, SpaceFsUploadProgress as ar, CursorPageInfo as at, BillingConversionIntent as b, RequestSourceVia as ba, BoardAwarenessUpdate as bi, SpaceBootstrapSource as bn, SpaceRecord as br, LabelAssignmentPageInfo as bt, createWebsocketClient as c, CompletionUsage as ca, BoardTransactionAppliedEvent as ci, SessionRecord as cn, SpaceInvitation as cr, ExploreSpacesResponse as ct, BatchUserProfilesResponse as d, SpaceCompletionResult as da, RealtimePatchOperation as di, SessionTurnSignedUrlsResponse as dn, SpaceListItem as dr, GenerationUsageSummary as dt, SessionTurnSegmentRecord as ea, getAllowedGenerationModelIds as ei, ReferralStatus as en, SpaceFsUploadDestination as er, CreateSpacePromptResponse as et, BillingBalanceActivity as f, SpaceCompletionStreamEvent as fa, RealtimeServerEvent as fi, SessionTurnStreamSnapshotResponse as fn, SpaceMember as fr, GlobalSearchResponse as ft, BillingCatalog as g, COHUB_SOURCE_HEADER as ga, WorkVersionPublishedEvent as gi, SkillCatalogResponse as gn, SpacePendingDiffSummary as gr, JsonObject as gt, BillingBalanceActivityStatus as h, ContentBlock as ha, SessionTurnPatchEvent as hi, SkillCatalogEntry as hn, SpacePendingDiffFileResponse as hr, InvitationDetail as ht, WebsocketClientEvents as i, CompletionAssistantMessage as ia, GenerationModelDeclaration as ii, SessionBindingRecord as in, SpaceFsUploadPlanEntryInput as ir, CronJobUpdatePatch as it, BillingProductKind as j, BoardDiagnostic as ji, SpaceConfig as jn, SpaceUsageSummary as jr, PatchResourceLabelsInput as jt, BillingProductCreditBenefit as k, resolveRequestSourceChannel as ka, BoardCreateInput as ki, SpaceCommerceProductBenefitBinding as kn, SpaceUsageHourlyStat as kr, MeResponse as kt, AcceptInvitationResponse as l, CreateSpaceCompletionInput as la, ChannelEnvelope as li, SessionTurnIndexResponse as ln, SpaceInvitationListResponse as lr, GenerationUsageBlock as lt, BillingBalanceActivityList as m, BillingPayload as ma, RealtimeWorkVersionRecord as mi, SessionTurnsPaginatedResponse as mn, SpaceModListItem as mr, GlobalSearchType as mt, WebSocketLike as n, SessionTurnRecord as na, parseGenerationPolicyFromEnv as ni, SandboxSpecId as nn, SpaceFsUploadError as nr, CronJobPayload as nt, WebsocketClientState as o, CompletionMessageRole as oa, BoardAwarenessUpdatedEvent as oi, SessionMessagesPaginatedResponse as on, SpaceFsUploadResponse as or, ExploreSection as ot, BillingBalanceActivityKind as p, Usage as pa, RealtimeWorkRecord as pi, SessionTurnWindowResponse as pn, SpaceMeta as pr, GlobalSearchResult as pt, CheckpointRecord as q, BoardValidationResult as qi, SpaceFsFileResponse as qn, GenerationPolicy as qr, ReferenceQueryResponse as qt, WebsocketClient as r, SpaceTurnsResponse$1 as ra, GenerationContentBlock as ri, SendMessageCronJobPayload as rn, SpaceFsUploadPlanEntry as rr, CronJobRecord as rt, WebsocketEventPayload as s, CompletionThinkingLevel as sa, BoardPlaybackChangedEvent as si, SessionMessagesResponse as sn, SpaceFsWriteFileInput as sr, ExploreSpaceItem as st, WebSocketConstructor as t, SessionTurnIndexItem as ta, normalizeGenerationPolicy as ti, ResourceLabelsResponse as tn, SpaceFsUploadEntry as tr, CreateSpaceSessionInput as tt, ApiError as u, ModelThinkingLevel as ua, LabelAssignmentsUpdatedEvent as ui, SessionTurnResponse as un, SpaceInvitationLocation as ur, GenerationUsageHourlyStat as ut, BillingCheckoutActionState as v, REQUEST_SOURCE_VIA_MAX_LENGTH as va, BoardAwarenessNodePreview as vi, SpaceAccess as vn, SpacePresenceUser as vr, JsonValue as vt, BillingCreditUnit as w, mergeRequestSourceIntoMeta as wa, WorkContentKind as wi, SpaceCommerceBuyerProfile as wn, SpaceSandboxProvider as wr, LabelListItem as wt, BillingCreditExpiryGroup as x, hasRequestSourceIdentity as xa, WorkArtifactDescriptor as xi, SpaceChannelBindingInput as xn, SpaceRole as xr, LabelAssignmentRecord as xt, BillingCheckoutResult as y, RequestSource as ya, BoardAwarenessStateUpdate as yi, SpaceAccessPolicy as yn, SpacePublicProfile as yr, LabelAssignmentListItem as yt, CheckpointDiffDelivery as z, BoardPlaybackCommand as zi, SpaceFsCompleteUploadResponse as zn, ChannelConfig as zr, PublicUserProfile as zt };
+export { CreateSpacePromptInput as $, BoardRenderCost as $i, SpaceFsTreeResponse as $n, findGenerationModelPolicy as $r, SandboxSpecId as $t, BillingProductDisplay as A, readRequestSourceFromEnv as Aa, BoardCapabilities as Ai, SpaceCommerceProductCreditBenefit as An, SpaceUsageResponse as Ar, Permission as At, CheckpointDiffFile as B, BoardNodeRecord as Bi, SpaceFsCreateDirectoryInput as Bn, ChannelHealth as Br, ReferenceAggregateGroupBy as Bt, BillingCreditStatus as C, RequestSourceVia as Ca, BoardAwarenessUpdate as Ci, SpaceCommerceBenefit as Cn, SpaceSandboxConfig as Cr, LabelResourceType as Ct, BillingPluginStatus as D, mergeRequestSourceIntoMeta as Da, WorkContentKind as Di, SpaceCommerceOrder as Dn, SpaceTurnListItem as Dr, ModelCatalogEntry as Dt, BillingPaymentStatus as E, isRequestSourceUuid as Ea, WorkBoardAsset as Ei, SpaceCommerceFeatureBenefit as En, SpaceTurnAuthorFilter as Er, MeResponse as Et, BillingSubscriptionHistoryList as F, BoardEffect as Fi, SpaceCreateResponse as Fn, UserRulesResponse as Fr, PublicUserPageResponse as Ft, CheckpointDiffStatus as G, BoardPlaybackSnapshot as Gi, SpaceFsEntry as Gn, GenerationModelPolicy as Gr, ReferenceQueryableType as Gt, CheckpointDiffPatchKind as H, BoardPlaybackCommand as Hi, SpaceFsCreateUploadResponse as Hn, ChannelRuntimeState as Hr, ReferenceDirection as Ht, BillingSubscriptionHistoryStatus as I, BoardInspectInput as Ii, SpaceDefaultResponse as In, UserSessionListItem as Ir, PublicUserProfile as It, ClaimReferralResponse as J, BoardTarget as Ji, SpaceFsMoveInput as Jn, GenerationPolicyError as Jr, ReferralDashboard as Jt, CheckpointDiffSummary as K, BoardRecord as Ki, SpaceFsFileKind as Kn, GenerationParameterConstraint as Kr, ReferenceRecord as Kt, BillingSubscriptionSummary as L, BoardKeyframe as Li, SpaceEnvInput as Ln, UserSessionSpaceSummary as Lr, PublicUserSpaceItem as Lt, BillingProductPricing as M, resolveRequestSourceChannel as Ma, BoardCreateInput as Mi, SpaceConfigInput as Mn, TaskRunDetailResponse as Mr, PromptTemplateCatalogEntry as Mt, BillingRedemptionResult as N, BoardDeleteReason as Ni, SpaceConfigResponse as Nn, TaskRunRecord as Nr, PromptTemplateCatalogResponse as Nt, BillingProductBillingInterval as O, normalizeRequestSource as Oa, BoardAssetRef as Oi, SpaceCommerceProduct as On, SpaceTurnsResponse as Or, PatchResourceLabelsInput as Ot, BillingResponsePayload as P, BoardDiagnostic as Pi, SpaceConfigUpdateResponse as Pn, UserProfile as Pr, PublicReferral as Pt, CreateSpaceModInput as Q, BoardCapability as Qi, SpaceFsReadFilesResponse as Qn, filterGenerationDeclarationsByPolicy as Qr, ResourceLabelsResponse as Qt, Channel as R, BoardManifest as Ri, SpaceFsCompleteUploadInput as Rn, UserSessionsResponse as Rr, PublicUserWorkItem as Rt, BillingCreditGrantStatus as S, RequestSource as Sa, BoardAwarenessStateUpdate as Si, SpaceCheckpointDetailResponse as Sn, SpaceSandboxAutoDestroyPolicy as Sr, LabelRecord as St, BillingHistoryPagination as T, isRequestSourceEmpty as Ta, WorkBoardArtifactManifest as Ti, SpaceCommerceCreditsBenefit as Tn, SpaceSessionsResponse as Tr, LabelSource as Tt, CheckpointDiffPatchLine as U, BoardPlaybackPolicy as Ui, SpaceFsDeleteNodeInput as Un, DiscordChannelConfig as Ur, ReferenceKind as Ut, CheckpointDiffFileResponse as V, BoardOperation as Vi, SpaceFsCreateUploadInput as Vn, ChannelHealthReasonCode as Vr, ReferenceAggregateResponse as Vt, CheckpointDiffStats as W, BoardPlaybackPolicySchema as Wi, SpaceFsEncoding as Wn, FeishuChannelConfig as Wr, ReferenceQueryResponse as Wt, CreateInvitationResponse as X, BoardValidationResult as Xi, SpaceFsReadFilesError as Xn, decodeGenerationPolicy as Xr, ReferralReward as Xt, CreateInvitationInput as Y, BoardTransaction as Yi, SpaceFsPreparingFile as Yn, assertGenerationRequestAllowedByPolicy as Yr, ReferralListItem as Yt, CreateSpaceInput as Z, parseBoardPlaybackPolicy as Zi, SpaceFsReadFilesInput as Zn, encodeGenerationPolicy as Zr, ReferralStatus as Zt, BillingCatalogProduct as _, BillingPayload as _a, RealtimeWorkVersionRecord as _i, SpaceBootstrapMeta as _n, SpacePresenceSnapshot as _r, LabelAssignmentPageInfo as _t, WebsocketClientOptions as a, SessionTurnRecord as aa, GenerationResult as ai, SessionRecord as an, SpaceFsUploadProgress as ar, CursorPageInfo as at, BillingConversionIntent as b, COHUB_SOURCE_HEADER_NAMES as ba, BoardAwarenessGesture as bi, SpaceBootstrapStatus as bn, SpaceRecord as br, LabelItemsSessionFork as bt, createWebsocketClient as c, CompletionMessage as ca, BoardTransactionAppliedEvent as ci, SessionTurnSignedUrlsResponse as cn, SpaceInvitation as cr, GenerationUsageSummary as ct, BatchUserProfilesResponse as d, CompletionUsage as da, RealtimePatchOperation as di, SessionTurnsPaginatedResponse as dn, SpaceListItem as dr, GlobalSearchType as dt, SpacePublicEndpoints as ea, getAllowedGenerationModelIds as ei, SendMessageCronJobPayload as en, SpaceFsUploadDestination as er, CreateSpacePromptResponse as et, BillingBalanceActivity as f, CreateSpaceCompletionInput as fa, RealtimeRoomDescriptor as fi, SkillCatalogEntry as fn, SpaceMember as fr, InvitationDetail as ft, BillingCatalog as g, Usage as ga, RealtimeWorkRecord as gi, SpaceAccessPolicy as gn, SpacePendingDiffSummary as gr, LabelAssignmentListItem as gt, BillingBalanceActivityStatus as h, SpaceCompletionStreamEvent as ha, RealtimeServerEvent as hi, SpaceAccess as hn, SpacePendingDiffFileResponse as hr, JsonValue as ht, WebsocketClientEvents as i, SessionTurnIndexItem as ia, GenerationModelDeclaration as ii, SessionMessagesResponse as in, SpaceFsUploadPlanEntryInput as ir, CronJobUpdatePatch as it, BillingProductKind as j, requestSourceToHeaders as ja, BoardClip as ji, SpaceConfig as jn, SpaceUsageSummary as jr, PromptAccessMode as jt, BillingProductCreditBenefit as k, parseRequestSourceFromHeaders as ka, BoardBootstrap as ki, SpaceCommerceProductBenefitBinding as kn, SpaceUsageHourlyStat as kr, PatchResourceLabelsResponse as kt, AcceptInvitationResponse as l, CompletionMessageRole as la, ChannelEnvelope as li, SessionTurnStreamSnapshotResponse as ln, SpaceInvitationListResponse as lr, GlobalSearchResponse as lt, BillingBalanceActivityList as m, SpaceCompletionResult as ma, RealtimeRoomMember as mi, SkillCatalogSource as mn, SpaceModListItem as mr, JsonPrimitive as mt, WebSocketLike as n, SessionForkRecord as na, parseGenerationPolicyFromEnv as ni, SessionMessageResponse as nn, SpaceFsUploadError as nr, CronJobPayload as nt, WebsocketClientState as o, SpaceTurnsResponse$1 as oa, BoardAwarenessUpdatedEvent as oi, SessionTurnIndexResponse as on, SpaceFsUploadResponse as or, GenerationUsageBlock as ot, BillingBalanceActivityKind as p, ModelThinkingLevel as pa, RealtimeRoomEvent as pi, SkillCatalogResponse as pn, SpaceMeta as pr, JsonObject as pt, CheckpointRecord as q, BoardSequence as qi, SpaceFsFileResponse as qn, GenerationPolicy as qr, ReferenceResourceType as qt, WebsocketClient as r, SessionTurnSegmentRecord as ra, GenerationContentBlock as ri, SessionMessagesPaginatedResponse as rn, SpaceFsUploadPlanEntry as rr, CronJobRecord as rt, WebsocketEventPayload as s, CompletionAssistantMessage as sa, BoardPlaybackChangedEvent as si, SessionTurnResponse as sn, SpaceFsWriteFileInput as sr, GenerationUsageHourlyStat as st, WebSocketConstructor as t, MessageRecord as ta, normalizeGenerationPolicy as ti, SessionBindingRecord as tn, SpaceFsUploadEntry as tr, CreateSpaceSessionInput as tt, ApiError as u, CompletionThinkingLevel as ua, LabelAssignmentsUpdatedEvent as ui, SessionTurnWindowResponse as un, SpaceInvitationLocation as ur, GlobalSearchResult as ut, BillingCheckoutActionState as v, ContentBlock as va, SessionTurnPatchEvent as vi, SpaceBootstrapSource as vn, SpacePresenceUser as vr, LabelAssignmentRecord as vt, BillingCreditUnit as w, hasRequestSourceIdentity as wa, WorkArtifactDescriptor as wi, SpaceCommerceBuyerProfile as wn, SpaceSandboxProvider as wr, LabelScopeType as wt, BillingCreditExpiryGroup as x, REQUEST_SOURCE_VIA_MAX_LENGTH as xa, BoardAwarenessNodePreview as xi, SpaceChannelBindingInput as xn, SpaceRole as xr, LabelListItem as xt, BillingCheckoutResult as y, COHUB_SOURCE_HEADER as ya, WorkVersionPublishedEvent as yi, SpaceBootstrapStage as yn, SpacePublicProfile as yr, LabelItemsResponse as yt, CheckpointDiffDelivery as z, BoardNodeInput as zi, SpaceFsCompleteUploadResponse as zn, ChannelConfig as zr, ReferenceAggregateGroup as zt };

package/dist/chunks/websocket.js

@@ -1,4 +1,4 @@
-import { C as normalizeRealtimeRooms, S as getSessionTurnPatchStreamKey, _ as WS_BOARD_AWARENESS_CAPABILITY, t as HttpError, v as WS_COMPACT_STREAM_CAPABILITY, x as getRealtimeSpaceRoom, y as WS_ROOM_SUBSCRIPTION_CAPABILITY } from "./transport.js";
+import { E as normalizeRealtimeRooms, S as WS_ROOM_SUBSCRIPTION_CAPABILITY, T as getSessionTurnPatchStreamKey, b as WS_COMPACT_STREAM_CAPABILITY, t as HttpError, w as getRealtimeSpaceRoom, x as WS_REALTIME_ROOM_CAPABILITY, y as WS_BOARD_AWARENESS_CAPABILITY } from "./transport.js";
 import { c as resolveWebsocketUrl } from "./environment.js";
 //#region src/http-error.ts
 /** Shared HTTP error code for every plan entitlement gate (402). */
@@ -88,7 +88,7 @@ const isRealtimeEnvelope = (value) => {
 	if (!isRecord(value)) return false;
 	if (typeof value.id !== "string") return false;
 	if (typeof value.timestamp !== "number") return false;
-	if (value.domain !== "system" && value.domain !== "session" && value.domain !== "space" && value.domain !== "label") return false;
+	if (value.domain !== "system" && value.domain !== "session" && value.domain !== "space" && value.domain !== "label" && value.domain !== "room") return false;
 	if (typeof value.type !== "string") return false;
 	if (!isRecord(value.payload)) return false;
 	return true;
@@ -157,8 +157,12 @@ var WebsocketClient = class {
 	compactStreamContexts = /* @__PURE__ */ new Map();
 	patchStreamBuffers = /* @__PURE__ */ new Map();
 	roomSubscriptions = /* @__PURE__ */ new Map();
+	serverCapabilities = /* @__PURE__ */ new Set();
 	state = "idle";
 	connectionId = null;
+	supportsCapability(capability) {
+		return this.serverCapabilities.has(capability);
+	}
 	listeners = createEventMap();
 	constructor(options = {}) {
 		const normalized = normalizeOptions(options);
@@ -322,6 +326,49 @@ var WebsocketClient = class {
 			}
 		});
 	}
+	async joinRealtimeRoom(input) {
+		await this.ensureOpen();
+		this.send({
+			type: "realtime.room.join",
+			requestId: input.requestId,
+			payload: {
+				roomId: input.roomId,
+				ticket: input.ticket
+			}
+		});
+	}
+	async publishRealtimeRoom(input) {
+		await this.ensureOpen();
+		this.send({
+			type: "realtime.room.publish",
+			requestId: input.requestId,
+			payload: {
+				roomId: input.roomId,
+				event: input.event,
+				data: input.data,
+				clientEventId: input.clientEventId
+			}
+		});
+	}
+	async leaveRealtimeRoom(input) {
+		await this.ensureOpen();
+		this.send({
+			type: "realtime.room.leave",
+			requestId: input.requestId,
+			payload: { roomId: input.roomId }
+		});
+	}
+	async updateRealtimeRoomPresence(input) {
+		await this.ensureOpen();
+		this.send({
+			type: "realtime.room.presence.update",
+			requestId: input.requestId,
+			payload: {
+				roomId: input.roomId,
+				presence: input.presence
+			}
+		});
+	}
 	async sendMessage(input) {
 		await this.ensureOpen();
 		this.send({
@@ -424,7 +471,8 @@ var WebsocketClient = class {
 				capabilities: [
 					WS_COMPACT_STREAM_CAPABILITY,
 					WS_ROOM_SUBSCRIPTION_CAPABILITY,
-					WS_BOARD_AWARENESS_CAPABILITY
+					WS_BOARD_AWARENESS_CAPABILITY,
+					WS_REALTIME_ROOM_CAPABILITY
 				]
 			}
 		});
@@ -515,11 +563,15 @@ var WebsocketClient = class {
 			case "system.auth.ok": {
 				const connectionId = typeof envelope.payload.connectionId === "string" ? envelope.payload.connectionId : this.connectionId;
 				const user = envelope.payload.user && typeof envelope.payload.user === "object" ? envelope.payload.user : {};
+				const capabilities = Array.isArray(envelope.payload.capabilities) ? envelope.payload.capabilities.filter((value) => typeof value === "string") : [];
+				this.serverCapabilities.clear();
+				for (const capability of capabilities) this.serverCapabilities.add(capability);
 				if (connectionId) {
 					this.connectionId = connectionId;
 					this.emit("auth", {
 						connectionId,
-						user
+						user,
+						capabilities
 					});
 				}
 				this.resolveAuthWaiter();