@effect-uai/core 0.5.2 → 0.7.0

package/dist/testing/MockSandbox.mjs

@@ -0,0 +1,160 @@
+import { ExecEvent, Sandbox, SandboxCustomImage, SandboxHostnameAllowlist, SandboxId, SandboxKernelSession, SandboxPauseResume, SandboxPortExposure, SandboxPty, SandboxSecretInjection, SandboxSnapshots, SandboxVolumes, SnapshotId, VolumeId } from "../sandbox/Sandbox.mjs";
+import { SandboxExecFailed, SandboxInvalidRequest } from "../sandbox/SandboxError.mjs";
+import { Array, Data, Effect, Layer, Ref, Stream } from "effect";
+//#region src/testing/MockSandbox.ts
+const Call = Data.taggedEnum();
+const defaultExec = {
+	exitCode: 0,
+	stdout: "",
+	stderr: "",
+	durationMs: 0
+};
+const toBytes = (contents) => typeof contents === "string" ? new TextEncoder().encode(contents) : contents;
+const seedFs = (files) => new Map(Object.entries(files ?? {}).map(([k, v]) => [k, toBytes(v)]));
+const exhausted = (method, scripted, attempt) => new SandboxInvalidRequest({
+	provider: "mock",
+	reason: `MockSandbox exhausted: ${scripted} ${method}(s) scripted, but call ${attempt} was made`
+});
+const consume = (cursor, scripted, onMiss) => Ref.getAndUpdate(cursor, (n) => n + 1).pipe(Effect.flatMap((i) => i < scripted.length ? Effect.succeed(scripted[i]) : onMiss(i + 1)));
+const buildInstance = (id, script, fs, execCursor, streamCursor, spawnCursor, record) => ({
+	id,
+	exec: (request) => record(Call.Exec({
+		id,
+		request
+	})).pipe(Effect.andThen(consume(execCursor, script.execs ?? [], () => Effect.succeed(defaultExec)))),
+	execStream: (request) => Stream.unwrap(record(Call.ExecStream({
+		id,
+		request
+	})).pipe(Effect.andThen(consume(streamCursor, script.streams ?? [], () => Effect.succeed([ExecEvent.Complete({
+		exitCode: 0,
+		durationMs: 0
+	})]))), Effect.map((events) => Stream.fromIterable(events)))),
+	spawn: (request) => record(Call.Spawn({
+		id,
+		request
+	})).pipe(Effect.andThen(consume(spawnCursor, script.spawns ?? [], (n) => Effect.fail(exhausted("spawn", (script.spawns ?? []).length, n)))), Effect.tap((handle) => Effect.addFinalizer(() => Effect.orDie(handle.kill)))),
+	files: {
+		read: (path) => record(Call.FileRead({
+			id,
+			path
+		})).pipe(Effect.andThen(Ref.get(fs)), Effect.flatMap((map) => map.has(path) ? Effect.succeed(map.get(path)) : Effect.fail(new SandboxExecFailed({
+			provider: "mock",
+			reason: `ENOENT: ${path}`,
+			raw: void 0
+		})))),
+		write: (path, contents) => record(Call.FileWrite({
+			id,
+			path,
+			contents
+		})).pipe(Effect.andThen(Ref.update(fs, (m) => new Map(m).set(path, toBytes(contents))))),
+		remove: (path) => record(Call.FileRemove({
+			id,
+			path
+		})).pipe(Effect.andThen(Ref.update(fs, (m) => {
+			const next = new Map(m);
+			next.delete(path);
+			return next;
+		}))),
+		mkdir: (path) => record(Call.FileMkdir({
+			id,
+			path
+		})),
+		list: (path) => record(Call.FileList({
+			id,
+			path
+		})).pipe(Effect.andThen(Ref.get(fs)), Effect.map((map) => {
+			const prefix = path.endsWith("/") ? path : `${path}/`;
+			const out = [];
+			for (const k of map.keys()) if (k.startsWith(prefix)) out.push({
+				path: k,
+				kind: "file"
+			});
+			return out;
+		})),
+		exists: (path) => record(Call.FileExists({
+			id,
+			path
+		})).pipe(Effect.andThen(Ref.get(fs)), Effect.map((map) => map.has(path)))
+	}
+});
+const buildService = (script, record) => {
+	const id = SandboxId(script.id ?? "mock-sandbox");
+	const acquireInstance = (sandboxId, onClose) => Effect.gen(function* () {
+		const fs = yield* Ref.make(seedFs(script.files));
+		const execCursor = yield* Ref.make(0);
+		const streamCursor = yield* Ref.make(0);
+		const spawnCursor = yield* Ref.make(0);
+		yield* Effect.addFinalizer(() => onClose);
+		return buildInstance(sandboxId, script, fs, execCursor, streamCursor, spawnCursor, record);
+	});
+	return {
+		create: (request) => record(Call.Create({ request })).pipe(Effect.andThen(acquireInstance(id, record(Call.Destroy({ id }))))),
+		attach: (sandboxId) => record(Call.Attach({ id: sandboxId })).pipe(Effect.andThen(acquireInstance(sandboxId, Effect.void))),
+		list: Effect.succeed(script.sandboxes ?? []),
+		destroy: (sandboxId) => record(Call.Destroy({ id: sandboxId })),
+		snapshots: {
+			create: (_from, name) => record(name === void 0 ? Call.SnapshotCreate({ id }) : Call.SnapshotCreate({
+				id,
+				name
+			})).pipe(Effect.as(SnapshotId(`mock-snapshot-${name ?? Math.random().toString(36).slice(2, 8)}`))),
+			destroy: (sid) => record(Call.SnapshotDestroy({ id: sid })),
+			list: Effect.succeed(script.snapshots ?? [])
+		},
+		volumes: {
+			create: (name, options) => record(options?.quotaBytes === void 0 ? Call.VolumeCreate({ name }) : Call.VolumeCreate({
+				name,
+				quotaBytes: options.quotaBytes
+			})).pipe(Effect.as(VolumeId(`mock-volume-${name}`))),
+			destroy: (vid) => record(Call.VolumeDestroy({ id: vid })),
+			list: Effect.succeed(script.volumes ?? [])
+		},
+		ports: { expose: (instance, port) => record(Call.ExposePort({
+			id: instance.id,
+			port
+		})).pipe(Effect.as({ url: (script.portUrl ?? ((p) => `http://mock.local:${p}`))(port) })) }
+	};
+};
+const makeRecorderUnsafe = () => {
+	const ref = Ref.makeUnsafe([]);
+	return {
+		record: (call) => Ref.update(ref, Array.append(call)),
+		recorder: Ref.get(ref).pipe(Effect.map((calls) => ({ calls })))
+	};
+};
+const allCapabilities = Layer.mergeAll(Layer.succeed(SandboxHostnameAllowlist, void 0), Layer.succeed(SandboxSecretInjection, void 0), Layer.succeed(SandboxSnapshots, void 0), Layer.succeed(SandboxPauseResume, void 0), Layer.succeed(SandboxVolumes, void 0), Layer.succeed(SandboxKernelSession, void 0), Layer.succeed(SandboxPty, void 0), Layer.succeed(SandboxCustomImage, void 0), Layer.succeed(SandboxPortExposure, void 0));
+/**
+* Layer that registers a `MockSandbox` against the `Sandbox` tag, with
+* every capability marker shipped — use when the code under test
+* exercises any of them.
+*/
+const layer = (script = {}) => {
+	const { record, recorder } = makeRecorderUnsafe();
+	return {
+		layer: Layer.merge(Layer.succeed(Sandbox, buildService(script, record)), allCapabilities),
+		recorder
+	};
+};
+/**
+* Layer with the `Sandbox` service but no capability markers. Use to
+* verify that consumers calling `Sandbox.snapshot` / `createVolume` /
+* etc. fail at `Effect.provide` with a type error.
+*/
+const layerWithoutCapabilities = (script = {}) => {
+	const { record, recorder } = makeRecorderUnsafe();
+	return {
+		layer: Layer.succeed(Sandbox, buildService(script, record)),
+		recorder
+	};
+};
+/** Bare service value + recorder. Use with `Effect.provideService`. */
+const make = (script = {}) => {
+	const { record, recorder } = makeRecorderUnsafe();
+	return {
+		service: buildService(script, record),
+		recorder
+	};
+};
+//#endregion
+export { Call, layer, layerWithoutCapabilities, make };
+
+//# sourceMappingURL=MockSandbox.mjs.map

package/dist/testing/MockSandbox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockSandbox.mjs","names":["SandboxError.SandboxInvalidRequest","SandboxError.SandboxExecFailed","Arr"],"sources":["../../src/testing/MockSandbox.ts"],"sourcesContent":["import { Array as Arr, Data, Effect, Layer, Ref, Stream } from \"effect\"\nimport {\n  ExecEvent,\n  Sandbox,\n  SandboxCustomImage,\n  SandboxHostnameAllowlist,\n  SandboxKernelSession,\n  SandboxPauseResume,\n  SandboxPortExposure,\n  SandboxPty,\n  SandboxSecretInjection,\n  SandboxSnapshots,\n  SandboxVolumes,\n  type CommonCreateRequest,\n  type CommonExecRequest,\n  type CommonSpawnRequest,\n  type ExecResult,\n  type FileEntry,\n  type ProcessHandle,\n  SandboxId,\n  type SandboxInstance,\n  type SandboxRef,\n  type SandboxService,\n  SnapshotId,\n  VolumeId,\n} from \"../sandbox/Sandbox.js\"\nimport * as SandboxError from \"../sandbox/SandboxError.js\"\n\n// ---------------------------------------------------------------------------\n// Call log\n// ---------------------------------------------------------------------------\n\n/**\n * One entry per side-effecting method call. Tests filter via\n * `Call.$is(...)` / `Call.$match`.\n */\nexport type Call = Data.TaggedEnum<{\n  Create: { readonly request: CommonCreateRequest }\n  Attach: { readonly id: SandboxId }\n  Destroy: { readonly id: SandboxId }\n  Exec: { readonly id: SandboxId; readonly request: CommonExecRequest }\n  ExecStream: { readonly id: SandboxId; readonly request: CommonExecRequest }\n  Spawn: { readonly id: SandboxId; readonly request: CommonSpawnRequest }\n  FileRead: { readonly id: SandboxId; readonly path: string }\n  FileWrite: {\n    readonly id: SandboxId\n    readonly path: string\n    readonly contents: Uint8Array | string\n  }\n  FileRemove: { readonly id: SandboxId; readonly path: string }\n  FileMkdir: { readonly id: SandboxId; readonly path: string }\n  FileList: { readonly id: SandboxId; readonly path: string }\n  FileExists: { readonly id: SandboxId; readonly path: string }\n  ExposePort: { readonly id: SandboxId; readonly port: number }\n  SnapshotCreate: { readonly id: SandboxId; readonly name?: string }\n  SnapshotDestroy: { readonly id: SnapshotId }\n  VolumeCreate: { readonly name: string; readonly quotaBytes?: number }\n  VolumeDestroy: { readonly id: VolumeId }\n}>\n\nexport const Call = Data.taggedEnum<Call>()\n\nexport type MockSandboxRecorder = {\n  readonly calls: ReadonlyArray<Call>\n}\n\n// ---------------------------------------------------------------------------\n// Script\n// ---------------------------------------------------------------------------\n\n/**\n * What this mock should hand back per call. Each method has its own\n * scripted queue and a sensible default when the queue is empty.\n * The filesystem is an in-memory mutable map seeded by `files`.\n */\nexport type MockSandboxScript = {\n  readonly id?: string\n  readonly execs?: ReadonlyArray<ExecResult>\n  readonly streams?: ReadonlyArray<ReadonlyArray<ExecEvent>>\n  readonly spawns?: ReadonlyArray<ProcessHandle>\n  readonly files?: Readonly<Record<string, Uint8Array | string>>\n  readonly sandboxes?: ReadonlyArray<SandboxRef>\n  readonly snapshots?: ReadonlyArray<{ readonly id: SnapshotId; readonly name?: string }>\n  readonly volumes?: ReadonlyArray<{ readonly id: VolumeId; readonly name: string }>\n  readonly portUrl?: (port: number) => string\n}\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nconst defaultExec: ExecResult = { exitCode: 0, stdout: \"\", stderr: \"\", durationMs: 0 }\n\nconst toBytes = (contents: Uint8Array | string) =>\n  typeof contents === \"string\" ? new TextEncoder().encode(contents) : contents\n\nconst seedFs = (files: MockSandboxScript[\"files\"]) =>\n  new Map(Object.entries(files ?? {}).map(([k, v]) => [k, toBytes(v)]))\n\nconst exhausted = (method: string, scripted: number, attempt: number) =>\n  new SandboxError.SandboxInvalidRequest({\n    provider: \"mock\",\n    reason: `MockSandbox exhausted: ${scripted} ${method}(s) scripted, but call ${attempt} was made`,\n  })\n\nconst consume = <A>(\n  cursor: Ref.Ref<number>,\n  scripted: ReadonlyArray<A>,\n  onMiss: (attempt: number) => Effect.Effect<A, SandboxError.SandboxError>,\n) =>\n  Ref.getAndUpdate(cursor, (n) => n + 1).pipe(\n    Effect.flatMap((i) => (i < scripted.length ? Effect.succeed(scripted[i]!) : onMiss(i + 1))),\n  )\n\n// ---------------------------------------------------------------------------\n// Service builder\n// ---------------------------------------------------------------------------\n\nconst buildInstance = (\n  id: SandboxId,\n  script: MockSandboxScript,\n  fs: Ref.Ref<Map<string, Uint8Array>>,\n  execCursor: Ref.Ref<number>,\n  streamCursor: Ref.Ref<number>,\n  spawnCursor: Ref.Ref<number>,\n  record: (call: Call) => Effect.Effect<void>,\n): SandboxInstance => ({\n  id,\n\n  exec: (request) =>\n    record(Call.Exec({ id, request })).pipe(\n      Effect.andThen(consume(execCursor, script.execs ?? [], () => Effect.succeed(defaultExec))),\n    ),\n\n  execStream: (request) =>\n    Stream.unwrap(\n      record(Call.ExecStream({ id, request })).pipe(\n        Effect.andThen(\n          consume(streamCursor, script.streams ?? [], () =>\n            Effect.succeed<ReadonlyArray<ExecEvent>>([\n              ExecEvent.Complete({ exitCode: 0, durationMs: 0 }),\n            ]),\n          ),\n        ),\n        Effect.map(\n          (events) =>\n            Stream.fromIterable(events) as Stream.Stream<ExecEvent, SandboxError.SandboxError>,\n        ),\n      ),\n    ),\n\n  spawn: (request) =>\n    record(Call.Spawn({ id, request })).pipe(\n      Effect.andThen(\n        consume(spawnCursor, script.spawns ?? [], (n) =>\n          Effect.fail(exhausted(\"spawn\", (script.spawns ?? []).length, n)),\n        ),\n      ),\n      Effect.tap((handle) => Effect.addFinalizer(() => Effect.orDie(handle.kill))),\n    ),\n\n  files: {\n    read: (path) =>\n      record(Call.FileRead({ id, path })).pipe(\n        Effect.andThen(Ref.get(fs)),\n        Effect.flatMap((map) =>\n          map.has(path)\n            ? Effect.succeed(map.get(path)!)\n            : Effect.fail(\n                new SandboxError.SandboxExecFailed({\n                  provider: \"mock\",\n                  reason: `ENOENT: ${path}`,\n                  raw: undefined,\n                }),\n              ),\n        ),\n      ),\n\n    write: (path, contents) =>\n      record(Call.FileWrite({ id, path, contents })).pipe(\n        Effect.andThen(Ref.update(fs, (m) => new Map(m).set(path, toBytes(contents)))),\n      ),\n\n    remove: (path) =>\n      record(Call.FileRemove({ id, path })).pipe(\n        Effect.andThen(\n          Ref.update(fs, (m) => {\n            const next = new Map(m)\n            next.delete(path)\n            return next\n          }),\n        ),\n      ),\n\n    mkdir: (path) => record(Call.FileMkdir({ id, path })),\n\n    list: (path) =>\n      record(Call.FileList({ id, path })).pipe(\n        Effect.andThen(Ref.get(fs)),\n        Effect.map((map) => {\n          const prefix = path.endsWith(\"/\") ? path : `${path}/`\n          const out: Array<FileEntry> = []\n          for (const k of map.keys()) {\n            if (k.startsWith(prefix)) out.push({ path: k, kind: \"file\" })\n          }\n          return out\n        }),\n      ),\n\n    exists: (path) =>\n      record(Call.FileExists({ id, path })).pipe(\n        Effect.andThen(Ref.get(fs)),\n        Effect.map((map) => map.has(path)),\n      ),\n  },\n})\n\nconst buildService = (\n  script: MockSandboxScript,\n  record: (call: Call) => Effect.Effect<void>,\n): SandboxService => {\n  const id = SandboxId(script.id ?? \"mock-sandbox\")\n\n  const acquireInstance = (sandboxId: SandboxId, onClose: Effect.Effect<void>) =>\n    Effect.gen(function* () {\n      const fs = yield* Ref.make(seedFs(script.files))\n      const execCursor = yield* Ref.make(0)\n      const streamCursor = yield* Ref.make(0)\n      const spawnCursor = yield* Ref.make(0)\n      yield* Effect.addFinalizer(() => onClose)\n      return buildInstance(sandboxId, script, fs, execCursor, streamCursor, spawnCursor, record)\n    })\n\n  return {\n    create: (request) =>\n      record(Call.Create({ request })).pipe(\n        Effect.andThen(acquireInstance(id, record(Call.Destroy({ id })))),\n      ),\n\n    attach: (sandboxId) =>\n      record(Call.Attach({ id: sandboxId })).pipe(\n        // Attach detaches on scope close (no destroy).\n        Effect.andThen(acquireInstance(sandboxId, Effect.void)),\n      ),\n\n    list: Effect.succeed(script.sandboxes ?? []),\n\n    destroy: (sandboxId) => record(Call.Destroy({ id: sandboxId })),\n\n    snapshots: {\n      create: (_from, name) =>\n        record(\n          name === undefined ? Call.SnapshotCreate({ id }) : Call.SnapshotCreate({ id, name }),\n        ).pipe(\n          Effect.as(SnapshotId(`mock-snapshot-${name ?? Math.random().toString(36).slice(2, 8)}`)),\n        ),\n      destroy: (sid) => record(Call.SnapshotDestroy({ id: sid })),\n      list: Effect.succeed(script.snapshots ?? []),\n    },\n\n    volumes: {\n      create: (name, options) =>\n        record(\n          options?.quotaBytes === undefined\n            ? Call.VolumeCreate({ name })\n            : Call.VolumeCreate({ name, quotaBytes: options.quotaBytes }),\n        ).pipe(Effect.as(VolumeId(`mock-volume-${name}`))),\n      destroy: (vid) => record(Call.VolumeDestroy({ id: vid })),\n      list: Effect.succeed(script.volumes ?? []),\n    },\n\n    ports: {\n      expose: (instance, port) =>\n        record(Call.ExposePort({ id: instance.id, port })).pipe(\n          Effect.as({ url: (script.portUrl ?? ((p) => `http://mock.local:${p}`))(port) }),\n        ),\n    },\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Recorder\n// ---------------------------------------------------------------------------\n\nconst makeRecorderUnsafe = () => {\n  const ref = Ref.makeUnsafe<ReadonlyArray<Call>>([])\n  return {\n    record: (call: Call) => Ref.update(ref, Arr.append(call)),\n    recorder: Ref.get(ref).pipe(Effect.map((calls): MockSandboxRecorder => ({ calls }))),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\nconst allCapabilities = Layer.mergeAll(\n  Layer.succeed(SandboxHostnameAllowlist, undefined),\n  Layer.succeed(SandboxSecretInjection, undefined),\n  Layer.succeed(SandboxSnapshots, undefined),\n  Layer.succeed(SandboxPauseResume, undefined),\n  Layer.succeed(SandboxVolumes, undefined),\n  Layer.succeed(SandboxKernelSession, undefined),\n  Layer.succeed(SandboxPty, undefined),\n  Layer.succeed(SandboxCustomImage, undefined),\n  Layer.succeed(SandboxPortExposure, undefined),\n)\n\n/**\n * Layer that registers a `MockSandbox` against the `Sandbox` tag, with\n * every capability marker shipped — use when the code under test\n * exercises any of them.\n */\nexport const layer = (script: MockSandboxScript = {}) => {\n  const { record, recorder } = makeRecorderUnsafe()\n  return {\n    layer: Layer.merge(Layer.succeed(Sandbox, buildService(script, record)), allCapabilities),\n    recorder,\n  }\n}\n\n/**\n * Layer with the `Sandbox` service but no capability markers. Use to\n * verify that consumers calling `Sandbox.snapshot` / `createVolume` /\n * etc. fail at `Effect.provide` with a type error.\n */\nexport const layerWithoutCapabilities = (script: MockSandboxScript = {}) => {\n  const { record, recorder } = makeRecorderUnsafe()\n  return {\n    layer: Layer.succeed(Sandbox, buildService(script, record)),\n    recorder,\n  }\n}\n\n/** Bare service value + recorder. Use with `Effect.provideService`. */\nexport const make = (script: MockSandboxScript = {}) => {\n  const { record, recorder } = makeRecorderUnsafe()\n  return {\n    service: buildService(script, record),\n    recorder,\n  }\n}\n"],"mappings":"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"}

package/dist/testing/MockSpeechSynthesizer.d.mts

@@ -1,5 +1,5 @@
-import { n as AudioChunk, t as AudioBlob } from "../Audio-BfCTGnH3.mjs";
-import { CommonStreamSynthesizeRequest, CommonSynthesizeRequest, SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
+import { n as AudioChunk, t as AudioBlob } from "../Audio-DPlTsNdz.mjs";
+import { CommonStreamSynthesizeRequest, CommonSynthesizeDialogueRequest, CommonSynthesizeRequest, MultiSpeakerTts, SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
 import { Effect, Layer } from "effect";
 
 //#region src/testing/MockSpeechSynthesizer.d.ts
@@ -7,31 +7,46 @@ type MockSynthesizerRecorder = {
   readonly synthesizeCalls: ReadonlyArray<CommonSynthesizeRequest>;
   readonly streamSynthesisCalls: ReadonlyArray<CommonSynthesizeRequest>;
   readonly streamSynthesisFromCalls: ReadonlyArray<CommonStreamSynthesizeRequest>;
+  readonly synthesizeDialogueCalls: ReadonlyArray<CommonSynthesizeDialogueRequest>;
+  readonly streamSynthesizeDialogueCalls: ReadonlyArray<CommonSynthesizeDialogueRequest>;
 };
 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>>;
+  readonly streamSynthesisFromChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>; /** One blob per `synthesizeDialogue` call, consumed in order. */
+  readonly dialogueBlobs?: ReadonlyArray<AudioBlob>; /** One chunk-list per `streamSynthesizeDialogue` call, consumed in order. */
+  readonly streamSynthesizeDialogueChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>;
 };
 /**
- * Layer providing the `SpeechSynthesizer` service AND the
- * `TtsIncrementalText` capability marker. Use for the common case
- * where code under test exercises `streamSynthesisFrom`.
+ * Layer providing `SpeechSynthesizer` plus both capability markers
+ * (`TtsIncrementalText` and `MultiSpeakerTts`). Use for the common case
+ * where code under test exercises any of the optional methods.
  */
 declare const layer: (script: MockSynthesizerScript) => {
-  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText>;
+  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText | MultiSpeakerTts>;
   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.
+ * provider without incremental-text-in support (e.g. OpenAI). Calls to
+ * `streamSynthesisFrom` in code under test should be a compile-time
+ * error. `MultiSpeakerTts` is still provided.
  */
 declare const layerWithoutIncremental: (script: MockSynthesizerScript) => {
-  readonly layer: Layer.Layer<SpeechSynthesizer>;
+  readonly layer: Layer.Layer<SpeechSynthesizer | MultiSpeakerTts>;
+  readonly recorder: Effect.Effect<MockSynthesizerRecorder>;
+};
+/**
+ * Variant that omits the `MultiSpeakerTts` marker — simulates a
+ * provider without multi-speaker dialogue support (e.g. OpenAI,
+ * Inworld). Calls to `synthesizeDialogue` /
+ * `streamSynthesizeDialogue` in code under test should be a
+ * compile-time error.
+ */
+declare const layerWithoutMultiSpeaker: (script: MockSynthesizerScript) => {
+  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText>;
   readonly recorder: Effect.Effect<MockSynthesizerRecorder>;
 };
 //#endregion
-export { MockSynthesizerRecorder, MockSynthesizerScript, layer, layerWithoutIncremental };
+export { MockSynthesizerRecorder, MockSynthesizerScript, layer, layerWithoutIncremental, layerWithoutMultiSpeaker };
 //# sourceMappingURL=MockSpeechSynthesizer.d.mts.map

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

@@ -1 +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"}
+{"version":3,"file":"MockSpeechSynthesizer.d.mts","names":[],"sources":["../../src/testing/MockSpeechSynthesizer.ts"],"mappings":";;;;;KAaY,uBAAA;EAAA,SACD,eAAA,EAAiB,aAAA,CAAc,uBAAA;EAAA,SAC/B,oBAAA,EAAsB,aAAA,CAAc,uBAAA;EAAA,SACpC,wBAAA,EAA0B,aAAA,CAAc,6BAAA;EAAA,SACxC,uBAAA,EAAyB,aAAA,CAAc,+BAAA;EAAA,SACvC,6BAAA,EAA+B,aAAA,CAAc,+BAAA;AAAA;AAAA,KAG5C,qBAAA;EANqB,kEAQtB,KAAA,GAAQ,aAAA,CAAc,SAAA,GAPI;EAAA,SAS1B,qBAAA,GAAwB,aAAA,CAAc,aAAA,CAAc,UAAA,IAR3B;EAAA,SAUzB,yBAAA,GAA4B,aAAA,CAAc,aAAA,CAAc,UAAA,IATzB;EAAA,SAW/B,aAAA,GAAgB,aAAA,CAAc,SAAA,GAXc;EAAA,SAa5C,8BAAA,GAAiC,aAAA,CAAc,aAAA,CAAc,UAAA;AAAA;;;;;;cAwI3D,KAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,iBAAA,GAAoB,kBAAA,GAAqB,eAAA;EAAA,SAC5D,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA;;;;;;;cAkBtB,uBAAA,GACX,MAAA,EAAQ,qBAAA;EAAA,SAEC,KAAA,EAAO,KAAA,CAAM,KAAA,CAAM,iBAAA,GAAoB,eAAA;EAAA,SACvC,QAAA,EAAU,MAAA,CAAO,MAAA,CAAO,uBAAA;AAAA;;;;;;;;cAiBtB,wBAAA,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"}

package/dist/testing/MockSpeechSynthesizer.mjs

@@ -1,95 +1,119 @@
 import { InvalidRequest } from "../domain/AiError.mjs";
-import { SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
+import { MultiSpeakerTts, SpeechSynthesizer, TtsIncrementalText } from "../speech-synthesizer/SpeechSynthesizer.mjs";
 import { Effect, Layer, Ref, Stream } from "effect";
 //#region src/testing/MockSpeechSynthesizer.ts
+const exhausted = (label, scripted, call) => new InvalidRequest({
+	provider: "mock",
+	raw: `MockSpeechSynthesizer exhausted: ${scripted} ${label} scripted, but call ${call} was made`
+});
 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);
+	const sdCursor = yield* Ref.make(0);
+	const ssdCursor = 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`
-			});
+			if (i >= scripted.length) return yield* exhausted("blobs", scripted.length, i + 1);
 			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`
-			}));
+			if (i >= scripted.length) return Stream.fail(exhausted("streamSynthesis lists", scripted.length, i + 1));
 			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`
-			}));
+			if (i >= scripted.length) return Stream.fail(exhausted("streamSynthesisFrom lists", scripted.length, i + 1));
 			return Stream.drain(textIn).pipe(Stream.concat(Stream.fromIterable(scripted[i])));
+		})),
+		synthesizeDialogue: (request) => Effect.gen(function* () {
+			yield* record.synthesizeDialogue(request);
+			const i = yield* Ref.getAndUpdate(sdCursor, (n) => n + 1);
+			const scripted = script.dialogueBlobs ?? [];
+			if (i >= scripted.length) return yield* exhausted("dialogueBlobs", scripted.length, i + 1);
+			return scripted[i];
+		}),
+		streamSynthesizeDialogue: (request) => Stream.unwrap(Effect.gen(function* () {
+			yield* record.streamSynthesizeDialogue(request);
+			const i = yield* Ref.getAndUpdate(ssdCursor, (n) => n + 1);
+			const scripted = script.streamSynthesizeDialogueChunks ?? [];
+			if (i >= scripted.length) return Stream.fail(exhausted("streamSynthesizeDialogue lists", scripted.length, i + 1));
+			return Stream.fromIterable(scripted[i]);
 		}))
 	};
 });
+const newBuffers = () => ({
+	bCalls: Ref.makeUnsafe([]),
+	ssCalls: Ref.makeUnsafe([]),
+	ssfCalls: Ref.makeUnsafe([]),
+	sdCalls: Ref.makeUnsafe([]),
+	ssdCalls: Ref.makeUnsafe([])
+});
+const recordFor = (b) => ({
+	synthesize: (req) => Ref.update(b.bCalls, (xs) => [...xs, req]),
+	streamSynthesis: (req) => Ref.update(b.ssCalls, (xs) => [...xs, req]),
+	streamSynthesisFrom: (req) => Ref.update(b.ssfCalls, (xs) => [...xs, req]),
+	synthesizeDialogue: (req) => Ref.update(b.sdCalls, (xs) => [...xs, req]),
+	streamSynthesizeDialogue: (req) => Ref.update(b.ssdCalls, (xs) => [...xs, req])
+});
+const recorderEffect = (b) => Effect.gen(function* () {
+	return {
+		synthesizeCalls: yield* Ref.get(b.bCalls),
+		streamSynthesisCalls: yield* Ref.get(b.ssCalls),
+		streamSynthesisFromCalls: yield* Ref.get(b.ssfCalls),
+		synthesizeDialogueCalls: yield* Ref.get(b.sdCalls),
+		streamSynthesizeDialogueCalls: yield* Ref.get(b.ssdCalls)
+	};
+});
 /**
-* Layer providing the `SpeechSynthesizer` service AND the
-* `TtsIncrementalText` capability marker. Use for the common case
-* where code under test exercises `streamSynthesisFrom`.
+* Layer providing `SpeechSynthesizer` plus both capability markers
+* (`TtsIncrementalText` and `MultiSpeakerTts`). Use for the common case
+* where code under test exercises any of the optional methods.
 */
 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])
-	}));
+	const buffers = newBuffers();
+	const synthesizerLayer = Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers)));
 	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)
-			};
-		})
+		layer: Layer.mergeAll(synthesizerLayer, Layer.succeed(TtsIncrementalText, void 0), Layer.succeed(MultiSpeakerTts, void 0)),
+		recorder: recorderEffect(buffers)
 	};
 };
 /**
 * 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.
+* provider without incremental-text-in support (e.g. OpenAI). Calls to
+* `streamSynthesisFrom` in code under test should be a compile-time
+* error. `MultiSpeakerTts` is still provided.
 */
 const layerWithoutIncremental = (script) => {
-	const bCalls = Ref.makeUnsafe([]);
-	const ssCalls = Ref.makeUnsafe([]);
-	const ssfCalls = Ref.makeUnsafe([]);
+	const buffers = newBuffers();
 	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)
-			};
-		})
+		layer: Layer.merge(Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers))), Layer.succeed(MultiSpeakerTts, void 0)),
+		recorder: recorderEffect(buffers)
+	};
+};
+/**
+* Variant that omits the `MultiSpeakerTts` marker — simulates a
+* provider without multi-speaker dialogue support (e.g. OpenAI,
+* Inworld). Calls to `synthesizeDialogue` /
+* `streamSynthesizeDialogue` in code under test should be a
+* compile-time error.
+*/
+const layerWithoutMultiSpeaker = (script) => {
+	const buffers = newBuffers();
+	return {
+		layer: Layer.merge(Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers))), Layer.succeed(TtsIncrementalText, void 0)),
+		recorder: recorderEffect(buffers)
 	};
 };
 //#endregion
-export { layer, layerWithoutIncremental };
+export { layer, layerWithoutIncremental, layerWithoutMultiSpeaker };
 
 //# sourceMappingURL=MockSpeechSynthesizer.mjs.map

package/dist/testing/MockSpeechSynthesizer.mjs.map

@@ -1 +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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"}
+{"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  type CommonStreamSynthesizeRequest,\n  type CommonSynthesizeDialogueRequest,\n  type CommonSynthesizeRequest,\n  MultiSpeakerTts,\n  SpeechSynthesizer,\n  type SpeechSynthesizerService,\n  TtsIncrementalText,\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  readonly synthesizeDialogueCalls: ReadonlyArray<CommonSynthesizeDialogueRequest>\n  readonly streamSynthesizeDialogueCalls: ReadonlyArray<CommonSynthesizeDialogueRequest>\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  /** One blob per `synthesizeDialogue` call, consumed in order. */\n  readonly dialogueBlobs?: ReadonlyArray<AudioBlob>\n  /** One chunk-list per `streamSynthesizeDialogue` call, consumed in order. */\n  readonly streamSynthesizeDialogueChunks?: ReadonlyArray<ReadonlyArray<AudioChunk>>\n}\n\ntype 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  readonly synthesizeDialogue: (req: CommonSynthesizeDialogueRequest) => Effect.Effect<void>\n  readonly streamSynthesizeDialogue: (req: CommonSynthesizeDialogueRequest) => Effect.Effect<void>\n}\n\nconst exhausted = (label: string, scripted: number, call: number): AiError.AiError =>\n  new AiError.InvalidRequest({\n    provider: \"mock\",\n    raw: `MockSpeechSynthesizer exhausted: ${scripted} ${label} scripted, but call ${call} was made`,\n  })\n\nconst makeService = (script: MockSynthesizerScript, record: Record) =>\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 sdCursor = yield* Ref.make(0)\n    const ssdCursor = 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) return yield* exhausted(\"blobs\", scripted.length, i + 1)\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(exhausted(\"streamSynthesis lists\", scripted.length, i + 1))\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 fail: Stream.Stream<AudioChunk, AiError.AiError | E, R> = Stream.fail(\n                exhausted(\"streamSynthesisFrom lists\", scripted.length, i + 1),\n              )\n              return fail\n            }\n            return Stream.drain(textIn).pipe(Stream.concat(Stream.fromIterable(scripted[i]!)))\n          }),\n        ),\n      synthesizeDialogue: (request) =>\n        Effect.gen(function* () {\n          yield* record.synthesizeDialogue(request)\n          const i = yield* Ref.getAndUpdate(sdCursor, (n) => n + 1)\n          const scripted = script.dialogueBlobs ?? []\n          if (i >= scripted.length) {\n            return yield* exhausted(\"dialogueBlobs\", scripted.length, i + 1)\n          }\n          return scripted[i]!\n        }),\n      streamSynthesizeDialogue: (request) =>\n        Stream.unwrap(\n          Effect.gen(function* () {\n            yield* record.streamSynthesizeDialogue(request)\n            const i = yield* Ref.getAndUpdate(ssdCursor, (n) => n + 1)\n            const scripted = script.streamSynthesizeDialogueChunks ?? []\n            if (i >= scripted.length) {\n              return Stream.fail(\n                exhausted(\"streamSynthesizeDialogue lists\", scripted.length, i + 1),\n              )\n            }\n            return Stream.fromIterable(scripted[i]!)\n          }),\n        ),\n    }\n    return service\n  })\n\ntype CallBuffers = {\n  readonly bCalls: Ref.Ref<ReadonlyArray<CommonSynthesizeRequest>>\n  readonly ssCalls: Ref.Ref<ReadonlyArray<CommonSynthesizeRequest>>\n  readonly ssfCalls: Ref.Ref<ReadonlyArray<CommonStreamSynthesizeRequest>>\n  readonly sdCalls: Ref.Ref<ReadonlyArray<CommonSynthesizeDialogueRequest>>\n  readonly ssdCalls: Ref.Ref<ReadonlyArray<CommonSynthesizeDialogueRequest>>\n}\n\nconst newBuffers = (): CallBuffers => ({\n  bCalls: Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([]),\n  ssCalls: Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeRequest>>([]),\n  ssfCalls: Ref.makeUnsafe<ReadonlyArray<CommonStreamSynthesizeRequest>>([]),\n  sdCalls: Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeDialogueRequest>>([]),\n  ssdCalls: Ref.makeUnsafe<ReadonlyArray<CommonSynthesizeDialogueRequest>>([]),\n})\n\nconst recordFor = (b: CallBuffers): Record => ({\n  synthesize: (req) => Ref.update(b.bCalls, (xs) => [...xs, req]),\n  streamSynthesis: (req) => Ref.update(b.ssCalls, (xs) => [...xs, req]),\n  streamSynthesisFrom: (req) => Ref.update(b.ssfCalls, (xs) => [...xs, req]),\n  synthesizeDialogue: (req) => Ref.update(b.sdCalls, (xs) => [...xs, req]),\n  streamSynthesizeDialogue: (req) => Ref.update(b.ssdCalls, (xs) => [...xs, req]),\n})\n\nconst recorderEffect = (b: CallBuffers): Effect.Effect<MockSynthesizerRecorder> =>\n  Effect.gen(function* () {\n    const synthesizeCalls = yield* Ref.get(b.bCalls)\n    const streamSynthesisCalls = yield* Ref.get(b.ssCalls)\n    const streamSynthesisFromCalls = yield* Ref.get(b.ssfCalls)\n    const synthesizeDialogueCalls = yield* Ref.get(b.sdCalls)\n    const streamSynthesizeDialogueCalls = yield* Ref.get(b.ssdCalls)\n    return {\n      synthesizeCalls,\n      streamSynthesisCalls,\n      streamSynthesisFromCalls,\n      synthesizeDialogueCalls,\n      streamSynthesizeDialogueCalls,\n    }\n  })\n\n/**\n * Layer providing `SpeechSynthesizer` plus both capability markers\n * (`TtsIncrementalText` and `MultiSpeakerTts`). Use for the common case\n * where code under test exercises any of the optional methods.\n */\nexport const layer = (\n  script: MockSynthesizerScript,\n): {\n  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText | MultiSpeakerTts>\n  readonly recorder: Effect.Effect<MockSynthesizerRecorder>\n} => {\n  const buffers = newBuffers()\n  const synthesizerLayer = Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers)))\n  const live = Layer.mergeAll(\n    synthesizerLayer,\n    Layer.succeed(TtsIncrementalText, undefined),\n    Layer.succeed(MultiSpeakerTts, undefined),\n  )\n  return { layer: live, recorder: recorderEffect(buffers) }\n}\n\n/**\n * Variant that omits the `TtsIncrementalText` marker — simulates a\n * provider without incremental-text-in support (e.g. OpenAI). Calls to\n * `streamSynthesisFrom` in code under test should be a compile-time\n * error. `MultiSpeakerTts` is still provided.\n */\nexport const layerWithoutIncremental = (\n  script: MockSynthesizerScript,\n): {\n  readonly layer: Layer.Layer<SpeechSynthesizer | MultiSpeakerTts>\n  readonly recorder: Effect.Effect<MockSynthesizerRecorder>\n} => {\n  const buffers = newBuffers()\n  const live = Layer.merge(\n    Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers))),\n    Layer.succeed(MultiSpeakerTts, undefined),\n  )\n  return { layer: live, recorder: recorderEffect(buffers) }\n}\n\n/**\n * Variant that omits the `MultiSpeakerTts` marker — simulates a\n * provider without multi-speaker dialogue support (e.g. OpenAI,\n * Inworld). Calls to `synthesizeDialogue` /\n * `streamSynthesizeDialogue` in code under test should be a\n * compile-time error.\n */\nexport const layerWithoutMultiSpeaker = (\n  script: MockSynthesizerScript,\n): {\n  readonly layer: Layer.Layer<SpeechSynthesizer | TtsIncrementalText>\n  readonly recorder: Effect.Effect<MockSynthesizerRecorder>\n} => {\n  const buffers = newBuffers()\n  const live = Layer.merge(\n    Layer.effect(SpeechSynthesizer, makeService(script, recordFor(buffers))),\n    Layer.succeed(TtsIncrementalText, undefined),\n  )\n  return { layer: live, recorder: recorderEffect(buffers) }\n}\n"],"mappings":"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"}

package/dist/tool/{Resolvers.d.mts → Approval.d.mts}

@@ -1,29 +1,29 @@
-import { o as FunctionCall } from "../Items-BH8xUkoR.mjs";
-import { ToolResult } from "./Outcome.mjs";
+import { v as ToolCall } from "../Items-D8UaXQx_.mjs";
+import { ToolResult } from "./ToolResult.mjs";
 import { ToolEvent } from "./ToolEvent.mjs";
 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 {
-  export { ApprovalMapEntry, ToolCallDecision, ToolCallPlan, Verdict, approvalRequested, approve, fromApprovalMap, fromVerdictQueue, reject, splitToolCallDecisions };
+//#region src/tool/Approval.d.ts
+declare namespace Approval_d_exports {
+  export { ApprovalDecision, ApprovalMapEntry, ToolCallPlan, Verdict, approvalRequested, approve, fromMap, fromQueue, reject, splitApprovalDecisions };
 }
 type ToolCallPlan = {
-  readonly approved: ReadonlyArray<FunctionCall>;
+  readonly approved: ReadonlyArray<ToolCall>;
   readonly rejected: ReadonlyArray<ToolResult>;
 };
-type ToolCallDecision = Data.TaggedEnum<{
+type ApprovalDecision = Data.TaggedEnum<{
   Approved: {
-    readonly call: FunctionCall;
+    readonly call: ToolCall;
   };
   Rejected: {
     readonly result: ToolResult;
   };
 }>;
-declare const ToolCallDecision: {
+declare const ApprovalDecision: {
   readonly Approved: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Approved";
-    readonly call: FunctionCall;
+    readonly call: ToolCall;
   }, "_tag">;
   readonly Rejected: Data.TaggedEnum.ConstructorFrom<{
     readonly _tag: "Rejected";
@@ -31,7 +31,7 @@ declare const ToolCallDecision: {
   }, "_tag">;
   readonly $is: <Tag extends "Approved" | "Rejected">(tag: Tag) => (u: unknown) => u is Extract<{
     readonly _tag: "Approved";
-    readonly call: FunctionCall;
+    readonly call: ToolCall;
   }, {
     readonly _tag: Tag;
   }> | Extract<{
@@ -44,7 +44,7 @@ declare const ToolCallDecision: {
     <Cases extends {
       readonly Approved: (args: {
         readonly _tag: "Approved";
-        readonly call: FunctionCall;
+        readonly call: ToolCall;
       }) => any;
       readonly Rejected: (args: {
         readonly _tag: "Rejected";
@@ -52,7 +52,7 @@ declare const ToolCallDecision: {
       }) => any;
     }>(cases: Cases): (value: {
       readonly _tag: "Approved";
-      readonly call: FunctionCall;
+      readonly call: ToolCall;
     } | {
       readonly _tag: "Rejected";
       readonly result: ToolResult;
@@ -60,7 +60,7 @@ declare const ToolCallDecision: {
     <Cases extends {
       readonly Approved: (args: {
         readonly _tag: "Approved";
-        readonly call: FunctionCall;
+        readonly call: ToolCall;
       }) => any;
       readonly Rejected: (args: {
         readonly _tag: "Rejected";
@@ -68,17 +68,17 @@ declare const ToolCallDecision: {
       }) => any;
     }>(value: {
       readonly _tag: "Approved";
-      readonly call: FunctionCall;
+      readonly call: ToolCall;
     } | {
       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;
-declare const splitToolCallDecisions: (decisions: ReadonlyArray<ToolCallDecision>) => ToolCallPlan;
-declare const approvalRequested: (call: FunctionCall) => ToolEvent;
+declare const approve: (call: ToolCall) => ApprovalDecision;
+declare const reject: (result: ToolResult) => ApprovalDecision;
+declare const splitApprovalDecisions: (decisions: ReadonlyArray<ApprovalDecision>) => ToolCallPlan;
+declare const approvalRequested: (call: ToolCall) => ToolEvent;
 type Verdict = {
   readonly call_id: string;
   readonly decision: "approve" | "deny";
@@ -87,12 +87,12 @@ type Verdict = {
 /**
  * Queue-backed approval planner. Safe calls are returned immediately in
  * `approved`; gated calls emit `ApprovalRequested` events and later produce
- * one `ToolCallDecision` when their matching verdict arrives.
+ * one `ApprovalDecision` when their matching verdict arrives.
  */
-declare const fromVerdictQueue: (predicate: (call: FunctionCall) => boolean, verdicts: Queue.Dequeue<Verdict>) => (calls: ReadonlyArray<FunctionCall>) => Effect.Effect<{
-  readonly approved: ReadonlyArray<FunctionCall>;
-  readonly decisions: Stream.Stream<ToolCallDecision>;
-  readonly announce: Stream.Stream<ToolEvent>;
+declare const fromQueue: (predicate: (call: ToolCall) => boolean, verdicts: Queue.Dequeue<Verdict>) => (calls: ReadonlyArray<ToolCall>) => Effect.Effect<{
+  readonly approved: ReadonlyArray<ToolCall>;
+  readonly decisions: Stream.Stream<ApprovalDecision>;
+  readonly approvalRequests: Stream.Stream<ToolEvent>;
 }, never, Scope.Scope>;
 type ApprovalMapEntry = {
   readonly decision: "approve";
@@ -100,7 +100,7 @@ type ApprovalMapEntry = {
   readonly decision: "deny";
   readonly reason?: string;
 };
-declare const fromApprovalMap: (predicate: (call: FunctionCall) => boolean, approvals: ReadonlyMap<string, ApprovalMapEntry>) => (calls: ReadonlyArray<FunctionCall>) => ToolCallPlan;
+declare const fromMap: (predicate: (call: ToolCall) => boolean, approvals: ReadonlyMap<string, ApprovalMapEntry>) => (calls: ReadonlyArray<ToolCall>) => ToolCallPlan;
 //#endregion
-export { ApprovalMapEntry, ToolCallDecision, ToolCallPlan, Verdict, approvalRequested, approve, fromApprovalMap, fromVerdictQueue, reject, splitToolCallDecisions, Resolvers_d_exports as t };
-//# sourceMappingURL=Resolvers.d.mts.map
+export { ApprovalDecision, ApprovalMapEntry, ToolCallPlan, Verdict, approvalRequested, approve, fromMap, fromQueue, reject, splitApprovalDecisions, Approval_d_exports as t };
+//# sourceMappingURL=Approval.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Approval.d.mts","names":[],"sources":["../../src/tool/Approval.ts"],"mappings":";;;;;;;;;;KAYY,YAAA;EAAA,SACD,QAAA,EAAU,aAAA,CAAc,QAAA;EAAA,SACxB,QAAA,EAAU,aAAA,CAAc,UAAA;AAAA;AAAA,KAGvB,gBAAA,GAAmB,IAAA,CAAK,UAAA;EAClC,QAAA;IAAA,SAAqB,IAAA,EAAM,QAAA;EAAA;EAC3B,QAAA;IAAA,SAAqB,MAAA,EAAQ,UAAA;EAAA;AAAA;AAAA,cAGlB,gBAAA;EAAA;;mBAJgB,QAAA;EAAA;EAAA;;qBACE,UAAA;EAAA;EAAA;;mBADF,QAAA;EAAA;IAAA;;;qBACE,UAAA;EAAA;IAAA;;;;;;uBADF,QAAA;MAAA;MAAA;;yBACE,UAAA;MAAA;IAAA;;qBADF,QAAA;IAAA;MAAA;uBACE,UAAA;IAAA;;;;uBADF,QAAA;MAAA;MAAA;;yBACE,UAAA;MAAA;IAAA;;qBADF,QAAA;IAAA;MAAA;uBACE,UAAA;IAAA;;;cAKlB,OAAA,GAAW,IAAA,EAAM,QAAA,KAAW,gBAAA;AAAA,cAE5B,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,QAAA,KAAW,SAAA;AAAA,KAWvC,OAAA;EAAA,SACD,OAAA;EAAA,SACA,QAAA;EAAA,SACA,MAAA;AAAA;;;;;;cAQE,SAAA,GACV,SAAA,GAAY,IAAA,EAAM,QAAA,cAAsB,QAAA,EAAU,KAAA,CAAM,OAAA,CAAQ,OAAA,OAE/D,KAAA,EAAO,aAAA,CAAc,QAAA,MACpB,MAAA,CAAO,MAAA;EAAA,SAEG,QAAA,EAAU,aAAA,CAAc,QAAA;EAAA,SACxB,SAAA,EAAW,MAAA,CAAO,MAAA,CAAO,gBAAA;EAAA,SACzB,gBAAA,EAAkB,MAAA,CAAO,MAAA,CAAO,SAAA;AAAA,UAG3C,KAAA,CAAM,KAAA;AAAA,KAkDE,gBAAA;EAAA,SACG,QAAA;AAAA;EAAA,SACA,QAAA;EAAA,SAA2B,MAAA;AAAA;AAAA,cAE7B,OAAA,GACV,SAAA,GAAY,IAAA,EAAM,QAAA,cAAsB,SAAA,EAAW,WAAA,SAAoB,gBAAA,OACvE,KAAA,EAAO,aAAA,CAAc,QAAA,MAAY,YAAA"}