@byte_fluffy/nexra-sdk 0.1.0-alpha.34 → 0.1.0-alpha.36

package/README.md

@@ -37,6 +37,19 @@ available from `@byte_fluffy/nexra-sdk/media`.
 The default API base URL is `https://api.nexra-ai.com/v1`. When overriding
 `baseUrl`, include the `/v1` API prefix.
 
+## DeepSeek model identity correction
+
+`0.1.0-alpha.36` replaces `ctyun/deepseek-v4-1-flash` with
+`deepseek/deepseek-v4-1-flash`. Update model IDs in SDK calls, direct HTTP
+requests, persisted selections and catalog caches. Upgrading the SDK does not
+rewrite a hardcoded model ID. The previous public ID and `deepseek-v4.1-flash`
+alias are retired; neither resolves in the new catalog.
+
+The server rollout must apply migration `0056_deepseek_model_identity` before
+syncing the new model definition. The model UUID, channel-specific upstream IDs,
+routes, prices and original request history remain attached to the same model.
+The API paths and native payload shapes remain unchanged.
+
 ## Error contract migration
 
 `0.1.0-alpha.30` introduces the flat public error response and matching SDK

package/dist/catalog.js

@@ -9,8 +9,8 @@ import {
   listModelSpecs,
   projectMediaGeometry,
   resolveNexraLanguageReasoning
-} from "./chunk-ZPOVSD7D.js";
-import "./chunk-R4BEO26Q.js";
+} from "./chunk-UOM4JX4G.js";
+import "./chunk-AAGTZN2G.js";
 export {
   CatalogClient,
   applyMediaGeometry,

package/dist/{chunk-R4BEO26Q.js → chunk-AAGTZN2G.js}

@@ -694,6 +694,31 @@ function isTerminalTaskStatus(status) {
   return status === "succeeded" || status === "failed" || status === "cancelled";
 }
 
+// ../contracts/src/usage-query-reference.ts
+var USAGE_QUERY_LIST_FILTERS = [
+  "userIds",
+  "apiKeyIds",
+  "providerIds",
+  "channelIds",
+  "modelIds",
+  "operations",
+  "requestStatuses",
+  "usageSources",
+  "normalizationStatuses",
+  "ratingStatuses"
+];
+var USAGE_QUERY_PARAMETERS = [
+  "start",
+  "end",
+  "timeZoneOffsetMinutes",
+  "groupBy",
+  "limit",
+  "cursor",
+  ...USAGE_QUERY_LIST_FILTERS,
+  "upstreamModelId",
+  "breakdown"
+];
+
 // ../contracts/src/admin-errors.ts
 var CALL_ERROR_STATUSES = ["failed", "rejected", "delivery_failed"];
 var CALL_ANOMALY_STATUSES = [...CALL_ERROR_STATUSES, "cancelled"];

package/dist/{chunk-ZPOVSD7D.js → chunk-UOM4JX4G.js}

@@ -2,7 +2,7 @@ import {
   normalizePublicErrorInput,
   pickPublicErrorFields,
   sortRatioDisplayOrder
-} from "./chunk-R4BEO26Q.js";
+} from "./chunk-AAGTZN2G.js";
 
 // src/catalog/generated/audio.generated.json
 var audio_generated_default = [
@@ -7738,17 +7738,15 @@ var image_generated_default = [
 // src/catalog/generated/language.generated.json
 var language_generated_default = [
   {
-    id: "ctyun/deepseek-v4-1-flash",
+    id: "deepseek/deepseek-v4-1-flash",
     contractVersion: 1,
     developer: "deepseek",
     displayName: "DeepSeek V4.1 Flash",
-    summary: "\u901A\u8FC7\u5929\u7FFC\u4E91\u661F\u8FB0 TokenHub \u4F7F\u7528 DeepSeek V4.1 Flash \u8FDB\u884C\u6587\u672C\u548C\u56FE\u50CF\u7406\u89E3\u3002",
+    summary: "DeepSeek V4.1 Flash \u652F\u6301\u6587\u672C\u4E0E\u56FE\u50CF\u7406\u89E3\u3001\u63A8\u7406\u3001\u5DE5\u5177\u8C03\u7528\u548C\u7ED3\u6784\u5316\u8F93\u51FA\u3002",
     kind: "language",
     family: "DeepSeek V4 Flash",
     versionLabel: "4.1 Flash",
-    aliases: [
-      "deepseek-v4.1-flash"
-    ],
+    aliases: [],
     capabilities: {
       inputModalities: [
         "text",
@@ -7845,9 +7843,9 @@ var language_generated_default = [
               type: "string",
               description: "Nexra \u516C\u5171\u6A21\u578B ID\uFF0C\u5FC5\u987B\u4E0E\u5916\u5C42 modelId \u76F8\u540C\u3002",
               title: "\u6A21\u578B ID",
-              const: "ctyun/deepseek-v4-1-flash",
+              const: "deepseek/deepseek-v4-1-flash",
               examples: [
-                "ctyun/deepseek-v4-1-flash"
+                "deepseek/deepseek-v4-1-flash"
               ]
             },
             messages: {
@@ -7996,7 +7994,7 @@ var language_generated_default = [
         },
         outputSchema: {
           type: "object",
-          description: "\u5929\u7FFC\u4E91\u539F\u751F Chat Completions \u54CD\u5E94\uFF1Bstream=true \u65F6\u8FD4\u56DE SSE\u3002",
+          description: "\u534F\u8BAE\u539F\u751F Chat Completions \u54CD\u5E94\uFF1Bstream=true \u65F6\u8FD4\u56DE SSE\u3002",
           additionalProperties: true
         }
       },
@@ -8021,9 +8019,9 @@ var language_generated_default = [
               type: "string",
               description: "Nexra \u516C\u5171\u6A21\u578B ID\uFF0C\u5FC5\u987B\u4E0E\u5916\u5C42 modelId \u76F8\u540C\u3002",
               title: "\u6A21\u578B ID",
-              const: "ctyun/deepseek-v4-1-flash",
+              const: "deepseek/deepseek-v4-1-flash",
               examples: [
-                "ctyun/deepseek-v4-1-flash"
+                "deepseek/deepseek-v4-1-flash"
               ]
             },
             messages: {
@@ -8189,7 +8187,7 @@ var language_generated_default = [
         },
         outputSchema: {
           type: "object",
-          description: "\u5929\u7FFC\u4E91\u539F\u751F Messages \u54CD\u5E94\uFF1Bstream=true \u65F6\u8FD4\u56DE Anthropic SSE\u3002",
+          description: "\u534F\u8BAE\u539F\u751F Messages \u54CD\u5E94\uFF1Bstream=true \u65F6\u8FD4\u56DE Anthropic SSE\u3002",
           additionalProperties: true
         }
       }
@@ -50897,7 +50895,7 @@ var NexraWaitTimeoutError = class extends Error {
 };
 
 // src/generated/version.generated.ts
-var SDK_VERSION = "0.1.0-alpha.34";
+var SDK_VERSION = "0.1.0-alpha.36";
 
 // src/transport.ts
 var DEFAULT_BASE_URL = "https://api.nexra-ai.com/v1";
@@ -51160,7 +51158,7 @@ var productDisplayNames = /* @__PURE__ */ new Map([
   ["bytedance/doubao-seedream-5-0-pro-260628", "Seedream 5.0 Pro"],
   ["bytedance/doubao-tts-v1", "Doubao TTS v1"],
   ["bytedance/doubao-tts-v2", "Doubao TTS v2"],
-  ["ctyun/deepseek-v4-1-flash", "DeepSeek V4.1 Flash"],
+  ["deepseek/deepseek-v4-1-flash", "DeepSeek V4.1 Flash"],
   ["elevenlabs/eleven_flash_v2_5", "ElevenLabs Flash v2.5"],
   ["elevenlabs/eleven_multilingual_v2", "ElevenLabs Multilingual v2"],
   ["fish-audio/s1", "Fish Audio S1"],

package/dist/index.d.ts

@@ -5,8 +5,8 @@ import { C as CursorPage, J as JsonValue } from './json-Cz0MkWQn.js';
 export { a as JsonObject, b as JsonPrimitive } from './json-Cz0MkWQn.js';
 import { N as NexraError, P as PublicErrorFields } from './errors-DZlSwyv8.js';
 export { A as ApiErrorPayload, a as PublicError, b as PublicErrorContext } from './errors-DZlSwyv8.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 TaskResult } from './voices-bcGBcfH-.js';
-export { d as CreateTaskOptions, e as CreateTaskRequest, f as RequestDetails, g as TASK_STATUSES, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, W as WaitTaskOptions, v as WatchTaskOptions, w as isTerminalTaskStatus, x as verifyWebhook } from './voices-bcGBcfH-.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 TaskResult } from './voices-CFRCuodH.js';
+export { d as CreateTaskOptions, e as CreateTaskRequest, f as RequestDetails, g as TASK_STATUSES, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, W as WaitTaskOptions, v as WatchTaskOptions, w as isTerminalTaskStatus, x as verifyWebhook } from './voices-CFRCuodH.js';
 import { CatalogClient } from './catalog.js';
 export { formatModelDisplayName, getModelSpec, listModelSpecs } from './catalog.js';
 export { ceilDecimal, multiplyDecimal } from './decimal.js';

package/dist/index.js

@@ -20,13 +20,13 @@ import {
   projectMediaGeometry,
   queryString,
   sleep
-} from "./chunk-ZPOVSD7D.js";
+} from "./chunk-UOM4JX4G.js";
 import {
   MEDIA_KINDS,
   TASK_STATUSES,
   createTaskRequest,
   isTerminalTaskStatus
-} from "./chunk-R4BEO26Q.js";
+} from "./chunk-AAGTZN2G.js";
 
 // src/assets.ts
 var AssetsClient = class {

package/dist/language.js

@@ -6,12 +6,12 @@ import {
   jsonBody,
   parseServerSentEvents,
   resolveNexraLanguageReasoning
-} from "./chunk-ZPOVSD7D.js";
+} from "./chunk-UOM4JX4G.js";
 import {
   isPublicErrorCode,
   publicErrorMessage,
   resolvePublicErrorLocale
-} from "./chunk-R4BEO26Q.js";
+} from "./chunk-AAGTZN2G.js";
 
 // src/language/index.ts
 import { createAnthropic } from "@ai-sdk/anthropic";
@@ -177,7 +177,7 @@ function chatRequest(binding, options, stream) {
     if (tool.type !== "function") throw new UnsupportedFunctionalityError({ functionality: "provider tools in Chat Completions" });
     return { type: "function", function: { name: tool.name, description: tool.description, parameters: tool.inputSchema, ...tool.strict !== void 0 ? { strict: tool.strict } : {} } };
   });
-  const choice = options.toolChoice;
+  const choice = tools?.length ? options.toolChoice : void 0;
   return {
     ...extension.max_completion_tokens === void 0 ? { max_tokens: options.maxOutputTokens } : {},
     temperature: options.temperature,

package/dist/media.js

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

package/dist/types.d.ts

@@ -2,4 +2,4 @@ export { A as AssetImportRequest, a as AssetInput, b as AssetReference, c as Ass
 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 { A as ApiErrorPayload, N as NexraError, a as PublicError, b as PublicErrorContext, P as PublicErrorFields } from './errors-DZlSwyv8.js';
-export { d as CreateTaskOptions, e as CreateTaskRequest, C as CreateVoiceRequest, f as RequestDetails, b as RunResult, R as RunTaskOptions, c as Task, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, c as TaskResult, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, v as WatchTaskOptions } from './voices-bcGBcfH-.js';
+export { d as CreateTaskOptions, e as CreateTaskRequest, C as CreateVoiceRequest, f as RequestDetails, b as RunResult, R as RunTaskOptions, c as Task, h as TaskCost, i as TaskError, j as TaskEvent, k as TaskEventType, l as TaskListParams, m as TaskPage, n as TaskProgress, o as TaskReceipt, c as TaskResult, p as TaskStatus, q as TaskTiming, r as TaskUsage, s as TaskWebhookConfig, t as TerminalTaskStatus, u as VerifyWebhookOptions, V as Voice, a as VoiceCreation, W as WaitTaskOptions, v as WatchTaskOptions } from './voices-CFRCuodH.js';

package/dist/{voices-bcGBcfH-.d.ts → voices-CFRCuodH.d.ts}

@@ -62,6 +62,16 @@ declare function verifyWebhook(request: Request, secret: string, options?: Verif
 
 type TaskPage<TOutput = JsonValue> = CursorPage<TaskResult<TOutput>>;
 
+declare const REQUEST_HISTORY_MODALITIES: readonly ["image", "video", "audio", "language"];
+declare const REQUEST_HISTORY_KINDS: readonly ["task", "api"];
+declare const REQUEST_HISTORY_DISPLAY_STATUSES: readonly ["succeeded", "failed", "delivery_failed", "running"];
+type RequestHistoryFilters = Readonly<{
+    query?: string;
+    modality?: typeof REQUEST_HISTORY_MODALITIES[number];
+    kind?: typeof REQUEST_HISTORY_KINDS[number];
+    displayStatus?: typeof REQUEST_HISTORY_DISPLAY_STATUSES[number];
+}>;
+
 declare const TASK_STATUSES: readonly ["queued", "running", "succeeded", "failed", "cancelling", "cancelled"];
 type TaskStatus = (typeof TASK_STATUSES)[number];
 type TerminalTaskStatus = "succeeded" | "failed" | "cancelled";
@@ -83,6 +93,7 @@ interface TaskCost {
     amount: string;
     currency: string;
 }
+type TaskBillingReason = "request_failed" | "request_cancelled" | "billing_usage_unavailable" | "billing_usage_invalid" | "billing_usage_incomplete" | "billing_evidence_invalid" | "billing_evidence_incomplete" | "billing_hold_unavailable" | "billing_price_unavailable" | "billing_pricing_unavailable";
 interface TaskQueueSnapshot {
     phase: "waiting_capacity" | "waiting_channel" | "dispatch_pending";
     since: string;
@@ -154,6 +165,8 @@ interface Task<TOutput = JsonValue> extends PublicErrorFields {
     cost?: TaskCost;
     /** Customer billing state; absent on older servers. */
     billingStatus?: "pending" | "succeeded" | "failed" | "refunded" | "unavailable";
+    /** Safe read-only cause; execution failures release authorization rather than failing settlement. */
+    billingReason?: TaskBillingReason;
     /** Final customer sale settlement. Provider procurement cost is never exposed here. */
     settlement?: NexraSettlement;
     /**
@@ -207,10 +220,13 @@ interface RequestDetails extends PublicErrorFields {
     timing?: TaskTiming;
     cost?: TaskCost;
     billingStatus?: Task["billingStatus"];
+    billingReason?: Task["billingReason"];
     settlement?: NexraSettlement;
     metadata?: JsonObject;
     /** Caller-asserted origin extracted from metadata.callerUrl; diagnostics display only. */
     callerUrl?: string | null;
+    /** Client address recorded at the trusted HTTP ingress; absent on historical requests. */
+    clientIp?: string | null;
     /** Caller-asserted end-user identifier extracted from metadata.endUserId; diagnostics display only. */
     endUserId?: string | null;
     /** Name of the API key that authenticated this request; diagnostics display only. */
@@ -269,11 +285,12 @@ type CreateTaskControls = Readonly<{
  * is deliberately not an envelope. Persistent Task records still retain their
  * own `input` snapshot after the HTTP boundary separates control fields. */
 type CreateTaskRequest<TInput extends JsonObject = JsonObject> = TInput & CreateTaskControls;
-interface TaskListParams {
+interface TaskListParams extends RequestHistoryFilters {
     status?: TaskStatus;
     model?: string;
     limit?: number;
     cursor?: string;
+    orphanOnly?: boolean;
 }
 interface RunResult<TOutput = JsonValue> {
     taskId: string;

package/package.json

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