@lambdacurry/arbor 0.21.7 → 0.21.9

package/dist/arbor.js

@@ -2774,6 +2774,22 @@ var watches = sqliteTable("watches", {
 var TERMINAL = new Set(["finished", "failed", "cancelled"]);
 var RUN_LIFECYCLE_TYPES = new Set(["run.started", "run.finished", "run.failed", "run.cancelled"]);
 var COMPUTER_RUN_ACTIVITY_LABEL_MAX = 120;
+var RUN_PROVIDER_LIFECYCLE_PHASES = [
+  "allocate",
+  "boot",
+  "restore",
+  "session",
+  "probe",
+  "readiness",
+  "ready",
+  "checkpoint",
+  "publish",
+  "suspend",
+  "release",
+  "lost",
+  "workspace_freeze"
+];
+var RUN_PROVIDER_LIFECYCLE_PHASE_SET = new Set(RUN_PROVIDER_LIFECYCLE_PHASES);
 
 // ../core/src/ops/computer.ts
 var MAX_COMPUTER_REPOSITORIES = 10;
@@ -17475,7 +17491,32 @@ var computerRunReceipt = exports_external.looseObject({
     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() }))
+  lifecycle: exports_external.array(exports_external.looseObject({ type: exports_external.string(), at: exports_external.string() })),
+  providerLifecycle: exports_external.looseObject({
+    generation: exports_external.number().int().min(0).nullable(),
+    lastPhase: exports_external.string().nullable(),
+    lastReasonCode: exports_external.string().nullable(),
+    lastEventId: exports_external.string().nullable(),
+    lastObservedAt: exports_external.string().nullable(),
+    replacementGeneration: exports_external.number().int().min(0).nullable(),
+    droppedCount: exports_external.number().int().min(0),
+    events: exports_external.array(exports_external.looseObject({
+      eventId: exports_external.string(),
+      observedAt: exports_external.string(),
+      phase: exports_external.string(),
+      providerGeneration: exports_external.number().int().min(0),
+      controlRelease: exports_external.string(),
+      attemptId: exports_external.string().optional(),
+      snapshotId: exports_external.string().optional(),
+      runtimeState: exports_external.enum(["live", "suspended"]).optional(),
+      releaseState: exports_external.enum(["live", "pending", "released"]).optional(),
+      reasonCode: exports_external.string().optional(),
+      providerHttpStatus: exports_external.number().int().optional(),
+      providerStopClass: exports_external.string().optional(),
+      providerRoute: exports_external.enum(["primary", "standby", "service"]).optional(),
+      parentWorkspaceFrozen: exports_external.boolean().optional()
+    }))
+  })
 });
 var computerCapabilityCard = exports_external.looseObject({
   capabilities: exports_external.array(exports_external.looseObject({
@@ -17823,6 +17864,7 @@ var MCP_OUTPUT_SCHEMAS = {
   }),
   admin_feedback_capability: jsonObject,
   admin_feedback_evidence: jsonObject,
+  admin_feedback: jsonObject,
   admin_feedback_topic: jsonObject,
   admin_feedback_thread: jsonObject,
   admin_feedback_publish: jsonObject,
@@ -18289,7 +18331,12 @@ var MCP_OUTPUT_SCHEMAS = {
         prCreate: exports_external.enum(["not-needed", "safe", "manual", "unknown"])
       }),
       nextAction: exports_external.string()
-    }))
+    })),
+    runDisposition: exports_external.looseObject({
+      action: exports_external.enum(["computer_run_suspend", "continue-local-work", "none"]),
+      resumeSameRunId: exports_external.boolean(),
+      reason: exports_external.string()
+    })
   }),
   computer_run_receipt: exports_external.looseObject({
     receipt: computerRunReceipt
@@ -18724,6 +18771,7 @@ var MCP_TOOL_ANNOTATIONS = {
   feedback_status: readOnly,
   admin_feedback_capability: destructiveIdempotent,
   admin_feedback_evidence: destructive,
+  admin_feedback: destructive,
   admin_feedback_topic: destructive,
   admin_feedback_thread: destructive,
   admin_feedback_publish: additive,
@@ -18892,6 +18940,49 @@ function dispatch(map2, reshape) {
     return ex.call(op, reshape && verb ? reshape(verb, rest) : rest);
   };
 }
+var ADMIN_FEEDBACK_VERBS = [
+  "publish",
+  "merge",
+  "transition",
+  "edit",
+  "curate",
+  "topic",
+  "create",
+  "update",
+  "move",
+  "archive",
+  "restore"
+];
+var ADMIN_FEEDBACK_THREAD_VERBS = new Set([
+  "create",
+  "update",
+  "move",
+  "transition",
+  "archive",
+  "restore",
+  "merge"
+]);
+var ADMIN_FEEDBACK_VERB_HELP = ADMIN_FEEDBACK_VERBS.join(" | ");
+function runAdminFeedback(ex, input) {
+  const { verb, ...rest } = input;
+  if (verb === "curate") {
+    if (rest.curate === "delete")
+      return ex.call("feedback_admin.remove", rest);
+    if (rest.curate === "restore")
+      return ex.call("feedback_admin.restore", rest);
+    return Promise.reject(new Error('curate requires curate "delete" or "restore"'));
+  }
+  if (verb && ADMIN_FEEDBACK_THREAD_VERBS.has(verb)) {
+    return ex.call("feedback_admin.thread", { ...rest, action: verb });
+  }
+  if (verb === "publish")
+    return ex.call("feedback_admin.publish", rest);
+  if (verb === "edit")
+    return ex.call("feedback_admin.edit", rest);
+  if (verb === "topic")
+    return ex.call("feedback_admin.topic", rest);
+  return Promise.reject(new Error(`unknown verb "${verb ?? ""}" — expected one of: ${ADMIN_FEEDBACK_VERB_HELP}`));
+}
 var NOTIFICATION_TRIAGE_DESCRIPTION = "READ ONLY: List your awareness feed newest first with unseen count and derived triage class: `settled-context` = settled Thread context; `owed-by-me` = an open request pointing to `inbox`; `judgment-available` = live engagement inviting judgment; `closed-loop` = your request completed; `room-motion` = ambient activity. Notifications are FYI, not a second obligation surface: `inbox` alone contains work owed by you; this cannot mark notifications read or modify inbox obligations.";
 var PAGINATION_INPUT = {
   limit: exports_external.number().int().min(1).optional().describe("max items to return — enables pagination"),
@@ -19083,6 +19174,36 @@ var ACTION_DEFINITIONS = [
       status: "feedback_admin.status"
     })
   },
+  {
+    name: "admin_feedback",
+    title: "Moderate shared Arbor Feedback",
+    description: "After a ship, recall matching Feedback, merge duplicates, publish the outcome, and transition the canonical Thread to resolved. Moderators only: this cannot file reports or expose receipt metadata.",
+    inputSchema: {
+      verb: exports_external.enum(ADMIN_FEEDBACK_VERBS).describe("close loop: publish, merge, transition; also edit, curate, topic, and thread lifecycle"),
+      threadId: exports_external.string().optional().describe("publish / update / move / transition / archive / restore: Thread id"),
+      type: exports_external.enum(CONTRIBUTION_TYPES).optional().describe("publish/edit: shared contribution type, including maintainer decision"),
+      body: exports_external.string().min(1).optional().describe("publish: follow-on body · edit: replacement body"),
+      summary: exports_external.string().max(500).nullable().optional().describe("publish/edit: gist; edit null/empty clears"),
+      confidence: exports_external.number().int().min(0).max(100).optional().describe("publish: 0–100 confidence"),
+      idempotencyKey: exports_external.string().min(1).max(200).optional().describe("publish: stable retry key"),
+      feedbackId: exports_external.string().optional().describe("publish: optional receipt id; additionally requires review_private"),
+      contributionId: exports_external.string().optional().describe("edit/curate: shared contribution id"),
+      curate: exports_external.enum(["delete", "restore"]).optional().describe("curate: delete or restore a shared contribution"),
+      action: exports_external.enum(["create", "update", "archive", "restore"]).optional().describe("topic: create, update, archive, or restore"),
+      topicId: exports_external.string().optional().describe("topic / create / move / update: Feedback Topic id"),
+      title: exports_external.string().min(1).optional().describe("topic/create/update: title"),
+      purpose: exports_external.string().optional().describe("topic: purpose"),
+      sourceThreadId: exports_external.string().optional().describe("merge: duplicate source Thread id"),
+      targetThreadId: exports_external.string().optional().describe("merge: canonical destination Thread id"),
+      objective: exports_external.string().min(1).optional().describe("create/update: Thread objective"),
+      status: exports_external.enum(["active", "needs-review", "stuck", "standing", "resolved", "archived"]).optional().describe("transition/update: target Thread status"),
+      reason: exports_external.string().optional().describe("merge: concise auditable rationale")
+    },
+    surfaces: ["mcp"],
+    toolset: "admin",
+    requiresCapability: "moderate",
+    run: runAdminFeedback
+  },
   {
     name: "admin_feedback_topic",
     title: "Maintain shared Feedback Topics",
@@ -19093,7 +19214,7 @@ var ACTION_DEFINITIONS = [
       title: exports_external.string().min(1).optional().describe("create/update: Topic title"),
       purpose: exports_external.string().optional().describe("create/update: Topic purpose")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
     toolset: "admin",
     run: forward("feedback_admin.topic")
   },
@@ -19112,7 +19233,7 @@ var ACTION_DEFINITIONS = [
       status: exports_external.enum(["active", "needs-review", "stuck", "standing", "resolved", "archived"]).optional().describe("transition/update: target Thread status"),
       reason: exports_external.string().optional().describe("merge: concise auditable rationale")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
     toolset: "admin",
     run: forward("feedback_admin.thread")
   },
@@ -19129,7 +19250,7 @@ var ACTION_DEFINITIONS = [
       idempotencyKey: exports_external.string().min(1).max(200).optional(),
       feedbackId: exports_external.string().optional().describe("optional receipt id; additionally requires review_private")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
     toolset: "admin",
     run: forward("feedback_admin.publish")
   },
@@ -19143,7 +19264,7 @@ var ACTION_DEFINITIONS = [
       summary: exports_external.string().max(500).nullable().optional().describe("replacement gist; null/empty clears"),
       type: exports_external.enum(CONTRIBUTION_TYPES).optional().describe("replacement shared contribution type")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
     toolset: "admin",
     run: forward("feedback_admin.edit")
   },
@@ -19155,7 +19276,7 @@ var ACTION_DEFINITIONS = [
       verb: exports_external.enum(["delete", "restore"]),
       contributionId: exports_external.string().describe("shared Feedback contribution id")
     },
-    surfaces: ["mcp", "cli"],
+    surfaces: ["cli"],
     toolset: "admin",
     run: dispatch({ delete: "feedback_admin.remove", restore: "feedback_admin.restore" })
   },
@@ -19442,7 +19563,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_repo_work_status",
     title: "Inspect repository finish state",
-    description: "READ ONLY: Inspect an active isolated WRITE Run before a push/PR retry or finish when Git publication, PR, CI, or review state matters. Returns authoritative durability/finishability, retry safety, mismatches, and the next repository action without mutating GitHub.",
+    description: "READ ONLY: Inspect an active isolated WRITE Run's Git publication, PR, CI, and review before retry, wait, or finish. Returns repository state (e.g. ci-pending) plus runDisposition.action computer_run_suspend when published work waits on CI/review/human authorization — the same runId resumes; dirty, unpublished, unknown-publication, failing, or changes-requested work keeps the local nextAction.",
     inputSchema: {
       runId: exports_external.string().describe("the active isolated WRITE Run to inspect, run_…")
     },
@@ -19467,7 +19588,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_receipt",
     title: "Read a run receipt",
-    description: "READ ONLY: Inspect one Run's durable receipt during or after execution, including its Run-owned operation/activity state; use this instead of parent computer_status to establish whether an isolated Run still has work in flight. Returns compact history/assessments and durable operation receipts, not raw command transcripts or process output.",
+    description: "READ ONLY: Inspect one Run's durable receipt during or after execution, including its Run-owned operation/activity state and a compact providerLifecycle journal (generation, last phase, typed reason) separate from command/process activity. Use this instead of parent computer_status; it returns compact history, not transcripts, and does not rewrite terminal reasonCode.",
     inputSchema: {
       runId: exports_external.string().describe("the run to read, run_… (from computer_run_start or computer_runs)")
     },
@@ -20360,7 +20481,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "service_register",
     title: "Register a Computer lifecycle service",
-    description: "Register a persistent service identity for Currybox Computer lifecycle maintenance and mint its API key (shown ONCE). Human owner/admin CLI setup only. The credential is restricted to computer.get + computer.lifecycle_runs + computer.checkpoint + computer.suspend_run + computer.resume_run + computer.reconcile_runs and to the Spaces listed here; store it as the Currybox control plane's Arbor credential.",
+    description: "Register a persistent service identity for Currybox Computer lifecycle maintenance and mint its API key (shown ONCE). Human owner/admin CLI setup only. The credential is restricted to computer.get + computer.lifecycle_runs + computer.append_run_lifecycle + computer.checkpoint + computer.suspend_run + computer.resume_run + computer.reconcile_runs and to the Spaces listed here; store it as the Currybox control plane's Arbor credential.",
     inputSchema: {
       displayName: exports_external.string().min(1).describe("the service display name, e.g. Currybox lifecycle service"),
       spaceIds: exports_external.array(exports_external.string().min(1)).min(1).describe("Spaces whose Thread computers the service may maintain")
@@ -21203,6 +21324,9 @@ var ACTION_DEFINITIONS = [
   }
 ];
 var ACTIONS = ACTION_DEFINITIONS.map((action) => {
+  if (action.requiresCapability && !action.surfaces.includes("mcp")) {
+    throw new Error(`${action.name}: requiresCapability is an MCP catalog gate`);
+  }
   if (!action.surfaces.some((surface) => surface === "mcp" || surface === "computer-mcp")) {
     return action;
   }

package/package.json

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