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

package/README.md

@@ -10,12 +10,6 @@
 npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help
 ```
 
-中国大陆用户如果希望更稳定、更快地安装，可以走 npm 的公开镜像：
-
-```powershell
-npm exec --yes --registry=https://registry.npmmirror.com --package=@mindscraft/branch-video-agent-cli branch-video-agent -- --help
-```
-
 如果你更喜欢简写，从 `0.1.2` 开始也支持：
 
 ```powershell
@@ -25,10 +19,13 @@ npx -y @mindscraft/branch-video-agent-cli --help
 也可以全局安装：
 
 ```powershell
-npm install -g @mindscraft/branch-video-agent-cli
+npm install -g @mindscraft/branch-video-agent-cli@latest --registry=https://registry.npmjs.org/
 branch-video-agent --help
+branch-video-agent --version
 ```
 
+从 `0.3.6` 开始，发布版 CLI 在每次执行命令前查询 npm 官方 registry 的 `latest`，发现新版本时先全局安装该精确版本，再用原参数重新执行命令。registry 查询或安装失败时命令会 fail closed，不会继续提交业务请求。仅在明确接受旧版风险的紧急诊断中设置 `BRANCH_VIDEO_AGENT_DISABLE_AUTO_UPDATE=1` 跳过检查。
+
 环境变量：
 
 - `AIHUB_AGENT_TOKEN`
@@ -127,6 +124,22 @@ AI Gateway 图片生成示例：
 '@ | npm exec --yes --package=@mindscraft/branch-video-agent-cli branch-video-agent -- ai-gateway image-generate -- --raw
 ```
 
+AI Gateway Banana Pro 同步生成示例（实际模型值为 `gemini-3-pro-image-preview`）：
+
+```powershell
+@'
+{
+  "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 image-generate -- --raw
+```
+
+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

package/dist/bin.js

@@ -1,3 +1,23 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { main } from './index.js';
-process.exitCode = await main(process.argv.slice(2));
+import { autoUpdateAndReexec } from './lib/autoUpdate.js';
+const packageJson = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+const argv = process.argv.slice(2);
+const update = await autoUpdateAndReexec({
+    currentVersion: packageJson.version,
+    argv,
+    executablePath: process.argv[1],
+    env: process.env,
+    platform: process.platform,
+    writeStderr: (text) => process.stderr.write(text),
+});
+if (update.handled) {
+    process.exitCode = update.exitCode;
+}
+else if (argv.length === 1 && ['--version', '-v'].includes(argv[0])) {
+    process.stdout.write(`${packageJson.version}\n`);
+}
+else {
+    process.exitCode = await main(argv);
+}

package/dist/commands/aiGateway.js

@@ -98,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 = {};

package/dist/lib/autoUpdate.d.ts

@@ -0,0 +1,26 @@
+export interface AutoUpdateRunResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+}
+export interface AutoUpdateRunOptions {
+    env?: Record<string, string | undefined>;
+    inheritStdio?: boolean;
+    timeoutMs?: number;
+}
+export type AutoUpdateRunner = (command: string, args: string[], options?: AutoUpdateRunOptions) => Promise<AutoUpdateRunResult>;
+export interface AutoUpdateOptions {
+    currentVersion: string;
+    argv: string[];
+    executablePath: string;
+    env: Record<string, string | undefined>;
+    platform: NodeJS.Platform;
+    run?: AutoUpdateRunner;
+    writeStderr: (text: string) => void;
+}
+export interface AutoUpdateResult {
+    handled: boolean;
+    exitCode: number;
+    latestVersion: string;
+}
+export declare function autoUpdateAndReexec(options: AutoUpdateOptions): Promise<AutoUpdateResult>;

package/dist/lib/autoUpdate.js

@@ -0,0 +1,90 @@
+import { spawnSync } from 'node:child_process';
+const PACKAGE_NAME = '@mindscraft/branch-video-agent-cli';
+const OFFICIAL_REGISTRY = 'https://registry.npmjs.org/';
+const REEXEC_ENV = 'BRANCH_VIDEO_AGENT_AUTO_UPDATE_REEXEC';
+const DISABLE_ENV = 'BRANCH_VIDEO_AGENT_DISABLE_AUTO_UPDATE';
+function runProcess(command, args, options) {
+    const result = spawnSync(command, args, {
+        encoding: 'utf8',
+        env: options?.env,
+        stdio: options?.inheritStdio ? 'inherit' : 'pipe',
+        timeout: options?.timeoutMs,
+    });
+    return Promise.resolve({
+        status: result.status,
+        stdout: result.stdout || '',
+        stderr: result.stderr || '',
+    });
+}
+function failedResult(options, message, latestVersion) {
+    options.writeStderr(`[branch-video-agent] ${message}\n`);
+    return { handled: true, exitCode: 1, latestVersion };
+}
+function compareVersions(left, right) {
+    const [leftCore, leftPrerelease] = left.split('-', 2);
+    const [rightCore, rightPrerelease] = right.split('-', 2);
+    const leftParts = leftCore.split('.').map(Number);
+    const rightParts = rightCore.split('.').map(Number);
+    for (let index = 0; index < 3; index += 1) {
+        const difference = leftParts[index] - rightParts[index];
+        if (difference !== 0)
+            return difference;
+    }
+    if (leftPrerelease === rightPrerelease)
+        return 0;
+    if (!leftPrerelease)
+        return 1;
+    if (!rightPrerelease)
+        return -1;
+    return leftPrerelease.localeCompare(rightPrerelease);
+}
+export async function autoUpdateAndReexec(options) {
+    if (options.env[DISABLE_ENV] === '1' || options.env[REEXEC_ENV] === '1') {
+        return { handled: false, exitCode: 0, latestVersion: options.currentVersion };
+    }
+    const run = options.run || runProcess;
+    const npmCommand = options.platform === 'win32'
+        ? options.env.ComSpec || options.env.COMSPEC || 'cmd.exe'
+        : 'npm';
+    const npmArgsPrefix = options.platform === 'win32' ? ['/d', '/s', '/c', 'npm'] : [];
+    const viewResult = await run(npmCommand, [
+        ...npmArgsPrefix,
+        'view',
+        `${PACKAGE_NAME}@latest`,
+        'version',
+        '--registry',
+        OFFICIAL_REGISTRY,
+    ], { timeoutMs: 15_000 });
+    const latestVersion = viewResult.stdout.trim();
+    if (viewResult.status !== 0 || !/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(latestVersion)) {
+        return failedResult(options, `cannot verify ${PACKAGE_NAME}@latest from ${OFFICIAL_REGISTRY}; refusing to run an unverified CLI`, latestVersion || options.currentVersion);
+    }
+    if (compareVersions(latestVersion, options.currentVersion) <= 0) {
+        return { handled: false, exitCode: 0, latestVersion };
+    }
+    options.writeStderr(`[branch-video-agent] upgrading ${PACKAGE_NAME} ${options.currentVersion} -> ${latestVersion}\n`);
+    const installResult = await run(npmCommand, [
+        ...npmArgsPrefix,
+        'install',
+        '-g',
+        `${PACKAGE_NAME}@${latestVersion}`,
+        '--registry',
+        OFFICIAL_REGISTRY,
+    ], { inheritStdio: true, env: options.env, timeoutMs: 120_000 });
+    if (installResult.status !== 0) {
+        return failedResult(options, `automatic upgrade to ${latestVersion} failed; command was not executed`, latestVersion);
+    }
+    const childEnv = {
+        ...options.env,
+        [REEXEC_ENV]: '1',
+    };
+    const reexecResult = await run(process.execPath, [options.executablePath, ...options.argv], {
+        inheritStdio: true,
+        env: childEnv,
+    });
+    return {
+        handled: true,
+        exitCode: reexecResult.status ?? 1,
+        latestVersion,
+    };
+}

package/package.json

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