@cplace/mcp-server 1.9.0 → 1.10.5

package/dist/tools/version-check.js

@@ -21,7 +21,7 @@ export function registerVersionCheckTool(server, client) {
     server.registerTool(TOOL_CHECK_VERSION_COMPATIBILITY, {
         description: "Check version compatibility between this MCP server package and the cplace backend API. Compares the npm package version (package.json) with the backend's expected version to detect mismatches. Returns compatibility status and provides guidance on whether to upgrade/downgrade the MCP server or upgrade the backend to resolve version mismatches.",
         inputSchema: {},
-        annotations: { title: "Check Version Compatibility" }
+        annotations: { title: 'Check Version Compatibility' },
     }, async () => {
         try {
             const backendResponse = await client.makeApiRequest('json/version', 'GET');
@@ -29,18 +29,20 @@ export function registerVersionCheckTool(server, client) {
             const isCompatible = semver.satisfies(FRONTEND_VERSION, backendExpectedVersion);
             if (isCompatible) {
                 return {
-                    content: [{
-                            type: "text",
+                    content: [
+                        {
+                            type: 'text',
                             text: JSON.stringify({
-                                status: "compatible",
-                                message: "✅ Package version matches backend expectations",
+                                status: 'compatible',
+                                message: '✅ Package version matches backend expectations',
                                 details: {
                                     frontendPackageVersion: FRONTEND_VERSION,
                                     backendExpectedVersion: backendExpectedVersion,
-                                    packageName: "@cplace/mcp-server"
-                                }
-                            }, null, 2)
-                        }]
+                                    packageName: '@cplace/mcp-server',
+                                },
+                            }, null, 2),
+                        },
+                    ],
                 };
             }
             else {
@@ -48,47 +50,51 @@ export function registerVersionCheckTool(server, client) {
                 const isBelowRange = minVersion && semver.lt(FRONTEND_VERSION, minVersion.version);
                 const guidance = isBelowRange
                     ? {
-                        action: "MCP SERVER UPGRADE NEEDED",
+                        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/mcp-server@${minVersion?.version} or later.`,
-                        explanation: `Backend accepts versions matching: ${backendExpectedVersion}. Your version ${FRONTEND_VERSION} is below the minimum required.`
+                        explanation: `Backend accepts versions matching: ${backendExpectedVersion}. Your version ${FRONTEND_VERSION} is below the minimum required.`,
                     }
                     : {
-                        action: "MCP SERVER DOWNGRADE OR BACKEND UPGRADE NEEDED",
+                        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.`
+                        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: [{
-                            type: "text",
+                    content: [
+                        {
+                            type: 'text',
                             text: JSON.stringify({
-                                status: "mismatch",
-                                message: "⚠️ VERSION MISMATCH DETECTED",
+                                status: 'mismatch',
+                                message: '⚠️ VERSION MISMATCH DETECTED',
                                 details: {
                                     frontendPackageVersion: FRONTEND_VERSION,
                                     backendExpectedVersion: backendExpectedVersion,
-                                    packageName: "@cplace/mcp-server"
+                                    packageName: '@cplace/mcp-server',
                                 },
-                                ...guidance
-                            }, null, 2)
-                        }],
-                    isError: true
+                                ...guidance,
+                            }, null, 2),
+                        },
+                    ],
+                    isError: true,
                 };
             }
         }
         catch (error) {
             return {
-                content: [{
-                        type: "text",
+                content: [
+                    {
+                        type: 'text',
                         text: JSON.stringify({
-                            status: "error",
-                            message: "❌ Unable to check version compatibility",
+                            status: 'error',
+                            message: '❌ Unable to check version compatibility',
                             reason: error instanceof Error ? error.message : String(error),
-                            suggestion: "Ensure backend endpoint 'json/version' is available. This may indicate the backend needs to be upgraded to support version checking."
-                        }, null, 2)
-                    }],
-                isError: true
+                            suggestion: "Ensure backend endpoint 'json/version' is available. This may indicate the backend needs to be upgraded to support version checking.",
+                        }, null, 2),
+                    },
+                ],
+                isError: true,
             };
         }
     });

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/version-history.d.ts

@@ -1,5 +1,5 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { z } from "zod";
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
 import { CplaceApiClient } from '../api.js';
 export declare const VERSION_HISTORY_TOOL_DEFINITIONS: {
     readonly cplace_get_page_changesets: {

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

@@ -1 +1 @@
-{"version":3,"file":"version-history.d.ts","sourceRoot":"","sources":["../../src/tools/version-history.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;AAW5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqJrF"}
+{"version":3,"file":"version-history.d.ts","sourceRoot":"","sources":["../../src/tools/version-history.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;AAW5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6DnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA4NrF"}

package/dist/tools/version-history.js

@@ -1,5 +1,5 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
 import { coerceNumber } from './common-schemas.js';
 const TOOL_GET_PAGE_CHANGESETS = 'cplace_get_page_changesets';
 const TOOL_GET_PAGE_STATE_AT_TIMESTAMP = 'cplace_get_page_state_at_timestamp';
@@ -7,42 +7,53 @@ const TOOL_GET_PAGE_DIFF = 'cplace_get_page_diff';
 const TOOL_GET_PAGE_CHANGESETS_SUMMARY = 'cplace_get_page_changesets_summary';
 export const VERSION_HISTORY_TOOL_DEFINITIONS = {
     [TOOL_GET_PAGE_CHANGESETS]: {
-        description: "Get all changesets (modification records) for a specific page within an optional time range. Returns changes in reverse chronological order. RichString values in changes appear in decoded form (`<decoded-widget>` tags) — no base64.",
+        description: 'Get all changesets (modification records) for a specific page within an optional time range. Returns changes in reverse chronological order. RichString values in changes appear in decoded form (`<decoded-widget>` tags) — no base64.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to get changesets for"),
-            fromTimestamp: z.number().optional().describe("Optional start time in milliseconds since Unix epoch (inclusive)"),
-            toTimestamp: z.number().optional().describe("Optional end time in milliseconds since Unix epoch (inclusive)"),
-            offset: coerceNumber(z.number().optional()).describe("Pagination offset (default: 0)"),
-            limit: coerceNumber(z.number().max(1000).optional()).describe("Maximum number of results (default: 100, max: 1000)")
+            pageUID: z.string().describe('The unique identifier (UID) of the page to get changesets for'),
+            fromTimestamp: z
+                .number()
+                .optional()
+                .describe('Optional start time in milliseconds since Unix epoch (inclusive)'),
+            toTimestamp: z
+                .number()
+                .optional()
+                .describe('Optional end time in milliseconds since Unix epoch (inclusive)'),
+            offset: coerceNumber(z.number().optional()).describe('Pagination offset (default: 0)'),
+            limit: coerceNumber(z.number().max(1000).optional()).describe('Maximum number of results (default: 100, max: 1000)'),
         },
-        annotations: { title: "Get Page ChangeSets" }
+        annotations: { title: 'Get Page ChangeSets' },
     },
     [TOOL_GET_PAGE_STATE_AT_TIMESTAMP]: {
-        description: "Reconstruct and return the complete state of a page as it was at a specific point in time. RichString attributes appear in decoded form (`<decoded-widget>` tags) — no base64.",
+        description: 'Reconstruct and return the complete state of a page as it was at a specific point in time. RichString attributes appear in decoded form (`<decoded-widget>` tags) — no base64.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to get historical state for"),
-            timestamp: z.number().describe("Target timestamp in milliseconds since Unix epoch")
+            pageUID: z
+                .string()
+                .describe('The unique identifier (UID) of the page to get historical state for'),
+            timestamp: z.number().describe('Target timestamp in milliseconds since Unix epoch'),
         },
-        annotations: { title: "Get Page State at Timestamp" }
+        annotations: { title: 'Get Page State at Timestamp' },
     },
     [TOOL_GET_PAGE_DIFF]: {
-        description: "Compare page states between two timestamps and return the differences. If toTimestamp is not provided, compares with current state. RichString values in diffs appear in decoded form (`<decoded-widget>` tags) — no base64.",
+        description: 'Compare page states between two timestamps and return the differences. If toTimestamp is not provided, compares with current state. RichString values in diffs appear in decoded form (`<decoded-widget>` tags) — no base64.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to compare"),
-            fromTimestamp: z.number().describe("Starting timestamp in milliseconds since Unix epoch"),
-            toTimestamp: z.number().optional().describe("Optional ending timestamp in milliseconds since Unix epoch (defaults to current state)")
+            pageUID: z.string().describe('The unique identifier (UID) of the page to compare'),
+            fromTimestamp: z.number().describe('Starting timestamp in milliseconds since Unix epoch'),
+            toTimestamp: z
+                .number()
+                .optional()
+                .describe('Optional ending timestamp in milliseconds since Unix epoch (defaults to current state)'),
         },
-        annotations: { title: "Get Page Diff" }
+        annotations: { title: 'Get Page Diff' },
     },
     [TOOL_GET_PAGE_CHANGESETS_SUMMARY]: {
-        description: "Get a summary of recent changes for a page. This is a convenience tool that retrieves changesets for the last 7 days by default. RichString values in changes appear in decoded form (`<decoded-widget>` tags) — no base64.",
+        description: 'Get a summary of recent changes for a page. This is a convenience tool that retrieves changesets for the last 7 days by default. RichString values in changes appear in decoded form (`<decoded-widget>` tags) — no base64.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to get changes for"),
-            daysBack: coerceNumber(z.number().optional()).describe("Number of days to look back (default: 7)"),
-            limit: coerceNumber(z.number().max(1000).optional()).describe("Maximum number of changesets to return (default: 50)")
+            pageUID: z.string().describe('The unique identifier (UID) of the page to get changes for'),
+            daysBack: coerceNumber(z.number().optional()).describe('Number of days to look back (default: 7)'),
+            limit: coerceNumber(z.number().max(1000).optional()).describe('Maximum number of changesets to return (default: 50)'),
         },
-        annotations: { title: "Get Page Recent Changes Summary" }
-    }
+        annotations: { title: 'Get Page Recent Changes Summary' },
+    },
 };
 export function registerVersionHistoryTools(server, client) {
     server.registerTool(TOOL_GET_PAGE_CHANGESETS, VERSION_HISTORY_TOOL_DEFINITIONS[TOOL_GET_PAGE_CHANGESETS], async ({ pageUID, fromTimestamp, toTimestamp, offset, limit }) => {
@@ -51,7 +62,7 @@ export function registerVersionHistoryTools(server, client) {
             const requestBody = {
                 pageUID,
                 offset: offset || 0,
-                limit: limit || 100
+                limit: limit || 100,
             };
             if (fromTimestamp !== undefined) {
                 requestBody.fromTimestamp = fromTimestamp;
@@ -65,14 +76,19 @@ export function registerVersionHistoryTools(server, client) {
             const result = await client.makeApiRequest('json/page/changesets', 'POST', undefined, requestBody);
             debugLogWithTag('PAGE_CHANGESETS', `Successfully retrieved changesets for page: ${pageUID}`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('PAGE_CHANGESETS', `Error retrieving changesets: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error retrieving changesets: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving changesets: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -81,20 +97,25 @@ export function registerVersionHistoryTools(server, client) {
         try {
             const requestBody = {
                 pageUID,
-                timestamp
+                timestamp,
             };
             debugLogWithTag('PAGE_STATE', `Request body: ${JSON.stringify(requestBody, null, 2)}`);
             const result = await client.makeApiRequest('json/page/state', 'POST', undefined, requestBody);
             debugLogWithTag('PAGE_STATE', `Successfully retrieved page state at timestamp ${timestamp}`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('PAGE_STATE', `Error retrieving page state: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error retrieving page state: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving page state: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -103,7 +124,7 @@ export function registerVersionHistoryTools(server, client) {
         try {
             const requestBody = {
                 pageUID,
-                fromTimestamp
+                fromTimestamp,
             };
             if (toTimestamp !== undefined) {
                 requestBody.toTimestamp = toTimestamp;
@@ -113,14 +134,19 @@ export function registerVersionHistoryTools(server, client) {
             const result = await client.makeApiRequest('json/page/diff', 'POST', undefined, requestBody);
             debugLogWithTag('PAGE_DIFF', `Successfully retrieved page diff`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('PAGE_DIFF', `Error retrieving page diff: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error retrieving page diff: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving page diff: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -130,26 +156,31 @@ export function registerVersionHistoryTools(server, client) {
         debugLogWithTag('PAGE_CHANGES_SUMMARY', `Getting recent changes for page ${pageUID} (last ${effectiveDaysBack} days)`);
         try {
             const toTimestamp = Date.now();
-            const fromTimestamp = toTimestamp - (effectiveDaysBack * 24 * 60 * 60 * 1000);
+            const fromTimestamp = toTimestamp - effectiveDaysBack * 24 * 60 * 60 * 1000;
             const requestBody = {
                 pageUID,
                 fromTimestamp,
                 toTimestamp,
                 offset: 0,
-                limit: effectiveLimit
+                limit: effectiveLimit,
             };
             debugLogWithTag('PAGE_CHANGES_SUMMARY', `Request body: ${JSON.stringify(requestBody, null, 2)}`);
             const result = await client.makeApiRequest('json/page/changesets', 'POST', undefined, requestBody);
             debugLogWithTag('PAGE_CHANGES_SUMMARY', `Successfully retrieved recent changes summary`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('PAGE_CHANGES_SUMMARY', `Error retrieving changes summary: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error retrieving changes summary: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving changes summary: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });

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

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

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

@@ -0,0 +1,18 @@
+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 under the production widget engine context for pre-embed verification.\n\nThis tool mirrors the engine row used by the real widget runtime\n(`evaluateShowAttributeScript` in cplace platform). The bindings, allowed type\nclasses, and read-only posture come from the platform source row — see\n`script-context-cards/widget.md` and `best-practices/low-code/script-contexts.md`.\n\n**Mode**: Read-only — widgets cannot modify data\n**Timeout**: 30 seconds maximum execution time\n\n**Injected bindings** (in addition to the baseline cplace API):\n- `embeddingPage` — WrappedPage hosting the layout this widget renders into\n- `targetEntity` — WrappedPage of the entity the widget is rendered for\n\n**No `pages` binding.** The widget runtime does not inject a pages iterable.\nIf your script needs an iterable of pages, construct one explicitly:\n\n  new Search()\n    .setEmbeddingEntity(embeddingPage)\n    .add(Filters.embeddingSpace())\n    .add(Filters.type('cf.myapp.task'))\n    .findAllPages()\n    .forEach(p => /* ... */)\n\n**Allowed type classes**: `Search`, `Filters` (lowcode wrapper classes).\n\n**Return Value Restrictions**: Same as cplace_execute_script (primitives, flat arrays/objects only).\n\n**When to use**: Before embedding any widget script (scriptingHighcharts, scriptingLineChart,\nlowCodeText, lowCodeButton row variants, dynamicCodeBlockWidget). For other contexts (page\nactions, change listeners, validators, jobs, wizards, button widgets) use the matching\n`cplace_simulate_*` tool — never `cplace_execute_script_write` for context-specific scripts.";
+        readonly inputSchema: {
+            readonly script: z.ZodString;
+            readonly embeddingPageUid: z.ZodString;
+            readonly targetEntityUid: 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;;;;;;;;;;;;CAoDrC,CAAC;AAEX,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAyDvF"}

package/dist/tools/widget-simulation.js

@@ -0,0 +1,94 @@
+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 under the production widget engine context for pre-embed verification.
+
+This tool mirrors the engine row used by the real widget runtime
+(\`evaluateShowAttributeScript\` in cplace platform). The bindings, allowed type
+classes, and read-only posture come from the platform source row — see
+\`script-context-cards/widget.md\` and \`best-practices/low-code/script-contexts.md\`.
+
+**Mode**: Read-only — widgets cannot modify data
+**Timeout**: 30 seconds maximum execution time
+
+**Injected bindings** (in addition to the baseline cplace API):
+- \`embeddingPage\` — WrappedPage hosting the layout this widget renders into
+- \`targetEntity\` — WrappedPage of the entity the widget is rendered for
+
+**No \`pages\` binding.** The widget runtime does not inject a pages iterable.
+If your script needs an iterable of pages, construct one explicitly:
+
+  new Search()
+    .setEmbeddingEntity(embeddingPage)
+    .add(Filters.embeddingSpace())
+    .add(Filters.type('cf.myapp.task'))
+    .findAllPages()
+    .forEach(p => /* ... */)
+
+**Allowed type classes**: \`Search\`, \`Filters\` (lowcode wrapper classes).
+
+**Return Value Restrictions**: Same as cplace_execute_script (primitives, flat arrays/objects only).
+
+**When to use**: Before embedding any widget script (scriptingHighcharts, scriptingLineChart,
+lowCodeText, lowCodeButton row variants, dynamicCodeBlockWidget). For other contexts (page
+actions, change listeners, validators, jobs, wizards, button widgets) use the matching
+\`cplace_simulate_*\` tool — never \`cplace_execute_script_write\` for context-specific scripts.`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute. Bindings: \`embeddingPage\`, \`targetEntity\` (both WrappedPage).
+There is NO \`pages\` binding — construct your own \`new Search()\` (e.g. \`new Search().setEmbeddingEntity(embeddingPage)\`).
+Allowed type classes: Search, Filters. Must return a JSON-serializable value.` +
+                CPLACEJS_COMMON_API_CHEAT_SHEET),
+            embeddingPageUid: z
+                .string()
+                .describe('Page UID hosting the layout (bound as `embeddingPage`). Required.'),
+            targetEntityUid: z
+                .string()
+                .describe('Page UID of the entity the widget renders for (bound as `targetEntity`). Required.'),
+        },
+        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, embeddingPageUid, targetEntityUid }) => {
+        debugLogWithTag('WIDGET_SIM', `Simulating widget script (${script.length} chars) embeddingPage=${embeddingPageUid} targetEntity=${targetEntityUid}`);
+        try {
+            const requestBody = { script, embeddingPageUid, targetEntityUid };
+            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":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAC;AAEtE,MAAM,2BAA2B,GAAG,+BAA+B,CAAC;AAEpE,MAAM,CAAC,MAAM,kCAAkC,GAAG;IAChD,CAAC,2BAA2B,CAAC,EAAE;QAC7B,WAAW,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iGA+BgF;QAC7F,WAAW,EAAE;YACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACzB;;8EAEsE;gBACpE,+BAA+B,CAClC;YACD,gBAAgB,EAAE,CAAC;iBAChB,MAAM,EAAE;iBACR,QAAQ,CAAC,mEAAmE,CAAC;YAChF,eAAe,EAAE,CAAC;iBACf,MAAM,EAAE;iBACR,QAAQ,CACP,oFAAoF,CACrF;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE;KACjD;CACO,CAAC;AAEX,MAAM,UAAU,6BAA6B,CAAC,MAAiB,EAAE,MAAuB;IACtF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B,kCAAkC,CAAC,2BAA2B,CAAC,EAC/D,KAAK,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,EAAE,EAAE;QACtD,eAAe,CACb,YAAY,EACZ,6BAA6B,MAAM,CAAC,MAAM,yBAAyB,gBAAgB,iBAAiB,eAAe,EAAE,CACtH,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,WAAW,GAA2B,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,EAAE,CAAC;YAE1F,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAC1C,4BAA4B,EAC5B,MAAM,EACN,SAAS,EACT,WAAW,CACZ,CAAC;YAEF,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;YAEpC,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,eAAe,CAAC,YAAY,EAAE,uBAAuB,SAAS,CAAC,UAAU,aAAa,CAAC,CAAC;gBACxF,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,uCAAuC,SAAS,CAAC,UAAU,uDAAuD;yBACzH;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,eAAe,CAAC,YAAY,EAAE,sCAAsC,CAAC,CAAC;YACtE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CACb,YAAY,EACZ,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAClG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/widget-tool-helpers.d.ts

@@ -1,5 +1,21 @@
-import { z } from "zod";
+import { z } from 'zod';
 import { LayoutContextSchema } from './layout.js';
+export interface WidgetIdEntry {
+    widgetId: string;
+    widgetType: string;
+    row: number;
+    column: number;
+    parentWidgetId?: string;
+}
+export declare function extractWidgetIdSummary(rows: any[], parentWidgetId?: string): WidgetIdEntry[];
+export declare function buildStaleIdErrorText(widgetId: string, contextType: string): string;
+export declare function buildStaleIdErrorResponse(widgetId: string, contextType: string): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+};
 export declare function determineApiEndpoint(context: z.infer<typeof LayoutContextSchema>): string;
 export declare function buildRequestParams(context: z.infer<typeof LayoutContextSchema>): any;
 export declare function buildUpdateRequestBody(context: z.infer<typeof LayoutContextSchema>, widgetId: string, newConfiguration: Record<string, any>): any;

package/dist/tools/widget-tool-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-tool-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/widget-tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAKlD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAEzF;AAKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,GAAG,CAUpF;AAKD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAC5C,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpC,GAAG,CASL;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAexE"}
+{"version":3,"file":"widget-tool-helpers.d.ts","sourceRoot":"","sources":["../../src/tools/widget-tool-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CAuB5F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;;;;;;EAK9E;AAKD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,MAAM,CAEzF;AAKD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,GAAG,GAAG,CAYpF;AAKD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,EAC5C,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACpC,GAAG,CASL;AAKD,wBAAgB,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CAexE"}

package/dist/tools/widget-tool-helpers.js

@@ -1,15 +1,50 @@
+export function extractWidgetIdSummary(rows, parentWidgetId) {
+    const entries = [];
+    for (const row of rows || []) {
+        const rowIndex = rows.indexOf(row);
+        for (const column of row.columns || []) {
+            const colIndex = row.columns.indexOf(column);
+            for (const widget of column.widgets || []) {
+                if (widget.id) {
+                    entries.push({
+                        widgetId: widget.id,
+                        widgetType: widget.widgetType,
+                        row: rowIndex,
+                        column: colIndex,
+                        ...(parentWidgetId && { parentWidgetId }),
+                    });
+                }
+                if (widget.widgetsLayout?.rows) {
+                    entries.push(...extractWidgetIdSummary(widget.widgetsLayout.rows, widget.id));
+                }
+            }
+        }
+    }
+    return entries;
+}
+export function buildStaleIdErrorText(widgetId, contextType) {
+    return `Widget with ID ${widgetId} not found in ${contextType} layout. Widget IDs are regenerated after every layout save — call cplace_get_layout_overview to get current IDs.`;
+}
+export function buildStaleIdErrorResponse(widgetId, contextType) {
+    return {
+        content: [{ type: 'text', text: buildStaleIdErrorText(widgetId, contextType) }],
+        isError: true,
+    };
+}
 export function determineApiEndpoint(context) {
-    return context.type === "page" ? "json/pageLayout" : "json/typeLayout";
+    return context.type === 'page' ? 'json/pageLayout' : 'json/typeLayout';
 }
 export function buildRequestParams(context) {
-    if (context.type === "page") {
+    if (context.type === 'page') {
         return { pageUID: context.pageUID };
     }
     else {
         return {
             workspaceId: context.workspaceId,
             typeInternalName: context.typeInternalName,
-            ...(context.alternativeLayoutName && { alternativeLayoutName: context.alternativeLayoutName })
+            ...(context.alternativeLayoutName && {
+                alternativeLayoutName: context.alternativeLayoutName,
+            }),
         };
     }
 }
@@ -17,10 +52,10 @@ export function buildUpdateRequestBody(context, widgetId, newConfiguration) {
     return {
         ...buildRequestParams(context),
         operation: {
-            type: "UPDATE",
+            type: 'UPDATE',
             widgetId,
-            newConfiguration
-        }
+            newConfiguration,
+        },
     };
 }
 export function findWidgetById(rows, widgetId) {