@nodaro/sdk 2.28.0 → 2.31.0

package/dist/index.js

@@ -1,4513 +1,102 @@
-export { OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from '@nodaro/shared/workflow';
-import { nodeRunRoute, NODE_TYPES_WITHOUT_RUN_ROUTE, NODE_RUN_ROUTES } from '@nodaro/shared/nodes';
-export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '@nodaro/shared/nodes';
-import { SOCIAL_POST_NODE_PLATFORM } from '@nodaro/shared/social';
-import { SCENE3D_V2_LIMITS } from '@nodaro/shared/scene3d';
-import { buildPersonHints } from '@nodaro/prompts/person';
-export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts/person';
-export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, SURROUND_DIRECTIONS } from '@nodaro/shared/entities';
-import { resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl } from '@nodaro/shared/edl';
-export { unwrapEditPlanOutput } from '@nodaro/shared/edl';
-import { WORKSPACE_HEADER } from '@nodaro/shared/organizations';
-export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from '@nodaro/shared/organizations';
-export { RECAST_SEGMENT_PACKS } from '@nodaro/shared/apps';
-
-// src/binary-response.ts
-async function readBinaryResponse(response, maxBytes) {
-  const advertised = response.headers.get("content-length");
-  if (advertised !== null && (!/^\d+$/.test(advertised) || Number(advertised) > maxBytes)) {
-    await response.body?.cancel();
-    throw new Error("Binary response exceeds its declared size limit");
-  }
-  if (!response.body) return new ArrayBuffer(0);
-  const reader = response.body.getReader();
-  const chunks = [];
-  let length = 0;
-  try {
-    while (true) {
-      const next = await reader.read();
-      if (next.done) break;
-      length += next.value.byteLength;
-      if (length > maxBytes) {
-        await reader.cancel();
-        throw new Error("Binary response exceeds its declared size limit");
-      }
-      chunks.push(next.value);
-    }
-  } finally {
-    reader.releaseLock();
-  }
-  const bytes = new Uint8Array(length);
-  let offset = 0;
-  for (const chunk of chunks) {
-    bytes.set(chunk, offset);
-    offset += chunk.byteLength;
-  }
-  return bytes.buffer;
-}
-
-// src/errors.ts
-var NodaroError = class extends Error {
-  constructor(message, code, status) {
-    super(message);
-    this.code = code;
-    this.status = status;
-    this.name = "NodaroError";
-  }
-  code;
-  status;
-};
-var UnauthorizedError = class extends NodaroError {
-  constructor(message = "Authentication required") {
-    super(message, "unauthorized", 401);
-    this.name = "UnauthorizedError";
-  }
-};
-var ForbiddenError = class extends NodaroError {
-  constructor(message = "Forbidden", missingScope) {
-    super(message, "forbidden", 403);
-    this.missingScope = missingScope;
-    this.name = "ForbiddenError";
-  }
-  missingScope;
-};
-var NotFoundError = class extends NodaroError {
-  constructor(message = "Not found") {
-    super(message, "not_found", 404);
-    this.name = "NotFoundError";
-  }
-};
-var RateLimitedError = class extends NodaroError {
-  constructor(message = "Rate limited") {
-    super(message, "rate_limited", 429);
-    this.name = "RateLimitedError";
-  }
-};
-var InsufficientCreditsError = class extends NodaroError {
-  constructor(message = "Insufficient credits", required, available) {
-    super(message, "insufficient_credits", 402);
-    this.required = required;
-    this.available = available;
-    this.name = "InsufficientCreditsError";
-  }
-  required;
-  available;
-};
-var StorageExceededError = class extends NodaroError {
-  constructor(message = "Storage exceeded", limitBytes) {
-    super(message, "storage_exceeded", 413);
-    this.limitBytes = limitBytes;
-    this.name = "StorageExceededError";
-  }
-  limitBytes;
-};
-var WorkflowConflictError = class extends NodaroError {
-  constructor(message = "Workflow was updated by another writer", currentUpdatedAt, currentVersion, currentRecord, code = "workflow_conflict") {
-    super(message, code, 409);
-    this.currentUpdatedAt = currentUpdatedAt;
-    this.currentVersion = currentVersion;
-    this.currentRecord = currentRecord;
-    this.name = "WorkflowConflictError";
-  }
-  currentUpdatedAt;
-  currentVersion;
-  currentRecord;
-};
-var StudioOpError = class extends NodaroError {
-  constructor(message, code, status, opIndex) {
-    super(message, code, status);
-    this.opIndex = opIndex;
-    this.name = "StudioOpError";
-  }
-  opIndex;
-};
-var CONTINUATION_REFUSAL_CODES = /* @__PURE__ */ new Set([
-  "already_running",
-  "continuation_superseded",
-  "render_final_already_rendered"
-]);
-var ContinuationRefusedError = class extends NodaroError {
-  constructor(message, code, jobId) {
-    super(message, code, 409);
-    this.jobId = jobId;
-    this.name = "ContinuationRefusedError";
-  }
-  jobId;
-};
-var JobBlockedError = class extends NodaroError {
-  constructor(message = "Blocked by this deployment's content policy") {
-    super(message, "job_blocked", 422);
-    this.name = "JobBlockedError";
-  }
-};
-var JobFailedError = class extends NodaroError {
-  constructor(message, jobId, jobStatus = "failed") {
-    super(message, "job_failed", 0);
-    this.jobId = jobId;
-    this.jobStatus = jobStatus;
-    this.name = "JobFailedError";
-  }
-  jobId;
-  jobStatus;
-};
-var JobTimeoutError = class extends NodaroError {
-  constructor(message, jobId, timeoutMs) {
-    super(message, "job_timeout", 0);
-    this.jobId = jobId;
-    this.timeoutMs = timeoutMs;
-    this.name = "JobTimeoutError";
-  }
-  jobId;
-  timeoutMs;
-};
-var JobAbortedError = class extends NodaroError {
-  constructor(message = "Aborted", jobId) {
-    super(message, "job_aborted", 0);
-    this.jobId = jobId;
-    this.name = "JobAbortedError";
-  }
-  jobId;
-};
-var StudioPreviewUnavailable = class extends NodaroError {
-  constructor(message = "This deployment does not preview operation batches; nothing was sent") {
-    super(message, "studio_preview_unavailable", 0);
-    this.name = "StudioPreviewUnavailable";
-  }
-};
-var StudioPreviewAppliedError = class extends NodaroError {
-  constructor(applied, message = applied ? "Asked for a preview and this deployment APPLIED the batch; the change is written \u2014 see `applied`" : "Asked for a preview and this deployment answered with neither one nor a body to read; the batch may have been applied \u2014 re-read the production before deciding anything") {
-    super(message, "studio_preview_applied", 0);
-    this.applied = applied;
-    this.name = "StudioPreviewAppliedError";
-  }
-  applied;
-};
-var JobHeldError = class extends NodaroError {
-  constructor(message, jobId) {
-    super(message, "job_held", 0);
-    this.jobId = jobId;
-    this.name = "JobHeldError";
-  }
-  jobId;
-};
-function throwFromResponse(status, body) {
-  const code = body.error?.code ?? "internal_error";
-  const message = body.error?.message ?? "Request failed";
-  if (status === 401) throw new UnauthorizedError(message);
-  if (status === 409 && (code === "workflow_conflict" || code === "production_busy")) {
-    throw new WorkflowConflictError(
-      message,
-      body.error?.currentUpdatedAt,
-      body.error?.currentVersion,
-      body.error?.currentRecord,
-      code
-    );
-  }
-  if (status >= 400 && status < 500 && typeof body.error?.opIndex === "number") {
-    throw new StudioOpError(message, code, status, body.error.opIndex);
-  }
-  if (status === 409 && CONTINUATION_REFUSAL_CODES.has(code) && typeof body.jobId === "string") {
-    throw new ContinuationRefusedError(message, code, body.jobId);
-  }
-  if (status === 422 && code === "job_blocked") throw new JobBlockedError(message);
-  if (status === 403 && code === "insufficient_scope") {
-    throw new ForbiddenError(message, body.error?.missingScope);
-  }
-  if (status === 403) throw new ForbiddenError(message);
-  if (status === 404) throw new NotFoundError(body.error?.message ?? (typeof body.message === "string" ? body.message : void 0));
-  if (status === 429) throw new RateLimitedError(message);
-  if (status === 402) {
-    throw new InsufficientCreditsError(message, body.error?.required, body.error?.available);
-  }
-  if (status === 413) throw new StorageExceededError(message, body.error?.limitBytes);
-  throw new NodaroError(message, code, status);
-}
-
-// src/resources/workflows.ts
-var WorkflowCollaboratorsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List a workflow's collaborators (id, name, avatar, role — never email). */
-  list(workflowId) {
-    return this.client.request(
-      "GET",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`
-    );
-  }
-  /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */
-  add(workflowId, input) {
-    return this.client.request(
-      "POST",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators`,
-      { body: input }
-    );
-  }
-  /** Change a collaborator's role. */
-  update(workflowId, userId, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`,
-      { body: input }
-    );
-  }
-  /** Remove a collaborator — or yourself. Returns `{ success: true }`. */
-  remove(workflowId, userId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/collaborators/${encodeURIComponent(userId)}`
-    );
-  }
-};
-var WorkflowsResource = class {
-  constructor(client) {
-    this.client = client;
-    this.collaborators = new WorkflowCollaboratorsResource(client);
-  }
-  client;
-  /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */
-  collaborators;
-  /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */
-  list(params) {
-    return this.client.request(
-      "GET",
-      `/v1/projects/${encodeURIComponent(params.projectId)}/workflows`
-    );
-  }
-  /** Get a workflow including its full nodes/edges/settings. */
-  get(id) {
-    return this.client.request("GET", `/v1/workflows/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Get a PUBLICLY-SHARED workflow by id (`GET /v1/public/workflows/:id`) — the
-   * unauthenticated share-by-link read. Returns the workflow's nodes/edges/
-   * settings ONLY when it's opted into sharing server-side (`settings.studio.shared
-   * === true`); otherwise the route 404s (→ `NotFoundError`). No auth required —
-   * a share viewer has no session; the SDK omits the bearer when no token exists.
-   */
-  getPublic(id) {
-    return this.client.request("GET", `/v1/public/workflows/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Create a workflow under a project. Returns the full record.
-   * NOTE: server route is `POST /v1/projects/:projectId/workflows`.
-   */
-  create(input) {
-    const { projectId, ...body } = input;
-    return this.client.request(
-      "POST",
-      `/v1/projects/${encodeURIComponent(projectId)}/workflows`,
-      { body }
-    );
-  }
-  /** Patch a workflow. Returns the full updated record. */
-  update(id, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/workflows/${encodeURIComponent(id)}`,
-      { body: input }
-    );
-  }
-  /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
-   *  when the id doesn't exist or isn't yours (the delete is not silent). */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/workflows/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Run a workflow. Returns the executionId for polling via
-   * `client.executions.get(executionId)`.
-   */
-  run(id, params = {}) {
-    return this.client.request(
-      "POST",
-      `/v1/workflows/${encodeURIComponent(id)}/run`,
-      { body: params }
-    );
-  }
-  /**
-   * Render final (`renderFinal` on `POST /v1/workflows/:id/run`): run the
-   * render at Final for this run only, and every node after it, continuing the
-   * execution that stopped at its preview. The server derives the nodes and
-   * the override — send nothing else. Quote it first with
-   * {@link estimateRenderFinal}. Refused with `render_final_node_not_found`,
-   * `render_final_not_a_render`, or a continuation code (see `run`); a run
-   * its payer cannot cover throws `InsufficientCreditsError` (with `required`
-   * and, when it is yours to see, `available`) before any execution exists.
-   */
-  renderFinal(id, params) {
-    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/run`, {
-      body: {
-        renderFinal: { renderNodeId: params.renderNodeId },
-        continueFromExecutionId: params.continueFromExecutionId
-      }
-    });
-  }
-  /**
-   * Quote a Render final (`POST /v1/workflows/:id/render-final/estimate`): the
-   * nodes it will run, the override it runs with and its estimated credits.
-   * Nothing is created or charged.
-   */
-  estimateRenderFinal(id, params) {
-    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/render-final/estimate`, {
-      body: { renderNodeId: params.renderNodeId, continueFromExecutionId: params.continueFromExecutionId }
-    });
-  }
-  /**
-   * Export a workflow as a portable JSON bundle.
-   * Pass `opts.assets = true` to include character/object/location entity data.
-   */
-  export(workflowId, opts) {
-    return this.client.request(
-      "GET",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/export`,
-      { query: { assets: opts?.assets ?? false } }
-    );
-  }
-  /**
-   * Import a `WorkflowExport` bundle into the specified project.
-   * Re-creates any bundled assets (characters, objects, creatures, locations)
-   * under your account, and re-points BOTH the entity nodes and every `@`-chip
-   * (`ConnectedReference`) bound in the graph at the rows it created.
-   * Media the bundle references on other hosts is copied onto this instance's
-   * storage where reachable; a bundled entity's images are copied whoever
-   * hosts them, because they are the exporter's bytes and their lifecycle is
-   * not yours. `importReport` says what was copied, what could not be reached
-   * and what was skipped (and why); `assetIdMap` maps each bundled entity id
-   * to the row created for it (for chips you hold outside the graph), and
-   * `assetsSkipped` names the entities your storage quota left uncreated —
-   * the workflow itself still lands.
-   */
-  import(input) {
-    const { projectId, ...workflowJson } = input;
-    return this.client.request("POST", "/v1/workflows/import", {
-      body: { projectId, workflow_json: workflowJson }
-    });
-  }
-  /**
-   * Set a workflow's visibility — `"private"` (creator + explicit collaborators)
-   * or `"workspace"` (everyone in its workspace). Only the creator or a workspace
-   * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:
-   * the visibility lever lives on `PATCH /v1/workflows/:id`.
-   */
-  setVisibility(id, visibility) {
-    return this.client.request("PATCH", `/v1/workflows/${encodeURIComponent(id)}`, {
-      body: { visibility }
-    });
-  }
-  /**
-   * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder
-   * is cleared. When the move takes the workflow out of a workspace, collaborator
-   * grants that came from that workspace are dropped and returned as
-   * `droppedCollaborators`.
-   */
-  move(id, params) {
-    return this.client.request("POST", `/v1/workflows/${encodeURIComponent(id)}/move`, {
-      body: params
-    });
-  }
-  /**
-   * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —
-   * grants on work that is NOT in a workspace you belong to (workspace work already
-   * shows in that workspace's own lists). Each carries the `grantedRole` you hold.
-   * Empty when the organizations feature is off server-side.
-   */
-  sharedWithMe() {
-    return this.client.request("GET", "/v1/workflows/shared-with-me");
-  }
-};
-
-// src/resources/projects.ts
-var ProjectsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List the authenticated user's projects. */
-  list() {
-    return this.client.request("GET", "/v1/projects");
-  }
-  /** Get a project by ID. */
-  get(id) {
-    return this.client.request("GET", `/v1/projects/${encodeURIComponent(id)}`);
-  }
-  /** Create a new project. */
-  create(input) {
-    return this.client.request("POST", "/v1/projects", { body: input });
-  }
-  /** Update a project. At least one field must be provided. */
-  update(id, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/projects/${encodeURIComponent(id)}`,
-      { body: input }
-    );
-  }
-  /** Delete a project. Returns `{ success: true }`. */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/projects/${encodeURIComponent(id)}`);
-  }
-};
-
-// src/resources/sessions.ts
-var SessionsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Create a session. Send its `id` as `sessionId` on a generation request
-   * (`nodes.run("generate-image", { sessionId, … })`, video, speech, music) and
-   * the job is born in it.
-   */
-  create(input) {
-    return this.client.request("POST", "/v1/sessions", { body: input });
-  }
-  /** Your sessions, newest first. */
-  list(params = {}) {
-    const query = {};
-    if (params.projectId) query.projectId = params.projectId;
-    if (params.tool) query.tool = params.tool;
-    if (params.includeArchived) query.includeArchived = "true";
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", "/v1/sessions", { query });
-  }
-  get(id) {
-    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}`);
-  }
-  /** Rename or archive a session. Its project cannot change. */
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/sessions/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** Delete a session and its links. Its jobs are kept, and stay in every other session holding them. */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/sessions/${encodeURIComponent(id)}`);
-  }
-  /** The session's items, born-in and imported, newest first. */
-  items(id, params = {}) {
-    const query = {};
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}/items`, { query });
-  }
-  /**
-   * Import some of your own jobs into a session — a link, not a copy (up to 100
-   * a call). All-or-nothing: if any id is not one of your jobs, nothing is
-   * imported and the call fails with 404. Items already there are left as they are.
-   */
-  importItems(id, input) {
-    return this.client.request("POST", `/v1/sessions/${encodeURIComponent(id)}/items`, { body: input });
-  }
-  /** Remove one item from a session. Only the link goes: the job, and every other session holding it, stay. */
-  removeItem(id, jobId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/sessions/${encodeURIComponent(id)}/items/${encodeURIComponent(jobId)}`
-    );
-  }
-};
-
-// src/resources/jobs.ts
-var JobsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Get a single job by ID. */
-  get(id) {
-    return this.client.request("GET", `/v1/jobs/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and
-   * `origin` filter on the job's own `input_data`, which every job carries —
-   * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
-   */
-  list(params = {}) {
-    return this.client.request("GET", "/v1/jobs", { query: { ...params } });
-  }
-  /**
-   * Get the lean status of a single job (poll-loop friendly).
-   * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/
-   * output_data/error_message, with far less wire/CPU cost than `get()`.
-   * Same auth + ownership semantics as {@link get}.
-   */
-  getStatus(id) {
-    return this.client.request(
-      "GET",
-      `/v1/jobs/${encodeURIComponent(id)}/status`
-    );
-  }
-  /**
-   * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.
-   * Refunds any reserved credit holds.
-   */
-  cancel(id) {
-    return this.client.request(
-      "POST",
-      `/v1/jobs/${encodeURIComponent(id)}/cancel`
-    );
-  }
-  /**
-   * Delete a job and the private media it produced. Server route is
-   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;
-   * a job that is still running is deleted as-is — cancel it first when its
-   * worker should stop ({@link cancel}).
-   */
-  delete(id) {
-    return this.client.request(
-      "DELETE",
-      `/v1/jobs/${encodeURIComponent(id)}`
-    );
-  }
-};
-
-// src/resources/video-pro.ts
-var VideoProResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Gracefully stop a running generate-video-pro job (keep + deliver the
-   *  completed segments; refund the rest). */
-  stop(jobId) {
-    return this.client.request(
-      "POST",
-      `/v1/generate-video-pro/${encodeURIComponent(jobId)}/stop`
-    );
-  }
-  /** Continue a stopped/failed/completed run from a segment (a NEW job).
-   *  Named `continueRun` because `continue` is a reserved word. */
-  continueRun(jobId, opts) {
-    return this.client.request("POST", "/v1/generate-video-pro/continue", {
-      body: {
-        fromJobId: jobId,
-        ...opts?.fromSegment !== void 0 ? { fromSegment: opts.fromSegment } : {}
-      }
-    });
-  }
-};
-var ExecutionsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Get an execution by ID. Falls back to standalone single-node jobs server-side. */
-  get(id) {
-    return this.client.request(
-      "GET",
-      `/v1/workflow-executions/${encodeURIComponent(id)}`
-    );
-  }
-  /** List executions for a workflow. Merges workflow_executions + standalone single-node jobs. */
-  listForWorkflow(workflowId, params = {}) {
-    return this.client.request(
-      "GET",
-      `/v1/workflows/${encodeURIComponent(workflowId)}/executions`,
-      {
-        query: {
-          limit: params.limit,
-          cursor: params.cursor,
-          status: params.status,
-          source: params.source
-        }
-      }
-    );
-  }
-  /** Cancel an execution. Returns `{ success: true }`. */
-  cancel(id, params = {}) {
-    return this.client.request(
-      "POST",
-      `/v1/workflow-executions/${encodeURIComponent(id)}/cancel`,
-      { body: params }
-    );
-  }
-};
-var DEFAULT_POLL_MS = 2e3;
-var DEFAULT_MAX_MS = 15 * 60 * 1e3;
-var sleep = (ms, signal) => new Promise((resolve, reject) => {
-  if (signal?.aborted) {
-    reject(new JobAbortedError());
-    return;
-  }
-  const timer = setTimeout(() => {
-    signal?.removeEventListener("abort", onAbort);
-    resolve();
-  }, ms);
-  function onAbort() {
-    clearTimeout(timer);
-    reject(new JobAbortedError());
-  }
-  signal?.addEventListener("abort", onAbort, { once: true });
-});
-function notRunnable(type, why) {
-  return new NodaroError(`Node type "${type}" has no route of its own to run it directly: ${why}.`, "node_not_runnable", 0);
-}
-var isRouteNotFound = (err) => err instanceof NotFoundError && /^Route\b.*\bnot found\b/i.test(err.message);
-function extractJobId(result, label) {
-  if (result && typeof result === "object" && "jobId" in result) {
-    const jobId = result.jobId;
-    if (typeof jobId === "string") return jobId;
-  }
-  throw new JobFailedError(`${label} did not return a jobId`, "");
-}
-var NodesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List all known node descriptors. Server caches publicly for 5 minutes. */
-  list() {
-    return this.client.request("GET", "/v1/nodes");
-  }
-  /** Get a single node descriptor by type slug (e.g. "generate-image"). */
-  get(type) {
-    return this.client.request("GET", `/v1/nodes/${encodeURIComponent(type)}`);
-  }
-  run(type, params = {}, options = {}) {
-    const route = type === "render-video" && typeof params.planType === "string" ? "/v1/render-video/plan" : nodeRunRoute(type);
-    if (!route) return Promise.reject(notRunnable(type, NODE_TYPES_WITHOUT_RUN_ROUTE[type]));
-    const platform = SOCIAL_POST_NODE_PLATFORM[type];
-    const body = platform && params.platform === void 0 ? { ...params, platform } : params;
-    const conventional = !Object.prototype.hasOwnProperty.call(NODE_RUN_ROUTES, type);
-    return this.client.request("POST", route, {
-      body,
-      // Transport-level retry safety, opt-in per call. The platform reads the
-      // standard header, so a caller that reuses a key on a retry gets the
-      // same run back instead of a second charge.
-      ...options.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
-    }).catch((err) => {
-      if (conventional && isRouteNotFound(err)) throw notRunnable(type, "it runs only inside a workflow (client.workflows.run)");
-      throw err;
-    });
-  }
-  async runAndWait(type, params = {}, opts = {}) {
-    if (opts.signal?.aborted) throw new JobAbortedError();
-    const result = await this.run(type, params, { idempotencyKey: opts.idempotencyKey });
-    const jobId = extractJobId(result, type);
-    return this.pollJob(jobId, type, opts);
-  }
-  /**
-   * Fan out N async runs of the same node `type` to completion concurrently —
-   * the candidate-grid path (generate N stills/clips in parallel). Each runs
-   * via {@link runAndWait}; resolves once ALL settle, to an array of
-   * `{ jobId, output }` in input order. Rejects (and the rejection wins) if any
-   * single run rejects — same typed errors as {@link runAndWait}, including
-   * {@link JobHeldError} when one candidate is held for review while the
-   * others complete. A shared `signal` aborts the whole batch.
-   *
-   * @param type        Node type slug, applied to every entry.
-   * @param paramsList  One request body per candidate.
-   * @param opts        Shared `signal` / `cancelOnAbort` / `onProgress` / `pollMs` / `maxMs`.
-   */
-  async runMany(type, paramsList, opts = {}) {
-    if (opts.signal?.aborted) throw new JobAbortedError();
-    return Promise.all(
-      paramsList.map(async (params) => {
-        if (opts.signal?.aborted) throw new JobAbortedError();
-        const result = await this.run(type, params);
-        const jobId = extractJobId(result, type);
-        const output = await this.pollJob(jobId, type, opts);
-        return { jobId, output };
-      })
-    );
-  }
-  /** {@link pollUntilSettled}, plus what an abort does to the job: it keeps
-   *  running unless `cancelOnAbort` asks to cancel it too, and the rejection
-   *  always names it (an abort landing mid-sleep carries no id of its own). */
-  async pollJob(jobId, label, opts) {
-    try {
-      return await this.pollUntilSettled(jobId, label, opts);
-    } catch (err) {
-      if (!(err instanceof JobAbortedError)) throw err;
-      if (opts.cancelOnAbort) await this.client.jobs.cancel(jobId).catch(() => void 0);
-      throw err.jobId ? err : new JobAbortedError(err.message, jobId);
-    }
-  }
-  /** Poll an already-kicked job id until it stops moving; resolve output_data
-   *  or throw. Two non-terminal statuses end the loop: an abort, and
-   *  `pending_review` (a job policy held the output for a human — see
-   *  {@link JobHeldError}). */
-  async pollUntilSettled(jobId, label, opts) {
-    const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
-    const maxMs = opts.maxMs ?? DEFAULT_MAX_MS;
-    const deadline = Date.now() + maxMs;
-    for (; ; ) {
-      if (opts.signal?.aborted) throw new JobAbortedError(void 0, jobId);
-      const { data } = await this.client.jobs.getStatus(jobId);
-      opts.onProgress?.(data);
-      if (data.status === "completed") {
-        return data.output_data ?? {};
-      }
-      if (data.status === "failed" || data.status === "cancelled") {
-        throw new JobFailedError(
-          data.error_message ?? `${label} ${data.status}`,
-          jobId,
-          data.status
-        );
-      }
-      if (data.status === "pending_review") {
-        throw new JobHeldError(`${label} is awaiting review`, jobId);
-      }
-      if (Date.now() > deadline) {
-        throw new JobTimeoutError(`${label} timed out`, jobId, maxMs);
-      }
-      await sleep(pollMs, opts.signal);
-    }
-  }
-};
-
-// src/resources/scene3d-types.ts
-var SCENE3D_DELIVERY_ASSET_USAGE = {
-  poster: "poster",
-  "validation-report": "validation",
-  "shot-still": "shot-still",
-  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
-  "source-json": "checkpoint"
-};
-
-// src/resources/scene3d.ts
-function newIdempotencyKey() {
-  const random = globalThis.crypto?.randomUUID?.();
-  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
-}
-var Scene3DResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  capabilities() {
-    return this.client.request("GET", "/v1/3d-scene/capabilities");
-  }
-  /** Current access to both the delivery and its source is required on every read. */
-  getDelivery(jobId) {
-    return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
-  }
-  /**
-   * The bytes of one descriptor the delivery listed.
-   *
-   * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which
-   * is why a `shot-still` now works: the route has served stills since they existed, and this
-   * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same
-   * map; the server still decides whether THIS caller may read it.
-   */
-  deliveryAssetBytes(jobId, asset, options) {
-    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {
-      throw new Error("This asset is not available through the delivery endpoint");
-    }
-    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
-      throw new Error("Invalid scene delivery asset byte length");
-    }
-    return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
-      signal: options?.signal,
-      maxBytes: asset.byteLength
-    });
-  }
-  /**
-   * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.
-   *
-   * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene
-   * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's
-   * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This
-   * fetches it in one call — delivery, then the `source-json` descriptor's bytes.
-   *
-   * `null` means the delivery has no retained recipe to hand back: no pass ever cleared
-   * admission, or this caller holds less than `edit` on the job's workflow and the descriptor
-   * is therefore not listed for them.
-   *
-   * Read it to see what was attempted and to inform the next prompt. There is no input that
-   * takes a recipe back: a refused run published no revision, so there is no `{kind:"scene"}`
-   * source to re-run it from.
-   */
-  async retainedRecipe(jobId, options) {
-    const delivery = await this.getDelivery(jobId);
-    const asset = delivery.assets.find((item) => item.kind === "source-json");
-    if (!asset) return null;
-    const bytes = await this.deliveryAssetBytes(jobId, asset, options);
-    return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
-  }
-  /** Persist deterministic overlays without an LLM or a generation charge. */
-  applyEdits(revisionId, params) {
-    return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
-  }
-  /** Asset access is scoped to an exact retained revision, with fresh authentication. */
-  assetBytes(revisionId, asset, options) {
-    if (!["glb", "camera-track-json", "poster", "validation-report"].includes(asset.kind)) {
-      throw new Error("This asset is not available through the playback endpoint");
-    }
-    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
-      throw new Error("Invalid scene asset byte length");
-    }
-    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {
-      signal: options?.signal,
-      maxBytes: asset.byteLength
-    });
-  }
-  /** The editable native file has its own authorization lane. */
-  sourceBytes(revisionId, options) {
-    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {
-      signal: options?.signal,
-      maxBytes: SCENE3D_V2_LIMITS.maxBlendSourceBytes
-    });
-  }
-  generate(params) {
-    return this.client.nodes.run("generate-3d-scene", params);
-  }
-  generateAndWait(params, options) {
-    return this.client.nodes.runAndWait("generate-3d-scene", params, options);
-  }
-  edit(params) {
-    return this.client.nodes.run("edit-3d-scene", params);
-  }
-  editAndWait(params, options) {
-    return this.client.nodes.runAndWait("edit-3d-scene", params, options);
-  }
-  /**
-   * Price a 3D Render Pro request WITHOUT starting it.
-   *
-   * Takes the same body a run takes, minus the `quoteId`, and answers a
-   * ceiling (`maxCredits`), a `breakdown` to show, and the
-   * `normalizedInputHash` admission re-checks. It reserves nothing and spends
-   * nothing — a quote is a price, not a purchase.
-   */
-  quotePro(params) {
-    return this.client.request("POST", "/v1/pro-3d-render/quote", { body: params });
-  }
-  /**
-   * Submit a quoted 3D Render Pro run.
-   *
-   * Requires the `quoteId` from {@link quotePro}: no run starts at a price
-   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
-   * supply your own, which you should when retrying a call that timed out.
-   *
-   * Availability is a property of the deployment: `capabilities().pro` says
-   * whether this install can serve it, and which controls you may offer.
-   */
-  runPro(params, options) {
-    return this.client.nodes.run("pro-3d-render", params, {
-      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
-    });
-  }
-  /**
-   * Quote if needed, run, and wait — the whole operation in one call.
-   *
-   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
-   * this quotes the identical body first, so the run is admitted against a
-   * hash of exactly what was priced. Pass a `quoteId` to run against a quote
-   * you already showed the user.
-   *
-   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
-   * (the exact composition it was rendered from), plus the revision, poster,
-   * validation and renderer metadata. A run that AUTHORED also reports its own
-   * account of the answer — `metadata.summary`, `repairPasses`,
-   * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from
-   * the compiler's own remedy with no planner call, counted APART from
-   * `repairPasses` on their own quoted allowance), `restoredAssertions`, and
-   * any `SCENE_AUTHORING_ASSUMPTION` warnings. A
-   * completed result whose `metadata.review` is present passed every mandatory
-   * assertion but did NOT get the visual reviewer's approval: `verdict:
-   * "refused"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`
-   * warning; `verdict: "unavailable"` means the review produced no usable
-   * verdict in `attempts` asks (`reason: "provider"` — never reached its
-   * provider; `"unusable"` — it answered, unusably), so nobody judged the scene and
-   * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same
-   * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;
-   * that costs no authoring.
-   */
-  async renderProAndWait(params, options) {
-    const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
-    return this.client.nodes.runAndWait("pro-3d-render", { ...params, quoteId }, {
-      ...options,
-      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
-    });
-  }
-  /**
-   * Uses the supplied immutable revision; never starts authoring or a rebuild.
-   *
-   * Priced by the plan's frame size — see {@link RenderScene3DParams}.
-   */
-  render(params) {
-    return this.client.nodes.run("render-video", params);
-  }
-  renderAndWait(params, options) {
-    return this.client.nodes.runAndWait("render-video", params, options);
-  }
-};
-
-// src/resources/developer-apps.ts
-var DeveloperAppsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List the authenticated user's developer apps. */
-  list() {
-    return this.client.request("GET", "/v1/developer-apps");
-  }
-  /** Get a developer app by ID. */
-  get(id) {
-    return this.client.request("GET", `/v1/developer-apps/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Create a new developer app. Returns the app PLUS a one-time `clientSecret`
-   * — store it now, the secret hash is the only copy kept server-side.
-   */
-  create(input) {
-    return this.client.request("POST", "/v1/developer-apps", { body: input });
-  }
-  /** Update a developer app's metadata, redirect URIs, origins, or requested scopes. */
-  update(id, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/developer-apps/${encodeURIComponent(id)}`,
-      { body: input }
-    );
-  }
-  /** Delete a developer app. Returns `{ success: true }`. Throws
-   *  `NotFoundError` when the id doesn't exist or isn't yours. */
-  delete(id) {
-    return this.client.request(
-      "DELETE",
-      `/v1/developer-apps/${encodeURIComponent(id)}`
-    );
-  }
-  /**
-   * Generate a new `clientSecret`. The previous secret is invalidated.
-   * Server returns ONLY the new secret, not the full app record.
-   */
-  rotateSecret(id) {
-    return this.client.request(
-      "POST",
-      `/v1/developer-apps/${encodeURIComponent(id)}/rotate-secret`
-    );
-  }
-};
-
-// src/resources/oauth.ts
-var OAuthResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Server-side authorization-code exchange. Sends the standard OAuth 2.0
-   * `application/json` body to `POST /v1/oauth/token`.
-   *
-   * NEVER call this from a browser — `client_secret` must stay on the server.
-   */
-  exchangeCode(input) {
-    return this.client.request("POST", "/v1/oauth/token", {
-      body: { grant_type: "authorization_code", ...input }
-    });
-  }
-  /**
-   * Revoke an access token (RFC 7009). Always returns `{ success: true }`,
-   * even for unknown tokens — the spec forbids leaking token validity.
-   */
-  revoke(token) {
-    return this.client.request("POST", "/v1/oauth/revoke", { body: { token } });
-  }
-  /**
-   * Get public app metadata for a consent screen.
-   * `GET /v1/oauth/app-info?client_id=<id>`. Public route — no auth needed.
-   */
-  getAppInfo(clientId, redirectUri) {
-    return this.client.request("GET", "/v1/oauth/app-info", {
-      query: redirectUri ? { client_id: clientId, redirect_uri: redirectUri } : { client_id: clientId }
-    });
-  }
-};
-
-// src/resources/apps.ts
-var AppsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List published apps. Public — no auth required for community apps. */
-  list(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.search) qs.set("search", params.search);
-    if (params.limit !== void 0) qs.set("limit", String(params.limit));
-    if (params.cursor) qs.set("cursor", params.cursor);
-    if (params.category) qs.set("category", params.category);
-    const query = qs.toString();
-    return this.client.request("GET", `/v1/apps/browse${query ? `?${query}` : ""}`);
-  }
-  /** Get one app's metadata + input schema by slug. */
-  get(slug) {
-    return this.client.request("GET", `/v1/app/${encodeURIComponent(slug)}`);
-  }
-  /**
-   * Trigger an app run with the given input values. The keys in `inputs` must
-   * match the app's input-schema field names (see `get(slug).inputSchema`).
-   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).
-   * Returns the execution-id for status polling via client.executions.get().
-   */
-  run(slug, inputs = {}, opts = {}) {
-    return this.client.request("POST", `/v1/app/${encodeURIComponent(slug)}/run`, {
-      body: { inputs, ...opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {} }
-    });
-  }
-  /** List past runs for an app (the caller must own the app or the runs). */
-  listRuns(slug, params = {}) {
-    const qs = new URLSearchParams();
-    if (params.limit !== void 0) qs.set("limit", String(params.limit));
-    if (params.cursor) qs.set("cursor", params.cursor);
-    const query = qs.toString();
-    return this.client.request(
-      "GET",
-      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : ""}`
-    );
-  }
-  /** Get one app-run by id. */
-  getRun(slug, runId) {
-    return this.client.request(
-      "GET",
-      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
-    );
-  }
-  /**
-   * Archive (soft-delete) a published-app run. The run is hidden from the
-   * default run list and can be restored or permanently deleted from the
-   * archive view at https://app.nodaro.ai/archived-runs.
-   *
-   * @param slug   The published app's slug (the last path segment of its URL).
-   * @param runId  The run's UUID.
-   */
-  deleteRun(slug, runId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
-    );
-  }
-};
-var CharactersResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * List the caller's characters. By default returns active characters only;
-   * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
-   * When `projectId` is set, only characters belonging to that project are
-   * returned.
-   *
-   * Cursor-paginated: a response carrying a non-null `nextCursor` means more
-   * rows exist. Pass it back as `cursor` to fetch the next page, and keep going
-   * until `nextCursor` is `null` — a single call returns at most `limit` rows
-   * (default 100), so treating one call as "all characters" silently truncates
-   * the list for anyone past that count.
-   *
-   * ```ts
-   * const all: Character[] = []
-   * let cursor: string | undefined
-   * do {
-   *   const page = await client.characters.list({ cursor })
-   *   all.push(...page.characters)
-   *   cursor = page.nextCursor ?? undefined
-   * } while (cursor)
-   * ```
-   */
-  list(params = {}) {
-    const query = {};
-    if (params.projectId) query.projectId = params.projectId;
-    if (params.archived) query.archived = "true";
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", "/v1/characters", { query });
-  }
-  /**
-   * Fetch a single character including in-flight portrait / asset job state.
-   * Soft-deleted (archived) rows are returned by id intentionally so canvas
-   * nodes that hold a stale `characterDbId` keep loading. Pass
-   * `{ candidates: "all" }` to also get the current portrait's own take in
-   * `previousCandidates` (flagged `isPortrait: true`).
-   */
-  get(id, options = {}) {
-    const query = {};
-    if (options.candidates) query.candidates = options.candidates;
-    return this.client.request("GET", `/v1/characters/${encodeURIComponent(id)}`, { query });
-  }
-  /**
-   * Create or update a character. Omit `id` to create; supply it to update
-   * (only the fields you pass get written — undefined keys are untouched).
-   *
-   * If the caller-supplied `name` collides with an existing active character
-   * for this user, the request returns 409 `name_taken`. To auto-number a
-   * placeholder, pass the placeholder name from `@nodaro/shared` and the
-   * server will derive "Untitled character 2", "Untitled character 3", etc.
-   */
-  upsert(input) {
-    return this.client.request("POST", "/v1/characters", { body: input });
-  }
-  /**
-   * Convenience wrapper around `upsert()` for creating new characters.
-   * Equivalent to `upsert({ ...input, id: undefined })`. `name` is REQUIRED
-   * on create — the route 400s on INSERT-without-name; we narrow the type
-   * here so callers fail at compile-time rather than runtime.
-   */
-  create(input) {
-    return this.upsert(input);
-  }
-  /**
-   * Convenience wrapper around `upsert()` for updating an existing character.
-   * Equivalent to `upsert({ ...input, id })`.
-   */
-  update(id, input) {
-    return this.upsert({ ...input, id });
-  }
-  /**
-   * Soft-delete (archive) a character. The row is hidden from `list()` by
-   * default but still loadable via `get(id)` so canvas nodes pointing at it
-   * keep working. Restore with `restore(id)`.
-   */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/characters/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Un-archive a character. If the original name now collides with an
-   * active row, the server auto-suffixes "(restored)" and returns the
-   * effective name.
-   */
-  restore(id) {
-    return this.client.request("POST", `/v1/characters/${encodeURIComponent(id)}/restore`);
-  }
-  /**
-   * Duplicate (fork) a character to a new row with a `"(copy)"` suffix.
-   * Asset URLs are shared by reference — the new row can diverge by
-   * regenerating any of them.
-   */
-  duplicate(id, input = {}) {
-    return this.client.request(
-      "POST",
-      `/v1/characters/${encodeURIComponent(id)}/duplicate`,
-      { body: input }
-    );
-  }
-  /**
-   * Count of the caller's workflows that reference this character. Powers the
-   * library "Archive" confirmation modal in the editor.
-   */
-  usage(id) {
-    return this.client.request("GET", `/v1/characters/${encodeURIComponent(id)}/usage`);
-  }
-  /**
-   * Fire `POST /v1/generate-character` to produce one or more portrait
-   * candidates. With `count > 1`, all jobs are reserved up-front before any
-   * is enqueued — mid-batch failures roll back atomically.
-   *
-   * When `attachToCharacterId` is set, the worker writes the result directly
-   * to the row's `source_image_url` (unless `attachPortrait: false`);
-   * otherwise you must call `approvePortrait()` after picking a candidate.
-   */
-  generate(input) {
-    return this.client.request("POST", "/v1/generate-character", { body: input });
-  }
-  /**
-   * Fire `POST /v1/generate-character-asset` to produce a single
-   * expression / pose / angle / lighting variant. When the studio path is
-   * set (`attachToCharacterId` + `attachToColumn` + `attachName`), the
-   * worker appends `{ name: attachName, url: <result> }` to the named
-   * JSONB array column on completion.
-   */
-  generateAsset(input) {
-    return this.client.request("POST", "/v1/generate-character-asset", { body: input });
-  }
-  /**
-   * Fire `POST /v1/generate-character-motion` to animate the character's
-   * portrait into a motion clip. The result is appended to the character's
-   * `motions[]` bucket when `attachToCharacterId` is set.
-   */
-  generateMotion(input) {
-    return this.client.request("POST", "/v1/generate-character-motion", { body: input });
-  }
-  /**
-   * Approve a completed `generate-character` job as the character's portrait.
-   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
-   * inline. Returns the new portrait URL plus the caption — `canonicalDescription`
-   * is `null` if the LLM call sub-failed (portrait still set; retry via `recaption()`).
-   */
-  approvePortrait(id, candidateJobId) {
-    return this.client.request(
-      "POST",
-      `/v1/characters/${encodeURIComponent(id)}/approve-portrait`,
-      { body: { candidateJobId } }
-    );
-  }
-  /**
-   * Re-fire the LLM caption against the character's current portrait. 502s on
-   * LLM failure; returns 400 `no_portrait` if no portrait is set yet.
-   */
-  recaption(id) {
-    return this.client.request(
-      "POST",
-      `/v1/characters/${encodeURIComponent(id)}/llm-caption`
-    );
-  }
-};
-function buildPersonSeedPrompt(value) {
-  return buildPersonHints(value).join(", ");
-}
-var LocationsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * List the caller's locations. By default returns active locations only;
-   * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
-   */
-  list(params = {}) {
-    const query = {};
-    if (params.archived) query.archived = "true";
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", "/v1/locations", { query });
-  }
-  /**
-   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
-   * rows so callers can drive a UI "Archived" tab without re-encoding the
-   * query param. Mirrors `ObjectsResource.listArchived`.
-   *
-   * `archived` is omitted from the param type — it's always set to `true` here.
-   */
-  listArchived(params = {}) {
-    return this.list({ ...params, archived: true });
-  }
-  /**
-   * Fetch a single location including in-flight asset job state. Soft-deleted
-   * (archived) rows are returned by id intentionally so canvas nodes that
-   * hold a stale `locationDbId` keep loading.
-   */
-  async get(id) {
-    const res = await this.client.request(
-      "GET",
-      `/v1/locations/${encodeURIComponent(id)}`
-    );
-    return { ...res, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Create a new location. `name` + `nodeId` are required — the route 400s
-   * otherwise. Returns the new row's id.
-   *
-   * Note: the underlying route is the same `POST /v1/locations` upsert that
-   * powers `update()`. This convenience wrapper enforces the INSERT-required
-   * fields at the type level and never sends an `id`.
-   */
-  create(data) {
-    return this.client.request("POST", "/v1/locations", { body: data });
-  }
-  /**
-   * Update a location. Only the fields you pass are written — undefined keys
-   * are NOT touched on the row. Worker-owned asset buckets are intentionally
-   * not exposed on this surface (see `UpdateLocationInput` for the rationale).
-   *
-   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's
-   * `updated_at` still matches; on mismatch the route returns 409
-   * `concurrent_modification`. The SDK surfaces that as a generic
-   * `NodaroError` with the same code.
-   */
-  update(id, data) {
-    return this.client.request("POST", "/v1/locations", {
-      body: { id, ...data }
-    });
-  }
-  /**
-   * Soft-delete (archive) a location. The row is hidden from `list()` by
-   * default but still loadable via `get(id)` so canvas nodes pointing at it
-   * keep working. Restore with `restore(id)`.
-   */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/locations/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Un-archive a location. If the original name now collides (case-
-   * insensitive) with an active row, the server auto-suffixes "(restored)"
-   * and returns the effective name.
-   */
-  restore(id) {
-    return this.client.request("POST", `/v1/locations/${encodeURIComponent(id)}/restore`);
-  }
-  /**
-   * Fire `POST /v1/generate-location` to produce one or more candidate main
-   * images. With `count > 1`, all jobs are reserved up-front before any
-   * is enqueued — mid-batch failures roll back atomically.
-   *
-   * When `attachToLocationId` is set AND `count === 1`, the worker writes
-   * the result directly to the row's `source_image_url`; otherwise you must
-   * call `approveMainImage()` after picking a candidate.
-   */
-  async generate(data) {
-    const res = await this.client.request(
-      "POST",
-      "/v1/generate-location",
-      { body: data }
-    );
-    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : []);
-    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds };
-  }
-  /**
-   * Fire `POST /v1/generate-location-asset` to produce a single variant.
-   * When the studio path is set (`attachToLocationId` + `attachToColumn` +
-   * `attachName`), the worker appends `{ name: attachName, url: <result> }`
-   * to the named JSONB array column on completion.
-   */
-  generateAsset(data) {
-    return this.client.request("POST", "/v1/generate-location-asset", { body: data });
-  }
-  /**
-   * Fire `POST /v1/generate-surround-continuation` to produce one seamless 360°
-   * ring view as an i2i continuation of `referenceImageUrl`. The platform builds
-   * the half-carry composite, paints the missing half, and color-harmonizes it
-   * to the carried half (no tonal seam; carried half stays pixel-exact). When the
-   * studio path is set, the worker appends the result to the location's bucket.
-   */
-  generateSurroundContinuation(data) {
-    return this.client.request("POST", "/v1/generate-surround-continuation", { body: data });
-  }
-  /**
-   * Fire `POST /v1/generate-location-motion` to animate the location's
-   * establishing shot into an atmospheric motion clip. Image-to-video, single
-   * clip per call; the attach column is hardcoded to `atmosphere_motions`
-   * server-side (locations have a single motion bucket so the caller doesn't
-   * supply `attachToColumn`). When the studio path is set
-   * (`attachToLocationId` + `attachName`), the worker appends
-   * `{ name: attachName, url: <result> }` to the row's `atmosphere_motions`
-   * column on completion.
-   */
-  generateMotion(data) {
-    return this.client.request("POST", "/v1/generate-location-motion", { body: data });
-  }
-  /**
-   * Atomically remove ONE asset take (every entry matching `url`) from a
-   * worker-owned bucket column — `POST /v1/locations/:id/remove-asset`. The
-   * worker-owned buckets are deliberately not writable through `update()`
-   * (a stale snapshot would race concurrent worker appends), so deleting a
-   * take — e.g. a 360° surround view being regenerated — goes through this
-   * single-statement server-side filter instead. 404s (`NotFoundError`) when
-   * the url isn't in that bucket or the location isn't yours.
-   */
-  removeAsset(id, data) {
-    return this.client.request(
-      "POST",
-      `/v1/locations/${encodeURIComponent(id)}/remove-asset`,
-      { body: data }
-    );
-  }
-  /**
-   * Approve a completed `generate-location` job as the location's main image.
-   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
-   * inline. Returns the new main-image URL plus the caption.
-   *
-   * Caption-failure semantics: the route still sends `""` on LLM sub-failure,
-   * but the SDK normalizes `""` → `null` here so `canonicalDescription` carries
-   * the same `string | null` semantics as characters. The main image is still
-   * set; call `recaption()` to retry.
-   */
-  async approveMainImage(id, candidateJobId) {
-    const res = await this.client.request(
-      "POST",
-      `/v1/locations/${encodeURIComponent(id)}/approve-main-image`,
-      { body: { candidateJobId } }
-    );
-    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Re-fire the LLM caption against the location's current main image. 502s
-   * on LLM failure (unlike `approveMainImage` which preserves the side-effect
-   * and returns ""); returns 400 `no_source_image` if no main image is set
-   * yet.
-   */
-  recaption(id) {
-    return this.client.request(
-      "POST",
-      `/v1/locations/${encodeURIComponent(id)}/llm-caption`
-    );
-  }
-};
-var ObjectsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * List the caller's objects. By default returns active objects only;
-   * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
-   * Optional `projectId` scopes the result to a single project.
-   */
-  list(params = {}) {
-    const query = {};
-    if (params.archived) query.archived = "true";
-    if (params.projectId) query.projectId = params.projectId;
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", "/v1/objects", { query });
-  }
-  /**
-   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
-   * rows so callers can drive a UI "Archived" tab without re-encoding the
-   * query param.
-   *
-   * `archived` is omitted from the param type — it's always set to `true` here.
-   */
-  listArchived(params = {}) {
-    return this.list({ ...params, archived: true });
-  }
-  /**
-   * Fetch a single object including in-flight asset job state. Soft-deleted
-   * (archived) rows are NOT returned by id — the route enforces
-   * `deleted_at IS NULL` so archived objects 404 (uniform Pass 10 F-90b
-   * "not_found" — does not leak the deleted vs non-existent distinction).
-   */
-  async get(id) {
-    const res = await this.client.request(
-      "GET",
-      `/v1/objects/${encodeURIComponent(id)}`
-    );
-    return { ...res, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Create a new object. `name` + `nodeId` are required — the route 400s
-   * otherwise. Returns the new row's id.
-   *
-   * Note: the underlying route is the same `POST /v1/objects` upsert that
-   * powers `update()`. This convenience wrapper enforces the INSERT-required
-   * fields at the type level and never sends an `id`.
-   */
-  create(data) {
-    return this.client.request("POST", "/v1/objects", { body: data });
-  }
-  /**
-   * Update an object. Only the fields you pass are written — undefined keys
-   * are NOT touched on the row. Worker-owned asset buckets are intentionally
-   * not exposed on this surface (see `UpdateObjectInput` for the rationale).
-   *
-   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's
-   * `updated_at` still matches; on mismatch the route returns 409
-   * `concurrent_modification` carrying the fresh `updatedAt`. The SDK
-   * surfaces that as a generic `NodaroError` with the same code (per Phase
-   * E1 calibration finding — error centralization in `throwApiError`).
-   */
-  update(id, data) {
-    return this.client.request("POST", "/v1/objects", {
-      body: { id, ...data }
-    });
-  }
-  /**
-   * Soft-delete (archive) an object. The row is hidden from `list()` by
-   * default but recoverable via `restore(id)` or visible under
-   * `listArchived()`. Idempotent — repeating a delete on an already-archived
-   * row is a no-op.
-   */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/objects/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Hard-delete (permanent) an object — the row + every R2 asset it
-   * references. Archived rows ONLY: active objects return 400 `not_archived`.
-   * Call `delete()` first to archive, then `permanentDelete()` to destroy.
-   *
-   * Mirrors the `app_runs` permanent-delete pattern (archive-first) so a
-   * stray SDK / curl caller cannot bypass the studio's archive-first UI
-   * flow.
-   */
-  permanentDelete(id) {
-    return this.client.request("DELETE", `/v1/objects/${encodeURIComponent(id)}`, {
-      query: { permanent: "true" }
-    });
-  }
-  /**
-   * Un-archive an object. If the original name now collides (case-
-   * insensitive) with an active row, the server auto-suffixes "(restored)"
-   * and returns the effective name.
-   */
-  restore(id) {
-    return this.client.request("POST", `/v1/objects/${encodeURIComponent(id)}/restore`);
-  }
-  /**
-   * Fire `POST /v1/generate-object` to produce one or more candidate main
-   * images. With `count > 1`, all jobs are reserved up-front before any
-   * is enqueued — mid-batch failures roll back atomically.
-   *
-   * When `attachToObjectId` is set AND `count === 1`, the worker writes
-   * the result directly to the row's `source_image_url`; otherwise you must
-   * call `approveMainImage()` after picking a candidate.
-   */
-  async generate(data) {
-    const res = await this.client.request(
-      "POST",
-      "/v1/generate-object",
-      { body: data }
-    );
-    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : []);
-    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds };
-  }
-  /**
-   * Fire `POST /v1/generate-object-asset` to produce a single variant.
-   * When the studio path is set (`attachToObjectId` + `attachToColumn` +
-   * `attachName`), the worker appends `{ name: attachName, url: <result> }`
-   * to the named JSONB array column on completion.
-   *
-   * Note: `attachToColumn` is REQUIRED for `assetType === "custom"` — the
-   * worker can't infer the bucket from the asset type. For canonical asset
-   * types (`angles` / `materials` / `variations` / `motion`), the column is
-   * derived automatically by the route.
-   */
-  generateAsset(data) {
-    return this.client.request("POST", "/v1/generate-object-asset", { body: data });
-  }
-  /**
-   * Fire `POST /v1/generate-object-motion` to animate the object's main
-   * image into a motion clip. Image-to-video, single clip per call; the
-   * attach column is hardcoded to `motion_clips` server-side (objects have a
-   * single motion bucket so the caller doesn't supply `attachToColumn`).
-   * When the studio path is set (`attachToObjectId` + `attachName`), the
-   * worker appends `{ name: attachName, url: <result> }` to the row's
-   * `motion_clips` column on completion.
-   *
-   * Defaults: `provider` → `"kling-turbo"`, `aspectRatio` → `"1:1"` (set
-   * server-side via `resolveObjectAspectRatio({ assetType: "motion" })`).
-   */
-  generateMotion(data) {
-    return this.client.request("POST", "/v1/generate-object-motion", { body: data });
-  }
-  /**
-   * Approve a completed `generate-object` job as the object's main image.
-   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
-   * inline. Returns the new main-image URL plus the caption.
-   *
-   * Caption-failure semantics: the route still sends `""` on LLM sub-failure,
-   * but the SDK normalizes `""` → `null` here so `canonicalDescription` carries
-   * the same `string | null` semantics as characters. The main image is still
-   * set; call `recaption()` to retry.
-   *
-   * Optimistic-concurrency: pass `expectedUpdatedAt` to gate the update on
-   * the row's current `updated_at`; on mismatch the route returns 409
-   * `concurrent_modification` carrying the fresh token.
-   */
-  async approveMainImage(id, candidateJobId, expectedUpdatedAt) {
-    const res = await this.client.request(
-      "POST",
-      `/v1/objects/${encodeURIComponent(id)}/approve-main-image`,
-      { body: { candidateJobId, expectedUpdatedAt } }
-    );
-    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Re-fire the LLM caption against the object's current main image. 502s
-   * on LLM failure (unlike `approveMainImage` which preserves the side-effect
-   * and returns ""); returns 400 `main_image_required` if no main image is
-   * set yet.
-   *
-   * The route is a pure idempotent retry — it does NOT accept an
-   * `expectedUpdatedAt` token (per Phase E1 calibration finding: backend
-   * route is idempotent retry, not gated on optimistic-concurrency).
-   */
-  recaption(id) {
-    return this.client.request(
-      "POST",
-      `/v1/objects/${encodeURIComponent(id)}/llm-caption`
-    );
-  }
-};
-var CREATURE_ASSET_TYPES = ["angles", "poses", "variations", "custom"];
-var CreaturesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * List the caller's creatures. By default returns active creatures only;
-   * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
-   * Optional `projectId` scopes the result to a single project.
-   */
-  list(params = {}) {
-    const query = {};
-    if (params.archived) query.archived = "true";
-    if (params.projectId) query.projectId = params.projectId;
-    if (params.limit !== void 0) query.limit = String(params.limit);
-    if (params.cursor) query.cursor = params.cursor;
-    return this.client.request("GET", "/v1/creatures", { query });
-  }
-  /**
-   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
-   * rows so callers can drive a UI "Archived" tab without re-encoding the
-   * query param.
-   *
-   * `archived` is omitted from the param type — it's always set to `true` here.
-   */
-  listArchived(params = {}) {
-    return this.list({ ...params, archived: true });
-  }
-  /**
-   * Fetch a single creature including in-flight asset job state. Soft-deleted
-   * (archived) rows are NOT returned by id — the route enforces
-   * `deleted_at IS NULL` so archived creatures 404 (uniform "not_found" — does
-   * not leak the deleted vs non-existent distinction).
-   */
-  async get(id) {
-    const res = await this.client.request(
-      "GET",
-      `/v1/creatures/${encodeURIComponent(id)}`
-    );
-    return { ...res, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Create a new creature. `name` + `nodeId` are required — the route 400s
-   * otherwise. Returns the new row's id.
-   *
-   * Note: the underlying route is the same `POST /v1/creatures` upsert that
-   * powers `update()`. This convenience wrapper enforces the INSERT-required
-   * fields at the type level and never sends an `id`.
-   */
-  create(data) {
-    return this.client.request("POST", "/v1/creatures", { body: data });
-  }
-  /**
-   * Update a creature. Only the fields you pass are written — undefined keys
-   * are NOT touched on the row. Worker-owned asset buckets are intentionally
-   * not exposed on this surface (see `UpdateCreatureInput` for the rationale).
-   *
-   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's
-   * `updated_at` still matches; on mismatch the route returns 409
-   * `concurrent_modification` carrying the fresh `updatedAt`. The SDK
-   * surfaces that as a generic `NodaroError` with the same code.
-   */
-  update(id, data) {
-    return this.client.request("POST", "/v1/creatures", {
-      body: { id, ...data }
-    });
-  }
-  /**
-   * Soft-delete (archive) a creature. The row is hidden from `list()` by
-   * default but recoverable via `restore(id)` or visible under
-   * `listArchived()`. Idempotent — repeating a delete on an already-archived
-   * row is a no-op.
-   */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/creatures/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Hard-delete (permanent) a creature — the row + every R2 asset it
-   * references. Archived rows ONLY: active creatures return 400 `not_archived`.
-   * Call `delete()` first to archive, then `permanentDelete()` to destroy.
-   *
-   * Mirrors the `app_runs` permanent-delete pattern (archive-first) so a
-   * stray SDK / curl caller cannot bypass the studio's archive-first UI
-   * flow.
-   */
-  permanentDelete(id) {
-    return this.client.request("DELETE", `/v1/creatures/${encodeURIComponent(id)}`, {
-      query: { permanent: "true" }
-    });
-  }
-  /**
-   * Un-archive a creature. If the original name now collides (case-
-   * insensitive) with an active row, the server auto-suffixes "(restored)"
-   * and returns the effective name.
-   */
-  restore(id) {
-    return this.client.request("POST", `/v1/creatures/${encodeURIComponent(id)}/restore`);
-  }
-  /**
-   * Fire `POST /v1/generate-creature` to produce one or more candidate main
-   * images. With `count > 1`, all jobs are reserved up-front before any
-   * is enqueued — mid-batch failures roll back atomically.
-   *
-   * When `attachToCreatureId` is set AND `count === 1`, the worker writes
-   * the result directly to the row's `source_image_url`; otherwise you must
-   * call `approveMainImage()` after picking a candidate.
-   */
-  async generate(data) {
-    const res = await this.client.request(
-      "POST",
-      "/v1/generate-creature",
-      { body: data }
-    );
-    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : []);
-    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds };
-  }
-  /**
-   * Fire `POST /v1/generate-creature-asset` to produce a single variant.
-   * When the studio path is set (`attachToCreatureId` + `attachToColumn` +
-   * `attachName`), the worker appends `{ name: attachName, url: <result> }`
-   * to the named JSONB array column on completion.
-   *
-   * Note: `attachToColumn` is REQUIRED for `assetType === "custom"` — the
-   * worker can't infer the bucket from the asset type. For canonical asset
-   * types (`angles` / `poses` / `variations`), the column is derived
-   * automatically by the route.
-   */
-  generateAsset(data) {
-    return this.client.request("POST", "/v1/generate-creature-asset", { body: data });
-  }
-  /**
-   * Fire `POST /v1/generate-creature-motion` to animate the creature's main
-   * image into a motion clip. Image-to-video, single clip per call; the
-   * attach column is hardcoded to `motion_clips` server-side (creatures have a
-   * single motion bucket so the caller doesn't supply `attachToColumn`).
-   * When the studio path is set (`attachToCreatureId` + `attachName`), the
-   * worker appends `{ name: attachName, url: <result> }` to the row's
-   * `motion_clips` column on completion.
-   *
-   * Defaults: `provider` → `"kling-turbo"`, `aspectRatio` → `"1:1"` (set
-   * server-side via `resolveObjectAspectRatio({ assetType: "motion" })`).
-   */
-  generateMotion(data) {
-    return this.client.request("POST", "/v1/generate-creature-motion", { body: data });
-  }
-  /**
-   * Approve a completed `generate-creature` job as the creature's main image.
-   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
-   * inline. Returns the new main-image URL plus the caption.
-   *
-   * Caption-failure semantics: the route still sends `""` on LLM sub-failure,
-   * but the SDK normalizes `""` → `null` here so `canonicalDescription` carries
-   * the same `string | null` semantics as characters. The main image is still
-   * set; call `recaption()` to retry.
-   *
-   * Optimistic-concurrency: pass `expectedUpdatedAt` to gate the update on
-   * the row's current `updated_at`; on mismatch the route returns 409
-   * `concurrent_modification` carrying the fresh token.
-   */
-  async approveMainImage(id, candidateJobId, expectedUpdatedAt) {
-    const res = await this.client.request(
-      "POST",
-      `/v1/creatures/${encodeURIComponent(id)}/approve-main-image`,
-      { body: { candidateJobId, expectedUpdatedAt } }
-    );
-    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null };
-  }
-  /**
-   * Re-fire the LLM caption against the creature's current main image. 502s
-   * on LLM failure (unlike `approveMainImage` which preserves the side-effect
-   * and returns ""); returns 400 `main_image_required` if no main image is
-   * set yet.
-   *
-   * The route is a pure idempotent retry — it does NOT accept an
-   * `expectedUpdatedAt` token (backend route is idempotent retry, not gated on
-   * optimistic-concurrency).
-   */
-  recaption(id) {
-    return this.client.request(
-      "POST",
-      `/v1/creatures/${encodeURIComponent(id)}/llm-caption`
-    );
-  }
-};
-
-// src/resources/pipelines.ts
-var PipelinesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Start a new pipeline (headless film generation) — the programmatic
-   * equivalent of the studio's "Create film". In Auto mode the engine
-   * self-advances to completion; poll {@link get} for status and
-   * {@link getTimeline} for the assembled output. In manual/guided mode, drive
-   * it with {@link pendingApprovals} + {@link approveStage} /
-   * {@link approveSubGate} / {@link acceptMatchCutBreak}.
-   *
-   * Requires `pipelines:execute` scope. Returns the new pipeline id.
-   */
-  create(input) {
-    return this.client.request("POST", "/v1/pipelines", { body: input });
-  }
-  /**
-   * Fetch current pipeline state: `status`, `current_stage`, credit counters,
-   * `mode`, and `failure_reason` (set when `status='failed'`). Poll this to
-   * track a headless Auto run to completion. Requires `pipelines:read`.
-   */
-  get(id) {
-    return this.client.request(
-      "GET",
-      `/v1/pipelines/${encodeURIComponent(id)}`
-    );
-  }
-  /** List the caller's pipelines (most recent first). Requires `pipelines:read`. */
-  list() {
-    return this.client.request("GET", "/v1/pipelines");
-  }
-  /**
-   * Cancel a running pipeline. Unspent reserved credits refund. Idempotent on
-   * an already-terminal pipeline. Requires `pipelines:execute`.
-   */
-  cancel(id) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/cancel`,
-      { body: {} }
-    );
-  }
-  /**
-   * Stages currently `awaiting_approval`. Empty in a clean Auto run (the engine
-   * self-approves); populated in manual/guided mode at each gate. Requires
-   * `pipelines:read`.
-   */
-  pendingApprovals(id) {
-    return this.client.request(
-      "GET",
-      `/v1/pipelines/${encodeURIComponent(id)}/pending-approvals`
-    );
-  }
-  /**
-   * Approve a stage so the engine advances to the next one. An optional `edits`
-   * JSON-Patch is applied to the stage output before approval. Requires
-   * `pipelines:approve`.
-   */
-  approveStage(id, stage, edits) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/stages/${encodeURIComponent(stage)}/approve`,
-      { body: edits ? { edits } : {} }
-    );
-  }
-  /**
-   * Reject a stage with feedback; the engine re-runs it incorporating the note.
-   * Requires `pipelines:approve`.
-   */
-  rejectStage(id, stage, feedback) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/stages/${encodeURIComponent(stage)}/reject`,
-      { body: { feedback } }
-    );
-  }
-  /**
-   * Approve a Stage 7 (`animate_audio_edit`) sub-gate — `silent_cut_preview`
-   * or `dialogue_recheck` — so the orchestrator resumes from the next
-   * sub-step. Stage 6's `match_cut_break_pending` is not approved here: accept
-   * each break with {@link acceptMatchCutBreak}. Requires `pipelines:approve`.
-   */
-  approveSubGate(id, gate) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/sub-gates/${encodeURIComponent(gate)}/approve`,
-      { body: {} }
-    );
-  }
-  /**
-   * Accept one match-cut break Stage 6 (`scene_images`) flagged. While any
-   * break is pending, the stage pauses at the `match_cut_break_pending`
-   * sub-gate, and its output lists the pending shot ids; accepting the last
-   * one resumes the stage. `sceneId` is the scene entity that holds the shot.
-   * Requires `pipelines:approve`.
-   */
-  acceptMatchCutBreak(id, sceneId, shotId) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/entities/${encodeURIComponent(sceneId)}/helpers/accept_match_cut_break`,
-      { body: { shotId } }
-    );
-  }
-  /**
-   * Read a single stage's `status`, `output`, and `critic_feedback`. Useful for
-   * inspecting the script/plan before approving. Requires `pipelines:read`.
-   */
-  getStage(id, stage) {
-    return this.client.request(
-      "GET",
-      `/v1/pipelines/${encodeURIComponent(id)}/stages/${encodeURIComponent(stage)}`
-    );
-  }
-  /**
-   * Assembled timeline — ordered scene composites + durations + audio URLs +
-   * live animate progress. The output a headless caller renders or hands to a
-   * downstream editor. Requires `pipelines:read`.
-   */
-  getTimeline(id) {
-    return this.client.request(
-      "GET",
-      `/v1/pipelines/${encodeURIComponent(id)}/timeline`
-    );
-  }
-  /**
-   * Branch a completed pipeline into a new pipeline that re-runs from the
-   * given stage. The original pipeline's upstream stages and entities are
-   * cloned into the new pipeline; downstream stages are created by the
-   * orchestrator as it advances.
-   *
-   * Requires `pipelines:execute` scope.
-   * The source pipeline must have `status='completed'`.
-   *
-   * @returns 201 with `{ pipelineId, clonedStages, clonedEntities }`.
-   */
-  branch(id, input) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(id)}/branch`,
-      { body: input }
-    );
-  }
-  /**
-   * Send a chat message to the Showrunner Refinement Director (Guided Mode).
-   * Persists user + assistant turns; returns the assistant's reply and an
-   * optional `proposed_change` the user can `applyChatProposal` to commit.
-   *
-   * Requires `pipelines:approve` scope. The pipeline must have
-   * `mode='guided'` and the stage must be `awaiting_approval`.
-   *
-   * Only the Script stage ships a wired specialist in Phase 1D.2b — the other
-   * chat-enabled stages (`shot_list`, `post_merge`) return 501 until 1D.2d.
-   */
-  chatStage(pipelineId, stage, message) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(pipelineId)}/stages/${encodeURIComponent(stage)}/chat`,
-      { body: { message } }
-    );
-  }
-  /**
-   * Accept a proposed change from a prior assistant turn. Routes through
-   * `applyStageEdit` (validates JSON Patch + per-stage schema +
-   * reference-integrity, inserts a new pipeline_stage_attempts row, CAS-flips
-   * the stage to approved, emits `chat:proposal_applied` SSE).
-   *
-   * Requires `pipelines:approve` scope.
-   *
-   * Returns `{ applied: true, attemptId, newOutput }` on success, or
-   * `{ applied: false, error }` on recoverable failures (the backend already
-   * inserted a follow-up assistant turn with a hint). Hard failures
-   * (`patch_invalid`, `stage_not_awaiting`) throw via the standard error
-   * pipeline (HTTP 409).
-   */
-  applyChatProposal(pipelineId, stage, turnId) {
-    return this.client.request(
-      "POST",
-      `/v1/pipelines/${encodeURIComponent(pipelineId)}/stages/${encodeURIComponent(stage)}/chat/turns/${encodeURIComponent(turnId)}/apply`,
-      { body: {} }
-    );
-  }
-  /**
-   * Fetch the chat history for a stage. Returns an empty array when no turns
-   * exist yet (e.g., stage has not been started or the user hasn't sent any
-   * messages). Used by the frontend chat panel on initial mount; subsequent
-   * updates arrive via SSE (`chat:turn` events).
-   *
-   * Requires `pipelines:read` scope.
-   */
-  getStageChat(pipelineId, stage) {
-    return this.client.request(
-      "GET",
-      `/v1/pipelines/${encodeURIComponent(pipelineId)}/stages/${encodeURIComponent(stage)}/chat`
-    );
-  }
-};
-
-// src/resources/reduce.ts
-var ReduceResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Run the Reduce (fan-in) node directly — useful for scripted batch
-   * scoring, picking the best of N generations outside a workflow, or
-   * one-shot programmatic merges.
-   *
-   * Throws `NodaroError` on 4xx/5xx responses (e.g. `code: "no_valid_inputs"`
-   * with status 400 when every input is empty / whitespace; the underlying
-   * `EmptyInputError` is mapped to a 400 server-side).
-   */
-  run(input) {
-    return this.client.request("POST", "/v1/reduce", {
-      body: {
-        strategyId: input.strategyId,
-        strategyConfig: input.strategyConfig ?? {},
-        inputs: input.inputs,
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-};
-
-// src/resources/prompt-helper.ts
-var PromptHelperResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  analyze(input) {
-    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "analyze", ...input } });
-  }
-  generate(input) {
-    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "generate", ...input } });
-  }
-  enhance(input) {
-    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "enhance", ...input } });
-  }
-};
-
-// src/resources/voices.ts
-var VoicesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * List the premade ElevenLabs voices (`GET /v1/voices`). Falls back to a
-   * curated set server-side when no ElevenLabs API key is configured.
-   */
-  async list() {
-    const res = await this.client.request("GET", "/v1/voices");
-    return res.voices;
-  }
-  /**
-   * Search the shared/community Voice Library (`GET /v1/voices/library`). All
-   * params are optional and forwarded as a querystring; `undefined` / `null` /
-   * empty-string values are omitted so the server defaults apply. `hasMore`
-   * drives "load more" pagination.
-   */
-  searchLibrary(params = {}) {
-    const query = {};
-    for (const [k, v] of Object.entries(params)) {
-      if (v !== void 0 && v !== null && v !== "") query[k] = v;
-    }
-    return this.client.request("GET", "/v1/voices/library", { query });
-  }
-  /**
-   * List the signed-in user's voice clones (`GET /v1/voice-clones`). The route
-   * wraps the rows in `{ voiceClones }`; we unwrap to the bare array.
-   */
-  async listClones() {
-    const res = await this.client.request("GET", "/v1/voice-clones");
-    return res.voiceClones;
-  }
-  /**
-   * @deprecated Voice cloning is no longer offered on Nodaro (retired
-   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
-   * rejects with that error. Clones created before the retirement are still
-   * listed by {@link VoicesResource.listClones} and still work as voice ids.
-   * For a new custom voice use {@link VoicesResource.design}.
-   */
-  createClone(input) {
-    return this.client.request("POST", "/v1/voice-clones/from-url", { body: input });
-  }
-  /** Delete one of the user's voice clones (`DELETE /v1/voice-clones/:id`). */
-  async deleteClone(id) {
-    await this.client.request("DELETE", `/v1/voice-clones/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Replace the voice in a recording — or in a whole talking video — with a
-   * different voice (`POST /v1/voice-changer`). Pass `audioUrl` to revoice
-   * audio→audio, or `videoUrl` to revoice an entire clip (the server demuxes
-   * the audio, runs speech-to-speech, and remuxes onto the original video,
-   * returning the video plus the new audio track). Exactly one of `audioUrl` /
-   * `videoUrl` is required; when both are sent, video wins. `removeBackgroundNoise`
-   * off keeps the music/SFX bed under the new voice; on yields a clean voice-only
-   * result. Costs credits and runs async — poll `jobs.get(jobId)` for the result
-   * (`output_data.videoUrl` + `output_data.audioUrl` in video mode).
-   */
-  change(input) {
-    return this.client.request("POST", "/v1/voice-changer", { body: input });
-  }
-  /**
-   * Recast each detected speaker in a multi-speaker recording to a different
-   * voice (`POST /v1/voice-changer-pro`). `orderedVoices` maps speaker positions to
-   * voices in detection order — speaker 0 → `orderedVoices[0]`, speaker 1 →
-   * `orderedVoices[1]`, etc. Speakers beyond the end of `orderedVoices` keep
-   * their original voice. Each entry is EITHER a bare voice id (premade name or
-   * ElevenLabs UUID) OR a {@link VoiceChangerProVoice} object carrying per-voice
-   * ElevenLabs speech-to-speech settings (stability / similarityBoost / style /
-   * useSpeakerBoost / `seed`) plus a loudness `volumeMode` (and a manual
-   * `volume`) — OR `null`, meaning keep this speaker's original voice (requires
-   * a platform running cloud-plugins with keep-slot support). At least one
-   * entry must be non-null. A per-voice `seed` makes that speaker's recast
-   * reproducible.
-   *
-   * Pass `audioUrl` for audio-only recast or `videoUrl` to recast the audio
-   * track of a video clip (the server demuxes, recasts, and remuxes).
-   *
-   * Voice and music are ALWAYS separated first — before recasting, the source
-   * is split into an isolated vocal stem and a music/SFX stem.
-   * `preserveBackground` (default `true`) only controls whether that
-   * music/instrumental stem is mixed back under the new voices; set it `false`
-   * for a clean voice-only result. `separationQuality` selects the quality of
-   * the voice/music separation: `"fast"` (default, quicker — preserves more of
-   * the voice) or `"best"` (finer voice/music separation).
-   * `removeBackgroundNoise` additionally denoises the result.
-   * `musicVolumeMode` sets the level of that preserved background (only relevant
-   * when `preserveBackground` is on): `"match"` (default) keeps the original
-   * level, `"normalize"` loudnorms it, `"manual"` uses `musicVolume`%.
-   * `voiceFx` applies a reverb/echo to the COMBINED recast voices BEFORE the
-   * background is mixed back in (effect sits on the voices, not the music bed).
-   *
-   * Cloud-only — costs credits and runs async; poll `jobs.get(jobId)` for the
-   * result (`output_data.videoUrl` + `output_data.audioUrl` in video mode).
-   */
-  recast(input) {
-    return this.client.request("POST", "/v1/voice-changer-pro", { body: input });
-  }
-  /**
-   * Detect the speakers in a clip WITHOUT recasting yet
-   * (`POST /v1/voice-changer-pro/analyze`) — the first step of the interactive
-   * flow. Separates voice from music once and diarizes the vocals, returning the
-   * speaker list so a user (or agent) can choose a voice per speaker before
-   * committing to a paid recast. Poll `jobs.get(jobId)`: the completed job's
-   * `output_data` carries the separated stem urls + the detected `speakers`
-   * (each with `id`, time `segments`, `firstStartSec`, `wordCount`, `snippet`)
-   * and the detected language — reshape it into a {@link VcpAnalysis} and pass it
-   * as `recast({ ..., analysis })` to skip re-detection. With `suggestTitle`,
-   * `output_data.suggestedTitle` also carries an LLM-proposed title.
-   *
-   * Cloud-only; costs credits and runs async.
-   */
-  analyze(input) {
-    return this.client.request("POST", "/v1/voice-changer-pro/analyze", { body: input });
-  }
-  /**
-   * Render a final video from a mixed set of stems
-   * (`POST /v1/voice-changer-pro/export`) — the last step of the interactive
-   * flow. After `recast({ output: "stems" })` hands back the dry per-track stems
-   * and the user has set levels / mutes / an effect in your editor, pass those
-   * `tracks` (plus the source `videoUrl`) here to mix and remux into the finished
-   * video. The video is stream-copied (never re-encoded), so the export is
-   * bit-identical to your preview. At least one track must be un-muted (all-muted
-   * is a 400); `voiceFx` is applied to the voice tracks at render time.
-   *
-   * Cloud-only; costs credits and runs async — poll `jobs.get(jobId)` for the
-   * result (`output_data.videoUrl`).
-   */
-  exportMix(input) {
-    return this.client.request("POST", "/v1/voice-changer-pro/export", { body: input });
-  }
-  /**
-   * Design a brand-new synthetic voice from a text description
-   * (`POST /v1/voice-design`) — ElevenLabs text-to-voice. `text` (100–1000 chars)
-   * is a preview line spoken in the designed voice; `voiceDescription` describes
-   * the voice to create. Costs credits and runs async — poll `jobs.get(jobId)`
-   * for the preview + the reusable voice id.
-   */
-  design(input) {
-    return this.client.request("POST", "/v1/voice-design", { body: input });
-  }
-  /**
-   * Generate speech in a voice described in natural language, without cloning
-   * (`POST /v1/voice-remix`). `text` (1–5000 chars) is spoken in a voice matching
-   * `voiceDescription`. Costs credits and runs async — poll `jobs.get(jobId)`.
-   */
-  remix(input) {
-    return this.client.request("POST", "/v1/voice-remix", { body: input });
-  }
-  /**
-   * Dub an audio clip into another language while preserving each speaker's voice
-   * (`POST /v1/dubbing`). `targetLanguage` is an ISO code (e.g. `"es"`, `"fr"`);
-   * `sourceLanguage` is auto-detected when omitted. Costs credits and runs async
-   * — poll `jobs.get(jobId)`.
-   */
-  dub(input) {
-    return this.client.request("POST", "/v1/dubbing", { body: input });
-  }
-  /**
-   * Voice a multi-speaker script as ONE audio file
-   * (`POST /v1/text-to-dialogue`) on ElevenLabs Dialogue v3 — the default — or
-   * Dialogue v4 (`provider: "elevenlabs-dialogue-v4"`). Each `dialogue` line is
-   * `{ text, voice }` in speaking order — `voice` is a premade voice name or an
-   * ElevenLabs voice UUID (cloned/library voices work too; mixed casts are
-   * fine). At most 5,000 characters total across lines on Dialogue v3 and
-   * 10,000 on Dialogue v4 (≤2,000 recommended for best quality) and 10 unique
-   * voices. Line text may
-   * carry `[audio tags]` like `[laughs]`. Costs credits and runs async — poll
-   * `jobs.get(jobId)` for `output_data.audioUrl` and — on every dialogue model,
-   * since both return timings at no extra credits — `output_data.transcript`, a
-   * `Transcript` (`@nodaro/shared`): `words[]` with `startMs` / `endMs` /
-   * `speaker` and one `segments[]` entry per line, `speaker` being the line's
-   * `voice` as you sent it. Pass `transcript.words` to
-   * `addCaptions({ captions, autoTranscribe: false })` to caption the dialogue
-   * without a second transcription.
-   */
-  textToDialogue(input) {
-    return this.client.request("POST", "/v1/text-to-dialogue", { body: input });
-  }
-  /**
-   * @deprecated Voice cloning is no longer offered on Nodaro (retired
-   * 2026-09-15). The route answers `410 voice_cloning_retired` and this call
-   * rejects with that error. See {@link VoicesResource.createClone}.
-   */
-  createCloneFromFile(input) {
-    const form = new FormData();
-    form.append("name", input.name);
-    const blob = input.file instanceof Blob ? input.file : new Blob([input.file], { type: input.contentType ?? "audio/mpeg" });
-    form.append("file", blob, input.filename ?? "sample");
-    return this.client.request("POST", "/v1/voice-clones", { body: form });
-  }
-};
-
-// src/resources/llm.ts
-var LlmResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
-   * can run several minutes — longer than the client's default 60 s
-   * `timeoutMs`; construct the client with a larger `timeoutMs` for this
-   * call, or use {@link LlmResource.structuredJob}.
-   */
-  structured(input) {
-    return this.client.request("POST", "/v1/llm/structured", { body: input });
-  }
-  /**
-   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
-   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
-   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
-   * `jobs.list({ type: "llm-structured", origin })` finds every run later.
-   * Throws `NotFoundError` on a platform that predates the route. An instance
-   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
-   * permanently — the SDK surfaces that as a generic `NodaroError` with the
-   * same code; treat it as unavailable here, not as transient.
-   */
-  structuredJob(input) {
-    return this.client.request("POST", "/v1/llm/structured/jobs", { body: input });
-  }
-};
-
-// src/sse.ts
-async function* readSseStream(res, opts = {}) {
-  if (!res.ok) {
-    let errBody = {};
-    try {
-      errBody = await res.json();
-    } catch {
-    }
-    throwFromResponse(res.status, errBody);
-  }
-  if (!res.body) {
-    throw new NodaroError(`${opts.label ?? "event stream"} has no response body`, "empty_stream", res.status);
-  }
-  const reader = res.body.getReader();
-  const decoder = new TextDecoder();
-  let buffer = "";
-  try {
-    for (; ; ) {
-      const { done, value } = await reader.read();
-      if (done) break;
-      buffer += decoder.decode(value, { stream: true });
-      let sep;
-      while ((sep = buffer.indexOf("\n\n")) >= 0) {
-        const frame = buffer.slice(0, sep);
-        buffer = buffer.slice(sep + 2);
-        for (const line of frame.split("\n")) {
-          if (!line.startsWith("data:")) continue;
-          try {
-            yield JSON.parse(line.slice(5).trim());
-          } catch {
-          }
-        }
-      }
-    }
-  } finally {
-    reader.releaseLock();
-    await res.body.cancel().catch(() => {
-    });
-  }
-}
-
-// src/resources/media.ts
-var MediaResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Download a social video (YouTube / TikTok / Instagram / X / Facebook) into
-   * your storage (`POST /v1/download-video`). `maxHeight` caps the resolution
-   * (default "best"); `sectionStartSec` + `sectionEndSec` (both-or-neither) fetch
-   * ONLY that time range instead of the whole video. A download that arrives
-   * with no audio stream FAILS by default (it is usually a degraded source
-   * response, and is retried through other routes first); pass
-   * `requireAudio: false` to accept a clip that really has no sound. Returns a
-   * `downloadId`; progress streams from
-   * `GET /v1/download-video/progress/:downloadId` (server-sent events) and the
-   * finished file lands in your library.
-   */
-  downloadVideo(input) {
-    return this.client.request("POST", "/v1/download-video", { body: input });
-  }
-  /**
-   * Stream the live progress of a {@link MediaResource.downloadVideo} import
-   * (`GET /v1/download-video/progress/:downloadId`, server-sent events) as an
-   * async iterable. Yields a {@link DownloadVideoProgress} roughly every 500ms
-   * until the download reaches `completed` (its event carries the stored
-   * `videoUrl`) or `failed` (its event carries `error`), then ends. The progress
-   * state expires server-side shortly after the download starts existing, so
-   * start iterating promptly after `downloadVideo` returns.
-   *
-   * No request timeout is applied (a large import legitimately takes minutes) —
-   * pass an `AbortSignal` to cancel from the caller.
-   */
-  async *downloadVideoProgress(downloadId, opts = {}) {
-    const url = `${this.client.baseUrl}/v1/download-video/progress/${encodeURIComponent(downloadId)}`;
-    const token = await this.client.auth.getToken();
-    const res = await this.client.fetch(url, {
-      headers: token ? { Authorization: `Bearer ${token}` } : {},
-      signal: opts.signal
-    });
-    yield* readSseStream(res, { label: "progress stream" });
-  }
-  /**
-   * Copy an external media URL into your Nodaro storage (`POST /v1/save-to-storage`)
-   * — a server-side fetch, so nothing round-trips through the client. Poll
-   * `jobs.get(jobId)`.
-   */
-  saveToStorage(input) {
-    return this.client.request("POST", "/v1/save-to-storage", { body: input });
-  }
-  /**
-   * Composite 2–30 images into ONE large 2K/4K collage (`POST /v1/image-collage`).
-   * `layout` `"smart"` (default — justified rows at each image's exact aspect
-   * ratio, no cropping; the output height floats) or `"grid"` (uniform,
-   * letterboxed cells). `imageSizes` is index-aligned with `imageUrls` and
-   * gives per-image RELATIVE size hints for the smart layout: `0` auto
-   * ("don't care", default), `1` big (~2× linear vs medium), `2` medium,
-   * `3` small (~½ linear). All-equal hints change nothing; grid ignores them.
-   * For storyboards, set `numbered` to stamp a 1-based sequence badge at each
-   * image's corner (top-left by default; `badgePosition: "top-right"` moves it;
-   * in `imageUrls` order) and pass `imageLabels`
-   * (index-aligned with `imageUrls`; `null`/`""`/omitted = no caption for that
-   * image) to caption images after the number, e.g. `3 · Close-up`. Badges are
-   * an overlay only — they never change the layout, the output size or the
-   * credit cost. Poll `jobs.get(jobId)` for the finished image.
-   */
-  imageCollage(input) {
-    return this.client.request("POST", "/v1/image-collage", { body: input });
-  }
-  /**
-   * Place 1–12 layers — pictures, real text, QR codes, shapes — on a base image,
-   * pixel-exactly (`POST /v1/image-overlay`) — local, deterministic, no AI.
-   * Every layer position/size is a PERCENT of the base image: `anchor` (nine
-   * positions, default `"center"`), `x`/`y` (offset from the anchor in % of
-   * the base width/height; negative on a right/bottom anchor moves inward),
-   * `width` (% of the base width, default 25 — height follows the layer's
-   * aspect unless `height` is set). Plus `opacity` (0..1), `rotation`
-   * (degrees), `blend` (`"over"` | `"multiply"` | `"screen"`), `fit`,
-   * `shadow` and `roundedCorners`. The output keeps the base's pixel size
-   * unless `canvas` is set. Flat credit cost. Poll `jobs.get(jobId)` for the
-   * finished image.
-   */
-  imageOverlay(input) {
-    return this.client.request("POST", "/v1/image-overlay", { body: input });
-  }
-  /**
-   * Ask a vision model WHERE one overlay layer should sit on a base image
-   * (`POST /v1/image-overlay/suggest-placement`) — it reads the picture and
-   * keeps the element off the faces, the subject and the busiest texture.
-   * The answer comes back in {@link MediaResource.imageOverlay}'s own percent
-   * units — `anchor`, `x`/`y` offsets, `width` — so it drops straight onto a
-   * layer (`const { reason, ...box } = placement`), plus a one-sentence
-   * `reason` you can show a user. Nothing is composited here: apply the
-   * placement yourself.
-   *
-   * `layerAspect` is the element's width / height (1 = square, the default) so
-   * the proposed box stays in proportion; `intent` says what the element is
-   * ("a logo", "a price badge"); `safeArea` is the always-visible region as
-   * fractions of the canvas (a platform preset's safe area), which the
-   * placement is kept inside. Unlike the other media calls this one answers
-   * synchronously — there is nothing to poll; `jobId` is the billing record
-   * (one image-to-text call).
-   */
-  suggestOverlayPlacement(input) {
-    return this.client.request(
-      "POST",
-      "/v1/image-overlay/suggest-placement",
-      { body: input }
-    );
-  }
-  /**
-   * Trim a video to a range (`POST /v1/trim-video`). Give the range in whichever
-   * unit fits: `startTime`/`endTime` seconds, `trim*Frames`, `trim*Seconds`, or
-   * `keepFirst`/`keepLastSeconds`. Poll `jobs.get(jobId)`.
-   */
-  trimVideo(input) {
-    return this.client.request("POST", "/v1/trim-video", { body: input });
-  }
-  /**
-   * Burn captions into a video (`POST /v1/add-captions`). Give the words as
-   * `text`, word-timed `captions[]`, or let it transcribe (`autoTranscribe`,
-   * the default when neither is set).
-   *
-   * `style: "subtitle"` renders statically (FFmpeg) UNLESS it carries a styling
-   * lever, in which case it — like the KINETIC styles (`word-highlight` /
-   * `karaoke` / `tiktok-words` / `word-pop` / `bouncy`) — renders via Remotion.
-   * `look` picks a preset — `outline` (Montserrat 900, UPPERCASE, black outline,
-   * yellow spoken word — the TikTok/Reels read) or `clean`; an UNSET look renders
-   * as `outline`. The explicit STYLING levers (`fontFamily`, `fontWeight`,
-   * `strokeColor`/`strokeWidth`, `uppercase`, `positionY`, `maxWordsPerLine`)
-   * override individual fields of it and now apply to `subtitle` too. Only
-   * `highlightColor` (the spoken-word cursor) and `animate` stay kinetic-only
-   * and are REJECTED on `subtitle`.
-   *
-   * `animate` (default true) freezes the per-word MOTION on the kinetic styles
-   * when set to false — the grouping, line-holding and spoken-word highlight
-   * stay; only the movement stops.
-   *
-   * `maxWordsPerLine` (1-20) caps how many words a line — or a `tiktok-words`
-   * page — may hold, on top of the width budget / sentence ends / pauses that
-   * already close one; it is inert on `word-pop`, which is always one word.
-   * Like every lever here it exists top-level AND per segment, and a segment
-   * that does not name its own inherits the top-level value.
-   *
-   * `segments[]` applies DIFFERENT treatments to non-overlapping time ranges in
-   * one call (e.g. a large top intro, then a small bottom body); a segment that
-   * names its own `look` starts fresh from that preset and does not inherit the
-   * top-level explicit levers. Poll `jobs.get(jobId)`.
-   *
-   * `word-highlight` shows ONE held line at a time and a word's
-   * `startMs`/`endMs` is its SPOKEN window (what times the highlight, not how
-   * long the text is on screen) — so `captions[]` can be handed over verbatim
-   * from an `audio.transcribe()` job's `output_data.words`, with
-   * `autoTranscribe: false`.
-   */
-  addCaptions(input) {
-    const { autoTranscribe, transcribeProvider, ...rest } = input;
-    const body = {
-      ...rest,
-      ...autoTranscribe !== void 0 ? { auto_transcribe: autoTranscribe } : {},
-      ...transcribeProvider !== void 0 ? { transcribe_provider: transcribeProvider } : {}
-    };
-    return this.client.request("POST", "/v1/add-captions", { body });
-  }
-  /**
-   * Trim (and extract) audio from a video or audio source
-   * (`POST /v1/trim-audio`) to `[startTime, endTime]` seconds, in `audioFormat`
-   * (`mp3` default / `wav` / `aac`). Poll `jobs.get(jobId)`.
-   */
-  trimAudio(input) {
-    return this.client.request("POST", "/v1/trim-audio", { body: input });
-  }
-  /**
-   * Cut a video and/or an audio file into consecutive parts
-   * (`POST /v1/split-media`). Every part is at most `chunkDuration` seconds and
-   * at least `minPartDuration` (default 4, never above `chunkDuration`) — a
-   * short leftover is evened out with the parts before it. Video is cut on
-   * whole frames with each part's sound matching its picture; audio parts are
-   * sample-exact, in `audioFormat` (`mp3` default / `wav` / `aac`). With both
-   * sources each is split on its own. At most 200 parts per input. Poll
-   * `jobs.get(jobId)`; the parts are on the completed job's `output_data` —
-   * see {@link SplitMediaOutput}.
-   */
-  splitMedia(input) {
-    return this.client.request("POST", "/v1/split-media", { body: input });
-  }
-  /**
-   * Turn one still image + one audio track into an MP4
-   * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
-   * zero credits. The output duration IS the audio's duration; there is no
-   * duration field. Optional `motion` animates the still (zoom / pan /
-   * ken-burns) at `intensity` 1–10. `fit: "contain"` letterboxes with
-   * `padColor` instead of cropping. Poll `jobs.get(jobId)`.
-   */
-  stillToVideo(input) {
-    return this.client.request("POST", "/v1/still-to-video", { body: input });
-  }
-  /**
-   * Turn 2–100 images + one optional audio track into an MP4 slideshow
-   * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With
-   * audio, the output duration IS the audio's duration (equal split unless
-   * `imageDurations` pins rows — null entries = auto; mismatched pinned sums
-   * scale proportionally and the factor is disclosed in the job output).
-   * Without audio: N × `perImageDuration`, silent output. Transitions
-   * consume the outgoing slide, so totals stay exact. For a single image use
-   * `stillToVideo`. Poll `jobs.get(jobId)`.
-   */
-  slideshow(input) {
-    return this.client.request("POST", "/v1/slideshow", { body: input });
-  }
-  /**
-   * Place 1–20 timed image layers over a video (`POST /v1/video-overlay`) —
-   * rendered locally (FFmpeg) in one pass, no AI; the base audio is kept
-   * untouched. Each layer has an `imageUrl`, a `start` and an optional `end`
-   * in seconds (no `end` = to the end of the video) and a placement: a
-   * `preset` (`"card"`, `"corner-badge"` with a `corner`, `"full-frame"`) or
-   * an explicit box in {@link MediaResource.imageOverlay}'s percent vocabulary
-   * (`anchor`, `x`, `y`, `width`, `height`, `fit`) — an explicit box field
-   * overrides the preset, and a layer with neither is a corner badge
-   * (bottom-right, or the `corner` it names). `outputAspect` renders onto a
-   * 16:9 / 9:16 / 1:1 / 4:5 canvas
-   * (`baseFit` cover by default; `backgroundColor` pads `contain`). Poll
-   * `jobs.get(jobId)`: the output carries `videoUrl`, `thumbnailUrl`, `width`,
-   * `height`, `durationSec` and `warnings[]` (a layer clipped or skipped at the
-   * video's end, an animated image's first frame, re-encoded audio).
-   */
-  videoOverlay(input) {
-    return this.client.request("POST", "/v1/video-overlay", { body: input });
-  }
-  /**
-   * Track a subject described in plain text through a video and get a
-   * black-and-white MASK VIDEO back (`POST /v1/video-mask`, SAM 3.1 by default,
-   * or `provider: "sam-3"` at half the price) — white = the subject. Clips up
-   * to 5 minutes at 30 fps (a faster clip counts
-   * proportionally longer), priced by the clip's length. Poll
-   * `jobs.get(jobId)`: the output carries `videoUrl` (the mask), `width`,
-   * `height`, `frames` and `coverage` (the fraction of pixels selected). Feed
-   * the mask to {@link MediaResource.maskComposite}.
-   */
-  videoMask(input) {
-    return this.client.request("POST", "/v1/video-mask", { body: input });
-  }
-  /**
-   * Place a foreground video over a background video through a mask video
-   * (`POST /v1/mask-composite`; white = foreground) — local FFmpeg, no AI.
-   * The result follows the foreground's size, frame rate and length; the
-   * background is fitted (`backgroundFit`, default cover) and loops when
-   * shorter; the mask holds its last frame when shorter. Optional
-   * `invertMask`, `feather` (0–20 px), `grow` (−10–10 px) and `audioSource`
-   * (foreground / background / mix / none). Priced per started 5 seconds of
-   * the result (foreground up to 300 s). Poll `jobs.get(jobId)` for `videoUrl`.
-   */
-  maskComposite(input) {
-    return this.client.request("POST", "/v1/mask-composite", { body: input });
-  }
-  /**
-   * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
-   * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
-   * job. Use it to decide whether to trim before importing.
-   */
-  videoMetadata(input) {
-    return this.client.request("POST", "/v1/video-metadata", { body: input });
-  }
-  /**
-   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
-   * free, the source-preparation sibling of the priced `trimVideo` node.
-   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
-   * the source object afterwards when it is yours and nothing else references
-   * it ("the cut replaces the original"). Answers the stored file.
-   */
-  process(input) {
-    return this.client.request("POST", "/v1/media/process", { body: input });
-  }
-};
-
-// src/resources/audio.ts
-var AudioResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).
-   * `mode` `"vocal_instrumental"` (default) splits voice from music/SFX;
-   * `"stems"` returns the full drums/bass/other/… breakdown. `quality`
-   * `auto` (default) / `fast` / `best`.
-   */
-  separate(input) {
-    return this.client.request("POST", "/v1/audio-separation", { body: input });
-  }
-  /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */
-  isolate(input) {
-    return this.client.request("POST", "/v1/audio-isolation", { body: input });
-  }
-  /**
-   * Apply a reverb / echo / telephone / megaphone effect to an audio track
-   * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.
-   * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;
-   * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.
-   */
-  applyFx(input) {
-    return this.client.request("POST", "/v1/audio-fx", { body: input });
-  }
-  /**
-   * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`
-   * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set
-   * per-track level. `duck` puts a music bed under speech: every track EXCEPT
-   * `duck.under` (the 0-based index of the voice track) dips while that track
-   * is loud and rises back in its pauses (sidechain compression). `amount`
-   * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),
-   * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and
-   * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix
-   * sums its tracks rather than averaging them, so the voice keeps its level;
-   * the price is the same with or without a duck. `endAt` (`"longest"`, the
-   * default, or `"voice"`) says where the mix ends: `"voice"` ends it when the
-   * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track
-   * too: its audio is mixed, and a video with no sound is a silent track.
-   */
-  mix(input) {
-    return this.client.request("POST", "/v1/mix-audio", { body: input });
-  }
-  /**
-   * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):
-   * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`
-   * seconds. Provide `audioUrl` or `videoUrl`.
-   */
-  adjustVolume(input) {
-    return this.client.request("POST", "/v1/adjust-volume", { body: input });
-  }
-  /**
-   * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):
-   * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept
-   * (default 1; fixed at 1 for a video), `preserveFormants` (default true).
-   * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.
-   * Input up to 30 minutes, priced per started minute.
-   */
-  pitchTempo(input) {
-    return this.client.request("POST", "/v1/pitch-tempo", { body: input });
-  }
-  /**
-   * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each
-   * segment is a `url` with an optional `[startTime, endTime]` sub-range.
-   */
-  combine(input) {
-    return this.client.request("POST", "/v1/combine-audio", { body: input });
-  }
-  /**
-   * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).
-   *
-   * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,
-   * flag or not, and is the only lane that honours `diarize` (who spoke) and
-   * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns
-   * word timings when you ask for them. `whisper` returns NO word timings at
-   * all — named explicitly or reached by OMITTING `provider`, which still falls
-   * back to it — so asking it for them (`wordTimestamps: true`) is rejected with
-   * a `400 validation_error` at ingress, before any credit is spent. A kinetic
-   * caption render therefore has to name one of the other two.
-   *
-   * Poll `jobs.get(jobId)`; the finished job's `output_data` is a
-   * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`
-   * (caption-shaped, in MILLISECONDS), `json` (the normalized
-   * {@link Transcript}, also ms) — and a top-level `segments` array that is in
-   * SECONDS, not ms.
-   *
-   * `words` is the caption source for a kinetic burn-in: hand it to
-   * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the
-   * render uses those exact words (correct the `text` of an entry in between
-   * and the fix is what burns in).
-   */
-  transcribe(input) {
-    return this.client.request("POST", "/v1/transcribe", { body: input });
-  }
-};
-
-// src/resources/credits.ts
-var MODEL_COSTS_LIMIT = 50;
-var CreditsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * `GET /v1/user/credits` → the authenticated user's credit balance and tier
-   * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's
-   * other typed errors on the usual statuses.
-   */
-  async balance() {
-    const res = await this.client.request(
-      "GET",
-      "/v1/user/credits"
-    );
-    return res.data;
-  }
-  /**
-   * `GET /v1/credits/transactions` → one page of the caller's credit
-   * transactions, newest first, with `nextCursor` for the next page (`null`
-   * at the end). Read `credits_charged` for what each run cost — it can be
-   * below the hold (`credits_reserved`) and is `null` while the hold is open.
-   * Cloud-only route: a self-hosted instance answers 404.
-   */
-  transactions(options = {}) {
-    return this.client.request("GET", "/v1/credits/transactions", {
-      query: { limit: options.limit, cursor: options.cursor }
-    });
-  }
-  /**
-   * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
-   * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
-   * (the route's request limit). Preserves the `{ data, missing, errors }`
-   * fault-isolation shape verbatim (see {@link ModelCostsResult}).
-   */
-  modelCosts(ids) {
-    return this.client.request("POST", "/v1/credits/model-costs", {
-      body: { models: ids.slice(0, MODEL_COSTS_LIMIT) }
-    });
-  }
-  /**
-   * `POST /v1/credits/claim-signup-grant` → claims the account's free signup
-   * grant, once, with the browser signals of the page making the claim.
-   *
-   * Call it once per page load as soon as the session is known, and never
-   * wait on it for rendering: it is idempotent (a decided account answers
-   * with its state and `granted: false`), it costs the user nothing when it
-   * fails (the next load asks again), and the signals are what make the
-   * claim worth sending — collect them with `collectSignupKeys()` from
-   * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.
-   * Cloud-only route: a self-hosted instance answers 404.
-   */
-  claimSignupGrant(keys = {}) {
-    return this.client.request("POST", "/v1/credits/claim-signup-grant", {
-      body: keys
-    });
-  }
-  // NOTE: no `estimate(...)` helper. The backend exposes
-  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {
-  // totalCredits, nodeCount } }`), but no consumer has a settled shape for it
-  // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than
-  // calling an estimate endpoint). Adding it now would be inventing an API
-  // surface ahead of a real caller, so it's deliberately omitted — add it when
-  // a consumer needs it, shaped to that need.
-};
-
-// src/resources/uploads.ts
-var UploadsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
-   * field). The SDK's `request` detects the `FormData` body and lets the
-   * runtime set the multipart boundary. Returns the persisted asset's public
-   * URL + storage metadata (unwraps the `{ data }` envelope). Throws
-   * `StorageExceededError` (413) over the storage cap and the SDK's other typed
-   * errors on the usual statuses.
-   */
-  async upload(file) {
-    const form = new FormData();
-    form.append("file", file);
-    const res = await this.client.request(
-      "POST",
-      "/v1/upload",
-      { body: form }
-    );
-    return res.data;
-  }
-};
-
-// src/resources/library.ts
-var LibraryResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * `GET /v1/library` → a page of the caller's media assets (newest first) plus
-   * a `nextCursor`. Pass the returned `nextCursor` back as `cursor` for the next
-   * page. Filter by `type` and a filename `search`; `owned: true` returns the
-   * full Storage set (uploads + generations), the default only library-saved +
-   * shared items.
-   */
-  list(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.type) qs.set("type", params.type);
-    if (params.search) qs.set("search", params.search);
-    if (params.limit !== void 0) qs.set("limit", String(params.limit));
-    if (params.cursor) qs.set("cursor", params.cursor);
-    if (params.owned !== void 0) qs.set("owned", String(params.owned));
-    if (params.source) qs.set("source", params.source);
-    const query = qs.toString();
-    return this.client.request("GET", `/v1/library${query ? `?${query}` : ""}`);
-  }
-};
-
-// src/resources/node-presets.ts
-var PresetsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * `GET /v1/node-presets` → your custom presets, newest first. Pass `nodeType`
-   * (e.g. `"generate-image"`) to filter to one node type.
-   */
-  async list(nodeType) {
-    const qs = nodeType ? `?nodeType=${encodeURIComponent(nodeType)}` : "";
-    const res = await this.client.request("GET", `/v1/node-presets${qs}`);
-    return res.data;
-  }
-  /**
-   * `GET /v1/node-preset-groups` → your preset folders/sections, in display
-   * order. Pass `nodeType` to filter to one node type.
-   */
-  async listGroups(nodeType) {
-    const qs = nodeType ? `?nodeType=${encodeURIComponent(nodeType)}` : "";
-    const res = await this.client.request("GET", `/v1/node-preset-groups${qs}`);
-    return res.data;
-  }
-  /**
-   * `GET /v1/node-presets/factory` → the built-in catalog for `nodeType`. These
-   * ship with the app (no account needed to exist), so they're a good starting
-   * point for "what configs are available".
-   */
-  listFactory(nodeType) {
-    return this.client.request(
-      "GET",
-      `/v1/node-presets/factory?nodeType=${encodeURIComponent(nodeType)}`
-    );
-  }
-};
-
-// src/resources/saved-posts.ts
-var SavedPostsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
-  list(params = {}) {
-    return this.client.request("GET", "/v1/saved-posts", {
-      query: {
-        platform: params.platform,
-        tag: params.tag,
-        q: params.q,
-        cursor: params.cursor,
-        limit: params.limit
-      }
-    });
-  }
-  /**
-   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
-   * updates its note and tags (when given) and returns the existing save.
-   */
-  save(input) {
-    return this.client.request("POST", "/v1/saved-posts", { body: input });
-  }
-  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
-  lookup(postIds) {
-    return this.client.request("POST", "/v1/saved-posts/lookup", { body: { postIds } });
-  }
-  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
-  async delete(id) {
-    await this.client.request("DELETE", `/v1/saved-posts/${encodeURIComponent(id)}`);
-  }
-};
-
-// src/resources/collections.ts
-var CollectionsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** `GET /v1/collections` → your collections with their record counts, whether the server has collections at all, and your caps. */
-  list() {
-    return this.client.request("GET", "/v1/collections");
-  }
-  /** `GET /v1/collections/:id` → one collection. */
-  get(id) {
-    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}`);
-  }
-  /** `POST /v1/collections` → a new collection (`409 name_taken` when you have one by that name, `403 collection_limit_reached` at your cap). */
-  create(input) {
-    return this.client.request("POST", "/v1/collections", { body: input });
-  }
-  /** `PATCH /v1/collections/:id` → rename or re-describe a collection. */
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** `DELETE /v1/collections/:id` → remove a collection and every record in it. */
-  async delete(id) {
-    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}`);
-  }
-  /**
-   * `GET /v1/collections/:id/records` → the records, newest first (`order: "oldest"`
-   * flips it). Narrow with `q` (words), `since` / `until` (ISO) and `usage`
-   * (`all`, `unused` — not used yet — or `used`); page with `cursor` / `limit`
-   * (1-100, default 50). Each record carries `usedAt` / `usedBy`, and its
-   * `source` the saving workflow's name and project when it is yours.
-   */
-  records(id, params = {}) {
-    return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}/records`, {
-      query: {
-        q: params.q,
-        since: params.since,
-        until: params.until,
-        usage: params.usage,
-        status: params.status,
-        order: params.order,
-        cursor: params.cursor,
-        offset: params.offset,
-        limit: params.limit
-      }
-    });
-  }
-  /** `POST /v1/collections/:id/records/:recordId/restore` → bring a record back from the Trash; the record. */
-  restoreRecord(id, recordId) {
-    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/restore`);
-  }
-  /** `POST /v1/collections/:id/records/bulk` → move up to 100 records to the Trash, bring them back, or delete records already in the Trash for good, in one call. */
-  bulkRecords(id, input) {
-    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/bulk`, { body: input });
-  }
-  /**
-   * `PATCH /v1/collections/:id/records/:recordId` → mark a record used (or not
-   * used again). `source` says who is marking it (defaults to the API). A
-   * server before the usage release answers `503 not_available`.
-   */
-  setUsed(id, recordId, used, source) {
-    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`, {
-      body: { used, ...source ? { source } : {} }
-    });
-  }
-  /**
-   * `POST /v1/collections/:id/records` → save one record. Give the fields, or
-   * `item` (any JSON — a feed post, a search result) and let the server map it;
-   * explicit fields win. `outcome` is `inserted`, `duplicate` (the same link or
-   * dedupe key is already there — the existing record comes back) or `replayed`
-   * (a write with the same `idempotencyKey` already happened).
-   */
-  addRecord(id, input, opts = {}) {
-    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records`, {
-      body: input,
-      ...opts.idempotencyKey ? { headers: { "Idempotency-Key": opts.idempotencyKey } } : {}
-    });
-  }
-  /**
-   * `DELETE /v1/collections/:id/records/:recordId` → the record moves to the
-   * collection's Trash (`restoreRecord` brings it back; `deleteRecordForever`
-   * removes it for good).
-   */
-  async deleteRecord(id, recordId) {
-    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`);
-  }
-  /** `DELETE /v1/collections/:id/records/:recordId/permanent` → a record already in the Trash is deleted for good (`409 not_in_trash` for a live one). */
-  async deleteRecordForever(id, recordId) {
-    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/permanent`);
-  }
-  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since`, `until`, `usage` and `q` narrow it. */
-  export(id, params = {}) {
-    return this.client.requestText("GET", `/v1/collections/${encodeURIComponent(id)}/export`, {
-      query: { format: params.format, since: params.since, until: params.until, usage: params.usage, q: params.q }
-    });
-  }
-};
-
-// src/resources/competitors.ts
-var CompetitorsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** `GET /v1/competitors` → every tracked brand. */
-  async list() {
-    const res = await this.listWithPlan();
-    return [...res.data];
-  }
-  /** `GET /v1/competitors` → every tracked brand, with how many months of scans your plan keeps. */
-  listWithPlan() {
-    return this.client.request("GET", "/v1/competitors");
-  }
-  /**
-   * `GET /v1/competitors/:id` → one brand with its latest scan (posts and
-   * cards) and its scan history; with `scan`, the brand as of that scan.
-   */
-  get(id, options = {}) {
-    const query = options.scan ? `?scan=${encodeURIComponent(options.scan)}` : "";
-    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}${query}`);
-  }
-  /** `GET /v1/competitors/:id/history` → the brand's scans oldest first, per platform what each found and read (free). */
-  history(id) {
-    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/history`);
-  }
-  /**
-   * `GET /v1/competitors/:id/compare` → the brand over a period, and over a
-   * second one to compare with (free). A post belongs to a period by its
-   * publish date; a period is at most a year.
-   */
-  compare(id, input) {
-    const params = new URLSearchParams({ from: input.from, to: input.to });
-    if (input.vsFrom !== void 0 && input.vsTo !== void 0) {
-      params.set("vsFrom", input.vsFrom);
-      params.set("vsTo", input.vsTo);
-    }
-    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/compare?${params.toString()}`);
-  }
-  /** `POST /v1/competitors` → track a brand. Accounts take handles or links. */
-  create(input) {
-    return this.client.request("POST", "/v1/competitors", { body: input });
-  }
-  /**
-   * `PATCH /v1/competitors/:id` → change its accounts, platforms, name or schedule.
-   * `accounts` replaces the whole set: pass every account to keep. Send
-   * `schedule` only to change it (it restarts the brand's schedule). While a
-   * scan of the brand runs, a change to its name, accounts, platforms or
-   * `isOwn` is refused with `409 scan_running`.
-   */
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/competitors/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** `DELETE /v1/competitors/:id` → stop tracking it (its scans go too). */
-  async delete(id) {
-    await this.client.request("DELETE", `/v1/competitors/${encodeURIComponent(id)}`);
-  }
-  /** `GET /v1/competitors/cards` → every action card, most urgent first, with the posts they rest on. */
-  cards() {
-    return this.client.request("GET", "/v1/competitors/cards");
-  }
-  /**
-   * `GET /v1/competitors/:id/lessons` → what works for a brand: per platform,
-   * what its best posts share, measured on its own posts across every stored
-   * scan, with the posts each lesson rests on (free). "What works for you" on
-   * the brand marked as yours.
-   */
-  lessons(id) {
-    return this.client.request("GET", `/v1/competitors/${encodeURIComponent(id)}/lessons`);
-  }
-  /**
-   * `GET /v1/competitors/actions` → the cards you marked "I did this", newest
-   * first, each with how it went (`outcome`), and your track record per
-   * family of advice (free). Each scan of your own brand judges the post that
-   * came of a card once it is a few days old; the first verdict stays.
-   */
-  tried() {
-    return this.client.request("GET", "/v1/competitors/actions");
-  }
-  /**
-   * `POST /v1/competitors/actions` → "I did this" on a card on your wall (its
-   * `id` from `cards()`), optionally with the link to your post that came of
-   * it. Only cards whose advice ends in a post of yours can be marked
-   * (`400 not_measurable`). Marking a marked card returns its mark
-   * (`created: false`).
-   */
-  markDone(cardId, options = {}) {
-    return this.client.request("POST", "/v1/competitors/actions", { body: { cardId, ...options.postUrl ? { postUrl: options.postUrl } : {} } });
-  }
-  /**
-   * `PATCH /v1/competitors/actions/:id` → link the post that came of a marked
-   * card (the post's full link; a short link is refused with `400
-   * short_link`), or `null` to remove the link. Another post is judged afresh.
-   */
-  linkPost(markId, postUrl) {
-    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { postUrl } });
-  }
-  /** `PATCH /v1/competitors/actions/:id` with `seen: true` → you have seen its verdict (the app stops announcing it). */
-  markSeen(markId) {
-    return this.client.request("PATCH", `/v1/competitors/actions/${encodeURIComponent(markId)}`, { body: { seen: true } });
-  }
-  /** `DELETE /v1/competitors/actions/:id` → undo "I did this" (its verdict leaves your track record). */
-  async unmark(markId) {
-    await this.client.request("DELETE", `/v1/competitors/actions/${encodeURIComponent(markId)}`);
-  }
-  /** `POST /v1/competitor-discover` → a brand's accounts found from its website (free; guesses are marked). */
-  discover(website) {
-    return this.client.request("POST", "/v1/competitor-discover", { body: { website } });
-  }
-  /**
-   * `POST /v1/competitor-scan` → scan a brand now. Answers with a job id;
-   * poll `client.jobs.getStatus(jobId)`, then read `get(id)` or `cards()`.
-   */
-  scan(id) {
-    return this.client.request("POST", "/v1/competitor-scan", { body: { competitorId: id } });
-  }
-};
-
-// src/resources/picker-catalogs.ts
-var PickerCatalogsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** List every parameter-picker node type + its option count. Cached publicly 5 min. */
-  list() {
-    return this.client.request("GET", "/v1/picker-catalogs");
-  }
-  /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
-   *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
-  analyzeText(params) {
-    return this.client.request("POST", "/v1/text-to-picker", { body: params });
-  }
-  /** Get one picker's catalog of valid values. */
-  get(nodeType, opts = {}) {
-    const qs = new URLSearchParams();
-    if (opts.detail) qs.set("detail", opts.detail);
-    if (opts.category) qs.set("category", opts.category);
-    if (opts.field) qs.set("field", opts.field);
-    const query = qs.toString();
-    return this.client.request(
-      "GET",
-      `/v1/picker-catalogs/${encodeURIComponent(nodeType)}${query ? `?${query}` : ""}`
-    );
-  }
-};
-
-// src/resources/catalogs.ts
-var CatalogsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Every catalog, projected & pack-composed (honors the deployment's
-   *  registered vendored packs). Cached publicly 5 min. `data` is absent
-   *  when the deployment registered no packs (`curated: false`). */
-  list(opts = {}) {
-    const qs = opts.detail ? `?detail=${opts.detail}` : "";
-    return this.client.request("GET", `/v1/catalogs${qs}`);
-  }
-};
-
-// src/resources/models.ts
-var ModelsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Browse the models available on this instance — capability sheets,
-   *  per-variant credit pricing, prompt tips, and the `doctrineCovered`
-   *  truth flag. Public endpoint; cached 5 minutes. */
-  list(opts = {}) {
-    const qs = new URLSearchParams();
-    if (opts.kind) qs.set("kind", opts.kind);
-    if (opts.mode) qs.set("mode", opts.mode);
-    if (opts.family) qs.set("family", opts.family);
-    if (opts.featuredOnly) qs.set("featuredOnly", "true");
-    const query = qs.toString();
-    return this.client.request("GET", `/v1/models${query ? `?${query}` : ""}`);
-  }
-};
-
-// src/resources/shots.ts
-var ShotsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Create a shot record. Returns the new shot's id — an unguessable
-   *  capability string that doubles as the share-link path segment. */
-  create(input = {}) {
-    return this.client.request("POST", "/v1/shots", { body: input });
-  }
-  /** Read a shot. Public shots are readable by anyone holding the id;
-   *  private shots resolve only for their owner (404 otherwise). */
-  get(id) {
-    return this.client.request("GET", `/v1/shots/${encodeURIComponent(id)}`);
-  }
-  /** Update an owned shot (any subset of fields, e.g. a visibility toggle). */
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/shots/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** Delete an owned shot. */
-  async delete(id) {
-    await this.client.request("DELETE", `/v1/shots/${encodeURIComponent(id)}`);
-  }
-};
-
-// src/resources/recast.ts
-var RecastResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  // ── Authored-script lane (all three endpoints are free) ────────────────
-  /** The generated authoring guide (markdown): document contract, enum
-   *  vocabularies, bounds, audio rules, and a validated worked example. */
-  async authoringSkill() {
-    const res = await this.client.request(
-      "GET",
-      "/v1/video-analysis/authoring-skill"
-    );
-    return res.markdown ?? "";
-  }
-  /** FREE validation of an authored script. Loop until `valid: true`. */
-  validateScript(script) {
-    return this.client.request("POST", "/v1/video-analysis/import/validate", {
-      body: { script }
-    });
-  }
-  /**
-   * Import a VALIDATED authored script as a completed analysis job.
-   * `rightsAttested: true` is required (403 otherwise) — authored recasts
-   * render Faithful, exactly as written, so only import work you own.
-   */
-  importScript(script, opts) {
-    return this.client.request("POST", "/v1/video-analysis/import", {
-      body: { script, rightsAttested: opts.rightsAttested }
-    });
-  }
-  // ── Run lane ───────────────────────────────────────────────────────────
-  /** Quote a run (credits) before buying the plan. */
-  estimate(input) {
-    return this.client.request("POST", "/v1/recast/estimate", { body: input });
-  }
-  /** Create a run (buys the plan). Returns `{ recastId }`. */
-  create(input) {
-    return this.client.request("POST", "/v1/recast", { body: input });
-  }
-  /** Poll the run — status plus any pending interactive step. */
-  get(recastId) {
-    return this.client.request("GET", `/v1/recast/${encodeURIComponent(recastId)}`);
-  }
-  /** Quote a revisioned Music replacement and/or complete desired mix. Free. */
-  estimateRescore(recastId, input) {
-    return this.client.request(
-      "POST",
-      `/v1/recast/${encodeURIComponent(recastId)}/estimate-rescore`,
-      { body: input }
-    );
-  }
-  /** Apply a quoted audio operation. Reuse its request id only for a transport retry. */
-  rescore(recastId, input) {
-    return this.client.request(
-      "POST",
-      `/v1/recast/${encodeURIComponent(recastId)}/rescore`,
-      { body: input }
-    );
-  }
-  /** Start rendering a `planned` run. Idempotent server-side. */
-  start(recastId, opts = {}) {
-    return this.client.request("POST", `/v1/recast/${encodeURIComponent(recastId)}/start`, {
-      body: opts
-    });
-  }
-  /** Answer a pending interactive gate (the pick itself is free). */
-  resolveGate(recastId, input) {
-    return this.client.request("POST", `/v1/recast/${encodeURIComponent(recastId)}/select`, {
-      body: input
-    });
-  }
-};
-
-// src/resources/studio-productions.ts
-function isStudioGenerateEstimate(result) {
-  return result.dryRun === true;
-}
-var StudioProductionsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  path(productionId, suffix = "") {
-    return `/v1/studio/productions/${encodeURIComponent(productionId)}${suffix}`;
-  }
-  // ── reads ────────────────────────────────────────────────────────────────
-  /**
-   * The authoring guide, the full catalog, the plan's JSON Schema and the
-   * operating guide — rendered server-side from the version that is live, so
-   * they describe the platform you are actually talking to. Free.
-   */
-  async skill() {
-    const res = await this.client.request(
-      "GET",
-      "/v1/studio/productions/skill"
-    );
-    return res.data;
-  }
-  /**
-   * Check a plan before it becomes anything. Free, persists nothing, and
-   * resolves cast names against YOUR library — loop on `errors` until
-   * `valid: true`, then `create({ plan })`.
-   */
-  async validatePlan(plan) {
-    const res = await this.client.request(
-      "POST",
-      "/v1/studio/productions/validate",
-      { body: { plan } }
-    );
-    return res.data;
-  }
-  /** Your productions, newest first. Archived rows are hidden unless asked for. */
-  async list(opts = {}) {
-    const res = await this.client.request(
-      "GET",
-      "/v1/studio/productions",
-      {
-        query: {
-          limit: opts.limit,
-          cursor: opts.cursor,
-          includeArchived: opts.includeArchived
-        }
-      }
-    );
-    return res.data;
-  }
-  /**
-   * One production. A pure read — it never lands a finished job, so call
-   * {@link reconcile} first if you are waiting on one.
-   */
-  async get(productionId, opts = {}) {
-    const res = await this.client.request(
-      "GET",
-      this.path(productionId),
-      { query: { detail: opts.detail, shot_id: opts.shotId } }
-    );
-    return res.data.production;
-  }
-  /**
-   * The ordered steps that assemble the film, with what they will cost. Run
-   * them yourself with the ordinary verbs — nothing here blocks for minutes,
-   * and nothing here spends.
-   */
-  async exportPlan(productionId, opts = {}) {
-    const res = await this.client.request(
-      "GET",
-      this.path(productionId, "/export-plan"),
-      { query: { upscale: opts.upscale } }
-    );
-    return res.data;
-  }
-  // ── writes ───────────────────────────────────────────────────────────────
-  /** A new production, optionally landed from a plan in the same call. */
-  async create(input = {}) {
-    const res = await this.client.request(
-      "POST",
-      "/v1/studio/productions",
-      { body: input }
-    );
-    return res.data;
-  }
-  async ops(productionId, input) {
-    if (input.dryRun !== true) {
-      const res2 = await this.client.request(
-        "POST",
-        this.path(productionId, "/ops"),
-        { body: input }
-      );
-      return res2.data;
-    }
-    const ping = await this.client.request(
-      "POST",
-      this.path(productionId, "/ops"),
-      { body: { ops: [], dryRun: true } }
-    );
-    if (ping?.data?.dryRun !== true) throw new StudioPreviewUnavailable();
-    const res = await this.client.request("POST", this.path(productionId, "/ops"), { body: input });
-    const data = res?.data;
-    if (data?.dryRun !== true) {
-      throw new StudioPreviewAppliedError(data);
-    }
-    return data;
-  }
-  /**
-   * Land every generation that has finished since you last looked, and report
-   * what is still running. The one call that turns finished jobs into results
-   * without a browser open. It writes only when something actually landed.
-   */
-  async reconcile(productionId) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/reconcile")
-    );
-    return res.data;
-  }
-  /** Add a plan's scenes to a production that already exists. */
-  async importPlan(productionId, plan, opts = {}) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/import"),
-      { body: { plan, mode: opts.mode ?? "append" } }
-    );
-    return res.data;
-  }
-  /**
-   * Turn a brief into scenes. The run is a platform job: poll it, and its
-   * scenes land through {@link reconcile}. The production comes back with the
-   * run recorded on it as a pending draft.
-   */
-  async describe(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/describe"),
-      { body: input }
-    );
-    return res.data;
-  }
-  async generate(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/generate"),
-      { body: input }
-    );
-    return res.data;
-  }
-  generateStill(productionId, shotId, opts = {}) {
-    return this.generate(productionId, { ...opts, kind: "still", shotId });
-  }
-  generateClip(productionId, shotId, opts = {}) {
-    return this.generate(productionId, { ...opts, kind: "clip", shotId });
-  }
-  // ── media on one shot ────────────────────────────────────────────────────
-  /**
-   * Extract a frame from a shot's active clip and put it where `target` says —
-   * a new shot after this one (the default), this shot's sticky start or end
-   * frame, or another still of the same shot. Seconds, not minutes: this one
-   * waits for the job and answers with the changed production.
-   */
-  async frame(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/frame"),
-      { body: input }
-    );
-    return res.data;
-  }
-  /** Synthesize a shot's spoken line and record it. Waits for the job. */
-  async voice(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/voice"),
-      { body: input }
-    );
-    return res.data;
-  }
-  /**
-   * Recast the voices of a shot's active clip. Minutes of work, so it answers
-   * `jobId` and the new clip lands as a result through its own marker.
-   */
-  async revoice(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/revoice"),
-      { body: input }
-    );
-    return res.data;
-  }
-  /** Score the film. The finished track lands through its pending marker. */
-  async music(productionId, input) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/music"),
-      { body: input }
-    );
-    return res.data;
-  }
-  // ── audience and copies ──────────────────────────────────────────────────
-  /**
-   * Open the share-by-link read. Deliberately its own route rather than an
-   * operation: who may see the work is decided by the owner, never as a side
-   * effect of a batch that was editing something else.
-   */
-  async share(productionId) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/share"),
-      { body: { shared: true } }
-    );
-    return res.data.production;
-  }
-  /** Close it again. Sharing is opt-in AND reversible. */
-  async unshare(productionId) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/unshare")
-    );
-    return res.data.production;
-  }
-  /**
-   * Copy a production you own or can see into your own Studio project. The
-   * copy starts PRIVATE and visible — sharing and archiving never travel — and
-   * it is copied through YOUR view of the source, so somebody else's bin does
-   * not come with it.
-   */
-  async clone(productionId, input = {}) {
-    const res = await this.client.request(
-      "POST",
-      this.path(productionId, "/clone"),
-      { body: input }
-    );
-    return res.data.production;
-  }
-};
-
-// src/resources/studio.ts
-var root = "/v1/studio/productions";
-var path = (id) => `${root}/${encodeURIComponent(id)}`;
-var StudioResource = class {
-  constructor(client) {
-    this.client = client;
-    this.productions = new StudioProductionsResource(client);
-  }
-  client;
-  productions;
-  capabilities() {
-    return this.client.request("GET", `${root}/capabilities`);
-  }
-  skill() {
-    return this.client.request("GET", `${root}/skill`);
-  }
-  list(options = {}) {
-    return this.client.request("GET", root, { query: options });
-  }
-  get(id, options = {}) {
-    return this.client.request("GET", path(id), { query: { detail: options.detail, shot_id: options.shotId } });
-  }
-  validatePlan(plan) {
-    return this.client.request("POST", `${root}/validate`, { body: { plan } });
-  }
-  create(input) {
-    return this.client.request("POST", root, { body: input });
-  }
-  /** Import a portable document through the compatible server writer.
-   * Retained frame media requires an authorized source; acceptance never transfers. */
-  importBundle(input) {
-    return this.client.request("POST", `${root}/import-bundle`, { body: input });
-  }
-  /** Append a bundle's scenes and frame closure under an exact destination revision. */
-  appendBundle(id, input) {
-    return this.client.request("POST", `${path(id)}/import-bundle`, { body: input });
-  }
-  /** Copy a saved production. Linked copies retain verified inputs, remap
-   * dependencies and require fresh frame acceptance; they start no media jobs. */
-  clone(id, input = {}) {
-    return this.client.request("POST", `${path(id)}/clone`, { body: input });
-  }
-  edit(id, input) {
-    return this.client.request("POST", `${path(id)}/ops`, { body: input });
-  }
-  /** Audience-authorized sharing; an expected revision prevents publication
-   * of concurrent edits the caller has not reviewed. */
-  setShared(id, input) {
-    return this.client.request("POST", `${path(id)}/share`, { body: input });
-  }
-  /** Save ordinary editor fields against the loaded revision. Protected frame
-   * and job state can only change through their dedicated semantic actions. */
-  saveEditorState(id, input) {
-    return this.edit(id, {
-      baseVersion: input.expectedVersion,
-      strict: true,
-      ...input.clientRequestId ? { clientRequestId: input.clientRequestId } : {},
-      ops: [{ op: "save_editor_state", expectedVersion: input.expectedVersion, graph: input.graph }]
-    });
-  }
-  generateKeyframe(id, input) {
-    return this.client.request("POST", `${path(id)}/generate`, { body: { ...input, kind: "keyframe" } });
-  }
-  generateShot(id, input) {
-    return this.client.request("POST", `${path(id)}/generate`, { body: input });
-  }
-  /** A separate explicit review action; generation never calls this method. */
-  acceptKeyframe(id, input, concurrency = {}) {
-    return this.edit(id, { ...concurrency, ops: [{ ...input, op: "accept_keyframe_result" }] });
-  }
-  reconcile(id) {
-    return this.client.request("POST", `${path(id)}/reconcile`, { body: {} });
-  }
-};
-
-// src/resources/copilot.ts
-var COPILOT_FRAME_TYPES = /* @__PURE__ */ new Set([
-  "metadata",
-  "token",
-  "tool_call",
-  "workflow_updated",
-  "workflow_created",
-  "run_proposed",
-  "memory_saved",
-  "usage",
-  "done",
-  "error"
-]);
-function isCopilotFrame(value) {
-  if (typeof value !== "object" || value === null) return false;
-  const type = value.type;
-  return typeof type === "string" && COPILOT_FRAME_TYPES.has(type);
-}
-var CopilotResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on
-   * a workflow the server creates from `prompt`. Re-opening a workflow that
-   * already has an active thread answers THAT thread rather than a second one.
-   */
-  create(input) {
-    return this.client.request("POST", "/v1/copilot/threads", { body: input });
-  }
-  /**
-   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),
-   * or `null` when the user has none open on it.
-   */
-  list(params) {
-    return this.client.request("GET", "/v1/copilot/threads", { query: { workflowId: params.workflowId } });
-  }
-  /**
-   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads
-   * only what followed that sequence number (the panel's catch-up); `limit`
-   * caps the page at the server's own ceiling.
-   */
-  get(id, opts = {}) {
-    return this.client.request("GET", `/v1/copilot/threads/${encodeURIComponent(id)}`, {
-      query: { ...opts.after !== void 0 ? { after: opts.after } : {}, ...opts.limit !== void 0 ? { limit: opts.limit } : {} }
-    });
-  }
-  /**
-   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not
-   * deletion — the messages stay readable. Refused while a turn is running.
-   */
-  archive(id) {
-    return this.client.request("DELETE", `/v1/copilot/threads/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the
-   * turn it asked to stop; the turn's own stream ends with a `done` frame.
-   */
-  cancel(id) {
-    return this.client.request("POST", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`);
-  }
-  /**
-   * Send one message and iterate the turn's frames
-   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).
-   *
-   * Deliberately NOT routed through `client.request`: that path arms an abort
-   * timer around the whole exchange, and a turn legitimately runs for minutes —
-   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller
-   * owns the lifetime instead: pass `signal` to end the stream, or stop
-   * iterating (the reader cancels the body, which ends the request).
-   *
-   * A frame kind this package does not model is skipped rather than thrown, so
-   * a newer server cannot break an older caller.
-   */
-  async *stream(threadId, opts) {
-    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`;
-    const token = await this.client.auth.getToken();
-    const res = await this.client.fetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        ...token ? { Authorization: `Bearer ${token}` } : {}
-      },
-      body: JSON.stringify({
-        message: opts.message,
-        ...opts.baseVersion !== void 0 ? { baseVersion: opts.baseVersion } : {},
-        ...opts.tier ? { tier: opts.tier } : {}
-      }),
-      signal: opts.signal
-    });
-    for await (const value of readSseStream(res, { label: "copilot stream" })) {
-      if (isCopilotFrame(value)) yield value;
-    }
-  }
-};
-
-// src/resources/community.ts
-var CommunityResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * `GET /v1/community/browse` → a page of public listings plus a `nextCursor`.
-   * Pass the returned `nextCursor` back as `cursor` to fetch the next page.
-   */
-  browse(params = {}) {
-    const qs = new URLSearchParams();
-    if (params.entityType) qs.set("entityType", params.entityType);
-    if (params.q) qs.set("q", params.q);
-    if (params.category) qs.set("category", params.category);
-    if (params.sort) qs.set("sort", params.sort);
-    if (params.cursor) qs.set("cursor", params.cursor);
-    if (params.limit !== void 0) qs.set("limit", String(params.limit));
-    const query = qs.toString();
-    return this.client.request(
-      "GET",
-      `/v1/community/browse${query ? `?${query}` : ""}`
-    );
-  }
-  /** `GET /v1/community/detail/:slug` → a single listing by its slug. */
-  get(slug) {
-    return this.client.request(
-      "GET",
-      `/v1/community/detail/${encodeURIComponent(slug)}`
-    );
-  }
-  /**
-   * `GET /v1/community/detail/:slug/full` → the full read-only detail (card
-   * identity + the stored public snapshot). Like {@link get}, but includes the
-   * snapshot asset/voice/text blob needed to render the full cross-user view.
-   */
-  getFull(slug) {
-    return this.client.request(
-      "GET",
-      `/v1/community/detail/${encodeURIComponent(slug)}/full`
-    );
-  }
-  /** `GET /v1/community/favorites` → the listings you've favorited. */
-  favorites() {
-    return this.client.request("GET", "/v1/community/favorites");
-  }
-  /**
-   * `POST /v1/community/listings/:id/clone` → copy a listing into your library.
-   * Returns the new asset's `entityType` and `id`. Requires the `assets:write`
-   * scope when called with an OAuth app token.
-   */
-  clone(id, entityType) {
-    return this.client.request(
-      "POST",
-      `/v1/community/listings/${encodeURIComponent(id)}/clone`,
-      { body: { entityType } }
-    );
-  }
-  /**
-   * `POST /v1/community/listings/:id/favorite` → toggle a favorite. Returns the
-   * resulting `favorited` state (`true` after adding, `false` after removing).
-   */
-  favorite(id) {
-    return this.client.request(
-      "POST",
-      `/v1/community/listings/${encodeURIComponent(id)}/favorite`
-    );
-  }
-  /**
-   * `POST /v1/community/listings/:id/report` → flag a listing for moderation.
-   * `reason` must be one of {@link CommunityReportReason}.
-   */
-  report(id, reason) {
-    return this.client.request(
-      "POST",
-      `/v1/community/listings/${encodeURIComponent(id)}/report`,
-      { body: { reason } }
-    );
-  }
-  /**
-   * `POST /v1/admin/community/:entityType/:id/publish` → share one of YOUR
-   * entities to the community, returning the new listing's `slug` + `id`.
-   *
-   * **Requires an admin token** (the route is `requireAdmin`) AND the caller
-   * must own the source entity. Personal/OAuth tokens without admin role get a
-   * 401. For `character` listings, `params.likenessAttestation` must be `true`.
-   */
-  publish(entityType, entityId, params) {
-    return this.client.request(
-      "POST",
-      `/v1/admin/community/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}/publish`,
-      { body: params }
-    );
-  }
-  /**
-   * `DELETE /v1/admin/community/listings/:id` → unshare (deactivate) a listing
-   * you published. **Requires an admin token** (the route is `requireAdmin`).
-   */
-  unpublish(listingId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/admin/community/listings/${encodeURIComponent(listingId)}`
-    );
-  }
-  /**
-   * `GET /v1/admin/community/by-source/:entityType/:sourceId` → look up YOUR
-   * existing listing (if any) for a source entity. Returns `{ data: null }`
-   * when the entity hasn't been shared. **Requires an admin token** (the route
-   * is `requireAdmin`); only returns listings created by the caller.
-   */
-  sharedListing(entityType, sourceId) {
-    return this.client.request(
-      "GET",
-      `/v1/admin/community/by-source/${encodeURIComponent(entityType)}/${encodeURIComponent(sourceId)}`
-    );
-  }
-};
-
-// src/resources/templates.ts
-var TemplatesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** Browse the public template marketplace (cursor-paginated, no auth required). */
-  browse(params = {}) {
-    return this.client.request("GET", "/v1/templates/browse", { query: { ...params } });
-  }
-  /** Fetch one public template by slug, including its full workflow snapshot. */
-  get(slug) {
-    return this.client.request("GET", `/v1/templates/${encodeURIComponent(slug)}`);
-  }
-  /** Clone a template into one of the caller's projects. Free — no credits charged. */
-  clone(slug, params) {
-    return this.client.request("POST", `/v1/templates/${encodeURIComponent(slug)}/clone`, {
-      body: params
-    });
-  }
-};
-
-// src/resources/tutorials.ts
-var TutorialsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** All enabled tutorial categories with their videos and flow tutorials. Public. */
-  list() {
-    return this.client.request("GET", "/v1/tutorials");
-  }
-};
-
-// src/resources/organizations.ts
-var OrganizationsResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /** The organizations this account belongs to. */
-  list() {
-    return this.client.request("GET", "/v1/orgs");
-  }
-  get(id) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(id)}`);
-  }
-  /**
-   * Create an organization. On instances that require it, `acceptTerms` must
-   * be true or the server answers `terms_required` — the SDK does not decide
-   * whether terms apply, because only the instance knows.
-   *
-   * A new organization may come back `pending`: some instances hold new
-   * organizations for a platform admin to approve, and a pending one grants
-   * nothing until it is active.
-   */
-  create(input) {
-    return this.client.request("POST", "/v1/orgs", { body: input });
-  }
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/orgs/${encodeURIComponent(id)}`, { body: input });
-  }
-  /** Soft-delete. The organization stops granting context; nothing is destroyed. */
-  delete(id) {
-    return this.client.request("DELETE", `/v1/orgs/${encodeURIComponent(id)}`);
-  }
-  /** Hand the organization to another member. The caller becomes an admin. */
-  transferOwnership(id, userId) {
-    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(id)}/transfer-ownership`, {
-      body: { userId }
-    });
-  }
-  /** Leave. An owner cannot — transfer ownership first (`owner_cannot_leave`). */
-  leave(id) {
-    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(id)}/leave`);
-  }
-  // -- members --------------------------------------------------------------
-  listMembers(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/members`, { query: { ...opts } });
-  }
-  updateMember(orgId, userId, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`,
-      { body: input }
-    );
-  }
-  removeMember(orgId, userId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/orgs/${encodeURIComponent(orgId)}/members/${encodeURIComponent(userId)}`
-    );
-  }
-  // -- invitations ----------------------------------------------------------
-  /**
-   * Invite by email. Returns ONE ROW PER ADDRESS, and a row whose `status` is
-   * not `sent` carries a `link` instead.
-   *
-   * Surface that link. An install with no mail provider — every fresh
-   * self-host — delivers nothing, and an integration that reports "invited"
-   * without showing the link creates invitations nobody can ever reach.
-   */
-  invite(orgId, input) {
-    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(orgId)}/invitations`, { body: input });
-  }
-  listInvitations(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/invitations`, {
-      query: { ...opts }
-    });
-  }
-  revokeInvitation(id) {
-    return this.client.request("DELETE", `/v1/invitations/${encodeURIComponent(id)}`);
-  }
-  resendInvitation(id) {
-    return this.client.request("POST", `/v1/invitations/${encodeURIComponent(id)}/resend`);
-  }
-  /**
-   * What an invitee sees before signing in — the one organization read that
-   * needs no token, so it works while the recipient is still signed out.
-   */
-  previewInvitation(token) {
-    return this.client.request("GET", `/v1/invitations/by-token/${encodeURIComponent(token)}`);
-  }
-  /** Accept. Requires an authenticated caller whose email matches the invite. */
-  acceptInvitation(token) {
-    return this.client.request("POST", `/v1/invitations/${encodeURIComponent(token)}/accept`);
-  }
-  // -- audit ----------------------------------------------------------------
-  /**
-   * The organization's audit log, newest first. Owner and admins only, and
-   * readable while the organization is suspended — the record of what
-   * happened is exactly what someone needs when things have gone wrong.
-   */
-  audit(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/audit`, { query: { ...opts } });
-  }
-  // -- usage ----------------------------------------------------------------
-  /**
-   * Credits by workspace, member, model or day. Owner and org admins only.
-   * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
-   * (default last 30).
-   */
-  usage(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts } });
-  }
-  /** The individual runs behind a report, newest first, cursor-paged. */
-  usageRows(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, groupBy: "none" } });
-  }
-  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
-  usageCsv(orgId, opts = {}) {
-    return this.client.requestText("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, format: "csv" } });
-  }
-};
-
-// src/resources/workspaces.ts
-var WorkspacesResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Every workspace this account belongs to, across all its organizations.
-   *
-   * An identity read: a stale workspace binding cannot lock a caller out of
-   * it, which is what makes it safe to call when a selection has gone bad.
-   *
-   * Byte-for-byte the list `GET /v1/me` carries, so a client reconciles
-   * against one truth rather than two. That is why these are SUMMARIES —
-   * enough to render a switcher, not the full view; use {@link get} for that.
-   */
-  list() {
-    return this.client.request("GET", "/v1/workspaces");
-  }
-  listForOrg(orgId, opts = {}) {
-    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, {
-      query: { includeArchived: opts.includeArchived }
-    });
-  }
-  get(id) {
-    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}`);
-  }
-  create(orgId, input) {
-    return this.client.request("POST", `/v1/orgs/${encodeURIComponent(orgId)}/workspaces`, { body: input });
-  }
-  update(id, input) {
-    return this.client.request("PATCH", `/v1/workspaces/${encodeURIComponent(id)}`, { body: input });
-  }
-  /**
-   * Archive or restore. Archiving is REVERSIBLE and destroys nothing: the
-   * workspace stops accepting new work and stays fully readable, which is
-   * what a finished class term needs and a delete would not survive.
-   */
-  setArchived(id, archived) {
-    return this.client.request(
-      "POST",
-      `/v1/workspaces/${encodeURIComponent(id)}/${archived ? "archive" : "unarchive"}`
-    );
-  }
-  // -- members --------------------------------------------------------------
-  listMembers(id, opts = {}) {
-    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/members`, {
-      query: { ...opts }
-    });
-  }
-  /** Add someone who is ALREADY in the organization. To bring in a new person, invite them. */
-  addMember(id, input) {
-    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/members`, { body: input });
-  }
-  updateMember(id, userId, input) {
-    return this.client.request(
-      "PATCH",
-      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`,
-      { body: input }
-    );
-  }
-  removeMember(id, userId) {
-    return this.client.request(
-      "DELETE",
-      `/v1/workspaces/${encodeURIComponent(id)}/members/${encodeURIComponent(userId)}`
-    );
-  }
-  // -- join codes -----------------------------------------------------------
-  /** The workspace's join code, or `null` if none has been created. Admins only. */
-  getJoinCode(id) {
-    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/join-code`);
-  }
-  /**
-   * Rotate, enable or disable the code. Rotating invalidates the old one
-   * immediately — that is the point of it, and anyone still holding a link
-   * with the old code will be refused.
-   */
-  actOnJoinCode(id, action) {
-    return this.client.request("POST", `/v1/workspaces/${encodeURIComponent(id)}/join-code`, {
-      body: { action }
-    });
-  }
-  /**
-   * Join by code. Another way IN, so a stale workspace binding must not block
-   * it — the server treats this as an identity route for that reason.
-   */
-  join(code) {
-    return this.client.request("POST", "/v1/workspaces/join", { body: { code } });
-  }
-  // -- usage ----------------------------------------------------------------
-  /**
-   * Credits by member, model or day for this workspace. A plain member sees
-   * their OWN runs (the report is self-narrowed and `groupBy: "member"` is
-   * refused); a workspace admin sees everyone and may filter `userId`.
-   * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).
-   */
-  usage(id, opts = {}) {
-    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts } });
-  }
-  /** The individual runs behind a report, newest first, cursor-paged. */
-  usageRows(id, opts = {}) {
-    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, groupBy: "none" } });
-  }
-  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
-  usageCsv(id, opts = {}) {
-    return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
-  }
-};
-function tightenBody(input) {
-  const { mediaUrl, ...rest } = input;
-  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)) };
-}
-function idempotencyHeaders(options) {
-  return options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {};
-}
-var EditResource = class {
-  constructor(client) {
-    this.client = client;
-  }
-  client;
-  /**
-   * Detect silence ranges in an audio/video source (`POST /v1/silence-detect`).
-   * Keyless — one ffmpeg pass over the source's audio proxy.
-   */
-  silenceDetect(input) {
-    return this.client.request("POST", "/v1/silence-detect", {
-      body: {
-        audioUrl: input.audioUrl,
-        ...input.thresholdDb !== void 0 ? { thresholdDb: input.thresholdDb } : {},
-        ...input.minSilenceMs !== void 0 ? { minSilenceMs: input.minSilenceMs } : {},
-        ...input.padMs !== void 0 ? { padMs: input.padMs } : {},
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-  /**
-   * Measure how far apart the clocks of 2–6 recordings of one conversation are
-   * (`POST /v1/audio-sync`), by cross-correlating their audio — keyless, one
-   * ffmpeg decode per source. The finished job's `output_data.json` is an
-   * {@link AudioSyncResult}. A malformed request (fewer than 2 or more than 6
-   * sources, a repeated id, a `reference` that is not one of the ids) throws a
-   * typed `NodaroError` (400, `code: "validation_error"`) before any credits
-   * are reserved.
-   */
-  audioSync(input) {
-    return this.client.request("POST", "/v1/audio-sync", {
-      body: {
-        sources: input.sources.map((s) => ({ id: s.id, url: s.url })),
-        ...input.reference !== void 0 ? { reference: input.reference } : {},
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-  /**
-   * Render an edit decision list into a video or audio cut (`POST /v1/apply-edl`).
-   * The EDL is validated at ingress — an unresolvable source or a picture-less
-   * segment on a video edit throws a typed `NodaroError` (400, `code:
-   * "invalid_edl"`) before any credits are reserved.
-   */
-  applyEdl(input) {
-    return this.client.request("POST", "/v1/apply-edl", {
-      body: {
-        edl: input.edl,
-        ...input.sources !== void 0 ? { sources: input.sources } : {},
-        ...input.transcript !== void 0 ? { transcript: input.transcript } : {},
-        ...input.output !== void 0 ? { output: input.output } : {},
-        ...input.quality !== void 0 ? { quality: input.quality } : {},
-        ...input.crossfadeMs !== void 0 ? { crossfadeMs: input.crossfadeMs } : {},
-        ...input.clipKey !== void 0 ? { clipKey: input.clipKey } : {},
-        ...input.planBasis !== void 0 ? { planBasis: input.planBasis } : {},
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-  /**
-   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording
-   * in one call — transcribe, cut the silences and filler, render, with
-   * optional captions, music and framing. Answers the run's job to poll; its
-   * `output_data` holds the episode. The run is priced as its steps at their own
-   * rates plus the listed per-run fee. Quote it first with
-   * {@link estimateTightenEpisode}.
-   */
-  tightenEpisode(input, options) {
-    return this.client.request("POST", "/v1/tighten-episode", { body: tightenBody(input), ...idempotencyHeaders(options) });
-  }
-  /**
-   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):
-   * its steps at their own rates plus its per-run fee. Nothing is created or
-   * charged. The estimate leans high: the render is priced at the recording's
-   * full length, while the charge follows the minutes actually rendered.
-   */
-  estimateTightenEpisode(input) {
-    return this.client.request("POST", "/v1/tighten-episode/estimate", { body: tightenBody(input) });
-  }
-  /**
-   * Continue a Tighten Episode run as a new job (`POST /v1/tighten-episode/continue`):
-   * `"from-failed"` keeps the steps that finished and runs the rest (the fee is
-   * held again; the failed run's was refunded); `"render-final"` renders the
-   * full-quality episode after a review-on preview, with the preview's
-   * settings and no fee. A refusal that names another job
-   * (`already_running`, `continuation_superseded`,
-   * `render_final_already_rendered`) throws a `ContinuationRefusedError`
-   * carrying that `jobId`.
-   */
-  continueUseCase(input, options) {
-    return this.client.request("POST", "/v1/tighten-episode/continue", {
-      body: { jobId: input.jobId, mode: input.mode, ...input.editedEdl !== void 0 ? { editedEdl: input.editedEdl } : {} },
-      ...idempotencyHeaders(options)
-    });
-  }
-  /**
-   * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
-   * transcript (plus optional silence ranges) and the media sources, and plans
-   * the edit. The finished job's `output_data` holds the plan: an `Edl`
-   * (`"tighten"` or `"trailer"`), an {@link EdlClipSet} (`"clips"`), or a
-   * {@link ChapterSet} (`"chapters"`) — normalize it with {@link unwrapEditPlanOutput}.
-   *
-   * On a self-hosted install the request relays to nodaro.ai and needs the
-   * install connected (a 503 `code: "nodaro_connection_required"` otherwise);
-   * on nodaro.ai it runs directly.
-   */
-  editPlan(input) {
-    const planned = resolveEditPlanSources(input.sources, {
-      offsets: input.offsets,
-      transcriptSourceId: input.transcriptSourceId
-    });
-    if (!planned.ok) {
-      const message = planned.issues.map((issue) => describeAudioSyncOffsetIssue(issue)).join("; ");
-      return Promise.reject(new NodaroError(`editPlan: ${message}`, "edit_plan_sources", 400));
-    }
-    const transcript = planned.transcriptSourceId ? { ...input.transcript, sourceId: planned.transcriptSourceId } : input.transcript;
-    return this.client.request("POST", "/v1/edit-plan", {
-      body: {
-        mode: input.mode,
-        planTier: input.planTier,
-        transcript,
-        sources: planned.sources,
-        ...input.silence !== void 0 ? { silence: input.silence } : {},
-        ...input.instructions !== void 0 ? { instructions: input.instructions } : {},
-        ...input.styleGuide !== void 0 ? { styleGuide: input.styleGuide } : {},
-        ...input.count !== void 0 ? { count: input.count } : {},
-        ...input.targetDurationSec !== void 0 ? { targetDurationSec: input.targetDurationSec } : {},
-        ...input.targetAspect !== void 0 ? { targetAspect: input.targetAspect } : {},
-        ...input.platform !== void 0 ? { platform: input.platform } : {},
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-  /**
-   * Camera Switch (podcast B5): choose which camera shows each cut of `edl`
-   * by who is speaking — the sound never changes. Cloud edition; a flat
-   * price. The finished job's `output_data.json` is the switched EDL (feed it
-   * to {@link applyEdl}) and `output_data.transcript` the transcript with
-   * `speakerNames` applied. A transcript with no speaker labels rejects with
-   * a {@link NodaroError} (`code: "no_speakers"`) before any request or charge.
-   */
-  cameraSwitch(input) {
-    if (transcriptSpeakerLabels(input.transcript).length === 0) {
-      return Promise.reject(new NodaroError(
-        "cameraSwitch: the transcript has no speaker labels \u2014 transcribe with speaker detection on",
-        "no_speakers",
-        422
-      ));
-    }
-    return this.client.request("POST", "/v1/camera-switch", {
-      body: {
-        edl: input.edl,
-        transcript: input.transcript,
-        ...input.speakerMap !== void 0 ? { speakerMap: input.speakerMap } : {},
-        ...input.speakerNames !== void 0 ? { speakerNames: input.speakerNames } : {},
-        ...input.minShotMs !== void 0 ? { minShotMs: input.minShotMs } : {},
-        ...input.leadMs !== void 0 ? { leadMs: input.leadMs } : {},
-        ...input.maxShotMs !== void 0 ? { maxShotMs: input.maxShotMs } : {},
-        ...input.wideEvery !== void 0 ? { wideEvery: input.wideEvery } : {},
-        ...input.layoutHints !== void 0 ? { layoutHints: input.layoutHints } : {},
-        ...input.workflowId !== void 0 ? { workflowId: input.workflowId } : {}
-      }
-    });
-  }
-  /**
-   * Remap a transcript through an EDL — a PURE client-side transform (NO
-   * request). Returns a new transcript whose word (and segment) timings are on
-   * the EDL's rendered output clock, dropping words that fall in cut regions and
-   * clipping straddlers. Runs `@nodaro/shared`'s canonical
-   * `remapTranscriptThroughEdl`, the same remap `applyEdl` performs server-side.
-   */
-  remapTranscript(edl, transcript) {
-    return remapTranscriptThroughEdl(edl, transcript);
-  }
-};
-var SDK_VERSION = "2.28.0" ;
-var CLIENT_HEADER = "X-Nodaro-Client";
-var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
-var NodaroClient = class _NodaroClient {
-  baseUrl;
-  auth;
-  timeoutMs;
-  /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
-  clientLabel;
-  /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
-  sendClientHeader;
-  fetchOverride;
-  /**
-   * Resolved lazily so consumers can swap `globalThis.fetch` after the
-   * client has been constructed (e.g. test mocks). Always rebound to the
-   * global object — native fetch throws "Illegal invocation" when its
-   * `this` is anything else.
-   */
-  get fetch() {
-    return this.fetchOverride ?? globalThis.fetch.bind(globalThis);
-  }
-  workflows;
-  projects;
-  /** Generation sessions inside projects (Create Image / Video / Music). */
-  sessions;
-  jobs;
-  videoPro;
-  executions;
-  nodes;
-  scene3d;
-  developerApps;
-  oauth;
-  apps;
-  characters;
-  locations;
-  objects;
-  creatures;
-  pipelines;
-  reduce;
-  promptHelper;
-  voices;
-  llm;
-  media;
-  audio;
-  credits;
-  uploads;
-  library;
-  presets;
-  savedPosts;
-  collections;
-  competitors;
-  pickerCatalogs;
-  catalogs;
-  models;
-  shots;
-  recast;
-  studio;
-  copilot;
-  community;
-  templates;
-  tutorials;
-  organizations;
-  workspaces;
-  edit;
-  /** The workspace this client acts in; undefined = the personal space. */
-  workspaceId;
-  constructor(opts) {
-    this.baseUrl = opts.baseUrl.replace(/\/$/, "");
-    this.auth = opts.auth;
-    this.fetchOverride = opts.fetch;
-    this.timeoutMs = opts.timeoutMs ?? 6e4;
-    this.clientLabel = opts.clientLabel ?? `sdk/${SDK_VERSION}`;
-    this.workspaceId = opts.workspaceId;
-    this.sendClientHeader = opts.clientLabel !== void 0 || !isBrowser();
-    this.workflows = new WorkflowsResource(this);
-    this.projects = new ProjectsResource(this);
-    this.sessions = new SessionsResource(this);
-    this.jobs = new JobsResource(this);
-    this.videoPro = new VideoProResource(this);
-    this.executions = new ExecutionsResource(this);
-    this.nodes = new NodesResource(this);
-    this.scene3d = new Scene3DResource(this);
-    this.developerApps = new DeveloperAppsResource(this);
-    this.oauth = new OAuthResource(this);
-    this.apps = new AppsResource(this);
-    this.characters = new CharactersResource(this);
-    this.locations = new LocationsResource(this);
-    this.objects = new ObjectsResource(this);
-    this.creatures = new CreaturesResource(this);
-    this.pipelines = new PipelinesResource(this);
-    this.reduce = new ReduceResource(this);
-    this.promptHelper = new PromptHelperResource(this);
-    this.voices = new VoicesResource(this);
-    this.llm = new LlmResource(this);
-    this.media = new MediaResource(this);
-    this.audio = new AudioResource(this);
-    this.credits = new CreditsResource(this);
-    this.uploads = new UploadsResource(this);
-    this.library = new LibraryResource(this);
-    this.presets = new PresetsResource(this);
-    this.savedPosts = new SavedPostsResource(this);
-    this.collections = new CollectionsResource(this);
-    this.competitors = new CompetitorsResource(this);
-    this.pickerCatalogs = new PickerCatalogsResource(this);
-    this.catalogs = new CatalogsResource(this);
-    this.models = new ModelsResource(this);
-    this.shots = new ShotsResource(this);
-    this.recast = new RecastResource(this);
-    this.studio = new StudioResource(this);
-    this.copilot = new CopilotResource(this);
-    this.community = new CommunityResource(this);
-    this.templates = new TemplatesResource(this);
-    this.tutorials = new TutorialsResource(this);
-    this.organizations = new OrganizationsResource(this);
-    this.workspaces = new WorkspacesResource(this);
-    this.edit = new EditResource(this);
-  }
-  /**
-   * A client that acts in `workspaceId`, sharing this one's auth and config.
-   *
-   * A NEW client rather than a setter, deliberately. A mutable selection is
-   * the bug this whole axis exists to prevent: two concurrent operations
-   * against one client would race over which workspace they were in, and the
-   * loser would create work in the wrong place with nothing failing. A
-   * per-workspace client cannot be raced.
-   *
-   * Pass `null` for the personal space.
-   */
-  withWorkspace(workspaceId) {
-    return new _NodaroClient({
-      baseUrl: this.baseUrl,
-      auth: this.auth,
-      timeoutMs: this.timeoutMs,
-      ...this.fetchOverride ? { fetch: this.fetchOverride } : {},
-      ...this.sendClientHeader ? { clientLabel: this.clientLabel } : {},
-      ...workspaceId ? { workspaceId } : {}
-    });
-  }
-  /**
-   * The transport: build the request, send it, throw the typed error on a
-   * non-2xx via {@link throwFromResponse}, then read the body via `read` — all
-   * inside the abort timer, so `timeoutMs` bounds the body download too (a
-   * stalled CSV stream aborts, it does not hang forever). Both the JSON path
-   * ({@link request}) and the text path ({@link requestText}) go through here.
-   */
-  async send(method, path2, options, read) {
-    const url = this.buildUrl(path2, options.query);
-    const token = await this.auth.getToken();
-    const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
-    const headers = {
-      ...isFormData ? {} : { "Content-Type": "application/json" },
-      ...this.sendClientHeader ? { [CLIENT_HEADER]: this.clientLabel } : {},
-      // Before per-request headers: a resource that needs to reach outside
-      // this client's workspace says so explicitly and wins.
-      ...this.workspaceId ? { [WORKSPACE_HEADER]: this.workspaceId } : {},
-      ...options.headers ?? {}
-    };
-    if (token) headers["Authorization"] = `Bearer ${token}`;
-    const ac = new AbortController();
-    const timeoutId = setTimeout(() => ac.abort(), this.timeoutMs);
-    const abort = () => ac.abort(options.signal?.reason);
-    options.signal?.addEventListener("abort", abort, { once: true });
-    if (options.signal?.aborted) abort();
-    try {
-      ac.signal.throwIfAborted();
-      const res = await this.fetch(url, {
-        method,
-        headers,
-        body: options.body === void 0 ? void 0 : isFormData ? options.body : JSON.stringify(options.body),
-        signal: ac.signal
-      });
-      if (!res.ok) {
-        let errBody = {};
-        try {
-          errBody = await res.json();
-        } catch {
-        }
-        throwFromResponse(res.status, errBody);
-      }
-      return await read(res);
-    } finally {
-      clearTimeout(timeoutId);
-      options.signal?.removeEventListener("abort", abort);
-    }
-  }
-  /** Authenticated, bounded binary reads through the normal timeout/error transport. */
-  async requestBytes(method, path2, options) {
-    if (!Number.isSafeInteger(options.maxBytes) || options.maxBytes < 1) throw new Error("maxBytes must be a positive integer");
-    return this.send(method, path2, options, (response) => readBinaryResponse(response, options.maxBytes));
-  }
-  async request(method, path2, options = {}) {
-    return this.send(
-      method,
-      path2,
-      options,
-      async (res) => (
-        // 204 No Content
-        res.status === 204 ? void 0 : await res.json()
-      )
-    );
-  }
-  /**
-   * Like {@link request}, for endpoints that answer text (CSV exports). Errors
-   * are still the JSON envelope and throw the same typed errors, and the read is
-   * bounded by the same timeout as the request.
-   */
-  async requestText(method, path2, options = {}) {
-    return this.send(method, path2, options, (res) => res.text());
-  }
-  /**
-   * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
-   * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
-   * token is missing/invalid, and the SDK's other typed errors as usual.
-   *
-   * On an instance with organizations it also carries what the caller belongs
-   * to. THREE states, and collapsing them is wrong in a way users feel: the
-   * organization fields ABSENT means this instance has no organizations at
-   * all; present and empty means the account belongs to none; and
-   * `organizationsUnavailable` means the lookup failed — keep whatever
-   * selection you already had rather than concluding the person was removed
-   * from everything.
-   */
-  async me() {
-    const res = await this.request("GET", "/v1/me");
-    return res.data;
-  }
-  buildUrl(path2, query) {
-    const base = this.baseUrl || (typeof window !== "undefined" ? window.location.origin : "http://placeholder");
-    const url = new URL(path2, base);
-    const fullUrl = this.baseUrl ? url.toString() : url.pathname + url.search;
-    if (query) {
-      const u = new URL(this.baseUrl ? fullUrl : fullUrl, base);
-      for (const [k, v] of Object.entries(query)) {
-        if (v !== void 0) u.searchParams.set(k, String(v));
-      }
-      return this.baseUrl ? u.toString() : u.pathname + u.search;
-    }
-    return fullUrl;
-  }
-};
-function createClient(opts) {
-  return new NodaroClient(opts);
-}
-
-// src/auth.ts
-var StaticTokenAuth = class {
-  constructor(token) {
-    this.token = token;
-  }
-  token;
-  async getToken() {
-    return this.token;
-  }
-};
-var CallbackAuth = class {
-  constructor(fn) {
-    this.fn = fn;
-  }
-  fn;
-  async getToken() {
-    return this.fn();
-  }
-};
-function supabaseAuth(supabase) {
-  return {
-    async getToken() {
-      const { data } = await supabase.auth.getSession();
-      return data.session?.access_token ?? null;
-    }
-  };
-}
-
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CollectionsResource, CommunityResource, CompetitorsResource, ContinuationRefusedError, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, EditResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, SavedPostsResource, Scene3DResource, SessionsResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { WebhookSignatureError, verifyWebhookSignature } from './chunk-VGTRKXF2.js';
+import './chunk-PGYQ754I.js';
+import './chunk-FHEYAW5H.js';
+import './chunk-D3PW7AHZ.js';
+import './chunk-BKP6F2IX.js';
+import './chunk-PMTM26LL.js';
+import './chunk-LHRQXWI5.js';
+import './chunk-VT237QF2.js';
+import './chunk-CGNVHN4V.js';
+import './chunk-VPAUN75Q.js';
+import './chunk-MEKI37WI.js';
+import './chunk-QVQCKOBM.js';
+import './chunk-IQ6KWSXP.js';
+import './chunk-KZQKFBRN.js';
+import './chunk-7A7HYFGM.js';
+export { RECAST_SEGMENT_PACKS } from './chunk-RJIJVVXS.js';
+import './chunk-6JFNBAKV.js';
+import './chunk-OJDBSKC2.js';
+import './chunk-CRCPRZFN.js';
+import './chunk-OMH7ATOQ.js';
+import './chunk-37Y5QAVA.js';
+import './chunk-NX67YIF3.js';
+export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from './chunk-W7YI5UT3.js';
+import './chunk-X7RDNMN7.js';
+import './chunk-OLPA44QJ.js';
+export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from './chunk-RKVRCNMB.js';
+import './chunk-HLHR3R4P.js';
+import './chunk-CJFIOVBA.js';
+import './chunk-OPR4TULG.js';
+import './chunk-C22RJDW3.js';
+import './chunk-I3TYBAOX.js';
+import './chunk-A3THLBFG.js';
+import './chunk-UIFFNTUX.js';
+import './chunk-HFBR6G36.js';
+import './chunk-ES2E65HT.js';
+import './chunk-GAZJ2PA3.js';
+import './chunk-GD24ZRFD.js';
+import './chunk-ELSOVJPF.js';
+import './chunk-AUDHV3OE.js';
+import './chunk-EXLAHZKF.js';
+import './chunk-V4GPQ6Y2.js';
+import './chunk-YOOZB4RL.js';
+export { unwrapEditPlanOutput } from './chunk-ZH4F2P2G.js';
+import './chunk-3PPSGM5X.js';
+import './chunk-HRXXGGSJ.js';
+import './chunk-M6Y5TOYE.js';
+import './chunk-SUCHGNYT.js';
+import './chunk-SLPD47SR.js';
+export { NodaroClient, createClient } from './chunk-5WAI7VGO.js';
+export { WebhooksResource } from './chunk-YN6CBIIB.js';
+export { WorkflowsResource } from './chunk-ZXJQSFIA.js';
+export { WorkspacesResource } from './chunk-Z5GLY4R3.js';
+export { SessionsResource } from './chunk-Y6VDCZPB.js';
+export { ShotsResource } from './chunk-WVFAQBS7.js';
+export { StudioProductionsResource, StudioResource, isStudioGenerateEstimate } from './chunk-VV4TZG5S.js';
+export { TemplatesResource } from './chunk-6OGGJQVA.js';
+export { TutorialsResource } from './chunk-DPSMVOM3.js';
+export { UploadsResource } from './chunk-T3SYREY4.js';
+export { VideoProResource } from './chunk-ERLXU47J.js';
+export { VoicesResource } from './chunk-T7N7DFQJ.js';
+export { PickerCatalogsResource } from './chunk-BLA44UCM.js';
+export { PipelinesResource } from './chunk-K4RQOSJH.js';
+export { ProjectsResource } from './chunk-H7VQTG4M.js';
+export { PromptHelperResource } from './chunk-E2ZXHS6E.js';
+export { RecastResource } from './chunk-AJVSMNPZ.js';
+export { ReduceResource } from './chunk-IHKIYVZQ.js';
+export { SavedPostsResource } from './chunk-NCCBS6GU.js';
+export { SCENE3D_DELIVERY_ASSET_USAGE, Scene3DResource } from './chunk-NNHWH7ER.js';
+export { ModelsResource } from './chunk-Y6V6CBY5.js';
+export { MOODBOARD_DIRECTION_PREFIX, MoodboardsResource, moodboardDirectionId } from './chunk-YVU2M7MI.js';
+export { PresetsResource } from './chunk-JTAW54UM.js';
+export { NodesResource } from './chunk-QITJGSFA.js';
+export { OAuthResource } from './chunk-Z7LGWNI7.js';
+export { OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectsResource } from './chunk-7LSFG2AF.js';
+export { OrganizationsResource } from './chunk-ALSLZG3U.js';
+export { PALETTE_DIRECTION_PREFIX, PalettesResource, paletteDirectionId } from './chunk-WEQWU2IC.js';
+export { ExecutionsResource, OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from './chunk-Z3ZKFI2M.js';
+export { GalleryResource } from './chunk-JDEZHITT.js';
+export { JobsResource } from './chunk-E5BM4BLO.js';
+export { LibraryResource } from './chunk-P6E4QDJN.js';
+export { LlmResource } from './chunk-E37CVHWW.js';
+export { LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationsResource, SURROUND_DIRECTIONS } from './chunk-TVENC6PH.js';
+export { MediaResource } from './chunk-4NLVBYMW.js';
+export { CommunityResource } from './chunk-SFB4YLCS.js';
+export { CompetitorsResource } from './chunk-BU5A6K4C.js';
+export { CopilotResource } from './chunk-I6CXC345.js';
+import './chunk-JMOKD6ZP.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from './chunk-LHP2CWHD.js';
+export { OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ASSET_TYPES, CREATURE_ATTACH_COLUMNS, CreaturesResource } from './chunk-CK3AMMSC.js';
+export { CreditsResource } from './chunk-XQAIEPAZ.js';
+export { DeveloperAppsResource } from './chunk-65E3JBFZ.js';
+export { CLIP_PACK_MAX_TARGET_SEC, CLIP_PACK_MIN_TARGET_SEC, EditResource, TRAILER_FORMATS, USE_CASE_NODE_TYPES } from './chunk-I4A5VJRL.js';
+export { AlreadyRunningError, AppRunVersionChangedError, ContinuationPreviewPendingError, ContinuationRefusedError, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, NodaroError, NotFoundError, RateLimitedError, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, UnauthorizedError, WorkflowConflictError, throwFromResponse } from './chunk-JGS6YBDW.js';
+export { AppsResource } from './chunk-53SXNN3A.js';
+export { AudioResource } from './chunk-3QFTP5P5.js';
+export { BillingResource } from './chunk-J4WFSKY6.js';
+export { CatalogsResource } from './chunk-KG4R454Z.js';
+export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, CharactersResource, PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints, buildPersonSeedPrompt } from './chunk-EJSGJDZY.js';
+import './chunk-Z5OMWAQX.js';
+export { CollectionsResource } from './chunk-4WRDR4GN.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map