@ycodium-ai/plugin-connector-registry 0.2.0

package/README.md

@@ -0,0 +1,38 @@
+# @ycodium-ai/plugin-connector-registry
+
+Searches the MCP connector directory shown under Settings → Plugins → Directory.
+
+## What it does
+
+The plugin exposes a `search` command. It merges a catalog shipped with the
+package with a remote catalog, then filters locally. The remote URL comes from
+the entry config (`url`), which the host fills from `YCODIUM_MCP_REGISTRY_URL`
+and which the settings card can override.
+
+If no URL is configured and the shipped catalog is empty, `search` returns
+`{ status: "not-configured" }`. A fetch failure falls back to cache, then to
+the shipped copy, and only fails when there is nothing to show.
+
+## Install
+
+```
+ycodium plugin add @ycodium-ai/plugin-connector-registry
+```
+
+This plugin declares no extra permissions. Outbound fetches use the host HTTP
+client, including the machine proxy.
+
+Ycodium ships it enabled as `core.connector-registry`. Disabling it hides the
+directory search. Uninstalling it writes a removal to the home patch so a
+restart does not bring it back. Reinstalling the unversioned bundled package
+restores the same entry without an npm fetch.
+
+## Developing
+
+Built from the Ycodium repository. The Node entry is bundled, but
+`@ycodium-ai/plugin-api` stays external and is provided by the Ycodium host at
+load time.
+
+## License
+
+UNLICENSED.

package/dist/index.js

@@ -0,0 +1,209 @@
+// src/index.ts
+import { definePlugin } from "@ycodium-ai/plugin-api";
+
+// src/catalog.ts
+var BUNDLED_CATALOG = [];
+var mergeCatalog = (bundled, fetched) => {
+  const byId = /* @__PURE__ */ new Map();
+  for (const entry of bundled) byId.set(entry.catalogId, entry);
+  for (const entry of fetched) byId.set(entry.catalogId, entry);
+  return [...byId.values()].sort((left, right) => left.name.localeCompare(right.name));
+};
+var filterCatalog = (entries, query) => {
+  const needle = query.trim().toLowerCase();
+  if (needle.length === 0) return entries;
+  return entries.filter(
+    (entry) => entry.name.toLowerCase().includes(needle) || entry.description.toLowerCase().includes(needle)
+  );
+};
+
+// src/index.ts
+var REQUEST_TIMEOUT_MS = 1e4;
+var CACHE_TTL_MS = 10 * 60 * 1e3;
+var SEARCH_PAYLOAD_SCHEMA = {
+  type: "object",
+  properties: { query: { type: "string" } },
+  required: ["query"],
+  additionalProperties: false
+};
+var STRING_MAP_SCHEMA = { type: "object", additionalProperties: { type: "string" } };
+var TRANSPORT_SCHEMA = {
+  type: "object",
+  required: ["type"],
+  additionalProperties: false,
+  properties: {
+    type: { enum: ["stdio", "http", "sse"] },
+    command: { type: "string" },
+    args: { type: "array", items: { type: "string" } },
+    env: STRING_MAP_SCHEMA,
+    url: { type: "string" },
+    headers: STRING_MAP_SCHEMA
+  }
+};
+var SEARCH_RESULT_SCHEMA = {
+  type: "object",
+  required: ["status"],
+  additionalProperties: false,
+  oneOf: [
+    {
+      properties: { status: { const: "not-configured" } },
+      required: ["status"],
+      additionalProperties: false
+    },
+    {
+      properties: { status: { const: "ok" }, items: {}, stale: {} },
+      required: ["status", "items", "stale"],
+      additionalProperties: false
+    }
+  ],
+  properties: {
+    status: { enum: ["not-configured", "ok"] },
+    stale: { type: "boolean" },
+    items: {
+      type: "array",
+      items: {
+        type: "object",
+        required: ["catalogId", "name", "description", "transport", "oauth"],
+        additionalProperties: false,
+        properties: {
+          catalogId: { type: "string" },
+          name: { type: "string" },
+          description: { type: "string" },
+          transport: TRANSPORT_SCHEMA,
+          oauth: { type: "boolean" }
+        }
+      }
+    }
+  }
+};
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var isStringRecord = (value) => isRecord(value) && Object.values(value).every((entry) => typeof entry === "string");
+var isStringArray = (value) => Array.isArray(value) && value.every((entry) => typeof entry === "string");
+var parseTransport = (value) => {
+  if (!isRecord(value)) return null;
+  const type = value["type"];
+  if (type === "stdio") {
+    const command = value["command"];
+    if (typeof command !== "string" || command.length === 0) return null;
+    const args = value["args"];
+    const env = value["env"];
+    if (args !== void 0 && !isStringArray(args)) return null;
+    if (env !== void 0 && !isStringRecord(env)) return null;
+    return {
+      type: "stdio",
+      command,
+      ...args === void 0 ? {} : { args },
+      ...env === void 0 ? {} : { env }
+    };
+  }
+  if (type === "http" || type === "sse") {
+    const url = value["url"];
+    if (typeof url !== "string" || url.length === 0) return null;
+    const headers = value["headers"];
+    if (headers !== void 0 && !isStringRecord(headers)) return null;
+    return { type, url, ...headers === void 0 ? {} : { headers } };
+  }
+  return null;
+};
+var parseItem = (value) => {
+  if (!isRecord(value)) return null;
+  const catalogId = value["catalogId"];
+  const name = value["name"];
+  const description = value["description"];
+  const oauth = value["oauth"];
+  const transport = parseTransport(value["transport"]);
+  if (typeof catalogId !== "string" || catalogId.trim().length === 0 || typeof name !== "string" || name.trim().length === 0 || typeof description !== "string" || typeof oauth !== "boolean" || transport === null) {
+    return null;
+  }
+  return { catalogId, name, description, transport, oauth };
+};
+var parseRegistryItems = (body) => {
+  if (!isRecord(body)) return null;
+  const items = body["items"];
+  if (!Array.isArray(items)) return null;
+  const parsed = [];
+  for (const raw of items) {
+    const item = parseItem(raw);
+    if (item === null) return null;
+    parsed.push(item);
+  }
+  return parsed;
+};
+var readUrl = (config) => {
+  const value = config["url"];
+  return typeof value === "string" && value.trim().length > 0 ? value.trim() : null;
+};
+var describeError = (error) => error instanceof Error ? error.message : String(error);
+var resolve = (fetched, query) => filterCatalog(mergeCatalog(BUNDLED_CATALOG, fetched), query);
+var CATALOG_CACHE_KEY = "catalog";
+var search = async (ctx, query) => {
+  const url = readUrl(ctx.config);
+  if (url === null) {
+    return BUNDLED_CATALOG.length === 0 ? { status: "not-configured" } : { status: "ok", items: [...filterCatalog(BUNDLED_CATALOG, query)], stale: false };
+  }
+  const cached = await ctx.cache.getJson(CATALOG_CACHE_KEY, CACHE_TTL_MS, true);
+  const cachedItems = cached === null ? null : parseRegistryItems(cached.value);
+  if (cachedItems !== null && cached !== null && !cached.stale) {
+    return { status: "ok", items: [...resolve(cachedItems, query)], stale: false };
+  }
+  try {
+    const response = await ctx.http(url, {
+      headers: { accept: "application/json" },
+      signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS)
+    });
+    if (!response.ok) {
+      throw new Error(`connector registry responded with HTTP ${response.status}`);
+    }
+    const items = parseRegistryItems(await response.json());
+    if (items === null) {
+      throw new Error("connector registry response did not match the expected shape");
+    }
+    await ctx.cache.setJson(CATALOG_CACHE_KEY, { items });
+    return { status: "ok", items: [...resolve(items, query)], stale: false };
+  } catch (error) {
+    const fallback = cachedItems ?? [];
+    ctx.log.warn("connector registry request failed; serving what is already on hand", {
+      detail: describeError(error)
+    });
+    const items = resolve(fallback, query);
+    if (items.length > 0 || BUNDLED_CATALOG.length > 0) {
+      return { status: "ok", items: [...items], stale: true };
+    }
+    throw error instanceof Error ? error : new Error(describeError(error));
+  }
+};
+var connectorRegistryPlugin = definePlugin({
+  id: "connector-registry",
+  apiVersion: 2,
+  activate: (ctx) => {
+    ctx.command({
+      name: "search",
+      description: "Search the MCP connector catalog configured for this environment.",
+      scope: "read",
+      payloadSchema: SEARCH_PAYLOAD_SCHEMA,
+      resultSchema: SEARCH_RESULT_SCHEMA,
+      handle: (payload) => {
+        const query = typeof payload["query"] === "string" ? payload["query"] : "";
+        return search(ctx, query);
+      }
+    });
+    ctx.settingsCard({
+      title: "Connector registry",
+      description: "Directory searched by Settings \u2192 Plugins \u2192 Connectors. Defaults to the YCODIUM_MCP_REGISTRY_URL environment variable.",
+      fields: [
+        {
+          key: "url",
+          kind: "text",
+          label: "Registry URL",
+          description: "Leave empty to fall back to the environment variable, if one is set.",
+          placeholder: "https://example.com/connectors/search"
+        }
+      ]
+    });
+  }
+});
+var index_default = connectorRegistryPlugin;
+export {
+  CATALOG_CACHE_KEY,
+  index_default as default
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@ycodium-ai/plugin-connector-registry",
+  "version": "0.2.0",
+  "description": "Searches the directory behind Settings → Plugins → Directory.",
+  "keywords": [
+    "connector",
+    "mcp",
+    "ycodium",
+    "ycodium-plugin"
+  ],
+  "license": "UNLICENSED",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@effect/vitest": "4.0.0-beta.103",
+    "esbuild": "0.28.1",
+    "vite-plus": "0.2.2",
+    "@ycodium-ai/plugin-api": "0.1.1"
+  },
+  "ycodium": {
+    "plugin": "./dist/index.js",
+    "displayName": "Connector directory",
+    "description": "Searches the directory behind Settings → Plugins → Directory.",
+    "icon": "blocks",
+    "permissions": []
+  },
+  "scripts": {
+    "build": "node build.mjs",
+    "typecheck": "tsgo --noEmit",
+    "test": "vp test run"
+  }
+}