@cplace/test-mcp-server 0.1.15 → 1.1.0

package/dist/tools/jobs.js

@@ -0,0 +1,193 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+const TOOL_GET_JOB = 'cplace_get_job';
+const TOOL_LIST_JOBS = 'cplace_list_jobs';
+function formatDuration(durationMs) {
+    if (durationMs === null || durationMs === undefined) {
+        return null;
+    }
+    const seconds = Math.floor(durationMs / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const remainingMinutes = minutes % 60;
+    const remainingSeconds = seconds % 60;
+    if (hours > 0) {
+        return `${hours}h ${remainingMinutes}m ${remainingSeconds}s`;
+    }
+    else if (minutes > 0) {
+        return `${remainingMinutes}m ${remainingSeconds}s`;
+    }
+    else {
+        return `${remainingSeconds}s`;
+    }
+}
+function transformJobResponse(job) {
+    if (!job)
+        return job;
+    return {
+        id: job.id,
+        uid: job.uid,
+        name: job.name,
+        className: job.className,
+        parameter: job.parameter,
+        state: job.state,
+        timestamps: {
+            createdAt: job.timestamps?.createdAt,
+            scheduledAt: job.timestamps?.scheduledAt,
+            startedAt: job.timestamps?.startedAt,
+            finishedAt: job.timestamps?.finishedAt,
+            durationMs: job.timestamps?.durationMs,
+            duration: formatDuration(job.timestamps?.durationMs)
+        },
+        creator: job.creator,
+        ...(job.output && {
+            output: {
+                log: job.output.log,
+                downloadFileName: job.output.downloadFileName
+            }
+        })
+    };
+}
+function transformJobListItem(job) {
+    if (!job)
+        return job;
+    return {
+        id: job.id,
+        uid: job.uid,
+        name: job.name,
+        className: job.className,
+        state: job.state,
+        timestamps: {
+            createdAt: job.timestamps?.createdAt,
+            startedAt: job.timestamps?.startedAt,
+            finishedAt: job.timestamps?.finishedAt,
+            durationMs: job.timestamps?.durationMs,
+            duration: formatDuration(job.timestamps?.durationMs)
+        },
+        creator: job.creator
+    };
+}
+export const JOBS_TOOL_DEFINITIONS = {
+    [TOOL_GET_JOB]: {
+        description: `Get detailed information about a PersistentJob by its ID.
+
+Returns job state, timestamps with computed duration, creator information, and optionally the job output (log and download file).
+
+Use cases:
+- Monitor a specific job's completion status
+- Debug failed job execution by examining the log
+- Analyze job performance via duration
+
+Note: If response is too large due to job log size, retry with includeOutput=false.`,
+        inputSchema: {
+            jobId: z.string().describe("The job ID to retrieve (e.g., '12345' or 'persistentJob/12345')"),
+            includeOutput: z.boolean().optional().default(true).describe("Whether to include job output (log and downloadFileName). Set to false for faster, smaller responses when output is not needed. Default: true")
+        },
+        annotations: { title: "Get Job by ID" }
+    },
+    [TOOL_LIST_JOBS]: {
+        description: `List PersistentJobs with optional filtering and pagination.
+
+Results are sorted by creation date (newest first). Job output (log) is NOT included - use cplace_get_job for full details including output.
+
+Filtering options:
+- state: Filter by job state (created, running, success, error, cancelled, skipped)
+- createdBy: Filter by creator user ID
+- createdAfter/createdBefore: Filter by creation time range
+- className: Filter by job class name (partial match)
+
+Use cases:
+- Find failed jobs for investigation
+- List jobs by a specific user
+- Monitor recent job activity`,
+        inputSchema: {
+            state: z.enum(['created', 'running', 'success', 'error', 'cancelled', 'skipped']).optional().describe("Filter by job state"),
+            createdBy: z.string().optional().describe("Filter by creator user ID (e.g., 'user/abc123')"),
+            createdAfter: z.string().optional().describe("Filter jobs created after this timestamp. Use ISO 8601 format (e.g., '2025-01-15T10:30:00Z')"),
+            createdBefore: z.string().optional().describe("Filter jobs created before this timestamp. Use ISO 8601 format (e.g., '2025-01-31T23:59:59Z')"),
+            className: z.string().optional().describe("Filter by job class name (partial match, case-sensitive). Example: 'DataExport' matches 'cf.cplace.myPlugin.jobs.DataExportJob'"),
+            limit: z.number().min(1).max(100).optional().default(50).describe("Maximum number of results (1-100). Default: 50"),
+            offset: z.number().min(0).optional().default(0).describe("Number of results to skip for pagination. Default: 0")
+        },
+        annotations: { title: "List Jobs" }
+    }
+};
+export function registerJobsTools(server, client) {
+    server.registerTool(TOOL_GET_JOB, JOBS_TOOL_DEFINITIONS[TOOL_GET_JOB], async ({ jobId, includeOutput = true }) => {
+        debugLogWithTag('JOBS', `Getting job ${jobId} (includeOutput: ${includeOutput})`);
+        try {
+            const result = await client.makeApiRequest('json/job', 'GET', {
+                jobId,
+                includeOutput
+            });
+            const transformedResult = transformJobResponse(result);
+            const sizeCheck = checkResponseSize(transformedResult);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('JOBS', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Response too large (${sizeCheck.actualSize} characters). The job log is likely very large. Retry with includeOutput=false to get job details without the log.`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('JOBS', `Successfully retrieved job ${jobId}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(transformedResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('JOBS', `Error retrieving job: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error retrieving job: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_LIST_JOBS, JOBS_TOOL_DEFINITIONS[TOOL_LIST_JOBS], async ({ state, createdBy, createdAfter, createdBefore, className, limit = 50, offset = 0 }) => {
+        debugLogWithTag('JOBS', `Listing jobs with filters: ${JSON.stringify({ state, createdBy, createdAfter, createdBefore, className, limit, offset })}`);
+        try {
+            const queryParams = { limit, offset };
+            if (state !== undefined)
+                queryParams.state = state;
+            if (createdBy !== undefined)
+                queryParams.createdBy = createdBy;
+            if (createdAfter !== undefined)
+                queryParams.createdAfter = createdAfter;
+            if (createdBefore !== undefined)
+                queryParams.createdBefore = createdBefore;
+            if (className !== undefined)
+                queryParams.className = className;
+            const result = await client.makeApiRequest('json/jobs', 'GET', queryParams);
+            const transformedResult = {
+                ...result,
+                jobs: result.jobs?.map(transformJobListItem) || []
+            };
+            const sizeCheck = checkResponseSize(transformedResult);
+            if (sizeCheck.tooLarge) {
+                debugLogWithTag('JOBS', `Response too large: ${sizeCheck.actualSize} characters`);
+                return {
+                    content: [{
+                            type: "text",
+                            text: `Response too large (${sizeCheck.actualSize} characters). Try: reduce limit (e.g., limit: 10), add filters (state, createdAfter, className), or use pagination with smaller pages.`
+                        }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('JOBS', `Successfully retrieved ${transformedResult.jobs?.length || 0} jobs`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(transformedResult, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('JOBS', `Error listing jobs: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error listing jobs: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=jobs.js.map

package/dist/tools/jobs.js.map

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

package/dist/tools/pages.d.ts

@@ -1,4 +1,59 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
 import { CplaceApiClient } from '../api.js';
+export declare const PAGE_TOOL_DEFINITIONS: {
+    readonly cplace_delete_page: {
+        readonly description: "⚠️ DESTRUCTIVE OPERATION: Permanently delete a single page. Only works for leaf pages (pages without children). For pages with children, use cplace_delete_page_with_children.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Delete Page";
+        };
+    };
+    readonly cplace_delete_page_with_children: {
+        readonly description: "⚠️ DESTRUCTIVE OPERATION: Permanently delete a page and optionally all its children. Uses a two-phase workflow: first call shows preview, second call with confirmation performs deletion.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+            readonly confirmDeleteChildren: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        readonly annotations: {
+            readonly title: "Delete Page with Children";
+        };
+    };
+    readonly cplace_copy_page: {
+        readonly description: "Copy a page with optional hierarchical copy. Set includeChildren=false for single page copy (leaf pages only), or includeChildren=true for copying page with all children. When includeChildren=true, uses a two-phase workflow: first call shows preview, second call with confirmCopyChildren=true performs the copy.";
+        readonly inputSchema: {
+            readonly sourcePageUID: z.ZodString;
+            readonly includeChildren: z.ZodBoolean;
+            readonly confirmCopyChildren: z.ZodOptional<z.ZodBoolean>;
+            readonly targetWorkspaceId: z.ZodOptional<z.ZodString>;
+            readonly targetParentUID: z.ZodOptional<z.ZodString>;
+            readonly newName: z.ZodOptional<z.ZodString>;
+            readonly includeComments: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+            readonly includeFiles: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        readonly annotations: {
+            readonly title: "Copy Page";
+        };
+    };
+    readonly cplace_manage_page: {
+        readonly description: "Create or update a page. Use operation='create' to create new pages with workspace and type. Use operation='update' to modify existing pages by UID. 🔍 IMPORTANT: Use 'cplace_get_type_datamodel' before creating pages to understand attribute requirements.";
+        readonly inputSchema: {
+            readonly operation: z.ZodEnum<["create", "update"]>;
+            readonly workspaceId: z.ZodOptional<z.ZodString>;
+            readonly typeInternalName: z.ZodOptional<z.ZodString>;
+            readonly pageUID: z.ZodOptional<z.ZodString>;
+            readonly name: z.ZodOptional<z.ZodString>;
+            readonly parentUID: z.ZodOptional<z.ZodString>;
+            readonly content: z.ZodOptional<z.ZodString>;
+            readonly attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            readonly builtinAttributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        };
+        readonly annotations: {
+            readonly title: "Manage Page";
+        };
+    };
+};
 export declare function registerPageTools(server: McpServer, client: CplaceApiClient): void;
 //# sourceMappingURL=pages.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/tools/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAI5C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA+d3E"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../src/tools/pages.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;AAY5C,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2ExB,CAAC;AAEX,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAsS3E"}