@insforge/mcp 1.2.4-deployment.0 → 1.2.4-deployment.10

package/dist/{chunk-ELPXCUYK.js → chunk-BLV3H4GZ.js}

@@ -7,6 +7,7 @@ import { promises as fs } from "fs";
 import { exec } from "child_process";
 import { promisify } from "util";
 import { tmpdir } from "os";
+import archiver from "archiver";
 
 // src/shared/response-handler.ts
 async function handleApiResponse(response) {
@@ -744,9 +745,7 @@ var realtimePermissionsResponseSchema = z8.object({
 });
 
 // node_modules/@insforge/shared-schemas/dist/metadata.schema.js
-var authMetadataSchema = z9.object({
-  oauths: z9.array(oAuthConfigSchema)
-});
+var authMetadataSchema = getPublicAuthConfigResponseSchema;
 var databaseMetadataSchema = z9.object({
   tables: z9.array(z9.object({
     tableName: z9.string(),
@@ -1079,23 +1078,27 @@ var cloudEventSchema = z16.discriminatedUnion("type", [
 import { z as z17 } from "zod";
 var docTypeSchema = z17.enum([
   "instructions",
+  "auth-sdk",
   "db-sdk",
   "storage-sdk",
   "functions-sdk",
   "ai-integration-sdk",
   "auth-components-react",
   "auth-components-nextjs",
-  "real-time"
+  "real-time",
+  "deployment"
 ]).describe(`
-    Documentation type: 
+    Documentation type:
       "instructions" (essential backend setup - use FIRST),
       "db-sdk" (database operations),
       "storage-sdk" (file storage),
       "functions-sdk" (edge functions),
+      "auth-sdk" (direct SDK methods for custom auth flows),
       "auth-components-react" (authentication components for React+Vite applications),
       "auth-components-nextjs" (authentication components for Next.js applications),
       "ai-integration-sdk" (AI features),
-      "real-time" (real-time pub/sub through WebSockets)
+      "real-time" (real-time pub/sub through WebSockets),
+      "deployment" (deploy frontend applications via MCP tool)
     `);
 
 // node_modules/@insforge/shared-schemas/dist/email-api.schema.js
@@ -1117,11 +1120,28 @@ var sendEmailResponseSchema = z18.object({});
 
 // node_modules/@insforge/shared-schemas/dist/deployments.schema.js
 import { z as z19 } from "zod";
+var deploymentStatusSchema = z19.enum([
+  "WAITING",
+  // Record created, waiting for client to upload zip to S3
+  "UPLOADING",
+  // Server is downloading from S3 and uploading to Vercel
+  "QUEUED",
+  // Vercel: deployment queued
+  "BUILDING",
+  // Vercel: deployment building
+  "READY",
+  // Vercel: deployment ready
+  "ERROR",
+  // Vercel: deployment failed
+  "CANCELED"
+  // Vercel: deployment canceled
+]);
 var deploymentSchema = z19.object({
   id: z19.string().uuid(),
-  deploymentId: z19.string(),
+  providerDeploymentId: z19.string().nullable(),
+  // Provider's deployment ID, null until deployment starts
   provider: z19.string(),
-  status: z19.string(),
+  status: deploymentStatusSchema,
   url: z19.string().nullable(),
   metadata: z19.record(z19.unknown()).nullable(),
   createdAt: z19.string(),
@@ -1137,20 +1157,20 @@ var projectSettingsSchema = z20.object({
   devCommand: z20.string().nullable().optional(),
   rootDirectory: z20.string().nullable().optional()
 });
-var deploymentFileSchema = z20.object({
-  file: z20.string(),
-  data: z20.string()
-});
 var envVarSchema = z20.object({
   key: z20.string(),
   value: z20.string()
 });
-var createDeploymentRequestSchema = z20.object({
-  name: z20.string().optional(),
-  files: z20.array(deploymentFileSchema).optional(),
+var createDeploymentResponseSchema = z20.object({
+  id: z20.string().uuid(),
+  uploadUrl: z20.string().url(),
+  uploadFields: z20.record(z20.string())
+  // Required for S3 presigned POST (policy, signature, key, etc.)
+});
+var startDeploymentRequestSchema = z20.object({
   projectSettings: projectSettingsSchema.optional(),
-  meta: z20.record(z20.string()).optional(),
-  envVars: z20.array(envVarSchema).optional()
+  envVars: z20.array(envVarSchema).optional(),
+  meta: z20.record(z20.string()).optional()
 });
 var listDeploymentsResponseSchema = z20.object({
   deployments: z20.array(deploymentSchema)
@@ -1160,75 +1180,74 @@ var listDeploymentsResponseSchema = z20.object({
 import FormData from "form-data";
 var execAsync = promisify(exec);
 var TOOL_VERSION_REQUIREMENTS = {
-  "upsert-schedule": "1.1.1",
-  // 'get-schedules': '1.1.1',
-  // 'get-schedule-logs': '1.1.1',
-  "delete-schedule": "1.1.1"
+  // Schedule tools - require backend v1.1.1+
+  "upsert-schedule": { minVersion: "1.1.1" },
+  "delete-schedule": { minVersion: "1.1.1" },
+  // 'get-schedules': { minVersion: '1.1.1' },
+  // 'get-schedule-logs': { minVersion: '1.1.1' },
+  "create-deployment": { minVersion: "1.4.7" }
+  // Example of a deprecated tool (uncomment when needed):
+  // 'legacy-tool': { minVersion: '1.0.0', maxVersion: '1.5.0' },
 };
-function registerInsforgeTools(server, config = {}) {
-  const GLOBAL_API_KEY = config.apiKey || process.env.API_KEY || "";
-  const API_BASE_URL = config.apiBaseUrl || process.env.API_BASE_URL || "http://localhost:7130";
-  const usageTracker = new UsageTracker(API_BASE_URL, GLOBAL_API_KEY);
-  let versionCache = null;
-  const VERSION_CACHE_TTL = 5 * 60 * 1e3;
-  async function getBackendVersion() {
-    const now = Date.now();
-    if (versionCache && now - versionCache.timestamp < VERSION_CACHE_TTL) {
-      return versionCache.version;
-    }
-    try {
-      const response = await fetch2(`${API_BASE_URL}/api/health`, {
-        method: "GET",
-        headers: {
-          "Content-Type": "application/json"
-        }
-      });
-      if (!response.ok) {
-        throw new Error(`Health check failed with status ${response.status}`);
-      }
-      const health = await response.json();
-      versionCache = {
-        version: health.version,
-        timestamp: now
-      };
-      return health.version;
-    } catch (error) {
-      const errMsg = error instanceof Error ? error.message : "Unknown error";
-      throw new Error(`Failed to fetch backend version: ${errMsg}`);
-    }
+function compareVersions(v1, v2) {
+  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;
+    if (part1 > part2) return 1;
+    if (part1 < part2) return -1;
   }
-  function compareVersions(v1, v2) {
-    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;
-      if (part1 > part2) return 1;
-      if (part1 < part2) return -1;
-    }
-    return 0;
+  return 0;
+}
+function shouldRegisterTool(toolName, backendVersion) {
+  const requirement = TOOL_VERSION_REQUIREMENTS[toolName];
+  if (!requirement) {
+    return true;
   }
-  async function checkToolVersion(toolName) {
-    const requiredVersion = TOOL_VERSION_REQUIREMENTS[toolName];
-    if (!requiredVersion) {
-      return;
-    }
-    try {
-      const currentVersion = await getBackendVersion();
-      if (compareVersions(currentVersion, requiredVersion) < 0) {
-        throw new Error(
-          `Tool '${toolName}' requires backend version ${requiredVersion} or higher, but current version is ${currentVersion}. Please upgrade your Insforge backend server.`
-        );
-      }
-    } catch (error) {
-      if (error instanceof Error && error.message.includes("requires backend version")) {
-        throw error;
-      }
-      console.warn(`Warning: Could not verify backend version for tool '${toolName}': ${error instanceof Error ? error.message : "Unknown error"}`);
+  const { minVersion, maxVersion } = requirement;
+  if (minVersion && compareVersions(backendVersion, minVersion) < 0) {
+    return false;
+  }
+  if (maxVersion && compareVersions(backendVersion, maxVersion) > 0) {
+    return false;
+  }
+  return true;
+}
+async function fetchBackendVersion(apiBaseUrl) {
+  const response = await fetch2(`${apiBaseUrl}/api/health`, {
+    method: "GET",
+    headers: {
+      "Content-Type": "application/json"
     }
+  });
+  if (!response.ok) {
+    throw new Error(`Health check failed with status ${response.status}`);
   }
+  const health = await response.json();
+  return health.version;
+}
+async function registerInsforgeTools(server, config = {}) {
+  const GLOBAL_API_KEY = config.apiKey || process.env.API_KEY || "";
+  const API_BASE_URL = config.apiBaseUrl || process.env.API_BASE_URL || "http://localhost:7130";
+  const usageTracker = new UsageTracker(API_BASE_URL, GLOBAL_API_KEY);
+  const backendVersion = await fetchBackendVersion(API_BASE_URL);
+  console.error(`Backend version: ${backendVersion}`);
+  let toolCount = 0;
+  const registerTool = (toolName, ...args) => {
+    if (shouldRegisterTool(toolName, backendVersion)) {
+      server.tool(toolName, ...args);
+      toolCount++;
+      return true;
+    } else {
+      const req = TOOL_VERSION_REQUIREMENTS[toolName];
+      const reason = req?.minVersion && compareVersions(backendVersion, req.minVersion) < 0 ? `requires backend >= ${req.minVersion}` : `deprecated after backend ${req?.maxVersion}`;
+      console.error(`Skipping tool '${toolName}': ${reason} (current: ${backendVersion})`);
+      return false;
+    }
+  };
   async function trackToolUsage(toolName, success = true) {
     if (GLOBAL_API_KEY) {
       await usageTracker.trackUsage(toolName, success);
@@ -1285,28 +1304,23 @@ function registerInsforgeTools(server, config = {}) {
     }
   };
   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: `
+    const isLegacyVersion = compareVersions(backendVersion, "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(
+  registerTool(
     "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.',
     {
@@ -1339,7 +1353,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-anon-key",
     "Generate an anonymous JWT token that never expires. Requires admin API key. Use this for client-side applications that need public access.",
     {
@@ -1378,7 +1392,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-table-schema",
     "Returns the detailed schema(including RLS, indexes, constraints, etc.) of a specific table",
     {
@@ -1417,7 +1431,7 @@ ${context}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-backend-metadata",
     "Index all backend metadata",
     {
@@ -1457,7 +1471,7 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "run-raw-sql",
     "Execute raw SQL query with optional parameters. Admin access required. Use with caution as it can modify data directly.",
     {
@@ -1502,7 +1516,7 @@ ${JSON.stringify(metadata, null, 2)}`
       }
     })
   );
-  server.tool(
+  registerTool(
     "download-template",
     "CRITICAL: MANDATORY FIRST STEP for all new InsForge projects. Download pre-configured starter template to a temporary directory. After download, you MUST copy files to current directory using the provided command.",
     {
@@ -1578,7 +1592,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "bulk-upsert",
     "Bulk insert or update data from CSV or JSON file. Supports upsert operations with a unique key.",
     {
@@ -1635,7 +1649,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-bucket",
     "Create new storage bucket",
     {
@@ -1676,7 +1690,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "list-buckets",
     "Lists all storage buckets",
     {},
@@ -1711,7 +1725,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "delete-bucket",
     "Deletes a storage bucket",
     {
@@ -1750,7 +1764,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-function",
     "Create a new edge function that runs in Deno runtime. The code must be written to a file first for version control",
     {
@@ -1809,7 +1823,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-function",
     "Get details of a specific edge function including its code",
     {
@@ -1846,7 +1860,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "update-function",
     "Update an existing edge function code or metadata",
     {
@@ -1912,7 +1926,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "delete-function",
     "Delete an edge function permanently",
     {
@@ -1949,7 +1963,7 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "get-container-logs",
     "Get latest logs from a specific container/service. Use this to help debug problems with your app.",
     {
@@ -1999,34 +2013,101 @@ To: Your current project directory
       }
     })
   );
-  server.tool(
+  registerTool(
     "create-deployment",
-    "Create a new deployment with files, project settings, and environment variables",
+    "Deploy source code from a directory. This tool zips files, uploads to cloud storage, and triggers deployment with optional environment variables and project settings.",
     {
-      ...createDeploymentRequestSchema.shape
+      sourceDirectory: z21.string().describe('Absolute path to the source directory containing files to deploy (e.g., /Users/name/project or C:\\Users\\name\\project). Do not use relative paths like "."'),
+      ...startDeploymentRequestSchema.shape
     },
-    withUsageTracking("create-deployment", async ({ name, files, projectSettings, meta, envVars }) => {
+    withUsageTracking("create-deployment", async ({ sourceDirectory, projectSettings, envVars, meta }) => {
       try {
-        const requestBody = {};
-        if (name) requestBody.name = name;
-        if (files) requestBody.files = files;
-        if (projectSettings) requestBody.projectSettings = projectSettings;
-        if (meta) requestBody.meta = meta;
-        if (envVars) requestBody.envVars = envVars;
-        const response = await fetch2(`${API_BASE_URL}/api/deployments`, {
+        const isAbsolutePath = sourceDirectory.startsWith("/") || /^[a-zA-Z]:[/\\]/.test(sourceDirectory);
+        if (!isAbsolutePath) {
+          return {
+            content: [
+              {
+                type: "text",
+                text: `Error: sourceDirectory must be an absolute path, not a relative path like "${sourceDirectory}". Please provide the full path to the source directory (e.g., /Users/name/project on macOS/Linux or C:\\Users\\name\\project on Windows).`
+              }
+            ],
+            isError: true
+          };
+        }
+        const resolvedSourceDir = sourceDirectory;
+        const createResponse = await fetch2(`${API_BASE_URL}/api/deployments`, {
+          method: "POST",
+          headers: {
+            "x-api-key": getApiKey(),
+            "Content-Type": "application/json"
+          }
+        });
+        const createResult = await handleApiResponse(createResponse);
+        const { id: deploymentId, uploadUrl, uploadFields } = createResult;
+        const zipBuffer = await new Promise((resolve, reject) => {
+          const archive = archiver("zip", { zlib: { level: 9 } });
+          const chunks = [];
+          archive.on("data", (chunk) => chunks.push(chunk));
+          archive.on("end", () => resolve(Buffer.concat(chunks)));
+          archive.on("error", (err) => reject(err));
+          const excludePatterns = [
+            "node_modules",
+            ".git",
+            ".next",
+            "dist",
+            "build",
+            ".env.local",
+            ".DS_Store"
+          ];
+          archive.directory(resolvedSourceDir, false, (entry) => {
+            const normalizedName = entry.name.replace(/\\/g, "/");
+            for (const pattern of excludePatterns) {
+              if (normalizedName.startsWith(pattern + "/") || normalizedName === pattern || normalizedName.endsWith("/" + pattern) || normalizedName.includes("/" + pattern + "/")) {
+                return false;
+              }
+            }
+            if (normalizedName.endsWith(".log")) {
+              return false;
+            }
+            return entry;
+          });
+          archive.finalize();
+        });
+        const uploadFormData = new FormData();
+        for (const [key, value] of Object.entries(uploadFields)) {
+          uploadFormData.append(key, value);
+        }
+        uploadFormData.append("file", zipBuffer, {
+          filename: "deployment.zip",
+          contentType: "application/zip"
+        });
+        const uploadResponse = await fetch2(uploadUrl, {
+          method: "POST",
+          body: uploadFormData,
+          headers: uploadFormData.getHeaders()
+        });
+        if (!uploadResponse.ok) {
+          const uploadError = await uploadResponse.text();
+          throw new Error(`Failed to upload zip file: ${uploadError}`);
+        }
+        const startBody = {};
+        if (projectSettings) startBody.projectSettings = projectSettings;
+        if (envVars) startBody.envVars = envVars;
+        if (meta) startBody.meta = meta;
+        const startResponse = await fetch2(`${API_BASE_URL}/api/deployments/${deploymentId}/start`, {
           method: "POST",
           headers: {
             "x-api-key": getApiKey(),
             "Content-Type": "application/json"
           },
-          body: JSON.stringify(requestBody)
+          body: JSON.stringify(startBody)
         });
-        const result = await handleApiResponse(response);
+        const startResult = await handleApiResponse(startResponse);
         return await addBackgroundContext({
           content: [
             {
               type: "text",
-              text: formatSuccessMessage("Deployment created", result) + "\n\nNote: You can check deployment status by querying the system.deployments table."
+              text: formatSuccessMessage("Deployment started", startResult) + "\n\nNote: You can check deployment status by querying the system.deployments table."
             }
           ]
         });
@@ -2047,7 +2128,8 @@ To: Your current project directory
   return {
     apiKey: GLOBAL_API_KEY,
     apiBaseUrl: API_BASE_URL,
-    toolCount: 16
+    toolCount,
+    backendVersion
   };
 }
 

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-ELPXCUYK.js";
+} from "./chunk-BLV3H4GZ.js";
 
 // src/http/server.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -91,7 +91,7 @@ app.post("/mcp", async (req, res) => {
       name: "insforge-mcp",
       version: "1.0.0"
     });
-    registerInsforgeTools(mcpServer, {
+    await registerInsforgeTools(mcpServer, {
       apiKey,
       apiBaseUrl
     });

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-ELPXCUYK.js";
+} from "./chunk-BLV3H4GZ.js";
 
 // src/stdio/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
@@ -12,15 +12,15 @@ program.option("--api_base_url <value>", "API Base URL");
 program.parse(process.argv);
 var options = program.opts();
 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: api_base_url || process.env.API_BASE_URL
-});
 async function main() {
+  const server = new McpServer({
+    name: "insforge-mcp",
+    version: "1.0.0"
+  });
+  const toolsConfig = await registerInsforgeTools(server, {
+    apiKey: api_key,
+    apiBaseUrl: api_base_url || process.env.API_BASE_URL
+  });
   const transport = new StdioServerTransport();
   await server.connect(transport);
   console.error("Insforge MCP server started");
@@ -30,6 +30,9 @@ async function main() {
     console.error("API Key: Not configured (will require api_key in tool calls)");
   }
   console.error(`API Base URL: ${toolsConfig.apiBaseUrl}`);
+  if (toolsConfig.backendVersion) {
+    console.error(`Backend Version: ${toolsConfig.backendVersion}`);
+  }
   console.error(`Tools registered: ${toolsConfig.toolCount}`);
 }
 main().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/mcp",
-  "version": "1.2.4-deployment.0",
+  "version": "1.2.4-deployment.10",
   "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
   "mcpName": "io.github.InsForge/insforge-mcp",
   "type": "module",
@@ -36,9 +36,10 @@
     "server.json"
   ],
   "dependencies": {
-    "@insforge/shared-schemas": "1.1.36-deployment.1",
+    "@insforge/shared-schemas": "1.1.37-deployment.1",
     "@modelcontextprotocol/sdk": "^1.15.1",
     "@types/express": "^5.0.3",
+    "archiver": "^7.0.1",
     "commander": "^14.0.0",
     "express": "^5.1.0",
     "form-data": "^4.0.4",
@@ -46,6 +47,7 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
+    "@types/archiver": "^7.0.0",
     "@types/node": "^20.10.5",
     "rimraf": "^5.0.5",
     "tsup": "^8.5.0",