@mindstudio-ai/agent 0.0.16 → 0.0.18

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

@@ -201,6 +201,27 @@ var init_metadata = __esm({
         inputSchema: { "type": "object", "properties": { "input": { "type": "string", "description": "Text to scan for personally identifiable information" }, "language": { "type": "string", "description": 'Language code of the input text (e.g. "en")' }, "entities": { "type": "array", "items": { "type": "string" }, "description": 'PII entity types to scan for (e.g. ["PHONE_NUMBER", "EMAIL_ADDRESS"]). Empty array means nothing is scanned.' }, "detectedStepId": { "type": "string", "description": "Step to transition to if PII is detected (workflow mode)" }, "notDetectedStepId": { "type": "string", "description": "Step to transition to if no PII is detected (workflow mode)" }, "outputLogVariable": { "type": "string", "description": "Variable name to store the raw detection results" } }, "required": ["input", "language", "entities"] },
         outputSchema: { "type": "object", "properties": { "detected": { "type": "boolean", "description": "Whether any PII was found in the input text" }, "detections": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "description": 'PII entity type (e.g. "PHONE_NUMBER", "EMAIL_ADDRESS", "PERSON")' }, "start": { "type": "number", "description": "Start character index in the input text" }, "end": { "type": "number", "description": "End character index in the input text" }, "score": { "type": "number", "description": "Confidence score between 0 and 1" } }, "required": ["entity_type", "start", "end", "score"] }, "description": "List of detected PII entities with type, location, and confidence" } }, "required": ["detected", "detections"] }
       },
+      "discordEditMessage": {
+        stepType: "discordEditMessage",
+        description: "Edit a previously sent Discord channel message. Use with the message ID returned by Send Discord Message.",
+        usageNotes: "- Only messages sent by the bot can be edited.\n- The messageId is returned by the Send Discord Message step.\n- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.\n- When editing with an attachment, the new attachment replaces any previous attachments on the message.\n- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).",
+        inputSchema: { "type": "object", "properties": { "botToken": { "type": "string", "description": "Discord bot token for authentication" }, "channelId": { "type": "string", "description": "Discord channel ID containing the message" }, "messageId": { "type": "string", "description": "ID of the message to edit (returned by Send Discord Message)" }, "text": { "type": "string", "description": "New message text to replace the existing content" }, "attachmentUrl": { "type": "string", "description": "URL of a file to download and attach to the message (replaces any previous attachments)" } }, "required": ["botToken", "channelId", "messageId", "text"] },
+        outputSchema: { "description": "This step does not produce output data." }
+      },
+      "discordSendFollowUp": {
+        stepType: "discordSendFollowUp",
+        description: "Send a follow-up message to a Discord slash command interaction.",
+        usageNotes: "- Requires the applicationId and interactionToken from the Discord trigger variables.\n- Follow-up messages appear as new messages in the channel after the initial response.\n- Returns the sent message ID.\n- Interaction tokens expire after 15 minutes.\n- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.\n- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).",
+        inputSchema: { "type": "object", "properties": { "applicationId": { "type": "string", "description": "Discord application ID from the bot registration" }, "interactionToken": { "type": "string", "description": "Interaction token provided by the Discord trigger \u2014 expires after 15 minutes" }, "text": { "type": "string", "description": "Message text to send as a follow-up" }, "attachmentUrl": { "type": "string", "description": "URL of a file to download and attach to the message" } }, "required": ["applicationId", "interactionToken", "text"] },
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": "ID of the sent follow-up message" } }, "required": ["messageId"] }
+      },
+      "discordSendMessage": {
+        stepType: "discordSendMessage",
+        description: "Send a message to Discord \u2014 either edit the loading message or send a new channel message.",
+        usageNotes: '- mode "edit" replaces the loading message (interaction response) with the final result. Uses applicationId and interactionToken from trigger variables. No bot permissions required.\n- mode "send" sends a new message to a channel. Uses botToken and channelId from trigger variables. Returns a messageId that can be used with Edit Discord Message.\n- Optionally attach a file by providing a URL to attachmentUrl. The file is downloaded and uploaded to Discord.\n- URLs in the text are automatically embedded by Discord (link previews for images, videos, etc.).\n- Interaction tokens expire after 15 minutes.',
+        inputSchema: { "type": "object", "properties": { "mode": { "enum": ["edit", "send"], "type": "string", "description": '"edit" replaces the loading message, "send" sends a new channel message' }, "text": { "type": "string", "description": "Message text to send" }, "applicationId": { "type": "string", "description": 'Discord application ID from the bot registration (required for "reply" mode)' }, "interactionToken": { "type": "string", "description": 'Interaction token provided by the Discord trigger \u2014 expires after 15 minutes (required for "reply" mode)' }, "botToken": { "type": "string", "description": 'Discord bot token for authentication (required for "send" mode)' }, "channelId": { "type": "string", "description": 'Discord channel ID to send the message to (required for "send" mode)' }, "attachmentUrl": { "type": "string", "description": "URL of a file to download and attach to the message" } }, "required": ["mode", "text"] },
+        outputSchema: { "type": "object", "properties": { "messageId": { "type": "string", "description": 'ID of the sent Discord message, only present in "send" mode (use with Edit Discord Message)' } } }
+      },
       "downloadVideo": {
         stepType: "downloadVideo",
         description: "Download a video file",
@@ -528,9 +549,13 @@ var init_metadata = __esm({
       },
       "logic": {
         stepType: "logic",
-        description: "Use an AI model to evaluate which condition from a list is most true, given a context prompt.",
-        usageNotes: '- This is "fuzzy" logic evaluated by an AI model, not computational logic. The model picks the most accurate statement.\n- All possible cases must be specified \u2014 there is no default/fallback case.\n- Requires at least two cases.\n- In workflow mode, transitions to the destinationStepId of the winning case. In direct execution, returns the winning case ID and condition.',
-        inputSchema: { "type": "object", "properties": { "context": { "type": "string", "description": "Prompt text providing context for the AI evaluation" }, "cases": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string", "description": "Unique case identifier" }, "condition": { "type": "string", "description": 'The statement to evaluate (e.g., "User selected a dog")' }, "destinationStepId": { "type": "string", "description": "Step to transition to if this case wins (workflow mode only)" } }, "required": ["id", "condition"] }, { "type": "string" }] }, "description": "List of conditions to evaluate (objects for managed UIs, strings for code)" } }, "required": ["context", "cases"], "description": "Configuration for the logic evaluation step" },
+        description: "Route execution to different branches based on AI evaluation, comparison operators, or workflow jumps.",
+        usageNotes: `- Supports two modes: "ai" (default) uses an AI model to pick the most accurate statement; "comparison" uses operator-based checks.
+- In AI mode, the model picks the most accurate statement from the list. All possible cases must be specified.
+- In comparison mode, the context is the left operand and each case's condition is the right operand. First matching case wins. Use operator "default" as a fallback.
+- Requires at least two cases.
+- Each case can transition to a step in the current workflow (destinationStepId) or jump to another workflow (destinationWorkflowId).`,
+        inputSchema: { "type": "object", "properties": { "mode": { "enum": ["ai", "comparison"], "type": "string", "description": "Evaluation mode: 'ai' for LLM-based, 'comparison' for operator-based. Default: 'ai'" }, "context": { "type": "string", "description": "AI mode: prompt context. Comparison mode: left operand (resolved via variables)." }, "cases": { "type": "array", "items": { "anyOf": [{ "type": "object", "properties": { "id": { "type": "string", "description": "Unique case identifier" }, "condition": { "type": "string", "description": "AI mode: statement to evaluate. Comparison mode: right operand value." }, "operator": { "enum": ["eq", "neq", "gt", "lt", "gte", "lte", "exists", "not_exists", "contains", "not_contains", "default"], "type": "string", "description": "Comparison operator (comparison mode only)" }, "destinationStepId": { "type": "string", "description": "Step to transition to if this case wins (workflow mode only)" }, "destinationWorkflowId": { "type": "string", "description": "Workflow to jump to if this case wins (uses that workflow's initial step)" } }, "required": ["id", "condition"] }, { "type": "string" }] }, "description": "List of conditions to evaluate (objects for managed UIs, strings for code)" }, "modelOverride": { "type": "object", "properties": { "model": { "type": "string", "description": 'Model identifier (e.g. "gpt-4", "claude-3-opus")' }, "temperature": { "type": "number", "description": "Sampling temperature for the model (0-2)" }, "maxResponseTokens": { "type": "number", "description": "Maximum number of tokens in the model's response" }, "ignorePreamble": { "type": "boolean", "description": "Whether to skip the system preamble/instructions" }, "userMessagePreprocessor": { "type": "object", "properties": { "dataSource": { "type": "string", "description": "Data source identifier for the preprocessor" }, "messageTemplate": { "type": "string", "description": "Template string applied to user messages before sending to the model" }, "maxResults": { "type": "number", "description": "Maximum number of results to include from the data source" }, "enabled": { "type": "boolean", "description": "Whether the preprocessor is active" }, "shouldInherit": { "type": "boolean", "description": "Whether child steps should inherit this preprocessor configuration" } }, "description": "Preprocessor applied to user messages before sending to the model" }, "preamble": { "type": "string", "description": "System preamble/instructions for the model" }, "multiModelEnabled": { "type": "boolean", "description": "Whether multi-model candidate generation is enabled" }, "editResponseEnabled": { "type": "boolean", "description": "Whether the user can edit the model's response" }, "config": { "type": "object", "description": "Additional model-specific configuration" } }, "required": ["model", "temperature", "maxResponseTokens"], "description": "Optional model settings override; uses the organization default if not specified (AI mode only)" } }, "required": ["context", "cases"], "description": "Configuration for the router step" },
         outputSchema: { "type": "object", "properties": { "selectedCase": { "type": "number", "description": "The index of the winning case" } }, "required": ["selectedCase"] }
       },
       "makeDotComRunScenario": {
@@ -845,9 +870,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 +889,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 +927,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 +1198,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, {
@@ -1244,6 +1325,15 @@ function applyStepMethods(AgentClass) {
   proto.detectPII = function(step, options) {
     return this.executeStep("detectPII", step, options);
   };
+  proto.discordEditMessage = function(step, options) {
+    return this.executeStep("discordEditMessage", step, options);
+  };
+  proto.discordSendFollowUp = function(step, options) {
+    return this.executeStep("discordSendFollowUp", step, options);
+  };
+  proto.discordSendMessage = function(step, options) {
+    return this.executeStep("discordSendMessage", step, options);
+  };
   proto.downloadVideo = function(step, options) {
     return this.executeStep("downloadVideo", step, options);
   };
@@ -1520,6 +1610,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 +1720,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 +1741,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 +1754,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 +1958,7 @@ async function startMcpServer(options) {
           capabilities: { tools: {} },
           serverInfo: {
             name: "mindstudio-agent",
-            version: "0.0.16"
+            version: "0.0.18"
           }
         });
         break;
@@ -2024,9 +2124,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 +2152,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 +2463,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.18";
+  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.18";
+  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.18";
+  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 +2830,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 +2968,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();