@byte_fluffy/nexra-sdk 0.1.0-alpha.5 → 0.1.0-alpha.50

package/dist/media-DzOxLGs-.d.ts

@@ -0,0 +1,343 @@
+import { a as JsonObject } from './json-Cz0MkWQn.js';
+
+declare const MEDIA_KINDS: readonly ["image", "video", "audio", "document", "archive", "other"];
+type MediaKind = (typeof MEDIA_KINDS)[number];
+type MediaAssetStatus = "pending" | "ready" | "failed" | "deleted";
+interface MediaAsset {
+    id: string;
+    kind: MediaKind;
+    status: MediaAssetStatus;
+    source: "upload" | "generated" | "provider" | "imported";
+    name?: string;
+    mimeType?: string;
+    sizeBytes?: number;
+    width?: number;
+    height?: number;
+    durationMs?: number;
+    checksumSha256?: string;
+    url?: string;
+    downloadUrl?: string;
+    expiresAt?: string;
+    metadata?: JsonObject;
+    createdAt: string;
+}
+interface AssetReference {
+    assetId: string;
+}
+type AssetInput = AssetReference | Blob | File | MediaAsset | string | URL;
+interface AssetUploadOptions {
+    kind?: MediaKind;
+    name?: string;
+    signal?: AbortSignal;
+}
+interface AssetImportRequest {
+    url: string;
+    kind?: MediaKind;
+    name?: string;
+}
+type AssetCertificationProvider = "seedance";
+type AssetCertificationStatus = "processing" | "ready" | "failed";
+interface AssetCertification {
+    assetId: string;
+    provider: AssetCertificationProvider;
+    status: AssetCertificationStatus;
+    providerAssetId?: string;
+    assetUri?: string;
+    groupId?: string;
+    library: "general" | "liveness";
+    error?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface AssetCertificationRequest {
+    library?: "general" | "liveness";
+}
+interface AssetCertificationWaitOptions {
+    pollIntervalMs?: number;
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+
+declare const NEXRA_MEDIA_API_VERSION: 1;
+/** Catalog-level generation taxonomy. Text keeps its native endpoint protocols. */
+declare const NEXRA_GENERATION_OPERATIONS: readonly ["text.generate", "image.generate", "video.generate", "audio.generate", "audio.transcribe", "image.upscale", "video.upscale", "video.depth", "video.segment"];
+type NexraGenerationOperation = (typeof NEXRA_GENERATION_OPERATIONS)[number];
+declare const NEXRA_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "audio.transcribe", "image.upscale", "video.upscale", "video.depth", "video.segment"];
+type NexraMediaOperation = (typeof NEXRA_MEDIA_OPERATIONS)[number];
+declare const NEXRA_PUBLISHED_MEDIA_OPERATIONS: readonly ["image.generate", "video.generate", "audio.generate", "audio.transcribe", "image.upscale", "video.upscale", "video.depth", "video.segment"];
+type NexraPublishedMediaOperation = (typeof NEXRA_PUBLISHED_MEDIA_OPERATIONS)[number];
+declare const NEXRA_MEDIA_FEATURES: readonly ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control", "text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference", "asr", "tts", "music", "sfx", "voice-reference", "voice-design", "scale-factor", "target-resolution", "video-depth", "video-segment"];
+type NexraMediaFeature = (typeof NEXRA_MEDIA_FEATURES)[number];
+/** JSON wire locator. SDK-only Blob/File support is normalized into one of these forms. */
+type NexraMediaSource = string | AssetReference;
+type NexraTextRole = "prompt" | "negative_prompt" | "script" | "lyrics";
+type NexraImageRole = "source" | "reference" | "first_frame" | "middle_frame" | "last_frame" | "mask" | "control" | "subject" | "background";
+type NexraVideoRole = "source" | "reference" | "edit" | "extend";
+type NexraAudioRole = "source" | "reference" | "voice_reference";
+type NexraTextContentPart = Readonly<{
+    type: "text";
+    text: string;
+    role?: NexraTextRole;
+}>;
+type NexraImageContentPart = Readonly<{
+    type: "image";
+    source: NexraMediaSource;
+    role?: NexraImageRole;
+    /** Stable prompt reference name for models that address media as `@name`. */
+    name?: string;
+}>;
+/** An image pinned inside a generated video; only models declaring this role accept it. */
+type NexraVideoKeyframeContentPart = Readonly<{
+    type: "image";
+    source: NexraMediaSource;
+    role: "keyframe";
+    /** Position in seconds, strictly inside the generated clip. */
+    timestamp: number;
+}>;
+type NexraVideoContentPart = Readonly<{
+    type: "video";
+    source: NexraMediaSource;
+    role?: NexraVideoRole;
+    name?: string;
+}>;
+type NexraAudioContentPart = Readonly<{
+    type: "audio";
+    source: NexraMediaSource;
+    role?: NexraAudioRole;
+}>;
+type NexraResourceContentPart = Readonly<{
+    type: "resource";
+    resource: "element" | "voice";
+    source: string;
+    name: string;
+}>;
+type NexraMediaContentPart = NexraResourceContentPart | NexraTextContentPart | NexraImageContentPart | NexraVideoContentPart | NexraAudioContentPart;
+type NexraDraftContentPart = Readonly<{
+    type: "draft_task";
+    draft_task: Readonly<{
+        id: string;
+    }>;
+}>;
+type NexraImageGenerateInput = Readonly<{
+    content: readonly (NexraTextContentPart | NexraImageContentPart)[];
+    output_mode?: "image" | "layers";
+    prompt_optimization?: "standard" | "fast";
+    aspect_ratio?: string;
+    resolution?: string;
+    quality?: string;
+    count?: number;
+    output_format?: string;
+    seed?: number;
+}>;
+type NexraImageLayer = Readonly<{
+    image_index: number;
+    z_index: number;
+    size: string;
+    name?: string;
+    description?: string;
+    output_format?: string;
+    bounding_box?: Readonly<{
+        absolute: readonly [number, number, number, number];
+        normalized: readonly [number, number, number, number];
+    }>;
+}>;
+type NexraImageLayerDecompositionOutput = Readonly<{
+    images: readonly string[];
+    layer_decomposition: Readonly<{
+        layers: readonly NexraImageLayer[];
+    }>;
+}>;
+type NexraVideoGenerateInput = Readonly<{
+    content: readonly (NexraMediaContentPart | NexraDraftContentPart | NexraVideoKeyframeContentPart)[];
+    task_type?: string;
+    draft?: boolean;
+    /** Explicit no-watermark value, only on models whose contract declares it. */
+    watermark?: false;
+    /** Optional preset or cloned voice used by talking-avatar video models. */
+    voice?: string;
+    aspect_ratio?: string;
+    resolution?: string;
+    quality?: string;
+    duration?: number;
+    fit?: "contain" | "cover";
+    title?: string;
+    generate_audio?: boolean;
+    output_format?: string;
+    seed?: number;
+}>;
+type NexraAudioGenerateInput = Readonly<{
+    content: readonly (NexraTextContentPart | NexraAudioContentPart)[];
+    voice?: string;
+    language?: string;
+    duration?: number;
+    output_format?: string;
+    sample_rate?: number;
+    speed?: number;
+    volume?: number;
+    pitch?: number;
+    emotion?: string;
+    instrumental?: boolean;
+    loop?: boolean;
+    prompt_influence?: number;
+    seed?: number;
+}>;
+type NexraAudioTranscribeInput = Readonly<{
+    content: readonly [NexraAudioContentPart];
+    language?: string;
+    input_format: string;
+    punctuate?: boolean;
+    diarize?: boolean;
+    timestamps?: boolean;
+}>;
+type NexraImageUpscaleInput = Readonly<{
+    content: readonly [NexraImageContentPart];
+    enable_hdr?: boolean;
+    enable_wb?: boolean;
+    scale?: number;
+    resolution?: string;
+    output_format?: string;
+    preserve_details?: boolean;
+}>;
+type NexraVideoUpscaleInput = Readonly<{
+    source_duration: number;
+    config?: string;
+    scale?: number;
+    resolution?: string;
+    output_format?: string;
+    preserve_details?: boolean;
+}> & (Readonly<{
+    content: readonly [NexraVideoContentPart];
+    vid?: never;
+}> | Readonly<{
+    vid: string;
+    content?: never;
+}>);
+type NexraVideoDepthInput = Readonly<{
+    content: readonly [NexraVideoContentPart];
+    resolution?: string;
+}>;
+type NexraVideoSegmentInput = Readonly<{
+    content: readonly [NexraVideoContentPart, NexraTextContentPart] | readonly [NexraTextContentPart, NexraVideoContentPart];
+    resolution?: string;
+}>;
+type NexraMediaInputByOperation = Readonly<{
+    "image.generate": NexraImageGenerateInput;
+    "video.generate": NexraVideoGenerateInput;
+    "audio.generate": NexraAudioGenerateInput;
+    "audio.transcribe": NexraAudioTranscribeInput;
+    "image.upscale": NexraImageUpscaleInput;
+    "video.upscale": NexraVideoUpscaleInput;
+    "video.depth": NexraVideoDepthInput;
+    "video.segment": NexraVideoSegmentInput;
+}>;
+type NexraMediaKind = "image" | "video" | "audio";
+type NexraMediaInputSlot = Readonly<{
+    mediaKind: NexraMediaKind;
+    role: string;
+    min?: number;
+    max: number;
+    maxBytes?: number;
+    minDurationSeconds?: number;
+    maxDurationSeconds?: number;
+}>;
+type NexraMediaInputMode = Readonly<{
+    id: string;
+    slots: readonly NexraMediaInputSlot[];
+}>;
+type NexraMediaParameterValue = string | number | boolean;
+type NexraMediaParameter = Readonly<{
+    key: string;
+    label?: string;
+}> & (Readonly<{
+    kind: "enum";
+    options: readonly NexraMediaParameterValue[];
+    default: NexraMediaParameterValue;
+    allowCustom?: boolean;
+}> | Readonly<{
+    kind: "range";
+    min: number;
+    max: number;
+    step: number;
+    default: number;
+    autoValue?: number;
+    unit?: string;
+}> | Readonly<{
+    kind: "toggle";
+    default: boolean;
+}> | Readonly<{
+    kind: "resource";
+    resource: "voice";
+    default?: string;
+    allowCustom?: boolean;
+}>);
+type NexraMediaParameterConstraint = Readonly<{
+    when: Readonly<Record<string, NexraMediaParameterValue | readonly NexraMediaParameterValue[]>>;
+    parameter: string;
+    allowedValues?: readonly NexraMediaParameterValue[];
+    fixedValue?: NexraMediaParameterValue;
+    disabled?: boolean;
+}>;
+type NexraMediaOperationDefinition = Readonly<{
+    operation: NexraMediaOperation;
+    status: "active" | "hold";
+    outputKind: NexraMediaKind | "text";
+    features: readonly NexraMediaFeature[];
+    parameterKeys: readonly string[];
+}>;
+declare const NEXRA_MEDIA_OPERATION_DEFINITIONS: readonly [{
+    readonly operation: "image.generate";
+    readonly status: "active";
+    readonly outputKind: "image";
+    readonly features: readonly ["text-to-image", "image-to-image", "image-reference", "image-edit", "image-inpaint", "image-control"];
+    readonly parameterKeys: readonly ["aspect_ratio", "resolution", "quality", "count", "output_format", "seed", "output_mode", "prompt_optimization"];
+}, {
+    readonly operation: "video.generate";
+    readonly status: "active";
+    readonly outputKind: "video";
+    readonly features: readonly ["text-to-video", "first-frame", "first-last-frame", "image-to-video", "video-to-video", "audio-to-video", "avatar-video", "reference-image", "reference-video", "reference-audio", "omni-reference"];
+    readonly parameterKeys: readonly ["voice", "aspect_ratio", "resolution", "quality", "duration", "fit", "title", "generate_audio", "output_format", "seed", "watermark"];
+}, {
+    readonly operation: "audio.generate";
+    readonly status: "active";
+    readonly outputKind: "audio";
+    readonly features: readonly ["tts", "music", "sfx", "voice-reference", "voice-design"];
+    readonly parameterKeys: readonly ["voice", "language", "duration", "output_format", "sample_rate", "speed", "volume", "pitch", "emotion", "instrumental", "loop", "prompt_influence", "seed"];
+}, {
+    readonly operation: "audio.transcribe";
+    readonly status: "active";
+    readonly outputKind: "text";
+    readonly features: readonly ["asr"];
+    readonly parameterKeys: readonly ["input_format", "language", "punctuate", "diarize", "timestamps"];
+}, {
+    readonly operation: "image.upscale";
+    readonly status: "active";
+    readonly outputKind: "image";
+    readonly features: readonly ["scale-factor", "target-resolution"];
+    readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];
+}, {
+    readonly operation: "video.upscale";
+    readonly status: "active";
+    readonly outputKind: "video";
+    readonly features: readonly ["scale-factor", "target-resolution"];
+    readonly parameterKeys: readonly ["scale", "resolution", "output_format", "preserve_details"];
+}, {
+    readonly operation: "video.depth";
+    readonly status: "active";
+    readonly outputKind: "video";
+    readonly features: readonly ["video-depth"];
+    readonly parameterKeys: readonly ["resolution"];
+}, {
+    readonly operation: "video.segment";
+    readonly status: "active";
+    readonly outputKind: "video";
+    readonly features: readonly ["video-segment"];
+    readonly parameterKeys: readonly ["resolution"];
+}];
+declare const NEXRA_MEDIA_INPUT_SCHEMAS: Readonly<Record<NexraPublishedMediaOperation, JsonObject>>;
+declare function nexraMediaInputSchema(operation: NexraMediaOperation): JsonObject | undefined;
+declare function isNexraMediaInput(value: unknown): value is JsonObject;
+declare function nexraMediaOperationForMode(mode: string): NexraPublishedMediaOperation | undefined;
+/** Narrow the shared category vocabulary for one Experience Center input mode. */
+declare function nexraMediaInputSchemaForMode(mode: string): JsonObject | undefined;
+
+export { type AssetImportRequest as A, type NexraMediaInputByOperation as B, type NexraMediaInputMode as C, type NexraMediaInputSlot as D, type NexraMediaKind as E, type NexraMediaOperation as F, type NexraMediaOperationDefinition as G, type NexraMediaParameter as H, type NexraMediaParameterConstraint as I, type NexraMediaSource as J, type NexraPublishedMediaOperation as K, type NexraResourceContentPart as L, MEDIA_KINDS as M, type NexraImageLayer as N, type NexraTextContentPart as O, type NexraVideoContentPart as P, type NexraVideoDepthInput as Q, type NexraVideoGenerateInput as R, type NexraVideoKeyframeContentPart as S, type NexraVideoUpscaleInput as T, isNexraMediaInput as U, nexraMediaInputSchema as V, nexraMediaInputSchemaForMode as W, nexraMediaOperationForMode as X, type AssetInput as a, type AssetReference as b, type AssetUploadOptions as c, type MediaAsset as d, type MediaAssetStatus as e, type MediaKind as f, type NexraImageLayerDecompositionOutput as g, type AssetCertificationRequest as h, type AssetCertification as i, type AssetCertificationWaitOptions as j, NEXRA_GENERATION_OPERATIONS as k, NEXRA_MEDIA_API_VERSION as l, NEXRA_MEDIA_FEATURES as m, NEXRA_MEDIA_INPUT_SCHEMAS as n, NEXRA_MEDIA_OPERATIONS as o, NEXRA_MEDIA_OPERATION_DEFINITIONS as p, NEXRA_PUBLISHED_MEDIA_OPERATIONS as q, type NexraAudioContentPart as r, type NexraAudioGenerateInput as s, type NexraAudioTranscribeInput as t, type NexraGenerationOperation as u, type NexraImageContentPart as v, type NexraImageGenerateInput as w, type NexraImageUpscaleInput as x, type NexraMediaContentPart as y, type NexraMediaFeature as z };

package/dist/{index-FyUOK0F-.d.ts → media-geometry-COln1N_2.d.ts}

@@ -1,37 +1,7 @@
-type JsonPrimitive = boolean | number | string | null;
-type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
-interface JsonObject {
-    [key: string]: JsonValue;
-}
-interface CursorPage<T> {
-    data: T[];
-    nextCursor?: string;
-}
+import { b as JsonPrimitive, a as JsonObject, J as JsonValue } from './json-Cz0MkWQn.js';
 
 declare const BILLING_METRICS: readonly ["requests", "input_tokens", "cached_input_tokens", "cache_write_tokens", "cache_creation_5m_input_tokens", "cache_creation_1h_input_tokens", "cache_read_input_tokens", "output_tokens", "input_characters", "input_utf8_bytes", "input_images", "output_images", "input_audio_seconds", "output_audio_seconds", "input_video_seconds", "output_video_seconds", "provider_credits", "web_search_requests"];
 type BillingMetric = (typeof BILLING_METRICS)[number];
-declare const BILLING_EXPORT_DIMENSIONS: readonly ["resolution", "duration", "layer_decomposition", "with_audio", "has_input_video", "hd", "prompt_extend", "modality", "tier", "quality", "image_count", "input_token_tier", "input_modality", "service_tier", "inference_geo", "speed", "region_scope", "has_reference_image", "mode"];
-type UsageComponentEvidence = {
-    source: "provider_native" | "request_derived" | "response_derived" | "tariff_equivalent" | "unknown";
-    paths?: string[];
-    calculation?: string;
-};
-interface MeteredUsageComponent {
-    metric: BillingMetric;
-    quantity: number;
-    dimensions?: Record<string, JsonPrimitive>;
-    evidence?: UsageComponentEvidence;
-}
-/**
- * Provider evidence is normalized into independent metered components instead
- * of one canonical model response. This keeps protocol conversion separate
- * from billing and allows one request to carry differently-dimensioned usage.
- */
-interface NormalizedUsageV1 {
-    schemaVersion: 1;
-    components: MeteredUsageComponent[];
-    billingEvidenceComplete?: boolean;
-}
 interface MeteredPriceRate {
     metric: BillingMetric;
     unitSize: number;
@@ -46,42 +16,8 @@ interface MeteredPriceRuleV1 {
     rates: MeteredPriceRate[];
 }
 type PriceRule = MeteredPriceRuleV1;
-interface PriceEvaluationLine {
-    evidence?: UsageComponentEvidence;
-    metric: BillingMetric;
-    quantity: number;
-    unitSize: number;
-    unitPrice: string;
-    rounding: "proportional" | "ceil";
-    includedQuantity: number;
-    dimensions?: Record<string, JsonPrimitive>;
-    amount: string;
-    discountedAmount?: string;
-}
-/** Preserve frozen row order when distributing the eight-decimal remainder. */
-declare function allocateDiscountedPriceLines(lines: readonly PriceEvaluationLine[], saleAmount: string): PriceEvaluationLine[];
-interface PriceEvaluationIssue {
-    code: "dimension_mismatch" | "ambiguous_rate" | "missing_usage";
-    metric: BillingMetric;
-    componentIndex: number;
-}
-interface PriceEvaluation {
-    status: "rated" | "incomplete";
-    amount: string;
-    lines: PriceEvaluationLine[];
-    issues: PriceEvaluationIssue[];
-}
-declare function validateNormalizedUsage(value: unknown): asserts value is NormalizedUsageV1;
-/**
- * Deterministically rates normalized usage without mutating wallets or billing
- * records. Amounts are rounded half-up to the database's eight-decimal money
- * scale per line; ceil rates round usage units before multiplying the price.
- */
-declare function evaluatePriceRule(ruleValue: unknown, usageValue: unknown): PriceEvaluation;
-declare function validatePriceRule(value: unknown): asserts value is PriceRule;
 
 type MeteringKind = "token" | "non_token" | "mixed";
-type UsageEvidenceStatus = "complete" | "partial" | "missing" | "invalid" | "not_expected";
 interface MeteringContract {
     schemaVersion: 1;
     kind: MeteringKind;
@@ -91,19 +27,33 @@ interface MeteringContract {
         whenFeature?: string;
     }>;
 }
-interface UsageEvidenceAssessment {
-    kind: MeteringKind | "unknown";
-    evidenceStatus: UsageEvidenceStatus;
-    expectedMetrics: BillingMetric[];
-    observedMetrics: BillingMetric[];
-    missingMetrics: BillingMetric[];
-    issues: string[];
-}
-declare function validateMeteringContract(value: unknown): asserts value is MeteringContract;
-/** Evidence completeness is independent of sale/cost prices and delivery success. */
-declare function assessUsageEvidence(contract: unknown, usage: unknown, features?: Readonly<Record<string, boolean>>): UsageEvidenceAssessment;
 
 type ModelModality = "language" | "embedding" | "reranker" | "image" | "video" | "audio" | "world" | "multimodal" | "other";
+/** A concrete operation of a code-owned endpoint contract, shared by API and UI. */
+type ModelHttpOperation = Readonly<{
+    key: string;
+    transport?: "http" | "websocket";
+    kind: "request" | "create" | "query" | "cancel" | "delete" | "stream" | "generate" | "edit";
+    httpMethod: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    pathTemplate: string;
+    documentationUrl?: string;
+    schemaProjection: "request" | "bearer-request" | "managed-task-create" | "managed-task-query" | "managed-task-cancel" | "native-task-create" | "native-task-query" | "native-task-delete";
+    responseStatus?: number;
+    idempotencyKey?: boolean;
+    queryParameters?: Readonly<JsonObject>;
+    headerParameters?: Readonly<JsonObject>;
+    pathParameters?: Readonly<JsonObject>;
+    /** Operation-specific body; binary fields describe multipart file parts. */
+    bodyParameters?: Readonly<JsonObject>;
+    /** Initial JSON configuration carried by a WebSocket message, not a GET body. */
+    messageParameters?: Readonly<JsonObject>;
+    responseBody?: Readonly<JsonObject>;
+    requestBody?: Readonly<{
+        properties: readonly string[];
+        required: readonly string[];
+        oneOfRequired?: readonly (readonly string[])[];
+    }>;
+}>;
 interface ModelEndpointSummary {
     key: string;
     label: string;
@@ -114,6 +64,8 @@ interface ModelEndpointSummary {
     capabilities: string[];
     /** Task execution of this native endpoint, not a second model parameter definition. */
     sourceEndpointKey?: string | null;
+    documentationUrl?: string;
+    httpOperations?: readonly ModelHttpOperation[];
 }
 interface ModelCapabilitySummary {
     inputModalities: string[];
@@ -121,6 +73,10 @@ interface ModelCapabilitySummary {
     /** User-facing input patterns such as text-to-video or image-to-image. */
     inputModes: string[];
     features: string[];
+    /** Maximum combined input and output context supported by the model. */
+    contextWindowTokens?: number;
+    /** Maximum generated output tokens supported by the model. */
+    maxOutputTokens?: number;
 }
 interface ModelDateVersion {
     id: string;
@@ -156,6 +112,8 @@ interface TaskModelSummary {
 }
 interface TaskModel extends TaskModelSummary {
     description?: string;
+    /** Code-owned contracts for documentation; endpoints remains executable supply only. */
+    documentedEndpoints?: ModelEndpointSummary[];
     regions: string[];
     metadata?: JsonObject;
     /** Public list and customer-facing sale prices. Channel costs are never exposed here. */
@@ -181,6 +139,8 @@ interface TaskModel extends TaskModelSummary {
 interface ModelSchema {
     model: string;
     version: number;
+    /** Contract owner for the returned schema. Defaults to nexra for older servers. */
+    contract?: "nexra" | "native";
     dialect: "https://json-schema.org/draft/2020-12/schema" | string;
     inputSchema: JsonObject;
     outputSchema: JsonObject;
@@ -228,6 +188,18 @@ interface NexraModelOperation {
     outputSchema: JsonObject;
     metering: MeteringContract;
 }
+/** Public native wire endpoint metadata. Provider routing and credentials stay private. */
+interface NexraModelEndpointSpec {
+    endpointKey: string;
+    operation: string;
+    protocol: string;
+    method: string;
+    path: string;
+    capabilities: readonly string[];
+    inputSchema?: JsonObject;
+    outputSchema?: JsonObject;
+    httpOperations?: readonly ModelHttpOperation[];
+}
 interface NexraModelSpec {
     id: string;
     contractVersion: number;
@@ -240,6 +212,7 @@ interface NexraModelSpec {
     aliases: readonly string[];
     capabilities: ModelCapabilitySummary;
     operations: readonly NexraModelOperation[];
+    endpoints: readonly NexraModelEndpointSpec[];
 }
 interface NexraModelSpecFilter {
     kind?: ModelModality;
@@ -252,12 +225,32 @@ interface NexraSalePrice {
     priceRevision: string;
     effectiveFrom: string;
     rule: PriceRule;
+    displayEstimates?: readonly Readonly<{
+        parameters: JsonObject;
+        inputImageCounts: readonly number[];
+        amount: string;
+        maximumAmount: string;
+    }>[];
+    displayEstimatesValidUntil?: string;
+}
+interface NexraSalePriceList {
+    quoteContextRevision?: string;
+    currency: NexraBillingCurrency;
+    prices: readonly NexraSalePrice[];
 }
 interface CreateNexraQuoteRequest {
     modelId: string;
     operation: string;
     input: JsonObject;
 }
+interface CreateNexraDisplayQuoteBatchRequest {
+    modelId: string;
+    operation: string;
+    entries: readonly Readonly<{
+        key: string;
+        input: JsonObject;
+    }>[];
+}
 interface NexraQuote {
     quoteToken: string;
     modelId: string;
@@ -269,6 +262,53 @@ interface NexraQuote {
     accuracy: "exact" | "estimated";
     expiresAt: string;
 }
+type NexraDisplayQuoteBatchEntry = Readonly<{
+    key: string;
+    amount: string;
+    maximumAmount: string;
+    accuracy: "exact" | "estimated";
+}> | Readonly<{
+    key: string;
+    error: {
+        code: string;
+        message: string;
+    };
+}>;
+interface NexraDisplayQuoteBatch {
+    modelId: string;
+    contractVersion: number;
+    priceRevision: string;
+    pricingPolicyRevision: string;
+    quoteContextRevision: string;
+    currency: NexraBillingCurrency;
+    entries: readonly NexraDisplayQuoteBatchEntry[];
+    expiresAt: string;
+}
+interface NexraCatalogRevision {
+    revision: string;
+    changedAt: string;
+}
+interface NexraCatalogModelIdentity {
+    modelId: string;
+    operation: string;
+    revision: string;
+    available: boolean;
+}
+interface NexraCatalogChangeParams {
+    after?: string;
+    upper?: string;
+    cursor?: string;
+    limit?: number;
+}
+interface NexraCatalogChangePage extends NexraCatalogRevision {
+    data: readonly NexraCatalogModelIdentity[];
+    nextCursor?: string;
+}
+interface NexraCatalogModelState extends NexraCatalogModelIdentity {
+    displayName?: string;
+    inputSchema?: JsonObject;
+    prices: readonly NexraSalePrice[];
+}
 interface NexraSettlement {
     amount: string;
     currency: NexraBillingCurrency;
@@ -298,11 +338,8 @@ declare class HttpTransport {
     json<T>(path: string, init?: RequestInit, options?: RequestOptions): Promise<T>;
     response(path: string, init?: RequestInit, options?: RequestOptions): Promise<Response>;
 }
-declare function jsonBody(value: unknown): Pick<RequestInit, "body" | "headers">;
-declare function queryString(values: Record<string, string | number | undefined>): string;
-declare function sleep(milliseconds: number, signal?: AbortSignal | null): Promise<void>;
 
-/** Unified canvas vocabulary: resolution 1K/2K/4K, ratio X:X. */
+/** UI-friendly view of Nexra's canonical geometry fields. */
 type UnifiedMediaGeometry = {
     resolution?: string;
     ratio?: string;
@@ -310,35 +347,23 @@ type UnifiedMediaGeometry = {
 };
 type MediaGeometryField = {
     field: string;
-    nest?: string;
     options: readonly string[];
     default?: string;
     optionLabels: Readonly<Record<string, string>>;
 };
 type MediaGeometryProjection = {
-    kind: "pixel-size" | "tier-size" | "resolution-ratio" | "ratio-only" | "none";
+    kind: "resolution-ratio" | "ratio-only" | "none";
     resolution?: MediaGeometryField;
     ratio?: MediaGeometryField;
     quality?: MediaGeometryField;
 };
-/** Schema → unified resolution/ratio/quality controls for app UIs. */
+/** Read controls from the Nexra contract. It never exposes provider-native size fields. */
 declare function projectMediaGeometry(inputSchema: JsonObject): MediaGeometryProjection;
-/** Unified geometry → the model's native catalog fields (channel original params). */
+/** UI geometry aliases → canonical Nexra request fields. */
 declare function encodeMediaGeometry(inputSchema: JsonObject, geometry: UnifiedMediaGeometry): JsonObject;
-/** Native catalog fields → unified resolution/ratio/quality. */
-declare function decodeMediaGeometry(inputSchema: JsonObject, nativeInput: JsonObject): UnifiedMediaGeometry;
-/**
- * Rewrite a Task/quote body: unified keys become native catalog fields.
- * Native size/ratio already present is left alone (existing callers keep working).
- */
+/** Canonical Nexra request fields → UI geometry aliases. */
+declare function decodeMediaGeometry(_inputSchema: JsonObject, input: JsonObject): UnifiedMediaGeometry;
+/** Normalize the SDK convenience alias `ratio` without producing Native fields. */
 declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject): JsonObject;
 
-declare class CatalogClient {
-    private readonly transport;
-    constructor(transport: HttpTransport);
-    quote(request: CreateNexraQuoteRequest, signal?: AbortSignal): Promise<NexraQuote>;
-}
-declare function getModelSpec(modelId: string): NexraModelSpec | undefined;
-declare function listModelSpecs(filter?: NexraModelSpecFilter): readonly NexraModelSpec[];
-
-export { listModelSpecs as $, type NexraQuote as A, type BillingMetric as B, type CursorPage as C, type NexraSalePrice as D, type NormalizedUsageV1 as E, type FetchLike as F, type PriceEvaluationIssue as G, HttpTransport as H, type PriceEvaluationLine as I, type JsonObject as J, type PriceRule as K, type UsageComponentEvidence as L, type ModelSchema as M, type NexraSettlement as N, type UsageEvidenceAssessment as O, type PriceEvaluation as P, type UsageEvidenceStatus as Q, allocateDiscountedPriceLines as R, applyMediaGeometry as S, type TaskModelSummary as T, type UnifiedMediaGeometry as U, assessUsageEvidence as V, decodeMediaGeometry as W, encodeMediaGeometry as X, evaluatePriceRule as Y, getModelSpec as Z, jsonBody as _, type JsonValue as a, projectMediaGeometry as a0, queryString as a1, sleep as a2, validateMeteringContract as a3, validateNormalizedUsage as a4, validatePriceRule as a5, type ModelSearchParams as b, type TaskModel as c, CatalogClient as d, type NexraClientOptions as e, BILLING_EXPORT_DIMENSIONS as f, BILLING_METRICS as g, type CreateNexraQuoteRequest as h, type JsonPrimitive as i, type MediaGeometryField as j, type MediaGeometryProjection as k, type MeteredPriceRate as l, type MeteredPriceRuleV1 as m, type MeteredUsageComponent as n, type MeteringContract as o, type MeteringKind as p, type ModelCapabilitySummary as q, type ModelDateVersion as r, type ModelEndpointSummary as s, type ModelModality as t, type ModelResourceList as u, type ModelResourceOption as v, type NexraBillingCurrency as w, type NexraModelOperation as x, type NexraModelSpec as y, type NexraModelSpecFilter as z };
+export { type ModelDateVersion as A, type ModelEndpointSummary as B, type CreateNexraQuoteRequest as C, type ModelModality as D, type ModelResourceOption as E, type FetchLike as F, type NexraDisplayQuoteBatchEntry as G, HttpTransport as H, type MediaGeometryField as M, type NexraCatalogChangeParams as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type NexraCatalogChangePage as a, type NexraCatalogModelState as b, type NexraSalePriceList as c, type NexraQuote as d, type CreateNexraDisplayQuoteBatchRequest as e, type NexraDisplayQuoteBatch as f, type NexraCatalogRevision as g, type NexraModelSpec as h, type NexraModelEndpointSpec as i, type NexraModelSpecFilter as j, type MediaGeometryProjection as k, type NexraBillingCurrency as l, type NexraCatalogModelIdentity as m, type NexraModelOperation as n, type NexraSalePrice as o, type NexraSettlement as p, applyMediaGeometry as q, decodeMediaGeometry as r, encodeMediaGeometry as s, projectMediaGeometry as t, type ModelSearchParams as u, type TaskModel as v, type ModelSchema as w, type ModelResourceList as x, type NexraClientOptions as y, type ModelCapabilitySummary as z };

package/dist/media.d.ts

@@ -0,0 +1,2 @@
+export { k as NEXRA_GENERATION_OPERATIONS, l as NEXRA_MEDIA_API_VERSION, m as NEXRA_MEDIA_FEATURES, n as NEXRA_MEDIA_INPUT_SCHEMAS, o as NEXRA_MEDIA_OPERATIONS, p as NEXRA_MEDIA_OPERATION_DEFINITIONS, q as NEXRA_PUBLISHED_MEDIA_OPERATIONS, r as NexraAudioContentPart, s as NexraAudioGenerateInput, t as NexraAudioTranscribeInput, u as NexraGenerationOperation, v as NexraImageContentPart, w as NexraImageGenerateInput, N as NexraImageLayer, g as NexraImageLayerDecompositionOutput, x as NexraImageUpscaleInput, y as NexraMediaContentPart, z as NexraMediaFeature, B as NexraMediaInputByOperation, C as NexraMediaInputMode, D as NexraMediaInputSlot, E as NexraMediaKind, F as NexraMediaOperation, G as NexraMediaOperationDefinition, H as NexraMediaParameter, I as NexraMediaParameterConstraint, J as NexraMediaSource, K as NexraPublishedMediaOperation, L as NexraResourceContentPart, O as NexraTextContentPart, P as NexraVideoContentPart, Q as NexraVideoDepthInput, R as NexraVideoGenerateInput, S as NexraVideoKeyframeContentPart, T as NexraVideoUpscaleInput, U as isNexraMediaInput, V as nexraMediaInputSchema, W as nexraMediaInputSchemaForMode, X as nexraMediaOperationForMode } from './media-DzOxLGs-.js';
+import './json-Cz0MkWQn.js';