@dropout-ai/runtime 0.4.3 → 0.4.5

package/README.md

@@ -115,6 +115,61 @@ bootstrap();
 | `apiKey` | `string` | Your Secret Key (`dp_live_...`). | ✅ |
 | `debug` | `boolean` | Set `true` to see "🟢 Online" logs and errors in console. | No |
 | `privacy` | `string` | `full` (capture text) or `mask` (metadata only). Default: `full`. | No |
+| `sessionId` | `string` | Optional initial session ID. If not provided, one is generated. | No |
+| `captureEndpoint` | `string` | Custom capture endpoint (for testing). Default: production URL. | No |
+
+---
+
+## 🔑 Session Management
+
+**Important:** A **session** represents a single conversation thread. By default, Dropout generates one session ID when initialized and uses it for all interactions. For proper analytics, you should call `startNewSession()` whenever the user starts a new conversation.
+
+### When to Call `startNewSession()`
+
+Call this method when:
+- User clicks "New Chat" button
+- User switches to a different conversation thread
+- User switches AI models (if you want to treat that as a new conversation)
+- Page refreshes and you want to start a fresh session
+
+### Example Usage
+
+```javascript
+const Dropout = require('@dropout-ai/runtime');
+
+// Initialize once at app startup
+const dropout = Dropout.init({
+  apiKey: process.env.DROPOUT_API_KEY,
+  projectId: process.env.DROPOUT_PROJECT_ID
+});
+
+// Later, when user clicks "New Chat":
+app.post('/api/new-chat', (req, res) => {
+  const newSessionId = dropout.startNewSession();
+  console.log(`Started new session: ${newSessionId}`);
+  res.json({ sessionId: newSessionId });
+});
+
+// Or with a custom session ID:
+dropout.startNewSession('user_123_chat_456');
+```
+
+### TypeScript Example
+
+```typescript
+import Dropout from '@dropout-ai/runtime';
+
+const dropout = Dropout.init({
+  apiKey: process.env.DROPOUT_API_KEY!,
+  projectId: process.env.DROPOUT_PROJECT_ID!
+});
+
+// Access current session
+console.log(dropout.currentSessionId);
+
+// Start new session
+const newSessionId = dropout.startNewSession();
+```
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dropout-ai/runtime",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Invisible Node.js runtime for understanding behavioral impact of AI interactions.",
   "main": "src/index.js",
   "types": "src/index.d.ts",

package/src/index.d.ts

@@ -5,6 +5,8 @@ export interface DropoutConfig {
     apiKey: string;
     debug?: boolean;
     privacy?: 'full' | 'mask';
+    sessionId?: string;
+    captureEndpoint?: string;
 }
 
 export default class Dropout {
@@ -28,11 +30,24 @@ export default class Dropout {
      */
     privacy: 'full' | 'mask';
 
+    /**
+     * Current session ID for tracking conversation threads.
+     */
+    currentSessionId: string;
+
     /**
      * Universal Initialization Method (Idempotent).
      * Safe to call multiple times; will only initialize once.
      */
     static init(config: DropoutConfig): Dropout;
 
+    /**
+     * Start a new session (e.g., when user clicks "New Chat").
+     * Resets turn counter and generates a fresh session ID.
+     * @param customSessionId - Optional custom session ID, otherwise auto-generates
+     * @returns The new session ID
+     */
+    startNewSession(customSessionId?: string): string;
+
     constructor(config: DropoutConfig);
 }

package/src/index.js

@@ -69,7 +69,7 @@ class Dropout {
       this.apiKey = config.apiKey;
       this.debug = config.debug || false;
       this.privacy = config.privacy || 'full';
-      this.captureEndpoint = SUPABASE_FUNCTION_URL;
+      this.captureEndpoint = config.captureEndpoint || SUPABASE_FUNCTION_URL;
       this.maxOutputBytes = 32768;
 
       // State
@@ -86,10 +86,10 @@ class Dropout {
       }
       global.__dropout_initialized__ = true;
 
-      // Identity
-      if (!global.__dropout_session_id__) {
-        global.__dropout_session_id__ = this.generateSessionId();
-      }
+      // ✅ Session Identity (Instance-Level, Not Global)
+      // Accept session_id from config OR generate a default
+      // Host app controls session lifecycle via startNewSession()
+      this.currentSessionId = config.sessionId || this.generateSessionId();
 
       // ✅ VISUAL SUCCESS INDICATOR
       if (this.debug) {
@@ -103,9 +103,6 @@ class Dropout {
       // 4. Start Network Interceptor
       this.patchNetwork();
 
-      // 5. SEND STARTUP PING
-      //this.sendStartupSignal();
-
       // Lock the instance
       Dropout.instance = this;
 
@@ -128,33 +125,23 @@ class Dropout {
     }
   }
 
-  // --- HEARTBEAT ---
-  sendStartupSignal() {
-    const payload = JSON.stringify({
-      project_id: this.projectId,
-      session_id: 'system_boot_' + Date.now(),
-      turn_role: 'system',
-      turn_index: 0,
-      content: 'Dropout SDK Initialized',
-      metadata_flags: {
-        type: 'system_boot',
-        environment: process.env.NODE_ENV || 'development',
-        runtime: 'node'
-      },
-      received_at: new Date().toISOString()
-    });
-
-    const req = https.request(this.captureEndpoint, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-dropout-key': this.apiKey
-      }
-    });
-
-    req.on('error', (e) => this.log("❌ Startup Signal Failed", e.message));
-    req.write(payload);
-    req.end();
+  /**
+   * 🔑 START NEW SESSION
+   * Call this when user clicks "New Chat" or starts a new conversation thread.
+   * Resets turn counter and generates a fresh session_id.
+   * @param {string} [customSessionId] - Optional custom session ID, otherwise auto-generates
+   * @returns {string} The new session ID
+   */
+  startNewSession(customSessionId) {
+    this.currentSessionId = customSessionId || this.generateSessionId();
+    this.turnIndex = 0; // Reset turn counter for new session
+    this.lastTurnConfirmed = true;
+    this.lastPromptHash = null;
+    this.lastResponseHash = null;
+    if (this.debug) {
+      console.log(`[Dropout] 🔄 New Session Started: ${this.currentSessionId}`);
+    }
+    return this.currentSessionId;
   }
 
   hash(text) {
@@ -208,6 +195,8 @@ class Dropout {
         session_id: payload.session_id,
         turn_index: payload.turn_index,
         turn_role: payload.turn_role,
+        // ✅ DIRECTION LOGIC APPLIED HERE
+        direction: payload.turn_role === 'user' ? 'user_to_ai' : 'ai_to_user',
         provider: payload.provider,
         model: payload.model,
         latency_ms: payload.latency_ms || null,
@@ -219,7 +208,10 @@ class Dropout {
 
       this.log(`🚀 Sending Capture [${payload.turn_role}]`);
 
-      const req = https.request(this.captureEndpoint, {
+      const isHttp = this.captureEndpoint.startsWith('http:');
+      const requestModule = isHttp ? http : https;
+
+      const req = requestModule.request(this.captureEndpoint, {
         method: 'POST',
         headers: {
           'Content-Type': 'application/json',
@@ -270,7 +262,7 @@ class Dropout {
         const pHash = _this.hash(bodyStr);
 
         _this.emit({
-          session_id: global.__dropout_session_id__,
+          session_id: _this.currentSessionId,
           turn_index: activeTurn,
           turn_role: 'user',
           provider,
@@ -295,7 +287,7 @@ class Dropout {
           const oHash = _this.hash(oText);
 
           _this.emit({
-            session_id: global.__dropout_session_id__,
+            session_id: _this.currentSessionId,
             turn_index: activeTurn,
             turn_role: 'assistant',
             latency_ms: latency,
@@ -381,7 +373,7 @@ class Dropout {
             clientRequest._dropout_model = model;
 
             _this.emit({
-              session_id: global.__dropout_session_id__,
+              session_id: _this.currentSessionId,
               turn_index: activeTurn,
               turn_role: 'user',
               provider,
@@ -408,7 +400,7 @@ class Dropout {
               const oHash = _this.hash(resBody);
 
               _this.emit({
-                session_id: global.__dropout_session_id__,
+                session_id: _this.currentSessionId,
                 turn_index: clientRequest._dropout_turn || 0,
                 turn_role: 'assistant',
                 latency_ms: latency,
@@ -444,4 +436,6 @@ if (typeof process !== 'undefined' && process.env.DROPOUT_PROJECT_ID && process.
   });
 }
 
+// 🛡️ DUAL EXPORT FIX (Crucial for TypeScript + Require compatibility)
+Dropout.default = Dropout;
 module.exports = Dropout;