@neta-art/cohub 5.6.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<{
@@ -370,6 +371,50 @@ declare const BoardVideoItemSchema: z.ZodObject<{
     naturalHeight: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
+/** Audio node — space file only. Playback state is local UI, never synced. */
+declare const BoardAudioItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"audio">;
+  ref: z.ZodObject<{
+    kind: z.ZodLiteral<"space-file">;
+    path: z.ZodString;
+  }, z.core.$strip>;
+  snapshot: z.ZodOptional<z.ZodObject<{
+    title: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    size: z.ZodOptional<z.ZodNumber>;
+    mtimeMs: z.ZodOptional<z.ZodNumber>;
+    naturalWidth: z.ZodOptional<z.ZodNumber>;
+    naturalHeight: z.ZodOptional<z.ZodNumber>;
+    durationMs: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+}, z.core.$strip>;
 /**
  * Cached display facts for a file card.
  *
@@ -440,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`.
@@ -468,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;
@@ -526,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
@@ -549,7 +652,7 @@ declare const BoardTaskItemSchema: z.ZodObject<{
  * authored by newer clients round-trip losslessly — data is never dropped or
  * silently downgraded just because this client predates a shape type.
  */
-declare const KNOWN_BOARD_ITEM_TYPES: readonly ["image", "video", "file", "task", "text", "geo", "draw", "arrow", "frame"];
+declare const KNOWN_BOARD_ITEM_TYPES: readonly ["image", "video", "audio", "file", "task", "text", "geo", "draw", "arrow", "frame"];
 type KnownBoardItemType = (typeof KNOWN_BOARD_ITEM_TYPES)[number];
 /**
  * A forward-compatible carrier for shape types this client does not recognise.
@@ -640,6 +743,39 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     naturalWidth?: number | undefined;
     naturalHeight?: number | undefined;
   } | undefined;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "audio";
+  ref: {
+    kind: "space-file";
+    path: string;
+  };
+  snapshot?: {
+    title?: string | undefined;
+    mimeType?: string | undefined;
+    size?: number | undefined;
+    mtimeMs?: number | undefined;
+    naturalWidth?: number | undefined;
+    naturalHeight?: number | undefined;
+    durationMs?: number | undefined;
+  } | undefined;
 } | {
   id: string;
   frame: {
@@ -700,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;
   };
 } | {
@@ -953,6 +1113,39 @@ declare const BoardDocumentSchema: z.ZodObject<{
       naturalWidth?: number | undefined;
       naturalHeight?: number | undefined;
     } | undefined;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "audio";
+    ref: {
+      kind: "space-file";
+      path: string;
+    };
+    snapshot?: {
+      title?: string | undefined;
+      mimeType?: string | undefined;
+      size?: number | undefined;
+      mtimeMs?: number | undefined;
+      naturalWidth?: number | undefined;
+      naturalHeight?: number | undefined;
+      durationMs?: number | undefined;
+    } | undefined;
   } | {
     id: string;
     frame: {
@@ -1013,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;
     };
   } | {
@@ -1241,13 +1458,14 @@ type BoardArrowItem = z.infer<typeof BoardArrowItemSchema>;
 type BoardFrameItem = z.infer<typeof BoardFrameItemSchema>;
 type BoardImageItem = z.infer<typeof BoardImageItemSchema>;
 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. */
-type BoardKnownItem = BoardImageItem | BoardVideoItem | BoardFileItem | BoardTaskItem | BoardTextItem | BoardGeoItem | BoardDrawItem | BoardArrowItem | BoardFrameItem;
+type BoardKnownItem = BoardImageItem | BoardVideoItem | BoardAudioItem | BoardFileItem | BoardTaskItem | BoardTextItem | BoardGeoItem | BoardDrawItem | BoardArrowItem | BoardFrameItem;
 /** Any item, including forward-compatible unknown types. */
 type BoardItem = BoardKnownItem | BoardUnknownItem;
 type BoardDocument = z.infer<typeof BoardDocumentSchema>;
@@ -1268,8 +1486,8 @@ declare function parseBoardDocument(input: unknown): BoardDocument;
 /** Keep only the connections whose endpoints both exist in `items`. */
 declare function withResolvedConnections(document: BoardDocument): BoardDocument;
 declare function isUnknownItem(item: BoardItem): item is BoardUnknownItem;
-declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVideoItem;
-/** Whether an item references a workspace file (image, video or file card). */
-declare function isFileBackedItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardFileItem;
+declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardAudioItem;
+/** 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, 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({
@@ -167,6 +168,12 @@ const BoardVideoItemSchema = BoardItemBaseSchema.extend({
 	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.
 *
@@ -202,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`.
@@ -232,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"),
@@ -251,6 +278,7 @@ const BoardTaskItemSchema = BoardItemBaseSchema.extend({
 const KNOWN_BOARD_ITEM_TYPES = [
 	"image",
 	"video",
+	"audio",
 	"file",
 	"task",
 	"text",
@@ -288,6 +316,10 @@ function parseBoardItemLoose(raw) {
 			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);
@@ -396,11 +428,11 @@ function isUnknownItem(item) {
 	return item.type === UNKNOWN_BOARD_ITEM_TYPE;
 }
 function isMediaItem(item) {
-	return item.type === "image" || item.type === "video";
+	return item.type === "image" || item.type === "video" || item.type === "audio";
 }
-/** Whether an item references a workspace file (image, video or file card). */
+/** Whether an item references a workspace file (media or file card). */
 function isFileBackedItem(item) {
-	return item.type === "image" || item.type === "video" || item.type === "file";
+	return item.type === "image" || item.type === "video" || item.type === "audio" || item.type === "file";
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearanceSchema, BoardArrowItemSchema, 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 };