@lambdacurry/arbor 0.24.33 → 0.24.35

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,
@@ -11984,6 +12025,46 @@ function buildOutputSchemas() {
           serializedByteLimit: number2().int().positive()
         })
       }),
+      presence: discriminatedUnion("status", [
+        object({ status: literal("absent") }).strict(),
+        object({ status: literal("unavailable") }).strict(),
+        looseObject({
+          status: literal("present"),
+          sessions: number2().int().positive(),
+          pageId: string2().nullable(),
+          viewport: jsonObject.nullable(),
+          lastActiveAt: timestamp.nullable(),
+          selection: looseObject({
+            shapeIds: array(string2()),
+            shapes: array(jsonObject),
+            missingShapeIds: array(string2()),
+            clusterIds: array(string2()),
+            bounds: jsonObject.nullable()
+          })
+        })
+      ]).optional(),
+      comments: looseObject({
+        items: array(looseObject({
+          contributionId: id,
+          url: string2(),
+          author: jsonObject,
+          createdAt: timestamp,
+          text: string2(),
+          anchor: jsonObject,
+          replyCount: number2().int().nonnegative(),
+          replies: array(jsonObject)
+        })),
+        total: number2().int().nonnegative(),
+        omitted: number2().int().nonnegative()
+      }).optional(),
+      screenshot: looseObject({
+        mimeType: literal("image/png"),
+        width: number2().int().positive(),
+        height: number2().int().positive(),
+        bounds: jsonObject,
+        shapeCount: number2().int().positive(),
+        data: string2().optional()
+      }).optional(),
       preview: tldrawLatestPreview
     }),
     tldraw_exec: looseObject({
@@ -12975,6 +13056,9 @@ var OUTPUT_SHAPERS = {
     ["documentClock", result.documentClock],
     ["documentDigest", result.documentDigest],
     ["scene", result.scene],
+    ["presence", result.presence],
+    ["comments", result.comments],
+    ["screenshot", result.screenshot],
     ["preview", compactTldrawPreview(result.preview)]
   ]),
   computer_write: (result) => defined([
@@ -13081,6 +13165,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,
@@ -13252,12 +13337,37 @@ var shapeId = TLDRAW_SHAPE_ID_SCHEMA.describe("stable tldraw shape id, shape:…
 var shapeType = _enum(["geo", "text", "note", "frame", "arrow", "line", "draw", "group"]).describe("built-in tldraw shape type; use code mode for custom or asset-backed shapes");
 var finite = number2().finite();
 var jsonRecord = record(string2(), unknown());
+var diagramKey = string2().min(1).max(80).describe("caller-meaningful node key; returned as the alias for its generated tldraw shape id");
+var pageIdFilter = string2().min(1).max(200).describe("optional page id to search");
+var textRef = object({
+  text: string2().min(1).max(500),
+  match: _enum(["exact", "contains"]).optional().describe("exact (default, case/whitespace-insensitive) or contains"),
+  type: string2().min(1).max(64).optional().describe("optional shape type filter"),
+  pageId: pageIdFilter.optional()
+}).strict().describe("the one existing shape whose text matches");
+var descriptionRef = object({ description: string2().min(1).max(200), pageId: pageIdFilter.optional() }).strict().describe(`the one existing shape a description like 'the blue box labelled "API" in the top right' names (quoted label, kind, colour, region are strict filters)`);
+var selectedRef = object({ selected: literal(true) }).strict().describe("your one currently selected shape in an open board tab");
+var createdRef = object({
+  created: union([literal("last"), number2().int().min(0).max(TLDRAW_EXEC_MAX_OPERATIONS)])
+}).strict().describe('a shape created earlier in this batch: "last" or its 0-based create index');
+var keyRef = object({ key: diagramKey }).strict().describe("a diagram node created earlier in this batch, by its key");
+var TLDRAW_SHAPE_REF_SCHEMA = union([shapeId, textRef, descriptionRef, selectedRef, createdRef, keyRef]).describe("shape id, or { text } | { description } | { selected: true } | { created } | { key }; resolved before any edit, ambiguity refuses");
+var shapeRef = TLDRAW_SHAPE_REF_SCHEMA;
+var selectedAllRef = object({ selected: literal("all") }).strict().describe("every currently selected shape in your open board tab");
+var shapeRefs = array(union([shapeId, textRef, descriptionRef, selectedRef, createdRef, keyRef, selectedAllRef])).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS);
+var place = object({
+  relativeTo: shapeRef.describe("the existing or earlier-created shape to place beside"),
+  side: _enum(["right", "left", "above", "below"]),
+  gap: finite.min(0).max(1e4).optional().describe("edge-to-edge gap; defaults to 40"),
+  align: _enum(["start", "center", "end"]).optional().describe("cross-axis alignment with the target; defaults to center")
+}).strict().describe("place the new shape beside another instead of giving x/y");
 var create = object({
   op: literal("create"),
   id: shapeId,
   type: shapeType,
-  x: finite,
-  y: finite,
+  x: finite.optional().describe("page x; omit only when place is given"),
+  y: finite.optional().describe("page y; omit only when place is given"),
+  place: place.optional(),
   parentId: string2().min(1).max(200).optional(),
   rotation: finite.optional(),
   opacity: finite.min(0).max(1).optional(),
@@ -13267,8 +13377,8 @@ var create = object({
 }).strict();
 var update = object({
   op: literal("update"),
-  id: shapeId,
-  type: shapeType,
+  id: shapeRef,
+  type: shapeType.optional().describe("optional; read from the resolved shape when omitted"),
   x: finite.optional(),
   y: finite.optional(),
   parentId: string2().min(1).max(200).optional(),
@@ -13278,20 +13388,18 @@ var update = object({
   props: jsonRecord.optional().describe("partial shape properties"),
   meta: jsonRecord.optional()
 }).strict();
-var shapeIds = array(shapeId).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS);
-var diagramKey = string2().min(1).max(80).describe("caller-meaningful node key; returned as the alias for its generated tldraw shape id");
 var diagramLabel = string2().min(1).max(160);
 var stack = object({
   op: literal("stack"),
-  ids: shapeIds.min(2).describe("native shapes in the exact stack order; first id is the anchor"),
+  ids: shapeRefs.describe("shapes in the exact stack order; the first is the anchor (at least 2)"),
   axis: _enum(["horizontal", "vertical"]),
   gap: finite.min(0).describe("required edge-to-edge gap between adjacent shapes"),
   alignment: _enum(["start", "center", "end"]).optional().describe("optional cross-axis alignment relative to the first shape")
 }).strict();
 var connect = object({
   op: literal("connect"),
-  sourceId: shapeId.describe("existing native shape to bind the arrow start to"),
-  targetId: shapeId.describe("existing native shape to bind the arrow end to")
+  sourceId: shapeRef.describe("existing native shape to bind the arrow start to"),
+  targetId: shapeRef.describe("existing native shape to bind the arrow end to")
 }).strict();
 var diagram = object({
   op: literal("diagram"),
@@ -13309,26 +13417,32 @@ var diagram = object({
 var TLDRAW_EXEC_OPERATION_SCHEMA = discriminatedUnion("op", [
   create,
   update,
-  object({ op: literal("delete"), ids: shapeIds }).strict(),
+  object({ op: literal("delete"), ids: shapeRefs }).strict(),
   object({
     op: literal("align"),
-    ids: shapeIds.min(2),
+    ids: shapeRefs.describe("at least 2 shapes"),
     alignment: _enum(["bottom", "center-horizontal", "center-vertical", "left", "right", "top"])
   }).strict(),
   object({
     op: literal("distribute"),
-    ids: shapeIds.min(3),
+    ids: shapeRefs.describe("at least 3 shapes"),
     axis: _enum(["horizontal", "vertical"])
   }).strict(),
   object({
     op: literal("group"),
-    ids: shapeIds.min(2),
+    ids: shapeRefs.describe("at least 2 shapes"),
     groupId: shapeId.optional()
   }).strict(),
   stack,
   connect,
   diagram
 ]);
+var MIN_REFERENCE_COUNT = {
+  align: 2,
+  distribute: 3,
+  group: 2,
+  stack: 2
+};
 var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).max(TLDRAW_EXEC_MAX_OPERATIONS).superRefine((operations, ctx) => {
   const createdIds = new Set;
   const diagramKeys = new Set;
@@ -13345,20 +13459,43 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
       }
       createdIds.add(operation.id);
     }
+    if (operation.op === "create") {
+      const hasPoint = operation.x !== undefined || operation.y !== undefined;
+      if (operation.place ? hasPoint : operation.x === undefined || operation.y === undefined) {
+        ctx.addIssue({
+          code: "custom",
+          message: "create needs both x and y, or place instead of x/y",
+          path: [index, operation.place ? "place" : "x"]
+        });
+      }
+    }
     if ("ids" in operation) {
       const seen = new Set;
       operation.ids.forEach((id, idIndex) => {
-        if (seen.has(id)) {
+        const key = typeof id === "string" ? id : JSON.stringify(id);
+        if (seen.has(key)) {
           ctx.addIssue({
             code: "custom",
-            message: `duplicate shape id: ${id}`,
+            message: `duplicate shape reference: ${key}`,
             path: [index, "ids", idIndex]
           });
         }
-        seen.add(id);
+        seen.add(key);
       });
+      const minimum = MIN_REFERENCE_COUNT[operation.op] ?? 1;
+      const expands = operation.ids.some((id) => typeof id === "object" && ("selected" in id) && id.selected === "all");
+      if (!expands && operation.ids.length < minimum) {
+        ctx.addIssue({
+          code: "too_small",
+          origin: "array",
+          minimum,
+          inclusive: true,
+          message: `${operation.op} needs at least ${minimum} shapes`,
+          path: [index, "ids"]
+        });
+      }
     }
-    if (operation.op === "connect" && operation.sourceId === operation.targetId) {
+    if (operation.op === "connect" && canonicalJson(operation.sourceId) === canonicalJson(operation.targetId)) {
       ctx.addIssue({
         code: "custom",
         message: "connect self-loops are not supported",
@@ -13422,6 +13559,16 @@ var TLDRAW_EXEC_OPERATIONS_SCHEMA = array(TLDRAW_EXEC_OPERATION_SCHEMA).min(1).m
     }
   });
 }).describe("preferred declarative edits, applied in order; mutually exclusive with code");
+function canonicalJson(value) {
+  if (Array.isArray(value)) {
+    return `[${value.map((item) => item === undefined ? "null" : canonicalJson(item)).join(",")}]`;
+  }
+  if (value && typeof value === "object") {
+    const entries = Object.entries(value).filter(([, item]) => item !== undefined).sort(([a], [b]) => a.localeCompare(b));
+    return `{${entries.map(([key, item]) => `${JSON.stringify(key)}:${canonicalJson(item)}`).join(",")}}`;
+  }
+  return JSON.stringify(value) ?? "null";
+}
 // ../actions/src/index.ts
 var ARTIFACT_TYPE_DESCRIPTION = `semantic type (one of: ${ARTIFACT_TYPES.join(", ")})`;
 var ARBOR_FEEDBACK_INPUT_TYPES = [...ARBOR_FEEDBACK_TYPES, "friction"];
@@ -14064,7 +14211,14 @@ var ACTION_DEFINITIONS = [
         id: string2(),
         label: string2()
       })).optional().describe("inline @-mentions in the body; person mentions notify"),
-      links: array(object({ rel: _enum(CONTRIBUTION_ADD_LINK_RELS), targetId: string2() })).optional().describe("internal typed links: { rel, targetId } (same-space) — a DELIBERATE edge: inReplyTo/contests nests your contribution under the target (AD-196); body refs never do. External refs go IN THE BODY as URLs.")
+      links: array(object({ rel: _enum(CONTRIBUTION_ADD_LINK_RELS), targetId: string2() })).optional().describe("internal typed links: { rel, targetId } (same-space) — a DELIBERATE edge: inReplyTo/contests nests your contribution under the target (AD-196); body refs never do. External refs go IN THE BODY as URLs."),
+      anchor: object({
+        artifactId: string2().describe("a tldraw board whose source Thread is this Thread"),
+        shapeId: TLDRAW_SHAPE_ID_SCHEMA.optional(),
+        pageId: string2().min(1).max(200).optional(),
+        x: number2().finite().optional(),
+        y: number2().finite().optional()
+      }).strict().optional().describe("pin this contribution to a board as a comment: shapeId, or pageId + x/y page point; reply to one with links inReplyTo")
     },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
@@ -14503,7 +14657,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 +15101,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",
@@ -16239,7 +16404,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_observe",
     title: "Observe a tldraw board",
-    description: `Read bounded scene/clock/digest/lint, scoped by shape ids or region; preview defaults to metadata, ensure reuses/renders latest PNG (renderInProgress: retry shortly); lint is advisory. MCP is links-only for viewing/downloading (model pixels vary by client); signedRead is 5-min/single-Attachment, never for posts; use permanent markdown; guide: ${AGENT_GUIDE_URLS.tldraw}.`,
+    description: `Read bounded scene/clock/digest/lint with labelled clusters, your own open tab's presence, and anchored comments, scoped by ids, region, or clusterIds; screenshot renders just the scope inline; preview ensure reuses/renders the board PNG (renderInProgress: retry shortly). Preview is links-only; signedRead is 5-min, never for posts; guide: ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       pageId: string2().min(1).max(200).optional().describe("optional page to observe"),
@@ -16250,6 +16415,13 @@ var ACTION_DEFINITIONS = [
         width: number2().finite().positive(),
         height: number2().finite().positive()
       }).optional().describe("optional page-coordinate rectangle; returns shapes whose page bounds intersect it, and combines with ids by intersection"),
+      clusterIds: array(string2().regex(/^cluster:[0-9a-z]{1,13}(?:-\d{1,4})?$/)).min(1).max(50).refine((values) => new Set(values).size === values.length, "cluster ids must be unique").optional().describe("drill into these clusters from a prior observe (ids change when their shapes do); intersects with ids/region"),
+      clusterCursor: string2().max(32).optional().describe("continue the cluster listing from a prior observe's scene.nextClusterCursor"),
+      view: _enum(["full", "clusters"]).optional().describe("full (default) returns shapes; clusters returns only the cluster overview"),
+      screenshot: object({
+        maxWidth: number2().int().min(64).max(1536).optional(),
+        maxHeight: number2().int().min(64).max(1536).optional()
+      }).strict().optional().describe("render only the observed scope (clusterIds/ids/region, else the page) as a PNG fitting maxWidth×maxHeight (default 768); returned as image content"),
       viewportWidth: number2().int().min(320).max(1920).optional(),
       viewportHeight: number2().int().min(240).max(1080).optional(),
       preview: _enum(["metadata", "ensure"]).optional().describe("preview behavior; defaults to metadata, while ensure explicitly refreshes only when stale/missing")
@@ -16261,7 +16433,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_exec",
     title: "Run a one-shot tldraw program",
-    description: `Modify the current live tldraw board with preferred declarative operations or bounded JavaScript, including graph-scoped diagram layout, ordered exact-gap stack composition, and safe native bound connect without caller-supplied connector geometry, then return a durable execution receipt; use IDs from a fresh observe, reacquire this current schema after compaction, and never replay an unknown result. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
+    description: `Modify the live tldraw board with preferred declarative operations or bounded JavaScript (diagram layout, exact-gap stack, native bound connect, create place); operations take shape ids or { text | description | selected | created | key } references resolved before any edit, and ambiguity refuses the batch. Returns a durable receipt; reacquire this schema after compaction and never replay an unknown result; first use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       code: string2().min(1).max(1e5).optional().describe("advanced script source; mutually exclusive with operations"),
@@ -16788,7 +16960,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 });
 
 // ../actions/src/retention-entry.ts
-var ARBOR_VERSION = "0.24.33";
+var ARBOR_VERSION = "0.24.35";
 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 +17368,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.33",
+  version: "0.24.35",
   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.35",
   "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",