codai-sdk 0.66.0 → 0.68.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,7 +1978,7 @@ 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);
 		}
 	}
 };
@@ -2159,6 +2159,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
@@ -2705,7 +2723,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 +2772,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 +2782,292 @@ 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 ?? {}
+});
+/** 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 = [
@@ -3036,6 +3340,10 @@ var VoiceRevocations = class {
 
 //#endregion
 //#region 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}`;
+}
 const seg = (base, id, suffix = "") => `${base}/${encodeURIComponent(id)}${suffix}`;
 /** `/v1/vault/devices/*` — hardware-backed device approval keys (public keys only; revocation is instant). */
 var VaultDevices = class {
@@ -3124,6 +3432,53 @@ var Vault = class {
 	setDefaultTier(defaultTier, opts = {}) {
 		return this.send("PATCH", "/v1/vault/settings", opts, { default_tier: defaultTier });
 	}
+	/**
+	* `PATCH /v1/vault/settings` — `default_tier` and/or partial anomaly `guards` (merged over the current ones).
+	* Answers the effective `{ default_tier, guards }`.
+	*/
+	updateSettings(body, opts = {}) {
+		if (body.default_tier === void 0 && body.guards === void 0) return Promise.reject(/* @__PURE__ */ new TypeError("updateSettings needs default_tier and/or guards"));
+		return this.send("PATCH", "/v1/vault/settings", opts, { ...body });
+	}
+	/**
+	* `POST /v1/vault/lock` — panic: revoke every live grant, deny every pending approval, lock the vault (agent uses
+	* then answer `vault_locked`). Device keys stay enrolled. Idempotent.
+	*/
+	lock(params = {}, opts = {}) {
+		return this.send("POST", "/v1/vault/lock", opts, { via: params.via });
+	}
+	/** `POST /v1/vault/unlock/challenge` — single-use unlock challenge, valid 5 minutes. */
+	unlockChallenge(opts = {}) {
+		return this.send("POST", "/v1/vault/unlock/challenge", opts, {});
+	}
+	/**
+	* `POST /v1/vault/unlock` — end a lock with a device-key proof over {@link vaultUnlockMessage} or a passkey whose
+	* challenge is base64url(SHA-256(that message with `passkey`)). 403 `challenge_invalid`, `wear_t3_only`, …
+	*/
+	unlock(body, opts = {}) {
+		return this.send("POST", "/v1/vault/unlock", opts, { ...body });
+	}
+	/** `GET /v1/vault/limits` — per-handle usage caps on your items. */
+	async limits(opts = {}) {
+		return [...(await this.get("/v1/vault/limits", opts)).limits];
+	}
+	/**
+	* `PUT /v1/vault/items/{id}/limits` — all three keys required; `null` removes a cap, all `null` removes the limits
+	* (answers `null`). Over a cap the broker calls answer 429 `vault_rate_limited` with `Retry-After`.
+	*/
+	async setLimits(id, limits, opts = {}) {
+		return (await this.http.json(seg("/v1/vault/items", id, "/limits"), {
+			method: "PUT",
+			body: {
+				per_minute: limits.per_minute,
+				per_day: limits.per_day,
+				units_per_day: limits.units_per_day
+			},
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		})).limits ?? null;
+	}
 	/** `GET /v1/vault/vaults` — vaults you belong to, with your role and sealed vault key. */
 	vaults(opts = {}) {
 		return this.get("/v1/vault/vaults", opts);
@@ -3174,6 +3529,10 @@ var Vault = class {
 	revokeGrant(id, opts = {}) {
 		return this.send("DELETE", seg("/v1/vault/grants", id), opts);
 	}
+	/** `POST /v1/vault/grants/revoke-task` — revoke every live grant of a task / session; answers `{ revoked }`. */
+	revokeTaskGrants(task, opts = {}) {
+		return this.send("POST", "/v1/vault/grants/revoke-task", opts, { task });
+	}
 	/** `GET /v1/vault/events` — append-only audit log (never contains secret values). */
 	events(params = {}, opts = {}) {
 		return this.get("/v1/vault/events", opts, { limit: params.limit });
@@ -6354,7 +6713,13 @@ const OPERATION_METHODS = {
 	createVoiceRevocation: "voiceRevocations.create",
 	getVaultAccount: "vault.account",
 	putVaultAccount: "vault.putAccount",
-	patchVaultSettings: "vault.setDefaultTier",
+	patchVaultSettings: "vault.updateSettings",
+	lockVault: "vault.lock",
+	createVaultUnlockChallenge: "vault.unlockChallenge",
+	unlockVault: "vault.unlock",
+	listVaultLimits: "vault.limits",
+	setVaultItemLimits: "vault.setLimits",
+	revokeVaultTaskGrants: "vault.revokeTaskGrants",
 	listVaults: "vault.vaults",
 	createVault: "vault.createVault",
 	listVaultItems: "vault.items",
@@ -6392,6 +6757,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",
@@ -6860,6 +7231,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
@@ -6869,6 +7247,7 @@ var CodaiApps = class {
 *   client.voiceRevocations.create (public takedown ticket for a voice cloned in codai Studio; no key needed)
 *   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)
 *     (zero-knowledge credentials vault: ciphertext only; the broker calls never return secret values)
 *   client.abuseReports.create (public DSA notice about a codai Studio share / review link; no key needed)
 *   client.provenance.check (public: which codai AI-provenance marks a file carries; no key needed)
@@ -6927,6 +7306,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)`). */
@@ -7031,6 +7416,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);
@@ -7165,5 +7556,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, 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, isProductionFinished, isResearchFinished, jamUrl, mergeToolCall, readSse, realtimeUrl, resolveAttestationStatement, settingsConflictCurrent, shareTokenFrom, uploadIdFromLocation, vaultUnlockMessage, verifyAttestationWithKeys, verifyResolveWebhook };
 //# sourceMappingURL=index.js.map