@mindscraft/branch-video-agent-cli 0.5.0 → 0.5.1

package/README.md

@@ -252,61 +252,61 @@ AI Gateway Seed Audio 音频生成并等待示例：
 '@ | 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`。
-
-## RPG2 生产工作台
-
-工作台 CLI 只提交调用方显式登记的项目、产物和归档清单；它不会扫描 RPG 阶段目录，也不会根据文件名推断版本关系。认证仍使用 `AIHUB_AGENT_TOKEN` 与 `BRANCH_VIDEO_AGENT_BASE_URL`，不要在 JSON、命令行或日志中保存 token。
-
-项目、生产记录和外部 CDN 产物可使用 JSON 文件提交：
-
-```powershell
-branch-video-agent workbench project create --file .\project.json --raw
-branch-video-agent workbench record put --project wb_project_id --file .\record.json --raw
-branch-video-agent workbench submit --file .\artifact-external.json --raw
-branch-video-agent workbench annotation put --project wb_project_id --file .\annotation.json --raw
-```
-
-同一产物用稳定的 `artifactKey` 和由流程侧持久维护的递增 `sourceRevision`。`idempotencyKey` 由流程侧保存并在重试时复用。已有持久媒体使用 `content.type: "external"`；本地文档、脱敏 session 或其他需要长期保存的文件使用 `content.type: "local"` 与 `sourcePath`。CLI 会先计算 SHA-256、声明 blob，再以原始二进制流上传；服务端只收到 blob 描述，绝不会收到本地路径。单文件上限为 64 MiB。
-
-```json
-{
-  "schemaVersion": "workbench.artifact/1",
-  "projectId": "wb_project_id",
-  "artifactKey": "document:director-program",
-  "sourceRevision": 2,
-  "idempotencyKey": "persisted-event-uuid",
-  "kind": "markdown",
-  "stageKey": "04",
-  "title": "导演稿",
-  "content": {
-    "type": "local",
-    "sourcePath": "C:/production/canonical/director.md",
-    "mime": "text/markdown"
-  },
-  "source": {
-    "productionRecordId": "record_id",
-    "archiveGeneration": 0,
-    "sourceSchema": "director-program/4"
-  }
-}
-```
-
-上传响应在网络中丢失时，CLI 会先查询同一个已声明 blob；ready 状态不会重传，也不会重新登记业务版本。失败交给流程侧持久待传队列用相同事件重试。
-
-`sync` 只读取 `--manifest` 中显式的 `items`。每个 item 为 `type: "artifact"`（默认）或 `type: "annotation"`，可直接携带提交字段或放进 `submission`；不会递归任何工作目录。
-
-```powershell
-branch-video-agent workbench sync --manifest .\.workbench\pending-items.json --raw
-branch-video-agent workbench archive prepare --manifest .\.workbench\archive-wrapper.json --raw
-branch-video-agent workbench archive finalize --project wb_project_id --record record_id --revision 1 --manifest-hash <sha256> --raw
-branch-video-agent workbench archive status --project wb_project_id --record record_id --raw
-branch-video-agent workbench archive download --project wb_project_id --record record_id --revision 1 --file .\entry.json --output .\session.jsonl.zst --raw
-```
-
-`archive prepare` 的文件是调用方维护的 wrapper：`{ manifest, manifestHash, expectedPreviousRevision }`；CLI 原样提交规范化清单和 hash。`archive finalize` 只校验已经提交的清单，不补扫文件。下载的 `entry.json` 至少包含 `{ "entryId": "..." }`；受权限保护的字节写入 `--output`，stdout 仍只输出 JSON 回执。
-
-`record put` 的路径参数是稳定的流程 `recordKey`，返回对象的 `id` 才是后续 `end-intent`、`reopen` 和所有 `archive` 命令使用的 `productionRecordId`（也可传给 `--record`）。不要把 `recordKey` 当成归档路由 ID。
+`tts-create` / `tts-get` 是 Seed Audio 的历史兼容别名；新脚本优先使用 `seed-audio-create` / `seed-audio-get`。
+
+## RPG2 生产工作台
+
+工作台 CLI 只提交调用方显式登记的项目、产物和归档清单；它不会扫描 RPG 阶段目录，也不会根据文件名推断版本关系。认证仍使用 `AIHUB_AGENT_TOKEN` 与 `BRANCH_VIDEO_AGENT_BASE_URL`，不要在 JSON、命令行或日志中保存 token。
+
+项目、生产记录和外部 CDN 产物可使用 JSON 文件提交：
+
+```powershell
+branch-video-agent workbench project create --file .\project.json --raw
+branch-video-agent workbench record put --project wb_project_id --file .\record.json --raw
+branch-video-agent workbench submit --file .\artifact-external.json --raw
+branch-video-agent workbench annotation put --project wb_project_id --file .\annotation.json --raw
+```
+
+同一产物用稳定的 `artifactKey` 和由流程侧持久维护的递增 `sourceRevision`。`idempotencyKey` 由流程侧保存并在重试时复用。已有持久媒体使用 `content.type: "external"`；本地文档、脱敏 session 或其他需要长期保存的文件使用 `content.type: "local"` 与 `sourcePath`。CLI 会先计算原文件 SHA-256、声明 blob，再流式 gzip 压缩上传（包括媒体与 session）。传输使用 `Content-Type: application/gzip` 和 `x-workbench-upload-format: gzip`，不使用 `Content-Encoding`；服务端流式解压后校验原始大小与 SHA-256，原 MIME、版本和幂等键不变，下载返回原文件字节。原文件上限为 64 MiB，压缩传输上限为 65 MiB。损坏、截断或超限上传不会成为 ready，CLI 不会自动回退 raw。CLI 生成单个 gzip member；服务端支持受限 gzip 字节流并统一校验解压后的总字节，无目录或多文件提取。服务端仍兼容未带传输标识的旧 raw 请求（原生 gzip 文件也保持原样）；部署时应先更新服务端再发布 CLI。服务端只收到 blob 描述，绝不会收到本地路径。
+
+```json
+{
+  "schemaVersion": "workbench.artifact/1",
+  "projectId": "wb_project_id",
+  "artifactKey": "document:director-program",
+  "sourceRevision": 2,
+  "idempotencyKey": "persisted-event-uuid",
+  "kind": "markdown",
+  "stageKey": "04",
+  "title": "导演稿",
+  "content": {
+    "type": "local",
+    "sourcePath": "C:/production/canonical/director.md",
+    "mime": "text/markdown"
+  },
+  "source": {
+    "productionRecordId": "record_id",
+    "archiveGeneration": 0,
+    "sourceSchema": "director-program/4"
+  }
+}
+```
+
+上传响应在网络中丢失时，CLI 会先查询同一个已声明 blob；ready 状态不会重传，也不会重新登记业务版本。失败交给流程侧持久待传队列用相同事件重试。
+
+`sync` 只读取 `--manifest` 中显式的 `items`。每个 item 为 `type: "artifact"`（默认）或 `type: "annotation"`，可直接携带提交字段或放进 `submission`；不会递归任何工作目录。
+
+```powershell
+branch-video-agent workbench sync --manifest .\.workbench\pending-items.json --raw
+branch-video-agent workbench archive prepare --manifest .\.workbench\archive-wrapper.json --raw
+branch-video-agent workbench archive finalize --project wb_project_id --record record_id --revision 1 --manifest-hash <sha256> --raw
+branch-video-agent workbench archive status --project wb_project_id --record record_id --raw
+branch-video-agent workbench archive download --project wb_project_id --record record_id --revision 1 --file .\entry.json --output .\session.jsonl.zst --raw
+```
+
+`archive prepare` 的文件是调用方维护的 wrapper：`{ manifest, manifestHash, expectedPreviousRevision }`；CLI 原样提交规范化清单和 hash。`archive finalize` 只校验已经提交的清单，不补扫文件。下载的 `entry.json` 至少包含 `{ "entryId": "..." }`；受权限保护的字节写入 `--output`，stdout 仍只输出 JSON 回执。
+
+`record put` 的路径参数是稳定的流程 `recordKey`，返回对象的 `id` 才是后续 `end-intent`、`reopen` 和所有 `archive` 命令使用的 `productionRecordId`（也可传给 `--record`）。不要把 `recordKey` 当成归档路由 ID。
 
 ## 在仓库内构建发布包
 
@@ -314,16 +314,16 @@ branch-video-agent workbench archive download --project wb_project_id --record r
 
 ```powershell
 npm run agent:cli:package:build
-npm run agent:cli:package:smoke
-```
-
-需要运行会启动 standalone Mongo、真实 CLI HTTP 流、Python adapter 或 Chromium 的 Production Workbench 集成验收时，使用专用命令；常规 `npm test` 会排除这些外部运行时依赖。adapter E2E 需要相邻的 rpg2 adapter checkout，或显式设置 `RPG2_WORKBENCH_ADAPTER_ROOT`；缺失 checkout、`zstd` 或 Chromium 时命令应失败。
-
-```powershell
-npm run test:workbench-cli-integration
-npm run test:workbench-adapter-e2e
-npm run test:workbench-integration
-```
+npm run agent:cli:package:smoke
+```
+
+需要运行会启动 standalone Mongo、真实 CLI HTTP 流、Python adapter 或 Chromium 的 Production Workbench 集成验收时，使用专用命令；常规 `npm test` 会排除这些外部运行时依赖。adapter E2E 需要相邻的 rpg2 adapter checkout，或显式设置 `RPG2_WORKBENCH_ADAPTER_ROOT`；缺失 checkout、`zstd` 或 Chromium 时命令应失败。
+
+```powershell
+npm run test:workbench-cli-integration
+npm run test:workbench-adapter-e2e
+npm run test:workbench-integration
+```
 
 产物输出到：
 

package/dist/commands/workbench.js

@@ -1,3 +1,5 @@
+import { createGzip } from 'node:zlib';
+import { pipeline } from 'node:stream/promises';
 import { createHash } from 'node:crypto';
 import { createReadStream } from 'node:fs';
 import { stat, writeFile } from 'node:fs/promises';
@@ -70,17 +72,28 @@ async function uploadLocalContent(context, sourcePath, content) {
     const blobId = getRequiredString(declared.data, 'id');
     if (declared.data.state !== 'ready') {
         let uploadError;
+        const source = createReadStream(sourcePath), compressed = createGzip();
+        const compressing = pipeline(source, compressed);
+        // Fetch consumes the compressed readable; prevent an unhandled rejection
+        // until its stream error reaches requestStream. Always close both below.
+        void compressing.catch(() => undefined);
         try {
             await context.client.requestStream(`${workbenchPath}/projects/${encodeURIComponent(projectId(context.payload, context.flags.project))}/blobs/${encodeURIComponent(blobId)}/content`, {
                 method: 'PUT',
-                body: Readable.toWeb(createReadStream(sourcePath)),
-                contentType: mime,
+                body: Readable.toWeb(compressed),
+                contentType: 'application/gzip',
+                uploadFormat: 'gzip',
                 timeoutMs: context.flags.timeoutMs,
             });
         }
         catch (error) {
             uploadError = error;
         }
+        finally {
+            source.destroy();
+            compressed.destroy();
+            await compressing.catch(() => undefined);
+        }
         if (uploadError) {
             const status = await context.client.request(`${workbenchPath}/projects/${encodeURIComponent(projectId(context.payload, context.flags.project))}/blobs/${encodeURIComponent(blobId)}`, {
                 method: 'GET',

package/dist/lib/http.d.ts

@@ -13,6 +13,7 @@ type StreamRequestOptions = {
     method: string;
     body: ReadableStream<Uint8Array>;
     contentType: string;
+    uploadFormat?: 'gzip';
     timeoutMs?: number;
 };
 type BinaryRequestResult = {

package/dist/lib/http.js

@@ -93,6 +93,7 @@ export class CliHttpClient {
                 headers: {
                     Authorization: `Bearer ${this.token}`,
                     'content-type': options.contentType,
+                    ...(options.uploadFormat ? { 'x-workbench-upload-format': options.uploadFormat } : {}),
                 },
                 body: options.body,
                 duplex: 'half',

package/package.json

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