@voiceinput/provider 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Hirad Arshadiyarahmadi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# `@voiceinput/provider`
+
+Versioned contracts and test utilities for VoiceInput adapters. Application
+authors normally receive this package through `@voiceinput/react`; adapter
+authors use it directly.
+
+## Install
+
+```bash
+npm install @voiceinput/provider@next
+```
+
+## Provider contract
+
+```ts
+import type { VoiceInputProviderV1 } from "@voiceinput/provider";
+
+const provider: VoiceInputProviderV1 = {
+  specificationVersion: "v1",
+  provider: "acme",
+  modelId: "acme-realtime-1",
+  sampleRate: 16_000,
+
+  validateOptions(options) {
+    // Synchronously reject unsupported shared options before recording.
+  },
+
+  async doOpen(options) {
+    // Return a session that accepts mono PCM16 and emits normalized parts.
+  },
+};
+```
+
+`validateOptions` must be synchronous. `doOpen` receives the same transcription
+options plus an `AbortSignal`. A session owns:
+
+- `stream`: terminal `ReadableStream<VoiceInputProviderV1StreamPart>`
+- `sendAudio(Int16Array)`: mono PCM16 at the declared sample rate
+- `finish()`: graceful and idempotent
+- `abort(reason?)`: immediate and idempotent
+
+Normal stream completion is terminal. Provider failures should be emitted as a
+normalized error part before closure.
+
+## Portable transcription options
+
+| Option                                         | Meaning                                                                             |
+| ---------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `language?: string`                            | BCP 47 language hint; omission asks for provider auto-detection                     |
+| `vocabulary?: readonly string[]`               | Domain terms; adapters document their real provider mapping                         |
+| `endpointing?: false \| { silenceMs: number }` | Provider default when omitted, manual/disabled when `false`, or a silence threshold |
+
+An adapter must reject an unsupported option with `VoiceInputError`; it must not
+silently ignore or approximate it.
+
+## Normalized stream parts
+
+```ts
+type VoiceInputProviderV1StreamPart =
+  | { type: "interim"; text: string }
+  | { type: "final"; text: string }
+  | { type: "speech-start" }
+  | { type: "speech-end" }
+  | { type: "error"; error: VoiceInputError };
+```
+
+## Errors
+
+`VoiceInputError` is safe to recognize across realms with
+`VoiceInputError.isInstance(value)`. It preserves the original `cause` and
+exposes:
+
+- `code`: stable `VoiceInputErrorCode`
+- `provider?: string`
+- `retryable: boolean`
+- `retryAfterMs?: number`
+
+Error codes are `unsupported-browser`, `permission-denied`, `device-not-found`,
+`device-busy`, `unauthorized`, `rate-limited`, `token-error`, `network-error`,
+`provider-error`, `unsupported-feature`, `invalid-configuration`, `audio-error`,
+and `transform-error`.
+
+Branch on `code`, never on the message. `invalid-configuration` means the value
+is malformed; `unsupported-feature` means the value is valid but the selected
+provider or model cannot implement it faithfully. Adapters and core preserve an
+existing `VoiceInputError`, including `provider`, `retryable`, `retryAfterMs`,
+and safe causes, instead of recategorizing it.
+
+## Test export
+
+Import deterministic utilities from the separate test entry point:
+
+```ts
+import {
+  createFakeVoiceInputProvider,
+  createVoiceInputProviderV1ConformanceCases,
+} from "@voiceinput/provider/test";
+```
+
+The fake provider returns `{ provider, controller }`. The controller can wait
+for sessions, resolve or reject opening, emit normalized parts, close, fail, or
+time out a stream, and inspect immutable session snapshots.
+
+The conformance runner is framework-independent:
+
+```ts
+import { createVoiceInputSession } from "@voiceinput/core";
+
+const cases = createVoiceInputProviderV1ConformanceCases({
+  createHarness: createMyDeterministicAdapterHarness,
+  createAccumulatorSession: (provider, audioSource) =>
+    createVoiceInputSession({ provider, audioSource }),
+  errorTaxonomy: {
+    createUnsupportedBrowserProvider: createMissingRuntimeAdapter,
+    invalidOptions: { language: "not a tag" },
+    malformedUnsupportedOptions: malformedUnavailableOptions,
+    unsupportedOptions: { vocabulary: ["valid-but-unavailable"] },
+  },
+});
+
+for (const testCase of cases) {
+  await testCase.run();
+}
+```
+
+The cases require ordered normalized output, multiple final chunks through the
+shared core accumulator, delayed final drain after `finish()`, no
+interim-to-final promotion, terminal timeout mapping, no output after completion
+or abort, idempotent finish/abort cleanup, opening abort, PCM16 delivery, and
+the shared error taxonomy. A harness's `timeout()` method must induce its
+adapter's real timeout or equivalent terminal transport condition; the resulting
+stream error must be a retryable `network-error`.
+
+Your harness supplies the adapter under test and a controller for its fake
+transport. See the
+[custom-provider guide](https://github.com/VoiceInput/voiceinput/blob/main/docs/custom-provider.md).
+
+## Public API
+
+Main entry point:
+
+- `VoiceInputError`
+- `VoiceInputErrorCode`, `VoiceInputErrorOptions`
+- `VoiceEndpointingOptions`, `VoiceTranscriptionOptions`
+- `VoiceInputProviderV1`
+- `VoiceInputProviderV1CallOptions`
+- `VoiceInputProviderV1Session`
+- `VoiceInputProviderV1StreamPart`
+
+`@voiceinput/provider/test`:
+
+- `createFakeVoiceInputProvider`
+- `createVoiceInputProviderV1ConformanceCases`
+- `VoiceInputProviderConformanceError`
+- `FakeVoiceInputProvider`
+- `FakeVoiceInputProviderOptions`
+- `FakeVoiceInputProviderController`
+- `FakeVoiceInputProviderSessionSnapshot`
+- `VoiceInputProviderV1ConformanceHarness`
+- `VoiceInputProviderV1ConformanceCase`
+- `VoiceInputProviderV1ConformanceOptions`
+
+## Security boundary
+
+This package contains no credential handling. Official adapters expose browser
+code from their root and token minting from a separate `/server` export. Custom
+adapters should preserve the same boundary: long-lived credentials must never
+enter browser code, payloads, or logs.
+
+## Segment identity
+
+Include `segmentId: string` on each `interim` and `final` stream part. Keep it
+stable across revisions of one segment and unique within an open session. Emit
+ordered segments; buffer out-of-order provider results in the adapter. Empty
+finals close segments too. Speech-start/end notifications alone do not close a
+transcription segment. Identical text in two segments is legitimate repetition.
+
+Official adapters always provide identities. The optional field preserves older
+strictly sequential custom providers; without it, each final advances an
+implicit segment and duplicate finals cannot be identified reliably. New
+adapters should always implement segment identity and use the published
+conformance cases.
+
+`sendAudio` may return a promise for backpressure. Bound transport queues and
+honor abort while waiting; never silently drop audio. The official adapters use
+the shared `@voiceinput/provider/transport` helper with a 1 MiB high-water mark
+and a five-second congestion deadline.

package/dist/index.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/index.ts
+const voiceInputErrorMarker = Symbol.for("@voiceinput/provider/VoiceInputError");
+var VoiceInputError = class extends Error {
+	code;
+	provider;
+	retryable;
+	retryAfterMs;
+	constructor(options) {
+		super(options.message, { cause: options.cause });
+		this.name = "VoiceInputError";
+		this.code = options.code;
+		this.provider = options.provider;
+		this.retryable = options.retryable ?? false;
+		this.retryAfterMs = options.retryAfterMs;
+		Object.defineProperty(this, voiceInputErrorMarker, {
+			configurable: false,
+			enumerable: false,
+			value: true,
+			writable: false
+		});
+	}
+	static isInstance(value) {
+		return typeof value === "object" && value !== null && voiceInputErrorMarker in value && value[voiceInputErrorMarker] === true;
+	}
+};
+//#endregion
+exports.VoiceInputError = VoiceInputError;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/index.ts"],"sourcesContent":["const voiceInputErrorMarker = Symbol.for(\n  \"@voiceinput/provider/VoiceInputError\",\n);\n\nexport type VoiceInputErrorCode =\n  | \"unsupported-browser\"\n  | \"permission-denied\"\n  | \"device-not-found\"\n  | \"device-busy\"\n  | \"unauthorized\"\n  | \"rate-limited\"\n  | \"token-error\"\n  | \"network-error\"\n  | \"provider-error\"\n  | \"unsupported-feature\"\n  | \"invalid-configuration\"\n  | \"audio-error\"\n  | \"transform-error\";\n\nexport interface VoiceInputErrorOptions {\n  code: VoiceInputErrorCode;\n  message: string;\n  provider?: string;\n  retryable?: boolean;\n  retryAfterMs?: number;\n  cause?: unknown;\n}\n\nexport class VoiceInputError extends Error {\n  readonly code: VoiceInputErrorCode;\n  readonly provider: string | undefined;\n  readonly retryable: boolean;\n  readonly retryAfterMs: number | undefined;\n\n  constructor(options: VoiceInputErrorOptions) {\n    super(options.message, { cause: options.cause });\n    this.name = \"VoiceInputError\";\n    this.code = options.code;\n    this.provider = options.provider;\n    this.retryable = options.retryable ?? false;\n    this.retryAfterMs = options.retryAfterMs;\n\n    Object.defineProperty(this, voiceInputErrorMarker, {\n      configurable: false,\n      enumerable: false,\n      value: true,\n      writable: false,\n    });\n  }\n\n  static isInstance(value: unknown): value is VoiceInputError {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      voiceInputErrorMarker in value &&\n      (value as Record<PropertyKey, unknown>)[voiceInputErrorMarker] === true\n    );\n  }\n}\n\nexport interface VoiceEndpointingOptions {\n  silenceMs: number;\n}\n\nexport interface VoiceTranscriptionOptions {\n  language?: string;\n  vocabulary?: readonly string[];\n  endpointing?: false | VoiceEndpointingOptions;\n}\n\nexport interface VoiceInputProviderV1CallOptions extends VoiceTranscriptionOptions {\n  abortSignal: AbortSignal;\n}\n\nexport type VoiceInputProviderV1StreamPart =\n  | { type: \"interim\"; text: string; segmentId?: string }\n  | { type: \"final\"; text: string; segmentId?: string }\n  | { type: \"speech-start\" }\n  | { type: \"speech-end\" }\n  | { type: \"error\"; error: VoiceInputError };\n\nexport interface VoiceInputProviderV1Session {\n  readonly stream: ReadableStream<VoiceInputProviderV1StreamPart>;\n  sendAudio(chunk: Int16Array): PromiseLike<void> | void;\n  finish(): PromiseLike<void> | void;\n  abort(reason?: unknown): void;\n}\n\nexport interface VoiceInputProviderV1 {\n  readonly specificationVersion: \"v1\";\n  readonly provider: string;\n  readonly modelId: string;\n  readonly sampleRate: number;\n  validateOptions(options: VoiceTranscriptionOptions): void;\n  doOpen(\n    options: VoiceInputProviderV1CallOptions,\n  ): PromiseLike<VoiceInputProviderV1Session>;\n}\n"],"mappings":";;AAAA,MAAM,wBAAwB,OAAO,IACnC,sCACF;AA0BA,IAAa,kBAAb,cAAqC,MAAM;CACzC;CACA;CACA;CACA;CAEA,YAAY,SAAiC;EAC3C,MAAM,QAAQ,SAAS,EAAE,OAAO,QAAQ,MAAM,CAAC;EAC/C,KAAK,OAAO;EACZ,KAAK,OAAO,QAAQ;EACpB,KAAK,WAAW,QAAQ;EACxB,KAAK,YAAY,QAAQ,aAAa;EACtC,KAAK,eAAe,QAAQ;EAE5B,OAAO,eAAe,MAAM,uBAAuB;GACjD,cAAc;GACd,YAAY;GACZ,OAAO;GACP,UAAU;EACZ,CAAC;CACH;CAEA,OAAO,WAAW,OAA0C;EAC1D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,yBAAyB,SACxB,MAAuC,2BAA2B;CAEvE;AACF"}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+//#region src/index.d.ts
+type VoiceInputErrorCode = "unsupported-browser" | "permission-denied" | "device-not-found" | "device-busy" | "unauthorized" | "rate-limited" | "token-error" | "network-error" | "provider-error" | "unsupported-feature" | "invalid-configuration" | "audio-error" | "transform-error";
+interface VoiceInputErrorOptions {
+  code: VoiceInputErrorCode;
+  message: string;
+  provider?: string;
+  retryable?: boolean;
+  retryAfterMs?: number;
+  cause?: unknown;
+}
+declare class VoiceInputError extends Error {
+  readonly code: VoiceInputErrorCode;
+  readonly provider: string | undefined;
+  readonly retryable: boolean;
+  readonly retryAfterMs: number | undefined;
+  constructor(options: VoiceInputErrorOptions);
+  static isInstance(value: unknown): value is VoiceInputError;
+}
+interface VoiceEndpointingOptions {
+  silenceMs: number;
+}
+interface VoiceTranscriptionOptions {
+  language?: string;
+  vocabulary?: readonly string[];
+  endpointing?: false | VoiceEndpointingOptions;
+}
+interface VoiceInputProviderV1CallOptions extends VoiceTranscriptionOptions {
+  abortSignal: AbortSignal;
+}
+type VoiceInputProviderV1StreamPart = {
+  type: "interim";
+  text: string;
+  segmentId?: string;
+} | {
+  type: "final";
+  text: string;
+  segmentId?: string;
+} | {
+  type: "speech-start";
+} | {
+  type: "speech-end";
+} | {
+  type: "error";
+  error: VoiceInputError;
+};
+interface VoiceInputProviderV1Session {
+  readonly stream: ReadableStream<VoiceInputProviderV1StreamPart>;
+  sendAudio(chunk: Int16Array): PromiseLike<void> | void;
+  finish(): PromiseLike<void> | void;
+  abort(reason?: unknown): void;
+}
+interface VoiceInputProviderV1 {
+  readonly specificationVersion: "v1";
+  readonly provider: string;
+  readonly modelId: string;
+  readonly sampleRate: number;
+  validateOptions(options: VoiceTranscriptionOptions): void;
+  doOpen(options: VoiceInputProviderV1CallOptions): PromiseLike<VoiceInputProviderV1Session>;
+}
+//#endregion
+export { VoiceEndpointingOptions, VoiceInputError, VoiceInputErrorCode, VoiceInputErrorOptions, VoiceInputProviderV1, VoiceInputProviderV1CallOptions, VoiceInputProviderV1Session, VoiceInputProviderV1StreamPart, VoiceTranscriptionOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";KAIY;UAeK;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;;cAGW,wBAAwB;WAC1B,MAAM;WACN;WACA;WACA;EAET,YAAY,SAAS;SAgBd,WAAW,iBAAiB,SAAS;;UAU7B;EACf;;UAGe;EACf;EACA;EACA,sBAAsB;;UAGP,wCAAwC;EACvD,aAAa;;KAGH;EACN;EAAiB;EAAc;;EAC/B;EAAe;EAAc;;EAC7B;;EACA;;EACA;EAAe,OAAO;;UAEX;WACN,QAAQ,eAAe;EAChC,UAAU,OAAO,aAAa;EAC9B,UAAU;EACV,MAAM;;UAGS;WACN;WACA;WACA;WACA;EACT,gBAAgB,SAAS;EACzB,OACE,SAAS,kCACR,YAAY"}

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+//#region src/index.d.ts
+type VoiceInputErrorCode = "unsupported-browser" | "permission-denied" | "device-not-found" | "device-busy" | "unauthorized" | "rate-limited" | "token-error" | "network-error" | "provider-error" | "unsupported-feature" | "invalid-configuration" | "audio-error" | "transform-error";
+interface VoiceInputErrorOptions {
+  code: VoiceInputErrorCode;
+  message: string;
+  provider?: string;
+  retryable?: boolean;
+  retryAfterMs?: number;
+  cause?: unknown;
+}
+declare class VoiceInputError extends Error {
+  readonly code: VoiceInputErrorCode;
+  readonly provider: string | undefined;
+  readonly retryable: boolean;
+  readonly retryAfterMs: number | undefined;
+  constructor(options: VoiceInputErrorOptions);
+  static isInstance(value: unknown): value is VoiceInputError;
+}
+interface VoiceEndpointingOptions {
+  silenceMs: number;
+}
+interface VoiceTranscriptionOptions {
+  language?: string;
+  vocabulary?: readonly string[];
+  endpointing?: false | VoiceEndpointingOptions;
+}
+interface VoiceInputProviderV1CallOptions extends VoiceTranscriptionOptions {
+  abortSignal: AbortSignal;
+}
+type VoiceInputProviderV1StreamPart = {
+  type: "interim";
+  text: string;
+  segmentId?: string;
+} | {
+  type: "final";
+  text: string;
+  segmentId?: string;
+} | {
+  type: "speech-start";
+} | {
+  type: "speech-end";
+} | {
+  type: "error";
+  error: VoiceInputError;
+};
+interface VoiceInputProviderV1Session {
+  readonly stream: ReadableStream<VoiceInputProviderV1StreamPart>;
+  sendAudio(chunk: Int16Array): PromiseLike<void> | void;
+  finish(): PromiseLike<void> | void;
+  abort(reason?: unknown): void;
+}
+interface VoiceInputProviderV1 {
+  readonly specificationVersion: "v1";
+  readonly provider: string;
+  readonly modelId: string;
+  readonly sampleRate: number;
+  validateOptions(options: VoiceTranscriptionOptions): void;
+  doOpen(options: VoiceInputProviderV1CallOptions): PromiseLike<VoiceInputProviderV1Session>;
+}
+//#endregion
+export { VoiceEndpointingOptions, VoiceInputError, VoiceInputErrorCode, VoiceInputErrorOptions, VoiceInputProviderV1, VoiceInputProviderV1CallOptions, VoiceInputProviderV1Session, VoiceInputProviderV1StreamPart, VoiceTranscriptionOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAIY;UAeK;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;;cAGW,wBAAwB;WAC1B,MAAM;WACN;WACA;WACA;EAET,YAAY,SAAS;SAgBd,WAAW,iBAAiB,SAAS;;UAU7B;EACf;;UAGe;EACf;EACA;EACA,sBAAsB;;UAGP,wCAAwC;EACvD,aAAa;;KAGH;EACN;EAAiB;EAAc;;EAC/B;EAAe;EAAc;;EAC7B;;EACA;;EACA;EAAe,OAAO;;UAEX;WACN,QAAQ,eAAe;EAChC,UAAU,OAAO,aAAa;EAC9B,UAAU;EACV,MAAM;;UAGS;WACN;WACA;WACA;WACA;EACT,gBAAgB,SAAS;EACzB,OACE,SAAS,kCACR,YAAY"}

package/dist/index.js

@@ -0,0 +1,29 @@
+//#region src/index.ts
+const voiceInputErrorMarker = Symbol.for("@voiceinput/provider/VoiceInputError");
+var VoiceInputError = class extends Error {
+	code;
+	provider;
+	retryable;
+	retryAfterMs;
+	constructor(options) {
+		super(options.message, { cause: options.cause });
+		this.name = "VoiceInputError";
+		this.code = options.code;
+		this.provider = options.provider;
+		this.retryable = options.retryable ?? false;
+		this.retryAfterMs = options.retryAfterMs;
+		Object.defineProperty(this, voiceInputErrorMarker, {
+			configurable: false,
+			enumerable: false,
+			value: true,
+			writable: false
+		});
+	}
+	static isInstance(value) {
+		return typeof value === "object" && value !== null && voiceInputErrorMarker in value && value[voiceInputErrorMarker] === true;
+	}
+};
+//#endregion
+export { VoiceInputError };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["const voiceInputErrorMarker = Symbol.for(\n  \"@voiceinput/provider/VoiceInputError\",\n);\n\nexport type VoiceInputErrorCode =\n  | \"unsupported-browser\"\n  | \"permission-denied\"\n  | \"device-not-found\"\n  | \"device-busy\"\n  | \"unauthorized\"\n  | \"rate-limited\"\n  | \"token-error\"\n  | \"network-error\"\n  | \"provider-error\"\n  | \"unsupported-feature\"\n  | \"invalid-configuration\"\n  | \"audio-error\"\n  | \"transform-error\";\n\nexport interface VoiceInputErrorOptions {\n  code: VoiceInputErrorCode;\n  message: string;\n  provider?: string;\n  retryable?: boolean;\n  retryAfterMs?: number;\n  cause?: unknown;\n}\n\nexport class VoiceInputError extends Error {\n  readonly code: VoiceInputErrorCode;\n  readonly provider: string | undefined;\n  readonly retryable: boolean;\n  readonly retryAfterMs: number | undefined;\n\n  constructor(options: VoiceInputErrorOptions) {\n    super(options.message, { cause: options.cause });\n    this.name = \"VoiceInputError\";\n    this.code = options.code;\n    this.provider = options.provider;\n    this.retryable = options.retryable ?? false;\n    this.retryAfterMs = options.retryAfterMs;\n\n    Object.defineProperty(this, voiceInputErrorMarker, {\n      configurable: false,\n      enumerable: false,\n      value: true,\n      writable: false,\n    });\n  }\n\n  static isInstance(value: unknown): value is VoiceInputError {\n    return (\n      typeof value === \"object\" &&\n      value !== null &&\n      voiceInputErrorMarker in value &&\n      (value as Record<PropertyKey, unknown>)[voiceInputErrorMarker] === true\n    );\n  }\n}\n\nexport interface VoiceEndpointingOptions {\n  silenceMs: number;\n}\n\nexport interface VoiceTranscriptionOptions {\n  language?: string;\n  vocabulary?: readonly string[];\n  endpointing?: false | VoiceEndpointingOptions;\n}\n\nexport interface VoiceInputProviderV1CallOptions extends VoiceTranscriptionOptions {\n  abortSignal: AbortSignal;\n}\n\nexport type VoiceInputProviderV1StreamPart =\n  | { type: \"interim\"; text: string; segmentId?: string }\n  | { type: \"final\"; text: string; segmentId?: string }\n  | { type: \"speech-start\" }\n  | { type: \"speech-end\" }\n  | { type: \"error\"; error: VoiceInputError };\n\nexport interface VoiceInputProviderV1Session {\n  readonly stream: ReadableStream<VoiceInputProviderV1StreamPart>;\n  sendAudio(chunk: Int16Array): PromiseLike<void> | void;\n  finish(): PromiseLike<void> | void;\n  abort(reason?: unknown): void;\n}\n\nexport interface VoiceInputProviderV1 {\n  readonly specificationVersion: \"v1\";\n  readonly provider: string;\n  readonly modelId: string;\n  readonly sampleRate: number;\n  validateOptions(options: VoiceTranscriptionOptions): void;\n  doOpen(\n    options: VoiceInputProviderV1CallOptions,\n  ): PromiseLike<VoiceInputProviderV1Session>;\n}\n"],"mappings":";AAAA,MAAM,wBAAwB,OAAO,IACnC,sCACF;AA0BA,IAAa,kBAAb,cAAqC,MAAM;CACzC;CACA;CACA;CACA;CAEA,YAAY,SAAiC;EAC3C,MAAM,QAAQ,SAAS,EAAE,OAAO,QAAQ,MAAM,CAAC;EAC/C,KAAK,OAAO;EACZ,KAAK,OAAO,QAAQ;EACpB,KAAK,WAAW,QAAQ;EACxB,KAAK,YAAY,QAAQ,aAAa;EACtC,KAAK,eAAe,QAAQ;EAE5B,OAAO,eAAe,MAAM,uBAAuB;GACjD,cAAc;GACd,YAAY;GACZ,OAAO;GACP,UAAU;EACZ,CAAC;CACH;CAEA,OAAO,WAAW,OAA0C;EAC1D,OACE,OAAO,UAAU,YACjB,UAAU,QACV,yBAAyB,SACxB,MAAuC,2BAA2B;CAEvE;AACF"}