@nodaro/sdk 1.25.0 → 1.27.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, ConnectedReference, TtsProvider, EntityStyle, CharacterAspectRatio, CharacterAttachColumn, LocationAssetType, LocationAttachColumn, SurroundDirection, ObjectAssetType, ObjectAttachColumn, ObjectAspectRatio, CreatureAttachColumn, PipelineInput, PipelineStatus, PipelineMode, PipelineStageName, SubGateName, ChatEnabledStage, ProposedChange, ReduceStrategyId, ReduceMeta, Voice, VoiceLibraryParams, VoiceLibraryResponse, VoiceClone, AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CommunityCard, CommunityFullDetail, CommunityEntityType, CloneListingResult, FavoriteListingResult, CommunityReportReason, ReportListingResult, PublishListingParams, PublishListingResult, SharedListing, OrganizationView, OrgKind, OrgSettings, OrgPage, OrgMemberView, MemberStatus, WorkspaceRole, InvitationDelivery, InvitationState, InvitationView, InvitationPreview, OrgAuditEntry, WorkspaceSummary, WorkspaceView, WorkspaceSettings, WorkspaceMemberView, JoinCodeView, MeOrganizations } from '@nodaro/shared';
-export { AudioFxPreset, BrowseCommunityParams, BrowseCommunityResult, CHARACTER_ASPECT_DEFAULTS, CHARACTER_ASPECT_OPTIONS, CHARACTER_STYLES, OBJECT_ASPECT_DEFAULTS as CREATURE_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS as CREATURE_ASPECT_OPTIONS, CREATURE_ATTACH_COLUMNS, CharacterAspectRatio, CloneListingResult, CommunityCard, CommunityEntityType, CommunityReportReason, CommunitySort, ConnectedReference, ObjectAspectRatio as CreatureAspectRatio, CreatureAttachColumn, EntityStyle, FavoriteListingResult, GenericEdge, GenericNode, InvitationDelivery, InvitationPreview, InvitationState, InvitationView, JoinCodeView, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, LocationAssetType, LocationAttachColumn, MeOrganizations, MemberStatus, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, ObjectAspectRatio, ObjectAssetType, ObjectAttachColumn, OrgAuditEntry, OrgErrorCode, OrgKind, OrgMemberView, OrgPage, OrgRole, OrgSettings, OrgStatus, OrganizationSummary, OrganizationView, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, 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 { CollaboratorRole, GenericNode, GenericEdge, WorkflowExport, WorkflowImportReport, WorkflowVisibility, ConnectedReference, ModelInputAdjustment, 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, UsageQuery, UsageReport, UsageLogEntry, 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, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, PipelineStageName, PromptAffixFields, PublishListingParams, PublishListingResult, ReduceMeta, ReduceStrategyId, ReportListingResult, SURROUND_DIRECTIONS, SharedListing, SharedVoice, SurroundDirection, USAGE_GROUP_BYS, UsageGroupBy, UsageLogEntry, UsageQuery, UsageReport, UsageReportRow, UsageReportTotals, UsageVarianceRow, 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';
 
@@ -317,6 +317,29 @@ declare class ProjectsResource {
 }
 
 type JobStatus = "pending" | "queued" | "processing" | "completed" | "failed" | "cancelled";
+/**
+ * A job's `jobs.error_hint` (migration 376) — a user-safe, machine-readable
+ * failure verdict the worker writes on a FINAL provider content-policy
+ * block, so a caller can act on it without parsing `error_message` prose.
+ * `class` distinguishes a deterministic block (copyright/likeness — retrying
+ * the same request never helps) from `safety`, whose filter is known to be
+ * non-deterministic for some models: `retried` says whether the worker
+ * already spent its one extra attempt, and `suggestedProvider` — present
+ * only when the catalog declares a fallback for the model that failed — is a
+ * real model id the SAME prompt/references can be retried on.
+ */
+interface JobErrorHint {
+    kind: "safety-block";
+    class: "copyright" | "likeness" | "safety";
+    retried: boolean;
+    suggestedProvider?: string;
+}
+/**
+ * The billing lifecycle of a job's credit reservation — `usage_logs.status`
+ * for the job's `usage_log_id`. `null` when the job has no usage log (e.g. a
+ * free run) or hasn't reserved credits yet.
+ */
+type CreditStatus = "reserved" | "committed" | "refunded";
 /**
  * Job record returned to non-admin SDK consumers. Field names are snake_case
  * to match the wire format (per the OpenAPI fix in Phase 1).
@@ -335,6 +358,13 @@ interface Job {
     input_data: unknown;
     output_data: unknown;
     error_message: string | null;
+    /** PR9: present on a failed job the worker classified as a content-policy
+     *  block; absent/null otherwise. User-safe by construction. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: the job's credit reservation lifecycle, derived server-side from
+     *  `usage_logs.status`. `null` when there is no usage log to report. Never
+     *  changes the meaning of `credits` (the reserved amount) below. */
+    credit_status?: CreditStatus | null;
     credits: number | null;
     job_type: string | null;
     created_at: string;
@@ -354,6 +384,22 @@ interface CancelJobResult {
     success: true;
     cancelled: number;
 }
+interface ListJobsParams {
+    /** Exact match on `input_data.type` — the route that created the job
+     *  (`"llm-structured"`, `"video-analysis"`, …). */
+    type?: string;
+    /** Exact match on `input_data.origin` — the client app that sent it. */
+    origin?: string;
+    /** Page size, 1–100 (server default 50). */
+    limit?: number;
+    /** The previous page's `next`. */
+    cursor?: string;
+}
+interface ListJobsPage {
+    data: Job[];
+    /** Pass back as `cursor` for the next page; `null` on the last one. */
+    next: string | null;
+}
 /**
  * Lean job status returned by `GET /v1/jobs/:id/status`. Skips the
  * `input_data` JSONB and cost/timestamp columns. Its `output_data` still goes
@@ -366,6 +412,10 @@ interface JobStatusResult {
     progress?: number;
     output_data?: unknown;
     error_message?: string | null;
+    /** PR9: see {@link Job.error_hint}. */
+    error_hint?: JobErrorHint | null;
+    /** PR9: see {@link Job.credit_status}. */
+    credit_status?: CreditStatus | null;
 }
 declare class JobsResource {
     private client;
@@ -374,6 +424,12 @@ declare class JobsResource {
     get(id: string): Promise<{
         data: Job;
     }>;
+    /**
+     * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and
+     * `origin` filter on the job's own `input_data`, which every job carries —
+     * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
+     */
+    list(params?: ListJobsParams): Promise<ListJobsPage>;
     /**
      * Get the lean status of a single job (poll-loop friendly).
      * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/
@@ -591,9 +647,22 @@ interface NodeDescriptor {
  * result body. The shape is route-specific; consumers should branch on the
  * presence of `jobId`.
  */
+/**
+ * One parameter the server corrected because the chosen model does not accept
+ * the value you sent (e.g. `gpt-image-2` has no 3:2 aspect ratio). The run
+ * proceeds with the corrected value rather than failing — this is how you find
+ * out what it actually used.
+ *
+ * Re-exports `@nodaro/shared`'s `ModelInputAdjustment` — the same shape the
+ * server's `normalizeModelInput` / `resolveNormalizedImageGen` populate — under
+ * the SDK's naming convention, rather than declaring a second copy of the
+ * fields.
+ */
+type RunNodeAdjustment = ModelInputAdjustment;
 type RunNodeResult = {
     jobId: string;
     usageLogId?: string;
+    adjustments?: RunNodeAdjustment[];
     [k: string]: unknown;
 } | Record<string, unknown>;
 /**
@@ -4079,6 +4148,89 @@ interface DubbingInput {
     watermark?: boolean;
 }
 
+/**
+ * Structured LLM output — `POST /v1/llm/structured` and its asynchronous
+ * twin. The platform supplies the model lane, forced JSON-Schema output with
+ * validation and error-fed retries, the job row and the credit lifecycle; the
+ * caller supplies its own system prompt and schema (an app-owned vocabulary
+ * the platform cannot know — Nodaro Studio's production plan is the first).
+ */
+interface LlmStructuredInput {
+    /** The system prompt (≤ 100,000 chars). */
+    system: string;
+    /** The user turn (1–100,000 chars). */
+    input: string;
+    /** A JSON Schema OBJECT (`type: "object"`, ≤ 64 KB, ≤ 20 levels) in the
+     *  keyword subset the server converts — see the API guide. */
+    jsonSchema: Record<string, unknown>;
+    /** Names the forced-output tool the provider sees (≤ 64 chars). */
+    schemaName?: string;
+    llmModel?: string;
+    reasoningEffort?: string;
+    /** Invalid answers fed back with their error before the call fails (0–3, default 2). */
+    maxRetries?: number;
+    /** Your app's slug — attribution only; `jobs.list({ origin })` finds the rows. */
+    origin?: string;
+    advancedMode?: boolean;
+    temperature?: number;
+    maxTokens?: number;
+}
+interface LlmStructuredResult<T = unknown> {
+    jobId: string;
+    output: T;
+    usage: {
+        inputTokens: number;
+        outputTokens: number;
+    };
+}
+interface LlmStructuredJobInput extends LlmStructuredInput {
+    /** Display label stored on the job (≤ 120 chars) — a run list's row title. */
+    label?: string;
+    /** Draft FROM this video: the platform analyzes it first (`POST
+     *  /v1/video-analysis`, a separate job you own) and appends the analysis
+     *  to `input` before the LLM call. */
+    videoUrl?: string;
+    /** Analysis options, handed to the analysis route unchanged (its tiers). */
+    videoAnalysis?: {
+        llmModel?: string;
+        selectionMode?: "choose" | "combine";
+    };
+}
+/** `output_data` of an `llm-structured` job as it progresses: `stage` while
+ *  running (`analyzing` only for movie runs), then the result. */
+interface LlmStructuredJobOutput<T = unknown> {
+    stage?: "analyzing" | "drafting";
+    output?: T;
+    inputTokens?: number;
+    outputTokens?: number;
+    analysisJobId?: string;
+    analysisCredits?: number;
+}
+declare class LlmResource {
+    private client;
+    constructor(client: NodaroClient);
+    /**
+     * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
+     * can run several minutes — longer than the client's default 60 s
+     * `timeoutMs`; construct the client with a larger `timeoutMs` for this
+     * call, or use {@link LlmResource.structuredJob}.
+     */
+    structured<T = unknown>(input: LlmStructuredInput): Promise<LlmStructuredResult<T>>;
+    /**
+     * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
+     * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
+     * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
+     * `jobs.list({ type: "llm-structured", origin })` finds every run later.
+     * Throws `NotFoundError` on a platform that predates the route. An instance
+     * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
+     * permanently — the SDK surfaces that as a generic `NodaroError` with the
+     * same code; treat it as unavailable here, not as transient.
+     */
+    structuredJob(input: LlmStructuredJobInput): Promise<{
+        jobId: string;
+    }>;
+}
+
 /**
  * Media ingestion + trimming — the source-preparation steps a Voice Changer Pro
  * flow (or any pipeline) needs before it has a clip to work on: pull a social
@@ -4251,6 +4403,16 @@ declare class MediaResource {
     videoMetadata(input: {
         url: string;
     }): Promise<VideoMetadata>;
+    /**
+     * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
+     * free, the source-preparation sibling of the priced `trimVideo` node.
+     * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
+     * the source object afterwards when it is yours and nothing else references
+     * it ("the cut replaces the original"). Answers the stored file.
+     */
+    process(input: MediaProcessInput): Promise<{
+        data: MediaProcessResult;
+    }>;
 }
 /**
  * One event from {@link MediaResource.downloadVideoProgress}. The stream ends
@@ -4277,6 +4439,30 @@ interface VideoMetadata {
     isLive?: boolean;
     [key: string]: unknown;
 }
+interface MediaProcessInput {
+    sourceUrl: string;
+    type: "video" | "audio";
+    trim?: {
+        startTime: number;
+        endTime: number;
+    };
+    crop?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    format?: "mp4" | "webm" | "mp3" | "wav" | "m4a" | "aac";
+    deleteSource?: boolean;
+}
+interface MediaProcessResult {
+    url: string;
+    thumbnailUrl: string | null;
+    assetId: string | null;
+    sizeBytes: number;
+    mimeType: string;
+    metadata: Record<string, unknown>;
+}
 
 /**
  * Audio primitives — the building blocks Voice Changer Pro composes internally
@@ -5504,6 +5690,20 @@ declare class OrganizationsResource {
         cursor?: string;
         limit?: number;
     }): Promise<OrgPage<OrgAuditEntry>>;
+    /**
+     * Credits by workspace, member, model or day. Owner and org admins only.
+     * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
+     * (default last 30).
+     */
+    usage(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit" | "groupBy"> & {
+        groupBy?: "workspace" | "member" | "model" | "day";
+    }): Promise<{
+        data: UsageReport;
+    }>;
+    /** The individual runs behind a report, newest first, cursor-paged. */
+    usageRows(orgId: string, opts?: Omit<UsageQuery, "groupBy">): Promise<OrgPage<UsageLogEntry>>;
+    /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+    usageCsv(orgId: string, opts?: Omit<UsageQuery, "cursor" | "limit">): Promise<string>;
 }
 
 /**
@@ -5608,6 +5808,21 @@ declare class WorkspacesResource {
             workspaceId: string;
         };
     }>;
+    /**
+     * Credits by member, model or day for this workspace. A plain member sees
+     * their OWN runs (the report is self-narrowed and `groupBy: "member"` is
+     * refused); a workspace admin sees everyone and may filter `userId`.
+     * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).
+     */
+    usage(id: string, opts?: Omit<UsageQuery, "cursor" | "limit" | "workspaceId" | "groupBy"> & {
+        groupBy?: "member" | "model" | "day";
+    }): Promise<{
+        data: UsageReport;
+    }>;
+    /** The individual runs behind a report, newest first, cursor-paged. */
+    usageRows(id: string, opts?: Omit<UsageQuery, "groupBy" | "workspaceId">): Promise<OrgPage<UsageLogEntry>>;
+    /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+    usageCsv(id: string, opts?: Omit<UsageQuery, "cursor" | "limit" | "workspaceId">): Promise<string>;
 }
 
 interface ClientOptions {
@@ -5703,6 +5918,7 @@ declare class NodaroClient {
     readonly reduce: ReduceResource;
     readonly promptHelper: PromptHelperResource;
     readonly voices: VoicesResource;
+    readonly llm: LlmResource;
     readonly media: MediaResource;
     readonly audio: AudioResource;
     readonly credits: CreditsResource;
@@ -5734,7 +5950,21 @@ declare class NodaroClient {
      * Pass `null` for the personal space.
      */
     withWorkspace(workspaceId: string | null): NodaroClient;
+    /**
+     * The transport: build the request, send it, throw the typed error on a
+     * non-2xx via {@link throwFromResponse}, then read the body via `read` — all
+     * inside the abort timer, so `timeoutMs` bounds the body download too (a
+     * stalled CSV stream aborts, it does not hang forever). Both the JSON path
+     * ({@link request}) and the text path ({@link requestText}) go through here.
+     */
+    private send;
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Like {@link request}, for endpoints that answer text (CSV exports). Errors
+     * are still the JSON envelope and throw the same typed errors, and the read is
+     * bounded by the same timeout as the request.
+     */
+    requestText(method: string, path: string, options?: RequestOptions): Promise<string>;
     /**
      * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
      * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
@@ -5842,4 +6072,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, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, 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 };
+export { type AccessTokenResponse, type AnalyzeInput, type AnalyzeResult, type AppRun, type AppRunResult, type ApplyChatProposalResult, type ApproveCreatureMainImageResult, type ApproveMainImageResult, type ApproveObjectMainImageResult, type ApprovePortraitResult, AppsResource, AudioResource, type Auth, type BranchPipelineInput, type BranchPipelineResult, type BrowseTemplatesParams, type BrowseTemplatesResult, CREATURE_ASSET_TYPES, CallbackAuth, type CancelExecutionParams, type CancelJobResult, CatalogsResource, type Character, type CharacterDetail, type CharacterUsage, CharactersResource, type ChatStageResult, type ChatTurn, type ClientOptions, type CloneTemplateParams, type CloneTemplateResult, CommunityResource, type ContinueVideoProResult, type CreateCreatureInput, type CreateDeveloperAppInput, type CreateDeveloperAppResult, type CreateLocationInput, type CreateObjectInput, type CreateOrgInput, type CreateProjectInput, type CreateRecastInput, type CreateShotInput, type CreateWorkflowInput, type CreateWorkspaceInput, type Creature, type CreatureAssetType, type CreatureDetail, type CreatureReferencePhoto, type CreatureReferencePhotoKind, CreaturesResource, CreditsResource, type DeleteAppRunResult, type DeveloperApp, type DeveloperAppScope, type DeveloperAppStatus, DeveloperAppsResource, type DownloadVideoProgress, type DubbingInput, type DuplicateCharacterInput, type EnhanceInput, type EstimateRecastInput, type EstimateRecastRescoreInput, type ExchangeCodeInput, type ExecutionStatus, type ExecutionTriggerType, ExecutionsResource, type FactoryPresetsResult, ForbiddenError, type GenerateAssetInput, type GenerateCharacterInput, type GenerateCharacterResult, type GenerateCreatureAssetInput, type GenerateCreatureAssetResult, type GenerateCreatureInput, type GenerateCreatureMotionInput, type GenerateCreatureMotionResult, type GenerateCreatureResult, type GenerateImageParams, type GenerateInput, type GenerateLocationAssetInput, type GenerateLocationInput, type GenerateLocationResult, type GenerateMotionInput, type GenerateObjectAssetInput, type GenerateObjectAssetResult, type GenerateObjectInput, type GenerateObjectMotionInput, type GenerateObjectMotionResult, type GenerateObjectResult, type GenerateSurroundContinuationInput, type GenerateVideoParams, type GetPickerCatalogOptions, InsufficientCreditsError, type InviteInput, type Job, JobAbortedError, JobFailedError, type JobStatus, type JobStatusResult, JobTimeoutError, JobsResource, type LibraryAsset, LibraryResource, type ListAppRunsParams, type ListAppsParams, type ListAppsResult, type ListCharactersParams, type ListCharactersResult, type ListCreaturesParams, type ListExecutionsForWorkflowParams, type ListExecutionsPage, type ListInvitationsOptions, type ListJobsPage, type ListJobsParams, type ListLibraryParams, type ListLibraryResult, type ListLocationsParams, type ListModelsOptions, type ListObjectsParams, type ListWorkflowsParams, LlmResource, type LlmStructuredInput, type LlmStructuredJobInput, type LlmStructuredJobOutput, type LlmStructuredResult, type Location, type LocationDetail, type LocationReferencePhoto, type LocationReferencePhotoKind, LocationsResource, type MediaProcessInput, type MediaProcessResult, MediaResource, type ModelCostsResult, type ModelSummary, type ModelsListResult, ModelsResource, NodaroClient, NodaroError, type NodeCategory, type NodeDescriptor, type NodeExecutionState, type NodeInputField, type NodeInputSchema, type NodeJobOutput, type NodePreset, type NodePresetGroup, NodesResource, NotFoundError, type OAuthAppInfo, OAuthResource, type Object$1 as Object, type ObjectCategory, type ObjectDetail, type ObjectReferencePhoto, type ObjectReferencePhotoKind, ObjectsResource, OrganizationsResource, type OutputType, type PickerCatalog, type PickerCatalogSummary, PickerCatalogsResource, type PickerDimension, type PickerOption, PipelinesResource, PresetsResource, type Project, type ProjectedCatalog, type ProjectedCatalogDimension, type ProjectedCatalogOption, ProjectsResource, PromptHelperResource, type PromptResult, type PublishedApp, type PublishedAppDetail, RateLimitedError, type RecaptionCreatureResult, type RecaptionLocationResult, type RecaptionObjectResult, type RecaptionResult, type RecastAudioLayerName, type RecastAudioManifestV1, type RecastAudioMix, type RecastAudioMixControl, type RecastAudioSectionReplacement, type RecastEstimate, type RecastRescoreOperation, type RecastRescoreQuote, type RecastRescoreReplacement, type RecastRescoreRequestV2, type RecastRescoreResponse, RecastResource, type RecastRunSnapshot, type RecastScriptImportResult, type RecastScriptValidation, type RecastScriptValidationError, type ReduceInput, ReduceResource, type ReduceResult, type ReferencePhoto, type ReferencePhotoKind, type ResolveRecastGateInput, type RotateSecretResult, type RunAndWaitOptions, type RunAppOptions, type RunManyResult, type RunNodeAdjustment, 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 };

package/dist/index.js

@@ -1,7 +1,7 @@
 import { buildPersonHints } from '@nodaro/prompts';
 export { PEOPLE, PERSON_DIMENSION_LABELS, PERSON_DIMENSION_ORDER, buildPersonHints } from '@nodaro/prompts';
 import { WORKSPACE_HEADER } from '@nodaro/shared';
-export { 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, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, SURROUND_DIRECTIONS, WORKSPACE_HEADER } from '@nodaro/shared';
+export { 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, LOCATION_ASSET_TYPES, LOCATION_ATTACH_COLUMNS, OBJECT_ASPECT_DEFAULTS, OBJECT_ASPECT_OPTIONS, OBJECT_ASSET_TYPES, OBJECT_ATTACH_COLUMNS, PROMPT_PREFIX_KEY, PROMPT_SUFFIX_KEY, SURROUND_DIRECTIONS, USAGE_GROUP_BYS, WORKSPACE_HEADER } from '@nodaro/shared';
 
 // src/errors.ts
 var NodaroError = class extends Error {
@@ -331,6 +331,14 @@ var JobsResource = class {
   get(id) {
     return this.client.request("GET", `/v1/jobs/${encodeURIComponent(id)}`);
   }
+  /**
+   * Your jobs, newest first (`GET /v1/jobs`), cursor-paginated. `type` and
+   * `origin` filter on the job's own `input_data`, which every job carries —
+   * a client app lists its runs with `{ type: "llm-structured", origin: "studio" }`.
+   */
+  list(params = {}) {
+    return this.client.request("GET", "/v1/jobs", { query: { ...params } });
+  }
   /**
    * Get the lean status of a single job (poll-loop friendly).
    * Hits `GET /v1/jobs/:id/status` — returns only id/status/progress/
@@ -1793,6 +1801,36 @@ var VoicesResource = class {
   }
 };
 
+// src/resources/llm.ts
+var LlmResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Synchronous forced-schema completion (`POST /v1/llm/structured`). A call
+   * can run several minutes — longer than the client's default 60 s
+   * `timeoutMs`; construct the client with a larger `timeoutMs` for this
+   * call, or use {@link LlmResource.structuredJob}.
+   */
+  structured(input) {
+    return this.client.request("POST", "/v1/llm/structured", { body: input });
+  }
+  /**
+   * The same call as a job (`POST /v1/llm/structured/jobs`): answers `{ jobId }`
+   * at once. Poll `jobs.getStatus(jobId)` — `output_data` is an
+   * {@link LlmStructuredJobOutput}; `error_message` says why a run failed.
+   * `jobs.list({ type: "llm-structured", origin })` finds every run later.
+   * Throws `NotFoundError` on a platform that predates the route. An instance
+   * that proxies its LLM calls to nodaro.ai answers `503 provider_unavailable`
+   * permanently — the SDK surfaces that as a generic `NodaroError` with the
+   * same code; treat it as unavailable here, not as transient.
+   */
+  structuredJob(input) {
+    return this.client.request("POST", "/v1/llm/structured/jobs", { body: input });
+  }
+};
+
 // src/resources/media.ts
 var MediaResource = class {
   constructor(client) {
@@ -1942,6 +1980,16 @@ var MediaResource = class {
   videoMetadata(input) {
     return this.client.request("POST", "/v1/video-metadata", { body: input });
   }
+  /**
+   * Cut or crop a stored file (`POST /v1/media/process`) — synchronous and
+   * free, the source-preparation sibling of the priced `trimVideo` node.
+   * `trim` is `[startTime, endTime]` in seconds; `deleteSource: true` removes
+   * the source object afterwards when it is yours and nothing else references
+   * it ("the cut replaces the original"). Answers the stored file.
+   */
+  process(input) {
+    return this.client.request("POST", "/v1/media/process", { body: input });
+  }
 };
 
 // src/resources/audio.ts
@@ -2543,6 +2591,23 @@ var OrganizationsResource = class {
   audit(orgId, opts = {}) {
     return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/audit`, { query: { ...opts } });
   }
+  // -- usage ----------------------------------------------------------------
+  /**
+   * Credits by workspace, member, model or day. Owner and org admins only.
+   * Inclusive dates (`from`/`to`), IANA `tz` (default UTC), ≤ 366 days
+   * (default last 30).
+   */
+  usage(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts } });
+  }
+  /** The individual runs behind a report, newest first, cursor-paged. */
+  usageRows(orgId, opts = {}) {
+    return this.client.request("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, groupBy: "none" } });
+  }
+  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+  usageCsv(orgId, opts = {}) {
+    return this.client.requestText("GET", `/v1/orgs/${encodeURIComponent(orgId)}/usage`, { query: { ...opts, format: "csv" } });
+  }
 };
 
 // src/resources/workspaces.ts
@@ -2634,8 +2699,26 @@ var WorkspacesResource = class {
   join(code) {
     return this.client.request("POST", "/v1/workspaces/join", { body: { code } });
   }
+  // -- usage ----------------------------------------------------------------
+  /**
+   * Credits by member, model or day for this workspace. A plain member sees
+   * their OWN runs (the report is self-narrowed and `groupBy: "member"` is
+   * refused); a workspace admin sees everyone and may filter `userId`.
+   * Inclusive dates, IANA `tz` (default UTC), ≤ 366 days (default last 30).
+   */
+  usage(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts } });
+  }
+  /** The individual runs behind a report, newest first, cursor-paged. */
+  usageRows(id, opts = {}) {
+    return this.client.request("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, groupBy: "none" } });
+  }
+  /** The same report (or the rows, with `groupBy: "none"`) as CSV text. */
+  usageCsv(id, opts = {}) {
+    return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
+  }
 };
-var SDK_VERSION = "1.25.0" ;
+var SDK_VERSION = "1.27.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -2673,6 +2756,7 @@ var NodaroClient = class _NodaroClient {
   reduce;
   promptHelper;
   voices;
+  llm;
   media;
   audio;
   credits;
@@ -2716,6 +2800,7 @@ var NodaroClient = class _NodaroClient {
     this.reduce = new ReduceResource(this);
     this.promptHelper = new PromptHelperResource(this);
     this.voices = new VoicesResource(this);
+    this.llm = new LlmResource(this);
     this.media = new MediaResource(this);
     this.audio = new AudioResource(this);
     this.credits = new CreditsResource(this);
@@ -2754,7 +2839,14 @@ var NodaroClient = class _NodaroClient {
       ...workspaceId ? { workspaceId } : {}
     });
   }
-  async request(method, path, options = {}) {
+  /**
+   * The transport: build the request, send it, throw the typed error on a
+   * non-2xx via {@link throwFromResponse}, then read the body via `read` — all
+   * inside the abort timer, so `timeoutMs` bounds the body download too (a
+   * stalled CSV stream aborts, it does not hang forever). Both the JSON path
+   * ({@link request}) and the text path ({@link requestText}) go through here.
+   */
+  async send(method, path, options, read) {
     const url = this.buildUrl(path, options.query);
     const token = await this.auth.getToken();
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
@@ -2787,12 +2879,30 @@ var NodaroClient = class _NodaroClient {
         }
         throwFromResponse(res.status, errBody);
       }
-      if (res.status === 204) return void 0;
-      return await res.json();
+      return await read(res);
     } finally {
       clearTimeout(timeoutId);
     }
   }
+  async request(method, path, options = {}) {
+    return this.send(
+      method,
+      path,
+      options,
+      async (res) => (
+        // 204 No Content
+        res.status === 204 ? void 0 : await res.json()
+      )
+    );
+  }
+  /**
+   * Like {@link request}, for endpoints that answer text (CSV exports). Errors
+   * are still the JSON envelope and throw the same typed errors, and the read is
+   * bounded by the same timeout as the request.
+   */
+  async requestText(method, path, options = {}) {
+    return this.send(method, path, options, (res) => res.text());
+  }
   /**
    * `GET /v1/me` → the authenticated user's identity (see {@link UserIdentity}).
    * Unwraps the `{ data }` envelope. Throws `UnauthorizedError` (401) when the
@@ -2856,6 +2966,6 @@ function supabaseAuth(supabase) {
   };
 }
 
-export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, ShotsResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
+export { AppsResource, AudioResource, CREATURE_ASSET_TYPES, CallbackAuth, CatalogsResource, CharactersResource, CommunityResource, CreaturesResource, CreditsResource, DeveloperAppsResource, ExecutionsResource, ForbiddenError, InsufficientCreditsError, JobAbortedError, JobFailedError, JobTimeoutError, JobsResource, LibraryResource, LlmResource, LocationsResource, MediaResource, ModelsResource, NodaroClient, NodaroError, NodesResource, NotFoundError, OAuthResource, ObjectsResource, OrganizationsResource, PickerCatalogsResource, PipelinesResource, PresetsResource, ProjectsResource, PromptHelperResource, RateLimitedError, RecastResource, ReduceResource, ShotsResource, StaticTokenAuth, StorageExceededError, TemplatesResource, TutorialsResource, UnauthorizedError, UploadsResource, VideoProResource, VoicesResource, WorkflowConflictError, WorkflowsResource, WorkspacesResource, buildPersonSeedPrompt, createClient, supabaseAuth, throwFromResponse };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map