@nodaro/sdk 2.26.0 → 2.28.0

package/dist/index.js

@@ -1,7 +1,16 @@
-import { nodeRunRoute, NODE_TYPES_WITHOUT_RUN_ROUTE, SOCIAL_POST_NODE_PLATFORM, NODE_RUN_ROUTES, SCENE3D_V2_LIMITS, resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl, WORKSPACE_HEADER } from '@nodaro/shared';
-export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, RECAST_SEGMENT_PACKS, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER, nodeStateMayCarryOutput, unwrapEditPlanOutput } from '@nodaro/shared';
-import { buildPersonHints } from '@nodaro/prompts';
-export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts';
+export { OUTPUT_BEARING_NODE_STATUSES, nodeStateMayCarryOutput } from '@nodaro/shared/workflow';
+import { nodeRunRoute, NODE_TYPES_WITHOUT_RUN_ROUTE, NODE_RUN_ROUTES } from '@nodaro/shared/nodes';
+export { PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY } from '@nodaro/shared/nodes';
+import { SOCIAL_POST_NODE_PLATFORM } from '@nodaro/shared/social';
+import { SCENE3D_V2_LIMITS } from '@nodaro/shared/scene3d';
+import { buildPersonHints } from '@nodaro/prompts/person';
+export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts/person';
+export { CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, SURROUND_DIRECTIONS } from '@nodaro/shared/entities';
+import { resolveEditPlanSources, describeAudioSyncOffsetIssue, transcriptSpeakerLabels, remapTranscriptThroughEdl } from '@nodaro/shared/edl';
+export { unwrapEditPlanOutput } from '@nodaro/shared/edl';
+import { WORKSPACE_HEADER } from '@nodaro/shared/organizations';
+export { USAGE_GROUP_BYS, WORKSPACE_HEADER } from '@nodaro/shared/organizations';
+export { RECAST_SEGMENT_PACKS } from '@nodaro/shared/apps';
 
 // src/binary-response.ts
 async function readBinaryResponse(response, maxBytes) {
@@ -112,6 +121,19 @@ var StudioOpError = class extends NodaroError {
   }
   opIndex;
 };
+var CONTINUATION_REFUSAL_CODES = /* @__PURE__ */ new Set([
+  "already_running",
+  "continuation_superseded",
+  "render_final_already_rendered"
+]);
+var ContinuationRefusedError = class extends NodaroError {
+  constructor(message, code, jobId) {
+    super(message, code, 409);
+    this.jobId = jobId;
+    this.name = "ContinuationRefusedError";
+  }
+  jobId;
+};
 var JobBlockedError = class extends NodaroError {
   constructor(message = "Blocked by this deployment's content policy") {
     super(message, "job_blocked", 422);
@@ -184,6 +206,9 @@ function throwFromResponse(status, body) {
   if (status >= 400 && status < 500 && typeof body.error?.opIndex === "number") {
     throw new StudioOpError(message, code, status, body.error.opIndex);
   }
+  if (status === 409 && CONTINUATION_REFUSAL_CODES.has(code) && typeof body.jobId === "string") {
+    throw new ContinuationRefusedError(message, code, body.jobId);
+  }
   if (status === 422 && code === "job_blocked") throw new JobBlockedError(message);
   if (status === 403 && code === "insufficient_scope") {
     throw new ForbiddenError(message, body.error?.missingScope);
@@ -424,6 +449,65 @@ var ProjectsResource = class {
   }
 };
 
+// src/resources/sessions.ts
+var SessionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Create a session. Send its `id` as `sessionId` on a generation request
+   * (`nodes.run("generate-image", { sessionId, … })`, video, speech, music) and
+   * the job is born in it.
+   */
+  create(input) {
+    return this.client.request("POST", "/v1/sessions", { body: input });
+  }
+  /** Your sessions, newest first. */
+  list(params = {}) {
+    const query = {};
+    if (params.projectId) query.projectId = params.projectId;
+    if (params.tool) query.tool = params.tool;
+    if (params.includeArchived) query.includeArchived = "true";
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", "/v1/sessions", { query });
+  }
+  get(id) {
+    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}`);
+  }
+  /** Rename or archive a session. Its project cannot change. */
+  update(id, input) {
+    return this.client.request("PATCH", `/v1/sessions/${encodeURIComponent(id)}`, { body: input });
+  }
+  /** Delete a session and its links. Its jobs are kept, and stay in every other session holding them. */
+  delete(id) {
+    return this.client.request("DELETE", `/v1/sessions/${encodeURIComponent(id)}`);
+  }
+  /** The session's items, born-in and imported, newest first. */
+  items(id, params = {}) {
+    const query = {};
+    if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
+    return this.client.request("GET", `/v1/sessions/${encodeURIComponent(id)}/items`, { query });
+  }
+  /**
+   * Import some of your own jobs into a session — a link, not a copy (up to 100
+   * a call). All-or-nothing: if any id is not one of your jobs, nothing is
+   * imported and the call fails with 404. Items already there are left as they are.
+   */
+  importItems(id, input) {
+    return this.client.request("POST", `/v1/sessions/${encodeURIComponent(id)}/items`, { body: input });
+  }
+  /** Remove one item from a session. Only the link goes: the job, and every other session holding it, stay. */
+  removeItem(id, jobId) {
+    return this.client.request(
+      "DELETE",
+      `/v1/sessions/${encodeURIComponent(id)}/items/${encodeURIComponent(jobId)}`
+    );
+  }
+};
+
 // src/resources/jobs.ts
 var JobsResource = class {
   constructor(client) {
@@ -2536,7 +2620,10 @@ var AudioResource = class {
    * `ratio` (1–20, overrides `amount`), `attackMs` (1–2000, default 20) and
    * `releaseMs` (10–9000, default 500) are optional fine controls. A ducked mix
    * sums its tracks rather than averaging them, so the voice keeps its level;
-   * the price is the same with or without a duck.
+   * the price is the same with or without a duck. `endAt` (`"longest"`, the
+   * default, or `"voice"`) says where the mix ends: `"voice"` ends it when the
+   * voice (the `duck.under` track) ends (needs `duck`). A video URL is a track
+   * too: its audio is mixed, and a video with no sound is a silent track.
    */
   mix(input) {
     return this.client.request("POST", "/v1/mix-audio", { body: input });
@@ -2613,6 +2700,18 @@ var CreditsResource = class {
     );
     return res.data;
   }
+  /**
+   * `GET /v1/credits/transactions` → one page of the caller's credit
+   * transactions, newest first, with `nextCursor` for the next page (`null`
+   * at the end). Read `credits_charged` for what each run cost — it can be
+   * below the hold (`credits_reserved`) and is `null` while the hold is open.
+   * Cloud-only route: a self-hosted instance answers 404.
+   */
+  transactions(options = {}) {
+    return this.client.request("GET", "/v1/credits/transactions", {
+      query: { limit: options.limit, cursor: options.cursor }
+    });
+  }
   /**
    * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
    * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
@@ -3955,6 +4054,13 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
+function tightenBody(input) {
+  const { mediaUrl, ...rest } = input;
+  return { mediaUrls: [mediaUrl], ...Object.fromEntries(Object.entries(rest).filter(([, v]) => v !== void 0)) };
+}
+function idempotencyHeaders(options) {
+  return options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {};
+}
 var EditResource = class {
   constructor(client) {
     this.client = client;
@@ -4014,6 +4120,42 @@ var EditResource = class {
       }
     });
   }
+  /**
+   * Tighten Episode (`POST /v1/tighten-episode`): tighten a podcast recording
+   * in one call — transcribe, cut the silences and filler, render, with
+   * optional captions, music and framing. Answers the run's job to poll; its
+   * `output_data` holds the episode. The run is priced as its steps at their own
+   * rates plus the listed per-run fee. Quote it first with
+   * {@link estimateTightenEpisode}.
+   */
+  tightenEpisode(input, options) {
+    return this.client.request("POST", "/v1/tighten-episode", { body: tightenBody(input), ...idempotencyHeaders(options) });
+  }
+  /**
+   * What a Tighten Episode run is estimated at (`POST /v1/tighten-episode/estimate`):
+   * its steps at their own rates plus its per-run fee. Nothing is created or
+   * charged. The estimate leans high: the render is priced at the recording's
+   * full length, while the charge follows the minutes actually rendered.
+   */
+  estimateTightenEpisode(input) {
+    return this.client.request("POST", "/v1/tighten-episode/estimate", { body: tightenBody(input) });
+  }
+  /**
+   * Continue a Tighten Episode run as a new job (`POST /v1/tighten-episode/continue`):
+   * `"from-failed"` keeps the steps that finished and runs the rest (the fee is
+   * held again; the failed run's was refunded); `"render-final"` renders the
+   * full-quality episode after a review-on preview, with the preview's
+   * settings and no fee. A refusal that names another job
+   * (`already_running`, `continuation_superseded`,
+   * `render_final_already_rendered`) throws a `ContinuationRefusedError`
+   * carrying that `jobId`.
+   */
+  continueUseCase(input, options) {
+    return this.client.request("POST", "/v1/tighten-episode/continue", {
+      body: { jobId: input.jobId, mode: input.mode, ...input.editedEdl !== void 0 ? { editedEdl: input.editedEdl } : {} },
+      ...idempotencyHeaders(options)
+    });
+  }
   /**
    * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
    * transcript (plus optional silence ranges) and the media sources, and plans
@@ -4094,7 +4236,7 @@ var EditResource = class {
     return remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.26.0" ;
+var SDK_VERSION = "2.28.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -4117,6 +4259,8 @@ var NodaroClient = class _NodaroClient {
   }
   workflows;
   projects;
+  /** Generation sessions inside projects (Create Image / Video / Music). */
+  sessions;
   jobs;
   videoPro;
   executions;
@@ -4168,6 +4312,7 @@ var NodaroClient = class _NodaroClient {
     this.sendClientHeader = opts.clientLabel !== void 0 || !isBrowser();
     this.workflows = new WorkflowsResource(this);
     this.projects = new ProjectsResource(this);
+    this.sessions = new SessionsResource(this);
     this.jobs = new JobsResource(this);
     this.videoPro = new VideoProResource(this);
     this.executions = new ExecutionsResource(this);
@@ -4363,6 +4508,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CollectionsResource, CommunityResource, CompetitorsResource, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, EditResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, SavedPostsResource, Scene3DResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CollectionsResource, CommunityResource, CompetitorsResource, ContinuationRefusedError, CopilotResource, CreaturesResource, CreditsResource, DeveloperAppsResource, EditResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobBlockedError, JobFailedError, JobHeldError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, SCENE3D_DELIVERY_ASSET_USAGE, SavedPostsResource, Scene3DResource, SessionsResource, ShotsResource, StaticTokenAuth, StorageExceededError, StudioOpError, StudioPreviewAppliedError, StudioPreviewUnavailable, StudioProductionsResource, StudioResource, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map