@shop-os/modelkit 0.3.8 → 0.4.1

package/dist/catalog.d.cts

@@ -181,6 +181,8 @@ interface VideoToolSubmission {
     responseUrl: string;
     cancelUrl: string;
     output: VideoToolOutputSpec;
+    /** Epoch ms when the kit submitted the job; the result's usage `latencyMs` is measured from it. */
+    submittedAt?: number;
 }
 type VideoToolStatus = "queued" | "running" | "completed";
 interface VideoToolResult {
@@ -520,6 +522,13 @@ interface UsageEvent {
     inputTokens?: number;
     outputTokens?: number;
     reportedCostUsd?: number;
+    /**
+     * Wall time of the kit call that produced this event, in ms: from dispatch to the
+     * provider's final answer (a video's polling included; a multi-step text call's tool
+     * steps included). Absent only where the kit never saw the start (a video tool whose
+     * submission carries no `submittedAt`).
+     */
+    latencyMs?: number;
     raw?: unknown;
 }
 type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "cloudflare";
@@ -1138,7 +1147,9 @@ declare function promptConventions(row: {
 
 /** Provider body or the lifted detail (Gemini blockReason, fal body.detail). */
 type ProviderErrorBody = string | JsonValue;
-type ModelKitErrorCode = "unknown_model" | "unsupported_option" | "missing_input" | "content_blocked" | "provider_rejected" | "timeout" | "auth" | "network" | "rate_limited";
+type ModelKitErrorCode = "unknown_model" | "unsupported_option" | "missing_input" | "content_blocked" | "provider_rejected"
+/** The provider account is out of credit or quota (HTTP 402 and its body spellings). Never retried. */
+ | "provider_billing" | "timeout" | "auth" | "network" | "rate_limited";
 interface ModelKitErrorInit {
     code: ModelKitErrorCode;
     message: string;

package/dist/catalog.d.ts

@@ -181,6 +181,8 @@ interface VideoToolSubmission {
     responseUrl: string;
     cancelUrl: string;
     output: VideoToolOutputSpec;
+    /** Epoch ms when the kit submitted the job; the result's usage `latencyMs` is measured from it. */
+    submittedAt?: number;
 }
 type VideoToolStatus = "queued" | "running" | "completed";
 interface VideoToolResult {
@@ -520,6 +522,13 @@ interface UsageEvent {
     inputTokens?: number;
     outputTokens?: number;
     reportedCostUsd?: number;
+    /**
+     * Wall time of the kit call that produced this event, in ms: from dispatch to the
+     * provider's final answer (a video's polling included; a multi-step text call's tool
+     * steps included). Absent only where the kit never saw the start (a video tool whose
+     * submission carries no `submittedAt`).
+     */
+    latencyMs?: number;
     raw?: unknown;
 }
 type ProviderKeyName = "openai" | "anthropic" | "google" | "xai" | "perplexity" | "deepseek" | "moonshot" | "minimax" | "ark" | "fal" | "replicate" | "prodia" | "higgsfield" | "cloudflare";
@@ -1138,7 +1147,9 @@ declare function promptConventions(row: {
 
 /** Provider body or the lifted detail (Gemini blockReason, fal body.detail). */
 type ProviderErrorBody = string | JsonValue;
-type ModelKitErrorCode = "unknown_model" | "unsupported_option" | "missing_input" | "content_blocked" | "provider_rejected" | "timeout" | "auth" | "network" | "rate_limited";
+type ModelKitErrorCode = "unknown_model" | "unsupported_option" | "missing_input" | "content_blocked" | "provider_rejected"
+/** The provider account is out of credit or quota (HTTP 402 and its body spellings). Never retried. */
+ | "provider_billing" | "timeout" | "auth" | "network" | "rate_limited";
 interface ModelKitErrorInit {
     code: ModelKitErrorCode;
     message: string;

package/dist/catalog.js

@@ -211,35 +211,43 @@ var IMAGE_MODELS = [
     GEMINI_PROMPT_MAX_CHARS,
     NANO_BANANA_2_1_RATIOS
   ),
-  geminiImage(
-    "gemini-3-pro-image-preview",
-    "Nano Banana Pro",
-    ["nb-pro"],
-    ["1K", "2K", "4K"],
-    {
-      provider: "google",
-      description: "Create stunning, production-quality visuals with exceptional realism, detail, and typography. Best for campaigns, e-commerce, product photography, and hero creatives.",
-      logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
-    },
-    ["cowork", "space_builder"],
-    { images: 14 },
-    GEMINI_PROMPT_MAX_CHARS
-  ),
-  geminiImage(
-    "gemini-3.1-flash-image-preview",
-    "Nano Banana 2",
-    ["nb-2"],
-    // Flash 3.1 is the only Gemini image model with the 512 tier.
-    ["512", "1K", "2K", "4K"],
-    {
-      provider: "google",
-      description: "Generate high-quality images at speed. Perfect for brainstorming, concept boards, concept testing, creative exploration, and large batch workflows.",
-      logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
-    },
-    ["cowork", "space_builder"],
-    { images: 14 },
-    GEMINI_PROMPT_MAX_CHARS
-  ),
+  // Google retired the -preview endpoints for the GA ids; the catalog ids stay because they
+  // are pricing keys and stored model ids.
+  {
+    ...geminiImage(
+      "gemini-3-pro-image-preview",
+      "Nano Banana Pro",
+      ["nb-pro"],
+      ["1K", "2K", "4K"],
+      {
+        provider: "google",
+        description: "Create stunning, production-quality visuals with exceptional realism, detail, and typography. Best for campaigns, e-commerce, product photography, and hero creatives.",
+        logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
+      },
+      ["cowork", "space_builder"],
+      { images: 14 },
+      GEMINI_PROMPT_MAX_CHARS
+    ),
+    providerModelId: "gemini-3-pro-image"
+  },
+  {
+    ...geminiImage(
+      "gemini-3.1-flash-image-preview",
+      "Nano Banana 2",
+      ["nb-2"],
+      // Flash 3.1 is the only Gemini image model with the 512 tier.
+      ["512", "1K", "2K", "4K"],
+      {
+        provider: "google",
+        description: "Generate high-quality images at speed. Perfect for brainstorming, concept boards, concept testing, creative exploration, and large batch workflows.",
+        logo: "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png"
+      },
+      ["cowork", "space_builder"],
+      { images: 14 },
+      GEMINI_PROMPT_MAX_CHARS
+    ),
+    providerModelId: "gemini-3.1-flash-image"
+  },
   geminiImage(
     "gemini-3.1-flash-lite-image",
     "Nano Banana Lite",
@@ -1373,6 +1381,7 @@ var OMNI_PROMPT = { referenceSyntax: "caption", maxChars: 5e4 };
 var BYTEDANCE_LOGO = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/3bba5d81-4e57-4e71-911b-cdfa05acca2c_compressed.png";
 var GOOGLE_LOGO2 = "https://d31vvfpk2ppdyq.cloudfront.net/assets/image/192485d2-a76a-4657-9c06-930b2c70badd_compressed.png";
 var VIDEO_MODELS = [
+  // Google shuts down the Veo 3.1 previews and Omni Flash 1.0 on 2026-10-22.
   {
     id: "veo-3.1",
     aliases: [
@@ -1385,8 +1394,9 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-generate-preview",
-    lifecycle: "active",
-    exposure: ["cowork", "space_builder"],
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
+    exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
       resolutions: ["720p", "1080p", "4k"],
@@ -1421,7 +1431,8 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-fast-generate-preview",
-    lifecycle: "active",
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
     exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
@@ -1451,7 +1462,8 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "veo-3.1-lite-generate-preview",
-    lifecycle: "active",
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
     exposure: [],
     constraints: {
       aspectRatios: [...OMNI_RATIOS],
@@ -1482,8 +1494,9 @@ var VIDEO_MODELS = [
     type: "video",
     adapter: "google-genai",
     providerModelId: "gemini-omni-flash-preview",
-    lifecycle: "active",
-    exposure: ["cowork", "space_builder"],
+    lifecycle: "deprecated",
+    replacedBy: "gemini-omni-1.1-flash",
+    exposure: [],
     constraints: {
       // 1.0 rejects `resolution`; it renders 720p. No defaults: the adapter
       // sends ratio and duration only when the caller set them, so a
@@ -2038,7 +2051,8 @@ var VIDEO_MODELS = [
     },
     defaults: {},
     usage: { ...VIDEO_USAGE },
-    pricingKind: "video_per_second",
+    // Higgsfield bills DoP per generation: a fixed-length clip with no duration knob.
+    pricingKind: "flat",
     display: {
       provider: "higgsfield",
       description: "Higgsfield DOP image-to-video model; animates a required first-frame image from a text prompt with an optional last-frame image and motion controls."