@effect-uai/core 0.3.0 → 0.5.0

package/dist/loop/Loop.test.mjs

@@ -1,6 +1,8 @@
-import { loop, loopWithState, next, nextAfter, stopAfter, stopEvent, value } from "./Loop.mjs";
-import { i as it, n as globalExpect, r as describe } from "../dist-DV5ISja1.mjs";
-import { Deferred, Effect, Fiber, Latch, Ref, Stream, SubscriptionRef } from "effect";
+import { RateLimited } from "../domain/AiError.mjs";
+import { TurnEvent } from "../domain/Turn.mjs";
+import { loop, loopFrom, loopWithState, next, nextAfter, onTurnComplete, stop, stopAfter, stopEvent, stopWith, value } from "./Loop.mjs";
+import { i as it, n as globalExpect, r as describe, t as import_dist } from "../dist-DV5ISja1.mjs";
+import { Deferred, Effect, Fiber, Latch, Ref, Stream, SubscriptionRef, pipe } from "effect";
 //#region src/loop/Loop.test.ts
 describe("Loop.loop", () => {
 	it("threads state across iterations and emits each iteration's substream in order", async () => {
@@ -59,6 +61,47 @@ describe("Loop.loop", () => {
 			2
 		]);
 	});
+	it("type: data-last (pipe) form preserves the body's E channel", () => {
+		pipe({ count: 0 }, loop((_state) => Stream.fail(new RateLimited({
+			provider: "test",
+			raw: null
+		}))));
+		(0, import_dist.expectTypeOf)().toEqualTypeOf();
+	});
+	it("type: data-first form preserves the body's E channel", () => {
+		loop({ count: 0 }, (_state) => Stream.fail(new RateLimited({
+			provider: "test",
+			raw: null
+		})));
+		(0, import_dist.expectTypeOf)().toEqualTypeOf();
+	});
+	it("type: onTurnComplete inside loop infers S and A from the handler without annotation", () => {
+		pipe({ turns: 0 }, loop((state) => Effect.gen(function* () {
+			return Stream.empty.pipe(onTurnComplete(() => Effect.sync(() => state.turns >= 1 ? stop : nextAfter(Stream.succeed({
+				_tag: "tool",
+				name: "x"
+			}), { turns: state.turns + 1 }))));
+		})));
+		(0, import_dist.expectTypeOf)().toEqualTypeOf();
+	});
+	it("onTurnComplete: data-first form (Function.dual) works at runtime", async () => {
+		const turnComplete = TurnEvent.TurnComplete({ turn: {
+			items: [],
+			usage: {
+				input_tokens: 0,
+				output_tokens: 0
+			},
+			stop_reason: "stop"
+		} });
+		const textDelta = TurnEvent.TextDelta({ text: "hi" });
+		const deltas = Stream.fromIterable([textDelta, turnComplete]);
+		const dataFirst = onTurnComplete(deltas, () => Effect.sync(() => stop));
+		const dataLast = deltas.pipe(onTurnComplete(() => Effect.sync(() => stop)));
+		const a = await Effect.runPromise(Stream.runCollect(dataFirst));
+		const b = await Effect.runPromise(Stream.runCollect(dataLast));
+		globalExpect(a.length).toBe(3);
+		globalExpect(b.length).toBe(3);
+	});
 	it("is stack-safe and linear-time across many iterations", async () => {
 		const N = 1e5;
 		const stream = loop(0, (n) => n >= N ? Stream.fromIterable([value(n), stopEvent]) : Stream.fromIterable([value(n), next(n + 1)]));
@@ -405,6 +448,131 @@ describe("Loop.loopWithState", () => {
 		]);
 	});
 });
+describe("Loop.loopFrom", () => {
+	it("runs a multi-turn inner loop per input until the body emits stop", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable(["a", "b"]).pipe(loopFrom(0, (turns, input) => {
+			if (turns >= 2 * (input === "a" ? 1 : 2)) return Stream.fromIterable([stopEvent]);
+			return Stream.fromIterable([value(`${input}:${turns}`), next(turns + 1)]);
+		}), Stream.runCollect))).toEqual([
+			"a:0",
+			"a:1",
+			"b:2",
+			"b:3"
+		]);
+	});
+	it("threads state across inputs (audio-pipeline shape)", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable([
+			"x",
+			"y",
+			"z"
+		]).pipe(loopFrom([], (history, input) => Stream.fromIterable([value([...history, input].join(",")), stopWith([...history, input])])), Stream.runCollect))).toEqual([
+			"x",
+			"x,y",
+			"x,y,z"
+		]);
+	});
+	it("simulates a stream of documents with multi-turn tool calls per document", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable(["doc1", "doc2"]).pipe(loopFrom({
+			turn: 0,
+			totalTurns: 0
+		}, (state, doc) => {
+			if (state.turn === 0) return Stream.fromIterable([value({
+				kind: "text",
+				doc,
+				text: "thinking"
+			}), next({
+				turn: 1,
+				totalTurns: state.totalTurns + 1
+			})]);
+			if (state.turn === 1) return Stream.fromIterable([value({
+				kind: "tool",
+				doc,
+				tool: "search"
+			}), next({
+				turn: 2,
+				totalTurns: state.totalTurns + 1
+			})]);
+			return Stream.fromIterable([value({
+				kind: "text",
+				doc,
+				text: "final"
+			}), stopWith({
+				turn: 0,
+				totalTurns: state.totalTurns + 1
+			})]);
+		}), Stream.runCollect))).toEqual([
+			{
+				kind: "text",
+				doc: "doc1",
+				text: "thinking"
+			},
+			{
+				kind: "tool",
+				doc: "doc1",
+				tool: "search"
+			},
+			{
+				kind: "text",
+				doc: "doc1",
+				text: "final"
+			},
+			{
+				kind: "text",
+				doc: "doc2",
+				text: "thinking"
+			},
+			{
+				kind: "tool",
+				doc: "doc2",
+				tool: "search"
+			},
+			{
+				kind: "text",
+				doc: "doc2",
+				text: "final"
+			}
+		]);
+	});
+	it("ends cleanly when the input stream ends mid-conversation", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable(["only"]).pipe(loopFrom(0, (turns, input) => turns >= 2 ? Stream.fromIterable([stopEvent]) : Stream.fromIterable([value(`${input}:${turns}`), next(turns + 1)])), Stream.runCollect))).toEqual(["only:0", "only:1"]);
+	});
+	it("body's `stop` advances to the next input (does NOT halt the whole stream)", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable([
+			1,
+			2,
+			3
+		]).pipe(loopFrom(0, (_state, input) => Stream.fromIterable([value(input * 10), stopEvent])), Stream.runCollect))).toEqual([
+			10,
+			20,
+			30
+		]);
+	});
+	it("data-first form (Function.dual) runs identically to data-last", async () => {
+		const inputs = Stream.fromIterable([1, 2]);
+		globalExpect(await Effect.runPromise(Stream.runCollect(loopFrom(inputs, 0, (state, input) => state >= input ? Stream.fromIterable([stopEvent]) : Stream.fromIterable([value(state + input), next(state + 1)]))))).toEqual([1, 3]);
+	});
+	it("supports Effect-returning bodies (parity with loop)", async () => {
+		globalExpect(await Effect.runPromise(Stream.fromIterable(["a"]).pipe(loopFrom(0, (turns, input) => Effect.gen(function* () {
+			const cur = yield* Effect.succeed(turns);
+			if (cur >= 2) return Stream.fromIterable([stopEvent]);
+			return Stream.fromIterable([value(`${input}:${cur}`), next(cur + 1)]);
+		})), Stream.runCollect))).toEqual(["a:0", "a:1"]);
+	});
+	it("type: data-last (pipe) form preserves the body's E channel", () => {
+		pipe(Stream.fromIterable([1]), loopFrom(0, (_state, _input) => Stream.fail(new RateLimited({
+			provider: "test",
+			raw: null
+		}))));
+		(0, import_dist.expectTypeOf)().toEqualTypeOf();
+	});
+	it("type: data-first form preserves the body's E channel and unifies with input's E", () => {
+		loopFrom(Stream.fail(/* @__PURE__ */ new Error("boom")), 0, (_state, _i) => Stream.fail(new RateLimited({
+			provider: "test",
+			raw: null
+		})));
+		(0, import_dist.expectTypeOf)().toEqualTypeOf();
+	});
+});
 //#endregion
 export {};
 

package/dist/loop/Loop.test.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Loop.test.mjs","names":[],"sources":["../../src/loop/Loop.test.ts"],"sourcesContent":["import { Deferred, Effect, Fiber, Latch, Ref, Stream, SubscriptionRef } from \"effect\"\nimport { describe, expect, it } from \"vitest\"\nimport {\n  type Event,\n  loop,\n  loopWithState,\n  next,\n  nextAfter,\n  stopEvent,\n  stopAfter,\n  value,\n} from \"./Loop.js\"\n\ndescribe(\"Loop.loop\", () => {\n  it(\"threads state across iterations and emits each iteration's substream in order\", async () => {\n    // Each iter emits [n, n + 0.5] then continues; final iter emits [n] and stops.\n    const stream = loop(0, (n: number) =>\n      n >= 3\n        ? stopAfter(Stream.fromIterable([n]))\n        : nextAfter(Stream.fromIterable([n, n + 0.5]), n + 1),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 0.5, 1, 1.5, 2, 2.5, 3])\n  })\n\n  it(\"supports iterations that emit zero values and only decide\", async () => {\n    // Every iteration emits nothing, just bumps state; stops at 5.\n    const stream = loop(0, (n: number) =>\n      n >= 5 ? Stream.fromIterable([stopEvent]) : Stream.fromIterable([next(n + 1)]),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([])\n  })\n\n  it(\"supports Effect-returning bodies directly (no Stream.unwrap needed)\", async () => {\n    // Each iter yields an Effect that doubles the state, then emits it.\n    // Body returns Effect<Stream> directly; loop unwraps internally.\n    const stream = loop(1, (n: number) =>\n      Effect.gen(function* () {\n        const doubled = yield* Effect.succeed(n * 2)\n        return doubled >= 16\n          ? stopAfter(Stream.fromIterable([doubled]))\n          : nextAfter(Stream.fromIterable([doubled]), doubled)\n      }),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([2, 4, 8, 16])\n  })\n\n  it(\"still accepts Stream.unwrap-wrapped bodies for backward compatibility\", async () => {\n    const stream = loop(1, (n: number) =>\n      Stream.unwrap(\n        Effect.gen(function* () {\n          const doubled = yield* Effect.succeed(n * 2)\n          return doubled >= 4\n            ? stopAfter(Stream.fromIterable([doubled]))\n            : nextAfter(Stream.fromIterable([doubled]), doubled)\n        }),\n      ),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([2, 4])\n  })\n\n  it(\"propagates errors from the body's stream\", async () => {\n    const boom = new Error(\"boom\")\n    const stream = loop(\n      0,\n      (n: number): Stream.Stream<Event<number, number>, Error> =>\n        n === 2 ? Stream.fail(boom) : Stream.fromIterable([value(n), next(n + 1)]),\n    )\n\n    const result = await Effect.runPromiseExit(Stream.runCollect(stream))\n    expect(result._tag).toBe(\"Failure\")\n  })\n\n  it(\"terminates silently if the body emits no Decision (mirrors paginate's silent stop)\", async () => {\n    // No decision emitted - loop just ends after the body's stream completes.\n    const stream = loop(0, (n: number) => Stream.fromIterable([value(n), value(n + 1)]))\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 1])\n  })\n\n  it(\"short-circuits the body's stream when a Decision is seen\", async () => {\n    // Body emits [n, next(n+1), n+10]. Once the Decision is encountered, the\n    // body's stream is interrupted - `n+10` is never pulled, so it never\n    // flows to the outer stream. This is the correct behavior: a Decision\n    // marks \"I'm done with this iteration\"; anything after it is dead code.\n    const stream = loop(0, (n: number) =>\n      n >= 2\n        ? Stream.fromIterable([value(n), stopEvent])\n        : Stream.fromIterable([value(n), next(n + 1), value(n + 10)]),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 1, 2])\n  })\n\n  it(\"is stack-safe and linear-time across many iterations\", async () => {\n    // 100k iterations far exceeds V8's typical stack depth (~10–15k frames).\n    const N = 100_000\n    const stream = loop(0, (n: number) =>\n      n >= N\n        ? Stream.fromIterable([value(n), stopEvent])\n        : Stream.fromIterable([value(n), next(n + 1)]),\n    )\n\n    const count = await Effect.runPromise(\n      Stream.runFold(\n        stream,\n        (): number => 0,\n        (acc) => acc + 1,\n      ),\n    )\n    expect(count).toBe(N + 1) // 0..N inclusive\n  }, 10_000)\n})\n\n// ---------------------------------------------------------------------------\n// Mock LLM scenario - proves the loop forwards deltas in real time and\n// correctly threads tool-result events between turns.\n// ---------------------------------------------------------------------------\n\ntype Delta =\n  | { readonly type: \"text\"; readonly text: string }\n  | { readonly type: \"tool_call\"; readonly id: string; readonly name: string }\n\ntype HistoryItem =\n  | { readonly type: \"user\"; readonly text: string }\n  | { readonly type: \"assistant\"; readonly text: string }\n  | { readonly type: \"tool_call\"; readonly id: string; readonly name: string }\n  | { readonly type: \"tool_result\"; readonly id: string; readonly output: string }\n\ntype UiEvent =\n  | { readonly type: \"text\"; readonly text: string }\n  | { readonly type: \"tool_started\"; readonly id: string; readonly name: string }\n  | { readonly type: \"tool_result\"; readonly id: string; readonly output: string }\n\ninterface MockModel {\n  readonly streamTurn: (history: ReadonlyArray<HistoryItem>) => Stream.Stream<Delta>\n}\n\ninterface State {\n  readonly history: ReadonlyArray<HistoryItem>\n  readonly model: MockModel\n}\n\ninterface ToolOutcome {\n  readonly output: string\n  readonly nextModel?: MockModel\n}\n\ntype ToolRunner = (call: { id: string; name: string }) => ToolOutcome\n\nconst scriptedModel = (script: ReadonlyArray<ReadonlyArray<Delta>>): MockModel => {\n  let i = 0\n  return {\n    streamTurn: () => {\n      const turn = script[i] ?? []\n      i += 1\n      return Stream.fromIterable(turn)\n    },\n  }\n}\n\n/**\n * Body factored out so both tests share it. Per iteration:\n *   1. Stream the model's deltas; tap captures texts + tool calls into Refs.\n *   2. flatMap projects deltas into UiEvents forwarded to the outer stream.\n *   3. Continuation reads the captured calls; if any, runs them, emits\n *      tool_result events, builds the next state (with model swap if a tool\n *      asked for one), and emits `next(state)`. Otherwise `stop`.\n */\nconst conversationLoop = (initial: State, runTool: ToolRunner) =>\n  loop(initial, (state) =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const textsRef = yield* Ref.make<ReadonlyArray<string>>([])\n        const toolCallsRef = yield* Ref.make<\n          ReadonlyArray<{ readonly id: string; readonly name: string }>\n        >([])\n\n        const deltas: Stream.Stream<Event<UiEvent, State>> = state.model\n          .streamTurn(state.history)\n          .pipe(\n            Stream.tap((d) =>\n              d.type === \"text\"\n                ? Ref.update(textsRef, (t) => [...t, d.text])\n                : Ref.update(toolCallsRef, (t) => [...t, { id: d.id, name: d.name }]),\n            ),\n            Stream.flatMap(\n              (d): Stream.Stream<Event<UiEvent, State>> =>\n                d.type === \"text\"\n                  ? Stream.fromIterable([value<UiEvent>({ type: \"text\", text: d.text })])\n                  : Stream.fromIterable([\n                      value<UiEvent>({ type: \"tool_started\", id: d.id, name: d.name }),\n                    ]),\n            ),\n          )\n\n        const continuation: Stream.Stream<Event<UiEvent, State>> = Stream.unwrap(\n          Effect.gen(function* () {\n            const texts = yield* Ref.get(textsRef)\n            const toolCalls = yield* Ref.get(toolCallsRef)\n\n            if (toolCalls.length === 0) {\n              return stopAfter(Stream.empty)\n            }\n\n            const turnItems: ReadonlyArray<HistoryItem> = [\n              ...(texts.length > 0 ? [{ type: \"assistant\" as const, text: texts.join(\"\") }] : []),\n              ...toolCalls.map(\n                (tc): HistoryItem => ({ type: \"tool_call\", id: tc.id, name: tc.name }),\n              ),\n            ]\n\n            const outcomes = toolCalls.map((call) => ({ call, outcome: runTool(call) }))\n\n            const events: ReadonlyArray<UiEvent> = outcomes.map(({ call, outcome }) => ({\n              type: \"tool_result\",\n              id: call.id,\n              output: outcome.output,\n            }))\n\n            const resultItems: ReadonlyArray<HistoryItem> = outcomes.map(\n              ({ call, outcome }): HistoryItem => ({\n                type: \"tool_result\",\n                id: call.id,\n                output: outcome.output,\n              }),\n            )\n\n            // Last requested model wins; default to the current one.\n            const nextModel = outcomes.reduce(\n              (m, { outcome }) => outcome.nextModel ?? m,\n              state.model,\n            )\n\n            const nextState: State = {\n              history: [...state.history, ...turnItems, ...resultItems],\n              model: nextModel,\n            }\n\n            return nextAfter(Stream.fromIterable(events), nextState)\n          }),\n        )\n\n        return Stream.concat(deltas, continuation)\n      }),\n    ),\n  )\n\ndescribe(\"Loop.loop - LLM-style scenarios\", () => {\n  it(\"forwards text deltas, tool start, tool result, and post-tool text in order\", async () => {\n    const m = scriptedModel([\n      [\n        { type: \"text\", text: \"hello\" },\n        { type: \"text\", text: \" \" },\n        { type: \"text\", text: \"world\" },\n        { type: \"tool_call\", id: \"c1\", name: \"get_time\" },\n      ],\n      [\n        { type: \"text\", text: \" time is \" },\n        { type: \"text\", text: \"12:00\" },\n      ],\n    ])\n\n    const runTool: ToolRunner = (call) => ({\n      output: call.name === \"get_time\" ? \"12:00\" : \"?\",\n    })\n\n    const initial: State = {\n      history: [{ type: \"user\", text: \"what time is it?\" }],\n      model: m,\n    }\n\n    const events = await Effect.runPromise(Stream.runCollect(conversationLoop(initial, runTool)))\n\n    expect(events).toEqual([\n      { type: \"text\", text: \"hello\" },\n      { type: \"text\", text: \" \" },\n      { type: \"text\", text: \"world\" },\n      { type: \"tool_started\", id: \"c1\", name: \"get_time\" },\n      { type: \"tool_result\", id: \"c1\", output: \"12:00\" },\n      { type: \"text\", text: \" time is \" },\n      { type: \"text\", text: \"12:00\" },\n    ])\n  })\n\n  it(\"model swap mid-stream: m1 calls upgrade, m2 finishes the response\", async () => {\n    const m2 = scriptedModel([\n      [\n        { type: \"text\", text: \"I am m2.\" },\n        { type: \"text\", text: \" The answer is 42.\" },\n      ],\n    ])\n\n    const m1 = scriptedModel([\n      [\n        { type: \"text\", text: \"Hard question.\" },\n        { type: \"text\", text: \" Upgrading.\" },\n        { type: \"tool_call\", id: \"u1\", name: \"upgrade\" },\n      ],\n    ])\n\n    const runTool: ToolRunner = (call) =>\n      call.name === \"upgrade\" ? { output: \"ok\", nextModel: m2 } : { output: \"?\" }\n\n    const initial: State = {\n      history: [{ type: \"user\", text: \"what is the meaning of life?\" }],\n      model: m1,\n    }\n\n    const events = await Effect.runPromise(Stream.runCollect(conversationLoop(initial, runTool)))\n\n    expect(events).toEqual([\n      { type: \"text\", text: \"Hard question.\" },\n      { type: \"text\", text: \" Upgrading.\" },\n      { type: \"tool_started\", id: \"u1\", name: \"upgrade\" },\n      { type: \"tool_result\", id: \"u1\", output: \"ok\" },\n      { type: \"text\", text: \"I am m2.\" },\n      { type: \"text\", text: \" The answer is 42.\" },\n    ])\n  })\n})\n\ndescribe(\"Loop.loop - pull-specific stream semantics\", () => {\n  it(\"does not start the next iteration when downstream only takes the first value\", async () => {\n    const bodyCalls = await Effect.runPromise(\n      Effect.gen(function* () {\n        const callsRef = yield* Ref.make(0)\n        const stream = loop(0, (n: number) =>\n          Stream.unwrap(\n            Ref.update(callsRef, (calls) => calls + 1).pipe(\n              Effect.as(\n                n >= 10\n                  ? Stream.fromIterable([value(n), stopEvent])\n                  : Stream.fromIterable([value(n), next(n + 1)]),\n              ),\n            ),\n          ),\n        )\n\n        yield* stream.pipe(Stream.take(1), Stream.runCollect)\n        return yield* Ref.get(callsRef)\n      }),\n    )\n\n    expect(bodyCalls).toBe(1)\n  })\n\n  it(\"propagates defects from the body instead of leaving the consumer waiting\", async () => {\n    const defect = new Error(\"defect\")\n    const stream = loop(0, () => Stream.die(defect))\n\n    const result = await Effect.runPromiseExit(Stream.runCollect(stream))\n\n    expect(result._tag).toBe(\"Failure\")\n  })\n\n  it(\"runs body finalizers when a Decision short-circuits the body\", async () => {\n    const releases = await Effect.runPromise(\n      Effect.gen(function* () {\n        const releasesRef = yield* Ref.make<ReadonlyArray<number>>([])\n        const stream = loop(0, (n: number) =>\n          (n >= 1\n            ? Stream.fromIterable([value(n), stopEvent])\n            : Stream.fromIterable([value(n), next(n + 1), value(n + 10)])\n          ).pipe(Stream.ensuring(Ref.update(releasesRef, (values) => [...values, n]))),\n        )\n\n        const values = yield* Stream.runCollect(stream)\n        expect(values).toEqual([0, 1])\n        return yield* Ref.get(releasesRef)\n      }),\n    )\n\n    expect(releases).toEqual([0, 1])\n  })\n\n  it(\"runs the active body finalizer when the downstream consumer is interrupted\", async () => {\n    const releases = await Effect.runPromise(\n      Effect.gen(function* () {\n        const started = yield* Deferred.make<void>()\n        const releasesRef = yield* Ref.make(0)\n        const body = (): Stream.Stream<Event<number, never>> =>\n          Stream.concat(\n            Stream.fromEffect(Deferred.succeed(started, undefined).pipe(Effect.as(value(0)))),\n            Stream.never,\n          ).pipe(Stream.ensuring(Ref.update(releasesRef, (n) => n + 1)))\n        const stream = loop(0, body)\n\n        const fiber = yield* Effect.forkChild(Stream.runCollect(stream))\n        yield* Deferred.await(started)\n        yield* Fiber.interrupt(fiber)\n\n        return yield* Ref.get(releasesRef)\n      }),\n    )\n\n    expect(releases).toBe(1)\n  })\n\n  it(\"does not create a body scope if constructing the body stream defects\", async () => {\n    const defect = new Error(\"body construction failed\")\n    const result = await Effect.runPromiseExit(\n      Stream.runCollect(\n        loop(0, (): Stream.Stream<Event<number, never>> => {\n          throw defect\n        }),\n      ),\n    )\n\n    expect(result._tag).toBe(\"Failure\")\n  })\n})\n\ndescribe(\"Loop.loopWithState\", () => {\n  it(\"exposes the final state in the SubscriptionRef after the stream completes\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        n >= 3 ? stopAfter(Stream.fromIterable([n])) : nextAfter(Stream.fromIterable([n]), n + 1),\n      )\n      const values = yield* Stream.runCollect(stream)\n      const finalState = yield* SubscriptionRef.get(state)\n      return { values: Array.from(values), finalState }\n    })\n\n    const { values, finalState } = await Effect.runPromise(program)\n    expect(values).toEqual([0, 1, 2, 3])\n    // Last `next(state)` was `next(3)` before the iteration that emitted Stop.\n    expect(finalState).toBe(3)\n  })\n\n  it(\"the state ref starts at `initial` and stays there if the loop stops without advancing\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState({ count: 7 }, () =>\n        Stream.fromIterable([stopEvent]),\n      )\n      yield* Stream.runDrain(stream)\n      return yield* SubscriptionRef.get(state)\n    })\n\n    expect(await Effect.runPromise(program)).toEqual({ count: 7 })\n  })\n\n  it(\"a downstream consumer can read the live state between emitted values\", async () => {\n    // Body emits one value per iteration, then advances. A `Stream.runForEach`\n    // consumer reads the ref each time a value arrives — proving the ref\n    // tracks loop state without the body needing to surface it.\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        n >= 3 ? stopAfter(Stream.fromIterable([n])) : nextAfter(Stream.fromIterable([n]), n + 1),\n      )\n      const seen: Array<{ value: number; stateAfter: number }> = []\n      yield* Stream.runForEach(stream, (v) =>\n        Effect.gen(function* () {\n          seen.push({ value: v, stateAfter: yield* SubscriptionRef.get(state) })\n        }),\n      )\n      return seen\n    })\n\n    // For each iter `n`, the consumer reads the ref between values: it sees\n    // the iteration's input state. The terminal iter (n=3) stops without\n    // advancing, so its read still shows 3.\n    expect(await Effect.runPromise(program)).toEqual([\n      { value: 0, stateAfter: 0 },\n      { value: 1, stateAfter: 1 },\n      { value: 2, stateAfter: 2 },\n      { value: 3, stateAfter: 3 },\n    ])\n  })\n\n  it(\"SubscriptionRef.changes emits every state transition to a concurrent observer\", async () => {\n    const program = Effect.gen(function* () {\n      const start = yield* Latch.make(false)\n\n      // Body waits on the latch in iter 0 so the observer can subscribe first.\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        Effect.gen(function* () {\n          if (n === 0) yield* Latch.await(start)\n          return n >= 3 ? stopAfter(Stream.empty) : nextAfter(Stream.empty, n + 1)\n        }),\n      )\n\n      // Fork the observer; take 4 distinct states (initial + 3 transitions).\n      const observerFiber = yield* Effect.forkChild(\n        SubscriptionRef.changes(state).pipe(Stream.take(4), Stream.runCollect),\n      )\n\n      // Give the observer fiber a chance to actually subscribe before the\n      // loop starts advancing the ref. Without this, the loop could finish\n      // before the observer's pubsub subscription is in place.\n      yield* Effect.sleep(\"10 millis\")\n\n      yield* Latch.open(start)\n      yield* Stream.runDrain(stream)\n\n      return Array.from(yield* Fiber.join(observerFiber))\n    })\n\n    // initial 0, then next(1), next(2), next(3) — four distinct states.\n    expect(await Effect.runPromise(program)).toEqual([0, 1, 2, 3])\n  })\n\n  it(\"does not interfere with the body's value stream\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream } = yield* loopWithState(0, (n: number) =>\n        n >= 3\n          ? stopAfter(Stream.fromIterable([n]))\n          : nextAfter(Stream.fromIterable([n, n + 0.5]), n + 1),\n      )\n      return Array.from(yield* Stream.runCollect(stream))\n    })\n\n    expect(await Effect.runPromise(program)).toEqual([0, 0.5, 1, 1.5, 2, 2.5, 3])\n  })\n})\n"],"mappings":"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"}
+{"version":3,"file":"Loop.test.mjs","names":["AiError.RateLimited"],"sources":["../../src/loop/Loop.test.ts"],"sourcesContent":["import { Deferred, Effect, Fiber, Latch, pipe, Ref, Stream, SubscriptionRef } from \"effect\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport * as AiError from \"../domain/AiError.js\"\nimport { TurnEvent } from \"../domain/Turn.js\"\nimport {\n  type Event,\n  loop,\n  loopFrom,\n  loopWithState,\n  next,\n  nextAfter,\n  onTurnComplete,\n  stop,\n  stopAfter,\n  stopEvent,\n  stopWith,\n  value,\n} from \"./Loop.js\"\n\ndescribe(\"Loop.loop\", () => {\n  it(\"threads state across iterations and emits each iteration's substream in order\", async () => {\n    // Each iter emits [n, n + 0.5] then continues; final iter emits [n] and stops.\n    const stream = loop(0, (n: number) =>\n      n >= 3\n        ? stopAfter(Stream.fromIterable([n]))\n        : nextAfter(Stream.fromIterable([n, n + 0.5]), n + 1),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 0.5, 1, 1.5, 2, 2.5, 3])\n  })\n\n  it(\"supports iterations that emit zero values and only decide\", async () => {\n    // Every iteration emits nothing, just bumps state; stops at 5.\n    const stream = loop(0, (n: number) =>\n      n >= 5 ? Stream.fromIterable([stopEvent]) : Stream.fromIterable([next(n + 1)]),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([])\n  })\n\n  it(\"supports Effect-returning bodies directly (no Stream.unwrap needed)\", async () => {\n    // Each iter yields an Effect that doubles the state, then emits it.\n    // Body returns Effect<Stream> directly; loop unwraps internally.\n    const stream = loop(1, (n: number) =>\n      Effect.gen(function* () {\n        const doubled = yield* Effect.succeed(n * 2)\n        return doubled >= 16\n          ? stopAfter(Stream.fromIterable([doubled]))\n          : nextAfter(Stream.fromIterable([doubled]), doubled)\n      }),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([2, 4, 8, 16])\n  })\n\n  it(\"still accepts Stream.unwrap-wrapped bodies for backward compatibility\", async () => {\n    const stream = loop(1, (n: number) =>\n      Stream.unwrap(\n        Effect.gen(function* () {\n          const doubled = yield* Effect.succeed(n * 2)\n          return doubled >= 4\n            ? stopAfter(Stream.fromIterable([doubled]))\n            : nextAfter(Stream.fromIterable([doubled]), doubled)\n        }),\n      ),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([2, 4])\n  })\n\n  it(\"propagates errors from the body's stream\", async () => {\n    const boom = new Error(\"boom\")\n    const stream = loop(\n      0,\n      (n: number): Stream.Stream<Event<number, number>, Error> =>\n        n === 2 ? Stream.fail(boom) : Stream.fromIterable([value(n), next(n + 1)]),\n    )\n\n    const result = await Effect.runPromiseExit(Stream.runCollect(stream))\n    expect(result._tag).toBe(\"Failure\")\n  })\n\n  it(\"terminates silently if the body emits no Decision (mirrors paginate's silent stop)\", async () => {\n    // No decision emitted - loop just ends after the body's stream completes.\n    const stream = loop(0, (n: number) => Stream.fromIterable([value(n), value(n + 1)]))\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 1])\n  })\n\n  it(\"short-circuits the body's stream when a Decision is seen\", async () => {\n    // Body emits [n, next(n+1), n+10]. Once the Decision is encountered, the\n    // body's stream is interrupted - `n+10` is never pulled, so it never\n    // flows to the outer stream. This is the correct behavior: a Decision\n    // marks \"I'm done with this iteration\"; anything after it is dead code.\n    const stream = loop(0, (n: number) =>\n      n >= 2\n        ? Stream.fromIterable([value(n), stopEvent])\n        : Stream.fromIterable([value(n), next(n + 1), value(n + 10)]),\n    )\n\n    const result = await Effect.runPromise(Stream.runCollect(stream))\n    expect(result).toEqual([0, 1, 2])\n  })\n\n  it(\"type: data-last (pipe) form preserves the body's E channel\", () => {\n    // Regression for the prior inference bug: when used as\n    // `pipe(initial, loop(body))`, the body's E must propagate to the outer\n    // stream instead of collapsing to `never`. Generics live on the outer\n    // return of each overload, so neither calling form can erase them.\n    const result = pipe(\n      { count: 0 },\n      loop((_state) => Stream.fail(new AiError.RateLimited({ provider: \"test\", raw: null }))),\n    )\n    type E = typeof result extends Stream.Stream<unknown, infer X, unknown> ? X : never\n    expectTypeOf<E>().toEqualTypeOf<AiError.RateLimited>()\n  })\n\n  it(\"type: data-first form preserves the body's E channel\", () => {\n    const result = loop({ count: 0 }, (_state) =>\n      Stream.fail(new AiError.RateLimited({ provider: \"test\", raw: null })),\n    )\n    type E = typeof result extends Stream.Stream<unknown, infer X, unknown> ? X : never\n    expectTypeOf<E>().toEqualTypeOf<AiError.RateLimited>()\n  })\n\n  it(\"type: onTurnComplete inside loop infers S and A from the handler without annotation\", () => {\n    // Regression: when piped through loop, onTurnComplete's handler return\n    // type (Stream<Event<A, S>>) is the single source of truth for the loop\n    // body's element type. The previous workaround required explicit\n    // <S, A> at the call site. Now the loop's outer-return generics pull\n    // them through automatically.\n    type LoopState = { readonly turns: number }\n    type ToolEvent = { readonly _tag: \"tool\"; readonly name: string }\n\n    const result = pipe(\n      { turns: 0 } as LoopState,\n      loop((state) =>\n        Effect.gen(function* () {\n          const deltas: Stream.Stream<TurnEvent> = Stream.empty\n          return deltas.pipe(\n            onTurnComplete(() =>\n              Effect.sync(() =>\n                state.turns >= 1\n                  ? stop\n                  : nextAfter(Stream.succeed<ToolEvent>({ _tag: \"tool\", name: \"x\" }), {\n                      turns: state.turns + 1,\n                    }),\n              ),\n            ),\n          )\n        }),\n      ),\n    )\n\n    type Element = typeof result extends Stream.Stream<infer X, unknown, unknown> ? X : never\n    expectTypeOf<Element>().toEqualTypeOf<TurnEvent | ToolEvent>()\n  })\n\n  it(\"onTurnComplete: data-first form (Function.dual) works at runtime\", async () => {\n    // Pin both calling forms: deltas.pipe(onTurnComplete(handler)) and\n    // onTurnComplete(deltas, handler). Same dispatch as loop's dual.\n    const turnComplete: TurnEvent = TurnEvent.TurnComplete({\n      turn: { items: [], usage: { input_tokens: 0, output_tokens: 0 }, stop_reason: \"stop\" },\n    })\n    const textDelta: TurnEvent = TurnEvent.TextDelta({ text: \"hi\" })\n    const deltas: Stream.Stream<TurnEvent> = Stream.fromIterable([textDelta, turnComplete])\n\n    const dataFirst = onTurnComplete(deltas, () => Effect.sync(() => stop))\n    const dataLast = deltas.pipe(onTurnComplete(() => Effect.sync(() => stop)))\n\n    const a = await Effect.runPromise(Stream.runCollect(dataFirst))\n    const b = await Effect.runPromise(Stream.runCollect(dataLast))\n\n    // Two value(delta) wraps + one stop sentinel from the handler.\n    expect(a.length).toBe(3)\n    expect(b.length).toBe(3)\n  })\n\n  it(\"is stack-safe and linear-time across many iterations\", async () => {\n    // 100k iterations far exceeds V8's typical stack depth (~10–15k frames).\n    const N = 100_000\n    const stream = loop(0, (n: number) =>\n      n >= N\n        ? Stream.fromIterable([value(n), stopEvent])\n        : Stream.fromIterable([value(n), next(n + 1)]),\n    )\n\n    const count = await Effect.runPromise(\n      Stream.runFold(\n        stream,\n        (): number => 0,\n        (acc) => acc + 1,\n      ),\n    )\n    expect(count).toBe(N + 1) // 0..N inclusive\n  }, 10_000)\n})\n\n// ---------------------------------------------------------------------------\n// Mock LLM scenario - proves the loop forwards deltas in real time and\n// correctly threads tool-result events between turns.\n// ---------------------------------------------------------------------------\n\ntype Delta =\n  | { readonly type: \"text\"; readonly text: string }\n  | { readonly type: \"tool_call\"; readonly id: string; readonly name: string }\n\ntype HistoryItem =\n  | { readonly type: \"user\"; readonly text: string }\n  | { readonly type: \"assistant\"; readonly text: string }\n  | { readonly type: \"tool_call\"; readonly id: string; readonly name: string }\n  | { readonly type: \"tool_result\"; readonly id: string; readonly output: string }\n\ntype UiEvent =\n  | { readonly type: \"text\"; readonly text: string }\n  | { readonly type: \"tool_started\"; readonly id: string; readonly name: string }\n  | { readonly type: \"tool_result\"; readonly id: string; readonly output: string }\n\ninterface MockModel {\n  readonly streamTurn: (history: ReadonlyArray<HistoryItem>) => Stream.Stream<Delta>\n}\n\ninterface State {\n  readonly history: ReadonlyArray<HistoryItem>\n  readonly model: MockModel\n}\n\ninterface ToolOutcome {\n  readonly output: string\n  readonly nextModel?: MockModel\n}\n\ntype ToolRunner = (call: { id: string; name: string }) => ToolOutcome\n\nconst scriptedModel = (script: ReadonlyArray<ReadonlyArray<Delta>>): MockModel => {\n  let i = 0\n  return {\n    streamTurn: () => {\n      const turn = script[i] ?? []\n      i += 1\n      return Stream.fromIterable(turn)\n    },\n  }\n}\n\n/**\n * Body factored out so both tests share it. Per iteration:\n *   1. Stream the model's deltas; tap captures texts + tool calls into Refs.\n *   2. flatMap projects deltas into UiEvents forwarded to the outer stream.\n *   3. Continuation reads the captured calls; if any, runs them, emits\n *      tool_result events, builds the next state (with model swap if a tool\n *      asked for one), and emits `next(state)`. Otherwise `stop`.\n */\nconst conversationLoop = (initial: State, runTool: ToolRunner) =>\n  loop(initial, (state) =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const textsRef = yield* Ref.make<ReadonlyArray<string>>([])\n        const toolCallsRef = yield* Ref.make<\n          ReadonlyArray<{ readonly id: string; readonly name: string }>\n        >([])\n\n        const deltas: Stream.Stream<Event<UiEvent, State>> = state.model\n          .streamTurn(state.history)\n          .pipe(\n            Stream.tap((d) =>\n              d.type === \"text\"\n                ? Ref.update(textsRef, (t) => [...t, d.text])\n                : Ref.update(toolCallsRef, (t) => [...t, { id: d.id, name: d.name }]),\n            ),\n            Stream.flatMap(\n              (d): Stream.Stream<Event<UiEvent, State>> =>\n                d.type === \"text\"\n                  ? Stream.fromIterable([value<UiEvent>({ type: \"text\", text: d.text })])\n                  : Stream.fromIterable([\n                      value<UiEvent>({ type: \"tool_started\", id: d.id, name: d.name }),\n                    ]),\n            ),\n          )\n\n        const continuation: Stream.Stream<Event<UiEvent, State>> = Stream.unwrap(\n          Effect.gen(function* () {\n            const texts = yield* Ref.get(textsRef)\n            const toolCalls = yield* Ref.get(toolCallsRef)\n\n            if (toolCalls.length === 0) {\n              return stopAfter(Stream.empty)\n            }\n\n            const turnItems: ReadonlyArray<HistoryItem> = [\n              ...(texts.length > 0 ? [{ type: \"assistant\" as const, text: texts.join(\"\") }] : []),\n              ...toolCalls.map(\n                (tc): HistoryItem => ({ type: \"tool_call\", id: tc.id, name: tc.name }),\n              ),\n            ]\n\n            const outcomes = toolCalls.map((call) => ({ call, outcome: runTool(call) }))\n\n            const events: ReadonlyArray<UiEvent> = outcomes.map(({ call, outcome }) => ({\n              type: \"tool_result\",\n              id: call.id,\n              output: outcome.output,\n            }))\n\n            const resultItems: ReadonlyArray<HistoryItem> = outcomes.map(\n              ({ call, outcome }): HistoryItem => ({\n                type: \"tool_result\",\n                id: call.id,\n                output: outcome.output,\n              }),\n            )\n\n            // Last requested model wins; default to the current one.\n            const nextModel = outcomes.reduce(\n              (m, { outcome }) => outcome.nextModel ?? m,\n              state.model,\n            )\n\n            const nextState: State = {\n              history: [...state.history, ...turnItems, ...resultItems],\n              model: nextModel,\n            }\n\n            return nextAfter(Stream.fromIterable(events), nextState)\n          }),\n        )\n\n        return Stream.concat(deltas, continuation)\n      }),\n    ),\n  )\n\ndescribe(\"Loop.loop - LLM-style scenarios\", () => {\n  it(\"forwards text deltas, tool start, tool result, and post-tool text in order\", async () => {\n    const m = scriptedModel([\n      [\n        { type: \"text\", text: \"hello\" },\n        { type: \"text\", text: \" \" },\n        { type: \"text\", text: \"world\" },\n        { type: \"tool_call\", id: \"c1\", name: \"get_time\" },\n      ],\n      [\n        { type: \"text\", text: \" time is \" },\n        { type: \"text\", text: \"12:00\" },\n      ],\n    ])\n\n    const runTool: ToolRunner = (call) => ({\n      output: call.name === \"get_time\" ? \"12:00\" : \"?\",\n    })\n\n    const initial: State = {\n      history: [{ type: \"user\", text: \"what time is it?\" }],\n      model: m,\n    }\n\n    const events = await Effect.runPromise(Stream.runCollect(conversationLoop(initial, runTool)))\n\n    expect(events).toEqual([\n      { type: \"text\", text: \"hello\" },\n      { type: \"text\", text: \" \" },\n      { type: \"text\", text: \"world\" },\n      { type: \"tool_started\", id: \"c1\", name: \"get_time\" },\n      { type: \"tool_result\", id: \"c1\", output: \"12:00\" },\n      { type: \"text\", text: \" time is \" },\n      { type: \"text\", text: \"12:00\" },\n    ])\n  })\n\n  it(\"model swap mid-stream: m1 calls upgrade, m2 finishes the response\", async () => {\n    const m2 = scriptedModel([\n      [\n        { type: \"text\", text: \"I am m2.\" },\n        { type: \"text\", text: \" The answer is 42.\" },\n      ],\n    ])\n\n    const m1 = scriptedModel([\n      [\n        { type: \"text\", text: \"Hard question.\" },\n        { type: \"text\", text: \" Upgrading.\" },\n        { type: \"tool_call\", id: \"u1\", name: \"upgrade\" },\n      ],\n    ])\n\n    const runTool: ToolRunner = (call) =>\n      call.name === \"upgrade\" ? { output: \"ok\", nextModel: m2 } : { output: \"?\" }\n\n    const initial: State = {\n      history: [{ type: \"user\", text: \"what is the meaning of life?\" }],\n      model: m1,\n    }\n\n    const events = await Effect.runPromise(Stream.runCollect(conversationLoop(initial, runTool)))\n\n    expect(events).toEqual([\n      { type: \"text\", text: \"Hard question.\" },\n      { type: \"text\", text: \" Upgrading.\" },\n      { type: \"tool_started\", id: \"u1\", name: \"upgrade\" },\n      { type: \"tool_result\", id: \"u1\", output: \"ok\" },\n      { type: \"text\", text: \"I am m2.\" },\n      { type: \"text\", text: \" The answer is 42.\" },\n    ])\n  })\n})\n\ndescribe(\"Loop.loop - pull-specific stream semantics\", () => {\n  it(\"does not start the next iteration when downstream only takes the first value\", async () => {\n    const bodyCalls = await Effect.runPromise(\n      Effect.gen(function* () {\n        const callsRef = yield* Ref.make(0)\n        const stream = loop(0, (n: number) =>\n          Stream.unwrap(\n            Ref.update(callsRef, (calls) => calls + 1).pipe(\n              Effect.as(\n                n >= 10\n                  ? Stream.fromIterable([value(n), stopEvent])\n                  : Stream.fromIterable([value(n), next(n + 1)]),\n              ),\n            ),\n          ),\n        )\n\n        yield* stream.pipe(Stream.take(1), Stream.runCollect)\n        return yield* Ref.get(callsRef)\n      }),\n    )\n\n    expect(bodyCalls).toBe(1)\n  })\n\n  it(\"propagates defects from the body instead of leaving the consumer waiting\", async () => {\n    const defect = new Error(\"defect\")\n    const stream = loop(0, () => Stream.die(defect))\n\n    const result = await Effect.runPromiseExit(Stream.runCollect(stream))\n\n    expect(result._tag).toBe(\"Failure\")\n  })\n\n  it(\"runs body finalizers when a Decision short-circuits the body\", async () => {\n    const releases = await Effect.runPromise(\n      Effect.gen(function* () {\n        const releasesRef = yield* Ref.make<ReadonlyArray<number>>([])\n        const stream = loop(0, (n: number) =>\n          (n >= 1\n            ? Stream.fromIterable([value(n), stopEvent])\n            : Stream.fromIterable([value(n), next(n + 1), value(n + 10)])\n          ).pipe(Stream.ensuring(Ref.update(releasesRef, (values) => [...values, n]))),\n        )\n\n        const values = yield* Stream.runCollect(stream)\n        expect(values).toEqual([0, 1])\n        return yield* Ref.get(releasesRef)\n      }),\n    )\n\n    expect(releases).toEqual([0, 1])\n  })\n\n  it(\"runs the active body finalizer when the downstream consumer is interrupted\", async () => {\n    const releases = await Effect.runPromise(\n      Effect.gen(function* () {\n        const started = yield* Deferred.make<void>()\n        const releasesRef = yield* Ref.make(0)\n        const body = (): Stream.Stream<Event<number, never>> =>\n          Stream.concat(\n            Stream.fromEffect(Deferred.succeed(started, undefined).pipe(Effect.as(value(0)))),\n            Stream.never,\n          ).pipe(Stream.ensuring(Ref.update(releasesRef, (n) => n + 1)))\n        const stream = loop(0, body)\n\n        const fiber = yield* Effect.forkChild(Stream.runCollect(stream))\n        yield* Deferred.await(started)\n        yield* Fiber.interrupt(fiber)\n\n        return yield* Ref.get(releasesRef)\n      }),\n    )\n\n    expect(releases).toBe(1)\n  })\n\n  it(\"does not create a body scope if constructing the body stream defects\", async () => {\n    const defect = new Error(\"body construction failed\")\n    const result = await Effect.runPromiseExit(\n      Stream.runCollect(\n        loop(0, (): Stream.Stream<Event<number, never>> => {\n          throw defect\n        }),\n      ),\n    )\n\n    expect(result._tag).toBe(\"Failure\")\n  })\n})\n\ndescribe(\"Loop.loopWithState\", () => {\n  it(\"exposes the final state in the SubscriptionRef after the stream completes\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        n >= 3 ? stopAfter(Stream.fromIterable([n])) : nextAfter(Stream.fromIterable([n]), n + 1),\n      )\n      const values = yield* Stream.runCollect(stream)\n      const finalState = yield* SubscriptionRef.get(state)\n      return { values: Array.from(values), finalState }\n    })\n\n    const { values, finalState } = await Effect.runPromise(program)\n    expect(values).toEqual([0, 1, 2, 3])\n    // Last `next(state)` was `next(3)` before the iteration that emitted Stop.\n    expect(finalState).toBe(3)\n  })\n\n  it(\"the state ref starts at `initial` and stays there if the loop stops without advancing\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState({ count: 7 }, () =>\n        Stream.fromIterable([stopEvent]),\n      )\n      yield* Stream.runDrain(stream)\n      return yield* SubscriptionRef.get(state)\n    })\n\n    expect(await Effect.runPromise(program)).toEqual({ count: 7 })\n  })\n\n  it(\"a downstream consumer can read the live state between emitted values\", async () => {\n    // Body emits one value per iteration, then advances. A `Stream.runForEach`\n    // consumer reads the ref each time a value arrives — proving the ref\n    // tracks loop state without the body needing to surface it.\n    const program = Effect.gen(function* () {\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        n >= 3 ? stopAfter(Stream.fromIterable([n])) : nextAfter(Stream.fromIterable([n]), n + 1),\n      )\n      const seen: Array<{ value: number; stateAfter: number }> = []\n      yield* Stream.runForEach(stream, (v) =>\n        Effect.gen(function* () {\n          seen.push({ value: v, stateAfter: yield* SubscriptionRef.get(state) })\n        }),\n      )\n      return seen\n    })\n\n    // For each iter `n`, the consumer reads the ref between values: it sees\n    // the iteration's input state. The terminal iter (n=3) stops without\n    // advancing, so its read still shows 3.\n    expect(await Effect.runPromise(program)).toEqual([\n      { value: 0, stateAfter: 0 },\n      { value: 1, stateAfter: 1 },\n      { value: 2, stateAfter: 2 },\n      { value: 3, stateAfter: 3 },\n    ])\n  })\n\n  it(\"SubscriptionRef.changes emits every state transition to a concurrent observer\", async () => {\n    const program = Effect.gen(function* () {\n      const start = yield* Latch.make(false)\n\n      // Body waits on the latch in iter 0 so the observer can subscribe first.\n      const { stream, state } = yield* loopWithState(0, (n: number) =>\n        Effect.gen(function* () {\n          if (n === 0) yield* Latch.await(start)\n          return n >= 3 ? stopAfter(Stream.empty) : nextAfter(Stream.empty, n + 1)\n        }),\n      )\n\n      // Fork the observer; take 4 distinct states (initial + 3 transitions).\n      const observerFiber = yield* Effect.forkChild(\n        SubscriptionRef.changes(state).pipe(Stream.take(4), Stream.runCollect),\n      )\n\n      // Give the observer fiber a chance to actually subscribe before the\n      // loop starts advancing the ref. Without this, the loop could finish\n      // before the observer's pubsub subscription is in place.\n      yield* Effect.sleep(\"10 millis\")\n\n      yield* Latch.open(start)\n      yield* Stream.runDrain(stream)\n\n      return Array.from(yield* Fiber.join(observerFiber))\n    })\n\n    // initial 0, then next(1), next(2), next(3) — four distinct states.\n    expect(await Effect.runPromise(program)).toEqual([0, 1, 2, 3])\n  })\n\n  it(\"does not interfere with the body's value stream\", async () => {\n    const program = Effect.gen(function* () {\n      const { stream } = yield* loopWithState(0, (n: number) =>\n        n >= 3\n          ? stopAfter(Stream.fromIterable([n]))\n          : nextAfter(Stream.fromIterable([n, n + 0.5]), n + 1),\n      )\n      return Array.from(yield* Stream.runCollect(stream))\n    })\n\n    expect(await Effect.runPromise(program)).toEqual([0, 0.5, 1, 1.5, 2, 2.5, 3])\n  })\n})\n\ndescribe(\"Loop.loopFrom\", () => {\n  it(\"runs a multi-turn inner loop per input until the body emits stop\", async () => {\n    // Per input: emit (input + turnsSoFar) twice, then stop. State counts\n    // total turns ACROSS inputs. Demonstrates that `next(s)` continues with\n    // the SAME input, multiple times per input — not one body call per item.\n    const result = await Effect.runPromise(\n      Stream.fromIterable([\"a\", \"b\"]).pipe(\n        loopFrom(0, (turns: number, input: string) => {\n          if (turns >= 2 * (input === \"a\" ? 1 : 2)) return Stream.fromIterable([stopEvent])\n          return Stream.fromIterable([value(`${input}:${turns}`), next(turns + 1)])\n        }),\n        Stream.runCollect,\n      ),\n    )\n\n    // input=\"a\": turns 0,1 → emit \"a:0\",\"a:1\"; turns=2 → stop. State threads.\n    // input=\"b\": turns 2,3 → emit \"b:2\",\"b:3\"; turns=4 → stop.\n    expect(result).toEqual([\"a:0\", \"a:1\", \"b:2\", \"b:3\"])\n  })\n\n  it(\"threads state across inputs (audio-pipeline shape)\", async () => {\n    // History accumulates across inputs. Each input emits its joined view of\n    // history+input, then `stopWith` ends the inner loop AND carries the\n    // updated history to the next input.\n    const result = await Effect.runPromise(\n      Stream.fromIterable([\"x\", \"y\", \"z\"]).pipe(\n        loopFrom([] as ReadonlyArray<string>, (history: ReadonlyArray<string>, input: string) =>\n          Stream.fromIterable([\n            value([...history, input].join(\",\")),\n            stopWith([...history, input]),\n          ]),\n        ),\n        Stream.runCollect,\n      ),\n    )\n\n    expect(result).toEqual([\"x\", \"x,y\", \"x,y,z\"])\n  })\n\n  it(\"simulates a stream of documents with multi-turn tool calls per document\", async () => {\n    // Document arrives → model \"thinks\" (one text turn) → calls a tool\n    // (one tool turn) → emits final text (one text turn) → done.\n    // Three turns per document, two documents.\n    type Turn =\n      | { readonly kind: \"text\"; readonly doc: string; readonly text: string }\n      | { readonly kind: \"tool\"; readonly doc: string; readonly tool: string }\n    type State = { readonly turn: number; readonly totalTurns: number }\n\n    const result = await Effect.runPromise(\n      Stream.fromIterable([\"doc1\", \"doc2\"]).pipe(\n        loopFrom({ turn: 0, totalTurns: 0 } as State, (state, doc: string) => {\n          // Each document runs three turns then stops.\n          if (state.turn === 0) {\n            return Stream.fromIterable([\n              value<Turn>({ kind: \"text\", doc, text: \"thinking\" }),\n              next({ turn: 1, totalTurns: state.totalTurns + 1 }),\n            ])\n          }\n          if (state.turn === 1) {\n            return Stream.fromIterable([\n              value<Turn>({ kind: \"tool\", doc, tool: \"search\" }),\n              next({ turn: 2, totalTurns: state.totalTurns + 1 }),\n            ])\n          }\n          // Final turn — `stopWith` emits the final value, advances state\n          // (reset turn to 0 for the next document, bump totalTurns), and\n          // ends this document's inner loop in one shot.\n          return Stream.fromIterable([\n            value<Turn>({ kind: \"text\", doc, text: \"final\" }),\n            stopWith({ turn: 0, totalTurns: state.totalTurns + 1 }),\n          ])\n        }),\n        Stream.runCollect,\n      ),\n    )\n\n    expect(result).toEqual([\n      { kind: \"text\", doc: \"doc1\", text: \"thinking\" },\n      { kind: \"tool\", doc: \"doc1\", tool: \"search\" },\n      { kind: \"text\", doc: \"doc1\", text: \"final\" },\n      { kind: \"text\", doc: \"doc2\", text: \"thinking\" },\n      { kind: \"tool\", doc: \"doc2\", tool: \"search\" },\n      { kind: \"text\", doc: \"doc2\", text: \"final\" },\n    ])\n  })\n\n  it(\"ends cleanly when the input stream ends mid-conversation\", async () => {\n    // Single-input case: body advances via `next` then stops cleanly.\n    const result = await Effect.runPromise(\n      Stream.fromIterable([\"only\"]).pipe(\n        loopFrom(0, (turns: number, input: string) =>\n          turns >= 2\n            ? Stream.fromIterable([stopEvent])\n            : Stream.fromIterable([value(`${input}:${turns}`), next(turns + 1)]),\n        ),\n        Stream.runCollect,\n      ),\n    )\n\n    expect(result).toEqual([\"only:0\", \"only:1\"])\n  })\n\n  it(\"body's `stop` advances to the next input (does NOT halt the whole stream)\", async () => {\n    // Three inputs, body always stops on its first emission. All three\n    // are processed — `stop` is per-input, not global. To halt the whole\n    // stream, end the INPUT stream upstream.\n    const result = await Effect.runPromise(\n      Stream.fromIterable([1, 2, 3]).pipe(\n        loopFrom(0, (_state: number, input: number) =>\n          Stream.fromIterable([value(input * 10), stopEvent]),\n        ),\n        Stream.runCollect,\n      ),\n    )\n\n    expect(result).toEqual([10, 20, 30])\n  })\n\n  it(\"data-first form (Function.dual) runs identically to data-last\", async () => {\n    const inputs = Stream.fromIterable([1, 2])\n    const result = await Effect.runPromise(\n      Stream.runCollect(\n        loopFrom(inputs, 0, (state: number, input: number) =>\n          state >= input\n            ? Stream.fromIterable([stopEvent])\n            : Stream.fromIterable([value(state + input), next(state + 1)]),\n        ),\n      ),\n    )\n\n    // input=1: state=0 → emit 1, state→1; state=1≥1 → stop.\n    // input=2: state=1 → emit 3, state→2; state=2≥2 → stop.\n    expect(result).toEqual([1, 3])\n  })\n\n  it(\"supports Effect-returning bodies (parity with loop)\", async () => {\n    const result = await Effect.runPromise(\n      Stream.fromIterable([\"a\"]).pipe(\n        loopFrom(0, (turns: number, input: string) =>\n          Effect.gen(function* () {\n            const cur = yield* Effect.succeed(turns)\n            if (cur >= 2) return Stream.fromIterable([stopEvent])\n            return Stream.fromIterable([value(`${input}:${cur}`), next(cur + 1)])\n          }),\n        ),\n        Stream.runCollect,\n      ),\n    )\n\n    expect(result).toEqual([\"a:0\", \"a:1\"])\n  })\n\n  it(\"type: data-last (pipe) form preserves the body's E channel\", () => {\n    const result = pipe(\n      Stream.fromIterable([1]),\n      loopFrom(0, (_state: number, _input: number) =>\n        Stream.fail(new AiError.RateLimited({ provider: \"test\", raw: null })),\n      ),\n    )\n    type E = typeof result extends Stream.Stream<unknown, infer X, unknown> ? X : never\n    expectTypeOf<E>().toEqualTypeOf<AiError.RateLimited>()\n  })\n\n  it(\"type: data-first form preserves the body's E channel and unifies with input's E\", () => {\n    const input: Stream.Stream<number, Error> = Stream.fail(new Error(\"boom\"))\n    const result = loopFrom(input, 0, (_state: number, _i: number) =>\n      Stream.fail(new AiError.RateLimited({ provider: \"test\", raw: null })),\n    )\n    type E = typeof result extends Stream.Stream<unknown, infer X, unknown> ? X : never\n    expectTypeOf<E>().toEqualTypeOf<AiError.RateLimited | Error>()\n  })\n})\n"],"mappings":"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"}

package/dist/music-generator/MusicGenerator.d.mts

@@ -0,0 +1,77 @@
+import { t as AiError } from "../AiError-CAX_48RU.mjs";
+import { n as AudioChunk } from "../Audio-BfCTGnH3.mjs";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput, WeightedPrompt } from "../domain/Music.mjs";
+import { Context, Effect, Stream } from "effect";
+
+//#region src/music-generator/MusicGenerator.d.ts
+declare namespace MusicGenerator_d_exports {
+  export { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, MusicResult, MusicSessionInput, WeightedPrompt, generate, streamGeneration, streamGenerationFrom };
+}
+type MusicGeneratorService = {
+  /**
+   * One-shot. Prompt in, full audio bytes out. Universally supported.
+   * Async/poll-based providers (Suno, Mureka) hide their poll loop
+   * inside the adapter — caller still sees a single `Effect`.
+   */
+  readonly generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, AiError>;
+  /**
+   * Prompt in, audio chunks streamed out. Providers without a native
+   * chunked-output endpoint (Lyria 3 sync, Mureka, MiniMax, Stable
+   * Audio) emulate this by calling `generate` and emitting a single
+   * `AudioChunk` — first-class, no `Unsupported`.
+   */
+  readonly streamGeneration: (request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError>;
+  /**
+   * Bidirectional session: a `Stream` of prompt-or-config updates flows
+   * in, a `Stream` of audio chunks flows out. The session WS / RPC is
+   * acquired on first pull and released when the output stream is
+   * finalized via `Stream.scoped`.
+   *
+   * Gated by the `MusicInteractiveSession` capability marker on the
+   * top-level helper — providers without bidirectional support don't
+   * ship the marker, so calls fail at `Effect.provide` with a type
+   * error.
+   */
+  readonly streamGenerationFrom: <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError | E, R>;
+};
+declare const MusicGenerator_base: Context.ServiceClass<MusicGenerator, "@betalyra/effect-uai/MusicGenerator", MusicGeneratorService>;
+declare class MusicGenerator extends MusicGenerator_base {}
+declare const MusicInteractiveSession_base: Context.ServiceClass<MusicInteractiveSession, "@betalyra/effect-uai/capability/MusicInteractiveSession", void>;
+/**
+ * Capability marker — provided by provider layers whose
+ * `streamGenerationFrom` is wired up at the wire level. Currently only
+ * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.
+ * Calling `streamGenerationFrom` while only a non-interactive Layer is
+ * in scope fails at `Effect.provide` with a type error.
+ *
+ * Phantom — the value is `void`; providers register with
+ * `Layer.succeed(MusicInteractiveSession, undefined)`.
+ */
+declare class MusicInteractiveSession extends MusicInteractiveSession_base {}
+/** One-shot generation. */
+declare const generate: (request: CommonGenerateMusicRequest) => Effect.Effect<MusicResult, AiError, MusicGenerator>;
+/** Prompt in, audio chunks out. */
+declare const streamGeneration: (request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError, MusicGenerator>;
+/**
+ * Bidirectional generation. Dual-arity: pipeable (data-last) and
+ * direct (data-first). Requires `MusicInteractiveSession` in R —
+ * providers without bidirectional support are a type error at provide
+ * time.
+ *
+ * @example
+ * ```ts
+ * const audio = Stream.fromIterable([
+ *   Music.promptsInput([{ text: "minimal techno", weight: 1.0 }]),
+ *   Music.configInput({ bpm: 124 }),
+ * ]).pipe(
+ *   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-001", prompts: "" }),
+ * )
+ * ```
+ */
+declare const streamGenerationFrom: {
+  (request: CommonStreamGenerateMusicRequest): <E, R>(input: Stream.Stream<MusicSessionInput, E, R>) => Stream.Stream<AudioChunk, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
+  <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest): Stream.Stream<AudioChunk, AiError | E, R | MusicGenerator | MusicInteractiveSession>;
+};
+//#endregion
+export { type CommonGenerateMusicRequest, type CommonStreamGenerateMusicRequest, MusicGenerator, MusicGeneratorService, MusicInteractiveSession, type MusicResult, type MusicSessionInput, type WeightedPrompt, generate, streamGeneration, streamGenerationFrom, MusicGenerator_d_exports as t };
+//# sourceMappingURL=MusicGenerator.d.mts.map

package/dist/music-generator/MusicGenerator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicGenerator.d.mts","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"mappings":";;;;;;;;;KAkBY,qBAAA;;;;;;WAMD,QAAA,GACP,OAAA,EAAS,0BAAA,KACN,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,OAAA;;;;;;;WAOvB,gBAAA,GACP,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA;;AAjBjC;;;;;;;;;;WA6BW,oBAAA,SACP,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA;AAAA;AAAA,cACrD,mBAAA;cAEY,cAAA,SAAuB,mBAAA;AAAA,cAEhC,4BAAA;;;;;;;;;;;cAYS,uBAAA,SAAgC,4BAAA;;cAKhC,QAAA,GACX,OAAA,EAAS,0BAAA,KACR,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,OAAA,EAAiB,cAAA;;cAIlC,gBAAA,GACX,OAAA,EAAS,gCAAA,KACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,EAAiB,cAAA;;;;;;;;;;;;;;;;;cAmBjC,oBAAA;EAAA,CAET,OAAA,EAAS,gCAAA,UAET,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,MACxC,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,cAAA,GAAiB,uBAAA;EAAA,OAEvE,KAAA,EAAO,MAAA,CAAO,MAAA,CAAO,iBAAA,EAAmB,CAAA,EAAG,CAAA,GAC3C,OAAA,EAAS,gCAAA,GACR,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,GAAkB,CAAA,EAAG,CAAA,GAAI,cAAA,GAAiB,uBAAA;AAAA"}

package/dist/music-generator/MusicGenerator.mjs

@@ -0,0 +1,51 @@
+import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { Context, Effect, Function, Stream } from "effect";
+//#region src/music-generator/MusicGenerator.ts
+var MusicGenerator_exports = /* @__PURE__ */ __exportAll({
+	MusicGenerator: () => MusicGenerator,
+	MusicInteractiveSession: () => MusicInteractiveSession,
+	generate: () => generate,
+	streamGeneration: () => streamGeneration,
+	streamGenerationFrom: () => streamGenerationFrom
+});
+var MusicGenerator = class extends Context.Service()("@betalyra/effect-uai/MusicGenerator") {};
+/**
+* Capability marker — provided by provider layers whose
+* `streamGenerationFrom` is wired up at the wire level. Currently only
+* Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.
+* Calling `streamGenerationFrom` while only a non-interactive Layer is
+* in scope fails at `Effect.provide` with a type error.
+*
+* Phantom — the value is `void`; providers register with
+* `Layer.succeed(MusicInteractiveSession, undefined)`.
+*/
+var MusicInteractiveSession = class extends Context.Service()("@betalyra/effect-uai/capability/MusicInteractiveSession") {};
+/** One-shot generation. */
+const generate = (request) => Effect.flatMap(MusicGenerator.asEffect(), (s) => s.generate(request));
+/** Prompt in, audio chunks out. */
+const streamGeneration = (request) => Stream.unwrap(Effect.map(MusicGenerator.asEffect(), (s) => s.streamGeneration(request)));
+/**
+* Bidirectional generation. Dual-arity: pipeable (data-last) and
+* direct (data-first). Requires `MusicInteractiveSession` in R —
+* providers without bidirectional support are a type error at provide
+* time.
+*
+* @example
+* ```ts
+* const audio = Stream.fromIterable([
+*   Music.promptsInput([{ text: "minimal techno", weight: 1.0 }]),
+*   Music.configInput({ bpm: 124 }),
+* ]).pipe(
+*   MusicGenerator.streamGenerationFrom({ model: "lyria-realtime-001", prompts: "" }),
+* )
+* ```
+*/
+const streamGenerationFrom = Function.dual(2, (input, request) => Stream.unwrap(Effect.gen(function* () {
+	const s = yield* MusicGenerator.asEffect();
+	yield* MusicInteractiveSession.asEffect();
+	return s.streamGenerationFrom(input, request);
+})));
+//#endregion
+export { MusicGenerator, MusicInteractiveSession, generate, streamGeneration, streamGenerationFrom, MusicGenerator_exports as t };
+
+//# sourceMappingURL=MusicGenerator.mjs.map

package/dist/music-generator/MusicGenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MusicGenerator.mjs","names":[],"sources":["../../src/music-generator/MusicGenerator.ts"],"sourcesContent":["import { Context, Effect, Function, Stream } from \"effect\"\nimport * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk } from \"../domain/Audio.js\"\nimport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  MusicResult,\n  MusicSessionInput,\n} from \"../domain/Music.js\"\n\nexport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  MusicResult,\n  MusicSessionInput,\n  WeightedPrompt,\n} from \"../domain/Music.js\"\n\nexport type MusicGeneratorService = {\n  /**\n   * One-shot. Prompt in, full audio bytes out. Universally supported.\n   * Async/poll-based providers (Suno, Mureka) hide their poll loop\n   * inside the adapter — caller still sees a single `Effect`.\n   */\n  readonly generate: (\n    request: CommonGenerateMusicRequest,\n  ) => Effect.Effect<MusicResult, AiError.AiError>\n  /**\n   * Prompt in, audio chunks streamed out. Providers without a native\n   * chunked-output endpoint (Lyria 3 sync, Mureka, MiniMax, Stable\n   * Audio) emulate this by calling `generate` and emitting a single\n   * `AudioChunk` — first-class, no `Unsupported`.\n   */\n  readonly streamGeneration: (\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\n  /**\n   * Bidirectional session: a `Stream` of prompt-or-config updates flows\n   * in, a `Stream` of audio chunks flows out. The session WS / RPC is\n   * acquired on first pull and released when the output stream is\n   * finalized via `Stream.scoped`.\n   *\n   * Gated by the `MusicInteractiveSession` capability marker on the\n   * top-level helper — providers without bidirectional support don't\n   * ship the marker, so calls fail at `Effect.provide` with a type\n   * error.\n   */\n  readonly streamGenerationFrom: <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError | E, R>\n}\n\nexport class MusicGenerator extends Context.Service<MusicGenerator, MusicGeneratorService>()(\n  \"@betalyra/effect-uai/MusicGenerator\",\n) {}\n\n/**\n * Capability marker — provided by provider layers whose\n * `streamGenerationFrom` is wired up at the wire level. Currently only\n * Lyria RealTime (via the BidiGenerateMusic WebSocket) ships it.\n * Calling `streamGenerationFrom` while only a non-interactive Layer is\n * in scope fails at `Effect.provide` with a type error.\n *\n * Phantom — the value is `void`; providers register with\n * `Layer.succeed(MusicInteractiveSession, undefined)`.\n */\nexport class MusicInteractiveSession extends Context.Service<MusicInteractiveSession, void>()(\n  \"@betalyra/effect-uai/capability/MusicInteractiveSession\",\n) {}\n\n/** One-shot generation. */\nexport const generate = (\n  request: CommonGenerateMusicRequest,\n): Effect.Effect<MusicResult, AiError.AiError, MusicGenerator> =>\n  Effect.flatMap(MusicGenerator.asEffect(), (s) => s.generate(request))\n\n/** Prompt in, audio chunks out. */\nexport const streamGeneration = (\n  request: CommonStreamGenerateMusicRequest,\n): Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator> =>\n  Stream.unwrap(Effect.map(MusicGenerator.asEffect(), (s) => s.streamGeneration(request)))\n\n/**\n * Bidirectional generation. Dual-arity: pipeable (data-last) and\n * direct (data-first). Requires `MusicInteractiveSession` in R —\n * providers without bidirectional support are a type error at provide\n * time.\n *\n * @example\n * ```ts\n * const audio = Stream.fromIterable([\n *   Music.promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n *   Music.configInput({ bpm: 124 }),\n * ]).pipe(\n *   MusicGenerator.streamGenerationFrom({ model: \"lyria-realtime-001\", prompts: \"\" }),\n * )\n * ```\n */\nexport const streamGenerationFrom: {\n  (\n    request: CommonStreamGenerateMusicRequest,\n  ): <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n  ) => Stream.Stream<AudioChunk, AiError.AiError | E, R | MusicGenerator | MusicInteractiveSession>\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError | E, R | MusicGenerator | MusicInteractiveSession>\n} = Function.dual(\n  2,\n  <E, R>(\n    input: Stream.Stream<MusicSessionInput, E, R>,\n    request: CommonStreamGenerateMusicRequest,\n  ) =>\n    Stream.unwrap(\n      Effect.gen(function* () {\n        const s = yield* MusicGenerator.asEffect()\n        yield* MusicInteractiveSession.asEffect()\n        return s.streamGenerationFrom(input, request)\n      }),\n    ),\n)\n"],"mappings":";;;;;;;;;;AAqDA,IAAa,iBAAb,cAAoC,QAAQ,SAAgD,CAC1F,sCACD,CAAC;;;;;;;;;;;AAYF,IAAa,0BAAb,cAA6C,QAAQ,SAAwC,CAC3F,0DACD,CAAC;;AAGF,MAAa,YACX,YAEA,OAAO,QAAQ,eAAe,UAAU,GAAG,MAAM,EAAE,SAAS,QAAQ,CAAC;;AAGvE,MAAa,oBACX,YAEA,OAAO,OAAO,OAAO,IAAI,eAAe,UAAU,GAAG,MAAM,EAAE,iBAAiB,QAAQ,CAAC,CAAC;;;;;;;;;;;;;;;;;AAkB1F,MAAa,uBAUT,SAAS,KACX,IAEE,OACA,YAEA,OAAO,OACL,OAAO,IAAI,aAAa;CACtB,MAAM,IAAI,OAAO,eAAe,UAAU;AAC1C,QAAO,wBAAwB,UAAU;AACzC,QAAO,EAAE,qBAAqB,OAAO,QAAQ;EAC7C,CACH,CACJ"}

package/dist/music-generator/MusicGenerator.test.d.mts

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