@lambdacurry/arbor 0.24.33 → 0.24.34

package/dist/arbor.js

@@ -10324,6 +10324,20 @@ var RUN_PROVIDER_LIFECYCLE_PHASES = [
   "workspace_freeze"
 ];
 var RUN_PROVIDER_LIFECYCLE_PHASE_SET = new Set(RUN_PROVIDER_LIFECYCLE_PHASES);
+var RUN_RESTORE_PHASE_KEYS = [
+  "verify",
+  "cacheBoot",
+  "cacheReady",
+  "cacheSweep",
+  "proof",
+  "homeReset",
+  "boot",
+  "ready",
+  "sweep",
+  "extract",
+  "chown"
+];
+var RUN_RESTORE_PHASE_KEY_SET = new Set(RUN_RESTORE_PHASE_KEYS);
 var OWNER_ACTION_EVENT_TYPES = new Set([
   "run.started",
   "process.starting",
@@ -10830,6 +10844,14 @@ function buildOutputSchemas() {
     lastDurableSnapshotId: id.nullable(),
     unsavedChanges: literal("not-saved-by-close")
   });
+  const runRestoreFacts = looseObject({
+    source: _enum(["native-cache", "durable-r2"]),
+    decision: _enum(["ok", "no_native", "image_mismatch", "too_old"]).nullable().optional(),
+    missPhase: _enum(["boot", "proof", "homeReset"]).nullable().optional(),
+    missErrorType: string2().nullable().optional(),
+    wallMs: number2().int().min(0).optional(),
+    phasesMs: record(string2(), number2().int().min(0)).optional()
+  });
   const computerRunReceipt = looseObject({
     runId: id,
     threadId: id,
@@ -10917,6 +10939,10 @@ function buildOutputSchemas() {
       reasonCode: string2().optional()
     })),
     lifecycle: array(looseObject({ type: string2(), at: string2() })),
+    start: looseObject({
+      admittedMs: number2().nullable(),
+      restore: runRestoreFacts.extend({ observedAt: timestamp, providerGeneration: number2().int().min(0) }).nullable().describe("null means not recorded, never that no restore happened")
+    }).describe("F1 start→admitted milliseconds and the provider's starting-restore facts"),
     providerLifecycle: looseObject({
       generation: number2().int().min(0).nullable(),
       lastPhase: string2().nullable(),
@@ -10945,7 +10971,8 @@ function buildOutputSchemas() {
         retryOperation: _enum(["run_terminal_checkpoint", "run_release", "run_checkpoint_publication"]).optional(),
         retryAttempts: number2().int().positive().optional(),
         retryLastFailedAt: timestamp.optional(),
-        retryNextAttemptAt: timestamp.optional()
+        retryNextAttemptAt: timestamp.optional(),
+        restore: runRestoreFacts.optional()
       }))
     })
   });
@@ -11437,6 +11464,20 @@ function buildOutputSchemas() {
       startingSnapshot: snapshot.nullable(),
       config: computerConfig
     }),
+    computer_topic_base: looseObject({
+      topicId: id,
+      topicBase: looseObject({ id, createdAt: timestamp, contentDigest: string2().nullable() }).nullable(),
+      nativeCache: union([
+        looseObject({
+          state: literal("checked"),
+          native: looseObject({ capturedImage: string2(), capturedAt: timestamp.nullable() }).nullable(),
+          servingImageMatches: boolean2().nullable(),
+          decision: _enum(["ok", "no_native", "image_mismatch", "too_old"]).nullable(),
+          checkedAt: timestamp.nullable()
+        }),
+        looseObject({ state: literal("unavailable") })
+      ]).nullable().describe("null when there is no Topic base to check")
+    }),
     get_computer: looseObject({
       threadId: id,
       config: redactedComputerRecipe,
@@ -13081,6 +13122,7 @@ var MCP_TOOL_ANNOTATIONS = {
   set_topic_computer: destructiveIdempotent,
   set_thread_computer: destructiveIdempotent,
   get_computer: readOnly,
+  computer_topic_base: readOnly,
   computer_inventory: readOnly,
   computer_audit_access: additive,
   transition_thread: additive,
@@ -14503,7 +14545,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_receipt",
     title: "Read a run receipt",
-    description: "Read pending admission, finish continuation, Run-owned operation/activity state, and providerLifecycle with exactly one of runId or runStartId instead of parent computer_status. This read drives nothing; setupReadiness is not an instruction to reinstall: run computer_run_setup when the task needs a prepared workspace, then save work outside the temporary Computer before finishing.",
+    description: "Read pending admission, finish continuation, Run-owned operation/activity state, providerLifecycle, and the start facts with exactly one of runId or runStartId instead of parent computer_status. This read drives nothing; setupReadiness is not an instruction to reinstall: run computer_run_setup when the task needs a prepared workspace, then save work outside the temporary Computer before finishing.",
     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")
@@ -14947,6 +14989,17 @@ var ACTION_DEFINITIONS = [
     toolset: "loop",
     run: forward("computer.get")
   },
+  {
+    name: "computer_topic_base",
+    title: "Check a Topic base's native cache",
+    description: "Read this Topic's current base and, live from Currybox control, its captured image and time, whether the serving image still matches, and the native-cache decision Runs will get. One read when asked: it never recaptures, retires, starts, or caches anything; nativeCache.state=unavailable means control could not answer, and a null topicBase means no base exists yet.",
+    inputSchema: {
+      topicId: string2().describe("the Topic, top_…")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer.topic_base")
+  },
   {
     name: "computer_audit_access",
     title: "Issue a Computer audit grant",
@@ -16788,7 +16841,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 });
 
 // ../actions/src/retention-entry.ts
-var ARBOR_VERSION = "0.24.33";
+var ARBOR_VERSION = "0.24.34";
 var historyPolicySchema = _enum(["full", "checkpoint"]).optional().describe("text Artifacts: future history retention policy; full retains every source snapshot, checkpoint keeps metadata for every revision and source only when explicitly retained");
 var retainSourceSchema = boolean2().optional().describe("edit: in checkpoint mode, retain this newly minted content revision's source");
 var checkpointSchema = boolean2().optional().describe("edit: retain the exact current version source without incrementing content version");
@@ -17196,7 +17249,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.33",
+  version: "0.24.34",
   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",

package/package.json

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