@rouvanpm/rouva 0.1.4 → 0.2.1

package/README.md

@@ -24,7 +24,7 @@ console.log(response.choices[0].message.content)
 
 ## Provider agnostic
 
-Rouva works with all connected providers — Anthropic, OpenAI, Gemini, DeepSeek, Mistral, and xAI Grok. You can request a specific model, force a specific provider, or omit both and let Rouva route to the cheapest capable model automatically.
+Rouva works with all connected providers — Anthropic, OpenAI, Gemini, DeepSeek, and Mistral. You can request a specific model, force a specific provider, or omit both and let Rouva route to the cheapest capable model automatically.
 
 ```typescript
 // Request a specific model
@@ -35,8 +35,8 @@ const res = await rouva.chat.completions.create({
 
 // Force a specific provider + model
 const res = await rouva.chat.completions.create({
-  provider: 'xai',
-  model: 'grok-4.3',
+  provider: 'gemini',
+  model: 'gemini-2.5-pro',
   messages,
 })
 

package/dist/index.d.mts

@@ -8,17 +8,29 @@ interface Message {
     role: 'system' | 'user' | 'assistant';
     content: string;
 }
-type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral' | 'xai' | (string & {});
+type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral' | (string & {});
 /**
  * Supported models across all providers.
  * Omit `model` entirely to let Rouva route to the cheapest capable model automatically.
  */
-type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-chat' | 'deepseek-reasoner' | 'mistral-small-latest' | 'mistral-large-latest' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | (string & {});
+type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-chat' | 'deepseek-reasoner' | 'mistral-small-latest' | 'mistral-large-latest' | (string & {});
+/** Anthropic-style text block — the array form of the `system` param */
+interface SystemTextBlock {
+    type: 'text';
+    text: string;
+}
 interface ChatCompletionParams {
     messages: Message[];
+    /**
+     * System prompt — a plain string or Anthropic-style text blocks.
+     * Equivalent to a `role: "system"` message at the head of `messages`;
+     * the gateway accepts both forms and re-emits whichever dialect the
+     * routed provider expects, so it survives cross-provider routing.
+     */
+    system?: string | SystemTextBlock[];
     /**
      * Target model — omit to let Rouva route intelligently to the cheapest capable model.
-     * Supports models from any connected provider.
+     * Supports models from any connected provider (Anthropic, OpenAI).
      */
     model?: RouvaModel;
     /**
@@ -76,4 +88,4 @@ declare class Rouva {
     private _createChatCompletion;
 }
 
-export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaProvider, type RouvaResponseMeta };
+export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaProvider, type RouvaResponseMeta, type SystemTextBlock };

package/dist/index.d.ts

@@ -8,17 +8,29 @@ interface Message {
     role: 'system' | 'user' | 'assistant';
     content: string;
 }
-type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral' | 'xai' | (string & {});
+type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral' | (string & {});
 /**
  * Supported models across all providers.
  * Omit `model` entirely to let Rouva route to the cheapest capable model automatically.
  */
-type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-chat' | 'deepseek-reasoner' | 'mistral-small-latest' | 'mistral-large-latest' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | (string & {});
+type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5' | 'gpt-5.5' | 'gpt-5.5-pro' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-chat' | 'deepseek-reasoner' | 'mistral-small-latest' | 'mistral-large-latest' | (string & {});
+/** Anthropic-style text block — the array form of the `system` param */
+interface SystemTextBlock {
+    type: 'text';
+    text: string;
+}
 interface ChatCompletionParams {
     messages: Message[];
+    /**
+     * System prompt — a plain string or Anthropic-style text blocks.
+     * Equivalent to a `role: "system"` message at the head of `messages`;
+     * the gateway accepts both forms and re-emits whichever dialect the
+     * routed provider expects, so it survives cross-provider routing.
+     */
+    system?: string | SystemTextBlock[];
     /**
      * Target model — omit to let Rouva route intelligently to the cheapest capable model.
-     * Supports models from any connected provider.
+     * Supports models from any connected provider (Anthropic, OpenAI).
      */
     model?: RouvaModel;
     /**
@@ -76,4 +88,4 @@ declare class Rouva {
     private _createChatCompletion;
 }
 
-export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaProvider, type RouvaResponseMeta };
+export { type ChatCompletion, type ChatCompletionChoice, type ChatCompletionParams, type ChatCompletionUsage, type Message, Rouva, type RouvaOptions, type RouvaProvider, type RouvaResponseMeta, type SystemTextBlock };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rouvanpm/rouva",
-  "version": "0.1.4",
+  "version": "0.2.1",
   "description": "Official Node.js SDK for Rouva — managed AI gateway with intelligent routing and spend tracking",
   "main": "dist/index.js",
   "module": "dist/index.mjs",