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

package/dist/schema/load.js

@@ -1,139 +0,0 @@
-/**
- * Load schema from the Dimensions API or optional disk cache.
- * @module schema/load
- */
-import { readFile, writeFile } from "node:fs/promises";
-import { createSchemaStoreFromResponse } from "./store.js";
-let moduleCache;
-let moduleLoadPromise;
-/**
- * Returns the module-level cached schema store, if loaded.
- * @returns Cached store or undefined before first load
- */
-export function getCachedSchemaStore() {
-    return moduleCache;
-}
-/**
- * Clears the module-level schema cache (for tests and refresh).
- */
-export function clearSchemaCache() {
-    moduleCache = undefined;
-    moduleLoadPromise = undefined;
-}
-/**
- * Reads optional cache file from `SCHEMA_CACHE_PATH` or explicit path.
- * @param cachePath - Path to JSON cache file
- * @returns Cached response or undefined
- */
-async function readCacheFile(cachePath) {
-    try {
-        const text = await readFile(cachePath, "utf8");
-        return JSON.parse(text);
-    }
-    catch {
-        return undefined;
-    }
-}
-/**
- * Writes describe response to cache file.
- * @param cachePath - Path to JSON cache file
- * @param response - Schema response to persist
- */
-async function writeCacheFile(cachePath, response) {
-    await writeFile(cachePath, JSON.stringify(response), "utf8");
-}
-/**
- * Extracts describe schema payload from a raw API response.
- * @param raw - Raw DSL API response
- * @returns Normalized describe schema object
- */
-export function extractDescribeSchema(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        throw new Error("Invalid describe schema response: expected object");
-    }
-    const record = raw;
-    if ("sources" in record || "entities" in record) {
-        return {
-            sources: record.sources ?? {},
-            entities: record.entities ?? {},
-        };
-    }
-    throw new Error("Invalid describe schema response: missing sources/entities");
-}
-/**
- * Extracts version string from `describe version` response.
- * @param raw - Raw DSL API response
- * @returns Version string or undefined
- */
-export function extractDescribeVersion(raw) {
-    if (typeof raw !== "object" || raw === null) {
-        return undefined;
-    }
-    const record = raw;
-    if (typeof record.version === "string") {
-        return record.version;
-    }
-    if (typeof record.release === "string") {
-        return record.release;
-    }
-    return undefined;
-}
-/**
- * Fetches schema from the Dimensions API.
- * @param client - Authenticated Dimensions client
- * @param cachePath - Optional cache file path
- * @returns Loaded schema store
- */
-export async function loadSchema(client, cachePath) {
-    const resolvedCachePath = cachePath ?? process.env.SCHEMA_CACHE_PATH;
-    if (resolvedCachePath) {
-        const cached = await readCacheFile(resolvedCachePath);
-        if (cached) {
-            let version;
-            try {
-                version = extractDescribeVersion(await client.rawQuery("describe version"));
-            }
-            catch {
-                // Version is optional when using cache
-            }
-            const store = createSchemaStoreFromResponse(cached, version);
-            moduleCache = store;
-            return store;
-        }
-    }
-    const started = performance.now();
-    const [schemaRaw, versionRaw] = await Promise.all([
-        client.rawQuery("describe schema"),
-        client.rawQuery("describe version").catch(() => undefined),
-    ]);
-    const response = extractDescribeSchema(schemaRaw);
-    const version = versionRaw ? extractDescribeVersion(versionRaw) : undefined;
-    if (resolvedCachePath) {
-        await writeCacheFile(resolvedCachePath, response);
-    }
-    const store = createSchemaStoreFromResponse(response, version);
-    moduleCache = store;
-    const stats = store.stats();
-    console.error(`[schema] loaded ${stats.sourceCount} sources, ${stats.entityCount} entities` +
-        (stats.dslVersion ? ` (DSL ${stats.dslVersion})` : "") +
-        ` in ${Math.round(performance.now() - started)}ms`);
-    return store;
-}
-/**
- * Returns cached schema or loads once per process.
- * @param client - Authenticated Dimensions client
- * @param cachePath - Optional cache override
- * @returns Schema store
- */
-export async function getOrLoadSchema(client, cachePath) {
-    if (moduleCache) {
-        return moduleCache;
-    }
-    if (!moduleLoadPromise) {
-        moduleLoadPromise = loadSchema(client, cachePath).finally(() => {
-            moduleLoadPromise = undefined;
-        });
-    }
-    return moduleLoadPromise;
-}
-//# sourceMappingURL=load.js.map

package/dist/schema/load.js.map

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

package/dist/schema/store.d.ts

@@ -1,112 +0,0 @@
-/**
- * In-memory schema store built from `describe schema` responses.
- * @module schema/store
- */
-import { type StructuredEntityType } from "./structured-entities.js";
-import type { DescribeSchemaResponse, EntityDescribe, SourceDescribe } from "./types.js";
-/** Operational limits mirrored from upstream DSL constants. */
-export declare const SCHEMA_LIMITS: {
-    readonly maxLimit: 1000;
-    readonly maxOffset: 50000;
-    readonly maxFacetBuckets: 1000;
-    readonly requestsPerMinute: 30;
-};
-/**
- * Read-only schema catalog with derived helper views for MCP tools and resources.
- */
-export declare class SchemaStore {
-    #private;
-    /**
-     * @param response - Parsed `describe schema` payload
-     * @param version - Optional DSL version from `describe version`
-     * @param loadedAt - Timestamp when schema was loaded
-     */
-    constructor(response: DescribeSchemaResponse, version?: string, loadedAt?: Date);
-    /** DSL version string, if known. */
-    get version(): string | undefined;
-    /** When this store was populated. */
-    get loadedAt(): Date;
-    /** Full describe payload. */
-    get raw(): DescribeSchemaResponse;
-    /** All source names. */
-    sourceNames(): readonly string[];
-    /** All auxiliary entity names. */
-    entityNames(): readonly string[];
-    /**
-     * Returns a source schema by name.
-     * @param name - Source name (e.g. `publications`)
-     * @returns Source schema or undefined
-     */
-    getSource(name: string): SourceDescribe | undefined;
-    /**
-     * Returns an auxiliary entity schema by name.
-     * @param name - Entity name (e.g. `journals`)
-     * @returns Entity schema or undefined
-     */
-    getEntity(name: string): EntityDescribe | undefined;
-    /**
-     * Filterable field names for a source.
-     * @param source - Source name
-     * @returns Field names where `is_filter` is true
-     */
-    filterableFields(source: string): readonly string[];
-    /**
-     * Facet field names for a source.
-     * @param source - Source name
-     * @returns Field names marked as facets or entity fields
-     */
-    facetFields(source: string): readonly string[];
-    /**
-     * Search index names for a source.
-     * @param source - Source name
-     * @returns Search field/index names
-     */
-    searchIndexes(source: string): readonly string[];
-    /**
-     * Aggregation indicator names for a source.
-     * @param source - Source name
-     * @returns Metric names
-     */
-    metrics(source: string): readonly string[];
-    /**
-     * Named fieldsets for a source.
-     * @param source - Source name
-     * @returns Fieldset name to field list map
-     */
-    fieldsets(source: string): Readonly<Record<string, readonly string[]>>;
-    /**
-     * Core entity types supported by structured search tools.
-     * @returns Structured sources that exist in the loaded describe schema
-     */
-    structuredEntityTypes(): readonly StructuredEntityType[];
-    /**
-     * Health/stats payload for `/health`.
-     * @returns Summary object
-     */
-    stats(): {
-        dslVersion: string | undefined;
-        sourceCount: number;
-        entityCount: number;
-        schemaLoadedAt: string;
-    };
-    /**
-     * Comma-separated facet fields for tool descriptions.
-     * @param source - Source name
-     * @returns Hint string
-     */
-    facetFieldsHint(source: string): string;
-    /**
-     * Comma-separated metrics for tool descriptions.
-     * @param source - Source name
-     * @returns Hint string
-     */
-    metricsHint(source: string): string;
-}
-/**
- * Builds a {@link SchemaStore} from a describe response.
- * @param response - `describe schema` JSON
- * @param version - Optional DSL version
- * @returns Schema store instance
- */
-export declare function createSchemaStoreFromResponse(response: DescribeSchemaResponse, version?: string): SchemaStore;
-//# sourceMappingURL=store.d.ts.map

package/dist/schema/store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/schema/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA2B,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEzF,+DAA+D;AAC/D,eAAO,MAAM,aAAa;;;;;CAKhB,CAAC;AAEX;;GAEG;AACH,qBAAa,WAAW;;IAOtB;;;;OAIG;gBACS,QAAQ,EAAE,sBAAsB,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,GAAE,IAAiB;IAQ3F,oCAAoC;IACpC,IAAI,OAAO,IAAI,MAAM,GAAG,SAAS,CAEhC;IAED,qCAAqC;IACrC,IAAI,QAAQ,IAAI,IAAI,CAEnB;IAED,6BAA6B;IAC7B,IAAI,GAAG,IAAI,sBAAsB,CAEhC;IAED,wBAAwB;IACxB,WAAW,IAAI,SAAS,MAAM,EAAE;IAIhC,kCAAkC;IAClC,WAAW,IAAI,SAAS,MAAM,EAAE;IAIhC;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAInD;;;;OAIG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAQnD;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAQ9C;;;;OAIG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAOhD;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE;IAO1C;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC;IAItE;;;OAGG;IACH,qBAAqB,IAAI,SAAS,oBAAoB,EAAE;IAIxD;;;OAGG;IACH,KAAK,IAAI;QACP,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB;IASD;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAIvC;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGpC;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,sBAAsB,EAChC,OAAO,CAAC,EAAE,MAAM,GACf,WAAW,CAEb"}

package/dist/schema/store.js

@@ -1,173 +0,0 @@
-/**
- * In-memory schema store built from `describe schema` responses.
- * @module schema/store
- */
-import { STRUCTURED_ENTITY_TYPES } from "./structured-entities.js";
-/** Operational limits mirrored from upstream DSL constants. */
-export const SCHEMA_LIMITS = {
-    maxLimit: 1000,
-    maxOffset: 50000,
-    maxFacetBuckets: 1000,
-    requestsPerMinute: 30,
-};
-/**
- * Read-only schema catalog with derived helper views for MCP tools and resources.
- */
-export class SchemaStore {
-    #version;
-    #loadedAt;
-    #sources;
-    #entities;
-    #raw;
-    /**
-     * @param response - Parsed `describe schema` payload
-     * @param version - Optional DSL version from `describe version`
-     * @param loadedAt - Timestamp when schema was loaded
-     */
-    constructor(response, version, loadedAt = new Date()) {
-        this.#raw = response;
-        this.#version = version;
-        this.#loadedAt = loadedAt;
-        this.#sources = new Map(Object.entries(response.sources ?? {}));
-        this.#entities = new Map(Object.entries(response.entities ?? {}));
-    }
-    /** DSL version string, if known. */
-    get version() {
-        return this.#version;
-    }
-    /** When this store was populated. */
-    get loadedAt() {
-        return this.#loadedAt;
-    }
-    /** Full describe payload. */
-    get raw() {
-        return this.#raw;
-    }
-    /** All source names. */
-    sourceNames() {
-        return [...this.#sources.keys()].sort();
-    }
-    /** All auxiliary entity names. */
-    entityNames() {
-        return [...this.#entities.keys()].sort();
-    }
-    /**
-     * Returns a source schema by name.
-     * @param name - Source name (e.g. `publications`)
-     * @returns Source schema or undefined
-     */
-    getSource(name) {
-        return this.#sources.get(name);
-    }
-    /**
-     * Returns an auxiliary entity schema by name.
-     * @param name - Entity name (e.g. `journals`)
-     * @returns Entity schema or undefined
-     */
-    getEntity(name) {
-        return this.#entities.get(name);
-    }
-    /**
-     * Filterable field names for a source.
-     * @param source - Source name
-     * @returns Field names where `is_filter` is true
-     */
-    filterableFields(source) {
-        const fields = this.#sources.get(source)?.fields ?? {};
-        return Object.entries(fields)
-            .filter(([, f]) => f.is_filter === true)
-            .map(([name]) => name)
-            .sort();
-    }
-    /**
-     * Facet field names for a source.
-     * @param source - Source name
-     * @returns Field names marked as facets or entity fields
-     */
-    facetFields(source) {
-        const fields = this.#sources.get(source)?.fields ?? {};
-        return Object.entries(fields)
-            .filter(([, f]) => f.is_facet === true || f.is_entity === true)
-            .map(([name]) => name)
-            .sort();
-    }
-    /**
-     * Search index names for a source.
-     * @param source - Source name
-     * @returns Search field/index names
-     */
-    searchIndexes(source) {
-        const raw = this.#sources.get(source)?.search_fields;
-        if (!raw)
-            return [];
-        if (Array.isArray(raw))
-            return [...raw].sort();
-        return Object.keys(raw).sort();
-    }
-    /**
-     * Aggregation indicator names for a source.
-     * @param source - Source name
-     * @returns Metric names
-     */
-    metrics(source) {
-        const raw = this.#sources.get(source)?.metrics;
-        if (!raw)
-            return [];
-        if (Array.isArray(raw))
-            return [...raw].sort();
-        return Object.keys(raw).sort();
-    }
-    /**
-     * Named fieldsets for a source.
-     * @param source - Source name
-     * @returns Fieldset name to field list map
-     */
-    fieldsets(source) {
-        return this.#sources.get(source)?.fieldsets ?? {};
-    }
-    /**
-     * Core entity types supported by structured search tools.
-     * @returns Structured sources that exist in the loaded describe schema
-     */
-    structuredEntityTypes() {
-        return STRUCTURED_ENTITY_TYPES.filter((entity) => this.#sources.has(entity));
-    }
-    /**
-     * Health/stats payload for `/health`.
-     * @returns Summary object
-     */
-    stats() {
-        return {
-            dslVersion: this.#version,
-            sourceCount: this.#sources.size,
-            entityCount: this.#entities.size,
-            schemaLoadedAt: this.#loadedAt.toISOString(),
-        };
-    }
-    /**
-     * Comma-separated facet fields for tool descriptions.
-     * @param source - Source name
-     * @returns Hint string
-     */
-    facetFieldsHint(source) {
-        return this.facetFields(source).join(", ") || "(none)";
-    }
-    /**
-     * Comma-separated metrics for tool descriptions.
-     * @param source - Source name
-     * @returns Hint string
-     */
-    metricsHint(source) {
-        return this.metrics(source).join(", ") || "(none)";
-    }
-}
-/**
- * Builds a {@link SchemaStore} from a describe response.
- * @param response - `describe schema` JSON
- * @param version - Optional DSL version
- * @returns Schema store instance
- */
-export function createSchemaStoreFromResponse(response, version) {
-    return new SchemaStore(response, version);
-}
-//# sourceMappingURL=store.js.map

package/dist/schema/store.js.map

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

package/dist/schema/structured-entities.d.ts

@@ -1,21 +0,0 @@
-/**
- * Structured search entity types supported by MCP search tools.
- * @module schema/structured-entities
- */
-/** Source names that have dedicated `search_*` MCP tools. */
-export declare const STRUCTURED_ENTITY_TYPES: readonly ["publications", "grants", "researchers", "patents", "clinical_trials", "datasets", "policy_documents", "organizations"];
-/** A source with a structured search tool. */
-export type StructuredEntityType = (typeof STRUCTURED_ENTITY_TYPES)[number];
-/**
- * MCP tool name for a structured entity.
- * @param source - Dimensions source name
- * @returns Tool name (e.g. `search_publications`)
- */
-export declare function searchToolName(source: StructuredEntityType): string;
-/**
- * JSON result key for entity rows (camelCase where historical tools used it).
- * @param source - Dimensions source name
- * @returns Property name in tool output
- */
-export declare function searchResultKey(source: StructuredEntityType): string;
-//# sourceMappingURL=structured-entities.d.ts.map

package/dist/schema/structured-entities.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"structured-entities.d.ts","sourceRoot":"","sources":["../../src/schema/structured-entities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAC7D,eAAO,MAAM,uBAAuB,mIAS1B,CAAC;AAEX,8CAA8C;AAC9C,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CASpE"}

package/dist/schema/structured-entities.js

@@ -1,39 +0,0 @@
-/**
- * Structured search entity types supported by MCP search tools.
- * @module schema/structured-entities
- */
-/** Source names that have dedicated `search_*` MCP tools. */
-export const STRUCTURED_ENTITY_TYPES = [
-    "publications",
-    "grants",
-    "researchers",
-    "patents",
-    "clinical_trials",
-    "datasets",
-    "policy_documents",
-    "organizations",
-];
-/**
- * MCP tool name for a structured entity.
- * @param source - Dimensions source name
- * @returns Tool name (e.g. `search_publications`)
- */
-export function searchToolName(source) {
-    return `search_${source}`;
-}
-/**
- * JSON result key for entity rows (camelCase where historical tools used it).
- * @param source - Dimensions source name
- * @returns Property name in tool output
- */
-export function searchResultKey(source) {
-    switch (source) {
-        case "clinical_trials":
-            return "clinicalTrials";
-        case "policy_documents":
-            return "policyDocuments";
-        default:
-            return source;
-    }
-}
-//# sourceMappingURL=structured-entities.js.map

package/dist/schema/structured-entities.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"structured-entities.js","sourceRoot":"","sources":["../../src/schema/structured-entities.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,6DAA6D;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,cAAc;IACd,QAAQ;IACR,aAAa;IACb,SAAS;IACT,iBAAiB;IACjB,UAAU;IACV,kBAAkB;IAClB,eAAe;CACP,CAAC;AAKX;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAA4B;IACzD,OAAO,UAAU,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAA4B;IAC1D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,iBAAiB;YACpB,OAAO,gBAAgB,CAAC;QAC1B,KAAK,kBAAkB;YACrB,OAAO,iBAAiB,CAAC;QAC3B;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/schema/types.d.ts

@@ -1,36 +0,0 @@
-/**
- * Types for Dimensions `describe` API responses.
- * @module schema/types
- */
-/** Field metadata from `describe schema` / `describe source`. */
-export type DescribeField = {
-    readonly type: string;
-    readonly description?: string;
-    readonly long_description?: string;
-    readonly is_entity?: boolean;
-    readonly is_filter?: boolean;
-    readonly is_facet?: boolean;
-    readonly is_multivalue?: boolean;
-};
-/** Per-source schema slice from `describe schema`. */
-export type SourceDescribe = {
-    readonly fields: Readonly<Record<string, DescribeField>>;
-    readonly fieldsets?: Readonly<Record<string, readonly string[]>>;
-    readonly metrics?: readonly string[];
-    readonly search_fields?: readonly string[];
-};
-/** Auxiliary entity schema from `describe schema`. */
-export type EntityDescribe = {
-    readonly fields: Readonly<Record<string, DescribeField>>;
-};
-/** Full response from `describe schema`. */
-export type DescribeSchemaResponse = {
-    readonly sources: Readonly<Record<string, SourceDescribe>>;
-    readonly entities: Readonly<Record<string, EntityDescribe>>;
-};
-/** Response from `describe version`. */
-export type DescribeVersionResponse = {
-    readonly version?: string;
-    readonly release?: string;
-};
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/schema/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iEAAiE;AACjE,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,CAAC;AAEF,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;CAC1D,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CAC7D,CAAC;AAEF,wCAAwC;AACxC,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC"}

package/dist/schema/types.js

@@ -1,6 +0,0 @@
-/**
- * Types for Dimensions `describe` API responses.
- * @module schema/types
- */
-export {};
-//# sourceMappingURL=types.js.map

package/dist/schema/types.js.map

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

package/dist/server.d.ts

@@ -1,57 +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 type { Transport } from "@modelcontextprotocol/sdk/shared/transport.js";
-import type { SchemaContext } from "./schema/context.js";
-import { clearSchemaCache, loadSchema, type SchemaStore } from "./schema/index.js";
-/**
- * Configuration options for the MCP server.
- */
-export interface McpServerConfig {
-    /** Dimensions API key (required) */
-    apiKey?: string;
-    /** Base URL for the Dimensions API */
-    baseUrl?: string;
-    /** Pre-loaded schema store (for tests; skips live describe fetch) */
-    schemaStore?: SchemaStore;
-}
-/**
- * Builds server instructions from loaded schema.
- * @param schemaStore - Loaded describe schema
- * @returns Instruction string for MCP clients
- */
-export declare function buildServerInstructions(schemaStore: SchemaStore): string;
-/**
- * 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 declare function createMcpServerAsync(config?: McpServerConfig): Promise<{
-    server: McpServer;
-    client: DimensionsClient;
-    schemaContext: SchemaContext;
-    schemaStore: SchemaStore;
-}>;
-/**
- * A handle returned by {@link startMcpServer} that allows callers to shut down
- * the server and its transport gracefully.
- */
-export interface McpServerHandle {
-    /** Closes the server and transport gracefully. */
-    readonly close: () => Promise<void>;
-}
-/**
- * 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 declare function startMcpServer(injectedTransport?: Transport, config?: McpServerConfig): Promise<McpServerHandle>;
-/** Force reload schema from API (clears module cache). */
-export { clearSchemaCache, loadSchema, McpServer };
-//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAG/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAmB,UAAU,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAcpG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAcD;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM,CA0BxE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC;IAChF,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC;CAC1B,CAAC,CA+DD;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,iBAAiB,CAAC,EAAE,SAAS,EAC7B,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAmB1B;AAED,0DAA0D;AAC1D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}