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

package/src/dsl/schema/cache.ts

@@ -38,7 +38,7 @@ export function isCacheFresh(cachedAt: Date | undefined, ttlMs: number): boolean
 }
 
 /**
- * Reads a schema cache file (envelope or legacy bare describe payload).
+ * Reads a schema cache file (envelope format).
  * @param cachePath - Path to JSON cache file
  * @returns Parsed cache entry or undefined when missing/invalid
  */
@@ -55,7 +55,7 @@ export async function readSchemaCacheFile(
 }
 
 /**
- * Parses cache JSON as an envelope or legacy describe response.
+ * Parses cache JSON envelope format.
  * @param parsed - Parsed JSON value
  * @returns Normalized cache entry
  */
@@ -66,20 +66,15 @@ export function parseCachePayload(parsed: unknown): SchemaCacheEntry | undefined
 
   const record = parsed as Record<string, unknown>;
 
-  if ("schema" in record) {
-    try {
-      const response = extractDescribeSchema(record.schema);
-      const cachedAt = typeof record.cachedAt === "string" ? new Date(record.cachedAt) : undefined;
-      const version = typeof record.version === "string" ? record.version : undefined;
-      return { response, cachedAt, version };
-    } catch {
-      return undefined;
-    }
+  if (!("schema" in record)) {
+    return undefined;
   }
 
   try {
-    const response = extractDescribeSchema(parsed);
-    return { response, cachedAt: undefined, version: undefined };
+    const response = extractDescribeSchema(record.schema);
+    const cachedAt = typeof record.cachedAt === "string" ? new Date(record.cachedAt) : undefined;
+    const version = typeof record.version === "string" ? record.version : undefined;
+    return { response, cachedAt, version };
   } catch {
     return undefined;
   }

package/src/dsl/schema/load.ts

@@ -112,7 +112,7 @@ export async function loadSchema(
         const age =
           cached.cachedAt != null
             ? `${Math.round((Date.now() - cached.cachedAt.getTime()) / 60_000)}m old`
-            : "legacy cache";
+            : "undated cache";
         console.error(
           `[schema] API unavailable; using stale cache (${age}). ` +
             `Call refresh_schema when the API is reachable.`,
@@ -155,6 +155,3 @@ function logSchemaLoaded(store: SchemaStore, via: string): void {
       ` [${flags}]`,
   );
 }
-
-// Re-export extract helpers for backward compatibility
-export { extractDescribeSchema, extractDescribeVersion } from "./extract.js";

package/src/mcp/tools/schema.ts

@@ -11,9 +11,6 @@ import type { SchemaContext } from "../schema/context.js";
 import { loadSchema, type SchemaStore } from "../schema/index.js";
 import { formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS } from "../utils.js";
 
-/** @deprecated Use {@link SchemaContext} from schema/context.js */
-export type { SchemaContext } from "../schema/context.js";
-
 /**
  * Registers schema introspection and validation tools.
  * @param server - MCP server instance

package/src/mcp/utils.ts

@@ -155,18 +155,6 @@ export function withSearchPagination<T extends Record<string, unknown>>(
   };
 }
 
-/**
- * @deprecated Use {@link withSearchPagination} — kept as alias for gradual migration.
- */
-export function withTruncationWarning<T extends Record<string, unknown>>(
-  data: T,
-  totalCount: number,
-  returnedCount: number,
-): T & SearchPaginationFields {
-  const pageSize = returnedCount > 0 ? returnedCount : 100;
-  return withSearchPagination(data, totalCount, returnedCount, 0, pageSize);
-}
-
 /** Logging levels supported by the MCP protocol (syslog severity). */
 export type McpLogLevel =
   | "debug"

package/test/client/deployment-config.test.ts

@@ -4,7 +4,12 @@
  */
 
 import { afterEach, beforeEach, describe, expect, it } from "vitest";
-import { hostedBootstrapUser, loadDeploymentConfig } from "../../src/client/deployment-config.js";
+import {
+  buildHostedDslLoggingInfo,
+  hostedBootstrapUser,
+  loadDeploymentConfig,
+  mcpTrackingUser,
+} from "../../src/client/deployment-config.js";
 
 const HOSTED_ENV = {
   DEPLOYMENT_MODE: "hosted",
@@ -67,3 +72,22 @@ describe("hostedBootstrapUser", () => {
     expect(hostedBootstrapUser("app.dimensions.ai")).toBe("mcp@app.dimensions.ai");
   });
 });
+
+describe("mcpTrackingUser", () => {
+  it("prefixes canonical email with mcp+", () => {
+    expect(mcpTrackingUser("alice@university.edu")).toBe("mcp+alice@university.edu");
+  });
+});
+
+describe("buildHostedDslLoggingInfo", () => {
+  it("includes channel metadata for dsl-service logs", () => {
+    expect(buildHostedDslLoggingInfo("alice@university.edu", "standard")).toEqual({
+      user: "alice@university.edu",
+      dimensions_user: "alice@university.edu",
+      channel: "mcp",
+      mcp_user: "mcp+alice@university.edu",
+      product_variant: "standard",
+      source: "dimensions-analytics-mcp-hosted",
+    });
+  });
+});

package/test/client/http-client.test.ts

@@ -101,7 +101,7 @@ describe("HttpClient", () => {
       expect(mockAuthProvider.getHeaders).toHaveBeenCalledTimes(2);
     });
 
-    it("query() without options still works (backward compat)", async () => {
+    it("query() without options still works", async () => {
       const mockFetch = vi.fn().mockResolvedValueOnce({
         ok: true,
         json: () => Promise.resolve({ _stats: { total_count: 0 } }),
@@ -1104,7 +1104,7 @@ describe("HttpClient", () => {
       expect(recordSpy).toHaveBeenCalledTimes(1);
     });
 
-    it("works without rate limiter (backward compatibility)", async () => {
+    it("works without rate limiter", async () => {
       const clientWithoutLimiter = new HttpClient({
         baseUrl: "https://app.dimensions.ai",
         authProvider: mockAuthProvider,

package/test/client/internal-dsl-client.test.ts

@@ -55,6 +55,9 @@ describe("InternalDslClient", () => {
           variant: "standard",
           additional_logging_info: {
             user: "user@example.com",
+            dimensions_user: "user@example.com",
+            channel: "mcp",
+            mcp_user: "mcp+user@example.com",
             product_variant: "standard",
             source: "dimensions-analytics-mcp-hosted",
           },

package/test/dsl/schema/cache.test.ts

@@ -41,10 +41,8 @@ describe("schema cache helpers", () => {
     expect(entry?.response.sources.publications).toBeDefined();
   });
 
-  it("parseCachePayload reads legacy bare describe format", () => {
-    const entry = parseCachePayload(sampleSchema);
-    expect(entry?.cachedAt).toBeUndefined();
-    expect(entry?.response.sources.publications).toBeDefined();
+  it("parseCachePayload returns undefined for bare describe payloads", () => {
+    expect(parseCachePayload(sampleSchema)).toBeUndefined();
   });
 
   it("resolveCacheTtlMs prefers explicit override", () => {

package/test/helpers/tool-test-harness.ts

@@ -17,7 +17,7 @@ type ToolHandler = (
 ) => Promise<ToolResult>;
 
 /**
- * Creates a mock McpServer that captures `.tool()` and `.registerTool()` registrations into a Map.
+ * Creates a mock McpServer that captures `.registerTool()` registrations into a Map.
  * @returns Object with the mock server and a Map of tool name to handler
  */
 export function createMockServer() {
@@ -27,24 +27,7 @@ export function createMockServer() {
     handlers.set(name, (args, extra) => handler(args, extra));
   });
 
-  const server = {
-    // Legacy — kept for backward compatibility during migration
-    tool: vi.fn(
-      (
-        name: string,
-        _descriptionOrSchema: unknown,
-        schemaOrHandler: unknown,
-        maybeHandler?: unknown,
-      ) => {
-        // server.tool() has two overloads:
-        //   tool(name, description, schema, handler)
-        //   tool(name, schema, handler)
-        const handler = (maybeHandler ?? schemaOrHandler) as ToolHandler;
-        handlers.set(name, handler);
-      },
-    ),
-    registerTool,
-  };
+  const server = { registerTool };
 
   return { server, handlers };
 }

package/test/middleware/field-aliases.test.ts

@@ -22,7 +22,7 @@ describe("resolveFieldName", () => {
     expect(resolveFieldName("publications", "times_cited")).toBe("times_cited");
   });
 
-  it("passes through unknown names unchanged (backward compat)", () => {
+  it("passes through unknown names unchanged", () => {
     expect(resolveFieldName("publications", "some_unknown_field")).toBe("some_unknown_field");
   });
 

package/test/tools/analytics.test.ts

@@ -103,7 +103,7 @@ describe("analytics tools", () => {
       expect(dsl).toContain("return journal");
     });
 
-    it("resolves legacy funders facet alias to funder_orgs on grants", async () => {
+    it("resolves funders facet alias to funder_orgs on grants", async () => {
       client.rawQuery.mockResolvedValue({ funder_orgs: [{ id: "grid.1", count: 1 }] });
 
       await callTool(handlers, "facet_query", {
@@ -205,7 +205,7 @@ describe("analytics tools", () => {
       expect(dsl).toContain("aggregate funding");
     });
 
-    it("resolves legacy funders facet alias on aggregate queries", async () => {
+    it("resolves funders facet alias on aggregate queries", async () => {
       client.rawQuery.mockResolvedValue({ funder_orgs: [] });
 
       await callTool(handlers, "aggregate_query", {

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/http-main.ts","./src/index.ts","./src/main.ts","./src/client/command.ts","./src/client/config.ts","./src/client/deployment-config.ts","./src/client/errors.ts","./src/client/http-client.ts","./src/client/index.ts","./src/client/internal-dsl-client.ts","./src/client/rate-limiter.ts","./src/client/resolve-api-key-user.ts","./src/client/types.ts","./src/client/auth/config-loaders.ts","./src/client/auth/factory.ts","./src/client/auth/index.ts","./src/client/auth/jwt-utils.ts","./src/client/auth/node.ts","./src/client/auth/schemas.ts","./src/client/auth/types.ts","./src/client/auth/decorators/index.ts","./src/client/auth/decorators/with-caching.ts","./src/client/auth/providers/index.ts","./src/client/auth/providers/jwt-auth-provider.ts","./src/client/config/index.ts","./src/client/config/loader.ts","./src/client/config/node.ts","./src/client/config/schemas.ts","./src/client/config/types.ts","./src/client/config/unified-loader.ts","./src/dsl/client.ts","./src/dsl/create-client.ts","./src/dsl/fluent-query-builder.ts","./src/dsl/index.ts","./src/dsl/pagination.ts","./src/dsl/query-builder.ts","./src/dsl/response-parser.ts","./src/dsl/usage-policy.ts","./src/dsl/commands/apply-filters.ts","./src/dsl/commands/index.ts","./src/dsl/commands/validate-input.ts","./src/dsl/commands/facet/index.ts","./src/dsl/commands/facet/schemas.ts","./src/dsl/commands/functions/classifycommand.ts","./src/dsl/commands/functions/extractaffiliationscommand.ts","./src/dsl/commands/functions/extractconceptscommand.ts","./src/dsl/commands/functions/extractgrantscommand.ts","./src/dsl/commands/functions/index.ts","./src/dsl/schema/cache.ts","./src/dsl/schema/extract.ts","./src/dsl/schema/index.ts","./src/dsl/schema/load.ts","./src/dsl/schema/store.ts","./src/dsl/schema/structured-entities.ts","./src/dsl/schema/summary.ts","./src/dsl/schema/types.ts","./src/dsl/schema/validation.ts","./src/dsl/types/buckets.ts","./src/dsl/types/common.ts","./src/dsl/types/entities.ts","./src/dsl/types/index.ts","./src/dsl/types/return-clauses.ts","./src/dsl/types/special-functions.ts","./src/dsl/types/vocabulary.ts","./src/dsl/utils/escape.ts","./src/dsl/utils/sanitize.ts","./src/dsl/utils/string-utils.ts","./src/dsl/utils/validate-field-name.ts","./src/mcp/batch-fetch.ts","./src/mcp/export-format.ts","./src/mcp/funder-org-names.ts","./src/mcp/http-server.ts","./src/mcp/server.ts","./src/mcp/shared-schema.ts","./src/mcp/utils.ts","./src/mcp/examples/dsl-examples.ts","./src/mcp/examples/usage-scenarios.ts","./src/mcp/middleware/field-aliases.ts","./src/mcp/resources/schema.ts","./src/mcp/schema/context.ts","./src/mcp/schema/index.ts","./src/mcp/tools/analytics-filters.ts","./src/mcp/tools/analytics.ts","./src/mcp/tools/fetch-search-pages.ts","./src/mcp/tools/functions.ts","./src/mcp/tools/lookup.ts","./src/mcp/tools/query.ts","./src/mcp/tools/schema.ts","./src/mcp/tools/search-entity-metadata.ts","./src/mcp/tools/search-input.ts","./src/mcp/tools/search.ts"],"version":"5.9.3"}
+{"root":["./src/http-main.ts","./src/index.ts","./src/main.ts","./src/client/command.ts","./src/client/config.ts","./src/client/deployment-config.ts","./src/client/errors.ts","./src/client/http-client.ts","./src/client/index.ts","./src/client/internal-dsl-client.ts","./src/client/rate-limiter.ts","./src/client/resolve-api-key-user.ts","./src/client/types.ts","./src/client/auth/config-loaders.ts","./src/client/auth/factory.ts","./src/client/auth/index.ts","./src/client/auth/jwt-utils.ts","./src/client/auth/node.ts","./src/client/auth/schemas.ts","./src/client/auth/types.ts","./src/client/auth/decorators/index.ts","./src/client/auth/decorators/with-caching.ts","./src/client/auth/providers/index.ts","./src/client/auth/providers/jwt-auth-provider.ts","./src/client/config/index.ts","./src/client/config/loader.ts","./src/client/config/node.ts","./src/client/config/schemas.ts","./src/client/config/types.ts","./src/client/config/unified-loader.ts","./src/dsl/client.ts","./src/dsl/create-client.ts","./src/dsl/fluent-query-builder.ts","./src/dsl/index.ts","./src/dsl/pagination.ts","./src/dsl/query-builder.ts","./src/dsl/response-parser.ts","./src/dsl/usage-policy.ts","./src/dsl/commands/apply-filters.ts","./src/dsl/commands/index.ts","./src/dsl/commands/validate-input.ts","./src/dsl/commands/facet/index.ts","./src/dsl/commands/facet/schemas.ts","./src/dsl/commands/functions/ClassifyCommand.ts","./src/dsl/commands/functions/ExtractAffiliationsCommand.ts","./src/dsl/commands/functions/ExtractConceptsCommand.ts","./src/dsl/commands/functions/ExtractGrantsCommand.ts","./src/dsl/commands/functions/index.ts","./src/dsl/schema/cache.ts","./src/dsl/schema/extract.ts","./src/dsl/schema/index.ts","./src/dsl/schema/load.ts","./src/dsl/schema/store.ts","./src/dsl/schema/structured-entities.ts","./src/dsl/schema/summary.ts","./src/dsl/schema/types.ts","./src/dsl/schema/validation.ts","./src/dsl/types/buckets.ts","./src/dsl/types/common.ts","./src/dsl/types/entities.ts","./src/dsl/types/index.ts","./src/dsl/types/return-clauses.ts","./src/dsl/types/special-functions.ts","./src/dsl/types/vocabulary.ts","./src/dsl/utils/escape.ts","./src/dsl/utils/sanitize.ts","./src/dsl/utils/string-utils.ts","./src/dsl/utils/validate-field-name.ts","./src/mcp/batch-fetch.ts","./src/mcp/export-format.ts","./src/mcp/funder-org-names.ts","./src/mcp/http-server.ts","./src/mcp/server.ts","./src/mcp/shared-schema.ts","./src/mcp/utils.ts","./src/mcp/examples/dsl-examples.ts","./src/mcp/examples/usage-scenarios.ts","./src/mcp/middleware/field-aliases.ts","./src/mcp/resources/schema.ts","./src/mcp/schema/context.ts","./src/mcp/schema/index.ts","./src/mcp/tools/analytics-filters.ts","./src/mcp/tools/analytics.ts","./src/mcp/tools/fetch-search-pages.ts","./src/mcp/tools/functions.ts","./src/mcp/tools/lookup.ts","./src/mcp/tools/query.ts","./src/mcp/tools/schema.ts","./src/mcp/tools/search-entity-metadata.ts","./src/mcp/tools/search-input.ts","./src/mcp/tools/search.ts"],"version":"5.9.3"}

package/dist/examples/dsl-examples.d.ts

@@ -1,11 +0,0 @@
-/**
- * Curated DSL examples for MCP resources (from public Dimensions DSL documentation patterns).
- * @module examples/dsl-examples
- */
-/** Example queries keyed by entity type. */
-export declare const DSL_EXAMPLES_BY_ENTITY: Record<string, readonly string[]>;
-/** General DSL patterns (describe, functions, pagination). */
-export declare const DSL_GENERAL_EXAMPLES: readonly ["describe version", "describe schema", "describe source publications", "extract_concepts(text: \"CRISPR gene editing enables precise DNA modification\")", "classify(text: \"Stem cell therapy for diabetes\", system: \"for\")"];
-/** Link to official DSL documentation. */
-export declare const DSL_DOCUMENTATION_URL = "https://docs.dimensions.ai/dsl/";
-//# sourceMappingURL=dsl-examples.d.ts.map

package/dist/examples/dsl-examples.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"dsl-examples.d.ts","sourceRoot":"","sources":["../../src/examples/dsl-examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAgCpE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,6OAMvB,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,oCAAoC,CAAC"}

package/dist/examples/dsl-examples.js

@@ -1,49 +0,0 @@
-/**
- * Curated DSL examples for MCP resources (from public Dimensions DSL documentation patterns).
- * @module examples/dsl-examples
- */
-/** Example queries keyed by entity type. */
-export const DSL_EXAMPLES_BY_ENTITY = {
-    publications: [
-        'search publications for "machine learning" return publications[id+title+doi] limit 10',
-        'search publications for "CRISPR" where year >= 2020 return publications[id+title+times_cited+year] sort by times_cited desc limit 25',
-        'search publications in title_only for "gene therapy" return publications[basics] limit 10',
-        "search publications return publications facet journal limit 20",
-    ],
-    grants: [
-        'search grants for "cancer immunotherapy" return grants limit 10',
-        'search grants where funder_org_name = "National Institutes of Health" return grants[basics] limit 10',
-        "search grants return grants aggregate funding_usd",
-    ],
-    patents: [
-        'search patents for "lithium battery" return patents limit 10',
-        "search patents where year >= 2018 return patents[id+title] limit 20",
-    ],
-    clinical_trials: [
-        'search clinical_trials for "diabetes" return clinical_trials limit 10',
-        'search clinical_trials where phase = "Phase 3" return clinical_trials limit 10',
-    ],
-    datasets: ['search datasets for "climate model" return datasets limit 10'],
-    policy_documents: [
-        'search policy_documents for "renewable energy" return policy_documents limit 10',
-    ],
-    researchers: [
-        'search researchers where last_name = "Smith" return researchers limit 10',
-        "search researchers where total_publications > 100 return researchers limit 10",
-    ],
-    organizations: [
-        'search organizations for "Stanford" return organizations limit 10',
-        'search organizations where country = "United States" return organizations limit 10',
-    ],
-};
-/** General DSL patterns (describe, functions, pagination). */
-export const DSL_GENERAL_EXAMPLES = [
-    "describe version",
-    "describe schema",
-    "describe source publications",
-    'extract_concepts(text: "CRISPR gene editing enables precise DNA modification")',
-    'classify(text: "Stem cell therapy for diabetes", system: "for")',
-];
-/** Link to official DSL documentation. */
-export const DSL_DOCUMENTATION_URL = "https://docs.dimensions.ai/dsl/";
-//# sourceMappingURL=dsl-examples.js.map

package/dist/examples/dsl-examples.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"dsl-examples.js","sourceRoot":"","sources":["../../src/examples/dsl-examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,YAAY,EAAE;QACZ,uFAAuF;QACvF,sIAAsI;QACtI,2FAA2F;QAC3F,gEAAgE;KACjE;IACD,MAAM,EAAE;QACN,iEAAiE;QACjE,sGAAsG;QACtG,mDAAmD;KACpD;IACD,OAAO,EAAE;QACP,8DAA8D;QAC9D,qEAAqE;KACtE;IACD,eAAe,EAAE;QACf,uEAAuE;QACvE,gFAAgF;KACjF;IACD,QAAQ,EAAE,CAAC,8DAA8D,CAAC;IAC1E,gBAAgB,EAAE;QAChB,iFAAiF;KAClF;IACD,WAAW,EAAE;QACX,0EAA0E;QAC1E,+EAA+E;KAChF;IACD,aAAa,EAAE;QACb,mEAAmE;QACnE,oFAAoF;KACrF;CACF,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,iBAAiB;IACjB,8BAA8B;IAC9B,gFAAgF;IAChF,iEAAiE;CACzD,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iCAAiC,CAAC"}

package/dist/examples/usage-scenarios.d.ts

@@ -1,22 +0,0 @@
-/**
- * Tool routing for natural-language prompts in docs/USAGE.md.
- * @module examples/usage-scenarios
- */
-export interface UsageScenario {
-    /** Stable id for tests */
-    id: string;
-    /** Short goal label (matches USAGE table) */
-    goal: string;
-    /** Example user prompt */
-    prompt: string;
-    /** Structured MCP tool agents should call */
-    tool: string;
-    /** Tool arguments (validated in usage-scenarios.test.ts) */
-    args: Record<string, unknown>;
-    /** Substrings expected in DSL passed to rawQuery (when applicable) */
-    dslContains?: string[];
-    /** Substrings expected in build_query DSL output */
-    buildDslContains?: string[];
-}
-export declare const USAGE_SCENARIOS: readonly UsageScenario[];
-//# sourceMappingURL=usage-scenarios.d.ts.map

package/dist/examples/usage-scenarios.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"usage-scenarios.d.ts","sourceRoot":"","sources":["../../src/examples/usage-scenarios.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAwK1C,CAAC"}

package/dist/examples/usage-scenarios.js

@@ -1,173 +0,0 @@
-/**
- * Tool routing for natural-language prompts in docs/USAGE.md.
- * @module examples/usage-scenarios
- */
-export const USAGE_SCENARIOS = [
-    {
-        id: "top-publications",
-        goal: "Top papers on a topic",
-        prompt: "Find the 20 most-cited publications on CRISPR gene editing since 2020.",
-        tool: "search_publications",
-        args: {
-            query: "CRISPR gene editing",
-            yearFrom: 2020,
-            sortBy: "total_citations",
-            limit: 20,
-            fields: ["id", "title", "doi", "year", "total_citations"],
-        },
-        dslContains: [
-            "search publications",
-            "CRISPR gene editing",
-            "year >= 2020",
-            "sort by times_cited desc",
-            "limit 20",
-        ],
-    },
-    {
-        id: "nih-grants",
-        goal: "Grants from a funder",
-        prompt: "Search NIH grants about cancer immunotherapy started after 2020, limit 25.",
-        tool: "search_grants",
-        args: {
-            query: "cancer immunotherapy",
-            startYearFrom: 2020,
-            funderOrgName: "National Cancer Institute",
-            limit: 25,
-            fields: ["id", "title", "funding_usd", "funder_name", "start_year"],
-        },
-        dslContains: [
-            "search grants",
-            "cancer immunotherapy",
-            "start_year >= 2020",
-            'funder_org_name = "National Cancer Institute"',
-            "limit 25",
-        ],
-    },
-    {
-        id: "researchers-by-topic",
-        goal: "Who works on a topic",
-        prompt: "Who are the top researchers working on quantum computing?",
-        tool: "facet_query",
-        args: {
-            entityType: "publications",
-            facetField: "researchers",
-            query: "quantum computing",
-            limit: 10,
-        },
-        dslContains: ["search publications", "quantum computing", "return researchers"],
-    },
-    {
-        id: "researchers-by-name",
-        goal: "Find researchers by name",
-        prompt: "Search researchers named Jennifer Doudna, sort by publication count.",
-        tool: "search_researchers",
-        args: {
-            query: "Jennifer Doudna",
-            sortBy: "total_publications",
-            limit: 10,
-            fields: ["id", "first_name", "last_name", "total_publications"],
-        },
-        dslContains: ["search researchers", "Jennifer Doudna", "sort by total_publications"],
-    },
-    {
-        id: "doi-lookup",
-        goal: "Known paper",
-        prompt: "Look up DOI 10.1038/nature12373 and show title, citations, and journal.",
-        tool: "get_by_doi",
-        args: {
-            doi: "10.1038/nature12373",
-            fields: ["id", "title", "times_cited", "journal"],
-        },
-        dslContains: ["10.1038/nature12373"],
-    },
-    {
-        id: "author-profile",
-        goal: "Researcher deep-dive",
-        prompt: "Get an author profile for Jennifer Doudna with recent publications.",
-        tool: "author_profile",
-        args: {
-            name: "Jennifer Doudna",
-            includePublications: true,
-            publicationLimit: 10,
-        },
-    },
-    {
-        id: "org-profile",
-        goal: "Institution",
-        prompt: "Profile Stanford University — publications and grants.",
-        tool: "org_profile",
-        args: {
-            organizationId: "grid.168010.e",
-            name: "Stanford University",
-            includePublications: true,
-            includeGrants: true,
-        },
-    },
-    {
-        id: "facet-journals-since-year",
-        goal: "Topic breakdown",
-        prompt: "Which journals publish the most machine learning research since 2020?",
-        tool: "facet_query",
-        args: {
-            entityType: "publications",
-            facetField: "journal",
-            query: "machine learning",
-            yearFrom: 2020,
-            limit: 20,
-        },
-        dslContains: ["machine learning", "year >= 2020", "return journal"],
-    },
-    {
-        id: "funding-leaders",
-        goal: "Funding leaders",
-        prompt: "Which funders have the most grant funding on climate adaptation?",
-        tool: "aggregate_query",
-        args: {
-            entityType: "grants",
-            facetField: "funder_orgs",
-            indicators: ["funding"],
-            query: "climate adaptation",
-            sortBy: "funding",
-            sortOrder: "desc",
-            limit: 10,
-        },
-        dslContains: ["search grants", "climate adaptation", "return funder_orgs aggregate funding"],
-    },
-    {
-        id: "citation-trend",
-        goal: "Citations over time",
-        prompt: "Citation trend for large language model publications from 2018 to 2024.",
-        tool: "citation_trend",
-        args: {
-            query: "large language model",
-            startYear: 2018,
-            endYear: 2024,
-        },
-        dslContains: ["large language model", "citations_per_year(2018, 2024)"],
-    },
-    {
-        id: "build-complex-query",
-        goal: "Build a complex query",
-        prompt: "Build a DSL query for publications: include CRISPR or gene editing, exclude animal models, year ≥ 2020.",
-        tool: "build_query",
-        args: {
-            entity: "publications",
-            concept_groups: [
-                { terms: ["CRISPR", "gene editing"], role: "include" },
-                { terms: ["animal model", "animal models"], role: "exclude" },
-            ],
-            filters: [{ field: "year", op: ">=", value: 2020 }],
-            fields: ["id", "title", "doi", "times_cited"],
-            limit: 20,
-        },
-        buildDslContains: [
-            "search publications",
-            "CRISPR",
-            "gene editing",
-            "animal model",
-            "year >= 2020",
-            "limit 20",
-        ],
-    },
-];
-//# sourceMappingURL=usage-scenarios.js.map

package/dist/examples/usage-scenarios.js.map

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

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

@@ -1,12 +0,0 @@
-/**
- * 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/funder-org-names.d.ts.map

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

package/dist/funder-org-names.js

@@ -1,30 +0,0 @@
-/**
- * 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/funder-org-names.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"funder-org-names.js","sourceRoot":"","sources":["../src/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/http.d.ts

@@ -1,29 +0,0 @@
-/**
- * HTTP entry point for the Dimensions MCP server.
- *
- * Callers authenticate with their Dimensions API key — the same credential
- * used for DSL API requests. Pass it on each `/mcp` POST as:
- *
- * - `Authorization: Bearer <dimensions-api-key>`, or
- * - `X-Dimensions-Api-Key: <dimensions-api-key>`
- *
- * The server exchanges the key for a JWT via Dimensions `auth.json` and
- * forwards queries upstream; keys are not stored server-side.
- * @module mcp/http
- */
-import { Hono } from "hono";
-/**
- * Extracts a Dimensions API key from request headers.
- * @param authorization - Raw Authorization header value
- * @param dimensionsApiKey - Raw X-Dimensions-Api-Key header value
- * @returns API key or null when missing
- */
-export declare function extractDimensionsApiKey(authorization: string | undefined, dimensionsApiKey: string | undefined): string | null;
-/**
- * Derives a stable, non-reversible telemetry distinct id from an API key.
- * @param apiKey - Dimensions API key
- * @returns Hex prefix of SHA-256 hash
- */
-export declare function telemetryDistinctId(apiKey: string): string;
-export declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
-//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAgB5B;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,gBAAgB,EAAE,MAAM,GAAG,SAAS,GACnC,MAAM,GAAG,IAAI,CASf;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D;AAMD,eAAO,MAAM,GAAG,4EAAa,CAAC"}