@lambdacurry/arbor 0.24.12 → 0.24.14

package/dist/arbor.js

@@ -646,7 +646,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.12",
+  version: "0.24.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",
@@ -8559,6 +8559,7 @@ var computerRuns = sqliteTable("computer_runs", {
   execution: text("isolation").$type().notNull(),
   workspaceDir: text("workspace_dir").notNull(),
   baseSnapshotId: text("base_snapshot_id"),
+  sourceRunId: text("source_run_id"),
   currentSnapshotId: text("current_snapshot_id"),
   runtimeState: text("runtime_state").$type().notNull().default("shared"),
   runtimeUpdatedAt: ts("runtime_updated_at"),
@@ -8755,6 +8756,8 @@ var computerRunStarts = sqliteTable("computer_run_starts", {
   checkpointParentSnapshotId: text("checkpoint_parent_snapshot_id").references(() => computerSnapshots.id),
   snapshotId: text("snapshot_id").references(() => computerSnapshots.id),
   runId: text("run_id").references(() => computerRuns.id),
+  sourceRunId: text("source_run_id").references(() => computerRuns.id),
+  sourceSnapshotId: text("source_snapshot_id").references(() => computerSnapshots.id),
   createdAt: ts("created_at").notNull(),
   updatedAt: ts("updated_at").notNull()
 }, (t) => ({
@@ -10378,6 +10381,7 @@ function buildOutputSchemas() {
     repositories: computerRunGitStartRepositories.describe("the inherited base's repositories before any requested revision was checked out"),
     materialized: looseObject({ repositories: computerRunGitStartRepositories }).optional().describe("the workspace as admitted, at each requested revision; read this, when present, for what the Run started on")
   });
+  const computerRunSource = object({ runId: id, snapshotId: id.nullable() }).optional().describe("this Run began at source.runId's durable checkpoint snapshotId");
   const computerRun = looseObject({
     runId: id,
     computerId: id,
@@ -10389,6 +10393,7 @@ function buildOutputSchemas() {
     execution: _enum(["shared", "isolated"]),
     workspaceDir: string2(),
     baseSnapshotId: id.nullable(),
+    source: computerRunSource,
     currentSnapshotId: id.nullable().optional(),
     runtime: computerRunRuntime,
     gitStart: computerRunGitStart.nullable().optional(),
@@ -10446,6 +10451,7 @@ function buildOutputSchemas() {
     execution: _enum(["shared", "isolated"]),
     workspace: looseObject({ dir: string2() }),
     baseSnapshotId: id.nullable(),
+    source: computerRunSource,
     runtime: computerRunRuntime,
     gitStart: computerRunGitStart.nullable().optional(),
     durability: computerRunDurability,
@@ -11703,6 +11709,7 @@ function buildOutputSchemas() {
       runId: id,
       replayed: boolean2(),
       execution: _enum(["shared", "isolated"]),
+      source: computerRunSource,
       durability: computerRunDurabilitySummary,
       status: string2()
     }),
@@ -11714,6 +11721,16 @@ function buildOutputSchemas() {
       parentCheckpoint: string2().optional(),
       parentAsleep: boolean2().optional()
     }),
+    computer_run_promote: looseObject({
+      snapshotId: id,
+      previousSnapshotId: id,
+      computerId: id,
+      generation: number2(),
+      sourceRunId: id,
+      sourceSnapshotId: id,
+      promotedAt: string2(),
+      replayed: boolean2()
+    }),
     computer_run_finish: looseObject({
       runId: id,
       status: string2(),
@@ -12318,6 +12335,7 @@ var OUTPUT_SHAPERS = {
       ["runId", run.runId],
       ["replayed", result.replayed],
       ["execution", run.execution],
+      ["source", selected(run.source, ["runId", "snapshotId"])],
       [
         "durability",
         defined([
@@ -12341,6 +12359,19 @@ var OUTPUT_SHAPERS = {
       ["parentAsleep", result.parentAsleep]
     ]);
   },
+  computer_run_promote: (result) => {
+    const promotion = record2(result.promotion) ?? {};
+    return defined([
+      ["snapshotId", promotion.snapshotId],
+      ["previousSnapshotId", promotion.previousSnapshotId],
+      ["computerId", promotion.computerId],
+      ["generation", promotion.generation],
+      ["sourceRunId", promotion.sourceRunId],
+      ["sourceSnapshotId", promotion.sourceSnapshotId],
+      ["promotedAt", promotion.promotedAt],
+      ["replayed", result.replayed]
+    ]);
+  },
   computer_run_finish: (result) => {
     const run = record2(result.run) ?? {};
     return defined([
@@ -12577,6 +12608,7 @@ var MCP_TOOL_ANNOTATIONS = {
   computer_reprovision: destructiveIdempotent,
   computer_run_start: idempotent,
   computer_run_suspend: idempotent,
+  computer_run_promote: idempotent,
   computer_repo_work_status: readOnly,
   computer_run_finish: idempotent,
   computer_run_receipt: readOnly,
@@ -13767,6 +13799,8 @@ var ACTION_DEFINITIONS = [
         repository: string2().describe("configured GitHub repository as canonical owner/name"),
         head: string2().regex(/^[0-9a-fA-F]{40}(?:[0-9a-fA-F]{24})?$/).describe("exact 40- or 64-hex Git object id required before caller work")
       })).max(32).optional().describe("optional exact repository revisions the isolated workspace must prove before caller work"),
+      sourceRunId: string2().optional().describe("fork: a new isolated write Run restored from YOUR same-Thread Run's last durable checkpoint (its last suspend or admission; edits since are not included), run_…; active, suspended, or ended within 14 days or Keep; requires threadId; the source Run is never changed"),
+      sourceSnapshotId: string2().optional().describe("with sourceRunId: the exact checkpoint you expect (the source receipt's runtime.currentSnapshotId), cps_…; refused if it moved"),
       idempotencyKey: string2().min(1).max(200).describe("stable key for this ONE logical Run-start request; reuse it unchanged for retries")
     },
     surfaces: ["computer-mcp", "computer-cli"],
@@ -13784,6 +13818,20 @@ var ACTION_DEFINITIONS = [
     toolset: "loop",
     run: forward("computer_runtime.run_suspend")
   },
+  {
+    name: "computer_run_promote",
+    title: "Promote a Run checkpoint",
+    description: "Make YOUR active isolated Run's last saved checkpoint (not later edits) the shared Thread Computer's next head, fast-forward only; default new isolated Runs and the parent's next wake start from it. Refused with nothing changed unless the Run started from expectedHeadSnapshotId, the head is unmoved, and the shared Computer is asleep with no open shared Run or pending work; never merges.",
+    inputSchema: {
+      runId: string2().describe("YOUR active isolated WRITE Run whose checkpoint to promote, run_…"),
+      sourceSnapshotId: string2().describe("the exact checkpoint you expect to promote (the Run receipt's runtime.currentSnapshotId), cps_…; refused if it moved"),
+      expectedHeadSnapshotId: string2().describe("the shared checkpoint head this Run started from and will replace (the Run's baseSnapshotId), cps_…; refused if the head moved"),
+      idempotencyKey: string2().min(1).max(200).describe("stable key for this ONE logical promotion; a retry with the same inputs returns the original result")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_runtime.run_promote")
+  },
   {
     name: "computer_repo_work_status",
     title: "Inspect repository finish state",

package/package.json

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