@neuroverseos/nv-sim 0.1.9 → 0.1.11

package/dist/assets/mirotir-logo-DUexumBH.svg

@@ -1,185 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 320" fill="none">
-  <!--
-    Mirotir Logo
-
-    Concept: School of fish (swarm) forming a circular cluster
-    with a horizontal line of teal fish cutting through — the
-    "reasoning line" that makes sense of the crowd.
-
-    Dark blue fish = the simulation (MiroFish, the crowd)
-    Teal fish line = the reasoning (Echelon, the brain)
-    Breakaway fish = the decision emerging from analysis
-
-    Typeface: Bold geometric sans-serif (Neue Haas Grotesk style)
-    Uniform stroke widths, clean, constructed, modern.
-  -->
-
-  <defs>
-    <!-- Fish shape template - dark blue swarm -->
-    <g id="fish-dark">
-      <ellipse rx="10" ry="6" fill="#1B5E7B"/>
-      <polygon points="10,-5 17,0 10,5" fill="#1B5E7B"/>
-    </g>
-    <!-- Fish shape template - dark blue small -->
-    <g id="fish-dark-sm">
-      <ellipse rx="7" ry="4" fill="#1B5E7B"/>
-      <polygon points="7,-3.5 12,0 7,3.5" fill="#1B5E7B"/>
-    </g>
-    <!-- Fish shape template - teal reasoning line -->
-    <g id="fish-teal">
-      <ellipse rx="11" ry="7" fill="#5BC0BE"/>
-      <polygon points="11,-5.5 19,0 11,5.5" fill="#5BC0BE"/>
-      <circle cx="-3" cy="-1" r="1.5" fill="white"/>
-    </g>
-    <!-- Fish shape template - teal small -->
-    <g id="fish-teal-sm">
-      <ellipse rx="8" ry="5" fill="#6FDBD8"/>
-      <polygon points="8,-4 14,0 8,4" fill="#6FDBD8"/>
-      <circle cx="-2" cy="-1" r="1.2" fill="white"/>
-    </g>
-  </defs>
-
-  <!-- ================================ -->
-  <!-- SWARM CLUSTER (circular school)  -->
-  <!-- ================================ -->
-
-  <!-- Top arc of swarm -->
-  <use href="#fish-dark" x="100" y="55" transform="rotate(-5,100,55)"/>
-  <use href="#fish-dark-sm" x="122" y="48" transform="rotate(8,122,48)"/>
-  <use href="#fish-dark" x="145" y="42" transform="rotate(-3,145,42)"/>
-  <use href="#fish-dark-sm" x="170" y="38" transform="rotate(12,170,38)"/>
-  <use href="#fish-dark" x="192" y="44" transform="rotate(-8,192,44)"/>
-  <use href="#fish-dark-sm" x="215" y="50" transform="rotate(5,215,50)"/>
-
-  <!-- Upper middle row -->
-  <use href="#fish-dark" x="78" y="75" transform="rotate(10,78,75)"/>
-  <use href="#fish-dark" x="108" y="72" transform="rotate(-6,108,72)"/>
-  <use href="#fish-dark-sm" x="135" y="68" transform="rotate(3,135,68)"/>
-  <use href="#fish-dark" x="160" y="65" transform="rotate(-10,160,65)"/>
-  <use href="#fish-dark-sm" x="185" y="62" transform="rotate(7,185,62)"/>
-  <use href="#fish-dark" x="208" y="68" transform="rotate(-4,208,68)"/>
-  <use href="#fish-dark-sm" x="228" y="75" transform="rotate(9,228,75)"/>
-
-  <!-- Middle-upper row -->
-  <use href="#fish-dark-sm" x="68" y="95" transform="rotate(-7,68,95)"/>
-  <use href="#fish-dark" x="92" y="90" transform="rotate(4,92,90)"/>
-  <use href="#fish-dark" x="118" y="88" transform="rotate(-2,118,88)"/>
-  <use href="#fish-dark-sm" x="145" y="85" transform="rotate(11,145,85)"/>
-  <use href="#fish-dark" x="172" y="82" transform="rotate(-9,172,82)"/>
-  <use href="#fish-dark" x="198" y="86" transform="rotate(6,198,86)"/>
-  <use href="#fish-dark-sm" x="222" y="92" transform="rotate(-5,222,92)"/>
-  <use href="#fish-dark" x="242" y="98" transform="rotate(3,242,98)"/>
-
-  <!-- Pre-reasoning row -->
-  <use href="#fish-dark" x="58" y="112" transform="rotate(8,58,112)"/>
-  <use href="#fish-dark-sm" x="85" y="108" transform="rotate(-3,85,108)"/>
-  <use href="#fish-dark" x="112" y="105" transform="rotate(5,112,105)"/>
-  <use href="#fish-dark" x="140" y="103" transform="rotate(-7,140,103)"/>
-  <use href="#fish-dark-sm" x="168" y="100" transform="rotate(2,168,100)"/>
-  <use href="#fish-dark" x="195" y="104" transform="rotate(-11,195,104)"/>
-  <use href="#fish-dark-sm" x="218" y="108" transform="rotate(4,218,108)"/>
-  <use href="#fish-dark" x="240" y="115" transform="rotate(-6,240,115)"/>
-
-  <!-- ================================ -->
-  <!-- REASONING LINE (teal fish)       -->
-  <!-- The line that cuts through       -->
-  <!-- ================================ -->
-
-  <use href="#fish-teal" x="32" y="132"/>
-  <use href="#fish-teal" x="65" y="130" transform="rotate(-2,65,130)"/>
-  <use href="#fish-teal" x="100" y="130"/>
-  <use href="#fish-teal" x="135" y="129" transform="rotate(2,135,129)"/>
-  <use href="#fish-teal" x="170" y="130"/>
-  <use href="#fish-teal" x="205" y="130" transform="rotate(-1,205,130)"/>
-  <use href="#fish-teal" x="240" y="131" transform="rotate(1,240,131)"/>
-
-  <!-- Breakaway fish — the decision emerging -->
-  <use href="#fish-teal-sm" x="282" y="130" transform="rotate(-3,282,130)"/>
-
-  <!-- ================================ -->
-  <!-- SWARM CLUSTER (below reasoning)  -->
-  <!-- ================================ -->
-
-  <!-- Post-reasoning row -->
-  <use href="#fish-dark" x="60" y="152" transform="rotate(-4,60,152)"/>
-  <use href="#fish-dark-sm" x="88" y="148" transform="rotate(7,88,148)"/>
-  <use href="#fish-dark" x="115" y="150" transform="rotate(-9,115,150)"/>
-  <use href="#fish-dark" x="142" y="153" transform="rotate(3,142,153)"/>
-  <use href="#fish-dark-sm" x="170" y="155" transform="rotate(-6,170,155)"/>
-  <use href="#fish-dark" x="198" y="152" transform="rotate(5,198,152)"/>
-  <use href="#fish-dark-sm" x="222" y="148" transform="rotate(-2,222,148)"/>
-  <use href="#fish-dark" x="245" y="152" transform="rotate(8,245,152)"/>
-
-  <!-- Lower-middle row -->
-  <use href="#fish-dark-sm" x="72" y="170" transform="rotate(6,72,170)"/>
-  <use href="#fish-dark" x="98" y="168" transform="rotate(-8,98,168)"/>
-  <use href="#fish-dark" x="128" y="172" transform="rotate(4,128,172)"/>
-  <use href="#fish-dark-sm" x="155" y="175" transform="rotate(-5,155,175)"/>
-  <use href="#fish-dark" x="180" y="172" transform="rotate(10,180,172)"/>
-  <use href="#fish-dark-sm" x="205" y="168" transform="rotate(-3,205,168)"/>
-  <use href="#fish-dark" x="230" y="170" transform="rotate(7,230,170)"/>
-
-  <!-- Lower row -->
-  <use href="#fish-dark" x="85" y="192" transform="rotate(-6,85,192)"/>
-  <use href="#fish-dark-sm" x="112" y="190" transform="rotate(9,112,190)"/>
-  <use href="#fish-dark" x="138" y="195" transform="rotate(-4,138,195)"/>
-  <use href="#fish-dark" x="165" y="192" transform="rotate(2,165,192)"/>
-  <use href="#fish-dark-sm" x="190" y="188" transform="rotate(-7,190,188)"/>
-  <use href="#fish-dark" x="215" y="192" transform="rotate(5,215,192)"/>
-
-  <!-- Bottom arc -->
-  <use href="#fish-dark-sm" x="100" y="210" transform="rotate(3,100,210)"/>
-  <use href="#fish-dark" x="128" y="212" transform="rotate(-8,128,212)"/>
-  <use href="#fish-dark-sm" x="155" y="215" transform="rotate(6,155,215)"/>
-  <use href="#fish-dark" x="182" y="212" transform="rotate(-2,182,212)"/>
-  <use href="#fish-dark-sm" x="205" y="208" transform="rotate(4,205,208)"/>
-
-  <!-- ================================ -->
-  <!-- WORDMARK: MIROTIR               -->
-  <!-- Bold geometric sans-serif        -->
-  <!-- Neue Haas Grotesk style          -->
-  <!-- Uniform stroke, constructed      -->
-  <!-- ================================ -->
-
-  <g transform="translate(340, 100)">
-    <!-- M -->
-    <path d="M0,130 L0,0 L8,0 L8,130 L0,130 Z" fill="#1B5E7B"/>
-    <path d="M8,0 L36,50 L36,42 L14,0 L8,0 Z" fill="#1B5E7B"/>
-    <path d="M36,42 L36,50 L64,0 L58,0 L36,42 Z" fill="#1B5E7B"/>
-    <path d="M58,0 L66,0 L66,130 L58,130 Z" fill="#1B5E7B"/>
-
-    <!-- I -->
-    <path d="M82,0 L90,0 L90,130 L82,130 Z" fill="#1B5E7B"/>
-
-    <!-- R -->
-    <path d="M106,0 L114,0 L114,130 L106,130 Z" fill="#1B5E7B"/>
-    <path d="M114,0 L148,0 Q162,0 162,22 Q162,44 148,44 L114,44 L114,36 L146,36 Q154,36 154,22 Q154,8 146,8 L114,8 Z" fill="#1B5E7B"/>
-    <path d="M134,44 L164,130 L155,130 L126,46 Z" fill="#1B5E7B"/>
-
-    <!-- O -->
-    <path d="M178,0 L214,0 Q232,0 232,18 L232,112 Q232,130 214,130 L178,130 Q160,130 160,112 L160,18 Q160,0 178,0 Z M178,8 Q168,8 168,18 L168,112 Q168,122 178,122 L214,122 Q224,122 224,112 L224,18 Q224,8 214,8 Z" fill="#1B5E7B"/>
-
-    <!-- T -->
-    <path d="M244,0 L302,0 L302,8 L277,8 L277,130 L269,130 L269,8 L244,8 Z" fill="#1B5E7B"/>
-
-    <!-- I -->
-    <path d="M314,0 L322,0 L322,130 L314,130 Z" fill="#1B5E7B"/>
-
-    <!-- R -->
-    <path d="M338,0 L346,0 L346,130 L338,130 Z" fill="#1B5E7B"/>
-    <path d="M346,0 L380,0 Q394,0 394,22 Q394,44 380,44 L346,44 L346,36 L378,36 Q386,36 386,22 Q386,8 378,8 L346,8 Z" fill="#1B5E7B"/>
-    <path d="M366,44 L396,130 L387,130 L358,46 Z" fill="#1B5E7B"/>
-  </g>
-
-  <!-- ================================ -->
-  <!-- TAGLINE                          -->
-  <!-- ================================ -->
-
-  <text x="340" y="268"
-        font-family="'Helvetica Neue', 'Arial', sans-serif"
-        font-size="14"
-        font-weight="400"
-        letter-spacing="3.5"
-        fill="#5BC0BE">EXPLORE DECISIONS BEFORE REALITY DOES</text>
-
-</svg>

package/dist/engine/mirofish.js

@@ -1,295 +0,0 @@
-"use strict";
-/**
- * MiroFish Integration Adapter
- *
- * Connects Mirotir to MiroFish swarm simulations as an EXTERNAL SERVICE.
- *
- * POSITIONING:
- *   MiroFish shows what might happen → the spectacle
- *   Mirotir helps you decide what to do → the brain
- *
- *   "MiroFish simulates the crowd. Mirotir reasons about the decision."
- *
- * LICENSE COMPLIANCE:
- *   MiroFish is called as an external service via its REST API.
- *   We do NOT embed, copy, or redistribute MiroFish code.
- *   We do NOT use MiroFish internals, algorithms, or data structures.
- *   The integration is purely through the public API contract.
- *   This is the same relationship as using Stripe's API — we call it, we don't own it.
- *
- * ARCHITECTURE:
- *   Scenario → Echelon reasoning → strategies generated
- *                                        ↓
- *                               MiroFish simulation runs
- *                                        ↓
- *                               Echelon evaluates outcomes
- *
- *   MiroFish = world engine (emergent behavior, swarms, crowds)
- *   Echelon  = decision engine (structured reasoning, recommendations)
- *
- * FALLBACK:
- *   When MiroFish is not available, we use Echelon's native
- *   lightweight reaction model (swarmSimulation.ts).
- *   The API contract is the same either way.
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MiroFishError = exports.MiroFishClient = exports.DEFAULT_MIROFISH_CONFIG = void 0;
-exports.stakeholdersToMiroFishAgents = stakeholdersToMiroFishAgents;
-exports.miroFishResultToSwarmResult = miroFishResultToSwarmResult;
-exports.buildMiroFishRequest = buildMiroFishRequest;
-exports.configureMiroFish = configureMiroFish;
-exports.getMiroFishClient = getMiroFishClient;
-exports.runUnifiedSimulation = runUnifiedSimulation;
-/**
- * Default MiroFish configuration.
- * Assumes local Docker container on default port.
- */
-exports.DEFAULT_MIROFISH_CONFIG = {
-    endpoint: "http://localhost:8080",
-    timeout: 30000,
-    fallbackToNative: true,
-};
-// ============================================
-// MIROFISH CLIENT
-// ============================================
-/**
- * MiroFish API client.
- * Calls MiroFish as an external service via REST API.
- */
-class MiroFishClient {
-    config;
-    constructor(config) {
-        this.config = { ...exports.DEFAULT_MIROFISH_CONFIG, ...config };
-    }
-    /**
-     * Check if the MiroFish service is available.
-     */
-    async isAvailable() {
-        try {
-            const response = await fetch(`${this.config.endpoint}/health`, {
-                method: "GET",
-                signal: AbortSignal.timeout(5000),
-            });
-            return response.ok;
-        }
-        catch {
-            return false;
-        }
-    }
-    /**
-     * Run a simulation against the MiroFish service.
-     */
-    async simulate(request) {
-        const headers = {
-            "Content-Type": "application/json",
-        };
-        if (this.config.apiKey) {
-            headers["Authorization"] = `Bearer ${this.config.apiKey}`;
-        }
-        const response = await fetch(`${this.config.endpoint}/simulate`, {
-            method: "POST",
-            headers,
-            body: JSON.stringify(request),
-            signal: AbortSignal.timeout(this.config.timeout ?? 30000),
-        });
-        if (!response.ok) {
-            throw new MiroFishError(`MiroFish simulation failed: ${response.status} ${response.statusText}`, response.status);
-        }
-        return response.json();
-    }
-    /**
-     * Get the MiroFish service configuration.
-     */
-    getConfig() {
-        return this.config;
-    }
-}
-exports.MiroFishClient = MiroFishClient;
-/**
- * MiroFish-specific error.
- */
-class MiroFishError extends Error {
-    statusCode;
-    constructor(message, statusCode) {
-        super(message);
-        this.name = "MiroFishError";
-        this.statusCode = statusCode;
-    }
-}
-exports.MiroFishError = MiroFishError;
-// ============================================
-// TRANSLATION LAYER
-// ============================================
-/**
- * Convert Mirotir stakeholders to MiroFish agents.
- */
-function stakeholdersToMiroFishAgents(stakeholders) {
-    return stakeholders.map((s) => ({
-        id: s.id,
-        role: s.description ?? s.id,
-        disposition: s.disposition,
-        priorities: s.priorities,
-    }));
-}
-/**
- * Convert MiroFish simulation results to Mirotir's SwarmSimulationResult format.
- *
- * This is the key translation — MiroFish provides the raw emergent behavior,
- * and we normalize it into the format that Echelon's reasoning engine consumes.
- *
- * MiroFish shows WHAT happens.
- * Echelon reasons about WHAT IT MEANS.
- */
-function miroFishResultToSwarmResult(mfResult) {
-    // Convert MiroFish steps to SwarmRounds
-    const rounds = mfResult.steps.map((step) => {
-        const reactions = step.agent_actions.map((action) => ({
-            stakeholder_id: action.agent_id,
-            reaction: action.action,
-            confidence: action.confidence,
-            impact: action.sentiment,
-            trigger: action.reasoning ?? "MiroFish emergent behavior",
-        }));
-        return {
-            round: step.step,
-            reactions,
-            emergent_dynamics: step.system_events,
-        };
-    });
-    // Determine trajectory from MiroFish final state
-    let trajectory;
-    if (mfResult.final_state.convergence && mfResult.final_state.stability > 0.7) {
-        trajectory = "converging";
-    }
-    else if (mfResult.final_state.convergence) {
-        trajectory = "stabilizing";
-    }
-    else if (mfResult.final_state.stability < 0.3) {
-        trajectory = "escalating";
-    }
-    else {
-        trajectory = "diverging";
-    }
-    // Extract inflection points from emergent patterns
-    const inflection_points = mfResult.emergent_patterns ?? [
-        "MiroFish simulation completed — see rounds for detailed agent behaviors",
-    ];
-    return {
-        rounds,
-        trajectory,
-        inflection_points,
-    };
-}
-/**
- * Build a MiroFish simulation request from Mirotir inputs.
- */
-function buildMiroFishRequest(scenario, stakeholders, config) {
-    return {
-        scenario,
-        agents: stakeholdersToMiroFishAgents(config.simulate_stakeholders
-            ? stakeholders.filter((s) => config.simulate_stakeholders.includes(s.id))
-            : stakeholders),
-        steps: config.rounds ?? 3,
-        parameters: {
-            model: config.reaction_model ?? "mixed",
-            pressure: 0.5,
-            allow_coalitions: true,
-        },
-    };
-}
-/**
- * Singleton MiroFish client instance.
- * Configured via setMiroFishConfig().
- */
-let miroFishClient = null;
-/**
- * Configure the MiroFish connection.
- * Call this at startup if MiroFish is available.
- */
-function configureMiroFish(config) {
-    miroFishClient = new MiroFishClient(config);
-}
-/**
- * Get the current MiroFish client (if configured).
- */
-function getMiroFishClient() {
-    return miroFishClient;
-}
-/**
- * Run simulation through unified interface.
- *
- * Strategy:
- * 1. If MiroFish is configured and available → use it
- * 2. If MiroFish fails and fallback is enabled → use Echelon-native
- * 3. If MiroFish is not configured → use Echelon-native
- */
-async function runUnifiedSimulation(scenario, stakeholders, paths, swarmConfig, miroFishOverride) {
-    // Determine which client to use
-    const client = miroFishOverride
-        ? new MiroFishClient(miroFishOverride)
-        : miroFishClient;
-    // Try MiroFish first if configured
-    if (client) {
-        try {
-            const available = await client.isAvailable();
-            if (available) {
-                const request = buildMiroFishRequest(scenario, stakeholders, swarmConfig);
-                const mfResult = await client.simulate(request);
-                const result = miroFishResultToSwarmResult(mfResult);
-                return {
-                    result,
-                    source: "mirofish",
-                    mirofish_simulation_id: mfResult.simulation_id,
-                };
-            }
-        }
-        catch (error) {
-            const fallback = miroFishOverride?.fallbackToNative ?? client.getConfig().fallbackToNative ?? true;
-            if (!fallback) {
-                throw error;
-            }
-            // Log and fall through to native simulation
-            console.warn("[MiroFish] Simulation failed, falling back to Echelon-native:", error instanceof Error ? error.message : "Unknown error");
-        }
-    }
-    // Fall back to Echelon-native simulation
-    const { runSwarmSimulation } = await Promise.resolve().then(() => __importStar(require("./swarmSimulation")));
-    const result = await runSwarmSimulation(scenario, stakeholders, paths, swarmConfig);
-    return {
-        result,
-        source: "echelon-native",
-    };
-}