@chrischall/gemini-mcp 1.6.2 → 1.7.0

package/dist/tools/jobs.js

@@ -11,7 +11,11 @@ import { z } from 'zod';
 // other session's result by job id — see src/session.ts.
 export function registerJobTools(server, client) {
     server.registerTool('gemini_get_result', {
-        description: 'Retrieve an async generation started with `async: true`. Pass the returned `job_id`: while running it reports status "running"; on completion it returns the normal result (image paths / inline images + meta); on failure it raises the recorded error. Jobs belong to your session and expire ~10 min after completion — if a job id is unknown, check the output dir / <image>.json sidecar.',
+        description: 'Retrieve a generation started with `async: true` or handed off by `max_wait_ms`. Pass the returned `job_id`: ' +
+            'while running it reports status "running"; on completion it returns the normal result (image URLs/paths + meta); ' +
+            'on failure it raises the recorded error, including the case where the generation was killed before it finished. ' +
+            'On the hosted connector job records are stored durably and survive a restart; on a local stdio server they live ' +
+            'with the process and expire ~10 min after completion, where the output dir / <image>.json sidecar is the fallback.',
         annotations: { readOnlyHint: true, openWorldHint: false },
         inputSchema: {
             job_id: z.string().min(1).describe('The job_id returned by a generation tool called with async: true'),

package/dist/tools/shared.js

@@ -55,7 +55,10 @@ export const idempotencyKeySchema = z
 export const asyncSchema = z
     .boolean()
     .optional()
-    .describe('Run in the background and return a job_id immediately instead of the image, so a long (Pro/4K) generation cannot hit the host tools/call timeout (-32001). Poll gemini_get_result with the job_id to fetch the result (jobs are per-process and expire ~10 min after completion).');
+    .describe('Run in the background and return a job_id immediately instead of the image, so a long (Pro/4K) generation cannot hit ' +
+    'the host tools/call timeout (-32001). Poll gemini_get_result with the job_id to fetch the result. ' +
+    'PREFER `max_wait_ms` on the hosted connector: it runs where the executor is only guaranteed to stay alive while the ' +
+    'request is open, so this option is served there as a bounded wait rather than an immediate hand-off.');
 /**
  * Wait-then-hand-off budget shared by every generation tool: wait up to the
  * budget for the in-band result, and past it return a `{ job_id }` handle
@@ -361,10 +364,17 @@ export function timeoutRiskHint(opts) {
         .join(' + ');
     const lead = `Slow config (${why}) can exceed a host's tools/call timeout (e.g. Claude Desktop ~30s, error -32001). `;
     if (opts.persistsFiles === false) {
+        // Deliberately NOT `async: true`. This connector runs on a machine that is
+        // stopped whenever no request is in flight, so an immediate hand-off is
+        // what gets a generation killed mid-flight; holding the request open is
+        // what keeps it alive. Recommending async here was recommending the
+        // failure mode (see src/job-store.ts).
         return (lead +
             `This connector has no filesystem, so a lost response cannot be recovered from disk — there is no output dir and no ` +
-            `<image>.json sidecar. Use \`async: true\` to get a job_id immediately and poll gemini_get_result, ` +
-            `or use a Flash model / drop image_size to 1K/2K for a faster in-band result.`);
+            `<image>.json sidecar. Set \`max_wait_ms\` (e.g. 240000): keeping the request open is also what keeps the generation ` +
+            `running here, and a batch that outlives the budget hands back a job_id to poll with gemini_get_result. ` +
+            `For a faster in-band result use a Flash model or drop image_size to 1K/2K. If a result is ever lost, ` +
+            `list what was already generated with gemini_list_recent_media before paying for it again.`);
     }
     return (lead +
         `If the host gives up mid-generation the image is still written to disk (and gemini_interact leaves an ` +

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Single source of the server version. release-please bumps the literal below. */
-export const VERSION = '1.6.2'; // x-release-please-version
+export const VERSION = '1.7.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrischall/gemini-mcp",
-  "version": "1.6.2",
+  "version": "1.7.0",
   "mcpName": "io.github.chrischall/gemini-mcp",
   "description": "Gemini image-generation MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/gemini-mcp",
     "source": "github"
   },
-  "version": "1.6.2",
+  "version": "1.7.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@chrischall/gemini-mcp",
-      "version": "1.6.2",
+      "version": "1.7.0",
       "transport": {
         "type": "stdio"
       },