@neta-art/cohub-cli 10.10.0 → 10.11.0

package/dist/board-command-support.d.ts

@@ -3,5 +3,4 @@ export declare const BOARD_CREATE_INPUT_MAX_BYTES: number;
 export declare const BOARD_DOMAIN_INPUT_MAX_BYTES: number;
 export declare function parseBoardJsonObject(text: string, source?: string): Record<string, unknown>;
 export declare function readBoardJsonObject(source: string, maxBytes?: number): Promise<Record<string, unknown>>;
-export declare function resolveBoardId(spaceId: string, target: string): Promise<string>;
 export declare function writeBoardOutput(path: string, bytes: Uint8Array, force?: boolean): Promise<void>;

package/dist/board-command-support.js

@@ -2,8 +2,6 @@ import { randomUUID } from "node:crypto";
 import { constants } from "node:fs";
 import { access, link, open, rename, unlink } from "node:fs/promises";
 import { basename, dirname, join } from "node:path";
-import { isBoardPath, parseBoardManifest, } from "@neta-art/cohub/board";
-import { createClient } from "./client.js";
 export const BOARD_TRANSACTION_INPUT_MAX_BYTES = 16 * 1024 * 1024;
 export const BOARD_CREATE_INPUT_MAX_BYTES = 32 * 1024 * 1024;
 export const BOARD_DOMAIN_INPUT_MAX_BYTES = 1024 * 1024;
@@ -62,15 +60,6 @@ export async function readBoardJsonObject(source, maxBytes = BOARD_DOMAIN_INPUT_
         await handle.close();
     }
 }
-export async function resolveBoardId(spaceId, target) {
-    if (!isBoardPath(target))
-        return target;
-    const file = await createClient().space(spaceId).files.read(target);
-    if (!("content" in file) || typeof file.content !== "string") {
-        throw new Error(`${target} is not a readable Board manifest`);
-    }
-    return parseBoardManifest(file.content).boardId;
-}
 export async function writeBoardOutput(path, bytes, force = false) {
     if (!force) {
         await access(path).then(() => { throw new Error(`Output already exists: ${path}; use --force to replace it`); }, () => undefined);

package/dist/board-export.js

@@ -12,7 +12,6 @@ const execFile = promisify(execFileCallback);
 import { parseBoardMediaSource } from "@neta-art/cohub/board";
 import { imageVariantUrl, MEDIA_VARIANT_MAX, mediaVariantSize, videoFrameUrl } from "@neta-art/cohub/media";
 import { hasBoardScripts, boardAssetKey, boardAssetKeySource, boardDocumentAt, boardRenderTheme, boardTextureEdge, boardTexturePixels, createBoardRenderSampler, buildBoardScene, createNodeBoardRenderer, createNodeBoardScriptHost, exportBoardImageBytes, parseBoardDocument, planBoardExport, prepareBoardExport, selectBoardExportAssets, } from "./board-kernel.js";
-import { resolveBoardId } from "./board-command-support.js";
 import { settleBoardDocument } from "./board-media.js";
 import { BOARD_EXPORT_FONTS } from "./board-fonts.js";
 import { createClient } from "./client.js";
@@ -40,7 +39,7 @@ export function resolveBundledFonts() {
     });
 }
 export async function loadBoardDocument(spaceId, target) {
-    const board = createClient().space(spaceId).board(await resolveBoardId(spaceId, target));
+    const board = await createClient().space(spaceId).boards.open(target);
     let result = await board.get();
     const snapshot = result;
     const items = { ...result.items };

package/dist/board-kernel.js

@@ -6127,10 +6127,17 @@ const BoardCustomItemSchema$1 = object({
 	props: object({}).strict().default({})
 }).strict();
 const BOARD_EXTENSION_TYPE_PATTERN$1 = /^[a-z][a-z0-9]*(?:\.[a-z0-9-]+)+$/;
+const BoardItemPreviewSchema$1 = object({
+	title: string().max(500).optional(),
+	excerpt: string().max(2e3).optional(),
+	cover: BoardMediaSourceSchema$1.optional().describe("An image for the card."),
+	src: BoardMediaSourceSchema$1.optional().describe("The file or page the card stands for.")
+}).strict().describe("How a client without this type's renderer shows the card, and what it refers to. The type's own client keeps it current.");
 const BoardExtensionItemSchema$1 = object({
 	...boxed$1(BOARD_DEFAULT_ITEM_SIZE$1),
 	type: string().regex(BOARD_EXTENSION_TYPE_PATTERN$1),
-	props: record(string(), unknown()).default({})
+	props: record(string(), unknown()).default({}),
+	preview: BoardItemPreviewSchema$1.optional()
 }).strict();
 const BOARD_ITEM_SCHEMAS$1 = {
 	frame: BoardFrameItemSchema$1,
@@ -6150,6 +6157,12 @@ const BOARD_ITEM_TYPES$1 = Object.keys(BOARD_ITEM_SCHEMAS$1);
 function isBuiltinItemType(type) {
 	return Object.hasOwn(BOARD_ITEM_SCHEMAS$1, type);
 }
+function isBuiltinItem(item) {
+	return isBuiltinItemType(item.type);
+}
+function boardItemPreview(item) {
+	return isBuiltinItem(item) ? null : item.preview ?? null;
+}
 function boardItemSchema(type) {
 	if (isBuiltinItemType(type)) return BOARD_ITEM_SCHEMAS$1[type];
 	return BOARD_EXTENSION_TYPE_PATTERN$1.test(type) ? BoardExtensionItemSchema$1 : null;
@@ -7687,6 +7700,16 @@ function unionRects(rects) {
 		height: maxY - minY
 	};
 }
+function rotatePointAround(point, center, angleRad) {
+	const cos = Math.cos(angleRad);
+	const sin = Math.sin(angleRad);
+	const dx = point.x - center.x;
+	const dy = point.y - center.y;
+	return {
+		x: center.x + dx * cos - dy * sin,
+		y: center.y + dx * sin + dy * cos
+	};
+}
 function itemBounds(frame) {
 	const rotation = frame.rotation || 0;
 	if (rotation === 0) return frameRect(frame);
@@ -9287,8 +9310,12 @@ const MEDIA_HOSTS = /* @__PURE__ */ new Map([
 		transform: "oss",
 		metaHeaders: true
 	}],
+	["oss.talesofai.com", { transform: "oss" }],
 	["public.cohub.live", { transform: "oss" }],
+	["public.cohub.run", { transform: "oss" }],
 	["sessions.cohub.live", { transform: "oss" }],
+	["works.cohub.live", { transform: "oss" }],
+	["works.cohub.run", { transform: "oss" }],
 	["cca.neta.art", { transform: "cloudflare" }]
 ]);
 const parseHttpsUrl = (url) => {
@@ -9389,7 +9416,9 @@ function imageAssetKey(item) {
 		const url = taskArtifactPreviewUrl(featuredTaskArtifact(item.props.snapshot.artifacts));
 		return url ? `url:${url}` : null;
 	}
-	return null;
+	const cover = boardItemPreview(item)?.cover;
+	const source = cover ? parseBoardMediaSource$1(cover) : null;
+	return source ? `${source.kind}:${source.value}` : null;
 }
 const STILL_MEDIA = ["video", "model"];
 function stillKey(media, src, mtimeMs) {
@@ -9447,6 +9476,12 @@ function boardAssetKeySource(key) {
 		media: "image",
 		value: base.slice(4)
 	};
+	if (base.startsWith("cover-url:")) return {
+		kind: "url",
+		media: "image",
+		value: base.slice(10),
+		fit: "cover"
+	};
 	return null;
 }
 function boardTexturePixels(item, scale) {
@@ -10074,7 +10109,7 @@ const BOARD_THEME_DATA = {
 			surface: 2039072,
 			hover: 1842202,
 			border: 1842202,
-			brand: 888041,
+			brand: 3900150,
 			text: 15920612,
 			muted: 9999759,
 			rare: 9235170,
@@ -10128,7 +10163,10 @@ const BOARD_THEME_DATA = {
 				label: 15920612
 			}
 		},
-		style: {}
+		style: {
+			selection: { outset: 0 },
+			frameLabelSize: 16
+		}
 	},
 	"neta-pixel": {
 		colorScheme: "light",
@@ -10200,9 +10238,9 @@ const BOARD_THEME_DATA = {
 				y: 0
 			},
 			selection: {
-				width: 2,
-				outset: 8,
-				dash: 4,
+				width: 1.5,
+				outset: 0,
+				dash: 0,
 				handle: "square",
 				handleSize: 8
 			},
@@ -10210,7 +10248,8 @@ const BOARD_THEME_DATA = {
 			progress: "mosaic",
 			icons: "pixel",
 			motion: "stepped",
-			font: "\"Figtree Variable\", \"PingFang SC\", \"Noto Sans CJK SC\", \"Microsoft YaHei\", system-ui, sans-serif"
+			font: "\"Figtree Variable\", \"PingFang SC\", \"Noto Sans CJK SC\", \"Microsoft YaHei\", system-ui, sans-serif",
+			frameLabelSize: 16
 		}
 	},
 	"neta-pixel-dark": {
@@ -10283,9 +10322,9 @@ const BOARD_THEME_DATA = {
 				y: 0
 			},
 			selection: {
-				width: 2,
-				outset: 8,
-				dash: 4,
+				width: 1.5,
+				outset: 0,
+				dash: 0,
 				handle: "square",
 				handleSize: 8
 			},
@@ -10293,7 +10332,8 @@ const BOARD_THEME_DATA = {
 			progress: "mosaic",
 			icons: "pixel",
 			motion: "stepped",
-			font: "\"Figtree Variable\", \"PingFang SC\", \"Noto Sans CJK SC\", \"Microsoft YaHei\", system-ui, sans-serif"
+			font: "\"Figtree Variable\", \"PingFang SC\", \"Noto Sans CJK SC\", \"Microsoft YaHei\", system-ui, sans-serif",
+			frameLabelSize: 16
 		}
 	}
 };
@@ -10358,6 +10398,13 @@ function layoutShapeLabel(props, width) {
 		width: Math.max(1, width - 16)
 	});
 }
+const BOARD_FRAME_LABEL_LINE_HEIGHT = 1.25;
+function frameLabelOffset(size) {
+	return {
+		x: 4,
+		y: -(size + 6)
+	};
+}
 //#endregion
 //#region ../../node_modules/.pnpm/pixi.js@8.20.1/node_modules/pixi.js/lib/environment-browser/browserExt.mjs
 const browserExt = {
@@ -32769,8 +32816,8 @@ const measuredFonts = /* @__PURE__ */ new Set();
 const measuredFamilies = /* @__PURE__ */ new Set();
 const TRAILING_SPACE = /[ \t]+$/u;
 const unquote = (name) => name.trim().replace(/^["']|["']$/gu, "");
-function prepareText(text, font) {
-	const key = `${font}\n${text}`;
+function prepareText(text, font, whiteSpace) {
+	const key = `${whiteSpace}\n${font}\n${text}`;
 	let value = prepared.get(key);
 	if (value) {
 		prepared.delete(key);
@@ -32781,30 +32828,75 @@ function prepareText(text, font) {
 		measuredFonts.add(font);
 		for (const name of /px\s+(.+)$/u.exec(font)?.[1]?.split(",") ?? []) measuredFamilies.add(unquote(name));
 	}
-	value = prepareWithSegments(text, font, { whiteSpace: "pre-wrap" });
+	value = prepareWithSegments(text, font, { whiteSpace });
 	if (prepared.size >= PREPARED_LIMIT) prepared.delete(prepared.keys().next().value);
 	prepared.set(key, value);
 	return value;
 }
-function layoutTextLines(text, font, maxWidth = Number.POSITIVE_INFINITY) {
+let measureContext;
+function measureTextWidth(text, font) {
+	measureContext ??= DOMAdapter.get().createCanvas(1, 1).getContext("2d");
+	if (!measureContext) return 0;
+	measureContext.font = font;
+	return measureContext.measureText(text).width;
+}
+function layoutTextLines(text, font, maxWidth = Number.POSITIVE_INFINITY, { whiteSpace = "pre-wrap", maxLines = Number.POSITIVE_INFINITY } = {}) {
 	const lines = [];
-	let width = 0;
-	for (const paragraph of text.replace(/\r\n?/gu, "\n").replaceAll("	", " ").split("\n")) {
+	const widths = [];
+	if (maxLines <= 0) return {
+		lines,
+		width: 0,
+		truncated: text.length > 0
+	};
+	let source = whiteSpace === "normal" ? text.replace(/\s+/gu, " ").trim() : text.replace(/\r\n?/gu, "\n").replaceAll("	", " ");
+	const cap = Number.isFinite(maxLines) && Number.isFinite(maxWidth) ? maxLines * (Math.ceil(maxWidth) + 1) : Number.POSITIVE_INFINITY;
+	let truncated = source.length > cap;
+	if (truncated) source = source.slice(0, cap);
+	const paragraphs = whiteSpace === "normal" ? source ? [source] : [] : source.split("\n");
+	for (const paragraph of paragraphs) {
+		if (lines.length > maxLines) break;
 		if (!paragraph) {
 			lines.push("");
+			widths.push(0);
 			continue;
 		}
-		const wrapped = layoutWithLines(prepareText(paragraph, font), maxWidth, 1).lines;
+		const wrapped = layoutWithLines(prepareText(paragraph, font, whiteSpace), maxWidth, 1).lines;
 		for (const [index, line] of wrapped.entries()) {
 			lines.push(index === wrapped.length - 1 ? line.text : line.text.replace(TRAILING_SPACE, ""));
-			width = Math.max(width, line.width);
+			widths.push(line.width);
 		}
 	}
+	if (lines.length > maxLines) {
+		truncated = true;
+		lines.length = maxLines;
+		widths.length = maxLines;
+	}
+	if (truncated && lines.length > 0) {
+		const last = lines.length - 1;
+		lines[last] = fitLineWithEllipsis(lines[last], maxWidth, (value) => measureTextWidth(value, font));
+		widths[last] = measureTextWidth(lines[last], font);
+	}
 	return {
 		lines,
-		width
+		width: widths.reduce((max, width) => Math.max(max, width), 0),
+		truncated
 	};
 }
+const graphemes = typeof Intl.Segmenter === "function" ? new Intl.Segmenter(void 0, { granularity: "grapheme" }) : null;
+function fitLineWithEllipsis(line, width, measureWidth) {
+	const trimmed = line.replace(/\s+$/u, "");
+	if (!trimmed) return "…";
+	if (measureWidth(`${trimmed}…`) <= width) return `${trimmed}…`;
+	const parts = graphemes ? Array.from(graphemes.segment(trimmed), ({ segment }) => segment) : Array.from(trimmed);
+	let lo = 0;
+	let hi = parts.length - 1;
+	while (lo < hi) {
+		const mid = lo + hi + 1 >> 1;
+		if (measureWidth(`${parts.slice(0, mid).join("")}…`) <= width) lo = mid;
+		else hi = mid - 1;
+	}
+	return `${parts.slice(0, lo).join("")}…`;
+}
 const baselineShifts = /* @__PURE__ */ new Map();
 function cssBaselineShift(style) {
 	const font = fontStringFromTextStyle(style);
@@ -32996,40 +33088,10 @@ function boardTextSize(item) {
 }
 //#endregion
 //#region ../sdk/src/board/render/text-fit.ts
-function fitLineWithEllipsis(line, wrapWidth, measureWidth) {
-	const trimmed = line.replace(/\s+$/u, "");
-	if (!trimmed) return "…";
-	const full = `${trimmed}…`;
-	if (measureWidth(full) <= wrapWidth) return full;
-	let lo = 0;
-	let hi = trimmed.length;
-	let best = "…";
-	while (lo <= hi) {
-		const mid = lo + hi >> 1;
-		const candidate = mid > 0 ? `${trimmed.slice(0, mid)}…` : "…";
-		if (measureWidth(candidate) <= wrapWidth) {
-			best = candidate;
-			lo = mid + 1;
-		} else hi = mid - 1;
-	}
-	return best;
-}
 function fitTextToLines(text, value, maxLines, wrapWidth) {
-	const width = Math.max(1, wrapWidth);
 	text.style.wordWrap = false;
-	if (!value || maxLines <= 0) {
-		if (text.text !== "") text.text = "";
-		return;
-	}
-	const charCap = Math.max(maxLines * Math.ceil(width), maxLines * 4);
-	const sample = value.length > charCap ? value.slice(0, charCap) : value;
-	const { lines } = layoutTextLines(sample, fontStringFromTextStyle(text.style), width);
-	const kept = lines.slice(0, maxLines);
-	if (lines.length > maxLines || sample !== value) {
-		const lastIndex = kept.length - 1;
-		kept[lastIndex] = fitLineWithEllipsis(kept[lastIndex] ?? "", width, (candidate) => CanvasTextMetrics.measureText(candidate, text.style).width);
-	}
-	const fitted = kept.join("\n");
+	const { lines } = layoutTextLines(value, fontStringFromTextStyle(text.style), Math.max(1, wrapWidth), { maxLines });
+	const fitted = lines.join("\n");
 	if (text.text !== fitted) text.text = fitted;
 }
 function fitTextToWidth(text, value, width) {
@@ -33644,6 +33706,10 @@ function traceLocal(graphics, frame, rect) {
 	const d = corner(x, y + height);
 	graphics.moveTo(a.x, a.y).lineTo(b.x, b.y).lineTo(c.x, c.y).lineTo(d.x, d.y).closePath();
 }
+function farPictureTone(item, context) {
+	const key = context.assetKey(item);
+	return (key ? context.assetTone?.(key) : null) ?? void 0;
+}
 function drawFarPlate(graphics, frame, style) {
 	if (frame.width <= 0 || frame.height <= 0) return;
 	traceLocal(graphics, frame, {
@@ -33983,7 +34049,7 @@ const modelCardRenderer = {
 	},
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
-			fill: context.palette.surface,
+			fill: farPictureTone(item, context) ?? context.palette.surface,
 			fillAlpha: .96,
 			accent: context.palette.legendary,
 			accentAlpha: .45
@@ -33995,6 +34061,64 @@ const modelCardRenderer = {
 	}
 };
 //#endregion
+//#region ../sdk/src/board/render/media-interaction.ts
+const BOARD_PLAY_MEDIA = "play-media";
+function mediaPlayBadgeVisible(item, zoom, options) {
+	if (!options.materialized) return false;
+	if (item.type === "video" || item.type === "audio") return true;
+	if (isBoardModelItem(item)) return boardCardDetailed(zoom);
+	if (item.type !== "task" || !boardCardDetailed(zoom)) return false;
+	const artifact = featuredTaskArtifact(item.props.snapshot.artifacts);
+	if (artifact?.type === "audio") return true;
+	return artifact?.type === "video" && (Boolean(artifact.previewUrl) || options.hasVideoPreview);
+}
+function cornerKey(item) {
+	const { width, height } = item.frame;
+	if (item.type === "audio") return audioKeyCenter(width, height);
+	return isBoardModelItem(item) ? modelKeyCenter(width, height) : null;
+}
+function mediaPlayKeyCenter(item) {
+	const { x, y, width, height, rotation } = item.frame;
+	const center = worldPoint(x + width / 2, y + height / 2);
+	const key = cornerKey(item);
+	if (!key) return center;
+	return rotatePointAround(worldPoint(x + key.x, y + key.y), center, degToRad(rotation || 0));
+}
+function mediaPlayBadgeHit(item, point, zoom) {
+	const scale = Math.max(zoom, .05);
+	const radius = isBoardModelItem(item) ? Math.max(cornerKey(item)?.radius ?? 0, 16 / scale) : 28 / scale;
+	const center = mediaPlayKeyCenter(item);
+	return Math.hypot(point.x - center.x, point.y - center.y) <= radius;
+}
+function boardMediaActionAt(item, point, zoom, options) {
+	return mediaPlayBadgeVisible(item, zoom, options) && mediaPlayBadgeHit(item, point, zoom) ? {
+		action: BOARD_PLAY_MEDIA,
+		itemId: item.id
+	} : null;
+}
+const PLAY_HIT = {
+	action: BOARD_PLAY_MEDIA,
+	cursor: "pointer"
+};
+function mediaPlayHit(item, point, context) {
+	const key = context.assetKey(item);
+	return boardMediaActionAt(item, point, context.zoom, {
+		materialized: true,
+		hasVideoPreview: Boolean(key && context.getTexture(key))
+	}) ? PLAY_HIT : null;
+}
+//#endregion
+//#region ../sdk/src/board/render/labels.ts
+const ARROW_LABEL = {
+	fontWeight: "500",
+	lineHeight: 1.25,
+	padX: .5,
+	padY: .25
+};
+function arrowLabelAnchor(arrow, style) {
+	return style.trim === void 0 ? arrow.mid : pathPointAt(arrow.path, .5);
+}
+//#endregion
 //#region ../sdk/src/board/render/renderers/arrow-card-renderer.ts
 const partsByContainer$11 = /* @__PURE__ */ new WeakMap();
 function sync$11(container, item, context) {
@@ -34056,8 +34180,9 @@ function sync$11(container, item, context) {
 		parts.label.text = props.label;
 		parts.label.style.fill = context.palette.text;
 		parts.label.style.fontSize = props.fontSize;
-		const padX = props.fontSize * .5;
-		const padY = props.fontSize * .25;
+		parts.label.style.lineHeight = props.fontSize * ARROW_LABEL.lineHeight;
+		const padX = props.fontSize * ARROW_LABEL.padX;
+		const padY = props.fontSize * ARROW_LABEL.padY;
 		const { width, height } = parts.label;
 		const plate = {
 			x: -width / 2 - padX,
@@ -34077,7 +34202,7 @@ function sync$11(container, item, context) {
 	const visible = props.label.length > 0 && (style.trim === void 0 || style.trim >= .5);
 	parts.label.visible = visible;
 	parts.backdrop.visible = visible;
-	const mid = style.trim === void 0 ? resolved.mid : pathPointAt(resolved.path, .5);
+	const mid = arrowLabelAnchor(resolved, style);
 	parts.label.position.set(mid.x, mid.y);
 	parts.backdrop.position.set(mid.x, mid.y);
 }
@@ -34093,7 +34218,7 @@ const arrowCardRenderer = {
 				fill: 16777215,
 				fontFamily: BOARD_FONT_STACK,
 				fontSize: 14,
-				fontWeight: "500"
+				fontWeight: ARROW_LABEL.fontWeight
 			},
 			resolution: context.textResolution,
 			roundPixels: true
@@ -34481,8 +34606,34 @@ const partsByContainer$8 = /* @__PURE__ */ new WeakMap();
 function detailFor(zoom) {
 	return boardCardDetailed(zoom) ? "full" : "title";
 }
-function coverHeight(item, height) {
-	if (filePreviewKind(item.props.snapshot) !== "cover") return 0;
+function viewOf(item) {
+	if (item.type === "file") {
+		const { src, snapshot } = item.props;
+		return {
+			src,
+			title: snapshot?.title || fileStem(src),
+			excerpt: snapshot?.excerpt ?? "",
+			kind: filePreviewKind(snapshot),
+			meta: fileMetaLine(src, snapshot?.size),
+			mark: fileTypeLabel(src),
+			category: fileCategory(src, snapshot?.mimeType)
+		};
+	}
+	const preview = boardItemPreview(item);
+	if (!preview) return null;
+	const label = (item.type.split(".").pop() ?? item.type).toUpperCase();
+	return {
+		src: preview.src ?? null,
+		title: preview.title || item.type,
+		excerpt: preview.excerpt ?? "",
+		kind: preview.cover ? "cover" : preview.excerpt ? "text" : "blank",
+		meta: label,
+		mark: label,
+		category: preview.src ? fileCategory(preview.src) : "other"
+	};
+}
+function coverHeight(view, height) {
+	if (view.kind !== "cover") return 0;
 	const ideal = Math.round(height * COVER_RATIO);
 	return Math.max(0, Math.min(ideal, height - MIN_BODY_FOR_COVER));
 }
@@ -34501,31 +34652,31 @@ function syncClip(parts, rect, style) {
 }
 function sync$8(container, item, context) {
 	const parts = partsByContainer$8.get(container);
-	if (!parts) return;
-	syncContent(parts, item, context);
+	const view = viewOf(item);
+	if (!parts || !view) return;
+	syncContent(parts, item, view, context);
 	for (const text of [
 		parts.title,
 		parts.excerpt,
 		parts.typeMark
 	]) syncTextResolution(text, context.textResolution);
 }
-function syncContent(parts, item, context) {
+function syncContent(parts, item, view, context) {
 	positionShell(parts.root, item);
 	const { width, height } = item.frame;
 	const detail = detailFor(context.zoom);
 	const elevation = cardElevation(context, item.id);
 	syncCardTag(parts.tag, {
 		glyph: "file",
-		text: fileMetaLine(item.props.src, item.props.snapshot?.size),
+		text: view.meta,
 		width
 	}, context);
 	const key = context.assetKey(item);
 	const texture = key ? context.getTexture(key) : null;
 	const coverFailed = Boolean(key && !texture && context.hasError(key));
-	const fileState = context.fileState(item.props.src);
-	const band = coverHeight(item, height);
-	const kind = filePreviewKind(item.props.snapshot);
-	const category = fileCategory(item.props.src, item.props.snapshot?.mimeType);
+	const fileState = view.src ? context.fileState(view.src) : "ok";
+	const band = coverHeight(view, height);
+	const { kind, category, title, excerpt, mark } = view;
 	const accent = fileCategoryAccent(category, context.palette);
 	const visualSig = [
 		key ?? "",
@@ -34584,9 +34735,6 @@ function syncContent(parts, item, context) {
 		parts.excerpt.visible = detail === "full";
 		parts.typeMark.visible = kind === "blank";
 	}
-	const title = item.props.snapshot?.title || fileStem(item.props.src);
-	const excerpt = item.props.snapshot?.excerpt ?? "";
-	const mark = fileTypeLabel(item.props.src);
 	const innerWidth = Math.max(1, width - 20);
 	const showTypeMark = kind === "blank";
 	const textSig = [
@@ -34642,7 +34790,7 @@ function syncContent(parts, item, context) {
 }
 const fileCardRenderer = {
 	id: "file-card",
-	canRender: (item) => item.type === "file",
+	canRender: (item) => item.type === "file" || boardItemPreview(item) !== null,
 	create: (item, context) => {
 		const root = new Container();
 		const plate = new Graphics();
@@ -34706,23 +34854,19 @@ const fileCardRenderer = {
 			visualSig: "",
 			textSig: ""
 		});
-		if (item.type === "file") sync$8(root, item, context);
+		sync$8(root, item, context);
 		return root;
 	},
-	update: (container, item, context) => {
-		if (item.type === "file") sync$8(container, item, context);
-	},
-	resolution: (container, item, context) => {
-		if (item.type === "file") sync$8(container, item, context);
-	},
+	update: sync$8,
+	resolution: sync$8,
 	zoom: (container, zoom) => {
 		const tag = partsByContainer$8.get(container)?.tag;
 		if (tag) zoomCardTag(tag, zoom);
 	},
 	renderFar: (graphics, item, context) => {
-		const category = fileCategory(item.type === "file" ? item.props.src : "", item.type === "file" ? item.props.snapshot?.mimeType : void 0);
+		const category = viewOf(item)?.category ?? "other";
 		drawFarPlate(graphics, item.frame, {
-			fill: context.palette.surface,
+			fill: farPictureTone(item, context) ?? context.palette.surface,
 			fillAlpha: .96,
 			accent: fileCategoryAccent(category, context.palette),
 			accentAlpha: .45
@@ -34786,19 +34930,24 @@ function sync$7(container, item, context) {
 	parts.label.visible = decorated;
 	const title = locked ? `🔒 ${props.label}`.trim() : props.label;
 	const labelColor = style.stroke ? baseStroke : context.palette.muted;
+	const size = context.style.frameLabelSize;
 	const textSig = [
 		title,
 		labelColor,
-		context.style.font
+		context.style.font,
+		size
 	].join("|");
 	if (textSig !== parts.textSig) {
 		parts.textSig = textSig;
 		parts.label.text = title;
 		parts.label.style.fill = labelColor;
 		parts.label.style.fontFamily = context.style.font;
+		parts.label.style.fontSize = size;
+		parts.label.style.lineHeight = size * BOARD_FRAME_LABEL_LINE_HEIGHT;
+		const offset = frameLabelOffset(size);
+		parts.label.position.set(offset.x, offset.y);
 	}
 	syncTextResolution(parts.label, context.textResolution);
-	parts.label.position.set(4, -18);
 }
 const frameCardRenderer = {
 	id: "frame-card",
@@ -34809,7 +34958,6 @@ const frameCardRenderer = {
 		const label = createLabel("", {
 			fill: context.palette.muted,
 			fontFamily: BOARD_FONT_STACK,
-			fontSize: 12,
 			fontWeight: "600"
 		}, context.textResolution);
 		root.addChild(box, label);
@@ -35284,7 +35432,7 @@ const imageCardRenderer = {
 	lod: { kind: "media" },
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
-			fill: context.palette.hover,
+			fill: farPictureTone(item, context) ?? context.palette.hover,
 			fillAlpha: FAR_ALPHA
 		});
 	},
@@ -35797,7 +35945,7 @@ const taskCardRenderer = {
 		const { status } = liveStatus(item, context);
 		const active = status === "failed" || status === "running" || status === "pending";
 		drawFarPlate(graphics, item.frame, {
-			fill: context.palette.surface,
+			fill: farPictureTone(item, context) ?? context.palette.surface,
 			fillAlpha: .82,
 			...active ? {
 				accent: statusColor(status, context),
@@ -36170,7 +36318,7 @@ const videoCardRenderer = {
 	lod: { kind: "media" },
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
-			fill: context.palette.surface,
+			fill: farPictureTone(item, context) ?? context.palette.surface,
 			fillAlpha: .96,
 			accent: context.palette.brand,
 			accentAlpha: .75
@@ -36190,14 +36338,18 @@ const DEFAULT_BOARD_RENDER_LABELS = {
 	previewUnavailable: "Preview unavailable",
 	noPreview: "No preview"
 };
+const playable = (renderer) => ({
+	...renderer,
+	hitAt: mediaPlayHit
+});
 const builtinCardRenderers = [
 	textCardRenderer,
 	imageCardRenderer,
-	videoCardRenderer,
-	audioCardRenderer,
-	modelCardRenderer,
+	playable(videoCardRenderer),
+	playable(audioCardRenderer),
+	playable(modelCardRenderer),
 	fileCardRenderer,
-	taskCardRenderer,
+	playable(taskCardRenderer),
 	shapeCardRenderer,
 	drawCardRenderer,
 	arrowCardRenderer,
@@ -36690,10 +36842,17 @@ object({
 	props: object({}).strict().default({})
 }).strict();
 const BOARD_EXTENSION_TYPE_PATTERN = /^[a-z][a-z0-9]*(?:\.[a-z0-9-]+)+$/;
+const BoardItemPreviewSchema = object({
+	title: string().max(500).optional(),
+	excerpt: string().max(2e3).optional(),
+	cover: BoardMediaSourceSchema.optional().describe("An image for the card."),
+	src: BoardMediaSourceSchema.optional().describe("The file or page the card stands for.")
+}).strict().describe("How a client without this type's renderer shows the card, and what it refers to. The type's own client keeps it current.");
 object({
 	...boxed(BOARD_DEFAULT_ITEM_SIZE),
 	type: string().regex(BOARD_EXTENSION_TYPE_PATTERN),
-	props: record(string(), unknown()).default({})
+	props: record(string(), unknown()).default({}),
+	preview: BoardItemPreviewSchema.optional()
 }).strict();
 const CSS_EASE_KEYWORDS = /* @__PURE__ */ new Set([
 	"linear",
@@ -37143,7 +37302,8 @@ const BASE = {
 	progress: "shimmer",
 	icons: "line",
 	motion: "smooth",
-	font: BOARD_FONT_STACK
+	font: BOARD_FONT_STACK,
+	frameLabelSize: 12
 };
 const SHADOW = {
 	light: {

package/dist/commands/boards.js

@@ -3,7 +3,7 @@ import { existsSync } from "node:fs";
 import { mkdir } from "node:fs/promises";
 import { dirname } from "node:path";
 import { BOARD_PRESET_NAMES, BOARD_SCHEMA_TARGETS, BOARD_SCRIPT_API, BOARD_THEME_IDS, boardJsonSchema, boardPresetTracks, boardSchemaOverview, isBoardPresetName, listBoardPresets, } from "@neta-art/cohub/board";
-import { BOARD_CREATE_INPUT_MAX_BYTES, BOARD_TRANSACTION_INPUT_MAX_BYTES, parseBoardJsonObject, readBoardJsonObject, resolveBoardId, writeBoardOutput, } from "../board-command-support.js";
+import { BOARD_CREATE_INPUT_MAX_BYTES, BOARD_TRANSACTION_INPUT_MAX_BYTES, parseBoardJsonObject, readBoardJsonObject, writeBoardOutput, } from "../board-command-support.js";
 import { BOARD_EXPORT_IMAGE_MEMORY_MIB } from "../board-export-resources.js";
 import { settleBoardPatch } from "../board-media.js";
 import { formatBoardTime, parseBoardTime, parseBoardTimes } from "../board-time.js";
@@ -55,7 +55,7 @@ function list(value) {
 }
 async function boardClient(boards, target, spaceId) {
     spaceId ??= await resolveSpace(boards);
-    return createClient().space(spaceId).board(await resolveBoardId(spaceId, target));
+    return createClient().space(spaceId).boards.open(target);
 }
 /** A patch from an inline argument, a file, or stdin (`-`). */
 async function readPatch(inline, input, maxBytes) {
@@ -538,9 +538,9 @@ Presets: ${BOARD_PRESET_NAMES.join(", ")}
         .action(async (target, options) => {
         try {
             const spaceId = await resolveSpace(boards);
-            const boardId = await resolveBoardId(spaceId, target);
             const client = createRealtimeClient();
-            const board = client.space(spaceId).board(boardId);
+            const board = await client.space(spaceId).boards.open(target);
+            const boardId = board.id;
             if (!jsonRequested(options))
                 process.stderr.write(`Watching Board ${boardId}…\n`);
             const offConnection = client.onConnection((state) => {

package/dist/runtime/supervisor.js

@@ -90,6 +90,7 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
     };
     let closeInstance;
     let bridgeTask;
+    let retryDisconnectedBridge;
     let nativeStarted = false;
     let tokenInFlight = null;
     const token = (forceRefresh = false) => {
@@ -139,6 +140,9 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                 let probeTimer;
                 let managed = false;
                 let childStopped = false;
+                let bridgeDisconnected = false;
+                let terminating = false;
+                let recoveryTimer;
                 let controlPipe = null;
                 try {
                     const initialToken = await token();
@@ -156,6 +160,8 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                         bridge.once("error", (error) => diagnostics.log("error", "sandboxd.process_error", { error: serializeDiagnosticError(error) }));
                         bridge.once("exit", (code, exitSignal) => {
                             childStopped = true;
+                            clearTimeout(recoveryTimer);
+                            recoveryTimer = undefined;
                             if (!signal.aborted)
                                 diagnostics.log("warn", "sandboxd.process_exit", { code, signal: exitSignal });
                             // Descendants may still hold inherited pipes. After draining buffered
@@ -198,8 +204,10 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                                 managed = true;
                             if (event.type === "connected" || event.type === "disconnected") {
                                 const connected = event.type === "connected";
+                                bridgeDisconnected = !connected;
                                 update({ workspaceConnected: connected });
                                 diagnostics.log(connected ? "info" : "warn", `sandboxd.${event.type}`);
+                                retryDisconnectedBridge?.();
                             }
                         }
                         catch {
@@ -238,6 +246,11 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                     };
                     probeTimer = setTimeout(() => void probe(), 1000);
                     const terminate = () => {
+                        if (terminating || childStopped)
+                            return;
+                        terminating = true;
+                        clearTimeout(recoveryTimer);
+                        recoveryTimer = undefined;
                         // Windows has no SIGTERM; closing the managed stdin lets sandboxd stop gracefully.
                         if (process.platform === "win32")
                             bridge.stdin?.end();
@@ -246,6 +259,26 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                         const timeout = setTimeout(() => bridge.kill("SIGKILL"), 3000);
                         void closed.finally(() => clearTimeout(timeout));
                     };
+                    // A managed bridge may be sleeping for five minutes after a lease
+                    // rejection. Retry only after it reports a lost connection and the
+                    // Harness has regained its lease; a connected bridge stays untouched.
+                    retryDisconnectedBridge = () => {
+                        if (signal.aborted || !status.harnessConnected || !bridgeDisconnected || terminating || childStopped) {
+                            clearTimeout(recoveryTimer);
+                            recoveryTimer = undefined;
+                        }
+                        else if (!recoveryTimer) {
+                            // Give the bridge its normal retry and channel reattachment
+                            // window before replacing a process stuck in config backoff.
+                            recoveryTimer = setTimeout(() => {
+                                recoveryTimer = undefined;
+                                if (!signal.aborted && status.harnessConnected && bridgeDisconnected && !terminating && !childStopped) {
+                                    diagnostics.log("info", "sandboxd.lease_recovery");
+                                    terminate();
+                                }
+                            }, 30_000);
+                        }
+                    };
                     signal.addEventListener("abort", terminate, { once: true });
                     if (signal.aborted)
                         terminate();
@@ -257,10 +290,12 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
                         diagnostics.log("warn", "sandboxd.restart_failed", { error: serializeDiagnosticError(error) });
                 }
                 finally {
+                    retryDisconnectedBridge = undefined;
                     childStopped = true;
                     controlPipe?.close();
                     clearTimeout(refreshTimer);
                     clearTimeout(probeTimer);
+                    clearTimeout(recoveryTimer);
                     update({ workspaceConnected: false });
                 }
                 if (Date.now() - startedAt > 60_000)
@@ -276,8 +311,8 @@ export async function runRuntime(config, onState, externalSignal, onDiagnostic)
         await serveRuntime({
             spaceId: config.spaceId, cwd: config.root, url: url.toString(), capabilities,
             runtimeId: status.runtimeId, diagnostics, token, signal, executor: native.executor,
-            onReady: () => update({ harnessConnected: true }),
-            onDisconnected: () => { native.connect(null); update({ harnessConnected: false }); },
+            onReady: () => { update({ harnessConnected: true }); retryDisconnectedBridge?.(); },
+            onDisconnected: () => { native.connect(null); update({ harnessConnected: false }); retryDisconnectedBridge?.(); },
             onNativeStop: (stop) => { native.stop(stop.sessionId, stop.turnId); },
             onNativeChannel: (send) => {
                 native.connect(send);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "10.10.0",
+  "version": "10.11.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "engines": {
@@ -18,7 +18,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/cohub": "12.2.0",
+    "@neta-art/cohub": "12.3.0",
     "@neta-art/generation": "^0.1.40",
     "commander": "^15.0.0",
     "sharp": "^0.35.4",