@insforge/mcp 1.1.7-dev.27 → 1.1.7-dev.29

package/dist/{chunk-MIGS7PIQ.js → chunk-QVPU2PDE.js}

@@ -838,6 +838,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;
@@ -851,6 +854,36 @@ 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.7.0") < 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.',
@@ -862,29 +895,24 @@ function registerInsforgeTools(server, config = {}) {
     withUsageTracking("fetch-docs", async ({ docType }) => {
       try {
         const content = await fetchDocumentation(docType);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
               text: content
             }
           ]
-        };
+        });
       } catch (error) {
-        if (error instanceof Error && error.message.includes("404")) {
-          try {
-            const instructionsContent = await fetchDocumentation("instructions");
-            return {
-              content: [{ type: "text", text: instructionsContent }]
-            };
-          } catch (fallbackError) {
-            const fallbackErrMsg = fallbackError instanceof Error ? fallbackError.message : "Unknown error occurred";
-            return {
-              content: [{ type: "text", text: `Error fetching documentation: ${fallbackErrMsg}` }]
-            };
-          }
-        }
         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}` }]
         };
@@ -908,14 +936,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 {
@@ -947,14 +975,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 {
@@ -985,7 +1013,7 @@ function registerInsforgeTools(server, config = {}) {
           }
         });
         const metadata = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -994,7 +1022,7 @@ function registerInsforgeTools(server, config = {}) {
 ${JSON.stringify(metadata, null, 2)}`
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1032,14 +1060,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 {
@@ -1085,9 +1113,9 @@ ${JSON.stringify(metadata, null, 2)}`
             console.error(`[download-template] Removing existing template at ${templatePath}`);
             await fs.rm(templatePath, { recursive: true, force: true });
           }
-        } catch (error) {
+        } catch {
         }
-        const command = `npx create-insforge-app ${targetDir} --frame ${frame} --base-url ${API_BASE_URL} --anon-key ${anonKey}`;
+        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
@@ -1097,7 +1125,7 @@ ${JSON.stringify(metadata, null, 2)}`
         if (output.toLowerCase().includes("error") && !output.includes("successfully")) {
           throw new Error(`Failed to download template: ${output}`);
         }
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1115,7 +1143,7 @@ To: Your current project directory
 `
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1159,7 +1187,7 @@ To: Your current project directory
         });
         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",
@@ -1172,7 +1200,7 @@ To: Your current project directory
               })
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1206,14 +1234,14 @@ To: Your current project directory
           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 {
@@ -1241,14 +1269,14 @@ To: Your current project directory
           }
         });
         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 {
@@ -1280,14 +1308,14 @@ To: Your current project directory
           }
         });
         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 {
@@ -1336,7 +1364,7 @@ To: Your current project directory
           })
         });
         const result = await handleApiResponse(response);
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1346,7 +1374,7 @@ To: Your current project directory
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1376,14 +1404,14 @@ To: Your current project directory
           }
         });
         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 {
@@ -1439,7 +1467,7 @@ To: Your current project directory
         });
         const result = await handleApiResponse(response);
         const fileInfo = args.codeFile ? ` from ${args.codeFile}` : "";
-        return {
+        return await addBackgroundContext({
           content: [
             {
               type: "text",
@@ -1449,7 +1477,7 @@ To: Your current project directory
               )
             }
           ]
-        };
+        });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -1479,14 +1507,14 @@ To: Your current project directory
           }
         });
         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 {
@@ -1529,125 +1557,21 @@ To: Your current project directory
           });
         }
         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 {
-          content: [
-            {
-              type: "text",
-              text: `Error retrieving container logs: ${errMsg}`
-            }
-          ],
-          isError: true
-        };
-      }
-    })
-  );
-  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 {
-          content: [
-            {
-              type: "text",
-              text: formatSuccessMessage(`Schedule '${name}' ${action} successfully`, result)
-            }
-          ]
-        };
-      } catch (error) {
-        const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-        return {
-          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 {
-          content: [
-            {
-              type: "text",
-              text: formatSuccessMessage(`Schedule ${scheduleId} deleted successfully`, result)
-            }
-          ]
-        };
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
         return {
           content: [
             {
               type: "text",
-              text: `Error deleting schedule: ${errMsg}`
+              text: `Error retrieving container logs: ${errMsg}`
             }
           ],
           isError: true

package/dist/http-server.js

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

package/dist/index.js

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

package/package.json

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