@lambdacurry/arbor 0.22.33 → 0.22.35

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.33",
+  version: "0.22.35",
   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",
@@ -9264,10 +9264,10 @@ var MCP_OUTPUT_SCHEMAS = {
   computer_process_read: looseObject({
     processId: string2(),
     status: string2(),
-    outputRetention: object({ state: literal("preserved"), expiresAt: timestamp }).optional(),
+    outputRetention: object({ state: _enum(["preserved", "expired"]), expiresAt: timestamp }).optional(),
     timedOut: boolean2().optional(),
     endedAt: timestamp.nullable().optional(),
-    durationMs: number2().int().min(0).nullable().optional(),
+    durationMs: number2().int().min(0).nullable().optional().describe("process elapsed runtime, final at terminal; it is not read or RPC latency"),
     stdout: string2().optional(),
     stderr: string2().optional(),
     truncated: boolean2().optional(),
@@ -9981,6 +9981,13 @@ var update = object({
 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 stack = object({
+  op: literal("stack"),
+  ids: shapeIds.min(2).describe("native shapes in the exact stack order; first id is the anchor"),
+  axis: _enum(["horizontal", "vertical"]),
+  gap: finite.min(0).describe("required edge-to-edge gap between adjacent shapes"),
+  alignment: _enum(["start", "center", "end"]).optional().describe("optional cross-axis alignment relative to the first shape")
+}).strict();
 var connect = object({
   op: literal("connect"),
   sourceId: shapeId.describe("existing native shape to bind the arrow start to"),
@@ -10018,6 +10025,7 @@ var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
     ids: shapeIds.min(2),
     groupId: shapeId.optional()
   }).strict(),
+  stack,
   connect,
   diagram
 ]);
@@ -10143,7 +10151,7 @@ Arbor's MCP is the collaboration and durable-knowledge surface. Configure, autho
 
 Run \`arbor help\` (or read the MCP tool list) for the exact command/flags — those stay generated from the live action surface, so they're always current.`;
 var ARBOR_SKILL_MARKDOWN = renderArborSkill(ORIENTATION);
-var COMPUTER_ORIENTATION = `Long Computer work returns a processId handle — do not hold one tool call for a full test or build. \`computer_exec\` runs a command; if the result is still running, observe it with \`computer_process_read\`; read a truncated continuation only when you need more output. Finish and suspend preserve unread terminal output internally, with original process IDs/cursors recoverable for 30 days. Do not chain \`pnpm test && pnpm build\` in one exec; split steps or pass \`background:true\`. An explicit waitForTerminalMs uses one server wait and canonical output page; otherwise the CLI polls only while the process is silent unless \`--no-wait\`. It never concatenates continuation pages into one agent context.
+var COMPUTER_ORIENTATION = `Long Computer work returns a processId handle — do not hold one tool call for a full test or build. \`computer_exec\` runs a command; if the result is still running, observe it with \`computer_process_read\`; read a truncated continuation only when you need more output. Finish and suspend preserve unread terminal output internally, with original process IDs/cursors recoverable for 30 days. Do not chain \`pnpm test && pnpm build\` in one exec; split steps or pass \`background:true\`. An explicit waitForTerminalMs uses one server wait and canonical output page; includeOutput=false on process_read returns status/liveness/recovery without output delivery or cursor advancement. Otherwise the CLI polls only while the process is silent unless \`--no-wait\`. It never concatenates continuation pages into one agent context.
 
 Arbor Computer is the complete software execution platform attached to Arbor's durable collaboration graph. It configures project environments, executes and verifies work, packages and releases Apps, and preserves reviewable evidence; it does not schedule agents or replace Arbor collaboration.
 
@@ -10987,14 +10995,15 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_process_read",
     title: "Read a background process",
-    description: "Read output with nextCursor, including repeated cursors for 30 days after preservation without provider wake. durationMs is process elapsed runtime (final at terminal), not RPC latency; waitForTerminalMs adds one bounded observation/page; expiry may leave work running; transport failure stays unknown/unsafe; only terminal or exact absence proof settles the durable operation.",
+    description: "Read output with nextCursor; includeOutput=false returns status/liveness/recovery without output or cursor delivery; durationMs is process runtime, not RPC latency; wait expiry does not stop work; transport failure stays unknown/unsafe; only terminal or exact absence proof settles the durable operation; preserved output stays readable for 30 days without provider wake.",
     inputSchema: {
       computerSessionId: string2().optional().describe("legacy alternative to runId: a computerSessionId on that Computer, cms_…; required unless runId is supplied"),
       runId: string2().optional().describe("the Run that owns this process, if it was started inside a Run"),
       processId: string2().min(1).describe("the processId returned by background exec, or matching computer_run_receipt.operations[].operationId for recovered foreground Run work, proc_…"),
       cursor: string2().optional().describe("continue after nextCursor from the prior result; omit to read from the beginning"),
       maxBytes: number2().int().min(1024).max(65536).optional().describe("maximum combined output bytes to return; default 4,096, opt up only when needed"),
-      waitForTerminalMs: number2().int().min(0).max(45000).optional().describe("use one native terminal-observation window up to this many milliseconds, then return one canonical output page; 0 is immediate, surviving descendants may remain running, and omission preserves the current read behavior")
+      waitForTerminalMs: number2().int().min(0).max(45000).optional().describe("use one native terminal-observation window up to this many milliseconds, then return one canonical output page when includeOutput is true; 0 is immediate, surviving descendants may remain running, and omission preserves the current read behavior"),
+      includeOutput: boolean2().optional().describe("include stdout, stderr, and paging cursors; set false to inspect status, liveness, and recovery without delivering output or marking it delivered")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -12359,7 +12368,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, including graph-scoped diagram layout and safe native bound connect between shape IDs without caller-supplied connector geometry, 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 graph-scoped diagram layout, ordered exact-gap stack composition, and safe native bound connect without caller-supplied connector geometry, 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.33",
+  "version": "0.22.35",
   "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",