@progress/kendo-react-mcp 1.1.2 → 1.1.4

package/LICENSE.md

@@ -1,15 +1,11 @@
-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).
+# KendoReact
 
-> Copyright © 2025 Progress Software Corporation and/or its subsidiaries or affiliates.
+This package is part of the [KendoReact](https://www.telerik.com/kendo-react-ui) suite.
 
-> 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
+## License
 
-> [http://www.apache.org/licenses/LICENSE-2.0](http://www.apache.org/licenses/LICENSE-2.0)
+This is commercial software. To use it, you need to agree to the [**Telerik End User License Agreement for KendoReact**](https://www.telerik.com/purchase/license-agreement/progress-kendoreact). If you do not own a commercial license, this file shall be governed by the trial license terms.
 
-> 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.
+All available Kendo UI commercial licenses may be obtained at https://www.telerik.com/kendo-react-ui/pricing.
+
+*Copyright © 2025 Progress Software Corporation and/or one of its subsidiaries or affiliates. All rights reserved.*

package/dist/index.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-var R=Object.defineProperty;var P=(e,t,o)=>t in e?R(e,t,{enumerable:!0,configurable:!0,writable:!0,value:o}):e[t]=o;var f=(e,t,o)=>P(e,typeof t!="symbol"?t+"":t,o);import{McpServer as M}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as O}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as A}from"zod";var C="Kendo UI for React",w="react",g=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","Calendar","Card","Chart","ChartWizard","Chat","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","InlineAIPrompt","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","SpeechToTextButton","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 _,join as N}from"path";import{fileURLToPath as B}from"url";import{readFileSync as L}from"node:fs";import s from"node:fs";import m from"node:path";import b from"@grpc/proto-loader";import u from"@grpc/grpc-js";var y=["TELERIK_LICENSE","KENDO_UI_LICENSE"],v="TELERIK_LICENSE_PATH",l=(e=>(e[e.UNAUTHENTICATED=16]="UNAUTHENTICATED",e[e.RESOURCE_EXHAUSTED=8]="RESOURCE_EXHAUSTED",e[e.PERMISSION_DENIED=7]="PERMISSION_DENIED",e))(l||{}),S=!1,i=process.env.DEBUG_LOG_FILE,x=!!(i&&typeof i=="string");if(x){let e=m.resolve(i),t=m.dirname(e);if(t!=="."&&t!==process.cwd()&&!s.existsSync(t))try{s.mkdirSync(t,{recursive:!0})}catch(o){console.error("Error creating log directory:",o)}if(!s.existsSync(e))try{s.writeFileSync(e,"")}catch(o){console.error("Error creating log file:",o)}}S=x&&!!i&&s.existsSync(m.resolve(i));function n(...e){if(S&&i){let t=`${new Date().toISOString()}: ${e.join(" ")}
-`,o=m.resolve(i);s.appendFile(o,t,r=>{r&&console.error("Error writing to log file:",r)})}}var a=process.env[v],E=process.env[y[0]]||process.env[y[1]],h=class extends Error{constructor(e){super(e),this.name="LicenseError"}};function U(){if(!a&&!E)throw new h(`No license found. Please set one of the following environment variables: ${y.join(", ")} or ${v}`);let e;if(a)try{e=L(a,"utf8"),n("License key read from file: ",a)}catch{throw new h(`Error reading license file: ${a}. Please verify the file exists and is readable.`)}return E&&(e=E,n("License key read from environment variable.")),e}var k=class{constructor(e,t){f(this,"client");f(this,"isDev");this.contextApiUrl=e,this.protoPath=t;let o=b.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 r=u.loadPackageDefinition(o);this.client=new r.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?u.credentials.createInsecure():u.credentials.createSsl())}async query(e){let t=this.isDev?"fake_license":U(),o=new u.Metadata;if(t&&typeof t=="string"){t=t.replace(/^\uFEFF/,"");try{o.add("x-license-key",t)}catch(r){return n("Error adding license key to metadata:",r),Promise.reject(new Error(`Failed to use license key: ${r.message}`))}}return t&&typeof t=="string"&&o.add("x-license-key",t),new Promise((r,c)=>{this.client.query(e,o,(d,p)=>{d?c(d):r(p)})})}};var F=N(_(B(import.meta.url)),"../proto/service.proto"),G=new k("contextapi.telerik.com:443",F);async function T(e){return G.query(e)}import V from"fs";import I from"path";import{fileURLToPath as K}from"url";var q=K(import.meta.url),H=I.dirname(q),j=I.resolve(H,"../package.json"),$=JSON.parse(V.readFileSync(j,"utf-8")),D=new M({name:"kendo-and-kendo-resources",version:$.version});D.tool("kendo_react_assistant",`Answers questions and retrieves documentation about Kendo UI for React. 
+var G=Object.defineProperty;var D=(e,t,r)=>t in e?G(e,t,{enumerable:!0,configurable:!0,writable:!0,value:r}):e[t]=r;var h=(e,t,r)=>D(e,typeof t!="symbol"?t+"":t,r);import{McpServer as M}from"@modelcontextprotocol/sdk/server/mcp.js";import{StdioServerTransport as O}from"@modelcontextprotocol/sdk/server/stdio.js";import{z as k}from"zod";var A="Kendo UI for React",C="react",f=["ActionSheet","AIPrompt","Animation","AppBar","ArcGauge","AutoComplete","Avatar","Badge","Barcode","BottomNavigation","Breadcrumb","Button","ButtonGroup","Calendar","Card","Chart","ChartWizard","Chat","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","InlineAIPrompt","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","SpeechToTextButton","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 L,join as U}from"path";import{fileURLToPath as F}from"url";import{readFileSync as R}from"node:fs";import a from"node:fs";import m from"node:path";import _ from"@grpc/proto-loader";import u from"@grpc/grpc-js";var w=["TELERIK_LICENSE","KENDO_UI_LICENSE"],I="TELERIK_LICENSE_PATH",l=(e=>(e[e.UNAUTHENTICATED=16]="UNAUTHENTICATED",e[e.RESOURCE_EXHAUSTED=8]="RESOURCE_EXHAUSTED",e[e.PERMISSION_DENIED=7]="PERMISSION_DENIED",e))(l||{}),E=!1,n=process.env.DEBUG_LOG_FILE,v=!!(n&&typeof n=="string");if(v){let e=m.resolve(n),t=m.dirname(e);if(t!=="."&&t!==process.cwd()&&!a.existsSync(t))try{a.mkdirSync(t,{recursive:!0})}catch(r){console.error("Error creating log directory:",r)}if(!a.existsSync(e))try{a.writeFileSync(e,"")}catch(r){console.error("Error creating log file:",r)}}else E=!1;E=v&&!!n&&a.existsSync(m.resolve(n));function i(...e){if(E&&n){let t=`${new Date().toISOString()}: ${e.join(" ")}
+`,r=m.resolve(n);a.appendFile(r,t,o=>{o&&console.error("Error writing to log file:",o)})}}var s=process.env[I],y=process.env[w[0]]||process.env[w[1]],g=class extends Error{constructor(e){super(e),this.name="LicenseError"}};function P(){if(!s&&!y)throw new g(`No license found. Please set one of the following environment variables: ${w.join(", ")} or ${I}`);let e;if(s)try{e=R(s,"utf8"),i("License key read from file: ",s)}catch{throw new g(`Error reading license file: ${s}. Please verify the file exists and is readable.`)}return y&&(e=y,i("License key read from environment variable.")),e}var S=class{constructor(e,t){h(this,"client");h(this,"isDev");this.contextApiUrl=e,this.protoPath=t;let r=_.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"),i("Using ContextApi URl:",this.contextApiUrl);let o=u.loadPackageDefinition(r);this.client=new o.ContextQueryService(this.contextApiUrl||"contextapi.telerik.com:443",this.isDev?u.credentials.createInsecure():u.credentials.createSsl())}async query(e){let t=this.isDev?"fake_license":P(),r=new u.Metadata;if(t&&typeof t=="string"){t=t.replace(/^\uFEFF/,"");try{r.add("x-license-key",t)}catch(o){return i("Error adding license key to metadata:",o),Promise.reject(new Error(`Failed to use license key: ${o.message}`))}}return t&&typeof t=="string"&&r.add("x-license-key",t),new Promise((o,d)=>{this.client.query(e,r,(c,p)=>{c?d(c):o(p)})})}};var N=U(L(F(import.meta.url)),"../proto/service.proto"),B=new S("contextapi.telerik.com:443",N);async function T(e){return B.query(e)}import V from"fs";import x from"path";import{fileURLToPath as q}from"url";var K=q(import.meta.url),H=x.dirname(K),j=x.resolve(H,"../package.json"),$=JSON.parse(V.readFileSync(j,"utf-8")),b=new M({name:"kendo-and-kendo-resources",version:$.version});b.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:
@@ -12,15 +12,15 @@ specify its name in the 'component' parameter. This tool can be automatically tr
 - '@kendo';
 - '@kendoreact';
 - '@ask_kendo';
-- '@help_kendo'.`,{query:A.string().describe("The query to search for."),component:A.enum(g).describe("The component to search for. If not specified, you can use General.")},async({query:e,component:t})=>{n("Calling tool: ",JSON.stringify({query:e,component:t})),t==="Grid"&&(t="DataGrid");try{let o=await T({query:e,component:t.toLocaleLowerCase(),lib_name:w,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]});n("Response from context API: ",JSON.stringify(o));let r=J(),c=o.values.join(`
+- '@help_kendo'.`,{query:k.string().describe("The query to search for."),component:k.enum(f).describe("The component to search for. If not specified, you can use General.")},async({query:e,component:t})=>{i("Calling tool: ",JSON.stringify({query:e,component:t})),t==="Grid"&&(t="DataGrid");try{let r=await T({query:e,component:t.toLocaleLowerCase(),lib_name:C,text_matches_count:3,code_matches_count:0,allowed_types:["documentation"]});i("Response from context API: ",JSON.stringify(r));let o=J(),d=r.values.join(`
 
-`),d=c.trim(),p=[{type:"text",text:c+(d?`
+`),c=d.trim(),p=[{type:"text",text:d+(c?`
 
-`+r:"")}];return n("Response from tool: ",JSON.stringify(p)),{content:p}}catch(o){throw n("Error calling context API: ",JSON.stringify(o)),o?.code===l.UNAUTHENTICATED?new Error("Error: You are not authenticated. Please verify the Telerik License Key provided is valid."):o?.code===l.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===l.PERMISSION_DENIED?new Error(`Error: You do not have permission to access this resource. Please verify that you have a valid ${C} license key.`):o instanceof h?(n("License error: ",o.message),o):new Error(`Error: An error occurred while calling the service. Please try again later.
+`+o:"")}];return i("Response from tool: ",JSON.stringify(p)),{content:p}}catch(r){throw i("Error calling context API: ",JSON.stringify(r)),r?.code===l.UNAUTHENTICATED?new Error("Error: You are not authenticated. Please verify the Telerik License Key provided is valid."):r?.code===l.RESOURCE_EXHAUSTED?new Error(`Error: You have exceeded the extension quota. Upgrade to subscription licensing in order to unlock full access. Message: ${r.message}.`):r?.code===l.PERMISSION_DENIED?new Error(`Error: You do not have permission to access this resource. Please verify that you have a valid ${A} license key.`):r instanceof g?(i("License error: ",r.message),r):new Error(`Error: An error occurred while calling the service. Please try again later.
 
-Error Message: ${o.message}`)}});function J(){return`
+Error Message: ${r.message}`)}});function J(){return`
 ## Available ReactComponent enum values:
-${g.join(", ")}
+${f.join(", ")}
 
 ## Rules
 When generating code, explanations, or refactorings, always follow these rules:
@@ -28,7 +28,6 @@ When generating code, explanations, or refactorings, always follow these rules:
 1. Component Awareness
 Whenever a component name is mentioned\u2014regardless of how it's written (all lowercase, all uppercase, mixed case, separate words, or even with typos)\u2014you should always look up the correct example from the corresponding component.
 
-
 Key points:
 - Match component names case-insensitively and robustly to minor variations
 - If someone refers to a component (e.g., "button", "BUTTON", "BuTtOn"), match it to the correct component (Button)
@@ -116,4 +115,38 @@ Key points:
 Example:
 \u274C Deprecated: selectedField="isSelected" editField="inEdit"
 \u2705 Modern: Use select and edit state properties with proper configuration
-`}async function z(){let e=new O;n("Starting server..."),await D.connect(e)}z();
+
+5. Smart Grid (AI-Enhanced Grid) Implementation Guidelines
+**CRITICAL: When users ask about ANY of these AI grid terms, ALWAYS provide GridToolbarAIAssistant implementation (not basic Grid):**
+
+**Primary AI Grid Trigger Terms (case-insensitive):**
+- smart grid, smartgrid, smart-grid, smart_grid, SMART GRID, SmArt GrId
+- ai grid, aigrid, ai-grid, ai_grid, AI GRID, aI-griD, AIGrid  
+- ai enhanced grid, ai-enhanced-grid, ai_enhanced_grid, AI Enhanced Grid
+- ai powered grid, ai-powered-grid, ai_powered_grid, AI Powered Grid
+- intelligent grid, intelligent-grid, intelligent_grid, Intelligent Grid
+- grid with ai, grid-with-ai, grid_with_ai, Grid with AI
+- grid ai assistant, gridaiassistant, grid-ai-assistant, Grid AI Assistant
+- grid toolbar ai assistant, gridtoolbaraiassistant, GridToolbarAIAssistant
+- grid assistant, gridassistant, grid-assistant, Grid Assistant
+
+**Additional variations that should trigger AI Grid:**
+- ai enhanced, ai powered, smart, intelligent + grid (any spacing/casing)
+- grid + ai, grid + smart, grid + intelligent (any spacing/casing) 
+- Any mention of GridToolbarAIAssistant component specifically
+
+**Recognition Rule: If query contains ANY combination of AI/Smart/Intelligent + Grid terms, respond with complete GridToolbarAIAssistant setup.**
+
+Example Smart Grid suggestions by domain:
+- Financial: 'Sort by Amount descending', 'Show only failed transactions', 'Filter where currency is USD'
+- Sales: 'Group by region', 'Show top performing products', 'Filter by date range'
+- Inventory: 'Sort by stock level', 'Show out of stock items', 'Group by category'
+- Always include: 'Clear sorting', 'Clear filtering', 'Clear grouping'
+
+\u274C Basic Grid: <Grid data={data}><GridColumn field="name" /></Grid>
+\u2705 Smart Grid: Complete AI-enhanced setup with GridToolbarAIAssistant, proper callbacks, reset functionality, and contextual suggestions
+
+Important Disclaimer:
+Always include this disclaimer when providing Smart Grid examples:
+"The demos in this article use a Telerik-hosted AI service for demonstration purposes only. For production applications, you should implement your own AI service that understands your specific domain, data, and business requirements."
+`}async function W(){let e=new O;i("Starting server..."),await b.connect(e)}W();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progress/kendo-react-mcp",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "type": "module",
   "bin": "./dist/index.js",
   "license": "See LICENSE.md",
@@ -23,15 +23,10 @@
     "LICENSE.md",
     "!**/*.tsbuildinfo"
   ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest",
-    "test:run": "vitest run"
-  },
   "dependencies": {
-    "@grpc/grpc-js": "^1.13.3",
-    "@grpc/proto-loader": "^0.7.15",
-    "@modelcontextprotocol/sdk": "^1.8.0",
+    "@grpc/grpc-js": "^1.14.0",
+    "@grpc/proto-loader": "^0.8.0",
+    "@modelcontextprotocol/sdk": "^1.18.2",
     "tslib": "^2.3.0"
   },
   "devDependencies": {

package/proto/service.proto

@@ -27,6 +27,30 @@ message StringArray {
     repeated string values = 1;
 }
 
+message CssSearchRequst {
+    string query = 1;
+    int32 limit = 2;
+}
+
+message BuildingBlocksSearchRequest {
+    string query = 1;
+    string lib_name = 2;
+}
+
+message BuildingBlockItem {
+    string name = 1;
+    string description = 2;
+    string code = 3;
+}
+
+message BuildingBlocksSearchResponse {
+    repeated BuildingBlockItem items = 1;
+}
+
 service ContextQueryService {
     rpc Query(ContextQueryRequest) returns (StringArray);
+    rpc IconsSearch(CssSearchRequst) returns (StringArray);
+    rpc CssUtilsSearch(CssSearchRequst) returns (StringArray);
+    rpc BuildingBlocksSearch(BuildingBlocksSearchRequest) returns (BuildingBlocksSearchResponse); 
 }
+