@nodaro/sdk 2.28.0 → 2.31.0

package/dist/chunk-E5BM4BLO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/jobs.ts"],"names":[],"mappings":";AAgMA,SAAS,UAAU,KAAA,EAAmE;AACpF,EAAA,IAAI,KAAA,KAAU,QAAW,OAAO,MAAA;AAChC,EAAA,OAAO,OAAO,KAAA,KAAU,QAAA,GAAW,KAAA,GAAQ,KAAA,CAAM,KAAK,GAAG,CAAA;AAC3D;AAgCO,IAAM,eAAN,MAAmB;AAAA,EACxB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAI,EAAA,EAAoC;AACtC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,IAAA,CAAK,MAAA,GAAyB,EAAC,EAA0B;AACvD,IAAA,MAAM,EAAE,MAAA,EAAQ,IAAA,EAAM,GAAG,MAAK,GAAI,MAAA;AAClC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,KAAA,EAAO,UAAA,EAAY;AAAA,MAC1D,KAAA,EAAO,EAAE,GAAG,IAAA,EAAM,MAAA,EAAQ,SAAA,CAAU,MAAM,CAAA,EAAG,IAAA,EAAM,SAAA,CAAU,IAAI,CAAA;AAAE,KACpE,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,IAAA,CAAK,IAAY,MAAA,EAAkD;AACjE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAuB,KAAA,EAAO,YAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA,EAAW;AAAA,MAC5F,IAAA,EAAM,EAAE,MAAA;AAAO,KAChB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,UAAU,EAAA,EAAgD;AACxD,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA;AAAA,KACpC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,OAAO,EAAA,EAAsC;AAC3C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,QAAA;AAAA,MACA,CAAA,SAAA,EAAY,kBAAA,CAAmB,EAAE,CAAC,CAAA;AAAA,KACpC;AAAA,EACF;AACF","file":"chunk-E5BM4BLO.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the\n * platform's `backend/src/lib/job-status.ts` — nothing links the two at build\n * time, so a new member has to be added here in the same change.\n *\n * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the\n * deployment held the output for a human reviewer. Treat it like `processing`\n * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`\n * (approved), `failed` (rejected, carrying an `error_hint` with\n * `kind: \"policy-block\"`) or `cancelled` (a held job is cancellable like any\n * in-flight job). `credit_status` reads `\"reserved\"` for the whole hold. Only\n * appears on deployments that register a job policy; `runAndWait` throws\n * {@link JobHeldError} on the first held tick rather than waiting it out.\n */\nexport type JobStatus =\n  | \"pending\"\n  | \"queued\"\n  | \"processing\"\n  | \"pending_review\"\n  | \"completed\"\n  | \"failed\"\n  | \"cancelled\"\n\n/**\n * A PROVIDER's verdict: the model's own safety filter refused the output.\n * `class` distinguishes a deterministic block (copyright/likeness — retrying\n * the same request never helps) from `safety`, whose filter is known to be\n * non-deterministic for some models: `retried` says whether the worker\n * already spent its one extra attempt, and `suggestedProvider` — present\n * only when the catalog declares a fallback for the model that failed — is a\n * real model id the SAME prompt/references can be retried on.\n */\nexport type SafetyBlockHint = {\n  kind: \"safety-block\"\n  class: \"copyright\" | \"likeness\" | \"safety\"\n  retried: boolean\n  suggestedProvider?: string\n}\n\n/**\n * A NODARO-side verdict, not a provider's: a job policy registered by the\n * deployment rejected the request (`hookPoint: \"request\"` — nothing ran, and\n * the call itself failed with {@link JobBlockedError}) or the finished output\n * (`hookPoint: \"result\"` — the result was blocked and never published).\n *\n * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's\n * machine text (scores, labels) never reaches it — so show it to the person\n * who made the request as-is. `policyId` identifies the deployment's policy,\n * not a Nodaro product feature. Only occurs on deployments that register a\n * job policy.\n */\nexport type PolicyBlockHint = {\n  kind: \"policy-block\"\n  policyId: string\n  reason: string\n  hookPoint: \"request\" | \"result\"\n}\n\n/**\n * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable\n * failure verdict, so a caller can act on it without parsing `error_message`\n * prose. One column, two verdict sources; `kind` is the discriminant.\n *\n * HAND-COPIED MIRROR of `ErrorHint` in the platform's\n * `backend/src/lib/safety-block.ts` (which names this file in its own\n * comment). Nothing links the two at build time: a new arm there has to be\n * pasted here verbatim in the same change, with a changeset.\n * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.\n */\nexport type JobErrorHint = SafetyBlockHint | PolicyBlockHint\n\n/**\n * The billing lifecycle of a job's credit reservation — `usage_logs.status`\n * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a\n * free run) or hasn't reserved credits yet.\n */\nexport type CreditStatus = \"reserved\" | \"committed\" | \"refunded\"\n\n/** A job owner's rating of their job — set with {@link JobsResource.rate}. */\nexport type JobRating = \"good\" | \"bad\"\n\n/**\n * The `rating` filter of {@link JobsResource.list}: one rating, any rating\n * (`\"rated\"`) or none (`\"unrated\"`).\n */\nexport type JobRatingFilter = JobRating | \"rated\" | \"unrated\"\n\n/**\n * Job record returned to non-admin SDK consumers. Field names are snake_case\n * to match the wire format (per the OpenAPI fix in Phase 1).\n *\n * Sensitive fields stripped server-side for non-admin callers:\n * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD\n * pricing is admin-only across api/sdk/mcp — non-admin consumers see\n * only the `credits` abstraction. Server-only nested job data (including\n * Recast's private remux base) is stripped for every caller, including admins.\n */\nexport interface Job {\n  id: string\n  status: JobStatus\n  progress: number\n  user_id: string\n  input_data: unknown\n  output_data: unknown\n  error_message: string | null\n  /** Present on a failed job the worker classified as a provider\n   *  content-policy block (`kind: \"safety-block\"`) or that a deployment's job\n   *  policy rejected (`kind: \"policy-block\"`); absent/null otherwise.\n   *  User-safe by construction — narrow on `kind` before reading the rest. */\n  error_hint?: JobErrorHint | null\n  /** PR9: the job's credit reservation lifecycle, derived server-side from\n   *  `usage_logs.status`. `null` when there is no usage log to report. Never\n   *  changes the meaning of `credits` (the reserved amount) below. */\n  credit_status?: CreditStatus | null\n  /** The credits HELD when the job was accepted. Never changes — a job can\n   *  settle below it; read {@link Job.credits_charged} for what it cost. */\n  credits: number | null\n  /**\n   * What the job actually cost once its hold settled. Can be lower than\n   * `credits` (the unused part goes back to the balance), `0` when the hold was\n   * refunded, `null` while the job is still running or when it reserved\n   * nothing of its own. Sum this — not `credits` — to total spend. Returned by\n   * `get()` and `list()`.\n   */\n  credits_charged?: number | null\n  job_type: string | null\n  created_at: string\n  started_at: string | null\n  completed_at: string | null\n  /**\n   * Provenance: which kind of caller created the job — one of\n   * `\"internal\" | \"mcp\" | \"app\" | \"cli\" | \"sdk\" | \"extension\" | \"web\" | \"api\"`.\n   * `source_detail` narrows it (origin host, `extension/<name>` label,\n   * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;\n   * lets a library view label or filter media by origin.\n   */\n  source?: string | null\n  source_detail?: string | null\n  /** The generation session this job was born in (the `sessionId` sent with\n   *  the generation request), or null. See `client.sessions`. */\n  session_id?: string | null\n  /**\n   * Whether the job's owner favorited it (`client.gallery.toggleFavorite`).\n   * Returned by `get()` and `list()`. Absent from an older server, and when\n   * the server could not read it for a moment — treat absent as unknown,\n   * never as `false`.\n   */\n  favorited?: boolean\n  /**\n   * The owner's rating of the job ({@link JobsResource.rate}), or `null` when\n   * unrated. Returned by `get()` and `list()`; absent like `favorited`.\n   */\n  rating?: JobRating | null\n}\n\nexport interface CancelJobResult {\n  success: true\n  cancelled: number\n}\n\nexport interface DeleteJobResult {\n  success: true\n}\n\nexport interface ListJobsParams {\n  /** One status or several (a job matching any of them). An unknown status is a 400. */\n  status?: JobStatus | readonly JobStatus[]\n  /** Exact match on `input_data.type` — the route that created the job\n   *  (`\"llm-structured\"`, `\"video-analysis\"`, …). One value or several (up to 20). */\n  type?: string | readonly string[]\n  /** Exact match on `input_data.origin` — the client app that sent it. */\n  origin?: string\n  /** `true`: only jobs you favorited; `false`: only jobs you did not. */\n  favorited?: boolean\n  /** Your rating: `\"good\"`, `\"bad\"`, any (`\"rated\"`) or none (`\"unrated\"`). */\n  rating?: JobRatingFilter\n  /** The jobs of one generate-image batch (`count` / `models`) — its `batchId`. */\n  batchId?: string\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `next`. */\n  cursor?: string\n}\n\n/** What {@link JobsResource.rate} answers: the job's rating now. */\nexport interface RateJobResult {\n  data: { jobId: string; rating: JobRating | null }\n}\n\n/** A list filter value as the query string carries it: several are comma-separated. */\nfunction listParam(value: string | readonly string[] | undefined): string | undefined {\n  if (value === undefined) return undefined\n  return typeof value === \"string\" ? value : value.join(\",\")\n}\n\nexport interface ListJobsPage {\n  /**\n   * A page may hold fewer than `limit` rows — even none — and still carry a\n   * `next`. Page on `next`, never on `data.length`.\n   */\n  data: Job[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  next: string | null\n}\n\n/**\n * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the\n * `input_data` JSONB and cost columns. Its `output_data` still goes\n * through the server-only nested-field redaction. Intended for poll loops that\n * only need progress/output/error, and when the job finished.\n */\nexport interface JobStatusResult {\n  id: string\n  status: JobStatus\n  progress?: number\n  output_data?: unknown\n  error_message?: string | null\n  /** PR9: see {@link Job.error_hint}. */\n  error_hint?: JobErrorHint | null\n  /** PR9: see {@link Job.credit_status}. */\n  credit_status?: CreditStatus | null\n  /** When the job finished, on the server's clock; null until it has. */\n  completed_at?: string | null\n}\n\nexport class JobsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Get a single job by ID. */\n  get(id: string): Promise<{ data: Job }> {\n    return this.client.request(\"GET\", `/v1/jobs/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and\n   * `origin` filter on the job's own `input_data`, which every job carries —\n   * a client app lists its runs with `{ type: \"llm-structured\", origin: \"studio\" }`.\n   * `status` and `type` take one value or a list; `favorited` and `rating`\n   * filter on your own marks. Every filter combines with AND, and each job\n   * carries `favorited` and `rating`.\n   */\n  list(params: ListJobsParams = {}): Promise<ListJobsPage> {\n    const { status, type, ...rest } = params\n    return this.client.request<ListJobsPage>(\"GET\", \"/v1/jobs\", {\n      query: { ...rest, status: listParam(status), type: listParam(type) },\n    })\n  }\n\n  /**\n   * Rate one of your jobs `\"good\"` or `\"bad\"`, or clear the rating with\n   * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone\n   * else's job is a `NotFoundError`. The rating reads back as `Job.rating`\n   * and filters {@link list}. OAuth apps need the `assets:write` scope.\n   */\n  rate(id: string, rating: JobRating | null): Promise<RateJobResult> {\n    return this.client.request<RateJobResult>(\"PUT\", `/v1/jobs/${encodeURIComponent(id)}/rating`, {\n      body: { rating },\n    })\n  }\n\n  /**\n   * Get the lean status of a single job (poll-loop friendly).\n   * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/\n   * output_data/error_message, with far less wire/CPU cost than `get()`.\n   * Same auth + ownership semantics as {@link get}.\n   */\n  getStatus(id: string): Promise<{ data: JobStatusResult }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/jobs/${encodeURIComponent(id)}/status`,\n    )\n  }\n\n  /**\n   * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.\n   * Refunds any reserved credit holds.\n   */\n  cancel(id: string): Promise<CancelJobResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/jobs/${encodeURIComponent(id)}/cancel`,\n    )\n  }\n\n  /**\n   * Delete a job and the private media it produced. Server route is\n   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;\n   * a job that is still running is deleted as-is — cancel it first when its\n   * worker should stop ({@link cancel}).\n   */\n  delete(id: string): Promise<DeleteJobResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/jobs/${encodeURIComponent(id)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-EHRWTYGR.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-EHRWTYGR.cjs.map
+//# sourceMappingURL=chunk-EHRWTYGR.cjs.map

package/dist/chunk-EHRWTYGR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-EHRWTYGR.cjs"}

package/dist/chunk-EJSGJDZY.js

@@ -0,0 +1,212 @@
+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 } from '@nodaro/shared/entities';
+
+// src/resources/characters.ts
+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; `q` keeps the ones whose name or description contains it.
+   *
+   * 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.q) query.q = params.q;
+    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`
+    );
+  }
+  /**
+   * Start training a high-fidelity model of the character on its own images
+   * (Nodaro Cloud only — other editions answer `NotFoundError`). Reserves the
+   * training price up front and refunds it if the training fails or is
+   * cancelled. Resolves at once (202); a training takes about 15 minutes —
+   * follow it with {@link trainingStatus}. Once it succeeds, a workflow's
+   * Generate Image node whose prompt @-mentions this one character runs on the
+   * trained model.
+   *
+   * An OAuth app token needs the `assets:write` scope (`ForbiddenError`
+   * otherwise, before anything is reserved); a session or personal API key
+   * needs none. Refusals are `NodaroError`s whose `code` is a
+   * {@link TrainCharacterRefusalCode}; rate-limited to 3 calls a minute.
+   */
+  train(id, input = {}) {
+    return this.client.request("POST", `/v1/characters/${encodeURIComponent(id)}/train`, { body: input });
+  }
+  /**
+   * The character's training record (Nodaro Cloud only). Poll it while
+   * `status` is `queued` or `training` — every 10 s or so is plenty.
+   */
+  trainingStatus(id) {
+    return this.client.request("GET", `/v1/characters/${encodeURIComponent(id)}/training`);
+  }
+  /**
+   * Remove the character's trained model (Nodaro Cloud only): cancels a
+   * training in flight and refunds its reservation, deletes the model, and
+   * clears the training record (`trainingStatus` then reads `untrained`).
+   * Generations go back to reference images. Cannot be undone — a new model
+   * means a new, paid training. An OAuth app token needs the `assets:write`
+   * scope (`ForbiddenError` otherwise), like deleting the character.
+   */
+  async deleteLora(id) {
+    await this.client.request("DELETE", `/v1/characters/${encodeURIComponent(id)}/lora`);
+  }
+};
+function buildPersonSeedPrompt(value) {
+  return buildPersonHints(value).join(", ");
+}
+
+export { CharactersResource, buildPersonSeedPrompt };
+//# sourceMappingURL=chunk-EJSGJDZY.js.map
+//# sourceMappingURL=chunk-EJSGJDZY.js.map

package/dist/chunk-EJSGJDZY.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/characters.ts"],"names":[],"mappings":"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","file":"chunk-EJSGJDZY.js","sourcesContent":["import { buildPersonHints, PEOPLE, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_LABELS, type PersonValue } from \"@nodaro/prompts/person\"\nimport type { CharacterAspectRatio, CharacterAttachColumn, EntityStyle } from \"@nodaro/shared/entities\"\nimport type { TtsProvider } from \"@nodaro/shared/models\"\nexport type { EntityStyle, CharacterAspectRatio } from \"@nodaro/shared/entities\"\nexport { CHARACTER_STYLES, CHARACTER_ASPECT_OPTIONS, CHARACTER_ASPECT_DEFAULTS } from \"@nodaro/shared/entities\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { GenerationSessionParams } from \"./nodes.js\"\n\n/**\n * Re-export the shared `EntityStyle` union (realistic | anime | 3d-pixar |\n * illustration) and `CHARACTER_STYLES` runtime tuple so SDK consumers don't\n * have to add `@nodaro/shared` as a second dependency just to typecheck the\n * `style` field. Single source of truth lives in `@nodaro/shared/entity-prompts`.\n */\n\n/**\n * Re-export the 4-value aspect-ratio union accepted by the generate-character*\n * routes. Single source of truth lives in `@nodaro/shared`. See\n * `CHARACTER_ASPECT_DEFAULTS` for the per-asset-type defaults.\n */\n\n/**\n * Structured Person composer, re-exported from `@nodaro/shared` so SDK\n * consumers can build a detailed person description — Identity, Body, and the\n * Face facial-geometry layer (cheekbones, canthal tilt, eyelid type, lip\n * fullness/shape, nose tip, etc.) — and feed it as `seedPrompt` / `description`\n * to `generate()` / `upsert()` without adding `@nodaro/shared` as a second dep.\n *\n * `buildPersonSeedPrompt` collapses a `PersonValue` into the same comma-joined\n * fragment the editor's Person picker produces (e.g. \"almond-shaped eyes,\n * sharply sculpted high cheekbones, full plump lips\"). Returns \"\" when empty.\n */\n\n\n/**\n * A character record returned by Nodaro's REST API. Mirrors the camelCase\n * shape produced by `backend/src/routes/characters.ts::toCamel()`.\n *\n * `expressions`, `poses`, `motions`, `angles`, `bodyAngles`,\n * `lightingVariations` are independent buckets keyed by a human-readable\n * variant name (e.g. `\"smile\"`, `\"standing\"`, `\"3/4 left\"`). Each entry's\n * `url` points at an R2-hosted asset.\n *\n * Identity-foundation fields:\n *   - `referencePhotos` — caller-supplied real-life refs (max one per\n *     non-`other` kind; cap 20 total). Drive the i2v / i2i path when a\n *     provider supports multi-image conditioning.\n *   - `realLifeRefsByVariant` — per-variant reference URLs (cap 20 keys,\n *     5 URLs per key). Keys are lowercased+trimmed.\n *   - `referenceVideosByVariant` — per-label user-uploaded reference VIDEO\n *     URLs (cap 20 keys, 5 URLs per key, lowercased+trimmed keys). Mirrors\n *     `realLifeRefsByVariant` for video clips (e.g. emotion takes). Read the\n *     chosen URLs off the row to drive generate-video's `referenceVideoUrls`.\n *   - `seedPrompt` — short prompt fragment that scaffolds portrait gen.\n *   - `canonicalDescription` — ~80–120-word LLM-authored visual caption,\n *     populated by `approvePortrait()` / `recaption()`.\n */\nexport interface Character {\n  id: string\n  userId: string\n  /** Canvas node linkage. `null` only on legacy clone rows that predate the\n   *  clone-side node_id fix (new clones mint one; creates always had one). */\n  nodeId: string | null\n  projectId: string | null\n  name: string\n  description: string | null\n  gender: string | null\n  style: string | null\n  baseOutfit: string | null\n  sourceImageUrl: string | null\n  /** MODEL_CATALOG image-model id the main image was generated with (or `null`).\n   *  Set on create (the provider you generated with) + editable via `upsert`. */\n  imageProvider: string | null\n  expressions: Array<{ name: string; url: string }> | null\n  poses: Array<{ name: string; url: string }> | null\n  lightingVariations: Array<{ name: string; url: string }> | null\n  angles: Array<{ name: string; url: string }> | null\n  bodyAngles: Array<{ name: string; url: string }> | null\n  motions: Array<{ name: string; url: string }> | null\n  /** Named Character Boards — dense reference sheets, one per persona/look\n   *  (the `generate-image/character-board` factory preset rendered from the\n   *  character's images). A first-class bucket: community publish snapshots it\n   *  and clone hands the consumer their own copy to extend. Defaults to `[]`.\n   *  `type` marks an image-collage `\"identity\"` sheet vs a plain `\"looks\"`\n   *  board; `sourceImages` are the R2 URLs it was collaged from. Both optional\n   *  + backward-compatible (legacy boards have neither). */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }> | null\n  /** Per-label user-uploaded reference VIDEO URLs (R2), keyed by a\n   *  caller-owned label (lowercased+trimmed server-side). Mirrors\n   *  `realLifeRefsByVariant` for video clips; read the chosen URLs off the row\n   *  to feed generate-video's `referenceVideoUrls`. Defaults to `{}`. */\n  referenceVideosByVariant?: Record<string, string[]> | null\n  /** The user's chosen DEFAULT asset take per variant (Studio version history).\n   *  OPAQUE map: key `\"<bucket>:<variant>\"` (e.g. `\"bodyAngles:front\"`,\n   *  `\"expressions:smile\"`) → the chosen asset URL (one already present in that\n   *  bucket). Stored verbatim — keys are NOT normalized; soft-capped server-side\n   *  at 200 keys / 2048-char values (overflow dropped silently). Defaults to `{}`. */\n  selectedAssetByVariant?: Record<string, string> | null\n  /** `voiceType` records the selected voice's KIND (premade voices are\n   *  addressed by name; library/custom voices by id at text-to-speech time).\n   *  `previewUrl` is a playable audio sample (the voice's `preview_url` / clone\n   *  sample) the studio plays in an `<audio>` element — persisted so Voice Library\n   *  voices (which have no by-id lookup) stay previewable after reload. Client-\n   *  played only; the server never fetches it. `ttsProvider` is the library\n   *  voice's verified TTS provider (see `SharedVoice.recommendedProvider`) —\n   *  send it as the text-to-speech `provider` so the voice renders on a model\n   *  it's verified for. All optional — a character may have no voice, or a\n   *  legacy voice predating these fields. */\n  voice: { voiceId: string; voiceName: string; traits: string; voiceType?: \"premade\" | \"library\" | \"custom\"; previewUrl?: string; ttsProvider?: TtsProvider } | null\n  personality: {\n    mood: string\n    speechStyle: string\n    movementStyle: string\n    behavioralNotes: string\n  } | null\n  /** ~80–120-word LLM-authored visual caption (approve-portrait / recaption).\n   *  Optional on the read surface so existing literal consumers don't break;\n   *  the route always returns it (string | null). */\n  canonicalDescription?: string | null\n  /** Identity-lock strength for Character Studio asset generation. */\n  identityLock?: \"off\" | \"soft\" | \"strict\"\n  deletedAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * GET /v1/characters/:id appends three live-progress buckets the studio uses\n * to rehydrate spinners after a reload. Optional in the SDK surface — they\n * don't appear on `list()` rows.\n */\nexport interface CharacterDetail extends Character {\n  pendingJobs?: Array<{\n    jobId: string\n    assetType: \"expressions\" | \"poses\" | \"angles\" | \"bodyAngles\" | \"lighting\" | \"motions\"\n    name: string\n  }>\n  portraitCandidates?: Array<{\n    jobId: string\n    url: string | undefined\n    progress: number\n    status: string\n  }>\n  /** Recently completed portrait takes (7 days, newest first): at most 5\n   *  alternates, never the current portrait — plus, with\n   *  `get(id, { candidates: \"all\" })`, the current portrait's own take. */\n  previousCandidates?: Array<{\n    jobId: string\n    url: string\n    createdAt: string\n    /** The image model the take was requested with. */\n    provider?: string\n    /** The aspect ratio the request sent explicitly; absent when the take\n     *  used the default ratio. */\n    aspectRatio?: string\n    /** `true` only on the current portrait's own take (returned with\n     *  `candidates: \"all\"`); `false` on the alternates. */\n    isPortrait?: boolean\n  }>\n}\n\n/** Options for `client.characters.get()`. */\nexport interface GetCharacterOptions {\n  /**\n   * `\"all\"`: `previousCandidates` also carries the current portrait's own\n   * take, flagged `isPortrait: true`, when its job is within the 7-day window\n   * (the alternates stay at most 5). Default `\"alternates\"`: the current\n   * portrait is left out.\n   */\n  candidates?: \"alternates\" | \"all\"\n}\n\nexport type ReferencePhotoKind =\n  | \"frontFace\"\n  | \"sideLeft\"\n  | \"sideRight\"\n  | \"threeQuarterLeft\"\n  | \"threeQuarterRight\"\n  | \"frontBody\"\n  | \"other\"\n\nexport interface ReferencePhoto {\n  url: string\n  kind: ReferencePhotoKind\n}\n\n/**\n * Body for `client.characters.upsert()`. Mirrors `upsertCharacterBody` in\n * `backend/src/routes/characters.ts`. Omitting `id` triggers an INSERT;\n * supplying it triggers an UPDATE that only writes the fields you pass —\n * undefined keys are NOT touched on the row.\n *\n * `name` is optional at the type level. The route requires `name` on INSERT\n * (id absent) and rejects with `validation_error` otherwise; on UPDATE the\n * route just ignores `name` when omitted, which lets partial updates like\n * `update(id, { gender: \"female\" })` succeed without re-sending the same\n * name the caller already has.\n */\nexport interface UpsertCharacterInput {\n  /** UUID of the character row; omit to create. */\n  id?: string\n  /** Canvas node id the character belongs to. REQUIRED on create (the route\n   *  400s without it, like `name`); optional on update — the update branch\n   *  never touches node_id, so partial updates needn't round-trip it. */\n  nodeId?: string\n  workflowId?: string\n  projectId?: string\n  name?: string\n  description?: string\n  gender?: string\n  style?: string\n  baseOutfit?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  expressions?: Array<{ name: string; url: string }>\n  poses?: Array<{ name: string; url: string }>\n  lightingVariations?: Array<{ name: string; url: string }>\n  angles?: Array<{ name: string; url: string }>\n  bodyAngles?: Array<{ name: string; url: string }>\n  motions?: Array<{ name: string; url: string }>\n  /** Named Character Boards (see `Character.boards`) — whole-array replace,\n   *  like the asset buckets. Server caps: 24 boards, 200-char names, 30\n   *  sourceImages per board. */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }>\n  /** See `Character.voice` — persisted alongside the voice so TTS can resolve a\n   *  library/custom voice by id, `previewUrl` keeps the sample playable after\n   *  reload, and `ttsProvider` keeps generation on a model the voice is\n   *  verified for. All optional. */\n  voice?: { voiceId: string; voiceName: string; traits: string; voiceType?: \"premade\" | \"library\" | \"custom\"; previewUrl?: string; ttsProvider?: TtsProvider } | null\n  personality?: {\n    mood: string\n    speechStyle: string\n    movementStyle: string\n    behavioralNotes: string\n  } | null\n  seedPrompt?: string\n  canonicalDescription?: string\n  /** Identity-lock strength for Character Studio asset generation (off/soft/strict). */\n  identityLock?: \"off\" | \"soft\" | \"strict\"\n  referencePhotos?: ReferencePhoto[]\n  /** Per-variant real-life reference URLs. Keys are lowercased+trimmed server-side. */\n  realLifeRefsByVariant?: Record<string, string[]>\n  /** Per-label user-uploaded reference VIDEO URLs (e.g. emotion takes). Keys\n   *  are lowercased+trimmed server-side; max 20 keys, 5 URLs each. Stored R2\n   *  URLs are read back off the row to drive generate-video's\n   *  `referenceVideoUrls`. */\n  referenceVideosByVariant?: Record<string, string[]>\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map\n   *  (the studio sends the full map each save). Omit to leave the row untouched.\n   *  Keys stored verbatim; soft-capped server-side at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n}\n\nexport interface UpsertCharacterResult {\n  id: string\n  name?: string\n}\n\nexport interface ListCharactersParams {\n  /** Restrict to a single project. */\n  projectId?: string\n  /** When true, return archived characters instead of active ones. */\n  archived?: boolean\n  /**\n   * Search words: only the characters whose name or description contains\n   * every word (split on spaces, the first 5), in any order, ignoring case —\n   * `\"red car\"` finds \"Car, red\". Each word is matched as written (`%`, `_`\n   * and `*` are not wildcards; punctuation is kept); blank means no search; up\n   * to 200 characters. Combines with the other filters and with `cursor`\n   * paging.\n   */\n  q?: string\n  /**\n   * Max rows to return. Server defaults to 100, caps at 500. Omit to take the\n   * server default — passing it just narrows further.\n   */\n  limit?: number\n  /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */\n  cursor?: string\n}\n\nexport interface ListCharactersResult {\n  characters: Character[]\n  /** Pass back as `cursor` for the next page; `null` when there are no more. */\n  nextCursor: string | null\n}\n\nexport interface DuplicateCharacterInput {\n  /** Optional canvas node id to bind the new row to. */\n  nodeId?: string\n  /** Optional project to drop the new row into. */\n  projectId?: string\n}\n\nexport interface CharacterUsage {\n  workflowCount: number\n  workflows: Array<{ id: string; name: string }>\n}\n\n/**\n * Input for `client.characters.generate()` — fires the\n * `POST /v1/generate-character` route. Produces 1–10 portrait candidates;\n * each lands as one `jobs` row in `pending` state and is then enqueued for\n * the worker.\n *\n * Provide at least one of `seedPrompt`, `referencePhotos`, or `description`\n * (the backend's refinement rejects empty input with `validation_error`).\n *\n * When `attachToCharacterId` is set, the worker writes the resulting URL\n * directly to `characters.source_image_url` on completion — caller doesn't\n * need a separate `approvePortrait` call for single-candidate runs. Pass\n * `attachPortrait: false` to keep every take a candidate instead.\n */\nexport interface GenerateCharacterInput extends GenerationSessionParams {\n  name: string\n  description?: string\n  userPrompt?: string\n  gender?: string\n  style?: EntityStyle\n  baseOutfit?: string\n  sourceImageUrl?: string\n  provider?: string\n  /** Auto-attach the result to this character row. */\n  attachToCharacterId?: string\n  /** `false`: the take stays a candidate; only the approve route\n   *  (`approvePortrait()`) sets the portrait. Omitted/`true`: the finished\n   *  take is written to the row's portrait. */\n  attachPortrait?: boolean\n  seedPrompt?: string\n  referencePhotos?: ReferencePhoto[]\n  /** Number of candidate images to generate (1–10; server-validated). */\n  count?: number\n  /**\n   * Explicit aspect ratio. Highest precedence — overrides both the character\n   * node toggle and the per-asset-type default (portraits default to `3:4`).\n   * Must be one of the 4-value `CharacterAspectRatio` union.\n   */\n  aspectRatio?: CharacterAspectRatio\n  /**\n   * Character node toggle (per-canvas-node `defaultAssetAspectRatio`). Wins\n   * against the per-asset-type default, loses to `aspectRatio`.\n   */\n  characterNodeAspectRatio?: CharacterAspectRatio\n  /**\n   * Credit-affecting quality tier (e.g. `\"high\"` for gpt-image). Priced like\n   * generate-image (composite ids such as `gpt-image:high`); values the chosen\n   * model doesn't support are ignored server-side, never rejected.\n   */\n  quality?: string\n  /**\n   * Credit-affecting output resolution (e.g. `\"2K\"` / `\"4K\"` / `\"2 MP\"`).\n   * Priced like generate-image (composite ids such as `nano-banana-pro:4K`);\n   * values the chosen model doesn't support are ignored server-side, never\n   * rejected.\n   */\n  resolution?: string\n}\n\nexport interface GenerateCharacterResult {\n  /** First job-id; convenience alias for `jobIds[0]`. */\n  jobId: string\n  /** All job-ids when `count > 1`. */\n  jobIds: string[]\n}\n\nexport interface GenerateAssetInput extends GenerationSessionParams {\n  assetType:\n    | \"expressions\"\n    | \"poses\"\n    | \"lighting\"\n    | \"angles\"\n    | \"headAngles\"\n    | \"bodyAngles\"\n    | \"custom\"\n  /** The named variant (e.g. `\"smile\"`, `\"standing\"`, `\"3/4 left\"`). */\n  variant: string\n  /** Display name of the character; appears in the prompt. */\n  name: string\n  description?: string\n  userPrompt?: string\n  gender?: string\n  style?: EntityStyle\n  baseOutfit?: string\n  sourceImageUrl?: string\n  /** Real-life reference URLs (cap 5). */\n  realLifeRefs?: string[]\n  provider?: string\n  /** Auto-attach to character row + asset bucket on completion. */\n  attachToCharacterId?: string\n  /** Shared type — auto-includes new buckets (sheets/detail_closeups/outfit_variations); mirrors objects.ts/locations.ts. */\n  attachToColumn?: CharacterAttachColumn\n  attachName?: string\n  /**\n   * Explicit aspect ratio. Highest precedence — overrides both the character\n   * node toggle and the per-asset-type default (expressions=1:1, poses=9:16,\n   * headAngles=3:4, bodyAngles=9:16, lighting=3:4, angles=3:4, custom=3:4).\n   */\n  aspectRatio?: CharacterAspectRatio\n  /**\n   * Character node toggle (per-canvas-node `defaultAssetAspectRatio`). Wins\n   * against the per-asset-type default, loses to `aspectRatio`.\n   */\n  characterNodeAspectRatio?: CharacterAspectRatio\n  /**\n   * Credit-affecting quality tier (e.g. `\"high\"` for gpt-image). Values the\n   * chosen model doesn't support are ignored server-side, never rejected.\n   */\n  quality?: string\n  /**\n   * Credit-affecting output resolution (e.g. `\"2K\"` / `\"4K\"` / `\"2 MP\"`).\n   * Values the chosen model doesn't support are ignored server-side, never\n   * rejected.\n   */\n  resolution?: string\n}\n\nexport interface GenerateMotionInput extends GenerationSessionParams {\n  motionPrompt: string\n  /** Optional when `attachToCharacterId` is set — falls back to the row's portrait. */\n  sourceImageUrl?: string\n  provider?: string\n  name: string\n  description?: string\n  motionDescription?: string\n  gender?: string\n  style?: EntityStyle\n  baseOutfit?: string\n  realLifeRefs?: string[]\n  attachToCharacterId?: string\n  attachName?: string\n  /**\n   * Explicit aspect ratio. Highest precedence — overrides both the character\n   * node toggle and the motions default (`9:16`).\n   */\n  aspectRatio?: CharacterAspectRatio\n  /**\n   * Character node toggle (per-canvas-node `defaultAssetAspectRatio`). Wins\n   * against the motions default, loses to `aspectRatio`.\n   */\n  characterNodeAspectRatio?: CharacterAspectRatio\n}\n\nexport interface ApprovePortraitResult {\n  portraitUrl: string\n  /**\n   * LLM-authored caption. `null` when the LLM call failed during the approval\n   * — the portrait is still set; call `recaption()` to retry.\n   */\n  canonicalDescription: string | null\n}\n\nexport interface RecaptionResult {\n  canonicalDescription: string\n}\n\n/**\n * Where a character's high-fidelity training stands. `untrained`: nothing was\n * ever trained, the trained model was removed (`deleteLora`), or a training\n * could not be started (`training_dispatch_failed` — refunded; this resets the\n * status even for a character trained before). `queued` / `training`: in\n * flight. `succeeded` / `failed` / `cancelled`: the last training's outcome.\n *\n * Generation uses the trained model only while the status is `succeeded`.\n */\nexport type CharacterTrainingState = \"untrained\" | \"queued\" | \"training\" | \"succeeded\" | \"failed\" | \"cancelled\"\n\n/** `GET /v1/characters/:id/training` — the character's training record. */\nexport interface CharacterTrainingStatus {\n  status: CharacterTrainingState\n  /** The provider's id for the latest training; `null` before the first one. */\n  trainingId: string | null\n  /** Why the last training failed, as the user may read it; `null` otherwise. */\n  error: string | null\n  /**\n   * When the last successful training finished (ISO 8601). It stays set through\n   * a re-train, a failed or cancelled one, or one that could not be started —\n   * but the model is used only while `status` is `succeeded`.\n   */\n  trainedAt: string | null\n  /** The last successful training's model version; set or not, used only while `status` is `succeeded`. */\n  version: string | null\n  /** The token added to prompts for this character (`TOK_<slug>_<6hex>`); generation adds it for you. */\n  triggerWord: string | null\n  /** How many images the latest training used. */\n  imageCount: number | null\n}\n\n/** Body for `characters.train()`. */\nexport interface TrainCharacterInput {\n  /**\n   * Train on these of the character's images only (max 200 URLs; at most 20\n   * are used). Omitted or empty: every eligible image — the portrait,\n   * reference photos, expressions, poses, head and body angles and lighting\n   * variations. At least 4 distinct images must remain either way.\n   */\n  selectedImageUrls?: string[]\n}\n\n/** `POST /v1/characters/:id/train` — answered 202 while the training runs. */\nexport interface TrainCharacterResult {\n  /** The training's job; it ends `completed`, `failed` or `cancelled` with the training. */\n  jobId: string\n  /** The provider's id for this training (also on `trainingStatus().trainingId`). */\n  trainingId: string\n  /** The token added to prompts for this character once trained. */\n  triggerWord: string\n}\n\n/**\n * The `code` of a `NodaroError` `train()` can throw beyond the typed classes\n * (`ForbiddenError` — an app token without `assets:write`, `missingScope`\n * says so; `InsufficientCreditsError`; `RateLimitedError`; `JobBlockedError`;\n * `UnauthorizedError`; …):\n *\n * - `insufficient_training_images` (400) — fewer than 4 distinct images; the\n *   message says how many there are.\n * - `validation_error` (400) — a malformed id or `selectedImageUrls`.\n * - `already_training_or_not_found` (409) — a training is already in flight,\n *   or the character is not yours / archived.\n * - `claim_failed` (500) — the training slot could not be claimed; nothing\n *   started. Retry.\n * - `training_dispatch_failed` (502) — the training could not be started;\n *   nothing is charged.\n * - `public_url_not_configured` (503) — the deployment cannot receive the\n *   provider's completion call.\n * - `price_not_configured` (503) — the deployment has no price for training.\n * - `dedup_race_winner_unresolvable` (503) — a duplicate of this request was\n *   in flight and its outcome could not be read; this one reserved nothing.\n *   Read {@link CharactersResource.trainingStatus} before retrying.\n */\nexport type TrainCharacterRefusalCode =\n  | \"insufficient_training_images\"\n  | \"validation_error\"\n  | \"already_training_or_not_found\"\n  | \"claim_failed\"\n  | \"training_dispatch_failed\"\n  | \"public_url_not_configured\"\n  | \"price_not_configured\"\n  | \"dedup_race_winner_unresolvable\"\n\nexport class CharactersResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * List the caller's characters. By default returns active characters only;\n   * pass `archived: true` to fetch soft-deleted rows for an \"archive\" view.\n   * When `projectId` is set, only characters belonging to that project are\n   * returned; `q` keeps the ones whose name or description contains it.\n   *\n   * Cursor-paginated: a response carrying a non-null `nextCursor` means more\n   * rows exist. Pass it back as `cursor` to fetch the next page, and keep going\n   * until `nextCursor` is `null` — a single call returns at most `limit` rows\n   * (default 100), so treating one call as \"all characters\" silently truncates\n   * the list for anyone past that count.\n   *\n   * ```ts\n   * const all: Character[] = []\n   * let cursor: string | undefined\n   * do {\n   *   const page = await client.characters.list({ cursor })\n   *   all.push(...page.characters)\n   *   cursor = page.nextCursor ?? undefined\n   * } while (cursor)\n   * ```\n   */\n  list(params: ListCharactersParams = {}): Promise<ListCharactersResult> {\n    const query: Record<string, string | undefined> = {}\n    if (params.projectId) query.projectId = params.projectId\n    if (params.archived) query.archived = \"true\"\n    if (params.q) query.q = params.q\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    if (params.cursor) query.cursor = params.cursor\n    return this.client.request(\"GET\", \"/v1/characters\", { query })\n  }\n\n  /**\n   * Fetch a single character including in-flight portrait / asset job state.\n   * Soft-deleted (archived) rows are returned by id intentionally so canvas\n   * nodes that hold a stale `characterDbId` keep loading. Pass\n   * `{ candidates: \"all\" }` to also get the current portrait's own take in\n   * `previousCandidates` (flagged `isPortrait: true`).\n   */\n  get(id: string, options: GetCharacterOptions = {}): Promise<CharacterDetail> {\n    const query: Record<string, string | undefined> = {}\n    if (options.candidates) query.candidates = options.candidates\n    return this.client.request(\"GET\", `/v1/characters/${encodeURIComponent(id)}`, { query })\n  }\n\n  /**\n   * Create or update a character. Omit `id` to create; supply it to update\n   * (only the fields you pass get written — undefined keys are untouched).\n   *\n   * If the caller-supplied `name` collides with an existing active character\n   * for this user, the request returns 409 `name_taken`. To auto-number a\n   * placeholder, pass the placeholder name from `@nodaro/shared` and the\n   * server will derive \"Untitled character 2\", \"Untitled character 3\", etc.\n   */\n  upsert(input: UpsertCharacterInput): Promise<UpsertCharacterResult> {\n    return this.client.request(\"POST\", \"/v1/characters\", { body: input })\n  }\n\n  /**\n   * Convenience wrapper around `upsert()` for creating new characters.\n   * Equivalent to `upsert({ ...input, id: undefined })`. `name` is REQUIRED\n   * on create — the route 400s on INSERT-without-name; we narrow the type\n   * here so callers fail at compile-time rather than runtime.\n   */\n  create(\n    input: Omit<UpsertCharacterInput, \"id\"> & { name: string },\n  ): Promise<UpsertCharacterResult> {\n    return this.upsert(input)\n  }\n\n  /**\n   * Convenience wrapper around `upsert()` for updating an existing character.\n   * Equivalent to `upsert({ ...input, id })`.\n   */\n  update(\n    id: string,\n    input: Omit<UpsertCharacterInput, \"id\">,\n  ): Promise<UpsertCharacterResult> {\n    return this.upsert({ ...input, id })\n  }\n\n  /**\n   * Soft-delete (archive) a character. The row is hidden from `list()` by\n   * default but still loadable via `get(id)` so canvas nodes pointing at it\n   * keep working. Restore with `restore(id)`.\n   */\n  delete(id: string): Promise<{ success: true; archived: true }> {\n    return this.client.request(\"DELETE\", `/v1/characters/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Un-archive a character. If the original name now collides with an\n   * active row, the server auto-suffixes \"(restored)\" and returns the\n   * effective name.\n   */\n  restore(id: string): Promise<{ id: string; name: string }> {\n    return this.client.request(\"POST\", `/v1/characters/${encodeURIComponent(id)}/restore`)\n  }\n\n  /**\n   * Duplicate (fork) a character to a new row with a `\"(copy)\"` suffix.\n   * Asset URLs are shared by reference — the new row can diverge by\n   * regenerating any of them.\n   */\n  duplicate(id: string, input: DuplicateCharacterInput = {}): Promise<{ id: string; name: string }> {\n    return this.client.request(\n      \"POST\",\n      `/v1/characters/${encodeURIComponent(id)}/duplicate`,\n      { body: input },\n    )\n  }\n\n  /**\n   * Count of the caller's workflows that reference this character. Powers the\n   * library \"Archive\" confirmation modal in the editor.\n   */\n  usage(id: string): Promise<CharacterUsage> {\n    return this.client.request(\"GET\", `/v1/characters/${encodeURIComponent(id)}/usage`)\n  }\n\n  /**\n   * Fire `POST /v1/generate-character` to produce one or more portrait\n   * candidates. With `count > 1`, all jobs are reserved up-front before any\n   * is enqueued — mid-batch failures roll back atomically.\n   *\n   * When `attachToCharacterId` is set, the worker writes the result directly\n   * to the row's `source_image_url` (unless `attachPortrait: false`);\n   * otherwise you must call `approvePortrait()` after picking a candidate.\n   */\n  generate(input: GenerateCharacterInput): Promise<GenerateCharacterResult> {\n    return this.client.request(\"POST\", \"/v1/generate-character\", { body: input })\n  }\n\n  /**\n   * Fire `POST /v1/generate-character-asset` to produce a single\n   * expression / pose / angle / lighting variant. When the studio path is\n   * set (`attachToCharacterId` + `attachToColumn` + `attachName`), the\n   * worker appends `{ name: attachName, url: <result> }` to the named\n   * JSONB array column on completion.\n   */\n  generateAsset(input: GenerateAssetInput): Promise<{ jobId: string }> {\n    return this.client.request(\"POST\", \"/v1/generate-character-asset\", { body: input })\n  }\n\n  /**\n   * Fire `POST /v1/generate-character-motion` to animate the character's\n   * portrait into a motion clip. The result is appended to the character's\n   * `motions[]` bucket when `attachToCharacterId` is set.\n   */\n  generateMotion(input: GenerateMotionInput): Promise<{ jobId: string }> {\n    return this.client.request(\"POST\", \"/v1/generate-character-motion\", { body: input })\n  }\n\n  /**\n   * Approve a completed `generate-character` job as the character's portrait.\n   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)\n   * inline. Returns the new portrait URL plus the caption — `canonicalDescription`\n   * is `null` if the LLM call sub-failed (portrait still set; retry via `recaption()`).\n   */\n  approvePortrait(id: string, candidateJobId: string): Promise<ApprovePortraitResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/characters/${encodeURIComponent(id)}/approve-portrait`,\n      { body: { candidateJobId } },\n    )\n  }\n\n  /**\n   * Re-fire the LLM caption against the character's current portrait. 502s on\n   * LLM failure; returns 400 `no_portrait` if no portrait is set yet.\n   */\n  recaption(id: string): Promise<RecaptionResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/characters/${encodeURIComponent(id)}/llm-caption`,\n    )\n  }\n\n  /**\n   * Start training a high-fidelity model of the character on its own images\n   * (Nodaro Cloud only — other editions answer `NotFoundError`). Reserves the\n   * training price up front and refunds it if the training fails or is\n   * cancelled. Resolves at once (202); a training takes about 15 minutes —\n   * follow it with {@link trainingStatus}. Once it succeeds, a workflow's\n   * Generate Image node whose prompt @-mentions this one character runs on the\n   * trained model.\n   *\n   * An OAuth app token needs the `assets:write` scope (`ForbiddenError`\n   * otherwise, before anything is reserved); a session or personal API key\n   * needs none. Refusals are `NodaroError`s whose `code` is a\n   * {@link TrainCharacterRefusalCode}; rate-limited to 3 calls a minute.\n   */\n  train(id: string, input: TrainCharacterInput = {}): Promise<TrainCharacterResult> {\n    return this.client.request(\"POST\", `/v1/characters/${encodeURIComponent(id)}/train`, { body: input })\n  }\n\n  /**\n   * The character's training record (Nodaro Cloud only). Poll it while\n   * `status` is `queued` or `training` — every 10 s or so is plenty.\n   */\n  trainingStatus(id: string): Promise<CharacterTrainingStatus> {\n    return this.client.request(\"GET\", `/v1/characters/${encodeURIComponent(id)}/training`)\n  }\n\n  /**\n   * Remove the character's trained model (Nodaro Cloud only): cancels a\n   * training in flight and refunds its reservation, deletes the model, and\n   * clears the training record (`trainingStatus` then reads `untrained`).\n   * Generations go back to reference images. Cannot be undone — a new model\n   * means a new, paid training. An OAuth app token needs the `assets:write`\n   * scope (`ForbiddenError` otherwise), like deleting the character.\n   */\n  async deleteLora(id: string): Promise<void> {\n    await this.client.request(\"DELETE\", `/v1/characters/${encodeURIComponent(id)}/lora`)\n  }\n}\n\n/** Person catalog + hint helpers, re-exported from @nodaro/prompts (FSL-licensed). */\nexport { buildPersonHints, PEOPLE, PERSON_DIMENSION_ORDER, PERSON_DIMENSION_LABELS }\nexport type { PersonValue }\n\n/**\n * Collapse a PersonValue into the comma-joined seed-prompt fragment used by\n * `characters.generate({ seedPrompt })` — same composition the Nodaro editor\n * performs. Powered by @nodaro/prompts.\n */\nexport function buildPersonSeedPrompt(value: PersonValue): string {\n  return buildPersonHints(value as Record<string, unknown> & PersonValue).join(\", \")\n}\n"]}

package/dist/chunk-ELSOVJPF.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-ELSOVJPF.js.map
+//# sourceMappingURL=chunk-ELSOVJPF.js.map

package/dist/chunk-ELSOVJPF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ELSOVJPF.js"}

package/dist/chunk-ERLXU47J.js

@@ -0,0 +1,29 @@
+// 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 } : {}
+      }
+    });
+  }
+};
+
+export { VideoProResource };
+//# sourceMappingURL=chunk-ERLXU47J.js.map
+//# sourceMappingURL=chunk-ERLXU47J.js.map

package/dist/chunk-ERLXU47J.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/video-pro.ts"],"names":[],"mappings":";AA8CO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA,EAIpB,KAAK,KAAA,EAA4C;AAC/C,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,CAAA,uBAAA,EAA0B,kBAAA,CAAmB,KAAK,CAAC,CAAA,KAAA;AAAA,KACrD;AAAA,EACF;AAAA;AAAA;AAAA,EAIA,WAAA,CACE,OACA,IAAA,EACiC;AACjC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MACpE,IAAA,EAAM;AAAA,QACJ,SAAA,EAAW,KAAA;AAAA,QACX,GAAI,MAAM,WAAA,KAAgB,MAAA,GAAY,EAAE,WAAA,EAAa,IAAA,CAAK,WAAA,EAAY,GAAI;AAAC;AAC7E,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-ERLXU47J.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Generate Video Pro control surface (Cloud edition) — the checkpointed\n * long-video engine's stop/continue operations. The generation itself is\n * dispatched like any other node (`POST /v1/generate-video-pro`); these\n * endpoints act on an EXISTING run:\n *\n * - `stop(jobId)` — graceful stop: the engine abandons the in-flight segment\n *   generation (that segment is still billed — the provider keeps rendering\n *   it), skips all remaining segments, stitches everything completed so far\n *   into the job's FINAL video, and refunds the untouched remainder of the\n *   reserve. A job that hasn't started yet is cancelled with a full refund\n *   instead. Poll the job as usual: it completes with `output_data.pro\n *   .stopped === true` and `stoppedAtSegment`.\n *\n * - `continueRun(jobId, opts?)` — a NEW job that resumes from\n *   `opts.fromSegment` (1-based; omitted → the first not-yet-delivered\n *   segment). Segments before it are reused from the parent; everything from\n *   it on is regenerated (overriding the parent's takes). Charged only for\n *   the regenerated segments plus the flat pro fee. Works on stopped, failed\n *   (with ≥1 delivered segment), and fully completed runs (tail re-roll via\n *   an explicit `fromSegment`).\n */\nexport interface StopVideoProResult {\n  jobId: string\n  /** Present when the run was processing — the engine finalizes within\n   *  seconds; keep polling the job. */\n  stopping?: boolean\n  /** Present when the job had not started — the generic cancel ran instead\n   *  (full refund). */\n  success?: boolean\n  cancelled?: number\n}\n\nexport interface ContinueVideoProResult {\n  /** The NEW job to poll — the continuation run. */\n  jobId: string\n  continuedFromJobId?: string\n  /** 1-based first regenerated segment. */\n  fromSegment?: number\n  segmentCount?: number\n  /** Present when an idempotency key matched an existing continuation. */\n  deduped?: boolean\n}\n\nexport class VideoProResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Gracefully stop a running generate-video-pro job (keep + deliver the\n   *  completed segments; refund the rest). */\n  stop(jobId: string): Promise<StopVideoProResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/generate-video-pro/${encodeURIComponent(jobId)}/stop`,\n    )\n  }\n\n  /** Continue a stopped/failed/completed run from a segment (a NEW job).\n   *  Named `continueRun` because `continue` is a reserved word. */\n  continueRun(\n    jobId: string,\n    opts?: { fromSegment?: number },\n  ): Promise<ContinueVideoProResult> {\n    return this.client.request(\"POST\", \"/v1/generate-video-pro/continue\", {\n      body: {\n        fromJobId: jobId,\n        ...(opts?.fromSegment !== undefined ? { fromSegment: opts.fromSegment } : {}),\n      },\n    })\n  }\n}\n"]}

package/dist/chunk-ES2E65HT.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-ES2E65HT.js.map
+//# sourceMappingURL=chunk-ES2E65HT.js.map

package/dist/chunk-ES2E65HT.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-ES2E65HT.js"}

package/dist/chunk-EXLAHZKF.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-EXLAHZKF.js.map
+//# sourceMappingURL=chunk-EXLAHZKF.js.map

package/dist/chunk-EXLAHZKF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-EXLAHZKF.js"}

package/dist/chunk-FHEYAW5H.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-FHEYAW5H.js.map
+//# sourceMappingURL=chunk-FHEYAW5H.js.map

package/dist/chunk-FHEYAW5H.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-FHEYAW5H.js"}

package/dist/chunk-GA4LZZKQ.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+// 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 });
+  }
+};
+
+exports.AudioResource = AudioResource;
+//# sourceMappingURL=chunk-GA4LZZKQ.cjs.map
+//# sourceMappingURL=chunk-GA4LZZKQ.cjs.map

package/dist/chunk-GA4LZZKQ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/audio.ts"],"names":[],"mappings":";;;AA+CO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,SAAS,KAAA,EAAoI;AAC3I,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,wBAAwB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC/F;AAAA;AAAA,EAGA,QAAQ,KAAA,EAAyD;AAC/D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,uBAAuB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC9F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,QAAQ,KAAA,EAQuB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACvF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,IAAI,KAAA,EAY2B;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,iBAAiB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACxF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAa,KAAA,EAOkB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,KAAA,EAMoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC1F;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAQ,KAAA,EAA+G;AACrH,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,qBAAqB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,WAAW,KAAA,EAOoB;AAC7B,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,kBAAkB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACzF;AACF","file":"chunk-GA4LZZKQ.cjs","sourcesContent":["import type { AudioFxPreset } from \"@nodaro/shared/media\"\nimport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { Transcript } from \"@nodaro/shared/edl\"\nexport type { TranscribeProvider } from \"@nodaro/shared/models\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * One word of a {@link AudioResource.transcribe} result — caption-shaped, in\n * MILLISECONDS, and structurally the `captions[]` entry `media.addCaptions()`\n * takes, so a word list can be passed straight through. `speaker` is present\n * only on a diarized `elevenlabs-stt` run.\n */\nexport interface TranscribeWord {\n  text: string\n  startMs: number\n  endMs: number\n  timestampMs?: number | null\n  confidence?: number | null\n  speaker?: string\n}\n\n/**\n * A completed transcribe job's `output_data` (read it off `jobs.get(jobId)`).\n *\n * Mind the units: `words` and `json.words` are in MILLISECONDS, while the\n * top-level `segments` are in SECONDS (the raw per-utterance ranges) — present\n * only on the legacy lanes; `elevenlabs-stt` returns none, so read `words`.\n */\nexport interface TranscribeJobOutput {\n  /** The full transcript as one string. */\n  text: string\n  /** Detected (or requested) language code. */\n  language?: string\n  /** Per-word timings, ms — present on the word-level lanes. */\n  words?: TranscribeWord[]\n  /** The normalized {@link Transcript} (ms), the shape `edit.*` consumes. */\n  json?: Transcript\n  /** Per-utterance ranges in SECONDS — not ms, unlike everything above. */\n  segments?: Array<{ start: number; end: number; text: string }>\n}\n\n/**\n * Audio primitives — the building blocks Voice Changer Pro composes internally\n * (separation, isolation, effect, mix, level) plus speech-to-text, exposed\n * standalone so a consumer can run any single step or assemble its own\n * pipeline. Each returns a job id to poll (`jobs.get(jobId)`).\n */\nexport class AudioResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Separate an audio track into stems (`POST /v1/audio-separation`, Demucs).\n   * `mode` `\"vocal_instrumental\"` (default) splits voice from music/SFX;\n   * `\"stems\"` returns the full drums/bass/other/… breakdown. `quality`\n   * `auto` (default) / `fast` / `best`.\n   */\n  separate(input: { audioUrl: string; mode?: \"vocal_instrumental\" | \"stems\"; quality?: \"auto\" | \"fast\" | \"best\" }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-separation\", { body: input })\n  }\n\n  /** Isolate the primary voice and strip background noise (`POST /v1/audio-isolation`, ElevenLabs). */\n  isolate(input: { audioUrl: string }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-isolation\", { body: input })\n  }\n\n  /**\n   * Apply a reverb / echo / telephone / megaphone effect to an audio track\n   * (`POST /v1/audio-fx`) — the same presets VCP's `voiceFx` uses, standalone.\n   * `mix` (0–100) is the reverb wet/dry; `delayMs` + `decay` drive `echo`/`custom`;\n   * `eqLow`/`eqHigh` (dB) shape telephone/megaphone.\n   */\n  applyFx(input: {\n    audioUrl: string\n    preset?: AudioFxPreset\n    mix?: number\n    delayMs?: number\n    decay?: number\n    eqLow?: number\n    eqHigh?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/audio-fx\", { body: input })\n  }\n\n  /**\n   * Layer multiple audio tracks into one (`POST /v1/mix-audio`). `audioUrls`\n   * (2–20) are summed; optional `trackVolumes` (0–200% each, positionally) set\n   * per-track level. `duck` puts a music bed under speech: every track EXCEPT\n   * `duck.under` (the 0-based index of the voice track) dips while that track\n   * is loud and rises back in its pauses (sidechain compression). `amount`\n   * (0–100, default 75) is how hard; `thresholdDb` (-60–0, default -30),\n   * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and\n   * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix\n   * sums its tracks rather than averaging them, so the voice keeps its level;\n   * the price is the same with or without a duck. `endAt` (`\"longest\"`, the\n   * default, or `\"voice\"`) says where the mix ends: `\"voice\"` ends it when the\n   * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track\n   * too: its audio is mixed, and a video with no sound is a silent track.\n   */\n  mix(input: {\n    audioUrls: string[]\n    trackVolumes?: number[]\n    duck?: {\n      under: number\n      amount?: number\n      thresholdDb?: number\n      ratio?: number\n      attackMs?: number\n      releaseMs?: number\n    }\n    endAt?: \"longest\" | \"voice\"\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/mix-audio\", { body: input })\n  }\n\n  /**\n   * Adjust an audio (or a video's audio) level (`POST /v1/adjust-volume`):\n   * `volume` % (default 100), `normalize` to loudnorm, and `fadeIn`/`fadeOut`\n   * seconds. Provide `audioUrl` or `videoUrl`.\n   */\n  adjustVolume(input: {\n    audioUrl?: string\n    videoUrl?: string\n    volume?: number\n    normalize?: boolean\n    fadeIn?: number\n    fadeOut?: number\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/adjust-volume\", { body: input })\n  }\n\n  /**\n   * Shift pitch and/or change tempo with Rubber Band (`POST /v1/pitch-tempo`):\n   * `semitones` −12…+12 (default 0), `tempo` 0.5…2 with the pitch kept\n   * (default 1; fixed at 1 for a video), `preserveFormants` (default true).\n   * Provide exactly one of `audioUrl` or `videoUrl` — a video keeps its picture.\n   * Input up to 30 minutes, priced per started minute.\n   */\n  pitchTempo(input: {\n    audioUrl?: string\n    videoUrl?: string\n    semitones?: number\n    tempo?: number\n    preserveFormants?: boolean\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/pitch-tempo\", { body: input })\n  }\n\n  /**\n   * Concatenate audio segments end-to-end (`POST /v1/combine-audio`). Each\n   * segment is a `url` with an optional `[startTime, endTime]` sub-range.\n   */\n  combine(input: { segments: Array<{ url: string; startTime?: number; endTime?: number }> }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/combine-audio\", { body: input })\n  }\n\n  /**\n   * Transcribe an audio (or video) track to text (`POST /v1/transcribe`).\n   *\n   * Three engines are accepted. `elevenlabs-stt` (Scribe) is always word-level,\n   * flag or not, and is the only lane that honours `diarize` (who spoke) and\n   * `tagAudioEvents` (laughter, applause, …); `incredibly-fast-whisper` returns\n   * word timings when you ask for them. `whisper` returns NO word timings at\n   * all — named explicitly or reached by OMITTING `provider`, which still falls\n   * back to it — so asking it for them (`wordTimestamps: true`) is rejected with\n   * a `400 validation_error` at ingress, before any credit is spent. A kinetic\n   * caption render therefore has to name one of the other two.\n   *\n   * Poll `jobs.get(jobId)`; the finished job's `output_data` is a\n   * {@link TranscribeJobOutput}: `text` (the whole transcript), `words`\n   * (caption-shaped, in MILLISECONDS), `json` (the normalized\n   * {@link Transcript}, also ms) — and a top-level `segments` array that is in\n   * SECONDS, not ms.\n   *\n   * `words` is the caption source for a kinetic burn-in: hand it to\n   * `media.addCaptions()` as `captions` with `autoTranscribe: false` and the\n   * render uses those exact words (correct the `text` of an entry in between\n   * and the fix is what burns in).\n   */\n  transcribe(input: {\n    audioUrl: string\n    provider?: TranscribeProvider\n    language?: string\n    diarize?: boolean\n    tagAudioEvents?: boolean\n    wordTimestamps?: boolean\n  }): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/transcribe\", { body: input })\n  }\n}\n"]}

package/dist/chunk-GAZJ2PA3.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-GAZJ2PA3.js.map
+//# sourceMappingURL=chunk-GAZJ2PA3.js.map

package/dist/chunk-GAZJ2PA3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-GAZJ2PA3.js"}

package/dist/chunk-GB6C5OEZ.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+// 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 } : {}
+      }
+    });
+  }
+};
+
+exports.ReduceResource = ReduceResource;
+//# sourceMappingURL=chunk-GB6C5OEZ.cjs.map
+//# sourceMappingURL=chunk-GB6C5OEZ.cjs.map

package/dist/chunk-GB6C5OEZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/reduce.ts"],"names":[],"mappings":";;;AA6CO,IAAM,iBAAN,MAAqB;AAAA,EAC1B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWpB,IAAI,KAAA,EAA2C;AAC7C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,YAAA,EAAc;AAAA,MAC/C,IAAA,EAAM;AAAA,QACJ,YAAY,KAAA,CAAM,UAAA;AAAA,QAClB,cAAA,EAAgB,KAAA,CAAM,cAAA,IAAkB,EAAC;AAAA,QACzC,QAAQ,KAAA,CAAM,MAAA;AAAA,QACd,GAAI,MAAM,UAAA,KAAe,MAAA,GACrB,EAAE,UAAA,EAAY,KAAA,CAAM,UAAA,EAAW,GAC/B;AAAC;AACP,KACD,CAAA;AAAA,EACH;AACF","file":"chunk-GB6C5OEZ.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { ReduceStrategyId, ReduceMeta } from \"@nodaro/shared/workflow\"\n\n// Re-export the canonical types from `@nodaro/shared` (single source of\n// truth — the registry lives at `packages/shared/src/reduce-strategy-registry.ts`).\n// `@nodaro/shared` is already a hard dep of this package, so there's no\n// bundle-size cost to importing from it.\nexport type { ReduceStrategyId, ReduceMeta }\n\nexport interface ReduceInput {\n  /** Which fan-in strategy to run. */\n  strategyId: ReduceStrategyId\n  /**\n   * Strategy-specific config. Defaults to `{}` server-side, which uses every\n   * strategy's `defaultConfig`. Schemas (from `@nodaro/shared`):\n   *   - `pick-best-llm`: `{ criteria: string, inputKind?: \"text\" | \"image-url\", llmModel?: string }`\n   *     (`llmModel` = the judge model id from the LLM registry; omitted → the\n   *     feature default. Its tier sets the price: economy / standard / premium.)\n   *   - `concat`: `{ separator?: string }`\n   *   - `vote`: `{ caseSensitive?: boolean }`\n   *   - `merge-json`: `{ strategy?: \"deep\" | \"shallow\" }`\n   *   - `first-non-empty`, `count`: `{}`\n   */\n  strategyConfig?: Record<string, unknown>\n  /** Up to 1000 input strings (URLs, text fragments, etc.). */\n  inputs: string[]\n  /**\n   * Optional — associates this reduce run with a workflow execution. The\n   * server reads this from the body before Zod strips it (same path as\n   * other job-creating routes).\n   */\n  workflowId?: string\n}\n\nexport interface ReduceResult {\n  jobId: string\n  /**\n   * Stringified result — for `count` this is a numeric string, for\n   * `merge-json` this is the JSON-encoded merged object, otherwise the\n   * chosen / joined text.\n   */\n  output: string\n  meta: ReduceMeta\n}\n\nexport class ReduceResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Run the Reduce (fan-in) node directly — useful for scripted batch\n   * scoring, picking the best of N generations outside a workflow, or\n   * one-shot programmatic merges.\n   *\n   * Throws `NodaroError` on 4xx/5xx responses (e.g. `code: \"no_valid_inputs\"`\n   * with status 400 when every input is empty / whitespace; the underlying\n   * `EmptyInputError` is mapped to a 400 server-side).\n   */\n  run(input: ReduceInput): Promise<ReduceResult> {\n    return this.client.request(\"POST\", \"/v1/reduce\", {\n      body: {\n        strategyId: input.strategyId,\n        strategyConfig: input.strategyConfig ?? {},\n        inputs: input.inputs,\n        ...(input.workflowId !== undefined\n          ? { workflowId: input.workflowId }\n          : {}),\n      },\n    })\n  }\n}\n"]}

package/dist/chunk-GD24ZRFD.js

@@ -0,0 +1,3 @@
+
+//# sourceMappingURL=chunk-GD24ZRFD.js.map
+//# sourceMappingURL=chunk-GD24ZRFD.js.map

package/dist/chunk-GD24ZRFD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-GD24ZRFD.js"}

package/dist/chunk-GI7LROLL.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=chunk-GI7LROLL.cjs.map
+//# sourceMappingURL=chunk-GI7LROLL.cjs.map

package/dist/chunk-GI7LROLL.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"chunk-GI7LROLL.cjs"}