@senseos/sdk (JS / TS)

SDK JavaScript / TypeScript pour SenseOS – Cognitive State & Adaptation Protocol (CSP).

Ce SDK fournit un client léger pour :

• envoyer des signaux cognitifs (stress, focus, fatigue),
• récupérer le dernier état cognitif calculé,
• réagir aux changements (onCognitiveChange).

Implémentation actuelle : mock local (classification C0–C3 en JS),
pensée pour être reliée ensuite au backend SenseOS (EFX / Supabase / Edge).

Installation (local, via monorepo)

cd senseos-sdk/js
npm install
npm run build
npm test

Utilisation
import { SenseOS } from "@senseos/sdk";

const sense = new SenseOS({
  apiKey: "demo-key",
  userId: "user-123",
  sessionId: "sess-456"
});

// Abonnement aux changements d'état
sense.onCognitiveChange((state) => {
  console.log("[SenseOS] nouvel état cognitif :", state);
});

// Envoi d'un triplet de signaux
const state = await sense.sendSignals({
  stress: 0.3,
  focus: 0.8,
  fatigue: 0.2
});

console.log("[SenseOS] état courant :", state);
API minimale :
new SenseOS(config)
apiKey (obligatoire)
endpoint?, userId?, sessionId?, nodeId?, debug?
await sendSignals({ stress, focus, fatigue, meta? }) → CognitiveState
getState() → dernier CognitiveState | null
onCognitiveChange(cb) → unsubscribe()
Modèle CSP (CognitiveState)
type CognitiveClass = "C0" | "C1" | "C2" | "C3";

interface CognitiveState {
  stress: number;
  focus: number;
  fatigue: number;
  confidence?: number;
  klass: CognitiveClass;
  timestamp?: string;
  source?: string;
  meta?: Record<string, unknown>;
}
Les règles de classification C0–C3 sont alignées sur la SPEC SenseOS v0.1 (CSP).
Limitations actuelles
pas encore de transport HTTP/WS vers un backend SenseOS réel,
classification locale (Brain-lite embarqué),
usage recommandé : prototypage, intégration early, tests de flux CSP côté front / Node.