@cplace/mcp-server 1.5.3 → 1.6.1

package/dist/tools/expert-settings.js

@@ -0,0 +1,145 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { checkResponseSize } from "../utils.js";
+import { applyStrReplace } from '../str-replace-utils.js';
+const TOOL_GET_EXPERT_SETTINGS = 'cplace_get_expert_settings';
+const TOOL_UPDATE_EXPERT_SETTINGS = 'cplace_update_expert_settings';
+const TOOL_EDIT_EXPERT_SETTINGS = 'cplace_edit_expert_settings';
+export const EXPERT_SETTINGS_TOOL_DEFINITIONS = {
+    [TOOL_GET_EXPERT_SETTINGS]: {
+        description: "Retrieves all tenant-wide expert settings for theming: LESS variables, SCSS variables, custom CSS, and custom JavaScript. Also returns whether JavaScript editing is enabled on the server. Requires administrator privileges.",
+        inputSchema: {},
+        annotations: { title: "Get Expert Settings" }
+    },
+    [TOOL_UPDATE_EXPERT_SETTINGS]: {
+        description: "Updates one or more tenant-wide expert settings (LESS, SCSS, CSS, JavaScript). Only provided fields are updated; omitted fields remain unchanged. Send an empty string to clear a setting. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.",
+        inputSchema: {
+            less: z.string().optional().describe("Custom LESS variables content. Updating triggers async CSS compilation."),
+            scss: z.string().optional().describe("Custom SCSS variables content. Updating triggers async CSS compilation."),
+            css: z.string().optional().describe("Custom CSS content. Takes effect immediately (no compilation)."),
+            javascript: z.string().optional().describe("Custom JavaScript content. Requires server-side JavaScript editing to be enabled. Updates will be rejected if disabled.")
+        },
+        annotations: { title: "Update Expert Settings" }
+    },
+    [TOOL_EDIT_EXPERT_SETTINGS]: {
+        description: "Surgically edit a single expert settings field using str_replace. Finds and replaces exact text within the specified field (LESS, SCSS, CSS, or JavaScript). More token-efficient than full replacement for small changes in large stylesheets or scripts. Updating LESS or SCSS triggers an asynchronous CSS compilation job — use cplace_get_job to poll compilation status. Requires administrator privileges.",
+        inputSchema: {
+            field: z.enum(["less", "scss", "css", "javascript"]).describe("The expert settings field to edit. 'javascript' requires server-side JavaScript editing to be enabled."),
+            old_str: z.string().describe("The exact string to find in the field content. Must match exactly including whitespace and line breaks."),
+            new_str: z.string().describe("The replacement string."),
+            replace_all: z.boolean().optional().describe("If true, replace all occurrences. If false (default), requires exactly one match.")
+        },
+        annotations: { title: "Edit Expert Settings" }
+    }
+};
+export function registerExpertSettingsTools(server, client) {
+    server.registerTool(TOOL_GET_EXPERT_SETTINGS, EXPERT_SETTINGS_TOOL_DEFINITIONS[TOOL_GET_EXPERT_SETTINGS], async () => {
+        debugLogWithTag('EXPERT_SETTINGS', 'Retrieving expert settings');
+        try {
+            const result = await client.makeApiRequest('json/expert-settings', 'GET');
+            const sizeCheck = checkResponseSize(result);
+            if (sizeCheck.tooLarge) {
+                return {
+                    content: [{ type: "text", text: `Error: ${sizeCheck.suggestion}` }],
+                    isError: true
+                };
+            }
+            debugLogWithTag('EXPERT_SETTINGS', 'Successfully retrieved expert settings');
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving expert settings: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_UPDATE_EXPERT_SETTINGS, EXPERT_SETTINGS_TOOL_DEFINITIONS[TOOL_UPDATE_EXPERT_SETTINGS], async ({ less, scss, css, javascript }) => {
+        debugLogWithTag('EXPERT_SETTINGS', 'Updating expert settings');
+        const body = {};
+        if (less !== undefined)
+            body.less = less;
+        if (scss !== undefined)
+            body.scss = scss;
+        if (css !== undefined)
+            body.css = css;
+        if (javascript !== undefined)
+            body.javascript = javascript;
+        if (Object.keys(body).length === 0) {
+            return {
+                content: [{ type: "text", text: "Error: No fields provided. Supply at least one of: less, scss, css, javascript. Use an empty string to clear a setting." }],
+                isError: true
+            };
+        }
+        try {
+            const result = await client.makeApiRequest('json/expert-settings', 'PATCH', undefined, body);
+            const updatedFields = result.updated || Object.keys(body);
+            let response = `Successfully updated expert settings: ${updatedFields.join(', ')}`;
+            if (result.lessCompilationJobId) {
+                response += `\nLESS compilation job started: ${result.lessCompilationJobId} (use cplace_get_job to check status)`;
+            }
+            if (result.scssCompilationJobId) {
+                response += `\nSCSS compilation job started: ${result.scssCompilationJobId} (use cplace_get_job to check status)`;
+            }
+            debugLogWithTag('EXPERT_SETTINGS', `Successfully updated fields: ${updatedFields.join(', ')}`);
+            return {
+                content: [{ type: "text", text: response }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error updating expert settings: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_EDIT_EXPERT_SETTINGS, EXPERT_SETTINGS_TOOL_DEFINITIONS[TOOL_EDIT_EXPERT_SETTINGS], async ({ field, old_str, new_str, replace_all = false }) => {
+        debugLogWithTag('EXPERT_SETTINGS', `Editing expert settings field '${field}'`);
+        try {
+            const settings = await client.makeApiRequest('json/expert-settings', 'GET');
+            const currentContent = settings[field];
+            if (currentContent === undefined || currentContent === null) {
+                return {
+                    content: [{ type: "text", text: `Error: Field '${field}' is not available. ${field === 'javascript' ? 'JavaScript editing may be disabled on the server.' : 'The field has no content.'}` }],
+                    isError: true
+                };
+            }
+            if (currentContent === '') {
+                return {
+                    content: [{ type: "text", text: `Error: Field '${field}' is empty. Use cplace_update_expert_settings to set initial content.` }],
+                    isError: true
+                };
+            }
+            const result = applyStrReplace(currentContent, old_str, new_str, replace_all);
+            if (!result.success) {
+                return {
+                    content: [{ type: "text", text: `Error: ${result.error}` }],
+                    isError: true
+                };
+            }
+            const patchBody = { [field]: result.newContent };
+            const patchResult = await client.makeApiRequest('json/expert-settings', 'PATCH', undefined, patchBody);
+            let response = `Successfully edited '${field}'. Replaced ${result.replacementCount} occurrence(s).`;
+            if (patchResult.lessCompilationJobId) {
+                response += `\nLESS compilation job started: ${patchResult.lessCompilationJobId} (use cplace_get_job to check status)`;
+            }
+            if (patchResult.scssCompilationJobId) {
+                response += `\nSCSS compilation job started: ${patchResult.scssCompilationJobId} (use cplace_get_job to check status)`;
+            }
+            debugLogWithTag('EXPERT_SETTINGS', `Successfully edited '${field}' (${result.replacementCount} replacement(s))`);
+            return {
+                content: [{ type: "text", text: response }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('EXPERT_SETTINGS', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error editing expert settings: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=expert-settings.js.map

package/dist/tools/expert-settings.js.map

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

package/dist/tools/job-schedule-trigger.d.ts

@@ -0,0 +1,16 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const JOB_SCHEDULE_TRIGGER_TOOL_DEFINITIONS: {
+    readonly cplace_trigger_job_schedule: {
+        readonly description: "Trigger manual execution of a Low-Code Job schedule. Accepts the UID of a job schedule page, validates it, and starts the referenced job script asynchronously. Returns a job ID that can be monitored with cplace_get_job. Use this to run scheduled jobs on-demand without waiting for the next cron cycle.";
+        readonly inputSchema: {
+            readonly pageUID: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Trigger Job Schedule";
+        };
+    };
+};
+export declare function registerJobScheduleTriggerTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=job-schedule-trigger.d.ts.map

package/dist/tools/job-schedule-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-trigger.d.ts","sourceRoot":"","sources":["../../src/tools/job-schedule-trigger.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;AAK5C,eAAO,MAAM,qCAAqC;;;;;;;;;;CAQxC,CAAC;AAEX,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QA2BzF"}

package/dist/tools/job-schedule-trigger.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+const TOOL_TRIGGER_JOB_SCHEDULE = 'cplace_trigger_job_schedule';
+export const JOB_SCHEDULE_TRIGGER_TOOL_DEFINITIONS = {
+    [TOOL_TRIGGER_JOB_SCHEDULE]: {
+        description: "Trigger manual execution of a Low-Code Job schedule. Accepts the UID of a job schedule page, validates it, and starts the referenced job script asynchronously. Returns a job ID that can be monitored with cplace_get_job. Use this to run scheduled jobs on-demand without waiting for the next cron cycle.",
+        inputSchema: {
+            pageUID: z.string().describe("The UID of the job schedule page to trigger (e.g., 'page/abc123def456')")
+        },
+        annotations: { title: "Trigger Job Schedule" }
+    }
+};
+export function registerJobScheduleTriggerTools(server, client) {
+    server.registerTool(TOOL_TRIGGER_JOB_SCHEDULE, JOB_SCHEDULE_TRIGGER_TOOL_DEFINITIONS[TOOL_TRIGGER_JOB_SCHEDULE], async ({ pageUID }) => {
+        debugLogWithTag('JOB_SCHEDULE_TRIGGER', `Triggering job schedule: ${pageUID}`);
+        try {
+            const result = await client.makeApiRequest('json/job-schedule/trigger', 'POST', undefined, { pageUID });
+            debugLogWithTag('JOB_SCHEDULE_TRIGGER', `Successfully triggered job schedule: ${pageUID}`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('JOB_SCHEDULE_TRIGGER', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error triggering job schedule: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=job-schedule-trigger.js.map

package/dist/tools/job-schedule-trigger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-schedule-trigger.js","sourceRoot":"","sources":["../../src/tools/job-schedule-trigger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AAEhE,MAAM,CAAC,MAAM,qCAAqC,GAAG;IACnD,CAAC,yBAAyB,CAAC,EAAE;QAC3B,WAAW,EAAE,+SAA+S;QAC5T,WAAW,EAAE;YACX,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yEAAyE,CAAC;SACxG;QACD,WAAW,EAAE,EAAE,KAAK,EAAE,sBAAsB,EAAE;KAC/C;CACO,CAAC;AAEX,MAAM,UAAU,+BAA+B,CAAC,MAAiB,EAAE,MAAuB;IACxF,MAAM,CAAC,YAAY,CAAC,yBAAyB,EAC3C,qCAAqC,CAAC,yBAAyB,CAAC,EAChE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,eAAe,CAAC,sBAAsB,EAAE,4BAA4B,OAAO,EAAE,CAAC,CAAC;QAE/E,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CACxC,2BAA2B,EAC3B,MAAM,EACN,SAAS,EACT,EAAE,OAAO,EAAE,CACZ,CAAC;YAEF,eAAe,CAAC,sBAAsB,EAAE,wCAAwC,OAAO,EAAE,CAAC,CAAC;YAC3F,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,eAAe,CAAC,sBAAsB,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC5G,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kCAAkC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC7H,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/job-scripts.d.ts

@@ -0,0 +1,58 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { CplaceApiClient } from '../api.js';
+export declare const JOB_SCRIPTS_TOOL_DEFINITIONS: {
+    readonly cplace_get_job_scripts: {
+        readonly description: "Get all Low-Code Job scripts in a workspace. Job scripts define the logic for scheduled or manually triggered jobs. Returns script code, enabled status, job configuration (category, enqueue mode, reschedulable), and metadata for each script.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Get Job Scripts";
+        };
+    };
+    readonly cplace_manage_job_script: {
+        readonly description: "Create or update a Low-Code Job script entity. Job scripts define JavaScript logic for scheduled or manually triggered jobs. For create: workspaceId, identifier, and script are required. For update: workspaceId and identifier are required, all other fields are optional.";
+        readonly inputSchema: {
+            readonly operation: z.ZodEnum<["create", "update"]>;
+            readonly workspaceId: z.ZodString;
+            readonly identifier: z.ZodString;
+            readonly script: z.ZodOptional<z.ZodString>;
+            readonly localizedNames: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+            readonly description: z.ZodOptional<z.ZodString>;
+            readonly enabled: z.ZodOptional<z.ZodBoolean>;
+            readonly contextPageId: z.ZodOptional<z.ZodString>;
+            readonly jobCategory: z.ZodOptional<z.ZodString>;
+            readonly jobCategoryEnqueueMode: z.ZodOptional<z.ZodString>;
+            readonly isReschedulable: z.ZodOptional<z.ZodBoolean>;
+        };
+        readonly annotations: {
+            readonly title: "Manage Job Script";
+        };
+    };
+    readonly cplace_edit_job_script: {
+        readonly description: "Edit a job script using str_replace — find an exact text match and replace it. Reads the current script, applies the replacement, and writes back. Use this instead of cplace_manage_job_script when making small changes to avoid reproducing the entire script.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly identifier: z.ZodString;
+            readonly old_str: z.ZodString;
+            readonly new_str: z.ZodString;
+            readonly replace_all: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+        };
+        readonly annotations: {
+            readonly title: "Edit Job Script";
+        };
+    };
+    readonly cplace_delete_job_script: {
+        readonly description: "Delete a job script from a workspace. This permanently removes the script — any scheduled jobs referencing it will no longer execute.";
+        readonly inputSchema: {
+            readonly workspaceId: z.ZodString;
+            readonly identifier: z.ZodString;
+        };
+        readonly annotations: {
+            readonly title: "Delete Job Script";
+        };
+    };
+};
+export declare function registerJobScriptsTools(server: McpServer, client: CplaceApiClient): void;
+//# sourceMappingURL=job-scripts.d.ts.map

package/dist/tools/job-scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scripts.d.ts","sourceRoot":"","sources":["../../src/tools/job-scripts.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;AAW5C,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4C/B,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAoNjF"}

package/dist/tools/job-scripts.js

@@ -0,0 +1,215 @@
+import { z } from "zod";
+import { debugLogWithTag } from "../logger.js";
+import { applyStrReplace } from '../str-replace-utils.js';
+const TOOL_GET_JOB_SCRIPTS = 'cplace_get_job_scripts';
+const TOOL_MANAGE_JOB_SCRIPT = 'cplace_manage_job_script';
+const TOOL_EDIT_JOB_SCRIPT = 'cplace_edit_job_script';
+const TOOL_DELETE_JOB_SCRIPT = 'cplace_delete_job_script';
+export const JOB_SCRIPTS_TOOL_DEFINITIONS = {
+    [TOOL_GET_JOB_SCRIPTS]: {
+        description: "Get all Low-Code Job scripts in a workspace. Job scripts define the logic for scheduled or manually triggered jobs. Returns script code, enabled status, job configuration (category, enqueue mode, reschedulable), and metadata for each script.",
+        inputSchema: {
+            workspaceId: z.string().describe("The workspace ID (e.g., 'workspace/abc123')")
+        },
+        annotations: { title: "Get Job Scripts" }
+    },
+    [TOOL_MANAGE_JOB_SCRIPT]: {
+        description: "Create or update a Low-Code Job script entity. Job scripts define JavaScript logic for scheduled or manually triggered jobs. For create: workspaceId, identifier, and script are required. For update: workspaceId and identifier are required, all other fields are optional.",
+        inputSchema: {
+            operation: z.enum(["create", "update"]).describe("Operation type: 'create' for new job scripts, 'update' for existing job scripts"),
+            workspaceId: z.string().describe("Required: Target workspace ID (e.g., 'workspace/abc123')"),
+            identifier: z.string().describe("Required: Unique identifier for the job script within the workspace"),
+            script: z.string().optional().describe("⚠️ REQUIRED for create: JavaScript code for the job script. Review cplace Low-Code documentation before writing job scripts."),
+            localizedNames: z.record(z.string()).optional().describe("Optional: Localized display names (e.g., {\"en\": \"My Job\", \"de\": \"Mein Job\"})"),
+            description: z.string().optional().describe("Optional: Description of the job script (empty string clears it on update)"),
+            enabled: z.boolean().optional().describe("For update only: Enable/disable the job script"),
+            contextPageId: z.string().optional().describe("Optional: Context page ID for job execution"),
+            jobCategory: z.string().optional().describe("Optional: Job category name for grouping related jobs"),
+            jobCategoryEnqueueMode: z.string().optional().describe("Optional: How jobs in the same category are enqueued (e.g., 'PARALLEL')"),
+            isReschedulable: z.boolean().optional().describe("Optional: Whether the job can be rescheduled after execution")
+        },
+        annotations: { title: "Manage Job Script" }
+    },
+    [TOOL_EDIT_JOB_SCRIPT]: {
+        description: "Edit a job script using str_replace — find an exact text match and replace it. Reads the current script, applies the replacement, and writes back. Use this instead of cplace_manage_job_script when making small changes to avoid reproducing the entire script.",
+        inputSchema: {
+            workspaceId: z.string().describe("The workspace ID (e.g., 'workspace/abc123')"),
+            identifier: z.string().describe("The unique identifier of the job script to edit"),
+            old_str: z.string().describe("The exact text to find in the job script (must match exactly, including whitespace and line breaks)"),
+            new_str: z.string().describe("The replacement text. Use empty string to delete the matched text."),
+            replace_all: z.boolean().optional().default(false).describe("If true, replace all occurrences of old_str. If false (default), fails when old_str matches more than once.")
+        },
+        annotations: { title: "Edit Job Script" }
+    },
+    [TOOL_DELETE_JOB_SCRIPT]: {
+        description: "Delete a job script from a workspace. This permanently removes the script — any scheduled jobs referencing it will no longer execute.",
+        inputSchema: {
+            workspaceId: z.string().describe("The workspace ID (e.g., 'workspace/abc123')"),
+            identifier: z.string().describe("The unique identifier of the job script to delete")
+        },
+        annotations: { title: "Delete Job Script" }
+    }
+};
+export function registerJobScriptsTools(server, client) {
+    server.registerTool(TOOL_GET_JOB_SCRIPTS, JOB_SCRIPTS_TOOL_DEFINITIONS[TOOL_GET_JOB_SCRIPTS], async ({ workspaceId }) => {
+        try {
+            const result = await client.makeApiRequest('json/job-scripts', 'GET', { workspaceId });
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error retrieving job scripts: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_MANAGE_JOB_SCRIPT, JOB_SCRIPTS_TOOL_DEFINITIONS[TOOL_MANAGE_JOB_SCRIPT], async (params) => {
+        try {
+            if (params.operation === "create") {
+                if (!params.script) {
+                    return {
+                        content: [{ type: "text", text: "Error: Create operation requires the script parameter" }],
+                        isError: true
+                    };
+                }
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    identifier: params.identifier,
+                    script: params.script
+                };
+                if (params.localizedNames) {
+                    requestBody.localizedNames = params.localizedNames;
+                }
+                if (params.description) {
+                    requestBody.description = params.description;
+                }
+                if (params.contextPageId) {
+                    requestBody.contextPageId = params.contextPageId;
+                }
+                if (params.jobCategory) {
+                    requestBody.jobCategory = params.jobCategory;
+                }
+                if (params.jobCategoryEnqueueMode) {
+                    requestBody.jobCategoryEnqueueMode = params.jobCategoryEnqueueMode;
+                }
+                if (params.isReschedulable !== undefined) {
+                    requestBody.isReschedulable = params.isReschedulable;
+                }
+                const result = await client.makeApiRequest('json/job-script', 'POST', undefined, requestBody);
+                return {
+                    content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+                };
+            }
+            else {
+                const requestBody = {
+                    workspaceId: params.workspaceId,
+                    scriptIdentifier: params.identifier
+                };
+                if (params.script !== undefined) {
+                    requestBody.script = params.script;
+                }
+                if (params.enabled !== undefined) {
+                    requestBody.enabled = params.enabled;
+                }
+                if (params.localizedNames !== undefined) {
+                    requestBody.localizedNames = params.localizedNames;
+                }
+                if (params.description !== undefined) {
+                    requestBody.description = params.description;
+                }
+                if (params.contextPageId !== undefined) {
+                    requestBody.contextPageId = params.contextPageId;
+                }
+                if (params.jobCategory !== undefined) {
+                    requestBody.jobCategory = params.jobCategory;
+                }
+                if (params.jobCategoryEnqueueMode !== undefined) {
+                    requestBody.jobCategoryEnqueueMode = params.jobCategoryEnqueueMode;
+                }
+                if (params.isReschedulable !== undefined) {
+                    requestBody.isReschedulable = params.isReschedulable;
+                }
+                const result = await client.makeApiRequest('json/job-script', '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} job script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_EDIT_JOB_SCRIPT, JOB_SCRIPTS_TOOL_DEFINITIONS[TOOL_EDIT_JOB_SCRIPT], async ({ workspaceId, identifier, old_str, new_str, replace_all = false }) => {
+        debugLogWithTag('EDIT_JOB_SCRIPT', `Editing job script '${identifier}'`);
+        try {
+            const allScripts = await client.makeApiRequest('json/job-scripts', 'GET', {
+                workspaceId
+            });
+            const scripts = allScripts.data || [];
+            const script = scripts.find((s) => s.identifier === identifier);
+            if (!script) {
+                const availableIds = scripts.map((s) => s.identifier).join(', ');
+                return {
+                    content: [{ type: "text", text: `Error: Job script '${identifier}' not found in workspace. Available identifiers: ${availableIds || '(none)'}` }],
+                    isError: true
+                };
+            }
+            const currentScript = script.script;
+            if (currentScript === undefined || currentScript === null || currentScript === '') {
+                return {
+                    content: [{ type: "text", text: `Error: Job script '${identifier}' has no script content.` }],
+                    isError: true
+                };
+            }
+            const result = applyStrReplace(currentScript, old_str, new_str, replace_all);
+            if (!result.success) {
+                return {
+                    content: [{ type: "text", text: `Error: ${result.error}` }],
+                    isError: true
+                };
+            }
+            await client.makeApiRequest('json/job-script', 'PATCH', undefined, {
+                workspaceId,
+                scriptIdentifier: identifier,
+                script: result.newContent
+            });
+            debugLogWithTag('EDIT_JOB_SCRIPT', `Successfully edited job script '${identifier}' (${result.replacementCount} replacement(s))`);
+            return {
+                content: [{ type: "text", text: `Successfully edited job script '${identifier}'. Replaced ${result.replacementCount} occurrence(s).` }]
+            };
+        }
+        catch (error) {
+            debugLogWithTag('EDIT_JOB_SCRIPT', `Error: ${error instanceof Error ? error.message : String(error)}`);
+            return {
+                content: [{ type: "text", text: `Error editing job script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+    server.registerTool(TOOL_DELETE_JOB_SCRIPT, JOB_SCRIPTS_TOOL_DEFINITIONS[TOOL_DELETE_JOB_SCRIPT], async ({ workspaceId, identifier }) => {
+        debugLogWithTag('JOB_SCRIPT_DELETE', `Deleting job script '${identifier}'`);
+        try {
+            const result = await client.makeApiRequest('json/job-script', 'DELETE', {
+                workspaceId,
+                identifier
+            });
+            debugLogWithTag('JOB_SCRIPT_DELETE', `Successfully deleted job script '${identifier}'`);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error deleting job script: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true
+            };
+        }
+    });
+}
+//# sourceMappingURL=job-scripts.js.map

package/dist/tools/job-scripts.js.map

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

package/dist/tools/layout-richstring-widgets.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"layout-richstring-widgets.d.ts","sourceRoot":"","sources":["../../src/tools/layout-richstring-widgets.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;AAoL5C,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsE5C,CAAC;AAMX,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAoJ7F"}
+{"version":3,"file":"layout-richstring-widgets.d.ts","sourceRoot":"","sources":["../../src/tools/layout-richstring-widgets.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;AAyH5C,eAAO,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0E5C,CAAC;AAMX,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,QAoJ7F"}

package/dist/tools/layout-richstring-widgets.js

@@ -1,6 +1,7 @@
 import { z } from "zod";
 import { debugLogWithTag } from "../logger.js";
 import { LayoutContextSchema } from './layout.js';
+import { findWidgetById, buildUpdateRequestBody, determineApiEndpoint, buildRequestParams } from './widget-tool-helpers.js';
 import { richstringInsertWidget, richstringUpdateWidget, richstringDeleteWidget, richstringExtractWidgets, buildContentMap } from './richstring-widgets.js';
 const TOOL_LAYOUT_RICHSTRING_INSERT_WIDGET = 'cplace_layout_richstring_insert_widget';
 const TOOL_LAYOUT_RICHSTRING_UPDATE_WIDGET = 'cplace_layout_richstring_update_widget';
@@ -10,48 +11,6 @@ const RICHSTRING_WIDGET_TYPES = [
     'cf.platform.richString',
     'cf.cplace.demoWidgets.demoRichString'
 ];
-function determineApiEndpoint(context) {
-    return context.type === "page" ? "json/pageLayout" : "json/typeLayout";
-}
-function buildRequestParams(context) {
-    if (context.type === "page") {
-        return { pageUID: context.pageUID };
-    }
-    else {
-        return {
-            workspaceId: context.workspaceId,
-            typeInternalName: context.typeInternalName,
-            ...(context.alternativeLayoutName && { alternativeLayoutName: context.alternativeLayoutName })
-        };
-    }
-}
-function buildUpdateRequestBody(context, widgetId, newConfiguration) {
-    return {
-        ...buildRequestParams(context),
-        operation: {
-            type: "UPDATE",
-            widgetId,
-            newConfiguration
-        }
-    };
-}
-function findWidgetById(rows, widgetId) {
-    for (const row of rows || []) {
-        for (const column of row.columns || []) {
-            for (const widget of column.widgets || []) {
-                if (widget.id === widgetId) {
-                    return widget;
-                }
-                if (widget.widgetsLayout?.rows) {
-                    const nested = findWidgetById(widget.widgetsLayout.rows, widgetId);
-                    if (nested)
-                        return nested;
-                }
-            }
-        }
-    }
-    return null;
-}
 function extractStringConfigValue(configuration, configAttribute) {
     if (!configuration)
         return '';
@@ -128,6 +87,8 @@ Most values are wrapped in single-element arrays:
 - String: {"title": ["My Widget"]}
 - Number: {"height": [800]}
 - Boolean: {"showFooter": [true]}
+- Script (e.g., lowCodeText.script): pass plain JavaScript in an array → {"cf.cplace.lowCodeWidgets.lowCodeTextWidget.script": ["var s = new Search(); return s.count();"]}
+  Do NOT wrap in {"string": ...} or {"version": "1", "script": ...} envelopes — the backend handles wrapping automatically.
 - Complex JSON: {"config": ["{\\"key\\": \\"value\\"}"]}
 
 EXCEPTIONS — these types must NOT be array-wrapped:
@@ -152,6 +113,8 @@ Most values are wrapped in single-element arrays:
 - String: {"title": ["Updated Widget"]}
 - Number: {"height": [900]}
 - Boolean: {"showFooter": [true]}
+- Script (e.g., lowCodeText.script): pass plain JavaScript in an array → {"cf.cplace.lowCodeWidgets.lowCodeTextWidget.script": ["var s = new Search(); return s.count();"]}
+  Do NOT wrap in {"string": ...} or {"version": "1", "script": ...} envelopes — the backend handles wrapping automatically.
 
 EXCEPTIONS — these types must NOT be array-wrapped:
 - LocalizedString: pass as plain map → {"localizedHeading": {"en": "Title", "de": "Titel"}}