@rudderhq/cli 0.2.1-canary.2 → 0.2.1-canary.4

package/README.md

@@ -8,8 +8,6 @@ Rudder began from a fork of an early version of Paperclip. That gave us a practi
 
 Rudder is built for the moment when agent work stops looking like a single prompt and starts looking like a real team.
 
-Current status: V1 is under active development. The current north-star metric is the weekly count of real agent-work loops completed end-to-end through Rudder.
-
 ## The Design Idea
 
 Rudder is shaped by a simple belief: the most useful way to work with agents is closer to the way humans coordinate with each other.

package/dist/index.js

@@ -117,6 +117,7 @@ var init_constants = __esm({
     CHAT_MESSAGE_ROLES = ["user", "assistant", "system"];
     CHAT_MESSAGE_KINDS = [
       "message",
+      "ask_user",
       "issue_proposal",
       "operation_proposal",
       "system_event"
@@ -579,7 +580,7 @@ var init_resource = __esm({
 
 // ../packages/shared/src/validators/chat.ts
 import { z as z5 } from "zod";
-var chatConversationStatusSchema, chatIssueCreationModeSchema, chatMessageRoleSchema, chatMessageKindSchema, chatMessageStatusSchema, chatContextEntityTypeSchema, createChatContextLinkSchema, createChatConversationSchema, setChatProjectContextSchema, updateChatConversationSchema, addChatMessageSchema, createChatAttachmentMetadataSchema, chatIssueProposalSchema, convertChatToIssueSchema, chatOperationProposalSchema, resolveChatOperationProposalSchema, updateChatConversationUserStateSchema;
+var chatConversationStatusSchema, chatIssueCreationModeSchema, chatMessageRoleSchema, chatMessageKindSchema, chatMessageStatusSchema, chatContextEntityTypeSchema, createChatContextLinkSchema, createChatConversationSchema, setChatProjectContextSchema, updateChatConversationSchema, addChatMessageSchema, chatRichReferenceDisplaySchema, chatIssueIdentifierSchema, chatAskUserIdentifierSchema, chatAskUserOptionSchema, chatAskUserQuestionSchema, chatAskUserRequestSchema, chatIssueRichReferenceSchema, chatIssueCommentRichReferenceSchema, chatRichReferenceSchema, chatRichReferencesSchema, createChatAttachmentMetadataSchema, chatIssueProposalSchema, convertChatToIssueSchema, chatOperationProposalSchema, resolveChatOperationProposalSchema, updateChatConversationUserStateSchema;
 var init_chat = __esm({
   "../packages/shared/src/validators/chat.ts"() {
     "use strict";
@@ -616,6 +617,47 @@ var init_chat = __esm({
       body: z5.string().trim().min(1).max(2e4),
       editUserMessageId: z5.string().uuid().optional().nullable()
     });
+    chatRichReferenceDisplaySchema = z5.enum(["card", "inline"]);
+    chatIssueIdentifierSchema = z5.string().trim().min(1).max(64).regex(/^[A-Z0-9][A-Z0-9-]*$/i);
+    chatAskUserIdentifierSchema = z5.string().trim().min(1).max(64).regex(/^[a-zA-Z0-9_-]+$/);
+    chatAskUserOptionSchema = z5.object({
+      id: chatAskUserIdentifierSchema,
+      label: z5.string().trim().min(1).max(80),
+      description: z5.string().trim().min(1).max(220).optional(),
+      recommended: z5.boolean().optional()
+    });
+    chatAskUserQuestionSchema = z5.object({
+      id: chatAskUserIdentifierSchema,
+      header: z5.string().trim().min(1).max(32).optional(),
+      question: z5.string().trim().min(1).max(240),
+      options: z5.array(chatAskUserOptionSchema).min(2).max(3),
+      allowFreeform: z5.boolean().optional()
+    });
+    chatAskUserRequestSchema = z5.object({
+      questions: z5.array(chatAskUserQuestionSchema).min(1).max(3)
+    });
+    chatIssueRichReferenceSchema = z5.object({
+      type: z5.literal("issue"),
+      issueId: z5.string().uuid().optional(),
+      identifier: chatIssueIdentifierSchema.optional(),
+      display: chatRichReferenceDisplaySchema.optional()
+    }).refine((value) => Boolean(value.issueId || value.identifier), {
+      message: "issueId or identifier is required"
+    });
+    chatIssueCommentRichReferenceSchema = z5.object({
+      type: z5.literal("issue_comment"),
+      issueId: z5.string().uuid().optional(),
+      identifier: chatIssueIdentifierSchema.optional(),
+      commentId: z5.string().uuid(),
+      display: chatRichReferenceDisplaySchema.optional()
+    }).refine((value) => Boolean(value.issueId || value.identifier), {
+      message: "issueId or identifier is required"
+    });
+    chatRichReferenceSchema = z5.union([
+      chatIssueRichReferenceSchema,
+      chatIssueCommentRichReferenceSchema
+    ]);
+    chatRichReferencesSchema = z5.array(chatRichReferenceSchema).max(5);
     createChatAttachmentMetadataSchema = z5.object({
       messageId: z5.string().uuid()
     });
@@ -2491,7 +2533,10 @@ var init_organization_skill_reference = __esm({
       "para-memory-files",
       "rudder",
       "rudder-create-agent",
-      "rudder-create-plugin"
+      "rudder-create-plugin",
+      "skill-creator",
+      "skill-optimizer",
+      "conversation-to-skill"
     ];
     RUDDER_BUNDLED_SKILL_KEYS = new Set(
       RUDDER_BUNDLED_SKILL_SLUGS.map((slug) => `rudder/${slug}`)
@@ -6133,6 +6178,70 @@ var DESKTOP_APP_NAME = "Rudder";
 var DESKTOP_METADATA_FILE = ".rudder-desktop-install.json";
 var DESKTOP_CHECKSUM_ASSET_NAME = "SHASUMS256.txt";
 var GITHUB_ASSET_DOWNLOAD_ACCEPT = "application/octet-stream";
+function normalizeProgressTotal(totalBytes) {
+  return typeof totalBytes === "number" && Number.isFinite(totalBytes) && totalBytes > 0 ? totalBytes : null;
+}
+function writeDesktopProgress(event) {
+  const payload = {
+    source: "rudder-desktop-update",
+    ...event,
+    at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  try {
+    process.stdout.write(`${JSON.stringify(payload)}
+`);
+  } catch (error) {
+    const code = typeof error === "object" && error && "code" in error ? String(error.code) : "";
+    if (code !== "EPIPE") throw error;
+  }
+}
+function desktopDownloadPhase(label) {
+  return label.toLowerCase().includes("shasums") ? "downloading_checksums" : "downloading_asset";
+}
+function createDesktopProgressFactory() {
+  return (label) => {
+    const phase = desktopDownloadPhase(label);
+    let latestReceivedBytes = 0;
+    let latestTotalBytes = null;
+    function emitByteProgress(message, receivedBytes, totalBytes) {
+      const total = normalizeProgressTotal(totalBytes);
+      writeDesktopProgress({
+        phase,
+        message,
+        transferredBytes: Math.max(0, receivedBytes),
+        ...total === null ? {} : {
+          totalBytes: total,
+          percent: Math.max(0, Math.min(100, Math.floor(Math.max(0, receivedBytes) / total * 100)))
+        }
+      });
+    }
+    return {
+      start(totalBytes) {
+        latestReceivedBytes = 0;
+        latestTotalBytes = totalBytes;
+        emitByteProgress(label, 0, totalBytes);
+      },
+      update(receivedBytes, totalBytes) {
+        latestReceivedBytes = receivedBytes;
+        latestTotalBytes = totalBytes;
+        emitByteProgress(label, receivedBytes, totalBytes);
+      },
+      finish(receivedBytes = latestReceivedBytes, totalBytes = latestTotalBytes) {
+        latestReceivedBytes = receivedBytes;
+        latestTotalBytes = totalBytes;
+        emitByteProgress(`${label} complete`, receivedBytes, totalBytes);
+      },
+      fail() {
+        writeDesktopProgress({
+          phase,
+          message: `${label} failed`,
+          transferredBytes: Math.max(0, latestReceivedBytes),
+          error: `${label} failed`
+        });
+      }
+    };
+  };
+}
 function resolveCurrentCliVersion(env = process.env) {
   const version = resolveCliVersion(import.meta.url, env);
   return version === "0.0.0" ? "latest" : version;
@@ -6685,15 +6794,28 @@ async function writeInstallMetadata(paths, releaseTag, assetName, assetChecksum)
   await writeFile2(paths.metadataPath, `${JSON.stringify(metadata, null, 2)}
 `, "utf8");
 }
-async function runStartPhase(message, successMessage, task) {
+async function runStartPhase(message, successMessage, task, progressPhase) {
+  if (progressPhase) {
+    writeDesktopProgress({ phase: progressPhase, message });
+  }
   const spinner3 = p13.spinner();
   spinner3.start(message);
   try {
     const result = await task();
     spinner3.stop(successMessage);
+    if (progressPhase) {
+      writeDesktopProgress({ phase: progressPhase, message: successMessage });
+    }
     return result;
   } catch (error) {
     spinner3.stop(pc8.red(`${message} failed.`));
+    if (progressPhase) {
+      writeDesktopProgress({
+        phase: "failed",
+        message: `${message} failed.`,
+        error: error instanceof Error ? error.message : String(error)
+      });
+    }
     throw error;
   }
 }
@@ -6704,6 +6826,12 @@ async function startCommand(opts) {
   const repo = opts.repo?.trim() || DEFAULT_DESKTOP_RELEASE_REPO;
   const version = opts.targetVersion?.trim() || opts.version?.trim() || resolveCurrentCliVersion();
   const dryRun = opts.dryRun === true;
+  const desktopProgressJson = opts.desktopProgressJson === true;
+  if (desktopProgressJson) {
+    process.stdout.on("error", (error) => {
+      if (error.code !== "EPIPE") throw error;
+    });
+  }
   if (!installCli && !installDesktop && !installRuntime) {
     throw new Error("Nothing to start. Remove --no-cli, --no-runtime, or --no-desktop.");
   }
@@ -6777,13 +6905,14 @@ async function startCommand(opts) {
       return;
     }
     const directReleaseVersion = resolveDesktopReleaseVersion(tag);
-    const progressFactory = createByteProgress;
+    const progressFactory = desktopProgressJson ? createDesktopProgressFactory() : createByteProgress;
     let release = null;
     try {
       release = await runStartPhase(
         "Resolving Desktop release...",
         "Desktop release resolved.",
-        () => fetchGithubRelease(repo, tag)
+        () => fetchGithubRelease(repo, tag),
+        desktopProgressJson ? "resolving_release" : null
       );
     } catch (error) {
       if (!directReleaseVersion) throw error;
@@ -6811,24 +6940,28 @@ async function startCommand(opts) {
         async () => {
           await removeMacQuarantine(installPaths, target);
           await createPlatformLaunchers(installPaths, target);
-        }
+        },
+        desktopProgressJson ? "preparing_restart" : null
       );
     } else {
       const installerPath = await downloadAsset(asset, outputDir, progressFactory);
       const checksum = await runStartPhase(
         "Verifying Desktop checksum...",
         `Verified ${pc8.cyan(path11.basename(installerPath))}.`,
-        () => assertChecksumMatch(installerPath, expectedChecksum)
+        () => assertChecksumMatch(installerPath, expectedChecksum),
+        desktopProgressJson ? "verifying_checksum" : null
       );
       await runStartPhase(
         "Replacing existing Rudder Desktop if needed...",
         "Existing Desktop install is ready for replacement.",
-        () => prepareForDesktopReplace(installPaths, target, { waitForActiveRuns: opts.waitForActiveRuns === true })
+        () => prepareForDesktopReplace(installPaths, target, { waitForActiveRuns: opts.waitForActiveRuns === true }),
+        desktopProgressJson ? opts.waitForActiveRuns === true ? "waiting_for_active_runs" : "preparing_restart" : null
       );
       await runStartPhase(
         "Installing portable Desktop app...",
         `Installed Rudder Desktop to ${pc8.cyan(installPaths.appPath)}.`,
-        () => installPortableDesktop(installerPath, installPaths, target)
+        () => installPortableDesktop(installerPath, installPaths, target),
+        desktopProgressJson ? "preparing_restart" : null
       );
       await runStartPhase(
         "Preparing Desktop launchers...",
@@ -6836,7 +6969,8 @@ async function startCommand(opts) {
         async () => {
           await removeMacQuarantine(installPaths, target);
           await createPlatformLaunchers(installPaths, target);
-        }
+        },
+        desktopProgressJson ? "preparing_restart" : null
       );
       await writeInstallMetadata(installPaths, releaseTag, asset.name, checksum);
     }
@@ -6844,7 +6978,8 @@ async function startCommand(opts) {
       await runStartPhase(
         "Launching Rudder Desktop...",
         "Rudder Desktop launched.",
-        () => launchDesktop(installPaths, target)
+        () => launchDesktop(installPaths, target),
+        desktopProgressJson ? "closing" : null
       );
     }
   }
@@ -11399,7 +11534,7 @@ function createProgram() {
     });
     loadRudderEnvFile(options.config);
   });
-  program.command("start").description("Start Rudder Desktop and prepare the matching persistent CLI").option("--no-cli", "Skip persistent CLI installation").option("--no-runtime", "Skip Rudder runtime installation").option("--no-desktop", "Skip desktop app installation").option("--version <version>", "Rudder version to start (default: current CLI version)").option("--target-version <version>", "Rudder version to start; avoids the root CLI version flag").option("--repo <owner/repo>", "GitHub repository that hosts desktop releases").option("--output-dir <path>", "Directory for downloaded desktop release assets").option("--desktop-install-dir <path>", "Directory for the portable Desktop install").option("--no-open", "Install Desktop without launching it").option("--wait-for-active-runs", "Wait for active Rudder runs to finish before replacing Desktop", false).option("--no-version-check", "Skip checking npm for a newer Rudder CLI version").option("--dry-run", "Print the start actions without changing the machine", false).action(startCommand);
+  program.command("start").description("Start Rudder Desktop and prepare the matching persistent CLI").option("--no-cli", "Skip persistent CLI installation").option("--no-runtime", "Skip Rudder runtime installation").option("--no-desktop", "Skip desktop app installation").option("--version <version>", "Rudder version to start (default: current CLI version)").option("--target-version <version>", "Rudder version to start; avoids the root CLI version flag").option("--repo <owner/repo>", "GitHub repository that hosts desktop releases").option("--output-dir <path>", "Directory for downloaded desktop release assets").option("--desktop-install-dir <path>", "Directory for the portable Desktop install").option("--no-open", "Install Desktop without launching it").option("--wait-for-active-runs", "Wait for active Rudder runs to finish before replacing Desktop", false).option("--desktop-progress-json", "Emit newline-delimited Desktop update progress events").option("--no-version-check", "Skip checking npm for a newer Rudder CLI version").option("--dry-run", "Print the start actions without changing the machine", false).action(startCommand);
   program.command("onboard").description("Interactive first-run setup wizard").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("-y, --yes", "Accept defaults (quickstart + start immediately)", false).option("--run", "Start Rudder immediately after saving config", false).action(onboard);
   program.command("doctor").description("Run diagnostic checks on your Rudder setup").option("-c, --config <path>", "Path to config file").option("-d, --data-dir <path>", DATA_DIR_OPTION_HELP).option("--repair", "Attempt to repair issues automatically").alias("--fix").option("-y, --yes", "Skip repair confirmation prompts").action(async (opts) => {
     await doctor(opts);