@nodaro/sdk 2.26.0 → 2.27.0

package/dist/index.d.ts

@@ -1,8 +1,37 @@
-import * as _nodaro_shared from '@nodaro/shared';
-import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, ExecutionOutcome, NodeExecutionStateWire, Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, ModelInputAdjustment, ConnectedReference, DescribedReference, VideoCharacterReference, SocialSearchParams, VideoDepthProvider, VideoDepthModelSize, VideoDepthColormap, VideoDepthResolution, SocialPost, SocialPlatform, SocialSearchMode, Scene3DAssetRef, OAuthScope, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, AnimateSubGate, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, DialogueProvider, CaptionLookId, SupportedFontName, TranscribeLane, CaptionStyle, OverlayAnchor, VideoOverlayRequest, VideoMaskRequest, MaskCompositeRequest, TranscribeProvider, Transcript, ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostsLookupResult, UpdateSavedPostInput, ListCollectionsResult, Collection, CreateCollectionInput, UpdateCollectionInput, ListCollectionRecordsParams, ListCollectionRecordsResult, CollectionRecord, BulkCollectionRecordsInput, BulkCollectionRecordsResult, CollectionRecordSource, AddCollectionRecordInput, AddCollectionRecordResult, CollectionExportFormat, CollectionUsage, TrackedCompetitor, CompetitorListResult, CompetitorDetail, CompetitorHistory, CompetitorCompareInput, CompetitorCompareResult, CreateCompetitorInput, UpdateCompetitorInput, CompetitorCardsResult, CompetitorLessonsResult, CompetitorActionsResult, CardActionResult, CompetitorDiscovery, CharacterMotionMetadata, RecastSegmentPack, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, Edl, EditPlanMode, EditPlanTier, MeOrganizations } from '@nodaro/shared';
-export { ActionCard, ActionCardKind, ActionCardPriority, AddCollectionRecordInput, AddCollectionRecordResult, AdviceFamily, AdviceRecord, AnimateSubGate, AudioFxPreset, BrandLesson, BrandLessonKind, BrandLessons, BrandPlatformLessons, BrowseCommunityParams, BrowseCommunityResult, 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, CardAction, CardActionResult, CardOutcome, CardOutcomeState, CardSnapshot, CardVerdict, ChapterSet, CharacterAspectRatio, ChatEnabledStage, CloneListingResult, Collection, CollectionCaps, CollectionDigestFormat, CollectionExportFormat, CollectionFieldValue, CollectionLimits, CollectionMedia, CollectionMediaType, CollectionRecord, CollectionRecordSource, CollectionWriteOutcome, CommunityCard, CommunityEntityType, CommunityFullDetail, CommunityReportReason, CommunitySort, CompetitorAboutPlatform, CompetitorAccountKey, CompetitorAccounts, CompetitorActionsResult, CompetitorBrandTally, CompetitorCardsResult, CompetitorCompareInput, CompetitorCompareResult, CompetitorDetail, CompetitorDiscovery, CompetitorHistory, CompetitorHistoryPlatform, CompetitorHistoryPoint, CompetitorLessonsResult, CompetitorListResult, CompetitorPeriod, CompetitorPeriodFollowers, CompetitorPeriodPlatform, CompetitorPlatformTally, CompetitorPost, CompetitorScan, CompetitorScanCounts, CompetitorScanSummary, CompetitorSchedule, CompetitorSearch, CompetitorSearchKind, ConnectedReference, CreateCollectionInput, CreateCompetitorInput, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EditPlanMode, EditPlanTier, Edl, EdlClipSet, EntityStyle, ExecutionOutcome, FavoriteListingResult, GeminiOmniVoicePresetId, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, ListCollectionRecordsParams, ListCollectionRecordsResult, ListCollectionsResult, ListSavedPostsParams, ListSavedPostsResult, LocationAssetType, LocationAttachColumn, MarkCardInput, MeOrganizations, MemberStatus, NodeExecutionStatus, NodeSkipReason, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, OUTPUT_BEARING_NODE_STATUSES, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineInput, PipelineMode, PipelineStageName, PipelineStatus, PromptAffixFields, ProposedChange, PublishListingParams, PublishListingResult, RECAST_SEGMENT_PACKS, RecastSegmentPack, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SavePostInput, SavedPost, SavedPostSource, SavedPostsLookupResult, SharedListing, SharedVoice, SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind, SubGateName, SurroundDirection, TrackedCompetitor, TranscribeLane, TranscribeProvider, Transcript, USAGE_GROUP_BYS, UpdateCardActionInput, UpdateCollectionInput, UpdateCompetitorInput, UpdateSavedPostInput, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, VideoCharacterReference, VideoCharacterVoice, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView, nodeStateMayCarryOutput, unwrapEditPlanOutput } from '@nodaro/shared';
-import { DirectionFields, SubjectFields, PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
-export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
+import { GenericNode, GenericEdge, ConnectedReference, DescribedReference, CharacterMotionMetadata } from '@nodaro/shared/types';
+export { ConnectedReference, DescribedReference, GenericEdge, GenericNode } from '@nodaro/shared/types';
+import { WorkflowExport, WorkflowImportReport, ExecutionOutcome, NodeExecutionStateWire, ReduceStrategyId, ReduceMeta } from '@nodaro/shared/workflow';
+export { ExecutionOutcome, NodeExecutionStatus, NodeSkipReason, OUTPUT_BEARING_NODE_STATUSES, ReduceMeta, ReduceStrategyId, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, nodeStateMayCarryOutput } from '@nodaro/shared/workflow';
+import { CollaboratorRole, WorkflowVisibility, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, UsageQuery, UsageReport, UsageLogEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared/organizations';
+export { InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, MeOrganizations, MemberStatus, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, WORKSPACE_HEADER, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared/organizations';
+import * as _nodaro_shared_scene3d from '@nodaro/shared/scene3d';
+import { Scene3DReference, Scene3DPlan, Scene3DEditOperation, Scene3DV2EditOperation, Pro3DRenderSource, Pro3DRenderEngine, Pro3DRenderQuality, Pro3DRenderStyle, Scene3DJobOutputAny, Pro3DRenderJobOutput as Pro3DRenderJobOutput$1, Pro3DRenderCapabilities, Scene3DPlanV2, Pro3DRenderQuote as Pro3DRenderQuote$1, Scene3DAssetRef } from '@nodaro/shared/scene3d';
+import { SocialSearchParams, SocialPost, SocialPlatform, SocialSearchMode, ListSavedPostsParams, ListSavedPostsResult, SavePostInput, SavedPost, SavedPostsLookupResult, UpdateSavedPostInput, TrackedCompetitor, CompetitorListResult, CompetitorDetail, CompetitorHistory, CompetitorCompareInput, CompetitorCompareResult, CreateCompetitorInput, UpdateCompetitorInput, CompetitorCardsResult, CompetitorLessonsResult, CompetitorActionsResult, CardActionResult, CompetitorDiscovery } from '@nodaro/shared/social';
+export { ActionCard, ActionCardKind, ActionCardPriority, AdviceFamily, AdviceRecord, BrandLesson, BrandLessonKind, BrandLessons, BrandPlatformLessons, CardAction, CardActionResult, CardOutcome, CardOutcomeState, CardSnapshot, CardVerdict, CompetitorAboutPlatform, CompetitorAccountKey, CompetitorAccounts, CompetitorActionsResult, CompetitorBrandTally, CompetitorCardsResult, CompetitorCompareInput, CompetitorCompareResult, CompetitorDetail, CompetitorDiscovery, CompetitorHistory, CompetitorHistoryPlatform, CompetitorHistoryPoint, CompetitorLessonsResult, CompetitorListResult, CompetitorPeriod, CompetitorPeriodFollowers, CompetitorPeriodPlatform, CompetitorPlatformTally, CompetitorPost, CompetitorScan, CompetitorScanCounts, CompetitorScanSummary, CompetitorSchedule, CompetitorSearch, CompetitorSearchKind, CreateCompetitorInput, ListSavedPostsParams, ListSavedPostsResult, MarkCardInput, SavePostInput, SavedPost, SavedPostSource, SavedPostsLookupResult, SocialPlatform, SocialPost, SocialPostAuthor, SocialPostMedia, SocialPostMetrics, SocialSearchCount, SocialSearchMode, SocialSearchParams, SocialSearchPeriod, SocialSearchSort, SocialSearchVideoKind, TrackedCompetitor, UpdateCardActionInput, UpdateCompetitorInput, UpdateSavedPostInput } from '@nodaro/shared/social';
+import { VideoCharacterReference, VideoOverlayRequest } from '@nodaro/shared/video';
+export { VideoCharacterReference, VideoCharacterVoice } from '@nodaro/shared/video';
+import { ModelInputAdjustment } from '@nodaro/shared/model-catalog';
+import { VideoDepthProvider, VideoDepthModelSize, VideoDepthColormap, VideoDepthResolution, AudioFxPreset, OverlayAnchor, VideoMaskRequest, MaskCompositeRequest } from '@nodaro/shared/media';
+export { AudioFxPreset, VideoDepthColormap, VideoDepthModelSize, VideoDepthProvider, VideoDepthResolution } from '@nodaro/shared/media';
+import { DirectionFields, SubjectFields } from '@nodaro/prompts/prompt-builder';
+import { OAuthScope, RecastSegmentPack, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing } from '@nodaro/shared/apps';
+export { BrowseCommunityParams, BrowseCommunityResult, CloneListingResult, CommunityCard, CommunityEntityType, CommunityFullDetail, CommunityReportReason, CommunitySort, FavoriteListingResult, PublishListingParams, PublishListingResult, RECAST_SEGMENT_PACKS, RecastSegmentPack, ReportListingResult, SharedListing } from '@nodaro/shared/apps';
+import { PersonValue } from '@nodaro/prompts/person';
+export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, buildPersonHints } from '@nodaro/prompts/person';
+import { EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn } from '@nodaro/shared/entities';
+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, CharacterAspectRatio, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, SURROUND_DIRECTIONS, SurroundDirection } from '@nodaro/shared/entities';
+import { TtsProvider, DialogueProvider, TranscribeLane, TranscribeProvider } from '@nodaro/shared/models';
+export { GeminiOmniVoicePresetId, TranscribeLane, TranscribeProvider } from '@nodaro/shared/models';
+import { PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, AnimateSubGate, ChatEnabledStage, ProposedChange, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone } from '@nodaro/shared/pipeline';
+export { AnimateSubGate, ChatEnabledStage, PipelineInput, PipelineMode, PipelineStageName, PipelineStatus, ProposedChange, SharedVoice, SubGateName, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse } from '@nodaro/shared/pipeline';
+import { WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel } from '@nodaro/prompts/doctrine';
+export { RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection } from '@nodaro/prompts/doctrine';
+import { CaptionLookId, SupportedFontName, CaptionStyle } from '@nodaro/shared/captions';
+import { Transcript, Edl, EdlTargetAspect, EditPlanTier, EditPlanMode } from '@nodaro/shared/edl';
+export { ChapterSet, EditPlanMode, EditPlanTier, Edl, EdlClipSet, Transcript, unwrapEditPlanOutput } from '@nodaro/shared/edl';
+import { FactoryPreset } from '@nodaro/prompts/presets';
+import { ListCollectionsResult, Collection, CreateCollectionInput, UpdateCollectionInput, ListCollectionRecordsParams, ListCollectionRecordsResult, CollectionRecord, BulkCollectionRecordsInput, BulkCollectionRecordsResult, CollectionRecordSource, AddCollectionRecordInput, AddCollectionRecordResult, CollectionExportFormat, CollectionUsage } from '@nodaro/shared/nodes';
+export { AddCollectionRecordInput, AddCollectionRecordResult, Collection, CollectionCaps, CollectionDigestFormat, CollectionExportFormat, CollectionFieldValue, CollectionLimits, CollectionMedia, CollectionMediaType, CollectionRecord, CollectionRecordSource, CollectionWriteOutcome, CreateCollectionInput, ListCollectionRecordsParams, ListCollectionRecordsResult, ListCollectionsResult, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PromptAffixFields, UpdateCollectionInput } from '@nodaro/shared/nodes';
 
 /**
  * Auth provides the token used for `Authorization: Bearer <token>` on each request.
@@ -111,7 +140,13 @@ interface RunWorkflowParams {
      * not used). A run through the API has nobody to review a Preview render, so
      * a workflow whose Apply EDL render is set to Preview is refused
      * (`preview_review_required`) unless the run sets it to Final:
-     * `{ [renderNodeId]: { quality: "final" } }`.
+     * `{ [renderNodeId]: { quality: "final" } }`. A Tighten Episode node with
+     * Review before render on is refused the same way (turn its review off). A
+     * failed execution records what held it — `preview_review_required` /
+     * `preview_render_nested` (a render), `…_review_on` (a review-on node) or
+     * `…_mixed` (both); match all six with `isPreviewRefusalCode` from
+     * `@nodaro/shared`. A review-on Tighten Episode fed by a List is refused
+     * with `use_case_review_list_driven`.
      */
     inputOverrides?: Record<string, Record<string, unknown>>;
     /**
@@ -486,7 +521,17 @@ interface Job {
      *  `usage_logs.status`. `null` when there is no usage log to report. Never
      *  changes the meaning of `credits` (the reserved amount) below. */
     credit_status?: CreditStatus | null;
+    /** The credits HELD when the job was accepted. Never changes — a job can
+     *  settle below it; read {@link Job.credits_charged} for what it cost. */
     credits: number | null;
+    /**
+     * What the job actually cost once its hold settled. Can be lower than
+     * `credits` (the unused part goes back to the balance), `0` when the hold was
+     * refunded, `null` while the job is still running or when it reserved
+     * nothing of its own. Sum this — not `credits` — to total spend. Returned by
+     * `get()` and `list()`.
+     */
+    credits_charged?: number | null;
     job_type: string | null;
     created_at: string;
     started_at: string | null;
@@ -853,7 +898,7 @@ interface Scene3DEngineParams {
 /** Structured authoring inputs; reference roles are interpreted by the platform. */
 interface GenerateScene3DParams extends Record<string, unknown>, Scene3DEngineParams {
     /** Existing GLBs selected by immutable revision/artifact IDs. Requires an import-capable advanced engine. */
-    inputAssets?: readonly _nodaro_shared.Scene3DInputAsset[];
+    inputAssets?: readonly _nodaro_shared_scene3d.Scene3DInputAsset[];
     prompt: string;
     durationSeconds?: number;
     fps?: number;
@@ -5753,7 +5798,10 @@ declare class AudioResource {
      * `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: {
         audioUrls: string[];
@@ -5766,6 +5814,7 @@ declare class AudioResource {
             attackMs?: number;
             releaseMs?: number;
         };
+        endAt?: "longest" | "voice";
     }): Promise<{
         jobId: string;
     }>;
@@ -5909,6 +5958,49 @@ interface SignupGrantClaimResult {
     /** True only when THIS call moved the credits — a repeat is `false` with the same state. */
     granted: boolean;
 }
+/**
+ * One row of `GET /v1/credits/transactions` — a run's reservation and how it
+ * settled.
+ *
+ * Which amount to read: a run first HOLDS credits and is then settled — charged
+ * all or part of the hold, the rest returned. `credits_charged` is what the run
+ * cost (`null` while the hold is still open, `0` once refunded); sum it for
+ * spend. `credits_reserved` is the hold, which never changes. `credits_used`
+ * is the same hold under its original name, kept for existing integrations.
+ */
+interface CreditTransaction {
+    id: string;
+    /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */
+    created_at: string;
+    /** Settled charge; `null` while `status` is `"reserved"`, `0` when refunded. */
+    credits_charged: number | null;
+    /** The hold taken when the run was accepted. */
+    credits_reserved: number | null;
+    /** The hold, under its original name. Prefer `credits_charged`. */
+    credits_used: number | null;
+    /** The model or operation the credits were for. */
+    action: string | null;
+    provider: string | null;
+    /** Reservation lifecycle: `"reserved"`, `"committed"` or `"refunded"`. */
+    status: string | null;
+    /** The caller's own billing details for the run (model, which pool paid, …). */
+    metadata: Record<string, unknown>;
+    /** `"workspace"` when a class or team budget paid, not your balance. */
+    payer: "user" | "workspace";
+    workspaceId: string | null;
+}
+/** A page of {@link CreditTransaction}s, newest first. */
+interface CreditTransactionsPage {
+    data: CreditTransaction[];
+    /** Pass as `cursor` for the next page; `null` when there are no more rows. */
+    nextCursor: string | null;
+}
+interface CreditTransactionsOptions {
+    /** Rows per page, 1–50 (server default 20). */
+    limit?: number;
+    /** The `nextCursor` of the previous page. */
+    cursor?: string;
+}
 declare class CreditsResource {
     private client;
     constructor(client: NodaroClient);
@@ -5918,6 +6010,14 @@ declare class CreditsResource {
      * other typed errors on the usual statuses.
      */
     balance(): Promise<UserBalance>;
+    /**
+     * `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?: CreditTransactionsOptions): Promise<CreditTransactionsPage>;
     /**
      * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
      * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
@@ -8791,6 +8891,90 @@ interface CameraSwitchInput {
     /** Optionally associate this run with a workflow execution (display only). */
     workflowId?: string;
 }
+/**
+ * Input for {@link EditResource.tightenEpisode} and
+ * {@link EditResource.estimateTightenEpisode}: one recording in, the tightened
+ * episode out. Only `mediaUrl` is required; every other field left out takes
+ * the node's default.
+ */
+interface TightenEpisodeInput {
+    /** The recording — a video or audio URL, up to 3 hours. */
+    mediaUrl: string;
+    /** Optional music bed, ducked under the voice and ending with the episode. */
+    musicUrl?: string;
+    /** `"video"` or `"audio"`; an audio recording always makes an audio episode. */
+    output?: "video" | "audio";
+    /**
+     * Frame a video episode with Speaker View: an output aspect and a layout,
+     * over automatic boxes on the speakers on screen. A layout the aspect does
+     * not draw is snapped to one it does. `null` or absent: no framing.
+     */
+    framing?: {
+        aspect: EdlTargetAspect;
+        layout: "auto" | "single" | "side-by-side" | "stacked" | "grid" | "pip";
+    } | null;
+    /** Captions on a video episode (on by default). */
+    captions?: boolean;
+    /** The captions' look. */
+    captionStyle?: CaptionStyle;
+    /**
+     * Stop at a quick preview for a person to review; render the full-quality
+     * episode afterwards with {@link EditResource.continueUseCase}
+     * (`mode: "render-final"`).
+     */
+    reviewBeforeRender?: boolean;
+    /** The planner's tier. */
+    planTier?: EditPlanTier;
+    /** Editing instructions for the planner (up to 4 000 characters). */
+    instructions?: string;
+    /** A style guide for the planner (up to 4 000 characters). */
+    styleGuide?: string;
+    /** How far the music dips under the voice, 0–100 (default 75). */
+    musicDuckAmount?: number;
+}
+/** What `tightenEpisode` and `continueUseCase` answer: the run's job to poll. */
+interface TightenEpisodeJobResult extends EditJobResult {
+    /** The run's execution (absent on a deduplicated retry). */
+    executionId?: string;
+    /** `true` when an `Idempotency-Key` retry found the run already started: `jobId` is that run. */
+    deduped?: boolean;
+}
+/**
+ * What a Tighten Episode run is estimated at (`data`). Every credit amount is 0
+ * on an edition without credits; `durationSec` is `null` when the recording's
+ * length could not be read.
+ */
+interface TightenEpisodeEstimate {
+    /** The whole run: its steps plus the fee. */
+    totalCredits: number;
+    /** The steps at their own rates. */
+    stepsCredits: number;
+    /** The per-run fee. */
+    feeCredits: number;
+    /** The recording's length, in seconds. */
+    durationSec: number | null;
+}
+/** Input for {@link EditResource.continueUseCase}. */
+interface UseCaseContinueInput {
+    /** The run to continue: the job `tightenEpisode` (or an earlier continuation) answered. */
+    jobId: string;
+    /**
+     * `"from-failed"` re-runs what did not finish of a failed run;
+     * `"render-final"` renders the full-quality episode after a review-on preview.
+     */
+    mode: "from-failed" | "render-final";
+    /** Render final only: the reviewer's edit of the plan (an EDL). */
+    editedEdl?: unknown;
+}
+/** Per-call options for the Tighten Episode requests. */
+interface UseCaseRequestOptions {
+    /**
+     * Sent as the `Idempotency-Key` header. Reuse the same value when retrying
+     * the same request and the server answers the run it already started
+     * (`deduped: true`) instead of starting a second one.
+     */
+    idempotencyKey?: string;
+}
 /**
  * Editorial primitives for podcast / long-form video editing, single-camera
  * and multicam: measure the cameras' offsets ({@link audioSync}), plan the cut
@@ -8803,11 +8987,17 @@ interface CameraSwitchInput {
  * - {@link editPlan} and {@link cameraSwitch} run on nodaro.ai; a self-hosted
  *   install relays them once it is connected (a 503
  *   `code: "nodaro_connection_required"` otherwise).
+ * - {@link tightenEpisode} runs the whole chain (transcribe, plan, render, and
+ *   optionally captions, music and framing) in one call. It is core, but a
+ *   self-hosted install needs a nodaro.ai connection for the steps that run
+ *   there (a 503 `code: "nodaro_connection_required"` otherwise).
+ *   {@link continueUseCase} continues one of its runs.
  * - {@link remapTranscript} is a PURE local transform (no request) — the same
  *   remap `applyEdl` performs on its `transcript`, exposed for callers that hold
  *   an EDL and a transcript and only want the re-timed transcript.
  *
- * Every request method returns {@link EditJobResult}; poll the `jobId` with
+ * Every request method except {@link estimateTightenEpisode} (a quote,
+ * `{ data }`) returns {@link EditJobResult}; poll the `jobId` with
  * `client.jobs.getStatus(jobId)`.
  */
 declare class EditResource {
@@ -8835,6 +9025,35 @@ declare class EditResource {
      * "invalid_edl"`) before any credits are reserved.
      */
     applyEdl(input: ApplyEdlInput): Promise<EditJobResult>;
+    /**
+     * 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: TightenEpisodeInput, options?: UseCaseRequestOptions): Promise<TightenEpisodeJobResult>;
+    /**
+     * 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: TightenEpisodeInput): Promise<{
+        data: TightenEpisodeEstimate;
+    }>;
+    /**
+     * 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: UseCaseContinueInput, options?: UseCaseRequestOptions): Promise<TightenEpisodeJobResult>;
     /**
      * Plan a transcript-driven cut (`POST /v1/edit-plan`). Reads a timed
      * transcript (plus optional silence ranges) and the media sources, and plans
@@ -9108,6 +9327,24 @@ declare class StudioOpError extends NodaroError {
     /** Zero-based index into the `ops` array that was sent. */
     opIndex: number);
 }
+/**
+ * A 409 that names the job to turn to instead: continuing a use-case run
+ * (`client.edit.continueUseCase`) answers `already_running` (a continuation is
+ * under way, or one that already completed — follow `jobId`),
+ * `continuation_superseded` (a later continuation failed too — continue
+ * `jobId` instead) or `render_final_already_rendered` (a Render final with this
+ * very edit already completed — `jobId` holds the result). `code` and `status`
+ * are what the server sent. Selected for exactly those three codes when the
+ * answer carries a top-level `jobId`; every other 409 stays a plain
+ * `NodaroError`.
+ */
+declare class ContinuationRefusedError extends NodaroError {
+    /** The job the refusal names. */
+    readonly jobId: string;
+    constructor(message: string, code: string, 
+    /** The job the refusal names. */
+    jobId: string);
+}
 /**
  * HTTP 422 `job_blocked`. A job policy registered by this deployment refused
  * the generation **before it ran** — no job was created, nothing was reserved
@@ -9263,7 +9500,9 @@ interface ApiErrorBody {
     };
     /** The server framework's own top-level message, e.g. for a route it does not have. */
     message?: unknown;
+    /** A refusal that names another job (see {@link ContinuationRefusedError}). */
+    jobId?: unknown;
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AddCaptionsInput, type AddCollaboratorInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, type AssembleNarratedVideoParams, AudioResource, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CameraSwitchInput, type CancelExecutionParams, type CancelJobResult, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type CatalogsListResponse, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, type Collaborator, CollectionsResource, CommunityResource, CompetitorsResource, type ContinueVideoProResult, type CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, type CreatureVoice, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppKind, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DroppedCollaborator, type DubbingInput, type DuplicateCharacterInput, type EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationMotionInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetCharacterOptions, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelFamilyGroup, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type OverlayPlacement, type PendingApproval, type PickerCatalog, type PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, type PipelineRecord, type PipelineTimeline, PipelinesResource, type PolicyBlockHint, PresetsResource, type Pro3DRenderJobOutput, type Pro3DRenderParams, type Pro3DRenderQuote, type Pro3DRenderRunOptions, type Pro3DRenderRunParams, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type ProjectedCatalogSection, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferenceCaptionParams, type ReferencePhoto, type ReferencePhotoKind, type RenderFinalParams, type RenderFinalQuote, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeOptions, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, SCENE3D_DELIVERY_ASSET_USAGE, type SafetyBlockHint, SavedPostsResource, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DDeliveryAssetKind, type Scene3DJobOutput, Scene3DResource, type SharedWorkflow, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, type SignupGrantClaimResult, type SignupKeys, type SilenceDetectInput, type SilenceRanges, type SocialSearchJobOutput, type SplitMediaInput, type SplitMediaOutput, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToPickerParams, type TextToPickerResult, type TextToSpeechParams, type TextToVideoParams, type TranscribeJobOutput, type TranscribeWord, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoDepthParams, type VideoMetadata, VideoProResource, type VideoUpscaleParams, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AddCaptionsInput, type AddCollaboratorInput, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApplyEdlInput, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, type AssembleNarratedVideoParams, AudioResource, type AudioSyncInput, type AudioSyncOffset, type AudioSyncResult, type AudioSyncSource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CameraSwitchInput, type CancelExecutionParams, type CancelJobResult, type CaptionEntry, type CaptionLookInput, type CaptionSegmentInput, type CatalogsListResponse, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, type Collaborator, CollectionsResource, CommunityResource, CompetitorsResource, ContinuationRefusedError, type ContinueVideoProResult, type CopilotMemorySavedFrameData, type CopilotMessage, type CopilotMessagePart, type CopilotMetadataFrameData, type CopilotModelTier, CopilotResource, type CopilotRunMode, type CopilotRunProposalFrameData, type CopilotRunProposalNode, type CopilotStreamFrame, type CopilotStreamOptions, type CopilotSurface, type CopilotThread, type CopilotThreadWorkflow, type CopilotToolCallFrameData, type CopilotWiredAsset, type CopilotWorkflowCreatedFrameData, type CopilotWorkflowUpdateFrameData, type CreateCopilotThreadInput, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, type CreatureVoice, CreaturesResource, type CreditStatus, type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppKind, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DroppedCollaborator, type DubbingInput, type DuplicateCharacterInput, type EditJobResult, type EditPlanInput, type EditPlanSource, EditResource, type EditScene3DParams, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationMotionInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateScene3DParams, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetCharacterOptions, type GetPickerCatalogOptions, type GetProductionOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobBlockedError, type JobErrorHint, JobFailedError, JobHeldError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListStudioProductionsOptions, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelFamilyGroup, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type OverlayPlacement, type PendingApproval, type PickerCatalog, type PickerCatalogSection, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, type PipelineRecord, type PipelineTimeline, PipelinesResource, type PolicyBlockHint, PresetsResource, type Pro3DRenderJobOutput, type Pro3DRenderParams, type Pro3DRenderQuote, type Pro3DRenderRunOptions, type Pro3DRenderRunParams, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, type ProjectedCatalogSection, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferenceCaptionParams, type ReferencePhoto, type ReferencePhotoKind, type RenderFinalParams, type RenderFinalQuote, type RenderScene3DParams, type ResolveRecastGateInput, type RetainedScene3DEditParams, type RetainedScene3DEditResult, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeOptions, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, SCENE3D_DELIVERY_ASSET_USAGE, type SafetyBlockHint, SavedPostsResource, type Scene3DAuthoringEngine, type Scene3DCapabilities, type Scene3DDelivery, type Scene3DDeliveryAsset, type Scene3DDeliveryAssetKind, type Scene3DJobOutput, Scene3DResource, type SharedWorkflow, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, type SignupGrantClaimResult, type SignupKeys, type SilenceDetectInput, type SilenceRanges, type SocialSearchJobOutput, type SplitMediaInput, type SplitMediaOutput, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type StudioClientRequestId, type StudioCloneRequest, type StudioCreateProductionRequest, type StudioDescribeRequest, type StudioDocumentJson, type StudioEditInput, type StudioExportPlanOptions, type StudioExportPlanResponse, type StudioExportStep, type StudioFrameRequest, type StudioGenerateEstimate, type StudioGenerateOptions, type StudioGenerateRequest, type StudioGenerateResponse, type StudioGenerateResult, type StudioGenerationReply, type StudioImportSummary, type StudioJobStartedResponse, type StudioKeyframeAcceptanceInput, type StudioKeyframeGenerationInput, type StudioKeyframeRecord, type StudioListProductionsResponse, type StudioMediaResponse, type StudioMusicRequest, type StudioOpClass, StudioOpError, type StudioOpsDryRunReceipt, type StudioOpsDryRunResponse, type StudioOpsImpact, type StudioOpsReceipt, type StudioOpsRequest, type StudioOpsResponse, type StudioPlanIssue, StudioPreviewAppliedError, StudioPreviewUnavailable, type StudioProduction, type StudioProductionCapabilities, type StudioProductionDetail, type StudioProductionRecord, type StudioProductionReply, type StudioProductionResponse, StudioProductionsResource, type StudioReconcileResponse, StudioResource, type StudioRevoiceRequest, type StudioShotGenerationInput, type StudioSkillResponse, type StudioValidatePlanResponse, type StudioVideoLane, type StudioVoiceRequest, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToPickerParams, type TextToPickerResult, type TextToSpeechParams, type TextToVideoParams, type TightenEpisodeEstimate, type TightenEpisodeInput, type TightenEpisodeJobResult, type TranscribeJobOutput, type TranscribeWord, type TutorialCategory, type TutorialFlowItem, type TutorialVideoItem, TutorialsResource, UnauthorizedError, type UpdateCreatureInput, type UpdateCreatureResult, type UpdateDeveloperAppInput, type UpdateLocationInput, type UpdateLocationResult, type UpdateObjectInput, type UpdateObjectResult, type UpdateProjectInput, type UpdateShotInput, type UpdateWorkflowInput, type UploadResult, UploadsResource, type UpsertCharacterInput, type UpsertCharacterResult, type UpsertCreatureInput, type UpsertCreatureResult, type UpsertObjectInput, type UpsertObjectResult, type UseCaseContinueInput, type UseCaseRequestOptions, type UserBalance, type UserIdentity, type VcpAnalysis, type VcpAnalysisSpeaker, type VcpAnalyzeInput, type VcpExportInput, type VcpExportTrack, type VideoDepthParams, type VideoMetadata, VideoProResource, type VideoUpscaleParams, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, type WorkflowConflictCode, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, isStudioGenerateEstimate, supabaseAuth, throwFromResponse };

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);
@@ -2536,7 +2561,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 +2641,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 +3995,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 +4061,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 +4177,7 @@ var EditResource = class {
     return remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.26.0" ;
+var SDK_VERSION = "2.27.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -4363,6 +4446,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, 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