feat: add OrcaRouter as a first-class model provider

.changeset/orcarouter-provider.md

@@ -0,0 +1,6 @@
+---
+"@truefoundry/trueforge": minor
+"@truefoundry/trueforge-core": minor
+---
+
+Add OrcaRouter as a first-class model provider: an OpenAI-compatible AI gateway covering model routing, failover, guardrails and agent tool governance behind one endpoint. Mirrors the existing well-known provider wiring (`buildLanguageModel` compatible-adapter case, manifest schema with a default base URL, and shipped catalog presets).

docs/models.mdx

@@ -18,6 +18,7 @@ TrueForge works with the major model providers and any OpenAI-compatible endpoin
 | `moonshot`      | Moonshot AI (Kimi)                                                     |
 | `zai`           | Z.ai (GLM)                                                             |
 | `alibaba`       | Alibaba (Qwen)                                                         |
+| `orcarouter`    | [OrcaRouter](https://www.orcarouter.ai) — OpenAI-compatible AI gateway |
 | `custom`        | Any OpenAI-compatible endpoint — self-hosted models, gateways, proxies |
 
 ## Configuring a standard provider

packages/trueforge-core/src/core/llm/VercelAILLM.ts

@@ -62,6 +62,7 @@ export const VERCEL_AI_PROVIDER_NAMES = [
   'moonshot',
   'alibaba',
   'together',
+  'orcarouter',
   'custom',
 ] as const;
 
@@ -121,9 +122,9 @@ function isFunctionToolCall<T extends { type: string }>(toolCall: T): toolCall i
 
 /**
  * Shared by every OpenAI-compatible provider, which differ only by endpoint. The provider type
- * doubles as the `providerOptions` key. Fireworks, Together and Z AI stay here rather than on their
- * own packages: those drop `json_schema`, and Fireworks also clamps efforts its models do accept.
- * TODO: move Z AI to @ai-sdk/zai once https://github.com/vercel/ai/pull/17340 ships.
+ * doubles as the `providerOptions` key. Fireworks, Together, Z AI and OrcaRouter stay here rather
+ * than on their own packages: those drop `json_schema`, and Fireworks also clamps efforts its
+ * models do accept. TODO: move Z AI to @ai-sdk/zai once https://github.com/vercel/ai/pull/17340 ships.
  */
 function compatibleModel(config: VercelAIProviderConfig): LanguageModel {
   const { provider, model, apiKey, headers, baseUrl } = config;
@@ -195,6 +196,7 @@ export function buildLanguageModel(config: VercelAIProviderConfig): LanguageMode
     case 'fireworks':
     case 'zai':
     case 'together':
+    case 'orcarouter':
     case 'custom': {
       return compatibleModel(config);
     }

packages/trueforge/catalog/model-catalog.yaml

@@ -366,3 +366,40 @@ providers:
           reasoning_efforts:
             - high
             - max
+  - type: orcarouter
+    models:
+      - model_id: orcarouter/auto
+        name: auto
+        properties:
+          reasoning_efforts:
+            - none
+            - low
+            - medium
+            - high
+      - model_id: orcarouter/fusion
+        name: fusion
+        properties:
+          context_length: 1000000
+          reasoning_efforts:
+            - none
+            - low
+            - medium
+            - high
+      - model_id: orcarouter/fusion-mini
+        name: fusion-mini
+        properties:
+          context_length: 1000000
+          reasoning_efforts:
+            - none
+            - low
+            - medium
+            - high
+      - model_id: orcarouter/fusion-flash
+        name: fusion-flash
+        properties:
+          context_length: 200000
+          reasoning_efforts:
+            - none
+            - low
+            - medium
+            - high

packages/trueforge/src/schemas/modelProvider.ts

@@ -127,6 +127,11 @@ const TogetherAIModelProviderSchema = wellKnownProviderSchema({
   base_url: 'https://api.together.xyz/v1',
 }).openapi('TogetherAIModelProvider');
 
+const OrcaRouterModelProviderSchema = wellKnownProviderSchema({
+  type: 'orcarouter',
+  base_url: 'https://api.orcarouter.ai/v1',
+}).openapi('OrcaRouterModelProvider');
+
 const AlibabaModelProviderSchema = wellKnownProviderSchema({
   type: 'alibaba',
   base_url: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
@@ -165,6 +170,7 @@ const ModelProviderBodySchema = z
     MoonshotModelProviderSchema,
     TogetherAIModelProviderSchema,
     AlibabaModelProviderSchema,
+    OrcaRouterModelProviderSchema,
     CustomModelProviderSchema,
   ])
   .superRefine(refineModelProviderManifest);