@effect-uai/core 0.3.0 → 0.5.0

package/dist/testing/MockSpeechSynthesizer.d.mts

@@ -0,0 +1,37 @@
+import { n as AudioChunk, t as AudioBlob } from "../Audio-BfCTGnH3.mjs";
+import { CommonStreamSynthesizeRequest, CommonSynthesizeRequest, SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
+import { Effect, Layer } from "effect";
+
+//#region src/testing/MockSpeechSynthesizer.d.ts
+type MockSynthesizerRecorder = {
+  readonly synthesizeCalls: ReadonlyArray<CommonSynthesizeRequest>;
+  readonly streamSynthesisCalls: ReadonlyArray<CommonSynthesizeRequest>;
+  readonly streamSynthesisFromCalls: ReadonlyArray<CommonStreamSynthesizeRequest>;
+};
+type MockSynthesizerScript = {
+  /** One blob per `synthesize` call, consumed in order. */readonly blobs?: ReadonlyArray<AudioBlob>; /** One chunk-list per `streamSynthesis` call, consumed in order. */
+  readonly streamSynthesisChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>; /** One chunk-list per `streamSynthesisFrom` call, consumed in order. */
+  readonly streamSynthesisFromChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>;
+};
+/**
+ * Layer providing the `SpeechSynthesizer` service AND the
+ * `TtsIncrementalText` capability marker. Use for the common case
+ * where code under test exercises `streamSynthesisFrom`.
+ */
+declare const layer: (script: MockSynthesizerScript) => {
+  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText>;
+  readonly recorder: Effect.Effect<MockSynthesizerRecorder>;
+};
+/**
+ * Variant that omits the `TtsIncrementalText` marker — simulates a
+ * provider without incremental-text-in support (e.g. OpenAI, AWS
+ * Polly non-Generative). Calls to `streamSynthesisFrom` in code under
+ * test should be a compile-time error.
+ */
+declare const layerWithoutIncremental: (script: MockSynthesizerScript) => {
+  readonly layer: Layer.Layer<SpeechSynthesizer>;
+  readonly recorder: Effect.Effect<MockSynthesizerRecorder>;
+};
+//#endregion
+export { MockSynthesizerRecorder, MockSynthesizerScript, layer, layerWithoutIncremental };
+//# sourceMappingURL=MockSpeechSynthesizer.d.mts.map

package/dist/testing/MockSpeechSynthesizer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockSpeechSynthesizer.d.mts","names":[],"sources":["../../src/testing/MockSpeechSynthesizer.ts"],"mappings":";;;;;KAWY,uBAAA;EAAA,SACD,eAAA,EAAiB,aAAA,CAAc,uBAAA;EAAA,SAC/B,oBAAA,EAAsB,aAAA,CAAc,uBAAA;EAAA,SACpC,wBAAA,EAA0B,aAAA,CAAc,6BAAA;AAAA;AAAA,KAGvC,qBAAA;EALgB,kEAOjB,KAAA,GAAQ,aAAA,CAAc,SAAA,GANA;EAAA,SAQtB,qBAAA,GAAwB,aAAA,CAAc,aAAA,CAAc,UAAA,IAP1B;EAAA,SAS1B,yBAAA,GAA4B,aAAA,CAAc,aAAA,CAAc,UAAA;AAAA;;;;;;cA8EtD,KAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,iBAAA,GAAoB,kBAAA;EAAA,SACvC,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA;;;AAxFnC;;;;cAuHa,uBAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,iBAAA;EAAA,SACnB,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA"}

package/dist/testing/MockSpeechSynthesizer.mjs

@@ -0,0 +1,95 @@
+import { InvalidRequest } from "../domain/AiError.mjs";
+import { SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
+import { Effect, Layer, Ref, Stream } from "effect";
+//#region src/testing/MockSpeechSynthesizer.ts
+const makeService = (script, record) => Effect.gen(function* () {
+	const bCursor = yield* Ref.make(0);
+	const ssCursor = yield* Ref.make(0);
+	const ssfCursor = yield* Ref.make(0);
+	return {
+		synthesize: (request) => Effect.gen(function* () {
+			yield* record.synthesize(request);
+			const i = yield* Ref.getAndUpdate(bCursor, (n) => n + 1);
+			const scripted = script.blobs ?? [];
+			if (i >= scripted.length) return yield* new InvalidRequest({
+				provider: "mock",
+				raw: `MockSpeechSynthesizer exhausted: ${scripted.length} blobs scripted, but call ${i + 1} was made`
+			});
+			return scripted[i];
+		}),
+		streamSynthesis: (request) => Stream.unwrap(Effect.gen(function* () {
+			yield* record.streamSynthesis(request);
+			const i = yield* Ref.getAndUpdate(ssCursor, (n) => n + 1);
+			const scripted = script.streamSynthesisChunks ?? [];
+			if (i >= scripted.length) return Stream.fail(new InvalidRequest({
+				provider: "mock",
+				raw: `MockSpeechSynthesizer exhausted: ${scripted.length} streamSynthesis lists scripted, but call ${i + 1} was made`
+			}));
+			return Stream.fromIterable(scripted[i]);
+		})),
+		streamSynthesisFrom: (textIn, request) => Stream.unwrap(Effect.gen(function* () {
+			yield* record.streamSynthesisFrom(request);
+			const i = yield* Ref.getAndUpdate(ssfCursor, (n) => n + 1);
+			const scripted = script.streamSynthesisFromChunks ?? [];
+			if (i >= scripted.length) return Stream.fail(new InvalidRequest({
+				provider: "mock",
+				raw: `MockSpeechSynthesizer exhausted: ${scripted.length} streamSynthesisFrom lists scripted, but call ${i + 1} was made`
+			}));
+			return Stream.drain(textIn).pipe(Stream.concat(Stream.fromIterable(scripted[i])));
+		}))
+	};
+});
+/**
+* Layer providing the `SpeechSynthesizer` service AND the
+* `TtsIncrementalText` capability marker. Use for the common case
+* where code under test exercises `streamSynthesisFrom`.
+*/
+const layer = (script) => {
+	const bCalls = Ref.makeUnsafe([]);
+	const ssCalls = Ref.makeUnsafe([]);
+	const ssfCalls = Ref.makeUnsafe([]);
+	const synthesizerLayer = Layer.effect(SpeechSynthesizer, makeService(script, {
+		synthesize: (req) => Ref.update(bCalls, (xs) => [...xs, req]),
+		streamSynthesis: (req) => Ref.update(ssCalls, (xs) => [...xs, req]),
+		streamSynthesisFrom: (req) => Ref.update(ssfCalls, (xs) => [...xs, req])
+	}));
+	return {
+		layer: Layer.merge(synthesizerLayer, Layer.succeed(TtsIncrementalText, void 0)),
+		recorder: Effect.gen(function* () {
+			return {
+				synthesizeCalls: yield* Ref.get(bCalls),
+				streamSynthesisCalls: yield* Ref.get(ssCalls),
+				streamSynthesisFromCalls: yield* Ref.get(ssfCalls)
+			};
+		})
+	};
+};
+/**
+* Variant that omits the `TtsIncrementalText` marker — simulates a
+* provider without incremental-text-in support (e.g. OpenAI, AWS
+* Polly non-Generative). Calls to `streamSynthesisFrom` in code under
+* test should be a compile-time error.
+*/
+const layerWithoutIncremental = (script) => {
+	const bCalls = Ref.makeUnsafe([]);
+	const ssCalls = Ref.makeUnsafe([]);
+	const ssfCalls = Ref.makeUnsafe([]);
+	return {
+		layer: Layer.effect(SpeechSynthesizer, makeService(script, {
+			synthesize: (req) => Ref.update(bCalls, (xs) => [...xs, req]),
+			streamSynthesis: (req) => Ref.update(ssCalls, (xs) => [...xs, req]),
+			streamSynthesisFrom: (req) => Ref.update(ssfCalls, (xs) => [...xs, req])
+		})),
+		recorder: Effect.gen(function* () {
+			return {
+				synthesizeCalls: yield* Ref.get(bCalls),
+				streamSynthesisCalls: yield* Ref.get(ssCalls),
+				streamSynthesisFromCalls: yield* Ref.get(ssfCalls)
+			};
+		})
+	};
+};
+//#endregion
+export { layer, layerWithoutIncremental };
+
+//# sourceMappingURL=MockSpeechSynthesizer.mjs.map

package/dist/testing/MockSpeechSynthesizer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockSpeechSynthesizer.mjs","names":["AiError.InvalidRequest"],"sources":["../../src/testing/MockSpeechSynthesizer.ts"],"sourcesContent":["import { Effect, Layer, Ref, Stream } from \"effect\"\nimport type { AudioBlob, AudioChunk } from \"../domain/Audio.js\"\nimport * as AiError from \"../domain/AiError.js\"\nimport {\n  SpeechSynthesizer,\n  TtsIncrementalText,\n  type CommonStreamSynthesizeRequest,\n  type CommonSynthesizeRequest,\n  type SpeechSynthesizerService,\n} from \"../speech-synthesizer/SpeechSynthesizer.js\"\n\nexport type MockSynthesizerRecorder = {\n  readonly synthesizeCalls: ReadonlyArray<CommonSynthesizeRequest>\n  readonly streamSynthesisCalls: ReadonlyArray<CommonSynthesizeRequest>\n  readonly streamSynthesisFromCalls: ReadonlyArray<CommonStreamSynthesizeRequest>\n}\n\nexport type MockSynthesizerScript = {\n  /** One blob per `synthesize` call, consumed in order. */\n  readonly blobs?: ReadonlyArray<AudioBlob>\n  /** One chunk-list per `streamSynthesis` call, consumed in order. */\n  readonly streamSynthesisChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>\n  /** One chunk-list per `streamSynthesisFrom` call, consumed in order. */\n  readonly streamSynthesisFromChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>\n}\n\nconst makeService = (\n  script: MockSynthesizerScript,\n  record: {\n    readonly synthesize: (req: CommonSynthesizeRequest) => Effect.Effect<void>\n    readonly streamSynthesis: (req: CommonSynthesizeRequest) => Effect.Effect<void>\n    readonly streamSynthesisFrom: (req: CommonStreamSynthesizeRequest) => Effect.Effect<void>\n  },\n) =>\n  Effect.gen(function* () {\n    const bCursor = yield* Ref.make(0)\n    const ssCursor = yield* Ref.make(0)\n    const ssfCursor = yield* Ref.make(0)\n    const service: SpeechSynthesizerService = {\n      synthesize: (request) =>\n        Effect.gen(function* () {\n          yield* record.synthesize(request)\n          const i = yield* Ref.getAndUpdate(bCursor, (n) => n + 1)\n          const scripted = script.blobs ?? []\n          if (i >= scripted.length) {\n            return yield* new AiError.InvalidRequest({\n              provider: \"mock\",\n              raw: `MockSpeechSynthesizer exhausted: ${scripted.length} blobs scripted, but call ${i + 1} was made`,\n            })\n          }\n          return scripted[i]!\n        }),\n      streamSynthesis: (request) =>\n        Stream.unwrap(\n          Effect.gen(function* () {\n            yield* record.streamSynthesis(request)\n            const i = yield* Ref.getAndUpdate(ssCursor, (n) => n + 1)\n            const scripted = script.streamSynthesisChunks ?? []\n            if (i >= scripted.length) {\n              return Stream.fail(\n                new AiError.InvalidRequest({\n                  provider: \"mock\",\n                  raw: `MockSpeechSynthesizer exhausted: ${scripted.length} streamSynthesis lists scripted, but call ${i + 1} was made`,\n                }),\n              )\n            }\n            return Stream.fromIterable(scripted[i]!)\n          }),\n        ),\n      streamSynthesisFrom: <E, R>(\n        textIn: Stream.Stream<string, E, R>,\n        request: CommonStreamSynthesizeRequest,\n      ): Stream.Stream<AudioChunk, AiError.AiError | E, R> =>\n        Stream.unwrap(\n          Effect.gen(function* () {\n            yield* record.streamSynthesisFrom(request)\n            const i = yield* Ref.getAndUpdate(ssfCursor, (n) => n + 1)\n            const scripted = script.streamSynthesisFromChunks ?? []\n            if (i >= scripted.length) {\n              const exhausted: Stream.Stream<AudioChunk, AiError.AiError | E, R> = Stream.fail(\n                new AiError.InvalidRequest({\n                  provider: \"mock\",\n                  raw: `MockSpeechSynthesizer exhausted: ${scripted.length} streamSynthesisFrom lists scripted, but call ${i + 1} was made`,\n                }),\n              )\n              return exhausted\n            }\n            // Drain the input text fully before emitting scripted audio chunks,\n            // so consumers can assert on what text was pushed.\n            return Stream.drain(textIn).pipe(Stream.concat(Stream.fromIterable(scripted[i]!)))\n          }),\n        ),\n    }\n    return service\n  })\n\n/**\n * Layer providing the `SpeechSynthesizer` service AND the\n * `TtsIncrementalText` capability marker. Use for the common case\n * where code under test exercises `streamSynthesisFrom`.\n */\nexport const layer = (\n  script: MockSynthesizerScript,\n): {\n  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText>\n  readonly recorder: Effect.Effect<MockSynthesizerRecorder>\n} => {\n  const bCalls = Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([])\n  const ssCalls = Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([])\n  const ssfCalls = Ref.makeUnsafe<ReadonlyArray<CommonStreamSynthesizeRequest>>([])\n  const synthesizerLayer = Layer.effect(\n    SpeechSynthesizer,\n    makeService(script, {\n      synthesize: (req) => Ref.update(bCalls, (xs) => [...xs, req]),\n      streamSynthesis: (req) => Ref.update(ssCalls, (xs) => [...xs, req]),\n      streamSynthesisFrom: (req) => Ref.update(ssfCalls, (xs) => [...xs, req]),\n    }),\n  )\n  const live = Layer.merge(synthesizerLayer, Layer.succeed(TtsIncrementalText, undefined))\n  return {\n    layer: live,\n    recorder: Effect.gen(function* () {\n      const synthesizeCalls = yield* Ref.get(bCalls)\n      const streamSynthesisCalls = yield* Ref.get(ssCalls)\n      const streamSynthesisFromCalls = yield* Ref.get(ssfCalls)\n      return { synthesizeCalls, streamSynthesisCalls, streamSynthesisFromCalls }\n    }),\n  }\n}\n\n/**\n * Variant that omits the `TtsIncrementalText` marker — simulates a\n * provider without incremental-text-in support (e.g. OpenAI, AWS\n * Polly non-Generative). Calls to `streamSynthesisFrom` in code under\n * test should be a compile-time error.\n */\nexport const layerWithoutIncremental = (\n  script: MockSynthesizerScript,\n): {\n  readonly layer: Layer.Layer<SpeechSynthesizer>\n  readonly recorder: Effect.Effect<MockSynthesizerRecorder>\n} => {\n  const bCalls = Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([])\n  const ssCalls = Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([])\n  const ssfCalls = Ref.makeUnsafe<ReadonlyArray<CommonStreamSynthesizeRequest>>([])\n  const live = Layer.effect(\n    SpeechSynthesizer,\n    makeService(script, {\n      synthesize: (req) => Ref.update(bCalls, (xs) => [...xs, req]),\n      streamSynthesis: (req) => Ref.update(ssCalls, (xs) => [...xs, req]),\n      streamSynthesisFrom: (req) => Ref.update(ssfCalls, (xs) => [...xs, req]),\n    }),\n  )\n  return {\n    layer: live,\n    recorder: Effect.gen(function* () {\n      const synthesizeCalls = yield* Ref.get(bCalls)\n      const streamSynthesisCalls = yield* Ref.get(ssCalls)\n      const streamSynthesisFromCalls = yield* Ref.get(ssfCalls)\n      return { synthesizeCalls, streamSynthesisCalls, streamSynthesisFromCalls }\n    }),\n  }\n}\n"],"mappings":"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"}

package/dist/testing/MockTranscriber.d.mts

@@ -0,0 +1,37 @@
+import { TranscriptEvent, TranscriptResult } from "../domain/Transcript.mjs";
+import { CommonStreamTranscribeRequest, CommonTranscribeRequest, SttStreaming, Transcriber } from "../transcriber/Transcriber.mjs";
+import { Effect, Layer } from "effect";
+
+//#region src/testing/MockTranscriber.d.ts
+/**
+ * Recorder of every call made to the mock.
+ */
+type MockTranscriberRecorder = {
+  readonly transcribeCalls: ReadonlyArray<CommonTranscribeRequest>;
+  readonly streamCalls: ReadonlyArray<CommonStreamTranscribeRequest>;
+};
+type MockTranscriberScript = {
+  /** One result per `transcribe` call, consumed in order. */readonly transcripts?: ReadonlyArray<TranscriptResult>; /** One event-list per `streamTranscriptionFrom` call, consumed in order. */
+  readonly streams?: ReadonlyArray<ReadonlyArray<TranscriptEvent>>;
+};
+/**
+ * Returns a Layer that provides both the `Transcriber` service and the
+ * `SttStreaming` capability marker. Use when the code under test calls
+ * `streamTranscriptionFrom`.
+ */
+declare const layer: (script: MockTranscriberScript) => {
+  readonly layer: Layer.Layer<Transcriber | SttStreaming>;
+  readonly recorder: Effect.Effect<MockTranscriberRecorder>;
+};
+/**
+ * Variant that omits the `SttStreaming` marker — use to test that
+ * consumers calling `streamTranscriptionFrom` fail to compile against
+ * a non-streaming provider.
+ */
+declare const layerSyncOnly: (script: MockTranscriberScript) => {
+  readonly layer: Layer.Layer<Transcriber>;
+  readonly recorder: Effect.Effect<MockTranscriberRecorder>;
+};
+//#endregion
+export { MockTranscriberRecorder, MockTranscriberScript, layer, layerSyncOnly };
+//# sourceMappingURL=MockTranscriber.d.mts.map

package/dist/testing/MockTranscriber.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockTranscriber.d.mts","names":[],"sources":["../../src/testing/MockTranscriber.ts"],"mappings":";;;;;;;AAcA;KAAY,uBAAA;EAAA,SACD,eAAA,EAAiB,aAAA,CAAc,uBAAA;EAAA,SAC/B,WAAA,EAAa,aAAA,CAAc,6BAAA;AAAA;AAAA,KAG1B,qBAAA;EAHY,oEAKb,WAAA,GAAc,aAAA,CAAc,gBAAA,GALF;EAAA,SAO1B,OAAA,GAAU,aAAA,CAAc,aAAA,CAAc,eAAA;AAAA;;;;;;cA2DpC,KAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,WAAA,GAAc,YAAA;EAAA,SACjC,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA;;;;;;cA2BtB,aAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,WAAA;EAAA,SACnB,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA"}

package/dist/testing/MockTranscriber.mjs

@@ -0,0 +1,77 @@
+import { InvalidRequest } from "../domain/AiError.mjs";
+import { SttStreaming, Transcriber } from "../transcriber/Transcriber.mjs";
+import { Effect, Layer, Ref, Stream } from "effect";
+//#region src/testing/MockTranscriber.ts
+const makeService = (script, record) => Effect.gen(function* () {
+	const tCursor = yield* Ref.make(0);
+	const sCursor = yield* Ref.make(0);
+	return {
+		transcribe: (request) => Effect.gen(function* () {
+			yield* record.transcribe(request);
+			const i = yield* Ref.getAndUpdate(tCursor, (n) => n + 1);
+			const scripted = script.transcripts ?? [];
+			if (i >= scripted.length) return yield* new InvalidRequest({
+				provider: "mock",
+				raw: `MockTranscriber exhausted: ${scripted.length} transcripts scripted, but call ${i + 1} was made`
+			});
+			return scripted[i];
+		}),
+		streamTranscriptionFrom: (audioIn, request) => Stream.unwrap(Effect.gen(function* () {
+			yield* record.stream(request);
+			const i = yield* Ref.getAndUpdate(sCursor, (n) => n + 1);
+			const scripted = script.streams ?? [];
+			if (i >= scripted.length) return Stream.fail(new InvalidRequest({
+				provider: "mock",
+				raw: `MockTranscriber exhausted: ${scripted.length} streams scripted, but call ${i + 1} was made`
+			}));
+			return Stream.drain(audioIn).pipe(Stream.concat(Stream.fromIterable(scripted[i])));
+		}))
+	};
+});
+/**
+* Returns a Layer that provides both the `Transcriber` service and the
+* `SttStreaming` capability marker. Use when the code under test calls
+* `streamTranscriptionFrom`.
+*/
+const layer = (script) => {
+	const tCalls = Ref.makeUnsafe([]);
+	const sCalls = Ref.makeUnsafe([]);
+	const transcriberLayer = Layer.effect(Transcriber, makeService(script, {
+		transcribe: (req) => Ref.update(tCalls, (xs) => [...xs, req]),
+		stream: (req) => Ref.update(sCalls, (xs) => [...xs, req])
+	}));
+	return {
+		layer: Layer.merge(transcriberLayer, Layer.succeed(SttStreaming, void 0)),
+		recorder: Effect.gen(function* () {
+			return {
+				transcribeCalls: yield* Ref.get(tCalls),
+				streamCalls: yield* Ref.get(sCalls)
+			};
+		})
+	};
+};
+/**
+* Variant that omits the `SttStreaming` marker — use to test that
+* consumers calling `streamTranscriptionFrom` fail to compile against
+* a non-streaming provider.
+*/
+const layerSyncOnly = (script) => {
+	const tCalls = Ref.makeUnsafe([]);
+	const sCalls = Ref.makeUnsafe([]);
+	return {
+		layer: Layer.effect(Transcriber, makeService(script, {
+			transcribe: (req) => Ref.update(tCalls, (xs) => [...xs, req]),
+			stream: (req) => Ref.update(sCalls, (xs) => [...xs, req])
+		})),
+		recorder: Effect.gen(function* () {
+			return {
+				transcribeCalls: yield* Ref.get(tCalls),
+				streamCalls: yield* Ref.get(sCalls)
+			};
+		})
+	};
+};
+//#endregion
+export { layer, layerSyncOnly };
+
+//# sourceMappingURL=MockTranscriber.mjs.map

package/dist/testing/MockTranscriber.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockTranscriber.mjs","names":["AiError.InvalidRequest"],"sources":["../../src/testing/MockTranscriber.ts"],"sourcesContent":["import { Effect, Layer, Ref, Stream } from \"effect\"\nimport * as AiError from \"../domain/AiError.js\"\nimport type { TranscriptEvent, TranscriptResult } from \"../domain/Transcript.js\"\nimport {\n  SttStreaming,\n  Transcriber,\n  type CommonStreamTranscribeRequest,\n  type CommonTranscribeRequest,\n  type TranscriberService,\n} from \"../transcriber/Transcriber.js\"\n\n/**\n * Recorder of every call made to the mock.\n */\nexport type MockTranscriberRecorder = {\n  readonly transcribeCalls: ReadonlyArray<CommonTranscribeRequest>\n  readonly streamCalls: ReadonlyArray<CommonStreamTranscribeRequest>\n}\n\nexport type MockTranscriberScript = {\n  /** One result per `transcribe` call, consumed in order. */\n  readonly transcripts?: ReadonlyArray<TranscriptResult>\n  /** One event-list per `streamTranscriptionFrom` call, consumed in order. */\n  readonly streams?: ReadonlyArray<ReadonlyArray<TranscriptEvent>>\n}\n\nconst makeService = (\n  script: MockTranscriberScript,\n  record: {\n    readonly transcribe: (req: CommonTranscribeRequest) => Effect.Effect<void>\n    readonly stream: (req: CommonStreamTranscribeRequest) => Effect.Effect<void>\n  },\n) =>\n  Effect.gen(function* () {\n    const tCursor = yield* Ref.make(0)\n    const sCursor = yield* Ref.make(0)\n    const service: TranscriberService = {\n      transcribe: (request) =>\n        Effect.gen(function* () {\n          yield* record.transcribe(request)\n          const i = yield* Ref.getAndUpdate(tCursor, (n) => n + 1)\n          const scripted = script.transcripts ?? []\n          if (i >= scripted.length) {\n            return yield* new AiError.InvalidRequest({\n              provider: \"mock\",\n              raw: `MockTranscriber exhausted: ${scripted.length} transcripts scripted, but call ${i + 1} was made`,\n            })\n          }\n          return scripted[i]!\n        }),\n      streamTranscriptionFrom: <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* record.stream(request)\n            const i = yield* Ref.getAndUpdate(sCursor, (n) => n + 1)\n            const scripted = script.streams ?? []\n            if (i >= scripted.length) {\n              const exhausted: Stream.Stream<TranscriptEvent, AiError.AiError | E, R> = Stream.fail(\n                new AiError.InvalidRequest({\n                  provider: \"mock\",\n                  raw: `MockTranscriber exhausted: ${scripted.length} streams scripted, but call ${i + 1} was made`,\n                }),\n              )\n              return exhausted\n            }\n            // Drain the input audio fully before emitting the scripted events,\n            // so consumers can assert on what bytes were pushed.\n            return Stream.drain(audioIn).pipe(Stream.concat(Stream.fromIterable(scripted[i]!)))\n          }),\n        ),\n    }\n    return service\n  })\n\n/**\n * Returns a Layer that provides both the `Transcriber` service and the\n * `SttStreaming` capability marker. Use when the code under test calls\n * `streamTranscriptionFrom`.\n */\nexport const layer = (\n  script: MockTranscriberScript,\n): {\n  readonly layer: Layer.Layer<Transcriber | SttStreaming>\n  readonly recorder: Effect.Effect<MockTranscriberRecorder>\n} => {\n  const tCalls = Ref.makeUnsafe<ReadonlyArray<CommonTranscribeRequest>>([])\n  const sCalls = Ref.makeUnsafe<ReadonlyArray<CommonStreamTranscribeRequest>>([])\n  const transcriberLayer = Layer.effect(\n    Transcriber,\n    makeService(script, {\n      transcribe: (req) => Ref.update(tCalls, (xs) => [...xs, req]),\n      stream: (req) => Ref.update(sCalls, (xs) => [...xs, req]),\n    }),\n  )\n  const live = Layer.merge(transcriberLayer, Layer.succeed(SttStreaming, undefined))\n  return {\n    layer: live,\n    recorder: Effect.gen(function* () {\n      const transcribeCalls = yield* Ref.get(tCalls)\n      const streamCalls = yield* Ref.get(sCalls)\n      return { transcribeCalls, streamCalls }\n    }),\n  }\n}\n\n/**\n * Variant that omits the `SttStreaming` marker — use to test that\n * consumers calling `streamTranscriptionFrom` fail to compile against\n * a non-streaming provider.\n */\nexport const layerSyncOnly = (\n  script: MockTranscriberScript,\n): {\n  readonly layer: Layer.Layer<Transcriber>\n  readonly recorder: Effect.Effect<MockTranscriberRecorder>\n} => {\n  const tCalls = Ref.makeUnsafe<ReadonlyArray<CommonTranscribeRequest>>([])\n  const sCalls = Ref.makeUnsafe<ReadonlyArray<CommonStreamTranscribeRequest>>([])\n  const live = Layer.effect(\n    Transcriber,\n    makeService(script, {\n      transcribe: (req) => Ref.update(tCalls, (xs) => [...xs, req]),\n      stream: (req) => Ref.update(sCalls, (xs) => [...xs, req]),\n    }),\n  )\n  return {\n    layer: live,\n    recorder: Effect.gen(function* () {\n      const transcribeCalls = yield* Ref.get(tCalls)\n      const streamCalls = yield* Ref.get(sCalls)\n      return { transcribeCalls, streamCalls }\n    }),\n  }\n}\n"],"mappings":";;;;AA0BA,MAAM,eACJ,QACA,WAKA,OAAO,IAAI,aAAa;CACtB,MAAM,UAAU,OAAO,IAAI,KAAK,EAAE;CAClC,MAAM,UAAU,OAAO,IAAI,KAAK,EAAE;AAuClC,QAAO;EArCL,aAAa,YACX,OAAO,IAAI,aAAa;AACtB,UAAO,OAAO,WAAW,QAAQ;GACjC,MAAM,IAAI,OAAO,IAAI,aAAa,UAAU,MAAM,IAAI,EAAE;GACxD,MAAM,WAAW,OAAO,eAAe,EAAE;AACzC,OAAI,KAAK,SAAS,OAChB,QAAO,OAAO,IAAIA,eAAuB;IACvC,UAAU;IACV,KAAK,8BAA8B,SAAS,OAAO,kCAAkC,IAAI,EAAE;IAC5F,CAAC;AAEJ,UAAO,SAAS;IAChB;EACJ,0BACE,SACA,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;AACtB,UAAO,OAAO,OAAO,QAAQ;GAC7B,MAAM,IAAI,OAAO,IAAI,aAAa,UAAU,MAAM,IAAI,EAAE;GACxD,MAAM,WAAW,OAAO,WAAW,EAAE;AACrC,OAAI,KAAK,SAAS,OAOhB,QAN0E,OAAO,KAC/E,IAAIA,eAAuB;IACzB,UAAU;IACV,KAAK,8BAA8B,SAAS,OAAO,8BAA8B,IAAI,EAAE;IACxF,CAAC,CAEY;AAIlB,UAAO,OAAO,MAAM,QAAQ,CAAC,KAAK,OAAO,OAAO,OAAO,aAAa,SAAS,GAAI,CAAC,CAAC;IACnF,CACH;EAES;EACd;;;;;;AAOJ,MAAa,SACX,WAIG;CACH,MAAM,SAAS,IAAI,WAAmD,EAAE,CAAC;CACzE,MAAM,SAAS,IAAI,WAAyD,EAAE,CAAC;CAC/E,MAAM,mBAAmB,MAAM,OAC7B,aACA,YAAY,QAAQ;EAClB,aAAa,QAAQ,IAAI,OAAO,SAAS,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;EAC7D,SAAS,QAAQ,IAAI,OAAO,SAAS,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;EAC1D,CAAC,CACH;AAED,QAAO;EACL,OAFW,MAAM,MAAM,kBAAkB,MAAM,QAAQ,cAAc,KAAA,EAAU,CAEpE;EACX,UAAU,OAAO,IAAI,aAAa;AAGhC,UAAO;IAAE,iBAAA,OAFsB,IAAI,IAAI,OAAO;IAEpB,aAAA,OADC,IAAI,IAAI,OAAO;IACH;IACvC;EACH;;;;;;;AAQH,MAAa,iBACX,WAIG;CACH,MAAM,SAAS,IAAI,WAAmD,EAAE,CAAC;CACzE,MAAM,SAAS,IAAI,WAAyD,EAAE,CAAC;AAQ/E,QAAO;EACL,OARW,MAAM,OACjB,aACA,YAAY,QAAQ;GAClB,aAAa,QAAQ,IAAI,OAAO,SAAS,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;GAC7D,SAAS,QAAQ,IAAI,OAAO,SAAS,OAAO,CAAC,GAAG,IAAI,IAAI,CAAC;GAC1D,CAAC,CAGS;EACX,UAAU,OAAO,IAAI,aAAa;AAGhC,UAAO;IAAE,iBAAA,OAFsB,IAAI,IAAI,OAAO;IAEpB,aAAA,OADC,IAAI,IAAI,OAAO;IACH;IACvC;EACH"}

package/dist/tool/HistoryCheck.d.mts

@@ -1,4 +1,4 @@
-import { d as Item, o as FunctionCall } from "../Items-CB8Bo3FI.mjs";
+import { d as Item, o as FunctionCall } from "../Items-DqbaJoz7.mjs";
 import { ToolResult } from "./Outcome.mjs";
 
 //#region src/tool/HistoryCheck.d.ts

package/dist/tool/Outcome.d.mts

@@ -1,4 +1,4 @@
-import { o as FunctionCall, s as FunctionCallOutput } from "../Items-CB8Bo3FI.mjs";
+import { o as FunctionCall, s as FunctionCallOutput } from "../Items-DqbaJoz7.mjs";
 import { Data } from "effect";
 import * as _$effect_Unify0 from "effect/Unify";
 

package/dist/tool/Resolvers.d.mts

@@ -1,7 +1,8 @@
-import { o as FunctionCall } from "../Items-CB8Bo3FI.mjs";
+import { o as FunctionCall } from "../Items-DqbaJoz7.mjs";
 import { ToolResult } from "./Outcome.mjs";
 import { ToolEvent } from "./ToolEvent.mjs";
-import { Effect, Queue, Scope, Stream } from "effect";
+import { Data, Effect, Queue, Scope, Stream } from "effect";
+import * as _$effect_Unify0 from "effect/Unify";
 
 //#region src/tool/Resolvers.d.ts
 declare namespace Resolvers_d_exports {
@@ -11,12 +12,68 @@ type ToolCallPlan = {
   readonly approved: ReadonlyArray<FunctionCall>;
   readonly rejected: ReadonlyArray<ToolResult>;
 };
-type ToolCallDecision = {
-  readonly _tag: "Approved";
-  readonly call: FunctionCall;
-} | {
-  readonly _tag: "Rejected";
-  readonly result: ToolResult;
+type ToolCallDecision = Data.TaggedEnum<{
+  Approved: {
+    readonly call: FunctionCall;
+  };
+  Rejected: {
+    readonly result: ToolResult;
+  };
+}>;
+declare const ToolCallDecision: {
+  readonly Approved: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Approved";
+    readonly call: FunctionCall;
+  }, "_tag">;
+  readonly Rejected: Data.TaggedEnum.ConstructorFrom<{
+    readonly _tag: "Rejected";
+    readonly result: ToolResult;
+  }, "_tag">;
+  readonly $is: <Tag extends "Approved" | "Rejected">(tag: Tag) => (u: unknown) => u is Extract<{
+    readonly _tag: "Approved";
+    readonly call: FunctionCall;
+  }, {
+    readonly _tag: Tag;
+  }> | Extract<{
+    readonly _tag: "Rejected";
+    readonly result: ToolResult;
+  }, {
+    readonly _tag: Tag;
+  }>;
+  readonly $match: {
+    <Cases extends {
+      readonly Approved: (args: {
+        readonly _tag: "Approved";
+        readonly call: FunctionCall;
+      }) => any;
+      readonly Rejected: (args: {
+        readonly _tag: "Rejected";
+        readonly result: ToolResult;
+      }) => any;
+    }>(cases: Cases): (value: {
+      readonly _tag: "Approved";
+      readonly call: FunctionCall;
+    } | {
+      readonly _tag: "Rejected";
+      readonly result: ToolResult;
+    }) => _$effect_Unify0.Unify<ReturnType<Cases["Approved" | "Rejected"]>>;
+    <Cases extends {
+      readonly Approved: (args: {
+        readonly _tag: "Approved";
+        readonly call: FunctionCall;
+      }) => any;
+      readonly Rejected: (args: {
+        readonly _tag: "Rejected";
+        readonly result: ToolResult;
+      }) => any;
+    }>(value: {
+      readonly _tag: "Approved";
+      readonly call: FunctionCall;
+    } | {
+      readonly _tag: "Rejected";
+      readonly result: ToolResult;
+    }, cases: Cases): _$effect_Unify0.Unify<ReturnType<Cases["Approved" | "Rejected"]>>;
+  };
 };
 declare const approve: (call: FunctionCall) => ToolCallDecision;
 declare const reject: (result: ToolResult) => ToolCallDecision;

package/dist/tool/Resolvers.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Resolvers.d.mts","names":[],"sources":["../../src/tool/Resolvers.ts"],"mappings":";;;;;;;;;KAYY,YAAA;EAAA,SACD,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,QAAA,EAAU,aAAA,CAAc,UAAA;AAAA;AAAA,KAGvB,gBAAA;EAAA,SACG,IAAA;EAAA,SAA2B,IAAA,EAAM,YAAA;AAAA;EAAA,SACjC,IAAA;EAAA,SAA2B,MAAA,EAAQ,UAAA;AAAA;AAAA,cAErC,OAAA,GAAW,IAAA,EAAM,YAAA,KAAe,gBAAA;AAAA,cAKhC,MAAA,GAAU,MAAA,EAAQ,UAAA,KAAa,gBAAA;AAAA,cAK/B,sBAAA,GAA0B,SAAA,EAAW,aAAA,CAAc,gBAAA,MAAoB,YAAA;AAAA,cASvE,iBAAA,GAAqB,IAAA,EAAM,YAAA,KAAe,SAAA;AAAA,KAW3C,OAAA;EAAA,SACD,OAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;;;cAQE,gBAAA,GACV,SAAA,GAAY,IAAA,EAAM,YAAA,cAA0B,QAAA,EAAU,KAAA,CAAM,OAAA,CAAQ,OAAA,OAEnE,KAAA,EAAO,aAAA,CAAc,YAAA,MACpB,MAAA,CAAO,MAAA;EAAA,SAEG,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,SAAA,EAAW,MAAA,CAAO,MAAA,CAAO,gBAAA;EAAA,SACzB,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,SAAA;AAAA,UAGnC,KAAA,CAAM,KAAA;AAAA,KAkDE,gBAAA;EAAA,SACG,QAAA;AAAA;EAAA,SACA,QAAA;EAAA,SAA2B,MAAA;AAAA;AAAA,cAE7B,eAAA,GACV,SAAA,GAAY,IAAA,EAAM,YAAA,cAA0B,SAAA,EAAW,WAAA,SAAoB,gBAAA,OAC3E,KAAA,EAAO,aAAA,CAAc,YAAA,MAAgB,YAAA"}
+{"version":3,"file":"Resolvers.d.mts","names":[],"sources":["../../src/tool/Resolvers.ts"],"mappings":";;;;;;;;;;KAYY,YAAA;EAAA,SACD,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,QAAA,EAAU,aAAA,CAAc,UAAA;AAAA;AAAA,KAGvB,gBAAA,GAAmB,IAAA,CAAK,UAAA;EAClC,QAAA;IAAA,SAAqB,IAAA,EAAM,YAAA;EAAA;EAC3B,QAAA;IAAA,SAAqB,MAAA,EAAQ,UAAA;EAAA;AAAA;AAAA,cAGlB,gBAAA;EAAA;;mBAJgB,YAAA;EAAA;EAAA;;qBACE,UAAA;EAAA;EAAA;;mBADF,YAAA;EAAA;IAAA;;;qBACE,UAAA;EAAA;IAAA;;;;;;uBADF,YAAA;MAAA;MAAA;;yBACE,UAAA;MAAA;IAAA;;qBADF,YAAA;IAAA;MAAA;uBACE,UAAA;IAAA;;;;uBADF,YAAA;MAAA;MAAA;;yBACE,UAAA;MAAA;IAAA;;qBADF,YAAA;IAAA;MAAA;uBACE,UAAA;IAAA;;;cAKlB,OAAA,GAAW,IAAA,EAAM,YAAA,KAAe,gBAAA;AAAA,cAEhC,MAAA,GAAU,MAAA,EAAQ,UAAA,KAAa,gBAAA;AAAA,cAG/B,sBAAA,GAA0B,SAAA,EAAW,aAAA,CAAc,gBAAA,MAAoB,YAAA;AAAA,cASvE,iBAAA,GAAqB,IAAA,EAAM,YAAA,KAAe,SAAA;AAAA,KAW3C,OAAA;EAAA,SACD,OAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;;;cAQE,gBAAA,GACV,SAAA,GAAY,IAAA,EAAM,YAAA,cAA0B,QAAA,EAAU,KAAA,CAAM,OAAA,CAAQ,OAAA,OAEnE,KAAA,EAAO,aAAA,CAAc,YAAA,MACpB,MAAA,CAAO,MAAA;EAAA,SAEG,QAAA,EAAU,aAAA,CAAc,YAAA;EAAA,SACxB,SAAA,EAAW,MAAA,CAAO,MAAA,CAAO,gBAAA;EAAA,SACzB,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,SAAA;AAAA,UAGnC,KAAA,CAAM,KAAA;AAAA,KAkDE,gBAAA;EAAA,SACG,QAAA;AAAA;EAAA,SACA,QAAA;EAAA,SAA2B,MAAA;AAAA;AAAA,cAE7B,eAAA,GACV,SAAA,GAAY,IAAA,EAAM,YAAA,cAA0B,SAAA,EAAW,WAAA,SAAoB,gBAAA,OAC3E,KAAA,EAAO,aAAA,CAAc,YAAA,MAAgB,YAAA"}

package/dist/tool/Resolvers.mjs

@@ -1,6 +1,7 @@
 import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
 import { cancelled, denied } from "./Outcome.mjs";
-import { Deferred, Effect, Queue, Stream } from "effect";
+import { ToolEvent } from "./ToolEvent.mjs";
+import { Data, Deferred, Effect, Queue, Stream } from "effect";
 //#region src/tool/Resolvers.ts
 /**
 * Approval helpers for the two transport flavors.
@@ -10,6 +11,7 @@ import { Deferred, Effect, Queue, Stream } from "effect";
 * the recipe boundary via `Toolkit.executeAll`.
 */
 var Resolvers_exports = /* @__PURE__ */ __exportAll({
+	ToolCallDecision: () => ToolCallDecision,
 	approvalRequested: () => approvalRequested,
 	approve: () => approve,
 	fromApprovalMap: () => fromApprovalMap,
@@ -17,14 +19,9 @@ var Resolvers_exports = /* @__PURE__ */ __exportAll({
 	reject: () => reject,
 	splitToolCallDecisions: () => splitToolCallDecisions
 });
-const approve = (call) => ({
-	_tag: "Approved",
-	call
-});
-const reject = (result) => ({
-	_tag: "Rejected",
-	result
-});
+const ToolCallDecision = Data.taggedEnum();
+const approve = (call) => ToolCallDecision.Approved({ call });
+const reject = (result) => ToolCallDecision.Rejected({ result });
 const splitToolCallDecisions = (decisions) => decisions.reduce((acc, decision) => decision._tag === "Approved" ? {
 	...acc,
 	approved: [...acc.approved, decision.call]
@@ -35,8 +32,7 @@ const splitToolCallDecisions = (decisions) => decisions.reduce((acc, decision) =
 	approved: [],
 	rejected: []
 });
-const approvalRequested = (call) => ({
-	_tag: "ApprovalRequested",
+const approvalRequested = (call) => ToolEvent.ApprovalRequested({
 	call_id: call.call_id,
 	tool: call.name,
 	arguments: call.arguments
@@ -72,6 +68,6 @@ const fromApprovalMap = (predicate, approvals) => (calls) => splitToolCallDecisi
 	return v.decision === "approve" ? approve(call) : reject(denied(call, v.reason));
 }));
 //#endregion
-export { approvalRequested, approve, fromApprovalMap, fromVerdictQueue, reject, splitToolCallDecisions, Resolvers_exports as t };
+export { ToolCallDecision, approvalRequested, approve, fromApprovalMap, fromVerdictQueue, reject, splitToolCallDecisions, Resolvers_exports as t };
 
 //# sourceMappingURL=Resolvers.mjs.map

package/dist/tool/Resolvers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Resolvers.mjs","names":[],"sources":["../../src/tool/Resolvers.ts"],"sourcesContent":["/**\n * Approval helpers for the two transport flavors.\n *\n * These helpers only decide which calls are approved and which synthetic\n * results must be returned to the model. Tool execution stays explicit at\n * the recipe boundary via `Toolkit.executeAll`.\n */\nimport { Deferred, Effect, Queue, Scope, Stream } from \"effect\"\nimport type { FunctionCall } from \"../domain/Items.js\"\nimport { type ToolResult, cancelled, denied } from \"./Outcome.js\"\nimport type { ToolEvent } from \"./ToolEvent.js\"\n\nexport type ToolCallPlan = {\n  readonly approved: ReadonlyArray<FunctionCall>\n  readonly rejected: ReadonlyArray<ToolResult>\n}\n\nexport type ToolCallDecision =\n  | { readonly _tag: \"Approved\"; readonly call: FunctionCall }\n  | { readonly _tag: \"Rejected\"; readonly result: ToolResult }\n\nexport const approve = (call: FunctionCall): ToolCallDecision => ({\n  _tag: \"Approved\",\n  call,\n})\n\nexport const reject = (result: ToolResult): ToolCallDecision => ({\n  _tag: \"Rejected\",\n  result,\n})\n\nexport const splitToolCallDecisions = (decisions: ReadonlyArray<ToolCallDecision>): ToolCallPlan =>\n  decisions.reduce<ToolCallPlan>(\n    (acc, decision) =>\n      decision._tag === \"Approved\"\n        ? { ...acc, approved: [...acc.approved, decision.call] }\n        : { ...acc, rejected: [...acc.rejected, decision.result] },\n    { approved: [], rejected: [] },\n  )\n\nexport const approvalRequested = (call: FunctionCall): ToolEvent => ({\n  _tag: \"ApprovalRequested\",\n  call_id: call.call_id,\n  tool: call.name,\n  arguments: call.arguments,\n})\n\n// ---------------------------------------------------------------------------\n// Verdict queue (WebSocket-style transport).\n// ---------------------------------------------------------------------------\n\nexport type Verdict = {\n  readonly call_id: string\n  readonly decision: \"approve\" | \"deny\"\n  readonly reason?: string\n}\n\n/**\n * Queue-backed approval planner. Safe calls are returned immediately in\n * `approved`; gated calls emit `ApprovalRequested` events and later produce\n * one `ToolCallDecision` when their matching verdict arrives.\n */\nexport const fromVerdictQueue =\n  (predicate: (call: FunctionCall) => boolean, verdicts: Queue.Dequeue<Verdict>) =>\n  (\n    calls: ReadonlyArray<FunctionCall>,\n  ): Effect.Effect<\n    {\n      readonly approved: ReadonlyArray<FunctionCall>\n      readonly decisions: Stream.Stream<ToolCallDecision>\n      readonly announce: Stream.Stream<ToolEvent>\n    },\n    never,\n    Scope.Scope\n  > =>\n    Effect.gen(function* () {\n      const gated = calls.filter(predicate)\n      const approved = calls.filter((call) => !predicate(call))\n\n      const entries = yield* Effect.forEach(gated, (call) =>\n        Deferred.make<Verdict>().pipe(Effect.map((d) => [call.call_id, d] as const)),\n      )\n      const deferreds: ReadonlyMap<string, Deferred.Deferred<Verdict>> = new Map(entries)\n\n      // Router is forked into the surrounding Scope so it lives as long\n      // as the consumer is pulling events. Recipes typically supply the\n      // scope by wrapping the events construction in `Stream.unwrap`.\n      yield* Effect.forkScoped(\n        Effect.forever(\n          Effect.gen(function* () {\n            const v = yield* Queue.take(verdicts)\n            const d = deferreds.get(v.call_id)\n            if (d !== undefined) yield* Deferred.succeed(d, v)\n          }),\n        ),\n      )\n\n      const decisions = Stream.fromIterable(gated).pipe(\n        Stream.flatMap(\n          (call) => {\n            const d = deferreds.get(call.call_id)!\n            return Stream.fromEffect(\n              Deferred.await(d).pipe(\n                Effect.map((v) =>\n                  v.decision === \"approve\" ? approve(call) : reject(denied(call, v.reason)),\n                ),\n              ),\n            )\n          },\n          { concurrency: \"unbounded\" },\n        ),\n      )\n\n      const announce = Stream.fromIterable<ToolEvent>(gated.map(approvalRequested))\n\n      return { approved, decisions, announce }\n    })\n\n// ---------------------------------------------------------------------------\n// Approval map (HTTP-style transport). Verdicts arrive synchronously\n// bundled in the request payload. Missing entries → cancelled.\n// ---------------------------------------------------------------------------\n\nexport type ApprovalMapEntry =\n  | { readonly decision: \"approve\" }\n  | { readonly decision: \"deny\"; readonly reason?: string }\n\nexport const fromApprovalMap =\n  (predicate: (call: FunctionCall) => boolean, approvals: ReadonlyMap<string, ApprovalMapEntry>) =>\n  (calls: ReadonlyArray<FunctionCall>): ToolCallPlan =>\n    splitToolCallDecisions(\n      calls.map((call) => {\n        if (!predicate(call)) return approve(call)\n        const v = approvals.get(call.call_id)\n        if (v === undefined) return reject(cancelled(call))\n        return v.decision === \"approve\" ? approve(call) : reject(denied(call, v.reason))\n      }),\n    )\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,WAAW,UAA0C;CAChE,MAAM;CACN;CACD;AAED,MAAa,UAAU,YAA0C;CAC/D,MAAM;CACN;CACD;AAED,MAAa,0BAA0B,cACrC,UAAU,QACP,KAAK,aACJ,SAAS,SAAS,aACd;CAAE,GAAG;CAAK,UAAU,CAAC,GAAG,IAAI,UAAU,SAAS,KAAK;CAAE,GACtD;CAAE,GAAG;CAAK,UAAU,CAAC,GAAG,IAAI,UAAU,SAAS,OAAO;CAAE,EAC9D;CAAE,UAAU,EAAE;CAAE,UAAU,EAAE;CAAE,CAC/B;AAEH,MAAa,qBAAqB,UAAmC;CACnE,MAAM;CACN,SAAS,KAAK;CACd,MAAM,KAAK;CACX,WAAW,KAAK;CACjB;;;;;;AAiBD,MAAa,oBACV,WAA4C,cAE3C,UAUA,OAAO,IAAI,aAAa;CACtB,MAAM,QAAQ,MAAM,OAAO,UAAU;CACrC,MAAM,WAAW,MAAM,QAAQ,SAAS,CAAC,UAAU,KAAK,CAAC;CAEzD,MAAM,UAAU,OAAO,OAAO,QAAQ,QAAQ,SAC5C,SAAS,MAAe,CAAC,KAAK,OAAO,KAAK,MAAM,CAAC,KAAK,SAAS,EAAE,CAAU,CAAC,CAC7E;CACD,MAAM,YAA6D,IAAI,IAAI,QAAQ;AAKnF,QAAO,OAAO,WACZ,OAAO,QACL,OAAO,IAAI,aAAa;EACtB,MAAM,IAAI,OAAO,MAAM,KAAK,SAAS;EACrC,MAAM,IAAI,UAAU,IAAI,EAAE,QAAQ;AAClC,MAAI,MAAM,KAAA,EAAW,QAAO,SAAS,QAAQ,GAAG,EAAE;GAClD,CACH,CACF;AAoBD,QAAO;EAAE;EAAU,WAlBD,OAAO,aAAa,MAAM,CAAC,KAC3C,OAAO,SACJ,SAAS;GACR,MAAM,IAAI,UAAU,IAAI,KAAK,QAAQ;AACrC,UAAO,OAAO,WACZ,SAAS,MAAM,EAAE,CAAC,KAChB,OAAO,KAAK,MACV,EAAE,aAAa,YAAY,QAAQ,KAAK,GAAG,OAAO,OAAO,MAAM,EAAE,OAAO,CAAC,CAC1E,CACF,CACF;KAEH,EAAE,aAAa,aAAa,CAC7B,CAKyB;EAAE,UAFb,OAAO,aAAwB,MAAM,IAAI,kBAAkB,CAEtC;EAAE;EACxC;AAWN,MAAa,mBACV,WAA4C,eAC5C,UACC,uBACE,MAAM,KAAK,SAAS;AAClB,KAAI,CAAC,UAAU,KAAK,CAAE,QAAO,QAAQ,KAAK;CAC1C,MAAM,IAAI,UAAU,IAAI,KAAK,QAAQ;AACrC,KAAI,MAAM,KAAA,EAAW,QAAO,OAAO,UAAU,KAAK,CAAC;AACnD,QAAO,EAAE,aAAa,YAAY,QAAQ,KAAK,GAAG,OAAO,OAAO,MAAM,EAAE,OAAO,CAAC;EAChF,CACH"}
+{"version":3,"file":"Resolvers.mjs","names":[],"sources":["../../src/tool/Resolvers.ts"],"sourcesContent":["/**\n * Approval helpers for the two transport flavors.\n *\n * These helpers only decide which calls are approved and which synthetic\n * results must be returned to the model. Tool execution stays explicit at\n * the recipe boundary via `Toolkit.executeAll`.\n */\nimport { Data, Deferred, Effect, Queue, Scope, Stream } from \"effect\"\nimport type { FunctionCall } from \"../domain/Items.js\"\nimport { type ToolResult, cancelled, denied } from \"./Outcome.js\"\nimport { ToolEvent } from \"./ToolEvent.js\"\n\nexport type ToolCallPlan = {\n  readonly approved: ReadonlyArray<FunctionCall>\n  readonly rejected: ReadonlyArray<ToolResult>\n}\n\nexport type ToolCallDecision = Data.TaggedEnum<{\n  Approved: { readonly call: FunctionCall }\n  Rejected: { readonly result: ToolResult }\n}>\n\nexport const ToolCallDecision = Data.taggedEnum<ToolCallDecision>()\n\nexport const approve = (call: FunctionCall): ToolCallDecision => ToolCallDecision.Approved({ call })\n\nexport const reject = (result: ToolResult): ToolCallDecision =>\n  ToolCallDecision.Rejected({ result })\n\nexport const splitToolCallDecisions = (decisions: ReadonlyArray<ToolCallDecision>): ToolCallPlan =>\n  decisions.reduce<ToolCallPlan>(\n    (acc, decision) =>\n      decision._tag === \"Approved\"\n        ? { ...acc, approved: [...acc.approved, decision.call] }\n        : { ...acc, rejected: [...acc.rejected, decision.result] },\n    { approved: [], rejected: [] },\n  )\n\nexport const approvalRequested = (call: FunctionCall): ToolEvent =>\n  ToolEvent.ApprovalRequested({\n    call_id: call.call_id,\n    tool: call.name,\n    arguments: call.arguments,\n  })\n\n// ---------------------------------------------------------------------------\n// Verdict queue (WebSocket-style transport).\n// ---------------------------------------------------------------------------\n\nexport type Verdict = {\n  readonly call_id: string\n  readonly decision: \"approve\" | \"deny\"\n  readonly reason?: string\n}\n\n/**\n * Queue-backed approval planner. Safe calls are returned immediately in\n * `approved`; gated calls emit `ApprovalRequested` events and later produce\n * one `ToolCallDecision` when their matching verdict arrives.\n */\nexport const fromVerdictQueue =\n  (predicate: (call: FunctionCall) => boolean, verdicts: Queue.Dequeue<Verdict>) =>\n  (\n    calls: ReadonlyArray<FunctionCall>,\n  ): Effect.Effect<\n    {\n      readonly approved: ReadonlyArray<FunctionCall>\n      readonly decisions: Stream.Stream<ToolCallDecision>\n      readonly announce: Stream.Stream<ToolEvent>\n    },\n    never,\n    Scope.Scope\n  > =>\n    Effect.gen(function* () {\n      const gated = calls.filter(predicate)\n      const approved = calls.filter((call) => !predicate(call))\n\n      const entries = yield* Effect.forEach(gated, (call) =>\n        Deferred.make<Verdict>().pipe(Effect.map((d) => [call.call_id, d] as const)),\n      )\n      const deferreds: ReadonlyMap<string, Deferred.Deferred<Verdict>> = new Map(entries)\n\n      // Router is forked into the surrounding Scope so it lives as long\n      // as the consumer is pulling events. Recipes typically supply the\n      // scope by wrapping the events construction in `Stream.unwrap`.\n      yield* Effect.forkScoped(\n        Effect.forever(\n          Effect.gen(function* () {\n            const v = yield* Queue.take(verdicts)\n            const d = deferreds.get(v.call_id)\n            if (d !== undefined) yield* Deferred.succeed(d, v)\n          }),\n        ),\n      )\n\n      const decisions = Stream.fromIterable(gated).pipe(\n        Stream.flatMap(\n          (call) => {\n            const d = deferreds.get(call.call_id)!\n            return Stream.fromEffect(\n              Deferred.await(d).pipe(\n                Effect.map((v) =>\n                  v.decision === \"approve\" ? approve(call) : reject(denied(call, v.reason)),\n                ),\n              ),\n            )\n          },\n          { concurrency: \"unbounded\" },\n        ),\n      )\n\n      const announce = Stream.fromIterable<ToolEvent>(gated.map(approvalRequested))\n\n      return { approved, decisions, announce }\n    })\n\n// ---------------------------------------------------------------------------\n// Approval map (HTTP-style transport). Verdicts arrive synchronously\n// bundled in the request payload. Missing entries → cancelled.\n// ---------------------------------------------------------------------------\n\nexport type ApprovalMapEntry =\n  | { readonly decision: \"approve\" }\n  | { readonly decision: \"deny\"; readonly reason?: string }\n\nexport const fromApprovalMap =\n  (predicate: (call: FunctionCall) => boolean, approvals: ReadonlyMap<string, ApprovalMapEntry>) =>\n  (calls: ReadonlyArray<FunctionCall>): ToolCallPlan =>\n    splitToolCallDecisions(\n      calls.map((call) => {\n        if (!predicate(call)) return approve(call)\n        const v = approvals.get(call.call_id)\n        if (v === undefined) return reject(cancelled(call))\n        return v.decision === \"approve\" ? approve(call) : reject(denied(call, v.reason))\n      }),\n    )\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,MAAa,mBAAmB,KAAK,YAA8B;AAEnE,MAAa,WAAW,SAAyC,iBAAiB,SAAS,EAAE,MAAM,CAAC;AAEpG,MAAa,UAAU,WACrB,iBAAiB,SAAS,EAAE,QAAQ,CAAC;AAEvC,MAAa,0BAA0B,cACrC,UAAU,QACP,KAAK,aACJ,SAAS,SAAS,aACd;CAAE,GAAG;CAAK,UAAU,CAAC,GAAG,IAAI,UAAU,SAAS,KAAK;CAAE,GACtD;CAAE,GAAG;CAAK,UAAU,CAAC,GAAG,IAAI,UAAU,SAAS,OAAO;CAAE,EAC9D;CAAE,UAAU,EAAE;CAAE,UAAU,EAAE;CAAE,CAC/B;AAEH,MAAa,qBAAqB,SAChC,UAAU,kBAAkB;CAC1B,SAAS,KAAK;CACd,MAAM,KAAK;CACX,WAAW,KAAK;CACjB,CAAC;;;;;;AAiBJ,MAAa,oBACV,WAA4C,cAE3C,UAUA,OAAO,IAAI,aAAa;CACtB,MAAM,QAAQ,MAAM,OAAO,UAAU;CACrC,MAAM,WAAW,MAAM,QAAQ,SAAS,CAAC,UAAU,KAAK,CAAC;CAEzD,MAAM,UAAU,OAAO,OAAO,QAAQ,QAAQ,SAC5C,SAAS,MAAe,CAAC,KAAK,OAAO,KAAK,MAAM,CAAC,KAAK,SAAS,EAAE,CAAU,CAAC,CAC7E;CACD,MAAM,YAA6D,IAAI,IAAI,QAAQ;AAKnF,QAAO,OAAO,WACZ,OAAO,QACL,OAAO,IAAI,aAAa;EACtB,MAAM,IAAI,OAAO,MAAM,KAAK,SAAS;EACrC,MAAM,IAAI,UAAU,IAAI,EAAE,QAAQ;AAClC,MAAI,MAAM,KAAA,EAAW,QAAO,SAAS,QAAQ,GAAG,EAAE;GAClD,CACH,CACF;AAoBD,QAAO;EAAE;EAAU,WAlBD,OAAO,aAAa,MAAM,CAAC,KAC3C,OAAO,SACJ,SAAS;GACR,MAAM,IAAI,UAAU,IAAI,KAAK,QAAQ;AACrC,UAAO,OAAO,WACZ,SAAS,MAAM,EAAE,CAAC,KAChB,OAAO,KAAK,MACV,EAAE,aAAa,YAAY,QAAQ,KAAK,GAAG,OAAO,OAAO,MAAM,EAAE,OAAO,CAAC,CAC1E,CACF,CACF;KAEH,EAAE,aAAa,aAAa,CAC7B,CAKyB;EAAE,UAFb,OAAO,aAAwB,MAAM,IAAI,kBAAkB,CAEtC;EAAE;EACxC;AAWN,MAAa,mBACV,WAA4C,eAC5C,UACC,uBACE,MAAM,KAAK,SAAS;AAClB,KAAI,CAAC,UAAU,KAAK,CAAE,QAAO,QAAQ,KAAK;CAC1C,MAAM,IAAI,UAAU,IAAI,KAAK,QAAQ;AACrC,KAAI,MAAM,KAAA,EAAW,QAAO,OAAO,UAAU,KAAK,CAAC;AACnD,QAAO,EAAE,aAAa,YAAY,QAAQ,KAAK,GAAG,OAAO,OAAO,MAAM,EAAE,OAAO,CAAC;EAChF,CACH"}

package/dist/tool/Resolvers.test.mjs

@@ -1,8 +1,8 @@
 import { functionCallOutput, userText } from "../domain/Items.mjs";
 import { fromEffectSchema, make, streaming } from "./Tool.mjs";
 import { isFailure, isValue, toFunctionCallOutput } from "./Outcome.mjs";
-import { isApprovalRequested, isIntermediate, isOutput } from "./ToolEvent.mjs";
-import { executeAll, outputEvent, outputEvents } from "./Toolkit.mjs";
+import { ToolEvent, isApprovalRequested, isIntermediate, isOutput } from "./ToolEvent.mjs";
+import { executeAll } from "./Toolkit.mjs";
 import { fromApprovalMap, fromVerdictQueue } from "./Resolvers.mjs";
 import { cancelAllPending, findUnansweredCalls, isReconciled } from "./HistoryCheck.mjs";
 import { i as it, n as globalExpect, r as describe } from "../dist-DV5ISja1.mjs";
@@ -86,11 +86,12 @@ const calls = [
 ];
 const resultsFrom = (collected) => collected.filter(isOutput).map((e) => e.result);
 const byCallId = (results) => new Map(results.map((r) => [r.call_id, r]));
+const rejectedStream = (rejected) => Stream.fromIterable(rejected.map((result) => ToolEvent.Output({ result })));
 const eventsFromApprovalMap = (approvals) => {
 	const plan = fromApprovalMap(isSensitive, approvals)(calls);
-	return Stream.merge(executeAll(allTools, plan.approved), outputEvents(plan.rejected));
+	return Stream.merge(executeAll(allTools, plan.approved), rejectedStream(plan.rejected));
 };
-const eventsFromDecision = (decision) => decision._tag === "Approved" ? executeAll(allTools, [decision.call]) : Stream.succeed(outputEvent(decision.result));
+const eventsFromDecision = (decision) => decision._tag === "Approved" ? executeAll(allTools, [decision.call]) : Stream.succeed(ToolEvent.Output({ result: decision.result }));
 describe("fromApprovalMap + executeAll", () => {
 	it("approval: all gated approved → tools execute, structured Values", async () => {
 		const approvals = new Map([["c2", { decision: "approve" }], ["c3", { decision: "approve" }]]);
@@ -179,7 +180,7 @@ describe("executeAll: graceful degradation", () => {
 		];
 		const by = byCallId(resultsFrom(await Effect.runPromise(Stream.runCollect((() => {
 			const plan = fromApprovalMap(isSensitive, new Map([["c3", { decision: "approve" }]]))(callsWithBogus);
-			return Stream.merge(executeAll(allTools, plan.approved), outputEvents(plan.rejected));
+			return Stream.merge(executeAll(allTools, plan.approved), rejectedStream(plan.rejected));
 		})()))));
 		globalExpect(by.get("c1")).toMatchObject({ _tag: "Value" });
 		globalExpect(by.get("c2")).toMatchObject({