@dropout-ai/runtime 0.2.5 → 0.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dropout-ai/runtime",
-  "version": "0.2.05",
+  "version": "0.2.07",
   "description": "Invisible Node.js runtime for capturing AI interactions.",
   "main": "src/index.js",
   "scripts": {

package/src/index.js

@@ -3,12 +3,12 @@
  * Role: Passive observer inside the user’s app.
  * 
  * Runtime never reasons, never interprets, never stores intelligence.
- * It only: Observes, Normalizes, Emits signals.
+ * it only: Observes, Normalizes, Emits signals.
  */
 
 const crypto = require('crypto');
 
-// --- A. Session Boundary (CRITICAL) ---
+// --- Identity & State ---
 const GLOBAL_OBJ = typeof window !== 'undefined' ? window : global;
 
 function generateSessionId() {
@@ -19,15 +19,16 @@ function generateSessionId() {
   }
 }
 
-// One session = one continuous user attempt
-// Resets on page reload (Browser) or process restart (Node)
 if (!GLOBAL_OBJ.__dropout_session_id__) {
   GLOBAL_OBJ.__dropout_session_id__ = generateSessionId();
 }
 
 let turnIndex = 0;
+let lastTurnConfirmed = true;
+let lastPromptHash = null;
+let lastResponseHash = null;
 
-// --- D. Runtime guarantees ---
+// --- Runtime Guarantees ---
 let config = {
   maxOutputBytes: 32768,
   captureEndpoint: 'http://localhost:4000/capture',
@@ -35,7 +36,7 @@ let config = {
   privacyMode: (typeof process !== 'undefined' && process.env.DROPOUT_PRIVACY_MODE) || 'safe'
 };
 
-// Zero user config required: Non-blocking remote config fetch
+// Remote config fetch (Non-blocking)
 setTimeout(async () => {
   const fetchFn = GLOBAL_OBJ.__dropout_original_fetch__ || GLOBAL_OBJ.fetch;
   if (typeof fetchFn !== 'function') return;
@@ -65,9 +66,42 @@ function emit(payload) {
   }, 0);
 }
 
-// --- C. Privacy Mode Helpers ---
+// --- Lifecycle Signals ---
 
-function getSemanticHash(text) {
+function emitSessionEnd(reason) {
+  if (GLOBAL_OBJ.__dropout_session_ended__) return;
+  GLOBAL_OBJ.__dropout_session_ended__ = true;
+
+  emit({
+    identity: {
+      session_id: GLOBAL_OBJ.__dropout_session_id__,
+      turn_index: turnIndex,
+      direction: 'meta',
+      turn_role: 'system'
+    },
+    timing: { created_at: Date.now() },
+    metadata_flags: {
+      session_end: true,
+      end_reason: reason
+    }
+  });
+}
+
+// Browser: Navigation/Reload
+if (typeof window !== 'undefined' && window.addEventListener) {
+  window.addEventListener('beforeunload', () => emitSessionEnd('navigation'));
+}
+
+// Node.js: Process Exit
+if (typeof process !== 'undefined' && process.on) {
+  process.on('exit', () => emitSessionEnd('process_exit'));
+  process.on('SIGINT', () => { emitSessionEnd('sigint'); process.exit(); });
+  process.on('SIGTERM', () => { emitSessionEnd('sigterm'); process.exit(); });
+}
+
+// --- Content Utilities ---
+
+function hash(text) {
   if (!text) return null;
   try {
     return crypto.createHash('sha256').update(text.toLowerCase().trim()).digest('hex');
@@ -76,34 +110,7 @@ function getSemanticHash(text) {
   }
 }
 
-function getMarkers(text) {
-  if (!text) return null;
-  return {
-    chars: text.length,
-    words: text.split(/\s+/).length,
-    lines: text.split('\n').length,
-    has_code: /```/.test(text),
-    has_list: /^\s*[-*•\d+.]/m.test(text)
-  };
-}
-
-const PATTERNS = {
-  negative: ["wrong", "bad", "not helpful", "incorrect", "stupid", "error", "worst"],
-  positive: ["thanks", "good", "perfect", "correct", "great", "helpful"],
-  struggle: ["but", "why", "stop", "don't", "no", "again", "explain"]
-};
-
-function getFlags(text) {
-  if (!text) return [];
-  const t = text.toLowerCase();
-  const flags = [];
-  if (PATTERNS.negative.some(p => t.includes(p))) flags.push('neg');
-  if (PATTERNS.positive.some(p => t.includes(p))) flags.push('pos');
-  if (PATTERNS.struggle.some(p => t.includes(p))) flags.push('clash');
-  return flags;
-}
-
-// --- B. Event Capture (Provider-agnostic) ---
+// --- Provider Normalization ---
 
 function normalize(url, body) {
   let provider = 'unknown';
@@ -131,16 +138,13 @@ function normalize(url, body) {
   return { provider, model };
 }
 
-/**
- * The Monkey Patch
- */
+// --- The Monkey Patch ---
+
 if (typeof GLOBAL_OBJ.fetch === 'function' && !GLOBAL_OBJ.fetch.__dropout_patched__) {
   GLOBAL_OBJ.__dropout_original_fetch__ = GLOBAL_OBJ.fetch;
 
   GLOBAL_OBJ.fetch = async function (input, init) {
-    const start = Date.now();
     const url = typeof input === 'string' ? input : (input && input.url);
-
     const isAI = url && (
       url.includes('openai.com') ||
       url.includes('anthropic.com') ||
@@ -149,50 +153,107 @@ if (typeof GLOBAL_OBJ.fetch === 'function' && !GLOBAL_OBJ.fetch.__dropout_patche
       (init && init.body && (init.body.includes('"model"') || init.body.includes('"messages"')))
     );
 
-    const response = await GLOBAL_OBJ.__dropout_original_fetch__(input, init);
+    if (!isAI) return GLOBAL_OBJ.__dropout_original_fetch__(input, init);
 
-    if (isAI) {
-      const latency = Date.now() - start;
-      const turn = turnIndex++;
-      const { provider, model } = normalize(url, init && init.body);
+    const start = Date.now();
 
-      let pText = "";
-      if (init && init.body) {
-        try { pText = typeof init.body === 'string' ? init.body : JSON.stringify(init.body); } catch (e) { }
-      }
+    // --- Explicit Turn Increment Rule ---
+    let activeTurn;
+    if (lastTurnConfirmed) {
+      activeTurn = turnIndex++;
+      lastTurnConfirmed = false;
+    } else {
+      activeTurn = turnIndex > 0 ? turnIndex - 1 : 0;
+    }
 
-      let oText = "";
-      try {
-        const cloned = response.clone();
-        oText = await cloned.text();
-        if (oText && oText.length > config.maxOutputBytes) {
-          oText = oText.slice(0, config.maxOutputBytes);
-        }
-      } catch (e) { }
+    const { provider, model } = normalize(url, init && init.body);
 
-      const payload = {
+    // --- 1. Emit Request Event ---
+    let pText = "";
+    if (init && init.body) {
+      try { pText = typeof init.body === 'string' ? init.body : JSON.stringify(init.body); } catch (e) { }
+    }
+    const pHash = hash(pText);
+    const isRetry = pHash && pHash === lastPromptHash;
+
+    const requestEvent = {
+      identity: {
         session_id: GLOBAL_OBJ.__dropout_session_id__,
-        timestamp: Date.now(),
-        latency,
-        turn_position: turn,
+        turn_index: activeTurn,
+        direction: 'request',
+        turn_role: 'user'
+      },
+      timing: {
+        created_at: Date.now()
+      },
+      provider_context: {
         provider,
-        model,
-        mode: config.privacyMode
-      };
-
-      if (config.privacyMode === 'full') {
-        payload.prompt = pText;
-        payload.output = oText;
-      } else {
-        payload.prompt_hash = getSemanticHash(pText);
-        payload.output_hash = getSemanticHash(oText);
-        payload.markers = { p: getMarkers(pText), o: getMarkers(oText) };
-        payload.flags = getFlags(pText + " " + oText);
+        model
+      },
+      content: {
+        content_raw: config.privacyMode === 'full' ? pText : null,
+        content_hash: pHash
+      },
+      metadata_flags: {
+        retry_like: isRetry ? 1 : 0
       }
+    };
+
+    emit(requestEvent);
+    lastPromptHash = pHash;
 
-      emit(payload);
+    // Execute actual fetch
+    let response;
+    let oText = "";
+    try {
+      response = await GLOBAL_OBJ.__dropout_original_fetch__(input, init);
+    } catch (err) {
+      throw err;
     }
 
+    const latency = Date.now() - start;
+
+    // --- 2. Emit Response Event ---
+    try {
+      const cloned = response.clone();
+      oText = await cloned.text();
+      if (oText && oText.length > config.maxOutputBytes) {
+        oText = oText.slice(0, config.maxOutputBytes);
+      }
+    } catch (e) { }
+
+    const oHash = hash(oText);
+    const isNonAdaptive = oHash && oHash === lastResponseHash;
+
+    const responseEvent = {
+      identity: {
+        session_id: GLOBAL_OBJ.__dropout_session_id__,
+        turn_index: activeTurn,
+        direction: 'response',
+        turn_role: 'assistant'
+      },
+      timing: {
+        created_at: Date.now(),
+        latency_ms: latency
+      },
+      provider_context: {
+        provider,
+        model
+      },
+      content: {
+        content_raw: config.privacyMode === 'full' ? oText : null,
+        content_hash: oHash
+      },
+      metadata_flags: {
+        non_adaptive_response: isNonAdaptive ? 1 : 0,
+        turn_boundary_confirmed: 1
+      }
+    };
+
+    emit(responseEvent);
+    lastResponseHash = oHash;
+    lastTurnConfirmed = true; // Confirmation Rule locked
+
     return response;
   };
 
@@ -205,78 +266,65 @@ if (typeof GLOBAL_OBJ.fetch === 'function' && !GLOBAL_OBJ.fetch.__dropout_patche
 async function capture(target, options = {}) {
   const start = Date.now();
 
-  // Resolve target (function, promise, or static object)
-  let result;
-  if (typeof target === 'function') {
-    result = await target();
-  } else if (target && typeof target.then === 'function') {
-    result = await target;
+  let activeTurn;
+  if (lastTurnConfirmed) {
+    activeTurn = turnIndex++;
+    lastTurnConfirmed = false;
   } else {
-    // case: capture({ prompt, output })
-    const { prompt, output } = target;
-    const latency = options.latency || 0;
-    const turn = turnIndex++;
-    const mode = options.privacy || config.privacyMode;
-
-    const payload = {
-      session_id: GLOBAL_OBJ.__dropout_session_id__,
-      timestamp: Date.now(),
-      latency,
-      turn_position: turn,
-      provider: options.provider || 'manual',
-      model: options.model || 'unknown',
-      mode
-    };
-
-    if (mode === 'full') {
-      payload.prompt = prompt;
-      payload.output = output;
-    } else {
-      payload.prompt_hash = getSemanticHash(prompt);
-      payload.output_hash = getSemanticHash(output);
-      payload.markers = { p: getMarkers(prompt), o: getMarkers(output) };
-      payload.flags = getFlags((prompt || "") + " " + (output || ""));
-    }
-
-    emit(payload);
-    return output;
+    activeTurn = turnIndex > 0 ? turnIndex - 1 : 0;
   }
 
-  // Wrapped execution capture
-  const latency = Date.now() - start;
-  const turn = turnIndex++;
   const mode = options.privacy || config.privacyMode;
-  const prompt = options.prompt;
-  const output = typeof result === 'string' ? result : JSON.stringify(result);
-
-  const payload = {
-    session_id: GLOBAL_OBJ.__dropout_session_id__,
-    timestamp: Date.now(),
-    latency,
-    turn_position: turn,
-    provider: options.provider || 'manual',
-    model: options.model || 'unknown',
-    mode
-  };
 
-  if (mode === 'full') {
-    payload.prompt = prompt;
-    payload.output = output;
+  let prompt, output, latency_ms = options.latency || 0;
+
+  if (typeof target === 'function' || (target && typeof target.then === 'function')) {
+    prompt = options.prompt;
+    const result = typeof target === 'function' ? await target() : await target;
+    output = typeof result === 'string' ? result : JSON.stringify(result);
+    latency_ms = Date.now() - start;
   } else {
-    payload.prompt_hash = getSemanticHash(prompt);
-    payload.output_hash = getSemanticHash(output);
-    payload.markers = { p: getMarkers(prompt), o: getMarkers(output) };
-    payload.flags = getFlags((prompt || "") + " " + (output || ""));
+    prompt = target.prompt;
+    output = target.output;
   }
 
-  emit(payload);
-  return result;
+  const pHash = hash(prompt);
+  const oHash = hash(output);
+
+  // Emit Request
+  emit({
+    identity: { session_id: GLOBAL_OBJ.__dropout_session_id__, turn_index: activeTurn, direction: 'request', turn_role: 'user' },
+    timing: { created_at: Date.now() },
+    provider_context: { provider: options.provider || 'manual', model: options.model || 'unknown' },
+    content: { content_raw: mode === 'full' ? prompt : null, content_hash: pHash },
+    metadata_flags: { retry_like: pHash === lastPromptHash ? 1 : 0 }
+  });
+
+  // Emit Response
+  emit({
+    identity: { session_id: GLOBAL_OBJ.__dropout_session_id__, turn_index: activeTurn, direction: 'response', turn_role: 'assistant' },
+    timing: { created_at: Date.now(), latency_ms },
+    provider_context: { provider: options.provider || 'manual', model: options.model || 'unknown' },
+    content: { content_raw: mode === 'full' ? output : null, content_hash: oHash },
+    metadata_flags: { non_adaptive_response: oHash === lastResponseHash ? 1 : 0, turn_boundary_confirmed: 1 }
+  });
+
+  lastPromptHash = pHash;
+  lastResponseHash = oHash;
+  lastTurnConfirmed = true;
+
+  return output;
 }
 
 module.exports = {
   capture,
-  reset: () => {
+  reset: (reason = 'manual_reset') => {
+    emitSessionEnd(reason);
     GLOBAL_OBJ.__dropout_session_id__ = generateSessionId();
+    GLOBAL_OBJ.__dropout_session_ended__ = false;
     turnIndex = 0;
+    lastTurnConfirmed = true;
+    lastPromptHash = null;
+    lastResponseHash = null;
   }
 };