@lambdacurry/arbor 0.14.4 → 0.14.6

package/dist/arbor.js

@@ -38,6 +38,7 @@ var ERROR_REASONS = new Set([
   "authorization.denied",
   "resource.not_found",
   "conflict.state",
+  "conflict.computer_recipe",
   "limit.exceeded",
   "provider.timeout",
   "provider.failure",
@@ -1581,12 +1582,55 @@ var githubWebhookDeliveries = sqliteTable("github_webhook_deliveries", {
 var threadComputers = sqliteTable("thread_computers", {
   id: text("id").primaryKey(),
   threadId: text("thread_id").notNull().references(() => threads.id),
+  generation: integer("generation").notNull().default(1),
   provider: text("provider").$type().notNull(),
+  backend: text("backend").$type().notNull().default("worker-shell"),
+  containerProfile: text("container_profile"),
+  repositories: text("repositories", { mode: "json" }).$type().notNull().default([]),
+  setupScriptConfigured: integer("setup_script_configured", { mode: "boolean" }).notNull().default(false),
+  configKey: text("config_key").notNull().default("legacy"),
+  configRevision: text("config_revision").notNull().default("legacy"),
+  predecessorComputerId: text("predecessor_computer_id"),
+  successorComputerId: text("successor_computer_id"),
+  restoredFromSnapshotId: text("restored_from_snapshot_id"),
   currentSnapshotId: text("current_snapshot_id"),
   createdByProfileId: text("created_by_profile_id").notNull().references(() => profiles.id),
   createdExecutionContextId: text("created_execution_context_id").notNull().references(() => executionContexts.id),
   createdAt: ts("created_at").notNull()
-}, (t) => ({ threadIdx: uniqueIndex("thread_computers_thread_idx").on(t.threadId) }));
+}, (t) => ({
+  threadIdx: index("thread_computers_thread_idx").on(t.threadId, t.generation),
+  generationIdx: uniqueIndex("thread_computers_generation_idx").on(t.threadId, t.generation)
+}));
+var threadComputerHeads = sqliteTable("thread_computer_heads", {
+  threadId: text("thread_id").primaryKey().references(() => threads.id),
+  activeComputerId: text("active_computer_id").notNull().unique().references(() => threadComputers.id),
+  updatedByProfileId: text("updated_by_profile_id").notNull().references(() => profiles.id),
+  updatedExecutionContextId: text("updated_execution_context_id").notNull().references(() => executionContexts.id),
+  updatedAt: ts("updated_at").notNull()
+});
+var computerReprovisions = sqliteTable("computer_reprovisions", {
+  id: text("id").primaryKey(),
+  threadId: text("thread_id").notNull().references(() => threads.id),
+  actorProfileId: text("actor_profile_id").notNull().references(() => profiles.id),
+  executionContextId: text("execution_context_id").notNull().references(() => executionContexts.id),
+  idempotencyKey: text("idempotency_key").notNull(),
+  targetConfigKey: text("target_config_key").notNull(),
+  reason: text("reason").notNull(),
+  status: text("status").$type().notNull().default("pending"),
+  oldComputerId: text("old_computer_id").notNull().references(() => threadComputers.id),
+  newComputerId: text("new_computer_id").references(() => threadComputers.id),
+  sourceSessionId: text("source_session_id"),
+  targetSessionId: text("target_session_id"),
+  checkpointOutcome: text("checkpoint_outcome").$type().notNull().default("not_needed"),
+  restorationOutcome: text("restoration_outcome").$type().notNull().default("not_needed"),
+  restoredSnapshotId: text("restored_snapshot_id"),
+  failureCode: text("failure_code"),
+  createdAt: ts("created_at").notNull(),
+  completedAt: ts("completed_at")
+}, (t) => ({
+  idempotencyIdx: uniqueIndex("computer_reprovisions_idempotency_idx").on(t.threadId, t.actorProfileId, t.idempotencyKey),
+  threadIdx: index("computer_reprovisions_thread_idx").on(t.threadId, t.createdAt)
+}));
 var computerSessions = sqliteTable("computer_sessions", {
   id: text("id").primaryKey(),
   computerId: text("computer_id").notNull().references(() => threadComputers.id),
@@ -1864,6 +1908,7 @@ var appBundles = sqliteTable("app_bundles", {
   }).$type(),
   runtimeEntrypoint: text("runtime_entrypoint").$type().notNull(),
   capabilityRequirements: text("capability_requirements", { mode: "json" }).$type().notNull().default([]),
+  runtimeConfigRequirements: text("runtime_config_requirements", { mode: "json" }).$type().notNull().default([]),
   stateSchemaVersion: integer("state_schema_version").notNull().default(0),
   stateCompatibleFrom: integer("state_compatible_from").notNull().default(0),
   stateCompatibleThrough: integer("state_compatible_through").notNull().default(0),
@@ -1930,6 +1975,22 @@ var secretBindings = sqliteTable("secret_bindings", {
   appNameUq: uniqueIndex("secret_bindings_app_name_uq").on(t.appId, t.bindingName),
   secretIdx: index("secret_bindings_secret_idx").on(t.secretId, t.status)
 }));
+var appRuntimeVars = sqliteTable("app_runtime_vars", {
+  id: text("id").primaryKey(),
+  appId: text("app_id").notNull().references(() => apps.id),
+  name: text("name").notNull(),
+  value: text("value").notNull(),
+  revision: integer("revision").notNull().default(1),
+  createdByProfileId: text("created_by_profile_id").notNull().references(() => profiles.id),
+  createdExecutionContextId: text("created_execution_context_id").notNull().references(() => executionContexts.id),
+  createdAt: ts("created_at").notNull(),
+  updatedByProfileId: text("updated_by_profile_id").notNull().references(() => profiles.id),
+  updatedExecutionContextId: text("updated_execution_context_id").notNull().references(() => executionContexts.id),
+  updatedAt: ts("updated_at").notNull()
+}, (t) => ({
+  appNameUq: uniqueIndex("app_runtime_vars_app_name_uq").on(t.appId, t.name),
+  appIdx: index("app_runtime_vars_app_idx").on(t.appId)
+}));
 var appDeployments = sqliteTable("app_deployments", {
   id: text("id").primaryKey(),
   appId: text("app_id").notNull().references(() => apps.id),
@@ -16576,6 +16637,15 @@ var computerConfig = exports_external.looseObject({
   setupScript: nullableString,
   repositories: exports_external.array(exports_external.string())
 });
+var redactedComputerRecipe = exports_external.looseObject({
+  provider: exports_external.string(),
+  backend: exports_external.enum(["worker-shell", "container"]),
+  containerProfile: nullableString,
+  repositories: exports_external.array(exports_external.string()),
+  setupScriptConfigured: exports_external.boolean(),
+  configRevision: exports_external.string(),
+  layers: exports_external.array(exports_external.looseObject({ scope: exports_external.string() }))
+});
 var computerConfigLayer = exports_external.looseObject({
   id,
   scope: exports_external.string(),
@@ -16903,11 +16973,20 @@ var MCP_OUTPUT_SCHEMAS = {
   }),
   get_computer: exports_external.looseObject({
     threadId: id,
-    config: computerConfig,
-    topicBase: snapshot.nullable(),
+    config: redactedComputerRecipe,
+    compatibility: exports_external.looseObject({
+      state: exports_external.enum(["ready", "stale_config", "backend_mismatch", "replacement_required"]),
+      reason: exports_external.string(),
+      effectiveRecipe: redactedComputerRecipe,
+      materializedRecipe: redactedComputerRecipe.nullable()
+    }),
+    topicBase: jsonObject.nullable(),
     computer: jsonObject.nullable(),
+    activeGenerationId: id.nullable(),
+    generations: exports_external.array(jsonObject),
     sessions: exports_external.array(jsonObject),
-    lineage: exports_external.array(snapshot)
+    lineage: exports_external.array(jsonObject),
+    reprovisions: exports_external.array(jsonObject)
   }),
   publish_topic_computer: exports_external.looseObject({
     published: exports_external.boolean(),
@@ -17141,6 +17220,7 @@ var MCP_OUTPUT_SCHEMAS = {
   app_fetch: appInvocationResponse,
   app_request: appInvocationResponse,
   app_create: app2,
+  app_config_apply: exports_external.object({ appId: id, dryRun: exports_external.boolean(), changes: exports_external.array(jsonObject) }),
   app_deploy: exports_external.looseObject({
     deployment,
     activated: exports_external.boolean(),
@@ -17181,6 +17261,19 @@ var MCP_OUTPUT_SCHEMAS = {
     materialized: checkpoint.nullable(),
     runtime: jsonObject
   }),
+  computer_reprovision: exports_external.looseObject({
+    reprovisionId: id,
+    threadId: id,
+    status: exports_external.string(),
+    oldComputerId: id,
+    newComputerId: id.nullable(),
+    computerSessionId: id.nullable(),
+    checkpointOutcome: exports_external.string(),
+    restorationOutcome: exports_external.string(),
+    restoredSnapshotId: id.nullable(),
+    failureCode: exports_external.string().nullable(),
+    reason: exports_external.string()
+  }),
   computer_exec: exports_external.looseObject({
     stdout: exports_external.string().optional(),
     stderr: exports_external.string().optional(),
@@ -17412,6 +17505,7 @@ var MCP_TOOL_ANNOTATIONS = {
   app_fetch: readOnly,
   app_request: destructive,
   app_create: additive,
+  app_config_apply: idempotent,
   app_deploy: idempotent,
   app_activate: additive,
   app_rollback: additive,
@@ -17421,6 +17515,7 @@ var MCP_TOOL_ANNOTATIONS = {
   app_archive: additive,
   charter: destructive,
   computer_open: additive,
+  computer_reprovision: destructiveIdempotent,
   computer_exec: destructiveOpenWorld,
   computer_status: readOnly,
   computer_verify: openWorld,
@@ -17779,6 +17874,19 @@ var ACTION_DEFINITIONS = [
     toolset: "loop",
     run: forward("computer_runtime.open")
   },
+  {
+    name: "computer_reprovision",
+    title: "Replace a Thread computer",
+    description: "Explicitly replace an incompatible active Computer generation from the Thread's effective recipe. The old generation remains authoritative unless the successor restores supported state and passes health. Same-provider worker-shell→container migration is supported; container→worker-shell and cross-provider migration fail explicitly. Reuse one idempotencyKey only for the same replacement request.",
+    inputSchema: {
+      threadId: exports_external.string().describe("the Thread whose active Computer generation is replaced, thr_…"),
+      idempotencyKey: exports_external.string().min(1).max(200).describe("stable key for this ONE replacement request; reuse it unchanged for retries"),
+      reason: exports_external.string().min(1).max(500).describe("concise auditable reason for replacing the active generation")
+    },
+    surfaces: ["computer-mcp", "computer-cli"],
+    toolset: "loop",
+    run: forward("computer_runtime.reprovision")
+  },
   {
     name: "computer_exec",
     title: "Run a command",
@@ -17968,6 +18076,7 @@ var ACTION_DEFINITIONS = [
       stateSchemaVersion: exports_external.number().int().min(0).optional().describe("durable schema this release writes; default 0"),
       stateCompatibleFrom: exports_external.number().int().min(0).optional().describe("oldest durable schema this code can open"),
       stateCompatibleThrough: exports_external.number().int().min(0).optional().describe("newest durable schema this code can open"),
+      runtimeConfigRequirements: exports_external.array(exports_external.object({ name: exports_external.string().min(1).max(64), kind: exports_external.enum(["var", "secret"]) })).optional().describe("required runtime config keys and kinds; values are never part of the AppBundle"),
       idempotencyKey: exports_external.string().min(1).max(200).describe("stable key for this one logical bundle publication")
     },
     surfaces: ["computer-mcp", "computer-cli"],
@@ -17988,7 +18097,7 @@ var ACTION_DEFINITIONS = [
   {
     name: "get_computer",
     title: "Read a Thread computer",
-    description: "Read a Thread's effective recipe, stable computer identity, current Topic/Thread snapshot refs, recent attachment receipts, and bounded lineage. This is durable Arbor protocol state, not live process/presence status; use Currybox for ephemeral runtime observations.",
+    description: "Read a Thread's redacted effective recipe, active materialized generation, compatibility state, historical generation lineage, current Topic/Thread snapshot refs, recent attachment receipts, and replacement outcomes. Recipe metadata includes provider/backend/profile/repositories/config revision and whether setup is configured, never setup content or credentials. This is durable Arbor protocol state, not live process/presence status.",
     inputSchema: {
       threadId: exports_external.string().describe("the Thread, thr_…"),
       lineageLimit: exports_external.number().int().min(1).max(100).optional().describe("recent receipts/lineage rows (default 20)")
@@ -19198,6 +19307,22 @@ var ACTION_DEFINITIONS = [
     toolset: "apps",
     run: forward("app.create")
   },
+  {
+    name: "app_config_apply",
+    title: "Apply App runtime config",
+    description: "Declaratively apply the complete typed runtime config for one App. var stores an ordinary runtime value; secret references an existing Arbor Secret without accepting or returning secret material. Dry-run performs the same validation and returns create/update/delete/no-op actions without mutating.",
+    inputSchema: {
+      appId: exports_external.string().describe("target App, app_…"),
+      config: exports_external.record(exports_external.string(), exports_external.discriminatedUnion("kind", [
+        exports_external.object({ kind: exports_external.literal("var"), value: exports_external.string().max(16384) }),
+        exports_external.object({ kind: exports_external.literal("secret"), secretId: exports_external.string() })
+      ])).describe("complete desired runtime config object keyed by environment variable name"),
+      dryRun: exports_external.boolean().optional().describe("validate and plan without mutating")
+    },
+    surfaces: ["mcp", "cli"],
+    toolset: "apps",
+    run: forward("app.config_apply")
+  },
   {
     name: "app_deploy",
     title: "Prepare an App deployment",
@@ -19506,6 +19631,11 @@ function parseErrorDetails(value) {
       };
     }
   }
+  if (typeof raw.compatibilityState === "string") {
+    details.compatibilityState = raw.compatibilityState;
+  }
+  if (typeof raw.suggestedAction === "string")
+    details.suggestedAction = raw.suggestedAction;
   return details;
 }
 function detailsForError(err) {
@@ -19748,6 +19878,9 @@ function kindOf(node) {
       return "array";
     case "boolean":
       return "boolean";
+    case "object":
+    case "record":
+      return "json";
     default:
       return "string";
   }
@@ -19756,7 +19889,7 @@ function acceptedFlags(inputSchema) {
   const out = new Set;
   for (const spec of flagsForSchema(inputSchema)) {
     out.add(spec.flag);
-    if (spec.kind === "string")
+    if (spec.kind === "string" || spec.kind === "json")
       out.add(`${spec.flag}-file`);
   }
   return out;
@@ -19792,7 +19925,7 @@ function buildInput(inputSchema, flags, command) {
   const primary = primaryPositionalField(inputSchema);
   const input = {};
   for (const spec of flagsForSchema(inputSchema)) {
-    if (spec.kind === "string") {
+    if (spec.kind === "string" || spec.kind === "json") {
       const fileSrc = lastValue(flags[`${spec.flag}-file`]);
       if (fileSrc !== undefined) {
         if (flags[spec.flag] !== undefined) {
@@ -19800,7 +19933,16 @@ function buildInput(inputSchema, flags, command) {
         }
         if (fileSrc === true)
           throw new UsageError(`--${spec.flag}-file expects a path (or - for stdin)`);
-        input[spec.field] = readTextSource(String(fileSrc));
+        const sourced = readTextSource(String(fileSrc));
+        if (spec.kind === "json") {
+          try {
+            input[spec.field] = JSON.parse(sourced);
+          } catch {
+            throw new UsageError(`--${spec.flag}-file must contain valid JSON`);
+          }
+        } else {
+          input[spec.field] = sourced;
+        }
         continue;
       }
     }
@@ -19864,6 +20006,14 @@ function buildInput(inputSchema, flags, command) {
         input[spec.field] = out;
         break;
       }
+      case "json": {
+        try {
+          input[spec.field] = JSON.parse(String(lastValue(raw)));
+        } catch {
+          throw new UsageError(`--${spec.flag} must be valid JSON`);
+        }
+        break;
+      }
       case "boolean": {
         const v = lastValue(raw);
         input[spec.field] = v === true ? true : v !== "false";

package/package.json

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