@cplace/mcp-server 1.9.1 → 1.10.5

package/dist/tools/pages.js

@@ -1,7 +1,7 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
 import { checkResponseSize } from '../utils.js';
-import { DATE_TIME_FORMAT_DESCRIPTION, jsonStringToObject } from "./common-schemas.js";
+import { DATE_TIME_FORMAT_DESCRIPTION, jsonStringToObject } from './common-schemas.js';
 import { applyStrReplace } from '../str-replace-utils.js';
 const TOOL_DELETE_PAGE = 'cplace_delete_page';
 const TOOL_DELETE_PAGE_WITH_CHILDREN = 'cplace_delete_page_with_children';
@@ -10,56 +10,117 @@ const TOOL_MANAGE_PAGE = 'cplace_manage_page';
 const TOOL_EDIT_PAGE_CONTENT = 'cplace_edit_page_content';
 export const PAGE_TOOL_DEFINITIONS = {
     [TOOL_DELETE_PAGE]: {
-        description: "⚠️ DESTRUCTIVE OPERATION: Permanently delete a single page. Only works for leaf pages (pages without children). For pages with children, use cplace_delete_page_with_children.",
+        description: '⚠️ DESTRUCTIVE OPERATION: Permanently delete a single page. Only works for leaf pages (pages without children). For pages with children, use cplace_delete_page_with_children.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to delete (e.g., 'page/abc123def456')")
+            pageUID: z
+                .string()
+                .describe("The unique identifier (UID) of the page to delete (e.g., 'page/abc123def456')"),
         },
-        annotations: { title: "Delete Page" }
+        annotations: { title: 'Delete Page' },
     },
     [TOOL_DELETE_PAGE_WITH_CHILDREN]: {
-        description: "⚠️ DESTRUCTIVE OPERATION: Permanently delete a page and optionally all its children. Uses a two-phase workflow: first call shows preview, second call with confirmation performs deletion.",
+        description: '⚠️ DESTRUCTIVE OPERATION: Permanently delete a page and optionally all its children. Uses a two-phase workflow: first call shows preview, second call with confirmation performs deletion.',
         inputSchema: {
-            pageUID: z.string().describe("The unique identifier (UID) of the page to delete"),
-            confirmDeleteChildren: z.boolean().optional().default(false).describe("Explicit confirmation flag for bulk deletion. Set to true to confirm deletion of page and all children.")
+            pageUID: z.string().describe('The unique identifier (UID) of the page to delete'),
+            confirmDeleteChildren: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Explicit confirmation flag for bulk deletion. Set to true to confirm deletion of page and all children.'),
         },
-        annotations: { title: "Delete Page with Children" }
+        annotations: { title: 'Delete Page with Children' },
     },
     [TOOL_COPY_PAGE]: {
-        description: "Copy a page with optional hierarchical copy. Set includeChildren=false for single page copy (leaf pages only), or includeChildren=true for copying page with all children. When includeChildren=true, uses a two-phase workflow: first call shows preview, second call with confirmCopyChildren=true performs the copy.",
+        description: 'Copy a page with optional hierarchical copy. Set includeChildren=false for single page copy (leaf pages only), or includeChildren=true for copying page with all children. When includeChildren=true, uses a two-phase workflow: first call shows preview, second call with confirmCopyChildren=true performs the copy.',
         inputSchema: {
             sourcePageUID: z.string().describe("The UID of the page to copy (e.g., 'page/abc123def456')"),
-            includeChildren: z.boolean().describe("Whether to copy child pages. false (default) for single page copy (will fail if page has children), true for hierarchical copy with all descendants."),
-            confirmCopyChildren: z.boolean().optional().describe("Required confirmation when includeChildren=true. Set to false (or omit) for preview showing child count, set to true to perform the actual bulk copy operation. Ignored when includeChildren=false."),
-            targetWorkspaceId: z.string().optional().describe("Target workspace ID (e.g., 'workspace789'). Exactly one of targetWorkspaceId or targetParentUID must be provided."),
-            targetParentUID: z.string().optional().describe("UID of target parent page (e.g., 'page/parent123xyz'). Exactly one of targetWorkspaceId or targetParentUID must be provided."),
-            newName: z.string().optional().describe("New name for the copied page (optional). If not provided, uses original page name. When includeChildren=true, only the root page is renamed; children retain their original names."),
-            includeComments: z.boolean().optional().default(false).describe("Whether to copy comments from the page(s). Default: false for single page copy, false for hierarchical copy. Comments add context but increase copy time significantly for large hierarchies."),
-            includeFiles: z.boolean().optional().default(true).describe("Whether to copy files attached to the page(s). Default: true for single page copy, true for hierarchical copy. Files are typically needed for complete page copies but increase copy time and storage usage.")
+            includeChildren: z
+                .boolean()
+                .describe('Whether to copy child pages. false (default) for single page copy (will fail if page has children), true for hierarchical copy with all descendants.'),
+            confirmCopyChildren: z
+                .boolean()
+                .optional()
+                .describe('Required confirmation when includeChildren=true. Set to false (or omit) for preview showing child count, set to true to perform the actual bulk copy operation. Ignored when includeChildren=false.'),
+            targetWorkspaceId: z
+                .string()
+                .optional()
+                .describe("Target workspace ID (e.g., 'workspace789'). Exactly one of targetWorkspaceId or targetParentUID must be provided."),
+            targetParentUID: z
+                .string()
+                .optional()
+                .describe("UID of target parent page (e.g., 'page/parent123xyz'). Exactly one of targetWorkspaceId or targetParentUID must be provided."),
+            newName: z
+                .string()
+                .optional()
+                .describe('New name for the copied page (optional). If not provided, uses original page name. When includeChildren=true, only the root page is renamed; children retain their original names.'),
+            includeComments: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('Whether to copy comments from the page(s). Default: false for single page copy, false for hierarchical copy. Comments add context but increase copy time significantly for large hierarchies.'),
+            includeFiles: z
+                .boolean()
+                .optional()
+                .default(true)
+                .describe('Whether to copy files attached to the page(s). Default: true for single page copy, true for hierarchical copy. Files are typically needed for complete page copies but increase copy time and storage usage.'),
         },
-        annotations: { title: "Copy Page" }
+        annotations: { title: 'Copy Page' },
     },
     [TOOL_EDIT_PAGE_CONTENT]: {
-        description: "Edit page wiki content using str_replace — find an exact text match and replace it. Reads current content, applies the replacement, and writes back. Use this instead of cplace_manage_page when making small changes to large page content to avoid reproducing the entire content.\n\nRichString content is in decoded form: embedded widgets appear as `<decoded-widget id=\"…\" type=\"…\">{\"properties\":{…}}</decoded-widget>` — no base64. `old_str` must match the decoded form exactly as returned by reads. Raw base64 `<embeddedwidget>` tags are rejected in both `old_str` and `new_str`.",
+        description: 'Edit page wiki content using str_replace — find an exact text match and replace it. Reads current content, applies the replacement, and writes back. Use this instead of cplace_manage_page when making small changes to large page content to avoid reproducing the entire content.\n\nRichString content is in decoded form: embedded widgets appear as `<decoded-widget id="…" type="…">{"properties":{…}}</decoded-widget>` — no base64. `old_str` must match the decoded form exactly as returned by reads. 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.',
         inputSchema: {
             pageUID: z.string().describe("The UID of the page to edit (e.g., 'page/abc123def456')"),
-            old_str: z.string().describe("The exact text to find in the page content (must match exactly, including whitespace and line breaks)"),
-            new_str: z.string().describe("The replacement text. Use empty string to delete the matched text."),
-            replace_all: z.boolean().optional().default(false).describe("If true, replace all occurrences of old_str. If false (default), fails when old_str matches more than once.")
+            old_str: z
+                .string()
+                .describe('The exact text to find in the page content (must match exactly, including whitespace and line breaks)'),
+            new_str: z
+                .string()
+                .describe('The replacement text. Use empty string to delete the matched text.'),
+            replace_all: z
+                .boolean()
+                .optional()
+                .default(false)
+                .describe('If true, replace all occurrences of old_str. If false (default), fails when old_str matches more than once.'),
         },
-        annotations: { title: "Edit Page Content" }
+        annotations: { title: 'Edit Page Content' },
     },
     [TOOL_MANAGE_PAGE]: {
-        description: "Create or update a page. Use operation='create' to create new pages with workspace and type. Use operation='update' to modify existing pages by UID. 🔍 IMPORTANT: Use 'cplace_get_type_datamodel' before creating pages to understand attribute requirements.\n\nRichString content (page content and richstring attributes) uses decoded form: `<decoded-widget id=\"…\" type=\"…\">{\"properties\":{…}}</decoded-widget>` — no base64. On writes, decoded tags are auto-encoded to storage form. Raw base64 `<embeddedwidget>` tags are rejected.",
+        description: 'Create or update a page. Use operation=\'create\' to create new pages with workspace and type. Use operation=\'update\' to modify existing pages by UID. 🔍 IMPORTANT: Use \'cplace_get_type_datamodel\' before creating pages to understand attribute requirements.\n\nRichString content (page content and richstring attributes) uses decoded form: `<decoded-widget id="…" type="…">{"properties":{…}}</decoded-widget>` — no base64. On writes, decoded tags are auto-encoded to storage form. Raw base64 `<embeddedwidget>` tags are rejected.',
         inputSchema: {
-            operation: z.enum(["create", "update"]).describe("Operation to perform: 'create' for new pages, 'update' for existing pages"),
-            responseFormat: z.enum(["status", "full"]).optional().default("status").describe("Response format. 'status' (default): returns only operation result with pageUID — prevents token-exceeded errors. 'full': returns the complete page entity (may exceed size limits for large pages)."),
-            workspaceId: z.string().optional().describe("Required for create: The workspace ID where the page should be created (e.g., 'abc123')"),
-            typeInternalName: z.string().optional().describe("Required for create: The type internal name (e.g., 'cf.example.myType')"),
-            pageUID: z.string().optional().describe("Required for update: The UID of the page to update (e.g., 'page/abc123def456')"),
-            name: z.string().optional().describe("Page name. For create operations: optional if type has name generation pattern (auto-generates from pattern), otherwise required. For update operations: optional. Name generation pattern syntax: <attributeName> for attribute values, {###} for sequential counter, {0000} for zero-padded counter. Example: '<title>-{0000}' generates 'ProjectAlpha-0001'. Provide explicit name to override pattern. Use cplace_get_type_datamodel to check if type supports name generation."),
-            parentUID: z.string().optional().describe("Parent page UID for hierarchy. For create: sets initial parent. For update: moves page (use empty string to remove parent)."),
-            content: z.string().optional().describe("HTML content for the page. Use HTML markup, not markdown - e.g. '<strong>bold</strong>' not '**bold**'. Embedded widgets appear in decoded form: `<decoded-widget type=\"…\">{\"properties\":{…}}</decoded-widget>`. For update: use empty string to remove content."),
-            attributes: jsonStringToObject(z.any().optional()).describe(`Pass as a JSON object (NOT \`customAttributes\`, NOT a JSON string). Custom attribute values as key-value pairs. 🔍 IMPORTANT: Use 'cplace_get_type_datamodel' tool first to understand attribute requirements and constraints. Supports:
+            operation: z
+                .enum(['create', 'update'])
+                .describe("Operation to perform: 'create' for new pages, 'update' for existing pages"),
+            responseFormat: z
+                .enum(['status', 'full'])
+                .optional()
+                .default('status')
+                .describe("Response format. 'status' (default): returns only operation result with pageUID — prevents token-exceeded errors. 'full': returns the complete page entity (may exceed size limits for large pages)."),
+            workspaceId: z
+                .string()
+                .optional()
+                .describe("Required for create: The workspace ID where the page should be created (e.g., 'abc123')"),
+            typeInternalName: z
+                .string()
+                .optional()
+                .describe("Required for create: The type internal name (e.g., 'cf.example.myType')"),
+            pageUID: z
+                .string()
+                .optional()
+                .describe("Required for update: The UID of the page to update (e.g., 'page/abc123def456')"),
+            name: z
+                .string()
+                .optional()
+                .describe("Page name. For create operations: optional if type has name generation pattern (auto-generates from pattern), otherwise required. For update operations: optional. Name generation pattern syntax: <attributeName> for attribute values, {###} for sequential counter, {0000} for zero-padded counter. Example: '<title>-{0000}' generates 'ProjectAlpha-0001'. Provide explicit name to override pattern. Use cplace_get_type_datamodel to check if type supports name generation."),
+            parentUID: z
+                .string()
+                .optional()
+                .describe('Parent page UID for hierarchy. For create: sets initial parent. For update: moves page (use empty string to remove parent).'),
+            content: z
+                .string()
+                .optional()
+                .describe('HTML content for the page. Use HTML markup, not markdown - e.g. \'<strong>bold</strong>\' not \'**bold**\'. Embedded widgets appear in decoded form: `<decoded-widget type="…">{"properties":{…}}</decoded-widget>`. For update: use empty string to remove content.'),
+            attributes: jsonStringToObject(z.any().optional())
+                .describe(`Pass as a JSON object (NOT \`customAttributes\`, NOT a JSON string). Custom attribute values as key-value pairs. 🔍 IMPORTANT: Use 'cplace_get_type_datamodel' tool first to understand attribute requirements and constraints. Supports:
 - String values: "text"
 - Numeric values: 42 or 3.14
 - Boolean values: true/false
@@ -76,7 +137,8 @@ The system automatically detects attribute types from the page type definition a
 - Proper multiplicity validation (single vs multi-valued)
 - Automatic type conversion and validation
 - Enhanced error messages with attribute-specific details`),
-            builtinAttributes: jsonStringToObject(z.any().optional()).describe(`Builtin/mixin-provided attributes (optional for schedules). Supports:
+            builtinAttributes: jsonStringToObject(z.any().optional())
+                .describe(`Builtin/mixin-provided attributes (optional for schedules). Supports:
 - owner: Person UID as string (e.g., "person/123abc456") - Sets/updates the page owner for schedules
 - For update only: Use null to remove builtin attribute values
 
@@ -84,19 +146,19 @@ Supported page type:
 - Schedule (cf.schedule): supports owner attribute
 
 Example for schedule:
-{"owner": "person/123abc456"}`)
+{"owner": "person/123abc456"}`),
         },
-        annotations: { title: "Manage Page" }
-    }
+        annotations: { title: 'Manage Page' },
+    },
 };
 export function registerPageTools(server, client) {
     function buildStatusResponse(operation, result) {
         const response = {
-            status: "SUCCESS",
+            status: 'SUCCESS',
             operation,
-            pageUID: result.uid || result.pageUID || result.id
+            pageUID: result.uid || result.pageUID || result.id,
         };
-        if (operation === "create" && result.name) {
+        if (operation === 'create' && result.name) {
             response.name = result.name;
         }
         return JSON.stringify(response, null, 2);
@@ -105,21 +167,23 @@ export function registerPageTools(server, client) {
         const { operation } = params;
         debugLogWithTag('MANAGE_PAGE', `${operation} page operation`);
         try {
-            if (operation === "create") {
+            if (operation === 'create') {
                 if (!params.workspaceId || !params.typeInternalName) {
                     return {
-                        content: [{
-                                type: "text",
-                                text: "Error: workspaceId and typeInternalName are required when operation='create'."
-                            }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: "Error: workspaceId and typeInternalName are required when operation='create'.",
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 const requestBody = {
                     workspaceId: params.workspaceId,
-                    typeInternalName: params.typeInternalName
+                    typeInternalName: params.typeInternalName,
                 };
-                if (params.name !== undefined && params.name !== null && params.name !== "") {
+                if (params.name !== undefined && params.name !== null && params.name !== '') {
                     requestBody.name = params.name;
                 }
                 if (params.parentUID) {
@@ -141,35 +205,37 @@ export function registerPageTools(server, client) {
                 debugLogWithTag('MANAGE_PAGE', `Request body: ${JSON.stringify(requestBody, null, 2)}`);
                 const result = await client.makeApiRequest('json/page/create', 'POST', undefined, requestBody);
                 debugLogWithTag('MANAGE_PAGE', `Successfully created page: ${params.name}`);
-                if (params.responseFormat === "full") {
+                if (params.responseFormat === 'full') {
                     const sizeCheck = checkResponseSize(result);
                     if (sizeCheck.tooLarge) {
-                        const statusJson = JSON.parse(buildStatusResponse("create", result));
+                        const statusJson = JSON.parse(buildStatusResponse('create', result));
                         statusJson.note = `Full response omitted (${sizeCheck.actualSize} chars exceeds limit). Use cplace_get_by_uid to inspect, or use responseFormat='status'.`;
                         return {
-                            content: [{ type: "text", text: JSON.stringify(statusJson, null, 2) }]
+                            content: [{ type: 'text', text: JSON.stringify(statusJson, null, 2) }],
                         };
                     }
                     return {
-                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                     };
                 }
                 return {
-                    content: [{ type: "text", text: buildStatusResponse("create", result) }]
+                    content: [{ type: 'text', text: buildStatusResponse('create', result) }],
                 };
             }
             else {
                 if (!params.pageUID) {
                     return {
-                        content: [{
-                                type: "text",
-                                text: "Error: pageUID is required when operation='update'. Specify the UID of the page to update."
-                            }],
-                        isError: true
+                        content: [
+                            {
+                                type: 'text',
+                                text: "Error: pageUID is required when operation='update'. Specify the UID of the page to update.",
+                            },
+                        ],
+                        isError: true,
                     };
                 }
                 const requestBody = {
-                    pageUID: params.pageUID
+                    pageUID: params.pageUID,
                 };
                 if (params.name !== undefined)
                     requestBody.name = params.name;
@@ -185,37 +251,44 @@ export function registerPageTools(server, client) {
                 }
                 if (Object.keys(requestBody).length === 1) {
                     return {
-                        content: [{ type: "text", text: "No updates specified. At least one of name, content, parentUID, attributes, or builtinAttributes must be provided." }]
+                        content: [
+                            {
+                                type: 'text',
+                                text: 'No updates specified. At least one of name, content, parentUID, attributes, or builtinAttributes must be provided.',
+                            },
+                        ],
                     };
                 }
                 const result = await client.makeApiRequest('json/page', 'PATCH', undefined, requestBody);
                 debugLogWithTag('MANAGE_PAGE', `Successfully updated page: ${params.pageUID}`);
-                if (params.responseFormat === "full") {
+                if (params.responseFormat === 'full') {
                     const sizeCheck = checkResponseSize(result);
                     if (sizeCheck.tooLarge) {
-                        const statusJson = JSON.parse(buildStatusResponse("update", result));
+                        const statusJson = JSON.parse(buildStatusResponse('update', result));
                         statusJson.note = `Full response omitted (${sizeCheck.actualSize} chars exceeds limit). Use cplace_get_by_uid to inspect, or use responseFormat='status'.`;
                         return {
-                            content: [{ type: "text", text: JSON.stringify(statusJson, null, 2) }]
+                            content: [{ type: 'text', text: JSON.stringify(statusJson, null, 2) }],
                         };
                     }
                     return {
-                        content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
                     };
                 }
                 return {
-                    content: [{ type: "text", text: buildStatusResponse("update", result) }]
+                    content: [{ type: 'text', text: buildStatusResponse('update', result) }],
                 };
             }
         }
         catch (error) {
             debugLogWithTag('MANAGE_PAGE', `Error ${operation} page: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{
-                        type: "text",
-                        text: `Error ${operation} page: ${error instanceof Error ? error.message : String(error)}`
-                    }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error ${operation} page: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -237,14 +310,26 @@ export function registerPageTools(server, client) {
             }
             debugLogWithTag('DELETE_PAGE', `Successfully deleted page: ${pageUID}`);
             return {
-                content: [{ type: "text", text: typeof parsedResult === 'object' ? JSON.stringify(parsedResult, null, 2) : String(parsedResult) }]
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof parsedResult === 'object'
+                            ? JSON.stringify(parsedResult, null, 2)
+                            : String(parsedResult),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('DELETE_PAGE', `Error deleting page: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error deleting page: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error deleting page: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -253,7 +338,7 @@ export function registerPageTools(server, client) {
         try {
             const requestBody = {
                 pageUID,
-                confirmDeleteChildren
+                confirmDeleteChildren,
             };
             const result = await client.makeApiRequest('json/page/with-children', 'DELETE', undefined, requestBody);
             let parsedResult;
@@ -270,14 +355,26 @@ export function registerPageTools(server, client) {
             }
             debugLogWithTag('DELETE_PAGE_WITH_CHILDREN', `Deletion operation completed for: ${pageUID}`);
             return {
-                content: [{ type: "text", text: typeof parsedResult === 'object' ? JSON.stringify(parsedResult, null, 2) : String(parsedResult) }]
+                content: [
+                    {
+                        type: 'text',
+                        text: typeof parsedResult === 'object'
+                            ? JSON.stringify(parsedResult, null, 2)
+                            : String(parsedResult),
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('DELETE_PAGE_WITH_CHILDREN', `Error deleting page with children: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error deleting page with children: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error deleting page with children: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -290,30 +387,32 @@ export function registerPageTools(server, client) {
             if (!hasWorkspace && !hasParent) {
                 debugLogWithTag('COPY_PAGE', 'Validation failed: No target specified');
                 return {
-                    content: [{
-                            type: "text",
-                            text: "Error: Either targetWorkspaceId or targetParentUID must be provided. Specify exactly one target location for the copied page."
-                        }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Either targetWorkspaceId or targetParentUID must be provided. Specify exactly one target location for the copied page.',
+                        },
+                    ],
+                    isError: true,
                 };
             }
             if (hasWorkspace && hasParent) {
                 debugLogWithTag('COPY_PAGE', 'Validation failed: Both targets specified');
                 return {
-                    content: [{
-                            type: "text",
-                            text: "Error: Only one of targetWorkspaceId or targetParentUID can be provided, not both. Choose a single target location."
-                        }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'Error: Only one of targetWorkspaceId or targetParentUID can be provided, not both. Choose a single target location.',
+                        },
+                    ],
+                    isError: true,
                 };
             }
-            const endpoint = includeChildren
-                ? 'json/page/copy-with-children'
-                : 'json/page/copy';
+            const endpoint = includeChildren ? 'json/page/copy-with-children' : 'json/page/copy';
             const requestBody = {
                 sourcePageUID: params.sourcePageUID,
                 includeComments: params.includeComments ?? false,
-                includeFiles: params.includeFiles ?? true
+                includeFiles: params.includeFiles ?? true,
             };
             if (params.targetWorkspaceId)
                 requestBody.targetWorkspaceId = params.targetWorkspaceId;
@@ -338,7 +437,7 @@ export function registerPageTools(server, client) {
                 debugLogWithTag('COPY_PAGE', `Successfully copied page: ${params.sourcePageUID}`);
             }
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
@@ -348,54 +447,80 @@ export function registerPageTools(server, client) {
             if (childMatch) {
                 const childCount = childMatch[1];
                 return {
-                    content: [{
-                            type: "text",
-                            text: `This page has ${childCount} children. Retry with includeChildren: true and confirmCopyChildren: false to preview.`
-                        }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `This page has ${childCount} children. Retry with includeChildren: true and confirmCopyChildren: false to preview.`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             return {
-                content: [{
-                        type: "text",
-                        text: `Error copying page: ${errorMessage}`
-                    }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error copying page: ${errorMessage}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
     server.registerTool(TOOL_EDIT_PAGE_CONTENT, PAGE_TOOL_DEFINITIONS[TOOL_EDIT_PAGE_CONTENT], async ({ pageUID, old_str, new_str, replace_all = false }) => {
         debugLogWithTag('EDIT_PAGE_CONTENT', `Editing content of page ${pageUID}`);
         try {
-            const page = await client.makeApiRequest('json/page', 'GET', { pageUID });
+            const page = (await client.makeApiRequest('json/page', 'GET', { pageUID }));
             const content = page.wikiMarkup;
             if (content === undefined || content === null) {
                 return {
-                    content: [{ type: "text", text: `Error: Page ${pageUID} has no wiki content to edit.` }],
-                    isError: true
+                    content: [
+                        { type: 'text', text: `Error: Page ${pageUID} has no wiki content to edit.` },
+                    ],
+                    isError: true,
                 };
             }
             const result = applyStrReplace(content, old_str, new_str, replace_all);
             if (!result.success) {
                 return {
-                    content: [{ type: "text", text: `Error: ${result.error}` }],
-                    isError: true
+                    content: [{ type: 'text', text: `Error: ${result.error}` }],
+                    isError: true,
                 };
             }
             await client.makeApiRequest('json/page', 'PATCH', undefined, {
                 pageUID,
-                content: result.newContent
+                content: result.newContent,
             });
+            const reReadPage = (await client.makeApiRequest('json/page', 'GET', { pageUID }));
+            const storedContent = reReadPage.wikiMarkup;
+            const storedPreview = storedContent
+                ? storedContent.length > 500
+                    ? storedContent.substring(0, 500) + '...'
+                    : storedContent
+                : null;
+            const normalizationNote = storedPreview
+                ? `\n\nNote: The stored content may differ from what was submitted due to server-side CSS normalization (properties alphabetized, hex→rgb, whitespace regularized). Current stored form (first 500 chars):\n${storedPreview}`
+                : '';
             debugLogWithTag('EDIT_PAGE_CONTENT', `Successfully edited page content (${result.replacementCount} replacement(s))`);
             return {
-                content: [{ type: "text", text: `Successfully edited page content. Replaced ${result.replacementCount} occurrence(s).` }]
+                content: [
+                    {
+                        type: 'text',
+                        text: `Successfully edited page content. Replaced ${result.replacementCount} occurrence(s).${normalizationNote}`,
+                    },
+                ],
             };
         }
         catch (error) {
             debugLogWithTag('EDIT_PAGE_CONTENT', `Error: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error editing page content: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error editing page content: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });