gpteam 0.1.21 → 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. 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.
+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.21';
+export const PACKAGE_VERSION = '0.1.22';
 
 export function getHelpText() {
   return [

package/lib/image-mcp/image.js

@@ -35,9 +35,9 @@ export function buildImageGenerationPayload(input = {}, options = {}) {
     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');
@@ -286,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'],
@@ -632,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.21",
+  "version": "0.1.22",
   "description": "GPTeam API interactive client configurator and ingress benchmark CLI.",
   "type": "module",
   "bin": {