@cplace/test-mcp-server 1.0.0 → 1.1.4

package/dist/tools/script.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+const TOOL_EXECUTE_SCRIPT = 'cplace_execute_script';
+const TOOL_EXECUTE_SCRIPT_WRITE = 'cplace_execute_script_write';
+export const SCRIPT_TOOL_DEFINITIONS = {
+    [TOOL_EXECUTE_SCRIPT]: {
+        description: `Execute JavaScript in a sandboxed cplace environment for data queries, calculations, and analysis.
+
+**Mode**: Read-only - scripts cannot modify data (no page.set, cplace.actions.createPage, etc.)
+
+**Timeout**: 30 seconds maximum execution time
+
+**Return Value Restrictions**:
+- Primitives: strings, numbers, booleans, null, dates (as ISO strings)
+- Arrays containing only primitives (no nested arrays or objects)
+- Objects containing only primitive values (no nested objects)
+- Cannot return cplace objects (Page, Person) directly - extract values first
+
+**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute. Must return a JSON-serializable value.
+
+The script has access to cplace low-code APIs (cplace.search, cplace.pages, Filters, etc.) but runs in read-only mode.
+
+Examples:
+- Simple: "return 2 + 2"
+- Search: "return cplace.search().add(Filters.type('cf.cplace.project')).findAll().map(function(p) { return p.getName(); });"
+- Extract: "var page = cplace.search().add(Filters.uid('page/abc')).findFirst(); return { name: page.getName() };"`)
+        },
+        annotations: { title: "Execute Script" }
+    },
+    [TOOL_EXECUTE_SCRIPT_WRITE]: {
+        description: `⚠️ WRITE OPERATIONS ENABLED: Execute JavaScript that can create, modify, and delete pages.
+
+Requires low-code edit permission (mayEditLowCode). Use cplace_execute_script for read-only operations.
+
+**Timeout**: 30 seconds maximum execution time
+
+**Available Action APIs**:
+- cplace.actions().createPage(params) - Create new pages
+- page.set(attributeName, value) - Set attribute values on pages
+- cplace.actions().deletePage(page) - Delete pages
+
+**Return Value Restrictions**: Same as read-only tool (primitives, flat arrays/objects only)
+
+**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute with write capabilities. Must return a JSON-serializable value.
+
+The script has access to all cplace low-code APIs including action APIs for creating, modifying, and deleting pages.
+
+Examples:
+- Create page: "var page = cplace.actions().createPage({ space: cplace.utils().getSpaceByName('My Workspace'), customType: 'cf.cplace.project.Task', customAttributes: { 'cf.cplace.project.title': 'New Task' } }); return { uid: page.getUid(), name: page.getName() };"
+- Update page: "var page = cplace.utils().getPageById('page/abc123'); page.set('cf.cplace.project.status', 'Completed'); return { success: true };"
+- Delete page: "var page = cplace.utils().getPageById('page/abc123'); cplace.actions().deletePage(page); return { deleted: true };"`)
+        },
+        annotations: { title: "Execute Script (Write)" }
+    }
+};
+export function registerScriptTools(server, client) {
+    server.registerTool(TOOL_EXECUTE_SCRIPT, SCRIPT_TOOL_DEFINITIONS[TOOL_EXECUTE_SCRIPT], async ({ script }) => {
+        debugLogWithTag('SCRIPT', `Executing script (${script.length} chars)`);
+        try {
+            const response = await client.makeApiRequest('json/script/execute', 'POST', undefined, { script });
+            const result = { result: response };
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('SCRIPT', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Script result too large (${sizeCheck.actualSize} characters). Modify your script to return less data (e.g., use .slice(), limit array size, or return specific fields only).`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('SCRIPT', 'Script executed successfully');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SCRIPT', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error executing script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_EXECUTE_SCRIPT_WRITE, SCRIPT_TOOL_DEFINITIONS[TOOL_EXECUTE_SCRIPT_WRITE], async ({ script }) => {
+        debugLogWithTag('SCRIPT', `Executing write script (${script.length} chars)`);
+        try {
+            const response = await client.makeApiRequest('json/script/execute-with-actions', 'POST', undefined, { script });
+            const result = { result: response };
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('SCRIPT', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Script result too large (${sizeCheck.actualSize} characters). Modify your script to return less data (e.g., use .slice(), limit array size, or return specific fields only).`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('SCRIPT', 'Write script executed successfully');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SCRIPT', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error executing script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=script.js.map

package/dist/tools/script.js.map

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

package/dist/tools/search.d.ts

@@ -3,7 +3,7 @@ import { z } from "zod";
 import { CplaceApiClient } from '../api.js';
 export declare const SEARCH_TOOL_DEFINITIONS: {
     readonly cplace_search_pages: {
-        readonly description: "Search pages of a type in cplace.";
+        readonly description: "Search pages of a type in cplace. The response includes a 'cplaceJson' field - use this when configuring search for embedded table/list widgets (cf.platform.embeddedSearchAsTable, cf.platform.embeddedSearchAsList).";
         readonly inputSchema: {
             readonly workspaceId: z.ZodOptional<z.ZodString>;
             readonly internalTypeName: z.ZodString;

package/dist/tools/search.js

@@ -9,7 +9,7 @@ const TOOL_SEARCH_PAGES_FULLTEXT = 'cplace_search_pages_fulltext';
 const TOOL_LIST_PAGES_OF_TYPE = 'cplace_list_pages_of_type';
 export const SEARCH_TOOL_DEFINITIONS = {
     [TOOL_SEARCH_PAGES]: {
-        description: "Search pages of a type in cplace.",
+        description: "Search pages of a type in cplace. The response includes a 'cplaceJson' field - use this when configuring search for embedded table/list widgets (cf.platform.embeddedSearchAsTable, cf.platform.embeddedSearchAsList).",
         inputSchema: {
             workspaceId: z.string().optional().describe("The ID of the workspace to search in. If not provided, searches across all accessible workspaces."),
             internalTypeName: z.string().describe(`The internal name of the type to filter by. Examples:

package/dist/tools/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,kBAAkB,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,iCAAiC,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,8BAA8B,EAAE,MAAM,qBAAqB,CAAC;AAGrE,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAChD,MAAM,0BAA0B,GAAG,8BAA8B,CAAC;AAClE,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAG5D,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,CAAC,iBAAiB,CAAC,EAAE;QACnB,WAAW,EAAE,wNAAwN;QACrO,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;YAChJ,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC;;;;;;8EAMkC,CAAC;YACzE,aAAa,EAAE,kBAAkB,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD/C,8BAA8B;;;;;;;;;;;;uEAYuC,CAAC;YAClE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACvG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uEAAuE,CAAC;YACjI,cAAc,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC;;;yDAGd,CAAC;YACpD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uJAAuJ,CAAC;SAC7M;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;KACvC;IACD,CAAC,0BAA0B,CAAC,EAAE;QAC5B,WAAW,EAAE,2GAA2G;QACxH,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mGAAmG,CAAC;YAChJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8IAA8I,CAAC;YAC7K,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACvG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uEAAuE,CAAC;SAClI;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,0BAA0B,EAAE;KACnD;IACD,CAAC,uBAAuB,CAAC,EAAE;QACzB,WAAW,EAAE,mHAAmH;QAChI,WAAW,EAAE;YACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YAC7E,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;YACpF,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,8CAA8C,CAAC;YACvG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uEAAuE,CAAC;SAClI;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE;KAC7C;CACO,CAAC;AAEX,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAuB;IAC5E,MAAM,CAAC,YAAY,CAAC,iBAAiB,EACnC,uBAAuB,CAAC,iBAAiB,CAAC,EAC1C,KAAK,EAAE,EACL,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,KAAK,GAAG,EAAE,EACV,MAAM,GAAG,CAAC,EACV,cAAc,EACd,UAAU,GACX,EAAE,EAAE;QACH,eAAe,CAAC,QAAQ,EAAE,4CAA4C,WAAW,IAAI,MAAM,UAAU,gBAAgB,YAAY,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,WAAW,KAAK,YAAY,MAAM,EAAE,CAAC,CAAC;QAEpM,IAAI,CAAC;YAEH,MAAM,YAAY,GAAG,iCAAiC,CAAC,aAAa,CAAC,CAAC;YAEtE,eAAe,CAAC,QAAQ,EAAE,qBAAqB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAG/E,IAAI,WAAW,EAAE,CAAC;gBAChB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;oBAC3B,IAAI,EAAE,WAAW;oBACjB,YAAY,EAAE,CAAC,WAAW,CAAC;iBAC5B,CAAC,CAAC;YACL,CAAC;YAGD,IAAI,gBAAgB,EAAE,CAAC;gBACrB,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC;oBAC3B,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,CAAC,gBAAgB,CAAC;iBAC1B,CAAC,CAAC;YACL,CAAC;YAED,eAAe,CAAC,QAAQ,EAAE,wBAAwB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;YAGlF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,EAAE;gBAC/D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBACpC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YAGH,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC;gBAC/B,MAAM,WAAW,GAAG;oBAClB,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;iBACrC,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;iBACxE,CAAC;YACJ,CAAC;YAED,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAkB,EAAE,EAAE,CACjF,kBAAkB,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,cAAc,KAAK,SAAS;gBACrC,iBAAiB,EAAE,cAAc,KAAK,SAAS;gBAC/C,eAAe,EAAE,KAAK;gBACtB,eAAe,EAAE,UAAU;gBAC3B,mBAAmB,EAAE,IAAI;aAC1B,CAAC,CACH,CAAC,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,cAAc,GAAG;gBACrB,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE;oBACV,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;oBACpC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,KAAK;oBACxC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,MAAM;oBAC3C,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK;iBAC7C;gBACD,2BAA2B,EAAE,MAAM,CAAC,OAAO;gBAC3C,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;YAGF,MAAM,SAAS,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;YACpD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;iBACxD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,QAAQ,EAAE,wBAAwB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5G,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAClI,OAAO,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,0BAA0B,EAC5C,uBAAuB,CAAC,0BAA0B,CAAC,EACnD,KAAK,EAAE,EACL,WAAW,EACX,QAAQ,EACR,KAAK,GAAG,EAAE,EACV,MAAM,GAAG,CAAC,GACX,EAAE,EAAE;QACH,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC;aAC1D,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,EAAE;gBACxE,WAAW,EAAE,WAAW;gBACxB,QAAQ,EAAE,IAAI,QAAQ,GAAG;gBACzB,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YACH,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAkB,EAAE,EAAE,CACjF,kBAAkB,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,IAAI;gBACvB,eAAe,EAAE,KAAK;gBACtB,mBAAmB,EAAE,IAAI;aAC1B,CAAC,CACH,CAAC,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,cAAc,GAAG;gBACrB,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE;oBACV,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;oBACpC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,KAAK;oBACxC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,MAAM;oBAC3C,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK;iBAC7C;gBACD,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,UAAU;aAC9B,CAAC;YAGF,MAAM,SAAS,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;YACpD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;iBACxD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yCAAyC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACpI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAGF,MAAM,CAAC,YAAY,CAAC,uBAAuB,EACzC,uBAAuB,CAAC,uBAAuB,CAAC,EAChD,KAAK,EAAE,EACL,WAAW,EACX,QAAQ,EACR,KAAK,GAAG,EAAE,EACV,MAAM,GAAG,CAAC,GACX,EAAE,EAAE;QACH,IAAI,CAAC;YAEH,MAAM,YAAY,GAAG;gBACnB,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,WAAW;wBACjB,YAAY,EAAE,CAAC,WAAW,CAAC;qBAC5B;oBACD;wBACE,IAAI,EAAE,MAAM;wBACZ,KAAK,EAAE,CAAC,QAAQ,CAAC;qBAClB;iBACF;aACF,CAAC;YAGF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,EAAE;gBAC/D,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBACpC,KAAK;gBACL,MAAM;aACP,CAAC,CAAC;YAGH,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAkB,EAAE,EAAE,CACjF,kBAAkB,CAAC,IAAI,EAAE;gBACvB,OAAO,EAAE,KAAK;gBACd,iBAAiB,EAAE,IAAI;gBACvB,eAAe,EAAE,KAAK;gBACtB,mBAAmB,EAAE,IAAI;aAC1B,CAAC,CACH,CAAC,CAAC,CAAC,EAAE,CAAC;YAEP,MAAM,cAAc,GAAG;gBACrB,OAAO,EAAE,eAAe;gBACxB,UAAU,EAAE;oBACV,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,CAAC;oBACpC,KAAK,EAAE,MAAM,CAAC,UAAU,EAAE,KAAK,IAAI,KAAK;oBACxC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,IAAI,MAAM;oBAC3C,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,OAAO,IAAI,KAAK;iBAC7C;gBACD,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;YAGF,MAAM,SAAS,GAAG,iBAAiB,CAAC,cAAc,CAAC,CAAC;YACpD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,UAAU,EAAE,CAAC;iBACxD,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC3E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACtH,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/type-management.d.ts

@@ -73,7 +73,7 @@ export declare const TYPE_MANAGEMENT_TOOL_DEFINITIONS: {
                 providerClass: z.ZodOptional<z.ZodString>;
                 providerSimpleName: z.ZodOptional<z.ZodString>;
             }, "strip", z.ZodTypeAny, {
-                constraintType: "string" | "number" | "boolean" | "workflow" | "longString" | "richString" | "localizedString" | "date" | "color" | "reference" | "textEnumeration" | "numberEnumeration" | "dynamicEnumeration";
+                constraintType: "string" | "number" | "boolean" | "workflow" | "date" | "reference" | "textEnumeration" | "numberEnumeration" | "dynamicEnumeration" | "longString" | "richString" | "localizedString" | "color";
                 pattern?: string | undefined;
                 patternErrorMessage?: Record<string, string> | undefined;
                 precision?: number | undefined;
@@ -94,7 +94,7 @@ export declare const TYPE_MANAGEMENT_TOOL_DEFINITIONS: {
                 providerClass?: string | undefined;
                 providerSimpleName?: string | undefined;
             }, {
-                constraintType: "string" | "number" | "boolean" | "workflow" | "longString" | "richString" | "localizedString" | "date" | "color" | "reference" | "textEnumeration" | "numberEnumeration" | "dynamicEnumeration";
+                constraintType: "string" | "number" | "boolean" | "workflow" | "date" | "reference" | "textEnumeration" | "numberEnumeration" | "dynamicEnumeration" | "longString" | "richString" | "localizedString" | "color";
                 pattern?: string | undefined;
                 patternErrorMessage?: Record<string, string> | undefined;
                 precision?: number | undefined;

package/dist/tools/version-check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/tools/version-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8B5C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAoFlF"}
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/tools/version-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8B5C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqFlF"}

package/dist/tools/version-check.js

@@ -1,3 +1,4 @@
+import semver from 'semver';
 import { readFileSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
@@ -25,7 +26,7 @@ export function registerVersionCheckTool(server, client) {
         try {
             const backendResponse = await client.makeApiRequest('json/version', 'GET');
             const backendExpectedVersion = backendResponse.apiVersion;
-            const isCompatible = FRONTEND_VERSION === backendExpectedVersion;
+            const isCompatible = semver.satisfies(FRONTEND_VERSION, backendExpectedVersion);
             if (isCompatible) {
                 return {
                     content: [{
@@ -43,19 +44,20 @@ export function registerVersionCheckTool(server, client) {
                 };
             }
             else {
-                const frontendIsNewer = compareVersions(FRONTEND_VERSION, backendExpectedVersion) > 0;
-                const guidance = frontendIsNewer
+                const minVersion = semver.minVersion(backendExpectedVersion);
+                const isBelowRange = minVersion && semver.lt(FRONTEND_VERSION, minVersion.version);
+                const guidance = isBelowRange
                     ? {
-                        action: "MCP SERVER DOWNGRADE OR BACKEND UPGRADE NEEDED",
-                        recommendation: `Two resolution options:
-Option A: Downgrade MCP server to version ${backendExpectedVersion} by updating your Claude Desktop/Code configuration to use @cplace/test-mcp-server@${backendExpectedVersion}
-Option B: Contact administrator to upgrade cplace backend to the latest version`,
-                        explanation: "Your MCP server package is newer than what the backend expects. You can either downgrade the MCP server or upgrade the backend."
+                        action: "MCP SERVER UPGRADE NEEDED",
+                        recommendation: `Upgrade MCP server package to version ${minVersion?.version} or higher. If using npx without version pin, simply restart Claude to auto-upgrade. Otherwise, update your configuration to @cplace/test-mcp-server@${minVersion?.version} or later.`,
+                        explanation: `Backend accepts versions matching: ${backendExpectedVersion}. Your version ${FRONTEND_VERSION} is below the minimum required.`
                     }
                     : {
-                        action: "MCP SERVER UPGRADE NEEDED",
-                        recommendation: `Upgrade MCP server package to version ${backendExpectedVersion}. If using npx without version pin, simply restart Claude to auto-upgrade. Otherwise, update your configuration to @cplace/test-mcp-server@${backendExpectedVersion}`,
-                        explanation: "Backend has been upgraded and expects newer MCP server package version."
+                        action: "MCP SERVER DOWNGRADE OR BACKEND UPGRADE NEEDED",
+                        recommendation: `Two resolution options:
+Option A: Downgrade MCP server to a version matching ${backendExpectedVersion} by updating your Claude Desktop/Code configuration
+Option B: Contact administrator to upgrade cplace backend to support version ${FRONTEND_VERSION}`,
+                        explanation: `Your MCP server package version ${FRONTEND_VERSION} is newer than what the backend accepts (${backendExpectedVersion}). Backend needs to be updated to declare a range that includes your version.`
                     };
                 return {
                     content: [{
@@ -91,17 +93,4 @@ Option B: Contact administrator to upgrade cplace backend to the latest version`
         }
     });
 }
-function compareVersions(v1, v2) {
-    const parts1 = v1.split('.').map(Number);
-    const parts2 = v2.split('.').map(Number);
-    for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
-        const part1 = parts1[i] || 0;
-        const part2 = parts2[i] || 0;
-        if (part1 > part2)
-            return 1;
-        if (part1 < part2)
-            return -1;
-    }
-    return 0;
-}
 //# sourceMappingURL=version-check.js.map

package/dist/tools/version-check.js.map

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

package/dist/tools/widgets.d.ts

@@ -3,21 +3,24 @@ import { z } from "zod";
 import { CplaceApiClient } from '../api.js';
 export declare const WIDGET_TOOL_DEFINITIONS: {
     readonly cplace_list_widget_definitions: {
-        readonly description: "Get a list of all available widget definitions in the system that support the specified embedding context, with their basic metadata including names, descriptions, and apps";
+        readonly description: "Get a list of all available widget definitions in the system that support the specified embedding context, with their basic metadata including names, descriptions, and apps.\n\n⚠️ APP DEPENDENCY CHECK: Each widget includes a 'requiredApp' field:\n- null: Widget is always available (platform widget, no app dependency)\n- \"cf.cplace.someApp\": Widget requires this app to be installed in the workspace\n\nBEFORE SELECTING A WIDGET for a specific workspace, verify the required app is installed using cplace_list_workspace_apps. Widgets with uninstalled requiredApp cannot be added to layouts.";
         readonly inputSchema: {
             readonly embeddingContext: z.ZodDefault<z.ZodEnum<["AS_WIDGET", "INSIDE_RICHSTRING", "INSIDE_WIDGET"]>>;
+            readonly tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
         };
         readonly annotations: {
             readonly title: "List Widget Definitions";
         };
     };
     readonly cplace_get_widget_definition: {
-        readonly description: "Get detailed widget configuration schema.\n\n🔍 ALWAYS USE BEFORE ADDING/CONFIGURING WIDGETS to understand:\n- Required vs optional attributes\n- Correct attribute names (often not intuitive!)\n- Expected data types and formats\n- Available enumeration values\n\nCOMMON GOTCHAS:\n- Bar charts use 'attributeName' not 'attribute'\n- Connected charts need 'tableWidgetId' to link to tables\n- Attribute names often need single quotes: \"'cf.cplace.myAttribute'\"\n- LocalizedString format: {\"en\": \"English\", \"de\": \"German\"}\n\nWidget kinds: 'cf.platform.connectedBarChart', 'cf.platform.wiki', etc.";
+        readonly description: "Get widget definition with configurable detail level.\n\nALWAYS includes:\n- widgetKind, localizedName\n- summary (from widget specifications)\n\nOPTIONAL depth control:\n- includeOverview: true → adds conceptual documentation (overview)\n- includeDetails: true → adds attributes array and implementation hints\n\nCOMMON USAGE:\n- Quick check: just widgetKinds (minimal response)\n- Understanding: includeOverview: true\n- Implementation: includeDetails: true\n- Full details: both flags true\n\nWidget kinds: 'cf.platform.connectedBarChart', 'cf.platform.wiki', etc.";
         readonly inputSchema: {
-            readonly widgetKind: z.ZodString;
+            readonly widgetKinds: z.ZodArray<z.ZodString, "many">;
+            readonly includeOverview: z.ZodDefault<z.ZodBoolean>;
+            readonly includeDetails: z.ZodDefault<z.ZodBoolean>;
         };
         readonly annotations: {
-            readonly title: "Get Widget Definition Details";
+            readonly title: "Get Widget Definition";
         };
     };
     readonly cplace_get_widget_details: {
@@ -76,7 +79,7 @@ export declare const WIDGET_TOOL_DEFINITIONS: {
         };
     };
     readonly cplace_add_widget_to_embedded_layout: {
-        readonly description: "Add widget to page or type embedded layout. Enables adding widgets to nested layouts like those within AttributesGroup widgets.";
+        readonly description: "Add widget to page or type embedded layout. Enables adding widgets to nested layouts like those within AttributesGroup widgets.\n\n⚠️ APP DEPENDENCY: Verify the widget's requiredApp is installed in the workspace using cplace_list_workspace_apps before adding. Widgets with uninstalled requiredApp will fail.";
         readonly inputSchema: {
             readonly context: z.ZodUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"page">;

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

@@ -1 +1 @@
-{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/tools/widgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAuC5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgG1B,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA4V7E"}
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/tools/widgets.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8E5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2H1B,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAsY7E"}

package/dist/tools/widgets.js

@@ -2,6 +2,30 @@ import { z } from "zod";
 import { debugLogWithTag } from "../logger.js";
 import { transformMultiplicityToBoolean } from '../utils.js';
 import { PositionSchema, WIDGET_CONFIG_DESCRIPTION } from './common-schemas.js';
+import { WIDGET_SPECIFICATIONS } from '../widget-specifications/index.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function loadTagRegistry() {
+    const tagRegistryPath = join(__dirname, '..', 'widget-specifications', 'tag-registry.json');
+    const content = readFileSync(tagRegistryPath, 'utf8');
+    return JSON.parse(content);
+}
+function buildTagFilterDescription() {
+    const tagRegistry = loadTagRegistry();
+    let description = 'Filter widgets by tags (OR logic - returns widgets matching ANY tag).\n\n';
+    for (const dimension of Object.values(tagRegistry.dimensions)) {
+        const dim = dimension;
+        description += `**${dim.description}**:\n`;
+        for (const [tagKey, tagDesc] of Object.entries(dim.tags)) {
+            description += `- ${tagKey}: ${tagDesc}\n`;
+        }
+        description += '\n';
+    }
+    return description.trim();
+}
 const TOOL_LIST_WIDGET_DEFINITIONS = 'cplace_list_widget_definitions';
 const TOOL_GET_WIDGET_DEFINITION = 'cplace_get_widget_definition';
 const TOOL_GET_WIDGET_DETAILS = 'cplace_get_widget_details';
@@ -10,21 +34,46 @@ const TOOL_ADD_WIDGET_TO_EMBEDDED_LAYOUT = 'cplace_add_widget_to_embedded_layout
 const TOOL_REMOVE_WIDGET_FROM_EMBEDDED_LAYOUT = 'cplace_remove_widget_from_embedded_layout';
 export const WIDGET_TOOL_DEFINITIONS = {
     [TOOL_LIST_WIDGET_DEFINITIONS]: {
-        description: "Get a list of all available widget definitions in the system that support the specified embedding context, with their basic metadata including names, descriptions, and apps",
+        description: `Get a list of all available widget definitions in the system that support the specified embedding context, with their basic metadata including names, descriptions, and apps.
+
+⚠️ APP DEPENDENCY CHECK: Each widget includes a 'requiredApp' field:
+- null: Widget is always available (platform widget, no app dependency)
+- "cf.cplace.someApp": Widget requires this app to be installed in the workspace
+
+BEFORE SELECTING A WIDGET for a specific workspace, verify the required app is installed using cplace_list_workspace_apps. Widgets with uninstalled requiredApp cannot be added to layouts.`,
         inputSchema: {
             embeddingContext: z.enum(["AS_WIDGET", "INSIDE_RICHSTRING", "INSIDE_WIDGET"]).default("AS_WIDGET").describe(`Filter widgets by embedding context support:
 - AS_WIDGET (default): Widgets that support full widget embedding with frame and title
 - INSIDE_RICHSTRING: Widgets that can be embedded in rich text content without frame
-- INSIDE_WIDGET: Widgets that can be embedded inside other widgets without frame`)
+- INSIDE_WIDGET: Widgets that can be embedded inside other widgets without frame`),
+            tags: z.array(z.string()).optional().describe(buildTagFilterDescription())
         },
         annotations: { title: "List Widget Definitions" }
     },
     [TOOL_GET_WIDGET_DEFINITION]: {
-        description: "Get detailed widget configuration schema.\n\n🔍 ALWAYS USE BEFORE ADDING/CONFIGURING WIDGETS to understand:\n- Required vs optional attributes\n- Correct attribute names (often not intuitive!)\n- Expected data types and formats\n- Available enumeration values\n\nCOMMON GOTCHAS:\n- Bar charts use 'attributeName' not 'attribute'\n- Connected charts need 'tableWidgetId' to link to tables\n- Attribute names often need single quotes: \"'cf.cplace.myAttribute'\"\n- LocalizedString format: {\"en\": \"English\", \"de\": \"German\"}\n\nWidget kinds: 'cf.platform.connectedBarChart', 'cf.platform.wiki', etc.",
+        description: `Get widget definition with configurable detail level.
+
+ALWAYS includes:
+- widgetKind, localizedName
+- summary (from widget specifications)
+
+OPTIONAL depth control:
+- includeOverview: true → adds conceptual documentation (overview)
+- includeDetails: true → adds attributes array and implementation hints
+
+COMMON USAGE:
+- Quick check: just widgetKinds (minimal response)
+- Understanding: includeOverview: true
+- Implementation: includeDetails: true
+- Full details: both flags true
+
+Widget kinds: 'cf.platform.connectedBarChart', 'cf.platform.wiki', etc.`,
         inputSchema: {
-            widgetKind: z.string().describe("The widget kind identifier (e.g., 'cf.cplace.platform.table', 'cf.platform.wiki')")
+            widgetKinds: z.array(z.string()).describe("Array of widget kind identifiers (e.g., ['cf.platform.embeddedSearchAsTable', 'cf.platform.connectedBarChart'])"),
+            includeOverview: z.boolean().default(false).describe("Include conceptual documentation from _overview.md. Use when you need to understand widget purpose and capabilities."),
+            includeDetails: z.boolean().default(false).describe("Include attributes array and implementation hints from _implementation.md. Use when you need to configure the widget.")
         },
-        annotations: { title: "Get Widget Definition Details" }
+        annotations: { title: "Get Widget Definition" }
     },
     [TOOL_GET_WIDGET_DETAILS]: {
         description: "Get detailed configuration for a specific widget within a page layout. Use this after cplace_get_page_layout_overview to examine specific widget configurations.",
@@ -57,7 +106,9 @@ export const WIDGET_TOOL_DEFINITIONS = {
         annotations: { title: "Get Embedded Layout" }
     },
     [TOOL_ADD_WIDGET_TO_EMBEDDED_LAYOUT]: {
-        description: "Add widget to page or type embedded layout. Enables adding widgets to nested layouts like those within AttributesGroup widgets.",
+        description: `Add widget to page or type embedded layout. Enables adding widgets to nested layouts like those within AttributesGroup widgets.
+
+⚠️ APP DEPENDENCY: Verify the widget's requiredApp is installed in the workspace using cplace_list_workspace_apps before adding. Widgets with uninstalled requiredApp will fail.`,
         inputSchema: {
             context: z.union([
                 z.object({
@@ -106,24 +157,30 @@ export const WIDGET_TOOL_DEFINITIONS = {
     }
 };
 export function registerWidgetTools(server, client) {
-    const WIDGET_ATTRIBUTE_ENHANCEMENTS = {
-        'cf.cplace.platform.attributesGroup': {
-            'cf.cplace.platform.attributesGroup.pageSelection': {
-                validValues: {
-                    'embedding': 'Use the current embedding page (the page containing this widget)',
-                    'parent': 'Use the parent page of the embedding page',
-                    'absolute': 'Use an absolute page reference (requires cf.cplace.platform.attributesGroup.absoluteSelection)',
-                    'relative': 'Use a relative reference through an attribute (requires cf.cplace.platform.attributesGroup.relativeSelection)'
-                },
-                defaultValue: 'embedding',
-                note: 'This attribute determines which page\'s attributes are displayed in the widget'
-            }
-        },
-    };
-    server.registerTool(TOOL_LIST_WIDGET_DEFINITIONS, WIDGET_TOOL_DEFINITIONS[TOOL_LIST_WIDGET_DEFINITIONS], async ({ embeddingContext = "AS_WIDGET" }) => {
-        debugLogWithTag('WIDGETS', `Starting widget definitions list request with embeddingContext: ${embeddingContext}`);
+    server.registerTool(TOOL_LIST_WIDGET_DEFINITIONS, WIDGET_TOOL_DEFINITIONS[TOOL_LIST_WIDGET_DEFINITIONS], async ({ embeddingContext = "AS_WIDGET", tags }) => {
+        debugLogWithTag('WIDGETS', `Starting widget definitions list request with embeddingContext: ${embeddingContext}${tags?.length ? `, tags: ${tags.join(', ')}` : ''}`);
         try {
             const result = await client.makeApiRequest('json/widget-definitions', 'GET', { embeddingContext });
+            if (result && typeof result === 'object' && Array.isArray(result.widgetDefinitions)) {
+                result.widgetDefinitions.forEach((widget) => {
+                    const widgetSpecs = WIDGET_SPECIFICATIONS[widget.widgetKind];
+                    if (widgetSpecs?.['_summary']) {
+                        widget.summary = widgetSpecs['_summary'];
+                    }
+                    if (widgetSpecs?._meta?.requiredApp !== undefined) {
+                        widget.requiredApp = widgetSpecs._meta.requiredApp;
+                    }
+                });
+                debugLogWithTag('WIDGETS', `Enriched ${result.widgetDefinitions.filter((w) => w.summary).length} widgets with summaries`);
+            }
+            if (tags?.length && result.widgetDefinitions) {
+                result.widgetDefinitions = result.widgetDefinitions.filter((widget) => {
+                    const widgetSpecs = WIDGET_SPECIFICATIONS[widget.widgetKind];
+                    const widgetTags = widgetSpecs?._meta?.tags || [];
+                    return tags.some(tag => widgetTags.includes(tag));
+                });
+                debugLogWithTag('WIDGETS', `Filtered to ${result.widgetDefinitions.length} widgets matching tags: ${tags.join(', ')}`);
+            }
             debugLogWithTag('WIDGETS', `Retrieved widget definitions for context: ${embeddingContext}`);
             return {
                 content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
@@ -139,34 +196,60 @@ export function registerWidgetTools(server, client) {
             };
         }
     });
-    server.registerTool(TOOL_GET_WIDGET_DEFINITION, WIDGET_TOOL_DEFINITIONS[TOOL_GET_WIDGET_DEFINITION], async ({ widgetKind }) => {
-        debugLogWithTag('WIDGETS', `Starting widget definition request for: ${widgetKind}`);
+    server.registerTool(TOOL_GET_WIDGET_DEFINITION, WIDGET_TOOL_DEFINITIONS[TOOL_GET_WIDGET_DEFINITION], async ({ widgetKinds, includeOverview = false, includeDetails = false }) => {
+        debugLogWithTag('WIDGETS', `Starting widget definition request for: ${widgetKinds.join(', ')} (includeOverview: ${includeOverview}, includeDetails: ${includeDetails})`);
         try {
-            const result = await client.makeApiRequest('json/widget-definition', 'GET', { widgetKind });
-            if (result && result.configurationSchema && result.configurationSchema.attributes) {
-                result.configurationSchema.attributes = transformMultiplicityToBoolean(result.configurationSchema.attributes);
-                const widgetEnhancements = WIDGET_ATTRIBUTE_ENHANCEMENTS[widgetKind];
-                if (widgetEnhancements) {
-                    result.configurationSchema.attributes = result.configurationSchema.attributes.map((attr) => {
-                        const enhancement = widgetEnhancements[attr.name];
-                        if (enhancement) {
-                            attr.hiddenKnowledge = enhancement;
-                            debugLogWithTag('WIDGETS', `Enhanced attribute ${attr.name} with hidden knowledge`);
+            const results = await Promise.all(widgetKinds.map(async (widgetKind) => {
+                try {
+                    const result = await client.makeApiRequest('json/widget-definition', 'GET', { widgetKind });
+                    const widgetSpecs = WIDGET_SPECIFICATIONS[widgetKind];
+                    const response = {
+                        widgetKind: result.widgetKind,
+                        localizedName: result.localizedName,
+                        summary: widgetSpecs?.['_summary'] ?? null
+                    };
+                    if (includeOverview) {
+                        response.overview = widgetSpecs?.['_overview'] ?? null;
+                    }
+                    if (includeDetails) {
+                        let attributes = result.configurationSchema?.attributes || [];
+                        attributes = transformMultiplicityToBoolean(attributes);
+                        if (widgetSpecs) {
+                            attributes = attributes.map((attr) => {
+                                const fullAttrName = `${widgetKind}.${attr.name}`;
+                                const specification = widgetSpecs[fullAttrName];
+                                if (specification && typeof specification === 'string') {
+                                    attr.specification = specification;
+                                }
+                                return attr;
+                            });
                         }
-                        return attr;
-                    });
+                        const implementation = widgetSpecs?.['_implementation'];
+                        if (implementation && typeof implementation === 'string') {
+                            response.implementation = implementation;
+                        }
+                        response.attributesCount = result.configurationSchema?.attributesCount;
+                        response.attributes = attributes;
+                    }
+                    return response;
                 }
-            }
-            debugLogWithTag('WIDGETS', `Retrieved widget definition for: ${widgetKind}`);
+                catch (error) {
+                    return {
+                        widgetKind,
+                        error: error instanceof Error ? error.message : String(error)
+                    };
+                }
+            }));
+            debugLogWithTag('WIDGETS', `Retrieved definitions for ${results.filter(r => !('error' in r)).length}/${widgetKinds.length} widgets`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }]
             };
         }
         catch (error) {
             return {
                 content: [{
                         type: "text",
-                        text: `Error retrieving widget definition for ${widgetKind}: ${error instanceof Error ? error.message : String(error)}`
+                        text: `Error retrieving widget definitions: ${error instanceof Error ? error.message : String(error)}`
                     }],
                 isError: true
             };