gpteam 0.1.20 → 0.1.22

package/README.md

@@ -27,7 +27,7 @@ The Image MCP exposes both a synchronous compatibility tool and a local async jo
 
 Image MCP results are returned as stable JSON text and MCP `structuredContent`. Successful results include final file path, model, action, size, format, quality, byte size, SHA-256, MIME type, image dimensions, duration, retry count, `job_id`, `trace_id`, and optional `idempotency_key`. Error results use stable `error.code`, `error.message`, `error.retryable`, `error.stage`, `error.upstream_status`, and `error.trace_id` fields while keeping compatibility fields such as `category` and `http_status`.
 
-The MCP supports normal text-to-image generation and image-to-image/edit inputs. Pass `images` as data URLs, HTTPS URLs, or local file paths. Pass `mask` the same way for masked edits. `input_fidelity` is accepted for compatibility but is not forwarded to the current GPTeam Image 2 bridge because upstream Codex image edits reject it. File writes create missing directories, avoid overwriting existing files by adding `-v2`, `-v3`, etc., and validate PNG/JPEG/WebP before returning success. `overwrite: true` is available for explicit replacement. `return_revised_prompt` controls whether the upstream revised prompt is included in the result.
+The MCP supports normal text-to-image generation and image-to-image/edit inputs. Pass `images` as data URLs, HTTPS URLs, or local file paths. For easier tool calling, `image`, `image_path`, `image_paths`, `input_image`, and `input_images` are accepted as aliases. Pass `mask` or `mask_path` the same way for masked edits. `input_fidelity` is accepted for compatibility but is not forwarded to the current GPTeam Image 2 bridge because upstream Codex image edits reject it. The MCP requests GPTeam image endpoints with `stream=true` and reads the final image event, so long image jobs get early stream bytes instead of sitting idle until the final JSON body. File writes create missing directories, avoid overwriting existing files by adding `-v2`, `-v3`, etc., and validate PNG/JPEG/WebP before returning success. `overwrite: true` is available for explicit replacement. `return_revised_prompt` controls whether the upstream revised prompt is included in the result.
 
 Claude Code is written to `~/.claude/settings.json` under the `env` section, using the GPTeam `/anthropic` base URL. OpenClaw writes `models.providers.gpteam` and also selects `gpteam/<model>` under `agents.defaults.model`, so the chosen model is active without an extra manual step.
 

package/lib/help.js

@@ -1,5 +1,5 @@
 export const PACKAGE_NAME = 'gpteam';
-export const PACKAGE_VERSION = '0.1.20';
+export const PACKAGE_VERSION = '0.1.22';
 
 export function getHelpText() {
   return [

package/lib/image-mcp/image.js

@@ -29,14 +29,15 @@ export function buildImageGenerationPayload(input = {}, options = {}) {
     model: String(input.model || DEFAULT_IMAGE_MODEL),
     prompt: String(input.prompt || '').trim(),
     response_format: 'b64_json',
+    stream: true,
     size: String(input.size || '1024x1024'),
     quality: String(input.quality || 'high'),
     output_format: normalizeImageFormat(input.format || input.output_format || DEFAULT_IMAGE_FORMAT)
   };
   const imageOptions = { ...options, home: options.home };
-  const images = normalizeInputImages(input.images || input.image, imageOptions);
+  const images = normalizeInputImages(collectInputImageValues(input), imageOptions);
   if (images.length > 0) payload.images = images.map((imageURL) => ({ image_url: imageURL }));
-  const mask = normalizeImageReference(input.mask, imageOptions);
+  const mask = normalizeImageReference(firstPresentImageReference(input.mask, input.mask_path), imageOptions);
   if (mask) payload.mask = { image_url: mask };
   copyOptionalImageToolOption(payload, input, 'background');
   copyOptionalImageToolOption(payload, input, 'moderation');
@@ -285,6 +286,8 @@ export function getCapabilities(options = {}) {
     supports_idempotency_key: true,
     supports_image_to_image: true,
     supports_mask: true,
+    image_input_fields: ['images', 'image', 'image_path', 'image_paths', 'input_image', 'input_images'],
+    mask_input_fields: ['mask', 'mask_path'],
     sizes: ['1024x1024', '1536x1024', '1024x1536', 'auto'],
     formats: ['png', 'jpeg', 'webp'],
     quality: ['low', 'medium', 'high', 'auto'],
@@ -330,21 +333,8 @@ async function fetchImageOnce(fetchImpl, credentials, payload, options) {
       signal: requestSignal.signal
     });
     if (!response.ok) throw await imageErrorFromHTTPResponse(response, credentials.apiKey);
-    const data = await response.json();
-    const first = Array.isArray(data && data.data) ? data.data[0] : null;
-    const b64 = first && typeof first.b64_json === 'string' ? first.b64_json : '';
-    if (!b64) {
-      throw new ImageMCPError('GPTeam 图片接口没有返回 b64_json 图片数据。', {
-      code: 'image_data_missing',
-      category: 'response_invalid',
-      stage: 'local',
-      retryable: false
-      });
-    }
-    return {
-      b64,
-      revisedPrompt: first && typeof first.revised_prompt === 'string' ? first.revised_prompt : ''
-    };
+    if (isEventStreamResponse(response)) return await readImageSSE(response);
+    return await readImageJSON(response);
   } catch (error) {
     if (error instanceof ImageMCPError) throw error;
     throw imageErrorFromFetch(error, {
@@ -357,6 +347,98 @@ async function fetchImageOnce(fetchImpl, credentials, payload, options) {
   }
 }
 
+async function readImageJSON(response) {
+  const data = await response.json();
+  const first = Array.isArray(data && data.data) ? data.data[0] : null;
+  return imageResultFromItem(first);
+}
+
+async function readImageSSE(response) {
+  const text = await response.text();
+  let lastError = null;
+  for (const event of parseSSEDataEvents(text)) {
+    if (!event || event === '[DONE]') continue;
+    let payload;
+    try {
+      payload = JSON.parse(event);
+    } catch {
+      continue;
+    }
+    if (payload && payload.error) {
+      lastError = imageErrorFromSSEPayload(payload);
+      continue;
+    }
+    const item = imageResultFromStreamPayload(payload);
+    if (item) return item;
+  }
+  if (lastError) throw lastError;
+  throw missingImageDataError();
+}
+
+function parseSSEDataEvents(text) {
+  const events = [];
+  let current = [];
+  for (const rawLine of String(text || '').split(/\r?\n/)) {
+    if (rawLine === '') {
+      if (current.length > 0) events.push(current.join('\n'));
+      current = [];
+      continue;
+    }
+    if (rawLine.startsWith('data:')) current.push(rawLine.slice(5).trimStart());
+  }
+  if (current.length > 0) events.push(current.join('\n'));
+  return events;
+}
+
+function imageResultFromStreamPayload(payload) {
+  const type = String(payload && payload.type || '');
+  if (!type.endsWith('.completed')) return null;
+  return imageResultFromItem(payload);
+}
+
+function imageResultFromItem(first) {
+  const b64 = first && typeof first.b64_json === 'string' ? first.b64_json : imageDataURLToB64(first && first.url);
+  if (!b64) throw missingImageDataError();
+  return {
+    b64,
+    revisedPrompt: first && typeof first.revised_prompt === 'string' ? first.revised_prompt : ''
+  };
+}
+
+function imageDataURLToB64(value) {
+  const text = String(value || '').trim();
+  const match = text.match(/^data:image\/[a-z0-9.+-]+;base64,(.+)$/i);
+  return match ? match[1] : '';
+}
+
+function missingImageDataError() {
+  return new ImageMCPError('GPTeam 图片接口没有返回 b64_json 图片数据。', {
+    code: 'image_data_missing',
+    category: 'response_invalid',
+    stage: 'local',
+    retryable: false
+  });
+}
+
+function imageErrorFromSSEPayload(payload) {
+  const error = payload && payload.error;
+  const message = typeof error === 'string' ? error : String(error && error.message || 'GPTeam 图片流返回错误。');
+  const code = typeof error === 'object' && error ? String(error.code || payload.code || 'upstream_stream_error') : String(payload.code || 'upstream_stream_error');
+  return new ImageMCPError(message, {
+    code,
+    category: 'upstream',
+    stage: 'upstream',
+    retryable: code === 'rate_limit_exceeded' || code === 'server_error'
+  });
+}
+
+function isEventStreamResponse(response) {
+  const contentType = response && response.headers && typeof response.headers.get === 'function'
+    ? String(response.headers.get('content-type') || '')
+    : '';
+  return /text\/event-stream/i.test(contentType);
+}
+
 function buildSuccessResult(input) {
   const result = {
     ok: true,
@@ -552,6 +634,36 @@ function normalizeInputImages(value, options = {}) {
   return rawImages.map((item) => normalizeImageReference(item, options)).filter(Boolean);
 }
 
+function collectInputImageValues(input = {}) {
+  const values = [];
+  appendImageAlias(values, input.images);
+  appendImageAlias(values, input.image);
+  appendImageAlias(values, input.image_path);
+  appendImageAlias(values, input.image_paths);
+  appendImageAlias(values, input.input_image);
+  appendImageAlias(values, input.input_images);
+  return values;
+}
+
+function appendImageAlias(target, value) {
+  if (Array.isArray(value)) {
+    for (const item of value) appendImageAlias(target, item);
+    return;
+  }
+  if (value) target.push(value);
+}
+
+function firstPresentImageReference(...values) {
+  for (const value of values) {
+    if (Array.isArray(value)) {
+      if (value.length > 0) return value[0];
+      continue;
+    }
+    if (value) return value;
+  }
+  return '';
+}
+
 function normalizeImageReference(value, options = {}) {
   if (!value) return '';
   if (typeof value === 'object') {

package/lib/image-mcp/server.js

@@ -53,10 +53,32 @@ const imageInputProperties = {
     items: { type: 'string' },
     description: 'Optional input images for image-to-image or edit. Values may be data URLs, HTTPS URLs, or local file paths.'
   },
+  image_path: {
+    type: 'string',
+    description: 'Optional single local image path alias for image-to-image or edit.'
+  },
+  image_paths: {
+    type: 'array',
+    items: { type: 'string' },
+    description: 'Optional local image path aliases for image-to-image or edit.'
+  },
+  input_image: {
+    type: 'string',
+    description: 'Optional single input image alias. Accepts a data URL, HTTPS URL, or local file path.'
+  },
+  input_images: {
+    type: 'array',
+    items: { type: 'string' },
+    description: 'Optional input image aliases. Accepts data URLs, HTTPS URLs, or local file paths.'
+  },
   mask: {
     type: 'string',
     description: 'Optional mask image for image edit. Value may be a data URL, HTTPS URL, or local file path.'
   },
+  mask_path: {
+    type: 'string',
+    description: 'Optional local mask image path alias for image edit.'
+  },
   input_fidelity: {
     type: 'string',
     description: 'Accepted for compatibility. The GPTeam Image 2 bridge currently ignores this option because the upstream Codex image tool rejects it on edits.',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gpteam",
-  "version": "0.1.20",
+  "version": "0.1.22",
   "description": "GPTeam API interactive client configurator and ingress benchmark CLI.",
   "type": "module",
   "bin": {