gpteam 0.1.23 → 0.1.24

package/README.md

@@ -16,14 +16,14 @@ Client config writing follows the same safety pattern as cc-switch: keep Codex t
 
 The Image MCP config uses cc-switch-style per-client env blocks. Codex writes `[mcp_servers.gpteam_image.env]`, OpenCode writes `mcp.gpteam_image.environment`, and Claude Code writes `mcpServers.gpteam_image.env` in `~/.claude.json`. The MCP receives `GPTEAM_API_KEY` and `GPTEAM_BASE_URL` from that MCP config, so it does not depend on Codex `auth.json` or inherited `OPENAI_API_KEY`.
 
-The Image MCP exposes both a synchronous compatibility tool and a local async job flow:
+The Image MCP exposes an async-first local job flow plus a legacy compatibility alias:
 
 - `create_image_job`: recommended for normal use. It starts a local background image job and returns `job_id` quickly, which avoids losing the whole generation when a VPN, proxy, or client has a 60-second idle timeout.
 - `get_image_job_status`: checks whether the local job is queued, running, succeeded, failed, canceled, or expired.
 - `cancel_image_job`: cancels a queued/running local job.
 - `download_image_result`: returns the completed file metadata and image content. Use `metadata_only`, `include_image`, and `include_revised_prompt` to control large result payloads.
 - `get_capabilities`: returns supported sizes, formats, quality values, async support, cancellation semantics, queue limits, and image-to-image support.
-- `generate_image`: waits for completion and writes the image file immediately. This is kept for synchronous compatibility.
+- `generate_image`: legacy compatibility alias. It now creates the same async job and returns `job_id` immediately instead of blocking until the image is complete.
 
 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`.
 

package/lib/config.js

@@ -13,8 +13,7 @@ const IMAGE_MCP_ENABLED_TOOLS = [
   'get_image_job_status',
   'download_image_result',
   'cancel_image_job',
-  'get_capabilities',
-  'generate_image'
+  'get_capabilities'
 ];
 
 export const CLIENTS = [
@@ -63,7 +62,7 @@ export function writeCodexConfig(settings) {
     `command = ${tomlString(mcpCommand.command)}`,
     `args = [${mcpCommand.args.map((arg) => tomlString(arg)).join(', ')}]`,
     'startup_timeout_sec = 20',
-    'tool_timeout_sec = 300',
+    'tool_timeout_sec = 900',
     `enabled_tools = [${IMAGE_MCP_ENABLED_TOOLS.map((name) => tomlString(name)).join(', ')}]`,
     'default_tools_approval_mode = "prompt"',
     '',

package/lib/help.js

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

package/lib/image-mcp/image.js

@@ -39,7 +39,7 @@ export const IMAGE_SIZE_CONSTRAINTS = {
 
 const defaultMaxAttempts = 3;
 const defaultRetryDelayMs = 800;
-const defaultRequestTimeoutMs = 5 * 60 * 1000;
+const defaultRequestTimeoutMs = 15 * 60 * 1000;
 const defaultMaxConcurrentJobs = 2;
 const defaultMaxQueuedJobs = 20;
 const defaultJobTTLMS = 30 * 60 * 1000;
@@ -301,6 +301,7 @@ export function getCapabilities(options = {}) {
     ok: true,
     model: DEFAULT_IMAGE_MODEL,
     default_model: DEFAULT_IMAGE_MODEL,
+    preferred_tool: 'create_image_job',
     supports_async: true,
     supports_cancel: true,
     cancel_semantics: 'best_effort',

package/lib/image-mcp/server.js

@@ -6,7 +6,6 @@ import {
   cancelImageJob,
   createImageJob,
   downloadImageResult,
-  generateImage,
   getCapabilities,
   IMAGE_BACKGROUND_OPTIONS,
   IMAGE_FORMATS,
@@ -19,7 +18,7 @@ import {
   toolResultContent
 } from './image.js';
 
-const imageToolPromptingInstruction = '调用前请先确认用户真实需求：尺寸或比例、质量、输出格式、保存目录或文件名。缺少这些关键信息时应先追问，不要直接默认生成。';
+const imageToolPromptingInstruction = '调用前请先确认用户真实需求：尺寸或比例、质量、输出格式、保存目录或文件名。缺少这些关键信息时应先追问，不要直接默认生成。常规生图请优先用 create_image_job，避免长任务占住 MCP 连接。';
 
 const imageInputProperties = {
   prompt: {
@@ -161,7 +160,7 @@ const tools = [
   },
   {
     name: 'generate_image',
-    description: `兼容同步工具。通过 GPTeam Image 2 生成图片，等待完成并保存到本地。${imageToolPromptingInstruction}耗时较长时优先使用 create_image_job。`,
+    description: `兼容旧调用的异步别名。为避免长图或高质量任务导致 MCP 连接断开，它不会等待图片完成，而是创建任务并立即返回 job_id；之后必须用 get_image_job_status 和 download_image_result 获取结果。${imageToolPromptingInstruction}`,
     inputSchema: {
       type: 'object',
       properties: imageInputProperties,
@@ -225,7 +224,7 @@ export async function callImageTool(toolName, args = {}, deps = {}) {
     case 'get_capabilities':
       return getCapabilities(deps);
     case 'generate_image':
-      return await generateImage(args || {}, deps);
+      return createImageJob(args || {}, deps);
     default:
       throw new McpError(ErrorCode.InvalidParams, `未知工具：${toolName}`);
     }

package/package.json

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