@hasna/connectors 0.2.8 → 0.3.0

package/bin/index.js

@@ -6583,7 +6583,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.2.8");
+program2.name("connectors").description("Install API connectors for your project").version("0.3.0");
 program2.command("interactive", { isDefault: true }).alias("i").description("Interactive connector browser").action(() => {
   if (!isTTY) {
     console.log(`Non-interactive environment detected. Use a subcommand:
@@ -7746,7 +7746,7 @@ program2.command("import").argument("<file>", "JSON backup file to import (use -
   }
 });
 program2.command("upgrade").alias("self-update").option("--check", "Only check for updates, don't install", false).option("--json", "Output as JSON", false).description("Check for updates and upgrade to the latest version").action(async (options) => {
-  const currentVersion = "0.2.8";
+  const currentVersion = "0.3.0";
   try {
     const res = await fetch("https://registry.npmjs.org/@hasna/connectors/latest");
     if (!res.ok)
@@ -7962,7 +7962,7 @@ Available presets:
 program2.command("whoami").option("--json", "Output as JSON", false).description("Show current setup: config dir, installed connectors, auth status").action((options) => {
   const configDir = join5(homedir3(), ".connectors");
   const installed = getInstalledConnectors();
-  const version = "0.2.8";
+  const version = "0.3.0";
   let configured = 0;
   let unconfigured = 0;
   const connectorDetails = [];

package/bin/mcp.js

@@ -20275,14 +20275,12 @@ function guessKeyField(name) {
 loadConnectorVersions();
 var server = new McpServer({
   name: "connectors",
-  version: "0.2.8"
+  version: "0.3.0"
 });
 server.registerTool("search_connectors", {
   title: "Search Connectors",
-  description: "Search connectors by name, keyword, or description.",
-  inputSchema: {
-    query: exports_external.string().describe("Search query")
-  }
+  description: "Search connectors by name or keyword.",
+  inputSchema: { query: exports_external.string() }
 }, async ({ query }) => {
   const results = searchConnectors(query);
   return {
@@ -20302,11 +20300,12 @@ server.registerTool("search_connectors", {
 });
 server.registerTool("list_connectors", {
   title: "List Connectors",
-  description: "List connectors, optionally filtered by category.",
+  description: "List connectors. category filters; compact=true returns names only.",
   inputSchema: {
-    category: exports_external.string().optional().describe("Filter by category (e.g. 'AI & ML', 'Developer Tools')")
+    category: exports_external.string().optional(),
+    compact: exports_external.boolean().optional()
   }
-}, async ({ category }) => {
+}, async ({ category, compact }) => {
   let connectors = CONNECTORS;
   if (category) {
     const matched = CATEGORIES.find((c) => c.toLowerCase() === category.toLowerCase());
@@ -20323,28 +20322,25 @@ server.registerTool("list_connectors", {
     }
     connectors = getConnectorsByCategory(matched);
   }
+  const data = compact ? connectors.map((c) => c.name) : connectors.map((c) => ({
+    name: c.name,
+    displayName: c.displayName,
+    version: c.version,
+    category: c.category,
+    description: c.description
+  }));
   return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify(connectors.map((c) => ({
-          name: c.name,
-          displayName: c.displayName,
-          version: c.version,
-          category: c.category,
-          description: c.description
-        })), null, 2)
-      }
-    ]
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
   };
 });
 server.registerTool("connector_docs", {
   title: "Connector Documentation",
-  description: "Get auth, env vars, CLI commands, and API docs for a connector.",
+  description: "Get connector docs. essential=true returns auth+envVars only.",
   inputSchema: {
-    name: exports_external.string().describe("Connector name")
+    name: exports_external.string(),
+    essential: exports_external.boolean().optional()
   }
-}, async ({ name }) => {
+}, async ({ name, essential }) => {
   const meta = getConnector(name);
   if (!meta) {
     return {
@@ -20359,32 +20355,28 @@ server.registerTool("connector_docs", {
       isError: true
     };
   }
+  const data = essential ? { name: meta.name, auth: docs.auth, envVars: docs.envVars } : {
+    name: meta.name,
+    displayName: meta.displayName,
+    version: meta.version,
+    category: meta.category,
+    description: meta.description,
+    overview: docs.overview,
+    auth: docs.auth,
+    envVars: docs.envVars,
+    cliCommands: docs.cliCommands,
+    dataStorage: docs.dataStorage
+  };
   return {
-    content: [
-      {
-        type: "text",
-        text: JSON.stringify({
-          name: meta.name,
-          displayName: meta.displayName,
-          version: meta.version,
-          category: meta.category,
-          description: meta.description,
-          overview: docs.overview,
-          auth: docs.auth,
-          envVars: docs.envVars,
-          cliCommands: docs.cliCommands,
-          dataStorage: docs.dataStorage
-        }, null, 2)
-      }
-    ]
+    content: [{ type: "text", text: JSON.stringify(data, null, 2) }]
   };
 });
 server.registerTool("install_connector", {
   title: "Install Connector",
-  description: "Install connectors into .connectors/ with auto-generated index.ts.",
+  description: "Install connectors into .connectors/.",
   inputSchema: {
-    names: exports_external.array(exports_external.string()).describe("Connector names to install"),
-    overwrite: exports_external.boolean().optional().describe("Overwrite if already installed")
+    names: exports_external.array(exports_external.string()),
+    overwrite: exports_external.boolean().optional()
   }
 }, async ({ names, overwrite }) => {
   const results = names.map((name) => installConnector(name, { overwrite: overwrite ?? false }));
@@ -20405,10 +20397,8 @@ server.registerTool("install_connector", {
 });
 server.registerTool("remove_connector", {
   title: "Remove Connector",
-  description: "Remove an installed connector from the project.",
-  inputSchema: {
-    name: exports_external.string().describe("Connector name to remove")
-  }
+  description: "Remove an installed connector.",
+  inputSchema: { name: exports_external.string() }
 }, async ({ name }) => {
   const removed = removeConnector(name);
   return {
@@ -20437,10 +20427,8 @@ server.registerTool("list_installed", {
 });
 server.registerTool("connector_info", {
   title: "Connector Info",
-  description: "Get connector metadata: version, category, tags, installed status.",
-  inputSchema: {
-    name: exports_external.string().describe("Connector name")
-  }
+  description: "Get connector metadata and installed status.",
+  inputSchema: { name: exports_external.string() }
 }, async ({ name }) => {
   const meta = getConnector(name);
   if (!meta) {
@@ -20462,10 +20450,8 @@ server.registerTool("connector_info", {
 });
 server.registerTool("connector_auth_status", {
   title: "Connector Auth Status",
-  description: "Check auth status: type (oauth/apikey/bearer), configured, token expiry, env vars.",
-  inputSchema: {
-    name: exports_external.string().describe("Connector name")
-  }
+  description: "Check auth status, token expiry, and env vars.",
+  inputSchema: { name: exports_external.string() }
 }, async ({ name }) => {
   const meta = getConnector(name);
   if (!meta) {
@@ -20490,11 +20476,11 @@ server.registerTool("connector_auth_status", {
 });
 server.registerTool("configure_auth", {
   title: "Configure Auth",
-  description: "Save an API key or bearer token for a connector.",
+  description: "Save an API key or token for a connector.",
   inputSchema: {
-    name: exports_external.string().describe("Connector name"),
-    key: exports_external.string().describe("API key or bearer token"),
-    field: exports_external.string().optional().describe("Field name (default: 'apiKey')")
+    name: exports_external.string(),
+    key: exports_external.string(),
+    field: exports_external.string().optional()
   }
 }, async ({ name, key, field }) => {
   try {
@@ -20537,6 +20523,49 @@ server.registerTool("list_categories", {
     ]
   };
 });
+server.registerTool("search_tools", {
+  title: "Search Tools",
+  description: "List tool names, optionally filtered by keyword.",
+  inputSchema: { query: exports_external.string().optional() }
+}, async ({ query }) => {
+  const all = [
+    "search_connectors",
+    "list_connectors",
+    "connector_docs",
+    "install_connector",
+    "remove_connector",
+    "list_installed",
+    "connector_info",
+    "connector_auth_status",
+    "configure_auth",
+    "list_categories",
+    "search_tools",
+    "describe_tools"
+  ];
+  const matches = query ? all.filter((n) => n.includes(query.toLowerCase())) : all;
+  return { content: [{ type: "text", text: matches.join(", ") }] };
+});
+server.registerTool("describe_tools", {
+  title: "Describe Tools",
+  description: "Get full descriptions for specific tools.",
+  inputSchema: { names: exports_external.array(exports_external.string()) }
+}, async ({ names }) => {
+  const descriptions = {
+    search_connectors: "Search connectors by name/keyword. Params: query",
+    list_connectors: "List connectors by category. Params: category, compact",
+    connector_docs: "Get auth, env vars, CLI docs. Params: name, essential?",
+    install_connector: "Install connector. Params: names, overwrite?",
+    remove_connector: "Remove installed connector. Params: name",
+    list_installed: "List installed connectors.",
+    connector_info: "Get metadata and install status. Params: name",
+    connector_auth_status: "Check auth status and env vars. Params: name",
+    configure_auth: "Save API key or token. Params: name, key, field?",
+    list_categories: "List connector categories with counts."
+  };
+  const result = names.map((n) => `${n}: ${descriptions[n] || "See tool schema"}`).join(`
+`);
+  return { content: [{ type: "text", text: result }] };
+});
 async function main() {
   const transport = new StdioServerTransport;
   await server.connect(transport);

package/package.json

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