@lambdacurry/arbor 0.23.38 → 0.23.40

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.23.38",
+  version: "0.23.40",
   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",
@@ -13427,7 +13427,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 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.",
+    description: "Create/edit an Artifact, bind a Live Preview, set a Computer snapshot, or promote a Thread attachment. Git edits derive retry keys (omitted edits derive one); keyless creates mint per-invocation keys; stable idempotencyKey supports caller retries. Retry only after unknown outcomes; never blindly repeat ambiguous creates. Exported reports use the Attachment downloadUrl; tldraw snapshot and lifecycle actions use their dedicated operations.",
     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"),
@@ -13445,6 +13445,7 @@ var ACTION_DEFINITIONS = [
       baseVersion: number2().optional().describe("edit: the version you READ (from get/create) — stale base is rejected with the current source"),
       patches: array(object({ old: string2(), new: string2() })).optional().describe("edit: exact-match hunks applied in order, atomically; each old must match exactly once"),
       note: string2().optional().describe("edit: one-line summary of what changed"),
+      idempotencyKey: string2().min(1).max(200).optional().describe("create: optional caller-stable key; omitted creates mint one per invocation; edit: optional stable key (omitted edits derive one from actor/artifact/base/payload); reuse unchanged only to recover an unknown outcome, never to start a new write"),
       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_…"),
@@ -14210,7 +14211,7 @@ function retentionAction(action) {
   if (action.name === "artifact") {
     return {
       ...action,
-      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.",
+      description: "Create/edit a durable Artifact with full|checkpoint retention or manage Live Preview, snapshots, and attachments. Git edits derive retry keys (omitted edits derive one); keyless creates mint per-invocation keys; stable idempotencyKey supports caller retries; never blindly repeat ambiguous creates. promote_attachment creates a file Artifact from a Contribution; exported reports use the Attachment downloadUrl; policy changes do not mint content versions.",
       inputSchema: {
         ...action.inputSchema,
         historyPolicy: historyPolicySchema,

package/package.json

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