@curenorway/kode-mcp 1.0.1 → 1.1.0

package/dist/index.js

@@ -70,6 +70,17 @@ var KodeApiClient = class {
   async listPages(siteId) {
     return this.request(`/api/cdn/sites/${siteId}/pages`);
   }
+  async assignScriptToPage(pageId, scriptId, loadOrderOverride) {
+    await this.request(`/api/cdn/pages/${pageId}/scripts`, {
+      method: "POST",
+      body: JSON.stringify({ scriptId, loadOrderOverride })
+    });
+  }
+  async removeScriptFromPage(pageId, scriptId) {
+    await this.request(`/api/cdn/pages/${pageId}/scripts/${scriptId}`, {
+      method: "DELETE"
+    });
+  }
   // Deployment operations
   async deploy(siteId, options = {}) {
     return this.request("/api/cdn/deploy", {
@@ -255,7 +266,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_create_script",
-        description: "Create a new script on the Cure Kode CDN. The script will be available at the CDN URL after deployment.",
+        description: "Create a new script on the Cure Kode CDN. The script will be available at the CDN URL after deployment. Global scripts auto-load by default; page-specific scripts do not.",
         inputSchema: {
           type: "object",
           properties: {
@@ -276,6 +287,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: "string",
               enum: ["global", "page-specific"],
               description: 'Script scope - "global" loads on all pages, "page-specific" only on assigned pages. Default: global'
+            },
+            autoLoad: {
+              type: "boolean",
+              description: "Whether to auto-load the script. Default: true for global scripts, false for page-specific. Set to false for scripts you want to load manually via CK.loadScript()."
             }
           },
           required: ["name", "type", "content"]
@@ -283,7 +298,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "kode_update_script",
-        description: "Update an existing script's content. This creates a new version of the script.",
+        description: "Update an existing script's content or settings. This creates a new version of the script when content changes.",
         inputSchema: {
           type: "object",
           properties: {
@@ -295,12 +310,21 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: "string",
               description: "New script content"
             },
+            autoLoad: {
+              type: "boolean",
+              description: "Whether to auto-load the script. Set to true to load automatically, false for manual loading via CK.loadScript()."
+            },
+            scope: {
+              type: "string",
+              enum: ["global", "page-specific"],
+              description: "Change script scope. Note: changing to page-specific requires assigning to pages."
+            },
             changeSummary: {
               type: "string",
               description: "Brief description of the changes (for version history)"
             }
           },
-          required: ["slug", "content"]
+          required: ["slug"]
         }
       },
       {
@@ -377,6 +401,46 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         }
       },
+      {
+        name: "kode_assign_script_to_page",
+        description: "Assign a page-specific script to a page. Required for page-specific scripts to load on their target pages.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            scriptSlug: {
+              type: "string",
+              description: "Script slug or ID to assign"
+            },
+            pageSlug: {
+              type: "string",
+              description: "Page slug or ID to assign the script to"
+            },
+            loadOrderOverride: {
+              type: "number",
+              description: "Optional load order for this page (overrides script default)"
+            }
+          },
+          required: ["scriptSlug", "pageSlug"]
+        }
+      },
+      {
+        name: "kode_remove_script_from_page",
+        description: "Remove a script from a page assignment.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            scriptSlug: {
+              type: "string",
+              description: "Script slug or ID to remove"
+            },
+            pageSlug: {
+              type: "string",
+              description: "Page slug or ID to remove the script from"
+            }
+          },
+          required: ["scriptSlug", "pageSlug"]
+        }
+      },
       {
         name: "kode_site_info",
         description: "Get information about the current Cure Kode site including domains and CDN URLs.",
@@ -556,20 +620,26 @@ ${script.content}`
         };
       }
       case "kode_create_script": {
-        const { name: scriptName, type, content, scope } = args;
+        const { name: scriptName, type, content, scope, autoLoad } = args;
+        const scriptScope = scope || "global";
         const script = await client.createScript(siteId, {
           name: scriptName,
           slug: scriptName,
           type,
           content,
-          scope: scope || "global"
+          scope: scriptScope,
+          autoLoad
+          // Let API handle default based on scope
         });
+        const autoLoadStatus = script.auto_load ? "will auto-load" : "manual load only (use CK.loadScript())";
         return {
           content: [
             {
               type: "text",
               text: `Created script "${script.name}" (${script.type})
 Slug: ${script.slug}
+Scope: ${script.scope}
+Auto-load: ${autoLoadStatus}
 Version: ${script.current_version}
 
 Note: Run kode_deploy to make it live.`
@@ -578,7 +648,7 @@ Note: Run kode_deploy to make it live.`
         };
       }
       case "kode_update_script": {
-        const { slug, content, changeSummary } = args;
+        const { slug, content, autoLoad, scope, changeSummary } = args;
         const scripts = await client.listScripts(siteId);
         const script = scripts.find((s) => s.slug === slug || s.id === slug);
         if (!script) {
@@ -587,16 +657,22 @@ Note: Run kode_deploy to make it live.`
             isError: true
           };
         }
-        const updated = await client.updateScript(script.id, {
-          content,
-          changeSummary: changeSummary || "Updated via MCP"
-        });
+        const updateData = {};
+        if (content !== void 0) updateData.content = content;
+        if (autoLoad !== void 0) updateData.autoLoad = autoLoad;
+        if (scope !== void 0) updateData.scope = scope;
+        updateData.changeSummary = changeSummary || "Updated via MCP";
+        const updated = await client.updateScript(script.id, updateData);
+        const changes = [];
+        if (content !== void 0) changes.push(`content \u2192 v${updated.current_version}`);
+        if (autoLoad !== void 0) changes.push(`auto_load \u2192 ${autoLoad}`);
+        if (scope !== void 0) changes.push(`scope \u2192 ${scope}`);
         return {
           content: [
             {
               type: "text",
               text: `Updated script "${updated.name}"
-New version: ${updated.current_version}
+Changes: ${changes.join(", ")}
 
 Note: Run kode_deploy to make changes live.`
             }
@@ -764,6 +840,83 @@ Webflow Components:
           ]
         };
       }
+      case "kode_assign_script_to_page": {
+        const { scriptSlug, pageSlug, loadOrderOverride } = args;
+        const scripts = await client.listScripts(siteId);
+        const script = scripts.find((s) => s.slug === scriptSlug || s.id === scriptSlug);
+        if (!script) {
+          return {
+            content: [{ type: "text", text: `Script "${scriptSlug}" not found` }],
+            isError: true
+          };
+        }
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          await client.assignScriptToPage(page.id, script.id, loadOrderOverride);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Assigned script "${script.name}" to page "${page.name}"
+URL patterns: ${page.url_patterns.join(", ")}
+
+Note: Run kode_deploy to make changes live.`
+              }
+            ]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to assign script: ${message}` }],
+            isError: true
+          };
+        }
+      }
+      case "kode_remove_script_from_page": {
+        const { scriptSlug, pageSlug } = args;
+        const scripts = await client.listScripts(siteId);
+        const script = scripts.find((s) => s.slug === scriptSlug || s.id === scriptSlug);
+        if (!script) {
+          return {
+            content: [{ type: "text", text: `Script "${scriptSlug}" not found` }],
+            isError: true
+          };
+        }
+        const pages = await client.listPages(siteId);
+        const page = pages.find((p) => p.slug === pageSlug || p.id === pageSlug);
+        if (!page) {
+          return {
+            content: [{ type: "text", text: `Page "${pageSlug}" not found` }],
+            isError: true
+          };
+        }
+        try {
+          await client.removeScriptFromPage(page.id, script.id);
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Removed script "${script.name}" from page "${page.name}"
+
+Note: Run kode_deploy to make changes live.`
+              }
+            ]
+          };
+        } catch (error) {
+          const message = error instanceof Error ? error.message : "Unknown error";
+          return {
+            content: [{ type: "text", text: `Failed to remove script: ${message}` }],
+            isError: true
+          };
+        }
+      }
       case "kode_site_info": {
         const config = getConfig();
         if (!config) {
@@ -1145,7 +1298,7 @@ Use kode_list_pages_context to see cached pages, or kode_refresh_page to cache a
         text += `Cached: ${context.extractedAt}${isStale ? ` \u26A0\uFE0F (${cacheAgeDays} days old - consider refreshing with kode_refresh_page)` : ""}
 `;
         if (context.stats) {
-          text += `Stats: ${context.stats.sectionCount} sections, ${context.stats.ctaCount} CTAs, ${context.stats.formCount} forms, ${context.stats.imageCount} images, ${context.stats.scriptCount} scripts, ${context.stats.interactionCount} interactions
+          text += `Stats: ${context.stats.sectionCount} sections, ${context.stats.ctaCount} CTAs, ${context.stats.formCount} forms, ${context.stats.linkCount} links, ${context.stats.gridCount || 0} grids, ${context.stats.imageCount} images, ${context.stats.interactiveCount || 0} interactive
 `;
         }
         text += "\n";
@@ -1161,6 +1314,17 @@ Use kode_list_pages_context to see cached pages, or kode_refresh_page to cache a
 `;
             if (flags) text += `Flags: [${flags}]
 `;
+            if (s.children) {
+              const c = s.children;
+              const childInfo = [
+                c.divs && `${c.divs} divs`,
+                c.links && `${c.links} links`,
+                c.buttons && `${c.buttons} buttons`,
+                c.images && `${c.images} images`
+              ].filter(Boolean).join(", ");
+              if (childInfo) text += `Contains: ${childInfo}
+`;
+            }
             if (s.textSample) text += `Preview: ${s.textSample.slice(0, 120)}...
 `;
             text += "\n";
@@ -1313,6 +1477,38 @@ Use kode_list_pages_context to see cached pages, or kode_refresh_page to cache a
           }
           text += "\n";
         }
+        if (context.grids && context.grids.length > 0) {
+          text += `## Grids/Lists (${context.grids.length})
+
+`;
+          for (const g of context.grids) {
+            text += `- \`${g.selector}\` (${g.gridType}, ${g.itemCount} items)
+`;
+            text += `  Item: \`${g.itemSelector}\`
+`;
+          }
+          text += "\n";
+        }
+        if (context.interactiveElements && context.interactiveElements.length > 0) {
+          text += `## Interactive Elements (${context.interactiveElements.length})
+
+`;
+          for (const el of context.interactiveElements) {
+            text += `- ${el.type}: \`${el.selector}\`${el.trigger ? ` [${el.trigger}]` : ""}
+`;
+          }
+          text += "\n";
+        }
+        if (context.links && context.links.length > 0) {
+          const internal = context.links.filter((l) => !l.isExternal).length;
+          const external = context.links.filter((l) => l.isExternal).length;
+          text += `## Links (${context.links.length})
+
+`;
+          text += `Internal: ${internal}, External: ${external}
+
+`;
+        }
         if (context.notes && context.notes.length > 0) {
           text += `## Notes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@curenorway/kode-mcp",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "MCP server for Cure Kode - enables AI agents to manage Webflow scripts",
   "type": "module",
   "bin": {