feat: add experimental modes to models to express things like "fast" that induce additional price changes

Author: rekram1-node

packages/core/src/schema.ts

@@ -88,6 +88,23 @@ export const Model = z
       output: z.number().min(0, "Output tokens must be positive"),
     }),
     status: z.enum(["alpha", "beta", "deprecated"]).optional(),
+    experimental: z
+      .object({
+        modes: z
+          .record(
+            z.object({
+              cost: Cost.optional(),
+              provider: z
+                .object({
+                  body: z.record(JsonValue).optional(),
+                  headers: z.record(z.string()).optional(),
+                })
+                .optional(),
+            }),
+          )
+          .optional(),
+      })
+      .optional(),
     provider: z
       .object({
         npm: z.string().optional(),

providers/anthropic/models/claude-opus-4-6.toml

@@ -22,3 +22,7 @@ output = 128_000
 [modalities]
 input = ["text", "image", "pdf"]
 output = ["text"]
+
+[experimental.modes.fast]
+cost = { input = 30.00, output = 150.00, cache_read = 3.00, cache_write = 37.50 }
+provider = { body = { speed = "fast" }, headers = { anthropic-beta = "fast-mode-2026-02-01" } }

providers/openai/models/gpt-5.4-mini.toml

@@ -23,3 +23,7 @@ output = 128_000
 [modalities]
 input = ["text", "image"]
 output = ["text"]
+
+[experimental.modes.fast]
+cost = { input = 1.50, output = 9.00, cache_read = 0.15 }
+provider = { body = { service_tier = "priority" } }

providers/openai/models/gpt-5.4.toml

@@ -28,3 +28,7 @@ output = 128_000
 [modalities]
 input = ["text", "image", "pdf"]
 output = ["text"]
+
+[experimental.modes.fast]
+cost = { input = 5.00, output = 30.00, cache_read = 0.50 }
+provider = { body = { service_tier = "priority" } }