@cyanheads/brapi-mcp-server 0.4.5 → 0.4.6

package/dist/services/brapi-dialect/singularizing-dialect.js

@@ -0,0 +1,63 @@
+/**
+ * @fileoverview Generic factory for dialects that translate BrAPI v2.1 plural
+ * filter keys (`studyDbIds`, `germplasmDbIds`, …) to the v2.0 singular forms
+ * the upstream actually honors. Used by both the SGN/Breedbase family
+ * (`cassavabase-dialect`) and the BrAPI Community Test Server
+ * (`brapi-test-dialect`) — the two share an identical translation engine but
+ * carry different per-endpoint mappings, drop lists, and search-route flags,
+ * so the data lives in each dialect module while the engine lives here.
+ *
+ * @module services/brapi-dialect/singularizing-dialect
+ */
+const EMPTY_DROP_SET = new Set();
+/**
+ * Build a `BrapiDialect` whose `adaptGetFilters` translates plural v2.1 filter
+ * names to the configured singulars, drops blacklisted keys, and downcasts
+ * multi-value arrays to the first element with a loud warning (the v2.0 GET
+ * surface can't express multi-value filters; the agent should re-call per
+ * value or use a curated tool that paginates).
+ */
+export function createSingularizingDialect(config) {
+    const adaptGetFilters = (endpoint, filters) => {
+        const mapping = config.pluralToSingular[endpoint] ?? {};
+        const droppedSet = config.droppedFilters?.[endpoint] ?? EMPTY_DROP_SET;
+        const out = {};
+        const warnings = [];
+        const dropped = [];
+        for (const [key, value] of Object.entries(filters)) {
+            if (value === undefined)
+                continue;
+            if (droppedSet.has(key)) {
+                dropped.push(key);
+                warnings.push(`${config.label} dialect: dropped filter '${key}' — this server does not honor it. Adjust the query or omit the filter.`);
+                continue;
+            }
+            const target = mapping[key];
+            if (!target) {
+                out[key] = value;
+                continue;
+            }
+            if (Array.isArray(value)) {
+                if (value.length === 0)
+                    continue;
+                out[target] = value[0];
+                if (value.length > 1) {
+                    warnings.push(`${config.label} dialect: '${key}' downcast to '${target}'; only the first value (${JSON.stringify(value[0])}) was sent — this server's GET /${endpoint} accepts a single value per filter, not arrays. Run separate calls for the other values, or use a curated tool that paginates over them.`);
+                }
+            }
+            else {
+                out[target] = value;
+            }
+        }
+        return { filters: out, dropped, warnings };
+    };
+    return {
+        id: config.id,
+        adaptGetFilters,
+        ...(config.disabledSearchEndpoints !== undefined && {
+            disabledSearchEndpoints: config.disabledSearchEndpoints,
+        }),
+        ...(config.notes !== undefined && { notes: config.notes }),
+    };
+}
+//# sourceMappingURL=singularizing-dialect.js.map

package/dist/services/brapi-dialect/singularizing-dialect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singularizing-dialect.js","sourceRoot":"","sources":["../../../src/services/brapi-dialect/singularizing-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AA+BH,MAAM,cAAc,GAAwB,IAAI,GAAG,EAAE,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAkC;IAC3E,MAAM,eAAe,GAAG,CACtB,QAAgB,EAChB,OAA0C,EACvB,EAAE;QACrB,MAAM,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACxD,MAAM,UAAU,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;QACvE,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAa,EAAE,CAAC;QAE7B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAS;YAClC,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAClB,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,CAAC,KAAK,6BAA6B,GAAG,yEAAyE,CACzH,CAAC;gBACF,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACjB,SAAS;YACX,CAAC;YACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;oBAAE,SAAS;gBACjC,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACrB,QAAQ,CAAC,IAAI,CACX,GAAG,MAAM,CAAC,KAAK,cAAc,GAAG,kBAAkB,MAAM,4BAA4B,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC,QAAQ,0IAA0I,CAClS,CAAC;gBACJ,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,eAAe;QACf,GAAG,CAAC,MAAM,CAAC,uBAAuB,KAAK,SAAS,IAAI;YAClD,uBAAuB,EAAE,MAAM,CAAC,uBAAuB;SACxD,CAAC;QACF,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;KAC3D,CAAC;AACJ,CAAC"}

package/dist/services/brapi-dialect/spec-dialect.d.ts

@@ -1,10 +1,12 @@
 /**
  * @fileoverview The default `spec` dialect — passes filters through verbatim.
- * Used for any server that implements BrAPI v2.1 query-string filters as
- * specified (the BrAPI Community Test Server, modern PIPPA / GnpIS / Reference
- * Server deployments). Selected when no server-specific dialect matches the
- * detected `serverInfo.serverName`, or when an operator pins
- * `BRAPI_<ALIAS>_DIALECT=spec` to override detection.
+ * Used for servers that implement BrAPI v2.1 query-string filters as
+ * specified (modern PIPPA / GnpIS / Reference Server deployments). Selected
+ * when no server-specific dialect matches the detected `serverInfo.serverName`,
+ * or when an operator pins `BRAPI_<ALIAS>_DIALECT=spec` to override detection.
+ *
+ * Note: the BrAPI Community Test Server is intentionally **not** spec-shaped
+ * for GET filters — see `brapi-test-dialect.ts`.
  *
  * @module services/brapi-dialect/spec-dialect
  */

package/dist/services/brapi-dialect/spec-dialect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-dialect.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-dialect/spec-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC"}
+{"version":3,"file":"spec-dialect.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-dialect/spec-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,WAAW,EAAE,YAKzB,CAAC"}

package/dist/services/brapi-dialect/spec-dialect.js

@@ -1,17 +1,19 @@
 /**
  * @fileoverview The default `spec` dialect — passes filters through verbatim.
- * Used for any server that implements BrAPI v2.1 query-string filters as
- * specified (the BrAPI Community Test Server, modern PIPPA / GnpIS / Reference
- * Server deployments). Selected when no server-specific dialect matches the
- * detected `serverInfo.serverName`, or when an operator pins
- * `BRAPI_<ALIAS>_DIALECT=spec` to override detection.
+ * Used for servers that implement BrAPI v2.1 query-string filters as
+ * specified (modern PIPPA / GnpIS / Reference Server deployments). Selected
+ * when no server-specific dialect matches the detected `serverInfo.serverName`,
+ * or when an operator pins `BRAPI_<ALIAS>_DIALECT=spec` to override detection.
+ *
+ * Note: the BrAPI Community Test Server is intentionally **not** spec-shaped
+ * for GET filters — see `brapi-test-dialect.ts`.
  *
  * @module services/brapi-dialect/spec-dialect
  */
 export const specDialect = {
     id: 'spec',
     adaptGetFilters(_endpoint, filters) {
-        return { filters: { ...filters }, warnings: [] };
+        return { filters: { ...filters }, dropped: [], warnings: [] };
     },
 };
 //# sourceMappingURL=spec-dialect.js.map

package/dist/services/brapi-dialect/spec-dialect.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec-dialect.js","sourceRoot":"","sources":["../../../src/services/brapi-dialect/spec-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,EAAE,EAAE,MAAM;IACV,eAAe,CAAC,SAAS,EAAE,OAAO;QAChC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACnD,CAAC;CACF,CAAC"}
+{"version":3,"file":"spec-dialect.js","sourceRoot":"","sources":["../../../src/services/brapi-dialect/spec-dialect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,MAAM,CAAC,MAAM,WAAW,GAAiB;IACvC,EAAE,EAAE,MAAM;IACV,eAAe,CAAC,SAAS,EAAE,OAAO;QAChC,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAChE,CAAC;CACF,CAAC"}

package/dist/services/brapi-dialect/types.d.ts

@@ -18,9 +18,18 @@
  * Result of adapting a filter map for a specific endpoint. `filters` is the
  * wire-shape map (what gets serialized into the URL); `warnings` are
  * operator-facing notes about lossy conversions (multi-value array downcast,
- * filters dropped because the server doesn't honor them, etc.).
+ * filters dropped because the server doesn't honor them, etc.). `dropped` is
+ * the structured list of input keys that were removed entirely so callers can
+ * detect "agent intended to scope, dialect couldn't honor it" without parsing
+ * warning strings.
  */
 export interface DialectAdaptation {
+    /**
+     * Input filter keys the dialect dropped entirely (server doesn't honor them
+     * in any form). Each dropped key also produces a human-readable entry in
+     * `warnings`. Empty when nothing was dropped.
+     */
+    dropped: readonly string[];
     filters: Record<string, unknown>;
     warnings: string[];
 }

package/dist/services/brapi-dialect/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-dialect/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IACjG;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/brapi-dialect/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC;IACjG;;;;;;;;;OASG;IACH,QAAQ,CAAC,uBAAuB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cyanheads/brapi-mcp-server",
   "mcpName": "io.github.cyanheads/brapi-mcp-server",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "BrAPI v2.1 MCP server — studies, germplasm, observations, genotypes, images, and pedigrees.",
   "author": "Casey Hand @cyanheads (https://github.com/cyanheads/brapi-mcp-server#readme)",
   "type": "module",

package/server.json

@@ -6,14 +6,14 @@
     "url": "https://github.com/cyanheads/brapi-mcp-server",
     "source": "github"
   },
-  "version": "0.4.5",
+  "version": "0.4.6",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/brapi-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.4.5",
+      "version": "0.4.6",
       "packageArguments": [
         { "type": "positional", "value": "run" },
         { "type": "positional", "value": "start:stdio" }
@@ -49,7 +49,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/brapi-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.4.5",
+      "version": "0.4.6",
       "packageArguments": [
         { "type": "positional", "value": "run" },
         { "type": "positional", "value": "start:http" }