@cplace/mcp-server 1.3.14

package/dist/tools/script-logs.js

@@ -0,0 +1,144 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+const TOOL_GET_SCRIPT_LOGS = 'cplace_get_script_logs';
+export const SCRIPT_LOGS_TOOL_DEFINITIONS = {
+    [TOOL_GET_SCRIPT_LOGS]: {
+        description: `Retrieve filtered and paginated script execution logs for debugging and monitoring low-code scripts.
+
+Supports comprehensive filtering by:
+- Script identity (scriptId, logName)
+- Context (spaceId, userId, correlationId)
+- Log level (logType, messageType)
+- Message content (message, logMatch)
+- Time range (logDateFrom, logDateTo)
+
+Security Model:
+- Administrators and low-code editors: Full access to all logs
+- Regular users: Must provide scriptId parameter
+
+Response Size Management:
+- By default, stack traces are truncated to 500 characters to save tokens
+- Use includeFullStackTraces=true to get complete stack traces when needed
+- If response is still too large, use more specific filters or smaller pageSize`,
+        inputSchema: {
+            scriptId: z.string().optional().describe("Filter by specific script identifier (e.g., 'script/abc123'). Required for non-admin/non-low-code-editor users."),
+            logName: z.string().optional().describe("Filter by log marker name"),
+            spaceId: z.string().optional().describe("Filter by workspace ID (e.g., 'workspace/xyz789')"),
+            userId: z.string().optional().describe("Filter by user ID who triggered the execution"),
+            correlationId: z.string().optional().describe("Filter by correlation ID for tracing related operations"),
+            logType: z.enum(['debug', 'error', 'all']).optional().describe("Filter by log category (default: 'all')"),
+            messageType: z.enum(['DEBUG', 'ERROR', 'INFO', 'WARN']).optional().describe("Filter by message severity"),
+            message: z.string().optional().describe("Filter by message text content"),
+            logMatch: z.enum(['prefix', 'contains', 'exact']).optional().describe("Message matching mode (default: 'contains'). 'prefix' matches start of message, 'contains' matches anywhere, 'exact' requires exact match."),
+            logDateFrom: z.string().optional().describe("Start date/time in ISO 8601 format or Unix timestamp in milliseconds (e.g., '2025-10-01T00:00:00Z' or '1696118400000')"),
+            logDateTo: z.string().optional().describe("End date/time in ISO 8601 format or Unix timestamp in milliseconds"),
+            page: z.number().min(1).optional().describe("Page number to retrieve (default: 1, min: 1)"),
+            pageSize: z.number().min(1).max(100).optional().describe("Number of log entries per page (default: 25, min: 1, max: 100)"),
+            includeFullStackTraces: z.boolean().optional().describe("Include complete stack traces without truncation (default: false). When false, stack traces are truncated to 500 characters to save tokens. Set to true when you need full stack traces for deep debugging.")
+        },
+        annotations: { title: "Get Script Logs" }
+    }
+};
+function truncateStackTraces(logs, maxLength = 500) {
+    if (!logs || !Array.isArray(logs)) {
+        return logs;
+    }
+    return logs.map(log => {
+        if (!log || typeof log !== 'object') {
+            return log;
+        }
+        if (log.stackTrace && typeof log.stackTrace === 'string' && log.stackTrace.length > maxLength) {
+            return {
+                ...log,
+                stackTrace: log.stackTrace.substring(0, maxLength) +
+                    '\n\n...[truncated - use includeFullStackTraces=true for full trace]',
+                stackTraceLength: log.stackTrace.length,
+                stackTraceTruncated: true
+            };
+        }
+        return log;
+    });
+}
+export function registerScriptLogsTools(server, client) {
+    server.registerTool(TOOL_GET_SCRIPT_LOGS, SCRIPT_LOGS_TOOL_DEFINITIONS[TOOL_GET_SCRIPT_LOGS], async ({ scriptId, logName, spaceId, userId, correlationId, logType, messageType, message, logMatch, logDateFrom, logDateTo, page, pageSize, includeFullStackTraces }) => {
+        debugLogWithTag('SCRIPT_LOGS', `Getting script logs with filters: ${JSON.stringify({
+            scriptId,
+            logName,
+            spaceId,
+            userId,
+            correlationId,
+            logType,
+            messageType,
+            message,
+            logMatch,
+            logDateFrom,
+            logDateTo,
+            page,
+            pageSize,
+            includeFullStackTraces
+        })}`);
+        try {
+            const queryParams = {};
+            if (scriptId !== undefined)
+                queryParams.scriptId = scriptId;
+            if (logName !== undefined)
+                queryParams.logName = logName;
+            if (spaceId !== undefined)
+                queryParams.spaceId = spaceId;
+            if (userId !== undefined)
+                queryParams.userId = userId;
+            if (correlationId !== undefined)
+                queryParams.correlationId = correlationId;
+            if (logType !== undefined)
+                queryParams.logType = logType;
+            if (messageType !== undefined)
+                queryParams.messageType = messageType;
+            if (message !== undefined)
+                queryParams.message = message;
+            if (logMatch !== undefined)
+                queryParams.logMatch = logMatch;
+            if (logDateFrom !== undefined)
+                queryParams.logDateFrom = logDateFrom;
+            if (logDateTo !== undefined)
+                queryParams.logDateTo = logDateTo;
+            if (page !== undefined)
+                queryParams.page = page;
+            if (pageSize !== undefined)
+                queryParams.pageSize = pageSize;
+            debugLogWithTag('SCRIPT_LOGS', `Request query params: ${JSON.stringify(queryParams, null, 2)}`);
+            const result = await client.makeApiRequest('json/script-logs', 'GET', queryParams, undefined);
+            let processedResult = result;
+            if (!includeFullStackTraces && result.logs && Array.isArray(result.logs)) {
+                debugLogWithTag('SCRIPT_LOGS', `Truncating stack traces for ${result.logs.length} log entries`);
+                processedResult = {
+                    ...result,
+                    logs: truncateStackTraces(result.logs, 500)
+                };
+            }
+            const sizeCheck = checkResponseSize(processedResult);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('SCRIPT_LOGS', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `${sizeCheck.suggestion}\n\nTip: Use more specific filters (scriptId, spaceId, time range) or smaller pageSize parameter. If you need full stack traces, first reduce the result count, then use includeFullStackTraces=true.`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('SCRIPT_LOGS', `Successfully retrieved ${result.logs?.length || 0} log entries`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(processedResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SCRIPT_LOGS', `Error retrieving script logs: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error retrieving script logs: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=script-logs.js.map

package/dist/tools/script-logs.js.map

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

package/dist/tools/script.d.ts

@@ -0,0 +1,25 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const SCRIPT_TOOL_DEFINITIONS: {
+    readonly cplace_execute_script: {
+        readonly description: "Execute JavaScript in a sandboxed cplace environment for data queries, calculations, and analysis.\n\n**Mode**: Read-only - scripts cannot modify data (no page.set, cplace.actions.createPage, etc.)\n\n**Timeout**: 30 seconds maximum execution time\n\n**Return Value Restrictions**:\n- Primitives: strings, numbers, booleans, null, dates (as ISO strings)\n- Arrays containing only primitives (no nested arrays or objects)\n- Objects containing only primitive values (no nested objects)\n- Cannot return cplace objects (Page, Person) directly - extract values first\n\n**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.";
+        readonly inputSchema: {
+            readonly script: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Execute Script";
+        };
+    };
+    readonly cplace_execute_script_write: {
+        readonly description: "⚠️ WRITE OPERATIONS ENABLED: Execute JavaScript that can create, modify, and delete pages.\n\nRequires low-code edit permission (mayEditLowCode). Use cplace_execute_script for read-only operations.\n\n**Timeout**: 30 seconds maximum execution time\n\n**Available Action APIs**:\n- cplace.actions().createPage(params) - Create new pages\n- page.set(attributeName, value) - Set attribute values on pages\n- cplace.actions().deletePage(page) - Delete pages\n\n**Return Value Restrictions**: Same as read-only tool (primitives, flat arrays/objects only)\n\n**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.";
+        readonly inputSchema: {
+            readonly script: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Execute Script (Write)";
+        };
+    };
+};
+export declare function registerScriptTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=script.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"script.d.ts","sourceRoot":"","sources":["../../src/tools/script.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;AAS5C,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;CAsD1B,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA4F7E"}

package/dist/tools/script.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+const TOOL_EXECUTE_SCRIPT = 'cplace_execute_script';
+const TOOL_EXECUTE_SCRIPT_WRITE = 'cplace_execute_script_write';
+export const SCRIPT_TOOL_DEFINITIONS = {
+    [TOOL_EXECUTE_SCRIPT]: {
+        description: `Execute JavaScript in a sandboxed cplace environment for data queries, calculations, and analysis.
+
+**Mode**: Read-only - scripts cannot modify data (no page.set, cplace.actions.createPage, etc.)
+
+**Timeout**: 30 seconds maximum execution time
+
+**Return Value Restrictions**:
+- Primitives: strings, numbers, booleans, null, dates (as ISO strings)
+- Arrays containing only primitives (no nested arrays or objects)
+- Objects containing only primitive values (no nested objects)
+- Cannot return cplace objects (Page, Person) directly - extract values first
+
+**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute. Must return a JSON-serializable value.
+
+The script has access to cplace low-code APIs (cplace.search, cplace.pages, Filters, etc.) but runs in read-only mode.
+
+Examples:
+- Simple: "return 2 + 2"
+- Search: "return cplace.search().add(Filters.type('cf.cplace.project')).findAll().map(function(p) { return p.getName(); });"
+- Extract: "var page = cplace.search().add(Filters.uid('page/abc')).findFirst(); return { name: page.getName() };"`)
+        },
+        annotations: { title: "Execute Script" }
+    },
+    [TOOL_EXECUTE_SCRIPT_WRITE]: {
+        description: `⚠️ WRITE OPERATIONS ENABLED: Execute JavaScript that can create, modify, and delete pages.
+
+Requires low-code edit permission (mayEditLowCode). Use cplace_execute_script for read-only operations.
+
+**Timeout**: 30 seconds maximum execution time
+
+**Available Action APIs**:
+- cplace.actions().createPage(params) - Create new pages
+- page.set(attributeName, value) - Set attribute values on pages
+- cplace.actions().deletePage(page) - Delete pages
+
+**Return Value Restrictions**: Same as read-only tool (primitives, flat arrays/objects only)
+
+**Important**: This tool requires knowledge of the cplace low-code JavaScript API. Ensure you have access to cplace low-code documentation to write effective scripts.`,
+        inputSchema: {
+            script: z.string().describe(`JavaScript code to execute with write capabilities. Must return a JSON-serializable value.
+
+The script has access to all cplace low-code APIs including action APIs for creating, modifying, and deleting pages.
+
+Examples:
+- Create page: "var page = cplace.actions().createPage({ space: cplace.utils().getSpaceByName('My Workspace'), customType: 'cf.cplace.project.Task', customAttributes: { 'cf.cplace.project.title': 'New Task' } }); return { uid: page.getUid(), name: page.getName() };"
+- Update page: "var page = cplace.utils().getPageById('page/abc123'); page.set('cf.cplace.project.status', 'Completed'); return { success: true };"
+- Delete page: "var page = cplace.utils().getPageById('page/abc123'); cplace.actions().deletePage(page); return { deleted: true };"`)
+        },
+        annotations: { title: "Execute Script (Write)" }
+    }
+};
+export function registerScriptTools(server, client) {
+    server.registerTool(TOOL_EXECUTE_SCRIPT, SCRIPT_TOOL_DEFINITIONS[TOOL_EXECUTE_SCRIPT], async ({ script }) => {
+        debugLogWithTag('SCRIPT', `Executing script (${script.length} chars)`);
+        try {
+            const response = await client.makeApiRequest('json/script/execute', 'POST', undefined, { script });
+            const result = { result: response };
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('SCRIPT', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Script result too large (${sizeCheck.actualSize} characters). Modify your script to return less data (e.g., use .slice(), limit array size, or return specific fields only).`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('SCRIPT', 'Script executed successfully');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SCRIPT', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error executing script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_EXECUTE_SCRIPT_WRITE, SCRIPT_TOOL_DEFINITIONS[TOOL_EXECUTE_SCRIPT_WRITE], async ({ script }) => {
+        debugLogWithTag('SCRIPT', `Executing write script (${script.length} chars)`);
+        try {
+            const response = await client.makeApiRequest('json/script/execute-with-actions', 'POST', undefined, { script });
+            const result = { result: response };
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('SCRIPT', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Script result too large (${sizeCheck.actualSize} characters). Modify your script to return less data (e.g., use .slice(), limit array size, or return specific fields only).`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('SCRIPT', 'Write script executed successfully');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SCRIPT', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error executing script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=script.js.map

package/dist/tools/script.js.map

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