@insforge/mcp 1.2.10-dev.0 → 1.2.10-dev.2

package/dist/{chunk-3HMBKVW5.js → chunk-HCVPTSOB.js}

@@ -1670,11 +1670,7 @@ var createDeploymentResponseSchema = z22.object({
   uploadUrl: z22.string().url(),
   uploadFields: z22.record(z22.string())
 });
-var createDirectDeploymentResponseSchema = z22.object({
-  id: z22.string().uuid(),
-  status: deploymentSchema.shape.status
-});
-var createDeploymentManifestRequestSchema = z22.object({
+var createDirectDeploymentRequestSchema = z22.object({
   files: z22.array(deploymentManifestFileEntrySchema).min(1)
 }).superRefine(({ files }, ctx) => {
   const firstSeenByPath = /* @__PURE__ */ new Map();
@@ -1691,7 +1687,9 @@ var createDeploymentManifestRequestSchema = z22.object({
     firstSeenByPath.set(file.path, index);
   });
 });
-var createDeploymentManifestResponseSchema = z22.object({
+var createDirectDeploymentResponseSchema = z22.object({
+  id: z22.string().uuid(),
+  status: deploymentSchema.shape.status,
   files: z22.array(deploymentManifestFileSchema)
 });
 var uploadDeploymentFileResponseSchema = deploymentManifestFileSchema.extend({
@@ -2647,7 +2645,16 @@ import { join as join2, relative, sep } from "path";
 import archiver from "archiver";
 import FormData2 from "form-data";
 var DIRECT_DEPLOYMENT_MIN_VERSION = "2.0.5";
-var EXCLUDED_DEPLOYMENT_SEGMENTS = /* @__PURE__ */ new Set(["node_modules", ".git", ".next", "dist", "build", ".insforge"]);
+var DEFAULT_DIRECT_UPLOAD_CONCURRENCY = 8;
+var MAX_DIRECT_UPLOAD_CONCURRENCY = 32;
+var EXCLUDED_DEPLOYMENT_SEGMENTS = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".git",
+  ".next",
+  "dist",
+  "build",
+  ".insforge"
+]);
 var DirectDeploymentUnsupportedError = class extends Error {
   constructor() {
     super("Direct deployment endpoints are not available on this backend");
@@ -2702,12 +2709,22 @@ function parseCreateDirectDeploymentResponse(obj) {
   }
   return result.data;
 }
-function parseCreateDeploymentManifestResponse(obj) {
-  const result = createDeploymentManifestResponseSchema.safeParse(obj);
-  if (!result.success) {
-    throw new Error("Unexpected response format from deployment manifest endpoint");
+function getDirectUploadConcurrency() {
+  const parsed = Number.parseInt(process.env.INSFORGE_DEPLOY_UPLOAD_CONCURRENCY ?? "", 10);
+  const requested = Number.isSafeInteger(parsed) && parsed > 0 ? parsed : DEFAULT_DIRECT_UPLOAD_CONCURRENCY;
+  return Math.min(requested, MAX_DIRECT_UPLOAD_CONCURRENCY);
+}
+async function runWithConcurrency(items, concurrency, worker) {
+  let nextIndex = 0;
+  async function runWorker() {
+    while (nextIndex < items.length) {
+      const index = nextIndex;
+      nextIndex++;
+      await worker(items[index], index);
+    }
   }
-  return result.data;
+  const workerCount = Math.min(concurrency, items.length);
+  await Promise.all(Array.from({ length: workerCount }, () => runWorker()));
 }
 async function collectDeploymentFiles(sourceDirectory) {
   const files = [];
@@ -2746,22 +2763,8 @@ function buildStartBody(input) {
   if (input.meta) startBody.meta = input.meta;
   return startBody;
 }
-async function createDirectDeploymentSession(API_BASE_URL, apiKey) {
+async function createDirectDeploymentSession(API_BASE_URL, apiKey, files) {
   const response = await fetch6(`${API_BASE_URL}/api/deployments/direct`, {
-    method: "POST",
-    headers: {
-      "x-api-key": apiKey,
-      "Content-Type": "application/json"
-    }
-  });
-  if (response.status === 404) {
-    throw new DirectDeploymentUnsupportedError();
-  }
-  const result = await handleApiResponse(response);
-  return parseCreateDirectDeploymentResponse(result);
-}
-async function createDeploymentManifest(API_BASE_URL, apiKey, deploymentId, files) {
-  const response = await fetch6(`${API_BASE_URL}/api/deployments/${encodeURIComponent(deploymentId)}/manifest`, {
     method: "POST",
     headers: {
       "x-api-key": apiKey,
@@ -2773,7 +2776,7 @@ async function createDeploymentManifest(API_BASE_URL, apiKey, deploymentId, file
     throw new DirectDeploymentUnsupportedError();
   }
   const result = await handleApiResponse(response);
-  return parseCreateDeploymentManifestResponse(result);
+  return parseCreateDirectDeploymentResponse(result);
 }
 async function uploadDeploymentFileContent(API_BASE_URL, apiKey, deploymentId, file, localFile) {
   const response = await fetch6(
@@ -2794,14 +2797,17 @@ async function uploadDeploymentFileContent(API_BASE_URL, apiKey, deploymentId, f
   await handleApiResponse(response);
 }
 async function startDeployment(API_BASE_URL, apiKey, deploymentId, startBody) {
-  const response = await fetch6(`${API_BASE_URL}/api/deployments/${encodeURIComponent(deploymentId)}/start`, {
-    method: "POST",
-    headers: {
-      "x-api-key": apiKey,
-      "Content-Type": "application/json"
-    },
-    body: JSON.stringify(startBody)
-  });
+  const response = await fetch6(
+    `${API_BASE_URL}/api/deployments/${encodeURIComponent(deploymentId)}/start`,
+    {
+      method: "POST",
+      headers: {
+        "x-api-key": apiKey,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify(startBody)
+    }
+  );
   return handleApiResponse(response);
 }
 async function deployDirect(API_BASE_URL, apiKey, sourceDirectory, startBody) {
@@ -2809,32 +2815,30 @@ async function deployDirect(API_BASE_URL, apiKey, sourceDirectory, startBody) {
   if (files.length === 0) {
     throw new Error("No deployable files found in source directory after applying exclusions.");
   }
-  const createResult = await createDirectDeploymentSession(API_BASE_URL, apiKey);
+  const manifestFiles = files.map(({ path, sha, size }) => ({ path, sha, size }));
+  const createResult = await createDirectDeploymentSession(API_BASE_URL, apiKey, manifestFiles);
   const deploymentId = String(createResult.id);
-  const manifest = await createDeploymentManifest(
-    API_BASE_URL,
-    apiKey,
-    deploymentId,
-    files.map(({ path, sha, size }) => ({ path, sha, size }))
-  );
-  const localFilesByPath = new Map(files.map((file) => [file.path, file]));
-  for (const manifestFile of manifest.files) {
-    const localFile = localFilesByPath.get(manifestFile.path);
+  const localFileByPath = new Map(files.map((file) => [file.path, file]));
+  const uploadConcurrency = getDirectUploadConcurrency();
+  await runWithConcurrency(createResult.files, uploadConcurrency, async (file) => {
+    const localFile = localFileByPath.get(file.path);
     if (!localFile) {
-      throw new Error(`Manifest response included unknown file path: ${manifestFile.path}`);
+      throw new Error(`Direct deployment response included unknown file path: ${file.path}`);
     }
-    await uploadDeploymentFileContent(API_BASE_URL, apiKey, deploymentId, manifestFile, localFile);
-  }
+    if (localFile.sha !== file.sha || localFile.size !== file.size) {
+      throw new Error(`Direct deployment response did not match local file metadata: ${file.path}`);
+    }
+    await uploadDeploymentFileContent(API_BASE_URL, apiKey, deploymentId, file, localFile);
+  });
   const startResult = await startDeployment(API_BASE_URL, apiKey, deploymentId, startBody);
-  return { deploymentId, fileCount: files.length, startResult };
+  return { deploymentId, fileCount: files.length, uploadConcurrency, startResult };
 }
-function buildRemoteDirectUploadInstructions(API_BASE_URL, sourceDirectory, deploymentId) {
+function buildRemoteDirectUploadInstructions(API_BASE_URL, sourceDirectory) {
   const escapedDir = shellEsc(sourceDirectory);
   const apiBaseUrlJson = JSON.stringify(API_BASE_URL);
-  const deploymentIdJson = JSON.stringify(deploymentId);
-  return `Deployment prepared successfully using direct upload. Deployment ID: ${deploymentId}
+  return `Direct deployment upload is available for this backend.
 
-Please execute the following command locally from a shell that has INSFORGE_API_KEY set, then call the \`start-deployment\` tool with the deployment ID printed by the script.
+Please execute the following command locally from a shell that has INSFORGE_API_KEY set, then call the \`start-deployment\` tool with the deployment ID printed by the script. Set \`INSFORGE_DEPLOY_UPLOAD_CONCURRENCY\` if you want to tune parallel uploads; the default is 8 and the maximum is 32.
 
 \`\`\`bash
 cd ${escapedDir}
@@ -2846,7 +2850,8 @@ const path = await import('node:path');
 
 const API_BASE_URL = ${apiBaseUrlJson};
 const API_KEY = process.env.INSFORGE_API_KEY;
-const deploymentId = ${deploymentIdJson};
+const DEFAULT_UPLOAD_CONCURRENCY = 8;
+const MAX_UPLOAD_CONCURRENCY = 32;
 const EXCLUDED_SEGMENTS = new Set(['node_modules', '.git', '.next', 'dist', 'build', '.insforge']);
 
 function shouldExcludeDeploymentPath(normalizedName) {
@@ -2858,9 +2863,17 @@ function shouldExcludeDeploymentPath(normalizedName) {
 
 async function readJsonResponse(response) {
   const text = await response.text();
-  const data = text ? JSON.parse(text) : null;
+  let data = null;
+  if (text) {
+    try {
+      data = JSON.parse(text);
+    } catch {
+      data = text;
+    }
+  }
   if (!response.ok) {
-    throw new Error(data?.message || data?.error || \`Request failed with status \${response.status}\`);
+    const message = data && typeof data === 'object' ? data.message || data.error : null;
+    throw new Error(message || 'Request failed with status ' + response.status);
   }
   return data;
 }
@@ -2870,10 +2883,31 @@ async function api(pathname, init = {}) {
     'x-api-key': API_KEY,
     ...(init.headers || {}),
   };
-  const response = await fetch(\`\${API_BASE_URL}\${pathname}\`, { ...init, headers });
+  const response = await fetch(API_BASE_URL + pathname, { ...init, headers });
   return readJsonResponse(response);
 }
 
+function getUploadConcurrency() {
+  const parsed = Number.parseInt(process.env.INSFORGE_DEPLOY_UPLOAD_CONCURRENCY || '', 10);
+  const requested = Number.isSafeInteger(parsed) && parsed > 0 ? parsed : DEFAULT_UPLOAD_CONCURRENCY;
+  return Math.min(requested, MAX_UPLOAD_CONCURRENCY);
+}
+
+async function runWithConcurrency(items, concurrency, worker) {
+  let nextIndex = 0;
+
+  async function runWorker() {
+    while (nextIndex < items.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      await worker(items[index], index);
+    }
+  }
+
+  const workerCount = Math.min(concurrency, items.length);
+  await Promise.all(Array.from({ length: workerCount }, () => runWorker()));
+}
+
 async function hashFile(filePath) {
   const hash = createHash('sha1');
   let size = 0;
@@ -2911,25 +2945,14 @@ async function collectFiles(rootDirectory) {
   return files;
 }
 
-const rootDirectory = process.cwd();
-const localFiles = await collectFiles(rootDirectory);
-if (localFiles.length === 0) throw new Error('No deployable files found after applying exclusions.');
-
-const manifest = await api(\`/api/deployments/\${encodeURIComponent(deploymentId)}/manifest\`, {
-  method: 'POST',
-  headers: { 'Content-Type': 'application/json' },
-  body: JSON.stringify({
-    files: localFiles.map(({ path, sha, size }) => ({ path, sha, size })),
-  }),
-});
-
-const localFilesByPath = new Map(localFiles.map((file) => [file.path, file]));
-for (const remoteFile of manifest.files) {
-  const localFile = localFilesByPath.get(remoteFile.path);
-  if (!localFile) throw new Error(\`Manifest response included unknown path: \${remoteFile.path}\`);
-
-  const uploadResponse = await fetch(
-    \`\${API_BASE_URL}/api/deployments/\${encodeURIComponent(deploymentId)}/files/\${encodeURIComponent(remoteFile.fileId)}/content\`,
+async function uploadFile(deploymentId, manifestFile, localFile) {
+  const response = await fetch(
+    API_BASE_URL +
+      '/api/deployments/' +
+      encodeURIComponent(deploymentId) +
+      '/files/' +
+      encodeURIComponent(manifestFile.fileId) +
+      '/content',
     {
       method: 'PUT',
       headers: {
@@ -2941,18 +2964,59 @@ for (const remoteFile of manifest.files) {
       duplex: 'half',
     }
   );
-  await readJsonResponse(uploadResponse);
+
+  await readJsonResponse(response);
 }
 
-console.log(\`Deployment files uploaded. Deployment ID: \${deploymentId}\`);
-console.log(\`Uploaded \${localFiles.length} files through the direct deployment proxy.\`);
+const rootDirectory = process.cwd();
+const localFiles = await collectFiles(rootDirectory);
+if (localFiles.length === 0) throw new Error('No deployable files found after applying exclusions.');
+
+const createResult = await api('/api/deployments/direct', {
+  method: 'POST',
+  headers: { 'Content-Type': 'application/json' },
+  body: JSON.stringify({
+    files: localFiles.map(({ path, sha, size }) => ({ path, sha, size })),
+  }),
+});
+
+if (!createResult || !Array.isArray(createResult.files)) {
+  throw new Error('Direct deployment endpoint returned an unexpected response.');
+}
+
+const deploymentId = createResult.id;
+const localFileByPath = new Map(localFiles.map((file) => [file.path, file]));
+const uploadConcurrency = getUploadConcurrency();
+console.log('Created deployment. Deployment ID: ' + deploymentId);
+
+await runWithConcurrency(createResult.files, uploadConcurrency, async (manifestFile) => {
+  const localFile = localFileByPath.get(manifestFile.path);
+  if (!localFile) throw new Error('Backend returned an unknown file path: ' + manifestFile.path);
+  if (localFile.sha !== manifestFile.sha || localFile.size !== manifestFile.size) {
+    throw new Error('Backend file metadata mismatch for: ' + manifestFile.path);
+  }
+  await uploadFile(deploymentId, manifestFile, localFile);
+});
+
+console.log('Deployment files uploaded. Deployment ID: ' + deploymentId);
+console.log('Uploaded ' + createResult.files.length + ' files through direct deployment proxy with concurrency ' + uploadConcurrency + '.');
 NODE
 \`\`\`
 
-After the script succeeds, call the \`start-deployment\` tool with the printed deployment ID.`;
+After the script succeeds, call the \`start-deployment\` tool with the printed deployment ID.
+
+If the upload is interrupted after the deployment ID is printed, query \`system.deployment_files\` with the raw SQL tool for that \`deployment_id\` to inspect \`uploaded_at\`. You can rerun \`create-deployment\` to create a fresh deployment, or upload missing file IDs to \`PUT /api/deployments/:id/files/:fileId/content\` using the queried manifest rows.`;
 }
 function registerDeploymentTools(ctx) {
-  const { API_BASE_URL, backendVersion, isRemote, registerTool, withUsageTracking, getApiKey, addBackgroundContext } = ctx;
+  const {
+    API_BASE_URL,
+    backendVersion,
+    isRemote,
+    registerTool,
+    withUsageTracking,
+    getApiKey,
+    addBackgroundContext
+  } = ctx;
   const supportsDirectDeployment = supportsDirectDeploymentVersion(backendVersion);
   registerTool(
     "get-container-logs",
@@ -2979,7 +3043,9 @@ function registerDeploymentTools(ctx) {
         }
         const result = await handleApiResponse(response);
         return await addBackgroundContext({
-          content: [{ type: "text", text: formatSuccessMessage(`Latest logs from ${source}`, result) }]
+          content: [
+            { type: "text", text: formatSuccessMessage(`Latest logs from ${source}`, result) }
+          ]
         });
       } catch (error) {
         const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
@@ -2993,35 +3059,34 @@ function registerDeploymentTools(ctx) {
   if (isRemote) {
     registerTool(
       "create-deployment",
-      "Prepare a deployment upload. For backends v2.0.5 and newer, returns direct file upload commands. Older backends use the legacy zip upload flow. After uploading, call the start-deployment tool to trigger the build.",
+      "Prepare a deployment upload. Direct-capable backends return direct file upload commands. Older backends use the legacy zip upload flow. After uploading, call the start-deployment tool to trigger the build.",
       {
-        sourceDirectory: z29.string().describe('Absolute path to the source directory containing files to deploy (e.g., /Users/name/project). Do not use relative paths like "."')
+        sourceDirectory: z29.string().describe(
+          'Absolute path to the source directory containing files to deploy (e.g., /Users/name/project). Do not use relative paths like "."'
+        )
       },
       withUsageTracking("create-deployment", async ({ sourceDirectory }) => {
         try {
           if (!isAbsoluteSourcePath(sourceDirectory)) {
             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).`
-              }],
+              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
             };
           }
           if (supportsDirectDeployment) {
-            try {
-              const createResult2 = await createDirectDeploymentSession(API_BASE_URL, getApiKey());
-              return {
-                content: [{
+            return {
+              content: [
+                {
                   type: "text",
-                  text: buildRemoteDirectUploadInstructions(API_BASE_URL, sourceDirectory, String(createResult2.id))
-                }]
-              };
-            } catch (error) {
-              if (!(error instanceof DirectDeploymentUnsupportedError)) {
-                throw error;
-              }
-            }
+                  text: buildRemoteDirectUploadInstructions(API_BASE_URL, sourceDirectory)
+                }
+              ]
+            };
           }
           const createResponse = await fetch6(`${API_BASE_URL}/api/deployments`, {
             method: "POST",
@@ -3030,7 +3095,9 @@ function registerDeploymentTools(ctx) {
               "Content-Type": "application/json"
             }
           });
-          const createResult = parseCreateDeploymentResponse(await handleApiResponse(createResponse));
+          const createResult = parseCreateDeploymentResponse(
+            await handleApiResponse(createResponse)
+          );
           const { id: deploymentId, uploadUrl, uploadFields } = createResult;
           const esc = shellEsc;
           const curlFields = Object.entries(uploadFields).map(([key, value]) => `-F ${esc(`${key}=${value}`)}`).join(" \\\n  ");
@@ -3078,158 +3145,194 @@ Run each step in order. If any step fails, do not proceed to the next step.`;
         deploymentId: z29.string().describe("The deployment ID returned by create-deployment"),
         ...startDeploymentRequestSchema.shape
       },
-      withUsageTracking("start-deployment", async ({ deploymentId, projectSettings, envVars, meta }) => {
-        try {
-          const startBody = {};
-          if (projectSettings) startBody.projectSettings = projectSettings;
-          if (envVars) startBody.envVars = envVars;
-          if (meta) startBody.meta = meta;
-          const startResponse = await fetch6(`${API_BASE_URL}/api/deployments/${encodeURIComponent(deploymentId)}/start`, {
-            method: "POST",
-            headers: {
-              "x-api-key": getApiKey(),
-              "Content-Type": "application/json"
-            },
-            body: JSON.stringify(startBody)
-          });
-          const startResult = await handleApiResponse(startResponse);
-          return await addBackgroundContext({
-            content: [{
-              type: "text",
-              text: formatSuccessMessage("Deployment started", startResult) + "\n\nNote: You can check deployment status by querying the system.deployments table."
-            }]
-          });
-        } catch (error) {
-          const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-          return {
-            content: [{ type: "text", text: `Error starting deployment: ${errMsg}` }],
-            isError: true
-          };
+      withUsageTracking(
+        "start-deployment",
+        async ({ deploymentId, projectSettings, envVars, meta }) => {
+          try {
+            const startBody = {};
+            if (projectSettings) startBody.projectSettings = projectSettings;
+            if (envVars) startBody.envVars = envVars;
+            if (meta) startBody.meta = meta;
+            const startResponse = await fetch6(
+              `${API_BASE_URL}/api/deployments/${encodeURIComponent(deploymentId)}/start`,
+              {
+                method: "POST",
+                headers: {
+                  "x-api-key": getApiKey(),
+                  "Content-Type": "application/json"
+                },
+                body: JSON.stringify(startBody)
+              }
+            );
+            const startResult = await handleApiResponse(startResponse);
+            return await addBackgroundContext({
+              content: [
+                {
+                  type: "text",
+                  text: formatSuccessMessage("Deployment started", startResult) + "\n\nNote: You can check deployment status by querying the system.deployments table."
+                }
+              ]
+            });
+          } catch (error) {
+            const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+              content: [{ type: "text", text: `Error starting deployment: ${errMsg}` }],
+              isError: true
+            };
+          }
         }
-      })
+      )
     );
   } else {
     registerTool(
       "create-deployment",
-      "Deploy source code from a directory. Uses direct file upload for backends v2.0.5 and newer, with legacy zip upload fallback for older projects.",
+      "Deploy source code from a directory. Uses parallel direct file uploads for direct-capable backends, with legacy zip upload fallback for older projects.",
       {
-        sourceDirectory: z29.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 "."'),
+        sourceDirectory: z29.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 ({ sourceDirectory, projectSettings, envVars, meta }) => {
-        try {
-          if (!isAbsoluteSourcePath(sourceDirectory)) {
-            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
-            };
-          }
+      withUsageTracking(
+        "create-deployment",
+        async ({ sourceDirectory, projectSettings, envVars, meta }) => {
           try {
-            const stats = await fs3.stat(sourceDirectory);
-            if (!stats.isDirectory()) {
+            if (!isAbsoluteSourcePath(sourceDirectory)) {
               return {
-                content: [{
-                  type: "text",
-                  text: `Error: "${sourceDirectory}" is not a directory. Please provide a path to a directory containing the source code.`
-                }],
+                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
               };
             }
-          } catch {
-            return {
-              content: [{
-                type: "text",
-                text: `Error: Directory "${sourceDirectory}" does not exist or is not accessible. Please verify the path is correct.`
-              }],
-              isError: true
-            };
-          }
-          const resolvedSourceDir = sourceDirectory;
-          const startBody = buildStartBody({ projectSettings, envVars, meta });
-          if (supportsDirectDeployment) {
             try {
-              const { fileCount, startResult: startResult2 } = await deployDirect(API_BASE_URL, getApiKey(), resolvedSourceDir, startBody);
-              return await addBackgroundContext({
-                content: [{
-                  type: "text",
-                  text: formatSuccessMessage("Deployment started", startResult2) + `
-
-Uploaded ${fileCount} files through the direct deployment proxy.
-
-Note: You can check deployment status by querying the system.deployments table.`
-                }]
-              });
-            } catch (error) {
-              if (!(error instanceof DirectDeploymentUnsupportedError)) {
-                throw error;
+              const stats = await fs3.stat(sourceDirectory);
+              if (!stats.isDirectory()) {
+                return {
+                  content: [
+                    {
+                      type: "text",
+                      text: `Error: "${sourceDirectory}" is not a directory. Please provide a path to a directory containing the source code.`
+                    }
+                  ],
+                  isError: true
+                };
               }
+            } catch {
+              return {
+                content: [
+                  {
+                    type: "text",
+                    text: `Error: Directory "${sourceDirectory}" does not exist or is not accessible. Please verify the path is correct.`
+                  }
+                ],
+                isError: true
+              };
             }
-          }
-          const createResponse = await fetch6(`${API_BASE_URL}/api/deployments`, {
-            method: "POST",
-            headers: {
-              "x-api-key": getApiKey(),
-              "Content-Type": "application/json"
-            }
-          });
-          const createResult = parseCreateDeploymentResponse(await handleApiResponse(createResponse));
-          const { id: deploymentId, uploadUrl, uploadFields } = createResult;
-          const tmpZipPath = join2(tmpdir2(), `insforge-deploy-${deploymentId}.zip`);
-          try {
-            await new Promise((resolve, reject) => {
-              const archive = archiver("zip", { zlib: { level: 9 } });
-              const output = createWriteStream(tmpZipPath);
-              output.on("close", resolve);
-              output.on("error", reject);
-              archive.on("error", reject);
-              archive.directory(resolvedSourceDir, false, (entry) => {
-                const normalizedName = entry.name.replace(/\\/g, "/");
-                if (shouldExcludeDeploymentPath(normalizedName)) return false;
-                return entry;
-              });
-              archive.pipe(output);
-              archive.finalize();
-            });
-            const { size: zipSize } = await fs3.stat(tmpZipPath);
-            const uploadFormData = new FormData2();
-            for (const [key, value] of Object.entries(uploadFields)) {
-              uploadFormData.append(key, value);
+            const resolvedSourceDir = sourceDirectory;
+            const startBody = buildStartBody({ projectSettings, envVars, meta });
+            if (supportsDirectDeployment) {
+              try {
+                const { fileCount, uploadConcurrency, startResult: startResult2 } = await deployDirect(
+                  API_BASE_URL,
+                  getApiKey(),
+                  resolvedSourceDir,
+                  startBody
+                );
+                const uploadSummary = `Uploaded ${fileCount} files through direct deployment proxy with concurrency ${uploadConcurrency}.`;
+                return await addBackgroundContext({
+                  content: [
+                    {
+                      type: "text",
+                      text: formatSuccessMessage("Deployment started", startResult2) + `
+
+${uploadSummary}
+
+Note: You can check deployment status by querying the system.deployments table. If file uploads are interrupted, inspect system.deployment_files with the raw SQL tool to see which files are already uploaded before retrying missing files.`
+                    }
+                  ]
+                });
+              } catch (error) {
+                if (!(error instanceof DirectDeploymentUnsupportedError)) {
+                  throw error;
+                }
+              }
             }
-            uploadFormData.append("file", createReadStream(tmpZipPath), {
-              filename: "deployment.zip",
-              contentType: "application/zip",
-              knownLength: zipSize
-            });
-            const uploadResponse = await fetch6(uploadUrl, {
+            const createResponse = await fetch6(`${API_BASE_URL}/api/deployments`, {
               method: "POST",
-              body: uploadFormData,
-              headers: uploadFormData.getHeaders()
+              headers: {
+                "x-api-key": getApiKey(),
+                "Content-Type": "application/json"
+              }
             });
-            if (!uploadResponse.ok) {
-              const uploadError = await uploadResponse.text();
-              throw new Error(`Failed to upload zip file: ${uploadError}`);
+            const createResult = parseCreateDeploymentResponse(
+              await handleApiResponse(createResponse)
+            );
+            const { id: deploymentId, uploadUrl, uploadFields } = createResult;
+            const tmpZipPath = join2(tmpdir2(), `insforge-deploy-${deploymentId}.zip`);
+            try {
+              await new Promise((resolve, reject) => {
+                const archive = archiver("zip", { zlib: { level: 9 } });
+                const output = createWriteStream(tmpZipPath);
+                output.on("close", resolve);
+                output.on("error", reject);
+                archive.on("error", reject);
+                archive.directory(resolvedSourceDir, false, (entry) => {
+                  const normalizedName = entry.name.replace(/\\/g, "/");
+                  if (shouldExcludeDeploymentPath(normalizedName)) return false;
+                  return entry;
+                });
+                archive.pipe(output);
+                archive.finalize();
+              });
+              const { size: zipSize } = await fs3.stat(tmpZipPath);
+              const uploadFormData = new FormData2();
+              for (const [key, value] of Object.entries(uploadFields)) {
+                uploadFormData.append(key, value);
+              }
+              uploadFormData.append("file", createReadStream(tmpZipPath), {
+                filename: "deployment.zip",
+                contentType: "application/zip",
+                knownLength: zipSize
+              });
+              const uploadResponse = await fetch6(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}`);
+              }
+            } finally {
+              await fs3.rm(tmpZipPath, { force: true }).catch(() => void 0);
             }
-          } finally {
-            await fs3.rm(tmpZipPath, { force: true }).catch(() => void 0);
+            const startResult = await startDeployment(
+              API_BASE_URL,
+              getApiKey(),
+              deploymentId,
+              startBody
+            );
+            return await addBackgroundContext({
+              content: [
+                {
+                  type: "text",
+                  text: formatSuccessMessage("Deployment started", startResult) + "\n\nNote: You can check deployment status by querying the system.deployments table."
+                }
+              ]
+            });
+          } catch (error) {
+            const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
+            return {
+              content: [{ type: "text", text: `Error creating deployment: ${errMsg}` }],
+              isError: true
+            };
           }
-          const startResult = await startDeployment(API_BASE_URL, getApiKey(), deploymentId, startBody);
-          return await addBackgroundContext({
-            content: [{
-              type: "text",
-              text: formatSuccessMessage("Deployment started", startResult) + "\n\nNote: You can check deployment status by querying the system.deployments table."
-            }]
-          });
-        } catch (error) {
-          const errMsg = error instanceof Error ? error.message : "Unknown error occurred";
-          return {
-            content: [{ type: "text", text: `Error creating deployment: ${errMsg}` }],
-            isError: true
-          };
         }
-      })
+      )
     );
   }
 }
@@ -3290,7 +3393,10 @@ async function fetchBackendVersion(apiBaseUrl) {
     return health.version;
   } catch (error) {
     if (error instanceof Error && error.name === "AbortError") {
-      throw new Error(`Health check timed out after 10s \u2014 is the backend running at ${apiBaseUrl}?`, { cause: error });
+      throw new Error(
+        `Health check timed out after 10s \u2014 is the backend running at ${apiBaseUrl}?`,
+        { cause: error }
+      );
     }
     throw error;
   } finally {
@@ -3313,7 +3419,9 @@ async function registerInsforgeTools(server, config = {}) {
   } catch (error) {
     const msg = error instanceof Error ? error.message : String(error);
     console.error(`Failed to fetch backend version: ${msg}`);
-    throw new Error(`Cannot initialize tools: backend at ${API_BASE_URL} is unreachable. ${msg}`, { cause: error });
+    throw new Error(`Cannot initialize tools: backend at ${API_BASE_URL} is unreachable. ${msg}`, {
+      cause: error
+    });
   }
   let toolCount = 0;
   const registerTool = (toolName, ...args) => {

package/dist/http-server.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-3HMBKVW5.js";
+} from "./chunk-HCVPTSOB.js";
 
 // src/http/server.ts
 import "dotenv/config";

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   registerInsforgeTools
-} from "./chunk-3HMBKVW5.js";
+} from "./chunk-HCVPTSOB.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.2.10-dev.0",
+  "version": "1.2.10-dev.2",
   "description": "MCP (Model Context Protocol) server for Insforge backend-as-a-service",
   "mcpName": "io.github.InsForge/insforge-mcp",
   "type": "module",
@@ -45,7 +45,7 @@
     "server.json"
   ],
   "dependencies": {
-    "@insforge/shared-schemas": "1.1.48",
+    "@insforge/shared-schemas": "1.1.49",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "archiver": "^7.0.1",
     "commander": "^14.0.0",