@neta-art/cohub 3.0.0 → 3.2.0

package/dist/protocol/dist/board.js

@@ -0,0 +1,207 @@
+import "./board-constants.js";
+import { z } from "zod";
+//#region ../protocol/dist/board.js
+const BOARD_EXTENSION = ".board";
+const BOARD_DOCUMENT_KIND = "cohub.board";
+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();
+const BoardManifestSchema = z.object({
+	kind: z.literal(BOARD_MANIFEST_KIND),
+	version: z.literal(1),
+	boardId: z.string().uuid(),
+	title: z.string().min(1).max(255)
+});
+var InvalidBoardFileError = class extends Error {
+	code = "INVALID_BOARD_FILE";
+	constructor(message = "Board file is invalid") {
+		super(message);
+		this.name = "InvalidBoardFileError";
+	}
+};
+function parseBoardManifest(input) {
+	let value = input;
+	if (typeof input === "string") try {
+		value = JSON.parse(input);
+	} catch {
+		throw new InvalidBoardFileError("Board file must contain valid JSON");
+	}
+	const parsed = BoardManifestSchema.safeParse(value);
+	if (!parsed.success) throw new InvalidBoardFileError("Board file must contain a valid boardId");
+	return parsed.data;
+}
+function serializeBoardManifest(manifest) {
+	return `${JSON.stringify(BoardManifestSchema.parse(manifest), null, 2)}\n`;
+}
+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),
+	title: z.string().min(1).max(255).optional(),
+	nodes: z.array(BoardNodeInputSchema).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",
+		"effects",
+		"sequences",
+		"clips",
+		"playback"
+	])).optional(),
+	viewport: z.object({
+		x: finiteSchema,
+		y: finiteSchema,
+		width: finiteSchema.positive(),
+		height: finiteSchema.positive()
+	}).optional()
+});
+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()
+	})
+]);
+function isBoardPath(path) {
+	return path.toLowerCase().endsWith(BOARD_EXTENSION);
+}
+//#endregion
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

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

@@ -0,0 +1,5 @@
+import { BoardCapability, BoardRenderCost } from "./board-constants.js";
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardClip, BoardClipSchema, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import "./realtime/board-awareness.js";
+import "./realtime/types.js";
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardAssetRef, BoardAssetRefSchema, BoardClip, BoardClipSchema, BoardDiagnostic, BoardEffect, BoardEffectSchema, BoardManifest, BoardManifestSchema, BoardNodeInput, BoardNodeRecord, BoardRecord, BoardSequence, BoardSequenceSchema, BoardTarget, BoardTargetSchema, BoardValidationResult, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/index.js

@@ -0,0 +1,5 @@
+import "./board-constants.js";
+import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema } from "./realtime/board-awareness.js";
+import { COHUB_SOURCE_HEADER } from "./provenance.js";
+export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_MANIFEST_KIND, BoardAssetRefSchema, BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema, BoardClipSchema, BoardEffectSchema, BoardKeyframeSchema, BoardManifestSchema, BoardNodeInputSchema, BoardSequenceSchema, BoardTargetSchema, COHUB_SOURCE_HEADER, InvalidBoardFileError, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/provenance.js

@@ -0,0 +1,12 @@
+//#region ../protocol/dist/provenance.js
+/** Request provenance via X-Cohub-Source-* headers. Never used for authorization. */
+const COHUB_SOURCE_HEADER = {
+	space: "X-Cohub-Source-Space",
+	session: "X-Cohub-Source-Session",
+	turn: "X-Cohub-Source-Turn",
+	toolCall: "X-Cohub-Source-Tool-Call",
+	via: "X-Cohub-Source-Via"
+};
+Object.values(COHUB_SOURCE_HEADER);
+//#endregion
+export { COHUB_SOURCE_HEADER };

package/dist/protocol/dist/realtime/board-awareness.d.ts

@@ -0,0 +1 @@
+import { z } from "zod";

package/dist/protocol/dist/realtime/board-awareness.js

@@ -0,0 +1,117 @@
+import { z } from "zod";
+//#region ../protocol/dist/realtime/board-awareness.js
+const idSchema = z.string().min(1).max(160);
+const finiteSchema = z.number().finite();
+const BoardAwarenessPointSchema = z.object({
+	x: finiteSchema,
+	y: finiteSchema
+});
+const BoardAwarenessDrawPointSchema = BoardAwarenessPointSchema.extend({ p: finiteSchema.min(0).max(1) });
+const BoardAwarenessFrameSchema = z.object({
+	x: finiteSchema,
+	y: finiteSchema,
+	width: finiteSchema.positive(),
+	height: finiteSchema.positive(),
+	rotation: finiteSchema
+});
+const arrowEndpointSchema = z.union([z.object({
+	kind: z.literal("point"),
+	x: finiteSchema,
+	y: finiteSchema
+}), z.object({
+	kind: z.literal("binding"),
+	target: idSchema,
+	nx: finiteSchema,
+	ny: finiteSchema,
+	precise: z.boolean()
+})]);
+const BoardAwarenessNodePreviewSchema = z.object({
+	nodeId: idSchema,
+	frame: BoardAwarenessFrameSchema,
+	arrow: z.object({
+		start: arrowEndpointSchema,
+		end: arrowEndpointSchema,
+		bend: finiteSchema
+	}).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).max(64),
+		count: z.number().int().nonnegative().max(5e4),
+		bounds: BoardAwarenessFrameSchema.nullable()
+	}),
+	editingId: idSchema.nullable()
+});
+const BoardAwarenessGestureSchema = z.discriminatedUnion("kind", [
+	z.object({
+		kind: z.literal("draw"),
+		id: idSchema,
+		nodeId: idSchema,
+		color: z.string().min(1).max(64),
+		size: finiteSchema.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,
+		nodeId: idSchema,
+		start: BoardAwarenessPointSchema,
+		current: BoardAwarenessPointSchema,
+		color: z.string().min(1).max(64)
+	}),
+	z.object({
+		kind: z.literal("box"),
+		id: idSchema,
+		nodeId: idSchema,
+		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("transform"),
+		id: idSchema,
+		mode: z.enum([
+			"translate",
+			"resize",
+			"rotate",
+			"arrow"
+		]),
+		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,
+		resultingNodeIds: z.array(idSchema).max(64)
+	}),
+	z.object({
+		type: z.literal("gesture.cancel"),
+		gestureId: idSchema
+	})
+]);
+z.object({
+	spaceId: z.string().uuid(),
+	boardId: z.string().uuid(),
+	seq: z.number().int().nonnegative(),
+	update: BoardAwarenessUpdateSchema
+});
+//#endregion
+export { BoardAwarenessDrawPointSchema, BoardAwarenessFrameSchema, BoardAwarenessGestureSchema, BoardAwarenessNodePreviewSchema, BoardAwarenessPointSchema, BoardAwarenessStateUpdateSchema, BoardAwarenessUpdateSchema };

package/dist/protocol/dist/realtime/types.d.ts

@@ -0,0 +1,2 @@
+import "../board.js";
+import "./board-awareness.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@neta-art/cohub",
-  "version": "3.0.0",
-  "description": "Cohub SDK for spaces, sessions, checkpoints, and realtime agent collaboration.",
+  "version": "3.2.0",
+  "description": "Cohub SDK for spaces, sessions, boards, and realtime agent collaboration.",
   "license": "Apache-2.0",
   "private": false,
   "type": "module",
@@ -46,8 +46,20 @@
       "import": "./dist/debugger.js"
     },
     "./board": {
-      "types": "./dist/board.d.ts",
-      "import": "./dist/board.js"
+      "types": "./dist/board/index.d.ts",
+      "import": "./dist/board/index.js"
+    },
+    "./board/render": {
+      "types": "./dist/board/render/index.d.ts",
+      "import": "./dist/board/render/index.js"
+    },
+    "./board/export": {
+      "types": "./dist/board/export/index.d.ts",
+      "import": "./dist/board/export/index.js"
+    },
+    "./board/headless": {
+      "types": "./dist/board/headless/index.d.ts",
+      "import": "./dist/board/headless/index.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -58,13 +70,36 @@
     "LICENSE",
     "NOTICE"
   ],
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
   "devDependencies": {
+    "@biomejs/biome": "2.5.3",
+    "@napi-rs/canvas": "^1.0.2",
+    "@types/node": "26.1.1",
+    "pixi.js": "^8.19.0",
     "tsdown": "^0.22.7",
+    "tsx": "4.23.1",
     "typescript": "^7.0.2",
     "@cohub/protocol": "2.0.0"
   },
+  "peerDependencies": {
+    "@napi-rs/canvas": "^1.0.2",
+    "pixi.js": "^8.19.0"
+  },
+  "peerDependenciesMeta": {
+    "@napi-rs/canvas": {
+      "optional": true
+    },
+    "pixi.js": {
+      "optional": true
+    }
+  },
   "scripts": {
     "build": "tsdown",
+    "lint": "biome lint .",
+    "lint:fix": "biome lint --write .",
+    "test": "tsx --test 'src/**/*.test.ts' 'tests/**/*.test.ts'",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   }
 }

package/dist/board.js

@@ -1,2 +0,0 @@
-import { a as createBoardExtensionRegistry, i as compileSequence, n as DEFAULT_BOARD_LIMITS, o as timeline, r as clip, t as BoardExtensionRegistry } from "./chunks/board.js";
-export { BoardExtensionRegistry, DEFAULT_BOARD_LIMITS, clip, compileSequence, createBoardExtensionRegistry, timeline };