@neta-art/cohub 8.11.0 → 8.12.0

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

@@ -21,7 +21,11 @@ const BOARD_BUILTIN_CLIP_KINDS = [
 	"camera.focus",
 	"camera.shake"
 ];
-const BOARD_BUILTIN_EFFECT_KINDS = ["effects.pulse", "effects.float"];
+const BOARD_BUILTIN_EFFECT_KINDS = [
+	"effects.pulse",
+	"effects.float",
+	"effects.deal"
+];
 /**
 * World-space typography for board text.
 *
@@ -85,6 +89,20 @@ function clipSchema(id) {
 		default: return;
 	}
 }
+function effectSchema(id) {
+	switch (id) {
+		case "effects.deal": return { params: {
+			lift: { unit: "board" },
+			swing: { unit: "board" },
+			curve: { unit: "board" },
+			tilt: { unit: "degree" },
+			scale: { unit: "ratio" },
+			duration: { unit: "ms" },
+			landing: { unit: "ms" }
+		} };
+		default: return;
+	}
+}
 const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => {
 	const schema = clipSchema(id);
 	return {
@@ -94,11 +112,15 @@ const BOARD_BUILTIN_CAPABILITIES = [...BOARD_BUILTIN_CLIP_KINDS.map((id) => {
 		renderers: ["webgpu", "webgl"],
 		...schema ? { schema } : {}
 	};
-}), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => ({
-	kind: "effect",
-	id,
-	version: 1,
-	renderers: ["webgpu", "webgl"]
-}))];
+}), ...BOARD_BUILTIN_EFFECT_KINDS.map((id) => {
+	const schema = effectSchema(id);
+	return {
+		kind: "effect",
+		id,
+		version: 1,
+		renderers: ["webgpu", "webgl"],
+		...schema ? { schema } : {}
+	};
+})];
 //#endregion
 export { BOARD_ARROW_STROKE_SIZE, BOARD_BUILTIN_CAPABILITIES, BOARD_BUILTIN_CLIP_KINDS, BOARD_BUILTIN_EFFECT_KINDS, BOARD_CONNECTION_STROKE_SIZE, BOARD_FONT_STACK, BOARD_MONO_FONT_STACK, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BOARD_TEXT_FONT_FAMILY, DEFAULT_BOARD_RENDER_LIMITS, clampBoardStrokeSize };

package/dist/protocol/dist/board-document.d.ts

@@ -21,7 +21,21 @@ declare const BoardViewportSchema: z.ZodObject<{
   zoom: z.ZodNumber;
 }, z.core.$strip>;
 declare const BoardAppearanceSchema: z.ZodObject<{
-  theme: z.ZodDefault<z.ZodString>;
+  theme: z.ZodOptional<z.ZodString>;
+  motion: z.ZodOptional<z.ZodObject<{
+    enter: z.ZodOptional<z.ZodObject<{
+      kind: z.ZodString;
+      kindVersion: z.ZodDefault<z.ZodNumber>;
+      params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strict>>;
+  }, z.core.$strict>>;
+  mood: z.ZodOptional<z.ZodEnum<{
+    arcane: "arcane";
+    clean: "clean";
+    cyber: "cyber";
+    natural: "natural";
+    playful: "playful";
+  }>>;
   background: z.ZodDefault<z.ZodObject<{
     kind: z.ZodDefault<z.ZodEnum<{
       custom: "custom";
@@ -52,13 +66,6 @@ declare const BoardAppearanceSchema: z.ZodObject<{
     size: z.ZodDefault<z.ZodNumber>;
     opacity: z.ZodDefault<z.ZodNumber>;
   }, z.core.$strip>>;
-  mood: z.ZodDefault<z.ZodEnum<{
-    arcane: "arcane";
-    clean: "clean";
-    cyber: "cyber";
-    natural: "natural";
-    playful: "playful";
-  }>>;
 }, z.core.$strip>;
 /** Optional visual chrome still carried by a few older shapes. */
 declare const BoardItemStyleSchema: z.ZodObject<{
@@ -1046,7 +1053,21 @@ declare const BoardDocumentSchema: z.ZodObject<{
   kind: z.ZodLiteral<"cohub.board">;
   version: z.ZodLiteral<1>;
   appearance: z.ZodDefault<z.ZodObject<{
-    theme: z.ZodDefault<z.ZodString>;
+    theme: z.ZodOptional<z.ZodString>;
+    motion: z.ZodOptional<z.ZodObject<{
+      enter: z.ZodOptional<z.ZodObject<{
+        kind: z.ZodString;
+        kindVersion: z.ZodDefault<z.ZodNumber>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+      }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    mood: z.ZodOptional<z.ZodEnum<{
+      arcane: "arcane";
+      clean: "clean";
+      cyber: "cyber";
+      natural: "natural";
+      playful: "playful";
+    }>>;
     background: z.ZodDefault<z.ZodObject<{
       kind: z.ZodDefault<z.ZodEnum<{
         custom: "custom";
@@ -1077,13 +1098,6 @@ declare const BoardDocumentSchema: z.ZodObject<{
       size: z.ZodDefault<z.ZodNumber>;
       opacity: z.ZodDefault<z.ZodNumber>;
     }, z.core.$strip>>;
-    mood: z.ZodDefault<z.ZodEnum<{
-      arcane: "arcane";
-      clean: "clean";
-      cyber: "cyber";
-      natural: "natural";
-      playful: "playful";
-    }>>;
   }, z.core.$strip>>;
   viewport: z.ZodObject<{
     x: z.ZodNumber;

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

@@ -1,6 +1,7 @@
 import { BOARD_ARROW_STROKE_SIZE } from "./board-constants.js";
 import { BoardConnectionSchema } from "./board-connection.js";
 import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION } from "./board.js";
+import { BoardMotionSchema } from "./board-animation.js";
 import { BOARD_REMOTE_URL_MAX_LENGTH, BoardRemoteUrlSchema, isPublicBoardRemoteAddress, normalizeBoardRemoteUrl } from "./board-url.js";
 import { z } from "zod";
 //#region ../protocol/dist/board-document.js
@@ -23,7 +24,18 @@ const BoardViewportSchema = z.object({
 	zoom: z.number().finite().min(.05).max(8)
 });
 const BoardAppearanceSchema = z.object({
-	theme: z.string().min(1).default("clean"),
+	/** Legacy field retained when reading older Board documents; not used for rendering. */
+	theme: z.string().min(1).optional(),
+	/** Board-wide motion policies. Omitted policies mean no motion. */
+	motion: BoardMotionSchema.optional(),
+	/** Legacy field retained when reading older Board documents; not used for rendering. */
+	mood: z.enum([
+		"clean",
+		"playful",
+		"arcane",
+		"cyber",
+		"natural"
+	]).optional(),
 	background: z.object({
 		kind: z.enum([
 			"solid",
@@ -57,14 +69,7 @@ const BoardAppearanceSchema = z.object({
 		visible: false,
 		size: 24,
 		opacity: .12
-	}),
-	mood: z.enum([
-		"clean",
-		"playful",
-		"arcane",
-		"cyber",
-		"natural"
-	]).default("clean")
+	})
 });
 /** Optional visual chrome still carried by a few older shapes. */
 const BoardItemStyleSchema = z.object({
@@ -390,14 +395,12 @@ const BoardDocumentSchema = z.object({
 	kind: z.literal(BOARD_DOCUMENT_KIND),
 	version: z.literal(1),
 	appearance: BoardAppearanceSchema.default({
-		theme: "clean",
 		background: { kind: "solid" },
 		grid: {
 			visible: false,
 			size: 24,
 			opacity: .12
-		},
-		mood: "clean"
+		}
 	}),
 	viewport: BoardViewportSchema,
 	items: z.array(BoardItemSchema),

package/dist/protocol/dist/board-effect.d.ts

@@ -18,10 +18,11 @@ declare const BoardEffectSchema: z.ZodObject<{
     type: z.ZodLiteral<"board">;
   }, z.core.$strict>], "type">;
   kind: z.ZodString;
-  kindVersion: z.ZodNumber;
+  kindVersion: z.ZodDefault<z.ZodNumber>;
   enabled: z.ZodDefault<z.ZodBoolean>;
   lifecycle: z.ZodEnum<{
     manual: "manual";
+    "on-enter": "on-enter";
     persistent: "persistent";
     "when-visible": "when-visible";
   }>;
@@ -60,10 +61,11 @@ declare const BoardEffectInputSchema: z.ZodObject<{
     type: z.ZodLiteral<"board">;
   }, z.core.$strict>], "type">;
   kind: z.ZodString;
-  kindVersion: z.ZodNumber;
+  kindVersion: z.ZodDefault<z.ZodNumber>;
   enabled: z.ZodDefault<z.ZodBoolean>;
   lifecycle: z.ZodEnum<{
     manual: "manual";
+    "on-enter": "on-enter";
     persistent: "persistent";
     "when-visible": "when-visible";
   }>;

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

@@ -21,12 +21,13 @@ const BoardEffectSchema = z.object({
 		itemId: idSchema
 	}).strict(), z.object({ type: z.literal("board") }).strict()]),
 	kind: extensionIdSchema,
-	kindVersion: z.number().int().positive(),
+	kindVersion: z.number().int().positive().default(1),
 	enabled: z.boolean().default(true),
 	lifecycle: z.enum([
 		"persistent",
 		"when-visible",
-		"manual"
+		"manual",
+		"on-enter"
 	]),
 	timeOrigin: z.enum([
 		"board",

package/dist/protocol/dist/board.d.ts

@@ -1,8 +1,9 @@
 import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./board-constants.js";
-import "./board-connection.js";
-import "./board-composition.js";
+import { BoardConnectionInput, BoardConnectionPatch, BoardConnectionRecord } from "./board-connection.js";
+import { BoardComposition } from "./board-composition.js";
 import { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema } from "./board-effect.js";
 import "./board-authoring.js";
+import { RequestSource } from "./provenance.js";
 import { z } from "zod";
 //#region ../protocol/dist/board.d.ts
 declare const BOARD_EXTENSION: ".board";
@@ -69,6 +70,108 @@ declare const BoardCameraFocusParamsSchema: z.ZodObject<{
 type BoardCameraState = z.infer<typeof BoardCameraStateSchema>;
 type BoardCameraFocus = z.infer<typeof BoardCameraFocusSchema>;
 type BoardCameraFocusParams = z.infer<typeof BoardCameraFocusParamsSchema>;
+type BoardRecord = {
+  id: string;
+  spaceId: string;
+  title: string;
+  version: number;
+  metadata: Record<string, unknown>;
+  createdAt: string | null;
+  updatedAt: string | null;
+};
+type BoardNodeRecord = {
+  boardId: string;
+  nodeId: string;
+  type: string;
+  parentId: string | null;
+  orderKey: string | null;
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  rotation: number;
+  refKind: string | null;
+  refPath: string | null;
+  refUrl: string | null;
+  view: Record<string, unknown>;
+  style: Record<string, unknown>;
+  data: Record<string, unknown>;
+  version: number;
+  createdAt: string | null;
+  updatedAt: string | null;
+};
+type BoardNodeInput = Omit<BoardNodeRecord, "boardId" | "version" | "createdAt" | "updatedAt">;
+declare const BOARD_DELETE_REASONS: readonly ["user-delete", "orphan-cleanup", "layout-replace", "placeholder-cascade", "node-cascade"];
+type BoardDeleteReason = (typeof BOARD_DELETE_REASONS)[number] | (string & {});
+type BoardOperationBase = {
+  opId?: string;
+  /** Optional local undo hint. Servers recompute authoritative inverse data. */
+  inverse?: Record<string, unknown>;
+};
+type BoardOperation = (BoardOperationBase & {
+  type: "board.patch";
+  payload: {
+    patch: {
+      title?: string;
+      metadata?: Record<string, unknown>;
+      metadataPatch?: Record<string, unknown>;
+    };
+  };
+}) | (BoardOperationBase & {
+  type: "node.create";
+  payload: {
+    node: BoardNodeInput;
+  };
+}) | (BoardOperationBase & {
+  type: "node.patch";
+  payload: {
+    nodeId: string;
+    patch: Partial<BoardNodeInput>;
+  };
+}) | (BoardOperationBase & {
+  type: "node.delete";
+  payload: {
+    nodeId: string;
+    reason?: BoardDeleteReason;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.create";
+  payload: {
+    connection: BoardConnectionInput;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.patch";
+  payload: {
+    connectionId: string;
+    patch: BoardConnectionPatch;
+  };
+}) | (BoardOperationBase & {
+  type: "connection.delete";
+  payload: {
+    connectionId: string;
+    reason?: BoardDeleteReason;
+  };
+}) | (BoardOperationBase & {
+  type: "effect.upsert";
+  payload: {
+    effect: Omit<BoardEffect, "boardId" | "revision">;
+  };
+}) | (BoardOperationBase & {
+  type: "effect.delete";
+  payload: {
+    effectId: string;
+  };
+}) | (BoardOperationBase & {
+  type: "composition.apply";
+  payload: {
+    composition: Omit<BoardComposition, "revision">;
+  };
+}) | (BoardOperationBase & {
+  type: "composition.delete";
+  payload: {
+    compositionId: string;
+  };
+});
 type BoardMutationReceipt = {
   mutationId: string;
   status: "applied" | "validated";
@@ -103,6 +206,48 @@ type BoardValidationResult = {
   diagnostics: BoardDiagnostic[];
   peakCost: BoardRenderCost;
 };
+/**
+ * One applied Board transaction as recorded in the log, with the server-computed
+ * inverse of every operation. Read-only: replay walks the log in either
+ * direction without touching Board rows.
+ */
+type BoardTransactionRecord = {
+  id: string;
+  txId: string;
+  baseVersion: number;
+  /** Board version this transaction produced. */
+  version: number;
+  actorId: string;
+  clientId: string | null;
+  undoGroupId: string | null;
+  source: RequestSource | null;
+  createdAt: string;
+  operations: BoardTransactionOperation[];
+};
+type BoardTransactionOperation = {
+  type: BoardOperation["type"];
+  payload: Record<string, unknown>;
+  inverse: Record<string, unknown> | null;
+};
+/**
+ * A page of the transaction log, newest first. The newest page (no `before`)
+ * carries the current rows unless `snapshot=false`, so a replay can start from
+ * the live state and walk inverses backwards; older pages carry transactions only.
+ */
+type BoardTransactionsPage = {
+  board: {
+    id: string;
+    version: number;
+  };
+  transactions: BoardTransactionRecord[];
+  /** Version to pass as `before` for the next older page, or null when exhausted. */
+  nextBefore: number | null;
+  snapshot?: {
+    board: BoardRecord;
+    nodes: BoardNodeRecord[];
+    connections: BoardConnectionRecord[];
+  };
+};
 type BoardPlaybackStatus = "playing" | "paused" | "stopped";
 type BoardPlaybackSnapshot = {
   boardId: string;
@@ -118,4 +263,4 @@ type BoardPlaybackSnapshot = {
 };
 declare function isBoardPath(path: string): boolean;
 //#endregion
-export { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, type BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardDiagnostic, type BoardEffect, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, type BoardRenderCost, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest };
+export { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, type BoardAssetRef, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, type BoardCapability, BoardDeleteReason, BoardDiagnostic, type BoardEffect, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardRecord, type BoardRenderCost, BoardTransactionOperation, BoardTransactionRecord, BoardTransactionsPage, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/board.js

@@ -159,6 +159,13 @@ z.object({
 		height: finiteSchema.positive()
 	}).optional()
 });
+z.object({
+	/** Return transactions with `version < before`. Omit for the newest page. */
+	before: z.number().int().positive().optional(),
+	limit: z.number().int().min(1).max(500).default(200),
+	/** Include the current rows on the newest page (default true). Tail refreshes turn this off. */
+	snapshot: z.boolean().default(true)
+});
 z.object({
 	compositionId: idSchema,
 	/** Delay before the first local playback after opening the Board, in milliseconds. */

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

@@ -3,7 +3,9 @@ import { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNEC
 import { BoardAnimationTarget, BoardAnimationTargetSchema, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardEasing, BoardEasingSchema, BoardProceduralClip, BoardProceduralClipSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema } from "./board-composition.js";
 import { BoardAssetRef, BoardAssetRefSchema, BoardEffect, BoardEffectInput, BoardEffectInputSchema, BoardEffectSchema } from "./board-effect.js";
 import { BoardAuthoringItem, BoardAuthoringItemSchema, BoardAuthoringSnapshot, BoardSemanticCommand, BoardSemanticCommandSchema } from "./board-authoring.js";
-import { BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardDiagnostic, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import { RequestSource, RequestSourceVia } from "./provenance.js";
+import { BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardDeleteReason, BoardDiagnostic, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardRecord, BoardTransactionOperation, BoardTransactionRecord, BoardTransactionsPage, BoardValidationResult, isBoardPath, parseBoardManifest, serializeBoardManifest } from "./board.js";
+import "./board-animation.js";
 import "./board-capability-registry.js";
 import { BOARD_COLOR_IDS, BOARD_GEO_KINDS, BoardColorId, BoardGeoKind } from "./board-node.js";
 import "./board-codec.js";
@@ -13,4 +15,4 @@ import "./realtime/board-awareness.js";
 import "./app.js";
 import "./realtime/types.js";
 import "./app-catalog.js";
-export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAnimationTarget, BoardAnimationTargetSchema, BoardArrowGeometryInput, type BoardAssetRef, BoardAuthoringItem, BoardAuthoringItemSchema, BoardAuthoringSnapshot, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardCapability, BoardColorId, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDiagnostic, BoardEasing, BoardEasingSchema, type BoardEffect, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardProceduralClip, BoardProceduralClipSchema, BoardRelationSchema, BoardRenderCost, BoardSemanticCommand, BoardSemanticCommandSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, boardArrowFrame, boardDrawBounds, boardDrawSampleRadius, clampBoardStrokeSize, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };
+export { AUTO_BOARD_CONNECTION_ANCHOR, BOARD_COLOR_IDS, BOARD_CONNECTION_DIRECTIONS, BOARD_CONNECTION_LINES, BOARD_CONNECTION_ROUTINGS, BOARD_CONNECTION_SIDES, BOARD_DELETE_REASONS, BOARD_DOCUMENT_KIND, BOARD_EXTENSION, BOARD_GEO_KINDS, BOARD_STROKE_MAX_SIZE, BOARD_STROKE_MIN_SIZE, BoardAnimationTarget, BoardAnimationTargetSchema, BoardArrowGeometryInput, type BoardAssetRef, BoardAuthoringItem, BoardAuthoringItemSchema, BoardAuthoringSnapshot, BoardCameraFocus, BoardCameraFocusParams, BoardCameraFocusParamsSchema, BoardCameraFocusSchema, BoardCameraState, BoardCameraStateSchema, BoardCapability, BoardColorId, BoardComposition, BoardCompositionInput, BoardCompositionInputSchema, BoardCompositionSchema, BoardConnection, BoardConnectionAnchor, BoardConnectionAnchorSchema, BoardConnectionDirection, BoardConnectionEndpoint, BoardConnectionEndpointSchema, BoardConnectionInput, BoardConnectionLine, BoardConnectionPatch, BoardConnectionPatchSchema, BoardConnectionRecord, BoardConnectionRouting, BoardConnectionRoutingConfig, BoardConnectionRoutingSchema, BoardConnectionSchema, BoardConnectionSide, BoardConnectionStyle, BoardConnectionStyleSchema, BoardConnectionWaypointSchema, BoardDeleteReason, BoardDiagnostic, BoardEasing, BoardEasingSchema, type BoardEffect, BoardGeoKind, BoardManifest, BoardManifestSchema, BoardMutationReceipt, BoardNodeInput, BoardNodeRecord, BoardOperation, BoardPlaybackSnapshot, BoardPlaybackStatus, BoardProceduralClip, BoardProceduralClipSchema, BoardRecord, BoardRelationSchema, BoardRenderCost, BoardSemanticCommand, BoardSemanticCommandSchema, BoardTimelineMarker, BoardTimelineMarkerSchema, BoardTrack, BoardTrackInterpolation, BoardTrackSchema, BoardTransactionOperation, BoardTransactionRecord, BoardTransactionsPage, BoardValidationResult, DEFAULT_BOARD_CONNECTION_ROUTING, DEFAULT_BOARD_CONNECTION_STYLE, DEFAULT_BOARD_RELATION, RequestSource, RequestSourceVia, boardArrowFrame, boardDrawBounds, boardDrawSampleRadius, clampBoardStrokeSize, connectionItemIds, connectionOtherItemId, connectionTouchesItem, createBoardConnection, flipBoardConnection, isBoardPath, normalizeBoardConnectionStyle, parseBoardManifest, serializeBoardManifest };

package/dist/protocol/dist/provenance.d.ts

@@ -0,0 +1,21 @@
+//#region ../protocol/dist/provenance.d.ts
+type RequestSourceVia = "cli" | "bash" | "tool" | "api" | "web" | (string & {});
+/** Caller context: via (channel) and optional identity fields. */
+type RequestSource = {
+  spaceId?: string;
+  sessionId?: string;
+  turnId?: string;
+  toolCallId?: string;
+  /**
+   * Logical id of the frontend instance that originated this chain of work.
+   * Survives reloads and WebSocket reconnects, and is distinct per browser tab.
+   * Used to route UI commands back to the originating client. Routing hint only
+   * — never an authorization input.
+   */
+  clientId?: string;
+  /** Untrusted provenance hint derived from the Sandbox runtime environment. */
+  sandboxVersion?: string;
+  via?: RequestSourceVia;
+};
+//#endregion
+export { RequestSource, RequestSourceVia };

package/dist/types.d.ts

@@ -2,7 +2,7 @@ import { BoardCapability, BoardCoordinateSpace, BoardRenderCost } from "./protoc
 import { BoardAnimationTarget, BoardComposition, BoardEasing, BoardProceduralClip, BoardTimelineMarker, BoardTrack } from "./protocol/dist/board-composition.js";
 import { BoardAssetRef, BoardEffect, BoardEffectInput } from "./protocol/dist/board-effect.js";
 import { BoardAuthoringItem, BoardAuthoringSnapshot, BoardSemanticCommand } from "./protocol/dist/board-authoring.js";
-import { BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardDiagnostic, BoardManifest, BoardMutationReceipt, BoardPlaybackSnapshot, BoardValidationResult } from "./protocol/dist/board.js";
+import { BoardCameraFocus, BoardCameraFocusParams, BoardCameraState, BoardDiagnostic, BoardManifest, BoardMutationReceipt, BoardPlaybackSnapshot, BoardRecord, BoardTransactionOperation, BoardTransactionRecord, BoardTransactionsPage, BoardValidationResult } from "./protocol/dist/board.js";
 import "./protocol/dist/index.js";
 //#region src/types.d.ts
 type UserProfile = {

package/docs/app-runtime-guide.md

@@ -282,8 +282,9 @@ if (created.granted && created.space) {
 Pass `alwaysAsk: true` to skip silent reuse and force a fresh dialog — for
 re-confirming a grant or letting the viewer switch to another Space.
 `requestCreateSpace` always opens the dialog; each confirm mints a new Space.
-The host creates it with the viewer's account token — the app never calls
-`POST /api/spaces` itself.
+The host creates it with the viewer's account token. An App can also create a
+viewer-owned Space directly with `client.spaces.create()` once it holds a
+`space.create` viewer grant.
 
 ### Checking grant state at runtime
 
@@ -339,6 +340,7 @@ dialog can.
 | List tasks in a Space | `client.tasks.list({ spaceId })` | `taskrun.view` on that Space | app or viewer |
 | List all owned task runs | `client.tasks.list()` | `user.taskrun.list` | **viewer only** |
 | Create a Space for the viewer | `client.auth.requestCreateSpace({ space, scopes })` | requested scopes on the new Space | **viewer consent** |
+| Create a viewer-owned Space directly | `client.spaces.create(input)` | `space.create` | **viewer only** |
 | List viewer's spaces | `client.spaces.list()` | `user.space.list` | **viewer only** |
 | List viewer's sessions | `client.user.listSessions()` | `user.session.list` | **viewer only** |
 | Read viewer's activity | `client.user.getActivity()` | `user.usage.read` | **viewer only** |
@@ -1225,8 +1227,9 @@ Before publishing your App, verify each item:
   on page load. It is safe to call repeatedly — covered scopes renew silently.
 - [ ] **Cross-Space access targets the right Space** — viewer grants are per
   Space. Pass `spaceId` when requesting, or use `auth.requestSpace` to let the
-  viewer pick. Use `auth.requestCreateSpace` when the app should mint a new
-  viewer-owned Space; do not call `spaces.create()` with the App token.
+  viewer pick. Use `auth.requestCreateSpace` to mint a new viewer-owned Space
+  in one consent, or `spaces.create()` directly once the app holds a
+  `space.create` viewer grant.
 - [ ] **`subscribeGeneration` errors are not silently swallowed** — if the
   stream fails, surface it; a silent fallback to polling will also 403 if
   `session.view` is missing.

package/package.json

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

package/dist/board/render/themes/board-theme-registry.d.ts

@@ -1,22 +0,0 @@
-import { BoardDocument, BoardViewport } from "../../../protocol/dist/board-document.js";
-import { BoardRenderPalette } from "../renderers/board-renderer-registry.js";
-import { Application, Container } from "pixi.js";
-//#region src/board/render/themes/board-theme-registry.d.ts
-type BoardThemeContext = {
-  app: Application;
-  document: BoardDocument;
-  viewport: BoardViewport;
-  palette: BoardRenderPalette;
-  /** The host renders an image backdrop below the transparent Pixi canvas. */
-  hasImageBackground?: boolean;
-};
-type BoardThemeRenderer = {
-  id: string;
-  canRender: (document: BoardDocument) => boolean;
-  createBackground: (context: BoardThemeContext) => Container;
-  updateBackground?: (container: Container, context: BoardThemeContext) => void;
-};
-declare function getBoardThemeRenderer(document: BoardDocument): BoardThemeRenderer;
-declare function registerBoardThemeRenderer(renderer: BoardThemeRenderer): void;
-//#endregion
-export { BoardThemeContext, BoardThemeRenderer, getBoardThemeRenderer, registerBoardThemeRenderer };

package/dist/board/render/themes/board-theme-registry.js

@@ -1,13 +0,0 @@
-import { cleanBoardTheme } from "./clean-theme.js";
-//#region src/board/render/themes/board-theme-registry.ts
-const boardThemeRenderers = [cleanBoardTheme];
-function getBoardThemeRenderer(document) {
-	return boardThemeRenderers.find((renderer) => renderer.canRender(document)) ?? cleanBoardTheme;
-}
-function registerBoardThemeRenderer(renderer) {
-	const existingIndex = boardThemeRenderers.findIndex((candidate) => candidate.id === renderer.id);
-	if (existingIndex >= 0) boardThemeRenderers.splice(existingIndex, 1, renderer);
-	else boardThemeRenderers.unshift(renderer);
-}
-//#endregion
-export { getBoardThemeRenderer, registerBoardThemeRenderer };

package/dist/board/render/themes/clean-theme.d.ts

@@ -1,5 +0,0 @@
-import { BoardThemeRenderer } from "./board-theme-registry.js";
-//#region src/board/render/themes/clean-theme.d.ts
-declare const cleanBoardTheme: BoardThemeRenderer;
-//#endregion
-export { cleanBoardTheme };