@nodaro/sdk 2.29.0 → 2.32.0

package/dist/chunk-NBVARNVA.cjs

@@ -0,0 +1,38 @@
+'use strict';
+
+// src/resources/palettes.ts
+var PALETTE_DIRECTION_PREFIX = "palette:";
+function paletteDirectionId(id) {
+  return `${PALETTE_DIRECTION_PREFIX}${id}`;
+}
+var PalettesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Your palettes, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/palettes", {
+      query: { limit: params.limit, cursor: params.cursor }
+    });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/palettes/${encodeURIComponent(id)}`);
+  }
+  create(input) {
+    return this.client.request("POST", "/v1/palettes", { body: input });
+  }
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/palettes/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** A run that still names the palette answers 404 `direction_not_found`. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/palettes/${encodeURIComponent(id)}`);
+  }
+};
+
+exports.PALETTE_DIRECTION_PREFIX = PALETTE_DIRECTION_PREFIX;
+exports.PalettesResource = PalettesResource;
+exports.paletteDirectionId = paletteDirectionId;
+//# sourceMappingURL=chunk-NBVARNVA.cjs.map
+//# sourceMappingURL=chunk-NBVARNVA.cjs.map

package/dist/chunk-NBVARNVA.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/palettes.ts"],"names":[],"mappings":";;;AA4CO,IAAM,wBAAA,GAA2B;AAQjC,SAAS,mBAAmB,EAAA,EAAiC;AAClE,EAAA,OAAO,CAAA,EAAG,wBAAwB,CAAA,EAAG,EAAE,CAAA,CAAA;AACzC;AASO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA6B,EAAC,EAAyB;AAC1D,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAqB,KAAA,EAAO,cAAA,EAAgB;AAAA,MAC7D,OAAO,EAAE,KAAA,EAAO,OAAO,KAAA,EAAO,MAAA,EAAQ,OAAO,MAAA;AAAO,KACrD,CAAA;AAAA,EACH;AAAA,EAEA,IAAI,EAAA,EAAmC;AACrC,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAsB,KAAA,EAAO,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAC1F;AAAA,EAEA,OAAO,KAAA,EAAkD;AACvD,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAsB,MAAA,EAAQ,gBAAgB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClF;AAAA,EAEA,MAAA,CAAO,IAAY,KAAA,EAAkD;AACnE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAsB,OAAA,EAAS,CAAA,aAAA,EAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC7G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACjG;AACF","file":"chunk-NBVARNVA.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/** One of your colour palettes. */\nexport interface ColorPalette {\n  id: string\n  name: string\n  /** 2–12 colours, `#RRGGBB`, upper case. */\n  colors: string[]\n  /** Your own note. It is not put into the prompt. */\n  description: string | null\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface CreatePaletteInput {\n  /** 1–80 characters. */\n  name: string\n  /** 2–12 colours, `#RRGGBB` (any case; stored upper case). */\n  colors: string[]\n  /** Up to 500 characters. */\n  description?: string | null\n}\n\n/** Only the fields you send are written; `description: null` clears it. */\nexport interface UpdatePaletteInput {\n  name?: string\n  colors?: string[]\n  description?: string | null\n}\n\nexport interface ListPalettesParams {\n  /** Page size, 1–100 (server default 50). */\n  limit?: number\n  /** The previous page's `nextCursor`. */\n  cursor?: string\n}\n\nexport interface PalettePage {\n  data: ColorPalette[]\n  /** Pass back as `cursor` for the next page; `null` on the last one. */\n  nextCursor: string | null\n}\n\n/** The prefix of a palette's generate-image direction id (`direction.colorLook`). */\nexport const PALETTE_DIRECTION_PREFIX = \"palette:\" as const\n\n/**\n * A palette as a generate-image direction value — put it on\n * `direction.colorLook`. The run names each colour (an everyday name and its\n * hex) in the prompt; the job keeps the id, so a re-run uses the palette as it\n * is then.\n */\nexport function paletteDirectionId(id: string): `palette:${string}` {\n  return `${PALETTE_DIRECTION_PREFIX}${id}`\n}\n\n/**\n * Colour palettes — `GET/POST /v1/palettes`, `GET/PATCH/DELETE /v1/palettes/:id`.\n *\n * Yours only (another person's id answers 404). Use one on generate-image as\n * `direction: { colorLook: paletteDirectionId(id) }`. OAuth app tokens need\n * `assets:read` for reads and `assets:write` for writes.\n */\nexport class PalettesResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** Your palettes, newest first. Page with `nextCursor`. */\n  list(params: ListPalettesParams = {}): Promise<PalettePage> {\n    return this.client.request<PalettePage>(\"GET\", \"/v1/palettes\", {\n      query: { limit: params.limit, cursor: params.cursor },\n    })\n  }\n\n  get(id: string): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"GET\", `/v1/palettes/${encodeURIComponent(id)}`)\n  }\n\n  create(input: CreatePaletteInput): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"POST\", \"/v1/palettes\", { body: input })\n  }\n\n  update(id: string, input: UpdatePaletteInput): Promise<ColorPalette> {\n    return this.client.request<ColorPalette>(\"PATCH\", `/v1/palettes/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** A run that still names the palette answers 404 `direction_not_found`. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/palettes/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-NCCBS6GU.js

@@ -0,0 +1,42 @@
+// src/resources/saved-posts.ts
+var SavedPostsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/saved-posts", {
+      query: {
+        platform: params.platform,
+        tag: params.tag,
+        q: params.q,
+        cursor: params.cursor,
+        limit: params.limit
+      }
+    });
+  }
+  /**
+   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved
+   * updates its note and tags (when given) and returns the existing save.
+   */
+  save(input) {
+    return this.client.request("POST", "/v1/saved-posts", { body: input });
+  }
+  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */
+  lookup(postIds) {
+    return this.client.request("POST", "/v1/saved-posts/lookup", { body: { postIds } });
+  }
+  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */
+  async delete(id) {
+    await this.client.request("DELETE", `/v1/saved-posts/${encodeURIComponent(id)}`);
+  }
+};
+
+export { SavedPostsResource };
+//# sourceMappingURL=chunk-NCCBS6GU.js.map
+//# sourceMappingURL=chunk-NCCBS6GU.js.map

package/dist/chunk-NCCBS6GU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/saved-posts.ts"],"names":[],"mappings":";AAkBO,IAAM,qBAAN,MAAyB;AAAA,EAC9B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,CAAK,MAAA,GAA+B,EAAC,EAAkC;AACrE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA8B,KAAA,EAAO,iBAAA,EAAmB;AAAA,MACzE,KAAA,EAAO;AAAA,QACL,UAAU,MAAA,CAAO,QAAA;AAAA,QACjB,KAAK,MAAA,CAAO,GAAA;AAAA,QACZ,GAAG,MAAA,CAAO,CAAA;AAAA,QACV,QAAQ,MAAA,CAAO,MAAA;AAAA,QACf,OAAO,MAAA,CAAO;AAAA;AAChB,KACD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KAAK,KAAA,EAA0C;AAC7C,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAmB,MAAA,EAAQ,mBAAmB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClF;AAAA;AAAA,EAGA,OAAO,OAAA,EAA6D;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,wBAAA,EAA0B,EAAE,IAAA,EAAM,EAAE,OAAA,EAAQ,EAAG,CAAA;AAAA,EAC5G;AAAA;AAAA,EAGA,MAAA,CAAO,IAAY,KAAA,EAAiD;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmB,OAAA,EAAS,CAAA,gBAAA,EAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA,EAAI,EAAE,IAAA,EAAM,KAAA,EAAO,CAAA;AAAA,EAC7G;AAAA;AAAA,EAGA,MAAM,OAAO,EAAA,EAA2B;AACtC,IAAA,MAAM,IAAA,CAAK,OAAO,OAAA,CAA2B,QAAA,EAAU,mBAAmB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACpG;AACF","file":"chunk-NCCBS6GU.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type {\n  ListSavedPostsParams,\n  ListSavedPostsResult,\n  SavePostInput,\n  SavedPost,\n  SavedPostsLookupResult,\n  UpdateSavedPostInput,\n} from \"@nodaro/shared/social\"\n\n/**\n * Saved posts — the inspiration wall.\n *\n * Save a post you found (a Social Search result, `nodes.run(\"social-search\")`)\n * with a note and tags, list and filter your saves, and change or remove them.\n * A save keeps a snapshot of the post and a copy of its still in your storage.\n * OAuth app tokens need `assets:read` for reads and `assets:write` for writes.\n */\nexport class SavedPostsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** `GET /v1/saved-posts` → your saves, newest first. Page with `nextCursor`. */\n  list(params: ListSavedPostsParams = {}): Promise<ListSavedPostsResult> {\n    return this.client.request<ListSavedPostsResult>(\"GET\", \"/v1/saved-posts\", {\n      query: {\n        platform: params.platform,\n        tag: params.tag,\n        q: params.q,\n        cursor: params.cursor,\n        limit: params.limit,\n      },\n    })\n  }\n\n  /**\n   * `POST /v1/saved-posts` → save a post. Saving a post that is already saved\n   * updates its note and tags (when given) and returns the existing save.\n   */\n  save(input: SavePostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"POST\", \"/v1/saved-posts\", { body: input })\n  }\n\n  /** `POST /v1/saved-posts/lookup` → which of these post ids (`SocialPost.id`) you saved. */\n  lookup(postIds: readonly string[]): Promise<SavedPostsLookupResult> {\n    return this.client.request<SavedPostsLookupResult>(\"POST\", \"/v1/saved-posts/lookup\", { body: { postIds } })\n  }\n\n  /** `PATCH /v1/saved-posts/:id` → change a save's note or tags. */\n  update(id: string, input: UpdateSavedPostInput): Promise<SavedPost> {\n    return this.client.request<SavedPost>(\"PATCH\", `/v1/saved-posts/${encodeURIComponent(id)}`, { body: input })\n  }\n\n  /** `DELETE /v1/saved-posts/:id` → remove a save and its copied still. */\n  async delete(id: string): Promise<void> {\n    await this.client.request<{ success: true }>(\"DELETE\", `/v1/saved-posts/${encodeURIComponent(id)}`)\n  }\n}\n"]}

package/dist/chunk-NGKODS3J.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+// src/resources/billing.ts
+var BillingResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * `GET /v1/billing/plans` → the plans and credit packs on sale, with their
+   * prices. Public: works with no credential, the same for every caller.
+   * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403
+   * self_serve_disabled` (this deployment does not sell to its users) and on
+   * `503` (`stripe_not_configured`, or prices briefly unavailable).
+   */
+  plans() {
+    return this.client.request("GET", "/v1/billing/plans");
+  }
+  /**
+   * `GET /v1/billing/subscription` → the account's latest subscription
+   * (`null` when it never subscribed) and the tier its entitlements follow.
+   * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current
+   * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in
+   * session, a personal API token without a workflow limit, or an app's OAuth
+   * token. Nodaro Cloud only — a self-hosted instance answers 404.
+   */
+  subscription() {
+    return this.client.request("GET", "/v1/billing/subscription");
+  }
+  /**
+   * `GET /v1/billing/surface` → how this deployment bills: whether it meters
+   * at all (`providerId !== "none"`) and in which unit costs display. Public,
+   * every edition.
+   */
+  async surface() {
+    const res = await this.client.request("GET", "/v1/billing/surface");
+    return res.data;
+  }
+  /**
+   * `GET /v1/billing/account` → the caller's plan and balance as the
+   * deployment's billing provider reports them, in its display unit. `null`
+   * when the provider could not answer — not a zero balance. Every edition.
+   */
+  async account() {
+    const res = await this.client.request("GET", "/v1/billing/account");
+    return res.data;
+  }
+};
+
+exports.BillingResource = BillingResource;
+//# sourceMappingURL=chunk-NGKODS3J.cjs.map
+//# sourceMappingURL=chunk-NGKODS3J.cjs.map

package/dist/chunk-NGKODS3J.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/billing.ts"],"names":[],"mappings":";;;AA6KO,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,KAAA,GAAqC;AACnC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA4B,KAAA,EAAO,mBAAmB,CAAA;AAAA,EAC3E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,YAAA,GAAmD;AACjD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAmC,KAAA,EAAO,0BAA0B,CAAA;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAA,GAAmC;AACvC,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAkC,OAAO,qBAAqB,CAAA;AAC5F,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,OAAA,GAAiD;AACrD,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgD,OAAO,qBAAqB,CAAA;AAC1G,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AACF","file":"chunk-NGKODS3J.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Plans and prices, the subscription, and the billing surface — the shapes of\n * the `/v1/billing/*` routes an app may call. Mirrors the backend routes\n * (`backend/src/ee/routes/billing.ts`, `backend/src/routes/billing-surface.ts`),\n * the source of truth: keep these in sync if they change.\n *\n * Buying, changing the plan and the payment settings stay in the Nodaro app:\n * those routes refuse API and app tokens, so they have no method here.\n */\n\n/** A sum of money in its currency's major unit (`12` = 12.00), with its ISO-4217 code (`\"USD\"`). */\nexport interface BillingMoney {\n  amount: number\n  currency: string\n}\n\n/** The credits a price grants, and how often. */\nexport interface BillingPriceCredits {\n  amount: number\n  per: \"month\" | \"year\"\n}\n\n/** A monthly price, and what it grants. */\nexport interface BillingMonthlyPrice extends BillingMoney {\n  /** `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\n/** A yearly price, what it comes to per month, and what it grants. */\nexport interface BillingYearlyPrice extends BillingMoney {\n  /** The yearly amount spread over the months it pays for; `null` when that cannot be said. */\n  perMonth: number | null\n  /** What the price grants — the plan's credits every month, as a monthly price; `null` when the price does not state it. */\n  credits: BillingPriceCredits | null\n}\n\nexport interface BillingPlanPrices {\n  /** `null` = Stripe cannot sell this price right now: show it as unavailable, never as free. */\n  monthly: BillingMonthlyPrice | null\n  yearly: BillingYearlyPrice | null\n}\n\n/** One plan on sale. */\nexport interface BillingPlan {\n  /** `\"free\"`, `\"basic\"`, `\"standard\"`, … — the stable id. */\n  id: string\n  name: string\n  /** `null` for the free plan: there is nothing to pay. */\n  prices: BillingPlanPrices | null\n  /** The free plan's one-time grant at sign-up; `null` on a paid plan, whose credits come with each price. */\n  signupCredits: number | null\n  /** How many nodes of one workflow run at once. */\n  parallelism: number\n  /** Storage for your media, in bytes. */\n  storageBytes: number\n}\n\n/** A credit pack: this many credits for this price. */\nexport interface BillingTopUp {\n  id: string\n  credits: number\n  /** `null` when the pack's price cannot be stated right now: show it as unavailable. */\n  price: BillingMoney | null\n}\n\n/** The answer of `GET /v1/billing/plans`. */\nexport interface BillingPlansResult {\n  /** The free plan first, then each paid plan from the smallest. */\n  data: BillingPlan[]\n  /** The credit packs, from the smallest. */\n  topUps: BillingTopUp[]\n  /** Any whole amount in this range can be loaded as credits, at the same rate as the packs. */\n  topUpRange: { min: number; max: number; currency: string }\n}\n\n/** The account's latest subscription record. */\nexport interface BillingSubscription {\n  id: string\n  stripe_subscription_id: string | null\n  /** The plan id: `\"basic\"`, `\"standard\"`, … */\n  tier: string\n  /** `\"active\"`, `\"trialing\"`, `\"past_due\"`, `\"paused\"`, `\"canceled\"`, `\"incomplete\"` or `\"expired\"`. */\n  status: string\n  stripe_price_id: string | null\n  /** ISO-8601. */\n  current_period_start: string | null\n  /** ISO-8601: when the current period ends (and renews, unless cancelled). */\n  current_period_end: string | null\n  /** True when the subscription ends at `current_period_end` instead of renewing. */\n  cancel_at_period_end: boolean\n  /** ISO-8601: when a scheduled cancellation takes effect. */\n  cancel_at: string | null\n  /** ISO-8601: when it was cancelled. */\n  canceled_at: string | null\n}\n\n/** The answer of `GET /v1/billing/subscription`. */\nexport interface BillingSubscriptionResult {\n  /** `null` when the account never subscribed. */\n  data: BillingSubscription | null\n  /**\n   * The tier the account's entitlements follow: usually a plan id from\n   * `plans()` (`\"free\"` included); `\"payg\"` — no subscription, but credits\n   * bought (every model, no watermark); or a tier that is not on sale, such\n   * as `\"enterprise\"`.\n   */\n  effectiveTier: string\n}\n\n/** How this deployment bills, the same for every caller (`GET /v1/billing/surface`). */\nexport interface BillingSurface {\n  /** The billing-surface contract version (an integer). */\n  contract: number\n  /** The registered billing provider; `\"none\"` = this deployment meters nothing. */\n  providerId: string\n  /** The unit costs display in by default (`\"credits\"`, `\"usd\"`, or a deployment's own label). */\n  displayUnit: string\n  canReport: boolean\n  canQuote: boolean\n  canAccount: boolean\n  /** Whether a cost view belongs on this deployment. */\n  mountCostTab: boolean\n  /** One billing account pays for every user here. */\n  deploymentPayer: boolean\n}\n\n/** One row of {@link BillingAccountSummary.byCategory}. */\nexport interface BillingUsageCategory {\n  category: string\n  count: number\n  /** Spend in the display unit; `null` = unavailable, never 0. */\n  amount: number | null\n  spent: BillingMoney | null\n}\n\n/**\n * The caller's account as the deployment's billing provider sees it\n * (`GET /v1/billing/account`). Money and amounts are `null` when the provider\n * could not say: show that distinctly, never as 0. A field the provider leaves\n * out is a concept it does not have.\n */\nexport interface BillingAccountSummary {\n  /** A plain string; `\"unknown\"` is a real answer. */\n  plan: string\n  balance: number | null\n  dailyAllowance: number | null\n  unit: string\n  /** `\"external_wallet\"` when the balance comes from a wallet outside Nodaro. */\n  balanceSource?: \"external_wallet\"\n  /** ISO-8601 start of the current usage period. */\n  periodStart?: string | null\n  /** Generations this period. */\n  generations?: number | null\n  /** Money spent this period. */\n  spent?: BillingMoney | null\n  /** Pay-as-you-go state. */\n  payg?: {\n    enabled: boolean\n    reserve: number | null\n    rate: { creditsPerUnit: number; currency: string } | null\n    monthlyCap: BillingMoney | null\n  } | null\n  /** The daily cap and when it resets; prefer it over `dailyAllowance` when present. `limit: 0` means blocked. */\n  daily?: { limit: number; used: number; remaining: number; resetsAt: string } | null\n  /** Money value of the pay-as-you-go reserve. */\n  reserveValue?: BillingMoney | null\n  byCategory?: BillingUsageCategory[] | null\n  /** The total the balance is drawn from, where the provider grants each user an allocation. */\n  allocated?: number | null\n}\n\nexport class BillingResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * `GET /v1/billing/plans` → the plans and credit packs on sale, with their\n   * prices. Public: works with no credential, the same for every caller.\n   * Nodaro Cloud only — a self-hosted instance answers 404. Throws on `403\n   * self_serve_disabled` (this deployment does not sell to its users) and on\n   * `503` (`stripe_not_configured`, or prices briefly unavailable).\n   */\n  plans(): Promise<BillingPlansResult> {\n    return this.client.request<BillingPlansResult>(\"GET\", \"/v1/billing/plans\")\n  }\n\n  /**\n   * `GET /v1/billing/subscription` → the account's latest subscription\n   * (`null` when it never subscribed) and the tier its entitlements follow.\n   * Match `effectiveTier` to a {@link BillingPlan} `id` to mark the current\n   * plan (no match: pay-as-you-go, or a tier not on sale). Needs a signed-in\n   * session, a personal API token without a workflow limit, or an app's OAuth\n   * token. Nodaro Cloud only — a self-hosted instance answers 404.\n   */\n  subscription(): Promise<BillingSubscriptionResult> {\n    return this.client.request<BillingSubscriptionResult>(\"GET\", \"/v1/billing/subscription\")\n  }\n\n  /**\n   * `GET /v1/billing/surface` → how this deployment bills: whether it meters\n   * at all (`providerId !== \"none\"`) and in which unit costs display. Public,\n   * every edition.\n   */\n  async surface(): Promise<BillingSurface> {\n    const res = await this.client.request<{ data: BillingSurface }>(\"GET\", \"/v1/billing/surface\")\n    return res.data\n  }\n\n  /**\n   * `GET /v1/billing/account` → the caller's plan and balance as the\n   * deployment's billing provider reports them, in its display unit. `null`\n   * when the provider could not answer — not a zero balance. Every edition.\n   */\n  async account(): Promise<BillingAccountSummary | null> {\n    const res = await this.client.request<{ data: BillingAccountSummary | null }>(\"GET\", \"/v1/billing/account\")\n    return res.data\n  }\n}\n"]}

package/dist/chunk-NJVSKUL2.cjs

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

package/dist/chunk-NJVSKUL2.cjs.map

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

package/dist/chunk-NLQQHJ25.cjs

@@ -0,0 +1,104 @@
+'use strict';
+
+var chunkKNMW722T_cjs = require('./chunk-KNMW722T.cjs');
+
+// src/resources/copilot.ts
+var COPILOT_FRAME_TYPES = /* @__PURE__ */ new Set([
+  "metadata",
+  "token",
+  "tool_call",
+  "workflow_updated",
+  "workflow_created",
+  "run_proposed",
+  "memory_saved",
+  "usage",
+  "done",
+  "error"
+]);
+function isCopilotFrame(value) {
+  if (typeof value !== "object" || value === null) return false;
+  const type = value.type;
+  return typeof type === "string" && COPILOT_FRAME_TYPES.has(type);
+}
+var CopilotResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on
+   * a workflow the server creates from `prompt`. Re-opening a workflow that
+   * already has an active thread answers THAT thread rather than a second one.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/copilot/threads", { body: input });
+  }
+  /**
+   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),
+   * or `null` when the user has none open on it.
+   */
+  list(params) {
+    return this.client.request("GET", "/v1/copilot/threads", { query: { workflowId: params.workflowId } });
+  }
+  /**
+   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads
+   * only what followed that sequence number (the panel's catch-up); `limit`
+   * caps the page at the server's own ceiling.
+   */
+  get(id, opts = {}) {
+    return this.client.request("GET", `/v1/copilot/threads/${encodeURIComponent(id)}`, {
+      query: { ...opts.after !== void 0 ? { after: opts.after } : {}, ...opts.limit !== void 0 ? { limit: opts.limit } : {} }
+    });
+  }
+  /**
+   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not
+   * deletion — the messages stay readable. Refused while a turn is running.
+   */
+  archive(id) {
+    return this.client.request("DELETE", `/v1/copilot/threads/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the
+   * turn it asked to stop; the turn's own stream ends with a `done` frame.
+   */
+  cancel(id) {
+    return this.client.request("POST", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`);
+  }
+  /**
+   * Send one message and iterate the turn's frames
+   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).
+   *
+   * Deliberately NOT routed through `client.request`: that path arms an abort
+   * timer around the whole exchange, and a turn legitimately runs for minutes —
+   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller
+   * owns the lifetime instead: pass `signal` to end the stream, or stop
+   * iterating (the reader cancels the body, which ends the request).
+   *
+   * A frame kind this package does not model is skipped rather than thrown, so
+   * a newer server cannot break an older caller.
+   */
+  async *stream(threadId, opts) {
+    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`;
+    const token = await this.client.auth.getToken();
+    const res = await this.client.fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...token ? { Authorization: `Bearer ${token}` } : {}
+      },
+      body: JSON.stringify({
+        message: opts.message,
+        ...opts.baseVersion !== void 0 ? { baseVersion: opts.baseVersion } : {},
+        ...opts.tier ? { tier: opts.tier } : {}
+      }),
+      signal: opts.signal
+    });
+    for await (const value of chunkKNMW722T_cjs.readSseStream(res, { label: "copilot stream" })) {
+      if (isCopilotFrame(value)) yield value;
+    }
+  }
+};
+
+exports.CopilotResource = CopilotResource;
+//# sourceMappingURL=chunk-NLQQHJ25.cjs.map
+//# sourceMappingURL=chunk-NLQQHJ25.cjs.map

package/dist/chunk-NLQQHJ25.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/copilot.ts"],"names":["readSseStream"],"mappings":"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","file":"chunk-NLQQHJ25.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport { readSseStream } from \"../sse.js\"\n\n/**\n * The assistant's conversation surface (`/v1/copilot/*`) — threads, and one\n * turn as a live stream.\n *\n * A thread is the conversation; a TURN is one message and everything the\n * assistant does in answer to it. `stream` is the only method that spends: it\n * POSTs the message and yields the turn's frames as they arrive, so a caller\n * renders prose, tool activity and proposals live instead of waiting for a\n * finished answer.\n *\n * Two shapes here are deliberately TOLERANT of a deployment that predates a\n * field, because the SDK ships ahead of every instance it talks to:\n *  - `surface` is optional on both {@link CopilotThread} and the `metadata`\n *    frame — absent is a value (\"this deployment does not say\"), never a\n *    default this package invents.\n *  - An event kind this package does not model is IGNORED, not thrown: a\n *    newer server may emit frames a caller was built before.\n */\n\n/** How this thread runs what it proposes: ask first, or run within a budget. */\nexport type CopilotRunMode = \"ask\" | \"auto\"\n\n/** The thread's model rung. Absent from a server that predates it. */\nexport type CopilotModelTier = \"economy\" | \"standard\" | \"premium\"\n\n/**\n * Which product the conversation belongs to.\n *\n * NO deployment sends this today — nothing in the platform emits it yet — and\n * it is typed here so that the day one does, a caller reads what the server\n * said. That is why it is OPTIONAL everywhere it appears: absent is a value\n * (\"this deployment does not say\"), never a default this package invents.\n */\nexport type CopilotSurface = \"studio\" | \"workflow\"\n\nexport interface CopilotThread {\n  id: string\n  workflowId: string\n  runMode: CopilotRunMode\n  /** See {@link CopilotSurface} — absent means the server did not say. */\n  surface?: CopilotSurface\n  /** Whether this thread may build nodes that publish to connected accounts. */\n  allowPublishing?: boolean\n  modelTier?: CopilotModelTier\n  autoRunLimitCredits: number\n  userTurnCount: number\n  lastMessageAt: string | null\n  createdAt: string\n  /** Only on {@link CopilotResource.get} — derived from a live turn. */\n  status?: \"running\" | \"idle\"\n  activeTurnId?: string | null\n}\n\n/** The workflow a thread was opened on, as `create` answers it. */\nexport interface CopilotThreadWorkflow {\n  id: string\n  projectId: string\n  name: string\n  version: number\n}\n\nexport type CopilotMessagePart =\n  | { kind: \"text\"; text: string }\n  | { kind: \"tool_call\"; id: string; name: string; label: string; status: \"finished\" | \"failed\" }\n\nexport interface CopilotMessage {\n  id: string\n  seq: number\n  turnId: string\n  role: \"user\" | \"assistant\"\n  createdAt: string\n  parts: CopilotMessagePart[]\n}\n\n/** Open a thread on an existing workflow, or on one this call creates. */\nexport interface CreateCopilotThreadInput {\n  /** The workflow to work on. Give this OR `prompt`. */\n  workflowId?: string\n  /** Start from nothing: the server creates a workflow seeded by this prompt. */\n  prompt?: string\n  /** Name for a workflow created by `prompt` (defaults to the prompt's head). */\n  name?: string\n}\n\nexport interface CopilotStreamOptions {\n  /** The user's turn. */\n  message: string\n  /** The workflow version this message was composed against — a newer one 409s. */\n  baseVersion?: number\n  /** The composer's echo of the thread's rung; the thread row stays authoritative. */\n  tier?: CopilotModelTier\n  /**\n   * Ends the stream. The client's request timeout is NOT applied to a turn.\n   *\n   * Aborting REJECTS the iteration — with the platform's raw `AbortError`, not\n   * a `NodaroError` — whether it fires before the first frame or between two of\n   * them. Wrap the loop in `try`/`catch` if a cancelled turn is an ordinary\n   * ending in your UI. (`media.downloadVideoProgress` behaves the same way.)\n   */\n  signal?: AbortSignal\n}\n\nexport interface CopilotToolCallFrameData {\n  id: string\n  name: string\n  label: string\n  status: \"started\" | \"finished\" | \"failed\"\n  summary?: string\n}\n\nexport interface CopilotWorkflowUpdateFrameData {\n  workflowId: string\n  version: number\n  updatedAt?: string\n  note?: string | null\n  addedNodeIds: string[]\n  updatedNodeIds: string[]\n  removedNodeIds: string[]\n  addedNodeTypes: string[]\n  nodeCount: number\n  edgeCount: number\n  adjustments: string[]\n}\n\n/** A file the turn wired onto a node — named on the run card, never counted. */\nexport interface CopilotWiredAsset {\n  id: string\n  kind: string\n  filename: string\n  nodeId: string\n}\n\nexport interface CopilotRunProposalNode {\n  id: string\n  type: string\n  graphVersion: number\n  label: string\n}\n\nexport interface CopilotRunProposalFrameData {\n  workflowId: string\n  addedNodeTypes: string[]\n  wiredAssets?: CopilotWiredAsset[]\n  note: string | null\n  /** Present when ONE node was proposed rather than the whole graph. */\n  node?: CopilotRunProposalNode | null\n}\n\n/** A workflow the turn created — a different one from the open canvas. */\nexport interface CopilotWorkflowCreatedFrameData {\n  workflowId: string\n  name: string\n  projectId: string\n}\n\n/** One thing the assistant saved to memory this turn. */\nexport interface CopilotMemorySavedFrameData {\n  id: string\n  content: string\n}\n\nexport interface CopilotMetadataFrameData {\n  threadId: string\n  turnId: string\n  jobId: string\n  model: string\n  baseVersion: number | null\n  runMode: CopilotRunMode\n  autoRunLimitCredits: number\n  allowPublishing?: boolean\n  modelTier?: CopilotModelTier\n  /** See {@link CopilotSurface} — absent means the server did not say. */\n  surface?: CopilotSurface\n}\n\n/**\n * One frame of a turn.\n *\n * The union covers the frame KINDS; a frame's `data` is passed through\n * untouched, so a field this package does not model still reaches the caller\n * rather than being stripped on the way.\n */\nexport type CopilotStreamFrame =\n  | { type: \"metadata\"; data: CopilotMetadataFrameData }\n  | { type: \"token\"; data: { text: string } }\n  | { type: \"tool_call\"; data: CopilotToolCallFrameData }\n  | { type: \"workflow_updated\"; data: CopilotWorkflowUpdateFrameData }\n  | { type: \"workflow_created\"; data: CopilotWorkflowCreatedFrameData }\n  | { type: \"run_proposed\"; data: CopilotRunProposalFrameData }\n  | { type: \"memory_saved\"; data: CopilotMemorySavedFrameData }\n  | { type: \"usage\"; data: { inputTokens: number; outputTokens: number; cacheReadTokens: number; creditsCharged: number | null } }\n  | { type: \"done\"; data: { turnId: string; messageId: string | null; status: \"completed\" | \"capped\" | \"cancelled\"; finalVersion: number | null } }\n  | { type: \"error\"; data: { code: string; message: string } }\n\n/** The kinds above, as the wire spells them — the whole of what `stream` yields. */\nconst COPILOT_FRAME_TYPES: ReadonlySet<string> = new Set([\n  \"metadata\",\n  \"token\",\n  \"tool_call\",\n  \"workflow_updated\",\n  \"workflow_created\",\n  \"run_proposed\",\n  \"memory_saved\",\n  \"usage\",\n  \"done\",\n  \"error\",\n])\n\nfunction isCopilotFrame(value: unknown): value is CopilotStreamFrame {\n  if (typeof value !== \"object\" || value === null) return false\n  const type = (value as { type?: unknown }).type\n  return typeof type === \"string\" && COPILOT_FRAME_TYPES.has(type)\n}\n\nexport class CopilotResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Open a conversation (`POST /v1/copilot/threads`) — on `workflowId`, or on\n   * a workflow the server creates from `prompt`. Re-opening a workflow that\n   * already has an active thread answers THAT thread rather than a second one.\n   */\n  create(input: CreateCopilotThreadInput): Promise<{ data: { thread: CopilotThread; workflow: CopilotThreadWorkflow } }> {\n    return this.client.request(\"POST\", \"/v1/copilot/threads\", { body: input })\n  }\n\n  /**\n   * The active thread for a workflow (`GET /v1/copilot/threads?workflowId=…`),\n   * or `null` when the user has none open on it.\n   */\n  list(params: { workflowId: string }): Promise<{ data: { thread: CopilotThread | null } }> {\n    return this.client.request(\"GET\", \"/v1/copilot/threads\", { query: { workflowId: params.workflowId } })\n  }\n\n  /**\n   * One thread with its messages (`GET /v1/copilot/threads/:id`). `after` reads\n   * only what followed that sequence number (the panel's catch-up); `limit`\n   * caps the page at the server's own ceiling.\n   */\n  get(\n    id: string,\n    opts: { after?: number; limit?: number } = {},\n  ): Promise<{ data: { thread: CopilotThread; messages: CopilotMessage[] } }> {\n    return this.client.request(\"GET\", `/v1/copilot/threads/${encodeURIComponent(id)}`, {\n      query: { ...(opts.after !== undefined ? { after: opts.after } : {}), ...(opts.limit !== undefined ? { limit: opts.limit } : {}) },\n    })\n  }\n\n  /**\n   * Close a conversation (`DELETE /v1/copilot/threads/:id`). Archival, not\n   * deletion — the messages stay readable. Refused while a turn is running.\n   */\n  archive(id: string): Promise<{ data: { archived: true } }> {\n    return this.client.request(\"DELETE\", `/v1/copilot/threads/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Stop the running turn (`POST /v1/copilot/threads/:id/cancel`). Answers the\n   * turn it asked to stop; the turn's own stream ends with a `done` frame.\n   */\n  cancel(id: string): Promise<{ data: { cancelling: true; turnId: string } }> {\n    return this.client.request(\"POST\", `/v1/copilot/threads/${encodeURIComponent(id)}/cancel`)\n  }\n\n  /**\n   * Send one message and iterate the turn's frames\n   * (`POST /v1/copilot/threads/:id/messages`, server-sent events).\n   *\n   * Deliberately NOT routed through `client.request`: that path arms an abort\n   * timer around the whole exchange, and a turn legitimately runs for minutes —\n   * inheriting `timeoutMs` would cut the assistant off mid-answer. The caller\n   * owns the lifetime instead: pass `signal` to end the stream, or stop\n   * iterating (the reader cancels the body, which ends the request).\n   *\n   * A frame kind this package does not model is skipped rather than thrown, so\n   * a newer server cannot break an older caller.\n   */\n  async *stream(threadId: string, opts: CopilotStreamOptions): AsyncGenerator<CopilotStreamFrame, void, undefined> {\n    const url = `${this.client.baseUrl}/v1/copilot/threads/${encodeURIComponent(threadId)}/messages`\n    const token = await this.client.auth.getToken()\n    const res = await this.client.fetch(url, {\n      method: \"POST\",\n      headers: {\n        \"Content-Type\": \"application/json\",\n        ...(token ? { Authorization: `Bearer ${token}` } : {}),\n      },\n      body: JSON.stringify({\n        message: opts.message,\n        ...(opts.baseVersion !== undefined ? { baseVersion: opts.baseVersion } : {}),\n        ...(opts.tier ? { tier: opts.tier } : {}),\n      }),\n      signal: opts.signal,\n    })\n    for await (const value of readSseStream<unknown>(res, { label: \"copilot stream\" })) {\n      if (isCopilotFrame(value)) yield value\n    }\n  }\n}\n"]}

package/dist/chunk-NNHWH7ER.js

@@ -0,0 +1,181 @@
+import { SCENE3D_V2_LIMITS } from '@nodaro/shared/scene3d';
+
+// src/resources/scene3d-types.ts
+var SCENE3D_DELIVERY_ASSET_USAGE = {
+  poster: "poster",
+  "validation-report": "validation",
+  "shot-still": "shot-still",
+  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */
+  "source-json": "checkpoint"
+};
+function newIdempotencyKey() {
+  const random = globalThis.crypto?.randomUUID?.();
+  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`;
+}
+var Scene3DResource = class {
+  /** Every operation runs a platform node, so the client must carry `nodes` too. */
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  capabilities() {
+    return this.client.request("GET", "/v1/3d-scene/capabilities");
+  }
+  /** Current access to both the delivery and its source is required on every read. */
+  getDelivery(jobId) {
+    return this.client.request("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`);
+  }
+  /**
+   * The bytes of one descriptor the delivery listed.
+   *
+   * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which
+   * is why a `shot-still` now works: the route has served stills since they existed, and this
+   * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same
+   * map; the server still decides whether THIS caller may read it.
+   */
+  deliveryAssetBytes(jobId, asset, options) {
+    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {
+      throw new Error("This asset is not available through the delivery endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene delivery asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
+  /**
+   * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.
+   *
+   * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene
+   * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's
+   * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This
+   * fetches it in one call — delivery, then the `source-json` descriptor's bytes.
+   *
+   * `null` means the delivery has no retained recipe to hand back: no pass ever cleared
+   * admission, or this caller holds less than `edit` on the job's workflow and the descriptor
+   * is therefore not listed for them.
+   *
+   * Read it to see what was attempted and to inform the next prompt. There is no input that
+   * takes a recipe back: a refused run published no revision, so there is no `{kind:"scene"}`
+   * source to re-run it from.
+   */
+  async retainedRecipe(jobId, options) {
+    const delivery = await this.getDelivery(jobId);
+    const asset = delivery.assets.find((item) => item.kind === "source-json");
+    if (!asset) return null;
+    const bytes = await this.deliveryAssetBytes(jobId, asset, options);
+    return JSON.parse(new TextDecoder("utf-8", { fatal: true }).decode(bytes));
+  }
+  /** Persist deterministic overlays without an LLM or a generation charge. */
+  applyEdits(revisionId, params) {
+    return this.client.request("POST", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params });
+  }
+  /** Asset access is scoped to an exact retained revision, with fresh authentication. */
+  assetBytes(revisionId, asset, options) {
+    if (!["glb", "camera-track-json", "poster", "validation-report"].includes(asset.kind)) {
+      throw new Error("This asset is not available through the playback endpoint");
+    }
+    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {
+      throw new Error("Invalid scene asset byte length");
+    }
+    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {
+      signal: options?.signal,
+      maxBytes: asset.byteLength
+    });
+  }
+  /** The editable native file has its own authorization lane. */
+  sourceBytes(revisionId, options) {
+    return this.client.requestBytes("GET", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {
+      signal: options?.signal,
+      maxBytes: SCENE3D_V2_LIMITS.maxBlendSourceBytes
+    });
+  }
+  generate(params) {
+    return this.client.nodes.run("generate-3d-scene", params);
+  }
+  generateAndWait(params, options) {
+    return this.client.nodes.runAndWait("generate-3d-scene", params, options);
+  }
+  edit(params) {
+    return this.client.nodes.run("edit-3d-scene", params);
+  }
+  editAndWait(params, options) {
+    return this.client.nodes.runAndWait("edit-3d-scene", params, options);
+  }
+  /**
+   * Price a 3D Render Pro request WITHOUT starting it.
+   *
+   * Takes the same body a run takes, minus the `quoteId`, and answers a
+   * ceiling (`maxCredits`), a `breakdown` to show, and the
+   * `normalizedInputHash` admission re-checks. It reserves nothing and spends
+   * nothing — a quote is a price, not a purchase.
+   */
+  quotePro(params) {
+    return this.client.request("POST", "/v1/pro-3d-render/quote", { body: params });
+  }
+  /**
+   * Submit a quoted 3D Render Pro run.
+   *
+   * Requires the `quoteId` from {@link quotePro}: no run starts at a price
+   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you
+   * supply your own, which you should when retrying a call that timed out.
+   *
+   * Availability is a property of the deployment: `capabilities().pro` says
+   * whether this install can serve it, and which controls you may offer.
+   */
+  runPro(params, options) {
+    return this.client.nodes.run("pro-3d-render", params, {
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Quote if needed, run, and wait — the whole operation in one call.
+   *
+   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent
+   * this quotes the identical body first, so the run is admitted against a
+   * hash of exactly what was priced. Pass a `quoteId` to run against a quote
+   * you already showed the user.
+   *
+   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`
+   * (the exact composition it was rendered from), plus the revision, poster,
+   * validation and renderer metadata. A run that AUTHORED also reports its own
+   * account of the answer — `metadata.summary`, `repairPasses`,
+   * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from
+   * the compiler's own remedy with no planner call, counted APART from
+   * `repairPasses` on their own quoted allowance), `restoredAssertions`, and
+   * any `SCENE_AUTHORING_ASSUMPTION` warnings. A
+   * completed result whose `metadata.review` is present passed every mandatory
+   * assertion but did NOT get the visual reviewer's approval: `verdict:
+   * "refused"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`
+   * warning; `verdict: "unavailable"` means the review produced no usable
+   * verdict in `attempts` asks (`reason: "provider"` — never reached its
+   * provider; `"unusable"` — it answered, unusably), so nobody judged the scene and
+   * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same
+   * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;
+   * that costs no authoring.
+   */
+  async renderProAndWait(params, options) {
+    const quoteId = typeof params.quoteId === "string" ? params.quoteId : (await this.quotePro(params)).quoteId;
+    return this.client.nodes.runAndWait("pro-3d-render", { ...params, quoteId }, {
+      ...options,
+      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey()
+    });
+  }
+  /**
+   * Uses the supplied immutable revision; never starts authoring or a rebuild.
+   *
+   * Priced by the plan's frame size — see {@link RenderScene3DParams}.
+   */
+  render(params) {
+    return this.client.nodes.run("render-video", params);
+  }
+  renderAndWait(params, options) {
+    return this.client.nodes.runAndWait("render-video", params, options);
+  }
+};
+
+export { SCENE3D_DELIVERY_ASSET_USAGE, Scene3DResource };
+//# sourceMappingURL=chunk-NNHWH7ER.js.map
+//# sourceMappingURL=chunk-NNHWH7ER.js.map

package/dist/chunk-NNHWH7ER.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/scene3d-types.ts","../src/resources/scene3d.ts"],"names":[],"mappings":"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","file":"chunk-NNHWH7ER.js","sourcesContent":["import type { Scene3DPlan, Scene3DPlanV2, Scene3DReference, Scene3DEditOperation, Scene3DV2EditOperation, Scene3DJobOutputAny as Scene3DWireJobOutput, Pro3DRenderCapabilities, Pro3DRenderEngine, Pro3DRenderJobOutput as Pro3DRenderWireOutput, Pro3DRenderQuality, Pro3DRenderQuote as Pro3DRenderWireQuote, Pro3DRenderSource, Pro3DRenderStyle } from \"@nodaro/shared/scene3d\"\nimport type { GenerationSessionParams } from \"./nodes.js\"\n\n/** Reuse newRevisionId for transport retries of the same immutable edit. */\nexport interface RetainedScene3DEditParams {\n  newRevisionId: string\n  expectedContentHash: string\n  operations: readonly Scene3DV2EditOperation[]\n  lockedObjectIds?: readonly string[]\n}\nexport interface RetainedScene3DEditResult { scenePlan: Scene3DPlanV2; changeSummary: string }\n\n/**\n * The kind of bytes a delivery descriptor names, and the usage it is pinned under.\n *\n * PAIRED, not two free enums: the platform refuses a pin whose usage is not the one its kind is\n * defined to have, and a client that checks only one of the two would accept a mis-pinned\n * artifact the server would then refuse. {@link SCENE3D_DELIVERY_ASSET_USAGE} is the map both\n * halves are read from.\n */\nexport const SCENE3D_DELIVERY_ASSET_USAGE = {\n  poster: \"poster\",\n  \"validation-report\": \"validation\",\n  \"shot-still\": \"shot-still\",\n  /** The recipe a run that never compiled was refused for. See {@link Scene3DDeliveryAsset}. */\n  \"source-json\": \"checkpoint\",\n} as const\n\nexport type Scene3DDeliveryAssetKind = keyof typeof SCENE3D_DELIVERY_ASSET_USAGE\n\n/**\n * One artifact a delivery pins, as a descriptor: opaque ids and digests only.\n *\n * Four kinds, and two of them are conditional:\n *\n * - `poster` and `validation-report` are on every delivery;\n * - `shot-still` appears once per shot on a render that produced a contact sheet, and carries\n *   its own shot identity (`shotIndex`, `frame`, and the frame size);\n * - `source-json` appears on ONE shape only — a `refused-authoring` delivery, published by a\n *   3D Render Pro run whose recipe the compiler refused on every pass. It is the planner's last\n *   admitted recipe, and it is the only thing such a run leaves that names what was attempted.\n *   Reading it needs `edit` on the job's workflow (the same access the `.blend` export costs);\n *   a reader with less simply does not see the descriptor.\n */\nexport interface Scene3DDeliveryAsset {\n  assetId: string\n  kind: Scene3DDeliveryAssetKind\n  usage: (typeof SCENE3D_DELIVERY_ASSET_USAGE)[Scene3DDeliveryAssetKind]\n  byteLength: number\n  sha256: string\n  viaRevisionId: string | null\n  /** Set on a `shot-still` and absent on every other kind — never `null`. */\n  shotIndex?: number\n  frame?: number\n  width?: number\n  height?: number\n}\n\n/** Export evidence is retained separately from the immutable scene it rendered. */\nexport interface Scene3DDelivery {\n  deliveryId: string\n  /**\n   * Null on a `refused-authoring` delivery and on that alone.\n   *\n   * A Pro run whose recipe the compiler refused on every pass still retains the refusal\n   * report, but nothing was ever compiled, so no scene revision was published. The field is\n   * null rather than absent so the shape stays one shape; read `sourceKind` to tell why.\n   */\n  sceneRevisionId: string | null\n  /**\n   * What this delivery was made from. Absent when read from a deployment that predates the\n   * refused lane, where every delivery necessarily had a scene behind it.\n   */\n  sourceKind?: \"retained-revision\" | \"job-output\" | \"refused-authoring\"\n  /** Null when there is no plan to hash — see `sceneRevisionId`. */\n  sourcePlanSha256: string | null\n  sourceContentHash: string | null\n  sourceJobId: string | null\n  workflowId: string | null\n  mode: \"authored\" | \"render-only\"\n  createdAt: string\n  access: \"view\" | \"edit\" | \"own\"\n  assets: Scene3DDeliveryAsset[]\n}\n\nexport type Scene3DAuthoringEngine = \"basic\" | \"blender-cloud\" | \"blender-local\"\n\nexport interface Scene3DCapabilities {\n  basic: { available: boolean; sceneSchemaVersions: number[] }\n  advanced: null | {\n    version: string\n    engines: Array<Exclude<Scene3DAuthoringEngine, \"basic\">>\n    sceneSchemaVersions: number[]\n    maxRepairPasses: number\n  }\n  /**\n   * What this deployment can serve for `pro-3d-render`, including which\n   * quality profiles, engines and aspect ratios a client may OFFER. Optional so\n   * a client of this version reads an older backend without throwing; absent\n   * means the node is unavailable.\n   */\n  pro?: Pro3DRenderCapabilities\n}\n\ninterface Scene3DEngineParams {\n  /** Basic is the default. Discover optional engines through scene3d.capabilities(). */\n  engine?: Scene3DAuthoringEngine\n  acceptedSceneSchemaVersions?: readonly number[]\n  localConnectionId?: string\n  quoteId?: string\n  maxRepairPasses?: number\n}\n\n/** Structured authoring inputs; reference roles are interpreted by the platform. */\nexport interface GenerateScene3DParams extends Record<string, unknown>, Scene3DEngineParams, GenerationSessionParams {\n  /** Existing GLBs selected by immutable revision/artifact IDs. Requires an import-capable advanced engine. */\n  inputAssets?: readonly import(\"@nodaro/shared/scene3d\").Scene3DInputAsset[]\n  prompt: string\n  durationSeconds?: number\n  fps?: number\n  aspectRatio?: string\n  references?: readonly Scene3DReference[]\n  llmModel?: string\n  reasoningEffort?: string\n  workflowId?: string\n  nodeId?: string\n}\n\n/** Editing creates a new revision and never mutates the supplied scene. */\nexport interface EditScene3DParams extends Record<string, unknown>, Scene3DEngineParams, GenerationSessionParams {\n  scenePlan: Scene3DPlan\n  expectedRevisionId: string\n  /** Replace the complete reference set, including clearing it with an empty list. Default: merge by id. */\n  replaceReferences?: boolean\n  /** Supply an instruction or deterministic operations, never both. */\n  prompt?: string\n  operations?: readonly (Scene3DEditOperation | Scene3DV2EditOperation)[]\n  references?: readonly Scene3DReference[]\n  lockedObjectIds?: readonly string[]\n  selectedObjectIds?: readonly string[]\n  llmModel?: string\n  reasoningEffort?: string\n  workflowId?: string\n  nodeId?: string\n}\n\n/**\n * 3D Render Pro — ONE durable operation producing a composition and its MP4.\n *\n * `source` is a strict discriminated union, not a bag of optionals:\n *  - `{kind:'prompt', prompt, references?}` authors a new scene;\n *  - `{kind:'scene', revisionId, sourceJobId}` with NO `editPrompt` is the\n *    render-only export — it spends no authoring or build credits, and OMIT\n *    the field rather than sending `\"\"`, which would buy an authoring pass;\n *  - `{kind:'local-export', exportId, connectionId}` uses a paired desktop.\n *\n * There is no model or effort field: the planner is fixed and server-owned.\n *\n * `durationSeconds` / `fps` / `aspectRatio` on a `scene` source are an EXPLICIT\n * re-time request. Omit them to keep the source's own timing; a conflicting\n * override is rejected rather than silently applied.\n */\nexport interface Pro3DRenderParams extends Record<string, unknown> {\n  source: Pro3DRenderSource\n  /** Optional. An unknown or unavailable engine is rejected, never downgraded. */\n  engine?: Pro3DRenderEngine\n  /** Names a paired desktop for a local run. */\n  localConnectionId?: string\n  durationSeconds?: number\n  fps?: number\n  aspectRatio?: string\n  quality?: Pro3DRenderQuality\n  style?: Pro3DRenderStyle\n  /** Correction budget, 0-2. Each pass is paid work. */\n  maxRepairPasses?: number\n  /**\n   * Which scene-schema versions THIS client can render. A prompt or\n   * local-export source mints v2, so omitting 2 is refused for free; a scene\n   * source inherits its revision's version and is left to the server.\n   */\n  acceptedSceneSchemaVersions?: readonly number[]\n  workflowId?: string\n  nodeId?: string\n  /** Keep every artifact of this run out of publicly-readable storage. */\n  forcePrivate?: boolean\n}\n\n/** A run additionally carries the quote it was priced under. */\nexport interface Pro3DRenderRunParams extends Pro3DRenderParams {\n  quoteId: string\n}\n\n/** The quote's answer. `maxCredits` is a ceiling; quoting spends nothing. */\nexport type Pro3DRenderQuote = Readonly<Pro3DRenderWireQuote> & Readonly<Record<string, unknown>>\n\n/** Per-call transport controls for the paid run. */\nexport interface Pro3DRenderRunOptions {\n  /**\n   * The `Idempotency-Key` the run is submitted under. Reuse the same value when\n   * retrying a call that timed out, so the run is not started twice; the SDK\n   * generates a fresh one per call when this is omitted, because two deliberate\n   * calls are two runs.\n   */\n  idempotencyKey?: string\n}\n\n/**\n * Render the exact scene revision through the existing render-video node.\n *\n * The price follows the plan's OWN `width`/`height`, not any node setting: a\n * frame up to 1920 px on its longest side settles under `render-video`, a\n * larger one under `render-video:3d-large` (1.5x) or, above 5.12 megapixels,\n * `render-video:3d-xlarge` (2.5x). Read the current numbers from the\n * model-cost API for those three identifiers.\n */\nexport interface RenderScene3DParams extends Record<string, unknown>, GenerationSessionParams {\n  planType: \"3d-scene\"\n  plan: Scene3DPlan\n  workflowId?: string\n  nodeId?: string\n}\n\n/**\n * Preserve the shared wire contract while allowing additive job metadata.\n *\n * A scene authored by an ADVANCED engine additionally reports what the run knows about its own\n * answer, every field optional and all of them absent on the deterministic Basic lane:\n * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION` (the planner's\n * assumptions), `metadata.summary` (its description of what it authored), `repairPasses`\n * (repairs actually run — `0` when the scene was accepted first time), `admissionRetries`\n * (pre-build planner retries, which spend no repair pass), `mechanicalPasses` (repairs the engine\n * applied from the compiler's own remedy with no planner call, counted APART from `repairPasses`\n * on their own quoted allowance, each with a `REMEDY_AUTO_APPLIED` warning) and\n * `restoredAssertions` (mandatory assertions put back after a planner answer re-shaped one the\n * feedback had not named, each a `ASSERTION_RESTORED` warning).\n *\n * A scene that passed every mandatory assertion but did not get the visual reviewer's approval\n * is delivered anyway, and `metadata.review` carries a verdict saying why. `verdict: \"refused\"`\n * is the ADVISORY delivery — the reviewer objected once the repair budget was spent — with one\n * `SCENE_REVIEW_REFUSED` warning per objection. `verdict: \"unavailable\"` is the UNREVIEWED\n * delivery: the review produced no usable verdict after `attempts` asks — `reason: \"provider\"`\n * when it never reached its provider, `\"unusable\"` when the provider answered with nothing usable\n * (`Scene3DReviewUnavailableReason` in `@nodaro/shared`) — so nobody judged the scene, and\n * `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE` (any objections under it came from\n * review batches that answered usably first, and are not the whole verdict).\n *\n * `validation.status` stays `\"passed\"` on both, so `metadata.review` being present is the only\n * reliable test — use `scene3DReviewVerdictOf` from `@nodaro/shared` rather than reading it by\n * hand, and `scene3DReviewNote` rather than writing the sentence yourself: a message that says\n * the reviewer refused a scene nobody reviewed invents an opinion.\n */\nexport type Scene3DJobOutput = Readonly<Scene3DWireJobOutput> & Readonly<Record<string, unknown>>\n\n/**\n * The settled 3D Render Pro result, plus any additive job metadata.\n *\n * On a run that AUTHORED, the result reports the run's own account of its answer:\n * `validation.warnings[]` entries coded `SCENE_AUTHORING_ASSUMPTION`, `metadata.summary`,\n * `repairPasses` (`0` when accepted first time), `admissionRetries` (pre-build planner retries,\n * which spend no repair pass), `mechanicalPasses` (repairs the engine authored itself from the\n * compiler's own remedy, counted APART from `repairPasses` because they buy their own quoted\n * allowance rather than spending one of your repairs) and `restoredAssertions`. A render-only\n * export authored nothing, so it carries no summary and omits the counts rather than claiming `0`.\n *\n * The one case where `mechanicalPasses` IS a subset of `repairPasses` is a run quoted before that\n * allowance existed — its quote carries no `mechanical` line. The discriminant is the quote, not\n * the result, so read the quote you were given rather than deriving it from the two counts.\n *\n * A completed result may also be published without the visual reviewer's approval, and then\n * `metadata.review` holds a verdict saying which way. `{ verdict: \"refused\", objections[],\n * observed? }` is the ADVISORY delivery: every mandatory assertion passed, the reviewer still\n * objected, and the scene was published once the repair budget was spent, with one\n * `SCENE_REVIEW_REFUSED` warning per objection. `{ verdict: \"unavailable\", reason, attempts,\n * objections[], observed? }` is the UNREVIEWED delivery: the review produced no usable verdict in\n * `attempts` asks — `reason: \"provider\"` when it never reached its provider, `\"unusable\"` when the\n * provider answered with nothing usable — so the assertion-passing scene was delivered with no\n * verdict on it and `validation.warnings[]` LEADS with `SCENE_REVIEW_UNAVAILABLE`. Objections on\n * that arm are whatever review batches answered usably first — real, but not the whole verdict.\n *\n * `validation.status` is `\"passed\"` on both, so test for `metadata.review` — via\n * `scene3DReviewVerdictOf` from `@nodaro/shared` — rather than for the status or the warnings,\n * and render it with `scene3DReviewNote` rather than assuming a refusal.\n */\nexport type Pro3DRenderJobOutput = Readonly<Pro3DRenderWireOutput> & Readonly<Record<string, unknown>>\n","import { SCENE3D_V2_LIMITS, type Scene3DAssetRef } from \"@nodaro/shared/scene3d\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { RunNodeResult, RunAndWaitOptions, NodeJobOutput, NodesResource } from \"./nodes.js\"\nimport type { EditScene3DParams, GenerateScene3DParams, Pro3DRenderJobOutput, Pro3DRenderParams, Pro3DRenderQuote, Pro3DRenderRunOptions, Pro3DRenderRunParams, RenderScene3DParams, Scene3DCapabilities, Scene3DJobOutput } from \"./scene3d-types.js\"\nimport type { RetainedScene3DEditParams, RetainedScene3DEditResult } from \"./scene3d-types.js\"\nimport { SCENE3D_DELIVERY_ASSET_USAGE } from \"./scene3d-types.js\"\nimport type { Scene3DDelivery, Scene3DDeliveryAsset } from \"./scene3d-types.js\"\n\n/**\n * A fresh per-call retry token.\n *\n * Random rather than derived from the request: two deliberate calls with the\n * same parameters are two runs, and collapsing them would silently swallow the\n * second. A caller who wants retry safety passes its own key.\n */\nfunction newIdempotencyKey(): string {\n  const random = globalThis.crypto?.randomUUID?.()\n  return `sdk-pro3d-${random ?? `${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}`}`\n}\n\n/** Scene authoring and render-only export through the same platform nodes. */\nexport class Scene3DResource {\n  /** Every operation runs a platform node, so the client must carry `nodes` too. */\n  constructor(private client: NodaroClientCore & { readonly nodes: NodesResource }) {}\n\n  capabilities(): Promise<Scene3DCapabilities> {\n    return this.client.request(\"GET\", \"/v1/3d-scene/capabilities\")\n  }\n\n  /** Current access to both the delivery and its source is required on every read. */\n  getDelivery(jobId: string): Promise<Scene3DDelivery> {\n    return this.client.request(\"GET\", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}`)\n  }\n\n  /**\n   * The bytes of one descriptor the delivery listed.\n   *\n   * Checked against {@link SCENE3D_DELIVERY_ASSET_USAGE} rather than a hardcoded pair, which\n   * is why a `shot-still` now works: the route has served stills since they existed, and this\n   * guard refused them. `source-json` — the recipe a refused run was kept for — is on the same\n   * map; the server still decides whether THIS caller may read it.\n   */\n  deliveryAssetBytes(jobId: string, asset: Scene3DDeliveryAsset, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    if (SCENE3D_DELIVERY_ASSET_USAGE[asset.kind] !== asset.usage) {\n      throw new Error(\"This asset is not available through the delivery endpoint\")\n    }\n    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {\n      throw new Error(\"Invalid scene delivery asset byte length\")\n    }\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/deliveries/${encodeURIComponent(jobId)}/assets/${encodeURIComponent(asset.assetId)}`, {\n      signal: options?.signal, maxBytes: asset.byteLength,\n    })\n  }\n\n  /**\n   * The recipe a 3D Render Pro run was refused for, parsed — or `null` when there is none.\n   *\n   * The one thing such a run leaves behind. Its recipe never compiled, so there is no scene\n   * revision, no poster and no `.blend`: `output_data` carries a `deliveryId`, the compiler's\n   * reasons, and `validation.sourceRetained` saying whether the recipe itself was kept. This\n   * fetches it in one call — delivery, then the `source-json` descriptor's bytes.\n   *\n   * `null` means the delivery has no retained recipe to hand back: no pass ever cleared\n   * admission, or this caller holds less than `edit` on the job's workflow and the descriptor\n   * is therefore not listed for them.\n   *\n   * Read it to see what was attempted and to inform the next prompt. There is no input that\n   * takes a recipe back: a refused run published no revision, so there is no `{kind:\"scene\"}`\n   * source to re-run it from.\n   */\n  async retainedRecipe(jobId: string, options?: { signal?: AbortSignal }): Promise<unknown | null> {\n    const delivery = await this.getDelivery(jobId)\n    const asset = delivery.assets.find((item) => item.kind === \"source-json\")\n    if (!asset) return null\n    const bytes = await this.deliveryAssetBytes(jobId, asset, options)\n    return JSON.parse(new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes)) as unknown\n  }\n\n  /** Persist deterministic overlays without an LLM or a generation charge. */\n  applyEdits(revisionId: string, params: RetainedScene3DEditParams): Promise<RetainedScene3DEditResult> {\n    return this.client.request(\"POST\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/edits`, { body: params })\n  }\n\n  /** Asset access is scoped to an exact retained revision, with fresh authentication. */\n  assetBytes(revisionId: string, asset: Scene3DAssetRef, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    if (![\"glb\", \"camera-track-json\", \"poster\", \"validation-report\"].includes(asset.kind)) {\n      throw new Error(\"This asset is not available through the playback endpoint\")\n    }\n    if (!Number.isSafeInteger(asset.byteLength) || asset.byteLength < 1 || asset.byteLength > SCENE3D_V2_LIMITS.maxRendererAssetBytes) {\n      throw new Error(\"Invalid scene asset byte length\")\n    }\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/assets/${encodeURIComponent(asset.assetId)}`, {\n      signal: options?.signal, maxBytes: asset.byteLength,\n    })\n  }\n\n  /** The editable native file has its own authorization lane. */\n  sourceBytes(revisionId: string, options?: { signal?: AbortSignal }): Promise<ArrayBuffer> {\n    return this.client.requestBytes(\"GET\", `/v1/3d-scene/revisions/${encodeURIComponent(revisionId)}/source`, {\n      signal: options?.signal, maxBytes: SCENE3D_V2_LIMITS.maxBlendSourceBytes,\n    })\n  }\n\n  generate(params: GenerateScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"generate-3d-scene\", params)\n  }\n\n  generateAndWait(params: GenerateScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput> {\n    return this.client.nodes.runAndWait(\"generate-3d-scene\", params, options)\n  }\n\n  edit(params: EditScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"edit-3d-scene\", params)\n  }\n\n  editAndWait(params: EditScene3DParams, options?: RunAndWaitOptions): Promise<Scene3DJobOutput> {\n    return this.client.nodes.runAndWait(\"edit-3d-scene\", params, options)\n  }\n\n  /**\n   * Price a 3D Render Pro request WITHOUT starting it.\n   *\n   * Takes the same body a run takes, minus the `quoteId`, and answers a\n   * ceiling (`maxCredits`), a `breakdown` to show, and the\n   * `normalizedInputHash` admission re-checks. It reserves nothing and spends\n   * nothing — a quote is a price, not a purchase.\n   */\n  quotePro(params: Pro3DRenderParams): Promise<Pro3DRenderQuote> {\n    return this.client.request(\"POST\", \"/v1/pro-3d-render/quote\", { body: params })\n  }\n\n  /**\n   * Submit a quoted 3D Render Pro run.\n   *\n   * Requires the `quoteId` from {@link quotePro}: no run starts at a price\n   * nobody showed. Sends an `Idempotency-Key` — a fresh one per call unless you\n   * supply your own, which you should when retrying a call that timed out.\n   *\n   * Availability is a property of the deployment: `capabilities().pro` says\n   * whether this install can serve it, and which controls you may offer.\n   */\n  runPro(params: Pro3DRenderRunParams, options?: Pro3DRenderRunOptions): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"pro-3d-render\", params, {\n      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey(),\n    })\n  }\n\n  /**\n   * Quote if needed, run, and wait — the whole operation in one call.\n   *\n   * Two HTTP requests at most, still ONE paid job: when `quoteId` is absent\n   * this quotes the identical body first, so the run is admitted against a\n   * hash of exactly what was priced. Pass a `quoteId` to run against a quote\n   * you already showed the user.\n   *\n   * Resolves with the settled result — `videoUrl` (the MP4) and `scenePlan`\n   * (the exact composition it was rendered from), plus the revision, poster,\n   * validation and renderer metadata. A run that AUTHORED also reports its own\n   * account of the answer — `metadata.summary`, `repairPasses`,\n   * `admissionRetries`, `mechanicalPasses` (repairs the engine applied from\n   * the compiler's own remedy with no planner call, counted APART from\n   * `repairPasses` on their own quoted allowance), `restoredAssertions`, and\n   * any `SCENE_AUTHORING_ASSUMPTION` warnings. A\n   * completed result whose `metadata.review` is present passed every mandatory\n   * assertion but did NOT get the visual reviewer's approval: `verdict:\n   * \"refused\"` means it objected, each objection also a `SCENE_REVIEW_REFUSED`\n   * warning; `verdict: \"unavailable\"` means the review produced no usable\n   * verdict in `attempts` asks (`reason: \"provider\"` — never reached its\n   * provider; `\"unusable\"` — it answered, unusably), so nobody judged the scene and\n   * `SCENE_REVIEW_UNAVAILABLE` leads the warnings. Re-render that same\n   * `scenePlan` later with {@link render}, or with a `{kind:'scene'}` source;\n   * that costs no authoring.\n   */\n  async renderProAndWait(\n    params: Pro3DRenderParams | Pro3DRenderRunParams,\n    options?: RunAndWaitOptions & Pro3DRenderRunOptions,\n  ): Promise<Pro3DRenderJobOutput> {\n    const quoteId =\n      typeof (params as Pro3DRenderRunParams).quoteId === \"string\"\n        ? (params as Pro3DRenderRunParams).quoteId\n        : (await this.quotePro(params)).quoteId\n    return this.client.nodes.runAndWait(\"pro-3d-render\", { ...params, quoteId }, {\n      ...options,\n      idempotencyKey: options?.idempotencyKey ?? newIdempotencyKey(),\n    })\n  }\n\n  /**\n   * Uses the supplied immutable revision; never starts authoring or a rebuild.\n   *\n   * Priced by the plan's frame size — see {@link RenderScene3DParams}.\n   */\n  render(params: RenderScene3DParams): Promise<RunNodeResult> {\n    return this.client.nodes.run(\"render-video\", params)\n  }\n\n  renderAndWait(params: RenderScene3DParams, options?: RunAndWaitOptions): Promise<NodeJobOutput> {\n    return this.client.nodes.runAndWait(\"render-video\", params, options)\n  }\n}\n"]}

package/dist/chunk-NX67YIF3.js

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

package/dist/chunk-NX67YIF3.js.map

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

package/dist/chunk-OA6FWYZF.cjs

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

package/dist/chunk-OA6FWYZF.cjs.map

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

package/dist/chunk-OJDBSKC2.js

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

package/dist/chunk-OJDBSKC2.js.map

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

package/dist/chunk-OLPA44QJ.js

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

package/dist/chunk-OLPA44QJ.js.map

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

package/dist/chunk-OMH7ATOQ.js

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

package/dist/chunk-OMH7ATOQ.js.map

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

package/dist/chunk-OPR4TULG.js

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