@nodaro/sdk 1.16.0 → 1.19.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { GenericNode, GenericEdge, WorkflowExport, ConnectedReference, 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 } 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, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, PipelineStageName, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, Voice, VoiceClone, VoiceLibraryParams, VoiceLibraryResponse, WorkflowExport, WorkflowExportCharacter, WorkflowExportLocation, WorkflowExportObject } from '@nodaro/shared';
+import { GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, ConnectedReference, 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, 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, PipelineStageName, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, 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';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, PersonValue, RecommendedModel, WizardNodeContext, WizardOption, WizardQuestion, WizardSelection, buildPersonHints } from '@nodaro/prompts';
 
@@ -141,7 +141,8 @@ declare class WorkflowsResource {
     update(id: string, input: UpdateWorkflowInput): Promise<{
         data: Workflow;
     }>;
-    /** Delete a workflow. Returns `{ success: true }`. */
+    /** Delete a workflow. Returns `{ success: true }`. Throws `NotFoundError`
+     *  when the id doesn't exist or isn't yours (the delete is not silent). */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -162,11 +163,15 @@ declare class WorkflowsResource {
     /**
      * Import a `WorkflowExport` bundle into the specified project.
      * Re-creates any bundled assets (characters, objects, locations) under your account.
+     * Media the bundle references on other hosts is copied onto this instance's
+     * storage where reachable; `importReport` says what was copied, what could
+     * not be reached, and what was skipped (and why).
      */
     import(input: WorkflowExport & {
         projectId: string;
     }): Promise<{
         data: Workflow;
+        importReport?: WorkflowImportReport;
     }>;
 }
 
@@ -222,7 +227,8 @@ type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" |
  * Sensitive fields stripped server-side for non-admin callers:
  * `provider`, `provider_cost`, `display_cost`, `credits_actual`. USD
  * pricing is admin-only across api/sdk/mcp — non-admin consumers see
- * only the `credits` abstraction.
+ * only the `credits` abstraction. Server-only nested job data (including
+ * Recast's private remux base) is stripped for every caller, including admins.
  */
 interface Job {
     id: string;
@@ -253,8 +259,9 @@ interface CancelJobResult {
 }
 /**
  * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the
- * `input_data` JSONB, cost/timestamp columns, and the public sanitize pass —
- * intended for poll loops that only need progress/output/error.
+ * `input_data` JSONB and cost/timestamp columns. Its `output_data` still goes
+ * through the server-only nested-field redaction. Intended for poll loops that
+ * only need progress/output/error.
  */
 interface JobStatusResult {
     id: string;
@@ -455,7 +462,10 @@ interface NodeDescriptor {
     category: NodeCategory;
     description: string;
     outputType: OutputType;
-    /** Credit cost. Number when fixed, string range like "1-8" when model-dependent, undefined if free. */
+    /** Credit cost. Number when fixed, string range like "1-8" when
+     *  model-dependent. Undefined when the node is free — or on editions
+     *  without a credit system (community/business omit the field entirely;
+     *  it is meaningful on Cloud only). */
     creditCost?: number | string;
     /** Input fields the node exposes for user override (subset of full config). */
     inputSchema?: NodeInputSchema;
@@ -463,6 +473,16 @@ interface NodeDescriptor {
     providers?: string[];
     /** Capability flags such as "supports-reference-image" or "supports-end-frame". */
     capabilities?: string[];
+    /** Hard duration ceiling in seconds (e.g. Generate Video Pro's env-configured cap). */
+    maxDurationSec?: number;
+    /** Providers whose segment-duration menu is sparse (off-menu values snap to the nearest entry). */
+    sparseProviders?: string[];
+    /** Per-provider resolution tiers, e.g. `{ "minimax-h3": ["2K", "768P"] }`. */
+    providerResolutions?: Record<string, string[]>;
+    /** Per-provider map of display resolution → the literal wire value the API expects. */
+    providerResolutionWire?: Record<string, Record<string, string>>;
+    /** Generate Video Pro: the deployed engine accepts the `soundtrack` input (original-audio replay). */
+    soundtrack?: boolean;
 }
 /**
  * Result of a direct node execution. Most node types return `{ jobId }` and
@@ -736,7 +756,8 @@ declare class DeveloperAppsResource {
     update(id: string, input: UpdateDeveloperAppInput): Promise<{
         data: DeveloperApp;
     }>;
-    /** Delete a developer app. Returns `{ success: true }`. */
+    /** Delete a developer app. Returns `{ success: true }`. Throws
+     *  `NotFoundError` when the id doesn't exist or isn't yours. */
     delete(id: string): Promise<{
         success: true;
     }>;
@@ -3338,7 +3359,9 @@ interface ReduceInput {
     /**
      * Strategy-specific config. Defaults to `{}` server-side, which uses every
      * strategy's `defaultConfig`. Schemas (from `@nodaro/shared`):
-     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url" }`
+     *   - `pick-best-llm`: `{ criteria: string, inputKind?: "text" | "image-url", llmModel?: string }`
+     *     (`llmModel` = the judge model id from the LLM registry; omitted → the
+     *     feature default. Its tier sets the price: economy / standard / premium.)
      *   - `concat`: `{ separator?: string }`
      *   - `vote`: `{ caseSensitive?: boolean }`
      *   - `merge-json`: `{ strategy?: "deep" | "shallow" }`
@@ -3964,6 +3987,54 @@ declare class MediaResource {
     }): Promise<{
         jobId: string;
     }>;
+    /**
+     * Turn one still image + one audio track into an MP4
+     * (`POST /v1/still-to-video`) — locally rendered (FFmpeg), no AI model,
+     * zero credits. The output duration IS the audio's duration; there is no
+     * duration field. Optional `motion` animates the still (zoom / pan /
+     * ken-burns) at `intensity` 1–10. `fit: "contain"` letterboxes with
+     * `padColor` instead of cropping. Poll `jobs.get(jobId)`.
+     */
+    stillToVideo(input: {
+        imageUrl: string;
+        audioUrl: string;
+        motion?: "none" | "zoom-in" | "zoom-out" | "pan-left" | "pan-right" | "ken-burns";
+        intensity?: number;
+        resolution?: "720p" | "1080p" | "4K";
+        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3";
+        fps?: 24 | 30;
+        fit?: "cover" | "contain";
+        padColor?: string;
+    }): Promise<{
+        jobId: string;
+    }>;
+    /**
+     * Turn 2–100 images + one optional audio track into an MP4 slideshow
+     * (`POST /v1/slideshow`) — locally rendered (FFmpeg), zero credits. With
+     * audio, the output duration IS the audio's duration (equal split unless
+     * `imageDurations` pins rows — null entries = auto; mismatched pinned sums
+     * scale proportionally and the factor is disclosed in the job output).
+     * Without audio: N × `perImageDuration`, silent output. Transitions
+     * consume the outgoing slide, so totals stay exact. For a single image use
+     * `stillToVideo`. Poll `jobs.get(jobId)`.
+     */
+    slideshow(input: {
+        imageUrls: string[];
+        audioUrl?: string;
+        imageDurations?: Array<number | null>;
+        perImageDuration?: number;
+        transition?: string;
+        transitionDuration?: number;
+        motion?: "none" | "zoom-in" | "zoom-out" | "ken-burns" | "alternate";
+        intensity?: number;
+        resolution?: "720p" | "1080p" | "4K";
+        aspectRatio?: "16:9" | "9:16" | "1:1" | "4:3";
+        fps?: 24 | 30;
+        fit?: "cover" | "contain";
+        padColor?: string;
+    }): Promise<{
+        jobId: string;
+    }>;
     /**
      * Probe a social video's metadata (`POST /v1/video-metadata`) — duration,
      * dimensions, title, live status — WITHOUT downloading it. A direct read, not a
@@ -4446,7 +4517,9 @@ interface ModelSummary {
     description: string;
     modes: string[];
     useCases: string[];
-    pricing: Array<{
+    /** Per-variant credit pricing. Cloud only — editions without a credit
+     *  system (community/business) omit the field entirely. */
+    pricing?: Array<{
         identifier: string;
         credits: number;
         note?: string;
@@ -4498,6 +4571,301 @@ declare class ModelsResource {
     list(opts?: ListModelsOptions): Promise<ModelsListResult>;
 }
 
+/**
+ * Cine shots — the Share → Remix record behind `/s/:id` share links.
+ * Mirrors the backend's `/v1/shots` wire contract (`shots.ts::toWire`);
+ * types are declared here so the SDK stays dependency-free — same
+ * convention as `ModelSummary` / `PickerCatalog`.
+ */
+/** An `@`-mention entity reference captured in the shot's prompt state. */
+interface ShotEntityRef {
+    entitySlug: string;
+    variantSlug?: string;
+    role?: string;
+    kind?: "character" | "location" | "object" | "creature";
+}
+type ShotMode = "single" | "multi-shot" | "frame-to-motion" | "storyboard";
+interface Shot {
+    id: string;
+    mode: ShotMode;
+    /** Opaque picker/builder selection state — round-tripped verbatim. */
+    selectionState: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    resultUrls?: string[];
+    visibility: "private" | "public";
+    schemaVersion: number;
+    ownerId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateShotInput {
+    mode?: ShotMode;
+    selectionState?: Record<string, unknown>;
+    freeText?: string;
+    negativePrompt?: string;
+    assembledPrompt?: string;
+    perModelPrompts?: Record<string, string>;
+    /** Video model ids the shot targets (max 16). */
+    models?: string[];
+    entityRefs?: ShotEntityRef[];
+    /**
+     * Result media URLs (max 32). Must be plain public http(s) URLs — the
+     * backend rejects signed URLs so a token can never leak into a share
+     * record.
+     */
+    resultUrls?: string[];
+    /** Rows default to private; sharing is an explicit "make public" action. */
+    visibility?: "private" | "public";
+}
+type UpdateShotInput = CreateShotInput;
+declare class ShotsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Create a shot record. Returns the new shot's id — an unguessable
+     *  capability string that doubles as the share-link path segment. */
+    create(input?: CreateShotInput): Promise<{
+        id: string;
+    }>;
+    /** Read a shot. Public shots are readable by anyone holding the id;
+     *  private shots resolve only for their owner (404 otherwise). */
+    get(id: string): Promise<{
+        shot: Shot;
+    }>;
+    /** Update an owned shot (any subset of fields, e.g. a visibility toggle). */
+    update(id: string, input: UpdateShotInput): Promise<{
+        shot: Shot;
+    }>;
+    /** Delete an owned shot. */
+    delete(id: string): Promise<void>;
+}
+
+/**
+ * Recast — regenerate an analyzed source video with your own cast (the engine
+ * behind recast.nodaro.ai), plus the authored-script import lane ("movie as
+ * JSON", no source video).
+ *
+ * Cloud edition only: the `/v1/recast/*` and `/v1/video-analysis/import*`
+ * routes are served by the cloud plugin and 404 on self-hosted installs.
+ * Wire contract: docs/api-integration.md §13c/§13d and
+ * docs/mcp/recast-authoring.md. The interactive run is server-driven — poll
+ * `get()` and answer gates with `resolveGate()`; the platform advances every
+ * non-gate step itself.
+ */
+interface RecastScriptValidationError {
+    path: string;
+    message: string;
+    /** Written for an LLM repair loop — fix `path` using this and re-validate. */
+    hint?: string;
+}
+interface RecastScriptValidation {
+    valid: boolean;
+    errors: RecastScriptValidationError[];
+    warnings: string[];
+}
+interface RecastScriptImportResult {
+    /** A standard completed analysis job — feed it to `create()` as `analysisJobId`. */
+    jobId: string;
+    /** false when an identical script was already imported (idempotent re-import). */
+    created: boolean;
+    warnings: string[];
+    /** The document of record — WITH the server-derived fields; always prefer it
+     *  over your input. */
+    json: Record<string, unknown>;
+}
+interface CreateRecastInput {
+    /** Required: an existing workflow you own that the run attaches to. */
+    workflowId: string;
+    /** The source analysis job (from a video analysis or an authored-script import). */
+    analysisJobId: string;
+    /** Authored imports render `"faithful"` — exactly as written. */
+    fidelity?: string;
+    /** Required (`true`) for faithful renders of authored scripts. */
+    rightsAttested?: boolean;
+    resolution?: string;
+    segmentSec?: number;
+    renderMethod?: string;
+    /** Opt in to the interactive walk (pick-1-of-3 gates surfaced via `get()`). */
+    interactive?: boolean;
+    provider?: string;
+    /**
+     * Interactive gates the CLIENT can answer, e.g. `["sheet-gate"]`. The
+     * platform only opens a gate kind for runs whose create declared support
+     * for it — undeclared kinds are decided automatically.
+     */
+    clientCapabilities?: string[];
+}
+type EstimateRecastInput = Omit<CreateRecastInput, "workflowId" | "rightsAttested" | "clientCapabilities">;
+interface RecastEstimate {
+    totalCredits?: number;
+    breakdown?: Record<string, number>;
+    [key: string]: unknown;
+}
+type RecastAudioLayerName = "music" | "video";
+interface RecastAudioMixControl {
+    /** Linear gain percentage. The server rounds and clamps this to 0–200. */
+    gain: number;
+    /** A muted lane has an effective wire gain of zero. */
+    muted: boolean;
+}
+/** Complete desired controls for the logical lanes addressed by an operation. */
+interface RecastAudioMix {
+    music?: RecastAudioMixControl;
+    video?: RecastAudioMixControl;
+}
+interface RecastAudioManifestV1 {
+    version: 1;
+    /** Opaque server-minted identity of the currently published audio delivery. */
+    revision: string;
+    mode: "bed" | "replace";
+    /** Logical layers in the delivery, including layers whose preview derivative failed. */
+    present: {
+        music?: true;
+        video?: true;
+    };
+    /** Browser-ready, CORS-enabled audio-only derivatives. */
+    layers: {
+        music?: {
+            url: string;
+        };
+        video?: {
+            url: string;
+        };
+    };
+    /** Effective integer gain percentages baked into the current `resultUrl`. */
+    bakedEffectiveGain: {
+        music?: number;
+        video?: number;
+    };
+    /** Present only while a paid audio operation is genuinely live. */
+    pendingRescore?: {
+        jobId: string;
+        requestId: string;
+        state: "pending" | "running";
+        expectedAudioRevision: string;
+        requestedEffectiveGain: {
+            music?: number;
+            video?: number;
+        };
+    };
+}
+interface RecastAudioSectionReplacement {
+    index: number;
+    brief: string;
+}
+/** Exactly one replacement lane may be combined with a mix. */
+type RecastRescoreReplacement = {
+    audioUrl: string;
+    sections?: never;
+} | {
+    sections: RecastAudioSectionReplacement[];
+    audioUrl?: never;
+};
+type RecastNoReplacement = {
+    audioUrl?: never;
+    sections?: never;
+};
+/** A mix, one Music replacement, or a replacement and its complete desired mix. */
+type RecastRescoreOperation = ({
+    mix: RecastAudioMix;
+} & (RecastRescoreReplacement | RecastNoReplacement)) | (RecastRescoreReplacement & {
+    mix?: RecastAudioMix;
+});
+/** Free quote input. `requestId` is deliberately absent because quoting has no side effects. */
+type EstimateRecastRescoreInput = RecastRescoreOperation & {
+    expectedAudioRevision: string;
+};
+/** Revision-safe paid operation. Reuse `requestId` only for transport retries. */
+type RecastRescoreRequestV2 = EstimateRecastRescoreInput & {
+    requestId: string;
+};
+interface RecastRescoreQuote {
+    credits: number;
+    audioRevision: string;
+    noOp: boolean;
+}
+type RecastRescoreResponse = {
+    recastId: string;
+    jobId: string;
+    noOp?: false;
+} | {
+    recastId: string;
+    noOp: true;
+    audioRevision: string;
+};
+/** Run snapshot — `status` plus, on interactive runs, the pending step. */
+interface RecastRunSnapshot {
+    status: string;
+    interactive?: Record<string, unknown>;
+    /** Presence of `audioLayers: 1` opts a client into the revisioned audio contract. */
+    capabilities?: {
+        audioLayers?: 1;
+        [key: string]: unknown;
+    };
+    /** Server-authored manifest for the selected completed take. */
+    audio?: RecastAudioManifestV1;
+    [key: string]: unknown;
+}
+interface ResolveRecastGateInput {
+    /** Which gate the picks answer. Defaults server-side to `"cast"`. */
+    gate?: "cast" | "sheet" | "anchors" | "music";
+    /** cast / sheet gates: the pick payload as surfaced by the pending gate. */
+    picks?: unknown;
+    /** anchors gate: which segment the anchor picks apply to. */
+    segment?: number;
+    anchorPicks?: {
+        start?: number;
+        end?: number;
+    };
+    /** music gate: which section the pick applies to. */
+    section?: number;
+    musicPick?: number | string;
+    /** Let the critic decide this and every remaining gate automatically. */
+    finishAuto?: boolean;
+}
+declare class RecastResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** The generated authoring guide (markdown): document contract, enum
+     *  vocabularies, bounds, audio rules, and a validated worked example. */
+    authoringSkill(): Promise<string>;
+    /** FREE validation of an authored script. Loop until `valid: true`. */
+    validateScript(script: Record<string, unknown>): Promise<RecastScriptValidation>;
+    /**
+     * Import a VALIDATED authored script as a completed analysis job.
+     * `rightsAttested: true` is required (403 otherwise) — authored recasts
+     * render Faithful, exactly as written, so only import work you own.
+     */
+    importScript(script: Record<string, unknown>, opts: {
+        rightsAttested: true;
+    }): Promise<RecastScriptImportResult>;
+    /** Quote a run (credits) before buying the plan. */
+    estimate(input: EstimateRecastInput): Promise<RecastEstimate>;
+    /** Create a run (buys the plan). Returns `{ recastId }`. */
+    create(input: CreateRecastInput): Promise<{
+        recastId: string;
+    }>;
+    /** Poll the run — status plus any pending interactive step. */
+    get(recastId: string): Promise<RecastRunSnapshot>;
+    /** Quote a revisioned Music replacement and/or complete desired mix. Free. */
+    estimateRescore(recastId: string, input: EstimateRecastRescoreInput): Promise<RecastRescoreQuote>;
+    /** Apply a quoted audio operation. Reuse its request id only for a transport retry. */
+    rescore(recastId: string, input: RecastRescoreRequestV2): Promise<RecastRescoreResponse>;
+    /** Start rendering a `planned` run. Idempotent server-side. */
+    start(recastId: string, opts?: {
+        segmentSec?: number;
+        provider?: string;
+    }): Promise<{
+        gvpJobId?: string;
+    }>;
+    /** Answer a pending interactive gate (the pick itself is free). */
+    resolveGate(recastId: string, input: ResolveRecastGateInput): Promise<Record<string, unknown>>;
+}
+
 /**
  * The community-listing types are the single source of truth in
  * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
@@ -4724,6 +5092,254 @@ declare class TutorialsResource {
     }>;
 }
 
+/**
+ * Organizations, their members, and the invitations that fill them.
+ *
+ * Every shape here comes from `@nodaro/shared` rather than being restated:
+ * the app, the CLI and this SDK all read the same wire, and a shape written
+ * out three times is one that drifts in two of them.
+ *
+ * Nothing in this file decides anything. Whether a caller may invite, remove
+ * or rename is the server's answer, delivered as a typed error code, and an
+ * SDK that guessed would be wrong the first time a setting changed.
+ */
+interface CreateOrgInput {
+    name: string;
+    kind: OrgKind;
+    /** Derived from the name when omitted; the server resolves collisions. */
+    slug?: string;
+    acceptTerms?: boolean;
+    settings?: OrgSettings;
+}
+interface InviteInput {
+    emails: string[];
+    orgRole?: "admin" | "member";
+    /** Also places the invitee in this workspace on accept. */
+    workspaceId?: string;
+    workspaceRole?: WorkspaceRole;
+}
+interface ListInvitationsOptions {
+    status?: InvitationState;
+    workspaceId?: string;
+    cursor?: string;
+    limit?: number;
+}
+declare class OrganizationsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** The organizations this account belongs to. */
+    list(): Promise<{
+        data: OrganizationView[];
+    }>;
+    get(id: string): Promise<{
+        data: OrganizationView;
+    }>;
+    /**
+     * Create an organization. On instances that require it, `acceptTerms` must
+     * be true or the server answers `terms_required` — the SDK does not decide
+     * whether terms apply, because only the instance knows.
+     *
+     * A new organization may come back `pending`: some instances hold new
+     * organizations for a platform admin to approve, and a pending one grants
+     * nothing until it is active.
+     */
+    create(input: CreateOrgInput): Promise<{
+        data: OrganizationView;
+    }>;
+    update(id: string, input: {
+        name?: string;
+        settings?: OrgSettings;
+    }): Promise<{
+        data: OrganizationView;
+    }>;
+    /** Soft-delete. The organization stops granting context; nothing is destroyed. */
+    delete(id: string): Promise<{
+        data: {
+            id: string;
+            status: string;
+        };
+    }>;
+    /** Hand the organization to another member. The caller becomes an admin. */
+    transferOwnership(id: string, userId: string): Promise<{
+        data: {
+            orgId: string;
+            ownerUserId: string;
+        };
+    }>;
+    /** Leave. An owner cannot — transfer ownership first (`owner_cannot_leave`). */
+    leave(id: string): Promise<{
+        data: {
+            orgId: string;
+            left: boolean;
+        };
+    }>;
+    listMembers(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgMemberView>>;
+    updateMember(orgId: string, userId: string, input: {
+        role?: "admin" | "member";
+        status?: MemberStatus;
+    }): Promise<{
+        data: OrgMemberView;
+    }>;
+    removeMember(orgId: string, userId: string): Promise<{
+        data: {
+            removed: boolean;
+        };
+    }>;
+    /**
+     * Invite by email. Returns ONE ROW PER ADDRESS, and a row whose `status` is
+     * not `sent` carries a `link` instead.
+     *
+     * Surface that link. An install with no mail provider — every fresh
+     * self-host — delivers nothing, and an integration that reports "invited"
+     * without showing the link creates invitations nobody can ever reach.
+     */
+    invite(orgId: string, input: InviteInput): Promise<{
+        data: InvitationDelivery[];
+    }>;
+    listInvitations(orgId: string, opts?: ListInvitationsOptions): Promise<OrgPage<InvitationView>>;
+    revokeInvitation(id: string): Promise<{
+        data: {
+            id: string;
+            revoked: boolean;
+        };
+    }>;
+    resendInvitation(id: string): Promise<{
+        data: InvitationDelivery & {
+            id: string;
+        };
+    }>;
+    /**
+     * What an invitee sees before signing in — the one organization read that
+     * needs no token, so it works while the recipient is still signed out.
+     */
+    previewInvitation(token: string): Promise<{
+        data: InvitationPreview;
+    }>;
+    /** Accept. Requires an authenticated caller whose email matches the invite. */
+    acceptInvitation(token: string): Promise<{
+        data: {
+            orgId: string;
+            workspaceId: string | null;
+        };
+    }>;
+    /**
+     * The organization's audit log, newest first. Owner and admins only, and
+     * readable while the organization is suspended — the record of what
+     * happened is exactly what someone needs when things have gone wrong.
+     */
+    audit(orgId: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<OrgAuditEntry>>;
+}
+
+/**
+ * Workspaces — the inner tenancy axis, where work actually lives.
+ *
+ * Selecting a workspace and belonging to one are different things, and this
+ * resource is only about the second. Use {@link NodaroClient.withWorkspace}
+ * to decide which workspace a REQUEST acts in; these methods read and change
+ * the workspaces themselves.
+ */
+interface CreateWorkspaceInput {
+    name: string;
+    slug?: string;
+    description?: string;
+    settings?: WorkspaceSettings;
+}
+declare class WorkspacesResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Every workspace this account belongs to, across all its organizations.
+     *
+     * An identity read: a stale workspace binding cannot lock a caller out of
+     * it, which is what makes it safe to call when a selection has gone bad.
+     *
+     * Byte-for-byte the list `GET /v1/me` carries, so a client reconciles
+     * against one truth rather than two. That is why these are SUMMARIES —
+     * enough to render a switcher, not the full view; use {@link get} for that.
+     */
+    list(): Promise<{
+        data: WorkspaceSummary[];
+        lastWorkspaceId: string | null;
+    }>;
+    listForOrg(orgId: string, opts?: {
+        includeArchived?: boolean;
+    }): Promise<{
+        data: WorkspaceView[];
+    }>;
+    get(id: string): Promise<{
+        data: WorkspaceView;
+    }>;
+    create(orgId: string, input: CreateWorkspaceInput): Promise<{
+        data: WorkspaceView;
+    }>;
+    update(id: string, input: {
+        name?: string;
+        description?: string | null;
+        settings?: WorkspaceSettings;
+    }): Promise<{
+        data: WorkspaceView;
+    }>;
+    /**
+     * Archive or restore. Archiving is REVERSIBLE and destroys nothing: the
+     * workspace stops accepting new work and stays fully readable, which is
+     * what a finished class term needs and a delete would not survive.
+     */
+    setArchived(id: string, archived: boolean): Promise<{
+        data: WorkspaceView;
+    }>;
+    listMembers(id: string, opts?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<OrgPage<WorkspaceMemberView>>;
+    /** Add someone who is ALREADY in the organization. To bring in a new person, invite them. */
+    addMember(id: string, input: {
+        userId: string;
+        role: WorkspaceRole;
+    }): Promise<{
+        data: WorkspaceMemberView;
+    }>;
+    updateMember(id: string, userId: string, input: {
+        role?: WorkspaceRole;
+        status?: MemberStatus;
+        creditCap?: number | null;
+    }): Promise<{
+        data: WorkspaceMemberView;
+    }>;
+    removeMember(id: string, userId: string): Promise<{
+        data: {
+            removed: boolean;
+        };
+    }>;
+    /** The workspace's join code, or `null` if none has been created. Admins only. */
+    getJoinCode(id: string): Promise<{
+        data: JoinCodeView | null;
+    }>;
+    /**
+     * Rotate, enable or disable the code. Rotating invalidates the old one
+     * immediately — that is the point of it, and anyone still holding a link
+     * with the old code will be refused.
+     */
+    actOnJoinCode(id: string, action: "rotate" | "enable" | "disable"): Promise<{
+        data: JoinCodeView;
+    }>;
+    /**
+     * Join by code. Another way IN, so a stale workspace binding must not block
+     * it — the server treats this as an identity route for that reason.
+     */
+    join(code: string): Promise<{
+        data: {
+            orgId: string;
+            workspaceId: string;
+        };
+    }>;
+}
+
 interface ClientOptions {
     /** Backend base URL, e.g. "https://nodaro.example.com" or empty string for same-origin. */
     baseUrl: string;
@@ -4741,6 +5357,19 @@ interface ClientOptions {
      * surfaces could never be told apart.
      */
     clientLabel?: string;
+    /**
+     * The workspace every request acts in — sent as `X-Nodaro-Workspace`.
+     *
+     * It selects which workspace a LIST reads from and where a CREATE lands.
+     * It never authorizes: reading, updating, deleting or running an
+     * identified object is decided by that object's own workspace, so a
+     * forgotten header cannot hide work and a forged one cannot reach anyone
+     * else's. Omit it to work in the caller's personal space.
+     *
+     * Prefer {@link NodaroClient.withWorkspace} for anything short-lived — one
+     * client per workspace, no shared mutable selection to get wrong.
+     */
+    workspaceId?: string;
 }
 interface RequestOptions {
     body?: unknown;
@@ -4812,17 +5441,43 @@ declare class NodaroClient {
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
     readonly models: ModelsResource;
+    readonly shots: ShotsResource;
+    readonly recast: RecastResource;
     readonly community: CommunityResource;
     readonly templates: TemplatesResource;
     readonly tutorials: TutorialsResource;
+    readonly organizations: OrganizationsResource;
+    readonly workspaces: WorkspacesResource;
+    /** The workspace this client acts in; undefined = the personal space. */
+    readonly workspaceId: string | undefined;
     constructor(opts: ClientOptions);
+    /**
+     * A client that acts in `workspaceId`, sharing this one's auth and config.
+     *
+     * A NEW client rather than a setter, deliberately. A mutable selection is
+     * the bug this whole axis exists to prevent: two concurrent operations
+     * against one client would race over which workspace they were in, and the
+     * loser would create work in the wrong place with nothing failing. A
+     * per-workspace client cannot be raced.
+     *
+     * Pass `null` for the personal space.
+     */
+    withWorkspace(workspaceId: string | null): NodaroClient;
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
     /**
      * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
      * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
      * token is missing/invalid, and the SDK's other typed errors as usual.
-     */
-    me(): Promise<UserIdentity>;
+     *
+     * On an instance with organizations it also carries what the caller belongs
+     * to. THREE states, and collapsing them is wrong in a way users feel: the
+     * organization fields ABSENT means this instance has no organizations at
+     * all; present and empty means the account belongs to none; and
+     * `organizationsUnavailable` means the lookup failed — keep whatever
+     * selection you already had rather than concluding the person was removed
+     * from everything.
+     */
+    me(): Promise<UserIdentity & MeOrganizations>;
     private buildUrl;
 }
 /** Factory function — preferred entry point. */
@@ -4916,4 +5571,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, 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 CreateProjectInput, type CreateWorkflowInput, 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 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 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type RotateSecretResult, type RunAndWaitOptions, type RunManyResult, type RunNodeResult, type RunWorkflowParams, type RunWorkflowResult, 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 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, 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, 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 ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, 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, 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 RunManyResult, 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 };