@rudderhq/cli 0.3.5-canary.21 → 0.3.5-canary.23

package/dist/index.js

@@ -2850,9 +2850,16 @@ var init_validators = __esm({
 });
 
 // ../packages/shared/dist/agent-url-key.js
+function isUuidLike(value) {
+  if (typeof value !== "string")
+    return false;
+  return UUID_RE.test(value.trim());
+}
+var UUID_RE;
 var init_agent_url_key = __esm({
   "../packages/shared/dist/agent-url-key.js"() {
     "use strict";
+    UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
   }
 });
 
@@ -6308,6 +6315,7 @@ async function addAllowedHostname(host, opts) {
 init_auth_bootstrap_ceo();
 
 // src/commands/client/common.ts
+init_dist();
 import pc4 from "picocolors";
 
 // src/client/board-auth.ts
@@ -6811,8 +6819,11 @@ function toStringRecord(headers) {
 
 // src/commands/client/common.ts
 init_store();
+var currentCommandFullIds = false;
+var CLI_SHORT_UUID_LENGTH = 12;
+var UUID_SUBSTRING_RE = /\b[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\b/giu;
 function addCommonClientOptions(command, opts) {
-  command.option("-c, --config <path>", "Path to Rudder config file").option("-d, --data-dir <path>", "Rudder data directory root (isolates state from ~/.rudder)").option("--context <path>", "Path to CLI context file").option("--profile <name>", "CLI context profile name").option("--api-base <url>", "Base URL for the Rudder API").option("--api-key <token>", "Bearer token for agent-authenticated calls").option("--run-id <id>", "Run ID to attach on mutating agent requests").option("--json", "Output raw JSON");
+  command.option("-c, --config <path>", "Path to Rudder config file").option("-d, --data-dir <path>", "Rudder data directory root (isolates state from ~/.rudder)").option("--context <path>", "Path to CLI context file").option("--profile <name>", "CLI context profile name").option("--api-base <url>", "Base URL for the Rudder API").option("--api-key <token>", "Bearer token for agent-authenticated calls").option("--run-id <id>", "Run ID to attach on mutating agent requests").option("--json", "Output JSON").option("--full-ids", "Show full UUIDs in output instead of CLI short IDs");
   if (opts?.includeCompany) {
     command.option("-O, --org-id <id>", "Organization ID (overrides context default)");
   }
@@ -6833,6 +6844,8 @@ function resolveCommandContext(options, opts) {
       "Organization ID is required. Pass --org-id, set RUDDER_ORG_ID, or set context profile orgId via `rudder context set`."
     );
   }
+  const fullIds = Boolean(options.fullIds);
+  currentCommandFullIds = fullIds;
   const api = new RudderApiClient({
     apiBase,
     apiKey,
@@ -6859,7 +6872,8 @@ function resolveCommandContext(options, opts) {
     runId,
     profileName,
     profile,
-    json: Boolean(options.json)
+    json: Boolean(options.json),
+    fullIds
   };
 }
 function shouldRecoverBoardAuth(error) {
@@ -6871,54 +6885,149 @@ function canAttemptInteractiveBoardAuth() {
   return Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
 function printOutput(data, opts = {}) {
+  const outputData = shouldShowFullIds(opts.fullIds) ? data : toCliShortIdOutput(data);
   if (opts.json) {
-    const output = JSON.stringify(data, null, 2);
+    const output = JSON.stringify(outputData, null, 2);
     process.stdout.write(output + "\n");
     return;
   }
   if (opts.label) {
     console.log(pc4.bold(opts.label));
   }
-  if (Array.isArray(data)) {
-    if (data.length === 0) {
+  if (Array.isArray(outputData)) {
+    if (outputData.length === 0) {
       console.log(pc4.dim("(empty)"));
       return;
     }
-    for (const item of data) {
+    for (const item of outputData) {
       if (typeof item === "object" && item !== null) {
-        console.log(formatInlineRecord(item));
+        console.log(formatInlineRecord(item, { fullIds: true }));
       } else {
         console.log(String(item));
       }
     }
     return;
   }
-  if (typeof data === "object" && data !== null) {
-    console.log(JSON.stringify(data, null, 2));
+  if (typeof outputData === "object" && outputData !== null) {
+    console.log(JSON.stringify(outputData, null, 2));
     return;
   }
-  if (data === void 0 || data === null) {
+  if (outputData === void 0 || outputData === null) {
     console.log(pc4.dim("(null)"));
     return;
   }
-  console.log(String(data));
+  console.log(String(outputData));
 }
-function formatInlineRecord(record) {
+function formatInlineRecord(record, opts = {}) {
+  const displayRecord = shouldShowFullIds(opts.fullIds) ? record : toCliShortIdOutput(record);
   const keyOrder = ["identifier", "id", "name", "status", "priority", "title", "action"];
   const seen = /* @__PURE__ */ new Set();
   const parts = [];
   for (const key of keyOrder) {
-    if (!(key in record)) continue;
-    parts.push(`${key}=${renderValue(record[key])}`);
+    if (!(key in displayRecord)) continue;
+    parts.push(`${key}=${renderValue(displayRecord[key])}`);
     seen.add(key);
   }
-  for (const [key, value] of Object.entries(record)) {
+  for (const [key, value] of Object.entries(displayRecord)) {
     if (seen.has(key)) continue;
     if (typeof value === "object") continue;
     parts.push(`${key}=${renderValue(value)}`);
   }
   return parts.join(" ");
 }
+function toCliShortIdOutput(value) {
+  if (Array.isArray(value)) {
+    return value.map((item) => toCliShortIdOutput(item));
+  }
+  if (typeof value !== "object" || value === null) {
+    return value;
+  }
+  const source = value;
+  const output = {};
+  for (const [key, childValue] of Object.entries(source)) {
+    output[key] = shortenCliValueForKey(key, childValue, source);
+  }
+  return output;
+}
+function formatCliRunId(runId) {
+  return isUuidLike(runId) ? shortUuid(runId) : runId;
+}
+function shortenCliValueForKey(key, value, parent) {
+  if (typeof value === "string" && isCliIdKey(key) && isUuidLike(value)) {
+    return displayIdForCli(key, value, parent);
+  }
+  if (typeof value === "string" && isCliReferenceStringKey(key)) {
+    return value.replace(UUID_SUBSTRING_RE, (uuid) => shortUuid(uuid));
+  }
+  if (Array.isArray(value) && isCliIdListKey(key)) {
+    return value.map(
+      (item) => typeof item === "string" && isUuidLike(item) ? displayIdForCli(singularizeIdListKey(key), item, parent) : toCliShortIdOutput(item)
+    );
+  }
+  return toCliShortIdOutput(value);
+}
+function displayIdForCli(key, uuid, parent) {
+  if (key === "id") {
+    const directShortRef = readString(parent.shortRef);
+    if (directShortRef) return directShortRef;
+    const issueIdentifier = readDirectIssueIdentifier(parent);
+    if (issueIdentifier) return issueIdentifier;
+  }
+  if (isAgentIdKey(key, parent)) {
+    return formatTypedShortRef("agent", uuid);
+  }
+  if (isIssueCommentIdKey(key)) {
+    return formatTypedShortRef("issue_comment", uuid);
+  }
+  if (key === "entityId" && parent.entityType === "issue") {
+    return readIssueIdentifier(parent) ?? shortUuid(uuid);
+  }
+  return shortUuid(uuid);
+}
+function shouldShowFullIds(explicit) {
+  return Boolean((explicit ?? currentCommandFullIds) || process.argv.includes("--full-ids"));
+}
+function isCliIdKey(key) {
+  return key === "id" || key.endsWith("Id");
+}
+function isCliIdListKey(key) {
+  return key.endsWith("Ids");
+}
+function isCliReferenceStringKey(key) {
+  const lowerKey = key.toLowerCase();
+  return lowerKey.endsWith("ref") || lowerKey.endsWith("path");
+}
+function singularizeIdListKey(key) {
+  return `${key.slice(0, -3)}Id`;
+}
+function isAgentIdKey(key, parent) {
+  const lowerKey = key.toLowerCase();
+  return lowerKey.includes("agentid") || key === "actorId" && parent.actorType === "agent";
+}
+function isIssueCommentIdKey(key) {
+  return key.toLowerCase().includes("commentid");
+}
+function formatTypedShortRef(kind, uuid) {
+  const prefix = kind === "agent" ? "agt" : "cmt";
+  return `${prefix}_${shortUuid(uuid)}`;
+}
+function shortUuid(uuid) {
+  return uuid.replace(/-/g, "").slice(0, CLI_SHORT_UUID_LENGTH).toLowerCase();
+}
+function readIssueIdentifier(parent) {
+  const direct = readDirectIssueIdentifier(parent);
+  if (direct) return direct;
+  const details = parent.details;
+  if (typeof details !== "object" || details === null) return null;
+  const detailsRecord = details;
+  return readString(detailsRecord.identifier) ?? readString(detailsRecord.issueIdentifier);
+}
+function readDirectIssueIdentifier(parent) {
+  return readString(parent.identifier) ?? readString(parent.issueIdentifier);
+}
+function readString(value) {
+  return typeof value === "string" && value.trim().length > 0 ? value : null;
+}
 function renderValue(value) {
   if (value === null || value === void 0) return "-";
   if (typeof value === "string") {
@@ -9507,15 +9616,16 @@ function formatChatSearchResult(row, maxChars) {
   };
 }
 function formatChatMessage(row, maxOutputChars = 1200) {
+  const runId = row.runId ? formatCliRunId(row.runId) : null;
   return {
     id: row.id,
     role: row.role,
     kind: row.kind,
     status: row.status,
-    ...row.runId ? {
-      runId: row.runId,
-      runCommand: `rudder runs get ${row.runId}`,
-      transcriptCommand: `rudder runs transcript ${row.runId}`
+    ...runId ? {
+      runId,
+      runCommand: `rudder runs get ${runId}`,
+      transcriptCommand: `rudder runs transcript ${runId}`
     } : {},
     createdAt: row.createdAt,
     body: clip(row.body, 220),
@@ -9524,15 +9634,16 @@ function formatChatMessage(row, maxOutputChars = 1200) {
   };
 }
 function formatChatTranscriptMessage(row, maxChars) {
+  const runId = row.runId ? formatCliRunId(row.runId) : null;
   const header = {
     id: row.id,
     role: row.role,
     kind: row.kind,
     status: row.status,
-    ...row.runId ? {
-      runId: row.runId,
-      runCommand: `rudder runs get ${row.runId}`,
-      transcriptCommand: `rudder runs transcript ${row.runId}`
+    ...runId ? {
+      runId,
+      runCommand: `rudder runs get ${runId}`,
+      transcriptCommand: `rudder runs transcript ${runId}`
     } : {},
     createdAt: row.createdAt,
     body: clip(row.body, 220)
@@ -11857,7 +11968,7 @@ function registerRunsCommands(program) {
     { includeCompany: false }
   );
   addCommonClientOptions(
-    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}`);
@@ -11868,7 +11979,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const rows = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/events`) ?? [];
@@ -11879,7 +11990,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").action(async (runId, opts) => {
+    runs.command("log").description(getAgentCliCapabilityById("runs.log").description).argument("<runId>", "Run ID or short run ID").option("--max-chars <n>", "Maximum log characters for human output", "12000").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}/log`);
@@ -11894,7 +12005,7 @@ 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("--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) => {
+    runs.command("transcript").description(getAgentCliCapabilityById("runs.transcript").description).argument("<runId>", "Run ID or short 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(
@@ -11913,7 +12024,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("errors").description(getAgentCliCapabilityById("runs.errors").description).argument("<runId>", "Run ID").option("--max-chars <n>", "Maximum output characters per error", "1200").action(async (runId, opts) => {
+    runs.command("errors").description(getAgentCliCapabilityById("runs.errors").description).argument("<runId>", "Run ID or short run ID").option("--max-chars <n>", "Maximum output characters per error", "1200").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const params = new URLSearchParams();
@@ -11928,7 +12039,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("cancel").description(getAgentCliCapabilityById("runs.cancel").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+    runs.command("cancel").description(getAgentCliCapabilityById("runs.cancel").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/cancel`, {});
@@ -11939,7 +12050,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("retry").description(getAgentCliCapabilityById("runs.retry").description).argument("<runId>", "Run ID").action(async (runId, opts) => {
+    runs.command("retry").description(getAgentCliCapabilityById("runs.retry").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const row = await ctx.api.post(`/api/heartbeat-runs/${encodeURIComponent(runId)}/retry`, {});
@@ -12000,8 +12111,9 @@ function buildTranscriptQuery(opts, output) {
   return params.toString();
 }
 function formatRunListRow(row) {
+  const runId = formatCliRunId(row.run.id);
   return {
-    id: row.run.id,
+    id: runId,
     status: row.run.status,
     agent: row.agentName ?? row.run.agentId,
     runtime: row.bundle.agentRuntimeType,
@@ -12012,7 +12124,7 @@ function formatRunListRow(row) {
     skill: row.skillEvidence?.matchedSkillKey ?? "-",
     langfuse: readLangfuseTraceUrl(row.langfuse) ?? "-",
     error: row.errorSummary ?? "-",
-    next: row.run.status === "failed" ? `rudder runs errors ${row.run.id}` : `rudder runs transcript ${row.run.id}`
+    next: row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`
   };
 }
 function buildSkillRunReport(skill, evidenceType, rows) {
@@ -12058,7 +12170,10 @@ function buildSkillRunReport(skill, evidenceType, rows) {
       commonErrors: [...errors.entries()].map(([summary, count]) => ({ summary, count })).sort((a, b) => b.count - a.count).slice(0, 5)
     },
     rows,
-    nextCommands: rows.slice(0, 5).map((row) => row.run.status === "failed" ? `rudder runs errors ${row.run.id}` : `rudder runs transcript ${row.run.id}`)
+    nextCommands: rows.slice(0, 5).map((row) => {
+      const runId = formatCliRunId(row.run.id);
+      return row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`;
+    })
   };
 }
 function formatSkillRunReport(report) {
@@ -12082,11 +12197,12 @@ function formatSkillRunReport(report) {
   return lines;
 }
 function formatInlineSkillRun(row) {
+  const runId = formatCliRunId(row.run.id);
   const issue = formatIssueRef(row.issue);
   const label = row.skillEvidence?.matchedSkillLabel && row.skillEvidence.matchedSkillLabel !== row.skillEvidence.matchedSkillKey ? ` label=${row.skillEvidence.matchedSkillLabel}` : "";
   const langfuse = readLangfuseTraceUrl(row.langfuse);
   return [
-    `id=${row.run.id}`,
+    `id=${runId}`,
     `status=${row.run.status}`,
     `agent=${row.agentName ?? row.run.agentId}`,
     `issue=${issue}`,
@@ -12097,7 +12213,7 @@ function formatInlineSkillRun(row) {
     `skill=${row.skillEvidence?.matchedSkillKey ?? "-"}${label}`,
     `langfuse=${langfuse ?? "-"}`,
     `error=${row.errorSummary ?? "-"}`,
-    `next=${row.run.status === "failed" ? `rudder runs errors ${row.run.id}` : `rudder runs transcript ${row.run.id}`}`
+    `next=${row.run.status === "failed" ? `rudder runs errors ${runId}` : `rudder runs transcript ${runId}`}`
   ].join(" ");
 }
 function formatIssueRef(issue) {
@@ -12909,7 +13025,7 @@ async function heartbeatRun(opts) {
     return;
   }
   const run = invokeRes;
-  console.log(pc12.cyan(`Invoked heartbeat run ${run.id} for agent ${agent.name} (${agent.id})`));
+  console.log(pc12.cyan(`Invoked heartbeat run ${formatCliRunId(run.id)} for agent ${agent.name} (${formatCliRunId(agent.id)})`));
   const runId = run.id;
   let activeRunId = null;
   let lastEventSeq = 0;