@mindscraft/branch-video-agent-cli 0.3.3 → 0.3.5

package/README.md

@@ -116,7 +116,7 @@ AIHub 导入公共库示例：
 
 `character search` 只返回已经人工添加 `accepted_for_reuse` 标签的角色资产；新入库资产默认未验收，需要在角色资产库页面验收后才会被 Agent 二次复用。
 
-AI Gateway 图片生成示例：
+AI Gateway 图片生成示例：
 
 ```powershell
 @'
@@ -124,40 +124,56 @@ AI Gateway 图片生成示例：
   "model": "doubao-seedream-5-0-260128",
   "prompt": "3D 卡通风格，穿白大褂的喵星人科学老师在实验室讲解电路"
 }
-'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway image-generate -- --raw
-```
-
-AI Gateway 视频生成并等待示例：
-
-```powershell
-@'
-{
-  "model": "doubao-seedance-2-0-260128",
-  "input": {
-    "prompt": "镜头推进到实验台，卡通猫老师点亮一个小灯泡"
-  }
-}
-'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway video-create -- --wait --raw
+'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway image-generate -- --raw
 ```
 
-AI Gateway Seed Audio 音频生成并等待示例：
+AI Gateway Banana Pro 同步生成示例（实际模型值为 `gemini-3-pro-image-preview`）：
 
 ```powershell
 @'
 {
-  "model": "seed-audio-1.0",
-  "text_prompt": "温柔的女声朗读：欢迎使用豆包语音合成服务。背景加入轻柔科技感铺底音乐。",
-  "audio_config": {
-    "format": "mp3",
-    "sample_rate": 24000
-  }
+  "model": "gemini-3-pro-image-preview",
+  "prompt": "一幅写实风格的山水画，远处有云雾缭绕的山峰",
+  "size": "16:9",
+  "image_size_ratios": "2K",
+  "output_format": "image/png"
 }
-'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway seed-audio-create -- --wait --raw
+'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway image-generate -- --raw
 ```
 
-`tts-create` / `tts-get` 是 Seed Audio 的历史兼容别名；新脚本优先使用 `seed-audio-create` / `seed-audio-get`。
-
-## 在仓库内构建发布包
+Banana Pro 图片编辑继续使用 `ai-gateway image-edit`，请求体为 JSON，`image` 是 HTTP(S) URL 字符串数组；GPT Image 2 编辑仍使用 multipart 文件描述。Banana Pro 当前只支持同步调用，不使用 `--wait`。响应通常包含 `data[].b64_json`，不要把完整 base64 写进 Agent 回复或持久化日志。
+
+AI Gateway 视频生成并等待示例：
+
+```powershell
+@'
+{
+  "model": "doubao-seedance-2-0-260128",
+  "input": {
+    "prompt": "镜头推进到实验台，卡通猫老师点亮一个小灯泡"
+  }
+}
+'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway video-create -- --wait --raw
+```
+
+AI Gateway Seed Audio 音频生成并等待示例：
+
+```powershell
+@'
+{
+  "model": "seed-audio-1.0",
+  "text_prompt": "温柔的女声朗读：欢迎使用豆包语音合成服务。背景加入轻柔科技感铺底音乐。",
+  "audio_config": {
+    "format": "mp3",
+    "sample_rate": 24000
+  }
+}
+'@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway seed-audio-create -- --wait --raw
+```
+
+`tts-create` / `tts-get` 是 Seed Audio 的历史兼容别名；新脚本优先使用 `seed-audio-create` / `seed-audio-get`。
+
+## 在仓库内构建发布包
 
 从仓库根目录执行：
 

package/dist/commands/aiGateway.js

@@ -43,6 +43,39 @@ function extractFailureMessage(value) {
         || record.error
         || 'AI Gateway task failed');
 }
+function isJsonRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function isHttpUrl(value) {
+    return typeof value === 'string' && /^https?:\/\//i.test(value);
+}
+function extractMusicAudioUrl(value) {
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            const audioUrl = extractMusicAudioUrl(item);
+            if (audioUrl)
+                return audioUrl;
+        }
+        return '';
+    }
+    if (!isJsonRecord(value))
+        return '';
+    for (const key of ['audioUrl', 'streamAudioUrl']) {
+        if (isHttpUrl(value[key]))
+            return String(value[key]);
+    }
+    for (const item of Object.values(value)) {
+        const audioUrl = extractMusicAudioUrl(item);
+        if (audioUrl)
+            return audioUrl;
+    }
+    return '';
+}
+function withStableMusicAudioUrl(data, audioUrl) {
+    return isJsonRecord(data)
+        ? { ...data, audioUrl }
+        : { status: data, audioUrl };
+}
 async function waitForGatewayTask(context, submit, poll) {
     const startedAt = context.runtime.now();
     while (context.runtime.now() - startedAt <= context.flags.timeoutMs) {
@@ -65,6 +98,8 @@ async function waitForGatewayTask(context, submit, poll) {
     throw new CliCommandError('AI Gateway wait timed out', 'TIMEOUT', { submit });
 }
 function normalizeImageEditPayload(payload) {
+    if (payload.model === 'gemini-3-pro-image-preview')
+        return payload;
     if (payload.fields || payload.files)
         return payload;
     const files = {};
@@ -191,7 +226,18 @@ export const aiGatewayCommands = {
         }
         const taskId = extractTaskId(result.data);
         const queryOperation = normalizeOperation(getOptionalString(context.payload, 'queryOperation') || inferMusicQueryOperation(operation));
-        return waitForGatewayTask(context, result.data, () => getMusicStatus(context, queryOperation, taskId));
+        const waitResult = await waitForGatewayTask(context, result.data, () => getMusicStatus(context, queryOperation, taskId));
+        if (queryOperation !== 'query')
+            return waitResult;
+        const statusData = isJsonRecord(waitResult.data) ? waitResult.data.status : undefined;
+        const audioUrl = extractMusicAudioUrl(statusData);
+        if (!audioUrl) {
+            throw new CliCommandError('AI Gateway music task completed without an audio URL', 'VALIDATION_ERROR', waitResult.data, waitResult.requestId || null);
+        }
+        return {
+            ...waitResult,
+            data: withStableMusicAudioUrl(waitResult.data, audioUrl),
+        };
     },
     'music-get': async ({ client, payload }) => {
         const id = getRequiredString(payload, 'id');
@@ -200,6 +246,14 @@ export const aiGatewayCommands = {
             method: 'GET',
             query: { id },
         });
+        const status = extractStatus(result.data);
+        const audioUrl = extractMusicAudioUrl(result.data);
+        if (gatewaySuccessStatuses.has(status) && operation === 'query' && !audioUrl) {
+            throw new CliCommandError('AI Gateway music task completed without an audio URL', 'VALIDATION_ERROR', result.data, result.requestId);
+        }
+        if (audioUrl) {
+            return { data: withStableMusicAudioUrl(result.data, audioUrl), requestId: result.requestId };
+        }
         return { data: result.data, requestId: result.requestId };
     },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindscraft/branch-video-agent-cli",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "Published CLI for branch-video and AIHub agent APIs.",
   "type": "module",
   "bin": {