@shop-os/modelkit 0.3.5 → 0.3.6

package/CHANGELOG.md

@@ -9,6 +9,20 @@ header in the release PR.
 
 ## [Unreleased]
 
+## [0.3.6] - Unreleased
+
+### Added
+- Snapshot rows for Perplexity's Agent API, which replaced Sonar Chat Completions on 2026-09-27: `perplexity/sonar` (Sonar as an Agent API model; the row sends the `web_search` tool on every call, since a bare model does not search) and `perplexity/fast` (the `fast` preset, gpt-5.6-luna with one web search, Perplexity's replacement for Sonar and Sonar Pro).
+- A text usage event carries `reportedCostUsd` when the provider reports its own charge. Perplexity does (`providerMetadata.perplexity.cost.totalCost`), and its total includes web search tool calls, which tokens alone miss. Multi-step calls sum it per model.
+- `detectTextProvider` treats a `perplexity/` id as Perplexity.
+
+### Changed
+- `@ai-sdk/perplexity` peer range is `^3.1.0` (dev `^3.1.3`): 3.1 is the release that speaks the Agent API.
+- `sonar`, `sonar-pro` and `sonar-reasoning-pro` are `deprecated`, replaced by `perplexity/sonar`, `perplexity/fast` and `perplexity/fast`. Their bare ids are not Agent API models, so calls to them fail.
+
+### Live rows to add after publish
+Seed `perplexity/sonar` and `perplexity/fast` into the live catalog (pro-backend's model catalog seed inserts them once it runs 0.3.6), and mark the live `sonar`, `sonar-pro` and `sonar-reasoning-pro` rows deprecated in pro-admin: the seed never overwrites an existing row. pro-backend already prices both new ids (`credit_pricing_token` rows `perplexity/sonar` and `perplexity/fast`); once it runs 0.3.6, drop their entries from `SEED_KEY_EXCEPTIONS` and `USAGE_ID_ALLOWLIST`, which fail closed when the kit knows the id.
+
 ## [0.3.5] - Unreleased
 
 ### Fixed

package/dist/catalog.cjs

@@ -1244,12 +1244,18 @@ var TEXT_MODELS = [
       contextWindow: 1048576
     }
   }),
+  // Perplexity stopped serving Sonar Chat Completions on 2026-09-27; @ai-sdk/perplexity 3.1
+  // speaks the Agent API, which rejects the bare `sonar*` ids. Its migration guide maps Sonar
+  // and Sonar Pro to the `fast` preset and Sonar Reasoning Pro to `low`
+  // (docs.perplexity.ai/docs/agent-api/migrate-from-sonar/overview).
   text("sonar", "Sonar", "sonar", {
+    lifecycle: "deprecated",
+    replacedBy: "perplexity/sonar",
     exposure: [],
     display: {
       provider: "perplexity",
       costTier: 1,
-      description: "Perplexity Sonar lightweight web-grounded search model returning cited answers; 128K-token context."
+      description: "Perplexity Sonar on Chat Completions, which Perplexity stopped serving on 2026-09-27; calls now fail."
     },
     capabilities: {
       vision: true,
@@ -1257,11 +1263,13 @@ var TEXT_MODELS = [
     }
   }),
   text("sonar-pro", "Sonar Pro", "sonar-pro", {
+    lifecycle: "deprecated",
+    replacedBy: "perplexity/fast",
     exposure: [],
     display: {
       provider: "perplexity",
       costTier: 2,
-      description: "Perplexity Sonar Pro advanced web-grounded search model for complex multi-step queries; 200K-token context."
+      description: "Perplexity Sonar Pro on Chat Completions, which Perplexity stopped serving on 2026-09-27; calls now fail."
     },
     capabilities: {
       vision: true,
@@ -1269,12 +1277,49 @@ var TEXT_MODELS = [
     }
   }),
   text("sonar-reasoning-pro", "Sonar Reasoning Pro", "sonar-reasoning-pro", {
+    lifecycle: "deprecated",
+    replacedBy: "perplexity/fast",
     exposure: [],
     display: {
       provider: "perplexity",
       costTier: 2,
-      description: "Perplexity Sonar Reasoning Pro chain-of-thought web-grounded search model for complex problem-solving; 128K-token context."
+      description: "Perplexity Sonar Reasoning Pro on Chat Completions, which Perplexity stopped serving on 2026-09-27; calls now fail."
+    },
+    capabilities: {
+      vision: true,
+      contextWindow: 128e3
+    }
+  }),
+  // Sonar as an Agent API model. A bare model searches only when given the web_search
+  // tool, so the row sends it on every call; the answer's sources come from its results.
+  text("perplexity/sonar", "Perplexity Sonar", "perplexity/sonar", {
+    exposure: [],
+    providerOptions: {
+      modelkit: { provider: "perplexity" },
+      perplexity: { tools: [{ type: "web_search" }] }
+    },
+    display: {
+      provider: "perplexity",
+      costTier: 1,
+      description: "Perplexity Sonar on the Agent API with web search, returning answers grounded in cited sources."
+    },
+    // Perplexity publishes no Agent API context window; Sonar's own is 128K.
+    capabilities: {
+      vision: true,
+      contextWindow: 128e3
+    }
+  }),
+  // The Agent API `fast` preset: openai/gpt-5.6-luna with one web search, Perplexity's
+  // recommended replacement for Sonar and Sonar Pro.
+  text("perplexity/fast", "Perplexity Fast", "fast", {
+    exposure: [],
+    providerOptions: { modelkit: { provider: "perplexity" } },
+    display: {
+      provider: "perplexity",
+      costTier: 1,
+      description: "Perplexity Agent API fast preset: a quick web-grounded answer from one search."
     },
+    // No published preset window; Sonar's 128K, the size the preset replaces.
     capabilities: {
       vision: true,
       contextWindow: 128e3