@lambdacurry/arbor 0.21.20 → 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;
@@ -17843,6 +17870,8 @@ var MCP_OUTPUT_SCHEMAS = {
     scope: exports_external.literal("global"),
     forum: exports_external.looseObject({ title: exports_external.string(), purpose: nullableString }),
     topics: exports_external.array(jsonObject),
+    total: exports_external.number().int().min(0).optional(),
+    nextCursor: exports_external.string().optional(),
     privacy: exports_external.string()
   }),
   feedback_recall: exports_external.looseObject({
@@ -17856,7 +17885,10 @@ var MCP_OUTPUT_SCHEMAS = {
     canonicalThreadId: id,
     thread: jsonObject,
     topic: jsonObject,
-    contributions: exports_external.array(jsonObject),
+    contributions: exports_external.array(jsonObject).optional(),
+    recentContributions: exports_external.array(jsonObject).optional(),
+    contributionPage: exports_external.looseObject({ total: exports_external.number().int().min(0), nextCursor: nullableString }).optional(),
+    contributionCount: exports_external.number().int().min(0).optional(),
     mergedFrom: exports_external.array(jsonObject),
     redirects: exports_external.array(jsonObject),
     privacy: exports_external.string()
@@ -18319,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()
@@ -18713,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",
@@ -19196,10 +19232,12 @@ var ACTION_DEFINITIONS = [
   {
     name: "feedback_tree",
     title: "Browse the shared Arbor Feedback forum",
-    description: "Browse the global Arbor Feedback forum by Topic and optional Thread roster; the global scope is implied and no Space id is required. New reports appear as their own shared Threads as submitted; private receipt metadata and reviewer diagnostics are never returned.",
+    description: "Browse the global Arbor Feedback forum; Topics page by default, and depth=threads requires topicId to page one shared Thread roster (all=true is the only unscoped complete enumeration). New reports appear as their own shared Threads as submitted; private receipt metadata and reviewer diagnostics are never returned.",
     inputSchema: {
-      depth: exports_external.enum(["topics", "threads"]).optional().describe("topics (default) or threads to include each Topic's shared Thread roster"),
-      includeArchived: exports_external.boolean().optional().describe("include archived Topics/Threads for historical moderation or lookup (default false)")
+      depth: exports_external.enum(["topics", "threads"]).optional().describe("topics (default) or threads for one explicitly selected Feedback Topic"),
+      topicId: exports_external.string().optional().describe("depth=threads only: shared Feedback Topic whose Thread roster to page"),
+      includeArchived: exports_external.boolean().optional().describe("include archived Topics/Threads for historical moderation or lookup (default false)"),
+      ...PAGINATION_INPUT
     },
     surfaces: ["mcp", "cli"],
     toolset: "feedback",
@@ -19221,10 +19259,14 @@ var ACTION_DEFINITIONS = [
   {
     name: "feedback_thread_get",
     title: "Read a shared Arbor Feedback thread",
-    description: "Read one shared Arbor Feedback Thread, following a merge redirect to its canonical destination while preserving shared provenance. A newly filed report appears here as submitted; private receipt ids, reporter organization metadata, diagnostics, and private associations are not projected.",
+    description: "Read one shared Arbor Feedback Thread, following merge redirects while preserving shared provenance; MCP/CLI/API default to compact recent context, while view=full pages sanitized Contributions and all=true returns complete history. Private receipt ids, reporter organization metadata, diagnostics, and private associations are never projected.",
     inputSchema: {
-      threadId: exports_external.string().describe("the shared Feedback Thread id, thr_…")
+      threadId: exports_external.string().describe("the shared Feedback Thread id, thr_…"),
+      view: exports_external.enum(["full", "compact"]).optional().describe("MCP/CLI/API default compact; full pages the shared Contribution transcript"),
+      recentLimit: exports_external.number().int().min(1).max(20).optional().describe("compact reads only: latest shared Contributions to include (default 6, max 20)"),
+      ...PAGINATION_INPUT
     },
+    externalReadDefaults: { view: EXTERNAL_DEFAULT_THREAD_VIEW },
     surfaces: ["mcp", "cli"],
     toolset: "feedback",
     run: forward("feedback.thread_get")
@@ -19659,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.20",
+  "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",