gpteam 0.1.23 → 0.1.26

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.
+- `download_image_result`: returns the completed file metadata and local file path by default. Pass `include_image: true` only when the client must receive MCP image content, because large images can trigger context compaction.
 - `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.26';
 
 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',
@@ -650,7 +651,7 @@ function normalizeIdempotencyKey(value) {
 }
 
 function shapeDownloadResult(result, input = {}) {
-  const includeImage = !input.metadata_only && input.include_image !== false;
+  const includeImage = input.include_image === true && !input.metadata_only;
   const includeRevisedPrompt = input.include_revised_prompt !== false;
   const output = {
     ...result,

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}`);
     }
@@ -239,13 +238,13 @@ function downloadSchema() {
   const schema = jobIDSchema();
   schema.properties.metadata_only = {
     type: 'boolean',
-    description: 'Return only metadata without MCP image content.',
-    default: false
+    description: '只返回文件路径和元数据，不返回 MCP 图片内容。默认 true，避免大图进入上下文触发频繁 compact。',
+    default: true
   };
   schema.properties.include_image = {
     type: 'boolean',
-    description: 'Include image content when the job succeeded.',
-    default: true
+    description: '显式返回 MCP 图片内容。大图会显著增加上下文，通常保持 false，只使用本地文件路径。',
+    default: false
   };
   schema.properties.include_revised_prompt = {
     type: 'boolean',

package/lib/models.js

@@ -45,8 +45,7 @@ export function normalizeModels(payload) {
 
   for (const item of items) {
     const id = String(item.id || item.name || '').trim();
-    if (!id || !id.startsWith('gpt-')) continue;
-    if (id.includes('image')) continue;
+    if (!isConfigurableCodexModel(id, item)) continue;
     const fallback = FALLBACK_MODELS[id] || {};
     const thinking = item.thinking && typeof item.thinking === 'object' ? item.thinking : {};
     const levels = Array.isArray(thinking.levels) ? thinking.levels : fallback.efforts;
@@ -74,6 +73,13 @@ export function normalizeModels(payload) {
   return Array.from(result.values()).sort((a, b) => a.id.localeCompare(b.id));
 }
 
+function isConfigurableCodexModel(id, item) {
+  if (!id || !id.startsWith('gpt-') || id.includes('image')) return false;
+  const owner = String(item?.owned_by || item?.provider || item?.type || '').trim().toLowerCase();
+  if (!owner) return Object.prototype.hasOwnProperty.call(FALLBACK_MODELS, id);
+  return owner === 'openai' || owner === 'codex' || owner === 'openai-compatible';
+}
+
 export async function fetchModels(baseUrl, apiKey, options = {}) {
   let response;
   try {

package/package.json

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