@cplace/mcp-server 1.9.0 → 1.9.1

package/dist/plugins/low-code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"low-code.d.ts","sourceRoot":"","sources":["../../src/plugins/low-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAkBpD,eAAO,MAAM,aAAa,EAAE,SAiB3B,CAAC"}
+{"version":3,"file":"low-code.d.ts","sourceRoot":"","sources":["../../src/plugins/low-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAmBpD,eAAO,MAAM,aAAa,EAAE,SAkB3B,CAAC"}

package/dist/plugins/low-code.js

@@ -9,6 +9,7 @@ import { registerLintingTools, LINTING_TOOL_DEFINITIONS } from '../tools/linting
 import { registerJobScriptsTools, JOB_SCRIPTS_TOOL_DEFINITIONS } from '../tools/job-scripts.js';
 import { registerJobScheduleTriggerTools, JOB_SCHEDULE_TRIGGER_TOOL_DEFINITIONS } from '../tools/job-schedule-trigger.js';
 import { registerWorkflowExecutionTools, WORKFLOW_EXECUTION_TOOL_DEFINITIONS } from '../tools/workflow-execution.js';
+import { registerWidgetSimulationTools, WIDGET_SIMULATION_TOOL_DEFINITIONS } from '../tools/widget-simulation.js';
 import { fileURLToPath } from 'url';
 import { dirname } from 'path';
 const __filename = fileURLToPath(import.meta.url);
@@ -29,6 +30,7 @@ export const lowCodePlugin = {
         'job-scripts': { register: registerJobScriptsTools, toolDefinitions: JOB_SCRIPTS_TOOL_DEFINITIONS },
         'job-schedule-trigger': { register: registerJobScheduleTriggerTools, toolDefinitions: JOB_SCHEDULE_TRIGGER_TOOL_DEFINITIONS },
         'workflow-execution': { register: registerWorkflowExecutionTools, toolDefinitions: WORKFLOW_EXECUTION_TOOL_DEFINITIONS },
+        'widget-simulation': { register: registerWidgetSimulationTools, toolDefinitions: WIDGET_SIMULATION_TOOL_DEFINITIONS },
     }
 };
 //# sourceMappingURL=low-code.js.map

package/dist/plugins/low-code.js.map

@@ -1 +1 @@
-{"version":3,"file":"low-code.js","sourceRoot":"","sources":["../../src/plugins/low-code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAC;AAC1H,OAAO,EAAE,8BAA8B,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAC;AACrH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,sGAAsG;IACnH,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,YAAY,EAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAY,eAAe,EAAE,0BAA0B,EAAE;QACnH,kBAAkB,EAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAO,eAAe,EAAE,gCAAgC,EAAE;QACzH,UAAU,EAAc,EAAE,QAAQ,EAAE,qBAAqB,EAAa,eAAe,EAAE,yBAAyB,EAAE;QAClH,kBAAkB,EAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAO,eAAe,EAAE,gCAAgC,EAAE;QACzH,aAAa,EAAW,EAAE,QAAQ,EAAE,uBAAuB,EAAW,eAAe,EAAE,4BAA4B,EAAE;QACrH,QAAQ,EAAgB,EAAE,QAAQ,EAAE,mBAAmB,EAAe,eAAe,EAAE,uBAAuB,EAAE;QAChH,SAAS,EAAe,EAAE,QAAQ,EAAE,oBAAoB,EAAc,eAAe,EAAE,wBAAwB,EAAE;QACjH,aAAa,EAAW,EAAE,QAAQ,EAAE,uBAAuB,EAAW,eAAe,EAAE,4BAA4B,EAAE;QACrH,sBAAsB,EAAE,EAAE,QAAQ,EAAE,+BAA+B,EAAG,eAAe,EAAE,qCAAqC,EAAE;QAC9H,oBAAoB,EAAI,EAAE,QAAQ,EAAE,8BAA8B,EAAG,eAAe,EAAE,mCAAmC,EAAE;KAC5H;CACF,CAAC"}
+{"version":3,"file":"low-code.js","sourceRoot":"","sources":["../../src/plugins/low-code.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAC5F,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACxF,OAAO,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,8BAA8B,CAAC;AAC7G,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,qCAAqC,EAAE,MAAM,kCAAkC,CAAC;AAC1H,OAAO,EAAE,8BAA8B,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAC;AACrH,OAAO,EAAE,6BAA6B,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AAClH,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;AAEtC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,cAAc;IACvB,WAAW,EAAE,sGAAsG;IACnH,UAAU,EAAE,SAAS;IACrB,OAAO,EAAE;QACP,YAAY,EAAY,EAAE,QAAQ,EAAE,sBAAsB,EAAY,eAAe,EAAE,0BAA0B,EAAE;QACnH,kBAAkB,EAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAO,eAAe,EAAE,gCAAgC,EAAE;QACzH,UAAU,EAAc,EAAE,QAAQ,EAAE,qBAAqB,EAAa,eAAe,EAAE,yBAAyB,EAAE;QAClH,kBAAkB,EAAM,EAAE,QAAQ,EAAE,2BAA2B,EAAO,eAAe,EAAE,gCAAgC,EAAE;QACzH,aAAa,EAAW,EAAE,QAAQ,EAAE,uBAAuB,EAAW,eAAe,EAAE,4BAA4B,EAAE;QACrH,QAAQ,EAAgB,EAAE,QAAQ,EAAE,mBAAmB,EAAe,eAAe,EAAE,uBAAuB,EAAE;QAChH,SAAS,EAAe,EAAE,QAAQ,EAAE,oBAAoB,EAAc,eAAe,EAAE,wBAAwB,EAAE;QACjH,aAAa,EAAW,EAAE,QAAQ,EAAE,uBAAuB,EAAW,eAAe,EAAE,4BAA4B,EAAE;QACrH,sBAAsB,EAAE,EAAE,QAAQ,EAAE,+BAA+B,EAAG,eAAe,EAAE,qCAAqC,EAAE;QAC9H,oBAAoB,EAAI,EAAE,QAAQ,EAAE,8BAA8B,EAAG,eAAe,EAAE,mCAAmC,EAAE;QAC3H,mBAAmB,EAAI,EAAE,QAAQ,EAAE,6BAA6B,EAAI,eAAe,EAAE,kCAAkC,EAAE;KAC1H;CACF,CAAC"}

package/dist/tools/widget-simulation.d.ts

@@ -0,0 +1,19 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const WIDGET_SIMULATION_TOOL_DEFINITIONS: {
+    readonly cplace_simulate_widget_script: {
+        readonly description: "Execute a widget script with real widget-runtime bindings for simulation.\n\nUnlike cplace_execute_script which runs scripts with only baseline bindings, this tool injects\nthe same bindings that the real widget runtime provides — most importantly `pages` as a\nSafeLazyIterable (not a plain Array). This catches binding-shape bugs (e.g., using .length or\nindex access on pages) that would otherwise only surface at widget render time.\n\n**Mode**: Read-only — matches real widget runtime (widgets cannot modify data)\n**Timeout**: 30 seconds maximum execution time\n\n**Injected Bindings** (beyond baseline cplace/Search/Filters):\n- `pages` — SafeLazyIterable<WrappedPage> from the search specified by typeName/workspaceId\n- `embeddingPage` — WrappedPage (if embeddingPageUid provided)\n\n**Return Value Restrictions**: Same as cplace_execute_script (primitives, flat arrays/objects only)\n\n**When to use**: For simulating widget scripts (scriptingHighcharts, scriptingLineChart, lowCodeText,\nlowCodeButton, dynamicCodeBlockWidget) before embedding them in layouts. Use cplace_execute_script\nfor non-widget simulation (wizard harnesses, workflow conditions, distribution probes).";
+        readonly inputSchema: {
+            readonly script: z.ZodString;
+            readonly typeName: z.ZodString;
+            readonly workspaceId: z.ZodOptional<z.ZodString>;
+            readonly embeddingPageUid: z.ZodOptional<z.ZodString>;
+        };
+        readonly annotations: {
+            readonly title: "Simulate Widget Script";
+        };
+    };
+};
+export declare function registerWidgetSimulationTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=widget-simulation.d.ts.map

package/dist/tools/widget-simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-simulation.d.ts","sourceRoot":"","sources":["../../src/tools/widget-simulation.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;AAO5C,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;CAiCrC,CAAC;AAEX,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA8CvF"}

package/dist/tools/widget-simulation.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+import { CPLACEJS_COMMON_API_CHEAT_SHEET } from "./common-schemas.js";
+const TOOL_SIMULATE_WIDGET_SCRIPT = 'cplace_simulate_widget_script';
+export const WIDGET_SIMULATION_TOOL_DEFINITIONS = {
+    [TOOL_SIMULATE_WIDGET_SCRIPT]: {
+        description: `Execute a widget script with real widget-runtime bindings for simulation.
+
+Unlike cplace_execute_script which runs scripts with only baseline bindings, this tool injects
+the same bindings that the real widget runtime provides — most importantly \`pages\` as a
+SafeLazyIterable (not a plain Array). This catches binding-shape bugs (e.g., using .length or
+index access on pages) that would otherwise only surface at widget render time.
+
+**Mode**: Read-only — matches real widget runtime (widgets cannot modify data)
+**Timeout**: 30 seconds maximum execution time
+
+**Injected Bindings** (beyond baseline cplace/Search/Filters):
+- \`pages\` — SafeLazyIterable<WrappedPage> from the search specified by typeName/workspaceId
+- \`embeddingPage\` — WrappedPage (if embeddingPageUid provided)
+
+**Return Value Restrictions**: Same as cplace_execute_script (primitives, flat arrays/objects only)
+
+**When to use**: For simulating widget scripts (scriptingHighcharts, scriptingLineChart, lowCodeText,
+lowCodeButton, dynamicCodeBlockWidget) before embedding them in layouts. Use cplace_execute_script
+for non-widget simulation (wizard harnesses, workflow conditions, distribution probes).`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute. The script receives \`pages\` as an injected binding
+(SafeLazyIterable, not a plain Array). Iterate with cplace.each(pages, fn) or pages.forEach(fn).
+Do NOT use pages.length, pages[i], or Array.from(pages) — these will fail, matching real widget runtime.
+
+Must return a JSON-serializable value.` + CPLACEJS_COMMON_API_CHEAT_SHEET),
+            typeName: z.string().describe("Type internal name for the pages search (e.g., 'cf.cplace.project.Task')"),
+            workspaceId: z.string().optional().describe("Workspace ID to scope the pages search (optional)"),
+            embeddingPageUid: z.string().optional().describe("Page UID to inject as embeddingPage binding (optional)")
+        },
+        annotations: { title: "Simulate Widget Script" }
+    }
+};
+export function registerWidgetSimulationTools(server, client) {
+    server.registerTool(TOOL_SIMULATE_WIDGET_SCRIPT, WIDGET_SIMULATION_TOOL_DEFINITIONS[TOOL_SIMULATE_WIDGET_SCRIPT], async ({ script, typeName, workspaceId, embeddingPageUid }) => {
+        debugLogWithTag('WIDGET_SIM', `Simulating widget script (${script.length} chars) for type ${typeName}`);
+        try {
+            const requestBody = { script, typeName };
+            if (workspaceId)
+                requestBody.workspaceId = workspaceId;
+            if (embeddingPageUid)
+                requestBody.embeddingPageUid = embeddingPageUid;
+            const response = await client.makeApiRequest('json/widget/simulateScript', 'POST', undefined, requestBody);
+            const result = { result: response };
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('WIDGET_SIM', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Widget simulation result too large (${sizeCheck.actualSize} characters). Modify your script to return less data.`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('WIDGET_SIM', 'Widget script simulated successfully');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('WIDGET_SIM', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error simulating widget script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=widget-simulation.js.map

package/dist/tools/widget-simulation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cplace/mcp-server",
-  "version": "1.9.0",
+  "version": "1.9.1",
   "description": "MCP server that provides Claude Desktop with tools to interact with cplace APIs",
   "main": "dist/public-api.js",
   "types": "dist/public-api.d.ts",