@lambdacurry/arbor 0.20.13 → 0.20.14

package/dist/arbor.js

@@ -16921,6 +16921,25 @@ var computerRunReceipt = exports_external.looseObject({
   status: exports_external.enum(["active", "finished", "failed", "cancelled"]),
   outcome: exports_external.enum(["finished", "failed", "cancelled"]).nullable(),
   reason: exports_external.string().nullable(),
+  reasonCode: exports_external.string().nullable(),
+  operations: exports_external.array(exports_external.looseObject({
+    operationId: exports_external.string(),
+    kind: exports_external.literal("exec"),
+    execution: exports_external.enum(["foreground", "background"]),
+    state: exports_external.enum([
+      "starting",
+      "running",
+      "completed",
+      "failed",
+      "cancelled",
+      "provider-lost",
+      "unknown"
+    ]),
+    mutationRetrySafety: exports_external.enum(["not-needed", "unsafe", "unknown"]),
+    reasonCode: exports_external.string(),
+    startedAt: exports_external.string(),
+    endedAt: exports_external.string().nullable()
+  })),
   startedAt: exports_external.string(),
   endedAt: exports_external.string().nullable(),
   durationMs: exports_external.number().nullable(),
@@ -16929,7 +16948,8 @@ var computerRunReceipt = exports_external.looseObject({
     at: exports_external.string(),
     label: exports_external.string().optional(),
     detail: exports_external.string().optional(),
-    targetId: exports_external.string().optional()
+    targetId: exports_external.string().optional(),
+    reasonCode: exports_external.string().optional()
   })),
   lifecycle: exports_external.array(exports_external.looseObject({ type: exports_external.string(), at: exports_external.string() }))
 });
@@ -17665,6 +17685,12 @@ var MCP_OUTPUT_SCHEMAS = {
       cpuPercent: exports_external.number().min(0).nullable(),
       processCount: exports_external.number().int().min(0).nullable(),
       reasonCode: exports_external.string()
+    }).optional(),
+    recovery: exports_external.looseObject({
+      state: exports_external.enum(["provider-timeout", "provider-lost", "unknown"]),
+      reasonCode: exports_external.string(),
+      mutationRetrySafety: exports_external.enum(["unsafe", "unknown"]),
+      nextAction: exports_external.enum(["computer_process_read", "computer_run_receipt"])
     }).optional()
   }),
   computer_process_terminate: exports_external.looseObject({
@@ -17864,7 +17890,8 @@ var OUTPUT_SHAPERS = {
     ["endedAt", result.endedAt],
     ["durationMs", result.durationMs],
     ["exitCode", result.exitCode],
-    ["activity", result.activity]
+    ["activity", result.activity],
+    ["recovery", result.recovery]
   ]),
   computer_process_terminate: (result) => defined([
     ["status", result.status],
@@ -18462,7 +18489,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_receipt",
     title: "Read a run receipt",
-    description: "READ ONLY: read one run's compact receipt — its purpose, actor, computer session, base snapshot and starting Git projection, explicit isolation/durability contract, pre-teardown durability assessment when available (including publication that remains unknown unless proven), meaningful activity, and terminal outcome. Background work may appear as distilled labels/outcomes, but Arbor keeps no raw command transcript or process output. The receipt stays readable after the Run is terminal.",
+    description: "READ ONLY: read one run's compact receipt — its purpose, actor, computer session, base snapshot and starting Git projection, explicit isolation/durability contract, pre-teardown durability assessment when available (including publication that remains unknown unless proven), durable operation receipts with stable state/reason/retry-safety, meaningful activity, and terminal outcome. Foreground and background work may appear as distilled process identities/labels/outcomes, but Arbor keeps no raw command transcript or process output. The receipt stays readable after the Run is terminal.",
     inputSchema: {
       runId: exports_external.string().describe("the run to read, run_… (from computer_run_start or computer_runs)")
     },
@@ -18486,7 +18513,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_exec",
     title: "Run a command",
-    description: "Run one bounded logical operation in an opened Thread computer. Omitting cwd uses the environment's defaultCwd; pass cwd explicitly to override it. Pass runId to route the command according to that Run's execution placement; without runId the command executes in the parent Computer. Strict Bash semantics are ON by default. For tests, builds, installs, or any command likely to run long, prefer background=true so the call returns a processId immediately; follow it with computer_process_read using the returned cursor for small incremental tails. For a labeled run-scoped verification check, pass activityKind=verification so the terminal exit becomes a distilled verification outcome. For a connected human, Arbor supplies ambient GitHub authorization and Git identity ephemerally without writing credentials into the workspace. Background processes stay in the environment where they were started.",
+    description: "Run one bounded logical operation in an opened Thread computer. Omitting cwd uses the environment's defaultCwd; pass cwd explicitly to override it. Pass runId to route the command according to that Run's execution placement; without runId the command executes in the parent Computer. Strict Bash semantics are ON by default. For explicit asynchronous work, background=true returns a processId immediately. On an isolated container Run, foreground exec also establishes a durable operation/process identity before Arbor waits; a missed foreground response can be recovered from computer_run_receipt.operations and computer_process_read without repeating the mutation. For a labeled run-scoped verification check, pass activityKind=verification so the terminal exit becomes a distilled verification outcome. For a connected human, Arbor supplies ambient GitHub authorization and Git identity ephemerally without writing credentials into the workspace. Provider-owned processes stay in the environment where they were started.",
     inputSchema: {
       computerSessionId: exports_external.string().optional().describe("the computerSessionId returned by computer_open, cms_…; required unless runId is supplied"),
       command: exports_external.string().min(1).describe("the shell command to run"),
@@ -18505,7 +18532,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_process_read",
     title: "Read a background process",
-    description: "READ ONLY: Tail one process returned by computer_exec(background=true). With no cursor, returns only the latest small output window; pass nextCursor on the next read to receive only newer output. Defaults to 4 KB total and allows an explicit larger read up to 64 KB. Returns a compact activity receipt that distinguishes fresh output, active CPU work, quiet running, terminal state, and unavailable telemetry without exposing raw process tables. Once terminal, also returns the final exit result.",
+    description: "READ ONLY: Read one provider-owned process from computer_exec, including a recoverable foreground operation discovered through computer_run_receipt.operations. With no cursor, returns only the latest small output window; pass nextCursor on the next read to receive only newer output. Defaults to 4 KB total and allows an explicit larger read up to 64 KB. Returns the existing compact activity receipt that distinguishes fresh output, active CPU work, quiet running, terminal state, and unavailable telemetry without exposing raw process tables. For a known foreground recovery handle whose provider state cannot be observed, returns structured recovery state/reason/retry-safety instead of guessing. Once terminal, also returns the final exit result.",
     inputSchema: {
       computerSessionId: exports_external.string().optional().describe("the computerSessionId returned by computer_open, cms_…; required unless runId is supplied"),
       runId: exports_external.string().optional().describe("the Run that owns this process, if it was started inside a Run"),

package/package.json

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