codai-sdk 0.67.0 → 0.69.0

package/dist/index.js

@@ -1583,7 +1583,7 @@ function decodeBase64(b64) {
 	for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
 	return out;
 }
-function abortableSleep$6(ms, signal) {
+function abortableSleep$7(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1698,7 +1698,7 @@ var Videos = class {
 			}
 			if (st.status === "failed" || st.status === "filtered") throw new Error(`codai video job ${st.status}: ${st.error ?? "no details"}`);
 			if (Date.now() + pollIntervalMs > deadline) throw new Error(`codai video job ${job.id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$6(pollIntervalMs, signal);
+			await abortableSleep$7(pollIntervalMs, signal);
 		}
 	}
 };
@@ -1797,14 +1797,14 @@ var Renders = class {
 			}
 			if (st.status === "failed") throw new Error(`codai render failed: ${st.error ?? "no details"}`);
 			if (Date.now() + pollIntervalMs > deadline) throw new Error(`codai render ${job.id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$6(pollIntervalMs, signal);
+			await abortableSleep$7(pollIntervalMs, signal);
 		}
 	}
 };
 
 //#endregion
 //#region src/resources/documents.ts
-function abortableSleep$5(ms, signal) {
+function abortableSleep$6(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1897,7 +1897,7 @@ var Documents = class {
 			if (st.status === "succeeded") return st;
 			if (st.status === "failed") throw new Error(`codai document preview failed: ${st.error ?? "no details"}`);
 			if (Date.now() + pollIntervalMs > deadline) throw new Error(`codai document preview ${job.id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$5(pollIntervalMs, signal);
+			await abortableSleep$6(pollIntervalMs, signal);
 		}
 	}
 	/** Queue a deck video and poll `renders.retrieve` until it succeeds. Throws on `failed` or timeout. */
@@ -1929,7 +1929,7 @@ var Documents = class {
 			}
 			if (st.status === "failed") throw new Error(`codai deck video failed: ${st.error ?? "no details"}`);
 			if (Date.now() + pollIntervalMs > deadline) throw new Error(`codai deck video ${accepted.id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$5(pollIntervalMs, signal);
+			await abortableSleep$6(pollIntervalMs, signal);
 		}
 	}
 };
@@ -1937,7 +1937,7 @@ var Documents = class {
 //#endregion
 //#region src/resources/exports.ts
 const path$6 = (id) => `/v1/studio/exports/${encodeURIComponent(id)}`;
-function abortableSleep$4(ms, signal) {
+function abortableSleep$5(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1978,13 +1978,15 @@ var Exports = class {
 			});
 			if (st.status === "succeeded" || st.status === "failed") return st;
 			if (Date.now() + intervalMs > deadline) throw new Error(`codai export ${id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$4(intervalMs, signal);
+			await abortableSleep$5(intervalMs, signal);
 		}
 	}
 };
 
 //#endregion
 //#region src/resources/creatives.ts
+/** True when a `build` answer is the 202 carousel / print export job (poll `exports.wait(r.export.id)`). */
+const isPagedBuild = (r) => "export" in r && r.export != null;
 const path$5 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
 const lottieQuery = (q) => ({
 	format: q.format,
@@ -2159,6 +2161,24 @@ var Creatives = class {
 		});
 	}
 	/**
+	* Mixdown + mastering + exports of an `audio` creative (MU-05; same `POST …/render` route, HTTP 202). `formats`
+	* (default `['wav', 'mp3']`), `stems: true` adds one WAV per audible track (+50 %), `lrc` exports the timed lyrics
+	* (default on when the document has them), `loudness` is `streaming` (−14) | `podcast` (−16) | `broadcast` (−23) or
+	* LUFS (−40…−5). Poll `renders.retrieve(render_id)`: the finished render's `data[]` holds one signed asset per output
+	* (`output: mix | stem | lrc`). $0.001 per output second, minimum $0.01; held up front, billed on the measured length.
+	* 400 `empty_audio` / `too_long` (20 min) / `no_lyrics`; video creatives use `render`.
+	*/
+	renderAudio(id, body = {}, opts = {}) {
+		return this.http.json(path$5(id, "/render"), {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: !opts.idempotencyKey
+		});
+	}
+	/**
 	* PNG still frames at up to 6 times (`t_ms`). `exact: false` (default) screenshots the compiled HTML; `exact: true`
 	* cuts them from a draft render of the covering scenes. Waits up to ~90 s: frames (`status: 'succeeded'`) or a
 	* running job (`status: 'running'`) to poll with `frameJob(id, frame_job_id)`. Cached frames are free; 60 frame
@@ -2308,6 +2328,11 @@ var Creatives = class {
 	* Studio document (`document`, exactly the `POST /v1/studio/documents` body). Converter notes come back in
 	* `warnings`. The file is free; `preview: true` also queues a billed preview (poll it with
 	* `documents.waitForPreview`). 400 `not_supported_for_kind` (video / image) or `invalid_spec`.
+	*
+	* A carousel (`format: 'png'` zip of slides or `'pdf'`) or print (`'pdf'`, PDF/X-4 with bleed and optional
+	* `crop_marks`) creative answers HTTP 202 with a queued export job in `export` (`format_id` picks the format,
+	* `quote_micro_usd` is held). Tell the two apart with `isPagedBuild`, poll with `exports.wait(r.export.id)` or use
+	* `buildAndWait`.
 	*/
 	build(id, body = {}, opts = {}) {
 		return this.http.json(path$5(id, "/build"), {
@@ -2319,6 +2344,69 @@ var Creatives = class {
 		});
 	}
 	/**
+	* `build`, then — for a carousel / print creative — poll the export job until it has `succeeded` or `failed`
+	* (`exports.wait`). Resolves to the 200 build for deck / doc / sheet, or to the finished `StudioExport`.
+	*/
+	async buildAndWait(id, body = {}, opts = {}) {
+		const r = await this.build(id, body, {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+		if (!isPagedBuild(r)) return r;
+		const e = r.export;
+		if (e.status === "succeeded" || e.status === "failed") return e;
+		return new Exports(this.http).wait(e.id, opts);
+	}
+	/**
+	* Social post copy for a carousel, image or video creative: a caption + hashtags per platform (`platforms`,
+	* default Instagram + LinkedIn; `language` `ro` (default) | `en`; optional `brief`, `tone`, `seq`) and one alt text
+	* per slide, every answer repaired to the platform's hard limits (changes listed in `fixes`). Nothing is written to
+	* the creative. Token-metered (`cost_micro_usd`) under a small wallet hold (402 `insufficient_funds`); 400
+	* `not_supported_for_kind`, 422 `no_post_copy`, 504 `timeout`. `idempotencyKey` replays a retry (24 h).
+	*/
+	postCopy(id, body = {}, opts = {}) {
+		return this.http.json(path$5(id, "/post-copy"), {
+			method: "POST",
+			body: stripUndefined(body),
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: !opts.idempotencyKey
+		});
+	}
+	/**
+	* Edit a video clip by its transcript: delete word ranges (`remove: [{ from_word, to_word }]`, indexes into the
+	* clip asset's cached transcript from `captions`) from video node `node_id`; the pieces are placed back to back as
+	* one new version (`base_seq` rebased like `edit`, locks honoured unless `force`). Free. 409 `captions_required`
+	* (run `captions` on that clip first) or `stale`; video creatives only.
+	*/
+	transcriptCut(id, body, opts = {}) {
+		return this.http.json(path$5(id, "/transcript-cut"), {
+			method: "POST",
+			body: stripUndefined(body),
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/**
+	* Generate a new picture for an `image` node (`prompt`, optional `model`, `aspect_ratio` — default the closest
+	* ratio of the node box — `base_seq`, `force`) and swap it in as one new version. A node with a `castId` sends that
+	* cast entry's `refAssetIds` as references and appends its `description`, so the subject stays consistent. Billed
+	* like `images.generate` (402 `insufficient_funds`); 400 `content_filtered` charges nothing. `idempotencyKey`
+	* replays a retry (24 h).
+	*/
+	regenerateNode(id, nodeId, body, opts = {}) {
+		return this.http.json(path$5(id, `/nodes/${encodeURIComponent(nodeId)}/regenerate`), {
+			method: "POST",
+			body: stripUndefined(body),
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: !opts.idempotencyKey
+		});
+	}
+	/**
 	* Re-apply a brand kit (`brand_kit_id`) or a flat token map (`tokens`) to the creative as one new version: literal
 	* colours equal to the old brand become token refs, `snap: true` maps every other colour to the nearest kit colour,
 	* `fonts` (default true) sets heading / body font refs by role, locked nodes are skipped unless `force`. The kit
@@ -2705,7 +2793,7 @@ var Templates = class {
 //#endregion
 //#region src/resources/productions.ts
 const path$2 = (id) => `/v1/studio/productions/${encodeURIComponent(id)}`;
-function abortableSleep$3(ms, signal) {
+function abortableSleep$4(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -2754,7 +2842,7 @@ var Productions = class {
 			const p = await this.retrieve(id, opts);
 			if (isProductionFinished(p)) return p;
 			if (Date.now() + interval > deadline) throw new Error(`codai: production ${id} did not finish in time (phase ${p.phase})`);
-			await abortableSleep$3(interval, opts.signal);
+			await abortableSleep$4(interval, opts.signal);
 		}
 	}
 	/** `create` + `wait`. */
@@ -2764,6 +2852,293 @@ var Productions = class {
 	}
 };
 
+//#endregion
+//#region src/resources/media-ops.ts
+const BASE$1 = "/v1/studio/media-ops";
+const opPath = (op) => `${BASE$1}/${encodeURIComponent(op)}`;
+function abortableSleep$3(ms, signal) {
+	return new Promise((resolve, reject) => {
+		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
+		const t = setTimeout(() => {
+			signal?.removeEventListener("abort", onAbort);
+			resolve();
+		}, ms);
+		const onAbort = () => {
+			clearTimeout(t);
+			reject(signal?.reason ?? /* @__PURE__ */ new Error("Aborted"));
+		};
+		signal?.addEventListener("abort", onAbort, { once: true });
+	});
+}
+const toBody = (input) => ({
+	asset_ids: input.assetIds ?? [],
+	params: input.params ?? {},
+	...input.maskPngB64 !== void 0 ? { mask_png_b64: input.maskPngB64 } : {}
+});
+/** A run answer is a job (async op, HTTP 202) when `object` is `media_op.job`. */
+const isMediaOpJob = (r) => r.object === "media_op.job";
+const isMediaOpJobFinished = (j) => j.status === "ready" || j.status === "failed";
+var MediaOps = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/** `GET /v1/studio/media-ops` — every op with engine, mode, inputs, `available` and a list quote (free). */
+	list(opts = {}) {
+		return this.http.json(BASE$1, {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/studio/media-ops/{op}/quote` — exact price of this request; nothing is held or billed. */
+	quote(op, input = {}, opts = {}) {
+		return this.http.json(`${opPath(op)}/quote`, {
+			method: "POST",
+			body: toBody(input),
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* `POST /v1/studio/media-ops/{op}` — sync ops resolve to a `media_op.result` with the outputs, async ops to a
+	* `media_op.job` (`status: pending`; poll with `job` / `wait`). Use `isMediaOpJob` to tell them apart.
+	*/
+	run(op, input = {}, opts = {}) {
+		return this.http.json(opPath(op), {
+			method: "POST",
+			body: toBody(input),
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `GET /v1/studio/media-ops/jobs/{id}` — the job; reading a finished one stores its outputs and bills it once. */
+	job(id, opts = {}) {
+		return this.http.json(`${BASE$1}/jobs/${encodeURIComponent(id)}`, {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* Poll `job` every `intervalMs` (default 3 s) until it is `ready` or `failed` (a failed job resolves too — check
+	* `status` / `error`). Throws after `timeoutMs` (default 20 min) or when `signal` aborts.
+	*/
+	async wait(id, opts = {}) {
+		const interval = opts.intervalMs ?? 3e3;
+		const deadline = Date.now() + (opts.timeoutMs ?? 12e5);
+		for (;;) {
+			const j = await this.job(id, opts);
+			if (isMediaOpJobFinished(j)) return j;
+			if (Date.now() + interval > deadline) throw new Error(`codai: media job ${id} did not finish in time (status ${j.status})`);
+			await abortableSleep$3(interval, opts.signal);
+		}
+	}
+	/** `run`, then `wait` when the op is async. */
+	async runAndWait(op, input = {}, opts = {}) {
+		const r = await this.run(op, input, opts);
+		return isMediaOpJob(r) && !isMediaOpJobFinished(r) ? this.wait(r.id, opts) : r;
+	}
+};
+
+//#endregion
+//#region src/resources/lyrics.ts
+const BASE = "/v1/studio/lyrics";
+var LyricsResource = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	post(path, body, opts) {
+		return this.http.json(path, {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* `POST /v1/studio/lyrics` — `{ brief, language: 'ro' | 'en', genre?, mood?, structure?, syllables_per_line?,
+	* rhyme_scheme?, lines_per_section?, title? }` → `studio.lyrics` with every line's syllables and rhyme letter, the
+	* whole song as `text` (`[kind]` headers) and a `report`. `repaired: true` when the repair turn won.
+	*/
+	write(body, opts = {}) {
+		return this.post(BASE, body, opts);
+	}
+	/**
+	* `POST /v1/studio/lyrics/align` — `{ creative_id, clip_id, lyrics_text, language?, apply?, base_seq?,
+	* retranscribe? }` → `studio.lyrics_alignment`: timed `lines`, `lrc`, `match_ratio`, `cached`, and `seq` /
+	* `doc_hash` of the new version when applied.
+	*/
+	align(body, opts = {}) {
+		return this.post(`${BASE}/align`, body, opts);
+	}
+};
+
+//#endregion
+//#region src/resources/jam.ts
+const JAM_SUBPROTOCOL = "codai-jam";
+/** WebSocket close codes of `/v1/studio/jam`. */
+const JAM_CLOSE_CODES = {
+	invalidMessage: 4400,
+	unauthorized: 4401,
+	insufficientFunds: 4402,
+	forbidden: 4403,
+	maxDuration: 4408,
+	busy: 4409,
+	upstream: 4502,
+	unavailable: 4503
+};
+const JAM_SCALES = [
+	"SCALE_UNSPECIFIED",
+	"C_MAJOR_A_MINOR",
+	"D_FLAT_MAJOR_B_FLAT_MINOR",
+	"D_MAJOR_B_MINOR",
+	"E_FLAT_MAJOR_C_MINOR",
+	"E_MAJOR_D_FLAT_MINOR",
+	"F_MAJOR_D_MINOR",
+	"G_FLAT_MAJOR_E_FLAT_MINOR",
+	"G_MAJOR_E_MINOR",
+	"A_FLAT_MAJOR_F_MINOR",
+	"A_MAJOR_G_FLAT_MINOR",
+	"B_FLAT_MAJOR_G_MINOR",
+	"B_MAJOR_A_FLAT_MINOR"
+];
+const OPEN$1 = 1;
+function toArrayBuffer(data) {
+	if (data instanceof ArrayBuffer) return data;
+	if (ArrayBuffer.isView(data)) {
+		const v = data;
+		return v.buffer.slice(v.byteOffset, v.byteOffset + v.byteLength);
+	}
+	return null;
+}
+/** A live jam session: `on()` listeners for status / audio / errors and typed senders. */
+var JamSession = class {
+	socket;
+	listeners = /* @__PURE__ */ new Map();
+	outbox = [];
+	closed = false;
+	/** Resolves when the socket is open (rejects if it closes first). */
+	ready;
+	constructor(socket) {
+		this.socket = socket;
+		let resolveReady;
+		let rejectReady;
+		this.ready = new Promise((res, rej) => {
+			resolveReady = res;
+			rejectReady = rej;
+		});
+		this.ready.catch(() => void 0);
+		socket.onopen = () => {
+			for (const f of this.outbox.splice(0)) socket.send(f);
+			resolveReady();
+		};
+		socket.onmessage = (ev) => {
+			if (typeof ev.data !== "string") {
+				const buf = toArrayBuffer(ev.data);
+				if (buf) this.emit({
+					type: "audio",
+					data: buf
+				});
+				return;
+			}
+			let parsed;
+			try {
+				parsed = JSON.parse(ev.data);
+			} catch {
+				return;
+			}
+			if (parsed && typeof parsed === "object" && typeof parsed.type === "string") this.emit(parsed);
+		};
+		socket.onerror = () => {};
+		socket.onclose = (ev) => {
+			rejectReady(/* @__PURE__ */ new Error(`jam socket closed before open (${String(ev.code)} ${ev.reason})`));
+			this.closed = true;
+			this.emit({
+				type: "close",
+				code: ev.code,
+				reason: ev.reason
+			});
+		};
+	}
+	on(type, fn) {
+		let set = this.listeners.get(type);
+		if (!set) this.listeners.set(type, set = /* @__PURE__ */ new Set());
+		set.add(fn);
+		return () => set.delete(fn);
+	}
+	/** Send one client message (JSON). Queued until the socket opens. */
+	send(msg) {
+		if (this.closed) throw new Error("jam session is closed");
+		const frame = JSON.stringify(msg);
+		if (this.socket.readyState === OPEN$1) this.socket.send(frame);
+		else this.outbox.push(frame);
+	}
+	prompts(prompts) {
+		this.send({
+			type: "prompts",
+			prompts
+		});
+	}
+	config(config) {
+		this.send({
+			type: "config",
+			...config
+		});
+	}
+	play() {
+		this.send({ type: "play" });
+	}
+	pause() {
+		this.send({ type: "pause" });
+	}
+	stop() {
+		this.send({ type: "stop" });
+	}
+	reset() {
+		this.send({ type: "reset" });
+	}
+	close(code = 1e3, reason = "client closed") {
+		if (this.closed) return;
+		this.socket.close(code, reason);
+	}
+	emit(ev) {
+		for (const fn of this.listeners.get(ev.type) ?? []) fn(ev);
+		for (const fn of this.listeners.get("*") ?? []) fn(ev);
+	}
+};
+/** Build the `wss://…/v1/studio/jam` URL (exported for tests and custom transports). */
+function jamUrl(baseUrl, opts = {}) {
+	const url = new URL(`${baseUrl.replace(/\/$/, "").replace(/^http/, "ws")}/v1/studio/jam`);
+	if (opts.sessionId) url.searchParams.set("session_id", opts.sessionId);
+	return url.toString();
+}
+var Jam = class {
+	defaults;
+	constructor(defaults) {
+		this.defaults = defaults;
+	}
+	/** Open a live jam. Returns immediately; `await session.ready` to wait for the socket. */
+	connect(opts = {}) {
+		const Ctor = opts.WebSocket ?? globalThis.WebSocket;
+		if (!Ctor) throw new Error("codai.jam: no WebSocket available — pass options.WebSocket");
+		let token = opts.token;
+		let apiKey = token ? void 0 : opts.apiKey ?? this.defaults.apiKey;
+		if (apiKey?.startsWith("codai_eph_v1.")) {
+			token = apiKey;
+			apiKey = void 0;
+		}
+		if (!token && !apiKey) throw new Error("codai.jam: pass `token` (browser) or `apiKey`");
+		const url = jamUrl(opts.baseUrl ?? this.defaults.baseUrl, opts);
+		const socket = apiKey ? new Ctor(url, [JAM_SUBPROTOCOL], { headers: { Authorization: `Bearer ${apiKey}` } }) : new Ctor(url, [JAM_SUBPROTOCOL, `bearer.${token}`]);
+		if ("binaryType" in socket) socket.binaryType = "arraybuffer";
+		return new JamSession(socket);
+	}
+};
+
 //#endregion
 //#region src/resources/batches.ts
 const BATCH_DONE = [
@@ -6453,6 +6828,12 @@ const OPERATION_METHODS = {
 	listCreativeTemplates: "templates.list",
 	createStudioProduction: "productions.create",
 	getStudioProduction: "productions.retrieve",
+	listStudioMediaOps: "mediaOps.list",
+	quoteStudioMediaOp: "mediaOps.quote",
+	runStudioMediaOp: "mediaOps.run",
+	getStudioMediaOpJob: "mediaOps.job",
+	writeStudioLyrics: "lyrics.write",
+	alignStudioLyrics: "lyrics.align",
 	getCreativeTemplate: "templates.retrieve",
 	deleteCreativeTemplate: "templates.delete",
 	exportCreativeFcpxml: "creatives.exportFcpxml",
@@ -6460,6 +6841,9 @@ const OPERATION_METHODS = {
 	getStudioExport: "exports.retrieve",
 	createCreativeFromDocument: "creatives.fromDocument",
 	buildCreative: "creatives.build",
+	writeCreativePostCopy: "creatives.postCopy",
+	transcriptCutCreative: "creatives.transcriptCut",
+	regenerateCreativeNode: "creatives.regenerateNode",
 	createSystemOne: "systemOne.create",
 	createTranscription: "audio.transcribe",
 	createSpeech: "audio.speech",
@@ -6921,6 +7305,13 @@ var CodaiApps = class {
 *     built-in starters; free; use with creatives.create({ kind, template, vars }))
 *   client.productions.create / .retrieve / .wait / .run (codai Studio brief → promo video: storyboard, images,
 *     voice-over, editable creative, draft render, one review + repair; billed as the parts are produced)
+*   client.mediaOps.list / .quote / .run / .job / .wait / .runAndWait (codai Studio media operations on your assets:
+*     background removal, upscale, inpaint / outpaint / erase, stems, denoise, MIDI, mastering, analysis, ACE-Step
+*     music and sound effects; quote held, measured cost billed; async ops return a job)
+*   client.lyrics.write / .align (codai Studio lyrics writer with syllable + rhyme checks; karaoke alignment to a clip
+*     of an audio creative with LRC; token-metered / transcription billed)
+*   client.creatives.renderAudio (mixdown + mastering of an audio creative: WAV / MP3 / FLAC, stems, LRC)
+*   client.jam.connect (WebSocket live jam on Lyria RealTime; not an OpenAPI operation)
 *   client.exports.retrieve / .wait (codai Studio FCPXML exports queued with creatives.exportFcpxml; only newly
 *     rendered seconds are billed; Lottie exports from creatives.exportLottie are free and ready at once)
 *   client.batches.create / .dryRun / .list / .get / .cancel / .retry / .exportCsv / .zip / .wait (codai Studio
@@ -6989,6 +7380,12 @@ var Codai = class {
 	templates;
 	/** codai Studio productions (`productions.run({ brief, language: 'ro' })` → a finished promo video + editable creative). */
 	productions;
+	/** codai Studio media operations (`mediaOps.run('audio.separate_stems', { assetIds })` → job; `mediaOps.wait(id)`). */
+	mediaOps;
+	/** codai Studio lyrics (`lyrics.write({ brief, language: 'ro' })`, `lyrics.align({ creative_id, clip_id, lyrics_text })`). */
+	lyrics;
+	/** codai Studio live jam over WebSocket (`jam.connect({ token })` → PCM16 48 kHz stereo; `prompts`, `config`, `play`). */
+	jam;
 	/** codai Studio FCPXML exports (`creatives.exportFcpxml(id)` queues one; `exports.wait(id)` polls until the zip is ready). */
 	exports;
 	/** codai Studio batches (`batches.create({ source: { template_id }, csv })` → one creative per row; `batches.wait(id)`). */
@@ -7093,6 +7490,12 @@ var Codai = class {
 		this.brandKits = new BrandKits(http);
 		this.templates = new Templates(http);
 		this.productions = new Productions(http);
+		this.mediaOps = new MediaOps(http);
+		this.lyrics = new LyricsResource(http);
+		this.jam = new Jam({
+			baseUrl: http.baseUrl,
+			apiKey: opts.apiKey
+		});
 		this.exports = new Exports(http);
 		this.batches = new Batches(http);
 		this.shares = new Shares(http);
@@ -7227,5 +7630,5 @@ function allKeys(obj) {
 }
 
 //#endregion
-export { AbuseReports, Account, AgentRuns, Agents, Assets, Audio, Batches, Billing, BrandKits, Cards, Chat, ChatCompletions, Codai, Codai as default, CodaiApps, CodaiError, Creatives, Devices, Documents, Embeddings, EnvironmentFiles, EnvironmentJobs, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Exports, Feedback, Health, Heartbeats, Hosts, HttpClient, Images, Keys, Lists, Memory, Messages, Models, Music, Notifications, OPERATION_METHODS, OrgMembers, Orgs, OsGate, PROVENANCE_MAX_BYTES, PhoneModels, Productions, Projects, Prompts, Provenance, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Referrals, Renders, Research, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SandboxFiles, Sandboxes, ScheduleExecutor, SchedulerHosts, Schedules, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Settings, Sfx, Shares, SystemOne, TUS_CHUNK_BYTES, Tasks, Templates, Tokens, Tools, Transcripts, Triggers, Usage, Vault, VaultDevices, Verify, Videos, VoiceRevocations, extensionHeaders, frameJson, isAssetDto, isProductionFinished, isResearchFinished, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
+export { AbuseReports, Account, AgentRuns, Agents, Assets, Audio, Batches, Billing, BrandKits, Cards, Chat, ChatCompletions, Codai, Codai as default, CodaiApps, CodaiError, Creatives, Devices, Documents, Embeddings, EnvironmentFiles, EnvironmentJobs, EnvironmentMembers, EnvironmentPorts, EnvironmentSecrets, EnvironmentTasks, Environments, Exports, Feedback, Health, Heartbeats, Hosts, HttpClient, Images, JAM_CLOSE_CODES, JAM_SCALES, JAM_SUBPROTOCOL, Jam, JamSession, Keys, Lists, LyricsResource, MediaOps, Memory, Messages, Models, Music, Notifications, OPERATION_METHODS, OrgMembers, Orgs, OsGate, PROVENANCE_MAX_BYTES, PhoneModels, Productions, Projects, Prompts, Provenance, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Referrals, Renders, Research, Resolve, ResolveError, ResolveInsufficientFundsError, Responses, STREAMING_OPERATIONS, SandboxFiles, Sandboxes, ScheduleExecutor, SchedulerHosts, Schedules, SessionControls, SessionEvents, SessionLease, SessionShares, Sessions, Settings, Sfx, Shares, SystemOne, TUS_CHUNK_BYTES, Tasks, Templates, Tokens, Tools, Transcripts, Triggers, Usage, Vault, VaultDevices, Verify, Videos, VoiceRevocations, extensionHeaders, frameJson, isAssetDto, isMediaOpJob, isMediaOpJobFinished, isPagedBuild, isProductionFinished, isResearchFinished, jamUrl, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map