@ricsam/r5dctl 0.0.42 → 0.0.44

package/README.md

@@ -64,6 +64,7 @@ r5dctl -s <session-id> conversation --tools            # include provider-shaped
 r5dctl -s <session-id> conversation --system           # include system prompt messages
 r5dctl -s <session-id> conversation --raw --tools --system  # exact raw agent request transcript
 r5dctl conversation overview <session-id>               # dialogue/thinking with tool work omitted
+r5dctl conversation inspect-node <session-id> <node-id>  # raw persisted node plus traversal metadata
 r5dctl conversation inspect-work <session-id> <work-id> # compact call list for one omitted turn
 r5dctl conversation inspect-work <session-id> <work-id> --summary
 r5dctl conversation inspect-work <session-id> <work-id> --full
@@ -92,6 +93,8 @@ When available, conversation rendering uses the newest complete persisted model-
 
 `conversation overview` is a deterministic active-branch projection for continuing work in another session. It keeps user messages, injected context, assistant thinking/commentary/final responses, and user decisions, while replacing each turn's tool batches with a stable work ID and numbered call ranges. Adjacent tool batches with no visible content between them are coalesced into one range. Use `conversation inspect-work` with that session and work ID to inspect the omitted calls. Inspection is compact by default; `--summary` adds bounded targets/outcomes and `--full` renders persisted inputs and results with the normal tool renderers. The explicit `--compact`, `--summary`, and `--full` flags are mutually exclusive. Compact and summary output are designed to be narrowed with `grep`, `head`, `tail`, `sed`, or `cat -n`.
 
+`conversation inspect-node` reads one exact persisted conversation node as formatted JSON. Its header includes the previous node, every direct next node, the next node on the active branch, whether the selected node is active, and the containing `work_...` ID when one is available. This allows callers that start with only a copied chat node ID to traverse nearby nodes or zoom out with `conversation inspect-work`.
+
 Project mode is derived from the persisted `backwardsCompatible` project setting:
 
 - `greenfield`: agent can make breaking/reset-style changes

package/dist/cjs/cli.cjs

@@ -44,6 +44,7 @@ __export(cli_exports, {
   parseSetEnvArgs: () => parseSetEnvArgs,
   parseShellArgs: () => parseShellArgs,
   readDotenvFile: () => readDotenvFile,
+  renderConversationNodeResponse: () => renderConversationNodeResponse,
   renderConversationOverviewResponse: () => renderConversationOverviewResponse,
   renderConversationResponse: () => renderConversationResponse,
   renderConversationWorkResponse: () => renderConversationWorkResponse,
@@ -195,6 +196,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "conversation overview <session-id>",
     description: "Read dialogue and thinking while replacing tool work with inspectable ranges."
   },
+  {
+    section: "sessions",
+    usage: "conversation inspect-node <session-id> <node-id>",
+    description: "Read one raw conversation node with previous, next, and containing work IDs."
+  },
   {
     section: "sessions",
     usage: "conversation inspect-work <session-id> <work-id> [--compact|--summary|--full]",
@@ -1404,6 +1410,24 @@ function renderConversationOverviewResponse(read) {
   return read.overviewText.endsWith("\n") ? read.overviewText : `${read.overviewText}
 `;
 }
+function renderConversationNodeResponse(read) {
+  const rawNode = JSON.stringify(read.node, null, 2) ?? String(read.node);
+  return [
+    "# Conversation Node",
+    "",
+    `node: ${read.nodeId}`,
+    `previous: ${read.previousNodeId ?? "(none)"}`,
+    `next: ${read.nextNodeIds.join(", ") || "(none)"}`,
+    `active next: ${read.activeNextNodeId ?? "(none)"}`,
+    `active branch: ${read.onActiveBranch ? "yes" : "no"}`,
+    `work: ${read.workId ?? "(none)"}`,
+    "",
+    "## Raw Node",
+    "",
+    rawNode,
+    ""
+  ].join("\n");
+}
 function renderConversationWorkResponse(read) {
   return read.workText.endsWith("\n") ? read.workText : `${read.workText}
 `;
@@ -1632,6 +1656,16 @@ ${result.message}
     write(read, renderConversationOverviewResponse(read));
     return;
   }
+  if (first === "conversation" && second === "inspect-node") {
+    if (args.length > 4) {
+      throw new Error(`Unexpected conversation inspect-node argument: ${args[4]}`);
+    }
+    const sessionId = requireValue(args[2], "Missing session id");
+    const nodeId = requireValue(args[3], "Missing node id");
+    const read = await client.sessions.inspectConversationNode(sessionId, nodeId);
+    write(read, renderConversationNodeResponse(read));
+    return;
+  }
   if (first === "conversation" && second === "inspect-work") {
     const sessionId = requireValue(args[2], "Missing session id");
     const workId = requireValue(args[3], "Missing work id");
@@ -2013,6 +2047,21 @@ function resolveCommandExecution(options, rest) {
         pluginArgs: ["conversation", "inspect-work", sessionId2, workId, ...remainingArgs]
       };
     }
+    if (subcommand === "inspect-node") {
+      const sessionId2 = options.session ?? commandArgs[1];
+      if (!sessionId2) {
+        throw new Error("Session id is required for `conversation inspect-node`");
+      }
+      const nodeId = options.session ? commandArgs[1] : commandArgs[2];
+      if (!nodeId) {
+        throw new Error("Node id is required for `conversation inspect-node`");
+      }
+      const remainingArgs = options.session ? commandArgs.slice(2) : commandArgs.slice(3);
+      return {
+        kind: "plugin",
+        pluginArgs: ["conversation", "inspect-node", sessionId2, nodeId, ...remainingArgs]
+      };
+    }
     const sessionId = options.session;
     if (!sessionId) {
       throw new Error("--session/-s is required for `conversation`");
@@ -2245,6 +2294,7 @@ async function main(argv = process.argv.slice(2)) {
   parseSetEnvArgs,
   parseShellArgs,
   readDotenvFile,
+  renderConversationNodeResponse,
   renderConversationOverviewResponse,
   renderConversationResponse,
   renderConversationWorkResponse,

package/dist/cjs/package.json

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

package/dist/mjs/cli.mjs

@@ -139,6 +139,11 @@ const SHARED_HELP_ENTRIES = [
     usage: "conversation overview <session-id>",
     description: "Read dialogue and thinking while replacing tool work with inspectable ranges."
   },
+  {
+    section: "sessions",
+    usage: "conversation inspect-node <session-id> <node-id>",
+    description: "Read one raw conversation node with previous, next, and containing work IDs."
+  },
   {
     section: "sessions",
     usage: "conversation inspect-work <session-id> <work-id> [--compact|--summary|--full]",
@@ -1348,6 +1353,24 @@ function renderConversationOverviewResponse(read) {
   return read.overviewText.endsWith("\n") ? read.overviewText : `${read.overviewText}
 `;
 }
+function renderConversationNodeResponse(read) {
+  const rawNode = JSON.stringify(read.node, null, 2) ?? String(read.node);
+  return [
+    "# Conversation Node",
+    "",
+    `node: ${read.nodeId}`,
+    `previous: ${read.previousNodeId ?? "(none)"}`,
+    `next: ${read.nextNodeIds.join(", ") || "(none)"}`,
+    `active next: ${read.activeNextNodeId ?? "(none)"}`,
+    `active branch: ${read.onActiveBranch ? "yes" : "no"}`,
+    `work: ${read.workId ?? "(none)"}`,
+    "",
+    "## Raw Node",
+    "",
+    rawNode,
+    ""
+  ].join("\n");
+}
 function renderConversationWorkResponse(read) {
   return read.workText.endsWith("\n") ? read.workText : `${read.workText}
 `;
@@ -1576,6 +1599,16 @@ ${result.message}
     write(read, renderConversationOverviewResponse(read));
     return;
   }
+  if (first === "conversation" && second === "inspect-node") {
+    if (args.length > 4) {
+      throw new Error(`Unexpected conversation inspect-node argument: ${args[4]}`);
+    }
+    const sessionId = requireValue(args[2], "Missing session id");
+    const nodeId = requireValue(args[3], "Missing node id");
+    const read = await client.sessions.inspectConversationNode(sessionId, nodeId);
+    write(read, renderConversationNodeResponse(read));
+    return;
+  }
   if (first === "conversation" && second === "inspect-work") {
     const sessionId = requireValue(args[2], "Missing session id");
     const workId = requireValue(args[3], "Missing work id");
@@ -1957,6 +1990,21 @@ function resolveCommandExecution(options, rest) {
         pluginArgs: ["conversation", "inspect-work", sessionId2, workId, ...remainingArgs]
       };
     }
+    if (subcommand === "inspect-node") {
+      const sessionId2 = options.session ?? commandArgs[1];
+      if (!sessionId2) {
+        throw new Error("Session id is required for `conversation inspect-node`");
+      }
+      const nodeId = options.session ? commandArgs[1] : commandArgs[2];
+      if (!nodeId) {
+        throw new Error("Node id is required for `conversation inspect-node`");
+      }
+      const remainingArgs = options.session ? commandArgs.slice(2) : commandArgs.slice(3);
+      return {
+        kind: "plugin",
+        pluginArgs: ["conversation", "inspect-node", sessionId2, nodeId, ...remainingArgs]
+      };
+    }
     const sessionId = options.session;
     if (!sessionId) {
       throw new Error("--session/-s is required for `conversation`");
@@ -2188,6 +2236,7 @@ export {
   parseSetEnvArgs,
   parseShellArgs,
   readDotenvFile,
+  renderConversationNodeResponse,
   renderConversationOverviewResponse,
   renderConversationResponse,
   renderConversationWorkResponse,

package/dist/mjs/package.json

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

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessRun, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type R5dctlConversationNodeResponse, type R5dctlConversationOverviewResponse, type R5dctlConversationWorkDetail, type R5dctlConversationWorkResponse, type R5dctlEnvData, type R5dctlProcessInspection, type R5dctlProcessListInput, type R5dctlProcessRun, type R5dctlWorkspaceStatus, type R5dctlWorkspaceSyncResult, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -80,6 +80,7 @@ export declare function parseConversationRenderArgs(args: string[]): Conversatio
 export declare function renderConversationResponse(read: R5dctlConversationResponse): string;
 export declare function parseConversationWorkDetailArgs(args: string[]): R5dctlConversationWorkDetail;
 export declare function renderConversationOverviewResponse(read: R5dctlConversationOverviewResponse): string;
+export declare function renderConversationNodeResponse(read: R5dctlConversationNodeResponse): string;
 export declare function renderConversationWorkResponse(read: R5dctlConversationWorkResponse): string;
 export declare function resolveCommandExecution(options: GlobalOptions, rest: string[]): CommandExecutionPlan;
 export declare function runR5dctlCli(argv: string[]): Promise<number>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.42",
+  "version": "0.0.44",
   "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.42",
+    "@ricsam/r5d-api": "^0.0.44",
     "dotenv": "^17",
     "ws": "^8.18.3"
   },