@charisol/plexo-mcp 1.0.9 → 1.0.11

package/dist/index.js

@@ -6,6 +6,10 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const plexoClient_js_1 = require("./client/plexoClient.js");
 const blogTools_js_1 = require("./blogTools.js");
+const commerceTools_js_1 = require("./commerceTools.js");
+const lmsTools_js_1 = require("./lmsTools.js");
+const donationTools_js_1 = require("./donationTools.js");
+const wpMigrationTools_js_1 = require("./wpMigrationTools.js");
 const server = new index_js_1.Server({
     name: "plexo-mcp",
     version: "1.0.0",
@@ -22,55 +26,78 @@ server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
                 name: "publish_landing_page",
                 description: `Creates, compiles, and publishes a landing page to Plexo in one atomic step. Returns the published live URL and editable visual builder URL.
 
-IMPORTANT INSTRUCTION FOR AI CLIENTS:
+DESIGN QUALITY — read this before writing designJson. Followed correctly it is what separates a premium, bespoke-looking result from a generic AI template; the worked example below demonstrates every rule.
+- Palette: choose one small, deliberate system before writing any row — a near-black/navy/charcoal "ink" plus an off-white/cream "paper" (never pure #000000/#ffffff), one brand accent color used sparingly for CTAs/highlights only, and 2-3 muted grays derived from the ink color for secondary text. Reuse these exact hex values everywhere. Default to this kind of restrained, brand-appropriate palette — NOT a generic dark background with a purple/blue accent — unless the user's prompt clearly calls for that look.
+- Typography: at most three font families — one serif or otherwise distinctive display font for headings (line-height 1.0-1.25, fontWeight 500-600, never 800+), one clean sans-serif for body copy and buttons (paragraphs at line-height 1.6-1.75), and optionally one monospace/condensed font in uppercase with letterSpacing "0.14em"-"0.18em" at a small fontSize (11-13px) reserved only for short eyebrow labels above a heading. Give headings/paragraphs a "maxWidth" (roughly 480-780px) so text never stretches edge-to-edge.
+- Section shell: every section is two layers, using the column's optional 'nestedRows' array (see schema below) — an OUTER row carries the section's full-bleed backgroundColor to the viewport edge with horizontal padding of either "0" or a fluid "clamp(20px, 6vw, 56px)" (never a fixed px value), containing one "100%"-width column whose 'nestedRows' holds an INNER row that caps actual content at maxWidth ~1200-1440px. Alternate background colors between sections (ink, paper, a warm neutral, a soft accent tint) for rhythm instead of leaving every section the same color.
+- Restraint: borderRadius near 0 by default (an editorial, premium feel) — reserve a rounded pill (~100px) only for tags/badges, small radii (2-10px) only for buttons/cards/inputs. Use boxShadow rarely and only as a soft, large, low-opacity shadow tinted with the ink color (never plain black) — most elements should have none.
+- Layout variety: vary column-width splits across sections (an asymmetric ~55/45 hero, a 33.33/33.33/33.33 feature grid, alternating ~60/40 image-and-text rows) instead of repeating the same centered block or identical grid everywhere. Buttons: understated solid-accent fill or a text link with a colored underline/arrow, fontWeight 600, padding ~"14px 26px", sharp-to-small corner radius, specific action copy ("Book a Consultation →") not generic "Click Here". Images: descriptive specific "alt" text, an intentional width/maxWidth so nothing stretches full-bleed by accident.
+
+STRUCTURAL RULES:
 The designJson argument MUST be a fully hydrated layout tree containing body style and rows array. There is no shorthand format —
 do NOT send rows shaped like { "type": "products", "content": { "items": [...] } }. That will be REJECTED with a validation error.
-Every row MUST already contain a 'columns' array with percentage widths ('100%', '50%', '33.33%'), and each column MUST contain an
-'elements' array with fully-styled component objects ('heading', 'paragraph', 'button', 'card', 'image', 'menu', 'social', 'divider',
-'spacer', 'form_container'). For any repeated-item section (products, features, testimonials, pricing tiers, etc.) YOU must expand
-each item into its own column with real elements — one column per item — rather than passing a list for the server to interpret.
+Every row MUST already contain a 'columns' array with percentage widths ('100%', '50%', '33.33%'), and each column MUST contain either
+an 'elements' array of fully-styled component objects ('heading', 'paragraph', 'button', 'card', 'image', 'menu', 'social', 'divider',
+'spacer', 'form_container') and/or a 'nestedRows' array (same shape as a top-level row — id/style/columns — used for the outer/inner
+full-bleed section shell described above; a column may have nestedRows, elements, or both). For any repeated-item section (products,
+features, testimonials, pricing tiers, etc.) YOU must expand each item into its own column with real elements — one column per item —
+rather than passing a list for the server to interpret.
 
-EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
+EXAMPLE VALID designJson PAYLOAD (full-bleed hero with an asymmetric 55/45 split, plus a full-bleed 3-up feature row) — note the
+restrained ink/paper/terracotta palette, the serif/sans/mono type system, near-zero border radius, and the outer/inner row shell:
 {
   "body": {
-    "style": { "backgroundColor": "#08090f", "color": "#f0f2ff", "fontFamily": "Inter, sans-serif", "htmlTitle": "Bulum SaaS Platform" },
+    "style": { "backgroundColor": "#FAF7F1", "color": "#1B2430", "fontFamily": "'Inter', sans-serif", "htmlTitle": "Norrland Coffee Roasters" },
     "rows": [
       {
-        "id": "row-hero",
-        "style": { "paddingTop": "80px", "paddingBottom": "80px" },
+        "id": "row-hero-outer",
+        "style": { "backgroundColor": "#1B2430", "padding": "0 clamp(24px, 6vw, 64px)" },
         "columns": [
-          {
-            "id": "col-hero",
-            "width": "100%",
-            "elements": [
-              { "type": "heading", "style": { "fontSize": "48px", "fontWeight": "800", "textAlign": "center", "color": "#ffffff" }, "attributes": { "text": "Build & Scale Faster" } },
-              { "type": "paragraph", "style": { "fontSize": "18px", "color": "#94a3b8", "textAlign": "center" }, "attributes": { "text": "The ultimate platform for modern digital teams." } },
-              { "type": "button", "style": { "textAlign": "center", "backgroundColor": "#8b5cf6", "color": "#ffffff", "borderRadius": "12px", "paddingTop": "14px", "paddingBottom": "14px", "paddingLeft": "28px", "paddingRight": "28px" }, "attributes": { "text": "Start Free Trial", "href": "#signup" } }
-            ]
-          }
+          { "id": "col-hero-outer", "width": "100%", "elements": [], "nestedRows": [
+            {
+              "id": "row-hero-inner",
+              "style": { "maxWidth": "1200px", "margin": "0 auto" },
+              "columns": [
+                { "id": "col-hero-text", "width": "55%", "styles": { "padding": "96px 32px 96px 0" }, "elements": [
+                  { "id": "el-eyebrow", "type": "text", "style": { "fontFamily": "'IBM Plex Mono', monospace", "fontSize": "12px", "letterSpacing": "0.16em", "textTransform": "uppercase", "color": "#C4623B" }, "attributes": { "text": "Small-Batch Roastery" } },
+                  { "id": "el-heading", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "48px", "lineHeight": "1.1", "color": "#FAF7F1", "maxWidth": "560px", "margin": "16px 0 0" }, "attributes": { "text": "Coffee, Roasted With Intention" } },
+                  { "id": "el-sub", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "17px", "lineHeight": "1.7", "color": "#B7BEC9", "maxWidth": "480px", "margin": "20px 0 0" }, "attributes": { "text": "Single-origin beans sourced direct from growers, roasted weekly in small batches for a cup that actually tastes like where it came from." } },
+                  { "id": "el-cta", "type": "button", "style": { "backgroundColor": "#C4623B", "color": "#FAF7F1", "border": "none", "borderRadius": "2px", "fontFamily": "'Inter', sans-serif", "fontWeight": "600", "fontSize": "15px", "padding": "14px 26px", "margin": "28px 0 0" }, "attributes": { "text": "Shop This Week's Roast →", "href": "/shop" } }
+                ] },
+                { "id": "col-hero-image", "width": "45%", "elements": [
+                  { "id": "el-hero-img", "type": "image", "style": { "width": "100%", "borderRadius": "4px", "boxShadow": "0 18px 34px -14px rgba(27,36,48,0.45)" }, "attributes": { "src": "https://...", "alt": "Roaster pouring fresh-roasted beans into a cooling tray" } }
+                ] }
+              ]
+            }
+          ] }
         ]
       },
       {
-        "id": "row-products",
-        "style": { "paddingTop": "60px", "paddingBottom": "60px" },
+        "id": "row-features-outer",
+        "style": { "backgroundColor": "#FAF7F1", "padding": "0 clamp(24px, 6vw, 64px)" },
         "columns": [
-          { "id": "col-product-1", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Urban Runner" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Urban Runner" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Lightweight sneakers for daily adventures" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$89" } }
-          ] },
-          { "id": "col-product-2", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Classic Court" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Classic Court" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Timeless style with modern comfort" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$79" } }
-          ] },
-          { "id": "col-product-3", "width": "33.33%", "elements": [
-            { "type": "image", "style": { "width": "100%", "borderRadius": "12px" }, "attributes": { "src": "https://...", "alt": "Street Flex" } },
-            { "type": "heading", "style": { "fontSize": "20px", "marginTop": "12px" }, "attributes": { "text": "Street Flex" } },
-            { "type": "paragraph", "style": { "fontSize": "14px", "color": "#94a3b8" }, "attributes": { "text": "Flexible performance footwear" } },
-            { "type": "paragraph", "style": { "fontSize": "16px", "fontWeight": "700", "color": "#8b5cf6" }, "attributes": { "text": "$99" } }
+          { "id": "col-features-outer", "width": "100%", "elements": [], "nestedRows": [
+            {
+              "id": "row-features-inner",
+              "style": { "maxWidth": "1200px", "margin": "0 auto", "padding": "80px 0" },
+              "columns": [
+                { "id": "col-feature-1", "width": "33.33%", "elements": [
+                  { "id": "el-icon-1", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "leaf", "iconSize": 30 } },
+                  { "id": "el-h-1", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Direct Trade" } },
+                  { "id": "el-p-1", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Every farm relationship is ours, not a broker's." } }
+                ] },
+                { "id": "col-feature-2", "width": "33.33%", "elements": [
+                  { "id": "el-icon-2", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "flame", "iconSize": 30 } },
+                  { "id": "el-h-2", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Roasted Weekly" } },
+                  { "id": "el-p-2", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Never more than seven days off the roaster." } }
+                ] },
+                { "id": "col-feature-3", "width": "33.33%", "elements": [
+                  { "id": "el-icon-3", "type": "icon", "style": { "color": "#C4623B" }, "attributes": { "iconName": "truck", "iconSize": 30 } },
+                  { "id": "el-h-3", "type": "heading", "style": { "fontFamily": "'Playfair Display', serif", "fontWeight": "600", "fontSize": "22px", "color": "#1B2430", "margin": "16px 0 0" }, "attributes": { "text": "Shipped Fresh" } },
+                  { "id": "el-p-3", "type": "paragraph", "style": { "fontFamily": "'Inter', sans-serif", "fontSize": "15px", "lineHeight": "1.65", "color": "#5B6472", "margin": "8px 0 0" }, "attributes": { "text": "Out the door within 24 hours of roasting." } }
+                ] }
+              ]
+            }
           ] }
         ]
       }
@@ -124,6 +151,7 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                                                                 width: { type: "string", description: "Percentage width (e.g. '100%', '50%', '33.33%')." },
                                                                 elements: {
                                                                     type: "array",
+                                                                    description: "This column's own content elements. May be empty ([]) when the column instead uses 'nestedRows' below (the full-bleed section-shell pattern) — a column may have elements, nestedRows, or both.",
                                                                     items: {
                                                                         type: "object",
                                                                         required: ["id", "type", "style", "attributes"],
@@ -137,6 +165,15 @@ EXAMPLE VALID designJson PAYLOAD (hero row, plus a 3-item product grid row):
                                                                         },
                                                                     },
                                                                 },
+                                                                nestedRows: {
+                                                                    type: "array",
+                                                                    description: "OPTIONAL. Nested row(s) inside this column, each the SAME shape as a top-level row (id/style/columns). This is how you build a full-bleed section: the outer row/column carries the background color edge-to-edge, and a nestedRow here caps content at a readable maxWidth. Use this instead of putting a 'maxWidth' directly on the outer row.",
+                                                                    items: {
+                                                                        type: "object",
+                                                                        required: ["id", "style", "columns"],
+                                                                        description: "Same shape as a top-level row: { id, style, columns: [{ id, width, elements, nestedRows? }] } — nesting may repeat if genuinely needed, but one level (outer band + inner capped row) covers nearly every section.",
+                                                                    },
+                                                                },
                                                             },
                                                         },
                                                     },
@@ -506,6 +543,23 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
                     required: ["templateId"],
                 },
             },
+            {
+                name: "delete_template",
+                description: "Permanently deletes any landing page or email template by templateId or template name (e.g. 'buzm'). Same underlying operation as delete_landing_page_page. Confirm with user before calling as this action cannot be undone.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        templateId: {
+                            type: "string",
+                            description: "ID of the template or page to delete (UUID, or exact/partial template name like 'buzm').",
+                        },
+                        name: {
+                            type: "string",
+                            description: "Optional template name or search phrase if templateId is unknown (e.g. 'buzm').",
+                        },
+                    },
+                },
+            },
             {
                 name: "delete_landing_page_page",
                 description: "Deletes a page. If it has sub-pages nested under it, they're deleted too (cascade) — the response reports how many. Deleting a site's home page deletes the whole site, including every page nested under it and its published domain link — this can't be undone, confirm with the user first.",
@@ -589,6 +643,10 @@ To edit a page's CONTENT (designJson), use update_template with the same templat
                 },
             },
             ...blogTools_js_1.BLOG_TOOL_DEFS,
+            ...commerceTools_js_1.COMMERCE_TOOL_DEFS,
+            ...lmsTools_js_1.LMS_TOOL_DEFS,
+            ...donationTools_js_1.DONATION_TOOL_DEFS,
+            ...wpMigrationTools_js_1.WP_MIGRATION_TOOL_DEFS,
         ],
     };
 });
@@ -730,8 +788,26 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "delete_template":
             case "delete_landing_page_page": {
-                const result = await client.deleteLandingPagePage(args?.templateId);
+                const rawInput = (args?.templateId || args?.name || "").trim();
+                if (!rawInput)
+                    throw new Error("templateId or template name is required.");
+                // Same UUID-or-name resolution as the server's own delete_template/
+                // delete_landing_page_page handler — try an exact id match first, then fall back to
+                // a case-insensitive name search across this account's templates.
+                let resolvedId = rawInput;
+                const { templates } = await client.listTemplates();
+                const byId = (templates || []).find((t) => t.id === rawInput);
+                if (!byId) {
+                    const needle = rawInput.toLowerCase();
+                    const matches = (templates || []).filter((t) => t.name?.toLowerCase().includes(needle));
+                    matches.sort((a, b) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""));
+                    if (!matches[0])
+                        throw new Error(`No template found matching "${rawInput}".`);
+                    resolvedId = matches[0].id;
+                }
+                const result = await client.deleteLandingPagePage(resolvedId);
                 return {
                     content: [
                         {
@@ -825,6 +901,37 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
                         ],
                     };
                 }
+                if (commerceTools_js_1.COMMERCE_TOOL_NAMES.has(name)) {
+                    const result = await (0, commerceTools_js_1.handleCommerceToolCall)(name, args || {}, client);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                if (lmsTools_js_1.LMS_TOOL_NAMES.has(name)) {
+                    const result = await (0, lmsTools_js_1.handleLmsToolCall)(name, args || {}, client);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: JSON.stringify(result, null, 2),
+                            },
+                        ],
+                    };
+                }
+                for (const [names, handler] of [
+                    [donationTools_js_1.DONATION_TOOL_NAMES, donationTools_js_1.handleDonationToolCall],
+                    [wpMigrationTools_js_1.WP_MIGRATION_TOOL_NAMES, wpMigrationTools_js_1.handleWpMigrationToolCall],
+                ]) {
+                    if (names.has(name)) {
+                        const result = await handler(name, args || {}, client);
+                        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+                    }
+                }
                 throw new Error(`Unknown tool: ${name}`);
             }
         }

package/dist/lmsTools.js

@@ -0,0 +1,254 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LMS_TOOL_NAMES = exports.LMS_TOOL_DEFS = void 0;
+exports.handleLmsToolCall = handleLmsToolCall;
+exports.LMS_TOOL_DEFS = [
+    {
+        name: "create_funnel",
+        description: "Attaches Funnel/LMS capability to an existing root landing page (see create_landing_page / list_landing_pages for how to get one), seeding a single Welcome page. Gated by the organization's funnel slot allowance (get_funnel_addon_slots shows current usage) — fails with the slot summary if none is available.",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string", description: "An existing root landing page's template id to turn into a funnel." } },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "get_funnel",
+        description: "Fetches a funnel's settings: enabled state, signup mode (FREE/PAID), signup product, and welcome-page options.",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "update_funnel",
+        description: "Updates a funnel's settings. Only the fields provided are changed. Switching signupMode to PAID requires signupProductId (a DIGITAL Commerce product) to already be set or provided here.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                enabled: { type: "boolean" },
+                signupMode: { type: "string", enum: ["FREE", "PAID"] },
+                signupProductId: { type: "string", description: "A DIGITAL Commerce product id (see create_commerce_product). Pass an empty string to clear it." },
+                requireName: { type: "boolean" },
+                collectPhone: { type: "boolean" },
+                welcomeRedirectPath: { type: "string", description: "Pass an empty string to clear it." },
+            },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "delete_funnel",
+        description: "Soft-deletes a funnel (enabled:false — hidden from visitors). Pages, enrollments, and progress are kept, so re-enabling later restores everything as-is.",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "list_funnel_pages",
+        description: "Lists a funnel's pages in their display order.",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "create_funnel_page",
+        description: "Appends a new page to a funnel. Defaults to kind VIDEO and unlocks after the current last page — use update_funnel_page to customize unlockRules afterward.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                title: { type: "string", description: "Defaults to \"Page N\"." },
+                kind: { type: "string", enum: ["WELCOME", "VIDEO", "DOCUMENT", "IMAGE"], description: "Defaults to VIDEO." },
+            },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "update_funnel_page",
+        description: "Updates a funnel page's content and/or unlock rules. Only the fields provided are changed. unlockRules shape: { mode: \"ALL\", conditions: [...] } where each condition is one of PREREQUISITE_PAGES ({type,pageIds}), TIME_DRIP_RELATIVE ({type,days}), TIME_DRIP_FIXED_DATE ({type,date}), MANUAL_APPROVAL ({type}) — satisfied via approve_funnel_enrollment_page.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                pageId: { type: "string" },
+                title: { type: "string" },
+                kind: { type: "string", enum: ["WELCOME", "VIDEO", "DOCUMENT", "IMAGE"] },
+                contentMode: { type: "string", enum: ["SIMPLE", "RAW_HTML", "ADVANCED"], description: "SIMPLE/RAW_HTML both write to bodyHtml; ADVANCED is a full-builder page and isn't settable from here." },
+                bodyHtml: { type: "string", description: "Sanitized server-side. For a WELCOME page this renders as plain text, not markup." },
+                youtubeVideoId: { type: "string", description: "Empty string clears it." },
+                assetUrl: { type: "string", description: "Already-uploaded file URL (this tool can't accept raw bytes). Empty string clears it." },
+                assetFileName: { type: "string" },
+                assetMimeType: { type: "string" },
+                assetSizeBytes: { type: "number" },
+                unlockRules: { type: "object", description: "See this tool's description for the shape." },
+                visible: { type: "boolean" },
+            },
+            required: ["templateId", "pageId"],
+        },
+    },
+    {
+        name: "delete_funnel_page",
+        description: "Deletes a funnel page and closes the resulting order gap in the remaining pages.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                pageId: { type: "string" },
+            },
+            required: ["templateId", "pageId"],
+        },
+    },
+    {
+        name: "reorder_funnel_pages",
+        description: "Reorders a funnel's pages. orderedPageIds must contain exactly this funnel's current page ids, in the new order.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                orderedPageIds: { type: "array", items: { type: "string" } },
+            },
+            required: ["templateId", "orderedPageIds"],
+        },
+    },
+    {
+        name: "list_funnel_enrollments",
+        description: "Lists a funnel's learner enrollments, most recently enrolled first.",
+        inputSchema: {
+            type: "object",
+            properties: { templateId: { type: "string", description: "The funnel's home page template id." } },
+            required: ["templateId"],
+        },
+    },
+    {
+        name: "get_funnel_enrollment",
+        description: "Fetches one learner's enrollment plus their per-page progress.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                email: { type: "string" },
+            },
+            required: ["templateId", "email"],
+        },
+    },
+    {
+        name: "approve_funnel_enrollment_page",
+        description: "Marks one page as manually approved for one learner — the way a MANUAL_APPROVAL unlock condition gets satisfied (see update_funnel_page's unlockRules description). Reversible: calling it again just re-stamps the approval.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                email: { type: "string" },
+                pageId: { type: "string" },
+            },
+            required: ["templateId", "email", "pageId"],
+        },
+    },
+    {
+        name: "set_funnel_enrollment_status",
+        description: "Revokes or reactivates a learner's enrollment. Revoked takes effect immediately on their next page load (no session to separately invalidate).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                email: { type: "string" },
+                status: { type: "string", enum: ["ACTIVE", "REVOKED"] },
+            },
+            required: ["templateId", "email", "status"],
+        },
+    },
+    {
+        name: "resend_funnel_magic_link",
+        description: "Re-sends the passwordless login email to an ACTIVE learner. Rate-limited to once per 60 seconds per learner.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                templateId: { type: "string", description: "The funnel's home page template id." },
+                email: { type: "string" },
+            },
+            required: ["templateId", "email"],
+        },
+    },
+    {
+        name: "get_funnel_addon_slots",
+        description: "Reports the organization's funnel slot usage (plan-included + purchased addon slots vs. funnels currently using one) and any active addon-slot subscriptions. Org-scoped, not per-site.",
+        inputSchema: { type: "object", properties: {} },
+    },
+];
+exports.LMS_TOOL_NAMES = new Set(exports.LMS_TOOL_DEFS.map((t) => t.name));
+async function handleLmsToolCall(name, args, client) {
+    const templateId = typeof args?.templateId === "string" ? args.templateId : "";
+    switch (name) {
+        case "create_funnel": {
+            if (!templateId)
+                throw new Error("templateId is required.");
+            const result = await client.createFunnel(templateId);
+            return { success: true, funnel: result.funnel };
+        }
+        case "get_funnel":
+            return await client.getFunnel(templateId);
+        case "update_funnel": {
+            const { templateId: _t, ...payload } = args;
+            const result = await client.updateFunnel(templateId, payload);
+            return { success: true, funnel: result.funnel };
+        }
+        case "delete_funnel":
+            await client.deleteFunnel(templateId);
+            return { success: true };
+        case "list_funnel_pages":
+            return await client.listFunnelPages(templateId);
+        case "create_funnel_page": {
+            const result = await client.createFunnelPage(templateId, { title: args.title, kind: args.kind });
+            return { success: true, page: result.page };
+        }
+        case "update_funnel_page": {
+            if (!args.pageId)
+                throw new Error("pageId is required.");
+            const { templateId: _t, pageId, ...payload } = args;
+            const result = await client.updateFunnelPage(templateId, pageId, payload);
+            return { success: true, page: result.page };
+        }
+        case "delete_funnel_page":
+            if (!args.pageId)
+                throw new Error("pageId is required.");
+            await client.deleteFunnelPage(templateId, args.pageId);
+            return { success: true, deletedPageId: args.pageId };
+        case "reorder_funnel_pages": {
+            if (!Array.isArray(args.orderedPageIds) || args.orderedPageIds.length === 0)
+                throw new Error("orderedPageIds is required.");
+            return await client.reorderFunnelPages(templateId, args.orderedPageIds);
+        }
+        case "list_funnel_enrollments":
+            return await client.listFunnelEnrollments(templateId);
+        case "get_funnel_enrollment":
+            if (!args.email)
+                throw new Error("email is required.");
+            return await client.getFunnelEnrollment(templateId, args.email);
+        case "approve_funnel_enrollment_page": {
+            if (!args.email || !args.pageId)
+                throw new Error("email and pageId are required.");
+            const result = await client.approveFunnelEnrollmentPage(templateId, args.email, args.pageId);
+            return { success: true, progress: result.progress };
+        }
+        case "set_funnel_enrollment_status": {
+            if (!args.email || !args.status)
+                throw new Error("email and status are required.");
+            const result = await client.setFunnelEnrollmentStatus(templateId, args.email, args.status);
+            return { success: true, enrollment: result.enrollment };
+        }
+        case "resend_funnel_magic_link":
+            if (!args.email)
+                throw new Error("email is required.");
+            return await client.resendFunnelMagicLink(templateId, args.email);
+        case "get_funnel_addon_slots":
+            return await client.getFunnelAddonSlots();
+        default:
+            throw new Error(`Unknown tool: ${name}`);
+    }
+}