@neta-art/cohub 5.4.3 → 5.6.0

package/README.md

@@ -124,6 +124,16 @@ const stop = board.subscribe({
 stop();
 ```
 
+Task nodes keep a small, replaceable display snapshot beside their stable `taskRunId`. The SDK can build that projection from an authoritative TaskRun without copying the full payload, result or inline media into a Board:
+
+```ts
+import { taskRunToBoardTaskSnapshot } from "@neta-art/cohub/board";
+
+const snapshot = taskRunToBoardTaskSnapshot(taskRun);
+```
+
+Use `client.tasks.getMany(ids, { spaceId })` to restore the TaskRuns for a Board in one request. The server applies the same Space permissions and result sanitization as the regular task list endpoint.
+
 Board is split by dependency: the model runs anywhere, drawing needs PixiJS.
 `@neta-art/cohub/board` carries the document schema, geometry, the shape layer,
 timeline compilation and export planning, with no renderer and no PixiJS — so

package/dist/board/codec.js

@@ -1,5 +1,5 @@
 import { BOARD_DOCUMENT_KIND, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
-import { BoardAppearanceSchema, BoardFileSnapshotSchema, UNKNOWN_BOARD_ITEM_TYPE, parseBoardDocument } from "../protocol/dist/board-document.js";
+import { BoardAppearanceSchema, BoardFileSnapshotSchema, BoardTaskSnapshotSchema, UNKNOWN_BOARD_ITEM_TYPE, parseBoardDocument } from "../protocol/dist/board-document.js";
 import { TEXT_FONT_SIZE, clampBoardTextFontSize } from "./core/text-metrics.js";
 import "../protocol/dist/index.js";
 //#region src/board/codec.ts
@@ -83,6 +83,24 @@ function pointFromData(value) {
 		y: 0
 	};
 }
+function unknownItemFromNode(node, frame, style, locked, data) {
+	const raw = {
+		...data,
+		id: node.nodeId,
+		type: node.type,
+		frame
+	};
+	if (style) raw.style = style;
+	if (locked) raw.locked = true;
+	return {
+		id: node.nodeId,
+		type: UNKNOWN_BOARD_ITEM_TYPE,
+		frame,
+		...locked ? { locked } : {},
+		style,
+		raw
+	};
+}
 function boardNodeToItemValue(node) {
 	const frame = frameFromNode(node);
 	const style = styleFromNode(node);
@@ -191,24 +209,20 @@ function boardNodeToItemValue(node) {
 				style
 			};
 		}
-		default: {
-			const raw = {
-				...data,
+		case "task": {
+			const parsed = BoardTaskSnapshotSchema.safeParse(node.view ?? {});
+			if (parsed.success && typeof data.taskRunId === "string") return {
 				id: node.nodeId,
-				type: node.type,
-				frame
-			};
-			if (style) raw.style = style;
-			if (locked) raw.locked = true;
-			return {
-				id: node.nodeId,
-				type: UNKNOWN_BOARD_ITEM_TYPE,
+				type: "task",
+				taskRunId: data.taskRunId,
+				snapshot: parsed.data,
 				frame,
 				...locked ? { locked } : {},
-				style,
-				raw
+				style
 			};
+			return unknownItemFromNode(node, frame, style, locked, data);
 		}
+		default: return unknownItemFromNode(node, frame, style, locked, data);
 	}
 }
 function boardNodeToItem(node) {

package/dist/board/image-key.js

@@ -16,6 +16,13 @@ function imageAssetKey(item) {
 		if (snapshot?.coverUrl) return `url:${snapshot.coverUrl}`;
 		return null;
 	}
+	if (item.type === "task") {
+		const output = item.snapshot.primaryOutput;
+		if (output?.type === "image" || output?.type === "video") {
+			const url = output.url;
+			return url ? `url:${url}` : null;
+		}
+	}
 	return null;
 }
 /** The source a key resolves from, recovered from its namespace prefix. */

package/dist/board/index.d.ts

@@ -2,7 +2,7 @@ import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } fr
 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 "../protocol/dist/board-connection.js";
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardManifest, BoardNodeRecord, BoardRecord, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
 import { BoardExtensionDefinition, BoardExtensionRegistry, BoardPresetDefinition, CompiledSequence, DEFAULT_BOARD_LIMITS, QualityProfile, RenderBounds, TimelineClipInput, TimelineInput, clip, compileSequence, createBoardExtensionRegistry, timeline } from "./animation.js";
-import { BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections } from "../protocol/dist/board-document.js";
+import { BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskOutput, BoardTaskOutputSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections } from "../protocol/dist/board-document.js";
 import { BOARD_NODE_SOURCE, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, WireBackedBoardItem, boardBootstrapToDocument, boardNodeToItem, isRecord, nodeInputFromRecord, sourceForItem } from "./codec.js";
 import { CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CornerResizeHandle, EDGE_RESIZE_HANDLES, FIT_PADDING, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, ResizeHandle, ScreenPoint, Size, VIEWPORT_MARGIN_RATIO, WorldPoint, angleFromCenter, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, panBy, pointToWorld, radToDeg, rectCenter, rectContainsPoint, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenPoint, screenToWorld, selectionBounds, unionRects, visibleWorldRect, worldPoint, worldToScreen, zoomAround } from "./geometry.js";
 import { ResolvedArrow, arrowBounds, arrowFrame, distanceToArrow, resolveArrow, sampleArrow, translateArrow } from "./core/arrow-geometry.js";
@@ -17,4 +17,5 @@ import { ShapeDefinition, definitionForItem, getShapeDefinition, registerShapeDe
 import { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardTextLineHeight, clampBoardTextFontSize, measureBoardText, setBoardTextMeasurer } from "./core/text-metrics.js";
 import { BoardStyledToolId, BoardToolStyleMap, BoardToolStylePatch, DEFAULT_BOARD_TOOL_STYLES, createBoardToolStyles } from "./core/tool-styles.js";
 import { boardImageKeySource, imageAssetKey } from "./image-key.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, type ArrowShapeProps, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_NODE_SOURCE, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardColorEntry, BoardColorId, BoardColorValue, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionDefinition, BoardExtensionRegistry, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotFacts, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, type BoardManifest, BoardMediaSnapshot, BoardMediaSnapshotSchema, type BoardNodeRecord, BoardPoint, BoardPointSchema, BoardPresetDefinition, type BoardRecord, BoardRelationSchema, BoardShapeColors, BoardStyledToolId, BoardTextItem, BoardTextItemSchema, BoardToolStyleMap, BoardToolStylePatch, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BuildSnapshotInput, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompiledSequence, ConnectionIndex, CornerResizeHandle, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPoint, DrawPointSchema, type DrawShapeProps, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, FilePreviewKind, FrameLookup, GEO_KINDS, type GeoKind, type GeoShapeProps, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, type HandleDragResult, ITEM_BASE_KEYS, type ImageShapeProps, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, QualityProfile, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, RenderBounds, ResizeHandle, ResolvedArrow, ResolvedConnection, ResolvedConnectionEndpoint, ResolvedCover, ScreenPoint, type ShapeCapabilities, ShapeDefinition, type ShapeGeometry, type ShapeHandle, type ShapeHandleId, type ShapeResizeMode, Size, SpaceFileRef, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, type TextShapeProps, TimelineClipInput, TimelineInput, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, type VideoShapeProps, WireBackedBoardItem, WorldPoint, anchorPointOnFrame, anchorToWorld, angleFromCenter, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeRotation, normalizeViewport, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, pathMidpoint, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldPoint, worldToAnchor, worldToScreen, zoomAround };
+import { normalizeBoardTaskOutputUrl, taskRunToBoardTaskSnapshot } from "./task.js";
+export { AUTO_BOARD_CONNECTION_ANCHOR, type ArrowShapeProps, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_NODE_SOURCE, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardColorEntry, BoardColorId, BoardColorValue, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardExportAssetSelection, BoardExportPlan, BoardExportPlanInput, BoardExportRegion, BoardExtensionDefinition, BoardExtensionRegistry, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotFacts, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, type BoardManifest, BoardMediaSnapshot, BoardMediaSnapshotSchema, type BoardNodeRecord, BoardPoint, BoardPointSchema, BoardPresetDefinition, type BoardRecord, BoardRelationSchema, BoardShapeColors, BoardStyledToolId, BoardTaskItem, BoardTaskItemSchema, BoardTaskOutput, BoardTaskOutputSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardToolStyleMap, BoardToolStylePatch, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, BuildSnapshotInput, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, CompiledSequence, ConnectionIndex, CornerResizeHandle, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPoint, DrawPointSchema, type DrawShapeProps, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, FileAvailability, FilePreviewKind, FrameLookup, GEO_KINDS, type GeoKind, type GeoShapeProps, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, type HandleDragResult, ITEM_BASE_KEYS, type ImageShapeProps, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, Point, QualityProfile, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, Rect, RenderBounds, ResizeHandle, ResolvedArrow, ResolvedConnection, ResolvedConnectionEndpoint, ResolvedCover, ScreenPoint, type ShapeCapabilities, ShapeDefinition, type ShapeGeometry, type ShapeHandle, type ShapeHandleId, type ShapeResizeMode, Size, SpaceFileRef, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, type TextShapeProps, TimelineClipInput, TimelineInput, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, type VideoShapeProps, WireBackedBoardItem, WorldPoint, anchorPointOnFrame, anchorToWorld, angleFromCenter, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardTaskOutputUrl, normalizeRotation, normalizeViewport, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, pathMidpoint, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, taskRunToBoardTaskSnapshot, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldPoint, worldToAnchor, worldToScreen, zoomAround };

package/dist/board/index.js

@@ -2,7 +2,7 @@ import { BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, clampBoardStrokeSize } fr
 import { BoardExtensionRegistry, DEFAULT_BOARD_LIMITS, clip, compileSequence, createBoardExtensionRegistry, timeline } from "./animation.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 "../protocol/dist/board-connection.js";
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "../protocol/dist/board.js";
-import { BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections } from "../protocol/dist/board-document.js";
+import { BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardTaskItemSchema, BoardTaskOutputSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections } from "../protocol/dist/board-document.js";
 import { TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, boardTextLineHeight, clampBoardTextFontSize, measureBoardText, setBoardTextMeasurer } from "./core/text-metrics.js";
 import { BOARD_NODE_SOURCE, DEFAULT_BOARD_APPEARANCE, ITEM_BASE_KEYS, boardBootstrapToDocument, boardNodeToItem, isRecord, nodeInputFromRecord, sourceForItem } from "./codec.js";
 import { CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, EDGE_RESIZE_HANDLES, FIT_PADDING, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, VIEWPORT_MARGIN_RATIO, angleFromCenter, clamp, clampZoom, degToRad, expandRect, fitToContent, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, handlePosition, itemBounds, normalizeRotation, normalizeViewport, panBy, pointToWorld, radToDeg, rectCenter, rectContainsPoint, rectsIntersect, resizeFrame, resizeFrameToSize, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, scaleFrames, screenPoint, screenToWorld, selectionBounds, unionRects, visibleWorldRect, worldPoint, worldToScreen, zoomAround } from "./geometry.js";
@@ -17,4 +17,5 @@ import { BOARD_COLORS, DEFAULT_BOARD_COLOR, boardColorCssVar, buildFallbackShape
 import { FULL_CAPABILITIES, GEO_KINDS, isGeoKind, resizeModeForCapabilities } from "./core/shape-types.js";
 import { definitionForItem, getShapeDefinition, registerShapeDefinition, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, unknownShapeDefinition } from "./core/shape-definition.js";
 import { DEFAULT_BOARD_TOOL_STYLES, createBoardToolStyles } from "./core/tool-styles.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_NODE_SOURCE, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAppearanceSchema, BoardArrowItemSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardRelationSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPointSchema, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, GEO_KINDS, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, ITEM_BASE_KEYS, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, anchorPointOnFrame, anchorToWorld, angleFromCenter, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeRotation, normalizeViewport, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, pathMidpoint, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldPoint, worldToAnchor, worldToScreen, zoomAround };
+import { normalizeBoardTaskOutputUrl, taskRunToBoardTaskSnapshot } from "./task.js";
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLORS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXPORT_DEFAULT_PADDING, BOARD_EXPORT_DEFAULT_SCALE, BOARD_EXPORT_ITEM_WARN_THRESHOLD, BOARD_EXPORT_MAX_EDGE, BOARD_EXPORT_MAX_PIXELS, BOARD_EXPORT_MAX_TEXTURES, BOARD_EXTENSION, BOARD_NODE_SOURCE, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAppearanceSchema, BoardArrowItemSchema, BoardConnectionAnchorSchema, BoardConnectionEndpointSchema, BoardConnectionPatchSchema, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardExtensionRegistry, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardRelationSchema, BoardTaskItemSchema, BoardTaskOutputSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, CONNECTION_ENDPOINT_GAP, CORNER_RESIZE_HANDLES, CORNER_ROTATION_ZONE_WIDTH, DEFAULT_BOARD_APPEARANCE, DEFAULT_BOARD_COLOR, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_LIMITS, DEFAULT_BOARD_RELATION, DEFAULT_BOARD_TOOL_STYLES, DrawPointSchema, EDGE_RESIZE_HANDLES, FILE_EXCERPT_MAX_BYTES, FILE_EXCERPT_MAX_CHARS, FIT_PADDING, FULL_CAPABILITIES, GEO_KINDS, HANDLE_DIRECTION, HANDLE_HIT_RADIUS, ITEM_BASE_KEYS, InvalidBoardFileError, KNOWN_BOARD_ITEM_TYPES, MAX_BOARD_ZOOM, MIN_BOARD_ZOOM, MIN_ITEM_SIZE, RESIZE_HANDLES, ROTATION_HANDLE_OFFSET, SpaceFileRefSchema, TEXT_FONT_FAMILY, TEXT_FONT_SIZE, TEXT_LINE_HEIGHT, TEXT_MAX_FONT_SIZE, TEXT_MIN_FONT_SIZE, UNKNOWN_BOARD_ITEM_TYPE, VIEWPORT_MARGIN_RATIO, anchorPointOnFrame, anchorToWorld, angleFromCenter, arrowBounds, arrowFrame, autoConnectionSide, availabilityFromError, boardBootstrapToDocument, boardColorCssVar, boardFrameLookup, boardImageKeySource, boardNodeToItem, boardTextLineHeight, buildFallbackShapeColors, buildFileExcerpt, buildFileSnapshot, buildStrokeOutline, clamp, clampBoardStrokeSize, clampBoardTextFontSize, clampZoom, clip, compileSequence, computeDrawBounds, connectionArrowheads, connectionBounds, connectionHitTest, connectionNodeIds, connectionOtherNodeId, connectionTouchesNode, createBoardConnection, createBoardExtensionRegistry, createBoardToolStyles, createConnectionIndex, definitionForItem, degToRad, distanceToArrow, distanceToConnection, distanceToStroke, expandRect, exportConnectionBounds, exportItemBounds, fileBaseName, filePreviewKind, filePreviewMemoKey, filePreviewScope, fileTypeLabel, fitToContent, flipBoardConnection, formatFileSize, frameContainsPoint, frameCornerRotationHandleAt, frameCorners, frameEdgeHandleAt, frameHandlePosition, frameRayIntersection, frameRect, getShapeDefinition, handlePosition, imageAssetKey, isBoardColorId, isBoardPath, isFileBackedItem, isFileSnapshotFresh, isGeoKind, isMediaItem, isRecord, isUnknownItem, itemBounds, measureBoardText, mergeFileSnapshot, nodeInputFromRecord, normalizeBoardConnectionStyle, normalizeBoardDocument, normalizeBoardTaskOutputUrl, normalizeRotation, normalizeViewport, panBy, parseBoardDocument, parseBoardItemLoose, parseBoardManifest, pathMidpoint, pickBoardColor, planBoardExport, pointToWorld, radToDeg, readCoverFromFrontmatter, readTitleFromFrontmatter, rectCenter, rectContainsPoint, rectsIntersect, registerShapeDefinition, resizeFrame, resizeFrameToSize, resizeModeForCapabilities, resolveArrow, resolveBoardColor, resolveConnection, resolveCoverRef, resolveSpacePath, rotateFrames, rotatePointAround, rotationHandleAnchor, rotationHandlePosition, sampleArrow, sampleRadius, scaleFrames, screenPoint, screenToWorld, selectBoardExportAssets, selectionBounds, serializeBoardManifest, setBoardTextMeasurer, shapeBounds, shapeCapabilities, shapeHandles, shapeHitTest, shapeResizeMode, shouldFetchFileExcerpt, simplifyDrawIndices, sourceForItem, splitFrontmatter, taskRunToBoardTaskSnapshot, timeline, translateArrow, unionRects, unknownRealType, unknownShapeDefinition, visibleWorldRect, withResolvedConnections, worldPoint, worldToAnchor, worldToScreen, zoomAround };

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

@@ -5,6 +5,7 @@ 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";
@@ -14,6 +15,7 @@ const boardCardRenderers = [
 	imageCardRenderer,
 	videoCardRenderer,
 	fileCardRenderer,
+	taskCardRenderer,
 	geoCardRenderer,
 	drawCardRenderer,
 	arrowCardRenderer,

package/dist/board/render/renderers/task-card-renderer.d.ts

@@ -0,0 +1,12 @@
+import { BoardCardRenderer } from "./board-renderer-registry.js";
+//#region src/board/render/renderers/task-card-renderer.d.ts
+/** Scale a texture into a frame without cropping or distortion. */
+declare function containTaskPreviewRect(width: number, height: number, imageWidth: number, imageHeight: number): {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+declare const taskCardRenderer: BoardCardRenderer;
+//#endregion
+export { containTaskPreviewRect, taskCardRenderer };

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

@@ -0,0 +1,389 @@
+import { BOARD_FONT_STACK, BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
+import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { drawFarPlate } from "./far-plate.js";
+import { positionShell } from "./base-card-renderer.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
+const RADIUS = 4;
+const PADDING = 12;
+const META_HEIGHT = 28;
+const FULL_DETAIL_ZOOM = .55;
+const WAVEFORM_BARS = 44;
+const WAVEFORM_GAP = 2;
+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 stateSurfaceFor(item, kind, hasTexture, previewFailed) {
+	if (kind === "texture" && !hasTexture) {
+		if (item.snapshot.status === "failed") return "failed";
+		return previewFailed ? "unavailable" : "media-loading";
+	}
+	if (kind !== "empty") return null;
+	if (item.snapshot.status === "failed") return "failed";
+	if (item.snapshot.status === "running") return "generating";
+	if (item.snapshot.status === "pending") return "queued";
+	return "empty";
+}
+function stateLabel(surface) {
+	switch (surface) {
+		case "generating": return "Generating";
+		case "queued": return "Queued";
+		case "failed": return "Failed";
+		case "unavailable": return "Preview unavailable";
+		case "empty": return "No preview";
+		default: return "";
+	}
+}
+function statusColor(item, context) {
+	if (item.snapshot.status === "failed") return context.colors.rose.stroke;
+	if (item.snapshot.status === "running") return context.colors.brand.stroke;
+	return context.colors.neutral.stroke;
+}
+function metadata(item) {
+	const extra = item.snapshot.outputCount > 1 ? `+${item.snapshot.outputCount - 1}` : null;
+	return [item.snapshot.model, extra].filter(Boolean).join(" · ");
+}
+/** Scale a texture into a frame without cropping or distortion. */
+function containTaskPreviewRect(width, height, imageWidth, imageHeight) {
+	if (width <= 0 || height <= 0 || imageWidth <= 0 || imageHeight <= 0) return {
+		x: 0,
+		y: 0,
+		width: 0,
+		height: 0
+	};
+	const scale = Math.min(width / imageWidth, height / imageHeight);
+	const renderedWidth = imageWidth * scale;
+	const renderedHeight = imageHeight * scale;
+	return {
+		x: (width - renderedWidth) / 2,
+		y: (height - renderedHeight) / 2,
+		width: renderedWidth,
+		height: renderedHeight
+	};
+}
+function waveformBars(seed, count) {
+	let hash = 2166136261;
+	for (let index = 0; index < seed.length; index += 1) {
+		hash ^= seed.charCodeAt(index);
+		hash = Math.imul(hash, 16777619) >>> 0;
+	}
+	const bars = [];
+	for (let index = 0; index < count; index += 1) {
+		hash ^= hash << 13;
+		hash ^= hash >>> 17;
+		hash ^= hash << 5;
+		hash >>>= 0;
+		const unit = hash % 1e3 / 1e3;
+		const envelope = Math.sin(Math.PI * (index + .5) / count);
+		bars.push(.18 + unit * .82 * (.45 + envelope * .55));
+	}
+	return bars;
+}
+function drawWaveform(graphics, seed, rect, color) {
+	const count = Math.max(8, Math.min(WAVEFORM_BARS, Math.floor(rect.width / 4)));
+	const step = rect.width / count;
+	const barWidth = Math.max(1.5, step - WAVEFORM_GAP);
+	const centerY = rect.y + rect.height / 2;
+	const maxHeight = Math.max(2, rect.height * .68);
+	const bars = waveformBars(seed, count);
+	for (let index = 0; index < count; index += 1) {
+		const amplitude = (bars[index] ?? .4) * maxHeight;
+		graphics.roundRect(rect.x + index * step + (step - barWidth) / 2, centerY - amplitude / 2, barWidth, amplitude, barWidth / 2);
+	}
+	graphics.fill({
+		color,
+		alpha: .68
+	});
+}
+function drawPlayBadge(graphics, rect, context) {
+	const radius = Math.min(PLAY_BADGE_RADIUS, Math.max(8, Math.min(rect.width, rect.height) * .16));
+	const cx = rect.x + rect.width / 2;
+	const cy = rect.y + rect.height / 2;
+	graphics.circle(cx, cy, radius).fill({
+		color: context.palette.bg,
+		alpha: .64
+	});
+	const size = radius * .72;
+	graphics.moveTo(cx - size * .34, cy - size * .56).lineTo(cx + size * .62, cy).lineTo(cx - size * .34, cy + size * .56).closePath().fill({
+		color: context.palette.text,
+		alpha: .94
+	});
+}
+/** Static state marks avoid implying measurable progress or keeping Pixi awake. */
+function drawStateMark(graphics, surface, cx, cy, color) {
+	if (surface === "generating" || surface === "media-loading") {
+		graphics.circle(cx, cy, 4).fill({
+			color,
+			alpha: .9
+		});
+		graphics.circle(cx - 12, cy + 7, 2.5).fill({
+			color,
+			alpha: .48
+		});
+		graphics.circle(cx + 11, cy + 6, 3).fill({
+			color,
+			alpha: .68
+		});
+		graphics.circle(cx + 3, cy - 12, 2).fill({
+			color,
+			alpha: .36
+		});
+		return;
+	}
+	if (surface === "queued") {
+		graphics.circle(cx, cy, 10).stroke({
+			color,
+			width: 1.5,
+			alpha: .62
+		}).circle(cx, cy, 3).fill({
+			color,
+			alpha: .78
+		});
+		return;
+	}
+	if (surface === "failed") {
+		graphics.circle(cx, cy, 11).stroke({
+			color,
+			width: 1.5,
+			alpha: .86
+		});
+		graphics.moveTo(cx - 4, cy - 4).lineTo(cx + 4, cy + 4).moveTo(cx + 4, cy - 4).lineTo(cx - 4, cy + 4).stroke({
+			color,
+			width: 1.5,
+			alpha: .94,
+			cap: "round"
+		});
+		return;
+	}
+	if (surface === "unavailable") graphics.roundRect(cx - 12, cy - 9, 24, 18, 3).stroke({
+		color,
+		width: 1.25,
+		alpha: .62
+	}).moveTo(cx - 8, cy + 5).lineTo(cx + 8, cy - 5).stroke({
+		color,
+		width: 1.25,
+		alpha: .72,
+		cap: "round"
+	});
+}
+function drawFailedBadge(graphics, width, color, context) {
+	const cx = Math.max(12, width - 12);
+	const cy = 12;
+	graphics.circle(cx, cy, 8).fill({
+		color: context.palette.bg,
+		alpha: .72
+	});
+	graphics.moveTo(cx - 2.5, cy - 2.5).lineTo(cx + 2.5, 14.5).moveTo(cx + 2.5, cy - 2.5).lineTo(cx - 2.5, 14.5).stroke({
+		color,
+		width: 1.5,
+		alpha: .96,
+		cap: "round"
+	});
+}
+function sync(container, item, context) {
+	const parts = partsByContainer.get(container);
+	if (!parts) return;
+	positionShell(parts.root, item);
+	const { width, height } = item.frame;
+	const selected = context.selectedIds.has(item.id);
+	const hovered = context.hoveredId === item.id;
+	const full = context.zoom >= FULL_DETAIL_ZOOM;
+	const color = statusColor(item, context);
+	const key = context.assetKey(item);
+	if (key !== parts.assetKey) {
+		if (parts.assetKey) context.releaseTexture(parts.assetKey);
+		parts.assetKey = key;
+		if (key) context.acquireTexture(key);
+	}
+	const texture = key ? context.getTexture(key) : null;
+	const previewFailed = Boolean(key && !texture && context.hasError(key));
+	const kind = previewKindFor(item);
+	const surface = stateSurfaceFor(item, kind, Boolean(texture), previewFailed);
+	const frame = {
+		x: 1,
+		y: 1,
+		width: Math.max(1, width - 2),
+		height: Math.max(1, height - 2)
+	};
+	const metaText = item.snapshot.primaryOutput ? metadata(item) : "";
+	const showMeta = full && Boolean(metaText);
+	const failedWithOutput = item.snapshot.status === "failed" && kind !== "empty";
+	syncTextResolution(parts.body, parts, context.zoom);
+	syncTextResolution(parts.meta, parts, context.zoom);
+	const visualSig = [
+		width,
+		height,
+		selected,
+		hovered,
+		full,
+		color,
+		kind,
+		surface,
+		showMeta,
+		failedWithOutput,
+		item.snapshot.primaryOutput?.type ?? "none",
+		item.taskRunId,
+		texture ? `${texture.width}x${texture.height}` : "none",
+		context.palette.surface,
+		context.palette.hover,
+		context.palette.border,
+		context.palette.bg
+	].join("|");
+	if (visualSig !== parts.visualSig) {
+		parts.visualSig = visualSig;
+		parts.plate.clear().roundRect(0, 0, width, height, RADIUS).fill({
+			color: context.palette.surface,
+			alpha: .98
+		}).roundRect(0, 0, width, height, RADIUS).stroke({
+			color: selected ? context.palette.brand : hovered ? context.palette.muted : context.palette.border,
+			width: selected ? 2 : 1,
+			alpha: selected ? .96 : .82
+		});
+		parts.clip.clear().roundRect(1, 1, frame.width, frame.height, RADIUS - 1).fill({ color: 16777215 });
+		parts.previewBg.clear().rect(frame.x, frame.y, frame.width, frame.height).fill({
+			color: context.palette.hover,
+			alpha: .5
+		});
+		parts.previewMask.clear().rect(frame.x, frame.y, frame.width, frame.height).fill({ color: 16777215 });
+		parts.previewArt.clear();
+		if (kind === "waveform") {
+			const bottomInset = showMeta ? META_HEIGHT : 0;
+			drawWaveform(parts.previewArt, item.taskRunId, {
+				x: frame.x + PADDING,
+				y: frame.y + PADDING,
+				width: Math.max(1, frame.width - PADDING * 2),
+				height: Math.max(1, frame.height - PADDING * 2 - bottomInset)
+			}, context.colors.brand.stroke);
+		}
+		if (kind === "texture" && texture && item.snapshot.primaryOutput?.type === "video" && full) 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);
+		}
+		if (showMeta) parts.previewArt.rect(frame.x, frame.y + frame.height - META_HEIGHT, frame.width, META_HEIGHT).fill({
+			color: context.palette.bg,
+			alpha: .68
+		});
+		if (failedWithOutput) drawFailedBadge(parts.previewArt, width, color, context);
+	}
+	parts.preview.visible = kind === "texture" && Boolean(texture);
+	if (parts.preview.visible && texture) {
+		if (parts.preview.texture !== texture) parts.preview.texture = texture;
+		const fitted = containTaskPreviewRect(frame.width, frame.height, texture.width, texture.height);
+		parts.preview.position.set(frame.x + fitted.x, frame.y + fitted.y);
+		parts.preview.width = fitted.width;
+		parts.preview.height = fitted.height;
+	}
+	const bodyText = kind === "text" ? item.snapshot.primaryOutput?.textExcerpt ?? "" : stateLabel(surface);
+	const textSig = [
+		bodyText,
+		metaText,
+		kind,
+		surface,
+		full,
+		width,
+		height,
+		context.palette.text,
+		context.palette.muted
+	].join("|");
+	if (textSig !== parts.textSig) {
+		parts.textSig = textSig;
+		parts.body.style.fill = surface === "failed" ? color : context.palette.text;
+		fitTextToLines(parts.body, bodyText, kind === "text" ? Math.max(1, Math.floor((height - PADDING * 2 - (showMeta ? META_HEIGHT : 0)) / 16)) : 1, Math.max(24, width - PADDING * 2));
+		parts.meta.style.fill = context.palette.text;
+		fitTextToLines(parts.meta, metaText, 1, Math.max(24, width - PADDING * 2));
+	}
+	parts.body.visible = full && Boolean(bodyText);
+	parts.meta.visible = showMeta;
+	if (kind === "text") parts.body.position.set(PADDING, PADDING);
+	else parts.body.position.set(Math.max(PADDING, (width - parts.body.width) / 2), height / 2 + 10);
+	parts.meta.position.set(PADDING, height - META_HEIGHT + 7);
+}
+const taskCardRenderer = {
+	id: "task-card",
+	canRender: (item) => item.type === "task",
+	create: (item, context) => {
+		const root = new Container();
+		const plate = new Graphics();
+		const clip = new Graphics();
+		const previewBg = new Graphics();
+		const preview = new Sprite();
+		const previewMask = new Graphics();
+		const previewArt = new Graphics();
+		const resolution = textResolutionForZoom(context.zoom);
+		const body = new Text({
+			text: "",
+			style: {
+				fontFamily: BOARD_FONT_STACK,
+				fontSize: 11.5,
+				fontWeight: "500",
+				wordWrap: true,
+				breakWords: true
+			},
+			resolution,
+			roundPixels: true
+		});
+		const meta = new Text({
+			text: "",
+			style: {
+				fontFamily: BOARD_MONO_FONT_STACK,
+				fontSize: 10,
+				fontWeight: "500",
+				wordWrap: true,
+				breakWords: true
+			},
+			resolution,
+			roundPixels: true
+		});
+		preview.mask = previewMask;
+		root.mask = clip;
+		root.addChild(plate, clip, previewBg, preview, previewMask, previewArt, body, meta);
+		partsByContainer.set(root, {
+			root,
+			plate,
+			clip,
+			previewBg,
+			preview,
+			previewMask,
+			previewArt,
+			body,
+			meta,
+			assetKey: null,
+			visualSig: "",
+			textSig: "",
+			resolution
+		});
+		if (item.type === "task") sync(root, item, context);
+		return root;
+	},
+	update: (container, item, context) => {
+		if (item.type === "task") sync(container, item, context);
+	},
+	renderFar: (graphics, item, context) => {
+		if (item.type !== "task") return;
+		const active = item.snapshot.status === "failed" || item.snapshot.status === "running" || item.snapshot.status === "pending";
+		drawFarPlate(graphics, item.frame, {
+			fill: context.palette.surface,
+			fillAlpha: .82,
+			...active ? {
+				accent: statusColor(item, context),
+				accentAlpha: .9
+			} : {}
+		});
+	},
+	destroy: (container, context) => {
+		const parts = partsByContainer.get(container);
+		if (parts?.assetKey) context.releaseTexture(parts.assetKey);
+		parts?.root.destroy({ children: true });
+		partsByContainer.delete(container);
+	}
+};
+//#endregion
+export { containTaskPreviewRect, taskCardRenderer };

package/dist/board/task.d.ts

@@ -0,0 +1,15 @@
+import { 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.
+ */
+declare function normalizeBoardTaskOutputUrl(value: unknown): 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 };

package/dist/board/task.js

@@ -0,0 +1,182 @@
+//#region src/board/task.ts
+const EXCERPT_LIMIT = 240;
+function record(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
+	if (typeof value !== "string") return void 0;
+	const clean = value.replace(/\s+/g, " ").trim();
+	if (!clean) return void 0;
+	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
+}
+function parseIpv4(host) {
+	const parts = host.split(".").map(Number);
+	return parts.length === 4 && parts.every((part) => Number.isInteger(part) && part >= 0 && part <= 255) ? parts : null;
+}
+function isBlockedIpv4(host) {
+	const parts = parseIpv4(host);
+	if (!parts) return false;
+	const [first, second, third] = parts;
+	if (first === 0 || first === 10 || first === 127) return true;
+	if (first === 100 && second >= 64 && second <= 127) return true;
+	if (first === 169 && second === 254) return true;
+	if (first === 172 && second >= 16 && second <= 31) return true;
+	if (first === 192 && second === 168) return true;
+	if (first === 192 && second === 0 && (third === 0 || third === 2)) return true;
+	if (first === 192 && second === 88 && third === 99) return true;
+	if (first === 198 && (second === 18 || second === 19)) return true;
+	if (first === 198 && second === 51 && third === 100) return true;
+	if (first === 203 && second === 0 && third === 113) return true;
+	return first >= 224;
+}
+function expandIpv6(host) {
+	const [head, tail, extra] = host.toLowerCase().split("::");
+	if (extra !== void 0) return null;
+	const headParts = head ? head.split(":").filter(Boolean) : [];
+	const tailParts = tail ? tail.split(":").filter(Boolean) : [];
+	const missing = 8 - headParts.length - tailParts.length;
+	if (missing < 0 || tail === void 0 && missing !== 0) return null;
+	const parts = [
+		...headParts,
+		...Array.from({ length: missing }, () => "0"),
+		...tailParts
+	];
+	if (parts.length !== 8 || parts.some((part) => !/^[0-9a-f]{1,4}$/.test(part))) return null;
+	return parts.map((part) => part.padStart(4, "0"));
+}
+function isBlockedIpv6(host) {
+	const parts = expandIpv6(host);
+	if (!parts) return true;
+	if (parts.every((part) => part === "0000")) return true;
+	if (parts.slice(0, 7).every((part) => part === "0000") && parts[7] === "0001") return true;
+	if (parts.slice(0, 5).every((part) => part === "0000") && parts[5] === "ffff") {
+		const high = Number.parseInt(parts[6] ?? "0", 16);
+		const low = Number.parseInt(parts[7] ?? "0", 16);
+		return isBlockedIpv4(`${high >> 8}.${high & 255}.${low >> 8}.${low & 255}`);
+	}
+	if (parts.slice(0, 6).every((part) => part === "0000")) return true;
+	const first = Number.parseInt(parts[0] ?? "0", 16);
+	if ((first & 65024) === 64512) return true;
+	if ((first & 65472) === 65152 || (first & 65472) === 65216) return true;
+	if ((first & 65280) === 65280) return true;
+	return parts[0] === "2001" && parts[1] === "0db8";
+}
+function isBlockedTaskOutputHost(hostname) {
+	const host = hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
+	if (host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal")) return true;
+	if (parseIpv4(host)) return isBlockedIpv4(host);
+	return host.includes(":") && isBlockedIpv6(host);
+}
+/**
+* Normalize a persistable remote media URL and reject credentialed or visibly
+* non-public hosts. Server-side fetchers must still validate resolved DNS addresses.
+*/
+function normalizeBoardTaskOutputUrl(value) {
+	if (typeof value !== "string") return void 0;
+	try {
+		const url = new URL(value.trim());
+		if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
+		if (url.username || url.password || isBlockedTaskOutputHost(url.hostname)) return void 0;
+		return url.toString();
+	} catch {
+		return;
+	}
+}
+function blockText(block) {
+	return cleanExcerpt(block.text ?? block.content ?? block.value);
+}
+function blockUrl(block) {
+	const source = record(block.source);
+	return normalizeBoardTaskOutputUrl(source?.url ?? source?.src ?? block.url ?? block.src);
+}
+function blockMimeType(block) {
+	const source = record(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;
+}
+function positiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function blockNaturalSize(block) {
+	const source = record(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 {
+		...naturalWidth ? { naturalWidth } : {},
+		...naturalHeight ? { naturalHeight } : {}
+	};
+}
+function contentBlocks(value) {
+	return Array.isArray(value) ? value.filter((item) => record(item)) : [];
+}
+function taskData(run) {
+	const payload = record(run.payload);
+	return record(payload?.data) ?? payload;
+}
+function generationOutput(run) {
+	return contentBlocks(record(run.result)?.output);
+}
+function generationPrompt(run) {
+	for (const block of contentBlocks(taskData(run)?.content)) {
+		const text = blockText(block);
+		if (text) return text;
+	}
+}
+function primaryOutput(blocks) {
+	for (const block of blocks) {
+		if (block.type !== "image" && block.type !== "video") continue;
+		const url = blockUrl(block);
+		if (!url) continue;
+		const mimeType = blockMimeType(block);
+		return {
+			type: block.type,
+			url,
+			...mimeType ? { mimeType } : {},
+			...blockNaturalSize(block)
+		};
+	}
+	for (const block of blocks) {
+		if (block.type === "audio") {
+			const url = blockUrl(block);
+			const mimeType = blockMimeType(block);
+			return {
+				type: "audio",
+				...url ? { url } : {},
+				...mimeType ? { mimeType } : {}
+			};
+		}
+		if (block.type === "text") {
+			const textExcerpt = blockText(block);
+			if (textExcerpt) return {
+				type: "text",
+				textExcerpt
+			};
+		}
+	}
+}
+function taskTypeTitle(taskType) {
+	return taskType.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
+}
+/**
+* Project an authoritative TaskRun into a small, replaceable Board display cache.
+* Raw payloads, complete results and inline media are never copied into the Board.
+*/
+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 primary = primaryOutput(blocks);
+	return {
+		taskType: run.taskType,
+		status: run.status,
+		title: promptExcerpt ?? taskTypeTitle(run.taskType),
+		...model ? { model } : {},
+		...promptExcerpt ? { promptExcerpt } : {},
+		outputCount: blocks.length,
+		...primary ? { primaryOutput: primary } : {},
+		updatedAt: run.updatedAt
+	};
+}
+//#endregion
+export { normalizeBoardTaskOutputUrl, taskRunToBoardTaskSnapshot };

package/dist/chunks/http.d.ts

@@ -1662,7 +1662,13 @@ declare class TasksApi {
   private readonly transport;
   constructor(transport: HttpTransport);
   get(taskRunId: string): Promise<TaskRunDetailResponse>;
+  getMany(taskRunIds: string[], options?: {
+    spaceId?: string;
+  }): Promise<{
+    runs: TaskRunRecord[];
+  }>;
   list(filters?: {
+    ids?: string[];
     cronJobId?: string;
     spaceId?: string;
     sessionId?: string;

package/dist/chunks/http.js

@@ -3135,8 +3135,19 @@ var TasksApi = class {
 	get(taskRunId) {
 		return this.transport.request(`/api/tasks/${taskRunId}`);
 	}
+	getMany(taskRunIds, options) {
+		const ids = [...new Set(taskRunIds.filter(Boolean))];
+		if (ids.length === 0) return Promise.resolve({ runs: [] });
+		if (ids.length > 100) throw new Error("At most 100 task runs can be fetched at once");
+		return this.list({
+			ids,
+			spaceId: options?.spaceId,
+			limit: ids.length
+		}).then(({ runs }) => ({ runs }));
+	}
 	list(filters) {
 		const params = new URLSearchParams();
+		if (filters?.ids?.length) params.set("ids", [...new Set(filters.ids)].join(","));
 		if (filters?.cronJobId) params.set("cronJobId", filters.cronJobId);
 		if (filters?.spaceId) params.set("spaceId", filters.spaceId);
 		if (filters?.sessionId) params.set("sessionId", filters.sessionId);

package/dist/chunks/websocket.d.ts

@@ -2289,7 +2289,7 @@ type UiCommandDispatchedEvent = {
 };
 type RealtimeServerEvent = SystemReadyEvent | SystemAuthOkEvent | SystemRequestErrorEvent | SystemPongEvent | SystemAckOkEvent | SystemSubscribeOkEvent | SystemSubscribeErrorEvent | SessionCreatedEvent | SessionUpdatedEvent | SessionRequestAcceptedEvent | SessionRequestErrorEvent | SessionTurnCreatedEvent | SessionTurnPatchEvent | SessionTurnErrorEvent | SessionTurnLifecycleEvent | SessionTurnUpdatedEvent | SessionTurnFinalizedEvent | SessionTurnNotifyEvent | SessionMessagePersistedEvent | SpaceFsChangedEvent | SpacePortsChangedEvent | SpacePresenceUpdatedEvent | BoardTransactionAppliedEvent | BoardAwarenessUpdatedEvent | BoardPlaybackChangedEvent | WorkVersionPublishedEvent | TaskCreatedEvent | TaskUpdatedEvent | LabelAssignmentsUpdatedEvent | UiCommandDispatchedEvent | RealtimeRoomEvent | RealtimeRoomJoinedEvent | RealtimeRoomMemberChangedEvent | RealtimeRoomPresenceUpdatedEvent | RealtimeRoomRequestEvent | RealtimeRoomRequestErrorEvent | RealtimeRoomClosedEvent;
 //#endregion
-//#region ../../node_modules/.pnpm/@neta-art+generation@0.1.20/node_modules/@neta-art/generation/dist/builtins-8R5iZQ10.d.ts
+//#region ../../node_modules/.pnpm/@neta-art+generation@0.1.21/node_modules/@neta-art/generation/dist/builtins-8R5iZQ10.d.ts
 //#region src/types.d.ts
 declare const MODEL_SCHEMA: "neta.generation.model.v1";
 type GenerationSource = {

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

@@ -440,13 +440,116 @@ declare const BoardFileItemSchema: z.ZodObject<{
     coverUrl: z.ZodOptional<z.ZodString>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
+declare const BoardTaskOutputSchema: z.ZodObject<{
+  type: z.ZodEnum<{
+    audio: "audio";
+    image: "image";
+    text: "text";
+    video: "video";
+  }>;
+  url: z.ZodOptional<z.ZodString>;
+  textExcerpt: z.ZodOptional<z.ZodString>;
+  mimeType: z.ZodOptional<z.ZodString>;
+  naturalWidth: z.ZodOptional<z.ZodNumber>;
+  naturalHeight: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+/**
+ * Cached task facts used for an immediate first paint. The task run remains the
+ * source of truth and live clients refresh this projection by `taskRunId`.
+ */
+declare const BoardTaskSnapshotSchema: z.ZodObject<{
+  taskType: z.ZodString;
+  status: z.ZodEnum<{
+    completed: "completed";
+    failed: "failed";
+    pending: "pending";
+    running: "running";
+  }>;
+  title: z.ZodString;
+  model: z.ZodOptional<z.ZodString>;
+  promptExcerpt: z.ZodOptional<z.ZodString>;
+  outputCount: z.ZodDefault<z.ZodNumber>;
+  primaryOutput: z.ZodOptional<z.ZodObject<{
+    type: z.ZodEnum<{
+      audio: "audio";
+      image: "image";
+      text: "text";
+      video: "video";
+    }>;
+    url: z.ZodOptional<z.ZodString>;
+    textExcerpt: z.ZodOptional<z.ZodString>;
+    mimeType: z.ZodOptional<z.ZodString>;
+    naturalWidth: z.ZodOptional<z.ZodNumber>;
+    naturalHeight: z.ZodOptional<z.ZodNumber>;
+  }, z.core.$strip>>;
+  updatedAt: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** A stable reference to a task run with a small, replaceable display cache. */
+declare const BoardTaskItemSchema: z.ZodObject<{
+  id: z.ZodString;
+  frame: z.ZodObject<{
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    rotation: z.ZodDefault<z.ZodNumber>;
+  }, z.core.$strip>;
+  locked: z.ZodOptional<z.ZodBoolean>;
+  style: z.ZodOptional<z.ZodObject<{
+    variant: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    accentColor: z.ZodOptional<z.ZodString>;
+    size: z.ZodDefault<z.ZodEnum<{
+      lg: "lg";
+      md: "md";
+      sm: "sm";
+    }>>;
+    emphasis: z.ZodDefault<z.ZodEnum<{
+      epic: "epic";
+      legendary: "legendary";
+      normal: "normal";
+      rare: "rare";
+    }>>;
+    effects: z.ZodDefault<z.ZodArray<z.ZodString>>;
+  }, z.core.$strip>>;
+  metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  type: z.ZodLiteral<"task">;
+  taskRunId: z.ZodString;
+  snapshot: z.ZodObject<{
+    taskType: z.ZodString;
+    status: z.ZodEnum<{
+      completed: "completed";
+      failed: "failed";
+      pending: "pending";
+      running: "running";
+    }>;
+    title: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    promptExcerpt: z.ZodOptional<z.ZodString>;
+    outputCount: z.ZodDefault<z.ZodNumber>;
+    primaryOutput: z.ZodOptional<z.ZodObject<{
+      type: z.ZodEnum<{
+        audio: "audio";
+        image: "image";
+        text: "text";
+        video: "video";
+      }>;
+      url: z.ZodOptional<z.ZodString>;
+      textExcerpt: z.ZodOptional<z.ZodString>;
+      mimeType: z.ZodOptional<z.ZodString>;
+      naturalWidth: z.ZodOptional<z.ZodNumber>;
+      naturalHeight: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    updatedAt: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
 /**
  * The set of shape types this client understands natively. Anything else is
  * preserved verbatim as an unknown item (see BoardUnknownItem) so documents
  * authored by newer clients round-trip losslessly — data is never dropped or
  * silently downgraded just because this client predates a shape type.
  */
-declare const KNOWN_BOARD_ITEM_TYPES: readonly ["image", "video", "file", "text", "geo", "draw", "arrow", "frame"];
+declare const KNOWN_BOARD_ITEM_TYPES: readonly ["image", "video", "file", "task", "text", "geo", "draw", "arrow", "frame"];
 type KnownBoardItemType = (typeof KNOWN_BOARD_ITEM_TYPES)[number];
 /**
  * A forward-compatible carrier for shape types this client does not recognise.
@@ -570,6 +673,44 @@ declare const BoardItemSchema: z.ZodPipe<z.ZodAny, z.ZodTransform<BoardUnknownIt
     coverPath?: string | undefined;
     coverUrl?: string | undefined;
   } | undefined;
+} | {
+  id: string;
+  frame: {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    rotation: number;
+  };
+  locked?: boolean | undefined;
+  style?: {
+    variant: string;
+    theme?: string | undefined;
+    accentColor?: string | undefined;
+    size: "lg" | "md" | "sm";
+    emphasis: "epic" | "legendary" | "normal" | "rare";
+    effects: string[];
+  } | undefined;
+  metadata?: Record<string, unknown> | undefined;
+  type: "task";
+  taskRunId: string;
+  snapshot: {
+    taskType: string;
+    status: "completed" | "failed" | "pending" | "running";
+    title: string;
+    model?: string | undefined;
+    promptExcerpt?: string | undefined;
+    outputCount: number;
+    primaryOutput?: {
+      type: "audio" | "image" | "text" | "video";
+      url?: string | undefined;
+      textExcerpt?: string | undefined;
+      mimeType?: string | undefined;
+      naturalWidth?: number | undefined;
+      naturalHeight?: number | undefined;
+    } | undefined;
+    updatedAt?: string | undefined;
+  };
 } | {
   id: string;
   frame: {
@@ -845,6 +986,44 @@ declare const BoardDocumentSchema: z.ZodObject<{
       coverPath?: string | undefined;
       coverUrl?: string | undefined;
     } | undefined;
+  } | {
+    id: string;
+    frame: {
+      x: number;
+      y: number;
+      width: number;
+      height: number;
+      rotation: number;
+    };
+    locked?: boolean | undefined;
+    style?: {
+      variant: string;
+      theme?: string | undefined;
+      accentColor?: string | undefined;
+      size: "lg" | "md" | "sm";
+      emphasis: "epic" | "legendary" | "normal" | "rare";
+      effects: string[];
+    } | undefined;
+    metadata?: Record<string, unknown> | undefined;
+    type: "task";
+    taskRunId: string;
+    snapshot: {
+      taskType: string;
+      status: "completed" | "failed" | "pending" | "running";
+      title: string;
+      model?: string | undefined;
+      promptExcerpt?: string | undefined;
+      outputCount: number;
+      primaryOutput?: {
+        type: "audio" | "image" | "text" | "video";
+        url?: string | undefined;
+        textExcerpt?: string | undefined;
+        mimeType?: string | undefined;
+        naturalWidth?: number | undefined;
+        naturalHeight?: number | undefined;
+      } | undefined;
+      updatedAt?: string | undefined;
+    };
   } | {
     id: string;
     frame: {
@@ -1064,8 +1243,11 @@ type BoardImageItem = z.infer<typeof BoardImageItemSchema>;
 type BoardVideoItem = z.infer<typeof BoardVideoItemSchema>;
 type BoardFileSnapshot = z.infer<typeof BoardFileSnapshotSchema>;
 type BoardFileItem = z.infer<typeof BoardFileItemSchema>;
+type BoardTaskOutput = z.infer<typeof BoardTaskOutputSchema>;
+type BoardTaskSnapshot = z.infer<typeof BoardTaskSnapshotSchema>;
+type BoardTaskItem = z.infer<typeof BoardTaskItemSchema>;
 /** Known (natively handled) item variants. */
-type BoardKnownItem = BoardImageItem | BoardVideoItem | BoardFileItem | BoardTextItem | BoardGeoItem | BoardDrawItem | BoardArrowItem | BoardFrameItem;
+type BoardKnownItem = BoardImageItem | BoardVideoItem | BoardFileItem | BoardTaskItem | BoardTextItem | BoardGeoItem | BoardDrawItem | BoardArrowItem | BoardFrameItem;
 /** Any item, including forward-compatible unknown types. */
 type BoardItem = BoardKnownItem | BoardUnknownItem;
 type BoardDocument = z.infer<typeof BoardDocumentSchema>;
@@ -1090,4 +1272,4 @@ declare function isMediaItem(item: BoardItem): item is BoardImageItem | BoardVid
 /** Whether an item references a workspace file (image, video or file card). */
 declare function isFileBackedItem(item: BoardItem): item is BoardImageItem | BoardVideoItem | BoardFileItem;
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearance, BoardAppearanceSchema, BoardArrowItem, BoardArrowItemSchema, BoardDocument, BoardDocumentSchema, BoardDrawItem, BoardDrawItemSchema, BoardFileItem, BoardFileItemSchema, BoardFileSnapshot, BoardFileSnapshotSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItem, BoardGeoItemSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemSchema, BoardItemStyle, BoardItemStyleSchema, BoardKnownItem, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardPoint, BoardPointSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskOutput, BoardTaskOutputSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardUnknownItem, BoardVideoItem, BoardVideoItemSchema, BoardViewport, BoardViewportSchema, DrawPoint, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, KnownBoardItemType, SpaceFileRef, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };

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

@@ -202,6 +202,46 @@ const BoardFileItemSchema = BoardItemBaseSchema.extend({
 	ref: SpaceFileRefSchema,
 	snapshot: BoardFileSnapshotSchema.optional()
 });
+const BoardTaskOutputSchema = z.object({
+	type: z.enum([
+		"image",
+		"video",
+		"audio",
+		"text"
+	]),
+	/** Remote preview only. Inline data is intentionally never persisted. */
+	url: z.string().url().optional(),
+	textExcerpt: z.string().max(480).optional(),
+	mimeType: z.string().max(160).optional(),
+	/** Intrinsic media size, cached so the node can match the preview aspect. */
+	naturalWidth: z.number().positive().optional(),
+	naturalHeight: z.number().positive().optional()
+});
+/**
+* Cached task facts used for an immediate first paint. The task run remains the
+* source of truth and live clients refresh this projection by `taskRunId`.
+*/
+const BoardTaskSnapshotSchema = z.object({
+	taskType: z.string().min(1).max(120),
+	status: z.enum([
+		"pending",
+		"running",
+		"completed",
+		"failed"
+	]),
+	title: z.string().min(1).max(240),
+	model: z.string().max(160).optional(),
+	promptExcerpt: z.string().max(480).optional(),
+	outputCount: z.number().int().nonnegative().default(0),
+	primaryOutput: BoardTaskOutputSchema.optional(),
+	updatedAt: z.string().optional()
+});
+/** A stable reference to a task run with a small, replaceable display cache. */
+const BoardTaskItemSchema = BoardItemBaseSchema.extend({
+	type: z.literal("task"),
+	taskRunId: z.string().min(1),
+	snapshot: BoardTaskSnapshotSchema
+});
 /**
 * The set of shape types this client understands natively. Anything else is
 * preserved verbatim as an unknown item (see BoardUnknownItem) so documents
@@ -212,6 +252,7 @@ const KNOWN_BOARD_ITEM_TYPES = [
 	"image",
 	"video",
 	"file",
+	"task",
 	"text",
 	"geo",
 	"draw",
@@ -251,6 +292,10 @@ function parseBoardItemLoose(raw) {
 			const parsed = BoardFileItemSchema.safeParse(raw);
 			return parsed.success ? parsed.data : makeUnknownItem(raw);
 		}
+		case "task": {
+			const parsed = BoardTaskItemSchema.safeParse(raw);
+			return parsed.success ? parsed.data : makeUnknownItem(raw);
+		}
 		case "text": {
 			const parsed = BoardTextItemSchema.safeParse(raw);
 			return parsed.success ? parsed.data : makeUnknownItem(raw);
@@ -358,4 +403,4 @@ function isFileBackedItem(item) {
 	return item.type === "image" || item.type === "video" || item.type === "file";
 }
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAppearanceSchema, BoardArrowItemSchema, BoardDocumentSchema, BoardDrawItemSchema, BoardFileItemSchema, BoardFileSnapshotSchema, BoardFrameItemSchema, BoardFrameSchema, BoardGeoItemSchema, BoardImageItemSchema, BoardItemSchema, BoardItemStyleSchema, BoardMediaSnapshotSchema, BoardPointSchema, BoardTaskItemSchema, BoardTaskOutputSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardVideoItemSchema, BoardViewportSchema, DrawPointSchema, KNOWN_BOARD_ITEM_TYPES, SpaceFileRefSchema, UNKNOWN_BOARD_ITEM_TYPE, isFileBackedItem, isMediaItem, isUnknownItem, parseBoardDocument, parseBoardItemLoose, unknownRealType, withResolvedConnections };

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+import { BoardCapability, BoardRenderCost } from "./protocol/dist/board-constants.js";
+import { BoardAssetRef, BoardClip, BoardDiagnostic, BoardEffect, BoardManifest, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardTarget, BoardValidationResult } from "./protocol/dist/board.js";
+import "./protocol/dist/index.js";
+//#region src/types.d.ts
+type UserProfile = {
+  userUuid: string;
+  logtoUserId?: string;
+  username: string | null;
+  displayName: string;
+  avatarUrl: string | null;
+  syncedAt?: string;
+};
+type TaskRunRecord = {
+  id: string;
+  jobId: string;
+  cronJobId: string | null;
+  taskType: string;
+  status: "pending" | "running" | "completed" | "failed";
+  payload: unknown;
+  result: unknown;
+  errorMessage: string | null;
+  attemptCount: number;
+  spaceId: string | null;
+  sessionId: string | null;
+  turnId: string | null;
+  userUuid: string | null;
+  userProfile?: UserProfile;
+  scheduledAt: string | null;
+  startedAt: string | null;
+  finishedAt: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+//#endregion
+export { TaskRunRecord, UserProfile };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "5.4.3",
+  "version": "5.6.0",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,