codai-sdk 0.54.1 → 0.62.0

package/dist/index.js

@@ -80,7 +80,8 @@ const EXTENSION_HEADERS = {
 	deviceName: "x-codai-device-name",
 	devicePlatform: "x-codai-device-platform",
 	pushToken: "x-codai-push-token",
-	shareToken: "x-codai-share-token"
+	shareToken: "x-codai-share-token",
+	idempotencyKey: "Idempotency-Key"
 };
 /** Translate an extensions bag into raw `X-Codai-*` headers. Exported for tests. */
 function extensionHeaders(ext) {
@@ -586,6 +587,20 @@ var Billing = class {
 		})).invoices];
 	}
 	/**
+	* `GET /v1/studio/quote` — what a Studio action costs (USD and wallet EUR micros) and your spendable balance,
+	* before you run it. Paid Studio calls answer 402 `insufficient_funds` when `sufficient` is false. Free.
+	*/
+	studioQuote(query, opts = {}) {
+		return this.http.json("/v1/studio/quote", {
+			query: {
+				...query,
+				audio: query.audio === void 0 ? void 0 : String(query.audio)
+			},
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
 	* Poll `get()` every `intervalMs` and call `onLow` once each time the wallet
 	* balance crosses below `thresholdEur`. Read-only: never creates a checkout.
 	* Returns a function that stops the watcher.
@@ -1568,7 +1583,7 @@ function decodeBase64(b64) {
 	for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
 	return out;
 }
-function abortableSleep$4(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(() => {
@@ -1683,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$4(pollIntervalMs, signal);
+			await abortableSleep$6(pollIntervalMs, signal);
 		}
 	}
 };
@@ -1782,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$4(pollIntervalMs, signal);
+			await abortableSleep$6(pollIntervalMs, signal);
 		}
 	}
 };
 
 //#endregion
 //#region src/resources/documents.ts
-function abortableSleep$3(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(() => {
@@ -1882,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$3(pollIntervalMs, signal);
+			await abortableSleep$5(pollIntervalMs, signal);
 		}
 	}
 	/** Queue a deck video and poll `renders.retrieve` until it succeeds. Throws on `failed` or timeout. */
@@ -1914,15 +1929,15 @@ 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$3(pollIntervalMs, signal);
+			await abortableSleep$5(pollIntervalMs, signal);
 		}
 	}
 };
 
 //#endregion
 //#region src/resources/exports.ts
-const path$4 = (id) => `/v1/studio/exports/${encodeURIComponent(id)}`;
-function abortableSleep$2(ms, signal) {
+const path$6 = (id) => `/v1/studio/exports/${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(() => {
@@ -1943,7 +1958,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$4(id), {
+		return this.http.json(path$6(id), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -1963,14 +1978,14 @@ 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$2(intervalMs, signal);
+			await abortableSleep$4(intervalMs, signal);
 		}
 	}
 };
 
 //#endregion
 //#region src/resources/creatives.ts
-const path$3 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
+const path$5 = (id, tail = "") => `/v1/studio/creatives/${encodeURIComponent(id)}${tail}`;
 const lottieQuery = (q) => ({
 	format: q.format,
 	formats: q.formats,
@@ -2010,7 +2025,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$3(id), {
+		return this.http.json(path$5(id), {
 			query: { seq: query.seq },
 			ext: opts.ext,
 			signal: opts.signal
@@ -2018,14 +2033,14 @@ var Creatives = class {
 	}
 	/** Compact text outline (+ formats and vars) — the cheapest structure for a prompt. */
 	outline(id, opts = {}) {
-		return this.http.json(path$3(id, "/outline"), {
+		return this.http.json(path$5(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$3(id, "/find"), {
+		return this.http.json(path$5(id, "/find"), {
 			method: "POST",
 			body: { query },
 			ext: opts.ext,
@@ -2034,7 +2049,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$3(id, "/subtree"), {
+		return this.http.json(path$5(id, "/subtree"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2047,7 +2062,7 @@ var Creatives = class {
 	* ops throw 400 with `code` (`invalid`, `not_found`, `locked`, `duplicate_id`).
 	*/
 	edit(id, body, opts = {}) {
-		return this.http.json(path$3(id, "/ops"), {
+		return this.http.json(path$5(id, "/ops"), {
 			method: "POST",
 			body: {
 				base_seq: body.baseSeq,
@@ -2063,7 +2078,7 @@ var Creatives = class {
 	}
 	/** Version history, newest first (`beforeSeq` pages). */
 	versions(id, query = {}, opts = {}) {
-		return this.http.json(path$3(id, "/versions"), {
+		return this.http.json(path$5(id, "/versions"), {
 			query: {
 				before_seq: query.beforeSeq,
 				limit: query.limit
@@ -2074,7 +2089,7 @@ var Creatives = class {
 	}
 	/** New head whose document is version `seq`'s (undo / redo). */
 	revert(id, seq, opts = {}) {
-		return this.http.json(path$3(id, "/revert"), {
+		return this.http.json(path$5(id, "/revert"), {
 			method: "POST",
 			body: { seq },
 			ext: opts.ext,
@@ -2084,7 +2099,7 @@ var Creatives = class {
 	}
 	/** New creative from version `seq` (default the head). */
 	fork(id, body = {}, opts = {}) {
-		return this.http.json(path$3(id, "/fork"), {
+		return this.http.json(path$5(id, "/fork"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2094,7 +2109,7 @@ var Creatives = class {
 	}
 	/** Soft-delete the creative. */
 	delete(id, opts = {}) {
-		return this.http.json(path$3(id), {
+		return this.http.json(path$5(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2107,7 +2122,7 @@ var Creatives = class {
 	* `text_overflow_locale`); 404 `Locale not found.` for an unknown locale.
 	*/
 	lint(id, body = {}, opts = {}) {
-		return this.http.json(path$3(id, "/lint"), {
+		return this.http.json(path$5(id, "/lint"), {
 			method: "POST",
 			...body.locale !== void 0 ? { body: { locale: body.locale } } : {},
 			ext: opts.ext,
@@ -2116,7 +2131,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$3(id, "/compiled"), {
+		return this.http.json(path$5(id, "/compiled"), {
 			query: {
 				format: query.format,
 				scene: query.scene,
@@ -2135,7 +2150,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$3(id, "/render"), {
+		return this.http.json(path$5(id, "/render"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2150,7 +2165,7 @@ var Creatives = class {
 	* jobs per UTC day are free, then billed (`billed_micro_usd`).
 	*/
 	frame(id, body, opts = {}) {
-		return this.http.json(path$3(id, "/frame"), {
+		return this.http.json(path$5(id, "/frame"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2165,7 +2180,7 @@ var Creatives = class {
 	* Token-metered like any `codai` text call.
 	*/
 	comment(id, body, opts = {}) {
-		return this.http.json(path$3(id, "/comments"), {
+		return this.http.json(path$5(id, "/comments"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2180,7 +2195,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$3(id, "/variants"), {
+		return this.http.json(path$5(id, "/variants"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2190,7 +2205,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$3(id, "/variants"), {
+		return this.http.json(path$5(id, "/variants"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2200,7 +2215,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$3(id, `/variants/${encodeURIComponent(variantId)}/pick`), {
+		return this.http.json(path$5(id, `/variants/${encodeURIComponent(variantId)}/pick`), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2214,7 +2229,7 @@ var Creatives = class {
 	* 400 `node_not_found` / `invalid_pick` / `duplicate_key`. Free.
 	*/
 	saveTemplate(id, body, opts = {}) {
-		return this.http.json(path$3(id, "/template"), {
+		return this.http.json(path$5(id, "/template"), {
 			method: "POST",
 			body,
 			ext: opts.ext,
@@ -2229,7 +2244,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$3(id, "/export.fcpxml"), {
+		return this.http.json(path$5(id, "/export.fcpxml"), {
 			query: {
 				format: query.format,
 				seq: query.seq
@@ -2247,7 +2262,7 @@ var Creatives = class {
 	* 400 `unsupported_kind` / `invalid_request`, 413 `too_large` (over 20 MB).
 	*/
 	exportLottie(id, query = {}, opts = {}) {
-		return this.http.json(path$3(id, "/export.lottie"), {
+		return this.http.json(path$5(id, "/export.lottie"), {
 			query: lottieQuery(query),
 			ext: opts.ext,
 			signal: opts.signal,
@@ -2259,7 +2274,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$3(id, "/export.lottie"), {
+		const res = await this.http.request(path$5(id, "/export.lottie"), {
 			query: {
 				...lottieQuery(query),
 				download: "1"
@@ -2295,7 +2310,7 @@ var Creatives = class {
 	* `documents.waitForPreview`). 400 `not_supported_for_kind` (video / image) or `invalid_spec`.
 	*/
 	build(id, body = {}, opts = {}) {
-		return this.http.json(path$3(id, "/build"), {
+		return this.http.json(path$5(id, "/build"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2310,7 +2325,7 @@ var Creatives = class {
 	* 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$3(id, "/restyle"), {
+		return this.http.json(path$5(id, "/restyle"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2326,7 +2341,7 @@ var Creatives = class {
 	* `unsupported_kind`); 403 `residency_unavailable`, 503 `transcription_unavailable`.
 	*/
 	captions(id, body = {}, opts = {}) {
-		return this.http.json(path$3(id, "/captions"), {
+		return this.http.json(path$5(id, "/captions"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2336,7 +2351,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$3(id, "/captions.srt"), {
+		return (await this.http.request(path$5(id, "/captions.srt"), {
 			query: {
 				node_id: query.node_id,
 				seq: query.seq,
@@ -2348,7 +2363,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$3(id, "/captions.vtt"), {
+		return (await this.http.request(path$5(id, "/captions.vtt"), {
 			query: {
 				node_id: query.node_id,
 				seq: query.seq,
@@ -2364,7 +2379,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$3(id, "/adapt"), {
+		return this.http.json(path$5(id, "/adapt"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2378,7 +2393,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$3(id, "/lint/fix"), {
+		return this.http.json(path$5(id, "/lint/fix"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2391,7 +2406,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$3(id, "/controls"), {
+		return this.http.json(path$5(id, "/controls"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2401,7 +2416,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$3(id, "/locales"), {
+		return this.http.json(path$5(id, "/locales"), {
 			query: {
 				locale: query.locale,
 				units: query.units,
@@ -2419,7 +2434,7 @@ var Creatives = class {
 	* 400 `nothing_to_translate`; 503 `localize_unavailable` when every locale failed.
 	*/
 	localize(id, body, opts = {}) {
-		return this.http.json(path$3(id, "/localize"), {
+		return this.http.json(path$5(id, "/localize"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2432,7 +2447,7 @@ var Creatives = class {
 	* title `<title> (<locale>)`). 404 `Locale not found.`. Free (HTTP 201).
 	*/
 	forkLocale(id, locale, body = {}, opts = {}) {
-		return this.http.json(path$3(id, `/locales/${encodeURIComponent(locale)}/fork`), {
+		return this.http.json(path$5(id, `/locales/${encodeURIComponent(locale)}/fork`), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2446,7 +2461,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$3(id, "/shares"), {
+		return this.http.json(path$5(id, "/shares"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2456,14 +2471,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$3(id, "/shares"), {
+		return this.http.json(path$5(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$3(id, `/shares/${encodeURIComponent(shareId)}`), {
+		await this.http.request(path$5(id, `/shares/${encodeURIComponent(shareId)}`), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2474,14 +2489,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$3(id, "/review"), {
+		return this.http.json(path$5(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$3(id, "/review"), {
+		return this.http.json(path$5(id, "/review"), {
 			method: "POST",
 			body: { action: "request" },
 			ext: opts.ext,
@@ -2490,7 +2505,7 @@ var Creatives = class {
 	}
 	/** Back to `draft` (decision cleared, comments kept). Free. */
 	resetReview(id, opts = {}) {
-		return this.http.json(path$3(id, "/review"), {
+		return this.http.json(path$5(id, "/review"), {
 			method: "POST",
 			body: { action: "reset" },
 			ext: opts.ext,
@@ -2499,7 +2514,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$3(id, "/review/threads"), {
+		return this.http.json(path$5(id, "/review/threads"), {
 			query: { status: query.status },
 			ext: opts.ext,
 			signal: opts.signal
@@ -2510,7 +2525,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$3(id, "/review/threads"), {
+		return this.http.json(path$5(id, "/review/threads"), {
 			method: "POST",
 			body: stripUndefined(body),
 			ext: opts.ext,
@@ -2520,7 +2535,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$3(id, `/review/threads/${encodeURIComponent(threadId)}/replies`), {
+		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/replies`), {
 			method: "POST",
 			body: { body: body.body },
 			ext: opts.ext,
@@ -2530,7 +2545,7 @@ var Creatives = class {
 	}
 	/** Resolve a thread. Free. */
 	resolveReviewThread(id, threadId, opts = {}) {
-		return this.http.json(path$3(id, `/review/threads/${encodeURIComponent(threadId)}/resolve`), {
+		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/resolve`), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2538,7 +2553,7 @@ var Creatives = class {
 	}
 	/** Reopen a resolved thread. Free. */
 	reopenReviewThread(id, threadId, opts = {}) {
-		return this.http.json(path$3(id, `/review/threads/${encodeURIComponent(threadId)}/reopen`), {
+		return this.http.json(path$5(id, `/review/threads/${encodeURIComponent(threadId)}/reopen`), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2546,7 +2561,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$3(id, `/review/comments/${encodeURIComponent(commentId)}`), {
+		await this.http.request(path$5(id, `/review/comments/${encodeURIComponent(commentId)}`), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2554,7 +2569,7 @@ 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$3(id, `/frames/${encodeURIComponent(jobId)}`), {
+		return this.http.json(path$5(id, `/frames/${encodeURIComponent(jobId)}`), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2563,7 +2578,7 @@ var Creatives = class {
 
 //#endregion
 //#region src/resources/brand-kits.ts
-const path$2 = (id, tail = "") => `/v1/studio/brand-kits/${encodeURIComponent(id)}${tail}`;
+const path$4 = (id, tail = "") => `/v1/studio/brand-kits/${encodeURIComponent(id)}${tail}`;
 var BrandKits = class {
 	http;
 	constructor(http) {
@@ -2588,7 +2603,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$2(id), {
+		return this.http.json(path$4(id), {
 			method: "PATCH",
 			body,
 			ext: opts.ext,
@@ -2598,7 +2613,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$2(id, "/dtcg"), {
+		return this.http.json(path$4(id, "/dtcg"), {
 			ext: opts.ext,
 			signal: opts.signal
 		});
@@ -2628,14 +2643,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$2(id), {
+		return this.http.json(path$4(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$2(id), {
+		return this.http.json(path$4(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2645,18 +2660,26 @@ var BrandKits = class {
 
 //#endregion
 //#region src/resources/templates.ts
-const path$1 = (id) => `/v1/studio/templates/${encodeURIComponent(id)}`;
+const path$3 = (id) => `/v1/studio/templates/${encodeURIComponent(id)}`;
 var Templates = class {
 	http;
 	constructor(http) {
 		this.http = http;
 	}
-	/** Your templates, newest first (`kind` filter, `limit` 1–100, default 50); without `doc`. Free. */
+	/**
+	* Your templates (newest first; `limit` 1–100, default 50), then the built-in starters in `locale` (`en` | `ro`,
+	* default from Accept-Language) with in-season ones first (`month` 1–12). `source`: `own` | `starter` | `all`
+	* (default). `kind` filters both. Without `doc`. Free. A starter id works anywhere a template id does
+	* (`retrieve`, `creatives.create({ template })`, batches); starters cannot be deleted.
+	*/
 	list(query = {}, opts = {}) {
 		return this.http.json("/v1/studio/templates", {
 			query: {
 				kind: query.kind,
-				limit: query.limit
+				limit: query.limit,
+				source: query.source,
+				locale: query.locale,
+				month: query.month
 			},
 			ext: opts.ext,
 			signal: opts.signal
@@ -2664,14 +2687,14 @@ var Templates = class {
 	}
 	/** One template with its variables and `doc`. Free. */
 	retrieve(id, opts = {}) {
-		return this.http.json(path$1(id), {
+		return this.http.json(path$3(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$1(id), {
+		return this.http.json(path$3(id), {
 			method: "DELETE",
 			ext: opts.ext,
 			signal: opts.signal
@@ -2679,6 +2702,68 @@ var Templates = class {
 	}
 };
 
+//#endregion
+//#region src/resources/productions.ts
+const path$2 = (id) => `/v1/studio/productions/${encodeURIComponent(id)}`;
+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 isProductionFinished = (p) => p.status === "succeeded" || p.status === "failed";
+var Productions = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/** `POST /v1/studio/productions` — brief → storyboard → assets → creative → queued draft render (202). */
+	create(body, opts = {}) {
+		return this.http.json("/v1/studio/productions", {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `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), {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* Poll `retrieve` every `intervalMs` (default 5 s) until the production `succeeded` or `failed` (a failed one
+	* resolves too — check `status` / `error`). Throws after `timeoutMs` (default 10 min) or when `signal` aborts.
+	*/
+	async wait(id, opts = {}) {
+		const interval = opts.intervalMs ?? 5e3;
+		const deadline = Date.now() + (opts.timeoutMs ?? 6e5);
+		for (;;) {
+			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);
+		}
+	}
+	/** `create` + `wait`. */
+	async run(body, opts = {}) {
+		const p = await this.create(body, opts);
+		return isProductionFinished(p) ? p : this.wait(p.id, opts);
+	}
+};
+
 //#endregion
 //#region src/resources/batches.ts
 const BATCH_DONE = [
@@ -2686,8 +2771,8 @@ const BATCH_DONE = [
 	"failed",
 	"cancelled"
 ];
-const path = (id, tail = "") => `/v1/studio/batches/${encodeURIComponent(id)}${tail}`;
-function abortableSleep$1(ms, signal) {
+const path$1 = (id, tail = "") => `/v1/studio/batches/${encodeURIComponent(id)}${tail}`;
+function abortableSleep$2(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason ?? /* @__PURE__ */ new Error("Aborted"));
 		const t = setTimeout(() => {
@@ -2747,7 +2832,7 @@ var Batches = class {
 	}
 	/** The batch (`rows: 1` adds rows; `status`, `offset`, `limit` ≤ 100). Each poll advances it a little. Free. */
 	get(id, query = {}, opts = {}) {
-		return this.http.json(path(id), {
+		return this.http.json(path$1(id), {
 			query: {
 				rows: query.rows,
 				status: query.status,
@@ -2760,7 +2845,7 @@ var Batches = class {
 	}
 	/** Stop the batch; rows not started become `skipped`. 409 `not_cancellable` when already finished. Free. */
 	cancel(id, opts = {}) {
-		return this.http.json(path(id, "/cancel"), {
+		return this.http.json(path$1(id, "/cancel"), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal,
@@ -2769,7 +2854,7 @@ var Batches = class {
 	}
 	/** Queue the failed rows again (≤ 3 attempts each). 409 `nothing_to_retry`. Free. */
 	retry(id, opts = {}) {
-		return this.http.json(path(id, "/retry"), {
+		return this.http.json(path$1(id, "/retry"), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal,
@@ -2778,7 +2863,7 @@ var Batches = class {
 	}
 	/** The original CSV plus `creative_id`, `status`, `error`, `render_url` per row (formula-safe). Free. */
 	async exportCsv(id, opts = {}) {
-		return (await this.http.request(path(id, "/export.csv"), {
+		return (await this.http.request(path$1(id, "/export.csv"), {
 			ext: opts.ext,
 			signal: opts.signal
 		})).text();
@@ -2788,7 +2873,7 @@ var Batches = class {
 	* ready). Poll `get` until `zip.status` is `ready` (signed `zip.url`). 409 `no_renders`. Free.
 	*/
 	zip(id, opts = {}) {
-		return this.http.json(path(id, "/zip"), {
+		return this.http.json(path$1(id, "/zip"), {
 			method: "POST",
 			ext: opts.ext,
 			signal: opts.signal,
@@ -2809,7 +2894,7 @@ var Batches = class {
 			});
 			if (BATCH_DONE.includes(batch.status)) return batch;
 			if (Date.now() + intervalMs > deadline) throw new Error(`codai batch ${id} did not finish within ${timeoutMs} ms`);
-			await abortableSleep$1(intervalMs, signal);
+			await abortableSleep$2(intervalMs, signal);
 		}
 	}
 };
@@ -2949,6 +3034,183 @@ var VoiceRevocations = class {
 	}
 };
 
+//#endregion
+//#region src/resources/vault.ts
+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 {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/** `POST /v1/vault/devices/challenge` — single-use enrolment nonce, valid 5 minutes. */
+	challenge(opts = {}) {
+		return this.http.json("/v1/vault/devices/challenge", {
+			method: "POST",
+			body: {},
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/** `POST /v1/vault/devices` — enrol (or re-enrol) a device key; vault-signed, possession-proven, attested (201). */
+	async enroll(body, opts = {}) {
+		return (await this.http.json("/v1/vault/devices", {
+			method: "POST",
+			body: stripUndefined({ ...body }),
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		})).device;
+	}
+	/** `GET /v1/vault/devices` — your device keys, revoked ones included, newest first. */
+	async list(opts = {}) {
+		return [...(await this.http.json("/v1/vault/devices", {
+			ext: opts.ext,
+			signal: opts.signal
+		})).devices];
+	}
+	/** `PATCH /v1/vault/devices/{id}` — change the display name (1-80 characters). */
+	async rename(id, name, opts = {}) {
+		return (await this.http.json(seg("/v1/vault/devices", id), {
+			method: "PATCH",
+			body: { name },
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		})).device;
+	}
+	/** `DELETE /v1/vault/devices/{id}` — revoke at once; later proofs answer 403 `device_revoked`. */
+	revoke(id, opts = {}) {
+		return this.http.json(seg("/v1/vault/devices", id), {
+			method: "DELETE",
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+};
+var Vault = class {
+	http;
+	devices;
+	constructor(http) {
+		this.http = http;
+		this.devices = new VaultDevices(http);
+	}
+	get(path, opts, query) {
+		return this.http.json(path, {
+			query,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	send(method, path, opts, body) {
+		return this.http.json(path, {
+			method,
+			...body ? { body: stripUndefined(body) } : {},
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: method !== "DELETE"
+		});
+	}
+	/** `GET /v1/vault/account` — bundle, fingerprint, default tier, revision (404 `vault_not_setup` before setup). */
+	account(opts = {}) {
+		return this.get("/v1/vault/account", opts);
+	}
+	/** `PUT /v1/vault/account` — upload the client-built bundle; updates send the current `revision` (409 otherwise). */
+	putAccount(body, opts = {}) {
+		return this.send("PUT", "/v1/vault/account", opts, body);
+	}
+	/** `PATCH /v1/vault/settings` — default approval tier for items without a matching rule. */
+	setDefaultTier(defaultTier, opts = {}) {
+		return this.send("PATCH", "/v1/vault/settings", opts, { default_tier: defaultTier });
+	}
+	/** `GET /v1/vault/vaults` — vaults you belong to, with your role and sealed vault key. */
+	vaults(opts = {}) {
+		return this.get("/v1/vault/vaults", opts);
+	}
+	/** `POST /v1/vault/vaults` — register a vault created client-side (HTTP 201). */
+	createVault(body, opts = {}) {
+		return this.send("POST", "/v1/vault/vaults", opts, body);
+	}
+	/** `GET /v1/vault/items` — envelopes you can read; with `since` (ISO) only changes after it, tombstones included. */
+	items(params = {}, opts = {}) {
+		return this.get("/v1/vault/items", opts, { since: params.since });
+	}
+	/** `PUT /v1/vault/items/{id}` — store an envelope (new = revision 1, update = revision + 1, 409 otherwise). */
+	putItem(id, envelope, opts = {}) {
+		return this.send("PUT", seg("/v1/vault/items", id), opts, envelope);
+	}
+	/** `DELETE /v1/vault/items/{id}` — tombstone; revokes every grant on the item and drops its cloud copy. */
+	deleteItem(id, opts = {}) {
+		return this.send("DELETE", seg("/v1/vault/items", id), opts);
+	}
+	/** `PUT /v1/vault/items/{id}/cloud` — owner only: the decrypted item to seal with KMS for cloud agents, or null. */
+	setItemCloud(id, item, opts = {}) {
+		return this.http.json(seg("/v1/vault/items", id, "/cloud"), {
+			method: "PUT",
+			body: { item },
+			ext: opts.ext,
+			signal: opts.signal,
+			noRetry: true
+		});
+	}
+	/** `GET /v1/vault/rules` — policy rules (item, agent glob, mode → tier). */
+	rules(opts = {}) {
+		return this.get("/v1/vault/rules", opts);
+	}
+	/** `POST /v1/vault/rules` — add a rule (HTTP 201). Host binding and honeytokens cannot be overridden. */
+	createRule(body, opts = {}) {
+		return this.send("POST", "/v1/vault/rules", opts, body);
+	}
+	/** `DELETE /v1/vault/rules/{id}`. */
+	deleteRule(id, opts = {}) {
+		return this.send("DELETE", seg("/v1/vault/rules", id), opts);
+	}
+	/** `GET /v1/vault/grants` — standing grants created by your approvals. */
+	grants(opts = {}) {
+		return this.get("/v1/vault/grants", opts);
+	}
+	/** `DELETE /v1/vault/grants/{id}` — revoke a grant immediately. */
+	revokeGrant(id, opts = {}) {
+		return this.send("DELETE", seg("/v1/vault/grants", id), opts);
+	}
+	/** `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 });
+	}
+	/** `GET /v1/vault/approvals` — agent requests waiting for your decision. */
+	approvals(opts = {}) {
+		return this.get("/v1/vault/approvals", opts);
+	}
+	/** `GET /v1/vault/approvals/{id}` — pending, approved, denied or expired. */
+	approval(id, opts = {}) {
+		return this.get(seg("/v1/vault/approvals", id), opts);
+	}
+	/**
+	* `POST /v1/vault/approvals/{id}/decide` — send `signature` (v1 vault key) or `proof` (v2 device key / passkey),
+	* never both. Deny needs no proof; a t4 approve needs a device or passkey proof (Wear: t3 only).
+	*/
+	decide(id, body, opts = {}) {
+		return this.send("POST", seg("/v1/vault/approvals", id, "/decide"), opts, body);
+	}
+	/** `GET /v1/vault/catalog` — items exposed to agents (handle, title, kind, hosts, env name); no values. */
+	catalog(opts = {}) {
+		return this.get("/v1/vault/catalog", opts);
+	}
+	/** `POST /v1/vault/use` — a policy decision for one use; t3/t4 return a pending approval id. */
+	use(body, opts = {}) {
+		return this.send("POST", "/v1/vault/use", opts, body);
+	}
+	/** `POST /v1/vault/http` — brokered HTTPS call with `{{vault:<slug>}}` handles; 202 = approval required. */
+	httpCall(body, opts = {}) {
+		return this.send("POST", "/v1/vault/http", opts, body);
+	}
+	/** `POST /v1/vault/resolve` — codai local brokers only (cloud fallback of `codaid vault run`); 202 = approval. */
+	resolve(body, opts = {}) {
+		return this.send("POST", "/v1/vault/resolve", opts, body);
+	}
+};
+
 //#endregion
 //#region src/resources/abuse-reports.ts
 var AbuseReports = class {
@@ -3770,7 +4032,7 @@ var Resolve = class {
 			if (until.has(job.status)) return job;
 			const left = deadline - Date.now();
 			if (left <= 0) throw new ResolveError(`codai-resolve job ${id} still ${job.status} after ${timeoutMs} ms`, 0, job);
-			await abortableSleep(Math.min(intervalMs, left), opts.signal);
+			await abortableSleep$1(Math.min(intervalMs, left), opts.signal);
 		}
 	}
 	async call(path, init) {
@@ -3808,7 +4070,7 @@ function toResolveError(path, err) {
 	const text = detail === null ? "" : `: ${typeof detail === "string" ? detail : JSON.stringify(detail)}`;
 	return new ResolveError(`codai-resolve ${path} → ${err.status}${text}`, err.status, err.body, meta);
 }
-function abortableSleep(ms, signal) {
+function abortableSleep$1(ms, signal) {
 	return new Promise((resolve, reject) => {
 		if (signal?.aborted) return reject(signal.reason);
 		const onAbort = () => {
@@ -5066,7 +5328,11 @@ var Sandboxes = class {
 		this.http = http;
 		this.files = new SandboxFiles(http);
 	}
-	/** `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` 60–86400, default 3600; `egress` none by default). */
+	/**
+	* `POST /v1/sandboxes` — start a sandbox (`ttl_seconds` 60–86400, default 3600; `egress` none by default).
+	* `backend: 'v2'` (closed canary) starts a long-lived pod with memory snapshots and accepts `template`
+	* `codai-base` | `brivio-acte` | `desktop`; its reply may carry `restored`.
+	*/
 	create(input = {}, opts = {}) {
 		return this.http.json("/v1/sandboxes", {
 			method: "POST",
@@ -5143,6 +5409,77 @@ var Sandboxes = class {
 			signal: opts.signal
 		});
 	}
+	/**
+	* `POST /v1/sandboxes/{id}/run_code` (v2) — run Python in the persistent kernel; globals survive between
+	* calls, pause/resume and forks. The last expression comes back as `result`.
+	*/
+	runCode(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/run_code`, {
+			method: "POST",
+			body: {
+				code: input.code,
+				...input.timeoutSeconds !== void 0 ? { timeout_seconds: input.timeoutSeconds } : {}
+			},
+			timeoutMs: execTimeoutMs(input.timeoutSeconds),
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/kernel/reset` (v2) — restart the kernel; globals are lost, files kept. */
+	async resetKernel(id, opts = {}) {
+		await this.http.json(`${base(id)}/kernel/reset`, {
+			method: "POST",
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/pause` (v2) — memory snapshot, then stop the pod (status `paused`). */
+	pause(id, opts = {}) {
+		return this.http.json(`${base(id)}/pause`, {
+			method: "POST",
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/resume` (v2) — restore a paused sandbox; `restored: false` = cold start. */
+	resume(id, opts = {}) {
+		return this.http.json(`${base(id)}/resume`, {
+			method: "POST",
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/fork` (v2) — start 1–5 copies of a running sandbox from a memory snapshot. */
+	fork(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/fork`, {
+			method: "POST",
+			body: {
+				count: input.count,
+				...input.ttlSeconds !== void 0 ? { ttl_seconds: input.ttlSeconds } : {}
+			},
+			timeoutMs: LIFECYCLE_TIMEOUT_MS,
+			noRetry: true,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `POST /v1/sandboxes/{id}/preview` (v2) — signed HTTPS URL on `*.sbx.codai.ro` for a port (≤ 1 h). */
+	preview(id, input, opts = {}) {
+		return this.http.json(`${base(id)}/preview`, {
+			method: "POST",
+			body: {
+				port: input.port,
+				...input.ttlSeconds !== void 0 ? { ttl_seconds: input.ttlSeconds } : {}
+			},
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
 	/** `DELETE /v1/sandboxes/{id}` — destroy the sandbox and its workspace (204). */
 	async delete(id, opts = {}) {
 		await this.http.request(base(id), {
@@ -5167,6 +5504,8 @@ var Sandboxes = class {
 		});
 	}
 };
+/** Pause / resume / fork wait for a snapshot or a pod start (server caps: 180 s snapshot, 240 s start). */
+const LIFECYCLE_TIMEOUT_MS = 48e4;
 /** Client timeout for a blocking exec: the server limit plus a margin for restore and upload. */
 function execTimeoutMs(timeoutSeconds) {
 	return ((timeoutSeconds ?? 120) + 60) * 1e3;
@@ -5633,7 +5972,12 @@ var Tools = class {
 	constructor(http) {
 		this.http = http;
 	}
-	/** `POST /v1/tools/search` — verified web search (never falls back to an unverified provider). */
+	/**
+	* `POST /v1/tools/search` — verified web search (never falls back to an unverified provider). Filters:
+	* `include_domains` / `exclude_domains`, `freshness` or `published_after` / `published_before` (undated pages are
+	* dropped), `content_chars` for a verified excerpt per result. Each result carries `published_at` (null when
+	* unknown, never the crawl date) and `crawled_at`.
+	*/
 	search(body, opts = {}) {
 		return this.http.json("/v1/tools/search", {
 			body,
@@ -5641,7 +5985,7 @@ var Tools = class {
 			signal: opts.signal
 		});
 	}
-	/** `POST /v1/tools/fetch` — fetch + extract a public page (SSRF-guarded). */
+	/** `POST /v1/tools/fetch` — fetch + extract a public page (SSRF-guarded; `max_chars` default 8000, max 40 000). */
 	fetch(body, opts = {}) {
 		return this.http.json("/v1/tools/fetch", {
 			body,
@@ -5662,6 +6006,82 @@ var Tools = class {
 	}
 };
 
+//#endregion
+//#region src/resources/research.ts
+const path = (id) => `/v1/research/${encodeURIComponent(id)}`;
+function abortableSleep(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 isResearchFinished = (job) => job.status === "done" || job.status === "failed";
+var Research = class {
+	http;
+	constructor(http) {
+		this.http = http;
+	}
+	/**
+	* `POST /v1/research` — start a deep-research job. With `wait_s` (0..55) the call waits that long and returns the
+	* finished job; otherwise (or when it is still running) the job comes back `queued` / `running`.
+	*/
+	create(body, opts = {}) {
+		return this.http.json("/v1/research", {
+			method: "POST",
+			body,
+			headers: opts.idempotencyKey ? { "Idempotency-Key": opts.idempotencyKey } : void 0,
+			noRetry: !opts.idempotencyKey,
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/** `GET /v1/research/{id}` — one of your jobs (another account's id is a 404). Free. */
+	retrieve(id, opts = {}) {
+		return this.http.json(path(id), {
+			ext: opts.ext,
+			signal: opts.signal
+		});
+	}
+	/**
+	* Poll `retrieve` every `intervalMs` (default 3 s) until the job is `done` or `failed` and resolve with it (a
+	* `failed` job resolves too — check `status` / `error`). Throws when it is not finished within `timeoutMs`
+	* (default 6 min) or when `signal` aborts.
+	*/
+	async wait(id, opts = {}) {
+		const { intervalMs = 3e3, timeoutMs = 36e4, signal, ext } = opts;
+		const deadline = Date.now() + timeoutMs;
+		for (;;) {
+			const job = await this.retrieve(id, {
+				ext,
+				signal
+			});
+			if (isResearchFinished(job)) return job;
+			if (Date.now() + intervalMs > deadline) throw new Error(`codai research job ${id} did not finish within ${timeoutMs} ms`);
+			await abortableSleep(intervalMs, signal);
+		}
+	}
+	/** `create` then `wait` until the job finishes. */
+	async run(body, opts = {}) {
+		const { intervalMs, timeoutMs, ...createOpts } = opts;
+		const job = await this.create(body, createOpts);
+		if (isResearchFinished(job)) return job;
+		return this.wait(job.id, {
+			ext: opts.ext,
+			signal: opts.signal,
+			...intervalMs !== void 0 ? { intervalMs } : {},
+			...timeoutMs !== void 0 ? { timeoutMs } : {}
+		});
+	}
+};
+
 //#endregion
 //#region src/resources/usage-keys.ts
 var Usage = class {
@@ -5836,6 +6256,33 @@ const OPERATION_METHODS = {
 	reopenPublicReviewThread: "shares.reopen",
 	decidePublicReview: "shares.decide",
 	createVoiceRevocation: "voiceRevocations.create",
+	getVaultAccount: "vault.account",
+	putVaultAccount: "vault.putAccount",
+	patchVaultSettings: "vault.setDefaultTier",
+	listVaults: "vault.vaults",
+	createVault: "vault.createVault",
+	listVaultItems: "vault.items",
+	putVaultItem: "vault.putItem",
+	deleteVaultItem: "vault.deleteItem",
+	setVaultItemCloud: "vault.setItemCloud",
+	listVaultRules: "vault.rules",
+	createVaultRule: "vault.createRule",
+	deleteVaultRule: "vault.deleteRule",
+	listVaultGrants: "vault.grants",
+	revokeVaultGrant: "vault.revokeGrant",
+	listVaultEvents: "vault.events",
+	listVaultApprovals: "vault.approvals",
+	getVaultApproval: "vault.approval",
+	decideVaultApproval: "vault.decide",
+	createVaultDeviceChallenge: "vault.devices.challenge",
+	enrollVaultDevice: "vault.devices.enroll",
+	listVaultDevices: "vault.devices.list",
+	renameVaultDevice: "vault.devices.rename",
+	revokeVaultDevice: "vault.devices.revoke",
+	vaultCatalog: "vault.catalog",
+	vaultUse: "vault.use",
+	vaultHttp: "vault.httpCall",
+	vaultResolve: "vault.resolve",
 	createStudioAbuseReport: "abuseReports.create",
 	checkProvenance: "provenance.check",
 	createStudioBatch: "batches.create",
@@ -5847,6 +6294,8 @@ const OPERATION_METHODS = {
 	zipStudioBatch: "batches.zip",
 	saveCreativeTemplate: "creatives.saveTemplate",
 	listCreativeTemplates: "templates.list",
+	createStudioProduction: "productions.create",
+	getStudioProduction: "productions.retrieve",
 	getCreativeTemplate: "templates.retrieve",
 	deleteCreativeTemplate: "templates.delete",
 	exportCreativeFcpxml: "creatives.exportFcpxml",
@@ -5873,6 +6322,8 @@ const OPERATION_METHODS = {
 	toolsSearch: "tools.search",
 	toolsFetch: "tools.fetch",
 	toolsGround: "tools.ground",
+	createResearch: "research.create",
+	getResearch: "research.retrieve",
 	listTasks: "tasks.list",
 	listPendingTasks: "tasks.pending",
 	getTaskStats: "tasks.stats",
@@ -5991,6 +6442,12 @@ const OPERATION_METHODS = {
 	snapshotSandbox: "sandboxes.snapshot",
 	deleteSandbox: "sandboxes.delete",
 	runSandbox: "sandboxes.run",
+	runSandboxCode: "sandboxes.runCode",
+	resetSandboxKernel: "sandboxes.resetKernel",
+	pauseSandbox: "sandboxes.pause",
+	resumeSandbox: "sandboxes.resume",
+	forkSandbox: "sandboxes.fork",
+	previewSandbox: "sandboxes.preview",
 	createSession: "sessions.create",
 	listSessions: "sessions.list",
 	getSession: "sessions.get",
@@ -6067,6 +6524,7 @@ const OPERATION_METHODS = {
 	patchAccount: "account.update",
 	getBilling: "billing.get",
 	listBillingInvoices: "billing.invoices",
+	getStudioQuote: "billing.studioQuote",
 	getReferrals: "referrals.get",
 	getSettings: "settings.get",
 	patchSettings: "settings.update",
@@ -6295,8 +6753,10 @@ var CodaiApps = class {
 *   client.brandKits.create / .update / .exportDtcg / .extract / .list / .retrieve / .delete (codai Studio brand
 *     kits as DTCG tokens, from a web page or a logo; extract is
 *     token-metered, the rest free; apply with creatives.create({ kind, brand_kit_id }))
-*   client.templates.list / .retrieve / .delete (codai Studio templates saved with creatives.saveTemplate; free;
-*     use with creatives.create({ kind, template, vars }))
+*   client.templates.list / .retrieve / .delete (codai Studio templates saved with creatives.saveTemplate plus the 40
+*     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.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
@@ -6304,11 +6764,15 @@ 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.vault.account / .items / .putItem / .rules / .approvals / .decide / .catalog / .use / .httpCall / .resolve
+*   client.vault.devices.challenge / .enroll / .list / .rename / .revoke (device approval keys, V-27)
+*     (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)
 *   client.systemOne.create / .batch (typed decisions, codai-s1)
 *   client.realtime.connect (WebSocket live STT / voice; not an OpenAPI operation)
-*   client.agents.run + client.agents.runs.*    client.tools.search / .fetch
+*   client.agents.run + client.agents.runs.*    client.tools.search / .fetch (metered web tools)
+*   client.research.create / .retrieve / .wait / .run (async deep research, cited report)
 *   client.cards.weather / .places / .geocode / .staticMap / .fx / .unfurl (typed card data, `{ block, provenance }`)
 *   client.tasks.*                              client.sessions.* (events, controls, lease, shares, stream)
 *   client.devices.* / client.hosts.*           client.orgs.* / client.account / client.receipt
@@ -6319,6 +6783,7 @@ var CodaiApps = class {
 *   client.projects.*                           client.environments.* (members, ports, secrets)
 *   client.sandboxes.create / .list / .retrieve / .exec / .execStream / .files.put / .files.get / .files.list
 *     / .artifacts / .snapshot / .delete / .run (agent sandboxes, beta: isolated gVisor workspaces, no network by default)
+*     / .runCode / .resetKernel / .pause / .resume / .fork / .preview (backend v2, closed canary)
 *   client.verify.agentOutputKey / .agentOutput (EXPERIMENTAL HIDE-signed agent outputs)
 *   client.feedback / client.phoneModels
 *   client.resolve.* (verified bug fixes on https://resolve.codai.ro — resolve.yaml; .list / .iterate page your jobs)
@@ -6356,6 +6821,8 @@ var Codai = class {
 	brandKits;
 	/** codai Studio templates (`creatives.saveTemplate(id, { vars })` saves one; `templates.list()`; create with `creatives.create({ kind, template, vars })`). */
 	templates;
+	/** codai Studio productions (`productions.run({ brief, language: 'ro' })` → a finished promo video + editable creative). */
+	productions;
 	/** 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)`). */
@@ -6364,6 +6831,8 @@ var Codai = class {
 	shares;
 	/** Public takedown tickets for voices cloned in codai Studio (`voiceRevocations.create({ email, … })`; no key needed). */
 	voiceRevocations;
+	/** 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). */
 	abuseReports;
 	/** Public AI-provenance checker (`provenance.check(file)` → C2PA / RIFF INFO / ID3 / MP4 / XMP marks; no key needed). */
@@ -6377,6 +6846,8 @@ var Codai = class {
 	health;
 	agents;
 	tools;
+	/** Async deep research (`research.run({ question })` → cited report + sources). */
+	research;
 	/** Typed card data (`cards.weather({ lat, lng })`, `.places({ q })`, `.fx()`, `.unfurl(url)` → `{ block, provenance }`). */
 	cards;
 	tasks;
@@ -6453,10 +6924,12 @@ var Codai = class {
 		this.creatives = new Creatives(http);
 		this.brandKits = new BrandKits(http);
 		this.templates = new Templates(http);
+		this.productions = new Productions(http);
 		this.exports = new Exports(http);
 		this.batches = new Batches(http);
 		this.shares = new Shares(http);
 		this.voiceRevocations = new VoiceRevocations(http);
+		this.vault = new Vault(http);
 		this.abuseReports = new AbuseReports(http);
 		this.provenance = new Provenance(http);
 		this.systemOne = new SystemOne(http);
@@ -6468,6 +6941,7 @@ var Codai = class {
 		this.health = new Health(http);
 		this.agents = new Agents(http);
 		this.tools = new Tools(http);
+		this.research = new Research(http);
 		this.cards = new Cards(http);
 		this.tasks = new Tasks(http);
 		this.triggers = new Triggers(http);
@@ -6584,5 +7058,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, PROVENANCE_MAX_BYTES, PhoneModels, Projects, Prompts, Provenance, RESOLVE_ATTESTATION_PAYLOAD_TYPE, RESOLVE_OPERATION_METHODS, RESOLVE_TERMINAL_STATUSES, Realtime, RealtimeSession, Receipts, Referrals, Renders, 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, Verify, Videos, VoiceRevocations, extensionHeaders, frameJson, isAssetDto, 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, Keys, Lists, Memory, Messages, Models, Music, Notifications, OPERATION_METHODS, OrgMembers, Orgs, 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 };
 //# sourceMappingURL=index.js.map