@neta-art/cohub 5.7.0 → 5.8.0

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

@@ -1,4 +1,5 @@
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION } from "./board.js";
+import { BOARD_REMOTE_URL_MAX_LENGTH, BoardRemoteUrlSchema, normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-document.d.ts
 declare const BoardFrameSchema: z.ZodObject<{
@@ -484,19 +485,39 @@ declare const BoardFileItemSchema: z.ZodObject<{
     coverUrl: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
-declare const BoardTaskOutputSchema: z.ZodObject<{
-  type: z.ZodEnum<{
-    audio: "audio";
-    image: "image";
-    text: "text";
-    video: "video";
-  }>;
-  url: z.ZodOptional<z.ZodString>;
-  textExcerpt: z.ZodOptional<z.ZodString>;
+declare const BOARD_TASK_ARTIFACT_LIMIT = 6;
+declare const BoardTaskArtifactSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  url: z.ZodString;
   mimeType: z.ZodOptional<z.ZodString>;
+  type: z.ZodLiteral<"image">;
   naturalWidth: z.ZodOptional<z.ZodNumber>;
   naturalHeight: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  url: z.ZodString;
+  mimeType: z.ZodOptional<z.ZodString>;
+  type: z.ZodLiteral<"video">;
+  previewUrl: z.ZodOptional<z.ZodString>;
+  durationMs: z.ZodOptional<z.ZodNumber>;
+  naturalWidth: z.ZodOptional<z.ZodNumber>;
+  naturalHeight: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+  id: z.ZodString;
+  title: z.ZodOptional<z.ZodString>;
+  url: z.ZodString;
+  mimeType: z.ZodOptional<z.ZodString>;
+  type: z.ZodLiteral<"audio">;
+  previewUrl: z.ZodOptional<z.ZodString>;
+  durationMs: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>, z.ZodObject<{
+  id: z.ZodString;
+  type: z.ZodLiteral<"text">;
+  title: z.ZodOptional<z.ZodString>;
+  textExcerpt: z.ZodString;
+}, z.core.$strict>], "type">;
 /**
  * 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`.
@@ -512,22 +533,41 @@ declare const BoardTaskSnapshotSchema: z.ZodObject<{
   title: z.ZodString;
   model: z.ZodOptional<z.ZodString>;
   promptExcerpt: z.ZodOptional<z.ZodString>;
-  outputCount: z.ZodDefault<z.ZodNumber>;
-  primaryOutput: z.ZodOptional<z.ZodObject<{
-    type: z.ZodEnum<{
-      audio: "audio";
-      image: "image";
-      text: "text";
-      video: "video";
-    }>;
-    url: z.ZodOptional<z.ZodString>;
-    textExcerpt: z.ZodOptional<z.ZodString>;
+  artifactCount: z.ZodNumber;
+  artifacts: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
     mimeType: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"image">;
     naturalWidth: z.ZodOptional<z.ZodNumber>;
     naturalHeight: z.ZodOptional<z.ZodNumber>;
-  }, z.core.$strip>>;
+  }, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"video">;
+    previewUrl: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+    naturalWidth: z.ZodOptional<z.ZodNumber>;
+    naturalHeight: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    url: z.ZodString;
+    mimeType: z.ZodOptional<z.ZodString>;
+    type: z.ZodLiteral<"audio">;
+    previewUrl: z.ZodOptional<z.ZodString>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strict>, z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodLiteral<"text">;
+    title: z.ZodOptional<z.ZodString>;
+    textExcerpt: z.ZodString;
+  }, z.core.$strict>], "type">>>;
   updatedAt: z.ZodOptional<z.ZodString>;
-}, z.core.$strip>;
+}, z.core.$strict>;
 /** A stable reference to a task run with a small, replaceable display cache. */
 declare const BoardTaskItemSchema: z.ZodObject<{
   id: z.ZodString;
@@ -570,22 +610,41 @@ declare const BoardTaskItemSchema: z.ZodObject<{
     title: z.ZodString;
     model: z.ZodOptional<z.ZodString>;
     promptExcerpt: z.ZodOptional<z.ZodString>;
-    outputCount: z.ZodDefault<z.ZodNumber>;
-    primaryOutput: z.ZodOptional<z.ZodObject<{
-      type: z.ZodEnum<{
-        audio: "audio";
-        image: "image";
-        text: "text";
-        video: "video";
-      }>;
-      url: z.ZodOptional<z.ZodString>;
-      textExcerpt: z.ZodOptional<z.ZodString>;
+    artifactCount: z.ZodNumber;
+    artifacts: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+      id: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      url: z.ZodString;
       mimeType: z.ZodOptional<z.ZodString>;
+      type: z.ZodLiteral<"image">;
       naturalWidth: z.ZodOptional<z.ZodNumber>;
       naturalHeight: z.ZodOptional<z.ZodNumber>;
-    }, z.core.$strip>>;
+    }, z.core.$strict>, z.ZodObject<{
+      id: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+      type: z.ZodLiteral<"video">;
+      previewUrl: z.ZodOptional<z.ZodString>;
+      durationMs: z.ZodOptional<z.ZodNumber>;
+      naturalWidth: z.ZodOptional<z.ZodNumber>;
+      naturalHeight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+      id: z.ZodString;
+      title: z.ZodOptional<z.ZodString>;
+      url: z.ZodString;
+      mimeType: z.ZodOptional<z.ZodString>;
+      type: z.ZodLiteral<"audio">;
+      previewUrl: z.ZodOptional<z.ZodString>;
+      durationMs: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>, z.ZodObject<{
+      id: z.ZodString;
+      type: z.ZodLiteral<"text">;
+      title: z.ZodOptional<z.ZodString>;
+      textExcerpt: z.ZodString;
+    }, z.core.$strict>], "type">>>;
     updatedAt: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>;
+  }, z.core.$strict>;
 }, z.core.$strip>;
 /**
  * The set of shape types this client understands natively. Anything else is
@@ -777,15 +836,39 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     title: string;
     model?: string | undefined;
     promptExcerpt?: string | undefined;
-    outputCount: number;
-    primaryOutput?: {
-      type: "audio" | "image" | "text" | "video";
-      url?: string | undefined;
-      textExcerpt?: string | undefined;
+    artifactCount: number;
+    artifacts: ({
+      id: string;
+      title?: string | undefined;
+      url: string;
       mimeType?: string | undefined;
+      type: "image";
       naturalWidth?: number | undefined;
       naturalHeight?: number | undefined;
-    } | undefined;
+    } | {
+      id: string;
+      title?: string | undefined;
+      url: string;
+      mimeType?: string | undefined;
+      type: "video";
+      previewUrl?: string | undefined;
+      durationMs?: number | undefined;
+      naturalWidth?: number | undefined;
+      naturalHeight?: number | undefined;
+    } | {
+      id: string;
+      title?: string | undefined;
+      url: string;
+      mimeType?: string | undefined;
+      type: "audio";
+      previewUrl?: string | undefined;
+      durationMs?: number | undefined;
+    } | {
+      id: string;
+      type: "text";
+      title?: string | undefined;
+      textExcerpt: string;
+    })[];
     updatedAt?: string | undefined;
   };
 } | {
@@ -1123,15 +1206,39 @@ declare const BoardDocumentSchema: z.ZodObject<{
       title: string;
       model?: string | undefined;
       promptExcerpt?: string | undefined;
-      outputCount: number;
-      primaryOutput?: {
-        type: "audio" | "image" | "text" | "video";
-        url?: string | undefined;
-        textExcerpt?: string | undefined;
+      artifactCount: number;
+      artifacts: ({
+        id: string;
+        title?: string | undefined;
+        url: string;
         mimeType?: string | undefined;
+        type: "image";
         naturalWidth?: number | undefined;
         naturalHeight?: number | undefined;
-      } | undefined;
+      } | {
+        id: string;
+        title?: string | undefined;
+        url: string;
+        mimeType?: string | undefined;
+        type: "video";
+        previewUrl?: string | undefined;
+        durationMs?: number | undefined;
+        naturalWidth?: number | undefined;
+        naturalHeight?: number | undefined;
+      } | {
+        id: string;
+        title?: string | undefined;
+        url: string;
+        mimeType?: string | undefined;
+        type: "audio";
+        previewUrl?: string | undefined;
+        durationMs?: number | undefined;
+      } | {
+        id: string;
+        type: "text";
+        title?: string | undefined;
+        textExcerpt: string;
+      })[];
       updatedAt?: string | undefined;
     };
   } | {
@@ -1354,7 +1461,7 @@ type BoardVideoItem = z.infer<typeof BoardVideoItemSchema>;
 type BoardAudioItem = z.infer<typeof BoardAudioItemSchema>;
 type BoardFileSnapshot = z.infer<typeof BoardFileSnapshotSchema>;
 type BoardFileItem = z.infer<typeof BoardFileItemSchema>;
-type BoardTaskOutput = z.infer<typeof BoardTaskOutputSchema>;
+type BoardTaskArtifact = z.infer<typeof BoardTaskArtifactSchema>;
 type BoardTaskSnapshot = z.infer<typeof BoardTaskSnapshotSchema>;
 type BoardTaskItem = z.infer<typeof BoardTaskItemSchema>;
 /** Known (natively handled) item variants. */
@@ -1383,4 +1490,4 @@ declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVid
 /** Whether an item references a workspace file (media or file card). */
 declare function isFileBackedItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem;
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardAudioItem, BoardAudioItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskOutput, BoardTaskOutputSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardAudioItem, BoardAudioItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardRemoteUrlSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };

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

@@ -1,6 +1,7 @@
 import { BOARD_ARROW_STROKE_SIZE } from "./board-constants.js";
 import { BoardConnectionSchema } from "./board-connection.js";
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION } from "./board.js";
+import { BOARD_REMOTE_URL_MAX_LENGTH, BoardRemoteUrlSchema, normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-document.js
 const BoardFrameSchema = z.object({
@@ -208,21 +209,41 @@ const BoardFileItemSchema = BoardItemBaseSchema.extend({
 	ref: SpaceFileRefSchema,
 	snapshot: BoardFileSnapshotSchema.optional()
 });
-const BoardTaskOutputSchema = z.object({
-	type: z.enum([
-		"image",
-		"video",
-		"audio",
-		"text"
-	]),
-	/** Remote preview only. Inline data is intentionally never persisted. */
-	url: z.string().url().optional(),
-	textExcerpt: z.string().max(480).optional(),
-	mimeType: z.string().max(160).optional(),
-	/** Intrinsic media size, cached so the node can match the preview aspect. */
-	naturalWidth: z.number().positive().optional(),
-	naturalHeight: z.number().positive().optional()
-});
+const BOARD_TASK_ARTIFACT_LIMIT = 6;
+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()
+	}).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`.
@@ -238,10 +259,10 @@ const BoardTaskSnapshotSchema = z.object({
 	title: z.string().min(1).max(240),
 	model: z.string().max(160).optional(),
 	promptExcerpt: z.string().max(480).optional(),
-	outputCount: z.number().int().nonnegative().default(0),
-	primaryOutput: BoardTaskOutputSchema.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"),
@@ -414,4 +435,4 @@ function isFileBackedItem(item) {
 	return item.type === "image" || item.type === "video" || item.type === "audio" || item.type === "file";
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearanceSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardTaskItemSchema, BoardTaskOutputSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_REMOTE_URL_MAX_LENGTH, BOARD_TASK_ARTIFACT_LIMIT, BoardAppearanceSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardRemoteUrlSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };

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

@@ -0,0 +1,18 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-node.d.ts
+declare const BOARD_COLOR_IDS: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
+type BoardColorId = (typeof BOARD_COLOR_IDS)[number];
+declare const BOARD_GEO_KINDS: readonly ["rectangle", "rounded", "ellipse", "diamond", "triangle"];
+type BoardGeoKind = (typeof BOARD_GEO_KINDS)[number];
+type BoardNodeValidationDiagnostic = {
+  severity: "error";
+  code: "INVALID_BOARD_NODE" | "INVALID_BOARD_GEOMETRY";
+  message: string;
+  path: string;
+  expected?: string;
+  received?: unknown;
+  allowedValues?: readonly string[];
+  coordinateSpace?: "frame-local" | "world";
+};
+//#endregion
+export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind, BoardNodeValidationDiagnostic };

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

@@ -0,0 +1,239 @@
+import { BOARD_ARROW_STROKE_SIZE } from "./board-constants.js";
+import { BoardTaskSnapshotSchema } from "./board-document.js";
+import { z } from "zod";
+//#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);
+}
+jsonSchema(nodeEnvelopeSchema), Object.fromEntries(BOARD_NATIVE_NODE_TYPES.map((type) => [type, jsonSchema(dataSchemas[type])])), 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 [];
+}
+//#endregion
+export { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BoardColorIdSchema, BoardGeoKindSchema, validateBoardNodeInput };

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

@@ -0,0 +1,12 @@
+import { z } from "zod";
+//#region ../protocol/dist/board-url.d.ts
+declare const BOARD_REMOTE_URL_MAX_LENGTH = 4096;
+/**
+ * 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.
+ */
+declare function normalizeBoardRemoteUrl(value: unknown): string | undefined;
+declare const BoardRemoteUrlSchema: z.ZodString;
+//#endregion
+export { BOARD_REMOTE_URL_MAX_LENGTH, BoardRemoteUrlSchema, normalizeBoardRemoteUrl };