@nodaro/sdk 1.11.0 → 1.13.0

package/dist/index.d.cts

@@ -237,6 +237,15 @@ interface Job {
     created_at: string;
     started_at: string | null;
     completed_at: string | null;
+    /**
+     * Provenance: which kind of caller created the job — one of
+     * `"internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web" | "api"`.
+     * `source_detail` narrows it (origin host, `extension/<name>` label,
+     * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;
+     * lets a library view label or filter media by origin.
+     */
+    source?: string | null;
+    source_detail?: string | null;
 }
 interface CancelJobResult {
     success: true;
@@ -4171,6 +4180,16 @@ interface LibraryAsset {
     readonly isLibraryItem: boolean;
     /** How the asset entered storage (e.g. "manual_upload" | "generated"). */
     readonly uploadSource: string;
+    /**
+     * WHICH SURFACE the media came from — `"internal" | "mcp" | "app" | "cli" |
+     * "sdk" | "extension" | "web" | "api"`. Distinct from `uploadSource`, which
+     * says how it entered storage (uploaded vs generated), not who was calling.
+     * `null` on assets created before origin tracking existed — render as
+     * "unknown", don't infer.
+     */
+    readonly source: string | null;
+    /** Specific identity within `source` (origin host, `extension/<name>`, `sdk/<version>`, MCP client, app id). */
+    readonly sourceDetail: string | null;
     readonly createdAt: string;
 }
 interface ListLibraryParams {
@@ -4189,6 +4208,13 @@ interface ListLibraryParams {
      * Media Library picker).
      */
     readonly owned?: boolean;
+    /**
+     * Filter to media that originated from one surface (see
+     * {@link LibraryAsset.source}) — e.g. `"extension"` for everything a
+     * browser extension produced. Assets predating origin tracking have a null
+     * source and match no value, so they appear only when this is omitted.
+     */
+    readonly source?: "internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web" | "api";
 }
 interface ListLibraryResult {
     readonly data: LibraryAsset[];
@@ -4429,6 +4455,151 @@ declare class CommunityResource {
     }>;
 }
 
+/**
+ * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:
+ * browse cards, a single template with its full snapshot, and the free
+ * clone-into-my-project action. Creator/admin surfaces (publish, mine,
+ * favorites, metadata patch, tutorial flags) are deliberately NOT part of
+ * the public SDK contract; first-party apps reach them via
+ * `client.request()`.
+ */
+/** Card returned by the marketplace browse (no snapshot payload). */
+interface TemplateBrowseCard {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    estimatedCredits: number;
+    category: string;
+    outputTypes: string[];
+    tags: string[];
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    complexity: string;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    creatorId: string;
+    creatorDisplayName: string | null;
+    cloneCount: number;
+    favoriteCount: number;
+    createdAt: string;
+}
+type TemplateSort = "newest" | "popular" | "most-favorited";
+interface BrowseTemplatesParams {
+    /** Opaque cursor from the previous page's `nextCursor`. */
+    cursor?: string;
+    limit?: number;
+    category?: string;
+    outputType?: string;
+    tag?: string;
+    /** Full-text search over name/description/tags. */
+    search?: string;
+    sort?: TemplateSort;
+    /** Only templates using this node type. */
+    nodeType?: string;
+    /** Only templates using this provider/model id. */
+    provider?: string;
+    complexity?: string;
+}
+interface BrowseTemplatesResult {
+    data: TemplateBrowseCard[];
+    /** Pass back as `cursor` to fetch the next page; `null` on the last page. */
+    nextCursor: string | null;
+}
+/**
+ * A single public template (`GET /v1/templates/:slug`) — the browse-card
+ * fields plus the full workflow snapshot the viewer/clone consume. The route
+ * returns the whole camelCased row, so additional columns may appear beyond
+ * the ones typed here; the index signature keeps them reachable without
+ * casting.
+ */
+interface Template extends TemplateBrowseCard {
+    markdownDescription: string | null;
+    /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */
+    snapshotNodes: unknown[];
+    snapshotEdges: unknown[];
+    snapshotSettings: Record<string, unknown>;
+    /** Channels the template is listed in (e.g. "marketplace", "tutorial"). */
+    listedIn: string[];
+    readonly [key: string]: unknown;
+}
+interface CloneTemplateParams {
+    /** Target project (must belong to the caller). */
+    projectId: string;
+    /** Optional name for the cloned workflow; defaults to the template's name. */
+    name?: string;
+}
+interface CloneTemplateResult {
+    workflowId: string;
+    projectId: string;
+}
+declare class TemplatesResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Browse the public template marketplace (cursor-paginated, no auth required). */
+    browse(params?: BrowseTemplatesParams): Promise<BrowseTemplatesResult>;
+    /** Fetch one public template by slug, including its full workflow snapshot. */
+    get(slug: string): Promise<Template>;
+    /** Clone a template into one of the caller's projects. Free — no credits charged. */
+    clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult>;
+}
+
+/**
+ * Public tutorials directory (`GET /v1/tutorials`) — video tutorials and
+ * flow (template) tutorials, pre-grouped under the shared category taxonomy.
+ * Read-only by design; curation is an admin surface outside the public SDK.
+ */
+interface TutorialVideoItem {
+    id: string;
+    type: "video";
+    title: string;
+    description: string | null;
+    videoUrl: string;
+    thumbnailUrl: string | null;
+    categoryId: string;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A workflow template surfaced as a tutorial; `slug` feeds `client.templates`. */
+interface TutorialFlowItem {
+    id: string;
+    type: "flow";
+    templateId: string;
+    slug: string | null;
+    title: string;
+    description: string | null;
+    markdownDescription: string | null;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    complexity: string;
+    estimatedCredits: number;
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    categoryId: string;
+    tutorialSortOrder: number;
+    workflowId: string;
+    createdAt: string;
+}
+interface TutorialCategory {
+    id: string;
+    name: string;
+    slug: string;
+    sortOrder: number;
+    videos: TutorialVideoItem[];
+    flows: TutorialFlowItem[];
+}
+declare class TutorialsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+    list(): Promise<{
+        categories: TutorialCategory[];
+    }>;
+}
+
 interface ClientOptions {
     /** Backend base URL, e.g. "https://nodaro.example.com" or empty string for same-origin. */
     baseUrl: string;
@@ -4438,6 +4609,14 @@ interface ClientOptions {
     fetch?: typeof fetch;
     /** Default request timeout in ms. Default 60s. */
     timeoutMs?: number;
+    /**
+     * Overrides the `X-Nodaro-Client` label. Defaults to `sdk/<version>`.
+     *
+     * Exists for `@nodaro/cli`, which is a wrapper AROUND this SDK: without an
+     * override every CLI invocation would be recorded as an SDK call and the two
+     * surfaces could never be told apart.
+     */
+    clientLabel?: string;
 }
 interface RequestOptions {
     body?: unknown;
@@ -4461,11 +4640,21 @@ interface UserIdentity {
     readonly avatarUrl: string | null;
     /** Subscription tier (e.g. "free", "pro"). */
     readonly tier: string;
+    /**
+     * Whether the user holds an admin role. DESCRIPTIVE only — use it to decide
+     * whether to render admin surfaces without capability-probing an admin
+     * endpoint; every admin API stays enforced server-side regardless.
+     */
+    readonly isAdmin: boolean;
 }
 declare class NodaroClient {
     readonly baseUrl: string;
     readonly auth: Auth;
     readonly timeoutMs: number;
+    /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+    readonly clientLabel: string;
+    /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+    private readonly sendClientHeader;
     private readonly fetchOverride;
     /**
      * Resolved lazily so consumers can swap `globalThis.fetch` after the
@@ -4499,6 +4688,8 @@ declare class NodaroClient {
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
     readonly community: CommunityResource;
+    readonly templates: TemplatesResource;
+    readonly tutorials: TutorialsResource;
     constructor(opts: ClientOptions);
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
     /**
@@ -4600,4 +4791,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, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, 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, 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 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 };

package/dist/index.d.ts

@@ -237,6 +237,15 @@ interface Job {
     created_at: string;
     started_at: string | null;
     completed_at: string | null;
+    /**
+     * Provenance: which kind of caller created the job — one of
+     * `"internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web" | "api"`.
+     * `source_detail` narrows it (origin host, `extension/<name>` label,
+     * `sdk/<version>`, MCP client name, developer-app id). Descriptive only;
+     * lets a library view label or filter media by origin.
+     */
+    source?: string | null;
+    source_detail?: string | null;
 }
 interface CancelJobResult {
     success: true;
@@ -4171,6 +4180,16 @@ interface LibraryAsset {
     readonly isLibraryItem: boolean;
     /** How the asset entered storage (e.g. "manual_upload" | "generated"). */
     readonly uploadSource: string;
+    /**
+     * WHICH SURFACE the media came from — `"internal" | "mcp" | "app" | "cli" |
+     * "sdk" | "extension" | "web" | "api"`. Distinct from `uploadSource`, which
+     * says how it entered storage (uploaded vs generated), not who was calling.
+     * `null` on assets created before origin tracking existed — render as
+     * "unknown", don't infer.
+     */
+    readonly source: string | null;
+    /** Specific identity within `source` (origin host, `extension/<name>`, `sdk/<version>`, MCP client, app id). */
+    readonly sourceDetail: string | null;
     readonly createdAt: string;
 }
 interface ListLibraryParams {
@@ -4189,6 +4208,13 @@ interface ListLibraryParams {
      * Media Library picker).
      */
     readonly owned?: boolean;
+    /**
+     * Filter to media that originated from one surface (see
+     * {@link LibraryAsset.source}) — e.g. `"extension"` for everything a
+     * browser extension produced. Assets predating origin tracking have a null
+     * source and match no value, so they appear only when this is omitted.
+     */
+    readonly source?: "internal" | "mcp" | "app" | "cli" | "sdk" | "extension" | "web" | "api";
 }
 interface ListLibraryResult {
     readonly data: LibraryAsset[];
@@ -4429,6 +4455,151 @@ declare class CommunityResource {
     }>;
 }
 
+/**
+ * Workflow-template marketplace — the PUBLIC-BY-DESIGN surfaces only:
+ * browse cards, a single template with its full snapshot, and the free
+ * clone-into-my-project action. Creator/admin surfaces (publish, mine,
+ * favorites, metadata patch, tutorial flags) are deliberately NOT part of
+ * the public SDK contract; first-party apps reach them via
+ * `client.request()`.
+ */
+/** Card returned by the marketplace browse (no snapshot payload). */
+interface TemplateBrowseCard {
+    id: string;
+    slug: string;
+    name: string;
+    description: string | null;
+    estimatedCredits: number;
+    category: string;
+    outputTypes: string[];
+    tags: string[];
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    complexity: string;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    creatorId: string;
+    creatorDisplayName: string | null;
+    cloneCount: number;
+    favoriteCount: number;
+    createdAt: string;
+}
+type TemplateSort = "newest" | "popular" | "most-favorited";
+interface BrowseTemplatesParams {
+    /** Opaque cursor from the previous page's `nextCursor`. */
+    cursor?: string;
+    limit?: number;
+    category?: string;
+    outputType?: string;
+    tag?: string;
+    /** Full-text search over name/description/tags. */
+    search?: string;
+    sort?: TemplateSort;
+    /** Only templates using this node type. */
+    nodeType?: string;
+    /** Only templates using this provider/model id. */
+    provider?: string;
+    complexity?: string;
+}
+interface BrowseTemplatesResult {
+    data: TemplateBrowseCard[];
+    /** Pass back as `cursor` to fetch the next page; `null` on the last page. */
+    nextCursor: string | null;
+}
+/**
+ * A single public template (`GET /v1/templates/:slug`) — the browse-card
+ * fields plus the full workflow snapshot the viewer/clone consume. The route
+ * returns the whole camelCased row, so additional columns may appear beyond
+ * the ones typed here; the index signature keeps them reachable without
+ * casting.
+ */
+interface Template extends TemplateBrowseCard {
+    markdownDescription: string | null;
+    /** React Flow node snapshots (generic node JSON, execution data stripped on clone). */
+    snapshotNodes: unknown[];
+    snapshotEdges: unknown[];
+    snapshotSettings: Record<string, unknown>;
+    /** Channels the template is listed in (e.g. "marketplace", "tutorial"). */
+    listedIn: string[];
+    readonly [key: string]: unknown;
+}
+interface CloneTemplateParams {
+    /** Target project (must belong to the caller). */
+    projectId: string;
+    /** Optional name for the cloned workflow; defaults to the template's name. */
+    name?: string;
+}
+interface CloneTemplateResult {
+    workflowId: string;
+    projectId: string;
+}
+declare class TemplatesResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** Browse the public template marketplace (cursor-paginated, no auth required). */
+    browse(params?: BrowseTemplatesParams): Promise<BrowseTemplatesResult>;
+    /** Fetch one public template by slug, including its full workflow snapshot. */
+    get(slug: string): Promise<Template>;
+    /** Clone a template into one of the caller's projects. Free — no credits charged. */
+    clone(slug: string, params: CloneTemplateParams): Promise<CloneTemplateResult>;
+}
+
+/**
+ * Public tutorials directory (`GET /v1/tutorials`) — video tutorials and
+ * flow (template) tutorials, pre-grouped under the shared category taxonomy.
+ * Read-only by design; curation is an admin surface outside the public SDK.
+ */
+interface TutorialVideoItem {
+    id: string;
+    type: "video";
+    title: string;
+    description: string | null;
+    videoUrl: string;
+    thumbnailUrl: string | null;
+    categoryId: string;
+    sortOrder: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** A workflow template surfaced as a tutorial; `slug` feeds `client.templates`. */
+interface TutorialFlowItem {
+    id: string;
+    type: "flow";
+    templateId: string;
+    slug: string | null;
+    title: string;
+    description: string | null;
+    markdownDescription: string | null;
+    previewMediaUrl: string | null;
+    previewMediaType: "image" | "video" | null;
+    complexity: string;
+    estimatedCredits: number;
+    nodeTypesUsed: string[];
+    providersUsed: string[];
+    nodeCount: number;
+    categoryId: string;
+    tutorialSortOrder: number;
+    workflowId: string;
+    createdAt: string;
+}
+interface TutorialCategory {
+    id: string;
+    name: string;
+    slug: string;
+    sortOrder: number;
+    videos: TutorialVideoItem[];
+    flows: TutorialFlowItem[];
+}
+declare class TutorialsResource {
+    private client;
+    constructor(client: NodaroClient);
+    /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+    list(): Promise<{
+        categories: TutorialCategory[];
+    }>;
+}
+
 interface ClientOptions {
     /** Backend base URL, e.g. "https://nodaro.example.com" or empty string for same-origin. */
     baseUrl: string;
@@ -4438,6 +4609,14 @@ interface ClientOptions {
     fetch?: typeof fetch;
     /** Default request timeout in ms. Default 60s. */
     timeoutMs?: number;
+    /**
+     * Overrides the `X-Nodaro-Client` label. Defaults to `sdk/<version>`.
+     *
+     * Exists for `@nodaro/cli`, which is a wrapper AROUND this SDK: without an
+     * override every CLI invocation would be recorded as an SDK call and the two
+     * surfaces could never be told apart.
+     */
+    clientLabel?: string;
 }
 interface RequestOptions {
     body?: unknown;
@@ -4461,11 +4640,21 @@ interface UserIdentity {
     readonly avatarUrl: string | null;
     /** Subscription tier (e.g. "free", "pro"). */
     readonly tier: string;
+    /**
+     * Whether the user holds an admin role. DESCRIPTIVE only — use it to decide
+     * whether to render admin surfaces without capability-probing an admin
+     * endpoint; every admin API stays enforced server-side regardless.
+     */
+    readonly isAdmin: boolean;
 }
 declare class NodaroClient {
     readonly baseUrl: string;
     readonly auth: Auth;
     readonly timeoutMs: number;
+    /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+    readonly clientLabel: string;
+    /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+    private readonly sendClientHeader;
     private readonly fetchOverride;
     /**
      * Resolved lazily so consumers can swap `globalThis.fetch` after the
@@ -4499,6 +4688,8 @@ declare class NodaroClient {
     readonly presets: PresetsResource;
     readonly pickerCatalogs: PickerCatalogsResource;
     readonly community: CommunityResource;
+    readonly templates: TemplatesResource;
+    readonly tutorials: TutorialsResource;
     constructor(opts: ClientOptions);
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
     /**
@@ -4600,4 +4791,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, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, 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, 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 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 };

package/dist/index.js

@@ -1932,6 +1932,7 @@ var LibraryResource = class {
     if (params.limit !== void 0) qs.set("limit", String(params.limit));
     if (params.cursor) qs.set("cursor", params.cursor);
     if (params.owned !== void 0) qs.set("owned", String(params.owned));
+    if (params.source) qs.set("source", params.source);
     const query = qs.toString();
     return this.client.request("GET", `/v1/library${query ? `?${query}` : ""}`);
   }
@@ -2116,11 +2117,52 @@ var CommunityResource = class {
   }
 };
 
+// src/resources/templates.ts
+var TemplatesResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Browse the public template marketplace (cursor-paginated, no auth required). */
+  browse(params = {}) {
+    return this.client.request("GET", "/v1/templates/browse", { query: { ...params } });
+  }
+  /** Fetch one public template by slug, including its full workflow snapshot. */
+  get(slug) {
+    return this.client.request("GET", `/v1/templates/${encodeURIComponent(slug)}`);
+  }
+  /** Clone a template into one of the caller's projects. Free — no credits charged. */
+  clone(slug, params) {
+    return this.client.request("POST", `/v1/templates/${encodeURIComponent(slug)}/clone`, {
+      body: params
+    });
+  }
+};
+
+// src/resources/tutorials.ts
+var TutorialsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** All enabled tutorial categories with their videos and flow tutorials. Public. */
+  list() {
+    return this.client.request("GET", "/v1/tutorials");
+  }
+};
+
 // src/client.ts
+var SDK_VERSION = "1.13.0" ;
+var CLIENT_HEADER = "X-Nodaro-Client";
+var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class {
   baseUrl;
   auth;
   timeoutMs;
+  /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+  clientLabel;
+  /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+  sendClientHeader;
   fetchOverride;
   /**
    * Resolved lazily so consumers can swap `globalThis.fetch` after the
@@ -2156,11 +2198,15 @@ var NodaroClient = class {
   presets;
   pickerCatalogs;
   community;
+  templates;
+  tutorials;
   constructor(opts) {
     this.baseUrl = opts.baseUrl.replace(/\/$/, "");
     this.auth = opts.auth;
     this.fetchOverride = opts.fetch;
     this.timeoutMs = opts.timeoutMs ?? 6e4;
+    this.clientLabel = opts.clientLabel ?? `sdk/${SDK_VERSION}`;
+    this.sendClientHeader = opts.clientLabel !== void 0 || !isBrowser();
     this.workflows = new WorkflowsResource(this);
     this.projects = new ProjectsResource(this);
     this.jobs = new JobsResource(this);
@@ -2186,6 +2232,8 @@ var NodaroClient = class {
     this.presets = new PresetsResource(this);
     this.pickerCatalogs = new PickerCatalogsResource(this);
     this.community = new CommunityResource(this);
+    this.templates = new TemplatesResource(this);
+    this.tutorials = new TutorialsResource(this);
   }
   async request(method, path, options = {}) {
     const url = this.buildUrl(path, options.query);
@@ -2193,6 +2241,7 @@ var NodaroClient = class {
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
     const headers = {
       ...isFormData ? {} : { "Content-Type": "application/json" },
+      ...this.sendClientHeader ? { [CLIENT_HEADER]: this.clientLabel } : {},
       ...options.headers ?? {}
     };
     if (token) headers["Authorization"] = `Bearer ${token}`;
@@ -2277,6 +2326,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, 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, 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