@cplace/test-mcp-server 0.1.9 → 0.1.11

package/dist/tools/search.js

@@ -0,0 +1,304 @@
+import { z } from "zod";
+import SearchFilterSchema from "../searchSchema.js";
+import { convertSearchFilterToCplaceFormat } from "../searchConversion.js";
+import { filterSearchResult, checkResponseSize } from "../utils.js";
+import { debugLogWithTag } from "../logger.js";
+import { convertPagesToCsv } from "../csvUtils.js";
+export function registerSearchTools(server, client) {
+    server.registerTool("cplace_search_pages", {
+        description: "Search pages of a type in cplace.",
+        inputSchema: {
+            workspaceId: z.string().optional().describe("The ID of the workspace to search in. If not provided, searches across all accessible workspaces."),
+            internalTypeName: z.string().describe(`The internal name of the type to filter by. Examples:
+- "cf.cplace.solution.safe.feature" for Feature pages
+- "cf.cplace.solution.safe.epic" for Epic pages  
+- "cf.cplace.solution.safe.story" for Story pages
+- "cf.projectNavigator.project" for Project pages
+- "cf.cplace.solution.safe.portfolio" for Portfolio pages
+Use cplace_get_types_in_workspace to discover available types in a workspace.`),
+            search_filter: SearchFilterSchema.describe(`Search Filters using cplace filter format. Examples:
+
+Basic string filter:
+[{"attribute": "cf.cplace.workflow", "string": {"equals": "approved"}}]
+
+Multiple conditions:
+[
+  {"name": {"equals": "Project Alpha"}},
+  {"attribute": "cf.cplace.location", "reference": {"equals": "page/abc123"}}
+]
+
+Date range filter:
+[
+  {"attribute": "cf.cplace.projectStart", "date": {"on_or_after": "2023-01-01"}},
+  {"attribute": "cf.cplace.projectFinish", "date": {"on_or_before": "2024-12-31"}}
+]
+
+Number comparison:
+[{"attribute": "cf.cplace.estimatedCost", "number": {"greater_than": 1000}}]
+
+Logical OR operator:
+[{
+  "or": [
+    {"attribute": "cf.cplace.managementPriority", "string": {"equals": "Focus"}},
+    {"attribute": "cf.cplace.managementPriority", "string": {"equals": "Accelerate"}}
+  ]
+}]
+
+Complex AND/OR combination:
+[{
+  "and": [
+    {"attribute": "cf.cplace.workflow", "string": {"equals": "inProgress"}},
+    {
+      "or": [
+        {"attribute": "cf.cplace.priority", "string": {"equals": "High"}},
+        {"attribute": "cf.cplace.priority", "string": {"equals": "Critical"}}
+      ]
+    }
+  ]
+}]
+
+Boolean filter:
+[{"attribute": "cf.cplace.isActive", "boolean": {"equals": true}}]
+
+Empty/not empty checks:
+[{"attribute": "cf.cplace.description", "string": {"is_not_empty": true}}]`),
+            limit: z.number().min(1).max(1000).default(50).describe("Maximum number of results to return (1-1000)"),
+            offset: z.number().min(0).max(10000).default(0).describe("Number of results to skip for pagination, cannot be larger than 10000"),
+            responseFormat: z.enum(["minimal", "count"]).optional().describe(`Response format options:
+- Default (not specified): Complete page data, respects 'attributes' parameter
+- "minimal": Only core fields (id, name, url, type, workspace)
+- "count": Only return the total count of matching pages`),
+            attributes: z.array(z.string()).optional().describe("Specific attribute names to include in response. If not provided, all attributes are included. Examples: ['cf.cplace.workflow', 'cf.cplace.priority']"),
+        },
+        annotations: { title: "Search Pages" }
+    }, async ({ workspaceId, internalTypeName, search_filter, limit = 50, offset = 0, responseFormat, attributes, }) => {
+        debugLogWithTag('SEARCH', `Starting search with params: workspaceId=${workspaceId || 'none'}, type=${internalTypeName}, filter=${JSON.stringify(search_filter)}, limit=${limit}, offset=${offset}`);
+        try {
+            const cplaceFilter = convertSearchFilterToCplaceFormat(search_filter);
+            debugLogWithTag('SEARCH', `Converted filter: ${JSON.stringify(cplaceFilter)}`);
+            if (workspaceId) {
+                cplaceFilter.filters.unshift({
+                    type: "Workspace",
+                    workspaceIds: [workspaceId]
+                });
+            }
+            if (internalTypeName) {
+                cplaceFilter.filters.unshift({
+                    type: "Type",
+                    types: [internalTypeName]
+                });
+            }
+            debugLogWithTag('SEARCH', `Final cplace filter: ${JSON.stringify(cplaceFilter)}`);
+            const result = await client.makeApiRequest('json/search', 'GET', {
+                filter: JSON.stringify(cplaceFilter),
+                limit,
+                offset
+            });
+            if (responseFormat === "count") {
+                const countResult = {
+                    count: result.pagination?.total || 0
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(countResult, null, 2) }]
+                };
+            }
+            const filteredResults = result.results ? result.results.map((item) => filterSearchResult(item, {
+                minimal: responseFormat === "minimal",
+                includeAttributes: responseFormat !== "minimal",
+                includeMetadata: false,
+                attributeFields: attributes,
+                truncateLargeValues: true
+            })) : [];
+            const filteredResult = {
+                results: filteredResults,
+                pagination: {
+                    total: result.pagination?.total || 0,
+                    limit: result.pagination?.limit || limit,
+                    offset: result.pagination?.offset || offset,
+                    hasMore: result.pagination?.hasMore || false
+                },
+                humanReadableRepresentation: result.summary,
+                cplaceJson: result.cplaceJson
+            };
+            const sizeCheck = checkResponseSize(filteredResult);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{ type: "text", text: sizeCheck.suggestion }]
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filteredResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('SEARCH', `Error during search: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error converting or executing search: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_search_pages_fulltext", {
+        description: "Make a fulltext search across all pages in cplace. Use this when searching for text content within pages.",
+        inputSchema: {
+            workspaceId: z.string().optional().describe("The ID of the workspace to search in. If not provided, searches across all accessible workspaces."),
+            fulltext: z.string().describe("The fulltext search query to filter pages by. The results will include pages that contain this string in their name, attributes, or content."),
+            limit: z.number().min(1).max(1000).default(50).describe("Maximum number of results to return (1-1000)"),
+            offset: z.number().min(0).max(10000).default(0).describe("Number of results to skip for pagination, cannot be larger than 10000"),
+        },
+        annotations: { title: "Search Pages by Fulltext" }
+    }, async ({ workspaceId, fulltext, limit = 50, offset = 0, }) => {
+        if (!fulltext) {
+            return {
+                content: [{ type: "text", text: "fulltext is required" }]
+            };
+        }
+        try {
+            const result = await client.makeApiRequest('json/fulltext-search', 'GET', {
+                workspaceId: workspaceId,
+                fulltext: `"${fulltext}"`,
+                limit,
+                offset
+            });
+            const filteredResults = result.results ? result.results.map((item) => filterSearchResult(item, {
+                minimal: false,
+                includeAttributes: true,
+                includeMetadata: false,
+                truncateLargeValues: true
+            })) : [];
+            const filteredResult = {
+                results: filteredResults,
+                pagination: {
+                    total: result.pagination?.total || 0,
+                    limit: result.pagination?.limit || limit,
+                    offset: result.pagination?.offset || offset,
+                    hasMore: result.pagination?.hasMore || false
+                },
+                summary: result.summary,
+                cplaceJson: result.cplaceJson
+            };
+            const sizeCheck = checkResponseSize(filteredResult);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{ type: "text", text: sizeCheck.suggestion }]
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filteredResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error converting or executing search: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_list_pages_of_type", {
+        description: "List all pages of a specific type in a workspace in cplace. Use this to retrieve multiple pages of the same type.",
+        inputSchema: {
+            workspaceId: z.string().describe("The ID of the workspace to get pages from"),
+            typeName: z.string().describe("The internal name of the type to retrieve pages for"),
+            limit: z.number().min(1).max(1000).default(50).describe("Maximum number of results to return (1-1000)"),
+            offset: z.number().min(0).max(10000).default(0).describe("Number of results to skip for pagination, cannot be larger than 10000"),
+        },
+        annotations: { title: "List Pages of Type" }
+    }, async ({ workspaceId, typeName, limit = 50, offset = 0, }) => {
+        try {
+            const cplaceFilter = {
+                filters: [
+                    {
+                        type: "Workspace",
+                        workspaceIds: [workspaceId]
+                    },
+                    {
+                        type: "Type",
+                        types: [typeName]
+                    }
+                ]
+            };
+            const result = await client.makeApiRequest('json/search', 'GET', {
+                filter: JSON.stringify(cplaceFilter),
+                limit,
+                offset
+            });
+            const filteredResults = result.results ? result.results.map((item) => filterSearchResult(item, {
+                minimal: false,
+                includeAttributes: true,
+                includeMetadata: false,
+                truncateLargeValues: true
+            })) : [];
+            const filteredResult = {
+                results: filteredResults,
+                pagination: {
+                    total: result.pagination?.total || 0,
+                    limit: result.pagination?.limit || limit,
+                    offset: result.pagination?.offset || offset,
+                    hasMore: result.pagination?.hasMore || false
+                },
+                summary: result.summary
+            };
+            const sizeCheck = checkResponseSize(filteredResult);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{ type: "text", text: sizeCheck.suggestion }]
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filteredResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving pages: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_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.",
+        inputSchema: {
+            workspaceId: z.string().optional().describe("Same as cplace_search_pages"),
+            internalTypeName: z.string().describe("Same as cplace_search_pages"),
+            search_filter: SearchFilterSchema.describe("Same as cplace_search_pages"),
+            limit: z.number().min(1).max(1000).default(50).describe("Same as cplace_search_pages"),
+            offset: 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)" }
+    }, async ({ workspaceId, internalTypeName, search_filter, limit = 50, offset = 0, attributes, }) => {
+        debugLogWithTag('CSV_SEARCH', `Starting CSV search with params: workspaceId=${workspaceId || 'none'}, type=${internalTypeName}, filter=${JSON.stringify(search_filter)}, limit=${limit}, offset=${offset}`);
+        try {
+            const cplaceFilter = convertSearchFilterToCplaceFormat(search_filter);
+            debugLogWithTag('CSV_SEARCH', `Converted filter: ${JSON.stringify(cplaceFilter)}`);
+            if (workspaceId) {
+                cplaceFilter.filters.unshift({
+                    type: "Workspace",
+                    workspaceIds: [workspaceId]
+                });
+            }
+            if (internalTypeName) {
+                cplaceFilter.filters.unshift({
+                    type: "Type",
+                    types: [internalTypeName]
+                });
+            }
+            debugLogWithTag('CSV_SEARCH', `Final cplace filter: ${JSON.stringify(cplaceFilter)}`);
+            const result = await client.makeApiRequest('json/search', 'GET', {
+                filter: JSON.stringify(cplaceFilter),
+                limit,
+                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 }]
+            };
+        }
+        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)}` }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

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

package/dist/tools/system.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerSystemTools(server: McpServer, config: any): void;
+//# sourceMappingURL=system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAGpE,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,QAwBjE"}

package/dist/tools/system.js

@@ -0,0 +1,22 @@
+import { DEBUG_LOGGING } from "../logger.js";
+export function registerSystemTools(server, config) {
+    if (config.registerSystemInfoTool) {
+        server.registerTool("cplace_get_system_info", {
+            description: "Get system information about the MCP server - including current working directory, CPLACE_URL setting, and debug state",
+            inputSchema: {},
+            annotations: { title: "Get System Information" }
+        }, async () => {
+            const systemInfo = {
+                currentWorkingDirectory: process.cwd(),
+                cplaceUrl: config.url || 'Not set',
+                debugLogging: DEBUG_LOGGING,
+                nodeVersion: process.version,
+                platform: process.platform
+            };
+            return {
+                content: [{ type: "text", text: JSON.stringify(systemInfo, null, 2) }]
+            };
+        });
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/tools/system.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.js","sourceRoot":"","sources":["../../src/tools/system.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,MAAW;IAEhE,IAAI,MAAM,CAAC,sBAAsB,EAAE,CAAC;QAClC,MAAM,CAAC,YAAY,CAAC,wBAAwB,EAC5C;YACE,WAAW,EAAE,wHAAwH;YACrI,WAAW,EAAE,EAAE;YACf,WAAW,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE;SACjD,EACD,KAAK,IAAI,EAAE;YACT,MAAM,UAAU,GAAG;gBACjB,uBAAuB,EAAE,OAAO,CAAC,GAAG,EAAE;gBACtC,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,SAAS;gBAClC,YAAY,EAAE,aAAa;gBAC3B,WAAW,EAAE,OAAO,CAAC,OAAO;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B,CAAC;YAEF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC;QACJ,CAAC,CACF,CAAC;IACF,CAAC;AACH,CAAC"}

package/dist/tools/type-layouts.d.ts

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

package/dist/tools/type-layouts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-layouts.d.ts","sourceRoot":"","sources":["../../src/tools/type-layouts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAU5C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAqEjF"}

package/dist/tools/type-layouts.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+export function registerTypeLayoutTools(server, client) {
+    server.registerTool("cplace_get_type_layout", {
+        description: "Retrieves the widget layout structure of a specific type definition, including all widget configurations and layout definitions. This endpoint returns the effective layout used by the type, which can be either the default layout or an alternative layout.",
+        inputSchema: {
+            workspaceId: z.string().describe("The ID of the workspace containing the type definition"),
+            typeInternalName: z.string().describe("The internal name of the type definition"),
+            alternativeLayoutName: z.string().optional().describe("The name of the alternative layout to retrieve. If not provided, returns the default layout")
+        },
+        annotations: { title: "Get Type Layout" }
+    }, async ({ workspaceId, typeInternalName, alternativeLayoutName }) => {
+        debugLogWithTag('TYPE_LAYOUT', `Getting type layout for ${typeInternalName} in workspace ${workspaceId}${alternativeLayoutName ? ` (layout: ${alternativeLayoutName})` : ' (default)'}`);
+        try {
+            const params = { workspaceId, typeInternalName };
+            if (alternativeLayoutName) {
+                params.alternativeLayoutName = alternativeLayoutName;
+            }
+            const result = await client.makeApiRequest('json/typeLayout', 'GET', params);
+            debugLogWithTag('TYPE_LAYOUT', `Successfully retrieved type layout for ${typeInternalName}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('TYPE_LAYOUT', `Error retrieving type layout: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error retrieving type layout: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_list_type_alternative_layouts", {
+        description: "Retrieves a comprehensive list of all available layouts for a specific type definition, including the default layout and all alternative layouts, along with usage statistics.",
+        inputSchema: {
+            workspaceId: z.string().describe("The ID of the workspace containing the type definition"),
+            typeInternalName: z.string().describe("The internal name of the type definition")
+        },
+        annotations: { title: "List Type Alternative Layouts" }
+    }, async ({ workspaceId, typeInternalName }) => {
+        debugLogWithTag('TYPE_LAYOUT', `Listing alternative layouts for type ${typeInternalName} in workspace ${workspaceId}`);
+        try {
+            const result = await client.makeApiRequest('json/typeLayout/list', 'GET', { workspaceId, typeInternalName });
+            debugLogWithTag('TYPE_LAYOUT', `Successfully listed layouts for type ${typeInternalName}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('TYPE_LAYOUT', `Error listing type layouts: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error listing type layouts: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=type-layouts.js.map

package/dist/tools/type-layouts.js.map

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

package/dist/tools/users.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA0E3E"}

package/dist/tools/users.js

@@ -0,0 +1,62 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+export function registerUserTools(server, client) {
+    server.registerTool("cplace_get_person_by_id", {
+        description: "Get details about a person including their name and email.",
+        inputSchema: {
+            id: z.string().describe("The ID of the person to get, e.g. 'person/kkt8ol745jqur4581kelm5ply'")
+        },
+        annotations: { title: "Get Person by ID" }
+    }, async ({ id }) => {
+        try {
+            const result = await client.makeApiRequest('json/person', 'GET', { id });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving person: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_get_person_by_name", {
+        description: "Get details about a person by searching for their name.",
+        inputSchema: {
+            name: z.string().describe("The name of the person or part of the name to search for"),
+        },
+        annotations: { title: "Get Person by Name" }
+    }, async ({ name }) => {
+        try {
+            const result = await client.makeApiRequest('json/person', 'GET', { name });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error searching for person: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_get_current_user", {
+        description: "Get information about the currently logged-in user, including their attributes and metadata",
+        inputSchema: {},
+        annotations: { title: "Get Current User" }
+    }, async () => {
+        debugLogWithTag('CURRENT_USER', 'Starting current user request');
+        try {
+            const result = await client.makeApiRequest('json/current-user');
+            debugLogWithTag('CURRENT_USER', `Retrieved current user information`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving current user information: ${error instanceof Error ? error.message : String(error)}` }]
+            };
+        }
+    });
+}
+//# sourceMappingURL=users.js.map

package/dist/tools/users.js.map

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

package/dist/tools/validators.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from '../api.js';
+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;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE5C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAuGhF"}

package/dist/tools/validators.js

@@ -0,0 +1,87 @@
+import { z } from "zod";
+export function registerValidatorTools(server, client) {
+    server.registerTool("cplace_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., 'workspace/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" }
+    }, 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)}` }]
+            };
+        }
+    });
+    server.registerTool("cplace_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., 'workspace/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" }
+    }, async (params) => {
+        try {
+            if (params.operation === "create") {
+                if (!params.script) {
+                    return {
+                        content: [{ type: "text", text: "Error: Create operation requires script parameter" }]
+                    };
+                }
+                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)}` }]
+            };
+        }
+    });
+}
+//# 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-history.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from '../api.js';
+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;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAG5C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAkLrF"}