@framers/agentos 0.13.44 → 0.13.46

package/dist/io/hearing/pieces/cut.js

@@ -0,0 +1,175 @@
+/**
+ * @fileoverview The pieces of a recording, cut in the page: packets copied into a container OpenAI takes when the codec
+ * allows (no decoding), and otherwise decoded and written as 16 kHz mono 16-bit WAV. On the decode path, each cut
+ * moves to the quietest 100 milliseconds within ten seconds before its mark when the search succeeds.
+ * @module agentos/io/hearing/pieces/cut
+ */
+import { AudioSample, AudioSampleSink, AudioSampleSource, BufferTarget, EncodedAudioPacketSource, EncodedPacketSink, Mp3OutputFormat, Mp4OutputFormat, Output, WavOutputFormat, WebMOutputFormat, ALL_FORMATS, BlobSource, BufferSource, Input, } from 'mediabunny';
+import { planPieces } from './plan.js';
+import { COPY_TARGETS, readAudioInfo, UnreadableAudioError } from './read.js';
+/** Creates a buffered output for a piece's container. */
+function outputFor(extension) {
+    const format = extension === 'm4a' ? new Mp4OutputFormat() : extension === 'webm' ? new WebMOutputFormat() : extension === 'mp3' ? new Mp3OutputFormat() : new WavOutputFormat();
+    return new Output({ format, target: new BufferTarget() });
+}
+/** The quietest 100 ms frame of the first channel in [from, to); keeps `to` if decoding fails or no frame fits. */
+async function quietestBefore(track, from, to) {
+    if (from >= to)
+        return to;
+    let best = to;
+    let bestLevel = Number.POSITIVE_INFINITY;
+    let sum = 0;
+    let count = 0;
+    let frameStart = from;
+    try {
+        const sink = new AudioSampleSink(track);
+        for await (const sample of sink.samples(from, to)) {
+            try {
+                const floats = new Float32Array(sample.numberOfFrames);
+                sample.copyTo(floats, { format: 'f32-planar', planeIndex: 0 });
+                const frame = Math.max(1, Math.round(sample.sampleRate / 10));
+                // A decoded sample can be shorter than 100 ms and can straddle either edge of the search window.
+                const first = Math.max(0, Math.ceil((from - sample.timestamp) * sample.sampleRate));
+                const last = Math.min(floats.length, Math.ceil((to - sample.timestamp) * sample.sampleRate));
+                for (let offset = first; offset < last; offset += 1) {
+                    if (count === 0)
+                        frameStart = sample.timestamp + offset / sample.sampleRate;
+                    sum += floats[offset] * floats[offset];
+                    count += 1;
+                    if (count === frame) {
+                        const level = sum / count;
+                        if (level < bestLevel) {
+                            bestLevel = level;
+                            best = frameStart + frame / (2 * sample.sampleRate);
+                        }
+                        sum = 0;
+                        count = 0;
+                    }
+                }
+            }
+            finally {
+                sample.close();
+            }
+        }
+    }
+    catch {
+        return to;
+    }
+    return best;
+}
+/** One piece by packet copy. */
+async function copyPiece(track, codec, start, end, isLast) {
+    const extension = codec === 'pcm-s16' ? 'wav' : COPY_TARGETS[codec].extension;
+    const output = outputFor(extension);
+    const source = new EncodedAudioPacketSource(codec);
+    output.addAudioTrack(source);
+    await output.start();
+    const sink = new EncodedPacketSink(track);
+    const first = await sink.getPacket(start);
+    const last = isLast ? undefined : await sink.getPacket(end, { metadataOnly: true });
+    const decoderConfig = (await track.getDecoderConfig()) ?? undefined;
+    let sent = false;
+    if (first !== null) {
+        for await (const packet of sink.packets(first, last ?? undefined)) {
+            await source.add(packet.clone({ timestamp: packet.timestamp - first.timestamp }), sent ? undefined : { decoderConfig });
+            sent = true;
+        }
+    }
+    await output.finalize();
+    return new Uint8Array(output.target.buffer);
+}
+/** One piece decoded to 16 kHz mono 16-bit WAV. */
+async function decodePiece(track, start, end) {
+    if (!await track.canDecode())
+        throw new UnreadableAudioError('cannot_decode');
+    const output = outputFor('wav');
+    const source = new AudioSampleSource({ codec: 'pcm-s16', transform: { numberOfChannels: 1, sampleRate: 16000 } });
+    output.addAudioTrack(source);
+    await output.start();
+    let sent = false;
+    for await (const sample of new AudioSampleSink(track).samples(start, end)) {
+        try {
+            const first = Math.max(0, Math.min(sample.numberOfFrames, Math.round((start - sample.timestamp) * sample.sampleRate)));
+            const last = Math.max(0, Math.min(sample.numberOfFrames, Math.round((end - sample.timestamp) * sample.sampleRate)));
+            if (first >= last)
+                continue;
+            const trimmed = sample.trim(first, last);
+            try {
+                // Round in frames so timestamp drift cannot create a zero-frame padding sample.
+                const offsetFrames = Math.max(0, Math.round((sample.timestamp - start) * sample.sampleRate) + first);
+                trimmed.setTimestamp(offsetFrames / sample.sampleRate);
+                if (!sent && offsetFrames > 0) {
+                    const padding = new AudioSample({
+                        data: new Float32Array(offsetFrames * sample.numberOfChannels),
+                        format: 'f32',
+                        sampleRate: sample.sampleRate,
+                        numberOfChannels: sample.numberOfChannels,
+                        timestamp: 0,
+                    });
+                    try {
+                        await source.add(padding);
+                    }
+                    finally {
+                        padding.close();
+                    }
+                }
+                await source.add(trimmed);
+                sent = true;
+            }
+            finally {
+                trimmed.close();
+            }
+        }
+        finally {
+            sample.close();
+        }
+    }
+    source.close();
+    await output.finalize();
+    return new Uint8Array(output.target.buffer);
+}
+/** Cuts a recording; yields its pieces in order. */
+export async function* cutPieces(file, options) {
+    const info = await readAudioInfo(file, options.signal);
+    options.signal?.throwIfAborted();
+    if (info.path === null)
+        throw new UnreadableAudioError(info.reason ?? 'unsupported_codec');
+    // Validate the options before opening the cutting input. Quiet cuts are planned from their actual starts below.
+    planPieces(info.seconds, options);
+    const input = new Input({ formats: ALL_FORMATS, source: file instanceof Uint8Array ? new BufferSource(file) : new BlobSource(file) });
+    try {
+        const track = (await input.getPrimaryAudioTrack());
+        const quiet = options.quietSeconds ?? 10;
+        let start = 0;
+        for (let index = 0; start < info.seconds; index += 1) {
+            options.signal?.throwIfAborted();
+            let end = Math.min(info.seconds, start + options.pieceSeconds);
+            // Keep the planner's one-second tail allowance.
+            if (info.seconds - end <= 1)
+                end = info.seconds;
+            if (info.path === 'decode' && end < info.seconds)
+                end = await quietestBefore(track, Math.max(start + options.overlapSeconds + 1, end - quiet), end);
+            if (index >= (options.fromIndex ?? 0)) {
+                const data = info.path === 'copy' ? await copyPiece(track, info.codec, start, end, end >= info.seconds) : await decodePiece(track, start, end);
+                if (data.length > options.maxBytes)
+                    throw new RangeError(`piece ${index} is ${data.length} bytes, past ${options.maxBytes}`);
+                const extension = info.path === 'decode' || info.codec === 'pcm-s16' ? 'wav' : COPY_TARGETS[info.codec].extension;
+                yield {
+                    index,
+                    startMs: Math.round(start * 1000),
+                    durationMs: Math.round((end - start) * 1000),
+                    data,
+                    mimeType: extension === 'wav' ? 'audio/wav' : COPY_TARGETS[info.codec].mimeType,
+                    fileName: `piece-${index}.${extension}`,
+                };
+            }
+            if (end >= info.seconds)
+                break;
+            start = Math.max(0, end - options.overlapSeconds);
+        }
+    }
+    finally {
+        input.dispose();
+    }
+}
+//# sourceMappingURL=cut.js.map

package/dist/io/hearing/pieces/cut.js.map

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

package/dist/io/hearing/pieces/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Audio pieces and their batch transcription, in a page or on a server. The only external import is
+ * the optional peer Mediabunny; this entry reaches no Node built-in.
+ * @module agentos/io/hearing/pieces
+ */
+export { planPieces, type PiecePlan } from './plan.js';
+export { readAudioInfo, pieceSeconds, type AudioInfo, UnreadableAudioError, COPY_TARGETS, MAX_COPIED_PCM_BYTES_PER_SECOND } from './read.js';
+export { wavHeaderSeconds, readWavPcm, type WavPcm } from './wav.js';
+export { cutPieces, type AudioPiece, type CutOptions } from './cut.js';
+export { transcribePieces, mergeSeam, lastSentence, PiecesFailed, type TranscribePiecesOptions, type PieceInput, type PieceTranscript, type TranscribePiece, type PieceOutcome, } from '../transcribePieces.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/io/hearing/pieces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,EACZ,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC"}

package/dist/io/hearing/pieces/index.js

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview Audio pieces and their batch transcription, in a page or on a server. The only external import is
+ * the optional peer Mediabunny; this entry reaches no Node built-in.
+ * @module agentos/io/hearing/pieces
+ */
+export { planPieces } from './plan.js';
+export { readAudioInfo, pieceSeconds, UnreadableAudioError, COPY_TARGETS, MAX_COPIED_PCM_BYTES_PER_SECOND } from './read.js';
+export { wavHeaderSeconds, readWavPcm } from './wav.js';
+export { cutPieces } from './cut.js';
+export { transcribePieces, mergeSeam, lastSentence, PiecesFailed, } from '../transcribePieces.js';
+//# sourceMappingURL=index.js.map

package/dist/io/hearing/pieces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAkB,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAkB,oBAAoB,EAAE,YAAY,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC7I,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,SAAS,EAAoC,MAAM,UAAU,CAAC;AACvE,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,YAAY,GAMb,MAAM,wBAAwB,CAAC"}

package/dist/io/hearing/pieces/plan.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Where the pieces of a recording start and end: `pieceSeconds` long, each starting `overlapSeconds`
+ * before the one before it ends; a remainder no longer than the overlap and one second joins the piece before it.
+ * @module agentos/io/hearing/pieces/plan
+ */
+/** One planned piece, in seconds. */
+export interface PiecePlan {
+    index: number;
+    start: number;
+    end: number;
+}
+/** The pieces of a recording of `seconds`. */
+export declare function planPieces(seconds: number, options: {
+    pieceSeconds: number;
+    overlapSeconds: number;
+}): PiecePlan[];
+//# sourceMappingURL=plan.d.ts.map

package/dist/io/hearing/pieces/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qCAAqC;AACrC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EAAE,CAiBlH"}

package/dist/io/hearing/pieces/plan.js

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Where the pieces of a recording start and end: `pieceSeconds` long, each starting `overlapSeconds`
+ * before the one before it ends; a remainder no longer than the overlap and one second joins the piece before it.
+ * @module agentos/io/hearing/pieces/plan
+ */
+/** The pieces of a recording of `seconds`. */
+export function planPieces(seconds, options) {
+    const { pieceSeconds, overlapSeconds } = options;
+    if (!Number.isFinite(seconds) || seconds <= 0)
+        throw new RangeError('planPieces: the length must be a positive number of seconds');
+    if (!Number.isFinite(pieceSeconds) || pieceSeconds < 10)
+        throw new RangeError('planPieces: a piece must be finite and 10 seconds or more');
+    if (!Number.isFinite(overlapSeconds) || overlapSeconds < 0 || overlapSeconds >= pieceSeconds)
+        throw new RangeError('planPieces: the overlap must be finite, nonnegative and shorter than a piece');
+    const step = pieceSeconds - overlapSeconds;
+    const pieces = [];
+    for (let start = 0, index = 0; start < seconds; start += step, index += 1) {
+        const end = Math.min(seconds, start + pieceSeconds);
+        if (pieces.length > 0 && end - start <= overlapSeconds + 1) {
+            pieces[pieces.length - 1].end = end;
+            break;
+        }
+        pieces.push({ index, start, end });
+        if (end >= seconds)
+            break;
+    }
+    return pieces;
+}
+//# sourceMappingURL=plan.js.map

package/dist/io/hearing/pieces/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/plan.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,8CAA8C;AAC9C,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,OAAyD;IACnG,MAAM,EAAE,YAAY,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IACjD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,6DAA6D,CAAC,CAAC;IACnI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,YAAY,GAAG,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,2DAA2D,CAAC,CAAC;IAC3I,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,IAAI,YAAY;QAAE,MAAM,IAAI,UAAU,CAAC,8EAA8E,CAAC,CAAC;IACnM,MAAM,IAAI,GAAG,YAAY,GAAG,cAAc,CAAC;IAC3C,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,GAAG,YAAY,CAAC,CAAC;QACpD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,GAAG,GAAG,GAAG,CAAC;YACrC,MAAM;QACR,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACnC,IAAI,GAAG,IAAI,OAAO;YAAE,MAAM;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/io/hearing/pieces/read.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview What a recording is, read with Mediabunny without decoding: its container, its audio codec, its length,
+ * and how its pieces are made. A piece's length read the same way on a server.
+ * @module agentos/io/hearing/pieces/read
+ */
+/** The containers and codecs a piece is copied into, and the type OpenAI's transcription reads it as. */
+export declare const COPY_TARGETS: {
+    readonly aac: {
+        readonly extension: "m4a";
+        readonly mimeType: "audio/mp4";
+    };
+    readonly opus: {
+        readonly extension: "webm";
+        readonly mimeType: "audio/webm";
+    };
+    readonly vorbis: {
+        readonly extension: "webm";
+        readonly mimeType: "audio/webm";
+    };
+    readonly mp3: {
+        readonly extension: "mp3";
+        readonly mimeType: "audio/mpeg";
+    };
+};
+/** PCM above this many bytes a second is decoded to 16 kHz mono (512 kbps). */
+export declare const MAX_COPIED_PCM_BYTES_PER_SECOND = 64000;
+/** Why a file cannot be cut. */
+export declare class UnreadableAudioError extends Error {
+    readonly reason: 'container' | 'no_audio' | 'unsupported_codec' | 'cannot_decode';
+    constructor(reason: 'container' | 'no_audio' | 'unsupported_codec' | 'cannot_decode');
+}
+/** A recording as read. */
+export interface AudioInfo {
+    container: string;
+    codec: string | null;
+    seconds: number;
+    sampleRate: number;
+    channels: number;
+    /** `copy`: packets copied into a container; `decode`: decoded to 16 kHz mono WAV; null: refused, with `reason`. */
+    path: 'copy' | 'decode' | null;
+    reason?: UnreadableAudioError['reason'];
+}
+/** Reads a recording's container, codec and length, and decides how its pieces are made. The signal can cancel the packet scan. */
+export declare function readAudioInfo(source: Blob | Uint8Array, signal?: AbortSignal): Promise<AudioInfo>;
+/** A piece's length in seconds, read from its container: what a server measures before it sends the piece on. */
+export declare function pieceSeconds(bytes: Uint8Array): Promise<number>;
+//# sourceMappingURL=read.d.ts.map

package/dist/io/hearing/pieces/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/read.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,yGAAyG;AACzG,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;CAKf,CAAC;AAEX,+EAA+E;AAC/E,eAAO,MAAM,+BAA+B,QAAS,CAAC;AAItD,gCAAgC;AAChC,qBAAa,oBAAqB,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,mBAAmB,GAAG,eAAe;gBAAxE,MAAM,EAAE,WAAW,GAAG,UAAU,GAAG,mBAAmB,GAAG,eAAe;CAI9F;AAED,2BAA2B;AAC3B,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,mHAAmH;IACnH,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IAC/B,MAAM,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CACzC;AAYD,mIAAmI;AACnI,wBAAsB,aAAa,CAAC,MAAM,EAAE,IAAI,GAAG,UAAU,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAsCvG;AAED,iHAAiH;AACjH,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAYrE"}

package/dist/io/hearing/pieces/read.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview What a recording is, read with Mediabunny without decoding: its container, its audio codec, its length,
+ * and how its pieces are made. A piece's length read the same way on a server.
+ * @module agentos/io/hearing/pieces/read
+ */
+import { ALL_FORMATS, BlobSource, BufferSource, EncodedPacketSink, Input } from 'mediabunny';
+/** The containers and codecs a piece is copied into, and the type OpenAI's transcription reads it as. */
+export const COPY_TARGETS = {
+    aac: { extension: 'm4a', mimeType: 'audio/mp4' },
+    opus: { extension: 'webm', mimeType: 'audio/webm' },
+    vorbis: { extension: 'webm', mimeType: 'audio/webm' },
+    mp3: { extension: 'mp3', mimeType: 'audio/mpeg' },
+};
+/** PCM above this many bytes a second is decoded to 16 kHz mono (512 kbps). */
+export const MAX_COPIED_PCM_BYTES_PER_SECOND = 64000;
+const REFUSED = new Set(['ac3', 'eac3', 'dts']);
+/** Why a file cannot be cut. */
+export class UnreadableAudioError extends Error {
+    constructor(reason) {
+        super(`the recording cannot be read (${reason})`);
+        this.reason = reason;
+        this.name = 'UnreadableAudioError';
+    }
+}
+function inputOf(source) {
+    return new Input({ formats: ALL_FORMATS, source: source instanceof Uint8Array ? new BufferSource(source) : new BlobSource(source) });
+}
+/** The bytes a second of a PCM codec at a rate and channel count, or null for a codec that is not PCM. */
+function pcmBytesPerSecond(codec, sampleRate, channels) {
+    const bits = /^pcm-[suf](8|16|24|32|64)/.exec(codec)?.[1] ?? (codec === 'ulaw' || codec === 'alaw' ? '8' : null);
+    return bits === null ? null : (Number(bits) / 8) * sampleRate * channels;
+}
+/** Reads a recording's container, codec and length, and decides how its pieces are made. The signal can cancel the packet scan. */
+export async function readAudioInfo(source, signal) {
+    signal?.throwIfAborted();
+    const input = inputOf(source);
+    try {
+        let container;
+        try {
+            container = (await input.getFormat()).name;
+        }
+        catch {
+            throw new UnreadableAudioError('container');
+        }
+        signal?.throwIfAborted();
+        const track = await input.getPrimaryAudioTrack();
+        if (track === null)
+            return { container, codec: null, seconds: 0, sampleRate: 0, channels: 0, path: null, reason: 'no_audio' };
+        const codec = await track.getCodec();
+        const [seconds, sampleRate, channels] = await Promise.all([track.computeDuration(), track.getSampleRate(), track.getNumberOfChannels()]);
+        signal?.throwIfAborted();
+        const base = { container, codec, seconds, sampleRate, channels };
+        if (codec === null || REFUSED.has(codec))
+            return { ...base, path: null, reason: 'unsupported_codec' };
+        if (codec in COPY_TARGETS) {
+            // Compressed tracks can exceed the copy limit too; count their packets without decoding or retaining them.
+            let bytes = 0;
+            for await (const packet of new EncodedPacketSink(track).packets()) {
+                signal?.throwIfAborted();
+                bytes += packet.data.byteLength;
+                if (bytes > seconds * MAX_COPIED_PCM_BYTES_PER_SECOND) {
+                    return (await track.canDecode()) ? { ...base, path: 'decode' } : { ...base, path: null, reason: 'cannot_decode' };
+                }
+            }
+            signal?.throwIfAborted();
+            return { ...base, path: 'copy' };
+        }
+        const pcm = pcmBytesPerSecond(codec, sampleRate, channels);
+        // 'pcm-s16' is little-endian; 'pcm-s16be' and every other PCM codec is decoded (Mediabunny's src/codec.ts lines 59 to 71).
+        if (pcm !== null && pcm <= MAX_COPIED_PCM_BYTES_PER_SECOND && codec === 'pcm-s16')
+            return { ...base, path: 'copy' };
+        return (await track.canDecode()) ? { ...base, path: 'decode' } : { ...base, path: null, reason: 'cannot_decode' };
+    }
+    finally {
+        input.dispose();
+    }
+}
+/** A piece's length in seconds, read from its container: what a server measures before it sends the piece on. */
+export async function pieceSeconds(bytes) {
+    const input = inputOf(bytes);
+    try {
+        const track = await input.getPrimaryAudioTrack();
+        if (track === null)
+            throw new UnreadableAudioError('no_audio');
+        return await track.computeDuration();
+    }
+    catch (error) {
+        if (error instanceof UnreadableAudioError)
+            throw error;
+        throw new UnreadableAudioError('container');
+    }
+    finally {
+        input.dispose();
+    }
+}
+//# sourceMappingURL=read.js.map

package/dist/io/hearing/pieces/read.js.map

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

package/dist/io/hearing/pieces/wav.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @fileoverview WAVE durations and planar PCM samples read through DataView, in a page or on a server.
+ * @module agentos/io/hearing/pieces/wav
+ */
+/** A WAVE recording's rate, channel count and samples, one array per channel. */
+export interface WavPcm {
+    sampleRate: number;
+    channels: number;
+    samples: Float32Array[];
+}
+/** Reads seconds from the WAVE header's byte rate and declared data length; the sample bytes need not be present. */
+export declare function wavHeaderSeconds(bytes: Uint8Array): number;
+/** Reads 16-bit integer or 32-bit float PCM from a WAVE file into one Float32Array per channel. */
+export declare function readWavPcm(bytes: Uint8Array): WavPcm;
+//# sourceMappingURL=wav.d.ts.map

package/dist/io/hearing/pieces/wav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wav.d.ts","sourceRoot":"","sources":["../../../../src/io/hearing/pieces/wav.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,iFAAiF;AACjF,MAAM,WAAW,MAAM;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAoDD,qHAAqH;AACrH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAG1D;AAED,mGAAmG;AACnG,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAcpD"}

package/dist/io/hearing/pieces/wav.js

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview WAVE durations and planar PCM samples read through DataView, in a page or on a server.
+ * @module agentos/io/hearing/pieces/wav
+ */
+import { UnreadableAudioError } from './read.js';
+/** Reads RIFF chunks, including padding, without requiring a data chunk's payload for a header read. */
+function chunksOf(bytes, headerOnly) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const fourCC = (offset) => String.fromCharCode(view.getUint8(offset), view.getUint8(offset + 1), view.getUint8(offset + 2), view.getUint8(offset + 3));
+    if (bytes.length < 12 || fourCC(0) !== 'RIFF' || fourCC(8) !== 'WAVE')
+        throw new UnreadableAudioError('container');
+    const limit = view.getUint32(4, true) + 8;
+    if (limit < 12 || (!headerOnly && limit > bytes.length))
+        throw new UnreadableAudioError('container');
+    let formatOffset;
+    let dataOffset;
+    let dataLength = 0;
+    for (let offset = 12; offset + 8 <= Math.min(limit, bytes.length);) {
+        const name = fourCC(offset);
+        const length = view.getUint32(offset + 4, true);
+        const payload = offset + 8;
+        if (payload + length > limit)
+            throw new UnreadableAudioError('container');
+        if (name === 'data') {
+            dataOffset ?? (dataOffset = payload);
+            if (dataOffset === payload)
+                dataLength = length;
+            if (headerOnly && formatOffset !== undefined)
+                break;
+        }
+        if (payload + length > bytes.length)
+            throw new UnreadableAudioError('container');
+        if (name === 'fmt ' && formatOffset === undefined) {
+            if (length < 16)
+                throw new UnreadableAudioError('container');
+            formatOffset = payload;
+        }
+        offset = payload + length + (length % 2);
+    }
+    if (formatOffset === undefined || dataOffset === undefined)
+        throw new UnreadableAudioError('container');
+    const format = view.getUint16(formatOffset, true);
+    const channels = view.getUint16(formatOffset + 2, true);
+    const sampleRate = view.getUint32(formatOffset + 4, true);
+    const byteRate = view.getUint32(formatOffset + 8, true);
+    const blockAlign = view.getUint16(formatOffset + 12, true);
+    const bits = view.getUint16(formatOffset + 14, true);
+    if (channels === 0 || sampleRate === 0 || byteRate === 0 || blockAlign === 0)
+        throw new UnreadableAudioError('container');
+    return { view, format, channels, sampleRate, byteRate, blockAlign, bits, dataOffset, dataLength };
+}
+/** Reads seconds from the WAVE header's byte rate and declared data length; the sample bytes need not be present. */
+export function wavHeaderSeconds(bytes) {
+    const { byteRate, dataLength } = chunksOf(bytes, true);
+    return dataLength / byteRate;
+}
+/** Reads 16-bit integer or 32-bit float PCM from a WAVE file into one Float32Array per channel. */
+export function readWavPcm(bytes) {
+    const { view, format, channels, sampleRate, byteRate, blockAlign, bits, dataOffset, dataLength } = chunksOf(bytes, false);
+    if (!((format === 1 && bits === 16) || (format === 3 && bits === 32)))
+        throw new UnreadableAudioError('unsupported_codec');
+    const width = bits / 8;
+    if (blockAlign !== channels * width || byteRate !== sampleRate * blockAlign || dataLength % blockAlign !== 0)
+        throw new UnreadableAudioError('container');
+    const frames = dataLength / blockAlign;
+    const samples = Array.from({ length: channels }, () => new Float32Array(frames));
+    for (let frame = 0; frame < frames; frame += 1) {
+        for (let channel = 0; channel < channels; channel += 1) {
+            const offset = dataOffset + frame * blockAlign + channel * width;
+            samples[channel][frame] = format === 1 ? view.getInt16(offset, true) / 32768 : view.getFloat32(offset, true);
+        }
+    }
+    return { sampleRate, channels, samples };
+}
+//# sourceMappingURL=wav.js.map

package/dist/io/hearing/pieces/wav.js.map

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

package/dist/safety/sandbox/subprocess/CLISubprocessBridge.d.ts

@@ -108,6 +108,11 @@ export declare abstract class CLISubprocessBridge {
      * Spawns the binary with `--output-format stream-json` and yields
      * {@link StreamEvent}s parsed from newline-delimited JSON on stdout.
      *
+     * Read to its end, the stream awaits the process's exit and throws on a
+     * failed one. A consumer that stops reading before the end (a `break` in
+     * its `for await`, or `return()`) ends the process instead: it is killed,
+     * and its outcome is handled here.
+     *
      * @param options — bridge options
      * @yields typed stream events (text_delta, result, error, system)
      * @throws {CLISubprocessError} on subprocess failure (via {@link classifyError})

package/dist/safety/sandbox/subprocess/CLISubprocessBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CLISubprocessBridge.d.ts","sourceRoot":"","sources":["../../../../src/safety/sandbox/subprocess/CLISubprocessBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8BH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,mBAAmB;IAIvC,uEAAuE;IACvE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE/C;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE;IAEpF;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,kBAAkB;IAEhE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IAIjE;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;IAiB3E;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAOjE;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAO9C;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAezD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAW5C;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB5D;;;;;;;;OAQG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;CAmDpF"}
+{"version":3,"file":"CLISubprocessBridge.d.ts","sourceRoot":"","sources":["../../../../src/safety/sandbox/subprocess/CLISubprocessBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AA8BH,OAAO,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAC9C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,kBAAkB,EACnB,MAAM,SAAS,CAAC;AAKjB;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,mBAAmB;IAIvC,uEAAuE;IACvE,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE/C;;;;;;;OAOG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,GAAG,MAAM,EAAE;IAEpF;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,kBAAkB;IAEhE;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,GAAG,IAAI;IAIjE;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY;IAiB3E;;;OAGG;IACH,SAAS,CAAC,kBAAkB,IAAI;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE;IAOjE;;;OAGG;IACH,SAAS,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAO9C;;;OAGG;IACG,oBAAoB,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAezD;;;OAGG;IACG,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAW5C;;;;;;;;OAQG;IACG,OAAO,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAoB5D;;;;;;;;;;;;;OAaG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,SAAS,CAAC;CAkEpF"}

package/dist/safety/sandbox/subprocess/CLISubprocessBridge.js

@@ -169,6 +169,11 @@ export class CLISubprocessBridge {
      * Spawns the binary with `--output-format stream-json` and yields
      * {@link StreamEvent}s parsed from newline-delimited JSON on stdout.
      *
+     * Read to its end, the stream awaits the process's exit and throws on a
+     * failed one. A consumer that stops reading before the end (a `break` in
+     * its `for await`, or `return()`) ends the process instead: it is killed,
+     * and its outcome is handled here.
+     *
      * @param options — bridge options
      * @yields typed stream events (text_delta, result, error, system)
      * @throws {CLISubprocessError} on subprocess failure (via {@link classifyError})
@@ -189,6 +194,10 @@ export class CLISubprocessBridge {
             throw this.classifyError(error);
         }
         let buffer = '';
+        /* Set once stdout has been read to its end and the run is awaited below.
+         * A consumer that stops reading early (a break in its for await, or
+         * return()) closes this generator at a yield, before that point. */
+        let readToEnd = false;
         try {
             for await (const chunk of subprocess.stdout) {
                 buffer += chunk.toString();
@@ -217,12 +226,24 @@ export class CLISubprocessBridge {
                 }
                 catch { /* ignore */ }
             }
+            readToEnd = true;
             /* Ensure non-zero exits after stdout drains still surface as errors. */
             await subprocess;
         }
         catch (error) {
             throw this.classifyError(error);
         }
+        finally {
+            /* Left before the run was awaited: nothing reads the process any more.
+             * End it (execa's kill: SIGTERM, then SIGKILL if it outlives the force
+             * delay) and handle its outcome, so a failed exit that follows is not an
+             * unhandled rejection in the host, which Node raises as an uncaught
+             * exception by default. */
+            if (!readToEnd) {
+                subprocess.kill();
+                subprocess.catch(() => undefined);
+            }
+        }
     }
 }
 //# sourceMappingURL=CLISubprocessBridge.js.map