@nodaro/sdk 2.29.0 → 2.32.0

package/dist/chunk-CR5E2SF3.cjs

@@ -0,0 +1,212 @@
+'use strict';
+
+var entities = require('@nodaro/shared/entities');
+
+// src/resources/objects.ts
+var ObjectsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List the caller's objects. By default returns active objects only;
+   * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
+   * Optional `projectId` scopes the result to a single project; `q` keeps the
+   * objects whose name or description contains it.
+   */
+  list(params = {}) {
+    const query = {};
+    if (params.archived) query.archived = "true";
+    if (params.projectId) query.projectId = params.projectId;
+    if (params.q) query.q = params.q;
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", "/v1/objects", { query });
+  }
+  /**
+   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
+   * rows so callers can drive a UI "Archived" tab without re-encoding the
+   * query param.
+   *
+   * `archived` is omitted from the param type — it's always set to `true` here.
+   */
+  listArchived(params = {}) {
+    return this.list({ ...params, archived: true });
+  }
+  /**
+   * Fetch a single object including in-flight asset job state. Soft-deleted
+   * (archived) rows are NOT returned by id — the route enforces
+   * `deleted_at IS NULL` so archived objects 404 (uniform Pass 10 F-90b
+   * "not_found" — does not leak the deleted vs non-existent distinction).
+   */
+  async get(id) {
+    const res = await this.client.request(
+      "GET",
+      `/v1/objects/${encodeURIComponent(id)}`
+    );
+    return { ...res, canonicalDescription: res.canonicalDescription || null };
+  }
+  /**
+   * Create a new object. `name` + `nodeId` are required — the route 400s
+   * otherwise. Returns the new row's id.
+   *
+   * Note: the underlying route is the same `POST /v1/objects` upsert that
+   * powers `update()`. This convenience wrapper enforces the INSERT-required
+   * fields at the type level and never sends an `id`.
+   */
+  create(data) {
+    return this.client.request("POST", "/v1/objects", { body: data });
+  }
+  /**
+   * Update an object. Only the fields you pass are written — undefined keys
+   * are NOT touched on the row. Worker-owned asset buckets are intentionally
+   * not exposed on this surface (see `UpdateObjectInput` for the rationale).
+   *
+   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's
+   * `updated_at` still matches; on mismatch the route returns 409
+   * `concurrent_modification` carrying the fresh `updatedAt`. The SDK
+   * surfaces that as a generic `NodaroError` with the same code (per Phase
+   * E1 calibration finding — error centralization in `throwApiError`).
+   */
+  update(id, data) {
+    return this.client.request("POST", "/v1/objects", {
+      body: { id, ...data }
+    });
+  }
+  /**
+   * Soft-delete (archive) an object. The row is hidden from `list()` by
+   * default but recoverable via `restore(id)` or visible under
+   * `listArchived()`. Idempotent — repeating a delete on an already-archived
+   * row is a no-op.
+   */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/objects/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Hard-delete (permanent) an object — the row + every R2 asset it
+   * references. Archived rows ONLY: active objects return 400 `not_archived`.
+   * Call `delete()` first to archive, then `permanentDelete()` to destroy.
+   *
+   * Mirrors the `app_runs` permanent-delete pattern (archive-first) so a
+   * stray SDK / curl caller cannot bypass the studio's archive-first UI
+   * flow.
+   */
+  permanentDelete(id) {
+    return this.client.request("DELETE", `/v1/objects/${encodeURIComponent(id)}`, {
+      query: { permanent: "true" }
+    });
+  }
+  /**
+   * Un-archive an object. If the original name now collides (case-
+   * insensitive) with an active row, the server auto-suffixes "(restored)"
+   * and returns the effective name.
+   */
+  restore(id) {
+    return this.client.request("POST", `/v1/objects/${encodeURIComponent(id)}/restore`);
+  }
+  /**
+   * Fire `POST /v1/generate-object` to produce one or more candidate main
+   * images. With `count > 1`, all jobs are reserved up-front before any
+   * is enqueued — mid-batch failures roll back atomically.
+   *
+   * When `attachToObjectId` is set AND `count === 1`, the worker writes
+   * the result directly to the row's `source_image_url`; otherwise you must
+   * call `approveMainImage()` after picking a candidate.
+   */
+  async generate(data) {
+    const res = await this.client.request(
+      "POST",
+      "/v1/generate-object",
+      { body: data }
+    );
+    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : []);
+    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds };
+  }
+  /**
+   * Fire `POST /v1/generate-object-asset` to produce a single variant.
+   * When the studio path is set (`attachToObjectId` + `attachToColumn` +
+   * `attachName`), the worker appends `{ name: attachName, url: <result> }`
+   * to the named JSONB array column on completion.
+   *
+   * Note: `attachToColumn` is REQUIRED for `assetType === "custom"` — the
+   * worker can't infer the bucket from the asset type. For canonical asset
+   * types (`angles` / `materials` / `variations` / `motion`), the column is
+   * derived automatically by the route.
+   */
+  generateAsset(data) {
+    return this.client.request("POST", "/v1/generate-object-asset", { body: data });
+  }
+  /**
+   * Fire `POST /v1/generate-object-motion` to animate the object's main
+   * image into a motion clip. Image-to-video, single clip per call; the
+   * attach column is hardcoded to `motion_clips` server-side (objects have a
+   * single motion bucket so the caller doesn't supply `attachToColumn`).
+   * When the studio path is set (`attachToObjectId` + `attachName`), the
+   * worker appends `{ name: attachName, url: <result> }` to the row's
+   * `motion_clips` column on completion.
+   *
+   * Defaults: `provider` → `"kling-turbo"`, `aspectRatio` → `"1:1"` (set
+   * server-side via `resolveObjectAspectRatio({ assetType: "motion" })`).
+   */
+  generateMotion(data) {
+    return this.client.request("POST", "/v1/generate-object-motion", { body: data });
+  }
+  /**
+   * Approve a completed `generate-object` job as the object's main image.
+   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)
+   * inline. Returns the new main-image URL plus the caption.
+   *
+   * Caption-failure semantics: the route still sends `""` on LLM sub-failure,
+   * but the SDK normalizes `""` → `null` here so `canonicalDescription` carries
+   * the same `string | null` semantics as characters. The main image is still
+   * set; call `recaption()` to retry.
+   *
+   * Optimistic-concurrency: pass `expectedUpdatedAt` to gate the update on
+   * the row's current `updated_at`; on mismatch the route returns 409
+   * `concurrent_modification` carrying the fresh token.
+   */
+  async approveMainImage(id, candidateJobId, expectedUpdatedAt) {
+    const res = await this.client.request(
+      "POST",
+      `/v1/objects/${encodeURIComponent(id)}/approve-main-image`,
+      { body: { candidateJobId, expectedUpdatedAt } }
+    );
+    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null };
+  }
+  /**
+   * Re-fire the LLM caption against the object's current main image. 502s
+   * on LLM failure (unlike `approveMainImage` which preserves the side-effect
+   * and returns ""); returns 400 `main_image_required` if no main image is
+   * set yet.
+   *
+   * The route is a pure idempotent retry — it does NOT accept an
+   * `expectedUpdatedAt` token (per Phase E1 calibration finding: backend
+   * route is idempotent retry, not gated on optimistic-concurrency).
+   */
+  recaption(id) {
+    return this.client.request(
+      "POST",
+      `/v1/objects/${encodeURIComponent(id)}/llm-caption`
+    );
+  }
+};
+
+Object.defineProperty(exports, "OBJECT_ASPECT_DEFAULTS", {
+  enumerable: true,
+  get: function () { return entities.OBJECT_ASPECT_DEFAULTS; }
+});
+Object.defineProperty(exports, "OBJECT_ASPECT_OPTIONS", {
+  enumerable: true,
+  get: function () { return entities.OBJECT_ASPECT_OPTIONS; }
+});
+Object.defineProperty(exports, "OBJECT_ASSET_TYPES", {
+  enumerable: true,
+  get: function () { return entities.OBJECT_ASSET_TYPES; }
+});
+Object.defineProperty(exports, "OBJECT_ATTACH_COLUMNS", {
+  enumerable: true,
+  get: function () { return entities.OBJECT_ATTACH_COLUMNS; }
+});
+exports.ObjectsResource = ObjectsResource;
+//# sourceMappingURL=chunk-CR5E2SF3.cjs.map
+//# sourceMappingURL=chunk-CR5E2SF3.cjs.map

package/dist/chunk-CR5E2SF3.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/objects.ts"],"names":[],"mappings":"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","file":"chunk-CR5E2SF3.cjs","sourcesContent":["import type { ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn } from \"@nodaro/shared/entities\"\nexport type { ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio } from \"@nodaro/shared/entities\"\nexport { OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OBJECT_ASPECT_OPTIONS, OBJECT_ASPECT_DEFAULTS } from \"@nodaro/shared/entities\"\nimport type { NodaroClientCore } from \"../core.js\"\nimport type { GenerationSessionParams } from \"./nodes.js\"\n\n/**\n * Re-export the shared `ObjectAssetType` / `ObjectAttachColumn` unions and\n * their runtime tuples so SDK consumers don't have to add `@nodaro/shared` as\n * a second dependency just to typecheck the `assetType` / `attachToColumn`\n * fields. Single source of truth lives in `@nodaro/shared/entity-prompts`.\n *\n * `ObjectAspectRatio` is re-exported alongside them — `generateMotion`'s\n * `aspectRatio` field is the 5-value object enum (1:1 / 3:4 / 16:9 / 9:16 /\n * 4:3) from `@nodaro/shared/object-aspect-defaults`. Distinct from\n * `CharacterAspectRatio` because objects support an extra 4:3 framing for\n * product-showcase shots.\n */\n\n/**\n * Reference-photo kind discriminator — the mood-board roles a user can attach\n * to an object. Mirrors the `reference_photos.kind` field accepted by\n * `backend/src/routes/objects.ts` (the route accepts open strings; this SDK\n * type narrows to the 6 canonical roles surfaced by the Studio). `other` is\n * the free-form bucket.\n */\nexport type ObjectReferencePhotoKind =\n  | \"front\"\n  | \"side\"\n  | \"detail\"\n  | \"context\"\n  | \"moodBoard\"\n  | \"other\"\n\nexport interface ObjectReferencePhoto {\n  url: string\n  kind: ObjectReferencePhotoKind\n}\n\n/**\n * An object record returned by Nodaro's REST API. Mirrors the camelCase\n * shape produced by `backend/src/routes/objects.ts::toCamel()`.\n *\n * Asset buckets (`angles`, `materials`, `variations`, `motionClips`) are\n * independent JSONB arrays keyed by a human-readable variant name (e.g.\n * `\"front\"`, `\"wood\"`, `\"weathered\"`). Each entry's `url` points at an\n * R2-hosted asset.\n *\n * Identity-foundation fields:\n *   - `referencePhotos` — caller-supplied mood-board refs (cap 20). Objects\n *     do NOT carry a `piiConsentAt` field (location Phase 2 #7 only).\n *   - `canonicalDescription` — ~80–120-word LLM-authored visual caption,\n *     populated by `approveMainImage()` / `recaption()`. The wire still sends\n *     `\"\"` on caption sub-failure (the breaking wire change is deferred to a\n *     major bump), but `get()` normalizes `\"\"` → `null` so consumers see the\n *     same `string | null` semantics as characters.\n *   - `styleLock` — whether asset gens should anchor to the canonical style\n *     captured at approval time. Defaults to `true` on new rows.\n *\n * `Object` shadows the JS global, which TypeScript handles cleanly via\n * local-scope resolution. Consumers who need both can alias as\n * `import type { Object as NodaroObject } from \"@nodaro/sdk\"`.\n */\nexport interface Object {\n  id: string\n  userId: string\n  nodeId: string\n  projectId: string | null\n  name: string\n  description: string | null\n  category: string | null\n  style: string | null\n  sourceImageUrl: string | null\n  /** MODEL_CATALOG image-model id the main image was generated with (or `null`).\n   *  Set on create + editable via the update route. */\n  imageProvider: string | null\n  angles: Array<{ name: string; url: string }>\n  materials: Array<{ name: string; url: string }>\n  variations: Array<{ name: string; url: string }>\n  motionClips: Array<{ name: string; url: string }>\n  /** Named Product Boards — dense reference sheets, one per variant/colorway\n   *  (the `generate-image/product-board` factory preset rendered from the\n   *  object's images). A first-class bucket: community publish snapshots it\n   *  and clone hands the consumer their own copy to extend. Defaults to `[]`.\n   *  `type` marks an image-collage `\"identity\"` sheet vs a plain `\"looks\"`\n   *  board; `sourceImages` are the R2 URLs it was collaged from. Both optional\n   *  + backward-compatible (legacy boards have neither). */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }> | null\n  referencePhotos: ObjectReferencePhoto[]\n  /** `null` when no caption is set (or the LLM caption sub-failed) — the wire\n   *  sends `\"\"`, normalized to `null` in `get()` to match character semantics. */\n  canonicalDescription: string | null\n  styleLock: boolean\n  /** The user's chosen DEFAULT asset take per variant (Studio version history).\n   *  OPAQUE map: key `\"<bucket>:<variant>\"` (e.g. `\"angles:front\"`) → the chosen\n   *  asset URL (one already present in that bucket). Stored verbatim — keys are\n   *  NOT normalized; soft-capped server-side at 200 keys / 2048-char values\n   *  (overflow dropped silently). Defaults to `{}`. */\n  selectedAssetByVariant?: Record<string, string> | null\n  deletedAt: string | null\n  createdAt: string\n  updatedAt: string\n}\n\n/**\n * GET /v1/objects/:id may append a `pendingJobs` bucket the studio uses to\n * rehydrate spinners after a reload. Optional on the SDK surface — it doesn't\n * appear on `list()` rows.\n */\nexport interface ObjectDetail extends Object {\n  pendingJobs?: Array<{\n    jobId: string\n    assetType: string\n    name: string\n    status: string\n  }>\n}\n\n/**\n * Body for `client.objects.create()`. Mirrors the INSERT branch of\n * `upsertObjectBody` in `backend/src/routes/objects.ts`. `name` + `nodeId`\n * are required on create.\n */\nexport interface CreateObjectInput {\n  nodeId: string\n  name: string\n  description?: string\n  category?: ObjectCategory\n  style?: string\n  workflowId?: string\n  projectId?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: ObjectReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map.\n   *  Keys stored verbatim; soft-capped server-side at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n}\n\n/**\n * The 10-value Object category enum. Mirrors the literal accepted by\n * `POST /v1/generate-object` and surfaced in the Object Studio category\n * picker. Distinct from location's geography-based set.\n */\nexport type ObjectCategory =\n  | \"furniture\"\n  | \"vehicle\"\n  | \"weapon\"\n  | \"food\"\n  | \"clothing\"\n  | \"electronics\"\n  | \"nature\"\n  | \"tool\"\n  | \"animal\"\n  | \"other\"\n\n/**\n * Body for `client.objects.update()`. Mirrors the UPDATE branch of\n * `upsertObjectBody` in `backend/src/routes/objects.ts`.\n *\n * Worker-owned asset buckets (`angles` / `materials` / `variations` /\n * `motionClips`) are deliberately omitted — the route drops them on UPDATE\n * so a Studio auto-save with a stale snapshot cannot clobber the worker's\n * atomic `append_object_asset()` writes.\n *\n * `expectedUpdatedAt` is the optimistic-concurrency token: when present, the\n * UPDATE only succeeds if the row's `updated_at` still matches; on mismatch\n * the route returns 409 so the studio can re-fetch + merge.\n */\nexport interface UpdateObjectInput {\n  name?: string\n  description?: string\n  category?: ObjectCategory\n  style?: string\n  sourceImageUrl?: string\n  /** Persistent image-model id (a MODEL_CATALOG image model). Validated\n   *  server-side — unknown / non-image / \"\" is stored as `null`. */\n  imageProvider?: string | null\n  referencePhotos?: ObjectReferencePhoto[]\n  canonicalDescription?: string\n  styleLock?: boolean\n  /** The user's chosen DEFAULT asset take per variant. OPAQUE\n   *  `\"<bucket>:<variant>\"` → chosen-URL map; a write REPLACES the whole map\n   *  (omit to leave untouched). Keys stored verbatim; soft-capped server-side\n   *  at 200 keys / 2048-char values. */\n  selectedAssetByVariant?: Record<string, string>\n  /** Named Product Boards (see `Object.boards`) — whole-array replace,\n   *  USER-owned (unlike the worker-owned buckets it flows through UPDATE).\n   *  Server caps: 24 boards, 200-char names, 30 sourceImages per board. */\n  boards?: Array<{ name: string; url: string; type?: \"looks\" | \"identity\"; sourceImages?: string[] }>\n  expectedUpdatedAt?: string\n}\n\nexport interface UpdateObjectResult {\n  id: string\n  updatedAt: string\n}\n\n/**\n * Combined create + update body (parameter for both branches). Exported for\n * callers that want to drive a single `upsert` flow without picking between\n * `Create*` and `Update*`. Mirrors the `upsertObjectBody` Zod schema in\n * `backend/src/routes/objects.ts`. `nodeId` + `name` are required on INSERT;\n * `id` flips the route into UPDATE mode.\n */\nexport interface UpsertObjectInput extends CreateObjectInput {\n  id?: string\n  expectedUpdatedAt?: string\n}\n\nexport type UpsertObjectResult = { id: string } | UpdateObjectResult\n\nexport interface ListObjectsParams {\n  /** When true, return archived objects instead of active ones. */\n  archived?: boolean\n  /** Optional project filter — server-scoped to the caller's user. */\n  projectId?: string\n  /**\n   * Search words: only the objects whose name or description contains every\n   * word (split on spaces, the first 5), in any order, ignoring case. Each\n   * word is matched as written (`%`, `_` and `*` are not wildcards;\n   * punctuation is kept); blank means no search; up to 200 characters.\n   * Combines with the other filters and with `cursor` paging.\n   */\n  q?: string\n  /**\n   * Max rows to return (cap 500). OPT-IN: omitted, the server returns the\n   * full legacy listing with no `nextCursor`; supplied, the response is one\n   * page plus `nextCursor` — keep passing it back until it is `null`.\n   */\n  limit?: number\n  /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */\n  cursor?: string\n}\n\n/**\n * Input for `client.objects.generate()` — fires the\n * `POST /v1/generate-object` route. Produces 1–10 candidate\n * main images; each lands as one `jobs` row in `pending` state and is then\n * enqueued for the worker.\n *\n * When `attachToObjectId` is set AND `count === 1`, the worker writes the\n * resulting URL directly to `objects.source_image_url` on completion —\n * caller doesn't need a separate `approveMainImage` call. Multi-candidate\n * batches MUST go through explicit approval so the user picks the winner.\n *\n * `seedPromptHint` (Pass 7 F-77) flows the parameter-picker's prompt fragment\n * through to the worker so a catalog selection (e.g. \"antique brass lantern\")\n * gets appended to the generated prompt context.\n */\nexport interface GenerateObjectInput extends GenerationSessionParams {\n  name: string\n  description?: string\n  userPrompt?: string\n  category?: ObjectCategory\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  sourceImageUrl?: string\n  provider?: string\n  /** Number of candidate images to generate (1–10; server-validated). */\n  count?: number\n  /** Auto-attach the result to this object row (single-candidate only). */\n  attachToObjectId?: string\n  /** Parameter-picker prompt-fragment pass-through. */\n  seedPromptHint?: string\n  /** Optional name to set on the attached row alongside the main image. */\n  attachName?: string\n  /** Optimistic-concurrency token for the single-candidate auto-attach path. */\n  expectedUpdatedAt?: string\n}\n\n/**\n * `generate()` response — `jobIds` is ALWAYS present (the harmonized contract,\n * matching characters). `jobId` is a deprecated back-compat alias populated only\n * on `count === 1`; prefer `jobIds`. (Will be removed on the next major.)\n */\nexport interface GenerateObjectResult {\n  jobIds: string[]\n  /** @deprecated count===1 back-compat alias — use `jobIds`. */\n  jobId?: string\n}\n\n/**\n * Input for `client.objects.generateAsset()` — fires the\n * `POST /v1/generate-object-asset` route. Produces a single\n * angles / materials / variations / custom variant.\n *\n * When all three studio-path fields are set (`attachToObjectId` +\n * `attachToColumn` + `attachName`), the worker appends\n * `{ name: attachName, url: <result> }` to the named JSONB array column on\n * the user's object row on completion. `attachToColumn` is REQUIRED for\n * `assetType === \"custom\"` — the worker can't infer the bucket from the\n * asset type.\n */\nexport interface GenerateObjectAssetInput extends GenerationSessionParams {\n  assetType: ObjectAssetType\n  variant: string\n  name: string\n  description?: string\n  userPrompt?: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  sourceImageUrl?: string\n  provider?: string\n  attachToObjectId?: string\n  attachToColumn?: ObjectAttachColumn\n  attachName?: string\n  /** Parameter-picker prompt-fragment pass-through (Pass 7 F-77). */\n  seedPromptHint?: string\n}\n\nexport interface GenerateObjectAssetResult {\n  jobId: string\n}\n\n/**\n * Input for `client.objects.generateMotion()` — fires the\n * `POST /v1/generate-object-motion` route. Produces a single motion clip\n * (rotation, orbit, hover, drift, etc.) animated FROM a static product-shot\n * image.\n *\n * Mirrors `client.locations.generateMotion()` minus the location-specific\n * atmospheric fields. The route hardcodes the attach column to `motion_clips`\n * — callers supply `attachToObjectId` + `attachName` only.\n *\n * `sourceImageUrl` is REQUIRED — image-to-video needs a source frame and the\n * route has no fallback (no `source_image_url` column to pull from on the\n * objects row at this point in the flow; the studio path supplies the\n * canonical product-shot URL explicitly).\n *\n * Object-specific defaults vs location:\n *   - `provider` defaults to `\"kling-turbo\"` (not location's `\"kling\"`)\n *   - `aspectRatio` defaults to `\"1:1\"` server-side via\n *     `resolveObjectAspectRatio({ assetType: \"motion\" })` — objects are\n *     product-showcase framing, not cinematic establishing shots.\n *\n * When the studio path is set (`attachToObjectId` + `attachName`), the\n * worker appends `{ name: attachName, url: <result> }` to the object row's\n * `motion_clips` JSONB column on completion.\n */\nexport interface GenerateObjectMotionInput extends GenerationSessionParams {\n  motionPrompt: string\n  sourceImageUrl: string\n  provider?: string\n  name: string\n  /** Source clip URL — when set, worker routes to video-to-video refine. */\n  refineFromVideoUrl?: string\n  category?: string\n  style?: \"realistic\" | \"anime\" | \"3d-pixar\" | \"illustration\"\n  canonicalDescription?: string\n  /** Parameter-picker prompt-fragment pass-through (Pass 7 F-77). */\n  seedPromptHint?: string\n  attachToObjectId?: string\n  attachName?: string\n  /**\n   * Optional aspect ratio override. Defaults to 1:1 server-side. One of the\n   * 5-value `ObjectAspectRatio` union (1:1 / 3:4 / 16:9 / 9:16 / 4:3) —\n   * objects have their own enum (with 4:3 added) vs the character set.\n   */\n  aspectRatio?: ObjectAspectRatio\n  /**\n   * Optional clip duration in seconds. Validated server-side against the chosen\n   * provider's allowed durations (e.g. kling 5/10, wan-i2v 5/10/15); omitted →\n   * the model's own default (no behavior change). Mirrors generate-video's\n   * per-model i2v duration lever.\n   */\n  duration?: number\n}\n\nexport interface GenerateObjectMotionResult {\n  jobId: string\n}\n\nexport interface ApproveObjectMainImageResult {\n  sourceImageUrl: string\n  /**\n   * LLM-authored caption. `null` when the LLM caption sub-failed — the wire\n   * sends `\"\"`, normalized to `null` here so consumers see the same\n   * `string | null` semantics as characters. The main image is still set; call\n   * `recaption()` to retry.\n   */\n  canonicalDescription: string | null\n}\n\nexport interface RecaptionObjectResult {\n  canonicalDescription: string\n}\n\nexport class ObjectsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * List the caller's objects. By default returns active objects only;\n   * pass `archived: true` to fetch soft-deleted rows for an \"archive\" view.\n   * Optional `projectId` scopes the result to a single project; `q` keeps the\n   * objects whose name or description contains it.\n   */\n  list(params: ListObjectsParams = {}): Promise<{ objects: Object[]; nextCursor?: string | null }> {\n    const query: Record<string, string | undefined> = {}\n    if (params.archived) query.archived = \"true\"\n    if (params.projectId) query.projectId = params.projectId\n    if (params.q) query.q = params.q\n    if (params.limit !== undefined) query.limit = String(params.limit)\n    if (params.cursor) query.cursor = params.cursor\n    return this.client.request(\"GET\", \"/v1/objects\", { query })\n  }\n\n  /**\n   * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted\n   * rows so callers can drive a UI \"Archived\" tab without re-encoding the\n   * query param.\n   *\n   * `archived` is omitted from the param type — it's always set to `true` here.\n   */\n  listArchived(params: Omit<ListObjectsParams, \"archived\"> = {}): Promise<{ objects: Object[]; nextCursor?: string | null }> {\n    return this.list({ ...params, archived: true })\n  }\n\n  /**\n   * Fetch a single object including in-flight asset job state. Soft-deleted\n   * (archived) rows are NOT returned by id — the route enforces\n   * `deleted_at IS NULL` so archived objects 404 (uniform Pass 10 F-90b\n   * \"not_found\" — does not leak the deleted vs non-existent distinction).\n   */\n  async get(id: string): Promise<ObjectDetail> {\n    const res = await this.client.request<ObjectDetail>(\n      \"GET\",\n      `/v1/objects/${encodeURIComponent(id)}`,\n    )\n    // Normalize the wire `\"\"` caption (DB null / LLM sub-failure) → null so\n    // consumers see the same `string | null` semantics as characters. New\n    // object — never mutate the response.\n    return { ...res, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Create a new object. `name` + `nodeId` are required — the route 400s\n   * otherwise. Returns the new row's id.\n   *\n   * Note: the underlying route is the same `POST /v1/objects` upsert that\n   * powers `update()`. This convenience wrapper enforces the INSERT-required\n   * fields at the type level and never sends an `id`.\n   */\n  create(data: CreateObjectInput): Promise<{ id: string }> {\n    return this.client.request(\"POST\", \"/v1/objects\", { body: data })\n  }\n\n  /**\n   * Update an object. Only the fields you pass are written — undefined keys\n   * are NOT touched on the row. Worker-owned asset buckets are intentionally\n   * not exposed on this surface (see `UpdateObjectInput` for the rationale).\n   *\n   * Optimistic-concurrency: pass `expectedUpdatedAt` to require the row's\n   * `updated_at` still matches; on mismatch the route returns 409\n   * `concurrent_modification` carrying the fresh `updatedAt`. The SDK\n   * surfaces that as a generic `NodaroError` with the same code (per Phase\n   * E1 calibration finding — error centralization in `throwApiError`).\n   */\n  update(id: string, data: UpdateObjectInput): Promise<UpdateObjectResult> {\n    return this.client.request(\"POST\", \"/v1/objects\", {\n      body: { id, ...data },\n    })\n  }\n\n  /**\n   * Soft-delete (archive) an object. The row is hidden from `list()` by\n   * default but recoverable via `restore(id)` or visible under\n   * `listArchived()`. Idempotent — repeating a delete on an already-archived\n   * row is a no-op.\n   */\n  delete(id: string): Promise<{ success: true; archived: true }> {\n    return this.client.request(\"DELETE\", `/v1/objects/${encodeURIComponent(id)}`)\n  }\n\n  /**\n   * Hard-delete (permanent) an object — the row + every R2 asset it\n   * references. Archived rows ONLY: active objects return 400 `not_archived`.\n   * Call `delete()` first to archive, then `permanentDelete()` to destroy.\n   *\n   * Mirrors the `app_runs` permanent-delete pattern (archive-first) so a\n   * stray SDK / curl caller cannot bypass the studio's archive-first UI\n   * flow.\n   */\n  permanentDelete(id: string): Promise<{ success: true; permanent: true }> {\n    return this.client.request(\"DELETE\", `/v1/objects/${encodeURIComponent(id)}`, {\n      query: { permanent: \"true\" },\n    })\n  }\n\n  /**\n   * Un-archive an object. If the original name now collides (case-\n   * insensitive) with an active row, the server auto-suffixes \"(restored)\"\n   * and returns the effective name.\n   */\n  restore(id: string): Promise<{ id: string; name: string }> {\n    return this.client.request(\"POST\", `/v1/objects/${encodeURIComponent(id)}/restore`)\n  }\n\n  /**\n   * Fire `POST /v1/generate-object` to produce one or more candidate main\n   * images. With `count > 1`, all jobs are reserved up-front before any\n   * is enqueued — mid-batch failures roll back atomically.\n   *\n   * When `attachToObjectId` is set AND `count === 1`, the worker writes\n   * the result directly to the row's `source_image_url`; otherwise you must\n   * call `approveMainImage()` after picking a candidate.\n   */\n  async generate(data: GenerateObjectInput): Promise<GenerateObjectResult> {\n    const res = await this.client.request<{ jobId?: string; jobIds?: string[] }>(\n      \"POST\", \"/v1/generate-object\", { body: data },\n    )\n    // Tolerate the legacy `{ jobId }`-only shape (older server): synthesize jobIds.\n    const jobIds = res.jobIds ?? (res.jobId ? [res.jobId] : [])\n    return res.jobId ? { jobIds, jobId: res.jobId } : { jobIds }\n  }\n\n  /**\n   * Fire `POST /v1/generate-object-asset` to produce a single variant.\n   * When the studio path is set (`attachToObjectId` + `attachToColumn` +\n   * `attachName`), the worker appends `{ name: attachName, url: <result> }`\n   * to the named JSONB array column on completion.\n   *\n   * Note: `attachToColumn` is REQUIRED for `assetType === \"custom\"` — the\n   * worker can't infer the bucket from the asset type. For canonical asset\n   * types (`angles` / `materials` / `variations` / `motion`), the column is\n   * derived automatically by the route.\n   */\n  generateAsset(\n    data: GenerateObjectAssetInput,\n  ): Promise<GenerateObjectAssetResult> {\n    return this.client.request(\"POST\", \"/v1/generate-object-asset\", { body: data })\n  }\n\n  /**\n   * Fire `POST /v1/generate-object-motion` to animate the object's main\n   * image into a motion clip. Image-to-video, single clip per call; the\n   * attach column is hardcoded to `motion_clips` server-side (objects have a\n   * single motion bucket so the caller doesn't supply `attachToColumn`).\n   * When the studio path is set (`attachToObjectId` + `attachName`), the\n   * worker appends `{ name: attachName, url: <result> }` to the row's\n   * `motion_clips` column on completion.\n   *\n   * Defaults: `provider` → `\"kling-turbo\"`, `aspectRatio` → `\"1:1\"` (set\n   * server-side via `resolveObjectAspectRatio({ assetType: \"motion\" })`).\n   */\n  generateMotion(\n    data: GenerateObjectMotionInput,\n  ): Promise<GenerateObjectMotionResult> {\n    return this.client.request(\"POST\", \"/v1/generate-object-motion\", { body: data })\n  }\n\n  /**\n   * Approve a completed `generate-object` job as the object's main image.\n   * Sets `source_image_url` and fires the LLM caption (Claude Sonnet vision)\n   * inline. Returns the new main-image URL plus the caption.\n   *\n   * Caption-failure semantics: the route still sends `\"\"` on LLM sub-failure,\n   * but the SDK normalizes `\"\"` → `null` here so `canonicalDescription` carries\n   * the same `string | null` semantics as characters. The main image is still\n   * set; call `recaption()` to retry.\n   *\n   * Optimistic-concurrency: pass `expectedUpdatedAt` to gate the update on\n   * the row's current `updated_at`; on mismatch the route returns 409\n   * `concurrent_modification` carrying the fresh token.\n   */\n  async approveMainImage(\n    id: string,\n    candidateJobId: string,\n    expectedUpdatedAt?: string,\n  ): Promise<ApproveObjectMainImageResult> {\n    const res = await this.client.request<{ sourceImageUrl: string; canonicalDescription: string | null }>(\n      \"POST\",\n      `/v1/objects/${encodeURIComponent(id)}/approve-main-image`,\n      { body: { candidateJobId, expectedUpdatedAt } },\n    )\n    // Normalize the wire `\"\"` (LLM sub-failure) → null; build a new object\n    // rather than mutating the response.\n    return { sourceImageUrl: res.sourceImageUrl, canonicalDescription: res.canonicalDescription || null }\n  }\n\n  /**\n   * Re-fire the LLM caption against the object's current main image. 502s\n   * on LLM failure (unlike `approveMainImage` which preserves the side-effect\n   * and returns \"\"); returns 400 `main_image_required` if no main image is\n   * set yet.\n   *\n   * The route is a pure idempotent retry — it does NOT accept an\n   * `expectedUpdatedAt` token (per Phase E1 calibration finding: backend\n   * route is idempotent retry, not gated on optimistic-concurrency).\n   */\n  recaption(id: string): Promise<RecaptionObjectResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/objects/${encodeURIComponent(id)}/llm-caption`,\n    )\n  }\n}\n"]}

package/dist/chunk-CRCPRZFN.js

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

package/dist/chunk-CRCPRZFN.js.map

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

package/dist/chunk-CYRFD6KR.cjs

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

package/dist/chunk-CYRFD6KR.cjs.map

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

package/dist/chunk-D3PW7AHZ.js

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

package/dist/chunk-D3PW7AHZ.js.map

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

package/dist/chunk-DKEYSJCE.cjs

@@ -0,0 +1,82 @@
+'use strict';
+
+// src/resources/apps.ts
+var AppsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** List published apps. Public — no auth required for community apps. */
+  list(params = {}) {
+    const qs = new URLSearchParams();
+    if (params.search) qs.set("search", params.search);
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params.cursor) qs.set("cursor", params.cursor);
+    if (params.category) qs.set("category", params.category);
+    const query = qs.toString();
+    return this.client.request("GET", `/v1/apps/browse${query ? `?${query}` : ""}`);
+  }
+  /** Get one app's metadata + input schema by slug. */
+  get(slug) {
+    return this.client.request("GET", `/v1/app/${encodeURIComponent(slug)}`);
+  }
+  /**
+   * Trigger an app run with the given input values. The keys in `inputs` must
+   * match the app's input-schema field names (see `get(slug).inputSchema`).
+   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).
+   * Returns the execution-id for status polling via client.executions.get().
+   */
+  run(slug, inputs = {}, opts = {}) {
+    return this.client.request("POST", `/v1/app/${encodeURIComponent(slug)}/run`, {
+      body: { inputs, ...opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {} }
+    });
+  }
+  /** List past runs for an app (the caller must own the app or the runs). */
+  listRuns(slug, params = {}) {
+    const qs = new URLSearchParams();
+    if (params.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params.cursor) qs.set("cursor", params.cursor);
+    const query = qs.toString();
+    return this.client.request(
+      "GET",
+      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : ""}`
+    );
+  }
+  /** Get one app-run by id. */
+  getRun(slug, runId) {
+    return this.client.request(
+      "GET",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
+    );
+  }
+  resume(slug, runId, opts = {}) {
+    return this.client.request(
+      "POST",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,
+      {
+        body: {
+          ...opts.dryRun ? { dryRun: true } : {},
+          ...opts.version !== void 0 ? { version: opts.version } : {}
+        }
+      }
+    );
+  }
+  /**
+   * Archive (soft-delete) a published-app run. The run is hidden from the
+   * default run list and can be restored or permanently deleted from the
+   * archive view at https://app.nodaro.ai/archived-runs.
+   *
+   * @param slug   The published app's slug (the last path segment of its URL).
+   * @param runId  The run's UUID.
+   */
+  deleteRun(slug, runId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`
+    );
+  }
+};
+
+exports.AppsResource = AppsResource;
+//# sourceMappingURL=chunk-DKEYSJCE.cjs.map
+//# sourceMappingURL=chunk-DKEYSJCE.cjs.map

package/dist/chunk-DKEYSJCE.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/apps.ts"],"names":[],"mappings":"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","file":"chunk-DKEYSJCE.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * A published app — a workflow wrapped in a curated input/output presentation.\n * Returned by the public `/v1/apps/browse` endpoint.\n */\nexport interface PublishedApp {\n  id: string\n  slug: string\n  name: string\n  description?: string | null\n  creatorId: string\n  creatorName?: string | null\n  thumbnailUrl?: string | null\n  category?: string | null\n  isFeatured?: boolean\n  runCount?: number\n  /** The listed price per run; when `perMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits?: number | null\n  /**\n   * Credits per minute of the recording the app is given, when its price\n   * follows that recording's length: the price is `estimatedCredits` plus\n   * this per minute. 0 or absent when the price does not depend on a\n   * recording's length.\n   */\n  perMinuteCredits?: number\n  /**\n   * Credits for each item beyond the creator's saved items of a list input\n   * the app's user fills: the price is the listed one plus this per further\n   * item. 0 or absent when the app has no such input.\n   */\n  perItemCredits?: number\n  /**\n   * The listed price is a range: `estimatedCredits` (with `perMinuteCredits` /\n   * `perItemCredits`) is \"from\" — the app's saved settings — and these are\n   * \"up to\": the most a run can cost over the choices the app's user has (every\n   * exposed field, at the creator's restricted values where set). Present only\n   * when they differ from \"from\"; absent on an app published before the range\n   * existed until its next publish.\n   */\n  maxEstimatedCredits?: number\n  maxPerMinuteCredits?: number\n  maxPerItemCredits?: number\n  createdAt: string\n  updatedAt: string\n}\n\nexport interface ListAppsParams {\n  /** Substring search across app name + description. */\n  search?: string\n  /** Page size; backend caps at 50. */\n  limit?: number\n  /** Cursor token returned by the previous page. */\n  cursor?: string\n  /** Filter to a single category slug. */\n  category?: string\n}\n\nexport interface ListAppsResult {\n  data: PublishedApp[]\n  nextCursor?: string | null\n}\n\n/**\n * App detail — includes the input schema (required + optional fields end users\n * fill in) and the output mapping (which workflow nodes produce which display\n * cards).\n */\nexport interface PublishedAppDetail extends PublishedApp {\n  inputSchema: Record<string, unknown>\n  outputs: Array<{ nodeId: string; label: string; type: string }>\n  /**\n   * The app run alone: the listed price less its Render final part (run and\n   * charged separately) — fixed, per minute of the recording and per further\n   * list item. Absent from a server that predates them; read the listed\n   * `estimatedCredits` / `perMinuteCredits` / `perItemCredits` instead.\n   */\n  runEstimatedCredits?: number\n  runPerMinuteCredits?: number\n  runPerItemCredits?: number\n  /**\n   * Whether this server charges Edit Plan per started minute of the recording\n   * (otherwise in 15/30/60/90/120/180-minute steps). Absent from a server that\n   * predates it: read it as the steps.\n   */\n  editPlanPerMinute?: boolean\n}\n\nexport interface AppRunResult {\n  /** The execution-id that was started — poll via client.executions.get(). */\n  executionId: string\n  status: \"pending\" | \"running\"\n  /** App-run id (distinct from executionId — used by listRuns/getRun). */\n  runId?: string\n}\n\nexport interface AppRun {\n  id: string\n  appSlug: string\n  executionId: string\n  status: \"pending\" | \"running\" | \"completed\" | \"failed\" | \"cancelled\"\n  inputs: Record<string, unknown>\n  outputs?: Array<{ nodeId: string; type: string; url?: string; text?: string }>\n  startedAt: string\n  finishedAt?: string | null\n}\n\nexport interface ListAppRunsParams {\n  limit?: number\n  cursor?: string\n}\n\n/**\n * Result of a soft-delete (archive) operation. The run is moved to the user's\n * archive in the Nodaro UI; restoration and permanent deletion are UI-only by\n * design — SDK / MCP / API delete callers can't accidentally destroy data.\n */\nexport interface DeleteAppRunResult {\n  success: true\n  archived: true\n}\n\n/** Advanced per-run options for `apps.run`. */\nexport interface RunAppOptions {\n  /**\n   * Raw node-data overrides keyed by node id → field → value, merged onto the\n   * app's workflow for THIS run only. Reaches fields that are NOT exposed as app\n   * inputs — e.g. `{ [nodeId]: { promptPrefix: \"…\", promptSuffix: \"…\" } }` to\n   * wrap the end user's prompt with text they never see.\n   */\n  inputOverrides?: Record<string, Record<string, unknown>>\n}\n\n/** Options for `apps.resume` — the Retry of a failed app run. */\nexport interface ResumeAppRunOptions {\n  /** Answer what the Retry would run and charge, and start nothing. */\n  dryRun?: boolean\n  /**\n   * The app version you expect the Retry to run — the one starting over would\n   * run. Absent: the app's latest. A run of another version is refused with\n   * `app_run_version_changed`; send the run's own version (the refusal's\n   * `runVersion`) to continue on it anyway.\n   */\n  version?: number\n}\n\n/** One step a Retry runs again. */\nexport interface AppRunResumeStep {\n  nodeId: string\n  type: string\n  /** The node's label, or `null` when it has none. */\n  label: string | null\n}\n\n/** What a Retry would do (`apps.resume(…, { dryRun: true })`); nothing is started. */\nexport interface AppRunResumePlan {\n  runId: string\n  /** The failed execution the Retry continues. */\n  continuesExecutionId: string\n  /** The app version the Retry runs (the run's own). */\n  appVersion: number | null\n  /** Every node the Retry runs, in graph order. */\n  nodeIds: string[]\n  /** The steps that run again. */\n  steps: AppRunResumeStep[]\n  /** What the Retry is expected to charge, the creator's fee included; `null` without credits. */\n  estimatedCredits: number | null\n  /** Clips handed back at no cost. */\n  reusedClips: number\n  /** Whether your balance and your app credits cover what the Retry holds while it runs; `null` without credits. */\n  sufficient: boolean | null\n  /** Your spendable balance; `null` without credits. */\n  available: number | null\n  /** Your app credits, present only when they are what stops the Retry (it would be refused `insufficient_app_credits`). */\n  appCreditsAllowance?: number\n}\n\n/**\n * A Retry that started. `deduped: true` when a concurrent double press reached\n * the same Retry; a second call made while the first is pending is refused\n * with `already_running` (`AlreadyRunningError`) instead.\n */\nexport interface AppRunResumeResult {\n  /** The Retry's execution — the run now points at it. Poll via client.executions.get(). */\n  executionId: string\n  runId: string\n  status: \"pending\"\n  /** Every node the Retry runs. */\n  nodeIds: string[]\n  /** `true` when a concurrent press had already started this Retry. */\n  deduped?: true\n}\n\n/**\n * The `code` the server gives an `apps.resume` refusal. Nothing is written or\n * billed when a Retry is refused. How each arrives:\n * - `app_run_version_changed` as `AppRunVersionChangedError`;\n * - `already_running` as `AlreadyRunningError` (with the live `executionId`);\n * - `not_found` and `continuation_not_found` as `NotFoundError`, whose `code`\n *   is always `not_found` (the server's message is kept);\n * - `insufficient_credits` and `insufficient_app_credits` as\n *   `InsufficientCreditsError`, whose `code` is always `insufficient_credits`\n *   (the server's message says which);\n * - the rest as `NodaroError` carrying this code.\n */\nexport type AppRunResumeRefusalCode =\n  /** No such run of yours under this app. */\n  | \"not_found\"\n  /** The run's execution is not yours. */\n  | \"continuation_not_found\"\n  /** A malformed run id or body, or a component's run (continued by the run that called it). */\n  | \"validation_error\"\n  /** The app version the run ran is gone: start the run over. */\n  | \"app_run_version_unavailable\"\n  /** The app is on another version than the run ran: start over, or send `version` = the run's. */\n  | \"app_run_version_changed\"\n  /** The run's execution ran another workflow, or another version of it (rare). */\n  | \"continuation_workflow_mismatch\"\n  | \"continuation_version_mismatch\"\n  /** The run did not fail (it completed or was stopped): start it over. */\n  | \"continuation_not_failed\"\n  /** The run is still running, a Retry of it is pending, or it was started again elsewhere. */\n  | \"already_running\"\n  /** Nothing is left to retry: every step completed (409), or the app runs no step (400). */\n  | \"continuation_subset_required\"\n  /** An input the run applied sets a field the app does not let a runner set. */\n  | \"locked_field\"\n  /**\n   * The Retry would stop at a Preview with nobody to review it: retry it from the app page.\n   * (The same refusal arrives under the other preview refusal codes when a review-on use-case\n   * node holds the run; `isPreviewRefusalCode` in `@nodaro/shared/nodes` asks for all of them.)\n   */\n  | \"preview_review_required\"\n  /** Your app credits cannot cover it. */\n  | \"insufficient_app_credits\"\n  /** Your balance cannot cover it. */\n  | \"insufficient_credits\"\n  /** Billing is briefly unavailable for a workspace run (503): try again shortly. */\n  | \"billing_unavailable\"\n\nexport class AppsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** List published apps. Public — no auth required for community apps. */\n  list(params: ListAppsParams = {}): Promise<ListAppsResult> {\n    const qs = new URLSearchParams()\n    if (params.search) qs.set(\"search\", params.search)\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    if (params.category) qs.set(\"category\", params.category)\n    const query = qs.toString()\n    return this.client.request(\"GET\", `/v1/apps/browse${query ? `?${query}` : \"\"}`)\n  }\n\n  /** Get one app's metadata + input schema by slug. */\n  get(slug: string): Promise<{ data: PublishedAppDetail }> {\n    return this.client.request(\"GET\", `/v1/app/${encodeURIComponent(slug)}`)\n  }\n\n  /**\n   * Trigger an app run with the given input values. The keys in `inputs` must\n   * match the app's input-schema field names (see `get(slug).inputSchema`).\n   * `opts.inputOverrides` adds raw per-node overrides (see {@link RunAppOptions}).\n   * Returns the execution-id for status polling via client.executions.get().\n   */\n  run(\n    slug: string,\n    inputs: Record<string, unknown> = {},\n    opts: RunAppOptions = {},\n  ): Promise<AppRunResult> {\n    return this.client.request(\"POST\", `/v1/app/${encodeURIComponent(slug)}/run`, {\n      body: { inputs, ...(opts.inputOverrides ? { inputOverrides: opts.inputOverrides } : {}) },\n    })\n  }\n\n  /** List past runs for an app (the caller must own the app or the runs). */\n  listRuns(slug: string, params: ListAppRunsParams = {}): Promise<{ data: AppRun[]; nextCursor?: string | null }> {\n    const qs = new URLSearchParams()\n    if (params.limit !== undefined) qs.set(\"limit\", String(params.limit))\n    if (params.cursor) qs.set(\"cursor\", params.cursor)\n    const query = qs.toString()\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs${query ? `?${query}` : \"\"}`,\n    )\n  }\n\n  /** Get one app-run by id. */\n  getRun(slug: string, runId: string): Promise<{ data: AppRun }> {\n    return this.client.request(\n      \"GET\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n\n  /**\n   * Retry a FAILED app run from where it stopped: only the steps it did not\n   * complete run, and only those are charged; every step it completed hands\n   * on its result. It runs the version the run ran, with the inputs the run\n   * applied (it takes none of its own). The run's execution moves to the\n   * Retry's.\n   *\n   * `{ dryRun: true }` answers what the Retry would run and charge\n   * ({@link AppRunResumePlan}) and starts nothing — show it before a Retry.\n   * Refusals are listed in {@link AppRunResumeRefusalCode}; to run with other\n   * inputs or on the app's current version, start over with\n   * `run(slug, inputs)` instead.\n   *\n   * @param slug   The published app's slug.\n   * @param runId  The run's UUID (`AppRunResult.runId`, `AppRun.id`).\n   */\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions & { dryRun: true }): Promise<{ data: AppRunResumePlan }>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions & { dryRun?: false }): Promise<AppRunResumeResult>\n  resume(slug: string, runId: string, opts?: ResumeAppRunOptions): Promise<{ data: AppRunResumePlan } | AppRunResumeResult>\n  resume(slug: string, runId: string, opts: ResumeAppRunOptions = {}): Promise<{ data: AppRunResumePlan } | AppRunResumeResult> {\n    return this.client.request(\n      \"POST\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}/resume`,\n      {\n        body: {\n          ...(opts.dryRun ? { dryRun: true } : {}),\n          ...(opts.version !== undefined ? { version: opts.version } : {}),\n        },\n      },\n    )\n  }\n\n  /**\n   * Archive (soft-delete) a published-app run. The run is hidden from the\n   * default run list and can be restored or permanently deleted from the\n   * archive view at https://app.nodaro.ai/archived-runs.\n   *\n   * @param slug   The published app's slug (the last path segment of its URL).\n   * @param runId  The run's UUID.\n   */\n  deleteRun(slug: string, runId: string): Promise<DeleteAppRunResult> {\n    return this.client.request(\n      \"DELETE\",\n      `/v1/app/${encodeURIComponent(slug)}/runs/${encodeURIComponent(runId)}`,\n    )\n  }\n}\n"]}

package/dist/chunk-DPSMVOM3.js

@@ -0,0 +1,15 @@
+// src/resources/tutorials.ts
+var TutorialsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+  list() {
+    return this.client.request("GET", "/v1/tutorials");
+  }
+};
+
+export { TutorialsResource };
+//# sourceMappingURL=chunk-DPSMVOM3.js.map
+//# sourceMappingURL=chunk-DPSMVOM3.js.map

package/dist/chunk-DPSMVOM3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/tutorials.ts"],"names":[],"mappings":";AAuDO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA,EAGpB,IAAA,GAAoD;AAClD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,eAAe,CAAA;AAAA,EACnD;AACF","file":"chunk-DPSMVOM3.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Public tutorials directory (`GET /v1/tutorials`) — video tutorials and\n * flow (template) tutorials, pre-grouped under the shared category taxonomy.\n * Read-only by design; curation is an admin surface outside the public SDK.\n */\n\nexport interface TutorialVideoItem {\n  id: string\n  type: \"video\"\n  title: string\n  description: string | null\n  videoUrl: string\n  thumbnailUrl: string | null\n  categoryId: string\n  sortOrder: number\n  createdAt: string\n  updatedAt: string\n}\n\n/** A workflow template surfaced as a tutorial; `slug` feeds `client.templates`. */\nexport interface TutorialFlowItem {\n  id: string\n  type: \"flow\"\n  templateId: string\n  slug: string | null\n  title: string\n  description: string | null\n  markdownDescription: string | null\n  previewMediaUrl: string | null\n  previewMediaType: \"image\" | \"video\" | null\n  complexity: string\n  /** The listed price; when `estimatedPerMinuteCredits` is above 0, its fixed part. */\n  estimatedCredits: number\n  /** Credits per minute of the recording the template is given (see `TemplateBrowseCard`); 0 or absent when none. */\n  estimatedPerMinuteCredits?: number\n  nodeTypesUsed: string[]\n  providersUsed: string[]\n  nodeCount: number\n  categoryId: string\n  tutorialSortOrder: number\n  workflowId: string\n  createdAt: string\n}\n\nexport interface TutorialCategory {\n  id: string\n  name: string\n  slug: string\n  sortOrder: number\n  videos: TutorialVideoItem[]\n  flows: TutorialFlowItem[]\n}\n\nexport class TutorialsResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /** All enabled tutorial categories with their videos and flow tutorials. Public. */\n  list(): Promise<{ categories: TutorialCategory[] }> {\n    return this.client.request(\"GET\", \"/v1/tutorials\")\n  }\n}\n"]}

package/dist/chunk-E2ZXHS6E.js

@@ -0,0 +1,20 @@
+// src/resources/prompt-helper.ts
+var PromptHelperResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  analyze(input) {
+    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "analyze", ...input } });
+  }
+  generate(input) {
+    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "generate", ...input } });
+  }
+  enhance(input) {
+    return this.client.request("POST", "/v1/prompt-helper/wizard", { body: { action: "enhance", ...input } });
+  }
+};
+
+export { PromptHelperResource };
+//# sourceMappingURL=chunk-E2ZXHS6E.js.map
+//# sourceMappingURL=chunk-E2ZXHS6E.js.map

package/dist/chunk-E2ZXHS6E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/prompt-helper.ts"],"names":[],"mappings":";AAqEO,IAAM,uBAAN,MAA2B;AAAA,EAChC,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA,EAEpB,QAAQ,KAAA,EAA6C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,0BAAA,EAA4B,EAAE,IAAA,EAAM,EAAE,MAAA,EAAQ,SAAA,EAAW,GAAG,KAAA,IAAS,CAAA;AAAA,EAC1G;AAAA,EAEA,SAAS,KAAA,EAA6C;AACpD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,0BAAA,EAA4B,EAAE,IAAA,EAAM,EAAE,MAAA,EAAQ,UAAA,EAAY,GAAG,KAAA,IAAS,CAAA;AAAA,EAC3G;AAAA,EAEA,QAAQ,KAAA,EAA4C;AAClD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,0BAAA,EAA4B,EAAE,IAAA,EAAM,EAAE,MAAA,EAAQ,SAAA,EAAW,GAAG,KAAA,IAAS,CAAA;AAAA,EAC1G;AACF","file":"chunk-E2ZXHS6E.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\nimport type { WizardQuestion, WizardSelection, RecommendedModel, WizardNodeContext } from \"@nodaro/prompts/doctrine\"\nexport type { WizardQuestion, WizardOption, WizardSelection, RecommendedModel, WizardNodeContext } from \"@nodaro/prompts/doctrine\"\n\n// Re-export the canonical wizard types (SSOT in @nodaro/shared).\n\ninterface CommonInput {\n  nodeType: string\n  provider?: string\n  style?: string\n  aspectRatio?: string\n  duration?: number\n  llmModel?: string\n  /** Reasoning effort level (model-dependent). */\n  reasoningEffort?: string\n  /**\n   * Gemini and Claude models. Runs the request on the provider's own API so\n   * `temperature`, `maxTokens` and the full reasoning range actually take\n   * effect — on the default lane those levers are not reliably honoured.\n   * Bills one credit rung up (a premium model moves to premium-direct). A model without a direct lane returns\n   * `400 advanced_mode_unsupported`.\n   */\n  advancedMode?: boolean\n  /** Sampling temperature. Only honoured when `advancedMode` is true. */\n  temperature?: number\n  /** Output token cap. Only honoured when `advancedMode` is true. */\n  maxTokens?: number\n  nodeContext?: WizardNodeContext\n  userPreference?: string\n  /** Associates this call with a workflow execution. Read server-side before Zod. */\n  workflowId?: string\n}\n\nexport interface AnalyzeInput extends CommonInput {\n  /** The user's rough idea. Omit to build questions from scratch. */\n  prompt?: string\n}\nexport interface AnalyzeResult {\n  jobId: string\n  questions: WizardQuestion[]\n}\n\nexport interface GenerateInput extends CommonInput {\n  /** The chosen answers from analyze. */\n  selections: WizardSelection[]\n  /** The user's original rough idea, woven into the generated prompt. */\n  originalPrompt?: string\n}\n\nexport interface EnhanceInput extends CommonInput {\n  /** The rough idea to improve one-shot. Omit to build from scratch. */\n  prompt?: string\n}\n\nexport interface PromptResult {\n  jobId: string\n  prompt: string\n  recommendedModel?: RecommendedModel\n}\n\n/**\n * AI Prompt Wizard — help write/improve prompts for generation nodes.\n *\n * - `analyze` -> guided questions, `generate` -> prompt from selections (the\n *   2-step human flow), or `enhance` -> one-shot \"improve this prompt\".\n *\n * All three delegate to `POST /v1/prompt-helper/wizard`. Throws `NodaroError`\n * on 4xx/5xx (e.g. `validation_error`, `malformed_response`).\n */\nexport class PromptHelperResource {\n  constructor(private client: NodaroClientCore) {}\n\n  analyze(input: AnalyzeInput): Promise<AnalyzeResult> {\n    return this.client.request(\"POST\", \"/v1/prompt-helper/wizard\", { body: { action: \"analyze\", ...input } })\n  }\n\n  generate(input: GenerateInput): Promise<PromptResult> {\n    return this.client.request(\"POST\", \"/v1/prompt-helper/wizard\", { body: { action: \"generate\", ...input } })\n  }\n\n  enhance(input: EnhanceInput): Promise<PromptResult> {\n    return this.client.request(\"POST\", \"/v1/prompt-helper/wizard\", { body: { action: \"enhance\", ...input } })\n  }\n}\n"]}

package/dist/chunk-E37CVHWW.js

@@ -0,0 +1,33 @@
+// src/resources/llm.ts
+var LlmResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
+   * can run several minutes — longer than the client's default 60 s
+   * `timeoutMs`; construct the client with a larger `timeoutMs` for this
+   * call, or use {@link LlmResource.structuredJob}.
+   */
+  structured(input) {
+    return this.client.request("POST", "/v1/llm/structured", { body: input });
+  }
+  /**
+   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
+   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
+   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
+   * `jobs.list({ type: "llm-structured", origin })` finds every run later.
+   * Throws `NotFoundError` on a platform that predates the route. An instance
+   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
+   * permanently — the SDK surfaces that as a generic `NodaroError` with the
+   * same code; treat it as unavailable here, not as transient.
+   */
+  structuredJob(input) {
+    return this.client.request("POST", "/v1/llm/structured/jobs", { body: input });
+  }
+};
+
+export { LlmResource };
+//# sourceMappingURL=chunk-E37CVHWW.js.map
+//# sourceMappingURL=chunk-E37CVHWW.js.map

package/dist/chunk-E37CVHWW.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/resources/llm.ts"],"names":[],"mappings":";AAoEO,IAAM,cAAN,MAAkB;AAAA,EACvB,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQpB,WAAwB,KAAA,EAA4D;AAClF,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAAgC,MAAA,EAAQ,sBAAsB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,cAAc,KAAA,EAA0D;AACtE,IAAA,OAAO,IAAA,CAAK,OAAO,OAAA,CAA2B,MAAA,EAAQ,2BAA2B,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAClG;AACF","file":"chunk-E37CVHWW.js","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Structured LLM output — `POST /v1/llm/structured` and its asynchronous\n * twin. The platform supplies the model lane, forced JSON-Schema output with\n * validation and error-fed retries, the job row and the credit lifecycle; the\n * caller supplies its own system prompt and schema (an app-owned vocabulary\n * the platform cannot know — Nodaro Studio's production plan is the first).\n */\nexport interface LlmStructuredInput {\n  /** The system prompt (≤ 100,000 chars). */\n  system: string\n  /** The user turn (1–100,000 chars). */\n  input: string\n  /** A JSON Schema OBJECT (`type: \"object\"`, ≤ 64 KB, ≤ 20 levels) in the\n   *  keyword subset the server converts — see the API guide. */\n  jsonSchema: Record<string, unknown>\n  /** Names the forced-output tool the provider sees (≤ 64 chars). */\n  schemaName?: string\n  llmModel?: string\n  reasoningEffort?: string\n  /** Invalid answers fed back with their error before the call fails (0–3, default 2). */\n  maxRetries?: number\n  /** Your app's slug — attribution only; `jobs.list({ origin })` finds the rows. */\n  origin?: string\n  advancedMode?: boolean\n  temperature?: number\n  maxTokens?: number\n}\n\nexport interface LlmStructuredResult<T = unknown> {\n  jobId: string\n  output: T\n  usage: { inputTokens: number; outputTokens: number }\n}\n\nexport interface LlmStructuredJobInput extends LlmStructuredInput {\n  /** Display label stored on the job (≤ 120 chars) — a run list's row title. */\n  label?: string\n  /** Draft FROM this video: the platform analyzes it first (`POST\n   *  /v1/video-analysis`, a separate job you own) and appends the analysis\n   *  to `input` before the LLM call. */\n  videoUrl?: string\n  /** Analysis options, handed to the analysis route unchanged (its tiers). */\n  videoAnalysis?: { llmModel?: string; selectionMode?: \"choose\" | \"combine\" }\n  /** Draft from THIS finished `video-analysis` job of yours instead of\n   *  analyzing `videoUrl` again: no second analysis, no second analysis\n   *  charge — a retry after a failed draft, another model, different\n   *  notes. `videoUrl` may still ride beside it as the record of the source.\n   *  422 when the job is not yours, does not exist, or is not a finished,\n   *  readable video analysis (`analysis_not_found` / `not_analysis` /\n   *  `analysis_failed` / `analysis_not_ready` / `invalid_analysis` — never a\n   *  404, which means the route itself is absent). Not combinable with\n   *  `videoAnalysis`. */\n  analysisJobId?: string\n}\n\n/** `output_data` of an `llm-structured` job as it progresses: `stage` while\n *  running (`analyzing` only for movie runs), then the result. */\nexport interface LlmStructuredJobOutput<T = unknown> {\n  stage?: \"analyzing\" | \"drafting\"\n  output?: T\n  inputTokens?: number\n  outputTokens?: number\n  analysisJobId?: string\n  analysisCredits?: number\n}\n\nexport class LlmResource {\n  constructor(private client: NodaroClientCore) {}\n\n  /**\n   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call\n   * can run several minutes — longer than the client's default 60 s\n   * `timeoutMs`; construct the client with a larger `timeoutMs` for this\n   * call, or use {@link LlmResource.structuredJob}.\n   */\n  structured<T = unknown>(input: LlmStructuredInput): Promise<LlmStructuredResult<T>> {\n    return this.client.request<LlmStructuredResult<T>>(\"POST\", \"/v1/llm/structured\", { body: input })\n  }\n\n  /**\n   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`\n   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an\n   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.\n   * `jobs.list({ type: \"llm-structured\", origin })` finds every run later.\n   * Throws `NotFoundError` on a platform that predates the route. An instance\n   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`\n   * permanently — the SDK surfaces that as a generic `NodaroError` with the\n   * same code; treat it as unavailable here, not as transient.\n   */\n  structuredJob(input: LlmStructuredJobInput): Promise<{ jobId: string }> {\n    return this.client.request<{ jobId: string }>(\"POST\", \"/v1/llm/structured/jobs\", { body: input })\n  }\n}\n"]}

package/dist/chunk-E5BM4BLO.js

@@ -0,0 +1,78 @@
+// src/resources/jobs.ts
+function listParam(value) {
+  if (value === void 0) return void 0;
+  return typeof value === "string" ? value : value.join(",");
+}
+var JobsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Get a single job by ID. */
+  get(id) {
+    return this.client.request("GET", `/v1/jobs/${encodeURIComponent(id)}`);
+  }
+  /**
+   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and
+   * `origin` filter on the job's own `input_data`, which every job carries —
+   * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
+   * `status` and `type` take one value or a list; `favorited` and `rating`
+   * filter on your own marks. Every filter combines with AND, and each job
+   * carries `favorited` and `rating`.
+   */
+  list(params = {}) {
+    const { status, type, ...rest } = params;
+    return this.client.request("GET", "/v1/jobs", {
+      query: { ...rest, status: listParam(status), type: listParam(type) }
+    });
+  }
+  /**
+   * Rate one of your jobs `"good"` or `"bad"`, or clear the rating with
+   * `null` (`PUT /v1/jobs/:id/rating`). Only the job's owner rates it — anyone
+   * else's job is a `NotFoundError`. The rating reads back as `Job.rating`
+   * and filters {@link list}. OAuth apps need the `assets:write` scope.
+   */
+  rate(id, rating) {
+    return this.client.request("PUT", `/v1/jobs/${encodeURIComponent(id)}/rating`, {
+      body: { rating }
+    });
+  }
+  /**
+   * Get the lean status of a single job (poll-loop friendly).
+   * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/
+   * output_data/error_message, with far less wire/CPU cost than `get()`.
+   * Same auth + ownership semantics as {@link get}.
+   */
+  getStatus(id) {
+    return this.client.request(
+      "GET",
+      `/v1/jobs/${encodeURIComponent(id)}/status`
+    );
+  }
+  /**
+   * Cancel a job. Server route is `POST /v1/jobs/:jobId/cancel`.
+   * Refunds any reserved credit holds.
+   */
+  cancel(id) {
+    return this.client.request(
+      "POST",
+      `/v1/jobs/${encodeURIComponent(id)}/cancel`
+    );
+  }
+  /**
+   * Delete a job and the private media it produced. Server route is
+   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;
+   * a job that is still running is deleted as-is — cancel it first when its
+   * worker should stop ({@link cancel}).
+   */
+  delete(id) {
+    return this.client.request(
+      "DELETE",
+      `/v1/jobs/${encodeURIComponent(id)}`
+    );
+  }
+};
+
+export { JobsResource };
+//# sourceMappingURL=chunk-E5BM4BLO.js.map
+//# sourceMappingURL=chunk-E5BM4BLO.js.map