@rudderhq/cli 0.3.4-canary.13 → 0.3.4-canary.15

package/dist/index.js

@@ -11170,9 +11170,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "chat.messages",
-    command: "rudder chat messages <chat-id>",
+    command: "rudder chat messages <chat-id> [--limit <n>] [--cursor <cursor>] [--include-transcript]",
     category: "chat",
-    description: "Read bounded chat messages, with transcript omitted unless requested.",
+    description: "Read bounded chat messages with page cursors; transcript output is omitted unless requested.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -11182,9 +11182,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "chat.transcript",
-    command: "rudder chat transcript <chat-id>",
+    command: "rudder chat transcript <chat-id> [--limit <n>] [--cursor <cursor>] [--max-output-chars <n>]",
     category: "chat",
-    description: "Read chat messages with assistant transcript entries clipped in human output.",
+    description: "Read paginated chat messages with assistant transcript entries clipped in human output.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -11194,9 +11194,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "chat.read",
-    command: "rudder chat read <chat-id>",
+    command: "rudder chat read <chat-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
     category: "chat",
-    description: "Read a bounded recent-message snapshot for one chat.",
+    description: "Read a bounded recent-message snapshot for one chat with page cursors.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -11290,9 +11290,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.transcript",
-    command: "rudder runs transcript <run-id>",
+    command: "rudder runs transcript <run-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
     category: "runs",
-    description: "Read the server-normalized run transcript, newest-first by default.",
+    description: "Read the server-normalized run transcript; human output is compact and JSON includes full entries.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -13464,25 +13464,35 @@ function registerChatCommands(program) {
     })
   );
   addCommonClientOptions(
-    chat.command("messages").description(getAgentCliCapabilityById("chat.messages").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--limit <n>", "Maximum messages to print").action(async (chatId, opts) => {
+    chat.command("messages").description(getAgentCliCapabilityById("chat.messages").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const messages = await getChatMessages(ctx, chatId, Boolean(opts.includeTranscript));
-        const limited = limitNewest(messages, opts.limit);
-        printOutput(ctx.json ? limited : limited.map(formatChatMessage), { json: ctx.json });
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: includesChatTranscript(opts),
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        printOutput(
+          ctx.json ? page : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
       } catch (err) {
         handleCommandError(err);
       }
     })
   );
   addCommonClientOptions(
-    chat.command("transcript").description(getAgentCliCapabilityById("chat.transcript").description).argument("<chatId>", "Chat conversation ID").option("--limit <n>", "Maximum messages to print").option("--max-chars <n>", "Maximum transcript chars per message", "1200").action(async (chatId, opts) => {
+    chat.command("transcript").description(getAgentCliCapabilityById("chat.transcript").description).argument("<chatId>", "Chat conversation ID").option("--limit <n>", "Maximum messages to print").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-chars <n>", "Maximum transcript chars per message", "1200").option("--max-output-chars <n>", "Alias for --max-chars").action(async (chatId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const messages = await getChatMessages(ctx, chatId, true);
-        const limited = limitNewest(messages, opts.limit);
+        const page = await getChatMessagesPage(ctx, chatId, {
+          includeTranscript: true,
+          limit: opts.limit,
+          cursor: opts.cursor
+        });
+        const maxChars = parseLimit(opts.maxOutputChars ?? opts.maxChars, 1200);
         printOutput(
-          ctx.json ? limited : limited.flatMap((message) => formatChatTranscriptMessage(message, parseLimit(opts.maxChars, 1200))),
+          ctx.json ? page : page.messages.flatMap((message) => formatChatTranscriptMessage(message, maxChars)),
           { json: ctx.json }
         );
       } catch (err) {
@@ -13491,19 +13501,26 @@ function registerChatCommands(program) {
     })
   );
   addCommonClientOptions(
-    chat.command("read").description(getAgentCliCapabilityById("chat.read").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--limit <n>", "Maximum recent messages", "20").action(async (chatId, opts) => {
+    chat.command("read").description(getAgentCliCapabilityById("chat.read").description).argument("<chatId>", "Chat conversation ID").option("--include-transcript", "Include assistant transcript entries").option("--include-output", "Alias for --include-transcript").option("--include-outputs", "Alias for --include-transcript").option("--limit <n>", "Maximum recent messages", "20").option("--turn-limit <n>", "Alias for --limit for chat turn snapshots").option("--cursor <cursor>", "Stable message cursor returned in page.nextCursor").option("--max-output-chars <n>", "Maximum transcript output chars for human output", "1200").action(async (chatId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const [conversation, messages] = await Promise.all([
+        const [conversation, page] = await Promise.all([
           ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}`),
-          getChatMessages(ctx, chatId, Boolean(opts.includeTranscript))
+          getChatMessagesPage(ctx, chatId, {
+            includeTranscript: includesChatTranscript(opts),
+            limit: opts.turnLimit ?? opts.limit,
+            cursor: opts.cursor
+          })
         ]);
-        const recentMessages = limitNewest(messages, opts.limit);
         const payload = {
           conversation,
-          messages: recentMessages
+          messages: page.messages,
+          page: page.page
         };
-        printOutput(ctx.json ? payload : recentMessages.map(formatChatMessage), { json: ctx.json });
+        printOutput(
+          ctx.json ? payload : page.messages.map((message) => formatChatMessage(message, parseLimit(opts.maxOutputChars, 1200))),
+          { json: ctx.json }
+        );
       } catch (err) {
         handleCommandError(err);
       }
@@ -13567,10 +13584,18 @@ async function listChats(ctx, opts) {
   const rows = await ctx.api.get(`/api/orgs/${ctx.orgId}/chats?${params.toString()}`) ?? [];
   return rows.slice(0, parseLimit(opts.limit, rows.length));
 }
-async function getChatMessages(ctx, chatId, includeTranscript) {
+async function getChatMessagesPage(ctx, chatId, opts) {
   const params = new URLSearchParams();
-  if (includeTranscript) params.set("includeTranscript", "true");
-  return await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}/messages?${params.toString()}`) ?? [];
+  params.set("envelope", "true");
+  params.set("order", "newest");
+  params.set("limit", String(parseLimit(opts.limit, 50)));
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.includeTranscript) params.set("includeTranscript", "true");
+  const page = await ctx.api.get(`/api/chats/${encodeURIComponent(chatId)}/messages?${params.toString()}`);
+  if (!page) {
+    throw new Error("Chat messages response was empty");
+  }
+  return page;
 }
 function filterChatSearchRows(rows, query, scope) {
   const normalized = query.toLowerCase();
@@ -13602,7 +13627,7 @@ function formatChatSearchResult(row, maxChars) {
     snippet: clip(row.searchPreview ?? row.latestReplyPreview ?? row.latestUserMessagePreview ?? row.summary ?? "", maxChars)
   };
 }
-function formatChatMessage(row) {
+function formatChatMessage(row, maxOutputChars = 1200) {
   return {
     id: row.id,
     role: row.role,
@@ -13610,7 +13635,8 @@ function formatChatMessage(row) {
     status: row.status,
     createdAt: row.createdAt,
     body: clip(row.body, 220),
-    transcriptEntries: row.transcriptSummary?.entryCount ?? row.transcript?.length ?? 0
+    transcriptEntries: row.transcriptSummary?.entryCount ?? row.transcript?.length ?? 0,
+    ...row.transcript?.length ? { transcriptPreview: clip(row.transcript.map((entry) => formatTranscriptEntry(entry, maxOutputChars)).join(" "), maxOutputChars) } : {}
   };
 }
 function formatChatTranscriptMessage(row, maxChars) {
@@ -13642,9 +13668,8 @@ function parseLimit(value, fallback) {
   if (!Number.isFinite(parsed) || parsed <= 0) return fallback;
   return Math.floor(parsed);
 }
-function limitNewest(rows, limit) {
-  if (!limit) return rows;
-  return rows.slice(-parseLimit(limit, rows.length));
+function includesChatTranscript(opts) {
+  return Boolean(opts.includeTranscript || opts.includeOutput || opts.includeOutputs);
 }
 function clip(value, maxChars) {
   const text6 = value.replace(/\s+/g, " ").trim();
@@ -13728,11 +13753,11 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("transcript").description(getAgentCliCapabilityById("runs.transcript").description).argument("<runId>", "Run ID").option("--errors-only", "Show only error transcript rows").option("--around-error <id>", "Show context around a run error id such as step-12").option("--context-turns <n>", "Turns around --around-error", "1").option("--chronological", "Show oldest-first instead of default newest-first").option("--narrative", "Use a narrative human layout").option("--max-chars <n>", "Maximum output characters per row", "1200").action(async (runId, opts) => {
+    runs.command("transcript").description(getAgentCliCapabilityById("runs.transcript").description).argument("<runId>", "Run ID").option("--errors-only", "Show only error transcript rows").option("--around-error <id>", "Show context around a run error id such as step-12").option("--context-turns <n>", "Turns around --around-error", "1").option("--cursor <cursor>", "Stable transcript cursor returned in page.nextCursor").option("--turn-limit <n>", "Maximum turns to return", "20").option("--chronological", "Show oldest-first instead of default newest-first").option("--narrative", "Use a narrative human layout").option("--max-chars <n>", "Maximum output characters per row", "1200").option("--max-output-chars <n>", "Alias for --max-chars").option("--include-output", "Include row output in compact human transcript rows").option("--include-outputs", "Alias for --include-output").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const payload = await ctx.api.get(
-          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts)}`
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts, { json: ctx.json })}`
         );
         if (ctx.json) {
           printOutput(payload, { json: true });
@@ -13796,13 +13821,18 @@ function buildRunsListQuery(opts) {
   if (opts.limit) params.set("limit", opts.limit);
   return params.toString();
 }
-function buildTranscriptQuery(opts) {
+function buildTranscriptQuery(opts, output) {
   const params = new URLSearchParams();
   if (opts.errorsOnly) params.set("errorsOnly", "true");
   if (opts.aroundError) params.set("aroundError", opts.aroundError);
+  if (opts.cursor) params.set("cursor", opts.cursor);
+  if (opts.turnLimit) params.set("turnLimit", String(parseLimit2(opts.turnLimit, 20)));
   params.set("contextTurns", String(parseLimit2(opts.contextTurns, 1)));
   params.set("order", opts.chronological || opts.narrative ? "oldest" : "newest");
-  params.set("maxChars", String(parseLimit2(opts.maxChars, 1200)));
+  params.set("output", output.json ? "full" : "compact");
+  const includeOutputs = output.json || Boolean(opts.includeOutput || opts.includeOutputs || opts.narrative);
+  params.set("includeOutputs", includeOutputs ? "true" : "false");
+  params.set("maxChars", String(parseLimit2(opts.maxOutputChars ?? opts.maxChars, 1200)));
   return params.toString();
 }
 function formatRunListRow(row) {
@@ -13832,13 +13862,13 @@ function formatRunTranscriptRow(row) {
     ts: row.ts,
     error: row.isError ? "yes" : "no",
     preview: row.preview || row.detailPreview,
-    output: row.output.text
+    ...row.output ? { output: row.output.text } : {}
   };
 }
 function formatRunTranscriptNarrative(row) {
   const marker = row.isError ? "ERROR " : "";
-  return `${row.id} ${row.ts} ${marker}${row.kind}: ${row.preview || row.detailPreview}
-${row.output.text}`;
+  return `${row.id} ${row.ts} ${marker}${row.kind}: ${row.preview || row.detailPreview}${row.output ? `
+${row.output.text}` : ""}`;
 }
 function formatRunError(row) {
   return {