@brainbase-labs/cli 0.59.0 → 0.60.0

package/dist/index.js

@@ -36091,7 +36091,7 @@ function padStart(s, n) {
 // package.json
 var package_default = {
   name: "@brainbase-labs/cli",
-  version: "0.59.0",
+  version: "0.60.0",
   description: "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   type: "module",
   bin: {
@@ -64820,6 +64820,61 @@ var import_picocolors24 = __toESM(require_picocolors(), 1);
 import path82 from "node:path";
 import fs70 from "node:fs";
 
+// src/core/self-delegation-concurrency.ts
+var SelfDelegationConcurrencySchema = exports_external.number().int().min(1).nullable().optional();
+var field = "self_delegation_concurrency_limit";
+var hasLimit = (state) => !!state && Object.prototype.hasOwnProperty.call(state, field) && state[field] !== undefined;
+function concurrencyManifest(cloud, previous) {
+  const source = cloud.self_delegation_concurrency_supported === true ? cloud : previous;
+  return concurrencyLimit(source);
+}
+function concurrencyLimit(state) {
+  return hasLimit(state) ? { [field]: state[field] } : {};
+}
+function concurrencyBaseline(cloud, previous) {
+  if (cloud.self_delegation_concurrency_supported === true) {
+    return { self_delegation_concurrency_supported: true, ...concurrencyManifest(cloud) };
+  }
+  return {
+    ...previous?.self_delegation_concurrency_supported === true ? { self_delegation_concurrency_supported: true } : {},
+    ...concurrencyManifest({}, previous)
+  };
+}
+function diffConcurrency(local, previous, cloud) {
+  const known = previous?.self_delegation_concurrency_supported === true;
+  const authored = hasLimit(local);
+  const baseline = hasLimit(previous);
+  const supported = cloud.self_delegation_concurrency_supported === true;
+  const localChanged = supported && (known ? local[field] !== previous[field] : authored && local[field] !== cloud[field]);
+  const cloudChanged = supported && (known ? cloud[field] !== previous[field] : hasLimit(cloud) && local[field] !== cloud[field]);
+  const same = local[field] === cloud[field];
+  return {
+    localChanged: localChanged && !same,
+    cloudChanged: cloudChanged && !same,
+    conflict: localChanged && cloudChanged && !same,
+    converged: supported && same && (localChanged || known && cloud[field] !== previous[field]),
+    unsupported: !supported && (authored || known && baseline)
+  };
+}
+function concurrencyWrite(local, cloud, diff2) {
+  if (cloud.self_delegation_concurrency_supported !== true || !diff2.localChanged)
+    return {};
+  return {
+    ...concurrencyLimit(local),
+    reconcile_self_delegation_concurrency: true
+  };
+}
+function concurrencyBaselineAfterPush(local, previous, diff2) {
+  return diff2.localChanged || diff2.converged ? concurrencyBaseline({ ...local, self_delegation_concurrency_supported: true }) : concurrencyBaseline({}, previous);
+}
+function verifyConcurrencyWrite(input, result2) {
+  if (!hasLimit(input) && !input.reconcile_self_delegation_concurrency)
+    return;
+  if (result2.self_delegation_concurrency_supported !== true || input[field] !== result2[field]) {
+    throw new Error("This control plane did not apply self_delegation_concurrency_limit. Upgrade it or enable self-delegation before retrying; the sync baseline is unchanged.");
+  }
+}
+
 // src/core/agent-manifest.ts
 import path81 from "node:path";
 import fs69 from "node:fs";
@@ -64963,6 +65018,7 @@ var AgentManifestSchema = exports_external.object({
   machine_kind: exports_external.string().trim().min(1).optional(),
   default_model: exports_external.string().trim().regex(MODEL_ID_RE, "default_model must use letters, digits, and . _ - : / only (max 128)").nullable().optional(),
   runtime_mode: exports_external.enum(["fixed", "auto"]).optional(),
+  self_delegation_concurrency_limit: SelfDelegationConcurrencySchema,
   agent: AgentMetaSchema,
   instructions: InstructionsSchema.optional(),
   entrypoint: EntrypointSchema.optional(),
@@ -64994,6 +65050,7 @@ var MANIFEST_KEY_SYNC = {
   machine_kind: "synced",
   default_model: "synced",
   runtime_mode: "synced",
+  self_delegation_concurrency_limit: "synced",
   agent: "synced",
   instructions: "synced",
   entrypoint: "synced",
@@ -65278,6 +65335,8 @@ var AgentMetaSnapshotSchema = exports_external.object({
   machine_kind: exports_external.string().min(1).optional(),
   default_model: exports_external.string().nullable().optional(),
   runtime_mode: exports_external.enum(["fixed", "auto"]).optional(),
+  self_delegation_concurrency_limit: SelfDelegationConcurrencySchema,
+  self_delegation_concurrency_supported: exports_external.boolean().optional(),
   memory: exports_external.boolean().nullable().optional(),
   browser: exports_external.boolean().nullable().optional()
 });
@@ -66251,6 +66310,7 @@ var WRITABLE_CAPABILITIES = ["memory", "browser"];
 var MIRRORED_CAPABILITIES = ["slack", "meeting", "github", "linear"];
 function manifestConfigState(manifest) {
   return {
+    ...hasOwn(manifest, "self_delegation_concurrency_limit") ? { self_delegation_concurrency_limit: manifest.self_delegation_concurrency_limit } : {},
     ...manifest.machine_kind !== undefined ? { machine_kind: manifest.machine_kind } : {},
     ...hasOwn(manifest, "default_model") ? { default_model: manifest.default_model ?? null } : {},
     ...manifest.runtime_mode !== undefined ? { runtime_mode: manifest.runtime_mode } : {},
@@ -66260,6 +66320,8 @@ function manifestConfigState(manifest) {
 }
 function cloudConfigState(agent) {
   return {
+    ...agent.self_delegation_concurrency_supported === true ? { self_delegation_concurrency_supported: true } : {},
+    ...hasOwn(agent, "self_delegation_concurrency_limit") ? { self_delegation_concurrency_limit: agent.self_delegation_concurrency_limit } : {},
     ...agent.machine_kind !== undefined ? { machine_kind: agent.machine_kind } : {},
     ...hasOwn(agent, "default_model") ? { default_model: agent.default_model ?? null } : {},
     ...agent.runtime_mode !== undefined ? { runtime_mode: agent.runtime_mode } : {},
@@ -66290,6 +66352,9 @@ function staleConnectionMirrors(manifest, cloud) {
 }
 function diffAgentConfig(manifest, lock, cloud) {
   const unsupported = [];
+  const { unsupported: concurrencyUnsupported, ...concurrency } = diffConcurrency(manifest, lock, cloud);
+  if (concurrencyUnsupported)
+    unsupported.push("self_delegation_concurrency_limit");
   const machineSupported = cloud.machine_kind !== undefined;
   const defaultModelSupported = hasOwn(cloud, "default_model");
   if (manifest.machine_kind !== undefined && !machineSupported) {
@@ -66332,9 +66397,10 @@ function diffAgentConfig(manifest, lock, cloud) {
     defaultModelCloudChanged: defaultModel.cloudChanged,
     defaultModelConflict: defaultModel.conflict,
     runtimeMode,
+    concurrency,
     memory,
     browser,
-    baselineConverged: machineConverged || defaultModel.converged || runtimeMode.converged || memory.converged || browser.converged
+    baselineConverged: machineConverged || defaultModel.converged || runtimeMode.converged || concurrency.converged || memory.converged || browser.converged
   };
 }
 function threeWayField(supported, authored, cloudRaw, lock, key2) {
@@ -67851,12 +67917,13 @@ async function runAgentPull(cwd2, args) {
     cloud: cloud.components
   });
   const config = diffAgentConfig(existingManifest ?? {}, lock?.agentMeta, cloudAgent);
-  const localRuntimeConfigChanged = config.machineLocalChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged;
+  const localRuntimeConfigChanged = config.machineLocalChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged || config.concurrency.localChanged;
   if (localRuntimeConfigChanged && !args.force) {
     f2.error(`Runtime config has local edits that pull would overwrite: ${[
       ...config.machineLocalChanged ? ["machine_kind"] : [],
       ...config.defaultModelLocalChanged ? ["default_model"] : [],
-      ...config.runtimeMode.localChanged ? ["runtime_mode"] : []
+      ...config.runtimeMode.localChanged ? ["runtime_mode"] : [],
+      ...config.concurrency.localChanged ? ["self_delegation_concurrency_limit"] : []
     ].join(", ")}.`);
     if (config.machineLocalChanged) {
       f2.info(`machine_kind cannot change on an existing agent. Run ${import_picocolors28.default.cyan("brainbase agent pull --force")} to discard the edit, or create a new agent for that provider.`);
@@ -67872,7 +67939,8 @@ async function runAgentPull(cwd2, args) {
   }
   const runtimeModeChanged = config.runtimeMode.cloudChanged || existingManifest?.runtime_mode === "fixed" && cloudAgent.runtime_mode === "fixed" || !!args.force && config.runtimeMode.localChanged;
   const leadConfigChanged = config.machineCloudChanged || config.defaultModelCloudChanged || !!args.force && (config.machineLocalChanged || config.defaultModelLocalChanged);
-  const runtimeConfigChanged = leadConfigChanged || runtimeModeChanged;
+  const concurrencyChanged = config.concurrency.cloudChanged || !!args.force && config.concurrency.localChanged;
+  const runtimeConfigChanged = leadConfigChanged || runtimeModeChanged || concurrencyChanged;
   const toInstallKeys = new Set;
   const toRemoveKeys = new Set;
   const conflicts = [];
@@ -67981,7 +68049,8 @@ async function runAgentPull(cwd2, args) {
       label: "runtime config",
       text: [
         ...leadConfigChanged ? ["machine/model"] : [],
-        ...runtimeModeChanged ? ["runtime_mode"] : []
+        ...runtimeModeChanged ? ["runtime_mode"] : [],
+        ...concurrencyChanged ? ["self_delegation_concurrency_limit"] : []
       ].join(" + ") + " from cloud"
     });
   }
@@ -68135,7 +68204,8 @@ async function runAgentPull(cwd2, args) {
         ...cloudAgent.machine_kind ? { machine_kind: cloudAgent.machine_kind } : lock?.agentMeta?.machine_kind ? { machine_kind: lock.agentMeta.machine_kind } : {},
         ...Object.prototype.hasOwnProperty.call(cloudAgent, "default_model") ? { default_model: cloudAgent.default_model ?? null } : Object.prototype.hasOwnProperty.call(lock?.agentMeta ?? {}, "default_model") ? { default_model: lock.agentMeta.default_model ?? null } : {},
         ...capabilityBaseline(cloudAgent, lock?.agentMeta),
-        ...runtimeModeBaseline(cloudAgent, lock?.agentMeta)
+        ...runtimeModeBaseline(cloudAgent, lock?.agentMeta),
+        ...concurrencyBaseline(cloudAgent, lock?.agentMeta)
       }
     };
     writeSyncState(cwd2, newState);
@@ -68342,6 +68412,7 @@ function mergeManifest(cwd2, prev, cloud, cloudAgent, harness, localOnly = {}, s
   const defaultModelSupported = Object.prototype.hasOwnProperty.call(cloudAgent, "default_model");
   return {
     schema: 1,
+    ...concurrencyManifest(cloudAgent, prev ?? undefined),
     id: cloudAgent.id,
     harness,
     ...machineKind ? { machine_kind: machineKind } : {},
@@ -68444,7 +68515,8 @@ function buildLockFromCloud(agent_id, cloud, prev, cloudAgent) {
       ...cloudAgent.machine_kind ? { machine_kind: cloudAgent.machine_kind } : prev?.agentMeta?.machine_kind ? { machine_kind: prev.agentMeta.machine_kind } : {},
       ...Object.prototype.hasOwnProperty.call(cloudAgent, "default_model") ? { default_model: cloudAgent.default_model ?? null } : Object.prototype.hasOwnProperty.call(prev?.agentMeta ?? {}, "default_model") ? { default_model: prev.agentMeta.default_model ?? null } : {},
       ...capabilityBaseline(cloudAgent, prev?.agentMeta),
-      ...runtimeModeBaseline(cloudAgent, prev?.agentMeta)
+      ...runtimeModeBaseline(cloudAgent, prev?.agentMeta),
+      ...concurrencyBaseline(cloudAgent, prev?.agentMeta)
     } : prev?.agentMeta
   };
 }
@@ -69073,8 +69145,8 @@ function fastApiValidationMessage(body) {
   }).filter((part) => !!part);
   return parts.length ? parts.join("; ") : null;
 }
-function rejectsBodyField(body, field) {
-  return fastApiDetails(body).some((entry) => entry.type === "extra_forbidden" && Array.isArray(entry.loc) && entry.loc[0] === "body" && entry.loc[1] === field);
+function rejectsBodyField(body, field2) {
+  return fastApiDetails(body).some((entry) => entry.type === "extra_forbidden" && Array.isArray(entry.loc) && entry.loc[0] === "body" && entry.loc[1] === field2);
 }
 
 // src/core/interfaces-api.ts
@@ -69940,6 +70012,11 @@ async function runAgentPush(cwd2, args) {
     }
     f2.warn(`${import_picocolors30.default.yellow("--force")}: overwriting the cloud runtime_mode with the local value.`);
   }
+  if (config.concurrency.conflict && !args.force) {
+    f2.error("Cannot push: self_delegation_concurrency_limit conflicts with cloud or has no sync baseline. Pull first, or use --force to keep the local value.");
+    process.exitCode = 1;
+    return;
+  }
   const conflictedCapabilities = WRITABLE_CAPABILITIES.filter((name) => config[name].conflict);
   if (conflictedCapabilities.length > 0) {
     const label = conflictedCapabilities.map((name) => `capabilities.${name}`).join(" and ");
@@ -70138,11 +70215,11 @@ async function runAgentPush(cwd2, args) {
     }
     f2.info(`If you push now, your push targets revision ${cloud.revision} and may race. Consider \`brainbase agent pull\` first.`);
   }
-  if (config.defaultModelCloudChanged || config.machineCloudChanged || config.runtimeMode.cloudChanged) {
+  if (config.defaultModelCloudChanged || config.machineCloudChanged || config.runtimeMode.cloudChanged || config.concurrency.cloudChanged) {
     f2.warn(`Cloud runtime config changed since the last sync. Run ${import_picocolors30.default.cyan("brainbase agent pull")} to accept it locally.`);
   }
   const shouldPushManifest = meta.localChanged || entrypointChanged || toSend.length > 0;
-  const shouldUpdateAgent = meta.localChanged || entrypointChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged || config.memory.localChanged || config.browser.localChanged;
+  const shouldUpdateAgent = meta.localChanged || entrypointChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged || config.concurrency.localChanged || config.memory.localChanged || config.browser.localChanged;
   const hasAgentChanges = shouldPushManifest || shouldUpdateAgent;
   const outgoing = hasAgentChanges ? await buildOutgoingComponents(cwd2, manifest, cloud, resolvedVersions) : null;
   if (hasAgentChanges && outgoing === null) {
@@ -70186,7 +70263,7 @@ async function runAgentPush(cwd2, args) {
     });
   }
   if (!hasAgentChanges && !secretPlan) {
-    if (config.defaultModelCloudChanged || config.runtimeMode.cloudChanged || config.machineCloudChanged || config.memory.cloudChanged || config.browser.cloudChanged) {
+    if (config.defaultModelCloudChanged || config.runtimeMode.cloudChanged || config.concurrency.cloudChanged || config.machineCloudChanged || config.memory.cloudChanged || config.browser.cloudChanged) {
       f2.info("Nothing local to push; cloud runtime config is awaiting pull.");
       return;
     }
@@ -70228,6 +70305,9 @@ async function runAgentPush(cwd2, args) {
   if (config.runtimeMode.localChanged) {
     resultRows.push({ type: "upd", label: "runtime mode", text: manifest.runtime_mode });
   }
+  if (config.concurrency.localChanged) {
+    resultRows.push({ type: "upd", label: "children running at once", text: manifest.self_delegation_concurrency_limit === null ? "Unlimited" : String(manifest.self_delegation_concurrency_limit ?? "inherit") });
+  }
   if (toSend.length) {
     resultRows.push({
       type: "add",
@@ -70290,7 +70370,7 @@ async function runAgentPush(cwd2, args) {
   }
   const changesPinnedDefinition = toSend.length > 0 || evalArchives.length > 0 || playbookArchives.length > 0 || entrypointChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged;
   const pinMessage = changesPinnedDefinition ? pinnedPushMessage(agentId) : Promise.resolve(null);
-  if (meta.localChanged || entrypointChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged || config.memory.localChanged || config.browser.localChanged) {
+  if (meta.localChanged || entrypointChanged || config.defaultModelLocalChanged || config.runtimeMode.localChanged || config.concurrency.localChanged || config.memory.localChanged || config.browser.localChanged) {
     const metaSpinner = spinner();
     metaSpinner.start("Updating agent config…");
     try {
@@ -70314,10 +70394,12 @@ async function runAgentPush(cwd2, args) {
       if (config.browser.localChanged) {
         update2.browser_enabled = manifest.capabilities?.browser;
       }
+      Object.assign(update2, concurrencyWrite(manifest, cloudAgent, config.concurrency));
       cloudAgent = await api.updateAgent(agentId, update2, httpRetryEnabled() ? { idempotent: true } : undefined);
       if (update2.runtime_mode !== undefined && cloudAgent.runtime_mode !== update2.runtime_mode) {
         throw new Error("This control plane did not apply runtime_mode. Upgrade it before retrying; the sync baseline is unchanged.");
       }
+      verifyConcurrencyWrite(update2, cloudAgent);
       metaSpinner.stop("Agent config updated.");
     } catch (err) {
       metaSpinner.stop("Failed.");
@@ -70490,7 +70572,8 @@ function buildAgentMetaAfterPush({
     ...config.machineCloudChanged ? lock?.agentMeta?.machine_kind ? { machine_kind: lock.agentMeta.machine_kind } : {} : cloudAgent.machine_kind ? { machine_kind: cloudAgent.machine_kind } : lock?.agentMeta?.machine_kind ? { machine_kind: lock.agentMeta.machine_kind } : {},
     ...config.defaultModelCloudChanged && !config.defaultModelLocalChanged ? Object.prototype.hasOwnProperty.call(lock?.agentMeta ?? {}, "default_model") ? { default_model: lock.agentMeta.default_model ?? null } : {} : Object.prototype.hasOwnProperty.call(cloudAgent, "default_model") ? { default_model: cloudAgent.default_model ?? null } : Object.prototype.hasOwnProperty.call(lock?.agentMeta ?? {}, "default_model") ? { default_model: lock.agentMeta.default_model ?? null } : {},
     ...capabilityBaselineAfterPush(cloudAgent, lock?.agentMeta, config),
-    ...runtimeModeBaselineAfterPush(lock?.agentMeta, config.runtimeMode, manifest.runtime_mode)
+    ...runtimeModeBaselineAfterPush(lock?.agentMeta, config.runtimeMode, manifest.runtime_mode),
+    ...concurrencyBaselineAfterPush(manifest, lock?.agentMeta, config.concurrency)
   };
 }
 async function planSecretPush(cwd2, agentId) {
@@ -70692,8 +70775,8 @@ function handleApiError3(err) {
 // src/cli/agent-status.ts
 import path89 from "node:path";
 var import_picocolors31 = __toESM(require_picocolors(), 1);
-function capabilityDrifted(field) {
-  return field.localChanged || field.cloudChanged || field.conflict;
+function capabilityDrifted(field2) {
+  return field2.localChanged || field2.cloudChanged || field2.conflict;
 }
 async function runAgentStatus(cwd2, args = {}) {
   const json = args.json === true;
@@ -70809,7 +70892,7 @@ async function runAgentStatus(cwd2, args = {}) {
   }
   const componentsDrifted = conflicts.length > 0 || toPush.length > 0 || toPull.length > 0;
   const metaDrifted = meta.localChanged || meta.cloudChanged;
-  const configDrifted = config.unsupported.length > 0 || config.machineMismatch || config.machineCloudChanged || config.defaultModelLocalChanged || config.defaultModelCloudChanged || capabilityDrifted(config.runtimeMode) || capabilityDrifted(config.memory) || capabilityDrifted(config.browser);
+  const configDrifted = config.unsupported.length > 0 || config.machineMismatch || config.machineCloudChanged || config.defaultModelLocalChanged || config.defaultModelCloudChanged || capabilityDrifted(config.runtimeMode) || capabilityDrifted(config.concurrency) || capabilityDrifted(config.memory) || capabilityDrifted(config.browser);
   const secretsDrifted = secretDrift.localOnly.length > 0 || secretDrift.cloudOnly.length > 0 || secretDrift.changed.length > 0;
   const secretConflicts = cloudAgent.secret_conflicts ?? [];
   const inheritedSecrets = (cloudAgent.inherited_secret_keys ?? []).map((entry) => ({
@@ -70850,6 +70933,7 @@ async function runAgentStatus(cwd2, args = {}) {
         defaultModelCloudChanged: config.defaultModelCloudChanged,
         defaultModelConflict: config.defaultModelConflict,
         ...cloudAgent.runtime_mode === "auto" || manifest.runtime_mode !== undefined || lock?.agentMeta?.runtime_mode === "auto" ? { runtimeMode: config.runtimeMode } : {},
+        ...cloudAgent.self_delegation_concurrency_supported === true || manifest.self_delegation_concurrency_limit !== undefined || lock?.agentMeta?.self_delegation_concurrency_limit !== undefined ? { concurrency: config.concurrency } : {},
         memory: config.memory,
         browser: config.browser
       },
@@ -70927,15 +71011,15 @@ async function runAgentStatus(cwd2, args = {}) {
       }
     }
     for (const name of WRITABLE_CAPABILITIES) {
-      const field = config[name];
-      if (field.conflict) {
+      const field2 = config[name];
+      if (field2.conflict) {
         lines.push(`    ${import_picocolors31.default.red("! conflict")}  capabilities.${name} changed locally and on cloud`);
         continue;
       }
-      if (field.localChanged) {
+      if (field2.localChanged) {
         lines.push(`    ${import_picocolors31.default.yellow("→ push")}  capabilities.${name} edited locally`);
       }
-      if (field.cloudChanged) {
+      if (field2.cloudChanged) {
         lines.push(`    ${import_picocolors31.default.cyan("← pull")}  capabilities.${name} changed on cloud`);
       }
     }
@@ -70947,6 +71031,14 @@ async function runAgentStatus(cwd2, args = {}) {
       if (config.runtimeMode.cloudChanged)
         lines.push(`    ${import_picocolors31.default.cyan("← pull")}  runtime_mode changed on cloud`);
     }
+    if (config.concurrency.conflict) {
+      lines.push(`    ${import_picocolors31.default.red("! conflict")}  self_delegation_concurrency_limit conflicts with cloud or has no sync baseline`);
+    } else {
+      if (config.concurrency.localChanged)
+        lines.push(`    ${import_picocolors31.default.yellow("→ push")}  self_delegation_concurrency_limit edited locally`);
+      if (config.concurrency.cloudChanged)
+        lines.push(`    ${import_picocolors31.default.cyan("← pull")}  self_delegation_concurrency_limit changed on cloud`);
+    }
     lines.push("");
   }
   if (secretsDrifted || !secretsChecked || hasInheritedSecrets) {
@@ -71613,7 +71705,8 @@ async function runAgentCreate(cwd2, args) {
       ...resolvedEntrypoint !== undefined ? { entrypoint: resolvedEntrypoint } : {},
       ...manifest.machine_kind !== undefined ? { machine_kind: manifest.machine_kind } : {},
       ...manifest.default_model !== undefined ? { default_model: manifest.default_model } : {},
-      ...manifest.runtime_mode !== undefined ? { runtime_mode: manifest.runtime_mode } : {}
+      ...manifest.runtime_mode !== undefined ? { runtime_mode: manifest.runtime_mode } : {},
+      ...concurrencyLimit(manifest)
     });
     createSpinner.stop(`Created ${import_picocolors34.default.bold(agent.name)}.`);
   } catch (err) {
@@ -71624,14 +71717,16 @@ async function runAgentCreate(cwd2, args) {
   const machineConfigMissing = manifest.machine_kind !== undefined && agent.machine_kind !== manifest.machine_kind;
   const modelConfigMissing = manifest.default_model !== undefined && (!Object.prototype.hasOwnProperty.call(agent, "default_model") || (agent.default_model ?? null) !== (manifest.default_model ?? null));
   const modeConfigMissing = manifest.runtime_mode !== undefined && agent.runtime_mode !== manifest.runtime_mode;
-  if (machineConfigMissing || modelConfigMissing || modeConfigMissing) {
+  const concurrencyConfigMissing = manifest.self_delegation_concurrency_limit !== undefined && (agent.self_delegation_concurrency_supported !== true || agent.self_delegation_concurrency_limit !== manifest.self_delegation_concurrency_limit);
+  if (machineConfigMissing || modelConfigMissing || modeConfigMissing || concurrencyConfigMissing) {
     manifest.id = agent.id;
     manifest.harness = harness;
     writeManifest(cwd2, manifest);
     const fields = [
       ...machineConfigMissing ? ["machine_kind"] : [],
       ...modelConfigMissing ? ["default_model"] : [],
-      ...modeConfigMissing ? ["runtime_mode"] : []
+      ...modeConfigMissing ? ["runtime_mode"] : [],
+      ...concurrencyConfigMissing ? ["self_delegation_concurrency_limit"] : []
     ];
     f2.error(`Agent ${import_picocolors34.default.bold(agent.id)} was created, but this control plane did not apply ${fields.join(" / ")}.`);
     if (machineConfigMissing) {
@@ -71784,7 +71879,8 @@ async function runAgentCreate(cwd2, args) {
       ...agent.machine_kind ? { machine_kind: agent.machine_kind } : {},
       ...Object.prototype.hasOwnProperty.call(agent, "default_model") ? { default_model: agent.default_model ?? null } : {},
       ...capabilityBaseline(agent, undefined),
-      ...runtimeModeBaseline(agent)
+      ...runtimeModeBaseline(agent),
+      ...concurrencyBaseline(agent)
     }
   };
   writeSyncState(cwd2, state);
@@ -72998,9 +73094,9 @@ async function defaultReadStdin(env3 = process.env, options = {}) {
     return "";
   }
 }
-async function defaultPrompt(field) {
+async function defaultPrompt(field2) {
   const answer = await re({
-    message: field.label,
+    message: field2.label,
     validate: (v3) => v3 && v3.trim() ? undefined : "Required"
   });
   return String(ensureNotCancelled(answer)).trim();
@@ -73017,10 +73113,10 @@ function parseStdinSecrets(raw, missing) {
       throw new Error('stdin looked like JSON but could not be parsed. Pass an object such as {"bot_token":"…","signing_secret":"…"}.');
     }
     const out = {};
-    for (const field of missing) {
-      const value = clean2(source[field.key]);
+    for (const field2 of missing) {
+      const value = clean2(source[field2.key]);
       if (value)
-        out[field.key] = value;
+        out[field2.key] = value;
     }
     return out;
   }
@@ -73035,10 +73131,10 @@ async function resolveSecrets(fields, deps = {}) {
   const prompt = deps.prompt ?? defaultPrompt;
   const interactive = deps.interactive ?? isInteractive;
   const resolved = {};
-  for (const field of fields) {
-    const value = clean2(field.value) ?? clean2(env3[field.envVar]);
+  for (const field2 of fields) {
+    const value = clean2(field2.value) ?? clean2(env3[field2.envVar]);
     if (value)
-      resolved[field.key] = value;
+      resolved[field2.key] = value;
   }
   let missing = fields.filter((f4) => !resolved[f4.key]);
   if (missing.length > 0) {
@@ -73048,11 +73144,11 @@ async function resolveSecrets(fields, deps = {}) {
       missing = fields.filter((f4) => !resolved[f4.key]);
     }
   }
-  for (const field of missing) {
+  for (const field2 of missing) {
     if (!interactive()) {
-      throw new NonInteractiveError(`${field.label} is required. Pass ${field.flag}, set ${field.envVar}, or pipe it on stdin.`);
+      throw new NonInteractiveError(`${field2.label} is required. Pass ${field2.flag}, set ${field2.envVar}, or pipe it on stdin.`);
     }
-    resolved[field.key] = await prompt(field);
+    resolved[field2.key] = await prompt(field2);
   }
   return resolved;
 }
@@ -75057,10 +75153,10 @@ var $ZodObject = /* @__PURE__ */ $constructor("$ZodObject", (inst, def) => {
     const shape = def.shape;
     const propValues = {};
     for (const key2 in shape) {
-      const field = shape[key2]._zod;
-      if (field.values) {
+      const field2 = shape[key2]._zod;
+      if (field2.values) {
         propValues[key2] ?? (propValues[key2] = new Set);
-        for (const v3 of field.values)
+        for (const v3 of field2.values)
           propValues[key2].add(v3);
       }
     }
@@ -80511,11 +80607,11 @@ ${value2}`, dataLines++;
       processField(line, "", line);
       return;
     }
-    const field = line.slice(0, fieldSeparatorIndex), offset = line.charCodeAt(fieldSeparatorIndex + 1) === SPACE ? 2 : 1, value = line.slice(fieldSeparatorIndex + offset);
-    processField(field, value, line);
+    const field2 = line.slice(0, fieldSeparatorIndex), offset = line.charCodeAt(fieldSeparatorIndex + 1) === SPACE ? 2 : 1, value = line.slice(fieldSeparatorIndex + offset);
+    processField(field2, value, line);
   }
-  function processField(field, value, line) {
-    switch (field) {
+  function processField(field2, value, line) {
+    switch (field2) {
       case "event":
         eventType = value || undefined;
         break;
@@ -80534,7 +80630,7 @@ ${value}`, dataLines++;
         }));
         break;
       default:
-        onError(new ParseError(`Unknown field "${field.length > 20 ? `${field.slice(0, 20)}…` : field}"`, { type: "unknown-field", field, value, line }));
+        onError(new ParseError(`Unknown field "${field2.length > 20 ? `${field2.slice(0, 20)}…` : field2}"`, { type: "unknown-field", field: field2, value, line }));
         break;
     }
   }
@@ -82744,23 +82840,23 @@ async function runAgentSurface(cwd2, argv, deps = {}) {
     if (action === "configure") {
       expectArgs(args, 0, `${surface} configure <flags>`);
       const config2 = {};
-      for (const [flag, field] of Object.entries(configureFlags[surface])) {
+      for (const [flag, field2] of Object.entries(configureFlags[surface])) {
         const input = s3(flag);
         if (input === undefined)
           continue;
         let result2 = input;
-        if (booleanConfig.has(field))
+        if (booleanConfig.has(field2))
           result2 = explicitBoolean(input, flag);
-        else if (field === "allowed_models" || field === "computer_panel_tabs")
+        else if (field2 === "allowed_models" || field2 === "computer_panel_tabs")
           result2 = list(input);
-        else if (field === "template_prompts")
+        else if (field2 === "template_prompts")
           result2 = await readPrompts(path95.resolve(cwd2, input));
-        else if (field === "bot_name") {
+        else if (field2 === "bot_name") {
           result2 = input.trim();
           if (!result2)
             throw new SurfaceCommandError("--bot-name must not be blank.");
         }
-        Object.assign(config2, { [field]: result2 });
+        Object.assign(config2, { [field2]: result2 });
       }
       if (!Object.keys(config2).length)
         throw new SurfaceCommandError("Pass at least one configuration flag. See brainbase agent surface --help.");
@@ -83826,7 +83922,7 @@ function printJson(value3) {
 function progress(json4) {
   return json4 ? (line) => console.error(line) : (line) => console.log(line);
 }
-function field(label, value3) {
+function field2(label, value3) {
   return `  ${import_picocolors45.default.dim(label.padEnd(12))}${value3}`;
 }
 function interruption(deps) {
@@ -84007,16 +84103,16 @@ function printDiff(agentId, result2) {
   const { diff: body } = result2;
   banner(`agent version diff ${result2.from ? `v${result2.from.version_number} -> ` : ""}v${result2.to.version_number}`);
   const out = [""];
-  out.push(field("agent", safe(agentId)));
-  out.push(field("from", versionLabel(result2.from)));
-  out.push(field("to", versionLabel(result2.to)));
+  out.push(field2("agent", safe(agentId)));
+  out.push(field2("from", versionLabel(result2.from)));
+  out.push(field2("to", versionLabel(result2.to)));
   if (body.initial) {
-    out.push(field("changes", `v${result2.to.version_number} is the first version, so everything reads as added`));
+    out.push(field2("changes", `v${result2.to.version_number} is the first version, so everything reads as added`));
   } else if (body.identical) {
-    out.push(field("changes", "none"));
+    out.push(field2("changes", "none"));
   } else {
     const count = body.sections.length;
-    out.push(field("changes", `${import_picocolors47.default.green(`+${body.totals.added}`)} ${import_picocolors47.default.red(`-${body.totals.removed}`)} lines in ${count} ${count === 1 ? "section" : "sections"}`));
+    out.push(field2("changes", `${import_picocolors47.default.green(`+${body.totals.added}`)} ${import_picocolors47.default.red(`-${body.totals.removed}`)} lines in ${count} ${count === 1 ? "section" : "sections"}`));
   }
   out.push("");
   if (body.identical) {
@@ -85297,8 +85393,8 @@ async function list2(ctx) {
     }
     banner("agent versions, newest first");
     const out = [""];
-    out.push(field("agent", safe(agentId)));
-    out.push(field("pinned", pinLine(listing.pin)));
+    out.push(field2("agent", safe(agentId)));
+    out.push(field2("pinned", pinLine(listing.pin)));
     out.push("");
     if (listing.items.length === 0) {
       out.push(`  ${import_picocolors49.default.dim("No versions yet. One is saved a few seconds after each change to the agent.")}`);
@@ -85343,21 +85439,21 @@ function printVersion(version2) {
   const none = import_picocolors49.default.dim("none");
   banner(`agent version ${versionName(version2)}`);
   const out = [""];
-  out.push(field("version", `v${version2.version_number}`));
-  out.push(field("id", safe(version2.id)));
-  out.push(field("kind", safe(version2.kind)));
-  out.push(field("label", version2.label ? safe(version2.label) : none));
-  out.push(field("description", version2.description ? safe(version2.description) : none));
-  out.push(field("summary", version2.summary ? safe(version2.summary) : none));
-  out.push(field("created", `${safe(version2.created_at)} ${import_picocolors49.default.dim(`(${ago(version2.created_at)})`)}`));
-  out.push(field("by", `${safe(version2.actor_type ?? "unknown")} ${safe(version2.created_by ?? "")}`.trim()));
-  out.push(field("source", version2.source ? safe(version2.source) : none));
+  out.push(field2("version", `v${version2.version_number}`));
+  out.push(field2("id", safe(version2.id)));
+  out.push(field2("kind", safe(version2.kind)));
+  out.push(field2("label", version2.label ? safe(version2.label) : none));
+  out.push(field2("description", version2.description ? safe(version2.description) : none));
+  out.push(field2("summary", version2.summary ? safe(version2.summary) : none));
+  out.push(field2("created", `${safe(version2.created_at)} ${import_picocolors49.default.dim(`(${ago(version2.created_at)})`)}`));
+  out.push(field2("by", `${safe(version2.actor_type ?? "unknown")} ${safe(version2.created_by ?? "")}`.trim()));
+  out.push(field2("source", version2.source ? safe(version2.source) : none));
   if (version2.restored_from)
-    out.push(field("restored", `from ${safe(version2.restored_from)}`));
+    out.push(field2("restored", `from ${safe(version2.restored_from)}`));
   if (version2.labeled_at) {
-    out.push(field("labelled", `${ago(version2.labeled_at)}${version2.labeled_by ? ` by ${safe(version2.labeled_by)}` : ""}`));
+    out.push(field2("labelled", `${ago(version2.labeled_at)}${version2.labeled_by ? ` by ${safe(version2.labeled_by)}` : ""}`));
   }
-  out.push(field("pinned", version2.pinned ? "yes, new tasks run this version" : "no"));
+  out.push(field2("pinned", version2.pinned ? "yes, new tasks run this version" : "no"));
   out.push("");
   console.log(out.join(`
 `));
@@ -85468,6 +85564,8 @@ var SyncedOrchestrationMetaSchema = exports_external.object({
 });
 var OrchestrationSyncStateSchema = exports_external.object({
   schemaVersion: exports_external.literal(1),
+  self_delegation_concurrency_limit: SelfDelegationConcurrencySchema,
+  self_delegation_concurrency_supported: exports_external.boolean().optional(),
   orchestration_id: exports_external.string(),
   revision: exports_external.number(),
   synced_at: exports_external.string(),
@@ -85988,6 +86086,7 @@ var DecisionSchema = exports_external.object({
 });
 var OrchestrationManifestSchema = exports_external.object({
   schema: exports_external.literal(1),
+  self_delegation_concurrency_limit: SelfDelegationConcurrencySchema,
   orchestration: OrchMetaSchema,
   members: exports_external.array(MemberSchema).default([]),
   edges: exports_external.array(EdgeSchema).default([]),
@@ -86068,6 +86167,7 @@ import os15 from "node:os";
 async function installAgentFresh(input) {
   const { cwd: cwd2, agent: agent2, cloud, harness } = input;
   const scope = input.scope ?? "project";
+  const { claimedByOther, previousManifest, previousMeta } = input.previousState ?? readFreshInstallPreviousState(cwd2, agent2.id);
   ensureDir(cwd2);
   const availableSecrets = input.pullSecrets === false ? {} : await pullAgentSecrets(cwd2, agent2.id);
   const stageRoot = stageManifestComponents2(cloud.components);
@@ -86107,10 +86207,7 @@ async function installAgentFresh(input) {
     }
     materializeInstructions2(cwd2, cloud);
     materializePlaybooks2(cwd2, cloud);
-    const claimedByOther = folderClaimedByOtherAgent(cwd2, agent2.id);
-    const previousMode = claimedByOther ? undefined : safeRead(() => readManifest(cwd2)?.runtime_mode);
-    const previousLock = safeRead(() => readSyncState(cwd2));
-    const previousMeta = previousLock?.agent_id === agent2.id ? previousLock.agentMeta : undefined;
+    const previousMode = previousManifest?.runtime_mode;
     const localOnly = input.preserveManifest || claimedByOther ? {} : readLocalOnlyContentReporting(cwd2);
     if (claimedByOther) {
       f2.warn(`${path98.basename(cwd2)} was linked to a different agent; its local-only blocks were left out of the rebuilt manifest.`);
@@ -86119,6 +86216,8 @@ async function installAgentFresh(input) {
     if (manifest && agent2.runtime_mode === undefined && previousMode !== undefined) {
       manifest.runtime_mode = previousMode;
     }
+    if (manifest)
+      Object.assign(manifest, concurrencyManifest(agent2, previousManifest));
     if (manifest)
       writeManifest(cwd2, manifest);
     writeLink(cwd2, {
@@ -86151,6 +86250,7 @@ async function installAgentFresh(input) {
         ...agent2.machine_kind ? { machine_kind: agent2.machine_kind } : {},
         ...Object.prototype.hasOwnProperty.call(agent2, "default_model") ? { default_model: agent2.default_model ?? null } : {},
         ...runtimeModeBaseline(agent2, previousMeta),
+        ...concurrencyBaseline(agent2, previousMeta),
         ...capabilityBaseline(agent2, undefined)
       }
     });
@@ -86259,6 +86359,7 @@ function buildManifestFromCloud(cloud, agent2, localOnly = {}) {
     schema: 1,
     ...agent2.machine_kind ? { machine_kind: agent2.machine_kind } : {},
     ...agent2.runtime_mode === "auto" ? { runtime_mode: "auto" } : {},
+    ...concurrencyManifest(agent2),
     ...agent2.default_model ? { default_model: agent2.default_model } : {},
     agent: {
       name: agent2.name,
@@ -86300,9 +86401,16 @@ async function pullAgentSecrets(cwd2, agentId) {
     return {};
   }
 }
-function folderClaimedByOtherAgent(cwd2, agentId) {
-  const claimedBy = readManifestAgentId(cwd2) ?? safeRead(() => readLink(cwd2)?.agent_id) ?? safeRead(() => readSyncState(cwd2)?.agent_id);
-  return claimedBy !== undefined && claimedBy !== agentId;
+function readFreshInstallPreviousState(cwd2, agentId) {
+  const manifest = safeRead(() => readManifest(cwd2)) ?? undefined;
+  const lock = safeRead(() => readSyncState(cwd2));
+  const claimedBy = (manifest ? manifest.id : readManifestAgentId(cwd2)) ?? safeRead(() => LinkSchema.parse(JSON.parse(fs85.readFileSync(legacyLinkPath(cwd2), "utf8"))).agent_id) ?? lock?.agent_id;
+  const claimedByOther = claimedBy !== undefined && claimedBy !== agentId;
+  return {
+    claimedByOther,
+    previousManifest: claimedByOther ? undefined : manifest,
+    previousMeta: lock?.agent_id === agentId ? lock.agentMeta : undefined
+  };
 }
 function safeRead(read2) {
   try {
@@ -86700,14 +86808,14 @@ function decideOrchestrationMeta(input) {
   if (!meta)
     return [];
   const out = [];
-  for (const field2 of ORCH_META_FIELDS) {
-    const local = metaText(meta[field2]);
-    const cloud = metaText(input.cloud[field2]) ?? "";
+  for (const field3 of ORCH_META_FIELDS) {
+    const local = metaText(meta[field3]);
+    const cloud = metaText(input.cloud[field3]) ?? "";
     if (local === undefined)
       continue;
     if (local === cloud)
       continue;
-    const base2 = input.baseline === undefined ? undefined : metaText(input.baseline[field2]) ?? "";
+    const base2 = input.baseline === undefined ? undefined : metaText(input.baseline[field3]) ?? "";
     let kind;
     if (base2 === undefined) {
       kind = "conflict";
@@ -86720,21 +86828,21 @@ function decideOrchestrationMeta(input) {
     }
     if (kind === "conflict" && input.force)
       kind = "push";
-    out.push({ field: field2, kind, local, cloud });
+    out.push({ field: field3, kind, local, cloud });
   }
   return out;
 }
 function nextOrchestrationMeta(input) {
   const kept = new Set(input.decisions.filter((d3) => d3.kind === "keep").map((d3) => d3.field));
   const out = {};
-  for (const field2 of ORCH_META_FIELDS) {
-    const value3 = kept.has(field2) ? input.previous?.[field2] : input.applied[field2];
+  for (const field3 of ORCH_META_FIELDS) {
+    const value3 = kept.has(field3) ? input.previous?.[field3] : input.applied[field3];
     if (value3 == null)
       continue;
-    if (field2 === "credit_limit") {
+    if (field3 === "credit_limit") {
       out.credit_limit = typeof value3 === "number" ? value3 : Number(value3);
     } else {
-      out[field2] = String(value3);
+      out[field3] = String(value3);
     }
   }
   return out;
@@ -86817,6 +86925,34 @@ async function runOrchestrationPull(cwd2, args) {
   }
   const slugByAgent = resolveMemberSlugs(cloud.members);
   const slugFor = (agentId) => slugByAgent.get(agentId) ?? agentId;
+  let previousManifest = null;
+  try {
+    previousManifest = readOrchManifest(cwd2);
+  } catch {}
+  const previousLock = readOrchSyncState(cwd2);
+  const memberStates = new Map(cloud.members.filter((m3) => m3.manifest).map((m3) => [
+    m3.agent_id,
+    readFreshInstallPreviousState(memberDir(cwd2, slugFor(m3.agent_id)), m3.agent_id)
+  ]));
+  const edited = [];
+  if (previousManifest && (!existingLink || existingLink.orchestration_id === cloud.id || previousLock?.orchestration_id === cloud.id)) {
+    const diff3 = diffConcurrency(previousManifest, previousLock?.orchestration_id === cloud.id ? previousLock : undefined, cloud);
+    if (diff3.localChanged && !diff3.converged)
+      edited.push("brainbase-orchestration.yaml");
+  }
+  for (const m3 of cloud.members) {
+    const state = memberStates.get(m3.agent_id);
+    if (!state?.previousManifest || state.claimedByOther)
+      continue;
+    const diff3 = diffConcurrency(state.previousManifest, state.previousMeta, m3);
+    if (diff3.localChanged && !diff3.converged)
+      edited.push(`${ORCH_MEMBERS_DIR}/${slugFor(m3.agent_id)}/brainbase.agent.yaml`);
+  }
+  if (edited.length && !args.force) {
+    fail(`self_delegation_concurrency_limit has local edits that pull would overwrite: ${edited.join(", ")}.`);
+    f2.info(`Push the edits first, or run ${import_picocolors54.default.cyan("brainbase orchestration pull --force")} to discard them.`);
+    return;
+  }
   const planLines = [];
   planLines.push("");
   planLines.push(`  ${import_picocolors54.default.bold(cloud.name)} ${import_picocolors54.default.dim(`(${cloud.id})`)}`);
@@ -86893,12 +87029,15 @@ async function runOrchestrationPull(cwd2, args) {
           harness: fallbackHarness,
           machine_kind: m3.machine_kind,
           default_model: m3.default_model,
-          runtime_mode: m3.runtime_mode
+          runtime_mode: m3.runtime_mode,
+          self_delegation_concurrency_limit: m3.self_delegation_concurrency_limit,
+          self_delegation_concurrency_supported: m3.self_delegation_concurrency_supported
         },
         cloud: m3.manifest,
         harness: fallbackHarness,
         scope: "project",
-        pullSecrets: true
+        pullSecrets: true,
+        previousState: memberStates.get(m3.agent_id)
       });
       memberSp.stop(`Installed ${import_picocolors54.default.bold(slug)} ${import_picocolors54.default.dim(`(${m3.manifest.components.length} components)`)}.`);
       installedMembers.push({
@@ -86916,11 +87055,8 @@ async function runOrchestrationPull(cwd2, args) {
   let manifestDecisions2 = pulledDecisions ? decisionsForManifest(pulledDecisions) : undefined;
   let decisionBaseline = pulledDecisions ? syncedDecisions(pulledDecisions) : undefined;
   if (!pulledDecisions) {
-    try {
-      manifestDecisions2 = readOrchManifest(cwd2)?.decisions;
-    } catch {}
-    const lock = readOrchSyncState(cwd2);
-    decisionBaseline = lock?.orchestration_id === cloud.id ? lock.decisions : undefined;
+    manifestDecisions2 = previousManifest?.decisions;
+    decisionBaseline = previousLock?.orchestration_id === cloud.id ? previousLock.decisions : undefined;
   }
   for (const [decisionId, count] of deadDecisionLinks(cloud)) {
     const name = pulledDecisions?.find((d3) => d3.id === decisionId)?.name;
@@ -86928,6 +87064,7 @@ async function runOrchestrationPull(cwd2, args) {
   }
   const manifest = {
     schema: 1,
+    ...concurrencyManifest(cloud, previousManifest ?? undefined),
     orchestration: {
       name: cloud.name,
       ...cloud.description ? { description: cloud.description } : {},
@@ -86965,6 +87102,7 @@ async function runOrchestrationPull(cwd2, args) {
   });
   writeOrchSyncState(cwd2, {
     schemaVersion: 1,
+    ...concurrencyBaseline(cloud, previousLock ?? undefined),
     orchestration_id: cloud.id,
     revision: cloud.revision,
     synced_at: new Date().toISOString(),
@@ -87293,6 +87431,17 @@ async function runOrchestrationPush(cwd2, args) {
     return;
   }
   const agentIdToSlug = new Map([...slugToAgentId.entries()].map(([slug, id]) => [id, slug]));
+  const concurrency = diffConcurrency(manifest, lock ?? undefined, cloud);
+  if (concurrency.unsupported) {
+    f2.error("This control plane does not support self_delegation_concurrency_limit. Upgrade it or enable self-delegation before retrying; the sync baseline is unchanged.");
+    process.exitCode = 1;
+    return;
+  }
+  if (concurrency.conflict && !args.force) {
+    f2.error("Cannot push: self_delegation_concurrency_limit conflicts with cloud or has no sync baseline. Pull first, or use --force to keep the local value.");
+    process.exitCode = 1;
+    return;
+  }
   const slugForAgent = (agentId, fallback) => agentIdToSlug.get(agentId) ?? fallback;
   const selfConflicts = selfEdgeConflicts(manifest, cloud, lock, slugToAgentId);
   if (selfConflicts.length && args.force)
@@ -87549,16 +87698,17 @@ async function runOrchestrationPush(cwd2, args) {
     }
   }
   const keptFields = new Set(metaKept.map((d3) => d3.field));
-  const metaField = (field2) => {
-    const value3 = manifest.orchestration[field2];
-    if (value3 === undefined || keptFields.has(field2))
+  const metaField = (field3) => {
+    const value3 = manifest.orchestration[field3];
+    if (value3 === undefined || keptFields.has(field3))
       return {};
-    return { [field2]: value3 };
+    return { [field3]: value3 };
   };
   const sp = spinner();
   sp.start("Updating orchestration graph…");
   try {
     const updateInput = {
+      ...concurrencyWrite(manifest, cloud, concurrency),
       ...metaField("name"),
       ...metaField("description"),
       ...metaField("icon"),
@@ -87581,10 +87731,12 @@ async function runOrchestrationPush(cwd2, args) {
       sp.stop("Connection lost after the graph was sent — reading the cloud graph back…");
       updated = await reconcileOrchestrationUpdate(link2.orchestration_id, updateInput, sendDecisions ? localDecisions : null, slugForAgent, pushStartedAt);
     }
+    verifyConcurrencyWrite(updateInput, updated);
     sp.stop(`Graph updated. New cloud revision ${updated.revision}.`);
     const settledDecisions = sendDecisions ? cloudDecisions(updated, slugForAgent) : decisionPlan?.kind === "reconcile" ? cloudDecisionList : null;
     writeOrchSyncState(cwd2, {
       schemaVersion: 1,
+      ...concurrencyBaselineAfterPush(manifest, lock ?? undefined, concurrency),
       orchestration_id: updated.id,
       revision: updated.revision,
       synced_at: new Date().toISOString(),
@@ -87705,20 +87857,20 @@ function graphDivergence(cloud, sent) {
       }))));
     }
   }
-  for (const field2 of [
+  for (const field3 of [
     "name",
     "description",
     "icon",
     "icon_color",
     "credit_limit"
   ]) {
-    let expected = sent[field2];
-    if (field2 === "name" && typeof expected === "string")
+    let expected = sent[field3];
+    if (field3 === "name" && typeof expected === "string")
       expected = expected.trim();
-    if ((field2 === "icon" || field2 === "icon_color") && expected === "")
+    if ((field3 === "icon" || field3 === "icon_color") && expected === "")
       expected = null;
-    if (expected !== undefined && cloud[field2] !== expected) {
-      diffs.push(`${field2}: cloud has "${String(cloud[field2])}", sent "${String(expected)}"`);
+    if (expected !== undefined && cloud[field3] !== expected) {
+      diffs.push(`${field3}: cloud has "${String(cloud[field3])}", sent "${String(expected)}"`);
     }
   }
   return diffs;
@@ -87930,6 +88082,22 @@ async function runOrchestrationStatus(cwd2) {
       lines.push(`    ${import_picocolors57.default.cyan("← pull")}  added on cloud: ${k3}`);
     lines.push("");
   }
+  const concurrency = diffConcurrency(localManifest ?? {}, lock ?? undefined, cloud);
+  const concurrencyDrifted = concurrency.unsupported || concurrency.localChanged || concurrency.cloudChanged || concurrency.conflict;
+  if (concurrencyDrifted) {
+    lines.push(`  ${import_picocolors57.default.bold("children running at once")}`);
+    if (concurrency.unsupported)
+      lines.push(`    ${import_picocolors57.default.red("! unsupported")}  self_delegation_concurrency_limit not exposed by this control plane`);
+    else if (concurrency.conflict)
+      lines.push(`    ${import_picocolors57.default.red("! conflict")}  self_delegation_concurrency_limit conflicts with cloud or has no sync baseline`);
+    else {
+      if (concurrency.localChanged)
+        lines.push(`    ${import_picocolors57.default.yellow("→ push")}  self_delegation_concurrency_limit edited locally`);
+      if (concurrency.cloudChanged)
+        lines.push(`    ${import_picocolors57.default.cyan("← pull")}  self_delegation_concurrency_limit changed on cloud; push leaves it alone`);
+    }
+    lines.push("");
+  }
   const metaDecisions = decideOrchestrationMeta({
     manifest: localManifest,
     cloud,
@@ -88146,7 +88314,7 @@ async function runOrchestrationStatus(cwd2) {
     endpointLines.push(...webhookEndpointLines(cloudWebhooks, "    "));
     endpointLines.push("");
   }
-  if (!membersAdded.length && !membersRemoved.length && !edgesAdded.length && !edgesRemoved.length && !triggersToPush.length && !triggersToPull.length && !webhooksToPush.length && !webhooksToPull.length && !decisionsToPush.length && !decisionsToPull.length && !metaDecisions.length && !memberDrift.length && !revisionDrift) {
+  if (!membersAdded.length && !membersRemoved.length && !edgesAdded.length && !edgesRemoved.length && !triggersToPush.length && !triggersToPull.length && !webhooksToPush.length && !webhooksToPull.length && !decisionsToPush.length && !decisionsToPull.length && !metaDecisions.length && !concurrencyDrifted && !memberDrift.length && !revisionDrift) {
     lines.push(`  ${import_picocolors57.default.green("✓")} everything is in sync`);
     lines.push("");
     lines.push(...endpointLines);
@@ -88462,6 +88630,7 @@ async function runOrchestrationCreate(cwd2, args) {
   sp.start("Creating orchestration…");
   try {
     const created = await api.createOrchestration({
+      ...concurrencyLimit(manifest),
       org_id: target.org.id,
       team_id: target.team.id,
       name: manifest.orchestration.name,
@@ -88486,8 +88655,10 @@ async function runOrchestrationCreate(cwd2, args) {
       description: created.description || undefined,
       linked_at: new Date().toISOString()
     });
+    verifyConcurrencyWrite(manifest, created);
     writeOrchSyncState(cwd2, {
       schemaVersion: 1,
+      ...concurrencyBaseline(created),
       orchestration_id: created.id,
       revision: created.revision,
       synced_at: new Date().toISOString(),
@@ -88958,7 +89129,8 @@ async function runOrchestration(cwd2, sub, args, opts) {
       await runOrchestrationPull(cwd2, {
         orchestrationId: args[0],
         yes: opts.yes,
-        harness: opts.harness
+        harness: opts.harness,
+        force: opts.force
       });
       return;
     case "push":
@@ -89017,7 +89189,7 @@ function printHelp4() {
   out.push(`  ${import_picocolors64.default.cyan("init")}             ${import_picocolors64.default.dim("write a starter brainbase-orchestration.yaml here — offline, no login (--full for a commented template, --force to overwrite)")}`);
   out.push(`  ${import_picocolors64.default.cyan("create")}           ${import_picocolors64.default.dim("claim a local orchestration manifest and create it in the cloud")}`);
   out.push(`  ${import_picocolors64.default.cyan("from-agent")} ${import_picocolors64.default.dim("[agent-id]")} ${import_picocolors64.default.dim("turn an existing agent (default: this folder's) into an orchestration")}`);
-  out.push(`  ${import_picocolors64.default.cyan("pull")} ${import_picocolors64.default.dim("<id>")}      ${import_picocolors64.default.dim("fetch orchestration + every member agent into this folder")}`);
+  out.push(`  ${import_picocolors64.default.cyan("pull")} ${import_picocolors64.default.dim("<id>")}      ${import_picocolors64.default.dim("fetch orchestration + every member agent into this folder (--force to discard local concurrency edits)")}`);
   out.push(`  ${import_picocolors64.default.cyan("push")}             ${import_picocolors64.default.dim("push each member, then update the orchestration graph")}`);
   out.push(`  ${import_picocolors64.default.cyan("add-agent")} ${import_picocolors64.default.dim("<name>")}    ${import_picocolors64.default.dim("create a member agent, wire edges (--from/--to), and push")}`);
   out.push(`  ${import_picocolors64.default.cyan("status")}           ${import_picocolors64.default.dim("show what would push and what would pull")}`);
@@ -93497,19 +93669,19 @@ async function get2(ctx) {
     banner(`interface — ${safe(row.name)}`);
     const state = interfaceState(row);
     const out = [""];
-    out.push(field("id", safe(row.id)));
-    out.push(field("agent", agentLabel(safe(row.agent_id), await agentNames([row.agent_id]))));
-    out.push(field("state", stateTint(state)(state)));
-    out.push(field("address", row.live_release ? safe(row.live_release.url) : `${safe(row.slug)} ${import_picocolors79.default.dim("(nothing live yet)")}`));
-    out.push(field("audience", audienceLabel(row)));
-    out.push(field("threads", threadsLabel(row.share_agent_threads)));
-    out.push(field("live", row.live_release ? `${safe(row.live_release.id)} ${import_picocolors79.default.dim(`published ${ago(row.live_release.published_at)}`)}` : import_picocolors79.default.dim("none")));
-    out.push(field("draft", row.draft_version_id ? safe(row.draft_version_id) : import_picocolors79.default.dim("none yet")));
+    out.push(field2("id", safe(row.id)));
+    out.push(field2("agent", agentLabel(safe(row.agent_id), await agentNames([row.agent_id]))));
+    out.push(field2("state", stateTint(state)(state)));
+    out.push(field2("address", row.live_release ? safe(row.live_release.url) : `${safe(row.slug)} ${import_picocolors79.default.dim("(nothing live yet)")}`));
+    out.push(field2("audience", audienceLabel(row)));
+    out.push(field2("threads", threadsLabel(row.share_agent_threads)));
+    out.push(field2("live", row.live_release ? `${safe(row.live_release.id)} ${import_picocolors79.default.dim(`published ${ago(row.live_release.published_at)}`)}` : import_picocolors79.default.dim("none")));
+    out.push(field2("draft", row.draft_version_id ? safe(row.draft_version_id) : import_picocolors79.default.dim("none yet")));
     if (row.running_generation) {
-      out.push(field("building", `conversation ${safe(row.running_generation.thread_id ?? "")} ${import_picocolors79.default.dim(`(follow it with \`brainbase task logs ${safe(row.running_generation.thread_id ?? "")} --follow\`)`)}`));
+      out.push(field2("building", `conversation ${safe(row.running_generation.thread_id ?? "")} ${import_picocolors79.default.dim(`(follow it with \`brainbase task logs ${safe(row.running_generation.thread_id ?? "")} --follow\`)`)}`));
     }
     if (row.archived_at)
-      out.push(field("archived", ago(row.archived_at)));
+      out.push(field2("archived", ago(row.archived_at)));
     out.push("");
     console.log(out.join(`
 `));
@@ -93655,9 +93827,9 @@ function peopleLine(access, members) {
 function printAccess(row, access, members) {
   console.log([
     "",
-    field("audience", audienceLabel(access)),
-    field("people", peopleLine(access, members)),
-    field("threads", threadsLabel(row.share_agent_threads)),
+    field2("audience", audienceLabel(access)),
+    field2("people", peopleLine(access, members)),
+    field2("threads", threadsLabel(row.share_agent_threads)),
     ""
   ].join(`
 `));
@@ -93748,15 +93920,15 @@ async function create3(ctx) {
       "",
       `  ${import_picocolors80.default.green("Created")} ${import_picocolors80.default.bold(safe(created.name))}`,
       "",
-      field("id", id),
-      field("agent", safe(created.agent_id)),
-      field("address", `${safe(created.slug)} ${import_picocolors80.default.dim("(nothing live yet)")}`),
-      field("threads", threadsLabel(created.share_agent_threads))
+      field2("id", id),
+      field2("agent", safe(created.agent_id)),
+      field2("address", `${safe(created.slug)} ${import_picocolors80.default.dim("(nothing live yet)")}`),
+      field2("threads", threadsLabel(created.share_agent_threads))
     ];
     if (access) {
-      out.push(field("audience", audienceLabel(access)));
+      out.push(field2("audience", audienceLabel(access)));
       if (access.audience_mode === "users")
-        out.push(field("people", peopleLine(access, members)));
+        out.push(field2("people", peopleLine(access, members)));
     }
     if (!audience) {
       out.push("", `  Nobody can open it until you choose who can: \`brainbase interface access ${id} --everyone\` or \`--people <emails>\`.`);
@@ -93904,7 +94076,7 @@ async function threads(ctx) {
       }
       const already = wanted === null ? "" : ` ${import_picocolors80.default.dim("(already set; nothing changed)")}`;
       console.log(`
-${field("threads", `${threadsLabel(row.share_agent_threads)}${already}`)}
+${field2("threads", `${threadsLabel(row.share_agent_threads)}${already}`)}
 `);
       return;
     }
@@ -93925,7 +94097,7 @@ ${field("threads", `${threadsLabel(row.share_agent_threads)}${already}`)}
       return;
     }
     console.log(`
-${field("threads", threadsLabel(updated.share_agent_threads))}
+${field2("threads", threadsLabel(updated.share_agent_threads))}
 `);
   });
 }
@@ -94176,8 +94348,8 @@ async function preview(ctx) {
         "",
         `  ${outcome === "serving" ? import_picocolors81.default.green("Preview ready") : import_picocolors81.default.yellow("Preview starting")} ${import_picocolors81.default.bold(safe(started.name))}`,
         "",
-        field("address", address2 ? safe(address2) : import_picocolors81.default.dim(missingAddress(started))),
-        field("showing", showing(started, taskId)),
+        field2("address", address2 ? safe(address2) : import_picocolors81.default.dim(missingAddress(started))),
+        field2("showing", showing(started, taskId)),
         "",
         `  ${import_picocolors81.default.dim("Opens for people who can edit the agent, after signing in. Nothing is published.")}`,
         ""
@@ -98202,13 +98374,13 @@ var CaseEvaluatorOverrideSchema = exports_external.object({
     value3.evidence,
     value3.evaluation_materials
   ];
-  if (value3.mode === "override" && overrides.every((field2) => field2 == null)) {
+  if (value3.mode === "override" && overrides.every((field3) => field3 == null)) {
     ctx.addIssue({
       code: exports_external.ZodIssueCode.custom,
       message: "override mode must change evaluator fields"
     });
   }
-  if (value3.mode !== "override" && overrides.some((field2) => field2 != null)) {
+  if (value3.mode !== "override" && overrides.some((field3) => field3 != null)) {
     ctx.addIssue({
       code: exports_external.ZodIssueCode.custom,
       message: `${value3.mode} mode must not include evaluator overrides`
@@ -100282,11 +100454,11 @@ function bundledFileSetDigest(output, value3, label3) {
   return output.digest(descriptors);
 }
 function stringField(value3, key2) {
-  const field2 = value3[key2];
-  if (typeof field2 !== "string" || !field2.trim()) {
+  const field3 = value3[key2];
+  if (typeof field3 !== "string" || !field3.trim()) {
     throw usageError(`Response is missing ${key2}`);
   }
-  return field2;
+  return field3;
 }
 function context(cwd2, command, options, deps) {
   const agentId = resolveBenchmarkAgentId(cwd2, options.agent);
@@ -102093,18 +102265,18 @@ function rowItem(row, options, fallbackId) {
   if (!isRecord2(row))
     return { id, error: "Not an object, so --text-field has nothing to select" };
   if (options.textFields.length === 1) {
-    const field2 = options.textFields[0];
-    const value3 = row[field2];
+    const field3 = options.textFields[0];
+    const value3 = row[field3];
     if (value3 === undefined || value3 === null || value3 === "")
-      return { id, error: `Empty ${field2}` };
+      return { id, error: `Empty ${field3}` };
     return { id, text: typeof value3 === "string" ? value3 : JSON.stringify(value3) };
   }
-  const missing = options.textFields.filter((field2) => row[field2] === undefined);
+  const missing = options.textFields.filter((field3) => row[field3] === undefined);
   if (missing.length)
     return { id, error: `Missing ${missing.join(", ")}` };
   const picked = {};
-  for (const field2 of options.textFields)
-    picked[field2] = row[field2];
+  for (const field3 of options.textFields)
+    picked[field3] = row[field3];
   return { id, json: picked };
 }
 function sourceLabel(cwd2, file) {
@@ -102143,39 +102315,39 @@ function jsonlItems(cwd2, file, options) {
 function parseCsv(text4) {
   const rows = [];
   let row = [];
-  let field2 = "";
+  let field3 = "";
   let quoted = false;
   for (let i = 0;i < text4.length; i += 1) {
     const char = text4[i];
     if (quoted) {
       if (char === '"' && text4[i + 1] === '"') {
-        field2 += '"';
+        field3 += '"';
         i += 1;
       } else if (char === '"') {
         quoted = false;
       } else {
-        field2 += char;
+        field3 += char;
       }
-    } else if (char === '"' && field2 === "") {
+    } else if (char === '"' && field3 === "") {
       quoted = true;
     } else if (char === ",") {
-      row.push(field2);
-      field2 = "";
+      row.push(field3);
+      field3 = "";
     } else if (char === `
 ` || char === "\r") {
       if (char === "\r" && text4[i + 1] === `
 `)
         i += 1;
-      row.push(field2);
+      row.push(field3);
       rows.push(row);
       row = [];
-      field2 = "";
+      field3 = "";
     } else {
-      field2 += char;
+      field3 += char;
     }
   }
-  if (field2 !== "" || row.length > 0) {
-    row.push(field2);
+  if (field3 !== "" || row.length > 0) {
+    row.push(field3);
     rows.push(row);
   }
   return rows.filter((cells) => cells.some((cell) => cell !== ""));
@@ -102770,7 +102942,7 @@ function help() {
   out.push(`  ${import_picocolors86.default.cyan("orchestration create")}           ${import_picocolors86.default.dim("claim a local orchestration manifest and create it in the cloud")}`);
   out.push(`  ${import_picocolors86.default.cyan("orchestration from-agent")}       ${import_picocolors86.default.dim("turn an existing agent into an orchestration")}`);
   out.push(`  ${import_picocolors86.default.cyan("orchestration list")}             ${import_picocolors86.default.dim("list orchestrations under a team")}`);
-  out.push(`  ${import_picocolors86.default.cyan("orchestration pull")} ${import_picocolors86.default.dim("<id>")}        ${import_picocolors86.default.dim("recursively fetch an orchestration + every member agent")}`);
+  out.push(`  ${import_picocolors86.default.cyan("orchestration pull")} ${import_picocolors86.default.dim("<id>")}        ${import_picocolors86.default.dim("recursively fetch an orchestration + every member agent (--force to discard local concurrency edits)")}`);
   out.push(`  ${import_picocolors86.default.cyan("orchestration push")}             ${import_picocolors86.default.dim("recursively push each member, then update the graph")}`);
   out.push(`  ${import_picocolors86.default.cyan("orchestration status")}           ${import_picocolors86.default.dim("show what would push and what would pull")}`);
   out.push(`  ${import_picocolors86.default.cyan("orchestration delete")} ${import_picocolors86.default.dim("<id>")}      ${import_picocolors86.default.dim("permanently delete an orchestration graph (member agents are kept)")}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brainbase-labs/cli",
-  "version": "0.59.0",
+  "version": "0.60.0",
   "description": "Pack, share, and install agent templates across harnesses (Claude Code, Codex, ...).",
   "type": "module",
   "bin": {