@neta-art/cohub 5.4.3 → 5.5.0

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,4 @@ 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 };
+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, 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 };

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,4 @@ 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 };
+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, 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 };

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/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/package.json

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