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

package/dist/server.js

@@ -1,144 +0,0 @@
-/**
- * MCP server for Dimensions Analytics API.
- * Provides tools for searching and querying the Dimensions database.
- * @module mcp/server
- */
-import { DimensionsClient } from "@digital-science/dimensions-dsl";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import pkg from "../package.json" with { type: "json" };
-import { registerSchemaResources } from "./resources/schema.js";
-import { clearSchemaCache, getOrLoadSchema, loadSchema } from "./schema/index.js";
-import { registerAnalyticsTools } from "./tools/analytics.js";
-import { registerConceptProfileTools } from "./tools/concept-profile.js";
-import { registerDatasetProfileTools } from "./tools/dataset-profile.js";
-import { registerFunctionTools } from "./tools/functions.js";
-import { registerImpactChainTools } from "./tools/impact-chain.js";
-import { registerKwqTools } from "./tools/kwq.js";
-import { registerLookupTools } from "./tools/lookup.js";
-import { registerPolicyProfileTools } from "./tools/policy-profile.js";
-import { registerProfileTools } from "./tools/profile.js";
-import { registerQueryTools } from "./tools/query.js";
-import { registerSchemaTools, validateFieldAliases } from "./tools/schema.js";
-import { registerSearchTools } from "./tools/search.js";
-/**
- * Reads a positive integer from an environment variable with a default fallback.
- * @param raw - Environment variable value
- * @param fallback - Default when unset or invalid
- * @returns Parsed integer
- */
-function readIntEnv(raw, fallback, min) {
-    if (raw == null || raw.trim() === "")
-        return fallback;
-    const value = Number.parseInt(raw, 10);
-    return Number.isFinite(value) && value >= min ? value : fallback;
-}
-/**
- * Builds server instructions from loaded schema.
- * @param schemaStore - Loaded describe schema
- * @returns Instruction string for MCP clients
- */
-export function buildServerInstructions(schemaStore) {
-    const version = schemaStore.version ? ` DSL ${schemaStore.version}.` : "";
-    return [
-        `Dimensions Analytics API — scholarly research data.${version}`,
-        [
-            "Workflow:",
-            "(1) Discover schema — read dimensions://schema/summary, dimensions://fields/{entity}, dimensions://examples, or describe_schema;",
-            "(2) Search — search_* for keyword discovery with filters; get_by_doi, get_by_pmid, get_by_id for known identifiers;",
-            "(3) Analyze — facet_query, aggregate_query, citation_trend, funding_trend;",
-            "(4) Drill down — author_profile, org_profile, concept_profile, research_impact_chain, dataset_profile, policy_document_profile.",
-        ].join(" "),
-        [
-            "Routing:",
-            "search_researchers matches names only — topic→researcher uses facet_query (entityType publications, facetField researchers);",
-            "search_grants funderOrgName needs exact Dimensions names (NCI/NSF acronyms resolve; discover funders via facet_query/aggregate_query on facetField funder_orgs);",
-            "org_profile prefers organizationId (GRID id) when the name is ambiguous;",
-            "facet_query supports yearFrom/yearTo for year-scoped facets.",
-        ].join(" "),
-        [
-            "Query construction:",
-            "for ranked publication search (e.g. most-cited since 2020), use search_publications with query, yearFrom, sortBy (times_cited or total_citations), limit — do not hand-write execute_dsl;",
-            "use build_query or ensemble_queries for boolean concept groups;",
-            "use execute_dsl only when structured tools are insufficient; DSL order is return ... sort by FIELD order limit N (never limit before sort).",
-        ].join(" "),
-        "Large result sets: structured search returns at most 1000 rows (default 100); if truncated, narrow filters or paginate with execute_dsl skip/limit.",
-    ].join("\n\n");
-}
-/**
- * Creates and configures the MCP server.
- * Loads describe schema at startup unless `schemaStore` is provided.
- * @param config - Optional configuration
- * @returns Configured MCP server, client, schema context, and store
- */
-export async function createMcpServerAsync(config = {}) {
-    const apiKey = config.apiKey ?? process.env.DIMENSIONS_API_KEY;
-    if (!apiKey) {
-        throw new Error("Dimensions API key required. Set DIMENSIONS_API_KEY environment variable or pass apiKey in config.");
-    }
-    const client = new DimensionsClient({
-        apiKey,
-        baseUrl: config.baseUrl ?? process.env.DIMENSIONS_BASE_URL,
-        maxRetries: readIntEnv(process.env.DIMENSIONS_MAX_RETRIES, 3, 0),
-        retryDelay: readIntEnv(process.env.DIMENSIONS_RETRY_DELAY_MS, 1000, 1),
-        rateLimitPerMinute: readIntEnv(process.env.DIMENSIONS_RATE_LIMIT_PER_MINUTE, 30, 1),
-    });
-    const schemaStore = config.schemaStore ?? (await getOrLoadSchema(client, process.env.SCHEMA_CACHE_PATH));
-    client.attachSchemaStore(schemaStore);
-    const schemaContext = { store: schemaStore };
-    validateFieldAliases(schemaStore);
-    const startedAt = Date.now();
-    console.error(`Schema loaded: ${schemaStore.stats().sourceCount} sources, ${schemaStore.stats().entityCount} entities` +
-        (schemaStore.version ? `, DSL ${schemaStore.version}` : "") +
-        (schemaStore.stale ? " (stale cache)" : "") +
-        ` [${schemaStore.loadSource}]` +
-        ` (${Date.now() - startedAt}ms)`);
-    const server = new McpServer({
-        name: "dimensions",
-        version: pkg.version,
-    }, {
-        capabilities: {
-            logging: {},
-        },
-        instructions: buildServerInstructions(schemaStore),
-    });
-    registerSchemaResources(server, schemaContext);
-    registerSearchTools(server, client, schemaStore);
-    registerLookupTools(server, client);
-    registerProfileTools(server, client);
-    registerQueryTools(server, client, schemaStore);
-    registerFunctionTools(server, client);
-    registerAnalyticsTools(server, client, schemaStore);
-    registerConceptProfileTools(server, client);
-    registerImpactChainTools(server, client);
-    registerDatasetProfileTools(server, client);
-    registerPolicyProfileTools(server, client);
-    registerKwqTools(server, client, schemaStore);
-    registerSchemaTools(server, client, schemaContext);
-    return { server, client, schemaContext, schemaStore };
-}
-/**
- * Starts the MCP server with the given transport (defaults to stdio).
- * @param injectedTransport - Optional transport (useful for testing)
- * @param config - Optional server configuration
- * @returns Shutdown handle
- */
-export async function startMcpServer(injectedTransport, config = {}) {
-    const { server } = await createMcpServerAsync(config);
-    const transport = injectedTransport ?? new StdioServerTransport();
-    server.server.onerror = (error) => console.error(`MCP server error: ${error.message}`);
-    if (!injectedTransport) {
-        server.server.onclose = () => {
-            process.exit(0);
-        };
-    }
-    await server.connect(transport);
-    return {
-        close: async () => {
-            await server.close();
-        },
-    };
-}
-/** Force reload schema from API (clears module cache). */
-export { clearSchemaCache, loadSchema, McpServer };
-//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/telemetry.d.ts

@@ -1,172 +0,0 @@
-/**
- * Mixpanel telemetry for the MCP server.
- *
- * Tracks one event per tool invocation (`mcp_tool_call`) with: tool name,
- * outcome (success / tool_error / exception), latency, transport, the
- * caller's distinct id, plus a truncated capture of the tool arguments
- * and response so analysts can reconstruct user conversations after the
- * fact. Captures are clipped to {@link MAX_CAPTURE_CHARS} characters per
- * field — long enough to read the prompt, short enough to keep events
- * cheap and to avoid mirroring full result payloads into Mixpanel.
- *
- * Telemetry is opt-in: if no {@link TelemetryConfig.client} is provided,
- * {@link createTelemetry} returns a no-op so callers can wire it
- * unconditionally without worrying about missing-credential branches.
- * Callers typically construct that client with
- * {@link initMixpanelClient}, which itself returns `undefined` when no
- * token is supplied.
- *
- * Stdio (local) callers should leave this off unless an operator has
- * explicitly enabled it for their fleet — by default `main.ts` does not
- * initialize and pass a client, even if `MIXPANEL_TOKEN` is set in the
- * user's shell.
- *
- * @module mcp/telemetry
- */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/** Outcome categories tracked for every tool invocation. */
-export type ToolOutcome = "success" | "tool_error" | "exception";
-/** Subset of the mixpanel-node client surface we depend on (for testability). */
-export interface MixpanelClient {
-    track(event: string, properties: Record<string, unknown>, callback?: (err: Error | undefined) => void): void;
-}
-/**
- * Mixpanel EU data residency endpoint. Default host because the Lambda is
- * deployed to `eu-west-1` and our project lives in the EU region — sending
- * to the default US host (`api.mixpanel.com`) would either drop events on
- * the floor or leak EU user identifiers across the Atlantic.
- *
- * Override with `MIXPANEL_HOST` (or the `host` argument to
- * {@link initMixpanelClient}) for projects on the US data center or a
- * regional residency endpoint we don't yet handle by default.
- *
- * @see https://docs.mixpanel.com/docs/privacy/eu-residency
- */
-export declare const MIXPANEL_DEFAULT_HOST = "api-eu.mixpanel.com";
-/**
- * Source label attached to every event. Lets analysts segment AI Analytics
- * traffic from other Mixpanel integrations sharing the same project — and
- * keeps the human-readable name stable even if package names or transport
- * details change later.
- */
-export declare const TELEMETRY_SOURCE = "AI Analytics MCP";
-/**
- * Maximum captured length, in characters, for the per-event `args` and
- * `response` fields. Mixpanel's per-event payload limit is 1MB but practical
- * UI surfaces (Insights, Funnels, raw event view) truncate long strings, so
- * we keep these short enough to read at a glance while still preserving
- * the verbatim user query — long enough to recover the prompt, short
- * enough that an attacker exfiltrating event logs doesn't get the full
- * result body.
- */
-export declare const MAX_CAPTURE_CHARS = 500;
-/**
- * Initializes the shared Mixpanel client. Returns `undefined` when no token
- * is supplied so the rest of the wiring can stay no-op without branching.
- *
- * Call once at module load (HTTP transport) — the underlying mixpanel-node
- * client maintains a keep-alive HTTPS agent that's wasteful to recreate per
- * Lambda invocation.
- *
- * @param token - Mixpanel project token; falsy values disable telemetry.
- * @param host - Mixpanel ingestion host; defaults to {@link MIXPANEL_DEFAULT_HOST}
- *   (EU residency). Pass an empty string or omit to use the default — empty
- *   strings are treated the same as `undefined` so SST secrets that resolve
- *   to `""` don't accidentally point Mixpanel at an empty host.
- */
-export declare function initMixpanelClient(token: string | undefined, host?: string): MixpanelClient | undefined;
-/** Configuration for a per-request telemetry instance. */
-export interface TelemetryConfig {
-    /**
-     * Shared Mixpanel client (from {@link initMixpanelClient}). Omit/undefined
-     * to disable telemetry — every method becomes a no-op.
-     */
-    readonly client?: MixpanelClient;
-    /** Stable identifier for the caller (e.g. JWT `sub`). Falls back to `"anonymous"`. */
-    readonly distinctId?: string;
-    /** Which transport invoked the server. */
-    readonly transport: "http" | "stdio";
-    /** MCP server package version, recorded on each event. */
-    readonly serverVersion: string;
-    /** Deployment stage / environment name (e.g. `"production"`, `"dev"`). Optional. */
-    readonly stage?: string;
-    /**
-     * Per-HTTP-request correlation id. Lets analysts cluster co-batched
-     * tool calls (multiple JSON-RPC calls in one POST) into a single
-     * conversational turn even though the server is otherwise stateless.
-     * Pair with `distinct_id` (cross-turn) and Mixpanel's event timestamp
-     * (chronology) to reconstruct a user's session. Optional — omit on
-     * stdio where there's no transport-level request boundary.
-     */
-    readonly requestId?: string;
-}
-/** Recorded fields for a single tool call. */
-export interface ToolCallEvent {
-    /** Tool name as registered with the MCP server (e.g. `"search_publications"`). */
-    readonly tool: string;
-    /** Whether the call succeeded, returned an error result, or threw. */
-    readonly outcome: ToolOutcome;
-    /** Wall-clock duration of the handler in milliseconds. */
-    readonly durationMs: number;
-    /** Error class name when {@link outcome} is `"exception"`; omitted for `"success"` and `"tool_error"`. */
-    readonly errorType?: string;
-    /**
-     * Verbatim tool arguments (JSON-stringified, clipped to
-     * {@link MAX_CAPTURE_CHARS}). Empty string when the handler took no
-     * arguments or the value couldn't be serialized.
-     */
-    readonly args: string;
-    /**
-     * First {@link MAX_CAPTURE_CHARS} characters of the tool's response.
-     * Prefer the first `text` content block; falls back to a JSON-stringified
-     * snippet of the whole result. Empty string for thrown exceptions
-     * (there's no response to capture in that case).
-     */
-    readonly response: string;
-}
-/** Public telemetry surface — safe to call when telemetry is disabled. */
-export interface Telemetry {
-    /** Record a single tool invocation. Fire-and-forget. */
-    trackToolCall(event: ToolCallEvent): void;
-    /**
-     * Wait for any in-flight events to be sent. Lambda freezes the event loop
-     * the moment the response is returned, so HTTP callers must `await` this
-     * before completing the request — otherwise events are silently dropped on
-     * cold containers.
-     */
-    flush(): Promise<void>;
-}
-/**
- * Creates a per-request telemetry instance. Returns a no-op implementation
- * when no Mixpanel client is provided.
- * @param config - Telemetry configuration.
- * @returns A {@link Telemetry} instance.
- */
-export declare function createTelemetry(config: TelemetryConfig): Telemetry;
-/**
- * Truncates a string to {@link MAX_CAPTURE_CHARS} characters. Exposed so
- * tests can assert length without re-importing the constant.
- *
- * Operates on JS code units, not extended grapheme clusters — clipping a
- * 4-byte emoji at exactly the limit can leave half a surrogate pair, but
- * Mixpanel handles invalid UTF-16 silently and the tradeoff (precise
- * length budget) is worth more here than perfect grapheme boundaries.
- *
- * @param value - Source string.
- * @returns Same string when within budget, otherwise the leading prefix.
- */
-export declare function truncateForCapture(value: string): string;
-/**
- * Wraps {@link McpServer.registerTool} so every subsequent tool registration
- * has its handler instrumented with timing, outcome reporting, and a
- * truncated capture of the tool args + response. Must be called *before*
- * tools are registered.
- *
- * The wrapper re-throws thrown exceptions so the SDK still surfaces them to
- * the client — telemetry is observational, never an error sink.
- *
- * @param server - The MCP server whose registrations should be instrumented.
- * @param telemetry - Telemetry sink (no-op when telemetry is disabled).
- */
-export declare function instrumentToolRegistrations(server: McpServer, telemetry: Telemetry): void;
-//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,4DAA4D;AAC5D,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,YAAY,GAAG,WAAW,CAAC;AAEjE,iFAAiF;AACjF,MAAM,WAAW,cAAc;IAC7B,KAAK,CACH,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,SAAS,KAAK,IAAI,GAC1C,IAAI,CAAC;CACT;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,qBAAqB,wBAAwB,CAAC;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAEnD;;;;;;;;GAQG;AACH,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,CAAC,EAAE,MAAM,GACZ,cAAc,GAAG,SAAS,CAI5B;AAED,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,cAAc,CAAC;IACjC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,0DAA0D;IAC1D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,8CAA8C;AAC9C,MAAM,WAAW,aAAa;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0GAA0G;IAC1G,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,0EAA0E;AAC1E,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAC1C;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAOD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CA4ClE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAgDD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI,CAwCzF"}

package/dist/telemetry.js

@@ -1,233 +0,0 @@
-/**
- * Mixpanel telemetry for the MCP server.
- *
- * Tracks one event per tool invocation (`mcp_tool_call`) with: tool name,
- * outcome (success / tool_error / exception), latency, transport, the
- * caller's distinct id, plus a truncated capture of the tool arguments
- * and response so analysts can reconstruct user conversations after the
- * fact. Captures are clipped to {@link MAX_CAPTURE_CHARS} characters per
- * field — long enough to read the prompt, short enough to keep events
- * cheap and to avoid mirroring full result payloads into Mixpanel.
- *
- * Telemetry is opt-in: if no {@link TelemetryConfig.client} is provided,
- * {@link createTelemetry} returns a no-op so callers can wire it
- * unconditionally without worrying about missing-credential branches.
- * Callers typically construct that client with
- * {@link initMixpanelClient}, which itself returns `undefined` when no
- * token is supplied.
- *
- * Stdio (local) callers should leave this off unless an operator has
- * explicitly enabled it for their fleet — by default `main.ts` does not
- * initialize and pass a client, even if `MIXPANEL_TOKEN` is set in the
- * user's shell.
- *
- * @module mcp/telemetry
- */
-import Mixpanel from "mixpanel";
-/**
- * Mixpanel EU data residency endpoint. Default host because the Lambda is
- * deployed to `eu-west-1` and our project lives in the EU region — sending
- * to the default US host (`api.mixpanel.com`) would either drop events on
- * the floor or leak EU user identifiers across the Atlantic.
- *
- * Override with `MIXPANEL_HOST` (or the `host` argument to
- * {@link initMixpanelClient}) for projects on the US data center or a
- * regional residency endpoint we don't yet handle by default.
- *
- * @see https://docs.mixpanel.com/docs/privacy/eu-residency
- */
-export const MIXPANEL_DEFAULT_HOST = "api-eu.mixpanel.com";
-/**
- * Source label attached to every event. Lets analysts segment AI Analytics
- * traffic from other Mixpanel integrations sharing the same project — and
- * keeps the human-readable name stable even if package names or transport
- * details change later.
- */
-export const TELEMETRY_SOURCE = "AI Analytics MCP";
-/**
- * Maximum captured length, in characters, for the per-event `args` and
- * `response` fields. Mixpanel's per-event payload limit is 1MB but practical
- * UI surfaces (Insights, Funnels, raw event view) truncate long strings, so
- * we keep these short enough to read at a glance while still preserving
- * the verbatim user query — long enough to recover the prompt, short
- * enough that an attacker exfiltrating event logs doesn't get the full
- * result body.
- */
-export const MAX_CAPTURE_CHARS = 500;
-/**
- * Initializes the shared Mixpanel client. Returns `undefined` when no token
- * is supplied so the rest of the wiring can stay no-op without branching.
- *
- * Call once at module load (HTTP transport) — the underlying mixpanel-node
- * client maintains a keep-alive HTTPS agent that's wasteful to recreate per
- * Lambda invocation.
- *
- * @param token - Mixpanel project token; falsy values disable telemetry.
- * @param host - Mixpanel ingestion host; defaults to {@link MIXPANEL_DEFAULT_HOST}
- *   (EU residency). Pass an empty string or omit to use the default — empty
- *   strings are treated the same as `undefined` so SST secrets that resolve
- *   to `""` don't accidentally point Mixpanel at an empty host.
- */
-export function initMixpanelClient(token, host) {
-    if (!token)
-        return undefined;
-    const effectiveHost = host && host.length > 0 ? host : MIXPANEL_DEFAULT_HOST;
-    return Mixpanel.init(token, { host: effectiveHost });
-}
-const NOOP = {
-    trackToolCall: () => { },
-    flush: () => Promise.resolve(),
-};
-/**
- * Creates a per-request telemetry instance. Returns a no-op implementation
- * when no Mixpanel client is provided.
- * @param config - Telemetry configuration.
- * @returns A {@link Telemetry} instance.
- */
-export function createTelemetry(config) {
-    if (!config.client)
-        return NOOP;
-    const client = config.client;
-    const distinctId = config.distinctId ?? "anonymous";
-    // Each track() schedules one HTTPS POST. We collect those promises so
-    // flush() can await them before the Lambda freezes.
-    const pending = new Set();
-    const trackToolCall = (event) => {
-        const promise = new Promise((resolve) => {
-            client.track("mcp_tool_call", {
-                distinct_id: distinctId,
-                source: TELEMETRY_SOURCE,
-                tool: event.tool,
-                outcome: event.outcome,
-                duration_ms: event.durationMs,
-                transport: config.transport,
-                server_version: config.serverVersion,
-                args: event.args,
-                response: event.response,
-                ...(event.errorType ? { error_type: event.errorType } : {}),
-                ...(config.stage ? { stage: config.stage } : {}),
-                ...(config.requestId ? { request_id: config.requestId } : {}),
-            }, 
-            // Mixpanel's API never rejects on network errors — it logs and
-            // returns. We swallow either way: telemetry must not affect the
-            // caller's response.
-            () => resolve());
-        });
-        pending.add(promise);
-        promise.finally(() => pending.delete(promise));
-    };
-    const flush = async () => {
-        if (pending.size === 0)
-            return;
-        await Promise.all(pending);
-    };
-    return { trackToolCall, flush };
-}
-/**
- * Truncates a string to {@link MAX_CAPTURE_CHARS} characters. Exposed so
- * tests can assert length without re-importing the constant.
- *
- * Operates on JS code units, not extended grapheme clusters — clipping a
- * 4-byte emoji at exactly the limit can leave half a surrogate pair, but
- * Mixpanel handles invalid UTF-16 silently and the tradeoff (precise
- * length budget) is worth more here than perfect grapheme boundaries.
- *
- * @param value - Source string.
- * @returns Same string when within budget, otherwise the leading prefix.
- */
-export function truncateForCapture(value) {
-    return value.length <= MAX_CAPTURE_CHARS ? value : value.slice(0, MAX_CAPTURE_CHARS);
-}
-/**
- * Captures the verbatim tool arguments for telemetry. The MCP SDK passes
- * the parsed input object as the first arg to the handler — JSON-stringify
- * it and clip. Returns an empty string when the input is missing or
- * un-serializable (e.g. circular refs); telemetry must never throw and
- * never block the response.
- *
- * @param handlerArgs - The variadic args the SDK passed into the handler.
- * @returns Truncated JSON capture of the input object.
- */
-function captureArgs(handlerArgs) {
-    if (handlerArgs.length === 0)
-        return "";
-    try {
-        return truncateForCapture(JSON.stringify(handlerArgs[0] ?? {}));
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * Captures a synopsis of the tool's response. MCP results have shape
- * `{ content: [{type, text, ...}], isError?: boolean }` — prefer the first
- * `text` content block (that's what the LLM actually reads), falling back
- * to a JSON snippet of the whole result on non-standard shapes.
- *
- * @param result - Whatever the wrapped handler returned (may be `undefined`).
- * @returns First {@link MAX_CAPTURE_CHARS} chars of the response synopsis.
- */
-function captureResponse(result) {
-    if (result == null || typeof result !== "object")
-        return "";
-    const r = result;
-    if (Array.isArray(r.content)) {
-        const firstText = r.content.find((c) => c?.type === "text" && typeof c?.text === "string");
-        if (firstText && typeof firstText.text === "string") {
-            return truncateForCapture(firstText.text);
-        }
-    }
-    try {
-        return truncateForCapture(JSON.stringify(result));
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * Wraps {@link McpServer.registerTool} so every subsequent tool registration
- * has its handler instrumented with timing, outcome reporting, and a
- * truncated capture of the tool args + response. Must be called *before*
- * tools are registered.
- *
- * The wrapper re-throws thrown exceptions so the SDK still surfaces them to
- * the client — telemetry is observational, never an error sink.
- *
- * @param server - The MCP server whose registrations should be instrumented.
- * @param telemetry - Telemetry sink (no-op when telemetry is disabled).
- */
-export function instrumentToolRegistrations(server, telemetry) {
-    const original = server.registerTool.bind(server);
-    const wrapped = (name, config, handler) => {
-        const instrumented = async (...handlerArgs) => {
-            const startedAt = Date.now();
-            const args = captureArgs(handlerArgs);
-            try {
-                const result = (await handler(...handlerArgs));
-                telemetry.trackToolCall({
-                    tool: name,
-                    outcome: result?.isError ? "tool_error" : "success",
-                    durationMs: Date.now() - startedAt,
-                    args,
-                    response: captureResponse(result),
-                });
-                return result;
-            }
-            catch (error) {
-                telemetry.trackToolCall({
-                    tool: name,
-                    outcome: "exception",
-                    durationMs: Date.now() - startedAt,
-                    errorType: error instanceof Error ? error.name : "Error",
-                    args,
-                    // No response to capture — the handler threw before returning.
-                    response: "",
-                });
-                throw error;
-            }
-        };
-        return original(name, config, instrumented);
-    };
-    server.registerTool = wrapped;
-}
-//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/tools/analytics-filters.d.ts

@@ -1,18 +0,0 @@
-/**
- * Shared filter helpers for analytics tools (facet_query, aggregate_query).
- * @module mcp/tools/analytics-filters
- */
-import type { EntityType, QueryBuilder } from "@digital-science/dimensions-dsl";
-import { type ExtendedWhereFilterInput } from "@digital-science/dimensions-dsl";
-/**
- * Applies year range and extended where filters to an analytics query builder.
- * @param builder - Query builder for the target entity
- * @param entityType - Entity being analyzed
- * @param args - Tool arguments with optional yearFrom, yearTo, filters
- */
-export declare function applyAnalyticsFilters(builder: QueryBuilder, entityType: EntityType, args: {
-    yearFrom?: number;
-    yearTo?: number;
-    filters?: readonly ExtendedWhereFilterInput[];
-}): void;
-//# sourceMappingURL=analytics-filters.d.ts.map

package/dist/tools/analytics-filters.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analytics-filters.d.ts","sourceRoot":"","sources":["../../src/tools/analytics-filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,iCAAiC,CAAC;AAYzC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE;IACJ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,CAAC;CAC/C,GACA,IAAI,CAaN"}

package/dist/tools/analytics-filters.js

@@ -1,35 +0,0 @@
-/**
- * Shared filter helpers for analytics tools (facet_query, aggregate_query).
- * @module mcp/tools/analytics-filters
- */
-import { applyFilters, } from "@digital-science/dimensions-dsl";
-/** Primary year field per entity for convenience yearFrom/yearTo filters. */
-const ENTITY_YEAR_FIELD = {
-    publications: "year",
-    grants: "start_year",
-    patents: "year",
-    clinical_trials: "year",
-    datasets: "year",
-    policy_documents: "year",
-};
-/**
- * Applies year range and extended where filters to an analytics query builder.
- * @param builder - Query builder for the target entity
- * @param entityType - Entity being analyzed
- * @param args - Tool arguments with optional yearFrom, yearTo, filters
- */
-export function applyAnalyticsFilters(builder, entityType, args) {
-    const yearField = ENTITY_YEAR_FIELD[entityType];
-    if (yearField) {
-        if (typeof args.yearFrom === "number") {
-            builder.where(yearField, ">=", args.yearFrom);
-        }
-        if (typeof args.yearTo === "number") {
-            builder.where(yearField, "<=", args.yearTo);
-        }
-    }
-    if (args.filters?.length) {
-        applyFilters(builder, args.filters);
-    }
-}
-//# sourceMappingURL=analytics-filters.js.map

package/dist/tools/analytics-filters.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"analytics-filters.js","sourceRoot":"","sources":["../../src/tools/analytics-filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,GAEb,MAAM,iCAAiC,CAAC;AAEzC,6EAA6E;AAC7E,MAAM,iBAAiB,GAAwC;IAC7D,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,MAAM;IACf,eAAe,EAAE,MAAM;IACvB,QAAQ,EAAE,MAAM;IAChB,gBAAgB,EAAE,MAAM;CACzB,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAqB,EACrB,UAAsB,EACtB,IAIC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,SAAS,EAAE,CAAC;QACd,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACzB,YAAY,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/tools/analytics.d.ts

@@ -1,16 +0,0 @@
-/**
- * Analytics tools for the MCP server.
- * Provides tools for facet distribution analysis, metric aggregation, and time-series trends.
- * @module mcp/tools/analytics
- */
-import type { DimensionsClient } from "@digital-science/dimensions-dsl";
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { SchemaStore } from "../schema/index.js";
-/**
- * Registers all analytics tools with the MCP server.
- * @param server - MCP server instance
- * @param client - Dimensions client instance
- * @param schemaStore - Loaded describe schema
- */
-export declare function registerAnalyticsTools(server: McpServer, client: DimensionsClient, schemaStore: SchemaStore): void;
-//# sourceMappingURL=analytics.d.ts.map

package/dist/tools/analytics.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../src/tools/analytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAY,gBAAgB,EAAc,MAAM,iCAAiC,CAAC;AAO9F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA4FtD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,WAAW,GACvB,IAAI,CA6UN"}