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

package/dist/tools/search-entity-metadata.js

@@ -1,221 +0,0 @@
-/**
- * Per-entity search tool metadata (descriptions, convenience filters, sort hints).
- * @module mcp/tools/search-entity-metadata
- */
-import { z } from "zod";
-import { resolveFunderOrgName } from "../funder-org-names.js";
-const noop = () => { };
-function yearRange(fromKey, toKey, field) {
-    return (builder, args) => {
-        const from = args[fromKey];
-        const to = args[toKey];
-        if (typeof from === "number") {
-            builder.where(field, ">=", from);
-        }
-        if (typeof to === "number") {
-            builder.where(field, "<=", to);
-        }
-    };
-}
-/** Metadata for all structured search tools. */
-export const SEARCH_ENTITY_METADATA = [
-    {
-        source: "publications",
-        description: "Search research publications in the Dimensions database. Returns articles, preprints, books, and other scholarly works with citation metrics, author information, and metadata.",
-        applyConvenienceFilters: (builder, args) => {
-            yearRange("yearFrom", "yearTo", "year")(builder, args);
-            if (typeof args.type === "string") {
-                builder.where("type", "=", args.type);
-            }
-        },
-        extraInputSchema: {
-            yearFrom: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter publications from this year (inclusive)"),
-            yearTo: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter publications up to this year (inclusive)"),
-            type: z
-                .enum(["article", "chapter", "proceeding", "monograph", "preprint", "book"])
-                .optional()
-                .describe("Filter by publication type"),
-            sortBy: z
-                .enum([
-                "times_cited",
-                "total_citations",
-                "recent_citations",
-                "relative_citation_ratio",
-                "field_citation_ratio",
-                "citation_ratio",
-                "altmetric",
-                "altmetric_score",
-                "year",
-                "date",
-            ])
-                .optional()
-                .describe("Sort results by this field (total_citations = times_cited, citation_ratio = field_citation_ratio, altmetric_score = altmetric)"),
-        },
-    },
-    {
-        source: "grants",
-        description: "Search research grants and funding awards in the Dimensions database. Returns grant information including funding amounts, funders, and research organizations. " +
-            "funderOrgName must match an exact Dimensions funder name (acronyms like NCI and NSF are resolved automatically). " +
-            "Umbrella labels such as NIH often match no grants — discover institute names with facet_query or aggregate_query on facetField funder_orgs.",
-        applyConvenienceFilters: (builder, args) => {
-            yearRange("startYearFrom", "startYearTo", "start_year")(builder, args);
-            if (typeof args.funderOrgName === "string") {
-                builder.where("funder_org_name", "=", resolveFunderOrgName(args.funderOrgName));
-            }
-        },
-        extraInputSchema: {
-            startYearFrom: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter grants starting from this year (inclusive)"),
-            startYearTo: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter grants starting up to this year (inclusive)"),
-            funderOrgName: z
-                .string()
-                .optional()
-                .describe("Filter by funder organization name. Acronyms NCI, NSF, NEH resolve automatically; use facet_query/aggregate_query on funder_orgs to discover exact names."),
-            sortBy: z
-                .enum([
-                "funding_usd",
-                "funding_eur",
-                "funding_amount_usd",
-                "funding_amount_eur",
-                "start_year",
-                "start_date",
-                "end_date",
-            ])
-                .optional()
-                .describe("Sort results by this field (funding_amount_usd = funding_usd, funding_amount_eur = funding_eur)"),
-        },
-    },
-    {
-        source: "researchers",
-        description: "Search researcher profiles by name in the Dimensions database. The query matches researcher names, not research topics — " +
-            "for topic→researcher discovery use facet_query with entityType publications and facetField researchers.",
-        applyConvenienceFilters: noop,
-        extraInputSchema: {
-            sortBy: z
-                .enum(["total_publications", "total_grants"])
-                .optional()
-                .describe("Sort results by this field"),
-        },
-    },
-    {
-        source: "patents",
-        description: "Search patents in the Dimensions database. Returns patent information including titles, abstracts, assignees, and filing dates.",
-        applyConvenienceFilters: (builder, args) => {
-            yearRange("filingYearFrom", "filingYearTo", "year")(builder, args);
-        },
-        extraInputSchema: {
-            filingYearFrom: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter patents filed from this year (inclusive)"),
-            filingYearTo: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter patents filed up to this year (inclusive)"),
-            sortBy: z
-                .enum(["filing_date", "publication_date", "granted_date"])
-                .optional()
-                .describe("Sort results by this field"),
-        },
-    },
-    {
-        source: "clinical_trials",
-        description: "Search clinical trials in the Dimensions database. Returns trial information including phases, conditions studied, and status.",
-        applyConvenienceFilters: (builder, args) => {
-            if (typeof args.phase === "string") {
-                builder.where("phase", "=", args.phase);
-            }
-            if (typeof args.overallStatus === "string") {
-                builder.where("overall_status", "=", args.overallStatus);
-            }
-            yearRange("yearFrom", "yearTo", "year")(builder, args);
-        },
-        extraInputSchema: {
-            phase: z.string().optional().describe("Filter by trial phase (e.g., 'Phase 3')"),
-            overallStatus: z
-                .string()
-                .optional()
-                .describe("Filter by trial status (e.g., 'Completed', 'Recruiting')"),
-            yearFrom: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter trials starting from this year (inclusive)"),
-            yearTo: z
-                .number()
-                .int()
-                .optional()
-                .describe("Filter trials starting up to this year (inclusive)"),
-            sortBy: z.enum(["start_date"]).optional().describe("Sort results by this field"),
-        },
-    },
-    {
-        source: "datasets",
-        description: "Search research datasets in the Dimensions database. Returns dataset information including descriptions, repositories, and associated publications.",
-        applyConvenienceFilters: (builder, args) => {
-            yearRange("yearFrom", "yearTo", "year")(builder, args);
-            if (typeof args.repository === "string") {
-                builder.where("repository", "=", args.repository);
-            }
-        },
-        extraInputSchema: {
-            yearFrom: z.number().int().optional().describe("Filter datasets from this year (inclusive)"),
-            yearTo: z.number().int().optional().describe("Filter datasets up to this year (inclusive)"),
-            repository: z.string().optional().describe("Filter by repository name"),
-            sortBy: z.enum(["year"]).optional().describe("Sort results by this field"),
-        },
-    },
-    {
-        source: "policy_documents",
-        description: "Search policy documents in the Dimensions database. Returns policy briefs, reports, and government documents that cite research.",
-        applyConvenienceFilters: (builder, args) => {
-            yearRange("yearFrom", "yearTo", "year")(builder, args);
-        },
-        extraInputSchema: {
-            yearFrom: z.number().int().optional().describe("Filter documents from this year (inclusive)"),
-            yearTo: z.number().int().optional().describe("Filter documents up to this year (inclusive)"),
-            sortBy: z.enum(["year"]).optional().describe("Sort results by this field"),
-        },
-    },
-    {
-        source: "organizations",
-        description: "Search research organizations in the Dimensions database. Returns universities, research institutes, hospitals, and companies with research output.",
-        applyConvenienceFilters: (builder, args) => {
-            if (typeof args.orgType === "string") {
-                builder.where("types", "=", args.orgType);
-            }
-            if (typeof args.country === "string") {
-                builder.where("country_name", "=", args.country);
-            }
-        },
-        extraInputSchema: {
-            orgType: z
-                .string()
-                .optional()
-                .describe("Filter by organization type (e.g., 'Education', 'Healthcare', 'Company')"),
-            country: z
-                .string()
-                .optional()
-                .describe("Filter by country (e.g., 'United States', 'Germany')"),
-            sortBy: z.enum(["name"]).optional().describe("Sort results by this field"),
-        },
-    },
-];
-//# sourceMappingURL=search-entity-metadata.js.map

package/dist/tools/search-entity-metadata.js.map

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

package/dist/tools/search.d.ts

@@ -1,23 +0,0 @@
-/**
- * Search tools for the MCP server.
- * Registers `search_{source}` tools from describe schema and shared QueryBuilder handlers.
- * @module mcp/tools/search
- */
-import type { DimensionsClient } from "@digital-science/dimensions-dsl";
-import { type SchemaStore, type StructuredEntityType } from "@digital-science/dimensions-dsl";
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-/**
- * Builds DSL for a structured search from tool arguments.
- * @param source - Dimensions source name
- * @param args - Tool arguments (after field-alias resolution)
- * @returns DSL query string
- */
-export declare function buildStructuredSearchDsl(client: DimensionsClient, source: StructuredEntityType, args: Record<string, unknown>): string;
-/**
- * Registers structured search tools for sources present in the schema store.
- * @param server - MCP server instance
- * @param client - Dimensions client instance
- * @param schemaStore - Loaded describe schema
- */
-export declare function registerSearchTools(server: McpServer, client: DimensionsClient, schemaStore: SchemaStore): void;
-//# sourceMappingURL=search.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,oBAAoB,EAG1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsCzE;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,oBAAoB,EAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,MAAM,CA4BR;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,WAAW,GACvB,IAAI,CAyDN"}

package/dist/tools/search.js

@@ -1,110 +0,0 @@
-/**
- * Search tools for the MCP server.
- * Registers `search_{source}` tools from describe schema and shared QueryBuilder handlers.
- * @module mcp/tools/search
- */
-import { applyFilters, ExtendedWhereFilterSchema, parseEntityResponse, searchResultKey, searchToolName, } from "@digital-science/dimensions-dsl";
-import { z } from "zod";
-import { withFieldAliases } from "../middleware/field-aliases.js";
-import { formatErrorResult, formatToolResult, READ_ONLY_API_ANNOTATIONS, withTruncationWarning, } from "../utils.js";
-import { SEARCH_ENTITY_METADATA } from "./search-entity-metadata.js";
-const metadataBySource = new Map(SEARCH_ENTITY_METADATA.map((meta) => [meta.source, meta]));
-const SHARED_SEARCH_INPUT = {
-    query: z
-        .string()
-        .describe("Search query terms (omit with filters-only search if the API allows)"),
-    limit: z
-        .number()
-        .int()
-        .min(1)
-        .max(1000)
-        .default(100)
-        .describe("Maximum results to return (max 1000)"),
-    fields: z
-        .array(z.string())
-        .optional()
-        .describe("Fields to return. Accepts aliases or DSL names. Use dimensions://fields/{entity} for the full list."),
-    filters: z
-        .array(ExtendedWhereFilterSchema)
-        .optional()
-        .describe("Additional where-clause filters"),
-};
-/**
- * Builds DSL for a structured search from tool arguments.
- * @param source - Dimensions source name
- * @param args - Tool arguments (after field-alias resolution)
- * @returns DSL query string
- */
-export function buildStructuredSearchDsl(client, source, args) {
-    const meta = metadataBySource.get(source);
-    const builder = client.createQueryBuilder().search(source);
-    if (typeof args.query === "string" && args.query.length > 0) {
-        builder.for(args.query);
-    }
-    meta?.applyConvenienceFilters(builder, args);
-    const filters = args.filters;
-    if (filters?.length) {
-        applyFilters(builder, filters);
-    }
-    const fields = args.fields;
-    if (fields?.length) {
-        builder.fields(fields);
-    }
-    if (typeof args.sortBy === "string") {
-        builder.sort(args.sortBy, "desc");
-    }
-    const limit = typeof args.limit === "number" ? args.limit : 100;
-    builder.limit(limit);
-    return builder.build();
-}
-/**
- * Registers structured search tools for sources present in the schema store.
- * @param server - MCP server instance
- * @param client - Dimensions client instance
- * @param schemaStore - Loaded describe schema
- */
-export function registerSearchTools(server, client, schemaStore) {
-    for (const source of schemaStore.structuredEntityTypes()) {
-        const meta = metadataBySource.get(source);
-        if (!meta)
-            continue;
-        const resultKey = searchResultKey(source);
-        const toolName = searchToolName(source);
-        server.registerTool(toolName, {
-            description: meta.description,
-            inputSchema: {
-                ...SHARED_SEARCH_INPUT,
-                ...meta.extraInputSchema,
-            },
-            outputSchema: {
-                totalCount: z.number().describe("Total matching records"),
-                returnedCount: z.number().describe("Records returned in this response"),
-                truncated: z.boolean().optional().describe("True when results are truncated"),
-                truncationWarning: z.string().optional().describe("Warning message when truncated"),
-                [resultKey]: z.array(z.record(z.string(), z.unknown())).describe("Result records"),
-            },
-            annotations: READ_ONLY_API_ANNOTATIONS,
-        }, withFieldAliases({
-            entitySource: { kind: "static", entity: source },
-            fieldArrayArgs: ["fields"],
-            fieldStringArgs: ["sortBy"],
-            filterArrayArgs: ["filters"],
-        }, async (args) => {
-            try {
-                const dsl = buildStructuredSearchDsl(client, source, args);
-                const response = (await client.rawQuery(dsl));
-                const parsed = parseEntityResponse(response, source);
-                const rows = parsed.data;
-                return formatToolResult(withTruncationWarning({
-                    totalCount: parsed.totalCount,
-                    returnedCount: rows.length,
-                    [resultKey]: rows,
-                }, parsed.totalCount, rows.length));
-            }
-            catch (error) {
-                return formatErrorResult(error);
-            }
-        }));
-    }
-}
-//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/solr-fields.d.ts

@@ -1,39 +0,0 @@
-/**
- * Shared SOLR field name constants and entity-to-collection mapping.
- * Field names are derived from the authoritative Python DSL wiring in
- * misc/dim-dsl/dsl/wiring/sources/ — each constant cites its source.
- * @module mcp/tools/solr-fields
- */
-/**
- * SOLR field for `researchers.id` in the publications collection.
- * Source: misc/dim-dsl/dsl/wiring/sources/publications.py:360
- */
-export declare const RESEARCHER_DIM_ID = "researcher_dim_id";
-/**
- * SOLR field for `research_orgs.id` in the publications collection.
- * Source: misc/dim-dsl/dsl/wiring/sources/publications.py:334
- */
-export declare const AFF_ORG_ID = "aff_org_id";
-/**
- * Maps DSL entity type names to their SOLR collection paths.
- *
- * This map bridges two naming conventions that meet in the MCP tools: the
- * DSL/AST `EntityType` is snake_case (`clinical_trials`), while the Solr
- * package's `LogicalCollectionName` is camelCase (`clinicalTrials`).
- * `resolveDefaultCollection` only accepts the camelCase form, so the
- * snake_case-keyed map is the case-conversion layer.
- *
- * Scope: only the six document-corpus entities used by the MCP fan-out tools
- * ({@link concept-profile}, {@link impact-chain}, etc.). `researchers` and
- * `organizations` are intentionally omitted — none of the consumer tools
- * query those collections.
- */
-export declare const ENTITY_COLLECTION_MAP: {
-    readonly publications: string;
-    readonly grants: string;
-    readonly patents: string;
-    readonly clinical_trials: string;
-    readonly policy_documents: string;
-    readonly datasets: string;
-};
-//# sourceMappingURL=solr-fields.d.ts.map

package/dist/tools/solr-fields.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"solr-fields.d.ts","sourceRoot":"","sources":["../../src/tools/solr-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,qBAAqB;;;;;;;CAOxB,CAAC"}

package/dist/tools/solr-fields.js

@@ -1,40 +0,0 @@
-/**
- * Shared SOLR field name constants and entity-to-collection mapping.
- * Field names are derived from the authoritative Python DSL wiring in
- * misc/dim-dsl/dsl/wiring/sources/ — each constant cites its source.
- * @module mcp/tools/solr-fields
- */
-import { resolveDefaultCollection } from "@digital-science/dimensions-solr";
-/**
- * SOLR field for `researchers.id` in the publications collection.
- * Source: misc/dim-dsl/dsl/wiring/sources/publications.py:360
- */
-export const RESEARCHER_DIM_ID = "researcher_dim_id";
-/**
- * SOLR field for `research_orgs.id` in the publications collection.
- * Source: misc/dim-dsl/dsl/wiring/sources/publications.py:334
- */
-export const AFF_ORG_ID = "aff_org_id";
-/**
- * Maps DSL entity type names to their SOLR collection paths.
- *
- * This map bridges two naming conventions that meet in the MCP tools: the
- * DSL/AST `EntityType` is snake_case (`clinical_trials`), while the Solr
- * package's `LogicalCollectionName` is camelCase (`clinicalTrials`).
- * `resolveDefaultCollection` only accepts the camelCase form, so the
- * snake_case-keyed map is the case-conversion layer.
- *
- * Scope: only the six document-corpus entities used by the MCP fan-out tools
- * ({@link concept-profile}, {@link impact-chain}, etc.). `researchers` and
- * `organizations` are intentionally omitted — none of the consumer tools
- * query those collections.
- */
-export const ENTITY_COLLECTION_MAP = {
-    publications: resolveDefaultCollection("publications"),
-    grants: resolveDefaultCollection("grants"),
-    patents: resolveDefaultCollection("patents"),
-    clinical_trials: resolveDefaultCollection("clinicalTrials"),
-    policy_documents: resolveDefaultCollection("policyDocuments"),
-    datasets: resolveDefaultCollection("datasets"),
-};
-//# sourceMappingURL=solr-fields.js.map

package/dist/tools/solr-fields.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"solr-fields.js","sourceRoot":"","sources":["../../src/tools/solr-fields.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEvC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,YAAY,EAAE,wBAAwB,CAAC,cAAc,CAAC;IACtD,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC;IAC1C,OAAO,EAAE,wBAAwB,CAAC,SAAS,CAAC;IAC5C,eAAe,EAAE,wBAAwB,CAAC,gBAAgB,CAAC;IAC3D,gBAAgB,EAAE,wBAAwB,CAAC,iBAAiB,CAAC;IAC7D,QAAQ,EAAE,wBAAwB,CAAC,UAAU,CAAC;CACtC,CAAC"}

package/dist/utils.d.ts

@@ -1,70 +0,0 @@
-/**
- * Utility functions for MCP tools.
- * @module mcp/utils
- */
-import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import type { ToolAnnotations } from "@modelcontextprotocol/sdk/types.js";
-/** Annotations for read-only tools that call external APIs. */
-export declare const READ_ONLY_API_ANNOTATIONS: ToolAnnotations;
-/**
- * Coerces an unknown value to an array of records, returning `[]` if not an array.
- * Replaces unsafe `as Array<Record<string, unknown>>` casts from API responses.
- * @param value - Unknown value from a DSL response property
- * @returns The value as an array of records, or empty array if not an array
- */
-export declare function asArray(value: unknown): Array<Record<string, unknown>>;
-/**
- * MCP tool result format.
- * Includes index signature for MCP SDK compatibility.
- */
-export interface ToolResult {
-    [key: string]: unknown;
-    content: Array<{
-        type: "text";
-        text: string;
-    }>;
-    structuredContent?: Record<string, unknown>;
-    isError?: boolean;
-}
-/**
- * Formats a successful tool result.
- * Populates both `content` (text/JSON) and `structuredContent` for SDK output schema validation.
- * @param data - The data to return
- * @returns Formatted tool result
- */
-export declare function formatToolResult(data: unknown): ToolResult;
-/**
- * Builds a JSON-serializable error payload for MCP tool responses.
- * Surfaces Dimensions API metadata (status codes, client rate-limit hints) when available.
- * @param error - The error that occurred
- * @returns Error payload object
- */
-export declare function formatErrorPayload(error: unknown): Record<string, unknown>;
-/**
- * Formats an error tool result.
- * @param error - The error that occurred
- * @returns Formatted error result
- */
-export declare function formatErrorResult(error: unknown): ToolResult;
-/**
- * Augments a result object with truncation warning when results are incomplete.
- * @param data - The result data object
- * @param totalCount - Total matching records from the API
- * @param returnedCount - Records actually returned
- * @returns The data object, augmented with truncation fields if applicable
- */
-export declare function withTruncationWarning<T extends Record<string, unknown>>(data: T, totalCount: number, returnedCount: number): T & {
-    truncated?: boolean;
-    truncationWarning?: string;
-};
-/** Logging levels supported by the MCP protocol (syslog severity). */
-export type McpLogLevel = "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency";
-/**
- * Sends a structured log message via the MCP protocol with stderr fallback.
- * @param server - MCP server instance
- * @param level - Log severity level
- * @param data - Structured log data (any JSON-serializable value)
- * @param logger - Optional logger namespace (e.g., "search", "schema")
- */
-export declare function mcpLog(server: McpServer, level: McpLogLevel, data: unknown, logger?: string): void;
-//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAE1E,+DAA+D;AAC/D,eAAO,MAAM,yBAAyB,EAAE,eAK9B,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAEtE;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,UAAU,CAU1D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAc1E;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAU5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,GACpB,CAAC,GAAG;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAAE,CASzD;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GACnB,OAAO,GACP,MAAM,GACN,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,GACV,OAAO,GACP,WAAW,CAAC;AAEhB;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAMN"}

package/dist/utils.js

@@ -1,104 +0,0 @@
-/**
- * Utility functions for MCP tools.
- * @module mcp/utils
- */
-import { DimensionsError } from "@digital-science/dimensions-dsl";
-/** Annotations for read-only tools that call external APIs. */
-export const READ_ONLY_API_ANNOTATIONS = {
-    readOnlyHint: true,
-    destructiveHint: false,
-    idempotentHint: true,
-    openWorldHint: true,
-};
-/**
- * Coerces an unknown value to an array of records, returning `[]` if not an array.
- * Replaces unsafe `as Array<Record<string, unknown>>` casts from API responses.
- * @param value - Unknown value from a DSL response property
- * @returns The value as an array of records, or empty array if not an array
- */
-export function asArray(value) {
-    return Array.isArray(value) ? value : [];
-}
-/**
- * Formats a successful tool result.
- * Populates both `content` (text/JSON) and `structuredContent` for SDK output schema validation.
- * @param data - The data to return
- * @returns Formatted tool result
- */
-export function formatToolResult(data) {
-    return {
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify(data, null, 2),
-            },
-        ],
-        structuredContent: data,
-    };
-}
-/**
- * Builds a JSON-serializable error payload for MCP tool responses.
- * Surfaces Dimensions API metadata (status codes, client rate-limit hints) when available.
- * @param error - The error that occurred
- * @returns Error payload object
- */
-export function formatErrorPayload(error) {
-    if (error instanceof DimensionsError) {
-        const json = error.toJSON();
-        return {
-            ...json,
-            error: json.message,
-            type: json.name,
-        };
-    }
-    return {
-        error: error instanceof Error ? error.message : String(error),
-        type: error instanceof Error ? error.name : "Error",
-    };
-}
-/**
- * Formats an error tool result.
- * @param error - The error that occurred
- * @returns Formatted error result
- */
-export function formatErrorResult(error) {
-    return {
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify(formatErrorPayload(error), null, 2),
-            },
-        ],
-        isError: true,
-    };
-}
-/**
- * Augments a result object with truncation warning when results are incomplete.
- * @param data - The result data object
- * @param totalCount - Total matching records from the API
- * @param returnedCount - Records actually returned
- * @returns The data object, augmented with truncation fields if applicable
- */
-export function withTruncationWarning(data, totalCount, returnedCount) {
-    if (totalCount > returnedCount) {
-        return {
-            ...data,
-            truncated: true,
-            truncationWarning: `Only ${returnedCount} of ${totalCount} results returned. Narrow your query with additional filters or use execute_dsl with pagination.`,
-        };
-    }
-    return data;
-}
-/**
- * Sends a structured log message via the MCP protocol with stderr fallback.
- * @param server - MCP server instance
- * @param level - Log severity level
- * @param data - Structured log data (any JSON-serializable value)
- * @param logger - Optional logger namespace (e.g., "search", "schema")
- */
-export function mcpLog(server, level, data, logger) {
-    server.sendLoggingMessage({ level, data, logger }).catch(() => {
-        console.error(`[${level}]${logger ? ` [${logger}]` : ""} ${typeof data === "string" ? data : JSON.stringify(data)}`);
-    });
-}
-//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAIlE,+DAA+D;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAoB;IACxD,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,IAAI;IACpB,aAAa,EAAE,IAAI;CACX,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAwC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/E,CAAC;AAgBD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAa;IAC5C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;aACpC;SACF;QACD,iBAAiB,EAAE,IAA+B;KACnD,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5B,OAAO;YACL,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,OAAO;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7D,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO;KACpD,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;aACzD;SACF;QACD,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAO,EACP,UAAkB,EAClB,aAAqB;IAErB,IAAI,UAAU,GAAG,aAAa,EAAE,CAAC;QAC/B,OAAO;YACL,GAAG,IAAI;YACP,SAAS,EAAE,IAAI;YACf,iBAAiB,EAAE,QAAQ,aAAa,OAAO,UAAU,kGAAkG;SAC5J,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAaD;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACpB,MAAiB,EACjB,KAAkB,EAClB,IAAa,EACb,MAAe;IAEf,MAAM,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAC5D,OAAO,CAAC,KAAK,CACX,IAAI,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}