@effect-uai/google 0.3.0 → 0.4.0

package/dist/LyriaGenerator.d.mts

@@ -0,0 +1,57 @@
+import { LyriaModel } from "./models.mjs";
+import { Context, Effect, Layer, Redacted, Stream } from "effect";
+import { HttpClient } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
+import { MusicGenerator } from "@effect-uai/core/MusicGenerator";
+import { CommonGenerateMusicRequest, CommonStreamGenerateMusicRequest, MusicResult, MusicSessionInput } from "@effect-uai/core/Music";
+import { AudioChunk, AudioFormat } from "@effect-uai/core/Audio";
+
+//#region src/LyriaGenerator.d.ts
+declare namespace LyriaGenerator_d_exports {
+  export { Config, LyriaGenerateRequest, LyriaGenerator, LyriaGeneratorService, LyriaResponseMimeType, buildPrompt, containerToMimeType, layer, make, realizedFormat };
+}
+/**
+ * Lyria-typed generate request. Narrows `model` to `LyriaModel`. The
+ * Lyria sync API (`generateContent`) accepts only `audio/mp3` and
+ * `audio/wav` output; `bpm`, `scale`, `instrumental` etc. on the
+ * `CommonGenerateMusicRequest` are flattened into the prompt text
+ * because the public API does not expose them as structured fields.
+ */
+type LyriaGenerateRequest = Omit<CommonGenerateMusicRequest, "model"> & {
+  readonly model: LyriaModel;
+};
+type LyriaGeneratorService = {
+  readonly generate: (request: LyriaGenerateRequest) => Effect.Effect<MusicResult, AiError.AiError>;
+  readonly streamGeneration: (request: LyriaGenerateRequest) => Stream.Stream<AudioChunk, AiError.AiError>;
+  readonly streamGenerationFrom: <E, R>(input: Stream.Stream<MusicSessionInput, E, R>, request: CommonStreamGenerateMusicRequest) => Stream.Stream<AudioChunk, AiError.AiError | E, R>;
+};
+declare const LyriaGenerator_base: Context.ServiceClass<LyriaGenerator, "@betalyra/effect-uai/providers/google/LyriaGenerator", LyriaGeneratorService>;
+declare class LyriaGenerator extends LyriaGenerator_base {}
+type Config = {
+  readonly apiKey: Redacted.Redacted;
+  readonly baseUrl?: string;
+};
+type LyriaResponseMimeType = "audio/mp3" | "audio/wav";
+declare const containerToMimeType: (container: AudioFormat["container"]) => Effect.Effect<LyriaResponseMimeType, AiError.AiError>;
+declare const realizedFormat: (mime: LyriaResponseMimeType) => AudioFormat;
+/**
+ * Collapse `prompts | WeightedPrompt[]` into a single prompt string and
+ * splice in non-structural hints (`lyrics`, `bpm`, `scale`,
+ * `instrumental`, `durationSeconds`). The Lyria 3 sync API only takes
+ * one text part — every condition lives inline.
+ */
+declare const buildPrompt: (request: CommonGenerateMusicRequest) => string;
+declare const make: (cfg: Config) => Effect.Effect<LyriaGeneratorService, never, HttpClient.HttpClient>;
+/**
+ * Layer that registers both the provider-specific `LyriaGenerator` tag
+ * and the generic `MusicGenerator` tag.
+ *
+ * Does NOT register the `MusicInteractiveSession` capability marker —
+ * Lyria 3 sync has no bidirectional session at the wire level. Code
+ * calling `MusicGenerator.streamGenerationFrom` will fail to typecheck
+ * against this Layer alone, which is the intended UX.
+ */
+declare const layer: (cfg: Config) => Layer.Layer<LyriaGenerator | MusicGenerator, never, HttpClient.HttpClient>;
+//#endregion
+export { Config, LyriaGenerateRequest, LyriaGenerator, LyriaGeneratorService, LyriaResponseMimeType, buildPrompt, containerToMimeType, layer, make, realizedFormat, LyriaGenerator_d_exports as t };
+//# sourceMappingURL=LyriaGenerator.d.mts.map

package/dist/LyriaGenerator.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LyriaGenerator.d.mts","names":[],"sources":["../src/LyriaGenerator.ts"],"mappings":";;;;;;;;;;;;;;;;;;;KAqCY,oBAAA,GAAuB,IAAA,CAAK,0BAAA;EAAA,SAC7B,KAAA,EAAO,UAAA;AAAA;AAAA,KAGN,qBAAA;EAAA,SACD,QAAA,GAAW,OAAA,EAAS,oBAAA,KAAyB,MAAA,CAAO,MAAA,CAAO,WAAA,EAAa,OAAA,CAAQ,OAAA;EAAA,SAChF,gBAAA,GACP,OAAA,EAAS,oBAAA,KACN,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAA,CAAQ,OAAA;EAAA,SAC9B,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,CAAQ,OAAA,GAAU,CAAA,EAAG,CAAA;AAAA;AAAA,cACrD,mBAAA;cAEY,cAAA,SAAuB,mBAAA;AAAA,KAIxB,MAAA;EAAA,SACD,MAAA,EAAQ,QAAA,CAAS,QAAA;EAAA,SACjB,OAAA;AAAA;AAAA,KAOC,qBAAA;AAAA,cAEC,mBAAA,GACX,SAAA,EAAW,WAAA,kBACR,MAAA,CAAO,MAAA,CAAO,qBAAA,EAAuB,OAAA,CAAQ,OAAA;AAAA,cAyBrC,cAAA,GAAiB,IAAA,EAAM,qBAAA,KAA0B,WAAA;;;;;AArD9D;;cA6Ea,WAAA,GAAe,OAAA,EAAS,0BAAA;AAAA,cA8OxB,IAAA,GACX,GAAA,EAAK,MAAA,KACJ,MAAA,CAAO,MAAA,CAAO,qBAAA,SAA8B,UAAA,CAAW,UAAA;;;;;;;;;;cAkB7C,KAAA,GACX,GAAA,EAAK,MAAA,KACJ,KAAA,CAAM,KAAA,CAAM,cAAA,GAAiB,cAAA,SAAuB,UAAA,CAAW,UAAA"}

package/dist/LyriaGenerator.mjs

@@ -0,0 +1,202 @@
+import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
+import { Array, Context, Effect, Encoding, Layer, Match, Option, Redacted, Result, Schema, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/unstable/http";
+import * as AiError from "@effect-uai/core/AiError";
+import { MusicGenerator } from "@effect-uai/core/MusicGenerator";
+//#region src/LyriaGenerator.ts
+var LyriaGenerator_exports = /* @__PURE__ */ __exportAll({
+	LyriaGenerator: () => LyriaGenerator,
+	buildPrompt: () => buildPrompt,
+	containerToMimeType: () => containerToMimeType,
+	layer: () => layer,
+	make: () => make,
+	realizedFormat: () => realizedFormat
+});
+var LyriaGenerator = class extends Context.Service()("@betalyra/effect-uai/providers/google/LyriaGenerator") {};
+const containerToMimeType = Match.type().pipe(Match.when("mp3", () => Effect.succeed("audio/mp3")), Match.when("wav", () => Effect.succeed("audio/wav")), Match.whenOr("ogg", "opus", "flac", "aac", "webm", "raw", (c) => Effect.fail(new AiError.Unsupported({
+	provider: "lyria",
+	capability: "outputFormat",
+	reason: `Lyria 3 only produces audio/mp3 or audio/wav; ${c} is not available. Use container: "mp3" or "wav".`
+}))), Match.exhaustive);
+/**
+* Is this a Lyria 3 Clip model variant? Clip is fixed at 30 s MP3 — it
+* does not accept a `responseFormat` on `generationConfig` (the live
+* API rejects unknown fields, despite what the docs imply). Pro
+* accepts the documented `responseFormat` knob.
+*/
+const isClipModel = (model) => model.includes("clip");
+const realizedFormat = Match.type().pipe(Match.when("audio/mp3", () => ({
+	container: "mp3",
+	encoding: "mp3",
+	sampleRate: 44100,
+	channels: 2
+})), Match.when("audio/wav", () => ({
+	container: "wav",
+	encoding: "pcm_s16le",
+	sampleRate: 44100,
+	channels: 2
+})), Match.exhaustive);
+/**
+* Collapse `prompts | WeightedPrompt[]` into a single prompt string and
+* splice in non-structural hints (`lyrics`, `bpm`, `scale`,
+* `instrumental`, `durationSeconds`). The Lyria 3 sync API only takes
+* one text part — every condition lives inline.
+*/
+const buildPrompt = (request) => {
+	const promptText = Match.value(request.prompts).pipe(Match.when(Match.string, (s) => s), Match.orElse((ws) => Array.map(ws, (w) => w.weight !== void 0 && w.weight !== 1 ? `${w.text} (weight ${w.weight})` : w.text).join(". ")));
+	const hints = Array.getSomes([
+		request.instrumental === true ? Option.some("Instrumental only — no vocals.") : Option.none(),
+		request.bpm !== void 0 ? Option.some(`BPM: ${request.bpm}.`) : Option.none(),
+		request.scale !== void 0 ? Option.some(`Key/scale: ${request.scale}.`) : Option.none(),
+		request.durationSeconds !== void 0 ? Option.some(`Target duration: ${request.durationSeconds}s.`) : Option.none()
+	]);
+	const lyricsBlock = request.lyrics !== void 0 && request.instrumental !== true ? `\n\nLyrics:\n${request.lyrics}` : "";
+	return [promptText, ...hints].join(" ") + lyricsBlock;
+};
+const InlineData = Schema.Struct({
+	mimeType: Schema.optional(Schema.String),
+	data: Schema.String
+});
+const Part = Schema.Struct({
+	text: Schema.optional(Schema.String),
+	inlineData: Schema.optional(InlineData)
+});
+const Content = Schema.Struct({ parts: Schema.optional(Schema.Array(Part)) });
+const Candidate = Schema.Struct({ content: Schema.optional(Content) });
+const Wire = Schema.Struct({ candidates: Schema.optional(Schema.Array(Candidate)) });
+const decodeWire = Schema.decodeUnknownEffect(Wire);
+const baseUrl = (cfg) => cfg.baseUrl ?? "https://generativelanguage.googleapis.com/v1beta";
+const transportFailure = (cause) => new AiError.Unavailable({
+	provider: "lyria",
+	raw: cause
+});
+const httpStatusError = (status, body) => Match.value(status).pipe(Match.when(429, () => new AiError.RateLimited({
+	provider: "lyria",
+	raw: body
+})), Match.whenOr(408, 504, () => new AiError.Timeout({
+	provider: "lyria",
+	raw: body
+})), Match.when(401, () => new AiError.AuthFailed({
+	provider: "lyria",
+	subtype: "auth",
+	raw: body
+})), Match.when(403, () => new AiError.AuthFailed({
+	provider: "lyria",
+	subtype: "permission",
+	raw: body
+})), Match.when(402, () => new AiError.AuthFailed({
+	provider: "lyria",
+	subtype: "billing",
+	raw: body
+})), Match.when((n) => n >= 500, (n) => new AiError.Unavailable({
+	provider: "lyria",
+	status: n,
+	raw: body
+})), Match.orElse(() => new AiError.InvalidRequest({
+	provider: "lyria",
+	raw: body
+})));
+const decodeBase64ToBytes = (b64) => Result.match(Encoding.decodeBase64(b64), {
+	onSuccess: Effect.succeed,
+	onFailure: (cause) => Effect.fail(new AiError.InvalidRequest({
+		provider: "lyria",
+		param: "audio",
+		raw: cause
+	}))
+});
+/**
+* Find the first inline-data audio part and the concatenated text parts
+* from a Wire response.
+*/
+const extractParts = (wire) => {
+	const allParts = (wire.candidates ?? []).flatMap((c) => c.content?.parts ?? []);
+	const inline = allParts.find((p) => p.inlineData !== void 0)?.inlineData;
+	const textParts = allParts.flatMap((p) => p.text !== void 0 ? [p.text] : []);
+	const text = textParts.length === 0 ? void 0 : textParts.join("\n");
+	return {
+		...inline !== void 0 && { inline },
+		...text !== void 0 && { text }
+	};
+};
+const generateImpl = (cfg) => (request) => Effect.gen(function* () {
+	const client = yield* HttpClient.HttpClient;
+	const mimeType = yield* containerToMimeType(request.outputFormat?.container ?? "mp3");
+	if (isClipModel(request.model) && mimeType === "audio/wav") return yield* Effect.fail(new AiError.Unsupported({
+		provider: "lyria",
+		capability: "outputFormat",
+		reason: `lyria-3-clip-preview is fixed at audio/mp3. Use lyria-3-pro-preview for audio/wav output.`
+	}));
+	const promptText = buildPrompt(request);
+	const body = isClipModel(request.model) ? { contents: [{ parts: [{ text: promptText }] }] } : {
+		contents: [{ parts: [{ text: promptText }] }],
+		generationConfig: {
+			responseModalities: ["AUDIO", "TEXT"],
+			responseFormat: { audio: { mimeType } }
+		}
+	};
+	const httpRequest = HttpClientRequest.post(`${baseUrl(cfg)}/models/${request.model}:generateContent`).pipe(HttpClientRequest.setHeader("x-goog-api-key", Redacted.value(cfg.apiKey)), HttpClientRequest.bodyJsonUnsafe(body));
+	const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure));
+	if (response.status >= 400) {
+		const text = yield* response.text.pipe(Effect.orElseSucceed(() => ""));
+		return yield* Effect.fail(httpStatusError(response.status, text));
+	}
+	const json = yield* response.json.pipe(Effect.mapError(transportFailure));
+	const { inline, text } = extractParts(yield* decodeWire(json).pipe(Effect.mapError((cause) => new AiError.GenerationFailed({
+		provider: "lyria",
+		raw: cause
+	}))));
+	if (inline === void 0) return yield* Effect.fail(new AiError.GenerationFailed({
+		provider: "lyria",
+		raw: {
+			message: "Lyria response had no inlineData audio part.",
+			hint: "Likely a prompt-filter rejection. Lyria filters references to real artists / copyrighted song lyrics. Rephrase with descriptive style language instead of artist names.",
+			textParts: text,
+			response: json
+		}
+	}));
+	const bytes = yield* decodeBase64ToBytes(inline.data);
+	return {
+		format: realizedFormat(mimeType),
+		bytes,
+		...text !== void 0 && { lyrics: text },
+		watermark: { kind: "synthid" }
+	};
+});
+const streamGenerationImpl = (cfg) => (request) => Stream.unwrap(Effect.map(generateImpl(cfg)(request), (result) => Stream.succeed({ bytes: result.bytes })));
+/**
+* Lyria 3 sync has no bidirectional session at the wire level — that's
+* Lyria RealTime (Phase 1b, separate Layer). The provider Layer here
+* also does NOT register `MusicInteractiveSession`, so callers using
+* `MusicGenerator.streamGenerationFrom` against only this Layer get a
+* compile-time error before this runtime fallback ever fires.
+*/
+const streamGenerationFromUnsupported = (_input, _request) => {
+	return Stream.fail(new AiError.Unsupported({
+		provider: "lyria",
+		capability: "streamGenerationFrom",
+		reason: "Lyria 3 sync does not support bidirectional sessions. Use the Lyria RealTime Layer (WebSocket BidiGenerateMusic) for interactive mid-session prompts."
+	}));
+};
+const make = (cfg) => Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({
+	generate: (request) => generateImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),
+	streamGeneration: (request) => streamGenerationImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client)),
+	streamGenerationFrom: streamGenerationFromUnsupported
+}));
+/**
+* Layer that registers both the provider-specific `LyriaGenerator` tag
+* and the generic `MusicGenerator` tag.
+*
+* Does NOT register the `MusicInteractiveSession` capability marker —
+* Lyria 3 sync has no bidirectional session at the wire level. Code
+* calling `MusicGenerator.streamGenerationFrom` will fail to typecheck
+* against this Layer alone, which is the intended UX.
+*/
+const layer = (cfg) => Layer.merge(Layer.effect(LyriaGenerator, make(cfg)), Layer.effect(MusicGenerator, Effect.map(make(cfg), (s) => ({
+	generate: (req) => s.generate(req),
+	streamGeneration: (req) => s.streamGeneration(req),
+	streamGenerationFrom: s.streamGenerationFrom
+}))));
+//#endregion
+export { LyriaGenerator, buildPrompt, containerToMimeType, layer, make, realizedFormat, LyriaGenerator_exports as t };
+
+//# sourceMappingURL=LyriaGenerator.mjs.map

package/dist/LyriaGenerator.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LyriaGenerator.mjs","names":["Arr"],"sources":["../src/LyriaGenerator.ts"],"sourcesContent":["import {\n  Array as Arr,\n  Context,\n  Effect,\n  Encoding,\n  Layer,\n  Match,\n  Option,\n  Redacted,\n  Result,\n  Schema,\n  Stream,\n} from \"effect\"\nimport { HttpClient, HttpClientRequest } from \"effect/unstable/http\"\nimport * as AiError from \"@effect-uai/core/AiError\"\nimport type { AudioChunk, AudioFormat } from \"@effect-uai/core/Audio\"\nimport type {\n  CommonGenerateMusicRequest,\n  CommonStreamGenerateMusicRequest,\n  MusicResult,\n  MusicSessionInput,\n  WeightedPrompt,\n} from \"@effect-uai/core/Music\"\nimport { MusicGenerator, type MusicGeneratorService } from \"@effect-uai/core/MusicGenerator\"\nimport type { LyriaModel } from \"./models.js\"\n\n// ---------------------------------------------------------------------------\n// Public types\n// ---------------------------------------------------------------------------\n\n/**\n * Lyria-typed generate request. Narrows `model` to `LyriaModel`. The\n * Lyria sync API (`generateContent`) accepts only `audio/mp3` and\n * `audio/wav` output; `bpm`, `scale`, `instrumental` etc. on the\n * `CommonGenerateMusicRequest` are flattened into the prompt text\n * because the public API does not expose them as structured fields.\n */\nexport type LyriaGenerateRequest = Omit<CommonGenerateMusicRequest, \"model\"> & {\n  readonly model: LyriaModel\n}\n\nexport type LyriaGeneratorService = {\n  readonly generate: (request: LyriaGenerateRequest) => Effect.Effect<MusicResult, AiError.AiError>\n  readonly streamGeneration: (\n    request: LyriaGenerateRequest,\n  ) => Stream.Stream<AudioChunk, AiError.AiError>\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 LyriaGenerator extends Context.Service<LyriaGenerator, LyriaGeneratorService>()(\n  \"@betalyra/effect-uai/providers/google/LyriaGenerator\",\n) {}\n\nexport type Config = {\n  readonly apiKey: Redacted.Redacted\n  readonly baseUrl?: string\n}\n\n// ---------------------------------------------------------------------------\n// Codec — request → prompt text + response_format\n// ---------------------------------------------------------------------------\n\nexport type LyriaResponseMimeType = \"audio/mp3\" | \"audio/wav\"\n\nexport const containerToMimeType: (\n  container: AudioFormat[\"container\"],\n) => Effect.Effect<LyriaResponseMimeType, AiError.AiError> = Match.type<\n  AudioFormat[\"container\"]\n>().pipe(\n  Match.when(\"mp3\", () => Effect.succeed<LyriaResponseMimeType>(\"audio/mp3\")),\n  Match.when(\"wav\", () => Effect.succeed<LyriaResponseMimeType>(\"audio/wav\")),\n  Match.whenOr(\"ogg\", \"opus\", \"flac\", \"aac\", \"webm\", \"raw\", (c) =>\n    Effect.fail(\n      new AiError.Unsupported({\n        provider: \"lyria\",\n        capability: \"outputFormat\",\n        reason: `Lyria 3 only produces audio/mp3 or audio/wav; ${c} is not available. Use container: \"mp3\" or \"wav\".`,\n      }),\n    ),\n  ),\n  Match.exhaustive,\n)\n\n/**\n * Is this a Lyria 3 Clip model variant? Clip is fixed at 30 s MP3 — it\n * does not accept a `responseFormat` on `generationConfig` (the live\n * API rejects unknown fields, despite what the docs imply). Pro\n * accepts the documented `responseFormat` knob.\n */\nconst isClipModel = (model: string): boolean => model.includes(\"clip\")\n\nexport const realizedFormat: (mime: LyriaResponseMimeType) => AudioFormat =\n  Match.type<LyriaResponseMimeType>().pipe(\n    Match.when(\n      \"audio/mp3\",\n      (): AudioFormat => ({ container: \"mp3\", encoding: \"mp3\", sampleRate: 44100, channels: 2 }),\n    ),\n    Match.when(\n      \"audio/wav\",\n      (): AudioFormat => ({\n        container: \"wav\",\n        encoding: \"pcm_s16le\",\n        sampleRate: 44100,\n        channels: 2,\n      }),\n    ),\n    Match.exhaustive,\n  )\n\n/**\n * Collapse `prompts | WeightedPrompt[]` into a single prompt string and\n * splice in non-structural hints (`lyrics`, `bpm`, `scale`,\n * `instrumental`, `durationSeconds`). The Lyria 3 sync API only takes\n * one text part — every condition lives inline.\n */\nexport const buildPrompt = (request: CommonGenerateMusicRequest): string => {\n  const promptText = Match.value(request.prompts).pipe(\n    Match.when(Match.string, (s) => s),\n    Match.orElse((ws: ReadonlyArray<WeightedPrompt>) =>\n      Arr.map(ws, (w) =>\n        w.weight !== undefined && w.weight !== 1 ? `${w.text} (weight ${w.weight})` : w.text,\n      ).join(\". \"),\n    ),\n  )\n  const hints = Arr.getSomes([\n    request.instrumental === true ? Option.some(\"Instrumental only — no vocals.\") : Option.none(),\n    request.bpm !== undefined ? Option.some(`BPM: ${request.bpm}.`) : Option.none(),\n    request.scale !== undefined ? Option.some(`Key/scale: ${request.scale}.`) : Option.none(),\n    request.durationSeconds !== undefined\n      ? Option.some(`Target duration: ${request.durationSeconds}s.`)\n      : Option.none(),\n  ])\n  const lyricsBlock =\n    request.lyrics !== undefined && request.instrumental !== true\n      ? `\\n\\nLyrics:\\n${request.lyrics}`\n      : \"\"\n  return [promptText, ...hints].join(\" \") + lyricsBlock\n}\n\n// ---------------------------------------------------------------------------\n// Wire response schema — just enough to find audio + optional lyrics text\n// ---------------------------------------------------------------------------\n\nconst InlineData = Schema.Struct({\n  mimeType: Schema.optional(Schema.String),\n  data: Schema.String,\n})\n\nconst Part = Schema.Struct({\n  text: Schema.optional(Schema.String),\n  inlineData: Schema.optional(InlineData),\n})\n\nconst Content = Schema.Struct({\n  parts: Schema.optional(Schema.Array(Part)),\n})\n\nconst Candidate = Schema.Struct({\n  content: Schema.optional(Content),\n})\n\nconst Wire = Schema.Struct({\n  candidates: Schema.optional(Schema.Array(Candidate)),\n})\n\nconst decodeWire = Schema.decodeUnknownEffect(Wire)\n\n// ---------------------------------------------------------------------------\n// HTTP plumbing\n// ---------------------------------------------------------------------------\n\nconst baseUrl = (cfg: Config): string =>\n  cfg.baseUrl ?? \"https://generativelanguage.googleapis.com/v1beta\"\n\nconst transportFailure = (cause: unknown): AiError.AiError =>\n  new AiError.Unavailable({ provider: \"lyria\", raw: cause })\n\nconst httpStatusError: (status: number, body: string) => AiError.AiError = (status, body) =>\n  Match.value(status).pipe(\n    Match.when(\n      429,\n      (): AiError.AiError => new AiError.RateLimited({ provider: \"lyria\", raw: body }),\n    ),\n    Match.whenOr(\n      408,\n      504,\n      (): AiError.AiError => new AiError.Timeout({ provider: \"lyria\", raw: body }),\n    ),\n    Match.when(\n      401,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"lyria\", subtype: \"auth\", raw: body }),\n    ),\n    Match.when(\n      403,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"lyria\", subtype: \"permission\", raw: body }),\n    ),\n    Match.when(\n      402,\n      (): AiError.AiError =>\n        new AiError.AuthFailed({ provider: \"lyria\", subtype: \"billing\", raw: body }),\n    ),\n    Match.when(\n      (n) => n >= 500,\n      (n): AiError.AiError => new AiError.Unavailable({ provider: \"lyria\", status: n, raw: body }),\n    ),\n    Match.orElse(\n      (): AiError.AiError => new AiError.InvalidRequest({ provider: \"lyria\", raw: body }),\n    ),\n  )\n\nconst decodeBase64ToBytes = (b64: string): Effect.Effect<Uint8Array, AiError.AiError> =>\n  Result.match(Encoding.decodeBase64(b64), {\n    onSuccess: Effect.succeed,\n    onFailure: (cause) =>\n      Effect.fail(new AiError.InvalidRequest({ provider: \"lyria\", param: \"audio\", raw: cause })),\n  })\n\n/**\n * Find the first inline-data audio part and the concatenated text parts\n * from a Wire response.\n */\nconst extractParts = (\n  wire: typeof Wire.Type,\n): { readonly inline?: typeof InlineData.Type; readonly text?: string } => {\n  const allParts = (wire.candidates ?? []).flatMap((c) => c.content?.parts ?? [])\n  const inline = allParts.find((p) => p.inlineData !== undefined)?.inlineData\n  const textParts = allParts.flatMap((p) => (p.text !== undefined ? [p.text] : []))\n  const text = textParts.length === 0 ? undefined : textParts.join(\"\\n\")\n  return {\n    ...(inline !== undefined && { inline }),\n    ...(text !== undefined && { text }),\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Service implementation\n// ---------------------------------------------------------------------------\n\nconst generateImpl =\n  (cfg: Config) =>\n  (\n    request: LyriaGenerateRequest,\n  ): Effect.Effect<MusicResult, AiError.AiError, HttpClient.HttpClient> =>\n    Effect.gen(function* () {\n      const client = yield* HttpClient.HttpClient\n      const requestedContainer = (request.outputFormat?.container ??\n        \"mp3\") satisfies AudioFormat[\"container\"]\n      const mimeType = yield* containerToMimeType(requestedContainer)\n      // Clip is fixed 30 s mp3 — reject wav up front rather than sending\n      // a `responseFormat` that the live API ignores or rejects.\n      if (isClipModel(request.model) && mimeType === \"audio/wav\") {\n        return yield* Effect.fail(\n          new AiError.Unsupported({\n            provider: \"lyria\",\n            capability: \"outputFormat\",\n            reason: `lyria-3-clip-preview is fixed at audio/mp3. Use lyria-3-pro-preview for audio/wav output.`,\n          }),\n        )\n      }\n      const promptText = buildPrompt(request)\n      const body = isClipModel(request.model)\n        ? { contents: [{ parts: [{ text: promptText }] }] }\n        : {\n            contents: [{ parts: [{ text: promptText }] }],\n            generationConfig: {\n              responseModalities: [\"AUDIO\", \"TEXT\"],\n              responseFormat: { audio: { mimeType } },\n            },\n          }\n      const httpRequest = HttpClientRequest.post(\n        `${baseUrl(cfg)}/models/${request.model}:generateContent`,\n      ).pipe(\n        HttpClientRequest.setHeader(\"x-goog-api-key\", Redacted.value(cfg.apiKey)),\n        HttpClientRequest.bodyJsonUnsafe(body),\n      )\n      const response = yield* client.execute(httpRequest).pipe(Effect.mapError(transportFailure))\n      if (response.status >= 400) {\n        const text = yield* response.text.pipe(Effect.orElseSucceed(() => \"\"))\n        return yield* Effect.fail(httpStatusError(response.status, text))\n      }\n      const json = yield* response.json.pipe(Effect.mapError(transportFailure))\n      const wire = yield* decodeWire(json).pipe(\n        Effect.mapError(\n          (cause): AiError.AiError =>\n            new AiError.GenerationFailed({ provider: \"lyria\", raw: cause }),\n        ),\n      )\n      const { inline, text } = extractParts(wire)\n      if (inline === undefined) {\n        // No audio came back. Most common cause: Lyria filtered the prompt\n        // (named-artist references, copyrighted lyrics, etc.). Surface the\n        // full response body — text parts, finish reasons, prompt-feedback\n        // blocks — so the caller can see why.\n        return yield* Effect.fail(\n          new AiError.GenerationFailed({\n            provider: \"lyria\",\n            raw: {\n              message: \"Lyria response had no inlineData audio part.\",\n              hint: \"Likely a prompt-filter rejection. Lyria filters references to real artists / copyrighted song lyrics. Rephrase with descriptive style language instead of artist names.\",\n              textParts: text,\n              response: json,\n            },\n          }),\n        )\n      }\n      const bytes = yield* decodeBase64ToBytes(inline.data)\n      return {\n        format: realizedFormat(mimeType),\n        bytes,\n        ...(text !== undefined && { lyrics: text }),\n        watermark: { kind: \"synthid\" },\n      } satisfies MusicResult\n    })\n\nconst streamGenerationImpl =\n  (cfg: Config) =>\n  (\n    request: LyriaGenerateRequest,\n  ): Stream.Stream<AudioChunk, AiError.AiError, HttpClient.HttpClient> =>\n    Stream.unwrap(\n      Effect.map(generateImpl(cfg)(request), (result) =>\n        Stream.succeed<AudioChunk>({ bytes: result.bytes }),\n      ),\n    )\n\n/**\n * Lyria 3 sync has no bidirectional session at the wire level — that's\n * Lyria RealTime (Phase 1b, separate Layer). The provider Layer here\n * also does NOT register `MusicInteractiveSession`, so callers using\n * `MusicGenerator.streamGenerationFrom` against only this Layer get a\n * compile-time error before this runtime fallback ever fires.\n */\nconst streamGenerationFromUnsupported = <E, R>(\n  _input: Stream.Stream<MusicSessionInput, E, R>,\n  _request: CommonStreamGenerateMusicRequest,\n): Stream.Stream<AudioChunk, AiError.AiError | E, R> => {\n  const fail: Stream.Stream<AudioChunk, AiError.AiError | E, R> = Stream.fail(\n    new AiError.Unsupported({\n      provider: \"lyria\",\n      capability: \"streamGenerationFrom\",\n      reason:\n        \"Lyria 3 sync does not support bidirectional sessions. Use the Lyria RealTime Layer (WebSocket BidiGenerateMusic) for interactive mid-session prompts.\",\n    }),\n  )\n  return fail\n}\n\n// ---------------------------------------------------------------------------\n// Constructors\n// ---------------------------------------------------------------------------\n\nexport const make = (\n  cfg: Config,\n): Effect.Effect<LyriaGeneratorService, never, HttpClient.HttpClient> =>\n  Effect.map(HttpClient.HttpClient.asEffect(), (client) => ({\n    generate: (request) =>\n      generateImpl(cfg)(request).pipe(Effect.provideService(HttpClient.HttpClient, client)),\n    streamGeneration: (request) =>\n      streamGenerationImpl(cfg)(request).pipe(Stream.provideService(HttpClient.HttpClient, client)),\n    streamGenerationFrom: streamGenerationFromUnsupported,\n  }))\n\n/**\n * Layer that registers both the provider-specific `LyriaGenerator` tag\n * and the generic `MusicGenerator` tag.\n *\n * Does NOT register the `MusicInteractiveSession` capability marker —\n * Lyria 3 sync has no bidirectional session at the wire level. Code\n * calling `MusicGenerator.streamGenerationFrom` will fail to typecheck\n * against this Layer alone, which is the intended UX.\n */\nexport const layer = (\n  cfg: Config,\n): Layer.Layer<LyriaGenerator | MusicGenerator, never, HttpClient.HttpClient> =>\n  Layer.merge(\n    Layer.effect(LyriaGenerator, make(cfg)),\n    Layer.effect(\n      MusicGenerator,\n      Effect.map(\n        make(cfg),\n        (s): MusicGeneratorService => ({\n          generate: (req: CommonGenerateMusicRequest) => s.generate(req as LyriaGenerateRequest),\n          streamGeneration: (req: CommonStreamGenerateMusicRequest) =>\n            s.streamGeneration(req as LyriaGenerateRequest),\n          streamGenerationFrom: s.streamGenerationFrom,\n        }),\n      ),\n    ),\n  )\n"],"mappings":"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"}

package/dist/LyriaGenerator.test.d.mts

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

package/dist/LyriaGenerator.test.mjs

@@ -0,0 +1,138 @@
+import { i as it, n as globalExpect, r as describe, t as import_dist } from "./dist-DMsg8YLb.mjs";
+import { LyriaGenerator, buildPrompt, containerToMimeType, layer, realizedFormat } from "./LyriaGenerator.mjs";
+import { Effect, Layer, Redacted, Stream } from "effect";
+import { FetchHttpClient } from "effect/unstable/http";
+import * as MusicGenerator$1 from "@effect-uai/core/MusicGenerator";
+import { promptsInput } from "@effect-uai/core/Music";
+//#region src/LyriaGenerator.test.ts
+const cfg = { apiKey: Redacted.make("test-key") };
+const live = Layer.provide(layer(cfg), FetchHttpClient.layer);
+describe("buildPrompt", () => {
+	it("returns a plain string when prompts is a string", () => {
+		globalExpect(buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: "upbeat indie pop"
+		})).toBe("upbeat indie pop");
+	});
+	it("joins weighted prompts with weight annotations", () => {
+		const out = buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: [{
+				text: "minimal techno",
+				weight: 1
+			}, {
+				text: "1980s synthwave",
+				weight: .3
+			}]
+		});
+		globalExpect(out).toContain("minimal techno");
+		globalExpect(out).toContain("1980s synthwave (weight 0.3)");
+	});
+	it("omits the weight annotation for weight === 1", () => {
+		globalExpect(buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: [{
+				text: "ambient",
+				weight: 1
+			}]
+		})).toBe("ambient");
+	});
+	it("splices in bpm, scale, duration, and instrumental hints", () => {
+		const out = buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: "house",
+			bpm: 124,
+			scale: "C_MAJOR",
+			durationSeconds: 30,
+			instrumental: true
+		});
+		globalExpect(out).toContain("Instrumental only");
+		globalExpect(out).toContain("BPM: 124");
+		globalExpect(out).toContain("Key/scale: C_MAJOR");
+		globalExpect(out).toContain("Target duration: 30s");
+	});
+	it("appends a lyrics block when lyrics is set and instrumental is not true", () => {
+		const out = buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: "indie rock",
+			lyrics: "[Verse]\nhello world"
+		});
+		globalExpect(out).toContain("Lyrics:");
+		globalExpect(out).toContain("[Verse]");
+	});
+	it("drops the lyrics block when instrumental is true", () => {
+		globalExpect(buildPrompt({
+			model: "lyria-3-clip-preview",
+			prompts: "indie rock",
+			lyrics: "[Verse]\nhello world",
+			instrumental: true
+		})).not.toContain("Lyrics:");
+	});
+});
+describe("containerToMimeType", () => {
+	it("maps mp3 and wav", async () => {
+		globalExpect(await Effect.runPromise(containerToMimeType("mp3"))).toBe("audio/mp3");
+		globalExpect(await Effect.runPromise(containerToMimeType("wav"))).toBe("audio/wav");
+	});
+	it("fails Unsupported for ogg / opus / flac / aac / webm / raw", async () => {
+		const exit = await Effect.runPromiseExit(containerToMimeType("ogg"));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("Unsupported");
+			globalExpect(JSON.stringify(exit.cause)).toContain("outputFormat");
+		}
+	});
+});
+describe("realizedFormat", () => {
+	it("reports 44.1 kHz stereo for both mp3 and wav", () => {
+		globalExpect(realizedFormat("audio/mp3")).toEqual({
+			container: "mp3",
+			encoding: "mp3",
+			sampleRate: 44100,
+			channels: 2
+		});
+		globalExpect(realizedFormat("audio/wav")).toEqual({
+			container: "wav",
+			encoding: "pcm_s16le",
+			sampleRate: 44100,
+			channels: 2
+		});
+	});
+});
+describe("LyriaGenerator capability guards (runtime)", () => {
+	it("streamGenerationFrom returns an Unsupported stream", async () => {
+		const program = LyriaGenerator.use((s) => Stream.runDrain(s.streamGenerationFrom(Stream.fromIterable([promptsInput([{ text: "x" }])]), {
+			model: "lyria-3-clip-preview",
+			prompts: ""
+		})));
+		const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)));
+		globalExpect(exit._tag).toBe("Failure");
+		if (exit._tag === "Failure") {
+			globalExpect(JSON.stringify(exit.cause)).toContain("Unsupported");
+			globalExpect(JSON.stringify(exit.cause)).toContain("streamGenerationFrom");
+		}
+	});
+});
+describe("LyriaGenerator Layer (compile-time)", () => {
+	it("leaves `MusicInteractiveSession` unsatisfied when using `streamGenerationFrom` against this Layer", () => {
+		const audio = Stream.fromIterable([promptsInput([{ text: "techno" }])]).pipe(MusicGenerator$1.streamGenerationFrom({
+			model: "lyria-3-clip-preview",
+			prompts: ""
+		}));
+		(0, import_dist.expectTypeOf)(Stream.runDrain(audio).pipe(Effect.provide(live))).toEqualTypeOf();
+	});
+	it("sync `generate` and chunked `streamGeneration` require no marker", () => {
+		(0, import_dist.expectTypeOf)(MusicGenerator$1.generate({
+			model: "lyria-3-clip-preview",
+			prompts: "ambient"
+		}).pipe(Effect.provide(live))).toEqualTypeOf();
+		globalExpect(Stream.runCollect(MusicGenerator$1.streamGeneration({
+			model: "lyria-3-clip-preview",
+			prompts: "ambient"
+		})).pipe(Effect.provide(live))).toBeDefined();
+	});
+});
+//#endregion
+export {};
+
+//# sourceMappingURL=LyriaGenerator.test.mjs.map

package/dist/LyriaGenerator.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LyriaGenerator.test.mjs","names":["LyriaGenerator.layer","LyriaGenerator.buildPrompt","LyriaGenerator.containerToMimeType","LyriaGenerator.realizedFormat","MusicGenerator"],"sources":["../src/LyriaGenerator.test.ts"],"sourcesContent":["import { Effect, Layer, Redacted, Stream } from \"effect\"\nimport { FetchHttpClient } from \"effect/unstable/http\"\nimport { describe, expect, expectTypeOf, it } from \"vitest\"\nimport type * as AiError from \"@effect-uai/core/AiError\"\nimport * as MusicGenerator from \"@effect-uai/core/MusicGenerator\"\nimport { promptsInput } from \"@effect-uai/core/Music\"\nimport * as LyriaGenerator from \"./LyriaGenerator.js\"\n\nconst cfg: LyriaGenerator.Config = { apiKey: Redacted.make(\"test-key\") }\n// FetchHttpClient is required for `make`, but these tests only exercise the\n// compile-time gating and runtime Unsupported branches — no real HTTP is made.\nconst live = Layer.provide(LyriaGenerator.layer(cfg), FetchHttpClient.layer)\n\ndescribe(\"buildPrompt\", () => {\n  it(\"returns a plain string when prompts is a string\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: \"upbeat indie pop\",\n    })\n    expect(out).toBe(\"upbeat indie pop\")\n  })\n\n  it(\"joins weighted prompts with weight annotations\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: [\n        { text: \"minimal techno\", weight: 1.0 },\n        { text: \"1980s synthwave\", weight: 0.3 },\n      ],\n    })\n    expect(out).toContain(\"minimal techno\")\n    expect(out).toContain(\"1980s synthwave (weight 0.3)\")\n  })\n\n  it(\"omits the weight annotation for weight === 1\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: [{ text: \"ambient\", weight: 1 }],\n    })\n    expect(out).toBe(\"ambient\")\n  })\n\n  it(\"splices in bpm, scale, duration, and instrumental hints\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: \"house\",\n      bpm: 124,\n      scale: \"C_MAJOR\",\n      durationSeconds: 30,\n      instrumental: true,\n    })\n    expect(out).toContain(\"Instrumental only\")\n    expect(out).toContain(\"BPM: 124\")\n    expect(out).toContain(\"Key/scale: C_MAJOR\")\n    expect(out).toContain(\"Target duration: 30s\")\n  })\n\n  it(\"appends a lyrics block when lyrics is set and instrumental is not true\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: \"indie rock\",\n      lyrics: \"[Verse]\\nhello world\",\n    })\n    expect(out).toContain(\"Lyrics:\")\n    expect(out).toContain(\"[Verse]\")\n  })\n\n  it(\"drops the lyrics block when instrumental is true\", () => {\n    const out = LyriaGenerator.buildPrompt({\n      model: \"lyria-3-clip-preview\",\n      prompts: \"indie rock\",\n      lyrics: \"[Verse]\\nhello world\",\n      instrumental: true,\n    })\n    expect(out).not.toContain(\"Lyrics:\")\n  })\n})\n\ndescribe(\"containerToMimeType\", () => {\n  it(\"maps mp3 and wav\", async () => {\n    expect(await Effect.runPromise(LyriaGenerator.containerToMimeType(\"mp3\"))).toBe(\"audio/mp3\")\n    expect(await Effect.runPromise(LyriaGenerator.containerToMimeType(\"wav\"))).toBe(\"audio/wav\")\n  })\n\n  it(\"fails Unsupported for ogg / opus / flac / aac / webm / raw\", async () => {\n    const exit = await Effect.runPromiseExit(LyriaGenerator.containerToMimeType(\"ogg\"))\n    expect(exit._tag).toBe(\"Failure\")\n    if (exit._tag === \"Failure\") {\n      expect(JSON.stringify(exit.cause)).toContain(\"Unsupported\")\n      expect(JSON.stringify(exit.cause)).toContain(\"outputFormat\")\n    }\n  })\n})\n\ndescribe(\"realizedFormat\", () => {\n  it(\"reports 44.1 kHz stereo for both mp3 and wav\", () => {\n    expect(LyriaGenerator.realizedFormat(\"audio/mp3\")).toEqual({\n      container: \"mp3\",\n      encoding: \"mp3\",\n      sampleRate: 44100,\n      channels: 2,\n    })\n    expect(LyriaGenerator.realizedFormat(\"audio/wav\")).toEqual({\n      container: \"wav\",\n      encoding: \"pcm_s16le\",\n      sampleRate: 44100,\n      channels: 2,\n    })\n  })\n})\n\ndescribe(\"LyriaGenerator capability guards (runtime)\", () => {\n  it(\"streamGenerationFrom returns an Unsupported stream\", async () => {\n    const program = LyriaGenerator.LyriaGenerator.use((s) =>\n      Stream.runDrain(\n        s.streamGenerationFrom(Stream.fromIterable([promptsInput([{ text: \"x\" }])]), {\n          model: \"lyria-3-clip-preview\",\n          prompts: \"\",\n        }),\n      ),\n    )\n    const exit = await Effect.runPromiseExit(program.pipe(Effect.provide(live)))\n    expect(exit._tag).toBe(\"Failure\")\n    if (exit._tag === \"Failure\") {\n      expect(JSON.stringify(exit.cause)).toContain(\"Unsupported\")\n      expect(JSON.stringify(exit.cause)).toContain(\"streamGenerationFrom\")\n    }\n  })\n})\n\ndescribe(\"LyriaGenerator Layer (compile-time)\", () => {\n  it(\"leaves `MusicInteractiveSession` unsatisfied when using `streamGenerationFrom` against this Layer\", () => {\n    const inputs = Stream.fromIterable([promptsInput([{ text: \"techno\" }])])\n    const audio = inputs.pipe(\n      MusicGenerator.streamGenerationFrom({\n        model: \"lyria-3-clip-preview\",\n        prompts: \"\",\n      }),\n    )\n    const provided = Stream.runDrain(audio).pipe(Effect.provide(live))\n    expectTypeOf(provided).toEqualTypeOf<\n      Effect.Effect<void, AiError.AiError, MusicGenerator.MusicInteractiveSession>\n    >()\n  })\n\n  it(\"sync `generate` and chunked `streamGeneration` require no marker\", () => {\n    const gen = MusicGenerator.generate({\n      model: \"lyria-3-clip-preview\",\n      prompts: \"ambient\",\n    }).pipe(Effect.provide(live))\n    expectTypeOf(gen).toEqualTypeOf<\n      Effect.Effect<import(\"@effect-uai/core/Music\").MusicResult, AiError.AiError, never>\n    >()\n    const _stream = Stream.runCollect(\n      MusicGenerator.streamGeneration({\n        model: \"lyria-3-clip-preview\",\n        prompts: \"ambient\",\n      }),\n    ).pipe(Effect.provide(live))\n    expect(_stream).toBeDefined()\n  })\n})\n"],"mappings":"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"}

package/dist/{chunk-CfYAbeIz.mjs → chunk-uyGKjUfl.mjs}

@@ -1,5 +1,6 @@
 //#region \0rolldown/runtime.js
 var __defProp = Object.defineProperty;
+var __commonJSMin = (cb, mod) => () => (mod || (cb((mod = { exports: {} }).exports, mod), cb = null), mod.exports);
 var __exportAll = (all, no_symbols) => {
 	let target = {};
 	for (var name in all) __defProp(target, name, {
@@ -10,4 +11,4 @@ var __exportAll = (all, no_symbols) => {
 	return target;
 };
 //#endregion
-export { __exportAll as t };
+export { __exportAll as n, __commonJSMin as t };

package/dist/codec.mjs

@@ -1,4 +1,4 @@
-import { t as __exportAll } from "./chunk-CfYAbeIz.mjs";
+import { n as __exportAll } from "./chunk-uyGKjUfl.mjs";
 import { Array, Encoding, Match, Option, Result, Schema, pipe } from "effect";
 //#region src/codec.ts
 var codec_exports = /* @__PURE__ */ __exportAll({