@effect-uai/core 0.11.0 → 0.12.1

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

@@ -1 +1 @@
-{"version":3,"file":"MusicGenerator.test.mjs","names":["MockMusicGenerator.layer","MusicGenerator.generate","MusicGenerator.streamGeneration","MusicGenerator.streamGenerationFrom","MockMusicGenerator.layerWithoutInteractive"],"sources":["../../src/music-generator/MusicGenerator.test.ts"],"sourcesContent":["import { Duration, Effect, Stream } from \"effect\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk, AudioFormat } from \"../domain/Audio.js\"\nimport {\n  audioEvent,\n  controlInput,\n  type GenerateResult,\n  type MusicResult,\n  type MusicStreamEvent,\n  promptsInput,\n  singleVariant,\n} from \"../domain/Music.js\"\nimport * as MockMusicGenerator from \"../testing/MockMusicGenerator.js\"\nimport * as MusicGenerator from \"./MusicGenerator.js\"\n\nconst mp3Format: AudioFormat = {\n  container: \"mp3\",\n  encoding: \"mp3\",\n  sampleRate: 44100,\n  channels: 2,\n}\n\nconst oneResult: MusicResult = {\n  audio: {\n    format: mp3Format,\n    bytes: new Uint8Array([0xff, 0xfb, 0x90, 0x00]),\n    duration: Duration.seconds(30),\n  },\n  provider: \"mock-music\",\n  lyrics: \"[Verse]\\nhello\\n\",\n  watermark: \"synthid\",\n}\n\nconst oneVariant: GenerateResult = singleVariant(oneResult)\n\nconst chunk = (n: number): AudioChunk => ({ bytes: new Uint8Array([n]) })\n\ndescribe(\"MusicGenerator.generate\", () => {\n  it(\"returns the scripted GenerateResult\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant] })\n    const program = MusicGenerator.generate({\n      model: \"mock-music\",\n      prompt: \"upbeat indie pop\",\n    })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.primary.audio.bytes).toEqual(oneResult.audio.bytes)\n    expect(out.primary.audio.duration).toEqual(Duration.seconds(30))\n    expect(out.primary.watermark).toBe(\"synthid\")\n    expect(out.primary.lyrics).toContain(\"[Verse]\")\n    expect(out.variants).toHaveLength(1)\n    expect(out.variants[0]).toBe(out.primary)\n  })\n\n  it(\"exposes multiple variants when the provider returned more than one\", async () => {\n    const secondTrack: MusicResult = {\n      ...oneResult,\n      audio: { ...oneResult.audio, bytes: new Uint8Array([0xff, 0xfb, 0xa0, 0x00]) },\n    }\n    const twoVariants: GenerateResult = {\n      primary: oneResult,\n      variants: [oneResult, secondTrack],\n    }\n    const mock = MockMusicGenerator.layer({ results: [twoVariants] })\n    const program = MusicGenerator.generate({ model: \"m\", prompt: \"house\" })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.variants).toHaveLength(2)\n    expect(out.variants[1]!.audio.bytes).toEqual(secondTrack.audio.bytes)\n  })\n\n  it(\"records the request shape on the recorder\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant, oneVariant] })\n    const program = Effect.gen(function* () {\n      yield* MusicGenerator.generate({ model: \"m\", prompt: \"techno\" })\n      yield* MusicGenerator.generate({\n        model: \"m\",\n        prompt: \"synthwave\",\n        duration: Duration.seconds(45),\n        seed: 42,\n      })\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.generateCalls.length).toBe(2)\n    expect(rec.generateCalls[1]!.duration).toEqual(Duration.seconds(45))\n    expect(rec.generateCalls[1]!.seed).toBe(42)\n  })\n})\n\ndescribe(\"MusicGenerator.streamGeneration\", () => {\n  it(\"emits scripted chunks\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationChunks: [[chunk(1), chunk(2), chunk(3)]],\n    })\n    const program = Stream.runCollect(\n      MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" }),\n    )\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.map((c) => Array.from(c.bytes))).toEqual([[1], [2], [3]])\n  })\n})\n\ndescribe(\"MusicGenerator capability marker (compile-time)\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"m\",\n    prompt: \"\",\n  }\n\n  it(\"requires `MusicInteractiveSession` on the R channel of streamGenerationFrom\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    expectTypeOf(events).toEqualTypeOf<\n      Stream.Stream<\n        MusicStreamEvent,\n        AiError.AiError,\n        MusicGenerator.MusicGenerator | MusicGenerator.MusicInteractiveSession\n      >\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for sync `generate`\", () => {\n    const eff = MusicGenerator.generate({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(eff).toEqualTypeOf<\n      Effect.Effect<GenerateResult, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for `streamGeneration`\", () => {\n    const audio = MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(audio).toEqualTypeOf<\n      Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"a layer without the marker leaves `MusicInteractiveSession` unsatisfied in R\", () => {\n    const noMarker = MockMusicGenerator.layerWithoutInteractive({})\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(noMarker.layer))\n    expectTypeOf(program).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"a full layer (with marker) clears R to never\", () => {\n    const fullMock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[]],\n    })\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(fullMock.layer))\n    expectTypeOf(program).toEqualTypeOf<Effect.Effect<void, AiError.AiError, never>>()\n  })\n})\n\ndescribe(\"MusicGenerator.streamGenerationFrom\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"lyria-realtime-exp\",\n    prompt: \"\",\n  }\n\n  it(\"drains a session-input stream and emits scripted events\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(10)), audioEvent(chunk(20))]],\n    })\n    const inputs = Stream.fromIterable([\n      promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n      controlInput(\"play\"),\n      promptsInput([\n        { text: \"minimal techno\", weight: 1.0 },\n        { text: \"1980s synthwave\", weight: 0.3 },\n      ]),\n    ])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const out = await Effect.runPromise(Stream.runCollect(events).pipe(Effect.provide(mock.layer)))\n    const audioChunks = out.flatMap((e) => (e._tag === \"audio\" ? [e.chunk] : []))\n    expect(audioChunks.map((c) => Array.from(c.bytes))).toEqual([[10], [20]])\n  })\n\n  it(\"records the request on the streamGenerationFrom call channel\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(42))]],\n    })\n    const program = Effect.gen(function* () {\n      const inputs = Stream.fromIterable([promptsInput([{ text: \"x\" }])])\n      yield* Stream.runDrain(inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq)))\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.streamGenerationFromCalls.length).toBe(1)\n    expect(rec.streamGenerationFromCalls[0]!.model).toBe(\"lyria-realtime-exp\")\n    expect(rec.generateCalls.length).toBe(0)\n    expect(rec.streamGenerationCalls.length).toBe(0)\n  })\n})\n"],"mappings":";;;;;;AAuBA,MAAM,YAAyB;CAC7B,OAAO;EACL,QAAQ;GARV,WAAW;GACX,UAAU;GACV,YAAY;GACZ,UAAU;GAKS;EACjB,OAAO,IAAI,WAAW;GAAC;GAAM;GAAM;GAAM;GAAK,CAAC;EAC/C,UAAU,SAAS,QAAQ,GAAG;EAC/B;CACD,UAAU;CACV,QAAQ;CACR,WAAW;CACZ;AAED,MAAM,aAA6B,cAAc,UAAU;AAE3D,MAAM,SAAS,OAA2B,EAAE,OAAO,IAAI,WAAW,CAAC,EAAE,CAAC,EAAE;AAExE,SAAS,iCAAiC;AACxC,IAAG,uCAAuC,YAAY;EACpD,MAAM,OAAOA,MAAyB,EAAE,SAAS,CAAC,WAAW,EAAE,CAAC;EAChE,MAAM,UAAUC,SAAwB;GACtC,OAAO;GACP,QAAQ;GACT,CAAC;EACF,MAAM,MAAM,MAAM,OAAO,WAAW,QAAQ,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC7E,eAAO,IAAI,QAAQ,MAAM,MAAM,CAAC,QAAQ,UAAU,MAAM,MAAM;AAC9D,eAAO,IAAI,QAAQ,MAAM,SAAS,CAAC,QAAQ,SAAS,QAAQ,GAAG,CAAC;AAChE,eAAO,IAAI,QAAQ,UAAU,CAAC,KAAK,UAAU;AAC7C,eAAO,IAAI,QAAQ,OAAO,CAAC,UAAU,UAAU;AAC/C,eAAO,IAAI,SAAS,CAAC,aAAa,EAAE;AACpC,eAAO,IAAI,SAAS,GAAG,CAAC,KAAK,IAAI,QAAQ;GACzC;AAEF,IAAG,sEAAsE,YAAY;EACnF,MAAM,cAA2B;GAC/B,GAAG;GACH,OAAO;IAAE,GAAG,UAAU;IAAO,OAAO,IAAI,WAAW;KAAC;KAAM;KAAM;KAAM;KAAK,CAAC;IAAE;GAC/E;EAKD,MAAM,OAAOD,MAAyB,EAAE,SAAS,CAAC;GAHhD,SAAS;GACT,UAAU,CAAC,WAAW,YAAY;GAEc,CAAY,EAAE,CAAC;EACjE,MAAM,UAAUC,SAAwB;GAAE,OAAO;GAAK,QAAQ;GAAS,CAAC;EACxE,MAAM,MAAM,MAAM,OAAO,WAAW,QAAQ,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC7E,eAAO,IAAI,SAAS,CAAC,aAAa,EAAE;AACpC,eAAO,IAAI,SAAS,GAAI,MAAM,MAAM,CAAC,QAAQ,YAAY,MAAM,MAAM;GACrE;AAEF,IAAG,6CAA6C,YAAY;EAC1D,MAAM,OAAOD,MAAyB,EAAE,SAAS,CAAC,YAAY,WAAW,EAAE,CAAC;EAC5E,MAAM,UAAU,OAAO,IAAI,aAAa;AACtC,UAAOC,SAAwB;IAAE,OAAO;IAAK,QAAQ;IAAU,CAAC;AAChE,UAAOA,SAAwB;IAC7B,OAAO;IACP,QAAQ;IACR,UAAU,SAAS,QAAQ,GAAG;IAC9B,MAAM;IACP,CAAC;AACF,UAAO,OAAO,KAAK;IACnB;EACF,MAAM,MAAM,MAAM,OAAO,WAAW,QAAQ,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC7E,eAAO,IAAI,cAAc,OAAO,CAAC,KAAK,EAAE;AACxC,eAAO,IAAI,cAAc,GAAI,SAAS,CAAC,QAAQ,SAAS,QAAQ,GAAG,CAAC;AACpE,eAAO,IAAI,cAAc,GAAI,KAAK,CAAC,KAAK,GAAG;GAC3C;EACF;AAEF,SAAS,yCAAyC;AAChD,IAAG,yBAAyB,YAAY;EACtC,MAAM,OAAOD,MAAyB,EACpC,wBAAwB,CAAC;GAAC,MAAM,EAAE;GAAE,MAAM,EAAE;GAAE,MAAM,EAAE;GAAC,CAAC,EACzD,CAAC;EACF,MAAM,UAAU,OAAO,WACrBE,iBAAgC;GAAE,OAAO;GAAK,QAAQ;GAAW,CAAC,CACnE;AAED,gBAAO,MADW,OAAO,WAAW,QAAQ,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EAClE,KAAK,MAAM,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ;GAAC,CAAC,EAAE;GAAE,CAAC,EAAE;GAAE,CAAC,EAAE;GAAC,CAAC;GACpE;EACF;AAEF,SAAS,yDAAyD;CAChE,MAAM,SAA0D;EAC9D,OAAO;EACP,QAAQ;EACT;AAED,IAAG,qFAAqF;AAGtF,GAAA,GAAA,YAAA,cAFe,OAAO,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,CAClD,CAAC,KAAKC,qBAAoC,OAAO,CACnD,CAAC,CAAC,eAMlB;GACH;AAEF,IAAG,wEAAwE;AAEzE,GAAA,GAAA,YAAA,cADYF,SAAwB;GAAE,OAAO;GAAK,QAAQ;GAAW,CACrD,CAAC,CAAC,eAEf;GACH;AAEF,IAAG,2EAA2E;AAE5E,GAAA,GAAA,YAAA,cADcC,iBAAgC;GAAE,OAAO;GAAK,QAAQ;GAAW,CAC7D,CAAC,CAAC,eAEjB;GACH;AAEF,IAAG,sFAAsF;EACvF,MAAM,WAAWE,wBAA2C,EAAE,CAAC;EAE/D,MAAM,SADS,OAAO,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,CAClD,CAAC,KAAKD,qBAAoC,OAAO,CAAC;AAEvE,GAAA,GAAA,YAAA,cADgB,OAAO,SAAS,OAAO,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,CACvD,CAAC,CAAC,eAEnB;GACH;AAEF,IAAG,sDAAsD;EACvD,MAAM,WAAWH,MAAyB,EACxC,4BAA4B,CAAC,EAAE,CAAC,EACjC,CAAC;EAEF,MAAM,SADS,OAAO,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,CAClD,CAAC,KAAKG,qBAAoC,OAAO,CAAC;AAEvE,GAAA,GAAA,YAAA,cADgB,OAAO,SAAS,OAAO,CAAC,KAAK,OAAO,QAAQ,SAAS,MAAM,CACvD,CAAC,CAAC,eAA4D;GAClF;EACF;AAEF,SAAS,6CAA6C;CACpD,MAAM,SAA0D;EAC9D,OAAO;EACP,QAAQ;EACT;AAED,IAAG,2DAA2D,YAAY;EACxE,MAAM,OAAOH,MAAyB,EACpC,4BAA4B,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC,EAAE,WAAW,MAAM,GAAG,CAAC,CAAC,CAAC,EAC7E,CAAC;EASF,MAAM,SARS,OAAO,aAAa;GACjC,aAAa,CAAC;IAAE,MAAM;IAAkB,QAAQ;IAAK,CAAC,CAAC;GACvD,aAAa,OAAO;GACpB,aAAa,CACX;IAAE,MAAM;IAAkB,QAAQ;IAAK,EACvC;IAAE,MAAM;IAAmB,QAAQ;IAAK,CACzC,CAAC;GACH,CACoB,CAAC,KAAKG,qBAAoC,OAAO,CAAC;AAGvE,gBADoB,MADF,OAAO,WAAW,OAAO,WAAW,OAAO,CAAC,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,EACvE,SAAS,MAAO,EAAE,SAAS,UAAU,CAAC,EAAE,MAAM,GAAG,EAAE,CACzD,CAAC,KAAK,MAAM,MAAM,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC;GACzE;AAEF,IAAG,gEAAgE,YAAY;EAC7E,MAAM,OAAOH,MAAyB,EACpC,4BAA4B,CAAC,CAAC,WAAW,MAAM,GAAG,CAAC,CAAC,CAAC,EACtD,CAAC;EACF,MAAM,UAAU,OAAO,IAAI,aAAa;GACtC,MAAM,SAAS,OAAO,aAAa,CAAC,aAAa,CAAC,EAAE,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC;AACnE,UAAO,OAAO,SAAS,OAAO,KAAKG,qBAAoC,OAAO,CAAC,CAAC;AAChF,UAAO,OAAO,KAAK;IACnB;EACF,MAAM,MAAM,MAAM,OAAO,WAAW,QAAQ,KAAK,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC;AAC7E,eAAO,IAAI,0BAA0B,OAAO,CAAC,KAAK,EAAE;AACpD,eAAO,IAAI,0BAA0B,GAAI,MAAM,CAAC,KAAK,qBAAqB;AAC1E,eAAO,IAAI,cAAc,OAAO,CAAC,KAAK,EAAE;AACxC,eAAO,IAAI,sBAAsB,OAAO,CAAC,KAAK,EAAE;GAChD;EACF"}
+{"version":3,"file":"MusicGenerator.test.mjs","names":["MockMusicGenerator.layer","MusicGenerator.generate","MusicGenerator.streamGeneration","MusicGenerator.streamGenerationFrom","MockMusicGenerator.layerWithoutInteractive"],"sources":["../../src/music-generator/MusicGenerator.test.ts"],"sourcesContent":["import { Duration, Effect, Stream } from \"effect\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"../domain/AiError.js\"\nimport type { AudioChunk, AudioFormat } from \"../domain/Audio.js\"\nimport {\n  audioEvent,\n  controlInput,\n  type GenerateResult,\n  type MusicResult,\n  type MusicStreamEvent,\n  promptsInput,\n  singleVariant,\n} from \"../domain/Music.js\"\nimport * as MockMusicGenerator from \"../testing/MockMusicGenerator.js\"\nimport * as MusicGenerator from \"./MusicGenerator.js\"\n\nconst mp3Format: AudioFormat = {\n  container: \"mp3\",\n  encoding: \"mp3\",\n  sampleRate: 44100,\n  channels: 2,\n}\n\nconst oneResult: MusicResult = {\n  audio: {\n    format: mp3Format,\n    bytes: new Uint8Array([0xff, 0xfb, 0x90, 0x00]),\n    duration: Duration.seconds(30),\n  },\n  provider: \"mock-music\",\n  lyrics: \"[Verse]\\nhello\\n\",\n  watermark: \"synthid\",\n}\n\nconst oneVariant: GenerateResult = singleVariant(oneResult)\n\nconst chunk = (n: number): AudioChunk => ({ bytes: new Uint8Array([n]) })\n\ndescribe(\"MusicGenerator.generate\", () => {\n  it(\"returns the scripted GenerateResult\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant] })\n    const program = MusicGenerator.generate({\n      model: \"mock-music\",\n      prompt: \"upbeat indie pop\",\n    })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.primary.audio.bytes).toEqual(oneResult.audio.bytes)\n    expect(out.primary.audio.duration).toEqual(Duration.seconds(30))\n    expect(out.primary.watermark).toBe(\"synthid\")\n    expect(out.primary.lyrics).toContain(\"[Verse]\")\n    expect(out.variants).toHaveLength(1)\n    expect(out.variants[0]).toBe(out.primary)\n  })\n\n  it(\"exposes multiple variants when the provider returned more than one\", async () => {\n    const secondTrack: MusicResult = {\n      ...oneResult,\n      audio: { ...oneResult.audio, bytes: new Uint8Array([0xff, 0xfb, 0xa0, 0x00]) },\n    }\n    const twoVariants: GenerateResult = {\n      primary: oneResult,\n      variants: [oneResult, secondTrack],\n    }\n    const mock = MockMusicGenerator.layer({ results: [twoVariants] })\n    const program = MusicGenerator.generate({ model: \"m\", prompt: \"house\" })\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.variants).toHaveLength(2)\n    expect(out.variants[1]!.audio.bytes).toEqual(secondTrack.audio.bytes)\n  })\n\n  it(\"records the request shape on the recorder\", async () => {\n    const mock = MockMusicGenerator.layer({ results: [oneVariant, oneVariant] })\n    const program = Effect.gen(function* () {\n      yield* MusicGenerator.generate({ model: \"m\", prompt: \"techno\" })\n      yield* MusicGenerator.generate({\n        model: \"m\",\n        prompt: \"synthwave\",\n        duration: Duration.seconds(45),\n        seed: 42,\n      })\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.generateCalls.length).toBe(2)\n    expect(rec.generateCalls[1]!.duration).toEqual(Duration.seconds(45))\n    expect(rec.generateCalls[1]!.seed).toBe(42)\n  })\n})\n\ndescribe(\"MusicGenerator.streamGeneration\", () => {\n  it(\"emits scripted chunks\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationChunks: [[chunk(1), chunk(2), chunk(3)]],\n    })\n    const program = Stream.runCollect(\n      MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" }),\n    )\n    const out = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(out.map((c) => Array.from(c.bytes))).toEqual([[1], [2], [3]])\n  })\n})\n\ndescribe(\"MusicGenerator capability marker (compile-time)\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"m\",\n    prompt: \"\",\n  }\n\n  it(\"requires `MusicInteractiveSession` on the R channel of streamGenerationFrom\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    expectTypeOf(events).toEqualTypeOf<\n      Stream.Stream<\n        MusicStreamEvent,\n        AiError.AiError,\n        MusicGenerator.MusicGenerator | MusicGenerator.MusicInteractiveSession\n      >\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for sync `generate`\", () => {\n    const eff = MusicGenerator.generate({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(eff).toEqualTypeOf<\n      Effect.Effect<GenerateResult, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"does NOT require `MusicInteractiveSession` for `streamGeneration`\", () => {\n    const audio = MusicGenerator.streamGeneration({ model: \"m\", prompt: \"ambient\" })\n    expectTypeOf(audio).toEqualTypeOf<\n      Stream.Stream<AudioChunk, AiError.AiError, MusicGenerator.MusicGenerator>\n    >()\n  })\n\n  it(\"a layer without the marker leaves `MusicInteractiveSession` unsatisfied in R\", () => {\n    const noMarker = MockMusicGenerator.layerWithoutInteractive({})\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(noMarker.layer))\n    expectTypeOf(program).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"a full layer (with marker) clears R to never\", () => {\n    const fullMock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[]],\n    })\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const program = Stream.runDrain(events).pipe(Effect.provide(fullMock.layer))\n    expectTypeOf(program).toEqualTypeOf<Effect.Effect<void, AiError.AiError, never>>()\n  })\n})\n\ndescribe(\"MusicGenerator.streamGenerationFrom\", () => {\n  const sgfReq: MusicGenerator.CommonStreamGenerateMusicRequest = {\n    model: \"lyria-realtime-exp\",\n    prompt: \"\",\n  }\n\n  it(\"drains a session-input stream and emits scripted events\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(10)), audioEvent(chunk(20))]],\n    })\n    const inputs = Stream.fromIterable([\n      promptsInput([{ text: \"minimal techno\", weight: 1.0 }]),\n      controlInput(\"play\"),\n      promptsInput([\n        { text: \"minimal techno\", weight: 1.0 },\n        { text: \"1980s synthwave\", weight: 0.3 },\n      ]),\n    ])\n    const events = inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq))\n    const out = await Effect.runPromise(Stream.runCollect(events).pipe(Effect.provide(mock.layer)))\n    const audioChunks = out.flatMap((e) => (e._tag === \"audio\" ? [e.chunk] : []))\n    expect(audioChunks.map((c) => Array.from(c.bytes))).toEqual([[10], [20]])\n  })\n\n  it(\"records the request on the streamGenerationFrom call channel\", async () => {\n    const mock = MockMusicGenerator.layer({\n      streamGenerationFromEvents: [[audioEvent(chunk(42))]],\n    })\n    const program = Effect.gen(function* () {\n      const inputs = Stream.fromIterable([promptsInput([{ text: \"x\" }])])\n      yield* Stream.runDrain(inputs.pipe(MusicGenerator.streamGenerationFrom(sgfReq)))\n      return yield* mock.recorder\n    })\n    const rec = await Effect.runPromise(program.pipe(Effect.provide(mock.layer)))\n    expect(rec.streamGenerationFromCalls.length).toBe(1)\n    expect(rec.streamGenerationFromCalls[0]!.model).toBe(\"lyria-realtime-exp\")\n    expect(rec.generateCalls.length).toBe(0)\n    expect(rec.streamGenerationCalls.length).toBe(0)\n  })\n})\n"],"mappings":"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"}

package/dist/observability/Metrics.d.mts

@@ -1,10 +1,8 @@
-import { x as Usage } from "../Items-BWNu6VGp.mjs";
+import { x as Usage } from "../Items-SfUabNuB.mjs";
 import { TurnEvent } from "../domain/Turn.mjs";
 import { Duration, Effect, Option, Stream } from "effect";
-
-//#region src/observability/Metrics.d.ts
 declare namespace Metrics_d_exports {
-  export { AllMetricsOptions, Measurement, MetricEvent, MetricEventTypeId, RateState, Throughput, ThroughputOptions, TimeToCompletion, TimeToFirstToken, TimeToFirstTokenOptions, TokenTotals, allMetrics, computeThroughputTick, isMetricEvent, makeEvent, metricEvents, throughput, timeToCompletion, timeToFirstToken, tokenTotals };
+  export { AllMetricsOptions, Measurement, MetricEvent, MetricEventTypeId, OutputDelta, RateState, Throughput, ThroughputOptions, TimeToCompletion, TimeToFirstToken, TimeToFirstTokenOptions, TokenTotals, allMetrics, computeThroughputTick, isMetricEvent, makeEvent, metricEvents, throughput, timeToCompletion, timeToFirstToken, tokenTotals };
 }
 /**
  * The instrument-agnostic description of a single recorded value. The
@@ -32,7 +30,8 @@ declare const MetricEventTypeId: unique symbol;
  */
 type MetricEvent = {
   readonly [MetricEventTypeId]: typeof MetricEventTypeId;
-  readonly _tag: string; /** Which turn within the piped stream this sample belongs to (0-based). */
+  readonly _tag: string;
+  /** Which turn within the piped stream this sample belongs to (0-based). */
   readonly turnIndex: number;
   readonly measurements: ReadonlyArray<Measurement>;
 };
@@ -77,6 +76,10 @@ declare const isMetricEvent: (u: unknown) => u is MetricEvent;
  * channel or a frontend feed.
  */
 declare const metricEvents: <A, E, R>(self: Stream.Stream<A, E, R>) => Stream.Stream<MetricEvent, E, R>;
+/** A delta carrying generated output, whatever the model was producing. */
+type OutputDelta = Extract<TurnEvent, {
+  readonly _tag: "TextDelta" | "ReasoningDelta" | "RefusalDelta" | "ToolCallArgsDelta";
+}>;
 type TimeToFirstTokenOptions = {
   /**
    * Where the clock starts. `"request"` (default) anchors at stream
@@ -90,10 +93,18 @@ declare const timeToFirstToken: (options?: TimeToFirstTokenOptions) => <A, E, R>
 declare const timeToCompletion: <A, E, R>(self: Stream.Stream<A, E, R>) => Stream.Stream<A | MetricEvent, E, R>;
 declare const tokenTotals: <A, E, R>(self: Stream.Stream<A, E, R>) => Stream.Stream<A | MetricEvent, E, R>;
 type ThroughputOptions = {
-  /** Tick interval. Default `"1 second"`. */readonly every?: Duration.Input; /** What a "unit" is. Default `"char"` (exact and chunking-independent). */
-  readonly unit?: "char" | "token" | "event"; /** Token counter for `unit: "token"`. Absent => approximate 1 per content delta. */
-  readonly tokenizer?: (event: TurnEvent) => Effect.Effect<number>; /** Rate definition. Default `"windowed"` (current speed, no cold-start bias). */
-  readonly mode?: "windowed" | "cumulative"; /** EWMA smoothing. Omitted => off; `"default"` => a sensible factor. */
+  /** Tick interval. Default `"1 second"`. */
+  readonly every?: Duration.Input;
+  /** What a "unit" is. Default `"char"` (exact and chunking-independent). */
+  readonly unit?: "char" | "token" | "event";
+  /**
+   * Token counter for `unit: "token"`. Called only for deltas that carry
+   * generated output. Absent => approximate 1 per such delta.
+   */
+  readonly tokenizer?: (event: OutputDelta) => Effect.Effect<number>;
+  /** Rate definition. Default `"windowed"` (current speed, no cold-start bias). */
+  readonly mode?: "windowed" | "cumulative";
+  /** EWMA smoothing. Omitted => off; `"default"` => a sensible factor. */
   readonly smooth?: "default" | number;
 };
 /**
@@ -129,5 +140,5 @@ type AllMetricsOptions = {
 };
 declare const allMetrics: (options?: AllMetricsOptions) => <A, E, R>(self: Stream.Stream<A, E, R>) => Stream.Stream<A | MetricEvent, E, R>;
 //#endregion
-export { AllMetricsOptions, Measurement, MetricEvent, MetricEventTypeId, RateState, Throughput, ThroughputOptions, TimeToCompletion, TimeToFirstToken, TimeToFirstTokenOptions, TokenTotals, allMetrics, computeThroughputTick, isMetricEvent, makeEvent, metricEvents, Metrics_d_exports as t, throughput, timeToCompletion, timeToFirstToken, tokenTotals };
+export { AllMetricsOptions, Measurement, MetricEvent, MetricEventTypeId, OutputDelta, RateState, Throughput, ThroughputOptions, TimeToCompletion, TimeToFirstToken, TimeToFirstTokenOptions, TokenTotals, allMetrics, computeThroughputTick, isMetricEvent, makeEvent, metricEvents, Metrics_d_exports as t, throughput, timeToCompletion, timeToFirstToken, tokenTotals };
 //# sourceMappingURL=Metrics.d.mts.map

package/dist/observability/Metrics.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"Metrics.d.mts","names":[],"sources":["../../src/observability/Metrics.ts"],"mappings":"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"}
+{"version":3,"file":"Metrics.d.mts","names":[],"sources":["../../src/observability/Metrics.ts"],"mappings":";;;;;;;;;;;;KA0BY;WACD;WACA;WACA,gBAAgB,SAAS;WACzB,aAAa,SAAS;;;;;;;;cAapB;;;;;;KASD;YACA,2BAA2B;WAC5B;;WAEA;WACA,cAAc,cAAc;;;KAI3B,mBAAmB;WACpB;WACA,SAAS,SAAS;WAClB;;;KAIC,aAAa;WACd;WACA;WACA;WACA,QAAQ,SAAS;;;KAIhB,cAAc;WACf;WACA,OAAO;WACP,YAAY;;;KAIX,mBAAmB;WACpB;WACA,UAAU,SAAS;WACnB,YAAY,SAAS;;;;;;;;cASnB,YAAa,eAAe,KAAK,oBAAoB,oBAAkB,QAC1E,WACP;YAAqB,2BAA2B;;;cAMtC,gBAAa,eAAiB,KAAK;;;;;cAOnC,eAAgB,GAAG,GAAG,GAAC,MAC5B,OAAO,OAAO,GAAG,GAAG,OACzB,OAAO,OAAO,aAAa,GAAG;;KAsCrB,cAAc,QACxB;WACW;;KA6ED;;;;;;;WAOD;;cAUE,mBAAgB,UAChB,6BACV,GAAG,GAAG,GAAC,MAAQ,OAAO,OAAO,GAAG,GAAG,OAAK,OAAO,OAAO,IAAI,aAAa,GAAG;cAwDhE,mBAAoB,GAAG,GAAG,GAAC,MAChC,OAAO,OAAO,GAAG,GAAG,OACzB,OAAO,OAAO,IAAI,aAAa,GAAG;cAqDxB,cAAe,GAAG,GAAG,GAAC,MAC3B,OAAO,OAAO,GAAG,GAAG,OACzB,OAAO,OAAO,IAAI,aAAa,GAAG;KAyBzB;;WAED,QAAQ,SAAS;;WAEjB;;;;;WAKA,aAAa,OAAO,gBAAgB,OAAO;;WAE3C;;WAEA;;;;;;;;KASC;WACD;WACA;WACA;WACA,aAAa,OAAO;WACpB,UAAU,OAAO;WACjB;;;;;;;;;cAsBE,wBAAqB,OACzB,WAAS,aACL,iCACoB,+BAE9B,OAAO;WACC;WACA,QAAQ,SAAS;WACjB,MAAM;;cAiDJ,aAAU,UACV,uBACV,GAAG,GAAG,GAAC,MAAQ,OAAO,OAAO,GAAG,GAAG,OAAK,OAAO,OAAO,IAAI,aAAa,GAAG;KA4DjE;WACD,mBAAmB;WACnB,aAAa;;cAGX,aAAU,UACV,uBACV,GAAG,GAAG,GAAC,MAAQ,OAAO,OAAO,GAAG,GAAG,OAAK,OAAO,OAAO,IAAI,aAAa,GAAG"}

package/dist/observability/Metrics.mjs

@@ -1,4 +1,5 @@
-import { n as __exportAll } from "../chunk-uyGKjUfl.mjs";
+import { n as __exportAll } from "../rolldown-runtime-EAsCxrDo.mjs";
+import { TurnEvent } from "../domain/Turn.mjs";
 import { Array, Clock, Duration, Effect, Match, Option, Predicate, Ref, Result, Schedule, Stream } from "effect";
 //#region src/observability/Metrics.ts
 var Metrics_exports = /* @__PURE__ */ __exportAll({
@@ -45,7 +46,8 @@ const MetricName = {
 	outputTokens: "effect_uai_output_tokens",
 	totalTokens: "effect_uai_total_tokens",
 	reasoningTokens: "effect_uai_reasoning_tokens",
-	cachedInputTokens: "effect_uai_cached_input_tokens"
+	cachedInputTokens: "effect_uai_cached_input_tokens",
+	cacheWriteTokens: "effect_uai_cache_write_tokens"
 };
 /** Read a structural `_tag` off any value without narrowing to a closed union. */
 const tagOf = (u) => Predicate.hasProperty(u, "_tag") && Predicate.isString(u._tag) ? u._tag : void 0;
@@ -53,17 +55,36 @@ const contentDeltaKind = (ev) => {
 	const t = tagOf(ev);
 	return t === "TextDelta" ? Option.some("text") : t === "ReasoningDelta" ? Option.some("reasoning") : Option.none();
 };
+const isTextDelta = TurnEvent.$is("TextDelta");
+const isReasoningDelta = TurnEvent.$is("ReasoningDelta");
+const isRefusalDelta = TurnEvent.$is("RefusalDelta");
+const isToolCallArgsDelta = TurnEvent.$is("ToolCallArgsDelta");
+/**
+* Narrow to a delta that contributes to the model's output stream. Tool-call
+* arguments count: an agent turn can be almost entirely `ToolCallArgsDelta`,
+* and measuring only prose reports a near-zero rate for it.
+*
+* The single place the output-delta tag list lives — the throughput
+* accumulator and `unitCount` both read it. Distinct from `contentDeltaKind`,
+* which answers a narrower question for first-token latency.
+*/
+const outputDelta = (ev) => isTextDelta(ev) || isReasoningDelta(ev) || isRefusalDelta(ev) || isToolCallArgsDelta(ev) ? Option.some(ev) : Option.none();
+const outputTextOf = (delta) => isToolCallArgsDelta(delta) ? delta.delta : delta.text;
 const isTurnCompleteEvent = (ev) => tagOf(ev) === "TurnComplete";
 const turnOf = (ev) => ev.turn;
 const sumOptional = (a, b) => a === void 0 && b === void 0 ? void 0 : (a ?? 0) + (b ?? 0);
 const addUsage = (a, b) => {
 	const cached = sumOptional(a.input_tokens_details?.cached_tokens, b.input_tokens_details?.cached_tokens);
+	const cacheWrite = sumOptional(a.input_tokens_details?.cache_write_tokens, b.input_tokens_details?.cache_write_tokens);
 	const reasoning = sumOptional(a.output_tokens_details?.reasoning_tokens, b.output_tokens_details?.reasoning_tokens);
 	return {
 		input_tokens: sumOptional(a.input_tokens, b.input_tokens),
 		output_tokens: sumOptional(a.output_tokens, b.output_tokens),
 		total_tokens: sumOptional(a.total_tokens, b.total_tokens),
-		input_tokens_details: cached === void 0 ? void 0 : { cached_tokens: cached },
+		input_tokens_details: cached === void 0 && cacheWrite === void 0 ? void 0 : {
+			...cached !== void 0 && { cached_tokens: cached },
+			...cacheWrite !== void 0 && { cache_write_tokens: cacheWrite }
+		},
 		output_tokens_details: reasoning === void 0 ? void 0 : { reasoning_tokens: reasoning }
 	};
 };
@@ -74,7 +95,8 @@ const usageMeasurements = (usage) => {
 		[MetricName.outputTokens, usage.output_tokens],
 		[MetricName.totalTokens, usage.total_tokens],
 		[MetricName.reasoningTokens, usage.output_tokens_details?.reasoning_tokens],
-		[MetricName.cachedInputTokens, usage.input_tokens_details?.cached_tokens]
+		[MetricName.cachedInputTokens, usage.input_tokens_details?.cached_tokens],
+		[MetricName.cacheWriteTokens, usage.input_tokens_details?.cache_write_tokens]
 	];
 	return Array.filterMap(pairs, ([name, value]) => value === void 0 ? Result.failVoid : Result.succeed({
 		name,
@@ -225,9 +247,10 @@ const resetTurn = (state) => ({
 	turnIndex: state.turnIndex + 1
 });
 const unitCount = (ev, unit, tokenizer) => {
-	if (tagOf(ev) !== "TextDelta") return Effect.succeed(0);
-	const text = ev.text;
-	return Match.value(unit).pipe(Match.when("char", () => Effect.succeed([...text].length)), Match.when("event", () => Effect.succeed(1)), Match.when("token", () => tokenizer === void 0 ? Effect.succeed(1) : tokenizer(ev)), Match.exhaustive);
+	const output = outputDelta(ev);
+	if (Option.isNone(output)) return Effect.succeed(0);
+	const delta = output.value;
+	return Match.value(unit).pipe(Match.when("char", () => Effect.succeed([...outputTextOf(delta)].length)), Match.when("event", () => Effect.succeed(1)), Match.when("token", () => tokenizer === void 0 ? Effect.succeed(1) : tokenizer(delta)), Match.exhaustive);
 };
 const throughputName = (unit) => `effect_uai_output_${unit}s_per_second`;
 const throughput = (options) => (self) => {
@@ -238,7 +261,7 @@ const throughput = (options) => (self) => {
 	const tokenizer = options?.tokenizer;
 	const name = throughputName(unit);
 	return Stream.unwrap(Effect.map(Ref.make(initRateState), (ref) => {
-		const source = self.pipe(Stream.tap((ev) => isTurnCompleteEvent(ev) ? Ref.update(ref, resetTurn) : tagOf(ev) === "TextDelta" ? Effect.flatMap(Clock.currentTimeMillis, (now) => Effect.flatMap(unitCount(ev, unit, tokenizer), (n) => Ref.update(ref, (state) => addUnits(state, n, now)))) : Effect.void));
+		const source = self.pipe(Stream.tap((ev) => isTurnCompleteEvent(ev) ? Ref.update(ref, resetTurn) : Option.isSome(outputDelta(ev)) ? Effect.flatMap(Clock.currentTimeMillis, (now) => Effect.flatMap(unitCount(ev, unit, tokenizer), (n) => Ref.update(ref, (state) => addUnits(state, n, now)))) : Effect.void));
 		const metronome = Stream.fromSchedule(Schedule.spaced(every)).pipe(Stream.mapEffect(() => Effect.flatMap(Clock.currentTimeMillis, (now) => Ref.modify(ref, (state) => Option.match(computeThroughputTick(state, now, mode, smooth), {
 			onNone: () => [Option.none(), state],
 			onSome: ({ next, rate, window }) => [Option.some(makeEvent({

package/dist/observability/Metrics.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"Metrics.mjs","names":["Arr"],"sources":["../../src/observability/Metrics.ts"],"sourcesContent":["import {\n  Array as Arr,\n  Clock,\n  Duration,\n  Effect,\n  Match,\n  Option,\n  Predicate,\n  Ref,\n  Result,\n  Schedule,\n  Stream,\n} from \"effect\"\nimport type { Usage } from \"../domain/Items.js\"\nimport type { Turn, TurnEvent } from \"../domain/Turn.js\"\n\n// ---------------------------------------------------------------------------\n// Self-describing measurements (the exporter-facing payload)\n// ---------------------------------------------------------------------------\n\n/**\n * The instrument-agnostic description of a single recorded value. The\n * `Telemetry` recorder reads only this: it builds (or reuses) a `Metric`\n * instrument from `kind` + `name` and updates it with `value`. A new metric,\n * built-in or user-defined, never requires a change to the recorder.\n */\nexport type Measurement = {\n  readonly name: string\n  readonly kind: \"counter\" | \"histogram\" | \"timer\" | \"gauge\"\n  readonly value: number | Duration.Duration\n  readonly attributes?: Readonly<Record<string, string>> | undefined\n}\n\n// ---------------------------------------------------------------------------\n// MetricEvent: an open, brand-marked union (built-ins + user metrics)\n// ---------------------------------------------------------------------------\n\n/**\n * Brand stamped on every metric event. `isMetricEvent` checks this symbol,\n * not an enumerated `_tag`, so events are distinguished from `TurnEvent`s,\n * tool outputs, and arbitrary custom loop values regardless of their tag.\n * This is the same TypeId-symbol pattern Effect uses for `isStream` etc.\n */\nexport const MetricEventTypeId: unique symbol = Symbol.for(\n  \"@effect-uai/core/observability/MetricEvent\",\n)\n\n/**\n * The structural contract every metric event satisfies, ours and custom.\n * The `_tag` + extra typed fields serve a frontend; the brand + `measurements`\n * serve the exporter.\n */\nexport type MetricEvent = {\n  readonly [MetricEventTypeId]: typeof MetricEventTypeId\n  readonly _tag: string\n  /** Which turn within the piped stream this sample belongs to (0-based). */\n  readonly turnIndex: number\n  readonly measurements: ReadonlyArray<Measurement>\n}\n\n/** Request/turn start to the first content delta. */\nexport type TimeToFirstToken = MetricEvent & {\n  readonly _tag: \"TimeToFirstToken\"\n  readonly elapsed: Duration.Duration\n  readonly kind: \"text\" | \"reasoning\"\n}\n\n/** A live output rate, emitted on the metronome cadence. */\nexport type Throughput = MetricEvent & {\n  readonly _tag: \"Throughput\"\n  readonly ratePerSecond: number\n  readonly unit: \"char\" | \"token\" | \"event\"\n  readonly window: Duration.Duration\n}\n\n/** Provider-reported usage at `TurnComplete`, this turn and cumulative. */\nexport type TokenTotals = MetricEvent & {\n  readonly _tag: \"TokenTotals\"\n  readonly usage: Usage\n  readonly cumulative: Usage\n}\n\n/** Per-turn wall times at `TurnComplete`. */\nexport type TimeToCompletion = MetricEvent & {\n  readonly _tag: \"TimeToCompletion\"\n  readonly duration: Duration.Duration\n  readonly generation: Duration.Duration\n}\n\n/**\n * Mint a custom metric event. Stamp it with the brand and provide a\n * well-formed `measurements` array; `Telemetry.record` will export it with no\n * changes to the recorder. The only constraint is that each measurement's\n * `kind` is one the recorder maps.\n */\nexport const makeEvent = <Fields extends Omit<MetricEvent, typeof MetricEventTypeId>>(\n  fields: Fields,\n): Fields & { readonly [MetricEventTypeId]: typeof MetricEventTypeId } => ({\n  [MetricEventTypeId]: MetricEventTypeId,\n  ...fields,\n})\n\n/** Structural (brand-based) guard for any metric event, built-in or custom. */\nexport const isMetricEvent = (u: unknown): u is MetricEvent =>\n  Predicate.hasProperty(u, MetricEventTypeId)\n\n/**\n * Project a stream of mixed events onto just its metric samples, for a side\n * channel or a frontend feed.\n */\nexport const metricEvents = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<MetricEvent, E, R> =>\n  self.pipe(Stream.filterMap((ev) => (isMetricEvent(ev) ? Result.succeed(ev) : Result.failVoid)))\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst MetricName = {\n  ttft: \"effect_uai_turn_ttft\",\n  duration: \"effect_uai_turn_duration\",\n  generation: \"effect_uai_turn_generation\",\n  inputTokens: \"effect_uai_input_tokens\",\n  outputTokens: \"effect_uai_output_tokens\",\n  totalTokens: \"effect_uai_total_tokens\",\n  reasoningTokens: \"effect_uai_reasoning_tokens\",\n  cachedInputTokens: \"effect_uai_cached_input_tokens\",\n} as const\n\n/** Read a structural `_tag` off any value without narrowing to a closed union. */\nconst tagOf = (u: unknown): string | undefined =>\n  Predicate.hasProperty(u, \"_tag\") && Predicate.isString(u._tag) ? u._tag : undefined\n\nconst contentDeltaKind = (ev: unknown): Option.Option<\"text\" | \"reasoning\"> => {\n  const t = tagOf(ev)\n  return t === \"TextDelta\"\n    ? Option.some(\"text\")\n    : t === \"ReasoningDelta\"\n      ? Option.some(\"reasoning\")\n      : Option.none()\n}\n\nconst isTurnCompleteEvent = (ev: unknown): boolean => tagOf(ev) === \"TurnComplete\"\n\nconst turnOf = (ev: unknown): Turn =>\n  (ev as Extract<TurnEvent, { readonly _tag: \"TurnComplete\" }>).turn\n\nconst sumOptional = (a: number | undefined, b: number | undefined): number | undefined =>\n  a === undefined && b === undefined ? undefined : (a ?? 0) + (b ?? 0)\n\nconst addUsage = (a: Usage, b: Usage): Usage => {\n  const cached = sumOptional(\n    a.input_tokens_details?.cached_tokens,\n    b.input_tokens_details?.cached_tokens,\n  )\n  const reasoning = sumOptional(\n    a.output_tokens_details?.reasoning_tokens,\n    b.output_tokens_details?.reasoning_tokens,\n  )\n  return {\n    input_tokens: sumOptional(a.input_tokens, b.input_tokens),\n    output_tokens: sumOptional(a.output_tokens, b.output_tokens),\n    total_tokens: sumOptional(a.total_tokens, b.total_tokens),\n    input_tokens_details: cached === undefined ? undefined : { cached_tokens: cached },\n    output_tokens_details: reasoning === undefined ? undefined : { reasoning_tokens: reasoning },\n  }\n}\n\n/** Per-turn token counts as incremental counter measurements (present fields only). */\nconst usageMeasurements = (usage: Usage): ReadonlyArray<Measurement> => {\n  const pairs: ReadonlyArray<readonly [string, number | undefined]> = [\n    [MetricName.inputTokens, usage.input_tokens],\n    [MetricName.outputTokens, usage.output_tokens],\n    [MetricName.totalTokens, usage.total_tokens],\n    [MetricName.reasoningTokens, usage.output_tokens_details?.reasoning_tokens],\n    [MetricName.cachedInputTokens, usage.input_tokens_details?.cached_tokens],\n  ]\n  return Arr.filterMap(pairs, ([name, value]) =>\n    value === undefined\n      ? Result.failVoid\n      : Result.succeed<Measurement>({ name, kind: \"counter\", value }),\n  )\n}\n\n// ---------------------------------------------------------------------------\n// timeToFirstToken\n// ---------------------------------------------------------------------------\n\nexport type TimeToFirstTokenOptions = {\n  /**\n   * Where the clock starts. `\"request\"` (default) anchors at stream\n   * initialization, i.e. when the provider request fires, so the measurement\n   * includes connection + prefill. `\"first-event\"` anchors at the first\n   * emitted event, isolating decode latency.\n   */\n  readonly from?: \"request\" | \"first-event\"\n}\n\ntype TtftState = {\n  readonly turnIndex: number\n  readonly turnStart: number\n  readonly started: boolean\n  readonly seen: boolean\n}\n\nexport const timeToFirstToken =\n  (options?: TimeToFirstTokenOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> => {\n    const fromRequest = (options?.from ?? \"request\") === \"request\"\n    return Stream.unwrap(\n      Effect.map(Clock.currentTimeMillis, (init) =>\n        self.pipe(\n          Stream.mapAccumEffect(\n            (): TtftState => ({ turnIndex: 0, turnStart: init, started: fromRequest, seen: false }),\n            (state, ev) =>\n              Effect.map(Clock.currentTimeMillis, (now) => {\n                const started = state.started ? state : { ...state, turnStart: now, started: true }\n                const kind = contentDeltaKind(ev)\n                const emitTtft = !started.seen && Option.isSome(kind)\n                const out: ReadonlyArray<A | MetricEvent> = emitTtft\n                  ? [\n                      ev,\n                      makeEvent<Omit<TimeToFirstToken, typeof MetricEventTypeId>>({\n                        _tag: \"TimeToFirstToken\",\n                        turnIndex: started.turnIndex,\n                        elapsed: Duration.millis(now - started.turnStart),\n                        kind: (kind as Option.Some<\"text\" | \"reasoning\">).value,\n                        measurements: [\n                          {\n                            name: MetricName.ttft,\n                            kind: \"timer\",\n                            value: Duration.millis(now - started.turnStart),\n                          },\n                        ],\n                      }),\n                    ]\n                  : [ev]\n                const next: TtftState = isTurnCompleteEvent(ev)\n                  ? {\n                      turnIndex: started.turnIndex + 1,\n                      turnStart: now,\n                      started: fromRequest,\n                      seen: false,\n                    }\n                  : { ...started, seen: started.seen || emitTtft }\n                return [next, out] as const\n              }),\n          ),\n        ),\n      ),\n    )\n  }\n\n// ---------------------------------------------------------------------------\n// timeToCompletion\n// ---------------------------------------------------------------------------\n\ntype CompletionState = {\n  readonly turnIndex: number\n  readonly turnStart: number\n  readonly firstTokenAt: Option.Option<number>\n}\n\nexport const timeToCompletion = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<A | MetricEvent, E, R> =>\n  Stream.unwrap(\n    Effect.map(Clock.currentTimeMillis, (init) =>\n      self.pipe(\n        Stream.mapAccumEffect(\n          (): CompletionState => ({ turnIndex: 0, turnStart: init, firstTokenAt: Option.none() }),\n          (state, ev) =>\n            Effect.map(Clock.currentTimeMillis, (now) => {\n              const firstTokenAt =\n                Option.isNone(state.firstTokenAt) && Option.isSome(contentDeltaKind(ev))\n                  ? Option.some(now)\n                  : state.firstTokenAt\n              if (!isTurnCompleteEvent(ev)) {\n                return [{ ...state, firstTokenAt }, [ev]] as const\n              }\n              const duration = Duration.millis(now - state.turnStart)\n              const generation = Option.match(firstTokenAt, {\n                onNone: () => Duration.zero,\n                onSome: (ft) => Duration.millis(now - ft),\n              })\n              const event = makeEvent<Omit<TimeToCompletion, typeof MetricEventTypeId>>({\n                _tag: \"TimeToCompletion\",\n                turnIndex: state.turnIndex,\n                duration,\n                generation,\n                measurements: [\n                  { name: MetricName.duration, kind: \"timer\", value: duration },\n                  { name: MetricName.generation, kind: \"timer\", value: generation },\n                ],\n              })\n              const next: CompletionState = {\n                turnIndex: state.turnIndex + 1,\n                turnStart: now,\n                firstTokenAt: Option.none(),\n              }\n              return [next, [ev, event]] as const\n            }),\n        ),\n      ),\n    ),\n  )\n\n// ---------------------------------------------------------------------------\n// tokenTotals\n// ---------------------------------------------------------------------------\n\nconst emptyUsage: Usage = {}\n\ntype TotalsState = {\n  readonly turnIndex: number\n  readonly cumulative: Usage\n}\n\nexport const tokenTotals = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<A | MetricEvent, E, R> =>\n  self.pipe(\n    Stream.mapAccumEffect(\n      (): TotalsState => ({ turnIndex: 0, cumulative: emptyUsage }),\n      (state, ev) =>\n        Effect.sync(() => {\n          if (!isTurnCompleteEvent(ev)) return [state, [ev]] as const\n          const usage = turnOf(ev).usage\n          const cumulative = addUsage(state.cumulative, usage)\n          const event = makeEvent<Omit<TokenTotals, typeof MetricEventTypeId>>({\n            _tag: \"TokenTotals\",\n            turnIndex: state.turnIndex,\n            usage,\n            cumulative,\n            measurements: usageMeasurements(usage),\n          })\n          return [{ turnIndex: state.turnIndex + 1, cumulative }, [ev, event]] as const\n        }),\n    ),\n  )\n\n// ---------------------------------------------------------------------------\n// throughput\n// ---------------------------------------------------------------------------\n\nexport type ThroughputOptions = {\n  /** Tick interval. Default `\"1 second\"`. */\n  readonly every?: Duration.Input\n  /** What a \"unit\" is. Default `\"char\"` (exact and chunking-independent). */\n  readonly unit?: \"char\" | \"token\" | \"event\"\n  /** Token counter for `unit: \"token\"`. Absent => approximate 1 per content delta. */\n  readonly tokenizer?: (event: TurnEvent) => Effect.Effect<number>\n  /** Rate definition. Default `\"windowed\"` (current speed, no cold-start bias). */\n  readonly mode?: \"windowed\" | \"cumulative\"\n  /** EWMA smoothing. Omitted => off; `\"default\"` => a sensible factor. */\n  readonly smooth?: \"default\" | number\n}\n\n/**\n * The throughput accumulator. Mutated by the source per content delta and read\n * by the metronome per tick.\n *\n * @internal\n */\nexport type RateState = {\n  readonly units: number\n  readonly lastUnits: number\n  readonly lastMillis: number\n  readonly firstMillis: Option.Option<number>\n  readonly smoothed: Option.Option<number>\n  readonly turnIndex: number\n}\n\nconst initRateState: RateState = {\n  units: 0,\n  lastUnits: 0,\n  lastMillis: 0,\n  firstMillis: Option.none(),\n  smoothed: Option.none(),\n  turnIndex: 0,\n}\n\nconst resolveSmooth = (smooth: ThroughputOptions[\"smooth\"]): number | undefined =>\n  smooth === undefined ? undefined : smooth === \"default\" ? 0.3 : smooth\n\n/**\n * Pure per-tick rate computation. Returns `None` before the first token, else\n * the rate, the window it was measured over, and the next accumulator state.\n * Separated from the metronome so the rate math is unit-testable without time.\n *\n * @internal\n */\nexport const computeThroughputTick = (\n  state: RateState,\n  now: number,\n  mode: \"windowed\" | \"cumulative\",\n  smooth: number | undefined,\n): Option.Option<{\n  readonly rate: number\n  readonly window: Duration.Duration\n  readonly next: RateState\n}> =>\n  Option.map(state.firstMillis, (first) => {\n    const windowMs = mode === \"windowed\" ? now - state.lastMillis : now - first\n    const deltaUnits = mode === \"windowed\" ? state.units - state.lastUnits : state.units\n    const instant = windowMs > 0 ? (deltaUnits / windowMs) * 1000 : 0\n    const rate =\n      smooth === undefined\n        ? instant\n        : Option.match(state.smoothed, {\n            onNone: () => instant,\n            onSome: (prev) => smooth * instant + (1 - smooth) * prev,\n          })\n    return {\n      rate,\n      window: Duration.millis(windowMs),\n      next: { ...state, lastUnits: state.units, lastMillis: now, smoothed: Option.some(rate) },\n    }\n  })\n\nconst addUnits = (state: RateState, n: number, now: number): RateState =>\n  Option.isNone(state.firstMillis)\n    ? { ...state, units: n, lastUnits: 0, lastMillis: now, firstMillis: Option.some(now) }\n    : { ...state, units: state.units + n }\n\nconst resetTurn = (state: RateState): RateState => ({\n  ...initRateState,\n  turnIndex: state.turnIndex + 1,\n})\n\nconst unitCount = (\n  ev: unknown,\n  unit: \"char\" | \"token\" | \"event\",\n  tokenizer: ThroughputOptions[\"tokenizer\"],\n): Effect.Effect<number> => {\n  if (tagOf(ev) !== \"TextDelta\") return Effect.succeed(0)\n  const text = (ev as { readonly text: string }).text\n  return Match.value(unit).pipe(\n    Match.when(\"char\", () => Effect.succeed([...text].length)),\n    Match.when(\"event\", () => Effect.succeed(1)),\n    Match.when(\"token\", () =>\n      tokenizer === undefined ? Effect.succeed(1) : tokenizer(ev as TurnEvent),\n    ),\n    Match.exhaustive,\n  )\n}\n\nconst throughputName = (unit: \"char\" | \"token\" | \"event\"): string =>\n  `effect_uai_output_${unit}s_per_second`\n\nexport const throughput =\n  (options?: ThroughputOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> => {\n    const unit = options?.unit ?? \"char\"\n    const mode = options?.mode ?? \"windowed\"\n    const every = options?.every ?? Duration.seconds(1)\n    const smooth = resolveSmooth(options?.smooth)\n    const tokenizer = options?.tokenizer\n    const name = throughputName(unit)\n\n    return Stream.unwrap(\n      Effect.map(Ref.make(initRateState), (ref) => {\n        const source = self.pipe(\n          Stream.tap((ev) =>\n            isTurnCompleteEvent(ev)\n              ? Ref.update(ref, resetTurn)\n              : tagOf(ev) === \"TextDelta\"\n                ? Effect.flatMap(Clock.currentTimeMillis, (now) =>\n                    Effect.flatMap(unitCount(ev, unit, tokenizer), (n) =>\n                      Ref.update(ref, (state) => addUnits(state, n, now)),\n                    ),\n                  )\n                : Effect.void,\n          ),\n        )\n        const metronome: Stream.Stream<MetricEvent> = Stream.fromSchedule(\n          Schedule.spaced(every),\n        ).pipe(\n          Stream.mapEffect(() =>\n            Effect.flatMap(Clock.currentTimeMillis, (now) =>\n              Ref.modify(ref, (state) =>\n                Option.match(computeThroughputTick(state, now, mode, smooth), {\n                  onNone: () => [Option.none<MetricEvent>(), state] as const,\n                  onSome: ({ next, rate, window }) =>\n                    [\n                      Option.some<MetricEvent>(\n                        makeEvent<Omit<Throughput, typeof MetricEventTypeId>>({\n                          _tag: \"Throughput\",\n                          turnIndex: state.turnIndex,\n                          ratePerSecond: rate,\n                          unit,\n                          window,\n                          measurements: [{ name, kind: \"histogram\", value: rate }],\n                        }),\n                      ),\n                      next,\n                    ] as const,\n                }),\n              ),\n            ),\n          ),\n          Stream.filterMap((o) => (Option.isSome(o) ? Result.succeed(o.value) : Result.failVoid)),\n        )\n        return source.pipe(Stream.merge(metronome, { haltStrategy: \"left\" }))\n      }),\n    )\n  }\n\n// ---------------------------------------------------------------------------\n// allMetrics\n// ---------------------------------------------------------------------------\n\nexport type AllMetricsOptions = {\n  readonly timeToFirstToken?: TimeToFirstTokenOptions\n  readonly throughput?: ThroughputOptions\n}\n\nexport const allMetrics =\n  (options?: AllMetricsOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> =>\n    self.pipe(\n      timeToFirstToken(options?.timeToFirstToken),\n      throughput(options?.throughput),\n      tokenTotals,\n      timeToCompletion,\n    )\n"],"mappings":"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"}
+{"version":3,"file":"Metrics.mjs","names":["Arr"],"sources":["../../src/observability/Metrics.ts"],"sourcesContent":["import {\n  Array as Arr,\n  Clock,\n  Duration,\n  Effect,\n  Match,\n  Option,\n  Predicate,\n  Ref,\n  Result,\n  Schedule,\n  Stream,\n} from \"effect\"\nimport type { Usage } from \"../domain/Items.js\"\nimport { type Turn, TurnEvent } from \"../domain/Turn.js\"\n\n// ---------------------------------------------------------------------------\n// Self-describing measurements (the exporter-facing payload)\n// ---------------------------------------------------------------------------\n\n/**\n * The instrument-agnostic description of a single recorded value. The\n * `Telemetry` recorder reads only this: it builds (or reuses) a `Metric`\n * instrument from `kind` + `name` and updates it with `value`. A new metric,\n * built-in or user-defined, never requires a change to the recorder.\n */\nexport type Measurement = {\n  readonly name: string\n  readonly kind: \"counter\" | \"histogram\" | \"timer\" | \"gauge\"\n  readonly value: number | Duration.Duration\n  readonly attributes?: Readonly<Record<string, string>> | undefined\n}\n\n// ---------------------------------------------------------------------------\n// MetricEvent: an open, brand-marked union (built-ins + user metrics)\n// ---------------------------------------------------------------------------\n\n/**\n * Brand stamped on every metric event. `isMetricEvent` checks this symbol,\n * not an enumerated `_tag`, so events are distinguished from `TurnEvent`s,\n * tool outputs, and arbitrary custom loop values regardless of their tag.\n * This is the same TypeId-symbol pattern Effect uses for `isStream` etc.\n */\nexport const MetricEventTypeId: unique symbol = Symbol.for(\n  \"@effect-uai/core/observability/MetricEvent\",\n)\n\n/**\n * The structural contract every metric event satisfies, ours and custom.\n * The `_tag` + extra typed fields serve a frontend; the brand + `measurements`\n * serve the exporter.\n */\nexport type MetricEvent = {\n  readonly [MetricEventTypeId]: typeof MetricEventTypeId\n  readonly _tag: string\n  /** Which turn within the piped stream this sample belongs to (0-based). */\n  readonly turnIndex: number\n  readonly measurements: ReadonlyArray<Measurement>\n}\n\n/** Request/turn start to the first content delta. */\nexport type TimeToFirstToken = MetricEvent & {\n  readonly _tag: \"TimeToFirstToken\"\n  readonly elapsed: Duration.Duration\n  readonly kind: \"text\" | \"reasoning\"\n}\n\n/** A live output rate, emitted on the metronome cadence. */\nexport type Throughput = MetricEvent & {\n  readonly _tag: \"Throughput\"\n  readonly ratePerSecond: number\n  readonly unit: \"char\" | \"token\" | \"event\"\n  readonly window: Duration.Duration\n}\n\n/** Provider-reported usage at `TurnComplete`, this turn and cumulative. */\nexport type TokenTotals = MetricEvent & {\n  readonly _tag: \"TokenTotals\"\n  readonly usage: Usage\n  readonly cumulative: Usage\n}\n\n/** Per-turn wall times at `TurnComplete`. */\nexport type TimeToCompletion = MetricEvent & {\n  readonly _tag: \"TimeToCompletion\"\n  readonly duration: Duration.Duration\n  readonly generation: Duration.Duration\n}\n\n/**\n * Mint a custom metric event. Stamp it with the brand and provide a\n * well-formed `measurements` array; `Telemetry.record` will export it with no\n * changes to the recorder. The only constraint is that each measurement's\n * `kind` is one the recorder maps.\n */\nexport const makeEvent = <Fields extends Omit<MetricEvent, typeof MetricEventTypeId>>(\n  fields: Fields,\n): Fields & { readonly [MetricEventTypeId]: typeof MetricEventTypeId } => ({\n  [MetricEventTypeId]: MetricEventTypeId,\n  ...fields,\n})\n\n/** Structural (brand-based) guard for any metric event, built-in or custom. */\nexport const isMetricEvent = (u: unknown): u is MetricEvent =>\n  Predicate.hasProperty(u, MetricEventTypeId)\n\n/**\n * Project a stream of mixed events onto just its metric samples, for a side\n * channel or a frontend feed.\n */\nexport const metricEvents = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<MetricEvent, E, R> =>\n  self.pipe(Stream.filterMap((ev) => (isMetricEvent(ev) ? Result.succeed(ev) : Result.failVoid)))\n\n// ---------------------------------------------------------------------------\n// Internal helpers\n// ---------------------------------------------------------------------------\n\nconst MetricName = {\n  ttft: \"effect_uai_turn_ttft\",\n  duration: \"effect_uai_turn_duration\",\n  generation: \"effect_uai_turn_generation\",\n  inputTokens: \"effect_uai_input_tokens\",\n  outputTokens: \"effect_uai_output_tokens\",\n  totalTokens: \"effect_uai_total_tokens\",\n  reasoningTokens: \"effect_uai_reasoning_tokens\",\n  cachedInputTokens: \"effect_uai_cached_input_tokens\",\n  cacheWriteTokens: \"effect_uai_cache_write_tokens\",\n} as const\n\n/** Read a structural `_tag` off any value without narrowing to a closed union. */\nconst tagOf = (u: unknown): string | undefined =>\n  Predicate.hasProperty(u, \"_tag\") && Predicate.isString(u._tag) ? u._tag : undefined\n\nconst contentDeltaKind = (ev: unknown): Option.Option<\"text\" | \"reasoning\"> => {\n  const t = tagOf(ev)\n  return t === \"TextDelta\"\n    ? Option.some(\"text\")\n    : t === \"ReasoningDelta\"\n      ? Option.some(\"reasoning\")\n      : Option.none()\n}\n\nconst isTextDelta = TurnEvent.$is(\"TextDelta\")\nconst isReasoningDelta = TurnEvent.$is(\"ReasoningDelta\")\nconst isRefusalDelta = TurnEvent.$is(\"RefusalDelta\")\nconst isToolCallArgsDelta = TurnEvent.$is(\"ToolCallArgsDelta\")\n\n/** A delta carrying generated output, whatever the model was producing. */\nexport type OutputDelta = Extract<\n  TurnEvent,\n  { readonly _tag: \"TextDelta\" | \"ReasoningDelta\" | \"RefusalDelta\" | \"ToolCallArgsDelta\" }\n>\n\n/**\n * Narrow to a delta that contributes to the model's output stream. Tool-call\n * arguments count: an agent turn can be almost entirely `ToolCallArgsDelta`,\n * and measuring only prose reports a near-zero rate for it.\n *\n * The single place the output-delta tag list lives — the throughput\n * accumulator and `unitCount` both read it. Distinct from `contentDeltaKind`,\n * which answers a narrower question for first-token latency.\n */\nconst outputDelta = (ev: unknown): Option.Option<OutputDelta> =>\n  isTextDelta(ev) || isReasoningDelta(ev) || isRefusalDelta(ev) || isToolCallArgsDelta(ev)\n    ? Option.some(ev)\n    : Option.none()\n\nconst outputTextOf = (delta: OutputDelta): string =>\n  isToolCallArgsDelta(delta) ? delta.delta : delta.text\n\nconst isTurnCompleteEvent = (ev: unknown): boolean => tagOf(ev) === \"TurnComplete\"\n\nconst turnOf = (ev: unknown): Turn =>\n  (ev as Extract<TurnEvent, { readonly _tag: \"TurnComplete\" }>).turn\n\nconst sumOptional = (a: number | undefined, b: number | undefined): number | undefined =>\n  a === undefined && b === undefined ? undefined : (a ?? 0) + (b ?? 0)\n\nconst addUsage = (a: Usage, b: Usage): Usage => {\n  const cached = sumOptional(\n    a.input_tokens_details?.cached_tokens,\n    b.input_tokens_details?.cached_tokens,\n  )\n  const cacheWrite = sumOptional(\n    a.input_tokens_details?.cache_write_tokens,\n    b.input_tokens_details?.cache_write_tokens,\n  )\n  const reasoning = sumOptional(\n    a.output_tokens_details?.reasoning_tokens,\n    b.output_tokens_details?.reasoning_tokens,\n  )\n  return {\n    input_tokens: sumOptional(a.input_tokens, b.input_tokens),\n    output_tokens: sumOptional(a.output_tokens, b.output_tokens),\n    total_tokens: sumOptional(a.total_tokens, b.total_tokens),\n    input_tokens_details:\n      cached === undefined && cacheWrite === undefined\n        ? undefined\n        : {\n            ...(cached !== undefined && { cached_tokens: cached }),\n            ...(cacheWrite !== undefined && { cache_write_tokens: cacheWrite }),\n          },\n    output_tokens_details: reasoning === undefined ? undefined : { reasoning_tokens: reasoning },\n  }\n}\n\n/** Per-turn token counts as incremental counter measurements (present fields only). */\nconst usageMeasurements = (usage: Usage): ReadonlyArray<Measurement> => {\n  const pairs: ReadonlyArray<readonly [string, number | undefined]> = [\n    [MetricName.inputTokens, usage.input_tokens],\n    [MetricName.outputTokens, usage.output_tokens],\n    [MetricName.totalTokens, usage.total_tokens],\n    [MetricName.reasoningTokens, usage.output_tokens_details?.reasoning_tokens],\n    [MetricName.cachedInputTokens, usage.input_tokens_details?.cached_tokens],\n    [MetricName.cacheWriteTokens, usage.input_tokens_details?.cache_write_tokens],\n  ]\n  return Arr.filterMap(pairs, ([name, value]) =>\n    value === undefined\n      ? Result.failVoid\n      : Result.succeed<Measurement>({ name, kind: \"counter\", value }),\n  )\n}\n\n// ---------------------------------------------------------------------------\n// timeToFirstToken\n// ---------------------------------------------------------------------------\n\nexport type TimeToFirstTokenOptions = {\n  /**\n   * Where the clock starts. `\"request\"` (default) anchors at stream\n   * initialization, i.e. when the provider request fires, so the measurement\n   * includes connection + prefill. `\"first-event\"` anchors at the first\n   * emitted event, isolating decode latency.\n   */\n  readonly from?: \"request\" | \"first-event\"\n}\n\ntype TtftState = {\n  readonly turnIndex: number\n  readonly turnStart: number\n  readonly started: boolean\n  readonly seen: boolean\n}\n\nexport const timeToFirstToken =\n  (options?: TimeToFirstTokenOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> => {\n    const fromRequest = (options?.from ?? \"request\") === \"request\"\n    return Stream.unwrap(\n      Effect.map(Clock.currentTimeMillis, (init) =>\n        self.pipe(\n          Stream.mapAccumEffect(\n            (): TtftState => ({ turnIndex: 0, turnStart: init, started: fromRequest, seen: false }),\n            (state, ev) =>\n              Effect.map(Clock.currentTimeMillis, (now) => {\n                const started = state.started ? state : { ...state, turnStart: now, started: true }\n                const kind = contentDeltaKind(ev)\n                const emitTtft = !started.seen && Option.isSome(kind)\n                const out: ReadonlyArray<A | MetricEvent> = emitTtft\n                  ? [\n                      ev,\n                      makeEvent<Omit<TimeToFirstToken, typeof MetricEventTypeId>>({\n                        _tag: \"TimeToFirstToken\",\n                        turnIndex: started.turnIndex,\n                        elapsed: Duration.millis(now - started.turnStart),\n                        kind: (kind as Option.Some<\"text\" | \"reasoning\">).value,\n                        measurements: [\n                          {\n                            name: MetricName.ttft,\n                            kind: \"timer\",\n                            value: Duration.millis(now - started.turnStart),\n                          },\n                        ],\n                      }),\n                    ]\n                  : [ev]\n                const next: TtftState = isTurnCompleteEvent(ev)\n                  ? {\n                      turnIndex: started.turnIndex + 1,\n                      turnStart: now,\n                      started: fromRequest,\n                      seen: false,\n                    }\n                  : { ...started, seen: started.seen || emitTtft }\n                return [next, out] as const\n              }),\n          ),\n        ),\n      ),\n    )\n  }\n\n// ---------------------------------------------------------------------------\n// timeToCompletion\n// ---------------------------------------------------------------------------\n\ntype CompletionState = {\n  readonly turnIndex: number\n  readonly turnStart: number\n  readonly firstTokenAt: Option.Option<number>\n}\n\nexport const timeToCompletion = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<A | MetricEvent, E, R> =>\n  Stream.unwrap(\n    Effect.map(Clock.currentTimeMillis, (init) =>\n      self.pipe(\n        Stream.mapAccumEffect(\n          (): CompletionState => ({ turnIndex: 0, turnStart: init, firstTokenAt: Option.none() }),\n          (state, ev) =>\n            Effect.map(Clock.currentTimeMillis, (now) => {\n              const firstTokenAt =\n                Option.isNone(state.firstTokenAt) && Option.isSome(contentDeltaKind(ev))\n                  ? Option.some(now)\n                  : state.firstTokenAt\n              if (!isTurnCompleteEvent(ev)) {\n                return [{ ...state, firstTokenAt }, [ev]] as const\n              }\n              const duration = Duration.millis(now - state.turnStart)\n              const generation = Option.match(firstTokenAt, {\n                onNone: () => Duration.zero,\n                onSome: (ft) => Duration.millis(now - ft),\n              })\n              const event = makeEvent<Omit<TimeToCompletion, typeof MetricEventTypeId>>({\n                _tag: \"TimeToCompletion\",\n                turnIndex: state.turnIndex,\n                duration,\n                generation,\n                measurements: [\n                  { name: MetricName.duration, kind: \"timer\", value: duration },\n                  { name: MetricName.generation, kind: \"timer\", value: generation },\n                ],\n              })\n              const next: CompletionState = {\n                turnIndex: state.turnIndex + 1,\n                turnStart: now,\n                firstTokenAt: Option.none(),\n              }\n              return [next, [ev, event]] as const\n            }),\n        ),\n      ),\n    ),\n  )\n\n// ---------------------------------------------------------------------------\n// tokenTotals\n// ---------------------------------------------------------------------------\n\nconst emptyUsage: Usage = {}\n\ntype TotalsState = {\n  readonly turnIndex: number\n  readonly cumulative: Usage\n}\n\nexport const tokenTotals = <A, E, R>(\n  self: Stream.Stream<A, E, R>,\n): Stream.Stream<A | MetricEvent, E, R> =>\n  self.pipe(\n    Stream.mapAccumEffect(\n      (): TotalsState => ({ turnIndex: 0, cumulative: emptyUsage }),\n      (state, ev) =>\n        Effect.sync(() => {\n          if (!isTurnCompleteEvent(ev)) return [state, [ev]] as const\n          const usage = turnOf(ev).usage\n          const cumulative = addUsage(state.cumulative, usage)\n          const event = makeEvent<Omit<TokenTotals, typeof MetricEventTypeId>>({\n            _tag: \"TokenTotals\",\n            turnIndex: state.turnIndex,\n            usage,\n            cumulative,\n            measurements: usageMeasurements(usage),\n          })\n          return [{ turnIndex: state.turnIndex + 1, cumulative }, [ev, event]] as const\n        }),\n    ),\n  )\n\n// ---------------------------------------------------------------------------\n// throughput\n// ---------------------------------------------------------------------------\n\nexport type ThroughputOptions = {\n  /** Tick interval. Default `\"1 second\"`. */\n  readonly every?: Duration.Input\n  /** What a \"unit\" is. Default `\"char\"` (exact and chunking-independent). */\n  readonly unit?: \"char\" | \"token\" | \"event\"\n  /**\n   * Token counter for `unit: \"token\"`. Called only for deltas that carry\n   * generated output. Absent => approximate 1 per such delta.\n   */\n  readonly tokenizer?: (event: OutputDelta) => Effect.Effect<number>\n  /** Rate definition. Default `\"windowed\"` (current speed, no cold-start bias). */\n  readonly mode?: \"windowed\" | \"cumulative\"\n  /** EWMA smoothing. Omitted => off; `\"default\"` => a sensible factor. */\n  readonly smooth?: \"default\" | number\n}\n\n/**\n * The throughput accumulator. Mutated by the source per content delta and read\n * by the metronome per tick.\n *\n * @internal\n */\nexport type RateState = {\n  readonly units: number\n  readonly lastUnits: number\n  readonly lastMillis: number\n  readonly firstMillis: Option.Option<number>\n  readonly smoothed: Option.Option<number>\n  readonly turnIndex: number\n}\n\nconst initRateState: RateState = {\n  units: 0,\n  lastUnits: 0,\n  lastMillis: 0,\n  firstMillis: Option.none(),\n  smoothed: Option.none(),\n  turnIndex: 0,\n}\n\nconst resolveSmooth = (smooth: ThroughputOptions[\"smooth\"]): number | undefined =>\n  smooth === undefined ? undefined : smooth === \"default\" ? 0.3 : smooth\n\n/**\n * Pure per-tick rate computation. Returns `None` before the first token, else\n * the rate, the window it was measured over, and the next accumulator state.\n * Separated from the metronome so the rate math is unit-testable without time.\n *\n * @internal\n */\nexport const computeThroughputTick = (\n  state: RateState,\n  now: number,\n  mode: \"windowed\" | \"cumulative\",\n  smooth: number | undefined,\n): Option.Option<{\n  readonly rate: number\n  readonly window: Duration.Duration\n  readonly next: RateState\n}> =>\n  Option.map(state.firstMillis, (first) => {\n    const windowMs = mode === \"windowed\" ? now - state.lastMillis : now - first\n    const deltaUnits = mode === \"windowed\" ? state.units - state.lastUnits : state.units\n    const instant = windowMs > 0 ? (deltaUnits / windowMs) * 1000 : 0\n    const rate =\n      smooth === undefined\n        ? instant\n        : Option.match(state.smoothed, {\n            onNone: () => instant,\n            onSome: (prev) => smooth * instant + (1 - smooth) * prev,\n          })\n    return {\n      rate,\n      window: Duration.millis(windowMs),\n      next: { ...state, lastUnits: state.units, lastMillis: now, smoothed: Option.some(rate) },\n    }\n  })\n\nconst addUnits = (state: RateState, n: number, now: number): RateState =>\n  Option.isNone(state.firstMillis)\n    ? { ...state, units: n, lastUnits: 0, lastMillis: now, firstMillis: Option.some(now) }\n    : { ...state, units: state.units + n }\n\nconst resetTurn = (state: RateState): RateState => ({\n  ...initRateState,\n  turnIndex: state.turnIndex + 1,\n})\n\nconst unitCount = (\n  ev: unknown,\n  unit: \"char\" | \"token\" | \"event\",\n  tokenizer: ThroughputOptions[\"tokenizer\"],\n): Effect.Effect<number> => {\n  const output = outputDelta(ev)\n  if (Option.isNone(output)) return Effect.succeed(0)\n  const delta = output.value\n  return Match.value(unit).pipe(\n    Match.when(\"char\", () => Effect.succeed([...outputTextOf(delta)].length)),\n    Match.when(\"event\", () => Effect.succeed(1)),\n    Match.when(\"token\", () => (tokenizer === undefined ? Effect.succeed(1) : tokenizer(delta))),\n    Match.exhaustive,\n  )\n}\n\nconst throughputName = (unit: \"char\" | \"token\" | \"event\"): string =>\n  `effect_uai_output_${unit}s_per_second`\n\nexport const throughput =\n  (options?: ThroughputOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> => {\n    const unit = options?.unit ?? \"char\"\n    const mode = options?.mode ?? \"windowed\"\n    const every = options?.every ?? Duration.seconds(1)\n    const smooth = resolveSmooth(options?.smooth)\n    const tokenizer = options?.tokenizer\n    const name = throughputName(unit)\n\n    return Stream.unwrap(\n      Effect.map(Ref.make(initRateState), (ref) => {\n        const source = self.pipe(\n          Stream.tap((ev) =>\n            isTurnCompleteEvent(ev)\n              ? Ref.update(ref, resetTurn)\n              : Option.isSome(outputDelta(ev))\n                ? Effect.flatMap(Clock.currentTimeMillis, (now) =>\n                    Effect.flatMap(unitCount(ev, unit, tokenizer), (n) =>\n                      Ref.update(ref, (state) => addUnits(state, n, now)),\n                    ),\n                  )\n                : Effect.void,\n          ),\n        )\n        const metronome: Stream.Stream<MetricEvent> = Stream.fromSchedule(\n          Schedule.spaced(every),\n        ).pipe(\n          Stream.mapEffect(() =>\n            Effect.flatMap(Clock.currentTimeMillis, (now) =>\n              Ref.modify(ref, (state) =>\n                Option.match(computeThroughputTick(state, now, mode, smooth), {\n                  onNone: () => [Option.none<MetricEvent>(), state] as const,\n                  onSome: ({ next, rate, window }) =>\n                    [\n                      Option.some<MetricEvent>(\n                        makeEvent<Omit<Throughput, typeof MetricEventTypeId>>({\n                          _tag: \"Throughput\",\n                          turnIndex: state.turnIndex,\n                          ratePerSecond: rate,\n                          unit,\n                          window,\n                          measurements: [{ name, kind: \"histogram\", value: rate }],\n                        }),\n                      ),\n                      next,\n                    ] as const,\n                }),\n              ),\n            ),\n          ),\n          Stream.filterMap((o) => (Option.isSome(o) ? Result.succeed(o.value) : Result.failVoid)),\n        )\n        return source.pipe(Stream.merge(metronome, { haltStrategy: \"left\" }))\n      }),\n    )\n  }\n\n// ---------------------------------------------------------------------------\n// allMetrics\n// ---------------------------------------------------------------------------\n\nexport type AllMetricsOptions = {\n  readonly timeToFirstToken?: TimeToFirstTokenOptions\n  readonly throughput?: ThroughputOptions\n}\n\nexport const allMetrics =\n  (options?: AllMetricsOptions) =>\n  <A, E, R>(self: Stream.Stream<A, E, R>): Stream.Stream<A | MetricEvent, E, R> =>\n    self.pipe(\n      timeToFirstToken(options?.timeToFirstToken),\n      throughput(options?.throughput),\n      tokenTotals,\n      timeToCompletion,\n    )\n"],"mappings":"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"}

package/dist/observability/Metrics.test.d.mts

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

package/dist/observability/Metrics.test.mjs

@@ -1,7 +1,8 @@
 import { TurnEvent } from "../domain/Turn.mjs";
 import { computeThroughputTick, isMetricEvent, makeEvent, metricEvents, throughput, timeToCompletion, timeToFirstToken, tokenTotals } from "./Metrics.mjs";
-import { n as globalExpect, o as describe } from "../dist-CcRV3-A5.mjs";
-import { t as it } from "../dist-C0m0QnUP.mjs";
+import { o as describe } from "../utils-CiH_DjFW.mjs";
+import { n as globalExpect } from "../test.DNmyFkvJ-YPzDR0Co.mjs";
+import { t as it } from "../dist-nohcnkD6.mjs";
 import { Array, Duration, Effect, Fiber, Option, Stream } from "effect";
 import * as TestClock from "effect/testing/TestClock";
 //#region src/observability/Metrics.test.ts
@@ -11,6 +12,10 @@ const turnComplete = (usage) => TurnEvent.TurnComplete({ turn: {
 	stop_reason: "stop"
 } });
 const text = (s) => TurnEvent.TextDelta({ text: s });
+const toolArgs = (s) => TurnEvent.ToolCallArgsDelta({
+	call_id: "call_1",
+	delta: s
+});
 const samples = (events) => events.filter(isMetricEvent);
 const head = (xs) => Option.getOrThrow(Array.head(xs));
 const tagged = (events, tag) => samples(events).filter((e) => e._tag === tag);
@@ -27,7 +32,8 @@ describe("tokenTotals", () => {
 			output_tokens: 20,
 			total_tokens: 120
 		}));
-		const totals = tagged(yield* Stream.runCollect(stream.pipe(tokenTotals)), "TokenTotals");
+		const out = yield* Stream.runCollect(stream.pipe(tokenTotals));
+		const totals = tagged(out, "TokenTotals");
 		globalExpect(totals).toHaveLength(1);
 		globalExpect(head(totals).turnIndex).toBe(0);
 		globalExpect(head(totals).usage.output_tokens).toBe(20);
@@ -41,7 +47,8 @@ describe("tokenTotals", () => {
 			input_tokens: 1300,
 			output_tokens: 410
 		}));
-		const totals = tagged(yield* Stream.runCollect(stream.pipe(tokenTotals)), "TokenTotals");
+		const out = yield* Stream.runCollect(stream.pipe(tokenTotals));
+		const totals = tagged(out, "TokenTotals");
 		globalExpect(totals.map((t) => t.turnIndex)).toEqual([0, 1]);
 		globalExpect(totals.map((t) => t.usage.output_tokens)).toEqual([120, 410]);
 		globalExpect(totals.map((t) => t.cumulative.input_tokens)).toEqual([1e3, 2300]);
@@ -49,56 +56,88 @@ describe("tokenTotals", () => {
 	}));
 	it.effect("emits an incremental output_tokens counter measurement per turn", () => Effect.gen(function* () {
 		const stream = Stream.make(turnComplete({ output_tokens: 7 }));
-		globalExpect(head(samples(yield* Stream.runCollect(stream.pipe(tokenTotals)))).measurements.find((m) => m.name === "effect_uai_output_tokens")).toEqual({
+		const out = yield* Stream.runCollect(stream.pipe(tokenTotals));
+		const m = head(samples(out)).measurements.find((m) => m.name === "effect_uai_output_tokens");
+		globalExpect(m).toEqual({
 			name: "effect_uai_output_tokens",
 			kind: "counter",
 			value: 7
 		});
 	}));
+	it.effect("carries cache read and write tokens through usage and measurements", () => Effect.gen(function* () {
+		const stream = Stream.make(turnComplete({
+			input_tokens: 94,
+			input_tokens_details: {
+				cached_tokens: 31851,
+				cache_write_tokens: 604
+			}
+		}), turnComplete({
+			input_tokens: 6,
+			input_tokens_details: { cached_tokens: 32e3 }
+		}));
+		const out = yield* Stream.runCollect(stream.pipe(tokenTotals));
+		const totals = tagged(out, "TokenTotals");
+		globalExpect(totals.map((t) => t.cumulative.input_tokens_details?.cache_write_tokens)).toEqual([604, 604]);
+		globalExpect(totals.map((t) => t.cumulative.input_tokens_details?.cached_tokens)).toEqual([31851, 63851]);
+		const write = head(totals).measurements.find((m) => m.name === "effect_uai_cache_write_tokens");
+		globalExpect(write).toEqual({
+			name: "effect_uai_cache_write_tokens",
+			kind: "counter",
+			value: 604
+		});
+	}));
 });
 describe("timeToFirstToken", () => {
 	it.effect("fires on the first content delta, measured from request (stream init)", () => Effect.gen(function* () {
-		const ttft = tagged(yield* runTimed(timed([["300 millis", text("hello")], ["700 millis", turnComplete({})]]).pipe(timeToFirstToken()), ["300 millis", "700 millis"]), "TimeToFirstToken");
+		const stream = timed([["300 millis", text("hello")], ["700 millis", turnComplete({})]]).pipe(timeToFirstToken());
+		const out = yield* runTimed(stream, ["300 millis", "700 millis"]);
+		const ttft = tagged(out, "TimeToFirstToken");
 		globalExpect(ttft).toHaveLength(1);
 		globalExpect(Duration.toMillis(head(ttft).elapsed)).toBe(300);
 		globalExpect(head(ttft).kind).toBe("text");
 	}));
 	it.effect("reports kind reasoning when reasoning arrives first", () => Effect.gen(function* () {
-		const ttft = tagged(yield* runTimed(timed([
+		const stream = timed([
 			["120 millis", TurnEvent.ReasoningDelta({
 				text: "...",
 				kind: "trace"
 			})],
 			["80 millis", text("answer")],
 			["50 millis", turnComplete({})]
-		]).pipe(timeToFirstToken()), [
+		]).pipe(timeToFirstToken());
+		const out = yield* runTimed(stream, [
 			"120 millis",
 			"80 millis",
 			"50 millis"
-		]), "TimeToFirstToken");
+		]);
+		const ttft = tagged(out, "TimeToFirstToken");
 		globalExpect(ttft).toHaveLength(1);
 		globalExpect(head(ttft).kind).toBe("reasoning");
 		globalExpect(Duration.toMillis(head(ttft).elapsed)).toBe(120);
 	}));
 	it.effect("loop level: one TTFT per turn, turnIndex increments", () => Effect.gen(function* () {
-		const ttft = tagged(yield* runTimed(timed([
+		const stream = timed([
 			["200 millis", text("a")],
 			["100 millis", turnComplete({})],
 			["300 millis", text("b")],
 			["100 millis", turnComplete({})]
-		]).pipe(timeToFirstToken()), [
+		]).pipe(timeToFirstToken());
+		const out = yield* runTimed(stream, [
 			"200 millis",
 			"100 millis",
 			"300 millis",
 			"100 millis"
-		]), "TimeToFirstToken");
+		]);
+		const ttft = tagged(out, "TimeToFirstToken");
 		globalExpect(ttft.map((t) => t.turnIndex)).toEqual([0, 1]);
 		globalExpect(ttft.map((t) => Duration.toMillis(t.elapsed))).toEqual([200, 300]);
 	}));
 });
 describe("timeToCompletion", () => {
 	it.effect("reports duration (request->complete) and generation (first token->complete)", () => Effect.gen(function* () {
-		const done = tagged(yield* runTimed(timed([["300 millis", text("hi")], ["700 millis", turnComplete({})]]).pipe(timeToCompletion), ["300 millis", "700 millis"]), "TimeToCompletion");
+		const stream = timed([["300 millis", text("hi")], ["700 millis", turnComplete({})]]).pipe(timeToCompletion);
+		const out = yield* runTimed(stream, ["300 millis", "700 millis"]);
+		const done = tagged(out, "TimeToCompletion");
 		globalExpect(done).toHaveLength(1);
 		globalExpect(Duration.toMillis(head(done).duration)).toBe(1e3);
 		globalExpect(Duration.toMillis(head(done).generation)).toBe(700);
@@ -117,52 +156,76 @@ describe("computeThroughputTick", () => {
 		globalExpect(Option.isNone(computeThroughputTick(base, 500, "windowed", void 0))).toBe(true);
 	});
 	it("windowed: rate is units in the last interval over that interval", () => {
-		const r = computeThroughputTick({
+		const state = {
 			...base,
 			units: 30,
 			lastUnits: 10,
 			lastMillis: 500,
 			firstMillis: Option.some(100)
-		}, 1e3, "windowed", void 0);
+		};
+		const r = computeThroughputTick(state, 1e3, "windowed", void 0);
 		globalExpect(Option.getOrThrow(r).rate).toBe(40);
 	});
 	it("cumulative: rate is total units over time since first token", () => {
-		const r = computeThroughputTick({
+		const state = {
 			...base,
 			units: 30,
 			lastUnits: 10,
 			lastMillis: 500,
 			firstMillis: Option.some(100)
-		}, 1e3, "cumulative", void 0);
+		};
+		const r = computeThroughputTick(state, 1e3, "cumulative", void 0);
 		globalExpect(Option.getOrThrow(r).rate).toBeCloseTo(33.333, 2);
 	});
 	it("smooth: blends the instantaneous rate with the carried average", () => {
-		const r = computeThroughputTick({
+		const state = {
 			...base,
 			units: 20,
 			lastUnits: 0,
 			lastMillis: 0,
 			firstMillis: Option.some(0),
 			smoothed: Option.some(100)
-		}, 1e3, "windowed", .5);
+		};
+		const r = computeThroughputTick(state, 1e3, "windowed", .5);
 		globalExpect(Option.getOrThrow(r).rate).toBe(60);
 	});
 });
 describe("throughput (metronome)", () => {
 	it.effect("emits a live char rate on the tick, over the elapsed window", () => Effect.gen(function* () {
-		const rates = (yield* runTimed(Stream.make(text("aaaaa"), text("aaaaa")).pipe(Stream.concat(timed([["10 seconds", turnComplete({})]]))).pipe(throughput({
+		const stream = Stream.make(text("aaaaa"), text("aaaaa")).pipe(Stream.concat(timed([["10 seconds", turnComplete({})]]))).pipe(throughput({
 			every: "1 second",
 			unit: "char"
-		}), metricEvents, Stream.take(1)), ["1 second"])).filter((e) => e._tag === "Throughput");
+		}), metricEvents, Stream.take(1));
+		const rates = (yield* runTimed(stream, ["1 second"])).filter((e) => e._tag === "Throughput");
 		globalExpect(rates).toHaveLength(1);
 		globalExpect(head(rates).unit).toBe("char");
 		globalExpect(head(rates).turnIndex).toBe(0);
 		globalExpect(head(rates).ratePerSecond).toBeGreaterThan(0);
 	}));
+	it.effect("counts tool-call arguments: a turn with no prose still reports a rate", () => Effect.gen(function* () {
+		const stream = Stream.make(toolArgs("{\"city\":"), toolArgs("\"Lisbon\"}")).pipe(Stream.concat(timed([["10 seconds", turnComplete({})]]))).pipe(throughput({
+			every: "1 second",
+			unit: "char"
+		}), metricEvents, Stream.take(1));
+		const rates = (yield* runTimed(stream, ["1 second"])).filter((e) => e._tag === "Throughput");
+		globalExpect(rates).toHaveLength(1);
+		globalExpect(head(rates).ratePerSecond).toBeGreaterThan(0);
+	}));
+	it.live("ignores events that carry no generated output", () => Effect.gen(function* () {
+		const stream = Stream.make(TurnEvent.ToolCallStart({
+			call_id: "call_1",
+			name: "get_weather"
+		}), TurnEvent.UsageUpdate({ usage: { output_tokens: 5 } })).pipe(Stream.concat(timed([["30 millis", turnComplete({})]]))).pipe(throughput({
+			every: "10 millis",
+			unit: "char"
+		}), metricEvents);
+		const out = yield* Stream.runCollect(stream);
+		globalExpect(out.filter((e) => e._tag === "Throughput")).toHaveLength(0);
+	}));
 });
 describe("custom events and helpers", () => {
 	it("makeEvent stamps the brand so isMetricEvent and the recorder see it", () => {
-		globalExpect(isMetricEvent(makeEvent({
+		const ev = makeEvent({
 			_tag: "ToolLatency",
 			turnIndex: 0,
 			measurements: [{
@@ -170,7 +233,8 @@ describe("custom events and helpers", () => {
 				kind: "timer",
 				value: Duration.millis(42)
 			}]
-		}))).toBe(true);
+		});
+		globalExpect(isMetricEvent(ev)).toBe(true);
 		globalExpect(isMetricEvent(text("x"))).toBe(false);
 		globalExpect(isMetricEvent(turnComplete({}))).toBe(false);
 	});