@hasna/connectors 0.5.5 → 0.5.7

package/bin/index.js

@@ -7185,6 +7185,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -7206,7 +7239,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";
@@ -7281,7 +7314,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.7").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 +7679,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 +7708,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 +7719,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 +7799,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 +7851,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 +8167,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 +9074,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 +9103,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 +9204,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 +9242,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 +9290,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 +9315,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

@@ -20676,6 +20676,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join4(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -20697,7 +20730,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";
@@ -20763,7 +20796,7 @@ async function getConnectorCommandHelp(name, command) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.5.5"
+  version: "0.5.7"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
@@ -20802,7 +20835,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 +20865,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 +20954,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 +20977,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 +21055,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 +21064,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 +21109,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 +21165,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/dist/index.js

@@ -1103,6 +1103,39 @@ function resolveConnectorsDir2() {
   return fromBin;
 }
 var CONNECTORS_DIR2 = resolveConnectorsDir2();
+var ENV_VAR_NAME_OVERRIDES = {
+  googlemaps: ["GOOGLE_MAPS"],
+  googletasks: ["GOOGLE_TASKS", "GOOGLE"],
+  google: ["GOOGLE"],
+  stabilityai: ["STABILITY"],
+  openweathermap: ["OPENWEATHERMAP", "OPENWEATHER"]
+};
+function buildEnvWithCredentials(connectorName, baseEnv) {
+  const env = { ...baseEnv };
+  const prefixes = ENV_VAR_NAME_OVERRIDES[connectorName] || [
+    connectorName.toUpperCase().replace(/-/g, "_")
+  ];
+  for (const prefix of prefixes) {
+    const canonicalKey = `${prefix}_API_KEY`;
+    if (env[canonicalKey])
+      continue;
+    const alternatives = [
+      `HASNAXYZ_${prefix}_LIVE_API_KEY`,
+      `HASNA_${prefix}_LIVE_API_KEY`,
+      `${prefix}_LIVE_API_KEY`,
+      `${prefix}_KEY`,
+      `${prefix}_TOKEN`
+    ];
+    for (const alt of alternatives) {
+      const value = env[alt];
+      if (value) {
+        env[canonicalKey] = value;
+        break;
+      }
+    }
+  }
+  return env;
+}
 function getConnectorCliPath(name) {
   const safeName = name.replace(/[^a-z0-9-]/g, "");
   const connectorDir = join3(CONNECTORS_DIR2, `connect-${safeName}`);
@@ -1124,7 +1157,7 @@ function runConnectorCommand(name, args, timeoutMs = 30000) {
   return new Promise((resolve) => {
     const proc = spawn("bun", ["run", cliPath, ...args], {
       timeout: timeoutMs,
-      env: { ...process.env },
+      env: buildEnvWithCredentials(name, process.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     let stdout = "";

package/dist/lib/runner.d.ts

@@ -6,6 +6,22 @@
  * them as subprocesses and capture stdout/stderr. This keeps the main CLI/MCP
  * lightweight while exposing every connector's full API.
  */
+/**
+ * Build the subprocess env with auto-detected credentials.
+ *
+ * For each connector we derive the "canonical" env var (e.g. EXA_API_KEY)
+ * and, if it's not already set, check common alternative patterns from the
+ * user's environment. When a match is found we inject it so the connector
+ * subprocess can read it.
+ *
+ * Patterns checked (in priority order):
+ *   1. HASNAXYZ_{NAME}_LIVE_API_KEY  → {NAME}_API_KEY
+ *   2. HASNA_{NAME}_LIVE_API_KEY     → {NAME}_API_KEY
+ *   3. {NAME}_LIVE_API_KEY           → {NAME}_API_KEY
+ *   4. {NAME}_KEY                    → {NAME}_API_KEY
+ *   5. {NAME}_TOKEN                  → {NAME}_API_KEY
+ */
+export declare function buildEnvWithCredentials(connectorName: string, baseEnv: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
 /**
  * Get the path to a connector's CLI entry point.
  * Returns null if the connector has no CLI.

package/package.json

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