@neta-art/cohub 5.6.0 → 5.8.0

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

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

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

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

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

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

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

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

package/dist/board/task.d.ts

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

package/dist/board/task.js

@@ -1,3 +1,5 @@
+import { normalizeBoardRemoteUrl } from "../protocol/dist/board-url.js";
+import "../protocol/dist/board-document.js";
 //#region src/board/task.ts
 const EXCERPT_LIMIT = 240;
 function record(value) {
@@ -9,85 +11,12 @@ function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
 	if (!clean) return void 0;
 	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
 }
-function parseIpv4(host) {
-	const parts = host.split(".").map(Number);
-	return parts.length === 4 && parts.every((part) => Number.isInteger(part) && part >= 0 && part <= 255) ? parts : null;
-}
-function isBlockedIpv4(host) {
-	const parts = parseIpv4(host);
-	if (!parts) return false;
-	const [first, second, third] = parts;
-	if (first === 0 || first === 10 || first === 127) return true;
-	if (first === 100 && second >= 64 && second <= 127) return true;
-	if (first === 169 && second === 254) return true;
-	if (first === 172 && second >= 16 && second <= 31) return true;
-	if (first === 192 && second === 168) return true;
-	if (first === 192 && second === 0 && (third === 0 || third === 2)) return true;
-	if (first === 192 && second === 88 && third === 99) return true;
-	if (first === 198 && (second === 18 || second === 19)) return true;
-	if (first === 198 && second === 51 && third === 100) return true;
-	if (first === 203 && second === 0 && third === 113) return true;
-	return first >= 224;
-}
-function expandIpv6(host) {
-	const [head, tail, extra] = host.toLowerCase().split("::");
-	if (extra !== void 0) return null;
-	const headParts = head ? head.split(":").filter(Boolean) : [];
-	const tailParts = tail ? tail.split(":").filter(Boolean) : [];
-	const missing = 8 - headParts.length - tailParts.length;
-	if (missing < 0 || tail === void 0 && missing !== 0) return null;
-	const parts = [
-		...headParts,
-		...Array.from({ length: missing }, () => "0"),
-		...tailParts
-	];
-	if (parts.length !== 8 || parts.some((part) => !/^[0-9a-f]{1,4}$/.test(part))) return null;
-	return parts.map((part) => part.padStart(4, "0"));
-}
-function isBlockedIpv6(host) {
-	const parts = expandIpv6(host);
-	if (!parts) return true;
-	if (parts.every((part) => part === "0000")) return true;
-	if (parts.slice(0, 7).every((part) => part === "0000") && parts[7] === "0001") return true;
-	if (parts.slice(0, 5).every((part) => part === "0000") && parts[5] === "ffff") {
-		const high = Number.parseInt(parts[6] ?? "0", 16);
-		const low = Number.parseInt(parts[7] ?? "0", 16);
-		return isBlockedIpv4(`${high >> 8}.${high & 255}.${low >> 8}.${low & 255}`);
-	}
-	if (parts.slice(0, 6).every((part) => part === "0000")) return true;
-	const first = Number.parseInt(parts[0] ?? "0", 16);
-	if ((first & 65024) === 64512) return true;
-	if ((first & 65472) === 65152 || (first & 65472) === 65216) return true;
-	if ((first & 65280) === 65280) return true;
-	return parts[0] === "2001" && parts[1] === "0db8";
-}
-function isBlockedTaskOutputHost(hostname) {
-	const host = hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.$/, "");
-	if (host === "localhost" || host.endsWith(".localhost") || host.endsWith(".local") || host.endsWith(".internal")) return true;
-	if (parseIpv4(host)) return isBlockedIpv4(host);
-	return host.includes(":") && isBlockedIpv6(host);
-}
-/**
-* Normalize a persistable remote media URL and reject credentialed or visibly
-* non-public hosts. Server-side fetchers must still validate resolved DNS addresses.
-*/
-function normalizeBoardTaskOutputUrl(value) {
-	if (typeof value !== "string") return void 0;
-	try {
-		const url = new URL(value.trim());
-		if (url.protocol !== "https:" && url.protocol !== "http:") return void 0;
-		if (url.username || url.password || isBlockedTaskOutputHost(url.hostname)) return void 0;
-		return url.toString();
-	} catch {
-		return;
-	}
-}
 function blockText(block) {
 	return cleanExcerpt(block.text ?? block.content ?? block.value);
 }
 function blockUrl(block) {
 	const source = record(block.source);
-	return normalizeBoardTaskOutputUrl(source?.url ?? source?.src ?? block.url ?? block.src);
+	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
 }
 function blockMimeType(block) {
 	const source = record(block.source);
@@ -122,37 +51,163 @@ function generationPrompt(run) {
 		if (text) return text;
 	}
 }
-function primaryOutput(blocks) {
-	for (const block of blocks) {
-		if (block.type !== "image" && block.type !== "video") continue;
-		const url = blockUrl(block);
-		if (!url) continue;
-		const mimeType = blockMimeType(block);
-		return {
-			type: block.type,
-			url,
-			...mimeType ? { mimeType } : {},
-			...blockNaturalSize(block)
-		};
+function blockMeta(block) {
+	return record(block.meta);
+}
+function blockIdentity(block) {
+	const meta = blockMeta(block);
+	const value = meta?.id ?? meta?.clip_id ?? meta?.clipId ?? block.id ?? block.clip_id ?? block.clipId;
+	if (typeof value !== "string" && typeof value !== "number") return void 0;
+	return cleanExcerpt(String(value), 220);
+}
+function blockTitle(block) {
+	return cleanExcerpt(blockMeta(block)?.title ?? block.title ?? block.name, 240);
+}
+function blockDurationMs(block) {
+	const source = record(block.source);
+	const meta = blockMeta(block);
+	const milliseconds = positiveNumber(source?.durationMs ?? meta?.durationMs ?? block.durationMs);
+	if (milliseconds) return Math.round(milliseconds);
+	const seconds = positiveNumber(source?.duration ?? meta?.duration ?? block.duration);
+	return seconds ? Math.round(seconds * 1e3) : void 0;
+}
+function blockPreviewUrl(block) {
+	const source = record(block.source);
+	return normalizeBoardRemoteUrl(source?.poster ?? source?.thumbnail ?? source?.previewUrl ?? block.poster ?? block.thumbnail ?? block.previewUrl);
+}
+function artifactId(base, used, suffix) {
+	const stem = cleanExcerpt(base, 220) ?? "output";
+	let candidate = suffix ? `${stem}-${suffix}` : stem;
+	let sequence = 2;
+	while (used.has(candidate)) {
+		candidate = `${stem}-${suffix ? `${suffix}-` : ""}${sequence}`;
+		sequence += 1;
 	}
-	for (const block of blocks) {
-		if (block.type === "audio") {
-			const url = blockUrl(block);
+	used.add(candidate);
+	return candidate;
+}
+/**
+* Group provider blocks into user-facing works. A cover/poster sharing a stable
+* provider id with playable media belongs to that work instead of becoming a
+* competing image result.
+*/
+function taskArtifacts(blocks) {
+	const groups = /* @__PURE__ */ new Map();
+	blocks.forEach((block, index) => {
+		const key = blockIdentity(block) ?? `output-${index + 1}`;
+		const group = groups.get(key);
+		if (group) group.push(block);
+		else groups.set(key, [block]);
+	});
+	const artifacts = [];
+	const usedIds = /* @__PURE__ */ new Set();
+	for (const [groupId, blocksInGroup] of groups) {
+		const images = blocksInGroup.filter((block) => block.type === "image").map((block) => ({
+			block,
+			url: blockUrl(block)
+		})).filter((entry) => Boolean(entry.url));
+		const media = blocksInGroup.filter((block) => block.type === "video" || block.type === "audio").map((block) => ({
+			block,
+			url: blockUrl(block)
+		})).filter((entry) => Boolean(entry.url));
+		const pairedPreview = images[0];
+		media.forEach(({ block, url }, mediaIndex) => {
+			const type = block.type;
+			const mimeType = blockMimeType(block);
+			const title = blockTitle(block);
+			const durationMs = blockDurationMs(block);
+			const previewUrl = blockPreviewUrl(block) ?? pairedPreview?.url;
+			const id = artifactId(groupId, usedIds, media.length > 1 ? `${type}-${mediaIndex + 1}` : void 0);
+			if (type === "video") {
+				artifacts.push({
+					id,
+					type,
+					url,
+					...title ? { title } : {},
+					...previewUrl ? { previewUrl } : {},
+					...mimeType ? { mimeType } : {},
+					...durationMs ? { durationMs } : {},
+					...blockNaturalSize(block)
+				});
+				return;
+			}
+			artifacts.push({
+				id,
+				type,
+				url,
+				...title ? { title } : {},
+				...previewUrl ? { previewUrl } : {},
+				...mimeType ? { mimeType } : {},
+				...durationMs ? { durationMs } : {}
+			});
+		});
+		const firstUnpairedImage = media.length > 0 ? 1 : 0;
+		images.slice(firstUnpairedImage).forEach(({ block, url }, imageIndex) => {
 			const mimeType = blockMimeType(block);
-			return {
-				type: "audio",
-				...url ? { url } : {},
-				...mimeType ? { mimeType } : {}
-			};
-		}
-		if (block.type === "text") {
+			const title = blockTitle(block);
+			artifacts.push({
+				id: artifactId(groupId, usedIds, images.length - firstUnpairedImage > 1 ? `image-${imageIndex + 1}` : void 0),
+				type: "image",
+				url,
+				...title ? { title } : {},
+				...mimeType ? { mimeType } : {},
+				...blockNaturalSize(block)
+			});
+		});
+		blocksInGroup.filter((block) => block.type === "text").forEach((block, textIndex, texts) => {
 			const textExcerpt = blockText(block);
-			if (textExcerpt) return {
+			if (!textExcerpt) return;
+			const title = blockTitle(block);
+			artifacts.push({
+				id: artifactId(groupId, usedIds, texts.length > 1 ? `text-${textIndex + 1}` : void 0),
 				type: "text",
+				...title ? { title } : {},
 				textExcerpt
-			};
-		}
+			});
+		});
 	}
+	return artifacts;
+}
+function artifactScore(artifact) {
+	const kind = {
+		text: 1,
+		image: 2,
+		audio: 3,
+		video: 4
+	}[artifact.type];
+	if (artifact.type === "text") return [kind, artifact.textExcerpt.length];
+	if (artifact.type === "image") return [kind, (artifact.naturalWidth ?? 0) * (artifact.naturalHeight ?? 0)];
+	return [
+		kind,
+		artifact.previewUrl ? 1 : 0,
+		artifact.durationMs ? 1 : 0,
+		artifact.durationMs ?? 0
+	];
+}
+function compareArtifacts(a, b) {
+	const left = artifactScore(a);
+	const right = artifactScore(b);
+	for (let index = 0; index < Math.max(left.length, right.length); index += 1) {
+		const difference = (right[index] ?? 0) - (left[index] ?? 0);
+		if (difference !== 0) return difference;
+	}
+	return 0;
+}
+/** Highest-value artifact first, with provider order as the stable final tie. */
+function rankedTaskArtifacts(artifacts) {
+	return artifacts.map((artifact, index) => ({
+		artifact,
+		index
+	})).sort((a, b) => compareArtifacts(a.artifact, b.artifact) || a.index - b.index).map(({ artifact }) => artifact);
+}
+function featuredTaskArtifact(artifacts) {
+	let featured;
+	for (const artifact of artifacts) if (!featured || compareArtifacts(artifact, featured) < 0) featured = artifact;
+	return featured;
+}
+function taskArtifactPreviewUrl(artifact) {
+	if (artifact?.type === "image") return artifact.url;
+	if (artifact?.type === "video" || artifact?.type === "audio") return artifact.previewUrl;
 }
 function taskTypeTitle(taskType) {
 	return taskType.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
@@ -166,17 +221,18 @@ function taskRunToBoardTaskSnapshot(run) {
 	const blocks = run.taskType === "generation" ? generationOutput(run) : [];
 	const promptExcerpt = run.taskType === "generation" ? generationPrompt(run) : cleanExcerpt(data?.command ?? data?.prompt ?? data?.title);
 	const model = typeof data?.model === "string" ? data.model : void 0;
-	const primary = primaryOutput(blocks);
+	const allArtifacts = taskArtifacts(blocks);
+	const artifacts = rankedTaskArtifacts(allArtifacts).slice(0, 6);
 	return {
 		taskType: run.taskType,
 		status: run.status,
 		title: promptExcerpt ?? taskTypeTitle(run.taskType),
 		...model ? { model } : {},
 		...promptExcerpt ? { promptExcerpt } : {},
-		outputCount: blocks.length,
-		...primary ? { primaryOutput: primary } : {},
+		artifactCount: allArtifacts.length,
+		artifacts,
 		updatedAt: run.updatedAt
 	};
 }
 //#endregion
-export { normalizeBoardTaskOutputUrl, taskRunToBoardTaskSnapshot };
+export { featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot };

package/dist/chunks/environment.d.ts

@@ -2,14 +2,14 @@
 type CohubEnvironment = "prod" | "dev";
 declare const COHUB_ENVIRONMENTS: {
   readonly prod: {
-    readonly apiBaseUrl: "https://api.cohub.run";
-    readonly websocketUrl: "wss://gateway.cohub.run/ws";
-    readonly voiceInputWebsocketUrl: "wss://gateway.cohub.run/asr/ws";
+    readonly apiBaseUrl: "https://api.cohub.live";
+    readonly websocketUrl: "wss://gateway.cohub.live/ws";
+    readonly voiceInputWebsocketUrl: "wss://gateway.cohub.live/asr/ws";
   };
   readonly dev: {
-    readonly apiBaseUrl: "https://api-dev.cohub.run";
-    readonly websocketUrl: "wss://gateway-dev.cohub.run/ws";
-    readonly voiceInputWebsocketUrl: "wss://gateway-dev.cohub.run/asr/ws";
+    readonly apiBaseUrl: "https://api-dev.cohub.live";
+    readonly websocketUrl: "wss://gateway-dev.cohub.live/ws";
+    readonly voiceInputWebsocketUrl: "wss://gateway-dev.cohub.live/asr/ws";
   };
 };
 declare const resolveCohubEnvironment: (env?: CohubEnvironment) => CohubEnvironment;

package/dist/chunks/environment.js

@@ -1,14 +1,14 @@
 //#region src/environment.ts
 const COHUB_ENVIRONMENTS = {
 	prod: {
-		apiBaseUrl: "https://api.cohub.run",
-		websocketUrl: "wss://gateway.cohub.run/ws",
-		voiceInputWebsocketUrl: "wss://gateway.cohub.run/asr/ws"
+		apiBaseUrl: "https://api.cohub.live",
+		websocketUrl: "wss://gateway.cohub.live/ws",
+		voiceInputWebsocketUrl: "wss://gateway.cohub.live/asr/ws"
 	},
 	dev: {
-		apiBaseUrl: "https://api-dev.cohub.run",
-		websocketUrl: "wss://gateway-dev.cohub.run/ws",
-		voiceInputWebsocketUrl: "wss://gateway-dev.cohub.run/asr/ws"
+		apiBaseUrl: "https://api-dev.cohub.live",
+		websocketUrl: "wss://gateway-dev.cohub.live/ws",
+		voiceInputWebsocketUrl: "wss://gateway-dev.cohub.live/asr/ws"
 	}
 };
 const readRuntimeEnv = () => {