agentic-canvas 0.6.0 → 0.6.1

package/README.md

@@ -279,12 +279,20 @@ Every name that each entry point exports is listed here. A name marked (type) ex
 | `FlowGraph` (type), `FlowNode` (type), `FlowEdge` (type), `Placement` (type), `DrawOptions` (type) | Types for a flow and its layout. |
 | `readBoard`, `BoardData` (type), `NodeData` (type), `EdgeData` (type) | Read a board as plain data. |
 | `toSvg(board)`, `svgToPng(svg)` | `toSvg` returns the board as SVG. `svgToPng` turns an SVG string into PNG through Chromium. |
-| `PRINCIPAL_KINDS`, `PrincipalKind` (type), `Principal` (type), `principalSchema`, `isMachineMade` | The principal kinds, the schema of a principal, and the rule that marks machine-made kinds. |
+| `PRINCIPAL_KINDS`, `PrincipalKind` (type), `Principal` (type), `principalSchema`, `isMachineMade` | The principal kinds, the schema of a principal, and the rule that marks machine-made kinds. `principalSchema` uses the identity rule below. |
 | `operatorActor(env?)`, `ActorConfigError` | Read the actor from `CANVAS_ACTOR` as `<kind>:<id>`. It throws `ActorConfigError` when the value is missing or bad. |
 | `CanvasService` | The board operations that the CLI, the MCP server and the Worker share. It takes a `Store`. |
 | `createMcpServer(service, actor)`, `runMcp(service, actor)` | Make the MCP server, or run it on stdio. |
 | `createFileStore`, `openLocalStore`, `FileStoreOptions` (type) | Stores on one local file. See `agentic-canvas/file-store`. |
 
+### Actor ids
+
+One rule names an actor in every new write, in the SDK, the CLI, the MCP server and the Worker. The kind must be
+one of `PRINCIPAL_KINDS`. The id has 1 to 128 characters from `A-Z`, `a-z`, `0-9`, `.`, `_` and `-`, and starts
+with a letter, digit, `_` or `-`. The rule comes from `parsePrincipal` in `agentic-identity`. A write with another
+id fails with `INVALID`. A board that was stored with an older, looser id (up to 200 characters) still opens. The
+old author stays on its elements. Only new writes follow the strict rule.
+
 ### `agentic-canvas/client`
 
 | Name | What it is |

package/dist/{chunk-G4YTESPS.js → chunk-66FFQMHI.js}

@@ -7,10 +7,10 @@ import {
   drawFlow,
   readBoard,
   toSvg
-} from "./chunk-JCYNPYYJ.js";
+} from "./chunk-ZSPZMGHG.js";
 import {
   principalSchema
-} from "./chunk-SPP6PINW.js";
+} from "./chunk-JOBTIAFJ.js";
 
 // src/service.ts
 import * as Y from "yjs";

package/dist/chunk-JOBTIAFJ.js

@@ -0,0 +1,19 @@
+// src/core/principal.ts
+import { PRINCIPAL_KINDS, isMachineMade, parsePrincipal } from "agentic-identity";
+import { z } from "zod";
+var principalSchema = z.object({ kind: z.string(), id: z.string() }).strict().transform((value, ctx) => {
+  try {
+    return parsePrincipal(value);
+  } catch (error) {
+    ctx.addIssue({ code: "custom", message: error instanceof Error ? error.message : "invalid principal" });
+    return z.NEVER;
+  }
+});
+var storedPrincipalSchema = z.object({ kind: z.enum(PRINCIPAL_KINDS), id: z.string().min(1).max(200) }).strict();
+
+export {
+  PRINCIPAL_KINDS,
+  isMachineMade,
+  principalSchema,
+  storedPrincipalSchema
+};

package/dist/{chunk-BIIC2DPZ.js → chunk-PH67TSYW.js}

@@ -1,10 +1,10 @@
 import {
   CanvasService,
   MAX_LIVE_BYTES
-} from "./chunk-G4YTESPS.js";
+} from "./chunk-66FFQMHI.js";
 import {
   CanvasError
-} from "./chunk-JCYNPYYJ.js";
+} from "./chunk-ZSPZMGHG.js";
 
 // src/worker.ts
 import { hasScope, parsePrincipal, parseRegion } from "agentic-identity";

package/dist/{chunk-SIDWRC3P.js → chunk-VFJJGXTK.js}

@@ -1,14 +1,14 @@
 import {
   CanvasError,
   SHAPE_TYPES
-} from "./chunk-JCYNPYYJ.js";
+} from "./chunk-ZSPZMGHG.js";
 import {
   PRINCIPAL_KINDS
-} from "./chunk-SPP6PINW.js";
+} from "./chunk-JOBTIAFJ.js";
 
 // src/version.ts
 import { createRequire } from "module";
-var VERSION = true ? "0.6.0" : readPackageVersion();
+var VERSION = true ? "0.6.1" : readPackageVersion();
 
 // src/brand.ts
 var BRAND = {

package/dist/{chunk-JCYNPYYJ.js → chunk-ZSPZMGHG.js}

@@ -1,7 +1,8 @@
 import {
   isMachineMade,
-  principalSchema
-} from "./chunk-SPP6PINW.js";
+  principalSchema,
+  storedPrincipalSchema
+} from "./chunk-JOBTIAFJ.js";
 
 // src/core/board.ts
 import { randomUUID } from "crypto";
@@ -58,8 +59,8 @@ var stampFields = {
   id,
   z: z.number().finite().min(-MAX_Z).max(MAX_Z),
   groupId: id.optional(),
-  author: principalSchema,
-  editedBy: principalSchema
+  author: storedPrincipalSchema,
+  editedBy: storedPrincipalSchema
 };
 var storedShape = z.object({ ...stampFields, type: z.enum(SHAPE_TYPES), x: coord, y: coord, w: size, h: size, text, fill: color.optional(), stroke: color.optional(), src: imageSrc.optional() }).refine((s) => s.type === "image" === (s.src !== void 0), { message: "src is required for image shapes and allowed on no other type" });
 var storedConnector = z.object({
@@ -129,7 +130,7 @@ var Board = class _Board {
     return value.success ? value.data : "";
   }
   get titleBy() {
-    const value = principalSchema.safeParse(this.meta.get("titleBy"));
+    const value = storedPrincipalSchema.safeParse(this.meta.get("titleBy"));
     return value.success ? value.data : void 0;
   }
   setTitle(title, actor) {

package/dist/cli.js

@@ -5,18 +5,18 @@ import {
   operatorActor,
   runMcp,
   svgToPng
-} from "./chunk-SIDWRC3P.js";
+} from "./chunk-VFJJGXTK.js";
 import {
   openLocalStore
 } from "./chunk-UKST5A57.js";
 import {
   CanvasService
-} from "./chunk-G4YTESPS.js";
+} from "./chunk-66FFQMHI.js";
 import "./chunk-NWQED42L.js";
 import {
   CanvasError
-} from "./chunk-JCYNPYYJ.js";
-import "./chunk-SPP6PINW.js";
+} from "./chunk-ZSPZMGHG.js";
+import "./chunk-JOBTIAFJ.js";
 
 // src/cli.ts
 import { readFileSync, writeFileSync } from "fs";

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { E as ErrorCode, a as BoardData, c as ShapeType, S as Shape, d as Endpoint, C as Connector } from './read-BupIJSPJ.js';
+import { E as ErrorCode, a as BoardData, c as ShapeType, S as Shape, d as Endpoint, C as Connector } from './read-CeWoSAAy.js';
 import { PrincipalKind } from 'agentic-identity';
 import 'yjs';
 import 'zod';

package/dist/embed.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { CanvasClient } from './client.js';
 import { PrincipalKind } from 'agentic-identity';
-import './read-BupIJSPJ.js';
+import './read-CeWoSAAy.js';
 import 'yjs';
 import 'zod';
 

package/dist/embed.js

@@ -1,6 +1,6 @@
 import {
   PRINCIPAL_KINDS
-} from "./chunk-SPP6PINW.js";
+} from "./chunk-JOBTIAFJ.js";
 
 // ui/embed.tsx
 import { ToastProvider, TooltipProvider } from "agentic-design/react";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { B as Board, P as Principal } from './read-BupIJSPJ.js';
-export { a as BoardData, b as CanvasElement, e as CanvasError, C as Connector, f as EdgeData, d as Endpoint, E as ErrorCode, G as Group, M as MAX_ELEMENTS, g as MAX_TEXT, N as NodeData, h as SHAPE_TYPES, S as Shape, c as ShapeType, p as principalSchema, r as readBoard } from './read-BupIJSPJ.js';
-import { B as BoardAccess } from './service-CR4-r1yx.js';
-export { C as CanvasService, D as DrawOptions, F as FlowEdge, a as FlowGraph, b as FlowNode, M as MAX_FLOW_EDGES, c as MAX_FLOW_NODES, P as Placement, d as drawFlow, l as layoutFlow, p as parseFlow } from './service-CR4-r1yx.js';
+import { B as Board, P as Principal } from './read-CeWoSAAy.js';
+export { a as BoardData, b as CanvasElement, e as CanvasError, C as Connector, f as EdgeData, d as Endpoint, E as ErrorCode, G as Group, M as MAX_ELEMENTS, g as MAX_TEXT, N as NodeData, h as SHAPE_TYPES, S as Shape, c as ShapeType, p as principalSchema, r as readBoard } from './read-CeWoSAAy.js';
+import { B as BoardAccess } from './service-Ckz-3qhK.js';
+export { C as CanvasService, D as DrawOptions, F as FlowEdge, a as FlowGraph, b as FlowNode, M as MAX_FLOW_EDGES, c as MAX_FLOW_NODES, P as Placement, d as drawFlow, l as layoutFlow, p as parseFlow } from './service-Ckz-3qhK.js';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export { FileStoreOptions, createFileStore, openLocalStore } from './store-file.js';
 export { PRINCIPAL_KINDS, PrincipalKind, isMachineMade } from 'agentic-identity';

package/dist/index.js

@@ -6,14 +6,14 @@ import {
   operatorActor,
   runMcp,
   svgToPng
-} from "./chunk-SIDWRC3P.js";
+} from "./chunk-VFJJGXTK.js";
 import {
   createFileStore,
   openLocalStore
 } from "./chunk-UKST5A57.js";
 import {
   CanvasService
-} from "./chunk-G4YTESPS.js";
+} from "./chunk-66FFQMHI.js";
 import "./chunk-NWQED42L.js";
 import {
   Board,
@@ -28,12 +28,12 @@ import {
   parseFlow,
   readBoard,
   toSvg
-} from "./chunk-JCYNPYYJ.js";
+} from "./chunk-ZSPZMGHG.js";
 import {
   PRINCIPAL_KINDS,
   isMachineMade,
   principalSchema
-} from "./chunk-SPP6PINW.js";
+} from "./chunk-JOBTIAFJ.js";
 export {
   ActorConfigError,
   BRAND,

package/dist/live-worker.d.ts

@@ -5,10 +5,10 @@ import 'agentic-identity';
 import 'agentic-realtime';
 import 'agentic-identity/cloudflare';
 import 'hono';
-import './read-BupIJSPJ.js';
+import './read-CeWoSAAy.js';
 import 'yjs';
 import 'zod';
-import './service-CR4-r1yx.js';
+import './service-Ckz-3qhK.js';
 
 type Namespace = Parameters<typeof createDurableObjectRealtime>[0];
 interface LiveEnv extends WorkerEnv {

package/dist/live-worker.js

@@ -1,12 +1,12 @@
 import {
   createApp
-} from "./chunk-BIIC2DPZ.js";
-import "./chunk-G4YTESPS.js";
+} from "./chunk-PH67TSYW.js";
+import "./chunk-66FFQMHI.js";
 import "./chunk-NWQED42L.js";
 import {
   CanvasError
-} from "./chunk-JCYNPYYJ.js";
-import "./chunk-SPP6PINW.js";
+} from "./chunk-ZSPZMGHG.js";
+import "./chunk-JOBTIAFJ.js";
 
 // src/live-worker.ts
 import { parseRegion } from "agentic-identity";

package/dist/live.d.ts

@@ -1,9 +1,9 @@
-import { B as Board, P as Principal, a as BoardData, S as Shape, C as Connector, b as CanvasElement } from './read-BupIJSPJ.js';
+import { B as Board, P as Principal, a as BoardData, S as Shape, C as Connector, b as CanvasElement } from './read-CeWoSAAy.js';
 import { Peer } from 'agentic-realtime/client';
-import { B as BoardAccess, D as DrawOptions } from './service-CR4-r1yx.js';
+import { B as BoardAccess, D as DrawOptions } from './service-Ckz-3qhK.js';
 import 'yjs';
-import 'zod';
 import 'agentic-identity';
+import 'zod';
 
 interface LiveOptions {
     /** The Worker address, such as `https://canvas.example.com`. */

package/dist/live.js

@@ -4,8 +4,8 @@ import {
   drawFlow,
   readBoard,
   toSvg
-} from "./chunk-JCYNPYYJ.js";
-import "./chunk-SPP6PINW.js";
+} from "./chunk-ZSPZMGHG.js";
+import "./chunk-JOBTIAFJ.js";
 
 // src/live.ts
 import { parsePrincipal } from "agentic-identity";

package/dist/{read-BupIJSPJ.d.ts → read-CeWoSAAy.d.ts}

@@ -1,17 +1,31 @@
 import * as Y from 'yjs';
+import { PrincipalKind } from 'agentic-identity';
 import { z } from 'zod';
 
-declare const principalSchema: z.ZodObject<{
-    kind: z.ZodEnum<["human", "agent_of_human", "agent_of_agent", "agent", "user_token"]>;
+/**
+ * The actor of a new write. The rule is the identity kernel's `parsePrincipal`: a known kind, and an id of 1 to 128
+ * characters from A-Z, a-z, 0-9, ".", "_" and "-". The Worker, the CLI and the SDK all use it.
+ */
+declare const principalSchema: z.ZodEffects<z.ZodObject<{
+    kind: z.ZodString;
     id: z.ZodString;
 }, "strict", z.ZodTypeAny, {
-    kind: "human" | "agent_of_human" | "agent_of_agent" | "agent" | "user_token";
+    kind: string;
     id: string;
 }, {
-    kind: "human" | "agent_of_human" | "agent_of_agent" | "agent" | "user_token";
+    kind: string;
+    id: string;
+}>, {
+    kind: PrincipalKind;
+    id: string;
+}, {
+    kind: string;
     id: string;
 }>;
-type Principal = z.infer<typeof principalSchema>;
+type Principal = {
+    kind: PrincipalKind;
+    id: string;
+};
 
 type ErrorCode = "INVALID" | "DUPLICATE_ID" | "NOT_FOUND" | "BAD_REFERENCE" | "LIMIT" | "UNAVAILABLE" | "FORBIDDEN";
 declare class CanvasError extends Error {

package/dist/{service-CR4-r1yx.d.ts → service-Ckz-3qhK.d.ts}

@@ -1,4 +1,4 @@
-import { c as ShapeType, B as Board, P as Principal, a as BoardData, S as Shape, C as Connector, b as CanvasElement } from './read-BupIJSPJ.js';
+import { c as ShapeType, B as Board, P as Principal, a as BoardData, S as Shape, C as Connector, b as CanvasElement } from './read-CeWoSAAy.js';
 import { Store } from 'agentic-identity';
 
 declare const MAX_FLOW_NODES = 500;

package/dist/worker.d.ts

@@ -2,8 +2,8 @@ import { Blobs } from 'agentic-identity';
 import { Realtime } from 'agentic-realtime';
 import { D1Like, R2Like } from 'agentic-identity/cloudflare';
 import { Hono } from 'hono';
-import { P as Principal } from './read-BupIJSPJ.js';
-import { C as CanvasService } from './service-CR4-r1yx.js';
+import { P as Principal } from './read-CeWoSAAy.js';
+import { C as CanvasService } from './service-Ckz-3qhK.js';
 import 'yjs';
 import 'zod';
 

package/dist/worker.js

@@ -4,11 +4,11 @@ import {
   createApp,
   sniffImage,
   worker_default
-} from "./chunk-BIIC2DPZ.js";
-import "./chunk-G4YTESPS.js";
+} from "./chunk-PH67TSYW.js";
+import "./chunk-66FFQMHI.js";
 import "./chunk-NWQED42L.js";
-import "./chunk-JCYNPYYJ.js";
-import "./chunk-SPP6PINW.js";
+import "./chunk-ZSPZMGHG.js";
+import "./chunk-JOBTIAFJ.js";
 export {
   WS_PROTOCOL,
   authenticate,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-canvas",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "A shared whiteboard for diagrams, drawn by people and agents.",
   "keywords": [
     "whiteboard",

package/dist/chunk-SPP6PINW.js

@@ -1,10 +0,0 @@
-// src/core/principal.ts
-import { PRINCIPAL_KINDS, isMachineMade } from "agentic-identity";
-import { z } from "zod";
-var principalSchema = z.object({ kind: z.enum(PRINCIPAL_KINDS), id: z.string().min(1).max(200) }).strict();
-
-export {
-  PRINCIPAL_KINDS,
-  isMachineMade,
-  principalSchema
-};