@neta-art/cohub 5.10.0 → 7.0.0

package/dist/board/semantic-mutation.js

@@ -0,0 +1,203 @@
+import { BoardAuthoringItemSchema } from "../protocol/dist/board-authoring.js";
+import { BoardAppearanceSchema, isUnknownItem } from "../protocol/dist/board-document.js";
+import { applyBoardItemPatch } from "../protocol/dist/board-codec.js";
+import { boardJsonEquals } from "../protocol/dist/board-json.js";
+import { boardAuthoringItemToDocumentItem, boardItemToAuthoringItem } from "./semantic-document.js";
+//#region src/board/semantic-mutation.ts
+function semanticItem(item) {
+	const value = boardItemToAuthoringItem(item);
+	if (value) return value;
+	const raw = isUnknownItem(item) ? BoardAuthoringItemSchema.safeParse(item.raw) : null;
+	if (raw?.success) return raw.data;
+	throw new Error(`Cannot author unknown Board item ${item.id}; the item has no semantic extension schema`);
+}
+function mergePatchValue(before, after) {
+	if (boardJsonEquals(before, after)) return void 0;
+	if (after === void 0) return null;
+	if (before && after && typeof before === "object" && typeof after === "object" && !Array.isArray(before) && !Array.isArray(after)) {
+		const patch = {};
+		const keys = /* @__PURE__ */ new Set([...Object.keys(before), ...Object.keys(after)]);
+		for (const key of keys) {
+			const value = mergePatchValue(before[key], after[key]);
+			if (value !== void 0) patch[key] = value;
+		}
+		return patch;
+	}
+	return after;
+}
+function itemPatch(before, after) {
+	const beforeAuthoring = semanticItem(before);
+	const afterAuthoring = semanticItem(after);
+	const patch = {};
+	if (!boardJsonEquals(before.frame, after.frame)) patch.frame = after.frame;
+	const beforeParent = before.parentId ?? null;
+	const afterParent = after.parentId ?? null;
+	if (beforeParent !== afterParent) patch.parentId = afterParent;
+	if ((before.locked ?? false) !== (after.locked ?? false)) patch.locked = after.locked ?? null;
+	const metadata = mergePatchValue(before.metadata, after.metadata);
+	if (metadata !== void 0) patch.metadata = after.metadata === void 0 ? null : metadata;
+	const props = mergePatchValue(beforeAuthoring.props, afterAuthoring.props);
+	if (props !== void 0) patch.props = props;
+	const beforeStyle = "style" in beforeAuthoring ? beforeAuthoring.style : void 0;
+	const afterStyle = "style" in afterAuthoring ? afterAuthoring.style : void 0;
+	const style = mergePatchValue(beforeStyle, afterStyle);
+	if (style !== void 0) patch.style = afterStyle === void 0 ? null : style;
+	const beforeSource = "source" in beforeAuthoring ? beforeAuthoring.source : void 0;
+	const afterSource = "source" in afterAuthoring ? afterAuthoring.source : void 0;
+	const source = mergePatchValue(beforeSource, afterSource);
+	if (source !== void 0) patch.source = afterSource === void 0 ? null : source;
+	return Object.keys(patch).length ? patch : null;
+}
+function connectionPatch(before, after) {
+	const patch = {};
+	for (const key of [
+		"source",
+		"target",
+		"relation",
+		"direction",
+		"label",
+		"routing",
+		"style",
+		"metadata"
+	]) if (!boardJsonEquals(before[key], after[key])) patch[key] = after[key];
+	return Object.keys(patch).length ? patch : null;
+}
+/** Compile an editor document delta to the public semantic mutation command set. */
+function boardDocumentToSemanticCommands(before, after) {
+	const commands = [];
+	if (!boardJsonEquals(before.appearance, after.appearance)) commands.push({
+		type: "board.patch",
+		patch: { metadataPatch: { appearance: after.appearance } }
+	});
+	const beforeConnections = new Map(before.connections.map((connection) => [connection.id, connection]));
+	const afterConnections = new Map(after.connections.map((connection) => [connection.id, connection]));
+	const beforeItems = new Map(before.items.map((item) => [item.id, item]));
+	const afterItems = new Map(after.items.map((item) => [item.id, item]));
+	for (const [id] of beforeConnections) if (!afterConnections.has(id)) commands.push({
+		type: "connection.delete",
+		connectionId: id
+	});
+	for (const item of after.items) {
+		const previous = beforeItems.get(item.id);
+		if (!previous) {
+			commands.push({
+				type: "item.create",
+				item: semanticItem(item)
+			});
+			continue;
+		}
+		if (previous.type !== item.type) {
+			commands.push({
+				type: "item.replace",
+				itemId: item.id,
+				item: semanticItem(item)
+			});
+			continue;
+		}
+		const patch = itemPatch(previous, item);
+		if (patch) commands.push({
+			type: "item.patch",
+			itemId: item.id,
+			patch
+		});
+	}
+	for (const [id] of beforeItems) if (!afterItems.has(id)) commands.push({
+		type: "item.delete",
+		itemId: id,
+		cascade: false
+	});
+	const workingOrder = before.items.map((item) => item.id);
+	for (const item of after.items) if (!beforeItems.has(item.id)) workingOrder.push(item.id);
+	for (const [id] of beforeItems) if (!afterItems.has(id)) workingOrder.splice(workingOrder.indexOf(id), 1);
+	for (let index = 0; index < after.items.length; index += 1) {
+		const id = after.items[index]?.id;
+		if (!id || workingOrder[index] === id) continue;
+		const previousIndex = workingOrder.indexOf(id);
+		if (previousIndex < 0) continue;
+		workingOrder.splice(previousIndex, 1);
+		workingOrder.splice(index, 0, id);
+		commands.push({
+			type: "item.reorder",
+			itemId: id,
+			index
+		});
+	}
+	for (const connection of after.connections) {
+		const previous = beforeConnections.get(connection.id);
+		if (!previous) {
+			commands.push({
+				type: "connection.create",
+				connection
+			});
+			continue;
+		}
+		const patch = connectionPatch(previous, connection);
+		if (patch) commands.push({
+			type: "connection.patch",
+			connectionId: connection.id,
+			patch
+		});
+	}
+	return commands;
+}
+/** Apply public semantic commands to the local render document (undo/rebase). */
+function applyBoardSemanticCommands(document, commands) {
+	let items = [...document.items];
+	let connections = [...document.connections];
+	let appearance = document.appearance;
+	for (const command of commands) {
+		if (command.type === "board.patch") {
+			const candidate = command.patch.metadataPatch?.appearance ?? command.patch.metadata?.appearance;
+			if (candidate !== void 0) {
+				const parsed = BoardAppearanceSchema.safeParse(candidate);
+				if (parsed.success) appearance = parsed.data;
+			}
+			continue;
+		}
+		if (command.type === "item.create") {
+			if (!items.some((item) => item.id === command.item.id)) items.push(boardAuthoringItemToDocumentItem(command.item));
+			continue;
+		}
+		if (command.type === "item.patch") {
+			items = items.map((item) => item.id === command.itemId ? boardAuthoringItemToDocumentItem(applyBoardItemPatch(semanticItem(item), command.patch)) : item);
+			continue;
+		}
+		if (command.type === "item.replace") {
+			items = items.map((item) => item.id === command.itemId ? boardAuthoringItemToDocumentItem(command.item) : item);
+			continue;
+		}
+		if (command.type === "item.delete") {
+			items = items.filter((item) => item.id !== command.itemId);
+			connections = connections.filter((connection) => connection.source.itemId !== command.itemId && connection.target.itemId !== command.itemId);
+			continue;
+		}
+		if (command.type === "item.reorder") {
+			const index = items.findIndex((item) => item.id === command.itemId);
+			if (index < 0) continue;
+			const [item] = items.splice(index, 1);
+			if (item) items.splice(Math.min(command.index, items.length), 0, item);
+			continue;
+		}
+		if (command.type === "connection.create") {
+			if (!connections.some((connection) => connection.id === command.connection.id)) connections.push(command.connection);
+			continue;
+		}
+		if (command.type === "connection.patch") {
+			connections = connections.map((connection) => connection.id === command.connectionId ? {
+				...connection,
+				...command.patch,
+				id: connection.id
+			} : connection);
+			continue;
+		}
+		if (command.type === "connection.delete") connections = connections.filter((connection) => connection.id !== command.connectionId);
+	}
+	return {
+		...document,
+		appearance,
+		items,
+		connections
+	};
+}
+//#endregion
+export { applyBoardSemanticCommands, boardDocumentToSemanticCommands };

package/dist/chunks/http.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateInvitationInput, $n as SpaceFsPreparingFile, Aa as BoardTransaction, Ar as SpaceTurnAuthorFilter, At as MeResponse, Bn as SpaceDefaultResponse, Cr as SpacePublicProfile, Ct as LabelItemsResponse, Dn as SpaceCommerceBenefit, Dt as LabelResourceType, Ei as SessionTurnPatchEvent, En as SpaceCheckpointDetailResponse, G as CheckpointDiffFileResponse, Ga as BoardConnectionRecord, Gn as SpaceFsCreateUploadInput, Gt as ReferenceAggregateResponse, H as Channel, Hn as SpaceFsCompleteUploadInput, Hr as UserProfile, In as SpaceConfigInput, Ir as TaskRunDetailResponse, Ji as UiCommandError, Jr as ChannelHealth, Jt as ReferenceQueryResponse, Ki as UiCommand, Kn as SpaceFsCreateUploadResponse, Kr as UserSessionsResponse, Kt as ReferenceDirection, Ln as SpaceConfigResponse, Lr as TaskRunRecord, Lt as PromptTemplateCatalogResponse, Mi as WorkArtifactDescriptor, Mn as SpaceCommerceProduct, Mt as PatchResourceLabelsInput, Nn as SpaceCommerceProductBenefitBinding, Nt as PatchResourceLabelsResponse, Oa as BoardSummary, On as SpaceCommerceBuyerProfile, Pr as SpaceUsageResponse, Pt as Permission, Q as ClaimReferralResponse, Qn as SpaceFsMoveInput, Qt as ReferralDashboard, Ri as WorkContentKind, Rn as SpaceConfigUpdateResponse, Rr as UserActivityQuery, Rt as PublicReferral, Sa as BoardPlaybackCommand, St as LabelAssignmentRecord, Ta as BoardPlaybackSnapshot, Tr as SpaceRole, Tt as LabelListItem, Ua as BoardConnection, Un as SpaceFsCompleteUploadResponse, Ur as UserRulesResponse, Vn as SpaceEnvInput, Vr as UserActivityResponse, Wa as BoardConnectionDirection, Wt as ReferenceAggregateGroupBy, X as CheckpointDiffSummary, Xa as MessageRecord, Xi as UiCommandStatus, Ya as SpacePublicEndpoints, Yi as UiCommandRecord, Yt as ReferenceQueryableType, Z as CheckpointRecord, Za as SessionForkRecord, Zn as SpaceFsFileResponse, _n as SkillCatalogResponse, _o as RequestSource, a as WebsocketClientOptions, at as CreateSpaceSessionInput, bn as SpaceAccessPolicy, br as SpacePendingDiffSummary, cn as SessionMessagesResponse, ct as CronJobUpdatePatch, d as BatchUserProfilesResponse, di as GenerationContentBlock, dn as SessionTurnResponse, do as Usage, dr as SpaceFsWriteFileInput, eo as SessionTurnRecord, et as CreateInvitationResponse, fa as BoardCreateInput, fi as GenerationModelDeclaration, fn as SessionTurnSignedUrlsResponse, fo as BillingPayload, ga as BoardInspectInput, gi as BoardTransactionAppliedEvent$1, gr as SpaceMember, gt as InvitationDetail, hi as BoardPlaybackChangedEvent$1, hn as SessionTurnsPaginatedResponse, ht as GlobalSearchType, it as CreateSpacePromptResponse, ja as BoardValidationResult, ji as BoardAwarenessUpdate, jn as SpaceCommerceOrder, jt as ModelCatalogEntry, kr as SpaceSessionsResponse, l as AcceptInvitationResponse, ln as SessionRecord, lo as SpaceCompletionResult, lt as CursorPageInfo, mi as BoardAwarenessUpdatedEvent$1, mn as SessionTurnWindowResponse, nr as SpaceFsReadFilesResponse, oa as BoardBootstrap, on as SessionMessageResponse, pn as SessionTurnStreamSnapshotResponse, po as ContentBlock, pr as SpaceInvitationListResponse, pt as GlobalSearchResponse, qr as ChannelConfig, qt as ReferenceKind, r as WebsocketClient, rr as SpaceFsTreeResponse, rt as CreateSpacePromptInput, s as WebsocketEventPayload, sn as SessionMessagesPaginatedResponse, so as CreateSpaceCompletionInput, st as CronJobRecord, to as SpaceTurnsResponse, tt as CreateSpaceInput, ua as BoardCapabilities, un as SessionTurnIndexResponse, uo as SpaceCompletionStreamEvent, ur as SpaceFsUploadResponse, vr as SpaceModListItem, wr as SpaceRecord, xa as BoardOperation, xr as SpacePresenceSnapshot, yi as RealtimePatchOperation, yr as SpacePendingDiffFileResponse, zn as SpaceCreateResponse, zt as PublicUserPageResponse } from "./websocket.js";
+import { $ as CreateInvitationInput, $i as UiCommandRecord, $n as SpaceFsPreparingFile, Ai as SessionTurnPatchEvent, Ar as SpaceTurnAuthorFilter, At as MeResponse, Bn as SpaceDefaultResponse, Ci as RealtimePatchOperation, Co as RequestSource, Cr as SpacePublicProfile, Ct as LabelItemsResponse, Da as BoardAuthoringReadInput, Dn as SpaceCommerceBenefit, Dt as LabelResourceType, En as SpaceCheckpointDetailResponse, Fi as BoardAwarenessUpdate, G as CheckpointDiffFileResponse, Gn as SpaceFsCreateUploadInput, Gt as ReferenceAggregateResponse, H as Channel, Hi as WorkContentKind, Hn as SpaceFsCompleteUploadInput, Hr as UserProfile, Ii as WorkArtifactDescriptor, In as SpaceConfigInput, Ir as TaskRunDetailResponse, Jr as ChannelHealth, Jt as ReferenceQueryResponse, Kn as SpaceFsCreateUploadResponse, Kr as UserSessionsResponse, Kt as ReferenceDirection, Ln as SpaceConfigResponse, Lr as TaskRunRecord, Lt as PromptTemplateCatalogResponse, Ma as BoardSemanticMutation, Mn as SpaceCommerceProduct, Mt as PatchResourceLabelsInput, Nn as SpaceCommerceProductBenefitBinding, Nt as PatchResourceLabelsResponse, Oa as BoardAuthoringSnapshot, On as SpaceCommerceBuyerProfile, Pr as SpaceUsageResponse, Pt as Permission, Q as ClaimReferralResponse, Qi as UiCommandError, Qn as SpaceFsMoveInput, Qt as ReferralDashboard, Rn as SpaceConfigUpdateResponse, Rr as UserActivityQuery, Rt as PublicReferral, Sa as BoardSummary, St as LabelAssignmentRecord, Tr as SpaceRole, Tt as LabelListItem, Un as SpaceFsCompleteUploadResponse, Ur as UserRulesResponse, Vn as SpaceEnvInput, Vr as UserActivityResponse, Wt as ReferenceAggregateGroupBy, X as CheckpointDiffSummary, Xi as UiCommand, Yt as ReferenceQueryableType, Z as CheckpointRecord, Zn as SpaceFsFileResponse, _a as BoardPlaybackCommand, _n as SkillCatalogResponse, _o as Usage, a as WebsocketClientOptions, at as CreateSpaceSessionInput, ba as BoardPlaybackSnapshot, bi as BoardPlaybackChangedEvent$1, bn as SpaceAccessPolicy, br as SpacePendingDiffSummary, cn as SessionMessagesResponse, ct as CronJobUpdatePatch, d as BatchUserProfilesResponse, di as GenerationContentBlock, dn as SessionTurnResponse, dr as SpaceFsWriteFileInput, ea as UiCommandStatus, et as CreateInvitationResponse, fa as BoardCapabilities, fi as GenerationModelDeclaration, fn as SessionTurnSignedUrlsResponse, ga as BoardMutationReceipt, go as SpaceCompletionStreamEvent, gr as SpaceMember, gt as InvitationDetail, hn as SessionTurnsPaginatedResponse, ho as SpaceCompletionResult, ht as GlobalSearchType, it as CreateSpacePromptResponse, jn as SpaceCommerceOrder, jt as ModelCatalogEntry, kr as SpaceSessionsResponse, l as AcceptInvitationResponse, ln as SessionRecord, lt as CursorPageInfo, mn as SessionTurnWindowResponse, no as MessageRecord, nr as SpaceFsReadFilesResponse, on as SessionMessageResponse, oo as SessionTurnRecord, pa as BoardCreateInput, pn as SessionTurnStreamSnapshotResponse, po as CreateSpaceCompletionInput, pr as SpaceInvitationListResponse, pt as GlobalSearchResponse, qr as ChannelConfig, qt as ReferenceKind, r as WebsocketClient, ro as SessionForkRecord, rr as SpaceFsTreeResponse, rt as CreateSpacePromptInput, s as WebsocketEventPayload, sn as SessionMessagesPaginatedResponse, so as SpaceTurnsResponse, st as CronJobRecord, to as SpacePublicEndpoints, tt as CreateSpaceInput, un as SessionTurnIndexResponse, ur as SpaceFsUploadResponse, vi as BoardAwarenessUpdatedEvent$1, vo as BillingPayload, vr as SpaceModListItem, wr as SpaceRecord, xr as SpacePresenceSnapshot, yi as BoardChangedEvent$1, yo as ContentBlock, yr as SpacePendingDiffFileResponse, zn as SpaceCreateResponse, zt as PublicUserPageResponse } 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
@@ -206,6 +206,14 @@ declare const WORK_PROMOTION_EVENT_KEYS: readonly ["landing", "ready", "registra
 type WorkPromotionEventKey = typeof WORK_PROMOTION_EVENT_KEYS[number];
 //#endregion
 //#region src/work-runtime.d.ts
+type WorkRuntimeInvocationContext = {
+  surface: "page" | "preview" | "background" | "broker";
+  source?: "ui_command" | "user" | "route";
+  spaceId?: string;
+  sessionId?: string;
+  turnId?: string;
+  toolCallId?: string;
+};
 type WorkRuntimeContext = {
   work: {
     id: string;
@@ -219,6 +227,7 @@ type WorkRuntimeContext = {
   viewer?: {
     userUuid: string;
   } | null;
+  invocation?: WorkRuntimeInvocationContext;
   permissions?: {
     scopes: Permission[];
     workScopes: Permission[];
@@ -956,33 +965,15 @@ declare function buildSpacePath(input: BuildSpacePathInput): string;
 declare function buildSpaceInvitePath(input: BuildSpaceInvitePathInput): string;
 //#endregion
 //#region src/apis/spaces.d.ts
-/**
- * A board transaction rejected by the server. `status`/`code` let callers
- * distinguish a recoverable version conflict (409 / "VERSION_CONFLICT") from
- * transient failures, so they can rebase and retry instead of surfacing an error.
- */
-declare class BoardTransactionError extends Error {
-  readonly status?: number | undefined;
-  readonly code?: string | undefined;
-  readonly body?: unknown;
-  constructor(message: string, status?: number | undefined, code?: string | undefined, body?: unknown, options?: ErrorOptions);
-  get isVersionConflict(): boolean;
-}
-type BoardTransactionInput = Omit<BoardTransaction, "boardId">;
-type BoardMutationInput = {
-  include?: BoardInspectInput["include"];
-  retries?: number;
-  build: (current: BoardBootstrap) => BoardOperation[] | Promise<BoardOperation[]>;
-};
-type BoardTransactionAppliedEvent = BoardTransactionAppliedEvent$1;
+type BoardChangedEvent = BoardChangedEvent$1;
 type BoardAwarenessUpdatedEvent = BoardAwarenessUpdatedEvent$1;
 type BoardPlaybackChangedEvent = BoardPlaybackChangedEvent$1;
-type BoardEventName = "transaction" | "awareness" | "playback";
+type BoardEventName = "changed" | "awareness" | "playback";
 type BoardSubscriptionHandlers = {
-  transaction?: (event: BoardTransactionAppliedEvent) => void;
+  changed?: (event: BoardChangedEvent) => void;
   awareness?: (event: BoardAwarenessUpdatedEvent) => void;
   playback?: (event: BoardPlaybackChangedEvent) => void;
-  event?: (event: BoardTransactionAppliedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent) => void;
+  event?: (event: BoardChangedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent) => void;
 };
 type SessionSubscriptionHandlers = {
   patch?: (event: WebsocketEventPayload) => void;
@@ -995,7 +986,7 @@ type SessionSubscriptionHandlers = {
   event?: (event: WebsocketEventPayload) => void;
 };
 type SessionEventName = "created" | "updated" | "turn.created" | "turn.patch" | "turn.lifecycle" | "turn.updated" | "turn.finalized" | "turn.error" | "message.persisted";
-type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "board.transaction.applied" | "board.playback.changed" | "work.version.published" | "task.created" | "task.updated" | "event";
+type SpaceEventName = SessionEventName | "fs.changed" | "ports.changed" | "presence.updated" | "board.changed" | "board.playback.changed" | "work.version.published" | "task.created" | "task.updated" | "event";
 declare class SpacesApi {
   private readonly transport;
   constructor(transport: HttpTransport);
@@ -1503,7 +1494,7 @@ declare class BoardRealtimeClient {
   private readonly boardId;
   constructor(websocketClient: WebsocketClient | null, spaceId: string, boardId: string);
   subscribe(handlers: BoardSubscriptionHandlers): () => void;
-  on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "changed", handler: (event: BoardChangedEvent) => void): () => void;
   on(type: "awareness", handler: (event: BoardAwarenessUpdatedEvent) => void): () => void;
   on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
 }
@@ -1514,70 +1505,14 @@ declare class BoardClient {
   readonly realtime: BoardRealtimeClient;
   private readonly boards;
   constructor(spaceId: string, id: string, transport: HttpTransport, websocketClient: WebsocketClient | null);
-  inspect(input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
   capabilities(customFetch?: Fetch): Promise<BoardCapabilities>;
   summary(customFetch?: Fetch): Promise<BoardSummary>;
-  mutate(input: BoardMutationInput): Promise<BoardBootstrap>;
-  validate(transaction: BoardTransactionInput): Promise<BoardValidationResult>;
-  apply(transaction: BoardTransactionInput, options?: {
-    compact?: boolean;
-  }): Promise<BoardBootstrap>;
+  authoring(input?: BoardAuthoringReadInput, customFetch?: Fetch): Promise<BoardAuthoringSnapshot>;
+  mutateSemantic(input: Omit<BoardSemanticMutation, "mutationId" | "dryRun"> & {
+    mutationId?: string;
+    dryRun?: boolean;
+  }): Promise<BoardMutationReceipt>;
   updateAwareness(seq: number, update: BoardAwarenessUpdate): Promise<void>;
-  playback(command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
-  /**
-   * Read the Board's relations.
-   *
-   * A dedicated read rather than a filter over `inspect()`: a caller that wants
-   * the graph should not have to fetch every node's geometry to get it.
-   */
-  connections(customFetch?: Fetch): Promise<BoardConnectionRecord[]>;
-  /**
-   * Connections touching a node, in either direction.
-   *
-   * Filtered client-side from the Board's relation set, which is a single read and
-   * bounded by the Board rather than by the node's degree.
-   */
-  connectionsForNode(nodeId: string, customFetch?: Fetch): Promise<BoardConnectionRecord[]>;
-  /**
-   * Connect two nodes.
-   *
-   * Wraps the transaction so the common case is one call: the caller supplies the
-   * two nodes and, optionally, the relation. `baseVersion` still has to be the
-   * version the caller last read, because a relation is only meaningful against
-   * the node set it was authored on.
-   */
-  connect(input: {
-    baseVersion: number;
-    sourceNodeId: string;
-    targetNodeId: string;
-    id?: string;
-    relation?: string;
-    direction?: BoardConnectionDirection;
-    label?: string;
-    sourcePortId?: string;
-    targetPortId?: string;
-    txId?: string;
-  }): Promise<BoardBootstrap>;
-  /** Remove a connection. The nodes it joined are untouched. */
-  disconnect(input: {
-    baseVersion: number;
-    connectionId: string;
-    txId?: string;
-  }): Promise<BoardBootstrap>;
-  /**
-   * Delete a node together with every relation that names it.
-   *
-   * The server refuses to orphan a relation, so the cascade is explicit and lands
-   * in one transaction: one undo step restores the node and its edges together.
-   * `connections` is the relation set the caller already read, so this stays a
-   * single round-trip.
-   */
-  deleteNodeWithConnections(input: {
-    baseVersion: number;
-    nodeId: string;
-    connections: readonly BoardConnection[];
-    txId?: string;
-  }): Promise<BoardBootstrap>;
   play(command: Omit<Extract<BoardPlaybackCommand, {
     type: "play";
   }>, "shared"> & {
@@ -1593,7 +1528,7 @@ declare class BoardClient {
     type: "stop";
   }>): Promise<BoardPlaybackSnapshot>;
   subscribe(handlers: BoardSubscriptionHandlers): () => void;
-  on(type: "transaction", handler: (event: BoardTransactionAppliedEvent) => void): () => void;
+  on(type: "changed", handler: (event: BoardChangedEvent) => void): () => void;
   on(type: "awareness", handler: (event: BoardAwarenessUpdatedEvent) => void): () => void;
   on(type: "playback", handler: (event: BoardPlaybackChangedEvent) => void): () => void;
 }
@@ -1603,15 +1538,12 @@ declare class SpaceBoardsApi {
   private readonly websocketClient;
   constructor(transport: HttpTransport, spaceId: string, websocketClient: WebsocketClient | null);
   byId(boardId: string): BoardClient;
-  create(input: BoardCreateInput): Promise<BoardBootstrap>;
-  inspect(boardId: string, input?: BoardInspectInput, customFetch?: Fetch): Promise<BoardBootstrap>;
+  create(input: BoardCreateInput): Promise<BoardAuthoringSnapshot>;
+  authoring(boardId: string, input?: BoardAuthoringReadInput, customFetch?: Fetch): Promise<BoardAuthoringSnapshot>;
+  mutateSemantic(boardId: string, mutation: BoardSemanticMutation): Promise<BoardMutationReceipt>;
   summary(boardId: string, customFetch?: Fetch): Promise<BoardSummary>;
   capabilities(boardId: string, customFetch?: Fetch): Promise<BoardCapabilities>;
-  validate(transaction: BoardTransaction): Promise<BoardValidationResult>;
-  apply(transaction: BoardTransaction, options?: {
-    compact?: boolean;
-  }): Promise<BoardBootstrap>;
-  playback(boardId: string, command: BoardPlaybackCommand): Promise<BoardPlaybackSnapshot>;
+  private playback;
   play(boardId: string, command: Omit<Extract<BoardPlaybackCommand, {
     type: "play";
   }>, "shared"> & {
@@ -2258,4 +2190,4 @@ declare class CohubHttpClient {
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { BoardTransactionAppliedEvent as $, ModelsApi as $t, WorkResolveResponse as A, PublicFileUploadEntryInput as An, parseAssistantMessageCommit as At, ReferralsApi as B, ModelStatusEntry as Bn, SearchApi as Bt, WorkPromotionProvider as C, createSlugWorkIdResolver as Cn, GenerationStreamOutOfSyncEvent as Ct, WorkPublicOwnerRecord as D, PublicFileCreateUploadResponse as Dn, GenerationStreamTurnUpdatedEvent as Dt, WorkPromotionStatsResponse as E, PublicFileCreateUploadInput as En, GenerationStreamSubscriptionHandlers as Et, WorkVersionRecord as F, CreateGenerationTaskResponse as Fn, SessionPatchStatus as Ft, WaitForUiCommandOptions as G, PublicAssetUploadProgress as Gt, UserApi as H, CreatePublicAssetUploadResponse as Ht, WorkViewSource as I, GenerationTaskResult as In, createSessionPatchReducer as It, BoardClient as J, UploadChatAttachmentInput as Jt, TasksApi as K, PublicAssetUploadProtocol as Kt, WorkViewStatsResponse as L, GenerationUsageBilling as Ln, SessionAccessApi as Lt, WorkStatus as M, PublicFileUrlResponse as Mn, SessionPatchApplyResult as Mt, WorkTargetType as N, SpaceStartupResponse as Nn, SessionPatchReducer as Nt, WorkPublicSpaceRecord as O, PublicFileListEntry as On, SessionGenerationStreamClient as Ot, WorkUpdateInput as P, CreateGenerationTaskRequest as Pn, SessionPatchState as Pt, BoardSubscriptionHandlers as Q, PromptsApi as Qt, WorkVisibility as R, ListGenerationModelsResponse as Rn, ReferenceResourceSelector as Rt, WorkPromotionEventResponse as S, WorkRuntimeTransport as Sn, GenerationStreamLifecycleEvent as St, WorkPromotionRecord as T, resolveWorkTransport as Tn, GenerationStreamSubscribeOptions as Tt, CreateUiCommandInput as U, PublicAssetMimeType as Ut, UsersApi as V, ModelStatusResponse as Vn, CreatePublicAssetUploadInput as Vt, UiCommandsApi as W, PublicAssetPurpose as Wt, BoardMutationInput as X, UploadPublicAssetInput as Xt, BoardEventName as Y, UploadChatImageAttachmentInput as Yt, BoardPlaybackChangedEvent as Z, SkillsApi as Zt, WorkExtractedPageMeta as _, WorkRuntimeCheckoutState as _n, GenerationStreamCommitEvent as _t, WorkCommerceCreditConsumeResponse as a, HttpError as an, SpaceClient as at, WorkPresentationMeta as b, WorkRuntimeModeConfig as bn, GenerationStreamFinalizedEvent as bt, WorkCommerceEntitlementsResponse as c, RawHttpResponse as cn, SpaceTurnListOptions as ct, WorkCommercePurchaseResponse as d, matchesUnauthorizedErrorToken as dn, BuildSpaceInvitePathInput as dt, GenerationsApi as en, BoardTransactionError as et, WorkAuthorizeResponse as f, sanitizeAccessToken as fn, BuildSpacePathInput as ft, WorkDetailResponse as g, WorkRuntimeApi as gn, AssistantMessageCommit as gt, WorkCreateInput as h, WorkIdResolver as hn, buildSpacePath as ht, WorkCommerceCheckoutStatus as i, Fetch as in, SpaceChannelBindingRecord as it, WorkSessionResponse as j, PublicFileUploadPlanEntry as jn, SessionPatchApplyInput as jt, WorkRecord as k, PublicFileListResponse as kn, createSessionGenerationStreamClient as kt, WorkCommerceOrder as l, UnauthorizedContext as ln, SpacesApi as lt, WorkContentDownload as m, PopupBrokerTransport as mn, buildSpaceInvitePath as mt, createHttpClient as n, ChannelsApi as nn, SessionEventName as nt, WorkCommerceCreditConsumeStatus as o, HttpTraceContext as on, SpaceEventName as ot, WorkContent as p, ParentBridgeTransport as pn, PublicInviteApi as pt, BoardAwarenessUpdatedEvent as q, PublicAssetsApi as qt, WorkCommerceApi as r, CohubClientOptions as rn, SessionSubscriptionHandlers as rt, WorkCommerceEntitlement as s, HttpTransport as sn, SpacePublicFilesApi as st, CohubHttpClient as t, CronJobsApi as tn, BoardTransactionInput as tt, WorkCommerceProductResolveResponse as u, joinApiUrl as un, WebSocketConnectionState as ut, WorkGetResponse as v, WorkRuntimeCheckoutStatus as vn, GenerationStreamErrorEvent as vt, WorkPromotionProviderStatus as w, createWorkRuntime as wn, GenerationStreamStateEvent as wt, WorkPromotionCreateInput as x, WorkRuntimeRequestOptions as xn, GenerationStreamIntermediateMessage as xt, WorkMeta as y, WorkRuntimeContext as yn, GenerationStreamEvent as yt, WorksApi as z, PublicGenerationDeclaration as zn, ReferencesApi as zt };
+export { SessionEventName as $, ChannelsApi as $t, WorkResolveResponse as A, PublicFileUrlResponse as An, SessionPatchReducer as At, ReferralsApi as B, PublicAssetMimeType as Bt, WorkPromotionProvider as C, resolveWorkTransport as Cn, GenerationStreamSubscriptionHandlers as Ct, WorkPublicOwnerRecord as D, PublicFileListResponse as Dn, parseAssistantMessageCommit as Dt, WorkPromotionStatsResponse as E, PublicFileListEntry as En, createSessionGenerationStreamClient as Et, WorkVersionRecord as F, GenerationUsageBilling as Fn, ReferenceResourceSelector as Ft, WaitForUiCommandOptions as G, UploadChatAttachmentInput as Gt, UserApi as H, PublicAssetUploadProgress as Ht, WorkViewSource as I, ListGenerationModelsResponse as In, ReferencesApi as It, BoardChangedEvent as J, SkillsApi as Jt, TasksApi as K, UploadChatImageAttachmentInput as Kt, WorkViewStatsResponse as L, PublicGenerationDeclaration as Ln, SearchApi as Lt, WorkStatus as M, CreateGenerationTaskRequest as Mn, SessionPatchStatus as Mt, WorkTargetType as N, CreateGenerationTaskResponse as Nn, createSessionPatchReducer as Nt, WorkPublicSpaceRecord as O, PublicFileUploadEntryInput as On, SessionPatchApplyInput as Ot, WorkUpdateInput as P, GenerationTaskResult as Pn, SessionAccessApi as Pt, BoardSubscriptionHandlers as Q, CronJobsApi as Qt, WorkVisibility as R, ModelStatusEntry as Rn, CreatePublicAssetUploadInput as Rt, WorkPromotionEventResponse as S, createWorkRuntime as Sn, GenerationStreamSubscribeOptions as St, WorkPromotionRecord as T, PublicFileCreateUploadResponse as Tn, SessionGenerationStreamClient as Tt, CreateUiCommandInput as U, PublicAssetUploadProtocol as Ut, UsersApi as V, PublicAssetPurpose as Vt, UiCommandsApi as W, PublicAssetsApi as Wt, BoardEventName as X, ModelsApi as Xt, BoardClient as Y, PromptsApi as Yt, BoardPlaybackChangedEvent as Z, GenerationsApi as Zt, WorkExtractedPageMeta as _, WorkRuntimeInvocationContext as _n, GenerationStreamFinalizedEvent as _t, WorkCommerceCreditConsumeResponse as a, RawHttpResponse as an, SpaceTurnListOptions as at, WorkPresentationMeta as b, WorkRuntimeTransport as bn, GenerationStreamOutOfSyncEvent as bt, WorkCommerceEntitlementsResponse as c, matchesUnauthorizedErrorToken as cn, BuildSpaceInvitePathInput as ct, WorkCommercePurchaseResponse as d, PopupBrokerTransport as dn, buildSpaceInvitePath as dt, CohubClientOptions as en, SessionSubscriptionHandlers as et, WorkAuthorizeResponse as f, WorkIdResolver as fn, buildSpacePath as ft, WorkDetailResponse as g, WorkRuntimeContext as gn, GenerationStreamEvent as gt, WorkCreateInput as h, WorkRuntimeCheckoutStatus as hn, GenerationStreamErrorEvent as ht, WorkCommerceCheckoutStatus as i, HttpTransport as in, SpacePublicFilesApi as it, WorkSessionResponse as j, SpaceStartupResponse as jn, SessionPatchState as jt, WorkRecord as k, PublicFileUploadPlanEntry as kn, SessionPatchApplyResult as kt, WorkCommerceOrder as l, sanitizeAccessToken as ln, BuildSpacePathInput as lt, WorkContentDownload as m, WorkRuntimeCheckoutState as mn, GenerationStreamCommitEvent as mt, createHttpClient as n, HttpError as nn, SpaceClient as nt, WorkCommerceCreditConsumeStatus as o, UnauthorizedContext as on, SpacesApi as ot, WorkContent as p, WorkRuntimeApi as pn, AssistantMessageCommit as pt, BoardAwarenessUpdatedEvent as q, UploadPublicAssetInput as qt, WorkCommerceApi as r, HttpTraceContext as rn, SpaceEventName as rt, WorkCommerceEntitlement as s, joinApiUrl as sn, WebSocketConnectionState as st, CohubHttpClient as t, Fetch as tn, SpaceChannelBindingRecord as tt, WorkCommerceProductResolveResponse as u, ParentBridgeTransport as un, PublicInviteApi as ut, WorkGetResponse as v, WorkRuntimeModeConfig as vn, GenerationStreamIntermediateMessage as vt, WorkPromotionProviderStatus as w, PublicFileCreateUploadInput as wn, GenerationStreamTurnUpdatedEvent as wt, WorkPromotionCreateInput as x, createSlugWorkIdResolver as xn, GenerationStreamStateEvent as xt, WorkMeta as y, WorkRuntimeRequestOptions as yn, GenerationStreamLifecycleEvent as yt, WorksApi as z, ModelStatusResponse as zn, CreatePublicAssetUploadResponse as zt };