@lambdacurry/arbor 0.21.21 → 0.21.22

package/dist/arbor.js

@@ -2112,6 +2112,32 @@ var computerSnapshots = sqliteTable("computer_snapshots", {
   runIdx: index("computer_snapshots_run_idx").on(t.runId, t.createdAt),
   parentIdx: index("computer_snapshots_parent_idx").on(t.parentSnapshotId)
 }));
+var computerRunStarts = sqliteTable("computer_run_starts", {
+  id: text("id").primaryKey(),
+  computerId: text("computer_id").notNull().references(() => threadComputers.id),
+  threadId: text("thread_id").notNull().references(() => threads.id),
+  originatingSessionId: text("originating_session_id").notNull().references(() => computerSessions.id),
+  profileId: text("profile_id").notNull().references(() => profiles.id),
+  executionContextId: text("execution_context_id").notNull().references(() => executionContexts.id),
+  idempotencyKey: text("idempotency_key").notNull(),
+  idempotencyFingerprint: text("idempotency_fingerprint").notNull(),
+  mode: text("mode").$type().notNull(),
+  execution: text("execution").$type().notNull(),
+  label: text("label"),
+  checkpointLineageKey: text("checkpoint_lineage_key"),
+  checkpointExpectedCurrentSnapshotId: text("checkpoint_expected_current_snapshot_id").references(() => computerSnapshots.id),
+  checkpointParentSnapshotId: text("checkpoint_parent_snapshot_id").references(() => computerSnapshots.id),
+  snapshotId: text("snapshot_id").references(() => computerSnapshots.id),
+  runId: text("run_id").references(() => computerRuns.id),
+  createdAt: ts("created_at").notNull(),
+  updatedAt: ts("updated_at").notNull()
+}, (t) => ({
+  idempotencyIdx: uniqueIndex("computer_run_starts_idempotency_idx").on(t.threadId, t.profileId, t.idempotencyKey),
+  threadIdx: index("computer_run_starts_thread_idx").on(t.threadId, t.createdAt),
+  checkpointLineageIdx: uniqueIndex("computer_run_starts_checkpoint_lineage_idx").on(t.checkpointLineageKey),
+  snapshotIdx: index("computer_run_starts_snapshot_idx").on(t.snapshotId),
+  runIdx: uniqueIndex("computer_run_starts_run_idx").on(t.runId)
+}));
 var previews = sqliteTable("previews", {
   id: text("id").primaryKey(),
   threadId: text("thread_id").notNull().references(() => threads.id),
@@ -2771,6 +2797,7 @@ var watches = sqliteTable("watches", {
   watchTargetIdx: index("watches_target_idx").on(t.targetType, t.targetId)
 }));
 // ../core/src/ops/computer-run.ts
+var COMPUTER_RUN_START_CHECKPOINT_RESERVATION_STALE_MS = 12 * 60 * 1000;
 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;
@@ -18324,7 +18351,9 @@ var MCP_OUTPUT_SCHEMAS = {
     ]).optional()
   }),
   computer_run_start: exports_external.object({
+    runStartId: id,
     runId: id,
+    replayed: exports_external.boolean(),
     execution: exports_external.enum(["shared", "isolated"]),
     durability: computerRunDurabilitySummary,
     status: exports_external.string()
@@ -18718,7 +18747,9 @@ var OUTPUT_SHAPERS = {
     const run = record2(result.run) ?? {};
     const durability = record2(run.durability) ?? {};
     return defined([
+      ["runStartId", result.runStartId],
       ["runId", run.runId],
+      ["replayed", result.replayed],
       ["execution", run.execution],
       [
         "durability",
@@ -19670,12 +19701,13 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_start",
     title: "Start a run",
-    description: "Start one bounded unit of work inside an opened Thread Computer. Write Runs default to isolated; if isolated provisioning fails after the durable Run exists, the error returns its runId and points to computer_run_receipt so the caller can inspect the terminal reason without listing or guessing.",
+    description: "Start one bounded unit of work inside an opened Thread Computer with a caller-owned idempotency key so response loss can recover zero-or-one Run creation without listing. Write Runs default isolated; post-creation provisioning failures keep returning the exact runId and computer_run_receipt recovery.",
     inputSchema: {
       computerSessionId: exports_external.string().describe("the computerSessionId returned by computer_open, cms_…"),
       mode: exports_external.enum(["read", "write"]).describe("write for mutable work; read for shared inspection"),
       execution: exports_external.enum(["shared", "isolated"]).optional().describe("write Run placement; defaults to isolated. Use shared only for intentional live collaboration on the Thread Computer"),
-      label: exports_external.string().max(120).optional().describe("short factual label for this unit of work")
+      label: exports_external.string().max(120).optional().describe("short factual label for this unit of work"),
+      idempotencyKey: exports_external.string().min(1).max(200).describe("stable key for this ONE logical Run-start request; reuse it unchanged for retries")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",

package/package.json

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