@neta-art/cohub 5.7.0 → 5.8.1

package/dist/index.js

@@ -1,9 +1,249 @@
-import { A as parseAssistantMessageCommit, B as ReferencesApi, C as SpaceClient, D as buildSpacePath, E as buildSpaceInvitePath, F as BOARD_ARROW_STROKE_SIZE, G as ModelsApi, H as PublicAssetsApi, I as BOARD_BUILTIN_CAPABILITIES, J as ChannelsApi, K as GenerationsApi, L as BOARD_CONNECTION_STROKE_SIZE, M as createSessionPatchReducer, N as ensureRealtimeConnected, O as SessionGenerationStreamClient, P as BoardConnectionSchema, R as DEFAULT_BOARD_RENDER_LIMITS, S as BoardTransactionError, T as PublicInviteApi, U as SkillsApi, V as SearchApi, W as PromptsApi, _ as isUiSurfaceMethod, a as ReferralsApi, b as TasksApi, c as UiCommandsApi, d as UI_COMMAND_PAYLOAD_MAX_BYTES, f as UI_COMMAND_PENDING_TTL_SECONDS, g as isTerminalUiCommandStatus, h as UI_COMMAND_VERSION, i as WorksApi, j as SessionPatchReducer, k as createSessionGenerationStreamClient, l as UI_COMMAND_DEFAULT_TIMEOUT_MS, m as UI_COMMAND_TERMINAL_TTL_SECONDS, n as createHttpClient, o as UsersApi, p as UI_COMMAND_SETTLEMENT_GRACE_SECONDS, q as CronJobsApi, r as WorkCommerceApi, s as UserApi, t as CohubHttpClient, u as UI_COMMAND_MAX_TIMEOUT_MS, v as parseUiCommand, w as SpacesApi, x as BoardClient, y as parseUiCommandId, z as SessionAccessApi } from "./chunks/http.js";
-import { _ as requestSourceToHeaders, a as sanitizeAccessToken, b as REALTIME_ROOM_EVENT_NAME_PATTERN, c as REQUEST_SOURCE_VIA_MAX_LENGTH, d as isRequestSourceEmpty, f as isRequestSourceUuid, g as readRequestSourceFromEnv, h as parseRequestSourceFromHeaders, i as matchesUnauthorizedErrorToken, l as hasRequestSourceIdentity, m as normalizeRequestSource, n as HttpTransport, o as COHUB_SOURCE_HEADER, p as mergeRequestSourceIntoMeta, r as joinApiUrl, s as COHUB_SOURCE_HEADER_NAMES, t as HttpError, u as isRequestSourceClientId, v as resolveRequestSourceChannel, y as REALTIME_DOMAINS } from "./chunks/transport.js";
+import { $ as parseUsername, A as WORK_SURFACE_READY_TIMEOUT_MS, B as parseWorkSurfaceRequest, C as BoardInputError, D as WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES, E as validateBoardNodes, F as buildWorkSurfaceRequest, G as UI_COMMAND_PENDING_TTL_SECONDS, H as UI_COMMAND_DEFAULT_TIMEOUT_MS, I as buildWorkSurfaceResponse, J as UI_COMMAND_VERSION, K as UI_COMMAND_SETTLEMENT_GRACE_SECONDS, L as parseWorkComposerChipClear, M as buildWorkComposerChipClear, N as buildWorkComposerChipSet, O as WORK_COMPOSER_CHIP_KEY_MAX_LENGTH, P as buildWorkSurfaceReady, Q as parseSpaceSlug, R as parseWorkComposerChipSet, S as createSessionPatchReducer, T as createBoardNode, U as UI_COMMAND_MAX_TIMEOUT_MS, V as parseWorkSurfaceResponse, W as UI_COMMAND_PAYLOAD_MAX_BYTES, X as isUiSurfaceMethod, Y as isTerminalUiCommandStatus, Z as parseUiCommand, _ as buildSpacePath, _t as ModelsApi, a as ReferralsApi, at as validateBoardNodeInput, b as parseAssistantMessageCommit, bt as ChannelsApi, c as UiCommandsApi, ct as ensureRealtimeConnected, d as BoardTransactionError, dt as SessionAccessApi, et as BoardAwarenessClientPayloadSchema, f as SpaceClient, ft as ReferencesApi, g as buildSpaceInvitePath, gt as PromptsApi, h as PublicInviteApi, ht as SkillsApi, i as WorksApi, it as BOARD_NODE_CONTRACT, j as WORK_SURFACE_REQUEST_TIMEOUT_MS, k as WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH, l as TasksApi, lt as BOARD_BUILTIN_CAPABILITIES, m as SpacesApi, mt as PublicAssetsApi, n as createHttpClient, nt as BOARD_GEO_KINDS, o as UsersApi, ot as BoardPlaybackPolicySchema, p as SpacePublicFilesApi, pt as SearchApi, q as UI_COMMAND_TERMINAL_TTL_SECONDS, r as WorkCommerceApi, rt as BOARD_NATIVE_NODE_TYPES, s as UserApi, st as parseBoardPlaybackPolicy, t as CohubHttpClient, tt as BOARD_COLOR_IDS, u as BoardClient, ut as DEFAULT_BOARD_RENDER_LIMITS, v as SessionGenerationStreamClient, vt as GenerationsApi, w as assertBoardNodes, x as SessionPatchReducer, y as createSessionGenerationStreamClient, yt as CronJobsApi, z as parseWorkSurfaceReady } from "./chunks/http.js";
+import { _ as requestSourceToHeaders, a as sanitizeAccessToken, b as REALTIME_DOMAINS, c as REQUEST_SOURCE_VIA_MAX_LENGTH, d as isRequestSourceEmpty, f as isRequestSourceUuid, g as readRequestSourceFromEnv, h as parseRequestSourceFromHeaders, i as matchesUnauthorizedErrorToken, l as hasRequestSourceIdentity, m as normalizeRequestSource, n as HttpTransport, o as COHUB_SOURCE_HEADER, p as mergeRequestSourceIntoMeta, r as joinApiUrl, s as COHUB_SOURCE_HEADER_NAMES, t as HttpError, u as isRequestSourceClientId, v as resolveRequestSourceChannel, x as REALTIME_ROOM_EVENT_NAME_PATTERN, y as isUuid } from "./chunks/transport.js";
 import { a as resolveApiBaseUrl, c as resolveWebsocketUrl, i as normalizeWebsocketUrl, n as normalizeBaseUrl, o as resolveCohubEnvironment, r as normalizeVoiceInputWebsocketUrl, s as resolveVoiceInputWebsocketUrl, t as COHUB_ENVIRONMENTS } from "./chunks/environment.js";
 import { a as extractBillingPayload, c as isFeatureNotEntitledError, i as FEATURE_NOT_ENTITLED_ERROR_CODE, l as isHttpErrorCode, n as createWebsocketClient, o as isBillingAccessBlockedCode, r as BILLING_ACCESS_BLOCKED_ERROR_CODE, s as isBillingAccessBlockedError, t as WebsocketClient } from "./chunks/websocket.js";
 import { VoiceApi, VoiceInputClient, createVoiceInputClient } from "./voice-input.js";
 import { z } from "zod";
+//#region ../protocol/dist/generation/catalog.js
+function isGenerationModelHidden(model) {
+	return model.hidden === true;
+}
+function filterDiscoverableGenerationModels(models, options = {}) {
+	const includeModelIds = new Set(options.includeModelIds);
+	return models.filter((model) => !isGenerationModelHidden(model) || includeModelIds.has(model.model));
+}
+//#endregion
+//#region ../protocol/dist/generation/policy.js
+const GENERATION_POLICY_ENV_KEY = "COHUB_GENERATION_POLICY_B64";
+var GenerationPolicyError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "GenerationPolicyError";
+	}
+};
+function isRecord(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isPrimitiveEnumValue(value) {
+	return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
+}
+function normalizeConstraint(value) {
+	if (!isRecord(value) || typeof value.kind !== "string") return null;
+	if (value.kind === "enum") {
+		if (!Array.isArray(value.values) || value.values.length === 0 || !value.values.every(isPrimitiveEnumValue)) return null;
+		return {
+			kind: "enum",
+			values: value.values
+		};
+	}
+	if (value.kind === "number" || value.kind === "integer") {
+		const result = { kind: value.kind };
+		if (typeof value.min === "number" && Number.isFinite(value.min)) result.min = value.min;
+		if (typeof value.max === "number" && Number.isFinite(value.max)) result.max = value.max;
+		if (result.min !== void 0 && result.max !== void 0 && result.min > result.max) return null;
+		if (Array.isArray(value.values) && value.values.every((item) => typeof item === "number" && Number.isFinite(item))) {
+			if (value.kind === "integer" && !value.values.every(Number.isInteger)) return null;
+			const min = result.min;
+			const max = result.max;
+			if (min !== void 0 && value.values.some((item) => item < min)) return null;
+			if (max !== void 0 && value.values.some((item) => item > max)) return null;
+			result.values = value.values;
+		}
+		return result;
+	}
+	if (value.kind === "boolean") return typeof value.value === "boolean" ? {
+		kind: "boolean",
+		value: value.value
+	} : { kind: "boolean" };
+	return null;
+}
+function normalizeGenerationPolicy(value) {
+	if (!isRecord(value) || value.version !== 1) return null;
+	if (value.mode === "auto") return {
+		version: 1,
+		mode: "auto"
+	};
+	if (value.mode !== "limited" || !Array.isArray(value.models) || value.models.length === 0) return null;
+	const models = [];
+	for (const item of value.models) {
+		if (!isRecord(item) || typeof item.model !== "string" || !item.model.trim()) return null;
+		const modelPolicy = { model: item.model.trim() };
+		if (item.parameters !== void 0) {
+			if (!isRecord(item.parameters)) return null;
+			const parameters = {};
+			for (const [key, rawConstraint] of Object.entries(item.parameters)) {
+				if (!key.trim()) return null;
+				const constraint = normalizeConstraint(rawConstraint);
+				if (!constraint) return null;
+				parameters[key] = constraint;
+			}
+			if (Object.keys(parameters).length > 0) modelPolicy.parameters = parameters;
+		}
+		models.push(modelPolicy);
+	}
+	return {
+		version: 1,
+		mode: "limited",
+		models
+	};
+}
+function bytesToBase64(bytes) {
+	let binary = "";
+	for (const byte of bytes) binary += String.fromCharCode(byte);
+	return btoa(binary);
+}
+function base64ToBytes(value) {
+	const binary = atob(value);
+	const bytes = new Uint8Array(binary.length);
+	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
+	return bytes;
+}
+function toBase64Url(value) {
+	return bytesToBase64(new TextEncoder().encode(value)).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
+}
+function fromBase64Url(value) {
+	const base64 = value.replaceAll("-", "+").replaceAll("_", "/");
+	const padded = base64.padEnd(base64.length + (4 - base64.length % 4) % 4, "=");
+	return new TextDecoder().decode(base64ToBytes(padded));
+}
+function encodeGenerationPolicy(policy) {
+	return toBase64Url(JSON.stringify(policy));
+}
+function decodeGenerationPolicy(value) {
+	try {
+		return normalizeGenerationPolicy(JSON.parse(fromBase64Url(value)));
+	} catch {
+		return null;
+	}
+}
+function parseGenerationPolicyFromEnv(env) {
+	const value = env[GENERATION_POLICY_ENV_KEY]?.trim();
+	return value ? decodeGenerationPolicy(value) : null;
+}
+function getAllowedGenerationModelIds(policy) {
+	if (!policy || policy.mode === "auto") return null;
+	return [...new Set((policy.models ?? []).map((item) => item.model))];
+}
+function findGenerationModelPolicy(policy, model) {
+	if (!policy || policy.mode === "auto") return null;
+	return policy.models?.find((item) => item.model === model) ?? null;
+}
+function formatList(values) {
+	return values.map((value) => `- ${String(value)}`).join("\n");
+}
+function modelNotSupportedMessage(allowedModels) {
+	return [
+		"This turn supports the following generation models:",
+		"",
+		formatList(allowedModels),
+		"",
+		"Choose one of these models or update Generation settings in the Models panel."
+	].join("\n");
+}
+function valuesNotSupportedMessage(model, name, values, received) {
+	return [
+		`This turn supports selected values for ${model}.${name}:`,
+		"",
+		formatList(values),
+		"",
+		"Received:",
+		`- ${String(received)}`
+	].join("\n");
+}
+function rangeNotSupportedMessage(model, name, min, max, received) {
+	return [
+		`This turn supports ${model}.${name} in the range ${min !== void 0 && max !== void 0 ? `${min}–${max}` : min !== void 0 ? `at least ${min}` : `at most ${max}`}.`,
+		"",
+		"Received:",
+		`- ${String(received)}`
+	].join("\n");
+}
+function booleanNotSupportedMessage(model, name, expected, received) {
+	return [
+		`This turn supports ${model}.${name}=${String(expected)}.`,
+		"",
+		"Received:",
+		`- ${String(received)}`
+	].join("\n");
+}
+function sameEnumValue(a, b) {
+	return typeof a === typeof b && a === b;
+}
+function validateConstraint(input) {
+	const { model, name, value, constraint } = input;
+	if (constraint.kind === "enum") {
+		if (!constraint.values.some((item) => sameEnumValue(item, value))) throw new GenerationPolicyError(valuesNotSupportedMessage(model, name, constraint.values, value));
+		return;
+	}
+	if (constraint.kind === "number" || constraint.kind === "integer") {
+		if (typeof value !== "number" || !Number.isFinite(value)) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
+		if (constraint.kind === "integer" && !Number.isInteger(value)) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
+		if (constraint.values?.length && !constraint.values.includes(value)) throw new GenerationPolicyError(valuesNotSupportedMessage(model, name, constraint.values, value));
+		if (constraint.min !== void 0 && value < constraint.min) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
+		if (constraint.max !== void 0 && value > constraint.max) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
+		return;
+	}
+	if (constraint.kind === "boolean" && constraint.value !== void 0 && value !== constraint.value) throw new GenerationPolicyError(booleanNotSupportedMessage(model, name, constraint.value, value));
+}
+function assertGenerationRequestAllowedByPolicy(input) {
+	const allowedModels = getAllowedGenerationModelIds(input.policy);
+	if (!allowedModels) return;
+	const modelPolicy = findGenerationModelPolicy(input.policy, input.model);
+	if (!modelPolicy) throw new GenerationPolicyError(modelNotSupportedMessage(allowedModels));
+	const parameters = input.parameters ?? {};
+	for (const [name, value] of Object.entries(parameters)) {
+		const constraint = modelPolicy.parameters?.[name];
+		if (!constraint) continue;
+		validateConstraint({
+			model: input.model,
+			name,
+			value,
+			constraint
+		});
+	}
+}
+function cloneDeclaration(declaration) {
+	return {
+		...declaration,
+		content: {
+			...declaration.content,
+			input: [...declaration.content.input]
+		},
+		parameters: declaration.parameters ? Object.fromEntries(Object.entries(declaration.parameters).map(([key, value]) => [key, { ...value }])) : declaration.parameters,
+		examples: declaration.examples ? [...declaration.examples] : declaration.examples
+	};
+}
+function narrowParameterSpec(spec, constraint) {
+	const next = { ...spec };
+	if (constraint.kind === "enum") {
+		if ("enum" in next && Array.isArray(next.enum)) next.enum = next.enum.filter((value) => constraint.values.some((allowed) => sameEnumValue(allowed, value)));
+		return next;
+	}
+	if (constraint.kind === "number" || constraint.kind === "integer") {
+		if ("min" in next && typeof next.min === "number" && constraint.min !== void 0) next.min = Math.max(next.min, constraint.min);
+		else if ("min" in next && constraint.min !== void 0) next.min = constraint.min;
+		if ("max" in next && typeof next.max === "number" && constraint.max !== void 0) next.max = Math.min(next.max, constraint.max);
+		else if ("max" in next && constraint.max !== void 0) next.max = constraint.max;
+		if (constraint.values?.length && "enum" in next && Array.isArray(next.enum)) next.enum = next.enum.filter((value) => constraint.values?.some((allowed) => sameEnumValue(allowed, value)));
+	}
+	return next;
+}
+function filterGenerationDeclarationsByPolicy(declarations, policy) {
+	const allowedModels = getAllowedGenerationModelIds(policy);
+	if (!allowedModels) return declarations;
+	const allowedSet = new Set(allowedModels);
+	return declarations.filter((declaration) => allowedSet.has(declaration.model)).map((declaration) => {
+		const cloned = cloneDeclaration(declaration);
+		const modelPolicy = findGenerationModelPolicy(policy, declaration.model);
+		if (!modelPolicy?.parameters || !cloned.parameters) return cloned;
+		for (const [name, constraint] of Object.entries(modelPolicy.parameters)) {
+			const spec = cloned.parameters[name];
+			if (spec) cloned.parameters[name] = narrowParameterSpec(spec, constraint);
+		}
+		return cloned;
+	});
+}
+//#endregion
 //#region src/apis/billing.ts
 var BillingApi = class {
 	transport;
@@ -35,6 +275,12 @@ var BillingApi = class {
 		const query = params.toString();
 		return this.transport.request(`/api/billing/subscriptions${query ? `?${query}` : ""}`);
 	}
+	async previewPromotionCode(input) {
+		return this.transport.request("/api/billing/promotion-code-preview", {
+			method: "POST",
+			body: JSON.stringify(input)
+		});
+	}
 	async createOrder(productKey, input) {
 		return this.transport.request("/api/billing/orders", {
 			method: "POST",
@@ -70,130 +316,14 @@ var BillingApi = class {
 	}
 };
 //#endregion
-//#region ../protocol/dist/realtime/board-awareness.js
-const idSchema$1 = z.string().min(1).max(160);
-const finiteSchema$1 = z.number().finite();
-const BoardAwarenessPointSchema = z.object({
-	x: finiteSchema$1,
-	y: finiteSchema$1
-});
-const BoardAwarenessDrawPointSchema = BoardAwarenessPointSchema.extend({ p: finiteSchema$1.min(0).max(1) });
-const BoardAwarenessFrameSchema = z.object({
-	x: finiteSchema$1,
-	y: finiteSchema$1,
-	width: finiteSchema$1.positive(),
-	height: finiteSchema$1.positive(),
-	rotation: finiteSchema$1
-});
-const BoardAwarenessNodePreviewSchema = z.object({
-	nodeId: idSchema$1,
-	frame: BoardAwarenessFrameSchema,
-	/** Live endpoints of a free arrow being dragged. */
-	arrow: z.object({
-		start: BoardAwarenessPointSchema,
-		end: BoardAwarenessPointSchema,
-		bend: finiteSchema$1
-	}).optional()
-});
-const BoardAwarenessStateUpdateSchema = z.object({
-	type: z.literal("state"),
-	client: z.object({ formFactor: z.enum(["desktop", "mobile"]) }).optional(),
-	cursor: BoardAwarenessPointSchema.extend({ pointerType: z.enum([
-		"mouse",
-		"pen",
-		"touch"
-	]) }).nullable(),
-	tool: z.string().min(1).max(40),
-	selection: z.object({
-		ids: z.array(idSchema$1).max(64),
-		count: z.number().int().nonnegative().max(5e4),
-		bounds: BoardAwarenessFrameSchema.nullable()
-	}),
-	editingId: idSchema$1.nullable()
-});
-const BoardAwarenessGestureSchema = z.discriminatedUnion("kind", [
+//#region ../protocol/dist/realtime/schema.js
+const contentBlockMetaSchema = z.record(z.string(), z.unknown());
+const realtimeRoomSchema = z.string().regex(/^(space|user|board|room):[^:]+$/);
+const contentBlockSchema = z.discriminatedUnion("type", [
 	z.object({
-		kind: z.literal("draw"),
-		id: idSchema$1,
-		nodeId: idSchema$1,
-		color: z.string().min(1).max(64),
-		size: finiteSchema$1.positive().max(256),
-		from: z.number().int().nonnegative().max(1e5),
-		points: z.array(BoardAwarenessDrawPointSchema).min(1).max(64)
-	}),
-	z.object({
-		kind: z.literal("arrow"),
-		id: idSchema$1,
-		nodeId: idSchema$1,
-		start: BoardAwarenessPointSchema,
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		size: finiteSchema$1.positive().max(256).default(BOARD_ARROW_STROKE_SIZE)
-	}),
-	z.object({
-		kind: z.literal("box"),
-		id: idSchema$1,
-		nodeId: idSchema$1,
-		shape: z.enum(["geo", "frame"]),
-		start: BoardAwarenessPointSchema,
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		geo: z.string().min(1).max(40)
-	}),
-	z.object({
-		kind: z.literal("connection"),
-		id: idSchema$1,
-		sourceNodeId: idSchema$1,
-		targetNodeId: idSchema$1.nullable(),
-		current: BoardAwarenessPointSchema,
-		color: z.string().min(1).max(64),
-		size: finiteSchema$1.positive().max(256).default(BOARD_CONNECTION_STROKE_SIZE)
-	}),
-	z.object({
-		kind: z.literal("transform"),
-		id: idSchema$1,
-		mode: z.enum([
-			"translate",
-			"resize",
-			"rotate",
-			"arrow",
-			"connection"
-		]),
-		nodes: z.array(BoardAwarenessNodePreviewSchema).max(64),
-		bounds: BoardAwarenessFrameSchema.nullable()
-	})
-]);
-const BoardAwarenessUpdateSchema = z.discriminatedUnion("type", [
-	BoardAwarenessStateUpdateSchema,
-	z.object({
-		type: z.literal("gesture"),
-		gesture: BoardAwarenessGestureSchema
-	}),
-	z.object({
-		type: z.literal("gesture.end"),
-		gestureId: idSchema$1,
-		resultingNodeIds: z.array(idSchema$1).max(64)
-	}),
-	z.object({
-		type: z.literal("gesture.cancel"),
-		gestureId: idSchema$1
-	})
-]);
-const BoardAwarenessClientPayloadSchema = z.object({
-	spaceId: z.string().uuid(),
-	boardId: z.string().uuid(),
-	seq: z.number().int().nonnegative(),
-	update: BoardAwarenessUpdateSchema
-});
-//#endregion
-//#region ../protocol/dist/realtime/schema.js
-const contentBlockMetaSchema = z.record(z.string(), z.unknown());
-const realtimeRoomSchema = z.string().regex(/^(space|user|board|room):[^:]+$/);
-const contentBlockSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("text"),
-		text: z.string(),
-		_meta: contentBlockMetaSchema.optional()
+		type: z.literal("text"),
+		text: z.string(),
+		_meta: contentBlockMetaSchema.optional()
 	}),
 	z.object({
 		type: z.literal("thinking"),
@@ -796,130 +926,16 @@ var WorkRealtimeApi = class {
 	}
 };
 //#endregion
-//#region ../protocol/dist/work-surface.js
-const WORK_SURFACE_PROTOCOL = "cohub.surface";
-const WORK_SURFACE_READY_TIMEOUT_MS = 1e4;
-const WORK_SURFACE_REQUEST_TIMEOUT_MS = 15e3;
-const WORK_COMPOSER_CHIP_KEY_MAX_LENGTH = 80;
-const WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH = 120;
-const WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES = 32 * 1024;
-const isRecord$1 = (value) => Boolean(value && typeof value === "object" && !Array.isArray(value));
-const isSurfaceEnvelope = (value) => isRecord$1(value) && value.protocol === "cohub.surface" && value.version === 1;
-const parseWorkSurfaceReady = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "ready") return null;
-	const methods = Array.isArray(value.methods) ? value.methods.filter((method) => typeof method === "string" && Boolean(method)) : [];
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "ready",
-		methods
-	};
-};
-const parseWorkSurfaceResponse = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "response") return null;
-	if (typeof value.requestId !== "string" || !value.requestId) return null;
-	const error = isRecord$1(value.error) ? {
-		code: typeof value.error.code === "string" && value.error.code ? value.error.code : "surface_error",
-		message: typeof value.error.message === "string" ? value.error.message : "Work surface call failed"
-	} : void 0;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "response",
-		requestId: value.requestId,
-		ok: value.ok === true,
-		...error ? { error } : {}
-	};
-};
-const parseComposerChipKey = (value) => {
-	if (typeof value !== "string") return null;
-	const key = value.trim();
-	if (!key || key.length > 80) return null;
-	return key;
-};
-const parseWorkComposerChipSet = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "composer.chip.set" || !isRecord$1(value.chip)) return null;
-	const key = parseComposerChipKey(value.chip.key);
-	if (!key || typeof value.chip.label !== "string" || typeof value.chip.content !== "string") return null;
-	const label = value.chip.label.trim();
-	if (!label || label.length > 120) return null;
-	if (!value.chip.content.trim()) return null;
-	if (new TextEncoder().encode(value.chip.content).length > 32768) return null;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "composer.chip.set",
-		chip: {
-			key,
-			label,
-			content: value.chip.content
-		}
-	};
-};
-const parseWorkComposerChipClear = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "composer.chip.clear") return null;
-	const key = parseComposerChipKey(value.key);
-	return key ? {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "composer.chip.clear",
-		key
-	} : null;
-};
-const parseWorkSurfaceRequest = (value) => {
-	if (!isSurfaceEnvelope(value) || value.type !== "request") return null;
-	if (typeof value.requestId !== "string" || !value.requestId) return null;
-	if (typeof value.method !== "string" || !value.method) return null;
-	const commandId = parseUiCommandId(value.commandId);
-	if (!commandId) return null;
-	return {
-		protocol: WORK_SURFACE_PROTOCOL,
-		version: 1,
-		type: "request",
-		requestId: value.requestId,
-		method: value.method,
-		...value.input === void 0 ? {} : { input: value.input },
-		commandId
-	};
-};
-const buildWorkSurfaceReady = (methods) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "ready",
-	methods: [...methods]
-});
-const buildWorkSurfaceRequest = (input) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "request",
-	...input
-});
-const buildWorkSurfaceResponse = (input) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "response",
-	...input
-});
-const buildWorkComposerChipSet = (chip) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "composer.chip.set",
-	chip
-});
-const buildWorkComposerChipClear = (key) => ({
-	protocol: WORK_SURFACE_PROTOCOL,
-	version: 1,
-	type: "composer.chip.clear",
-	key
-});
-//#endregion
 //#region src/work-surface.ts
 /**
-* Explicit app origins, not a `*.cohub.run` suffix match: Works themselves are
+* Explicit app origins, not a Cohub suffix match: Works themselves are
 * served from Cohub subdomains, so a suffix match would let one Work call into
 * another and turn a subdomain takeover into surface access.
 */
 const COHUB_APP_ORIGINS = [
+	"https://cohub.live",
+	"https://www.cohub.live",
+	"https://dev.cohub.live",
 	"https://cohub.run",
 	"https://www.cohub.run",
 	"https://dev.cohub.run"
@@ -1607,66 +1623,8 @@ var CohubClient = class {
 };
 const createCohubClient = (options) => new CohubClient(options);
 //#endregion
-//#region ../protocol/dist/public-identifiers.js
-const USERNAME_PATTERN = /^(?!-)(?!.*--)[a-z0-9-]{1,39}(?<!-)$/;
-const SPACE_SLUG_PATTERN = /^[a-z0-9](?:[a-z0-9_-]{0,78}[a-z0-9])?$/;
-/**
-* Platform-owned path segments that must not be newly assigned to public
-* identities. Existing stored values remain readable through parse helpers.
-*/
-const RESERVED_PLATFORM_PATH_SEGMENTS = Object.freeze([
-	"admin",
-	"api",
-	"assets",
-	"auth",
-	"callback",
-	"changelog",
-	"docs",
-	"explore",
-	"invite",
-	"landing",
-	"login",
-	"logout",
-	"new",
-	"org",
-	"pricing",
-	"pwa",
-	"referrals",
-	"sessions",
-	"settings",
-	"spaces",
-	"static",
-	"teams",
-	"trending",
-	"u",
-	"user",
-	"users",
-	"work-auth"
-]);
-new Set(RESERVED_PLATFORM_PATH_SEGMENTS);
-[...RESERVED_PLATFORM_PATH_SEGMENTS];
-function parseUsername(value) {
-	if (value === null || value === void 0) return null;
-	const normalized = value.trim().toLowerCase();
-	return USERNAME_PATTERN.test(normalized) ? normalized : null;
-}
-function parseSpaceSlug(value) {
-	if (value === null || value === void 0) return null;
-	const normalized = value.trim();
-	return SPACE_SLUG_PATTERN.test(normalized) ? normalized : null;
-}
-//#endregion
 //#region src/work-ref.ts
-/**
-* Accepts every way a Work is named across Cohub — id, management URL, public
-* URL, `cohub://works` URI, or `username/space/work` — and normalizes it.
-*
-* Public and mention forms may carry launch state (`?query#hash`); it is kept
-* separately so it can be forwarded to the Work while the stable identity stays
-* clean.
-*/
-const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
-const isWorkId = (value) => UUID_PATTERN.test(value.trim());
+const isWorkId = (value) => isUuid(value.trim());
 function decodePart(value) {
 	try {
 		return decodeURIComponent(value).trim();
@@ -1708,7 +1666,7 @@ function parseUrlRef(value) {
 		} : null;
 	}
 	if (url.protocol !== "http:" && url.protocol !== "https:") return null;
-	if (parts.length === 4 && parts[0] === "spaces" && UUID_PATTERN.test(parts[1] ?? "") && parts[2] === "works" && UUID_PATTERN.test(parts[3] ?? "")) return { id: parts[3] };
+	if (parts.length === 4 && parts[0] === "spaces" && isUuid(parts[1] ?? "") && parts[2] === "works" && isUuid(parts[3] ?? "")) return { id: parts[3] };
 	if (parts.length === 4 && parts[2] === "w") {
 		const ref = publicRef([
 			parts[0],
@@ -1730,7 +1688,7 @@ var WorkRefParseError = class extends Error {
 };
 function parseWorkRef(input) {
 	const value = input.trim();
-	if (UUID_PATTERN.test(value)) return { id: value };
+	if (isUuid(value)) return { id: value };
 	const parsedUrl = parseUrlRef(value.includes("://") ? value : value.startsWith("/") ? `https://cohub.invalid${value}` : value);
 	if (parsedUrl) return parsedUrl;
 	const parts = value.split("/").filter(Boolean);
@@ -1954,6 +1912,7 @@ function createWorkBridgeCore(config) {
 			await config.requestSignIn(typeof location !== "undefined" ? location.pathname + location.search + location.hash : "/");
 			return null;
 		}
+		const promotionAttribution = config.getPromotionAttribution?.() ?? null;
 		const response = await fetch(`${apiOrigin}/api/works/${work.id}/commerce/purchase`, {
 			method: "POST",
 			headers: {
@@ -1962,7 +1921,8 @@ function createWorkBridgeCore(config) {
 			},
 			body: JSON.stringify({
 				productKey,
-				purchaseAttemptId
+				purchaseAttemptId,
+				...promotionAttribution ? { promotionAttribution } : {}
 			})
 		});
 		if (!response.ok) throw new Error((await response.json().catch(() => null))?.message ?? "Purchase failed.");
@@ -2034,6 +1994,7 @@ function createWorkBridgeCore(config) {
 				state.purchaseError = null;
 				state.purchaseOpen = true;
 				notify();
+				config.onPurchaseRequested?.({ ...state.pendingPurchase });
 			}
 			if (data.type === "cohub.work.authorize") {
 				const allowedViewerScopes = clonePermissionScopes(work.allowedViewerScopes);
@@ -2124,7 +2085,14 @@ function createWorkBridgeCore(config) {
 					productKey: next.productKey
 				});
 				const url = next.checkoutUrl;
-				if (next.checkoutUsable === true && typeof url === "string" && url) window.location.href = url;
+				if (next.checkoutUsable === true && typeof url === "string" && url) {
+					config.onCheckoutStarted?.({
+						...state.pendingPurchase,
+						...typeof next.value === "number" ? { value: next.value } : {},
+						...typeof next.currency === "string" ? { currency: next.currency } : {}
+					});
+					window.location.href = url;
+				}
 			}
 			state.purchaseOpen = false;
 			state.pendingPurchase = null;
@@ -2166,440 +2134,6 @@ function createWorkBridgeCore(config) {
 	};
 }
 //#endregion
-//#region ../protocol/dist/generation/catalog.js
-function isGenerationModelHidden(model) {
-	return model.hidden === true;
-}
-function filterDiscoverableGenerationModels(models, options = {}) {
-	const includeModelIds = new Set(options.includeModelIds);
-	return models.filter((model) => !isGenerationModelHidden(model) || includeModelIds.has(model.model));
-}
-//#endregion
-//#region ../protocol/dist/generation/policy.js
-const GENERATION_POLICY_ENV_KEY = "COHUB_GENERATION_POLICY_B64";
-var GenerationPolicyError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "GenerationPolicyError";
-	}
-};
-function isRecord(value) {
-	return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function isPrimitiveEnumValue(value) {
-	return typeof value === "string" || typeof value === "number" || typeof value === "boolean";
-}
-function normalizeConstraint(value) {
-	if (!isRecord(value) || typeof value.kind !== "string") return null;
-	if (value.kind === "enum") {
-		if (!Array.isArray(value.values) || value.values.length === 0 || !value.values.every(isPrimitiveEnumValue)) return null;
-		return {
-			kind: "enum",
-			values: value.values
-		};
-	}
-	if (value.kind === "number" || value.kind === "integer") {
-		const result = { kind: value.kind };
-		if (typeof value.min === "number" && Number.isFinite(value.min)) result.min = value.min;
-		if (typeof value.max === "number" && Number.isFinite(value.max)) result.max = value.max;
-		if (result.min !== void 0 && result.max !== void 0 && result.min > result.max) return null;
-		if (Array.isArray(value.values) && value.values.every((item) => typeof item === "number" && Number.isFinite(item))) {
-			if (value.kind === "integer" && !value.values.every(Number.isInteger)) return null;
-			const min = result.min;
-			const max = result.max;
-			if (min !== void 0 && value.values.some((item) => item < min)) return null;
-			if (max !== void 0 && value.values.some((item) => item > max)) return null;
-			result.values = value.values;
-		}
-		return result;
-	}
-	if (value.kind === "boolean") return typeof value.value === "boolean" ? {
-		kind: "boolean",
-		value: value.value
-	} : { kind: "boolean" };
-	return null;
-}
-function normalizeGenerationPolicy(value) {
-	if (!isRecord(value) || value.version !== 1) return null;
-	if (value.mode === "auto") return {
-		version: 1,
-		mode: "auto"
-	};
-	if (value.mode !== "limited" || !Array.isArray(value.models) || value.models.length === 0) return null;
-	const models = [];
-	for (const item of value.models) {
-		if (!isRecord(item) || typeof item.model !== "string" || !item.model.trim()) return null;
-		const modelPolicy = { model: item.model.trim() };
-		if (item.parameters !== void 0) {
-			if (!isRecord(item.parameters)) return null;
-			const parameters = {};
-			for (const [key, rawConstraint] of Object.entries(item.parameters)) {
-				if (!key.trim()) return null;
-				const constraint = normalizeConstraint(rawConstraint);
-				if (!constraint) return null;
-				parameters[key] = constraint;
-			}
-			if (Object.keys(parameters).length > 0) modelPolicy.parameters = parameters;
-		}
-		models.push(modelPolicy);
-	}
-	return {
-		version: 1,
-		mode: "limited",
-		models
-	};
-}
-function bytesToBase64(bytes) {
-	let binary = "";
-	for (const byte of bytes) binary += String.fromCharCode(byte);
-	return btoa(binary);
-}
-function base64ToBytes(value) {
-	const binary = atob(value);
-	const bytes = new Uint8Array(binary.length);
-	for (let i = 0; i < binary.length; i++) bytes[i] = binary.charCodeAt(i);
-	return bytes;
-}
-function toBase64Url(value) {
-	return bytesToBase64(new TextEncoder().encode(value)).replaceAll("+", "-").replaceAll("/", "_").replaceAll("=", "");
-}
-function fromBase64Url(value) {
-	const base64 = value.replaceAll("-", "+").replaceAll("_", "/");
-	const padded = base64.padEnd(base64.length + (4 - base64.length % 4) % 4, "=");
-	return new TextDecoder().decode(base64ToBytes(padded));
-}
-function encodeGenerationPolicy(policy) {
-	return toBase64Url(JSON.stringify(policy));
-}
-function decodeGenerationPolicy(value) {
-	try {
-		return normalizeGenerationPolicy(JSON.parse(fromBase64Url(value)));
-	} catch {
-		return null;
-	}
-}
-function parseGenerationPolicyFromEnv(env) {
-	const value = env[GENERATION_POLICY_ENV_KEY]?.trim();
-	return value ? decodeGenerationPolicy(value) : null;
-}
-function getAllowedGenerationModelIds(policy) {
-	if (!policy || policy.mode === "auto") return null;
-	return [...new Set((policy.models ?? []).map((item) => item.model))];
-}
-function findGenerationModelPolicy(policy, model) {
-	if (!policy || policy.mode === "auto") return null;
-	return policy.models?.find((item) => item.model === model) ?? null;
-}
-function formatList(values) {
-	return values.map((value) => `- ${String(value)}`).join("\n");
-}
-function modelNotSupportedMessage(allowedModels) {
-	return [
-		"This turn supports the following generation models:",
-		"",
-		formatList(allowedModels),
-		"",
-		"Choose one of these models or update Generation settings in the Models panel."
-	].join("\n");
-}
-function valuesNotSupportedMessage(model, name, values, received) {
-	return [
-		`This turn supports selected values for ${model}.${name}:`,
-		"",
-		formatList(values),
-		"",
-		"Received:",
-		`- ${String(received)}`
-	].join("\n");
-}
-function rangeNotSupportedMessage(model, name, min, max, received) {
-	return [
-		`This turn supports ${model}.${name} in the range ${min !== void 0 && max !== void 0 ? `${min}–${max}` : min !== void 0 ? `at least ${min}` : `at most ${max}`}.`,
-		"",
-		"Received:",
-		`- ${String(received)}`
-	].join("\n");
-}
-function booleanNotSupportedMessage(model, name, expected, received) {
-	return [
-		`This turn supports ${model}.${name}=${String(expected)}.`,
-		"",
-		"Received:",
-		`- ${String(received)}`
-	].join("\n");
-}
-function sameEnumValue(a, b) {
-	return typeof a === typeof b && a === b;
-}
-function validateConstraint(input) {
-	const { model, name, value, constraint } = input;
-	if (constraint.kind === "enum") {
-		if (!constraint.values.some((item) => sameEnumValue(item, value))) throw new GenerationPolicyError(valuesNotSupportedMessage(model, name, constraint.values, value));
-		return;
-	}
-	if (constraint.kind === "number" || constraint.kind === "integer") {
-		if (typeof value !== "number" || !Number.isFinite(value)) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
-		if (constraint.kind === "integer" && !Number.isInteger(value)) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
-		if (constraint.values?.length && !constraint.values.includes(value)) throw new GenerationPolicyError(valuesNotSupportedMessage(model, name, constraint.values, value));
-		if (constraint.min !== void 0 && value < constraint.min) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
-		if (constraint.max !== void 0 && value > constraint.max) throw new GenerationPolicyError(rangeNotSupportedMessage(model, name, constraint.min, constraint.max, value));
-		return;
-	}
-	if (constraint.kind === "boolean" && constraint.value !== void 0 && value !== constraint.value) throw new GenerationPolicyError(booleanNotSupportedMessage(model, name, constraint.value, value));
-}
-function assertGenerationRequestAllowedByPolicy(input) {
-	const allowedModels = getAllowedGenerationModelIds(input.policy);
-	if (!allowedModels) return;
-	const modelPolicy = findGenerationModelPolicy(input.policy, input.model);
-	if (!modelPolicy) throw new GenerationPolicyError(modelNotSupportedMessage(allowedModels));
-	const parameters = input.parameters ?? {};
-	for (const [name, value] of Object.entries(parameters)) {
-		const constraint = modelPolicy.parameters?.[name];
-		if (!constraint) continue;
-		validateConstraint({
-			model: input.model,
-			name,
-			value,
-			constraint
-		});
-	}
-}
-function cloneDeclaration(declaration) {
-	return {
-		...declaration,
-		content: {
-			...declaration.content,
-			input: [...declaration.content.input]
-		},
-		parameters: declaration.parameters ? Object.fromEntries(Object.entries(declaration.parameters).map(([key, value]) => [key, { ...value }])) : declaration.parameters,
-		examples: declaration.examples ? [...declaration.examples] : declaration.examples
-	};
-}
-function narrowParameterSpec(spec, constraint) {
-	const next = { ...spec };
-	if (constraint.kind === "enum") {
-		if ("enum" in next && Array.isArray(next.enum)) next.enum = next.enum.filter((value) => constraint.values.some((allowed) => sameEnumValue(allowed, value)));
-		return next;
-	}
-	if (constraint.kind === "number" || constraint.kind === "integer") {
-		if ("min" in next && typeof next.min === "number" && constraint.min !== void 0) next.min = Math.max(next.min, constraint.min);
-		else if ("min" in next && constraint.min !== void 0) next.min = constraint.min;
-		if ("max" in next && typeof next.max === "number" && constraint.max !== void 0) next.max = Math.min(next.max, constraint.max);
-		else if ("max" in next && constraint.max !== void 0) next.max = constraint.max;
-		if (constraint.values?.length && "enum" in next && Array.isArray(next.enum)) next.enum = next.enum.filter((value) => constraint.values?.some((allowed) => sameEnumValue(allowed, value)));
-	}
-	return next;
-}
-function filterGenerationDeclarationsByPolicy(declarations, policy) {
-	const allowedModels = getAllowedGenerationModelIds(policy);
-	if (!allowedModels) return declarations;
-	const allowedSet = new Set(allowedModels);
-	return declarations.filter((declaration) => allowedSet.has(declaration.model)).map((declaration) => {
-		const cloned = cloneDeclaration(declaration);
-		const modelPolicy = findGenerationModelPolicy(policy, declaration.model);
-		if (!modelPolicy?.parameters || !cloned.parameters) return cloned;
-		for (const [name, constraint] of Object.entries(modelPolicy.parameters)) {
-			const spec = cloned.parameters[name];
-			if (spec) cloned.parameters[name] = narrowParameterSpec(spec, constraint);
-		}
-		return cloned;
-	});
-}
-//#endregion
-//#region ../protocol/dist/board.js
-const BOARD_MANIFEST_KIND = "cohub.board.manifest";
-const idSchema = z.string().min(1).max(160);
-const extensionIdSchema = z.string().regex(/^[a-z][a-z0-9]*(?:[.-][a-z0-9]+)+$/).max(160);
-const jsonObjectSchema = z.record(z.string(), z.unknown());
-const finiteSchema = z.number().finite();
-z.object({
-	kind: z.literal(BOARD_MANIFEST_KIND),
-	version: z.literal(1),
-	boardId: z.string().uuid(),
-	title: z.string().min(1).max(255)
-});
-const BoardTargetSchema = z.discriminatedUnion("type", [
-	z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}),
-	z.object({
-		type: z.literal("effect"),
-		effectId: idSchema
-	}),
-	z.object({ type: z.literal("board") }),
-	z.object({ type: z.literal("camera") })
-]);
-const BoardAssetRefSchema = z.object({
-	type: z.enum(["space-file", "extension"]),
-	ref: z.string().min(1).max(4096),
-	digest: z.string().min(16).max(160).optional()
-});
-const BoardKeyframeSchema = z.object({
-	at: finiteSchema.nonnegative(),
-	value: z.unknown(),
-	easing: z.string().min(1).max(80).optional()
-});
-const BoardClipSchema = z.object({
-	id: idSchema,
-	sequenceId: idSchema,
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	target: BoardTargetSchema,
-	start: finiteSchema.nonnegative(),
-	duration: finiteSchema.positive(),
-	layer: z.enum([
-		"behind",
-		"content",
-		"front",
-		"screen"
-	]).default("content"),
-	fill: z.enum([
-		"none",
-		"backwards",
-		"forwards",
-		"both"
-	]).default("none"),
-	easing: z.string().min(1).max(80).default("linear"),
-	params: jsonObjectSchema.default({}),
-	keyframes: z.array(BoardKeyframeSchema).default([]),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	seed: z.string().min(1).max(160),
-	metadata: jsonObjectSchema.default({})
-});
-const BoardEffectSchema = z.object({
-	id: idSchema,
-	boardId: z.string().uuid(),
-	target: z.discriminatedUnion("type", [z.object({
-		type: z.literal("node"),
-		nodeId: idSchema
-	}), z.object({ type: z.literal("board") })]),
-	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
-	enabled: z.boolean().default(true),
-	lifecycle: z.enum([
-		"persistent",
-		"when-visible",
-		"manual"
-	]),
-	timeOrigin: z.enum([
-		"board",
-		"visible",
-		"activation"
-	]),
-	layer: z.enum([
-		"behind",
-		"front",
-		"screen"
-	]).default("front"),
-	seed: z.string().min(1).max(160),
-	params: jsonObjectSchema.default({}),
-	assetRefs: z.array(BoardAssetRefSchema).default([]),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardSequenceSchema = z.object({
-	id: idSchema,
-	boardId: z.string().uuid(),
-	name: z.string().min(1).max(255),
-	duration: finiteSchema.nonnegative(),
-	seed: z.string().min(1).max(160),
-	restPose: jsonObjectSchema.default({}),
-	metadata: jsonObjectSchema.default({}),
-	revision: z.number().int().nonnegative()
-});
-const BoardNodeInputSchema = z.object({
-	nodeId: idSchema,
-	type: z.string().min(1).max(40),
-	parentId: idSchema.nullable(),
-	orderKey: z.string().max(4096).nullable(),
-	x: finiteSchema,
-	y: finiteSchema,
-	width: finiteSchema.positive(),
-	height: finiteSchema.positive(),
-	rotation: finiteSchema,
-	refKind: z.string().max(40).nullable(),
-	refPath: z.string().max(4096).nullable(),
-	refUrl: z.string().max(4096).nullable(),
-	view: jsonObjectSchema,
-	style: jsonObjectSchema,
-	data: jsonObjectSchema
-});
-z.object({
-	path: z.string().min(1),
-	/** Reused by clients when board creation is interrupted and retried. */
-	mutationId: z.string().max(128).optional(),
-	title: z.string().min(1).max(255).optional(),
-	metadata: jsonObjectSchema.optional(),
-	nodes: z.array(BoardNodeInputSchema).max(5e4).optional(),
-	connections: z.array(BoardConnectionSchema).max(5e4).optional(),
-	effects: z.array(BoardEffectSchema.omit({
-		boardId: true,
-		revision: true
-	})).optional(),
-	sequences: z.array(z.object({
-		sequence: BoardSequenceSchema.omit({
-			boardId: true,
-			revision: true
-		}),
-		clips: z.array(BoardClipSchema.omit({ sequenceId: true }))
-	})).optional()
-});
-z.object({
-	include: z.array(z.enum([
-		"nodes",
-		"connections",
-		"effects",
-		"sequences",
-		"clips",
-		"playback"
-	])).optional(),
-	viewport: z.object({
-		x: finiteSchema,
-		y: finiteSchema,
-		width: finiteSchema.positive(),
-		height: finiteSchema.positive()
-	}).optional()
-});
-/** Persisted on `boards.metadata.playback`: how a Board plays when opened. */
-const BoardPlaybackPolicySchema = z.object({
-	sequenceId: idSchema,
-	/** Delay before the first local playback after opening the Board, in milliseconds. */
-	delayMs: finiteSchema.nonnegative().default(0),
-	loop: z.boolean().default(false)
-});
-function parseBoardPlaybackPolicy(metadata) {
-	const parsed = BoardPlaybackPolicySchema.safeParse(metadata.playback);
-	return parsed.success ? parsed.data : null;
-}
-z.discriminatedUnion("type", [
-	z.object({
-		commandId: idSchema,
-		type: z.literal("play"),
-		sequenceId: idSchema,
-		position: finiteSchema.nonnegative().optional(),
-		timeScale: finiteSchema.positive().max(4).optional(),
-		shared: z.boolean().optional(),
-		seed: idSchema.optional()
-	}),
-	z.object({
-		commandId: idSchema,
-		type: z.literal("pause"),
-		playbackId: z.string().uuid()
-	}),
-	z.object({
-		commandId: idSchema,
-		type: z.literal("seek"),
-		playbackId: z.string().uuid(),
-		position: finiteSchema.nonnegative()
-	}),
-	z.object({
-		commandId: idSchema,
-		type: z.literal("stop"),
-		playbackId: z.string().uuid()
-	})
-]);
-//#endregion
 //#region src/board/animation.ts
 const ZERO_COST = {
 	particles: 0,
@@ -2951,4 +2485,4 @@ function createBoardExtensionRegistry(input = {}) {
 	return registry;
 }
 //#endregion
-export { BILLING_ACCESS_BLOCKED_ERROR_CODE, BillingApi, BoardClient, BoardExtensionRegistry, BoardPlaybackPolicySchema, BoardTransactionError, COHUB_ENVIRONMENTS, COHUB_SOURCE_HEADER, COHUB_SOURCE_HEADER_NAMES, CohubClient, CohubHttpClient, DEFAULT_BOARD_LIMITS, FEATURE_NOT_ENTITLED_ERROR_CODE, GenerationPolicyError, HttpError, ParentBridgeTransport, PopupBrokerTransport, REQUEST_SOURCE_VIA_MAX_LENGTH, ReferencesApi, ReferralsApi, SessionGenerationStreamClient, SessionPatchReducer, UI_COMMAND_DEFAULT_TIMEOUT_MS, UI_COMMAND_MAX_TIMEOUT_MS, UI_COMMAND_PAYLOAD_MAX_BYTES, UI_COMMAND_PENDING_TTL_SECONDS, UI_COMMAND_SETTLEMENT_GRACE_SECONDS, UI_COMMAND_TERMINAL_TTL_SECONDS, UI_COMMAND_VERSION, UiCommandsApi, UsersApi, VoiceApi, VoiceInputClient, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH, WORK_SURFACE_READY_TIMEOUT_MS, WORK_SURFACE_REQUEST_TIMEOUT_MS, WebsocketClient, WorkCommerceApi, WorkRealtimeApi, WorkRefParseError, WorkRoom, WorkRuntimeApi, WorkSurfaceApi, WorksApi, assertGenerationRequestAllowedByPolicy, buildSpaceInvitePath, buildSpacePath, buildWorkSurfaceRequest, clearGrantedWorkScopes, clip, compileSequence, createBoardExtensionRegistry, createCohubClient, createHttpClient, createSessionGenerationStreamClient, createSessionPatchReducer, createSlugWorkIdResolver, createVoiceInputClient, createWebsocketClient, createWorkBridgeCore, createWorkRuntime, decodeGenerationPolicy, encodeGenerationPolicy, extractBillingPayload, filterDiscoverableGenerationModels, filterGenerationDeclarationsByPolicy, findGenerationModelPolicy, formatWorkRef, getAllowedGenerationModelIds, hasGrantedWorkScopes, hasRequestSourceIdentity, isBillingAccessBlockedCode, isBillingAccessBlockedError, isFeatureNotEntitledError, isGenerationModelHidden, isHttpErrorCode, isRequestSourceClientId, isRequestSourceEmpty, isRequestSourceUuid, isTerminalUiCommandStatus, isUiSurfaceMethod, isWorkId, joinApiUrl, matchesUnauthorizedErrorToken, mergeRequestSourceIntoMeta, normalizeBaseUrl, normalizeGenerationPolicy, normalizeRequestSource, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, parseAssistantMessageCommit, parseBoardPlaybackPolicy, parseGenerationPolicyFromEnv, parseRequestSourceFromHeaders, parseUiCommand, parseWorkRef, parseWorkSurfaceReady, parseWorkSurfaceResponse, readRequestSourceFromEnv, requestSourceToHeaders, resolveApiBaseUrl, resolveCohubEnvironment, resolveRequestSourceChannel, resolveVoiceInputWebsocketUrl, resolveWebsocketUrl, resolveWorkTransport, sanitizeAccessToken, setGrantedWorkScopes, timeline };
+export { BILLING_ACCESS_BLOCKED_ERROR_CODE, BOARD_COLOR_IDS, BOARD_GEO_KINDS, BOARD_NATIVE_NODE_TYPES, BOARD_NODE_CONTRACT, BillingApi, BoardClient, BoardExtensionRegistry, BoardInputError, BoardPlaybackPolicySchema, BoardTransactionError, COHUB_ENVIRONMENTS, COHUB_SOURCE_HEADER, COHUB_SOURCE_HEADER_NAMES, CohubClient, CohubHttpClient, DEFAULT_BOARD_LIMITS, FEATURE_NOT_ENTITLED_ERROR_CODE, GenerationPolicyError, HttpError, ParentBridgeTransport, PopupBrokerTransport, REQUEST_SOURCE_VIA_MAX_LENGTH, ReferencesApi, ReferralsApi, SessionGenerationStreamClient, SessionPatchReducer, SpacePublicFilesApi, UI_COMMAND_DEFAULT_TIMEOUT_MS, UI_COMMAND_MAX_TIMEOUT_MS, UI_COMMAND_PAYLOAD_MAX_BYTES, UI_COMMAND_PENDING_TTL_SECONDS, UI_COMMAND_SETTLEMENT_GRACE_SECONDS, UI_COMMAND_TERMINAL_TTL_SECONDS, UI_COMMAND_VERSION, UiCommandsApi, UsersApi, VoiceApi, VoiceInputClient, WORK_COMPOSER_CHIP_CONTENT_MAX_BYTES, WORK_COMPOSER_CHIP_KEY_MAX_LENGTH, WORK_COMPOSER_CHIP_LABEL_MAX_LENGTH, WORK_SURFACE_READY_TIMEOUT_MS, WORK_SURFACE_REQUEST_TIMEOUT_MS, WebsocketClient, WorkCommerceApi, WorkRealtimeApi, WorkRefParseError, WorkRoom, WorkRuntimeApi, WorkSurfaceApi, WorksApi, assertBoardNodes, assertGenerationRequestAllowedByPolicy, buildSpaceInvitePath, buildSpacePath, buildWorkSurfaceRequest, clearGrantedWorkScopes, clip, compileSequence, createBoardExtensionRegistry, createBoardNode, createCohubClient, createHttpClient, createSessionGenerationStreamClient, createSessionPatchReducer, createSlugWorkIdResolver, createVoiceInputClient, createWebsocketClient, createWorkBridgeCore, createWorkRuntime, decodeGenerationPolicy, encodeGenerationPolicy, extractBillingPayload, filterDiscoverableGenerationModels, filterGenerationDeclarationsByPolicy, findGenerationModelPolicy, formatWorkRef, getAllowedGenerationModelIds, hasGrantedWorkScopes, hasRequestSourceIdentity, isBillingAccessBlockedCode, isBillingAccessBlockedError, isFeatureNotEntitledError, isGenerationModelHidden, isHttpErrorCode, isRequestSourceClientId, isRequestSourceEmpty, isRequestSourceUuid, isTerminalUiCommandStatus, isUiSurfaceMethod, isUuid, isWorkId, joinApiUrl, matchesUnauthorizedErrorToken, mergeRequestSourceIntoMeta, normalizeBaseUrl, normalizeGenerationPolicy, normalizeRequestSource, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, parseAssistantMessageCommit, parseBoardPlaybackPolicy, parseGenerationPolicyFromEnv, parseRequestSourceFromHeaders, parseUiCommand, parseWorkRef, parseWorkSurfaceReady, parseWorkSurfaceResponse, readRequestSourceFromEnv, requestSourceToHeaders, resolveApiBaseUrl, resolveCohubEnvironment, resolveRequestSourceChannel, resolveVoiceInputWebsocketUrl, resolveWebsocketUrl, resolveWorkTransport, sanitizeAccessToken, setGrantedWorkScopes, timeline, validateBoardNodeInput, validateBoardNodes };