fastmode-mcp 1.0.0

package/dist/tools/cms-items.js

@@ -0,0 +1,376 @@
+"use strict";
+/**
+ * CMS Item Management Tools
+ *
+ * CRUD operations for managing items in CMS collections via the dashboard API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCmsItem = createCmsItem;
+exports.listCmsItems = listCmsItems;
+exports.getCmsItem = getCmsItem;
+exports.updateCmsItem = updateCmsItem;
+exports.deleteCmsItem = deleteCmsItem;
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+/**
+ * Helper to ensure authentication and resolve project ID
+ */
+async function prepareRequest(projectId) {
+    // Check if we need to authenticate
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return { success: false, message: authResult.message };
+        }
+    }
+    // Resolve project ID
+    const resolved = await (0, api_client_1.resolveProjectId)(projectId);
+    if ('error' in resolved) {
+        return { success: false, message: `# Project Not Found\n\n${resolved.error}` };
+    }
+    return { success: true, tenantId: resolved.tenantId };
+}
+/**
+ * Helper to get collection ID from slug
+ * Dashboard API uses collection IDs, not slugs
+ */
+async function getCollectionId(tenantId, collectionSlug) {
+    const response = await (0, api_client_1.apiRequest)('/api/collections', { tenantId });
+    if ((0, api_client_1.isApiError)(response)) {
+        return { error: `Failed to fetch collections: ${response.error}` };
+    }
+    const collection = response.data.find(c => c.slug === collectionSlug);
+    if (!collection) {
+        const available = response.data.map(c => `- ${c.slug} (${c.name})`).join('\n');
+        return {
+            error: `Collection "${collectionSlug}" not found.\n\nAvailable collections:\n${available || 'None'}`
+        };
+    }
+    return { collectionId: collection.id };
+}
+/**
+ * Create a new item in a CMS collection
+ */
+async function createCmsItem(params) {
+    const prep = await prepareRequest(params.projectId);
+    if (!prep.success)
+        return prep.message;
+    // Get collection ID from slug
+    const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
+    if ('error' in collectionResult) {
+        return `# Error\n\n${collectionResult.error}`;
+    }
+    const response = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, {
+        tenantId: prep.tenantId,
+        method: 'POST',
+        body: {
+            name: params.name,
+            slug: params.slug,
+            data: params.data,
+            publishedAt: params.publishedAt || new Date().toISOString(),
+        },
+    });
+    if ((0, api_client_1.isApiError)(response)) {
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated)
+                return authResult.message;
+            // Retry
+            const retry = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, {
+                tenantId: prep.tenantId,
+                method: 'POST',
+                body: {
+                    name: params.name,
+                    slug: params.slug,
+                    data: params.data,
+                    publishedAt: params.publishedAt || new Date().toISOString(),
+                },
+            });
+            if ((0, api_client_1.isApiError)(retry)) {
+                return `# Error Creating Item\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
+            }
+            return formatCreatedItem(retry.data, params.collectionSlug);
+        }
+        return `# Error Creating Item\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
+    }
+    return formatCreatedItem(response.data, params.collectionSlug);
+}
+function formatCreatedItem(item, collectionSlug) {
+    return `# Item Created Successfully
+
+**Collection:** ${collectionSlug}
+**Name:** ${item.name}
+**Slug:** ${item.slug || 'N/A'}
+**ID:** ${item.id}
+**Published:** ${item.publishedAt || 'Draft'}
+
+## Item Data
+\`\`\`json
+${JSON.stringify(item.data, null, 2)}
+\`\`\`
+`;
+}
+/**
+ * List items in a CMS collection
+ */
+async function listCmsItems(params) {
+    const prep = await prepareRequest(params.projectId);
+    if (!prep.success)
+        return prep.message;
+    // Get collection ID from slug
+    const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
+    if ('error' in collectionResult) {
+        return `# Error\n\n${collectionResult.error}`;
+    }
+    // Build query params
+    const queryParams = new URLSearchParams();
+    if (params.limit)
+        queryParams.set('limit', String(params.limit));
+    if (params.sort)
+        queryParams.set('sort', params.sort);
+    if (params.order)
+        queryParams.set('order', params.order);
+    const queryString = queryParams.toString();
+    const endpoint = `/api/collections/${collectionResult.collectionId}/items${queryString ? '?' + queryString : ''}`;
+    const response = await (0, api_client_1.apiRequest)(endpoint, { tenantId: prep.tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(response)) {
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated)
+                return authResult.message;
+            const retry = await (0, api_client_1.apiRequest)(endpoint, { tenantId: prep.tenantId, method: 'GET' });
+            if ((0, api_client_1.isApiError)(retry)) {
+                return `# Error Listing Items\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
+            }
+            return formatItemsList(retry.data, params.collectionSlug);
+        }
+        return `# Error Listing Items\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
+    }
+    return formatItemsList(response.data, params.collectionSlug);
+}
+function formatItemsList(items, collectionSlug) {
+    if (!items || items.length === 0) {
+        return `# No Items Found
+
+Collection **${collectionSlug}** is empty.
+
+Use \`create_cms_item\` to add items to this collection.
+`;
+    }
+    let output = `# Items in ${collectionSlug}
+
+Found ${items.length} item${items.length !== 1 ? 's' : ''}:
+
+| Name | Slug | Published | ID |
+|------|------|-----------|-----|
+`;
+    for (const item of items) {
+        const published = item.publishedAt ? new Date(item.publishedAt).toLocaleDateString() : 'Draft';
+        output += `| ${item.name} | ${item.slug || '-'} | ${published} | \`${item.id.slice(0, 8)}...\` |\n`;
+    }
+    output += `
+---
+
+## Item Details
+
+`;
+    for (const item of items) {
+        output += `### ${item.name}
+- **Slug:** \`${item.slug || 'N/A'}\`
+- **ID:** \`${item.id}\`
+- **Data:** ${Object.keys(item.data).length} fields
+
+`;
+    }
+    return output;
+}
+/**
+ * Get a single item by slug
+ */
+async function getCmsItem(params) {
+    const prep = await prepareRequest(params.projectId);
+    if (!prep.success)
+        return prep.message;
+    // Get collection ID from slug
+    const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
+    if ('error' in collectionResult) {
+        return `# Error\n\n${collectionResult.error}`;
+    }
+    // List items and find by slug (dashboard API uses item IDs, not slugs)
+    const response = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, { tenantId: prep.tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(response)) {
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated)
+                return authResult.message;
+            const retry = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, { tenantId: prep.tenantId, method: 'GET' });
+            if ((0, api_client_1.isApiError)(retry)) {
+                return `# Error Fetching Item\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
+            }
+            const item = retry.data.find(i => i.slug === params.itemSlug);
+            if (!item) {
+                return `# Item Not Found\n\nNo item with slug "${params.itemSlug}" in collection "${params.collectionSlug}".`;
+            }
+            return formatSingleItem(item, params.collectionSlug);
+        }
+        return `# Error Fetching Item\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
+    }
+    const item = response.data.find(i => i.slug === params.itemSlug);
+    if (!item) {
+        return `# Item Not Found\n\nNo item with slug "${params.itemSlug}" in collection "${params.collectionSlug}".`;
+    }
+    return formatSingleItem(item, params.collectionSlug);
+}
+function formatSingleItem(item, collectionSlug) {
+    return `# ${item.name}
+
+**Collection:** ${collectionSlug}
+**Slug:** \`${item.slug || 'N/A'}\`
+**ID:** \`${item.id}\`
+**Published:** ${item.publishedAt ? new Date(item.publishedAt).toLocaleString() : 'Draft'}
+**Created:** ${new Date(item.createdAt).toLocaleString()}
+**Updated:** ${new Date(item.updatedAt).toLocaleString()}
+
+## Item Data
+
+\`\`\`json
+${JSON.stringify(item.data, null, 2)}
+\`\`\`
+`;
+}
+/**
+ * Update an existing item
+ */
+async function updateCmsItem(params) {
+    const prep = await prepareRequest(params.projectId);
+    if (!prep.success)
+        return prep.message;
+    // Get collection ID from slug
+    const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
+    if ('error' in collectionResult) {
+        return `# Error\n\n${collectionResult.error}`;
+    }
+    // Find item ID by slug
+    const itemsResponse = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, { tenantId: prep.tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(itemsResponse)) {
+        return `# Error Finding Item\n\n${itemsResponse.error}\n\n**Status:** ${itemsResponse.statusCode}`;
+    }
+    const existingItem = itemsResponse.data.find(i => i.slug === params.itemSlug);
+    if (!existingItem) {
+        return `# Item Not Found\n\nNo item with slug "${params.itemSlug}" in collection "${params.collectionSlug}".`;
+    }
+    // Build the update body with only provided fields
+    // IMPORTANT: Merge new data with existing data to preserve fields not being updated
+    const updateBody = {};
+    if (params.name !== undefined)
+        updateBody.name = params.name;
+    if (params.data !== undefined) {
+        // Merge with existing data - new fields override, existing fields preserved
+        const existingData = existingItem.data;
+        updateBody.data = { ...existingData, ...params.data };
+    }
+    if (params.publishedAt !== undefined)
+        updateBody.publishedAt = params.publishedAt;
+    if (Object.keys(updateBody).length === 0) {
+        return `# No Updates Provided
+
+You must provide at least one of: \`name\`, \`data\`, or \`publishedAt\` to update.
+`;
+    }
+    const response = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items/${existingItem.id}`, {
+        tenantId: prep.tenantId,
+        method: 'PUT',
+        body: updateBody,
+    });
+    if ((0, api_client_1.isApiError)(response)) {
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated)
+                return authResult.message;
+            const retry = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items/${existingItem.id}`, {
+                tenantId: prep.tenantId,
+                method: 'PUT',
+                body: updateBody,
+            });
+            if ((0, api_client_1.isApiError)(retry)) {
+                return `# Error Updating Item\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
+            }
+            return formatUpdatedItem(retry.data, params.collectionSlug);
+        }
+        return `# Error Updating Item\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
+    }
+    return formatUpdatedItem(response.data, params.collectionSlug);
+}
+function formatUpdatedItem(item, collectionSlug) {
+    return `# Item Updated Successfully
+
+**Collection:** ${collectionSlug}
+**Name:** ${item.name}
+**Slug:** ${item.slug || 'N/A'}
+**ID:** ${item.id}
+**Updated:** ${new Date(item.updatedAt).toLocaleString()}
+
+## Updated Data
+\`\`\`json
+${JSON.stringify(item.data, null, 2)}
+\`\`\`
+`;
+}
+/**
+ * Delete an item from a collection
+ * REQUIRES confirmDelete: true to execute
+ */
+async function deleteCmsItem(params) {
+    // Safety check: require explicit confirmation
+    if (params.confirmDelete !== true) {
+        return `# Confirmation Required
+
+**You must get explicit permission from the user before deleting items.**
+
+To delete the item "${params.itemSlug}" from collection "${params.collectionSlug}":
+
+1. Ask the user: "Are you sure you want to delete [item name]? This cannot be undone."
+2. Only after the user confirms, call this tool again with \`confirmDelete: true\`
+
+**Never delete without user confirmation.**
+`;
+    }
+    const prep = await prepareRequest(params.projectId);
+    if (!prep.success)
+        return prep.message;
+    // Get collection ID from slug
+    const collectionResult = await getCollectionId(prep.tenantId, params.collectionSlug);
+    if ('error' in collectionResult) {
+        return `# Error\n\n${collectionResult.error}`;
+    }
+    // Find item ID by slug
+    const itemsResponse = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items`, { tenantId: prep.tenantId, method: 'GET' });
+    if ((0, api_client_1.isApiError)(itemsResponse)) {
+        return `# Error Finding Item\n\n${itemsResponse.error}\n\n**Status:** ${itemsResponse.statusCode}`;
+    }
+    const existingItem = itemsResponse.data.find(i => i.slug === params.itemSlug);
+    if (!existingItem) {
+        return `# Item Not Found\n\nNo item with slug "${params.itemSlug}" in collection "${params.collectionSlug}".`;
+    }
+    const response = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items/${existingItem.id}`, { tenantId: prep.tenantId, method: 'DELETE' });
+    if ((0, api_client_1.isApiError)(response)) {
+        if ((0, api_client_1.needsAuthError)(response)) {
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated)
+                return authResult.message;
+            const retry = await (0, api_client_1.apiRequest)(`/api/collections/${collectionResult.collectionId}/items/${existingItem.id}`, { tenantId: prep.tenantId, method: 'DELETE' });
+            if ((0, api_client_1.isApiError)(retry)) {
+                return `# Error Deleting Item\n\n${retry.error}\n\n**Status:** ${retry.statusCode}`;
+            }
+            return `# Item Deleted
+
+Successfully deleted item "${params.itemSlug}" from collection "${params.collectionSlug}".
+`;
+        }
+        return `# Error Deleting Item\n\n${response.error}\n\n**Status:** ${response.statusCode}`;
+    }
+    return `# Item Deleted
+
+Successfully deleted item "${params.itemSlug}" from collection "${params.collectionSlug}".
+`;
+}

package/dist/tools/create-site.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Create a new Fast Mode site/project
+ *
+ * @param name - The name of the project
+ * @param subdomain - Optional: Custom subdomain (auto-generated from name if not provided)
+ * @param confirmCreate - Optional: Skip similar-name check (set to true after user confirms)
+ */
+export declare function createSite(name: string, subdomain?: string, confirmCreate?: boolean): Promise<string>;
+//# sourceMappingURL=create-site.d.ts.map

package/dist/tools/create-site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-site.d.ts","sourceRoot":"","sources":["../../src/tools/create-site.ts"],"names":[],"mappings":"AAiEA;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAwI3G"}

package/dist/tools/create-site.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSite = createSite;
+const api_client_1 = require("../lib/api-client");
+const device_flow_1 = require("../lib/device-flow");
+/**
+ * Check for similar project names
+ */
+function findSimilarProjects(name, projects) {
+    const normalizedName = name.toLowerCase().trim();
+    return projects.filter(project => {
+        const projectName = project.name.toLowerCase();
+        // Exact match
+        if (projectName === normalizedName)
+            return true;
+        // One contains the other
+        if (projectName.includes(normalizedName) || normalizedName.includes(projectName))
+            return true;
+        // Similar words (check if main words overlap)
+        const nameWords = normalizedName.split(/\s+/).filter(w => w.length > 2);
+        const projectWords = projectName.split(/\s+/).filter(w => w.length > 2);
+        const overlap = nameWords.filter(w => projectWords.some(pw => pw.includes(w) || w.includes(pw)));
+        if (overlap.length > 0 && overlap.length >= nameWords.length * 0.5)
+            return true;
+        return false;
+    });
+}
+/**
+ * List existing projects for the authenticated user
+ */
+async function listExistingProjects() {
+    const response = await (0, api_client_1.apiRequest)('/api/tenants');
+    if ((0, api_client_1.isApiError)(response)) {
+        return [];
+    }
+    return response.data;
+}
+/**
+ * Create a new Fast Mode site/project
+ *
+ * @param name - The name of the project
+ * @param subdomain - Optional: Custom subdomain (auto-generated from name if not provided)
+ * @param confirmCreate - Optional: Skip similar-name check (set to true after user confirms)
+ */
+async function createSite(name, subdomain, confirmCreate) {
+    // Check authentication
+    if (await (0, api_client_1.needsAuthentication)()) {
+        const authResult = await (0, device_flow_1.ensureAuthenticated)();
+        if (!authResult.authenticated) {
+            return authResult.message;
+        }
+    }
+    // Validate name
+    if (!name || name.trim().length === 0) {
+        return `# Invalid Name
+
+Please provide a name for your project.
+
+Example:
+\`\`\`
+create_site(name: "My Awesome Website")
+\`\`\`
+`;
+    }
+    // Check for similar projects (unless confirmCreate is true)
+    if (!confirmCreate) {
+        const existingProjects = await listExistingProjects();
+        const similarProjects = findSimilarProjects(name, existingProjects);
+        if (similarProjects.length > 0) {
+            let output = `# Similar Project Found
+
+Before creating "${name}", please note that you have similar existing project(s):
+
+`;
+            similarProjects.forEach((project, index) => {
+                const url = project.customDomain || `${project.subdomain}.fastmode.ai`;
+                output += `${index + 1}. **${project.name}**
+   - ID: \`${project.id}\`
+   - URL: ${url}
+
+`;
+            });
+            output += `---
+
+## ACTION REQUIRED
+
+**Ask the user:** "I found a similar project called '${similarProjects[0].name}'. Would you like to:
+1. Deploy to the existing project '${similarProjects[0].name}'?
+2. Create a new project called '${name}'?"
+
+### If deploying to existing project:
+\`\`\`
+deploy_package(
+  packagePath: "./your-site.zip",
+  projectId: "${similarProjects[0].id}"
+)
+\`\`\`
+
+### If creating new project anyway:
+\`\`\`
+create_site(name: "${name}", confirmCreate: true)
+\`\`\`
+`;
+            return output;
+        }
+    }
+    // Generate subdomain from name if not provided
+    const finalSubdomain = subdomain || name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .slice(0, 30);
+    // Create the site
+    const response = await (0, api_client_1.apiRequest)('/api/tenants', {
+        method: 'POST',
+        body: {
+            name: name.trim(),
+            subdomain: finalSubdomain,
+        },
+    });
+    if ((0, api_client_1.isApiError)(response)) {
+        // Check for common errors
+        if (response.error.includes('subdomain') && response.error.includes('taken')) {
+            return `# Subdomain Already Taken
+
+The subdomain "${finalSubdomain}" is already in use.
+
+Try creating with a different subdomain:
+\`\`\`
+create_site(name: "${name}", subdomain: "${finalSubdomain}-2")
+\`\`\`
+`;
+        }
+        if (response.statusCode === 401) {
+            // Try to re-authenticate
+            const authResult = await (0, device_flow_1.ensureAuthenticated)();
+            if (!authResult.authenticated) {
+                return authResult.message;
+            }
+            // Retry
+            const retryResponse = await (0, api_client_1.apiRequest)('/api/tenants', {
+                method: 'POST',
+                body: {
+                    name: name.trim(),
+                    subdomain: finalSubdomain,
+                },
+            });
+            if ((0, api_client_1.isApiError)(retryResponse)) {
+                return `# Failed to Create Site
+
+${retryResponse.error}
+
+Please try again or create manually at app.fastmode.ai
+`;
+            }
+            return formatSuccess(retryResponse.data);
+        }
+        return `# Failed to Create Site
+
+${response.error}
+
+Please try again or create manually at app.fastmode.ai
+`;
+    }
+    return formatSuccess(response.data);
+}
+/**
+ * Format success message
+ */
+function formatSuccess(site) {
+    return `# Site Created Successfully! 🎉
+
+## Your New Site
+
+- **Name:** ${site.name}
+- **URL:** https://${site.subdomain}.fastmode.ai
+- **Project ID:** \`${site.id}\`
+
+## Next Steps
+
+**Option 1: Deploy via MCP**
+\`\`\`
+deploy_package(
+  packagePath: "./your-site.zip",
+  projectId: "${site.id}"
+)
+\`\`\`
+
+**Option 2: Connect GitHub**
+1. Go to app.fastmode.ai
+2. Open Settings → Connected Git Repository
+3. Connect your GitHub account and select a repo
+
+**Option 3: Manual Upload**
+1. Go to app.fastmode.ai
+2. Upload your website package in the Editor
+
+---
+
+Your site is ready at: https://${site.subdomain}.fastmode.ai
+`;
+}

package/dist/tools/deploy-package.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Deploy a website package to Fast Mode
+ *
+ * @param packagePath - Path to the zip file
+ * @param projectId - Project ID to deploy to (use list_projects to find, or create_site to create new)
+ * @param force - Optional: Skip GitHub connection check and deploy anyway
+ */
+export declare function deployPackage(packagePath: string, projectId?: string, force?: boolean): Promise<string>;
+//# sourceMappingURL=deploy-package.d.ts.map

package/dist/tools/deploy-package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy-package.d.ts","sourceRoot":"","sources":["../../src/tools/deploy-package.ts"],"names":[],"mappings":"AA4QA;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,WAAW,EAAE,MAAM,EACnB,SAAS,CAAC,EAAE,MAAM,EAClB,KAAK,CAAC,EAAE,OAAO,GACd,OAAO,CAAC,MAAM,CAAC,CA2LjB"}