@ricsam/r5dctl 0.0.130 → 0.0.132

package/README.md

@@ -136,6 +136,7 @@ r5dctl session status <session-id>
 r5dctl session prompt --worker <label> --mode agent --model max --delivery steer <session-id> "Also check the migration"
 r5dctl session prompt --worker <label> --mode agent --model max --delivery force <session-id> "Stop that and fix the build first"
 r5dctl session stop <session-id>
+r5dctl session set-worker <session-id> --worker <label>
 r5dctl session process-log <run-id> --tail 200
 r5dctl session process-log <run-id> --grep "error|failed"
 
@@ -169,6 +170,8 @@ Delivery is not acknowledgment. If a merge or shared-checkout change depends on
 
 `session stop` also stops every sub-agent session the stopped session started, directly or through its own children, and `session status` prints `Child sessions: <active> active of <total>` for a session that launched sub-agents.
 
+`session set-worker` rebinds a stopped session to another connected worker, exactly like the composer's worker selector: it publishes the current worker's workspace, synchronizes the target worker, persists the binding, and the session resumes there on its next prompt or resume. It is refused with `409` while the session's agent runs and with `403` for a worker credential. A running project agent moves its own session with the `switch_worker` tool instead, which needs no stop; workspace chats are rebound only while stopped. Shell runs, r5dctl shells, browser port forwards, and sub-agents started earlier stay on the worker that started them.
+
 `session status` reports the run lifecycle and the launch-time `Source` and `Working tree` facts only. It deliberately prints no commit hash for the worktree, not even the launch baseline: a hash would be stale by the time a caller acts on it, because commits can land between the read and the action. Find the base and the branch's commits with git in the worker checkout instead, for example `git merge-base <your-branch> <branch>`, `git log --oneline <your-branch>..<branch>`, and `git status` in the branch folder, as the `Branch state` line reminds you. While a new worktree is still provisioning, a `Provisioning` line reports where its creation stands in the worker's operation queue and since when (`Provisioning: queued behind 3 worker operations since 2026-09-03T11:41:30Z`); a worker that predates operation receipts leaves that line out.
 
 `session process-log` prints a shell run's stored stdout and stderr from the server, where r5d keeps every run's full output; the `logPath` in tool results names that server-side store, not a file on the worker. Without flags it prints the whole log, `--tail <n>` keeps the last n lines, and `--grep <pattern>` keeps the lines matching a JavaScript regular expression (combine both for the last n matches). Each stream is capped at 512 KB per call and printed under a `==> stdout <==` or `==> stderr <==` header; a one-line summary with byte totals, the selection, and any truncation goes to stderr so stdout stays clean for `grep`, `head`, and `tail`. Inside an r5d worker shell the temporary credential can only read runs on that shell's worker.

package/dist/cjs/cli.cjs

@@ -95,6 +95,7 @@ __export(cli_exports, {
   renderSessionList: () => renderSessionList,
   renderSessionRunStart: () => renderSessionRunStart,
   renderSessionRunStatus: () => renderSessionRunStatus,
+  renderSessionSetWorker: () => renderSessionSetWorker,
   renderWorkerCapacity: () => renderWorkerCapacity,
   renderWorkspaceStatus: () => renderWorkspaceStatus,
   renderWorkspaceSync: () => renderWorkspaceSync,
@@ -175,6 +176,7 @@ const SESSION_RUN_HELP_TEXT = [
   "  r5dctl session status <session-id>",
   '  r5dctl session prompt --worker <label> --mode <mode> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
   "  r5dctl session stop <session-id>",
+  "  r5dctl session set-worker <session-id> --worker <label>",
   "  r5dctl session process-log <run-id> [--tail <n>] [--grep <pattern>]",
   "  r5dctl [-s <session-id>] session claim <topic> [--ttl <duration>] [--note <text>]",
   "  r5dctl [-s <session-id>] session claim <topic> --status | --renew [--ttl <duration>] | --release",
@@ -197,6 +199,8 @@ const SESSION_RUN_HELP_TEXT = [
   "Use -f/--follow/--watch to attach after a start; Ctrl-C detaches without stopping the session.",
   "process-log prints a shell run's stored stdout/stderr from the server: the whole log, its last n lines,",
   "or the lines matching a JavaScript regular expression. The log is not a file on the worker.",
+  "set-worker rebinds a stopped session to another connected worker: it publishes the current worker's workspace,",
+  "synchronizes the target, and the session resumes there. A running agent moves itself with its switch_worker tool.",
   ""
 ].join("\n");
 const SHARED_HELP_ENTRIES = [
@@ -335,6 +339,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "session stop <session-id>",
     description: "Stop an active session generation."
   },
+  {
+    section: "sessions",
+    usage: "session set-worker <session-id> --worker <label>",
+    description: "Rebind a stopped session to another connected worker: publish the current worker's workspace, synchronize the target, and resume there. Refused while the agent runs; a running agent switches itself with switch_worker."
+  },
   {
     section: "sessions",
     usage: "[-s <session-id>] session claim <topic> [--ttl <duration>] [--note <text>] [--status|--renew|--release]",
@@ -903,6 +912,12 @@ function parseSessionRunCommand(options, args, env = process.env) {
     if (parsed.positionals.length > 1) throw new Error(`Unexpected session ${subcommand} argument: ${parsed.positionals[1]}`);
     return { kind: subcommand, sessionId };
   }
+  if (subcommand === "set-worker") {
+    const parsed = parseCommandOperands(commandArgs, /* @__PURE__ */ new Set(["--worker"]), /* @__PURE__ */ new Map(), "session set-worker");
+    const sessionId = requireValue(parsed.positionals[0], "Session id is required for `session set-worker`");
+    if (parsed.positionals.length > 1) throw new Error(`Unexpected session set-worker argument: ${parsed.positionals[1]}`);
+    return { kind: "set-worker", sessionId, worker: requireWorker(parsed.values) };
+  }
   if (subcommand === "prompt") {
     const parsed = parseCommandOperands(
       commandArgs,
@@ -2279,9 +2294,23 @@ async function dispatchSessionRunCommand(client, command) {
     });
     return { data: data2, human: renderSessionRunStatus(data2) };
   }
+  if (command.kind === "set-worker") {
+    const data2 = await client.sessions.setWorker(command.sessionId, { worker: command.worker });
+    return { data: data2, human: renderSessionSetWorker(data2) };
+  }
   const data = await client.sessions.stop(command.sessionId);
   return { data, human: renderSessionRunStatus(data) };
 }
+function renderSessionSetWorker(response) {
+  const previous = typeof response.previousWorker === "string" && response.previousWorker.length > 0 ? response.previousWorker : null;
+  const lines = [
+    `Session: ${responseString(response, "sessionId") ?? "(unknown)"}`,
+    `Worker: ${responseString(response, "worker") ?? "(unassigned)"}${previous ? ` (was ${previous})` : ""}`,
+    "The session resumes on this worker; shell runs and sub-agents started earlier stay where they ran."
+  ];
+  return `${lines.join("\n")}
+`;
+}
 async function waitForSessionProvisioning(client, initial, options = {}) {
   const sessionId = requireValue(responseString(initial, "sessionId"), "Session start did not return a session id");
   const wait = options.wait ?? import_promises.setTimeout;
@@ -3880,6 +3909,7 @@ async function main(argv = process.argv.slice(2)) {
   renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
+  renderSessionSetWorker,
   renderWorkerCapacity,
   renderWorkspaceStatus,
   renderWorkspaceSync,

package/dist/cjs/package.json

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

package/dist/mjs/cli.mjs

@@ -70,6 +70,7 @@ const SESSION_RUN_HELP_TEXT = [
   "  r5dctl session status <session-id>",
   '  r5dctl session prompt --worker <label> --mode <mode> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
   "  r5dctl session stop <session-id>",
+  "  r5dctl session set-worker <session-id> --worker <label>",
   "  r5dctl session process-log <run-id> [--tail <n>] [--grep <pattern>]",
   "  r5dctl [-s <session-id>] session claim <topic> [--ttl <duration>] [--note <text>]",
   "  r5dctl [-s <session-id>] session claim <topic> --status | --renew [--ttl <duration>] | --release",
@@ -92,6 +93,8 @@ const SESSION_RUN_HELP_TEXT = [
   "Use -f/--follow/--watch to attach after a start; Ctrl-C detaches without stopping the session.",
   "process-log prints a shell run's stored stdout/stderr from the server: the whole log, its last n lines,",
   "or the lines matching a JavaScript regular expression. The log is not a file on the worker.",
+  "set-worker rebinds a stopped session to another connected worker: it publishes the current worker's workspace,",
+  "synchronizes the target, and the session resumes there. A running agent moves itself with its switch_worker tool.",
   ""
 ].join("\n");
 const SHARED_HELP_ENTRIES = [
@@ -230,6 +233,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "session stop <session-id>",
     description: "Stop an active session generation."
   },
+  {
+    section: "sessions",
+    usage: "session set-worker <session-id> --worker <label>",
+    description: "Rebind a stopped session to another connected worker: publish the current worker's workspace, synchronize the target, and resume there. Refused while the agent runs; a running agent switches itself with switch_worker."
+  },
   {
     section: "sessions",
     usage: "[-s <session-id>] session claim <topic> [--ttl <duration>] [--note <text>] [--status|--renew|--release]",
@@ -798,6 +806,12 @@ function parseSessionRunCommand(options, args, env = process.env) {
     if (parsed.positionals.length > 1) throw new Error(`Unexpected session ${subcommand} argument: ${parsed.positionals[1]}`);
     return { kind: subcommand, sessionId };
   }
+  if (subcommand === "set-worker") {
+    const parsed = parseCommandOperands(commandArgs, /* @__PURE__ */ new Set(["--worker"]), /* @__PURE__ */ new Map(), "session set-worker");
+    const sessionId = requireValue(parsed.positionals[0], "Session id is required for `session set-worker`");
+    if (parsed.positionals.length > 1) throw new Error(`Unexpected session set-worker argument: ${parsed.positionals[1]}`);
+    return { kind: "set-worker", sessionId, worker: requireWorker(parsed.values) };
+  }
   if (subcommand === "prompt") {
     const parsed = parseCommandOperands(
       commandArgs,
@@ -2174,9 +2188,23 @@ async function dispatchSessionRunCommand(client, command) {
     });
     return { data: data2, human: renderSessionRunStatus(data2) };
   }
+  if (command.kind === "set-worker") {
+    const data2 = await client.sessions.setWorker(command.sessionId, { worker: command.worker });
+    return { data: data2, human: renderSessionSetWorker(data2) };
+  }
   const data = await client.sessions.stop(command.sessionId);
   return { data, human: renderSessionRunStatus(data) };
 }
+function renderSessionSetWorker(response) {
+  const previous = typeof response.previousWorker === "string" && response.previousWorker.length > 0 ? response.previousWorker : null;
+  const lines = [
+    `Session: ${responseString(response, "sessionId") ?? "(unknown)"}`,
+    `Worker: ${responseString(response, "worker") ?? "(unassigned)"}${previous ? ` (was ${previous})` : ""}`,
+    "The session resumes on this worker; shell runs and sub-agents started earlier stay where they ran."
+  ];
+  return `${lines.join("\n")}
+`;
+}
 async function waitForSessionProvisioning(client, initial, options = {}) {
   const sessionId = requireValue(responseString(initial, "sessionId"), "Session start did not return a session id");
   const wait = options.wait ?? sleep;
@@ -3774,6 +3802,7 @@ export {
   renderSessionList,
   renderSessionRunStart,
   renderSessionRunStatus,
+  renderSessionSetWorker,
   renderWorkerCapacity,
   renderWorkspaceStatus,
   renderWorkspaceSync,

package/dist/mjs/package.json

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

package/dist/types/cli.d.ts

@@ -84,6 +84,10 @@ export type R5dctlSessionRunCommand = R5dctlSessionStartCommand | {
 } | {
     kind: "stop";
     sessionId: string;
+} | {
+    kind: "set-worker";
+    sessionId: string;
+    worker: string;
 };
 export type R5dctlBranchCreateArgs = {
     source: R5dctlWorktreeSource;
@@ -312,6 +316,8 @@ export type R5dctlCommandResponse = {
     baselineCommit?: string | null;
     workspaceHead?: string | null;
     worker?: string;
+    /** The binding a `session set-worker` replaced; null when the session had none. */
+    previousWorker?: string | null;
     status?: string;
     runStatus?: unknown;
     /** Worker queue state while a new worktree provisions; older servers and workers omit it. */
@@ -347,6 +353,9 @@ export type R5dctlSessionRunClient = {
             delivery?: R5dctlPromptDelivery;
         }) => Promise<R5dctlCommandResponse>;
         stop: (sessionId: string) => Promise<R5dctlCommandResponse>;
+        setWorker: (sessionId: string, input: {
+            worker: string;
+        }) => Promise<R5dctlCommandResponse>;
     };
 };
 export declare function renderSessionRunStart(session: R5dctlCommandResponse): string;
@@ -356,6 +365,7 @@ export type R5dctlCommandDispatchResult = {
     human: string;
 };
 export declare function dispatchSessionRunCommand(client: R5dctlSessionRunClient, command: R5dctlSessionRunCommand): Promise<R5dctlCommandDispatchResult>;
+export declare function renderSessionSetWorker(response: R5dctlCommandResponse): string;
 export declare function waitForSessionProvisioning(client: Pick<R5dctlSessionRunClient, "sessions">, initial: R5dctlCommandResponse, options?: {
     intervalMs?: number;
     wait?: (milliseconds: number) => Promise<unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.130",
+  "version": "0.0.132",
   "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.130",
+    "@ricsam/r5d-api": "^0.0.132",
     "dotenv": "^17",
     "qrcode": "^1.5.4",
     "ws": "^8.18.3"