@rudderhq/cli 0.4.6-canary.10 → 0.4.6-canary.11

package/dist/index.js

@@ -7897,9 +7897,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.get",
-    command: "rudder runs get <run-id>",
+    command: "rudder runs get <run-id> [--full]",
     category: "runs",
-    description: "Read one observed run detail.",
+    description: "Read one bounded run summary; use --full only from a direct trusted CLI for raw detail.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -7909,9 +7909,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.events",
-    command: "rudder runs events <run-id> [--after-seq <n>] [--limit <n>]",
+    command: "rudder runs events <run-id> [--cursor <cursor>] [--after-seq <n>] [--limit <n>] [--full]",
     category: "runs",
-    description: "List a bounded page of persisted run events with a sequence cursor.",
+    description: "List a bounded page of persisted run events with a lossless opaque cursor and clipped payload previews.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -7933,9 +7933,9 @@ var AGENT_CLI_CAPABILITIES = [
   },
   {
     id: "runs.transcript",
-    command: "rudder runs transcript <run-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output]",
+    command: "rudder runs transcript <run-id> [--turn-limit <n>] [--cursor <cursor>] [--include-output] [--full]",
     category: "runs",
-    description: "Read the server-normalized run transcript; human output is compact and JSON includes full entries.",
+    description: "Read a compact server-normalized transcript; --json changes encoding only and --full is direct-CLI-only raw access.",
     mutating: false,
     contract: "agent-v1",
     requiresOrgId: false,
@@ -8040,6 +8040,75 @@ function mcpInputSchemaForCapability(id) {
   const add = (key, value) => {
     properties[key] = value;
   };
+  if (id.startsWith("runs.")) {
+    const addString = (key, description) => add(key, mcpString(description));
+    const addNumber = (key, description) => add(key, mcpNumber(description));
+    const addBoolean = (key, description) => add(key, mcpBoolean(description));
+    switch (id) {
+      case "runs.list":
+        addString("updatedAfter", "Only runs updated after this timestamp.");
+        addString("runIdPrefix", "Run id prefix filter.");
+        addString("relatedAgentId", "Agent id filter.");
+        addString("status", "Run status filter.");
+        addString("runtime", "Runtime type filter.");
+        addString("issueId", "Linked issue id filter.");
+        addString("usedSkill", "Used skill filter.");
+        addString("loadedSkill", "Loaded skill filter.");
+        addString("createdBefore", "Only runs created before this timestamp.");
+        addString("cursor", "Stable summary cursor.");
+        addNumber("limit", "Summary page size, capped by the server.");
+        break;
+      case "runs.by-skill":
+        addString("skill", "Skill key or display name.");
+        addString("evidence", "Evidence type: used or loaded.");
+        addString("relatedAgentId", "Agent id filter.");
+        addString("status", "Run status filter.");
+        addString("runtime", "Runtime type filter.");
+        addString("issueId", "Linked issue id filter.");
+        addString("createdBefore", "Only runs created before this timestamp.");
+        addString("cursor", "Stable summary cursor.");
+        addNumber("limit", "Summary page size, capped by the server.");
+        break;
+      case "runs.events":
+        addString("run", "Run id or short run id.");
+        addString("cursor", "Opaque total-order event cursor.");
+        addNumber("afterSeq", "Legacy sequence-only cursor.");
+        addNumber("limit", "Event page size, capped by the server.");
+        addNumber("maxChars", "Maximum payload preview characters per event.");
+        break;
+      case "runs.log":
+        addString("run", "Run id or short run id.");
+        addNumber("maxChars", "Maximum log characters for display.");
+        addNumber("offset", "Byte offset for the ranged read.");
+        addNumber("limitBytes", "Maximum bytes for the ranged read.");
+        break;
+      case "runs.transcript":
+        addString("run", "Run id or short run id.");
+        addBoolean("errorsOnly", "Return only error rows.");
+        addString("aroundError", "Transcript error step id.");
+        addNumber("contextTurns", "Turns around the selected error.");
+        addString("cursor", "Stable transcript cursor.");
+        addNumber("turnLimit", "Maximum turns to return.");
+        addBoolean("chronological", "Return oldest-first rows.");
+        addBoolean("narrative", "Use narrative row formatting.");
+        addNumber("maxChars", "Maximum output characters per row.");
+        addBoolean("includeOutput", "Include clipped row output.");
+        break;
+      case "runs.errors":
+        addString("run", "Run id or short run id.");
+        addString("cursor", "Error page cursor.");
+        addNumber("maxChars", "Maximum output characters per error.");
+        break;
+      default:
+        addString("run", "Run id or short run id.");
+        break;
+    }
+    return {
+      type: "object",
+      additionalProperties: false,
+      properties
+    };
+  }
   if (id.startsWith("issue.")) {
     add("issue", mcpString("Issue UUID, identifier, or short reference."));
     add("body", mcpString("Direct Markdown body for issue comments or close-out notes."));
@@ -8077,7 +8146,6 @@ function mcpInputSchemaForCapability(id) {
     add("chat", mcpString("Chat conversation id."));
     add("body", mcpString("Agent-authored chat message body."));
   }
-  if (id.startsWith("runs.")) add("run", mcpString("Run id or short run id."));
   if (id.startsWith("agent.skills.")) {
     add("selectionRefs", { type: "array", items: { type: "string" }, description: "Skill selection refs." });
     add("skills", { type: "array", items: { type: "string" }, description: "Skill selection refs alias." });
@@ -8395,6 +8463,8 @@ function toStringRecord(headers) {
 
 // src/agent-v1-mcp-server.ts
 var RUDDER_MCP_SERVER_NAME = "rudder-control-plane";
+var RUDDER_MCP_MAX_TOOL_RESULT_BYTES = 1e6;
+var RUDDER_MCP_MAX_INLINE_TEXT_BYTES = 32e3;
 var RESERVED_MODEL_ARGUMENTS = /* @__PURE__ */ new Set([
   "orgId",
   "org_id",
@@ -8441,6 +8511,7 @@ function buildAgentV1ToolCallPlan(toolName, rawArgs, env = buildMcpServerEnv())
   }
   const capability = getAgentCliCapabilityById(capabilityId);
   rejectModelProvidedRuntimeIdentity(input);
+  rejectUnsupportedToolArguments(toolName, input);
   assertBrowserCapabilityEnabled(capabilityId, env);
   assertRuntimeMcpContext(capability, env);
   const tempFiles = [];
@@ -8482,7 +8553,7 @@ async function runAgentV1McpJsonRpcMessage(message, env = buildMcpServerEnv()) {
           }).tools.map(toMcpToolListEntry)
         });
       case "tools/call":
-        return rpcResult(id, await callToolSafely(message.params, env));
+        return boundedToolCallRpcResponse(id, await callToolSafely(message.params, env));
       default:
         if (isNotification) return null;
         return rpcError(id, -32601, `Unsupported JSON-RPC method: ${String(message.method ?? "")}`);
@@ -8595,11 +8666,7 @@ async function callTool(params, env) {
     const result = await runRudderCli(materializedArgs, plan.env);
     if (result.exitCode === 0) {
       const text6 = result.stdout.trim() || "{}";
-      return {
-        content: [{ type: "text", text: text6 }],
-        ...structuredContentFromJsonText(text6),
-        isError: false
-      };
+      return mcpSuccessFromJsonText(text6);
     }
     const payload = {
       status: "error",
@@ -8722,12 +8789,47 @@ function mcpApiClient(env) {
   });
 }
 function mcpSuccess(data) {
-  const text6 = JSON.stringify(data ?? {});
-  return {
-    content: [{ type: "text", text: text6 }],
-    ...structuredContentFromJsonText(text6),
+  return mcpSuccessFromJsonText(JSON.stringify(data ?? {}));
+}
+function mcpSuccessFromJsonText(text6) {
+  const structured = structuredContentFromJsonText(text6);
+  const textBytes = Buffer.byteLength(text6, "utf8");
+  const inlineText = textBytes <= RUDDER_MCP_MAX_INLINE_TEXT_BYTES ? text6 : JSON.stringify({
+    status: "ok",
+    output: "structuredContent",
+    originalLength: text6.length,
+    originalBytes: textBytes
+  });
+  const result = {
+    content: [{ type: "text", text: inlineText }],
+    ...structured,
     isError: false
   };
+  const resultBytes = Buffer.byteLength(JSON.stringify(result), "utf8");
+  if (resultBytes <= RUDDER_MCP_MAX_TOOL_RESULT_BYTES) return result;
+  return mcpResponseTooLarge(resultBytes);
+}
+function boundedToolCallRpcResponse(id, result) {
+  const response = rpcResult(id, result);
+  const responseBytes = Buffer.byteLength(JSON.stringify(response), "utf8");
+  if (responseBytes <= RUDDER_MCP_MAX_TOOL_RESULT_BYTES) return response;
+  return rpcResult(id, mcpResponseTooLarge(responseBytes));
+}
+function mcpResponseTooLarge(responseBytes) {
+  const payload = {
+    status: "error",
+    code: "rudder_mcp_response_too_large",
+    message: "Rudder MCP response exceeded the bounded tool-result budget. Use pagination or a ranged log read.",
+    details: {
+      maxBytes: RUDDER_MCP_MAX_TOOL_RESULT_BYTES,
+      responseBytes
+    }
+  };
+  return {
+    content: [{ type: "text", text: JSON.stringify(payload) }],
+    structuredContent: payload,
+    isError: true
+  };
 }
 function parseCsvInput(value, fallback) {
   const source = Array.isArray(value) ? value.map((entry) => optionalString(entry)).filter(Boolean).join(",") : optionalString(value) || fallback;
@@ -9124,7 +9226,6 @@ function cliArgsForCapability(capabilityId, input, tempFiles, env) {
       pushOptional(args, "--created-before", input.createdBefore);
       pushOptional(args, "--cursor", input.cursor);
       pushOptional(args, "--limit", input.limit);
-      pushBoolean(args, "--full", input.full);
       return args;
     }
     case "runs.by-skill": {
@@ -9137,15 +9238,16 @@ function cliArgsForCapability(capabilityId, input, tempFiles, env) {
       pushOptional(args, "--created-before", input.createdBefore);
       pushOptional(args, "--cursor", input.cursor);
       pushOptional(args, "--limit", input.limit);
-      pushBoolean(args, "--full", input.full);
       return args;
     }
     case "runs.get":
       return ["runs", "get", requiredString(input, "run")];
     case "runs.events": {
       const args = ["runs", "events", requiredString(input, "run")];
+      pushOptional(args, "--cursor", input.cursor);
       pushOptional(args, "--after-seq", input.afterSeq);
       pushOptional(args, "--limit", input.limit);
+      pushOptional(args, "--max-chars", input.maxChars);
       return args;
     }
     case "runs.log": {
@@ -9171,6 +9273,7 @@ function cliArgsForCapability(capabilityId, input, tempFiles, env) {
     case "runs.errors": {
       const args = ["runs", "errors", requiredString(input, "run")];
       pushOptional(args, "--max-chars", input.maxChars);
+      pushOptional(args, "--cursor", input.cursor);
       return args;
     }
     case "runs.cancel":
@@ -9270,6 +9373,16 @@ function rejectModelProvidedRuntimeIdentity(input) {
   err.code = "rudder_mcp_reserved_identity_argument";
   throw err;
 }
+function rejectUnsupportedToolArguments(toolName, input) {
+  const tool = buildAgentV1McpToolsManifest("agent-v1").tools.find((entry) => entry.name === toolName);
+  if (!tool) return;
+  const supported = new Set(Object.keys(tool.inputSchema.properties));
+  const unsupported = Object.keys(input).filter((key) => !supported.has(key)).sort();
+  if (unsupported.length === 0) return;
+  const err = new Error(`Unsupported argument${unsupported.length === 1 ? "" : "s"} for ${toolName}: ${unsupported.join(", ")}`);
+  err.code = "rudder_mcp_invalid_arguments";
+  throw err;
+}
 function normalizeRuntimeIdentityKey(key) {
   return key.replace(/[^a-z0-9]/giu, "").toLowerCase();
 }
@@ -14208,10 +14321,13 @@ function registerRunsCommands(program) {
     { includeCompany: false }
   );
   addCommonClientOptions(
-    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID or short run ID").action(async (runId, opts) => {
+    runs.command("get").description(getAgentCliCapabilityById("runs.get").description).argument("<runId>", "Run ID or short run ID").option("--full", "Include raw run result, context, excerpts, and session fields").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
-        const row = await ctx.api.get(`/api/run-intelligence/runs/${encodeURIComponent(runId)}`);
+        const projection = opts.full ? "full" : "summary";
+        const row = await ctx.api.get(
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}?projection=${projection}`
+        );
         printOutput(row, { json: ctx.json });
       } catch (err) {
         handleCommandError(err);
@@ -14219,13 +14335,16 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID or short run ID").option("--after-seq <n>", "Return events after this sequence number", "0").option("--limit <n>", "Maximum events to return", "200").action(async (runId, opts) => {
+    runs.command("events").description(getAgentCliCapabilityById("runs.events").description).argument("<runId>", "Run ID or short run ID").option("--cursor <cursor>", "Opaque total-order cursor returned in page.nextCursor").option("--after-seq <n>", "Legacy sequence-only cursor; prefer --cursor", "0").option("--limit <n>", "Maximum events to return", "200").option("--max-chars <n>", "Maximum payload preview characters per event", "1200").option("--full", "Include raw event payloads; unavailable through MCP").action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const params = new URLSearchParams({
           afterSeq: String(parseNonNegativeInteger(opts.afterSeq, 0)),
-          limit: String(parseLimit2(opts.limit, 200))
+          limit: String(parseLimit2(opts.limit, 200)),
+          maxChars: String(parseLimit2(opts.maxChars, 1200)),
+          projection: opts.full ? "full" : "compact"
         });
+        if (opts.cursor) params.set("cursor", opts.cursor);
         const page = await ctx.api.get(
           `/api/run-intelligence/runs/${encodeURIComponent(runId)}/events?${params}`
         );
@@ -14257,7 +14376,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    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").addHelpText("after", formatExamplesAndCautions({
+    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").option("--full", "Return raw lossless transcript entries; unavailable through MCP").addHelpText("after", formatExamplesAndCautions({
       examples: [
         {
           description: "Inspect the neighborhood around a failing step:",
@@ -14269,14 +14388,15 @@ function registerRunsCommands(program) {
         }
       ],
       cautions: [
-        "Human output is compact and clipped by default; use --json only when a script needs the full payload.",
+        "Human and JSON output use the same compact projection; --json changes encoding only.",
+        "Use --full only from a direct trusted CLI when lossless provider entries are required.",
         "Use --around-error from runs errors when investigating a failure instead of reading the entire run first."
       ]
     })).action(async (runId, opts) => {
       try {
         const ctx = resolveCommandContext(opts);
         const payload = await ctx.api.get(
-          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts, { json: ctx.json })}`
+          `/api/run-intelligence/runs/${encodeURIComponent(runId)}/transcript?${buildTranscriptQuery(opts)}`
         );
         if (ctx.json) {
           printOutput(payload, { json: true });
@@ -14291,7 +14411,7 @@ function registerRunsCommands(program) {
     })
   );
   addCommonClientOptions(
-    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").addHelpText("after", formatExamplesAndCautions({
+    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").option("--cursor <cursor>", "Cursor returned in page.nextCursor").addHelpText("after", formatExamplesAndCautions({
       examples: [
         {
           description: "Start failed-run investigation with error summaries:",
@@ -14311,6 +14431,7 @@ function registerRunsCommands(program) {
         const ctx = resolveCommandContext(opts);
         const params = new URLSearchParams();
         params.set("maxChars", String(parseLimit2(opts.maxChars, 1200)));
+        if (opts.cursor) params.set("cursor", opts.cursor);
         const payload = await ctx.api.get(
           `/api/run-intelligence/runs/${encodeURIComponent(runId)}/errors?${params.toString()}`
         );
@@ -14382,7 +14503,7 @@ function parseSkillEvidenceType(value) {
   if (normalized === "used" || normalized === "loaded") return normalized;
   throw new Error("--evidence must be either 'used' or 'loaded'.");
 }
-function buildTranscriptQuery(opts, output) {
+function buildTranscriptQuery(opts) {
   const params = new URLSearchParams();
   if (opts.errorsOnly) params.set("errorsOnly", "true");
   if (opts.aroundError) params.set("aroundError", opts.aroundError);
@@ -14390,8 +14511,8 @@ function buildTranscriptQuery(opts, output) {
   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("output", output.json ? "full" : "compact");
-  const includeOutputs = output.json || Boolean(opts.includeOutput || opts.includeOutputs || opts.narrative);
+  params.set("output", opts.full ? "full" : "compact");
+  const includeOutputs = Boolean(opts.full || 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();