@lambdacurry/arbor 0.22.7 → 0.22.9

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.7",
+  version: "0.22.9",
   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",
@@ -4910,6 +4910,13 @@ function json(params) {
 }
 // ../../node_modules/.pnpm/zod@4.4.3/node_modules/zod/v4/classic/external.js
 config(en_default());
+// ../actions/src/agent-guides.ts
+var AGENT_GUIDE_URLS = {
+  tldraw: "https://arborthreads.com/docs/agents/tldraw",
+  computer: "https://arborthreads.com/docs/agents/computer",
+  apps: "https://arborthreads.com/docs/agents/apps"
+};
+
 // ../core/src/objects/types.ts
 var CONTRIBUTION_TYPES = [
   "comment",
@@ -9722,6 +9729,88 @@ Artifacts Arbor keeps current. Use it to decide things with others and to rememb
 ${orientation}
 `;
 }
+
+// ../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");
 // ../actions/src/index.ts
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
 var CONTRIBUTION_ADD_LINK_RELS = [
@@ -10494,7 +10583,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_start",
     title: "Start a run",
-    description: "Start one bounded unit of work on a Thread's Computer by threadId, no computer_open first: an isolated write Run (the default) restores its own environment from the Thread's snapshot without booting the parent; shared and read Runs use the live parent. The caller-owned idempotencyKey makes a lost response recover zero-or-one Run, and failures return the exact runId for computer_run_receipt.",
+    description: `Start one bounded unit of work by threadId, no computer_open first: write defaults to an isolated Run from the Thread snapshot without booting the parent; shared/read Runs use the live parent; idempotencyKey recovers zero-or-one Run after response loss, and failures return runId for computer_run_receipt. First use: read the Computer guide at ${AGENT_GUIDE_URLS.computer}.`,
     inputSchema: {
       threadId: string2().optional().describe("the Thread whose Computer this Run works in, thr_…; the front door — no computer_open first"),
       computerSessionId: string2().optional().describe("alternative to threadId: an existing computerSessionId from computer_open, cms_… (parent already open)"),
@@ -10773,7 +10862,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_publish_app_bundle",
     title: "Publish an immutable AppBundle",
-    description: "Publish an immutable AppBundle from the parent Computer behind a shared write Run (runId) after a green build when an ArtifactVersion is ready; Arbor acquires compatible bun-typescript-v1 execution internally. Verifies entry bytes against the ArtifactVersion, captures source/Git provenance and static assets, and returns bundleId; isolated Runs are refused, so push and start a shared Run first.",
+    description: `Publish an immutable AppBundle from parent bytes behind a shared write Run after a green build; Arbor acquires compatible bun-typescript-v1 execution, verifies bytes against ArtifactVersion, captures provenance/assets, and returns bundleId; isolated Runs are refused, so push then start shared first. First use: read the Apps guide at ${AGENT_GUIDE_URLS.apps}.`,
     inputSchema: {
       runId: string2().optional().describe("an active shared write Run on the parent whose bytes to publish, run_…"),
       computerSessionId: string2().optional().describe("legacy alternative to runId: a computerSessionId on that Computer, cms_…"),
@@ -11936,7 +12025,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 use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       pageId: string2().min(1).max(200).optional().describe("optional page to observe"),
@@ -11950,10 +12039,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 never replay an unknown result automatically. 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).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")
@@ -12231,7 +12321,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "app_create",
     title: "Create an App",
-    description: "Create a stable first-class App identity in a Space before deploying code. Public Apps are stateless and start public+unlisted+none; durable Apps are always space+durable with membership authorization and isolated SQLite state.",
+    description: `Create a stable first-class App identity in a Space before deploying code; public Apps are stateless and start public+unlisted+none, while durable Apps are always space+durable with membership authorization and isolated SQLite state. First use: read the Apps guide at ${AGENT_GUIDE_URLS.apps}.`,
     inputSchema: {
       spaceId: string2().describe("owning Space, spc_…"),
       title: string2().min(1).max(160).describe("short factual App title"),
@@ -12549,6 +12639,11 @@ function retentionAction(action) {
 var ACTIONS2 = ACTIONS.map(retentionAction);
 
 // ../actions/src/recovery-entry.ts
+var TLDRAW_GUIDE_URI = AGENT_GUIDE_URLS.tldraw;
+var TLDRAW_GUIDE_MARKDOWN = `# Working well in native tldraw
+
+This guide moved to ${AGENT_GUIDE_URLS.tldraw}.
+`;
 var grantOutput = object({
   grant: object({
     grantId: string2(),

package/package.json

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