@lambdacurry/arbor 0.22.7 → 0.22.8

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.7",
+  version: "0.22.8",
   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",
@@ -9675,6 +9675,88 @@ function mcpAnnotationsFor(name) {
   return annotations;
 }
 
+// ../actions/src/tldraw-agent.ts
+var TLDRAW_EXEC_MAX_OPERATIONS = 100;
+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();
+var jsonRecord = record(string2(), unknown());
+var create = object({
+  op: literal("create"),
+  id: shapeId,
+  type: shapeType,
+  x: finite,
+  y: finite,
+  parentId: string2().min(1).max(200).optional(),
+  rotation: finite.optional(),
+  opacity: finite.min(0).max(1).optional(),
+  isLocked: boolean2().optional(),
+  props: jsonRecord.optional().describe("shape properties such as w, h, geo, color, or richText"),
+  meta: jsonRecord.optional()
+}).strict();
+var update = object({
+  op: literal("update"),
+  id: shapeId,
+  type: shapeType,
+  x: finite.optional(),
+  y: finite.optional(),
+  parentId: string2().min(1).max(200).optional(),
+  rotation: finite.optional(),
+  opacity: finite.min(0).max(1).optional(),
+  isLocked: boolean2().optional(),
+  props: jsonRecord.optional().describe("partial shape properties"),
+  meta: jsonRecord.optional()
+}).strict();
+var shapeIds = array(shapeId).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS);
+var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
+  create,
+  update,
+  object({ op: literal("delete"), ids: shapeIds }).strict(),
+  object({
+    op: literal("align"),
+    ids: shapeIds.min(2),
+    alignment: _enum(["bottom", "center-horizontal", "center-vertical", "left", "right", "top"])
+  }).strict(),
+  object({
+    op: literal("distribute"),
+    ids: shapeIds.min(3),
+    axis: _enum(["horizontal", "vertical"])
+  }).strict(),
+  object({
+    op: literal("group"),
+    ids: shapeIds.min(2),
+    groupId: shapeId.optional()
+  }).strict()
+]);
+var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS).superRefine((operations, ctx) => {
+  const createdIds = new Set;
+  operations.forEach((operation, index) => {
+    if (operation.op === "create") {
+      if (createdIds.has(operation.id)) {
+        ctx.addIssue({
+          code: "custom",
+          message: `duplicate create id: ${operation.id}`,
+          path: [index, "id"]
+        });
+      }
+      createdIds.add(operation.id);
+    }
+    if ("ids" in operation) {
+      const seen = new Set;
+      operation.ids.forEach((id, idIndex) => {
+        if (seen.has(id)) {
+          ctx.addIssue({
+            code: "custom",
+            message: `duplicate shape id: ${id}`,
+            path: [index, "ids", idIndex]
+          });
+        }
+        seen.add(id);
+      });
+    }
+  });
+}).describe("preferred declarative edits, applied in order; mutually exclusive with code — read skill://arbor/references/tldraw.md before first use");
+
 // ../actions/src/skill.ts
 var ARBOR_SKILL_NAME = "arbor";
 var ARBOR_SKILL_DESCRIPTION = "Work in Arbor (arborthreads.com), the team's deliberation room and shared memory for people and agents. " + "Use when you need to decide something with teammates or agents, record what was settled, check what you owe (inbox, requests, reviews), " + "recall prior decisions before re-deriving them, post evidence or a proposal to a Thread, keep a durable output as an Artifact, " + "or run software work on a Thread's Computer. Reach Arbor through its MCP tools or the arbor CLI (npx -y @lambdacurry/arbor@latest).";
@@ -9720,6 +9802,12 @@ Artifacts Arbor keeps current. Use it to decide things with others and to rememb
 ## How to work well in Arbor
 
 ${orientation}
+
+## Native tldraw
+
+Before creating or modifying a native tldraw Artifact, read the bundled
+references/tldraw.md. Over MCP it is skill://arbor/references/tldraw.md; when only the CLI or web is
+available, read ${base}/skill/tldraw.md.
 `;
 }
 // ../actions/src/index.ts
@@ -11936,7 +12024,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_observe",
     title: "Observe a tldraw board",
-    description: "Capture a fresh bounded tldraw scene, lint result, document clock and digest, plus a PNG attachment for visual review.",
+    description: "Capture a fresh bounded tldraw scene, lint result, document clock and digest, plus a PNG attachment for visual review. Observe before editing; first-time agents should read skill://arbor/references/tldraw.md (or https://arborthreads.com/skill/tldraw.md).",
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       pageId: string2().min(1).max(200).optional().describe("optional page to observe"),
@@ -11950,10 +12038,11 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_exec",
     title: "Run a one-shot tldraw program",
-    description: "Run bounded one-shot code against the current live tldraw board without changing its persistent document script, and return a durable execution receipt. An unknown result is reported for recovery and is never replayed automatically.",
+    description: "Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, then return a durable execution receipt. Observe first and read skill://arbor/references/tldraw.md (or https://arborthreads.com/skill/tldraw.md); an unknown result is never replayed automatically.",
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
-      code: string2().min(1).max(1e5).describe("the script source to execute"),
+      code: string2().min(1).max(1e5).optional().describe("advanced script source; mutually exclusive with operations"),
+      operations: TLDRAW_EXEC_OPERATIONS_SCHEMA.optional(),
       idempotencyKey: string2().min(1).max(200).describe("stable key for this execution"),
       expectedDocumentClock: number2().int().min(0).optional().describe("optional current room clock guard"),
       boundedSettleMs: number2().int().min(400).max(3000).optional().describe("maximum settle time")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambdacurry/arbor",
-  "version": "0.22.7",
+  "version": "0.22.8",
   "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",