@neta-art/cohub 5.7.0 → 5.8.0

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,45 @@ 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 src/work-runtime.d.ts
 type WorkRuntimeContext = {
   work: {
@@ -293,7 +332,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 +1000,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. */
@@ -1600,6 +1665,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 +1810,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>;
 }
@@ -2098,4 +2164,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 { SpaceEventName as $, HttpTraceContext as $t, WorkViewSource as A, GenerationUsageBilling as An, SessionAccessApi as At, TasksApi as B, PublicAssetsApi as Bt, WorkRecord as C, PublicFileUploadEntryInput as Cn, parseAssistantMessageCommit as Ct, WorkTargetType as D, CreateGenerationTaskRequest as Dn, SessionPatchState as Dt, WorkStatus as E, SpaceStartupResponse as En, SessionPatchReducer as Et, UsersApi as F, CreatePublicAssetUploadResponse as Ft, BoardSubscriptionHandlers as G, PromptsApi as Gt, BoardClient as H, UploadChatImageAttachmentInput as Ht, UserApi as I, PublicAssetMimeType as It, BoardTransactionInput as J, CronJobsApi as Jt, BoardTransactionAppliedEvent as K, ModelsApi as Kt, CreateUiCommandInput as L, PublicAssetPurpose as Lt, WorkVisibility as M, PublicGenerationDeclaration as Mn, ReferencesApi as Mt, WorksApi as N, ModelStatusEntry as Nn, SearchApi as Nt, WorkUpdateInput as O, CreateGenerationTaskResponse as On, SessionPatchStatus as Ot, ReferralsApi as P, ModelStatusResponse as Pn, CreatePublicAssetUploadInput as Pt, SpaceClient as Q, HttpError as Qt, UiCommandsApi as R, PublicAssetUploadProgress as Rt, WorkPublicSpaceRecord as S, PublicFileListResponse as Sn, createSessionGenerationStreamClient as St, WorkSessionResponse as T, PublicFileUrlResponse as Tn, SessionPatchApplyResult as Tt, BoardEventName as U, UploadPublicAssetInput as Ut, BoardAwarenessUpdatedEvent as V, UploadChatAttachmentInput as Vt, BoardPlaybackChangedEvent as W, SkillsApi as Wt, SessionSubscriptionHandlers as X, CohubClientOptions as Xt, SessionEventName as Y, ChannelsApi as Yt, SpaceChannelBindingRecord as Z, Fetch as Zt, WorkExtractedPageMeta as _, createWorkRuntime as _n, GenerationStreamStateEvent as _t, WorkCommerceCreditConsumeResponse as a, sanitizeAccessToken as an, BuildSpacePathInput as at, WorkPresentationMeta as b, PublicFileCreateUploadResponse as bn, GenerationStreamTurnUpdatedEvent as bt, WorkCommerceEntitlementsResponse as c, WorkIdResolver as cn, buildSpacePath as ct, WorkCommercePurchaseResponse as d, WorkRuntimeCheckoutStatus as dn, GenerationStreamErrorEvent as dt, HttpTransport as en, SpacePublicFilesApi as et, WorkAuthorizeResponse as f, WorkRuntimeContext as fn, GenerationStreamEvent as ft, WorkDetailResponse as g, createSlugWorkIdResolver as gn, GenerationStreamOutOfSyncEvent as gt, WorkCreateInput as h, WorkRuntimeTransport as hn, GenerationStreamLifecycleEvent as ht, WorkCommerceCheckoutStatus as i, matchesUnauthorizedErrorToken as in, BuildSpaceInvitePathInput as it, WorkViewStatsResponse as j, ListGenerationModelsResponse as jn, ReferenceResourceSelector as jt, WorkVersionRecord as k, GenerationTaskResult as kn, createSessionPatchReducer as kt, WorkCommerceOrder as l, WorkRuntimeApi as ln, AssistantMessageCommit as lt, WorkContentDownload as m, WorkRuntimeRequestOptions as mn, GenerationStreamIntermediateMessage as mt, createHttpClient as n, UnauthorizedContext as nn, SpacesApi as nt, WorkCommerceCreditConsumeStatus as o, ParentBridgeTransport as on, PublicInviteApi as ot, WorkContent as p, WorkRuntimeModeConfig as pn, GenerationStreamFinalizedEvent as pt, BoardTransactionError as q, GenerationsApi as qt, WorkCommerceApi as r, joinApiUrl as rn, WebSocketConnectionState as rt, WorkCommerceEntitlement as s, PopupBrokerTransport as sn, buildSpaceInvitePath as st, CohubHttpClient as t, RawHttpResponse as tn, SpaceTurnListOptions as tt, WorkCommerceProductResolveResponse as u, WorkRuntimeCheckoutState as un, GenerationStreamCommitEvent as ut, WorkGetResponse as v, resolveWorkTransport as vn, GenerationStreamSubscribeOptions as vt, WorkResolveResponse as w, PublicFileUploadPlanEntry as wn, SessionPatchApplyInput as wt, WorkPublicOwnerRecord as x, PublicFileListEntry as xn, SessionGenerationStreamClient as xt, WorkMeta as y, PublicFileCreateUploadInput as yn, GenerationStreamSubscriptionHandlers as yt, WaitForUiCommandOptions as z, PublicAssetUploadProtocol as zt };