@jieunmarslim/server-editable-slides 0.2.0 → 0.2.2

package/index.js

@@ -43,23 +43,212 @@ function getProject() {
       .trim();
     if (p && p !== '(unset)') return p;
   } catch {}
-  throw new Error(
-    'No GCP project detected for Gemini Enterprise Agent Platform (GEAP) billing. Set your project via `gcloud config set project <PROJECT_ID>` or export EDITABLE_SLIDES_PROJECT.',
-  );
+  return null;
+}
+
+function getAccount() {
+  try {
+    const a = execSync('gcloud config get-value account', {
+      stdio: ['ignore', 'pipe', 'ignore'],
+    })
+      .toString()
+      .trim();
+    if (a && a !== '(unset)') return a;
+  } catch {}
+  return null;
+}
+
+async function runDoctor() {
+  const account = getAccount();
+  const token = getAuthToken();
+  const project = getProject();
+
+  console.error('\n========================================================================');
+  console.error(' 🔍 EditNBLM MCP Pre-flight Diagnostic & Doctor');
+  console.error('========================================================================\n');
+
+  let hasError = false;
+
+  // 1. Check Auth
+  if (account && token) {
+    console.error(` [1/4] Google Cloud Authentication:`);
+    console.error(`       ✓ Authenticated: ${account}`);
+  } else {
+    hasError = true;
+    console.error(` [1/4] Google Cloud Authentication:`);
+    console.error(`       ✗ FAILED: Not authenticated or token expired.`);
+    console.error(`       👉 Please run: gcloud auth login`);
+  }
+
+  // 2. Check Project Configuration & Account Access Permissions
+  let projectAccessOk = false;
+  if (!project) {
+    hasError = true;
+    console.error(`\n [2/4] GEAP Billing & Quota Project:`);
+    console.error(`       ✗ FAILED: No GCP project configured.`);
+    console.error(`       👉 Please run: gcloud config set project YOUR_GCP_PROJECT_ID`);
+    console.error(`       👉 Or export:  export EDITABLE_SLIDES_PROJECT=YOUR_GCP_PROJECT_ID`);
+  } else {
+    try {
+      // Actually verify that the logged-in account has access to this project
+      const check = execSync(
+        `gcloud projects describe ${project} --format="value(projectId)"`,
+        { stdio: ['ignore', 'pipe', 'pipe'] },
+      )
+        .toString()
+        .trim();
+      if (check === project) {
+        projectAccessOk = true;
+        console.error(`\n [2/4] Target GCP Project Accessibility:`);
+        console.error(
+          `       ✓ Verified: Account [${account}] has active access to project [${project}].`,
+        );
+      }
+    } catch (err) {
+      hasError = true;
+      const stderr = err.stderr ? err.stderr.toString() : err.message;
+      console.error(`\n [2/4] Target GCP Project Accessibility:`);
+      if (
+        stderr.includes('does not have permission') ||
+        stderr.includes('caller does not have permission')
+      ) {
+        console.error(
+          `       ✗ ACCESS DENIED: Account [${account}] does NOT have permission to access project [${project}].`,
+        );
+        console.error(
+          `       👉 Solution 1: Switch to an account that has access to [${project}]:`,
+        );
+        console.error(`          gcloud config set account <ACCOUNT_WITH_ACCESS>`);
+        console.error(
+          `       👉 Solution 2: Switch to a project that [${account}] can access:`,
+        );
+        console.error(
+          `          gcloud config set project <ACCESSIBLE_PROJECT_ID>`,
+        );
+      } else if (stderr.includes('not found') || stderr.includes('404')) {
+        console.error(
+          `       ✗ NOT FOUND: Project [${project}] does not exist or was deleted.`,
+        );
+        console.error(
+          `       👉 Please run: gcloud config set project <VALID_PROJECT_ID>`,
+        );
+      } else {
+        console.error(
+          `       ✗ FAILED: Unable to verify project access (${stderr.trim()}).`,
+        );
+      }
+    }
+  }
+
+  // 3. Verify One-Time IAM Delegation to EditNBLM Service Account
+  if (projectAccessOk) {
+    try {
+      const bindings = execSync(
+        `gcloud projects get-iam-policy ${project} --flatten="bindings[].members" --filter="bindings.role:roles/aiplatform.user" --format="value(bindings.members)"`,
+        { stdio: ['ignore', 'pipe', 'ignore'] },
+      ).toString();
+      const hasAiPlatform = bindings.includes(
+        'serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com',
+      );
+
+      console.error(`\n [3/4] GEAP Quota & IAM Delegation:`);
+      if (hasAiPlatform) {
+        console.error(
+          `       ✓ GRANTED: Service account has roles/aiplatform.user on [${project}].`,
+        );
+      } else {
+        hasError = true;
+        console.error(
+          `       ✗ MISSING: editnblm-mcp-runtime has NOT been granted roles/aiplatform.user on [${project}].`,
+        );
+        console.error(`       👉 Please run the delegation commands below.`);
+      }
+    } catch {
+      console.error(`\n [3/4] GEAP Quota & IAM Delegation:`);
+      console.error(
+        `       ⚠️  Could not read IAM policy directly. Ensure the delegation commands below were executed.`,
+      );
+    }
+  } else {
+    console.error(`\n [3/4] GEAP Quota & IAM Delegation:`);
+    console.error(`       ⏸️  Skipped until project access is resolved.`);
+  }
+
+  // 4. Check Backend Connectivity
+  try {
+    const res = await fetch(`${BASE_URL}/health`);
+    if (res.ok) {
+      console.error(`\n [4/4] EditNBLM Cloud Backend:`);
+      console.error(`       ✓ Status: Connected (${BASE_URL})`);
+    } else {
+      console.error(`\n [4/4] EditNBLM Cloud Backend:`);
+      console.error(`       ⚠️  Status: HTTP ${res.status}`);
+    }
+  } catch (err) {
+    console.error(`\n [4/4] EditNBLM Cloud Backend:`);
+    console.error(`       ✗ Status: Unreachable (${err.message})`);
+  }
+
+  // 5. One-Time IAM Delegation command helper
+  console.error('\n------------------------------------------------------------------------');
+  console.error(' 📋 One-Time IAM Delegation Commands for your Project:');
+  console.error('------------------------------------------------------------------------');
+  const targetProject = project || 'YOUR_GCP_PROJECT_ID';
+  console.error(`gcloud projects add-iam-policy-binding ${targetProject} \\`);
+  console.error('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\');
+  console.error('  --role="roles/aiplatform.user"\n');
+  console.error(`gcloud projects add-iam-policy-binding ${targetProject} \\`);
+  console.error('  --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" \\');
+  console.error('  --role="roles/serviceusage.serviceUsageConsumer"');
+  console.error('========================================================================\n');
+
+  if (!hasError) {
+    console.error('🎉 All checks PASSED! Your environment is ready to use EditNBLM MCP.\n');
+    process.exit(0);
+  } else {
+    console.error('⚠️  Setup incomplete. Please fix the items marked with ✗ above.\n');
+    process.exit(1);
+  }
+}
+
+// If invoked from an interactive terminal directly or with doctor/auth/check args, run diagnostic
+const args = process.argv.slice(2);
+if (
+  args.includes('doctor') ||
+  args.includes('auth') ||
+  args.includes('check') ||
+  args.includes('--check') ||
+  args.includes('--doctor') ||
+  args.includes('-h') ||
+  args.includes('--help') ||
+  (process.stdin.isTTY && !args.includes('--stdio'))
+) {
+  runDoctor();
+} else {
+  startMcpServer();
 }
 
 async function callRemoteMcp(method, params, apiKey) {
   const token = apiKey || getAuthToken();
+  if (!token) {
+    throw new Error(
+      '[EditNBLM Auth Required] Google Cloud credentials not found. Run `gcloud auth login` or set EDITABLE_SLIDES_API_KEY.',
+    );
+  }
+
   const project = getProject();
-  const url = `${BASE_URL}/mcp/${project}`;
+  if (!project) {
+    throw new Error(
+      '[EditNBLM Setup Required] No GCP project detected for Gemini Enterprise Agent Platform (GEAP) billing. Run `gcloud config set project <PROJECT_ID>` or export EDITABLE_SLIDES_PROJECT=<PROJECT_ID>.',
+    );
+  }
 
+  const url = `${BASE_URL}/mcp/${project}`;
   const headers = {
     'Content-Type': 'application/json',
     Accept: 'application/json, text/event-stream',
+    Authorization: `Bearer ${token}`,
   };
-  if (token) {
-    headers['Authorization'] = `Bearer ${token}`;
-  }
 
   const res = await fetch(url, {
     method: 'POST',
@@ -82,7 +271,18 @@ async function callRemoteMcp(method, params, apiKey) {
   const data = JSON.parse(jsonStr);
 
   if (data.error) {
-    throw new Error(data.error.message || JSON.stringify(data.error));
+    const msg = data.error.message || JSON.stringify(data.error);
+    if (
+      msg.includes('aiplatform.endpoints.predict') ||
+      (msg.includes('Permission') && msg.includes('denied'))
+    ) {
+      throw new Error(
+        `[EditNBLM IAM Delegation Required] Project (${project}) has not delegated roles/aiplatform.user to the EditNBLM service account.\n` +
+          `Run in terminal:\n` +
+          `gcloud projects add-iam-policy-binding ${project} --member="serviceAccount:editnblm-mcp-runtime@editnblm-in-ge-2036.iam.gserviceaccount.com" --role="roles/aiplatform.user"`,
+      );
+    }
+    throw new Error(msg);
   }
   return data.result;
 }
@@ -144,259 +344,264 @@ async function downloadPptxHelper(downloadUrl, targetPath) {
   return null;
 }
 
-const server = new McpServer({
-  name: 'editable-slides',
-  version: '1.0.0',
-});
-
-// 1. Fast Synchronous Slide Conversion (Single Image)
-server.tool(
-  'create_slides_from_image',
-  'Convert a single presentation slide image (PNG/JPG) synchronously into an editable deck. For multi-page PDFs or multi-slide documents, this tool automatically triggers background conversion to prevent client timeouts. DO NOT write code or install packages; present the output directly or use existing Google Drive MCP tools.',
-  {
-    filePath: z
-      .string()
-      .optional()
-      .describe('Local file path to the slide image or PDF (e.g. /path/to/slide.png)'),
-    fileUrl: z
-      .string()
-      .optional()
-      .describe('Public HTTP(S) or gs:// URL of the slide image or PDF'),
-    format: z
-      .enum(['slides', 'pptx'])
-      .optional()
-      .describe("Output format: 'slides' (default, Google Slides URL) or 'pptx'"),
-    apiKey: z
-      .string()
-      .optional()
-      .describe('Optional API key or access token for authentication'),
-  },
-  async ({ filePath, fileUrl, format, apiKey }) => {
-    let targetUrl = fileUrl;
-    let originalName = fileUrl ? path.basename(fileUrl) : 'presentation';
-    let isPdf = false;
-
-    if (filePath && !targetUrl) {
-      const uploaded = await uploadLocalFile(filePath, apiKey);
-      targetUrl = uploaded.fileUrl;
-      originalName = uploaded.fileName;
-      isPdf = uploaded.isPdf;
-    } else if (targetUrl && targetUrl.toLowerCase().endsWith('.pdf')) {
-      isPdf = true;
-    }
+function startMcpServer() {
+  const server = new McpServer({
+    name: 'editable-slides',
+    version: '1.0.0',
+  });
 
-    if (!targetUrl) {
-      throw new Error('Either filePath or fileUrl must be provided.');
-    }
+  // 1. Fast Synchronous Slide Conversion (Single Image)
+  server.tool(
+    'create_slides_from_image',
+    'Convert a single presentation slide image (PNG/JPG) synchronously into an editable deck. For multi-page PDFs or multi-slide documents, this tool automatically triggers background conversion to prevent client timeouts. DO NOT write code or install packages; present the output directly or use existing Google Drive MCP tools.',
+    {
+      filePath: z
+        .string()
+        .optional()
+        .describe('Local file path to the slide image or PDF (e.g. /path/to/slide.png)'),
+      fileUrl: z
+        .string()
+        .optional()
+        .describe('Public HTTP(S) or gs:// URL of the slide image or PDF'),
+      format: z
+        .enum(['slides', 'pptx'])
+        .optional()
+        .describe("Output format: 'slides' (default, Google Slides URL) or 'pptx'"),
+      apiKey: z
+        .string()
+        .optional()
+        .describe('Optional API key or access token for authentication'),
+    },
+    async ({ filePath, fileUrl, format, apiKey }) => {
+      let targetUrl = fileUrl;
+      let originalName = fileUrl ? path.basename(fileUrl) : 'presentation';
+      let isPdf = false;
+
+      if (filePath && !targetUrl) {
+        const uploaded = await uploadLocalFile(filePath, apiKey);
+        targetUrl = uploaded.fileUrl;
+        originalName = uploaded.fileName;
+        isPdf = uploaded.isPdf;
+      } else if (targetUrl && targetUrl.toLowerCase().endsWith('.pdf')) {
+        isPdf = true;
+      }
 
-    // If document is a multi-page PDF, route to async pipeline to prevent 120s MCP timeout
-    if (isPdf) {
-      console.error('[EditNBLM] Multi-page PDF detected. Starting background pipeline to prevent timeout...');
-      const startResult = await callRemoteMcp(
+      if (!targetUrl) {
+        throw new Error('Either filePath or fileUrl must be provided.');
+      }
+
+      // If document is a multi-page PDF, route to async pipeline to prevent 120s MCP timeout
+      if (isPdf) {
+        console.error('[EditNBLM] Multi-page PDF detected. Starting background pipeline to prevent timeout...');
+        const startResult = await callRemoteMcp(
+          'tools/call',
+          {
+            name: 'start_slide_conversion',
+            arguments: {
+              fileUrl: targetUrl,
+              fileName: originalName,
+              format: format || 'slides',
+            },
+          },
+          apiKey,
+        );
+
+        const parsed = JSON.parse(startResult.content[0].text);
+        if (parsed.jobId) {
+          activeJobs.set(parsed.jobId, { filePath, fileName: originalName });
+          parsed.note =
+            'Multi-page PDF detected. High-performance conversion started in background to prevent client timeouts. ' +
+            'STRICT MANDATE FOR AGENT: Immediately call `check_slide_conversion` with this jobId to track progress until done. ' +
+            'DO NOT write custom scripts or install packages.';
+          parsed.agentInstructions = [
+            `Call check_slide_conversion with jobId: "${parsed.jobId}" to follow page-by-page progress.`,
+            'When check_slide_conversion returns status "done", the finished presentation will be automatically saved locally.',
+          ];
+          startResult.content[0].text = JSON.stringify(parsed, null, 2);
+        }
+        return startResult;
+      }
+
+      // Synchronous single-image conversion
+      console.error(`[EditNBLM] Converting image to ${format || 'slides'}...`);
+      const result = await callRemoteMcp(
         'tools/call',
         {
-          name: 'start_slide_conversion',
+          name: 'create_slides_from_image',
           arguments: {
             fileUrl: targetUrl,
-            fileName: originalName,
             format: format || 'slides',
           },
         },
         apiKey,
       );
 
-      const parsed = JSON.parse(startResult.content[0].text);
-      if (parsed.jobId) {
-        activeJobs.set(parsed.jobId, { filePath, fileName: originalName });
-        parsed.note =
-          'Multi-page PDF detected. High-performance conversion started in background to prevent client timeouts. ' +
-          'STRICT MANDATE FOR AGENT: Immediately call `check_slide_conversion` with this jobId to track progress until done. ' +
-          'DO NOT write custom scripts or install packages.';
-        parsed.agentInstructions = [
-          `Call check_slide_conversion with jobId: "${parsed.jobId}" to follow page-by-page progress.`,
-          'When check_slide_conversion returns status "done", the finished presentation will be automatically saved locally.',
-        ];
-        startResult.content[0].text = JSON.stringify(parsed, null, 2);
+      try {
+        const parsed = JSON.parse(result.content[0].text);
+        if (parsed.downloadUrl && filePath) {
+          const localPptxPath = filePath.replace(/\.[^/.]+$/, '') + '.pptx';
+          await downloadPptxHelper(parsed.downloadUrl, localPptxPath);
+          parsed.localPptxPath = localPptxPath;
+        }
+        if (parsed.downloadUrl || parsed.localPptxPath) {
+          parsed.agentInstructions = [
+            'TASK FINISHED: The presentation has been successfully generated and saved as an editable PowerPoint (.pptx) file.',
+            'STRICT MANDATE FOR AGENT: DO NOT write custom scripts, install Python/Node packages, or execute terminal commands to convert or upload this file.',
+            '1. If you already have an active Google Drive MCP tool (e.g. drive.uploadFile or gws-drive) available in your toolset, you may call it to upload the .pptx file with Google Slides conversion.',
+            '2. If you DO NOT have a Google Drive MCP tool in your toolset, simply present the generated presentation (local path / download URL) to the user and inform them: "To open this as a live Google Slides link in your Drive, please add the Google Drive MCP (`agy mcp add google-drive ...`) or drag the .pptx file into Google Drive."',
+          ];
+        }
+        result.content[0].text = JSON.stringify(parsed, null, 2);
+      } catch {
+        // Retain original result
       }
-      return startResult;
-    }
 
-    // Synchronous single-image conversion
-    console.error(`[EditNBLM] Converting image to ${format || 'slides'}...`);
-    const result = await callRemoteMcp(
-      'tools/call',
-      {
-        name: 'create_slides_from_image',
-        arguments: {
-          fileUrl: targetUrl,
-          format: format || 'slides',
-        },
-      },
-      apiKey,
-    );
+      return result;
+    },
+  );
 
-    try {
-      const parsed = JSON.parse(result.content[0].text);
-      if (parsed.downloadUrl && filePath) {
-        const localPptxPath = filePath.replace(/\.[^/.]+$/, '') + '.pptx';
-        await downloadPptxHelper(parsed.downloadUrl, localPptxPath);
-        parsed.localPptxPath = localPptxPath;
+  // 2. Start Asynchronous Slide Conversion (for PDFs & heavy decks)
+  server.tool(
+    'start_slide_conversion',
+    'Begin converting an image or multi-page PDF (e.g. 15-page presentation) into an editable presentation deck. Accepts a local filePath or remote fileUrl. Returns a jobId immediately in ~1 second without client timeouts. Follow up by calling check_slide_conversion with the returned jobId.',
+    {
+      filePath: z
+        .string()
+        .optional()
+        .describe('Local file path to the slide image or PDF (e.g. /path/to/asdf.pdf)'),
+      fileUrl: z
+        .string()
+        .optional()
+        .describe('Public HTTP(S) or gs:// URL of the slide image or PDF'),
+      fileName: z
+        .string()
+        .optional()
+        .describe('Original file name if known'),
+      format: z
+        .enum(['slides', 'pptx'])
+        .optional()
+        .describe("What to produce: 'slides' for a Google Slides deck (default), or 'pptx'"),
+      apiKey: z
+        .string()
+        .optional()
+        .describe('Optional API key or access token for authentication'),
+    },
+    async ({ filePath, fileUrl, fileName, format, apiKey }) => {
+      let targetUrl = fileUrl;
+      let targetFileName = fileName;
+
+      if (filePath && !targetUrl) {
+        const uploaded = await uploadLocalFile(filePath, apiKey);
+        targetUrl = uploaded.fileUrl;
+        targetFileName = targetFileName || uploaded.fileName;
       }
-      if (parsed.downloadUrl || parsed.localPptxPath) {
-        parsed.agentInstructions = [
-          'TASK FINISHED: The presentation has been successfully generated and saved as an editable PowerPoint (.pptx) file.',
-          'STRICT MANDATE FOR AGENT: DO NOT write custom scripts, install Python/Node packages, or execute terminal commands to convert or upload this file.',
-          '1. If you already have an active Google Drive MCP tool (e.g. drive.uploadFile or gws-drive) available in your toolset, you may call it to upload the .pptx file with Google Slides conversion.',
-          '2. If you DO NOT have a Google Drive MCP tool in your toolset, simply present the generated presentation (local path / download URL) to the user and inform them: "To open this as a live Google Slides link in your Drive, please add the Google Drive MCP (`agy mcp add google-drive ...`) or drag the .pptx file into Google Drive."',
-        ];
+
+      if (!targetUrl) {
+        throw new Error('Either filePath or fileUrl must be provided.');
       }
-      result.content[0].text = JSON.stringify(parsed, null, 2);
-    } catch {
-      // Retain original result
-    }
 
-    return result;
-  },
-);
-
-// 2. Start Asynchronous Slide Conversion (for PDFs & heavy decks)
-server.tool(
-  'start_slide_conversion',
-  'Begin converting an image or multi-page PDF (e.g. 15-page presentation) into an editable presentation deck. Accepts a local filePath or remote fileUrl. Returns a jobId immediately in ~1 second without client timeouts. Follow up by calling check_slide_conversion with the returned jobId.',
-  {
-    filePath: z
-      .string()
-      .optional()
-      .describe('Local file path to the slide image or PDF (e.g. /path/to/asdf.pdf)'),
-    fileUrl: z
-      .string()
-      .optional()
-      .describe('Public HTTP(S) or gs:// URL of the slide image or PDF'),
-    fileName: z
-      .string()
-      .optional()
-      .describe('Original file name if known'),
-    format: z
-      .enum(['slides', 'pptx'])
-      .optional()
-      .describe("What to produce: 'slides' for a Google Slides deck (default), or 'pptx'"),
-    apiKey: z
-      .string()
-      .optional()
-      .describe('Optional API key or access token for authentication'),
-  },
-  async ({ filePath, fileUrl, fileName, format, apiKey }) => {
-    let targetUrl = fileUrl;
-    let targetFileName = fileName;
-
-    if (filePath && !targetUrl) {
-      const uploaded = await uploadLocalFile(filePath, apiKey);
-      targetUrl = uploaded.fileUrl;
-      targetFileName = targetFileName || uploaded.fileName;
-    }
+      console.error(`[EditNBLM] Starting background conversion for "${targetFileName || targetUrl}"...`);
+      const startResult = await callRemoteMcp(
+        'tools/call',
+        {
+          name: 'start_slide_conversion',
+          arguments: {
+            fileUrl: targetUrl,
+            fileName: targetFileName,
+            format: format || 'slides',
+          },
+        },
+        apiKey,
+      );
 
-    if (!targetUrl) {
-      throw new Error('Either filePath or fileUrl must be provided.');
-    }
+      try {
+        const parsed = JSON.parse(startResult.content[0].text);
+        if (parsed.jobId) {
+          activeJobs.set(parsed.jobId, { filePath, fileName: targetFileName });
+          parsed.agentInstructions = [
+            `Call check_slide_conversion with jobId: "${parsed.jobId}" to follow page-by-page progress.`,
+            'DO NOT write scripts or install packages while waiting.',
+          ];
+          startResult.content[0].text = JSON.stringify(parsed, null, 2);
+        }
+      } catch {}
 
-    console.error(`[EditNBLM] Starting background conversion for "${targetFileName || targetUrl}"...`);
-    const startResult = await callRemoteMcp(
-      'tools/call',
-      {
-        name: 'start_slide_conversion',
-        arguments: {
-          fileUrl: targetUrl,
-          fileName: targetFileName,
-          format: format || 'slides',
-        },
-      },
-      apiKey,
-    );
+      return startResult;
+    },
+  );
 
-    try {
-      const parsed = JSON.parse(startResult.content[0].text);
-      if (parsed.jobId) {
-        activeJobs.set(parsed.jobId, { filePath, fileName: targetFileName });
-        parsed.agentInstructions = [
-          `Call check_slide_conversion with jobId: "${parsed.jobId}" to follow page-by-page progress.`,
-          'DO NOT write scripts or install packages while waiting.',
-        ];
-        startResult.content[0].text = JSON.stringify(parsed, null, 2);
-      }
-    } catch {}
-
-    return startResult;
-  },
-);
-
-// 3. Check Slide Conversion Progress & Auto-Download
-server.tool(
-  'check_slide_conversion',
-  'Report the progress of a conversion started by start_slide_conversion. Call this repeatedly until status is "done". When complete, automatically downloads the editable PowerPoint (.pptx) file to local disk.',
-  {
-    jobId: z
-      .string()
-      .describe('The jobId returned by start_slide_conversion or create_slides_from_image'),
-    sinceUpdatedAt: z
-      .number()
-      .optional()
-      .describe('updatedAt from previous check to wait for new progress updates'),
-    apiKey: z
-      .string()
-      .optional()
-      .describe('Optional API key or access token for authentication'),
-  },
-  async ({ jobId, sinceUpdatedAt, apiKey }) => {
-    const result = await callRemoteMcp(
-      'tools/call',
-      {
-        name: 'check_slide_conversion',
-        arguments: { jobId, sinceUpdatedAt },
-      },
-      apiKey,
-    );
+  // 3. Check Slide Conversion Progress & Auto-Download
+  server.tool(
+    'check_slide_conversion',
+    'Report the progress of a conversion started by start_slide_conversion. Call this repeatedly until status is "done". When complete, automatically downloads the editable PowerPoint (.pptx) file to local disk.',
+    {
+      jobId: z
+        .string()
+        .describe('The jobId returned by start_slide_conversion or create_slides_from_image'),
+      sinceUpdatedAt: z
+        .number()
+        .optional()
+        .describe('updatedAt from previous check to wait for new progress updates'),
+      apiKey: z
+        .string()
+        .optional()
+        .describe('Optional API key or access token for authentication'),
+    },
+    async ({ jobId, sinceUpdatedAt, apiKey }) => {
+      const result = await callRemoteMcp(
+        'tools/call',
+        {
+          name: 'check_slide_conversion',
+          arguments: { jobId, sinceUpdatedAt },
+        },
+        apiKey,
+      );
 
-    try {
-      const parsed = JSON.parse(result.content[0].text);
-      const jobInfo = activeJobs.get(jobId);
-
-      if (parsed.status === 'done') {
-        if (parsed.downloadUrl) {
-          let destPath = null;
-          if (jobInfo?.filePath) {
-            destPath = jobInfo.filePath.replace(/\.[^/.]+$/, '') + '.pptx';
-          } else {
-            const safeName = (jobInfo?.fileName || 'presentation').replace(/\.[^/.]+$/, '');
-            destPath = path.resolve(process.cwd(), `${safeName}.pptx`);
+      try {
+        const parsed = JSON.parse(result.content[0].text);
+        const jobInfo = activeJobs.get(jobId);
+
+        if (parsed.status === 'done') {
+          if (parsed.downloadUrl) {
+            let destPath = null;
+            if (jobInfo?.filePath) {
+              destPath = jobInfo.filePath.replace(/\.[^/.]+$/, '') + '.pptx';
+            } else {
+              const safeName = (jobInfo?.fileName || 'presentation').replace(/\.[^/.]+$/, '');
+              destPath = path.resolve(process.cwd(), `${safeName}.pptx`);
+            }
+
+            await downloadPptxHelper(parsed.downloadUrl, destPath);
+            parsed.localPptxPath = destPath;
           }
 
-          await downloadPptxHelper(parsed.downloadUrl, destPath);
-          parsed.localPptxPath = destPath;
+          parsed.agentInstructions = [
+            'TASK FINISHED: The presentation has been successfully generated and saved as an editable PowerPoint (.pptx) file.',
+            parsed.localPptxPath ? `Local file: ${parsed.localPptxPath}` : null,
+            'STRICT MANDATE FOR AGENT: DO NOT write custom scripts, install Python/Node packages, or execute terminal commands to convert this file.',
+            '1. If you have an active Google Drive MCP tool (e.g. drive.uploadFile or gws-drive), call it now to upload the .pptx file with Google Slides conversion.',
+            '2. If you DO NOT have a Google Drive MCP tool, present the local file path and download URL to the user directly.',
+          ].filter(Boolean);
         }
 
-        parsed.agentInstructions = [
-          'TASK FINISHED: The presentation has been successfully generated and saved as an editable PowerPoint (.pptx) file.',
-          parsed.localPptxPath ? `Local file: ${parsed.localPptxPath}` : null,
-          'STRICT MANDATE FOR AGENT: DO NOT write custom scripts, install Python/Node packages, or execute terminal commands to convert this file.',
-          '1. If you have an active Google Drive MCP tool (e.g. drive.uploadFile or gws-drive), call it now to upload the .pptx file with Google Slides conversion.',
-          '2. If you DO NOT have a Google Drive MCP tool, present the local file path and download URL to the user directly.',
-        ].filter(Boolean);
-      }
-
-      result.content[0].text = JSON.stringify(parsed, null, 2);
-    } catch {}
+        result.content[0].text = JSON.stringify(parsed, null, 2);
+      } catch {}
 
-    return result;
-  },
-);
+      return result;
+    },
+  );
 
-async function main() {
   const transport = new StdioServerTransport();
-  await server.connect(transport);
-  console.error('[EditNBLM] Ready and connected to EditNBLM Cloud.');
+  server.connect(transport).then(() => {
+    const project = getProject();
+    if (project) {
+      console.error(`[EditNBLM] Ready. Connected to EditNBLM Cloud (Billing Project: ${project}).`);
+    } else {
+      console.error('[EditNBLM] ⚠️  Warning: No active GCP project detected for billing.');
+      console.error('[EditNBLM] Run `npx @jieunmarslim/server-editable-slides doctor` to configure.');
+    }
+  }).catch((err) => {
+    console.error('[EditNBLM] Fatal error:', err);
+    process.exit(1);
+  });
 }
-
-main().catch((err) => {
-  console.error('[EditNBLM] Fatal error:', err);
-  process.exit(1);
-});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jieunmarslim/server-editable-slides",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Model Context Protocol (MCP) client for Editable Slides Cloud",
   "type": "module",
   "bin": {