@rimelabs/sdk 0.1.0-alpha.2 → 0.1.0-alpha.21

package/dist/stt/client.js

@@ -0,0 +1,121 @@
+import { connect, metadata } from "../grpc.js";
+import { timeout } from "../validation.js";
+import { RimeInputError, RimeAudioFormatError, RimeResourceLimitError, RimeCancelledError, RimeTimeoutError, } from "../errors.js";
+import { scope } from "../cancellation.js";
+import { resolvePCMFormat } from "../pcm.js";
+import { transport, requireSchema, transcribe, MAX_WAV_BYTES, } from "./transport.js";
+import { TranscriptStream } from "./stream.js";
+import { policy } from "./policy.js";
+export class STT {
+    credentials;
+    checkOpen;
+    connection = null;
+    streams = new Set();
+    cancellation = new AbortController();
+    requests = new Set();
+    constructor(credentials, checkOpen) {
+        this.credentials = credentials;
+        this.checkOpen = checkOpen;
+    }
+    /** Transcribe complete WAV bytes (at most 16 MiB), without replay or retries. */
+    transcribe(audio, options) {
+        this.checkOpen();
+        if (!(audio instanceof Uint8Array) || audio.byteLength === 0)
+            throw new RimeAudioFormatError("audio must contain complete WAV bytes");
+        if (audio.byteLength > MAX_WAV_BYTES)
+            throw new RimeResourceLimitError("WAV input exceeds 16 MiB");
+        validateOptions(options);
+        const settings = {
+            ...options,
+            contextTerms: [...(options.contextTerms ?? [])],
+        };
+        const data = Buffer.from(audio);
+        const deadline = scope([options.signal, this.cancellation.signal], timeout(options.timeout) ?? undefined, new RimeTimeoutError("Overall transcription deadline expired"));
+        const operation = (async () => {
+            try {
+                const prepared = await this.prepare(deadline.signal, policy.target);
+                return await transcribe(prepared.client, prepared.metadata, data, settings, deadline.signal);
+            }
+            catch (error) {
+                if (deadline.signal.aborted &&
+                    !(error instanceof RimeTimeoutError) &&
+                    !(error instanceof RimeCancelledError)) {
+                    if (deadline.signal.reason instanceof RimeTimeoutError)
+                        throw deadline.signal.reason;
+                    throw new RimeCancelledError("Transcription cancelled");
+                }
+                throw error;
+            }
+            finally {
+                deadline.dispose();
+            }
+        })();
+        this.requests.add(operation);
+        void operation.then(() => this.requests.delete(operation), () => this.requests.delete(operation));
+        return operation;
+    }
+    async prepare(signal, target) {
+        this.checkOpen();
+        requireSchema();
+        signal.throwIfAborted();
+        const headers = metadata(this.credentials.authorization());
+        this.connection ??= transport.makeClient(target);
+        await connect(this.connection, signal, policy.connectionTimeout);
+        signal.throwIfAborted();
+        return { client: this.connection, metadata: headers };
+    }
+    stream(source, options) {
+        this.checkOpen();
+        if (!source || typeof source[Symbol.asyncIterator] !== "function")
+            throw new RimeInputError("audio must be an async iterable of Uint8Array chunks");
+        validateOptions(options);
+        const outputContract = options.outputContract ?? "revised_hypotheses";
+        if (outputContract !== "revised_hypotheses" &&
+            outputContract !== "append_fragments")
+            throw new RimeInputError("outputContract must be revised_hypotheses or append_fragments");
+        const mode = options.mode ?? "written";
+        const terms = options.contextTerms ?? [];
+        const format = resolvePCMFormat(options.inputFormat);
+        const target = policy.target;
+        const stream = new TranscriptStream({
+            checkOpen: this.checkOpen,
+            forget: (stream) => this.streams.delete(stream),
+            prepare: (signal) => this.prepare(signal, target),
+        }, source, {
+            language: options.language,
+            outputContract,
+            mode,
+            contextTerms: [...terms],
+            inputFormat: format,
+            timeout: timeout(options.timeout),
+            signal: options.signal,
+        });
+        this.streams.add(stream);
+        return stream;
+    }
+    async close() {
+        this.cancellation.abort(new RimeCancelledError("Client closed"));
+        try {
+            const results = await Promise.allSettled([
+                ...[...this.streams].map((stream) => stream.cancel()),
+                ...[...this.requests].map((request) => request.catch(() => { })),
+            ]);
+            for (const result of results)
+                if (result.status === "rejected")
+                    throw result.reason;
+        }
+        finally {
+            this.connection?.close();
+        }
+    }
+}
+function validateOptions(options) {
+    if (!options || typeof options.language !== "string")
+        throw new RimeInputError("language must be a string");
+    const mode = options.mode ?? "written";
+    if (mode !== "written" && mode !== "verbatim")
+        throw new RimeInputError("mode must be written or verbatim");
+    const terms = options.contextTerms ?? [];
+    if (!Array.isArray(terms) || terms.some((term) => typeof term !== "string"))
+        throw new RimeInputError("contextTerms must be an array of strings");
+}

package/dist/stt/policy.d.ts

@@ -0,0 +1,11 @@
+/** Independent resource and transport limits for recognition. Durations are seconds. */
+export declare const policy: {
+    target: string;
+    connectionTimeout: number;
+    acceptanceTimeout: number;
+    completionTimeout: number;
+    cleanupTimeout: number;
+    receiveBytes: number;
+    transcriptBytes: number;
+    queuedUpdates: number;
+};

package/dist/stt/policy.js

@@ -0,0 +1,11 @@
+/** Independent resource and transport limits for recognition. Durations are seconds. */
+export const policy = {
+    target: "stt.api.rime.ai:443",
+    connectionTimeout: 10,
+    acceptanceTimeout: 10,
+    completionTimeout: 120,
+    cleanupTimeout: 2,
+    receiveBytes: 1048576 + 65536,
+    transcriptBytes: 1048576,
+    queuedUpdates: 16,
+};

package/dist/stt/protocol.d.ts

@@ -0,0 +1,14 @@
+import * as schema from "@rimelabs/api";
+import type { TranscriptionPartial, TranscriptionDelta, TranscriptionFinal, TranscriptionOutputContract } from "./types.js";
+/** Validate the wire sequence before exposing any final result. */
+export declare class TranscriptState {
+    private readonly textLimit;
+    private readonly outputContract;
+    language: string | null;
+    private revision;
+    private text;
+    private final;
+    constructor(textLimit: number, outputContract?: TranscriptionOutputContract);
+    accept(message: schema.StreamingTranscriptionResponse, inputDone: boolean): TranscriptionPartial | TranscriptionDelta | null;
+    finish(): TranscriptionFinal;
+}

package/dist/stt/protocol.js

@@ -0,0 +1,76 @@
+import * as schema from "@rimelabs/api";
+import { RimeStreamError, RimeResourceLimitError } from "../errors.js";
+/** Validate the wire sequence before exposing any final result. */
+export class TranscriptState {
+    textLimit;
+    outputContract;
+    language = null;
+    revision = 0n;
+    text = "";
+    final = null;
+    constructor(textLimit, outputContract = "revised_hypotheses") {
+        this.textLimit = textLimit;
+        this.outputContract = outputContract;
+    }
+    accept(message, inputDone) {
+        const payload = message.payload;
+        if (payload.case === undefined)
+            return null;
+        if (this.final)
+            throw new RimeStreamError("Received a message after transcription completion");
+        if (payload.case === "accepted") {
+            const accepted = payload.value;
+            if (this.language !== null)
+                throw new RimeStreamError("Received duplicate transcription acceptance");
+            if (accepted.outputContract !==
+                (this.outputContract === "append_fragments"
+                    ? schema.StreamingOutputContract.APPEND_FRAGMENTS
+                    : schema.StreamingOutputContract.REVISED_HYPOTHESES))
+                throw new RimeStreamError("The service accepted a different transcript contract");
+            if (!accepted.language?.tag || !accepted.language.source)
+                throw new RimeStreamError("The service did not confirm a resolved language");
+            this.language = accepted.language.tag;
+            return null;
+        }
+        if (this.language === null)
+            throw new RimeStreamError("Received a transcript before acceptance");
+        const append = this.outputContract === "append_fragments";
+        if (payload.case === "delta" && append) {
+            const text = payload.value.text;
+            if (Buffer.byteLength(this.text) + Buffer.byteLength(text) >
+                this.textLimit)
+                throw new RimeResourceLimitError("The transcript exceeds the SDK text limit");
+            this.text += text;
+            return { kind: "delta", text };
+        }
+        if (payload.case !== "hypothesis" && payload.case !== "done")
+            throw new RimeStreamError("Received an unexpected transcription response");
+        if (payload.case === "hypothesis" && append)
+            throw new RimeStreamError("Received an unexpected transcription response");
+        const value = payload.value;
+        if (Buffer.byteLength(value.text, "utf8") > this.textLimit)
+            throw new RimeResourceLimitError("The transcript exceeds the SDK text limit");
+        if (payload.case === "hypothesis") {
+            if (value.revision <= this.revision ||
+                (this.revision === 0n && value.revision !== 1n))
+                throw new RimeStreamError("Transcript revisions are not increasing from one");
+            this.revision = value.revision;
+            this.text = value.text;
+            return { kind: "partial", text: value.text };
+        }
+        if (!inputDone)
+            throw new RimeStreamError("The service completed before input finished");
+        if (value.revision !== this.revision || value.text !== this.text)
+            throw new RimeStreamError("Final transcript does not match prior updates");
+        const language = payload.value.language;
+        if (language?.tag !== this.language || !language.source)
+            throw new RimeStreamError("Final language does not match the accepted language");
+        this.final = { kind: "final", text: value.text, language: language.tag };
+        return null;
+    }
+    finish() {
+        if (!this.final)
+            throw new RimeStreamError("The service ended without a final transcript");
+        return this.final;
+    }
+}

package/dist/stt/queue.d.ts

@@ -0,0 +1,16 @@
+import type { TranscriptionUpdate } from "./types.js";
+/** Bounded, atomic transcript events; failure wakes producers and consumers. */
+export declare class TranscriptQueue {
+    private readonly limit;
+    private items;
+    private closed;
+    private error;
+    private waiters;
+    constructor(limit: number);
+    private wait;
+    private wake;
+    put(value: TranscriptionUpdate): Promise<void>;
+    get(): Promise<IteratorResult<TranscriptionUpdate>>;
+    finish(): void;
+    fail(error: Error): void;
+}

package/dist/stt/queue.js

@@ -0,0 +1,45 @@
+/** Bounded, atomic transcript events; failure wakes producers and consumers. */
+export class TranscriptQueue {
+    limit;
+    items = [];
+    closed = false;
+    error = null;
+    waiters = new Set();
+    constructor(limit) {
+        this.limit = limit;
+    }
+    wait() {
+        return new Promise((resolve) => this.waiters.add(resolve));
+    }
+    wake() {
+        for (const resolve of this.waiters)
+            resolve();
+        this.waiters.clear();
+    }
+    async put(value) {
+        while (!this.closed && this.items.length >= this.limit)
+            await this.wait();
+        if (!this.closed) {
+            this.items.push(value);
+            this.wake();
+        }
+    }
+    async get() {
+        while (!this.closed && !this.items.length)
+            await this.wait();
+        if (this.error)
+            throw this.error;
+        const value = this.items.shift();
+        this.wake();
+        return value ? { done: false, value } : { done: true, value: undefined };
+    }
+    finish() {
+        this.closed = true;
+        this.wake();
+    }
+    fail(error) {
+        this.error ??= error;
+        this.items = [];
+        this.finish();
+    }
+}

package/dist/stt/stream.d.ts

@@ -0,0 +1,48 @@
+import type * as grpc from "@grpc/grpc-js";
+import type { AudioSource, TranscriptionOptions, TranscriptionUpdate } from "./types.js";
+interface StreamOwner {
+    prepare(signal: AbortSignal): Promise<{
+        client: grpc.Client;
+        metadata: grpc.Metadata;
+    }>;
+    checkOpen(): void;
+    forget(stream: TranscriptStream): void;
+}
+/** Lazy, single-consumer stream. Source exhaustion commits input; return/cancel aborts it. */
+export declare class TranscriptStream implements AsyncIterableIterator<TranscriptionUpdate> {
+    private readonly owner;
+    private source;
+    private readonly options;
+    private readonly controller;
+    private readonly queue;
+    private readonly timers;
+    private worker;
+    private workerFinished;
+    private call;
+    private failure;
+    private reading;
+    private finished;
+    private inputDone;
+    private accepted;
+    private readonly acceptance;
+    private admission;
+    private completion;
+    private readonly externalAbort;
+    constructor(owner: StreamOwner, source: AudioSource | null, options: TranscriptionOptions);
+    /** Server request identity, available once response headers arrive. */
+    get requestId(): string | null;
+    private deadline;
+    private start;
+    private fail;
+    private produce;
+    private read;
+    private run;
+    [Symbol.asyncIterator](): this;
+    next(): Promise<IteratorResult<TranscriptionUpdate>>;
+    private cleanup;
+    /** Cancel unfinished work and release owned resources; safe to repeat. */
+    cancel(): Promise<void>;
+    return(): Promise<IteratorResult<TranscriptionUpdate>>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export {};

package/dist/stt/stream.js

@@ -0,0 +1,224 @@
+import { abortable, scope } from "../cancellation.js";
+import { RimeError, RimeInputError, RimeCancelledError, RimeTimeoutError, RimeStreamError, } from "../errors.js";
+import { InputAudio } from "./audio.js";
+import { TranscriptQueue } from "./queue.js";
+import { TranscriptState } from "./protocol.js";
+import { TranscriptionCall } from "./transport.js";
+import { policy } from "./policy.js";
+/** Lazy, single-consumer stream. Source exhaustion commits input; return/cancel aborts it. */
+export class TranscriptStream {
+    owner;
+    source;
+    options;
+    controller = new AbortController();
+    queue = new TranscriptQueue(policy.queuedUpdates);
+    timers = new Set();
+    worker = null;
+    workerFinished = false;
+    call = null;
+    failure = null;
+    reading = false;
+    finished = false;
+    inputDone = false;
+    accepted;
+    acceptance = new Promise((resolve) => {
+        this.accepted = resolve;
+    });
+    admission = null;
+    completion = null;
+    externalAbort = () => this.fail(new RimeCancelledError("Transcription cancelled"));
+    constructor(owner, source, options) {
+        this.owner = owner;
+        this.source = source;
+        this.options = options;
+    }
+    /** Server request identity, available once response headers arrive. */
+    get requestId() {
+        return this.call?.requestId ?? null;
+    }
+    deadline(seconds, message) {
+        const timer = scope([], seconds, new RimeTimeoutError(message));
+        timer.signal.addEventListener("abort", () => this.fail(timer.signal.reason), { once: true });
+        if (timer.signal.aborted)
+            this.fail(timer.signal.reason);
+        this.timers.add(timer);
+        return timer;
+    }
+    start() {
+        if (this.failure)
+            throw this.failure;
+        if (this.finished || this.worker)
+            return;
+        this.owner.checkOpen();
+        if (this.options.signal?.aborted) {
+            this.externalAbort();
+            throw this.failure;
+        }
+        this.options.signal?.addEventListener("abort", this.externalAbort, {
+            once: true,
+        });
+        if (this.options.timeout != null)
+            this.deadline(this.options.timeout, "Overall transcription deadline expired");
+        this.worker = this.run();
+    }
+    fail(error) {
+        if (this.failure || this.finished)
+            return;
+        if (error.requestId === null && this.requestId !== null)
+            error = new error.constructor(error.message, this.requestId, { cause: error.cause });
+        this.failure = error;
+        this.queue.fail(error);
+        for (const timer of this.timers)
+            timer.dispose();
+        this.controller.abort(error);
+        this.call?.cancel();
+        this.options.signal?.removeEventListener("abort", this.externalAbort);
+        if (!this.worker || this.workerFinished) {
+            this.source = null;
+            this.owner.forget(this);
+        }
+    }
+    async produce() {
+        const signal = this.controller.signal;
+        await abortable(this.acceptance, signal);
+        const audio = new InputAudio(this.options.inputFormat);
+        let iterator;
+        try {
+            try {
+                iterator = this.source[Symbol.asyncIterator]();
+            }
+            catch (error) {
+                throw new RimeInputError("The audio source failed", this.requestId, {
+                    cause: error,
+                });
+            }
+            for (;;) {
+                let result;
+                try {
+                    result = await abortable(iterator.next(), signal);
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        throw signal.reason;
+                    throw new RimeInputError("The audio source failed", this.requestId, {
+                        cause: error,
+                    });
+                }
+                if (result.done)
+                    break;
+                for (const part of audio.feed(result.value))
+                    await this.call.writeAudio(part);
+            }
+            audio.finish();
+            this.inputDone = true;
+            this.completion = this.deadline(policy.completionTimeout, "Transcription completion timed out");
+            this.call.finishInput();
+        }
+        finally {
+            if (iterator?.return) {
+                const cleanup = scope([], policy.cleanupTimeout, new RimeTimeoutError("Audio source cleanup timed out"));
+                try {
+                    await abortable(Promise.resolve().then(() => iterator.return()), cleanup.signal);
+                }
+                catch {
+                    /* Caller-owned source cleanup cannot replace the operation outcome. */
+                }
+                finally {
+                    cleanup.dispose();
+                }
+            }
+        }
+    }
+    async read() {
+        const state = new TranscriptState(policy.transcriptBytes, this.options.outputContract);
+        for await (const message of this.call.responses()) {
+            const update = state.accept(message, this.inputDone);
+            if (state.language !== null) {
+                this.admission?.dispose();
+                this.accepted();
+            }
+            if (update)
+                await this.queue.put(update);
+        }
+        return state.finish();
+    }
+    async run() {
+        let tasks = [];
+        try {
+            const prepared = await this.owner.prepare(this.controller.signal);
+            this.controller.signal.throwIfAborted();
+            this.call = new TranscriptionCall(prepared.client, prepared.metadata, this.controller.signal);
+            this.admission = this.deadline(policy.acceptanceTimeout, "Transcription acceptance timed out");
+            await this.call.start(this.options.language, this.options.mode ?? "written", this.options.contextTerms ?? [], this.options.outputContract);
+            const producer = this.produce(), reader = this.read();
+            tasks = [producer, reader];
+            const [, final] = await Promise.all([producer, reader]);
+            this.completion?.dispose();
+            await this.queue.put(final);
+            this.queue.finish();
+        }
+        catch (error) {
+            this.fail(error instanceof RimeError
+                ? error
+                : new RimeStreamError("Transcription failed", this.requestId, {
+                    cause: error,
+                }));
+        }
+        finally {
+            if (this.failure)
+                this.controller.abort(this.failure);
+            this.call?.cancel();
+            await Promise.allSettled(tasks);
+            this.source = null;
+            this.workerFinished = true;
+            if (this.failure)
+                this.owner.forget(this);
+        }
+    }
+    [Symbol.asyncIterator]() {
+        return this;
+    }
+    async next() {
+        if (this.reading)
+            throw new RimeInputError("TranscriptStream permits only one concurrent reader");
+        this.reading = true;
+        try {
+            this.start();
+            if (this.finished)
+                return { done: true, value: undefined };
+            const result = await this.queue.get();
+            if (this.failure)
+                throw this.failure;
+            if (!result.done && result.value.kind === "final") {
+                await this.cleanup();
+                if (this.failure)
+                    throw this.failure;
+                this.finished = true;
+            }
+            return result;
+        }
+        finally {
+            this.reading = false;
+        }
+    }
+    async cleanup() {
+        await this.worker;
+        for (const timer of this.timers)
+            timer.dispose();
+        this.options.signal?.removeEventListener("abort", this.externalAbort);
+        this.owner.forget(this);
+    }
+    /** Cancel unfinished work and release owned resources; safe to repeat. */
+    async cancel() {
+        this.fail(new RimeCancelledError("Transcription cancelled"));
+        await this.cleanup();
+        this.source = null;
+    }
+    async return() {
+        await this.cancel();
+        return { done: true, value: undefined };
+    }
+    async [Symbol.asyncDispose]() {
+        await this.cancel();
+    }
+}

package/dist/stt/transport.d.ts

@@ -0,0 +1,15 @@
+import * as grpc from "@grpc/grpc-js";
+import * as schema from "@rimelabs/api";
+import { BidiCall } from "../grpc.js";
+import type { TranscriptionMode, TranscribeOptions, Transcription } from "./types.js";
+export declare const MAX_WAV_BYTES: number;
+export declare function requireSchema(): void;
+export declare const transport: {
+    makeClient: (target: string) => grpc.Client;
+};
+export declare function transcribe(client: grpc.Client, auth: grpc.Metadata, audio: Uint8Array, options: TranscribeOptions, signal: AbortSignal): Promise<Transcription>;
+export declare class TranscriptionCall extends BidiCall<schema.StreamingTranscriptionRequest, schema.StreamingTranscriptionResponse> {
+    constructor(client: grpc.Client, auth: grpc.Metadata, signal: AbortSignal);
+    start(language: string, mode: TranscriptionMode, contextTerms: readonly string[], outputContract?: import("./types.js").TranscriptionOutputContract): Promise<void>;
+    writeAudio(audio: Uint8Array): Promise<void>;
+}

package/dist/stt/transport.js

@@ -0,0 +1,94 @@
+import * as grpc from "@grpc/grpc-js";
+import { create } from "@bufbuild/protobuf";
+import * as schema from "@rimelabs/api";
+import { BidiCall, serializer, deserializer, requestId, nativeError, } from "../grpc.js";
+import { abortable, scope } from "../cancellation.js";
+import { RimeInputError, RimeStreamError, RimeResourceLimitError, RimeTimeoutError, RimeCancelledError, } from "../errors.js";
+import { policy } from "./policy.js";
+export const MAX_WAV_BYTES = 16 * 1024 * 1024;
+export function requireSchema() {
+    if (!schema.SpeechToText)
+        throw new RimeInputError("STT requires @rimelabs/api with SpeechToText definitions");
+}
+export const transport = {
+    makeClient: (target) => new grpc.Client(target, grpc.credentials.createSsl(), {
+        "grpc.enable_retries": 0,
+        "grpc.max_receive_message_length": policy.receiveBytes,
+        "grpc.max_send_message_length": MAX_WAV_BYTES + 65536,
+    }),
+};
+export async function transcribe(client, auth, audio, options, signal) {
+    const method = schema.SpeechToText.method.transcribe;
+    const deadline = scope([signal], policy.completionTimeout, new RimeTimeoutError("Transcription request timed out"));
+    let call;
+    let id = null;
+    try {
+        deadline.signal.throwIfAborted();
+        const result = await abortable(new Promise((resolve, reject) => {
+            call = client.makeUnaryRequest(`/${schema.SpeechToText.typeName}/${method.name}`, serializer(method.input), deserializer(method.output), create(method.input, {
+                audio,
+                options: {
+                    language: options.language,
+                    mode: options.mode === "verbatim"
+                        ? schema.TranscriptionMode.VERBATIM
+                        : schema.TranscriptionMode.WRITTEN,
+                    contextTerms: [...(options.contextTerms ?? [])],
+                },
+            }), auth, (error, response) => (error ? reject(error) : resolve(response)));
+            call.on("metadata", (headers) => {
+                id = requestId(headers);
+            });
+            call.on("status", (status) => {
+                id ??= requestId(status.metadata);
+            });
+        }), deadline.signal);
+        if (!result.language?.tag || !result.language.source)
+            throw new RimeStreamError("The service did not confirm a resolved language", id);
+        if (Buffer.byteLength(result.text) > policy.transcriptBytes)
+            throw new RimeResourceLimitError("The transcript exceeds the SDK text limit", id);
+        return { text: result.text, language: result.language.tag, requestId: id };
+    }
+    catch (error) {
+        if (deadline.signal.aborted) {
+            const reason = deadline.signal.reason;
+            if (reason instanceof RimeTimeoutError)
+                throw new RimeTimeoutError(reason.message, id);
+            throw new RimeCancelledError("Transcription cancelled", id);
+        }
+        throw nativeError(error, id);
+    }
+    finally {
+        call?.cancel();
+        deadline.dispose();
+    }
+}
+export class TranscriptionCall extends BidiCall {
+    constructor(client, auth, signal) {
+        requireSchema();
+        const service = schema.SpeechToText;
+        const method = service.method.transcribeStreaming;
+        super(client.makeBidiStreamRequest(`/${service.typeName}/${method.name}`, serializer(method.input), deserializer(method.output), auth), signal);
+    }
+    start(language, mode, contextTerms, outputContract = "revised_hypotheses") {
+        return this.write(create(schema.StreamingTranscriptionRequestSchema, {
+            payload: {
+                case: "config",
+                value: {
+                    language,
+                    mode: mode === "verbatim"
+                        ? schema.TranscriptionMode.VERBATIM
+                        : schema.TranscriptionMode.WRITTEN,
+                    contextTerms: [...contextTerms],
+                    outputContract: outputContract === "append_fragments"
+                        ? schema.StreamingOutputContract.APPEND_FRAGMENTS
+                        : schema.StreamingOutputContract.REVISED_HYPOTHESES,
+                },
+            },
+        }));
+    }
+    writeAudio(audio) {
+        return this.write(create(schema.StreamingTranscriptionRequestSchema, {
+            payload: { case: "audio", value: audio },
+        }));
+    }
+}