@nodaro/sdk 2.29.0 → 2.31.0

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"}

package/dist/chunk-GRFLPEM2.cjs

@@ -0,0 +1,16 @@
+'use strict';
+
+var organizations = require('@nodaro/shared/organizations');
+
+
+
+Object.defineProperty(exports, "USAGE_GROUP_BYS", {
+  enumerable: true,
+  get: function () { return organizations.USAGE_GROUP_BYS; }
+});
+Object.defineProperty(exports, "WORKSPACE_HEADER", {
+  enumerable: true,
+  get: function () { return organizations.WORKSPACE_HEADER; }
+});
+//# sourceMappingURL=chunk-GRFLPEM2.cjs.map
+//# sourceMappingURL=chunk-GRFLPEM2.cjs.map

package/dist/chunk-GRFLPEM2.cjs.map

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

package/dist/chunk-GVIFLUYZ.cjs

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

package/dist/chunk-GVIFLUYZ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/oauth.ts"],"names":[],"mappings":";;;AA8CO,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,aAAa,KAAA,EAAwD;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,iBAAA,EAAmB;AAAA,MACpD,IAAA,EAAM,EAAE,UAAA,EAAY,oBAAA,EAAsB,GAAG,KAAA;AAAM,KACpD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,KAAA,EAA2C;AAChD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,kBAAA,EAAoB,EAAE,IAAA,EAAM,EAAE,KAAA,EAAM,EAAG,CAAA;AAAA,EAC5E;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAA,CAAW,UAAkB,WAAA,EAA6C;AACxE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,oBAAA,EAAsB;AAAA,MACtD,KAAA,EAAO,WAAA,GAAc,EAAE,SAAA,EAAW,QAAA,EAAU,cAAc,WAAA,EAAY,GAAI,EAAE,SAAA,EAAW,QAAA;AAAS,KACjG,CAAA;AAAA,EACH;AACF","file":"chunk-GVIFLUYZ.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { DeveloperAppScope } from \"./developer-apps.js\"\n\n/**\n * Server-side authorization-code exchange payload. Field names are snake_case\n * per OAuth 2.0 (RFC 6749).\n */\nexport interface ExchangeCodeInput {\n  client_id: string\n  client_secret: string\n  /** Authorization code received from the consent redirect. */\n  code: string\n  /** Must match the redirect_uri used when issuing the code. */\n  redirect_uri: string\n}\n\n/**\n * `POST /v1/oauth/token` response — snake_case per RFC 6749. `expires_in` is\n * the token's lifetime in seconds.\n */\nexport interface AccessTokenResponse {\n  access_token: string\n  token_type: \"Bearer\"\n  /** Space-separated list of granted scopes. */\n  scope: string\n  expires_in: number\n}\n\n/**\n * Public app metadata for consent screens. Only safe-to-display fields —\n * no secret, no full origin list, no owner_user_id.\n */\nexport interface OAuthAppInfo {\n  name: string\n  description: string | null\n  logoUrl: string | null\n  homepageUrl: string | null\n  scopesRequested: DeveloperAppScope[]\n  /**\n   * Present when `getAppInfo` was given a `redirectUri`: whether that exact\n   * URI is registered for the app. `null` when none was given. Lets a consent\n   * screen refuse to redirect anywhere unregistered without exposing the list.\n   */\n  redirectUriRegistered?: boolean | null\n}\n\nexport class OAuthResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Server-side authorization-code exchange. Sends the standard OAuth 2.0\n   * `application/json` body to `POST /v1/oauth/token`.\n   *\n   * NEVER call this from a browser — `client_secret` must stay on the server.\n   */\n  exchangeCode(input: ExchangeCodeInput): Promise<AccessTokenResponse> {\n    return this.client.request(\"POST\", \"/v1/oauth/token\", {\n      body: { grant_type: \"authorization_code\", ...input },\n    })\n  }\n\n  /**\n   * Revoke an access token (RFC 7009). Always returns `{ success: true }`,\n   * even for unknown tokens — the spec forbids leaking token validity.\n   */\n  revoke(token: string): Promise<{ success: true }> {\n    return this.client.request(\"POST\", \"/v1/oauth/revoke\", { body: { token } })\n  }\n\n  /**\n   * Get public app metadata for a consent screen.\n   * `GET /v1/oauth/app-info?client_id=<id>`. Public route — no auth needed.\n   */\n  getAppInfo(clientId: string, redirectUri?: string): Promise<OAuthAppInfo> {\n    return this.client.request(\"GET\", \"/v1/oauth/app-info\", {\n      query: redirectUri ? { client_id: clientId, redirect_uri: redirectUri } : { client_id: clientId },\n    })\n  }\n}\n"]}

package/dist/chunk-H7VQTG4M.js

@@ -0,0 +1,35 @@
+// 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)}`);
+  }
+};
+
+export { ProjectsResource };
+//# sourceMappingURL=chunk-H7VQTG4M.js.map
+//# sourceMappingURL=chunk-H7VQTG4M.js.map

package/dist/chunk-H7VQTG4M.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/projects.ts"],"names":[],"mappings":";AAwBO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAAqC;AACnC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,cAAc,CAAA;AAAA,EAClD;AAAA;AAAA,EAGA,IAAI,EAAA,EAAwC;AAC1C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,KAAA,EAAO,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAC5E;AAAA;AAAA,EAGA,OAAO,KAAA,EAAuD;AAC5D,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EACpE;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAuD;AACxE,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,OAAA;AAAA,MACA,CAAA,aAAA,EAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAAA,MACtC,EAAE,MAAM,KAAA;AAAM,KAChB;AAAA,EACF;AAAA;AAAA,EAGA,OAAO,EAAA,EAAwC;AAC7C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,QAAA,EAAU,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAC/E;AACF","file":"chunk-H7VQTG4M.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\nexport interface Project {\n  id: string\n  userId: string\n  name: string\n  description?: string | null\n  settings?: Record<string, unknown>\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface CreateProjectInput {\n  name: string\n  description?: string\n  settings?: Record<string, unknown>\n}\n\nexport interface UpdateProjectInput {\n  name?: string\n  description?: string\n  settings?: Record<string, unknown>\n}\n\nexport class ProjectsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List the authenticated user's projects. */\n  list(): Promise<{ data: Project[] }> {\n    return this.client.request(\"GET\", \"/v1/projects\")\n  }\n\n  /** Get a project by ID. */\n  get(id: string): Promise<{ data: Project }> {\n    return this.client.request(\"GET\", `/v1/projects/${encodeURIComponent(id)}`)\n  }\n\n  /** Create a new project. */\n  create(input: CreateProjectInput): Promise<{ data: Project }> {\n    return this.client.request(\"POST\", \"/v1/projects\", { body: input })\n  }\n\n  /** Update a project. At least one field must be provided. */\n  update(id: string, input: UpdateProjectInput): Promise<{ data: Project }> {\n    return this.client.request(\n      \"PATCH\",\n      `/v1/projects/${encodeURIComponent(id)}`,\n      { body: input },\n    )\n  }\n\n  /** Delete a project. Returns `{ success: true }`. */\n  delete(id: string): Promise<{ success: true }> {\n    return this.client.request(\"DELETE\", `/v1/projects/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-HAKYPZLB.cjs

@@ -0,0 +1,242 @@
+'use strict';
+
+var person = require('@nodaro/prompts/person');
+var entities = require('@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 person.buildPersonHints(value).join(", ");
+}
+
+Object.defineProperty(exports, "PEOPLE", {
+  enumerable: true,
+  get: function () { return person.PEOPLE; }
+});
+Object.defineProperty(exports, "PERSON_DIMENSION_LABELS", {
+  enumerable: true,
+  get: function () { return person.PERSON_DIMENSION_LABELS; }
+});
+Object.defineProperty(exports, "PERSON_DIMENSION_ORDER", {
+  enumerable: true,
+  get: function () { return person.PERSON_DIMENSION_ORDER; }
+});
+Object.defineProperty(exports, "buildPersonHints", {
+  enumerable: true,
+  get: function () { return person.buildPersonHints; }
+});
+Object.defineProperty(exports, "CHARACTER_ASPECT_DEFAULTS", {
+  enumerable: true,
+  get: function () { return entities.CHARACTER_ASPECT_DEFAULTS; }
+});
+Object.defineProperty(exports, "CHARACTER_ASPECT_OPTIONS", {
+  enumerable: true,
+  get: function () { return entities.CHARACTER_ASPECT_OPTIONS; }
+});
+Object.defineProperty(exports, "CHARACTER_STYLES", {
+  enumerable: true,
+  get: function () { return entities.CHARACTER_STYLES; }
+});
+exports.CharactersResource = CharactersResource;
+exports.buildPersonSeedPrompt = buildPersonSeedPrompt;
+//# sourceMappingURL=chunk-HAKYPZLB.cjs.map
+//# sourceMappingURL=chunk-HAKYPZLB.cjs.map