@ricsam/r5dctl 0.0.16 → 0.0.18

package/README.md

@@ -55,13 +55,18 @@ r5dctl describe session <session-id>
 r5dctl -s <session-id> update session --name "Renamed session"
 r5dctl -s <session-id> delete session
 
-r5dctl -s <session-id> conversation           # exact agent request transcript
+r5dctl -s <session-id> conversation           # human-readable agent request transcript
+r5dctl -s <session-id> conversation --raw     # raw JSON message/tool parts
+r5dctl -s <session-id> conversation --tools   # include provider-shaped tool definitions
+r5dctl -s <session-id> conversation --raw --tools  # exact raw agent request transcript
 r5dctl -s <session-id> prompt --mode plan --model max "..."
 r5dctl -s <session-id> answer-questions -a1 "Recipe Collection" -a2 "Both Manual & AI"
 r5dctl -s <session-id> apply-required-envs -e backend/KEY=value -e frontend/KEY=value
 
 ```
 
+Conversation output is human-readable by default. `--raw` keeps the transcript layout but renders structured message and tool parts as JSON, while `--tools` includes the provider-shaped tool definitions. The global `--json` flag remains separate and prints the complete API response envelope.
+
 Project mode is derived from the persisted `backwardsCompatible` project setting:
 
 - `greenfield`: agent can make breaking/reset-style changes

package/dist/cjs/cli.cjs

@@ -116,7 +116,11 @@ const SHARED_HELP_ENTRIES = [
   { section: "sessions", usage: "describe session <session-id>", description: "Show session details." },
   { section: "sessions", usage: "-s <session-id> update session --name <name>", description: "Rename a session or clear its name." },
   { section: "sessions", usage: "-s <session-id> delete session", description: "Delete a session." },
-  { section: "sessions", usage: "-s <session-id> conversation", description: "Read the exact agent request transcript." },
+  {
+    section: "sessions",
+    usage: "-s <session-id> conversation [--raw] [--tools]",
+    description: "Read the agent request transcript in human-readable form."
+  },
   {
     section: "sessions",
     usage: '-s <session-id> prompt --mode <mode> --model <tier> "<message>"',
@@ -205,8 +209,16 @@ function readInstalledPackageVersion(packageJsonPath) {
   }
   return null;
 }
+function resolveEntrypointPath(entrypoint) {
+  const resolved = import_node_path.default.resolve(entrypoint);
+  try {
+    return import_node_fs.default.realpathSync.native(resolved);
+  } catch {
+    return resolved;
+  }
+}
 function getR5dctlVersion() {
-  const entrypoint = process.argv[1] ? import_node_path.default.resolve(process.argv[1]) : null;
+  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) {
     const packageVersion = readInstalledPackageVersion(import_node_path.default.join(current, "package.json"));
@@ -838,15 +850,21 @@ function parseSessionUpdateArgs(args) {
   return input;
 }
 function parseConversationRenderArgs(args) {
-  const options = {};
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
+  const options = { format: "human", includeTools: false };
+  for (const arg of args) {
+    if (arg === "--raw") {
+      options.format = "raw";
+      continue;
+    }
+    if (arg === "--tools") {
+      options.includeTools = true;
+      continue;
+    }
     throw new Error(`Unknown conversation argument: ${arg}`);
   }
   return options;
 }
-function renderConversationResponse(read, options = {}) {
-  void options;
+function renderConversationResponse(read) {
   return read.agentText.endsWith("\n") ? read.agentText : `${read.agentText}
 `;
 }
@@ -1011,8 +1029,9 @@ ${result.message}
   }
   if (first === "sessions" && second === "conversation" || first === "conversation") {
     const offset = first === "conversation" ? 1 : 2;
-    const read = await client.sessions.conversation(requireValue(args[offset], "Missing session id"));
-    write(read, renderConversationResponse(read, parseConversationRenderArgs(args.slice(offset + 1))));
+    const renderOptions = parseConversationRenderArgs(args.slice(offset + 1));
+    const read = await client.sessions.conversation(requireValue(args[offset], "Missing session id"), renderOptions);
+    write(read, renderConversationResponse(read));
     return;
   }
   if (first === "sessions" && second === "prompt" || first === "prompt") {

package/dist/cjs/package.json

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

package/dist/mjs/cli.mjs

@@ -76,7 +76,11 @@ const SHARED_HELP_ENTRIES = [
   { section: "sessions", usage: "describe session <session-id>", description: "Show session details." },
   { section: "sessions", usage: "-s <session-id> update session --name <name>", description: "Rename a session or clear its name." },
   { section: "sessions", usage: "-s <session-id> delete session", description: "Delete a session." },
-  { section: "sessions", usage: "-s <session-id> conversation", description: "Read the exact agent request transcript." },
+  {
+    section: "sessions",
+    usage: "-s <session-id> conversation [--raw] [--tools]",
+    description: "Read the agent request transcript in human-readable form."
+  },
   {
     section: "sessions",
     usage: '-s <session-id> prompt --mode <mode> --model <tier> "<message>"',
@@ -165,8 +169,16 @@ function readInstalledPackageVersion(packageJsonPath) {
   }
   return null;
 }
+function resolveEntrypointPath(entrypoint) {
+  const resolved = path.resolve(entrypoint);
+  try {
+    return fs.realpathSync.native(resolved);
+  } catch {
+    return resolved;
+  }
+}
 function getR5dctlVersion() {
-  const entrypoint = process.argv[1] ? path.resolve(process.argv[1]) : null;
+  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) {
     const packageVersion = readInstalledPackageVersion(path.join(current, "package.json"));
@@ -798,15 +810,21 @@ function parseSessionUpdateArgs(args) {
   return input;
 }
 function parseConversationRenderArgs(args) {
-  const options = {};
-  for (let index = 0; index < args.length; index += 1) {
-    const arg = args[index];
+  const options = { format: "human", includeTools: false };
+  for (const arg of args) {
+    if (arg === "--raw") {
+      options.format = "raw";
+      continue;
+    }
+    if (arg === "--tools") {
+      options.includeTools = true;
+      continue;
+    }
     throw new Error(`Unknown conversation argument: ${arg}`);
   }
   return options;
 }
-function renderConversationResponse(read, options = {}) {
-  void options;
+function renderConversationResponse(read) {
   return read.agentText.endsWith("\n") ? read.agentText : `${read.agentText}
 `;
 }
@@ -971,8 +989,9 @@ ${result.message}
   }
   if (first === "sessions" && second === "conversation" || first === "conversation") {
     const offset = first === "conversation" ? 1 : 2;
-    const read = await client.sessions.conversation(requireValue(args[offset], "Missing session id"));
-    write(read, renderConversationResponse(read, parseConversationRenderArgs(args.slice(offset + 1))));
+    const renderOptions = parseConversationRenderArgs(args.slice(offset + 1));
+    const read = await client.sessions.conversation(requireValue(args[offset], "Missing session id"), renderOptions);
+    write(read, renderConversationResponse(read));
     return;
   }
   if (first === "sessions" && second === "prompt" || first === "prompt") {

package/dist/mjs/package.json

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

package/dist/types/cli.d.ts

@@ -1,4 +1,4 @@
-import { type R5dctlConversationResponse, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
+import { type R5dctlConversationRenderOptions, type R5dctlConversationResponse, type ChatMode, type ModelTier } from "@ricsam/r5d-api";
 export type GlobalOptions = {
     baseUrl?: string;
     json: boolean;
@@ -30,7 +30,7 @@ type CommandExecutionPlan = {
     kind: "cli-help";
     text: string;
 };
-type ConversationRenderOptions = {};
+type ConversationRenderOptions = Required<R5dctlConversationRenderOptions>;
 export declare function getCliHelpText(): string;
 export declare function getR5dctlVersion(): string;
 export declare function parseGlobalArgs(argv: string[]): {
@@ -45,7 +45,7 @@ export declare function parsePromptArgs(args: string[]): {
     message: string;
 };
 export declare function parseConversationRenderArgs(args: string[]): ConversationRenderOptions;
-export declare function renderConversationResponse(read: R5dctlConversationResponse, options?: ConversationRenderOptions): string;
+export declare function renderConversationResponse(read: R5dctlConversationResponse): string;
 export declare function resolveCommandExecution(options: GlobalOptions, rest: string[]): CommandExecutionPlan;
 export declare function runR5dctlCli(argv: string[]): Promise<number>;
 export declare function main(argv?: string[]): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ricsam/r5dctl",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "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.16"
+    "@ricsam/r5d-api": "^0.0.18"
   },
   "files": [
     "dist",