@neta-art/cohub 11.3.1 → 11.3.2

package/dist/index.js

@@ -74,12 +74,51 @@ const appAuthorizationResultSchema = z.discriminatedUnion("status", [
 ]);
 const GiB = 1073741824;
 /** Maximum size of a single uploaded file. */
-const UPLOAD_MAX_FILE_BYTES = 1 * GiB;
+const UPLOAD_MAX_FILE_BYTES = 2 * GiB;
 /** Maximum combined size of one upload batch. */
 const UPLOAD_MAX_BATCH_BYTES = 2 * GiB;
 /** Maximum file count of one upload batch. */
 const UPLOAD_MAX_BATCH_FILES = 2e3;
 //#endregion
+//#region ../protocol/dist/upload-errors.js
+/**
+* Structured upload rejection codes shared by the api routes and their clients.
+* The api keeps human-readable English messages; clients map these codes to
+* localized copy instead of matching on message text.
+*/
+/** A single file exceeds `UPLOAD_MAX_FILE_BYTES`. */
+const UPLOAD_ERROR_FILE_TOO_LARGE = "file_too_large";
+/** One batch exceeds `UPLOAD_MAX_BATCH_BYTES`. */
+const UPLOAD_ERROR_BATCH_TOO_LARGE = "upload_batch_too_large";
+/** One batch exceeds `UPLOAD_MAX_BATCH_FILES`. */
+const UPLOAD_ERROR_TOO_MANY_FILES = "upload_too_many_files";
+/** The per-user upload quota is exhausted; the response carries `retryAfterSeconds`. */
+const UPLOAD_ERROR_RATE_LIMITED = "upload_rate_limited";
+/**
+* Split entries into batches that respect the batch byte and file caps, keeping
+* input order. A single entry larger than the batch byte cap still gets its own
+* batch so the server can reject it with `file_too_large` rather than silently
+* dropping it.
+*/
+function batchUploadEntries(entries, sizeOf, options = {}) {
+	const maxBatchBytes = options.maxBatchBytes ?? 2147483648;
+	const maxBatchFiles = options.maxBatchFiles ?? 2e3;
+	const batches = [];
+	let batch = [];
+	let bytes = 0;
+	for (const entry of entries) {
+		if (batch.length > 0 && (batch.length >= maxBatchFiles || bytes + sizeOf(entry) > maxBatchBytes)) {
+			batches.push(batch);
+			batch = [];
+			bytes = 0;
+		}
+		batch.push(entry);
+		bytes += sizeOf(entry);
+	}
+	if (batch.length > 0) batches.push(batch);
+	return batches;
+}
+//#endregion
 //#region ../protocol/dist/board-url.js
 const BOARD_REMOTE_URL_MAX_LENGTH = 4096;
 function parseIpv4(host) {
@@ -693,6 +732,86 @@ const BoardPatchSchema = z.object({
 	animations: z.record(BoardIdSchema, patchObject.and(z.object({ tracks: z.record(BoardKeySchema, patchObject.nullable()).optional() })).nullable()).optional()
 }).strict();
 //#endregion
+//#region ../protocol/dist/board.js
+const BOARD_EXTENSION = ".board";
+const BOARD_MIME_TYPE = "application/json";
+z.object({
+	kind: z.literal("cohub.board.manifest"),
+	version: z.literal(1),
+	boardId: z.string().uuid(),
+	title: z.string().min(1).max(255)
+});
+const BOARD_READ_SECTIONS = ["items", "animations"];
+const rectSchema = z.object({
+	x: z.number().finite(),
+	y: z.number().finite(),
+	width: z.number().finite().positive(),
+	height: z.number().finite().positive()
+}).strict();
+z.object({
+	only: z.array(z.enum(BOARD_READ_SECTIONS)).optional(),
+	rect: rectSchema.optional(),
+	within: BoardIdSchema.optional(),
+	items: z.array(z.string().min(1)).max(5e4).optional(),
+	animations: z.array(z.string().min(1)).max(1e4).optional(),
+	limit: z.number().int().min(1).max(5e4).optional(),
+	cursor: z.string().min(1).optional()
+}).strict().refine((read) => !(read.cursor && (read.rect || read.within)), {
+	path: ["cursor"],
+	message: "cursor pages by id, so it cannot be combined with rect or within"
+});
+z.object({
+	patch: BoardPatchSchema,
+	replace: z.boolean().default(false),
+	cascade: z.boolean().default(false),
+	dryRun: z.boolean().default(false),
+	baseVersion: z.number().int().nonnegative().optional(),
+	mutationId: z.string().min(1).max(160).optional(),
+	clientId: z.string().min(1).max(160).optional()
+}).strict();
+z.object({
+	path: z.string().min(1),
+	title: z.string().min(1).max(255).optional(),
+	document: BoardPatchSchema.optional(),
+	mutationId: z.string().max(160).optional()
+}).strict();
+z.object({
+	before: z.number().int().positive().optional(),
+	limit: z.number().int().min(1).max(500).default(200)
+}).strict();
+const commandId = z.string().min(1).max(160);
+z.discriminatedUnion("type", [
+	z.object({
+		commandId,
+		type: z.literal("play"),
+		animationId: z.string().min(1),
+		position: z.number().finite().nonnegative().optional(),
+		timeScale: z.number().finite().positive().max(4).optional(),
+		seed: z.string().min(1).max(160).optional()
+	}).strict(),
+	z.object({
+		commandId,
+		type: z.literal("pause")
+	}).strict(),
+	z.object({
+		commandId,
+		type: z.literal("resume")
+	}).strict(),
+	z.object({
+		commandId,
+		type: z.literal("seek"),
+		position: z.number().finite().nonnegative()
+	}).strict(),
+	z.object({
+		commandId,
+		type: z.literal("next")
+	}).strict(),
+	z.object({
+		commandId,
+		type: z.literal("stop")
+	}).strict()
+]);
+//#endregion
 //#region ../protocol/dist/board-json.js
 /** Structural equality for JSON-shaped semantic values. */
 function boardJsonEquals(a, b) {
@@ -1245,20 +1364,20 @@ const CAMERA_PROPERTIES = {
 			y: z.number().finite(),
 			width: z.number().finite().positive(),
 			height: z.number().finite().positive()
-		}).strict()])
+		}).strict()]).describe("Item id or world-space rect to fit with 48 px padding; holds until the next focus keyframe.")
 	},
 	zoom: {
 		kind: "number",
-		schema: z.number().finite().positive(),
+		schema: z.number().finite().positive().describe("Pixels per world unit; overrides the zoom computed by focus."),
 		multiplicative: true
 	},
 	center: {
 		kind: "vec2",
-		schema: BoardVec2Schema
+		schema: BoardVec2Schema.describe("World-space viewport center; overrides focus positioning using the resolved zoom.")
 	},
 	shake: {
 		kind: "number",
-		schema: z.number().finite().nonnegative()
+		schema: z.number().finite().nonnegative().describe("Shake amplitude in screen pixels, applied after focus, zoom and center.")
 	}
 };
 const ANIMATION_PROPERTIES = { time: {
@@ -1961,6 +2080,117 @@ const readSentTurns = (meta) => {
 	return refs;
 };
 //#endregion
+//#region ../protocol/dist/fs/mime.js
+const MIME_BY_EXTENSION = {
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".markdown": "text/markdown",
+	".json": "application/json",
+	".jsonl": "application/x-ndjson",
+	".csv": "text/csv",
+	[BOARD_EXTENSION]: BOARD_MIME_TYPE,
+	".js": "text/javascript",
+	".mjs": "text/javascript",
+	".cjs": "text/javascript",
+	".ts": "text/typescript",
+	".tsx": "text/tsx",
+	".jsx": "text/jsx",
+	".svelte": "text/x-svelte",
+	".css": "text/css",
+	".scss": "text/x-scss",
+	".html": "text/html",
+	".htm": "text/html",
+	".xml": "application/xml",
+	".yaml": "application/yaml",
+	".yml": "application/yaml",
+	".toml": "application/toml",
+	".ini": "text/plain",
+	".env": "text/plain",
+	".sh": "text/x-shellscript",
+	".bash": "text/x-shellscript",
+	".py": "text/x-python",
+	".go": "text/x-go",
+	".rs": "text/x-rust",
+	".java": "text/x-java-source",
+	".c": "text/x-c",
+	".h": "text/x-c",
+	".cpp": "text/x-c++src",
+	".hpp": "text/x-c++hdr",
+	".sql": "application/sql",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".avif": "image/avif",
+	".bmp": "image/bmp",
+	".ico": "image/x-icon",
+	".mp4": "video/mp4",
+	".webm": "video/webm",
+	".mov": "video/quicktime",
+	".m4v": "video/x-m4v",
+	".ogv": "video/ogg",
+	".avi": "video/x-msvideo",
+	".mp3": "audio/mpeg",
+	".wav": "audio/wav",
+	".ogg": "audio/ogg",
+	".m4a": "audio/mp4",
+	".aac": "audio/aac",
+	".flac": "audio/flac",
+	".opus": "audio/ogg",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".stl": "model/stl",
+	".obj": "model/obj",
+	".3mf": "model/3mf",
+	".usdz": "model/vnd.usdz+zip",
+	".mtl": "text/plain",
+	".pdf": "application/pdf",
+	".wasm": "application/wasm",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".zip": "application/zip",
+	".gz": "application/gzip",
+	".tar": "application/x-tar",
+	".rar": "application/vnd.rar",
+	".7z": "application/x-7z-compressed",
+	".exe": "application/x-msdownload",
+	".dmg": "application/x-apple-diskimage",
+	".deb": "application/vnd.debian.binary-package",
+	".rpm": "application/x-rpm"
+};
+const MIME_BY_FILENAME = {
+	dockerfile: "text/x-dockerfile",
+	makefile: "text/x-makefile"
+};
+function mimeTypeForPath(path) {
+	const name = (path.split(/[\\/]/).pop() ?? "").toLowerCase();
+	const byName = Object.hasOwn(MIME_BY_FILENAME, name) ? MIME_BY_FILENAME[name] : void 0;
+	if (byName) return byName;
+	const dot = name.lastIndexOf(".");
+	const byExtension = dot > 0 ? MIME_BY_EXTENSION[name.slice(dot)] : void 0;
+	if (byExtension) return byExtension;
+	return name.startsWith(".") ? "text/plain" : null;
+}
+function normalizeMime(mimeType) {
+	if (!mimeType) return null;
+	return mimeType.split(";")[0]?.trim().toLowerCase() || null;
+}
+const TEXT_APPLICATION_MIMES = /* @__PURE__ */ new Set([
+	"application/json",
+	"application/csv",
+	"application/xml",
+	"application/yaml",
+	"application/toml",
+	"application/sql",
+	"application/x-ndjson"
+]);
+function isTextMime(mimeType) {
+	const mime = normalizeMime(mimeType);
+	return Boolean(mime && (mime.startsWith("text/") || TEXT_APPLICATION_MIMES.has(mime)));
+}
+//#endregion
 //#region ../protocol/dist/display/actions.js
 const DISPLAY_ACTION_TYPES = [
 	"tap",
@@ -7489,4 +7719,4 @@ function generationOutputSource(result, outputIndex) {
 	return `data:${declared && MEDIA_TYPE_PATTERN.test(declared) ? declared : DEFAULT_MEDIA_TYPES[String(block.type)] ?? "application/octet-stream"};base64,${data}`;
 }
 //#endregion
-export { APP_APPEARANCE_TOKENS, APP_COMPOSER_CHIP_CONTENT_MAX_BYTES, APP_COMPOSER_CHIP_KEY_MAX_LENGTH, APP_COMPOSER_CHIP_LABEL_MAX_LENGTH, APP_DEVICES, APP_SURFACE_READY_TIMEOUT_MS, APP_SURFACE_REQUEST_TIMEOUT_MS, AppCommerceApi, AppRealtimeApi, AppRefParseError, AppRoom, AppRoomRtc, AppRtcChannel, AppRtcError, AppRuntimeApi, AppRuntimeApi as WorkRuntimeApi, AppRuntimeError, AppSurfaceApi, AppWindowApi, AppsApi, BILLING_ACCESS_BLOCKED_ERROR_CODE, BOARD_COLOR_TOKENS, BOARD_ITEM_TYPES, BillingApi, BoardAnimationSchema, BoardClient, BoardPatchSchema, BoardTrackSchema, COHUB_ENVIRONMENTS, COHUB_SOURCE_HEADER, COHUB_SOURCE_HEADER_NAMES, CohubClient, CohubHttpClient, DESKTOP_COMMAND_ACCEPT_TIMEOUT_MS, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_COMMAND_MAX_TIMEOUT_MS, DESKTOP_COMMAND_OPEN_TIMEOUT_MS, DESKTOP_COMMAND_PAYLOAD_MAX_BYTES, DESKTOP_COMMAND_PENDING_TTL_SECONDS, DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS, DESKTOP_COMMAND_TERMINAL_TTL_SECONDS, DESKTOP_COMMAND_VERSION, DISPLAY_ACTION_TYPES, DISPLAY_ELEMENT_REF_PATTERN, DISPLAY_SYSTEM_ACTIONS, DesktopCommandsApi, DisplayActionError, DisplayConnection, FEATURE_NOT_ENTITLED_ERROR_CODE, GenerationPolicyError, HOME_SPACE_SLUG, HttpError, NATIVE_INGEST_MAX_TURNS, NATIVE_SYNC_SOURCE, OriginBrokerTransport, PERMISSIONS, ParentBridgeTransport, PopupBrokerTransport, REQUEST_SOURCE_VIA_MAX_LENGTH, RUNTIME_ARCHIVE_SEGMENT_BYTES, RUNTIME_MAX_FRAME_BYTES, RUNTIME_PROTOCOL_VERSION, RUNTIME_RECOVERY_BATCH_SIZE, ReferencesApi, ReferralsApi, RoomsApi, SETTLED_TURN_STATUSES, SessionGenerationStreamClient, SessionPatchReducer, SpaceDisplaysApi, SpacePublicFilesApi, SpaceWebhooksApi, UPLOAD_MAX_BATCH_BYTES, UPLOAD_MAX_BATCH_FILES, UPLOAD_MAX_FILE_BYTES, USER_LEVEL_PERMISSIONS, UiCommandsApi, UsersApi, VoiceApi, VoiceInputClient, WebsocketClient, WorkCommerceApi, WorkRealtimeApi, WorkRefParseError, WorkRoom, WorkSurfaceApi, appAppearanceVar, applyAppAppearance, assertGenerationRequestAllowedByPolicy, attachAppEmbed, buildAppSurfaceRequest, buildSpaceInvitePath, buildSpacePath, clearGrantedAppScopes, compileDisplayActions, connectDisplay, contextToPiMessages, createAppBridgeCore, createAppBridgeCore as createWorkBridgeCore, createAppRuntime, createAppRuntime as createWorkRuntime, createCohubClient, createHttpClient, createOriginAppResolver, createSessionGenerationStreamClient, createSessionPatchReducer, createSlugAppIdResolver, createSlugAppIdResolver as createSlugWorkIdResolver, createVoiceInputClient, createWebsocketClient, decodeGenerationPolicy, defaultDesktopCommandTimeoutMs, encodeGenerationPolicy, extractBillingPayload, filterDiscoverableGenerationModels, filterGenerationDeclarationsByPolicy, filterSpacePickerItems, findGenerationModelPolicy, fingerprintProjectionTurns, formatAppRef, formatWorkRef, generationOutputSource, getAllowedGenerationModelIds, getCohubContext, harnessArchiveIndexSchema, hasGrantedAppScopes, hasRequestSourceIdentity, isActiveGenerationTask, isAppId, isBillingAccessBlockedCode, isBillingAccessBlockedError, isDesktopCallMethod, isFeatureNotEntitledError, isGenerationModelHidden, isHttpErrorCode, isLocalHarness, isNativeClientTurn, isProjectionCompaction, isRequestSourceClientId, isRequestSourceEmpty, isRequestSourceUuid, isTerminalDesktopCommandStatus, isUserLevelPermission, isUuid, isWorkId, joinApiUrl, matchesUnauthorizedErrorToken, mergeRequestSourceIntoMeta, nativeIngestTurnSchema, nativeRuntimeEventSchema, nativeTurnCompleteSchema, nativeTurnProgressSchema, normalizeBaseUrl, normalizeDisplayPoint, normalizeGenerationPolicy, normalizeRequestSource, normalizeSessionTurnOrigin, normalizeSpacePickerQuery, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, orderSpacePickerItems, parseAppRef, parseAppSurfaceReady, parseAppSurfaceResponse, parseAssistantMessageCommit, parseBoardDocument, parseBoardItem, parseDesktopCommand, parseGenerationPolicyFromEnv, parseRequestSourceFromHeaders, parseSpaceRef, parseWorkRef, projectNativeMessageMeta, projectNativeSession, readRequestSourceFromEnv, readSentTurns, readSessionTurnOrigin, requestSourceToHeaders, resolveApiBaseUrl, resolveAppTransport, resolveAppTransport as resolveWorkTransport, resolveCohubEnvironment, resolveExecutionAppId, resolveExecutionToken, resolveHarness, resolveOpenSurface, resolveRequestSourceChannel, resolveVoiceInputWebsocketUrl, resolveWebBaseUrl, resolveWebsocketUrl, runtimeCommandSchema, runtimeEventSchema, runtimeNativeStopSchema, runtimeReadySchema, sanitizeAccessToken, scopeListHasPermission, selectRuntimeContextMessages, selectSpacePickerItems, serializeProjection, serializeProjectionRecords, setGrantedAppScopes, toGenerationTaskView, trimProjectionTurnsToCompaction, validateArchiveBoundary };
+export { APP_APPEARANCE_TOKENS, APP_COMPOSER_CHIP_CONTENT_MAX_BYTES, APP_COMPOSER_CHIP_KEY_MAX_LENGTH, APP_COMPOSER_CHIP_LABEL_MAX_LENGTH, APP_DEVICES, APP_SURFACE_READY_TIMEOUT_MS, APP_SURFACE_REQUEST_TIMEOUT_MS, AppCommerceApi, AppRealtimeApi, AppRefParseError, AppRoom, AppRoomRtc, AppRtcChannel, AppRtcError, AppRuntimeApi, AppRuntimeApi as WorkRuntimeApi, AppRuntimeError, AppSurfaceApi, AppWindowApi, AppsApi, BILLING_ACCESS_BLOCKED_ERROR_CODE, BOARD_COLOR_TOKENS, BOARD_ITEM_TYPES, BillingApi, BoardAnimationSchema, BoardClient, BoardPatchSchema, BoardTrackSchema, COHUB_ENVIRONMENTS, COHUB_SOURCE_HEADER, COHUB_SOURCE_HEADER_NAMES, CohubClient, CohubHttpClient, DESKTOP_COMMAND_ACCEPT_TIMEOUT_MS, DESKTOP_COMMAND_DEFAULT_TIMEOUT_MS, DESKTOP_COMMAND_MAX_TIMEOUT_MS, DESKTOP_COMMAND_OPEN_TIMEOUT_MS, DESKTOP_COMMAND_PAYLOAD_MAX_BYTES, DESKTOP_COMMAND_PENDING_TTL_SECONDS, DESKTOP_COMMAND_SETTLEMENT_GRACE_SECONDS, DESKTOP_COMMAND_TERMINAL_TTL_SECONDS, DESKTOP_COMMAND_VERSION, DISPLAY_ACTION_TYPES, DISPLAY_ELEMENT_REF_PATTERN, DISPLAY_SYSTEM_ACTIONS, DesktopCommandsApi, DisplayActionError, DisplayConnection, FEATURE_NOT_ENTITLED_ERROR_CODE, GenerationPolicyError, HOME_SPACE_SLUG, HttpError, NATIVE_INGEST_MAX_TURNS, NATIVE_SYNC_SOURCE, OriginBrokerTransport, PERMISSIONS, ParentBridgeTransport, PopupBrokerTransport, REQUEST_SOURCE_VIA_MAX_LENGTH, RUNTIME_ARCHIVE_SEGMENT_BYTES, RUNTIME_MAX_FRAME_BYTES, RUNTIME_PROTOCOL_VERSION, RUNTIME_RECOVERY_BATCH_SIZE, ReferencesApi, ReferralsApi, RoomsApi, SETTLED_TURN_STATUSES, SessionGenerationStreamClient, SessionPatchReducer, SpaceDisplaysApi, SpacePublicFilesApi, SpaceWebhooksApi, UPLOAD_ERROR_BATCH_TOO_LARGE, UPLOAD_ERROR_FILE_TOO_LARGE, UPLOAD_ERROR_RATE_LIMITED, UPLOAD_ERROR_TOO_MANY_FILES, UPLOAD_MAX_BATCH_BYTES, UPLOAD_MAX_BATCH_FILES, UPLOAD_MAX_FILE_BYTES, USER_LEVEL_PERMISSIONS, UiCommandsApi, UsersApi, VoiceApi, VoiceInputClient, WebsocketClient, WorkCommerceApi, WorkRealtimeApi, WorkRefParseError, WorkRoom, WorkSurfaceApi, appAppearanceVar, applyAppAppearance, assertGenerationRequestAllowedByPolicy, attachAppEmbed, batchUploadEntries, buildAppSurfaceRequest, buildSpaceInvitePath, buildSpacePath, clearGrantedAppScopes, compileDisplayActions, connectDisplay, contextToPiMessages, createAppBridgeCore, createAppBridgeCore as createWorkBridgeCore, createAppRuntime, createAppRuntime as createWorkRuntime, createCohubClient, createHttpClient, createOriginAppResolver, createSessionGenerationStreamClient, createSessionPatchReducer, createSlugAppIdResolver, createSlugAppIdResolver as createSlugWorkIdResolver, createVoiceInputClient, createWebsocketClient, decodeGenerationPolicy, defaultDesktopCommandTimeoutMs, encodeGenerationPolicy, extractBillingPayload, filterDiscoverableGenerationModels, filterGenerationDeclarationsByPolicy, filterSpacePickerItems, findGenerationModelPolicy, fingerprintProjectionTurns, formatAppRef, formatWorkRef, generationOutputSource, getAllowedGenerationModelIds, getCohubContext, harnessArchiveIndexSchema, hasGrantedAppScopes, hasRequestSourceIdentity, isActiveGenerationTask, isAppId, isBillingAccessBlockedCode, isBillingAccessBlockedError, isDesktopCallMethod, isFeatureNotEntitledError, isGenerationModelHidden, isHttpErrorCode, isLocalHarness, isNativeClientTurn, isProjectionCompaction, isRequestSourceClientId, isRequestSourceEmpty, isRequestSourceUuid, isTerminalDesktopCommandStatus, isTextMime, isUserLevelPermission, isUuid, isWorkId, joinApiUrl, matchesUnauthorizedErrorToken, mergeRequestSourceIntoMeta, mimeTypeForPath, nativeIngestTurnSchema, nativeRuntimeEventSchema, nativeTurnCompleteSchema, nativeTurnProgressSchema, normalizeBaseUrl, normalizeDisplayPoint, normalizeGenerationPolicy, normalizeRequestSource, normalizeSessionTurnOrigin, normalizeSpacePickerQuery, normalizeVoiceInputWebsocketUrl, normalizeWebsocketUrl, orderSpacePickerItems, parseAppRef, parseAppSurfaceReady, parseAppSurfaceResponse, parseAssistantMessageCommit, parseBoardDocument, parseBoardItem, parseDesktopCommand, parseGenerationPolicyFromEnv, parseRequestSourceFromHeaders, parseSpaceRef, parseWorkRef, projectNativeMessageMeta, projectNativeSession, readRequestSourceFromEnv, readSentTurns, readSessionTurnOrigin, requestSourceToHeaders, resolveApiBaseUrl, resolveAppTransport, resolveAppTransport as resolveWorkTransport, resolveCohubEnvironment, resolveExecutionAppId, resolveExecutionToken, resolveHarness, resolveOpenSurface, resolveRequestSourceChannel, resolveVoiceInputWebsocketUrl, resolveWebBaseUrl, resolveWebsocketUrl, runtimeCommandSchema, runtimeEventSchema, runtimeNativeStopSchema, runtimeReadySchema, sanitizeAccessToken, scopeListHasPermission, selectRuntimeContextMessages, selectSpacePickerItems, serializeProjection, serializeProjectionRecords, setGrantedAppScopes, toGenerationTaskView, trimProjectionTurnsToCompaction, validateArchiveBoundary };

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

@@ -93,20 +93,20 @@ const CAMERA_PROPERTIES = {
 			y: z.number().finite(),
 			width: z.number().finite().positive(),
 			height: z.number().finite().positive()
-		}).strict()])
+		}).strict()]).describe("Item id or world-space rect to fit with 48 px padding; holds until the next focus keyframe.")
 	},
 	zoom: {
 		kind: "number",
-		schema: z.number().finite().positive(),
+		schema: z.number().finite().positive().describe("Pixels per world unit; overrides the zoom computed by focus."),
 		multiplicative: true
 	},
 	center: {
 		kind: "vec2",
-		schema: BoardVec2Schema
+		schema: BoardVec2Schema.describe("World-space viewport center; overrides focus positioning using the resolved zoom.")
 	},
 	shake: {
 		kind: "number",
-		schema: z.number().finite().nonnegative()
+		schema: z.number().finite().nonnegative().describe("Shake amplitude in screen pixels, applied after focus, zoom and center.")
 	}
 };
 const ANIMATION_PROPERTIES = { time: {

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

@@ -1,5 +1,5 @@
 import { BOARD_CAMERA_TARGET, BOARD_COLOR_TOKENS, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BoardAnimationHeaderSchema, BoardKeySchema, BoardScriptSchema, BoardSettingsSchema, BoardTrackSchema, isBuiltinItemType } from "./board-model.js";
-import { listBoardProperties } from "./board-patch.js";
+import { listBoardProperties, resolveBoardProperty } from "./board-patch.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-schema.js
 function toJsonSchema(schema) {
@@ -25,7 +25,18 @@ function boardJsonSchema(target) {
 	};
 	if (target === "track") return { schema: toJsonSchema(BoardTrackSchema) };
 	if (target === "script") return { schema: toJsonSchema(BoardScriptSchema) };
-	if (target === "camera") return { properties: listBoardProperties(BOARD_CAMERA_TARGET) };
+	if (target === "camera") {
+		const properties = listBoardProperties(target);
+		const fields = Object.fromEntries(properties.map(({ property }) => {
+			const result = resolveBoardProperty(target, property);
+			if (!result.ok) throw new Error(result.message);
+			return [property, result.spec.schema];
+		}));
+		return {
+			schema: toJsonSchema(z.object(fields).partial().strict()),
+			properties
+		};
+	}
 	if (!isBuiltinItemType(target)) return null;
 	return {
 		schema: toJsonSchema(BOARD_ITEM_SCHEMAS[target]),

package/dist/protocol/dist/board.js

@@ -2,6 +2,7 @@ import { BoardIdSchema, BoardPatchSchema } from "./board-model.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.js
 const BOARD_EXTENSION = ".board";
+const BOARD_MIME_TYPE = "application/json";
 const BOARD_MANIFEST_KIND = "cohub.board.manifest";
 const BOARD_CLIPBOARD_KIND = "cohub.board.clipboard";
 const BOARD_CLIPBOARD_MIME = "application/x-cohub-board";
@@ -106,4 +107,4 @@ z.discriminatedUnion("type", [
 	}).strict()
 ]);
 //#endregion
-export { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BOARD_READ_SECTIONS, BoardManifestSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BOARD_MIME_TYPE, BOARD_READ_SECTIONS, BoardManifestSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/fs/mime.d.ts

@@ -0,0 +1,4 @@
+//#region ../protocol/dist/fs/mime.d.ts
+type ModelFormat = "glb" | "gltf" | "stl" | "obj";
+//#endregion
+export { ModelFormat };

package/dist/protocol/dist/fs/mime.js

@@ -0,0 +1,113 @@
+import { BOARD_EXTENSION, BOARD_MIME_TYPE } from "../board.js";
+//#region ../protocol/dist/fs/mime.js
+const MIME_BY_EXTENSION = {
+	".txt": "text/plain",
+	".md": "text/markdown",
+	".markdown": "text/markdown",
+	".json": "application/json",
+	".jsonl": "application/x-ndjson",
+	".csv": "text/csv",
+	[BOARD_EXTENSION]: BOARD_MIME_TYPE,
+	".js": "text/javascript",
+	".mjs": "text/javascript",
+	".cjs": "text/javascript",
+	".ts": "text/typescript",
+	".tsx": "text/tsx",
+	".jsx": "text/jsx",
+	".svelte": "text/x-svelte",
+	".css": "text/css",
+	".scss": "text/x-scss",
+	".html": "text/html",
+	".htm": "text/html",
+	".xml": "application/xml",
+	".yaml": "application/yaml",
+	".yml": "application/yaml",
+	".toml": "application/toml",
+	".ini": "text/plain",
+	".env": "text/plain",
+	".sh": "text/x-shellscript",
+	".bash": "text/x-shellscript",
+	".py": "text/x-python",
+	".go": "text/x-go",
+	".rs": "text/x-rust",
+	".java": "text/x-java-source",
+	".c": "text/x-c",
+	".h": "text/x-c",
+	".cpp": "text/x-c++src",
+	".hpp": "text/x-c++hdr",
+	".sql": "application/sql",
+	".svg": "image/svg+xml",
+	".png": "image/png",
+	".jpg": "image/jpeg",
+	".jpeg": "image/jpeg",
+	".gif": "image/gif",
+	".webp": "image/webp",
+	".avif": "image/avif",
+	".bmp": "image/bmp",
+	".ico": "image/x-icon",
+	".mp4": "video/mp4",
+	".webm": "video/webm",
+	".mov": "video/quicktime",
+	".m4v": "video/x-m4v",
+	".ogv": "video/ogg",
+	".avi": "video/x-msvideo",
+	".mp3": "audio/mpeg",
+	".wav": "audio/wav",
+	".ogg": "audio/ogg",
+	".m4a": "audio/mp4",
+	".aac": "audio/aac",
+	".flac": "audio/flac",
+	".opus": "audio/ogg",
+	".glb": "model/gltf-binary",
+	".gltf": "model/gltf+json",
+	".stl": "model/stl",
+	".obj": "model/obj",
+	".3mf": "model/3mf",
+	".usdz": "model/vnd.usdz+zip",
+	".mtl": "text/plain",
+	".pdf": "application/pdf",
+	".wasm": "application/wasm",
+	".woff": "font/woff",
+	".woff2": "font/woff2",
+	".zip": "application/zip",
+	".gz": "application/gzip",
+	".tar": "application/x-tar",
+	".rar": "application/vnd.rar",
+	".7z": "application/x-7z-compressed",
+	".exe": "application/x-msdownload",
+	".dmg": "application/x-apple-diskimage",
+	".deb": "application/vnd.debian.binary-package",
+	".rpm": "application/x-rpm"
+};
+const MIME_BY_FILENAME = {
+	dockerfile: "text/x-dockerfile",
+	makefile: "text/x-makefile"
+};
+function mimeTypeForPath(path) {
+	const name = (path.split(/[\\/]/).pop() ?? "").toLowerCase();
+	const byName = Object.hasOwn(MIME_BY_FILENAME, name) ? MIME_BY_FILENAME[name] : void 0;
+	if (byName) return byName;
+	const dot = name.lastIndexOf(".");
+	const byExtension = dot > 0 ? MIME_BY_EXTENSION[name.slice(dot)] : void 0;
+	if (byExtension) return byExtension;
+	return name.startsWith(".") ? "text/plain" : null;
+}
+function normalizeMime(mimeType) {
+	if (!mimeType) return null;
+	return mimeType.split(";")[0]?.trim().toLowerCase() || null;
+}
+const MODEL_FORMAT_BY_MIME = {
+	"model/gltf-binary": "glb",
+	"model/gltf+json": "gltf",
+	"model/stl": "stl",
+	"model/obj": "obj"
+};
+function modelFormatForPath(path, mimeType) {
+	const format = (mime) => {
+		const key = normalizeMime(mime);
+		return key && Object.hasOwn(MODEL_FORMAT_BY_MIME, key) ? MODEL_FORMAT_BY_MIME[key] : void 0;
+	};
+	return format(mimeTypeForPath(path)) ?? format(mimeType) ?? null;
+}
+//#endregion
+export { mimeTypeForPath, modelFormatForPath, normalizeMime };

package/dist/protocol/dist/index.d.ts

@@ -19,8 +19,9 @@ import "./runtime/index.js";
 import "./model/turn.js";
 import "./model/session.js";
 import "./realtime/board-awareness.js";
+import { ModelFormat } from "./fs/mime.js";
 import "./app.js";
 import "./realtime/types.js";
 import "./app-catalog.js";
 import "./host-bridge.js";
-export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, RequestSource, RequestSourceVia, TaskRunStatus, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };
+export { BOARD_ANCHOR_SIDES, BOARD_ARROW_ROUTES, BOARD_CAMERA_TARGET, BOARD_CLIPBOARD_KIND, BOARD_CLIPBOARD_MIME, BOARD_COLOR_TOKENS, BOARD_DASHES, BOARD_DERIVED_SIZE_TYPES, BOARD_EFFECT_KINDS, BOARD_EFFECT_KIND_INFO, BOARD_ENTER_PRESETS, BOARD_EXTENSION_TYPE_PATTERN, BOARD_GRID_DEFAULT_SIZE, BOARD_GRID_MAX_SIZE, BOARD_GRID_MIN_SIZE, BOARD_ID_MAX_LENGTH, BOARD_ITEM_SCHEMAS, BOARD_ITEM_TYPES, BOARD_PLAY_MODES, BOARD_SCHEMA_TARGETS, BOARD_SHAPE_GEOMETRIES, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TASK_ARTIFACT_LIMIT, BOARD_TASK_SOURCE_PREFIX, BOARD_TEXT_ALIGNS, BoardAnchorSide, BoardAnimation, BoardAnimationHeader, BoardAnimationHeaderSchema, BoardAnimationSchema, BoardApplyOptions, BoardApplyResult, BoardArrowAnchor, BoardArrowAnchorSchema, BoardArrowBinding, BoardArrowBindingSchema, BoardArrowEnd, BoardArrowEndSchema, BoardArrowItem, BoardArrowItemSchema, BoardArrowRoute, BoardAudioItem, BoardAudioItemSchema, BoardBackgroundSchema, BoardBuiltinItem, BoardBuiltinItemType, BoardChangeSummary, BoardColor, BoardColorSchema, BoardColorToken, BoardCropSchema, BoardCustomItem, BoardCustomItemSchema, BoardDash, BoardDelta, BoardDiagnostic, BoardDocument, BoardDrawItem, BoardDrawItemSchema, BoardDrawPoint, BoardDrawPointSchema, BoardEaseSchema, BoardEffectItem, BoardEffectItemSchema, BoardEffectKind, BoardEnterPreset, BoardExtensionItem, BoardExtensionItemSchema, BoardFileBackedItem, BoardFileItem, BoardFileItemSchema, BoardFrame, BoardFrameItem, BoardFrameItemSchema, BoardHistoryPage, BoardIdSchema, BoardImageItem, BoardImageItemSchema, BoardItem, BoardItemLookup, BoardItemType, BoardJsonSchemaResult, BoardKeySchema, BoardKeyframe, BoardKeyframeSchema, BoardLayout, BoardManifest, BoardManifestSchema, BoardMarker, BoardMarkerSchema, BoardMatrix, BoardMediaOrigin, BoardMediaOriginSchema, BoardMediaSnapshot, BoardMediaSnapshotSchema, BoardMediaSource, BoardMediaSourceSchema, BoardPatch, BoardPatchResult, BoardPatchSchema, BoardPlayMode, BoardPlaybackCommand, BoardPlaybackCommandSchema, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardPropertySpec, BoardReadResult, BoardRect, BoardScript, BoardScriptSchema, BoardSettings, BoardSettingsSchema, BoardShapeGeometry, BoardShapeItem, BoardShapeItemSchema, BoardSize, BoardSizeSchema, BoardState, BoardStyle, BoardStyleSchema, BoardTaskArtifact, BoardTaskArtifactSchema, BoardTaskItem, BoardTaskItemSchema, BoardTaskRunSource, BoardTaskSnapshot, BoardTaskSnapshotSchema, BoardTextItem, BoardTextItemSchema, BoardTextLayout, BoardTextMeasurer, BoardTrack, BoardTrackSchema, BoardTransactionRecord, BoardValueKind, BoardVec2, BoardVec2Schema, BoardVideoItem, BoardVideoItemSchema, GenerationRunPayload, IDENTITY_MATRIX, ModelFormat, RequestSource, RequestSourceVia, TaskRunStatus, anchorPoint, applyBoardDelta, applyBoardPatch, applyBoardPatchToDocument, applyMatrix, arrowBindings, autoAnchorSide, bendControl, boardItemSchema, boardJsonSchema, boardPatchTouches, boardSchemaOverview, boardTaskSource, clampBoardFontSize, clampBoardStrokeSize, createBoardLayout, createDocumentLayout, createDocumentState, diffBoardDocuments, diffMergePatch, drawPointsBounds, drawSampleRadius, emptyBoardDocument, estimateTextWidth, featuredTaskArtifact, framePoint, hasAuthoredSize, invertMatrix, isArrowBinding, isBoardColorString, isBoardEase, isBoardPath, isBuiltinItem, isBuiltinItemType, isEmptyBoardDelta, isEmptyBoardPatch, isFileBackedItem, isMediaItem, isPublicBoardRemoteAddress, isSafeBoardSourcePath, layoutBoardText, listBoardProperties, mergePatch, multiplyMatrix, normalizeBoardRemoteUrl, parseBoardDocument, parseBoardItem, parseBoardManifest, parseBoardMediaSource, pointsRect, pruneBoardTrack, rankedTaskArtifacts, resolveBoardProperty, rotateAround, scaleVector, serializeBoardManifest, setBoardTextMeasurer, sideAnchor, taskArtifactPreviewUrl, taskArtifacts, taskRunArtifacts, taskRunToBoardTaskSnapshot, trackReferences, withObservedArtifactFacts };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub",
-  "version": "11.3.1",
+  "version": "11.3.2",
   "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,