feat: add Fireworks AI provider and fix model tier resolution

.changeset/add-fireworks-provider.md

@@ -0,0 +1,8 @@
+---
+"@perstack/core": patch
+"@perstack/runtime": patch
+"@perstack/fireworks-provider": patch
+"perstack": patch
+---
+
+feat: add Fireworks AI provider

.github/workflows/e2e.yml

@@ -79,6 +79,7 @@ jobs:
           EXA_API_KEY: ${{ secrets.EXA_API_KEY }}
           OPENAI_API_KEY: ${{ secrets.OPENAI_API_KEY }}
           GOOGLE_GENERATIVE_AI_API_KEY: ${{ secrets.GOOGLE_GENERATIVE_AI_API_KEY }}
+          FIREWORKS_API_KEY: ${{ secrets.FIREWORKS_API_KEY }}
           PERSTACK_API_KEY: ${{ secrets.PERSTACK_STAGING_API_KEY }}
 
   # Gate job for branch protection: required check that passes when E2E is

e2e/lib/prerequisites.ts

@@ -9,3 +9,7 @@ export function hasAnthropicKey(): boolean {
 export function hasGoogleKey(): boolean {
   return !!process.env.GOOGLE_GENERATIVE_AI_API_KEY
 }
+
+export function hasFireworksKey(): boolean {
+  return !!process.env.FIREWORKS_API_KEY
+}

e2e/perstack-cli/providers.test.ts

@@ -1,6 +1,11 @@
 import { describe, expect, it } from "bun:test"
 import { assertEventSequenceContains } from "../lib/assertions.js"
-import { hasAnthropicKey, hasGoogleKey, hasOpenAIKey } from "../lib/prerequisites.js"
+import {
+  hasAnthropicKey,
+  hasFireworksKey,
+  hasGoogleKey,
+  hasOpenAIKey,
+} from "../lib/prerequisites.js"
 import { runCli, withEventParsing } from "../lib/runner.js"
 
 const CONFIG = "./e2e/experts/providers.toml"
@@ -10,6 +15,7 @@ const providers = [
   { provider: "openai", hasKey: hasOpenAIKey },
   { provider: "anthropic", hasKey: hasAnthropicKey },
   { provider: "google", hasKey: hasGoogleKey },
+  { provider: "fireworks", hasKey: hasFireworksKey },
 ]
 
 describe.concurrent("LLM Providers", () => {

packages/core/src/known-models/index.ts

@@ -200,6 +200,32 @@ export const knownModels = [
       },
     ],
   },
+  {
+    provider: "fireworks",
+    models: [
+      // https://fireworks.ai/models/fireworks/kimi-k2p5
+      {
+        name: "accounts/fireworks/models/kimi-k2p5",
+        tier: "high" as const,
+        contextWindow: 262_144,
+        maxOutputTokens: 262_144,
+      },
+      // https://fireworks.ai/models/fireworks/deepseek-v3p2
+      {
+        name: "accounts/fireworks/models/deepseek-v3p2",
+        tier: "high" as const,
+        contextWindow: 163_840,
+        maxOutputTokens: 163_840,
+      },
+      // https://fireworks.ai/models/fireworks/glm-5
+      {
+        name: "accounts/fireworks/models/glm-5",
+        tier: "high" as const,
+        contextWindow: 202_752,
+        maxOutputTokens: 202_752,
+      },
+    ],
+  },
   {
     provider: "ollama",
     models: [