@jupiterone/jupiterone-mcp 0.0.3 → 0.0.6

package/dist/utils/j1ql-validator.js

@@ -0,0 +1,292 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.J1QLValidator = void 0;
+class J1QLValidator {
+    j1qlService;
+    constructor(j1qlService) {
+        this.j1qlService = j1qlService;
+    }
+    /**
+     * Validates a J1QL query by executing it with a small limit
+     * Returns validation result with error details and suggestions
+     */
+    async validateQuery(query) {
+        try {
+            // Add a small limit if not present to avoid large result sets during validation
+            let validationQuery = query.trim();
+            if (!validationQuery.match(/\bLIMIT\s+\d+/i)) {
+                validationQuery += ' LIMIT 5';
+            }
+            const result = await this.j1qlService.executeJ1qlQuery({
+                query: validationQuery,
+            });
+            // Check if we got valid results
+            if (result && result.data) {
+                return {
+                    isValid: true,
+                    results: result,
+                };
+            }
+            return {
+                isValid: false,
+                error: 'Query returned no data',
+                suggestion: 'Verify that entities matching your criteria exist. Try removing filters or using broader entity classes.',
+            };
+        }
+        catch (error) {
+            return this.handleQueryError(error, query);
+        }
+    }
+    /**
+     * Provides detailed error handling with suggestions
+     */
+    handleQueryError(error, query) {
+        const errorMessage = error?.message || error?.toString() || 'Unknown error';
+        // Check specific error patterns first
+        for (const { pattern, suggestion } of this.getErrorPatterns()) {
+            const match = errorMessage.match(pattern);
+            if (match) {
+                const suggestionText = typeof suggestion === 'function'
+                    ? suggestion(match)
+                    : suggestion === 'syntax_analysis'
+                        ? this.analyzeSyntaxError(query, errorMessage)
+                        : suggestion;
+                return {
+                    isValid: false,
+                    error: errorMessage,
+                    suggestion: suggestionText,
+                };
+            }
+        }
+        return {
+            isValid: false,
+            error: errorMessage,
+            suggestion: this.getGenericSuggestions(query),
+        };
+    }
+    /**
+     * Consolidated error patterns for better maintainability
+     */
+    getErrorPatterns() {
+        return [
+            // New queryV2 error patterns
+            {
+                pattern: /Error parsing query\. Unexpected token "(\w+)" at line \d+ column \d+/i,
+                suggestion: (match) => {
+                    const token = match[1].toLowerCase();
+                    // Check for reserved keywords used as aliases
+                    const reservedKeywords = [
+                        'count',
+                        'sum',
+                        'avg',
+                        'min',
+                        'max',
+                        'find',
+                        'that',
+                        'with',
+                        'where',
+                        'return',
+                        'order',
+                        'by',
+                        'limit',
+                        'skip',
+                        'has',
+                        'relates',
+                        'to',
+                        'from',
+                        'and',
+                        'or',
+                        'not',
+                        'true',
+                        'false',
+                        'null',
+                        'undefined',
+                        'as',
+                    ];
+                    if (reservedKeywords.includes(token)) {
+                        return `Cannot use reserved keyword "${token}" as an alias. Choose a different name.`;
+                    }
+                    // Check for unquoted string values
+                    if (match[0].includes('WITH') && match[0].includes('=')) {
+                        return `String values must be quoted: ${token} should be '${token}'`;
+                    }
+                    return 'syntax_analysis'; // Fall back to syntax analysis
+                },
+            },
+            {
+                pattern: /Error parsing query\. Unexpected token "(>>|<<)" at line \d+ column \d+/i,
+                suggestion: 'Direction arrows must follow the relationship verb: "THAT HAS >>" not "THAT >>"',
+            },
+            {
+                pattern: /Error parsing query\. Unexpected token ">" at line \d+ column \d+.*=>/i,
+                suggestion: 'Invalid operator "=>". Use ">=" for greater than or equal',
+            },
+            {
+                pattern: /Error parsing query\. Unexpected token "-" at line \d+ column \d+.*LIMIT/i,
+                suggestion: 'SKIP and LIMIT values must be positive numbers',
+            },
+            {
+                pattern: /Error parsing query\. Unexpected token "WITH" at line \d+ column \d+\. Did you mean "with"\?/i,
+                suggestion: 'Place alias after WITH: "WITH property = value AS alias"',
+            },
+            // Existing patterns that still work with queryV2
+            {
+                pattern: /Invalid return selector provided: "(\w+)", valid return selectors are: "([^"]+)"/i,
+                suggestion: (match) => `Undefined alias "${match[1]}". Use "${match[2]}" or define alias: FIND ${match[2]} AS ${match[1]}`,
+            },
+            {
+                pattern: /Invalid predicate filter selector provided: "(\w+)", valid predicate selectors are: "([^"]+)"/i,
+                suggestion: (match) => `Undefined alias "${match[1]}" in WHERE clause. Aliases in WHERE must be defined earlier. Valid selectors: ${match[2]}`,
+            },
+            {
+                pattern: /"limit" must be a value between \d+ and \d+/i,
+                suggestion: 'LIMIT must be between 1 and 250. Try using COUNT for aggregation queries.',
+            },
+            // Legacy patterns (keeping for backward compatibility)
+            {
+                pattern: /J1QL Query is invalid\. Please check the syntax/i,
+                suggestion: 'syntax_analysis', // Special marker for syntax analysis
+            },
+            {
+                pattern: /exceeds maximum allowed tokens/i,
+                suggestion: 'Query returned too much data. Add LIMIT clause to reduce result size (e.g., LIMIT 100)',
+            },
+            {
+                pattern: /Invalid entity type or class/i,
+                suggestion: 'Check entity class capitalization (e.g., User not user) and type format (e.g., aws_iam_user).',
+            },
+            {
+                pattern: /Unknown property/i,
+                suggestion: 'Property does not exist. Run discovery: FIND <EntityClass> AS e RETURN e.* LIMIT 10',
+            },
+            {
+                pattern: /Invalid comparison operator/i,
+                suggestion: 'Use valid operators: =, !=, ~=, ^=, $=, !~=, !^=, !$=, >, <, >=, <=',
+            },
+            {
+                pattern: /timeout|timed out/i,
+                suggestion: 'Query took too long. Add LIMIT clause or simplify the query.',
+            },
+        ];
+    }
+    /**
+     * Analyzes generic "J1QL Query is invalid" errors for specific issues
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars, no-unused-vars
+    analyzeSyntaxError(query, _errorMessage) {
+        const syntaxChecks = [
+            {
+                pattern: /"/,
+                message: 'Use single quotes for strings, not double quotes',
+            },
+            {
+                pattern: /=\s*([a-zA-Z]+)(?:\s|$)/,
+                message: (match) => {
+                    const value = match[1];
+                    if (!['true', 'false', 'null', 'undefined'].includes(value)) {
+                        return `String values must be quoted: ${value} should be '${value}'`;
+                    }
+                    return null;
+                },
+            },
+            {
+                pattern: /\bAS\s+\w+\s+WITH\b/i,
+                message: 'Place alias after WITH: "WITH property = value AS alias"',
+            },
+            {
+                pattern: /\bWHERE\b/i,
+                message: query.match(/\bAS\s+\w+.*WHERE/i)
+                    ? null
+                    : 'WHERE clause requires aliases. Use "FIND Entity AS e WHERE e.property = value"',
+            },
+            {
+                pattern: /=>/,
+                message: 'Invalid operator "=>". Use ">=" for greater than or equal',
+            },
+            {
+                pattern: /THAT\s*>>/i,
+                message: 'Direction arrows must follow the relationship verb: "THAT HAS >>" not "THAT >>"',
+            },
+            {
+                pattern: /FIND\s+([a-z]\w*)/,
+                message: (match) => {
+                    const entityClass = match[1];
+                    if (!entityClass.includes('_')) {
+                        return `Entity classes should be capitalized: "${entityClass}" should be "${entityClass.charAt(0).toUpperCase() + entityClass.slice(1)}"`;
+                    }
+                    return null;
+                },
+            },
+            {
+                pattern: /=\s*(yes|no|YES|NO)\b/,
+                message: 'Use "true" or "false" for boolean values, not "yes"/"no"',
+            },
+            {
+                pattern: /^(?!.*\bLIMIT\s+\d+)(?!.*\bCOUNT\s*\()/i,
+                message: query.match(/\bLIMIT\s+\d+/i) || query.match(/\bCOUNT\s*\(/i)
+                    ? null
+                    : 'Add LIMIT clause to prevent query timeout',
+            },
+            {
+                pattern: /=\s*\/[^/]*$/,
+                message: 'Invalid regex pattern - missing closing slash',
+            },
+            {
+                pattern: /\b(SKIP|LIMIT)\s+-\d+/i,
+                message: 'SKIP and LIMIT values must be positive numbers',
+            },
+            {
+                pattern: /\bLIMIT\s+0\b/i,
+                message: 'LIMIT must be at least 1',
+            },
+            {
+                pattern: /\bAS\s+(count|sum|avg|min|max|find|that|with|where|return|order|by|limit|skip|has|relates|to|from|and|or|not|true|false|null|undefined|as)\b/i,
+                message: (match) => {
+                    const keyword = match[1];
+                    return `Cannot use reserved keyword "${keyword}" as an alias. Choose a different name.`;
+                },
+            },
+        ];
+        const issues = syntaxChecks
+            .map((check) => {
+            const match = query.match(check.pattern);
+            if (match) {
+                return typeof check.message === 'function' ? check.message(match) : check.message;
+            }
+            return null;
+        })
+            .filter(Boolean);
+        return issues.length > 0 ? issues.join('\n') : this.getGenericSuggestions(query);
+    }
+    /**
+     * Provides generic suggestions based on query structure
+     */
+    getGenericSuggestions(query) {
+        const commonIssues = [
+            {
+                check: () => !query.match(/\bLIMIT\s+\d+/i) && !query.match(/\bCOUNT\s*\(/i),
+                message: 'Add LIMIT clause to prevent large result sets',
+            },
+            {
+                check: () => query.match(/\bWHERE\b/i) && !query.match(/\bAS\s+\w+.*WHERE/i),
+                message: 'WHERE clause requires aliases. Use "FIND Entity AS e WHERE e.property = value"',
+            },
+            {
+                check: () => query.includes('"'),
+                message: 'Use single quotes for strings, not double quotes',
+            },
+            {
+                check: () => query.match(/\bAS\s+\w+\s+WITH\b/i),
+                message: 'Place alias after WITH: "WITH property = value AS alias"',
+            },
+            { check: () => !query.match(/\b(FIND|find)\b/), message: 'Query must start with FIND' },
+        ];
+        const suggestions = commonIssues.filter((issue) => issue.check()).map((issue) => issue.message);
+        if (suggestions.length === 0) {
+            suggestions.push('Try these discovery queries first:', '1. FIND * AS e RETURN e._class, COUNT(e) - to see available entity classes', '2. FIND <EntityClass> AS e RETURN e.* LIMIT 10 - to see entity properties', '3. FIND Entity1 THAT RELATES TO AS rel Entity2 RETURN rel._class - to discover relationships');
+        }
+        return suggestions.join('\n');
+    }
+}
+exports.J1QLValidator = J1QLValidator;
+//# sourceMappingURL=j1ql-validator.js.map

package/dist/utils/j1ql-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"j1ql-validator.js","sourceRoot":"","sources":["../../src/utils/j1ql-validator.ts"],"names":[],"mappings":";;;AASA,MAAa,aAAa;IACJ;IAApB,YAAoB,WAAwB;QAAxB,gBAAW,GAAX,WAAW,CAAa;IAAG,CAAC;IAEhD;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,KAAa;QAC/B,IAAI,CAAC;YACH,gFAAgF;YAChF,IAAI,eAAe,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC7C,eAAe,IAAI,UAAU,CAAC;YAChC,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC;gBACrD,KAAK,EAAE,eAAe;aACvB,CAAC,CAAC;YAEH,gCAAgC;YAChC,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC1B,OAAO;oBACL,OAAO,EAAE,IAAI;oBACb,OAAO,EAAE,MAAM;iBAChB,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,wBAAwB;gBAC/B,UAAU,EACR,0GAA0G;aAC7G,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAED;;OAEG;IACI,gBAAgB,CAAC,KAAU,EAAE,KAAa;QAC/C,MAAM,YAAY,GAAG,KAAK,EAAE,OAAO,IAAI,KAAK,EAAE,QAAQ,EAAE,IAAI,eAAe,CAAC;QAE5E,sCAAsC;QACtC,KAAK,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,cAAc,GAClB,OAAO,UAAU,KAAK,UAAU;oBAC9B,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC;oBACnB,CAAC,CAAC,UAAU,KAAK,iBAAiB;wBAChC,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,YAAY,CAAC;wBAC9C,CAAC,CAAC,UAAU,CAAC;gBAEnB,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,YAAY;oBACnB,UAAU,EAAE,cAAwB;iBACrC,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC;SAC9C,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,gBAAgB;QACtB,OAAO;YACL,6BAA6B;YAC7B;gBACE,OAAO,EAAE,wEAAwE;gBACjF,UAAU,EAAE,CAAC,KAAuB,EAAE,EAAE;oBACtC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;oBACrC,8CAA8C;oBAC9C,MAAM,gBAAgB,GAAG;wBACvB,OAAO;wBACP,KAAK;wBACL,KAAK;wBACL,KAAK;wBACL,KAAK;wBACL,MAAM;wBACN,MAAM;wBACN,MAAM;wBACN,OAAO;wBACP,QAAQ;wBACR,OAAO;wBACP,IAAI;wBACJ,OAAO;wBACP,MAAM;wBACN,KAAK;wBACL,SAAS;wBACT,IAAI;wBACJ,MAAM;wBACN,KAAK;wBACL,IAAI;wBACJ,KAAK;wBACL,MAAM;wBACN,OAAO;wBACP,MAAM;wBACN,WAAW;wBACX,IAAI;qBACL,CAAC;oBACF,IAAI,gBAAgB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBACrC,OAAO,gCAAgC,KAAK,yCAAyC,CAAC;oBACxF,CAAC;oBACD,mCAAmC;oBACnC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBACxD,OAAO,iCAAiC,KAAK,eAAe,KAAK,GAAG,CAAC;oBACvE,CAAC;oBACD,OAAO,iBAAiB,CAAC,CAAC,+BAA+B;gBAC3D,CAAC;aACF;YACD;gBACE,OAAO,EAAE,0EAA0E;gBACnF,UAAU,EACR,iFAAiF;aACpF;YACD;gBACE,OAAO,EAAE,wEAAwE;gBACjF,UAAU,EAAE,2DAA2D;aACxE;YACD;gBACE,OAAO,EAAE,2EAA2E;gBACpF,UAAU,EAAE,gDAAgD;aAC7D;YACD;gBACE,OAAO,EACL,+FAA+F;gBACjG,UAAU,EAAE,0DAA0D;aACvE;YACD,iDAAiD;YACjD;gBACE,OAAO,EACL,mFAAmF;gBACrF,UAAU,EAAE,CAAC,KAAuB,EAAE,EAAE,CACtC,oBAAoB,KAAK,CAAC,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,CAAC,2BAA2B,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,EAAE;aACtG;YACD;gBACE,OAAO,EACL,gGAAgG;gBAClG,UAAU,EAAE,CAAC,KAAuB,EAAE,EAAE,CACtC,oBAAoB,KAAK,CAAC,CAAC,CAAC,iFAAiF,KAAK,CAAC,CAAC,CAAC,EAAE;aAC1H;YACD;gBACE,OAAO,EAAE,8CAA8C;gBACvD,UAAU,EAAE,2EAA2E;aACxF;YACD,uDAAuD;YACvD;gBACE,OAAO,EAAE,kDAAkD;gBAC3D,UAAU,EAAE,iBAAiB,EAAE,qCAAqC;aACrE;YACD;gBACE,OAAO,EAAE,iCAAiC;gBAC1C,UAAU,EACR,wFAAwF;aAC3F;YACD;gBACE,OAAO,EAAE,+BAA+B;gBACxC,UAAU,EACR,+FAA+F;aAClG;YACD;gBACE,OAAO,EAAE,mBAAmB;gBAC5B,UAAU,EACR,qFAAqF;aACxF;YACD;gBACE,OAAO,EAAE,8BAA8B;gBACvC,UAAU,EAAE,qEAAqE;aAClF;YACD;gBACE,OAAO,EAAE,oBAAoB;gBAC7B,UAAU,EAAE,8DAA8D;aAC3E;SACF,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,6EAA6E;IACtE,kBAAkB,CAAC,KAAa,EAAE,aAAqB;QAC5D,MAAM,YAAY,GAAG;YACnB;gBACE,OAAO,EAAE,GAAG;gBACZ,OAAO,EAAE,kDAAkD;aAC5D;YACD;gBACE,OAAO,EAAE,yBAAyB;gBAClC,OAAO,EAAE,CAAC,KAAuB,EAAE,EAAE;oBACnC,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACvB,IAAI,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;wBAC5D,OAAO,iCAAiC,KAAK,eAAe,KAAK,GAAG,CAAC;oBACvE,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF;YACD;gBACE,OAAO,EAAE,sBAAsB;gBAC/B,OAAO,EAAE,0DAA0D;aACpE;YACD;gBACE,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC;oBACxC,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,gFAAgF;aACrF;YACD;gBACE,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,2DAA2D;aACrE;YACD;gBACE,OAAO,EAAE,YAAY;gBACrB,OAAO,EAAE,iFAAiF;aAC3F;YACD;gBACE,OAAO,EAAE,mBAAmB;gBAC5B,OAAO,EAAE,CAAC,KAAuB,EAAE,EAAE;oBACnC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC7B,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;wBAC/B,OAAO,0CAA0C,WAAW,gBAAgB,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;oBAC5I,CAAC;oBACD,OAAO,IAAI,CAAC;gBACd,CAAC;aACF;YACD;gBACE,OAAO,EAAE,uBAAuB;gBAChC,OAAO,EAAE,0DAA0D;aACpE;YACD;gBACE,OAAO,EAAE,yCAAyC;gBAClD,OAAO,EACL,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC;oBAC3D,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,2CAA2C;aAClD;YACD;gBACE,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,+CAA+C;aACzD;YACD;gBACE,OAAO,EAAE,wBAAwB;gBACjC,OAAO,EAAE,gDAAgD;aAC1D;YACD;gBACE,OAAO,EAAE,gBAAgB;gBACzB,OAAO,EAAE,0BAA0B;aACpC;YACD;gBACE,OAAO,EACL,+IAA+I;gBACjJ,OAAO,EAAE,CAAC,KAAuB,EAAE,EAAE;oBACnC,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;oBACzB,OAAO,gCAAgC,OAAO,yCAAyC,CAAC;gBAC1F,CAAC;aACF;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,YAAY;aACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACzC,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;YACpF,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;aACD,MAAM,CAAC,OAAO,CAAa,CAAC;QAE/B,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;IACnF,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,KAAa;QACzC,MAAM,YAAY,GAAG;YACnB;gBACE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC;gBAC5E,OAAO,EAAE,+CAA+C;aACzD;YACD;gBACE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,oBAAoB,CAAC;gBAC5E,OAAO,EAAE,gFAAgF;aAC1F;YACD;gBACE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAChC,OAAO,EAAE,kDAAkD;aAC5D;YACD;gBACE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC;gBAChD,OAAO,EAAE,0DAA0D;aACpE;YACD,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,EAAE,OAAO,EAAE,4BAA4B,EAAE;SACxF,CAAC;QAEF,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEhG,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,WAAW,CAAC,IAAI,CACd,oCAAoC,EACpC,4EAA4E,EAC5E,2EAA2E,EAC3E,8FAA8F,CAC/F,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AA5TD,sCA4TC"}

package/dist/utils/load-description.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"load-description.d.ts","sourceRoot":"","sources":["../../src/utils/load-description.ts"],"names":[],"mappings":"AAMA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGxD"}
+{"version":3,"file":"load-description.d.ts","sourceRoot":"","sources":["../../src/utils/load-description.ts"],"names":[],"mappings":"AAGA,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAExD"}

package/dist/utils/load-description.js

@@ -1,9 +1,9 @@
-import { readFileSync } from 'fs';
-import { join } from 'path';
-import { fileURLToPath } from 'url';
-const __dirname = fileURLToPath(new URL('.', import.meta.url));
-export function loadDescription(filename) {
-    const filePath = join(__dirname, '..', 'descriptions', filename);
-    return readFileSync(filePath, 'utf-8');
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDescription = loadDescription;
+// src/utils/load-description.ts
+const description_map_js_1 = require("../generated/description-map.js");
+function loadDescription(filename) {
+    return description_map_js_1.descriptionMap[filename] ?? '';
 }
 //# sourceMappingURL=load-description.js.map

package/dist/utils/load-description.js.map

@@ -1 +1 @@
-{"version":3,"file":"load-description.js","sourceRoot":"","sources":["../../src/utils/load-description.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC;IACjE,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"load-description.js","sourceRoot":"","sources":["../../src/utils/load-description.ts"],"names":[],"mappings":";;AAGA,0CAEC;AALD,gCAAgC;AAChC,wEAAiE;AAEjE,SAAgB,eAAe,CAAC,QAAgB;IAC9C,OAAO,mCAAc,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@jupiterone/jupiterone-mcp",
-  "version": "0.0.3",
+  "version": "0.0.6",
   "description": "Model Context Protocol server for JupiterOne account rules and rule details",
-  "type": "module",
   "main": "dist/index.js",
   "bin": {
     "jupiterone-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc && npm run copy-descriptions",
-    "copy-descriptions": "cp -r src/descriptions dist/",
-    "dev": "npm run build && npx nodemon --watch src --ext ts --exec 'npm run build && npx dotenv -e .env -- npx @modelcontextprotocol/inspector node dist/index.js'",
+    "prebuild": "npx tsx scripts/generate-descriptions.ts",
+    "build": "npm run prebuild && tsc",
+    "dev": "npm run build && npx nodemon --watch src --ext ts --ignore src/generated --exec 'npm run build'",
+    "inspector": "npx dotenv -e .env -- npx @modelcontextprotocol/inspector node dist/index.js",
     "start": "node dist/index.js",
     "test": "jest",
     "test-connection": "node test-connection.js",

package/dist/descriptions/create-dashboard-widget.md

@@ -1,325 +0,0 @@
-# JupiterOne Create Dashboard Widget Tool
-
-**Purpose**: Adds a new widget to a specified JupiterOne dashboard. This tool allows you to programmatically create visual widgets (such as pie charts, bar charts, tables, etc.) on any dashboard, using custom queries and configuration.
-
-This tool should be used when:
-- You want to add a new visualization to an existing dashboard
-- You need to automate dashboard widget creation for reporting or monitoring
-- You want to programmatically manage dashboard content
-
-## Required Parameters
-- `dashboardId`: The ID of the dashboard to add the widget to
-- `input`: The widget configuration object (CreateInsightsWidgetInput), including:
-  - `title`: Widget title
-  - `description`: Widget description (optional)
-  - `type`: Widget type (e.g., 'pie', 'bar', 'table', etc.)
-  - `noResultMessage`: Message to display when there are no results
-  - `config`: Widget configuration, including queries and settings
-
-## Supported Chart Types
-
-The following values are supported for the `type` property when creating a widget:
-
-```typescript
-export enum ChartType {
-  Area = 'area',
-  Bar = 'bar',
-  Graph = 'graph',
-  Line = 'line',
-  Matrix = 'matrix',
-  Number = 'number',
-  Pie = 'pie',
-  Table = 'table',
-  Status = 'status',
-  Markdown = 'markdown',
-}
-```
-
-## Example Usage
-```json
-{
-  "dashboardId": "95936c1a-468a-494f-b11d-b134ac9b9577",
-  "input": {
-    "title": "Example title",
-    "type": "pie",
-    "noResultMessage": "Message that shows when no results",
-    "config": {
-      "queries": [
-        {
-          "query": "FIND (aws_db_cluster_snapshot|aws_db_snapshot) as snapshot\n  RETURN\n    snapshot.tag.AccountName as name,\n    sum(snapshot.allocatedStorage) * 0.02 as value",
-          "name": "Query 1"
-        }
-      ],
-      "settings": {
-        "pie": {
-          "customColors": {
-            "0": "#26A69A",
-            "1": "#3F51B5",
-            "2": "#D81B60",
-            "3": "#FF8F00",
-            "4": "#9575CD",
-            "5": "#8BC34A",
-            "6": "#039BE5"
-          },
-          "upwardTrendIsGood": true
-        }
-      }
-    }
-  }
-}
-```
-
-# Widget Options
-
-When creating a dashboard, there are several options for widgets to choose from. This allows you to utilize the most impactful visual representation for your data. Below are the supported dashboard widgets, each with their own requirements and examples.
-
----
-
-# Chart Types and Example Queries
-
-> **Note:**
-> To enable trend functionality for a chart, set `trendDataIsEnabled: true` in the relevant chart type's settings (e.g., `settings.pie.trendDataIsEnabled`). You can also use keys like `trendQueryResultsCount` to control the number of trend data points, and `upwardTrendIsGood` to indicate if an upward trend is positive.
-
-## Number
-The number chart visualization shows one large stat value. In the trend version of this chart you are able to track the value through a spark line to see if the result is getting larger or smaller over time.
-
-### Query Requirements
-Expects only a single `value` in the returned query response.
-
-### Example Queries
-**Trend:**
-```j1ql
-FIND User AS u
-  RETURN count(u) AS value
-```
-**Non-Trend:**
-```j1ql
-FIND User AS u
-  RETURN count(u) AS value
-```
-
----
-
-## Pie Chart
-The pie chart displays values from one or more queries, as they relate to each other, in the form of slices of a pie. The arc length, area and central angle of a slice are all proportional to the slice's value, as it relates to the sum of all values. This type of chart is best used when you want a quick comparison of a small set of values in an aesthetically pleasing form. In the trend version of this chart you are able to track the value change of each slice value as well as the total value through a spark line to see if the data set is getting larger or smaller over time.
-
-### Query Requirements
-Expects 2 or more pairs of `name` and numeric `value` properties.
-
-### Example Queries
-**Trend:**
-```j1ql
-FIND DataStore AS ds
-  THAT RELATES TO (Account|Service) AS a
-RETURN
-  a.tag.AccountName AS name,
-  count(ds) AS value
-```
-**Non-Trend 1:**
-```j1ql
-FIND DataStore AS ds
-  THAT RELATES TO (Account|Service) AS a
-RETURN
-  a.tag.AccountName AS name,
-  count(ds) AS value
-```
-**Non-Trend 2:**
-```j1ql
-FIND DataStore AS ds
-  THAT RELATES TO (Account|Service) AS a
-RETURN
-  count(ds) AS value
-```
-
----
-
-## Bar Chart
-The bar chart visualization allows you to view categorical data to analyze your queries with a specified x and y axis. You are able to run multiple queries and visualize the bar chart in stacked format. This chart is best suited for categorizing your results. In the trend version of the chart you are able to visualize the value change of each categorical result through a %Change indicator and a reference category bar of the result value from the previous time period selected.
-
-### Query Requirements
-Expects one or more `x` and `y` values.
-
-### Example Queries
-**Trend:**
-```j1ql
-FIND Person AS p
-  THAT IS User AS u
-  THAT opened PR
-  WITH state='OPEN' AS pr
-RETURN
-  p.displayName AS x,
-  count(pr) AS y
-ORDER BY y DESC
-```
-**Non-Trend:**
-```j1ql
-FIND Person AS p
-  THAT IS User AS u
-  THAT opened PR
-  WITH state='OPEN' AS pr
-RETURN
-  p.displayName AS x,
-  count(pr) AS y
-ORDER BY y DESC
-LIMIT 5
-```
-
----
-
-## Line Chart
-The line chart is created by plotting a series of several points and connecting them with a straight line. This is best suited for data that has historical trend data enabled.
-
-### Query Requirements
-Expects `line` and `y` values.
-
-### Example Queries
-**Trend:**
-```j1ql
-FIND Finding
-  WITH createdOn > date.now-7day AS f
-RETURN
-  count(f) AS y,
-  f.numericSeverity AS line
-```
-**Non-Trend:**
-```j1ql
-FIND Finding
-  WITH createdOn > date.now-7day AS f
-RETURN
-  f.createdOn AS x,
-  count(f) AS y,
-  f.numericSeverity AS line
-```
-
----
-
-## Matrix Chart
-The matrix chart is used for analyzing and displaying the relationship between data sets. The matrix diagram shows the relationship between two, three, or four groups of information.
-
-### Query Requirements
-Expects `x` and `y` row and column names. Optional `label` to be shown in each cell. Any additional properties returned will be shown as key: value.
-
-### Example Queries
-**Firewall matrix:**
-```j1ql
-FIND Firewall AS row
-  THAT allows AS rel
-  Network AS col
-RETURN
-  row.displayName AS x,
-  col.displayName AS y,
-  rel.egress AS egress,
-  rel.ingress AS ingress,
-  rel.fromPort as fromPort,
-  rel.toPort as toPort,
-  rel.ipProtocol AS label
-```
-
----
-
-## Table
-The tables chart present data in as close to raw form as possible. Tables are meant to be read, so they are ideal when you have data that cannot easily be presented visually, or when the data requires more specific attention.
-
-### Query Requirements
-Note: This chart is currently limited to displaying 250 rows, and it does not handle pagination. It is recommended to use LIMIT and ORDER BY to sort and limit the results.
-
-### Example Queries
-**Most recent people:**
-```j1ql
-FIND Person AS p
-  RETURN
-    p.name AS Name,
-    p.email AS Email,
-    p.manager AS Manager
-  ORDER BY p._createdOn DESC
-  LIMIT 5
-```
-
----
-
-## Graph Chart
-The graph chart displays a tree graph of query results. This chart is best used to visualize specific relationships between entities.
-
-### Example Queries
-**Most recent people:**
-```j1ql
-FIND Person RETURN TREE
-```
-
----
-
-## Status
-The status chart displays a visual summary of correlating queries. This chart is best used to show positive or negative results based on if relationships are present in query results. This chart is best suited by multiple queries.
-
-### Example Queries
-**Users passing security check:**
-```j1ql
-Find Person as p
-  Return
-    p.email as id,
-    p.name as displayName,
-    p.acceptedSecurityPolicyOn,
-    p.backgroundCheck,
-    p.iconWebLink as iconWebLink
-```
-```j1ql
-Find Person as p that owns Device as d
-  Return
-    p.email as id,
-    d.encrypted
-```
-```j1ql
-Find Person as p that is User as u
-  Return
-    p.email as id,
-    count(u)
-```
-
----
-
-## Area Chart
-The area chart is a graph that combines a line chart and a bar chart to show changes in quantities over time. This chart requires the assets in the query to have relevant dates in their properties. For the best results, these charts can be generated by J1 Questions that have trend collection enabled. (This will soon be available straight from Insights.)
-
-### Query Requirements
-Expects two or more `x` and `y` values.
-
-### Example Queries
-**Top 5 most open PRs by Person:**
-```j1ql
-FIND Person AS p
-  THAT IS User AS u
-  THAT opened PR
-  WITH state='OPEN' AS pr
-RETURN
-  p.displayName AS x,
-  count(pr) AS y
-ORDER BY y DESC
-LIMIT 5
-```
-
----
-
-## Markdown Chart
-The markdown chart/widget allows you to display custom Markdown content directly on your dashboard. This is useful for adding documentation, instructions, or contextual information alongside your visualizations.
-
-### Query Requirements
-- No queries are required for this widget type.
-- The widget's settings must include a `markdown.text` property containing the Markdown content to display.
-
-### Example Configuration
-**Simple Markdown widget:**
-```json
-{
-  "type": "markdown",
-  "config": {
-    "queries": [],
-    "settings": {
-      "markdown": {
-        "text": "# test markdown here\nsome more content"
-      }
-    }
-  }
-}
-```
-
----