@neta-art/cohub 6.0.0 → 7.0.0

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

@@ -1,7 +1,10 @@
 import "./board-constants.js";
+import { BoardConnectionPatchSchema, BoardConnectionSchema } from "./board-connection.js";
+import { BoardCompositionInputSchema } from "./board-composition.js";
+import { BoardEffectInputSchema } from "./board-effect.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-authoring.js
-const BOARD_COLOR_IDS = [
+const BOARD_AUTHORING_COLOR_IDS = [
 	"brand",
 	"neutral",
 	"black",
@@ -12,7 +15,7 @@ const BOARD_COLOR_IDS = [
 	"violet",
 	"rose"
 ];
-const BOARD_GEO_KINDS = [
+const BOARD_AUTHORING_GEO_KINDS = [
 	"rectangle",
 	"rounded",
 	"ellipse",
@@ -46,7 +49,7 @@ const cropSchema = z.object({
 	h: finiteSchema.min(0).max(1)
 }).strict();
 const BoardItemStyleSchema = z.object({
-	color: z.enum(BOARD_COLOR_IDS).optional(),
+	color: z.enum(BOARD_AUTHORING_COLOR_IDS).optional(),
 	strokeWidth: finiteSchema.min(1).max(64).optional(),
 	fillOpacity: finiteSchema.min(0).max(1).optional()
 }).strict();
@@ -82,7 +85,7 @@ const BoardGeoAuthoringItemSchema = z.object({
 	...styledBaseFields,
 	type: z.literal("geo"),
 	props: z.object({
-		shape: z.enum(BOARD_GEO_KINDS).default("rectangle"),
+		shape: z.enum(BOARD_AUTHORING_GEO_KINDS).default("rectangle"),
 		text: z.string().default("")
 	}).strict()
 }).strict();
@@ -185,7 +188,23 @@ const BoardItemPatchSchema = z.object({
 	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
@@ -204,14 +223,69 @@ const BoardSemanticCommandSchema = z.discriminatedUnion("type", [
 		type: z.literal("item.delete"),
 		itemId: idSchema,
 		cascade: z.boolean().default(false)
+	}).strict(),
+	z.object({
+		type: z.literal("item.reorder"),
+		itemId: idSchema,
+		index: z.number().int().nonnegative()
+	}).strict(),
+	z.object({
+		type: z.literal("connection.create"),
+		connection: BoardConnectionInputSchema
+	}).strict(),
+	z.object({
+		type: z.literal("connection.patch"),
+		connectionId: idSchema,
+		patch: BoardConnectionPatchSchema
+	}).strict(),
+	z.object({
+		type: z.literal("connection.delete"),
+		connectionId: idSchema
+	}).strict(),
+	z.object({
+		type: z.literal("effect.apply"),
+		effect: BoardEffectCommandInputSchema
+	}).strict(),
+	z.object({
+		type: z.literal("effect.delete"),
+		effectId: idSchema
+	}).strict(),
+	z.object({
+		type: z.literal("composition.apply"),
+		composition: BoardCompositionCommandInputSchema
+	}).strict(),
+	z.object({
+		type: z.literal("composition.delete"),
+		compositionId: idSchema
 	}).strict()
 ]);
-z.object({
+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
-export { BoardArrowAuthoringItemSchema, BoardAudioAuthoringItemSchema, BoardAuthoringItemSchema, BoardBuiltinAuthoringItemSchema, BoardDrawAuthoringItemSchema, BoardExtensionAuthoringItemSchema, BoardFileAuthoringItemSchema, BoardFrameAuthoringItemSchema, BoardGeoAuthoringItemSchema, BoardImageAuthoringItemSchema, BoardItemPatchSchema, BoardItemSourceSchema, BoardItemStyleSchema, BoardSemanticCommandSchema, BoardTaskAuthoringItemSchema, BoardTextAuthoringItemSchema, BoardVideoAuthoringItemSchema, isSafeBoardSourcePath };
+export { BOARD_AUTHORING_COLOR_IDS, BOARD_AUTHORING_GEO_KINDS, BoardArrowAuthoringItemSchema, BoardAudioAuthoringItemSchema, BoardAuthoringItemSchema, BoardBuiltinAuthoringItemSchema, BoardDrawAuthoringItemSchema, BoardExtensionAuthoringItemSchema, BoardFileAuthoringItemSchema, BoardFrameAuthoringItemSchema, BoardGeoAuthoringItemSchema, BoardImageAuthoringItemSchema, BoardItemPatchSchema, BoardItemSourceSchema, BoardItemStyleSchema, BoardSemanticCommandSchema, BoardSemanticMutationSchema, BoardTaskAuthoringItemSchema, BoardTextAuthoringItemSchema, BoardVideoAuthoringItemSchema, isSafeBoardSourcePath };

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

@@ -1,2 +1,2 @@
-import "./board.js";
-import "./board-authoring.js";
+import "./board-authoring.js";
+import "./board.js";

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

@@ -1,4 +1,19 @@
-import "./board-authoring.js";
-import "./board.js";
-import "./board-node.js";
-export {};
+import { BoardAuthoringItemSchema, BoardItemPatchSchema } from "./board-authoring.js";
+//#region ../protocol/dist/board-codec.js
+const isRecord = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
+function applyBoardItemPatch(current, value) {
+	const merged = mergePatch(current, BoardItemPatchSchema.parse(value));
+	merged.id = current.id;
+	merged.type = current.type;
+	if ("kindVersion" in current) merged.kindVersion = current.kindVersion;
+	return BoardAuthoringItemSchema.parse(merged);
+}
+function mergePatch(current, patch) {
+	if (!isRecord(patch)) return patch;
+	const result = isRecord(current) ? { ...current } : {};
+	for (const [key, value] of Object.entries(patch)) if (value === null) delete result[key];
+	else result[key] = isRecord(value) ? mergePatch(result[key], value) : value;
+	return result;
+}
+//#endregion
+export { applyBoardItemPatch };

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

@@ -128,6 +128,131 @@ declare const BoardTimelineMarkerSchema: z.ZodObject<{
   metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
 }, z.core.$strict>;
 type BoardTimelineMarker = z.infer<typeof BoardTimelineMarkerSchema>;
+declare const BoardCompositionInputSchema: z.ZodObject<{
+  id: z.ZodString;
+  name: z.ZodString;
+  timeline: z.ZodObject<{
+    duration: z.ZodNumber;
+    tracks: z.ZodDefault<z.ZodArray<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<"effect">;
+        effectId: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"camera">;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"board">;
+      }, z.core.$strict>], "type">;
+      channel: z.ZodString;
+      channelVersion: z.ZodDefault<z.ZodNumber>;
+      interpolation: z.ZodDefault<z.ZodEnum<{
+        linear: "linear";
+        step: "step";
+      }>>;
+      fill: z.ZodDefault<z.ZodEnum<{
+        backwards: "backwards";
+        both: "both";
+        forwards: "forwards";
+        none: "none";
+      }>>;
+      keyframes: z.ZodArray<z.ZodObject<{
+        time: z.ZodNumber;
+        value: z.ZodUnknown;
+        easing: z.ZodOptional<z.ZodEnum<{
+          "ease-in-cubic": "ease-in-cubic";
+          "ease-in-out-cubic": "ease-in-out-cubic";
+          "ease-in-out-quad": "ease-in-out-quad";
+          "ease-in-quad": "ease-in-quad";
+          "ease-out-cubic": "ease-out-cubic";
+          "ease-out-expo": "ease-out-expo";
+          "ease-out-quad": "ease-out-quad";
+          "ease-out-quart": "ease-out-quart";
+          linear: "linear";
+        }>>;
+      }, z.core.$strict>>;
+      metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    clips: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      kind: z.ZodString;
+      kindVersion: z.ZodNumber;
+      target: z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"item">;
+        itemId: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"effect">;
+        effectId: z.ZodString;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"camera">;
+      }, z.core.$strict>, z.ZodObject<{
+        type: z.ZodLiteral<"board">;
+      }, z.core.$strict>], "type">;
+      start: z.ZodNumber;
+      duration: z.ZodNumber;
+      layer: z.ZodDefault<z.ZodEnum<{
+        behind: "behind";
+        content: "content";
+        front: "front";
+        screen: "screen";
+      }>>;
+      fill: z.ZodDefault<z.ZodEnum<{
+        backwards: "backwards";
+        both: "both";
+        forwards: "forwards";
+        none: "none";
+      }>>;
+      easing: z.ZodDefault<z.ZodEnum<{
+        "ease-in-cubic": "ease-in-cubic";
+        "ease-in-out-cubic": "ease-in-out-cubic";
+        "ease-in-out-quad": "ease-in-out-quad";
+        "ease-in-quad": "ease-in-quad";
+        "ease-out-cubic": "ease-out-cubic";
+        "ease-out-expo": "ease-out-expo";
+        "ease-out-quad": "ease-out-quad";
+        "ease-out-quart": "ease-out-quart";
+        linear: "linear";
+      }>>;
+      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>>>;
+      seed: z.ZodString;
+      metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+    markers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+      id: z.ZodString;
+      time: z.ZodNumber;
+      duration: z.ZodOptional<z.ZodNumber>;
+      metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>>;
+  }, z.core.$strict>;
+  playback: z.ZodDefault<z.ZodObject<{
+    loop: z.ZodDefault<z.ZodBoolean>;
+    endBehavior: z.ZodDefault<z.ZodEnum<{
+      hold: "hold";
+      reset: "reset";
+    }>>;
+    reducedMotion: z.ZodDefault<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      mode: z.ZodLiteral<"base">;
+    }, z.core.$strict>, z.ZodObject<{
+      mode: z.ZodLiteral<"time">;
+      time: z.ZodNumber;
+    }, z.core.$strict>, z.ZodObject<{
+      mode: z.ZodLiteral<"marker">;
+      markerId: z.ZodString;
+    }, z.core.$strict>], "mode">>;
+  }, z.core.$strict>>;
+  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strict>;
+type BoardCompositionInput = z.infer<typeof BoardCompositionInputSchema>;
 declare const BoardCompositionSchema: z.ZodObject<{
   id: z.ZodString;
   name: z.ZodString;
@@ -255,4 +380,4 @@ declare const BoardCompositionSchema: z.ZodObject<{
 }, z.core.$strict>;
 type BoardComposition = z.infer<typeof BoardCompositionSchema>;
 //#endregion
-export { BoardAnimationTarget, BoardAnimationTargetSchema, BoardComposition, BoardCompositionSchema, BoardEasing, BoardEasingSchema, BoardProceduralClip, BoardProceduralClipSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema };
+export { BoardAnimationTarget, BoardAnimationTargetSchema, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardEasing, BoardEasingSchema, BoardProceduralClip, BoardProceduralClipSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema };

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

@@ -297,14 +297,6 @@ 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. */
-function parseBoardCompositionInput(value) {
-	if (value && typeof value === "object" && !Array.isArray(value)) {
-		const { revision: _revision, ...input } = value;
-		return BoardCompositionInputSchema.parse(input);
-	}
-	return BoardCompositionInputSchema.parse(value);
-}
 Object.entries(BOARD_ANIMATION_CHANNELS).map(([id, definition]) => ({
 	id,
 	version: 1,
@@ -315,4 +307,4 @@ Object.entries(BOARD_ANIMATION_CHANNELS).map(([id, definition]) => ({
 	valueSchema: z.toJSONSchema(definition.value)
 }));
 //#endregion
-export { BOARD_ANIMATION_CHANNELS, BOARD_EASINGS, BoardAnimationTargetSchema, BoardCompositionInputSchema, BoardCompositionPlaybackSchema, BoardCompositionSchema, BoardEasingSchema, BoardProceduralClipSchema, BoardTimelineMarkerSchema, BoardTimelineSchema, BoardTrackSchema, parseBoardCompositionInput };
+export { BOARD_ANIMATION_CHANNELS, BOARD_EASINGS, BoardAnimationTargetSchema, BoardCompositionInputSchema, BoardCompositionPlaybackSchema, BoardCompositionSchema, BoardEasingSchema, BoardProceduralClipSchema, BoardTimelineMarkerSchema, BoardTimelineSchema, BoardTrackSchema };

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 };