@cplace/mcp-server 1.3.14

package/dist/tools/users.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.js","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAC5D,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAGxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,CAAC,uBAAuB,CAAC,EAAE;QACzB,WAAW,EAAE,yDAAyD;QACtE,WAAW,EAAE;YACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0DAA0D,CAAC;SACtF;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE;KAC7C;IACD,CAAC,qBAAqB,CAAC,EAAE;QACvB,WAAW,EAAE,6FAA6F;QAC1G,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE;KAC3C;CACO,CAAC;AAEX,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,MAAuB;IAC1E,MAAM,CAAC,YAAY,CAAC,uBAAuB,EACzC,qBAAqB,CAAC,uBAAuB,CAAC,EAC9C,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3E,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,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC1H,OAAO,EAAE,IAAI;aACd,CAAC;QAEJ,CAAC;IACH,CAAC,CACF,CAAC;IAGF,MAAM,CAAC,YAAY,CAAC,qBAAqB,EACvC,qBAAqB,CAAC,qBAAqB,CAAC,EAC5C,KAAK,IAAI,EAAE;QACT,eAAe,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC;QAEjE,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;YAEhE,eAAe,CAAC,cAAc,EAAE,oCAAoC,CAAC,CAAC;YAEtE,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,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8CAA8C,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBACzI,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/validators.d.ts

@@ -0,0 +1,32 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const VALIDATOR_TOOL_DEFINITIONS: {
+    readonly cplace_get_validator_by_attribute: {
+        readonly description: "Retrieves the JavaScript validator script and metadata for a specific attribute definition. Returns comprehensive context information including workspace, type, and attribute details along with the validator code if it exists.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly typeInternalName: z.ZodString;
+            readonly attributeName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Validator by Attribute";
+        };
+    };
+    readonly cplace_manage_validator: {
+        readonly description: "Create or update JavaScript validators for attribute definitions. Validators are JavaScript functions executed to validate attribute values during page creation and updates.";
+        readonly inputSchema: {
+            readonly operation: z.ZodEnum<["create", "update"]>;
+            readonly workspaceId: z.ZodString;
+            readonly typeInternalName: z.ZodString;
+            readonly attributeName: z.ZodString;
+            readonly script: z.ZodOptional<z.ZodString>;
+            readonly description: z.ZodOptional<z.ZodString>;
+        };
+        readonly annotations: {
+            readonly title: "Manage Validator";
+        };
+    };
+};
+export declare function registerValidatorTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=validators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.ts","sourceRoot":"","sources":["../../src/tools/validators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAO5C,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;CAsB7B,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAuFhF"}

package/dist/tools/validators.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+const TOOL_GET_VALIDATOR_BY_ATTRIBUTE = 'cplace_get_validator_by_attribute';
+const TOOL_MANAGE_VALIDATOR = 'cplace_manage_validator';
+export const VALIDATOR_TOOL_DEFINITIONS = {
+    [TOOL_GET_VALIDATOR_BY_ATTRIBUTE]: {
+        description: "Retrieves the JavaScript validator script and metadata for a specific attribute definition. Returns comprehensive context information including workspace, type, and attribute details along with the validator code if it exists.",
+        inputSchema: {
+            workspaceId: z.string().describe("The workspace identifier (e.g., 'abc123')"),
+            typeInternalName: z.string().describe("The internal name of the type definition (e.g., 'cf.example.task')"),
+            attributeName: z.string().describe("The name of the attribute (e.g., 'taskTitle')")
+        },
+        annotations: { title: "Get Validator by Attribute" }
+    },
+    [TOOL_MANAGE_VALIDATOR]: {
+        description: "Create or update JavaScript validators for attribute definitions. Validators are JavaScript functions executed to validate attribute values during page creation and updates.",
+        inputSchema: {
+            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new validators, 'update' for existing validators"),
+            workspaceId: z.string().describe("Required: Target workspace identifier (e.g., 'abc123')"),
+            typeInternalName: z.string().describe("Required: Target type internal name (e.g., 'cf.example.task')"),
+            attributeName: z.string().describe("Required: Target attribute name (e.g., 'taskTitle')"),
+            script: z.string().optional().describe("⚠️ REQUIRED: Review cplace Low-Code documentation before writing validator scripts. Access via web (https://docs.cplace.io/lowcode/features/validators/), MCP tools, or local file system."),
+            description: z.string().optional().describe("Optional: Human-readable description of the validator")
+        },
+        annotations: { title: "Manage Validator" }
+    }
+};
+export function registerValidatorTools(server, client) {
+    server.registerTool(TOOL_GET_VALIDATOR_BY_ATTRIBUTE, VALIDATOR_TOOL_DEFINITIONS[TOOL_GET_VALIDATOR_BY_ATTRIBUTE], async ({ workspaceId, typeInternalName, attributeName }) => {
+        try {
+            const result = await client.makeApiRequest('json/validator', 'GET', {
+                workspaceId,
+                typeInternalName,
+                attributeName
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving validator: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_MANAGE_VALIDATOR, VALIDATOR_TOOL_DEFINITIONS[TOOL_MANAGE_VALIDATOR], async (params) => {
+        try {
+            if (params.operation === "create") {
+                if (!params.script) {
+                    return {
+                        content: [{ type: "text", text: "Error: Create operation requires script parameter" }],
+                        isError: true
+                    };
+                }
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeInternalName: params.typeInternalName,
+                    attributeName: params.attributeName,
+                    script: params.script
+                };
+                if (params.description) {
+                    requestBody.description = params.description;
+                }
+                const result = await client.makeApiRequest('json/validator', 'POST', undefined, requestBody);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            else {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeInternalName: params.typeInternalName,
+                    attributeName: params.attributeName
+                };
+                if (params.script !== undefined) {
+                    requestBody.script = params.script;
+                }
+                if (params.description !== undefined) {
+                    requestBody.description = params.description;
+                }
+                const result = await client.makeApiRequest('json/validator', 'PATCH', undefined, requestBody);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+        }
+        catch (error) {
+            const operationText = params.operation === "create" ? "creating" : "updating";
+            return {
+                content: [{ type: "text", text: `Error ${operationText} validator: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=validators.js.map

package/dist/tools/validators.js.map

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

package/dist/tools/version-check.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from "../api.js";
+export declare function registerVersionCheckTool(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=version-check.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/tools/version-check.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8B5C,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqFlF"}

package/dist/tools/version-check.js

@@ -0,0 +1,96 @@
+import semver from 'semver';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+const TOOL_CHECK_VERSION_COMPATIBILITY = 'cplace_check_version_compatibility';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJsonPath = join(__dirname, '../../package.json');
+function readPackageVersion() {
+    try {
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        return packageJson.version;
+    }
+    catch (error) {
+        console.error('Warning: Could not read package.json version:', error);
+        return 'unknown';
+    }
+}
+const FRONTEND_VERSION = readPackageVersion();
+export function registerVersionCheckTool(server, client) {
+    server.registerTool(TOOL_CHECK_VERSION_COMPATIBILITY, {
+        description: "Check version compatibility between this MCP server package and the cplace backend API. Compares the npm package version (package.json) with the backend's expected version to detect mismatches. Returns compatibility status and provides guidance on whether to upgrade/downgrade the MCP server or upgrade the backend to resolve version mismatches.",
+        inputSchema: {},
+        annotations: { title: "Check Version Compatibility" }
+    }, async () => {
+        try {
+            const backendResponse = await client.makeApiRequest('json/version', 'GET');
+            const backendExpectedVersion = backendResponse.apiVersion;
+            const isCompatible = semver.satisfies(FRONTEND_VERSION, backendExpectedVersion);
+            if (isCompatible) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "compatible",
+                                message: "✅ Package version matches backend expectations",
+                                details: {
+                                    frontendPackageVersion: FRONTEND_VERSION,
+                                    backendExpectedVersion: backendExpectedVersion,
+                                    packageName: "@cplace/mcp-server"
+                                }
+                            }, null, 2)
+                        }]
+                };
+            }
+            else {
+                const minVersion = semver.minVersion(backendExpectedVersion);
+                const isBelowRange = minVersion && semver.lt(FRONTEND_VERSION, minVersion.version);
+                const guidance = isBelowRange
+                    ? {
+                        action: "MCP SERVER UPGRADE NEEDED",
+                        recommendation: `Upgrade MCP server package to version ${minVersion?.version} or higher. If using npx without version pin, simply restart Claude to auto-upgrade. Otherwise, update your configuration to @cplace/mcp-server@${minVersion?.version} or later.`,
+                        explanation: `Backend accepts versions matching: ${backendExpectedVersion}. Your version ${FRONTEND_VERSION} is below the minimum required.`
+                    }
+                    : {
+                        action: "MCP SERVER DOWNGRADE OR BACKEND UPGRADE NEEDED",
+                        recommendation: `Two resolution options:
+Option A: Downgrade MCP server to a version matching ${backendExpectedVersion} by updating your Claude Desktop/Code configuration
+Option B: Contact administrator to upgrade cplace backend to support version ${FRONTEND_VERSION}`,
+                        explanation: `Your MCP server package version ${FRONTEND_VERSION} is newer than what the backend accepts (${backendExpectedVersion}). Backend needs to be updated to declare a range that includes your version.`
+                    };
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                status: "mismatch",
+                                message: "⚠️ VERSION MISMATCH DETECTED",
+                                details: {
+                                    frontendPackageVersion: FRONTEND_VERSION,
+                                    backendExpectedVersion: backendExpectedVersion,
+                                    packageName: "@cplace/mcp-server"
+                                },
+                                ...guidance
+                            }, null, 2)
+                        }],
+                    isError: true
+                };
+            }
+        }
+        catch (error) {
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify({
+                            status: "error",
+                            message: "❌ Unable to check version compatibility",
+                            reason: error instanceof Error ? error.message : String(error),
+                            suggestion: "Ensure backend endpoint 'json/version' is available. This may indicate the backend needs to be upgraded to support version checking."
+                        }, null, 2)
+                    }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=version-check.js.map

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

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

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

@@ -0,0 +1,52 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const VERSION_HISTORY_TOOL_DEFINITIONS: {
+    readonly cplace_get_page_changesets: {
+        readonly description: "Get all changesets (modification records) for a specific page within an optional time range. Returns changes in reverse chronological order.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+            readonly fromTimestamp: z.ZodOptional<z.ZodNumber>;
+            readonly toTimestamp: z.ZodOptional<z.ZodNumber>;
+            readonly offset: z.ZodOptional<z.ZodNumber>;
+            readonly limit: z.ZodOptional<z.ZodNumber>;
+        };
+        readonly annotations: {
+            readonly title: "Get Page ChangeSets";
+        };
+    };
+    readonly cplace_get_page_state_at_timestamp: {
+        readonly description: "Reconstruct and return the complete state of a page as it was at a specific point in time.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+            readonly timestamp: z.ZodNumber;
+        };
+        readonly annotations: {
+            readonly title: "Get Page State at Timestamp";
+        };
+    };
+    readonly cplace_get_page_diff: {
+        readonly description: "Compare page states between two timestamps and return the differences. If toTimestamp is not provided, compares with current state.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+            readonly fromTimestamp: z.ZodNumber;
+            readonly toTimestamp: z.ZodOptional<z.ZodNumber>;
+        };
+        readonly annotations: {
+            readonly title: "Get Page Diff";
+        };
+    };
+    readonly cplace_get_page_changesets_summary: {
+        readonly description: "Get a summary of recent changes for a page. This is a convenience tool that retrieves changesets for the last 7 days by default.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+            readonly daysBack: z.ZodOptional<z.ZodNumber>;
+            readonly limit: z.ZodOptional<z.ZodNumber>;
+        };
+        readonly annotations: {
+            readonly title: "Get Page Recent Changes Summary";
+        };
+    };
+};
+export declare function registerVersionHistoryTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=version-history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"version-history.d.ts","sourceRoot":"","sources":["../../src/tools/version-history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAU5C,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCnC,CAAC;AAEX,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqJrF"}

package/dist/tools/version-history.js

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

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

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

package/dist/tools/widgets.d.ts

@@ -0,0 +1,28 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const WIDGET_TOOL_DEFINITIONS: {
+    readonly cplace_list_widget_definitions: {
+        readonly description: "Get a list of all available widget definitions in the system that support the specified embedding context, with their basic metadata including names, descriptions, and apps.\n\n⚠️ APP DEPENDENCY CHECK: Each widget includes a 'requiredApp' field:\n- null: Widget is always available (platform widget, no app dependency)\n- \"cf.cplace.someApp\": Widget requires this app to be installed in the workspace\n\nBEFORE SELECTING A WIDGET for a specific workspace, verify the required app is installed using cplace_list_workspace_apps. Widgets with uninstalled requiredApp cannot be added to layouts.";
+        readonly inputSchema: {
+            readonly embeddingContext: z.ZodDefault<z.ZodEnum<["AS_WIDGET", "INSIDE_RICHSTRING", "INSIDE_WIDGET"]>>;
+            readonly tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        };
+        readonly annotations: {
+            readonly title: "List Widget Definitions";
+        };
+    };
+    readonly cplace_get_widget_definition: {
+        readonly description: "Get widget definition as a markdown Config Reference Card optimized for writing layout.define() scripts.\n\nALWAYS includes:\n- Widget kind as heading\n- Summary paragraph\n\nOPTIONAL depth control:\n- includeOverview: true → adds conceptual documentation (## Overview)\n- includeDetails: true → adds implementation hints (## Implementation) and config attributes grouped by required/optional (## Config Attributes)\n\nCOMMON USAGE:\n- Quick check: just widgetKinds (minimal response)\n- Understanding: includeOverview: true\n- Implementation: includeDetails: true\n- Full details: both flags true\n\nWidget kinds: 'cf.platform.connectedBarChart', 'cf.platform.wiki', etc.\nMultiple widgets in one call are separated by --- horizontal rules.";
+        readonly inputSchema: {
+            readonly widgetKinds: z.ZodArray<z.ZodString, "many">;
+            readonly includeOverview: z.ZodDefault<z.ZodBoolean>;
+            readonly includeDetails: z.ZodDefault<z.ZodBoolean>;
+        };
+        readonly annotations: {
+            readonly title: "Get Widget Definition";
+        };
+    };
+};
+export declare function registerWidgetTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=widgets.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"widgets.d.ts","sourceRoot":"","sources":["../../src/tools/widgets.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;AAgD5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;CA4C1B,CAAC;AAsKX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAsF7E"}