@cplace/mcp-server 1.9.0 → 1.10.5

package/dist/tools/layout-richstring-widgets.js

@@ -1,20 +1,144 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
 import { LayoutContextSchema } from './layout.js';
-import { findWidgetById, determineApiEndpoint, buildRequestParams } from './widget-tool-helpers.js';
-import { richstringExtractWidgets, buildContentMap } from './richstring-widgets.js';
-import { RICHSTRING_WIDGET_TYPES, extractStringConfigValue } from './layout-richstring-shared.js';
+import { findWidgetById, determineApiEndpoint, buildRequestParams, buildStaleIdErrorResponse, buildStaleIdErrorText, } from './widget-tool-helpers.js';
+import { RICHSTRING_WIDGET_TYPES, extractStringConfigValue, parseScriptEnvelope, parseDecodedRichStringContent, reassembleDecodedContent, } from './layout-richstring-shared.js';
+import { applyStrReplace } from '../str-replace-utils.js';
 const TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS = 'cplace_layout_richstring_extract_widgets';
+const TOOL_RICHSTRING_SET_WIDGET_SCRIPT = 'cplace_richstring_set_widget_script';
+const TOOL_RICHSTRING_EDIT_WIDGET_SCRIPT = 'cplace_richstring_edit_widget_script';
+const SET_WIDGET_SCRIPT_DESCRIPTION = `Replace the entire script body of a script-typed attribute on an embedded widget inside a layout-resident rich-string container. Reads the layout, modifies the target attribute, and writes back via a single layout.updateWidget call — atomic.
+
+Why this tool exists. When a rich-string widget (cf.platform.richString, cf.cplace.demoWidgets.demoRichString) is placed in a page or type layout via cplace_execute_layout_script, embedded widgets travel inline as <decoded-widget> tags. Authoring a script attribute inline forces it through four nested encoding layers (HTML → JSON → JS string literal → MCP wire). Use this tool instead: the script arrives as a plain string in a structured tool argument.
+
+Workflow.
+1. Place the rich-string container with embedded children via cplace_execute_layout_script, initializing each script attribute to a minimal placeholder body (e.g. return '';).
+2. Run cplace_layout_richstring_extract_widgets to discover embedded widget IDs.
+3. For each embedded widget, call this tool with the real script body.
+
+Known script-bearing embedded widget types and their attribute keys:
+- cf.cplace.lowCodeWidgets.lowCodeText → cf.cplace.lowCodeWidgets.lowCodeTextWidget.script
+- cf.cplace.lowCodeWidgets.lowCodeButton → cf.cplace.lowCodeWidgets.lowCodeButtonWidget.script
+- cf.cplace.visualizations.scriptingHighcharts → cf.cplace.visualization.script
+- cf.cplace.visualizations.scriptingLineChart → cf.cplace.visualization.script
+- cf.cplace.dynamicCodeBlockWidget.dynamicCodeBlockWidget → cf.cplace.dynamicCodeBlockWidget.script
+
+Passing a non-script attribute key writes the value as a string into that attribute (no guard) — verify the attribute key matches a script-typed attribute on the target widget type.`;
+const EDIT_WIDGET_SCRIPT_DESCRIPTION = `Apply a string-replacement edit to the script body of a script-typed attribute on an embedded widget inside a layout-resident rich-string container. oldString must match the current raw script body exactly once unless replaceAll is true. Atomic via a single layout.updateWidget call.
+
+Use this tool for iterative refinement of an already-set script body — small, focused diffs over the wire instead of resending the full script. Mirrors the contract of the file Edit tool: matches against the raw script body (the stored CplaceJsScript envelope is unwrapped server-side before matching), fails fast on zero or duplicate matches.
+
+Same target shape and constraints as cplace_richstring_set_widget_script — see that tool's description for the placeholder workflow, the list of script-bearing widget types, and the addressing model.`;
 export const LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS = {
     [TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS]: {
         description: "Extract all embedded widgets from a layout widget's richstring config. Returns structured inventory (IDs, types, properties) and a positional content map without loading the full layout script into context. Use this to discover widget IDs and positions before editing via cplace_edit_layout str_replace on decoded embedded-widget tags.\n\nSupported layout widget types: cf.platform.richString, cf.cplace.demoWidgets.demoRichString",
         inputSchema: {
             context: LayoutContextSchema,
-            widgetId: z.string().describe("The ID of the layout widget containing the richstring config (e.g., '_kpi1_open_cases')")
+            widgetId: z
+                .string()
+                .describe("The ID of the layout widget containing the richstring config (e.g., '_kpi1_open_cases')"),
         },
-        annotations: { title: "Extract Embedded Widgets from Layout Widget RichString" }
-    }
+        annotations: { title: 'Extract Embedded Widgets from Layout Widget RichString' },
+    },
+    [TOOL_RICHSTRING_SET_WIDGET_SCRIPT]: {
+        description: SET_WIDGET_SCRIPT_DESCRIPTION,
+        inputSchema: {
+            context: LayoutContextSchema,
+            containerWidgetId: z
+                .string()
+                .describe('ID of the layout widget that holds the rich-string. Must be cf.platform.richString or cf.cplace.demoWidgets.demoRichString.'),
+            embeddedWidgetId: z
+                .string()
+                .describe('ID of the embedded widget inside the rich-string whose script attribute will be replaced. Discover via cplace_layout_richstring_extract_widgets.'),
+            attributeKey: z
+                .string()
+                .describe('Fully-qualified attribute name of the script-typed attribute on the embedded widget (e.g. cf.cplace.lowCodeWidgets.lowCodeTextWidget.script).'),
+            script: z
+                .string()
+                .describe('New script body as plain JavaScript text. Delivered to the backend as a raw string; backend wraps it in the canonical CplaceJsScript envelope at the latest version.'),
+        },
+        annotations: { title: 'Set Embedded Widget Script in Layout RichString' },
+    },
+    [TOOL_RICHSTRING_EDIT_WIDGET_SCRIPT]: {
+        description: EDIT_WIDGET_SCRIPT_DESCRIPTION,
+        inputSchema: {
+            context: LayoutContextSchema,
+            containerWidgetId: z.string().describe('ID of the rich-string layout widget.'),
+            embeddedWidgetId: z
+                .string()
+                .describe('ID of the embedded widget whose script attribute will be edited.'),
+            attributeKey: z.string().describe('Fully-qualified script attribute name.'),
+            oldString: z
+                .string()
+                .describe('Exact substring to find in the current raw script body. Must match exactly once unless replaceAll is true.'),
+            newString: z
+                .string()
+                .describe('Replacement substring. Use empty string to delete oldString.'),
+            replaceAll: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('If true, replace all occurrences. If false, require exactly one match — fails on zero or multiple.'),
+        },
+        annotations: { title: 'Edit Embedded Widget Script in Layout RichString' },
+    },
 };
+async function loadScriptMutationContext(client, context, containerWidgetId, embeddedWidgetId) {
+    const endpoint = determineApiEndpoint(context);
+    const layoutResult = await client.makeApiRequest(endpoint, 'GET', buildRequestParams(context));
+    const containerWidget = findWidgetById(layoutResult.rows, containerWidgetId);
+    if (!containerWidget) {
+        return { ok: false, error: buildStaleIdErrorText(containerWidgetId, context.type) };
+    }
+    if (!RICHSTRING_WIDGET_TYPES.includes(containerWidget.widgetType)) {
+        return {
+            ok: false,
+            error: `Container widget '${containerWidgetId}' is type '${containerWidget.widgetType}'; expected one of: ${RICHSTRING_WIDGET_TYPES.join(', ')}`,
+        };
+    }
+    const rawContent = extractStringConfigValue(containerWidget.configuration, 'content');
+    const parsed = parseDecodedRichStringContent(rawContent);
+    const widgetsById = new Map();
+    for (const w of parsed.embeddedWidgets) {
+        widgetsById.set(w.widgetId, {
+            widgetId: w.widgetId,
+            widgetType: w.widgetType,
+            properties: { ...w.properties },
+        });
+    }
+    const contentMap = parsed.contentMap;
+    const targetWidget = widgetsById.get(embeddedWidgetId);
+    if (!targetWidget) {
+        return {
+            ok: false,
+            error: `Embedded widget '${embeddedWidgetId}' not found inside container '${containerWidgetId}'. Widget IDs are regenerated after every layout save — call cplace_get_layout_overview to get current IDs.`,
+        };
+    }
+    return { ok: true, ctx: { containerWidget, rawContent, contentMap, widgetsById, targetWidget } };
+}
+async function commitScriptMutation(client, context, containerWidgetId, ctx) {
+    const newContent = reassembleDecodedContent(ctx.contentMap, ctx.widgetsById);
+    const script = `layout.updateWidget(${JSON.stringify(containerWidgetId)}, { content: ${JSON.stringify(newContent)} });`;
+    const endpoint = context.type === 'page' ? 'json/page/layoutScript' : 'json/type/layoutScript';
+    const body = context.type === 'page'
+        ? { pageUID: context.pageUID, script }
+        : {
+            workspaceId: context.workspaceId,
+            typeInternalName: context.typeInternalName,
+            ...(context.alternativeLayoutName && {
+                alternativeLayoutName: context.alternativeLayoutName,
+            }),
+            script,
+        };
+    const raw = await client.makeRawApiRequest(endpoint, 'POST', undefined, body);
+    if (raw.success !== true) {
+        const detail = raw.errors
+            ? JSON.stringify(raw.errors)
+            : (raw.errorMessage ?? 'Unknown error');
+        return { ok: false, error: detail };
+    }
+    return { ok: true, status: raw.status };
+}
 export function registerLayoutRichStringWidgetTools(server, client) {
     server.registerTool(TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS], async ({ context, widgetId }) => {
         debugLogWithTag('LAYOUT_RICHSTRING', `Extracting widgets from layout widget ${widgetId}, config content`);
@@ -23,37 +147,135 @@ export function registerLayoutRichStringWidgetTools(server, client) {
             const layoutResult = await client.makeApiRequest(endpoint, 'GET', buildRequestParams(context));
             const widget = findWidgetById(layoutResult.rows, widgetId);
             if (!widget) {
-                return {
-                    content: [{ type: "text", text: `Widget '${widgetId}' not found in layout` }],
-                    isError: true
-                };
+                return buildStaleIdErrorResponse(widgetId, context.type);
             }
             if (!RICHSTRING_WIDGET_TYPES.includes(widget.widgetType)) {
                 return {
-                    content: [{ type: "text", text: `Widget '${widgetId}' is type '${widget.widgetType}', but layout richstring operations only support: ${RICHSTRING_WIDGET_TYPES.join(', ')}` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Widget '${widgetId}' is type '${widget.widgetType}', but layout richstring operations only support: ${RICHSTRING_WIDGET_TYPES.join(', ')}`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             const content = extractStringConfigValue(widget.configuration, 'content');
-            const result = await richstringExtractWidgets(client, content);
-            const contentMap = buildContentMap(content, result);
-            const response = { ...result };
-            if (contentMap) {
-                response.contentMap = contentMap;
-            }
-            debugLogWithTag('LAYOUT_RICHSTRING', `Successfully extracted ${result.totalCount || 0} widgets`);
+            const parsed = parseDecodedRichStringContent(content);
+            const response = {
+                embeddedWidgets: parsed.embeddedWidgets,
+                totalCount: parsed.embeddedWidgets.length,
+                contentMap: parsed.contentMap,
+            };
+            debugLogWithTag('LAYOUT_RICHSTRING', `Successfully extracted ${response.totalCount} widgets`);
             return {
-                content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('LAYOUT_RICHSTRING', `Error extracting widgets: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error extracting widgets from layout widget: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error extracting widgets from layout widget: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool(TOOL_RICHSTRING_SET_WIDGET_SCRIPT, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_RICHSTRING_SET_WIDGET_SCRIPT], async ({ context, containerWidgetId, embeddedWidgetId, attributeKey, script }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `set_widget_script container=${containerWidgetId} embedded=${embeddedWidgetId} attr=${attributeKey}`);
+        try {
+            const loaded = await loadScriptMutationContext(client, context, containerWidgetId, embeddedWidgetId);
+            if (!loaded.ok) {
+                return { content: [{ type: 'text', text: loaded.error }], isError: true };
+            }
+            loaded.ctx.targetWidget.properties[attributeKey] = script;
+            const committed = await commitScriptMutation(client, context, containerWidgetId, loaded.ctx);
+            if (!committed.ok) {
+                return {
+                    content: [{ type: 'text', text: `Error writing layout: ${committed.error}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'SET_WIDGET_SCRIPT',
+                            containerWidgetId,
+                            embeddedWidgetId,
+                            attributeKey,
+                            status: committed.status,
+                            scriptLength: script.length,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error setting widget script: ${e instanceof Error ? e.message : String(e)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.registerTool(TOOL_RICHSTRING_EDIT_WIDGET_SCRIPT, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_RICHSTRING_EDIT_WIDGET_SCRIPT], async ({ context, containerWidgetId, embeddedWidgetId, attributeKey, oldString, newString, replaceAll = false, }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `edit_widget_script container=${containerWidgetId} embedded=${embeddedWidgetId} attr=${attributeKey}`);
+        try {
+            const loaded = await loadScriptMutationContext(client, context, containerWidgetId, embeddedWidgetId);
+            if (!loaded.ok) {
+                return { content: [{ type: 'text', text: loaded.error }], isError: true };
+            }
+            const currentRaw = parseScriptEnvelope(loaded.ctx.targetWidget.properties[attributeKey]);
+            const replaced = applyStrReplace(currentRaw, oldString, newString, replaceAll);
+            if (!replaced.success) {
+                return { content: [{ type: 'text', text: `Error: ${replaced.error}` }], isError: true };
+            }
+            loaded.ctx.targetWidget.properties[attributeKey] = replaced.newContent;
+            const committed = await commitScriptMutation(client, context, containerWidgetId, loaded.ctx);
+            if (!committed.ok) {
+                return {
+                    content: [{ type: 'text', text: `Error writing layout: ${committed.error}` }],
+                    isError: true,
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            operation: 'EDIT_WIDGET_SCRIPT',
+                            containerWidgetId,
+                            embeddedWidgetId,
+                            attributeKey,
+                            status: committed.status,
+                            replacementCount: replaced.replacementCount,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (e) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error editing widget script: ${e instanceof Error ? e.message : String(e)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
-    debugLogWithTag('LAYOUT_RICHSTRING', 'Registered 1 layout richstring widget tool');
+    debugLogWithTag('LAYOUT_RICHSTRING', 'Registered 3 layout richstring widget tools');
 }
 //# sourceMappingURL=layout-richstring-widgets.js.map

package/dist/tools/layout-richstring-widgets.js.map

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

package/dist/tools/layout.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 LayoutContextSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     type: z.ZodLiteral<"page">;
@@ -34,9 +34,10 @@ export declare const LayoutContextSchema: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
     typeInternalName: string;
     alternativeLayoutName?: string | undefined;
 }, unknown>;
+export type LayoutContext = z.infer<typeof LayoutContextSchema>;
 export declare const LAYOUT_TOOL_DEFINITIONS: {
     readonly cplace_execute_layout_script: {
-        readonly description: "Execute a layout script — either a full layout.define() replacement or per-widget edit verbs.\n\nTWO MODES (determined by script content):\n\nMODE 1 — FULL REPLACE (layout.define):\n- Script calls layout.define() exactly once to declare the complete layout structure\n- Replaces the entire layout atomically\n- Same behavior as before\n\nMODE 2 — EDIT VERBS (per-widget):\n- Script calls one or more edit methods: layout.updateWidget(), layout.addWidget(), layout.removeWidget(), layout.moveWidget(), layout.addRow(), layout.compact()\n- Each call collects an operation; all operations commit atomically or fail together\n- Cannot mix layout.define() with edit verbs in the same script\n\nEDIT VERBS:\n  layout.updateWidget(\"widgetId\", { \"cf.cplace.x\": newValue })  — partial config merge (only specified keys change)\n  layout.addWidget({ widgetType: \"cf.platform.wiki\", position: { rowIndex: 0, columnIndex: 0, widgetIndex: 0 }, configuration: { ... } })\n  layout.removeWidget(\"widgetId\")\n  layout.moveWidget(\"widgetId\", { rowIndex: 1, columnIndex: 0, widgetIndex: 0 })\n  layout.addRow(rowIndex, [6, 6])  — column proportions must sum to 12\n  layout.compact()  — remove empty rows\n\nWORKFLOW for per-widget edit:\n1. Read: cplace_get_layout_script with widgetIds to get layout.updateWidget() fragments\n2. Edit: modify the config values in the fragment\n3. Execute: post the modified script via this tool\n\nKEY BEHAVIORS (for layout.define mode):\n- The script must call layout.define() exactly once\n- The entire layout is atomically replaced — previous layout is fully overwritten\n- Script timeout: 30 seconds\n- Widget IDs: MUST be omitted from layout.define. Ids are assigned by the server and returned in the response. Use the returned id in subsequent layout.updateWidget() calls.\n\nRESPONSE OUTCOMES:\n- VALID_COMPLETE: Layout saved, all widgets fully configured\n- VALID_INCOMPLETE: Layout saved, but some widgets have missing optional configuration (warnings returned)\n- Validation errors: Layout NOT saved — structural or widget errors returned with details\n- Generic errors: Entity not found, permission denied, script errors\n\nVALIDATION FEEDBACK:\n- Structural errors: invalid column proportions (must be 3-12 each, sum to 12 per row)\n- Widget errors: unknown widget types, invalid configurations\n- Warnings: widgets saved but missing optional configuration (e.g., search filter not set)\n\nTIP: After a VALID_INCOMPLETE response, re-run layout.define() with corrected widget configuration to resolve warnings.\n\nCOMMON WIDGET TYPES (platform, always available):\ncf.platform.attributes, cf.cplace.platform.attributesGroup,\ncf.platform.wiki, cf.platform.richString, cf.cplace.demoWidgets.demoRichString,\ncf.platform.embeddedSearchAsTable, cf.cplace.platform.tableWidget,\ncf.platform.connectedBarChart, cf.platform.connectedPieChart,\ncf.platform.connectedMatrix, cf.platform.connectedTableFilter,\ncf.platform.incomingReferences, cf.platform.comments, cf.platform.files,\ncf.cplace.visualizations.scriptingHighcharts\n\nFor app-dependent widgets not in this list, call cplace_list_widget_definitions with embeddingContext \"AS_WIDGET\".\n\nRICHSTRING WIDGETS AND EMBEDDED WIDGETS (decoded form):\nRichString widgets (cf.platform.richString, cf.cplace.demoWidgets.demoRichString)\nhold HTML in their 'content' config. Embedded widgets inside that HTML are\nexpressed in decoded form:\n  <decoded-widget id=\"id_w1\" type=\"cf.platform.singleAttribute\">{\"properties\":{\"attribute\":\"name\"}}</decoded-widget>\n\nSemantics when submitting a script:\n  • Tag with an existing id + same type → update (properties replace current)\n  • Tag without id → insert new embedded widget (backend assigns id)\n  • Existing id omitted from new content → delete\n  • Unknown id, duplicate id, or type change for same id → error\n\nRaw base64 <embeddedwidget>BASE64</embeddedwidget> tags are REJECTED on writes.\nFetch current decoded form via cplace_get_layout_script.\n\nIMPORTANT: Decoded <decoded-widget> tags must appear directly inline in a content: value.\nDo NOT build the tag in a variable and pass it — the parser rejects tags outside content: literals.\n  ✅ layout.updateWidget(\"id\", { content: '<decoded-widget type=\"...\">...</decoded-widget>' });\n  ❌ var tag = '<decoded-widget ...>...</decoded-widget>'; layout.updateWidget(\"id\", { content: tag });\n\nFor atomic single-embedded-widget edits without rewriting the full script,\nsee cplace_layout_richstring_* tools.";
+        readonly description: "Execute a layout script — either a full layout.define() replacement or per-widget edit verbs.\n\nTWO MODES (determined by script content):\n\nMODE 1 — FULL REPLACE (layout.define):\n- Script calls layout.define() exactly once to declare the complete layout structure\n- Replaces the entire layout atomically\n- Same behavior as before\n\nMODE 2 — EDIT VERBS (per-widget):\n- Script calls one or more edit methods: layout.updateWidget(), layout.addWidget(), layout.removeWidget(), layout.moveWidget(), layout.addRow(), layout.compact()\n- Each call collects an operation; all operations commit atomically or fail together\n- Cannot mix layout.define() with edit verbs in the same script\n\nEDIT VERBS:\n  layout.updateWidget(\"widgetId\", { \"cf.cplace.x\": newValue })  — partial config merge (only specified keys change)\n  layout.addWidget({ widgetType: \"cf.platform.wiki\", position: { rowIndex: 0, columnIndex: 0, widgetIndex: 0 }, configuration: { ... } })\n  layout.removeWidget(\"widgetId\")\n  layout.moveWidget(\"widgetId\", { rowIndex: 1, columnIndex: 0, widgetIndex: 0 })\n  layout.addRow(rowIndex, [6, 6])  — column proportions must sum to 12\n  layout.compact()  — remove empty rows\n\nWORKFLOW for per-widget edit:\n1. Read: cplace_get_layout_script with widgetIds to get layout.updateWidget() fragments\n2. Edit: modify the config values in the fragment\n3. Execute: post the modified script via this tool\n\nKEY BEHAVIORS (for layout.define mode):\n- The script must call layout.define() exactly once\n- The entire layout is atomically replaced — previous layout is fully overwritten\n- Script timeout: 30 seconds\n- Widget IDs: MUST be omitted from layout.define. Ids are assigned by the server and returned in the response. Use the returned id in subsequent layout.updateWidget() calls.\n\nRESPONSE OUTCOMES:\n- VALID_COMPLETE: Layout saved, all widgets fully configured\n- VALID_INCOMPLETE: Layout saved, but some widgets have missing optional configuration (warnings returned)\n- Validation errors: Layout NOT saved — structural or widget errors returned with details\n- Generic errors: Entity not found, permission denied, script errors\n\nVALIDATION FEEDBACK:\n- Structural errors: invalid column proportions (must be 3-12 each, sum to 12 per row)\n- Widget errors: unknown widget types, invalid configurations\n- Warnings: widgets saved but missing optional configuration (e.g., search filter not set)\n\nTIP: After a VALID_INCOMPLETE response, re-run layout.define() with corrected widget configuration to resolve warnings.\n\nCOMMON WIDGET TYPES (platform, always available):\ncf.platform.attributes, cf.cplace.platform.attributesGroup,\ncf.platform.wiki, cf.platform.richString, cf.cplace.demoWidgets.demoRichString,\ncf.platform.embeddedSearchAsTable, cf.cplace.platform.tableWidget,\ncf.platform.connectedBarChart, cf.platform.connectedPieChart,\ncf.platform.connectedMatrix, cf.platform.connectedTableFilter,\ncf.platform.incomingReferences, cf.platform.comments, cf.platform.files,\ncf.cplace.visualizations.scriptingHighcharts\n\nFor app-dependent widgets not in this list, call cplace_list_widget_definitions with embeddingContext \"AS_WIDGET\".\n\nRICHSTRING WIDGETS AND EMBEDDED WIDGETS (decoded form):\nRichString widgets (cf.platform.richString, cf.cplace.demoWidgets.demoRichString)\nhold HTML in their 'content' config. Embedded widgets inside that HTML are\nexpressed in decoded form:\n  <decoded-widget id=\"id_w1\" type=\"cf.platform.singleAttribute\">{\"properties\":{\"attribute\":\"name\"}}</decoded-widget>\n\nSemantics when submitting a script:\n  • Tag with an existing id + same type → update (properties replace current)\n  • Tag without id → insert new embedded widget (backend assigns id)\n  • Existing id omitted from new content → delete\n  • Unknown id, duplicate id, or type change for same id → error\n\nRaw base64 <embeddedwidget>BASE64</embeddedwidget> tags are REJECTED on writes.\nFetch current decoded form via cplace_get_layout_script.\n\nIMPORTANT: Decoded <decoded-widget> tags must appear directly inline in a content: value.\nDo NOT build the tag in a variable and pass it — the parser rejects tags outside content: literals.\n  ✅ layout.updateWidget(\"id\", { content: '<decoded-widget type=\"...\">...</decoded-widget>' });\n  ❌ var tag = '<decoded-widget ...>...</decoded-widget>'; layout.updateWidget(\"id\", { content: tag });\n\nEMBEDDED WIDGET SCRIPT ATTRIBUTES — PLACEHOLDER WORKFLOW (REQUIRED):\nFor script-typed attributes on embedded widgets (e.g. cf.cplace.lowCodeWidgets.lowCodeTextWidget.script),\ninitialize the value to a minimal placeholder body inside the inline <decoded-widget> JSON, then fill the\nreal script body afterward via cplace_richstring_set_widget_script (full replace) or\ncplace_richstring_edit_widget_script (str-replace diff). Authoring a non-trivial script body inline\nforces it through four nested encoding layers (HTML → JSON → JS string literal → MCP wire) and is a\ndocumented source of escape-bug churn — the dedicated tools take the script as a plain string in a\nstructured argument and avoid all four layers.\n\nSafe placeholder for cf.cplace.lowCodeWidgets.lowCodeText: return '';\nOther script-bearing widget types: pick any runtime-valid placeholder for that widget.\n\nNon-script attributes (strings, numbers, references, lists) do NOT have this problem and are authored\ninline as normal JSON properties on the <decoded-widget> tag.\n\nFor atomic single-embedded-widget edits without rewriting the full script,\nsee cplace_layout_richstring_* and cplace_richstring_*_widget_script tools.";
         readonly inputSchema: {
             readonly context: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"page">;
@@ -203,7 +204,7 @@ export declare const LAYOUT_TOOL_DEFINITIONS: {
         };
     };
     readonly cplace_edit_layout: {
-        readonly description: "Edit a layout using str_replace — find an exact text match and replace it. Reads the current layout.define() definition, applies the replacement, and writes back. Use this instead of cplace_execute_layout_script when making small changes to large layouts to avoid reproducing the entire definition.\n\nRichString widget content is in decoded form. `old_str` must match the decoded form exactly as returned by cplace_get_layout_script. Raw base64 <embeddedwidget> tags are rejected in both `old_str` and `new_str`.";
+        readonly description: "Edit a layout using str_replace — find an exact text match and replace it. Reads the current layout.define() definition, applies the replacement, and writes back. Use this instead of cplace_execute_layout_script when making small changes to large layouts to avoid reproducing the entire definition.\n\nRichString widget content is in decoded form. `old_str` must match the decoded form exactly as returned by cplace_get_layout_script. Raw base64 <embeddedwidget> tags are rejected in both `old_str` and `new_str`.\n\nIMPORTANT: cplace normalizes HTML/CSS on every save (CSS properties are alphabetized, hex colors become rgb(), whitespace is regularized). After this tool completes, the stored content may differ from what was submitted. The response includes the current stored form — use it (not your original input) when constructing the next old_str.";
         readonly inputSchema: {
             readonly context: z.ZodEffects<z.ZodUnion<[z.ZodObject<{
                 type: z.ZodLiteral<"page">;

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

@@ -1 +1 @@
-{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/tools/layout.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;AAQ5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAWgD,CAAC;AAajF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqO1B,CAAC;AAYX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA8V7E"}
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/tools/layout.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;AAe5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAe/B,CAAC;AAGF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAUhE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgR1B,CAAC;AAYX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAgf7E"}