@sovant/sdk 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to the Sovant JavaScript/TypeScript SDK will be documented i
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.1] - 2025-09-15
+
+### Fixed
+- **Robust SSE parsing** - Complete rewrite of SSE parser to handle:
+  - Partial chunk reassembly
+  - Both `\n\n` and `\r\n\r\n` event boundaries
+  - Multi-line `data:` fields
+  - Comment lines starting with `:`
+  - Optional `event:` and `id:` fields
+- **Chat streaming** - Fixed `sendMessage()` to properly stream delta events with API keys
+- **API headers** - SDK now uses `x-sovant-api-key` header (matching docs) instead of `Authorization: Bearer`
+- **Session creation** - Fixed response parsing to expect session data at root level
+
+### Changed
+- Improved `sendMessage()` to handle both object and string message formats
+- Enhanced SSE event processing to parse JSON `text` fields from API responses
+
 ## [1.1.0] - 2025-09-15
 
 ### Added

package/README.md

@@ -52,22 +52,26 @@ Stream real-time chat responses with memory context:
 ```typescript
 import { Sovant } from '@sovant/sdk';
 
-const sovant = new Sovant({ apiKey: process.env.SOVANT_API_KEY });
+const client = new Sovant({ apiKey: process.env.SOVANT_API_KEY, baseUrl: 'https://sovant.ai' });
 
 // Create a chat session
-const session = await sovant.chat.createSession({
+const session = await client.chat.createSession({ title: 'Demo' });
+
+// Stream a response
+const stream = await client.chat.sendMessage(session.id, {
+  message: 'hello',
   provider: 'openai',
   model: 'gpt-4o-mini',
+  stream: true,
+  useMemory: true,
 });
 
-// Stream a response
-for await (const event of sovant.chat.sendMessage(session.id, 'Hey there!', { useMemory: true })) {
-  if (event.type === 'delta') process.stdout.write(event.data);
-  if (event.type === 'done') console.log('\n[done]');
+for await (const ev of stream) {
+  if (ev.type === 'delta') process.stdout.write(ev.data || '');
 }
 
 // Get chat history
-const messages = await sovant.chat.getMessages(session.id);
+const messages = await client.chat.getMessages(session.id);
 ```
 
 ## Profile Recall Helpers
@@ -76,16 +80,16 @@ Save and recall user profile facts with canonical patterns:
 
 ```typescript
 // Extract profile entity from text
-const extraction = sovant.recall.extractProfile("My name is Sarah");
-// { entity: 'name', value: 'Sarah' }
+const fact = await client.recall.extractProfile("i'm from kuching");
+// -> { entity: 'location', value: 'kuching' } | null
 
-// Save profile fact in canonical form
-await sovant.recall.saveProfileFact('location', 'Singapore');
-// Saves as: "user location is Singapore"
+if (fact) {
+  await client.recall.saveProfileFact(fact); // canonicalizes and persists
+}
 
 // Get all profile facts
-const facts = await sovant.recall.getProfileFacts();
-// { name: 'Sarah', location: 'Singapore', age: '28', preferences: ['dark mode', 'email updates'] }
+const profile = await client.recall.getProfileFacts();
+// -> { name?: string, age?: string|number, location?: string, preferences?: string[] }
 ```
 
 ## Configuration
@@ -286,6 +290,26 @@ const threadMemories = await sovant.memory.list({
 });
 ```
 
+## API Key Management
+
+Manage API keys programmatically:
+
+```typescript
+// List all API keys
+const keys = await client.keys.list();
+console.log(keys); // Array of key objects
+
+// Create a new API key
+const newKey = await client.keys.create({ name: 'CI key' });
+console.log(newKey.key); // The actual secret key (only shown once!)
+
+// Update key metadata
+await client.keys.update(newKey.id, { name: 'Production key' });
+
+// Revoke a key
+await client.keys.revoke(newKey.id);
+```
+
 ## Advanced Features
 
 ### Retry Configuration
@@ -316,7 +340,7 @@ const sovant = new Sovant({
 Connect to different environments:
 
 ```typescript
-const sovant = new Sovant({
+const client = new Sovant({
   apiKey: 'sk_live_...',
   baseUrl: 'https://staging.sovant.ai',
 });
@@ -428,6 +452,10 @@ The API implements rate limiting. The SDK automatically handles rate limit respo
 - Issues: [GitHub Issues](https://github.com/sovant-ai/javascript-sdk/issues)
 - Support: support@sovant.ai
 
+## Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for a detailed history of changes.
+
 ## License
 
 MIT - See [LICENSE](LICENSE) file for details.

package/dist/index.d.mts

@@ -199,10 +199,12 @@ interface Message {
     created_at: string;
 }
 interface SendMessageOptions {
+    message?: string;
     provider?: string;
     model?: string;
     useMemory?: boolean;
     captureToMemory?: boolean;
+    stream?: boolean;
     signal?: AbortSignal;
 }
 interface StreamEvent {
@@ -383,7 +385,7 @@ declare class ChatNamespace {
     /**
      * Send a message with SSE streaming
      */
-    sendMessage(sessionId: string, message: string, opts?: SendMessageOptions): AsyncGenerator<StreamEvent, void, unknown>;
+    sendMessage(sessionId: string, message: string | SendMessageOptions, opts?: SendMessageOptions): AsyncGenerator<StreamEvent, void, unknown>;
 }
 /**
  * Keys namespace for API key management

package/dist/index.d.ts

@@ -199,10 +199,12 @@ interface Message {
     created_at: string;
 }
 interface SendMessageOptions {
+    message?: string;
     provider?: string;
     model?: string;
     useMemory?: boolean;
     captureToMemory?: boolean;
+    stream?: boolean;
     signal?: AbortSignal;
 }
 interface StreamEvent {
@@ -383,7 +385,7 @@ declare class ChatNamespace {
     /**
      * Send a message with SSE streaming
      */
-    sendMessage(sessionId: string, message: string, opts?: SendMessageOptions): AsyncGenerator<StreamEvent, void, unknown>;
+    sendMessage(sessionId: string, message: string | SendMessageOptions, opts?: SendMessageOptions): AsyncGenerator<StreamEvent, void, unknown>;
 }
 /**
  * Keys namespace for API key management

package/dist/index.js

@@ -168,7 +168,7 @@ var HttpClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     const headers = {
-      "Authorization": `Bearer ${this.apiKey}`,
+      "x-sovant-api-key": this.apiKey,
       "Content-Type": "application/json",
       ...options.headers
     };
@@ -248,72 +248,64 @@ var HttpClient = class {
 };
 
 // src/sse-parser.ts
-function parseSSE(buffer) {
-  const events = [];
-  const lines = buffer.split("\n");
-  let currentEvent = {};
-  let remaining = "";
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    if (i === lines.length - 1 && !buffer.endsWith("\n")) {
-      remaining = line;
-      break;
-    }
-    if (line.trim() === "") {
-      if (currentEvent.data !== void 0) {
-        events.push({
-          event: currentEvent.event,
-          data: currentEvent.data,
-          id: currentEvent.id,
-          retry: currentEvent.retry
-        });
-        currentEvent = {};
+var SseParser = class {
+  constructor(onEvent) {
+    this.buffer = "";
+    this.onEvent = onEvent;
+  }
+  feed(chunk) {
+    if (!chunk) return;
+    this.buffer += chunk;
+    this.process();
+  }
+  process() {
+    let boundaryIndex = this.findBoundary(this.buffer);
+    while (boundaryIndex !== -1) {
+      const raw = this.buffer.slice(0, boundaryIndex);
+      this.buffer = this.buffer.slice(boundaryIndex + this.boundaryLength(this.buffer, boundaryIndex));
+      const lines = raw.split(/\r?\n/);
+      let eventName = "";
+      let dataLines = [];
+      let id;
+      for (const line of lines) {
+        if (!line) continue;
+        if (line.startsWith(":")) continue;
+        const idx = line.indexOf(":");
+        const field = idx === -1 ? line : line.slice(0, idx);
+        const value = idx === -1 ? "" : line.slice(idx + 1).replace(/^ /, "");
+        switch (field) {
+          case "event":
+            eventName = value;
+            break;
+          case "data":
+            dataLines.push(value);
+            break;
+          case "id":
+            id = value;
+            break;
+        }
       }
-      continue;
-    }
-    if (line.startsWith(":")) {
-      continue;
-    }
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) {
-      const field2 = line.trim();
-      if (field2 === "data") {
-        currentEvent.data = "";
+      const data = dataLines.join("\n");
+      const ev = { type: "event", event: eventName || "message", data, id };
+      this.onEvent(ev);
+      if (ev.event === "message" || ev.event === "delta" || ev.event === "") {
+        this.onEvent({ type: "delta", data: data ?? "" });
       }
-      continue;
-    }
-    const field = line.substring(0, colonIndex).trim();
-    let value = line.substring(colonIndex + 1);
-    if (value.startsWith(" ")) {
-      value = value.substring(1);
-    }
-    switch (field) {
-      case "event":
-        currentEvent.event = value;
-        break;
-      case "data":
-        if (currentEvent.data === void 0) {
-          currentEvent.data = value;
-        } else {
-          currentEvent.data += "\n" + value;
-        }
-        break;
-      case "id":
-        currentEvent.id = value;
-        break;
-      case "retry":
-        const retryTime = parseInt(value, 10);
-        if (!isNaN(retryTime)) {
-          currentEvent.retry = retryTime;
-        }
-        break;
+      boundaryIndex = this.findBoundary(this.buffer);
     }
   }
-  return {
-    events,
-    buffer: remaining
-  };
-}
+  findBoundary(buf) {
+    const n = buf.indexOf("\n\n");
+    const r = buf.indexOf("\r\n\r\n");
+    if (n === -1) return r;
+    if (r === -1) return n;
+    return Math.min(n, r);
+  }
+  boundaryLength(buf, start) {
+    if (buf.slice(start, start + 4) === "\r\n\r\n") return 4;
+    return 2;
+  }
+};
 
 // src/index.ts
 var Sovant = class {
@@ -552,7 +544,7 @@ var ChatNamespace = class {
       method: "POST",
       body: input || {}
     });
-    return response.data.session;
+    return response.data;
   }
   /**
    * Get a chat session by ID
@@ -592,22 +584,28 @@ var ChatNamespace = class {
    * Send a message with SSE streaming
    */
   async *sendMessage(sessionId, message, opts) {
+    const options = typeof message === "string" ? opts : message;
+    const messageText = typeof message === "string" ? message : message.message;
+    if (!messageText) {
+      yield { type: "error", data: "Message is required" };
+      return;
+    }
     const body = {
-      message,
-      provider: opts?.provider,
-      model: opts?.model,
-      useMemory: opts?.useMemory ?? true,
-      captureToMemory: opts?.captureToMemory ?? true
+      message: messageText,
+      provider: options?.provider,
+      model: options?.model,
+      useMemory: options?.useMemory ?? true,
+      stream: options?.stream ?? true
     };
     const response = await fetch(`${this.http.baseUrl}/api/v1/chat/sessions/${sessionId}/messages`, {
       method: "POST",
       headers: {
-        "authorization": `Bearer ${this.http.apiKey}`,
+        "x-sovant-api-key": this.http.apiKey,
         "content-type": "application/json",
         "accept": "text/event-stream"
       },
       body: JSON.stringify(body),
-      signal: opts?.signal
+      signal: options?.signal
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ message: "Request failed" }));
@@ -620,29 +618,43 @@ var ChatNamespace = class {
       return;
     }
     const decoder = new TextDecoder();
-    let buffer = "";
+    const queue = [];
+    const parser = new SseParser((ev) => {
+      queue.push(ev);
+    });
     try {
       while (true) {
         const { done, value } = await reader.read();
         if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const events = parseSSE(buffer);
-        buffer = events.buffer;
-        for (const event of events.events) {
-          if (event.data === "[DONE]") {
-            yield { type: "done" };
-            return;
-          }
-          try {
-            const parsed = JSON.parse(event.data);
-            if (parsed.content) {
-              yield { type: "delta", data: parsed.content };
+        const text = decoder.decode(value, { stream: true });
+        parser.feed(text);
+        while (queue.length > 0) {
+          const ev = queue.shift();
+          if (ev.type === "delta") {
+            try {
+              const parsed = JSON.parse(ev.data);
+              if (parsed.text !== void 0) {
+                yield { type: "delta", data: parsed.text };
+              } else if (parsed.data !== void 0) {
+                yield { type: "delta", data: parsed.data };
+              } else {
+                yield { type: "delta", data: ev.data };
+              }
+            } catch {
+              yield { type: "delta", data: ev.data };
+            }
+          } else if (ev.type === "event") {
+            if (ev.event === "done") {
+              yield { type: "done" };
+            } else if (ev.event === "error") {
+              yield { type: "error", data: ev.data };
+            } else if (ev.event === "meta" || ev.event === "provider") {
+              continue;
             }
-          } catch {
-            yield { type: "delta", data: event.data };
           }
         }
       }
+      yield { type: "done" };
     } catch (error) {
       if (error.name === "AbortError") {
         yield { type: "error", data: "Request cancelled" };

package/dist/index.mjs

@@ -138,7 +138,7 @@ var HttpClient = class {
     const controller = new AbortController();
     const timeoutId = setTimeout(() => controller.abort(), timeout);
     const headers = {
-      "Authorization": `Bearer ${this.apiKey}`,
+      "x-sovant-api-key": this.apiKey,
       "Content-Type": "application/json",
       ...options.headers
     };
@@ -218,72 +218,64 @@ var HttpClient = class {
 };
 
 // src/sse-parser.ts
-function parseSSE(buffer) {
-  const events = [];
-  const lines = buffer.split("\n");
-  let currentEvent = {};
-  let remaining = "";
-  for (let i = 0; i < lines.length; i++) {
-    const line = lines[i];
-    if (i === lines.length - 1 && !buffer.endsWith("\n")) {
-      remaining = line;
-      break;
-    }
-    if (line.trim() === "") {
-      if (currentEvent.data !== void 0) {
-        events.push({
-          event: currentEvent.event,
-          data: currentEvent.data,
-          id: currentEvent.id,
-          retry: currentEvent.retry
-        });
-        currentEvent = {};
+var SseParser = class {
+  constructor(onEvent) {
+    this.buffer = "";
+    this.onEvent = onEvent;
+  }
+  feed(chunk) {
+    if (!chunk) return;
+    this.buffer += chunk;
+    this.process();
+  }
+  process() {
+    let boundaryIndex = this.findBoundary(this.buffer);
+    while (boundaryIndex !== -1) {
+      const raw = this.buffer.slice(0, boundaryIndex);
+      this.buffer = this.buffer.slice(boundaryIndex + this.boundaryLength(this.buffer, boundaryIndex));
+      const lines = raw.split(/\r?\n/);
+      let eventName = "";
+      let dataLines = [];
+      let id;
+      for (const line of lines) {
+        if (!line) continue;
+        if (line.startsWith(":")) continue;
+        const idx = line.indexOf(":");
+        const field = idx === -1 ? line : line.slice(0, idx);
+        const value = idx === -1 ? "" : line.slice(idx + 1).replace(/^ /, "");
+        switch (field) {
+          case "event":
+            eventName = value;
+            break;
+          case "data":
+            dataLines.push(value);
+            break;
+          case "id":
+            id = value;
+            break;
+        }
       }
-      continue;
-    }
-    if (line.startsWith(":")) {
-      continue;
-    }
-    const colonIndex = line.indexOf(":");
-    if (colonIndex === -1) {
-      const field2 = line.trim();
-      if (field2 === "data") {
-        currentEvent.data = "";
+      const data = dataLines.join("\n");
+      const ev = { type: "event", event: eventName || "message", data, id };
+      this.onEvent(ev);
+      if (ev.event === "message" || ev.event === "delta" || ev.event === "") {
+        this.onEvent({ type: "delta", data: data ?? "" });
       }
-      continue;
-    }
-    const field = line.substring(0, colonIndex).trim();
-    let value = line.substring(colonIndex + 1);
-    if (value.startsWith(" ")) {
-      value = value.substring(1);
-    }
-    switch (field) {
-      case "event":
-        currentEvent.event = value;
-        break;
-      case "data":
-        if (currentEvent.data === void 0) {
-          currentEvent.data = value;
-        } else {
-          currentEvent.data += "\n" + value;
-        }
-        break;
-      case "id":
-        currentEvent.id = value;
-        break;
-      case "retry":
-        const retryTime = parseInt(value, 10);
-        if (!isNaN(retryTime)) {
-          currentEvent.retry = retryTime;
-        }
-        break;
+      boundaryIndex = this.findBoundary(this.buffer);
     }
   }
-  return {
-    events,
-    buffer: remaining
-  };
-}
+  findBoundary(buf) {
+    const n = buf.indexOf("\n\n");
+    const r = buf.indexOf("\r\n\r\n");
+    if (n === -1) return r;
+    if (r === -1) return n;
+    return Math.min(n, r);
+  }
+  boundaryLength(buf, start) {
+    if (buf.slice(start, start + 4) === "\r\n\r\n") return 4;
+    return 2;
+  }
+};
 
 // src/index.ts
 var Sovant = class {
@@ -522,7 +514,7 @@ var ChatNamespace = class {
       method: "POST",
       body: input || {}
     });
-    return response.data.session;
+    return response.data;
   }
   /**
    * Get a chat session by ID
@@ -562,22 +554,28 @@ var ChatNamespace = class {
    * Send a message with SSE streaming
    */
   async *sendMessage(sessionId, message, opts) {
+    const options = typeof message === "string" ? opts : message;
+    const messageText = typeof message === "string" ? message : message.message;
+    if (!messageText) {
+      yield { type: "error", data: "Message is required" };
+      return;
+    }
     const body = {
-      message,
-      provider: opts?.provider,
-      model: opts?.model,
-      useMemory: opts?.useMemory ?? true,
-      captureToMemory: opts?.captureToMemory ?? true
+      message: messageText,
+      provider: options?.provider,
+      model: options?.model,
+      useMemory: options?.useMemory ?? true,
+      stream: options?.stream ?? true
     };
     const response = await fetch(`${this.http.baseUrl}/api/v1/chat/sessions/${sessionId}/messages`, {
       method: "POST",
       headers: {
-        "authorization": `Bearer ${this.http.apiKey}`,
+        "x-sovant-api-key": this.http.apiKey,
         "content-type": "application/json",
         "accept": "text/event-stream"
       },
       body: JSON.stringify(body),
-      signal: opts?.signal
+      signal: options?.signal
     });
     if (!response.ok) {
       const error = await response.json().catch(() => ({ message: "Request failed" }));
@@ -590,29 +588,43 @@ var ChatNamespace = class {
       return;
     }
     const decoder = new TextDecoder();
-    let buffer = "";
+    const queue = [];
+    const parser = new SseParser((ev) => {
+      queue.push(ev);
+    });
     try {
       while (true) {
         const { done, value } = await reader.read();
         if (done) break;
-        buffer += decoder.decode(value, { stream: true });
-        const events = parseSSE(buffer);
-        buffer = events.buffer;
-        for (const event of events.events) {
-          if (event.data === "[DONE]") {
-            yield { type: "done" };
-            return;
-          }
-          try {
-            const parsed = JSON.parse(event.data);
-            if (parsed.content) {
-              yield { type: "delta", data: parsed.content };
+        const text = decoder.decode(value, { stream: true });
+        parser.feed(text);
+        while (queue.length > 0) {
+          const ev = queue.shift();
+          if (ev.type === "delta") {
+            try {
+              const parsed = JSON.parse(ev.data);
+              if (parsed.text !== void 0) {
+                yield { type: "delta", data: parsed.text };
+              } else if (parsed.data !== void 0) {
+                yield { type: "delta", data: parsed.data };
+              } else {
+                yield { type: "delta", data: ev.data };
+              }
+            } catch {
+              yield { type: "delta", data: ev.data };
+            }
+          } else if (ev.type === "event") {
+            if (ev.event === "done") {
+              yield { type: "done" };
+            } else if (ev.event === "error") {
+              yield { type: "error", data: ev.data };
+            } else if (ev.event === "meta" || ev.event === "provider") {
+              continue;
             }
-          } catch {
-            yield { type: "delta", data: event.data };
           }
         }
       }
+      yield { type: "done" };
     } catch (error) {
       if (error.name === "AbortError") {
         yield { type: "error", data: "Request cancelled" };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sovant/sdk",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "Official JavaScript/TypeScript SDK for Sovant Memory API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",