@mcp-s/connectors 0.0.20260929124921 → 0.0.20261003181632

package/README.md

@@ -16,7 +16,8 @@ never contain secrets.
 
 ```
 src/schema/          # zod 4 schema; all types are inferred from it
-src/connectors/      # one folder per connector: <name>.connector.ts (+ .tools.ts)
+src/connectors/api/  # Willow-authored tools against a vendor API: <name>/<name>.connector.ts (+ .tools.ts)
+src/connectors/mcp/  # proxied MCP servers, tools discovered from the server: <name>/<name>.connector.ts
 src/connectors/index.ts  # the list of published connectors
 scripts/build.ts     # validates every connector and writes dist/public
 test/                # schema validation + 1:1 parity with db-service's built-ins
@@ -34,8 +35,9 @@ The same files ship in the npm package under `dist/public`, readable with
 
 ## Adding or changing a connector
 
-1. Add `src/connectors/<name>/<name>.connector.ts` exporting a `CatalogConnector`
-   (and `.tools.ts` if it has them).
+1. Add `src/connectors/<kind>/<name>/<name>.connector.ts` exporting a
+   `CatalogConnector` (and `.tools.ts` if it has them), where `<kind>` is `api`
+   or `mcp`.
 2. Register it in `src/connectors/index.ts`.
 3. `npm test && npm run build`.
 4. Open a PR. Once merged, it reaches every org on the `unified-connectors` beta
@@ -50,6 +52,10 @@ Rules the build enforces:
   that is in use.
 - **Exactly one of `definition.api` and `definition.mcp`.** That choice is the
   connector's kind; there is no separate field for it.
+- **Folder matches kind.** A connector with `definition.api` lives under `api/`,
+  one with `definition.mcp` under `mcp/`, and every connector on disk is
+  registered in `index.ts`. Who publishes an MCP server is the `official`
+  label, not a folder. Moving a connector never changes its `id`.
 
 ## Release flow
 

package/dist/public/index.json

@@ -1,6 +1,6 @@
 {
   "schema_version": 1,
-  "generated_at": "2026-09-29T12:49:21.925Z",
+  "generated_at": "2026-10-03T18:16:32.048Z",
   "connectors": [
     {
       "id": "github",

package/dist/schema/catalog.d.ts

@@ -331,7 +331,7 @@ export declare const catalogConnector: z.ZodObject<{
         active: "active";
         "super-admin": "super-admin";
     }>;
-    applications: z.ZodArray<z.ZodString>;
+    applications: z.ZodOptional<z.ZodArray<z.ZodString>>;
     definition: z.ZodObject<{
         display: z.ZodObject<{
             name: z.ZodString;
@@ -658,7 +658,7 @@ export declare const catalogIndexEntry: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     icon: z.ZodOptional<z.ZodString>;
     category: z.ZodEnum<typeof import("./enums.js").ConnectorCategory>;
-    applications: z.ZodArray<z.ZodString>;
+    applications: z.ZodOptional<z.ZodArray<z.ZodString>>;
     hash: z.ZodString;
 }, z.core.$loose>;
 export type CatalogIndexEntry = z.infer<typeof catalogIndexEntry>;
@@ -681,7 +681,7 @@ export declare const catalogIndex: z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         icon: z.ZodOptional<z.ZodString>;
         category: z.ZodEnum<typeof import("./enums.js").ConnectorCategory>;
-        applications: z.ZodArray<z.ZodString>;
+        applications: z.ZodOptional<z.ZodArray<z.ZodString>>;
         hash: z.ZodString;
     }, z.core.$loose>>;
 }, z.core.$loose>;

package/dist/schema/catalog.js

@@ -81,8 +81,8 @@ export const catalogConnector = obj({
      */
     id: z.string().regex(/^[a-z0-9][a-z0-9-]*$/),
     status: catalogConnectorStatus,
-    /** Products this connector covers, e.g. ["jira", "confluence"]. */
-    applications: z.array(z.string()),
+    /** Products this connector covers, e.g. ["jira", "confluence"]. Absent when the connector is not grouped with a product. */
+    applications: z.array(z.string()).optional(),
     definition: catalogConnectorDefinition,
 });
 export const connectorKind = (connector) => (connector.definition.mcp ? "mcp" : "api");
@@ -95,7 +95,7 @@ export const catalogIndexEntry = obj({
     description: z.string().optional(),
     icon: z.string().optional(),
     category: connectorCategory,
-    applications: z.array(z.string()),
+    applications: z.array(z.string()).optional(),
     /** Content hash of the published definition file. */
     hash: z.string(),
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-s/connectors",
-  "version": "0.0.20260929124921",
+  "version": "0.0.20261003181632",
   "description": "Willow connector catalog: one schema for every connector, plus the published catalog JSON",
   "type": "module",
   "main": "./dist/index.js",
@@ -17,6 +17,7 @@
   ],
   "scripts": {
     "build": "rm -rf dist && tsc -p tsconfig.build.json && tsx scripts/build.ts",
+    "dev": "tsx scripts/build.ts && (npx serve dist/public -p 8787 & tsx watch scripts/build.ts & wait)",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "fixtures:parity": "tsx scripts/generate-parity-fixtures.ts"