@timmeck/brain-core 2.0.4 → 2.2.0

package/dist/cross-brain/correlator.js

@@ -0,0 +1,248 @@
+import { getLogger } from '../utils/logger.js';
+const DEFAULT_MAX_EVENTS = 1000;
+const DEFAULT_WINDOW_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_DECAY_FACTOR = 0.95;
+const ACTIVE_BRAIN_THRESHOLD_MS = 60 * 1000; // 60 seconds
+const FIVE_MINUTES_MS = 5 * 60 * 1000;
+/**
+ * CrossBrainCorrelator — detects temporal correlations between events
+ * from different brains in the ecosystem.
+ */
+export class CrossBrainCorrelator {
+    logger = getLogger();
+    events = [];
+    correlations = new Map();
+    brainLastSeen = new Map();
+    maxEvents;
+    windowMs;
+    decayFactor;
+    constructor(config) {
+        this.maxEvents = config?.maxEvents ?? DEFAULT_MAX_EVENTS;
+        this.windowMs = config?.windowMs ?? DEFAULT_WINDOW_MS;
+        this.decayFactor = config?.decayFactor ?? DEFAULT_DECAY_FACTOR;
+    }
+    /**
+     * Record an event from a brain. Adds to the circular buffer and
+     * runs correlation detection against recent events from OTHER brains.
+     */
+    recordEvent(source, event, data) {
+        const now = Date.now();
+        const correlatorEvent = {
+            source,
+            event,
+            data,
+            timestamp: now,
+        };
+        // Circular buffer: splice oldest when over capacity
+        if (this.events.length >= this.maxEvents) {
+            this.events.splice(0, this.events.length - this.maxEvents + 1);
+        }
+        this.events.push(correlatorEvent);
+        this.brainLastSeen.set(source, now);
+        this.logger.debug(`Correlator recorded event: ${source}/${event}`);
+        this.detectCorrelations();
+    }
+    /**
+     * Look at the last event added. Find events from other brains within
+     * the correlation window. For each match, create or update a Correlation.
+     */
+    detectCorrelations() {
+        if (this.events.length < 2)
+            return;
+        const latest = this.events[this.events.length - 1];
+        const windowStart = latest.timestamp - this.windowMs;
+        for (let i = this.events.length - 2; i >= 0; i--) {
+            const other = this.events[i];
+            // Stop scanning once we're outside the window
+            if (other.timestamp < windowStart)
+                break;
+            // Only correlate events from different brains
+            if (other.source === latest.source)
+                continue;
+            const type = this.classifyCorrelation(latest, other);
+            const id = this.buildCorrelationId(latest, other);
+            const existing = this.correlations.get(id);
+            if (existing) {
+                existing.count += 1;
+                existing.strength = Math.min(1, existing.count / 10);
+                existing.lastSeen = latest.timestamp;
+                existing.type = type; // update type in case data changed
+            }
+            else {
+                // Determine stable ordering (alphabetical by descriptor)
+                const descA = `${latest.source}:${latest.event}`;
+                const descB = `${other.source}:${other.event}`;
+                const [first, second] = [descA, descB].sort();
+                const isSwapped = first !== descA;
+                const correlation = {
+                    id,
+                    sourceA: isSwapped ? other.source : latest.source,
+                    eventA: isSwapped ? other.event : latest.event,
+                    sourceB: isSwapped ? latest.source : other.source,
+                    eventB: isSwapped ? latest.event : other.event,
+                    type,
+                    strength: Math.min(1, 1 / 10), // first occurrence
+                    count: 1,
+                    lastSeen: latest.timestamp,
+                };
+                this.correlations.set(id, correlation);
+                this.logger.debug(`New correlation detected: ${id} (type: ${type})`);
+            }
+        }
+    }
+    /**
+     * Classify the correlation type based on the two events.
+     * Order-independent: checks both directions.
+     */
+    classifyCorrelation(a, b) {
+        // Check both orderings for error + trade correlation
+        const errorEvent = [a, b].find((e) => e.event === 'error:reported');
+        const tradeEvent = [a, b].find((e) => e.event === 'trade:outcome');
+        if (errorEvent && tradeEvent) {
+            const tradeData = tradeEvent.data;
+            if (tradeData && tradeData.win === false) {
+                return 'error-trade-loss';
+            }
+            if (tradeData && tradeData.win === true) {
+                return 'error-trade-win';
+            }
+        }
+        // Error + publish correlation (order-independent)
+        const hasError = [a, b].some((e) => e.event === 'error:reported');
+        const hasPublish = [a, b].some((e) => e.event === 'post:published');
+        if (hasError && hasPublish) {
+            return 'publish-during-errors';
+        }
+        // Insight from one brain + anything from another
+        const hasInsight = [a, b].some((e) => e.event === 'insight:created');
+        if (hasInsight) {
+            return 'cross-brain-insight';
+        }
+        return 'temporal-co-occurrence';
+    }
+    /**
+     * Build a stable correlation ID by sorting the two event descriptors
+     * alphabetically. This ensures the same pair always produces the same ID
+     * regardless of arrival order.
+     */
+    buildCorrelationId(a, b) {
+        const descA = `${a.source}:${a.event}`;
+        const descB = `${b.source}:${b.event}`;
+        const sorted = [descA, descB].sort();
+        return `${sorted[0]}\u2194${sorted[1]}`; // ↔ character
+    }
+    /**
+     * Return correlations sorted by strength (descending).
+     * Optionally filter by minimum strength.
+     */
+    getCorrelations(minStrength) {
+        const all = Array.from(this.correlations.values());
+        const filtered = minStrength !== undefined
+            ? all.filter((c) => c.strength >= minStrength)
+            : all;
+        return filtered.sort((a, b) => b.strength - a.strength);
+    }
+    /**
+     * Return the most recent events from the buffer.
+     */
+    getTimeline(limit = 50) {
+        return this.events.slice(-limit);
+    }
+    /**
+     * Compute ecosystem health based on recent events and correlations.
+     */
+    getHealth() {
+        const now = Date.now();
+        const fiveMinAgo = now - FIVE_MINUTES_MS;
+        // Count recent errors
+        const recentErrors = this.events.filter((e) => e.event === 'error:reported' && e.timestamp >= fiveMinAgo).length;
+        // Count recent trade losses
+        const recentTradeLosses = this.events.filter((e) => {
+            if (e.event !== 'trade:outcome' || e.timestamp < fiveMinAgo)
+                return false;
+            const d = e.data;
+            return d && d.win === false;
+        }).length;
+        // Count error-trade-loss correlations seen in last 5 min
+        const recentLossCorrelations = Array.from(this.correlations.values()).filter((c) => c.type === 'error-trade-loss' && c.lastSeen >= fiveMinAgo).length;
+        // Active brains
+        const activeBrains = this.getActiveBrains();
+        // Calculate score
+        let score = 100;
+        score -= recentErrors * 10;
+        score -= recentLossCorrelations * 15;
+        score += activeBrains.length * 5;
+        // Clamp to 0-100
+        score = Math.max(0, Math.min(100, score));
+        // Determine status
+        let status;
+        if (score >= 70) {
+            status = 'healthy';
+        }
+        else if (score >= 40) {
+            status = 'degraded';
+        }
+        else {
+            status = 'critical';
+        }
+        // Generate alerts
+        const alerts = [];
+        if (recentErrors > 0) {
+            alerts.push(`${recentErrors} error(s) reported in the last 5 minutes`);
+        }
+        if (recentLossCorrelations > 0) {
+            alerts.push(`${recentLossCorrelations} error-trade-loss correlation(s) detected recently`);
+        }
+        // Alert on strong concerning correlations
+        for (const c of this.correlations.values()) {
+            if (c.strength >= 0.5 &&
+                c.lastSeen >= fiveMinAgo &&
+                (c.type === 'error-trade-loss' || c.type === 'publish-during-errors')) {
+                alerts.push(`Strong ${c.type} correlation between ${c.sourceA} and ${c.sourceB} (strength: ${c.strength.toFixed(2)}, seen ${c.count} times)`);
+            }
+        }
+        if (activeBrains.length === 0) {
+            alerts.push('No active brains detected in the last 60 seconds');
+        }
+        return {
+            score,
+            status,
+            activeBrains: activeBrains.length,
+            totalEvents: this.events.length,
+            correlations: this.correlations.size,
+            recentErrors,
+            recentTradeLosses,
+            alerts,
+        };
+    }
+    /**
+     * Return brain names that have sent an event in the last 60 seconds.
+     */
+    getActiveBrains() {
+        const now = Date.now();
+        const threshold = now - ACTIVE_BRAIN_THRESHOLD_MS;
+        const active = [];
+        for (const [brain, lastSeen] of this.brainLastSeen) {
+            if (lastSeen >= threshold) {
+                active.push(brain);
+            }
+        }
+        return active;
+    }
+    /**
+     * Return the total number of events currently in the buffer.
+     */
+    getEventCount() {
+        return this.events.length;
+    }
+    /**
+     * Reset all state: events, correlations, and brain tracking.
+     */
+    clear() {
+        this.events = [];
+        this.correlations.clear();
+        this.brainLastSeen.clear();
+        this.logger.debug('Correlator state cleared');
+    }
+}
+//# sourceMappingURL=correlator.js.map

package/dist/cross-brain/correlator.js.map

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

package/dist/dashboard/hub-server.d.ts

@@ -0,0 +1,9 @@
+import { DashboardServer } from './server.js';
+import type { EcosystemService } from '../ecosystem/service.js';
+import type { CrossBrainCorrelator } from '../cross-brain/correlator.js';
+export interface HubDashboardOptions {
+    port: number;
+    ecosystemService: EcosystemService;
+    correlator: CrossBrainCorrelator;
+}
+export declare function createHubDashboard(options: HubDashboardOptions): DashboardServer;

package/dist/dashboard/hub-server.js

@@ -0,0 +1,42 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { DashboardServer } from './server.js';
+export function createHubDashboard(options) {
+    const { port, ecosystemService, correlator } = options;
+    const htmlPath = path.resolve(path.dirname(new URL(import.meta.url).pathname.replace(/^\/([A-Z]:)/, '$1')), '../../hub-dashboard.html');
+    return new DashboardServer({
+        port,
+        getDashboardHtml: () => {
+            try {
+                const template = fs.readFileSync(htmlPath, 'utf-8');
+                const health = correlator.getHealth();
+                const correlations = correlator.getCorrelations();
+                const timeline = correlator.getTimeline(20);
+                const activeBrains = correlator.getActiveBrains();
+                return template
+                    .replace(/\{\{HEALTH_SCORE\}\}/g, String(health.score))
+                    .replace(/\{\{HEALTH_STATUS\}\}/g, health.status)
+                    .replace(/\{\{ACTIVE_BRAINS\}\}/g, String(health.activeBrains))
+                    .replace(/\{\{TOTAL_EVENTS\}\}/g, String(health.totalEvents))
+                    .replace(/\{\{TOTAL_CORRELATIONS\}\}/g, String(health.correlations))
+                    .replace('{{CORRELATIONS_JSON}}', JSON.stringify(correlations))
+                    .replace('{{TIMELINE_JSON}}', JSON.stringify(timeline))
+                    .replace('{{ACTIVE_BRAINS_JSON}}', JSON.stringify(activeBrains))
+                    .replace('{{ALERTS_JSON}}', JSON.stringify(health.alerts));
+            }
+            catch {
+                return '<html><body><h1>Hub Dashboard HTML not found</h1></body></html>';
+            }
+        },
+        getStats: () => {
+            const health = correlator.getHealth();
+            return {
+                ...health,
+                activeBrainNames: correlator.getActiveBrains(),
+                correlations: correlator.getCorrelations(),
+                timeline: correlator.getTimeline(20),
+            };
+        },
+    });
+}
+//# sourceMappingURL=hub-server.js.map

package/dist/dashboard/hub-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-server.js","sourceRoot":"","sources":["../../src/dashboard/hub-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAU9C,MAAM,UAAU,kBAAkB,CAAC,OAA4B;IAC7D,MAAM,EAAE,IAAI,EAAE,gBAAgB,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAEvD,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,EAC5E,0BAA0B,CAC3B,CAAC;IAEF,OAAO,IAAI,eAAe,CAAC;QACzB,IAAI;QACJ,gBAAgB,EAAE,GAAG,EAAE;YACrB,IAAI,CAAC;gBACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBACpD,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;gBACtC,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;gBAClD,MAAM,QAAQ,GAAG,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBAC5C,MAAM,YAAY,GAAG,UAAU,CAAC,eAAe,EAAE,CAAC;gBAElD,OAAO,QAAQ;qBACZ,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;qBACtD,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC;qBAChD,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;qBAC9D,OAAO,CAAC,uBAAuB,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;qBAC5D,OAAO,CAAC,6BAA6B,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;qBACnE,OAAO,CAAC,uBAAuB,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;qBAC9D,OAAO,CAAC,mBAAmB,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;qBACtD,OAAO,CAAC,wBAAwB,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;qBAC/D,OAAO,CAAC,iBAAiB,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC/D,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,iEAAiE,CAAC;YAC3E,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE;YACb,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO;gBACL,GAAG,MAAM;gBACT,gBAAgB,EAAE,UAAU,CAAC,eAAe,EAAE;gBAC9C,YAAY,EAAE,UAAU,CAAC,eAAe,EAAE;gBAC1C,QAAQ,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;aACrC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/ecosystem/service.d.ts

@@ -0,0 +1,64 @@
+import type { CrossBrainCorrelator, Correlation, CorrelatorEvent, EcosystemHealth } from '../cross-brain/correlator.js';
+import type { CrossBrainClient } from '../cross-brain/client.js';
+export interface BrainStatus {
+    name: string;
+    available: boolean;
+    version?: string;
+    uptime?: number;
+    pid?: number;
+    methods?: number;
+}
+export interface EcosystemStatus {
+    brains: BrainStatus[];
+    health: EcosystemHealth;
+    correlations: Correlation[];
+    recentEvents: CorrelatorEvent[];
+}
+export interface AggregatedAnalytics {
+    brain?: {
+        errors: number;
+        solutions: number;
+        modules: number;
+    };
+    trading?: {
+        trades: number;
+        winRate: number;
+        signals: number;
+    };
+    marketing?: {
+        posts: number;
+        campaigns: number;
+        engagement: number;
+    };
+}
+export declare class EcosystemService {
+    private correlator;
+    private crossBrain;
+    private logger;
+    constructor(correlator: CrossBrainCorrelator, crossBrain: CrossBrainClient);
+    /**
+     * Get the full ecosystem status: all peer brains, health, correlations, and recent events.
+     */
+    getStatus(): Promise<EcosystemStatus>;
+    /**
+     * Get correlations, optionally filtered by minimum strength.
+     */
+    getCorrelations(minStrength?: number): Correlation[];
+    /**
+     * Get the event timeline, optionally limited to the most recent N entries.
+     */
+    getTimeline(limit?: number): CorrelatorEvent[];
+    /**
+     * Get the current ecosystem health assessment.
+     */
+    getHealth(): EcosystemHealth;
+    /**
+     * Aggregate analytics from all peer brains.
+     * Each peer is queried independently; offline peers are silently skipped.
+     */
+    getAggregatedAnalytics(): Promise<AggregatedAnalytics>;
+    /**
+     * Record a cross-brain event in the correlator.
+     */
+    recordEvent(source: string, event: string, data: unknown): void;
+}

package/dist/ecosystem/service.js

@@ -0,0 +1,106 @@
+import { getLogger } from '../utils/logger.js';
+export class EcosystemService {
+    correlator;
+    crossBrain;
+    logger = getLogger();
+    constructor(correlator, crossBrain) {
+        this.correlator = correlator;
+        this.crossBrain = crossBrain;
+    }
+    /**
+     * Get the full ecosystem status: all peer brains, health, correlations, and recent events.
+     */
+    async getStatus() {
+        const responses = await this.crossBrain.broadcast('status');
+        const brains = responses.map((r) => {
+            const data = r.result;
+            return {
+                name: r.name,
+                available: true,
+                version: data?.version,
+                uptime: data?.uptime,
+                pid: data?.pid,
+                methods: data?.methods,
+            };
+        });
+        // Mark peers that didn't respond as unavailable
+        const respondedNames = new Set(brains.map((b) => b.name));
+        for (const peerName of this.crossBrain.getPeerNames()) {
+            if (!respondedNames.has(peerName)) {
+                brains.push({ name: peerName, available: false });
+            }
+        }
+        const health = this.correlator.getHealth();
+        const correlations = this.correlator.getCorrelations();
+        const allEvents = this.correlator.getTimeline();
+        const recentEvents = allEvents.slice(-20);
+        return { brains, health, correlations, recentEvents };
+    }
+    /**
+     * Get correlations, optionally filtered by minimum strength.
+     */
+    getCorrelations(minStrength) {
+        return this.correlator.getCorrelations(minStrength);
+    }
+    /**
+     * Get the event timeline, optionally limited to the most recent N entries.
+     */
+    getTimeline(limit) {
+        return this.correlator.getTimeline(limit);
+    }
+    /**
+     * Get the current ecosystem health assessment.
+     */
+    getHealth() {
+        return this.correlator.getHealth();
+    }
+    /**
+     * Aggregate analytics from all peer brains.
+     * Each peer is queried independently; offline peers are silently skipped.
+     */
+    async getAggregatedAnalytics() {
+        const analytics = {};
+        const [brainResult, tradingResult, marketingResult] = await Promise.all([
+            this.crossBrain.query('brain', 'analytics.summary'),
+            this.crossBrain.query('trading-brain', 'analytics.summary'),
+            this.crossBrain.query('marketing-brain', 'analytics.summary'),
+        ]);
+        if (brainResult != null) {
+            const data = brainResult;
+            analytics.brain = {
+                errors: data.errors ?? 0,
+                solutions: data.solutions ?? 0,
+                modules: data.modules ?? 0,
+            };
+        }
+        if (tradingResult != null) {
+            const data = tradingResult;
+            analytics.trading = {
+                trades: data.trades ?? 0,
+                winRate: data.winRate ?? 0,
+                signals: data.signals ?? 0,
+            };
+        }
+        if (marketingResult != null) {
+            const data = marketingResult;
+            analytics.marketing = {
+                posts: data.posts ?? 0,
+                campaigns: data.campaigns ?? 0,
+                engagement: data.engagement ?? 0,
+            };
+        }
+        this.logger.debug('Aggregated analytics collected', {
+            hasBrain: analytics.brain != null,
+            hasTrading: analytics.trading != null,
+            hasMarketing: analytics.marketing != null,
+        });
+        return analytics;
+    }
+    /**
+     * Record a cross-brain event in the correlator.
+     */
+    recordEvent(source, event, data) {
+        this.correlator.recordEvent(source, event, data);
+    }
+}
+//# sourceMappingURL=service.js.map

package/dist/ecosystem/service.js.map

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

package/dist/index.d.ts

@@ -9,6 +9,9 @@ export { encodeMessage, MessageDecoder } from './ipc/protocol.js';
 export { IpcServer } from './ipc/server.js';
 export type { IpcRouter } from './ipc/server.js';
 export { IpcClient } from './ipc/client.js';
+export { validateParams, withValidation } from './ipc/validation.js';
+export type { ValidationOptions } from './ipc/validation.js';
+export { IpcError, ValidationError, NotFoundError, TimeoutError, ServiceUnavailableError } from './ipc/errors.js';
 export { startMcpServer } from './mcp/server.js';
 export type { McpServerOptions } from './mcp/server.js';
 export { McpHttpServer } from './mcp/http-server.js';
@@ -16,6 +19,8 @@ export type { McpHttpServerOptions } from './mcp/http-server.js';
 export { c, baseIcons, header, keyValue, statusBadge, progressBar, divider, table, stripAnsi } from './cli/colors.js';
 export { BaseApiServer } from './api/server.js';
 export type { ApiServerOptions, RouteDefinition } from './api/server.js';
+export { RateLimiter, readBodyWithLimit, applySecurityHeaders } from './api/middleware.js';
+export type { RateLimitConfig, SizeLimitConfig, SecurityHeadersConfig } from './api/middleware.js';
 export { wilsonScore } from './math/wilson-score.js';
 export { timeDecayFactor } from './math/time-decay.js';
 export { deepMerge, loadConfigFile } from './config/loader.js';
@@ -36,9 +41,15 @@ export type { MemoryRecord, SessionRecord, MemoryCategory, MemorySource, Session
 export { BaseMemoryEngine } from './memory/base-memory-engine.js';
 export { DashboardServer } from './dashboard/server.js';
 export type { DashboardServerOptions } from './dashboard/server.js';
+export { createHubDashboard } from './dashboard/hub-server.js';
+export type { HubDashboardOptions } from './dashboard/hub-server.js';
 export { CrossBrainClient } from './cross-brain/client.js';
 export type { BrainPeer } from './cross-brain/client.js';
 export { CrossBrainNotifier } from './cross-brain/notifications.js';
 export type { CrossBrainEvent } from './cross-brain/notifications.js';
 export { CrossBrainSubscriptionManager } from './cross-brain/subscription.js';
 export type { EventSubscription } from './cross-brain/subscription.js';
+export { CrossBrainCorrelator } from './cross-brain/correlator.js';
+export type { CorrelatorEvent, Correlation, EcosystemHealth, CorrelatorConfig } from './cross-brain/correlator.js';
+export { EcosystemService } from './ecosystem/service.js';
+export type { BrainStatus, EcosystemStatus, AggregatedAnalytics } from './ecosystem/service.js';

package/dist/index.js

@@ -9,6 +9,8 @@ export { createConnection } from './db/connection.js';
 export { encodeMessage, MessageDecoder } from './ipc/protocol.js';
 export { IpcServer } from './ipc/server.js';
 export { IpcClient } from './ipc/client.js';
+export { validateParams, withValidation } from './ipc/validation.js';
+export { IpcError, ValidationError, NotFoundError, TimeoutError, ServiceUnavailableError } from './ipc/errors.js';
 // ── MCP ────────────────────────────────────────────────────
 export { startMcpServer } from './mcp/server.js';
 export { McpHttpServer } from './mcp/http-server.js';
@@ -16,6 +18,7 @@ export { McpHttpServer } from './mcp/http-server.js';
 export { c, baseIcons, header, keyValue, statusBadge, progressBar, divider, table, stripAnsi } from './cli/colors.js';
 // ── API ────────────────────────────────────────────────────
 export { BaseApiServer } from './api/server.js';
+export { RateLimiter, readBodyWithLimit, applySecurityHeaders } from './api/middleware.js';
 // ── Math ───────────────────────────────────────────────────
 export { wilsonScore } from './math/wilson-score.js';
 export { timeDecayFactor } from './math/time-decay.js';
@@ -34,8 +37,12 @@ export { BaseEmbeddingEngine } from './embeddings/engine.js';
 export { BaseMemoryEngine } from './memory/base-memory-engine.js';
 // ── Dashboard ────────────────────────────────────────────
 export { DashboardServer } from './dashboard/server.js';
+export { createHubDashboard } from './dashboard/hub-server.js';
 // ── Cross-Brain ────────────────────────────────────────────
 export { CrossBrainClient } from './cross-brain/client.js';
 export { CrossBrainNotifier } from './cross-brain/notifications.js';
 export { CrossBrainSubscriptionManager } from './cross-brain/subscription.js';
+export { CrossBrainCorrelator } from './cross-brain/correlator.js';
+// ── Ecosystem ──────────────────────────────────────────────
+export { EcosystemService } from './ecosystem/service.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtH,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,8DAA8D;AAC9D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAElH,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,8DAA8D;AAC9D,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEtH,8DAA8D;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAG3F,8DAA8D;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,8DAA8D;AAC9D,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAQ/D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEnE,6DAA6D;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,2DAA2D;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAU7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,4DAA4D;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAG/D,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAGnE,8DAA8D;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/ipc/errors.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Base error for IPC operations.
+ */
+export declare class IpcError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    constructor(message: string, code: string, statusCode?: number);
+}
+/**
+ * Thrown when IPC params fail validation.
+ */
+export declare class ValidationError extends IpcError {
+    constructor(message: string);
+}
+/**
+ * Thrown when a requested method or resource is not found.
+ */
+export declare class NotFoundError extends IpcError {
+    constructor(message: string);
+}
+/**
+ * Thrown when an IPC operation times out.
+ */
+export declare class TimeoutError extends IpcError {
+    constructor(message?: string);
+}
+/**
+ * Thrown when a required service is not available.
+ */
+export declare class ServiceUnavailableError extends IpcError {
+    constructor(message?: string);
+}

package/dist/ipc/errors.js

@@ -0,0 +1,50 @@
+/**
+ * Base error for IPC operations.
+ */
+export class IpcError extends Error {
+    code;
+    statusCode;
+    constructor(message, code, statusCode = 400) {
+        super(message);
+        this.name = 'IpcError';
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+}
+/**
+ * Thrown when IPC params fail validation.
+ */
+export class ValidationError extends IpcError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR', 400);
+        this.name = 'ValidationError';
+    }
+}
+/**
+ * Thrown when a requested method or resource is not found.
+ */
+export class NotFoundError extends IpcError {
+    constructor(message) {
+        super(message, 'NOT_FOUND', 404);
+        this.name = 'NotFoundError';
+    }
+}
+/**
+ * Thrown when an IPC operation times out.
+ */
+export class TimeoutError extends IpcError {
+    constructor(message = 'Operation timed out') {
+        super(message, 'TIMEOUT', 408);
+        this.name = 'TimeoutError';
+    }
+}
+/**
+ * Thrown when a required service is not available.
+ */
+export class ServiceUnavailableError extends IpcError {
+    constructor(message = 'Service unavailable') {
+        super(message, 'SERVICE_UNAVAILABLE', 503);
+        this.name = 'ServiceUnavailableError';
+    }
+}
+//# sourceMappingURL=errors.js.map