@digital-science-dsl/dimensions-analytics-mcp 0.5.3

package/dist/mcp/export-format.js

@@ -0,0 +1,92 @@
+/**
+ * File export formatting for batch search results (JSONL and CSV).
+ * @module mcp/export-format
+ */
+/**
+ * Resolves export format from an explicit choice or output path extension.
+ * @param outputPath - Destination file path
+ * @param explicit - Optional format override
+ * @returns Resolved format (defaults to JSONL)
+ */
+export function resolveExportFormat(outputPath, explicit) {
+    if (explicit)
+        return explicit;
+    return outputPath.toLowerCase().endsWith(".csv") ? "csv" : "jsonl";
+}
+/**
+ * Escapes a single CSV cell value.
+ * @param value - Cell value
+ * @returns CSV-safe string
+ */
+export function escapeCsvCell(value) {
+    if (value === null || value === undefined)
+        return "";
+    const text = typeof value === "string"
+        ? value
+        : typeof value === "number" || typeof value === "boolean"
+            ? String(value)
+            : JSON.stringify(value);
+    if (/[",\n\r]/.test(text)) {
+        return `"${text.replace(/"/g, '""')}"`;
+    }
+    return text;
+}
+/**
+ * Derives stable CSV column order from rows and optional preferred field list.
+ * @param rows - Result rows
+ * @param preferredFields - Field order from the search `fields` argument
+ * @param existing - Columns from a resumed export
+ * @returns Ordered column names
+ */
+export function deriveCsvColumns(rows, preferredFields, existing) {
+    if (existing?.length)
+        return [...existing];
+    const keySet = new Set();
+    for (const row of rows) {
+        for (const key of Object.keys(row)) {
+            keySet.add(key);
+        }
+    }
+    const columns = [];
+    if (preferredFields?.length) {
+        for (const field of preferredFields) {
+            if (keySet.has(field)) {
+                columns.push(field);
+                keySet.delete(field);
+            }
+        }
+    }
+    columns.push(...[...keySet].sort());
+    return columns;
+}
+/**
+ * Formats result rows for file export.
+ * @param rows - Records to write
+ * @param format - Target format
+ * @param options - CSV column and header options
+ * @returns Serialized text and resolved CSV columns
+ */
+export function formatRowsForExport(rows, format, options = {}) {
+    if (rows.length === 0) {
+        return { text: "", columns: options.columns ? [...options.columns] : [] };
+    }
+    if (format === "jsonl") {
+        return {
+            text: `${rows.map((row) => JSON.stringify(row)).join("\n")}\n`,
+            columns: [],
+        };
+    }
+    const columns = deriveCsvColumns(rows, options.preferredFields, options.columns);
+    const lines = [];
+    if (options.includeHeader) {
+        lines.push(columns.map(escapeCsvCell).join(","));
+    }
+    for (const row of rows) {
+        lines.push(columns.map((column) => escapeCsvCell(row[column])).join(","));
+    }
+    return {
+        text: `${lines.join("\n")}\n`,
+        columns,
+    };
+}
+//# sourceMappingURL=export-format.js.map

package/dist/mcp/export-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-format.js","sourceRoot":"","sources":["../../src/mcp/export-format.ts"],"names":[],"mappings":"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"}

package/dist/mcp/funder-org-names.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolves common funder acronyms and aliases to Dimensions funder_org_name values.
+ * @module funder-org-names
+ */
+/**
+ * Resolves a funder organization name or acronym to the canonical Dimensions value.
+ * Unknown names pass through unchanged.
+ * @param input - Funder name or acronym from tool arguments
+ * @returns Canonical Dimensions funder_org_name
+ */
+export declare function resolveFunderOrgName(input: string): string;
+//# sourceMappingURL=funder-org-names.d.ts.map

package/dist/mcp/funder-org-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"funder-org-names.d.ts","sourceRoot":"","sources":["../../src/mcp/funder-org-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgBH;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAI1D"}

package/dist/mcp/funder-org-names.js

@@ -0,0 +1,30 @@
+/**
+ * Resolves common funder acronyms and aliases to Dimensions funder_org_name values.
+ * @module funder-org-names
+ */
+/** Case-insensitive acronym / alias → exact Dimensions funder_org_name */
+const FUNDER_ORG_ALIASES = {
+    nih: "National Institutes of Health",
+    nci: "National Cancer Institute",
+    nsf: "National Science Foundation",
+    neh: "National Endowment for the Humanities",
+    cdc: "Centers for Disease Control and Prevention",
+    dod: "Department of Defense",
+    usaid: "United States Agency for International Development",
+    "national institutes of health": "National Institutes of Health",
+    "national cancer institute": "National Cancer Institute",
+    "national science foundation": "National Science Foundation",
+};
+/**
+ * Resolves a funder organization name or acronym to the canonical Dimensions value.
+ * Unknown names pass through unchanged.
+ * @param input - Funder name or acronym from tool arguments
+ * @returns Canonical Dimensions funder_org_name
+ */
+export function resolveFunderOrgName(input) {
+    const trimmed = input.trim();
+    if (!trimmed)
+        return trimmed;
+    return FUNDER_ORG_ALIASES[trimmed.toLowerCase()] ?? trimmed;
+}
+//# sourceMappingURL=funder-org-names.js.map

package/dist/mcp/funder-org-names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"funder-org-names.js","sourceRoot":"","sources":["../../src/mcp/funder-org-names.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,MAAM,kBAAkB,GAAqC;IAC3D,GAAG,EAAE,+BAA+B;IACpC,GAAG,EAAE,2BAA2B;IAChC,GAAG,EAAE,6BAA6B;IAClC,GAAG,EAAE,uCAAuC;IAC5C,GAAG,EAAE,4CAA4C;IACjD,GAAG,EAAE,uBAAuB;IAC5B,KAAK,EAAE,oDAAoD;IAC3D,+BAA+B,EAAE,+BAA+B;IAChE,2BAA2B,EAAE,2BAA2B;IACxD,6BAA6B,EAAE,6BAA6B;CAC7D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO;QAAE,OAAO,OAAO,CAAC;IAC7B,OAAO,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,OAAO,CAAC;AAC9D,CAAC"}

package/dist/mcp/http-server.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Express HTTP server for hosted MCP (Streamable HTTP transport).
+ * @module mcp/http-server
+ */
+import type { HostedEnvConfig } from "../client/deployment-config.js";
+export interface HostedHttpServerOptions {
+    readonly hosted: HostedEnvConfig;
+    readonly port: number;
+    readonly bindHost?: string;
+}
+export interface HostedHttpServerHandle {
+    /** Resolves to the bound TCP port once the server is listening. */
+    readonly ready: Promise<number>;
+    readonly close: () => Promise<void>;
+}
+/**
+ * Starts the hosted MCP HTTP server with Streamable HTTP at POST /mcp.
+ */
+export declare function startHostedHttpServer(options: HostedHttpServerOptions): HostedHttpServerHandle;
+//# sourceMappingURL=http-server.d.ts.map

package/dist/mcp/http-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.d.ts","sourceRoot":"","sources":["../../src/mcp/http-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAKtE,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,sBAAsB;IACrC,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAaD;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,uBAAuB,GAAG,sBAAsB,CA2G9F"}

package/dist/mcp/http-server.js

@@ -0,0 +1,118 @@
+/**
+ * Express HTTP server for hosted MCP (Streamable HTTP transport).
+ * @module mcp/http-server
+ */
+import { createMcpExpressApp } from "@modelcontextprotocol/sdk/server/express.js";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { AuthenticationError } from "../client/errors.js";
+import { parseBearerToken, resolveUserFromApiKey } from "../client/resolve-api-key-user.js";
+import { createMcpServerAsync, warmHostedSchemaCache } from "./server.js";
+function clientIpFromRequest(req) {
+    const forwarded = req.headers["x-forwarded-for"];
+    if (typeof forwarded === "string" && forwarded.length > 0) {
+        return forwarded.split(",")[0]?.trim();
+    }
+    if (Array.isArray(forwarded) && forwarded[0]) {
+        return forwarded[0].split(",")[0]?.trim();
+    }
+    return req.socket.remoteAddress ?? undefined;
+}
+/**
+ * Starts the hosted MCP HTTP server with Streamable HTTP at POST /mcp.
+ */
+export function startHostedHttpServer(options) {
+    const bindHost = options.bindHost ?? "0.0.0.0";
+    const app = createMcpExpressApp({ host: bindHost });
+    app.get("/health", (_req, res) => {
+        res.status(200).json({ status: "ok" });
+    });
+    app.post("/mcp", async (req, res) => {
+        try {
+            const apiKey = parseBearerToken(req.headers.authorization);
+            const clientIp = clientIpFromRequest(req);
+            const userEmail = await resolveUserFromApiKey({
+                apiKey,
+                authUrl: options.hosted.radarAuthUrl,
+                clientIp,
+            });
+            const { server } = await createMcpServerAsync({
+                deploymentMode: "hosted",
+                hosted: options.hosted,
+                userEmail,
+                clientIp,
+            });
+            const transport = new StreamableHTTPServerTransport({
+                sessionIdGenerator: undefined,
+            });
+            await server.connect(transport);
+            await transport.handleRequest(req, res, req.body);
+            res.on("close", () => {
+                void transport.close();
+                void server.close();
+            });
+        }
+        catch (error) {
+            if (error instanceof AuthenticationError) {
+                if (!res.headersSent) {
+                    res.status(401).json({
+                        jsonrpc: "2.0",
+                        error: { code: -32001, message: "Unauthorized" },
+                        id: null,
+                    });
+                }
+                return;
+            }
+            console.error("MCP HTTP error:", error instanceof Error ? error.message : error);
+            if (!res.headersSent) {
+                res.status(500).json({
+                    jsonrpc: "2.0",
+                    error: { code: -32603, message: "Internal server error" },
+                    id: null,
+                });
+            }
+        }
+    });
+    app.get("/mcp", (_req, res) => {
+        res.status(405).json({
+            jsonrpc: "2.0",
+            error: { code: -32000, message: "Method not allowed." },
+            id: null,
+        });
+    });
+    app.delete("/mcp", (_req, res) => {
+        res.status(405).json({
+            jsonrpc: "2.0",
+            error: { code: -32000, message: "Method not allowed." },
+            id: null,
+        });
+    });
+    let httpServer;
+    const ready = warmHostedSchemaCache(options.hosted).then(() => new Promise((resolve, reject) => {
+        const server = app.listen(options.port, bindHost);
+        httpServer = server;
+        server.once("error", reject);
+        server.once("listening", () => {
+            const address = server.address();
+            const port = address != null && typeof address === "object" ? address.port : options.port;
+            resolve(port);
+        });
+    }));
+    return {
+        ready,
+        close: async () => {
+            await new Promise((resolve, reject) => {
+                if (!httpServer) {
+                    resolve();
+                    return;
+                }
+                httpServer.close((error) => {
+                    if (error)
+                        reject(error);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=http-server.js.map

package/dist/mcp/http-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-server.js","sourceRoot":"","sources":["../../src/mcp/http-server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/middleware/field-aliases.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Field name alias middleware for MCP tools.
+ * Translates LLM-friendly field aliases to raw Dimensions DSL field names
+ * via a higher-order function (decorator) pattern.
+ * @module mcp/middleware/field-aliases
+ */
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { EntityType } from "../../dsl/index.js";
+/**
+ * Runtime alias registry. One flat map per entity type.
+ * Keys: LLM-friendly alias names. Values: raw DSL field names.
+ * Unknown names pass through unchanged at resolution time.
+ */
+export declare const ENTITY_ALIASES: Readonly<Record<EntityType, Readonly<Record<string, string>>>>;
+/**
+ * Resolves a single field alias to its raw DSL name.
+ * Returns the input unchanged if it is not a known alias (pass-through).
+ * @param entity - The entity type
+ * @param name - Alias name or raw DSL field name
+ * @returns The raw DSL field name
+ */
+export declare function resolveFieldName(entity: EntityType, name: string): string;
+/**
+ * Resolves facet-field aliases (e.g. grants `funders` → `funder_orgs` on live describe).
+ * Falls back to {@link resolveFieldName} when no facet-specific alias exists.
+ * @param entity - The entity type
+ * @param name - Facet field name or alias
+ * @returns Raw DSL facet field name
+ */
+export declare function resolveFacetFieldName(entity: EntityType, name: string): string;
+/**
+ * Resolves an array of field names, applying alias resolution to each.
+ * @param entity - The entity type
+ * @param names - Array of alias or DSL field names
+ * @returns Array of raw DSL field names
+ */
+export declare function resolveFieldNames(entity: EntityType, names: readonly string[]): string[];
+/**
+ * Builds a reverse lookup map: DSL field name → alias names.
+ * Useful for documentation and resource generation.
+ * @param entity - The entity type
+ * @returns Map of DSL field name → array of alias names
+ */
+export declare function buildReverseAliasMap(entity: EntityType): Map<string, string[]>;
+/**
+ * Where to find the entity type for alias resolution.
+ * - `static`: hardcoded at registration time (e.g., search_publications → "publications")
+ * - `dynamic`: read from an arg at call time (e.g., get_by_id → args.entityType)
+ */
+export type EntitySource = {
+    readonly kind: "static";
+    readonly entity: EntityType;
+} | {
+    readonly kind: "dynamic";
+    readonly argName: string;
+};
+/**
+ * Describes which args of a tool contain field names that need alias resolution.
+ */
+export interface FieldAliasDescriptor {
+    /** Where to get the entity type. */
+    readonly entitySource: EntitySource;
+    /** Args that are `string[]` of field names (e.g., `["fields"]`, `["indicators"]`). */
+    readonly fieldArrayArgs?: readonly string[];
+    /** Args that are a single field name string (e.g., `["sortBy"]`, `["facetField"]`). */
+    readonly fieldStringArgs?: readonly string[];
+    /** Args that are arrays of filter objects with a `.field` property (e.g., `["filters"]`). */
+    readonly filterArrayArgs?: readonly string[];
+}
+/** Generic tool handler function type compatible with the MCP SDK. */
+type ToolHandler = (args: any, extra: any) => CallToolResult | Promise<CallToolResult>;
+/**
+ * Wraps a tool handler with transparent field alias resolution.
+ * Resolves LLM-friendly aliases to raw DSL field names before the inner handler runs.
+ *
+ * @param descriptor - Declares which args contain field names
+ * @param handler - The inner tool handler
+ * @returns A new handler with the same signature that pre-processes args
+ *
+ * @example
+ * ```typescript
+ * server.registerTool("search_publications", config,
+ *   withFieldAliases(
+ *     {
+ *       entitySource: { kind: "static", entity: "publications" },
+ *       fieldArrayArgs: ["fields"],
+ *       fieldStringArgs: ["sortBy"],
+ *       filterArrayArgs: ["filters"],
+ *     },
+ *     async (args) => { ... },
+ *   ),
+ * );
+ * ```
+ */
+export declare function withFieldAliases<T extends ToolHandler>(descriptor: FieldAliasDescriptor, handler: T): T;
+export {};
+//# sourceMappingURL=field-aliases.d.ts.map

package/dist/mcp/middleware/field-aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-aliases.d.ts","sourceRoot":"","sources":["../../../src/mcp/middleware/field-aliases.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAmFrD;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CASzF,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAI9E;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAIxF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAY9E;AAMD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,oCAAoC;IACpC,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,sFAAsF;IACtF,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,uFAAuF;IACvF,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,6FAA6F;IAC7F,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC9C;AAMD,sEAAsE;AAEtE,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAEvF;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,UAAU,EAAE,oBAAoB,EAChC,OAAO,EAAE,CAAC,GACT,CAAC,CA2CH"}

package/dist/mcp/middleware/field-aliases.js

@@ -0,0 +1,208 @@
+/**
+ * Field name alias middleware for MCP tools.
+ * Translates LLM-friendly field aliases to raw Dimensions DSL field names
+ * via a higher-order function (decorator) pattern.
+ * @module mcp/middleware/field-aliases
+ */
+// ---------------------------------------------------------------------------
+// Per-entity alias maps (targets are raw DSL field / metric names)
+// ---------------------------------------------------------------------------
+/**
+ * Publication field aliases.
+ * Keys: LLM-friendly names. Values: raw DSL field names.
+ */
+const PUBLICATION_ALIASES = {
+    total_citations: "times_cited",
+    citation_ratio: "field_citation_ratio",
+    altmetric_score: "altmetric",
+    fields_of_research: "category_for",
+    sdg_categories: "category_sdg",
+};
+/**
+ * Publication indicator aliases for aggregation queries.
+ */
+const PUBLICATION_INDICATOR_ALIASES = {
+    field_citation_ratio_avg: "fcr_gavg",
+    relative_citation_ratio_avg: "rcr_avg",
+    total_citations_sum: "citations_total",
+    average_citations: "citations_avg",
+    median_citations: "citations_median",
+};
+/**
+ * Grant field aliases.
+ */
+const GRANT_ALIASES = {
+    funding_amount_usd: "funding_usd",
+    funding_amount_eur: "funding_eur",
+    funder_name: "funder_org_name",
+};
+/**
+ * Grant facet-field aliases (entity facets, not filter fields).
+ * Live describe uses `funder_orgs`; older examples used `funders`.
+ */
+const GRANT_FACET_FIELD_ALIASES = {
+    funders: "funder_orgs",
+};
+/** Per-entity facet field alias maps. */
+const FACET_FIELD_ALIASES = {
+    grants: GRANT_FACET_FIELD_ALIASES,
+};
+/**
+ * Grant indicator aliases for aggregation queries.
+ */
+const GRANT_INDICATOR_ALIASES = {
+    total_funding: "funding",
+};
+/** Patent field aliases. */
+const PATENT_ALIASES = {};
+/** Clinical trial field aliases. */
+const CLINICAL_TRIAL_ALIASES = {};
+/** Dataset field aliases. */
+const DATASET_ALIASES = {};
+/** Policy document field aliases. */
+const POLICY_DOCUMENT_ALIASES = {};
+/** Researcher field aliases. */
+const RESEARCHER_ALIASES = {
+    orcid: "orcid_id",
+};
+/** Organization field aliases. */
+const ORGANIZATION_ALIASES = {};
+// ---------------------------------------------------------------------------
+// Merged per-entity runtime maps
+// ---------------------------------------------------------------------------
+/**
+ * Runtime alias registry. One flat map per entity type.
+ * Keys: LLM-friendly alias names. Values: raw DSL field names.
+ * Unknown names pass through unchanged at resolution time.
+ */
+export const ENTITY_ALIASES = {
+    publications: { ...PUBLICATION_ALIASES, ...PUBLICATION_INDICATOR_ALIASES },
+    grants: { ...GRANT_ALIASES, ...GRANT_INDICATOR_ALIASES },
+    patents: { ...PATENT_ALIASES },
+    clinical_trials: { ...CLINICAL_TRIAL_ALIASES },
+    datasets: { ...DATASET_ALIASES },
+    policy_documents: { ...POLICY_DOCUMENT_ALIASES },
+    researchers: { ...RESEARCHER_ALIASES },
+    organizations: { ...ORGANIZATION_ALIASES },
+};
+// ---------------------------------------------------------------------------
+// Resolution functions
+// ---------------------------------------------------------------------------
+/**
+ * Resolves a single field alias to its raw DSL name.
+ * Returns the input unchanged if it is not a known alias (pass-through).
+ * @param entity - The entity type
+ * @param name - Alias name or raw DSL field name
+ * @returns The raw DSL field name
+ */
+export function resolveFieldName(entity, name) {
+    const map = ENTITY_ALIASES[entity];
+    if (!map)
+        return name;
+    return map[name] ?? name;
+}
+/**
+ * Resolves facet-field aliases (e.g. grants `funders` → `funder_orgs` on live describe).
+ * Falls back to {@link resolveFieldName} when no facet-specific alias exists.
+ * @param entity - The entity type
+ * @param name - Facet field name or alias
+ * @returns Raw DSL facet field name
+ */
+export function resolveFacetFieldName(entity, name) {
+    const facetMap = FACET_FIELD_ALIASES[entity];
+    if (facetMap?.[name])
+        return facetMap[name];
+    return resolveFieldName(entity, name);
+}
+/**
+ * Resolves an array of field names, applying alias resolution to each.
+ * @param entity - The entity type
+ * @param names - Array of alias or DSL field names
+ * @returns Array of raw DSL field names
+ */
+export function resolveFieldNames(entity, names) {
+    const map = ENTITY_ALIASES[entity];
+    if (!map)
+        return [...names];
+    return names.map((n) => map[n] ?? n);
+}
+/**
+ * Builds a reverse lookup map: DSL field name → alias names.
+ * Useful for documentation and resource generation.
+ * @param entity - The entity type
+ * @returns Map of DSL field name → array of alias names
+ */
+export function buildReverseAliasMap(entity) {
+    const map = ENTITY_ALIASES[entity];
+    const reverse = new Map();
+    for (const [alias, dslName] of Object.entries(map)) {
+        const existing = reverse.get(dslName);
+        if (existing) {
+            existing.push(alias);
+        }
+        else {
+            reverse.set(dslName, [alias]);
+        }
+    }
+    return reverse;
+}
+/**
+ * Wraps a tool handler with transparent field alias resolution.
+ * Resolves LLM-friendly aliases to raw DSL field names before the inner handler runs.
+ *
+ * @param descriptor - Declares which args contain field names
+ * @param handler - The inner tool handler
+ * @returns A new handler with the same signature that pre-processes args
+ *
+ * @example
+ * ```typescript
+ * server.registerTool("search_publications", config,
+ *   withFieldAliases(
+ *     {
+ *       entitySource: { kind: "static", entity: "publications" },
+ *       fieldArrayArgs: ["fields"],
+ *       fieldStringArgs: ["sortBy"],
+ *       filterArrayArgs: ["filters"],
+ *     },
+ *     async (args) => { ... },
+ *   ),
+ * );
+ * ```
+ */
+export function withFieldAliases(descriptor, handler) {
+    const wrapper = (args, extra) => {
+        const entity = descriptor.entitySource.kind === "static"
+            ? descriptor.entitySource.entity
+            : args[descriptor.entitySource.argName];
+        const resolved = { ...args };
+        // Resolve string[] field arrays (e.g., args.fields, args.indicators)
+        for (const argName of descriptor.fieldArrayArgs ?? []) {
+            const val = resolved[argName];
+            if (Array.isArray(val)) {
+                resolved[argName] = resolveFieldNames(entity, val);
+            }
+        }
+        // Resolve single field name strings (e.g., args.sortBy, args.facetField)
+        for (const argName of descriptor.fieldStringArgs ?? []) {
+            const val = resolved[argName];
+            if (typeof val === "string") {
+                resolved[argName] = resolveFieldName(entity, val);
+            }
+        }
+        // Resolve filter object arrays (e.g., args.filters[].field)
+        for (const argName of descriptor.filterArrayArgs ?? []) {
+            const val = resolved[argName];
+            if (Array.isArray(val)) {
+                resolved[argName] = val.map((filter) => ({
+                    ...filter,
+                    field: typeof filter.field === "string"
+                        ? resolveFieldName(entity, filter.field)
+                        : filter.field,
+                }));
+            }
+        }
+        return handler(resolved, extra);
+    };
+    return wrapper;
+}
+//# sourceMappingURL=field-aliases.js.map

package/dist/mcp/middleware/field-aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-aliases.js","sourceRoot":"","sources":["../../../src/mcp/middleware/field-aliases.ts"],"names":[],"mappings":"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"}

package/dist/mcp/resources/schema.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dynamic MCP resources derived from runtime {@link SchemaStore}.
+ * @module mcp/resources/schema
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SchemaContext } from "../schema/context.js";
+/**
+ * Registers schema MCP resources from a loaded {@link SchemaStore}.
+ * @param server - MCP server instance
+ * @param context - Mutable schema context (handlers read latest store)
+ */
+export declare function registerSchemaResources(server: McpServer, context: SchemaContext): void;
+//# sourceMappingURL=schema.d.ts.map

package/dist/mcp/resources/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/mcp/resources/schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoBzE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI,CA2UvF"}