@neta-art/cohub 5.7.0 → 5.8.1

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 = () => {

package/dist/chunks/http.d.ts

@@ -1,4 +1,4 @@
-import { $ as CreateSpacePromptInput, $n as SpaceFsTreeResponse, Aa as SessionTurnRecord, Ai as WorkContentKind, Ar as SpaceUsageResponse, At as Permission, Ba as SpaceCompletionStreamEvent, Bi as UiCommandError, Br as ChannelHealth, Bt as ReferenceAggregateGroupBy, Ci as BoardAwarenessUpdate, Cn as SpaceCommerceBenefit, Ct as LabelResourceType, Da as SessionForkRecord, Dn as SpaceCommerceOrder, Dt as ModelCatalogEntry, Ea as MessageRecord, Er as SpaceTurnAuthorFilter, Et as MeResponse, Fn as SpaceCreateResponse, Fr as UserRulesResponse, Ft as PublicUserPageResponse, Gt as ReferenceQueryableType, Ha as BillingPayload, Hi as UiCommandStatus, Hn as SpaceFsCreateUploadResponse, Ht as ReferenceDirection, In as SpaceDefaultResponse, J as ClaimReferralResponse, Jn as SpaceFsMoveInput, Jt as ReferralDashboard, K as CheckpointDiffSummary, La as CreateSpaceCompletionInput, Ln as SpaceEnvInput, Mn as SpaceConfigInput, Mr as TaskRunDetailResponse, Nn as SpaceConfigResponse, Nr as TaskRunRecord, Nt as PromptTemplateCatalogResponse, On as SpaceCommerceProduct, Ot as PatchResourceLabelsInput, Pn as SpaceConfigUpdateResponse, Pr as UserProfile, Pt as PublicReferral, Qi as BoardCapabilities, Qn as SpaceFsReadFilesResponse, R as Channel, Ri as UiCommand, Rn as SpaceFsCompleteUploadInput, Rr as UserSessionsResponse, Sa as BoardConnectionRecord, Sn as SpaceCheckpointDetailResponse, Ta as SpacePublicEndpoints, Tr as SpaceSessionsResponse, Ua as ContentBlock, Ut as ReferenceKind, V as CheckpointDiffFileResponse, Va as Usage, Vi as UiCommandRecord, Vn as SpaceFsCreateUploadInput, Vt as ReferenceAggregateResponse, Wt as ReferenceQueryResponse, X as CreateInvitationResponse, Y as CreateInvitationInput, Yn as SpaceFsPreparingFile, Z as CreateSpaceInput, Zi as BoardBootstrap, _a as BoardTransaction, _r as SpacePresenceSnapshot, a as WebsocketClientOptions, an as SessionRecord, at as CursorPageInfo, ba as BoardConnection, br as SpaceRecord, ci as BoardTransactionAppliedEvent$1, cn as SessionTurnSignedUrlsResponse, d as BatchUserProfilesResponse, di as RealtimePatchOperation, dn as SessionTurnsPaginatedResponse, dt as GlobalSearchType, ea as BoardCreateInput, et as CreateSpacePromptResponse, fr as SpaceMember, ft as InvitationDetail, gn as SpaceAccessPolicy, gr as SpacePendingDiffSummary, hr as SpacePendingDiffFileResponse, ia as BoardInspectInput, ii as GenerationModelDeclaration, in as SessionMessagesResponse, it as CronJobUpdatePatch, ja as SpaceTurnsResponse, kn as SpaceCommerceProductBenefitBinding, kt as PatchResourceLabelsResponse, l as AcceptInvitationResponse, ln as SessionTurnStreamSnapshotResponse, lr as SpaceInvitationListResponse, lt as GlobalSearchResponse, mr as SpaceModListItem, nn as SessionMessageResponse, oi as BoardAwarenessUpdatedEvent$1, on as SessionTurnIndexResponse, or as SpaceFsUploadResponse, pa as BoardPlaybackSnapshot, pn as SkillCatalogResponse, q as CheckpointRecord, qa as RequestSource, qn as SpaceFsFileResponse, r as WebsocketClient, ri as GenerationContentBlock, rn as SessionMessagesPaginatedResponse, rt as CronJobRecord, s as WebsocketEventPayload, si as BoardPlaybackChangedEvent$1, sn as SessionTurnResponse, sr as SpaceFsWriteFileInput, tt as CreateSpaceSessionInput, ua as BoardPlaybackCommand, un as SessionTurnWindowResponse, va as BoardValidationResult, vi as SessionTurnPatchEvent, vt as LabelAssignmentRecord, wi as WorkArtifactDescriptor, wn as SpaceCommerceBuyerProfile, xa as BoardConnectionDirection, xr as SpaceRole, xt as LabelListItem, yr as SpacePublicProfile, yt as LabelItemsResponse, za as SpaceCompletionResult, zn as SpaceFsCompleteUploadResponse, zr as ChannelConfig } from "./websocket.js";
+import { $ as CreateInvitationInput, $n as SpaceFsPreparingFile, Ar as SpaceTurnAuthorFilter, At as MeResponse, Ba as BoardConnectionRecord, Bn as SpaceDefaultResponse, Cr as SpacePublicProfile, Ct as LabelItemsResponse, Dn as SpaceCommerceBenefit, Dt as LabelResourceType, Ea as BoardValidationResult, Ei as SessionTurnPatchEvent, En as SpaceCheckpointDetailResponse, G as CheckpointDiffFileResponse, Ga as SessionForkRecord, Gn as SpaceFsCreateUploadInput, Gt as ReferenceAggregateResponse, H as Channel, Hn as SpaceFsCompleteUploadInput, Hr as UserProfile, In as SpaceConfigInput, Ir as TaskRunDetailResponse, Ja as SessionTurnRecord, Ji as UiCommandError, Jr as ChannelHealth, Jt as ReferenceQueryResponse, Ki as UiCommand, Kn as SpaceFsCreateUploadResponse, Kr as UserSessionsResponse, Kt as ReferenceDirection, Ln as SpaceConfigResponse, Lr as TaskRunRecord, Lt as PromptTemplateCatalogResponse, Mi as WorkArtifactDescriptor, Mn as SpaceCommerceProduct, Mt as PatchResourceLabelsInput, Nn as SpaceCommerceProductBenefitBinding, Nt as PatchResourceLabelsResponse, On as SpaceCommerceBuyerProfile, Pr as SpaceUsageResponse, Pt as Permission, Q as ClaimReferralResponse, Qn as SpaceFsMoveInput, Qt as ReferralDashboard, Ra as BoardConnection, Ri as WorkContentKind, Rn as SpaceConfigUpdateResponse, Rr as UserActivityQuery, Rt as PublicReferral, St as LabelAssignmentRecord, Ta as BoardTransaction, Tr as SpaceRole, Tt as LabelListItem, Ua as SpacePublicEndpoints, Un as SpaceFsCompleteUploadResponse, Ur as UserRulesResponse, Vn as SpaceEnvInput, Vr as UserActivityResponse, Wa as MessageRecord, Wt as ReferenceAggregateGroupBy, X as CheckpointDiffSummary, Xi as UiCommandStatus, Ya as SpaceTurnsResponse, Yi as UiCommandRecord, Yt as ReferenceQueryableType, Z as CheckpointRecord, Zn as SpaceFsFileResponse, _n as SkillCatalogResponse, a as WebsocketClientOptions, aa as BoardBootstrap, ao as Usage, at as CreateSpaceSessionInput, bn as SpaceAccessPolicy, br as SpacePendingDiffSummary, ca as BoardCreateInput, cn as SessionMessagesResponse, ct as CronJobUpdatePatch, d as BatchUserProfilesResponse, di as GenerationContentBlock, dn as SessionTurnResponse, do as RequestSource, dr as SpaceFsWriteFileInput, et as CreateInvitationResponse, fa as BoardInspectInput, fi as GenerationModelDeclaration, fn as SessionTurnSignedUrlsResponse, gi as BoardTransactionAppliedEvent$1, gr as SpaceMember, gt as InvitationDetail, hi as BoardPlaybackChangedEvent$1, hn as SessionTurnsPaginatedResponse, ht as GlobalSearchType, io as SpaceCompletionStreamEvent, it as CreateSpacePromptResponse, ji as BoardAwarenessUpdate, jn as SpaceCommerceOrder, jt as ModelCatalogEntry, kr as SpaceSessionsResponse, l as AcceptInvitationResponse, ln as SessionRecord, lt as CursorPageInfo, mi as BoardAwarenessUpdatedEvent$1, mn as SessionTurnWindowResponse, nr as SpaceFsReadFilesResponse, oa as BoardCapabilities, on as SessionMessageResponse, oo as BillingPayload, pn as SessionTurnStreamSnapshotResponse, pr as SpaceInvitationListResponse, pt as GlobalSearchResponse, qr as ChannelConfig, qt as ReferenceKind, r as WebsocketClient, ro as SpaceCompletionResult, rr as SpaceFsTreeResponse, rt as CreateSpacePromptInput, s as WebsocketEventPayload, sn as SessionMessagesPaginatedResponse, so as ContentBlock, st as CronJobRecord, to as CreateSpaceCompletionInput, tt as CreateSpaceInput, un as SessionTurnIndexResponse, ur as SpaceFsUploadResponse, va as BoardPlaybackCommand, vr as SpaceModListItem, wr as SpaceRecord, xa as BoardPlaybackSnapshot, xr as SpacePresenceSnapshot, yi as RealtimePatchOperation, yr as SpacePendingDiffFileResponse, za as BoardConnectionDirection, zn as SpaceCreateResponse, zt as PublicUserPageResponse } from "./websocket.js";
 import { n as CohubEnvironment } from "./environment.js";
 import { a as VoiceInputCreateOptions } from "./voice-input.js";
 //#region ../protocol/dist/model/status.d.ts
@@ -161,6 +161,49 @@ type SpaceStartupResponse = {
   retryAfterMs?: number;
 };
 //#endregion
+//#region ../protocol/dist/public-files.d.ts
+type PublicFileUploadEntryInput = {
+  id: string;
+  relativePath: string;
+  size: number;
+  mimeType?: string | null;
+};
+type PublicFileCreateUploadInput = {
+  entries: PublicFileUploadEntryInput[];
+  overwrite?: boolean;
+};
+type PublicFileUploadPlanEntry = {
+  id: string;
+  path: string;
+  uploadUrl: string;
+  publicUrl: string;
+  headers?: Record<string, string>;
+};
+type PublicFileCreateUploadResponse = {
+  entries: PublicFileUploadPlanEntry[];
+};
+type PublicFileListEntry = {
+  path: string;
+  name: string;
+  kind: "file" | "directory";
+  size: number | null;
+  updatedAt: string | null;
+  publicUrl: string | null;
+};
+type PublicFileListResponse = {
+  path: string;
+  entries: PublicFileListEntry[];
+  nextCursor: string | null;
+};
+type PublicFileUrlResponse = {
+  path: string;
+  url: string;
+};
+//#endregion
+//#region ../protocol/dist/work-promotion-stats.d.ts
+declare const WORK_PROMOTION_EVENT_KEYS: readonly ["landing", "ready", "registration_completed", "paywall_viewed", "checkout_started"];
+type WorkPromotionEventKey = typeof WORK_PROMOTION_EVENT_KEYS[number];
+//#endregion
 //#region src/work-runtime.d.ts
 type WorkRuntimeContext = {
   work: {
@@ -293,7 +336,7 @@ declare class WorkRuntimeApi {
 type WorkRuntimeModeConfig = {
   /** Explicit mode selection. When omitted, auto-detection is used. */
   mode?: "bridge" | "broker";
-  /** Cohub origin for the broker page (e.g. "https://cohub.run"). */
+  /** Cohub origin for the broker page (e.g. "https://cohub.live"). */
   brokerOrigin?: string;
   /**
    * The work's public id. Required for broker mode unless the slug triple
@@ -961,12 +1004,38 @@ declare class SpacesApi {
   getBySlug(username: string, slug: string, customFetch?: Fetch): Promise<SpaceRecord>;
   create(input: CreateSpaceInput, headers?: Record<string, string>): Promise<SpaceCreateResponse>;
 }
+type SpaceFileUrlPurpose = "preview" | "playback";
+type ResolveSpaceFileUrlOptions = {
+  /** Playback only accepts a streamable URL; previews may fall back to a data URL. */
+  purpose?: SpaceFileUrlPurpose;
+  /** Maximum time to wait while CDN delivery is being prepared. */
+  timeoutMs?: number;
+  signal?: AbortSignal;
+  fetch?: Fetch;
+};
+declare class SpacePublicFilesApi {
+  private readonly transport;
+  private readonly spaceId;
+  constructor(transport: HttpTransport, spaceId: string);
+  createUpload(input: PublicFileCreateUploadInput, options?: {
+    signal?: AbortSignal;
+  }): Promise<PublicFileCreateUploadResponse>;
+  list(path?: string, options?: {
+    recursive?: boolean;
+    limit?: number;
+    cursor?: string;
+    fetch?: Fetch;
+  }): Promise<PublicFileListResponse>;
+  url(path: string, customFetch?: Fetch): Promise<PublicFileUrlResponse>;
+}
 declare class SpaceFilesApi {
   private readonly transport;
   private readonly spaceId;
   constructor(transport: HttpTransport, spaceId: string);
   list(path?: string, customFetch?: Fetch): Promise<SpaceFsTreeResponse>;
-  read(path: string, customFetch?: Fetch): Promise<SpaceFsFileResponse | SpaceFsPreparingFile>;
+  read(path: string, customFetch?: Fetch, signal?: AbortSignal): Promise<SpaceFsFileResponse | SpaceFsPreparingFile>;
+  /** Resolve a browser-ready file URL, waiting for CDN delivery when necessary. */
+  resolveUrl(path: string, options?: ResolveSpaceFileUrlOptions): Promise<string | null>;
   /** Pending workspace changes vs the space head checkpoint. */
   diff(customFetch?: Fetch): Promise<SpacePendingDiffSummary>;
   /** Per-file pending workspace diff vs the space head checkpoint. */
@@ -1475,6 +1544,8 @@ declare class BoardClient {
     relation?: string;
     direction?: BoardConnectionDirection;
     label?: string;
+    sourcePortId?: string;
+    targetPortId?: string;
     txId?: string;
   }): Promise<BoardBootstrap>;
   /** Remove a connection. The nodes it joined are untouched. */
@@ -1600,6 +1671,7 @@ declare class SpaceClient {
   private readonly transport;
   private readonly websocketClient;
   readonly files: SpaceFilesApi;
+  readonly publicFiles: SpacePublicFilesApi;
   readonly sessions: SpaceSessionsApi;
   readonly turns: SpaceTurnsApi;
   readonly members: SpaceMembersApi;
@@ -1744,7 +1816,7 @@ declare class UserApi {
     space: SpaceRecord;
     session: SessionRecord;
   }>;
-  getUsage(days?: number, customFetch?: Fetch): Promise<SpaceUsageResponse>;
+  getActivity(options?: UserActivityQuery, customFetch?: Fetch): Promise<UserActivityResponse>;
   setAuthToken(token: string): Promise<any>;
   clearAuthToken(): Promise<null>;
 }
@@ -1948,6 +2020,54 @@ type WorkViewStatsResponse = {
     views: number;
   }>;
 };
+type WorkPromotionProvider = "generic" | "meta";
+type WorkPromotionRecord = {
+  id: string;
+  workId: string;
+  name: string;
+  provider: WorkPromotionProvider | string;
+  parameters: Record<string, string>;
+  createdBy: string;
+  createdAt: string;
+};
+type WorkPromotionProviderStatus = {
+  key: WorkPromotionProvider | string;
+  configured: boolean;
+};
+type WorkPromotionCreateInput = {
+  name: string;
+  provider: WorkPromotionProvider | string;
+  parameters: Record<string, string>;
+};
+type WorkPromotionStatsResponse = {
+  promotion: WorkPromotionRecord;
+  summary: {
+    landing: number;
+    ready: number;
+    registrationCompleted: number;
+    paywallViewed: number;
+    checkoutStarted: number;
+    readyRate: number;
+  };
+  daily: Array<{
+    date: string;
+    landing: number;
+    ready: number;
+    registrationCompleted: number;
+    paywallViewed: number;
+    checkoutStarted: number;
+  }>;
+};
+type WorkPromotionEventResponse = {
+  ok: true;
+  eventId: string;
+  browser: {
+    provider: "generic";
+  } | {
+    provider: "meta";
+    pixelId: string;
+  } | null;
+};
 type WorkSessionResponse = {
   token: string;
   expiresIn: number;
@@ -1987,6 +2107,31 @@ declare class WorksApi {
     ok: true;
   }>;
   getStats(workId: string): Promise<WorkViewStatsResponse>;
+  listPromotions(workId: string): Promise<{
+    promotions: WorkPromotionRecord[];
+    providers: WorkPromotionProviderStatus[];
+  }>;
+  createPromotion(workId: string, input: WorkPromotionCreateInput): Promise<{
+    promotion: WorkPromotionRecord;
+  }>;
+  getPromotionStats(workId: string, promotionId: string): Promise<WorkPromotionStatsResponse>;
+  recordPromotionEvent(workId: string, promotionId: string, input: {
+    eventKey: WorkPromotionEventKey;
+    eventId?: string;
+    sourceUrl?: string;
+    fbp?: string;
+    fbc?: string;
+    productKey?: string;
+  }): Promise<WorkPromotionEventResponse>;
+  recordPromotionRegistration(workId: string, promotionId: string, input?: {
+    sourceUrl?: string;
+    fbp?: string;
+    fbc?: string;
+  }): Promise<{
+    reported: boolean;
+    eventId: string | null;
+    browser: WorkPromotionEventResponse["browser"];
+  }>;
   listVersions(workId: string): Promise<{
     versions: WorkVersionRecord[];
   }>;
@@ -2038,6 +2183,8 @@ type WorkCommercePurchaseResponse = {
     message: string | null;
     orderId: string;
     productKey: string;
+    value: number | null;
+    currency: string | null;
   };
 };
 type WorkCommerceOrder = {
@@ -2098,4 +2245,4 @@ declare class CohubHttpClient {
 }
 declare const createHttpClient: (options?: CohubClientOptions) => CohubHttpClient;
 //#endregion
-export { SpaceEventName as $, HttpTransport as $t, WorkViewSource as A, ReferenceResourceSelector as At, TasksApi as B, UploadChatAttachmentInput as Bt, WorkRecord as C, ListGenerationModelsResponse as Cn, SessionPatchApplyInput as Ct, WorkTargetType as D, SessionPatchStatus as Dt, WorkStatus as E, ModelStatusResponse as En, SessionPatchState as Et, UsersApi as F, PublicAssetMimeType as Ft, BoardSubscriptionHandlers as G, ModelsApi as Gt, BoardClient as H, UploadPublicAssetInput as Ht, UserApi as I, PublicAssetPurpose as It, BoardTransactionInput as J, ChannelsApi as Jt, BoardTransactionAppliedEvent as K, GenerationsApi as Kt, CreateUiCommandInput as L, PublicAssetUploadProgress as Lt, WorkVisibility as M, SearchApi as Mt, WorksApi as N, CreatePublicAssetUploadInput as Nt, WorkUpdateInput as O, createSessionPatchReducer as Ot, ReferralsApi as P, CreatePublicAssetUploadResponse as Pt, SpaceClient as Q, HttpTraceContext as Qt, UiCommandsApi as R, PublicAssetUploadProtocol as Rt, WorkPublicSpaceRecord as S, GenerationUsageBilling as Sn, parseAssistantMessageCommit as St, WorkSessionResponse as T, ModelStatusEntry as Tn, SessionPatchReducer as Tt, BoardEventName as U, SkillsApi as Ut, BoardAwarenessUpdatedEvent as V, UploadChatImageAttachmentInput as Vt, BoardPlaybackChangedEvent as W, PromptsApi as Wt, SessionSubscriptionHandlers as X, Fetch as Xt, SessionEventName as Y, CohubClientOptions as Yt, SpaceChannelBindingRecord as Z, HttpError as Zt, WorkExtractedPageMeta as _, resolveWorkTransport as _n, GenerationStreamSubscribeOptions as _t, WorkCommerceCreditConsumeResponse as a, ParentBridgeTransport as an, PublicInviteApi as at, WorkPresentationMeta as b, CreateGenerationTaskResponse as bn, SessionGenerationStreamClient as bt, WorkCommerceEntitlementsResponse as c, WorkRuntimeApi as cn, AssistantMessageCommit as ct, WorkCommercePurchaseResponse as d, WorkRuntimeContext as dn, GenerationStreamEvent as dt, RawHttpResponse as en, SpaceTurnListOptions as et, WorkAuthorizeResponse as f, WorkRuntimeModeConfig as fn, GenerationStreamFinalizedEvent as ft, WorkDetailResponse as g, createWorkRuntime as gn, GenerationStreamStateEvent as gt, WorkCreateInput as h, createSlugWorkIdResolver as hn, GenerationStreamOutOfSyncEvent as ht, WorkCommerceCheckoutStatus as i, sanitizeAccessToken as in, BuildSpacePathInput as it, WorkViewStatsResponse as j, ReferencesApi as jt, WorkVersionRecord as k, SessionAccessApi as kt, WorkCommerceOrder as l, WorkRuntimeCheckoutState as ln, GenerationStreamCommitEvent as lt, WorkContentDownload as m, WorkRuntimeTransport as mn, GenerationStreamLifecycleEvent as mt, createHttpClient as n, joinApiUrl as nn, WebSocketConnectionState as nt, WorkCommerceCreditConsumeStatus as o, PopupBrokerTransport as on, buildSpaceInvitePath as ot, WorkContent as p, WorkRuntimeRequestOptions as pn, GenerationStreamIntermediateMessage as pt, BoardTransactionError as q, CronJobsApi as qt, WorkCommerceApi as r, matchesUnauthorizedErrorToken as rn, BuildSpaceInvitePathInput as rt, WorkCommerceEntitlement as s, WorkIdResolver as sn, buildSpacePath as st, CohubHttpClient as t, UnauthorizedContext as tn, SpacesApi as tt, WorkCommerceProductResolveResponse as u, WorkRuntimeCheckoutStatus as un, GenerationStreamErrorEvent as ut, WorkGetResponse as v, SpaceStartupResponse as vn, GenerationStreamSubscriptionHandlers as vt, WorkResolveResponse as w, PublicGenerationDeclaration as wn, SessionPatchApplyResult as wt, WorkPublicOwnerRecord as x, GenerationTaskResult as xn, createSessionGenerationStreamClient as xt, WorkMeta as y, CreateGenerationTaskRequest as yn, GenerationStreamTurnUpdatedEvent as yt, WaitForUiCommandOptions as z, PublicAssetsApi as zt };
+export { BoardTransactionError as $, GenerationsApi as $t, WorkResolveResponse as A, PublicFileUploadPlanEntry as An, SessionPatchApplyInput as At, ReferralsApi as B, ModelStatusResponse as Bn, CreatePublicAssetUploadInput as Bt, WorkPromotionProvider as C, createWorkRuntime as Cn, GenerationStreamStateEvent as Ct, WorkPublicOwnerRecord as D, PublicFileListEntry as Dn, SessionGenerationStreamClient as Dt, WorkPromotionStatsResponse as E, PublicFileCreateUploadResponse as En, GenerationStreamTurnUpdatedEvent as Et, WorkVersionRecord as F, GenerationTaskResult as Fn, createSessionPatchReducer as Ft, WaitForUiCommandOptions as G, PublicAssetUploadProtocol as Gt, UserApi as H, PublicAssetMimeType as Ht, WorkViewSource as I, GenerationUsageBilling as In, SessionAccessApi as It, BoardClient as J, UploadChatImageAttachmentInput as Jt, TasksApi as K, PublicAssetsApi as Kt, WorkViewStatsResponse as L, ListGenerationModelsResponse as Ln, ReferenceResourceSelector as Lt, WorkStatus as M, SpaceStartupResponse as Mn, SessionPatchReducer as Mt, WorkTargetType as N, CreateGenerationTaskRequest as Nn, SessionPatchState as Nt, WorkPublicSpaceRecord as O, PublicFileListResponse as On, createSessionGenerationStreamClient as Ot, WorkUpdateInput as P, CreateGenerationTaskResponse as Pn, SessionPatchStatus as Pt, BoardTransactionAppliedEvent as Q, ModelsApi as Qt, WorkVisibility as R, PublicGenerationDeclaration as Rn, ReferencesApi as Rt, WorkPromotionEventResponse as S, createSlugWorkIdResolver as Sn, GenerationStreamOutOfSyncEvent as St, WorkPromotionRecord as T, PublicFileCreateUploadInput as Tn, GenerationStreamSubscriptionHandlers as Tt, CreateUiCommandInput as U, PublicAssetPurpose as Ut, UsersApi as V, CreatePublicAssetUploadResponse as Vt, UiCommandsApi as W, PublicAssetUploadProgress as Wt, BoardPlaybackChangedEvent as X, SkillsApi as Xt, BoardEventName as Y, UploadPublicAssetInput as Yt, BoardSubscriptionHandlers as Z, PromptsApi as Zt, WorkExtractedPageMeta as _, WorkRuntimeCheckoutStatus as _n, GenerationStreamErrorEvent as _t, WorkCommerceCreditConsumeResponse as a, HttpTraceContext as an, SpaceEventName as at, WorkPresentationMeta as b, WorkRuntimeRequestOptions as bn, GenerationStreamIntermediateMessage as bt, WorkCommerceEntitlementsResponse as c, UnauthorizedContext as cn, SpacesApi as ct, WorkCommercePurchaseResponse as d, sanitizeAccessToken as dn, BuildSpacePathInput as dt, CronJobsApi as en, BoardTransactionInput as et, WorkAuthorizeResponse as f, ParentBridgeTransport as fn, PublicInviteApi as ft, WorkDetailResponse as g, WorkRuntimeCheckoutState as gn, GenerationStreamCommitEvent as gt, WorkCreateInput as h, WorkRuntimeApi as hn, AssistantMessageCommit as ht, WorkCommerceCheckoutStatus as i, HttpError as in, SpaceClient as it, WorkSessionResponse as j, PublicFileUrlResponse as jn, SessionPatchApplyResult as jt, WorkRecord as k, PublicFileUploadEntryInput as kn, parseAssistantMessageCommit as kt, WorkCommerceOrder as l, joinApiUrl as ln, WebSocketConnectionState as lt, WorkContentDownload as m, WorkIdResolver as mn, buildSpacePath as mt, createHttpClient as n, CohubClientOptions as nn, SessionSubscriptionHandlers as nt, WorkCommerceCreditConsumeStatus as o, HttpTransport as on, SpacePublicFilesApi as ot, WorkContent as p, PopupBrokerTransport as pn, buildSpaceInvitePath as pt, BoardAwarenessUpdatedEvent as q, UploadChatAttachmentInput as qt, WorkCommerceApi as r, Fetch as rn, SpaceChannelBindingRecord as rt, WorkCommerceEntitlement as s, RawHttpResponse as sn, SpaceTurnListOptions as st, CohubHttpClient as t, ChannelsApi as tn, SessionEventName as tt, WorkCommerceProductResolveResponse as u, matchesUnauthorizedErrorToken as un, BuildSpaceInvitePathInput as ut, WorkGetResponse as v, WorkRuntimeContext as vn, GenerationStreamEvent as vt, WorkPromotionProviderStatus as w, resolveWorkTransport as wn, GenerationStreamSubscribeOptions as wt, WorkPromotionCreateInput as x, WorkRuntimeTransport as xn, GenerationStreamLifecycleEvent as xt, WorkMeta as y, WorkRuntimeModeConfig as yn, GenerationStreamFinalizedEvent as yt, WorksApi as z, ModelStatusEntry as zn, SearchApi as zt };