@insforge/mcp 1.1.7-dev.9 → 1.2.1

package/dist/{chunk-HEUOFCZP.js → chunk-MRGODXOM.js}

@@ -4,6 +4,9 @@
 import { z as z14 } from "zod";
 import fetch2 from "node-fetch";
 import { promises as fs } from "fs";
+import { exec } from "child_process";
+import { promisify } from "util";
+import { tmpdir } from "os";
 
 // src/shared/response-handler.ts
 async function handleApiResponse(response) {
@@ -735,6 +738,7 @@ var functionUpdateRequestSchema = z13.object({
 
 // src/shared/tools.ts
 import FormData from "form-data";
+var execAsync = promisify(exec);
 var TOOL_VERSION_REQUIREMENTS = {
   "upsert-schedule": "1.1.1",
   // 'get-schedules': '1.1.1',
@@ -774,8 +778,10 @@ function registerInsforgeTools(server, config = {}) {
     }
   }
   function compareVersions(v1, v2) {
-    const parts1 = v1.split(".").map(Number);
-    const parts2 = v2.split(".").map(Number);
+    const clean1 = v1.replace(/^v/, "").split("-")[0];
+    const clean2 = v2.replace(/^v/, "").split("-")[0];
+    const parts1 = clean1.split(".").map(Number);
+    const parts2 = clean2.split(".").map(Number);
     for (let i = 0; i < Math.max(parts1.length, parts2.length); i++) {
       const part1 = parts1[i] || 0;
       const part2 = parts2[i] || 0;
@@ -834,6 +840,9 @@ function registerInsforgeTools(server, config = {}) {
           "Content-Type": "application/json"
         }
       });
+      if (response.status === 404) {
+        throw new Error("Documentation not found");
+      }
       const result = await handleApiResponse(response);
       if (result && typeof result === "object" && "content" in result) {
         let content = result.content;
@@ -847,27 +856,65 @@ function registerInsforgeTools(server, config = {}) {
       throw new Error(`Unable to retrieve ${docType} documentation: ${errMsg}`);
     }
   };
+  const fetchInsforgeInstructionsContext = async () => {
+    try {
+      return await fetchDocumentation("instructions");
+    } catch (error) {
+      console.error("Failed to fetch insforge-instructions.md:", error);
+      return null;
+    }
+  };
+  const addBackgroundContext = async (response) => {
+    try {
+      const currentVersion = await getBackendVersion();
+      const isLegacyVersion = compareVersions(currentVersion, "1.1.7") < 0;
+      if (isLegacyVersion) {
+        const context = await fetchInsforgeInstructionsContext();
+        if (context && response.content && Array.isArray(response.content)) {
+          response.content.push({
+            type: "text",
+            text: `
+
+---
+\u{1F527} INSFORGE DEVELOPMENT RULES (Auto-loaded):
+${context}`
+          });
+        }
+      }
+    } catch {
+      console.warn("Could not determine backend version, skipping background context");
+    }
+    return response;
+  };
   server.tool(
     "fetch-docs",
     'Fetch Insforge documentation. Use "instructions" for essential backend setup (MANDATORY FIRST), or select specific SDK docs for database, auth, storage, functions, or AI integration.',
     {
-      docType: z14.enum(["instructions", "db-sdk", "storage-sdk", "functions-sdk", "ai-integration-sdk", "auth-components-nextjs", "auth-components-react"]).describe(
-        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features), "auth-components-nextjs" (authentication components for Next.js applications), "auth-components-react" (authentication components for React applications),'
+      docType: z14.enum(["instructions", "db-sdk", "storage-sdk", "functions-sdk", "ai-integration-sdk", "auth-components-react"]).describe(
+        'Documentation type: "instructions" (essential backend setup - use FIRST), "db-sdk" (database operations), "storage-sdk" (file storage), "functions-sdk" (edge functions), "ai-integration-sdk" (AI features), "auth-components-react" (authentication components for React+Vite applications).'
       )
     },
     withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
         const content = await fetchDocumentation(docType);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: content
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        if (errMsg.includes("404") || errMsg.toLowerCase().includes("not found")) {
+          return {
+            content: [{
+              type: "text",
+              text: `Documentation for "${docType}" is not available. This is likely because your backend version is too old and doesn't support this documentation endpoint yet. This won't affect the functionality of the tools - they will still work correctly.`
+            }]
+          };
+        }
         return {
           content: [{ type: "text", text: `Error fetching ${docType} documentation: ${errMsg}` }]
         };
@@ -891,14 +938,14 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Anonymous token generated", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -930,14 +977,14 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Schema retrieved", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -968,7 +1015,7 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const metadata = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -977,7 +1024,7 @@ function registerInsforgeTools(server, config = {}) {
 ${JSON.stringify(metadata, null, 2)}`
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1015,14 +1062,14 @@ ${JSON.stringify(metadata, null, 2)}`
           body: JSON.stringify(requestBody)
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("SQL query executed", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1037,6 +1084,82 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
+  server.tool(
+    "download-template",
+    "CRITICAL: MANDATORY FIRST STEP for all new InsForge projects. Download pre-configured starter template (React) to a temporary directory. After download, you MUST copy files to current directory using the provided command.",
+    {
+      frame: z14.enum(["react"]).describe("Framework to use for the template (currently only React is supported)"),
+      projectName: z14.string().optional().describe('Name for the project directory (optional, defaults to "insforge-react")')
+    },
+    withUsageTracking("download-template", async ({ frame, projectName }) => {
+      try {
+        const response = await fetch2(`${API_BASE_URL}/api/auth/tokens/anon`, {
+          method: "POST",
+          headers: {
+            "x-api-key": getApiKey(),
+            "Content-Type": "application/json"
+          }
+        });
+        const result = await handleApiResponse(response);
+        const anonKey = result.accessToken;
+        if (!anonKey) {
+          throw new Error("Failed to retrieve anon key from backend");
+        }
+        const tempDir = tmpdir();
+        const targetDir = projectName || `insforge-${frame}`;
+        const templatePath = `${tempDir}/${targetDir}`;
+        console.error(`[download-template] Target path: ${templatePath}`);
+        try {
+          const stats = await fs.stat(templatePath);
+          if (stats.isDirectory()) {
+            console.error(`[download-template] Removing existing template at ${templatePath}`);
+            await fs.rm(templatePath, { recursive: true, force: true });
+          }
+        } catch {
+        }
+        const command = `npx create-insforge-app ${targetDir} --frame ${frame} --base-url ${API_BASE_URL} --anon-key ${anonKey} --skip-install`;
+        const { stdout, stderr } = await execAsync(command, {
+          maxBuffer: 10 * 1024 * 1024,
+          // 10MB buffer
+          cwd: tempDir
+        });
+        const output = stdout || stderr || "";
+        if (output.toLowerCase().includes("error") && !output.includes("successfully")) {
+          throw new Error(`Failed to download template: ${output}`);
+        }
+        return await addBackgroundContext({
+          content: [
+            {
+              type: "text",
+              text: `\u2705 React template downloaded successfully
+
+\u{1F4C1} Template Location: ${templatePath}
+
+\u26A0\uFE0F  IMPORTANT: The template is in a temporary directory and NOT in your current working directory.
+
+\u{1F534} CRITICAL NEXT STEP REQUIRED:
+You MUST copy ALL files (INCLUDING HIDDEN FILES like .env, .gitignore, etc.) from the temporary directory to your current project directory.
+
+Copy all files from: ${templatePath}
+To: Your current project directory
+`
+            }
+          ]
+        });
+      } catch (error) {
+        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Error downloading template: ${errMsg}`
+            }
+          ],
+          isError: true
+        };
+      }
+    })
+  );
   server.tool(
     "bulk-upsert",
     "Bulk insert or update data from CSV or JSON file. Supports upsert operations with a unique key.",
@@ -1066,7 +1189,7 @@ ${JSON.stringify(metadata, null, 2)}`
         });
         const result = await handleApiResponse(response);
         const message = result.success ? `Successfully processed ${result.rowsAffected} of ${result.totalRecords} records into table "${result.table}"` : result.message || "Bulk upsert operation completed";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1079,7 +1202,7 @@ ${JSON.stringify(metadata, null, 2)}`
               })
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1113,14 +1236,14 @@ ${JSON.stringify(metadata, null, 2)}`
           body: JSON.stringify({ bucketName, isPublic })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Bucket created", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1148,14 +1271,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Buckets retrieved", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1187,14 +1310,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage("Bucket deleted", result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1243,7 +1366,7 @@ ${JSON.stringify(metadata, null, 2)}`
           })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1253,7 +1376,7 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1283,14 +1406,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Edge function '${args.slug}' details`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1346,7 +1469,7 @@ ${JSON.stringify(metadata, null, 2)}`
         });
         const result = await handleApiResponse(response);
         const fileInfo = args.codeFile ? ` from ${args.codeFile}` : "";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1356,7 +1479,7 @@ ${JSON.stringify(metadata, null, 2)}`
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1386,14 +1509,14 @@ ${JSON.stringify(metadata, null, 2)}`
           }
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Edge function '${args.slug}' deleted successfully`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1436,14 +1559,14 @@ ${JSON.stringify(metadata, null, 2)}`
           });
         }
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: formatSuccessMessage(`Latest logs from ${source}`, result)
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1458,114 +1581,10 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
-  server.tool(
-    "upsert-schedule",
-    "Create or update a cron job schedule. If id is provided, updates existing schedule; otherwise creates a new one.",
-    {
-      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
-      id: z14.string().uuid().optional().describe("The UUID of the schedule to update. If omitted, a new schedule will be created."),
-      name: z14.string().min(3).describe("Schedule name (at least 3 characters)"),
-      cronSchedule: z14.string().describe('Cron schedule format (5 or 6 parts, e.g., "0 */2 * * *" for every 2 hours)'),
-      functionUrl: z14.string().url().describe("The URL to call when the schedule triggers"),
-      httpMethod: z14.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]).optional().default("POST").describe("HTTP method to use"),
-      headers: z14.record(z14.string()).optional().describe('HTTP headers. Values starting with "secret:" will be resolved from secrets store.'),
-      body: z14.record(z14.unknown()).optional().describe("JSON body to send with the request")
-    },
-    withUsageTracking("upsert-schedule", async ({ apiKey, id, name, cronSchedule, functionUrl, httpMethod, headers, body }) => {
-      try {
-        await checkToolVersion("upsert-schedule");
-        const actualApiKey = getApiKey(apiKey);
-        const requestBody = {
-          name,
-          cronSchedule,
-          functionUrl,
-          httpMethod: httpMethod || "POST"
-        };
-        if (id) {
-          requestBody.id = id;
-        }
-        if (headers) {
-          requestBody.headers = headers;
-        }
-        if (body) {
-          requestBody.body = body;
-        }
-        const response = await fetch2(`${API_BASE_URL}/api/schedules`, {
-          method: "POST",
-          headers: {
-            "x-api-key": actualApiKey,
-            "Content-Type": "application/json"
-          },
-          body: JSON.stringify(requestBody)
-        });
-        const result = await handleApiResponse(response);
-        const action = id ? "updated" : "created";
-        return await addBackgroundContext({
-          content: [
-            {
-              type: "text",
-              text: formatSuccessMessage(`Schedule '${name}' ${action} successfully`, result)
-            }
-          ]
-        });
-      } catch (error) {
-        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return await addBackgroundContext({
-          content: [
-            {
-              type: "text",
-              text: `Error upserting schedule: ${errMsg}`
-            }
-          ],
-          isError: true
-        });
-      }
-    })
-  );
-  server.tool(
-    "delete-schedule",
-    "Delete a cron job schedule permanently",
-    {
-      apiKey: z14.string().optional().describe("API key for authentication (optional if provided via --api_key)"),
-      scheduleId: z14.string().uuid().describe("The UUID of the schedule to delete")
-    },
-    withUsageTracking("delete-schedule", async ({ apiKey, scheduleId }) => {
-      try {
-        await checkToolVersion("delete-schedule");
-        const actualApiKey = getApiKey(apiKey);
-        const response = await fetch2(`${API_BASE_URL}/api/schedules/${scheduleId}`, {
-          method: "DELETE",
-          headers: {
-            "x-api-key": actualApiKey
-          }
-        });
-        const result = await handleApiResponse(response);
-        return await addBackgroundContext({
-          content: [
-            {
-              type: "text",
-              text: formatSuccessMessage(`Schedule ${scheduleId} deleted successfully`, result)
-            }
-          ]
-        });
-      } catch (error) {
-        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return await addBackgroundContext({
-          content: [
-            {
-              type: "text",
-              text: `Error deleting schedule: ${errMsg}`
-            }
-          ],
-          isError: true
-        });
-      }
-    })
-  );
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 16
+    toolCount: 15
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-HEUOFCZP.js";
+} from "./chunk-MRGODXOM.js";
 
 // src/http/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

package/dist/index.js

@@ -1,23 +1,24 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-HEUOFCZP.js";
+} from "./chunk-MRGODXOM.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { program } from "commander";
 program.option("--api_key <value>", "API Key");
+program.option("--api_base_url <value>", "API Base URL");
 program.parse(process.argv);
 var options = program.opts();
-var { api_key } = options;
+var { api_key, api_base_url } = options;
 var server = new McpServer({
   name: "insforge-mcp",
   version: "1.0.0"
 });
 var toolsConfig = registerInsforgeTools(server, {
   apiKey: api_key,
-  apiBaseUrl: process.env.API_BASE_URL
+  apiBaseUrl: api_base_url || process.env.API_BASE_URL
 });
 async function main() {
   const transport = new StdioServerTransport();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/mcp",
-  "version": "1.1.7-dev.9",
+  "version": "1.2.1",
   "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
   "mcpName": "io.github.InsForge/insforge-mcp",
   "type": "module",