@nodaro/sdk 1.17.0 → 1.20.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 { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, 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';
 
@@ -109,8 +109,68 @@ interface RunWorkflowResult {
     executionId: string;
     status: "pending" | "running";
 }
+/** A person granted access to a workflow. Email is never returned (privacy). */
+interface Collaborator {
+    userId: string;
+    name?: string | null;
+    avatar?: string | null;
+    role: CollaboratorRole;
+}
+interface AddCollaboratorInput {
+    /** Provide exactly one of `userId` or `email`. */
+    userId?: string;
+    email?: string;
+    role: CollaboratorRole;
+}
+/** A workflow someone else shared with you, plus the role you hold on it. */
+interface SharedWorkflow extends Workflow {
+    grantedRole: CollaboratorRole;
+}
+/** A grant dropped because a move took the workflow out of the workspace the
+ *  access came from. */
+interface DroppedCollaborator {
+    userId: string;
+    name: string | null;
+}
+/**
+ * The people a workflow is shared with — reached as `client.workflows.collaborators`.
+ * All four endpoints are served by the organizations feature and exist only when
+ * it is enabled server-side; against an install without it they 404
+ * (→ `NotFoundError`). The active workspace travels on the request like every
+ * other call, so a workspace admin's grants apply automatically.
+ */
+declare class WorkflowCollaboratorsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** List a workflow's collaborators (id, name, avatar, role — never email). */
+    list(workflowId: string): Promise<{
+        data: Collaborator[];
+    }>;
+    /** Add a collaborator by `userId` OR `email` (exactly one), at the given role. */
+    add(workflowId: string, input: AddCollaboratorInput): Promise<{
+        data: {
+            userId: string;
+            role: CollaboratorRole;
+        };
+    }>;
+    /** Change a collaborator's role. */
+    update(workflowId: string, userId: string, input: {
+        role: CollaboratorRole;
+    }): Promise<{
+        data: {
+            userId: string;
+            role: CollaboratorRole;
+        };
+    }>;
+    /** Remove a collaborator — or yourself. Returns `{ success: true }`. */
+    remove(workflowId: string, userId: string): Promise<{
+        success: true;
+    }>;
+}
 declare class WorkflowsResource {
     private client;
+    /** The people this workflow is shared with. See {@link WorkflowCollaboratorsResource}. */
+    readonly collaborators: WorkflowCollaboratorsResource;
     constructor(client: NodaroClient);
     /** List workflows for a project. Returns metadata only — `nodes`/`edges` are not included. */
     list(params: ListWorkflowsParams): Promise<{
@@ -163,11 +223,45 @@ 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;
+    }>;
+    /**
+     * Set a workflow's visibility — `"private"` (creator + explicit collaborators)
+     * or `"workspace"` (everyone in its workspace). Only the creator or a workspace
+     * admin may change it; anyone else gets HTTP 403. Thin wrapper over `update()`:
+     * the visibility lever lives on `PATCH /v1/workflows/:id`.
+     */
+    setVisibility(id: string, visibility: WorkflowVisibility): Promise<{
+        data: Workflow;
+    }>;
+    /**
+     * Move a workflow to another project (`POST /v1/workflows/:id/move`); its folder
+     * is cleared. When the move takes the workflow out of a workspace, collaborator
+     * grants that came from that workspace are dropped and returned as
+     * `droppedCollaborators`.
+     */
+    move(id: string, params: {
+        projectId: string;
+    }): Promise<{
+        data: Workflow;
+        droppedCollaborators: DroppedCollaborator[];
+    }>;
+    /**
+     * Workflows other people shared with you (`GET /v1/workflows/shared-with-me`) —
+     * grants on work that is NOT in a workspace you belong to (workspace work already
+     * shows in that workspace's own lists). Each carries the `grantedRole` you hold.
+     * Empty when the organizations feature is off server-side.
+     */
+    sharedWithMe(): Promise<{
+        data: SharedWorkflow[];
     }>;
 }
 
@@ -223,7 +317,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;
@@ -254,8 +349,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;
@@ -1726,6 +1822,14 @@ interface UpdateLocationResult {
 interface ListLocationsParams {
     /** When true, return archived locations instead of active ones. */
     archived?: boolean;
+    /**
+     * Max rows to return (cap 500). OPT-IN: omitted, the server returns the
+     * full legacy listing with no `nextCursor`; supplied, the response is one
+     * page plus `nextCursor` — keep passing it back until it is `null`.
+     */
+    limit?: number;
+    /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */
+    cursor?: string;
 }
 /**
  * Input for `client.locations.generate()` — fires the
@@ -1920,6 +2024,7 @@ declare class LocationsResource {
      */
     list(params?: ListLocationsParams): Promise<{
         locations: Location[];
+        nextCursor?: string | null;
     }>;
     /**
      * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
@@ -1930,6 +2035,7 @@ declare class LocationsResource {
      */
     listArchived(params?: Omit<ListLocationsParams, "archived">): Promise<{
         locations: Location[];
+        nextCursor?: string | null;
     }>;
     /**
      * Fetch a single location including in-flight asset job state. Soft-deleted
@@ -2267,6 +2373,14 @@ interface ListObjectsParams {
     archived?: boolean;
     /** Optional project filter — server-scoped to the caller's user. */
     projectId?: string;
+    /**
+     * Max rows to return (cap 500). OPT-IN: omitted, the server returns the
+     * full legacy listing with no `nextCursor`; supplied, the response is one
+     * page plus `nextCursor` — keep passing it back until it is `null`.
+     */
+    limit?: number;
+    /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */
+    cursor?: string;
 }
 /**
  * Input for `client.objects.generate()` — fires the
@@ -2422,6 +2536,7 @@ declare class ObjectsResource {
      */
     list(params?: ListObjectsParams): Promise<{
         objects: Object$1[];
+        nextCursor?: string | null;
     }>;
     /**
      * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
@@ -2432,6 +2547,7 @@ declare class ObjectsResource {
      */
     listArchived(params?: Omit<ListObjectsParams, "archived">): Promise<{
         objects: Object$1[];
+        nextCursor?: string | null;
     }>;
     /**
      * Fetch a single object including in-flight asset job state. Soft-deleted
@@ -2821,6 +2937,14 @@ interface ListCreaturesParams {
     archived?: boolean;
     /** Optional project filter — server-scoped to the caller's user. */
     projectId?: string;
+    /**
+     * Max rows to return (cap 500). OPT-IN: omitted, the server returns the
+     * full legacy listing with no `nextCursor`; supplied, the response is one
+     * page plus `nextCursor` — keep passing it back until it is `null`.
+     */
+    limit?: number;
+    /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */
+    cursor?: string;
 }
 /**
  * Input for `client.creatures.generate()` — fires the
@@ -2977,6 +3101,7 @@ declare class CreaturesResource {
      */
     list(params?: ListCreaturesParams): Promise<{
         creatures: Creature[];
+        nextCursor?: string | null;
     }>;
     /**
      * Convenience wrapper for `list({ archived: true })`. Returns soft-deleted
@@ -2987,6 +3112,7 @@ declare class CreaturesResource {
      */
     listArchived(params?: Omit<ListCreaturesParams, "archived">): Promise<{
         creatures: Creature[];
+        nextCursor?: string | null;
     }>;
     /**
      * Fetch a single creature including in-flight asset job state. Soft-deleted
@@ -3981,6 +4107,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
@@ -4361,6 +4535,13 @@ interface PickerOption {
     category?: string;
     /** The prompt fragment this id injects downstream. Present only when detail="full". */
     promptHint?: string;
+    /**
+     * Short professional term injected by compact hint mode; `label` is for
+     * display. Present at BOTH detail levels — a thin client renders `label`
+     * and injects `term`. Empty for a no-op ("auto"/"none") entry that injects
+     * nothing.
+     */
+    term?: string;
     icon?: string;
 }
 interface PickerDimension {
@@ -4395,7 +4576,7 @@ interface PickerCatalogSummary {
     optionCount: number;
 }
 interface GetPickerCatalogOptions {
-    /** "compact" (default) = id, label, category, icon; "full" additionally includes description + promptHint. */
+    /** "compact" (default) = id, label, category, term, icon; "full" additionally includes description + promptHint. */
     detail?: "compact" | "full";
     /** single-dim: filter to one category. */
     category?: string;
@@ -4452,6 +4633,58 @@ declare class PickerCatalogsResource {
     }>;
 }
 
+/**
+ * Catalog projection types. Mirror `@nodaro/shared`'s `ProjectedCatalog` so the
+ * SDK stays dependency-free (same convention as `picker-catalogs.ts`). Tag-free
+ * by design — the deferred `CatalogPolicy` never crosses the wire.
+ */
+interface ProjectedCatalogOption {
+    id: string;
+    label: string;
+    description?: string;
+    category?: string;
+    /** The prompt fragment this id injects downstream. Present only when detail="full". */
+    promptHint?: string;
+    /**
+     * Short professional term injected by compact hint mode; `label` is for
+     * display. Present at BOTH detail levels — a thin client renders `label`
+     * and injects `term`. Empty for a no-op ("auto"/"none") entry that injects
+     * nothing.
+     */
+    term?: string;
+    icon?: string;
+}
+interface ProjectedCatalogDimension {
+    field: string;
+    label: string;
+    options: ProjectedCatalogOption[];
+}
+interface ProjectedCatalog {
+    nodeType: string;
+    label: string;
+    catalogId: string;
+    kind: "single" | "multi";
+    valueField?: string;
+    defaultValue?: string;
+    categoryOrder?: string[];
+    categoryLabels?: Record<string, string>;
+    detail: "compact" | "full";
+    options?: ProjectedCatalogOption[];
+    fields?: string[];
+    dimensions?: ProjectedCatalogDimension[];
+}
+declare class CatalogsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Every catalog, projected & pack-composed (honors the deployment's
+     *  registered vendored packs). Cached publicly 5 min. */
+    list(opts?: {
+        detail?: "compact" | "full";
+    }): Promise<{
+        data: ProjectedCatalog[];
+    }>;
+}
+
 /**
  * Model-catalog types. Mirrors the backend's `GET /v1/models` projection
  * (itself shared with the MCP `list_models` tool) so the SDK stays
@@ -4651,10 +4884,109 @@ interface RecastEstimate {
     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 {
@@ -4698,6 +5030,10 @@ declare class RecastResource {
     }>;
     /** 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;
@@ -4935,6 +5271,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;
@@ -4952,6 +5536,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;
@@ -5022,20 +5619,45 @@ declare class NodaroClient {
     readonly library: LibraryResource;
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
+    readonly catalogs: CatalogsResource;
     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. */
@@ -5129,4 +5751,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 CreateRecastInput, type CreateShotInput, 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 EstimateRecastInput, 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 RecastEstimate, 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, 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, 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, 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 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 };