@neta-art/cohub 5.3.3 → 5.4.0

package/dist/board/render/connection-layer.js

@@ -0,0 +1,223 @@
+import { BOARD_FONT_STACK } from "../../protocol/dist/board-constants.js";
+import { connectionArrowheads, resolveConnection } from "../core/connections.js";
+import { pickBoardColor } from "../core/palette.js";
+import { syncTextResolution, textResolutionForZoom } from "./text-resolution.js";
+import { Container, Graphics, Text } from "pixi.js";
+//#region src/board/render/connection-layer.ts
+/**
+* Connection drawing.
+*
+* Connections render into one shared layer beneath the cards rather than as a
+* container per relation. A connection is a thin stroke with no texture and no
+* interactive chrome of its own, so a per-connection container would add a
+* transform, a render group and a draw call each for geometry that batches
+* perfectly — on a densely connected board that is the difference between a few
+* draw calls and a few thousand.
+*
+* Labels are the exception: text needs its own object to rasterise, so a `Text`
+* is materialised only for connections that actually carry one and is pooled by
+* connection id.
+*/
+/** Arrowhead length relative to stroke width, and its floor in world units. */
+const HEAD_SCALE = 5.5;
+const HEAD_MIN = 11;
+const HEAD_SPREAD = Math.PI / 6;
+/** Dash pattern for `dashed` connections, in world units. */
+const DASH_LENGTH = 10;
+const DASH_GAP = 7;
+/** Draw an open chevron arrowhead aimed along `angle`. */
+function drawArrowhead(graphics, tip, angle, size, color, width, alpha) {
+	graphics.moveTo(tip.x - size * Math.cos(angle - HEAD_SPREAD), tip.y - size * Math.sin(angle - HEAD_SPREAD)).lineTo(tip.x, tip.y).lineTo(tip.x - size * Math.cos(angle + HEAD_SPREAD), tip.y - size * Math.sin(angle + HEAD_SPREAD)).stroke({
+		color,
+		width,
+		alpha,
+		cap: "round",
+		join: "round"
+	});
+}
+/** Trace a polyline as a dashed path, walking segment by segment. */
+function traceDashed(graphics, path) {
+	let penDown = true;
+	let remaining = DASH_LENGTH;
+	let current = path[0];
+	if (!current) return;
+	graphics.moveTo(current.x, current.y);
+	for (let index = 1; index < path.length; index += 1) {
+		const next = path[index];
+		if (!next) continue;
+		let segmentRemaining = Math.hypot(next.x - current.x, next.y - current.y);
+		let from = current;
+		while (segmentRemaining > 1e-4) {
+			const step = Math.min(segmentRemaining, remaining);
+			const ratio = step / segmentRemaining;
+			const to = {
+				x: from.x + (next.x - from.x) * ratio,
+				y: from.y + (next.y - from.y) * ratio
+			};
+			if (penDown) graphics.lineTo(to.x, to.y);
+			else graphics.moveTo(to.x, to.y);
+			remaining -= step;
+			segmentRemaining -= step;
+			from = to;
+			if (remaining <= 1e-4) {
+				penDown = !penDown;
+				remaining = penDown ? DASH_LENGTH : DASH_GAP;
+			}
+		}
+		current = next;
+	}
+}
+function createConnectionLayer(options) {
+	let graphics = null;
+	let labelLayer = null;
+	const labels = /* @__PURE__ */ new Map();
+	let resolvedById = /* @__PURE__ */ new Map();
+	function ensureAttached() {
+		if (graphics && labelLayer) return {
+			graphics,
+			labelLayer
+		};
+		const nextGraphics = new Graphics({ label: "board-connections" });
+		const nextLabels = new Container({ label: "board-connection-labels" });
+		if (options.zIndex !== void 0) {
+			nextGraphics.zIndex = options.zIndex;
+			nextLabels.zIndex = options.zIndex;
+		}
+		options.parent.addChild(nextGraphics, nextLabels);
+		graphics = nextGraphics;
+		labelLayer = nextLabels;
+		return {
+			graphics: nextGraphics,
+			labelLayer: nextLabels
+		};
+	}
+	function releaseLabel(connectionId) {
+		const entry = labels.get(connectionId);
+		if (!entry) return;
+		labelLayer?.removeChild(entry.text);
+		entry.text.destroy();
+		labels.delete(connectionId);
+	}
+	function syncLabel(connection, resolved, input, color, host) {
+		const value = connection.label.trim();
+		if (!value) {
+			releaseLabel(connection.id);
+			return;
+		}
+		let entry = labels.get(connection.id);
+		if (!entry) {
+			const resolution = textResolutionForZoom(input.zoom);
+			const text = new Text({
+				text: value,
+				style: {
+					fill: color,
+					fontFamily: BOARD_FONT_STACK,
+					fontSize: 12,
+					fontWeight: "500"
+				},
+				resolution,
+				roundPixels: true
+			});
+			text.anchor.set(.5);
+			host.addChild(text);
+			entry = {
+				text,
+				resolution,
+				sig: ""
+			};
+			labels.set(connection.id, entry);
+		}
+		syncTextResolution(entry.text, entry, input.zoom);
+		const sig = `${value}|${color}`;
+		if (sig !== entry.sig) {
+			entry.sig = sig;
+			entry.text.text = value;
+			entry.text.style.fill = color;
+		}
+		entry.text.position.set(resolved.mid.x, resolved.mid.y);
+	}
+	function sync(input) {
+		if (input.connections.length === 0 && !graphics) {
+			resolvedById = /* @__PURE__ */ new Map();
+			return;
+		}
+		const host = ensureAttached();
+		host.graphics.clear();
+		const next = /* @__PURE__ */ new Map();
+		const selected = input.selectedIds ?? /* @__PURE__ */ new Set();
+		const skip = input.skipIds;
+		const minWidth = 1 / Math.max(input.zoom, 1e-4);
+		for (const connection of input.connections) {
+			const resolved = resolveConnection(connection, input.getFrame);
+			if (!resolved) continue;
+			next.set(connection.id, resolved);
+			if (skip?.has(connection.id)) {
+				releaseLabel(connection.id);
+				continue;
+			}
+			const isSelected = selected.has(connection.id);
+			const isHovered = input.hoveredId === connection.id;
+			const color = pickBoardColor(input.colors, connection.style.color, input.colorScheme);
+			const width = Math.max(connection.style.size + (isSelected ? 1 : 0), minWidth);
+			const alpha = isSelected || isHovered ? 1 : .9;
+			if (connection.style.line === "dashed") traceDashed(host.graphics, resolved.path);
+			else {
+				const first = resolved.path[0];
+				if (!first) continue;
+				host.graphics.moveTo(first.x, first.y);
+				for (let index = 1; index < resolved.path.length; index += 1) {
+					const point = resolved.path[index];
+					if (point) host.graphics.lineTo(point.x, point.y);
+				}
+			}
+			host.graphics.stroke({
+				color: color.stroke,
+				width,
+				alpha,
+				cap: "round",
+				join: "round"
+			});
+			const heads = connectionArrowheads(connection);
+			const headSize = Math.max(HEAD_MIN, connection.style.size * HEAD_SCALE);
+			if (heads.atTarget) {
+				const tip = resolved.path[resolved.path.length - 1];
+				const previous = resolved.path[resolved.path.length - 2];
+				if (tip && previous) drawArrowhead(host.graphics, tip, Math.atan2(tip.y - previous.y, tip.x - previous.x), headSize, color.stroke, width, alpha);
+			}
+			if (heads.atSource) {
+				const tip = resolved.path[0];
+				const next2 = resolved.path[1];
+				if (tip && next2) drawArrowhead(host.graphics, tip, Math.atan2(tip.y - next2.y, tip.x - next2.x), headSize, color.stroke, width, alpha);
+			}
+			syncLabel(connection, resolved, input, color.label, host.labelLayer);
+		}
+		for (const connectionId of [...labels.keys()]) if (!next.has(connectionId)) releaseLabel(connectionId);
+		resolvedById = next;
+	}
+	return {
+		sync,
+		resolved: (connectionId) => resolvedById.get(connectionId) ?? null,
+		get children() {
+			const list = [];
+			if (graphics) list.push(graphics);
+			if (labelLayer) list.push(labelLayer);
+			return list;
+		},
+		destroy: () => {
+			for (const entry of labels.values()) entry.text.destroy();
+			labels.clear();
+			graphics?.destroy();
+			labelLayer?.destroy({ children: true });
+			graphics = null;
+			labelLayer = null;
+			resolvedById = /* @__PURE__ */ new Map();
+		}
+	};
+}
+/** Frame lookup over a plain item list, for hosts without an index. */
+function framesFromItems(items) {
+	const frames = new Map(items.map((item) => [item.id, item.frame]));
+	return (id) => frames.get(id);
+}
+//#endregion
+export { createConnectionLayer, framesFromItems };

package/dist/board/render/index.d.ts

@@ -1,6 +1,7 @@
+import { ConnectionLayer, ConnectionRenderInput, createConnectionLayer, framesFromItems } from "./connection-layer.js";
 import { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { defaultBoardPalette } from "./palette.js";
 import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { BoardThemeContext, BoardThemeRenderer, getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
-export { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, boardCardRenderersForTest, defaultBoardPalette, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };
+export { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, ConnectionLayer, ConnectionRenderInput, boardCardRenderersForTest, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };

package/dist/board/render/index.js

@@ -1,6 +1,7 @@
+import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
+import { createConnectionLayer, framesFromItems } from "./connection-layer.js";
 import { defaultBoardPalette } from "./palette.js";
 import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
-import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
-export { boardCardRenderersForTest, defaultBoardPalette, ensureBoardTextMeasurement, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };
+export { boardCardRenderersForTest, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };

package/dist/board/render/renderers/arrow-card-renderer.js

@@ -1,21 +1,11 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
-import { resolveArrow, sampleQuadratic } from "../../core/bindings.js";
+import { resolveArrow, sampleArrow } from "../../core/arrow-geometry.js";
 import { pickBoardColor } from "../../core/palette.js";
 import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
 import { drawFarStroke } from "./far-plate.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/arrow-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();
-/**
-* Frame lookup for resolving bindings.
-*
-* Routed through the context's id index rather than scanning the document: an
-* arrow re-resolves its endpoints on every sync, and a per-arrow O(items) scan
-* would make a board with many arrows quadratic per frame.
-*/
-function frameLookup(context) {
-	return (id) => context.getItem(id)?.frame;
-}
 /** Open chevron arrowhead — clearly directional, not a tiny filled nub. */
 function drawArrowhead(graphics, tip, angle, size, color, strokeWidth) {
 	const spread = Math.PI / 6;
@@ -44,8 +34,8 @@ function sync(container, item, context) {
 	const hovered = context.hoveredId === item.id;
 	const color = pickBoardColor(context.colors, item.color, context.colorScheme);
 	syncTextResolution(parts.label, parts, context.zoom);
-	const resolved = resolveArrow(item, frameLookup(context));
-	const lineSig = resolved ? [
+	const resolved = resolveArrow(item);
+	const lineSig = [
 		resolved.start.x,
 		resolved.start.y,
 		resolved.end.x,
@@ -58,39 +48,37 @@ function sync(container, item, context) {
 		item.size,
 		item.arrowStart,
 		item.arrowEnd
-	].join("|") : `empty|${item.id}`;
+	].join("|");
 	if (lineSig !== parts.lineSig) {
 		parts.lineSig = lineSig;
 		parts.line.clear();
-		if (resolved) {
-			const strokeColor = color.stroke;
-			const width = selected ? item.size + 1 : item.size;
-			const samples = sampleQuadratic(resolved, 24);
-			const head = samples[0];
-			const tail = samples[samples.length - 1];
-			if (head && tail) {
-				parts.line.moveTo(head.x, head.y);
-				for (let i = 1; i < samples.length; i += 1) {
-					const point = samples[i];
-					if (point) parts.line.lineTo(point.x, point.y);
-				}
-				parts.line.stroke({
-					color: strokeColor,
-					width,
-					alpha: selected || hovered ? 1 : .92,
-					cap: "round",
-					join: "round"
-				});
-				const span = Math.hypot(tail.x - head.x, tail.y - head.y);
-				const headSize = Math.min(Math.max(14, item.size * 5.5), Math.max(10, span * .28));
-				if (item.arrowEnd) {
-					const prev = samples[samples.length - 2];
-					if (prev) drawArrowhead(parts.line, tail, Math.atan2(tail.y - prev.y, tail.x - prev.x), headSize, strokeColor, width);
-				}
-				if (item.arrowStart) {
-					const next = samples[1];
-					if (next) drawArrowhead(parts.line, head, Math.atan2(head.y - next.y, head.x - next.x), headSize, strokeColor, width);
-				}
+		const strokeColor = color.stroke;
+		const width = selected ? item.size + 1 : item.size;
+		const samples = sampleArrow(resolved, 24);
+		const head = samples[0];
+		const tail = samples[samples.length - 1];
+		if (head && tail) {
+			parts.line.moveTo(head.x, head.y);
+			for (let i = 1; i < samples.length; i += 1) {
+				const point = samples[i];
+				if (point) parts.line.lineTo(point.x, point.y);
+			}
+			parts.line.stroke({
+				color: strokeColor,
+				width,
+				alpha: selected || hovered ? 1 : .92,
+				cap: "round",
+				join: "round"
+			});
+			const span = Math.hypot(tail.x - head.x, tail.y - head.y);
+			const headSize = Math.min(Math.max(14, item.size * 5.5), Math.max(10, span * .28));
+			if (item.arrowEnd) {
+				const prev = samples[samples.length - 2];
+				if (prev) drawArrowhead(parts.line, tail, Math.atan2(tail.y - prev.y, tail.x - prev.x), headSize, strokeColor, width);
+			}
+			if (item.arrowStart) {
+				const next = samples[1];
+				if (next) drawArrowhead(parts.line, head, Math.atan2(head.y - next.y, head.x - next.x), headSize, strokeColor, width);
 			}
 		}
 	}
@@ -100,8 +88,8 @@ function sync(container, item, context) {
 		parts.label.text = item.label;
 		parts.label.style.fill = color.label;
 	}
-	parts.label.visible = Boolean(resolved && item.label.length > 0);
-	if (resolved) parts.label.position.copyFrom(resolved.control);
+	parts.label.visible = item.label.length > 0;
+	parts.label.position.copyFrom(resolved.control);
 }
 const arrowCardRenderer = {
 	id: "arrow-card",
@@ -139,10 +127,9 @@ const arrowCardRenderer = {
 	},
 	renderFar: (graphics, item, context) => {
 		if (item.type !== "arrow") return;
-		const resolved = resolveArrow(item, frameLookup(context));
-		if (!resolved) return;
+		const resolved = resolveArrow(item);
 		const color = pickBoardColor(context.colors, item.color, context.colorScheme);
-		drawFarStroke(graphics, sampleQuadratic(resolved, 12), {
+		drawFarStroke(graphics, sampleArrow(resolved, 12), {
 			color: color.stroke,
 			width: item.size,
 			alpha: .85

package/dist/chunks/http.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateSpacePromptInput, $n as SpaceFsTreeResponse, Ai as WorkContentKind, Ar as SpaceUsageResponse, At as Permission, Ba as ContentBlock, Bi as UiCommandError, Br as ChannelHealth, Bt as ReferenceAggregateGroupBy, Ca as MessageRecord, Ci as BoardAwarenessUpdate, Cn as SpaceCommerceBenefit, Ct as LabelResourceType, Da as SessionTurnRecord, Dn as SpaceCommerceOrder, Dt as ModelCatalogEntry, Er as SpaceTurnAuthorFilter, Et as MeResponse, Fn as SpaceCreateResponse, Fr as UserRulesResponse, Ft as PublicUserPageResponse, Gt as ReferenceQueryableType, Hi as UiCommandStatus, Hn as SpaceFsCreateUploadResponse, Ht as ReferenceDirection, Ia as SpaceCompletionResult, In as SpaceDefaultResponse, J as ClaimReferralResponse, Jn as SpaceFsMoveInput, Jt as ReferralDashboard, K as CheckpointDiffSummary, La as SpaceCompletionStreamEvent, Ln as SpaceEnvInput, Mn as SpaceConfigInput, Mr as TaskRunDetailResponse, Nn as SpaceConfigResponse, Nr as TaskRunRecord, Nt as PromptTemplateCatalogResponse, Oa as SpaceTurnsResponse, On as SpaceCommerceProduct, Ot as PatchResourceLabelsInput, Pa as CreateSpaceCompletionInput, Pn as SpaceConfigUpdateResponse, Pr as UserProfile, Pt as PublicReferral, Qi as BoardCapabilities, Qn as SpaceFsReadFilesResponse, R as Channel, Ra as Usage, Ri as UiCommand, Rn as SpaceFsCompleteUploadInput, Rr as UserSessionsResponse, Sa as SpacePublicEndpoints, Sn as SpaceCheckpointDetailResponse, Tr as SpaceSessionsResponse, Ut as ReferenceKind, V as CheckpointDiffFileResponse, Vi as UiCommandRecord, Vn as SpaceFsCreateUploadInput, Vt as ReferenceAggregateResponse, Wa as RequestSource, Wt as ReferenceQueryResponse, X as CreateInvitationResponse, Y as CreateInvitationInput, Yn as SpaceFsPreparingFile, Z as CreateSpaceInput, Zi as BoardBootstrap, _a as BoardTransaction, _r as SpacePresenceSnapshot, a as WebsocketClientOptions, 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 BoardCreateInput, et as CreateSpacePromptResponse, fr as SpaceMember, ft as InvitationDetail, gn as SpaceAccessPolicy, gr as SpacePendingDiffSummary, hr as SpacePendingDiffFileResponse, ia as BoardInspectInput, ii as GenerationModelDeclaration, in as SessionMessagesResponse, it as CronJobUpdatePatch, kn as SpaceCommerceProductBenefitBinding, kt as PatchResourceLabelsResponse, l as AcceptInvitationResponse, ln as SessionTurnStreamSnapshotResponse, lr as SpaceInvitationListResponse, lt as GlobalSearchResponse, mr as SpaceModListItem, nn as SessionMessageResponse, oi as BoardAwarenessUpdatedEvent$1, on as SessionTurnIndexResponse, or as SpaceFsUploadResponse, pa as BoardPlaybackSnapshot, 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, tt as CreateSpaceSessionInput, ua as BoardPlaybackCommand, un as SessionTurnWindowResponse, va as BoardValidationResult, vi as SessionTurnPatchEvent, vt as LabelAssignmentRecord, wa as SessionForkRecord, wi as WorkArtifactDescriptor, wn as SpaceCommerceBuyerProfile, xr as SpaceRole, xt as LabelListItem, yr as SpacePublicProfile, yt as LabelItemsResponse, za as BillingPayload, zn as SpaceFsCompleteUploadResponse, zr as ChannelConfig } from "./websocket.js";
+import { $ as CreateSpacePromptInput, $n as SpaceFsTreeResponse, Aa as SessionTurnRecord, Ai as WorkContentKind, Ar as SpaceUsageResponse, At as Permission, Ba as SpaceCompletionStreamEvent, Bi as UiCommandError, Br as ChannelHealth, Bt as ReferenceAggregateGroupBy, Ci as BoardAwarenessUpdate, Cn as SpaceCommerceBenefit, Ct as LabelResourceType, Da as SessionForkRecord, Dn as SpaceCommerceOrder, Dt as ModelCatalogEntry, Ea as MessageRecord, Er as SpaceTurnAuthorFilter, Et as MeResponse, Fn as SpaceCreateResponse, Fr as UserRulesResponse, Ft as PublicUserPageResponse, Gt as ReferenceQueryableType, Ha as BillingPayload, Hi as UiCommandStatus, Hn as SpaceFsCreateUploadResponse, Ht as ReferenceDirection, In as SpaceDefaultResponse, J as ClaimReferralResponse, Jn as SpaceFsMoveInput, Jt as ReferralDashboard, K as CheckpointDiffSummary, La as CreateSpaceCompletionInput, Ln as SpaceEnvInput, 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, Qi as BoardCapabilities, Qn as SpaceFsReadFilesResponse, R as Channel, Ri as UiCommand, Rn as SpaceFsCompleteUploadInput, Rr as UserSessionsResponse, Sa as BoardConnectionRecord, Sn as SpaceCheckpointDetailResponse, Ta as SpacePublicEndpoints, Tr as SpaceSessionsResponse, Ua as ContentBlock, Ut as ReferenceKind, V as CheckpointDiffFileResponse, Va as Usage, Vi as UiCommandRecord, Vn as SpaceFsCreateUploadInput, Vt as ReferenceAggregateResponse, Wt as ReferenceQueryResponse, X as CreateInvitationResponse, Y as CreateInvitationInput, Yn as SpaceFsPreparingFile, Z as CreateSpaceInput, Zi as BoardBootstrap, _a as BoardTransaction, _r as SpacePresenceSnapshot, a as WebsocketClientOptions, an as SessionRecord, at as CursorPageInfo, ba as BoardConnection, br as SpaceRecord, ci as BoardTransactionAppliedEvent$1, cn as SessionTurnSignedUrlsResponse, d as BatchUserProfilesResponse, di as RealtimePatchOperation, dn as SessionTurnsPaginatedResponse, dt as GlobalSearchType, ea as BoardCreateInput, et as CreateSpacePromptResponse, fr as SpaceMember, ft as InvitationDetail, gn as SpaceAccessPolicy, gr as SpacePendingDiffSummary, hr as SpacePendingDiffFileResponse, ia as BoardInspectInput, ii as GenerationModelDeclaration, in as SessionMessagesResponse, it as CronJobUpdatePatch, ja as SpaceTurnsResponse, kn as SpaceCommerceProductBenefitBinding, kt as PatchResourceLabelsResponse, l as AcceptInvitationResponse, ln as SessionTurnStreamSnapshotResponse, lr as SpaceInvitationListResponse, lt as GlobalSearchResponse, mr as SpaceModListItem, nn as SessionMessageResponse, oi as BoardAwarenessUpdatedEvent$1, on as SessionTurnIndexResponse, or as SpaceFsUploadResponse, pa as BoardPlaybackSnapshot, pn as SkillCatalogResponse, q as CheckpointRecord, qa as RequestSource, 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, tt as CreateSpaceSessionInput, ua as BoardPlaybackCommand, un as SessionTurnWindowResponse, va as BoardValidationResult, vi as SessionTurnPatchEvent, vt as LabelAssignmentRecord, wi as WorkArtifactDescriptor, wn as SpaceCommerceBuyerProfile, xa as BoardConnectionDirection, xr as SpaceRole, xt as LabelListItem, yr as SpacePublicProfile, yt as LabelItemsResponse, za as SpaceCompletionResult, 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
@@ -1445,6 +1445,58 @@ declare class BoardClient {
   apply(transaction: BoardTransactionInput): Promise<BoardBootstrap>;
   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;
+    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"> & {