codai-sdk 0.68.0 → 0.70.0

package/dist/index.js

@@ -1,4 +1,4 @@
-//#region src/http.ts
+// src/http.ts
 var CodaiError = class extends Error {
 	status;
 	body;
@@ -258,16 +258,14 @@ function sleep(ms) {
 	return new Promise((r) => setTimeout(r, ms));
 }
 
-//#endregion
-//#region src/resources/_shared.ts
+// src/resources/_shared.ts
 function stripUndefined(obj) {
 	const out = {};
 	for (const [k, v] of Object.entries(obj)) if (v !== void 0) out[k] = v;
 	return out;
 }
 
-//#endregion
-//#region src/resources/account.ts
+// src/resources/account.ts
 var Account = class {
 	http;
 	constructor(http) {
@@ -341,8 +339,7 @@ var PhoneModels = class {
 	}
 };
 
-//#endregion
-//#region src/resources/agents.ts
+// src/resources/agents.ts
 /** `/v1/agents/*` — synchronous runs and the persisted async run lifecycle. */
 var AgentRuns = class {
 	http;
@@ -436,8 +433,7 @@ var Agents = class {
 	}
 };
 
-//#endregion
-//#region src/resources/audio.ts
+// src/resources/audio.ts
 /** `POST /v1/audio/transcriptions`, `POST /v1/audio/speech` and `POST /v1/audio/speech/stream`. */
 function base64ToBytes$1(b64) {
 	const bin = atob(b64);
@@ -564,8 +560,7 @@ var Audio = class {
 	}
 };
 
-//#endregion
-//#region src/resources/billing.ts
+// src/resources/billing.ts
 var Billing = class {
 	http;
 	constructor(http) {
@@ -637,8 +632,7 @@ var Billing = class {
 	}
 };
 
-//#endregion
-//#region src/resources/cards.ts
+// src/resources/cards.ts
 var Cards = class {
 	http;
 	constructor(http) {
@@ -765,8 +759,7 @@ var Cards = class {
 	}
 };
 
-//#endregion
-//#region src/resources/chat.ts
+// src/resources/chat.ts
 /** `POST /v1/chat/completions` — OpenAI-compatible completions (JSON + SSE). */
 function toUsage(u) {
 	if (!u) return null;
@@ -905,8 +898,7 @@ var Chat = class {
 	}
 };
 
-//#endregion
-//#region src/resources/devices.ts
+// src/resources/devices.ts
 var Devices = class {
 	http;
 	constructor(http) {
@@ -960,8 +952,7 @@ var Devices = class {
 	}
 };
 
-//#endregion
-//#region src/resources/embeddings.ts
+// src/resources/embeddings.ts
 var Embeddings = class {
 	http;
 	constructor(http) {
@@ -987,8 +978,7 @@ var Embeddings = class {
 	}
 };
 
-//#endregion
-//#region src/resources/environments.ts
+// src/resources/environments.ts
 const envPath = (id, suffix = "") => `/v1/environments/${encodeURIComponent(id)}${suffix}`;
 /** Absolute environment path → `/files/<each segment URL-encoded>`. */
 const filePath$1 = (path) => path.replace(/^\/+/, "").split("/").map((s) => encodeURIComponent(s)).join("/");
@@ -1332,8 +1322,7 @@ var Environments = class {
 	}
 };
 
-//#endregion
-//#region src/resources/health.ts
+// src/resources/health.ts
 var Health = class {
 	http;
 	constructor(http) {
@@ -1370,8 +1359,7 @@ var Health = class {
 	}
 };
 
-//#endregion
-//#region src/resources/hosts.ts
+// src/resources/hosts.ts
 /** `/v1/hosts/*` — host relay (desktop announces itself; clients exec ops on it). */
 var Hosts = class {
 	http;
@@ -1438,8 +1426,7 @@ var Hosts = class {
 	}
 };
 
-//#endregion
-//#region src/resources/assets.ts
+// src/resources/assets.ts
 /** True for a `data` item that is a stored asset rather than inline base64. */
 function isAssetDto(item) {
 	return typeof item === "object" && item !== null && "asset_id" in item;
@@ -1514,8 +1501,7 @@ var Assets = class {
 	}
 };
 
-//#endregion
-//#region src/resources/images.ts
+// src/resources/images.ts
 /** Image generation typically takes 5–30 s; the gateway allows 120 s upstream. */
 const MIN_IMAGE_TIMEOUT_MS = 15e4;
 function decodeBase64$1(b64) {
@@ -1573,8 +1559,7 @@ var Images = class {
 	}
 };
 
-//#endregion
-//#region src/resources/media.ts
+// src/resources/media.ts
 /** Lyria 3 Pro can take minutes for a long song; the gateway allows 240 s upstream (+ lyrics check). */
 const MIN_MUSIC_TIMEOUT_MS = 3e5;
 function decodeBase64(b64) {
@@ -1583,7 +1568,7 @@ function decodeBase64(b64) {
 	for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
 	return out;
 }
-function abortableSleep$7(ms, signal) {
+function abortableSleep$8(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1698,7 +1683,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$7(pollIntervalMs, signal);
+			await abortableSleep$8(pollIntervalMs, signal);
 		}
 	}
 };
@@ -1797,14 +1782,13 @@ 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$7(pollIntervalMs, signal);
+			await abortableSleep$8(pollIntervalMs, signal);
 		}
 	}
 };
 
-//#endregion
-//#region src/resources/documents.ts
-function abortableSleep$6(ms, signal) {
+// src/resources/documents.ts
+function abortableSleep$7(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1897,7 +1881,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$6(pollIntervalMs, signal);
+			await abortableSleep$7(pollIntervalMs, signal);
 		}
 	}
 	/** Queue a deck video and poll `renders.retrieve` until it succeeds. Throws on `failed` or timeout. */
@@ -1929,15 +1913,14 @@ 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$6(pollIntervalMs, signal);
+			await abortableSleep$7(pollIntervalMs, signal);
 		}
 	}
 };
 
-//#endregion
-//#region src/resources/exports.ts
-const path$6 = (id) => `/v1/studio/exports/${encodeURIComponent(id)}`;
-function abortableSleep$5(ms, signal) {
+// src/resources/exports.ts
+const path$7 = (id) => `/v1/studio/exports/${encodeURIComponent(id)}`;
+function abortableSleep$6(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -1958,7 +1941,7 @@ var Exports = class {
 	}
 	/** The export: `queued` / `running`, then `succeeded` (signed `url`, valid 1 h) or `failed` (`error`). Free. */
 	retrieve(id, opts = {}) {
-		return this.http.json(path$6(id), {
+		return this.http.json(path$7(id), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -1978,14 +1961,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$5(intervalMs, signal);
+			await abortableSleep$6(intervalMs, signal);
 		}
 	}
 };
 
-//#endregion
-//#region src/resources/creatives.ts
-const path$5 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
+// 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$6 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
 const lottieQuery = (q) => ({
 	format: q.format,
 	formats: q.formats,
@@ -2025,7 +2009,7 @@ var Creatives = class {
 	}
 	/** The document at the head (or `seq`) with signed `assets` (1 h URLs). */
 	retrieve(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id), {
+		return this.http.json(path$6(id), {
 			query: { seq: query.seq },
 			ext: opts.ext,
 			signal: opts.signal
@@ -2033,14 +2017,14 @@ var Creatives = class {
 	}
 	/** Compact text outline (+ formats and vars) — the cheapest structure for a prompt. */
 	outline(id, opts = {}) {
-		return this.http.json(path$5(id, "/outline"), {
+		return this.http.json(path$6(id, "/outline"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 	/** Node ids matching `query` (a string = text/name/id substring, or `{ text, type, sceneId, assetId, locked }`). */
 	find(id, query, opts = {}) {
-		return this.http.json(path$5(id, "/find"), {
+		return this.http.json(path$6(id, "/find"), {
 			method: "POST",
 			body: { query },
 			ext: opts.ext,
@@ -2049,7 +2033,7 @@ var Creatives = class {
 	}
 	/** Full JSON of `ids` (scene ids return whole scenes) or of one `sceneId`. */
 	subtree(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/subtree"), {
+		return this.http.json(path$6(id, "/subtree"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2062,7 +2046,7 @@ var Creatives = class {
 	* ops throw 400 with `code` (`invalid`, `not_found`, `locked`, `duplicate_id`).
 	*/
 	edit(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/ops"), {
+		return this.http.json(path$6(id, "/ops"), {
 			method: "POST",
 			body: {
 				base_seq: body.baseSeq,
@@ -2078,7 +2062,7 @@ var Creatives = class {
 	}
 	/** Version history, newest first (`beforeSeq` pages). */
 	versions(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/versions"), {
+		return this.http.json(path$6(id, "/versions"), {
 			query: {
 				before_seq: query.beforeSeq,
 				limit: query.limit
@@ -2089,7 +2073,7 @@ var Creatives = class {
 	}
 	/** New head whose document is version `seq`'s (undo / redo). */
 	revert(id, seq, opts = {}) {
-		return this.http.json(path$5(id, "/revert"), {
+		return this.http.json(path$6(id, "/revert"), {
 			method: "POST",
 			body: { seq },
 			ext: opts.ext,
@@ -2099,7 +2083,7 @@ var Creatives = class {
 	}
 	/** New creative from version `seq` (default the head). */
 	fork(id, body = {}, opts = {}) {
-		return this.http.json(path$5(id, "/fork"), {
+		return this.http.json(path$6(id, "/fork"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2109,7 +2093,7 @@ var Creatives = class {
 	}
 	/** Soft-delete the creative. */
 	delete(id, opts = {}) {
-		return this.http.json(path$5(id), {
+		return this.http.json(path$6(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2122,7 +2106,7 @@ var Creatives = class {
 	* `text_overflow_locale`); 404 `Locale not found.` for an unknown locale.
 	*/
 	lint(id, body = {}, opts = {}) {
-		return this.http.json(path$5(id, "/lint"), {
+		return this.http.json(path$6(id, "/lint"), {
 			method: "POST",
 			...body.locale !== void 0 ? { body: { locale: body.locale } } : {},
 			ext: opts.ext,
@@ -2131,7 +2115,7 @@ var Creatives = class {
 	}
 	/** Preview HTML (signed asset URLs) for `format` / one `scene` / a translation (`locale`). */
 	compiled(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/compiled"), {
+		return this.http.json(path$6(id, "/compiled"), {
 			query: {
 				format: query.format,
 				scene: query.scene,
@@ -2150,7 +2134,7 @@ var Creatives = class {
 	* `corner` when the creative uses TTS narration or AI images, else `none` (`none` with narration: 400 `ai_label_required`).
 	*/
 	render(id, body = {}, opts = {}) {
-		return this.http.json(path$5(id, "/render"), {
+		return this.http.json(path$6(id, "/render"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2167,7 +2151,7 @@ var Creatives = class {
 	* 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"), {
+		return this.http.json(path$6(id, "/render"), {
 			method: "POST",
 			body,
 			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
@@ -2183,7 +2167,7 @@ var Creatives = class {
 	* jobs per UTC day are free, then billed (`billed_micro_usd`).
 	*/
 	frame(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/frame"), {
+		return this.http.json(path$6(id, "/frame"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2198,7 +2182,7 @@ var Creatives = class {
 	* Token-metered like any `codai` text call.
 	*/
 	comment(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/comments"), {
+		return this.http.json(path$6(id, "/comments"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2213,7 +2197,7 @@ var Creatives = class {
 	* until `pickVariant`. 422 `no_edit` when no valid variant came back, 504 `timeout` after 90 s. Token-metered.
 	*/
 	variants(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/variants"), {
+		return this.http.json(path$6(id, "/variants"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2223,7 +2207,7 @@ var Creatives = class {
 	}
 	/** The latest variant group of a creative (`group_id: null` when none) with statuses and stored render state. */
 	listVariants(id, opts = {}) {
-		return this.http.json(path$5(id, "/variants"), {
+		return this.http.json(path$6(id, "/variants"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2233,7 +2217,7 @@ var Creatives = class {
 	* else); the winner is marked `winner`, the rest of its group `rejected`.
 	*/
 	pickVariant(id, variantId, body, opts = {}) {
-		return this.http.json(path$5(id, `/variants/${encodeURIComponent(variantId)}/pick`), {
+		return this.http.json(path$6(id, `/variants/${encodeURIComponent(variantId)}/pick`), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2247,7 +2231,7 @@ var Creatives = class {
 	* 400 `node_not_found` / `invalid_pick` / `duplicate_key`. Free.
 	*/
 	saveTemplate(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/template"), {
+		return this.http.json(path$6(id, "/template"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2262,7 +2246,7 @@ var Creatives = class {
 	* rendered seconds are billed (final render price). 400 `unsupported_kind` / `unsupported_format` / `too_long`.
 	*/
 	exportFcpxml(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/export.fcpxml"), {
+		return this.http.json(path$6(id, "/export.fcpxml"), {
 			query: {
 				format: query.format,
 				seq: query.seq
@@ -2280,7 +2264,7 @@ var Creatives = class {
 	* 400 `unsupported_kind` / `invalid_request`, 413 `too_large` (over 20 MB).
 	*/
 	exportLottie(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/export.lottie"), {
+		return this.http.json(path$6(id, "/export.lottie"), {
 			query: lottieQuery(query),
 			ext: opts.ext,
 			signal: opts.signal,
@@ -2292,7 +2276,7 @@ var Creatives = class {
 	* for a dotLottie archive or a zip of JSON files (`formats: 'all'`). Same options and errors as `exportLottie`. Free.
 	*/
 	async downloadLottie(id, query = {}, opts = {}) {
-		const res = await this.http.request(path$5(id, "/export.lottie"), {
+		const res = await this.http.request(path$6(id, "/export.lottie"), {
 			query: {
 				...lottieQuery(query),
 				download: "1"
@@ -2326,9 +2310,60 @@ 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"), {
+		return this.http.json(path$6(id, "/build"), {
+			method: "POST",
+			body: stripUndefined(body),
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/**
+	* `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$6(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$6(id, "/transcript-cut"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2337,13 +2372,30 @@ var Creatives = class {
 		});
 	}
 	/**
+	* 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$6(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
 	* logo is registered too. `base_seq` defaults to the head (rebased like `edit`, 409 `stale` else). Free.
 	*/
 	restyle(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/restyle"), {
+		return this.http.json(path$6(id, "/restyle"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2359,7 +2411,7 @@ var Creatives = class {
 	* `unsupported_kind`); 403 `residency_unavailable`, 503 `transcription_unavailable`.
 	*/
 	captions(id, body = {}, opts = {}) {
-		return this.http.json(path$5(id, "/captions"), {
+		return this.http.json(path$6(id, "/captions"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2369,7 +2421,7 @@ var Creatives = class {
 	}
 	/** The captions as SubRip text on the document timeline (`node_id`, `seq` optional); 404 without captions. Free. */
 	async captionsSrt(id, query = {}, opts = {}) {
-		return (await this.http.request(path$5(id, "/captions.srt"), {
+		return (await this.http.request(path$6(id, "/captions.srt"), {
 			query: {
 				node_id: query.node_id,
 				seq: query.seq,
@@ -2381,7 +2433,7 @@ var Creatives = class {
 	}
 	/** The captions as WebVTT text on the document timeline (`node_id`, `seq` optional); 404 without captions. Free. */
 	async captionsVtt(id, query = {}, opts = {}) {
-		return (await this.http.request(path$5(id, "/captions.vtt"), {
+		return (await this.http.request(path$6(id, "/captions.vtt"), {
 			query: {
 				node_id: query.node_id,
 				seq: query.seq,
@@ -2397,7 +2449,7 @@ var Creatives = class {
 	* `focal: 'vision'` (token-metered) finds the focal point of full-bleed images; it fails open. Free otherwise.
 	*/
 	adapt(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/adapt"), {
+		return this.http.json(path$6(id, "/adapt"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2411,7 +2463,7 @@ var Creatives = class {
 	* to one `codai` turn. Nothing to fix: the current `seq`, empty `fixed`, no new version.
 	*/
 	lintFix(id, body = {}, opts = {}) {
-		return this.http.json(path$5(id, "/lint/fix"), {
+		return this.http.json(path$6(id, "/lint/fix"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2424,7 +2476,7 @@ var Creatives = class {
 	* values with a `setVar` op and controls with a `setControl` op (`edit`). Free.
 	*/
 	controls(id, opts = {}) {
-		return this.http.json(path$5(id, "/controls"), {
+		return this.http.json(path$6(id, "/controls"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2434,7 +2486,7 @@ var Creatives = class {
 	* With `locale` (+ `units`, default 1) also the units of that locale (paged with `offset` / `limit` ≤ 500). Free.
 	*/
 	locales(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/locales"), {
+		return this.http.json(path$6(id, "/locales"), {
 			query: {
 				locale: query.locale,
 				units: query.units,
@@ -2452,7 +2504,7 @@ var Creatives = class {
 	* 400 `nothing_to_translate`; 503 `localize_unavailable` when every locale failed.
 	*/
 	localize(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/localize"), {
+		return this.http.json(path$6(id, "/localize"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2465,7 +2517,7 @@ var Creatives = class {
 	* title `<title> (<locale>)`). 404 `Locale not found.`. Free (HTTP 201).
 	*/
 	forkLocale(id, locale, body = {}, opts = {}) {
-		return this.http.json(path$5(id, `/locales/${encodeURIComponent(locale)}/fork`), {
+		return this.http.json(path$6(id, `/locales/${encodeURIComponent(locale)}/fork`), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2479,7 +2531,7 @@ var Creatives = class {
 	* only in this answer (HTTP 201). 400 `unknown_seq`; 409 `too_many_shares` (20 active links). Free.
 	*/
 	createShare(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/shares"), {
+		return this.http.json(path$6(id, "/shares"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2489,14 +2541,14 @@ var Creatives = class {
 	}
 	/** The active links (not revoked, not expired), newest first; `url` is always null. Free. */
 	listShares(id, opts = {}) {
-		return this.http.json(path$5(id, "/shares"), {
+		return this.http.json(path$6(id, "/shares"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 	/** Revoke a link: it answers 404 from now on. 404 when unknown or already revoked. Free. */
 	async revokeShare(id, shareId, opts = {}) {
-		await this.http.request(path$5(id, `/shares/${encodeURIComponent(shareId)}`), {
+		await this.http.request(path$6(id, `/shares/${encodeURIComponent(shareId)}`), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2507,14 +2559,14 @@ var Creatives = class {
 	* version (`approved_is_head` false once the creative changed), decider and thread counts. Free.
 	*/
 	review(id, opts = {}) {
-		return this.http.json(path$5(id, "/review"), {
+		return this.http.json(path$6(id, "/review"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 	/** Send the head to review (`in_review`, earlier decision cleared) so approver links can decide. Free. */
 	requestReview(id, opts = {}) {
-		return this.http.json(path$5(id, "/review"), {
+		return this.http.json(path$6(id, "/review"), {
 			method: "POST",
 			body: { action: "request" },
 			ext: opts.ext,
@@ -2523,7 +2575,7 @@ var Creatives = class {
 	}
 	/** Back to `draft` (decision cleared, comments kept). Free. */
 	resetReview(id, opts = {}) {
-		return this.http.json(path$5(id, "/review"), {
+		return this.http.json(path$6(id, "/review"), {
 			method: "POST",
 			body: { action: "reset" },
 			ext: opts.ext,
@@ -2532,7 +2584,7 @@ var Creatives = class {
 	}
 	/** Comment threads, newest first (≤ 200), replies oldest first; `status` `open` | `resolved` | `all`. Free. */
 	reviewThreads(id, query = {}, opts = {}) {
-		return this.http.json(path$5(id, "/review/threads"), {
+		return this.http.json(path$6(id, "/review/threads"), {
 			query: { status: query.status },
 			ext: opts.ext,
 			signal: opts.signal
@@ -2543,7 +2595,7 @@ var Creatives = class {
 	* 400 `unknown_node` / `unknown_scene`; HTTP 201). 409 `too_many_comments`. Free.
 	*/
 	createReviewThread(id, body, opts = {}) {
-		return this.http.json(path$5(id, "/review/threads"), {
+		return this.http.json(path$6(id, "/review/threads"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2553,7 +2605,7 @@ var Creatives = class {
 	}
 	/** Reply in a thread as the owner (HTTP 201) — returns the whole thread. Free. */
 	replyReviewThread(id, threadId, body, opts = {}) {
-		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/replies`), {
+		return this.http.json(path$6(id, `/review/threads/${encodeURIComponent(threadId)}/replies`), {
 			method: "POST",
 			body: { body: body.body },
 			ext: opts.ext,
@@ -2563,7 +2615,7 @@ var Creatives = class {
 	}
 	/** Resolve a thread. Free. */
 	resolveReviewThread(id, threadId, opts = {}) {
-		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/resolve`), {
+		return this.http.json(path$6(id, `/review/threads/${encodeURIComponent(threadId)}/resolve`), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2571,7 +2623,7 @@ var Creatives = class {
 	}
 	/** Reopen a resolved thread. Free. */
 	reopenReviewThread(id, threadId, opts = {}) {
-		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/reopen`), {
+		return this.http.json(path$6(id, `/review/threads/${encodeURIComponent(threadId)}/reopen`), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2579,7 +2631,7 @@ var Creatives = class {
 	}
 	/** Delete any comment (owner moderation; deleting a root hides the thread). 404 when unknown. Free. */
 	async deleteReviewComment(id, commentId, opts = {}) {
-		await this.http.request(path$5(id, `/review/comments/${encodeURIComponent(commentId)}`), {
+		await this.http.request(path$6(id, `/review/comments/${encodeURIComponent(commentId)}`), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2587,16 +2639,15 @@ var Creatives = class {
 	}
 	/** Poll a frame job: frames when done (`status: 'succeeded'`), `status: 'running'` meanwhile; 404 unknown job. */
 	frameJob(id, jobId, opts = {}) {
-		return this.http.json(path$5(id, `/frames/${encodeURIComponent(jobId)}`), {
+		return this.http.json(path$6(id, `/frames/${encodeURIComponent(jobId)}`), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 };
 
-//#endregion
-//#region src/resources/brand-kits.ts
-const path$4 = (id, tail = "") => `/v1/studio/brand-kits/${encodeURIComponent(id)}${tail}`;
+// src/resources/brand-kits.ts
+const path$5 = (id, tail = "") => `/v1/studio/brand-kits/${encodeURIComponent(id)}${tail}`;
 var BrandKits = class {
 	http;
 	constructor(http) {
@@ -2621,7 +2672,7 @@ var BrandKits = class {
 	* `logo_asset_id: null` removes the logo. Creatives keep their tokens until `creatives.restyle`. Free.
 	*/
 	update(id, body, opts = {}) {
-		return this.http.json(path$4(id), {
+		return this.http.json(path$5(id), {
 			method: "PATCH",
 			body,
 			ext: opts.ext,
@@ -2631,7 +2682,7 @@ var BrandKits = class {
 	}
 	/** The kit as a DTCG 2025.10 JSON document (`$extensions['ro.codai']` = kit id, name, logo asset id). Free. */
 	exportDtcg(id, opts = {}) {
-		return this.http.json(path$4(id, "/dtcg"), {
+		return this.http.json(path$5(id, "/dtcg"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2661,14 +2712,14 @@ var BrandKits = class {
 	}
 	/** One kit with a signed logo URL (1 h), its `dtcg` and the WCAG `contrast` pairs. Free. */
 	retrieve(id, opts = {}) {
-		return this.http.json(path$4(id), {
+		return this.http.json(path$5(id), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 	/** Delete a kit (creatives keep their tokens; the logo asset stays). Free. */
 	delete(id, opts = {}) {
-		return this.http.json(path$4(id), {
+		return this.http.json(path$5(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2676,9 +2727,8 @@ var BrandKits = class {
 	}
 };
 
-//#endregion
-//#region src/resources/templates.ts
-const path$3 = (id) => `/v1/studio/templates/${encodeURIComponent(id)}`;
+// src/resources/templates.ts
+const path$4 = (id) => `/v1/studio/templates/${encodeURIComponent(id)}`;
 var Templates = class {
 	http;
 	constructor(http) {
@@ -2705,14 +2755,14 @@ var Templates = class {
 	}
 	/** One template with its variables and `doc`. Free. */
 	retrieve(id, opts = {}) {
-		return this.http.json(path$3(id), {
+		return this.http.json(path$4(id), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
 	}
 	/** Delete a template (creatives made from it are not affected). Free. */
 	delete(id, opts = {}) {
-		return this.http.json(path$3(id), {
+		return this.http.json(path$4(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2720,10 +2770,9 @@ var Templates = class {
 	}
 };
 
-//#endregion
-//#region src/resources/productions.ts
-const path$2 = (id) => `/v1/studio/productions/${encodeURIComponent(id)}`;
-function abortableSleep$4(ms, signal) {
+// src/resources/productions.ts
+const path$3 = (id) => `/v1/studio/productions/${encodeURIComponent(id)}`;
+function abortableSleep$5(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -2756,7 +2805,7 @@ var Productions = class {
 	}
 	/** `GET /v1/studio/productions/{id}` — advances the production and returns it (another account's id is a 404). */
 	retrieve(id, opts = {}) {
-		return this.http.json(path$2(id), {
+		return this.http.json(path$3(id), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2772,7 +2821,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$4(interval, opts.signal);
+			await abortableSleep$5(interval, opts.signal);
 		}
 	}
 	/** `create` + `wait`. */
@@ -2782,8 +2831,110 @@ var Productions = class {
 	}
 };
 
-//#endregion
-//#region src/resources/media-ops.ts
+// src/resources/music-room.ts
+const BASE$2 = "/v1/studio/music-room";
+const path$2 = (id) => `${BASE$2}/${encodeURIComponent(id)}`;
+function abortableSleep$4(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 });
+	});
+}
+/** The song reached a terminal state (`succeeded` or `failed`). */
+const isMusicRoomFinished = (r) => r.status === "succeeded" || r.status === "failed";
+var MusicRoom = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/** `POST /v1/studio/music-room` — start a song (202; the producer plans it, then it waits at the plan gate). */
+	create(body, opts = {}) {
+		return this.http.json(BASE$2, {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `GET /v1/studio/music-room/{id}` — advances the workflow and returns the song (another account's id is a 404). */
+	get(id, opts = {}) {
+		return this.http.json(path$2(id), {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `GET /v1/studio/music-room` — your songs, newest first; page with `before` while `has_more`. */
+	list(query = {}, opts = {}) {
+		return this.http.json(BASE$2, {
+			query: {
+				limit: query.limit,
+				before: query.before
+			},
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* `POST /v1/studio/music-room/{id}/choose` — answer the open gate: `{ gate: 'plan', variant }`,
+	* `{ gate: 'demo', approve: true }` or `{ gate: 'final', approve: true }` (409 `not_at_gate` otherwise).
+	*/
+	choose(id, answer, opts = {}) {
+		return this.http.json(`${path$2(id)}/choose`, {
+			method: "POST",
+			body: answer,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* `POST /v1/studio/music-room/{id}/direct` — one player re-plays its part following `direction` and the demo is
+	* re-rendered (202; only at the demo or final gate).
+	*/
+	direct(id, body, opts = {}) {
+		return this.http.json(`${path$2(id)}/direct`, {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `GET /v1/studio/music-room/quota` — `{ plan, included, used, remaining, period_end }` for this calendar month. */
+	quota(opts = {}) {
+		return this.http.json(`${BASE$2}/quota`, {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* Poll `get` every `intervalMs` (default 10 s) until the song `succeeded` or `failed` (a failed one resolves too —
+	* check `status` / `error`), or with `untilGate: true` until it waits at a gate. Throws after `timeoutMs`
+	* (default 30 min) or when `signal` aborts.
+	*/
+	async wait(id, opts = {}) {
+		const interval = opts.intervalMs ?? 1e4;
+		const deadline = Date.now() + (opts.timeoutMs ?? 18e5);
+		for (;;) {
+			const r = await this.get(id, opts);
+			if (isMusicRoomFinished(r) || opts.untilGate && r.status === "waiting") return r;
+			if (Date.now() + interval > deadline) throw new Error(`codai: music room ${id} did not finish in time (phase ${r.phase})`);
+			await abortableSleep$4(interval, opts.signal);
+		}
+	}
+};
+
+// src/resources/media-ops.ts
 const BASE$1 = "/v1/studio/media-ops";
 const opPath = (op) => `${BASE$1}/${encodeURIComponent(op)}`;
 function abortableSleep$3(ms, signal) {
@@ -2802,7 +2953,8 @@ function abortableSleep$3(ms, signal) {
 }
 const toBody = (input) => ({
 	asset_ids: input.assetIds ?? [],
-	params: input.params ?? {}
+	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";
@@ -2870,8 +3022,7 @@ var MediaOps = class {
 	}
 };
 
-//#endregion
-//#region src/resources/lyrics.ts
+// src/resources/lyrics.ts
 const BASE = "/v1/studio/lyrics";
 var LyricsResource = class {
 	http;
@@ -2906,8 +3057,7 @@ var LyricsResource = class {
 	}
 };
 
-//#endregion
-//#region src/resources/jam.ts
+// src/resources/jam.ts
 const JAM_SUBPROTOCOL = "codai-jam";
 /** WebSocket close codes of `/v1/studio/jam`. */
 const JAM_CLOSE_CODES = {
@@ -3068,8 +3218,7 @@ var Jam = class {
 	}
 };
 
-//#endregion
-//#region src/resources/batches.ts
+// src/resources/batches.ts
 const BATCH_DONE = [
 	"completed",
 	"failed",
@@ -3203,8 +3352,7 @@ var Batches = class {
 	}
 };
 
-//#endregion
-//#region src/resources/shares.ts
+// src/resources/shares.ts
 const SHARE_TOKEN_RE = /^[A-Za-z0-9_-]{43}$/;
 /**
 * The share token in `input`: a raw token, or any `https://…/s/<token>` / `…/r/<token>` URL (query and fragment
@@ -3319,8 +3467,7 @@ var Shares = class {
 	}
 };
 
-//#endregion
-//#region src/resources/voice-revocations.ts
+// src/resources/voice-revocations.ts
 var VoiceRevocations = class {
 	http;
 	constructor(http) {
@@ -3338,8 +3485,40 @@ var VoiceRevocations = class {
 	}
 };
 
-//#endregion
-//#region src/resources/vault.ts
+// src/resources/voices.ts
+const singing = (id) => `/v1/studio/voices/${encodeURIComponent(id)}/singing-consent`;
+var Voices = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/**
+	* `POST /v1/studio/voices/{id}/singing-consent` — add the singing purpose from a finished singing recording session
+	* (liveness-checked statement + sung sample). Returns the voice with `singing.status: 'active'`. Never retried.
+	*/
+	addSingingConsent(id, body, opts = {}) {
+		return this.http.json(singing(id), {
+			method: "POST",
+			body,
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/**
+	* `DELETE /v1/studio/voices/{id}/singing-consent` — revoke ONLY the singing purpose (204). The sung sample is deleted
+	* at once; the voice keeps working for narration. Idempotent.
+	*/
+	async revokeSingingConsent(id, opts = {}) {
+		await this.http.request(singing(id), {
+			method: "DELETE",
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+};
+
+// src/resources/vault.ts
 /** The UTF-8 message an unlock proof covers: `codai-vault/unlock/v1|<challenge>|<device_id or "passkey">`. */
 function vaultUnlockMessage(challenge, deviceIdOrPasskey) {
 	return `codai-vault/unlock/v1|${challenge}|${deviceIdOrPasskey}`;
@@ -3570,8 +3749,7 @@ var Vault = class {
 	}
 };
 
-//#endregion
-//#region src/resources/abuse-reports.ts
+// src/resources/abuse-reports.ts
 var AbuseReports = class {
 	http;
 	constructor(http) {
@@ -3589,8 +3767,7 @@ var AbuseReports = class {
 	}
 };
 
-//#endregion
-//#region src/resources/provenance.ts
+// src/resources/provenance.ts
 /** Largest file the checker accepts (25 MB). */
 const PROVENANCE_MAX_BYTES = 26214400;
 var Provenance = class {
@@ -3615,8 +3792,7 @@ var Provenance = class {
 	}
 };
 
-//#endregion
-//#region src/resources/messages.ts
+// src/resources/messages.ts
 /** `POST /v1/messages` — Anthropic Messages wire (JSON + named-event SSE). */
 var Messages = class {
 	http;
@@ -3719,8 +3895,7 @@ var Messages = class {
 	}
 };
 
-//#endregion
-//#region src/resources/models.ts
+// src/resources/models.ts
 var Models = class {
 	http;
 	constructor(http) {
@@ -3735,8 +3910,7 @@ var Models = class {
 	}
 };
 
-//#endregion
-//#region src/resources/orgs.ts
+// src/resources/orgs.ts
 var OrgMembers = class {
 	http;
 	constructor(http) {
@@ -3790,8 +3964,7 @@ var Orgs = class {
 	}
 };
 
-//#endregion
-//#region src/resources/projects.ts
+// src/resources/projects.ts
 var Projects = class {
 	http;
 	constructor(http) {
@@ -3838,8 +4011,7 @@ var Projects = class {
 	}
 };
 
-//#endregion
-//#region src/resources/realtime.ts
+// src/resources/realtime.ts
 const OPEN = 1;
 function toBytes(audio) {
 	if (audio instanceof ArrayBuffer) return new Uint8Array(audio);
@@ -4022,8 +4194,7 @@ var Realtime = class {
 	}
 };
 
-//#endregion
-//#region src/resources/referrals.ts
+// src/resources/referrals.ts
 var Referrals = class {
 	http;
 	constructor(http) {
@@ -4058,8 +4229,7 @@ var Referrals = class {
 	}
 };
 
-//#endregion
-//#region src/resources/resolve.ts
+// src/resources/resolve.ts
 /**
 * Verify a Resolve webhook delivery: `x-codai-signature: t=<unix>,v1=<hex>`
 * with `v1 = HMAC-SHA256(callback_secret, "<t>.<rawBody>")`. Pass the RAW
@@ -4444,8 +4614,7 @@ function abortableSleep$1(ms, signal) {
 	});
 }
 
-//#endregion
-//#region src/resources/responses.ts
+// src/resources/responses.ts
 /** `POST /v1/responses` — OpenAI Responses API compatibility (JSON + named-event SSE). */
 var Responses = class {
 	http;
@@ -4528,8 +4697,7 @@ var Responses = class {
 	}
 };
 
-//#endregion
-//#region src/resources/sessions.ts
+// src/resources/sessions.ts
 /**
 * `/v1/sessions/*` — shared-sessions protocol v2 (events, controls, lease,
 * dispatch, SSE stream) plus the per-session shares under `/shares`.
@@ -4765,8 +4933,7 @@ var Sessions = class {
 	}
 };
 
-//#endregion
-//#region src/resources/settings.ts
+// src/resources/settings.ts
 /**
 * `/v1/settings` — account-level settings shared by every device of the account (per user, not per key). Reads
 * always return the full object with defaults applied; writes deep-merge a partial and are validated strictly.
@@ -4809,8 +4976,7 @@ var Settings = class {
 	}
 };
 
-//#endregion
-//#region src/resources/os-gate.ts
+// src/resources/os-gate.ts
 var OsGate = class {
 	http;
 	constructor(http) {
@@ -4837,8 +5003,7 @@ var OsGate = class {
 	}
 };
 
-//#endregion
-//#region src/resources/sfx.ts
+// src/resources/sfx.ts
 var Sfx = class {
 	http;
 	constructor(http) {
@@ -4876,8 +5041,7 @@ var Sfx = class {
 	}
 };
 
-//#endregion
-//#region src/resources/system-one.ts
+// src/resources/system-one.ts
 var SystemOne = class {
 	http;
 	constructor(http) {
@@ -4896,8 +5060,7 @@ var SystemOne = class {
 	}
 };
 
-//#endregion
-//#region src/resources/tasks.ts
+// src/resources/tasks.ts
 var Tasks = class {
 	http;
 	constructor(http) {
@@ -4947,8 +5110,7 @@ var Tasks = class {
 	}
 };
 
-//#endregion
-//#region src/resources/triggers.ts
+// src/resources/triggers.ts
 var Triggers = class {
 	http;
 	constructor(http) {
@@ -5098,8 +5260,7 @@ var Notifications = class {
 	}
 };
 
-//#endregion
-//#region src/resources/prompts.ts
+// src/resources/prompts.ts
 /** `/v1/prompts/*` — pending prompts: ready-to-paste prompts left for a future chat (handoffs, follow-ups). */
 const one$3 = (id, suffix = "") => `/v1/prompts/${encodeURIComponent(id)}${suffix}`;
 function filterQuery(q) {
@@ -5256,8 +5417,7 @@ var Prompts = class {
 	}
 };
 
-//#endregion
-//#region src/resources/schedules.ts
+// src/resources/schedules.ts
 /** `/v1/schedules/*`, `/v1/schedule-runs/*`, `/v1/scheduler/*` — the codai Scheduler (ADR 0006). */
 const one$2 = (id, suffix = "") => `/v1/schedules/${encodeURIComponent(id)}${suffix}`;
 const run = (id, suffix) => `/v1/schedule-runs/${encodeURIComponent(id)}${suffix}`;
@@ -5528,8 +5688,7 @@ var Schedules = class {
 	}
 };
 
-//#endregion
-//#region src/resources/lists.ts
+// src/resources/lists.ts
 /** `/v1/lists/*`, `/v1/share` — lists and the share-sheet entry point. */
 const one$1 = (id, suffix = "") => `/v1/lists/${encodeURIComponent(id)}${suffix}`;
 const item = (id, suffix = "") => `/v1/lists/items/${encodeURIComponent(id)}${suffix}`;
@@ -5661,8 +5820,7 @@ var Lists = class {
 	}
 };
 
-//#endregion
-//#region src/resources/memory.ts
+// src/resources/memory.ts
 var Memory = class {
 	http;
 	constructor(http) {
@@ -5722,8 +5880,7 @@ var Memory = class {
 	}
 };
 
-//#endregion
-//#region src/resources/sandboxes.ts
+// src/resources/sandboxes.ts
 /**
 * `/v1/sandboxes` — agent sandboxes: isolated gVisor containers with a persistent `/workspace`, no network
 * by default, artifacts from `/workspace/out` as scanned, signed links. Backend `v2` (default) = long-lived
@@ -5966,8 +6123,7 @@ function execTimeoutMs(timeoutSeconds) {
 	return ((timeoutSeconds ?? 120) + 60) * 1e3;
 }
 
-//#endregion
-//#region src/resources/transcripts.ts
+// src/resources/transcripts.ts
 /**
 * `/v1/transcripts/*` + `/v1/transcript-folders` + `/v1/transcript-vocabulary` + tus `/v1/uploads` — voice
 * recordings → diarized RO/EN transcripts → insights (summary, key points, actions, suggested agent prompts).
@@ -6391,8 +6547,7 @@ var Transcripts = class {
 	}
 };
 
-//#endregion
-//#region src/resources/tokens.ts
+// src/resources/tokens.ts
 var Tokens = class {
 	http;
 	constructor(http) {
@@ -6420,8 +6575,7 @@ var Tokens = class {
 	}
 };
 
-//#endregion
-//#region src/resources/tools.ts
+// src/resources/tools.ts
 var Tools = class {
 	http;
 	constructor(http) {
@@ -6461,8 +6615,7 @@ var Tools = class {
 	}
 };
 
-//#endregion
-//#region src/resources/research.ts
+// src/resources/research.ts
 const path = (id) => `/v1/research/${encodeURIComponent(id)}`;
 function abortableSleep(ms, signal) {
 	return new Promise((resolve, reject) => {
@@ -6537,8 +6690,7 @@ var Research = class {
 	}
 };
 
-//#endregion
-//#region src/resources/usage-keys.ts
+// src/resources/usage-keys.ts
 var Usage = class {
 	http;
 	constructor(http) {
@@ -6587,8 +6739,7 @@ var Keys = class {
 	}
 };
 
-//#endregion
-//#region src/resources/verify.ts
+// src/resources/verify.ts
 var Verify = class {
 	http;
 	constructor(http) {
@@ -6609,8 +6760,7 @@ var Verify = class {
 	}
 };
 
-//#endregion
-//#region src/operations.ts
+// src/operations.ts
 /**
 * Single source of truth for OpenAPI parity: every `operationId` in
 * `apps/docs/openapi/en/gateway.yaml` maps to exactly one dotted method path
@@ -6711,6 +6861,8 @@ const OPERATION_METHODS = {
 	reopenPublicReviewThread: "shares.reopen",
 	decidePublicReview: "shares.decide",
 	createVoiceRevocation: "voiceRevocations.create",
+	addStudioVoiceSingingConsent: "voices.addSingingConsent",
+	revokeStudioVoiceSingingConsent: "voices.revokeSingingConsent",
 	getVaultAccount: "vault.account",
 	putVaultAccount: "vault.putAccount",
 	patchVaultSettings: "vault.updateSettings",
@@ -6757,6 +6909,12 @@ const OPERATION_METHODS = {
 	listCreativeTemplates: "templates.list",
 	createStudioProduction: "productions.create",
 	getStudioProduction: "productions.retrieve",
+	createStudioMusicRoom: "studio.musicRoom.create",
+	listStudioMusicRooms: "studio.musicRoom.list",
+	getStudioMusicRoomQuota: "studio.musicRoom.quota",
+	getStudioMusicRoom: "studio.musicRoom.get",
+	chooseStudioMusicRoom: "studio.musicRoom.choose",
+	directStudioMusicRoom: "studio.musicRoom.direct",
 	listStudioMediaOps: "mediaOps.list",
 	quoteStudioMediaOp: "mediaOps.quote",
 	runStudioMediaOp: "mediaOps.run",
@@ -6770,6 +6928,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",
@@ -7033,8 +7194,7 @@ const RESOLVE_OPERATION_METHODS = {
 	getResolveBalance: "resolve.balance"
 };
 
-//#endregion
-//#region src/resources/apps.ts
+// src/resources/apps.ts
 /**
 * `CodaiApps` — management client for host apps (studiai.ro, …) that resell
 * codai to their own end users. It talks to the mgmt API (`api.codai.ro`),
@@ -7200,8 +7360,7 @@ var CodaiApps = class {
 	}
 };
 
-//#endregion
-//#region src/index.ts
+// src/index.ts
 /**
 * codai-sdk — official TypeScript client for the codai AI gateway.
 *
@@ -7231,6 +7390,8 @@ 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.studio.musicRoom.create / .get / .list / .choose / .direct / .quota / .wait (codai Studio Music Room: a team
+*     of role agents writes, plays, sings and mixes a song with three approval gates; free within the plan quota)
 *   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)
@@ -7245,6 +7406,8 @@ var CodaiApps = class {
 *   client.shares.get / .remix / .comment / .reply / .resolve / .reopen / .decide (codai Studio share links from the
 *     outside: read a shared creative, remix a view link, comment and decide through a review link; free)
 *   client.voiceRevocations.create (public takedown ticket for a voice cloned in codai Studio; no key needed)
+*   client.voices.addSingingConsent / .revokeSingingConsent (voice passport, beta: your own custom voice singing in
+*     Music Room songs; a separate, revocable consent; free)
 *   client.vault.account / .items / .putItem / .rules / .approvals / .decide / .catalog / .use / .httpCall / .resolve
 *   client.vault.devices.challenge / .enroll / .list / .rename / .revoke (device approval keys, V-27)
 *   client.vault.updateSettings / .lock / .unlockChallenge / .unlock / .limits / .setLimits / .revokeTaskGrants (guards, v4)
@@ -7306,6 +7469,11 @@ var Codai = class {
 	templates;
 	/** codai Studio productions (`productions.run({ brief, language: 'ro' })` → a finished promo video + editable creative). */
 	productions;
+	/**
+	* codai Studio namespace. `studio.musicRoom.create({ brief, language: 'ro' })` → a team of role agents makes a song;
+	* answer its gates with `studio.musicRoom.choose(id, …)`, poll with `studio.musicRoom.wait(id, { untilGate: true })`.
+	*/
+	studio;
 	/** 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 })`). */
@@ -7320,6 +7488,8 @@ var Codai = class {
 	shares;
 	/** Public takedown tickets for voices cloned in codai Studio (`voiceRevocations.create({ email, … })`; no key needed). */
 	voiceRevocations;
+	/** codai Studio custom voices: the voice passport singing consent (`voices.addSingingConsent(id, { session_id })`). */
+	voices;
 	/** Zero-knowledge credentials vault (`vault.items()`, `vault.use({ handle, mode, action })`, `vault.decide(id, …)`). */
 	vault;
 	/** Public abuse reports about codai Studio share / review links (`abuseReports.create({ share_token, … })`; no key needed). */
@@ -7416,6 +7586,7 @@ var Codai = class {
 		this.brandKits = new BrandKits(http);
 		this.templates = new Templates(http);
 		this.productions = new Productions(http);
+		this.studio = { musicRoom: new MusicRoom(http) };
 		this.mediaOps = new MediaOps(http);
 		this.lyrics = new LyricsResource(http);
 		this.jam = new Jam({
@@ -7426,6 +7597,7 @@ var Codai = class {
 		this.batches = new Batches(http);
 		this.shares = new Shares(http);
 		this.voiceRevocations = new VoiceRevocations(http);
+		this.voices = new Voices(http);
 		this.vault = new Vault(http);
 		this.abuseReports = new AbuseReports(http);
 		this.provenance = new Provenance(http);
@@ -7555,6 +7727,5 @@ function allKeys(obj) {
 	return [...keys];
 }
 
-//#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, 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, isProductionFinished, isResearchFinished, jamUrl, 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, MusicRoom, 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, Voices, extensionHeaders, frameJson, isAssetDto, isMediaOpJob, isMediaOpJobFinished, isMusicRoomFinished, isPagedBuild, isProductionFinished, isResearchFinished, jamUrl, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map