@nodaro/sdk 1.27.0 → 1.29.0

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, ConnectedReference, ModelInputAdjustment, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, 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, MeOrganizations } from '@nodaro/shared';
-export { AudioFxPreset, 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, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } from '@nodaro/shared';
-import { PersonValue, WizardNodeContext, WizardQuestion, WizardSelection, RecommendedModel, FactoryPreset } from '@nodaro/prompts';
+import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, ConnectedReference, DescribedReference, ModelInputAdjustment, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, 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, MeOrganizations } from '@nodaro/shared';
+export { AudioFxPreset, 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, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, DescribedReference, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WORKSPACE_HEADER, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject, WorkspaceMemberView, WorkspaceRole, WorkspaceSettings, WorkspaceSummary, WorkspaceView } 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';
 
 /**
@@ -316,11 +316,23 @@ declare class ProjectsResource {
     }>;
 }
 
-type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" | "cancelled";
 /**
- * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable
- * failure verdict the worker writes on a FINAL provider content-policy
- * block, so a caller can act on it without parsing `error_message` prose.
+ * A job's lifecycle status. Hand-copied mirror of `JOB_STATUSES` in the
+ * platform's `backend/src/lib/job-status.ts` — nothing links the two at build
+ * time, so a new member has to be added here in the same change.
+ *
+ * `pending_review` is IN-FLIGHT, NOT TERMINAL: a job policy registered by the
+ * deployment held the output for a human reviewer. Treat it like `processing`
+ * in a `switch` — keep waiting, do not re-run — and it resolves to `completed`
+ * (approved), `failed` (rejected, carrying an `error_hint` with
+ * `kind: "policy-block"`) or `cancelled` (a held job is cancellable like any
+ * in-flight job). `credit_status` reads `"reserved"` for the whole hold. Only
+ * appears on deployments that register a job policy; `runAndWait` throws
+ * {@link JobHeldError} on the first held tick rather than waiting it out.
+ */
+type JobStatus = "pending" | "queued" | "processing" | "pending_review" | "completed" | "failed" | "cancelled";
+/**
+ * A PROVIDER's verdict: the model's own safety filter refused the output.
  * `class` distinguishes a deterministic block (copyright/likeness — retrying
  * the same request never helps) from `safety`, whose filter is known to be
  * non-deterministic for some models: `retried` says whether the worker
@@ -328,12 +340,42 @@ type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" |
  * only when the catalog declares a fallback for the model that failed — is a
  * real model id the SAME prompt/references can be retried on.
  */
-interface JobErrorHint {
+type SafetyBlockHint = {
     kind: "safety-block";
     class: "copyright" | "likeness" | "safety";
     retried: boolean;
     suggestedProvider?: string;
-}
+};
+/**
+ * A NODARO-side verdict, not a provider's: a job policy registered by the
+ * deployment rejected the request (`hookPoint: "request"` — nothing ran, and
+ * the call itself failed with {@link JobBlockedError}) or the finished output
+ * (`hookPoint: "result"` — the result was blocked and never published).
+ *
+ * `reason` is USER-SAFE BY CONTRACT — the platform guarantees the policy's
+ * machine text (scores, labels) never reaches it — so show it to the person
+ * who made the request as-is. `policyId` identifies the deployment's policy,
+ * not a Nodaro product feature. Only occurs on deployments that register a
+ * job policy.
+ */
+type PolicyBlockHint = {
+    kind: "policy-block";
+    policyId: string;
+    reason: string;
+    hookPoint: "request" | "result";
+};
+/**
+ * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable
+ * failure verdict, so a caller can act on it without parsing `error_message`
+ * prose. One column, two verdict sources; `kind` is the discriminant.
+ *
+ * HAND-COPIED MIRROR of `ErrorHint` in the platform's
+ * `backend/src/lib/safety-block.ts` (which names this file in its own
+ * comment). Nothing links the two at build time: a new arm there has to be
+ * pasted here verbatim in the same change, with a changeset.
+ * `packages/client/dist/index.d.ts` is REBUILT, never hand-edited.
+ */
+type JobErrorHint = SafetyBlockHint | PolicyBlockHint;
 /**
  * The billing lifecycle of a job's credit reservation — `usage_logs.status`
  * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a
@@ -358,8 +400,10 @@ interface Job {
     input_data: unknown;
     output_data: unknown;
     error_message: string | null;
-    /** PR9: present on a failed job the worker classified as a content-policy
-     *  block; absent/null otherwise. User-safe by construction. */
+    /** Present on a failed job the worker classified as a provider
+     *  content-policy block (`kind: "safety-block"`) or that a deployment's job
+     *  policy rejected (`kind: "policy-block"`); absent/null otherwise.
+     *  User-safe by construction — narrow on `kind` before reading the rest. */
     error_hint?: JobErrorHint | null;
     /** PR9: the job's credit reservation lifecycle, derived server-side from
      *  `usage_logs.status`. `null` when there is no usage log to report. Never
@@ -384,6 +428,9 @@ interface CancelJobResult {
     success: true;
     cancelled: number;
 }
+interface DeleteJobResult {
+    success: true;
+}
 interface ListJobsParams {
     /** Exact match on `input_data.type` — the route that created the job
      *  (`"llm-structured"`, `"video-analysis"`, …). */
@@ -396,6 +443,10 @@ interface ListJobsParams {
     cursor?: string;
 }
 interface ListJobsPage {
+    /**
+     * A page may hold fewer than `limit` rows — even none — and still carry a
+     * `next`. Page on `next`, never on `data.length`.
+     */
     data: Job[];
     /** Pass back as `cursor` for the next page; `null` on the last one. */
     next: string | null;
@@ -444,6 +495,13 @@ declare class JobsResource {
      * Refunds any reserved credit holds.
      */
     cancel(id: string): Promise<CancelJobResult>;
+    /**
+     * 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: string): Promise<DeleteJobResult>;
 }
 
 /**
@@ -676,9 +734,29 @@ type RunNodeResult = {
 interface StructuredReferenceParams {
     /** Wired references assembled server-side (deduped + capped per provider). */
     connectedReferences?: ConnectedReference[];
+    /**
+     * References you can NAME and DESCRIBE but have no media for — a cast role no
+     * entity is bound to yet, a character that exists only in the script. They
+     * carry no url, so nothing is attached and no `@image_N` seat is used: each
+     * becomes a `<Name> — <description>.` line, and a name left in the prompt
+     * prose reaches the model as a real, described subject. Up to 10.
+     */
+    describedReferences?: DescribedReference[];
     /** Reorder the assembled reference list by stable ref ids; renumbers `@image_N`. */
     referenceOrder?: string[];
 }
+/**
+ * Captions for a node's video / audio rail references — INDEX-ALIGNED with
+ * `referenceVideoUrls` / `referenceAudioUrls`, so `referenceVideoCaptions[0]`
+ * describes `referenceVideoUrls[0]`. Each renders as `@video_N: <caption>.` /
+ * `@audio_N: <caption>.` in the assembled prompt and is bounded by the number of
+ * rail references that actually ship, so a caption can never bind a slot the
+ * payload dropped. A blank entry is a hole in the alignment, not a line.
+ */
+interface ReferenceCaptionParams {
+    referenceVideoCaptions?: string[];
+    referenceAudioCaptions?: string[];
+}
 /**
  * Typed request body for `nodes.run("generate-image", …)` / `runAndWait`.
  * Common fields are typed; any other route field passes through via the index
@@ -696,7 +774,7 @@ interface GenerateImageParams extends StructuredReferenceParams {
  * Typed request body for `nodes.run("generate-video", …)` / `runAndWait`.
  * Common fields are typed; any other route field passes through.
  */
-interface GenerateVideoParams extends StructuredReferenceParams {
+interface GenerateVideoParams extends StructuredReferenceParams, ReferenceCaptionParams {
     prompt?: string;
     provider?: string;
     /** Start-frame image (image-to-video). */
@@ -706,6 +784,37 @@ interface GenerateVideoParams extends StructuredReferenceParams {
     referenceAudioUrls?: string[];
     [k: string]: unknown;
 }
+/**
+ * Typed request body for `nodes.run("text-to-video", …)` / `runAndWait` — the
+ * PROMPT-ONLY video lane (`POST /v1/text-to-video`).
+ *
+ * Which lane takes what: `text-to-video` renders from text (plus optional
+ * references) and `prompt` is REQUIRED; frames belong to `generate-video`
+ * alone, which is the image-to-video lane (`imageUrl` start frame, `endFrameUrl`
+ * closing frame) and where a prompt is optional. A model with no text-to-video
+ * mode answers this lane with a `400 image_required` naming itself.
+ *
+ * Common fields are typed; any other route field passes through.
+ */
+interface TextToVideoParams extends StructuredReferenceParams, ReferenceCaptionParams {
+    prompt: string;
+    provider?: string;
+    duration?: number;
+    /** Native audio toggle, on the models that render sound. */
+    sound?: boolean;
+    negativePrompt?: string;
+    aspectRatio?: string;
+    resolution?: string;
+    seed?: number;
+    referenceImageUrls?: string[];
+    referenceVideoUrls?: string[];
+    referenceAudioUrls?: string[];
+    /** Cinematic direction as catalog IDS — the route renders the wording. */
+    direction?: DirectionFields;
+    /** SUBJECT ids (who is in the shot), folded ahead of the direction clauses. */
+    subject?: SubjectFields;
+    [k: string]: unknown;
+}
 /**
  * Typed request body for `nodes.run("assemble-narrated-video", …)` / `runAndWait`.
  * Assembles blocks of video with audio narration into a single composed video.
@@ -803,6 +912,7 @@ declare class NodesResource {
      */
     run(type: "generate-image", params?: GenerateImageParams): Promise<RunNodeResult>;
     run(type: "generate-video", params?: GenerateVideoParams): Promise<RunNodeResult>;
+    run(type: "text-to-video", params: TextToVideoParams): Promise<RunNodeResult>;
     run(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams): Promise<RunNodeResult>;
     run(type: string, params?: Record<string, unknown>): Promise<RunNodeResult>;
     /**
@@ -819,6 +929,11 @@ declare class NodesResource {
      * - {@link JobTimeoutError} — `maxMs` deadline exceeded before terminal.
      * - {@link JobAbortedError} — `signal` fired (or was already aborted);
      *   polling stops immediately.
+     * - {@link JobHeldError} — the job entered `pending_review` on a deployment
+     *   that registers a job policy. Ends the poll on the FIRST held tick (that
+     *   status waits on a human, not on the job) and does NOT cancel it.
+     * - {@link JobBlockedError} — a 422 from {@link run} before any poll: the
+     *   deployment's job policy refused the request outright.
      *
      * Polling is fully client-side (no server function blocks) — the same model
      * thin clients use, lifted out of their hand-rolled run→poll loops.
@@ -829,6 +944,7 @@ declare class NodesResource {
      */
     runAndWait(type: "generate-image", params?: GenerateImageParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "generate-video", params?: GenerateVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
+    runAndWait(type: "text-to-video", params: TextToVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: "assemble-narrated-video", params?: AssembleNarratedVideoParams, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     runAndWait(type: string, params?: Record<string, unknown>, opts?: RunAndWaitOptions): Promise<NodeJobOutput>;
     /**
@@ -836,15 +952,19 @@ declare class NodesResource {
      * the candidate-grid path (generate N stills/clips in parallel). Each runs
      * via {@link runAndWait}; resolves once ALL settle, to an array of
      * `{ jobId, output }` in input order. Rejects (and the rejection wins) if any
-     * single run rejects — same typed errors as {@link runAndWait}. A shared
-     * `signal` aborts the whole batch.
+     * single run rejects — same typed errors as {@link runAndWait}, including
+     * {@link JobHeldError} when one candidate is held for review while the
+     * others complete. A shared `signal` aborts the whole batch.
      *
      * @param type        Node type slug, applied to every entry.
      * @param paramsList  One request body per candidate.
      * @param opts        Shared `signal` / `onProgress` / `pollMs` / `maxMs`.
      */
     runMany(type: string, paramsList: Record<string, unknown>[], opts?: RunAndWaitOptions): Promise<RunManyResult[]>;
-    /** Poll an already-kicked job id until terminal; resolve output_data or throw. */
+    /** Poll an already-kicked job id until it stops moving; resolve output_data
+     *  or throw. Two non-terminal statuses end the loop: an abort, and
+     *  `pending_review` (a job policy held the output for a human — see
+     *  {@link JobHeldError}). */
     private pollJob;
 }
 
@@ -6024,6 +6144,20 @@ declare class WorkflowConflictError extends NodaroError {
     readonly currentRecord?: Record<string, unknown> | undefined;
     constructor(message?: string, currentUpdatedAt?: string | undefined, currentVersion?: number | undefined, currentRecord?: Record<string, unknown> | undefined);
 }
+/**
+ * HTTP 422 `job_blocked`. A job policy registered by this deployment refused
+ * the generation **before it ran** — no job was created, nothing was reserved
+ * and nothing was charged. `message` is the policy's user-safe text: show it
+ * as-is. Do not retry the identical request; whether the same input would be
+ * judged differently is the deployment's policy's business.
+ *
+ * Only occurs on deployments that register a job policy. Selected by `code`,
+ * not by status, the same way `workflow_conflict` narrows a 409 above — any
+ * other 422 stays a plain `NodaroError`.
+ */
+declare class JobBlockedError extends NodaroError {
+    constructor(message?: string);
+}
 /**
  * A job reached a terminal `failed`/`cancelled` status while being awaited by
  * `nodes.runAndWait` / `nodes.runMany`. Not an HTTP-level error (the polls
@@ -6059,6 +6193,26 @@ declare class JobAbortedError extends NodaroError {
     readonly jobId?: string | undefined;
     constructor(message?: string, jobId?: string | undefined);
 }
+/**
+ * The awaited job entered `pending_review`: a job policy registered by this
+ * deployment held its output for a human reviewer. `pending_review` is
+ * IN-FLIGHT, not terminal, so `nodes.runAndWait` / `nodes.runMany` end the
+ * poll on the first tick they observe it rather than burning `maxMs` on a
+ * status that no longer moves on its own.
+ *
+ * This does NOT cancel the job — the output exists, a human is reviewing it,
+ * and the credit reservation stays `reserved` for the whole hold. Do not
+ * re-run the request (a duplicate would be held too): re-fetch with
+ * `jobs.get(jobId)` later, or surface "awaiting review" to your user and poll
+ * `jobs.getStatus()` yourself. It resolves to `completed` (approved), `failed`
+ * (rejected, with `error_hint.kind === "policy-block"`) or `cancelled`.
+ *
+ * Not an HTTP error — `status` is 0; catch by type/`code`.
+ */
+declare class JobHeldError extends NodaroError {
+    readonly jobId: string;
+    constructor(message: string, jobId: string);
+}
 interface ApiErrorBody {
     error?: {
         code?: string;
@@ -6072,4 +6226,4 @@ interface ApiErrorBody {
 }
 declare function throwFromResponse(status: number, body: ApiErrorBody): never;
 
-export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, 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, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, 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 GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobFailedError, 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 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 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 PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, 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 ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, 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 VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, 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, CreaturesResource, type CreditStatus, CreditsResource, type DeleteAppRunResult, type DeleteJobResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, 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 GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, 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 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 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 PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, type PolicyBlockHint, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, 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 ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, type SafetyBlockHint, type Shot, type ShotEntityRef, type ShotMode, ShotsResource, StaticTokenAuth, type StopVideoProResult, StorageExceededError, type StructuredReferenceParams, type Template, type TemplateBrowseCard, type TemplateSort, TemplatesResource, type TextToVideoParams, 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 VideoMetadata, VideoProResource, type VoiceChangerProInput, type VoiceChangerProVoice, type VoiceDesignInput, type VoiceRemixInput, VoicesResource, type Workflow, WorkflowConflictError, type WorkflowExecution, type WorkflowExecutionSummary, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };

package/dist/index.js

@@ -70,6 +70,12 @@ var WorkflowConflictError = class extends NodaroError {
   currentVersion;
   currentRecord;
 };
+var JobBlockedError = class extends NodaroError {
+  constructor(message = "Blocked by this deployment's content policy") {
+    super(message, "job_blocked", 422);
+    this.name = "JobBlockedError";
+  }
+};
 var JobFailedError = class extends NodaroError {
   constructor(message, jobId, jobStatus = "failed") {
     super(message, "job_failed", 0);
@@ -98,6 +104,14 @@ var JobAbortedError = class extends NodaroError {
   }
   jobId;
 };
+var JobHeldError = class extends NodaroError {
+  constructor(message, jobId) {
+    super(message, "job_held", 0);
+    this.jobId = jobId;
+    this.name = "JobHeldError";
+  }
+  jobId;
+};
 function throwFromResponse(status, body) {
   const code = body.error?.code ?? "internal_error";
   const message = body.error?.message ?? "Request failed";
@@ -110,6 +124,7 @@ function throwFromResponse(status, body) {
       body.error?.currentRecord
     );
   }
+  if (status === 422 && code === "job_blocked") throw new JobBlockedError(message);
   if (status === 403 && code === "insufficient_scope") {
     throw new ForbiddenError(message, body.error?.missingScope);
   }
@@ -361,6 +376,18 @@ var JobsResource = class {
       `/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)}`
+    );
+  }
 };
 
 // src/resources/video-pro.ts
@@ -479,8 +506,9 @@ var NodesResource = class {
    * the candidate-grid path (generate N stills/clips in parallel). Each runs
    * via {@link runAndWait}; resolves once ALL settle, to an array of
    * `{ jobId, output }` in input order. Rejects (and the rejection wins) if any
-   * single run rejects — same typed errors as {@link runAndWait}. A shared
-   * `signal` aborts the whole batch.
+   * single run rejects — same typed errors as {@link runAndWait}, including
+   * {@link JobHeldError} when one candidate is held for review while the
+   * others complete. A shared `signal` aborts the whole batch.
    *
    * @param type        Node type slug, applied to every entry.
    * @param paramsList  One request body per candidate.
@@ -498,7 +526,10 @@ var NodesResource = class {
       })
     );
   }
-  /** Poll an already-kicked job id until terminal; resolve output_data or throw. */
+  /** Poll an already-kicked job id until it stops moving; resolve output_data
+   *  or throw. Two non-terminal statuses end the loop: an abort, and
+   *  `pending_review` (a job policy held the output for a human — see
+   *  {@link JobHeldError}). */
   async pollJob(jobId, label, opts) {
     const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
     const maxMs = opts.maxMs ?? DEFAULT_MAX_MS;
@@ -517,6 +548,9 @@ var NodesResource = class {
           data.status
         );
       }
+      if (data.status === "pending_review") {
+        throw new JobHeldError(`${label} is awaiting review`, jobId);
+      }
       if (Date.now() > deadline) {
         throw new JobTimeoutError(`${label} timed out`, jobId, maxMs);
       }
@@ -2718,7 +2752,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "1.27.0" ;
+var SDK_VERSION = "1.29.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -2966,6 +3000,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, ShotsResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, 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, ShotsResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map