gmail-workspace-mcp-server 0.4.7 → 0.4.8

package/node_modules/@pulsemcp/mcp-elicitation/build/config.d.ts

@@ -3,11 +3,13 @@ import type { ElicitationConfig } from './types.js';
  * Reads elicitation configuration from environment variables.
  *
  * Environment variables:
- *   ELICITATION_ENABLED       - "true" (default) or "false"
- *   ELICITATION_REQUEST_URL   - POST endpoint for HTTP fallback
- *   ELICITATION_POLL_URL      - GET endpoint for HTTP fallback polling
- *   ELICITATION_TTL_MS        - Request TTL in milliseconds (default: 300000)
- *   ELICITATION_POLL_INTERVAL_MS - Poll interval in milliseconds (default: 5000, min: 1000)
- *   ELICITATION_SESSION_ID      - Session identifier for HTTP fallback `_meta`
+ *   ELICITATION_ENABLED              - "true" (default) or "false"
+ *   ELICITATION_REQUEST_URL          - POST endpoint for HTTP fallback
+ *   ELICITATION_POLL_URL             - GET endpoint for HTTP fallback polling
+ *   ELICITATION_TTL_MS               - Request TTL in milliseconds (default: 300000)
+ *   ELICITATION_POLL_INTERVAL_MS     - Poll interval in milliseconds (default: 5000, min: 1000)
+ *   ELICITATION_SESSION_ID           - Session identifier for HTTP fallback `_meta`
+ *   ELICITATION_PREFER_HTTP_FALLBACK - "true" forces HTTP fallback over native elicitation
+ *                                      when both are available. Default: "false".
  */
 export declare function readElicitationConfig(env?: Record<string, string | undefined>): ElicitationConfig;

package/node_modules/@pulsemcp/mcp-elicitation/build/config.js

@@ -14,16 +14,20 @@ function parsePositiveInt(value, defaultValue) {
  * Reads elicitation configuration from environment variables.
  *
  * Environment variables:
- *   ELICITATION_ENABLED       - "true" (default) or "false"
- *   ELICITATION_REQUEST_URL   - POST endpoint for HTTP fallback
- *   ELICITATION_POLL_URL      - GET endpoint for HTTP fallback polling
- *   ELICITATION_TTL_MS        - Request TTL in milliseconds (default: 300000)
- *   ELICITATION_POLL_INTERVAL_MS - Poll interval in milliseconds (default: 5000, min: 1000)
- *   ELICITATION_SESSION_ID      - Session identifier for HTTP fallback `_meta`
+ *   ELICITATION_ENABLED              - "true" (default) or "false"
+ *   ELICITATION_REQUEST_URL          - POST endpoint for HTTP fallback
+ *   ELICITATION_POLL_URL             - GET endpoint for HTTP fallback polling
+ *   ELICITATION_TTL_MS               - Request TTL in milliseconds (default: 300000)
+ *   ELICITATION_POLL_INTERVAL_MS     - Poll interval in milliseconds (default: 5000, min: 1000)
+ *   ELICITATION_SESSION_ID           - Session identifier for HTTP fallback `_meta`
+ *   ELICITATION_PREFER_HTTP_FALLBACK - "true" forces HTTP fallback over native elicitation
+ *                                      when both are available. Default: "false".
  */
 export function readElicitationConfig(env = process.env) {
     const enabledRaw = env.ELICITATION_ENABLED;
     const enabled = enabledRaw === undefined ? true : enabledRaw.toLowerCase() !== 'false';
+    const preferHttpFallbackRaw = env.ELICITATION_PREFER_HTTP_FALLBACK;
+    const preferHttpFallback = preferHttpFallbackRaw !== undefined && preferHttpFallbackRaw.toLowerCase() === 'true';
     const pollIntervalMs = Math.max(MIN_POLL_INTERVAL_MS, parsePositiveInt(env.ELICITATION_POLL_INTERVAL_MS, DEFAULT_POLL_INTERVAL_MS));
     return {
         enabled,
@@ -32,5 +36,6 @@ export function readElicitationConfig(env = process.env) {
         ttlMs: parsePositiveInt(env.ELICITATION_TTL_MS, DEFAULT_TTL_MS),
         pollIntervalMs,
         sessionId: env.ELICITATION_SESSION_ID,
+        preferHttpFallback,
     };
 }

package/node_modules/@pulsemcp/mcp-elicitation/build/elicitation.d.ts

@@ -2,12 +2,17 @@ import type { ElicitationConfig, ElicitationRequestedSchema, ElicitationResult,
 /**
  * Requests user confirmation through the best available mechanism.
  *
- * Decision tree:
+ * Decision tree (default):
  * 1. If elicitation is disabled (`ELICITATION_ENABLED=false`), returns `accept` immediately.
  * 2. If the client supports native elicitation, uses `server.elicitInput()`.
  * 3. If HTTP fallback URLs are configured, posts to the external endpoint and polls.
  * 4. Otherwise, throws an error indicating no elicitation mechanism is available.
  *
+ * When `cfg.preferHttpFallback` is true (set via `ELICITATION_PREFER_HTTP_FALLBACK=true`)
+ * AND both fallback URLs are configured, tier 3 runs before tier 2. This is intended for
+ * headless agent runtimes that falsely advertise elicitation capability but cannot actually
+ * surface the prompt to a user.
+ *
  * @param options - Configuration for the confirmation request.
  * @param config - Elicitation config (defaults to reading from env vars).
  * @returns The user's response.

package/node_modules/@pulsemcp/mcp-elicitation/build/elicitation.js

@@ -98,15 +98,37 @@ async function pollElicitationStatus(config, requestId, expiresAt) {
     }
     return { action: 'expired' };
 }
+/**
+ * Runs the HTTP fallback flow: POST a request, then poll until resolved or expired.
+ */
+async function httpFallbackElicit(cfg, options) {
+    const clientRequestId = randomUUID();
+    const expiresAt = Date.now() + cfg.ttlMs;
+    const meta = {
+        'com.pulsemcp/request-id': clientRequestId,
+        'com.pulsemcp/expires-at': new Date(expiresAt).toISOString(),
+        ...(cfg.sessionId && { 'com.pulsemcp/session-id': cfg.sessionId }),
+        ...options.meta,
+    };
+    const postResponse = await postElicitationRequest(cfg, options.message, options.requestedSchema, meta);
+    // Use the server-provided requestId if available, otherwise fall back to the client-generated one
+    const requestId = postResponse.requestId || clientRequestId;
+    return pollElicitationStatus(cfg, requestId, expiresAt);
+}
 /**
  * Requests user confirmation through the best available mechanism.
  *
- * Decision tree:
+ * Decision tree (default):
  * 1. If elicitation is disabled (`ELICITATION_ENABLED=false`), returns `accept` immediately.
  * 2. If the client supports native elicitation, uses `server.elicitInput()`.
  * 3. If HTTP fallback URLs are configured, posts to the external endpoint and polls.
  * 4. Otherwise, throws an error indicating no elicitation mechanism is available.
  *
+ * When `cfg.preferHttpFallback` is true (set via `ELICITATION_PREFER_HTTP_FALLBACK=true`)
+ * AND both fallback URLs are configured, tier 3 runs before tier 2. This is intended for
+ * headless agent runtimes that falsely advertise elicitation capability but cannot actually
+ * surface the prompt to a user.
+ *
  * @param options - Configuration for the confirmation request.
  * @param config - Elicitation config (defaults to reading from env vars).
  * @returns The user's response.
@@ -117,24 +139,18 @@ export async function requestConfirmation(options, config) {
     if (!cfg.enabled) {
         return { action: 'accept' };
     }
+    const httpFallbackAvailable = Boolean(cfg.requestUrl && cfg.pollUrl);
+    // Opt-in: prefer HTTP fallback over native elicitation when both are available.
+    if (cfg.preferHttpFallback && httpFallbackAvailable) {
+        return httpFallbackElicit(cfg, options);
+    }
     // Tier 2: Native elicitation
     if (clientSupportsElicitation(options.server)) {
         return nativeElicit(options.server, options.message, options.requestedSchema);
     }
     // Tier 3: HTTP fallback
-    if (cfg.requestUrl && cfg.pollUrl) {
-        const clientRequestId = randomUUID();
-        const expiresAt = Date.now() + cfg.ttlMs;
-        const meta = {
-            'com.pulsemcp/request-id': clientRequestId,
-            'com.pulsemcp/expires-at': new Date(expiresAt).toISOString(),
-            ...(cfg.sessionId && { 'com.pulsemcp/session-id': cfg.sessionId }),
-            ...options.meta,
-        };
-        const postResponse = await postElicitationRequest(cfg, options.message, options.requestedSchema, meta);
-        // Use the server-provided requestId if available, otherwise fall back to the client-generated one
-        const requestId = postResponse.requestId || clientRequestId;
-        return pollElicitationStatus(cfg, requestId, expiresAt);
+    if (httpFallbackAvailable) {
+        return httpFallbackElicit(cfg, options);
     }
     // Tier 4: No mechanism available
     throw new Error('Elicitation is enabled but no mechanism is available. ' +

package/node_modules/@pulsemcp/mcp-elicitation/build/types.d.ts

@@ -64,6 +64,16 @@ export interface ElicitationConfig {
     pollIntervalMs: number;
     /** Session identifier included as `com.pulsemcp/session-id` in `_meta` of HTTP fallback requests. */
     sessionId?: string;
+    /**
+     * When true, prefer HTTP fallback (Tier 3) over native elicitation (Tier 2)
+     * when both are available. Default: false.
+     *
+     * Useful for headless agent runtimes (e.g., Claude Code under Agent Orchestrator)
+     * that advertise the `elicitation` client capability but have no real interactive
+     * user — native `elicitInput()` calls auto-cancel without ever surfacing a prompt.
+     * Forcing the HTTP fallback routes the request to an external approval UI instead.
+     */
+    preferHttpFallback?: boolean;
 }
 /**
  * The result of an elicitation request.

package/node_modules/@pulsemcp/mcp-elicitation/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pulsemcp/mcp-elicitation",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Elicitation support library for PulseMCP MCP servers - provides native elicitation with HTTP fallback",
   "type": "module",
   "main": "build/index.js",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gmail-workspace-mcp-server",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "description": "MCP server for Gmail integration with OAuth2 and service account support",
   "main": "build/index.js",
   "type": "module",