@cplace/mcp-server 1.9.1 → 1.10.6

package/dist/tools/csv-export.js

@@ -1,60 +1,65 @@
-import { z } from "zod";
-import SearchFilterSchema from "../searchSchema.js";
-import { convertSearchFilterToCplaceFormat } from "../searchConversion.js";
-import { debugLogWithTag } from "../logger.js";
-import { convertPagesToCsv } from "../csvUtils.js";
-import { jsonStringToArray, coerceNumber } from "./common-schemas.js";
+import { z } from 'zod';
+import SearchFilterSchema from '../searchSchema.js';
+import { convertSearchFilterToCplaceFormat } from '../searchConversion.js';
+import { debugLogWithTag } from '../logger.js';
+import { convertPagesToCsv } from '../csvUtils.js';
+import { jsonStringToArray, coerceNumber } from './common-schemas.js';
 const TOOL_SEARCH_PAGES_CSV = 'cplace_search_pages_csv';
 export const CSV_EXPORT_TOOL_DEFINITIONS = {
     [TOOL_SEARCH_PAGES_CSV]: {
-        description: "Same as cplace_search_pages but returns results in CSV format instead of JSON. Only use this tool after first calling cplace_search_pages to establish and validate the search parameters. The CSV result should always be stored as an artifact.\n\nIMPORTANT: Date filter values must use date-only format (YYYY-MM-DD). Datetime formats are not supported. See cplace_search_pages for full details.\n\nNote: Embedded widget tags (`<decoded-widget>`) are stripped from CSV output — only surrounding text is preserved.",
+        description: 'Same as cplace_search_pages but returns results in CSV format instead of JSON. Only use this tool after first calling cplace_search_pages to establish and validate the search parameters. The CSV result should always be stored as an artifact.\n\nIMPORTANT: Date filter values must use date-only format (YYYY-MM-DD). Datetime formats are not supported. See cplace_search_pages for full details.\n\nNote: Embedded widget tags (`<decoded-widget>`) are stripped from CSV output — only surrounding text is preserved.',
         inputSchema: {
-            workspaceId: z.string().optional().describe("Same as cplace_search_pages"),
-            typeInternalName: z.string().describe("Same as cplace_search_pages"),
-            searchFilter: jsonStringToArray(z.union([SearchFilterSchema, z.string()])).describe("Same as cplace_search_pages"),
-            limit: coerceNumber(z.number().min(1).max(1000).default(50)).describe("Same as cplace_search_pages"),
-            offset: coerceNumber(z.number().min(0).max(10000).default(0)).describe("Same as cplace_search_pages"),
-            attributes: z.array(z.string()).optional().describe("Same as cplace_search_pages"),
+            workspaceId: z.string().optional().describe('Same as cplace_search_pages'),
+            typeInternalName: z.string().describe('Same as cplace_search_pages'),
+            searchFilter: jsonStringToArray(z.union([SearchFilterSchema, z.string()])).describe('Same as cplace_search_pages'),
+            limit: coerceNumber(z.number().min(1).max(1000).default(50)).describe('Same as cplace_search_pages'),
+            offset: coerceNumber(z.number().min(0).max(10000).default(0)).describe('Same as cplace_search_pages'),
+            attributes: z.array(z.string()).optional().describe('Same as cplace_search_pages'),
         },
-        annotations: { title: "Search Pages (CSV Export)" }
-    }
+        annotations: { title: 'Search Pages (CSV Export)' },
+    },
 };
 export function registerCsvExportTools(server, client) {
-    server.registerTool(TOOL_SEARCH_PAGES_CSV, CSV_EXPORT_TOOL_DEFINITIONS[TOOL_SEARCH_PAGES_CSV], async ({ workspaceId, typeInternalName, searchFilter, limit = 50, offset = 0, attributes, }) => {
+    server.registerTool(TOOL_SEARCH_PAGES_CSV, CSV_EXPORT_TOOL_DEFINITIONS[TOOL_SEARCH_PAGES_CSV], async ({ workspaceId, typeInternalName, searchFilter, limit = 50, offset = 0, attributes }) => {
         debugLogWithTag('CSV_SEARCH', `Starting CSV search with params: workspaceId=${workspaceId || 'none'}, type=${typeInternalName}, filter=${JSON.stringify(searchFilter)}, limit=${limit}, offset=${offset}`);
         try {
             const cplaceFilter = convertSearchFilterToCplaceFormat(searchFilter);
             debugLogWithTag('CSV_SEARCH', `Converted filter: ${JSON.stringify(cplaceFilter)}`);
             if (workspaceId) {
                 cplaceFilter.filters.unshift({
-                    type: "Workspace",
-                    workspaceIds: [workspaceId]
+                    type: 'Workspace',
+                    workspaceIds: [workspaceId],
                 });
             }
             if (typeInternalName) {
                 cplaceFilter.filters.unshift({
-                    type: "Type",
-                    types: [typeInternalName]
+                    type: 'Type',
+                    types: [typeInternalName],
                 });
             }
             debugLogWithTag('CSV_SEARCH', `Final cplace filter: ${JSON.stringify(cplaceFilter)}`);
             const result = await client.makeApiRequest('json/search', 'GET', {
                 filter: JSON.stringify(cplaceFilter),
                 limit,
-                offset
+                offset,
             });
             const searchResults = result.results || [];
             debugLogWithTag('CSV_SEARCH', `Retrieved ${searchResults.length} results for CSV conversion`);
             const csvContent = await convertPagesToCsv(searchResults, client, attributes);
             return {
-                content: [{ type: "text", text: csvContent }]
+                content: [{ type: 'text', text: csvContent }],
             };
         }
         catch (error) {
             debugLogWithTag('CSV_SEARCH', `Error during CSV search: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error converting or executing CSV search: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error converting or executing CSV search: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });

package/dist/tools/csv-export.js.map

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

package/dist/tools/documents.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 DOCUMENT_TOOL_DEFINITIONS: {
     readonly cplace_get_document: {

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

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.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,yBAAyB;;;;;;;;;;;;CAU5B,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAuD/E"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/tools/documents.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,yBAAyB;;;;;;;;;;;;CA2B5B,CAAC;AAEX,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqE/E"}

package/dist/tools/documents.js

@@ -1,17 +1,27 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
-import { checkResponseSize } from "../utils.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
+import { checkResponseSize } from '../utils.js';
 const TOOL_GET_DOCUMENT = 'cplace_get_document';
 export const DOCUMENT_TOOL_DEFINITIONS = {
     [TOOL_GET_DOCUMENT]: {
-        description: "Get document details including fulltext content. Retrieves metadata and extracted text for a document by its UID. Document UIDs are found in page responses (documents array). Supports reading large documents in chunks via fulltextOffset and fulltextMaxLength parameters.",
+        description: 'Get document details including fulltext content. Retrieves metadata and extracted text for a document by its UID. Document UIDs are found in page responses (documents array). Supports reading large documents in chunks via fulltextOffset and fulltextMaxLength parameters.',
         inputSchema: {
-            documentUID: z.string().describe("The unique identifier of the document (e.g., 'document/abc123'). Found in the documents array of page responses. (parameter name is `documentUID`, NOT `uid`)"),
-            fulltextOffset: z.number().min(0).optional().describe("Character position to start reading fulltext from (default: 0). Use with fulltextMaxLength to read large documents in chunks."),
-            fulltextMaxLength: z.number().min(0).optional().describe("Maximum number of fulltext characters to return (default: 40000). Set to 0 to exclude fulltext entirely and return metadata only.")
+            documentUID: z
+                .string()
+                .describe("The unique identifier of the document (e.g., 'document/abc123'). Found in the documents array of page responses. (parameter name is `documentUID`, NOT `uid`)"),
+            fulltextOffset: z
+                .number()
+                .min(0)
+                .optional()
+                .describe('Character position to start reading fulltext from (default: 0). Use with fulltextMaxLength to read large documents in chunks.'),
+            fulltextMaxLength: z
+                .number()
+                .min(0)
+                .optional()
+                .describe('Maximum number of fulltext characters to return (default: 40000). Set to 0 to exclude fulltext entirely and return metadata only.'),
         },
-        annotations: { title: "Get Document" }
-    }
+        annotations: { title: 'Get Document' },
+    },
 };
 export function registerDocumentTools(server, client) {
     server.registerTool(TOOL_GET_DOCUMENT, DOCUMENT_TOOL_DEFINITIONS[TOOL_GET_DOCUMENT], async ({ documentUID, fulltextOffset, fulltextMaxLength }) => {
@@ -38,20 +48,30 @@ export function registerDocumentTools(server, client) {
             const sizeCheck = checkResponseSize(result);
             if (sizeCheck.tooLarge) {
                 return {
-                    content: [{ type: "text", text: `Response too large (${sizeCheck.actualSize} characters, max: 45000). Try reducing fulltextMaxLength (current: ${maxLength}) or set fulltextMaxLength to 0 to retrieve metadata only.` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Response too large (${sizeCheck.actualSize} characters, max: 45000). Try reducing fulltextMaxLength (current: ${maxLength}) or set fulltextMaxLength to 0 to retrieve metadata only.`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             debugLogWithTag('DOCUMENTS', `Successfully retrieved document: ${documentUID}`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('DOCUMENTS', `Error getting document: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error retrieving document: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving document: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });

package/dist/tools/documents.js.map

@@ -1 +1 @@
-{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGhD,MAAM,iBAAiB,GAAG,qBAAqB,CAAC;AAGhD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,CAAC,iBAAiB,CAAC,EAAE;QACnB,WAAW,EACT,gRAAgR;QAClR,WAAW,EAAE;YACX,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,QAAQ,CACP,+JAA+J,CAChK;YACH,cAAc,EAAE,CAAC;iBACd,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CACP,+HAA+H,CAChI;YACH,iBAAiB,EAAE,CAAC;iBACjB,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,EAAE;iBACV,QAAQ,CACP,mIAAmI,CACpI;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE;KACvC;CACO,CAAC;AAEX,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAuB;IAC9E,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB,yBAAyB,CAAC,iBAAiB,CAAC,EAC5C,KAAK,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,iBAAiB,EAAE,EAAE,EAAE;QAC3D,eAAe,CAAC,WAAW,EAAE,qBAAqB,WAAW,EAAE,CAAC,CAAC;QAEjE,MAAM,MAAM,GAAG,cAAc,IAAI,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,iBAAiB,IAAI,KAAK,CAAC;QAE7C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,KAAK,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;YAGpF,IAAI,MAAM,CAAC,QAAQ,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBAE9C,IAAI,SAAS,KAAK,CAAC,EAAE,CAAC;oBAEpB,OAAO,MAAM,CAAC,QAAQ,CAAC;oBACvB,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;oBAChC,MAAM,CAAC,sBAAsB,GAAG,cAAc,CAAC;oBAC/C,MAAM,CAAC,cAAc,GAAG,CAAC,CAAC;gBAC5B,CAAC;qBAAM,IAAI,MAAM,GAAG,CAAC,IAAI,cAAc,GAAG,MAAM,GAAG,SAAS,EAAE,CAAC;oBAE7D,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;oBACxE,MAAM,CAAC,iBAAiB,GAAG,IAAI,CAAC;oBAChC,MAAM,CAAC,sBAAsB,GAAG,cAAc,CAAC;oBAC/C,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC;gBACjC,CAAC;YAEH,CAAC;YAGD,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,uBAAuB,SAAS,CAAC,UAAU,sEAAsE,SAAS,4DAA4D;yBAC7L;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,eAAe,CAAC,WAAW,EAAE,oCAAoC,WAAW,EAAE,CAAC,CAAC;YAEhF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CACb,WAAW,EACX,2BAA2B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACpF,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAC7F;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/expert-settings.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 EXPERT_SETTINGS_TOOL_DEFINITIONS: {
     readonly cplace_get_expert_settings: {
@@ -22,7 +22,7 @@ export declare const EXPERT_SETTINGS_TOOL_DEFINITIONS: {
         };
     };
     readonly cplace_edit_expert_settings: {
-        readonly description: "Surgically edit a single expert settings field using str_replace. Finds and replaces exact text within the specified field (LESS, SCSS, CSS, or JavaScript). More token-efficient than full replacement for small changes in large stylesheets or scripts. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.";
+        readonly description: "Surgically edit a single expert settings field using str_replace. Finds and replaces exact text within the specified field (LESS, SCSS, CSS, or JavaScript). More token-efficient than full replacement for small changes in large stylesheets or scripts. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.\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 field: z.ZodEnum<["less", "scss", "css", "javascript"]>;
             readonly old_str: z.ZodString;

package/dist/tools/expert-settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"expert-settings.d.ts","sourceRoot":"","sources":["../../src/tools/expert-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAW5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA0IrF"}
+{"version":3,"file":"expert-settings.d.ts","sourceRoot":"","sources":["../../src/tools/expert-settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAW5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwDnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA2MrF"}

package/dist/tools/expert-settings.js

@@ -1,36 +1,55 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
-import { checkResponseSize } from "../utils.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
+import { checkResponseSize } from '../utils.js';
 import { applyStrReplace } from '../str-replace-utils.js';
 const TOOL_GET_EXPERT_SETTINGS = 'cplace_get_expert_settings';
 const TOOL_UPDATE_EXPERT_SETTINGS = 'cplace_update_expert_settings';
 const TOOL_EDIT_EXPERT_SETTINGS = 'cplace_edit_expert_settings';
 export const EXPERT_SETTINGS_TOOL_DEFINITIONS = {
     [TOOL_GET_EXPERT_SETTINGS]: {
-        description: "Retrieves all tenant-wide expert settings for theming: LESS variables, SCSS variables, custom CSS, and custom JavaScript. Also returns whether JavaScript editing is enabled on the server. Requires administrator privileges.",
+        description: 'Retrieves all tenant-wide expert settings for theming: LESS variables, SCSS variables, custom CSS, and custom JavaScript. Also returns whether JavaScript editing is enabled on the server. Requires administrator privileges.',
         inputSchema: {},
-        annotations: { title: "Get Expert Settings" }
+        annotations: { title: 'Get Expert Settings' },
     },
     [TOOL_UPDATE_EXPERT_SETTINGS]: {
-        description: "Updates one or more tenant-wide expert settings (LESS, SCSS, CSS, JavaScript). Only provided fields are updated; omitted fields remain unchanged. Send an empty string to clear a setting. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.",
+        description: 'Updates one or more tenant-wide expert settings (LESS, SCSS, CSS, JavaScript). Only provided fields are updated; omitted fields remain unchanged. Send an empty string to clear a setting. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.',
         inputSchema: {
-            less: z.string().optional().describe("Custom LESS variables content. Updating triggers async CSS compilation."),
-            scss: z.string().optional().describe("Custom SCSS variables content. Updating triggers async CSS compilation."),
-            css: z.string().optional().describe("Custom CSS content. Takes effect immediately (no compilation)."),
-            javascript: z.string().optional().describe("Custom JavaScript content. Requires server-side JavaScript editing to be enabled. Updates will be rejected if disabled.")
+            less: z
+                .string()
+                .optional()
+                .describe('Custom LESS variables content. Updating triggers async CSS compilation.'),
+            scss: z
+                .string()
+                .optional()
+                .describe('Custom SCSS variables content. Updating triggers async CSS compilation.'),
+            css: z
+                .string()
+                .optional()
+                .describe('Custom CSS content. Takes effect immediately (no compilation).'),
+            javascript: z
+                .string()
+                .optional()
+                .describe('Custom JavaScript content. Requires server-side JavaScript editing to be enabled. Updates will be rejected if disabled.'),
         },
-        annotations: { title: "Update Expert Settings" }
+        annotations: { title: 'Update Expert Settings' },
     },
     [TOOL_EDIT_EXPERT_SETTINGS]: {
-        description: "Surgically edit a single expert settings field using str_replace. Finds and replaces exact text within the specified field (LESS, SCSS, CSS, or JavaScript). More token-efficient than full replacement for small changes in large stylesheets or scripts. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.",
+        description: 'Surgically edit a single expert settings field using str_replace. Finds and replaces exact text within the specified field (LESS, SCSS, CSS, or JavaScript). More token-efficient than full replacement for small changes in large stylesheets or scripts. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.\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: {
-            field: z.enum(["less", "scss", "css", "javascript"]).describe("The expert settings field to edit. 'javascript' requires server-side JavaScript editing to be enabled."),
-            old_str: z.string().describe("The exact string to find in the field content. Must match exactly including whitespace and line breaks."),
-            new_str: z.string().describe("The replacement string."),
-            replace_all: z.boolean().optional().describe("If true, replace all occurrences. If false (default), requires exactly one match.")
+            field: z
+                .enum(['less', 'scss', 'css', 'javascript'])
+                .describe("The expert settings field to edit. 'javascript' requires server-side JavaScript editing to be enabled."),
+            old_str: z
+                .string()
+                .describe('The exact string to find in the field content. Must match exactly including whitespace and line breaks.'),
+            new_str: z.string().describe('The replacement string.'),
+            replace_all: z
+                .boolean()
+                .optional()
+                .describe('If true, replace all occurrences. If false (default), requires exactly one match.'),
         },
-        annotations: { title: "Edit Expert Settings" }
-    }
+        annotations: { title: 'Edit Expert Settings' },
+    },
 };
 export function registerExpertSettingsTools(server, client) {
     server.registerTool(TOOL_GET_EXPERT_SETTINGS, EXPERT_SETTINGS_TOOL_DEFINITIONS[TOOL_GET_EXPERT_SETTINGS], async () => {
@@ -40,19 +59,24 @@ export function registerExpertSettingsTools(server, client) {
             const sizeCheck = checkResponseSize(result);
             if (sizeCheck.tooLarge) {
                 return {
-                    content: [{ type: "text", text: `Error: ${sizeCheck.suggestion}` }],
-                    isError: true
+                    content: [{ type: 'text', text: `Error: ${sizeCheck.suggestion}` }],
+                    isError: true,
                 };
             }
             debugLogWithTag('EXPERT_SETTINGS', 'Successfully retrieved expert settings');
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `Error retrieving expert settings: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving expert settings: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -69,8 +93,13 @@ export function registerExpertSettingsTools(server, client) {
             body.javascript = javascript;
         if (Object.keys(body).length === 0) {
             return {
-                content: [{ type: "text", text: "Error: No fields provided. Supply at least one of: less, scss, css, javascript. Use an empty string to clear a setting." }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: 'Error: No fields provided. Supply at least one of: less, scss, css, javascript. Use an empty string to clear a setting.',
+                    },
+                ],
+                isError: true,
             };
         }
         try {
@@ -85,13 +114,18 @@ export function registerExpertSettingsTools(server, client) {
             }
             debugLogWithTag('EXPERT_SETTINGS', `Successfully updated fields: ${updatedFields.join(', ')}`);
             return {
-                content: [{ type: "text", text: response }]
+                content: [{ type: 'text', text: response }],
             };
         }
         catch (error) {
             return {
-                content: [{ type: "text", text: `Error updating expert settings: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error updating expert settings: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });
@@ -102,26 +136,46 @@ export function registerExpertSettingsTools(server, client) {
             const currentContent = settings[field];
             if (currentContent === undefined || currentContent === null) {
                 return {
-                    content: [{ type: "text", text: `Error: Field '${field}' is not available. ${field === 'javascript' ? 'JavaScript editing may be disabled on the server.' : 'The field has no content.'}` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Field '${field}' is not available. ${field === 'javascript' ? 'JavaScript editing may be disabled on the server.' : 'The field has no content.'}`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             if (currentContent === '') {
                 return {
-                    content: [{ type: "text", text: `Error: Field '${field}' is empty. Use cplace_update_expert_settings to set initial content.` }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: Field '${field}' is empty. Use cplace_update_expert_settings to set initial content.`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             const result = applyStrReplace(currentContent, 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,
                 };
             }
             const patchBody = { [field]: result.newContent };
             const patchResult = await client.makeApiRequest('json/expert-settings', 'PATCH', undefined, patchBody);
-            let response = `Successfully edited '${field}'. Replaced ${result.replacementCount} occurrence(s).`;
+            const reReadSettings = (await client.makeApiRequest('json/expert-settings', 'GET'));
+            const storedFieldContent = reReadSettings[field];
+            const storedPreview = storedFieldContent
+                ? storedFieldContent.length > 500
+                    ? storedFieldContent.substring(0, 500) + '...'
+                    : storedFieldContent
+                : 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}`
+                : '';
+            let response = `Successfully edited '${field}'. Replaced ${result.replacementCount} occurrence(s).${normalizationNote}`;
             if (patchResult.lessCompilationJobId) {
                 response += `\nLESS compilation job started: ${patchResult.lessCompilationJobId} (use cplace_get_job to check status)`;
             }
@@ -130,14 +184,19 @@ export function registerExpertSettingsTools(server, client) {
             }
             debugLogWithTag('EXPERT_SETTINGS', `Successfully edited '${field}' (${result.replacementCount} replacement(s))`);
             return {
-                content: [{ type: "text", text: response }]
+                content: [{ type: 'text', text: response }],
             };
         }
         catch (error) {
             debugLogWithTag('EXPERT_SETTINGS', `Error: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{ type: "text", text: `Error editing expert settings: ${error instanceof Error ? error.message : String(error)}` }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error editing expert settings: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });

package/dist/tools/expert-settings.js.map

@@ -1 +1 @@
-{"version":3,"file":"expert-settings.js","sourceRoot":"","sources":["../../src/tools/expert-settings.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"expert-settings.js","sourceRoot":"","sources":["../../src/tools/expert-settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,MAAM,wBAAwB,GAAG,4BAA4B,CAAC;AAC9D,MAAM,2BAA2B,GAAG,+BAA+B,CAAC;AACpE,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAGhE,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,CAAC,wBAAwB,CAAC,EAAE;QAC1B,WAAW,EACT,gOAAgO;QAClO,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,KAAK,EAAE,qBAAqB,EAAE;KAC9C;IACD,CAAC,2BAA2B,CAAC,EAAE;QAC7B,WAAW,EACT,mVAAmV;QACrV,WAAW,EAAE;YACX,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;YACtF,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,yEAAyE,CAAC;YACtF,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,gEAAgE,CAAC;YAC7E,UAAU,EAAE,CAAC;iBACV,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,yHAAyH,CAC1H;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE;KACjD;IACD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,WAAW,EACT,wuBAAwuB;QAC1uB,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;iBAC3C,QAAQ,CACP,wGAAwG,CACzG;YACH,OAAO,EAAE,CAAC;iBACP,MAAM,EAAE;iBACR,QAAQ,CACP,yGAAyG,CAC1G;YACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YACvD,WAAW,EAAE,CAAC;iBACX,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CACP,mFAAmF,CACpF;SACJ;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;KAC/C;CACO,CAAC;AAEX,MAAM,UAAU,2BAA2B,CAAC,MAAiB,EAAE,MAAuB;IAEpF,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB,gCAAgC,CAAC,wBAAwB,CAAC,EAC1D,KAAK,IAAI,EAAE;QACT,eAAe,CAAC,iBAAiB,EAAE,4BAA4B,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAE1E,MAAM,SAAS,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YAC5C,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC;oBAC5E,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,eAAe,CAAC,iBAAiB,EAAE,wCAAwC,CAAC,CAAC;YAC7E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,qCAAqC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACpG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAGF,MAAM,CAAC,YAAY,CACjB,2BAA2B,EAC3B,gCAAgC,CAAC,2BAA2B,CAAC,EAC7D,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE;QACxC,eAAe,CAAC,iBAAiB,EAAE,0BAA0B,CAAC,CAAC;QAG/D,MAAM,IAAI,GAA2B,EAAE,CAAC;QACxC,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACzC,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACzC,IAAI,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACtC,IAAI,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAE3D,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,yHAAyH;qBAChI;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CACxC,sBAAsB,EACtB,OAAO,EACP,SAAS,EACT,IAAI,CACL,CAAC;YAEF,MAAM,aAAa,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,QAAQ,GAAG,yCAAyC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAEnF,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;gBAChC,QAAQ,IAAI,mCAAmC,MAAM,CAAC,oBAAoB,uCAAuC,CAAC;YACpH,CAAC;YACD,IAAI,MAAM,CAAC,oBAAoB,EAAE,CAAC;gBAChC,QAAQ,IAAI,mCAAmC,MAAM,CAAC,oBAAoB,uCAAuC,CAAC;YACpH,CAAC;YAED,eAAe,CACb,iBAAiB,EACjB,gCAAgC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3D,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aACrD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,mCAAmC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBAClG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAGF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB,gCAAgC,CAAC,yBAAyB,CAAC,EAC3D,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,GAAG,KAAK,EAAE,EAAE,EAAE;QACzD,eAAe,CAAC,iBAAiB,EAAE,kCAAkC,KAAK,GAAG,CAAC,CAAC;QAE/E,IAAI,CAAC;YAEH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YAE5E,MAAM,cAAc,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAEvC,IAAI,cAAc,KAAK,SAAS,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;gBAC5D,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB,KAAK,uBAAuB,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,mDAAmD,CAAC,CAAC,CAAC,2BAA2B,EAAE;yBAChK;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAED,IAAI,cAAc,KAAK,EAAE,EAAE,CAAC;gBAC1B,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAe;4BACrB,IAAI,EAAE,iBAAiB,KAAK,uEAAuE;yBACpG;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAGD,MAAM,MAAM,GAAG,eAAe,CAAC,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;YAC9E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC;oBACpE,OAAO,EAAE,IAAI;iBACd,CAAC;YACJ,CAAC;YAGD,MAAM,SAAS,GAA2B,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;YACzE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,cAAc,CAC7C,sBAAsB,EACtB,OAAO,EACP,SAAS,EACT,SAAS,CACV,CAAC;YAGF,MAAM,cAAc,GAAG,CAAC,MAAM,MAAM,CAAC,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAQ,CAAC;YAC3F,MAAM,kBAAkB,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,kBAAkB;gBACtC,CAAC,CAAC,kBAAkB,CAAC,MAAM,GAAG,GAAG;oBAC/B,CAAC,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;oBAC9C,CAAC,CAAC,kBAAkB;gBACtB,CAAC,CAAC,IAAI,CAAC;YAET,MAAM,iBAAiB,GAAG,aAAa;gBACrC,CAAC,CAAC,4MAA4M,aAAa,EAAE;gBAC7N,CAAC,CAAC,EAAE,CAAC;YAEP,IAAI,QAAQ,GAAG,wBAAwB,KAAK,eAAe,MAAM,CAAC,gBAAgB,kBAAkB,iBAAiB,EAAE,CAAC;YAExH,IAAI,WAAW,CAAC,oBAAoB,EAAE,CAAC;gBACrC,QAAQ,IAAI,mCAAmC,WAAW,CAAC,oBAAoB,uCAAuC,CAAC;YACzH,CAAC;YACD,IAAI,WAAW,CAAC,oBAAoB,EAAE,CAAC;gBACrC,QAAQ,IAAI,mCAAmC,WAAW,CAAC,oBAAoB,uCAAuC,CAAC;YACzH,CAAC;YAED,eAAe,CACb,iBAAiB,EACjB,wBAAwB,KAAK,MAAM,MAAM,CAAC,gBAAgB,kBAAkB,CAC7E,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;aACrD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CACb,iBAAiB,EACjB,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACnE,CAAC;YACF,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE;qBACjG;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/get-operations.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 GET_OPERATIONS_TOOL_DEFINITIONS: {
     readonly cplace_get_by_uid: {

package/dist/tools/get-operations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-operations.d.ts","sourceRoot":"","sources":["../../src/tools/get-operations.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,+BAA+B;;;;;;;;;;CAQlC,CAAC;AAEX,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA8DnF"}
+{"version":3,"file":"get-operations.d.ts","sourceRoot":"","sources":["../../src/tools/get-operations.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,+BAA+B;;;;;;;;;;CAalC,CAAC;AAEX,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAoEnF"}

package/dist/tools/get-operations.js

@@ -1,15 +1,17 @@
-import { z } from "zod";
-import { debugLogWithTag } from "../logger.js";
-import { truncateDocumentSummaries } from "../utils.js";
+import { z } from 'zod';
+import { debugLogWithTag } from '../logger.js';
+import { truncateDocumentSummaries } from '../utils.js';
 const TOOL_GET_BY_UID = 'cplace_get_by_uid';
 export const GET_OPERATIONS_TOOL_DEFINITIONS = {
     [TOOL_GET_BY_UID]: {
-        description: "Get entity by UID. Retrieves detailed information for a page or person by their UID. Entity type is automatically detected from the UID format (page/... or person/...).",
+        description: 'Get entity by UID. Retrieves detailed information for a page or person by their UID. Entity type is automatically detected from the UID format (page/... or person/...).',
         inputSchema: {
-            uid: z.string().describe("The unique identifier. For pages: 'page/abc123'. For persons: 'person/user456'. Entity type is auto-detected from the prefix.")
+            uid: z
+                .string()
+                .describe("The unique identifier. For pages: 'page/abc123'. For persons: 'person/user456'. Entity type is auto-detected from the prefix."),
         },
-        annotations: { title: "Get Entity by UID" }
-    }
+        annotations: { title: 'Get Entity by UID' },
+    },
 };
 export function registerGetOperationTools(server, client) {
     server.registerTool(TOOL_GET_BY_UID, GET_OPERATIONS_TOOL_DEFINITIONS[TOOL_GET_BY_UID], async ({ uid }) => {
@@ -24,38 +26,44 @@ export function registerGetOperationTools(server, client) {
             }
             else {
                 return {
-                    content: [{
-                            type: "text",
-                            text: `Invalid UID format: '${uid}'. UID must start with 'page/' or 'person/'.`
-                        }],
-                    isError: true
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Invalid UID format: '${uid}'. UID must start with 'page/' or 'person/'.`,
+                        },
+                    ],
+                    isError: true,
                 };
             }
             const endpoints = {
                 page: 'json/page',
-                person: 'json/person'
+                person: 'json/person',
             };
             const paramNames = {
                 page: 'pageUID',
-                person: 'id'
+                person: 'id',
             };
-            const result = await client.makeApiRequest(endpoints[entityType], 'GET', { [paramNames[entityType]]: uid });
+            const result = await client.makeApiRequest(endpoints[entityType], 'GET', {
+                [paramNames[entityType]]: uid,
+            });
             if (entityType === 'page' && result.documents && Array.isArray(result.documents)) {
                 result.documents = truncateDocumentSummaries(result.documents);
             }
             debugLogWithTag('GET_BY_ID', `Successfully retrieved ${entityType}: ${uid}`);
             return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
             };
         }
         catch (error) {
             debugLogWithTag('GET_BY_ID', `Error getting entity: ${error instanceof Error ? error.message : String(error)}`);
             return {
-                content: [{
-                        type: "text",
-                        text: `Error retrieving entity: ${error instanceof Error ? error.message : String(error)}`
-                    }],
-                isError: true
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error retrieving entity: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
             };
         }
     });

package/dist/tools/get-operations.js.map

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