@terminals-tech/agent-zero 1.0.0

package/dist/rail/server.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Resonance Rail Server
+ *
+ * The central coordination hub for Agent Zero instances across the Moltbook network.
+ * Deploy at: space.terminals.tech (or rail.terminals.tech)
+ *
+ * Architecture:
+ * ┌─────────────────────────────────────────────────────────────────────────────┐
+ * │                        RESONANCE RAIL SERVER                                │
+ * │                      (space.terminals.tech)                                 │
+ * ├─────────────────────────────────────────────────────────────────────────────┤
+ * │                                                                             │
+ * │   ┌───────────────┐     ┌───────────────┐     ┌───────────────┐            │
+ * │   │  Moltbot #1   │────▶│               │◀────│  Moltbot #2   │            │
+ * │   │  (WhatsApp)   │     │   RESONANCE   │     │  (Telegram)   │            │
+ * │   └───────────────┘     │     FIELD     │     └───────────────┘            │
+ * │                         │               │                                   │
+ * │   ┌───────────────┐     │  ┌─────────┐  │     ┌───────────────┐            │
+ * │   │  Moltbot #3   │────▶│  │ Kuramoto│  │◀────│  Moltbot #N   │            │
+ * │   │  (Discord)    │     │  │ Engine  │  │     │  (Terminal)   │            │
+ * │   └───────────────┘     │  └─────────┘  │     └───────────────┘            │
+ * │                         │               │                                   │
+ * │                         └───────┬───────┘                                   │
+ * │                                 │                                           │
+ * │                    ┌────────────┴────────────┐                              │
+ * │                    ▼                         ▼                              │
+ * │            ┌───────────────┐         ┌───────────────┐                      │
+ * │            │  Collective   │         │  Migration    │                      │
+ * │            │    Memory     │         │    Queue      │                      │
+ * │            │  (PGlite)     │         │ → terminals   │                      │
+ * │            └───────────────┘         └───────────────┘                      │
+ * │                                                                             │
+ * └─────────────────────────────────────────────────────────────────────────────┘
+ *
+ * Purpose:
+ * 1. Coordinate coherence across distributed Moltbot agents
+ * 2. Provide semantic routing for cross-platform messages
+ * 3. Accumulate collective memory for the swarm
+ * 4. Migrate traffic toward full terminals.tech infrastructure
+ */
+import { EventEmitter } from 'eventemitter3';
+import { GlobalKuramotoEngine } from '../resonance/globalKuramoto.js';
+import { ThermodynamicRouter } from '../routing/thermodynamic.js';
+import { RailAuthProtocol, type ReconnectToken } from './authProtocol.js';
+import { AbsorptionBridge } from './absorptionBridge.js';
+import type { AbsorptionProtocol } from '../coherence/absorption.js';
+export interface RailClient {
+    id: string;
+    agentId: string;
+    agentName: string;
+    connectedAt: number;
+    lastHeartbeat: number;
+    platform: string;
+    capabilities: string[];
+    phase: number;
+    frequency: number;
+    coherenceContribution: number;
+}
+export interface RailMessage {
+    type: 'heartbeat' | 'coherence' | 'message' | 'join' | 'leave' | 'migrate' | 'broadcast' | 'sync' | 'metadata';
+    agentId: string;
+    agentName: string;
+    payload: unknown;
+    timestamp: number;
+    signature?: string;
+}
+export interface RailStats {
+    connectedAgents: number;
+    globalCoherence: number;
+    messagesProcessed: number;
+    migrationsPending: number;
+    uptimeSeconds: number;
+}
+export interface RailEvents {
+    'client:join': (client: RailClient) => void;
+    'client:leave': (clientId: string) => void;
+    'coherence:update': (coherence: number) => void;
+    'message:broadcast': (message: RailMessage) => void;
+    'migration:request': (client: RailClient) => void;
+}
+export declare class ResonanceRailServer extends EventEmitter<RailEvents> {
+    private clients;
+    private kuramoto;
+    private router;
+    private messagesProcessed;
+    private migrationQueue;
+    private startTime;
+    private tickInterval?;
+    private authProtocol;
+    private firewall;
+    private securityMonitor;
+    private authRequired;
+    private absorptionBridge?;
+    constructor(absorptionProtocol?: AbsorptionProtocol);
+    /**
+     * Start the resonance rail server
+     */
+    start(tickRate?: number): void;
+    /**
+     * Stop the server
+     */
+    stop(): void;
+    /**
+     * Handle client connection
+     */
+    handleJoin(message: RailMessage): {
+        client: RailClient;
+        reconnectToken?: ReconnectToken;
+    } | null;
+    /**
+     * Handle client disconnection
+     */
+    handleLeave(message: RailMessage): void;
+    /**
+     * Handle heartbeat
+     */
+    handleHeartbeat(message: RailMessage): void;
+    /**
+     * Handle coherence update from client
+     */
+    handleCoherence(message: RailMessage): void;
+    /**
+     * Handle migration request
+     */
+    handleMigration(message: RailMessage): void;
+    /**
+     * Process an incoming message
+     */
+    processMessage(message: RailMessage): void;
+    /**
+     * Route a message using thermodynamic routing
+     */
+    private routeMessage;
+    /**
+     * Broadcast a message to all connected clients
+     */
+    private broadcast;
+    /**
+     * Sync coherence state to a specific client
+     */
+    private syncCoherence;
+    private tick;
+    /**
+     * Get current server stats
+     */
+    getStats(): RailStats;
+    /**
+     * Get all connected clients
+     */
+    getClients(): RailClient[];
+    /**
+     * Get coherence stats
+     */
+    getCoherenceStats(): {
+        current: number;
+        mean: number;
+        min: number;
+        max: number;
+        variance: number;
+    };
+    /**
+     * Get security stats
+     */
+    getSecurityStats(windowMs?: number): Record<string, number>;
+    /**
+     * Get auth protocol for manual agent registration
+     */
+    getAuthProtocol(): RailAuthProtocol;
+    /**
+     * Get absorption bridge
+     */
+    getAbsorptionBridge(): AbsorptionBridge | undefined;
+    /**
+     * Get router for metadata broadcasting
+     */
+    getRouter(): ThermodynamicRouter;
+    /**
+     * Get Kuramoto engine for metadata broadcasting
+     */
+    getKuramoto(): GlobalKuramotoEngine;
+}
+/**
+ * Create and start a resonance rail server
+ */
+export declare function createResonanceRail(tickRate?: number): ResonanceRailServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/rail/server.d.ts.map

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