@modyo/mcp 0.1.0

package/build/prompts/channels/pages/CreateContentPage.d.ts

@@ -0,0 +1,48 @@
+import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import { PromptBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Prompt for creating a content page with Liquid templates
+ *
+ * Guides users through creating a content page (content/entry type) with:
+ * - Content type linking
+ * - Liquid template configuration
+ * - Router setup for entry pages
+ * - Template management
+ *
+ * @example
+ * Input: { siteId: 123, spaceId: 456, contentTypeId: 789, name: "Blog" }
+ * Output: Step-by-step instructions for creating a content page with Liquid templates
+ */
+export declare class CreateContentPagePrompt extends PromptBase<{
+    siteId: number;
+    spaceId: number;
+    contentTypeId: number;
+    name: string;
+    isEntryPage?: boolean | undefined;
+}> {
+    protected config: {
+        name: string;
+        description: string;
+        isPublic: boolean;
+    };
+    protected getParamsSchema(): z.ZodObject<{
+        siteId: z.ZodNumber;
+        spaceId: z.ZodNumber;
+        contentTypeId: z.ZodNumber;
+        name: z.ZodString;
+        isEntryPage: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>;
+    generate(params: {
+        siteId: number;
+        spaceId: number;
+        contentTypeId: number;
+        name: string;
+        isEntryPage?: boolean;
+    }): Promise<GetPromptResult>;
+    private generateSlug;
+    private generateEntryTemplate;
+    private generateListTemplate;
+}
+export declare const CreateContentPage: Prompt;
+//# sourceMappingURL=CreateContentPage.d.ts.map

package/build/prompts/channels/pages/CreateContentPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateContentPage.d.ts","sourceRoot":"","sources":["../../../../src/prompts/channels/pages/CreateContentPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,qBAAa,uBAAwB,SAAQ,UAAU,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CACnC,CAAC;IACA,SAAS,CAAC,MAAM;;;;MAKd;IAEF,SAAS,CAAC,eAAe;;;;;;;IAmBnB,QAAQ,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsL5B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,qBAAqB;IA0C7B,OAAO,CAAC,oBAAoB;CAgD7B;AAGD,eAAO,MAAM,iBAAiB,EAAE,MAAsC,CAAC"}

package/build/prompts/channels/pages/CreateContentPage.js

@@ -0,0 +1,314 @@
+import { PromptBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Prompt for creating a content page with Liquid templates
+ *
+ * Guides users through creating a content page (content/entry type) with:
+ * - Content type linking
+ * - Liquid template configuration
+ * - Router setup for entry pages
+ * - Template management
+ *
+ * @example
+ * Input: { siteId: 123, spaceId: 456, contentTypeId: 789, name: "Blog" }
+ * Output: Step-by-step instructions for creating a content page with Liquid templates
+ */
+export class CreateContentPagePrompt extends PromptBase {
+    config = {
+        name: "modyo-create-content-page",
+        description: "Guide for creating a content page with Liquid templates and Content API integration",
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return z.object({
+            siteId: z
+                .number()
+                .min(1)
+                .describe("The site ID where the page will be created"),
+            spaceId: z.number().min(1).describe("The content space ID"),
+            contentTypeId: z
+                .number()
+                .min(1)
+                .describe("The content type ID to display"),
+            name: z.string().min(2).max(100).describe("The name of the page"),
+            isEntryPage: z
+                .boolean()
+                .optional()
+                .describe("Whether this is an entry detail page (default: false)"),
+        });
+    }
+    async generate(params) {
+        this.info(`Generating content page creation prompt for ${params.name}`);
+        const isEntryPage = params.isEntryPage || false;
+        const pageType = isEntryPage ? "Entry Detail" : "Content List";
+        const promptText = `# Create Content Page: "${params.name}" (${pageType})
+
+## Overview
+You'll create a **content page** (type: "content") that displays content from the Content API using Liquid templates.
+
+## Context: Content Pages
+- **Purpose**: Server-side rendered pages that display content from Content module
+- **No Widgets**: Cannot add custom widgets to content pages
+- **Liquid Templates**: Use Liquid markup to access and display content
+- **Router Support**: Entry pages use \`has_router: true\` for slug-based routing (/blog/{slug})
+- **SEO Friendly**: Content renders server-side for better search engine indexing
+
+## Step 1: Get Content Type Information
+First, fetch the content type schema to understand available fields:
+
+\`\`\`
+tool: type-get
+spaceId: ${params.spaceId}
+typeId: ${params.contentTypeId}
+\`\`\`
+
+**CRITICAL**: Note the exact field names (with spaces, accents, capitalization).
+Example: "Título", "Icono SVG", "URL" (not "titulo", "icono_svg", "url")
+
+## Step 2: Create the Page
+Use the \`page-create\` tool:
+
+\`\`\`
+siteId: ${params.siteId}
+name: ${params.name}
+path: ${this.generateSlug(params.name)}${isEntryPage ? "/{slug}" : ""}
+type: content
+content_type_id: ${params.contentTypeId}
+${isEntryPage ? "has_router: true  // Enables slug-based routing" : "has_router: false"}
+layout: (optional - use site's default layout)
+parent_id: (optional - parent page ID)
+\`\`\`
+
+${isEntryPage
+            ? `
+**Entry Page Path**: Must include \`/{slug}\` placeholder (e.g., "blog/{slug}")
+**Router Required**: \`has_router: true\` enables server-side slug resolution
+`
+            : `
+**List Page Path**: No slug placeholder (e.g., "blog")
+**Router Optional**: \`has_router: false\` for static list pages
+`}
+
+## Step 3: Add Liquid Templates
+After creating the page, update it with Liquid templates using \`page-update\`:
+
+### ${isEntryPage ? "Entry Detail Template" : "List Page Template"}
+
+\`\`\`liquid
+${isEntryPage ? this.generateEntryTemplate() : this.generateListTemplate()}
+\`\`\`
+
+**Add this template using \`page-update\` tool:**
+\`\`\`
+siteId: ${params.siteId}
+pageId: <page-id-from-step-2>
+templates: [
+  {
+    type: "main",
+    code: "<your-liquid-template-here>"
+  }
+]
+\`\`\`
+
+## Step 4: Access Content Fields in Liquid
+
+**Get Content Type Fields First!**
+Use \`type-get\` tool to see exact field names, then access them:
+
+\`\`\`liquid
+{%- comment -%}
+Example: If content type has fields "Título", "Descripción", "Imagen Principal"
+{%- endcomment -%}
+
+{{ entry.meta.title }}  {# Entry name #}
+{{ entry.meta.slug }}   {# URL slug #}
+{{ entry.fields['Título'] }}  {# Custom field - EXACT name from type-get #}
+{{ entry.fields['Descripción'] }}
+{{ entry.fields['Imagen Principal'].url }}
+\`\`\`
+
+**Field Name Rules:**
+- ✅ Use exact names from \`type-get\`: \`entry.fields['Título']\`
+- ❌ Don't transform names: \`entry.fields['titulo']\` won't work
+- ✅ Preserve spaces: \`entry.fields['Icono SVG']\`
+- ✅ Preserve accents: \`entry.fields['Descripción']\`
+
+## Step 5: Publish the Page
+
+Get publishable elements:
+\`\`\`
+tool: release-get-elements-to-publish
+siteId: ${params.siteId}
+\`\`\`
+
+Create release:
+\`\`\`
+tool: release-create
+siteId: ${params.siteId}
+elements: [<page-id>]
+comment: "Publishing ${params.name} content page"
+\`\`\`
+
+## Common Patterns
+
+### Blog Index + Detail
+1. Create list page: \`blog\` (has_router: false)
+2. Create entry page: \`blog/{slug}\` (has_router: true)
+3. List page shows all entries, links to entry pages
+
+### Product Catalog
+1. Create list page: \`products\` with filters
+2. Create entry page: \`products/{slug}\` with full details
+3. Use Liquid filters: \`by_category\`, \`filter_by\`, \`sort_by\`
+
+### News Section
+1. Create paginated list: Use \`paginated\` filter
+2. Create entry page with related content
+3. Add breadcrumbs with \`page.parent\`
+
+## Liquid Filters for Content
+
+\`\`\`liquid
+{%- assign entries = spaces['space-uid'].types['type-uid'].entries -%}
+
+{# Filter by category #}
+{%- assign filtered = entries | by_category: 'category-slug' -%}
+
+{# Filter by tag #}
+{%- assign tagged = entries | by_tag: 'tag-name' -%}
+
+{# Sort #}
+{%- assign sorted = entries | sort_by: 'created_at', 'desc' -%}
+
+{# Paginate #}
+{%- assign paginated = entries | paginated: 10 -%}
+
+{# Find by slug #}
+{%- assign entry = entries | by_slug: 'my-entry' -%}
+\`\`\`
+
+## Verification Checklist
+- [ ] Page created with type \`content\`
+- [ ] Content type linked correctly
+- [ ] ${isEntryPage ? "Router enabled (`has_router: true`)" : "Path set without slug placeholder"}
+- [ ] Liquid templates added via \`page-update\`
+- [ ] Field names match exactly from \`type-get\`
+- [ ] Page published and accessible
+- [ ] Content displays correctly in browser
+
+## Troubleshooting
+
+**Problem**: Fields show as empty
+**Solution**: Run \`type-get\` and verify exact field names (spaces, accents, case)
+
+**Problem**: Entry page 404 error
+**Solution**: Ensure \`has_router: true\` and path includes \`/{slug}\`
+
+**Problem**: No content displays
+**Solution**: Verify \`content_type_id\` is correct and entries exist
+
+## Documentation
+- Content Pages: https://docs.modyo.com/en/platform/channels/pages.html
+- Liquid Markup: https://docs.modyo.com/en/platform/channels/liquid-markup.html
+- Content API: Use \`type-get\` tool to see field structure`;
+        return this.success(promptText);
+    }
+    generateSlug(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, "");
+    }
+    generateEntryTemplate() {
+        return `{%- comment -%}
+Entry Detail Page Template
+Automatically receives 'entry' object from Content API
+{%- endcomment -%}
+
+<article class="entry-detail">
+  <header>
+    <h1>{{ entry.meta.title }}</h1>
+    <p class="meta">
+      Published: {{ entry.meta.published_at | date: '%B %d, %Y' }}
+      {% if entry.meta.category %}
+        | Category: {{ entry.meta.category.name }}
+      {% endif %}
+    </p>
+  </header>
+
+  <div class="entry-content">
+    {%- comment -%}
+    IMPORTANT: Get exact field names using type-get tool first!
+    {%- endcomment -%}
+
+    {%- if entry.fields['Featured Image'] -%}
+      <img src="{{ entry.fields['Featured Image'].url }}"
+           alt="{{ entry.fields['Featured Image'].alt_text }}">
+    {%- endif -%}
+
+    <div class="body">
+      {{ entry.fields['Body'] }}
+    </div>
+  </div>
+
+  {%- if entry.meta.tags.size > 0 -%}
+    <div class="tags">
+      {%- for tag in entry.meta.tags -%}
+        <span class="tag">{{ tag.name }}</span>
+      {%- endfor -%}
+    </div>
+  {%- endif -%}
+</article>`;
+    }
+    generateListTemplate() {
+        return `{%- comment -%}
+Content List Page Template
+Access entries via spaces['space-uid'].types['type-uid'].entries
+{%- endcomment -%}
+
+{%- assign entries = spaces['space-uid'].types['type-uid'].entries -%}
+{%- assign paginated_entries = entries | paginated: 12 -%}
+
+<div class="content-list">
+  <h1>{{ page.name }}</h1>
+
+  <div class="entries-grid">
+    {%- for entry in paginated_entries -%}
+      <article class="entry-card">
+        {%- if entry.fields['Thumbnail'] -%}
+          <img src="{{ entry.fields['Thumbnail'].url }}"
+               alt="{{ entry.fields['Thumbnail'].alt_text }}">
+        {%- endif -%}
+
+        <h2>
+          <a href="{{ entry.meta.slug }}">{{ entry.meta.title }}</a>
+        </h2>
+
+        {%- if entry.fields['Excerpt'] -%}
+          <p>{{ entry.fields['Excerpt'] }}</p>
+        {%- endif -%}
+
+        <p class="meta">{{ entry.meta.published_at | date: '%B %d, %Y' }}</p>
+      </article>
+    {%- endfor -%}
+  </div>
+
+  {%- if paginated_entries.total_pages > 1 -%}
+    <nav class="pagination">
+      {%- if paginated_entries.previous_page -%}
+        <a href="?page={{ paginated_entries.previous_page }}">Previous</a>
+      {%- endif -%}
+
+      <span>Page {{ paginated_entries.current_page }} of {{ paginated_entries.total_pages }}</span>
+
+      {%- if paginated_entries.next_page -%}
+        <a href="?page={{ paginated_entries.next_page }}">Next</a>
+      {%- endif -%}
+    </nav>
+  {%- endif -%}
+</div>`;
+    }
+}
+// Export instance for registration
+export const CreateContentPage = new CreateContentPagePrompt();
+//# sourceMappingURL=CreateContentPage.js.map

package/build/prompts/channels/pages/CreateContentPage.js.map

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

package/build/prompts/channels/pages/CreateWidgetPage.d.ts

@@ -0,0 +1,47 @@
+import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import { PromptBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Prompt for creating a widget page with proper grid layout
+ *
+ * Guides users through creating a widget page (custom/default type) with:
+ * - Proper grid_type selection
+ * - Layout configuration
+ * - Parent page setup
+ * - Publishing workflow
+ *
+ * @example
+ * Input: { siteId: 123, name: "Dashboard" }
+ * Output: Step-by-step instructions for creating a widget page
+ */
+export declare class CreateWidgetPagePrompt extends PromptBase<{
+    siteId: number;
+    name: string;
+    gridType?: "full_grid" | "full_three_cols_grid" | "side_left_grid" | "side_right_grid" | "full_two_cols_grid" | undefined;
+}> {
+    protected config: {
+        name: string;
+        description: string;
+        isPublic: boolean;
+    };
+    protected getParamsSchema(): z.ZodObject<{
+        siteId: z.ZodNumber;
+        name: z.ZodString;
+        gridType: z.ZodOptional<z.ZodEnum<{
+            full_grid: "full_grid";
+            full_three_cols_grid: "full_three_cols_grid";
+            side_left_grid: "side_left_grid";
+            side_right_grid: "side_right_grid";
+            full_two_cols_grid: "full_two_cols_grid";
+        }>>;
+    }, z.core.$strip>;
+    generate(params: {
+        siteId: number;
+        name: string;
+        gridType?: "full_grid" | "full_three_cols_grid" | "side_left_grid" | "side_right_grid" | "full_two_cols_grid";
+    }): Promise<GetPromptResult>;
+    private generateSlug;
+    private getColumnCount;
+}
+export declare const CreateWidgetPage: Prompt;
+//# sourceMappingURL=CreateWidgetPage.d.ts.map

package/build/prompts/channels/pages/CreateWidgetPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateWidgetPage.d.ts","sourceRoot":"","sources":["../../../../src/prompts/channels/pages/CreateWidgetPage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,qBAAa,sBAAuB,SAAQ,UAAU,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EACL,WAAW,GACX,sBAAsB,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,SAAS,CAAC;CACf,CAAC;IACA,SAAS,CAAC,MAAM;;;;MAKd;IAEF,SAAS,CAAC,eAAe;;;;;;;;;;;IAoBnB,QAAQ,CAAC,MAAM,EAAE;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EACL,WAAW,GACX,sBAAsB,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,CAAC;KAC1B,GAAG,OAAO,CAAC,eAAe,CAAC;IAwH5B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,cAAc;CAUvB;AAGD,eAAO,MAAM,gBAAgB,EAAE,MAAqC,CAAC"}

package/build/prompts/channels/pages/CreateWidgetPage.js

@@ -0,0 +1,176 @@
+import { PromptBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Prompt for creating a widget page with proper grid layout
+ *
+ * Guides users through creating a widget page (custom/default type) with:
+ * - Proper grid_type selection
+ * - Layout configuration
+ * - Parent page setup
+ * - Publishing workflow
+ *
+ * @example
+ * Input: { siteId: 123, name: "Dashboard" }
+ * Output: Step-by-step instructions for creating a widget page
+ */
+export class CreateWidgetPagePrompt extends PromptBase {
+    config = {
+        name: "modyo-create-widget-page",
+        description: "Guide for creating a widget page with proper grid layout and configuration",
+        isPublic: false,
+    };
+    getParamsSchema() {
+        return z.object({
+            siteId: z
+                .number()
+                .min(1)
+                .describe("The site ID where the page will be created"),
+            name: z.string().min(2).max(100).describe("The name of the page"),
+            gridType: z
+                .enum([
+                "full_grid",
+                "full_three_cols_grid",
+                "side_left_grid",
+                "side_right_grid",
+                "full_two_cols_grid",
+            ])
+                .optional()
+                .describe("Grid layout type (optional, defaults to full_grid)"),
+        });
+    }
+    async generate(params) {
+        this.info(`Generating widget page creation prompt for ${params.name}`);
+        const gridType = params.gridType || "full_grid";
+        const promptText = `# Create Widget Page: "${params.name}"
+
+## Overview
+You'll create a **widget page** (type: "custom") that can hold custom widgets arranged in a grid layout.
+
+## Context: Widget Pages
+- **Purpose**: Pages that display custom widgets (React/Vue components, HTML snippets)
+- **Grid Layout**: Controls widget positioning (columns, sidebars)
+- **Router Support**: Can use client-side routing for SPAs
+- **Publishing**: Must publish page after creation to make it live
+
+## Step-by-Step Workflow
+
+### Step 1: Create the Page
+Use the \`page-create\` tool with these parameters:
+
+\`\`\`
+siteId: ${params.siteId}
+name: ${params.name}
+path: ${this.generateSlug(params.name)}
+type: custom
+grid_type: ${gridType}
+layout: (optional - use site's default layout or specify)
+parent_id: (optional - leave empty for root page or specify parent page ID)
+\`\`\`
+
+### Step 2: Understanding Grid Types
+Your selected grid type: **${gridType}**
+
+Grid types available:
+- **full_grid**: Single full-width column (best for dashboards, landing pages)
+- **full_three_cols_grid**: Three equal columns (best for card layouts)
+- **side_left_grid**: Main content + left sidebar (best for navigation)
+- **side_right_grid**: Main content + right sidebar (best for complementary info)
+- **full_two_cols_grid**: Two equal columns (best for comparisons)
+
+### Step 3: Add Widgets (After Page Creation)
+Once page is created, use \`page-add-widgets\` tool:
+
+\`\`\`
+siteId: ${params.siteId}
+pageId: <page-id-from-step-1>
+widgets: [
+  {
+    widget_id: <widget-definition-id>,
+    column: 0,  // For ${gridType}: column 0-${this.getColumnCount(gridType) - 1}
+    order: 0,
+    sync: false  // false = async loading (recommended)
+  }
+]
+\`\`\`
+
+**Widget Loading Modes:**
+- \`sync: false\` (Recommended): Non-blocking, loads after page render
+- \`sync: true\`: Blocking, renders with page (use for critical above-fold content)
+
+### Step 4: Publish the Page
+Get publishable elements:
+\`\`\`
+tool: release-get-elements-to-publish
+siteId: ${params.siteId}
+\`\`\`
+
+Create release:
+\`\`\`
+tool: release-create
+siteId: ${params.siteId}
+elements: [<page-id>, <other-elements>]
+comment: "Publishing ${params.name} page"
+\`\`\`
+
+## Common Patterns
+
+### Homepage with Hero + Content Grid
+\`\`\`
+type: custom
+grid_type: full_grid
+widgets: [
+  { widget_id: hero-banner, column: 0, order: 0, sync: true },
+  { widget_id: featured-cards, column: 0, order: 1, sync: false }
+]
+\`\`\`
+
+### Dashboard with Sidebar
+\`\`\`
+type: custom
+grid_type: side_left_grid
+widgets: [
+  { widget_id: navigation-menu, column: 0, order: 0, sync: true },
+  { widget_id: main-dashboard, column: 1, order: 0, sync: false }
+]
+\`\`\`
+
+## Verification Checklist
+- [ ] Page created with correct type (\`custom\`)
+- [ ] Grid type matches your layout needs
+- [ ] Widgets added to correct columns
+- [ ] Page published and visible on site
+- [ ] Test page loads correctly in browser
+
+## Next Steps
+After creating the widget page, you can:
+1. Add more widgets with \`page-add-widgets\`
+2. Update page properties with \`page-update\`
+3. Create child pages by setting \`parent_id\`
+4. Configure SEO metadata (meta tags, descriptions)
+
+## Documentation
+- Widget Pages: https://docs.modyo.com/en/platform/channels/pages.html
+- Grid Layouts: Check template snippets with \`template-list-snippets\`
+- Publishing: https://docs.modyo.com/en/platform/core/key-concepts.html#versioning`;
+        return this.success(promptText);
+    }
+    generateSlug(name) {
+        return name
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, "");
+    }
+    getColumnCount(gridType) {
+        const columnMap = {
+            full_grid: 1,
+            full_three_cols_grid: 3,
+            side_left_grid: 2,
+            side_right_grid: 2,
+            full_two_cols_grid: 2,
+        };
+        return columnMap[gridType] || 1;
+    }
+}
+// Export instance for registration
+export const CreateWidgetPage = new CreateWidgetPagePrompt();
+//# sourceMappingURL=CreateWidgetPage.js.map

package/build/prompts/channels/pages/CreateWidgetPage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateWidgetPage.js","sourceRoot":"","sources":["../../../../src/prompts/channels/pages/CreateWidgetPage.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,sBAAuB,SAAQ,UAU1C;IACU,MAAM,GAAG;QACjB,IAAI,EAAE,0BAA0B;QAChC,WAAW,EACT,4EAA4E;QAC9E,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEQ,eAAe;QACvB,OAAO,CAAC,CAAC,MAAM,CAAC;YACd,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,4CAA4C,CAAC;YACzD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACjE,QAAQ,EAAE,CAAC;iBACR,IAAI,CAAC;gBACJ,WAAW;gBACX,sBAAsB;gBACtB,gBAAgB;gBAChB,iBAAiB;gBACjB,oBAAoB;aACrB,CAAC;iBACD,QAAQ,EAAE;iBACV,QAAQ,CAAC,oDAAoD,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MASd;QACC,IAAI,CAAC,IAAI,CAAC,8CAA8C,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAEvE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,WAAW,CAAC;QAEhD,MAAM,UAAU,GAAG,0BAA0B,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;UAiBlD,MAAM,CAAC,MAAM;QACf,MAAM,CAAC,IAAI;QACX,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC;;aAEzB,QAAQ;;;;;;6BAMQ,QAAQ;;;;;;;;;;;;;UAa3B,MAAM,CAAC,MAAM;;;;;yBAKE,QAAQ,cAAc,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;UAetE,MAAM,CAAC,MAAM;;;;;;UAMb,MAAM,CAAC,MAAM;;uBAEA,MAAM,CAAC,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mFA0CiD,CAAC;QAEhF,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,CAAC;IAEO,YAAY,CAAC,IAAY;QAC/B,OAAO,IAAI;aACR,WAAW,EAAE;aACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;aAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC7B,CAAC;IAEO,cAAc,CAAC,QAAgB;QACrC,MAAM,SAAS,GAA2B;YACxC,SAAS,EAAE,CAAC;YACZ,oBAAoB,EAAE,CAAC;YACvB,cAAc,EAAE,CAAC;YACjB,eAAe,EAAE,CAAC;YAClB,kBAAkB,EAAE,CAAC;SACtB,CAAC;QACF,OAAO,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,CAAC;CACF;AAED,mCAAmC;AACnC,MAAM,CAAC,MAAM,gBAAgB,GAAW,IAAI,sBAAsB,EAAE,CAAC"}

package/build/prompts/channels/pages/PagesPrompts.d.ts

@@ -0,0 +1,2 @@
+export declare const PagesPrompts: Prompt[];
+//# sourceMappingURL=PagesPrompts.d.ts.map

package/build/prompts/channels/pages/PagesPrompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagesPrompts.d.ts","sourceRoot":"","sources":["../../../../src/prompts/channels/pages/PagesPrompts.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,EAAE,MAAM,EAGhC,CAAC"}

package/build/prompts/channels/pages/PagesPrompts.js

@@ -0,0 +1,7 @@
+import { CreateContentPage } from "./CreateContentPage.js";
+import { CreateWidgetPage } from "./CreateWidgetPage.js";
+export const PagesPrompts = [
+    CreateWidgetPage,
+    CreateContentPage,
+];
+//# sourceMappingURL=PagesPrompts.js.map

package/build/prompts/channels/pages/PagesPrompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagesPrompts.js","sourceRoot":"","sources":["../../../../src/prompts/channels/pages/PagesPrompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,CAAC,MAAM,YAAY,GAAa;IACpC,gBAAgB;IAChB,iBAAiB;CAClB,CAAC"}

package/build/prompts/channels/releases/ManageReleases.d.ts

@@ -0,0 +1,34 @@
+import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import { PromptBase } from "../../../shared/index.js";
+import { z } from "zod";
+/**
+ * Prompt for managing release workflow and publishing
+ *
+ * Guides users through:
+ * - Understanding Modyo's two-step publishing process
+ * - Getting publishable elements
+ * - Creating releases
+ * - Publishing strategies
+ * - Versioning concepts
+ *
+ * @example
+ * Input: { siteId: 123 }
+ * Output: Complete release management and publishing workflow guide
+ */
+export declare class ManageReleasesPrompt extends PromptBase<{
+    siteId: number;
+}> {
+    protected config: {
+        name: string;
+        description: string;
+        isPublic: boolean;
+    };
+    protected getParamsSchema(): z.ZodObject<{
+        siteId: z.ZodNumber;
+    }, z.core.$strip>;
+    generate(params: {
+        siteId: number;
+    }): Promise<GetPromptResult>;
+}
+export declare const ManageReleases: Prompt;
+//# sourceMappingURL=ManageReleases.d.ts.map

package/build/prompts/channels/releases/ManageReleases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ManageReleases.d.ts","sourceRoot":"","sources":["../../../../src/prompts/channels/releases/ManageReleases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,UAAU,CAAC;IACnD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;IACA,SAAS,CAAC,MAAM;;;;MAKd;IAEF,SAAS,CAAC,eAAe;;;IAMnB,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;CA0XrE;AAGD,eAAO,MAAM,cAAc,EAAE,MAAmC,CAAC"}