@lambdacurry/arbor 0.22.39 → 0.22.41

package/dist/arbor.js

@@ -2,7 +2,7 @@
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.22.39",
+  version: "0.22.41",
   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",
@@ -4921,6 +4921,16 @@ var IDENTITY_COLORS = [
   "rose",
   "cyan"
 ];
+var LIFECYCLE_TYPES = [
+  "backlog",
+  "active",
+  "needs-review",
+  "stuck",
+  "standing",
+  "resolved",
+  "canceled",
+  "archived"
+];
 var CONTRIBUTION_TYPES = [
   "comment",
   "question",
@@ -6464,13 +6474,15 @@ var threads = sqliteTable("threads", {
   title: text("title").notNull(),
   objective: text("objective").notNull(),
   status: text("status").$type().notNull().default("active"),
+  lifecycleType: text("lifecycle_type").$type().notNull().default("active"),
   waysToHelp: text("ways_to_help", { mode: "json" }).$type().notNull().default([]),
   openQuestions: text("open_questions", { mode: "json" }).$type().notNull().default([]),
   expectedOutput: text("expected_output").notNull().default(""),
   createdAt: ts("created_at").notNull()
 }, (t) => ({
   topicIdx: index("threads_topic_idx").on(t.topicId),
-  spaceIdx: index("threads_space_idx").on(t.spaceId)
+  spaceIdx: index("threads_space_idx").on(t.spaceId),
+  lifecycleTypeIdx: index("threads_lifecycle_type_idx").on(t.lifecycleType)
 }));
 var computerConfigs = sqliteTable("computer_configs", {
   id: text("id").primaryKey(),
@@ -6685,6 +6697,7 @@ var computerRuns = sqliteTable("computer_runs", {
   runtimeState: text("runtime_state").$type().notNull().default("shared"),
   runtimeUpdatedAt: ts("runtime_updated_at"),
   gitStart: text("git_start", { mode: "json" }).$type(),
+  f1Authority: text("f1_authority", { mode: "json" }).$type(),
   finishRequest: text("finish_request", { mode: "json" }).$type(),
   status: text("status").$type().notNull().default("active"),
   label: text("label"),
@@ -6698,6 +6711,60 @@ var computerRuns = sqliteTable("computer_runs", {
   statusIdx: index("computer_runs_status_idx").on(t.computerId, t.status),
   runtimeIdx: index("computer_runs_runtime_idx").on(t.computerId, t.runtimeState)
 }));
+var packageCacheObjects = sqliteTable("package_cache_objects", {
+  key: text("key").primaryKey(),
+  orgId: text("org_id").notNull().references(() => orgs.id),
+  project: text("project").notNull(),
+  ecosystem: text("ecosystem").notNull(),
+  originId: text("origin_id").notNull(),
+  integrityAlgorithm: text("integrity_algorithm").notNull(),
+  digest: text("digest").notNull(),
+  sri: text("sri").notNull(),
+  byteLength: integer2("byte_length").notNull(),
+  status: text("status").$type().notNull(),
+  uploadId: text("upload_id").notNull(),
+  producerRunId: text("producer_run_id").notNull().references(() => computerRuns.id),
+  producerTrust: text("producer_trust").$type().notNull(),
+  createdAt: ts("created_at").notNull(),
+  readyAt: ts("ready_at"),
+  expiresAt: ts("expires_at").notNull()
+}, (t) => ({
+  uploadUq: uniqueIndex("package_cache_objects_upload_uniq").on(t.uploadId),
+  projectStatusExpiryIdx: index("package_cache_objects_project_status_expiry_idx").on(t.orgId, t.project, t.status, t.expiresAt)
+}));
+var packageCacheProjectUsage = sqliteTable("package_cache_project_usage", {
+  id: text("id").primaryKey(),
+  orgId: text("org_id").notNull().references(() => orgs.id),
+  project: text("project").notNull(),
+  maxStoredBytes: integer2("max_stored_bytes").notNull(),
+  maxObjects: integer2("max_objects").notNull(),
+  maxWriteBytesPerDay: integer2("max_write_bytes_per_day").notNull(),
+  writePeriod: text("write_period").notNull(),
+  writeBytesToday: integer2("write_bytes_today").notNull().default(0),
+  storedBytes: integer2("stored_bytes").notNull().default(0),
+  objectCount: integer2("object_count").notNull().default(0),
+  reservedBytes: integer2("reserved_bytes").notNull().default(0),
+  reservedObjects: integer2("reserved_objects").notNull().default(0),
+  writeBytes: integer2("write_bytes").notNull().default(0),
+  readBytes: integer2("read_bytes").notNull().default(0),
+  hits: integer2("hits").notNull().default(0),
+  misses: integer2("misses").notNull().default(0),
+  rejections: integer2("rejections").notNull().default(0),
+  classAOps: integer2("class_a_ops").notNull().default(0),
+  classBOps: integer2("class_b_ops").notNull().default(0),
+  publicationsNew: integer2("publications_new").notNull().default(0),
+  publicationsDuplicate: integer2("publications_duplicate").notNull().default(0),
+  publicationsConverged: integer2("publications_converged").notNull().default(0),
+  publicationsRejected: integer2("publications_rejected").notNull().default(0),
+  fallbacks: integer2("fallbacks").notNull().default(0),
+  updatedAt: ts("updated_at").notNull()
+}, (t) => ({
+  projectUq: uniqueIndex("package_cache_project_usage_project_uniq").on(t.orgId, t.project),
+  nonnegative: check("package_cache_project_usage_nonnegative", sql`${t.storedBytes} >= 0 AND ${t.objectCount} >= 0 AND ${t.reservedBytes} >= 0 AND ${t.reservedObjects} >= 0`),
+  byteBudget: check("package_cache_project_usage_byte_budget", sql`${t.storedBytes} + ${t.reservedBytes} <= ${t.maxStoredBytes}`),
+  objectBudget: check("package_cache_project_usage_object_budget", sql`${t.objectCount} + ${t.reservedObjects} <= ${t.maxObjects}`),
+  dailyWriteBudget: check("package_cache_project_usage_daily_write_budget", sql`${t.writeBytesToday} + ${t.reservedBytes} <= ${t.maxWriteBytesPerDay}`)
+}));
 var computerSnapshots = sqliteTable("computer_snapshots", {
   id: text("id").primaryKey(),
   ownerScope: text("owner_scope").$type().notNull(),
@@ -7063,6 +7130,22 @@ var artifactTldrawBoards = sqliteTable("artifact_tldraw_boards", {
 }, (t) => ({
   createKeyUq: uniqueIndex("artifact_tldraw_boards_create_key_uq").on(t.createActorProfileId, t.createThreadId, t.createIdempotencyKey)
 }));
+var artifactTldrawLatestPreviews = sqliteTable("artifact_tldraw_latest_previews", {
+  artifactId: text("artifact_id").primaryKey().references(() => artifacts.id, { onDelete: "cascade" }),
+  attachmentId: text("attachment_id").notNull().references(() => attachments.id),
+  documentDigest: text("document_digest").notNull(),
+  documentClock: integer2("document_clock").notNull(),
+  roomGeneration: integer2("room_generation").notNull(),
+  width: integer2("width").notNull(),
+  height: integer2("height").notNull(),
+  generatedAt: ts("generated_at").notNull(),
+  revision: integer2("revision").notNull().default(1),
+  storageSlot: integer2("storage_slot").notNull(),
+  retiredAttachmentId: text("retired_attachment_id"),
+  retiredStorageSlot: integer2("retired_storage_slot")
+}, (t) => ({
+  attachmentIdx: uniqueIndex("artifact_tldraw_latest_previews_attachment_uniq").on(t.attachmentId)
+}));
 var artifactTldrawCheckpoints = sqliteTable("artifact_tldraw_checkpoints", {
   id: text("id").primaryKey(),
   artifactId: text("artifact_id").notNull().references(() => artifacts.id, { onDelete: "cascade" }),
@@ -7588,6 +7671,36 @@ var threadAssignments = sqliteTable("thread_assignments", {
   assigneeUq: uniqueIndex("thread_assignments_thread_profile_uniq").on(t.threadId, t.profileId),
   profileIdx: index("thread_assignments_profile_idx").on(t.profileId, t.createdAt)
 }));
+// ../core/src/db/tldraw-preview-candidate-schema.ts
+var ts2 = (name) => text(name);
+var artifactTldrawPreviewCandidates = sqliteTable("artifact_tldraw_preview_candidates", {
+  artifactId: text("artifact_id").primaryKey().references(() => artifacts.id, { onDelete: "cascade" }),
+  generationToken: text("generation_token").notNull(),
+  slot: integer2("slot").notNull(),
+  attachmentId: text("attachment_id").notNull(),
+  r2Key: text("r2_key").notNull(),
+  targetDocumentDigest: text("target_document_digest").notNull(),
+  leaseExpiresAt: ts2("lease_expires_at").notNull(),
+  createdAt: ts2("created_at").notNull()
+}, (t) => ({
+  generationIdx: uniqueIndex("artifact_tldraw_preview_candidates_generation_uniq").on(t.generationToken),
+  attachmentIdx: uniqueIndex("artifact_tldraw_preview_candidates_attachment_uniq").on(t.attachmentId),
+  r2KeyIdx: uniqueIndex("artifact_tldraw_preview_candidates_r2_key_uniq").on(t.r2Key)
+}));
+// ../core/src/lifecycle/thread.ts
+var STATUS_OPENNESS = {
+  backlog: { working: false, currentWork: false, closed: false },
+  active: { working: true, currentWork: true, closed: false },
+  "needs-review": { working: true, currentWork: true, closed: false },
+  stuck: { working: true, currentWork: true, closed: false },
+  standing: { working: true, currentWork: false, closed: false },
+  resolved: { working: false, currentWork: false, closed: true },
+  canceled: { working: false, currentWork: false, closed: true },
+  archived: { working: false, currentWork: false, closed: true }
+};
+var typesWhere = (sense) => Object.keys(STATUS_OPENNESS).filter((s) => STATUS_OPENNESS[s][sense]);
+var WORKING_THREAD_STATUSES = typesWhere("working");
+var CURRENT_WORK_THREAD_STATUSES = typesWhere("currentWork");
 // ../core/src/ops/secret.ts
 var SECRET_PERMISSIONS = [
   "create",
@@ -7609,6 +7722,15 @@ var ORG_ADMIN_CONTAINMENT_PERMISSIONS = new Set([
 
 // ../core/src/ops/computer-run.ts
 var COMPUTER_RUN_START_CHECKPOINT_RESERVATION_STALE_MS = 12 * 60 * 1000;
+var COMPUTER_RUN_F1_FINAL_FAILURE_CODES = new Set([
+  "run.provision.lifecycle_capacity_blocked",
+  "run.provision.capacity_blocked",
+  "run.provision.attempts_exhausted",
+  "run.provision.preflight_failed",
+  "run.provision.reconciliation_failed",
+  "run.provision.owner_unavailable",
+  "run.provision.provider_unavailable"
+]);
 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;
@@ -7661,6 +7783,9 @@ var assigneeColumns = {
   color: profiles.color,
   emoji: profiles.emoji
 };
+// ../core/src/ops/package-cache.ts
+var PACKAGE_CACHE_PENDING_TTL_MS = 15 * 60 * 1000;
+var PACKAGE_CACHE_FINAL_TTL_MS = 30 * 24 * 60 * 60 * 1000;
 // ../core/src/ops/computer-output.ts
 var COMPUTER_OUTPUT_DEFAULT_STALE_MS = 24 * 60 * 60 * 1000;
 // ../core/src/ops/computer-recovery.ts
@@ -7820,6 +7945,20 @@ var recallHit = looseObject({
   url: nullableString,
   createdAt: timestamp
 });
+var tldrawLatestPreview = object({
+  status: _enum(["current", "stale", "missing"]),
+  representedDocumentDigest: string2().optional(),
+  representedDocumentClock: number2().int().min(0).optional(),
+  generatedAt: timestamp.optional(),
+  image: object({
+    attachmentId: id,
+    downloadUrl: string2(),
+    mimeType: literal("image/png"),
+    width: number2().int().positive(),
+    height: number2().int().positive(),
+    size: number2().int().positive()
+  }).strict().optional()
+});
 var artifactLivePreviewThread = looseObject({
   id,
   title: string2()
@@ -8990,6 +9129,7 @@ var MCP_OUTPUT_SCHEMAS = {
         retryCount: number2().int().min(0)
       })
     }),
+    preview: tldrawLatestPreview,
     script: object({
       artifactId: id,
       revision: number2().int().min(0),
@@ -9040,15 +9180,7 @@ var MCP_OUTPUT_SCHEMAS = {
         serializedByteLimit: number2().int().positive()
       })
     }),
-    image: object({
-      attachmentId: id,
-      downloadUrl: string2(),
-      mimeType: literal("image/png"),
-      width: number2().int().positive(),
-      height: number2().int().positive(),
-      size: number2().int().positive(),
-      sha256: string2()
-    }).strict()
+    preview: tldrawLatestPreview
   }),
   tldraw_exec: looseObject({
     executionId: id,
@@ -9314,7 +9446,16 @@ var MCP_OUTPUT_SCHEMAS = {
     })
   }),
   computer_run_receipt: looseObject({
-    receipt: computerRunReceipt2
+    receipt: union([
+      computerRunReceipt2,
+      object({
+        runStartId: id,
+        runId: id,
+        runCreated: literal(false),
+        status: literal("provisioning"),
+        phase: literal("run.admission")
+      })
+    ])
   }),
   computer_runs: looseObject({
     computerId: id,
@@ -9549,6 +9690,28 @@ function selectedArray(value, fields) {
     return;
   return value.map((entry) => selected(entry, fields) ?? {});
 }
+function compactTldrawPreview(value) {
+  const preview = record2(value);
+  if (!preview)
+    return;
+  return defined([
+    ["status", preview.status],
+    ["representedDocumentDigest", preview.representedDocumentDigest],
+    ["representedDocumentClock", preview.representedDocumentClock],
+    ["generatedAt", preview.generatedAt],
+    [
+      "image",
+      selected(preview.image, [
+        "attachmentId",
+        "downloadUrl",
+        "mimeType",
+        "width",
+        "height",
+        "size"
+      ])
+    ]
+  ]);
+}
 function omitNull(value) {
   return value === null ? undefined : value;
 }
@@ -9777,18 +9940,7 @@ var OUTPUT_SHAPERS = {
     ["documentClock", result.documentClock],
     ["documentDigest", result.documentDigest],
     ["scene", result.scene],
-    [
-      "image",
-      selected(result.image, [
-        "attachmentId",
-        "downloadUrl",
-        "mimeType",
-        "width",
-        "height",
-        "size",
-        "sha256"
-      ])
-    ]
+    ["preview", compactTldrawPreview(result.preview)]
   ]),
   computer_write: (result) => defined([
     ["ok", result.ok],
@@ -10589,7 +10741,7 @@ var ACTION_DEFINITIONS = [
       sourceThreadId: string2().optional().describe("merge: duplicate source Thread id"),
       targetThreadId: string2().optional().describe("merge: canonical destination Thread id"),
       objective: string2().min(1).optional().describe("create/update: Thread objective"),
-      status: _enum(["active", "needs-review", "stuck", "standing", "resolved", "archived"]).optional().describe("transition/update: target Thread status"),
+      status: _enum(LIFECYCLE_TYPES).optional().describe("transition/update: target Thread lifecycle type"),
       reason: string2().optional().describe("merge: concise auditable rationale")
     },
     surfaces: ["mcp"],
@@ -10623,7 +10775,7 @@ var ACTION_DEFINITIONS = [
       topicId: string2().optional().describe("create/move/update: destination Feedback Topic id"),
       title: string2().min(1).optional().describe("create/update: Thread title"),
       objective: string2().min(1).optional().describe("create/update: Thread objective"),
-      status: _enum(["active", "needs-review", "stuck", "standing", "resolved", "archived"]).optional().describe("transition/update: target Thread status"),
+      status: _enum(LIFECYCLE_TYPES).optional().describe("transition/update: target Thread lifecycle type"),
       reason: string2().optional().describe("merge: concise auditable rationale")
     },
     surfaces: ["cli"],
@@ -10869,13 +11021,15 @@ var ACTION_DEFINITIONS = [
       status: _enum([
         "current",
         "all",
+        "backlog",
         "active",
         "needs-review",
         "stuck",
         "standing",
         "resolved",
+        "canceled",
         "archived"
-      ]).optional().describe("default current = active + needs-review + stuck; all includes standing/resolved/archived"),
+      ]).optional().describe("default current = active + needs-review + stuck; all includes backlog/standing/resolved/canceled/archived"),
       limit: number2().int().min(1).max(100).optional().describe("page size (default 20, max 100)"),
       cursor: string2().optional().describe("keyset cursor from a prior page's nextCursor")
     },
@@ -10985,7 +11139,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_start",
     title: "Start a run",
-    description: `Start one bounded unit of work by threadId: write defaults to an isolated Run from the Thread snapshot without booting the parent; shared/read Runs use the live parent; idempotencyKey recovers zero-or-one Run after response loss, and failures return runId for computer_run_receipt. First use: read the Computer guide at ${AGENT_GUIDE_URLS.computer}.`,
+    description: `Start an isolated write Run or shared/read Run with one idempotencyKey; a pending admission returns runStartId for receipt observation while the lifecycle owner continues independently, and caller work waits for admission. First use: read the Computer guide at ${AGENT_GUIDE_URLS.computer}.`,
     inputSchema: {
       threadId: string2().optional().describe("the Thread whose Computer this Run works in, thr_…; the canonical Run-first front door"),
       computerSessionId: string2().optional().describe("legacy compatibility alternative to threadId: an existing parent computerSessionId, cms_…"),
@@ -11041,9 +11195,10 @@ var ACTION_DEFINITIONS = [
   {
     name: "computer_run_receipt",
     title: "Read a run receipt",
-    description: "Read a Run's durable receipt, including finishRequest, derived finishContinuation, Run-owned operation/activity state, and compact providerLifecycle. A verified pending continuation names the stage the existing owner is retrying with callerAction none; reads never advance finish or rewrite terminal reasonCode, so use this instead of parent computer_status for compact history.",
+    description: "Read with exactly one of runId or runStartId: observe pending admission, finish continuation, Run-owned operation/activity state, and providerLifecycle instead of parent computer_status. Reads never drive admission or finish; the existing lifecycle owner continues independently.",
     inputSchema: {
-      runId: string2().describe("the run to read, run_… (from computer_run_start or computer_runs)")
+      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")
     },
     surfaces: ["computer-mcp", "computer-cli"],
     toolset: "loop",
@@ -11355,10 +11510,10 @@ var ACTION_DEFINITIONS = [
   {
     name: "transition_thread",
     title: "Move a thread's lifecycle",
-    description: "Move a Thread among active, needs-review, stuck, standing, resolved, or archived with an optional reason; illegal lifecycle jumps are rejected. Resolve finite Decide/Deliver/Investigate/Manage work once its outcome is in, archive retired work (refile misfiled work with `thread_update` instead), use standing only for intentionally open-ended concerns, and curate standout outputs separately.",
+    description: "Move a Thread among backlog, active, needs-review, stuck, standing, resolved, canceled, or archived with an optional reason; illegal lifecycle jumps are rejected. Park accepted-not-committed work in backlog, resolve finite Decide/Deliver/Investigate/Manage work once its outcome is in, cancel work the room decided not to do, archive retired work (refile misfiled work with `thread_update` instead), use standing only for intentionally open-ended concerns, and curate standout outputs separately.",
     inputSchema: {
       threadId: string2().describe("the thread to move, thr_…"),
-      to: _enum(["active", "needs-review", "stuck", "standing", "resolved", "archived"]).describe("target Thread lifecycle status"),
+      to: _enum(LIFECYCLE_TYPES).describe("target Thread lifecycle type"),
       reason: string2().optional().describe("optional one-line why, recorded on the event")
     },
     surfaces: ["mcp", "cli"],
@@ -12431,7 +12586,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_status",
     title: "Check tldraw board status",
-    description: "Read compact operational room health and separately reported script sessions for a tldraw board; board geometry/document content stays on tldraw_observe and tldraw_get. Session reports remain per-session observations and are never collapsed into global success.",
+    description: "Read compact operational room health, current latest-preview freshness, and separately reported script sessions for a tldraw board without rendering an image; board geometry/document content stays on tldraw_observe and tldraw_get. Session reports remain per-session observations and are never collapsed into global success.",
     inputSchema: { artifactId: string2().describe("the tldraw Artifact, art_…") },
     surfaces: ["mcp", "cli"],
     toolset: "artifacts",
@@ -12489,12 +12644,13 @@ var ACTION_DEFINITIONS = [
   {
     name: "tldraw_observe",
     title: "Observe a tldraw board",
-    description: `Capture a fresh bounded tldraw scene, lint result, document clock and digest, plus a PNG attachment for visual review; observe before editing and after context compaction to reacquire authoritative shape IDs/geometry. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
+    description: `Read a fresh bounded tldraw scene, lint result, document clock/digest, and latest-preview freshness; preview defaults to metadata-only with no screenshot/storage write, while preview=ensure reuses a same-digest preview or explicitly renders the canonical latest PNG when visual composition matters, and lint remains advisory rather than ownership/intent evidence. First use: read the tldraw guide at ${AGENT_GUIDE_URLS.tldraw}.`,
     inputSchema: {
       artifactId: string2().describe("the tldraw Artifact, art_…"),
       pageId: string2().min(1).max(200).optional().describe("optional page to observe"),
       viewportWidth: number2().int().min(320).max(1920).optional(),
-      viewportHeight: number2().int().min(240).max(1080).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")
     },
     surfaces: ["mcp", "cli"],
     toolset: "artifacts",

package/package.json

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