@neta-art/cohub 5.7.0 → 5.8.0

package/dist/board/nodes.js

@@ -0,0 +1,154 @@
+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 };

package/dist/board/render/index.d.ts

@@ -1,8 +1,10 @@
 import { ConnectionLayer, ConnectionRenderInput, createConnectionLayer, framesFromItems } from "./connection-layer.js";
+import { BoardMediaAction, boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible } from "./media-interaction.js";
 import { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { defaultBoardPalette } from "./palette.js";
 import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
 import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { BoardThemeContext, BoardThemeRenderer, getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
-export { BoardCardRenderer, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, ConnectionLayer, ConnectionRenderInput, TASK_CARD_FULL_DETAIL_ZOOM, boardCardRenderersForTest, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };
+import { VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
+export { BoardCardRenderer, BoardMediaAction, BoardRenderContext, BoardRenderPalette, BoardThemeContext, BoardThemeRenderer, ConnectionLayer, ConnectionRenderInput, TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/index.js

@@ -1,8 +1,10 @@
 import { getBoardResolution, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket } from "./text-resolution.js";
 import { createConnectionLayer, framesFromItems } from "./connection-layer.js";
+import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
+import { boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible } from "./media-interaction.js";
 import { defaultBoardPalette } from "./palette.js";
 import { ensureBoardTextMeasurement, installBoardTextMeasurement } from "./text-measurement.js";
-import { TASK_CARD_FULL_DETAIL_ZOOM } from "./renderers/task-card-renderer.js";
 import { boardCardRenderersForTest, getBoardCardRenderer, registerBoardCardRenderer } from "./renderers/board-renderer-registry.js";
 import { getBoardThemeRenderer, registerBoardThemeRenderer } from "./themes/board-theme-registry.js";
-export { TASK_CARD_FULL_DETAIL_ZOOM, boardCardRenderersForTest, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket };
+import { VIDEO_THUMBNAIL_MAX_EDGE, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize } from "./video-thumbnail.js";
+export { TASK_CARD_FULL_DETAIL_ZOOM, VIDEO_THUMBNAIL_MAX_EDGE, boardCardRenderersForTest, boardMediaActionAt, createConnectionLayer, defaultBoardPalette, ensureBoardTextMeasurement, framesFromItems, getBoardCardRenderer, getBoardResolution, getBoardThemeRenderer, installBoardTextMeasurement, loadVideoThumbnailTexture, mediaPlayBadgeHit, mediaPlayBadgeVisible, registerBoardCardRenderer, registerBoardThemeRenderer, syncTextResolution, syncTextWrapWidth, textResolutionForZoom, textZoomBucket, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/media-interaction.d.ts

@@ -0,0 +1,19 @@
+import { BoardItem } from "../../protocol/dist/board-document.js";
+import { WorldPoint } from "../geometry.js";
+//#region src/board/render/media-interaction.d.ts
+type BoardMediaAction = {
+  action: "play-media";
+  itemId: string;
+};
+declare function mediaPlayBadgeVisible(item: BoardItem, zoom: number, options: {
+  materialized: boolean;
+  hasVideoPreview: boolean;
+}): boolean;
+/** The central badge is a fixed screen-space target, independent of Board zoom. */
+declare function mediaPlayBadgeHit(item: BoardItem, point: WorldPoint, zoom: number): boolean;
+declare function boardMediaActionAt(item: BoardItem, point: WorldPoint, zoom: number, options: {
+  materialized: boolean;
+  hasVideoPreview: boolean;
+}): BoardMediaAction | null;
+//#endregion
+export { BoardMediaAction, boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible };

package/dist/board/render/media-interaction.js

@@ -0,0 +1,26 @@
+import { featuredTaskArtifact } from "../task.js";
+import "./renderers/task-card-renderer.js";
+//#region src/board/render/media-interaction.ts
+function mediaPlayBadgeVisible(item, zoom, options) {
+	if (!options.materialized) return false;
+	if (item.type === "video" || item.type === "audio") return true;
+	if (item.type !== "task" || zoom < .55) return false;
+	const artifact = featuredTaskArtifact(item.snapshot.artifacts);
+	if (artifact?.type === "audio") return true;
+	return artifact?.type === "video" && (Boolean(artifact.previewUrl) || options.hasVideoPreview);
+}
+/** The central badge is a fixed screen-space target, independent of Board zoom. */
+function mediaPlayBadgeHit(item, point, zoom) {
+	const radius = 28 / Math.max(zoom, .05);
+	const centerX = item.frame.x + item.frame.width / 2;
+	const centerY = item.frame.y + item.frame.height / 2;
+	return Math.hypot(point.x - centerX, point.y - centerY) <= radius;
+}
+function boardMediaActionAt(item, point, zoom, options) {
+	return mediaPlayBadgeVisible(item, zoom, options) && mediaPlayBadgeHit(item, point, zoom) ? {
+		action: "play-media",
+		itemId: item.id
+	} : null;
+}
+//#endregion
+export { boardMediaActionAt, mediaPlayBadgeHit, mediaPlayBadgeVisible };

package/dist/board/render/renderers/audio-card-renderer.js

@@ -1,8 +1,8 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { syncTextResolution, syncTextWrapWidth, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { drawAudioWaveform } from "../audio-waveform.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/audio-card-renderer.ts
 const RADIUS = 4;

package/dist/board/render/renderers/board-renderer-registry.js

@@ -1,12 +1,12 @@
+import { fileCardRenderer } from "./file-card-renderer.js";
+import { taskCardRenderer } from "./task-card-renderer.js";
 import { ensureBoardTextMeasurement } from "../text-measurement.js";
 import { arrowCardRenderer } from "./arrow-card-renderer.js";
 import { audioCardRenderer } from "./audio-card-renderer.js";
 import { drawCardRenderer } from "./draw-card-renderer.js";
-import { fileCardRenderer } from "./file-card-renderer.js";
 import { frameCardRenderer } from "./frame-card-renderer.js";
 import { geoCardRenderer } from "./geo-card-renderer.js";
 import { imageCardRenderer } from "./image-card-renderer.js";
-import { taskCardRenderer } from "./task-card-renderer.js";
 import { textCardRenderer } from "./text-card-renderer.js";
 import { unknownCardRenderer } from "./unknown-card-renderer.js";
 import { videoCardRenderer } from "./video-card-renderer.js";

package/dist/board/render/renderers/draw-card-renderer.js

@@ -1,7 +1,7 @@
 import { buildStrokeOutline, computeDrawBounds } from "../../core/draw-geometry.js";
 import { pickBoardColor } from "../../core/palette.js";
-import { drawFarStroke } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarStroke } from "./far-plate.js";
 import { Container, Graphics } from "pixi.js";
 //#region src/board/render/renderers/draw-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();

package/dist/board/render/renderers/file-card-renderer.js

@@ -1,8 +1,8 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { fileBaseName, filePreviewKind } from "../../core/file-preview.js";
 import { syncTextResolution } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { CanvasTextMetrics, Container, Graphics, Sprite, Text, Texture } from "pixi.js";
 //#region src/board/render/renderers/file-card-renderer.ts
 /**

package/dist/board/render/renderers/frame-card-renderer.js

@@ -1,8 +1,8 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { pickBoardColor } from "../../core/palette.js";
 import { syncTextResolution } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { createLabel, positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics } from "pixi.js";
 //#region src/board/render/renderers/frame-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();

package/dist/board/render/renderers/geo-card-renderer.js

@@ -1,8 +1,8 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { pickBoardColor } from "../../core/palette.js";
 import { syncTextResolution, syncTextWrapWidth, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/geo-card-renderer.ts
 const RADIUS = 8;

package/dist/board/render/renderers/image-card-renderer.js

@@ -1,5 +1,5 @@
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Sprite, Texture } from "pixi.js";
 //#region src/board/render/renderers/image-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();

package/dist/board/render/renderers/task-card-renderer.js

@@ -1,8 +1,9 @@
 import { BOARD_FONT_STACK, BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
+import { featuredTaskArtifact } from "../../task.js";
 import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { drawAudioWaveform } from "../audio-waveform.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { fitTextToLines } from "./file-card-renderer.js";
 import { Container, Graphics, Sprite, Text } from "pixi.js";
 //#region src/board/render/renderers/task-card-renderer.ts
@@ -12,12 +13,11 @@ const META_HEIGHT = 28;
 const TASK_CARD_FULL_DETAIL_ZOOM = .55;
 const PLAY_BADGE_RADIUS = 15;
 const partsByContainer = /* @__PURE__ */ new WeakMap();
-function previewKindFor(item) {
-	const output = item.snapshot.primaryOutput;
-	if (!output) return "empty";
-	if (output.type === "image" || output.type === "video") return "texture";
-	if (output.type === "audio") return "waveform";
-	return output.textExcerpt ? "text" : "empty";
+function previewKindFor(artifact) {
+	if (!artifact) return "empty";
+	if (artifact.type === "image" || artifact.type === "video") return "texture";
+	if (artifact.type === "audio") return artifact.previewUrl ? "texture" : "waveform";
+	return artifact.textExcerpt ? "text" : "empty";
 }
 function stateSurfaceFor(item, kind, hasTexture, previewFailed) {
 	if (kind === "texture" && !hasTexture) {
@@ -46,7 +46,8 @@ function statusColor(item, context) {
 	return context.colors.neutral.stroke;
 }
 function metadata(item) {
-	const extra = item.snapshot.outputCount > 1 ? `+${item.snapshot.outputCount - 1}` : null;
+	const { artifactCount, artifacts } = item.snapshot;
+	const extra = artifactCount > artifacts.length ? `${artifacts.length}/${artifactCount}` : artifactCount > 1 ? `+${artifactCount - 1}` : null;
 	return [item.snapshot.model, extra].filter(Boolean).join(" · ");
 }
 /** Scale a texture into a frame without cropping or distortion. */
@@ -169,7 +170,8 @@ function sync(container, item, context) {
 	}
 	const texture = key ? context.getTexture(key) : null;
 	const previewFailed = Boolean(key && !texture && context.hasError(key));
-	const kind = previewKindFor(item);
+	const artifact = featuredTaskArtifact(item.snapshot.artifacts);
+	const kind = previewKindFor(artifact);
 	const surface = stateSurfaceFor(item, kind, Boolean(texture), previewFailed);
 	const frame = {
 		x: 1,
@@ -177,7 +179,7 @@ function sync(container, item, context) {
 		width: Math.max(1, width - 2),
 		height: Math.max(1, height - 2)
 	};
-	const metaText = item.snapshot.primaryOutput ? metadata(item) : "";
+	const metaText = artifact ? metadata(item) : "";
 	const showMeta = full && Boolean(metaText);
 	const failedWithOutput = item.snapshot.status === "failed" && kind !== "empty";
 	syncTextResolution(parts.body, parts, context.zoom);
@@ -193,7 +195,8 @@ function sync(container, item, context) {
 		surface,
 		showMeta,
 		failedWithOutput,
-		item.snapshot.primaryOutput?.type ?? "none",
+		artifact?.type ?? "none",
+		artifact?.id ?? "none",
 		item.taskRunId,
 		texture ? `${texture.width}x${texture.height}` : "none",
 		context.palette.surface,
@@ -227,7 +230,7 @@ function sync(container, item, context) {
 				height: Math.max(1, frame.height - PADDING * 2 - bottomInset)
 			}, context.colors.brand.stroke);
 		}
-		if (full && (item.snapshot.primaryOutput?.type === "audio" || item.snapshot.primaryOutput?.type === "video" && texture)) drawPlayBadge(parts.previewArt, frame, context);
+		if (full && (artifact?.type === "audio" || artifact?.type === "video" && texture)) drawPlayBadge(parts.previewArt, frame, context);
 		if (surface) {
 			const markY = frame.y + frame.height / 2 - (full && stateLabel(surface) ? 10 : 0);
 			drawStateMark(parts.previewArt, surface, frame.x + frame.width / 2, markY, surface === "failed" ? color : context.colors.neutral.stroke);
@@ -246,7 +249,7 @@ function sync(container, item, context) {
 		parts.preview.width = fitted.width;
 		parts.preview.height = fitted.height;
 	}
-	const bodyText = kind === "text" ? item.snapshot.primaryOutput?.textExcerpt ?? "" : stateLabel(surface);
+	const bodyText = kind === "text" && artifact?.type === "text" ? artifact.textExcerpt : stateLabel(surface);
 	const textSig = [
 		bodyText,
 		metaText,

package/dist/board/render/renderers/text-card-renderer.js

@@ -2,8 +2,8 @@ import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { TEXT_FONT_SIZE, boardTextLineHeight, clampBoardTextFontSize, measureBoardText } from "../../core/text-metrics.js";
 import { pickBoardColor } from "../../core/palette.js";
 import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Text } from "pixi.js";
 //#region src/board/render/renderers/text-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();

package/dist/board/render/renderers/unknown-card-renderer.js

@@ -1,8 +1,8 @@
 import { BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { unknownRealType } from "../../../protocol/dist/board-document.js";
 import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/unknown-card-renderer.ts
 const RADIUS = 10;

package/dist/board/render/renderers/video-card-renderer.js

@@ -1,7 +1,7 @@
 import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { syncTextResolution, syncTextWrapWidth, textResolutionForZoom } from "../text-resolution.js";
-import { drawFarPlate } from "./far-plate.js";
 import { positionShell } from "./base-card-renderer.js";
+import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Sprite, Text, Texture } from "pixi.js";
 //#region src/board/render/renderers/video-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();

package/dist/board/render/video-thumbnail.d.ts

@@ -0,0 +1,16 @@
+import { Texture } from "pixi.js";
+//#region src/board/render/video-thumbnail.d.ts
+declare const VIDEO_THUMBNAIL_MAX_EDGE = 960;
+type VideoNaturalSize = {
+  width: number;
+  height: number;
+};
+declare function videoThumbnailSize(width: number, height: number, maxEdge?: number): {
+  width: number;
+  height: number;
+};
+declare function videoTextureNaturalSize(texture: Texture): VideoNaturalSize | null;
+/** Decode one static, bounded preview frame without starting playback. */
+declare function loadVideoThumbnailTexture(url: string): Promise<Texture>;
+//#endregion
+export { VIDEO_THUMBNAIL_MAX_EDGE, VideoNaturalSize, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/render/video-thumbnail.js

@@ -0,0 +1,86 @@
+import { Texture } from "pixi.js";
+//#region src/board/render/video-thumbnail.ts
+const VIDEO_THUMBNAIL_MAX_EDGE = 960;
+const VIDEO_LOAD_TIMEOUT_MS = 15e3;
+const FRAME_PRESENT_TIMEOUT_MS = 250;
+const naturalSizeByTexture = /* @__PURE__ */ new WeakMap();
+function videoThumbnailSize(width, height, maxEdge = 960) {
+	if (width <= 0 || height <= 0 || maxEdge <= 0) throw new Error("Video has no displayable frame");
+	const scale = Math.min(1, maxEdge / Math.max(width, height));
+	return {
+		width: Math.max(1, Math.round(width * scale)),
+		height: Math.max(1, Math.round(height * scale))
+	};
+}
+function waitForFirstFrame(video) {
+	if (video.readyState >= 2) return Promise.resolve();
+	return new Promise((resolve, reject) => {
+		const timeout = setTimeout(() => finish(/* @__PURE__ */ new Error("Video preview timed out")), VIDEO_LOAD_TIMEOUT_MS);
+		const onLoaded = () => finish();
+		const onError = () => finish(/* @__PURE__ */ new Error("Video preview could not be decoded"));
+		function finish(error) {
+			clearTimeout(timeout);
+			video.removeEventListener("loadeddata", onLoaded);
+			video.removeEventListener("error", onError);
+			if (error) reject(error);
+			else resolve();
+		}
+		video.addEventListener("loadeddata", onLoaded, { once: true });
+		video.addEventListener("error", onError, { once: true });
+	});
+}
+function waitForPresentedFrame(video) {
+	if (!video.requestVideoFrameCallback) return new Promise((resolve) => requestAnimationFrame(() => resolve()));
+	return new Promise((resolve) => {
+		let settled = false;
+		let timeout;
+		const finish = () => {
+			if (settled) return;
+			settled = true;
+			clearTimeout(timeout);
+			resolve();
+		};
+		const handle = video.requestVideoFrameCallback(finish);
+		timeout = setTimeout(() => {
+			video.cancelVideoFrameCallback?.(handle);
+			finish();
+		}, FRAME_PRESENT_TIMEOUT_MS);
+	});
+}
+function videoTextureNaturalSize(texture) {
+	return naturalSizeByTexture.get(texture) ?? null;
+}
+/** Decode one static, bounded preview frame without starting playback. */
+async function loadVideoThumbnailTexture(url) {
+	const video = document.createElement("video");
+	video.muted = true;
+	video.playsInline = true;
+	video.preload = "auto";
+	if (/^https?:/i.test(url)) video.crossOrigin = "anonymous";
+	try {
+		const ready = waitForFirstFrame(video);
+		video.src = url;
+		video.load();
+		await ready;
+		await waitForPresentedFrame(video);
+		const size = videoThumbnailSize(video.videoWidth, video.videoHeight);
+		const canvas = document.createElement("canvas");
+		canvas.width = size.width;
+		canvas.height = size.height;
+		const context = canvas.getContext("2d", { alpha: false });
+		if (!context) throw new Error("Canvas is not supported");
+		context.drawImage(video, 0, 0, size.width, size.height);
+		const texture = Texture.from(canvas);
+		naturalSizeByTexture.set(texture, {
+			width: video.videoWidth,
+			height: video.videoHeight
+		});
+		return texture;
+	} finally {
+		video.pause();
+		video.removeAttribute("src");
+		video.load();
+	}
+}
+//#endregion
+export { VIDEO_THUMBNAIL_MAX_EDGE, loadVideoThumbnailTexture, videoTextureNaturalSize, videoThumbnailSize };

package/dist/board/task.d.ts

@@ -1,15 +1,20 @@
-import { BoardTaskSnapshot } from "../protocol/dist/board-document.js";
+import { BoardTaskArtifact, BoardTaskSnapshot } from "../protocol/dist/board-document.js";
 import { TaskRunRecord } from "../types.js";
 //#region src/board/task.d.ts
 /**
- * Normalize a persistable remote media URL and reject credentialed or visibly
- * non-public hosts. Server-side fetchers must still validate resolved DNS addresses.
+ * Group provider blocks into user-facing works. A cover/poster sharing a stable
+ * provider id with playable media belongs to that work instead of becoming a
+ * competing image result.
  */
-declare function normalizeBoardTaskOutputUrl(value: unknown): string | undefined;
+declare function taskArtifacts(blocks: Record<string, unknown>[]): BoardTaskArtifact[];
+/** Highest-value artifact first, with provider order as the stable final tie. */
+declare function rankedTaskArtifacts(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact[];
+declare function featuredTaskArtifact(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact | undefined;
+declare function taskArtifactPreviewUrl(artifact: BoardTaskArtifact | undefined): string | undefined;
 /**
  * Project an authoritative TaskRun into a small, replaceable Board display cache.
  * Raw payloads, complete results and inline media are never copied into the Board.
  */
 declare function taskRunToBoardTaskSnapshot(run: TaskRunRecord): BoardTaskSnapshot;
 //#endregion
-export { normalizeBoardTaskOutputUrl, taskRunToBoardTaskSnapshot };
+export { featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot };