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

package/dist/kwq/concept-groups.js

@@ -0,0 +1,55 @@
+/**
+ * Converts concept groups (include/exclude term clusters) to a QuerySpec.
+ *
+ * Extracted from `apps/mcp/src/tools/kwq.ts` so both MCP tools and skills
+ * can import from one source.
+ *
+ * @module concept-groups
+ */
+/**
+ * Converts concept groups (or raw search JSON) to a {@link QuerySpec}.
+ *
+ * Include groups: each group's terms OR'd, groups AND'd together.
+ * Exclude groups: all terms flattened into a single OR, negated.
+ *
+ * @param input - Concept groups and query parameters
+ * @returns A fully-formed QuerySpec ready for `buildQuery()`
+ */
+export function conceptGroupsToQuerySpec(input) {
+    let search;
+    let exclude;
+    if (input.search_json) {
+        search = JSON.parse(input.search_json);
+    }
+    else if (input.concept_groups) {
+        const includeGroups = input.concept_groups.filter((g) => g.role === "include");
+        const excludeGroups = input.concept_groups.filter((g) => g.role === "exclude");
+        // Build include expression: each group's terms OR'd, groups AND'd
+        if (includeGroups.length > 0) {
+            const includeExprs = includeGroups.map((g) => g.terms.length === 1 ? g.terms[0] : { or: g.terms });
+            search = includeExprs.length === 1 ? includeExprs[0] : { and: includeExprs };
+        }
+        // Build exclude expression: all exclude terms flattened into a single OR
+        if (excludeGroups.length > 0) {
+            const excludeTerms = excludeGroups.flatMap((g) => g.terms);
+            exclude = excludeTerms.length === 1 ? excludeTerms[0] : { or: excludeTerms };
+        }
+    }
+    return {
+        entity: input.entity,
+        search,
+        exclude,
+        index: input.index,
+        filters: input.filters?.map((f) => ({
+            field: f.field,
+            op: f.op,
+            value: f.value,
+        })),
+        fields: input.fields,
+        sortBy: input.sort_by,
+        sortOrder: input.sort_order,
+        limit: input.limit,
+        skip: input.skip,
+    };
+}
+//# sourceMappingURL=concept-groups.js.map

package/dist/kwq/concept-groups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concept-groups.js","sourceRoot":"","sources":["../../src/kwq/concept-groups.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA+BH;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAyB;IAChE,IAAI,MAA8B,CAAC;IACnC,IAAI,OAA+B,CAAC;IAEpC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,CAAe,CAAC;IACvD,CAAC;SAAM,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;QAChC,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAC/E,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;QAE/E,kEAAkE;QAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAiB,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CACzD,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE,CACpD,CAAC;YACF,MAAM,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC;QAC/E,CAAC;QAED,yEAAyE;QACzE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,YAAY,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAC3D,OAAO,GAAG,YAAY,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,KAAK,CAAC,MAA6B;QAC3C,MAAM;QACN,OAAO;QACP,KAAK,EAAE,KAAK,CAAC,KAA2B;QACxC,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAClC,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,EAAE,EAAE,CAAC,CAAC,EAAuD;YAC7D,KAAK,EAAE,CAAC,CAAC,KAAgE;SAC1E,CAAC,CAAC;QACH,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,SAAS,EAAE,KAAK,CAAC,UAAoC;QACrD,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC;AACJ,CAAC"}

package/dist/kwq/dsl-assembler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Assembles Dimensions DSL query strings from structured specs (no AST).
+ * @module dsl-assembler
+ */
+import type { QuerySpec, SearchExpr } from "./types.js";
+/**
+ * Emits a `for "..."` clause (with optional index) from a search expression.
+ * @param expr - Search expression tree
+ * @param defaultIndex - Default index for string leaves
+ * @returns DSL search fragment (without leading `search`)
+ */
+export declare function buildSearchClause(expr: SearchExpr, defaultIndex: string | null): string;
+/**
+ * Builds a full DSL query string from a {@link QuerySpec}.
+ * @param spec - Structured query specification
+ * @returns DSL source text
+ */
+export declare function assembleQueryDsl(spec: QuerySpec): string;
+/**
+ * Lightweight complexity metrics for a query spec.
+ * @param spec - Query specification
+ */
+export declare function querySpecComplexity(spec: QuerySpec): {
+    readonly filterCount: number;
+    readonly hasExclusion: boolean;
+    readonly hasSearch: boolean;
+};
+//# sourceMappingURL=dsl-assembler.d.ts.map

package/dist/kwq/dsl-assembler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-assembler.d.ts","sourceRoot":"","sources":["../../src/kwq/dsl-assembler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAc,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAcpE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CA6BvF;AA6BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAuCxD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,SAAS,GAAG;IACpD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B,CAMA"}

package/dist/kwq/dsl-assembler.js

@@ -0,0 +1,124 @@
+/**
+ * Assembles Dimensions DSL query strings from structured specs (no AST).
+ * @module dsl-assembler
+ */
+import { escapeDslString } from "../dsl/index.js";
+/** Default search index label when none is set. */
+const DEFAULT_INDEX = "full_data";
+function quoteDsl(text) {
+    return `"${escapeDslString(text)}"`;
+}
+function indexPrefix(index) {
+    if (!index || index === DEFAULT_INDEX)
+        return "";
+    return `in ${index} `;
+}
+/**
+ * Emits a `for "..."` clause (with optional index) from a search expression.
+ * @param expr - Search expression tree
+ * @param defaultIndex - Default index for string leaves
+ * @returns DSL search fragment (without leading `search`)
+ */
+export function buildSearchClause(expr, defaultIndex) {
+    if (typeof expr === "string") {
+        return `${indexPrefix(defaultIndex)}for ${quoteDsl(expr)}`;
+    }
+    if ("term" in expr) {
+        const idx = expr.index ?? defaultIndex;
+        return `${indexPrefix(idx)}for ${quoteDsl(expr.term)}`;
+    }
+    if ("and" in expr) {
+        if (expr.and.length === 0) {
+            throw new Error("AND expression must have at least one child");
+        }
+        const parts = expr.and.map((child) => buildSearchClause(child, defaultIndex));
+        if (parts.length === 1)
+            return parts[0];
+        return parts.map((p) => wrapSearch(p, "or")).join(" and ");
+    }
+    if ("or" in expr) {
+        if (expr.or.length === 0) {
+            throw new Error("OR expression must have at least one child");
+        }
+        const parts = expr.or.map((child) => buildSearchClause(child, defaultIndex));
+        if (parts.length === 1)
+            return parts[0];
+        return `(${parts.join(" or ")})`;
+    }
+    throw new Error("Invalid SearchExpr: must be string, { term }, { and }, or { or }");
+}
+function wrapSearch(clause, childOp) {
+    if (childOp === "or" && clause.includes(" or ")) {
+        return `(${clause})`;
+    }
+    return clause;
+}
+function formatFilterValue(value) {
+    if (typeof value === "string") {
+        return quoteDsl(value);
+    }
+    if (typeof value === "number") {
+        return String(value);
+    }
+    if (Array.isArray(value) && value.length > 0) {
+        if (typeof value[0] === "string") {
+            return `[${value.map(quoteDsl).join(", ")}]`;
+        }
+        return `[${value.join(", ")}]`;
+    }
+    return "[]";
+}
+function formatFilter(filter) {
+    return `${filter.field} ${filter.op} ${formatFilterValue(filter.value)}`;
+}
+/**
+ * Builds a full DSL query string from a {@link QuerySpec}.
+ * @param spec - Structured query specification
+ * @returns DSL source text
+ */
+export function assembleQueryDsl(spec) {
+    const parts = [`search ${spec.entity}`];
+    let searchPart = "";
+    if (spec.search) {
+        searchPart = buildSearchClause(spec.search, spec.index ?? null);
+    }
+    if (spec.exclude) {
+        const excludePart = buildSearchClause(spec.exclude, spec.index ?? null);
+        if (searchPart) {
+            searchPart = `${searchPart} not ${excludePart}`;
+        }
+    }
+    if (searchPart) {
+        parts.push(searchPart);
+    }
+    if (spec.filters?.length) {
+        parts.push(`where ${spec.filters.map(formatFilter).join(" and ")}`);
+    }
+    const returnParts = [`return ${spec.entity}`];
+    if (spec.fields?.length) {
+        returnParts[0] = `return ${spec.entity}[${spec.fields.join(" + ")}]`;
+    }
+    if (spec.sortBy) {
+        returnParts.push(`sort by ${spec.sortBy} ${spec.sortOrder ?? "desc"}`);
+    }
+    if (spec.limit !== undefined) {
+        returnParts.push(`limit ${spec.limit}`);
+    }
+    if (spec.skip !== undefined && spec.skip > 0) {
+        returnParts.push(`skip ${spec.skip}`);
+    }
+    parts.push(returnParts.join(" "));
+    return parts.join(" ");
+}
+/**
+ * Lightweight complexity metrics for a query spec.
+ * @param spec - Query specification
+ */
+export function querySpecComplexity(spec) {
+    return {
+        filterCount: spec.filters?.length ?? 0,
+        hasExclusion: spec.exclude !== undefined,
+        hasSearch: spec.search !== undefined,
+    };
+}
+//# sourceMappingURL=dsl-assembler.js.map

package/dist/kwq/dsl-assembler.js.map

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

package/dist/kwq/ensemble.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 type { EnsembleResult, QuerySpec } from "./types.js";
+/**
+ * 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 declare function ensembleQueries(execute: (dsl: string) => Promise<Record<string, unknown>>, specs: readonly QuerySpec[], options?: {
+    k?: number;
+    limit?: number;
+}): Promise<EnsembleResult>;
+//# sourceMappingURL=ensemble.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensemble.d.ts","sourceRoot":"","sources":["../../src/kwq/ensemble.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAgB,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAK1E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC1D,KAAK,EAAE,SAAS,SAAS,EAAE,EAC3B,OAAO,CAAC,EAAE;IAAE,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC,OAAO,CAAC,cAAc,CAAC,CAoFzB"}

package/dist/kwq/ensemble.js

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

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

package/dist/kwq/index.d.ts

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

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

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

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

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

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

package/dist/kwq/types.js

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

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

package/dist/lambda.d.ts

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

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

package/dist/lambda.js

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

@@ -0,0 +1 @@
+{"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/main.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ * Starts the Dimensions Analytics MCP server with stdio transport.
+ * @module main
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA;;;;GAIG"}

package/dist/main.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+/**
+ * MCP server entry point.
+ * Starts the Dimensions Analytics MCP server with stdio transport.
+ * @module main
+ */
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServerAsync } from "./mcp/server.js";
+let close;
+try {
+    const { server } = await createMcpServerAsync();
+    const transport = new StdioServerTransport();
+    server.server.onerror = (error) => console.error(`MCP server error: ${error.message}`);
+    server.server.onclose = () => {
+        process.exit(0);
+    };
+    await server.connect(transport);
+    close = async () => {
+        await server.close();
+    };
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`Failed to start MCP server: ${message}`);
+    process.exit(1);
+}
+const shutdown = async () => {
+    await close();
+    process.exit(0);
+};
+process.on("SIGTERM", shutdown);
+process.on("SIGINT", shutdown);
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,IAAI,KAA0B,CAAC;AAE/B,IAAI,CAAC;IACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,oBAAoB,EAAE,CAAC;IAEhD,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9F,MAAM,CAAC,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,KAAK,GAAG,KAAK,IAAI,EAAE;QACjB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC,CAAC;AACJ,CAAC;AAAC,OAAO,KAAc,EAAE,CAAC;IACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;IACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;IAC1B,MAAM,KAAK,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAChC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC"}