@nodaro/sdk 2.28.0 → 2.31.0

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

package/dist/chunk-OPR4TULG.js.map

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

package/dist/chunk-OSX2GVZ2.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+// src/resources/picker-catalogs.ts
+var PickerCatalogsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** List every parameter-picker node type + its option count. Cached publicly 5 min. */
+  list() {
+    return this.client.request("GET", "/v1/picker-catalogs");
+  }
+  /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+   *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+  analyzeText(params) {
+    return this.client.request("POST", "/v1/text-to-picker", { body: params });
+  }
+  /** Get one picker's catalog of valid values. */
+  get(nodeType, opts = {}) {
+    const qs = new URLSearchParams();
+    if (opts.detail) qs.set("detail", opts.detail);
+    if (opts.category) qs.set("category", opts.category);
+    if (opts.field) qs.set("field", opts.field);
+    const query = qs.toString();
+    return this.client.request(
+      "GET",
+      `/v1/picker-catalogs/${encodeURIComponent(nodeType)}${query ? `?${query}` : ""}`
+    );
+  }
+};
+
+exports.PickerCatalogsResource = PickerCatalogsResource;
+//# sourceMappingURL=chunk-OSX2GVZ2.cjs.map
+//# sourceMappingURL=chunk-OSX2GVZ2.cjs.map

package/dist/chunk-OSX2GVZ2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/picker-catalogs.ts"],"names":[],"mappings":";;;AAiIO,IAAM,yBAAN,MAA6B;AAAA,EAClC,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAAkD;AAChD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,qBAAqB,CAAA;AAAA,EACzD;AAAA;AAAA;AAAA,EAIA,YAAY,MAAA,EAAyD;AACnE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAQ,MAAA,EAAQ,sBAAsB,EAAE,IAAA,EAAM,QAAQ,CAAA;AAAA,EAC3E;AAAA;AAAA,EAGA,GAAA,CAAI,QAAA,EAAkB,IAAA,GAAgC,EAAC,EAAqC;AAC1F,IAAA,MAAM,EAAA,GAAK,IAAI,eAAA,EAAgB;AAC/B,IAAA,IAAI,KAAK,MAAA,EAAQ,EAAA,CAAG,GAAA,CAAI,QAAA,EAAU,KAAK,MAAM,CAAA;AAC7C,IAAA,IAAI,KAAK,QAAA,EAAU,EAAA,CAAG,GAAA,CAAI,UAAA,EAAY,KAAK,QAAQ,CAAA;AACnD,IAAA,IAAI,KAAK,KAAA,EAAO,EAAA,CAAG,GAAA,CAAI,OAAA,EAAS,KAAK,KAAK,CAAA;AAC1C,IAAA,MAAM,KAAA,GAAQ,GAAG,QAAA,EAAS;AAC1B,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,KAAA;AAAA,MACA,CAAA,oBAAA,EAAuB,mBAAmB,QAAQ,CAAC,GAAG,KAAA,GAAQ,CAAA,CAAA,EAAI,KAAK,CAAA,CAAA,GAAK,EAAE,CAAA;AAAA,KAChF;AAAA,EACF;AACF","file":"chunk-OSX2GVZ2.cjs","sourcesContent":["import type { CharacterMotionMetadata } from \"@nodaro/shared/types\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Picker-catalog types. Mirrors `@nodaro/shared`'s `ProjectedPickerCatalog` /\n * `PickerCatalogSummary` so the SDK stays dependency-free (same convention as\n * `NodeDescriptor` mirroring node-registry).\n */\nexport interface PickerOption {\n  id: string\n  label: string\n  description?: string\n  category?: string\n  /** The prompt fragment this id injects downstream. Present only when detail=\"full\". */\n  promptHint?: string\n  /**\n   * Short professional term injected by compact hint mode; `label` is for\n   * display. Present at BOTH detail levels — a thin client renders `label`\n   * and injects `term`. Empty for a no-op (\"auto\"/\"none\") entry that injects\n   * nothing.\n   */\n  term?: string\n  icon?: string\n  /** Authored Character Motion prerequisites and sequence state. Missing means unknown. */\n  motion?: CharacterMotionMetadata\n  /**\n   * Per-option parameters — node-data fields that apply only while THIS option\n   * is picked (the Transition catalog's `wipe` → `wipeDirection`). Same shape\n   * as a catalog's `dimensions`, at both detail levels; `auto` leads each list\n   * and means \"send nothing\". Absent on every other option.\n   */\n  params?: PickerDimension[]\n  /**\n   * Absolute URL of the option's picture — a photo, 3D emoji, flag or (Nodaro\n   * Cloud only) rendered look preview — on the installation's own host, or the\n   * Nodaro CDN for look previews. Absent when the option has no picture. Use it\n   * as given: file names carry a content hash, so it can be cached for good.\n   */\n  imageUrl?: string\n}\n\nexport interface PickerDimension {\n  field: string\n  label: string\n  options: PickerOption[]\n}\n\n/** A topic a multi-dim catalog's settings are grouped under in the editor (person, styling). */\nexport interface PickerCatalogSection {\n  /** English topic name, e.g. \"Identity\", \"Beauty & Hair\". */\n  label: string\n  /** Node-data fields of the settings in this topic, in display order. */\n  fields: string[]\n  /** Absolute URL of the topic's round picture. Absent when it has none. */\n  imageUrl?: string\n}\n\nexport interface PickerCatalog {\n  nodeType: string\n  label: string\n  catalogId: string\n  kind: \"single\" | \"multi\"\n  /** single only — the node-data field the chosen id writes to. */\n  valueField?: string\n  defaultValue?: string\n  categoryOrder?: string[]\n  categoryLabels?: Record<string, string>\n  /** single-dim catalogs. */\n  options?: PickerOption[]\n  /** multi-dim catalogs. */\n  fields?: string[]\n  /** Per-field option lists. Multi-dim catalogs always carry these; a\n   *  single-dim catalog carries them when it has secondary parameter\n   *  fields beside its main picker (transition position/duration/intensity). */\n  dimensions?: PickerDimension[]\n  detail?: \"compact\" | \"full\"\n  /** person and styling: the topics their settings are grouped under, in order, each with its picture. */\n  sections?: PickerCatalogSection[]\n}\n\nexport interface PickerCatalogSummary {\n  nodeType: string\n  label: string\n  catalogId: string\n  kind: \"single\" | \"multi\"\n  valueField?: string\n  fields?: string[]\n  optionCount: number\n  /** How many of those options carry an `imageUrl` (0 = no pictures). Absent from servers that predate pictures. */\n  imageCount?: number\n}\n\nexport interface GetPickerCatalogOptions {\n  /** \"compact\" (default) = id, label, category, term, icon, imageUrl; \"full\" additionally includes description + promptHint. */\n  detail?: \"compact\" | \"full\"\n  /** single-dim: filter to one category. */\n  category?: string\n  /** multi-dim: only this dimension field. */\n  field?: string\n}\n\n/** Input for `analyzeText` (POST /v1/text-to-picker). */\nexport interface TextToPickerParams {\n  /** Free-text scene/shot description to analyze. */\n  text: string\n  /** Picker node types to fill. Omit for ALL analyzable pickers (the server\n   *  fans the analysis out per family and merges). */\n  targetPickers?: string[]\n  /** Extra guidance appended to the analyzer system prompt. */\n  instructions?: string\n  /** Originating client app slug (e.g. \"cine\") — attribution only. */\n  origin?: string\n  llmModel?: string\n  reasoningEffort?: string\n}\n\nexport interface TextToPickerResult {\n  jobId: string\n  /** pickerType → dimension → chosen catalog id(s) — same shape as\n   *  describe-to-picker; hydrate pickers from it verbatim. */\n  pickerJson: Record<string, Record<string, string | string[]>>\n  /** Catalog-coverage feedback (attributes the text described that no\n   *  catalog id represents well). Surface as \"we couldn't infer X\". */\n  gaps?: {\n    missingItems: Array<{ picker: string; dimension: string; observed: string }>\n    missingCategories: Array<{ picker: string; suggestedDimension: string; observed: string }>\n  }\n}\n\nexport class PickerCatalogsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List every parameter-picker node type + its option count. Cached publicly 5 min. */\n  list(): Promise<{ data: PickerCatalogSummary[] }> {\n    return this.client.request(\"GET\", \"/v1/picker-catalogs\")\n  }\n\n  /** Fill pickers from a free-text description (Cine \"AI Fill\"): returns the\n   *  same pickerJson shape as describe-to-picker, keyed by picker node type. */\n  analyzeText(params: TextToPickerParams): Promise<TextToPickerResult> {\n    return this.client.request(\"POST\", \"/v1/text-to-picker\", { body: params })\n  }\n\n  /** Get one picker's catalog of valid values. */\n  get(nodeType: string, opts: GetPickerCatalogOptions = {}): Promise<{ data: PickerCatalog }> {\n    const qs = new URLSearchParams()\n    if (opts.detail) qs.set(\"detail\", opts.detail)\n    if (opts.category) qs.set(\"category\", opts.category)\n    if (opts.field) qs.set(\"field\", opts.field)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/picker-catalogs/${encodeURIComponent(nodeType)}${query ? `?${query}` : \"\"}`,\n    )\n  }\n}\n"]}