@neta-art/cohub 5.10.0 → 6.0.0

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,18 +38,6 @@ function parseBoardManifest(input) {
 function serializeBoardManifest(manifest) {
 	return `${JSON.stringify(BoardManifestSchema.parse(manifest), null, 2)}\n`;
 }
-const BoardTargetSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}),
-	z.object({
-		type: z.literal("effect"),
-		effectId: idSchema
-	}),
-	z.object({ type: z.literal("board") }),
-	z.object({ type: z.literal("camera") })
-]);
 const BoardCameraStateSchema = z.object({
 	centerX: finiteSchema,
 	centerY: finiteSchema,
@@ -64,12 +54,12 @@ const BoardCameraFocusSchema = z.discriminatedUnion("type", [
 		})
 	}),
 	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
+		type: z.literal("item"),
+		itemId: idSchema
 	}),
 	z.object({
-		type: z.literal("nodes"),
-		nodeIds: z.array(idSchema).min(1).max(1e3)
+		type: z.literal("items"),
+		itemIds: z.array(idSchema).min(1).max(1e3)
 	}),
 	z.object({
 		type: z.literal("frame"),
@@ -94,45 +84,13 @@ const BoardAssetRefSchema = z.object({
 	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),
@@ -157,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(),
@@ -190,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({
@@ -221,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(),
@@ -257,4 +197,4 @@ function isBoardPath(path) {
 	return path.toLowerCase().endsWith(BOARD_EXTENSION);
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, 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, 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_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardClip, BoardClipSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, 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_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BoardAssetRef, BoardAssetRefSchema, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardClip, BoardClipSchema, BoardColorId, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardNodeValidationDiagnostic, BoardOperation, BoardPlaybackPolicy, BoardPlaybackPolicySchema, 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, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, 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, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraStateSchema, 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, BoardCoordinateSpace, BoardRenderCost } from "./protocol/dist/board-constants.js";
-import { BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardClip, BoardDeleteReason, BoardDiagnostic, BoardEffect, BoardManifest, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackPolicy, BoardRecord, BoardSequence, BoardTarget, BoardValidationResult } from "./protocol/dist/board.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.10.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"
   }
 }

package/dist/board/nodes.d.ts

@@ -1,113 +0,0 @@
-import { BoardColorId, BoardGeoKind, BoardNodeValidationDiagnostic } from "../protocol/dist/board-node.js";
-import { BoardNodeInput } from "../protocol/dist/board.js";
-import "../protocol/dist/index.js";
-import { BoardAudioItem, BoardFileSnapshot, BoardMediaSnapshot, BoardTaskSnapshot } from "../protocol/dist/board-document.js";
-//#region src/board/nodes.d.ts
-type BoardNodeFrameInput = {
-  x: number;
-  y: number;
-  width: number;
-  height: number;
-  rotation?: number;
-};
-type BoardNodeSpecBase = {
-  id: string;
-  parentId?: string | null;
-  orderKey?: string | null;
-  style?: Record<string, unknown>;
-};
-type BoardBoxNodeSpec = BoardNodeSpecBase & {
-  frame: BoardNodeFrameInput;
-};
-type BoardMediaNodeSpec = BoardBoxNodeSpec & {
-  path: string;
-  snapshot?: BoardMediaSnapshot;
-};
-type BoardNodeSpec = (BoardBoxNodeSpec & {
-  type: "text";
-  text?: string;
-  color?: BoardColorId;
-  fontSize?: number;
-}) | (BoardBoxNodeSpec & {
-  type: "geo";
-  geo?: BoardGeoKind;
-  text?: string;
-  color?: BoardColorId;
-  fillOpacity?: number;
-}) | (BoardNodeSpecBase & {
-  type: "draw";
-  /** Raw world-space samples. Stored points are converted to frame-local space. */
-  points: Array<{
-    x: number;
-    y: number;
-    p?: number;
-  }>;
-  color?: BoardColorId;
-  size?: number;
-}) | (BoardNodeSpecBase & {
-  type: "arrow";
-  start: {
-    x: number;
-    y: number;
-  };
-  end: {
-    x: number;
-    y: number;
-  };
-  bend?: number;
-  color?: BoardColorId;
-  size?: number;
-  arrowStart?: boolean;
-  arrowEnd?: boolean;
-  label?: string;
-}) | (BoardBoxNodeSpec & {
-  type: "frame";
-  label?: string;
-  color?: BoardColorId;
-}) | (BoardMediaNodeSpec & {
-  type: "image";
-  crop?: {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-  };
-}) | (BoardMediaNodeSpec & {
-  type: "video";
-}) | (Omit<BoardMediaNodeSpec, "snapshot"> & {
-  type: "audio";
-  snapshot?: BoardAudioItem["snapshot"];
-}) | (BoardBoxNodeSpec & {
-  type: "file";
-  path: string;
-  snapshot?: BoardFileSnapshot;
-}) | (BoardBoxNodeSpec & {
-  type: "task";
-  taskRunId: string;
-  snapshot: BoardTaskSnapshot;
-});
-declare class BoardInputError extends Error {
-  readonly code = "INVALID_BOARD_NODE";
-  readonly diagnostics: BoardNodeValidationDiagnostic[];
-  readonly body: {
-    code: "INVALID_BOARD_NODE";
-    message: string;
-    diagnostics: BoardNodeValidationDiagnostic[];
-  };
-  constructor(diagnostics: BoardNodeValidationDiagnostic[]);
-}
-/**
- * Create one validated wire node from semantic Board input.
- *
- * Box nodes take an explicit world-space frame. Draw samples and arrow endpoints
- * take world coordinates; the builder derives their frame and local storage form.
- */
-declare function createBoardNode(spec: BoardNodeSpec): BoardNodeInput;
-declare function validateBoardNodes(nodes: readonly BoardNodeInput[], path?: string): BoardNodeValidationDiagnostic[];
-declare function assertBoardNodes(nodes: readonly BoardNodeInput[], path?: string): void;
-declare function assertBoardTransactionNodeCreates(operations: ReadonlyArray<{
-  type: string;
-  payload: unknown;
-}>): void;
-//#endregion
-export { BoardInputError, BoardNodeFrameInput, BoardNodeSpec, assertBoardNodes, assertBoardTransactionNodeCreates, createBoardNode, validateBoardNodes };

package/dist/board/nodes.js

@@ -1,154 +0,0 @@
-import "../protocol/dist/board-constants.js";
-import { validateBoardNodeInput } from "../protocol/dist/board-node.js";
-import "../protocol/dist/index.js";
-import { computeDrawBounds } from "./core/draw-geometry.js";
-//#region src/board/nodes.ts
-var BoardInputError = class extends Error {
-	code = "INVALID_BOARD_NODE";
-	diagnostics;
-	body;
-	constructor(diagnostics) {
-		const message = diagnostics[0]?.message ?? "Invalid Board node";
-		super(message);
-		this.name = "BoardInputError";
-		this.diagnostics = diagnostics;
-		this.body = {
-			code: this.code,
-			message,
-			diagnostics
-		};
-	}
-};
-function baseNode(spec, frame) {
-	return {
-		nodeId: spec.id,
-		type: spec.type,
-		parentId: spec.parentId ?? null,
-		orderKey: spec.orderKey ?? null,
-		x: frame.x,
-		y: frame.y,
-		width: frame.width,
-		height: frame.height,
-		rotation: frame.rotation ?? 0,
-		refKind: null,
-		refPath: null,
-		refUrl: null,
-		view: {},
-		style: spec.style ?? {},
-		data: {}
-	};
-}
-function arrowFrame(start, end) {
-	const padding = 16;
-	return {
-		x: Math.min(start.x, end.x) - padding,
-		y: Math.min(start.y, end.y) - padding,
-		width: Math.max(1, Math.abs(end.x - start.x) + padding * 2),
-		height: Math.max(1, Math.abs(end.y - start.y) + padding * 2)
-	};
-}
-/**
-* Create one validated wire node from semantic Board input.
-*
-* Box nodes take an explicit world-space frame. Draw samples and arrow endpoints
-* take world coordinates; the builder derives their frame and local storage form.
-*/
-function createBoardNode(spec) {
-	let node;
-	if (spec.type === "draw") {
-		const size = spec.size ?? 4;
-		const worldPoints = spec.points.map((point) => ({
-			x: point.x,
-			y: point.y,
-			p: point.p ?? .5
-		}));
-		const bounds = computeDrawBounds(worldPoints, size);
-		node = baseNode(spec, bounds);
-		node.data = {
-			points: worldPoints.map((point) => ({
-				x: point.x - bounds.x,
-				y: point.y - bounds.y,
-				p: point.p
-			})),
-			color: spec.color ?? "brand",
-			size
-		};
-	} else if (spec.type === "arrow") {
-		node = baseNode(spec, arrowFrame(spec.start, spec.end));
-		node.data = {
-			start: spec.start,
-			end: spec.end,
-			bend: spec.bend ?? 0,
-			color: spec.color ?? "brand",
-			size: spec.size ?? 2.5,
-			arrowStart: spec.arrowStart ?? false,
-			arrowEnd: spec.arrowEnd ?? true,
-			label: spec.label ?? ""
-		};
-	} else {
-		node = baseNode(spec, spec.frame);
-		switch (spec.type) {
-			case "text":
-				node.data = {
-					text: spec.text ?? "",
-					color: spec.color ?? "neutral",
-					fontSize: spec.fontSize ?? 24
-				};
-				break;
-			case "geo":
-				node.data = {
-					geo: spec.geo ?? "rectangle",
-					text: spec.text ?? "",
-					color: spec.color ?? "brand",
-					fillOpacity: spec.fillOpacity ?? 0
-				};
-				break;
-			case "frame":
-				node.data = {
-					label: spec.label ?? "Frame",
-					color: spec.color ?? "neutral"
-				};
-				break;
-			case "image":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				node.data = spec.crop ? { crop: spec.crop } : {};
-				break;
-			case "video":
-			case "audio":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				break;
-			case "file":
-				node.refKind = "space_file";
-				node.refPath = spec.path;
-				node.view = spec.snapshot ?? {};
-				break;
-			case "task":
-				node.view = spec.snapshot;
-				node.data = { taskRunId: spec.taskRunId };
-				break;
-		}
-	}
-	assertBoardNodes([node]);
-	return node;
-}
-function validateBoardNodes(nodes, path = "nodes") {
-	return nodes.flatMap((node, index) => validateBoardNodeInput(node, `${path}.${index}`));
-}
-function assertBoardNodes(nodes, path = "nodes") {
-	const diagnostics = validateBoardNodes(nodes, path);
-	if (diagnostics.length > 0) throw new BoardInputError(diagnostics);
-}
-function assertBoardTransactionNodeCreates(operations) {
-	const diagnostics = operations.flatMap((operation, index) => {
-		if (operation.type !== "node.create") return [];
-		const payload = operation.payload;
-		return payload.node ? validateBoardNodeInput(payload.node, `operations.${index}.payload.node`) : [];
-	});
-	if (diagnostics.length > 0) throw new BoardInputError(diagnostics);
-}
-//#endregion
-export { BoardInputError, assertBoardNodes, assertBoardTransactionNodeCreates, createBoardNode, validateBoardNodes };