@mindstudio-ai/agent 0.0.16 → 0.0.17

package/README.md

@@ -46,8 +46,8 @@ Every method is fully typed — your editor will autocomplete available paramete
 ### CLI
 
 ```bash
-# Set your API key
-export MINDSTUDIO_API_KEY=your-api-key
+# Authenticate (opens browser, saves key locally)
+mindstudio login
 
 # Execute a step with named flags
 mindstudio generate-image --prompt "A mountain landscape at sunset"
@@ -96,9 +96,15 @@ All 120+ step methods are exposed as MCP tools with full JSON Schema input defin
 
 ## Authentication
 
-The SDK supports two authentication modes:
+The fastest way to authenticate is the interactive login:
 
-**API Key** — for external apps, scripts, and CLI usage:
+```bash
+mindstudio login
+```
+
+This opens your browser, authenticates with MindStudio, and saves your API key to `~/.mindstudio/config.json`. All subsequent CLI and SDK usage will pick it up automatically.
+
+You can also authenticate via environment variable or constructor parameter:
 
 ```typescript
 // Pass directly
@@ -109,15 +115,19 @@ const agent = new MindStudioAgent({ apiKey: 'your-api-key' });
 const agent = new MindStudioAgent();
 ```
 
-**Managed mode** — automatically available inside MindStudio custom functions:
+MindStudio routes to the correct AI provider (OpenAI, Google, Anthropic, etc.) server-side — you do not need separate provider API keys.
 
-```typescript
-// Inside a MindStudio custom function, auth and base URL are automatic
-// (CALLBACK_TOKEN and REMOTE_HOSTNAME are set by the runtime)
-const agent = new MindStudioAgent();
+Other auth commands:
+
+```bash
+# Check current auth status and verify credentials
+mindstudio whoami
+
+# Clear stored credentials
+mindstudio logout
 ```
 
-Resolution order: constructor `apiKey` > `MINDSTUDIO_API_KEY` env > `CALLBACK_TOKEN` env.
+Resolution order: constructor `apiKey` > `MINDSTUDIO_API_KEY` env > `~/.mindstudio/config.json` > `CALLBACK_TOKEN` env.
 
 ## Thread persistence
 
@@ -248,7 +258,7 @@ const { services } = await agent.listConnectors();
 
 ```typescript
 const agent = new MindStudioAgent({
-  // API key (or set MINDSTUDIO_API_KEY env var)
+  // API key (or set MINDSTUDIO_API_KEY env var, or run `mindstudio login`)
   apiKey: 'your-api-key',
 
   // Base URL (or set MINDSTUDIO_BASE_URL env var)
@@ -322,6 +332,9 @@ import { blockTypeAliases } from '@mindstudio-ai/agent';
 Usage: mindstudio <command | method> [options]
 
 Commands:
+  login                            Authenticate with MindStudio (opens browser)
+  logout                           Clear stored credentials
+  whoami                           Show current authentication status
   <method> [json | --flags]        Execute a step method
   exec <method> [json | --flags]   Execute a step method (same as above)
   list [--json]                    List available methods

package/dist/cli.js

@@ -845,9 +845,9 @@ var init_metadata = __esm({
       },
       "sendSMS": {
         stepType: "sendSMS",
-        description: "Send an SMS text message to a phone number configured via OAuth connection.",
-        usageNotes: "- User is responsible for configuring the connection to the number (MindStudio requires double opt-in to prevent spam)",
-        inputSchema: { "type": "object", "properties": { "body": { "type": "string", "description": "SMS message body text" }, "connectionId": { "type": "string", "description": "OAuth connection ID for the recipient phone number" } }, "required": ["body"] },
+        description: "Send an SMS or MMS message to a phone number configured via OAuth connection.",
+        usageNotes: "- User is responsible for configuring the connection to the number (MindStudio requires double opt-in to prevent spam)\n- If mediaUrls are provided, the message is sent as MMS instead of SMS\n- MMS supports up to 10 media URLs (images, video, audio, PDF) with a 5MB limit per file\n- MMS is only supported on US and Canadian carriers; international numbers will receive SMS only (media silently dropped)",
+        inputSchema: { "type": "object", "properties": { "body": { "type": "string", "description": "SMS message body text" }, "connectionId": { "type": "string", "description": "OAuth connection ID for the recipient phone number" }, "mediaUrls": { "type": "array", "items": { "type": "string" }, "description": "Optional array of media URLs to send as MMS (up to 10, 5MB each)" } }, "required": ["body"] },
         outputSchema: { "description": "This step does not produce output data." }
       },
       "setRunTitle": {
@@ -864,6 +864,20 @@ var init_metadata = __esm({
         inputSchema: { "type": "object", "properties": { "value": { "anyOf": [{ "type": "string" }, { "type": "array", "items": { "type": "string" } }] } }, "required": ["value"], "description": "Configuration for the set variable step" },
         outputSchema: { "type": "object" }
       },
+      "telegramEditMessage": {
+        stepType: "telegramEditMessage",
+        description: "Edit a previously sent Telegram message. Use with the message ID returned by Send Telegram Message.",
+        usageNotes: '- Only text messages sent by the bot can be edited.\n- The messageId is returned by the Send Telegram Message step.\n- Common pattern: send a "Processing..." message, do work, then edit it with the result.',
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID containing the message" }, "messageId": { "type": "string", "description": "ID of the message to edit" }, "text": { "type": "string", "description": "New message text (MarkdownV2 formatting supported)" } }, "required": ["botToken", "chatId", "messageId", "text"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "telegramReplyToMessage": {
+        stepType: "telegramReplyToMessage",
+        description: "Send a reply to a specific Telegram message. The reply will be visually threaded in the chat.",
+        usageNotes: "- Use the rawMessage.message_id from the incoming trigger variables to reply to the user's message.\n- Especially useful in group chats where replies provide context.\n- Returns the sent message ID, which can be used with Edit Telegram Message.",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the reply to" }, "replyToMessageId": { "type": "string", "description": "ID of the message to reply to" }, "text": { "type": "string", "description": "Reply text (MarkdownV2 formatting supported)" } }, "required": ["botToken", "chatId", "replyToMessageId", "text"] },
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "number", "description": "ID of the sent reply message" } }, "required": ["messageId"] }
+      },
       "telegramSendAudio": {
         stepType: "telegramSendAudio",
         description: "Send an audio file to a Telegram chat as music or a voice note via a bot.",
@@ -888,9 +902,9 @@ var init_metadata = __esm({
       "telegramSendMessage": {
         stepType: "telegramSendMessage",
         description: "Send a text message to a Telegram chat via a bot.",
-        usageNotes: '- Messages are sent using MarkdownV2 formatting. Special characters are auto-escaped.\n- botToken format is "botId:token" \u2014 both parts are required.',
+        usageNotes: '- Messages are sent using MarkdownV2 formatting. Special characters are auto-escaped.\n- botToken format is "botId:token" \u2014 both parts are required.\n- Returns the sent message ID, which can be used with Edit Telegram Message to update the message later.',
         inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": 'Telegram bot token in "botId:token" format' }, "chatId": { "type": "string", "description": "Telegram chat ID to send the message to" }, "text": { "type": "string", "description": "Message text to send (MarkdownV2 formatting supported)" } }, "required": ["botToken", "chatId", "text"] },
-        outputSchema: { "description": "This step does not produce output data." }
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "number", "description": "ID of the sent Telegram message" } }, "required": ["messageId"] }
       },
       "telegramSendVideo": {
         stepType: "telegramSendVideo",
@@ -1159,6 +1173,48 @@ var init_rate_limit = __esm({
   }
 });
 
+// src/config.ts
+var config_exports = {};
+__export(config_exports, {
+  clearConfig: () => clearConfig,
+  getConfigPath: () => getConfigPath,
+  loadConfig: () => loadConfig,
+  saveConfig: () => saveConfig
+});
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function getConfigPath() {
+  return CONFIG_PATH;
+}
+function loadConfig() {
+  try {
+    const raw = readFileSync(CONFIG_PATH, "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+function saveConfig(config) {
+  mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(
+    CONFIG_PATH,
+    JSON.stringify(config, null, 2) + "\n",
+    "utf-8"
+  );
+}
+function clearConfig() {
+  saveConfig({});
+}
+var CONFIG_DIR, CONFIG_PATH;
+var init_config = __esm({
+  "src/config.ts"() {
+    "use strict";
+    CONFIG_DIR = join(homedir(), ".mindstudio");
+    CONFIG_PATH = join(CONFIG_DIR, "config.json");
+  }
+});
+
 // src/generated/steps.ts
 var steps_exports = {};
 __export(steps_exports, {
@@ -1520,6 +1576,12 @@ function applyStepMethods(AgentClass) {
   proto.setVariable = function(step, options) {
     return this.executeStep("setVariable", step, options);
   };
+  proto.telegramEditMessage = function(step, options) {
+    return this.executeStep("telegramEditMessage", step, options);
+  };
+  proto.telegramReplyToMessage = function(step, options) {
+    return this.executeStep("telegramReplyToMessage", step, options);
+  };
   proto.telegramSendAudio = function(step, options) {
     return this.executeStep("telegramSendAudio", step, options);
   };
@@ -1624,14 +1686,16 @@ __export(client_exports, {
 function sleep2(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function resolveToken(provided) {
+function resolveToken(provided, config) {
   if (provided) return { token: provided, authType: "apiKey" };
   if (process.env.MINDSTUDIO_API_KEY)
     return { token: process.env.MINDSTUDIO_API_KEY, authType: "apiKey" };
+  if (config?.apiKey)
+    return { token: config.apiKey, authType: "apiKey" };
   if (process.env.CALLBACK_TOKEN)
     return { token: process.env.CALLBACK_TOKEN, authType: "internal" };
   throw new MindStudioError(
-    "No API key provided. Pass `apiKey` to the MindStudioAgent constructor, or set the MINDSTUDIO_API_KEY environment variable.",
+    "No API key provided. Run `mindstudio login`, pass `apiKey` to the constructor, or set the MINDSTUDIO_API_KEY environment variable.",
     "missing_api_key",
     401
   );
@@ -1643,6 +1707,7 @@ var init_client = __esm({
     init_http();
     init_errors();
     init_rate_limit();
+    init_config();
     init_steps();
     init_helpers();
     DEFAULT_BASE_URL = "https://v1.mindstudio-api.com";
@@ -1655,8 +1720,9 @@ var init_client = __esm({
       /** @internal */
       _threadId;
       constructor(options = {}) {
-        const { token, authType } = resolveToken(options.apiKey);
-        const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? DEFAULT_BASE_URL;
+        const config = loadConfig();
+        const { token, authType } = resolveToken(options.apiKey, config);
+        const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? config.baseUrl ?? DEFAULT_BASE_URL;
         this._reuseThreadId = options.reuseThreadId ?? /^(true|1)$/i.test(process.env.MINDSTUDIO_REUSE_THREAD_ID ?? "");
         this._httpConfig = {
           baseUrl,
@@ -1858,7 +1924,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.0.16"
+            version: "0.0.17"
           }
         });
         break;
@@ -2024,9 +2090,13 @@ var init_mcp = __esm({
 
 // src/cli.ts
 import { parseArgs } from "util";
+import { execSync } from "child_process";
 var HELP = `Usage: mindstudio <command | method> [options]
 
 Commands:
+  login                       Authenticate with MindStudio (opens browser)
+  logout                      Clear stored credentials
+  whoami                      Show current authentication status
   <method> [json | --flags]   Execute a step method (shorthand for exec)
   exec <method> [json | --flags]   Execute a step method
   list [--json]               List available methods
@@ -2048,6 +2118,7 @@ Options:
   --help                   Show this help
 
 Examples:
+  mindstudio login
   mindstudio generate-image --prompt "a sunset"
   mindstudio generate-image --prompt "a sunset" --output-key imageUrl
   mindstudio generate-text --message "hello" --no-meta
@@ -2358,6 +2429,300 @@ async function cmdRun(appId, variables, options) {
     process.stdout.write(JSON.stringify(result, null, 2) + "\n");
   }
 }
+var ansi = {
+  cyan: (s) => `\x1B[36m${s}\x1B[0m`,
+  cyanBright: (s) => `\x1B[96m${s}\x1B[0m`,
+  cyanBold: (s) => `\x1B[96;1m${s}\x1B[0m`,
+  dim: (s) => `\x1B[2m${s}\x1B[0m`,
+  green: (s) => `\x1B[32m${s}\x1B[0m`,
+  greenBold: (s) => `\x1B[32;1m${s}\x1B[0m`,
+  gray: (s) => `\x1B[90m${s}\x1B[0m`,
+  bold: (s) => `\x1B[1m${s}\x1B[0m`
+};
+var UPDATE_CHECK_INTERVAL = 60 * 60 * 1e3;
+function isNewerVersion(current, latest) {
+  const c = current.split(".").map(Number);
+  const l = latest.split(".").map(Number);
+  for (let i = 0; i < Math.max(c.length, l.length); i++) {
+    const cv = c[i] ?? 0;
+    const lv = l[i] ?? 0;
+    if (lv > cv) return true;
+    if (lv < cv) return false;
+  }
+  return false;
+}
+async function checkForUpdate() {
+  const currentVersion = "0.0.17";
+  if (!currentVersion) return null;
+  try {
+    const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const config = loadConfig2();
+    if (config._updateCheck) {
+      const age = Date.now() - config._updateCheck.checkedAt;
+      if (age < UPDATE_CHECK_INTERVAL) {
+        return isNewerVersion(currentVersion, config._updateCheck.latestVersion) ? config._updateCheck.latestVersion : null;
+      }
+    }
+    const res = await fetch(
+      "https://registry.npmjs.org/@mindstudio-ai/agent/latest",
+      { signal: AbortSignal.timeout(5e3) }
+    );
+    if (!res.ok) return null;
+    const data = await res.json();
+    const latestVersion = data.version;
+    if (!latestVersion) return null;
+    saveConfig2({
+      ...config,
+      _updateCheck: { latestVersion, checkedAt: Date.now() }
+    });
+    return isNewerVersion(currentVersion, latestVersion) ? latestVersion : null;
+  } catch {
+    return null;
+  }
+}
+function printUpdateNotice(latestVersion) {
+  const currentVersion = "0.0.17";
+  process.stderr.write(
+    `
+  ${ansi.cyanBright("Update available")} ${ansi.gray(currentVersion + " \u2192")} ${ansi.cyanBold(latestVersion)}
+  ${ansi.gray("Run")} npm install -g @mindstudio-ai/agent ${ansi.gray("to update")}
+`
+  );
+}
+var LOGO = `       .=+-.     :++.
+      *@@@@@+  :%@@@@%:
+    .%@@@@@@#..@@@@@@@=
+  .*@@@@@@@--@@@@@@@#.**.
+  *@@@@@@@.-@@@@@@@@.#@@*
+.#@@@@@@@-.@@@@@@@* #@@@@%.
+=@@@@@@@-.@@@@@@@#.-@@@@@@+
+:@@@@@@:  +@@@@@#. .@@@@@@:
+  .++:     .-*-.     .++:`;
+function printLogo() {
+  const lines = LOGO.split("\n");
+  for (const line of lines) {
+    const colored = line.replace(
+      /[^\s]/g,
+      (ch) => ch === "." || ch === ":" || ch === "-" || ch === "+" || ch === "=" ? `\x1B[36m${ch}\x1B[0m` : `\x1B[96;1m${ch}\x1B[0m`
+    );
+    process.stderr.write(`  ${colored}
+`);
+  }
+}
+function openBrowser(url) {
+  try {
+    if (process.platform === "darwin") execSync(`open "${url}"`);
+    else if (process.platform === "win32") execSync(`start "" "${url}"`);
+    else execSync(`xdg-open "${url}"`);
+  } catch {
+  }
+}
+function sleep3(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function waitForKeypress() {
+  return new Promise((resolve) => {
+    if (!process.stdin.isTTY) {
+      resolve();
+      return;
+    }
+    process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.once("data", () => {
+      process.stdin.setRawMode(false);
+      process.stdin.pause();
+      resolve();
+    });
+  });
+}
+function maskKey(key) {
+  if (key.length <= 8) return "****";
+  return key.slice(0, 4) + "..." + key.slice(-4);
+}
+var DEFAULT_BASE_URL2 = "https://v1.mindstudio-api.com";
+var SPINNER_FRAMES = [
+  "\u28FE",
+  "\u28FD",
+  "\u28FB",
+  "\u28BF",
+  "\u287F",
+  "\u28DF",
+  "\u28EF",
+  "\u28F7"
+];
+async function cmdLogin(options) {
+  const baseUrl = options.baseUrl ?? process.env.MINDSTUDIO_BASE_URL ?? process.env.REMOTE_HOSTNAME ?? DEFAULT_BASE_URL2;
+  process.stderr.write("\n");
+  printLogo();
+  process.stderr.write("\n");
+  const ver = "0.0.17";
+  process.stderr.write(
+    `  ${ansi.bold("MindStudio")} ${ansi.gray("CLI")}${ver ? " " + ansi.gray("v" + ver) : ""}
+`
+  );
+  process.stderr.write(
+    `  ${ansi.gray("Connect your MindStudio account to get started.")}
+
+`
+  );
+  process.stderr.write(
+    `  ${ansi.cyanBright("Press any key to open the browser...")}
+
+
+
+`
+  );
+  await waitForKeypress();
+  process.stderr.write("\x1B[4A\r\x1B[J");
+  process.stderr.write(
+    `  ${ansi.gray("Requesting authorization...")}
+`
+  );
+  const authRes = await fetch(
+    `${baseUrl}/developer/v2/request-auth-url`,
+    {
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": "@mindstudio-ai/agent"
+      }
+    }
+  );
+  if (!authRes.ok) {
+    fatal(
+      `Failed to request auth URL: ${authRes.status} ${authRes.statusText}`
+    );
+  }
+  const { url, token } = await authRes.json();
+  openBrowser(url);
+  process.stderr.write(
+    `  ${ansi.cyanBright("Opening browser to authenticate...")}
+
+  ${ansi.gray("If the browser didn't open, visit:")}
+  ${ansi.cyan(url)}
+
+`
+  );
+  const POLL_INTERVAL = 2e3;
+  const MAX_ATTEMPTS = 60;
+  for (let attempt = 0; attempt < MAX_ATTEMPTS; attempt++) {
+    await sleep3(POLL_INTERVAL);
+    const frame = SPINNER_FRAMES[attempt % SPINNER_FRAMES.length];
+    const remaining = Math.ceil(
+      MAX_ATTEMPTS * POLL_INTERVAL / 1e3 - (attempt + 1) * POLL_INTERVAL / 1e3
+    );
+    process.stderr.write(
+      `\r  ${ansi.cyan(frame)} Waiting for browser authorization... ${ansi.gray(`(${remaining}s)`)}`
+    );
+    const pollRes = await fetch(`${baseUrl}/developer/v2/poll-auth-url`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "User-Agent": "@mindstudio-ai/agent"
+      },
+      body: JSON.stringify({ token })
+    });
+    if (!pollRes.ok) {
+      process.stderr.write("\n");
+      fatal(
+        `Poll request failed: ${pollRes.status} ${pollRes.statusText}`
+      );
+    }
+    const result = await pollRes.json();
+    if (result.status === "completed" && result.apiKey) {
+      process.stderr.write("\r\x1B[K");
+      const { saveConfig: saveConfig2, getConfigPath: getConfigPath2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+      const config = {
+        apiKey: result.apiKey
+      };
+      if (baseUrl !== DEFAULT_BASE_URL2) {
+        config.baseUrl = baseUrl;
+      }
+      saveConfig2(config);
+      process.stderr.write(
+        `  ${ansi.greenBold("\u2714")} Authenticated successfully!
+  ${ansi.gray("Credentials saved to")} ${getConfigPath2()}
+
+`
+      );
+      return;
+    }
+    if (result.status === "expired") {
+      process.stderr.write("\r\x1B[K");
+      fatal("Authorization expired. Please try again.");
+    }
+  }
+  process.stderr.write("\r\x1B[K");
+  fatal("Authorization timed out. Please try again.");
+}
+async function cmdLogout() {
+  const { loadConfig: loadConfig2, clearConfig: clearConfig2, getConfigPath: getConfigPath2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+  const config = loadConfig2();
+  if (!config.apiKey) {
+    process.stderr.write(
+      `  ${ansi.gray("Not currently logged in.")}
+`
+    );
+    return;
+  }
+  clearConfig2();
+  process.stderr.write(
+    `  ${ansi.greenBold("\u2714")} Logged out. Credentials removed from ${ansi.gray(getConfigPath2())}
+`
+  );
+}
+async function cmdWhoami(options) {
+  let source;
+  let detail = [];
+  if (options.apiKey) {
+    source = `${ansi.bold("--api-key flag")} ${ansi.gray("(CLI argument)")}`;
+  } else if (process.env.MINDSTUDIO_API_KEY) {
+    source = `${ansi.bold("MINDSTUDIO_API_KEY")} ${ansi.gray("(environment variable)")}`;
+    detail.push(
+      `  ${ansi.gray("Key:")}  ${maskKey(process.env.MINDSTUDIO_API_KEY)}`
+    );
+  } else {
+    const { loadConfig: loadConfig2, getConfigPath: getConfigPath2 } = await Promise.resolve().then(() => (init_config(), config_exports));
+    const config = loadConfig2();
+    if (config.apiKey) {
+      source = `${ansi.bold("config file")} ${ansi.gray("(mindstudio login)")}`;
+      detail.push(`  ${ansi.gray("File:")} ${getConfigPath2()}`);
+      detail.push(`  ${ansi.gray("Key:")}  ${maskKey(config.apiKey)}`);
+      if (config.baseUrl) {
+        detail.push(`  ${ansi.gray("URL:")}  ${config.baseUrl}`);
+      }
+    } else if (process.env.CALLBACK_TOKEN) {
+      source = `${ansi.bold("CALLBACK_TOKEN")} ${ansi.gray("(managed/internal mode)")}`;
+    } else {
+      process.stderr.write(
+        `  ${ansi.gray("\u25CB")} Not authenticated. Run ${ansi.cyan("mindstudio login")} to get started.
+`
+      );
+      return;
+    }
+  }
+  process.stderr.write(`  ${ansi.gray("Auth:")} ${source}
+`);
+  for (const line of detail) process.stderr.write(line + "\n");
+  process.stderr.write(`  ${ansi.gray("Verifying...")} `);
+  try {
+    const { MindStudioAgent: MindStudioAgent2 } = await Promise.resolve().then(() => (init_client(), client_exports));
+    const agent = new MindStudioAgent2({
+      apiKey: options.apiKey,
+      baseUrl: options.baseUrl
+    });
+    const result = await agent.listAgents();
+    process.stderr.write(
+      `\r\x1B[K  ${ansi.greenBold("\u25CF")} ${ansi.green("Connected")} ${ansi.gray("\u2014")} ${result.orgName} ${ansi.gray("(" + result.orgId + ")")}
+`
+    );
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(
+      `\r\x1B[K  ${ansi.dim("\u25CF")} ${ansi.dim("Not connected")} ${ansi.gray("\u2014")} ${message}
+`
+    );
+  }
+}
 function parseStepFlags(argv) {
   const result = {};
   for (let i = 0; i < argv.length; i++) {
@@ -2431,7 +2796,25 @@ async function main() {
     process.exit(positionals.length === 0 ? 1 : 0);
   }
   const command = positionals[0];
+  const updatePromise = command !== "mcp" && command !== "login" ? checkForUpdate() : Promise.resolve(null);
   try {
+    if (command === "login") {
+      await cmdLogin({
+        baseUrl: values["base-url"]
+      });
+      return;
+    }
+    if (command === "logout") {
+      await cmdLogout();
+      return;
+    }
+    if (command === "whoami") {
+      await cmdWhoami({
+        apiKey: values["api-key"],
+        baseUrl: values["base-url"]
+      });
+      return;
+    }
     if (command === "list") {
       await cmdList(values.json);
       return;
@@ -2551,6 +2934,9 @@ async function main() {
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);
     fatal(message);
+  } finally {
+    const latestVersion = await updatePromise;
+    if (latestVersion) printUpdateNotice(latestVersion);
   }
 }
 main();