@hasna/connectors 0.2.3 → 0.2.4

package/bin/index.js

@@ -4014,6 +4014,9 @@ function getConnectorPath(name) {
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
   return join2(CONNECTORS_DIR, connectorName);
 }
+function connectorExists(name) {
+  return existsSync2(getConnectorPath(name));
+}
 function installConnector(name, options = {}) {
   const { targetDir = process.cwd(), overwrite = false } = options;
   if (!/^[a-z0-9-]+$/.test(name)) {
@@ -4148,7 +4151,7 @@ var init_installer = __esm(() => {
 });
 
 // src/server/auth.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, mkdirSync as mkdirSync2, readdirSync as readdirSync2, rmSync as rmSync2, statSync as statSync2 } from "fs";
 import { randomBytes } from "crypto";
 import { homedir } from "os";
 import { join as join3 } from "path";
@@ -4165,7 +4168,7 @@ function getAuthType(name) {
 }
 function getConnectorConfigDir(name) {
   const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
-  return join3(homedir(), ".connect", connectorName);
+  return join3(homedir(), ".connectors", connectorName);
 }
 function getCurrentProfile(name) {
   const configDir = getConnectorConfigDir(name);
@@ -4217,6 +4220,8 @@ function getAuthStatus(name) {
     description: v.description,
     set: !!process.env[v.variable]
   }));
+  const envVarTotalCount = envVars.length;
+  const envVarSetCount = envVars.filter((v) => v.set).length;
   if (authType === "oauth") {
     const tokens = loadTokens(name);
     const config2 = loadProfileConfig(name);
@@ -4228,7 +4233,9 @@ function getAuthStatus(name) {
       configured: hasTokens || hasRefreshToken,
       tokenExpiry,
       hasRefreshToken,
-      envVars
+      envVars,
+      envVarSetCount,
+      envVarTotalCount
     };
   }
   const config = loadProfileConfig(name);
@@ -4237,9 +4244,15 @@ function getAuthStatus(name) {
   return {
     type: authType,
     configured: hasKey || hasEnvVar,
-    envVars
+    envVars,
+    envVarSetCount,
+    envVarTotalCount
   };
 }
+function getEnvVars(name) {
+  const docs = getConnectorDocs(name);
+  return docs?.envVars || [];
+}
 function saveApiKey(name, key, field) {
   const configDir = getConnectorConfigDir(name);
   const profile = getCurrentProfile(name);
@@ -4408,6 +4421,55 @@ async function refreshOAuthToken(name) {
   saveOAuthTokens(name, tokens);
   return tokens;
 }
+function listProfiles(name) {
+  const configDir = getConnectorConfigDir(name);
+  const profilesDir = join3(configDir, "profiles");
+  if (!existsSync3(profilesDir))
+    return ["default"];
+  const seen = new Set;
+  try {
+    const entries = readdirSync2(profilesDir);
+    for (const entry of entries) {
+      const fullPath = join3(profilesDir, entry);
+      const stat = statSync2(fullPath);
+      if (stat.isDirectory()) {
+        seen.add(entry);
+      } else if (entry.endsWith(".json")) {
+        seen.add(entry.replace(/\.json$/, ""));
+      }
+    }
+  } catch {}
+  seen.add("default");
+  return Array.from(seen).sort();
+}
+function switchProfile(name, profile) {
+  const configDir = getConnectorConfigDir(name);
+  mkdirSync2(configDir, { recursive: true });
+  writeFileSync2(join3(configDir, "current_profile"), profile);
+}
+function deleteProfile(name, profile) {
+  if (profile === "default")
+    return false;
+  const configDir = getConnectorConfigDir(name);
+  const profilesDir = join3(configDir, "profiles");
+  const profileFile = join3(profilesDir, `${profile}.json`);
+  if (existsSync3(profileFile)) {
+    rmSync2(profileFile);
+    if (getCurrentProfile(name) === profile) {
+      switchProfile(name, "default");
+    }
+    return true;
+  }
+  const profileDir = join3(profilesDir, profile);
+  if (existsSync3(profileDir)) {
+    rmSync2(profileDir, { recursive: true });
+    if (getCurrentProfile(name) === profile) {
+      switchProfile(name, "default");
+    }
+    return true;
+  }
+  return false;
+}
 var FETCH_TIMEOUT = 1e4, oauthStateStore, GOOGLE_AUTH_URL = "https://accounts.google.com/o/oauth2/v2/auth", GOOGLE_TOKEN_URL = "https://oauth2.googleapis.com/token", GOOGLE_SCOPES;
 var init_auth = __esm(() => {
   init_installer();
@@ -4457,9 +4519,16 @@ var exports_serve = {};
 __export(exports_serve, {
   startServer: () => startServer
 });
-import { existsSync as existsSync4 } from "fs";
-import { join as join4, dirname as dirname3, extname } from "path";
+import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync3, mkdirSync as mkdirSync3 } from "fs";
+import { join as join4, dirname as dirname3, extname, basename } from "path";
 import { fileURLToPath as fileURLToPath3 } from "url";
+import { homedir as homedir2 } from "os";
+function logActivity(action, connector, detail) {
+  activityLog.unshift({ action, connector, timestamp: Date.now(), detail });
+  if (activityLog.length > MAX_ACTIVITY_LOG) {
+    activityLog.length = MAX_ACTIVITY_LOG;
+  }
+}
 function resolveDashboardDir() {
   const candidates = [];
   try {
@@ -4533,7 +4602,19 @@ function serveStaticFile(filePath) {
     headers: { "Content-Type": contentType }
   });
 }
-async function startServer(port, options) {
+async function findAvailablePort(preferred) {
+  for (let port = preferred;port < preferred + 100; port++) {
+    try {
+      const server = Bun.serve({ port, fetch() {
+        return new Response;
+      } });
+      server.stop(true);
+      return port;
+    } catch {}
+  }
+  throw new Error(`No available port found in range ${preferred}-${preferred + 99}`);
+}
+async function startServer(requestedPort, options) {
   const shouldOpen = options?.open ?? true;
   loadConnectorVersions();
   const dashboardDir = resolveDashboardDir();
@@ -4550,6 +4631,10 @@ Dashboard not found at: ${dashboardDir}`);
     console.error(`  bun run build:dashboard
 `);
   }
+  const port = await findAvailablePort(requestedPort);
+  if (port !== requestedPort) {
+    console.log(`Port ${requestedPort} is in use, using port ${port} instead`);
+  }
   const server = Bun.serve({
     port,
     async fetch(req) {
@@ -4592,6 +4677,7 @@ Dashboard not found at: ${dashboardDir}`);
           if (!body.key)
             return json({ error: "Missing 'key' in request body" }, 400, port);
           saveApiKey(name, body.key, body.field);
+          logActivity("key_saved", name, body.field ? `Field: ${body.field}` : undefined);
           return json({ success: true }, 200, port);
         } catch (e) {
           return json({ error: e instanceof Error ? e.message : "Failed to save key" }, 500, port);
@@ -4604,18 +4690,215 @@ Dashboard not found at: ${dashboardDir}`);
           return json({ error: "Invalid connector name" }, 400, port);
         try {
           const tokens = await refreshOAuthToken(name);
+          logActivity("token_refreshed", name, tokens.expiresAt ? `Expires: ${new Date(tokens.expiresAt).toISOString()}` : undefined);
           return json({ success: true, expiresAt: tokens.expiresAt }, 200, port);
         } catch (e) {
           return json({ success: false, error: e instanceof Error ? e.message : "Failed to refresh" }, 500, port);
         }
       }
+      const installMatch = path.match(/^\/api\/connectors\/([^/]+)\/install$/);
+      if (installMatch && method === "POST") {
+        const name = installMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        const meta = getConnector(name);
+        if (!meta)
+          return json({ error: `Connector '${name}' not found` }, 404, port);
+        try {
+          const result = installConnector(name);
+          if (!result.success) {
+            return json({ error: result.error || "Failed to install connector" }, 500, port);
+          }
+          logActivity("installed", name);
+          return json({ success: true, name }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to install connector" }, 500, port);
+        }
+      }
+      const uninstallMatch = path.match(/^\/api\/connectors\/([^/]+)\/uninstall$/);
+      if (uninstallMatch && method === "POST") {
+        const name = uninstallMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const removed = removeConnector(name);
+          if (!removed) {
+            return json({ error: `Connector '${name}' is not installed` }, 404, port);
+          }
+          logActivity("uninstalled", name);
+          return json({ success: true, name }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to uninstall connector" }, 500, port);
+        }
+      }
+      if (path === "/api/update" && method === "POST") {
+        try {
+          const installed = getInstalledConnectors();
+          if (installed.length === 0) {
+            return json({ updated: [], count: 0 }, 200, port);
+          }
+          const results = installed.map((name) => installConnector(name, { overwrite: true }));
+          return json({
+            results,
+            count: results.filter((r) => r.success).length,
+            total: installed.length
+          }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to update" }, 500, port);
+        }
+      }
+      if (path === "/api/activity" && method === "GET") {
+        return json(activityLog, 200, port);
+      }
+      const profilesMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles$/);
+      if (profilesMatch && method === "GET") {
+        const name = profilesMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const profiles = listProfiles(name);
+          const configDir = join4(homedir2(), ".connectors", name.startsWith("connect-") ? name : `connect-${name}`);
+          const currentProfileFile = join4(configDir, "current_profile");
+          let current = "default";
+          if (existsSync4(currentProfileFile)) {
+            try {
+              current = readFileSync4(currentProfileFile, "utf-8").trim() || "default";
+            } catch {}
+          }
+          return json({ current, profiles }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to list profiles" }, 500, port);
+        }
+      }
+      const profileSwitchMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles\/switch$/);
+      if (profileSwitchMatch && method === "POST") {
+        const name = profileSwitchMatch[1];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        try {
+          const contentLength = parseInt(req.headers.get("content-length") || "0", 10);
+          if (contentLength > MAX_BODY_SIZE)
+            return json({ error: "Request body too large" }, 413, port);
+          const body = await req.json();
+          if (!body.profile)
+            return json({ error: "Missing 'profile' in request body" }, 400, port);
+          switchProfile(name, body.profile);
+          logActivity("profile_switch", name, `Switched to profile: ${body.profile}`);
+          return json({ success: true, profile: body.profile }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to switch profile" }, 500, port);
+        }
+      }
+      const profileDeleteMatch = path.match(/^\/api\/connectors\/([^/]+)\/profiles\/([^/]+)$/);
+      if (profileDeleteMatch && method === "DELETE") {
+        const name = profileDeleteMatch[1];
+        const profile = profileDeleteMatch[2];
+        if (!isValidConnectorName(name))
+          return json({ error: "Invalid connector name" }, 400, port);
+        if (profile === "default")
+          return json({ error: "Cannot delete the default profile" }, 400, port);
+        try {
+          const deleted = deleteProfile(name, profile);
+          if (!deleted)
+            return json({ error: `Profile '${profile}' not found` }, 404, port);
+          logActivity("profile_delete", name, `Deleted profile: ${profile}`);
+          return json({ success: true }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to delete profile" }, 500, port);
+        }
+      }
+      if (path === "/api/export" && method === "GET") {
+        try {
+          const connectDir = join4(homedir2(), ".connectors");
+          const result = {};
+          if (existsSync4(connectDir)) {
+            const entries = readdirSync3(connectDir, { withFileTypes: true });
+            for (const entry of entries) {
+              if (!entry.isDirectory() || !entry.name.startsWith("connect-"))
+                continue;
+              const connectorName = entry.name.replace(/^connect-/, "");
+              const profilesDir = join4(connectDir, entry.name, "profiles");
+              if (!existsSync4(profilesDir))
+                continue;
+              const profiles = {};
+              const profileEntries = readdirSync3(profilesDir, { withFileTypes: true });
+              for (const pEntry of profileEntries) {
+                if (pEntry.isFile() && pEntry.name.endsWith(".json")) {
+                  const profileName = basename(pEntry.name, ".json");
+                  try {
+                    const config = JSON.parse(readFileSync4(join4(profilesDir, pEntry.name), "utf-8"));
+                    profiles[profileName] = config;
+                  } catch {}
+                }
+                if (pEntry.isDirectory()) {
+                  const configPath = join4(profilesDir, pEntry.name, "config.json");
+                  if (existsSync4(configPath)) {
+                    try {
+                      const config = JSON.parse(readFileSync4(configPath, "utf-8"));
+                      profiles[pEntry.name] = config;
+                    } catch {}
+                  }
+                }
+              }
+              if (Object.keys(profiles).length > 0) {
+                result[connectorName] = { profiles };
+              }
+            }
+          }
+          const exportData = { connectors: result, exportedAt: new Date().toISOString() };
+          return new Response(JSON.stringify(exportData, null, 2), {
+            status: 200,
+            headers: {
+              "Content-Type": "application/json",
+              "Content-Disposition": `attachment; filename="connectors-backup-${new Date().toISOString().slice(0, 10)}.json"`,
+              "Access-Control-Allow-Origin": port ? `http://localhost:${port}` : "*",
+              ...SECURITY_HEADERS
+            }
+          });
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to export credentials" }, 500, port);
+        }
+      }
+      if (path === "/api/import" && method === "POST") {
+        try {
+          const contentLength = parseInt(req.headers.get("content-length") || "0", 10);
+          if (contentLength > MAX_BODY_SIZE)
+            return json({ error: "Request body too large" }, 413, port);
+          const body = await req.json();
+          if (!body.connectors || typeof body.connectors !== "object") {
+            return json({ error: "Invalid import format: missing 'connectors' object" }, 400, port);
+          }
+          let imported = 0;
+          const connectDir = join4(homedir2(), ".connectors");
+          for (const [connectorName, data] of Object.entries(body.connectors)) {
+            if (!isValidConnectorName(connectorName))
+              continue;
+            if (!data.profiles || typeof data.profiles !== "object")
+              continue;
+            const connectorDir = join4(connectDir, `connect-${connectorName}`);
+            const profilesDir = join4(connectorDir, "profiles");
+            for (const [profileName, config] of Object.entries(data.profiles)) {
+              if (!config || typeof config !== "object")
+                continue;
+              mkdirSync3(profilesDir, { recursive: true });
+              const profileFile = join4(profilesDir, `${profileName}.json`);
+              writeFileSync3(profileFile, JSON.stringify(config, null, 2));
+              imported++;
+            }
+          }
+          logActivity("credentials_imported", "all", `Imported ${imported} profiles`);
+          return json({ success: true, imported }, 200, port);
+        } catch (e) {
+          return json({ error: e instanceof Error ? e.message : "Failed to import credentials" }, 500, port);
+        }
+      }
       const oauthStartMatch = path.match(/^\/oauth\/([^/]+)\/start$/);
       if (oauthStartMatch && method === "GET") {
         const name = oauthStartMatch[1];
         const redirectUri = `http://localhost:${port}/oauth/${name}/callback`;
         const authUrl = getOAuthStartUrl(name, redirectUri);
         if (!authUrl) {
-          return htmlResponse(errorPage("OAuth Not Available", `No OAuth client credentials found for <strong>${name}</strong>.`, `Set up credentials at <code>~/.connect/connect-${name}/credentials.json</code>`));
+          return htmlResponse(errorPage("OAuth Not Available", `No OAuth client credentials found for <strong>${name}</strong>.`, `Set up credentials at <code>~/.connectors/connect-${name}/credentials.json</code>`));
         }
         return Response.redirect(authUrl, 302);
       }
@@ -4637,6 +4920,7 @@ Dashboard not found at: ${dashboardDir}`);
         try {
           const redirectUri = `http://localhost:${port}/oauth/${name}/callback`;
           await exchangeOAuthCode(name, code, redirectUri);
+          logActivity("oauth_connected", name);
           return htmlResponse(`<!DOCTYPE html><html><head><meta charset="utf-8"></head><body style="font-family:system-ui,sans-serif;display:flex;justify-content:center;align-items:center;height:100vh;margin:0;background:#0a0a0a;color:#e5e5e5;">
             <div style="text-align:center;">
               <h2 style="color:#22c55e;">Connected!</h2>
@@ -4657,7 +4941,7 @@ Dashboard not found at: ${dashboardDir}`);
         return new Response(null, {
           headers: {
             "Access-Control-Allow-Origin": `http://localhost:${port}`,
-            "Access-Control-Allow-Methods": "GET, POST, OPTIONS",
+            "Access-Control-Allow-Methods": "GET, POST, DELETE, OPTIONS",
             "Access-Control-Allow-Headers": "Content-Type"
           }
         });
@@ -4693,11 +4977,12 @@ Dashboard not found at: ${dashboardDir}`);
     } catch {}
   }
 }
-var MIME_TYPES, SECURITY_HEADERS, MAX_BODY_SIZE;
+var activityLog, MAX_ACTIVITY_LOG = 100, MIME_TYPES, SECURITY_HEADERS, MAX_BODY_SIZE;
 var init_serve = __esm(() => {
   init_registry();
   init_installer();
   init_auth();
+  activityLog = [];
   MIME_TYPES = {
     ".html": "text/html; charset=utf-8",
     ".js": "application/javascript",
@@ -5218,42 +5503,67 @@ function ConnectorSelect({
   onConfirm,
   onBack
 }) {
-  const totalItems = connectors.length + 2;
   const [cursor, setCursor] = useState2(0);
+  const [filter, setFilter] = useState2("");
+  const filteredConnectors = useMemo(() => {
+    if (!filter)
+      return connectors;
+    const lower = filter.toLowerCase();
+    return connectors.filter((c) => c.name.toLowerCase().includes(lower) || c.description && c.description.toLowerCase().includes(lower));
+  }, [connectors, filter]);
+  const totalItems = filteredConnectors.length + 2;
+  const clampedCursor = useMemo(() => {
+    if (cursor >= totalItems)
+      return totalItems - 1;
+    return cursor;
+  }, [cursor, totalItems]);
   const maxVisible = 16;
   const scrollOffset = useMemo(() => {
     if (totalItems <= maxVisible)
       return 0;
     const half = Math.floor(maxVisible / 2);
-    if (cursor < half)
+    if (clampedCursor < half)
       return 0;
-    if (cursor > totalItems - maxVisible + half)
+    if (clampedCursor > totalItems - maxVisible + half)
       return totalItems - maxVisible;
-    return cursor - half;
-  }, [cursor, totalItems]);
+    return clampedCursor - half;
+  }, [clampedCursor, totalItems]);
   useInput2((input, key) => {
     if (key.escape) {
-      onBack();
+      if (filter) {
+        setFilter("");
+        setCursor(0);
+      } else {
+        onBack();
+      }
     } else if (key.upArrow) {
-      setCursor((c) => c > 0 ? c - 1 : totalItems - 1);
+      setCursor((c) => {
+        const total = filteredConnectors.length + 2;
+        return c > 0 ? c - 1 : total - 1;
+      });
     } else if (key.downArrow) {
-      setCursor((c) => c < totalItems - 1 ? c + 1 : 0);
+      setCursor((c) => {
+        const total = filteredConnectors.length + 2;
+        return c < total - 1 ? c + 1 : 0;
+      });
     } else if (key.return) {
-      if (cursor === 0) {
+      const cur = clampedCursor;
+      const total = filteredConnectors.length + 2;
+      if (cur === 0) {
         onBack();
-      } else if (cursor === totalItems - 1) {
+      } else if (cur === total - 1) {
         if (selected.size > 0)
           onConfirm();
       } else {
-        onToggle(connectors[cursor - 1].name);
+        onToggle(filteredConnectors[cur - 1].name);
       }
-    } else if (input === " " && cursor > 0 && cursor < totalItems - 1) {
-      onToggle(connectors[cursor - 1].name);
+    } else if (input === " " && clampedCursor > 0 && clampedCursor < filteredConnectors.length + 1) {
+      onToggle(filteredConnectors[clampedCursor - 1].name);
     } else if (input === "i" && selected.size > 0) {
       onConfirm();
     } else if (input === "a") {
-      const allSelected = connectors.every((c) => selected.has(c.name));
-      for (const c of connectors) {
+      const allSelected = filteredConnectors.every((c) => selected.has(c.name));
+      for (const c of filteredConnectors) {
         if (allSelected) {
           if (selected.has(c.name))
             onToggle(c.name);
@@ -5262,6 +5572,12 @@ function ConnectorSelect({
             onToggle(c.name);
         }
       }
+    } else if (key.backspace || key.delete) {
+      setFilter((f) => f.slice(0, -1));
+      setCursor(0);
+    } else if (input && /^[a-zA-Z0-9\-_.]$/.test(input) && input !== "a" && input !== "i") {
+      setFilter((f) => f + input);
+      setCursor(0);
     }
   });
   const visibleStart = scrollOffset;
@@ -5271,11 +5587,33 @@ function ConnectorSelect({
     children: [
       /* @__PURE__ */ jsxDEV3(Box5, {
         marginBottom: 1,
-        children: /* @__PURE__ */ jsxDEV3(Text5, {
-          bold: true,
-          children: "Select connectors to install:"
-        }, undefined, false, undefined, this)
-      }, undefined, false, undefined, this),
+        children: [
+          /* @__PURE__ */ jsxDEV3(Text5, {
+            bold: true,
+            children: "Select connectors to install:"
+          }, undefined, false, undefined, this),
+          filter ? /* @__PURE__ */ jsxDEV3(Text5, {
+            color: "yellow",
+            children: [
+              " Filter: ",
+              filter
+            ]
+          }, undefined, true, undefined, this) : null,
+          filter && filteredConnectors.length === 0 ? /* @__PURE__ */ jsxDEV3(Text5, {
+            dimColor: true,
+            children: " (no matches)"
+          }, undefined, false, undefined, this) : filter ? /* @__PURE__ */ jsxDEV3(Text5, {
+            dimColor: true,
+            children: [
+              " (",
+              filteredConnectors.length,
+              " match",
+              filteredConnectors.length !== 1 ? "es" : "",
+              ")"
+            ]
+          }, undefined, true, undefined, this) : null
+        ]
+      }, undefined, true, undefined, this),
       /* @__PURE__ */ jsxDEV3(Box5, {
         children: [
           /* @__PURE__ */ jsxDEV3(Box5, {
@@ -5326,7 +5664,7 @@ function ConnectorSelect({
       Array.from({ length: visibleEnd - visibleStart }, (_, i) => {
         const idx = visibleStart + i;
         if (idx === 0) {
-          const isActive2 = cursor === 0;
+          const isActive2 = clampedCursor === 0;
           return /* @__PURE__ */ jsxDEV3(Box5, {
             children: /* @__PURE__ */ jsxDEV3(Text5, {
               color: isActive2 ? "cyan" : undefined,
@@ -5339,7 +5677,7 @@ function ConnectorSelect({
           }, "__back__", false, undefined, this);
         }
         if (idx === totalItems - 1) {
-          const isActive2 = cursor === totalItems - 1;
+          const isActive2 = clampedCursor === totalItems - 1;
           const hasSelection = selected.size > 0;
           return /* @__PURE__ */ jsxDEV3(Box5, {
             children: /* @__PURE__ */ jsxDEV3(Text5, {
@@ -5355,8 +5693,8 @@ function ConnectorSelect({
             }, undefined, true, undefined, this)
           }, "__confirm__", false, undefined, this);
         }
-        const c = connectors[idx - 1];
-        const isActive = cursor === idx;
+        const c = filteredConnectors[idx - 1];
+        const isActive = clampedCursor === idx;
         const isChecked = selected.has(c.name);
         return /* @__PURE__ */ jsxDEV3(Box5, {
           children: [
@@ -5418,8 +5756,11 @@ function ConnectorSelect({
         marginTop: 1,
         children: /* @__PURE__ */ jsxDEV3(Text5, {
           dimColor: true,
-          children: "\u2191\u2193 navigate  space/enter toggle  a select all  i install  esc back"
-        }, undefined, false, undefined, this)
+          children: [
+            "\u2191\u2193 navigate  space/enter toggle  a select all  i install  type to filter  esc ",
+            filter ? "clear filter" : "back"
+          ]
+        }, undefined, true, undefined, this)
       }, undefined, false, undefined, this)
     ]
   }, undefined, true, undefined, this);
@@ -6154,11 +6495,15 @@ function App({ initialConnectors, overwrite = false }) {
 // src/cli/index.tsx
 init_registry();
 init_installer();
+init_auth();
+import { readdirSync as readdirSync4, statSync as statSync3 } from "fs";
+import { join as join5, relative } from "path";
+import { createInterface } from "readline";
 import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 loadConnectorVersions();
 var isTTY = process.stdout.isTTY ?? false;
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.2.3");
+program2.name("connectors").description("Install API connectors for your project").version("0.2.4");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -6176,7 +6521,19 @@ Run 'connectors --help' for full usage.`);
   }
   render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
 });
-program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors, options) => {
+function listFilesRecursive(dir, base = dir) {
+  const files = [];
+  for (const entry of readdirSync4(dir)) {
+    const fullPath = join5(dir, entry);
+    if (statSync3(fullPath).isDirectory()) {
+      files.push(...listFilesRecursive(fullPath, base));
+    } else {
+      files.push(relative(base, fullPath));
+    }
+  }
+  return files;
+}
+program2.command("install").alias("add").argument("[connectors...]", "Connectors to install").option("-o, --overwrite", "Overwrite existing connectors", false).option("-d, --dry-run", "Preview what would be installed without making changes", false).option("--json", "Output results as JSON", false).description("Install one or more connectors").action((connectors, options) => {
   if (connectors.length === 0) {
     if (!isTTY) {
       console.error("Error: specify connectors to install. Example: connectors install figma stripe");
@@ -6185,6 +6542,101 @@ program2.command("install").alias("add").argument("[connectors...]", "Connectors
     render(/* @__PURE__ */ jsxDEV7(App, {}, undefined, false, undefined, this));
     return;
   }
+  if (options.dryRun) {
+    const installed = getInstalledConnectors();
+    const destDir = join5(process.cwd(), ".connectors");
+    const actions = [];
+    for (const name of connectors) {
+      if (!/^[a-z0-9-]+$/.test(name)) {
+        actions.push({ connector: name, action: "error", reason: `Invalid connector name '${name}'` });
+        continue;
+      }
+      const meta = getConnector(name);
+      if (!meta) {
+        actions.push({ connector: name, action: "error", reason: `Connector '${name}' not found in registry` });
+        continue;
+      }
+      if (!connectorExists(name)) {
+        actions.push({ connector: name, action: "error", reason: `Connector '${name}' source files not found` });
+        continue;
+      }
+      const connectorDirName = name.startsWith("connect-") ? name : `connect-${name}`;
+      const sourcePath = getConnectorPath(name);
+      const destPath = join5(destDir, connectorDirName);
+      const alreadyInstalled = installed.includes(name);
+      const files = listFilesRecursive(sourcePath);
+      const importLine = `export * as ${name} from './${connectorDirName}/src/index.js';`;
+      if (alreadyInstalled && !options.overwrite) {
+        actions.push({
+          connector: name,
+          action: "skip",
+          reason: "Already installed. Use --overwrite to replace.",
+          sourcePath,
+          destPath
+        });
+      } else {
+        actions.push({
+          connector: name,
+          action: alreadyInstalled ? "overwrite" : "install",
+          sourcePath,
+          destPath,
+          files,
+          importLine
+        });
+      }
+    }
+    if (options.json) {
+      console.log(JSON.stringify({ dryRun: true, actions }, null, 2));
+      process.exit(actions.every((a) => a.action !== "error") ? 0 : 1);
+      return;
+    }
+    console.log(chalk2.bold(`
+Dry run \u2014 no changes will be made
+`));
+    for (const a of actions) {
+      if (a.action === "error") {
+        console.log(chalk2.red(`  \u2717 ${a.connector}: ${a.reason}`));
+        continue;
+      }
+      if (a.action === "skip") {
+        console.log(chalk2.yellow(`  \u2298 ${a.connector}: ${a.reason}`));
+        continue;
+      }
+      const actionLabel = a.action === "overwrite" ? chalk2.yellow("overwrite") : chalk2.green("install");
+      console.log(`  ${actionLabel} ${chalk2.cyan(a.connector)}`);
+      console.log(chalk2.dim(`    source: ${a.sourcePath}`));
+      console.log(chalk2.dim(`    dest:   ${a.destPath}`));
+      if (a.files && a.files.length > 0) {
+        console.log(chalk2.dim(`    files (${a.files.length}):`));
+        for (const f of a.files) {
+          console.log(chalk2.dim(`      ${f}`));
+        }
+      }
+      if (a.importLine) {
+        console.log(`    ${chalk2.dim("index.ts:")} ${a.importLine}`);
+      }
+      console.log();
+    }
+    const installCount = actions.filter((a) => a.action === "install").length;
+    const overwriteCount = actions.filter((a) => a.action === "overwrite").length;
+    const skipCount = actions.filter((a) => a.action === "skip").length;
+    const errorCount = actions.filter((a) => a.action === "error").length;
+    const parts = [];
+    if (installCount)
+      parts.push(chalk2.green(`${installCount} to install`));
+    if (overwriteCount)
+      parts.push(chalk2.yellow(`${overwriteCount} to overwrite`));
+    if (skipCount)
+      parts.push(chalk2.yellow(`${skipCount} skipped`));
+    if (errorCount)
+      parts.push(chalk2.red(`${errorCount} failed`));
+    console.log(`  ${chalk2.bold("Summary:")} ${parts.join(", ")}`);
+    console.log(chalk2.dim(`
+  Run without --dry-run to apply.
+`));
+    process.exit(errorCount > 0 ? 1 : 0);
+    return;
+  }
   const results = connectors.map((name) => installConnector(name, { overwrite: options.overwrite }));
   if (options.json) {
     console.log(JSON.stringify(results, null, 2));
@@ -6216,20 +6668,74 @@ Next steps:`));
 program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available connectors", false).option("-i, --installed", "Show only installed connectors", false).option("--json", "Output as JSON", false).description("List available or installed connectors").action((options) => {
   if (options.installed) {
     const installed = getInstalledConnectors();
-    if (options.json) {
-      console.log(JSON.stringify(installed));
+    if (installed.length === 0) {
+      if (options.json) {
+        console.log(JSON.stringify([]));
+      } else {
+        console.log(chalk2.dim("No connectors installed"));
+      }
       return;
     }
-    if (installed.length === 0) {
-      console.log(chalk2.dim("No connectors installed"));
+    const statuses = installed.map((name) => {
+      const meta = getConnector(name);
+      const auth = getAuthStatus(name);
+      let expiryLabel = null;
+      let expired = false;
+      if (auth.type === "oauth" && auth.tokenExpiry) {
+        const remaining = auth.tokenExpiry - Date.now();
+        if (remaining <= 0) {
+          expiryLabel = "Expired";
+          expired = true;
+        } else {
+          const minutes = Math.floor(remaining / 60000);
+          if (minutes < 60) {
+            expiryLabel = `Expires ${minutes}m`;
+          } else {
+            const hours = Math.floor(minutes / 60);
+            expiryLabel = `Expires ${hours}h`;
+          }
+        }
+      }
+      return {
+        name,
+        category: meta?.category || "Unknown",
+        authType: auth.type,
+        configured: auth.configured,
+        expired,
+        expiryLabel,
+        tokenExpiry: auth.tokenExpiry || null,
+        hasRefreshToken: auth.hasRefreshToken || false
+      };
+    });
+    if (options.json) {
+      console.log(JSON.stringify(statuses, null, 2));
       return;
     }
+    const nameWidth = Math.max(6, ...statuses.map((s) => s.name.length)) + 2;
+    const catWidth = Math.max(10, ...statuses.map((s) => s.category.length)) + 2;
+    const authWidth = 10;
     console.log(chalk2.bold(`
 Installed connectors (${installed.length}):
 `));
-    for (const name of installed) {
-      console.log(`  ${name}`);
+    console.log(`  ${chalk2.dim("Name".padEnd(nameWidth))}` + `${chalk2.dim("Category".padEnd(catWidth))}` + `${chalk2.dim("Auth Type".padEnd(authWidth))}` + `${chalk2.dim("Status")}`);
+    console.log(chalk2.dim(`  ${"\u2500".repeat(nameWidth + catWidth + authWidth + 24)}`));
+    for (const s of statuses) {
+      const authTypeLabel = s.authType === "oauth" ? "OAuth" : s.authType === "apikey" ? "API Key" : "Bearer";
+      let statusLabel;
+      if (s.configured && s.expired) {
+        statusLabel = chalk2.yellow("\u26A0 Token expired");
+      } else if (s.configured) {
+        statusLabel = chalk2.green("\u2713 Configured");
+      } else {
+        statusLabel = chalk2.red("\u2717 Needs auth");
+      }
+      let expiryStr = "";
+      if (s.expiryLabel && s.configured && !s.expired) {
+        expiryStr = `   ${chalk2.dim(s.expiryLabel)}`;
+      }
+      console.log(`  ${chalk2.cyan(s.name.padEnd(nameWidth))}` + `${s.category.padEnd(catWidth)}` + `${authTypeLabel.padEnd(authWidth)}` + `${statusLabel}${expiryStr}`);
     }
+    console.log();
     return;
   }
   if (options.category) {
@@ -6449,7 +6955,7 @@ Starting Connectors Dashboard...
   const { startServer: startServer2 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
   await startServer2(port, { open: options.open });
 });
-program2.command("update").description("Update all installed connectors to the latest version from the package").option("--json", "Output as JSON", false).action((options) => {
+program2.command("update").argument("[connectors...]", "Specific connectors to update (default: all installed)").description("Update installed connectors to the latest version from the package").option("-a, --all", "Update all without prompting", false).option("--json", "Output as JSON", false).action(async (connectors, options) => {
   const installed = getInstalledConnectors();
   if (installed.length === 0) {
     if (options.json) {
@@ -6459,14 +6965,57 @@ program2.command("update").description("Update all installed connectors to the l
     }
     return;
   }
-  const results = installed.map((name) => installConnector(name, { overwrite: true }));
+  let toUpdate;
+  if (connectors.length > 0) {
+    const notInstalled = connectors.filter((name) => !installed.includes(name));
+    if (notInstalled.length > 0) {
+      if (options.json) {
+        console.log(JSON.stringify({ error: `Not installed: ${notInstalled.join(", ")}` }));
+      } else {
+        console.log(chalk2.red(`Not installed: ${notInstalled.join(", ")}`));
+        console.log(chalk2.dim("Installed connectors: " + installed.join(", ")));
+      }
+      process.exit(1);
+      return;
+    }
+    toUpdate = connectors;
+  } else if (options.all || !isTTY) {
+    toUpdate = installed;
+  } else {
+    console.log(chalk2.bold(`
+Installed connectors (${installed.length}):
+`));
+    for (const name of installed) {
+      console.log(`  ${chalk2.cyan(name)}`);
+    }
+    console.log();
+    const confirmed = await new Promise((resolve) => {
+      const rl = createInterface({
+        input: process.stdin,
+        output: process.stdout
+      });
+      rl.question(`  Update all ${installed.length} connector(s)? (y/N) `, (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase() === "y" || answer.trim().toLowerCase() === "yes");
+      });
+    });
+    if (!confirmed) {
+      console.log(chalk2.dim(`
+  Aborted. Use 'connectors update <name1> <name2>' to update specific connectors.
+`));
+      process.exit(0);
+      return;
+    }
+    toUpdate = installed;
+  }
+  const results = toUpdate.map((name) => installConnector(name, { overwrite: true }));
   if (options.json) {
     console.log(JSON.stringify(results, null, 2));
     process.exit(results.every((r) => r.success) ? 0 : 1);
     return;
   }
   console.log(chalk2.bold(`
-Updating ${installed.length} connector(s)...
+Updating ${toUpdate.length} connector(s)...
 `));
   for (const result of results) {
     if (result.success) {
@@ -6477,4 +7026,481 @@ Updating ${installed.length} connector(s)...
   }
   process.exit(results.every((r) => r.success) ? 0 : 1);
 });
+program2.command("status").option("--json", "Output as JSON", false).description("Show auth status of installed connectors").action((options) => {
+  const installed = getInstalledConnectors();
+  if (installed.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify([]));
+    } else {
+      console.log(chalk2.dim("No connectors installed. Run: connectors install <name>"));
+    }
+    return;
+  }
+  const statuses = installed.map((name) => {
+    const meta = getConnector(name);
+    const auth = getAuthStatus(name);
+    let expiryLabel = null;
+    let expired = false;
+    if (auth.type === "oauth" && auth.tokenExpiry) {
+      const remaining = auth.tokenExpiry - Date.now();
+      if (remaining <= 0) {
+        expiryLabel = "Expired";
+        expired = true;
+      } else {
+        const minutes = Math.floor(remaining / 60000);
+        if (minutes < 60) {
+          expiryLabel = `Expires ${minutes}m`;
+        } else {
+          const hours = Math.floor(minutes / 60);
+          expiryLabel = `Expires ${hours}h`;
+        }
+      }
+    }
+    return {
+      name,
+      category: meta?.category || "Unknown",
+      authType: auth.type,
+      configured: auth.configured,
+      expired,
+      expiryLabel,
+      tokenExpiry: auth.tokenExpiry || null,
+      hasRefreshToken: auth.hasRefreshToken || false
+    };
+  });
+  if (options.json) {
+    console.log(JSON.stringify(statuses, null, 2));
+    return;
+  }
+  const nameWidth = Math.max(6, ...statuses.map((s) => s.name.length)) + 2;
+  const catWidth = Math.max(10, ...statuses.map((s) => s.category.length)) + 2;
+  const authWidth = 10;
+  console.log(chalk2.bold(`
+Connector Status
+`));
+  console.log(`  ${chalk2.dim("Name".padEnd(nameWidth))}` + `${chalk2.dim("Category".padEnd(catWidth))}` + `${chalk2.dim("Auth Type".padEnd(authWidth))}` + `${chalk2.dim("Status")}`);
+  console.log(chalk2.dim(`  ${"\u2500".repeat(nameWidth + catWidth + authWidth + 24)}`));
+  for (const s of statuses) {
+    const authTypeLabel = s.authType === "oauth" ? "OAuth" : s.authType === "apikey" ? "API Key" : "Bearer";
+    let statusLabel;
+    if (s.configured && s.expired) {
+      statusLabel = chalk2.yellow("\u26A0 Token expired");
+    } else if (s.configured) {
+      statusLabel = chalk2.green("\u2713 Configured");
+    } else {
+      statusLabel = chalk2.red("\u2717 Not configured");
+    }
+    let expiryStr = "";
+    if (s.expiryLabel && s.configured && !s.expired) {
+      expiryStr = `   ${chalk2.dim(s.expiryLabel)}`;
+    }
+    console.log(`  ${chalk2.cyan(s.name.padEnd(nameWidth))}` + `${s.category.padEnd(catWidth)}` + `${authTypeLabel.padEnd(authWidth)}` + `${statusLabel}${expiryStr}`);
+  }
+  console.log();
+});
+program2.command("doctor").option("--json", "Output as JSON", false).description("Check all installed connectors for issues and output a health report").action((options) => {
+  const installed = getInstalledConnectors();
+  if (installed.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ connectors: [], summary: { healthy: 0, warnings: 0, errors: 0 } }));
+    } else {
+      console.log(chalk2.dim("No connectors installed. Run: connectors install <name>"));
+    }
+    return;
+  }
+  const ONE_HOUR = 60 * 60 * 1000;
+  const results = installed.map((name) => {
+    const meta = getConnector(name);
+    const auth = getAuthStatus(name);
+    const issues = [];
+    const suggestions = [];
+    let level = "healthy";
+    if (!auth.configured) {
+      level = "error";
+      issues.push("Not configured");
+      if (auth.type === "oauth") {
+        suggestions.push(`Run 'connectors serve' and authenticate ${name} via OAuth`);
+      } else {
+        suggestions.push(`Run 'connectors auth ${name}' to configure`);
+      }
+    } else if (auth.type === "oauth" && auth.tokenExpiry) {
+      const remaining = auth.tokenExpiry - Date.now();
+      if (remaining <= 0) {
+        level = "error";
+        issues.push("Token expired");
+        if (auth.hasRefreshToken) {
+          suggestions.push(`Run 'connectors serve' and refresh the token for ${name}`);
+        } else {
+          suggestions.push(`Run 'connectors serve' and re-authenticate ${name} via OAuth`);
+        }
+      } else if (remaining < ONE_HOUR) {
+        level = "warning";
+        const minutes = Math.floor(remaining / 60000);
+        issues.push(`Token expiring soon (${minutes}m remaining)`);
+        suggestions.push(`Refresh the token for ${name} before it expires`);
+      }
+    }
+    if (auth.configured && auth.envVarTotalCount > 1 && auth.envVarSetCount < auth.envVarTotalCount) {
+      if (level === "healthy")
+        level = "warning";
+      issues.push(`Partially configured (${auth.envVarSetCount}/${auth.envVarTotalCount} env vars set)`);
+      const missingVars = auth.envVars.filter((v) => !v.set).map((v) => v.variable);
+      suggestions.push(`Set missing env vars: ${missingVars.join(", ")}`);
+    }
+    return {
+      name,
+      displayName: meta?.displayName || name,
+      category: meta?.category || "Unknown",
+      authType: auth.type,
+      level,
+      issues,
+      suggestions
+    };
+  });
+  const summary = {
+    healthy: results.filter((r) => r.level === "healthy").length,
+    warnings: results.filter((r) => r.level === "warning").length,
+    errors: results.filter((r) => r.level === "error").length
+  };
+  if (options.json) {
+    console.log(JSON.stringify({ connectors: results, summary }, null, 2));
+    process.exit(summary.errors > 0 ? 1 : 0);
+    return;
+  }
+  console.log(chalk2.bold(`
+Connector Health Report
+`));
+  for (const r of results) {
+    let icon;
+    if (r.level === "healthy") {
+      icon = chalk2.green("\u2713");
+    } else if (r.level === "warning") {
+      icon = chalk2.yellow("\u26A0");
+    } else {
+      icon = chalk2.red("\u2717");
+    }
+    const nameStr = r.level === "healthy" ? chalk2.green(r.name) : r.level === "warning" ? chalk2.yellow(r.name) : chalk2.red(r.name);
+    if (r.issues.length === 0) {
+      console.log(`  ${icon} ${nameStr} \u2014 ${chalk2.green("healthy")}`);
+    } else {
+      console.log(`  ${icon} ${nameStr} \u2014 ${r.issues.join(", ")}`);
+      for (const suggestion of r.suggestions) {
+        console.log(chalk2.dim(`      \u2192 ${suggestion}`));
+      }
+    }
+  }
+  const parts = [];
+  if (summary.healthy > 0)
+    parts.push(chalk2.green(`${summary.healthy} healthy`));
+  if (summary.warnings > 0)
+    parts.push(chalk2.yellow(`${summary.warnings} warning${summary.warnings !== 1 ? "s" : ""}`));
+  if (summary.errors > 0)
+    parts.push(chalk2.red(`${summary.errors} error${summary.errors !== 1 ? "s" : ""}`));
+  console.log(`
+  ${chalk2.bold("Summary:")} ${parts.join(", ")}`);
+  if (summary.errors > 0 || summary.warnings > 0) {
+    console.log(chalk2.dim(`
+  Run 'connectors auth <name>' to configure individual connectors.`));
+    console.log(chalk2.dim(`  Run 'connectors serve' to manage auth via the dashboard.
+`));
+  } else {
+    console.log(chalk2.green(`
+  All connectors are healthy!
+`));
+  }
+  process.exit(summary.errors > 0 ? 1 : 0);
+});
+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).description("Configure authentication for a connector").action(async (connector, options) => {
+  const meta = getConnector(connector);
+  if (!meta) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+    } else {
+      console.log(chalk2.red(`Connector '${connector}' not found`));
+    }
+    process.exit(1);
+    return;
+  }
+  const authType = getAuthType(connector);
+  const statusBefore = getAuthStatus(connector);
+  if (!options.json) {
+    const statusLabel = statusBefore.configured ? chalk2.green("configured") : chalk2.red("not configured");
+    console.log(chalk2.bold(`
+${meta.displayName} \u2014 Auth Configuration
+`));
+    console.log(`  Auth type: ${authType === "oauth" ? "OAuth" : authType === "apikey" ? "API Key" : "Bearer Token"}`);
+    console.log(`  Status:    ${statusLabel}`);
+    const envVars2 = getEnvVars(connector);
+    if (envVars2.length > 0) {
+      console.log(`  Fields:    ${envVars2.map((v) => v.variable).join(", ")}`);
+    }
+    console.log();
+  }
+  if (authType === "oauth") {
+    if (options.json) {
+      console.log(JSON.stringify({
+        connector,
+        authType: "oauth",
+        message: "OAuth connectors require browser-based authentication. Use 'connectors serve' or pass --key to set tokens manually."
+      }));
+      process.exit(0);
+      return;
+    }
+    console.log(chalk2.yellow("OAuth connectors require browser-based authentication."));
+    console.log();
+    try {
+      const port = 19426 + Math.floor(Math.random() * 1000);
+      const { startServer: startServer2 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
+      console.log(chalk2.dim(`Starting temporary server on port ${port}...`));
+      await startServer2(port, { open: false });
+      const oauthUrl = `http://localhost:${port}/oauth/${connector}/start`;
+      console.log(chalk2.bold(`
+Open this URL to authenticate:
+`));
+      console.log(`  ${chalk2.cyan(oauthUrl)}
+`);
+      try {
+        const { exec } = await import("child_process");
+        const openCmd = process.platform === "darwin" ? "open" : process.platform === "win32" ? "start" : "xdg-open";
+        exec(`${openCmd} "${oauthUrl}"`);
+        console.log(chalk2.dim("Browser opened. Complete the OAuth flow, then press Ctrl+C to stop the server."));
+      } catch {
+        console.log(chalk2.dim("Open the URL above in your browser to complete authentication."));
+      }
+      console.log(chalk2.dim(`Press Ctrl+C when done.
+`));
+      await new Promise(() => {});
+    } catch (err) {
+      console.log(chalk2.red(`Failed to start OAuth flow: ${err}`));
+      console.log(chalk2.dim("Try 'connectors serve' to use the full dashboard instead."));
+      process.exit(1);
+    }
+    return;
+  }
+  if (options.key) {
+    saveApiKey(connector, options.key, options.field || undefined);
+    const statusAfter2 = getAuthStatus(connector);
+    if (options.json) {
+      console.log(JSON.stringify({
+        connector,
+        authType,
+        configured: statusAfter2.configured,
+        field: options.field || null
+      }));
+    } else {
+      console.log(chalk2.green(`\u2713 API key saved for ${meta.displayName}`));
+      if (options.field) {
+        console.log(chalk2.dim(`  Field: ${options.field}`));
+      }
+    }
+    process.exit(0);
+    return;
+  }
+  if (!isTTY) {
+    if (options.json) {
+      console.log(JSON.stringify({ error: "Interactive mode requires a TTY. Use --key flag." }));
+    } else {
+      console.log(chalk2.red("Interactive mode requires a TTY. Use --key <value> to set non-interactively."));
+    }
+    process.exit(1);
+    return;
+  }
+  const envVars = getEnvVars(connector);
+  const fieldLabel = options.field ? options.field : envVars.length > 0 ? envVars[0].variable : "API Key";
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const key = await new Promise((resolve) => {
+    let input = "";
+    process.stdout.write(`  Enter ${fieldLabel}: `);
+    if (process.stdin.isTTY) {
+      process.stdin.setRawMode(true);
+    }
+    process.stdin.resume();
+    process.stdin.setEncoding("utf-8");
+    const onData = (ch) => {
+      const c = ch.toString();
+      if (c === `
+` || c === "\r" || c === "\x04") {
+        process.stdout.write(`
+`);
+        process.stdin.removeListener("data", onData);
+        if (process.stdin.isTTY) {
+          process.stdin.setRawMode(false);
+        }
+        process.stdin.pause();
+        rl.close();
+        resolve(input);
+      } else if (c === "\x03") {
+        process.stdout.write(`
+`);
+        rl.close();
+        process.exit(0);
+      } else if (c === "\x7F" || c === "\b") {
+        if (input.length > 0) {
+          input = input.slice(0, -1);
+          process.stdout.write("\b \b");
+        }
+      } else {
+        input += c;
+        process.stdout.write("*");
+      }
+    };
+    process.stdin.on("data", onData);
+  });
+  if (!key.trim()) {
+    console.log(chalk2.red(`
+  No key provided. Aborting.`));
+    process.exit(1);
+    return;
+  }
+  saveApiKey(connector, key.trim(), options.field || undefined);
+  const statusAfter = getAuthStatus(connector);
+  console.log(chalk2.green(`
+\u2713 API key saved for ${meta.displayName}`));
+  if (statusAfter.configured) {
+    console.log(chalk2.green(`  Status: configured`));
+  }
+  process.exit(0);
+});
+program2.command("init").option("--json", "Output categories and connectors as JSON (non-interactive)", false).description("Guided onboarding: pick categories, choose connectors, install them").action(async (options) => {
+  if (options.json) {
+    const data = CATEGORIES.map((category) => ({
+      name: category,
+      connectors: getConnectorsByCategory(category).map((c) => ({
+        name: c.name,
+        displayName: c.displayName,
+        description: c.description,
+        version: c.version || null
+      }))
+    }));
+    console.log(JSON.stringify(data, null, 2));
+    process.exit(0);
+    return;
+  }
+  if (!isTTY) {
+    console.error("Interactive mode requires a TTY. Use --json for non-interactive output.");
+    process.exit(1);
+    return;
+  }
+  function ask(question) {
+    return new Promise((resolve) => {
+      const rl = createInterface({ input: process.stdin, output: process.stdout });
+      rl.question(question, (answer) => {
+        rl.close();
+        resolve(answer.trim());
+      });
+    });
+  }
+  console.log();
+  console.log(chalk2.bold("Welcome to Connectors!"));
+  console.log(chalk2.dim(`Let's get you set up with the API connectors you need.
+`));
+  console.log(chalk2.bold(`Available categories:
+`));
+  const categoryList = CATEGORIES.map((cat) => ({
+    name: cat,
+    connectors: getConnectorsByCategory(cat)
+  }));
+  for (let i = 0;i < categoryList.length; i++) {
+    const c = categoryList[i];
+    console.log(`  ${chalk2.cyan(String(i + 1).padStart(2))}. ${c.name} ${chalk2.dim(`(${c.connectors.length} connectors)`)}`);
+  }
+  console.log();
+  const catAnswer = await ask(chalk2.bold("Pick categories") + chalk2.dim(" (comma-separated numbers, e.g. 1,3,5): "));
+  if (!catAnswer) {
+    console.log(chalk2.dim(`
+No categories selected. Exiting.
+`));
+    process.exit(0);
+    return;
+  }
+  const catIndices = catAnswer.split(",").map((s) => parseInt(s.trim(), 10) - 1).filter((i) => i >= 0 && i < categoryList.length);
+  if (catIndices.length === 0) {
+    console.log(chalk2.red(`
+No valid categories selected. Exiting.
+`));
+    process.exit(1);
+    return;
+  }
+  const selectedCategories = catIndices.map((i) => categoryList[i]);
+  const seen = new Set;
+  const connectorPool = [];
+  for (const cat of selectedCategories) {
+    for (const c of cat.connectors) {
+      if (!seen.has(c.name)) {
+        seen.add(c.name);
+        connectorPool.push({
+          name: c.name,
+          displayName: c.displayName,
+          description: c.description,
+          category: cat.name
+        });
+      }
+    }
+  }
+  console.log();
+  console.log(chalk2.bold(`Connectors in ${selectedCategories.map((c) => c.name).join(", ")}:
+`));
+  const nameWidth = Math.max(12, ...connectorPool.map((c) => c.name.length)) + 2;
+  for (let i = 0;i < connectorPool.length; i++) {
+    const c = connectorPool[i];
+    console.log(`  ${chalk2.cyan(String(i + 1).padStart(3))}. ${c.name.padEnd(nameWidth)}${chalk2.dim(c.description)}`);
+  }
+  console.log();
+  const connAnswer = await ask(chalk2.bold("Install which connectors?") + chalk2.dim(" (comma-separated numbers, or 'all'): "));
+  if (!connAnswer) {
+    console.log(chalk2.dim(`
+No connectors selected. Exiting.
+`));
+    process.exit(0);
+    return;
+  }
+  let toInstall;
+  if (connAnswer.toLowerCase() === "all") {
+    toInstall = connectorPool.map((c) => c.name);
+  } else {
+    const connIndices = connAnswer.split(",").map((s) => parseInt(s.trim(), 10) - 1).filter((i) => i >= 0 && i < connectorPool.length);
+    if (connIndices.length === 0) {
+      console.log(chalk2.red(`
+No valid connectors selected. Exiting.
+`));
+      process.exit(1);
+      return;
+    }
+    toInstall = connIndices.map((i) => connectorPool[i].name);
+  }
+  console.log(chalk2.bold(`
+Installing ${toInstall.length} connector(s)...
+`));
+  const results = toInstall.map((name) => installConnector(name, { overwrite: false }));
+  const succeeded = [];
+  for (const result of results) {
+    if (result.success) {
+      console.log(chalk2.green(`  \u2713 ${result.connector}`));
+      succeeded.push(result.connector);
+    } else {
+      console.log(chalk2.red(`  \u2717 ${result.connector}: ${result.error}`));
+    }
+  }
+  if (succeeded.length > 0) {
+    console.log(chalk2.bold(`
+Next steps:
+`));
+    console.log(`  ${chalk2.dim("1.")} Import in your code:`);
+    console.log(`     ${chalk2.cyan(`import { ${succeeded.slice(0, 3).join(", ")}${succeeded.length > 3 ? ", ..." : ""} } from './.connectors'`)}`);
+    console.log();
+    console.log(`  ${chalk2.dim("2.")} Configure authentication:`);
+    console.log(`     ${chalk2.cyan("connectors auth <name>")}  ${chalk2.dim("\u2014 set API keys interactively")}`);
+    console.log(`     ${chalk2.cyan("connectors serve")}        ${chalk2.dim("\u2014 open dashboard for OAuth setup")}`);
+    console.log();
+    console.log(`  ${chalk2.dim("3.")} Check connector docs:`);
+    console.log(`     ${chalk2.cyan(`connectors docs ${succeeded[0]}`)}  ${chalk2.dim("\u2014 see auth & env var details")}`);
+    console.log();
+    console.log(`  ${chalk2.dim("4.")} Verify everything works:`);
+    console.log(`     ${chalk2.cyan("connectors doctor")}       ${chalk2.dim("\u2014 health check all connectors")}`);
+  }
+  console.log();
+  process.exit(results.every((r) => r.success) ? 0 : 1);
+});
 program2.parse();