@hasna/connectors 0.5.5 → 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.5").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;
@@ -8130,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;
@@ -9036,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;
@@ -9064,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);
@@ -9165,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;
@@ -9201,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) {
@@ -9247,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) {
@@ -9270,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.5"
+  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.5",
+  "version": "0.5.6",
   "description": "Open source connector library - Install API connectors with a single command",
   "type": "module",
   "bin": {