@modyo/mcp 0.1.0

package/build/tools/channels/locks/Manage.js

@@ -0,0 +1,197 @@
+import { LocksRepository } from "../../../repositories/channels/locks/LocksRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const paramsSchema = z
+    .object({
+    action: z
+        .enum([
+        "acquire",
+        "get",
+        "list",
+        "release",
+    ])
+        .default("list")
+        .describe("Action to perform: 'acquire' (lock resource), 'get' (get lock details), 'list' (list all locks), 'release' (unlock resource)"),
+    // For acquire action
+    lockable_type: z
+        .string()
+        .optional()
+        .describe("Resource type to lock (e.g., 'LayoutPage', 'Templates::SiteTemplate', 'WidgetDefinition', 'Entry') - required for acquire"),
+    lockable_id: z
+        .number()
+        .optional()
+        .describe("Resource ID to lock - required for acquire"),
+    // For get/release actions
+    lockId: z
+        .number()
+        .optional()
+        .describe("Lock ID - required for get and release actions"),
+    // For list action (pagination)
+    page: z
+        .number()
+        .min(1)
+        .default(1)
+        .describe("Page number for pagination (default: 1)"),
+    per_page: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(100)
+        .describe("Items per page (default: 100, max: 100)"),
+})
+    .refine((data) => data.action !== "acquire" ||
+    (data.lockable_type !== undefined && data.lockable_id !== undefined), {
+    message: "lockable_type and lockable_id required for acquire action",
+    path: [
+        "lockable_type",
+    ],
+})
+    .refine((data) => data.action !== "get" || data.lockId !== undefined, {
+    message: "lockId required for get action",
+    path: [
+        "lockId",
+    ],
+})
+    .refine((data) => data.action !== "release" ||
+    data.lockId !== undefined ||
+    (data.lockable_type !== undefined && data.lockable_id !== undefined), {
+    message: "release requires either lockId OR lockable_type + lockable_id",
+    path: [
+        "lockId",
+    ],
+});
+class LocksManageTool extends ToolBase {
+    config = {
+        name: "channels-locks-manage",
+        description: `Lock lifecycle for concurrent editing protection. Types: LayoutPage, Template, WidgetDefinition, Entry. Flow: acquire → edit → release.
+📚 modyo://docs/tools/channels-locks-manage`,
+        annotations: {
+            title: "Manage Locks",
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { action } = params;
+        switch (action) {
+            case "acquire":
+                return this.handleAcquire(params);
+            case "get":
+                return this.handleGet(params);
+            case "list":
+                return this.handleList(params);
+            case "release":
+                return this.handleRelease(params);
+            default:
+                throw new Error(`Unknown action: ${action}`);
+        }
+    }
+    /**
+     * Handle acquire action - lock a resource
+     */
+    async handleAcquire(params) {
+        const { lockable_type, lockable_id } = params;
+        const repository = await this.getRepository(LocksRepository);
+        this.debug("Acquiring lock", {
+            lockable_type,
+            lockable_id,
+        });
+        const lock = await repository.acquireLock({
+            lockable_type: lockable_type,
+            lockable_id: lockable_id,
+        });
+        return this.success({
+            id: lock.id,
+            lockable_type: lock.lockable_type,
+            lockable_id: lock.lockable_id,
+            admin_user_id: lock.admin_user_id,
+            created_at: lock.created_at,
+            action: "acquired",
+            message: `Lock acquired on ${lockable_type} ${lockable_id}`,
+        });
+    }
+    /**
+     * Handle get action - retrieve lock details
+     */
+    async handleGet(params) {
+        const { lockId } = params;
+        const repository = await this.getRepository(LocksRepository);
+        this.debug("Getting lock details", {
+            lockId,
+        });
+        const lock = await repository.getLock(lockId);
+        return this.success({
+            id: lock.id,
+            lockable_type: lock.lockable_type,
+            lockable_id: lock.lockable_id,
+            admin_user_id: lock.admin_user_id,
+            admin_user: lock.admin_user,
+            created_at: lock.created_at,
+            updated_at: lock.updated_at,
+        });
+    }
+    /**
+     * Handle list action - list all active locks
+     */
+    async handleList(params) {
+        const { page, per_page } = params;
+        const repository = await this.getRepository(LocksRepository);
+        this.debug("Listing locks", {
+            page,
+            per_page,
+        });
+        const result = await repository.listLocks(page, per_page);
+        return this.success({
+            locks: result.locks.map((lock) => ({
+                id: lock.id,
+                lockable_type: lock.lockable_type,
+                lockable_id: lock.lockable_id,
+                admin_user_id: lock.admin_user_id,
+                admin_user: lock.admin_user,
+                created_at: lock.created_at,
+            })),
+            total: result.meta.total_entries,
+            page: result.meta.current_page,
+            per_page: result.meta.per_page,
+            total_pages: result.meta.total_pages,
+        });
+    }
+    /**
+     * Handle release action - release a lock by lockId or by lockable_type + lockable_id
+     */
+    async handleRelease(params) {
+        const { lockId, lockable_type, lockable_id } = params;
+        const repository = await this.getRepository(LocksRepository);
+        if (lockId) {
+            this.debug("Releasing lock by lockId", {
+                lockId,
+            });
+            await repository.releaseLock(lockId);
+            return this.success({
+                lockId,
+                released: true,
+                action: "released",
+                message: `Lock ${lockId} released successfully`,
+            });
+        }
+        this.debug("Releasing lock by lockable", {
+            lockable_type,
+            lockable_id,
+        });
+        await repository.releaseLockByLockable(lockable_type, lockable_id);
+        return this.success({
+            lockable_type,
+            lockable_id,
+            released: true,
+            action: "released",
+            message: `Lock on ${lockable_type} ${lockable_id} released successfully`,
+        });
+    }
+}
+export const Manage = new LocksManageTool();
+//# sourceMappingURL=Manage.js.map

package/build/tools/channels/locks/Manage.js.map

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

package/build/tools/channels/navigation/Copy.d.ts

@@ -0,0 +1,12 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    sourceSiteId: z.ZodNumber;
+    sourceMenuId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    targetSiteId: z.ZodNumber;
+    newName: z.ZodOptional<z.ZodString>;
+    newSlug: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const Copy: Tool;
+export {};
+//# sourceMappingURL=Copy.d.ts.map

package/build/tools/channels/navigation/Copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Copy.d.ts","sourceRoot":"","sources":["../../../../src/tools/channels/navigation/Copy.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;iBAgChB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAuQxD,eAAO,MAAM,IAAI,EAAE,IAAmC,CAAC"}

package/build/tools/channels/navigation/Copy.js

@@ -0,0 +1,226 @@
+import { NavigationRepository } from "../../../repositories/channels/navigation/NavigationRepository.js";
+import { SitesRepository } from "../../../repositories/channels/sites/SitesRepository.js";
+import { ToolBase } from "../../../shared/index.js";
+import { z } from "zod";
+const paramsSchema = z.object({
+    // Source
+    sourceSiteId: z.number().min(1).describe("Source site ID"),
+    sourceMenuId: z
+        .union([
+        z.string(),
+        z.number(),
+    ])
+        .describe("Source menu ID, slug, or name"),
+    // Target
+    targetSiteId: z
+        .number()
+        .min(1)
+        .describe("Target site ID (can be same or different from source)"),
+    // Copy options
+    newName: z
+        .string()
+        .min(2)
+        .max(100)
+        .optional()
+        .describe("New name for copied menu (defaults to source name with copy suffix)"),
+    newSlug: z
+        .string()
+        .regex(/^[a-z0-9]+(-[a-z0-9]+)*$/, {
+        message: "Slug must be lowercase letters, numbers, and hyphens only",
+    })
+        .optional()
+        .describe("New slug for copied menu (required if same site)"),
+});
+/**
+ * High-level tool for copying navigation menus between sites/platforms.
+ *
+ * Features:
+ * - Cross-platform menu copying
+ * - Copies complete menu item hierarchy
+ * - Auto-suffix slug on conflict
+ */
+class NavigationMenuCopyTool extends ToolBase {
+    config = {
+        name: "channels-menus-copy",
+        description: `Copy menu cross-site with item hierarchy. Auto-suffix slug on conflict.
+📚 modyo://docs/tools/channels-menus-copy`,
+        annotations: {
+            title: "Copy Menu",
+            readOnlyHint: false,
+            idempotentHint: false,
+            destructiveHint: false,
+        },
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return paramsSchema;
+    }
+    async execute(params) {
+        const { sourceSiteId, sourceMenuId, targetSiteId, newName, newSlug } = params;
+        const isSameSite = sourceSiteId === targetSiteId;
+        // Validation: same site copy requires new slug
+        if (isSameSite && !newSlug) {
+            throw new Error("newSlug is required when copying to the same site");
+        }
+        // Get repositories
+        const sourceNavRepo = await this.getRepository(NavigationRepository);
+        const targetNavRepo = await this.getRepository(NavigationRepository);
+        // Step 1: Resolve source menu
+        this.debug("Resolving source menu", {
+            sourceMenuId,
+            sourceSiteId,
+        });
+        const sourceMenu = await this.resolveMenu(sourceNavRepo, sourceSiteId, sourceMenuId);
+        if (!sourceMenu) {
+            throw new Error(`Menu not found with identifier: ${sourceMenuId}`);
+        }
+        this.debug("Source menu resolved", {
+            id: sourceMenu.id,
+            slug: sourceMenu.slug,
+            name: sourceMenu.name,
+            itemCount: sourceMenu.menus?.length || 0,
+        });
+        // Step 2: Resolve target site (verify it exists)
+        const targetSiteRepo = await this.getRepository(SitesRepository);
+        try {
+            await targetSiteRepo.getSite(targetSiteId);
+        }
+        catch {
+            throw new Error(`Target site ${targetSiteId} not found`);
+        }
+        // Step 3: Resolve naming and slug conflicts
+        let targetName = newName || sourceMenu.name;
+        let targetSlug = newSlug || sourceMenu.slug;
+        // Check for slug conflicts in target site
+        const existingMenus = await sourceNavRepo.getMenus(targetSiteId);
+        const existingSlugs = existingMenus.menus?.map((m) => m.slug) || [];
+        const existingNames = existingMenus.menus?.map((m) => m.name) || [];
+        if (existingSlugs.includes(targetSlug)) {
+            targetSlug = this.generateUniqueSlug(targetSlug, existingSlugs);
+            this.debug("Slug conflict resolved", {
+                original: newSlug || sourceMenu.slug,
+                resolved: targetSlug,
+            });
+        }
+        if (existingNames.includes(targetName)) {
+            targetName = this.generateUniqueName(targetName, existingNames);
+            this.debug("Name conflict resolved", {
+                original: newName || sourceMenu.name,
+                resolved: targetName,
+            });
+        }
+        // Step 4: Create menu in target site
+        this.debug("Creating menu in target site", {
+            targetSiteId,
+            targetName,
+            targetSlug,
+        });
+        const createdMenu = await targetNavRepo.createMenu(targetSiteId, {
+            name: targetName,
+            slug: targetSlug,
+        });
+        // Step 5: Copy menu items recursively
+        let itemsCopied = 0;
+        if (sourceMenu.menus && sourceMenu.menus.length > 0) {
+            itemsCopied = await this.copyMenuItems(targetNavRepo, targetSiteId, createdMenu.id, sourceMenu.menus, null);
+        }
+        // Get final menu state
+        const targetMenu = await targetNavRepo.getMenu(targetSiteId, createdMenu.id);
+        return this.success({
+            source: {
+                id: sourceMenu.id,
+                slug: sourceMenu.slug,
+                name: sourceMenu.name,
+                siteId: sourceSiteId,
+            },
+            target: {
+                id: targetMenu.id,
+                slug: targetMenu.slug,
+                name: targetMenu.name,
+                siteId: targetSiteId,
+            },
+            action: "created",
+            itemsCopied,
+        });
+    }
+    /**
+     * Resolve menu by ID, slug, or name
+     */
+    async resolveMenu(repository, siteId, identifier) {
+        // If numeric, get directly
+        if (typeof identifier === "number") {
+            return repository.getMenu(siteId, identifier);
+        }
+        // If string, search by slug or name
+        const menus = await repository.getMenus(siteId);
+        // Try exact slug match first
+        let menu = menus.menus?.find((m) => m.slug === identifier);
+        // Try name match if slug didn't work
+        if (!menu) {
+            menu = menus.menus?.find((m) => m.name === identifier);
+        }
+        if (!menu) {
+            return null;
+        }
+        // Get full menu data with items
+        return repository.getMenu(siteId, menu.id);
+    }
+    /**
+     * Recursively copy menu items
+     */
+    async copyMenuItems(repository, siteId, menuId, items, parentId) {
+        let count = 0;
+        for (const item of items) {
+            try {
+                // Create item in target menu
+                const createdItem = await repository.addMenuItem(siteId, menuId, {
+                    label: item.label,
+                    url: item.url || "",
+                    target: item.target || "_self",
+                    visible: item.visible !== false,
+                    parent_id: parentId || undefined,
+                });
+                count++;
+                // Recursively copy children if any
+                if (item.child_items && item.child_items.length > 0) {
+                    const childCount = await this.copyMenuItems(repository, siteId, menuId, item.child_items, createdItem.id);
+                    count += childCount;
+                }
+            }
+            catch (error) {
+                this.debug("Failed to copy menu item", {
+                    label: item.label,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+                // Continue with other items
+            }
+        }
+        return count;
+    }
+    /**
+     * Generate unique slug by adding -copy, -copy-2, etc.
+     */
+    generateUniqueSlug(baseSlug, existingSlugs) {
+        let counter = 0;
+        let newSlug = `${baseSlug}-copy`;
+        while (existingSlugs.includes(newSlug)) {
+            counter++;
+            newSlug = `${baseSlug}-copy-${counter + 1}`;
+        }
+        return newSlug;
+    }
+    /**
+     * Generate unique name by adding (Copy), (Copy 2), etc.
+     */
+    generateUniqueName(baseName, existingNames) {
+        let counter = 0;
+        let newName = `${baseName} (Copy)`;
+        while (existingNames.includes(newName)) {
+            counter++;
+            newName = `${baseName} (Copy ${counter + 1})`;
+        }
+        return newName;
+    }
+}
+export const Copy = new NavigationMenuCopyTool();
+//# sourceMappingURL=Copy.js.map

package/build/tools/channels/navigation/Copy.js.map

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

package/build/tools/channels/navigation/Manage.d.ts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+declare const paramsSchema: z.ZodObject<{
+    siteId: z.ZodNumber;
+    action: z.ZodDefault<z.ZodEnum<{
+        delete: "delete";
+        list: "list";
+        manage: "manage";
+    }>>;
+    identifier: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    name: z.ZodOptional<z.ZodString>;
+    slug: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    verify: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type ParamsSchema = z.infer<typeof paramsSchema>;
+export declare const Manage: Tool;
+export {};
+//# sourceMappingURL=Manage.d.ts.map

package/build/tools/channels/navigation/Manage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Manage.d.ts","sourceRoot":"","sources":["../../../../src/tools/channels/navigation/Manage.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,YAAY;;;;;;;;;;;;iBAuDf,CAAC;AAEJ,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AA0OxD,eAAO,MAAM,MAAM,EAAE,IAAqC,CAAC"}