@hasna/connectors 1.3.21 → 1.3.23

package/bin/index.js

@@ -65,7 +65,7 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
-// node_modules/commander/lib/error.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/error.js
 var require_error = __commonJS((exports) => {
   class CommanderError extends Error {
     constructor(exitCode, code, message) {
@@ -89,7 +89,7 @@ var require_error = __commonJS((exports) => {
   exports.InvalidArgumentError = InvalidArgumentError;
 });
 
-// node_modules/commander/lib/argument.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/argument.js
 var require_argument = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -168,7 +168,7 @@ var require_argument = __commonJS((exports) => {
   exports.humanReadableArgName = humanReadableArgName;
 });
 
-// node_modules/commander/lib/help.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/help.js
 var require_help = __commonJS((exports) => {
   var { humanReadableArgName } = require_argument();
 
@@ -417,7 +417,7 @@ var require_help = __commonJS((exports) => {
   exports.Help = Help;
 });
 
-// node_modules/commander/lib/option.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/option.js
 var require_option = __commonJS((exports) => {
   var { InvalidArgumentError } = require_error();
 
@@ -568,7 +568,7 @@ var require_option = __commonJS((exports) => {
   exports.DualOptions = DualOptions;
 });
 
-// node_modules/commander/lib/suggestSimilar.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/suggestSimilar.js
 var require_suggestSimilar = __commonJS((exports) => {
   var maxDistance = 3;
   function editDistance(a, b) {
@@ -641,7 +641,7 @@ var require_suggestSimilar = __commonJS((exports) => {
   exports.suggestSimilar = suggestSimilar;
 });
 
-// node_modules/commander/lib/command.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/lib/command.js
 var require_command = __commonJS((exports) => {
   var EventEmitter = __require("events").EventEmitter;
   var childProcess = __require("child_process");
@@ -1884,7 +1884,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
   exports.Command = Command;
 });
 
-// node_modules/commander/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/index.js
 var require_commander = __commonJS((exports) => {
   var { Argument } = require_argument();
   var { Command } = require_command();
@@ -1909,7 +1909,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/connectors",
-    version: "1.3.20",
+    version: "1.3.23",
     description: "Open source connector library - Install API connectors with a single command",
     type: "module",
     bin: {
@@ -1940,7 +1940,7 @@ var init_package = __esm(() => {
       typecheck: "tsc --noEmit",
       test: "bun test",
       "sdk:build": "cd sdk && bun run build",
-      prepublishOnly: "bun test && bun run build"
+      prepublishOnly: "bun run build && bun test"
     },
     keywords: [
       "connectors",
@@ -2081,7 +2081,7 @@ var init_registry = __esm(() => {
   init_connector();
 });
 
-// node_modules/zod/v3/helpers/util.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/helpers/util.js
 var util, objectUtil, ZodParsedType, getParsedType = (data) => {
   const t = typeof data;
   switch (t) {
@@ -2212,7 +2212,7 @@ var init_util = __esm(() => {
   ]);
 });
 
-// node_modules/zod/v3/ZodError.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/ZodError.js
 var ZodIssueCode, quotelessJson = (obj) => {
   const json = JSON.stringify(obj, null, 2);
   return json.replace(/"([^"]+)":/g, "$1:");
@@ -2333,7 +2333,7 @@ var init_ZodError = __esm(() => {
   };
 });
 
-// node_modules/zod/v3/locales/en.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/locales/en.js
 var errorMap = (issue, _ctx) => {
   let message;
   switch (issue.code) {
@@ -2440,7 +2440,7 @@ var init_en = __esm(() => {
   en_default = errorMap;
 });
 
-// node_modules/zod/v3/errors.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/errors.js
 function setErrorMap(map) {
   overrideErrorMap = map;
 }
@@ -2453,7 +2453,7 @@ var init_errors2 = __esm(() => {
   overrideErrorMap = en_default;
 });
 
-// node_modules/zod/v3/helpers/parseUtil.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/helpers/parseUtil.js
 function addIssueToContext(ctx, issueData) {
   const overrideMap = getErrorMap();
   const issue = makeIssue({
@@ -2558,10 +2558,10 @@ var init_parseUtil = __esm(() => {
   });
 });
 
-// node_modules/zod/v3/helpers/typeAliases.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/helpers/typeAliases.js
 var init_typeAliases = () => {};
 
-// node_modules/zod/v3/helpers/errorUtil.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/helpers/errorUtil.js
 var errorUtil;
 var init_errorUtil = __esm(() => {
   (function(errorUtil2) {
@@ -2570,7 +2570,7 @@ var init_errorUtil = __esm(() => {
   })(errorUtil || (errorUtil = {}));
 });
 
-// node_modules/zod/v3/types.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/types.js
 class ParseInputLazyPath {
   constructor(parent, value, path, key) {
     this._cachedPath = [];
@@ -5921,7 +5921,7 @@ var init_types = __esm(() => {
   NEVER = INVALID;
 });
 
-// node_modules/zod/v3/external.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/v3/external.js
 var exports_external = {};
 __export(exports_external, {
   void: () => voidType,
@@ -6041,7 +6041,7 @@ var init_external = __esm(() => {
   init_ZodError();
 });
 
-// node_modules/zod/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/zod/index.js
 var init_zod = __esm(() => {
   init_external();
   init_external();
@@ -6913,7 +6913,7 @@ Commands:
   });
 });
 
-// node_modules/@hasna/cloud/dist/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/@hasna/cloud/dist/index.js
 var exports_dist = {};
 __export(exports_dist, {
   translateSql: () => translateSql,
@@ -26525,7 +26525,7 @@ var init_registry2 = __esm(() => {
   ];
 });
 
-// node_modules/cli-spinners/spinners.json
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/cli-spinners/spinners.json
 var require_spinners = __commonJS((exports, module) => {
   module.exports = {
     dots: {
@@ -28151,7 +28151,7 @@ var require_spinners = __commonJS((exports, module) => {
   };
 });
 
-// node_modules/cli-spinners/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/cli-spinners/index.js
 var require_cli_spinners = __commonJS((exports, module) => {
   var spinners = Object.assign({}, require_spinners());
   var spinnersList = Object.keys(spinners);
@@ -29591,6 +29591,53 @@ function getConnectorCliPath(name) {
 function hasConnectorCommandSurface(name) {
   return Boolean(getInternalCommandRuntime(name)?.commands.length || getConnectorCliPath(name));
 }
+function normalizeCommanderUsage(usage) {
+  const commandToken = usage.trim().split(/\s+/)[0];
+  if (!commandToken || commandToken === "help")
+    return null;
+  const aliases = commandToken.split("|").filter(Boolean);
+  const [name, ...rest] = aliases;
+  if (!name)
+    return null;
+  return {
+    name,
+    aliases: rest,
+    usage: usage.trim()
+  };
+}
+function parseCommanderHelpOperations(helpText) {
+  const operations = [];
+  const lines = helpText.split(`
+`);
+  let inCommands = false;
+  for (const line of lines) {
+    if (line.trim().startsWith("Commands:")) {
+      inCommands = true;
+      continue;
+    }
+    if (!inCommands)
+      continue;
+    if (line.trim() === "") {
+      if (operations.length > 0)
+        inCommands = false;
+      continue;
+    }
+    const row = line.match(/^ {2}(\S.*?)(?: {2,}(.+))?$/);
+    if (!row)
+      continue;
+    const usage = row[1].trim();
+    const summary = (row[2] ?? "").trim();
+    const normalized = normalizeCommanderUsage(usage);
+    if (!normalized)
+      continue;
+    operations.push({
+      ...normalized,
+      summary,
+      source: "cli"
+    });
+  }
+  return operations;
+}
 function runConnectorCommand2(name, args, timeoutMs = 30000) {
   getConnectorsHome();
   const internalRuntime = getInternalCommandRuntime(name);
@@ -29657,38 +29704,33 @@ function runLegacyConnectorCommand(name, args, timeoutMs = 30000) {
 async function getConnectorOperations(name) {
   const internalRuntime = getInternalCommandRuntime(name);
   if (internalRuntime?.commands.length) {
+    const operations2 = internalRuntime.commands.map((command) => ({
+      name: command.name,
+      aliases: [],
+      usage: command.name,
+      summary: command.summary,
+      source: "internal"
+    }));
     return {
-      commands: internalRuntime.commands.map((command) => command.name),
+      commands: operations2.map((operation) => operation.name),
+      operations: operations2,
       helpText: internalRuntime.helpText ?? buildInternalHelpText(name, internalRuntime.commands),
       hasCli: true
     };
   }
   const cliPath = getConnectorCliPath(name);
   if (!cliPath) {
-    return { commands: [], helpText: "", hasCli: false };
+    return { commands: [], operations: [], helpText: "", hasCli: false };
   }
   const result = await runConnectorCommand2(name, ["--help"]);
   const helpText = result.stdout || result.stderr;
-  const commands = [];
-  const lines = helpText.split(`
-`);
-  let inCommands = false;
-  for (const line of lines) {
-    if (line.trim().startsWith("Commands:")) {
-      inCommands = true;
-      continue;
-    }
-    if (inCommands) {
-      const match = line.match(/^\s{2,}(\S+)/);
-      if (match && match[1] !== "help") {
-        commands.push(match[1]);
-      }
-      if (line.trim() === "" && commands.length > 0) {
-        inCommands = false;
-      }
-    }
-  }
-  return { commands, helpText, hasCli: true };
+  const operations = parseCommanderHelpOperations(helpText);
+  return {
+    commands: operations.map((operation) => operation.name),
+    operations,
+    helpText,
+    hasCli: true
+  };
 }
 async function getConnectorCommandHelp(name, command) {
   const internalRuntime = getInternalCommandRuntime(name);
@@ -29951,7 +29993,9 @@ Dashboard not found at: ${dashboardDir}`);
         return json({
           connector: name,
           displayName: meta.displayName,
+          auth: getAuthStatus(name),
           commands: ops.commands,
+          operations: ops.operations,
           helpText: ops.helpText
         }, 200, port);
       }
@@ -30524,7 +30568,7 @@ var init_serve = __esm(() => {
 // src/cli/index.tsx
 import { render as render2 } from "ink";
 
-// node_modules/commander/esm.mjs
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/commander/esm.mjs
 var import__ = __toESM(require_commander(), 1);
 var {
   program,
@@ -30548,11 +30592,11 @@ init_registry2();
 import { useState as useState7 } from "react";
 import { Box as Box8, Text as Text10, useApp, useInput as useInput5 } from "ink";
 
-// node_modules/ink-select-input/build/Indicator.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-select-input/build/Indicator.js
 import React from "react";
 import { Box, Text } from "ink";
 
-// node_modules/is-unicode-supported/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/is-unicode-supported/index.js
 import process2 from "process";
 function isUnicodeSupported() {
   const { env } = process2;
@@ -30563,7 +30607,7 @@ function isUnicodeSupported() {
   return Boolean(env.WT_SESSION) || Boolean(env.TERMINUS_SUBLIME) || env.ConEmuTask === "{cmd::Cmder}" || TERM_PROGRAM === "Terminus-Sublime" || TERM_PROGRAM === "vscode" || TERM === "xterm-256color" || TERM === "alacritty" || TERM === "rxvt-unicode" || TERM === "rxvt-unicode-256color" || env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
 
-// node_modules/figures/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/figures/index.js
 var common = {
   circleQuestionMark: "(?)",
   questionMarkPrefix: "(?)",
@@ -30839,23 +30883,23 @@ var figures = shouldUseMain ? mainSymbols : fallbackSymbols;
 var figures_default = figures;
 var replacements = Object.entries(specialMainSymbols);
 
-// node_modules/ink-select-input/build/Indicator.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-select-input/build/Indicator.js
 function Indicator({ isSelected = false }) {
   return React.createElement(Box, { marginRight: 1 }, isSelected ? React.createElement(Text, { color: "blue" }, figures_default.pointer) : React.createElement(Text, null, " "));
 }
 var Indicator_default = Indicator;
-// node_modules/ink-select-input/build/Item.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-select-input/build/Item.js
 import * as React2 from "react";
 import { Text as Text2 } from "ink";
 function Item({ isSelected = false, label }) {
   return React2.createElement(Text2, { color: isSelected ? "blue" : undefined }, label);
 }
 var Item_default = Item;
-// node_modules/ink-select-input/build/SelectInput.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-select-input/build/SelectInput.js
 import { isDeepStrictEqual } from "util";
 import React3, { useState, useEffect, useRef, useCallback } from "react";
 
-// node_modules/to-rotated/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/to-rotated/index.js
 function toRotated(array, steps) {
   if (!Array.isArray(array)) {
     throw new TypeError(`Expected an array, got \`${typeof array}\`.`);
@@ -30877,7 +30921,7 @@ function toRotated(array, steps) {
   ];
 }
 
-// node_modules/ink-select-input/build/SelectInput.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-select-input/build/SelectInput.js
 import { Box as Box2, useInput } from "ink";
 function SelectInput({ items = [], isFocused = true, initialIndex = 0, indicatorComponent = Indicator_default, itemComponent = Item_default, limit: customLimit, onSelect, onHighlight }) {
   const hasLimit = typeof customLimit === "number" && items.length > customLimit;
@@ -31290,7 +31334,7 @@ function ConnectorSelect({
 import { useState as useState4, useEffect as useEffect3, useMemo as useMemo2 } from "react";
 import { Box as Box6, Text as Text7, useInput as useInput4 } from "ink";
 
-// node_modules/ink-text-input/build/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-text-input/build/index.js
 import React5, { useState as useState3, useEffect as useEffect2 } from "react";
 import { Text as Text6, useInput as useInput3 } from "ink";
 import chalk from "chalk";
@@ -31678,7 +31722,7 @@ function SearchView({
 import { useState as useState6, useEffect as useEffect5 } from "react";
 import { Box as Box7, Text as Text9 } from "ink";
 
-// node_modules/ink-spinner/build/index.js
+// ../../../home/hasna/workspace/hasna/opensource/open-connectors/node_modules/ink-spinner/build/index.js
 var import_cli_spinners = __toESM(require_cli_spinners(), 1);
 import React7, { useState as useState5, useEffect as useEffect4 } from "react";
 import { Text as Text8 } from "ink";
@@ -32762,6 +32806,8 @@ function registerCommands3(program2) {
         const globalDirs = readdirSync12(configDir).filter((f) => {
           if (!f.startsWith("connect-"))
             return false;
+          if (f.startsWith("connect-zzztest"))
+            return false;
           try {
             return statSync7(join19(configDir, f)).isDirectory();
           } catch {
@@ -33029,8 +33075,29 @@ function redactSecrets(obj) {
   }
   return obj;
 }
+function getOAuthTokenState(name) {
+  const tokens = loadTokens(name);
+  if (!tokens?.accessToken && !tokens?.refreshToken) {
+    return { hasTokens: false, expired: false };
+  }
+  if (!tokens.expiresAt) {
+    return { hasTokens: true, expired: false };
+  }
+  const now3 = Date.now();
+  const isExpired = now3 >= tokens.expiresAt - 60000;
+  const expiresIn = isExpired ? undefined : (() => {
+    const ms = tokens.expiresAt - now3;
+    const mins = Math.floor(ms / 60000);
+    if (mins < 1)
+      return "less than a minute";
+    if (mins < 60)
+      return `${mins}m`;
+    return `${Math.floor(mins / 60)}h ${mins % 60}m`;
+  })();
+  return { hasTokens: true, expired: isExpired, expiresIn };
+}
 function registerCommands4(program2) {
-  program2.command("auth").argument("<connector>", "Connector name to configure auth for").option("-k, --key <value>", "API key or bearer token value (non-interactive)").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("--json", "Output as JSON", false).option("--no-browser", "Print OAuth URL without opening a browser (agent-friendly)", false).description("Configure authentication for a connector").action(async (connector, options) => {
+  program2.command("auth").argument("<connector>", "Connector name to configure auth for").option("-k, --key <value>", "API key or bearer token value (non-interactive)").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("--json", "Output as JSON", false).option("--no-browser", "Print OAuth URL without opening a browser (agent-friendly)", false).option("--refresh", "Refresh expired OAuth tokens", false).option("--port <port>", "OAuth server port (default: 9876)", "9876").description("Configure authentication for a connector").action(async (connector, options) => {
     const meta = getConnector(connector);
     if (!meta) {
       if (options.json) {
@@ -33044,6 +33111,39 @@ function registerCommands4(program2) {
     }
     const authType = getAuthType(connector);
     const statusBefore = getAuthStatus(connector);
+    if (options.refresh) {
+      if (authType !== "oauth") {
+        if (options.json) {
+          console.log(JSON.stringify({ error: `${connector} does not use OAuth. Refresh is only available for OAuth connectors.` }));
+        } else {
+          console.log(chalk5.red(`${meta.displayName} does not use OAuth. Refresh is only available for OAuth connectors.`));
+        }
+        process.exit(1);
+        return;
+      }
+      try {
+        const tokens = await refreshOAuthToken(connector);
+        if (options.json) {
+          console.log(JSON.stringify({ success: true, connector, tokenType: tokens.tokenType, scope: tokens.scope, expiresAt: tokens.expiresAt }));
+        } else {
+          console.log(chalk5.green(`
+\u2713 Refreshed ${meta.displayName} tokens.`));
+          console.log(chalk5.dim(`  Expires: ${new Date(tokens.expiresAt).toLocaleString()}`));
+        }
+        process.exit(0);
+        return;
+      } catch (err) {
+        if (options.json) {
+          console.log(JSON.stringify({ error: `Refresh failed: ${err instanceof Error ? err.message : String(err)}` }));
+        } else {
+          console.log(chalk5.red(`
+\u2717 Refresh failed: ${err instanceof Error ? err.message : String(err)}`));
+          console.log(chalk5.dim("You may need to re-authenticate."));
+        }
+        process.exit(1);
+        return;
+      }
+    }
     if (!options.json) {
       const statusLabel = statusBefore.configured ? chalk5.green("configured") : chalk5.red("not configured");
       console.log(chalk5.bold(`
@@ -33051,6 +33151,14 @@ ${meta.displayName} \u2014 Auth Configuration
 `));
       console.log(`  Auth type: ${authType === "oauth" ? "OAuth" : authType === "apikey" ? "API Key" : "Bearer Token"}`);
       console.log(`  Status:    ${statusLabel}`);
+      if (authType === "oauth" && statusBefore.configured) {
+        const tokenState = getOAuthTokenState(connector);
+        if (tokenState.hasTokens && !tokenState.expired) {
+          console.log(`  Token:     ${chalk5.green("valid")} (expires in ${tokenState.expiresIn})`);
+        } else if (tokenState.hasTokens && tokenState.expired) {
+          console.log(`  Token:     ${chalk5.yellow("expired")} (run 'connectors auth ${connector} --refresh' or re-authenticate)`);
+        }
+      }
       const envVars2 = getEnvVars(connector);
       if (envVars2.length > 0) {
         console.log(`  Fields:    ${envVars2.map((v) => v.variable).join(", ")}`);
@@ -33058,18 +33166,55 @@ ${meta.displayName} \u2014 Auth Configuration
       console.log();
     }
     if (authType === "oauth") {
+      const tokenState = getOAuthTokenState(connector);
+      if (tokenState.hasTokens && !tokenState.expired) {
+        if (options.json) {
+          console.log(JSON.stringify({ connector, authType: "oauth", status: "authenticated", message: `Tokens are valid and not expired.` }));
+        } else {
+          console.log(chalk5.green(`
+\u2713 ${meta.displayName} is already authenticated (tokens valid, expires in ${tokenState.expiresIn}).`));
+          console.log(chalk5.dim(`Use --refresh to renew tokens, or re-run auth to re-authenticate.`));
+        }
+        process.exit(0);
+        return;
+      }
+      if (tokenState.hasTokens && tokenState.expired) {
+        if (!options.json) {
+          console.log(chalk5.dim("Tokens expired \u2014 attempting auto-refresh..."));
+        }
+        try {
+          const tokens = await refreshOAuthToken(connector);
+          if (options.json) {
+            console.log(JSON.stringify({ connector, authType: "oauth", status: "refreshed", expiresAt: tokens.expiresAt }));
+          } else {
+            console.log(chalk5.green(`
+\u2713 Refreshed ${meta.displayName} tokens.`));
+            console.log(chalk5.dim(`  Expires: ${new Date(tokens.expiresAt).toLocaleString()}`));
+          }
+          process.exit(0);
+          return;
+        } catch {
+          if (!options.json) {
+            console.log(chalk5.yellow("Auto-refresh failed. Proceeding with OAuth flow..."));
+            console.log();
+          }
+        }
+      }
       if (options.json) {
+        const port2 = parseInt(options.port, 10) || 9876;
+        const oauthUrl2 = `http://localhost:${port2}/oauth/${connector}/start`;
         console.log(JSON.stringify({
           connector,
           authType: "oauth",
-          message: "OAuth connectors require browser-based authentication. Use 'connectors serve' or pass --key to set tokens manually."
+          message: "OAuth connectors require browser-based authentication. Use 'connectors serve' or pass --key to set tokens manually.",
+          oauthUrl: oauthUrl2
         }));
         process.exit(0);
         return;
       }
       console.log(chalk5.yellow("OAuth connectors require browser-based authentication."));
       console.log();
-      const port = 9876;
+      const port = parseInt(options.port, 10) || 9876;
       const oauthUrl = `http://localhost:${port}/oauth/${connector}/start`;
       try {
         if (!options.browser) {
@@ -33094,13 +33239,10 @@ ${meta.displayName} \u2014 Auth Configuration
 `));
           console.log(`  ${chalk5.cyan(oauthUrl)}
 `);
-          console.log(chalk5.dim(`Waiting for authentication to complete...
-`));
-          const { join: join8 } = await import("path");
-          const { getConnectorsHome: getConnectorsHome2 } = await Promise.resolve().then(() => (init_database(), exports_database));
-          const connectorsHome = getConnectorsHome2();
+          console.log(chalk5.dim("Waiting for authentication to complete..."));
+          const connectorsHome = getConnectorsHome();
           const connectorDirName = connector.startsWith("connect-") ? connector : `connect-${connector}`;
-          const tokensPath = join8(connectorsHome, connectorDirName, "profiles", "default", "tokens.json");
+          const tokensPath = join20(connectorsHome, connectorDirName, "profiles", "default", "tokens.json");
           let attempts = 0;
           const maxAttempts = 360;
           while (attempts < maxAttempts) {
@@ -33109,17 +33251,22 @@ ${meta.displayName} \u2014 Auth Configuration
               break;
             }
             attempts++;
+            if (attempts % 6 === 0) {
+              process.stdout.write(".");
+            }
           }
           try {
             serverProc.kill("SIGTERM");
           } catch {}
           if (attempts >= maxAttempts) {
+            console.log();
             console.log(chalk5.yellow("Timed out waiting for OAuth callback. The auth may still be in progress."));
             console.log(chalk5.dim(`Check ${tokensPath} for tokens.`));
             console.log(chalk5.dim("You can stop the server manually: lsof -ti :${port} | xargs kill"));
             process.exit(1);
             return;
           }
+          console.log();
           console.log(chalk5.green(`
 \u2713 Connected! ${meta.displayName} is now authenticated.`));
           process.exit(0);
@@ -34280,15 +34427,19 @@ ${meta.displayName} \u2192 ${command}
       console.log(JSON.stringify({
         connector: name,
         displayName: meta.displayName,
-        commands: ops.commands
+        auth: getAuthStatus(name),
+        commands: ops.commands,
+        operations: ops.operations
       }, null, 2));
     } else {
       console.log(chalk7.bold(`
 ${meta.displayName} operations:
 `));
-      if (ops.commands.length > 0) {
-        for (const cmd of ops.commands) {
-          console.log(`  ${chalk7.cyan(cmd)}`);
+      if (ops.operations.length > 0) {
+        for (const operation of ops.operations) {
+          const aliases = operation.aliases.length > 0 ? chalk7.dim(` aliases: ${operation.aliases.join(", ")}`) : "";
+          const summary = operation.summary ? chalk7.dim(` \u2014 ${operation.summary}`) : "";
+          console.log(`  ${chalk7.cyan(operation.name)}${aliases}${summary}`);
         }
         console.log(chalk7.dim(`
   Run ${chalk7.white(`connectors ops ${name} <command>`)} for details`));
@@ -34324,7 +34475,7 @@ ${meta.displayName} operations:
     }
     process.exit(result.exitCode);
   });
-  program2.command("setup").argument("<name>", "Connector name to set up").option("-k, --key <value>", "API key or bearer token value").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("-o, --overwrite", "Overwrite existing installation", false).option("--json", "Output as JSON", false).description("Install, configure auth, and verify a connector in one step").action(async (name, options) => {
+  program2.command("setup").argument("<name>", "Connector name to set up").option("-k, --key <value>", "API key or bearer token value").option("-f, --field <field>", "Which field to set (for multi-field connectors)").option("-o, --overwrite", "Overwrite existing installation", false).option("--json", "Output as JSON", false).option("--no-browser", "Print OAuth URL without opening a browser (agent-friendly)", false).description("Install, configure auth, and verify a connector in one step").action(async (name, options) => {
     const meta = getConnector(name);
     if (!meta) {
       if (options.json) {
@@ -34399,11 +34550,63 @@ Setting up ${meta.displayName}...
             return;
           }
           console.log(`  ${chalk7.yellow("\u27F3")} OAuth authentication required \u2014 starting server...`);
+          const port = 9876;
+          const oauthUrl = `http://localhost:${port}/oauth/${name}/start`;
+          if (!options.browser) {
+            console.log(`
+  ${chalk7.bold("Open this URL to authenticate:")}`);
+            console.log(`  ${chalk7.cyan(oauthUrl)}
+`);
+            const { spawn: spawn4 } = await import("child_process");
+            const { getConnectorsHome: getConnectorsHome2 } = await Promise.resolve().then(() => (init_database(), exports_database));
+            const { existsSync: existsSync8 } = await import("fs");
+            const { join: join8 } = await import("path");
+            const scriptPath = process.argv[1];
+            const serverProc = spawn4("node", [scriptPath, "serve", "--port", String(port)], {
+              detached: true,
+              stdio: "ignore"
+            });
+            serverProc.unref();
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            try {
+              await fetch(`http://localhost:${port}/api/connectors`);
+            } catch {
+              console.log(`  ${chalk7.red("\u2717")} OAuth server failed to start on port ${port}.`);
+              process.exit(1);
+              return;
+            }
+            console.log(chalk7.dim("  Waiting for authentication to complete..."));
+            const connectorsHome = getConnectorsHome2();
+            const connectorDirName = name.startsWith("connect-") ? name : `connect-${name}`;
+            const tokensPath = join8(connectorsHome, connectorDirName, "profiles", "default", "tokens.json");
+            let attempts = 0;
+            const maxAttempts = 360;
+            while (attempts < maxAttempts) {
+              await new Promise((resolve) => setTimeout(resolve, 500));
+              if (existsSync8(tokensPath))
+                break;
+              attempts++;
+              if (attempts % 6 === 0)
+                process.stdout.write(".");
+            }
+            try {
+              serverProc.kill("SIGTERM");
+            } catch {}
+            if (attempts >= maxAttempts) {
+              console.log();
+              console.log(chalk7.yellow("  Timed out waiting for OAuth callback."));
+              process.exit(1);
+              return;
+            }
+            console.log();
+            console.log(`  ${chalk7.green("\u2713")} ${meta.displayName} is now authenticated.`);
+            authConfigured = true;
+            process.exit(0);
+            return;
+          }
           try {
-            const port = 9876;
             const { startServer: startServer2 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
             await startServer2(port, { open: false, strict: true });
-            const oauthUrl = `http://localhost:${port}/oauth/${name}/start`;
             console.log(`
   ${chalk7.bold("Open this URL to authenticate:")}`);
             console.log(`  ${chalk7.cyan(oauthUrl)}