@progress/kendo-react-mcp 1.0.4 → 1.0.5

package/LICENSE.md

@@ -0,0 +1,15 @@
+This project has been released under the [Apache License, version 2.0](http://www.apache.org/licenses/LICENSE-2.0.html), the text of which is included below. This license applies ONLY to the source of this repository and does not extend to any other Kendo UI distribution or variant, or any other 3rd party libraries used in a repository. For licensing information about KendoReact, see the [License Agreements page](https://www.telerik.com/purchase/license-agreement/progress-kendoreact).
+
+> Copyright © 2025 Progress Software Corporation and/or its subsidiaries or affiliates.
+
+> Licensed under the Apache License, Version 2.0 (the "License");
+> you may not use this file except in compliance with the License.
+> You may obtain a copy of the License at
+
+> [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
+
+> Unless required by applicable law or agreed to in writing, software
+> distributed under the License is distributed on an "AS IS" BASIS,
+> WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+> See the License for the specific language governing permissions and
+> limitations under the License.

package/dist/index.js

@@ -1,23 +1,6 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-import { ReactComponents, Suite, GrpcErrors, REACT_SUITE_NAME, } from './lib/constants.js';
-import { query as contextApiQuery } from './lib/grpc-client.js';
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { log } from './lib/logger.js';
-import { LicenseError } from './lib/read-license.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-const packageJsonPath = path.resolve(__dirname, '../package.json');
-const packageJson = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
-const server = new McpServer({
-    name: 'kendo-and-kendo-resources',
-    version: packageJson.version,
-});
-server.tool('kendo_react_assistant', `Answers questions and retrieves documentation about Kendo UI for React. 
+var A=Object.defineProperty;var _=(e,r,o)=>r in e?A(e,r,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[r]=o;var u=(e,r,o)=>_(e,typeof r!="symbol"?r+"":r,o);import{McpServer as M}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as O}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as T}from"zod";var h="Kendo UI for React",g="react",S=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","Calendar","Card","Chart","Checkbox","Chip","ChipList","ChunkProgressBar","CircularGauge","ColorGradient","ColorPalette","ColorPicker","ComboBox","ContextMenu","ConversationalUI","DataGrid","Grid","DataQuery","DateMath","DateInput","DatePicker","DateRangePicker","DateTimePicker","Dialog","Drag&Drop","Drawer","Drawing","DropDownButton","DropDownList","DropDownTree","Editor","Error","ExcelExport","ExpansionPanel","ExternalDropZone","FileSaver","FileManager","Filter","FlatColorPicker","FloatingActionButton","FloatingLabel","FontIcon","Form","Gantt","Gauge","General","GridLayout","Hint","Input","Label","LinearGauge","ListBox","ListView","Loader","Map","MaskedTextBox","Menu","MultiColumnComboBox","MultiSelect","MultiSelectTree","MultiViewCalendar","Notification","NumericTextBox","OrgChart","PageTemplates/BuildingBlocks","Pager","PanelBar","PDFProcessing","PDFViewer","PivotGrid","Popover","Popup","ProgressBar","QRCode","RadialGauge","RadioButton","RadioGroup","RangeSlider","Rating","Ripple","Sankey","Scheduler","ScrollView","Signature","Skeleton","Slider","Sortable","Sparkline","SplitButton","Splitter","Spreadsheet","StackLayout","Stepper","StockChart","SVGIcon","Switch","TabStrip","TaskBoard","TextArea","TextBox","TileLayout","Timeline","TimePicker","Toolbar","Tooltip","TreeList","TreeView","Typography","Upload","VSCodeExtension","Window"];import{dirname as N,join as B}from"path";import{fileURLToPath as G}from"url";import{readFileSync as L}from"node:fs";import a from"node:fs";import p from"node:path";import U from"@grpc/proto-loader";import l from"@grpc/grpc-js";var E=["TELERIK_LICENSE","KENDO_UI_LICENSE"],y="TELERIK_LICENSE_PATH",c=(e=>(e[e.UNAUTHENTICATED=16]="UNAUTHENTICATED",e[e.RESOURCE_EXHAUSTED=8]="RESOURCE_EXHAUSTED",e[e.PERMISSION_DENIED=7]="PERMISSION_DENIED",e))(c||{}),v=!1,i=process.env.DEBUG_LOG_FILE,x=!!(i&&typeof i=="string");if(x){let e=p.resolve(i),r=p.dirname(e);if(r!=="."&&r!==process.cwd()&&!a.existsSync(r))try{a.mkdirSync(r,{recursive:!0})}catch(o){console.error("Error creating log directory:",o)}if(!a.existsSync(e))try{a.writeFileSync(e,"")}catch(o){console.error("Error creating log file:",o)}}v=x&&!!i&&a.existsSync(p.resolve(i));function n(...e){if(v&&i){let r=`${new Date().toISOString()}: ${e.join(" ")}
+`,o=p.resolve(i);a.appendFile(o,r,t=>{t&&console.error("Error writing to log file:",t)})}}var s=process.env[y],m=process.env[E[0]]||process.env[E[1]],d=class extends Error{constructor(e){super(e),this.name="LicenseError"}};function R(){if(!s&&!m)throw new d(`No license found. Please set one of the following environment variables: ${E.join(", ")} or ${y}`);let e;if(s)try{e=L(s,"utf8"),n("License key read from file: ",s)}catch{throw new d(`Error reading license file: ${s}. Please verify the file exists and is readable.`)}return m&&(e=m,n("License key read from environment variable.")),e}var k=class{constructor(e,r){u(this,"client");u(this,"isDev");this.contextApiUrl=e,this.protoPath=r;let o=U.loadSync(this.protoPath,{keepCase:!0,longs:String,enums:String,defaults:!0,oneofs:!0});this.isDev=this.contextApiUrl?.includes("localhost")||this.contextApiUrl?.includes("127.0.0.1"),n("Using ContextApi URl:",this.contextApiUrl);let t=l.loadPackageDefinition(o);this.client=new t.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?l.credentials.createInsecure():l.credentials.createSsl())}async query(e){let r=this.isDev?"fake_license":R(),o=new l.Metadata;if(r&&typeof r=="string"){r=r.replace(/^\uFEFF/,"");try{o.add("x-license-key",r)}catch(t){return n("Error adding license key to metadata:",t),Promise.reject(new Error(`Failed to use license key: ${t.message}`))}}return r&&typeof r=="string"&&o.add("x-license-key",r),new Promise((t,I)=>{this.client.query(e,o,(f,D)=>{f?I(f):t(D)})})}};var b=B(N(G(import.meta.url)),"../proto/service.proto"),F=new k("contextapi.telerik.com:443",b);async function C(e){return F.query(e)}import q from"fs";import w from"path";import{fileURLToPath as V}from"url";var H=V(import.meta.url),$=w.dirname(H),K=w.resolve($,"../package.json"),J=JSON.parse(q.readFileSync(K,"utf-8")),P=new M({name:"kendo-and-kendo-resources",version:J.version});P.tool("kendo_react_assistant",`Answers questions and retrieves documentation about Kendo UI for React. 
 Use this tool when the user asks about Kendo UI for React features, specific components (e.g., Grid, Chart, Editor), implementation details, or general usage. 
 Provide the user's detailed question as the 'query'. If the question pertains to a specific Kendo UI for React component, 
 specify its name in the 'component' parameter. This tool can be automatically triggered when the following phrases are detected in the user's input/prompt:
@@ -29,60 +12,8 @@ specify its name in the 'component' parameter. This tool can be automatically tr
 - '@kendo';
 - '@kendoreact';
 - '@ask_kendo';
-- '@help_kendo'.`, {
-    query: z.string().describe('The query to search for.'),
-    component: z
-        .enum(ReactComponents)
-        .describe('The component to search for. If not specified, you can use General.'),
-}, async ({ query, component }) => {
-    log('Calling tool: ', JSON.stringify({ query, component }));
-    if (component === 'Grid') {
-        component = 'DataGrid';
-    }
-    try {
-        const response = await contextApiQuery({
-            query,
-            component: component.toLocaleLowerCase(),
-            lib_name: Suite,
-            text_matches_count: 3,
-            code_matches_count: 0,
-            allowed_types: ['documentation'],
-        });
-        log('Response from context API: ', JSON.stringify(response));
-        const content = [
-            {
-                type: 'text',
-                text: response.values.join('\n\n'),
-            },
-        ];
-        log('Response from tool: ', JSON.stringify(content));
-        return {
-            content,
-        };
-    }
-    catch (error) {
-        log('Error calling context API: ', JSON.stringify(error));
-        if (error?.code === GrpcErrors.UNAUTHENTICATED) {
-            throw new Error('Error: You are not authenticated. Please verify the Telerik License Key provided is valid.');
-        }
-        else if (error?.code === GrpcErrors.RESOURCE_EXHAUSTED) {
-            throw new Error(`Error: You have exceeded the extension quota. Upgrade to subscription licensing in order to unlock full access. Message: ${error.message}.`);
-        }
-        else if (error?.code === GrpcErrors.PERMISSION_DENIED) {
-            throw new Error(`Error: You do not have permission to access this resource. Please verify that you have a valid ${REACT_SUITE_NAME} license key.`);
-        }
-        else if (error instanceof LicenseError) {
-            log('License error: ', error.message);
-            throw error;
-        }
-        else {
-            throw new Error(`Error: An error occurred while calling the service. Please try again later.\n\nError Message: ${error.message}`);
-        }
-    }
-});
-async function startServer() {
-    const transport = new StdioServerTransport();
-    log('Starting server...');
-    await server.connect(transport);
-}
-startServer();
+- '@help_kendo'.`,{query:T.string().describe("The query to search for."),component:T.enum(S).describe("The component to search for. If not specified, you can use General.")},async({query:e,component:r})=>{n("Calling tool: ",JSON.stringify({query:e,component:r})),r==="Grid"&&(r="DataGrid");try{let o=await C({query:e,component:r.toLocaleLowerCase(),lib_name:g,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]});n("Response from context API: ",JSON.stringify(o));let t=[{type:"text",text:o.values.join(`
+
+`)}];return n("Response from tool: ",JSON.stringify(t)),{content:t}}catch(o){throw n("Error calling context API: ",JSON.stringify(o)),o?.code===c.UNAUTHENTICATED?new Error("Error: You are not authenticated. Please verify the Telerik License Key provided is valid."):o?.code===c.RESOURCE_EXHAUSTED?new Error(`Error: You have exceeded the extension quota. Upgrade to subscription licensing in order to unlock full access. Message: ${o.message}.`):o?.code===c.PERMISSION_DENIED?new Error(`Error: You do not have permission to access this resource. Please verify that you have a valid ${h} license key.`):o instanceof d?(n("License error: ",o.message),o):new Error(`Error: An error occurred while calling the service. Please try again later.
+
+Error Message: ${o.message}`)}});async function j(){let e=new O;n("Starting server..."),await P.connect(e)}j();

package/dist/lib/constants.d.ts

@@ -1,10 +1,3 @@
-export declare const LICENSE_ENV_VARS: string[];
-export declare const LICENSE_ENV_PATH_VAR = "TELERIK_LICENSE_PATH";
 export declare const REACT_SUITE_NAME = "Kendo UI for React";
 export declare const Suite = "react";
 export declare const ReactComponents: readonly ["ActionSheet", "AIPrompt", "Animation", "AppBar", "ArcGauge", "AutoComplete", "Avatar", "Badge", "Barcode", "BottomNavigation", "Breadcrumb", "Button", "ButtonGroup", "Calendar", "Card", "Chart", "Checkbox", "Chip", "ChipList", "ChunkProgressBar", "CircularGauge", "ColorGradient", "ColorPalette", "ColorPicker", "ComboBox", "ContextMenu", "ConversationalUI", "DataGrid", "Grid", "DataQuery", "DateMath", "DateInput", "DatePicker", "DateRangePicker", "DateTimePicker", "Dialog", "Drag&Drop", "Drawer", "Drawing", "DropDownButton", "DropDownList", "DropDownTree", "Editor", "Error", "ExcelExport", "ExpansionPanel", "ExternalDropZone", "FileSaver", "FileManager", "Filter", "FlatColorPicker", "FloatingActionButton", "FloatingLabel", "FontIcon", "Form", "Gantt", "Gauge", "General", "GridLayout", "Hint", "Input", "Label", "LinearGauge", "ListBox", "ListView", "Loader", "Map", "MaskedTextBox", "Menu", "MultiColumnComboBox", "MultiSelect", "MultiSelectTree", "MultiViewCalendar", "Notification", "NumericTextBox", "OrgChart", "PageTemplates/BuildingBlocks", "Pager", "PanelBar", "PDFProcessing", "PDFViewer", "PivotGrid", "Popover", "Popup", "ProgressBar", "QRCode", "RadialGauge", "RadioButton", "RadioGroup", "RangeSlider", "Rating", "Ripple", "Sankey", "Scheduler", "ScrollView", "Signature", "Skeleton", "Slider", "Sortable", "Sparkline", "SplitButton", "Splitter", "Spreadsheet", "StackLayout", "Stepper", "StockChart", "SVGIcon", "Switch", "TabStrip", "TaskBoard", "TextArea", "TextBox", "TileLayout", "Timeline", "TimePicker", "Toolbar", "Tooltip", "TreeList", "TreeView", "Typography", "Upload", "VSCodeExtension", "Window"];
-export declare enum GrpcErrors {
-    UNAUTHENTICATED = 16,
-    RESOURCE_EXHAUSTED = 8,
-    PERMISSION_DENIED = 7
-}

package/dist/lib/grpc-client.d.ts

@@ -1,5 +1,3 @@
-type Response = {
+export declare function query(queryParams: any): Promise<{
     values: string[];
-};
-export declare function query(queryParams: any): Promise<Response>;
-export {};
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-mcp",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "type": "module",
   "bin": "./dist/index.js",
   "license": "See LICENSE.md",
@@ -28,5 +28,8 @@
     "@grpc/proto-loader": "^0.7.15",
     "@modelcontextprotocol/sdk": "^1.8.0",
     "tslib": "^2.3.0"
+  },
+  "devDependencies": {
+    "@local/mcp-common": "*"
   }
 }

package/proto/service.proto

@@ -9,6 +9,8 @@ message ContextQueryRequest {
     int32 code_matches_count = 4;
     repeated string allowed_types = 5;
     string component = 6;
+    string userId = 7;
+    string filters_json = 8;
 }
 
 message Item {

package/dist/lib/constants.js

@@ -1,135 +0,0 @@
-export const LICENSE_ENV_VARS = ['TELERIK_LICENSE', 'KENDO_UI_LICENSE'];
-export const LICENSE_ENV_PATH_VAR = 'TELERIK_LICENSE_PATH';
-export const REACT_SUITE_NAME = 'Kendo UI for React';
-export const Suite = 'react';
-export const ReactComponents = [
-    'ActionSheet',
-    'AIPrompt',
-    'Animation',
-    'AppBar',
-    'ArcGauge',
-    'AutoComplete',
-    'Avatar',
-    'Badge',
-    'Barcode',
-    'BottomNavigation',
-    'Breadcrumb',
-    'Button',
-    'ButtonGroup',
-    'Calendar',
-    'Card',
-    'Chart',
-    'Checkbox',
-    'Chip',
-    'ChipList',
-    'ChunkProgressBar',
-    'CircularGauge',
-    'ColorGradient',
-    'ColorPalette',
-    'ColorPicker',
-    'ComboBox',
-    'ContextMenu',
-    'ConversationalUI',
-    'DataGrid',
-    'Grid',
-    'DataQuery',
-    'DateMath',
-    'DateInput',
-    'DatePicker',
-    'DateRangePicker',
-    'DateTimePicker',
-    'Dialog',
-    'Drag&Drop',
-    'Drawer',
-    'Drawing',
-    'DropDownButton',
-    'DropDownList',
-    'DropDownTree',
-    'Editor',
-    'Error',
-    'ExcelExport',
-    'ExpansionPanel',
-    'ExternalDropZone',
-    'FileSaver',
-    'FileManager',
-    'Filter',
-    'FlatColorPicker',
-    'FloatingActionButton',
-    'FloatingLabel',
-    'FontIcon',
-    'Form',
-    'Gantt',
-    'Gauge',
-    'General',
-    'GridLayout',
-    'Hint',
-    'Input',
-    'Label',
-    'LinearGauge',
-    'ListBox',
-    'ListView',
-    'Loader',
-    'Map',
-    'MaskedTextBox',
-    'Menu',
-    'MultiColumnComboBox',
-    'MultiSelect',
-    'MultiSelectTree',
-    'MultiViewCalendar',
-    'Notification',
-    'NumericTextBox',
-    'OrgChart',
-    'PageTemplates/BuildingBlocks',
-    'Pager',
-    'PanelBar',
-    'PDFProcessing',
-    'PDFViewer',
-    'PivotGrid',
-    'Popover',
-    'Popup',
-    'ProgressBar',
-    'QRCode',
-    'RadialGauge',
-    'RadioButton',
-    'RadioGroup',
-    'RangeSlider',
-    'Rating',
-    'Ripple',
-    'Sankey',
-    'Scheduler',
-    'ScrollView',
-    'Signature',
-    'Skeleton',
-    'Slider',
-    'Sortable',
-    'Sparkline',
-    'SplitButton',
-    'Splitter',
-    'Spreadsheet',
-    'StackLayout',
-    'Stepper',
-    'StockChart',
-    'SVGIcon',
-    'Switch',
-    'TabStrip',
-    'TaskBoard',
-    'TextArea',
-    'TextBox',
-    'TileLayout',
-    'Timeline',
-    'TimePicker',
-    'Toolbar',
-    'Tooltip',
-    'TreeList',
-    'TreeView',
-    'Typography',
-    'Upload',
-    'VSCodeExtension',
-    'Window',
-];
-export var GrpcErrors;
-(function (GrpcErrors) {
-    GrpcErrors[GrpcErrors["UNAUTHENTICATED"] = 16] = "UNAUTHENTICATED";
-    GrpcErrors[GrpcErrors["RESOURCE_EXHAUSTED"] = 8] = "RESOURCE_EXHAUSTED";
-    GrpcErrors[GrpcErrors["PERMISSION_DENIED"] = 7] = "PERMISSION_DENIED";
-})(GrpcErrors || (GrpcErrors = {}));

package/dist/lib/grpc-client.js

@@ -1,45 +0,0 @@
-import protoLoader from '@grpc/proto-loader';
-import grpc from '@grpc/grpc-js';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-import { readLicense } from './read-license.js';
-import { log } from './logger.js';
-const protoPath = join(dirname(fileURLToPath(import.meta.url)), '../../proto/service.proto');
-const proto = protoLoader.loadSync(protoPath, {
-    keepCase: true,
-    longs: String,
-    enums: String,
-    defaults: true,
-    oneofs: true,
-});
-const protoDescriptor = grpc.loadPackageDefinition(proto);
-const service = protoDescriptor.ContextQueryService;
-const client = new service('contextapi.telerik.com:443', grpc.credentials.createSsl());
-export async function query(queryParams) {
-    let license = readLicense();
-    const metadata = new grpc.Metadata();
-    if (license && typeof license === 'string') {
-        // Check for BOM character and trim it
-        license = license.replace(/^\uFEFF/, '');
-        try {
-            metadata.add('x-license-key', license);
-        }
-        catch (error) {
-            log('Error adding license key to metadata:', error);
-            return Promise.reject(new Error(`Failed to use license key: ${error.message}`));
-        }
-    }
-    if (license && typeof license === 'string') {
-        metadata.add('x-license-key', license);
-    }
-    return new Promise((resolve, reject) => {
-        client.query(queryParams, metadata, (err, response) => {
-            if (err) {
-                reject(err);
-            }
-            else {
-                resolve(response);
-            }
-        });
-    });
-}

package/dist/lib/logger.d.ts

@@ -1 +0,0 @@
-export declare function log(...args: any[]): void;

package/dist/lib/logger.js

@@ -1,43 +0,0 @@
-import fs from 'node:fs';
-import path from 'node:path';
-let LOG_ENABLED = false;
-const LOG_FILE = process.env.DEBUG_LOG_FILE;
-const LOG_FILE_DEFINED = !!(LOG_FILE && typeof LOG_FILE === 'string');
-// check if the log file is a valid path
-if (LOG_FILE_DEFINED) {
-    const resolvedLogFile = path.resolve(LOG_FILE);
-    const logDir = path.dirname(resolvedLogFile);
-    // Only create directory if it's not the current directory and doesn't exist
-    if (logDir !== '.' && logDir !== process.cwd() && !fs.existsSync(logDir)) {
-        try {
-            fs.mkdirSync(logDir, { recursive: true });
-        }
-        catch (err) {
-            console.error('Error creating log directory:', err);
-        }
-    }
-    // Create the log file if it doesn't exist
-    if (!fs.existsSync(resolvedLogFile)) {
-        try {
-            fs.writeFileSync(resolvedLogFile, '');
-        }
-        catch (err) {
-            console.error('Error creating log file:', err);
-        }
-    }
-}
-LOG_ENABLED = LOG_FILE_DEFINED && !!LOG_FILE && fs.existsSync(path.resolve(LOG_FILE));
-export function log(...args) {
-    if (LOG_ENABLED && LOG_FILE) {
-        // write a new line to the file with the date and time
-        const date = new Date();
-        const dateString = date.toISOString();
-        const logString = `${dateString}: ${args.join(' ')}\n`;
-        const resolvedLogFile = path.resolve(LOG_FILE);
-        fs.appendFile(resolvedLogFile, logString, (err) => {
-            if (err) {
-                console.error('Error writing to log file:', err);
-            }
-        });
-    }
-}

package/dist/lib/read-license.d.ts

@@ -1,4 +0,0 @@
-export declare class LicenseError extends Error {
-    constructor(message: string);
-}
-export declare function readLicense(): string | undefined;

package/dist/lib/read-license.js

@@ -1,32 +0,0 @@
-import { LICENSE_ENV_VARS, LICENSE_ENV_PATH_VAR } from './constants.js';
-import { readFileSync } from 'node:fs';
-import { log } from './logger.js';
-const LICENSE_PATH = process.env[LICENSE_ENV_PATH_VAR];
-const LICENSE_KEY = process.env[LICENSE_ENV_VARS[0]] || process.env[LICENSE_ENV_VARS[1]];
-// create a custom LicenseError class
-export class LicenseError extends Error {
-    constructor(message) {
-        super(message);
-        this.name = 'LicenseError';
-    }
-}
-export function readLicense() {
-    if (!LICENSE_PATH && !LICENSE_KEY) {
-        throw new LicenseError(`No license found. Please set one of the following environment variables: ${LICENSE_ENV_VARS.join(', ')} or ${LICENSE_ENV_PATH_VAR}`);
-    }
-    let licenseKey;
-    if (LICENSE_PATH) {
-        try {
-            licenseKey = readFileSync(LICENSE_PATH, 'utf8');
-            log('License key read from file: ', LICENSE_PATH);
-        }
-        catch (error) {
-            throw new LicenseError(`Error reading license file: ${LICENSE_PATH}. Please verify the file exists and is readable.`);
-        }
-    }
-    if (LICENSE_KEY) {
-        licenseKey = LICENSE_KEY;
-        log('License key read from environment variable.');
-    }
-    return licenseKey;
-}