@hasna/connectors 0.5.4 → 0.5.6

package/bin/index.js

@@ -7281,7 +7281,7 @@ var PRESETS = {
   commerce: { description: "Commerce and finance", connectors: ["stripe", "shopify", "revolut", "mercury", "pandadoc"] }
 };
 var program2 = new Command;
-program2.name("connectors").description("Install API connectors for your project").version("0.5.4").enablePositionalOptions();
+program2.name("connectors").description("Install API connectors for your project").version("0.5.6").enablePositionalOptions();
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -7646,10 +7646,11 @@ program2.command("info").argument("<connector>", "Connector name").option("--jso
   const meta = getConnector(connector);
   if (!meta) {
     if (options.json) {
-      console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+      console.log(JSON.stringify({ error: `Connector '${connector}' not found. Run 'connectors list' to see available connectors.` }));
       process.exit(1);
     }
     console.log(chalk2.red(`Connector '${connector}' not found`));
+    console.log(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${connector}' to search.`));
     process.exit(1);
     return;
   }
@@ -7674,9 +7675,10 @@ program2.command("docs").argument("<connector>", "Connector name").option("--jso
   const meta = getConnector(connector);
   if (!meta) {
     if (options.json) {
-      console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+      console.log(JSON.stringify({ error: `Connector '${connector}' not found. Run 'connectors list' to see available connectors.` }));
     } else {
       console.log(chalk2.red(`Connector '${connector}' not found`));
+      console.log(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${connector}' to search.`));
     }
     process.exit(1);
     return;
@@ -7684,9 +7686,10 @@ program2.command("docs").argument("<connector>", "Connector name").option("--jso
   const docs = getConnectorDocs(connector);
   if (!docs) {
     if (options.json) {
-      console.log(JSON.stringify({ error: `No documentation found for '${connector}'` }));
+      console.log(JSON.stringify({ error: `No documentation found for '${connector}'. The connector may not be installed yet. Run 'connectors install ${connector}' first.` }));
     } else {
       console.log(chalk2.red(`No documentation found for '${connector}'`));
+      console.log(chalk2.dim(`The connector may not be installed yet. Run 'connectors install ${connector}' first.`));
     }
     process.exit(1);
     return;
@@ -7763,6 +7766,7 @@ program2.command("remove").alias("rm").argument("<connector>", "Connector to rem
     console.log(chalk2.green(`\u2713 Removed ${connector}`));
   } else {
     console.log(chalk2.red(`\u2717 ${connector} is not installed`));
+    console.log(chalk2.dim(`Run 'connectors install ${connector}' to install it, or 'connectors list --installed' to see installed connectors.`));
     process.exit(1);
   }
 });
@@ -7814,7 +7818,7 @@ program2.command("update").argument("[connectors...]", "Specific connectors to u
         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(", ")));
+        console.log(chalk2.dim(`Run 'connectors install ${notInstalled[0]}' to install, or 'connectors list --installed' to see installed connectors.`));
       }
       process.exit(1);
       return;
@@ -7867,19 +7871,21 @@ Updating ${toUpdate.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) => {
+program2.command("status").option("--json", "Output as JSON", false).description("Show auth status of all configured connectors (project + global)").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 configDir = join6(homedir3(), ".connectors");
+  const seen = new Set;
+  const allStatuses = [];
+  function buildStatusEntry(name, source) {
     const auth = getAuthStatus(name);
+    const connectorName = name.startsWith("connect-") ? name : `connect-${name}`;
+    const currentProfileFile = join6(configDir, connectorName, "current_profile");
+    let profile = "default";
+    if (existsSync6(currentProfileFile)) {
+      try {
+        profile = readFileSync5(currentProfileFile, "utf-8").trim() || "default";
+      } catch {}
+    }
     let expiryLabel = null;
     let expired = false;
     if (auth.type === "oauth" && auth.tokenExpiry) {
@@ -7899,43 +7905,117 @@ program2.command("status").option("--json", "Output as JSON", false).description
     }
     return {
       name,
-      category: meta?.category || "Unknown",
       authType: auth.type,
       configured: auth.configured,
+      profile,
       expired,
       expiryLabel,
       tokenExpiry: auth.tokenExpiry || null,
-      hasRefreshToken: auth.hasRefreshToken || false
+      hasRefreshToken: auth.hasRefreshToken || false,
+      source
     };
-  });
+  }
+  for (const name of installed) {
+    seen.add(name);
+    allStatuses.push(buildStatusEntry(name, "project"));
+  }
+  if (existsSync6(configDir)) {
+    try {
+      const globalDirs = readdirSync4(configDir).filter((f) => {
+        if (!f.startsWith("connect-"))
+          return false;
+        try {
+          return statSync3(join6(configDir, f)).isDirectory();
+        } catch {
+          return false;
+        }
+      });
+      for (const dir of globalDirs) {
+        const name = dir.replace("connect-", "");
+        if (seen.has(name))
+          continue;
+        seen.add(name);
+        allStatuses.push(buildStatusEntry(name, "global"));
+      }
+    } catch {}
+  }
+  if (allStatuses.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ configured: [], unconfigured: [], summary: { total: 0, configured: 0, unconfigured: 0 } }, null, 2));
+    } else {
+      console.log(chalk2.dim("No connectors found. Run: connectors install <name>"));
+    }
+    return;
+  }
+  const configuredList = allStatuses.filter((s) => s.configured);
+  const unconfiguredList = allStatuses.filter((s) => !s.configured);
   if (options.json) {
-    console.log(JSON.stringify(statuses, null, 2));
+    console.log(JSON.stringify({
+      configured: configuredList,
+      unconfigured: unconfiguredList,
+      summary: {
+        total: allStatuses.length,
+        configured: configuredList.length,
+        unconfigured: unconfiguredList.length
+      }
+    }, 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 nameWidth = Math.max(6, ...allStatuses.map((s) => s.name.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 profileWidth = Math.max(8, ...allStatuses.map((s) => s.profile.length)) + 2;
+  function printRow(s) {
     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");
+      statusLabel = chalk2.yellow("expired");
     } else if (s.configured) {
-      statusLabel = chalk2.green("\u2713 Configured");
+      statusLabel = chalk2.green("yes");
     } else {
-      statusLabel = chalk2.red("\u2717 Not configured");
+      statusLabel = chalk2.red("no");
     }
+    const profileLabel = s.profile.padEnd(profileWidth);
     let expiryStr = "";
-    if (s.expiryLabel && s.configured && !s.expired) {
-      expiryStr = `   ${chalk2.dim(s.expiryLabel)}`;
+    if (s.authType === "oauth") {
+      if (s.expired) {
+        expiryStr = chalk2.yellow("Expired");
+      } else if (s.expiryLabel && s.configured) {
+        expiryStr = chalk2.dim(s.expiryLabel);
+      } else {
+        expiryStr = chalk2.dim("-");
+      }
+    } else {
+      expiryStr = chalk2.dim("-");
+    }
+    const sourceLabel = s.source === "global" ? chalk2.dim(" (global)") : "";
+    console.log(`  ${chalk2.cyan(s.name.padEnd(nameWidth))}` + `${authTypeLabel.padEnd(authWidth)}` + `${statusLabel.padEnd(16)}` + `${profileLabel}` + `${expiryStr}${sourceLabel}`);
+  }
+  function printHeader() {
+    console.log(`  ${chalk2.dim("Name".padEnd(nameWidth))}` + `${chalk2.dim("Auth".padEnd(authWidth))}` + `${chalk2.dim("Configured".padEnd(16))}` + `${chalk2.dim("Profile".padEnd(profileWidth))}` + `${chalk2.dim("Expiry")}`);
+    console.log(chalk2.dim(`  ${"\u2500".repeat(nameWidth + authWidth + 16 + profileWidth + 12)}`));
+  }
+  console.log(chalk2.bold(`
+Connector Status
+`));
+  if (configuredList.length > 0) {
+    console.log(chalk2.green.bold(`  Configured (${configuredList.length})
+`));
+    printHeader();
+    for (const s of configuredList) {
+      printRow(s);
+    }
+    console.log();
+  }
+  if (unconfiguredList.length > 0) {
+    console.log(chalk2.red.bold(`  Unconfigured (${unconfiguredList.length})
+`));
+    printHeader();
+    for (const s of unconfiguredList) {
+      printRow(s);
     }
-    console.log(`  ${chalk2.cyan(s.name.padEnd(nameWidth))}` + `${s.category.padEnd(catWidth)}` + `${authTypeLabel.padEnd(authWidth)}` + `${statusLabel}${expiryStr}`);
+    console.log();
   }
+  console.log(chalk2.dim(`  Total: ${allStatuses.length}  |  Configured: ${configuredList.length}  |  Unconfigured: ${unconfiguredList.length}`));
   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) => {
@@ -8054,9 +8134,10 @@ program2.command("auth").argument("<connector>", "Connector name to configure au
   const meta = getConnector(connector);
   if (!meta) {
     if (options.json) {
-      console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+      console.log(JSON.stringify({ error: `Connector '${connector}' not found. Run 'connectors list' to see available connectors.` }));
     } else {
       console.log(chalk2.red(`Connector '${connector}' not found`));
+      console.log(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${connector}' to search.`));
     }
     process.exit(1);
     return;
@@ -8960,9 +9041,10 @@ program2.command("test").argument("[connector]", "Connector to test (default: al
   if (connector) {
     if (!getConnector(connector)) {
       if (options.json) {
-        console.log(JSON.stringify({ error: `Connector '${connector}' not found` }));
+        console.log(JSON.stringify({ error: `Connector '${connector}' not found. Run 'connectors list' to see available connectors.` }));
       } else {
         console.log(chalk2.red(`Connector '${connector}' not found`));
+        console.log(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${connector}' to search.`));
       }
       process.exit(1);
       return;
@@ -8988,15 +9070,15 @@ Testing connector credentials...
     const auth = getAuthStatus(name);
     const endpoint = TEST_ENDPOINTS[name];
     if (!auth.configured) {
-      results.push({ name, status: "no-key", message: "No credentials configured" });
+      results.push({ name, status: "no-key", message: `No credentials configured. Run 'connectors auth ${name}' or 'connectors setup ${name} --key <your-key>'` });
       if (!options.json)
-        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim("no credentials configured")}`);
+        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim(`no credentials configured \u2014 run 'connectors auth ${name}'`)}`);
       continue;
     }
     if (!endpoint) {
-      results.push({ name, status: "skip", message: "No test endpoint defined" });
+      results.push({ name, status: "skip", message: `No test endpoint defined. Run 'connectors ops ${name}' to see available operations` });
       if (!options.json)
-        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim("no test endpoint (key exists)")}`);
+        console.log(`  ${chalk2.dim("\u25CB")} ${chalk2.dim(name)} \u2014 ${chalk2.dim(`no test endpoint \u2014 run 'connectors ops ${name}' to see operations`)}`);
       continue;
     }
     const docs = getConnectorDocs(name);
@@ -9089,10 +9171,12 @@ Testing connector credentials...
           console.log(`  ${chalk2.green("\u2713")} ${chalk2.green(name)} \u2014 ${chalk2.dim(`${res.status} OK`)} ${chalk2.dim(`(${ms}ms)`)}`);
       } else {
         const body2 = await res.text().catch(() => "");
-        const msg = res.status === 401 ? "Invalid or expired credentials" : `HTTP ${res.status}`;
+        const msg = res.status === 401 ? `Invalid or expired credentials. Run 'connectors auth ${name}' to reconfigure` : `HTTP ${res.status}`;
         results.push({ name, status: "fail", message: msg, ms });
         if (!options.json)
-          console.log(`  ${chalk2.red("\u2717")} ${chalk2.red(name)} \u2014 ${chalk2.red(msg)} ${chalk2.dim(`(${ms}ms)`)}`);
+          console.log(`  ${chalk2.red("\u2717")} ${chalk2.red(name)} \u2014 ${chalk2.red(res.status === 401 ? "Invalid or expired credentials" : `HTTP ${res.status}`)} ${chalk2.dim(`(${ms}ms)`)}`);
+        if (!options.json && res.status === 401)
+          console.log(chalk2.dim(`      \u2192 Run 'connectors auth ${name}' to reconfigure credentials`));
       }
     } catch (e) {
       const ms = Date.now() - start;
@@ -9125,10 +9209,12 @@ program2.command("ops").description("List available API operations for a connect
   const meta = getConnector(name);
   if (!meta) {
     console.error(chalk2.red(`Connector '${name}' not found.`));
+    console.error(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${name}' to search.`));
     process.exit(1);
   }
   if (!getConnectorCliPath(name)) {
     console.error(chalk2.red(`Connector '${name}' does not have a CLI.`));
+    console.error(chalk2.dim(`Run 'connectors docs ${name}' to see how to use this connector programmatically.`));
     process.exit(1);
   }
   if (command) {
@@ -9171,10 +9257,12 @@ program2.command("run").description("Execute an API operation on a connector").a
   const meta = getConnector(name);
   if (!meta) {
     console.error(chalk2.red(`Connector '${name}' not found.`));
+    console.error(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${name}' to search.`));
     process.exit(1);
   }
   if (!getConnectorCliPath(name)) {
     console.error(chalk2.red(`Connector '${name}' does not have a CLI.`));
+    console.error(chalk2.dim(`Run 'connectors docs ${name}' to see how to use this connector programmatically.`));
     process.exit(1);
   }
   if (args.length === 0) {
@@ -9194,9 +9282,10 @@ program2.command("setup").argument("<name>", "Connector name to set up").option(
   const meta = getConnector(name);
   if (!meta) {
     if (options.json) {
-      console.log(JSON.stringify({ error: `Connector '${name}' not found` }));
+      console.log(JSON.stringify({ error: `Connector '${name}' not found. Run 'connectors list' to see available connectors.` }));
     } else {
       console.log(chalk2.red(`Connector '${name}' not found`));
+      console.log(chalk2.dim(`Run 'connectors list' to see available connectors, or 'connectors search ${name}' to search.`));
     }
     process.exit(1);
     return;

package/bin/mcp.js

@@ -20763,7 +20763,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.5.4"
+  version: "0.5.6"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
@@ -20802,7 +20802,7 @@ server.registerTool("list_connectors", {
         content: [
           {
             type: "text",
-            text: `Unknown category: "${category}". Available: ${CATEGORIES.join(", ")}`
+            text: `Unknown category: "${category}". Use list_categories to see available categories: ${CATEGORIES.join(", ")}`
           }
         ],
         isError: true
@@ -20832,14 +20832,14 @@ server.registerTool("connector_docs", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }
   const docs = getConnectorDocs(name);
   if (!docs) {
     return {
-      content: [{ type: "text", text: `No documentation found for '${name}'.` }],
+      content: [{ type: "text", text: `No documentation found for '${name}'. Use install_connector to install it first.` }],
       isError: true
     };
   }
@@ -20921,7 +20921,7 @@ server.registerTool("connector_info", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }
@@ -20944,7 +20944,7 @@ server.registerTool("connector_auth_status", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }
@@ -21022,7 +21022,7 @@ server.registerTool("list_connector_operations", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }
@@ -21031,7 +21031,7 @@ server.registerTool("list_connector_operations", {
       content: [
         {
           type: "text",
-          text: `Connector '${name}' does not have a CLI. It may be API-only.`
+          text: `Connector '${name}' does not have a CLI. It may be API-only. Use connector_docs to see how to use it programmatically.`
         }
       ],
       isError: true
@@ -21076,7 +21076,7 @@ server.registerTool("run_connector_operation", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }
@@ -21132,7 +21132,7 @@ server.registerTool("setup_connector", {
   const meta = getConnector(name);
   if (!meta) {
     return {
-      content: [{ type: "text", text: `Connector '${name}' not found.` }],
+      content: [{ type: "text", text: `Connector '${name}' not found. Use search_connectors or list_connectors to find available connectors.` }],
       isError: true
     };
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/connectors",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {