mcp-google-multi 6.0.0-alpha.2 → 6.0.0-alpha.3

package/dist/api-probe.d.ts

@@ -0,0 +1,18 @@
+import type { ApiProbeResult } from './doctor.js';
+export interface ApiProbeSpec {
+    service: string;
+    /** console library id for the enable deep-link, e.g. "calendar-json". */
+    api: string;
+    url: string;
+    scopePrefixes: string[];
+    /** id-required APIs have no no-arg read; a 404 on a nonexistent id still
+     * proves the API is enabled (accessNotConfigured wins before routing). */
+    notFoundMeansEnabled?: boolean;
+}
+export declare const API_PROBES: ApiProbeSpec[];
+export declare function planProbes(granted: string[], probes?: ApiProbeSpec[]): ApiProbeSpec[];
+export interface ApiProbeDeps {
+    grantedScopes: (alias: string) => string[];
+    request: (alias: string, url: string) => Promise<void>;
+}
+export declare function probeApiEnablement(alias: string, deps?: ApiProbeDeps): Promise<ApiProbeResult[]>;

package/dist/api-probe.js

@@ -0,0 +1,65 @@
+import { getClient } from './client.js';
+import { readToken } from './token-store.js';
+import { mapGoogleError } from './tools/_errors.js';
+const P = 'https://www.googleapis.com/auth/';
+const BOGUS_ID = 'mcp-google-multi-probe-nonexistent';
+export const API_PROBES = [
+    { service: 'gmail', api: 'gmail', url: 'https://gmail.googleapis.com/gmail/v1/users/me/profile', scopePrefixes: [`${P}gmail.`] },
+    { service: 'drive', api: 'drive', url: 'https://www.googleapis.com/drive/v3/about?fields=user', scopePrefixes: [`${P}drive`] },
+    { service: 'calendar', api: 'calendar-json', url: 'https://www.googleapis.com/calendar/v3/users/me/calendarList?maxResults=1', scopePrefixes: [`${P}calendar`] },
+    // people/me needs profile scopes, not contacts; connections is the read the
+    // contacts grant actually authorizes.
+    { service: 'contacts', api: 'people', url: 'https://people.googleapis.com/v1/people/me/connections?personFields=names&pageSize=1', scopePrefixes: [`${P}contacts`] },
+    { service: 'sheets', api: 'sheets', url: `https://sheets.googleapis.com/v4/spreadsheets/${BOGUS_ID}`, scopePrefixes: [`${P}spreadsheets`], notFoundMeansEnabled: true },
+    { service: 'docs', api: 'docs', url: `https://docs.googleapis.com/v1/documents/${BOGUS_ID}`, scopePrefixes: [`${P}documents`], notFoundMeansEnabled: true },
+    { service: 'searchconsole', api: 'searchconsole', url: 'https://www.googleapis.com/webmasters/v3/sites', scopePrefixes: [`${P}webmasters`] },
+    { service: 'tasks', api: 'tasks', url: 'https://tasks.googleapis.com/tasks/v1/users/@me/lists?maxResults=1', scopePrefixes: [`${P}tasks`] },
+    { service: 'chat', api: 'chat', url: 'https://chat.googleapis.com/v1/spaces?pageSize=1', scopePrefixes: [`${P}chat.`] },
+    { service: 'meet', api: 'meet', url: 'https://meet.googleapis.com/v2/conferenceRecords?pageSize=1', scopePrefixes: [`${P}meetings.`] },
+    { service: 'forms', api: 'forms', url: `https://forms.googleapis.com/v1/forms/${BOGUS_ID}`, scopePrefixes: [`${P}forms.`], notFoundMeansEnabled: true },
+];
+export function planProbes(granted, probes = API_PROBES) {
+    return probes.filter((p) => granted.some((s) => p.scopePrefixes.some((prefix) => s.startsWith(prefix))));
+}
+const DEFAULT_DEPS = {
+    grantedScopes: (alias) => {
+        try {
+            const scope = readToken(alias)?.scope;
+            return typeof scope === 'string' ? scope.split(' ').filter(Boolean) : [];
+        }
+        catch {
+            return [];
+        }
+    },
+    request: async (alias, url) => {
+        const auth = await getClient(alias);
+        await auth.request({ url, timeout: 10_000 });
+    },
+};
+export async function probeApiEnablement(alias, deps = DEFAULT_DEPS) {
+    const results = [];
+    for (const spec of planProbes(deps.grantedScopes(alias))) {
+        try {
+            await deps.request(alias, spec.url);
+            results.push({ service: spec.service, api: spec.api, ok: true });
+        }
+        catch (error) {
+            const envelope = mapGoogleError(error, alias);
+            if (envelope.error === 'network_error') {
+                // One connect failure means they will all fail: abort so section 6
+                // reports a single WARN "Probe could not complete" with the code.
+                throw new Error(envelope.message, { cause: error });
+            }
+            if (envelope.error === 'api_not_enabled') {
+                results.push({ service: spec.service, api: spec.api, ok: false, notEnabled: true, message: envelope.message });
+            }
+            else if (spec.notFoundMeansEnabled && envelope.error === 'not_found') {
+                results.push({ service: spec.service, api: spec.api, ok: true });
+            }
+            else {
+                results.push({ service: spec.service, api: spec.api, ok: false, message: envelope.error });
+            }
+        }
+    }
+    return results;
+}

package/dist/doctor.js

@@ -6,6 +6,7 @@ import { deriveAccountHealth } from './tools/accounts-tool.js';
 import { peekMasterKeyProvenance, deleteMasterKeyMaterial } from './master-key.js';
 import { hasToken } from './token-store.js';
 import { configDir } from './config-file.js';
+import { probeApiEnablement } from './api-probe.js';
 const MIN_NODE_MAJOR = 22;
 const DEFAULT_DEPS = {
     nodeVersion: process.versions.node,
@@ -23,6 +24,7 @@ const DEFAULT_DEPS = {
     masterKeyProvenance: () => peekMasterKeyProvenance(),
     anyTokensExist: (aliases) => aliases.some((a) => hasToken(a)),
     fileExists: fs.existsSync,
+    probeApi: (alias) => probeApiEnablement(alias),
 };
 /** Console deep-link to enable one API (section-6 hint, error taxonomy B10). */
 export function apiEnableLink(api) {
@@ -163,6 +165,9 @@ async function sectionApiEnablement(deps, aliases) {
         // Network / transient: WARN with the target, never crash the report.
         return { id: 6, title: 'API enablement', verdict: 'warn', lines: [`Probe could not complete: ${e?.message ?? e}`] };
     }
+    if (results.length === 0) {
+        return { id: 6, title: 'API enablement', verdict: 'unknown', lines: [`No probeable service scopes granted on "${healthy}".`] };
+    }
     const disabled = results.filter((r) => r.notEnabled);
     const lines = results.map((r) => `${r.service}: ${r.ok ? 'enabled' : r.notEnabled ? 'NOT ENABLED' : `unknown (${r.message ?? 'error'})`}`);
     if (disabled.length > 0) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-google-multi",
-  "version": "6.0.0-alpha.2",
+  "version": "6.0.0-alpha.3",
   "description": "Local MCP server for Google Workspace (Gmail, Drive, Calendar, Sheets, Docs, Contacts, Tasks, Meet, Search Console, +Forms/Chat/Admin) across multiple accounts — OAuth-only, encrypted token storage, deny-by-default writes.",
   "type": "module",
   "license": "MIT",