@ricsam/r5dctl 0.0.121 → 0.0.123

package/README.md

@@ -59,6 +59,8 @@ r5dctl -p <project> create branch <branch> --source worktree:<branch> [--working
 r5dctl -p <project> describe branch-operation <operation-id>
 r5dctl -p <project> delete branch <branch> [<branch>...]            # preview the sessions that would be deleted, exit 1
 r5dctl -p <project> delete branch <branch> [<branch>...] --confirm  # delete the branches and their sessions through the platform
+r5dctl -p <project> delete branch <branch> --confirm --no-wait      # accept the deletion and print its branch id instead of waiting
+r5dctl -p <project> describe branch-deletion <branch-id>            # pending, failed, or completed
 r5dctl -p <project> get envs
 r5dctl -p <project> get envs --show-values
 r5dctl -p <project> get env API_KEY
@@ -127,7 +129,7 @@ pull requests.
 
 `create branch` creates a linked worktree branch through the platform from an existing branch's checkout, with the same `--source worktree:<branch>` and `--working-tree carry|clean` semantics as `session start --new-worktree` (carry is the default) and no session prompt. `--worker <label>` selects the connected worker that cuts the checkout; omitted, the platform chooses one, and an r5d worker shell's temporary credential is always bound to its own worker. The command returns as soon as the operation is accepted and prints its id; `describe branch-operation <operation-id>` reports `provisioning`, `ready`, or `failed` with the worker and any error. Neither prints a commit hash: read the branch with git in its checkout once it is ready.
 
-`delete branch` removes one or more branches and every session on them through the platform, which is the only supported way to remove a linked worktree: the platform owns those checkouts, so never run `git worktree remove`, `git worktree prune`, or `git branch -D` inside a project checkout. Without `--confirm` it prints each branch and its sessions and exits non-zero without deleting anything. With `--confirm` the branches are deleted one after another, each prints its own result line, a failure does not stop the remaining deletions, and the exit status is non-zero if any branch failed. The primary branch `main` is refused before anything is deleted, as is a branch with a running agent or active process (stop them first). A worker that is still applying a configuration refresh makes a deletion wait on the server for up to 45 seconds; if the refresh is still running after that, the result line says so and the branch can be retried. On a server that predates the route, the command explains that the server does not support `delete branch` yet instead of reporting a missing branch.
+`delete branch` removes one or more branches and every session on them through the platform, which is the only supported way to remove a linked worktree: the platform owns those checkouts, so never run `git worktree remove`, `git worktree prune`, or `git branch -D` inside a project checkout. Without `--confirm` it prints each branch and its sessions and exits non-zero without deleting anything. With `--confirm` each branch is resolved to the exact managed branch it names today, its deletion is accepted at once by the platform, and the command waits (polling every 2 seconds, up to 10 minutes) until the platform reports it completed before requesting the next one; a failure does not stop the remaining deletions, and the exit status is non-zero if any branch failed. `--no-wait` prints the accepted branch id instead of waiting; `describe branch-deletion <branch-id>` reports `pending` (with the retry reason when the worker has not answered yet), `failed` with the platform's error, or `completed`, and answers `completed` for a branch id that no longer exists. The deletion stays bound to that branch id: a same-name branch created afterwards is never deleted by an old request, and re-running the command for a branch whose deletion failed retries it. The primary branch `main` is refused before anything is deleted, as is a branch with a running agent or active process (stop them first); a name that only has sessions and no managed branch is refused too (delete those sessions with `delete session`). On a server that predates the route, the command explains that the server does not support `delete branch` yet instead of reporting a missing branch.
 
 `get branches` lists every branch the project knows about, including managed branches without sessions. A worker whose workspace sync found a configured branch's checkout directory missing, or present but not a linked worktree of the project, skips that branch and reports it; the listing then shows `checkout=missing on <worker>` or `checkout=not_a_worktree on <worker>`, and `workspace status` prints a `Missing checkouts on <worker>` line. Recover either by deleting the branch with `delete branch <branch> --confirm` or by reconnecting that worker, which recreates the checkout without snapshotting the project's other checkouts.
 
@@ -153,7 +155,9 @@ Add `-f`/`--follow`/`--watch` to `session start` to poll the provisioning handle
 
 `shell` connects to the same live worker PTY as the web Shell tab. Without `-c` it attaches the local terminal interactively. With `-c`/`--command`, it runs the supplied shell expression, streams combined PTY output, and exits with the remote command's status. Because command output uses a PTY, stdout and stderr are combined and programs may emit colors or other terminal control sequences.
 
-`ps list` shows active long-running commands managed by r5d. It does not expose the worker host's general OS process table or interactive PTYs. Global project, branch, and session options filter the list, while `--worker` selects a worker label. `ps stop` sends `SIGTERM` to the selected run. Inside an r5d-provided worker shell, the temporary credential can only list and stop runs on that shell's worker.
+`ps list` shows active long-running commands managed by r5d. It does not expose the worker host's general OS process table or interactive PTYs. Global project, branch, and session options filter the list, while `--worker` selects a worker label. The `LANE` column names the worker command lane each run holds (`general`, `utility`, or `control`) or waits for (`queued:general`), from the worker's latest capacity report; `-` means the worker did not report the run. `ps stop` sends `SIGTERM` to the selected run. Inside an r5d-provided worker shell, the temporary credential can only list and stop runs on that shell's worker.
+
+A managed worker runs two general shells at a time; a third waits up to 60 seconds and then fails with "command capacity is busy". Coordination does not compete for those slots: when an agent shell runs one plain `r5dctl` coordination command (`ps list`, `ps stop`, `workspace status`, `session status|stop|prompt|claim|claims|process-log`, `describe …`, `get …`, `sessions recent`, the `conversation` read forms, `create|update|delete session`, `answer-questions`, `answer-env-request`) with plain or simply quoted arguments, the platform runs it in a reserved control lane: two small slots, no shell, a 120-second limit. Shell operators, pipes, redirections, `$` expansions, environment assignments, wrappers, paths to r5dctl, `--`, `--follow`, and credential or endpoint flags make it an ordinary shell command again. `workspace status` prints each worker's lane totals, holders, and queue.
 
 `k8s usage` shows current and rolling CPU and memory usage for every workload container in your managed vCluster. The default window is `24h`; pass `--window 7d` for seven days. Filter with `--namespace`, `--workload`, or `--container`; a workload may be identified by name, `namespace/name`, or Kubernetes UID. Human-readable output shows current totals across sampled replicas and the selected window's maximum. Global `--json` includes min/max summaries, the complete five-minute history envelope, per-pod series, coverage, and freshness metadata.
 

package/dist/cjs/cli.cjs

@@ -28,6 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var cli_exports = {};
 __export(cli_exports, {
+  BRANCH_DELETION_POLL_INTERVAL_MS: () => BRANCH_DELETION_POLL_INTERVAL_MS,
+  BRANCH_DELETION_WAIT_TIMEOUT_MS: () => BRANCH_DELETION_WAIT_TIMEOUT_MS,
   advanceTransientDevicePollBackoff: () => advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage: () => branchDeletionConfirmationMessage,
   branchDeletionsConfirmationMessage: () => branchDeletionsConfirmationMessage,
@@ -41,6 +43,7 @@ __export(cli_exports, {
   formatK8sCpu: () => formatK8sCpu,
   formatK8sMemory: () => formatK8sMemory,
   formatProcessAge: () => formatProcessAge,
+  formatProcessLane: () => formatProcessLane,
   getCliHelpText: () => getCliHelpText,
   getK8sUsageState: () => getK8sUsageState,
   getProjectEnvValue: () => getProjectEnvValue,
@@ -77,6 +80,7 @@ __export(cli_exports, {
   renderBranchDeletion: () => renderBranchDeletion,
   renderBranchDeletionPreview: () => renderBranchDeletionPreview,
   renderBranchDeletionResult: () => renderBranchDeletionResult,
+  renderBranchDeletionStatus: () => renderBranchDeletionStatus,
   renderBranchList: () => renderBranchList,
   renderBranchOperation: () => renderBranchOperation,
   renderConversationForkResponse: () => renderConversationForkResponse,
@@ -97,11 +101,13 @@ __export(cli_exports, {
   renderSessionList: () => renderSessionList,
   renderSessionRunStart: () => renderSessionRunStart,
   renderSessionRunStatus: () => renderSessionRunStatus,
+  renderWorkerCapacity: () => renderWorkerCapacity,
   renderWorkspaceStatus: () => renderWorkspaceStatus,
   renderWorkspaceSync: () => renderWorkspaceSync,
   resolveCommandExecution: () => resolveCommandExecution,
   runR5dctlCli: () => runR5dctlCli,
   summarizeEnvData: () => summarizeEnvData,
+  waitForBranchDeletion: () => waitForBranchDeletion,
   waitForSessionProvisioning: () => waitForSessionProvisioning,
   writeConfig: () => writeConfig
 });
@@ -247,8 +253,13 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "branches",
-    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm]",
-    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted."
+    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm] [--no-wait]",
+    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted. Each deletion is accepted at once and awaited until the platform finishes it; --no-wait prints the accepted branch ids instead."
+  },
+  {
+    section: "branches",
+    usage: "-p <project> describe branch-deletion <branch-id>",
+    description: "Show whether an accepted branch deletion is pending, failed, or completed."
   },
   {
     section: "envs",
@@ -656,16 +667,21 @@ function parseBranchCreateArgs(args) {
 function parseBranchDeleteArgs(args) {
   const branchNames = [];
   let confirmed = false;
+  let noWait = false;
   for (const arg of args) {
     if (arg === "--confirm") {
       confirmed = true;
       continue;
     }
+    if (arg === "--no-wait") {
+      noWait = true;
+      continue;
+    }
     if (arg.startsWith("-")) throw new Error(`Unknown delete branch flag: ${arg}`);
     if (branchNames.includes(arg)) throw new Error(`Branch ${arg} was given more than once`);
     branchNames.push(arg);
   }
-  return { branchNames, confirmed };
+  return { branchNames, confirmed, noWait };
 }
 const PRIMARY_BRANCH_NAME = "main";
 function isUnsupportedServerRoute(error) {
@@ -693,12 +709,66 @@ async function createBranchThroughPlatform(client, projectRef, input) {
     })
   );
 }
+const BRANCH_DELETION_POLL_INTERVAL_MS = 2e3;
+const BRANCH_DELETION_WAIT_TIMEOUT_MS = 10 * 60 * 1e3;
+async function waitForBranchDeletion(client, projectRef, branchId, options = {}) {
+  const pollIntervalMs = options.pollIntervalMs ?? BRANCH_DELETION_POLL_INTERVAL_MS;
+  const timeoutMs = options.timeoutMs ?? BRANCH_DELETION_WAIT_TIMEOUT_MS;
+  const wait = options.sleep ?? ((ms) => (0, import_promises.setTimeout)(ms));
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const status = await client.projects.branches.describeDeletion(projectRef, branchId);
+    if (status.status === "completed") return;
+    if (status.status === "failed") throw new Error(status.error ?? "Branch deletion failed");
+    if (Date.now() >= deadline) {
+      throw new Error(
+        `Branch deletion ${branchId} is still pending after ${Math.round(timeoutMs / 1e3)}s${status.retryReason ? ` (${status.retryReason})` : ""}; it continues on the platform, re-run to keep waiting`
+      );
+    }
+    await wait(pollIntervalMs);
+  }
+}
+async function resolveUncertainAcceptance(client, projectRef, branchId, error) {
+  if (error.status !== 503) return null;
+  try {
+    const status = await client.projects.branches.describeDeletion(projectRef, branchId);
+    return { status: status.status };
+  } catch {
+    return null;
+  }
+}
 async function deleteBranchThroughPlatform(client, projectRef, branchName, options) {
   if (branchName === PRIMARY_BRANCH_NAME) throw new Error(`The primary branch ${branchName} cannot be deleted`);
   const branch = await client.projects.branches.describe(projectRef, branchName);
   if (!options.confirmed) return { kind: "preview", branch };
-  const result = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName));
-  return { kind: "deleted", result };
+  if (!branch.branchId) {
+    throw new Error(
+      `Branch ${branchName} has no managed checkout, only ${branch.sessions.length} session(s); delete those with \`delete session <id>\``
+    );
+  }
+  const branchId = branch.branchId;
+  let accepted;
+  try {
+    accepted = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName, { branchId }));
+  } catch (error) {
+    const landed = error instanceof import_r5d_api.R5dctlApiError ? await resolveUncertainAcceptance(client, projectRef, branchId, error) : null;
+    if (!landed) throw error;
+    const sessionIds = branch.sessions.map((session) => session.id);
+    accepted = landed.status === "completed" ? { status: "completed", branchId, branchName, sessionIds } : { status: "pending", branchId, branchName, workerLabel: "", sessionIds };
+  }
+  if (accepted.status === "completed" && accepted.sessionIds.length > 0) {
+    return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: accepted.sessionIds } };
+  }
+  if (accepted.status === "completed") return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: [] } };
+  if (options.noWait) {
+    return { kind: "accepted", result: { branchName, branchId, sessionIds: accepted.sessionIds, workerLabel: accepted.workerLabel } };
+  }
+  await waitForBranchDeletion(client, projectRef, branchId, {
+    ...options.pollIntervalMs !== void 0 ? { pollIntervalMs: options.pollIntervalMs } : {},
+    ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+    ...options.sleep ? { sleep: options.sleep } : {}
+  });
+  return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: accepted.sessionIds } };
 }
 async function deleteBranchesThroughPlatform(client, projectRef, branchNames, options) {
   if (branchNames.length === 0) throw new Error("Missing branch name");
@@ -716,9 +786,15 @@ async function deleteBranchesThroughPlatform(client, projectRef, branchNames, op
   for (const branchName of branchNames) {
     let result;
     try {
-      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, { confirmed: true });
-      if (deletion.kind !== "deleted") throw new Error(`Branch ${branchName} was only previewed`);
-      result = { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds };
+      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, {
+        confirmed: true,
+        ...options.noWait !== void 0 ? { noWait: options.noWait } : {},
+        ...options.pollIntervalMs !== void 0 ? { pollIntervalMs: options.pollIntervalMs } : {},
+        ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+        ...options.sleep ? { sleep: options.sleep } : {}
+      });
+      if (deletion.kind === "preview") throw new Error(`Branch ${branchName} was only previewed`);
+      result = deletion.kind === "deleted" ? { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds } : { branchName, deleted: false, accepted: true, branchId: deletion.result.branchId, sessionIds: deletion.result.sessionIds };
     } catch (error) {
       result = {
         branchName,
@@ -732,7 +808,21 @@ async function deleteBranchesThroughPlatform(client, projectRef, branchNames, op
   return { kind: "deleted", results };
 }
 function renderBranchDeletionResult(result) {
-  return result.deleted ? renderBranchDeletion(result) : `Failed to delete branch ${result.branchName}: ${result.error}
+  if (result.deleted) return renderBranchDeletion(result);
+  if (result.accepted) {
+    return `Accepted deletion of branch ${result.branchName} (${result.sessionIds.length} session(s)); it continues on the platform. Check with \`describe branch-deletion ${result.branchId}\`.
+`;
+  }
+  return `Failed to delete branch ${result.branchName}: ${result.error}
+`;
+}
+function renderBranchDeletionStatus(status) {
+  const lines = [`Branch: ${status.branchName ?? "(deleted)"}`, `Branch id: ${status.branchId}`, `Status: ${status.status}`];
+  if (status.workerLabel) lines.push(`Worker: ${status.workerLabel}`);
+  if (status.attempts !== void 0) lines.push(`Attempts: ${status.attempts}`);
+  if (status.retryReason) lines.push(`Retrying: ${status.retryReason}`);
+  if (status.error) lines.push(`Error: ${status.error}`);
+  return `${lines.join("\n")}
 `;
 }
 function branchDeletionsConfirmationMessage(branches) {
@@ -742,7 +832,7 @@ function branchDeletionsConfirmationMessage(branches) {
   return `Nothing was deleted. Re-run with --confirm to delete ${branches.length} branches and their ${sessionCount} session(s).`;
 }
 function branchDeletionsFailureMessage(results) {
-  return `Failed to delete ${results.filter((result) => !result.deleted).length} of ${results.length} branch(es).`;
+  return `Failed to delete ${results.filter((result) => !result.deleted && !result.accepted).length} of ${results.length} branch(es).`;
 }
 function renderBranchDeletionPreview(branch) {
   const count = branch.sessions.length;
@@ -1802,6 +1892,23 @@ function renderRecentSessionList(sessions) {
   return `${sessions.map((session) => `${session.id}  ${session.projectPath}/${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
 `;
 }
+function renderWorkerCapacity(workerLabel, capacity) {
+  if (!capacity) return [`Command capacity on ${workerLabel}: not reported yet`];
+  if (!capacity.bounded) return [`Command capacity on ${workerLabel}: unbounded (no managed launcher)`];
+  const describeLane = (lane) => {
+    const report = capacity.lanes[lane];
+    const slots = report.slots === null ? "?" : String(report.slots);
+    const holders = report.active.map((entry) => `${entry.id}${entry.sessionId ? ` (session ${entry.sessionId})` : ""}`);
+    const queued = report.queued.map((entry) => `${entry.id}${entry.sessionId ? ` (session ${entry.sessionId})` : ""}`);
+    return `  ${lane}: ${report.active.length}/${slots} busy${holders.length ? `, held by ${holders.join(", ")}` : ""}${queued.length ? `; queued: ${queued.join(", ")}` : ""}`;
+  };
+  return [
+    `Command capacity on ${workerLabel} (reported ${capacity.reportedAt}):`,
+    describeLane("general"),
+    describeLane("utility"),
+    `${describeLane("control")}${capacity.controlRuntimeMs !== null ? ` (plain r5dctl coordination, ${Math.round(capacity.controlRuntimeMs / 1e3)}s limit)` : ""}`
+  ];
+}
 function renderWorkspaceStatus(status) {
   const lines = [
     `Workspace HEAD: ${status.head ?? "(not initialized)"}`,
@@ -1809,7 +1916,8 @@ function renderWorkspaceStatus(status) {
     `Remediation: ${status.incident ? `${status.incident.kind} ${status.incident.status} (${status.incident.id}) on ${status.incident.originWorkerLabel}` : "none"}`,
     ...status.workers.flatMap((worker) => [
       `Worker ${worker.workerLabel}: ${worker.configured ? "configured" : "configuring"}; head ${worker.localHead ?? "(none)"}; pending checkouts ${worker.pendingCheckouts.length}`,
-      ...renderMissingCheckouts(worker.workerLabel, worker.missingCheckouts ?? [])
+      ...renderMissingCheckouts(worker.workerLabel, worker.missingCheckouts ?? []),
+      ...renderWorkerCapacity(worker.workerLabel, worker.capacity)
     ])
   ];
   if (status.latestSync?.missingCheckouts?.length && !status.workers.some((worker) => worker.missingCheckouts?.length)) {
@@ -1830,7 +1938,8 @@ function renderBranchList(branches) {
   if (branches.length === 0) return "No branches found.\n";
   const lines = branches.map((branch) => {
     const checkout = branch.checkoutState ? `  checkout=${branch.checkoutState}${branch.checkoutStateWorkerLabel ? ` on ${branch.checkoutStateWorkerLabel}` : ""}` : "";
-    return `${branch.branchName}  sessions=${branch.sessionCount}${checkout}`;
+    const deletion = branch.deletion ? `  deletion=${branch.deletion.status}${branch.deletion.error ? ` (${branch.deletion.error})` : ""}` : "";
+    return `${branch.branchName}  sessions=${branch.sessionCount}${checkout}${deletion}`;
   });
   if (branches.some((branch) => branch.checkoutState)) {
     lines.push(`Workspace sync skips a branch whose checkout is missing or not a worktree; ${CHECKOUT_RECOVERY_HINT}.`);
@@ -2042,10 +2151,11 @@ function renderProcessList(processes, nowMs = Date.now()) {
   if (processes.length === 0) {
     return "No active processes.\n";
   }
-  const headers = ["RUN ID", "STATUS", "AGE", "WORKER", "TARGET", "SCOPE", "SESSION", "COMMAND"];
+  const headers = ["RUN ID", "STATUS", "LANE", "AGE", "WORKER", "TARGET", "SCOPE", "SESSION", "COMMAND"];
   const rows = processes.map((process2) => [
     process2.runId,
     process2.status,
+    formatProcessLane(process2),
     formatProcessAge(process2.startedAt, nowMs),
     process2.workerLabel,
     process2.projectPath,
@@ -2059,6 +2169,10 @@ function renderProcessList(processes, nowMs = Date.now()) {
   return `${[formatRow(headers), separator, ...rows.map(formatRow)].join("\n")}
 `;
 }
+function formatProcessLane(process2) {
+  if (process2.admission) return process2.admission.phase === "queued" ? `queued:${process2.admission.lane}` : process2.admission.lane;
+  return process2.commandClass ?? "-";
+}
 function renderProcessHistory(processes, nowMs = Date.now()) {
   return processes.length === 0 ? "No process history.\n" : renderProcessList(processes, nowMs);
 }
@@ -2096,6 +2210,7 @@ function renderProcessInspection(process2) {
     `Worker: ${process2.workerLabel} (${process2.platform ?? "unknown"}/${process2.arch ?? "unknown"})`,
     `Target: ${process2.projectPath} ${process2.target.type === "project" ? process2.target.branchName : process2.target.rootProfile}`,
     `Session: ${process2.sessionId}`,
+    `Lane: ${formatProcessLane(process2)}${process2.admission ? ` since ${process2.admission.since}` : ""}`,
     `Command: ${process2.command}`,
     `Argv: ${JSON.stringify(process2.argv)}`,
     `CWD: ${process2.cwd ?? "(execution root)"}`,
@@ -3091,10 +3206,15 @@ async function executeR5dctlCommand(client, json, args) {
       requireValue(args[offset], "Missing project reference"),
       requireValue(args[offset + 1], "Missing branch name")
     );
-    write(result, `Project: ${result.project.path}
+    write(
+      result,
+      `Project: ${result.project.path}
 Branch: ${result.branchName}
-Sessions: ${result.sessions.length}
-`);
+Branch id: ${result.branchId ?? "(no managed branch)"}
+${result.deletion ? `Deletion: ${result.deletion.status}${result.deletion.error ? ` (${result.deletion.error})` : ""}
+` : ""}Sessions: ${result.sessions.length}
+`
+    );
     return;
   }
   if (first === "projects" && second === "branches" && third === "create" || first === "create" && second === "branch") {
@@ -3122,9 +3242,10 @@ Sessions: ${result.sessions.length}
   if (first === "projects" && second === "branches" && third === "delete" || first === "delete" && second === "branch") {
     const offset = first === "delete" ? 2 : 3;
     const projectRef = requireValue(args[offset], "Missing project reference");
-    const { branchNames, confirmed } = parseBranchDeleteArgs(args.slice(offset + 1));
+    const { branchNames, confirmed, noWait } = parseBranchDeleteArgs(args.slice(offset + 1));
     const deletion = await deleteBranchesThroughPlatform(client, projectRef, branchNames, {
       confirmed,
+      noWait,
       // Each deletion is its own round trip, so a reader sees results as they land.
       onResult: (result) => {
         if (!json) process.stdout.write(renderBranchDeletionResult(result));
@@ -3135,7 +3256,15 @@ Sessions: ${result.sessions.length}
       throw new Error(branchDeletionsConfirmationMessage(deletion.branches));
     }
     if (json) write({ results: deletion.results }, "");
-    if (deletion.results.some((result) => !result.deleted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
+    if (deletion.results.some((result) => !result.deleted && !result.accepted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
+    return;
+  }
+  if (first === "projects" && second === "branches" && third === "describe-deletion" || first === "describe" && second === "branch-deletion") {
+    const offset = first === "describe" ? 2 : 3;
+    const projectRef = requireValue(args[offset], "Missing project reference");
+    const branchId = requireValue(args[offset + 1], "Missing branch id");
+    const status = await requireServerRouteSupport("describe branch-deletion", () => client.projects.branches.describeDeletion(projectRef, branchId));
+    write(status, renderBranchDeletionStatus(status));
     return;
   }
   if (first === "get" && second === "envs") {
@@ -3928,6 +4057,8 @@ async function main(argv = process.argv.slice(2)) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BRANCH_DELETION_POLL_INTERVAL_MS,
+  BRANCH_DELETION_WAIT_TIMEOUT_MS,
   advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage,
   branchDeletionsConfirmationMessage,
@@ -3941,6 +4072,7 @@ async function main(argv = process.argv.slice(2)) {
   formatK8sCpu,
   formatK8sMemory,
   formatProcessAge,
+  formatProcessLane,
   getCliHelpText,
   getK8sUsageState,
   getProjectEnvValue,
@@ -3977,6 +4109,7 @@ async function main(argv = process.argv.slice(2)) {
   renderBranchDeletion,
   renderBranchDeletionPreview,
   renderBranchDeletionResult,
+  renderBranchDeletionStatus,
   renderBranchList,
   renderBranchOperation,
   renderConversationForkResponse,
@@ -3997,11 +4130,13 @@ async function main(argv = process.argv.slice(2)) {
   renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
+  renderWorkerCapacity,
   renderWorkspaceStatus,
   renderWorkspaceSync,
   resolveCommandExecution,
   runR5dctlCli,
   summarizeEnvData,
+  waitForBranchDeletion,
   waitForSessionProvisioning,
   writeConfig
 });

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.121",
+  "version": "0.0.123",
   "type": "commonjs"
 }

package/dist/mjs/cli.mjs

@@ -142,8 +142,13 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "branches",
-    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm]",
-    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted."
+    usage: "-p <project> delete branch <branch> [<branch>...] [--confirm] [--no-wait]",
+    description: "Delete one or more branches and their sessions through the platform; without --confirm, only preview what would be deleted. Each deletion is accepted at once and awaited until the platform finishes it; --no-wait prints the accepted branch ids instead."
+  },
+  {
+    section: "branches",
+    usage: "-p <project> describe branch-deletion <branch-id>",
+    description: "Show whether an accepted branch deletion is pending, failed, or completed."
   },
   {
     section: "envs",
@@ -551,16 +556,21 @@ function parseBranchCreateArgs(args) {
 function parseBranchDeleteArgs(args) {
   const branchNames = [];
   let confirmed = false;
+  let noWait = false;
   for (const arg of args) {
     if (arg === "--confirm") {
       confirmed = true;
       continue;
     }
+    if (arg === "--no-wait") {
+      noWait = true;
+      continue;
+    }
     if (arg.startsWith("-")) throw new Error(`Unknown delete branch flag: ${arg}`);
     if (branchNames.includes(arg)) throw new Error(`Branch ${arg} was given more than once`);
     branchNames.push(arg);
   }
-  return { branchNames, confirmed };
+  return { branchNames, confirmed, noWait };
 }
 const PRIMARY_BRANCH_NAME = "main";
 function isUnsupportedServerRoute(error) {
@@ -588,12 +598,66 @@ async function createBranchThroughPlatform(client, projectRef, input) {
     })
   );
 }
+const BRANCH_DELETION_POLL_INTERVAL_MS = 2e3;
+const BRANCH_DELETION_WAIT_TIMEOUT_MS = 10 * 60 * 1e3;
+async function waitForBranchDeletion(client, projectRef, branchId, options = {}) {
+  const pollIntervalMs = options.pollIntervalMs ?? BRANCH_DELETION_POLL_INTERVAL_MS;
+  const timeoutMs = options.timeoutMs ?? BRANCH_DELETION_WAIT_TIMEOUT_MS;
+  const wait = options.sleep ?? ((ms) => sleep(ms));
+  const deadline = Date.now() + timeoutMs;
+  for (; ; ) {
+    const status = await client.projects.branches.describeDeletion(projectRef, branchId);
+    if (status.status === "completed") return;
+    if (status.status === "failed") throw new Error(status.error ?? "Branch deletion failed");
+    if (Date.now() >= deadline) {
+      throw new Error(
+        `Branch deletion ${branchId} is still pending after ${Math.round(timeoutMs / 1e3)}s${status.retryReason ? ` (${status.retryReason})` : ""}; it continues on the platform, re-run to keep waiting`
+      );
+    }
+    await wait(pollIntervalMs);
+  }
+}
+async function resolveUncertainAcceptance(client, projectRef, branchId, error) {
+  if (error.status !== 503) return null;
+  try {
+    const status = await client.projects.branches.describeDeletion(projectRef, branchId);
+    return { status: status.status };
+  } catch {
+    return null;
+  }
+}
 async function deleteBranchThroughPlatform(client, projectRef, branchName, options) {
   if (branchName === PRIMARY_BRANCH_NAME) throw new Error(`The primary branch ${branchName} cannot be deleted`);
   const branch = await client.projects.branches.describe(projectRef, branchName);
   if (!options.confirmed) return { kind: "preview", branch };
-  const result = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName));
-  return { kind: "deleted", result };
+  if (!branch.branchId) {
+    throw new Error(
+      `Branch ${branchName} has no managed checkout, only ${branch.sessions.length} session(s); delete those with \`delete session <id>\``
+    );
+  }
+  const branchId = branch.branchId;
+  let accepted;
+  try {
+    accepted = await requireServerRouteSupport("delete branch", () => client.projects.branches.delete(projectRef, branchName, { branchId }));
+  } catch (error) {
+    const landed = error instanceof R5dctlApiError ? await resolveUncertainAcceptance(client, projectRef, branchId, error) : null;
+    if (!landed) throw error;
+    const sessionIds = branch.sessions.map((session) => session.id);
+    accepted = landed.status === "completed" ? { status: "completed", branchId, branchName, sessionIds } : { status: "pending", branchId, branchName, workerLabel: "", sessionIds };
+  }
+  if (accepted.status === "completed" && accepted.sessionIds.length > 0) {
+    return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: accepted.sessionIds } };
+  }
+  if (accepted.status === "completed") return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: [] } };
+  if (options.noWait) {
+    return { kind: "accepted", result: { branchName, branchId, sessionIds: accepted.sessionIds, workerLabel: accepted.workerLabel } };
+  }
+  await waitForBranchDeletion(client, projectRef, branchId, {
+    ...options.pollIntervalMs !== void 0 ? { pollIntervalMs: options.pollIntervalMs } : {},
+    ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+    ...options.sleep ? { sleep: options.sleep } : {}
+  });
+  return { kind: "deleted", result: { branchName, branchId, deletedSessionIds: accepted.sessionIds } };
 }
 async function deleteBranchesThroughPlatform(client, projectRef, branchNames, options) {
   if (branchNames.length === 0) throw new Error("Missing branch name");
@@ -611,9 +675,15 @@ async function deleteBranchesThroughPlatform(client, projectRef, branchNames, op
   for (const branchName of branchNames) {
     let result;
     try {
-      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, { confirmed: true });
-      if (deletion.kind !== "deleted") throw new Error(`Branch ${branchName} was only previewed`);
-      result = { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds };
+      const deletion = await deleteBranchThroughPlatform(client, projectRef, branchName, {
+        confirmed: true,
+        ...options.noWait !== void 0 ? { noWait: options.noWait } : {},
+        ...options.pollIntervalMs !== void 0 ? { pollIntervalMs: options.pollIntervalMs } : {},
+        ...options.timeoutMs !== void 0 ? { timeoutMs: options.timeoutMs } : {},
+        ...options.sleep ? { sleep: options.sleep } : {}
+      });
+      if (deletion.kind === "preview") throw new Error(`Branch ${branchName} was only previewed`);
+      result = deletion.kind === "deleted" ? { branchName, deleted: true, deletedSessionIds: deletion.result.deletedSessionIds } : { branchName, deleted: false, accepted: true, branchId: deletion.result.branchId, sessionIds: deletion.result.sessionIds };
     } catch (error) {
       result = {
         branchName,
@@ -627,7 +697,21 @@ async function deleteBranchesThroughPlatform(client, projectRef, branchNames, op
   return { kind: "deleted", results };
 }
 function renderBranchDeletionResult(result) {
-  return result.deleted ? renderBranchDeletion(result) : `Failed to delete branch ${result.branchName}: ${result.error}
+  if (result.deleted) return renderBranchDeletion(result);
+  if (result.accepted) {
+    return `Accepted deletion of branch ${result.branchName} (${result.sessionIds.length} session(s)); it continues on the platform. Check with \`describe branch-deletion ${result.branchId}\`.
+`;
+  }
+  return `Failed to delete branch ${result.branchName}: ${result.error}
+`;
+}
+function renderBranchDeletionStatus(status) {
+  const lines = [`Branch: ${status.branchName ?? "(deleted)"}`, `Branch id: ${status.branchId}`, `Status: ${status.status}`];
+  if (status.workerLabel) lines.push(`Worker: ${status.workerLabel}`);
+  if (status.attempts !== void 0) lines.push(`Attempts: ${status.attempts}`);
+  if (status.retryReason) lines.push(`Retrying: ${status.retryReason}`);
+  if (status.error) lines.push(`Error: ${status.error}`);
+  return `${lines.join("\n")}
 `;
 }
 function branchDeletionsConfirmationMessage(branches) {
@@ -637,7 +721,7 @@ function branchDeletionsConfirmationMessage(branches) {
   return `Nothing was deleted. Re-run with --confirm to delete ${branches.length} branches and their ${sessionCount} session(s).`;
 }
 function branchDeletionsFailureMessage(results) {
-  return `Failed to delete ${results.filter((result) => !result.deleted).length} of ${results.length} branch(es).`;
+  return `Failed to delete ${results.filter((result) => !result.deleted && !result.accepted).length} of ${results.length} branch(es).`;
 }
 function renderBranchDeletionPreview(branch) {
   const count = branch.sessions.length;
@@ -1697,6 +1781,23 @@ function renderRecentSessionList(sessions) {
   return `${sessions.map((session) => `${session.id}  ${session.projectPath}/${session.branchName}  ${session.name ?? "(unnamed)"}`).join("\n")}
 `;
 }
+function renderWorkerCapacity(workerLabel, capacity) {
+  if (!capacity) return [`Command capacity on ${workerLabel}: not reported yet`];
+  if (!capacity.bounded) return [`Command capacity on ${workerLabel}: unbounded (no managed launcher)`];
+  const describeLane = (lane) => {
+    const report = capacity.lanes[lane];
+    const slots = report.slots === null ? "?" : String(report.slots);
+    const holders = report.active.map((entry) => `${entry.id}${entry.sessionId ? ` (session ${entry.sessionId})` : ""}`);
+    const queued = report.queued.map((entry) => `${entry.id}${entry.sessionId ? ` (session ${entry.sessionId})` : ""}`);
+    return `  ${lane}: ${report.active.length}/${slots} busy${holders.length ? `, held by ${holders.join(", ")}` : ""}${queued.length ? `; queued: ${queued.join(", ")}` : ""}`;
+  };
+  return [
+    `Command capacity on ${workerLabel} (reported ${capacity.reportedAt}):`,
+    describeLane("general"),
+    describeLane("utility"),
+    `${describeLane("control")}${capacity.controlRuntimeMs !== null ? ` (plain r5dctl coordination, ${Math.round(capacity.controlRuntimeMs / 1e3)}s limit)` : ""}`
+  ];
+}
 function renderWorkspaceStatus(status) {
   const lines = [
     `Workspace HEAD: ${status.head ?? "(not initialized)"}`,
@@ -1704,7 +1805,8 @@ function renderWorkspaceStatus(status) {
     `Remediation: ${status.incident ? `${status.incident.kind} ${status.incident.status} (${status.incident.id}) on ${status.incident.originWorkerLabel}` : "none"}`,
     ...status.workers.flatMap((worker) => [
       `Worker ${worker.workerLabel}: ${worker.configured ? "configured" : "configuring"}; head ${worker.localHead ?? "(none)"}; pending checkouts ${worker.pendingCheckouts.length}`,
-      ...renderMissingCheckouts(worker.workerLabel, worker.missingCheckouts ?? [])
+      ...renderMissingCheckouts(worker.workerLabel, worker.missingCheckouts ?? []),
+      ...renderWorkerCapacity(worker.workerLabel, worker.capacity)
     ])
   ];
   if (status.latestSync?.missingCheckouts?.length && !status.workers.some((worker) => worker.missingCheckouts?.length)) {
@@ -1725,7 +1827,8 @@ function renderBranchList(branches) {
   if (branches.length === 0) return "No branches found.\n";
   const lines = branches.map((branch) => {
     const checkout = branch.checkoutState ? `  checkout=${branch.checkoutState}${branch.checkoutStateWorkerLabel ? ` on ${branch.checkoutStateWorkerLabel}` : ""}` : "";
-    return `${branch.branchName}  sessions=${branch.sessionCount}${checkout}`;
+    const deletion = branch.deletion ? `  deletion=${branch.deletion.status}${branch.deletion.error ? ` (${branch.deletion.error})` : ""}` : "";
+    return `${branch.branchName}  sessions=${branch.sessionCount}${checkout}${deletion}`;
   });
   if (branches.some((branch) => branch.checkoutState)) {
     lines.push(`Workspace sync skips a branch whose checkout is missing or not a worktree; ${CHECKOUT_RECOVERY_HINT}.`);
@@ -1937,10 +2040,11 @@ function renderProcessList(processes, nowMs = Date.now()) {
   if (processes.length === 0) {
     return "No active processes.\n";
   }
-  const headers = ["RUN ID", "STATUS", "AGE", "WORKER", "TARGET", "SCOPE", "SESSION", "COMMAND"];
+  const headers = ["RUN ID", "STATUS", "LANE", "AGE", "WORKER", "TARGET", "SCOPE", "SESSION", "COMMAND"];
   const rows = processes.map((process2) => [
     process2.runId,
     process2.status,
+    formatProcessLane(process2),
     formatProcessAge(process2.startedAt, nowMs),
     process2.workerLabel,
     process2.projectPath,
@@ -1954,6 +2058,10 @@ function renderProcessList(processes, nowMs = Date.now()) {
   return `${[formatRow(headers), separator, ...rows.map(formatRow)].join("\n")}
 `;
 }
+function formatProcessLane(process2) {
+  if (process2.admission) return process2.admission.phase === "queued" ? `queued:${process2.admission.lane}` : process2.admission.lane;
+  return process2.commandClass ?? "-";
+}
 function renderProcessHistory(processes, nowMs = Date.now()) {
   return processes.length === 0 ? "No process history.\n" : renderProcessList(processes, nowMs);
 }
@@ -1991,6 +2099,7 @@ function renderProcessInspection(process2) {
     `Worker: ${process2.workerLabel} (${process2.platform ?? "unknown"}/${process2.arch ?? "unknown"})`,
     `Target: ${process2.projectPath} ${process2.target.type === "project" ? process2.target.branchName : process2.target.rootProfile}`,
     `Session: ${process2.sessionId}`,
+    `Lane: ${formatProcessLane(process2)}${process2.admission ? ` since ${process2.admission.since}` : ""}`,
     `Command: ${process2.command}`,
     `Argv: ${JSON.stringify(process2.argv)}`,
     `CWD: ${process2.cwd ?? "(execution root)"}`,
@@ -2986,10 +3095,15 @@ async function executeR5dctlCommand(client, json, args) {
       requireValue(args[offset], "Missing project reference"),
       requireValue(args[offset + 1], "Missing branch name")
     );
-    write(result, `Project: ${result.project.path}
+    write(
+      result,
+      `Project: ${result.project.path}
 Branch: ${result.branchName}
-Sessions: ${result.sessions.length}
-`);
+Branch id: ${result.branchId ?? "(no managed branch)"}
+${result.deletion ? `Deletion: ${result.deletion.status}${result.deletion.error ? ` (${result.deletion.error})` : ""}
+` : ""}Sessions: ${result.sessions.length}
+`
+    );
     return;
   }
   if (first === "projects" && second === "branches" && third === "create" || first === "create" && second === "branch") {
@@ -3017,9 +3131,10 @@ Sessions: ${result.sessions.length}
   if (first === "projects" && second === "branches" && third === "delete" || first === "delete" && second === "branch") {
     const offset = first === "delete" ? 2 : 3;
     const projectRef = requireValue(args[offset], "Missing project reference");
-    const { branchNames, confirmed } = parseBranchDeleteArgs(args.slice(offset + 1));
+    const { branchNames, confirmed, noWait } = parseBranchDeleteArgs(args.slice(offset + 1));
     const deletion = await deleteBranchesThroughPlatform(client, projectRef, branchNames, {
       confirmed,
+      noWait,
       // Each deletion is its own round trip, so a reader sees results as they land.
       onResult: (result) => {
         if (!json) process.stdout.write(renderBranchDeletionResult(result));
@@ -3030,7 +3145,15 @@ Sessions: ${result.sessions.length}
       throw new Error(branchDeletionsConfirmationMessage(deletion.branches));
     }
     if (json) write({ results: deletion.results }, "");
-    if (deletion.results.some((result) => !result.deleted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
+    if (deletion.results.some((result) => !result.deleted && !result.accepted)) throw new Error(branchDeletionsFailureMessage(deletion.results));
+    return;
+  }
+  if (first === "projects" && second === "branches" && third === "describe-deletion" || first === "describe" && second === "branch-deletion") {
+    const offset = first === "describe" ? 2 : 3;
+    const projectRef = requireValue(args[offset], "Missing project reference");
+    const branchId = requireValue(args[offset + 1], "Missing branch id");
+    const status = await requireServerRouteSupport("describe branch-deletion", () => client.projects.branches.describeDeletion(projectRef, branchId));
+    write(status, renderBranchDeletionStatus(status));
     return;
   }
   if (first === "get" && second === "envs") {
@@ -3822,6 +3945,8 @@ async function main(argv = process.argv.slice(2)) {
   }
 }
 export {
+  BRANCH_DELETION_POLL_INTERVAL_MS,
+  BRANCH_DELETION_WAIT_TIMEOUT_MS,
   advanceTransientDevicePollBackoff,
   branchDeletionConfirmationMessage,
   branchDeletionsConfirmationMessage,
@@ -3835,6 +3960,7 @@ export {
   formatK8sCpu,
   formatK8sMemory,
   formatProcessAge,
+  formatProcessLane,
   getCliHelpText,
   getK8sUsageState,
   getProjectEnvValue,
@@ -3871,6 +3997,7 @@ export {
   renderBranchDeletion,
   renderBranchDeletionPreview,
   renderBranchDeletionResult,
+  renderBranchDeletionStatus,
   renderBranchList,
   renderBranchOperation,
   renderConversationForkResponse,
@@ -3891,11 +4018,13 @@ export {
   renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
+  renderWorkerCapacity,
   renderWorkspaceStatus,
   renderWorkspaceSync,
   resolveCommandExecution,
   runR5dctlCli,
   summarizeEnvData,
+  waitForBranchDeletion,
   waitForSessionProvisioning,
   writeConfig
 };

package/dist/mjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.121",
+  "version": "0.0.123",
   "type": "module"
 }

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { R5dctlApiError, R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessLog, type R5dctlProcessRun, type R5dctlBranch, type R5dctlBranchDeleteResponse, type R5dctlBranchDescription, type R5dctlBranchOperation, type R5dctlSessionSummary, type R5dctlSessionClaim, type R5dctlSessionClaimListResponse, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorkingTreeMode, type R5dctlWorktreeSource, type R5dctlPromptDelivery, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { R5dctlApiError, R5dctlClient, type R5dctlConversationForkResponse, type R5dctlConversationHeadResponse, type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlK8sResourceHistory, type R5dctlK8sUsage, type R5dctlK8sWorkload, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessLog, type R5dctlProcessRun, type R5dctlWorkerCapacityReport, type R5dctlBranch, type R5dctlBranchDeletionStatus, type R5dctlBranchDescription, type R5dctlBranchOperation, type R5dctlSessionSummary, type R5dctlSessionClaim, type R5dctlSessionClaimListResponse, type R5dctlSessionEvent, type R5dctlSessionStartInput, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type R5dctlWorkingTreeMode, type R5dctlWorktreeSource, type R5dctlPromptDelivery, type R5dctlSessionMode, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -90,6 +90,7 @@ export declare function parseBranchCreateArgs(args: string[]): R5dctlBranchCreat
 export declare function parseBranchDeleteArgs(args: string[]): {
     branchNames: string[];
     confirmed: boolean;
+    noWait: boolean;
 };
 /** An older server strips unknown routes and answers with this generic 404; a route's own not-found carries a specific message. */
 export declare function isUnsupportedServerRoute(error: unknown): error is R5dctlApiError;
@@ -101,10 +102,39 @@ export type R5dctlBranchDeletionOutcome = {
     branch: R5dctlBranchDescription;
 } | {
     kind: "deleted";
-    result: R5dctlBranchDeleteResponse;
+    result: {
+        branchName: string;
+        branchId: string;
+        deletedSessionIds: string[];
+    };
+} | {
+    kind: "accepted";
+    result: {
+        branchName: string;
+        branchId: string;
+        sessionIds: string[];
+        workerLabel: string;
+    };
 };
+/** The platform answers an accepted deletion at once; the checkout and chats disappear behind this poll. */
+export declare const BRANCH_DELETION_POLL_INTERVAL_MS = 2000;
+export declare const BRANCH_DELETION_WAIT_TIMEOUT_MS: number;
+/**
+ * Wait for one accepted deletion, keyed by its exact branch incarnation. A
+ * `completed` status is the terminal success; a `failed` status carries the
+ * platform's reason and is not retried here (re-run the command to retry).
+ */
+export declare function waitForBranchDeletion(client: R5dctlClient, projectRef: string, branchId: string, options?: {
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
+}): Promise<void>;
 export declare function deleteBranchThroughPlatform(client: R5dctlClient, projectRef: string, branchName: string, options: {
     confirmed: boolean;
+    noWait?: boolean;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
 }): Promise<R5dctlBranchDeletionOutcome>;
 export type R5dctlBranchDeletionResult = {
     branchName: string;
@@ -113,6 +143,13 @@ export type R5dctlBranchDeletionResult = {
 } | {
     branchName: string;
     deleted: false;
+    accepted: true;
+    branchId: string;
+    sessionIds: string[];
+} | {
+    branchName: string;
+    deleted: false;
+    accepted?: false;
     error: string;
 };
 export type R5dctlBranchDeletionsOutcome = {
@@ -126,18 +163,29 @@ export type R5dctlBranchDeletionsOutcome = {
  * Delete several branches one request at a time: the server route stays
  * one-branch-per-request. Every name is checked before the first request, a
  * preview describes each branch, and a confirmed run continues past a failed
- * branch so one refused deletion does not strand the rest of the list.
+ * branch so one refused deletion does not strand the rest of the list. Each
+ * accepted deletion is awaited before the next is requested, so the worker
+ * handles them in order and a failure is reported where it happened.
  */
 export declare function deleteBranchesThroughPlatform(client: R5dctlClient, projectRef: string, branchNames: readonly string[], options: {
     confirmed: boolean;
+    noWait?: boolean;
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    sleep?: (ms: number) => Promise<void>;
     onResult?: (result: R5dctlBranchDeletionResult) => void;
 }): Promise<R5dctlBranchDeletionsOutcome>;
 export declare function renderBranchDeletionResult(result: R5dctlBranchDeletionResult): string;
+/** Operation facts of one deletion, keyed by its branch incarnation. */
+export declare function renderBranchDeletionStatus(status: R5dctlBranchDeletionStatus): string;
 export declare function branchDeletionsConfirmationMessage(branches: readonly R5dctlBranchDescription[]): string;
 export declare function branchDeletionsFailureMessage(results: readonly R5dctlBranchDeletionResult[]): string;
 export declare function renderBranchDeletionPreview(branch: R5dctlBranchDescription): string;
 export declare function branchDeletionConfirmationMessage(branch: R5dctlBranchDescription): string;
-export declare function renderBranchDeletion(result: R5dctlBranchDeleteResponse): string;
+export declare function renderBranchDeletion(result: {
+    branchName: string;
+    deletedSessionIds: string[];
+}): string;
 /** Operation facts only: no commit hash, because a hash is stale as soon as the branch commits. */
 export declare function renderBranchOperation(operation: R5dctlBranchOperation, projectRef: string): string;
 export declare function parseSessionRunCommand(options: Pick<GlobalOptions, "project" | "branch" | "session">, args: string[], env?: Record<string, string | undefined>): R5dctlSessionRunCommand;
@@ -230,6 +278,8 @@ export declare function advanceTransientDevicePollBackoff(intervalMs: number, tr
 };
 export declare function handleAuthLogin(client: R5dctlClient, options: GlobalOptions, commandArgs: string[], config: R5dctlConfig): Promise<void>;
 export declare function renderSessionList(sessions: R5dctlSessionSummary[], nowMs?: number): string;
+/** One line per worker naming every lane's holders and queue, so an agent can see whom to ask to free capacity. */
+export declare function renderWorkerCapacity(workerLabel: string, capacity: R5dctlWorkerCapacityReport | null | undefined): string[];
 export declare function renderWorkspaceStatus(status: R5dctlWorkspaceStatus): string;
 export declare function renderBranchList(branches: R5dctlBranch[]): string;
 export declare function renderWorkspaceSync(result: R5dctlWorkspaceSyncResult): string;
@@ -270,6 +320,8 @@ export declare function getK8sUsageState(entry: K8sUsageReport["entries"][number
 export declare function renderK8sUsageReport(report: K8sUsageReport): string;
 export declare function formatProcessAge(startedAt: string, nowMs?: number): string;
 export declare function renderProcessList(processes: R5dctlProcessRun[], nowMs?: number): string;
+/** `general`, `control`, `queued:general`, or `-` when the worker reported nothing for this run. */
+export declare function formatProcessLane(process: Pick<R5dctlProcessRun, "admission" | "commandClass">): string;
 export declare function renderProcessHistory(processes: R5dctlProcessRun[], nowMs?: number): string;
 /** Streams go to stdout under `==> name <==` headers; the selection summary is returned separately for stderr. */
 export declare function renderProcessLog(log: R5dctlProcessLog): {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.121",
+  "version": "0.0.123",
   "type": "module",
   "main": "./dist/cjs/cli.cjs",
   "module": "./dist/mjs/cli.mjs",
@@ -26,7 +26,7 @@
     "r5dctl": "dist/cjs/main.cjs"
   },
   "dependencies": {
-    "@ricsam/r5d-api": "^0.0.121",
+    "@ricsam/r5d-api": "^0.0.123",
     "dotenv": "^17",
     "qrcode": "^1.5.4",
     "ws": "^8.18.3"