@ricsam/r5dctl 0.0.169 → 0.0.170

package/dist/cjs/cli.cjs

@@ -180,7 +180,7 @@ const SESSION_RUN_HELP_TEXT = [
   '  r5dctl -p <project> session start --worker <label> --worktree <branch> --model <tier> [-f|--follow|--watch] [--tools] [--parent-session <session-id>] "<prompt>"',
   '  r5dctl -p <project> session start --worker <label> --new-worktree <branch> --source worktree:<branch> [--working-tree carry|clean] --model <tier> [-f|--follow|--watch] [--tools] [--parent-session <session-id>] "<prompt>"',
   "  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 prompt --worker <label> --mode <plan|agent> --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>]",
@@ -205,7 +205,7 @@ const SESSION_RUN_HELP_TEXT = [
   "The reserved topic `checkout` declares tracked-file writes in that checkout: claim it before running the command, hold it until the",
   "write is done, and release it. A running session native to that branch holds `checkout` implicitly, so the call names who to message.",
   "Commands started while a cross-scope `checkout` claim is held also fence the claimed checkout on the bound worker (the fence line says",
-  "whether the worker supports it). checkout path prints where a project branch is checked out on the session's bound worker.",
+  "whether the worker supports it). checkout path prints the absolute checkout path of a project branch on the session's bound worker, one bare line (use --json for the checkout and worker too).",
   "Agent shells act as their own session; user credentials select the acting session with -s or R5D_SESSION_ID.",
   "A new worktree starts with the source checkout's uncommitted changes (--working-tree carry, the default);",
   "--working-tree clean checks out the source branch's current commit only. Start and status print the mode, never a commit hash.",
@@ -349,7 +349,7 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "sessions",
-    usage: 'session prompt --worker <label> --mode <mode> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
+    usage: 'session prompt --worker <label> --mode <plan|agent> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
     description: "Prompt a session: steer after the next tool result (default), queue a deferred follow-up, or force in place of the current tool round. An idle unfinished session may require explicit continuation or confirmation of interrupted tools. Blocked delivery reports the saved message/queue ID and reason; inspect the existing queue in the session UI instead of sending duplicates. The recipient sees the verified sender session id; --sender only adds a display title."
   },
   {
@@ -384,12 +384,12 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "sessions",
-    usage: '-s <session-id> answer-questions --worker <label> --mode <mode> --model <tier> -a1 "<answer>" ...',
+    usage: '-s <session-id> answer-questions --worker <label> --mode <plan|agent> --model <tier> -a1 "<answer>" ...',
     description: "Answer pending questions in order."
   },
   {
     section: "sessions",
-    usage: "-s <session-id> answer-env-request --worker <label> --mode <mode> --model <tier> [-e KEY=value] [--context <text>]",
+    usage: "-s <session-id> answer-env-request --worker <label> --mode <plan|agent> --model <tier> [-e KEY=value] [--context <text>]",
     description: "Answer a pending environment variable request with values, context, or both."
   },
   {
@@ -489,7 +489,7 @@ function resolveEntrypointPath(entrypoint) {
   }
 }
 function getR5dctlVersion() {
-  if (true) return "0.0.169";
+  if (true) return "0.0.170";
   const entrypoint = process.argv[1] ? resolveEntrypointPath(process.argv[1]) : null;
   let current = entrypoint ? import_node_path.default.dirname(entrypoint) : process.cwd();
   for (let index = 0; index < 12; index += 1) {
@@ -646,7 +646,7 @@ function requireModel(value) {
   return model;
 }
 function requireSessionMode(value) {
-  const mode = requireValue(value?.trim(), "--mode <mode> is required");
+  const mode = requireValue(value?.trim(), "--mode <plan|agent> is required");
   if (!R5DCTL_SESSION_MODES.has(mode)) {
     throw new Error("Invalid --mode. Expected one of: plan, agent");
   }
@@ -1147,9 +1147,8 @@ ${rows.join("\n")}
 `;
 }
 function renderCheckoutPath(response) {
-  return [`Checkout: ${response.projectPath}#${response.branchName}`, `Worker: ${response.worker}`, `Path: ${response.path}`, ""].join(
-    "\n"
-  );
+  return `${response.path}
+`;
 }
 function assertAuthLoginArgs(args) {
   const valueFlags = /* @__PURE__ */ new Set(["--device-name", "--worker-label"]);
@@ -1388,7 +1387,7 @@ function parseAnswerFlags(args) {
   return ordered.map(([, value]) => value);
 }
 function requireChatMode(value) {
-  const mode = requireValue(value?.trim(), "--mode <mode> is required");
+  const mode = requireValue(value?.trim(), "--mode <plan|agent> is required");
   if (!CHAT_MODES.has(mode)) throw new Error(`Invalid --mode: ${mode}`);
   return mode;
 }

package/dist/cjs/package.json

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

package/dist/mjs/cli.mjs

@@ -68,7 +68,7 @@ const SESSION_RUN_HELP_TEXT = [
   '  r5dctl -p <project> session start --worker <label> --worktree <branch> --model <tier> [-f|--follow|--watch] [--tools] [--parent-session <session-id>] "<prompt>"',
   '  r5dctl -p <project> session start --worker <label> --new-worktree <branch> --source worktree:<branch> [--working-tree carry|clean] --model <tier> [-f|--follow|--watch] [--tools] [--parent-session <session-id>] "<prompt>"',
   "  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 prompt --worker <label> --mode <plan|agent> --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>]",
@@ -93,7 +93,7 @@ const SESSION_RUN_HELP_TEXT = [
   "The reserved topic `checkout` declares tracked-file writes in that checkout: claim it before running the command, hold it until the",
   "write is done, and release it. A running session native to that branch holds `checkout` implicitly, so the call names who to message.",
   "Commands started while a cross-scope `checkout` claim is held also fence the claimed checkout on the bound worker (the fence line says",
-  "whether the worker supports it). checkout path prints where a project branch is checked out on the session's bound worker.",
+  "whether the worker supports it). checkout path prints the absolute checkout path of a project branch on the session's bound worker, one bare line (use --json for the checkout and worker too).",
   "Agent shells act as their own session; user credentials select the acting session with -s or R5D_SESSION_ID.",
   "A new worktree starts with the source checkout's uncommitted changes (--working-tree carry, the default);",
   "--working-tree clean checks out the source branch's current commit only. Start and status print the mode, never a commit hash.",
@@ -237,7 +237,7 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "sessions",
-    usage: 'session prompt --worker <label> --mode <mode> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
+    usage: 'session prompt --worker <label> --mode <plan|agent> --model <tier> [--delivery queue|steer|force] [--sender <name>] <session-id> "<prompt>"',
     description: "Prompt a session: steer after the next tool result (default), queue a deferred follow-up, or force in place of the current tool round. An idle unfinished session may require explicit continuation or confirmation of interrupted tools. Blocked delivery reports the saved message/queue ID and reason; inspect the existing queue in the session UI instead of sending duplicates. The recipient sees the verified sender session id; --sender only adds a display title."
   },
   {
@@ -272,12 +272,12 @@ const SHARED_HELP_ENTRIES = [
   },
   {
     section: "sessions",
-    usage: '-s <session-id> answer-questions --worker <label> --mode <mode> --model <tier> -a1 "<answer>" ...',
+    usage: '-s <session-id> answer-questions --worker <label> --mode <plan|agent> --model <tier> -a1 "<answer>" ...',
     description: "Answer pending questions in order."
   },
   {
     section: "sessions",
-    usage: "-s <session-id> answer-env-request --worker <label> --mode <mode> --model <tier> [-e KEY=value] [--context <text>]",
+    usage: "-s <session-id> answer-env-request --worker <label> --mode <plan|agent> --model <tier> [-e KEY=value] [--context <text>]",
     description: "Answer a pending environment variable request with values, context, or both."
   },
   {
@@ -377,7 +377,7 @@ function resolveEntrypointPath(entrypoint) {
   }
 }
 function getR5dctlVersion() {
-  if (true) return "0.0.169";
+  if (true) return "0.0.170";
   const entrypoint = process.argv[1] ? resolveEntrypointPath(process.argv[1]) : null;
   let current = entrypoint ? path.dirname(entrypoint) : process.cwd();
   for (let index = 0; index < 12; index += 1) {
@@ -534,7 +534,7 @@ function requireModel(value) {
   return model;
 }
 function requireSessionMode(value) {
-  const mode = requireValue(value?.trim(), "--mode <mode> is required");
+  const mode = requireValue(value?.trim(), "--mode <plan|agent> is required");
   if (!R5DCTL_SESSION_MODES.has(mode)) {
     throw new Error("Invalid --mode. Expected one of: plan, agent");
   }
@@ -1035,9 +1035,8 @@ ${rows.join("\n")}
 `;
 }
 function renderCheckoutPath(response) {
-  return [`Checkout: ${response.projectPath}#${response.branchName}`, `Worker: ${response.worker}`, `Path: ${response.path}`, ""].join(
-    "\n"
-  );
+  return `${response.path}
+`;
 }
 function assertAuthLoginArgs(args) {
   const valueFlags = /* @__PURE__ */ new Set(["--device-name", "--worker-label"]);
@@ -1276,7 +1275,7 @@ function parseAnswerFlags(args) {
   return ordered.map(([, value]) => value);
 }
 function requireChatMode(value) {
-  const mode = requireValue(value?.trim(), "--mode <mode> is required");
+  const mode = requireValue(value?.trim(), "--mode <plan|agent> is required");
   if (!CHAT_MODES.has(mode)) throw new Error(`Invalid --mode: ${mode}`);
   return mode;
 }

package/dist/mjs/package.json

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

package/dist/types/cli.d.ts

@@ -257,6 +257,10 @@ export declare function renderSessionClaimResponse(response: {
     fenceDetail?: string;
 }, nowMs?: number): string;
 export declare function renderSessionClaimList(response: R5dctlSessionClaimListResponse, nowMs?: number): string;
+/** One bare line: agents compose `checkout path` with `$(…)` and `git -C`, so
+ * the answer must be the path and nothing else (stage 2026-09-17: a labelled
+ * three-line block reached `git -C` verbatim). The checkout, worker and path
+ * remain available together through `--json`. */
 export declare function renderCheckoutPath(response: R5dctlCheckoutPathResponse): string;
 export declare function parseGlobalArgs(argv: string[]): {
     options: GlobalOptions;

package/package.json

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