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

package/dist/kwq/ensemble.js

@@ -1,107 +0,0 @@
-/**
- * Ring 4: RRF (Reciprocal Rank Fusion) ensemble.
- *
- * Executes multiple QuerySpecs in parallel, merges results using RRF scoring,
- * and returns a fused ranking. Pure function — no LLM dependency.
- *
- * @module ensemble
- */
-import { buildQuery } from "./build-query.js";
-const DEFAULT_K = 60;
-const DEFAULT_LIMIT = 100;
-/**
- * Execute multiple query specs and fuse results using Reciprocal Rank Fusion.
- *
- * RRF score for a document `d` across N ranked lists:
- *   score(d) = Σ 1/(k + rank_i(d))
- * where rank_i is the 0-based position in list i.
- *
- * @param execute - Executes a DSL string and returns the raw API response.
- *   In MCP context: `(dsl) => client.rawQuery(dsl)`.
- * @param specs - Query specifications to build, execute, and fuse.
- * @param options - Optional k (default 60) and limit (default 100).
- *
- * @example
- * ```typescript
- * const result = await ensembleQueries(
- *   (dsl) => client.rawQuery(dsl),
- *   [
- *     { entity: "publications", search: "quantum networking" },
- *     { entity: "publications", search: "quantum key distribution" },
- *   ],
- * );
- * // result.items: [{ id: "pub.123", rrfScore: 0.033, ... }, ...]
- * ```
- */
-export async function ensembleQueries(execute, specs, options) {
-    const startMs = Date.now();
-    const k = options?.k ?? DEFAULT_K;
-    const limit = options?.limit ?? DEFAULT_LIMIT;
-    // Phase 1: Build DSL for each spec, skip invalid ones
-    const built = specs.map((spec, originalIndex) => {
-        const result = buildQuery(spec);
-        return { spec, result, valid: result.validation._tag === "valid", originalIndex };
-    });
-    // Phase 2: Execute valid queries in parallel
-    const validEntries = built.filter((b) => b.valid);
-    const settled = await Promise.allSettled(validEntries.map((entry) => execute(entry.result.dsl)));
-    const rankedLists = [];
-    for (let i = 0; i < settled.length; i++) {
-        const outcome = settled[i];
-        if (outcome.status !== "fulfilled")
-            continue;
-        const response = outcome.value;
-        const entity = validEntries[i].spec.entity;
-        // Dimensions API returns entity array under the entity name key
-        const entityArray = response[entity];
-        if (!Array.isArray(entityArray))
-            continue;
-        rankedLists.push({
-            specIndex: validEntries[i].originalIndex,
-            items: entityArray,
-        });
-    }
-    // Phase 4: RRF merge
-    const scoreMap = new Map();
-    for (const list of rankedLists) {
-        for (let rank = 0; rank < list.items.length; rank++) {
-            const item = list.items[rank];
-            const id = String(item.id ?? "");
-            if (!id)
-                continue;
-            const existing = scoreMap.get(id);
-            const contribution = 1 / (k + rank);
-            if (existing) {
-                existing.rrfScore += contribution;
-                existing.sourceIndices.push(list.specIndex);
-            }
-            else {
-                scoreMap.set(id, {
-                    rrfScore: contribution,
-                    sourceIndices: [list.specIndex],
-                    data: item,
-                });
-            }
-        }
-    }
-    // Phase 5: Sort by rrfScore descending, truncate to limit
-    const items = [...scoreMap.entries()]
-        .map(([id, entry]) => ({
-        id,
-        rrfScore: entry.rrfScore,
-        sourceIndices: entry.sourceIndices,
-        data: entry.data,
-    }))
-        .sort((a, b) => b.rrfScore - a.rrfScore)
-        .slice(0, limit);
-    return {
-        items,
-        metadata: {
-            specsProvided: specs.length,
-            specsExecuted: rankedLists.length,
-            k,
-            durationMs: Date.now() - startMs,
-        },
-    };
-}
-//# sourceMappingURL=ensemble.js.map

package/dist/kwq/ensemble.js.map

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

package/dist/kwq/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * @digital-science/dimensions-kwq
- *
- * Keyword query construction for Dimensions DSL.
- *
- * Ring 1: buildQuery() — structured spec → DSL string
- * Ring 4: ensembleQueries() — multi-query RRF fusion
- *
- * @module index
- */
-export { buildQuery, buildSearchNode } from "./build-query.js";
-export type { ConceptGroup, ConceptGroupsInput } from "./concept-groups.js";
-export { conceptGroupsToQuerySpec } from "./concept-groups.js";
-export { ensembleQueries } from "./ensemble.js";
-export type { BuildResult, EnsembleItem, EnsembleResult, FilterSpec, QuerySpec, SearchExpr, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/kwq/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/kwq/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/D,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,YAAY,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,UAAU,EACV,SAAS,EACT,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/kwq/index.js

@@ -1,14 +0,0 @@
-/**
- * @digital-science/dimensions-kwq
- *
- * Keyword query construction for Dimensions DSL.
- *
- * Ring 1: buildQuery() — structured spec → DSL string
- * Ring 4: ensembleQueries() — multi-query RRF fusion
- *
- * @module index
- */
-export { buildQuery, buildSearchNode } from "./build-query.js";
-export { conceptGroupsToQuerySpec } from "./concept-groups.js";
-export { ensembleQueries } from "./ensemble.js";
-//# sourceMappingURL=index.js.map

package/dist/kwq/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/kwq/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAE/D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/kwq/types.d.ts

@@ -1,120 +0,0 @@
-/**
- * Types for the KWQ (Keyword Query) package.
- *
- * Ring 1: QuerySpec → buildQuery() → BuildResult (DSL string)
- * Ring 4: ensembleQueries() → EnsembleResult
- *
- * @module types
- */
-/** Result of structural query validation (API validates on execute). */
-export type ValidationResult = {
-    readonly _tag: "valid";
-    readonly warnings: readonly [];
-} | {
-    readonly _tag: "invalid";
-    readonly errors: readonly {
-        readonly message: string;
-    }[];
-    readonly warnings: readonly [];
-};
-/** Dimensions search index names (see describe schema `search_fields`). */
-export type SearchIndex = "full_data" | "full_data_exact" | "title_abstract_only" | "title_only" | "authors" | "inventors" | "investigators" | "concepts" | "funding" | "abstract_only" | "title_abstract" | "title_abstract_concepts";
-/**
- * A search expression tree.
- *
- * - `string` shorthand becomes a single phrase with default index
- * - `{ term, index? }` for explicit per-clause index control
- * - `{ and: [...] }` / `{ or: [...] }` for boolean composition
- */
-export type SearchExpr = string | {
-    readonly term: string;
-    readonly index?: SearchIndex;
-} | {
-    readonly and: readonly SearchExpr[];
-} | {
-    readonly or: readonly SearchExpr[];
-};
-/**
- * A WHERE-clause filter.
- */
-export interface FilterSpec {
-    readonly field: string;
-    readonly op: "=" | "!=" | ">" | "<" | ">=" | "<=" | "in" | "~";
-    readonly value: string | number | readonly string[] | readonly number[];
-}
-/**
- * Full query specification — the input to `buildQuery()`.
- */
-export interface QuerySpec {
-    /** Target entity type */
-    readonly entity: "publications" | "grants" | "researchers" | "patents" | "clinical_trials" | "datasets" | "policy_documents" | "organizations";
-    /** Search expression (the `for "..."` clause) */
-    readonly search?: SearchExpr;
-    /** Exclusion expression — combined as `search NOT exclude` */
-    readonly exclude?: SearchExpr;
-    /** Default search index for terms without explicit index */
-    readonly index?: SearchIndex;
-    /** WHERE-clause filters */
-    readonly filters?: readonly FilterSpec[];
-    /** Fields to return */
-    readonly fields?: readonly string[];
-    /** Sort field */
-    readonly sortBy?: string;
-    /** Sort order (default: "desc") */
-    readonly sortOrder?: "asc" | "desc";
-    /** Result limit (default: 20) */
-    readonly limit?: number;
-    /** Result offset */
-    readonly skip?: number;
-}
-/** Lightweight complexity summary for a built query. */
-export interface QueryComplexity {
-    readonly filterCount: number;
-    readonly hasExclusion: boolean;
-    readonly hasSearch: boolean;
-}
-/**
- * Result of `buildQuery()`.
- */
-export interface BuildResult {
-    /** Emitted DSL string */
-    readonly dsl: string;
-    /** Validation result (may be valid with warnings, or invalid with errors) */
-    readonly validation: ValidationResult;
-    /** Human-readable query explanation */
-    readonly description: string;
-    /** Query complexity metrics */
-    readonly complexity: QueryComplexity;
-}
-/**
- * A single item in the fused RRF ranking.
- */
-export interface EnsembleItem {
-    /** Entity ID (e.g. publication id, grant id) */
-    readonly id: string;
-    /** Reciprocal Rank Fusion score: Σ 1/(k + rank_i) */
-    readonly rrfScore: number;
-    /** Indices of the source specs that contributed this item (0-based) */
-    readonly sourceIndices: readonly number[];
-    /** Raw entity data from the first source that contained this item */
-    readonly data: Record<string, unknown>;
-}
-/**
- * Result of `ensembleQueries()`.
- */
-export interface EnsembleResult {
-    /** Fused items sorted by rrfScore descending */
-    readonly items: readonly EnsembleItem[];
-    /** Ensemble metadata */
-    readonly metadata: {
-        /** Number of specs provided */
-        readonly specsProvided: number;
-        /** Number of specs that produced valid DSL and executed successfully */
-        readonly specsExecuted: number;
-        /** RRF k parameter used */
-        readonly k: number;
-        /** Total duration in milliseconds */
-        readonly durationMs: number;
-    };
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/kwq/types.d.ts.map

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

package/dist/kwq/types.js

@@ -1,11 +0,0 @@
-/**
- * Types for the KWQ (Keyword Query) package.
- *
- * Ring 1: QuerySpec → buildQuery() → BuildResult (DSL string)
- * Ring 4: ensembleQueries() → EnsembleResult
- *
- * @module types
- */
-export {};
-// #endregion
-//# sourceMappingURL=types.js.map

package/dist/kwq/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kwq/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;AA8JH,aAAa"}

package/dist/lambda.d.ts

@@ -1,10 +0,0 @@
-export declare const handler: <L extends import("hono/aws-lambda").LambdaEvent>(event: L, lambdaContext?: import("hono/aws-lambda").LambdaContext) => Promise<import("hono/aws-lambda").APIGatewayProxyResult & (L extends {
-    multiValueHeaders: Record<string, string[]>;
-} ? {
-    headers?: undefined;
-    multiValueHeaders: Record<string, string[]>;
-} : {
-    headers: Record<string, string>;
-    multiValueHeaders?: undefined;
-})>;
-//# sourceMappingURL=lambda.d.ts.map

package/dist/lambda.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"lambda.d.ts","sourceRoot":"","sources":["../src/lambda.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO;;;;;;;;GAAc,CAAC"}

package/dist/lambda.js

@@ -1,4 +0,0 @@
-import { handle } from "hono/aws-lambda";
-import { app } from "./http.js";
-export const handler = handle(app);
-//# sourceMappingURL=lambda.js.map

package/dist/lambda.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"lambda.js","sourceRoot":"","sources":["../src/lambda.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,MAAM,CAAC,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC"}

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

@@ -1,14 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,130 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,15 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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"}