@neta-art/cohub 5.9.0 → 6.0.0

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

@@ -1,5 +1,6 @@
-import { BoardCapability, BoardRenderCost } from "./board-constants.js";
-import "./board-connection.js";
+import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
+import { BoardConnectionInput, BoardConnectionPatch } from "./board-connection.js";
+import { BoardComposition } from "./board-composition.js";
 import "./board-node.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.d.ts
@@ -18,17 +19,56 @@ declare class InvalidBoardFileError extends Error {
 }
 declare function parseBoardManifest(input: string | unknown): BoardManifest;
 declare function serializeBoardManifest(manifest: BoardManifest): string;
-declare const BoardTargetSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
-  type: z.ZodLiteral<"node">;
-  nodeId: z.ZodString;
+declare const BoardCameraStateSchema: z.ZodObject<{
+  centerX: z.ZodNumber;
+  centerY: z.ZodNumber;
+  zoom: z.ZodNumber;
+}, z.core.$strip>;
+declare const BoardCameraFocusSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+  type: z.ZodLiteral<"rect">;
+  rect: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+  }, z.core.$strip>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"effect">;
-  effectId: z.ZodString;
+  type: z.ZodLiteral<"item">;
+  itemId: z.ZodString;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"board">;
+  type: z.ZodLiteral<"items">;
+  itemIds: z.ZodArray<z.ZodString>;
 }, z.core.$strip>, z.ZodObject<{
-  type: z.ZodLiteral<"camera">;
+  type: z.ZodLiteral<"frame">;
+  frameId: z.ZodString;
 }, z.core.$strip>], "type">;
+declare const BoardCameraFocusParamsSchema: z.ZodObject<{
+  focus: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"rect">;
+    rect: z.ZodObject<{
+      x: z.ZodNumber;
+      y: z.ZodNumber;
+      width: z.ZodNumber;
+      height: z.ZodNumber;
+    }, z.core.$strip>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"items">;
+    itemIds: z.ZodArray<z.ZodString>;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"frame">;
+    frameId: z.ZodString;
+  }, z.core.$strip>], "type">;
+  fit: z.ZodDefault<z.ZodEnum<{
+    contain: "contain";
+    cover: "cover";
+  }>>;
+  padding: z.ZodDefault<z.ZodNumber>;
+  minZoom: z.ZodOptional<z.ZodNumber>;
+  maxZoom: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
 declare const BoardAssetRefSchema: z.ZodObject<{
   type: z.ZodEnum<{
     extension: "extension";
@@ -37,63 +77,15 @@ declare const BoardAssetRefSchema: z.ZodObject<{
   ref: z.ZodString;
   digest: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
-declare const BoardClipSchema: z.ZodObject<{
-  id: z.ZodString;
-  sequenceId: z.ZodString;
-  kind: z.ZodString;
-  kindVersion: z.ZodNumber;
-  target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"node">;
-    nodeId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"effect">;
-    effectId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"board">;
-  }, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<"camera">;
-  }, z.core.$strip>], "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.ZodString>;
-  params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  keyframes: z.ZodDefault<z.ZodArray<z.ZodObject<{
-    at: z.ZodNumber;
-    value: z.ZodUnknown;
-    easing: z.ZodOptional<z.ZodString>;
-  }, z.core.$strip>>>;
-  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.$strip>>>;
-  seed: z.ZodString;
-  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-}, z.core.$strip>;
 declare const BoardEffectSchema: z.ZodObject<{
   id: z.ZodString;
   boardId: z.ZodString;
   target: z.ZodDiscriminatedUnion<[z.ZodObject<{
-    type: z.ZodLiteral<"node">;
-    nodeId: z.ZodString;
-  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"item">;
+    itemId: z.ZodString;
+  }, z.core.$strict>, z.ZodObject<{
     type: z.ZodLiteral<"board">;
-  }, z.core.$strip>], "type">;
+  }, z.core.$strict>], "type">;
   kind: z.ZodString;
   kindVersion: z.ZodNumber;
   enabled: z.ZodDefault<z.ZodBoolean>;
@@ -125,21 +117,11 @@ declare const BoardEffectSchema: z.ZodObject<{
   metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
   revision: z.ZodNumber;
 }, z.core.$strip>;
-declare const BoardSequenceSchema: z.ZodObject<{
-  id: z.ZodString;
-  boardId: z.ZodString;
-  name: z.ZodString;
-  duration: z.ZodNumber;
-  seed: z.ZodString;
-  restPose: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-  revision: z.ZodNumber;
-}, z.core.$strip>;
-type BoardTarget = z.infer<typeof BoardTargetSchema>;
+type BoardCameraState = z.infer<typeof BoardCameraStateSchema>;
+type BoardCameraFocus = z.infer<typeof BoardCameraFocusSchema>;
+type BoardCameraFocusParams = z.infer<typeof BoardCameraFocusParamsSchema>;
 type BoardAssetRef = z.infer<typeof BoardAssetRefSchema>;
-type BoardClip = z.infer<typeof BoardClipSchema>;
 type BoardEffect = z.infer<typeof BoardEffectSchema>;
-type BoardSequence = z.infer<typeof BoardSequenceSchema>;
 type BoardRecord = {
   id: string;
   spaceId: string;
@@ -171,6 +153,77 @@ type BoardNodeRecord = {
   updatedAt: string | null;
 };
 type BoardNodeInput = Omit<BoardNodeRecord, "boardId" | "version" | "createdAt" | "updatedAt">;
+declare const BOARD_DELETE_REASONS: readonly ["user-delete", "orphan-cleanup", "layout-replace", "placeholder-cascade", "node-cascade"];
+type BoardDeleteReason = (typeof BOARD_DELETE_REASONS)[number] | (string & {});
+type BoardOperationBase = {
+  opId?: string;
+  /** Optional local undo hint. Servers recompute authoritative inverse data. */
+  inverse?: Record<string, unknown>;
+};
+type BoardOperation = (BoardOperationBase & {
+  type: "board.patch";
+  payload: {
+    patch: {
+      title?: string;
+      metadata?: Record<string, unknown>;
+      metadataPatch?: Record<string, unknown>;
+    };
+  };
+}) | (BoardOperationBase & {
+  type: "node.create";
+  payload: {
+    node: BoardNodeInput;
+  };
+}) | (BoardOperationBase & {
+  type: "node.patch";
+  payload: {
+    nodeId: string;
+    patch: Partial<BoardNodeInput>;
+  };
+}) | (BoardOperationBase & {
+  type: "node.delete";
+  payload: {
+    nodeId: string;
+    reason?: BoardDeleteReason;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.create";
+  payload: {
+    connection: BoardConnectionInput;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.patch";
+  payload: {
+    connectionId: string;
+    patch: BoardConnectionPatch;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.delete";
+  payload: {
+    connectionId: string;
+    reason?: BoardDeleteReason;
+  };
+}) | (BoardOperationBase & {
+  type: "effect.upsert";
+  payload: {
+    effect: Omit<BoardEffect, "boardId" | "revision">;
+  };
+}) | (BoardOperationBase & {
+  type: "effect.delete";
+  payload: {
+    effectId: string;
+  };
+}) | (BoardOperationBase & {
+  type: "composition.apply";
+  payload: {
+    composition: Omit<BoardComposition, "revision">;
+  };
+}) | (BoardOperationBase & {
+  type: "composition.delete";
+  payload: {
+    compositionId: string;
+  };
+});
 type BoardDiagnostic = {
   severity: "info" | "warning" | "error";
   code: string;
@@ -180,13 +233,19 @@ type BoardDiagnostic = {
   expected?: string;
   received?: unknown;
   allowedValues?: readonly string[];
-  coordinateSpace?: "frame-local" | "world";
+  coordinateSpace?: BoardCoordinateSpace;
 };
 type BoardValidationResult = {
   valid: boolean;
   diagnostics: BoardDiagnostic[];
   peakCost: BoardRenderCost;
 };
+/** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
+declare const BoardPlaybackPolicySchema: z.ZodObject<{
+  compositionId: z.ZodString;
+  delayMs: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+type BoardPlaybackPolicy = z.infer<typeof BoardPlaybackPolicySchema>;
 declare function isBoardPath(path: string): boolean;
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardClip, BoardClipSchema, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, type BoardRenderCost, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/board.js

@@ -1,5 +1,7 @@
-import "./board-constants.js";
+import { BOARD_BUILTIN_CAPABILITIES, DEFAULT_BOARD_RENDER_LIMITS } from "./board-constants.js";
 import { BoardConnectionSchema } from "./board-connection.js";
+import { BoardCompositionInputSchema } from "./board-composition.js";
+import { BoardAuthoringItemSchema } from "./board-authoring.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.js
 const BOARD_EXTENSION = ".board";
@@ -36,62 +38,59 @@ function parseBoardManifest(input) {
 function serializeBoardManifest(manifest) {
 	return `${JSON.stringify(BoardManifestSchema.parse(manifest), null, 2)}\n`;
 }
-const BoardTargetSchema = z.discriminatedUnion("type", [
+const BoardCameraStateSchema = z.object({
+	centerX: finiteSchema,
+	centerY: finiteSchema,
+	zoom: finiteSchema.positive()
+});
+const BoardCameraFocusSchema = z.discriminatedUnion("type", [
+	z.object({
+		type: z.literal("rect"),
+		rect: z.object({
+			x: finiteSchema,
+			y: finiteSchema,
+			width: finiteSchema.positive(),
+			height: finiteSchema.positive()
+		})
+	}),
 	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
+		type: z.literal("item"),
+		itemId: idSchema
 	}),
 	z.object({
-		type: z.literal("effect"),
-		effectId: idSchema
+		type: z.literal("items"),
+		itemIds: z.array(idSchema).min(1).max(1e3)
 	}),
-	z.object({ type: z.literal("board") }),
-	z.object({ type: z.literal("camera") })
+	z.object({
+		type: z.literal("frame"),
+		frameId: idSchema
+	})
 ]);
+const BoardCameraFocusParamsSchema = z.object({
+	focus: BoardCameraFocusSchema,
+	fit: z.enum(["contain", "cover"]).default("contain"),
+	padding: finiteSchema.nonnegative().default(32),
+	minZoom: finiteSchema.positive().optional(),
+	maxZoom: finiteSchema.positive().optional()
+}).superRefine((value, context) => {
+	if (value.minZoom !== void 0 && value.maxZoom !== void 0 && value.minZoom > value.maxZoom) context.addIssue({
+		code: "custom",
+		message: "minZoom must not exceed maxZoom",
+		path: ["minZoom"]
+	});
+});
 const BoardAssetRefSchema = z.object({
 	type: z.enum(["space-file", "extension"]),
 	ref: z.string().min(1).max(4096),
 	digest: z.string().min(16).max(160).optional()
 });
-const BoardKeyframeSchema = z.object({
-	at: finiteSchema.nonnegative(),
-	value: z.unknown(),
-	easing: z.string().min(1).max(80).optional()
-});
-const BoardClipSchema = z.object({
-	id: idSchema,
-	sequenceId: idSchema,
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	target: BoardTargetSchema,
-	start: finiteSchema.nonnegative(),
-	duration: finiteSchema.positive(),
-	layer: z.enum([
-		"behind",
-		"content",
-		"front",
-		"screen"
-	]).default("content"),
-	fill: z.enum([
-		"none",
-		"backwards",
-		"forwards",
-		"both"
-	]).default("none"),
-	easing: z.string().min(1).max(80).default("linear"),
-	params: jsonObjectSchema.default({}),
-	keyframes: z.array(BoardKeyframeSchema).default([]),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	seed: z.string().min(1).max(160),
-	metadata: jsonObjectSchema.default({})
-});
 const BoardEffectSchema = z.object({
 	id: idSchema,
 	boardId: z.string().uuid(),
 	target: z.discriminatedUnion("type", [z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}), z.object({ type: z.literal("board") })]),
+		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),
@@ -116,17 +115,7 @@ const BoardEffectSchema = z.object({
 	metadata: jsonObjectSchema.default({}),
 	revision: z.number().int().nonnegative()
 });
-const BoardSequenceSchema = z.object({
-	id: idSchema,
-	boardId: z.string().uuid(),
-	name: z.string().min(1).max(255),
-	duration: finiteSchema.nonnegative(),
-	seed: z.string().min(1).max(160),
-	restPose: jsonObjectSchema.default({}),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardNodeInputSchema = z.object({
+z.object({
 	nodeId: idSchema,
 	type: z.string().min(1).max(40),
 	parentId: idSchema.nullable(),
@@ -149,27 +138,20 @@ z.object({
 	mutationId: z.string().max(128).optional(),
 	title: z.string().min(1).max(255).optional(),
 	metadata: jsonObjectSchema.optional(),
-	nodes: z.array(BoardNodeInputSchema).max(5e4).optional(),
+	items: z.array(BoardAuthoringItemSchema).max(5e4).optional(),
 	connections: z.array(BoardConnectionSchema).max(5e4).optional(),
 	effects: z.array(BoardEffectSchema.omit({
 		boardId: true,
 		revision: true
 	})).optional(),
-	sequences: z.array(z.object({
-		sequence: BoardSequenceSchema.omit({
-			boardId: true,
-			revision: true
-		}),
-		clips: z.array(BoardClipSchema.omit({ sequenceId: true }))
-	})).optional()
+	compositions: z.array(BoardCompositionInputSchema).optional()
 });
 z.object({
 	include: z.array(z.enum([
 		"nodes",
 		"connections",
 		"effects",
-		"sequences",
-		"clips",
+		"compositions",
 		"playback"
 	])).optional(),
 	viewport: z.object({
@@ -180,16 +162,15 @@ z.object({
 	}).optional()
 });
 z.object({
-	sequenceId: idSchema,
+	compositionId: idSchema,
 	/** Delay before the first local playback after opening the Board, in milliseconds. */
-	delayMs: finiteSchema.nonnegative().default(0),
-	loop: z.boolean().default(false)
+	delayMs: finiteSchema.nonnegative().default(0)
 });
 z.discriminatedUnion("type", [
 	z.object({
 		commandId: idSchema,
 		type: z.literal("play"),
-		sequenceId: idSchema,
+		compositionId: idSchema,
 		position: finiteSchema.nonnegative().optional(),
 		timeScale: finiteSchema.positive().max(4).optional(),
 		shared: z.boolean().optional(),
@@ -216,4 +197,4 @@ function isBoardPath(path) {
 	return path.toLowerCase().endsWith(BOARD_EXTENSION);
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_BUILTIN_CAPABILITIES, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardEffectSchema, BoardManifestSchema, DEFAULT_BOARD_RENDER_LIMITS, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/index.d.ts

@@ -1,9 +1,14 @@
-import { BoardCapability, BoardRenderCost } from "./board-constants.js";
+import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
 import { 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 } from "./board-connection.js";
-import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind, BoardNodeValidationDiagnostic } from "./board-node.js";
-import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardClip, BoardClipSchema, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { BoardAnimationTarget, BoardAnimationTargetSchema, BoardComposition, BoardCompositionSchema, BoardEasing, BoardEasingSchema, BoardProceduralClip, BoardProceduralClipSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema } from "./board-composition.js";
+import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind } from "./board-node.js";
+import { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardRecord, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import "./board-authoring.js";
+import "./board-capability-registry.js";
+import "./board-codec.js";
 import "./board-content.js";
+import "./board-upgrade.js";
 import "./realtime/board-awareness.js";
 import "./work.js";
 import "./realtime/types.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BoardAssetRef, BoardAssetRefSchema, BoardClip, BoardClipSchema, BoardColorId, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardNodeValidationDiagnostic, BoardRecord, BoardRelationSchema, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, InvalidBoardFileError, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BoardAnimationTarget, BoardAnimationTargetSchema, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardColorId, BoardComposition, BoardCompositionSchema, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDeleteReason, BoardDiagnostic, BoardEasing, BoardEasingSchema, BoardEffect, BoardEffectSchema, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, BoardProceduralClip, BoardProceduralClipSchema, BoardRecord, BoardRelationSchema, type BoardRenderCost, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, InvalidBoardFileError, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/index.js

@@ -1,8 +1,13 @@
-import "./board-constants.js";
+import { BOARD_BUILTIN_CAPABILITIES, DEFAULT_BOARD_RENDER_LIMITS } from "./board-constants.js";
 import { 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 } from "./board-connection.js";
-import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { BOARD_ANIMATION_CHANNELS, BOARD_EASINGS, BoardAnimationTargetSchema, BoardCompositionInputSchema, BoardCompositionPlaybackSchema, BoardCompositionSchema, BoardEasingSchema, BoardProceduralClipSchema, BoardTimelineMarkerSchema, BoardTimelineSchema, BoardTrackSchema, parseBoardCompositionInput } from "./board-composition.js";
+import { BoardArrowAuthoringItemSchema, BoardAudioAuthoringItemSchema, BoardAuthoringItemSchema, BoardBuiltinAuthoringItemSchema, BoardDrawAuthoringItemSchema, BoardExtensionAuthoringItemSchema, BoardFileAuthoringItemSchema, BoardFrameAuthoringItemSchema, BoardGeoAuthoringItemSchema, BoardImageAuthoringItemSchema, BoardItemPatchSchema, BoardItemSourceSchema, BoardItemStyleSchema, BoardSemanticCommandSchema, BoardTaskAuthoringItemSchema, BoardTextAuthoringItemSchema, BoardVideoAuthoringItemSchema, isSafeBoardSourcePath } from "./board-authoring.js";
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardEffectSchema, BoardManifestSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { estimateBuiltinBoardClipCost, validateBuiltinBoardClip } from "./board-capability-registry.js";
+import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BoardColorIdSchema, BoardGeoKindSchema } from "./board-node.js";
+import "./board-codec.js";
 import { BOARD_CONTENT_KINDS, BoardContentKindSchema, BoardPortSchema } from "./board-content.js";
-import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BoardColorIdSchema, BoardGeoKindSchema, validateBoardNodeInput } from "./board-node.js";
+import "./board-upgrade.js";
 import { BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema } from "./realtime/board-awareness.js";
 import { SHORT_UUID_PATTERN, UUID_OR_SHORT_UUID_PATTERN, UUID_PATTERN, UUID_SHAPE_PATTERN } from "./identifiers.js";
 import { COHUB_SOURCE_HEADER } from "./provenance.js";
@@ -11,4 +16,4 @@ import "./ui-command.js";
 import "./work-surface.js";
 import "./work-view-stats.js";
 import { WORK_PROMOTION_EVENT_KEYS } from "./work-promotion-stats.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_CONTENT_KINDS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BOARD_MANIFEST_KIND, BOARD_NATIVE_NODE_TYPES, BoardAssetRefSchema, BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema, BoardClipSchema, BoardColorIdSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardContentKindSchema, BoardEffectSchema, BoardGeoKindSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardPortSchema, BoardRelationSchema, BoardSequenceSchema, BoardTargetSchema, COHUB_SOURCE_HEADER, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, InvalidBoardFileError, RESERVED_PLATFORM_PATH_SEGMENTS, SHORT_UUID_PATTERN, UUID_OR_SHORT_UUID_PATTERN, UUID_PATTERN, UUID_SHAPE_PATTERN, WORK_PROMOTION_EVENT_KEYS, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest, validateBoardNodeInput };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_ANIMATION_CHANNELS, BOARD_BUILTIN_CAPABILITIES, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_CONTENT_KINDS, BOARD_DOCUMENT_KIND, BOARD_EASINGS, BOARD_EXTENSION, BOARD_GEO_KINDS, BOARD_MANIFEST_KIND, BOARD_NATIVE_NODE_TYPES, BoardAnimationTargetSchema, BoardArrowAuthoringItemSchema, BoardAssetRefSchema, BoardAudioAuthoringItemSchema, BoardAuthoringItemSchema, BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema, BoardBuiltinAuthoringItemSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, BoardColorIdSchema, BoardCompositionInputSchema, BoardCompositionPlaybackSchema, BoardCompositionSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardContentKindSchema, BoardDrawAuthoringItemSchema, BoardEasingSchema, BoardEffectSchema, BoardExtensionAuthoringItemSchema, BoardFileAuthoringItemSchema, BoardFrameAuthoringItemSchema, BoardGeoAuthoringItemSchema, BoardGeoKindSchema, BoardImageAuthoringItemSchema, BoardItemPatchSchema, BoardItemSourceSchema, BoardItemStyleSchema, BoardManifestSchema, BoardPortSchema, BoardProceduralClipSchema, BoardRelationSchema, BoardSemanticCommandSchema, BoardTaskAuthoringItemSchema, BoardTextAuthoringItemSchema, BoardTimelineMarkerSchema, BoardTimelineSchema, BoardTrackSchema, BoardVideoAuthoringItemSchema, COHUB_SOURCE_HEADER, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_RENDER_LIMITS, InvalidBoardFileError, RESERVED_PLATFORM_PATH_SEGMENTS, SHORT_UUID_PATTERN, UUID_OR_SHORT_UUID_PATTERN, UUID_PATTERN, UUID_SHAPE_PATTERN, WORK_PROMOTION_EVENT_KEYS, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, estimateBuiltinBoardClipCost, flipBoardConnection, isBoardPath, isSafeBoardSourcePath, normalizeBoardConnectionStyle, parseBoardCompositionInput, parseBoardManifest, serializeBoardManifest, validateBuiltinBoardClip };

package/dist/types.d.ts

@@ -1,5 +1,6 @@
-import { BoardCapability, BoardRenderCost } from "./protocol/dist/board-constants.js";
-import { BoardAssetRef, BoardClip, BoardDiagnostic, BoardEffect, BoardManifest, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardTarget, BoardValidationResult } from "./protocol/dist/board.js";
+import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./protocol/dist/board-constants.js";
+import { BoardAnimationTarget, BoardComposition, BoardEasing, BoardProceduralClip, BoardTimelineMarker, BoardTrack } from "./protocol/dist/board-composition.js";
+import { BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardManifest, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardRecord, BoardValidationResult } from "./protocol/dist/board.js";
 import "./protocol/dist/index.js";
 //#region src/types.d.ts
 type UserProfile = {

package/docs/work-runtime-guide.md

@@ -83,10 +83,24 @@ The Work runs inside a Cohub-hosted iframe (`window.parent !== window`). The
 SDK communicates with the parent window via `postMessage` to request tokens
 and context. This is the normal case when a viewer opens a Work through Cohub.
 
-- `client.context()` returns the **real** `space.id`, `work.id`, and current
-  permission scopes from the host.
+- `client.context()` returns the **real** `space.id`, `work.id`, current viewer,
+  and permission scopes from the host.
+- A Work opened through `cohub ui preview` also receives an `invocation`
+  snapshot with the originating `spaceId`, `sessionId`, `turnId`, and
+  `toolCallId` when available. The invocation Space may differ from the Work's
+  own `space.id`.
 - `client.auth.request()` triggers an in-shell consent flow (no popup window).
 
+```js
+const ctx = await client.context();
+console.log(ctx.viewer?.userUuid ?? null);
+console.log(ctx.invocation?.sessionId ?? null);
+```
+
+Invocation fields describe where the preview came from. They are identifiers,
+not authorization: API access remains controlled by the Work session token and
+its scopes.
+
 ### Broker mode (standalone deployment)
 
 The Work is accessed as a standalone page (`window.parent === window`), e.g.
@@ -183,6 +197,7 @@ but **not active** until the viewer approves them through a consent dialog
 triggered by `client.auth.request()`. These are **action** permissions.
 
 ```
+taskrun.view              — read Task Runs the viewer can already access
 session.prompt.readonly   — send read-only prompts (no side effects)
 session.prompt.fullaccess — send prompts with full access (write, create sessions)
 generation.create         — create generation tasks (image/video/audio)
@@ -199,7 +214,8 @@ user.usage.read           — read the viewer's aggregated usage
 `session.prompt.fullaccess` lets you **send** a prompt, but does **not** let
 you **read** the result — that needs `session.view` (a work scope).
 `generation.create` lets you **create** a generation task, but reading its
-result needs `taskrun.view` (a work scope).
+result needs `taskrun.view`, either from the publishing Space's work scopes or
+from viewer authorization checked against the requested Space or Session.
 
 ### Complete API → scope mapping
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "5.9.0",
+  "version": "6.0.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
@@ -82,6 +82,7 @@
     "tsdown": "^0.22.7",
     "tsx": "4.23.1",
     "typescript": "^7.0.2",
+    "@cohub/core": "1.1.1",
     "@cohub/protocol": "2.0.0"
   },
   "peerDependencies": {
@@ -100,7 +101,7 @@
     "build": "tsdown",
     "lint": "biome lint .",
     "lint:fix": "biome lint --write .",
-    "test": "node ../../scripts/test/run.mjs 'src/**/*.test.ts' 'tests/**/*.test.ts'",
+    "test": "node ../../scripts/test/run.mjs --test-concurrency=2 'src/**/*.test.ts' 'tests/**/*.test.ts'",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }