@cplace/test-mcp-server 0.1.14 → 1.0.0

package/dist/tools/workflow.js

@@ -0,0 +1,259 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+const TOOL_MANAGE_WORKFLOW_STATE = 'cplace_manage_workflow_state';
+const TOOL_DELETE_WORKFLOW_STATE = 'cplace_delete_workflow_state';
+const TOOL_MANAGE_WORKFLOW_TRANSITION = 'cplace_manage_workflow_transition';
+const TOOL_DELETE_WORKFLOW_TRANSITION = 'cplace_delete_workflow_transition';
+export const WORKFLOW_TOOL_DEFINITIONS = {
+    [TOOL_MANAGE_WORKFLOW_STATE]: {
+        description: "Create or update workflow states with specified display properties. State internal names must be unique within the workflow and are immutable after creation.",
+        inputSchema: {
+            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new workflow state, 'update' for existing workflow state"),
+            workspaceId: z.string().describe("UID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeDefinitionInternalName: z.string().describe("Internal name of the type definition (e.g., 'cf.example.Task')"),
+            attributeName: z.string().describe("Name of the workflow attribute (e.g., 'status')"),
+            internalName: z.string().optional().describe("Required for create: Unique internal name for the new state - immutable after creation (e.g., 'in-review')"),
+            stateInternalName: z.string().optional().describe("Required for update: Internal name of the state to update - immutable identifier (e.g., 'in-review')"),
+            displayNames: z.record(z.string()).optional().describe("Localized display names as language code -> text map. For create: required. For update: optional (e.g., {\"en\": \"In Review\", \"de\": \"In Überprüfung\"})"),
+            icon: z.string().optional().describe("FontAwesome icon name without 'fa-' prefix (e.g., 'eye', 'check')"),
+            color: z.string().optional().describe("Hex color code (e.g., '#3498db')"),
+            isDefault: z.boolean().optional().describe("Whether this state should be the default for new pages (default: false)")
+        },
+        annotations: { title: "Manage Workflow State" }
+    },
+    [TOOL_DELETE_WORKFLOW_STATE]: {
+        description: "Remove a workflow state and all transitions involving it. Does NOT migrate existing pages - pages in the deleted state become uneditable (but remain readable). Returns warning with affected page count. Fixed states (isFixed=true) and default states (isDefault=true) cannot be deleted.",
+        inputSchema: {
+            workspaceId: z.string().describe("UID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeDefinitionInternalName: z.string().describe("Internal name of the type definition (e.g., 'cf.example.Task')"),
+            attributeName: z.string().describe("Name of the workflow attribute (e.g., 'status')"),
+            stateInternalName: z.string().describe("Internal name of the state to delete (e.g., 'in-review')")
+        },
+        annotations: { title: "Delete Workflow State" }
+    },
+    [TOOL_MANAGE_WORKFLOW_TRANSITION]: {
+        description: "Create or update workflow transitions between states with specified display properties. Both state names must exist in the workflow. Transitions are uniquely identified by the composite key (previousStateName, nextStateName).",
+        inputSchema: {
+            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new workflow transition, 'update' for existing workflow transition"),
+            workspaceId: z.string().describe("UID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeDefinitionInternalName: z.string().describe("Internal name of the type definition (e.g., 'cf.example.Task')"),
+            attributeName: z.string().describe("Name of the workflow attribute (e.g., 'status')"),
+            previousStateName: z.string().describe("Source state internal name - must exist (e.g., 'open')"),
+            nextStateName: z.string().describe("Target state internal name - must exist (e.g., 'in-review')"),
+            displayNames: z.record(z.string()).optional().describe("Localized display names for the transition button. For create: required. For update: optional (e.g., {\"en\": \"Submit for Review\", \"de\": \"Zur Überprüfung einreichen\"})"),
+            icon: z.string().optional().describe("FontAwesome icon name without 'fa-' prefix (e.g., 'arrow-right')"),
+            color: z.string().optional().describe("Hex color code for the transition button (e.g., '#3498db')"),
+            successMessage: z.string().optional().describe("Message shown after successful transition (optional)"),
+            confirm: z.boolean().optional().describe("Whether to show confirmation dialog (default: false)"),
+            executeValidators: z.boolean().optional().describe("Whether to run validators before transition (default: true)")
+        },
+        annotations: { title: "Manage Workflow Transition" }
+    },
+    [TOOL_DELETE_WORKFLOW_TRANSITION]: {
+        description: "Remove a workflow transition. Fixed transitions (isFixed=true) cannot be deleted. Deleting a transition only removes the ability to transition between the states - it does not affect existing pages or the states themselves.",
+        inputSchema: {
+            workspaceId: z.string().describe("UID of the workspace containing the type (e.g., 'workspace/abc123')"),
+            typeDefinitionInternalName: z.string().describe("Internal name of the type definition (e.g., 'cf.example.Task')"),
+            attributeName: z.string().describe("Name of the workflow attribute (e.g., 'status')"),
+            previousStateName: z.string().describe("Source state internal name (e.g., 'open')"),
+            nextStateName: z.string().describe("Target state internal name (e.g., 'in-review')")
+        },
+        annotations: { title: "Delete Workflow Transition" }
+    }
+};
+export function registerWorkflowTools(server, client) {
+    server.registerTool(TOOL_MANAGE_WORKFLOW_STATE, WORKFLOW_TOOL_DEFINITIONS[TOOL_MANAGE_WORKFLOW_STATE], async (params) => {
+        if (params.operation === "create") {
+            if (!params.internalName || !params.displayNames) {
+                return {
+                    content: [{ type: "text", text: "Error: Create operation requires internalName and displayNames parameters" }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('WORKFLOW_STATE', `Creating state '${params.internalName}' for ${params.typeDefinitionInternalName}.${params.attributeName}`);
+            try {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeDefinitionInternalName: params.typeDefinitionInternalName,
+                    attributeName: params.attributeName,
+                    internalName: params.internalName,
+                    displayNames: params.displayNames
+                };
+                if (params.icon !== undefined)
+                    requestBody.icon = params.icon;
+                if (params.color !== undefined)
+                    requestBody.color = params.color;
+                if (params.isDefault !== undefined)
+                    requestBody.isDefault = params.isDefault;
+                const result = await client.makeApiRequest('json/workflow-state', 'POST', undefined, requestBody);
+                debugLogWithTag('WORKFLOW_STATE', `Successfully created state '${params.internalName}'`);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error creating workflow state: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true
+                };
+            }
+        }
+        else {
+            if (!params.stateInternalName) {
+                return {
+                    content: [{ type: "text", text: "Error: Update operation requires stateInternalName parameter" }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('WORKFLOW_STATE', `Updating state '${params.stateInternalName}' for ${params.typeDefinitionInternalName}.${params.attributeName}`);
+            try {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeDefinitionInternalName: params.typeDefinitionInternalName,
+                    attributeName: params.attributeName,
+                    stateInternalName: params.stateInternalName
+                };
+                if (params.displayNames !== undefined)
+                    requestBody.displayNames = params.displayNames;
+                if (params.icon !== undefined)
+                    requestBody.icon = params.icon;
+                if (params.color !== undefined)
+                    requestBody.color = params.color;
+                if (params.isDefault !== undefined)
+                    requestBody.isDefault = params.isDefault;
+                const result = await client.makeApiRequest('json/workflow-state', 'PATCH', undefined, requestBody);
+                debugLogWithTag('WORKFLOW_STATE', `Successfully updated state '${params.stateInternalName}'`);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error updating workflow state: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true
+                };
+            }
+        }
+    });
+    server.registerTool(TOOL_DELETE_WORKFLOW_STATE, WORKFLOW_TOOL_DEFINITIONS[TOOL_DELETE_WORKFLOW_STATE], async ({ workspaceId, typeDefinitionInternalName, attributeName, stateInternalName }) => {
+        debugLogWithTag('WORKFLOW_STATE', `Deleting state '${stateInternalName}' for ${typeDefinitionInternalName}.${attributeName}`);
+        try {
+            const result = await client.makeApiRequest('json/workflow-state', 'DELETE', {
+                workspaceId,
+                typeDefinitionInternalName,
+                attributeName,
+                stateInternalName
+            });
+            debugLogWithTag('WORKFLOW_STATE', `Successfully deleted state '${stateInternalName}'`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error deleting workflow state: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_MANAGE_WORKFLOW_TRANSITION, WORKFLOW_TOOL_DEFINITIONS[TOOL_MANAGE_WORKFLOW_TRANSITION], async (params) => {
+        if (params.operation === "create") {
+            if (!params.displayNames) {
+                return {
+                    content: [{ type: "text", text: "Error: Create operation requires displayNames parameter" }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('WORKFLOW_TRANSITION', `Creating transition '${params.previousStateName}' -> '${params.nextStateName}' for ${params.typeDefinitionInternalName}.${params.attributeName}`);
+            try {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeDefinitionInternalName: params.typeDefinitionInternalName,
+                    attributeName: params.attributeName,
+                    previousStateName: params.previousStateName,
+                    nextStateName: params.nextStateName,
+                    displayNames: params.displayNames
+                };
+                if (params.icon !== undefined)
+                    requestBody.icon = params.icon;
+                if (params.color !== undefined)
+                    requestBody.color = params.color;
+                if (params.successMessage !== undefined)
+                    requestBody.successMessage = params.successMessage;
+                if (params.confirm !== undefined)
+                    requestBody.confirm = params.confirm;
+                if (params.executeValidators !== undefined)
+                    requestBody.executeValidators = params.executeValidators;
+                const result = await client.makeApiRequest('json/workflow-transition', 'POST', undefined, requestBody);
+                debugLogWithTag('WORKFLOW_TRANSITION', `Successfully created transition '${params.previousStateName}' -> '${params.nextStateName}'`);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error creating workflow transition: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true
+                };
+            }
+        }
+        else {
+            debugLogWithTag('WORKFLOW_TRANSITION', `Updating transition '${params.previousStateName}' -> '${params.nextStateName}' for ${params.typeDefinitionInternalName}.${params.attributeName}`);
+            try {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    typeDefinitionInternalName: params.typeDefinitionInternalName,
+                    attributeName: params.attributeName,
+                    previousStateName: params.previousStateName,
+                    nextStateName: params.nextStateName
+                };
+                if (params.displayNames !== undefined)
+                    requestBody.displayNames = params.displayNames;
+                if (params.icon !== undefined)
+                    requestBody.icon = params.icon;
+                if (params.color !== undefined)
+                    requestBody.color = params.color;
+                if (params.successMessage !== undefined)
+                    requestBody.successMessage = params.successMessage;
+                if (params.confirm !== undefined)
+                    requestBody.confirm = params.confirm;
+                if (params.executeValidators !== undefined)
+                    requestBody.executeValidators = params.executeValidators;
+                const result = await client.makeApiRequest('json/workflow-transition', 'PATCH', undefined, requestBody);
+                debugLogWithTag('WORKFLOW_TRANSITION', `Successfully updated transition '${params.previousStateName}' -> '${params.nextStateName}'`);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: "text", text: `Error updating workflow transition: ${error instanceof Error ? error.message : String(error)}` }],
+                    isError: true
+                };
+            }
+        }
+    });
+    server.registerTool(TOOL_DELETE_WORKFLOW_TRANSITION, WORKFLOW_TOOL_DEFINITIONS[TOOL_DELETE_WORKFLOW_TRANSITION], async ({ workspaceId, typeDefinitionInternalName, attributeName, previousStateName, nextStateName }) => {
+        debugLogWithTag('WORKFLOW_TRANSITION', `Deleting transition '${previousStateName}' -> '${nextStateName}' for ${typeDefinitionInternalName}.${attributeName}`);
+        try {
+            const result = await client.makeApiRequest('json/workflow-transition', 'DELETE', {
+                workspaceId,
+                typeDefinitionInternalName,
+                attributeName,
+                previousStateName,
+                nextStateName
+            });
+            debugLogWithTag('WORKFLOW_TRANSITION', `Successfully deleted transition '${previousStateName}' -> '${nextStateName}'`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error deleting workflow transition: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=workflow.js.map

package/dist/tools/workflow.js.map

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

package/dist/tools/workspace-admin.d.ts

@@ -0,0 +1,40 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const WORKSPACE_ADMIN_TOOL_DEFINITIONS: {
+    readonly cplace_create_workspace: {
+        readonly description: "Create a new workspace (PageSpace) with specified configuration including name, permissions, and apps. Requires global CREATE_PAGE_SPACE permission.";
+        readonly inputSchema: {
+            readonly name: z.ZodString;
+            readonly administratorUids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly readerUids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly writerUids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly layouterUids: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            readonly apps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        };
+        readonly annotations: {
+            readonly title: "Create Workspace";
+        };
+    };
+    readonly cplace_list_workspace_apps: {
+        readonly description: "Get comprehensive information about applications within a workspace, including installed apps, available apps for installation, dependency information, and compatibility status";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "List Workspace Apps";
+        };
+    };
+    readonly cplace_install_workspace_app: {
+        readonly description: "Install a specific application into a workspace, including automatic dependency resolution. Validates permissions, app compatibility, and automatically installs required dependencies.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly appQualifiedName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Install Workspace App";
+        };
+    };
+};
+export declare function registerWorkspaceAdminTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=workspace-admin.d.ts.map

package/dist/tools/workspace-admin.d.ts.map

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

package/dist/tools/workspace-admin.js

@@ -0,0 +1,125 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from '../utils.js';
+const TOOL_CREATE_WORKSPACE = 'cplace_create_workspace';
+const TOOL_LIST_WORKSPACE_APPS = 'cplace_list_workspace_apps';
+const TOOL_INSTALL_WORKSPACE_APP = 'cplace_install_workspace_app';
+export const WORKSPACE_ADMIN_TOOL_DEFINITIONS = {
+    [TOOL_CREATE_WORKSPACE]: {
+        description: "Create a new workspace (PageSpace) with specified configuration including name, permissions, and apps. Requires global CREATE_PAGE_SPACE permission.",
+        inputSchema: {
+            name: z.string().describe("Required: Internal workspace name (must be unique across the system)"),
+            administratorUids: z.array(z.string()).optional().describe("Optional: List of administrator principal UIDs (e.g., ['person/user123', 'person/admin456']). Defaults to current user if not provided."),
+            readerUids: z.array(z.string()).optional().describe("Optional: List of reader principal UIDs (e.g., ['person/reader789'])"),
+            writerUids: z.array(z.string()).optional().describe("Optional: List of writer principal UIDs (e.g., ['person/writer456'])"),
+            layouterUids: z.array(z.string()).optional().describe("Optional: List of layouter principal UIDs (e.g., ['person/layouter123'])"),
+            apps: z.array(z.string()).optional().describe("Optional: List of app qualified names to install (e.g., ['cf.cplace.solution.safe', 'cf.cplace.solution.ppm']). Apps are installed best-effort - incompatible apps are skipped with warnings.")
+        },
+        annotations: { title: "Create Workspace" }
+    },
+    [TOOL_LIST_WORKSPACE_APPS]: {
+        description: "Get comprehensive information about applications within a workspace, including installed apps, available apps for installation, dependency information, and compatibility status",
+        inputSchema: {
+            workspaceId: z.string().describe("The ID of the workspace to query for apps (e.g., 'abc123')")
+        },
+        annotations: { title: "List Workspace Apps" }
+    },
+    [TOOL_INSTALL_WORKSPACE_APP]: {
+        description: "Install a specific application into a workspace, including automatic dependency resolution. Validates permissions, app compatibility, and automatically installs required dependencies.",
+        inputSchema: {
+            workspaceId: z.string().describe("The ID of the workspace to install the app in (e.g., 'abc123')"),
+            appQualifiedName: z.string().describe("The qualified name of the app to install (e.g., 'cf.cplace.solution.safe')")
+        },
+        annotations: { title: "Install Workspace App" }
+    }
+};
+export function registerWorkspaceAdminTools(server, client) {
+    server.registerTool(TOOL_CREATE_WORKSPACE, WORKSPACE_ADMIN_TOOL_DEFINITIONS[TOOL_CREATE_WORKSPACE], async ({ name, administratorUids, readerUids, writerUids, layouterUids, apps }) => {
+        debugLogWithTag('WORKSPACES', `Creating workspace: ${name}`);
+        try {
+            const requestBody = { name };
+            if (administratorUids)
+                requestBody.administratorUids = administratorUids;
+            if (readerUids)
+                requestBody.readerUids = readerUids;
+            if (writerUids)
+                requestBody.writerUids = writerUids;
+            if (layouterUids)
+                requestBody.layouterUids = layouterUids;
+            if (apps)
+                requestBody.apps = apps;
+            const result = await client.makeApiRequest('json/workspace/create', 'POST', undefined, requestBody);
+            debugLogWithTag('WORKSPACES', `Successfully created workspace: ${name} with ID: ${result.result?.workspaceId}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('WORKSPACES', `Error creating workspace ${name}: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error creating workspace: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_LIST_WORKSPACE_APPS, WORKSPACE_ADMIN_TOOL_DEFINITIONS[TOOL_LIST_WORKSPACE_APPS], async ({ workspaceId }) => {
+        debugLogWithTag('WORKSPACES', `Getting apps for workspace: ${workspaceId}`);
+        try {
+            const result = await client.makeApiRequest('json/apps', 'GET', { workspaceId });
+            debugLogWithTag('WORKSPACES', `Retrieved apps data for workspace ${workspaceId}`);
+            debugLogWithTag('WORKSPACES', `Installed apps: ${result.result?.installed?.length || 0}, Available apps: ${result.result?.available?.length || 0}`);
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{ type: "text", text: `Response too large (${sizeCheck.actualSize} characters, max allowed: 45000). The apps data for this workspace is too large to display. Consider using the workspace details tool for basic app information.` }],
+                    isError: true
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('WORKSPACES', `Error getting apps for workspace ${workspaceId}: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error retrieving workspace apps: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_INSTALL_WORKSPACE_APP, WORKSPACE_ADMIN_TOOL_DEFINITIONS[TOOL_INSTALL_WORKSPACE_APP], async ({ workspaceId, appQualifiedName }) => {
+        debugLogWithTag('WORKSPACES', `Installing app: ${appQualifiedName} in workspace: ${workspaceId}`);
+        try {
+            const requestBody = {
+                workspaceId,
+                appQualifiedName
+            };
+            const result = await client.makeApiRequest('json/install-app', 'POST', undefined, requestBody);
+            debugLogWithTag('WORKSPACES', `Successfully installed app: ${appQualifiedName}`);
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: `App installed successfully but response too large (${sizeCheck.actualSize} characters, max allowed: 45000). Use cplace_list_workspace_apps to see updated app information.`
+                        }],
+                    isError: true
+                };
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('WORKSPACES', `Error installing app ${appQualifiedName} in workspace ${workspaceId}: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{
+                        type: "text",
+                        text: `Error installing app: ${error instanceof Error ? error.message : String(error)}`
+                    }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=workspace-admin.js.map

package/dist/tools/workspace-admin.js.map

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

package/dist/tools/workspace-core.d.ts

@@ -0,0 +1,45 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const WORKSPACE_CORE_TOOL_DEFINITIONS: {
+    readonly cplace_list_workspaces: {
+        readonly description: "Get a list of all workspaces with essential properties (id, name, displayName, totalPages, isFavorite, installed apps)";
+        readonly inputSchema: {
+            readonly limit: z.ZodOptional<z.ZodNumber>;
+            readonly offset: z.ZodDefault<z.ZodNumber>;
+        };
+        readonly annotations: {
+            readonly title: "List Workspaces";
+        };
+    };
+    readonly cplace_list_types: {
+        readonly description: "List all types available in a workspace";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "List Types";
+        };
+    };
+    readonly cplace_get_workspace_details: {
+        readonly description: "Get comprehensive details about a specific workspace including all metadata, permissions, type definitions (count only), styling, and configuration. Provides access to rootPageId and other fields not available in the list view. For the full list of types, use cplace_list_types.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Workspace Details";
+        };
+    };
+    readonly cplace_get_type_datamodel: {
+        readonly description: "Get the datamodel of a type including its attributes, constraints, and permissions. Use this before performing a search to understand the type structure.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly internalName: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Type Details";
+        };
+    };
+};
+export declare function registerWorkspaceCoreTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=workspace-core.d.ts.map

package/dist/tools/workspace-core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-core.d.ts","sourceRoot":"","sources":["../../src/tools/workspace-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAqB,MAAM,WAAW,CAAC;AAW/D,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BlC,CAAC;AAEX,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAwJpF"}