@rudderhq/cli 0.7.16 → 0.7.18

package/dist/index.js

@@ -21223,8 +21223,7 @@ var init_plugin_v1 = __esm({
     inspectRudderPluginArchiveSchema = z36.object({
       sourceLabel: z36.string().trim().min(1).max(240),
       filename: z36.string().trim().min(1).max(240).refine((value) => /\.zip$/i.test(value), "Only ZIP Plugin archives are supported"),
-      // 100 MiB binary package ceiling plus base64 expansion.
-      content: z36.string().min(1).max(14e7),
+      content: z36.string().min(1).max(14e6),
       encoding: z36.literal("base64")
     }).strict();
     configureRudderPluginMarketplaceSchema = z36.object({
@@ -28031,7 +28030,7 @@ var IssueTransportBudget = class {
           });
           return { filePath, scope, surface: this.surface, attempt: "fallback" };
         }
-        throw issueTransportUnavailable(state, now);
+        throw issueTransportUnavailable(state, now, scope);
       });
     } catch (error) {
       if (error instanceof ApiRequestError) throw error;
@@ -28067,7 +28066,8 @@ var IssueTransportBudget = class {
         expiresAt: now + this.backoffMs
       };
       await writeState(reservation.filePath, state);
-      attachTransportDiagnostic(error, state, now);
+      attachTransportDiagnostic(error, state, now, reservation.scope);
+      appendFallbackGuidance(error, state, reservation.scope);
       if (budgetExhausted) {
         error.code = "issue_transport_unavailable";
         error.message = "Issue transport unavailable";
@@ -28109,7 +28109,7 @@ var IssueTransportBudget = class {
 };
 function issueTransportScope(method, requestPath) {
   const normalizedMethod = String(method ?? "GET").toUpperCase();
-  const pathname = requestPath.split("?", 1)[0] ?? "";
+  const [pathname, queryString] = requestPath.split("?", 2);
   const match = /^\/api\/issues\/([^/]+)(?:\/(heartbeat-context|comments)(?:\/([^/]+))?)?$/.exec(pathname);
   if (!match) return null;
   const issueId = decodeURIComponent(match[1] ?? "");
@@ -28121,7 +28121,13 @@ function issueTransportScope(method, requestPath) {
   if (normalizedMethod === "GET" && resource === "comments" && !commentId) operation = "issue.comments.list";
   if (normalizedMethod === "GET" && resource === "comments" && commentId) operation = "issue.comments.get";
   if (normalizedMethod === "POST" && resource === "comments" && !commentId) operation = "issue.comment";
-  return operation ? { operation, issueId } : null;
+  if (!operation) return null;
+  const query = new URLSearchParams(queryString ?? "");
+  return {
+    operation,
+    issueId,
+    fallbackCommand: buildCliFallbackCommand(operation, issueId, commentId, query)
+  };
 }
 function buildFingerprint(scope, error) {
   const normalizedMessage = error.message.trim().replace(/\s+/g, " ").toLowerCase().slice(0, 256);
@@ -28134,24 +28140,34 @@ function buildFingerprint(scope, error) {
     normalizedMessage
   };
 }
-function issueTransportUnavailable(state, now) {
-  const details = { issueTransport: transportDiagnostic(state, now) };
+function issueTransportUnavailable(state, now, requestScope = state) {
+  const details = { issueTransport: transportDiagnostic(state, now, requestScope) };
   return new ApiRequestError(
     503,
-    state.phase === "fallback_in_flight" ? "Issue transport probe already in flight" : "Issue transport unavailable",
+    issueTransportErrorMessage(state, requestScope),
     details,
     { error: "Issue transport unavailable", code: "issue_transport_unavailable", details },
     "issue_transport_unavailable"
   );
 }
-function attachTransportDiagnostic(error, state, now) {
+function attachTransportDiagnostic(error, state, now, requestScope = state) {
   const upstreamDetails = error.details;
   error.details = {
     ...isRecord2(upstreamDetails) ? upstreamDetails : upstreamDetails === void 0 ? {} : { upstreamDetails },
-    issueTransport: transportDiagnostic(state, now)
+    issueTransport: transportDiagnostic(state, now, requestScope)
   };
 }
-function transportDiagnostic(state, now) {
+function appendFallbackGuidance(error, state, requestScope) {
+  const fallback = issueTransportFallbackAction(state, requestScope);
+  if (!fallback) return;
+  error.message = `${error.message}; use the equivalent ${fallbackSurfaceLabel(fallback.surface)} fallback once: ${fallbackTarget(fallback)}`;
+}
+function issueTransportErrorMessage(state, requestScope = state) {
+  const base = state.phase === "fallback_in_flight" ? "Issue transport probe already in flight" : "Issue transport unavailable";
+  const fallback = issueTransportFallbackAction(state, requestScope);
+  return fallback ? `${base}; use the equivalent ${fallbackSurfaceLabel(fallback.surface)} fallback once: ${fallbackTarget(fallback)}` : base;
+}
+function transportDiagnostic(state, now, requestScope = state) {
   return {
     state: state.phase,
     fingerprint: state.failure?.fingerprint ?? null,
@@ -28164,10 +28180,65 @@ function transportDiagnostic(state, now) {
     fallbackSurface: state.fallbackSurface ?? null,
     fallbackMatchedFingerprint: state.fallbackMatchedFingerprint ?? null,
     fallbackBudgetRemaining: state.phase === "fallback_available" ? 1 : 0,
+    fallbackAction: issueTransportFallbackAction(state, requestScope),
     retryAfterMs: Math.max(0, state.expiresAt - now),
     checkpoint: "Issue transport unavailable"
   };
 }
+function issueTransportFallbackAction(state, requestScope = state) {
+  if (state.phase !== "fallback_available") return null;
+  if (state.initialSurface === "mcp") {
+    return {
+      surface: "cli",
+      command: requestScope.fallbackCommand ?? state.fallbackCommand ?? buildCliFallbackCommand(state.operation, state.issueId, void 0, new URLSearchParams())
+    };
+  }
+  return {
+    surface: "mcp",
+    tool: mcpToolNameForOperation(state.operation)
+  };
+}
+function fallbackSurfaceLabel(surface) {
+  return surface === "cli" ? "Rudder CLI" : "Rudder MCP";
+}
+function fallbackTarget(fallback) {
+  return fallback.command ?? fallback.tool ?? "the alternate Rudder transport";
+}
+function mcpToolNameForOperation(operation) {
+  return `rudder_${operation.replace(/\./g, "_")}`;
+}
+function buildCliFallbackCommand(operation, issueId, commentId, query) {
+  const issue = shellQuote(issueId);
+  switch (operation) {
+    case "issue.get":
+      return `rudder issue get ${issue} --json`;
+    case "issue.context": {
+      const command = [`rudder issue context ${issue}`];
+      appendCliOption(command, "--wake-comment-id", query.get("wakeCommentId"));
+      return `${command.join(" ")} --json`;
+    }
+    case "issue.comments.list": {
+      const command = [`rudder issue comments list ${issue}`];
+      appendCliOption(command, "--after", query.get("after"));
+      appendCliOption(command, "--order", query.get("order"));
+      return `${command.join(" ")} --json`;
+    }
+    case "issue.comments.get":
+      return `rudder issue comments get ${issue} ${shellQuote(commentId ?? "<comment-id>")} --json`;
+    case "issue.comment":
+      return `rudder issue comment ${issue} --body-file ./issue-comment.md --json`;
+    default:
+      return `rudder issue ${shellQuote(operation)} ${issue} --json`;
+  }
+}
+function appendCliOption(command, option, value) {
+  if (value === null || value.trim().length === 0) return;
+  command.push(option, shellQuote(value));
+}
+function shellQuote(value) {
+  if (/^[A-Za-z0-9_./:-]+$/.test(value)) return value;
+  return `'${value.replace(/'/g, "'\\''")}'`;
+}
 async function readState(filePath) {
   try {
     const parsed = JSON.parse(await fs.readFile(filePath, "utf8"));
@@ -30720,7 +30791,7 @@ function jsonSchemaViolation(value, schema) {
   }
   const types = Array.isArray(schema.type) ? schema.type : schema.type === void 0 ? [] : [schema.type];
   if (types.length > 0) {
-    const validType = types.some((type) => type === "string" ? typeof value === "string" : type === "number" ? typeof value === "number" && Number.isFinite(value) : type === "boolean" ? typeof value === "boolean" : type === "array" ? Array.isArray(value) : type === "object" ? isRecord3(value) : type === "null" ? value === null : false);
+    const validType = types.some((type) => type === "string" ? typeof value === "string" : type === "number" ? typeof value === "number" && Number.isFinite(value) : type === "boolean" ? typeof value === "boolean" : type === "array" ? Array.isArray(value) : type === "object" ? isRecord3(value) : false);
     if (!validType) return `must be ${types.join(" or ")}`;
   }
   if (typeof value === "string") {
@@ -30758,9 +30829,6 @@ function jsonSchemaViolation(value, schema) {
     }
   }
   if (isRecord3(value) && schema.type === "object") {
-    if (typeof schema.minProperties === "number" && Object.keys(value).length < schema.minProperties) {
-      return `must contain at least ${schema.minProperties} properties`;
-    }
     const properties = isRecord3(schema.properties) ? schema.properties : {};
     const required = Array.isArray(schema.required) ? schema.required.map(String) : [];
     for (const key of required) {
@@ -31414,17 +31482,21 @@ Reason: {{context.passiveFollowup.reason}}
 Before changing the issue, continue to progress the current issue, then inspect the current issue state and any side effects from the previous run. Finally, do exactly one close-out action: add a progress comment, mark the issue done, block it with a reason, or hand it off explicitly with explanation.
 ${ISSUE_ASSIGNEE_EXECUTION_RAIL}`;
 var RUDDER_AGENT_OPERATING_CONTRACT = [
-  "You are a helpful assistant running inside Rudder. Your home directory is `$AGENT_HOME`. Everything personal to you -- life, memory, knowledge -- lives there. Other agents may have their own folders and you may update them when necessary.",
+  "You are a helpful assistant running inside Rudder. Your home directory is `$AGENT_HOME`. Everything personal to you -- life, memory, knowledge -- lives there. Every agent has its own folders and you may update them when necessary.",
   "",
-  "Read Rudder mcp tools to firstly.",
-  "Use these paths consistently:",
+  "## Basic Rules",
+  "- If you want to perform any Rudder-related operation such as issue, chat, agent run, automation, or projects, you can use rudder-mcp.",
+  "- When working in an issue, the only scenario for user feedback and communication is via issue comments. Whenever there is progress, changes, or responses, always post an issue comment. Users do not see the entire trajectory of your agent run by default.",
+  "- Another scenario is when you need to request something from the user. In such cases, use a request approval to seek the user's assistance.",
+  "- Before taking action, deeply analyze and research the existing information to ensure you have comprehensive context information before proceeding with the next action. You have your own goal, memory, skills, automation, library, project, org, use these resources to make better decisions.",
+  "- When the user explicitly mentions previously handled issue, tasks or conversations, retrieve the relevant tasks first before proceeding with the next action.",
   "",
+  "## Basic Paths",
   "- Your personal instructions live under `$AGENT_HOME/instructions`.",
   "- Personal memory lives under `$AGENT_HOME/memory`.",
   "- Tacit memory instruction lives at `$AGENT_HOME/instructions/MEMORY.md` and is automatically loaded when present.",
   "- Personal skills live under `$AGENT_HOME/skills`.",
-  "- Shared organization workspace root lives under `$RUDDER_ORG_WORKSPACE_ROOT`.",
-  "- Shared organization skills live under `$RUDDER_ORG_SKILLS_DIR`.",
+  "- Shared organization workspace root lives under `$RUDDER_ORG_WORKSPACE_ROOT` and shared org's skills live under `$RUDDER_ORG_SKILLS_DIR`.",
   "- Project Library root lives under `$RUDDER_PROJECT_LIBRARY_ROOT` when the run has project context.",
   "- Project Library locator lives in `$RUDDER_PROJECT_LIBRARY_PATH` when the run has project context, for example `projects/<project-key>`.",
   '- Library-backed project resources use `sourceType: "library"`; their `locator` points into `library:projects/<project-key>/`.',
@@ -31440,11 +31512,8 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "When you create or copy a skill under `$AGENT_HOME/skills/<slug>/`, check the agent's Skills snapshot before claiming it will load in future runs. If it is installed but not enabled, say exactly that future runs will not load it until enabled, and offer to enable it with `rudder agent skills enable <agent-id> <selection-ref>` when you have permission.",
   "If there is an AGENTS.md file in the project you're working on, please read it first and follow the project's development guidelines.",
   "",
-  "When you write issue comments or chat replies, match the language of the user's or board's most recent substantive message unless they explicitly ask for a different language.",
-  "When you mention a web page, issue URL, external dashboard, or other user-openable target in an issue comment or chat reply, write it as a clickable Markdown link with a descriptive label, for example `[NameSilo transfer page](https://www.namesilo.com/account_domain_manage_transfer.php)`. Do not put action URLs in backticks or code blocks unless you are showing literal code or a command.",
   "",
   "## Rudder Renderable Links",
-  "",
   "When you mention Rudder entities in any user-visible Markdown output, prefer Rudder's renderable Markdown link syntax over plain IDs, bare URLs, or backticked references so the UI can render chips and navigate correctly.",
   "",
   "- Issues: use `[](issue://<issue-id>)`; include `?c=<comment-id>` when linking to a specific comment.",
@@ -31454,6 +31523,7 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "- Chat threads: use `[](chat://<conversation-id>)` when citing a Rudder chat conversation.",
   "- Skills: use `[](skill://<skill-ref>)` when citing a Rudder skill reference. The skill ref may be an org skill, agent skill, bundled Rudder skill, or local-machine skill ref; the UI resolves the display label when metadata is available.",
   '- Library files: use the `markdownLink` returned by `rudder library file ref "$RUDDER_PROJECT_LIBRARY_PATH/<relative-file>" --json` with project context, or `rudder library file ref "artifacts/YYYY-MM-DD/<conversation-title>/<relative-file>" --json` without project context; do not hand-write `library-entry://...` links, and treat `library-file://...` as legacy path syntax only.',
+  "- Web page, issue URL, external dashboard, or other user-openable target: write it as a clickable Markdown link with a descriptive label, eg: [NameSilo transfer page](https://www.namesilo.com/account_domain_manage_transfer.php). Do not put action URLs in backticks or code blocks unless you are showing literal code or a command.",
   "",
   "Write these as normal Markdown links, not inside code spans or code blocks, unless you are literally documenting the syntax.",
   "",
@@ -31471,13 +31541,9 @@ var RUDDER_AGENT_OPERATING_CONTRACT = [
   "",
   "You MUST use the `para-memory-files` skill for all memory operations: storing facts, writing daily notes, creating entities, running weekly synthesis, recalling past context, and managing shared work notes. The skill defines your three-layer memory system (knowledge graph, daily notes, tacit knowledge), the PARA folder structure, atomic fact schemas, memory decay rules, and recall conventions.",
   "",
-  "Keep stable preferences and operating lessons in `$AGENT_HOME/instructions/MEMORY.md`. Use `$AGENT_HOME/memory/YYYY-MM-DD.md` for daily notes and `$AGENT_HOME/life/` for structured long-term memory. Rudder injects bounded today/yesterday daily-memory excerpts in the startup context bundle; open the files directly when you need full detail.",
-  "",
-  "Invoke it whenever you need to remember, retrieve, or organize anything.",
+  "Keep stable preferences and operating lessons in `$AGENT_HOME/instructions/MEMORY.md`. Use `$AGENT_HOME/memory/YYYY-MM-DD.md` for daily notes and `$AGENT_HOME/life/` for structured long-term memory. ",
   "",
-  "## Other",
-  "- Before taking action, deeply analyze and research the existing information to ensure you have comprehensive context information before proceeding with the next action. You have your own goal, memory, skills, automation, library, project, org, use these resources to make better decisions.",
-  "- When the user explicitly mentions previously handled issue, tasks or conversations, you need to retrieve the relevant tasks first before proceeding with the next action."
+  "Invoke it whenever you need to remember, retrieve, or organize anything."
 ].join("\n");
 var RUDDER_AGENT_HEARTBEAT_INSTRUCTION = [
   "This section is injected by Rudder only for heartbeat scene runs. It is the platform-owned heartbeat/self-check pipeline.",
@@ -38275,6 +38341,11 @@ function findDesktopExecutablePids(executablePath, target) {
     return matchesExecutable && pid !== process.pid ? [pid] : [];
   });
 }
+function desktopApplicationEnvironment() {
+  const env = { ...process.env };
+  delete env.ELECTRON_RUN_AS_NODE;
+  return env;
+}
 async function waitForUpdateQuitResponse(responsePath, timeoutMs = 8e3) {
   const startedAt = Date.now();
   while (Date.now() - startedAt < timeoutMs) {
@@ -38292,6 +38363,7 @@ async function requestDesktopQuit(executablePath, target, options = {}) {
     `${DESKTOP_UPDATE_QUIT_ARG}=${responsePath}`,
     ...options.forceUpdate ? [DESKTOP_UPDATE_FORCE_ARG] : []
   ], {
+    env: desktopApplicationEnvironment(),
     stdio: "ignore",
     timeout: 5e3
   });
@@ -38917,12 +38989,12 @@ async function startCommand(opts) {
         let applySignal = null;
         let applySignalController = null;
         if (desktopProgressJson && opts.desktopWaitForApply === true) {
+          applySignalController = createDesktopApplySignalController();
           writeDesktopProgress({
             phase: "ready_to_install",
             message: "Desktop update is downloaded and verified.",
             percent: 100
           });
-          applySignalController = createDesktopApplySignalController();
           applySignal = await applySignalController.waitForInitialSignal();
           writeDesktopProgress({
             phase: "preparing_restart",