@lambdacurry/arbor 0.22.31 → 0.22.33

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.31",
+  version: "0.22.33",
   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",
@@ -9981,6 +9981,11 @@ 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 connect = object({
+  op: literal("connect"),
+  sourceId: shapeId.describe("existing native shape to bind the arrow start to"),
+  targetId: shapeId.describe("existing native shape to bind the arrow end to")
+}).strict();
 var diagram = object({
   op: literal("diagram"),
   direction: _enum(["LR", "RL", "TB", "BT"]).describe("graph reading direction: left/right or top/bottom"),
@@ -10013,6 +10018,7 @@ var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
     ids: shapeIds.min(2),
     groupId: shapeId.optional()
   }).strict(),
+  connect,
   diagram
 ]);
 var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS).superRefine((operations, ctx) => {
@@ -10044,6 +10050,13 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
         seen.add(id);
       });
     }
+    if (operation.op === "connect" && operation.sourceId === operation.targetId) {
+      ctx.addIssue({
+        code: "custom",
+        message: "connect self-loops are not supported",
+        path: [index, "targetId"]
+      });
+    }
     if (operation.op === "diagram") {
       const previousNodeTotal = totalDiagramNodes;
       const previousEdgeTotal = totalDiagramEdges;
@@ -10974,7 +10987,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_process_read",
     title: "Read a background process",
-    description: "Read process output with nextCursor; preserved bytes remain available for 30 days after preservation, including repeated cursors after finish/suspend, without provider wake. waitForTerminalMs adds one bounded native observation and page; expiry or descendants may still run, transport failure stays unknown/unsafe, and Arbor settles the durable operation only from terminal or exact absence proof.",
+    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.",
     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"),
@@ -11341,7 +11354,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "promote_attachment",
     title: "Promote a file attachment to an artifact",
-    description: "Turn a file uploaded to a thread into a first-class artifact — the blob becomes the artifact's content, owned by the author of the contribution it hangs off (not necessarily you). Reach for this when an attached file is itself a deliverable worth retaining and citing. The attachment must share the contribution's thread; idempotent — re-promoting the same file returns the same artifact.",
+    description: "Turn a file uploaded to a thread into a separate first-class file Artifact from a source Contribution — the blob becomes the Artifact's content, owned by that contribution's author (not necessarily you). Use the Attachment's durable downloadUrl to reference an exported report within an existing baseline Artifact instead of promoting it into that artifactId; the Attachment must share the source Contribution's Thread, and re-promoting the same file is idempotent.",
     inputSchema: {
       attachmentId: string2().describe("the uploaded attachment, att_…"),
       sourceContributionId: string2().describe("the contribution it's produced by, con_… (must share the attachment's thread)")
@@ -12161,7 +12174,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "artifact",
     title: "Create or edit an Artifact",
-    description: "Create or edit a durable versioned Artifact, bind its executable Thread Live Preview, set a Computer-file asleep/share snapshot, or promote a Thread attachment; for a computer:// .tldr snapshot mint: computer_export the exact locator path and same-Thread PNG, then use set_snapshot. Board save and TLP do not mint snapshots. set_snapshot does not wake Computer or change the locator; read artifact_get before changing it, while lifecycle/removal stay in artifact_transition and artifact_delete.",
+    description: "Create or edit a durable versioned Artifact, bind its executable Thread Live Preview, set a Computer-file asleep/share snapshot, or promote a Thread attachment into a separate file Artifact from a source Contribution. To reference an exported report within an existing baseline Artifact, use the Attachment's durable downloadUrl instead of promoting it into that artifactId. For a computer:// .tldr snapshot mint: computer_export the exact locator path and same-Thread PNG, then use set_snapshot. Board save and TLP do not mint snapshots. set_snapshot does not wake Computer or change the locator; read artifact_get before changing it, while lifecycle/removal stay in artifact_transition and artifact_delete.",
     inputSchema: {
       verb: _enum(["create", "edit", "set_live_preview", "set_snapshot", "promote_attachment"]).describe("which artifact move"),
       title: string2().optional().describe("create: the artifact's title"),
@@ -12181,7 +12194,8 @@ var ACTION_DEFINITIONS = [
       note: string2().optional().describe("edit: one-line summary of what changed"),
       sourceAttachmentId: string2().optional().describe("set_snapshot: computer_export of the exact computer:// locator path; MIME application/vnd.tldraw+json, computerPath stamped and matching defaultCwd + locator"),
       previewAttachmentId: string2().optional().describe("set_snapshot: same-Thread computer_export image/png Attachment, used as the asleep face preview"),
-      attachmentId: string2().optional().describe("promote_attachment: the upload, att_…")
+      attachmentId: string2().optional().describe("promote_attachment: the upload, att_…"),
+      sourceContributionId: string2().optional().describe("promote_attachment: REQUIRED source Contribution, con_… (must share the Attachment's Thread)")
     },
     surfaces: ["mcp"],
     toolset: "artifacts",
@@ -12345,7 +12359,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 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}.`,
+    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}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       code: string2().min(1).max(1e5).optional().describe("advanced script source; mutually exclusive with operations"),
@@ -12928,7 +12942,7 @@ function retentionAction(action) {
   if (action.name === "artifact") {
     return {
       ...action,
-      description: "Create or edit a durable versioned Artifact with bounded full|checkpoint retention, or manage its Live Preview/snapshot/attachment surface. Content edits return artifactVersionId; byte-identical edits reuse the current version, while policy changes and checkpoints preserve the content version.",
+      description: "Create/edit a durable versioned Artifact with bounded full|checkpoint retention or manage its Live Preview/snapshot/attachment surface; promote_attachment creates a separate file Artifact from a source Contribution, while exported reports in an existing baseline Artifact use the Attachment's durable downloadUrl instead of promotion into that artifactId. Content edits return artifactVersionId; byte-identical edits reuse current version, while policy changes/checkpoints preserve content version.",
       inputSchema: {
         ...action.inputSchema,
         historyPolicy: historyPolicySchema,
@@ -14288,7 +14302,7 @@ function bareConnectUrl(apiUrl, returnedUrl) {
     return fallback;
   }
 }
-async function connect(opts) {
+async function connect2(opts) {
   if (defaultConfigOverwriteBlocked()) {
     throw new Error(DEFAULT_TOKEN_OVERWRITE_REFUSAL);
   }
@@ -14615,7 +14629,7 @@ async function main() {
         const key = positionals[1];
         if (!key)
           throw new UsageError("usage: arbor connect <pairing-key> [--url <api-url>]");
-        await connect({ pairingKey: key, url: stringFlag(flags.url, "url") });
+        await connect2({ pairingKey: key, url: stringFlag(flags.url, "url") });
         advise(`
   ✓ Connected (${getConfigPath()}).
   `, ctx);

package/package.json

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