@qwen-code/arena-agent 0.0.10-dev.5 → 0.0.10-dev.7

package/dist/voice-registry.d.ts

@@ -7,6 +7,7 @@ export interface VoiceAuditionCandidate {
 export interface VoiceBattle {
     battleId: string;
     candidates: VoiceAuditionCandidate[];
+    model?: string;
     language: string;
 }
 export interface RegisteredVoiceSelection {
@@ -16,6 +17,7 @@ export interface RegisteredVoiceSelection {
 interface RegisteredVoice {
     language: string;
     providerVoice: string;
+    model: string;
 }
 export declare class VoiceRegistry {
     private battleSequence;

package/dist/voice-registry.js

@@ -1,10 +1,14 @@
 import { generateSpeechWithModelRouter } from "./model-router-media.js";
+import { isGeminiSpeechModel, speechModel } from "./speech-model.js";
 const registries = new Map();
 function primaryLanguage(language) {
     return language.toLowerCase().split(/[-_]/)[0] || "";
 }
 function voiceCatalog(language, gender) {
     const masculine = gender === "masculine";
+    if (isGeminiSpeechModel(speechModel())) {
+        return masculine ? ["Puck", "Charon"] : ["Kore", "Aoede"];
+    }
     if (primaryLanguage(language) === "en") {
         return masculine
             ? ["en_male_tim_uranus_bigtts", "zh_male_m191_uranus_bigtts"]
@@ -31,9 +35,11 @@ export class VoiceRegistry {
     async audition(text, language, voiceIdentity = {}, signal) {
         const battleId = this.nextBattleId();
         const voices = selectedVoices(language, voiceIdentity);
+        const model = speechModel();
         const audio = await Promise.all(voices.map((voice) => generateSpeechWithModelRouter({
             format: "mp3",
-            model: process.env.ARENA_SPEECH_MODEL || "doubao-tts",
+            model,
+            language,
             signal,
             text,
             voice,
@@ -41,6 +47,7 @@ export class VoiceRegistry {
         return {
             battleId,
             language,
+            model,
             candidates: voices.map((providerVoice, index) => ({
                 id: `candidate-${index + 1}`,
                 label: `Voice ${index + 1}`,
@@ -57,6 +64,7 @@ export class VoiceRegistry {
         this.voices.set(voiceId, {
             language: battle.language,
             providerVoice: candidate.providerVoice,
+            model: battle.model || speechModel(),
         });
         return voiceId;
     }
@@ -64,7 +72,7 @@ export class VoiceRegistry {
         const battleId = this.nextBattleId();
         const voiceId = `voice-${battleId}`;
         const providerVoice = selectedVoices(language, voiceIdentity)[0];
-        this.voices.set(voiceId, { language, providerVoice });
+        this.voices.set(voiceId, { language, providerVoice, model: speechModel() });
         return { battleId, voiceId };
     }
     resolve(voiceId) {

package/dist/voice-registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-registry.js","sourceRoot":"","sources":["../src/voice-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"voice-registry.js","sourceRoot":"","sources":["../src/voice-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErE,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;AA2BpD,SAAS,eAAe,CAAC,QAAgB;IACvC,OAAO,QAAQ,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB,EAAE,MAAe;IACrD,MAAM,SAAS,GAAG,MAAM,KAAK,WAAW,CAAC;IACzC,IAAI,mBAAmB,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC;QACvC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,eAAe,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,SAAS;YACd,CAAC,CAAC,CAAC,2BAA2B,EAAE,4BAA4B,CAAC;YAC7D,CAAC,CAAC,CAAC,+BAA+B,EAAE,gCAAgC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,SAAS;QACd,CAAC,CAAC,CAAC,4BAA4B,EAAE,gCAAgC,CAAC;QAClE,CAAC,CAAC,CAAC,4BAA4B,EAAE,gCAAgC,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,cAAc,CACrB,QAAgB,EAChB,aAAsC;IAEtC,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7D,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,CAC7B,CAAC,EACD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAC7C,CAAC;IACF,OAAO;QACL,OAAO,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAE;QAC/C,OAAO,CAAC,CAAC,cAAc,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAE;KACpD,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,aAAa;IAChB,cAAc,GAAG,CAAC,CAAC;IACV,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAErD,YAAY;QAClB,OAAO,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAY,EACZ,QAAgB,EAChB,aAAa,GAA4B,EAAE,EAC3C,MAAoB;QAEpB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAC7B,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CACnB,6BAA6B,CAAC;YAC5B,MAAM,EAAE,KAAK;YACb,KAAK;YACL,QAAQ;YACR,MAAM;YACN,IAAI;YACJ,KAAK;SACN,CAAC,CACH,CACF,CAAC;QACF,OAAO;YACL,QAAQ;YACR,QAAQ;YACR,KAAK;YACL,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;gBAChD,EAAE,EAAE,aAAa,KAAK,GAAG,CAAC,EAAE;gBAC5B,KAAK,EAAE,SAAS,KAAK,GAAG,CAAC,EAAE;gBAC3B,aAAa;gBACb,YAAY,EAAE,0BAA0B,KAAK,CAAC,KAAK,CAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE;aAC3E,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,QAAQ,CAAC,MAAmB,EAAE,WAAmB;QAC/C,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC,CAAC;QAC5E,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACnF,MAAM,OAAO,GAAG,SAAS,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE;YACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,aAAa,EAAE,SAAS,CAAC,aAAa;YACtC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,WAAW,EAAE;SACrC,CAAC,CAAC;QACH,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,eAAe,CACb,QAAgB,EAChB,aAAa,GAA4B,EAAE;QAE3C,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,SAAS,QAAQ,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,CAAE,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,OAAO,CAAC,OAAe;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,SAAiB;IACzD,IAAI,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;QAC/B,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/web-fetch-output.d.ts

@@ -0,0 +1,9 @@
+export declare function truncateCodeArenaText(value: string, maxBytes?: number): string;
+export declare function boundedWebFetchResult(result: {
+    title?: unknown;
+    content?: unknown;
+}): {
+    status: "success";
+    title: string;
+    content: string;
+};

package/dist/web-fetch-output.js

@@ -0,0 +1,38 @@
+const defaultMaxBytes = 40_000;
+const maxTitleBytes = 512;
+function configuredMaxBytes() {
+    const value = process.env.CODE_HARNESS_WEB_FETCH_MAX_BYTES?.trim() || "";
+    const parsed = /^\d+$/.test(value) ? Number(value) : NaN;
+    return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : defaultMaxBytes;
+}
+export function truncateCodeArenaText(value, maxBytes = defaultMaxBytes) {
+    const bytes = Buffer.from(value, "utf8");
+    if (bytes.length <= maxBytes)
+        return value;
+    // Captures retain ~40 KB with symmetric head/tail and this marker. The
+    // omitted-token count is an estimate (UTF-8 bytes / 4), not model tokenization.
+    const omittedTokens = Math.ceil((bytes.length - maxBytes) / 4);
+    let notice = `\n…${omittedTokens} tokens truncated…\n`;
+    if (Buffer.byteLength(notice) > maxBytes)
+        notice = maxBytes >= 3 ? "…" : ".";
+    const half = Math.floor((maxBytes - Buffer.byteLength(notice)) / 2);
+    let headEnd = half;
+    let tailStart = bytes.length - half;
+    // Move cut points inward to preserve complete UTF-8 characters and the bound.
+    while (headEnd > 0 && (bytes[headEnd] & 0xc0) === 0x80)
+        headEnd -= 1;
+    while (tailStart < bytes.length && (bytes[tailStart] & 0xc0) === 0x80)
+        tailStart += 1;
+    return bytes.subarray(0, headEnd).toString("utf8") + notice +
+        bytes.subarray(tailStart).toString("utf8");
+}
+// Apply at the Code Arena tool boundary so local and Routify readers share the
+// same bound. Agent Arena fetch_page retains its full, separately paged cache.
+export function boundedWebFetchResult(result) {
+    return {
+        status: "success",
+        title: truncateCodeArenaText(String(result.title || "No Title Found"), maxTitleBytes),
+        content: truncateCodeArenaText(String(result.content || ""), configuredMaxBytes()),
+    };
+}
+//# sourceMappingURL=web-fetch-output.js.map

package/dist/web-fetch-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-fetch-output.js","sourceRoot":"","sources":["../src/web-fetch-output.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,MAAM,CAAC;AAC/B,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,SAAS,kBAAkB;IACzB,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gCAAgC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,OAAO,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa,EAAE,QAAQ,GAAG,eAAe;IAC7E,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,MAAM,IAAI,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3C,uEAAuE;IACvE,gFAAgF;IAChF,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI,MAAM,GAAG,MAAM,aAAa,sBAAsB,CAAC;IACvD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,QAAQ;QAAE,MAAM,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC7E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACpC,8EAA8E;IAC9E,OAAO,OAAO,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAE,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC;IACtE,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAE,GAAG,IAAI,CAAC,KAAK,IAAI;QAAE,SAAS,IAAI,CAAC,CAAC;IACvF,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM;QACzD,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,+EAA+E;AAC/E,+EAA+E;AAC/E,MAAM,UAAU,qBAAqB,CAAC,MAGrC;IACC,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI,gBAAgB,CAAC,EAAE,aAAa,CAAC;QACrF,OAAO,EAAE,qBAAqB,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/docs/BINARY_DISTRIBUTION.md

@@ -102,9 +102,9 @@ npm run package:binary
 ```
 
 默认命令构建当前 runner 的系统、CPU 和 libc。CI 还支持在 Linux x64 上按 Node
-SEA 跨平台流程生成三个关键目标：`linux-x64` 固定下载完全相同版本的 Node.js
+SEA 跨平台流程生成四个发布目标：`linux-x64` 固定下载完全相同版本的 Node.js
 unofficial-builds glibc 2.17 Runtime，`linux-x64-musl` 下载 unofficial-builds
-musl Runtime，`darwin-x64` 下载官方 macOS x64 Runtime。三者都通过 Aone 可访问的
+musl Runtime，`darwin-arm64` 和 `darwin-x64` 下载对应架构的官方 macOS Runtime。四者都通过 Aone 可访问的
 npmmirror 二进制镜像下载，并校验对应的
 `SHASUMS256.txt`，关闭 code cache/snapshot 后注入 SEA blob。
 macOS 产物再使用固定版本和 checksum 的 `rcodesign` 做 ad-hoc 签名。Aone 从仓库的
@@ -134,29 +134,33 @@ node scripts/package-binaries.mjs \
 ```
 
 CI 应构建并汇总 `build/npm/packages/<target>`。原生 Runtime 通常应在对应环境中
-构建；禁用 SEA snapshot/code cache 后，`linux-x64`、`linux-x64-musl` 和
-`darwin-x64` 都可以在 Linux x64 Runner 上使用经过校验的目标 Node Runtime
+构建；禁用 SEA snapshot/code cache 后，`linux-x64`、`linux-x64-musl`、
+`darwin-arm64` 和 `darwin-x64` 都可以在 Linux x64 Runner 上使用经过校验的目标 Node Runtime
 组装。
 
 本仓库使用 Aone CI，流水线定义在
 [`/.aoneci/arena-binaries.yaml`](../.aoneci/arena-binaries.yaml)。当前项目没有关联
 自托管 Runner 组，因此流水线优先使用 Aone 托管的 Linux amd64 资源构建
-`linux-x64`，并交叉构建 `linux-x64-musl` 和 `darwin-x64`。推送与根
+`linux-x64`，并交叉构建 `linux-x64-musl`、`darwin-arm64` 和 `darwin-x64`。推送与根
 `package.json` 版本完全一致的 `v<semver>` Tag 时会自动运行，并在同一批次
-发布这三个关键平台包、`@qwen-code/arena-agent` 和
+发布这四个平台包、`@qwen-code/arena-agent` 和
 `@qwen-code/arena-cli`；后两个包都包含四种模式和两个命令入口。普通分支 push
 不触发，手动运行只构建、不发布。发布前
 需要在“设置 → 持续集成 → 变量管理”中添加名为 `NPM_TOKEN` 的 Secret。
 
-例如，预发布版自动使用 npm `dev` tag：
+每次发布前先按[发版流程](MODES_AND_RELEASES.md#发布节奏)更新
+[`CHANGELOG.md`](../CHANGELOG.md)。以下以新的预发布版 `0.0.10-dev.7` 为例，
+发布脚本自动使用 npm `dev` tag：
 
 ```bash
-npm version 0.0.10-dev.1 --no-git-tag-version
-git add package.json package-lock.json
-git commit -m "chore: release 0.0.10-dev.1"
+npm version 0.0.10-dev.7 --no-git-tag-version
+# 将本次变更整理到 CHANGELOG.md 的 0.0.10-dev.7 条目，填写日期并更新比较链接
+npm run check:changelog
+git add package.json package-lock.json CHANGELOG.md
+git commit -m "chore: release 0.0.10-dev.7"
 git push origin master
-git tag v0.0.10-dev.1
-git push origin v0.0.10-dev.1
+git tag v0.0.10-dev.7
+git push origin v0.0.10-dev.7
 ```
 
 正式版同理，例如 `package.json` 为 `0.0.10` 时推送 `v0.0.10`，发布脚本会自动
@@ -164,16 +168,21 @@ git push origin v0.0.10-dev.1
 发布到 npm。首次稳定版发布前请显式使用 `@dev` 或完整版本号；首个正式版本发布后
 才把无版本安装渠道作为稳定入口。
 
-Aone 官方不提供 Windows/macOS 托管资源；`darwin-x64` 已通过上述交叉构建覆盖。
+Aone 官方不提供 Windows/macOS 托管资源；macOS 两个架构通过上述交叉构建覆盖。
 Linux arm64 的两个平台包暂不参与自动发布，以免非关键 ARM64 Job 阻塞 x64
-发布。发布 `darwin-arm64` 和 Windows 包前，仍需要关联对应的 self-hosted Runner
-组。
+发布。Windows 包仍需要关联对应的 self-hosted Runner 组。
 
 ## 发布
 
+发布前必须有与根 `package.json` 版本一致、带有效日期及实际变更条目的 changelog，
+并按 Agent Arena、Code Arena、通用分别记录变更。
+`npm publish` 和多平台发布脚本均执行此检查，缺失时立即失败；多平台脚本在发布
+第一个平台包前检查，避免只发布部分包后才发现变更记录缺失。
+
 汇总全部 7 个平台包目录后，重新生成一次入口包并进行发布前检查：
 
 ```bash
+npm run check:changelog
 npm run package:binary:cli
 npm run publish:binaries -- --dry-run --tag dev
 ```
@@ -201,7 +210,7 @@ SEA 产物内含目标平台的 Node.js 可执行文件，因此需要为每种
 - Linux arm64/x64 的 glibc 与 musl
 - Windows x64
 
-除流水线已覆盖的三个关键 x64 目标外，其他目标应在对应操作系统和 CPU 架构的
+除流水线已覆盖的四个发布目标外，其他目标应在对应操作系统和 CPU 架构的
 构建机或 CI runner 上执行。
 
 “业务机不需要 Node.js 20+”不等于“二进制不受 Node.js 20 的系统要求影响”。

package/docs/MODES_AND_RELEASES.md

@@ -8,7 +8,7 @@
   agent loop、compaction、history、metrics、CLI/TUI/server 和 SDK。
 - 模式边界只包含 system prompt、工具 schema/实现以及可选 scaffold。
 - 四种模式使用同一个版本号一起演进，避免两份 agent loop 再次漂移。
-- JavaScript/SDK 包与 SEA 二进制包是两种分发形式，可以按需要分别发布；
+- JavaScript/SDK 包与 SEA 二进制包是两种分发形式，共用发布版本；
   它们不是两套产品源码，也不要求 npm workspaces。
 
 ## 目录
@@ -89,10 +89,30 @@ arena --mode full-stack -p '...'
 
 ## 发布节奏
 
-可以只发布 JavaScript/SDK 包，也可以在随后完成 7 个平台的 SEA 包和 launcher；
-但不建议单独发布某一个模式。推荐顺序：
+每次发布（包括 dev 预发布）都必须先更新根目录的
+[`CHANGELOG.md`](../CHANGELOG.md)，并与版本号修改一起提交：
+
+1. 将 `Unreleased` 中本次要发布的变更整理为 `## [版本号] - YYYY-MM-DD`，
+   版本号与 `package.json` 完全一致，并说明配置迁移。每个版本及 `Unreleased`
+   内按 `### Agent Arena`、`### Code Arena`、`### 通用` 分组；两类 Arena 的专属
+   变更分别记录，共用运行时、模型连接和 CLI 变化只写在通用部分。无变更的
+   分类省略，分类内可按需用四级标题区分新增、变更、修复。
+2. 保留顶部 `## [Unreleased]` 供后续记录，更新新版本及 `Unreleased` 的比较链接。
+3. 完成下面的发布检查，再提交版本变更和 changelog、推送匹配的 `v<version>` 标签。
+
+Changelog 只记录用户使用 CLI 时能感知的功能、行为、修复、配置、安装兼容性和
+迁移要求。内部技能、回放与审计工具、报告、测试、发布流程维护、源码归档及
+构建下载诊断不写入 changelog。
+
+`npm run check:changelog` 校验最新版本条目、有效日期和非空变更内容。
+直接 `npm publish` 会通过 `prepublishOnly` 执行检查；多平台发布脚本（含 dry-run）
+也会在任何包发布前执行检查，Aone 标签发布走同一入口。
+
+四种模式一起发布。Agent、CLI 和所支持的平台包必须使用同一版本；只发布
+JavaScript/SDK 包不算发版完成。检查及打包顺序：
 
 ```bash
+npm run check:changelog
 npm run typecheck
 npm test
 npm pack --dry-run
@@ -105,8 +125,11 @@ npm run package:binary:cli
 npm run publish:binaries -- --dry-run
 ```
 
-平台包必须先于 `@qwen-code/arena-cli` 发布。完整矩阵见
-[`BINARY_DISTRIBUTION.md`](BINARY_DISTRIBUTION.md)。
+平台包必须先于 `@qwen-code/arena-cli` 发布。推送标签后，核验 Agent、CLI 和所有
+受支持平台包的 exact-version npm 查询，至少覆盖 `darwin-arm64`、`darwin-x64`、
+`linux-x64`、`linux-x64-musl`，并用该完整版本号的 `install.sh` 做端到端烟测。
+预发布还需确认相关包的 `dev` dist-tag 均指向最新预发布版本。
+完整矩阵及发布命令见 [`BINARY_DISTRIBUTION.md`](BINARY_DISTRIBUTION.md)。
 
 ## 原 Code Harness 的迁移边界
 

package/docs/SDK.md

@@ -173,6 +173,10 @@ console.log(history.activePrompt);
 `getHistory()` 同时会设置 SSE 续传需要的 `lastEventId`。恢复后再调用
 `run()`、`stream()` 或 `connect()` 即可继续。
 
+`history.messages` 与运行结果的 `messages` 只包含对话历史（含 compaction），
+不包含运行时生成的开头 system；中途的 system 消息仍会保留。服务端在每次运行时
+按当前配置生成开头 system，并只将它加入模型请求。
+
 当前服务端还没有用户账号维度的 `sessions.list()`/`sessions.open()`。
 跨设备登录应由服务端把 session 绑定到可信的 `userId`，并在用户登录后重新
 签发短期 session token，而不是在设备之间同步旧 token。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwen-code/arena-agent",
-  "version": "0.0.10-dev.5",
+  "version": "0.0.10-dev.7",
   "description": "A four-mode TypeScript agent harness for Arena and Code Arena traces.",
   "type": "module",
   "types": "./dist/sdk.d.ts",
@@ -29,7 +29,10 @@
     "docs/BINARY_DISTRIBUTION.md",
     "modes",
     "web",
+    "vendor/audio",
     "README.md",
+    "CHANGELOG.md",
+    "scripts/check-changelog.mjs",
     ".env.example"
   ],
   "engines": {
@@ -46,11 +49,14 @@
     "package:binary:platform": "npm run build:binary && node scripts/package-binaries.mjs --skip-cli",
     "package:binary:cli": "node scripts/package-binaries.mjs --cli-only",
     "publish:binaries": "node scripts/publish-binaries.mjs",
+    "check:changelog": "node scripts/check-changelog.mjs",
+    "prepublishOnly": "npm run check:changelog",
     "dev": "tsx src/cli.ts serve",
     "tui": "tsx src/cli.ts tui",
-    "prepack": "npm run build",
+    "prepare:audio": "node scripts/prepare-audio.mjs",
+    "prepack": "npm run build && node scripts/prepare-audio.mjs --all",
     "start": "node dist/cli.js serve",
-    "pretest": "npm run build",
+    "pretest": "npm run build && npm run prepare:audio",
     "test": "tsx --test test/*.test.ts",
     "test:tool-replay": "ARENA_TOOL_REPLAY_TESTS=1 tsx --test test/tool-replay.test.ts",
     "scaffolds:validate-inputs": "tsx scripts/validate-scaffold-inputs.ts",

package/scripts/README.md

@@ -0,0 +1,62 @@
+# 轨迹复刻脚本
+
+本目录保存 DataWorks SQL Arena 轨迹数据的复刻与环境准备脚本。数据集位于
+`tasks/`，运行产物位于 `tasks/reproductions/`。
+
+## 通用脚本
+
+`reproduce_case.mjs` 运行单个 case，`reproduce_all.mjs`
+批量运行数据集中标记为可复刻的 case。
+
+每个 case 可以通过可选的 `prepare.json` 声明运行前环境准备。没有配置时
+prepare phase 是 no-op；存在配置时，单任务和批量入口都会在调用模型前自动
+执行并校验。当前支持固定 Git commit、从原始 history 恢复附件和文件断言。
+
+```bash
+# 单个 case；默认数据集可省略 --dataset
+node scripts/reproduce_case.mjs --case 010
+
+# 指定其他数据集
+node scripts/reproduce_case.mjs \
+  --dataset /path/to/dataset \
+  --case 010
+
+# 以 5 个并发运行全部可复刻 case
+node scripts/reproduce_all.mjs \
+  --dataset /path/to/dataset \
+  --concurrency 5
+```
+
+单独验证某个 prepare 配置，不调用模型：
+
+```bash
+node scripts/prepare_workspace.mjs \
+  --case-dir /path/to/dataset/cases/case-xxx \
+  --workspace /path/to/empty/workspace
+```
+
+脚本读取项目根目录 `.env` 中的 `ARENA_API_MODEL`、`OPENAI_BASE_URL` 和
+`OPENAI_API_KEY`。固定生成参数由数据集自身的 `reproduction.config.json`
+提供。
+
+批量入口具有以下行为：
+
+- 每个失败 case 自动重试一次。
+- 第一次失败后删除该次失败目录。
+- 成功或最终失败后，只保留该 case 最新的最终运行目录。
+- prepare 失败时不会调用模型，错误会写入该次 `result.json`。
+- 单次运行默认 60 分钟超时，可通过 `--timeout-minutes` 或
+  `ARENA_REPRO_TIMEOUT_MINUTES` 调整。
+- `--case` 的退出码只反映本次指定 case，不受历史失败记录影响。
+- `--clean` 仅在数据集清单和可复刻性审计验证通过后清理
+  `reproductions/`。
+
+完整清理后重新运行：
+
+```bash
+node scripts/reproduce_all.mjs \
+  --dataset /path/to/dataset \
+  --concurrency 5 \
+  --timeout-minutes 60 \
+  --clean
+```

package/scripts/check-changelog.mjs

@@ -0,0 +1,66 @@
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+export function checkChangelog(directory = root) {
+  const { version } = JSON.parse(
+    readFileSync(path.join(directory, "package.json"), "utf8"),
+  );
+  const fail = (message) => {
+    throw new Error(`CHANGELOG.md: ${message}. Update the changelog before releasing ${version}.`);
+  };
+  let changelog;
+  try {
+    changelog = readFileSync(path.join(directory, "CHANGELOG.md"), "utf8");
+  } catch (error) {
+    if (error.code === "ENOENT") fail("file is missing");
+    throw error;
+  }
+  // Examples and comments are not release notes.
+  const content = changelog
+    .replace(/<!--[^]*?-->/g, "")
+    .replace(/^(`{3,}|~{3,})[^\n]*\n[^]*?^\1[^\S\r\n]*$/gm, "");
+  const sections = [...content.matchAll(/^##[ \t]+(.+?)[ \t]*\r?$/gm)];
+  if (sections[0]?.[1] !== "[Unreleased]") {
+    fail("the first section must be ## [Unreleased]");
+  }
+  if (sections.filter((section) => section[1] === "[Unreleased]").length !== 1) {
+    fail("Unreleased must appear exactly once");
+  }
+  const currentSections = sections.filter((section) =>
+    section[1].startsWith(`[${version}]`),
+  );
+  if (currentSections.length !== 1 || currentSections[0] !== sections[1]) {
+    fail(`the newest release section must be a single ## [${version}] - YYYY-MM-DD`);
+  }
+  const current = currentSections[0];
+  const date = current[1].slice(`[${version}] - `.length);
+  if (
+    current[1] !== `[${version}] - ${date}` ||
+    !/^\d{4}-\d{2}-\d{2}$/.test(date) ||
+    !Number.isFinite(Date.parse(`${date}T00:00:00Z`)) ||
+    new Date(`${date}T00:00:00Z`).toISOString().slice(0, 10) !== date
+  ) {
+    fail(`release ${version} needs a valid date in YYYY-MM-DD format`);
+  }
+  const body = content.slice(current.index + current[0].length, sections[2]?.index);
+  const entries = [...body.matchAll(/^[-*][ \t]+(.+?)\r?$/gm)];
+  if (!entries.some((entry) =>
+    /[\p{L}\p{N}]/u.test(entry[1]) &&
+    !/^(?:TODO|TBD|待补充|待填写|暂无)(?:[\s:：.!！。…-]|$)/i.test(entry[1]),
+  )) {
+    fail(`release ${version} needs at least one non-placeholder change entry`);
+  }
+  return version;
+}
+
+if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url)) {
+  try {
+    console.log(`Changelog ready for ${checkChangelog()}`);
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+  }
+}