@neta-art/cohub 5.10.0 → 7.0.0

package/dist/protocol/dist/board-connection.d.ts

@@ -35,7 +35,7 @@ declare const BoardConnectionAnchorSchema: z.ZodUnion<readonly [z.ZodObject<{
 type BoardConnectionAnchor = z.infer<typeof BoardConnectionAnchorSchema>;
 declare const AUTO_BOARD_CONNECTION_ANCHOR: BoardConnectionAnchor;
 declare const BoardConnectionEndpointSchema: z.ZodObject<{
-  nodeId: z.ZodString;
+  itemId: z.ZodString;
   portId: z.ZodOptional<z.ZodString>;
   anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
     kind: z.ZodLiteral<"auto">;
@@ -125,7 +125,7 @@ declare const DEFAULT_BOARD_CONNECTION_STYLE: BoardConnectionStyle;
 declare const BoardConnectionSchema: z.ZodObject<{
   id: z.ZodString;
   source: z.ZodObject<{
-    nodeId: z.ZodString;
+    itemId: z.ZodString;
     portId: z.ZodOptional<z.ZodString>;
     anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
       kind: z.ZodLiteral<"auto">;
@@ -145,7 +145,7 @@ declare const BoardConnectionSchema: z.ZodObject<{
     }, z.core.$strip>]>>;
   }, z.core.$strip>;
   target: z.ZodObject<{
-    nodeId: z.ZodString;
+    itemId: z.ZodString;
     portId: z.ZodOptional<z.ZodString>;
     anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
       kind: z.ZodLiteral<"auto">;
@@ -193,7 +193,7 @@ declare const BoardConnectionSchema: z.ZodObject<{
     }>>;
   }, z.core.$strip>>;
   metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type BoardConnection = z.infer<typeof BoardConnectionSchema>;
 /** Server-owned fields, mirroring how nodes carry a board id and revision. */
 type BoardConnectionRecord = BoardConnection & {
@@ -212,7 +212,7 @@ type BoardConnectionInput = BoardConnection;
  */
 declare const BoardConnectionPatchSchema: z.ZodObject<{
   source: z.ZodOptional<z.ZodObject<{
-    nodeId: z.ZodString;
+    itemId: z.ZodString;
     portId: z.ZodOptional<z.ZodString>;
     anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
       kind: z.ZodLiteral<"auto">;
@@ -232,7 +232,7 @@ declare const BoardConnectionPatchSchema: z.ZodObject<{
     }, z.core.$strip>]>>;
   }, z.core.$strip>>;
   target: z.ZodOptional<z.ZodObject<{
-    nodeId: z.ZodString;
+    itemId: z.ZodString;
     portId: z.ZodOptional<z.ZodString>;
     anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
       kind: z.ZodLiteral<"auto">;
@@ -280,26 +280,26 @@ declare const BoardConnectionPatchSchema: z.ZodObject<{
     }>>;
   }, z.core.$strip>>>;
   metadata: z.ZodOptional<z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 type BoardConnectionPatch = z.infer<typeof BoardConnectionPatchSchema>;
-/** Both node ids a connection touches, deduped for a self-loop. */
-declare function connectionNodeIds(connection: BoardConnection): string[];
+/** Both item ids a connection touches, deduped for a self-loop. */
+declare function connectionItemIds(connection: BoardConnection): string[];
 /** Whether a connection touches the given node. */
-declare function connectionTouchesNode(connection: BoardConnection, nodeId: string): boolean;
-/** The node at the far end of a connection from `nodeId`, or null. */
-declare function connectionOtherNodeId(connection: BoardConnection, nodeId: string): string | null;
+declare function connectionTouchesItem(connection: BoardConnection, itemId: string): boolean;
+/** The item at the far end of a connection from `itemId`, or null. */
+declare function connectionOtherItemId(connection: BoardConnection, itemId: string): string | null;
 declare function normalizeBoardConnectionStyle(style: Partial<BoardConnectionStyle> | undefined): BoardConnectionStyle;
 /**
  * Build a connection with every default filled in.
  *
- * Callers only state what they mean (which nodes, and optionally the relation),
+ * Callers only state what they mean (which items, and optionally the relation),
  * so a connection created by the editor, an agent or the CLI is byte-identical
  * for the same intent.
  */
 declare function createBoardConnection(input: {
   id: string;
-  sourceNodeId: string;
-  targetNodeId: string;
+  sourceItemId: string;
+  targetItemId: string;
   relation?: string;
   direction?: BoardConnectionDirection;
   label?: string;
@@ -314,4 +314,4 @@ declare function createBoardConnection(input: {
 /** Reverse a connection's endpoints, preserving the relation's reading order. */
 declare function flipBoardConnection(connection: BoardConnection): BoardConnection;
 //#endregion
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle };

package/dist/protocol/dist/board-connection.js

@@ -10,7 +10,7 @@ import { z } from "zod";
 * force a bounding box to be persisted and kept in sync with both endpoints —
 * a second source of truth that is stale the moment either node moves.
 *
-* The stored form is therefore purely semantic: which nodes, in which direction,
+* The stored form is therefore purely semantic: which items, in which direction,
 * anchored where, routed how. Every world coordinate is resolved at read time
 * from the live node frames (see the SDK's connection geometry), so a connection
 * can never drift from the nodes it describes.
@@ -54,7 +54,7 @@ const BoardConnectionAnchorSchema = z.union([
 ]);
 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)
@@ -140,7 +140,7 @@ 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({})
-});
+}).strict();
 /**
 * A patch to an existing connection.
 *
@@ -148,18 +148,18 @@ const BoardConnectionSchema = z.object({
 * endpoints is an edit of the same relation, not a new one.
 */
 const BoardConnectionPatchSchema = BoardConnectionSchema.omit({ id: true }).partial();
-/** Both node ids a connection touches, deduped for a self-loop. */
-function connectionNodeIds(connection) {
-	return connection.source.nodeId === connection.target.nodeId ? [connection.source.nodeId] : [connection.source.nodeId, connection.target.nodeId];
+/** Both item ids a connection touches, deduped for a self-loop. */
+function connectionItemIds(connection) {
+	return connection.source.itemId === connection.target.itemId ? [connection.source.itemId] : [connection.source.itemId, connection.target.itemId];
 }
 /** Whether a connection touches the given node. */
-function connectionTouchesNode(connection, nodeId) {
-	return connection.source.nodeId === nodeId || connection.target.nodeId === nodeId;
+function connectionTouchesItem(connection, itemId) {
+	return connection.source.itemId === itemId || connection.target.itemId === itemId;
 }
-/** The node at the far end of a connection from `nodeId`, or null. */
-function connectionOtherNodeId(connection, nodeId) {
-	if (connection.source.nodeId === nodeId) return connection.target.nodeId;
-	if (connection.target.nodeId === nodeId) return connection.source.nodeId;
+/** The item at the far end of a connection from `itemId`, or null. */
+function connectionOtherItemId(connection, itemId) {
+	if (connection.source.itemId === itemId) return connection.target.itemId;
+	if (connection.target.itemId === itemId) return connection.source.itemId;
 	return null;
 }
 function normalizeBoardConnectionStyle(style) {
@@ -172,7 +172,7 @@ function normalizeBoardConnectionStyle(style) {
 /**
 * Build a connection with every default filled in.
 *
-* Callers only state what they mean (which nodes, and optionally the relation),
+* Callers only state what they mean (which items, and optionally the relation),
 * so a connection created by the editor, an agent or the CLI is byte-identical
 * for the same intent.
 */
@@ -180,12 +180,12 @@ function createBoardConnection(input) {
 	return {
 		id: input.id,
 		source: {
-			nodeId: input.sourceNodeId,
+			itemId: input.sourceItemId,
 			...input.sourcePortId ? { portId: input.sourcePortId } : {},
 			anchor: input.sourceAnchor ?? AUTO_BOARD_CONNECTION_ANCHOR
 		},
 		target: {
-			nodeId: input.targetNodeId,
+			itemId: input.targetItemId,
 			...input.targetPortId ? { portId: input.targetPortId } : {},
 			anchor: input.targetAnchor ?? AUTO_BOARD_CONNECTION_ANCHOR
 		},
@@ -216,4 +216,4 @@ function flipBoardConnection(connection) {
 	};
 }
 //#endregion
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardRelationSchema, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, normalizeBoardConnectionStyle };

package/dist/protocol/dist/board-constants.js

@@ -11,7 +11,6 @@ const DEFAULT_BOARD_RENDER_LIMITS = {
 	simulationSteps: 1e5
 };
 const BOARD_BUILTIN_CLIP_KINDS = [
-	"motion.keyframes",
 	"motion.path",
 	"draw.reveal",
 	"draw.handwrite",
@@ -20,9 +19,6 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 	"effects.trail",
 	"effects.impact",
 	"effects.flash",
-	"effects.color",
-	"camera.pan",
-	"camera.zoom",
 	"camera.focus",
 	"camera.shake"
 ];
@@ -63,16 +59,6 @@ const BOARD_FONT_STACK = "\"Geist\", system-ui, -apple-system, \"Noto Sans CJK S
 const BOARD_MONO_FONT_STACK = "\"Geist Mono\", \"Fira Code\", ui-monospace, \"Noto Sans Mono CJK SC\", monospace";
 function clipSchema(id) {
 	switch (id) {
-		case "motion.keyframes": return { params: {
-			x: {
-				coordinateSpace: "world-offset",
-				unit: "board"
-			},
-			y: {
-				coordinateSpace: "world-offset",
-				unit: "board"
-			}
-		} };
 		case "motion.path": return { params: { points: {
 			coordinateSpace: "world-offset",
 			unit: "board"
@@ -81,17 +67,6 @@ function clipSchema(id) {
 			coordinateSpace: "world",
 			unit: "board"
 		} } };
-		case "camera.pan": return { params: {
-			x: {
-				coordinateSpace: "screen-offset",
-				unit: "css-px"
-			},
-			y: {
-				coordinateSpace: "screen-offset",
-				unit: "css-px"
-			}
-		} };
-		case "camera.zoom": return { params: { scale: { unit: "ratio" } } };
 		case "camera.focus": return { params: {
 			focus: {
 				coordinateSpace: "world",

package/dist/protocol/dist/board-document.d.ts

@@ -100,6 +100,7 @@ declare const BoardTextItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -133,6 +134,7 @@ declare const BoardGeoItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -178,6 +180,7 @@ declare const BoardDrawItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -224,6 +227,7 @@ declare const BoardArrowItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -269,6 +273,7 @@ declare const BoardFrameItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -302,6 +307,7 @@ declare const BoardImageItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -351,6 +357,7 @@ declare const BoardVideoItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -394,6 +401,7 @@ declare const BoardAudioItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -464,6 +472,7 @@ declare const BoardFileItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -591,6 +600,7 @@ declare const BoardTaskItemSchema: z.ZodObject<{
     height: z.ZodNumber;
     rotation: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>;
+  parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
   locked: z.ZodOptional<z.ZodBoolean>;
   style: z.ZodOptional<z.ZodObject<{
     variant: z.ZodDefault<z.ZodString>;
@@ -678,6 +688,7 @@ type BoardUnknownItem = {
   id: string;
   type: typeof UNKNOWN_BOARD_ITEM_TYPE;
   frame: z.infer<typeof BoardFrameSchema>;
+  parentId?: string | null;
   locked?: boolean;
   style?: z.infer<typeof BoardItemStyleSchema>;
   metadata?: Record<string, unknown>;
@@ -695,6 +706,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -733,6 +745,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -765,6 +778,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -798,6 +812,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -831,6 +846,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -893,6 +909,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -916,6 +933,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -940,6 +958,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -967,6 +986,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -1001,6 +1021,7 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     height: number;
     rotation: number;
   };
+  parentId?: string | null | undefined;
   locked?: boolean | undefined;
   style?: {
     variant: string;
@@ -1078,6 +1099,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1116,6 +1138,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1148,6 +1171,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1181,6 +1205,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1214,6 +1239,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1276,6 +1302,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1299,6 +1326,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1323,6 +1351,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1350,6 +1379,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1384,6 +1414,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       height: number;
       rotation: number;
     };
+    parentId?: string | null | undefined;
     locked?: boolean | undefined;
     style?: {
       variant: string;
@@ -1401,7 +1432,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
   connections: z.ZodDefault<z.ZodArray<z.ZodObject<{
     id: z.ZodString;
     source: z.ZodObject<{
-      nodeId: z.ZodString;
+      itemId: z.ZodString;
       portId: z.ZodOptional<z.ZodString>;
       anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"auto">;
@@ -1421,7 +1452,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       }, z.core.$strip>]>>;
     }, z.core.$strip>;
     target: z.ZodObject<{
-      nodeId: z.ZodString;
+      itemId: z.ZodString;
       portId: z.ZodOptional<z.ZodString>;
       anchor: z.ZodDefault<z.ZodUnion<readonly [z.ZodObject<{
         kind: z.ZodLiteral<"auto">;
@@ -1469,7 +1500,7 @@ declare const BoardDocumentSchema: z.ZodObject<{
       }>>;
     }, z.core.$strip>>;
     metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  }, z.core.$strip>>>;
+  }, z.core.$strict>>>;
 }, z.core.$strip>;
 type BoardFrame = z.infer<typeof BoardFrameSchema>;
 type BoardViewport = z.infer<typeof BoardViewportSchema>;

package/dist/protocol/dist/board-document.js

@@ -100,6 +100,7 @@ const BoardMediaSnapshotSchema = z.object({
 const BoardItemBaseSchema = z.object({
 	id: z.string().min(1),
 	frame: BoardFrameSchema,
+	parentId: z.string().min(1).nullable().optional(),
 	/** When true the shape cannot be moved, resized, or deleted. */
 	locked: z.boolean().optional(),
 	style: BoardItemStyleSchema.optional(),
@@ -378,6 +379,7 @@ function makeUnknownItem(raw) {
 			height: 80,
 			rotation: 0
 		},
+		...typeof record.parentId === "string" || record.parentId === null ? { parentId: record.parentId } : {},
 		...record.locked === true ? { locked: true } : {},
 		...styleParsed.success && record.style ? { style: styleParsed.data } : {},
 		...record.metadata && typeof record.metadata === "object" ? { metadata: record.metadata } : {},
@@ -431,7 +433,7 @@ function parseBoardDocument(input) {
 function withResolvedConnections(document) {
 	if (document.connections.length === 0) return document;
 	const ids = new Set(document.items.map((item) => item.id));
-	const connections = document.connections.filter((connection) => ids.has(connection.source.nodeId) && ids.has(connection.target.nodeId));
+	const connections = document.connections.filter((connection) => ids.has(connection.source.itemId) && ids.has(connection.target.itemId));
 	return connections.length === document.connections.length ? document : {
 		...document,
 		connections

package/dist/protocol/dist/board-effect.d.ts

@@ -0,0 +1,94 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-effect.d.ts
+declare const BoardAssetRefSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    extension: "extension";
+    "space-file": "space-file";
+  }>;
+  ref: z.ZodString;
+  digest: z.ZodOptional<z.ZodString>;
+}, z.core.$strict>;
+declare const BoardEffectSchema: z.ZodObject<{
+  id: z.ZodString;
+  boardId: z.ZodString;
+  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"board">;
+  }, z.core.$strict>], "type">;
+  kind: z.ZodString;
+  kindVersion: z.ZodNumber;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  lifecycle: z.ZodEnum<{
+    manual: "manual";
+    persistent: "persistent";
+    "when-visible": "when-visible";
+  }>;
+  timeOrigin: z.ZodEnum<{
+    activation: "activation";
+    board: "board";
+    visible: "visible";
+  }>;
+  layer: z.ZodDefault<z.ZodEnum<{
+    behind: "behind";
+    front: "front";
+    screen: "screen";
+  }>>;
+  seed: z.ZodString;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  assetRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      extension: "extension";
+      "space-file": "space-file";
+    }>;
+    ref: z.ZodString;
+    digest: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  revision: z.ZodNumber;
+}, z.core.$strict>;
+type BoardAssetRef = z.infer<typeof BoardAssetRefSchema>;
+type BoardEffect = z.infer<typeof BoardEffectSchema>;
+/** The client-authored effect form: no server-owned `boardId`/`revision`. */
+declare const BoardEffectInputSchema: z.ZodObject<{
+  id: z.ZodString;
+  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
+    type: z.ZodLiteral<"board">;
+  }, z.core.$strict>], "type">;
+  kind: z.ZodString;
+  kindVersion: z.ZodNumber;
+  enabled: z.ZodDefault<z.ZodBoolean>;
+  lifecycle: z.ZodEnum<{
+    manual: "manual";
+    persistent: "persistent";
+    "when-visible": "when-visible";
+  }>;
+  timeOrigin: z.ZodEnum<{
+    activation: "activation";
+    board: "board";
+    visible: "visible";
+  }>;
+  layer: z.ZodDefault<z.ZodEnum<{
+    behind: "behind";
+    front: "front";
+    screen: "screen";
+  }>>;
+  seed: z.ZodString;
+  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  assetRefs: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    type: z.ZodEnum<{
+      extension: "extension";
+      "space-file": "space-file";
+    }>;
+    ref: z.ZodString;
+    digest: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+type BoardEffectInput = z.infer<typeof BoardEffectInputSchema>;
+//#endregion
+export { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema };

package/dist/protocol/dist/board-effect.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+//#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 = 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 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,
+	boardId: z.string().uuid(),
+	target: z.discriminatedUnion("type", [z.object({
+		type: z.literal("item"),
+		itemId: idSchema
+	}).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()
+}).strict();
+/** The client-authored effect form: no server-owned `boardId`/`revision`. */
+const BoardEffectInputSchema = BoardEffectSchema.omit({
+	boardId: true,
+	revision: true
+});
+//#endregion
+export { BoardAssetRefSchema, BoardEffectInputSchema, BoardEffectSchema };