@drawdream/livespeech 0.1.4 → 0.1.6

package/README.md

@@ -90,6 +90,7 @@ connect() → startSession() → audioStart() → sendAudioChunk()* → audioEnd
 const client = new LiveSpeechClient({
   region: 'ap-northeast-2',       // Required: Seoul region
   apiKey: 'your-api-key',         // Required: Your API key
+  userId: 'user-123',             // Optional: Enable conversation memory
   autoReconnect: true,            // Auto-reconnect on disconnect
   maxReconnectAttempts: 5,        // Maximum reconnection attempts
   debug: false,                   // Enable debug logging
@@ -101,6 +102,35 @@ await client.startSession({
 });
 ```
 
+## Conversation Memory
+
+When you provide a `userId`, the SDK enables persistent conversation memory:
+
+- **Entity Memory**: AI remembers facts shared in previous sessions (names, preferences, relationships)
+- **Session Summaries**: Recent conversation summaries are available to the AI
+- **Cross-Session**: Memory persists across sessions for the same `userId`
+
+```typescript
+// With memory (authenticated user)
+const client = new LiveSpeechClient({
+  region: 'ap-northeast-2',
+  apiKey: 'your-api-key',
+  userId: 'user-123',  // Enables conversation memory
+});
+
+// Without memory (guest)
+const client = new LiveSpeechClient({
+  region: 'ap-northeast-2',
+  apiKey: 'your-api-key',
+  // No userId = guest mode, no persistent memory
+});
+```
+
+| Mode | Memory Persistence | Use Case |
+|------|-------------------|----------|
+| With `userId` | Permanent | Authenticated users |
+| Without `userId` | Session only | Guests, anonymous users |
+
 ## Events
 
 | Event | Description | Key Properties |

package/dist/index.d.mts

@@ -46,6 +46,15 @@ interface LiveSpeechConfig {
      * API key for authentication
      */
     apiKey: string;
+    /**
+     * User identifier for conversation memory persistence.
+     * When provided, conversation history is stored and can be retrieved across sessions.
+     * If not provided, the user is treated as a "guest" and conversations are stored
+     * temporarily per connection.
+     *
+     * @example "user-123"
+     */
+    userId?: string;
     /**
      * Connection timeout in milliseconds
      * @default 30000
@@ -112,6 +121,7 @@ interface SessionConfig {
 interface ResolvedConfig {
     endpoint: string;
     apiKey: string;
+    userId?: string;
     connectionTimeout: number;
     autoReconnect: boolean;
     maxReconnectAttempts: number;

package/dist/index.d.ts

@@ -46,6 +46,15 @@ interface LiveSpeechConfig {
      * API key for authentication
      */
     apiKey: string;
+    /**
+     * User identifier for conversation memory persistence.
+     * When provided, conversation history is stored and can be retrieved across sessions.
+     * If not provided, the user is treated as a "guest" and conversations are stored
+     * temporarily per connection.
+     *
+     * @example "user-123"
+     */
+    userId?: string;
     /**
      * Connection timeout in milliseconds
      * @default 30000
@@ -112,6 +121,7 @@ interface SessionConfig {
 interface ResolvedConfig {
     endpoint: string;
     apiKey: string;
+    userId?: string;
     connectionTimeout: number;
     autoReconnect: boolean;
     maxReconnectAttempts: number;

package/dist/index.js

@@ -281,6 +281,9 @@ var WebSocketConnection = class {
       try {
         const url = new URL(this.config.endpoint);
         url.searchParams.set("apiKey", this.config.apiKey);
+        if (this.config.userId) {
+          url.searchParams.set("userId", this.config.userId);
+        }
         this.logger.info("Connecting to", url.origin);
         this.ws = new WebSocket(url.toString());
         const timeoutId = setTimeout(() => {
@@ -629,6 +632,7 @@ var LiveSpeechClient = class {
     this.config = {
       endpoint,
       apiKey: config.apiKey,
+      ...config.userId && { userId: config.userId },
       connectionTimeout: config.connectionTimeout ?? CONFIG_DEFAULTS.connectionTimeout,
       autoReconnect: config.autoReconnect ?? CONFIG_DEFAULTS.autoReconnect,
       maxReconnectAttempts: config.maxReconnectAttempts ?? CONFIG_DEFAULTS.maxReconnectAttempts,

package/dist/index.mjs

@@ -242,6 +242,9 @@ var WebSocketConnection = class {
       try {
         const url = new URL(this.config.endpoint);
         url.searchParams.set("apiKey", this.config.apiKey);
+        if (this.config.userId) {
+          url.searchParams.set("userId", this.config.userId);
+        }
         this.logger.info("Connecting to", url.origin);
         this.ws = new WebSocket(url.toString());
         const timeoutId = setTimeout(() => {
@@ -590,6 +593,7 @@ var LiveSpeechClient = class {
     this.config = {
       endpoint,
       apiKey: config.apiKey,
+      ...config.userId && { userId: config.userId },
       connectionTimeout: config.connectionTimeout ?? CONFIG_DEFAULTS.connectionTimeout,
       autoReconnect: config.autoReconnect ?? CONFIG_DEFAULTS.autoReconnect,
       maxReconnectAttempts: config.maxReconnectAttempts ?? CONFIG_DEFAULTS.maxReconnectAttempts,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawdream/livespeech",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "Real-time speech-to-speech AI conversation SDK",
   "main": "dist/index.js",
   "module": "dist/index.mjs",