overmind-mcp 2.8.13 → 2.8.15

package/dist/bridge/ScenarioLoader.js

@@ -0,0 +1,333 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   OVERMIND BRIDGE — ScenarioLoader (Multi-Agent Orchestration)      ║
+ * ║                                                                      ║
+ * ║   Charge un scénario depuis YAML/JSON qui décrit un workflow        ║
+ * ║   multi-agents : séquentiel, parallèle, conditionnel, A2A.          ║
+ * ║                                                                      ║
+ * ║   FORMAT JSON                                                         ║
+ * ║   ──────────                                                         ║
+ * ║   {                                                                   ║
+ * ║     "name": "My workflow",                                            ║
+ * ║     "vars": { "ticker": "BTC" },                                      ║
+ * ║     "steps": [                                                        ║
+ * ║       { "id": "step1", "type": "run", "agent": "scout",              ║
+ * ║         "runner": "kilo", "prompt": "Analyse ${ticker}" },            ║
+ * ║       { "id": "step2", "type": "a2a", "from": "scout", "to":         ║
+ * ║         "analyst", "prompt": "Valide ${step1.output}" },              ║
+ * ║       { "id": "step3", "type": "parallel", "steps": [...] }           ║
+ * ║     ]                                                                 ║
+ * ║   }                                                                   ║
+ * ╚══════════════════════════════════════════════════════════════════════╝
+ */
+import fs from 'node:fs/promises';
+import { interpolate } from './utils.js';
+// ─── Lazy YAML loader (optionnel) ──────────────────────────────────────────
+//
+// YAML est supporté si le module `yaml` est installé.
+// Sinon on throw une erreur claire demandant `npm i yaml`.
+//
+// On utilise createRequire pour rester compatible ESM (NodeNext).
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+function tryLoadYaml() {
+    try {
+        const yaml = require('yaml');
+        return yaml.parse;
+    }
+    catch {
+        return undefined;
+    }
+}
+// ─── Loader ────────────────────────────────────────────────────────────────
+/**
+ * Charge un scénario depuis un fichier. Supporte JSON et YAML.
+ */
+export async function loadScenario(filePath) {
+    const raw = await fs.readFile(filePath, 'utf-8');
+    const ext = filePath.toLowerCase().split('.').pop() ?? 'json';
+    let parsed;
+    if (ext === 'yaml' || ext === 'yml') {
+        const parseYaml = tryLoadYaml();
+        if (!parseYaml) {
+            throw new Error(`YAML scenario requested but 'yaml' module is not installed.\n` +
+                `Install it with: npm install yaml\n` +
+                `Or convert your scenario to JSON (.json) which is supported out-of-the-box.`);
+        }
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch (err) {
+            throw new Error(`Invalid YAML in ${filePath}: ${err.message}`, { cause: err });
+        }
+    }
+    else {
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch (err) {
+            throw new Error(`Invalid JSON in ${filePath}: ${err.message}`, { cause: err });
+        }
+    }
+    return validateScenario(parsed);
+}
+/**
+ * Valide et normalise un objet scénario.
+ */
+function validateScenario(obj) {
+    if (!obj || typeof obj !== 'object') {
+        throw new Error('Scenario must be an object');
+    }
+    const s = obj;
+    if (typeof s.name !== 'string' || !s.name) {
+        throw new Error('Scenario.name is required');
+    }
+    if (!Array.isArray(s.steps)) {
+        throw new Error('Scenario.steps must be an array');
+    }
+    for (const [i, step] of s.steps.entries()) {
+        validateStep(step, `steps[${i}]`);
+    }
+    return {
+        name: s.name,
+        description: typeof s.description === 'string' ? s.description : undefined,
+        vars: s.vars ?? {},
+        steps: s.steps,
+    };
+}
+function validateStep(step, path) {
+    if (!step || typeof step !== 'object') {
+        throw new Error(`${path} must be an object`);
+    }
+    const s = step;
+    if (typeof s.id !== 'string' || !s.id) {
+        throw new Error(`${path}.id is required`);
+    }
+    const type = s.type;
+    if (type === 'run') {
+        if (typeof s.agent !== 'string')
+            throw new Error(`${path}.agent required for run`);
+        if (typeof s.runner !== 'string')
+            throw new Error(`${path}.runner required for run`);
+        if (typeof s.prompt !== 'string')
+            throw new Error(`${path}.prompt required for run`);
+    }
+    else if (type === 'a2a') {
+        if (typeof s.from !== 'string')
+            throw new Error(`${path}.from required for a2a`);
+        if (typeof s.to !== 'string')
+            throw new Error(`${path}.to required for a2a`);
+        if (typeof s.runner !== 'string')
+            throw new Error(`${path}.runner required for a2a`);
+        if (typeof s.prompt !== 'string')
+            throw new Error(`${path}.prompt required for a2a`);
+    }
+    else if (type === 'parallel') {
+        if (!Array.isArray(s.steps))
+            throw new Error(`${path}.steps required for parallel`);
+        s.steps.forEach((sub, j) => validateStep(sub, `${path}.steps[${j}]`));
+    }
+    else if (type === 'if') {
+        if (typeof s.condition !== 'string')
+            throw new Error(`${path}.condition required for if`);
+        if (!Array.isArray(s.then))
+            throw new Error(`${path}.then required for if`);
+        s.then.forEach((sub, j) => validateStep(sub, `${path}.then[${j}]`));
+        if (s.else && Array.isArray(s.else)) {
+            s.else.forEach((sub, j) => validateStep(sub, `${path}.else[${j}]`));
+        }
+    }
+    else if (type === 'wait') {
+        if (typeof s.ms !== 'number')
+            throw new Error(`${path}.ms required for wait`);
+    }
+    else {
+        throw new Error(`${path}.type must be one of: run, a2a, parallel, if, wait (got: ${String(type)})`);
+    }
+}
+/**
+ * Exécute un scénario séquentiellement. Retourne tous les résultats.
+ */
+export async function runScenario(scenario, ctx) {
+    // Init vars (input + step outputs)
+    const vars = { ...(scenario.vars ?? {}) };
+    const localCtx = { ...ctx, vars };
+    const results = [];
+    for (const step of scenario.steps) {
+        const result = await runStep(step, localCtx);
+        results.push(result);
+        if (result.output !== undefined) {
+            // Expose output aux steps suivants : ${stepId.output} et ${stepId}
+            const outputStr = typeof result.output === 'string' ? result.output : JSON.stringify(result.output);
+            localCtx.vars[result.stepId] = outputStr;
+            localCtx.vars[`${result.stepId}.output`] = outputStr;
+        }
+        if (!result.success && step.stopOnError) {
+            break;
+        }
+    }
+    return results;
+}
+async function runStep(step, ctx) {
+    const startTime = Date.now();
+    const log = ctx.log ?? (() => { });
+    try {
+        switch (step.type) {
+            case 'run': {
+                const prompt = interpolate(step.prompt, ctx.vars);
+                log(`▶ [${step.id}] run ${step.agent} (${step.runner})`);
+                const r = await ctx.runAgent({
+                    agentName: step.agent,
+                    runner: step.runner,
+                    prompt,
+                    model: step.model,
+                    mode: step.mode,
+                    path: step.path,
+                });
+                log(r.isError ? `✗ [${step.id}] failed` : `✓ [${step.id}] done (${Date.now() - startTime}ms)`);
+                return {
+                    stepId: step.id,
+                    type: 'run',
+                    success: !r.isError,
+                    output: r.text,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            case 'a2a': {
+                const prompt = interpolate(step.prompt, ctx.vars);
+                log(`▶ [${step.id}] a2a ${step.from} → ${step.to}`);
+                const r = await ctx.runA2A({
+                    fromAgent: step.from,
+                    toAgent: step.to,
+                    runner: step.runner,
+                    prompt,
+                    model: step.model,
+                });
+                log(r.isError ? `✗ [${step.id}] failed` : `✓ [${step.id}] done (${Date.now() - startTime}ms)`);
+                return {
+                    stepId: step.id,
+                    type: 'a2a',
+                    success: !r.isError,
+                    output: r.text,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            case 'parallel': {
+                const waitAll = step.waitAll ?? true;
+                log(`▶ [${step.id}] parallel (${step.steps.length} steps, waitAll=${waitAll})`);
+                let subResults;
+                if (waitAll) {
+                    subResults = await Promise.all(step.steps.map((s) => runStep(s, ctx)));
+                }
+                else {
+                    // waitAll=false : retourne dès qu'un step réussit
+                    // On lance tout, et on retourne au premier succès (les autres continuent en background)
+                    const promises = step.steps.map((s) => runStep(s, ctx));
+                    // Promise.any retourne le 1er à RÉSOUDRE (donc succès, car on catch les erreurs dans runStep)
+                    const first = await Promise.any(promises);
+                    // Cancel le reste en best-effort (ils continuent mais on n'attend pas)
+                    subResults = [first];
+                }
+                const success = subResults.every((r) => r.success);
+                return {
+                    stepId: step.id,
+                    type: 'parallel',
+                    success,
+                    output: subResults,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            case 'if': {
+                const condStr = interpolate(step.condition, ctx.vars);
+                const truthy = evaluateCondition(condStr);
+                log(`▶ [${step.id}] if (${condStr}) → ${truthy ? 'then' : 'else'}`);
+                const branch = truthy ? step.then : (step.else ?? []);
+                const subResults = [];
+                for (const s of branch) {
+                    subResults.push(await runStep(s, ctx));
+                }
+                return {
+                    stepId: step.id,
+                    type: 'if',
+                    success: subResults.every((r) => r.success),
+                    output: subResults,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            case 'wait': {
+                log(`▶ [${step.id}] wait ${step.ms}ms`);
+                await new Promise((resolve) => setTimeout(resolve, step.ms));
+                return {
+                    stepId: step.id,
+                    type: 'wait',
+                    success: true,
+                    durationMs: Date.now() - startTime,
+                };
+            }
+            default: {
+                const _exhaustive = step;
+                throw new Error(`Unknown step type: ${JSON.stringify(_exhaustive)}`);
+            }
+        }
+    }
+    catch (err) {
+        log(`💥 [${step.id}] crashed: ${err.message}`);
+        return {
+            stepId: step.id,
+            type: step.type,
+            success: false,
+            error: err.message,
+            durationMs: Date.now() - startTime,
+        };
+    }
+}
+/**
+ * Évalue une condition simple. Supporte :
+ *   - "value" (truthy si non-vide)
+ *   - ${var} == "literal"
+ *   - ${var} != "literal"
+ *   - ${var} > 5, < 5
+ *   - ${var} && ${other}
+ *   - !${var}
+ */
+function evaluateCondition(expr) {
+    const trimmed = expr.trim();
+    if (!trimmed)
+        return false;
+    // ${var} == "literal"
+    let m = trimmed.match(/^(.+?)\s*==\s*["']([^"']*)["']$/);
+    if (m)
+        return m[1].trim() === m[2];
+    // ${var} != "literal"
+    m = trimmed.match(/^(.+?)\s*!=\s*["']([^"']*)["']$/);
+    if (m)
+        return m[1].trim() !== m[2];
+    // ${var} > N
+    m = trimmed.match(/^(.+?)\s*>\s*(\d+(?:\.\d+)?)$/);
+    if (m)
+        return Number(m[1].trim()) > Number(m[2]);
+    // ${var} < N
+    m = trimmed.match(/^(.+?)\s*<\s*(\d+(?:\.\d+)?)$/);
+    if (m)
+        return Number(m[1].trim()) < Number(m[2]);
+    // !${var}
+    if (trimmed.startsWith('!'))
+        return !evaluateCondition(trimmed.slice(1));
+    // ${a} && ${b}
+    if (trimmed.includes('&&')) {
+        return trimmed
+            .split('&&')
+            .map((p) => evaluateCondition(p.trim()))
+            .every(Boolean);
+    }
+    // ${a} || ${b}
+    if (trimmed.includes('||')) {
+        return trimmed
+            .split('||')
+            .map((p) => evaluateCondition(p.trim()))
+            .some(Boolean);
+    }
+    // Truthy simple
+    return Boolean(trimmed);
+}
+//# sourceMappingURL=ScenarioLoader.js.map

package/dist/bridge/ScenarioLoader.js.map

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

package/dist/bridge/SessionStore.d.ts

@@ -0,0 +1,109 @@
+/**
+ * ╔══════════════════════════════════════════════════════════════════════╗
+ * ║   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 { type BridgeLogger } from './utils.js';
+export interface SessionEntry {
+    /** Clé externe fournie par le caller (phone, userId, etc.) */
+    externalKey: string;
+    /** SessionId réel retourné par l'agent (Hermes/Claude/etc.) */
+    sessionId: string;
+    /** Agent name (pour multi-tenant multi-agent) */
+    agentName: string;
+    /** Runner utilisé (pour invalidation si le runner change) */
+    runner: string;
+    /** Timestamp dernière activité */
+    lastActivityAt: number;
+    /** Contexte additionnel optionnel (le CONTEXT_UPDATE de bt-sms) */
+    context?: Record<string, unknown>;
+    /** Statut temporaire (idle/busy — optionnel) */
+    status?: 'idle' | 'busy';
+}
+export interface SessionStoreConfig {
+    /** Chemin du fichier de persistence (optionnel — si absent, in-memory only) */
+    persistPath?: string;
+    /** TTL en ms (default: 4h, comme bt-sms) */
+    ttlMs?: number;
+    /** Cleanup interval en ms (default: 5min) */
+    cleanupIntervalMs?: number;
+}
+export interface SessionContextPatch {
+    /** Champs à patcher dans le context */
+    patch: Record<string, unknown>;
+}
+export declare class SessionStore {
+    private readonly map;
+    private readonly log;
+    private readonly config;
+    private cleanupTimer;
+    private writeQueue;
+    constructor(config?: SessionStoreConfig, logger?: BridgeLogger);
+    /**
+     * Initialise le store : charge le fichier de persistence si présent,
+     * démarre le cleanup périodique.
+     */
+    init(): Promise<void>;
+    /**
+     * Arrête le cleanup et persiste l'état final.
+     */
+    close(): Promise<void>;
+    /**
+     * Récupère une session par (externalKey, agentName).
+     * Retourne undefined si absente ou expirée.
+     */
+    get(externalKey: string, agentName: string): SessionEntry | undefined;
+    /**
+     * Sauvegarde ou met à jour une session. Retourne l'entrée.
+     */
+    set(entry: Omit<SessionEntry, 'lastActivityAt'> & {
+        lastActivityAt?: number;
+    }): SessionEntry;
+    /**
+     * Met à jour uniquement le sessionId (cas typique : après un run, on a le vrai ID).
+     */
+    updateSessionId(externalKey: string, agentName: string, sessionId: string, runner: string): SessionEntry | undefined;
+    /**
+     * Met à jour le context (pattern CONTEXT_UPDATE de bt-sms).
+     */
+    updateContext(externalKey: string, agentName: string, patch: Record<string, unknown>): SessionEntry | undefined;
+    /**
+     * Supprime une session.
+     */
+    delete(externalKey: string, agentName: string): boolean;
+    /**
+     * Purge toutes les sessions (reset complet).
+     */
+    clear(): void;
+    /**
+     * Liste toutes les sessions actives (non expirées).
+     */
+    list(): SessionEntry[];
+    /**
+     * Stats par agent.
+     */
+    stats(): {
+        total: number;
+        byAgent: Record<string, number>;
+    };
+    private makeKey;
+    private isExpired;
+    private purgeExpired;
+    private schedulePersist;
+    private persist;
+}
+//# sourceMappingURL=SessionStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStore.d.ts","sourceRoot":"","sources":["../../src/bridge/SessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAInE,MAAM,WAAW,YAAY;IAC3B,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAkB;IACjC,+EAA+E;IAC/E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,uCAAuC;IACvC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAID,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAmC;IACvD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CACmB;IAC1C,OAAO,CAAC,YAAY,CAA6C;IACjE,OAAO,CAAC,UAAU,CAAoC;gBAE1C,MAAM,GAAE,kBAAuB,EAAE,MAAM,CAAC,EAAE,YAAY;IAWlE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyB3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAY5B;;;OAGG;IACH,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWrE;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,GAAG;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,YAAY;IAQ5F;;OAEG;IACH,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAapH;;OAEG;IACH,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,SAAS;IAU/G;;OAEG;IACH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAMvD;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,IAAI,IAAI,YAAY,EAAE;IAKtB;;OAEG;IACH,KAAK,IAAI;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE;IAU3D,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,eAAe;YAOT,OAAO;CAiBtB"}