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

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

@@ -0,0 +1,35 @@
+/**
+ * Shared filter helpers for analytics tools (facet_query, aggregate_query).
+ * @module mcp/tools/analytics-filters
+ */
+import { applyFilters } from "../../dsl/index.js";
+/** 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/mcp/tools/analytics-filters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-filters.js","sourceRoot":"","sources":["../../../src/mcp/tools/analytics-filters.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,YAAY,EAAiC,MAAM,oBAAoB,CAAC;AAEjF,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/mcp/tools/analytics.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Analytics tools for the MCP server.
+ * Provides tools for facet distribution analysis, metric aggregation, and time-series trends.
+ * @module mcp/tools/analytics
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DimensionsClient } from "../../dsl/index.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/mcp/tools/analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/analytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAY,gBAAgB,EAAc,MAAM,oBAAoB,CAAC;AAQjF,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"}

package/dist/mcp/tools/analytics.js

@@ -0,0 +1,381 @@
+/**
+ * Analytics tools for the MCP server.
+ * Provides tools for facet distribution analysis, metric aggregation, and time-series trends.
+ * @module mcp/tools/analytics
+ */
+import { ErrorCode, McpError } from "@modelcontextprotocol/sdk/types.js";
+import { z } from "zod";
+import { ExtendedWhereFilterSchema, parseFacetResponse, SUPPORTED_CURRENCIES, } from "../../dsl/index.js";
+import { resolveFacetFieldName, withFieldAliases } from "../middleware/field-aliases.js";
+import { formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS } from "../utils.js";
+import { applyAnalyticsFilters } from "./analytics-filters.js";
+/** API may return year→value map or an array; normalize for MCP output schemas. */
+function normalizeYearSeries(data, valueKey) {
+    if (Array.isArray(data)) {
+        return data;
+    }
+    if (data && typeof data === "object") {
+        return Object.entries(data)
+            .map(([year, value]) => ({ year: Number(year), [valueKey]: value }))
+            .sort((a, b) => a.year - b.year);
+    }
+    return [];
+}
+/**
+ * Zod enum of structured entity types from the loaded schema.
+ * @param schemaStore - Loaded describe schema
+ * @returns Entity type enum for tool input schemas
+ */
+function entityTypeEnum(schemaStore) {
+    const types = schemaStore.structuredEntityTypes();
+    if (types.length === 0) {
+        return z.string().min(1).describe("Entity type (no sources loaded in schema)");
+    }
+    return z
+        .enum(types)
+        .describe("The entity type to analyze (e.g., 'publications', 'grants', 'patents')");
+}
+/**
+ * Validates a facet field against describe schema.
+ * @param schemaStore - Loaded schema
+ * @param entity - Entity type
+ * @param facetField - Facet field name
+ */
+function assertFacetField(schemaStore, entity, facetField) {
+    const valid = schemaStore.facetFields(entity);
+    if (!valid.includes(facetField)) {
+        throw new McpError(ErrorCode.InvalidParams, `Invalid facet field "${facetField}" for entity "${entity}". Valid fields: ${valid.join(", ") || "(none)"}`);
+    }
+}
+/**
+ * Validates aggregation indicators against describe schema.
+ * @param schemaStore - Loaded schema
+ * @param entity - Entity type
+ * @param indicators - Metric names
+ */
+function assertIndicators(schemaStore, entity, indicators) {
+    const valid = new Set(schemaStore.metrics(entity));
+    const invalid = indicators.filter((name) => !valid.has(name));
+    if (invalid.length > 0) {
+        throw new McpError(ErrorCode.InvalidParams, `Invalid indicator(s) for entity "${entity}": ${invalid.join(", ")}. Valid metrics: ${[...valid].join(", ") || "(none)"}`);
+    }
+}
+/**
+ * Builds facet field hint text from describe schema.
+ * @param schemaStore - Loaded schema
+ * @returns Description fragment
+ */
+function facetFieldsDescription(schemaStore) {
+    return schemaStore
+        .structuredEntityTypes()
+        .map((entity) => `${entity}: ${schemaStore.facetFieldsHint(entity)}`)
+        .join(". ");
+}
+/**
+ * Builds metrics hint text from describe schema.
+ * @param schemaStore - Loaded schema
+ * @returns Description fragment
+ */
+function metricsDescription(schemaStore) {
+    return schemaStore
+        .structuredEntityTypes()
+        .map((entity) => `${entity}: ${schemaStore.metricsHint(entity)}`)
+        .join(". ");
+}
+/**
+ * Registers all analytics tools with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ * @param schemaStore - Loaded describe schema
+ */
+export function registerAnalyticsTools(server, client, schemaStore) {
+    const facetHint = facetFieldsDescription(schemaStore);
+    const metricsHint = metricsDescription(schemaStore);
+    const entityTypeSchema = entityTypeEnum(schemaStore);
+    // Facet Query
+    server.registerTool("facet_query", {
+        description: "Distribution analysis across entity dimensions. Returns facet buckets showing how records " +
+            "are distributed across a categorical field. Example: 'What journals publish the most CRISPR research?'",
+        inputSchema: {
+            entityType: entityTypeSchema,
+            facetField: z
+                .string()
+                .min(1)
+                .describe(`Field to facet on. Valid fields by entity: ${facetHint}`),
+            query: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional search query to filter records before faceting (e.g., 'CRISPR gene editing')"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .max(100)
+                .default(20)
+                .describe("Maximum number of facet buckets to return (default 20, max 100)"),
+            yearFrom: z
+                .number()
+                .int()
+                .optional()
+                .describe("Filter records from this year (publications: year; grants: start_year)"),
+            yearTo: z
+                .number()
+                .int()
+                .optional()
+                .describe("Filter records up to this year (publications: year; grants: start_year)"),
+            filters: z
+                .array(ExtendedWhereFilterSchema)
+                .optional()
+                .describe("Additional where-clause filters before faceting"),
+        },
+        outputSchema: {
+            entityType: z.string().describe("Entity type analyzed"),
+            facetField: z.string().describe("Field faceted on"),
+            totalBuckets: z.number().describe("Number of facet buckets returned"),
+            buckets: z.array(z.record(z.string(), z.unknown())).describe("Facet bucket distribution"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, withFieldAliases({
+        entitySource: { kind: "dynamic", argName: "entityType" },
+        filterArrayArgs: ["filters"],
+    }, async (args) => {
+        try {
+            const facetField = resolveFacetFieldName(args.entityType, args.facetField);
+            assertFacetField(schemaStore, args.entityType, facetField);
+            const builder = client.createQueryBuilder().search(args.entityType);
+            if (args.query) {
+                builder.for(args.query);
+            }
+            applyAnalyticsFilters(builder, args.entityType, args);
+            builder.returnFacet(facetField, { limit: args.limit });
+            const response = (await client.rawQuery(builder.build()));
+            const facetConfigs = {
+                [facetField]: {},
+            };
+            const parsed = parseFacetResponse(response, args.entityType, facetConfigs, {
+                includeRaw: false,
+            });
+            const facets = parsed.facets[facetField];
+            return formatToolResult({
+                entityType: args.entityType,
+                facetField,
+                totalBuckets: facets.buckets.length,
+                buckets: facets.buckets,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    }));
+    // Aggregate Query
+    server.registerTool("aggregate_query", {
+        description: "Metric aggregation on facet buckets. Returns facet buckets enriched with aggregated indicator " +
+            "values. Example: 'Which funders have the highest average citation ratio?'",
+        inputSchema: {
+            entityType: entityTypeSchema,
+            facetField: z
+                .string()
+                .min(1)
+                .describe(`Field to facet on. Valid fields by entity: ${facetHint}`),
+            indicators: z
+                .array(z.string().min(1))
+                .min(1)
+                .describe(`Aggregation indicators per bucket. Valid metrics by entity: ${metricsHint}`),
+            query: z
+                .string()
+                .min(1)
+                .optional()
+                .describe("Optional search query to filter records before aggregating"),
+            sortBy: z
+                .string()
+                .optional()
+                .describe("Field to sort buckets by (must be 'count' or one of the specified indicators)"),
+            sortOrder: z.enum(["asc", "desc"]).optional().describe("Sort direction — 'asc' or 'desc'"),
+            limit: z
+                .number()
+                .int()
+                .min(1)
+                .default(20)
+                .describe("Maximum number of facet buckets to return (default 20)"),
+            yearFrom: z
+                .number()
+                .int()
+                .optional()
+                .describe("Filter records from this year (publications: year; grants: start_year)"),
+            yearTo: z
+                .number()
+                .int()
+                .optional()
+                .describe("Filter records up to this year (publications: year; grants: start_year)"),
+            filters: z
+                .array(ExtendedWhereFilterSchema)
+                .optional()
+                .describe("Additional where-clause filters before aggregating"),
+        },
+        outputSchema: {
+            entityType: z.string().describe("Entity type analyzed"),
+            facetField: z.string().describe("Field faceted on"),
+            indicators: z.array(z.string()).describe("Aggregation indicators computed"),
+            totalBuckets: z.number().describe("Number of facet buckets returned"),
+            buckets: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe("Facet buckets with aggregated values"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, withFieldAliases({
+        entitySource: { kind: "dynamic", argName: "entityType" },
+        fieldStringArgs: ["sortBy"],
+        fieldArrayArgs: ["indicators"],
+        filterArrayArgs: ["filters"],
+    }, async (args) => {
+        try {
+            const facetField = resolveFacetFieldName(args.entityType, args.facetField);
+            assertFacetField(schemaStore, args.entityType, facetField);
+            assertIndicators(schemaStore, args.entityType, args.indicators);
+            const builder = client.createQueryBuilder().search(args.entityType);
+            if (args.query) {
+                builder.for(args.query);
+            }
+            applyAnalyticsFilters(builder, args.entityType, args);
+            builder.returnAggregate(facetField, args.indicators, {
+                sortBy: args.sortBy,
+                sortOrder: args.sortOrder,
+                limit: args.limit,
+            });
+            const response = (await client.rawQuery(builder.build()));
+            const facetConfigs = {
+                [facetField]: { indicators: args.indicators },
+            };
+            const parsed = parseFacetResponse(response, args.entityType, facetConfigs, {
+                includeRaw: false,
+            });
+            const facets = parsed.facets[facetField];
+            return formatToolResult({
+                entityType: args.entityType,
+                facetField,
+                indicators: args.indicators,
+                totalBuckets: facets.buckets.length,
+                buckets: facets.buckets,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    }));
+    // Citation Trend
+    server.registerTool("citation_trend", {
+        description: "Year-by-year citation counts for a topic. Returns annual citation totals for publications " +
+            "matching the query over the specified year range.",
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .describe("Search query to identify publications (e.g., 'CRISPR gene editing')"),
+            startYear: z
+                .number()
+                .int()
+                .min(1900)
+                .max(2100)
+                .describe("First year of the time range (inclusive)"),
+            endYear: z
+                .number()
+                .int()
+                .min(1900)
+                .max(2100)
+                .describe("Last year of the time range (inclusive)"),
+        },
+        outputSchema: {
+            query: z.string().describe("Search query used"),
+            startYear: z.number().describe("First year of range"),
+            endYear: z.number().describe("Last year of range"),
+            citationsPerYear: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe("Annual citation totals"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            if (args.startYear > args.endYear) {
+                throw new McpError(ErrorCode.InvalidParams, `startYear (${args.startYear}) must be ≤ endYear (${args.endYear})`);
+            }
+            const dsl = client
+                .createQueryBuilder()
+                .search("publications")
+                .for(args.query)
+                .returnCitationsPerYear(args.startYear, args.endYear)
+                .build();
+            const response = await client.rawQuery(dsl);
+            return formatToolResult({
+                query: args.query,
+                startYear: args.startYear,
+                endYear: args.endYear,
+                citationsPerYear: normalizeYearSeries(response.citations_per_year, "count"),
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+    // Funding Trend
+    server.registerTool("funding_trend", {
+        description: "Year-by-year funding totals for a topic. Returns annual grant funding amounts for grants " +
+            "matching the query over the specified year range.",
+        inputSchema: {
+            query: z
+                .string()
+                .min(1)
+                .describe("Search query to identify grants (e.g., 'cancer immunotherapy')"),
+            startYear: z
+                .number()
+                .int()
+                .min(1900)
+                .max(2100)
+                .describe("First year of the time range (inclusive)"),
+            endYear: z
+                .number()
+                .int()
+                .min(1900)
+                .max(2100)
+                .describe("Last year of the time range (inclusive)"),
+            currency: z
+                .enum(SUPPORTED_CURRENCIES)
+                .default("USD")
+                .describe(`Currency for funding amounts (default USD). Supported: ${SUPPORTED_CURRENCIES.join(", ")}.`),
+        },
+        outputSchema: {
+            query: z.string().describe("Search query used"),
+            startYear: z.number().describe("First year of range"),
+            endYear: z.number().describe("Last year of range"),
+            currency: z.string().describe("Currency of funding amounts"),
+            fundingPerYear: z
+                .array(z.record(z.string(), z.unknown()))
+                .describe("Annual funding totals"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            if (args.startYear > args.endYear) {
+                throw new McpError(ErrorCode.InvalidParams, `startYear (${args.startYear}) must be ≤ endYear (${args.endYear})`);
+            }
+            const dsl = client
+                .createQueryBuilder()
+                .search("grants")
+                .for(args.query)
+                .returnFundingPerYear(args.startYear, args.endYear, args.currency)
+                .build();
+            const response = await client.rawQuery(dsl);
+            return formatToolResult({
+                query: args.query,
+                startYear: args.startYear,
+                endYear: args.endYear,
+                currency: args.currency,
+                fundingPerYear: normalizeYearSeries(response.funding_per_year, "funding"),
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=analytics.js.map

package/dist/mcp/tools/analytics.js.map

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

package/dist/mcp/tools/concept-profile.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Concept profile tool for the MCP server.
+ * Provides multi-dimensional concept profiling across entity types via the Dimensions DSL.
+ * @module mcp/tools/concept-profile
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DimensionsClient } from "../../dsl/index.js";
+/**
+ * Registers the concept_profile tool with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export declare function registerConceptProfileTools(server: McpServer, client: DimensionsClient): void;
+//# sourceMappingURL=concept-profile.d.ts.map

package/dist/mcp/tools/concept-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-profile.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/concept-profile.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAkB3D;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAkI7F"}

package/dist/mcp/tools/concept-profile.js

@@ -0,0 +1,130 @@
+/**
+ * Concept profile tool for the MCP server.
+ * Provides multi-dimensional concept profiling across entity types via the Dimensions DSL.
+ * @module mcp/tools/concept-profile
+ */
+import { z } from "zod";
+import { asArray, formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS, } from "../utils.js";
+/** Entity types used for entity footprint counts. */
+const FOOTPRINT_ENTITIES = [
+    "publications",
+    "grants",
+    "patents",
+    "clinical_trials",
+    "datasets",
+    "policy_documents",
+];
+/**
+ * Registers the concept_profile tool with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export function registerConceptProfileTools(server, client) {
+    server.registerTool("concept_profile", {
+        description: "Build a multi-dimensional profile for a research concept. Returns publication analytics (year trends, top orgs, journals, funders, field classification) and entity footprint across 6 entity types.",
+        inputSchema: {
+            concept: z.string().describe("The concept to profile (e.g., 'CRISPR', 'machine learning')"),
+            includeAnalytics: z
+                .boolean()
+                .default(true)
+                .describe("Include DSL facet analytics (year trends, top orgs, journals, funders, fields)"),
+            includeEntityFootprint: z
+                .boolean()
+                .default(true)
+                .describe("Include cross-entity type record counts"),
+            facetLimit: z
+                .number()
+                .int()
+                .min(1)
+                .max(50)
+                .default(10)
+                .describe("Max buckets per facet in analytics"),
+        },
+        outputSchema: {
+            found: z.boolean().describe("Whether results were found for the concept"),
+            concept: z.string().optional().describe("The profiled concept"),
+            profile: z
+                .record(z.string(), z.unknown())
+                .optional()
+                .describe("Multi-dimensional concept profile"),
+        },
+        annotations: READ_ONLY_API_ANNOTATIONS,
+    }, async (args) => {
+        try {
+            const profile = {};
+            const phases = [];
+            // Phase 1: DSL facet analytics
+            if (args.includeAnalytics !== false) {
+                phases.push((async () => {
+                    const facetFields = ["year", "research_orgs", "journal", "funders", "category_for"];
+                    const facetResults = await Promise.all(facetFields.map(async (field) => {
+                        const dsl = client
+                            .createQueryBuilder()
+                            .search("publications")
+                            .for(args.concept)
+                            .returnFacet(field, { limit: field === "year" ? 50 : args.facetLimit })
+                            .limit(0)
+                            .build();
+                        const response = await client.rawQuery(dsl);
+                        return { field, data: response };
+                    }));
+                    const analytics = {};
+                    for (const { field, data } of facetResults) {
+                        const buckets = asArray(data[field]);
+                        switch (field) {
+                            case "year":
+                                analytics.yearTrend = buckets;
+                                break;
+                            case "research_orgs":
+                                analytics.topOrgs = buckets;
+                                break;
+                            case "journal":
+                                analytics.topJournals = buckets;
+                                break;
+                            case "funders":
+                                analytics.topFunders = buckets;
+                                break;
+                            case "category_for":
+                                analytics.fieldClassification = buckets;
+                                break;
+                        }
+                    }
+                    profile.analytics = analytics;
+                })());
+            }
+            // Phase 2: DSL entity footprint
+            if (args.includeEntityFootprint !== false) {
+                phases.push((async () => {
+                    const counts = await Promise.all(FOOTPRINT_ENTITIES.map(async (entityType) => {
+                        const dsl = client
+                            .createQueryBuilder()
+                            .search(entityType)
+                            .for(args.concept)
+                            .limit(1)
+                            .build();
+                        const response = await client.rawQuery(dsl);
+                        const total = typeof response._stats?.total_count === "number"
+                            ? response._stats.total_count
+                            : 0;
+                        return { entityType, count: total };
+                    }));
+                    const entityFootprint = {};
+                    for (const { entityType, count } of counts) {
+                        entityFootprint[entityType] = count;
+                    }
+                    profile.entityFootprint = entityFootprint;
+                })());
+            }
+            await Promise.all(phases);
+            return formatToolResult({
+                found: true,
+                concept: args.concept,
+                profile,
+            });
+        }
+        catch (error) {
+            return formatErrorResult(error);
+        }
+    });
+}
+//# sourceMappingURL=concept-profile.js.map

package/dist/mcp/tools/concept-profile.js.map

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

package/dist/mcp/tools/dataset-profile.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Dataset profile tool for the MCP server.
+ * Provides deep profiling of Dimensions datasets including structural links
+ * to associated publications and grants.
+ * @module mcp/tools/dataset-profile
+ */
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { DimensionsClient } from "../../dsl/index.js";
+/**
+ * Registers the dataset_profile tool with the MCP server.
+ * @param server - MCP server instance
+ * @param client - Dimensions client instance
+ */
+export declare function registerDatasetProfileTools(server: McpServer, client: DimensionsClient): void;
+//# sourceMappingURL=dataset-profile.d.ts.map

package/dist/mcp/tools/dataset-profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataset-profile.d.ts","sourceRoot":"","sources":["../../../src/mcp/tools/dataset-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGzE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAQ3D;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,GAAG,IAAI,CA6M7F"}