@neta-art/cohub 10.0.0 → 11.1.0

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

@@ -1,8 +1,10 @@
+import { normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-model.js
 const BOARD_ID_MAX_LENGTH = 160;
 const BOARD_CAMERA_TARGET = "camera";
-const BoardIdSchema = z.string().min(1).max(160).regex(/^[^\s/]+$/, "ids must not contain whitespace or '/'").refine((value) => value !== BOARD_CAMERA_TARGET, "\"camera\" is reserved");
+const BoardKeySchema = z.string().min(1).max(160).regex(/^[^\s/]+$/, "ids must not contain whitespace or '/'");
+const BoardIdSchema = BoardKeySchema.refine((value) => value !== BOARD_CAMERA_TARGET, "\"camera\" is reserved");
 const finite = z.number().finite();
 const nonNegative = finite.nonnegative();
 const ratio = finite.min(0).max(1);
@@ -50,10 +52,29 @@ const BoardStyleSchema = z.object({
 	trim: ratio.optional()
 }).strict();
 function isSafeBoardSourcePath(value) {
-	return value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !value.includes("\\") && value.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
+	return value.length > 0 && value.length <= 4096 && !value.startsWith("/") && !/^[a-z][a-z\d+.-]*:/i.test(value.trimStart()) && !value.includes("\\") && value.split("/").every((part) => part.length > 0 && part !== "." && part !== "..");
 }
 const srcSchema = z.string().refine(isSafeBoardSourcePath, "src must be a relative Space file path");
+function parseBoardMediaSource(src) {
+	if (isSafeBoardSourcePath(src)) return {
+		kind: "file",
+		value: src
+	};
+	return normalizeBoardRemoteUrl(src) ? {
+		kind: "url",
+		value: src
+	} : null;
+}
+const BoardMediaSourceSchema = z.string().max(4096).refine((src) => parseBoardMediaSource(src) !== null, "src must be a public HTTP(S) URL or relative Space file path").describe("Prefer a stable public HTTP(S) URL; relative Space file paths remain supported.");
+const BoardScriptSchema = z.object({
+	src: srcSchema.refine((path) => /\.m?js$/.test(path), "script src must be a .js or .mjs module"),
+	params: z.record(z.string(), z.json()).default({}),
+	targets: z.record(z.string().min(1).max(80), BoardIdSchema).default({}),
+	seed: z.string().min(1).max(160).optional(),
+	enabled: z.boolean().default(true)
+}).strict();
 const itemEnvelope = {
+	script: BoardScriptSchema.optional(),
 	parent: BoardIdSchema.optional(),
 	z: finite.optional(),
 	position: BoardVec2Schema.default({
@@ -98,6 +119,7 @@ const BoardFrameItemSchema = z.object({
 	type: z.literal("frame"),
 	props: z.object({
 		label: z.string().max(280).default(""),
+		decoration: z.enum(["frame", "none"]).optional(),
 		clip: z.boolean().default(true)
 	}).strict().prefault({})
 }).strict();
@@ -197,11 +219,19 @@ const BoardMediaSnapshotSchema = z.object({
 	coverUrl: z.string().optional()
 }).strict();
 const fileProps = {
-	src: srcSchema,
+	src: BoardMediaSourceSchema,
 	snapshot: BoardMediaSnapshotSchema.optional()
 };
-const timedFileProps = {
+const BoardMediaOriginSchema = z.object({
+	taskRunId: z.string().min(1).max(160),
+	artifactId: z.string().min(1).max(240)
+}).strict();
+const mediaProps = {
 	...fileProps,
+	origin: BoardMediaOriginSchema.optional()
+};
+const timedFileProps = {
+	...mediaProps,
 	time: nonNegative.optional()
 };
 const BoardCropSchema = z.object({
@@ -214,7 +244,7 @@ const BoardImageItemSchema = z.object({
 	...boxed(640, 360),
 	type: z.literal("image"),
 	props: z.object({
-		...fileProps,
+		...mediaProps,
 		crop: BoardCropSchema.optional()
 	}).strict()
 }).strict();
@@ -280,8 +310,10 @@ const BoardTaskSnapshotSchema = z.object({
 	title: z.string().min(1).max(240),
 	model: z.string().max(160).optional(),
 	promptExcerpt: z.string().max(480).optional(),
+	errorExcerpt: z.string().max(240).optional(),
 	artifactCount: z.number().int().nonnegative(),
 	artifacts: z.array(BoardTaskArtifactSchema).max(6).default([]),
+	startedAt: z.string().max(64).optional(),
 	updatedAt: z.string().optional()
 }).strict();
 const BoardTaskItemSchema = z.object({
@@ -289,7 +321,7 @@ const BoardTaskItemSchema = z.object({
 	type: z.literal("task"),
 	props: z.object({
 		taskRunId: z.string().min(1).max(160),
-		snapshot: BoardTaskSnapshotSchema
+		snapshot: BoardTaskSnapshotSchema.describe("Maintained by the server for tasks in the Board's Space; writers may omit it.")
 	}).strict()
 }).strict();
 const BOARD_EFFECT_KINDS = [
@@ -369,14 +401,11 @@ const BoardEffectItemSchema = z.object({
 		seed: z.string().min(1).max(160).optional()
 	}).strict()
 }).strict();
-const BoardSketchItemSchema = z.object({
+const BoardCustomItemSchema = z.object({
 	...boxed(480, 320),
-	type: z.literal("sketch"),
-	props: z.object({
-		src: srcSchema.refine((path) => /\.m?js$/.test(path), "sketch src must be a .js or .mjs module"),
-		params: z.record(z.string(), z.unknown()).default({}),
-		seed: z.string().min(1).max(160).optional()
-	}).strict()
+	type: z.literal("custom"),
+	script: BoardScriptSchema,
+	props: z.object({}).strict().default({})
 }).strict();
 const BOARD_EXTENSION_TYPE_PATTERN = /^[a-z][a-z0-9]*(?:\.[a-z0-9-]+)+$/;
 const BoardExtensionItemSchema = z.object({
@@ -400,7 +429,7 @@ const BOARD_ITEM_SCHEMAS = {
 	file: BoardFileItemSchema,
 	task: BoardTaskItemSchema,
 	effect: BoardEffectItemSchema,
-	sketch: BoardSketchItemSchema
+	custom: BoardCustomItemSchema
 };
 const BOARD_ITEM_TYPES = Object.keys(BOARD_ITEM_SCHEMAS);
 function isBuiltinItemType(type) {
@@ -533,7 +562,7 @@ const BoardAnimationHeaderSchema = z.object({
 	end: z.enum(["hold", "reset"]).default("hold"),
 	markers: z.array(BoardMarkerSchema).max(1e4).default([])
 }).strict();
-const BoardAnimationSchema = BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardIdSchema, BoardTrackSchema).default({}) }).strict();
+const BoardAnimationSchema = BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardKeySchema, BoardTrackSchema).default({}) }).strict();
 const BOARD_ENTER_PRESETS = [
 	"fade-in",
 	"rise",
@@ -583,10 +612,10 @@ const patchObject = z.record(z.string(), z.unknown());
 const BoardPatchSchema = z.object({
 	board: patchObject.nullable().optional(),
 	items: z.record(BoardIdSchema, patchObject.nullable()).optional(),
-	animations: z.record(BoardIdSchema, patchObject.and(z.object({ tracks: z.record(BoardIdSchema, patchObject.nullable()).optional() })).nullable()).optional()
+	animations: z.record(BoardIdSchema, patchObject.and(z.object({ tracks: z.record(BoardKeySchema, patchObject.nullable()).optional() })).nullable()).optional()
 }).strict();
 function isEmptyBoardDelta(delta) {
 	return !delta.board && Object.keys(delta.items ?? {}).length === 0 && Object.keys(delta.animations ?? {}).length === 0 && Object.keys(delta.tracks ?? {}).length === 0;
 }
 //#endregion
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaSnapshotSchema, BoardPatchSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardSketchItemSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

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

@@ -82,7 +82,8 @@ const NOT_ANIMATABLE = /* @__PURE__ */ new Set([
 	"parent",
 	"z",
 	"locked",
-	"metadata"
+	"metadata",
+	"script"
 ]);
 const CAMERA_PROPERTIES = {
 	focus: {

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

@@ -1,6 +1,6 @@
 //#region ../protocol/dist/board-schema.d.ts
 type JsonSchema = Record<string, unknown>;
-declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[]];
+declare const BOARD_SCHEMA_TARGETS: readonly ["board", "animation", "track", "camera", ...("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[]];
 type BoardJsonSchemaResult = {
   schema?: JsonSchema;
   properties?: Array<{
@@ -11,6 +11,7 @@ type BoardJsonSchemaResult = {
     description: string;
     parameters: Record<string, string>;
   }>;
+  semantics?: Record<string, string>;
 };
 declare function boardJsonSchema(target: string): BoardJsonSchemaResult | null;
 declare function boardSchemaOverview(): {
@@ -19,7 +20,8 @@ declare function boardSchemaOverview(): {
     rotation: string;
     length: string;
   };
-  types: ("arrow" | "audio" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "sketch" | "task" | "text" | "video")[];
+  coordinates: string;
+  types: ("arrow" | "audio" | "custom" | "draw" | "effect" | "file" | "frame" | "image" | "shape" | "task" | "text" | "video")[];
   colors: {
     tokens: readonly ["brand", "neutral", "black", "white", "blue", "green", "amber", "violet", "rose"];
     css: string;

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

@@ -1,4 +1,4 @@
-import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
+import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardKeySchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
 import { listBoardProperties } from "./board-patch.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-schema.js
@@ -19,13 +19,26 @@ const BOARD_SCHEMA_TARGETS = [
 function boardJsonSchema(target) {
 	if (target === "board") return { schema: toJsonSchema(BoardSettingsSchema) };
 	if (target === "animation") return {
-		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(z.string(), BoardTrackSchema).optional() })),
-		properties: listBoardProperties("animation")
+		schema: toJsonSchema(BoardAnimationHeaderSchema.extend({ tracks: z.record(BoardKeySchema, BoardTrackSchema).optional() })),
+		properties: listBoardProperties("animation"),
+		semantics: { composition: "Target another animation's time property to drive its local clock. Parent markers control pauses; child markers are not automatically promoted." }
+	};
+	if (target === "track") return {
+		schema: toJsonSchema(BoardTrackSchema),
+		semantics: {
+			boundary: "Before the first keyframe and after the last, the value is held. Use opacity tracks to control visibility.",
+			easing: "Defaults to linear. The destination keyframe controls the incoming segment. Supports CSS easing keywords, cubic-bezier() and steps().",
+			composition: "replace: the most recently started track wins; ties use the lexicographically larger track ID. Before any start, the nearest upcoming track wins. add: numbers and positions add; opacity and scale multiply.",
+			interpolation: "auto interpolates numbers, colors and vectors; other values step. spline smooths vector motion. orient follows the position tangent."
+		}
 	};
-	if (target === "track") return { schema: toJsonSchema(BoardTrackSchema) };
 	if (target === "effect") return {
 		schema: toJsonSchema(BOARD_ITEM_SCHEMAS.effect),
 		properties: listBoardProperties("effect"),
+		semantics: {
+			follow: "follow is used by trail only. Parent a particle effect to a decoration:none frame to move it with other items.",
+			time: "Effects use animation time in milliseconds. trail samples target history; seed makes procedural particles repeatable."
+		},
 		kinds: Object.fromEntries(BOARD_EFFECT_KINDS.map((kind) => [kind, BOARD_EFFECT_KIND_INFO[kind]]))
 	};
 	if (target === "camera") return { properties: listBoardProperties(BOARD_CAMERA_TARGET) };
@@ -42,6 +55,7 @@ function boardSchemaOverview() {
 			rotation: "degrees",
 			length: "board units (1 = 1 CSS px at zoom 1)"
 		},
+		coordinates: "Positions, draw points and unbound arrow endpoints are relative to their parent frame; without a parent they are world coordinates. Shape paths are fitted to the item size.",
 		types: BOARD_ITEM_TYPES,
 		colors: {
 			tokens: BOARD_COLOR_TOKENS,

package/dist/protocol/dist/board-script-modules.d.ts

@@ -0,0 +1,25 @@
+//#region ../protocol/dist/board-script-modules.d.ts
+declare const BOARD_SCRIPT_MAX_BYTES = 2000000;
+type BoardScriptSource = {
+  code: string;
+  imports: Array<{
+    start: number;
+    end: number;
+    path: string;
+    dynamic: boolean;
+  }>;
+};
+type BoardScriptSources = Record<string, BoardScriptSource>;
+declare function createBoardScriptModuleReader(read: (path: string) => Promise<string>, timeoutMs?: number): {
+  read(path: string): Promise<string>;
+  invalidate(path?: string): void;
+  destroy(): void;
+};
+declare function resolveScriptImport(from: string, specifier: string): string;
+declare function loadBoardScriptSources(src: string, read: (path: string) => Promise<string>, timeoutMs?: number): Promise<BoardScriptSources>;
+declare function scriptModuleUrls(sources: BoardScriptSources): {
+  urls: Record<string, string>;
+  dispose(): void;
+};
+//#endregion
+export { BOARD_SCRIPT_MAX_BYTES, BoardScriptSource, BoardScriptSources, createBoardScriptModuleReader, loadBoardScriptSources, resolveScriptImport, scriptModuleUrls };

package/dist/protocol/dist/board-script-modules.js

@@ -0,0 +1,127 @@
+import { isSafeBoardSourcePath } from "./board-model.js";
+//#region ../protocol/dist/board-script-modules.js
+const BOARD_SCRIPT_MAX_BYTES = 2e6;
+function createBoardScriptModuleReader(read, timeoutMs = 15e3) {
+	const cache = /* @__PURE__ */ new Map();
+	const queue = [];
+	let active = 0;
+	let disposed = false;
+	function pump() {
+		while (active < 4 && queue.length) queue.shift()?.();
+	}
+	return {
+		read(path) {
+			if (disposed) return Promise.reject(/* @__PURE__ */ new Error("Module reader is disposed."));
+			const cached = cache.get(path);
+			if (cached) return cached;
+			const promise = new Promise((resolve, reject) => {
+				queue.push(() => {
+					if (disposed) {
+						reject(/* @__PURE__ */ new Error("Module reader is disposed."));
+						return;
+					}
+					active++;
+					let timer;
+					const timeout = new Promise((_resolve, rejectRead) => {
+						timer = setTimeout(() => rejectRead(/* @__PURE__ */ new Error(`Module read timed out: ${path}`)), timeoutMs);
+					});
+					Promise.race([Promise.resolve().then(() => read(path)), timeout]).then(resolve, reject).finally(() => {
+						clearTimeout(timer);
+						active--;
+						pump();
+					});
+				});
+				pump();
+			});
+			cache.set(path, promise);
+			promise.catch(() => {
+				if (cache.get(path) === promise) cache.delete(path);
+			});
+			return promise;
+		},
+		invalidate(path) {
+			if (path) cache.delete(path);
+			else cache.clear();
+		},
+		destroy() {
+			disposed = true;
+			cache.clear();
+			for (const job of queue.splice(0)) job();
+		}
+	};
+}
+function resolveScriptImport(from, specifier) {
+	if (!specifier.startsWith("./") && !specifier.startsWith("../")) throw new Error(`Only relative module imports are supported: ${specifier}`);
+	const parts = from.split("/").slice(0, -1);
+	for (const part of specifier.split("/")) {
+		if (part === ".") continue;
+		if (part === "..") {
+			if (!parts.length) throw new Error("Module import leaves the Space.");
+			parts.pop();
+		} else parts.push(part);
+	}
+	const path = parts.join("/");
+	if (!isSafeBoardSourcePath(path) || !/\.m?js$/.test(path)) throw new Error(`Invalid module path: ${path}`);
+	return path;
+}
+async function loadBoardScriptSources(src, read, timeoutMs = 15e3) {
+	if (!isSafeBoardSourcePath(src) || !/\.m?js$/.test(src)) throw new Error("Invalid script entry path.");
+	const { init, parse } = await import("es-module-lexer");
+	await init;
+	const sources = {};
+	const visiting = /* @__PURE__ */ new Set();
+	let bytes = 0;
+	async function visit(path) {
+		if (visiting.has(path)) throw new Error(`Circular module dependency: ${path}`);
+		if (sources[path]) return;
+		if (Object.keys(sources).length + visiting.size >= 64) throw new Error("A script may load at most 64 modules.");
+		visiting.add(path);
+		let timer;
+		const code = await Promise.race([Promise.resolve().then(() => read(path)), new Promise((_resolve, reject) => {
+			timer = setTimeout(() => reject(/* @__PURE__ */ new Error(`Module read timed out: ${path}`)), timeoutMs);
+		})]).finally(() => clearTimeout(timer));
+		bytes += new TextEncoder().encode(code).byteLength;
+		if (bytes > 2e6) throw new Error("Script modules exceed the 2 MB limit.");
+		const [imports] = parse(code, path);
+		const resolved = [];
+		for (const entry of imports) {
+			if (entry.d === -2) throw new Error("import.meta is not available in Board scripts.");
+			if (entry.n === void 0) throw new Error("Dynamic imports must use a literal relative path.");
+			const dependency = resolveScriptImport(path, entry.n);
+			await visit(dependency);
+			resolved.push({
+				start: entry.s,
+				end: entry.e,
+				path: dependency,
+				dynamic: entry.d >= 0
+			});
+		}
+		sources[path] = {
+			code,
+			imports: resolved
+		};
+		visiting.delete(path);
+	}
+	await visit(src);
+	return sources;
+}
+function scriptModuleUrls(sources) {
+	const urls = {};
+	for (const [path, source] of Object.entries(sources)) {
+		let code = source.code;
+		for (const entry of [...source.imports].reverse()) {
+			const url = urls[entry.path];
+			if (!url) throw new Error(`Unresolved module: ${entry.path}`);
+			code = code.slice(0, entry.start) + (entry.dynamic ? JSON.stringify(url) : url) + code.slice(entry.end);
+		}
+		urls[path] = URL.createObjectURL(new Blob([`${code}\n//# sourceURL=cohub-script/${path.split("/").map(encodeURIComponent).join("/")}`], { type: "text/javascript" }));
+	}
+	return {
+		urls,
+		dispose: () => {
+			for (const url of Object.values(urls)) URL.revokeObjectURL(url);
+		}
+	};
+}
+//#endregion
+export { BOARD_SCRIPT_MAX_BYTES, createBoardScriptModuleReader, loadBoardScriptSources, resolveScriptImport, scriptModuleUrls };

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

@@ -0,0 +1,22 @@
+import { BoardTaskArtifact, BoardTaskSnapshot } from "./board-model.js";
+import { GenerationRunPayload } from "./generation/blocks.js";
+import { TaskRunStatus } from "./task/index.js";
+//#region ../protocol/dist/board-task.d.ts
+type BoardTaskRunSource = GenerationRunPayload & {
+  taskType: string;
+  status: TaskRunStatus;
+  errorMessage?: string | null;
+  startedAt?: string | null;
+  updatedAt: string;
+};
+declare const BOARD_TASK_SOURCE_PREFIX = "cohub-task:";
+declare const boardTaskSource: (taskRunId: string) => string;
+declare function taskArtifacts(blocks: Record<string, unknown>[]): BoardTaskArtifact[];
+declare function rankedTaskArtifacts(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact[];
+declare function featuredTaskArtifact(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact | undefined;
+declare function taskArtifactPreviewUrl(artifact: BoardTaskArtifact | undefined): string | undefined;
+declare function taskRunArtifacts(run: Pick<BoardTaskRunSource, "taskType" | "result">): BoardTaskArtifact[];
+declare function taskRunToBoardTaskSnapshot(run: BoardTaskRunSource): BoardTaskSnapshot;
+declare function withObservedArtifactFacts(snapshot: BoardTaskSnapshot, observed: BoardTaskSnapshot | undefined): BoardTaskSnapshot;
+//#endregion
+export { BOARD_TASK_SOURCE_PREFIX, BoardTaskRunSource, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts };

package/dist/{board/model/task.js → protocol/dist/board-task.js}

@@ -1,6 +1,8 @@
-import "../../protocol/dist/board-model.js";
-import { blockDurationMs, blockIdentity, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, generationCovers, generationOutput, generationPrompt, taskData } from "../../generation-blocks.js";
-//#region src/board/model/task.ts
+import "./board-model.js";
+import { blockDurationMs, blockIdentity, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, generationCovers, generationOutput, generationPrompt, taskData } from "./generation/blocks.js";
+//#region ../protocol/dist/board-task.js
+const BOARD_TASK_SOURCE_PREFIX = "cohub-task:";
+const boardTaskSource = (taskRunId) => `${BOARD_TASK_SOURCE_PREFIX}${taskRunId}`;
 function artifactId(base, used, suffix) {
 	const stem = cleanExcerpt(base, 220) ?? "output";
 	let candidate = suffix ? `${stem}-${suffix}` : stem;
@@ -137,23 +139,48 @@ function taskArtifactPreviewUrl(artifact) {
 function taskTypeTitle(taskType) {
 	return taskType.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+function taskRunArtifacts(run) {
+	return run.taskType === "generation" ? rankedTaskArtifacts(taskArtifacts(generationOutput(run))) : [];
+}
 function taskRunToBoardTaskSnapshot(run) {
 	const data = taskData(run);
-	const blocks = run.taskType === "generation" ? generationOutput(run) : [];
 	const promptExcerpt = run.taskType === "generation" ? generationPrompt(run) : cleanExcerpt(data?.command ?? data?.prompt ?? data?.title);
 	const model = typeof data?.model === "string" ? data.model : void 0;
-	const allArtifacts = taskArtifacts(blocks);
-	const artifacts = rankedTaskArtifacts(allArtifacts).slice(0, 6);
+	const allArtifacts = taskRunArtifacts(run);
+	const artifacts = allArtifacts.slice(0, 6);
+	const errorExcerpt = run.status === "failed" ? cleanExcerpt(run.errorMessage, 240) : void 0;
 	return {
 		taskType: run.taskType,
 		status: run.status,
 		title: promptExcerpt ?? taskTypeTitle(run.taskType),
 		...model ? { model } : {},
 		...promptExcerpt ? { promptExcerpt } : {},
+		...errorExcerpt ? { errorExcerpt } : {},
 		artifactCount: allArtifacts.length,
 		artifacts,
+		...run.startedAt ? { startedAt: run.startedAt } : {},
 		updatedAt: run.updatedAt
 	};
 }
+function withObservedArtifactFacts(snapshot, observed) {
+	if (!observed?.artifacts.length) return snapshot;
+	let changed = false;
+	const artifacts = snapshot.artifacts.map((artifact) => {
+		if (artifact.type !== "image" && artifact.type !== "video") return artifact;
+		if (artifact.naturalWidth && artifact.naturalHeight) return artifact;
+		const match = observed.artifacts.find((candidate) => candidate.id === artifact.id && candidate.type === artifact.type && candidate.url === artifact.url);
+		if (!match || match.type !== "image" && match.type !== "video" || !match.naturalWidth || !match.naturalHeight) return artifact;
+		changed = true;
+		return {
+			...artifact,
+			naturalWidth: match.naturalWidth,
+			naturalHeight: match.naturalHeight
+		};
+	});
+	return changed ? {
+		...snapshot,
+		artifacts
+	} : snapshot;
+}
 //#endregion
-export { featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot };
+export { BOARD_TASK_SOURCE_PREFIX, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts };

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

@@ -1,2 +1,3 @@
 import "./actions.js";
+import "../rtc/index.js";
 import { z } from "zod";

package/dist/protocol/dist/generation/blocks.d.ts

@@ -0,0 +1,8 @@
+//#region ../protocol/dist/generation/blocks.d.ts
+/** Tolerant readers for generation payloads, shared by every task projection. */
+type GenerationRunPayload = {
+  payload?: unknown;
+  result?: unknown;
+};
+//#endregion
+export { GenerationRunPayload };

package/dist/{generation-blocks.js → protocol/dist/generation/blocks.js}

@@ -1,8 +1,7 @@
-import { normalizeBoardRemoteUrl } from "./protocol/dist/board-url.js";
-//#region src/generation-blocks.ts
-/** Tolerant readers for generation payloads, shared by every task projection. */
+import { normalizeBoardRemoteUrl } from "../board-url.js";
+//#region ../protocol/dist/generation/blocks.js
 const EXCERPT_LIMIT = 240;
-function record(value) {
+function asRecord(value) {
 	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
 }
 function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
@@ -15,11 +14,11 @@ function blockText(block) {
 	return cleanExcerpt(block.text ?? block.content ?? block.value);
 }
 function blockUrl(block) {
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
 }
 function blockMimeType(block) {
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	const value = source?.mediaType ?? source?.media_type ?? source?.mimeType ?? block.mediaType ?? block.media_type ?? block.mimeType;
 	return typeof value === "string" ? value : void 0;
 }
@@ -27,7 +26,7 @@ function positiveNumber(value) {
 	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
 }
 function blockNaturalSize(block) {
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	const naturalWidth = positiveNumber(source?.width ?? source?.naturalWidth ?? block.width ?? block.naturalWidth);
 	const naturalHeight = positiveNumber(source?.height ?? source?.naturalHeight ?? block.height ?? block.naturalHeight);
 	return {
@@ -36,14 +35,14 @@ function blockNaturalSize(block) {
 	};
 }
 function contentBlocks(value) {
-	return Array.isArray(value) ? value.filter((item) => record(item)) : [];
+	return Array.isArray(value) ? value.filter((item) => asRecord(item)) : [];
 }
 function taskData(run) {
-	const payload = record(run.payload);
-	return record(payload?.data) ?? payload;
+	const payload = asRecord(run.payload);
+	return asRecord(payload?.data) ?? payload;
 }
 function generationOutput(run) {
-	return contentBlocks(record(run.result)?.output);
+	return contentBlocks(asRecord(run.result)?.output);
 }
 function generationPrompt(run) {
 	for (const block of contentBlocks(taskData(run)?.content)) {
@@ -52,7 +51,7 @@ function generationPrompt(run) {
 	}
 }
 function blockMeta(block) {
-	return record(block.meta);
+	return asRecord(block.meta);
 }
 function blockIdentity(block) {
 	const meta = blockMeta(block);
@@ -64,7 +63,7 @@ function blockTitle(block) {
 	return cleanExcerpt(blockMeta(block)?.title ?? block.title ?? block.name, 240);
 }
 function blockDurationMs(block) {
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	const meta = blockMeta(block);
 	const milliseconds = positiveNumber(source?.durationMs ?? meta?.durationMs ?? block.durationMs);
 	if (milliseconds) return Math.round(milliseconds);
@@ -72,7 +71,7 @@ function blockDurationMs(block) {
 	return seconds ? Math.round(seconds * 1e3) : void 0;
 }
 function blockPreviewUrl(block) {
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	return normalizeBoardRemoteUrl(source?.poster ?? source?.thumbnail ?? source?.previewUrl ?? block.poster ?? block.thumbnail ?? block.previewUrl);
 }
 /**
@@ -122,4 +121,4 @@ function generationCovers(blocks) {
 	return covers;
 }
 //#endregion
-export { blockDurationMs, blockIdentity, blockMeta, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, contentBlocks, generationCovers, generationOutput, generationPrompt, positiveNumber, record, taskData };
+export { asRecord, blockDurationMs, blockIdentity, blockMeta, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, contentBlocks, generationCovers, generationOutput, generationPrompt, positiveNumber, taskData };

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

@@ -1,4 +1,4 @@
-import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardSketchItem, BoardSketchItemSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem } from "./board-model.js";
+import { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource } from "./board-model.js";
 import { BoardFrame, BoardItemLookup, BoardLayout, BoardMatrix, BoardRect, BoardTextLayout, BoardTextMeasurer, IDENTITY_MATRIX, anchorPoint, applyMatrix, arrowBindings, autoAnchorSide, bendControl, clampBoardFontSize, createBoardLayout, createDocumentLayout, drawPointsBounds, drawSampleRadius, estimateTextWidth, framePoint, invertMatrix, isArrowBinding, layoutBoardText, multiplyMatrix, pointsRect, rotateAround, scaleVector, setBoardTextMeasurer, sideAnchor } from "./board-layout.js";
 import { BoardApplyOptions, BoardPatchResult, BoardPropertySpec, BoardState, BoardValueKind, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, boardPatchTouches, createDocumentState, diffBoardDocuments, diffMergePatch, isEmptyBoardPatch, listBoardProperties, mergePatch, parseBoardDocument, pruneBoardTrack, resolveBoardProperty, trackReferences } from "./board-patch.js";
 import "./app-authorization.js";
@@ -6,9 +6,14 @@ import { RequestSource, RequestSourceVia } from "./provenance.js";
 import { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BoardApplyResult, BoardChangeSummary, BoardHistoryPage, BoardManifest, BoardManifestSchema, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardReadResult, BoardTransactionRecord, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
 import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } from "./board-constants.js";
 import "./board-content.js";
+import "./board-assets.js";
 import { BOARD_SCHEMA_TARGETS, BoardJsonSchemaResult, boardJsonSchema, boardSchemaOverview } from "./board-schema.js";
+import { GenerationRunPayload } from "./generation/blocks.js";
+import { TaskRunStatus } from "./task/index.js";
+import { BOARD_TASK_SOURCE_PREFIX, BoardTaskRunSource, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts } from "./board-task.js";
 import "./board-upgrade.js";
 import { isPublicBoardRemoteAddress, normalizeBoardRemoteUrl } from "./board-url.js";
+import "./rtc/index.js";
 import "./display/index.js";
 import "./runtime/index.js";
 import "./model/turn.js";
@@ -18,4 +23,4 @@ import "./app.js";
 import "./realtime/types.js";
 import "./app-catalog.js";
 import "./host-bridge.js";
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardSketchItem, BoardSketchItemSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, IDENTITY_MATRIX, RequestSource, RequestSourceVia, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, pointsRect, pruneBoardTrack, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, trackReferences };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, RequestSource, RequestSourceVia, TaskRunStatus, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };

package/dist/protocol/dist/realtime/types.d.ts

@@ -1,5 +1,6 @@
 import "../board-model.js";
 import "../board.js";
+import "../rtc/index.js";
 import "../model/turn.js";
 import "../model/metrics.js";
 import "../model/session.js";

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

@@ -0,0 +1 @@
+import { z } from "zod";

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

@@ -0,0 +1,4 @@
+//#region ../protocol/dist/task/index.d.ts
+type TaskRunStatus = "pending" | "running" | "completed" | "failed";
+//#endregion
+export { TaskRunStatus };