@neuroverseos/nv-sim 0.1.0

package/dist/engine/scenarioCapsule.js

@@ -0,0 +1,351 @@
+"use strict";
+/**
+ * Scenario Capsules — Shareable Decision Worlds
+ *
+ * A scenario capsule is a self-contained, portable simulation seed.
+ * It encodes everything needed to reproduce a reasoning session:
+ * - scenario description
+ * - assumption sliders
+ * - stakeholders
+ * - constraints
+ * - initial evidence signals
+ *
+ * Capsules can be:
+ * 1. Encoded in a URL: mirotir.com/run#capsule=<encoded>
+ * 2. Downloaded as JSON: scenario.capsule.json
+ * 3. Generated via API: POST /api/v1/scenario → capsule
+ * 4. Created by agents: autonomous agents generate decision worlds
+ *
+ * CRITICAL: No server-side storage. The capsule IS the data.
+ * This preserves the stateless, no-storage architecture.
+ *
+ * The sharing loop:
+ *   watch scenario → change assumptions → new reasoning → share capsule
+ *   The platform spreads through ideas, not accounts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCENARIO_TEMPLATES = void 0;
+exports.createCapsule = createCapsule;
+exports.capsuleToReasonRequest = capsuleToReasonRequest;
+exports.encodeCapsule = encodeCapsule;
+exports.decodeCapsule = decodeCapsule;
+exports.buildShareableUrl = buildShareableUrl;
+exports.extractCapsuleFromUrl = extractCapsuleFromUrl;
+exports.getPresetCapsule = getPresetCapsule;
+// ============================================
+// CAPSULE CREATION
+// ============================================
+/**
+ * Create a scenario capsule from a reason request.
+ */
+function createCapsule(title, request, options) {
+    const normalizedStakeholders = (request.stakeholders ?? []).map((s) => typeof s === "string" ? { id: s, disposition: "unknown" } : s);
+    const capsule = {
+        version: "1.0",
+        created_at: new Date().toISOString(),
+        title,
+        scenario: request.scenario,
+        stakeholders: normalizedStakeholders,
+        assumptions: request.assumptions ?? {},
+        constraints: request.constraints ?? {},
+        signals: options?.signals,
+        depth: request.depth ?? "standard",
+        perspective: request.perspective ?? "strategic_advisor",
+        swarm: request.swarm,
+        tags: options?.tags,
+        author: options?.author,
+    };
+    return {
+        ...capsule,
+        capsule_hash: computeCapsuleHash(capsule),
+    };
+}
+/**
+ * Convert a capsule back to a ReasonRequest for processing.
+ */
+function capsuleToReasonRequest(capsule) {
+    return {
+        scenario: capsule.scenario,
+        stakeholders: capsule.stakeholders,
+        assumptions: capsule.assumptions,
+        constraints: capsule.constraints,
+        depth: capsule.depth,
+        perspective: capsule.perspective,
+        swarm: capsule.swarm,
+        goal: capsule.goal,
+        mode: capsule.goal ? "goal" : "explore",
+    };
+}
+// ============================================
+// ENCODING / DECODING (URL-safe)
+// ============================================
+/**
+ * Encode a capsule for URL embedding.
+ * Result can be used as: mirotir.com/run#capsule=<encoded>
+ */
+function encodeCapsule(capsule) {
+    const json = JSON.stringify(capsule);
+    // Use base64url encoding (URL-safe)
+    if (typeof btoa === "function") {
+        return btoa(unescape(encodeURIComponent(json)))
+            .replace(/\+/g, "-")
+            .replace(/\//g, "_")
+            .replace(/=+$/, "");
+    }
+    // Node.js fallback
+    return Buffer.from(json, "utf-8").toString("base64url");
+}
+/**
+ * Decode a capsule from URL encoding.
+ */
+function decodeCapsule(encoded) {
+    // Restore base64 padding
+    let base64 = encoded.replace(/-/g, "+").replace(/_/g, "/");
+    while (base64.length % 4) {
+        base64 += "=";
+    }
+    let json;
+    if (typeof atob === "function") {
+        json = decodeURIComponent(escape(atob(base64)));
+    }
+    else {
+        json = Buffer.from(base64, "base64").toString("utf-8");
+    }
+    const capsule = JSON.parse(json);
+    // Verify integrity
+    const { capsule_hash, ...rest } = capsule;
+    const expectedHash = computeCapsuleHash(rest);
+    if (expectedHash !== capsule_hash) {
+        throw new Error("Capsule integrity check failed — data may have been tampered with");
+    }
+    return capsule;
+}
+/**
+ * Build a shareable URL from a capsule.
+ */
+function buildShareableUrl(capsule, baseUrl = "https://mirotir.com") {
+    const encoded = encodeCapsule(capsule);
+    return `${baseUrl}/run#capsule=${encoded}`;
+}
+/**
+ * Extract a capsule from a shareable URL.
+ */
+function extractCapsuleFromUrl(url) {
+    const hashIndex = url.indexOf("#capsule=");
+    if (hashIndex === -1)
+        return null;
+    const encoded = url.slice(hashIndex + "#capsule=".length);
+    return decodeCapsule(encoded);
+}
+// ============================================
+// CAPSULE HASH
+// ============================================
+/**
+ * Compute a hash for capsule integrity verification.
+ * Simple hash — not cryptographic. Just for tampering detection.
+ */
+function computeCapsuleHash(data) {
+    const json = JSON.stringify(data);
+    let hash = 0;
+    for (let i = 0; i < json.length; i++) {
+        const char = json.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32-bit integer
+    }
+    return `cap_${Math.abs(hash).toString(36)}`;
+}
+// ============================================
+// PRESET SCENARIO TEMPLATES
+// ============================================
+/**
+ * Built-in scenario templates that demonstrate Mirotir's capabilities.
+ * These are the "instant insight" scenarios that make people share.
+ */
+exports.SCENARIO_TEMPLATES = {
+    strait_of_hormuz: {
+        title: "Strait of Hormuz Closes",
+        scenario: "The Strait of Hormuz is closed due to military conflict. " +
+            "20% of global oil supply is disrupted. Oil prices spike 40% in 48 hours. " +
+            "Global supply chains begin to fracture.",
+        stakeholders: [
+            { id: "Energy Companies", disposition: "supportive", priorities: ["supply security", "price stability"] },
+            { id: "Consumers", disposition: "hostile", priorities: ["affordable fuel", "economic stability"] },
+            { id: "Government", disposition: "neutral", priorities: ["national security", "economic stability", "election impact"] },
+            { id: "Military", disposition: "neutral", priorities: ["strategic positioning", "force projection"] },
+            { id: "Financial Markets", disposition: "hostile", priorities: ["stability", "predictability"] },
+            { id: "OPEC", disposition: "unknown", priorities: ["market share", "price control"] },
+        ],
+        assumptions: {
+            severity: "critical",
+            environmental_hostility: "high",
+            time_pressure: "immediate",
+            regulatory_climate: "strict",
+        },
+        constraints: {
+            time_horizon: "30 days",
+            regulatory: ["international maritime law", "sanctions framework"],
+            risk_tolerance: "conservative",
+        },
+        signals: {
+            oil_price_spike: "40%",
+            shipping_disruption: true,
+            military_presence: "elevated",
+            diplomatic_channels: "active",
+        },
+        depth: "full",
+        perspective: "strategic_advisor",
+        swarm: { enabled: true, rounds: 5, reaction_model: "mixed" },
+        tags: ["geopolitical", "energy", "crisis", "supply-chain"],
+        world: {
+            world_id: "geopolitics_energy",
+            name: "Geopolitics & Energy Crisis",
+            inline_definition: {
+                thesis: "Geopolitical disruptions to energy supply chains create cascading economic and political effects",
+                state_variables: [
+                    { id: "oil_supply_disruption", label: "Oil Supply Disruption %", type: "number", range: { min: 0, max: 100 }, default_value: 20 },
+                    { id: "military_escalation", label: "Military Escalation Level", type: "enum", enum_values: ["posturing", "limited_engagement", "full_conflict"], default_value: "limited_engagement" },
+                    { id: "diplomatic_channels_open", label: "Diplomatic Channels Open", type: "boolean", default_value: true },
+                    { id: "strategic_reserve_release", label: "Strategic Reserve Release %", type: "number", range: { min: 0, max: 50 }, default_value: 0 },
+                    { id: "media_hostility", label: "Media Hostility", type: "number", range: { min: 0, max: 1 }, default_value: 0.7 },
+                ],
+                invariants: [
+                    { id: "INV-001", description: "Energy supply disruption > 30% triggers emergency pricing mechanisms", enforceable: true },
+                    { id: "INV-002", description: "Military escalation restricts diplomatic solution space", enforceable: true },
+                    { id: "INV-003", description: "Consumer sentiment inversely correlates with price spikes", enforceable: true },
+                ],
+                gates: [
+                    { id: "GATE-001", label: "Market Panic", condition: "oil_supply_disruption > 40", severity: "critical" },
+                    { id: "GATE-002", label: "Diplomatic Window Closing", condition: "military_escalation == full_conflict", severity: "critical" },
+                ],
+            },
+        },
+    },
+    gas_price_spike: {
+        title: "Gas Prices Hit $5/Gallon",
+        scenario: "US gas prices spike to $5/gallon driven by supply disruption and refinery constraints. " +
+            "Consumer sentiment craters. Midterm elections are 6 months away. " +
+            "EV adoption accelerates but grid infrastructure can't keep up.",
+        stakeholders: [
+            { id: "Consumers", disposition: "hostile", priorities: ["affordability", "commute costs"] },
+            { id: "Oil Companies", disposition: "supportive", priorities: ["margins", "market position"] },
+            { id: "Politicians", disposition: "hostile", priorities: ["re-election", "constituent pressure"] },
+            { id: "EV Manufacturers", disposition: "supportive", priorities: ["market share", "adoption"] },
+            { id: "Grid Operators", disposition: "neutral", priorities: ["reliability", "capacity"] },
+            { id: "Trucking Industry", disposition: "hostile", priorities: ["operating costs", "contracts"] },
+        ],
+        assumptions: {
+            severity: "high",
+            environmental_hostility: "high",
+            time_pressure: "urgent",
+            regulatory_climate: "strict",
+        },
+        constraints: {
+            time_horizon: "6 months",
+            regulatory: ["EPA", "DOE", "state fuel regulations"],
+            risk_tolerance: "moderate",
+        },
+        signals: {
+            gas_price: "$5.00/gal",
+            consumer_sentiment: "very_low",
+            ev_demand_spike: "35%",
+            grid_capacity_surplus: "-12%",
+        },
+        depth: "full",
+        perspective: "strategic_advisor",
+        swarm: { enabled: true, rounds: 4, reaction_model: "mixed" },
+        tags: ["economic", "energy", "political", "consumer"],
+        world: {
+            world_id: "economic_energy",
+            name: "Economic Energy Shock",
+            inline_definition: {
+                thesis: "Energy price spikes create political, economic, and social cascading effects with EV transition implications",
+                state_variables: [
+                    { id: "gas_price", label: "Gas Price ($/gal)", type: "number", range: { min: 2, max: 10 }, default_value: 5 },
+                    { id: "consumer_sentiment", label: "Consumer Sentiment", type: "number", range: { min: 0, max: 1 }, default_value: 0.2 },
+                    { id: "ev_demand_surge", label: "EV Demand Surge %", type: "number", range: { min: 0, max: 100 }, default_value: 35 },
+                    { id: "election_proximity_months", label: "Months to Election", type: "number", range: { min: 0, max: 24 }, default_value: 6 },
+                    { id: "grid_capacity", label: "Grid Spare Capacity %", type: "number", range: { min: -30, max: 30 }, default_value: -12 },
+                ],
+                invariants: [
+                    { id: "INV-001", description: "Gas price > $4.50 triggers political crisis mode", enforceable: true },
+                    { id: "INV-002", description: "EV demand surge without grid capacity creates secondary crisis", enforceable: true },
+                    { id: "INV-003", description: "Election proximity amplifies political response intensity", enforceable: true },
+                ],
+                gates: [
+                    { id: "GATE-001", label: "Political Crisis", condition: "gas_price > 4.5 && election_proximity_months < 12", severity: "critical" },
+                    { id: "GATE-002", label: "Grid Failure Risk", condition: "ev_demand_surge > 30 && grid_capacity < 0", severity: "warning" },
+                ],
+            },
+        },
+    },
+    ai_regulation_crisis: {
+        title: "Major AI Regulation Passes",
+        scenario: "The EU passes sweeping AI regulation requiring full model transparency, " +
+            "mandatory audits, and liability for AI-generated outputs. " +
+            "US lawmakers signal similar legislation within 12 months. " +
+            "Open-source AI communities face existential compliance questions.",
+        stakeholders: [
+            { id: "AI Companies", disposition: "hostile", priorities: ["innovation speed", "competitive advantage", "IP protection"] },
+            { id: "Regulators", disposition: "supportive", priorities: ["public safety", "accountability", "precedent"] },
+            { id: "Open Source Community", disposition: "hostile", priorities: ["freedom", "access", "collaboration"] },
+            { id: "Enterprise Customers", disposition: "neutral", priorities: ["compliance", "reliability", "cost"] },
+            { id: "Civil Society", disposition: "supportive", priorities: ["transparency", "fairness", "rights"] },
+        ],
+        assumptions: {
+            severity: "high",
+            environmental_hostility: "moderate",
+            time_pressure: "low",
+            regulatory_climate: "adversarial",
+        },
+        constraints: {
+            time_horizon: "18 months",
+            regulatory: ["EU AI Act", "proposed US AI legislation"],
+            risk_tolerance: "moderate",
+        },
+        depth: "full",
+        perspective: "strategic_advisor",
+        swarm: { enabled: true, rounds: 4, reaction_model: "rational" },
+        tags: ["ai", "regulation", "technology", "policy"],
+        world: {
+            world_id: "ai_regulation",
+            name: "AI Regulation Landscape",
+            inline_definition: {
+                thesis: "AI regulation creates compliance burdens that reshape competitive dynamics between open and closed AI ecosystems",
+                state_variables: [
+                    { id: "regulation_strictness", label: "Regulation Strictness", type: "number", range: { min: 0, max: 1 }, default_value: 0.8 },
+                    { id: "enforcement_timeline_months", label: "Enforcement Timeline (months)", type: "number", range: { min: 3, max: 36 }, default_value: 18 },
+                    { id: "open_source_exemption", label: "Open Source Exemption", type: "boolean", default_value: false },
+                    { id: "us_follows_eu", label: "US Follows EU", type: "boolean", default_value: true },
+                    { id: "compliance_cost_multiplier", label: "Compliance Cost Multiplier", type: "number", range: { min: 1, max: 10 }, default_value: 3 },
+                ],
+                invariants: [
+                    { id: "INV-001", description: "Strict regulation without open-source exemption eliminates small AI labs", enforceable: true },
+                    { id: "INV-002", description: "Cross-jurisdiction regulation creates compliance arbitrage opportunities", enforceable: true },
+                    { id: "INV-003", description: "Enterprise customers require compliance before adoption", enforceable: true },
+                ],
+                gates: [
+                    { id: "GATE-001", label: "Market Consolidation", condition: "compliance_cost_multiplier > 5 && !open_source_exemption", severity: "critical" },
+                    { id: "GATE-002", label: "Innovation Flight", condition: "regulation_strictness > 0.7 && !us_follows_eu", severity: "warning" },
+                ],
+            },
+        },
+    },
+};
+/**
+ * Get a preset scenario as a full capsule.
+ */
+function getPresetCapsule(templateId) {
+    const template = exports.SCENARIO_TEMPLATES[templateId];
+    if (!template) {
+        throw new Error(`Unknown scenario template: ${String(templateId)}`);
+    }
+    const capsule = {
+        version: "1.0",
+        created_at: new Date().toISOString(),
+        ...template,
+    };
+    return {
+        ...capsule,
+        capsule_hash: computeCapsuleHash(capsule),
+    };
+}

package/dist/engine/swarmSimulation.js

@@ -0,0 +1,244 @@
+"use strict";
+/**
+ * Swarm Simulation Layer
+ *
+ * Lightweight stakeholder reaction simulation for POST /reason.
+ *
+ * IMPORTANT — MiroFish License Compliance:
+ * This is NOT MiroFish. This is Echelon's own lightweight reaction model.
+ * MiroFish is a separate product with its own license.
+ * If/when MiroFish integration is desired, it would be called as an
+ * external service via its REST API, respecting its license terms.
+ *
+ * This simulation layer uses:
+ * - Echelon-native stakeholder modeling
+ * - Simplified reaction dynamics (rational, emotional, mixed)
+ * - Projected reactions based on scenario decomposition
+ *
+ * It does NOT use MiroFish internals, algorithms, or data structures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runSwarmSimulation = runSwarmSimulation;
+// ============================================
+// REACTION MODELS
+// ============================================
+/**
+ * Model how a stakeholder reacts based on their disposition
+ * and the reaction model selected.
+ */
+function modelReaction(stakeholder, path, model, round) {
+    const disposition = stakeholder.disposition ?? "unknown";
+    const pathRisk = path.risk;
+    // Base confidence decreases with rounds (more uncertainty over time)
+    const baseConfidence = Math.max(0.3, 0.9 - round * 0.15);
+    // Impact calculation based on disposition + path risk
+    let impact = 0;
+    let reaction = "";
+    let trigger = "";
+    switch (model) {
+        case "rational": {
+            // Rational agents evaluate based on self-interest
+            const benefited = path.benefits_stakeholders?.includes(stakeholder.id);
+            const harmed = path.harms_stakeholders?.includes(stakeholder.id);
+            if (benefited) {
+                impact = 0.5 + Math.random() * 0.3;
+                reaction = `${stakeholder.id} supports this path — aligns with their priorities`;
+                trigger = "Self-interest alignment";
+            }
+            else if (harmed) {
+                impact = -(0.5 + Math.random() * 0.3);
+                reaction = `${stakeholder.id} opposes this path — threatens their position`;
+                trigger = "Self-interest conflict";
+            }
+            else {
+                impact = (Math.random() - 0.5) * 0.4;
+                reaction = `${stakeholder.id} monitors the situation — no strong position yet`;
+                trigger = "Neutral assessment";
+            }
+            break;
+        }
+        case "emotional": {
+            // Emotional agents react more strongly and less predictably
+            const volatility = disposition === "hostile" ? 0.8 : disposition === "supportive" ? 0.3 : 0.5;
+            impact = (Math.random() - 0.5) * 2 * volatility;
+            if (pathRisk === "high" || pathRisk === "critical") {
+                impact -= 0.3; // Fear response to high-risk scenarios
+                reaction = `${stakeholder.id} reacts with concern — elevated anxiety about ${pathRisk} risk`;
+                trigger = "Fear of high-risk outcome";
+            }
+            else {
+                reaction = `${stakeholder.id} responds with ${impact > 0 ? "cautious optimism" : "skepticism"}`;
+                trigger = "Emotional assessment of path viability";
+            }
+            break;
+        }
+        case "mixed":
+        default: {
+            // Mixed model: 60% rational, 40% emotional
+            const rationalComponent = (() => {
+                const benefited = path.benefits_stakeholders?.includes(stakeholder.id);
+                const harmed = path.harms_stakeholders?.includes(stakeholder.id);
+                if (benefited)
+                    return 0.4;
+                if (harmed)
+                    return -0.4;
+                return 0;
+            })();
+            const emotionalComponent = (Math.random() - 0.5) * 0.6;
+            impact = rationalComponent * 0.6 + emotionalComponent * 0.4;
+            if (disposition === "hostile") {
+                impact -= 0.2;
+                reaction = `${stakeholder.id} pushes back — predisposed against this approach`;
+                trigger = "Pre-existing opposition + rational assessment";
+            }
+            else if (disposition === "supportive") {
+                impact += 0.15;
+                reaction = `${stakeholder.id} provides conditional support — reserves judgment on execution`;
+                trigger = "Pre-existing alignment + cautious evaluation";
+            }
+            else {
+                reaction = `${stakeholder.id} weighs options — ${impact > 0 ? "leaning toward engagement" : "leaning toward caution"}`;
+                trigger = "Mixed rational-emotional evaluation";
+            }
+            break;
+        }
+    }
+    // Clamp impact to [-1, 1]
+    impact = Math.max(-1, Math.min(1, impact));
+    return {
+        stakeholder_id: stakeholder.id,
+        reaction,
+        confidence: Number((baseConfidence + (Math.random() - 0.5) * 0.2).toFixed(2)),
+        impact: Number(impact.toFixed(2)),
+        trigger,
+    };
+}
+// ============================================
+// EMERGENT DYNAMICS
+// ============================================
+/**
+ * Detect emergent dynamics from a round of reactions.
+ * These are patterns that arise from the combination of individual reactions.
+ */
+function detectEmergentDynamics(reactions) {
+    const dynamics = [];
+    // Check for consensus
+    const avgImpact = reactions.reduce((sum, r) => sum + r.impact, 0) / reactions.length;
+    if (Math.abs(avgImpact) > 0.5) {
+        dynamics.push(avgImpact > 0
+            ? "Strong positive consensus emerging — stakeholders broadly supportive"
+            : "Strong negative consensus emerging — widespread opposition forming");
+    }
+    // Check for polarization
+    const positive = reactions.filter((r) => r.impact > 0.2).length;
+    const negative = reactions.filter((r) => r.impact < -0.2).length;
+    if (positive > 0 && negative > 0 && Math.abs(positive - negative) <= 1) {
+        dynamics.push("Polarization detected — stakeholder base splitting into opposing camps");
+    }
+    // Check for high-confidence negative reactions
+    const highConfidenceNegative = reactions.filter((r) => r.confidence > 0.7 && r.impact < -0.3);
+    if (highConfidenceNegative.length >= 2) {
+        dynamics.push(`Coalition risk: ${highConfidenceNegative.map((r) => r.stakeholder_id).join(" + ")} may form opposition bloc`);
+    }
+    return dynamics;
+}
+// ============================================
+// TRAJECTORY ANALYSIS
+// ============================================
+/**
+ * Determine the overall trajectory from multiple simulation rounds.
+ */
+function analyzeTrajectory(rounds) {
+    if (rounds.length < 2)
+        return "stabilizing";
+    const avgImpacts = rounds.map((r) => r.reactions.reduce((sum, rx) => sum + rx.impact, 0) / r.reactions.length);
+    // Check trend
+    const trend = avgImpacts[avgImpacts.length - 1] - avgImpacts[0];
+    const variance = avgImpacts.reduce((sum, v) => {
+        const mean = avgImpacts.reduce((s, x) => s + x, 0) / avgImpacts.length;
+        return sum + (v - mean) ** 2;
+    }, 0) / avgImpacts.length;
+    if (variance > 0.15)
+        return "diverging";
+    if (Math.abs(trend) < 0.1 && variance < 0.05)
+        return "converging";
+    if (trend < -0.2)
+        return "escalating";
+    return "stabilizing";
+}
+/**
+ * Identify inflection points across rounds.
+ */
+function findInflectionPoints(rounds) {
+    const points = [];
+    for (let i = 1; i < rounds.length; i++) {
+        const prevAvg = rounds[i - 1].reactions.reduce((s, r) => s + r.impact, 0) /
+            rounds[i - 1].reactions.length;
+        const currAvg = rounds[i].reactions.reduce((s, r) => s + r.impact, 0) /
+            rounds[i].reactions.length;
+        const shift = Math.abs(currAvg - prevAvg);
+        if (shift > 0.3) {
+            points.push(`Round ${i}: Significant sentiment shift (${shift > 0 ? "positive" : "negative"} swing of ${(shift * 100).toFixed(0)}%)`);
+        }
+        // Check for individual stakeholder flips
+        for (const reaction of rounds[i].reactions) {
+            const prevReaction = rounds[i - 1].reactions.find((r) => r.stakeholder_id === reaction.stakeholder_id);
+            if (prevReaction) {
+                const individualShift = Math.abs(reaction.impact - prevReaction.impact);
+                if (individualShift > 0.5) {
+                    points.push(`Round ${i}: ${reaction.stakeholder_id} dramatically shifts position`);
+                }
+            }
+        }
+    }
+    if (points.length === 0) {
+        points.push("No major inflection points detected — scenario evolves gradually");
+    }
+    return points;
+}
+// ============================================
+// MAIN SIMULATION
+// ============================================
+/**
+ * Run the swarm simulation.
+ *
+ * This is Echelon's native reaction model — NOT MiroFish.
+ * It simulates how stakeholders react to different reasoning paths
+ * over multiple rounds, detecting emergent dynamics.
+ */
+async function runSwarmSimulation(scenario, stakeholders, paths, config) {
+    const roundCount = config.rounds ?? 3;
+    const model = config.reaction_model ?? "mixed";
+    // Filter stakeholders if specific ones requested
+    const activeStakeholders = config.simulate_stakeholders
+        ? stakeholders.filter((s) => config.simulate_stakeholders.includes(s.id))
+        : stakeholders;
+    // Use the first (most likely) path for simulation
+    const primaryPath = paths[0];
+    if (!primaryPath) {
+        return {
+            rounds: [],
+            trajectory: "stabilizing",
+            inflection_points: ["No reasoning paths available for simulation"],
+        };
+    }
+    // Run simulation rounds
+    const rounds = [];
+    for (let round = 0; round < roundCount; round++) {
+        const reactions = activeStakeholders.map((stakeholder) => modelReaction(stakeholder, primaryPath, model, round));
+        const emergentDynamics = detectEmergentDynamics(reactions);
+        rounds.push({
+            round,
+            reactions,
+            emergent_dynamics: emergentDynamics,
+        });
+    }
+    // Analyze overall trajectory
+    const trajectory = analyzeTrajectory(rounds);
+    const inflectionPoints = findInflectionPoints(rounds);
+    return {
+        rounds,
+        trajectory,
+        inflection_points: inflectionPoints,
+    };
+}

package/dist/engine/types.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * POST /reason API — Type Contracts
+ *
+ * The external reasoning API that makes Echelon infrastructure.
+ * Any autonomous agent, application, or service can call POST /reason
+ * with a scenario and constraints, and receive structured reasoning output.
+ *
+ * Design principles:
+ * - Stateless: no server-side storage of scenarios or results
+ * - BYOK: caller provides their own API key for the underlying LLM
+ * - Governance traces included in every response (open governance layer)
+ * - Echelon reasoning engine is private/proprietary
+ */
+Object.defineProperty(exports, "__esModule", { value: true });