@neta-art/cohub 3.0.0 → 3.2.0

package/dist/chunks/http.d.ts

@@ -1,5 +1,4 @@
-import { a as BoardCreateInput, b as BoardTransaction, g as BoardPlaybackSnapshot, h as BoardPlaybackCommand, l as BoardInspectInput, n as BoardBootstrap, r as BoardCapabilities, x as BoardValidationResult } from "./board.js";
-import { $ as CreateSpacePromptInput, $r as BoardTransactionAppliedEvent$1, Ar as UserSessionsResponse, At as ModelCatalogEntry, Bn as SpaceFsCreateUploadResponse, Cn as SpaceCommerceBuyerProfile, Dn as SpaceCommerceProduct, Dr as UserRulesResponse, En as SpaceCommerceOrder, Er as UserProfile, Et as LabelResourceType, Fn as SpaceDefaultResponse, Gn as SpaceFsMoveInput, Gt as ReferenceDirection, In as SpaceEnvInput, It as PromptTemplateCatalogResponse, J as ClaimReferralResponse, Jt as ReferenceQueryableType, K as CheckpointDiffSummary, Kn as SpaceFsPreparingFile, Kt as ReferenceKind, Ln as SpaceFsCompleteUploadInput, Lt as PublicReferral, Mn as SpaceConfigResponse, Mr as ChannelHealth, Mt as PatchResourceLabelsResponse, Nn as SpaceConfigUpdateResponse, Nt as Permission, On as SpaceCommerceProductBenefitBinding, Pn as SpaceCreateResponse, Qr as BoardPlaybackChangedEvent$1, R as Channel, Rn as SpaceFsCompleteUploadResponse, Rt as PublicUserPageResponse, Si as BillingPayload, Sn as SpaceCommerceBenefit, Sr as SpaceUsageResponse, St as LabelItemsResponse, Tr as TaskRunRecord, Ut as ReferenceAggregateGroupBy, V as CheckpointDiffFileResponse, Wn as SpaceFsFileResponse, Wt as ReferenceAggregateResponse, X as CreateInvitationResponse, Xn as SpaceFsTreeResponse, Xr as GenerationModelDeclaration, Y as CreateInvitationInput, Yn as SpaceFsReadFilesResponse, Yr as GenerationContentBlock, Z as CreateSpaceInput, Zt as ReferralDashboard, a as WebsocketClientOptions, ai as SpacePublicEndpoints, an as SessionMessageResponse, ar as SpaceInvitation, at as CursorPageInfo, bi as Usage, br as SpaceSessionsResponse, cn as SessionRecord, d as BatchUserProfilesResponse, dn as SessionTurnSignedUrlsResponse, dr as SpacePendingDiffSummary, et as CreateSpacePromptResponse, fn as SessionTurnStreamSnapshotResponse, fr as SpacePresenceSnapshot, ft as GlobalSearchResponse, gi as CreateSpaceCompletionInput, gn as SkillCatalogResponse, gr as SpaceRole, hr as SpaceRecord, ht as InvitationDetail, ii as SessionTurnPatchEvent, ir as SpaceFsWriteFileInput, it as CronJobUpdatePatch, jn as SpaceConfigInput, jr as ChannelConfig, jt as PatchResourceLabelsInput, kt as MeResponse, l as AcceptInvitationResponse, ln as SessionTurnIndexResponse, lr as SpaceModListItem, mn as SessionTurnsPaginatedResponse, mr as SpacePublicProfile, mt as GlobalSearchType, ni as RealtimePatchOperation, oi as MessageRecord, on as SessionMessagesPaginatedResponse, pn as SessionTurnWindowResponse, q as CheckpointRecord, qt as ReferenceQueryResponse, r as WebsocketClient, rr as SpaceFsUploadResponse, rt as CronJobRecord, s as WebsocketEventPayload, si as SessionForkRecord, sn as SessionMessagesResponse, sr as SpaceMember, tt as CreateSpaceSessionInput, ui as SessionTurnRecord, un as SessionTurnResponse, ur as SpacePendingDiffFileResponse, vi as SpaceCompletionResult, vn as SpaceAccessPolicy, wr as TaskRunDetailResponse, wt as LabelListItem, xi as ContentBlock, xn as SpaceCheckpointDetailResponse, xt as LabelAssignmentRecord, yi as SpaceCompletionStreamEvent, zn as SpaceFsCreateUploadInput } from "./websocket.js";
+import { $ as CreateSpacePromptInput, $r as BoardPlaybackChangedEvent$1, Ai as BoardValidationResult, Ar as UserSessionsResponse, At as ModelCatalogEntry, Bn as SpaceFsCreateUploadResponse, Cn as SpaceCommerceBuyerProfile, Dn as SpaceCommerceProduct, Dr as UserRulesResponse, En as SpaceCommerceOrder, Er as UserProfile, Et as LabelResourceType, Fi as SessionForkRecord, Fn as SpaceDefaultResponse, Gn as SpaceFsMoveInput, Gt as ReferenceDirection, In as SpaceEnvInput, It as PromptTemplateCatalogResponse, J as ClaimReferralResponse, Ji as Usage, Jt as ReferenceQueryableType, K as CheckpointDiffSummary, Ki as SpaceCompletionResult, Kn as SpaceFsPreparingFile, Kt as ReferenceKind, Ln as SpaceFsCompleteUploadInput, Lt as PublicReferral, Mn as SpaceConfigResponse, Mr as ChannelHealth, Mt as PatchResourceLabelsResponse, Ni as SpacePublicEndpoints, Nn as SpaceConfigUpdateResponse, Nt as Permission, On as SpaceCommerceProductBenefitBinding, Pi as MessageRecord, Pn as SpaceCreateResponse, Qr as BoardAwarenessUpdatedEvent$1, R as Channel, Ri as SessionTurnRecord, Rn as SpaceFsCompleteUploadResponse, Rt as PublicUserPageResponse, Sn as SpaceCommerceBenefit, Sr as SpaceUsageResponse, St as LabelItemsResponse, Ti as BoardPlaybackSnapshot, Tr as TaskRunRecord, Ut as ReferenceAggregateGroupBy, V as CheckpointDiffFileResponse, Wi as CreateSpaceCompletionInput, Wn as SpaceFsFileResponse, Wt as ReferenceAggregateResponse, X as CreateInvitationResponse, Xi as ContentBlock, Xn as SpaceFsTreeResponse, Xr as GenerationModelDeclaration, Y as CreateInvitationInput, Yi as BillingPayload, Yn as SpaceFsReadFilesResponse, Yr as GenerationContentBlock, Z as CreateSpaceInput, Zt as ReferralDashboard, a as WebsocketClientOptions, ai as SessionTurnPatchEvent, an as SessionMessageResponse, ar as SpaceInvitation, at as CursorPageInfo, br as SpaceSessionsResponse, cn as SessionRecord, d as BatchUserProfilesResponse, di as BoardBootstrap, dn as SessionTurnSignedUrlsResponse, dr as SpacePendingDiffSummary, ea as RequestSource, ei as BoardTransactionAppliedEvent$1, et as CreateSpacePromptResponse, fi as BoardCapabilities, fn as SessionTurnStreamSnapshotResponse, fr as SpacePresenceSnapshot, ft as GlobalSearchResponse, gn as SkillCatalogResponse, gr as SpaceRole, hr as SpaceRecord, ht as InvitationDetail, ir as SpaceFsWriteFileInput, it as CronJobUpdatePatch, jn as SpaceConfigInput, jr as ChannelConfig, jt as PatchResourceLabelsInput, ki as BoardTransaction, kt as MeResponse, l as AcceptInvitationResponse, li as BoardAwarenessUpdate, ln as SessionTurnIndexResponse, lr as SpaceModListItem, mi as BoardCreateInput, mn as SessionTurnsPaginatedResponse, mr as SpacePublicProfile, mt as GlobalSearchType, on as SessionMessagesPaginatedResponse, pn as SessionTurnWindowResponse, q as CheckpointRecord, qi as SpaceCompletionStreamEvent, qt as ReferenceQueryResponse, r as WebsocketClient, ri as RealtimePatchOperation, rr as SpaceFsUploadResponse, rt as CronJobRecord, s as WebsocketEventPayload, sn as SessionMessagesResponse, sr as SpaceMember, tt as CreateSpaceSessionInput, un as SessionTurnResponse, ur as SpacePendingDiffFileResponse, vi as BoardInspectInput, vn as SpaceAccessPolicy, wi as BoardPlaybackCommand, wr as TaskRunDetailResponse, wt as LabelListItem, xn as SpaceCheckpointDetailResponse, xt as LabelAssignmentRecord, zn as SpaceFsCreateUploadInput } 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
@@ -161,41 +160,6 @@ type SpaceStartupResponse = {
   retryAfterMs?: number;
 };
 //#endregion
-//#region ../protocol/dist/provenance.d.ts
-/** Request provenance via X-Cohub-Source-* headers. Never used for authorization. */
-declare const COHUB_SOURCE_HEADER: {
-  readonly space: "X-Cohub-Source-Space";
-  readonly session: "X-Cohub-Source-Session";
-  readonly turn: "X-Cohub-Source-Turn";
-  readonly toolCall: "X-Cohub-Source-Tool-Call";
-  readonly via: "X-Cohub-Source-Via";
-};
-type RequestSourceVia = "cli" | "bash" | "tool" | "api" | "web" | (string & {});
-/** Caller context: via (channel) and optional identity fields. */
-type RequestSource = {
-  spaceId?: string;
-  sessionId?: string;
-  turnId?: string;
-  toolCallId?: string;
-  via?: RequestSourceVia;
-};
-declare const isRequestSourceUuid: (value: unknown) => value is string;
-declare const REQUEST_SOURCE_VIA_MAX_LENGTH = 64;
-declare const isRequestSourceEmpty: (source: RequestSource | null | undefined) => boolean;
-declare const hasRequestSourceIdentity: (source: RequestSource | null | undefined) => boolean;
-/** Drop invalid UUIDs; via-only is valid. */
-declare const normalizeRequestSource: (input: unknown) => RequestSource | null;
-declare const parseRequestSourceFromHeaders: (getHeader: (name: string) => string | null | undefined) => RequestSource | null;
-declare const requestSourceToHeaders: (source: RequestSource | null | undefined) => Record<string, string>;
-/** Read COHUB_* env into a RequestSource. */
-declare const readRequestSourceFromEnv: (env?: Record<string, string | undefined>, defaults?: {
-  via?: RequestSourceVia;
-}) => RequestSource | null;
-declare const resolveRequestSourceChannel: (source: RequestSource | null | undefined, fallback?: string) => string;
-/** Put identity under meta.source; strip body source. Via-only is skipped. */
-declare const mergeRequestSourceIntoMeta: (meta: Record<string, unknown> | null | undefined, headerSource: RequestSource | null | undefined) => Record<string, unknown> | null;
-declare const COHUB_SOURCE_HEADER_NAMES: readonly string[];
-//#endregion
 //#region src/work-runtime.d.ts
 type WorkRuntimeContext = {
   work: {
@@ -898,12 +862,14 @@ declare class BoardTransactionError extends Error {
 }
 type BoardTransactionInput = Omit<BoardTransaction, "boardId">;
 type BoardTransactionAppliedEvent = BoardTransactionAppliedEvent$1;
+type BoardAwarenessUpdatedEvent = BoardAwarenessUpdatedEvent$1;
 type BoardPlaybackChangedEvent = BoardPlaybackChangedEvent$1;
-type BoardEventName = "transaction" | "playback";
+type BoardEventName = "transaction" | "awareness" | "playback";
 type BoardSubscriptionHandlers = {
   transaction?: (event: BoardTransactionAppliedEvent) => void;
+  awareness?: (event: BoardAwarenessUpdatedEvent) => void;
   playback?: (event: BoardPlaybackChangedEvent) => void;
-  event?: (event: BoardTransactionAppliedEvent | BoardPlaybackChangedEvent) => void;
+  event?: (event: BoardTransactionAppliedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent) => void;
 };
 type SessionSubscriptionHandlers = {
   patch?: (event: WebsocketEventPayload) => void;
@@ -1382,11 +1348,13 @@ declare class BoardRealtimeClient {
   constructor(websocketClient: WebsocketClient | null, spaceId: string, boardId: string);
   subscribe(handlers: BoardSubscriptionHandlers): () => void;
   on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "awareness", handler: (event: BoardAwarenessUpdatedEvent) => void): () => void;
   on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
 }
 declare class BoardClient {
   readonly spaceId: string;
   readonly id: string;
+  private readonly websocketClient;
   readonly realtime: BoardRealtimeClient;
   private readonly boards;
   constructor(spaceId: string, id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
@@ -1394,6 +1362,7 @@ declare class BoardClient {
   capabilities(customFetch?: Fetch): Promise<BoardCapabilities>;
   validate(transaction: BoardTransactionInput): Promise<BoardValidationResult>;
   apply(transaction: BoardTransactionInput): Promise<BoardBootstrap>;
+  updateAwareness(seq: number, update: BoardAwarenessUpdate): Promise<void>;
   playback(command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
   play(command: Omit<Extract<BoardPlaybackCommand, {
     type: "play";
@@ -1411,6 +1380,7 @@ declare class BoardClient {
   }>): Promise<BoardPlaybackSnapshot>;
   subscribe(handlers: BoardSubscriptionHandlers): () => void;
   on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "awareness", handler: (event: BoardAwarenessUpdatedEvent) => void): () => void;
   on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
 }
 declare class SpaceBoardsApi {
@@ -1910,4 +1880,4 @@ declare class CohubHttpClient {
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { GenerationStreamFinalizedEvent as $, resolveWorkTransport as $t, ReferralsApi as A, ModelsApi as At, BoardTransactionInput as B, sanitizeAccessToken as Bt, WorkSessionResponse as C, PublicAssetPurpose as Ct, WorkVersionRecord as D, UploadPublicAssetInput as Dt, WorkUpdateInput as E, UploadChatImageAttachmentInput as Et, BoardEventName as F, Fetch as Ft, SpaceEventName as G, WorkRuntimeCheckoutState as Gt, SessionSubscriptionHandlers as H, PopupBrokerTransport as Ht, BoardPlaybackChangedEvent as I, HttpError as It, PublicInviteApi as J, WorkRuntimeModeConfig as Jt, SpacesApi as K, WorkRuntimeCheckoutStatus as Kt, BoardSubscriptionHandlers as L, HttpTransport as Lt, UserApi as M, CronJobsApi as Mt, TasksApi as N, ChannelsApi as Nt, WorkVisibility as O, SkillsApi as Ot, BoardClient as P, CohubClientOptions as Pt, GenerationStreamEvent as Q, createWorkRuntime as Qt, BoardTransactionAppliedEvent as R, RawHttpResponse as Rt, WorkResolveResponse as S, ModelStatusResponse as Sn, PublicAssetMimeType as St, WorkTargetType as T, UploadChatAttachmentInput as Tt, SpaceChannelBindingRecord as U, WorkIdResolver as Ut, SessionEventName as V, ParentBridgeTransport as Vt, SpaceClient as W, WorkRuntimeApi as Wt, GenerationStreamCommitEvent as X, WorkRuntimeTransport as Xt, AssistantMessageCommit as Y, WorkRuntimeRequestOptions as Yt, GenerationStreamErrorEvent as Z, createSlugWorkIdResolver as Zt, WorkMeta as _, GenerationTaskResult as _n, ReferenceResourceSelector as _t, WorkCommerceCreditConsumeResponse as a, hasRequestSourceIdentity as an, GenerationStreamSubscriptionHandlers as at, WorkPublicSpaceRecord as b, PublicGenerationDeclaration as bn, CreatePublicAssetUploadInput as bt, WorkCommerceEntitlementsResponse as c, mergeRequestSourceIntoMeta as cn, createSessionGenerationStreamClient as ct, WorkCommercePurchaseResponse as d, readRequestSourceFromEnv as dn, SessionPatchApplyResult as dt, COHUB_SOURCE_HEADER as en, GenerationStreamIntermediateMessage as et, WorkAuthorizeResponse as f, requestSourceToHeaders as fn, SessionPatchReducer as ft, WorkGetResponse as g, CreateGenerationTaskResponse as gn, SessionAccessApi as gt, WorkExtractedPageMeta as h, CreateGenerationTaskRequest as hn, createSessionPatchReducer as ht, WorkCommerceCheckoutStatus as i, RequestSourceVia as in, GenerationStreamSubscribeOptions as it, UsersApi as j, GenerationsApi as jt, WorksApi as k, PromptsApi as kt, WorkCommerceOrder as l, normalizeRequestSource as ln, parseAssistantMessageCommit as lt, WorkDetailResponse as m, SpaceStartupResponse as mn, SessionPatchStatus as mt, createHttpClient as n, REQUEST_SOURCE_VIA_MAX_LENGTH as nn, GenerationStreamOutOfSyncEvent as nt, WorkCommerceCreditConsumeStatus as o, isRequestSourceEmpty as on, GenerationStreamTurnUpdatedEvent as ot, WorkCreateInput as p, resolveRequestSourceChannel as pn, SessionPatchState as pt, WebSocketConnectionState as q, WorkRuntimeContext as qt, WorkCommerceApi as r, RequestSource as rn, GenerationStreamStateEvent as rt, WorkCommerceEntitlement as s, isRequestSourceUuid as sn, SessionGenerationStreamClient as st, CohubHttpClient as t, COHUB_SOURCE_HEADER_NAMES as tn, GenerationStreamLifecycleEvent as tt, WorkCommerceProductResolveResponse as u, parseRequestSourceFromHeaders as un, SessionPatchApplyInput as ut, WorkPresentationMeta as v, GenerationUsageBilling as vn, ReferencesApi as vt, WorkStatus as w, PublicAssetsApi as wt, WorkRecord as x, ModelStatusEntry as xn, CreatePublicAssetUploadResponse as xt, WorkPublicOwnerRecord as y, ListGenerationModelsResponse as yn, SearchApi as yt, BoardTransactionError as z, joinApiUrl as zt };
+export { GenerationStreamEvent as $, createWorkRuntime as $t, ReferralsApi as A, PromptsApi as At, BoardTransactionError as B, joinApiUrl as Bt, WorkSessionResponse as C, PublicAssetMimeType as Ct, WorkVersionRecord as D, UploadChatImageAttachmentInput as Dt, WorkUpdateInput as E, UploadChatAttachmentInput as Et, BoardClient as F, CohubClientOptions as Ft, SpaceClient as G, WorkRuntimeApi as Gt, SessionEventName as H, ParentBridgeTransport as Ht, BoardEventName as I, Fetch as It, WebSocketConnectionState as J, WorkRuntimeContext as Jt, SpaceEventName as K, WorkRuntimeCheckoutState as Kt, BoardPlaybackChangedEvent as L, HttpError as Lt, UserApi as M, GenerationsApi as Mt, TasksApi as N, CronJobsApi as Nt, WorkVisibility as O, UploadPublicAssetInput as Ot, BoardAwarenessUpdatedEvent as P, ChannelsApi as Pt, GenerationStreamErrorEvent as Q, createSlugWorkIdResolver as Qt, BoardSubscriptionHandlers as R, HttpTransport as Rt, WorkResolveResponse as S, CreatePublicAssetUploadResponse as St, WorkTargetType as T, PublicAssetsApi as Tt, SessionSubscriptionHandlers as U, PopupBrokerTransport as Ut, BoardTransactionInput as V, sanitizeAccessToken as Vt, SpaceChannelBindingRecord as W, WorkIdResolver as Wt, AssistantMessageCommit as X, WorkRuntimeRequestOptions as Xt, PublicInviteApi as Y, WorkRuntimeModeConfig as Yt, GenerationStreamCommitEvent as Z, WorkRuntimeTransport as Zt, WorkMeta as _, SessionAccessApi as _t, WorkCommerceCreditConsumeResponse as a, GenerationUsageBilling as an, GenerationStreamSubscribeOptions as at, WorkPublicSpaceRecord as b, SearchApi as bt, WorkCommerceEntitlementsResponse as c, ModelStatusEntry as cn, SessionGenerationStreamClient as ct, WorkCommercePurchaseResponse as d, SessionPatchApplyInput as dt, resolveWorkTransport as en, GenerationStreamFinalizedEvent as et, WorkAuthorizeResponse as f, SessionPatchApplyResult as ft, WorkGetResponse as g, createSessionPatchReducer as gt, WorkExtractedPageMeta as h, SessionPatchStatus as ht, WorkCommerceCheckoutStatus as i, GenerationTaskResult as in, GenerationStreamStateEvent as it, UsersApi as j, ModelsApi as jt, WorksApi as k, SkillsApi as kt, WorkCommerceOrder as l, ModelStatusResponse as ln, createSessionGenerationStreamClient as lt, WorkDetailResponse as m, SessionPatchState as mt, createHttpClient as n, CreateGenerationTaskRequest as nn, GenerationStreamLifecycleEvent as nt, WorkCommerceCreditConsumeStatus as o, ListGenerationModelsResponse as on, GenerationStreamSubscriptionHandlers as ot, WorkCreateInput as p, SessionPatchReducer as pt, SpacesApi as q, WorkRuntimeCheckoutStatus as qt, WorkCommerceApi as r, CreateGenerationTaskResponse as rn, GenerationStreamOutOfSyncEvent as rt, WorkCommerceEntitlement as s, PublicGenerationDeclaration as sn, GenerationStreamTurnUpdatedEvent as st, CohubHttpClient as t, SpaceStartupResponse as tn, GenerationStreamIntermediateMessage as tt, WorkCommerceProductResolveResponse as u, parseAssistantMessageCommit as ut, WorkPresentationMeta as v, ReferenceResourceSelector as vt, WorkStatus as w, PublicAssetPurpose as wt, WorkRecord as x, CreatePublicAssetUploadInput as xt, WorkPublicOwnerRecord as y, ReferencesApi as yt, BoardTransactionAppliedEvent as z, RawHttpResponse as zt };

package/dist/chunks/http.js

@@ -1,4 +1,4 @@
-import { n as HttpTransport, t as HttpError, y as getRealtimeSpaceRoom } from "./transport.js";
+import { b as getRealtimeBoardRoom, n as HttpTransport, t as HttpError, x as getRealtimeSpaceRoom } from "./transport.js";
 import { a as resolveApiBaseUrl } from "./environment.js";
 //#region src/apis/channels.ts
 var ChannelsApi = class {
@@ -2161,7 +2161,7 @@ var BoardRealtimeClient = class {
 	subscribe(handlers) {
 		if (!this.websocketClient) throw new Error("realtime transport is not configured for this client");
 		ensureRealtimeConnected(this.websocketClient);
-		const releaseRoom = this.websocketClient.retainRooms([getRealtimeSpaceRoom(this.spaceId)]);
+		const releaseRoom = this.websocketClient.retainRooms([getRealtimeSpaceRoom(this.spaceId), getRealtimeBoardRoom(this.boardId)]);
 		const unsubscribe = this.websocketClient.on("event", (event) => {
 			if (event.spaceId !== this.spaceId) return;
 			if (event.type === "board.transaction.applied" && event.payload.boardId === this.boardId) {
@@ -2169,6 +2169,13 @@ var BoardRealtimeClient = class {
 				handlers.event?.(transactionEvent);
 				handlers.transaction?.(transactionEvent);
 			}
+			if (event.type === "board.awareness.updated" && event.payload.boardId === this.boardId) {
+				const awarenessEvent = event;
+				if (awarenessEvent.payload.connectionId !== this.websocketClient?.connectionId) {
+					handlers.event?.(awarenessEvent);
+					handlers.awareness?.(awarenessEvent);
+				}
+			}
 			if (event.type === "board.playback.changed" && event.payload.boardId === this.boardId) {
 				const playbackEvent = event;
 				handlers.event?.(playbackEvent);
@@ -2181,17 +2188,21 @@ var BoardRealtimeClient = class {
 		};
 	}
 	on(type, handler) {
-		return type === "transaction" ? this.subscribe({ transaction: handler }) : this.subscribe({ playback: handler });
+		if (type === "transaction") return this.subscribe({ transaction: handler });
+		if (type === "awareness") return this.subscribe({ awareness: handler });
+		return this.subscribe({ playback: handler });
 	}
 };
 var BoardClient = class {
 	spaceId;
 	id;
+	websocketClient;
 	realtime;
 	boards;
 	constructor(spaceId, id, transport, websocketClient) {
 		this.spaceId = spaceId;
 		this.id = id;
+		this.websocketClient = websocketClient;
 		this.boards = new SpaceBoardsApi(transport, spaceId, websocketClient);
 		this.realtime = new BoardRealtimeClient(websocketClient, spaceId, id);
 	}
@@ -2213,6 +2224,15 @@ var BoardClient = class {
 			boardId: this.id
 		});
 	}
+	updateAwareness(seq, update) {
+		if (!this.websocketClient) return Promise.resolve();
+		return this.websocketClient.updateBoardAwareness({
+			spaceId: this.spaceId,
+			boardId: this.id,
+			seq,
+			update
+		});
+	}
 	playback(command) {
 		return this.boards.playback(this.id, command);
 	}
@@ -2232,7 +2252,9 @@ var BoardClient = class {
 		return this.realtime.subscribe(handlers);
 	}
 	on(type, handler) {
-		return type === "transaction" ? this.realtime.on("transaction", handler) : this.realtime.on("playback", handler);
+		if (type === "transaction") return this.realtime.on("transaction", handler);
+		if (type === "awareness") return this.realtime.on("awareness", handler);
+		return this.realtime.on("playback", handler);
 	}
 };
 var SpaceBoardsApi = class {

package/dist/chunks/transport.js

@@ -2,7 +2,9 @@ import { a as resolveApiBaseUrl } from "./environment.js";
 //#region ../protocol/dist/realtime/types.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 getRealtimeSpaceRoom = (spaceId) => `space:${spaceId}`;
+const getRealtimeBoardRoom = (boardId) => `board:${boardId}`;
 const parseRealtimeRoom = (room) => {
 	const trimmed = room.trim();
 	const separatorIndex = trimmed.indexOf(":");
@@ -10,7 +12,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") return null;
+	if (kind !== "space" && kind !== "user" && kind !== "board") return null;
 	return {
 		kind,
 		id
@@ -302,4 +304,4 @@ var HttpTransport = class {
 	}
 };
 //#endregion
-export { WS_COMPACT_STREAM_CAPABILITY as _, COHUB_SOURCE_HEADER as a, getSessionTurnPatchStreamKey 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_ROOM_SUBSCRIPTION_CAPABILITY as v, normalizeRealtimeRooms as x, getRealtimeSpaceRoom as y };
+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 };