@rouvanpm/rouva 0.2.9 → 0.2.10

package/dist/index.d.mts

@@ -56,7 +56,7 @@ type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral'
  * as-is. Until the gateway's registry knows their pricing, such requests are
  * logged with token counts but zero cost.
  */
-type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5.4-mini' | 'gpt-5' | 'gpt-5.6' | '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-v4-flash' | 'deepseek-v4-flash-think' | 'deepseek-v4-pro' | 'mistral-small-latest' | 'mistral-large-latest' | 'kimi-k2.6' | 'kimi-k3' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | 'grok-4.5' | 'glm-4.7-flash' | 'glm-5.2' | (string & {});
+type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5.4-mini' | 'gpt-5' | 'gpt-5.6' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-3.7-flash' | 'gemini-3.6-flash' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-v4-flash' | 'deepseek-v4-flash-think' | 'deepseek-v4-pro' | 'mistral-small-latest' | 'mistral-large-latest' | 'kimi-k2.6' | 'kimi-k3' | 'grok-4.6' | 'grok-4.5' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | 'glm-4.7-flash' | 'glm-5.2' | (string & {});
 /** Anthropic-style text block — the array form of the `system` param */
 interface SystemTextBlock {
     type: 'text';
@@ -168,12 +168,27 @@ interface RouvaResponseMeta {
 declare class Rouva {
     private apiKey;
     private baseURL;
+    private _sessionId;
     readonly chat: {
         completions: {
             create(params: ChatCompletionParams): Promise<ChatCompletion | ReadableStream>;
         };
     };
     constructor(options: RouvaOptions);
+    /**
+     * Start a new agent session. Every subsequent `chat.completions.create()`
+     * call will include `x-rouva-session-id` so all turns are grouped in the
+     * Rouva dashboard. Call `endSession()` when the agent run is complete.
+     * Returns the generated session ID.
+     */
+    startSession(): string;
+    /**
+     * End the current session. Subsequent requests will not carry a session ID
+     * until `startSession()` is called again.
+     */
+    endSession(): void;
+    /** The active session ID, or undefined if no session is in progress. */
+    get sessionId(): string | undefined;
     private _createChatCompletion;
 }
 

package/dist/index.d.ts

@@ -56,7 +56,7 @@ type RouvaProvider = 'anthropic' | 'openai' | 'gemini' | 'deepseek' | 'mistral'
  * as-is. Until the gateway's registry knows their pricing, such requests are
  * logged with token counts but zero cost.
  */
-type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5.4-mini' | 'gpt-5' | 'gpt-5.6' | '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-v4-flash' | 'deepseek-v4-flash-think' | 'deepseek-v4-pro' | 'mistral-small-latest' | 'mistral-large-latest' | 'kimi-k2.6' | 'kimi-k3' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | 'grok-4.5' | 'glm-4.7-flash' | 'glm-5.2' | (string & {});
+type RouvaModel = 'claude-opus-4-6' | 'claude-opus-4-7' | 'claude-opus-4-8' | 'claude-sonnet-4-6' | 'claude-sonnet-5' | 'claude-haiku-4-5-20251001' | 'claude-fable-5' | 'gpt-5-nano' | 'gpt-5-mini' | 'gpt-5.4-mini' | 'gpt-5' | 'gpt-5.6' | 'gpt-4.1-nano' | 'gpt-4.1-mini' | 'gpt-4.1' | 'gpt-4o' | 'gpt-4o-mini' | 'gemini-3.7-flash' | 'gemini-3.6-flash' | 'gemini-2.5-flash' | 'gemini-2.5-pro' | 'deepseek-v4-flash' | 'deepseek-v4-flash-think' | 'deepseek-v4-pro' | 'mistral-small-latest' | 'mistral-large-latest' | 'kimi-k2.6' | 'kimi-k3' | 'grok-4.6' | 'grok-4.5' | 'grok-4.3' | 'grok-4.20-0309-reasoning' | 'glm-4.7-flash' | 'glm-5.2' | (string & {});
 /** Anthropic-style text block — the array form of the `system` param */
 interface SystemTextBlock {
     type: 'text';
@@ -168,12 +168,27 @@ interface RouvaResponseMeta {
 declare class Rouva {
     private apiKey;
     private baseURL;
+    private _sessionId;
     readonly chat: {
         completions: {
             create(params: ChatCompletionParams): Promise<ChatCompletion | ReadableStream>;
         };
     };
     constructor(options: RouvaOptions);
+    /**
+     * Start a new agent session. Every subsequent `chat.completions.create()`
+     * call will include `x-rouva-session-id` so all turns are grouped in the
+     * Rouva dashboard. Call `endSession()` when the agent run is complete.
+     * Returns the generated session ID.
+     */
+    startSession(): string;
+    /**
+     * End the current session. Subsequent requests will not carry a session ID
+     * until `startSession()` is called again.
+     */
+    endSession(): void;
+    /** The active session ID, or undefined if no session is in progress. */
+    get sessionId(): string | undefined;
     private _createChatCompletion;
 }
 

package/dist/index.js

@@ -383,15 +383,38 @@ var Rouva = class {
       }
     };
   }
+  /**
+   * Start a new agent session. Every subsequent `chat.completions.create()`
+   * call will include `x-rouva-session-id` so all turns are grouped in the
+   * Rouva dashboard. Call `endSession()` when the agent run is complete.
+   * Returns the generated session ID.
+   */
+  startSession() {
+    this._sessionId = `rva-sess-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    return this._sessionId;
+  }
+  /**
+   * End the current session. Subsequent requests will not carry a session ID
+   * until `startSession()` is called again.
+   */
+  endSession() {
+    this._sessionId = void 0;
+  }
+  /** The active session ID, or undefined if no session is in progress. */
+  get sessionId() {
+    return this._sessionId;
+  }
   async _createChatCompletion(params) {
     const url = `${this.baseURL}/api/gateway/messages`;
     const { stream: _stream, ...body } = params;
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this._sessionId) headers["x-rouva-session-id"] = this._sessionId;
     const res = await fetch(url, {
       method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${this.apiKey}`
-      },
+      headers,
       body: JSON.stringify(body)
     });
     if (!res.ok) {

package/dist/index.mjs

@@ -357,15 +357,38 @@ var Rouva = class {
       }
     };
   }
+  /**
+   * Start a new agent session. Every subsequent `chat.completions.create()`
+   * call will include `x-rouva-session-id` so all turns are grouped in the
+   * Rouva dashboard. Call `endSession()` when the agent run is complete.
+   * Returns the generated session ID.
+   */
+  startSession() {
+    this._sessionId = `rva-sess-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+    return this._sessionId;
+  }
+  /**
+   * End the current session. Subsequent requests will not carry a session ID
+   * until `startSession()` is called again.
+   */
+  endSession() {
+    this._sessionId = void 0;
+  }
+  /** The active session ID, or undefined if no session is in progress. */
+  get sessionId() {
+    return this._sessionId;
+  }
   async _createChatCompletion(params) {
     const url = `${this.baseURL}/api/gateway/messages`;
     const { stream: _stream, ...body } = params;
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this._sessionId) headers["x-rouva-session-id"] = this._sessionId;
     const res = await fetch(url, {
       method: "POST",
-      headers: {
-        "Content-Type": "application/json",
-        "Authorization": `Bearer ${this.apiKey}`
-      },
+      headers,
       body: JSON.stringify(body)
     });
     if (!res.ok) {

package/package.json

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