@cplace/test-mcp-server 0.1.8 → 0.1.10

package/dist/tools/version-history.js

@@ -0,0 +1,142 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+export function registerVersionHistoryTools(server, client) {
+    server.registerTool("cplace_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" }
+    }, 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)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_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" }
+    }, 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)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_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" }
+    }, 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)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_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" }
+    }, 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)}` }]
+            };
+        }
+    });
+}
+//# 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,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from '../api.js';
+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;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AA8B5C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAwoB7E"}