@lambdacurry/arbor 0.22.29 → 0.22.30

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.29",
+  version: "0.22.30",
   description: "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   keywords: [
     "agents",
@@ -9946,6 +9946,8 @@ ${orientation}
 
 // ../actions/src/tldraw-agent.ts
 var TLDRAW_EXEC_MAX_OPERATIONS = 100;
+var TLDRAW_DIAGRAM_MAX_NODES = 64;
+var TLDRAW_DIAGRAM_MAX_EDGES = 96;
 var shapeId = string2().regex(/^shape:[A-Za-z0-9_-]{1,128}$/).describe("stable tldraw shape id, shape:…");
 var shapeType = _enum(["geo", "text", "note", "frame", "arrow", "line", "draw", "group"]).describe("built-in tldraw shape type; use code mode for custom or asset-backed shapes");
 var finite = number2().finite();
@@ -9977,6 +9979,21 @@ var update = object({
   meta: jsonRecord.optional()
 }).strict();
 var shapeIds = array(shapeId).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS);
+var diagramKey = string2().min(1).max(80).describe("caller-meaningful node key; returned as the alias for its generated tldraw shape id");
+var diagramLabel = string2().min(1).max(160);
+var diagram = object({
+  op: literal("diagram"),
+  direction: _enum(["LR", "RL", "TB", "BT"]).describe("graph reading direction: left/right or top/bottom"),
+  nodes: array(object({
+    key: diagramKey,
+    label: diagramLabel
+  }).strict()).min(1).max(TLDRAW_DIAGRAM_MAX_NODES),
+  edges: array(object({
+    from: diagramKey,
+    to: diagramKey,
+    label: diagramLabel.optional()
+  }).strict()).max(TLDRAW_DIAGRAM_MAX_EDGES)
+}).strict();
 var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
   create,
   update,
@@ -9995,10 +10012,14 @@ var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
     op: literal("group"),
     ids: shapeIds.min(2),
     groupId: shapeId.optional()
-  }).strict()
+  }).strict(),
+  diagram
 ]);
 var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS).superRefine((operations, ctx) => {
   const createdIds = new Set;
+  const diagramKeys = new Set;
+  let totalDiagramNodes = 0;
+  let totalDiagramEdges = 0;
   operations.forEach((operation, index) => {
     if (operation.op === "create") {
       if (createdIds.has(operation.id)) {
@@ -10023,6 +10044,61 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
         seen.add(id);
       });
     }
+    if (operation.op === "diagram") {
+      const previousNodeTotal = totalDiagramNodes;
+      const previousEdgeTotal = totalDiagramEdges;
+      totalDiagramNodes += operation.nodes.length;
+      totalDiagramEdges += operation.edges.length;
+      if (previousNodeTotal <= TLDRAW_DIAGRAM_MAX_NODES && totalDiagramNodes > TLDRAW_DIAGRAM_MAX_NODES) {
+        ctx.addIssue({
+          code: "custom",
+          message: `diagram nodes exceed execution limit: ${TLDRAW_DIAGRAM_MAX_NODES}`,
+          path: [index, "nodes"]
+        });
+      }
+      if (previousEdgeTotal <= TLDRAW_DIAGRAM_MAX_EDGES && totalDiagramEdges > TLDRAW_DIAGRAM_MAX_EDGES) {
+        ctx.addIssue({
+          code: "custom",
+          message: `diagram edges exceed execution limit: ${TLDRAW_DIAGRAM_MAX_EDGES}`,
+          path: [index, "edges"]
+        });
+      }
+      const keys = new Set;
+      operation.nodes.forEach((node, nodeIndex) => {
+        if (keys.has(node.key)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `duplicate diagram node key: ${node.key}`,
+            path: [index, "nodes", nodeIndex, "key"]
+          });
+        }
+        if (diagramKeys.has(node.key)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `diagram node key is already used in this execution: ${node.key}`,
+            path: [index, "nodes", nodeIndex, "key"]
+          });
+        }
+        keys.add(node.key);
+        diagramKeys.add(node.key);
+      });
+      operation.edges.forEach((edge, edgeIndex) => {
+        if (!keys.has(edge.from)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `diagram edge source does not name a node: ${edge.from}`,
+            path: [index, "edges", edgeIndex, "from"]
+          });
+        }
+        if (!keys.has(edge.to)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `diagram edge target does not name a node: ${edge.to}`,
+            path: [index, "edges", edgeIndex, "to"]
+          });
+        }
+      });
+    }
   });
 }).describe("preferred declarative edits, applied in order; mutually exclusive with code");
 // ../actions/src/index.ts
@@ -12267,7 +12343,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_exec",
     title: "Run a one-shot tldraw program",
-    description: `Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, then return a durable execution receipt; use IDs from a fresh observe, reacquire this current schema after compaction, and never replay an unknown result. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
+    description: `Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, including a graph-scoped diagram operation that lays out keyed nodes and native bound edges without caller-supplied coordinates, then return a durable execution receipt; use IDs from a fresh observe, reacquire this current schema after compaction, and never replay an unknown result. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       code: string2().min(1).max(1e5).optional().describe("advanced script source; mutually exclusive with operations"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.22.29",
+  "version": "0.22.30",
   "description": "The Arbor CLI — a shared workspace for people and agents. The human + headless-agent write path over Arbor's guarded operation surface.",
   "keywords": [
     "agents",