@yanickxia/agent-vision 0.1.0 → 0.3.0

package/README.md

@@ -1,14 +1,15 @@
 # agent-vision
 
 一个小而直接的视觉 MCP Server + Agent Skill：让纯文本 Agent 通过一个
-OpenAI-compatible 视觉模型理解图片和视频。
+OpenAI-compatible 视觉模型理解图片和视频，也能通过生图模型从文字生成图片。
 
 - 纯 Node.js / TypeScript，`npx` 自动下载运行
-- MCP 工具：`analyze_image`、`analyze_video`
-- Agent Skills 标准目录：`skills/agent-vision/`
+- MCP 工具：`analyze_image`、`analyze_video`、`generate_image`
+- Agent Skills 标准目录：`skills/agent-vision/`，能力自适应：能看图的 Agent 直接看，纯文本 Agent 直接跑 CLI
 - 图片：本地路径、HTTP(S) URL、Data URI
 - 视频：本地路径或 URL，自动下载 npm 内的 ffmpeg 并均匀抽帧
-- 单一 provider，无免费模型列表、fallback 竞速、watchdog 或透明代理
+- 识图多 provider 多模型并发竞速：所有 target 同时请求，谁先成功用谁，其余请求 abort
+- 生图：支持 OpenAI-compatible 和火山方舟 Seedream，独立配置 provider / model，按顺序失败回退
 
 ## 为什么做这个项目
 
@@ -19,25 +20,54 @@ OpenAI-compatible 视觉模型理解图片和视频。
 - [vision-tool](https://github.com/farhanic017/vision-tool)：支持视频抽帧，但包含大量 provider 探测、并行 fallback 和安装逻辑，并采用 GPL-3.0。
 - [agent-vision-toolkit](https://github.com/Anionex/agent-vision-toolkit)：Skill 和任务工作流很强，但核心是多组 Python/Shell CLI，不是 MCP 视频服务。
 
-`agent-vision` 只保留一条链路：**MCP/CLI → 图片或视频帧 → 你配置的视觉 API → 文本**。
+`agent-vision` 保持两条简单链路：
+
+- 理解：**MCP/CLI → 图片或视频帧 → 你配置的视觉 API → 文本**
+- 生成：**MCP/CLI → 文字描述 → 你配置的生图 API → 图片**
 本仓库是独立实现，没有复制 `vision-tool` 的 GPL 源码。
 
 ## 要求
 
 - Node.js 20+
-- 一个支持 `/chat/completions` 和 `image_url` 的 OpenAI-compatible 视觉模型
+- 图片/视频理解：支持 `/chat/completions` 和 `image_url` 的 OpenAI-compatible 视觉模型
+- 生图：OpenAI-compatible 生图模型，或火山方舟 Seedream（API Key 鉴权）；理解和生图可以单独配置
 
 ffmpeg 由 `@ffmpeg-installer/ffmpeg` 按平台自动安装，无需另行安装。
 
 ## 配置
 
+推荐用配置文件（一次配置，所有宿主共用）：
+
 ```bash
-export AGENT_VISION_BASE_URL="https://your-endpoint.example/v1"
-export AGENT_VISION_API_KEY="your-key"
-export AGENT_VISION_MODEL="your-vision-model"
+mkdir -p ~/.config/agent-vision
+cat > ~/.config/agent-vision/settings.json <<'EOF'
+{
+  "providers": [
+    {
+      "name": "dashscope",
+      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
+      "apiKey": "sk-...",
+      "models": ["qwen-vl-max", "qwen-vl-plus"]
+    },
+    {
+      "name": "openai",
+      "baseUrl": "https://api.openai.com/v1",
+      "apiKey": "sk-...",
+      "models": ["gpt-4o"]
+    }
+  ]
+}
+EOF
+chmod 600 ~/.config/agent-vision/settings.json
 ```
 
-本地无鉴权端点可以不设置 API key。变量优先级：
+- 位置：`$AGENT_VISION_CONFIG` 显式路径，或 `$XDG_CONFIG_HOME/agent-vision/settings.json`（默认 `~/.config/agent-vision/settings.json`）
+- `providers` 用于图片/视频理解，每个 provider × model 是一个 target；多个 target 时**并发请求，第一个成功者胜出**，其余请求 abort。注意成本：N 个 target 意味着每次分析最多 N 份上传与推理费用
+- provider 字段：`baseUrl`（必填）、`models`（必填非空）、`name`/`apiKey`/`headers`（可选；`apiKey` 缺省回退环境变量）
+- 顶层可选：`maxTokens`、`timeoutMs`、`headers`、`maxImageMb`、`maxVideoMb`、`allowPrivateUrls`、`ffmpegPath`
+- 文件定义的字段优先于环境变量；含 key 的文件建议 `chmod 600`
+
+环境变量作为回退仍然完整支持（无配置文件时）：
 
 | 设置 | 兼容回退 |
 |---|---|
@@ -45,33 +75,111 @@ export AGENT_VISION_MODEL="your-vision-model"
 | `AGENT_VISION_BASE_URL` | `VISION_BASE_URL` → `OPENAI_BASE_URL` |
 | `AGENT_VISION_MODEL` | `VISION_MODEL` → `OPENAI_MODEL` |
 
-可选变量：
+### 生图配置
+
+在同一个 `settings.json` 中添加 `generationProviders`，字段与识图的 `providers`
+类似，额外通过 `type` 选择生图协议；也可以只配置生图，不配置识图：
+
+```json
+{
+  "generationProviders": [
+    {
+      "name": "image-api",
+      "type": "openai-images",
+      "baseUrl": "https://your-image-api.example/v1",
+      "apiKey": "sk-...",
+      "models": ["your-image-generation-model"]
+    }
+  ]
+}
+```
+
+- 识图与生图模型完全分开，不会把视觉聊天模型自动当作生图模型。
+- `type` 支持 `openai-images`（默认，兼容旧配置）和 `volcengine-ark`。按显式协议适配请求，不根据域名或模型名称猜测；未知类型会报配置错误。
+- `generationProviders` 内按 provider、model 的配置顺序依次尝试，拿到第一张有效图片就停止，**不并发竞速**。失败回退仍可能产生多次费用（例如上游超时但实际已完成生成）；只想调用一个模型时配置一个 target。
+- 每次只生成一张图片；目前支持文生图，不包含参考图编辑或异步任务轮询。
+- 两种协议均支持 `data[0].b64_json` 或 `data[0].url` 返回。`openai-images` 省略 `response_format`，避免不支持该参数的模型报错；`volcengine-ark` 请求 base64 返回。参考 [OpenAI 官方 Images API 文档](https://developers.openai.com/api/reference/resources/images/methods/generate)。
+- 与识图共用顶层 `timeoutMs`、`maxImageMb`、`headers`、`allowPrivateUrls`，生图较慢时可调高 `timeoutMs`。
+- `doctor` 会分别列出识图和生图 targets，并显示生图协议，只配置生图时不要求 ffmpeg。
+
+#### 火山引擎方舟（Seedream）
+
+在已有配置中加入下面的生图部分即可，保留原来的 `providers`：
+
+```json
+{
+  "generationProviders": [
+    {
+      "name": "volcengine",
+      "type": "volcengine-ark",
+      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
+      "apiKey": "你的方舟 API Key",
+      "models": ["doubao-seedream-5-0-lite-260128"]
+    }
+  ]
+}
+```
+
+`models` 填写你已开通的 Seedream Model ID，也支持配置了生图模型的 `ep-...` 接入点 ID。
+`apiKey` 可省略并从 `ARK_API_KEY` 读取；若设置了 `AGENT_VISION_GENERATION_API_KEY`，则后者优先。
+方舟不会自动继承识图的 `AGENT_VISION_API_KEY` / `OPENAI_API_KEY`，避免把其他服务的 key 发给火山。
+
+```bash
+npx -y @yanickxia/agent-vision generate \
+  --prompt "一只坐在窗边的橘猫，水彩风格" --output ./cat.jpg --size 2K
+```
+
+- 使用方舟原生 `/api/v3/images/generations` 参数，不发送 OpenAI 的 `n` 或 `quality`；传 `--quality` 会在调用前报错，不静默忽略。
+- `--size` 可用模型支持的分辨率档位（例如 `2K`）或 `宽x高`，省略时采用模型默认值。
+- 保持服务端的单图、非流式默认行为，不发送部分 Seedream 模型不支持的组图/流式开关。
+- 保留模型默认水印和输出格式；Seedream 通常返回 JPEG，文件扩展名不会触发转码。
+- 能解析火山的 HTTP 错误及成功 HTTP 响应中的顶层/单图错误，保留错误码与消息。
+
+协议依据：[方舟官方图片生成 API](https://ark.volcengine.com/region:cn-beijing/docs/image-generation-api.md)。
+本适配针对**方舟 Seedream 文生图**，不是“视觉智能／即梦”的 AK/SK 签名接口，不包含图生图、组图或图层拆分。
+
+#### 生图环境变量
+
+也可以用环境变量配置生图：
+
+| 变量 | 回退 / 说明 |
+|---|---|
+| `AGENT_VISION_GENERATION_TYPE` | 默认 `openai-images`；火山方舟设为 `volcengine-ark` |
+| `AGENT_VISION_GENERATION_MODEL` | 生图模型名称，必须显式设置；不回退到识图模型 |
+| `AGENT_VISION_GENERATION_BASE_URL` | OpenAI 协议回退到识图 URL 及其别名；方舟协议默认 `https://ark.cn-beijing.volces.com/api/v3`，不继承识图 URL |
+| `AGENT_VISION_GENERATION_API_KEY` | OpenAI 协议回退到识图 key 及其别名；方舟协议回退到 `ARK_API_KEY` |
+| `ARK_API_KEY` | 仅用于 `volcengine-ark` 的 key 回退 |
+| `AGENT_VISION_GENERATION_HEADERS` | 生图专用额外请求头 JSON，覆盖通用环境变量请求头 |
+
+文件中 `generationProviders` 优先于环境变量生图 target；provider 的 `apiKey`
+省略时使用上述生图 key 回退，显式 `"apiKey": ""` 可关闭 key 回退。
+文件内未指定 `type` 的 provider 始终是 `openai-images`，不受环境变量的 `TYPE` 影响。
+请求头优先级：通用环境变量 → 生图环境变量 → 文件顶层 → provider。
+
+### 通用选项
+
+以下可选变量与对应的配置文件字段等价：
 
 | 变量 | 默认值 | 说明 |
 |---|---:|---|
 | `AGENT_VISION_MAX_TOKENS` | `4096` | 最大输出 tokens |
 | `AGENT_VISION_TIMEOUT_MS` | `120000` | 下载和 API 超时 |
-| `AGENT_VISION_MAX_IMAGE_MB` | `20` | 图片大小上限 |
+| `AGENT_VISION_MAX_IMAGE_MB` | `20` | 输入和生成图片的大小上限 |
 | `AGENT_VISION_MAX_VIDEO_MB` | `200` | 视频大小上限 |
 | `AGENT_VISION_HEADERS` | `{}` | 额外请求头 JSON |
-| `AGENT_VISION_ALLOW_PRIVATE_URLS` | `false` | 允许私网图片/视频来源 URL |
+| `AGENT_VISION_ALLOW_PRIVATE_URLS` | `false` | 允许私网图片/视频来源及生图结果 URL |
 | `AGENT_VISION_FFMPEG_PATH` | 自动发现 | 指定 ffmpeg 可执行文件；默认先用 PATH，再用 npm 内置版本 |
 
 ## MCP 安装
 
-### npm（发布后推荐）
+### npm（推荐）
 
 ```json
 {
   "mcpServers": {
     "agent-vision": {
       "command": "npx",
-      "args": ["-y", "@yanickxia/agent-vision"],
-      "env": {
-        "AGENT_VISION_BASE_URL": "https://your-endpoint.example/v1",
-        "AGENT_VISION_API_KEY": "your-key",
-        "AGENT_VISION_MODEL": "your-vision-model"
-      }
+      "args": ["-y", "@yanickxia/agent-vision"]
     }
   }
 }
@@ -84,17 +192,15 @@ export AGENT_VISION_MODEL="your-vision-model"
   "mcpServers": {
     "agent-vision": {
       "command": "npx",
-      "args": ["-y", "github:yanickxia/agent-vision"],
-      "env": {
-        "AGENT_VISION_BASE_URL": "https://your-endpoint.example/v1",
-        "AGENT_VISION_API_KEY": "your-key",
-        "AGENT_VISION_MODEL": "your-vision-model"
-      }
+      "args": ["-y", "github:yanickxia/agent-vision"]
     }
   }
 }
 ```
 
+无需 env 块：配置从 `~/.config/agent-vision/settings.json` 读取（见上文「配置」）。
+也可以继续用环境变量，在 `env` / `environment` 块里传入。
+
 Claude Desktop、Claude Code、Cursor、Cline 等使用上面的标准
 `mcpServers` 格式。
 
@@ -106,12 +212,7 @@ Claude Desktop、Claude Code、Cursor、Cline 等使用上面的标准
     "agent-vision": {
       "type": "local",
       "command": ["npx", "-y", "@yanickxia/agent-vision"],
-      "enabled": true,
-      "environment": {
-        "AGENT_VISION_BASE_URL": "https://your-endpoint.example/v1",
-        "AGENT_VISION_API_KEY": "your-key",
-        "AGENT_VISION_MODEL": "your-vision-model"
-      }
+      "enabled": true
     }
   }
 }
@@ -123,9 +224,22 @@ Claude Desktop、Claude Code、Cursor、Cline 等使用上面的标准
 npx skills add yanickxia/agent-vision --skill agent-vision -g -y
 ```
 
-也可以复制 `skills/agent-vision/` 到 Agent 的 skills 目录。Skill 负责告诉
-Agent 何时调用图片/视频工具、如何传参和如何处理失败；MCP 负责实际读取文件、
-抽帧和请求模型。
+也可以复制 `skills/agent-vision/` 到 Agent 的 skills 目录。Skill 是能力自适应
+的：Agent 自己能看图就直接看；看不了（或输入是视频）就由 Skill 指导 Agent
+直接跑 CLI 完成分析。生图不受「能否看图」限制，任何 Agent 都可以使用。
+
+**MCP 和 Skill/CLI 都支持火山方舟生图**，共用同一份 `settings.json` 中的
+`generationProviders` 配置。Skill 直接执行 CLI，不依赖启动或安装 MCP Server。
+
+| 入口 | 调用 | 输出 |
+|---|---|---|
+| MCP | `generate_image`，传 `prompt`、可选 `size` / `output_path` | 图片内容和元数据，可选保存文件 |
+| Skill / CLI | `agent-vision generate --prompt ... --output ...` | 保存文件，stdout 返回绝对路径 |
+
+从源码使用尚未发布的功能时，先在仓库中运行 `npm run build`，然后用
+`node /绝对路径/agent-vision/dist/cli.js generate ...` 运行 CLI。
+本地 MCP 配置也可使用 `command: "node"`、`args: ["/绝对路径/agent-vision/dist/cli.js"]`，
+不要加 `generate` 参数，无子命令时即启动 MCP stdio 服务。
 
 ## CLI
 
@@ -136,9 +250,18 @@ npx -y @yanickxia/agent-vision image ./screenshot.png \
 npx -y @yanickxia/agent-vision video ./demo.mp4 \
   --prompt "按时间顺序总结 UI 操作" --frames 8
 
+npx -y @yanickxia/agent-vision generate \
+  --prompt "一只坐在窗边的橘猫，水彩风格" --output ./cat.png --size 1024x1024
+
 npx -y @yanickxia/agent-vision doctor
 ```
 
+`generate` 必须提供 `--prompt`（或一个带引号的位置参数）和 `--output`。
+可选 `--size` 原样传给生图 API；`--quality` 仅用于 OpenAI-compatible 协议。
+省略时采用 provider 默认值，支持值取决于模型。
+输出文件的父目录必须存在，已有文件不会被覆盖；成功时 stdout 输出保存的绝对路径。
+图片保留 API 返回的实际格式，不会因输出文件的扩展名而转码。
+
 ## MCP 工具
 
 ### `analyze_image`
@@ -166,12 +289,28 @@ npx -y @yanickxia/agent-vision doctor
 `max_frames` 范围 1–16，默认 8。实现会均匀抽取 JPEG 帧，并带时间点一起发给
 模型。它不是逐帧转写，快速变化可能被漏掉。
 
+### `generate_image`
+
+```json
+{
+  "prompt": "一只坐在窗边的橘猫，水彩风格",
+  "output_path": "/absolute/path/to/cat.png",
+  "size": "1024x1024"
+}
+```
+
+只有 `prompt` 必填。`output_path` 可选，不传时仅返回 MCP 图片内容，不写本地文件。
+`size`、`quality` 可选。返回一个 text 内容块（JSON 元数据：模型、MIME 类型、字节数、
+可选输出路径和上游改写的 prompt）以及一个 image 内容块。路径是 MCP Server 所在机器上的路径。
+
 ## 隐私与安全
 
 - 图片会发送到你配置的视觉 API。
+- 生图 prompt 会发送到你配置的生图 API；如果上游返回图片 URL，会下载该图片，但不会向图片下载地址转发生图 API key 或自定义请求头。
 - 视频不会整体发给模型；远程视频先下载到本地临时目录，然后只发送抽出的 JPEG 帧。
 - 临时目录在成功或失败后都会删除。
-- 用户提供的远程图片/视频 URL 默认拒绝 localhost、私网、链路本地和云元数据地址。
+- 用户提供的远程图片/视频 URL 和上游返回的生图 URL 默认拒绝 localhost、私网、链路本地和云元数据地址。
+- 生图失败会删除本次预留的输出文件；成功的生图文件会保留，不会作为临时文件清理。
 - stdio 模式不向 stdout 写日志，避免破坏 MCP 协议。
 
 ## 开发

package/dist/analyze.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAS/E,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ5B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe5B"}
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,EAAyB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAS7E,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAQ5B;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAe5B"}

package/dist/analyze.js

@@ -1,13 +1,13 @@
 import { loadConfig } from "./config.js";
 import { loadImage } from "./image.js";
-import { requestVisionCompletion } from "./provider.js";
+import { raceVisionCompletions } from "./provider.js";
 import { extractVideoFrames } from "./video.js";
 const DEFAULT_IMAGE_PROMPT = "Describe this image accurately. Include visible text, layout, objects, colors, and details relevant to understanding it. Do not invent details that are not visible.";
 const DEFAULT_VIDEO_PROMPT = "Analyze these evenly sampled video frames as one timeline. Describe the sequence of events, scene or UI changes, actions, and visible text. Distinguish observations from uncertainty.";
 export async function analyzeImage(options) {
     const config = options.config ?? loadConfig();
     const image = await loadImage(options.source, config);
-    return requestVisionCompletion({
+    return raceVisionCompletions({
         config,
         prompt: options.prompt?.trim() || DEFAULT_IMAGE_PROMPT,
         images: [{ dataUrl: image.dataUrl, label: image.label }],
@@ -21,7 +21,7 @@ export async function analyzeVideo(options) {
         config,
     });
     const userPrompt = options.prompt?.trim();
-    return requestVisionCompletion({
+    return raceVisionCompletions({
         config,
         prompt: userPrompt
             ? `${DEFAULT_VIDEO_PROMPT}\n\nUser question: ${userPrompt}`

package/dist/analyze.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,uBAAuB,EAAyB,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,oBAAoB,GACxB,sKAAsK,CAAC;AAEzK,MAAM,oBAAoB,GACxB,wLAAwL,CAAC;AAE3L,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAIlC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,uBAAuB,CAAC;QAC7B,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,oBAAoB;QACtD,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,MAAM;KACP,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,OAAO,uBAAuB,CAAC;QAC7B,MAAM;QACN,MAAM,EAAE,UAAU;YAChB,CAAC,CAAC,GAAG,oBAAoB,sBAAsB,UAAU,EAAE;YAC3D,CAAC,CAAC,oBAAoB;QACxB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../src/analyze.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,qBAAqB,EAAyB,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,oBAAoB,GACxB,sKAAsK,CAAC;AAEzK,MAAM,oBAAoB,GACxB,wLAAwL,CAAC;AAE3L,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAIlC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,qBAAqB,CAAC;QAC3B,MAAM;QACN,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,oBAAoB;QACtD,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC;KACzD,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,OAKlC;IACC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,UAAU,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC;QACjC,MAAM;KACP,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IAC1C,OAAO,qBAAqB,CAAC;QAC3B,MAAM;QACN,MAAM,EAAE,UAAU;YAChB,CAAC,CAAC,GAAG,oBAAoB,sBAAsB,UAAU,EAAE;YAC3D,CAAC,CAAC,oBAAoB;QACxB,MAAM,EAAE,MAAM;KACf,CAAC,CAAC;AACL,CAAC"}

package/dist/cli.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
+import { parseArgs } from "node:util";
 import { analyzeImage, analyzeVideo } from "./analyze.js";
 import { loadConfig } from "./config.js";
 import { errorMessage } from "./errors.js";
+import { generateImage } from "./generate.js";
 import { SERVER_VERSION, startStdioServer } from "./server.js";
 import { ensureFfmpeg } from "./video.js";
 const HELP = `agent-vision ${SERVER_VERSION}
@@ -10,11 +12,15 @@ Usage:
   agent-vision                         Start the MCP stdio server
   agent-vision image <source> [options]
   agent-vision video <source> [options]
+  agent-vision generate --prompt <text> --output <path> [options]
   agent-vision doctor
 
 Options:
-  -p, --prompt <text>                  Question or focus for the analysis
+  -p, --prompt <text>                  Analysis question or image generation prompt
   --frames <1-16>                      Video frames to sample (default: 8)
+  -o, --output <path>                  Save generated image (must not exist)
+  --size <value>                       Generation size, e.g. 1024x1024 or Ark 2K
+  --quality <value>                    OpenAI-compatible quality (not supported by Ark)
   -h, --help                           Show help
   -v, --version                        Show version
 `;
@@ -44,22 +50,72 @@ async function runCli(args) {
         const config = loadConfig();
         let ffmpeg = "unavailable";
         try {
-            ffmpeg = await ensureFfmpeg();
+            ffmpeg = await ensureFfmpeg(config.ffmpegPath);
         }
         catch {
             // Report below without failing before the full doctor output is printed.
         }
-        const report = [
-            `model: ${config.model || "missing"}`,
-            `base URL: ${config.baseUrl}`,
-            `API key: ${config.apiKey ? "configured" : "not configured (allowed for local endpoints)"}`,
-            `ffmpeg: ${ffmpeg}`,
+        const lines = [
+            `config file: ${config.configFile ?? "not found (using environment variables)"}`,
         ];
-        process.stdout.write(`${report.join("\n")}\n`);
-        if (!config.model || ffmpeg === "unavailable")
+        if (config.targets.length === 0) {
+            lines.push("targets: none configured");
+        }
+        else {
+            lines.push("targets:");
+            config.targets.forEach((target, index) => {
+                lines.push(`  ${index + 1}. ${target.label}  ${target.baseUrl}  key: ${target.apiKey ? "configured" : "not configured"}`);
+            });
+        }
+        if (config.generationTargets.length === 0) {
+            lines.push("generation targets: none configured (optional)");
+        }
+        else {
+            lines.push("generation targets (sequential fallback):");
+            config.generationTargets.forEach((target, index) => {
+                lines.push(`  ${index + 1}. ${target.label}  ${target.baseUrl}  key: ${target.apiKey ? "configured" : "not configured"}  type: ${target.type ?? "openai-images"}`);
+            });
+        }
+        lines.push(`ffmpeg: ${ffmpeg}`);
+        process.stdout.write(`${lines.join("\n")}\n`);
+        if ((config.targets.length === 0 && config.generationTargets.length === 0) ||
+            (config.targets.length > 0 && ffmpeg === "unavailable"))
             process.exitCode = 1;
         return;
     }
+    if (command === "generate") {
+        const { values, positionals } = parseArgs({
+            args: args.slice(1),
+            allowPositionals: true,
+            options: {
+                prompt: { type: "string", short: "p" },
+                output: { type: "string", short: "o" },
+                size: { type: "string" },
+                quality: { type: "string" },
+                help: { type: "boolean", short: "h" },
+            },
+        });
+        if (values.help) {
+            process.stdout.write(HELP);
+            return;
+        }
+        if (positionals.length > 1 || (positionals.length > 0 && values.prompt !== undefined)) {
+            throw new Error("generate accepts one prompt, either positional or via --prompt");
+        }
+        const prompt = values.prompt ?? positionals[0];
+        if (!prompt?.trim())
+            throw new Error("generate requires --prompt <text>");
+        if (!values.output?.trim())
+            throw new Error("generate requires --output <path>");
+        const result = await generateImage({
+            prompt,
+            outputPath: values.output,
+            ...(values.size !== undefined ? { size: values.size } : {}),
+            ...(values.quality !== undefined ? { quality: values.quality } : {}),
+        });
+        process.stdout.write(`${result.outputPath}\n`);
+        return;
+    }
     if (command !== "image" && command !== "video") {
         throw new Error(`Unknown command: ${command}\n\n${HELP}`);
     }

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -1,17 +1,31 @@
-export interface VisionConfig {
-    apiKey?: string;
-    baseUrl: string;
+export interface ModelTarget {
+    label: string;
     model: string;
+    baseUrl: string;
+    apiKey?: string;
+    headers: Record<string, string>;
+}
+export type GenerationProviderType = "openai-images" | "volcengine-ark";
+export interface GenerationTarget extends ModelTarget {
+    type?: GenerationProviderType;
+}
+export declare const VOLCENGINE_ARK_BASE_URL = "https://ark.cn-beijing.volces.com/api/v3";
+export interface VisionConfig {
+    targets: ModelTarget[];
+    generationTargets: GenerationTarget[];
+    configFile?: string;
     maxTokens: number;
     timeoutMs: number;
     headers: Record<string, string>;
     maxImageBytes: number;
     maxVideoBytes: number;
     allowPrivateUrls: boolean;
+    ffmpegPath?: string;
 }
 type Environment = Record<string, string | undefined>;
-export declare function loadConfig(env?: Environment): VisionConfig;
-export declare function requireModel(config: VisionConfig): void;
+export type SettingsReader = (filePath: string) => string | undefined;
+export declare function loadConfig(env?: Environment, readSettings?: SettingsReader): VisionConfig;
 export declare function chatCompletionsUrl(baseUrl: string): string;
+export declare function imageGenerationsUrl(baseUrl: string): string;
 export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAgDtD,wBAAgB,UAAU,CAAC,GAAG,GAAE,WAAyB,GAAG,YAAY,CAiCvE;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAOvD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqB1D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAExE,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IAEnD,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B;AAED,eAAO,MAAM,uBAAuB,6CAA6C,CAAC;AAElF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0BD,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;AAmOtE,wBAAgB,UAAU,CACxB,GAAG,GAAE,WAAyB,EAC9B,YAAY,GAAE,cAAsC,GACnD,YAAY,CAsId;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3D"}