@cplace/mcp-server 1.3.14

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

@@ -0,0 +1,270 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { LayoutContextSchema } from './layout.js';
+import { richstringInsertWidget, richstringUpdateWidget, richstringDeleteWidget, richstringExtractWidgets, buildContentMap } from './richstring-widgets.js';
+const TOOL_LAYOUT_RICHSTRING_INSERT_WIDGET = 'cplace_layout_richstring_insert_widget';
+const TOOL_LAYOUT_RICHSTRING_UPDATE_WIDGET = 'cplace_layout_richstring_update_widget';
+const TOOL_LAYOUT_RICHSTRING_DELETE_WIDGET = 'cplace_layout_richstring_delete_widget';
+const TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS = 'cplace_layout_richstring_extract_widgets';
+const RICHSTRING_WIDGET_TYPES = [
+    'cf.platform.richString',
+    'cf.cplace.demoWidgets.demoRichString'
+];
+function determineApiEndpoint(context) {
+    return context.type === "page" ? "json/pageLayout" : "json/typeLayout";
+}
+function buildRequestParams(context) {
+    if (context.type === "page") {
+        return { pageUID: context.pageUID };
+    }
+    else {
+        return {
+            workspaceId: context.workspaceId,
+            typeInternalName: context.typeInternalName,
+            ...(context.alternativeLayoutName && { alternativeLayoutName: context.alternativeLayoutName })
+        };
+    }
+}
+function buildUpdateRequestBody(context, widgetId, newConfiguration) {
+    return {
+        ...buildRequestParams(context),
+        operation: {
+            type: "UPDATE",
+            widgetId,
+            newConfiguration
+        }
+    };
+}
+function findWidgetById(rows, widgetId) {
+    for (const row of rows || []) {
+        for (const column of row.columns || []) {
+            for (const widget of column.widgets || []) {
+                if (widget.id === widgetId) {
+                    return widget;
+                }
+                if (widget.widgetsLayout?.rows) {
+                    const nested = findWidgetById(widget.widgetsLayout.rows, widgetId);
+                    if (nested)
+                        return nested;
+                }
+            }
+        }
+    }
+    return null;
+}
+function extractStringConfigValue(configuration, configAttribute) {
+    if (!configuration)
+        return '';
+    if (typeof configuration === 'object' && !Array.isArray(configuration)) {
+        const value = configuration[configAttribute];
+        if (value === undefined || value === null)
+            return '';
+        if (typeof value === 'string')
+            return value;
+        if (typeof value === 'object' && value.markup !== undefined)
+            return value.markup;
+        return '';
+    }
+    if (Array.isArray(configuration)) {
+        const entry = configuration.find((c) => c.name === configAttribute);
+        if (!entry || !Array.isArray(entry.values) || entry.values.length === 0)
+            return '';
+        const firstValue = entry.values[0];
+        if (typeof firstValue === 'string')
+            return firstValue;
+        if (firstValue.string !== undefined)
+            return firstValue.string;
+        if (firstValue.markup !== undefined)
+            return firstValue.markup;
+        return '';
+    }
+    return '';
+}
+async function withLayoutWidgetConfig(client, context, widgetId, configAttribute, transformFn, writeBack = true) {
+    const endpoint = determineApiEndpoint(context);
+    const layoutResult = await client.makeApiRequest(endpoint, 'GET', buildRequestParams(context));
+    const widget = findWidgetById(layoutResult.rows, widgetId);
+    if (!widget) {
+        throw new Error(`Widget '${widgetId}' not found in layout`);
+    }
+    if (!RICHSTRING_WIDGET_TYPES.includes(widget.widgetType)) {
+        throw new Error(`Widget '${widgetId}' is type '${widget.widgetType}', but layout richstring operations only support: ${RICHSTRING_WIDGET_TYPES.join(', ')}`);
+    }
+    const content = extractStringConfigValue(widget.configuration, configAttribute);
+    const { result, modifiedContent } = await transformFn(content);
+    if (writeBack) {
+        const requestBody = buildUpdateRequestBody(context, widgetId, {
+            [configAttribute]: modifiedContent
+        });
+        await client.makeApiRequest(endpoint, 'PATCH', undefined, requestBody);
+    }
+    const inventory = await richstringExtractWidgets(client, modifiedContent);
+    return { result, inventory };
+}
+export const LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS = {
+    [TOOL_LAYOUT_RICHSTRING_EXTRACT_WIDGETS]: {
+        description: "Extract all embedded widgets from a layout widget's richstring config attribute. Reads the layout internally and returns structured information about each embedded widget including ID, type, properties, and position. Use this to discover widget IDs before updating or deleting them.\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')"),
+            configAttribute: z.string().default("content").describe("The fully-qualified config attribute name containing richstring HTML (default: 'content')")
+        },
+        annotations: { title: "Extract Embedded Widgets from Layout Widget RichString" }
+    },
+    [TOOL_LAYOUT_RICHSTRING_INSERT_WIDGET]: {
+        description: "Insert a new embedded widget into a layout widget's richstring config attribute. Reads the layout, inserts the widget via the backend richstring API, and writes the modified config back via PATCH UPDATE — all in one call. Returns the inserted widget ID and the full widget inventory.\n\nSupported layout widget types: cf.platform.richString, cf.cplace.demoWidgets.demoRichString\n\nIMPORTANT: For low-code widgets that execute cplaceJS scripts (e.g., lowCodeText, lowCodeButton, scriptingHighcharts), always test your script first using cplace_execute_script to verify it works correctly before embedding the widget.",
+        inputSchema: {
+            context: LayoutContextSchema,
+            widgetId: z.string().describe("The ID of the layout widget containing the richstring config (e.g., '_kpi1_open_cases')"),
+            configAttribute: z.string().default("content").describe("The fully-qualified config attribute name containing richstring HTML (default: 'content')"),
+            widgetType: z.string().describe("Widget type to insert (e.g., 'cf.cplace.lowCodeWidgets.lowCodeText'). Use cplace_get_widget_definition to verify it supports INSIDE_RICHSTRING embedding."),
+            position: z.number().optional().describe("Zero-based character position to insert at (default: end of content)."),
+            expectedBefore: z.string().optional().describe("Optional: Expected content immediately before insertion position for validation."),
+            expectedAfter: z.string().optional().describe("Optional: Expected content immediately after insertion position for validation."),
+            properties: z.record(z.any()).optional().describe(`Optional: Widget configuration properties as key-value pairs. Values should be arrays. Examples:
+- String array: {"title": ["My Widget"]}
+- Number: {"height": [800]}
+- Boolean: {"showFooter": [true]}
+- Complex JSON: {"config": ["{\"key\": \"value\"}"]}
+
+Use cplace_get_widget_definition to understand required properties and data types.`)
+        },
+        annotations: { title: "Insert Embedded Widget into Layout Widget RichString" }
+    },
+    [TOOL_LAYOUT_RICHSTRING_UPDATE_WIDGET]: {
+        description: "Update an existing embedded widget's properties in a layout widget's richstring config attribute. Reads the layout, updates the widget via the backend richstring API, and writes back — all in one call. Properties are completely replaced (not merged). Returns the updated widget ID and the full widget inventory.\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')"),
+            configAttribute: z.string().default("content").describe("The fully-qualified config attribute name containing richstring HTML (default: 'content')"),
+            embeddedWidgetId: z.string().describe("The unique ID of the embedded widget to update (obtain via cplace_layout_richstring_extract_widgets)"),
+            properties: z.record(z.any()).describe(`New widget properties to set (completely replaces existing properties). Values should be arrays. Examples:
+- String array: {"title": ["Updated Widget"]}
+- Number: {"height": [900]}
+- Boolean: {"showFooter": [true]}
+
+Use cplace_get_widget_definition to understand required properties and data types.`)
+        },
+        annotations: { title: "Update Embedded Widget in Layout Widget RichString" }
+    },
+    [TOOL_LAYOUT_RICHSTRING_DELETE_WIDGET]: {
+        description: "Remove an embedded widget from a layout widget's richstring config attribute. Reads the layout, deletes the widget via the backend richstring API, and writes back — all in one call. Returns the deleted widget ID and the remaining widget inventory.\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')"),
+            configAttribute: z.string().default("content").describe("The fully-qualified config attribute name containing richstring HTML (default: 'content')"),
+            embeddedWidgetId: z.string().describe("The unique ID of the embedded widget to delete (obtain via cplace_layout_richstring_extract_widgets)")
+        },
+        annotations: { title: "Delete Embedded Widget from Layout Widget RichString" }
+    }
+};
+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, configAttribute }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `Extracting widgets from layout widget ${widgetId}, config ${configAttribute}`);
+        try {
+            const endpoint = determineApiEndpoint(context);
+            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
+                };
+            }
+            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
+                };
+            }
+            const content = extractStringConfigValue(widget.configuration, configAttribute);
+            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`);
+            return {
+                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
+            };
+        }
+    });
+    server.registerTool(TOOL_LAYOUT_RICHSTRING_INSERT_WIDGET, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_LAYOUT_RICHSTRING_INSERT_WIDGET], async ({ context, widgetId, configAttribute, widgetType, position, expectedBefore, expectedAfter, properties }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `Inserting widget ${widgetType} into layout widget ${widgetId}, config ${configAttribute}`);
+        try {
+            const { result, inventory } = await withLayoutWidgetConfig(client, context, widgetId, configAttribute, async (content) => richstringInsertWidget(client, content, {
+                widgetType, position, expectedBefore, expectedAfter, properties
+            }));
+            const response = {
+                ...result,
+                embeddedWidgets: inventory.embeddedWidgets,
+                totalWidgetCount: inventory.totalCount
+            };
+            debugLogWithTag('LAYOUT_RICHSTRING', `Successfully inserted widget: ${result.insertedWidgetId}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('LAYOUT_RICHSTRING', `Error inserting widget: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error inserting widget into layout widget: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_LAYOUT_RICHSTRING_UPDATE_WIDGET, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_LAYOUT_RICHSTRING_UPDATE_WIDGET], async ({ context, widgetId, configAttribute, embeddedWidgetId, properties }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `Updating embedded widget ${embeddedWidgetId} in layout widget ${widgetId}, config ${configAttribute}`);
+        try {
+            const { result, inventory } = await withLayoutWidgetConfig(client, context, widgetId, configAttribute, async (content) => richstringUpdateWidget(client, content, embeddedWidgetId, properties));
+            const response = {
+                ...result,
+                embeddedWidgets: inventory.embeddedWidgets,
+                totalWidgetCount: inventory.totalCount
+            };
+            debugLogWithTag('LAYOUT_RICHSTRING', `Successfully updated embedded widget: ${embeddedWidgetId}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('LAYOUT_RICHSTRING', `Error updating widget: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error updating embedded widget in layout widget: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_LAYOUT_RICHSTRING_DELETE_WIDGET, LAYOUT_RICHSTRING_WIDGET_TOOL_DEFINITIONS[TOOL_LAYOUT_RICHSTRING_DELETE_WIDGET], async ({ context, widgetId, configAttribute, embeddedWidgetId }) => {
+        debugLogWithTag('LAYOUT_RICHSTRING', `Deleting embedded widget ${embeddedWidgetId} from layout widget ${widgetId}, config ${configAttribute}`);
+        try {
+            const { result, inventory } = await withLayoutWidgetConfig(client, context, widgetId, configAttribute, async (content) => richstringDeleteWidget(client, content, embeddedWidgetId));
+            const response = {
+                ...result,
+                embeddedWidgets: inventory.embeddedWidgets,
+                totalWidgetCount: inventory.totalCount
+            };
+            debugLogWithTag('LAYOUT_RICHSTRING', `Successfully deleted embedded widget: ${embeddedWidgetId}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('LAYOUT_RICHSTRING', `Error deleting widget: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error deleting embedded widget from layout widget: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    debugLogWithTag('LAYOUT_RICHSTRING', 'Registered 4 layout richstring widget tools');
+}
+//# sourceMappingURL=layout-richstring-widgets.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,202 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const LayoutContextSchema: z.ZodUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"page">;
+    pageUID: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "page";
+    pageUID: string;
+}, {
+    type: "page";
+    pageUID: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"type">;
+    workspaceId: z.ZodString;
+    typeInternalName: z.ZodString;
+    alternativeLayoutName: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "type";
+    workspaceId: string;
+    typeInternalName: string;
+    alternativeLayoutName?: string | undefined;
+}, {
+    type: "type";
+    workspaceId: string;
+    typeInternalName: string;
+    alternativeLayoutName?: string | undefined;
+}>]>;
+export declare const LAYOUT_TOOL_DEFINITIONS: {
+    readonly cplace_define_layout: {
+        readonly description: "Define a complete page or type layout atomically using a layout.define() low-code script.\n\nWHEN TO USE:\n- Use this tool when you know the full layout structure upfront\n- Replaces the entire layout in a single atomic operation (no partial updates)\n- More efficient than sequential add-row/add-widget calls for complete layouts\n\nKEY BEHAVIORS:\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: auto-generated if omitted; if provided without '_' prefix, '_' is prepended automatically\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.";
+        readonly inputSchema: {
+            readonly context: z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>;
+            readonly script: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Define Layout";
+        };
+    };
+    readonly cplace_get_layout_overview: {
+        readonly description: "Get layout structure for page or type. Provides an overview of the layout grid including rows, columns, and widget summaries for both page and type layouts.";
+        readonly inputSchema: {
+            readonly context: z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>;
+        };
+        readonly annotations: {
+            readonly title: "Get Layout Overview";
+        };
+    };
+    readonly cplace_get_layout_widget_details: {
+        readonly description: "Get detailed widget configuration from page or type layout. Extracts specific widget information from the layout structure.";
+        readonly inputSchema: {
+            readonly context: z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>;
+            readonly widgetId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Layout Widget Details";
+        };
+    };
+    readonly cplace_get_layout_definition: {
+        readonly description: "Get the current layout as a layout.define() JavaScript definition for a page or type layout.\n\nWHEN TO USE:\n- To read the current layout before modifying it (read-edit-write workflow)\n- To inspect the full layout definition including widget configurations and embedded layouts\n- To copy a layout from one page/type to another\n\nRETURNS:\n- The layout as a layout.define({...}) definition string, ready to be modified and posted back via cplace_define_layout\n- Widget config values are in the INPUT format accepted by cplace_define_layout (references as UID strings, rich strings as markup strings, localized strings as {locale: value} maps)\n\nROUND-TRIP WORKFLOW:\n1. GET: Use this tool to retrieve the current layout definition\n2. EDIT: Modify the definition as needed\n3. APPLY: Use cplace_define_layout to apply the modified definition";
+        readonly inputSchema: {
+            readonly context: z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>;
+        };
+        readonly annotations: {
+            readonly title: "Get Layout Definition";
+        };
+    };
+    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_define_layout when making small changes to large layouts to avoid reproducing the entire definition.";
+        readonly inputSchema: {
+            readonly context: z.ZodUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"page">;
+                pageUID: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                type: "page";
+                pageUID: string;
+            }, {
+                type: "page";
+                pageUID: string;
+            }>, z.ZodObject<{
+                type: z.ZodLiteral<"type">;
+                workspaceId: z.ZodString;
+                typeInternalName: z.ZodString;
+                alternativeLayoutName: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }, {
+                type: "type";
+                workspaceId: string;
+                typeInternalName: string;
+                alternativeLayoutName?: string | undefined;
+            }>]>;
+            readonly old_str: z.ZodString;
+            readonly new_str: z.ZodString;
+            readonly replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        readonly annotations: {
+            readonly title: "Edit Layout";
+        };
+    };
+};
+export declare function registerLayoutTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=layout.d.ts.map

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

@@ -0,0 +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;AAM5C,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;IAW+C,CAAC;AAahF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoN1B,CAAC;AAkCX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA8W7E"}