@neta-art/cohub 6.0.0 → 8.0.0

package/dist/chunks/http.js

@@ -1,4 +1,4 @@
-import { D as getRealtimeBoardRoom, O as getRealtimeSpaceRoom, n as HttpTransport, t as HttpError, y as isUuid } from "./transport.js";
+import { D as getRealtimeSpaceRoom, E as getRealtimeBoardRoom, n as HttpTransport, t as HttpError, y as isUuid } from "./transport.js";
 import { a as resolveApiBaseUrl } from "./environment.js";
 import { z } from "zod";
 //#region src/apis/channels.ts
@@ -467,10 +467,6 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 const BOARD_BUILTIN_EFFECT_KINDS = ["effects.pulse", "effects.float"];
 const BOARD_ARROW_STROKE_SIZE = 2.5;
 const BOARD_CONNECTION_STROKE_SIZE = 2.5;
-function clampBoardStrokeSize(size) {
-	if (!Number.isFinite(size)) return BOARD_CONNECTION_STROKE_SIZE;
-	return Math.min(64, Math.max(1, size));
-}
 function clipSchema(id) {
 	switch (id) {
 		case "motion.path": return { params: { points: {
@@ -546,12 +542,11 @@ const BoardConnectionAnchorSchema = z.union([
 		ny: z.number().finite().min(0).max(1)
 	})
 ]);
-const AUTO_BOARD_CONNECTION_ANCHOR = { kind: "auto" };
 const BoardConnectionEndpointSchema = z.object({
-	nodeId: z.string().min(1).max(160),
+	itemId: z.string().min(1).max(160),
 	/** Optional semantic port. Older connections omit it and remain valid. */
 	portId: z.string().min(1).max(120).optional(),
-	anchor: BoardConnectionAnchorSchema.default(AUTO_BOARD_CONNECTION_ANCHOR)
+	anchor: BoardConnectionAnchorSchema.default({ kind: "auto" })
 });
 /**
 * Which ends carry an arrowhead.
@@ -626,50 +621,18 @@ const BoardConnectionSchema = z.object({
 	routing: BoardConnectionRoutingSchema.default(DEFAULT_BOARD_CONNECTION_ROUTING),
 	style: BoardConnectionStyleSchema.default(DEFAULT_BOARD_CONNECTION_STYLE),
 	metadata: z.record(z.string(), z.unknown()).default({})
-});
-BoardConnectionSchema.omit({ id: true }).partial();
-function normalizeBoardConnectionStyle(style) {
-	return {
-		color: style?.color?.trim() || DEFAULT_BOARD_CONNECTION_STYLE.color,
-		size: clampBoardStrokeSize(typeof style?.size === "number" && Number.isFinite(style.size) ? style.size : DEFAULT_BOARD_CONNECTION_STYLE.size),
-		line: style?.line ?? DEFAULT_BOARD_CONNECTION_STYLE.line
-	};
-}
+}).strict();
 /**
-* Build a connection with every default filled in.
+* A patch to an existing connection.
 *
-* Callers only state what they mean (which nodes, and optionally the relation),
-* so a connection created by the editor, an agent or the CLI is byte-identical
-* for the same intent.
+* `id` is excluded: a connection's identity never changes, and re-pointing both
+* endpoints is an edit of the same relation, not a new one.
 */
-function createBoardConnection(input) {
-	return {
-		id: input.id,
-		source: {
-			nodeId: input.sourceNodeId,
-			...input.sourcePortId ? { portId: input.sourcePortId } : {},
-			anchor: input.sourceAnchor ?? AUTO_BOARD_CONNECTION_ANCHOR
-		},
-		target: {
-			nodeId: input.targetNodeId,
-			...input.targetPortId ? { portId: input.targetPortId } : {},
-			anchor: input.targetAnchor ?? AUTO_BOARD_CONNECTION_ANCHOR
-		},
-		relation: input.relation ?? "related",
-		direction: input.direction ?? "forward",
-		label: input.label ?? "",
-		routing: {
-			...DEFAULT_BOARD_CONNECTION_ROUTING,
-			...input.routing
-		},
-		style: normalizeBoardConnectionStyle(input.style),
-		metadata: input.metadata ?? {}
-	};
-}
+const BoardConnectionPatchSchema = BoardConnectionSchema.omit({ id: true }).partial();
 //#endregion
 //#region ../protocol/dist/board-composition.js
-const idSchema$3 = z.string().min(1).max(160);
-const finiteSchema$3 = z.number().finite();
+const idSchema$2 = z.string().min(1).max(160);
+const finiteSchema$1 = z.number().finite();
 const jsonObjectSchema$2 = z.record(z.string(), z.unknown());
 const BoardEasingSchema = z.enum([
 	"linear",
@@ -685,22 +648,22 @@ const BoardEasingSchema = z.enum([
 const BoardAnimationTargetSchema = z.discriminatedUnion("type", [
 	z.object({
 		type: z.literal("item"),
-		itemId: idSchema$3
+		itemId: idSchema$2
 	}).strict(),
 	z.object({
 		type: z.literal("effect"),
-		effectId: idSchema$3
+		effectId: idSchema$2
 	}).strict(),
 	z.object({ type: z.literal("camera") }).strict(),
 	z.object({ type: z.literal("board") }).strict()
 ]);
 const vector2Schema = z.object({
-	x: finiteSchema$3,
-	y: finiteSchema$3
+	x: finiteSchema$1,
+	y: finiteSchema$1
 }).strict();
-const scaleSchema = z.union([finiteSchema$3.positive(), z.object({
-	x: finiteSchema$3.positive(),
-	y: finiteSchema$3.positive()
+const scaleSchema = z.union([finiteSchema$1.positive(), z.object({
+	x: finiteSchema$1.positive(),
+	y: finiteSchema$1.positive()
 }).strict()]);
 const BOARD_ANIMATION_CHANNELS = {
 	"transform.translation": {
@@ -712,7 +675,7 @@ const BOARD_ANIMATION_CHANNELS = {
 	},
 	"transform.rotation": {
 		targets: ["item"],
-		value: finiteSchema$3,
+		value: finiteSchema$1,
 		interpolations: ["linear", "step"],
 		unit: "radian"
 	},
@@ -724,18 +687,18 @@ const BOARD_ANIMATION_CHANNELS = {
 	},
 	"style.opacity": {
 		targets: ["item"],
-		value: finiteSchema$3.min(0).max(1),
+		value: finiteSchema$1.min(0).max(1),
 		interpolations: ["linear", "step"],
 		unit: "ratio"
 	}
 };
 const BoardTrackKeyframeSchema = z.object({
-	time: finiteSchema$3.nonnegative(),
+	time: finiteSchema$1.nonnegative(),
 	value: z.unknown(),
 	easing: BoardEasingSchema.optional()
 }).strict();
 const BoardTrackSchema = z.object({
-	id: idSchema$3,
+	id: idSchema$2,
 	target: BoardAnimationTargetSchema,
 	channel: z.string().min(1).max(160),
 	channelVersion: z.number().int().positive().default(1),
@@ -796,12 +759,12 @@ const BoardTrackSchema = z.object({
 });
 const extensionKindSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
 const BoardProceduralClipSchema = z.object({
-	id: idSchema$3,
+	id: idSchema$2,
 	kind: extensionKindSchema,
 	kindVersion: z.number().int().positive(),
 	target: BoardAnimationTargetSchema,
-	start: finiteSchema$3.nonnegative(),
-	duration: finiteSchema$3.positive(),
+	start: finiteSchema$1.nonnegative(),
+	duration: finiteSchema$1.positive(),
 	layer: z.enum([
 		"behind",
 		"content",
@@ -821,17 +784,17 @@ const BoardProceduralClipSchema = z.object({
 		ref: z.string().min(1).max(4096),
 		digest: z.string().min(16).max(160).optional()
 	}).strict()).default([]),
-	seed: idSchema$3,
+	seed: idSchema$2,
 	metadata: jsonObjectSchema$2.default({})
 }).strict();
 const BoardTimelineMarkerSchema = z.object({
-	id: idSchema$3,
-	time: finiteSchema$3.nonnegative(),
-	duration: finiteSchema$3.nonnegative().optional(),
+	id: idSchema$2,
+	time: finiteSchema$1.nonnegative(),
+	duration: finiteSchema$1.nonnegative().optional(),
 	metadata: jsonObjectSchema$2.default({})
 }).strict();
 const BoardTimelineSchema = z.object({
-	duration: finiteSchema$3.nonnegative(),
+	duration: finiteSchema$1.nonnegative(),
 	tracks: z.array(BoardTrackSchema).max(5e4).default([]),
 	clips: z.array(BoardProceduralClipSchema).max(5e4).default([]),
 	markers: z.array(BoardTimelineMarkerSchema).max(1e4).default([])
@@ -919,16 +882,16 @@ const BoardCompositionPlaybackSchema = z.object({
 		z.object({ mode: z.literal("base") }).strict(),
 		z.object({
 			mode: z.literal("time"),
-			time: finiteSchema$3.nonnegative()
+			time: finiteSchema$1.nonnegative()
 		}).strict(),
 		z.object({
 			mode: z.literal("marker"),
-			markerId: idSchema$3
+			markerId: idSchema$2
 		}).strict()
 	]).default({ mode: "base" })
 }).strict();
 const compositionFields = {
-	id: idSchema$3,
+	id: idSchema$2,
 	name: z.string().min(1).max(255),
 	timeline: BoardTimelineSchema,
 	playback: BoardCompositionPlaybackSchema.default({
@@ -964,11 +927,23 @@ const BoardCompositionSchema = z.object({
 	...compositionFields,
 	revision: z.number().int().nonnegative().default(0)
 }).strict().superRefine(validateCompositionFallback);
-/** Accept inspect/get output as apply input while stripping server-owned revision. */
+/**
+* Accept inspect/get output as apply input while stripping server-owned
+* `revision`. Anything else that looks server-owned (or simply unknown) fails
+* with a pointer at the offending key, so a get → edit → apply round-trip that
+* accidentally carries runtime fields names the culprit instead of a bare
+* "Unrecognized key".
+*/
 function parseBoardCompositionInput(value) {
 	if (value && typeof value === "object" && !Array.isArray(value)) {
 		const { revision: _revision, ...input } = value;
-		return BoardCompositionInputSchema.parse(input);
+		const result = BoardCompositionInputSchema.safeParse(input);
+		if (!result.success) {
+			const issue = result.error.issues.find((item) => item.code === "unrecognized_keys");
+			if (issue) throw new Error(`unknown field in composition input: ${issue.message}. Server-owned fields such as revision are stripped automatically; remove other fields not part of the composition schema`);
+			throw result.error;
+		}
+		return result.data;
 	}
 	return BoardCompositionInputSchema.parse(value);
 }
@@ -982,8 +957,67 @@ const BOARD_ANIMATION_CHANNEL_CAPABILITIES = Object.entries(BOARD_ANIMATION_CHAN
 	valueSchema: z.toJSONSchema(definition.value)
 }));
 //#endregion
+//#region ../protocol/dist/board-effect.js
+/**
+* Board effect schema, isolated so `board-authoring.ts` can reuse the exact
+* definition without a runtime cycle through `board.ts`. One definition, one
+* strictness level — semantic mutations and Board create must not drift apart.
+*/
+const idSchema$1 = z.string().min(1).max(160);
+const extensionIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
+const jsonObjectSchema$1 = z.record(z.string(), z.unknown());
+const BoardAssetRefSchema = z.object({
+	type: z.enum(["space-file", "extension"]),
+	ref: z.string().min(1).max(4096),
+	digest: z.string().min(16).max(160).optional()
+}).strict();
+const BoardEffectSchema = z.object({
+	id: idSchema$1,
+	boardId: z.string().uuid(),
+	target: z.discriminatedUnion("type", [z.object({
+		type: z.literal("item"),
+		itemId: idSchema$1
+	}).strict(), z.object({ type: z.literal("board") }).strict()]),
+	kind: extensionIdSchema,
+	kindVersion: z.number().int().positive(),
+	enabled: z.boolean().default(true),
+	lifecycle: z.enum([
+		"persistent",
+		"when-visible",
+		"manual"
+	]),
+	timeOrigin: z.enum([
+		"board",
+		"visible",
+		"activation"
+	]),
+	layer: z.enum([
+		"behind",
+		"front",
+		"screen"
+	]).default("front"),
+	seed: z.string().min(1).max(160),
+	params: jsonObjectSchema$1.default({}),
+	assetRefs: z.array(BoardAssetRefSchema).default([]),
+	metadata: jsonObjectSchema$1.default({}),
+	revision: z.number().int().nonnegative()
+}).strict();
+/** The client-authored effect form: no server-owned `boardId`/`revision`. */
+const BoardEffectInputSchema = BoardEffectSchema.omit({
+	boardId: true,
+	revision: true
+});
+/** Accept a read projection in a write command while stripping server fields. */
+function parseBoardEffectInput(value) {
+	if (value && typeof value === "object" && !Array.isArray(value)) {
+		const { boardId: _boardId, revision: _revision, ...input } = value;
+		return BoardEffectInputSchema.parse(input);
+	}
+	return BoardEffectInputSchema.parse(value);
+}
+//#endregion
 //#region ../protocol/dist/board-authoring.js
-const BOARD_COLOR_IDS$1 = [
+const BOARD_AUTHORING_COLOR_IDS = [
 	"brand",
 	"neutral",
 	"black",
@@ -994,43 +1028,43 @@ const BOARD_COLOR_IDS$1 = [
 	"violet",
 	"rose"
 ];
-const BOARD_GEO_KINDS$1 = [
+const BOARD_AUTHORING_GEO_KINDS = [
 	"rectangle",
 	"rounded",
 	"ellipse",
 	"diamond",
 	"triangle"
 ];
-const idSchema$2 = z.string().min(1).max(160);
-const jsonObjectSchema$1 = z.record(z.string(), z.unknown());
-const finiteSchema$2 = z.number().finite();
+const idSchema = z.string().min(1).max(160);
+const jsonObjectSchema = z.record(z.string(), z.unknown());
+const finiteSchema = z.number().finite();
 const extensionTypeSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
 const BoardAuthoringFrameSchema = z.object({
-	x: finiteSchema$2,
-	y: finiteSchema$2,
-	width: finiteSchema$2.positive(),
-	height: finiteSchema$2.positive(),
-	rotation: finiteSchema$2.default(0)
+	x: finiteSchema,
+	y: finiteSchema,
+	width: finiteSchema.positive(),
+	height: finiteSchema.positive(),
+	rotation: finiteSchema.default(0)
 }).strict();
-const pointSchema$1 = z.object({
-	x: finiteSchema$2,
-	y: finiteSchema$2,
-	p: finiteSchema$2.min(0).max(1).default(.5)
+const pointSchema = z.object({
+	x: finiteSchema,
+	y: finiteSchema,
+	p: finiteSchema.min(0).max(1).default(.5)
 }).strict();
-const worldPointSchema$1 = z.object({
-	x: finiteSchema$2,
-	y: finiteSchema$2
+const worldPointSchema = z.object({
+	x: finiteSchema,
+	y: finiteSchema
 }).strict();
 const cropSchema = z.object({
-	x: finiteSchema$2.min(0).max(1),
-	y: finiteSchema$2.min(0).max(1),
-	w: finiteSchema$2.min(0).max(1),
-	h: finiteSchema$2.min(0).max(1)
+	x: finiteSchema.min(0).max(1),
+	y: finiteSchema.min(0).max(1),
+	w: finiteSchema.min(0).max(1),
+	h: finiteSchema.min(0).max(1)
 }).strict();
-const BoardItemStyleSchema$1 = z.object({
-	color: z.enum(BOARD_COLOR_IDS$1).optional(),
-	strokeWidth: finiteSchema$2.min(1).max(64).optional(),
-	fillOpacity: finiteSchema$2.min(0).max(1).optional()
+const BoardItemStyleSchema = z.object({
+	color: z.enum(BOARD_AUTHORING_COLOR_IDS).optional(),
+	strokeWidth: finiteSchema.min(1).max(64).optional(),
+	fillOpacity: finiteSchema.min(0).max(1).optional()
 }).strict();
 const sourceSnapshotSchema = z.record(z.string(), z.unknown());
 function isSafeBoardSourcePath(value) {
@@ -1042,44 +1076,44 @@ const BoardItemSourceSchema = z.object({
 	snapshot: sourceSnapshotSchema.optional()
 }).strict();
 const baseFields = {
-	id: idSchema$2,
+	id: idSchema,
 	frame: BoardAuthoringFrameSchema,
-	parentId: idSchema$2.nullable().optional(),
+	parentId: idSchema.nullable().optional(),
 	locked: z.boolean().optional(),
-	metadata: jsonObjectSchema$1.optional()
+	metadata: jsonObjectSchema.optional()
 };
 const styledBaseFields = {
 	...baseFields,
-	style: BoardItemStyleSchema$1.optional()
+	style: BoardItemStyleSchema.optional()
 };
 const BoardTextAuthoringItemSchema = z.object({
 	...styledBaseFields,
 	type: z.literal("text"),
 	props: z.object({
 		text: z.string().default(""),
-		fontSize: finiteSchema$2.min(2).max(512).default(24)
+		fontSize: finiteSchema.min(2).max(512).default(24)
 	}).strict()
 }).strict();
 const BoardGeoAuthoringItemSchema = z.object({
 	...styledBaseFields,
 	type: z.literal("geo"),
 	props: z.object({
-		shape: z.enum(BOARD_GEO_KINDS$1).default("rectangle"),
+		shape: z.enum(BOARD_AUTHORING_GEO_KINDS).default("rectangle"),
 		text: z.string().default("")
 	}).strict()
 }).strict();
 const BoardDrawAuthoringItemSchema = z.object({
 	...styledBaseFields,
 	type: z.literal("draw"),
-	props: z.object({ points: z.array(pointSchema$1).min(1) }).strict()
+	props: z.object({ points: z.array(pointSchema).min(1) }).strict()
 }).strict();
 const BoardArrowAuthoringItemSchema = z.object({
 	...styledBaseFields,
 	type: z.literal("arrow"),
 	props: z.object({
-		start: worldPointSchema$1,
-		end: worldPointSchema$1,
-		bend: finiteSchema$2.min(-.85).max(.85).default(0),
+		start: worldPointSchema,
+		end: worldPointSchema,
+		bend: finiteSchema.min(-.85).max(.85).default(0),
 		arrowStart: z.boolean().default(false),
 		arrowEnd: z.boolean().default(true),
 		label: z.string().default("")
@@ -1136,1264 +1170,178 @@ const BoardExtensionAuthoringItemSchema = z.object({
 	...baseFields,
 	type: extensionTypeSchema,
 	kindVersion: z.number().int().positive(),
-	props: jsonObjectSchema$1,
-	style: jsonObjectSchema$1.optional(),
+	props: jsonObjectSchema,
+	style: jsonObjectSchema.optional(),
 	source: z.object({
 		kind: z.string().min(1).max(80),
 		ref: z.string().min(1).max(4096),
-		snapshot: jsonObjectSchema$1.optional()
+		snapshot: jsonObjectSchema.optional()
 	}).strict().optional()
 }).strict();
 const BoardAuthoringItemSchema = z.union([BoardBuiltinAuthoringItemSchema, BoardExtensionAuthoringItemSchema]);
 const framePatchSchema = z.object({
-	x: finiteSchema$2.optional(),
-	y: finiteSchema$2.optional(),
-	width: finiteSchema$2.positive().optional(),
-	height: finiteSchema$2.positive().optional(),
-	rotation: finiteSchema$2.optional()
+	x: finiteSchema.optional(),
+	y: finiteSchema.optional(),
+	width: finiteSchema.positive().optional(),
+	height: finiteSchema.positive().optional(),
+	rotation: finiteSchema.optional()
 }).strict();
 /** JSON Merge Patch semantics, constrained to the stable Item envelope. */
 const BoardItemPatchSchema = z.object({
 	frame: framePatchSchema.optional(),
-	parentId: idSchema$2.nullable().optional(),
+	parentId: idSchema.nullable().optional(),
 	locked: z.boolean().nullable().optional(),
-	props: jsonObjectSchema$1.optional(),
-	style: jsonObjectSchema$1.nullable().optional(),
-	source: jsonObjectSchema$1.nullable().optional(),
-	metadata: jsonObjectSchema$1.nullable().optional()
+	props: jsonObjectSchema.optional(),
+	style: jsonObjectSchema.nullable().optional(),
+	source: jsonObjectSchema.nullable().optional(),
+	metadata: jsonObjectSchema.nullable().optional()
 }).strict().refine((patch) => Object.keys(patch).length > 0, "item patch is empty");
+const BoardConnectionInputSchema = BoardConnectionSchema;
+const stripServerFields = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return value;
+	const { boardId: _boardId, revision: _revision, ...input } = value;
+	return input;
+};
+const BoardEffectCommandInputSchema = z.preprocess(stripServerFields, BoardEffectInputSchema);
+const BoardCompositionCommandInputSchema = z.preprocess(stripServerFields, BoardCompositionInputSchema);
 const BoardSemanticCommandSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("board.patch"),
+		patch: z.object({
+			title: z.string().min(1).max(255).optional(),
+			metadata: jsonObjectSchema.nullable().optional(),
+			metadataPatch: jsonObjectSchema.optional()
+		}).strict().refine((patch) => Object.keys(patch).length > 0, "board patch is empty")
+	}).strict(),
 	z.object({
 		type: z.literal("item.create"),
 		item: BoardAuthoringItemSchema
 	}).strict(),
 	z.object({
 		type: z.literal("item.patch"),
-		itemId: idSchema$2,
+		itemId: idSchema,
 		patch: BoardItemPatchSchema
 	}).strict(),
 	z.object({
 		type: z.literal("item.replace"),
-		itemId: idSchema$2,
+		itemId: idSchema,
 		item: BoardAuthoringItemSchema
 	}).strict(),
 	z.object({
 		type: z.literal("item.delete"),
-		itemId: idSchema$2,
+		itemId: idSchema,
 		cascade: z.boolean().default(false)
-	}).strict()
-]);
-z.object({
-	mutationId: idSchema$2,
-	baseVersion: z.number().int().nonnegative(),
-	clientId: idSchema$2.optional(),
-	undoGroupId: idSchema$2.optional(),
-	commands: z.array(BoardSemanticCommandSchema).min(1).max(5e4)
-}).strict();
-//#endregion
-//#region ../protocol/dist/board.js
-const BOARD_DOCUMENT_KIND = "cohub.board";
-const BOARD_MANIFEST_KIND = "cohub.board.manifest";
-const idSchema$1 = z.string().min(1).max(160);
-const extensionIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
-const jsonObjectSchema = z.record(z.string(), z.unknown());
-const finiteSchema$1 = z.number().finite();
-z.object({
-	kind: z.literal(BOARD_MANIFEST_KIND),
-	version: z.literal(1),
-	boardId: z.string().uuid(),
-	title: z.string().min(1).max(255)
-});
-z.object({
-	centerX: finiteSchema$1,
-	centerY: finiteSchema$1,
-	zoom: finiteSchema$1.positive()
-});
-const BoardCameraFocusSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("rect"),
-		rect: z.object({
-			x: finiteSchema$1,
-			y: finiteSchema$1,
-			width: finiteSchema$1.positive(),
-			height: finiteSchema$1.positive()
-		})
-	}),
-	z.object({
-		type: z.literal("item"),
-		itemId: idSchema$1
-	}),
-	z.object({
-		type: z.literal("items"),
-		itemIds: z.array(idSchema$1).min(1).max(1e3)
-	}),
-	z.object({
-		type: z.literal("frame"),
-		frameId: idSchema$1
-	})
-]);
-const BoardCameraFocusParamsSchema = z.object({
-	focus: BoardCameraFocusSchema,
-	fit: z.enum(["contain", "cover"]).default("contain"),
-	padding: finiteSchema$1.nonnegative().default(32),
-	minZoom: finiteSchema$1.positive().optional(),
-	maxZoom: finiteSchema$1.positive().optional()
-}).superRefine((value, context) => {
-	if (value.minZoom !== void 0 && value.maxZoom !== void 0 && value.minZoom > value.maxZoom) context.addIssue({
-		code: "custom",
-		message: "minZoom must not exceed maxZoom",
-		path: ["minZoom"]
-	});
-});
-const BoardAssetRefSchema = z.object({
-	type: z.enum(["space-file", "extension"]),
-	ref: z.string().min(1).max(4096),
-	digest: z.string().min(16).max(160).optional()
-});
-const BoardEffectSchema = z.object({
-	id: idSchema$1,
-	boardId: z.string().uuid(),
-	target: z.discriminatedUnion("type", [z.object({
-		type: z.literal("item"),
-		itemId: idSchema$1
-	}).strict(), z.object({ type: z.literal("board") }).strict()]),
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	enabled: z.boolean().default(true),
-	lifecycle: z.enum([
-		"persistent",
-		"when-visible",
-		"manual"
-	]),
-	timeOrigin: z.enum([
-		"board",
-		"visible",
-		"activation"
-	]),
-	layer: z.enum([
-		"behind",
-		"front",
-		"screen"
-	]).default("front"),
-	seed: z.string().min(1).max(160),
-	params: jsonObjectSchema.default({}),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-z.object({
-	nodeId: idSchema$1,
-	type: z.string().min(1).max(40),
-	parentId: idSchema$1.nullable(),
-	orderKey: z.string().max(4096).nullable(),
-	x: finiteSchema$1,
-	y: finiteSchema$1,
-	width: finiteSchema$1.positive(),
-	height: finiteSchema$1.positive(),
-	rotation: finiteSchema$1,
-	refKind: z.string().max(40).nullable(),
-	refPath: z.string().max(4096).nullable(),
-	refUrl: z.string().max(4096).nullable(),
-	view: jsonObjectSchema,
-	style: jsonObjectSchema,
-	data: jsonObjectSchema
-});
-z.object({
-	path: z.string().min(1),
-	/** Reused by clients when board creation is interrupted and retried. */
-	mutationId: z.string().max(128).optional(),
-	title: z.string().min(1).max(255).optional(),
-	metadata: jsonObjectSchema.optional(),
-	items: z.array(BoardAuthoringItemSchema).max(5e4).optional(),
-	connections: z.array(BoardConnectionSchema).max(5e4).optional(),
-	effects: z.array(BoardEffectSchema.omit({
-		boardId: true,
-		revision: true
-	})).optional(),
-	compositions: z.array(BoardCompositionInputSchema).optional()
-});
-z.object({
-	include: z.array(z.enum([
-		"nodes",
-		"connections",
-		"effects",
-		"compositions",
-		"playback"
-	])).optional(),
-	viewport: z.object({
-		x: finiteSchema$1,
-		y: finiteSchema$1,
-		width: finiteSchema$1.positive(),
-		height: finiteSchema$1.positive()
-	}).optional()
-});
-/** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
-const BoardPlaybackPolicySchema = z.object({
-	compositionId: idSchema$1,
-	/** Delay before the first local playback after opening the Board, in milliseconds. */
-	delayMs: finiteSchema$1.nonnegative().default(0)
-});
-function parseBoardPlaybackPolicy(metadata) {
-	const parsed = BoardPlaybackPolicySchema.safeParse(metadata.playback);
-	return parsed.success ? parsed.data : null;
-}
-z.discriminatedUnion("type", [
-	z.object({
-		commandId: idSchema$1,
-		type: z.literal("play"),
-		compositionId: idSchema$1,
-		position: finiteSchema$1.nonnegative().optional(),
-		timeScale: finiteSchema$1.positive().max(4).optional(),
-		shared: z.boolean().optional(),
-		seed: idSchema$1.optional()
-	}),
-	z.object({
-		commandId: idSchema$1,
-		type: z.literal("pause"),
-		playbackId: z.string().uuid()
-	}),
-	z.object({
-		commandId: idSchema$1,
-		type: z.literal("seek"),
-		playbackId: z.string().uuid(),
-		position: finiteSchema$1.nonnegative()
-	}),
-	z.object({
-		commandId: idSchema$1,
-		type: z.literal("stop"),
-		playbackId: z.string().uuid()
-	})
-]);
-//#endregion
-//#region ../protocol/dist/board-capability-registry.js
-const CLIPS = new Set(BOARD_BUILTIN_CLIP_KINDS);
-new Set(BOARD_BUILTIN_EFFECT_KINDS);
-const record = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
-const finite = (value) => typeof value === "number" && Number.isFinite(value);
-function validateBuiltinBoardClip(clip, path = "clip") {
-	if (!CLIPS.has(clip.kind)) return [];
-	const errors = [];
-	const error = (message, suffix, coordinateSpace, code = "INVALID_BOARD_CLIP") => {
-		errors.push({
-			severity: "error",
-			code,
-			message,
-			path: `${path}.${suffix}`,
-			...coordinateSpace ? { coordinateSpace } : {}
-		});
-	};
-	if ((clip.kind.startsWith("motion.") || clip.kind.startsWith("draw.") || clip.kind === "text.reveal" || clip.kind === "effects.trail") && clip.target.type !== "item") error(`${clip.kind} must target an item`, "target");
-	if (clip.kind.startsWith("camera.") && clip.target.type !== "camera") error(`${clip.kind} must target the camera`, "target");
-	if (clip.kind === "motion.path") {
-		const points = clip.params.points;
-		if (!Array.isArray(points) || points.length < 2 || points.length > 1e4) error("motion path must contain 2 to 10000 world-offset points", "params.points", "world-offset");
-		else for (const [index, point] of points.entries()) if (!record(point) || !finite(point.x) || !finite(point.y)) error("motion path point must contain finite x and y", `params.points.${index}`, "world-offset");
-	}
-	if (clip.kind === "effects.particles") {
-		const count = clip.params.count;
-		if (!Number.isSafeInteger(count) || count < 1 || count > DEFAULT_BOARD_RENDER_LIMITS.particles) error(`particle count must be an integer from 1 to ${DEFAULT_BOARD_RENDER_LIMITS.particles}`, "params.count", void 0, "INVALID_PARTICLE_COUNT");
-		const bounds = clip.params.bounds;
-		if (!record(bounds) || !finite(bounds.x) || !finite(bounds.y) || !finite(bounds.width) || !finite(bounds.height) || bounds.width <= 0 || bounds.height <= 0) error("particles require positive finite world bounds", "params.bounds", "world", "PARTICLE_BOUNDS_REQUIRED");
-	}
-	if (clip.kind === "camera.focus") {
-		const parsed = BoardCameraFocusParamsSchema.safeParse(clip.params);
-		if (!parsed.success) error(parsed.error.issues[0]?.message ?? "invalid camera focus", "params", "world");
-	}
-	return errors;
-}
-function estimateBuiltinBoardClipCost(clip) {
-	switch (clip.kind) {
-		case "effects.particles": {
-			const count = Number.isSafeInteger(clip.params.count) ? Math.max(0, clip.params.count) : 0;
-			return {
-				particles: count,
-				vertices: count * 4,
-				dynamicVertices: count * 4,
-				drawCalls: 1,
-				bufferBytes: count * 48,
-				simulationSteps: count
-			};
-		}
-		case "effects.trail": return {
-			vertices: 32,
-			dynamicVertices: 32,
-			drawCalls: 1,
-			bufferBytes: 1024,
-			simulationSteps: 16
-		};
-		case "effects.impact":
-		case "effects.flash": return {
-			vertices: 64,
-			drawCalls: 1
-		};
-		case "draw.reveal":
-		case "draw.handwrite": return {
-			drawCalls: 1,
-			dynamicVertices: 1
-		};
-		case "motion.path": return { simulationSteps: Array.isArray(clip.params.points) ? clip.params.points.length : 0 };
-		default: return {};
-	}
-}
-//#endregion
-//#region ../protocol/dist/board-url.js
-const BOARD_REMOTE_URL_MAX_LENGTH = 4096;
-function parseIpv4(host) {
-	const parts = host.split(".").map(Number);
-	return parts.length === 4 && parts.every((part) => Number.isInteger(part) && part >= 0 && part <= 255) ? parts : null;
-}
-function isBlockedIpv4(host) {
-	const parts = parseIpv4(host);
-	if (!parts) return false;
-	const [first, second, third] = parts;
-	if (first === 0 || first === 10 || first === 127) return true;
-	if (first === 100 && second >= 64 && second <= 127) return true;
-	if (first === 169 && second === 254) return true;
-	if (first === 172 && second >= 16 && second <= 31) return true;
-	if (first === 192 && second === 168) return true;
-	if (first === 192 && second === 0 && (third === 0 || third === 2)) return true;
-	if (first === 192 && second === 88 && third === 99) return true;
-	if (first === 198 && (second === 18 || second === 19)) return true;
-	if (first === 198 && second === 51 && third === 100) return true;
-	if (first === 203 && second === 0 && third === 113) return true;
-	return first >= 224;
-}
-function expandIpv6(host) {
-	const [head, tail, extra] = host.toLowerCase().split("::");
-	if (extra !== void 0) return null;
-	const headParts = head ? head.split(":").filter(Boolean) : [];
-	const tailParts = tail ? tail.split(":").filter(Boolean) : [];
-	const missing = 8 - headParts.length - tailParts.length;
-	if (missing < 0 || tail === void 0 && missing !== 0) return null;
-	const parts = [
-		...headParts,
-		...Array.from({ length: missing }, () => "0"),
-		...tailParts
-	];
-	if (parts.length !== 8 || parts.some((part) => !/^[0-9a-f]{1,4}$/.test(part))) return null;
-	return parts.map((part) => part.padStart(4, "0"));
-}
-function isBlockedIpv6(host) {
-	const parts = expandIpv6(host);
-	if (!parts) return true;
-	if (parts.every((part) => part === "0000")) return true;
-	if (parts.slice(0, 7).every((part) => part === "0000") && parts[7] === "0001") return true;
-	if (parts.slice(0, 5).every((part) => part === "0000") && parts[5] === "ffff") {
-		const high = Number.parseInt(parts[6] ?? "0", 16);
-		const low = Number.parseInt(parts[7] ?? "0", 16);
-		return isBlockedIpv4(`${high >> 8}.${high & 255}.${low >> 8}.${low & 255}`);
-	}
-	if (parts.slice(0, 6).every((part) => part === "0000")) return true;
-	const first = Number.parseInt(parts[0] ?? "0", 16);
-	if ((first & 65024) === 64512) return true;
-	if ((first & 65472) === 65152 || (first & 65472) === 65216) return true;
-	if ((first & 65280) === 65280) return true;
-	return parts[0] === "2001" && parts[1] === "0db8";
-}
-function isPublicBoardRemoteAddress(value) {
-	const address = value.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
-	if (parseIpv4(address)) return !isBlockedIpv4(address);
-	return address.includes(":") && !isBlockedIpv6(address);
-}
-function isBlockedHost(hostname) {
-	const host = hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
-	if (host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal")) return true;
-	if (parseIpv4(host) || host.includes(":")) return !isPublicBoardRemoteAddress(host);
-	return false;
-}
-/**
-* Normalize a browser-loadable public HTTP(S) URL. This blocks explicit local
-* addresses; any future server-side fetcher must additionally validate DNS
-* resolution to defend against rebinding.
-*/
-function normalizeBoardRemoteUrl(value) {
-	if (typeof value !== "string") return void 0;
-	const input = value.trim();
-	if (!input || input.length > 4096) return void 0;
-	try {
-		const url = new URL(input);
-		if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
-		if (url.username || url.password || isBlockedHost(url.hostname)) return;
-		const normalized = url.toString();
-		return normalized.length <= 4096 ? normalized : void 0;
-	} catch {
-		return;
-	}
-}
-const BoardRemoteUrlSchema = z.string().max(BOARD_REMOTE_URL_MAX_LENGTH).refine((value) => normalizeBoardRemoteUrl(value) !== void 0, { message: "URL must be a public HTTP(S) URL without credentials" });
-//#endregion
-//#region ../protocol/dist/board-document.js
-const BoardFrameSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite(),
-	width: z.number().finite().positive(),
-	height: z.number().finite().positive(),
-	rotation: z.number().finite().default(0)
-});
-/**
-* The board camera. This is local UI state, not synced content: semantic ops
-* (see diffBoardDocuments) never describe the viewport, and the editor holds
-* the live camera separately from the persisted document. Here it only serves
-* as an initial camera hint when a document is first loaded.
-*/
-const BoardViewportSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite(),
-	zoom: z.number().finite().min(.05).max(8)
-});
-const BoardAppearanceSchema = z.object({
-	theme: z.string().min(1).default("clean"),
-	background: z.object({
-		kind: z.enum([
-			"solid",
-			"dots",
-			"grid",
-			"image",
-			"shader",
-			"custom"
-		]).default("dots"),
-		color: z.string().optional(),
-		imageUrl: BoardRemoteUrlSchema.optional(),
-		fit: z.enum([
-			"cover",
-			"contain",
-			"repeat"
-		]).optional(),
-		position: z.enum([
-			"center",
-			"top",
-			"bottom",
-			"left",
-			"right"
-		]).optional(),
-		opacity: z.number().finite().min(0).max(1).optional()
-	}).default({ kind: "solid" }),
-	grid: z.object({
-		visible: z.boolean().default(false),
-		size: z.number().finite().min(4).default(24),
-		opacity: z.number().finite().min(0).max(1).default(.12)
-	}).default({
-		visible: false,
-		size: 24,
-		opacity: .12
-	}),
-	mood: z.enum([
-		"clean",
-		"playful",
-		"arcane",
-		"cyber",
-		"natural"
-	]).default("clean")
-});
-/** Optional visual chrome still carried by a few older shapes. */
-const BoardItemStyleSchema = z.object({
-	variant: z.string().min(1).default("default"),
-	theme: z.string().min(1).optional(),
-	accentColor: z.string().optional(),
-	size: z.enum([
-		"sm",
-		"md",
-		"lg"
-	]).default("md"),
-	emphasis: z.enum([
-		"normal",
-		"rare",
-		"epic",
-		"legendary"
-	]).default("normal"),
-	effects: z.array(z.string().min(1)).default([])
-});
-const SpaceFileRefSchema = z.object({
-	kind: z.literal("space-file"),
-	path: z.string().min(1)
-});
-const BoardMediaSnapshotSchema = z.object({
-	title: z.string().optional(),
-	mimeType: z.string().optional(),
-	size: z.number().finite().nonnegative().optional(),
-	mtimeMs: z.number().finite().nonnegative().optional(),
-	/** Intrinsic pixel size once known. */
-	naturalWidth: z.number().finite().positive().optional(),
-	naturalHeight: z.number().finite().positive().optional()
-});
-const BoardItemBaseSchema = z.object({
-	id: z.string().min(1),
-	frame: BoardFrameSchema,
-	/** When true the shape cannot be moved, resized, or deleted. */
-	locked: z.boolean().optional(),
-	style: BoardItemStyleSchema.optional(),
-	metadata: z.record(z.string(), z.unknown()).optional()
-});
-/** Freestanding text — no card chrome; its frame always follows the glyphs. */
-const BoardTextItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("text"),
-	text: z.string().default(""),
-	color: z.string().min(1).default("neutral"),
-	fontSize: z.number().finite().min(2).max(512).default(24)
-});
-const BoardGeoItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("geo"),
-	geo: z.string().min(1).default("rectangle"),
-	text: z.string().default(""),
-	color: z.string().min(1).default("brand"),
-	fillOpacity: z.number().finite().min(0).max(1).default(0)
-});
-/** A raw freehand sample. Pressure defaults to 0.5 (mouse) when absent. */
-const DrawPointSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite(),
-	p: z.number().finite().min(0).max(1).default(.5)
-});
-/** A world-space point. */
-const BoardPointSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite()
-});
-const BoardDrawItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("draw"),
-	points: z.array(DrawPointSchema).default([]),
-	color: z.string().min(1).default("brand"),
-	size: z.number().finite().positive().default(4)
-});
-/**
-* A free arrow — a standalone annotation stroke between two world points.
-*
-* Arrows do not relate nodes. A relation between two nodes is a
-* `BoardConnection`, which is stored separately and resolves its geometry from
-* the live node frames. Keeping the two apart is what lets an arrow be a plain
-* shape (its own frame, freely movable) while a connection stays purely
-* semantic — neither has to pretend to be the other.
-*/
-const BoardArrowItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("arrow"),
-	start: BoardPointSchema,
-	end: BoardPointSchema,
-	bend: z.number().finite().min(-.85).max(.85).default(0),
-	color: z.string().min(1).default("brand"),
-	size: z.number().finite().positive().default(BOARD_ARROW_STROKE_SIZE),
-	arrowStart: z.boolean().default(false),
-	arrowEnd: z.boolean().default(true),
-	label: z.string().default("")
-});
-/** A frame container for organising shapes. */
-const BoardFrameItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("frame"),
-	label: z.string().default("Frame"),
-	color: z.string().min(1).default("neutral")
-});
-/** Image node — space file only, natural aspect, no chrome. */
-const BoardImageItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("image"),
-	ref: SpaceFileRefSchema,
-	snapshot: BoardMediaSnapshotSchema.optional(),
-	/** Optional normalized crop in source image space (0..1). */
-	crop: z.object({
-		x: z.number().finite().min(0).max(1).default(0),
-		y: z.number().finite().min(0).max(1).default(0),
-		w: z.number().finite().min(0).max(1).default(1),
-		h: z.number().finite().min(0).max(1).default(1)
-	}).optional()
-});
-/** Video node — space file only. Playback state is local UI, never synced. */
-const BoardVideoItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("video"),
-	ref: SpaceFileRefSchema,
-	snapshot: BoardMediaSnapshotSchema.optional()
-});
-/** Audio node — space file only. Playback state is local UI, never synced. */
-const BoardAudioItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("audio"),
-	ref: SpaceFileRefSchema,
-	snapshot: BoardMediaSnapshotSchema.extend({ durationMs: z.number().finite().nonnegative().optional() }).optional()
-});
-/**
-* Cached display facts for a file card.
-*
-* Purely derived from the referenced file and versioned by `mtimeMs`, so it is a
-* cache and never a second source of truth: the workspace file remains
-* authoritative, and a stale snapshot is detectable rather than silently wrong.
-* It is stored so that opening a board renders complete cards immediately, with
-* no per-node file read on the first paint.
-*/
-const BoardFileSnapshotSchema = z.object({
-	title: z.string().optional(),
-	mimeType: z.string().optional(),
-	size: z.number().finite().nonnegative().optional(),
-	mtimeMs: z.number().finite().nonnegative().optional(),
-	/** Cleaned leading prose. Capped when written (see FILE_EXCERPT_MAX_CHARS). */
-	excerpt: z.string().optional(),
-	/** Cover image inside the space, already resolved to a workspace path. */
-	coverPath: z.string().optional(),
-	/** Cover image at an absolute https URL, as declared by the file itself. */
-	coverUrl: z.string().optional()
-});
-/**
-* File node — a thumbnail entry point to any workspace file.
-*
-* This is the fallback for every dropped file that is not natively an image or
-* video, including binaries and unknown extensions: a board should never refuse
-* a file, only present it with less detail. Presentation tiers are derived from
-* the snapshot (see filePreviewKind), not stored, so there is no display state
-* to drift from the facts.
-*/
-const BoardFileItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("file"),
-	ref: SpaceFileRefSchema,
-	snapshot: BoardFileSnapshotSchema.optional()
-});
-const BoardTaskMediaArtifactFields = {
-	id: z.string().min(1).max(240),
-	title: z.string().max(240).optional(),
-	url: BoardRemoteUrlSchema,
-	mimeType: z.string().max(160).optional()
-};
-const BoardTaskArtifactSchema = z.discriminatedUnion("type", [
-	z.object({
-		...BoardTaskMediaArtifactFields,
-		type: z.literal("image"),
-		naturalWidth: z.number().positive().optional(),
-		naturalHeight: z.number().positive().optional()
 	}).strict(),
 	z.object({
-		...BoardTaskMediaArtifactFields,
-		type: z.literal("video"),
-		previewUrl: BoardRemoteUrlSchema.optional(),
-		durationMs: z.number().int().positive().optional(),
-		naturalWidth: z.number().positive().optional(),
-		naturalHeight: z.number().positive().optional()
+		type: z.literal("item.reorder"),
+		itemId: idSchema,
+		index: z.number().int().nonnegative()
 	}).strict(),
 	z.object({
-		...BoardTaskMediaArtifactFields,
-		type: z.literal("audio"),
-		previewUrl: BoardRemoteUrlSchema.optional(),
-		durationMs: z.number().int().positive().optional()
-	}).strict(),
-	z.object({
-		id: z.string().min(1).max(240),
-		type: z.literal("text"),
-		title: z.string().max(240).optional(),
-		textExcerpt: z.string().min(1).max(480)
-	}).strict()
-]);
-/**
-* Cached task facts used for an immediate first paint. The task run remains the
-* source of truth and live clients refresh this projection by `taskRunId`.
-*/
-const BoardTaskSnapshotSchema = z.object({
-	taskType: z.string().min(1).max(120),
-	status: z.enum([
-		"pending",
-		"running",
-		"completed",
-		"failed"
-	]),
-	title: z.string().min(1).max(240),
-	model: z.string().max(160).optional(),
-	promptExcerpt: z.string().max(480).optional(),
-	artifactCount: z.number().int().nonnegative(),
-	artifacts: z.array(BoardTaskArtifactSchema).max(6).default([]),
-	updatedAt: z.string().optional()
-}).strict();
-/** A stable reference to a task run with a small, replaceable display cache. */
-const BoardTaskItemSchema = BoardItemBaseSchema.extend({
-	type: z.literal("task"),
-	taskRunId: z.string().min(1),
-	snapshot: BoardTaskSnapshotSchema
-});
-/**
-* A forward-compatible carrier for shape types this client does not recognise.
-* Its discriminant is the literal `"unknown"` so the item union still narrows
-* cleanly on `type`. The real type string and every original field are preserved
-* verbatim in `raw`.
-*/
-const UNKNOWN_BOARD_ITEM_TYPE = "unknown";
-const BoardItemSchema = z.any().transform((raw) => parseBoardItemLoose(raw));
-/**
-* Parse a single item leniently: known types are validated and normalised;
-* anything else becomes a lossless unknown item. Never throws on shape data —
-* a malformed known item degrades to unknown rather than failing the document.
-*/
-function parseBoardItemLoose(raw) {
-	if (!raw || typeof raw !== "object") return makeUnknownItem(raw);
-	switch (raw.type) {
-		case "image": {
-			const parsed = BoardImageItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "video": {
-			const parsed = BoardVideoItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "audio": {
-			const parsed = BoardAudioItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "file": {
-			const parsed = BoardFileItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "task": {
-			const parsed = BoardTaskItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "text": {
-			const parsed = BoardTextItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "geo": {
-			const parsed = BoardGeoItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "draw": {
-			const parsed = BoardDrawItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "arrow": {
-			const parsed = BoardArrowItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		case "frame": {
-			const parsed = BoardFrameItemSchema.safeParse(raw);
-			return parsed.success ? parsed.data : makeUnknownItem(raw);
-		}
-		default: return makeUnknownItem(raw);
-	}
-}
-function makeUnknownItem(raw) {
-	const record = raw && typeof raw === "object" ? raw : {};
-	const frameParsed = BoardFrameSchema.safeParse(record.frame);
-	const styleParsed = BoardItemStyleSchema.safeParse(record.style);
-	return {
-		id: typeof record.id === "string" && record.id ? record.id : "unknown",
-		type: UNKNOWN_BOARD_ITEM_TYPE,
-		frame: frameParsed.success ? frameParsed.data : {
-			x: 0,
-			y: 0,
-			width: 120,
-			height: 80,
-			rotation: 0
-		},
-		...record.locked === true ? { locked: true } : {},
-		...styleParsed.success && record.style ? { style: styleParsed.data } : {},
-		...record.metadata && typeof record.metadata === "object" ? { metadata: record.metadata } : {},
-		raw: record
-	};
-}
-z.object({
-	kind: z.literal(BOARD_DOCUMENT_KIND),
-	version: z.literal(1),
-	appearance: BoardAppearanceSchema.default({
-		theme: "clean",
-		background: { kind: "solid" },
-		grid: {
-			visible: false,
-			size: 24,
-			opacity: .12
-		},
-		mood: "clean"
-	}),
-	viewport: BoardViewportSchema,
-	items: z.array(BoardItemSchema),
-	/**
-	* Node relations. Separate from `items` because a connection has no frame of
-	* its own — its geometry is derived from the nodes it joins, so it is a
-	* relation over the item set rather than a member of it.
-	*
-	* Connections referencing a missing node are dropped on parse: a relation to
-	* nothing is not a relation, and keeping one would let an invisible dangling
-	* edge accumulate silently. Callers that need to know write through the
-	* transaction API, which reports the reference error instead.
-	*/
-	connections: z.array(BoardConnectionSchema).default([])
-});
-//#endregion
-//#region ../protocol/dist/board-node.js
-const BOARD_COLOR_IDS = [
-	"brand",
-	"neutral",
-	"black",
-	"white",
-	"blue",
-	"green",
-	"amber",
-	"violet",
-	"rose"
-];
-const BoardColorIdSchema = z.enum(BOARD_COLOR_IDS);
-const BOARD_GEO_KINDS = [
-	"rectangle",
-	"rounded",
-	"ellipse",
-	"diamond",
-	"triangle"
-];
-const BoardGeoKindSchema = z.enum(BOARD_GEO_KINDS);
-const BOARD_NATIVE_NODE_TYPES = [
-	"image",
-	"video",
-	"audio",
-	"file",
-	"task",
-	"text",
-	"geo",
-	"draw",
-	"arrow",
-	"frame"
-];
-const metadataSchema = z.record(z.string(), z.unknown());
-const commonData = {
-	locked: z.boolean().optional(),
-	metadata: metadataSchema.optional()
-};
-const pointSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite(),
-	p: z.number().finite().min(0).max(1).default(.5)
-}).strict();
-const worldPointSchema = z.object({
-	x: z.number().finite(),
-	y: z.number().finite()
-}).strict();
-const strokeSizeSchema = z.number().finite().min(1).max(64);
-const mediaViewSchema = z.object({
-	title: z.string().optional(),
-	mimeType: z.string().optional(),
-	size: z.number().finite().nonnegative().optional(),
-	mtimeMs: z.number().finite().nonnegative().optional(),
-	naturalWidth: z.number().finite().positive().optional(),
-	naturalHeight: z.number().finite().positive().optional()
-}).strict();
-const audioViewSchema = mediaViewSchema.extend({ durationMs: z.number().finite().nonnegative().optional() });
-const dataSchemas = {
-	text: z.object({
-		...commonData,
-		text: z.string().default(""),
-		color: BoardColorIdSchema.default("neutral"),
-		fontSize: z.number().finite().min(2).max(512).default(24)
-	}).strict(),
-	geo: z.object({
-		...commonData,
-		geo: BoardGeoKindSchema.default("rectangle"),
-		text: z.string().default(""),
-		color: BoardColorIdSchema.default("brand"),
-		fillOpacity: z.number().finite().min(0).max(1).default(0)
-	}).strict(),
-	draw: z.object({
-		...commonData,
-		points: z.array(pointSchema).min(1),
-		color: BoardColorIdSchema.default("brand"),
-		size: strokeSizeSchema.default(4)
-	}).strict(),
-	arrow: z.object({
-		...commonData,
-		start: worldPointSchema,
-		end: worldPointSchema,
-		bend: z.number().finite().min(-.85).max(.85).default(0),
-		color: BoardColorIdSchema.default("brand"),
-		size: strokeSizeSchema.default(BOARD_ARROW_STROKE_SIZE),
-		arrowStart: z.boolean().default(false),
-		arrowEnd: z.boolean().default(true),
-		label: z.string().default("")
-	}).strict(),
-	frame: z.object({
-		...commonData,
-		label: z.string().default("Frame"),
-		color: BoardColorIdSchema.default("neutral")
-	}).strict(),
-	image: z.object({
-		...commonData,
-		crop: z.object({
-			x: z.number().finite().min(0).max(1),
-			y: z.number().finite().min(0).max(1),
-			w: z.number().finite().min(0).max(1),
-			h: z.number().finite().min(0).max(1)
-		}).strict().optional()
-	}).strict(),
-	video: z.object(commonData).strict(),
-	audio: z.object(commonData).strict(),
-	file: z.object(commonData).strict(),
-	task: z.object({
-		...commonData,
-		taskRunId: z.string().min(1)
-	}).strict()
-};
-const fileViewSchema = z.object({
-	title: z.string().optional(),
-	mimeType: z.string().optional(),
-	size: z.number().finite().nonnegative().optional(),
-	mtimeMs: z.number().finite().nonnegative().optional(),
-	excerpt: z.string().optional(),
-	coverPath: z.string().optional(),
-	coverUrl: z.string().url().optional()
-}).strict();
-const taskViewSchema = BoardTaskSnapshotSchema;
-const emptyViewSchema = z.object({}).strict();
-const viewSchemas = {
-	image: mediaViewSchema,
-	video: mediaViewSchema,
-	audio: audioViewSchema,
-	file: fileViewSchema,
-	task: taskViewSchema,
-	text: emptyViewSchema,
-	geo: emptyViewSchema,
-	draw: emptyViewSchema,
-	arrow: emptyViewSchema,
-	frame: emptyViewSchema
-};
-const nodeEnvelopeSchema = z.object({
-	nodeId: z.string().min(1).max(160),
-	type: z.string().min(1).max(40),
-	parentId: z.string().min(1).max(160).nullable(),
-	orderKey: z.string().max(4096).nullable(),
-	x: z.number().finite(),
-	y: z.number().finite(),
-	width: z.number().finite().positive(),
-	height: z.number().finite().positive(),
-	rotation: z.number().finite(),
-	refKind: z.string().max(40).nullable(),
-	refPath: z.string().max(4096).nullable(),
-	refUrl: z.string().max(4096).nullable(),
-	view: z.record(z.string(), z.unknown()),
-	style: z.record(z.string(), z.unknown()),
-	data: z.record(z.string(), z.unknown())
-}).strict();
-function jsonSchema(schema) {
-	return z.toJSONSchema(schema);
-}
-const BOARD_NODE_CONTRACT = {
-	types: BOARD_NATIVE_NODE_TYPES,
-	colors: BOARD_COLOR_IDS,
-	geos: BOARD_GEO_KINDS,
-	coordinates: {
-		frame: "world",
-		drawPoints: "frame-local",
-		arrowEndpoints: "world"
-	},
-	references: {
-		nodeTypes: [
-			"image",
-			"video",
-			"audio",
-			"file"
-		],
-		kind: "space_file",
-		pathField: "refPath"
-	},
-	schemas: {
-		envelope: jsonSchema(nodeEnvelopeSchema),
-		data: Object.fromEntries(BOARD_NATIVE_NODE_TYPES.map((type) => [type, jsonSchema(dataSchemas[type])])),
-		view: Object.fromEntries(BOARD_NATIVE_NODE_TYPES.map((type) => [type, jsonSchema(viewSchemas[type])]))
-	}
-};
-function issueDiagnostic(issue, path) {
-	const fullPath = [path, ...issue.path].join(".");
-	const values = "values" in issue && Array.isArray(issue.values) ? issue.values.filter((value) => typeof value === "string") : void 0;
-	return {
-		severity: "error",
-		code: "INVALID_BOARD_NODE",
-		message: `${fullPath}: ${issue.message}`,
-		path: fullPath,
-		...values?.length ? { allowedValues: values } : {}
-	};
-}
-function drawGeometryDiagnostic(node, data, path) {
-	let minX = Number.POSITIVE_INFINITY;
-	let minY = Number.POSITIVE_INFINITY;
-	let maxX = Number.NEGATIVE_INFINITY;
-	let maxY = Number.NEGATIVE_INFINITY;
-	for (const point of data.points) {
-		const radius = Math.max(.5, data.size / 2 * (.5 + point.p));
-		minX = Math.min(minX, point.x - radius);
-		minY = Math.min(minY, point.y - radius);
-		maxX = Math.max(maxX, point.x + radius);
-		maxY = Math.max(maxY, point.y + radius);
-	}
-	const width = Math.max(1, maxX - minX);
-	const height = Math.max(1, maxY - minY);
-	const tolerance = Math.max(.01, node.width * 1e-6, node.height * 1e-6);
-	if (Math.abs(minX) <= tolerance && Math.abs(minY) <= tolerance && Math.abs(width - node.width) <= tolerance && Math.abs(height - node.height) <= tolerance) return null;
-	return {
-		severity: "error",
-		code: "INVALID_BOARD_GEOMETRY",
-		message: `${path}.data.points must use frame-local coordinates and match the node frame`,
-		path: `${path}.data.points`,
-		expected: "frame-local points with bounds matching width and height",
-		coordinateSpace: "frame-local"
-	};
-}
-function validateBoardNodeInput(node, path = "node") {
-	const envelopeResult = nodeEnvelopeSchema.safeParse(node);
-	if (!envelopeResult.success) return envelopeResult.error.issues.map((issue) => issueDiagnostic(issue, path));
-	if (typeof node.type !== "string" || !BOARD_NATIVE_NODE_TYPES.includes(node.type)) return [{
-		severity: "error",
-		code: "INVALID_BOARD_NODE",
-		message: `${path}.type is not supported`,
-		path: `${path}.type`,
-		expected: "BoardNativeNodeType",
-		received: node.type,
-		allowedValues: BOARD_NATIVE_NODE_TYPES
-	}];
-	const type = node.type;
-	const dataResult = dataSchemas[type].safeParse(node.data ?? {});
-	if (!dataResult.success) return dataResult.error.issues.map((issue) => issueDiagnostic(issue, `${path}.data`));
-	const viewResult = viewSchemas[type].safeParse(node.view ?? {});
-	if (!viewResult.success) return viewResult.error.issues.map((issue) => issueDiagnostic(issue, `${path}.view`));
-	if (type === "image" || type === "video" || type === "audio" || type === "file") {
-		if (node.refKind !== "space_file" || typeof node.refPath !== "string" || !node.refPath) return [{
-			severity: "error",
-			code: "INVALID_BOARD_NODE",
-			message: `${path} requires a space file reference`,
-			path: `${path}.refPath`,
-			expected: "non-empty refPath with refKind space_file"
-		}];
-	}
-	if (type === "draw") {
-		const diagnostic = drawGeometryDiagnostic(node, dataResult.data, path);
-		return diagnostic ? [diagnostic] : [];
-	}
-	if (type === "arrow") {
-		const data = dataResult.data;
-		const inside = (point) => point.x >= node.x && point.x <= node.x + node.width && point.y >= node.y && point.y <= node.y + node.height;
-		if (!inside(data.start) || !inside(data.end)) return [{
-			severity: "error",
-			code: "INVALID_BOARD_GEOMETRY",
-			message: `${path}.data endpoints must be covered by the node frame`,
-			path: `${path}.data`,
-			expected: "world-space endpoints inside the node frame",
-			coordinateSpace: "world"
-		}];
-	}
-	return [];
-}
-const BoardContentKindSchema = z.enum([
-	"text",
-	"image",
-	"video",
-	"audio",
-	"file",
-	"json",
-	"collection"
-]);
-const BoardPortSchema = z.object({
-	id: z.string().min(1).max(120),
-	kind: BoardContentKindSchema,
-	role: z.string().min(1).max(80).optional(),
-	required: z.boolean().optional(),
-	multiple: z.boolean().optional(),
-	maxItems: z.number().int().positive().optional()
-}).strict();
-z.object({
-	inputs: z.array(BoardPortSchema),
-	outputs: z.array(BoardPortSchema)
-}).strict();
-//#endregion
-//#region ../protocol/dist/realtime/board-awareness.js
-const idSchema = z.string().min(1).max(160);
-const finiteSchema = z.number().finite();
-const BoardAwarenessPointSchema = z.object({
-	x: finiteSchema,
-	y: finiteSchema
-});
-const BoardAwarenessDrawPointSchema = BoardAwarenessPointSchema.extend({ p: finiteSchema.min(0).max(1) });
-const BoardAwarenessFrameSchema = z.object({
-	x: finiteSchema,
-	y: finiteSchema,
-	width: finiteSchema.positive(),
-	height: finiteSchema.positive(),
-	rotation: finiteSchema
-});
-const BoardAwarenessNodePreviewSchema = z.object({
-	nodeId: idSchema,
-	frame: BoardAwarenessFrameSchema,
-	/** Live endpoints of a free arrow being dragged. */
-	arrow: z.object({
-		start: BoardAwarenessPointSchema,
-		end: BoardAwarenessPointSchema,
-		bend: finiteSchema
-	}).optional()
-});
-const BoardAwarenessStateUpdateSchema = z.object({
-	type: z.literal("state"),
-	client: z.object({ formFactor: z.enum(["desktop", "mobile"]) }).optional(),
-	cursor: BoardAwarenessPointSchema.extend({ pointerType: z.enum([
-		"mouse",
-		"pen",
-		"touch"
-	]) }).nullable(),
-	tool: z.string().min(1).max(40),
-	selection: z.object({
-		ids: z.array(idSchema).max(64),
-		count: z.number().int().nonnegative().max(5e4),
-		bounds: BoardAwarenessFrameSchema.nullable()
-	}),
-	editingId: idSchema.nullable()
-});
-const BoardAwarenessGestureSchema = z.discriminatedUnion("kind", [
-	z.object({
-		kind: z.literal("draw"),
-		id: idSchema,
-		nodeId: idSchema,
-		color: z.string().min(1).max(64),
-		size: finiteSchema.positive().max(256),
-		from: z.number().int().nonnegative().max(1e5),
-		points: z.array(BoardAwarenessDrawPointSchema).min(1).max(64)
-	}),
-	z.object({
-		kind: z.literal("arrow"),
-		id: idSchema,
-		nodeId: idSchema,
-		start: BoardAwarenessPointSchema,
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		size: finiteSchema.positive().max(256).default(BOARD_ARROW_STROKE_SIZE)
-	}),
+		type: z.literal("connection.create"),
+		connection: BoardConnectionInputSchema
+	}).strict(),
 	z.object({
-		kind: z.literal("box"),
-		id: idSchema,
-		nodeId: idSchema,
-		shape: z.enum(["geo", "frame"]),
-		start: BoardAwarenessPointSchema,
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		geo: z.string().min(1).max(40)
-	}),
+		type: z.literal("connection.patch"),
+		connectionId: idSchema,
+		patch: BoardConnectionPatchSchema
+	}).strict(),
 	z.object({
-		kind: z.literal("connection"),
-		id: idSchema,
-		sourceNodeId: idSchema,
-		targetNodeId: idSchema.nullable(),
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		size: finiteSchema.positive().max(256).default(BOARD_CONNECTION_STROKE_SIZE)
-	}),
+		type: z.literal("connection.delete"),
+		connectionId: idSchema
+	}).strict(),
 	z.object({
-		kind: z.literal("transform"),
-		id: idSchema,
-		mode: z.enum([
-			"translate",
-			"resize",
-			"rotate",
-			"arrow",
-			"connection"
-		]),
-		nodes: z.array(BoardAwarenessNodePreviewSchema).max(64),
-		bounds: BoardAwarenessFrameSchema.nullable()
-	})
-]);
-const BoardAwarenessUpdateSchema = z.discriminatedUnion("type", [
-	BoardAwarenessStateUpdateSchema,
+		type: z.literal("effect.apply"),
+		effect: BoardEffectCommandInputSchema
+	}).strict(),
 	z.object({
-		type: z.literal("gesture"),
-		gesture: BoardAwarenessGestureSchema
-	}),
+		type: z.literal("effect.delete"),
+		effectId: idSchema
+	}).strict(),
 	z.object({
-		type: z.literal("gesture.end"),
-		gestureId: idSchema,
-		resultingNodeIds: z.array(idSchema).max(64)
-	}),
+		type: z.literal("composition.apply"),
+		composition: BoardCompositionCommandInputSchema
+	}).strict(),
 	z.object({
-		type: z.literal("gesture.cancel"),
-		gestureId: idSchema
-	})
-]);
-const BoardAwarenessClientPayloadSchema = z.object({
-	spaceId: z.string().uuid(),
-	boardId: z.string().uuid(),
-	seq: z.number().int().nonnegative(),
-	update: BoardAwarenessUpdateSchema
-});
-//#endregion
-//#region ../protocol/dist/public-identifiers.js
-const USERNAME_PATTERN = /^(?!-)(?!.*--)[a-z0-9-]{1,39}(?<!-)$/;
-const SPACE_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9_-]{0,78}[a-z0-9])?$/;
-/**
-* Platform-owned path segments that must not be newly assigned to public
-* identities. Existing stored values remain readable through parse helpers.
-*/
-const RESERVED_PLATFORM_PATH_SEGMENTS = Object.freeze([
-	"admin",
-	"api",
-	"assets",
-	"auth",
-	"callback",
-	"changelog",
-	"docs",
-	"explore",
-	"invite",
-	"landing",
-	"login",
-	"logout",
-	"new",
-	"org",
-	"pricing",
-	"pwa",
-	"referrals",
-	"sessions",
-	"settings",
-	"spaces",
-	"static",
-	"teams",
-	"trending",
-	"u",
-	"user",
-	"users",
-	"work-auth"
+		type: z.literal("composition.delete"),
+		compositionId: idSchema
+	}).strict()
 ]);
-new Set(RESERVED_PLATFORM_PATH_SEGMENTS);
-[...RESERVED_PLATFORM_PATH_SEGMENTS];
-function parseUsername(value) {
-	if (value === null || value === void 0) return null;
-	const normalized = value.trim().toLowerCase();
-	return USERNAME_PATTERN.test(normalized) ? normalized : null;
-}
-function parseSpaceSlug(value) {
-	if (value === null || value === void 0) return null;
-	const normalized = value.trim();
-	return SPACE_SLUG_PATTERN.test(normalized) ? normalized : null;
-}
+const BoardSemanticMutationSchema = z.object({
+	mutationId: idSchema,
+	baseVersion: z.number().int().nonnegative(),
+	clientId: idSchema.optional(),
+	undoGroupId: idSchema.optional(),
+	/** Validate (including server-side reference checks) without writing. */
+	dryRun: z.boolean().default(false),
+	commands: z.array(BoardSemanticCommandSchema).min(1).max(5e4)
+}).strict();
+z.object({
+	include: z.array(z.enum([
+		"items",
+		"connections",
+		"effects",
+		"compositions",
+		"playback"
+	])).optional(),
+	itemIds: z.array(idSchema).max(5e4).optional(),
+	connectionIds: z.array(idSchema).max(5e4).optional(),
+	effectIds: z.array(idSchema).max(5e4).optional(),
+	compositionIds: z.array(idSchema).max(5e4).optional(),
+	viewport: z.object({
+		x: finiteSchema,
+		y: finiteSchema,
+		width: finiteSchema.positive(),
+		height: finiteSchema.positive()
+	}).optional()
+}).strict();
 //#endregion
-//#region ../protocol/dist/ui-command.js
+//#region ../protocol/dist/desktop-command.js
 /**
-* Lets an agent drive the Cohub frontend that originated the work. Routing comes
+* Lets an agent drive the Cohub desktop that originated the app. Routing comes
 * from request provenance, never a caller-supplied target, so a command only
 * reaches the actor's own instances.
+*
+* The canonical command is `desktop.open`. The legacy `preview.show` shape is
+* accepted on input and normalized, so older clients keep working, but commands
+* are always stored and dispatched in the canonical form.
 */
-const UI_COMMAND_VERSION = 1;
+const DESKTOP_COMMAND_VERSION = 1;
 /** Persisted and broadcast, so every field is capped; MAX_BYTES bounds the whole. */
-const UI_COMMAND_PAYLOAD_MAX_BYTES = 32 * 1024;
-const UI_COMMAND_MAX_BYTES = 40 * 1024;
-const UI_COMMAND_LAUNCH_MAX_LENGTH = 2048;
-const UI_COMMAND_DEFAULT_TIMEOUT_MS = 600 * 1e3;
-const UI_COMMAND_MAX_TIMEOUT_MS = 720 * 60 * 1e3;
-const UI_COMMAND_SETTLEMENT_GRACE_SECONDS = 600;
+const DESKTOP_COMMAND_PAYLOAD_MAX_BYTES = 32 * 1024;
+const DESKTOP_COMMAND_MAX_BYTES = 40 * 1024;
+const DESKTOP_COMMAND_LAUNCH_MAX_LENGTH = 2048;
+const DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS = 600 * 1e3;
+const DESKTOP_COMMAND_MAX_TIMEOUT_MS = 720 * 60 * 1e3;
+const DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS = 600;
 /** Keeps pending commands reportable for the full wait window plus settlement grace. */
-const UI_COMMAND_PENDING_TTL_SECONDS = 43800;
-const UI_COMMAND_TERMINAL_TTL_SECONDS = 1800;
-const UI_COMMAND_TERMINAL_STATUSES = [
+const DESKTOP_COMMAND_PENDING_TTL_SECONDS = 43800;
+const DESKTOP_COMMAND_TERMINAL_TTL_SECONDS = 1800;
+const DESKTOP_COMMAND_TERMINAL_STATUSES = [
 	"applied",
 	"no_active_client",
-	"ui_host_unavailable",
+	"desktop_host_unavailable",
 	"rejected",
 	"unsupported",
 	"timeout"
 ];
-const isTerminalUiCommandStatus = (status) => UI_COMMAND_TERMINAL_STATUSES.includes(status);
+const isTerminalDesktopCommandStatus = (status) => DESKTOP_COMMAND_TERMINAL_STATUSES.includes(status);
 const METHOD_RE = /^[A-Za-z][A-Za-z0-9_.:-]{0,63}$/;
-const isUiSurfaceMethod = (value) => typeof value === "string" && METHOD_RE.test(value);
-const UI_COMMAND_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
-const parseUiCommandId = (value) => {
+const isDesktopCallMethod = (value) => typeof value === "string" && METHOD_RE.test(value);
+const DESKTOP_COMMAND_ID_RE = /^[A-Za-z0-9_-]{1,64}$/;
+const parseDesktopCommandId = (value) => {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
-	return UI_COMMAND_ID_RE.test(trimmed) ? trimmed : null;
+	return DESKTOP_COMMAND_ID_RE.test(trimmed) ? trimmed : null;
 };
-const isRecord$2 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
 const asTrimmed = (value) => {
 	if (typeof value !== "string") return null;
 	const trimmed = value.trim();
 	return trimmed ? trimmed : null;
 };
 const parseLaunch = (value) => {
-	if (!isRecord$2(value)) return void 0;
+	if (!isRecord$1(value)) return void 0;
 	const search = asTrimmed(value.search);
 	const hash = asTrimmed(value.hash);
 	if (!search && !hash) return void 0;
@@ -2402,7 +1350,7 @@ const parseLaunch = (value) => {
 		...hash ? { hash: hash.startsWith("#") ? hash : `#${hash}` } : {}
 	};
 };
-const measureUiCommandPayload = (value) => {
+const measureDesktopCommandPayload = (value) => {
 	if (value === void 0) return 0;
 	try {
 		return new TextEncoder().encode(JSON.stringify(value) ?? "").length;
@@ -2410,118 +1358,131 @@ const measureUiCommandPayload = (value) => {
 		return null;
 	}
 };
-const parseUiCommand = (input) => {
-	if (!isRecord$2(input)) return {
+/**
+* Parse a desktop command from untrusted input.
+*
+* Accepts both the canonical `desktop.open` shape (`target` / `call`) and the
+* legacy `preview.show` shape (`preview` / `request`); the result is always
+* canonical so every later stage handles a single form.
+*/
+const parseDesktopCommand = (input) => {
+	if (!isRecord$1(input)) return {
 		command: null,
 		error: "command must be an object"
 	};
-	if (input.type !== "preview.show") return {
+	const legacy = input.type === "preview.show";
+	if (input.type !== "desktop.open" && !legacy) return {
 		command: null,
-		error: "command.type must be one of: preview.show"
+		error: "command.type must be one of: desktop.open"
 	};
-	const preview = input.preview;
-	if (!isRecord$2(preview)) return {
+	const target = isRecord$1(input.target) ? input.target : isRecord$1(input.preview) ? input.preview : null;
+	if (!target) return {
 		command: null,
-		error: "command.preview is required"
+		error: "command.target is required"
 	};
-	if (preview.kind !== "work" && preview.kind !== "file") return {
+	const kind = target.kind === "app" || legacy && target.kind === "work" ? "app" : target.kind === "file" ? "file" : null;
+	if (!kind) return {
 		command: null,
-		error: "command.preview.kind must be one of: work, file"
+		error: "command.target.kind must be one of: app, file"
 	};
-	if (preview.kind === "file") {
-		const path = asTrimmed(preview.path);
+	if (kind === "file") {
+		const path = asTrimmed(target.path);
 		if (!path) return {
 			command: null,
-			error: "command.preview.path is required"
+			error: "command.target.path is required"
 		};
 		if (path.length > 2048 || path.startsWith("/") || path.includes("\0") || path.includes("\\") || path.split("/").some((segment) => segment === "..")) return {
 			command: null,
-			error: "command.preview.path must be a relative Space file path"
+			error: "command.target.path must be a relative Space file path"
 		};
-		const command = {
-			type: "preview.show",
-			preview: {
-				kind: "file",
-				path
-			}
+		if (input.call !== void 0 && input.call !== null) return {
+			command: null,
+			error: "command.call is only supported for app targets"
 		};
-		if (input.request !== void 0 && input.request !== null) return {
+		if (legacy && input.request !== void 0 && input.request !== null) return {
 			command: null,
-			error: "command.request is only supported for Work previews"
+			error: "command.call is only supported for app targets"
 		};
 		return {
-			command,
+			command: {
+				type: "desktop.open",
+				target: {
+					kind: "file",
+					path
+				}
+			},
 			error: null
 		};
 	}
-	const workId = asTrimmed(preview.workId);
-	if (!workId) return {
+	const appId = asTrimmed(target.appId ?? target.workId);
+	if (!appId) return {
 		command: null,
-		error: "command.preview.workId is required"
+		error: "command.target.appId is required"
 	};
-	if (!isUuid(workId)) return {
+	if (!isUuid(appId)) return {
 		command: null,
-		error: "command.preview.workId must be a Work id"
+		error: "command.target.appId must be an App id"
 	};
-	const label = asTrimmed(preview.label);
+	const label = asTrimmed(target.label);
 	if (label && label.length > 200) return {
 		command: null,
-		error: `command.preview.label exceeds 200 characters`
+		error: `command.target.label exceeds 200 characters`
 	};
-	const launch = parseLaunch(preview.launch);
+	const launch = parseLaunch(target.launch);
 	if (launch) {
 		for (const [field, value] of [["search", launch.search], ["hash", launch.hash]]) if (value && value.length > 2048) return {
 			command: null,
-			error: `command.preview.launch.${field} exceeds ${UI_COMMAND_LAUNCH_MAX_LENGTH} characters`
+			error: `command.target.launch.${field} exceeds ${DESKTOP_COMMAND_LAUNCH_MAX_LENGTH} characters`
 		};
 	}
-	let request;
-	if (input.request !== void 0 && input.request !== null) {
-		if (!isRecord$2(input.request)) return {
+	const callSource = input.call !== void 0 ? input.call : input.request;
+	let call;
+	if (callSource !== void 0 && callSource !== null) {
+		if (!isRecord$1(callSource)) return {
 			command: null,
-			error: "command.request must be an object"
+			error: "command.call must be an object"
 		};
-		const method = asTrimmed(input.request.method);
+		const method = asTrimmed(callSource.method);
 		if (!method) return {
 			command: null,
-			error: "command.request.method is required"
+			error: "command.call.method is required"
 		};
-		if (!isUiSurfaceMethod(method)) return {
+		if (!isDesktopCallMethod(method)) return {
 			command: null,
-			error: "command.request.method has an unsupported format"
+			error: "command.call.method has an unsupported format"
 		};
-		const size = measureUiCommandPayload(input.request.input);
+		const size = measureDesktopCommandPayload(callSource.input);
 		if (size === null) return {
 			command: null,
-			error: "command.request.input must be JSON-serializable"
+			error: "command.call.input must be JSON-serializable"
 		};
 		if (size > 32768) return {
 			command: null,
-			error: `command.request.input exceeds ${UI_COMMAND_PAYLOAD_MAX_BYTES} bytes`
+			error: `command.call.input exceeds ${DESKTOP_COMMAND_PAYLOAD_MAX_BYTES} bytes`
 		};
-		request = {
+		call = {
 			method,
-			...input.request.input === void 0 ? {} : { input: input.request.input }
+			...callSource.input === void 0 ? {} : { input: callSource.input }
 		};
 	}
 	const command = {
-		type: "preview.show",
-		preview: {
-			kind: "work",
-			workId,
+		type: "desktop.open",
+		target: {
+			kind: "app",
+			appId,
 			...label ? { label } : {},
 			...launch ? { launch } : {}
 		},
-		...request ? { request } : {}
+		...call ? { call } : {}
 	};
-	const totalSize = measureUiCommandPayload(command);
+	const totalSize = measureDesktopCommandPayload(command);
 	if (totalSize === null) return {
 		command: null,
 		error: "command must be JSON-serializable"
 	};
 	if (totalSize > 40960) return {
 		command: null,
-		error: `command exceeds ${UI_COMMAND_MAX_BYTES} bytes`
+		error: `command exceeds ${DESKTOP_COMMAND_MAX_BYTES} bytes`
 	};
 	return {
 		command,
@@ -2529,123 +1490,6 @@ const parseUiCommand = (input) => {
 	};
 };
 //#endregion
-//#region ../protocol/dist/work-surface.js
-const WORK_SURFACE_PROTOCOL = "cohub.surface";
-const WORK_SURFACE_READY_TIMEOUT_MS = 1e4;
-const WORK_SURFACE_REQUEST_TIMEOUT_MS = 15e3;
-const WORK_COMPOSER_CHIP_KEY_MAX_LENGTH = 80;
-const WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH = 120;
-const WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES = 32 * 1024;
-const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
-const isSurfaceEnvelope = (value) => isRecord$1(value) && value.protocol === "cohub.surface" && value.version === 1;
-const parseWorkSurfaceReady = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "ready") return null;
-	const methods = Array.isArray(value.methods) ? value.methods.filter((method) => typeof method === "string" && Boolean(method)) : [];
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "ready",
-		methods
-	};
-};
-const parseWorkSurfaceResponse = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "response") return null;
-	if (typeof value.requestId !== "string" || !value.requestId) return null;
-	const error = isRecord$1(value.error) ? {
-		code: typeof value.error.code === "string" && value.error.code ? value.error.code : "surface_error",
-		message: typeof value.error.message === "string" ? value.error.message : "Work surface call failed"
-	} : void 0;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "response",
-		requestId: value.requestId,
-		ok: value.ok === true,
-		...error ? { error } : {}
-	};
-};
-const parseComposerChipKey = (value) => {
-	if (typeof value !== "string") return null;
-	const key = value.trim();
-	if (!key || key.length > 80) return null;
-	return key;
-};
-const parseWorkComposerChipSet = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "composer.chip.set" || !isRecord$1(value.chip)) return null;
-	const key = parseComposerChipKey(value.chip.key);
-	if (!key || typeof value.chip.label !== "string" || typeof value.chip.content !== "string") return null;
-	const label = value.chip.label.trim();
-	if (!label || label.length > 120) return null;
-	if (!value.chip.content.trim()) return null;
-	if (new TextEncoder().encode(value.chip.content).length > 32768) return null;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "composer.chip.set",
-		chip: {
-			key,
-			label,
-			content: value.chip.content
-		}
-	};
-};
-const parseWorkComposerChipClear = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "composer.chip.clear") return null;
-	const key = parseComposerChipKey(value.key);
-	return key ? {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "composer.chip.clear",
-		key
-	} : null;
-};
-const parseWorkSurfaceRequest = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "request") return null;
-	if (typeof value.requestId !== "string" || !value.requestId) return null;
-	if (typeof value.method !== "string" || !value.method) return null;
-	const commandId = parseUiCommandId(value.commandId);
-	if (!commandId) return null;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "request",
-		requestId: value.requestId,
-		method: value.method,
-		...value.input === void 0 ? {} : { input: value.input },
-		commandId
-	};
-};
-const buildWorkSurfaceReady = (methods) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "ready",
-	methods: [...methods]
-});
-const buildWorkSurfaceRequest = (input) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "request",
-	...input
-});
-const buildWorkSurfaceResponse = (input) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "response",
-	...input
-});
-const buildWorkComposerChipSet = (chip) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "composer.chip.set",
-	chip
-});
-const buildWorkComposerChipClear = (key) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "composer.chip.clear",
-	key
-});
-//#endregion
 //#region src/realtime.ts
 function ensureRealtimeConnected(websocketClient) {
 	if (websocketClient.state === "open" || websocketClient.state === "connecting" || websocketClient.state === "reconnecting") return;
@@ -3664,26 +2508,6 @@ const getFilenameFromContentDisposition = (value) => {
 	return value.match(/filename="?([^";]+)"?/i)?.[1] ?? null;
 };
 /**
-* 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.
-*/
-var BoardTransactionError = class extends Error {
-	status;
-	code;
-	body;
-	constructor(message, status, code, body, options) {
-		super(message, options);
-		this.status = status;
-		this.code = code;
-		this.body = body;
-		this.name = "BoardTransactionError";
-	}
-	get isVersionConflict() {
-		return this.code === "VERSION_CONFLICT";
-	}
-};
-/**
 * Identifier for a client-authored Board entity (connection id, transaction id).
 *
 * `crypto.randomUUID` is used where available and falls back to a random string
@@ -4298,7 +3122,7 @@ var SpaceEventsApi = class {
 				handler(event);
 				return;
 			}
-			if (type === "board.transaction.applied" && event.type === "board.transaction.applied") {
+			if (type === "board.changed" && event.type === "board.changed") {
 				handler(event);
 				return;
 			}
@@ -4306,7 +3130,7 @@ var SpaceEventsApi = class {
 				handler(event);
 				return;
 			}
-			if (type === "work.version.published" && event.type === "work.version.published") {
+			if (type === "app.version.published" && event.type === "app.version.published") {
 				handler(event);
 				return;
 			}
@@ -4656,10 +3480,10 @@ var BoardRealtimeClient = class {
 		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) {
-				const transactionEvent = event;
-				handlers.event?.(transactionEvent);
-				handlers.transaction?.(transactionEvent);
+			if (event.type === "board.changed" && event.payload.boardId === this.boardId) {
+				const changedEvent = event;
+				handlers.event?.(changedEvent);
+				handlers.changed?.(changedEvent);
 			}
 			if (event.type === "board.awareness.updated" && event.payload.boardId === this.boardId) {
 				const awarenessEvent = event;
@@ -4680,7 +3504,7 @@ var BoardRealtimeClient = class {
 		};
 	}
 	on(type, handler) {
-		if (type === "transaction") return this.subscribe({ transaction: handler });
+		if (type === "changed") return this.subscribe({ changed: handler });
 		if (type === "awareness") return this.subscribe({ awareness: handler });
 		return this.subscribe({ playback: handler });
 	}
@@ -4698,67 +3522,20 @@ var BoardClient = class {
 		this.boards = new SpaceBoardsApi(transport, spaceId, websocketClient);
 		this.realtime = new BoardRealtimeClient(websocketClient, spaceId, id);
 	}
-	inspect(input = {}, customFetch) {
-		return this.boards.inspect(this.id, input, customFetch);
-	}
 	capabilities(customFetch) {
 		return this.boards.capabilities(this.id, customFetch);
 	}
 	summary(customFetch) {
 		return this.boards.summary(this.id, customFetch);
 	}
-	authoring(customFetch) {
-		return this.boards.authoring(this.id, customFetch);
+	authoring(input = {}, customFetch) {
+		return this.boards.authoring(this.id, input, customFetch);
 	}
 	mutateSemantic(input) {
 		return this.boards.mutateSemantic(this.id, {
 			...input,
-			mutationId: input.mutationId ?? randomBoardId()
-		});
-	}
-	async mutate(input) {
-		const retries = input.retries ?? 1;
-		if (!Number.isSafeInteger(retries) || retries < 0 || retries > 3) throw new RangeError("Board mutation retries must be an integer from 0 to 3");
-		for (let attempt = 0;; attempt += 1) {
-			const current = await this.inspect({ include: input.include ?? [] });
-			const operations = await input.build(current);
-			if (operations.length === 0) return {
-				mutationId: randomBoardId(),
-				status: "validated",
-				replayed: false,
-				board: {
-					id: current.board.id,
-					version: current.board.version
-				},
-				changed: {
-					items: [],
-					connections: [],
-					effects: [],
-					compositions: [],
-					board: false
-				}
-			};
-			try {
-				return await this.apply({
-					txId: randomBoardId(),
-					baseVersion: current.board.version,
-					operations
-				});
-			} catch (cause) {
-				if (!(cause instanceof BoardTransactionError) || !cause.isVersionConflict || attempt >= retries) throw cause;
-			}
-		}
-	}
-	validate(transaction) {
-		return this.boards.validate({
-			...transaction,
-			boardId: this.id
-		});
-	}
-	apply(transaction) {
-		return this.boards.apply({
-			...transaction,
-			boardId: this.id
+			mutationId: input.mutationId ?? randomBoardId(),
+			dryRun: input.dryRun ?? false
 		});
 	}
 	updateAwareness(seq, update) {
@@ -4770,91 +3547,6 @@ var BoardClient = class {
 			update
 		});
 	}
-	playback(command) {
-		return this.boards.playback(this.id, command);
-	}
-	/**
-	* 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.
-	*/
-	async connections(customFetch) {
-		return (await this.boards.inspect(this.id, { include: ["connections"] }, customFetch)).connections;
-	}
-	/**
-	* 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.
-	*/
-	async connectionsForNode(nodeId, customFetch) {
-		return (await this.connections(customFetch)).filter((connection) => connection.source.nodeId === nodeId || connection.target.nodeId === nodeId);
-	}
-	/**
-	* 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) {
-		const connection = createBoardConnection({
-			id: input.id ?? randomBoardId(),
-			sourceNodeId: input.sourceNodeId,
-			targetNodeId: input.targetNodeId,
-			...input.relation === void 0 ? {} : { relation: input.relation },
-			...input.direction === void 0 ? {} : { direction: input.direction },
-			...input.label === void 0 ? {} : { label: input.label },
-			...input.sourcePortId === void 0 ? {} : { sourcePortId: input.sourcePortId },
-			...input.targetPortId === void 0 ? {} : { targetPortId: input.targetPortId }
-		});
-		return this.apply({
-			txId: input.txId ?? randomBoardId(),
-			baseVersion: input.baseVersion,
-			operations: [{
-				type: "connection.create",
-				payload: { connection }
-			}]
-		});
-	}
-	/** Remove a connection. The nodes it joined are untouched. */
-	disconnect(input) {
-		return this.apply({
-			txId: input.txId ?? randomBoardId(),
-			baseVersion: input.baseVersion,
-			operations: [{
-				type: "connection.delete",
-				payload: { connectionId: input.connectionId }
-			}]
-		});
-	}
-	/**
-	* 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) {
-		const incident = input.connections.filter((connection) => connection.source.nodeId === input.nodeId || connection.target.nodeId === input.nodeId);
-		return this.apply({
-			txId: input.txId ?? randomBoardId(),
-			baseVersion: input.baseVersion,
-			operations: [...incident.map((connection) => ({
-				type: "connection.delete",
-				payload: {
-					connectionId: connection.id,
-					reason: "node-cascade"
-				}
-			})), {
-				type: "node.delete",
-				payload: { nodeId: input.nodeId }
-			}]
-		});
-	}
 	play(command) {
 		return this.boards.play(this.id, command);
 	}
@@ -4871,7 +3563,7 @@ var BoardClient = class {
 		return this.realtime.subscribe(handlers);
 	}
 	on(type, handler) {
-		if (type === "transaction") return this.realtime.on("transaction", handler);
+		if (type === "changed") return this.realtime.on("changed", handler);
 		if (type === "awareness") return this.realtime.on("awareness", handler);
 		return this.realtime.on("playback", handler);
 	}
@@ -4888,7 +3580,7 @@ var SpaceBoardsApi = class {
 	byId(boardId) {
 		return new BoardClient(this.spaceId, boardId, this.transport, this.websocketClient);
 	}
-	create(input) {
+	async create(input) {
 		for (const item of input.items ?? []) BoardAuthoringItemSchema.parse(item);
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards`, {
 			method: "POST",
@@ -4896,15 +3588,19 @@ var SpaceBoardsApi = class {
 			body: JSON.stringify(input)
 		});
 	}
-	inspect(boardId, input = {}, customFetch) {
+	authoring(boardId, input = {}, customFetch) {
 		const params = new URLSearchParams();
-		for (const section of input.include ?? []) params.append("include", section);
+		if (input.include) {
+			for (const section of input.include) params.append("include", section);
+			if (input.include.length === 0) params.set("include", "");
+		}
+		if (input.itemIds?.length) params.set("itemIds", input.itemIds.join(","));
+		if (input.connectionIds?.length) params.set("connectionIds", input.connectionIds.join(","));
+		if (input.effectIds?.length) params.set("effectIds", input.effectIds.join(","));
+		if (input.compositionIds?.length) params.set("compositionIds", input.compositionIds.join(","));
 		if (input.viewport) params.set("viewport", JSON.stringify(input.viewport));
 		const query = params.toString();
-		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}${query ? `?${query}` : ""}`, { fetch: customFetch });
-	}
-	authoring(boardId, customFetch) {
-		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/authoring`, { fetch: customFetch });
+		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/authoring${query ? `?${query}` : ""}`, { fetch: customFetch });
 	}
 	mutateSemantic(boardId, mutation) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/mutations`, {
@@ -4919,25 +3615,6 @@ var SpaceBoardsApi = class {
 	capabilities(boardId, customFetch) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/capabilities`, { fetch: customFetch });
 	}
-	validate(transaction) {
-		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/validate`, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(transaction)
-		});
-	}
-	async apply(transaction) {
-		try {
-			return await this.transport.request(`/api/spaces/${this.spaceId}/boards/${transaction.boardId}/transactions`, {
-				method: "POST",
-				headers: { "Content-Type": "application/json" },
-				body: JSON.stringify(transaction)
-			});
-		} catch (cause) {
-			if (cause instanceof HttpError) throw new BoardTransactionError(cause.message, cause.status, cause.code ?? void 0, cause.body, { cause });
-			throw cause;
-		}
-	}
 	playback(boardId, command) {
 		return this.transport.request(`/api/spaces/${this.spaceId}/boards/${boardId}/playback`, {
 			method: "POST",
@@ -5340,79 +4017,6 @@ var TasksApi = class {
 	}
 };
 //#endregion
-//#region src/apis/ui-commands.ts
-const DEFAULT_POLL_INTERVAL_MS = 300;
-const resolveTimeoutMs = (timeoutMs) => {
-	const value = timeoutMs ?? 6e5;
-	if (!Number.isFinite(value) || value <= 0 || value > 432e5) throw new RangeError(`timeoutMs must be between 1 and ${UI_COMMAND_MAX_TIMEOUT_MS} milliseconds`);
-	return value;
-};
-const sleep = (ms, signal) => new Promise((resolve, reject) => {
-	if (signal?.aborted) {
-		reject(/* @__PURE__ */ new Error("aborted"));
-		return;
-	}
-	const timer = setTimeout(() => {
-		signal?.removeEventListener("abort", onAbort);
-		resolve();
-	}, ms);
-	const onAbort = () => {
-		clearTimeout(timer);
-		reject(/* @__PURE__ */ new Error("aborted"));
-	};
-	signal?.addEventListener("abort", onAbort, { once: true });
-});
-var UiCommandsApi = class {
-	transport;
-	constructor(transport) {
-		this.transport = transport;
-	}
-	create(input) {
-		return this.transport.request("/api/ui/commands", {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(input)
-		});
-	}
-	get(commandId) {
-		return this.transport.request(`/api/ui/commands/${encodeURIComponent(commandId)}`);
-	}
-	reportResult(commandId, input) {
-		return this.transport.request(`/api/ui/commands/${encodeURIComponent(commandId)}/result`, {
-			method: "POST",
-			headers: { "Content-Type": "application/json" },
-			body: JSON.stringify(input)
-		});
-	}
-	async run(input, options = {}) {
-		const { command } = await this.create(input);
-		if (isTerminalUiCommandStatus(command.status)) return command;
-		return this.wait(command.commandId, options);
-	}
-	async wait(commandId, options = {}) {
-		const timeoutMs = resolveTimeoutMs(options.timeoutMs);
-		const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
-		const deadline = Date.now() + timeoutMs;
-		let latest = (await this.get(commandId)).command;
-		while (!isTerminalUiCommandStatus(latest.status)) {
-			const remaining = deadline - Date.now();
-			if (remaining <= 0) break;
-			await sleep(Math.min(pollIntervalMs, remaining), options.signal);
-			latest = (await this.get(commandId)).command;
-		}
-		if (isTerminalUiCommandStatus(latest.status)) return latest;
-		return {
-			...latest,
-			status: "timeout",
-			error: {
-				code: "timeout",
-				message: "No Cohub frontend reported a result before the timeout."
-			},
-			settledAt: (/* @__PURE__ */ new Date()).toISOString()
-		};
-	}
-};
-//#endregion
 //#region src/apis/user.ts
 const usageDate = (value) => value instanceof Date ? value.toISOString() : value;
 var UserApi = class {
@@ -5540,131 +4144,208 @@ var ReferralsApi = class {
 	}
 };
 //#endregion
-//#region src/apis/works.ts
-var WorksApi = class {
+//#region src/apis/apps.ts
+var AppsApi = class {
 	transport;
 	constructor(transport) {
 		this.transport = transport;
 	}
 	listBySpace(spaceId) {
-		return this.transport.request(`/api/works/space/${spaceId}`);
+		return this.transport.request(`/api/apps/space/${spaceId}`);
 	}
 	get(id) {
-		return this.transport.request(`/api/works/${id}`);
+		return this.transport.request(`/api/apps/${id}`);
 	}
 	/**
-	* Loads a published work's metadata + owner info by id (public access model).
-	* Used by the standalone work auth broker page.
+	* Loads a published app's metadata + owner info by id (public access model).
+	* Used by the standalone app auth broker page.
 	*/
 	getPublicById(id) {
-		return this.transport.request(`/api/works/${id}/public`);
+		return this.transport.request(`/api/apps/${id}/public`);
 	}
-	getBySlug(username, spaceSlug, workSlug, options) {
-		return this.transport.request(`/api/works/by-slug/${encodeURIComponent(username)}/${encodeURIComponent(spaceSlug)}/${encodeURIComponent(workSlug)}`, options?.signal ? { signal: options.signal } : void 0);
+	getBySlug(username, spaceSlug, appSlug, options) {
+		return this.transport.request(`/api/apps/by-slug/${encodeURIComponent(username)}/${encodeURIComponent(spaceSlug)}/${encodeURIComponent(appSlug)}`, options?.signal ? { signal: options.signal } : void 0);
 	}
 	create(input) {
-		return this.transport.request("/api/works", {
+		return this.transport.request("/api/apps", {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
 	update(id, input) {
-		return this.transport.request(`/api/works/${id}`, {
+		return this.transport.request(`/api/apps/${id}`, {
 			method: "PATCH",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
 	delete(id) {
-		return this.transport.request(`/api/works/${id}`, { method: "DELETE" });
+		return this.transport.request(`/api/apps/${id}`, { method: "DELETE" });
 	}
-	getStats(workId) {
-		return this.transport.request(`/api/works/${workId}/stats`);
+	getStats(appId) {
+		return this.transport.request(`/api/apps/${appId}/stats`);
 	}
-	listPromotions(workId) {
-		return this.transport.request(`/api/works/${workId}/promotions`);
+	listPromotions(appId) {
+		return this.transport.request(`/api/apps/${appId}/promotions`);
 	}
-	createPromotion(workId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions`, {
+	createPromotion(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getPromotionStats(workId, promotionId) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/stats`);
+	getPromotionStats(appId, promotionId) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/stats`);
 	}
-	recordPromotionEvent(workId, promotionId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/events`, {
+	recordPromotionEvent(appId, promotionId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/events`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	recordPromotionRegistration(workId, promotionId, input) {
-		return this.transport.request(`/api/works/${workId}/promotions/${promotionId}/registration`, {
+	recordPromotionRegistration(appId, promotionId, input) {
+		return this.transport.request(`/api/apps/${appId}/promotions/${promotionId}/registration`, {
 			method: "POST",
 			headers: input ? { "Content-Type": "application/json" } : void 0,
 			body: input ? JSON.stringify(input) : void 0
 		});
 	}
-	listVersions(workId) {
-		return this.transport.request(`/api/works/${workId}/versions`);
+	listVersions(appId) {
+		return this.transport.request(`/api/apps/${appId}/versions`);
 	}
-	publishVersion(workId, input) {
-		return this.transport.request(`/api/works/${workId}/versions`, {
+	publishVersion(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/versions`, {
 			method: "POST",
 			headers: input ? { "Content-Type": "application/json" } : void 0,
 			body: input ? JSON.stringify(input) : void 0
 		});
 	}
-	createSession(workId) {
-		return this.transport.request(`/api/works/${workId}/session`, { method: "POST" });
+	createSession(appId) {
+		return this.transport.request(`/api/apps/${appId}/session`, { method: "POST" });
+	}
+	authorize(appId, input) {
+		return this.transport.request(`/api/apps/${appId}/authorize`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+	}
+};
+//#endregion
+//#region src/apis/desktop-commands.ts
+const DEFAULT_POLL_INTERVAL_MS = 300;
+const resolveTimeoutMs = (timeoutMs) => {
+	const value = timeoutMs ?? 6e5;
+	if (!Number.isFinite(value) || value <= 0 || value > 432e5) throw new RangeError(`timeoutMs must be between 1 and ${DESKTOP_COMMAND_MAX_TIMEOUT_MS} milliseconds`);
+	return value;
+};
+const sleep = (ms, signal) => new Promise((resolve, reject) => {
+	if (signal?.aborted) {
+		reject(/* @__PURE__ */ new Error("aborted"));
+		return;
+	}
+	const timer = setTimeout(() => {
+		signal?.removeEventListener("abort", onAbort);
+		resolve();
+	}, ms);
+	const onAbort = () => {
+		clearTimeout(timer);
+		reject(/* @__PURE__ */ new Error("aborted"));
+	};
+	signal?.addEventListener("abort", onAbort, { once: true });
+});
+var DesktopCommandsApi = class {
+	transport;
+	constructor(transport) {
+		this.transport = transport;
+	}
+	create(input) {
+		return this.transport.request("/api/desktop/commands", {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify(input)
+		});
+	}
+	get(commandId) {
+		return this.transport.request(`/api/desktop/commands/${encodeURIComponent(commandId)}`);
 	}
-	authorize(workId, input) {
-		return this.transport.request(`/api/works/${workId}/authorize`, {
+	reportResult(commandId, input) {
+		return this.transport.request(`/api/desktop/commands/${encodeURIComponent(commandId)}/result`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
+	async run(input, options = {}) {
+		const { command } = await this.create(input);
+		if (isTerminalDesktopCommandStatus(command.status)) return command;
+		return this.wait(command.commandId, options);
+	}
+	async wait(commandId, options = {}) {
+		const timeoutMs = resolveTimeoutMs(options.timeoutMs);
+		const pollIntervalMs = Math.max(50, options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS);
+		const deadline = Date.now() + timeoutMs;
+		let latest = (await this.get(commandId)).command;
+		while (!isTerminalDesktopCommandStatus(latest.status)) {
+			const remaining = deadline - Date.now();
+			if (remaining <= 0) break;
+			await sleep(Math.min(pollIntervalMs, remaining), options.signal);
+			latest = (await this.get(commandId)).command;
+		}
+		if (isTerminalDesktopCommandStatus(latest.status)) return latest;
+		return {
+			...latest,
+			status: "timeout",
+			error: {
+				code: "timeout",
+				message: "No Cohub desktop reported a result before the timeout."
+			},
+			settledAt: (/* @__PURE__ */ new Date()).toISOString()
+		};
+	}
 };
+/** @deprecated Use `DesktopCommandsApi`. */
+var UiCommandsApi = class extends DesktopCommandsApi {};
 //#endregion
-//#region src/apis/work-commerce.ts
-var WorkCommerceApi = class {
+//#region src/apis/app-commerce.ts
+var AppCommerceApi = class {
 	transport;
 	constructor(transport) {
 		this.transport = transport;
 	}
-	resolveProducts(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/products/resolve`, {
+	resolveProducts(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/products/resolve`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getEntitlements(workId) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/entitlements`);
+	getEntitlements(appId) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/entitlements`);
 	}
-	consumeCredits(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/credits/consume`, {
+	consumeCredits(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/credits/consume`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	purchase(workId, input) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/purchase`, {
+	purchase(appId, input) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/purchase`, {
 			method: "POST",
 			headers: { "Content-Type": "application/json" },
 			body: JSON.stringify(input)
 		});
 	}
-	getOrder(workId, orderId) {
-		return this.transport.request(`/api/works/${encodeURIComponent(workId)}/commerce/orders/${encodeURIComponent(orderId)}`);
+	getOrder(appId, orderId) {
+		return this.transport.request(`/api/apps/${encodeURIComponent(appId)}/commerce/orders/${encodeURIComponent(orderId)}`);
 	}
 };
+/** @deprecated Use `AppCommerceApi`. */
+var WorkCommerceApi = class extends AppCommerceApi {};
 //#endregion
 //#region src/http.ts
 var CohubHttpClient = class {
@@ -5684,9 +4365,21 @@ var CohubHttpClient = class {
 	cronJobs;
 	invite;
 	referrals;
-	works;
-	workCommerce;
-	ui;
+	apps;
+	appCommerce;
+	/** @deprecated Use `apps`. */
+	get works() {
+		return this.apps;
+	}
+	/** @deprecated Use `appCommerce`. */
+	get workCommerce() {
+		return this.appCommerce;
+	}
+	desktop;
+	/** @deprecated Use `desktop`. */
+	get ui() {
+		return this.desktop;
+	}
 	transport;
 	constructor(options = {}) {
 		const apiBaseUrl = resolveApiBaseUrl(options);
@@ -5707,9 +4400,9 @@ var CohubHttpClient = class {
 		this.cronJobs = new CronJobsApi(this.transport);
 		this.invite = new PublicInviteApi(this.transport);
 		this.referrals = new ReferralsApi(this.transport);
-		this.works = new WorksApi(this.transport);
-		this.workCommerce = new WorkCommerceApi(this.transport);
-		this.ui = new UiCommandsApi(this.transport);
+		this.apps = new AppsApi(this.transport);
+		this.appCommerce = new AppCommerceApi(this.transport);
+		this.desktop = new DesktopCommandsApi(this.transport);
 	}
 	space(spaceId) {
 		return new SpaceClient(spaceId, this.transport, null);
@@ -5717,4 +4410,4 @@ var CohubHttpClient = class {
 };
 const createHttpClient = (options) => new CohubHttpClient(options);
 //#endregion
-export { BOARD_GEO_KINDS as $, buildWorkComposerChipSet as A, UI_COMMAND_MAX_TIMEOUT_MS as B, ensureRealtimeConnected as C, SkillsApi as Ct, WORK_SURFACE_READY_TIMEOUT_MS as D, CronJobsApi as Dt, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH as E, GenerationsApi as Et, parseWorkComposerChipSet as F, UI_COMMAND_VERSION as G, UI_COMMAND_PENDING_TTL_SECONDS as H, parseWorkSurfaceReady as I, parseUiCommand as J, isTerminalUiCommandStatus as K, parseWorkSurfaceRequest as L, buildWorkSurfaceRequest as M, buildWorkSurfaceResponse as N, WORK_SURFACE_REQUEST_TIMEOUT_MS as O, ChannelsApi as Ot, parseWorkComposerChipClear as P, BOARD_COLOR_IDS as Q, parseWorkSurfaceResponse as R, createSessionPatchReducer as S, PublicAssetsApi as St, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH as T, ModelsApi as Tt, UI_COMMAND_SETTLEMENT_GRACE_SECONDS as U, UI_COMMAND_PAYLOAD_MAX_BYTES as V, UI_COMMAND_TERMINAL_TTL_SECONDS as W, parseUsername as X, parseSpaceSlug as Y, BoardAwarenessClientPayloadSchema as Z, buildSpacePath as _, BOARD_BUILTIN_CAPABILITIES as _t, ReferralsApi as a, BoardEffectSchema as at, parseAssistantMessageCommit as b, ReferencesApi as bt, UiCommandsApi as c, BoardAuthoringItemSchema as ct, BoardTransactionError as d, BOARD_ANIMATION_CHANNEL_CAPABILITIES as dt, BOARD_NATIVE_NODE_TYPES as et, SpaceClient as f, BoardCompositionInputSchema as ft, buildSpaceInvitePath as g, parseBoardCompositionInput as gt, PublicInviteApi as h, BoardTrackSchema as ht, WorksApi as i, validateBuiltinBoardClip as it, buildWorkSurfaceReady as j, buildWorkComposerChipClear as k, TasksApi as l, BoardItemPatchSchema as lt, SpacesApi as m, BoardProceduralClipSchema as mt, createHttpClient as n, validateBoardNodeInput as nt, UsersApi as o, BoardPlaybackPolicySchema as ot, SpacePublicFilesApi as p, BoardCompositionSchema as pt, isUiSurfaceMethod as q, WorkCommerceApi as r, estimateBuiltinBoardClipCost as rt, UserApi as s, parseBoardPlaybackPolicy as st, CohubHttpClient as t, BOARD_NODE_CONTRACT as tt, BoardClient as u, BOARD_ANIMATION_CHANNELS as ut, SessionGenerationStreamClient as v, DEFAULT_BOARD_RENDER_LIMITS as vt, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES as w, PromptsApi as wt, SessionPatchReducer as x, SearchApi as xt, createSessionGenerationStreamClient as y, SessionAccessApi as yt, UI_COMMAND_DEFAULT_TIMEOUT_MS as z };
+export { BOARD_BUILTIN_EFFECT_KINDS as $, DESKTOP_COMMAND_TERMINAL_TTL_SECONDS as A, BoardEffectSchema as B, createSessionPatchReducer as C, DESKTOP_COMMAND_PAYLOAD_MAX_BYTES as D, DESKTOP_COMMAND_MAX_TIMEOUT_MS as E, parseDesktopCommandId as F, BoardCompositionSchema as G, BOARD_ANIMATION_CHANNELS as H, BoardAuthoringItemSchema as I, parseBoardCompositionInput as J, BoardProceduralClipSchema as K, BoardItemPatchSchema as L, isDesktopCallMethod as M, isTerminalDesktopCommandStatus as N, DESKTOP_COMMAND_PENDING_TTL_SECONDS as O, parseDesktopCommand as P, BOARD_BUILTIN_CLIP_KINDS as Q, BoardSemanticMutationSchema as R, SessionPatchReducer as S, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS as T, BOARD_ANIMATION_CHANNEL_CAPABILITIES as U, parseBoardEffectInput as V, BoardCompositionInputSchema as W, BOARD_ARROW_STROKE_SIZE as X, BoardConnectionSchema as Y, BOARD_BUILTIN_CAPABILITIES as Z, buildSpaceInvitePath as _, DesktopCommandsApi as a, SkillsApi as at, createSessionGenerationStreamClient as b, ReferralsApi as c, GenerationsApi as ct, TasksApi as d, DEFAULT_BOARD_RENDER_LIMITS as et, BoardClient as f, PublicInviteApi as g, SpacesApi as h, WorkCommerceApi as i, PublicAssetsApi as it, DESKTOP_COMMAND_VERSION as j, DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS as k, UsersApi as l, CronJobsApi as lt, SpacePublicFilesApi as m, createHttpClient as n, ReferencesApi as nt, UiCommandsApi as o, PromptsApi as ot, SpaceClient as p, BoardTrackSchema as q, AppCommerceApi as r, SearchApi as rt, AppsApi as s, ModelsApi as st, CohubHttpClient as t, SessionAccessApi as tt, UserApi as u, ChannelsApi as ut, buildSpacePath as v, ensureRealtimeConnected as w, parseAssistantMessageCommit as x, SessionGenerationStreamClient as y, BoardEffectInputSchema as z };