@nodaro/sdk 1.17.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';
 
@@ -163,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;
     }>;
 }
 
@@ -223,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;
@@ -254,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;
@@ -3981,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
@@ -4651,10 +4705,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 +4851,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 +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;
@@ -4952,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;
@@ -5028,14 +5446,38 @@ declare class NodaroClient {
     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 +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 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, 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 };