overmind-mcp 2.8.12 → 2.8.14

package/dist/bridge/SessionStore.js

@@ -0,0 +1,220 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — SessionStore (Multi-Tenant Session Map)         ║
+ * ║                                                                      ║
+ * ║   Gère une map clé_externe → session_id avec TTL et persistence.     ║
+ * ║   Inspiré du pattern bt-sms (phone → sessionId avec TTL 4h).        ║
+ * ║                                                                      ║
+ * ║   USAGE                                                              ║
+ * ║   ─────                                                              ║
+ * ║   Clé externe = n'importe quoi : téléphone, user_id, channel_id,     ║
+ * ║   conversation_id, etc. Le bridge isole les sessions par clé.        ║
+ * ║                                                                      ║
+ * ║   {                                                                  ║
+ * ║     "agent.run": { agentName, runner, prompt, externalKey: "+1418..." } ║
+ * ║   }                                                                  ║
+ * ║   → le bridge retrouve ou crée une session pour cette clé,          ║
+ * ║   la passe à l'agent, et la sauvegarde dans le store.               ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { createBridgeLogger } from './utils.js';
+// ─── SessionStore ──────────────────────────────────────────────────────────
+export class SessionStore {
+    map = new Map();
+    log;
+    config;
+    cleanupTimer;
+    writeQueue = Promise.resolve();
+    constructor(config = {}, logger) {
+        this.config = {
+            ttlMs: config.ttlMs ?? 4 * 60 * 60 * 1000, // 4h
+            cleanupIntervalMs: config.cleanupIntervalMs ?? 5 * 60 * 1000, // 5min
+            persistPath: config.persistPath,
+        };
+        this.log = logger ?? createBridgeLogger('session-store');
+    }
+    // ─── Lifecycle ───────────────────────────────────────────────────────────
+    /**
+     * Initialise le store : charge le fichier de persistence si présent,
+     * démarre le cleanup périodique.
+     */
+    async init() {
+        if (this.config.persistPath) {
+            try {
+                const raw = await fs.readFile(this.config.persistPath, 'utf-8');
+                const parsed = JSON.parse(raw);
+                const now = Date.now();
+                let loaded = 0;
+                for (const entry of parsed.sessions ?? []) {
+                    // Skip les sessions expirées au load
+                    if (now - entry.lastActivityAt > this.config.ttlMs)
+                        continue;
+                    this.map.set(this.makeKey(entry.externalKey, entry.agentName), entry);
+                    loaded++;
+                }
+                this.log.info(`📂 Loaded ${loaded} session(s) from ${this.config.persistPath}`);
+            }
+            catch (err) {
+                if (err.code !== 'ENOENT') {
+                    this.log.warn(`⚠️  Failed to load sessions: ${err.message}`);
+                }
+            }
+        }
+        if (this.cleanupTimer)
+            clearInterval(this.cleanupTimer);
+        this.cleanupTimer = setInterval(() => this.purgeExpired(), this.config.cleanupIntervalMs);
+    }
+    /**
+     * Arrête le cleanup et persiste l'état final.
+     */
+    async close() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        await this.writeQueue; // attend les writes en cours
+        await this.persist();
+        this.log.info('🛑 SessionStore closed');
+    }
+    // ─── CRUD ────────────────────────────────────────────────────────────────
+    /**
+     * Récupère une session par (externalKey, agentName).
+     * Retourne undefined si absente ou expirée.
+     */
+    get(externalKey, agentName) {
+        const key = this.makeKey(externalKey, agentName);
+        const entry = this.map.get(key);
+        if (!entry)
+            return undefined;
+        if (this.isExpired(entry)) {
+            this.map.delete(key);
+            return undefined;
+        }
+        return { ...entry };
+    }
+    /**
+     * Sauvegarde ou met à jour une session. Retourne l'entrée.
+     */
+    set(entry) {
+        const full = { ...entry, lastActivityAt: entry.lastActivityAt ?? Date.now() };
+        const key = this.makeKey(full.externalKey, full.agentName);
+        this.map.set(key, full);
+        this.schedulePersist();
+        return full;
+    }
+    /**
+     * Met à jour uniquement le sessionId (cas typique : après un run, on a le vrai ID).
+     */
+    updateSessionId(externalKey, agentName, sessionId, runner) {
+        const key = this.makeKey(externalKey, agentName);
+        const existing = this.map.get(key);
+        if (!existing) {
+            return this.set({ externalKey, agentName, runner, sessionId });
+        }
+        existing.sessionId = sessionId;
+        existing.runner = runner;
+        existing.lastActivityAt = Date.now();
+        this.schedulePersist();
+        return { ...existing };
+    }
+    /**
+     * Met à jour le context (pattern CONTEXT_UPDATE de bt-sms).
+     */
+    updateContext(externalKey, agentName, patch) {
+        const entry = this.get(externalKey, agentName);
+        if (!entry)
+            return undefined;
+        entry.context = { ...(entry.context ?? {}), ...patch };
+        entry.lastActivityAt = Date.now();
+        this.map.set(this.makeKey(externalKey, agentName), entry);
+        this.schedulePersist();
+        return { ...entry };
+    }
+    /**
+     * Supprime une session.
+     */
+    delete(externalKey, agentName) {
+        const deleted = this.map.delete(this.makeKey(externalKey, agentName));
+        if (deleted)
+            this.schedulePersist();
+        return deleted;
+    }
+    /**
+     * Purge toutes les sessions (reset complet).
+     */
+    clear() {
+        this.map.clear();
+        this.schedulePersist();
+    }
+    // ─── Queries ────────────────────────────────────────────────────────────
+    /**
+     * Liste toutes les sessions actives (non expirées).
+     */
+    list() {
+        this.purgeExpired();
+        return Array.from(this.map.values()).map((e) => ({ ...e }));
+    }
+    /**
+     * Stats par agent.
+     */
+    stats() {
+        const byAgent = {};
+        for (const entry of this.map.values()) {
+            byAgent[entry.agentName] = (byAgent[entry.agentName] ?? 0) + 1;
+        }
+        return { total: this.map.size, byAgent };
+    }
+    // ─── Helpers ────────────────────────────────────────────────────────────
+    makeKey(externalKey, agentName) {
+        return `${agentName}::${externalKey}`;
+    }
+    isExpired(entry) {
+        return Date.now() - entry.lastActivityAt > this.config.ttlMs;
+    }
+    purgeExpired() {
+        const now = Date.now();
+        let purged = 0;
+        for (const [key, entry] of this.map) {
+            if (now - entry.lastActivityAt > this.config.ttlMs) {
+                this.map.delete(key);
+                purged++;
+            }
+        }
+        if (purged > 0) {
+            this.log.info(`🧹 Purged ${purged} expired sessions`);
+            this.schedulePersist();
+        }
+        return purged;
+    }
+    // ─── Persistence (queued, atomic) ───────────────────────────────────────
+    schedulePersist() {
+        if (!this.config.persistPath)
+            return;
+        this.writeQueue = this.writeQueue.then(() => this.persist()).catch((err) => {
+            this.log.error(`Persist error: ${err.message}`);
+        });
+    }
+    async persist() {
+        if (!this.config.persistPath)
+            return;
+        const data = { sessions: Array.from(this.map.values()) };
+        const tmp = this.config.persistPath + '.tmp';
+        try {
+            await fs.mkdir(path.dirname(this.config.persistPath), { recursive: true });
+            await fs.writeFile(tmp, JSON.stringify(data, null, 2), 'utf-8');
+            await fs.rename(tmp, this.config.persistPath);
+        }
+        catch (err) {
+            this.log.error(`Failed to persist sessions: ${err.message}`);
+            try {
+                await fs.unlink(tmp);
+            }
+            catch {
+                // ignore
+            }
+        }
+    }
+}
+//# sourceMappingURL=SessionStore.js.map

package/dist/bridge/SessionStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStore.js","sourceRoot":"","sources":["../../src/bridge/SessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAqB,MAAM,YAAY,CAAC;AAmCnE,8EAA8E;AAE9E,MAAM,OAAO,YAAY;IACN,GAAG,GAAG,IAAI,GAAG,EAAwB,CAAC;IACtC,GAAG,CAAe;IAClB,MAAM,CACmB;IAClC,YAAY,CAA6C;IACzD,UAAU,GAAkB,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtD,YAAY,SAA6B,EAAE,EAAE,MAAqB;QAChE,IAAI,CAAC,MAAM,GAAG;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,KAAK;YAChD,iBAAiB,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,OAAO;YACrE,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QACF,IAAI,CAAC,GAAG,GAAG,MAAM,IAAI,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAC3D,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;gBAChE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiC,CAAC;gBAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBACvB,IAAI,MAAM,GAAG,CAAC,CAAC;gBACf,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;oBAC1C,qCAAqC;oBACrC,IAAI,GAAG,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK;wBAAE,SAAS;oBAC7D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;oBACtE,MAAM,EAAE,CAAC;gBACX,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,MAAM,oBAAoB,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YAClF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACrD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAiC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,IAAI,CAAC,YAAY;YAAE,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC5F,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,6BAA6B;QACpD,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1C,CAAC;IAED,4EAA4E;IAE5E;;;OAGG;IACH,GAAG,CAAC,WAAmB,EAAE,SAAiB;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACrB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAyE;QAC3E,MAAM,IAAI,GAAiB,EAAE,GAAG,KAAK,EAAE,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,WAAmB,EAAE,SAAiB,EAAE,SAAiB,EAAE,MAAc;QACvF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;QACjE,CAAC;QACD,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC;QAC/B,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,QAAQ,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,WAAmB,EAAE,SAAiB,EAAE,KAA8B;QAClF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,KAAK,CAAC,OAAO,GAAG,EAAE,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QACvD,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAClC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,KAAK,CAAC,CAAC;QAC1D,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,OAAO,EAAE,GAAG,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAmB,EAAE,SAAiB;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QACtE,IAAI,OAAO;YAAE,IAAI,CAAC,eAAe,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,eAAe,EAAE,CAAC;IACzB,CAAC;IAED,2EAA2E;IAE3E;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,OAAO,GAA2B,EAAE,CAAC;QAC3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IAED,2EAA2E;IAEnE,OAAO,CAAC,WAAmB,EAAE,SAAiB;QACpD,OAAO,GAAG,SAAS,KAAK,WAAW,EAAE,CAAC;IACxC,CAAC;IAEO,SAAS,CAAC,KAAmB;QACnC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/D,CAAC;IAEO,YAAY;QAClB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YACpC,IAAI,GAAG,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBACnD,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACrB,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QACD,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,MAAM,mBAAmB,CAAC,CAAC;YACtD,IAAI,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2EAA2E;IAEnE,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO;QACrC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;YACzE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAmB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC3E,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAChE,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAChD,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,+BAAgC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/bridge/WebhookAdapter.d.ts

@@ -0,0 +1,76 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — WebhookAdapter (Generic Webhook → Bridge)        ║
+ * ║                                                                      ║
+ * ║   Normalise les webhooks de providers variés vers un format         ║
+ * ║   uniforme consommable par l'API agent.run.                         ║
+ * ║                                                                      ║
+ * ║   PROVIDERS SUPPORTÉS                                                ║
+ * ║   ────────────────────                                               ║
+ * ║   - voipms    : VoIP.ms (from, to, message, id, date, media)        ║
+ * ║   - twilio    : Twilio (From, To, Body, MessageSid, MediaUrl0)       ║
+ * ║   - generic   : Format customisable (mapping field-by-field)         ║
+ * ║                                                                      ║
+ * ║   Chaque adapter retourne un NormalizedWebhook qui contient :        ║
+ * ║     - externalKey : clé pour SessionStore (phone, user, etc.)       ║
+ * ║     - prompt      : texte à envoyer à l'agent (déjà contextualisé)  ║
+ * ║     - metadata    : données brutes pour audit                        ║
+ * ║     - mediaUrls   : URLs de médias attachés                          ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { type BridgeLogger } from './utils.js';
+export interface NormalizedWebhook {
+    /** Clé externe pour SessionStore (ex: numéro de téléphone) */
+    externalKey: string;
+    /** Prompt à passer à l'agent (déjà contextualisé) */
+    prompt: string;
+    /** Liste des URLs de médias (optionnel) */
+    mediaUrls: string[];
+    /** Métadonnées brutes (provider, messageId, etc.) */
+    metadata: Record<string, unknown>;
+}
+export type WebhookProvider = 'voipms' | 'twilio' | 'generic' | 'discord';
+export interface WebhookAdapterConfig {
+    /** Nom du provider (default: 'voipms') */
+    provider?: WebhookProvider;
+    /** Pour 'generic' : mapping custom field → champ normalisé */
+    fieldMap?: Partial<Record<keyof NormalizedWebhook, string>>;
+    /** Préfixe ajouté au prompt (ex: '[SMS reçu]') */
+    promptPrefix?: string;
+    /** Inclure un contexte Discord-like dans le prompt */
+    discordContext?: {
+        channelId?: string;
+        userId?: string;
+        username?: string;
+    };
+    /** Logger */
+    logger?: BridgeLogger;
+}
+export declare class WebhookAdapter {
+    private readonly config;
+    private readonly log;
+    constructor(config?: WebhookAdapterConfig);
+    /**
+     * Adapte un payload brut vers un NormalizedWebhook.
+     */
+    adapt(rawPayload: Record<string, unknown>): NormalizedWebhook;
+    /**
+     * VoIP.ms callback format.
+     * Params: from, to, message, id, date, media (URLs séparées par |)
+     * Body peut être GET query ou POST form-encoded.
+     */
+    private adaptVoipMs;
+    /**
+     * Twilio format (snake_case ou CamelCase).
+     */
+    private adaptTwilio;
+    /**
+     * Discord-like format (channel, user, message).
+     */
+    private adaptDiscord;
+    /**
+     * Generic — applique le fieldMap custom.
+     */
+    private adaptGeneric;
+}
+//# sourceMappingURL=WebhookAdapter.d.ts.map

package/dist/bridge/WebhookAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookAdapter.d.ts","sourceRoot":"","sources":["../../src/bridge/WebhookAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAKnE,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5D,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,cAAc,CAAC,EAAE;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,aAAa;IACb,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAID,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CACqC;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;gBAEvB,MAAM,GAAE,oBAAyB;IAU7C;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB;IAmB7D;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAgCnB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkCnB;;OAEG;IACH,OAAO,CAAC,YAAY;IAqBpB;;OAEG;IACH,OAAO,CAAC,YAAY;CAuBrB"}

package/dist/bridge/WebhookAdapter.js

@@ -0,0 +1,186 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — WebhookAdapter (Generic Webhook → Bridge)        ║
+ * ║                                                                      ║
+ * ║   Normalise les webhooks de providers variés vers un format         ║
+ * ║   uniforme consommable par l'API agent.run.                         ║
+ * ║                                                                      ║
+ * ║   PROVIDERS SUPPORTÉS                                                ║
+ * ║   ────────────────────                                               ║
+ * ║   - voipms    : VoIP.ms (from, to, message, id, date, media)        ║
+ * ║   - twilio    : Twilio (From, To, Body, MessageSid, MediaUrl0)       ║
+ * ║   - generic   : Format customisable (mapping field-by-field)         ║
+ * ║                                                                      ║
+ * ║   Chaque adapter retourne un NormalizedWebhook qui contient :        ║
+ * ║     - externalKey : clé pour SessionStore (phone, user, etc.)       ║
+ * ║     - prompt      : texte à envoyer à l'agent (déjà contextualisé)  ║
+ * ║     - metadata    : données brutes pour audit                        ║
+ * ║     - mediaUrls   : URLs de médias attachés                          ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import { createBridgeLogger } from './utils.js';
+import { formatDiscordContext } from './utils.js';
+// ─── WebhookAdapter ────────────────────────────────────────────────────────
+export class WebhookAdapter {
+    config;
+    log;
+    constructor(config = {}) {
+        this.config = {
+            provider: config.provider ?? 'voipms',
+            promptPrefix: config.promptPrefix ?? '',
+            fieldMap: config.fieldMap,
+            discordContext: config.discordContext,
+        };
+        this.log = config.logger ?? createBridgeLogger('webhook-adapter');
+    }
+    /**
+     * Adapte un payload brut vers un NormalizedWebhook.
+     */
+    adapt(rawPayload) {
+        switch (this.config.provider) {
+            case 'voipms':
+                return this.adaptVoipMs(rawPayload);
+            case 'twilio':
+                return this.adaptTwilio(rawPayload);
+            case 'discord':
+                return this.adaptDiscord(rawPayload);
+            case 'generic':
+                return this.adaptGeneric(rawPayload);
+            default: {
+                const _exhaustive = this.config.provider;
+                throw new Error(`Unknown provider: ${String(_exhaustive)}`);
+            }
+        }
+    }
+    // ─── Provider Adapters ──────────────────────────────────────────────────
+    /**
+     * VoIP.ms callback format.
+     * Params: from, to, message, id, date, media (URLs séparées par |)
+     * Body peut être GET query ou POST form-encoded.
+     */
+    adaptVoipMs(raw) {
+        const from = stringOr(raw.from ?? raw.From, 'unknown');
+        const to = stringOr(raw.to ?? raw.To, 'unknown');
+        const message = stringOr(raw.message ?? raw.Message ?? raw.Body ?? raw.body, '');
+        const messageId = stringOr(raw.id ?? raw.MessageSid, '');
+        const date = stringOr(raw.date ?? raw.Date, new Date().toISOString());
+        const mediaRaw = stringOr(raw.media ?? raw.MediaUrl0 ?? '', '');
+        const mediaUrls = mediaRaw ? mediaRaw.split('|').map((u) => u.trim()).filter(Boolean) : [];
+        const promptParts = [];
+        if (this.config.promptPrefix)
+            promptParts.push(this.config.promptPrefix);
+        promptParts.push(`[Webhook VoIP.ms]`);
+        promptParts.push(`From: ${from}`);
+        promptParts.push(`To: ${to}`);
+        promptParts.push(`Date: ${date}`);
+        if (messageId)
+            promptParts.push(`MessageId: ${messageId}`);
+        promptParts.push('---');
+        promptParts.push(message);
+        if (mediaUrls.length > 0) {
+            promptParts.push('---');
+            promptParts.push(`Médias (${mediaUrls.length}):`);
+            for (const url of mediaUrls)
+                promptParts.push(`- ${url}`);
+        }
+        return {
+            externalKey: from,
+            prompt: promptParts.join('\n'),
+            mediaUrls,
+            metadata: { provider: 'voipms', from, to, messageId, date },
+        };
+    }
+    /**
+     * Twilio format (snake_case ou CamelCase).
+     */
+    adaptTwilio(raw) {
+        const from = stringOr(raw.From ?? raw.from, 'unknown');
+        const to = stringOr(raw.To ?? raw.to, 'unknown');
+        const body = stringOr(raw.Body ?? raw.body, '');
+        const messageSid = stringOr(raw.MessageSid ?? raw.SmsSid ?? raw.messageId, '');
+        const numMedia = Number(raw.NumMedia ?? 0);
+        const mediaUrls = [];
+        for (let i = 0; i < numMedia; i++) {
+            const url = raw[`MediaUrl${i}`];
+            if (typeof url === 'string' && url)
+                mediaUrls.push(url);
+        }
+        const promptParts = [];
+        if (this.config.promptPrefix)
+            promptParts.push(this.config.promptPrefix);
+        promptParts.push(`[Webhook Twilio]`);
+        promptParts.push(`From: ${from}`);
+        promptParts.push(`To: ${to}`);
+        if (messageSid)
+            promptParts.push(`MessageSid: ${messageSid}`);
+        promptParts.push('---');
+        promptParts.push(body);
+        if (mediaUrls.length > 0) {
+            promptParts.push('---');
+            promptParts.push(`Médias (${mediaUrls.length}):`);
+            for (const url of mediaUrls)
+                promptParts.push(`- ${url}`);
+        }
+        return {
+            externalKey: from,
+            prompt: promptParts.join('\n'),
+            mediaUrls,
+            metadata: { provider: 'twilio', from, to, messageSid, numMedia },
+        };
+    }
+    /**
+     * Discord-like format (channel, user, message).
+     */
+    adaptDiscord(raw) {
+        const author = raw.author ?? undefined;
+        const channelId = stringOr(raw.channelId ?? raw.channel_id, '');
+        const userId = stringOr(raw.userId ?? raw.user_id ?? author?.id, '');
+        const username = stringOr(raw.username ?? author?.username, 'unknown');
+        const message = stringOr(raw.content ?? raw.message ?? raw.body, '');
+        const prompt = formatDiscordContext({ channelId, userId, username, message });
+        return {
+            externalKey: userId || channelId,
+            prompt: this.config.promptPrefix
+                ? `${this.config.promptPrefix}\n${prompt}`
+                : prompt,
+            mediaUrls: Array.isArray(raw.attachments)
+                ? raw.attachments.map((a) => a.url).filter((u) => Boolean(u))
+                : [],
+            metadata: { provider: 'discord', channelId, userId, username },
+        };
+    }
+    /**
+     * Generic — applique le fieldMap custom.
+     */
+    adaptGeneric(raw) {
+        const map = this.config.fieldMap ?? {};
+        const get = (key) => {
+            const sourceKey = map[key];
+            if (!sourceKey)
+                return '';
+            const v = raw[sourceKey];
+            return typeof v === 'string' ? v : v != null ? JSON.stringify(v) : '';
+        };
+        const externalKey = get('externalKey') || 'default';
+        const prompt = get('prompt') || JSON.stringify(raw);
+        const mediaStr = get('mediaUrls');
+        const mediaUrls = mediaStr ? mediaStr.split(',').map((s) => s.trim()).filter(Boolean) : [];
+        return {
+            externalKey,
+            prompt: this.config.promptPrefix
+                ? `${this.config.promptPrefix}\n${prompt}`
+                : prompt,
+            mediaUrls,
+            metadata: { provider: 'generic', raw },
+        };
+    }
+}
+// ─── Helpers ───────────────────────────────────────────────────────────────
+function stringOr(value, defaultValue) {
+    if (typeof value === 'string')
+        return value;
+    if (value == null)
+        return defaultValue;
+    return String(value);
+}
+//# sourceMappingURL=WebhookAdapter.js.map

package/dist/bridge/WebhookAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebhookAdapter.js","sourceRoot":"","sources":["../../src/bridge/WebhookAdapter.ts"],"names":[],"mappings":"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"}

package/dist/bridge/index.d.ts

@@ -1,11 +1,33 @@
 /**
  * ╔══════════════════════════════════════════════════════════════════════╗
  * ║   OVERMIND BRIDGE — Barrel Export                                    ║
- * ║   Expose les APIs client et les types associés                      ║
+ * ║   Expose les APIs client, serveur, et les types associés             ║
  * ╚══════════════════════════════════════════════════════════════════════╝
  */
 export { BridgeProxy } from './BridgeProxy.js';
 export { OverBridgeService } from './OverBridgeService.js';
+export { OverBridgeServer } from './OverBridgeServer.js';
+export type { OverBridgeServerConfig, JsonRpcRequest, JsonRpcResponse } from './OverBridgeServer.js';
+export { parseArgs, getFlag, requireFlag, hasStdinData, readStdin } from './ArgParser.js';
+export type { ParsedArgs, ArgValue } from './ArgParser.js';
+export { resolvePrompt, parseVars } from './PromptSource.js';
+export type { ResolvePromptOptions, ResolvedPrompt, PromptSource } from './PromptSource.js';
+export { loadScenario, runScenario } from './ScenarioLoader.js';
+export type { Scenario, ScenarioStep, RunStep, A2AStep, ParallelStep, ConditionalStep, WaitStep, StepResult, ScenarioRunnerContext, } from './ScenarioLoader.js';
+export { BridgeHttpClient } from './BridgeHttpClient.js';
+export type { BridgeHttpClientConfig, JsonRpcCallRequest, JsonRpcCallResponse, } from './BridgeHttpClient.js';
+export { AgentRegistry } from './AgentRegistry.js';
+export type { AgentLiveState, AgentLiveStatus, ListAgentsFilter } from './AgentRegistry.js';
+export { MessageLog, loadMessageLogConfigFromEnv } from './MessageLog.js';
+export type { PersistedMessage, MessageStatus, CreateMessageInput, ListMessagesFilter, MessageLogConfig, } from './MessageLog.js';
+export { SessionStore } from './SessionStore.js';
+export type { SessionEntry, SessionStoreConfig } from './SessionStore.js';
+export { DirectiveParser, parseKeyValueArgs } from './DirectiveParser.js';
+export type { DirectiveAction, ParsedDirectives, DirectiveParserOptions } from './DirectiveParser.js';
+export { WebhookAdapter } from './WebhookAdapter.js';
+export type { NormalizedWebhook, WebhookProvider, WebhookAdapterConfig } from './WebhookAdapter.js';
+export { sanitizeAndParse, sanitizeJsonRaw, looksLikeWindowsPathIssue } from './JsonSanitizer.js';
+export { newRequestId, getOrCreateRequestId } from './RequestContext.js';
 export * from './types.js';
 export { createBridgeLogger, parseMcpResponseBody, validatePrompt, validateAgentName, formatDiscordContext, type BridgeLogger, type LogLevel, } from './utils.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/bridge/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,sBAAsB,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGrG,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC1F,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC7D,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC5F,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,OAAO,EACP,YAAY,EACZ,eAAe,EACf,QAAQ,EACR,UAAU,EACV,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EACV,sBAAsB,EACtB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC1E,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC1E,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,cAAc,YAAY,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,YAAY,EACjB,KAAK,QAAQ,GACd,MAAM,YAAY,CAAC"}

package/dist/bridge/index.js

@@ -1,11 +1,29 @@
 /**
  * ╔══════════════════════════════════════════════════════════════════════╗
  * ║   OVERMIND BRIDGE — Barrel Export                                    ║
- * ║   Expose les APIs client et les types associés                      ║
+ * ║   Expose les APIs client, serveur, et les types associés             ║
  * ╚══════════════════════════════════════════════════════════════════════╝
  */
+// ─── Client API (existant) ────────────────────────────────────────────────
 export { BridgeProxy } from './BridgeProxy.js';
 export { OverBridgeService } from './OverBridgeService.js';
+// ─── Server API (nouveau) ─────────────────────────────────────────────────
+export { OverBridgeServer } from './OverBridgeServer.js';
+// ─── CLI Components ──────────────────────────────────────────────────────
+export { parseArgs, getFlag, requireFlag, hasStdinData, readStdin } from './ArgParser.js';
+export { resolvePrompt, parseVars } from './PromptSource.js';
+export { loadScenario, runScenario } from './ScenarioLoader.js';
+export { BridgeHttpClient } from './BridgeHttpClient.js';
+// ─── Server Components (nouveau) ─────────────────────────────────────────
+export { AgentRegistry } from './AgentRegistry.js';
+export { MessageLog, loadMessageLogConfigFromEnv } from './MessageLog.js';
+export { SessionStore } from './SessionStore.js';
+export { DirectiveParser, parseKeyValueArgs } from './DirectiveParser.js';
+export { WebhookAdapter } from './WebhookAdapter.js';
+export { sanitizeAndParse, sanitizeJsonRaw, looksLikeWindowsPathIssue } from './JsonSanitizer.js';
+export { newRequestId, getOrCreateRequestId } from './RequestContext.js';
+// ─── Types ────────────────────────────────────────────────────────────────
 export * from './types.js';
+// ─── Utilities ────────────────────────────────────────────────────────────
 export { createBridgeLogger, parseMcpResponseBody, validatePrompt, validateAgentName, formatDiscordContext, } from './utils.js';
 //# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,cAAc,YAAY,CAAC;AAC3B,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,6EAA6E;AAC7E,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,4EAA4E;AAC5E,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE1F,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAYhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAOzD,4EAA4E;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EAAE,UAAU,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAQ1E,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEzE,6EAA6E;AAC7E,cAAc,YAAY,CAAC;AAE3B,6EAA6E;AAC7E,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GAGrB,MAAM,YAAY,CAAC"}

package/dist/bridge/utils.d.ts

@@ -45,4 +45,13 @@ export declare function formatDiscordContext(params: {
     username?: string;
     message: string;
 }): string;
+/**
+ * Interpolation de variables ${var} dans un template.
+ * Utilisé par ScenarioLoader, PromptSource, et le CLI.
+ *
+ * Supporte :
+ *   - ${var}        → remplacé par vars[var] si défini, sinon laissé tel quel
+ *   - ${var:-def}   → valeur par défaut si vars[var] est undefined
+ */
+export declare function interpolate(template: string, vars?: Record<string, string | undefined>): string;
 //# sourceMappingURL=utils.d.ts.map

package/dist/bridge/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/bridge/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAc/D;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAc7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAgB9D;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CASvD;AAID,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,MAAM,GAAG,SAAS,CAMpB;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAYT"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/bridge/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;CAC1D;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAc/D;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAc7D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAgB9D;AAID,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAID,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,YAAY,EAClB,MAAM,CAAC,EAAE,YAAY,GACpB,OAAO,CAAC,CAAC,CAAC,CAsBZ;AAID,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAKtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CASvD;AAID,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,GAC7C,MAAM,GAAG,SAAS,CAMpB;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAYT;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,MAAM,CAM/F"}

package/dist/bridge/utils.js

@@ -125,4 +125,21 @@ export function formatDiscordContext(params) {
         `MESSAGE: ${message}`,
     ].join('\n');
 }
+/**
+ * Interpolation de variables ${var} dans un template.
+ * Utilisé par ScenarioLoader, PromptSource, et le CLI.
+ *
+ * Supporte :
+ *   - ${var}        → remplacé par vars[var] si défini, sinon laissé tel quel
+ *   - ${var:-def}   → valeur par défaut si vars[var] est undefined
+ */
+export function interpolate(template, vars) {
+    if (!vars || Object.keys(vars).length === 0)
+        return template;
+    return template.replace(/\$\{([a-zA-Z0-9_]+)(?::-([^}]*))?\}/g, (_, key, def) => {
+        if (vars[key] !== undefined)
+            return vars[key];
+        return def !== undefined ? def : `\${${key}}`;
+    });
+}
 //# sourceMappingURL=utils.js.map