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

package/dist/dsl/utils/escape.js

@@ -0,0 +1,124 @@
+/**
+ * Escapes a string for safe inclusion in a DSL query.
+ *
+ * Handles backslashes, double quotes (including Unicode smart quotes),
+ * and control characters to prevent DSL injection attacks when
+ * user-supplied strings are interpolated into queries.
+ *
+ * Characters escaped via `\uXXXX` (ANTLR grammar-compatible):
+ * - Null byte and C0 controls (U+0000–U+001F) not covered by named escapes
+ * - DEL and C1 controls (U+007F–U+009F)
+ * - Smart single quotes (U+2018, U+2019)
+ * - Line and paragraph separators (U+2028, U+2029)
+ *
+ * @param text - The string to escape
+ * @returns The escaped string safe for DSL interpolation
+ */
+export function escapeDslString(text) {
+    let result = "";
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        switch (ch) {
+            case "\\":
+                result += "\\\\";
+                break;
+            case '"':
+                result += '\\"';
+                break;
+            case "\u201c":
+                result += "\\\u201c";
+                break;
+            case "\u201d":
+                result += "\\\u201d";
+                break;
+            case "\n":
+                result += "\\n";
+                break;
+            case "\t":
+                result += "\\t";
+                break;
+            case "\r":
+                result += "\\r";
+                break;
+            case "\b":
+                result += "\\b";
+                break;
+            case "\f":
+                result += "\\f";
+                break;
+            default: {
+                const code = ch.charCodeAt(0);
+                if (code <= 0x001f ||
+                    (code >= 0x007f && code <= 0x009f) ||
+                    code === 0x2018 ||
+                    code === 0x2019 ||
+                    code === 0x2028 ||
+                    code === 0x2029) {
+                    result += `\\u${code.toString(16).padStart(4, "0")}`;
+                }
+                else {
+                    result += ch;
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Unescapes DSL string literal content (inverse of {@link escapeDslString} for common sequences).
+ * @param text - Escaped string content without surrounding quotes
+ * @returns Unescaped string
+ */
+export function unescapeDslString(text) {
+    if (!text.includes("\\"))
+        return text;
+    let result = "";
+    for (let i = 0; i < text.length; i++) {
+        if (text[i] === "\\" && i + 1 < text.length) {
+            const next = text[i + 1];
+            switch (next) {
+                case '"':
+                case "\\":
+                case "n":
+                    result += next === "n" ? "\n" : next;
+                    i++;
+                    break;
+                case "t":
+                    result += "\t";
+                    i++;
+                    break;
+                case "r":
+                    result += "\r";
+                    i++;
+                    break;
+                case "b":
+                    result += "\b";
+                    i++;
+                    break;
+                case "f":
+                    result += "\f";
+                    i++;
+                    break;
+                case "u": {
+                    const hex = text.slice(i + 2, i + 6);
+                    if (hex.length === 4 && /^[0-9a-fA-F]{4}$/.test(hex)) {
+                        result += String.fromCharCode(Number.parseInt(hex, 16));
+                        i += 5;
+                    }
+                    else {
+                        result += "\\";
+                    }
+                    break;
+                }
+                default:
+                    result += "\\";
+                    break;
+            }
+        }
+        else {
+            result += text[i];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=escape.js.map

package/dist/dsl/utils/escape.js.map

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

package/dist/dsl/utils/sanitize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Input sanitization for DSL query construction.
+ * @module utils/sanitize
+ */
+/** Maximum allowed length for search text within a `for "..."` clause. */
+export declare const MAX_SEARCH_TEXT_LENGTH = 10000;
+/**
+ * Normalizes user search text before embedding in DSL.
+ * @param text - Raw input text
+ * @returns Sanitized text
+ */
+export declare function sanitizeInput(text: string): string;
+//# sourceMappingURL=sanitize.d.ts.map

package/dist/dsl/utils/sanitize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.d.ts","sourceRoot":"","sources":["../../../src/dsl/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKlD"}

package/dist/dsl/utils/sanitize.js

@@ -0,0 +1,19 @@
+/**
+ * Input sanitization for DSL query construction.
+ * @module utils/sanitize
+ */
+/** Maximum allowed length for search text within a `for "..."` clause. */
+export const MAX_SEARCH_TEXT_LENGTH = 10_000;
+const ZERO_WIDTH_RE = /[\u00AD\u180E\u200B-\u200F\u2028\u2029\uFEFF\u2060-\u2064]/g;
+/**
+ * Normalizes user search text before embedding in DSL.
+ * @param text - Raw input text
+ * @returns Sanitized text
+ */
+export function sanitizeInput(text) {
+    return text
+        .normalize("NFC")
+        .replace(ZERO_WIDTH_RE, "")
+        .replace(/[\u201c\u201d]/g, '"');
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/dsl/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../../src/dsl/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAE7C,MAAM,aAAa,GAAG,6DAA6D,CAAC;AAEpF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,IAAI;SACR,SAAS,CAAC,KAAK,CAAC;SAChB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC"}

package/dist/dsl/utils/string-utils.d.ts

@@ -0,0 +1,35 @@
+/**
+ * String manipulation utilities for DSL quoting and escape sequences.
+ * @module utils/string-utils
+ */
+/**
+ * Strips the first and last character from a quoted string token.
+ * @param text - The raw STRING token text including quotes
+ * @returns The unquoted string content
+ */
+export declare function stripQuotes(text: string): string;
+/**
+ * Strips triple quotes from a LONG_STRING token.
+ * @param text - The raw LONG_STRING token text including triple quotes
+ * @returns The unquoted string content
+ */
+export declare function stripTripleQuotes(text: string): string;
+/**
+ * Processes escape sequences in a DSL string.
+ * @param text - The string content (without outer quotes)
+ * @returns The unescaped string
+ */
+export declare function unescapeString(text: string): string;
+/**
+ * Escapes special characters in a string for DSL output.
+ * @param text - The raw string content
+ * @returns The escaped string (without surrounding quotes)
+ */
+export declare function escapeString(text: string): string;
+/**
+ * Wraps a string in double quotes after escaping special characters.
+ * @param text - The raw string content
+ * @returns The quoted and escaped string
+ */
+export declare function quoteString(text: string): string;
+//# sourceMappingURL=string-utils.d.ts.map

package/dist/dsl/utils/string-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-utils.d.ts","sourceRoot":"","sources":["../../../src/dsl/utils/string-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAuEnD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA+BjD;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/dsl/utils/string-utils.js

@@ -0,0 +1,145 @@
+/**
+ * String manipulation utilities for DSL quoting and escape sequences.
+ * @module utils/string-utils
+ */
+/**
+ * Strips the first and last character from a quoted string token.
+ * @param text - The raw STRING token text including quotes
+ * @returns The unquoted string content
+ */
+export function stripQuotes(text) {
+    return unescapeString(text.slice(1, -1));
+}
+/**
+ * Strips triple quotes from a LONG_STRING token.
+ * @param text - The raw LONG_STRING token text including triple quotes
+ * @returns The unquoted string content
+ */
+export function stripTripleQuotes(text) {
+    return unescapeString(text.slice(3, -3));
+}
+/**
+ * Processes escape sequences in a DSL string.
+ * @param text - The string content (without outer quotes)
+ * @returns The unescaped string
+ */
+export function unescapeString(text) {
+    if (!text.includes("\\"))
+        return text;
+    let result = "";
+    for (let i = 0; i < text.length; i++) {
+        if (text[i] === "\\" && i + 1 < text.length) {
+            const next = text[i + 1];
+            switch (next) {
+                case '"':
+                case "\u201c":
+                case "\u201d":
+                case "\\":
+                case "/":
+                case "^":
+                case "*":
+                case "?":
+                case ":":
+                case "~":
+                case "[":
+                case "]":
+                case "{":
+                case "}":
+                case "(":
+                case ")":
+                case "!":
+                case "|":
+                case "&":
+                case "+":
+                case "-":
+                    result += next;
+                    i++;
+                    break;
+                case "n":
+                    result += "\n";
+                    i++;
+                    break;
+                case "t":
+                    result += "\t";
+                    i++;
+                    break;
+                case "r":
+                    result += "\r";
+                    i++;
+                    break;
+                case "b":
+                    result += "\b";
+                    i++;
+                    break;
+                case "f":
+                    result += "\f";
+                    i++;
+                    break;
+                case "u": {
+                    const hex = text.slice(i + 2, i + 6);
+                    if (hex.length === 4 && /^[0-9a-fA-F]{4}$/.test(hex)) {
+                        result += String.fromCharCode(Number.parseInt(hex, 16));
+                        i += 5;
+                    }
+                    else {
+                        result += "\\";
+                    }
+                    break;
+                }
+                default:
+                    result += "\\";
+                    break;
+            }
+        }
+        else {
+            result += text[i];
+        }
+    }
+    return result;
+}
+/**
+ * Escapes special characters in a string for DSL output.
+ * @param text - The raw string content
+ * @returns The escaped string (without surrounding quotes)
+ */
+export function escapeString(text) {
+    let result = "";
+    for (let i = 0; i < text.length; i++) {
+        const ch = text[i];
+        switch (ch) {
+            case "\\":
+                result += "\\\\";
+                break;
+            case '"':
+                result += '\\"';
+                break;
+            case "\n":
+                result += "\\n";
+                break;
+            case "\t":
+                result += "\\t";
+                break;
+            case "\r":
+                result += "\\r";
+                break;
+            case "\b":
+                result += "\\b";
+                break;
+            case "\f":
+                result += "\\f";
+                break;
+            default:
+                result += ch;
+        }
+    }
+    return result;
+}
+/**
+ * Wraps a string in double quotes after escaping special characters.
+ * @param text - The raw string content
+ * @returns The quoted and escaped string
+ */
+export function quoteString(text) {
+    return `"${escapeString(text)}"`;
+}
+//# sourceMappingURL=string-utils.js.map

package/dist/dsl/utils/string-utils.js.map

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

package/dist/dsl/utils/validate-field-name.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Validates a DSL field name to prevent injection via field interpolation.
+ * Valid names start with a letter or underscore and contain only letters,
+ * digits, underscores, and dots (for nested fields like `authors.first_name`).
+ *
+ * @param field - The field name to validate
+ * @returns void
+ * @throws {ValidationError} If the field name contains invalid characters
+ */
+export declare function validateFieldName(field: string): void;
+//# sourceMappingURL=validate-field-name.d.ts.map

package/dist/dsl/utils/validate-field-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-field-name.d.ts","sourceRoot":"","sources":["../../../src/dsl/utils/validate-field-name.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIrD"}

package/dist/dsl/utils/validate-field-name.js

@@ -0,0 +1,18 @@
+import { ValidationError } from "../../client/index.js";
+/** Regex for valid DSL field names: letters, digits, underscores, dots. */
+const FIELD_NAME_RE = /^[a-z_][a-z0-9_.]*$/i;
+/**
+ * Validates a DSL field name to prevent injection via field interpolation.
+ * Valid names start with a letter or underscore and contain only letters,
+ * digits, underscores, and dots (for nested fields like `authors.first_name`).
+ *
+ * @param field - The field name to validate
+ * @returns void
+ * @throws {ValidationError} If the field name contains invalid characters
+ */
+export function validateFieldName(field) {
+    if (!FIELD_NAME_RE.test(field)) {
+        throw new ValidationError(`Invalid field name: ${field}`);
+    }
+}
+//# sourceMappingURL=validate-field-name.js.map

package/dist/dsl/utils/validate-field-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-field-name.js","sourceRoot":"","sources":["../../../src/dsl/utils/validate-field-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,2EAA2E;AAC3E,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,eAAe,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IAC5D,CAAC;AACH,CAAC"}

package/dist/examples/dsl-examples.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Curated DSL examples for MCP resources (from public Dimensions DSL documentation patterns).
+ * @module examples/dsl-examples
+ */
+/** Example queries keyed by entity type. */
+export declare const DSL_EXAMPLES_BY_ENTITY: Record<string, readonly string[]>;
+/** General DSL patterns (describe, functions, pagination). */
+export declare const DSL_GENERAL_EXAMPLES: readonly ["describe version", "describe schema", "describe source publications", "extract_concepts(text: \"CRISPR gene editing enables precise DNA modification\")", "classify(text: \"Stem cell therapy for diabetes\", system: \"for\")"];
+/** Link to official DSL documentation. */
+export declare const DSL_DOCUMENTATION_URL = "https://docs.dimensions.ai/dsl/";
+//# sourceMappingURL=dsl-examples.d.ts.map

package/dist/examples/dsl-examples.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-examples.d.ts","sourceRoot":"","sources":["../../src/examples/dsl-examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4CAA4C;AAC5C,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAgCpE,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,6OAMvB,CAAC;AAEX,0CAA0C;AAC1C,eAAO,MAAM,qBAAqB,oCAAoC,CAAC"}

package/dist/examples/dsl-examples.js

@@ -0,0 +1,49 @@
+/**
+ * Curated DSL examples for MCP resources (from public Dimensions DSL documentation patterns).
+ * @module examples/dsl-examples
+ */
+/** Example queries keyed by entity type. */
+export const DSL_EXAMPLES_BY_ENTITY = {
+    publications: [
+        'search publications for "machine learning" return publications[id+title+doi] limit 10',
+        'search publications for "CRISPR" where year >= 2020 return publications[id+title+times_cited+year] sort by times_cited desc limit 25',
+        'search publications in title_only for "gene therapy" return publications[basics] limit 10',
+        "search publications return publications facet journal limit 20",
+    ],
+    grants: [
+        'search grants for "cancer immunotherapy" return grants limit 10',
+        'search grants where funder_org_name = "National Institutes of Health" return grants[basics] limit 10',
+        "search grants return grants aggregate funding_usd",
+    ],
+    patents: [
+        'search patents for "lithium battery" return patents limit 10',
+        "search patents where year >= 2018 return patents[id+title] limit 20",
+    ],
+    clinical_trials: [
+        'search clinical_trials for "diabetes" return clinical_trials limit 10',
+        'search clinical_trials where phase = "Phase 3" return clinical_trials limit 10',
+    ],
+    datasets: ['search datasets for "climate model" return datasets limit 10'],
+    policy_documents: [
+        'search policy_documents for "renewable energy" return policy_documents limit 10',
+    ],
+    researchers: [
+        'search researchers where last_name = "Smith" return researchers limit 10',
+        "search researchers where total_publications > 100 return researchers limit 10",
+    ],
+    organizations: [
+        'search organizations for "Stanford" return organizations limit 10',
+        'search organizations where country = "United States" return organizations limit 10',
+    ],
+};
+/** General DSL patterns (describe, functions, pagination). */
+export const DSL_GENERAL_EXAMPLES = [
+    "describe version",
+    "describe schema",
+    "describe source publications",
+    'extract_concepts(text: "CRISPR gene editing enables precise DNA modification")',
+    'classify(text: "Stem cell therapy for diabetes", system: "for")',
+];
+/** Link to official DSL documentation. */
+export const DSL_DOCUMENTATION_URL = "https://docs.dimensions.ai/dsl/";
+//# sourceMappingURL=dsl-examples.js.map

package/dist/examples/dsl-examples.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl-examples.js","sourceRoot":"","sources":["../../src/examples/dsl-examples.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,4CAA4C;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAsC;IACvE,YAAY,EAAE;QACZ,uFAAuF;QACvF,sIAAsI;QACtI,2FAA2F;QAC3F,gEAAgE;KACjE;IACD,MAAM,EAAE;QACN,iEAAiE;QACjE,sGAAsG;QACtG,mDAAmD;KACpD;IACD,OAAO,EAAE;QACP,8DAA8D;QAC9D,qEAAqE;KACtE;IACD,eAAe,EAAE;QACf,uEAAuE;QACvE,gFAAgF;KACjF;IACD,QAAQ,EAAE,CAAC,8DAA8D,CAAC;IAC1E,gBAAgB,EAAE;QAChB,iFAAiF;KAClF;IACD,WAAW,EAAE;QACX,0EAA0E;QAC1E,+EAA+E;KAChF;IACD,aAAa,EAAE;QACb,mEAAmE;QACnE,oFAAoF;KACrF;CACF,CAAC;AAEF,8DAA8D;AAC9D,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,kBAAkB;IAClB,iBAAiB;IACjB,8BAA8B;IAC9B,gFAAgF;IAChF,iEAAiE;CACzD,CAAC;AAEX,0CAA0C;AAC1C,MAAM,CAAC,MAAM,qBAAqB,GAAG,iCAAiC,CAAC"}

package/dist/examples/usage-scenarios.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Tool routing for natural-language prompts in docs/USAGE.md.
+ * @module examples/usage-scenarios
+ */
+export interface UsageScenario {
+    /** Stable id for tests */
+    id: string;
+    /** Short goal label (matches USAGE table) */
+    goal: string;
+    /** Example user prompt */
+    prompt: string;
+    /** Structured MCP tool agents should call */
+    tool: string;
+    /** Tool arguments (validated in usage-scenarios.test.ts) */
+    args: Record<string, unknown>;
+    /** Substrings expected in DSL passed to rawQuery (when applicable) */
+    dslContains?: string[];
+    /** Substrings expected in build_query DSL output */
+    buildDslContains?: string[];
+}
+export declare const USAGE_SCENARIOS: readonly UsageScenario[];
+//# sourceMappingURL=usage-scenarios.d.ts.map

package/dist/examples/usage-scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-scenarios.d.ts","sourceRoot":"","sources":["../../src/examples/usage-scenarios.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,oDAAoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAwK1C,CAAC"}