@byte_fluffy/nexra-sdk 0.1.0-alpha.29 → 0.1.0-alpha.30

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { a as AssetImportRequest, b as AssetInput, A as AssetReference, c as AssetUploadOptions, M as MEDIA_KINDS, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-dUJMQNJD.js';
-import { H as HttpTransport, u as ModelSearchParams, T as TaskModelSummary, v as TaskModel, w as ModelSchema, x as ModelResourceList, y as NexraClientOptions } from './media-geometry-nJ7I7ohO.js';
-export { e as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, k as MediaGeometryProjection, z as ModelCapabilitySummary, A as ModelDateVersion, B as ModelEndpointSummary, D as ModelModality, E as ModelResourceOption, l as NexraBillingCurrency, g as NexraCatalogRevision, f as NexraDisplayQuoteBatch, G as NexraDisplayQuoteBatchEntry, n as NexraModelOperation, h as NexraModelSpec, j as NexraModelSpecFilter, d as NexraQuote, o as NexraSalePrice, c as NexraSalePriceList, p as NexraSettlement, U as UnifiedMediaGeometry, q as applyMediaGeometry, r as decodeMediaGeometry, s as encodeMediaGeometry, t as projectMediaGeometry } from './media-geometry-nJ7I7ohO.js';
-import { C as CursorPage, a as JsonValue } from './json-Drjj1OKl.js';
-export { J as JsonObject, b as JsonPrimitive } from './json-Drjj1OKl.js';
-import { V as Voice, C as CreateVoiceRequest, a as VoiceCreation, A as AssetsClient, T as TasksClient, R as RunTaskOptions, b as RunResult, c as ApiErrorPayload, d as TaskResult } from './types-B3Xee2AJ.js';
-export { e as CreateTaskOptions, f as CreateTaskRequest, g as RequestDetails, h as TASK_STATUSES, i as Task, j as TaskCost, k as TaskError, l as TaskEvent, m as TaskEventType, n as TaskListParams, o as TaskPage, p as TaskProgress, q as TaskReceipt, r as TaskStatus, s as TaskTiming, t as TaskUsage, u as TaskWebhookConfig, v as TerminalTaskStatus, w as VerifyWebhookOptions, W as WaitTaskOptions, x as WatchTaskOptions, y as isTerminalTaskStatus, z as verifyWebhook } from './types-B3Xee2AJ.js';
+export { A as AssetImportRequest, a as AssetInput, b as AssetReference, c as AssetUploadOptions, M as MEDIA_KINDS, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-Cusrjj7_.js';
+import { H as HttpTransport, M as ModelSearchParams, T as TaskModelSummary, a as TaskModel, b as ModelSchema, c as ModelResourceList, N as NexraClientOptions } from './media-geometry-DAVFGry1.js';
+export { C as CreateNexraDisplayQuoteBatchRequest, d as CreateNexraQuoteRequest, F as FetchLike, e as MediaGeometryField, f as MediaGeometryProjection, g as ModelCapabilitySummary, h as ModelDateVersion, i as ModelEndpointSummary, j as ModelModality, k as ModelResourceOption, l as NexraBillingCurrency, m as NexraCatalogRevision, n as NexraDisplayQuoteBatch, o as NexraDisplayQuoteBatchEntry, p as NexraModelOperation, q as NexraModelSpec, r as NexraModelSpecFilter, s as NexraQuote, t as NexraSalePrice, u as NexraSalePriceList, v as NexraSettlement, U as UnifiedMediaGeometry, w as applyMediaGeometry, x as decodeMediaGeometry, y as encodeMediaGeometry, z as projectMediaGeometry } from './media-geometry-DAVFGry1.js';
+import { C as CursorPage, J as JsonValue } from './json-Cz0MkWQn.js';
+export { a as JsonObject, b as JsonPrimitive } from './json-Cz0MkWQn.js';
+import { V as Voice, C as CreateVoiceRequest, a as VoiceCreation, A as AssetsClient, T as TasksClient, R as RunTaskOptions, b as RunResult, N as NexraError, P as PublicErrorFields, c as TaskResult } from './voices-Cl4ygZHV.js';
+export { d as ApiErrorPayload, e as CreateTaskOptions, f as CreateTaskRequest, g as PublicError, h as PublicErrorContext, i as RequestDetails, j as TASK_STATUSES, k as TaskCost, l as TaskError, m as TaskEvent, n as TaskEventType, o as TaskListParams, p as TaskPage, q as TaskProgress, r as TaskReceipt, s as TaskStatus, t as TaskTiming, u as TaskUsage, v as TaskWebhookConfig, w as TerminalTaskStatus, x as VerifyWebhookOptions, W as WaitTaskOptions, y as WatchTaskOptions, z as isTerminalTaskStatus, B as verifyWebhook } from './voices-Cl4ygZHV.js';
 import { CatalogClient } from './catalog.js';
 export { formatModelDisplayName, getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';
@@ -41,23 +41,65 @@ declare class NexraClient {
 }
 declare function createNexra(options?: NexraClientOptions): NexraClient;
 
+type LegacyTaskInput = TaskResult<unknown> & {
+    requestId?: string;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: unknown;
+    };
+};
 declare class NexraApiError extends Error {
     readonly status: number;
-    readonly code: string;
-    readonly requestId?: string;
-    readonly retryable: boolean;
-    readonly details?: ApiErrorPayload["error"]["details"];
-    constructor(message: string, options: {
+    readonly nexraError: NexraError;
+    readonly nexraRequestId?: string;
+    readonly nexraHttpStatus?: number;
+    readonly upstreamHttpStatus?: PublicErrorFields["upstreamHttpStatus"];
+    readonly upstreamRequestId?: string;
+    readonly upstreamError?: PublicErrorFields["upstreamError"];
+    readonly upstreamRedacted?: true;
+    readonly upstreamTruncated?: true;
+    readonly upstreamUnavailableReason?: PublicErrorFields["upstreamUnavailableReason"];
+    readonly upstreamFormat?: PublicErrorFields["upstreamFormat"];
+    readonly upstreamEvent?: string;
+    constructor(message: string, options: PublicErrorFields & {
         status: number;
         code?: string;
         requestId?: string;
-        retryable?: boolean;
-        details?: ApiErrorPayload["error"]["details"];
+        details?: unknown;
+        upstream?: unknown;
     });
+    get code(): string;
+    /** @deprecated Use nexraRequestId. */
+    get requestId(): string | undefined;
+    /** @deprecated Use nexraError.param. */
+    get details(): {
+        param: string;
+    } | undefined;
 }
 declare class NexraTaskError extends Error {
-    readonly task: TaskResult<unknown>;
-    constructor(task: TaskResult<unknown>);
+    readonly task: LegacyTaskInput;
+    constructor(task: LegacyTaskInput);
+    get nexraError(): NexraError | undefined;
+    get code(): string | undefined;
+    /** @deprecated Use nexraError.param. */
+    get details(): {
+        param: string;
+    } | undefined;
+    /** @deprecated Use nexraRequestId. */
+    get requestId(): string | undefined;
+    get nexraRequestId(): string | undefined;
+    get nexraHttpStatus(): number | undefined;
+    get upstreamHttpStatus(): PublicErrorFields["upstreamHttpStatus"];
+    get upstreamRequestId(): string | undefined;
+    get upstreamError(): PublicErrorFields["upstreamError"];
+    get upstreamRedacted(): true | undefined;
+    get upstreamTruncated(): true | undefined;
+    get upstreamUnavailableReason(): PublicErrorFields["upstreamUnavailableReason"];
+    get upstreamFormat(): PublicErrorFields["upstreamFormat"];
+    get upstreamEvent(): string | undefined;
+    private get publicFields();
+    get taskId(): string;
 }
 declare class NexraWaitTimeoutError extends Error {
     readonly taskId: string;
@@ -65,4 +107,4 @@ declare class NexraWaitTimeoutError extends Error {
     constructor(taskId: string, timeoutMs: number);
 }
 
-export { ApiErrorPayload, AssetsClient, CatalogClient, type CreateVoiceOptions, CreateVoiceRequest, CursorPage, JsonValue, ModelResourceList, ModelSchema, ModelSearchParams, ModelsClient, NexraApiError, NexraClient, NexraClientOptions, NexraTaskError, NexraWaitTimeoutError, RunResult, RunTaskOptions, TaskModel, TaskModelSummary, TaskResult, TasksClient, Voice, VoiceCreation, VoicesClient, createNexra };
+export { AssetsClient, CatalogClient, type CreateVoiceOptions, CreateVoiceRequest, CursorPage, JsonValue, ModelResourceList, ModelSchema, ModelSearchParams, ModelsClient, NexraApiError, NexraClient, NexraClientOptions, NexraError, NexraTaskError, NexraWaitTimeoutError, PublicErrorFields, RunResult, RunTaskOptions, TaskResult as Task, TaskModel, TaskModelSummary, TaskResult, TasksClient, Voice, VoiceCreation, VoicesClient, createNexra };

package/dist/index.js

@@ -20,13 +20,13 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-ESV6ODRA.js";
+} from "./chunk-3CF6PDT3.js";
 import {
   MEDIA_KINDS,
   TASK_STATUSES,
   createTaskRequest,
   isTerminalTaskStatus
-} from "./chunk-IEBCNRT4.js";
+} from "./chunk-DKQZWIQ7.js";
 
 // src/assets.ts
 var AssetsClient = class {

package/dist/{json-Drjj1OKl.d.ts → json-Cz0MkWQn.d.ts}

@@ -8,4 +8,4 @@ interface CursorPage<T> {
     nextCursor?: string;
 }
 
-export type { CursorPage as C, JsonObject as J, JsonValue as a, JsonPrimitive as b };
+export type { CursorPage as C, JsonValue as J, JsonObject as a, JsonPrimitive as b };

package/dist/language.d.ts

@@ -1,8 +1,8 @@
 import { LanguageModelV4 } from '@ai-sdk/provider';
 import { NexraLanguageProtocol } from './catalog.js';
 export { NexraLanguageModelBinding } from './catalog.js';
-import { F as FetchLike } from './media-geometry-nJ7I7ohO.js';
-import './json-Drjj1OKl.js';
+import { F as FetchLike } from './media-geometry-DAVFGry1.js';
+import './json-Cz0MkWQn.js';
 
 type NexraLanguageModelOptions = {
     apiKey: string;

package/dist/language.js

@@ -5,8 +5,8 @@ import {
   jsonBody,
   parseServerSentEvents,
   resolveNexraLanguageReasoning
-} from "./chunk-ESV6ODRA.js";
-import "./chunk-IEBCNRT4.js";
+} from "./chunk-3CF6PDT3.js";
+import "./chunk-DKQZWIQ7.js";
 
 // src/language/index.ts
 import { createAnthropic } from "@ai-sdk/anthropic";

package/dist/{media-geometry-nJ7I7ohO.d.ts → media-geometry-DAVFGry1.d.ts}

@@ -1,4 +1,4 @@
-import { b as JsonPrimitive, J as JsonObject, a as JsonValue } from './json-Drjj1OKl.js';
+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];
@@ -360,4 +360,4 @@ declare function decodeMediaGeometry(_inputSchema: JsonObject, input: JsonObject
 /** Normalize the SDK convenience alias `ratio` without producing Native fields. */
 declare function applyMediaGeometry(inputSchema: JsonObject, input: JsonObject): JsonObject;
 
-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 };
+export { type NexraCatalogChangeParams as A, type NexraCatalogChangePage as B, type CreateNexraDisplayQuoteBatchRequest as C, type NexraCatalogModelState as D, type NexraModelEndpointSpec as E, type FetchLike as F, type NexraCatalogModelIdentity as G, HttpTransport as H, type ModelSearchParams as M, type NexraClientOptions as N, type TaskModelSummary as T, type UnifiedMediaGeometry as U, type TaskModel as a, type ModelSchema as b, type ModelResourceList as c, type CreateNexraQuoteRequest as d, type MediaGeometryField as e, type MediaGeometryProjection as f, type ModelCapabilitySummary as g, type ModelDateVersion as h, type ModelEndpointSummary as i, type ModelModality as j, type ModelResourceOption as k, type NexraBillingCurrency as l, type NexraCatalogRevision as m, type NexraDisplayQuoteBatch as n, type NexraDisplayQuoteBatchEntry as o, type NexraModelOperation as p, type NexraModelSpec as q, type NexraModelSpecFilter as r, type NexraQuote as s, type NexraSalePrice as t, type NexraSalePriceList as u, type NexraSettlement as v, applyMediaGeometry as w, decodeMediaGeometry as x, encodeMediaGeometry as y, projectMediaGeometry as z };

package/dist/media.d.ts

@@ -1,5 +1,5 @@
-import { A as AssetReference } from './assets-dUJMQNJD.js';
-import { J as JsonObject } from './json-Drjj1OKl.js';
+import { b as AssetReference } from './assets-Cusrjj7_.js';
+import { a as JsonObject } from './json-Cz0MkWQn.js';
 
 declare const NEXRA_MEDIA_API_VERSION: 1;
 /** Catalog-level generation taxonomy. Text keeps its native endpoint protocols. */

package/dist/media.js

@@ -10,7 +10,7 @@ import {
   nexraMediaInputSchema,
   nexraMediaInputSchemaForMode,
   nexraMediaOperationForMode
-} from "./chunk-IEBCNRT4.js";
+} from "./chunk-DKQZWIQ7.js";
 export {
   NEXRA_GENERATION_OPERATIONS,
   NEXRA_MEDIA_API_VERSION,

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-export { a as AssetImportRequest, b as AssetInput, A as AssetReference, c as AssetUploadOptions, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-dUJMQNJD.js';
-export { e as CreateNexraDisplayQuoteBatchRequest, C as CreateNexraQuoteRequest, F as FetchLike, M as MediaGeometryField, k as MediaGeometryProjection, z as ModelCapabilitySummary, A as ModelDateVersion, B as ModelEndpointSummary, D as ModelModality, x as ModelResourceList, E as ModelResourceOption, w as ModelSchema, u as ModelSearchParams, l as NexraBillingCurrency, g as NexraCatalogRevision, y as NexraClientOptions, f as NexraDisplayQuoteBatch, G as NexraDisplayQuoteBatchEntry, n as NexraModelOperation, h as NexraModelSpec, j as NexraModelSpecFilter, d as NexraQuote, o as NexraSalePrice, c as NexraSalePriceList, p as NexraSettlement, v as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-nJ7I7ohO.js';
-export { C as CursorPage, J as JsonObject, b as JsonPrimitive, a as JsonValue } from './json-Drjj1OKl.js';
-export { c as ApiErrorPayload, e as CreateTaskOptions, f as CreateTaskRequest, C as CreateVoiceRequest, g as RequestDetails, b as RunResult, R as RunTaskOptions, i as Task, j as TaskCost, k as TaskError, l as TaskEvent, m as TaskEventType, n as TaskListParams, o as TaskPage, p as TaskProgress, q as TaskReceipt, d as TaskResult, r as TaskStatus, s as TaskTiming, t as TaskUsage, u as TaskWebhookConfig, v as TerminalTaskStatus, w as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, x as WatchTaskOptions } from './types-B3Xee2AJ.js';
+export { A as AssetImportRequest, a as AssetInput, b as AssetReference, c as AssetUploadOptions, d as MediaAsset, e as MediaAssetStatus, f as MediaKind } from './assets-Cusrjj7_.js';
+export { C as CreateNexraDisplayQuoteBatchRequest, d as CreateNexraQuoteRequest, F as FetchLike, e as MediaGeometryField, f as MediaGeometryProjection, g as ModelCapabilitySummary, h as ModelDateVersion, i as ModelEndpointSummary, j as ModelModality, c as ModelResourceList, k as ModelResourceOption, b as ModelSchema, M as ModelSearchParams, l as NexraBillingCurrency, m as NexraCatalogRevision, N as NexraClientOptions, n as NexraDisplayQuoteBatch, o as NexraDisplayQuoteBatchEntry, p as NexraModelOperation, q as NexraModelSpec, r as NexraModelSpecFilter, s as NexraQuote, t as NexraSalePrice, u as NexraSalePriceList, v as NexraSettlement, a as TaskModel, T as TaskModelSummary, U as UnifiedMediaGeometry } from './media-geometry-DAVFGry1.js';
+export { C as CursorPage, a as JsonObject, b as JsonPrimitive, J as JsonValue } from './json-Cz0MkWQn.js';
+export { d as ApiErrorPayload, e as CreateTaskOptions, f as CreateTaskRequest, C as CreateVoiceRequest, N as NexraError, g as PublicError, h as PublicErrorContext, P as PublicErrorFields, i as RequestDetails, b as RunResult, R as RunTaskOptions, c as Task, k as TaskCost, l as TaskError, m as TaskEvent, n as TaskEventType, o as TaskListParams, p as TaskPage, q as TaskProgress, r as TaskReceipt, c as TaskResult, s as TaskStatus, t as TaskTiming, u as TaskUsage, v as TaskWebhookConfig, w as TerminalTaskStatus, x as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, y as WatchTaskOptions } from './voices-Cl4ygZHV.js';

package/dist/{types-B3Xee2AJ.d.ts → voices-Cl4ygZHV.d.ts}

@@ -1,18 +1,93 @@
-import { d as MediaAsset, c as AssetUploadOptions, a as AssetImportRequest, g as AssetCertificationRequest, h as AssetCertification, i as AssetCertificationWaitOptions } from './assets-dUJMQNJD.js';
-import { p as NexraSettlement, H as HttpTransport } from './media-geometry-nJ7I7ohO.js';
-import { J as JsonObject, a as JsonValue, C as CursorPage } from './json-Drjj1OKl.js';
+import { c as AssetUploadOptions, d as MediaAsset, A as AssetImportRequest, g as AssetCertificationRequest, h as AssetCertification, i as AssetCertificationWaitOptions } from './assets-Cusrjj7_.js';
+import { H as HttpTransport, v as NexraSettlement } from './media-geometry-DAVFGry1.js';
+import { J as JsonValue, a as JsonObject, C as CursorPage } from './json-Cz0MkWQn.js';
 
-interface ApiErrorPayload {
-    error: {
-        code: string;
-        message: string;
-        category?: string;
-        retryable?: boolean;
-        requestId?: string;
-        details?: JsonObject;
-    };
+type PublicUpstreamUnavailableReason = "no_response" | "not_retained" | "unsupported_capture" | "error_not_emitted" | "size_limit";
+/** Network errors retain unknown codes from older or newer servers. */
+type NexraError = {
+    code: string;
+    message: string;
+    param?: string;
+};
+type PublicErrorContext = {
+    nexraRequestId?: string;
+    nexraHttpStatus?: number;
+};
+type PublicErrorFields = PublicErrorContext & {
+    nexraError?: NexraError;
+    upstreamHttpStatus?: number;
+    upstreamRequestId?: string;
+    upstreamError?: JsonValue;
+    upstreamRedacted?: true;
+    upstreamTruncated?: true;
+    upstreamUnavailableReason?: PublicUpstreamUnavailableReason;
+    upstreamFormat?: "sse" | "decoded";
+    upstreamEvent?: string;
+};
+type PublicError = PublicErrorFields & {
+    nexraError: NexraError;
+};
+type ApiErrorPayload = PublicError;
+
+declare class AssetsClient {
+    private readonly transport;
+    constructor(transport: HttpTransport);
+    upload(file: Blob, options?: AssetUploadOptions): Promise<MediaAsset>;
+    import(request: AssetImportRequest, signal?: AbortSignal): Promise<MediaAsset>;
+    get(assetId: string, signal?: AbortSignal): Promise<MediaAsset>;
+    certifyForSeedance(asset: MediaAsset | string, request?: AssetCertificationRequest, signal?: AbortSignal): Promise<AssetCertification>;
+    getSeedanceCertification(asset: MediaAsset | string, signal?: AbortSignal): Promise<AssetCertification>;
+    waitForSeedanceCertification(asset: MediaAsset | string, options?: AssetCertificationWaitOptions): Promise<AssetCertification>;
+    download(asset: MediaAsset | string, signal?: AbortSignal): Promise<Response>;
+    stream(asset: MediaAsset | string, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
+}
+
+interface CreateTaskOptions {
+    quoteToken?: string;
+    submittedAt?: string;
+    metadata?: JsonObject;
+    callback_url?: string;
+    /** @deprecated Use callback_url; do not supply both. */
+    webhook?: TaskWebhookConfig;
+    schemaVersion?: number;
+    idempotencyKey?: string;
+    signal?: AbortSignal;
+}
+interface WatchTaskOptions {
+    signal?: AbortSignal;
+    lastEventId?: string;
+    maxReconnects?: number;
+}
+interface WaitTaskOptions extends WatchTaskOptions {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    onEvent?: (event: TaskEvent) => void | Promise<void>;
+}
+interface RunTaskOptions extends CreateTaskOptions, WaitTaskOptions {
+    cancelOnAbort?: boolean;
+}
+declare class TasksClient {
+    private readonly transport;
+    private readonly assets;
+    constructor(transport: HttpTransport, assets: AssetsClient);
+    create<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: CreateTaskOptions): Promise<TaskReceipt>;
+    get<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskResult<TOutput>>;
+    list<TOutput = JsonValue>(params?: TaskListParams, signal?: AbortSignal): Promise<CursorPage<TaskResult<TOutput>>>;
+    cancel<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskReceipt>;
+    watch(taskId: string, options?: WatchTaskOptions): AsyncGenerator<TaskEvent>;
+    wait<TOutput = JsonValue>(taskId: string, options?: WaitTaskOptions): Promise<TaskResult<TOutput>>;
+    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: RunTaskOptions): Promise<RunResult<TOutput>>;
 }
 
+interface VerifyWebhookOptions {
+    toleranceSeconds?: number;
+    now?: Date;
+}
+/** @deprecated Only verifies legacy signed webhooks, not callback_url notifications. */
+declare function verifyWebhook(request: Request, secret: string, options?: VerifyWebhookOptions): Promise<boolean>;
+
+type TaskPage<TOutput = JsonValue> = CursorPage<TaskResult<TOutput>>;
+
 declare const TASK_STATUSES: readonly ["queued", "running", "succeeded", "failed", "cancelling", "cancelled"];
 type TaskStatus = (typeof TASK_STATUSES)[number];
 type TerminalTaskStatus = "succeeded" | "failed" | "cancelled";
@@ -21,13 +96,7 @@ interface TaskProgress {
     stage?: string;
     message?: string;
 }
-interface TaskError {
-    code: string;
-    message: string;
-    category?: string;
-    retryable?: boolean;
-    details?: JsonObject;
-}
+type TaskError = NexraError;
 interface TaskUsage {
     components: Array<{
         name: string;
@@ -61,6 +130,8 @@ interface TaskTiming {
     generationMs: number | null;
     /** Background: elapsed persistence stage until assets are ready; terminal: measured transfer. Null when unfinished or unavailable. */
     storageMs: number | null;
+    /** First-response time outside measured preparation/generation and any pre-response storage; not a separately instrumented stage. */
+    responseOverheadMs?: number | null;
     /** Start of in-progress background persistence, when a worker has claimed the output. */
     storageStartedAt?: string;
     /** Background persistence elapsed time from first response to durable asset readiness. */
@@ -78,7 +149,7 @@ interface TaskTiming {
     observedAt?: string;
 }
 /** Repository/console read model. HTTP clients receive TaskReceipt or TaskResult. */
-interface Task<TOutput = JsonValue> {
+interface Task<TOutput = JsonValue> extends PublicErrorFields {
     id: string;
     /** Original platform request ID, shared with request history. */
     requestId?: string;
@@ -106,7 +177,7 @@ interface Task<TOutput = JsonValue> {
     /** Native-managed tasks preserve the final response shape and media URLs; catalog models may normalize model identifiers. */
     output?: TOutput;
     assets: MediaAsset[];
-    error?: TaskError;
+    error?: PublicError;
     usage?: TaskUsage;
     cost?: TaskCost;
     /** Customer billing state; absent on older servers. */
@@ -139,13 +210,13 @@ interface Task<TOutput = JsonValue> {
     expiresAt?: string;
 }
 /** POST /tasks returns acceptance only, including for idempotent replays. */
-type TaskReceipt = Pick<Task, "id" | "status">;
+type TaskReceipt = Pick<Task, "id" | "status"> & PublicErrorContext;
 /** Public Task result; platform diagnostics and business tags live in RequestDetails. */
-type TaskResult<TOutput = JsonValue> = Pick<Task<TOutput>, "id" | "model" | "status"> & Partial<Pick<Task<TOutput>, "requestId" | "output" | "assets" | "error" | "persistPolicy" | "deliveryStatus" | "settlement" | "queue">>;
+type TaskResult<TOutput = JsonValue> = Pick<Task<TOutput>, "id" | "model" | "status"> & Partial<Pick<Task<TOutput>, "output" | "assets" | "persistPolicy" | "deliveryStatus" | "settlement" | "queue">> & PublicErrorFields;
 /** Platform request details, used by both managed Tasks and native proxy requests. */
-interface RequestDetails {
+interface RequestDetails extends PublicErrorFields {
     id: string;
-    requestId: string;
+    nexraRequestId?: string;
     taskId: string | null;
     method: string;
     path: string;
@@ -158,7 +229,6 @@ interface RequestDetails {
     taskStatus?: string | null;
     persistPolicy?: "terminal" | "background";
     deliveryStatus?: Task["deliveryStatus"];
-    httpStatus: number | null;
     errorCode: string | null;
     /** HTTP duration, never substituted with asynchronous task duration. */
     durationMs: number | null;
@@ -233,7 +303,6 @@ interface TaskListParams {
     limit?: number;
     cursor?: string;
 }
-type TaskPage<TOutput = JsonValue> = CursorPage<Task<TOutput>>;
 interface RunResult<TOutput = JsonValue> {
     taskId: string;
     output: TOutput;
@@ -273,61 +342,4 @@ type VoiceCreation = Readonly<{
     voice: Voice;
 }>;
 
-declare class AssetsClient {
-    private readonly transport;
-    constructor(transport: HttpTransport);
-    upload(file: Blob, options?: AssetUploadOptions): Promise<MediaAsset>;
-    import(request: AssetImportRequest, signal?: AbortSignal): Promise<MediaAsset>;
-    get(assetId: string, signal?: AbortSignal): Promise<MediaAsset>;
-    certifyForSeedance(asset: MediaAsset | string, request?: AssetCertificationRequest, signal?: AbortSignal): Promise<AssetCertification>;
-    getSeedanceCertification(asset: MediaAsset | string, signal?: AbortSignal): Promise<AssetCertification>;
-    waitForSeedanceCertification(asset: MediaAsset | string, options?: AssetCertificationWaitOptions): Promise<AssetCertification>;
-    download(asset: MediaAsset | string, signal?: AbortSignal): Promise<Response>;
-    stream(asset: MediaAsset | string, signal?: AbortSignal): Promise<ReadableStream<Uint8Array>>;
-}
-
-interface CreateTaskOptions {
-    quoteToken?: string;
-    submittedAt?: string;
-    metadata?: JsonObject;
-    callback_url?: string;
-    /** @deprecated Use callback_url; do not supply both. */
-    webhook?: TaskWebhookConfig;
-    schemaVersion?: number;
-    idempotencyKey?: string;
-    signal?: AbortSignal;
-}
-interface WatchTaskOptions {
-    signal?: AbortSignal;
-    lastEventId?: string;
-    maxReconnects?: number;
-}
-interface WaitTaskOptions extends WatchTaskOptions {
-    timeoutMs?: number;
-    pollIntervalMs?: number;
-    onEvent?: (event: TaskEvent) => void | Promise<void>;
-}
-interface RunTaskOptions extends CreateTaskOptions, WaitTaskOptions {
-    cancelOnAbort?: boolean;
-}
-declare class TasksClient {
-    private readonly transport;
-    private readonly assets;
-    constructor(transport: HttpTransport, assets: AssetsClient);
-    create<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: CreateTaskOptions): Promise<TaskReceipt>;
-    get<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskResult<TOutput>>;
-    list<TOutput = JsonValue>(params?: TaskListParams, signal?: AbortSignal): Promise<CursorPage<TaskResult<TOutput>>>;
-    cancel<TOutput = JsonValue>(taskId: string, signal?: AbortSignal): Promise<TaskReceipt>;
-    watch(taskId: string, options?: WatchTaskOptions): AsyncGenerator<TaskEvent>;
-    wait<TOutput = JsonValue>(taskId: string, options?: WaitTaskOptions): Promise<TaskResult<TOutput>>;
-    run<TOutput = JsonValue, TInput = Record<string, unknown>>(model: string, input: TInput, options?: RunTaskOptions): Promise<RunResult<TOutput>>;
-}
-
-interface VerifyWebhookOptions {
-    toleranceSeconds?: number;
-    now?: Date;
-}
-/** @deprecated Only verifies legacy signed webhooks, not callback_url notifications. */
-declare function verifyWebhook(request: Request, secret: string, options?: VerifyWebhookOptions): Promise<boolean>;
-
-export { AssetsClient as A, type CreateVoiceRequest as C, type RunTaskOptions as R, TasksClient as T, type Voice as V, type WaitTaskOptions as W, type VoiceCreation as a, type RunResult as b, type ApiErrorPayload as c, type TaskResult as d, type CreateTaskOptions as e, type CreateTaskRequest as f, type RequestDetails as g, TASK_STATUSES as h, type Task as i, type TaskCost as j, type TaskError as k, type TaskEvent as l, type TaskEventType as m, type TaskListParams as n, type TaskPage as o, type TaskProgress as p, type TaskReceipt as q, type TaskStatus as r, type TaskTiming as s, type TaskUsage as t, type TaskWebhookConfig as u, type TerminalTaskStatus as v, type VerifyWebhookOptions as w, type WatchTaskOptions as x, isTerminalTaskStatus as y, verifyWebhook as z };
+export { AssetsClient as A, verifyWebhook as B, type CreateVoiceRequest as C, type NexraError as N, type PublicErrorFields as P, type RunTaskOptions as R, TasksClient as T, type Voice as V, type WaitTaskOptions as W, type VoiceCreation as a, type RunResult as b, type TaskResult as c, type ApiErrorPayload as d, type CreateTaskOptions as e, type CreateTaskRequest as f, type PublicError as g, type PublicErrorContext as h, type RequestDetails as i, TASK_STATUSES as j, type TaskCost as k, type TaskError as l, type TaskEvent as m, type TaskEventType as n, type TaskListParams as o, type TaskPage as p, type TaskProgress as q, type TaskReceipt as r, type TaskStatus as s, type TaskTiming as t, type TaskUsage as u, type TaskWebhookConfig as v, type TerminalTaskStatus as w, type VerifyWebhookOptions as x, type WatchTaskOptions as y, isTerminalTaskStatus as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@byte_fluffy/nexra-sdk",
-  "version": "0.1.0-alpha.29",
+  "version": "0.1.0-alpha.30",
   "type": "module",
   "types": "./dist/index.d.ts",
   "sideEffects": false,