@effect-uai/mistral 0.17.0 → 0.19.0-dev-20261109183959

package/dist/onHalt.test.mjs

@@ -1,7 +1,7 @@
 import { make } from "./Mistral.mjs";
-import { n as describe, r as it, t as globalExpect } from "./test.DNmyFkvJ-N3QqMRwZ.mjs";
+import { n as globalExpect, o as describe, s as it } from "./index.C4tKZ0yW-CUBm3Bmz.mjs";
 import { Effect, Exit, Redacted, Stream } from "effect";
-import { HttpClient, HttpClientResponse } from "effect/unstable/http";
+import { HttpClient, HttpClientResponse } from "effect/http";
 //#region src/onHalt.test.ts
 const clientWithBody = (makeBody) => HttpClient.make((request) => Effect.succeed(HttpClientResponse.fromWeb(request, new Response(makeBody(), {
 	status: 200,

package/dist/onHalt.test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"onHalt.test.mjs","names":["makeMistral"],"sources":["../src/onHalt.test.ts"],"sourcesContent":["import { Effect, Exit, Redacted, Stream } from \"effect\"\nimport { HttpClient, HttpClientResponse } from \"effect/unstable/http\"\nimport { describe, expect, it } from \"vitest\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\nimport { make as makeMistral } from \"./Mistral.js\"\n\n// An HttpClient backed by a scripted SSE body\nconst clientWithBody = (makeBody: () => ReadableStream<Uint8Array>): HttpClient.HttpClient =>\n  HttpClient.make((request) =>\n    Effect.succeed(\n      HttpClientResponse.fromWeb(\n        request,\n        new Response(makeBody(), {\n          status: 200,\n          headers: { \"content-type\": \"text/event-stream\" },\n        }),\n      ),\n    ),\n  )\n\nconst enc = new TextEncoder()\nconst sse = (obj: unknown) => enc.encode(`data: ${JSON.stringify(obj)}\\n\\n`)\n\nconst runStream = (client: HttpClient.HttpClient) =>\n  Effect.gen(function* () {\n    const svc = yield* makeMistral({ apiKey: Redacted.make(\"k\") })\n    const events: Array<TurnEvent> = []\n    const exit = yield* svc.streamTurn({ model: \"mistral-small-latest\", history: [] }).pipe(\n      Stream.runForEach((e) => Effect.sync(() => events.push(e))),\n      Effect.exit,\n    )\n    return { tags: events.map((e) => e._tag), events, exit }\n  }).pipe(Effect.provideService(HttpClient.HttpClient, client))\n\ndescribe(\"Mistral streamTurn: truncated turn presented as complete\", () => {\n  it(\"truncated EOF (no finish_reason) must not synthesize a complete turn\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.close() // no finish_reason, no [DONE]\n        },\n      })\n    const { tags } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(tags).toContain(\"TextDelta\")\n    expect(tags).not.toContain(\"TurnComplete\")\n  })\n\n  it(\"mid-stream error must surface as a failure, not a fake TurnComplete\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.error(new Error(\"connection reset\"))\n        },\n      })\n    const { tags, exit } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(Exit.isFailure(exit)).toBe(true)\n    expect(tags).not.toContain(\"TurnComplete\")\n  })\n\n  it(\"a well-formed stream (finish_reason present) still completes\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.enqueue(sse({ choices: [{ delta: {}, finish_reason: \"stop\" }] }))\n          controller.enqueue(enc.encode(\"data: [DONE]\\n\\n\"))\n          controller.close()\n        },\n      })\n    const { tags } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(tags).toContain(\"TurnComplete\")\n  })\n})\n"],"mappings":";;;;;AAOA,MAAM,kBAAkB,aACtB,WAAW,MAAM,YACf,OAAO,QACL,mBAAmB,QACjB,SACA,IAAI,SAAS,SAAS,GAAG;CACvB,QAAQ;CACR,SAAS,EAAE,gBAAgB,oBAAoB;AACjD,CAAC,CACH,CACF,CACF;AAEF,MAAM,MAAM,IAAI,YAAY;AAC5B,MAAM,OAAO,QAAiB,IAAI,OAAO,SAAS,KAAK,UAAU,GAAG,EAAE,KAAK;AAE3E,MAAM,aAAa,WACjB,OAAO,IAAI,aAAa;CACtB,MAAM,MAAM,OAAOA,KAAY,EAAE,QAAQ,SAAS,KAAK,GAAG,EAAE,CAAC;CAC7D,MAAM,SAA2B,CAAC;CAClC,MAAM,OAAO,OAAO,IAAI,WAAW;EAAE,OAAO;EAAwB,SAAS,CAAC;CAAE,CAAC,CAAC,CAAC,KACjF,OAAO,YAAY,MAAM,OAAO,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC,GAC1D,OAAO,IACT;CACA,OAAO;EAAE,MAAM,OAAO,KAAK,MAAM,EAAE,IAAI;EAAG;EAAQ;CAAK;AACzD,CAAC,CAAC,CAAC,KAAK,OAAO,eAAe,WAAW,YAAY,MAAM,CAAC;AAE9D,SAAS,kEAAkE;CACzE,GAAG,wEAAwE,YAAY;EACrF,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,MAAM;EACnB,EACF,CAAC;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EACxE,aAAO,IAAI,CAAC,CAAC,UAAU,WAAW;EAClC,aAAO,IAAI,CAAC,CAAC,IAAI,UAAU,cAAc;CAC3C,CAAC;CAED,GAAG,uEAAuE,YAAY;EACpF,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,sBAAM,IAAI,MAAM,kBAAkB,CAAC;EAChD,EACF,CAAC;EACH,MAAM,EAAE,MAAM,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EAC9E,aAAO,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;EACtC,aAAO,IAAI,CAAC,CAAC,IAAI,UAAU,cAAc;CAC3C,CAAC;CAED,GAAG,gEAAgE,YAAY;EAC7E,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC;IAAE,OAAO,CAAC;IAAG,eAAe;GAAO,CAAC,EAAE,CAAC,CAAC;GAC3E,WAAW,QAAQ,IAAI,OAAO,kBAAkB,CAAC;GACjD,WAAW,MAAM;EACnB,EACF,CAAC;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EACxE,aAAO,IAAI,CAAC,CAAC,UAAU,cAAc;CACvC,CAAC;AACH,CAAC"}
+{"version":3,"file":"onHalt.test.mjs","names":["makeMistral"],"sources":["../src/onHalt.test.ts"],"sourcesContent":["import { Effect, Exit, Redacted, Stream } from \"effect\"\nimport { HttpClient, HttpClientResponse } from \"effect/http\"\nimport { describe, expect, it } from \"vitest\"\nimport { TurnEvent } from \"@effect-uai/core/Turn\"\nimport { make as makeMistral } from \"./Mistral.js\"\n\n// An HttpClient backed by a scripted SSE body\nconst clientWithBody = (makeBody: () => ReadableStream<Uint8Array>): HttpClient.HttpClient =>\n  HttpClient.make((request) =>\n    Effect.succeed(\n      HttpClientResponse.fromWeb(\n        request,\n        new Response(makeBody(), {\n          status: 200,\n          headers: { \"content-type\": \"text/event-stream\" },\n        }),\n      ),\n    ),\n  )\n\nconst enc = new TextEncoder()\nconst sse = (obj: unknown) => enc.encode(`data: ${JSON.stringify(obj)}\\n\\n`)\n\nconst runStream = (client: HttpClient.HttpClient) =>\n  Effect.gen(function* () {\n    const svc = yield* makeMistral({ apiKey: Redacted.make(\"k\") })\n    const events: Array<TurnEvent> = []\n    const exit = yield* svc.streamTurn({ model: \"mistral-small-latest\", history: [] }).pipe(\n      Stream.runForEach((e) => Effect.sync(() => events.push(e))),\n      Effect.exit,\n    )\n    return { tags: events.map((e) => e._tag), events, exit }\n  }).pipe(Effect.provideService(HttpClient.HttpClient, client))\n\ndescribe(\"Mistral streamTurn: truncated turn presented as complete\", () => {\n  it(\"truncated EOF (no finish_reason) must not synthesize a complete turn\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.close() // no finish_reason, no [DONE]\n        },\n      })\n    const { tags } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(tags).toContain(\"TextDelta\")\n    expect(tags).not.toContain(\"TurnComplete\")\n  })\n\n  it(\"mid-stream error must surface as a failure, not a fake TurnComplete\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.error(new Error(\"connection reset\"))\n        },\n      })\n    const { tags, exit } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(Exit.isFailure(exit)).toBe(true)\n    expect(tags).not.toContain(\"TurnComplete\")\n  })\n\n  it(\"a well-formed stream (finish_reason present) still completes\", async () => {\n    const body = () =>\n      new ReadableStream<Uint8Array>({\n        start(controller) {\n          controller.enqueue(sse({ choices: [{ delta: { content: \"Hel\" } }] }))\n          controller.enqueue(sse({ choices: [{ delta: {}, finish_reason: \"stop\" }] }))\n          controller.enqueue(enc.encode(\"data: [DONE]\\n\\n\"))\n          controller.close()\n        },\n      })\n    const { tags } = await Effect.runPromise(runStream(clientWithBody(body)))\n    expect(tags).toContain(\"TurnComplete\")\n  })\n})\n"],"mappings":";;;;;AAOA,MAAM,kBAAkB,aACtB,WAAW,MAAM,YACf,OAAO,QACL,mBAAmB,QACjB,SACA,IAAI,SAAS,SAAS,GAAG;CACvB,QAAQ;CACR,SAAS,EAAE,gBAAgB,oBAAoB;AACjD,CAAC,CACH,CACF,CACF;AAEF,MAAM,MAAM,IAAI,YAAY;AAC5B,MAAM,OAAO,QAAiB,IAAI,OAAO,SAAS,KAAK,UAAU,GAAG,EAAE,KAAK;AAE3E,MAAM,aAAa,WACjB,OAAO,IAAI,aAAa;CACtB,MAAM,MAAM,OAAOA,KAAY,EAAE,QAAQ,SAAS,KAAK,GAAG,EAAE,CAAC;CAC7D,MAAM,SAA2B,CAAC;CAClC,MAAM,OAAO,OAAO,IAAI,WAAW;EAAE,OAAO;EAAwB,SAAS,CAAC;CAAE,CAAC,CAAC,CAAC,KACjF,OAAO,YAAY,MAAM,OAAO,WAAW,OAAO,KAAK,CAAC,CAAC,CAAC,GAC1D,OAAO,IACT;CACA,OAAO;EAAE,MAAM,OAAO,KAAK,MAAM,EAAE,IAAI;EAAG;EAAQ;CAAK;AACzD,CAAC,CAAC,CAAC,KAAK,OAAO,eAAe,WAAW,YAAY,MAAM,CAAC;AAE9D,SAAS,kEAAkE;CACzE,GAAG,wEAAwE,YAAY;EACrF,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,MAAM;EACnB,EACF,CAAC;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EACxE,aAAO,IAAI,CAAC,CAAC,UAAU,WAAW;EAClC,aAAO,IAAI,CAAC,CAAC,IAAI,UAAU,cAAc;CAC3C,CAAC;CAED,GAAG,uEAAuE,YAAY;EACpF,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,sBAAM,IAAI,MAAM,kBAAkB,CAAC;EAChD,EACF,CAAC;EACH,MAAM,EAAE,MAAM,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EAC9E,aAAO,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI;EACtC,aAAO,IAAI,CAAC,CAAC,IAAI,UAAU,cAAc;CAC3C,CAAC;CAED,GAAG,gEAAgE,YAAY;EAC7E,MAAM,aACJ,IAAI,eAA2B,EAC7B,MAAM,YAAY;GAChB,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;GACpE,WAAW,QAAQ,IAAI,EAAE,SAAS,CAAC;IAAE,OAAO,CAAC;IAAG,eAAe;GAAO,CAAC,EAAE,CAAC,CAAC;GAC3E,WAAW,QAAQ,IAAI,OAAO,kBAAkB,CAAC;GACjD,WAAW,MAAM;EACnB,EACF,CAAC;EACH,MAAM,EAAE,SAAS,MAAM,OAAO,WAAW,UAAU,eAAe,IAAI,CAAC,CAAC;EACxE,aAAO,IAAI,CAAC,CAAC,UAAU,cAAc;CACvC,CAAC;AACH,CAAC"}

package/dist/{realtimeStt-BcthMc57.d.mts → realtimeStt-CcuQ6EZS.d.mts}

@@ -1,6 +1,7 @@
 import { Duration, Redacted, Stream } from "effect";
 import * as AiError from "@effect-uai/core/AiError";
 import { CommonStreamTranscribeRequest } from "@effect-uai/core/Transcriber";
+import * as Socket from "effect/socket/Socket";
 import { TranscriptEvent } from "@effect-uai/core/Transcript";
 //#region src/realtimeStt.d.ts
 type Config = {
@@ -14,8 +15,13 @@ type Config = {
    * adapter delimits turns. Default 700 ms.
    */
   readonly utteranceSilence?: Duration.Duration;
+  /**
+   * Build the socket yourself, for a proxy or an in-memory transport. The
+   * default attaches the bearer token through the `ws` package.
+   */
+  readonly webSocket?: Socket.WebSocketConstructor["Service"];
 };
 declare const streamTranscription: (cfg: Config) => <E, R>(audioIn: Stream.Stream<Uint8Array, E, R>, request: CommonStreamTranscribeRequest) => Stream.Stream<TranscriptEvent, AiError.AiError | E, R>;
 //#endregion
 export { streamTranscription as n, Config as t };
-//# sourceMappingURL=realtimeStt-BcthMc57.d.mts.map
+//# sourceMappingURL=realtimeStt-CcuQ6EZS.d.mts.map

package/dist/realtimeStt-CcuQ6EZS.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"realtimeStt-CcuQ6EZS.d.mts","names":[],"sources":["../src/realtimeStt.ts"],"mappings":";;;;;;KA+CY;WACD,QAAQ,SAAS;WACjB;;WAEA,uBAAuB,SAAS;;;;;;WAMhC,mBAAmB,SAAS;;;;;WAK5B,YAAY,OAAO;;cAsJjB,sBAAmB,KACxB,YACL,GAAG,GAAC,SACM,OAAO,OAAO,YAAY,GAAG,IAAE,SAC/B,kCACR,OAAO,OAAO,iBAAiB,QAAQ,UAAU,GAAG"}

package/dist/realtimeStt.d.mts

@@ -1,2 +1,2 @@
-import { n as streamTranscription, t as Config } from "./realtimeStt-BcthMc57.mjs";
+import { n as streamTranscription, t as Config } from "./realtimeStt-CcuQ6EZS.mjs";
 export { Config, streamTranscription };

package/dist/realtimeStt.mjs

@@ -1,7 +1,9 @@
-import { Clock, Duration, Effect, Encoding, Match, Queue, Redacted, Ref, Schema, Stream } from "effect";
+import { Clock, Duration, Effect, Match, Option, Predicate, Redacted, Ref, Schema, Stream } from "effect";
 import * as AiError from "@effect-uai/core/AiError";
-import * as Socket from "effect/unstable/socket/Socket";
+import { Base64 } from "effect/encoding";
+import * as Socket from "effect/socket/Socket";
 import * as JSONL from "@effect-uai/core/JSONL";
+import * as WebSocketSession from "@effect-uai/core/WebSocketSession";
 import { WebSocket } from "ws";
 //#region src/realtimeStt.ts
 /**
@@ -50,7 +52,7 @@ const sessionUpdateFrame = (cfg) => JSON.stringify({
 });
 const audioAppendFrame = (bytes) => JSON.stringify({
 	type: "input_audio.append",
-	audio: Encoding.encodeBase64(bytes)
+	audio: Base64.encode(bytes)
 });
 const audioEndFrame = JSON.stringify({ type: "input_audio.end" });
 const ServerEvent = Schema.Union([
@@ -75,60 +77,55 @@ const ServerEvent = Schema.Union([
 	})
 ]);
 const decodeServerEvent = Schema.decodeUnknownEffect(ServerEvent);
-const emitFinal = (queue, state, override) => Effect.gen(function* () {
+const takeFinal = (state, override) => Effect.gen(function* () {
 	const acc = yield* Ref.getAndSet(state.text, "");
 	const text = (override !== void 0 && override.length > 0 ? override : acc).trim();
-	if (text.length > 0) yield* Queue.offer(queue, {
+	return text.length > 0 ? {
 		_tag: "final",
 		text
-	});
+	} : void 0;
 });
-const handleServerMessage = (queue, state) => (raw) => Effect.gen(function* () {
+const frameToEvent = (state) => (raw) => Effect.gen(function* () {
 	const json = yield* JSONL.parseSafe(raw);
-	if (json === void 0) return;
+	if (json === void 0) return void 0;
 	const decoded = yield* decodeServerEvent(json).pipe(Effect.option);
-	if (decoded._tag === "None") return;
-	yield* Match.value(decoded.value).pipe(Match.when({ type: "transcription.text.delta" }, (m) => Effect.gen(function* () {
+	if (Option.isNone(decoded)) return void 0;
+	return yield* Match.value(decoded.value).pipe(Match.when({ type: "transcription.text.delta" }, (m) => Effect.gen(function* () {
 		const now = yield* Clock.currentTimeMillis;
 		const next = yield* Ref.updateAndGet(state.text, (t) => t + m.text);
 		yield* Ref.set(state.lastActivityMs, now);
-		yield* Queue.offer(queue, {
+		return {
 			_tag: "partial",
 			text: next
-		});
-	})), Match.when({ type: "transcription.done" }, (m) => emitFinal(queue, state, m.text)), Match.when({ type: "error" }, (m) => Queue.offer(queue, {
+		};
+	})), Match.when({ type: "transcription.done" }, (m) => takeFinal(state, m.text)), Match.when({ type: "error" }, (m) => Effect.succeed({
 		_tag: "error",
 		...m.error.code != null && { code: String(m.error.code) },
 		message: m.error.message
-	})), Match.orElse(() => Effect.void));
+	})), Match.orElse(() => Effect.succeed(void 0)));
 });
-const silenceFinalizer = (queue, state, silence) => {
+const silenceFinals = (state, silence) => {
 	const silenceMs = Duration.toMillis(silence);
-	return Effect.gen(function* () {
+	return Stream.tick("150 millis").pipe(Stream.mapEffect(() => Effect.gen(function* () {
 		const now = yield* Clock.currentTimeMillis;
 		const last = yield* Ref.get(state.lastActivityMs);
-		if ((yield* Ref.get(state.text)).trim().length > 0 && now - last >= silenceMs) yield* emitFinal(queue, state);
-		yield* Effect.sleep("150 millis");
-	}).pipe(Effect.forever);
+		return (yield* Ref.get(state.text)).trim().length > 0 && now - last >= silenceMs ? yield* takeFinal(state) : void 0;
+	})), Stream.filter(Predicate.isNotUndefined));
 };
 const authedWsConstructor = (cfg) => (url) => new WebSocket(url, void 0, { headers: { Authorization: `Bearer ${Redacted.value(cfg.apiKey)}` } });
 const streamTranscription = (cfg) => (audioIn, request) => Stream.unwrap(Effect.gen(function* () {
 	yield* ensureInputFormat(request.inputFormat);
-	const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request.model), { closeCodeIsError: (code) => code !== 1e3 && code !== 1001 && code !== 1005 }).pipe(Effect.provideService(Socket.WebSocketConstructor, authedWsConstructor(cfg)));
-	const queue = yield* Queue.bounded(64);
+	const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request.model)).pipe(Effect.provideService(Socket.WebSocketConstructor, cfg.webSocket ?? authedWsConstructor(cfg)));
 	const state = {
 		text: yield* Ref.make(""),
 		lastActivityMs: yield* Ref.make(0)
 	};
-	const write = yield* socket.writer;
-	yield* Effect.gen(function* () {
-		yield* write(sessionUpdateFrame(cfg));
-		yield* Stream.runForEach(audioIn, (bytes) => write(audioAppendFrame(bytes)));
-		yield* write(audioEndFrame);
-	}).pipe(Effect.tapError((cause) => Effect.logWarning("[voxtral-realtime] audio send failed", { cause })), Effect.ignore, Effect.forkScoped);
-	yield* silenceFinalizer(queue, state, cfg.utteranceSilence ?? DEFAULT_SILENCE).pipe(Effect.forkScoped);
-	yield* socket.runString(handleServerMessage(queue, state)).pipe(Effect.tapError((cause) => Effect.logWarning("[voxtral-realtime] socket closed", { cause })), Effect.ensuring(Queue.end(queue)), Effect.forkScoped);
-	return Stream.fromQueue(queue);
+	const { write } = yield* socket.writer;
+	const asAiError = WebSocketSession.toAiError("mistral");
+	const frames = Stream.fromPull(Socket.readerString(socket)).pipe(Stream.scoped, Stream.catchIf(WebSocketSession.isCleanClose, () => Stream.empty), Stream.mapError(asAiError), Stream.mapEffect(frameToEvent(state)), Stream.filter(Predicate.isNotUndefined));
+	const events = Stream.merge(frames, silenceFinals(state, cfg.utteranceSilence ?? DEFAULT_SILENCE), { haltStrategy: "left" });
+	const outgoing = Stream.concat(Stream.concat(Stream.make(sessionUpdateFrame(cfg)), Stream.map(audioIn, audioAppendFrame)), Stream.make(audioEndFrame)).pipe(Stream.mapEffect((frame) => Effect.mapError(write(frame), asAiError)));
+	return Stream.merge(events, Stream.drain(outgoing), { haltStrategy: "left" });
 }));
 //#endregion
 export { streamTranscription };

package/dist/realtimeStt.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"realtimeStt.mjs","names":["WSWebSocket"],"sources":["../src/realtimeStt.ts"],"sourcesContent":["/**\n * Voxtral Realtime STT over WebSocket.\n *\n * Protocol mirrors the `mistralai[realtime]` Python client:\n *   - URL: `wss://api.mistral.ai/v1/audio/transcriptions/realtime?model=…`\n *     (the model is a query param, not a session field).\n *   - Auth: `Authorization: Bearer …` header on the upgrade. The browser\n *     `WebSocket` API can't set headers, so this module uses the `ws` peer\n *     dep; `ws` is only pulled in transitively via\n *     `MistralRealtimeTranscriber` (the sync `MistralTranscriber` stays free\n *     of it).\n *   - Client → server (JSON): `session.update` (audio_format +\n *     target_streaming_delay_ms), then `input_audio.append` with base64 PCM,\n *     and `input_audio.end` when the mic stream stops.\n *   - Server → client (JSON): `session.created` / `session.updated`,\n *     `transcription.text.delta` (`{ text }`), `transcription.done`\n *     (`{ text }`), `transcription.segment`, `transcription.language`,\n *     and `error` (`{ error: { message, code } }`).\n *\n * Voxtral Realtime is a *continuous* transcriber: it streams text deltas and\n * only emits one `transcription.done` at end-of-audio (no server-side\n * utterance segmentation). To satisfy the `Transcriber` contract's `final`\n * semantics for conversational use, this adapter synthesizes a `final` event\n * when the deltas go quiet for `utteranceSilence`.\n */\nimport {\n  Cause,\n  Clock,\n  Duration,\n  Effect,\n  Encoding,\n  Match,\n  Queue,\n  Redacted,\n  Ref,\n  Schema,\n  Stream,\n} from \"effect\"\nimport * as Socket from \"effect/unstable/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport type { TranscriptEvent } from \"@effect-uai/core/Transcript\"\nimport type { CommonStreamTranscribeRequest } from \"@effect-uai/core/Transcriber\"\nimport { WebSocket as WSWebSocket } from \"ws\"\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  /** Target latency knob (`target_streaming_delay_ms`); lower = faster, less accurate. */\n  readonly targetStreamingDelay?: Duration.Duration\n  /**\n   * Silence gap after which the accumulated deltas are committed as a synthetic\n   * `final`. Voxtral Realtime does no utterance segmentation, so this is how the\n   * adapter delimits turns. Default 700 ms.\n   */\n  readonly utteranceSilence?: Duration.Duration\n}\n\nconst DEFAULT_SILENCE = Duration.millis(700)\n\n// ---------------------------------------------------------------------------\n// AudioFormat gate — Voxtral Realtime ingests pcm_s16le @ 16000 mono only.\n// ---------------------------------------------------------------------------\n\nconst ensureInputFormat = (format: AudioFormat): Effect.Effect<void, AiError.AiError> =>\n  format.container === \"raw\" && format.encoding === \"pcm_s16le\" && format.sampleRate === 16000\n    ? Effect.void\n    : Effect.fail(\n        new AiError.Unsupported({\n          provider: \"mistral\",\n          capability: \"inputFormat\",\n          reason: `Voxtral Realtime accepts pcm_s16le @ 16000 mono only. Got ${JSON.stringify(format)}.`,\n        }),\n      )\n\n// ---------------------------------------------------------------------------\n// URL + client frame builders\n// ---------------------------------------------------------------------------\n\nconst buildWsUrl = (cfg: Config, model: string) => {\n  const base = (cfg.baseUrl ?? \"https://api.mistral.ai\").replace(/^http/, \"ws\")\n  return `${base}/v1/audio/transcriptions/realtime?model=${encodeURIComponent(model)}`\n}\n\nconst sessionUpdateFrame = (cfg: Config) =>\n  JSON.stringify({\n    type: \"session.update\",\n    session: {\n      audio_format: { encoding: \"pcm_s16le\", sample_rate: 16000 },\n      ...(cfg.targetStreamingDelay !== undefined && {\n        target_streaming_delay_ms: Duration.toMillis(cfg.targetStreamingDelay),\n      }),\n    },\n  })\n\nconst audioAppendFrame = (bytes: Uint8Array) =>\n  JSON.stringify({ type: \"input_audio.append\", audio: Encoding.encodeBase64(bytes) })\n\nconst audioEndFrame = JSON.stringify({ type: \"input_audio.end\" })\n\n// ---------------------------------------------------------------------------\n// Wire schemas (server → client)\n// ---------------------------------------------------------------------------\n\nconst ServerEvent = Schema.Union([\n  Schema.Struct({ type: Schema.Literal(\"session.created\") }),\n  Schema.Struct({ type: Schema.Literal(\"session.updated\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.language\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.segment\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.text.delta\"), text: Schema.String }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.done\"), text: Schema.String }),\n  Schema.Struct({\n    type: Schema.Literal(\"error\"),\n    error: Schema.Struct({\n      message: Schema.String,\n      code: Schema.optional(Schema.NullOr(Schema.Number)),\n    }),\n  }),\n])\nconst decodeServerEvent = Schema.decodeUnknownEffect(ServerEvent)\n\n/** Mutable turn state shared by the message handler and the silence finalizer. */\ntype TurnState = {\n  readonly text: Ref.Ref<string>\n  readonly lastActivityMs: Ref.Ref<number>\n}\n\nconst emitFinal = (\n  queue: Queue.Queue<TranscriptEvent, Cause.Done>,\n  state: TurnState,\n  override?: string,\n): Effect.Effect<void> =>\n  Effect.gen(function* () {\n    const acc = yield* Ref.getAndSet(state.text, \"\")\n    const text = (override !== undefined && override.length > 0 ? override : acc).trim()\n    if (text.length > 0) yield* Queue.offer(queue, { _tag: \"final\", text })\n  })\n\nconst handleServerMessage =\n  (queue: Queue.Queue<TranscriptEvent, Cause.Done>, state: TurnState) => (raw: string) =>\n    Effect.gen(function* () {\n      const json = yield* JSONL.parseSafe(raw)\n      if (json === undefined) return\n      const decoded = yield* decodeServerEvent(json).pipe(Effect.option)\n      if (decoded._tag === \"None\") return\n      yield* Match.value(decoded.value).pipe(\n        Match.when({ type: \"transcription.text.delta\" }, (m) =>\n          Effect.gen(function* () {\n            const now = yield* Clock.currentTimeMillis\n            const next = yield* Ref.updateAndGet(state.text, (t) => t + m.text)\n            yield* Ref.set(state.lastActivityMs, now)\n            // Cumulative partial so the UI shows the growing sentence.\n            yield* Queue.offer(queue, { _tag: \"partial\", text: next })\n          }),\n        ),\n        // End-of-audio: commit whatever's left as the final utterance.\n        Match.when({ type: \"transcription.done\" }, (m) => emitFinal(queue, state, m.text)),\n        Match.when({ type: \"error\" }, (m) =>\n          Queue.offer(queue, {\n            _tag: \"error\",\n            ...(m.error.code != null && { code: String(m.error.code) }),\n            message: m.error.message,\n          }),\n        ),\n        // session.created / .updated / language / segment: no user-visible event.\n        Match.orElse(() => Effect.void),\n      )\n    })\n\n// Background loop: commit a synthetic final once the deltas go quiet.\nconst silenceFinalizer = (\n  queue: Queue.Queue<TranscriptEvent, Cause.Done>,\n  state: TurnState,\n  silence: Duration.Duration,\n): Effect.Effect<never> => {\n  const silenceMs = Duration.toMillis(silence)\n  return Effect.gen(function* () {\n    const now = yield* Clock.currentTimeMillis\n    const last = yield* Ref.get(state.lastActivityMs)\n    const acc = yield* Ref.get(state.text)\n    if (acc.trim().length > 0 && now - last >= silenceMs) yield* emitFinal(queue, state)\n    yield* Effect.sleep(\"150 millis\")\n  }).pipe(Effect.forever)\n}\n\n// ---------------------------------------------------------------------------\n// Stream<Uint8Array> → Stream<TranscriptEvent>\n// ---------------------------------------------------------------------------\n\n// `@types/ws`'s WebSocket extends Node's EventEmitter while\n// `globalThis.WebSocket` extends EventTarget; the browser-style surface\n// Effect's Socket reads (`addEventListener` / `send` / `close`) is identical at\n// runtime, hence the single contained cast.\nconst authedWsConstructor =\n  (cfg: Config): Socket.WebSocketConstructor[\"Service\"] =>\n  (url) =>\n    new WSWebSocket(url, undefined, {\n      headers: { Authorization: `Bearer ${Redacted.value(cfg.apiKey)}` },\n    }) as unknown as globalThis.WebSocket\n\nexport const streamTranscription =\n  (cfg: Config) =>\n  <E, R>(\n    audioIn: Stream.Stream<Uint8Array, E, R>,\n    request: CommonStreamTranscribeRequest,\n  ): Stream.Stream<TranscriptEvent, AiError.AiError | E, R> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        yield* ensureInputFormat(request.inputFormat)\n        const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request.model), {\n          // Effect's Socket treats all close codes as errors by default —\n          // whitelist standard clean-close codes (1000 / 1001 / 1005).\n          closeCodeIsError: (code) => code !== 1000 && code !== 1001 && code !== 1005,\n        }).pipe(Effect.provideService(Socket.WebSocketConstructor, authedWsConstructor(cfg)))\n        const queue = yield* Queue.bounded<TranscriptEvent, Cause.Done>(64)\n        const state: TurnState = {\n          text: yield* Ref.make(\"\"),\n          lastActivityMs: yield* Ref.make(0),\n        }\n        const write = yield* socket.writer\n\n        // session.update first, then stream base64 PCM frames, then signal end.\n        // Fork-scoped so the Stream's downstream scope tears them down on\n        // disconnect / cancel.\n        yield* Effect.gen(function* () {\n          yield* write(sessionUpdateFrame(cfg))\n          yield* Stream.runForEach(audioIn, (bytes) => write(audioAppendFrame(bytes)))\n          yield* write(audioEndFrame)\n        }).pipe(\n          Effect.tapError((cause) =>\n            Effect.logWarning(\"[voxtral-realtime] audio send failed\", { cause }),\n          ),\n          Effect.ignore,\n          Effect.forkScoped,\n        )\n\n        yield* silenceFinalizer(queue, state, cfg.utteranceSilence ?? DEFAULT_SILENCE).pipe(\n          Effect.forkScoped,\n        )\n\n        // `Queue.end` flushes pending events then ends the stream cleanly;\n        // `Queue.shutdown` would drop queued items and interrupt takes. A\n        // connection/read failure is logged (otherwise the stream would end\n        // silently with no transcripts).\n        yield* socket.runString(handleServerMessage(queue, state)).pipe(\n          Effect.tapError((cause) =>\n            Effect.logWarning(\"[voxtral-realtime] socket closed\", { cause }),\n          ),\n          Effect.ensuring(Queue.end(queue)),\n          Effect.forkScoped,\n        )\n\n        return Stream.fromQueue(queue)\n      }),\n    )\n"],"mappings":"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"}
+{"version":3,"file":"realtimeStt.mjs","names":["WSWebSocket"],"sources":["../src/realtimeStt.ts"],"sourcesContent":["/**\n * Voxtral Realtime STT over WebSocket.\n *\n * Protocol mirrors the `mistralai[realtime]` Python client:\n *   - URL: `wss://api.mistral.ai/v1/audio/transcriptions/realtime?model=…`\n *     (the model is a query param, not a session field).\n *   - Auth: `Authorization: Bearer …` header on the upgrade. The browser\n *     `WebSocket` API can't set headers, so this module uses the `ws` peer\n *     dep; `ws` is only pulled in transitively via\n *     `MistralRealtimeTranscriber` (the sync `MistralTranscriber` stays free\n *     of it).\n *   - Client → server (JSON): `session.update` (audio_format +\n *     target_streaming_delay_ms), then `input_audio.append` with base64 PCM,\n *     and `input_audio.end` when the mic stream stops.\n *   - Server → client (JSON): `session.created` / `session.updated`,\n *     `transcription.text.delta` (`{ text }`), `transcription.done`\n *     (`{ text }`), `transcription.segment`, `transcription.language`,\n *     and `error` (`{ error: { message, code } }`).\n *\n * Voxtral Realtime is a *continuous* transcriber: it streams text deltas and\n * only emits one `transcription.done` at end-of-audio (no server-side\n * utterance segmentation). To satisfy the `Transcriber` contract's `final`\n * semantics for conversational use, this adapter synthesizes a `final` event\n * when the deltas go quiet for `utteranceSilence`.\n */\nimport {\n  Clock,\n  Duration,\n  Effect,\n  Match,\n  Option,\n  Predicate,\n  Redacted,\n  Ref,\n  Schema,\n  Stream,\n} from \"effect\"\nimport { Base64 } from \"effect/encoding\"\nimport * as Socket from \"effect/socket/Socket\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioFormat } from \"@effect-uai/core/Audio\"\nimport * as JSONL from \"@effect-uai/core/JSONL\"\nimport type { TranscriptEvent } from \"@effect-uai/core/Transcript\"\nimport type { CommonStreamTranscribeRequest } from \"@effect-uai/core/Transcriber\"\nimport * as WebSocketSession from \"@effect-uai/core/WebSocketSession\"\nimport { WebSocket as WSWebSocket } from \"ws\"\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n  /** Target latency knob (`target_streaming_delay_ms`); lower = faster, less accurate. */\n  readonly targetStreamingDelay?: Duration.Duration\n  /**\n   * Silence gap after which the accumulated deltas are committed as a synthetic\n   * `final`. Voxtral Realtime does no utterance segmentation, so this is how the\n   * adapter delimits turns. Default 700 ms.\n   */\n  readonly utteranceSilence?: Duration.Duration\n  /**\n   * Build the socket yourself, for a proxy or an in-memory transport. The\n   * default attaches the bearer token through the `ws` package.\n   */\n  readonly webSocket?: Socket.WebSocketConstructor[\"Service\"]\n}\n\nconst DEFAULT_SILENCE = Duration.millis(700)\n\n// ---------------------------------------------------------------------------\n// AudioFormat gate — Voxtral Realtime ingests pcm_s16le @ 16000 mono only.\n// ---------------------------------------------------------------------------\n\nconst ensureInputFormat = (format: AudioFormat): Effect.Effect<void, AiError.AiError> =>\n  format.container === \"raw\" && format.encoding === \"pcm_s16le\" && format.sampleRate === 16000\n    ? Effect.void\n    : Effect.fail(\n        new AiError.Unsupported({\n          provider: \"mistral\",\n          capability: \"inputFormat\",\n          reason: `Voxtral Realtime accepts pcm_s16le @ 16000 mono only. Got ${JSON.stringify(format)}.`,\n        }),\n      )\n\n// ---------------------------------------------------------------------------\n// URL + client frame builders\n// ---------------------------------------------------------------------------\n\nconst buildWsUrl = (cfg: Config, model: string) => {\n  const base = (cfg.baseUrl ?? \"https://api.mistral.ai\").replace(/^http/, \"ws\")\n  return `${base}/v1/audio/transcriptions/realtime?model=${encodeURIComponent(model)}`\n}\n\nconst sessionUpdateFrame = (cfg: Config) =>\n  JSON.stringify({\n    type: \"session.update\",\n    session: {\n      audio_format: { encoding: \"pcm_s16le\", sample_rate: 16000 },\n      ...(cfg.targetStreamingDelay !== undefined && {\n        target_streaming_delay_ms: Duration.toMillis(cfg.targetStreamingDelay),\n      }),\n    },\n  })\n\nconst audioAppendFrame = (bytes: Uint8Array) =>\n  JSON.stringify({ type: \"input_audio.append\", audio: Base64.encode(bytes) })\n\nconst audioEndFrame = JSON.stringify({ type: \"input_audio.end\" })\n\n// ---------------------------------------------------------------------------\n// Wire schemas (server → client)\n// ---------------------------------------------------------------------------\n\nconst ServerEvent = Schema.Union([\n  Schema.Struct({ type: Schema.Literal(\"session.created\") }),\n  Schema.Struct({ type: Schema.Literal(\"session.updated\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.language\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.segment\") }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.text.delta\"), text: Schema.String }),\n  Schema.Struct({ type: Schema.Literal(\"transcription.done\"), text: Schema.String }),\n  Schema.Struct({\n    type: Schema.Literal(\"error\"),\n    error: Schema.Struct({\n      message: Schema.String,\n      code: Schema.optional(Schema.NullOr(Schema.Number)),\n    }),\n  }),\n])\nconst decodeServerEvent = Schema.decodeUnknownEffect(ServerEvent)\n\n/** Mutable turn state shared by the frame handler and the silence finalizer. */\ntype TurnState = {\n  readonly text: Ref.Ref<string>\n  readonly lastActivityMs: Ref.Ref<number>\n}\n\nconst takeFinal = (\n  state: TurnState,\n  override?: string,\n): Effect.Effect<TranscriptEvent | undefined> =>\n  Effect.gen(function* () {\n    const acc = yield* Ref.getAndSet(state.text, \"\")\n    const text = (override !== undefined && override.length > 0 ? override : acc).trim()\n    return text.length > 0 ? { _tag: \"final\", text } : undefined\n  })\n\nconst frameToEvent =\n  (state: TurnState) =>\n  (raw: string): Effect.Effect<TranscriptEvent | undefined> =>\n    Effect.gen(function* () {\n      const json = yield* JSONL.parseSafe(raw)\n      if (json === undefined) return undefined\n      const decoded = yield* decodeServerEvent(json).pipe(Effect.option)\n      if (Option.isNone(decoded)) return undefined\n      return yield* Match.value(decoded.value).pipe(\n        Match.when({ type: \"transcription.text.delta\" }, (m) =>\n          Effect.gen(function* () {\n            const now = yield* Clock.currentTimeMillis\n            const next = yield* Ref.updateAndGet(state.text, (t) => t + m.text)\n            yield* Ref.set(state.lastActivityMs, now)\n            // Cumulative partial so the UI shows the growing sentence.\n            return { _tag: \"partial\", text: next } satisfies TranscriptEvent\n          }),\n        ),\n        // End-of-audio: commit whatever's left as the final utterance.\n        Match.when({ type: \"transcription.done\" }, (m) => takeFinal(state, m.text)),\n        Match.when({ type: \"error\" }, (m) =>\n          Effect.succeed<TranscriptEvent>({\n            _tag: \"error\",\n            ...(m.error.code != null && { code: String(m.error.code) }),\n            message: m.error.message,\n          }),\n        ),\n        // session.created / .updated / language / segment: no user-visible event.\n        Match.orElse(() => Effect.succeed(undefined)),\n      )\n    })\n\n// Commits a synthetic final once the deltas go quiet; checks now, then every 150 ms.\nconst silenceFinals = (\n  state: TurnState,\n  silence: Duration.Duration,\n): Stream.Stream<TranscriptEvent> => {\n  const silenceMs = Duration.toMillis(silence)\n  return Stream.tick(\"150 millis\").pipe(\n    Stream.mapEffect(() =>\n      Effect.gen(function* () {\n        const now = yield* Clock.currentTimeMillis\n        const last = yield* Ref.get(state.lastActivityMs)\n        const acc = yield* Ref.get(state.text)\n        return acc.trim().length > 0 && now - last >= silenceMs\n          ? yield* takeFinal(state)\n          : undefined\n      }),\n    ),\n    Stream.filter(Predicate.isNotUndefined),\n  )\n}\n\n// ---------------------------------------------------------------------------\n// Stream<Uint8Array> → Stream<TranscriptEvent>\n// ---------------------------------------------------------------------------\n\n// `@types/ws`'s WebSocket extends Node's EventEmitter while\n// `globalThis.WebSocket` extends EventTarget; the browser-style surface\n// Effect's Socket reads (`addEventListener` / `send` / `close`) is identical at\n// runtime, hence the single contained cast.\nconst authedWsConstructor =\n  (cfg: Config): Socket.WebSocketConstructor[\"Service\"] =>\n  (url) =>\n    new WSWebSocket(url, undefined, {\n      headers: { Authorization: `Bearer ${Redacted.value(cfg.apiKey)}` },\n    }) as unknown as globalThis.WebSocket\n\nexport const streamTranscription =\n  (cfg: Config) =>\n  <E, R>(\n    audioIn: Stream.Stream<Uint8Array, E, R>,\n    request: CommonStreamTranscribeRequest,\n  ): Stream.Stream<TranscriptEvent, AiError.AiError | E, R> =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        yield* ensureInputFormat(request.inputFormat)\n        const socket = yield* Socket.makeWebSocket(buildWsUrl(cfg, request.model)).pipe(\n          Effect.provideService(\n            Socket.WebSocketConstructor,\n            cfg.webSocket ?? authedWsConstructor(cfg),\n          ),\n        )\n        const state: TurnState = {\n          text: yield* Ref.make(\"\"),\n          lastActivityMs: yield* Ref.make(0),\n        }\n        const { write } = yield* socket.writer\n        const asAiError = WebSocketSession.toAiError(\"mistral\")\n\n        const frames = Stream.fromPull(Socket.readerString(socket)).pipe(\n          Stream.scoped,\n          Stream.catchIf(WebSocketSession.isCleanClose, () => Stream.empty),\n          Stream.mapError(asAiError),\n          Stream.mapEffect(frameToEvent(state)),\n          Stream.filter(Predicate.isNotUndefined),\n        )\n        const events = Stream.merge(\n          frames,\n          silenceFinals(state, cfg.utteranceSilence ?? DEFAULT_SILENCE),\n          { haltStrategy: \"left\" },\n        )\n\n        // session.update first, then base64 PCM, then signal end. Writes wait for the reader to connect.\n        const outgoing = Stream.concat(\n          Stream.concat(\n            Stream.make(sessionUpdateFrame(cfg)),\n            Stream.map(audioIn, audioAppendFrame),\n          ),\n          Stream.make(audioEndFrame),\n        ).pipe(Stream.mapEffect((frame) => Effect.mapError(write(frame), asAiError)))\n\n        // The server's close ends the transcript; the audio running out does not.\n        return Stream.merge(events, Stream.drain(outgoing), { haltStrategy: \"left\" })\n      }),\n    )\n"],"mappings":"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"}

package/dist/realtimeStt.test.d.mts

@@ -0,0 +1 @@
+export {}

package/dist/realtimeStt.test.mjs

@@ -0,0 +1,317 @@
+import { streamTranscription } from "./realtimeStt.mjs";
+import { a as beforeEach, i as beforeAll, n as globalExpect, o as describe, r as afterAll, s as it$2, t as TestRunner } from "./index.C4tKZ0yW-CUBm3Bmz.mjs";
+import { Effect, Exit, Fiber, Redacted, Stream } from "effect";
+import * as Arbitrary from "effect/Arbitrary";
+import * as Cause from "effect/Cause";
+import * as Duration$1 from "effect/Duration";
+import * as Effect$1 from "effect/Effect";
+import * as Exit$1 from "effect/Exit";
+import "effect/Fiber";
+import { constVoid, flow, pipe } from "effect/Function";
+import * as Layer$1 from "effect/Layer";
+import * as Schedule from "effect/Schedule";
+import * as Scope from "effect/Scope";
+import * as TestClock$1 from "effect/testing/TestClock";
+import * as TestConsole from "effect/testing/TestConsole";
+import { TestClock } from "effect/testing";
+import * as FakeWebSocket from "@effect-uai/core/testing/FakeWebSocket";
+//#region ../../../node_modules/.pnpm/@effect+vitest@4.1.2_effect@4.1.2_vitest@5.0.3_@types+node@26.2.0_vite@7.3.2_@types+nod_a2fffe0deec250ef9d6207b86a9a1ab8/node_modules/@effect/vitest/dist/internal/internal.js
+/**
+* @since 4.0.0
+*/
+const getCurrentSuite = TestRunner.getCurrentSuite;
+const runPromise = (effect, ctx) => Effect$1.runPromise(Effect$1.uninterruptibleMask((restore) => Effect$1.gen(function* () {
+	const exit = yield* Effect$1.exit(restore(effect));
+	if (Exit$1.isFailure(exit)) {
+		const errors = Cause.prettyErrors(exit.cause);
+		for (let i = 0; i < errors.length; i++) yield* Effect$1.logError(errors[i]);
+	}
+	return yield* exit;
+})), { signal: ctx?.signal });
+const settleOnAbort = (ctx, promise) => {
+	const onAbort = () => ctx.onTestFinished(() => promise.then(constVoid, constVoid));
+	ctx.signal.addEventListener("abort", onAbort, { once: true });
+	const cleanup = () => ctx.signal.removeEventListener("abort", onAbort);
+	promise.then(cleanup, cleanup);
+	if (ctx.signal.aborted) onAbort();
+	return promise;
+};
+/** @internal */
+const runTest = (ctx) => (effect) => {
+	const promise = runPromise(effect, ctx);
+	return ctx ? settleOnAbort(ctx, promise) : promise;
+};
+const TestEnv = /*#__PURE__*/ Layer$1.mergeAll(TestConsole.layer, /*#__PURE__*/ TestClock$1.layer());
+/** @internal */
+const testOptions = (timeout) => typeof timeout === "number" ? { timeout } : timeout ?? {};
+const hookTimeout = (timeout) => timeout === void 0 ? void 0 : Duration$1.toMillis(Duration$1.fromInputUnsafe(timeout));
+const propertyTestOptions = (timeout) => typeof timeout === "number" ? void 0 : timeout;
+const checkOptions = (timeout) => propertyTestOptions(timeout)?.arbitrary;
+const compileArbitraryInput = (input) => Arbitrary.isArbitrary(input) ? input : Arbitrary.schema(input);
+const makeArbitrary = (arbitraries) => Arbitrary.all(Array.isArray(arbitraries) ? arbitraries.map(compileArbitraryInput) : Object.fromEntries(Object.entries(arbitraries).map(([key, input]) => [key, compileArbitraryInput(input)])));
+const normalizeProperty = (property, value) => Effect$1.catchCause(Effect$1.suspend(() => {
+	const output = property(value);
+	return Effect$1.isEffect(output) ? output : Effect$1.succeed(output);
+}), (cause) => Cause.hasInterrupts(cause) ? Effect$1.failCause(cause) : Effect$1.fail(cause));
+const runCheck = (ctx, arbitrary, property, options) => runTest(ctx)(Effect$1.flatMapEager(Arbitrary.checkEffect(arbitrary, (value) => normalizeProperty(property, value), options), (result) => {
+	const failure = Arbitrary.formatCheckFailure(result);
+	return failure === void 0 ? Effect$1.void : Effect$1.die(new Error(failure));
+}));
+const withFixturesOf = (source, f) => Object.defineProperty(f, "toString", { value: () => source.toString() });
+const makeItProxy = (it, overrides) => new Proxy(it, {
+	apply(target, thisArg, argArray) {
+		return Reflect.apply(target, thisArg, argArray);
+	},
+	get(target, property, receiver) {
+		if (Object.hasOwn(overrides, property)) return Reflect.get(overrides, property);
+		return Reflect.get(target, property, receiver);
+	}
+});
+const collectTasks = (tasks, acc = []) => {
+	for (let i = 0; i < tasks.length; i++) {
+		const task = tasks[i];
+		if (task.type === "test" && task.mode !== "skip" && task.mode !== "todo") acc.push(task);
+		else if (task.tasks !== void 0) collectTasks(task.tasks, acc);
+	}
+	return acc;
+};
+const runsMoreThanOnce = (task) => {
+	return ((typeof task.retry === "number" ? task.retry : task.retry?.count) ?? 0) > 0 || (task.repeats ?? 0) > 0;
+};
+const registerProp = (it, name, arbitraries, property, timeout) => {
+	const arbitrary = makeArbitrary(arbitraries);
+	it(name, testOptions(timeout), withFixturesOf(() => {}, (ctx) => runCheck(ctx, arbitrary, (values) => property(values, ctx), checkOptions(timeout))));
+};
+const makeTester = (mapEffect, it) => {
+	const run = (ctx, args, self) => pipe(Effect$1.suspend(() => self(...args)), mapEffect, runTest(ctx));
+	const register = (test) => (name, self, timeout) => test(name, testOptions(timeout), withFixturesOf(self, (ctx) => run(ctx, [ctx], self)));
+	const each = (cases) => (name, self, timeout) => it.for(cases)(name, testOptions(timeout), withFixturesOf(self, (args, ctx) => run(ctx, [args, ctx], self).then(constVoid)));
+	const prop = (name, arbitraries, self, timeout) => registerProp(it, name, arbitraries, (values, ctx) => Effect$1.mapEager(mapEffect(Effect$1.suspend(() => self(values, ctx))), (value) => value !== false), timeout);
+	return Object.assign(register(it), {
+		skip: register(it.skip),
+		skipIf: (condition) => register(it.skipIf(condition)),
+		runIf: (condition) => register(it.runIf(condition)),
+		only: register(it.only),
+		each,
+		fails: register(it.fails),
+		prop
+	});
+};
+const makeProp = (it) => (name, arbitraries, self, timeout) => registerProp(it, name, arbitraries, (values, ctx) => {
+	const result = self(values, ctx);
+	if (result !== void 0 && typeof result !== "boolean") throw new TypeError("it.prop callbacks must return boolean or void. Use it.effect.prop for Effect callbacks.");
+	return result !== false;
+}, timeout);
+const makeLayer = (it) => (layer_, options) => (...args) => {
+	const excludeTestServices = options?.excludeTestServices ?? false;
+	const withTestEnv = excludeTestServices ? layer_ : Layer$1.provideMerge(layer_, TestEnv);
+	const memoMap = options?.memoMap ?? Effect$1.runSync(Layer$1.makeMemoMap);
+	const buildPerTest = options?.buildPerTest ?? false;
+	const suiteOptions = options?.concurrent === void 0 ? {} : { concurrent: options.concurrent };
+	const makeBlockMethods = (provide) => makeItProxy(it, {
+		effect: makeTester((effect) => provide(Effect$1.scoped(effect)), it),
+		prop: makeProp(it),
+		flakyTest,
+		layer(nestedLayer, nestedOptions) {
+			return makeLayer(it)(Layer$1.provideMerge(nestedLayer, withTestEnv), {
+				...nestedOptions,
+				memoMap: Layer$1.forkMemoMapUnsafe(memoMap),
+				excludeTestServices,
+				buildPerTest: buildPerTest || nestedOptions?.buildPerTest === true
+			});
+		}
+	});
+	if (buildPerTest) {
+		const methods = makeBlockMethods((effect) => Effect$1.scopedWith((scope) => Layer$1.buildWithMemoMap(withTestEnv, Layer$1.forkMemoMapUnsafe(memoMap), scope).pipe(Effect$1.orDie, Effect$1.flatMap((context) => Effect$1.provide(effect, context)))));
+		if (args.length === 1) return args[0](methods);
+		return describe(args[0], suiteOptions, () => args[1](methods));
+	}
+	const scope = Effect$1.runSync(Scope.make());
+	const contextEffect = Layer$1.buildWithMemoMap(withTestEnv, memoMap, scope).pipe(Effect$1.orDie, Effect$1.cached, Effect$1.runSync);
+	let closed = false;
+	const closeScope = () => {
+		if (closed) return Promise.resolve();
+		closed = true;
+		return runPromise(Scope.close(scope, Exit$1.void));
+	};
+	const methods = makeBlockMethods((effect) => Effect$1.flatMap(contextEffect, (context) => Effect$1.provide(effect, context)));
+	if (args.length === 1) {
+		const currentSuite = getCurrentSuite();
+		const previousTasks = new Set(currentSuite.tasks);
+		args[0](methods);
+		const blockTasks = collectTasks(currentSuite.tasks.filter((task) => !previousTasks.has(task)));
+		if (blockTasks.length === 0) {
+			afterAll(() => closeScope(), hookTimeout(options?.timeout));
+			return;
+		}
+		const blockTaskSet = new Set(blockTasks);
+		const releaseAfterLastTest = !blockTasks.some(runsMoreThanOnce);
+		let remaining = blockTasks.length;
+		beforeEach(({ onTestFinished, signal, task }) => {
+			if (!blockTaskSet.has(task)) return;
+			if (releaseAfterLastTest) onTestFinished(() => {
+				remaining--;
+				if (remaining === 0) return closeScope();
+			});
+			return runPromise(Effect$1.asVoid(contextEffect), { signal });
+		}, hookTimeout(options?.timeout));
+		afterAll(() => closeScope(), hookTimeout(options?.timeout));
+		return;
+	}
+	return describe(args[0], suiteOptions, () => {
+		beforeAll(() => runPromise(Effect$1.asVoid(contextEffect)), hookTimeout(options?.timeout));
+		afterAll(() => closeScope(), hookTimeout(options?.timeout));
+		return args[1](methods);
+	});
+};
+/** @internal */
+const flakyTest = (self, timeout = Duration$1.seconds(30)) => pipe(self, Effect$1.scoped, Effect$1.sandbox, Effect$1.retry(pipe(Schedule.recurs(10), Schedule.while((_) => Effect$1.succeed(Duration$1.isLessThanOrEqualTo(Duration$1.fromInputUnsafe(_.elapsed), Duration$1.fromInputUnsafe(timeout)))))), Effect$1.orDie);
+/** @internal */
+const makeMethods = (it) => makeItProxy(it, {
+	effect: makeTester(flow(Effect$1.scoped, Effect$1.provide(TestEnv)), it),
+	live: makeTester(Effect$1.scoped, it),
+	flakyTest,
+	layer: makeLayer(it),
+	prop: makeProp(it)
+});
+/** @internal */
+const it$1 = /*#__PURE__*/ makeMethods(it$2);
+/** @internal */
+const { effect, layer, live, prop } = it$1;
+//#endregion
+//#region ../../../node_modules/.pnpm/@effect+vitest@4.1.2_effect@4.1.2_vitest@5.0.3_@types+node@26.2.0_vite@7.3.2_@types+nod_a2fffe0deec250ef9d6207b86a9a1ab8/node_modules/@effect/vitest/dist/index.js
+/**
+* Vitest test API extended with Effect test helpers.
+*
+* @stability unstable
+* @category testing
+* @since 4.0.0
+*/
+const it = it$1;
+//#endregion
+//#region src/realtimeStt.test.ts
+const request = {
+	model: "voxtral-mini-transcribe-realtime-2602",
+	inputFormat: {
+		container: "raw",
+		encoding: "pcm_s16le",
+		sampleRate: 16e3,
+		channels: 1
+	}
+};
+const sessionCreated = {
+	type: "session.created",
+	session: {
+		request_id: "req_1",
+		model: request.model
+	}
+};
+const delta = (text) => ({
+	type: "transcription.text.delta",
+	text
+});
+const start = (server, audioIn) => streamTranscription({
+	apiKey: Redacted.make("test-key"),
+	webSocket: server.connect
+})(audioIn, request).pipe(Stream.runCollect, Effect.exit, Effect.forkChild);
+/** Run a transcription against `server`, closing it, if asked, once the frames are in. */
+const transcribe = (server, audioIn, close) => Effect.gen(function* () {
+	const collector = yield* start(server, audioIn);
+	if (close !== void 0) {
+		yield* server.greeted;
+		yield* server.awaitSent(close.afterSent ?? 0);
+		yield* server.close(close.code);
+	}
+	return yield* Fiber.join(collector);
+});
+describe("Mistral Realtime STT socket", () => {
+	it.live("configures the session before any audio, and ends on a clean close", () => Effect.gen(function* () {
+		const server = yield* FakeWebSocket.make({ greeting: [
+			sessionCreated,
+			delta("hel"),
+			delta("lo"),
+			{
+				type: "transcription.done",
+				text: "hello",
+				model: request.model,
+				segments: []
+			},
+			{
+				type: "error",
+				error: {
+					message: "slow down",
+					code: 3001
+				}
+			}
+		] });
+		const exit = yield* transcribe(server, Stream.make(new Uint8Array([1, 2])), {
+			code: 1e3,
+			afterSent: 3
+		});
+		globalExpect(exit).toEqual(Exit.succeed([
+			{
+				_tag: "partial",
+				text: "hel"
+			},
+			{
+				_tag: "partial",
+				text: "hello"
+			},
+			{
+				_tag: "final",
+				text: "hello"
+			},
+			{
+				_tag: "error",
+				code: "3001",
+				message: "slow down"
+			}
+		]));
+		const sent = yield* server.sent;
+		globalExpect(sent.map((f) => f.type)).toEqual([
+			"session.update",
+			"input_audio.append",
+			"input_audio.end"
+		]);
+	}).pipe(Effect.scoped));
+	it.live("fails rather than ending when the connection drops", () => Effect.gen(function* () {
+		const server = yield* FakeWebSocket.make({ greeting: [sessionCreated] });
+		const exit = yield* transcribe(server, Stream.never, { code: 1011 });
+		globalExpect(Exit.isFailure(exit) && JSON.stringify(exit.cause)).toContain("Unavailable");
+	}).pipe(Effect.scoped));
+	it.live("fails with the audio input's own error", () => Effect.gen(function* () {
+		const server = yield* FakeWebSocket.make({ greeting: [sessionCreated] });
+		const exit = yield* transcribe(server, Stream.fail("microphone unplugged"));
+		globalExpect(Exit.isFailure(exit) && JSON.stringify(exit.cause)).toContain("microphone unplugged");
+	}).pipe(Effect.scoped));
+	it.effect("commits a synthetic final once the deltas go quiet", () => Effect.gen(function* () {
+		const server = yield* FakeWebSocket.make({ greeting: [
+			sessionCreated,
+			delta("hel"),
+			delta("lo ")
+		] });
+		const collector = yield* start(server, Stream.never);
+		yield* server.greeted;
+		yield* TestClock.withLive(Effect.sleep("5 millis"));
+		yield* TestClock.adjust("1 second");
+		yield* server.close(1e3);
+		globalExpect(yield* Fiber.join(collector)).toEqual(Exit.succeed([
+			{
+				_tag: "partial",
+				text: "hel"
+			},
+			{
+				_tag: "partial",
+				text: "hello "
+			},
+			{
+				_tag: "final",
+				text: "hello"
+			}
+		]));
+	}).pipe(Effect.scoped));
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=realtimeStt.test.mjs.map