@lambdacurry/arbor 0.23.6 → 0.23.8

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.23.6",
+  version: "0.23.8",
   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",
@@ -8438,6 +8438,19 @@ var computerRunFinishRequest = looseObject({
   providerGeneration: number2().int().nonnegative().nullable(),
   releasedSnapshotId: id.nullable()
 });
+var computerExecOutput = looseObject({
+  stdout: string2().optional(),
+  stderr: string2().optional(),
+  exitCode: number2().optional(),
+  processId: string2().optional(),
+  status: string2().optional(),
+  timedOut: boolean2().optional(),
+  truncated: boolean2().optional().describe("true when returned stdout/stderr is partial and more output remains"),
+  nextCursor: string2().optional().describe("opaque cursor for continuing partial output with computer_process_read"),
+  cwd: string2().optional(),
+  execution: _enum(["completed", "running"]).optional(),
+  nextAction: literal("computer_process_read").optional()
+});
 var computerRunReceipt2 = looseObject({
   runId: id,
   threadId: id,
@@ -9768,19 +9781,8 @@ var MCP_OUTPUT_SCHEMAS = {
     failureCode: string2().nullable(),
     reason: string2()
   }),
-  computer_exec: looseObject({
-    stdout: string2().optional(),
-    stderr: string2().optional(),
-    exitCode: number2().optional(),
-    processId: string2().optional(),
-    status: string2().optional(),
-    timedOut: boolean2().optional(),
-    truncated: boolean2().optional().describe("true when returned stdout/stderr is partial and more output remains"),
-    nextCursor: string2().optional().describe("opaque cursor for continuing partial output with computer_process_read"),
-    cwd: string2().optional(),
-    execution: _enum(["completed", "running"]).optional(),
-    nextAction: literal("computer_process_read").optional()
-  }),
+  computer_exec: computerExecOutput,
+  computer_run_setup: computerExecOutput,
   computer_process_read: looseObject({
     processId: string2(),
     status: string2(),
@@ -10308,6 +10310,12 @@ var openWorld = {
   idempotentHint: false,
   openWorldHint: true
 };
+var destructiveIdempotentOpenWorld = {
+  readOnlyHint: false,
+  destructiveHint: true,
+  idempotentHint: true,
+  openWorldHint: true
+};
 var destructiveOpenWorld = {
   readOnlyHint: false,
   destructiveHint: true,
@@ -10429,6 +10437,7 @@ var MCP_TOOL_ANNOTATIONS = {
   computer_run_receipt: readOnly,
   computer_runs: readOnly,
   computer_exec: destructiveOpenWorld,
+  computer_run_setup: destructiveIdempotentOpenWorld,
   computer_process_read: readOnly,
   computer_process_terminate: destructiveOpenWorld,
   computer_status: readOnly,
@@ -11519,7 +11528,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_receipt",
     title: "Read a run receipt",
-    description: "Read with exactly one of runId or runStartId: observe pending admission, finish continuation, Run-owned operation/activity state, and providerLifecycle instead of parent computer_status. Reads never drive admission or finish; the existing lifecycle owner continues independently.",
+    description: "Read with exactly one of runId or runStartId: observe pending admission, finish continuation, Run-owned operation/activity state, and providerLifecycle instead of parent computer_status. Reads never drive admission or finish; the existing lifecycle owner continues independently. setupReadiness says whether declared setup still matches this workspace; computer_run_setup is what makes it ready.",
     inputSchema: {
       runId: string2().optional().describe("the Run to read, run_…; provide exactly one of runId or runStartId"),
       runStartId: string2().optional().describe("the pending or linked RunStart to read, rsr_…; alternative to runId")
@@ -11528,6 +11537,20 @@ var ACTION_DEFINITIONS = [
     toolset: "loop",
     run: forward("computer_runtime.run_receipt")
   },
+  {
+    name: "computer_run_setup",
+    title: "Run the declared setup",
+    description: "Run this Run's own declared project setup once, explicitly — Arbor resolves the authoritative recipe internally, so you neither supply nor see the command, and reusing the same idempotencyKey recovers a lost response instead of installing twice. Nothing runs it for you: a successful run is what makes setupReadiness ready, and it is refused unless the Run is isolated and a setup is declared.",
+    inputSchema: {
+      runId: string2().describe("the Run whose declared setup should run, run_…"),
+      idempotencyKey: string2().describe("stable key for this ONE logical setup request; reuse it unchanged for retries"),
+      background: boolean2().optional().describe("return a processId immediately instead of waiting; read it with computer_process_read"),
+      timeout: number2().int().optional().describe("process kill deadline in milliseconds")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_runtime.run_setup")
+  },
   {
     name: "computer_runs",
     title: "List runs",
@@ -12346,11 +12369,15 @@ var ACTION_DEFINITIONS = [
   {
     name: "list_goals",
     title: "List goals",
-    description: "List compact goals attached to one Space, or a Thread's linked goals plus its available pick list. Space lists are compact cards; Thread lists page only the available `all` list and keep `linked` complete; view=summary returns 3 active goals. Archived goals are omitted.",
+    description: "List compact goals attached to one Space, or a Thread's linked goals plus its available pick list. Space lists are compact cards; Thread lists page only the available `all` list and keep `linked` complete; view=summary returns 3 active goals; status pages named lifecycles before the page.",
     inputSchema: {
       spaceId: string2().optional().describe("a Space whose attached goals to list, spc_…"),
       threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_…"),
-      view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Omit for the full attached list."),
+      view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Ignores status. Omit for the attached list."),
+      status: union([
+        _enum(["active", "paused", "completed", "archived"]),
+        array(_enum(["active", "paused", "completed", "archived"])).min(1)
+      ]).optional().describe("Space list only. One or more of active, paused, completed, archived. Filters before the page. Active goals come first, then most recently active within a lifecycle. Archived goals are included only when archived is named. Omit for the attached list (archived dropped, not active-only). view=summary ignores status."),
       ...PAGINATION_INPUT
     },
     surfaces: ["cli"],
@@ -12641,11 +12668,15 @@ var ACTION_DEFINITIONS = [
   {
     name: "goal_list",
     title: "List goals",
-    description: "List compact goals attached to one Space, or the linked and available goals for one Thread. Space pages omit relatedThreads; Thread pages keep linked complete and page only the available `all` list; view=summary returns 3 active goals; it cannot mutate a goal.",
+    description: "List compact goals attached to one Space, or the linked and available goals for one Thread. Space pages omit relatedThreads; Thread pages keep linked complete and page only the available `all` list; view=summary returns 3 active goals; status pages named lifecycles before the page; it cannot mutate a goal.",
     inputSchema: {
       spaceId: string2().optional().describe("a Space whose attached goals to list, spc_…"),
       threadId: string2().optional().describe("a Thread whose linked and available goals to list, thr_…"),
-      view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Omit for the full attached list."),
+      view: literal("summary").optional().describe("summary: Topics home — 3 most recently active goals (title + in-space linked Thread count). Ignores status. Omit for the attached list."),
+      status: union([
+        _enum(["active", "paused", "completed", "archived"]),
+        array(_enum(["active", "paused", "completed", "archived"])).min(1)
+      ]).optional().describe("Space list only. One or more of active, paused, completed, archived. Filters before the page. Active goals come first, then most recently active within a lifecycle. Archived goals are included only when archived is named. Omit for the attached list (archived dropped, not active-only). view=summary ignores status."),
       ...PAGINATION_INPUT
     },
     surfaces: ["mcp"],

package/package.json

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