@lambdacurry/arbor 0.24.16 → 0.24.18

package/dist/arbor.js

@@ -7657,13 +7657,16 @@ var threads = sqliteTable("threads", {
   openQuestions: text("open_questions", { mode: "json" }).$type().notNull().default([]),
   expectedOutput: text("expected_output").notNull().default(""),
   number: integer2("number"),
-  createdAt: ts("created_at").notNull()
+  createdAt: ts("created_at").notNull(),
+  lastActivityAt: ts("last_activity_at")
 }, (t) => ({
   spaceNumberUq: uniqueIndex("threads_space_number_uq").on(t.spaceId, t.number),
   topicIdx: index("threads_topic_idx").on(t.topicId),
   spaceIdx: index("threads_space_idx").on(t.spaceId),
   lifecycleTypeIdx: index("threads_lifecycle_type_idx").on(t.lifecycleType),
-  topicLifecycleRankIdx: index("threads_topic_lifecycle_rank_idx").on(t.topicId, t.lifecycleType, t.rank)
+  topicLifecycleRankIdx: index("threads_topic_lifecycle_rank_idx").on(t.topicId, t.lifecycleType, t.rank),
+  topicLabelRankIdx: index("threads_topic_label_rank_idx").on(t.topicId, t.lifecycleLabel, t.rank, t.lastActivityAt),
+  topicActivityIdx: index("threads_topic_activity_idx").on(t.topicId, t.lastActivityAt, t.id)
 }));
 var computerConfigs = sqliteTable("computer_configs", {
   id: text("id").primaryKey(),
@@ -8040,6 +8043,29 @@ 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 computerCheckpointOperations = sqliteTable("computer_checkpoint_operations", {
+  operationId: text("operation_id").primaryKey(),
+  computerId: text("computer_id").notNull().references(() => threadComputers.id),
+  payload: text("payload").notNull(),
+  payloadDigest: text("payload_digest").notNull(),
+  workspaceGeneration: text("workspace_generation").notNull(),
+  captureMutationVersion: integer2("capture_mutation_version").notNull(),
+  expectedHeadSnapshotId: text("expected_head_snapshot_id"),
+  state: text("state").$type().notNull(),
+  failureCode: text("failure_code"),
+  nativeSnapshotId: text("native_snapshot_id"),
+  capturedAt: ts("captured_at"),
+  expiresAt: ts("expires_at"),
+  portableProviderRef: text("portable_provider_ref"),
+  publishedSnapshotId: text("published_snapshot_id"),
+  restoreSessionId: text("restore_session_id"),
+  restoreState: text("restore_state").$type(),
+  restoredAt: ts("restored_at"),
+  createdAt: ts("created_at").notNull(),
+  updatedAt: ts("updated_at").notNull()
+}, (t) => ({
+  computerIdx: index("computer_checkpoint_operations_computer_idx").on(t.computerId, t.createdAt)
+}));
 var computerSnapshotEvidence = sqliteTable("computer_snapshot_evidence", {
   snapshotId: text("snapshot_id").primaryKey().references(() => computerSnapshots.id),
   purpose: text("purpose").$type().notNull(),
@@ -9199,11 +9225,7 @@ var assigneeColumns = {
   color: profiles.color,
   emoji: profiles.emoji
 };
-var lastActivityExpr = sql`coalesce(
-  (select max(${contributions.createdAt}) from ${contributions}
-    where ${contributions.threadId} = ${threads.id}),
-  ${threads.createdAt}
-)`;
+var lastActivity = sql`${threads.lastActivityAt}`;
 
 // ../core/src/ops/space.ts
 var GUIDANCE_LIMITS = {
@@ -9320,6 +9342,8 @@ var BASE_MS = Date.parse("2026-07-20T15:00:00.000Z");
 var PAIRING_TTL_MS = 15 * 60 * 1000;
 // ../core/src/ops/space-visit.ts
 var VISIT_THROTTLE_MS = 5 * 60 * 1000;
+// ../core/src/ops/computer-checkpoint-operations.ts
+var CHECKPOINT_OPERATION_TTL_SECONDS = 7 * 24 * 60 * 60;
 // ../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;
@@ -9472,6 +9496,24 @@ var adminCloseOutputSchema = strictObject({
   reasonCode: literal("run.admin_closed_abandoned"),
   actorProfileId: string2()
 });
+var adminForceStopOutputSchema = strictObject({
+  mode: literal("admin_force"),
+  outcome: _enum(["stopped", "absent"]),
+  computerId: string2(),
+  computerSessionId: string2(),
+  reason: string2(),
+  generation: strictObject({
+    providerGeneration: number2().int().nonnegative(),
+    workspaceGeneration: string2().nullable()
+  }),
+  settledRunIds: array(string2()),
+  skippedRuns: array(strictObject({ runId: string2(), reason: string2() })),
+  stoppedAt: string2().optional(),
+  terminatedProcessIds: array(string2()).optional(),
+  recoveryRebased: boolean2().optional(),
+  replayed: boolean2().optional(),
+  note: string2().optional()
+});
 function buildOutputSchemas() {
   const id = string2();
   const timestamp = string2();
@@ -10603,9 +10645,26 @@ function buildOutputSchemas() {
       workflow: workflowSummary.optional(),
       threads: array(thread).optional(),
       promotedArtifacts: array(artifact).optional(),
-      total: number2().int().min(0),
+      total: number2().int().min(0).optional(),
       nextCursor: string2().optional(),
-      computerConfig: resolvedComputerConfig.nullable().optional()
+      computerConfig: resolvedComputerConfig.nullable().optional(),
+      counts: looseObject({
+        total: number2().int().min(0),
+        byStatus: record(string2(), number2().int().min(0)),
+        byLabel: record(string2(), number2().int().min(0))
+      }).optional(),
+      canEditGuidance: boolean2().optional()
+    }).superRefine((value, ctx) => {
+      if (value.threads !== undefined && value.total === undefined) {
+        ctx.addIssue({
+          code: "custom",
+          path: ["total"],
+          message: "a Thread roster requires total"
+        });
+      }
+      if (value.threads === undefined && value.counts === undefined) {
+        ctx.addIssue({ code: "custom", path: ["counts"], message: "a header requires counts" });
+      }
     }),
     goal: looseObject({
       id: id.optional(),
@@ -13061,7 +13120,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "thread_list",
     title: "List assigned threads or a Space's threads",
-    description: "List Threads you are responsible for (default), another profile's or jointly several, unassigned in one Space/Topic, or every Thread in a Space (`assignee=any` + spaceId) — default current work; status widens; order=activity is last-activity DESC (the aggregate board). `inbox` remains what you owe.",
+    description: "List Threads you are responsible for (default), another profile's or jointly several, unassigned in one Space/Topic, or every Thread in a Space or Topic (`assignee=any` + spaceId or one topicId) — default current work; status widens; order=activity is last-activity DESC (the aggregate board). `inbox` remains what you owe.",
     inputSchema: {
       assignee: union([string2(), array(string2()).min(1).max(5)]).optional().describe("`me` (default), a profile id (prof_…), a list (assigned to ALL of them), or `any` (every Thread in the required spaceId)"),
       unassigned: boolean2().optional().describe("threads with no assignee — requires spaceId or topicId"),
@@ -13094,8 +13153,9 @@ var ACTION_DEFINITIONS = [
           "archived"
         ])).min(1).max(8)
       ]).optional().describe("default current = active + needs-review + stuck; all includes backlog/standing/resolved/canceled/archived; or a list of statuses to keep (current/all only alone)"),
-      order: _enum(["assigned", "activity"]).optional().describe("default assigned = newest assignment first; activity = last_activity_at DESC (aggregate board order)"),
-      limit: number2().int().min(1).max(100).optional().describe("page size (default 20, max 100)"),
+      order: _enum(["assigned", "activity", "column"]).optional().describe("default assigned = newest assignment first; activity = last_activity_at DESC (default page 50); column = one Topic Board column, ranked then by recency (needs assignee=any, one topicId, lifecycleLabel)"),
+      lifecycleLabel: string2().min(1).optional().describe("order=column only: the Board column's lifecycle label key"),
+      limit: number2().int().min(1).max(100).optional().describe("page size (default 20; 50 for order=activity; max 100)"),
       cursor: string2().optional().describe("keyset cursor from a prior page's nextCursor")
     },
     surfaces: ["mcp", "cli"],
@@ -13696,10 +13756,31 @@ var ACTION_DEFINITIONS = [
     description: "Deprecated by AD-306: finishing the last active shared Run with computer_run_finish performs the final checkpoint and stops the parent. Still checkpoints and stops the parent for a shared write Run (runId) or a legacy computerSessionId, refusing teardown when durability fails or a background process is running.",
     inputSchema: {
       runId: string2().optional().describe("an active shared write Run whose parent to checkpoint and stop, run_…"),
-      computerSessionId: string2().optional().describe("legacy alternative to runId: a computerSessionId on that Computer, cms_…")
+      computerSessionId: string2().optional().describe("legacy alternative to runId: a computerSessionId on that Computer, cms_…"),
+      mode: literal("save").optional().describe("save stop (checkpoint, then stop); omission preserves existing behavior")
     },
     surfaces: ["computer-cli"],
     toolset: "loop",
+    variantDiscriminator: "mode",
+    privilegedVariants: [
+      {
+        tag: "admin_force",
+        requires: "active-org-admin",
+        inputSchema: {
+          mode: literal("admin_force").describe("active same-org owner/admin only (AD-358): kill the parent's processes and release it WITHOUT saving; its last checkpoint stays the restore point"),
+          computerSessionId: string2().describe("admin_force: the exact computerSessionId of the Computer to stop, cms_…"),
+          acceptDataLoss: boolean2().refine((value) => value === true, {
+            message: "admin_force requires acceptDataLoss: true"
+          }).describe("admin_force: must be true; running processes and unsaved work are lost"),
+          reason: string2().trim().min(1).max(500).describe("admin_force: why the Computer is being force-stopped (recorded)"),
+          expectedProviderGeneration: number2().int().nonnegative().describe("admin_force: the exact provider generation to stop"),
+          expectedWorkspaceGeneration: string2().min(1).nullable().describe("admin_force: the exact workspace generation; null (CLI: the value null) for a Computer with none")
+        },
+        omitInputs: ["runId"],
+        description: "Checkpoint and stop the parent for a shared write Run (deprecated by AD-306 in favor of computer_run_finish). Organization owner/admin only: mode=admin_force kills the parent's processes and releases it without saving, by exact computerSessionId and both expected generations, with acceptDataLoss and a reason; its shared Runs settle only on control's confirmed stop of that generation.",
+        outputSchema: adminForceStopOutputSchema
+      }
+    ],
     run: forward("computer_runtime.stop")
   },
   {
@@ -14517,11 +14598,13 @@ var ACTION_DEFINITIONS = [
   {
     name: "topic_get",
     title: "Read a topic",
-    description: "Read a Topic's durable context, guidance, the room's standing ways to help (`contributionLanes`), selected workflow summary, open requests, promoted artifacts, and a paged Thread roster (default 50; `total` is the full roster size). Continue with `cursor`, or use `all=true` / `--all` only for intentional complete enumeration; for a concrete question in a large Topic, prefer Topic-scoped `recall`.",
+    description: "Read a Topic's durable context, guidance, the room's standing ways to help (`contributionLanes`), selected workflow summary, open requests, promoted artifacts, and a paged Thread roster (default 50; `total` is the full roster size). Continue with `cursor`, or use `all=true` / `--all` only for intentional complete enumeration; for a concrete question in a large Topic, prefer Topic-scoped `recall`. `threads=none` is the header alone.",
     inputSchema: {
       topicId: string2().min(1).describe("the topic id"),
+      threads: _enum(["page", "none"]).optional().describe("page (default) includes the Thread roster page; none = header only — counts by status/label, participants, open-request count (no limit/cursor/all); page its Threads with thread_list assignee=any + topicId"),
       ...PAGINATION_INPUT
     },
+    externalReadDefaults: { unpagedWhen: { field: "threads", value: "none" } },
     surfaces: ["mcp", "cli"],
     toolset: "loop",
     run: forward("topic.get")
@@ -15526,7 +15609,7 @@ var ACTIONS = ACTION_DEFINITIONS.map((action) => {
 });
 
 // ../actions/src/retention-entry.ts
-var ARBOR_VERSION = "0.24.16";
+var ARBOR_VERSION = "0.24.18";
 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");
@@ -16410,7 +16493,7 @@ function dispositionFilename(value) {
 // package.json
 var package_default = {
   name: "@lambdacurry/arbor",
-  version: "0.24.16",
+  version: "0.24.18",
   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.16",
+  "version": "0.24.18",
   "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",