@qwen-code/arena-agent 0.0.10-dev.0 → 0.0.10-dev.10

package/dist/speech-audio.js

@@ -0,0 +1,130 @@
+import { spawn } from "node:child_process";
+import { createHash } from "node:crypto";
+import { mkdtemp, readFile, writeFile, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { gunzip } from "node:zlib";
+import { promisify } from "node:util";
+import { fileURLToPath } from "node:url";
+import { embeddedAsset, isSingleExecutable } from "./runtime-assets.js";
+const unzip = promisify(gunzip);
+const maximumBytes = 25 * 1024 * 1024;
+export function validatePcm(pcm) {
+    if (!Number.isInteger(pcm.sampleRate) || pcm.sampleRate < 8000 || pcm.sampleRate > 96000 ||
+        ![1, 2].includes(pcm.channels) || !pcm.bytes.length ||
+        pcm.bytes.length > maximumBytes || pcm.bytes.length % (2 * pcm.channels) !== 0) {
+        throw new Error("Invalid or oversized 16-bit speech PCM response");
+    }
+}
+export function pcmToWav(pcm) {
+    validatePcm(pcm);
+    const header = Buffer.alloc(44);
+    header.write("RIFF", 0);
+    header.writeUInt32LE(36 + pcm.bytes.length, 4);
+    header.write("WAVEfmt ", 8);
+    header.writeUInt32LE(16, 16);
+    header.writeUInt16LE(1, 20);
+    header.writeUInt16LE(pcm.channels, 22);
+    header.writeUInt32LE(pcm.sampleRate, 24);
+    header.writeUInt32LE(pcm.sampleRate * pcm.channels * 2, 28);
+    header.writeUInt16LE(pcm.channels * 2, 32);
+    header.writeUInt16LE(16, 34);
+    header.write("data", 36);
+    header.writeUInt32LE(pcm.bytes.length, 40);
+    return Buffer.concat([header, pcm.bytes]);
+}
+async function audioAsset(name) {
+    if (isSingleExecutable()) {
+        const bytes = embeddedAsset(`audio/${name}`);
+        if (bytes)
+            return bytes;
+    }
+    else {
+        // Both src/ and dist/ live one directory below the package root.
+        const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+        const target = `${process.platform}-${process.arch}`;
+        try {
+            return await readFile(path.join(root, "vendor", "audio", target, name));
+        }
+        catch (error) {
+            throw new Error(`Bundled speech encoder asset missing for ${target}: ${name}. Reinstall the complete Arena package.`, { cause: error });
+        }
+    }
+    throw new Error(`Bundled speech encoder asset missing: ${name}`);
+}
+function checksum(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+async function extractEncoder(directory) {
+    const metadata = JSON.parse((await audioAsset("manifest.json")).toString("utf8"));
+    if (metadata.target !== `${process.platform}-${process.arch}` ||
+        !Number.isSafeInteger(metadata.binaryBytes) || metadata.binaryBytes <= 0 || metadata.binaryBytes > 128 * 1024 * 1024) {
+        throw new Error("Bundled speech encoder metadata does not match this platform");
+    }
+    const compressed = await audioAsset("ffmpeg.gz");
+    if (checksum(compressed) !== metadata.compressedSha256)
+        throw new Error("Bundled speech encoder checksum mismatch");
+    const binary = await unzip(compressed, { maxOutputLength: metadata.binaryBytes });
+    if (binary.length !== metadata.binaryBytes || checksum(binary) !== metadata.binarySha256) {
+        throw new Error("Bundled speech encoder binary checksum mismatch");
+    }
+    const executable = path.join(directory, process.platform === "win32" ? "ffmpeg.exe" : "ffmpeg");
+    await writeFile(executable, binary, { flag: "wx", mode: 0o700 });
+    return executable;
+}
+function executeEncoder(executable, args, signal) {
+    signal?.throwIfAborted();
+    return new Promise((resolve, reject) => {
+        // Never invoke a shell, search PATH, download a binary, or fall back to host tools.
+        const child = spawn(executable, args, { stdio: ["ignore", "ignore", "pipe"], windowsHide: true });
+        let diagnostic = "";
+        let failure;
+        const stop = (error) => { failure ||= error; child.kill("SIGKILL"); };
+        const abort = () => stop(new Error("Speech encoding aborted", { cause: signal?.reason }));
+        const timer = setTimeout(() => stop(new Error("Bundled speech encoder exceeded 60 seconds")), 60000);
+        signal?.addEventListener("abort", abort, { once: true });
+        if (signal?.aborted)
+            abort();
+        child.stderr.on("data", (chunk) => { diagnostic = (diagnostic + chunk.toString("utf8")).slice(-4096); });
+        child.on("error", (error) => { failure ||= error; });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", abort);
+            if (failure)
+                reject(failure);
+            else if (code !== 0)
+                reject(new Error(`Bundled speech encoder failed (${code}): ${diagnostic}`));
+            else
+                resolve();
+        });
+    });
+}
+export async function encodeSpeechPcm(pcm, format, signal) {
+    signal?.throwIfAborted();
+    validatePcm(pcm);
+    if (format === "wav")
+        return pcmToWav(pcm);
+    if (format !== "mp3" && format !== "opus")
+        throw new Error(`Unsupported speech format: ${format}`);
+    const directory = await mkdtemp(path.join(tmpdir(), "arena-speech-"));
+    try {
+        const executable = await extractEncoder(directory);
+        signal?.throwIfAborted();
+        const input = path.join(directory, "input.pcm");
+        const output = path.join(directory, `output.${format}`);
+        await writeFile(input, pcm.bytes, { mode: 0o600 });
+        await executeEncoder(executable, ["-hide_banner", "-loglevel", "error", "-nostdin", "-y",
+            "-f", "s16le", "-ar", String(pcm.sampleRate), "-ac", String(pcm.channels), "-i", input,
+            "-c:a", format === "mp3" ? "libmp3lame" : "libopus", "-b:a", format === "mp3" ? "128k" : "64k",
+            "-fs", String(maximumBytes), "-f", format === "mp3" ? "mp3" : "ogg", output], signal);
+        signal?.throwIfAborted();
+        const bytes = await readFile(output);
+        if (!bytes.length || bytes.length >= maximumBytes)
+            throw new Error("Generated speech exceeded the output size limit");
+        return bytes;
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=speech-audio.js.map

package/dist/speech-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech-audio.js","sourceRoot":"","sources":["../src/speech-audio.ts"],"names":[],"mappings":"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"}

package/dist/speech-model.d.ts

@@ -0,0 +1,3 @@
+export declare const defaultSpeechModel = "gemini-3.1-flash-tts-preview";
+export declare function speechModel(): string;
+export declare function isGeminiSpeechModel(model: string): boolean;

package/dist/speech-model.js

@@ -0,0 +1,8 @@
+export const defaultSpeechModel = "gemini-3.1-flash-tts-preview";
+export function speechModel() {
+    return process.env.ARENA_SPEECH_MODEL || defaultSpeechModel;
+}
+export function isGeminiSpeechModel(model) {
+    return /^gemini-.*-tts(?:-|$)/.test(model);
+}
+//# sourceMappingURL=speech-model.js.map

package/dist/speech-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"speech-model.js","sourceRoot":"","sources":["../src/speech-model.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG,8BAA8B,CAAC;AAEjE,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,kBAAkB,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAO,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC7C,CAAC"}

package/dist/tools.d.ts

@@ -1,11 +1,15 @@
 import { type ArenaConfig } from "./config.js";
+import { type ModelConnectionOptions } from "./provider.js";
+import type { CheckpointHookToolCall } from "./midturn-checkpoint-hook.js";
 import type { AskUserHandler, AskUserContext, MultimodalUserMessage, ModelClient, ToolCall, ToolDefinition, ToolMessage, WorkspaceContext } from "./types.js";
 interface ToolExecutorOptions {
     askUserHandler?: AskUserHandler;
     modelClient?: ModelClient;
+    imageInputFallbackClient?: ModelClient;
     signal?: AbortSignal;
     workspaceContext?: WorkspaceContext;
 }
+export declare function imageInputFallbackConnection(config: ArenaConfig): ModelConnectionOptions | undefined;
 /**
  * Mode-aware tool facade. The Arena executor stays byte-compatible with the
  * existing harness, while the three Code Arena modes use their captured tool
@@ -17,6 +21,7 @@ export declare class ToolExecutor {
     get workspace(): string;
     get askUserEnabled(): boolean;
     availableTools(): ToolDefinition[];
+    inspect(call: ToolCall): CheckpointHookToolCall;
     execute(call: ToolCall, context?: AskUserContext): Promise<ToolMessage>;
     takeVisualMessage(toolCallIds: string[]): MultimodalUserMessage | undefined;
 }