@mindscraft/branch-video-agent-cli 0.3.2 → 0.3.4

package/README.md

@@ -140,6 +140,23 @@ AI Gateway 视频生成并等待示例：
 '@ | 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) {
@@ -97,6 +130,26 @@ async function getMusicStatus(context, operation, id) {
         query: { id },
     });
 }
+async function createSeedAudio(context) {
+    const result = await context.client.request('/api/agent/ai-gateway/tts/create', {
+        method: 'POST',
+        body: context.payload,
+    });
+    if (!context.flags.wait) {
+        return { data: result.data, requestId: result.requestId };
+    }
+    const taskId = extractTaskId(result.data);
+    const query = pickDefined(context.payload, ['model']);
+    return waitForGatewayTask(context, result.data, () => context.client.request(`/api/agent/ai-gateway/tts/query/${encodeURIComponent(taskId)}`, { method: 'GET', query }));
+}
+async function getSeedAudio({ client, payload }) {
+    const taskId = getRequiredString(payload, 'taskId');
+    const result = await client.request(`/api/agent/ai-gateway/tts/query/${encodeURIComponent(taskId)}`, {
+        method: 'GET',
+        query: pickDefined(payload, ['model']),
+    });
+    return { data: result.data, requestId: result.requestId };
+}
 export const aiGatewayCommands = {
     capabilities: async ({ client }) => {
         const result = await client.request('/api/agent/ai-gateway/capabilities', {
@@ -153,6 +206,10 @@ export const aiGatewayCommands = {
         });
         return { data: result.data, requestId: result.requestId };
     },
+    'seed-audio-create': createSeedAudio,
+    'seed-audio-get': getSeedAudio,
+    'tts-create': createSeedAudio,
+    'tts-get': getSeedAudio,
     'music-submit': async (context) => {
         const operation = normalizeOperation(getRequiredString(context.payload, 'operation'));
         const body = context.payload.body === undefined
@@ -167,7 +224,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');
@@ -176,6 +244,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/dist/lib/flags.js

@@ -100,7 +100,7 @@ export function getCliHelpText() {
         '  agent-production create | status | cancel | finalize | autopilot-binding | events | metrics | multica-comment-payload | node claim|inputs|complete|submit|block|fail|retry|expire | blocker resolve | artifact submit|list | asset-job poll|retry|revise|attach-artifact|fail | gate evaluate|results',
         '  aihub-production schema | start | status | retry',
         '  character  search | create | get',
-        '  ai-gateway capabilities | request | image-generate | image-edit | video-create | video-get | music-submit | music-get',
+        '  ai-gateway capabilities | request | image-generate | image-edit | video-create | video-get | seed-audio-create | seed-audio-get | music-submit | music-get | tts-create | tts-get',
         '',
         'Config precedence:',
         '  AIHUB_AGENT_TOKEN / BRANCH_VIDEO_AGENT_BASE_URL > stdin JSON or --token-file > command flags',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindscraft/branch-video-agent-cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Published CLI for branch-video and AIHub agent APIs.",
   "type": "module",
   "bin": {
@@ -33,4 +33,4 @@
     "prepack": "npm run build",
     "smoke:help": "npm run build && node dist/bin.js --help"
   }
-}
+}