@neta-art/cohub 11.0.0 → 11.1.0

package/dist/index.js

@@ -381,8 +381,16 @@ const fileProps = {
 		coverUrl: z.string().optional()
 	}).strict().optional()
 };
-const timedFileProps = {
+const BoardMediaOriginSchema = z.object({
+	taskRunId: z.string().min(1).max(160),
+	artifactId: z.string().min(1).max(240)
+}).strict();
+const mediaProps = {
 	...fileProps,
+	origin: BoardMediaOriginSchema.optional()
+};
+const timedFileProps = {
+	...mediaProps,
 	time: nonNegative.optional()
 };
 const BoardCropSchema = z.object({
@@ -395,7 +403,7 @@ const BoardImageItemSchema = z.object({
 	...boxed(640, 360),
 	type: z.literal("image"),
 	props: z.object({
-		...fileProps,
+		...mediaProps,
 		crop: BoardCropSchema.optional()
 	}).strict()
 }).strict();
@@ -460,8 +468,10 @@ const BoardTaskSnapshotSchema = z.object({
 	title: z.string().min(1).max(240),
 	model: z.string().max(160).optional(),
 	promptExcerpt: z.string().max(480).optional(),
+	errorExcerpt: z.string().max(240).optional(),
 	artifactCount: z.number().int().nonnegative(),
 	artifacts: z.array(BoardTaskArtifactSchema).max(6).default([]),
+	startedAt: z.string().max(64).optional(),
 	updatedAt: z.string().optional()
 }).strict();
 const BoardTaskItemSchema = z.object({
@@ -469,7 +479,7 @@ const BoardTaskItemSchema = z.object({
 	type: z.literal("task"),
 	props: z.object({
 		taskRunId: z.string().min(1).max(160),
-		snapshot: BoardTaskSnapshotSchema
+		snapshot: BoardTaskSnapshotSchema.describe("Maintained by the server for tasks in the Board's Space; writers may omit it.")
 	}).strict()
 }).strict();
 const BOARD_EFFECT_KINDS = [
@@ -1751,10 +1761,132 @@ function parseBoardDocument(input) {
 	} : result;
 }
 //#endregion
+//#region ../protocol/dist/generation/blocks.js
+const EXCERPT_LIMIT = 240;
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
+	if (typeof value !== "string") return void 0;
+	const clean = value.replace(/\s+/g, " ").trim();
+	if (!clean) return void 0;
+	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
+}
+function blockText(block) {
+	return cleanExcerpt(block.text ?? block.content ?? block.value);
+}
+function blockUrl(block) {
+	const source = asRecord(block.source);
+	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
+}
+function blockMimeType(block) {
+	const source = asRecord(block.source);
+	const value = source?.mediaType ?? source?.media_type ?? source?.mimeType ?? block.mediaType ?? block.media_type ?? block.mimeType;
+	return typeof value === "string" ? value : void 0;
+}
+function positiveNumber(value) {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
+}
+function blockNaturalSize(block) {
+	const source = asRecord(block.source);
+	const naturalWidth = positiveNumber(source?.width ?? source?.naturalWidth ?? block.width ?? block.naturalWidth);
+	const naturalHeight = positiveNumber(source?.height ?? source?.naturalHeight ?? block.height ?? block.naturalHeight);
+	return {
+		...naturalWidth ? { naturalWidth } : {},
+		...naturalHeight ? { naturalHeight } : {}
+	};
+}
+function contentBlocks(value) {
+	return Array.isArray(value) ? value.filter((item) => asRecord(item)) : [];
+}
+function taskData(run) {
+	const payload = asRecord(run.payload);
+	return asRecord(payload?.data) ?? payload;
+}
+function generationOutput(run) {
+	return contentBlocks(asRecord(run.result)?.output);
+}
+function generationPrompt(run) {
+	for (const block of contentBlocks(taskData(run)?.content)) {
+		const text = blockText(block);
+		if (text) return text;
+	}
+}
+function blockMeta(block) {
+	return asRecord(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 = asRecord(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 = asRecord(block.source);
+	return normalizeBoardRemoteUrl(source?.poster ?? source?.thumbnail ?? source?.previewUrl ?? block.poster ?? block.thumbnail ?? block.previewUrl);
+}
+/**
+* Image roles that depict playable media, by the media types they may cover;
+* `last_frame` stays a result of its own.
+*/
+const COVER_ROLES = /* @__PURE__ */ new Map([
+	["first_frame", /* @__PURE__ */ new Set(["video"])],
+	["cover", /* @__PURE__ */ new Set(["video", "audio"])],
+	["poster", /* @__PURE__ */ new Set(["video", "audio"])],
+	["thumbnail", /* @__PURE__ */ new Set(["video", "audio"])]
+]);
+function isPlayable(block) {
+	return block.type === "video" || block.type === "audio";
+}
+/**
+* Pair playable media with its cover image, returning media index → cover
+* index. An image sharing the provider id wins (music tracks and their art,
+* shared by every media of that id); otherwise cover-role images pair in
+* order with remaining media their role fits (a video and its `first_frame`).
+* Covers need a remote URL, so an inline image is never folded away.
+*/
+function generationCovers(blocks) {
+	const covers = /* @__PURE__ */ new Map();
+	const isCover = (block) => block.type === "image" && blockUrl(block) !== void 0 && blockMeta(block)?.role !== "last_frame";
+	blocks.forEach((block, index) => {
+		const id = blockIdentity(block);
+		if (!isPlayable(block) || id === void 0) return;
+		const cover = blocks.findIndex((candidate) => isCover(candidate) && blockIdentity(candidate) === id);
+		if (cover >= 0) covers.set(index, cover);
+	});
+	const paired = new Set(covers.values());
+	const roleCovers = blocks.flatMap((block, index) => {
+		const role = blockMeta(block)?.role;
+		const types = typeof role === "string" ? COVER_ROLES.get(role) : void 0;
+		return isCover(block) && !paired.has(index) && types ? [{
+			index,
+			types
+		}] : [];
+	});
+	blocks.forEach((block, index) => {
+		if (!isPlayable(block) || covers.has(index)) return;
+		const at = roleCovers.findIndex(({ types }) => types.has(String(block.type)));
+		const [cover] = at < 0 ? [] : roleCovers.splice(at, 1);
+		if (cover) covers.set(index, cover.index);
+	});
+	return covers;
+}
+//#endregion
 //#region ../protocol/dist/turn-origin.js
-const record$2 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+const record$1 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 const normalizeSessionTurnOrigin = (value) => {
-	const input = record$2(value);
+	const input = record$1(value);
 	if (!input || ![
 		"prompt",
 		"scheduled_prompt",
@@ -1774,12 +1906,12 @@ const normalizeSessionTurnOrigin = (value) => {
 };
 /** Reads durable provenance; legacy background tasks only knew their caller's Session/Turn. */
 const readSessionTurnOrigin = (meta, spaceId) => {
-	const input = record$2(meta);
+	const input = record$1(meta);
 	const origin = normalizeSessionTurnOrigin(input?.origin);
 	if (origin) return origin;
-	const context = record$2(input?.context);
+	const context = record$1(input?.context);
 	if (context?.kind !== "background_bash_task" || !isUuidLike(spaceId)) return null;
-	const legacy = record$2(context.origin);
+	const legacy = record$1(context.origin);
 	return normalizeSessionTurnOrigin({
 		...legacy,
 		spaceId,
@@ -1794,9 +1926,9 @@ const KINDS = [
 	"background_task",
 	"hook"
 ];
-const record$1 = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
+const record = (value) => value && typeof value === "object" && !Array.isArray(value) ? value : null;
 const normalizeSentTurnRef = (value) => {
-	const input = record$1(value);
+	const input = record(value);
 	if (!input) return null;
 	if (!isUuidLike(input.sessionId) || !isUuidLike(input.turnId)) return null;
 	const kind = String(input.kind);
@@ -1815,7 +1947,7 @@ const normalizeSentTurnRef = (value) => {
 };
 /** Deduplicates by child Turn, so a retried request cannot render one twice. */
 const readSentTurns = (meta) => {
-	const raw = record$1(meta)?.messagesSent;
+	const raw = record(meta)?.messagesSent;
 	if (!Array.isArray(raw)) return [];
 	const seen = /* @__PURE__ */ new Set();
 	const refs = [];
@@ -7031,7 +7163,10 @@ var CohubClient = class {
 		const appTransport = resolveAppTransport(appRuntime, appIdResolver, createOriginAppResolver({
 			apiBaseUrl,
 			fetch: options.fetch
-		}), resolveWebBaseUrl({ env: options.env }));
+		}), resolveWebBaseUrl({
+			env: options.env,
+			url: options.webBaseUrl
+		}));
 		this.appRuntime = createAppRuntime(appTransport, appRuntime?.appId, appIdResolver);
 		this.appWindow = new AppWindowApi(appTransport, {
 			context: () => this.appRuntime.context(),
@@ -8871,129 +9006,6 @@ function createAppBridgeCore(config) {
 	};
 }
 //#endregion
-//#region src/generation-blocks.ts
-/** Tolerant readers for generation payloads, shared by every task projection. */
-const EXCERPT_LIMIT = 240;
-function record(value) {
-	return value && typeof value === "object" && !Array.isArray(value) ? value : null;
-}
-function cleanExcerpt(value, limit = EXCERPT_LIMIT) {
-	if (typeof value !== "string") return void 0;
-	const clean = value.replace(/\s+/g, " ").trim();
-	if (!clean) return void 0;
-	return clean.length > limit ? `${clean.slice(0, limit - 3).trimEnd()}...` : clean;
-}
-function blockText(block) {
-	return cleanExcerpt(block.text ?? block.content ?? block.value);
-}
-function blockUrl(block) {
-	const source = record(block.source);
-	return normalizeBoardRemoteUrl(source?.url ?? source?.src ?? block.url ?? block.src);
-}
-function blockMimeType(block) {
-	const source = record(block.source);
-	const value = source?.mediaType ?? source?.media_type ?? source?.mimeType ?? block.mediaType ?? block.media_type ?? block.mimeType;
-	return typeof value === "string" ? value : void 0;
-}
-function positiveNumber(value) {
-	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : void 0;
-}
-function blockNaturalSize(block) {
-	const source = record(block.source);
-	const naturalWidth = positiveNumber(source?.width ?? source?.naturalWidth ?? block.width ?? block.naturalWidth);
-	const naturalHeight = positiveNumber(source?.height ?? source?.naturalHeight ?? block.height ?? block.naturalHeight);
-	return {
-		...naturalWidth ? { naturalWidth } : {},
-		...naturalHeight ? { naturalHeight } : {}
-	};
-}
-function contentBlocks(value) {
-	return Array.isArray(value) ? value.filter((item) => record(item)) : [];
-}
-function taskData(run) {
-	const payload = record(run.payload);
-	return record(payload?.data) ?? payload;
-}
-function generationOutput(run) {
-	return contentBlocks(record(run.result)?.output);
-}
-function generationPrompt(run) {
-	for (const block of contentBlocks(taskData(run)?.content)) {
-		const text = blockText(block);
-		if (text) return text;
-	}
-}
-function 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);
-}
-/**
-* Image roles that depict playable media, by the media types they may cover;
-* `last_frame` stays a result of its own.
-*/
-const COVER_ROLES = /* @__PURE__ */ new Map([
-	["first_frame", /* @__PURE__ */ new Set(["video"])],
-	["cover", /* @__PURE__ */ new Set(["video", "audio"])],
-	["poster", /* @__PURE__ */ new Set(["video", "audio"])],
-	["thumbnail", /* @__PURE__ */ new Set(["video", "audio"])]
-]);
-function isPlayable(block) {
-	return block.type === "video" || block.type === "audio";
-}
-/**
-* Pair playable media with its cover image, returning media index → cover
-* index. An image sharing the provider id wins (music tracks and their art,
-* shared by every media of that id); otherwise cover-role images pair in
-* order with remaining media their role fits (a video and its `first_frame`).
-* Covers need a remote URL, so an inline image is never folded away.
-*/
-function generationCovers(blocks) {
-	const covers = /* @__PURE__ */ new Map();
-	const isCover = (block) => block.type === "image" && blockUrl(block) !== void 0 && blockMeta(block)?.role !== "last_frame";
-	blocks.forEach((block, index) => {
-		const id = blockIdentity(block);
-		if (!isPlayable(block) || id === void 0) return;
-		const cover = blocks.findIndex((candidate) => isCover(candidate) && blockIdentity(candidate) === id);
-		if (cover >= 0) covers.set(index, cover);
-	});
-	const paired = new Set(covers.values());
-	const roleCovers = blocks.flatMap((block, index) => {
-		const role = blockMeta(block)?.role;
-		const types = typeof role === "string" ? COVER_ROLES.get(role) : void 0;
-		return isCover(block) && !paired.has(index) && types ? [{
-			index,
-			types
-		}] : [];
-	});
-	blocks.forEach((block, index) => {
-		if (!isPlayable(block) || covers.has(index)) return;
-		const at = roleCovers.findIndex(({ types }) => types.has(String(block.type)));
-		const [cover] = at < 0 ? [] : roleCovers.splice(at, 1);
-		if (cover) covers.set(index, cover.index);
-	});
-	return covers;
-}
-//#endregion
 //#region src/generation-task.ts
 const INLINE_KEYS = [
 	"data",
@@ -9001,7 +9013,7 @@ const INLINE_KEYS = [
 	"contentBase64"
 ];
 function isDeferred(block) {
-	return block.deferredBase64 === true || record(block.source)?.deferredBase64 === true;
+	return block.deferredBase64 === true || asRecord(block.source)?.deferredBase64 === true;
 }
 const MEDIA_TYPE_PATTERN = /^(image|video|audio)\/[\w.+-]+$/;
 const DEFAULT_MEDIA_TYPES = {
@@ -9044,7 +9056,7 @@ function projectOutputs(run) {
 }
 function toGenerationTaskView(run) {
 	const data = taskData(run);
-	const result = record(run.result);
+	const result = asRecord(run.result);
 	const model = data?.model ?? result?.model;
 	return {
 		id: run.id,
@@ -9067,11 +9079,11 @@ function isActiveGenerationTask(task) {
 }
 /** Playable source of an output: its URL, or a data URL for inline payloads. */
 function generationOutputSource(result, outputIndex) {
-	const block = contentBlocks(record(result)?.output)[outputIndex];
+	const block = contentBlocks(asRecord(result)?.output)[outputIndex];
 	if (!block) return null;
 	const url = blockUrl(block);
 	if (url) return url;
-	const source = record(block.source);
+	const source = asRecord(block.source);
 	const data = INLINE_KEYS.map((key) => source?.[key] ?? block[key]).find((value) => typeof value === "string" && value !== "");
 	if (!data) return null;
 	const declared = blockMimeType(block);

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

@@ -481,6 +481,11 @@ declare const BoardMediaSnapshotSchema: z.ZodObject<{
   coverUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type BoardMediaSnapshot = z.infer<typeof BoardMediaSnapshotSchema>;
+declare const BoardMediaOriginSchema: z.ZodObject<{
+  taskRunId: z.ZodString;
+  artifactId: z.ZodString;
+}, z.core.$strict>;
+type BoardMediaOrigin = z.infer<typeof BoardMediaOriginSchema>;
 declare const BoardCropSchema: z.ZodObject<{
   x: z.ZodNumber;
   y: z.ZodNumber;
@@ -551,6 +556,10 @@ declare const BoardImageItemSchema: z.ZodObject<{
       coverPath: z.ZodOptional<z.ZodString>;
       coverUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    origin: z.ZodOptional<z.ZodObject<{
+      taskRunId: z.ZodString;
+      artifactId: z.ZodString;
+    }, z.core.$strict>>;
     crop: z.ZodOptional<z.ZodObject<{
       x: z.ZodNumber;
       y: z.ZodNumber;
@@ -623,6 +632,10 @@ declare const BoardVideoItemSchema: z.ZodObject<{
       coverPath: z.ZodOptional<z.ZodString>;
       coverUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    origin: z.ZodOptional<z.ZodObject<{
+      taskRunId: z.ZodString;
+      artifactId: z.ZodString;
+    }, z.core.$strict>>;
     time: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strict>;
 }, z.core.$strict>;
@@ -690,6 +703,10 @@ declare const BoardAudioItemSchema: z.ZodObject<{
       coverPath: z.ZodOptional<z.ZodString>;
       coverUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>>;
+    origin: z.ZodOptional<z.ZodObject<{
+      taskRunId: z.ZodString;
+      artifactId: z.ZodString;
+    }, z.core.$strict>>;
     time: z.ZodOptional<z.ZodNumber>;
   }, z.core.$strict>;
 }, z.core.$strict>;
@@ -804,6 +821,7 @@ declare const BoardTaskSnapshotSchema: z.ZodObject<{
   title: z.ZodString;
   model: z.ZodOptional<z.ZodString>;
   promptExcerpt: z.ZodOptional<z.ZodString>;
+  errorExcerpt: z.ZodOptional<z.ZodString>;
   artifactCount: z.ZodNumber;
   artifacts: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
     id: z.ZodString;
@@ -837,6 +855,7 @@ declare const BoardTaskSnapshotSchema: z.ZodObject<{
     title: z.ZodOptional<z.ZodString>;
     textExcerpt: z.ZodString;
   }, z.core.$strict>], "type">>>;
+  startedAt: z.ZodOptional<z.ZodString>;
   updatedAt: z.ZodOptional<z.ZodString>;
 }, z.core.$strict>;
 type BoardTaskSnapshot = z.infer<typeof BoardTaskSnapshotSchema>;
@@ -903,6 +922,7 @@ declare const BoardTaskItemSchema: z.ZodObject<{
       title: z.ZodString;
       model: z.ZodOptional<z.ZodString>;
       promptExcerpt: z.ZodOptional<z.ZodString>;
+      errorExcerpt: z.ZodOptional<z.ZodString>;
       artifactCount: z.ZodNumber;
       artifacts: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
         id: z.ZodString;
@@ -936,6 +956,7 @@ declare const BoardTaskItemSchema: z.ZodObject<{
         title: z.ZodOptional<z.ZodString>;
         textExcerpt: z.ZodString;
       }, z.core.$strict>], "type">>>;
+      startedAt: z.ZodOptional<z.ZodString>;
       updatedAt: z.ZodOptional<z.ZodString>;
     }, z.core.$strict>;
   }, z.core.$strict>;
@@ -1581,6 +1602,10 @@ declare const BOARD_ITEM_SCHEMAS: {
         coverPath: z.ZodOptional<z.ZodString>;
         coverUrl: z.ZodOptional<z.ZodString>;
       }, z.core.$strict>>;
+      origin: z.ZodOptional<z.ZodObject<{
+        taskRunId: z.ZodString;
+        artifactId: z.ZodString;
+      }, z.core.$strict>>;
       crop: z.ZodOptional<z.ZodObject<{
         x: z.ZodNumber;
         y: z.ZodNumber;
@@ -1653,6 +1678,10 @@ declare const BOARD_ITEM_SCHEMAS: {
         coverPath: z.ZodOptional<z.ZodString>;
         coverUrl: z.ZodOptional<z.ZodString>;
       }, z.core.$strict>>;
+      origin: z.ZodOptional<z.ZodObject<{
+        taskRunId: z.ZodString;
+        artifactId: z.ZodString;
+      }, z.core.$strict>>;
       time: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
   }, z.core.$strict>;
@@ -1720,6 +1749,10 @@ declare const BOARD_ITEM_SCHEMAS: {
         coverPath: z.ZodOptional<z.ZodString>;
         coverUrl: z.ZodOptional<z.ZodString>;
       }, z.core.$strict>>;
+      origin: z.ZodOptional<z.ZodObject<{
+        taskRunId: z.ZodString;
+        artifactId: z.ZodString;
+      }, z.core.$strict>>;
       time: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strict>;
   }, z.core.$strict>;
@@ -1852,6 +1885,7 @@ declare const BOARD_ITEM_SCHEMAS: {
         title: z.ZodString;
         model: z.ZodOptional<z.ZodString>;
         promptExcerpt: z.ZodOptional<z.ZodString>;
+        errorExcerpt: z.ZodOptional<z.ZodString>;
         artifactCount: z.ZodNumber;
         artifacts: z.ZodDefault<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
           id: z.ZodString;
@@ -1885,6 +1919,7 @@ declare const BOARD_ITEM_SCHEMAS: {
           title: z.ZodOptional<z.ZodString>;
           textExcerpt: z.ZodString;
         }, z.core.$strict>], "type">>>;
+        startedAt: z.ZodOptional<z.ZodString>;
         updatedAt: z.ZodOptional<z.ZodString>;
       }, z.core.$strict>;
     }, z.core.$strict>;
@@ -2239,4 +2274,4 @@ type BoardDelta = {
 };
 declare function isEmptyBoardDelta(delta: BoardDelta): boolean;
 //#endregion
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrameItem, BoardFrameItemSchema, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemType, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardMarker, BoardMarkerSchema, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchSchema, BoardPlayMode, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTrack, BoardTrackSchema, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

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

@@ -222,8 +222,16 @@ const fileProps = {
 	src: BoardMediaSourceSchema,
 	snapshot: BoardMediaSnapshotSchema.optional()
 };
-const timedFileProps = {
+const BoardMediaOriginSchema = z.object({
+	taskRunId: z.string().min(1).max(160),
+	artifactId: z.string().min(1).max(240)
+}).strict();
+const mediaProps = {
 	...fileProps,
+	origin: BoardMediaOriginSchema.optional()
+};
+const timedFileProps = {
+	...mediaProps,
 	time: nonNegative.optional()
 };
 const BoardCropSchema = z.object({
@@ -236,7 +244,7 @@ const BoardImageItemSchema = z.object({
 	...boxed(640, 360),
 	type: z.literal("image"),
 	props: z.object({
-		...fileProps,
+		...mediaProps,
 		crop: BoardCropSchema.optional()
 	}).strict()
 }).strict();
@@ -302,8 +310,10 @@ const BoardTaskSnapshotSchema = z.object({
 	title: z.string().min(1).max(240),
 	model: z.string().max(160).optional(),
 	promptExcerpt: z.string().max(480).optional(),
+	errorExcerpt: z.string().max(240).optional(),
 	artifactCount: z.number().int().nonnegative(),
 	artifacts: z.array(BoardTaskArtifactSchema).max(6).default([]),
+	startedAt: z.string().max(64).optional(),
 	updatedAt: z.string().optional()
 }).strict();
 const BoardTaskItemSchema = z.object({
@@ -311,7 +321,7 @@ const BoardTaskItemSchema = z.object({
 	type: z.literal("task"),
 	props: z.object({
 		taskRunId: z.string().min(1).max(160),
-		snapshot: BoardTaskSnapshotSchema
+		snapshot: BoardTaskSnapshotSchema.describe("Maintained by the server for tasks in the Board's Space; writers may omit it.")
 	}).strict()
 }).strict();
 const BOARD_EFFECT_KINDS = [
@@ -608,4 +618,4 @@ function isEmptyBoardDelta(delta) {
 	return !delta.board && Object.keys(delta.items ?? {}).length === 0 && Object.keys(delta.animations ?? {}).length === 0 && Object.keys(delta.tracks ?? {}).length === 0;
 }
 //#endregion
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SHAPE_GEOMETRIES, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TEXT_ALIGNS, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardArrowAnchorSchema, BoardArrowBindingSchema, BoardArrowEndSchema, BoardArrowItemSchema, BoardAudioItemSchema, BoardBackgroundSchema, BoardColorSchema, BoardCropSchema, BoardCustomItemSchema, BoardDrawItemSchema, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItemSchema, BoardExtensionItemSchema, BoardFileItemSchema, BoardFrameItemSchema, BoardIdSchema, BoardImageItemSchema, BoardKeySchema, BoardKeyframeSchema, BoardMarkerSchema, BoardMediaOriginSchema, BoardMediaSnapshotSchema, BoardMediaSourceSchema, BoardPatchSchema, BoardScriptSchema, BoardSettingsSchema, BoardShapeItemSchema, BoardSizeSchema, BoardStyleSchema, BoardTaskArtifactSchema, BoardTaskItemSchema, BoardTaskSnapshotSchema, BoardTextItemSchema, BoardTrackSchema, BoardVec2Schema, BoardVideoItemSchema, boardItemSchema, emptyBoardDocument, hasAuthoredSize, isBoardColorString, isBoardEase, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isFileBackedItem, isMediaItem, isSafeBoardSourcePath, parseBoardItem, parseBoardMediaSource };

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

@@ -0,0 +1,22 @@
+import { BoardTaskArtifact, BoardTaskSnapshot } from "./board-model.js";
+import { GenerationRunPayload } from "./generation/blocks.js";
+import { TaskRunStatus } from "./task/index.js";
+//#region ../protocol/dist/board-task.d.ts
+type BoardTaskRunSource = GenerationRunPayload & {
+  taskType: string;
+  status: TaskRunStatus;
+  errorMessage?: string | null;
+  startedAt?: string | null;
+  updatedAt: string;
+};
+declare const BOARD_TASK_SOURCE_PREFIX = "cohub-task:";
+declare const boardTaskSource: (taskRunId: string) => string;
+declare function taskArtifacts(blocks: Record<string, unknown>[]): BoardTaskArtifact[];
+declare function rankedTaskArtifacts(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact[];
+declare function featuredTaskArtifact(artifacts: readonly BoardTaskArtifact[]): BoardTaskArtifact | undefined;
+declare function taskArtifactPreviewUrl(artifact: BoardTaskArtifact | undefined): string | undefined;
+declare function taskRunArtifacts(run: Pick<BoardTaskRunSource, "taskType" | "result">): BoardTaskArtifact[];
+declare function taskRunToBoardTaskSnapshot(run: BoardTaskRunSource): BoardTaskSnapshot;
+declare function withObservedArtifactFacts(snapshot: BoardTaskSnapshot, observed: BoardTaskSnapshot | undefined): BoardTaskSnapshot;
+//#endregion
+export { BOARD_TASK_SOURCE_PREFIX, BoardTaskRunSource, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts };

package/dist/{board/model/task.js → protocol/dist/board-task.js}

@@ -1,6 +1,8 @@
-import "../../protocol/dist/board-model.js";
-import { blockDurationMs, blockIdentity, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, generationCovers, generationOutput, generationPrompt, taskData } from "../../generation-blocks.js";
-//#region src/board/model/task.ts
+import "./board-model.js";
+import { blockDurationMs, blockIdentity, blockMimeType, blockNaturalSize, blockPreviewUrl, blockText, blockTitle, blockUrl, cleanExcerpt, generationCovers, generationOutput, generationPrompt, taskData } from "./generation/blocks.js";
+//#region ../protocol/dist/board-task.js
+const BOARD_TASK_SOURCE_PREFIX = "cohub-task:";
+const boardTaskSource = (taskRunId) => `${BOARD_TASK_SOURCE_PREFIX}${taskRunId}`;
 function artifactId(base, used, suffix) {
 	const stem = cleanExcerpt(base, 220) ?? "output";
 	let candidate = suffix ? `${stem}-${suffix}` : stem;
@@ -137,23 +139,48 @@ function taskArtifactPreviewUrl(artifact) {
 function taskTypeTitle(taskType) {
 	return taskType.replace(/[._-]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase());
 }
+function taskRunArtifacts(run) {
+	return run.taskType === "generation" ? rankedTaskArtifacts(taskArtifacts(generationOutput(run))) : [];
+}
 function taskRunToBoardTaskSnapshot(run) {
 	const data = taskData(run);
-	const blocks = run.taskType === "generation" ? generationOutput(run) : [];
 	const promptExcerpt = run.taskType === "generation" ? generationPrompt(run) : cleanExcerpt(data?.command ?? data?.prompt ?? data?.title);
 	const model = typeof data?.model === "string" ? data.model : void 0;
-	const allArtifacts = taskArtifacts(blocks);
-	const artifacts = rankedTaskArtifacts(allArtifacts).slice(0, 6);
+	const allArtifacts = taskRunArtifacts(run);
+	const artifacts = allArtifacts.slice(0, 6);
+	const errorExcerpt = run.status === "failed" ? cleanExcerpt(run.errorMessage, 240) : void 0;
 	return {
 		taskType: run.taskType,
 		status: run.status,
 		title: promptExcerpt ?? taskTypeTitle(run.taskType),
 		...model ? { model } : {},
 		...promptExcerpt ? { promptExcerpt } : {},
+		...errorExcerpt ? { errorExcerpt } : {},
 		artifactCount: allArtifacts.length,
 		artifacts,
+		...run.startedAt ? { startedAt: run.startedAt } : {},
 		updatedAt: run.updatedAt
 	};
 }
+function withObservedArtifactFacts(snapshot, observed) {
+	if (!observed?.artifacts.length) return snapshot;
+	let changed = false;
+	const artifacts = snapshot.artifacts.map((artifact) => {
+		if (artifact.type !== "image" && artifact.type !== "video") return artifact;
+		if (artifact.naturalWidth && artifact.naturalHeight) return artifact;
+		const match = observed.artifacts.find((candidate) => candidate.id === artifact.id && candidate.type === artifact.type && candidate.url === artifact.url);
+		if (!match || match.type !== "image" && match.type !== "video" || !match.naturalWidth || !match.naturalHeight) return artifact;
+		changed = true;
+		return {
+			...artifact,
+			naturalWidth: match.naturalWidth,
+			naturalHeight: match.naturalHeight
+		};
+	});
+	return changed ? {
+		...snapshot,
+		artifacts
+	} : snapshot;
+}
 //#endregion
-export { featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunToBoardTaskSnapshot };
+export { BOARD_TASK_SOURCE_PREFIX, boardTaskSource, featuredTaskArtifact, rankedTaskArtifacts, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, withObservedArtifactFacts };