@nodaro/sdk 1.13.1 → 1.15.0

package/dist/index.d.cts

@@ -1204,6 +1204,13 @@ interface ListCharactersParams {
      * server default — passing it just narrows further.
      */
     limit?: number;
+    /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */
+    cursor?: string;
+}
+interface ListCharactersResult {
+    characters: Character[];
+    /** Pass back as `cursor` for the next page; `null` when there are no more. */
+    nextCursor: string | null;
 }
 interface DuplicateCharacterInput {
     /** Optional canvas node id to bind the new row to. */
@@ -1370,10 +1377,24 @@ declare class CharactersResource {
      * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
      * When `projectId` is set, only characters belonging to that project are
      * returned.
-     */
-    list(params?: ListCharactersParams): Promise<{
-        characters: Character[];
-    }>;
+     *
+     * Cursor-paginated: a response carrying a non-null `nextCursor` means more
+     * rows exist. Pass it back as `cursor` to fetch the next page, and keep going
+     * until `nextCursor` is `null` — a single call returns at most `limit` rows
+     * (default 100), so treating one call as "all characters" silently truncates
+     * the list for anyone past that count.
+     *
+     * ```ts
+     * const all: Character[] = []
+     * let cursor: string | undefined
+     * do {
+     *   const page = await client.characters.list({ cursor })
+     *   all.push(...page.characters)
+     *   cursor = page.nextCursor ?? undefined
+     * } while (cursor)
+     * ```
+     */
+    list(params?: ListCharactersParams): Promise<ListCharactersResult>;
     /**
      * Fetch a single character including in-flight portrait / asset job state.
      * Soft-deleted (archived) rows are returned by id intentionally so canvas
@@ -4361,6 +4382,40 @@ interface GetPickerCatalogOptions {
     /** multi-dim: only this dimension field. */
     field?: string;
 }
+/** Input for `analyzeText` (POST /v1/text-to-picker). */
+interface TextToPickerParams {
+    /** Free-text scene/shot description to analyze. */
+    text: string;
+    /** Picker node types to fill. Omit for ALL analyzable pickers (the server
+     *  fans the analysis out per family and merges). */
+    targetPickers?: string[];
+    /** Extra guidance appended to the analyzer system prompt. */
+    instructions?: string;
+    /** Originating client app slug (e.g. "cine") — attribution only. */
+    origin?: string;
+    llmModel?: string;
+    reasoningEffort?: string;
+}
+interface TextToPickerResult {
+    jobId: string;
+    /** pickerType → dimension → chosen catalog id(s) — same shape as
+     *  describe-to-picker; hydrate pickers from it verbatim. */
+    pickerJson: Record<string, Record<string, string | string[]>>;
+    /** Catalog-coverage feedback (attributes the text described that no
+     *  catalog id represents well). Surface as "we couldn't infer X". */
+    gaps?: {
+        missingItems: Array<{
+            picker: string;
+            dimension: string;
+            observed: string;
+        }>;
+        missingCategories: Array<{
+            picker: string;
+            suggestedDimension: string;
+            observed: string;
+        }>;
+    };
+}
 declare class PickerCatalogsResource {
     private client;
     constructor(client: NodaroClient);
@@ -4368,12 +4423,78 @@ declare class PickerCatalogsResource {
     list(): Promise<{
         data: PickerCatalogSummary[];
     }>;
+    /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+     *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+    analyzeText(params: TextToPickerParams): Promise<TextToPickerResult>;
     /** Get one picker's catalog of valid values. */
     get(nodeType: string, opts?: GetPickerCatalogOptions): Promise<{
         data: PickerCatalog;
     }>;
 }
 
+/**
+ * Model-catalog types. Mirrors the backend's `GET /v1/models` projection
+ * (itself shared with the MCP `list_models` tool) so the SDK stays
+ * dependency-free — same convention as `PickerCatalog` / `NodeDescriptor`.
+ */
+interface ModelSummary {
+    id: string;
+    label: string;
+    description: string;
+    modes: string[];
+    useCases: string[];
+    pricing: Array<{
+        identifier: string;
+        credits: number;
+        note?: string;
+    }>;
+    featured?: boolean;
+    features?: string[];
+    aspectRatios?: string[];
+    resolutions?: string[];
+    qualities?: string[];
+    durations?: number[];
+    /** Compact per-model prompting tips (present when a doctrine exists). */
+    promptTips?: string[];
+    /** TRUE only when a sourced per-family prompt doctrine exists for this
+     *  model — gate "vendor doctrine · real rewrite" badges on this and show
+     *  a generic label otherwise (never overclaim). */
+    doctrineCovered: boolean;
+}
+interface ModelFamilyGroup {
+    family: string;
+    models: ModelSummary[];
+}
+interface ModelsListResult {
+    sections: Array<{
+        kind: "image" | "video" | "audio";
+        families: ModelFamilyGroup[];
+    }>;
+    recommendations: Array<{
+        id: string;
+        title: string;
+        modelIds: string[];
+        reason?: string;
+    } & Record<string, unknown>>;
+    totalModels: number;
+}
+interface ListModelsOptions {
+    kind?: "image" | "video" | "audio";
+    /** Operation filter, e.g. "t2v", "i2v", "t2i". */
+    mode?: string;
+    /** Vendor / lab name, e.g. "Google", "Bytedance". */
+    family?: string;
+    featuredOnly?: boolean;
+}
+declare class ModelsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Browse the models available on this instance — capability sheets,
+     *  per-variant credit pricing, prompt tips, and the `doctrineCovered`
+     *  truth flag. Public endpoint; cached 5 minutes. */
+    list(opts?: ListModelsOptions): Promise<ModelsListResult>;
+}
+
 /**
  * The community-listing types are the single source of truth in
  * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
@@ -4687,6 +4808,7 @@ declare class NodaroClient {
     readonly library: LibraryResource;
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
+    readonly models: ModelsResource;
     readonly community: CommunityResource;
     readonly templates: TemplatesResource;
     readonly tutorials: TutorialsResource;
@@ -4791,4 +4913,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 ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, 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 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 };

package/dist/index.d.ts

@@ -1204,6 +1204,13 @@ interface ListCharactersParams {
      * server default — passing it just narrows further.
      */
     limit?: number;
+    /** Opaque cursor from a prior page's `nextCursor` (fetches the next page). */
+    cursor?: string;
+}
+interface ListCharactersResult {
+    characters: Character[];
+    /** Pass back as `cursor` for the next page; `null` when there are no more. */
+    nextCursor: string | null;
 }
 interface DuplicateCharacterInput {
     /** Optional canvas node id to bind the new row to. */
@@ -1370,10 +1377,24 @@ declare class CharactersResource {
      * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
      * When `projectId` is set, only characters belonging to that project are
      * returned.
-     */
-    list(params?: ListCharactersParams): Promise<{
-        characters: Character[];
-    }>;
+     *
+     * Cursor-paginated: a response carrying a non-null `nextCursor` means more
+     * rows exist. Pass it back as `cursor` to fetch the next page, and keep going
+     * until `nextCursor` is `null` — a single call returns at most `limit` rows
+     * (default 100), so treating one call as "all characters" silently truncates
+     * the list for anyone past that count.
+     *
+     * ```ts
+     * const all: Character[] = []
+     * let cursor: string | undefined
+     * do {
+     *   const page = await client.characters.list({ cursor })
+     *   all.push(...page.characters)
+     *   cursor = page.nextCursor ?? undefined
+     * } while (cursor)
+     * ```
+     */
+    list(params?: ListCharactersParams): Promise<ListCharactersResult>;
     /**
      * Fetch a single character including in-flight portrait / asset job state.
      * Soft-deleted (archived) rows are returned by id intentionally so canvas
@@ -4361,6 +4382,40 @@ interface GetPickerCatalogOptions {
     /** multi-dim: only this dimension field. */
     field?: string;
 }
+/** Input for `analyzeText` (POST /v1/text-to-picker). */
+interface TextToPickerParams {
+    /** Free-text scene/shot description to analyze. */
+    text: string;
+    /** Picker node types to fill. Omit for ALL analyzable pickers (the server
+     *  fans the analysis out per family and merges). */
+    targetPickers?: string[];
+    /** Extra guidance appended to the analyzer system prompt. */
+    instructions?: string;
+    /** Originating client app slug (e.g. "cine") — attribution only. */
+    origin?: string;
+    llmModel?: string;
+    reasoningEffort?: string;
+}
+interface TextToPickerResult {
+    jobId: string;
+    /** pickerType → dimension → chosen catalog id(s) — same shape as
+     *  describe-to-picker; hydrate pickers from it verbatim. */
+    pickerJson: Record<string, Record<string, string | string[]>>;
+    /** Catalog-coverage feedback (attributes the text described that no
+     *  catalog id represents well). Surface as "we couldn't infer X". */
+    gaps?: {
+        missingItems: Array<{
+            picker: string;
+            dimension: string;
+            observed: string;
+        }>;
+        missingCategories: Array<{
+            picker: string;
+            suggestedDimension: string;
+            observed: string;
+        }>;
+    };
+}
 declare class PickerCatalogsResource {
     private client;
     constructor(client: NodaroClient);
@@ -4368,12 +4423,78 @@ declare class PickerCatalogsResource {
     list(): Promise<{
         data: PickerCatalogSummary[];
     }>;
+    /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+     *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+    analyzeText(params: TextToPickerParams): Promise<TextToPickerResult>;
     /** Get one picker's catalog of valid values. */
     get(nodeType: string, opts?: GetPickerCatalogOptions): Promise<{
         data: PickerCatalog;
     }>;
 }
 
+/**
+ * Model-catalog types. Mirrors the backend's `GET /v1/models` projection
+ * (itself shared with the MCP `list_models` tool) so the SDK stays
+ * dependency-free — same convention as `PickerCatalog` / `NodeDescriptor`.
+ */
+interface ModelSummary {
+    id: string;
+    label: string;
+    description: string;
+    modes: string[];
+    useCases: string[];
+    pricing: Array<{
+        identifier: string;
+        credits: number;
+        note?: string;
+    }>;
+    featured?: boolean;
+    features?: string[];
+    aspectRatios?: string[];
+    resolutions?: string[];
+    qualities?: string[];
+    durations?: number[];
+    /** Compact per-model prompting tips (present when a doctrine exists). */
+    promptTips?: string[];
+    /** TRUE only when a sourced per-family prompt doctrine exists for this
+     *  model — gate "vendor doctrine · real rewrite" badges on this and show
+     *  a generic label otherwise (never overclaim). */
+    doctrineCovered: boolean;
+}
+interface ModelFamilyGroup {
+    family: string;
+    models: ModelSummary[];
+}
+interface ModelsListResult {
+    sections: Array<{
+        kind: "image" | "video" | "audio";
+        families: ModelFamilyGroup[];
+    }>;
+    recommendations: Array<{
+        id: string;
+        title: string;
+        modelIds: string[];
+        reason?: string;
+    } & Record<string, unknown>>;
+    totalModels: number;
+}
+interface ListModelsOptions {
+    kind?: "image" | "video" | "audio";
+    /** Operation filter, e.g. "t2v", "i2v", "t2i". */
+    mode?: string;
+    /** Vendor / lab name, e.g. "Google", "Bytedance". */
+    family?: string;
+    featuredOnly?: boolean;
+}
+declare class ModelsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Browse the models available on this instance — capability sheets,
+     *  per-variant credit pricing, prompt tips, and the `doctrineCovered`
+     *  truth flag. Public endpoint; cached 5 minutes. */
+    list(opts?: ListModelsOptions): Promise<ModelsListResult>;
+}
+
 /**
  * The community-listing types are the single source of truth in
  * `@nodaro/shared` (re-used by the backend, frontend, and CLI). Re-export them
@@ -4687,6 +4808,7 @@ declare class NodaroClient {
     readonly library: LibraryResource;
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
+    readonly models: ModelsResource;
     readonly community: CommunityResource;
     readonly templates: TemplatesResource;
     readonly tutorials: TutorialsResource;
@@ -4791,4 +4913,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 ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, 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 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 };

package/dist/index.js

@@ -591,12 +591,29 @@ var CharactersResource = class {
    * pass `archived: true` to fetch soft-deleted rows for an "archive" view.
    * When `projectId` is set, only characters belonging to that project are
    * returned.
+   *
+   * Cursor-paginated: a response carrying a non-null `nextCursor` means more
+   * rows exist. Pass it back as `cursor` to fetch the next page, and keep going
+   * until `nextCursor` is `null` — a single call returns at most `limit` rows
+   * (default 100), so treating one call as "all characters" silently truncates
+   * the list for anyone past that count.
+   *
+   * ```ts
+   * const all: Character[] = []
+   * let cursor: string | undefined
+   * do {
+   *   const page = await client.characters.list({ cursor })
+   *   all.push(...page.characters)
+   *   cursor = page.nextCursor ?? undefined
+   * } while (cursor)
+   * ```
    */
   list(params = {}) {
     const query = {};
     if (params.projectId) query.projectId = params.projectId;
     if (params.archived) query.archived = "true";
     if (params.limit !== void 0) query.limit = String(params.limit);
+    if (params.cursor) query.cursor = params.cursor;
     return this.client.request("GET", "/v1/characters", { query });
   }
   /**
@@ -1985,6 +2002,11 @@ var PickerCatalogsResource = class {
   list() {
     return this.client.request("GET", "/v1/picker-catalogs");
   }
+  /** Fill pickers from a free-text description (Cine "AI Fill"): returns the
+   *  same pickerJson shape as describe-to-picker, keyed by picker node type. */
+  analyzeText(params) {
+    return this.client.request("POST", "/v1/text-to-picker", { body: params });
+  }
   /** Get one picker's catalog of valid values. */
   get(nodeType, opts = {}) {
     const qs = new URLSearchParams();
@@ -1999,6 +2021,26 @@ var PickerCatalogsResource = class {
   }
 };
 
+// src/resources/models.ts
+var ModelsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Browse the models available on this instance — capability sheets,
+   *  per-variant credit pricing, prompt tips, and the `doctrineCovered`
+   *  truth flag. Public endpoint; cached 5 minutes. */
+  list(opts = {}) {
+    const qs = new URLSearchParams();
+    if (opts.kind) qs.set("kind", opts.kind);
+    if (opts.mode) qs.set("mode", opts.mode);
+    if (opts.family) qs.set("family", opts.family);
+    if (opts.featuredOnly) qs.set("featuredOnly", "true");
+    const query = qs.toString();
+    return this.client.request("GET", `/v1/models${query ? `?${query}` : ""}`);
+  }
+};
+
 // src/resources/community.ts
 var CommunityResource = class {
   constructor(client) {
@@ -2152,7 +2194,7 @@ var TutorialsResource = class {
 };
 
 // src/client.ts
-var SDK_VERSION = "1.13.1" ;
+var SDK_VERSION = "1.15.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class {
@@ -2197,6 +2239,7 @@ var NodaroClient = class {
   library;
   presets;
   pickerCatalogs;
+  models;
   community;
   templates;
   tutorials;
@@ -2231,6 +2274,7 @@ var NodaroClient = class {
     this.library = new LibraryResource(this);
     this.presets = new PresetsResource(this);
     this.pickerCatalogs = new PickerCatalogsResource(this);
+    this.models = new ModelsResource(this);
     this.community = new CommunityResource(this);
     this.templates = new TemplatesResource(this);
     this.tutorials = new TutorialsResource(this);
@@ -2326,6 +2370,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LocationsResource, MediaResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, ReduceResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, ReduceResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map