@cplace/mcp-server 1.3.14

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

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAgB,MAAM,WAAW,CAAC;AAa1D,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmJ1B,CAAC;AAEX,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA2O7E"}

package/dist/tools/search.js

@@ -0,0 +1,328 @@
+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 { DATE_FILTER_FORMAT_DESCRIPTION } from "./common-schemas.js";
+const TOOL_SEARCH_PAGES = 'cplace_search_pages';
+const TOOL_SEARCH_PAGES_FULLTEXT = 'cplace_search_pages_fulltext';
+const TOOL_LIST_PAGES_OF_TYPE = 'cplace_list_pages_of_type';
+export const SEARCH_TOOL_DEFINITIONS = {
+    [TOOL_SEARCH_PAGES]: {
+        description: "Search pages of a type in cplace. The response includes a 'cplaceJson' field - use this when configuring search for embedded table/list widgets (cf.platform.embeddedSearchAsTable, cf.platform.embeddedSearchAsList).",
+        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}}]
+
+Relative filter - Find tasks assigned to current user:
+[{"relativeReference": {"attribute": "cf.cplace.project.task.responsible", "operator": "sessionUser"}}]
+
+Relative filter - Find items due within next 7 days:
+[{"relativeDate": {"attribute": "dueDate", "operator": "lessEquals", "offset": 7}}]
+
+Relative filter - Find pages in same workspace as embedding entity:
+[{"relativeSpace": {}}]
+(Requires embeddingEntityUid parameter)
+
+Relative filter - Find items modified since last login:
+[{"relativeDate": {"attribute": "cf.cplace.modificationDate", "operator": "greaterEquals", "relativeToAttribute": "_lastLogin"}}]
+
+Relative filter - Combine with static filters:
+[
+  {"relativeReference": {"attribute": "assignee", "operator": "sessionUser"}},
+  {"attribute": "cf.cplace.workflow", "string": {"equals": "inProgress"}}
+]
+
+RELATIVE FILTER CONTEXT REQUIREMENTS:
+Some relative filters require context parameters:
+- relativeSpace: Requires embeddingEntityUid
+- relativeReference with embeddingCustomEntity, parentOfEmbeddingPage, ba_*, ca_*: Requires embeddingEntityUid
+- relativeReference with connectedTable, ctca_*: Requires connectedTableSelectionUid
+- relativeString, relativeNumber, relativeBoolean: Require embeddingEntityUid
+- relativeUid with connectedTable: Requires connectedTableSelectionUid
+
+Available relative filter types:
+- relativeReference: Dynamic reference filtering (sessionUser, embeddingCustomEntity, etc.)
+- relativeDate: Date filtering relative to today or last login
+- relativeString/relativeNumber/relativeBoolean: Copy values from embedding entity
+- relativeSpace: Filter to embedding entity's workspace
+- relativeUid: Filter by UID using dynamic reference
+- relativeBuiltinReference: Filter built-in reference attributes dynamically
+
+DATE FILTER FORMAT REQUIREMENTS:
+${DATE_FILTER_FORMAT_DESCRIPTION}
+
+Available date operators:
+- "equals": Exact date match
+- "after": Date is after the specified date (exclusive)
+- "before": Date is before the specified date (exclusive)
+- "on_or_after": Date is on or after the specified date (inclusive)
+- "on_or_before": Date is on or before the specified date (inclusive)
+
+Examples (date-only format required):
+[{"attribute": "cf.cplace.dueDate", "date": {"after": "2024-01-15"}}]
+[{"attribute": "cf.cplace.startDate", "date": {"on_or_after": "2024-01-15"}}]
+[{"attribute": "cf.cplace.endDate", "date": {"before": "2024-12-31"}}]`),
+            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']"),
+            embeddingEntityUid: z.string().optional().describe(`UID of the embedding entity for relative filters. Required for filters using:
+- relativeSpace (filters to same workspace as embedding entity)
+- relativeReference with operator: embeddingCustomEntity, parentOfEmbeddingPage, ba_*, ca_*
+- relativeString, relativeNumber, relativeBoolean (source from embedding entity)
+Example: "page/abc123def456"`),
+            connectedTableSelectionUid: z.string().optional().describe(`UID of the selected entity in a connected table. Required for filters using:
+- relativeReference with operator: connectedTable, ctca_*
+- relativeUid with operator: connectedTable
+Example: "page/xyz789"`),
+        },
+        annotations: { title: "Search Pages" }
+    },
+    [TOOL_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" }
+    },
+    [TOOL_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" }
+    }
+};
+export function registerSearchTools(server, client) {
+    server.registerTool(TOOL_SEARCH_PAGES, SEARCH_TOOL_DEFINITIONS[TOOL_SEARCH_PAGES], async ({ workspaceId, internalTypeName, search_filter, limit = 50, offset = 0, responseFormat, attributes, embeddingEntityUid, connectedTableSelectionUid, }) => {
+        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,
+                ...(embeddingEntityUid && { embeddingEntityUid }),
+                ...(connectedTableSelectionUid && { connectedTableSelectionUid }),
+            });
+            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)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_SEARCH_PAGES_FULLTEXT, SEARCH_TOOL_DEFINITIONS[TOOL_SEARCH_PAGES_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)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_LIST_PAGES_OF_TYPE, SEARCH_TOOL_DEFINITIONS[TOOL_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)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# 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,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CplaceApiClient } from "../api.js";
+export declare function registerSystemTools(server: McpServer, config: any, client?: CplaceApiClient): 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":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,eAAe,QA2G3F"}

package/dist/tools/system.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { DEBUG_LOGGING } from "../logger.js";
+import { registerVersionCheckTool } from "./version-check.js";
+const TOOL_GET_SYSTEM_INFO = 'cplace_get_system_info';
+const TOOL_GET_ICON_NAMES = 'cplace_get_icon_names';
+export function registerSystemTools(server, config, client) {
+    if (config.registerSystemInfoTool) {
+        server.registerTool(TOOL_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) }]
+            };
+        });
+    }
+    if (client) {
+        server.registerTool(TOOL_GET_ICON_NAMES, {
+            description: "Get all available icon names in the cplace system. Returns icon names from FontAwesome (fa-*), cplace custom icons (cf-*), and HUI utility icons (hui-*). Use this to discover valid icon names when configuring type definitions, layouts, workspaces, and widgets.\n\n⚠️ IMPORTANT: Single search terms often return suboptimal results. ALWAYS perform multiple searches with related terms to find the best icon. For example, when searching for project icons, try: 'project', 'folder', 'briefcase', 'tasks', 'board', 'chart', etc. Compare results and select the most appropriate icon.",
+            inputSchema: {
+                prefix: z.array(z.string()).optional().describe("Filter by icon prefixes. Available: ['fa', 'cf', 'hui']. Example: ['fa', 'cf']"),
+                search: z.string().optional().describe("Filter icons by search term (searches in icon names). Example: 'project', 'user', 'home'. TIP: Try multiple related search terms to find the best icon."),
+                limit: z.number().min(1).optional().describe("Maximum number of icons to return. If not specified, returns all matching icons."),
+                includeAll: z.boolean().optional().describe("Optional: If true, bypasses all filters and returns all available icons. Default: false")
+            },
+            annotations: { title: "Get Available Icon Names" }
+        }, async (params) => {
+            try {
+                const result = await client.makeApiRequest('json/icon-names', 'GET', {});
+                let iconNames = [];
+                if (result && typeof result === 'object' && 'result' in result && Array.isArray(result.result)) {
+                    iconNames = result.result;
+                }
+                else if (Array.isArray(result)) {
+                    iconNames = result;
+                }
+                else {
+                    throw new Error('Unexpected response format from icon names API');
+                }
+                if (params.includeAll) {
+                    return {
+                        content: [{ type: "text", text: JSON.stringify({ result: iconNames, totalCount: iconNames.length }, null, 2) }]
+                    };
+                }
+                let filteredIcons = iconNames;
+                if (params.prefix && params.prefix.length > 0) {
+                    filteredIcons = filteredIcons.filter(icon => params.prefix.some(prefix => icon.startsWith(`${prefix}-`)));
+                }
+                if (params.search) {
+                    const searchLower = params.search.toLowerCase();
+                    filteredIcons = filteredIcons.filter(icon => icon.toLowerCase().includes(searchLower));
+                }
+                if (params.limit) {
+                    filteredIcons = filteredIcons.slice(0, params.limit);
+                }
+                const response = {
+                    result: filteredIcons,
+                    totalCount: filteredIcons.length,
+                    totalAvailable: iconNames.length,
+                    filters: {
+                        prefix: params.prefix || null,
+                        search: params.search || null,
+                        limit: params.limit || null
+                    }
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error retrieving icon names: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true
+                };
+            }
+        });
+        registerVersionCheckTool(server, client);
+    }
+}
+//# 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":"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"}

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

@@ -0,0 +1,30 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const TYPE_LAYOUT_TOOL_DEFINITIONS: {
+    readonly cplace_list_type_alternative_layouts: {
+        readonly 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.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly typeInternalName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "List Type Alternative Layouts";
+        };
+    };
+    readonly cplace_create_type_alternative_layout: {
+        readonly description: "Creates a new alternative layout for a specific type definition. Alternative layouts allow types to support different presentation modes or views while maintaining the same underlying data structure. Each alternative layout has its own internal name, localized display names, and optional icon.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly typeInternalName: z.ZodString;
+            readonly internalName: z.ZodString;
+            readonly localizedNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            readonly iconName: z.ZodOptional<z.ZodString>;
+        };
+        readonly annotations: {
+            readonly title: "Create Type Alternative Layout";
+        };
+    };
+};
+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;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAQ5C,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;CAoB/B,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA+DjF"}

package/dist/tools/type-layouts.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+const TOOL_LIST_TYPE_ALTERNATIVE_LAYOUTS = 'cplace_list_type_alternative_layouts';
+const TOOL_CREATE_TYPE_ALTERNATIVE_LAYOUT = 'cplace_create_type_alternative_layout';
+export const TYPE_LAYOUT_TOOL_DEFINITIONS = {
+    [TOOL_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" }
+    },
+    [TOOL_CREATE_TYPE_ALTERNATIVE_LAYOUT]: {
+        description: "Creates a new alternative layout for a specific type definition. Alternative layouts allow types to support different presentation modes or views while maintaining the same underlying data structure. Each alternative layout has its own internal name, localized display names, and optional icon.",
+        inputSchema: {
+            workspaceId: z.string().describe("Required: ID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeInternalName: z.string().describe("Required: Internal name of the type definition (e.g., 'cf.project.Task')"),
+            internalName: z.string().describe("Required: Unique internal name for the new layout (e.g., 'compactView')"),
+            localizedNames: z.record(z.string()).optional().describe("Optional: Map of language codes to localized display names (e.g., {\"en\": \"Compact View\", \"de\": \"Kompakte Ansicht\"})"),
+            iconName: z.string().optional().describe("Optional: Font Awesome icon name for the layout (e.g., 'fa-compress')")
+        },
+        annotations: { title: "Create Type Alternative Layout" }
+    }
+};
+export function registerTypeLayoutTools(server, client) {
+    server.registerTool(TOOL_LIST_TYPE_ALTERNATIVE_LAYOUTS, TYPE_LAYOUT_TOOL_DEFINITIONS[TOOL_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)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_CREATE_TYPE_ALTERNATIVE_LAYOUT, TYPE_LAYOUT_TOOL_DEFINITIONS[TOOL_CREATE_TYPE_ALTERNATIVE_LAYOUT], async ({ workspaceId, typeInternalName, internalName, localizedNames, iconName }) => {
+        debugLogWithTag('TYPE_LAYOUT', `Creating alternative layout '${internalName}' for type ${typeInternalName} in workspace ${workspaceId}`);
+        try {
+            const requestBody = {
+                workspaceId,
+                typeInternalName,
+                internalName
+            };
+            if (localizedNames) {
+                requestBody.localizedNames = localizedNames;
+            }
+            if (iconName) {
+                requestBody.iconName = iconName;
+            }
+            const result = await client.makeApiRequest('json/typeLayout/create', 'POST', undefined, requestBody);
+            debugLogWithTag('TYPE_LAYOUT', `Successfully created alternative layout '${internalName}' for type ${typeInternalName}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('TYPE_LAYOUT', `Error creating alternative layout: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error creating alternative layout: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# 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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"}