agentic-qe 2.7.3 → 2.8.0

package/dist/edge/p2p/nat/types.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * NAT Traversal Types for @ruvector/edge P2P
+ *
+ * Type definitions for NAT detection, TURN management, hole punching,
+ * and connectivity testing in browser environments.
+ *
+ * @module edge/p2p/nat/types
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_ESCALATION_CONFIG = exports.DEFAULT_CONNECTIVITY_TESTER_CONFIG = exports.DEFAULT_HOLE_PUNCHER_CONFIG = exports.DEFAULT_TURN_MANAGER_CONFIG = exports.DEFAULT_NAT_DETECTOR_CONFIG = exports.DEFAULT_STUN_SERVERS = exports.NATEventType = exports.EscalationLevel = exports.ConnectionPath = exports.NAT_CONNECTIVITY_MATRIX = exports.NATClassification = void 0;
+// ============================================
+// NAT Type Classifications
+// ============================================
+/**
+ * NAT type classification based on RFC 3489/5389
+ *
+ * NAT behavior affects peer-to-peer connectivity:
+ * - Open/FullCone: Best connectivity, direct connections usually work
+ * - RestrictedCone: Good connectivity with coordination
+ * - PortRestricted: Limited connectivity, may need TURN
+ * - Symmetric: Most restrictive, usually requires TURN relay
+ */
+var NATClassification;
+(function (NATClassification) {
+    /** No NAT detected - public IP address */
+    NATClassification["Open"] = "open";
+    /** Full Cone NAT - most permissive NAT type */
+    NATClassification["FullCone"] = "full_cone";
+    /** Address Restricted Cone NAT */
+    NATClassification["RestrictedCone"] = "restricted_cone";
+    /** Port Restricted Cone NAT */
+    NATClassification["PortRestricted"] = "port_restricted";
+    /** Symmetric NAT - most restrictive */
+    NATClassification["Symmetric"] = "symmetric";
+    /** NAT type could not be determined */
+    NATClassification["Unknown"] = "unknown";
+    /** Detection in progress */
+    NATClassification["Detecting"] = "detecting";
+    /** Detection failed */
+    NATClassification["Failed"] = "failed";
+})(NATClassification || (exports.NATClassification = NATClassification = {}));
+/**
+ * Mapping table for NAT connectivity probability
+ * Values represent probability (0-1) of successful direct connection
+ */
+exports.NAT_CONNECTIVITY_MATRIX = {
+    [NATClassification.Open]: {
+        [NATClassification.Open]: 1.0,
+        [NATClassification.FullCone]: 1.0,
+        [NATClassification.RestrictedCone]: 1.0,
+        [NATClassification.PortRestricted]: 1.0,
+        [NATClassification.Symmetric]: 0.8,
+        [NATClassification.Unknown]: 0.5,
+        [NATClassification.Detecting]: 0.5,
+        [NATClassification.Failed]: 0.3,
+    },
+    [NATClassification.FullCone]: {
+        [NATClassification.Open]: 1.0,
+        [NATClassification.FullCone]: 1.0,
+        [NATClassification.RestrictedCone]: 0.95,
+        [NATClassification.PortRestricted]: 0.9,
+        [NATClassification.Symmetric]: 0.7,
+        [NATClassification.Unknown]: 0.5,
+        [NATClassification.Detecting]: 0.5,
+        [NATClassification.Failed]: 0.3,
+    },
+    [NATClassification.RestrictedCone]: {
+        [NATClassification.Open]: 1.0,
+        [NATClassification.FullCone]: 0.95,
+        [NATClassification.RestrictedCone]: 0.85,
+        [NATClassification.PortRestricted]: 0.7,
+        [NATClassification.Symmetric]: 0.5,
+        [NATClassification.Unknown]: 0.4,
+        [NATClassification.Detecting]: 0.4,
+        [NATClassification.Failed]: 0.2,
+    },
+    [NATClassification.PortRestricted]: {
+        [NATClassification.Open]: 1.0,
+        [NATClassification.FullCone]: 0.9,
+        [NATClassification.RestrictedCone]: 0.7,
+        [NATClassification.PortRestricted]: 0.5,
+        [NATClassification.Symmetric]: 0.3,
+        [NATClassification.Unknown]: 0.3,
+        [NATClassification.Detecting]: 0.3,
+        [NATClassification.Failed]: 0.1,
+    },
+    [NATClassification.Symmetric]: {
+        [NATClassification.Open]: 0.8,
+        [NATClassification.FullCone]: 0.7,
+        [NATClassification.RestrictedCone]: 0.5,
+        [NATClassification.PortRestricted]: 0.3,
+        [NATClassification.Symmetric]: 0.1,
+        [NATClassification.Unknown]: 0.2,
+        [NATClassification.Detecting]: 0.2,
+        [NATClassification.Failed]: 0.05,
+    },
+    [NATClassification.Unknown]: {
+        [NATClassification.Open]: 0.5,
+        [NATClassification.FullCone]: 0.5,
+        [NATClassification.RestrictedCone]: 0.4,
+        [NATClassification.PortRestricted]: 0.3,
+        [NATClassification.Symmetric]: 0.2,
+        [NATClassification.Unknown]: 0.3,
+        [NATClassification.Detecting]: 0.3,
+        [NATClassification.Failed]: 0.1,
+    },
+    [NATClassification.Detecting]: {
+        [NATClassification.Open]: 0.5,
+        [NATClassification.FullCone]: 0.5,
+        [NATClassification.RestrictedCone]: 0.4,
+        [NATClassification.PortRestricted]: 0.3,
+        [NATClassification.Symmetric]: 0.2,
+        [NATClassification.Unknown]: 0.3,
+        [NATClassification.Detecting]: 0.3,
+        [NATClassification.Failed]: 0.1,
+    },
+    [NATClassification.Failed]: {
+        [NATClassification.Open]: 0.3,
+        [NATClassification.FullCone]: 0.3,
+        [NATClassification.RestrictedCone]: 0.2,
+        [NATClassification.PortRestricted]: 0.1,
+        [NATClassification.Symmetric]: 0.05,
+        [NATClassification.Unknown]: 0.1,
+        [NATClassification.Detecting]: 0.1,
+        [NATClassification.Failed]: 0.05,
+    },
+};
+// ============================================
+// Connection Path Types
+// ============================================
+/**
+ * Connection path classification
+ */
+var ConnectionPath;
+(function (ConnectionPath) {
+    /** Direct peer-to-peer connection */
+    ConnectionPath["Direct"] = "direct";
+    /** Connection through TURN relay */
+    ConnectionPath["Relay"] = "relay";
+    /** Connection failed */
+    ConnectionPath["Failed"] = "failed";
+    /** Path determination in progress */
+    ConnectionPath["Pending"] = "pending";
+})(ConnectionPath || (exports.ConnectionPath = ConnectionPath = {}));
+// ============================================
+// Fallback Escalation Types
+// ============================================
+/**
+ * Fallback escalation level
+ */
+var EscalationLevel;
+(function (EscalationLevel) {
+    /** Try direct connection first */
+    EscalationLevel[EscalationLevel["Direct"] = 0] = "Direct";
+    /** Try UDP hole punching */
+    EscalationLevel[EscalationLevel["HolePunch"] = 1] = "HolePunch";
+    /** Try TCP connection */
+    EscalationLevel[EscalationLevel["TCP"] = 2] = "TCP";
+    /** Use TURN UDP relay */
+    EscalationLevel[EscalationLevel["TurnUdp"] = 3] = "TurnUdp";
+    /** Use TURN TCP relay */
+    EscalationLevel[EscalationLevel["TurnTcp"] = 4] = "TurnTcp";
+    /** Use TURN TLS relay */
+    EscalationLevel[EscalationLevel["TurnTls"] = 5] = "TurnTls";
+    /** All options exhausted */
+    EscalationLevel[EscalationLevel["Exhausted"] = 6] = "Exhausted";
+})(EscalationLevel || (exports.EscalationLevel = EscalationLevel = {}));
+// ============================================
+// Event Types
+// ============================================
+/**
+ * NAT module event types
+ */
+var NATEventType;
+(function (NATEventType) {
+    /** NAT detection started */
+    NATEventType["DetectionStarted"] = "nat_detection_started";
+    /** NAT detection completed */
+    NATEventType["DetectionCompleted"] = "nat_detection_completed";
+    /** NAT detection failed */
+    NATEventType["DetectionFailed"] = "nat_detection_failed";
+    /** TURN credentials refreshed */
+    NATEventType["CredentialsRefreshed"] = "turn_credentials_refreshed";
+    /** TURN allocation created */
+    NATEventType["AllocationCreated"] = "turn_allocation_created";
+    /** TURN allocation failed */
+    NATEventType["AllocationFailed"] = "turn_allocation_failed";
+    /** Hole punch started */
+    NATEventType["HolePunchStarted"] = "hole_punch_started";
+    /** Hole punch succeeded */
+    NATEventType["HolePunchSucceeded"] = "hole_punch_succeeded";
+    /** Hole punch failed */
+    NATEventType["HolePunchFailed"] = "hole_punch_failed";
+    /** Connectivity test completed */
+    NATEventType["ConnectivityTestCompleted"] = "connectivity_test_completed";
+    /** Escalation level changed */
+    NATEventType["EscalationChanged"] = "escalation_changed";
+    /** Connection path determined */
+    NATEventType["PathDetermined"] = "path_determined";
+})(NATEventType || (exports.NATEventType = NATEventType = {}));
+// ============================================
+// Default Configurations
+// ============================================
+/**
+ * Default STUN servers for NAT detection
+ */
+exports.DEFAULT_STUN_SERVERS = [
+    { urls: 'stun:stun.l.google.com:19302' },
+    { urls: 'stun:stun1.l.google.com:19302' },
+    { urls: 'stun:stun2.l.google.com:19302' },
+    { urls: 'stun:stun3.l.google.com:19302' },
+];
+/**
+ * Default NAT detector configuration
+ */
+exports.DEFAULT_NAT_DETECTOR_CONFIG = {
+    stunServers: exports.DEFAULT_STUN_SERVERS,
+    timeout: 10000,
+    enableCache: true,
+    cacheTtl: 300000, // 5 minutes
+    parallelTesting: true,
+    minServers: 2,
+};
+/**
+ * Default TURN manager configuration
+ */
+exports.DEFAULT_TURN_MANAGER_CONFIG = {
+    latencyTestTimeout: 5000,
+    enableHealthMonitoring: true,
+    healthCheckInterval: 60000,
+    maxCredentialAge: 3600000, // 1 hour
+};
+/**
+ * Default hole puncher configuration
+ */
+exports.DEFAULT_HOLE_PUNCHER_CONFIG = {
+    maxAttempts: 10,
+    attemptTimeout: 3000,
+    attemptDelay: 500,
+    enablePortPrediction: true,
+    portPredictionRange: 100,
+    enableSimultaneousOpen: true,
+};
+/**
+ * Default connectivity tester configuration
+ */
+exports.DEFAULT_CONNECTIVITY_TESTER_CONFIG = {
+    timeout: 15000,
+    pingCount: 10,
+    pingInterval: 100,
+    enableBandwidthTest: false,
+    maxAcceptableRtt: 500,
+    maxAcceptablePacketLoss: 10,
+};
+/**
+ * Default escalation configuration
+ */
+exports.DEFAULT_ESCALATION_CONFIG = {
+    autoEscalate: true,
+    maxAttemptsPerLevel: 3,
+    timeoutPerLevel: 5000,
+    skipLevels: [],
+    maxTotalTime: 30000,
+};
+//# sourceMappingURL=types.js.map

package/dist/edge/p2p/nat/types.js.map

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

package/dist/edge/p2p/protocol/AgentChannel.d.ts

@@ -0,0 +1,333 @@
+/**
+ * Agent Channel for High-Level Agent-to-Agent Communication
+ *
+ * Provides a high-level API for agent-to-agent communication including
+ * request/response patterns with correlation IDs, event subscription/publication,
+ * typed message handlers, channel lifecycle management, and metrics collection.
+ *
+ * @module edge/p2p/protocol/AgentChannel
+ * @version 1.0.0
+ */
+import type { KeyPair, AgentIdentity } from '../crypto';
+import type { PeerConnectionManager } from '../webrtc';
+import type { ChannelConfig, ChannelStats, MessageHandler, EventHandler, ErrorHandler, StateChangeHandler } from './types';
+import { ProtocolState, ProtocolFeature } from './types';
+/**
+ * Channel options for creation
+ */
+export interface AgentChannelOptions {
+    /** Local agent identity */
+    localIdentity: AgentIdentity;
+    /** Local key pair for signing */
+    localKeyPair: KeyPair;
+    /** Remote agent ID to connect to */
+    remoteAgentId: string;
+    /** Peer connection manager for WebRTC transport */
+    connectionManager?: PeerConnectionManager;
+    /** Channel configuration */
+    config?: Partial<ChannelConfig>;
+}
+/**
+ * Channel event types
+ */
+export declare enum ChannelEventType {
+    OPENED = "opened",
+    CLOSED = "closed",
+    ERROR = "error",
+    RECONNECTING = "reconnecting",
+    RECONNECTED = "reconnected",
+    MESSAGE_RECEIVED = "message_received",
+    MESSAGE_SENT = "message_sent",
+    STATE_CHANGED = "state_changed"
+}
+/**
+ * Channel event
+ */
+export interface ChannelEvent {
+    type: ChannelEventType;
+    timestamp: number;
+    details?: unknown;
+}
+/**
+ * Channel event handler
+ */
+export type ChannelEventHandler = (event: ChannelEvent) => void;
+/**
+ * High-level agent-to-agent communication channel
+ *
+ * @example
+ * ```typescript
+ * const channel = new AgentChannel({
+ *   localIdentity: myIdentity,
+ *   localKeyPair: myKeyPair,
+ *   remoteAgentId: 'remote-agent-id',
+ *   connectionManager: peerManager,
+ * });
+ *
+ * // Open channel
+ * await channel.open();
+ *
+ * // Register request handler
+ * channel.onRequest('get-data', async (params) => {
+ *   return { data: 'response' };
+ * });
+ *
+ * // Send request
+ * const result = await channel.request('process-task', { taskId: '123' });
+ *
+ * // Subscribe to events
+ * channel.subscribe('task-completed', (data) => {
+ *   console.log('Task completed:', data);
+ * });
+ *
+ * // Publish event
+ * await channel.publish('status-update', { status: 'active' });
+ *
+ * // Close channel
+ * await channel.close();
+ * ```
+ */
+export declare class AgentChannel {
+    private localIdentity;
+    private localKeyPair;
+    private remoteAgentId;
+    private connectionManager?;
+    private config;
+    private protocolHandler;
+    private encoder;
+    private router;
+    private isOpen;
+    private isClosing;
+    private reconnectAttempts;
+    private openedAt;
+    private pendingRequests;
+    private requestHandlers;
+    private eventSubscriptions;
+    private channelEventHandlers;
+    private errorHandlers;
+    private stateChangeHandlers;
+    private stats;
+    private reconnectTimer;
+    constructor(options: AgentChannelOptions);
+    /**
+     * Open the channel and establish connection
+     */
+    open(): Promise<void>;
+    /**
+     * Close the channel gracefully
+     */
+    close(reason?: string): Promise<void>;
+    /**
+     * Check if channel is open
+     */
+    isChannelOpen(): boolean;
+    /**
+     * Get channel state
+     */
+    getState(): ProtocolState;
+    /**
+     * Send a request and wait for response
+     *
+     * @param method - Method name to call
+     * @param params - Request parameters
+     * @param timeout - Optional timeout override
+     * @returns Promise resolving to response data
+     */
+    request<T = unknown, R = unknown>(method: string, params: T, timeout?: number): Promise<R>;
+    /**
+     * Register a request handler
+     */
+    onRequest<T = unknown, R = unknown>(method: string, handler: MessageHandler<T, R>): void;
+    /**
+     * Remove a request handler
+     */
+    offRequest(method: string): void;
+    /**
+     * Send a request (internal)
+     */
+    private sendRequest;
+    /**
+     * Handle incoming request
+     */
+    private handleRequest;
+    /**
+     * Handle incoming response
+     */
+    private handleResponse;
+    /**
+     * Subscribe to an event
+     *
+     * @param event - Event name to subscribe to
+     * @param handler - Event handler function
+     */
+    subscribe<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Subscribe to an event (one time)
+     */
+    subscribeOnce<T = unknown>(event: string, handler: EventHandler<T>): void;
+    /**
+     * Unsubscribe from an event
+     */
+    unsubscribe<T = unknown>(event: string, handler?: EventHandler<T>): void;
+    /**
+     * Publish an event
+     */
+    publish<T = unknown>(event: string, data: T, requiresAck?: boolean): Promise<void>;
+    /**
+     * Broadcast an event to all connected peers
+     */
+    broadcast<T = unknown>(event: string, data: T): Promise<void>;
+    /**
+     * Handle incoming event
+     */
+    private handleEvent;
+    /**
+     * Process incoming message data
+     */
+    processIncomingData(data: Uint8Array | string): Promise<void>;
+    /**
+     * Route incoming message to handler
+     */
+    private routeIncomingMessage;
+    /**
+     * Handle incoming handshake
+     */
+    private handleIncomingHandshake;
+    /**
+     * Handle handshake acknowledgment
+     */
+    private handleHandshakeAck;
+    /**
+     * Handle heartbeat
+     */
+    private handleHeartbeat;
+    /**
+     * Handle acknowledgment
+     */
+    private handleAck;
+    /**
+     * Handle negative acknowledgment
+     */
+    private handleNack;
+    /**
+     * Handle close message
+     */
+    private handleClose;
+    /**
+     * Handle error message
+     */
+    private handleErrorMessage;
+    /**
+     * Send an envelope over the channel
+     */
+    private sendEnvelope;
+    /**
+     * Send acknowledgment
+     */
+    private sendAck;
+    /**
+     * Register this channel with the router
+     */
+    private registerWithRouter;
+    /**
+     * Register error handler
+     */
+    onError(handler: ErrorHandler): void;
+    /**
+     * Remove error handler
+     */
+    offError(handler: ErrorHandler): void;
+    /**
+     * Handle error
+     */
+    private handleError;
+    /**
+     * Register state change handler
+     */
+    onStateChange(handler: StateChangeHandler): void;
+    /**
+     * Remove state change handler
+     */
+    offStateChange(handler: StateChangeHandler): void;
+    /**
+     * Schedule reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Attempt to reconnect
+     */
+    private attemptReconnect;
+    /**
+     * Get channel statistics
+     */
+    getStats(): ChannelStats;
+    /**
+     * Create initial stats object
+     */
+    private createInitialStats;
+    /**
+     * Update latency statistics
+     */
+    private updateLatencyStats;
+    /**
+     * Add channel event handler
+     */
+    on(handler: ChannelEventHandler): void;
+    /**
+     * Remove channel event handler
+     */
+    off(handler: ChannelEventHandler): void;
+    /**
+     * Emit channel event
+     */
+    private emitChannelEvent;
+    /**
+     * Setup event forwarding from protocol handler and router
+     */
+    private setupEventForwarding;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+    /**
+     * Destroy the channel and release all resources
+     */
+    destroy(): void;
+    /**
+     * Get local agent ID
+     */
+    getLocalAgentId(): string;
+    /**
+     * Get remote agent ID
+     */
+    getRemoteAgentId(): string;
+    /**
+     * Get session ID
+     */
+    getSessionId(): string | null;
+    /**
+     * Get agreed features
+     */
+    getAgreedFeatures(): ProtocolFeature[];
+    /**
+     * Check if a feature is enabled
+     */
+    hasFeature(feature: ProtocolFeature): boolean;
+    /**
+     * Get heartbeat latency
+     */
+    getHeartbeatLatency(): number | null;
+    /**
+     * Get rate limit status
+     */
+    getRateLimitStatus(): import("./types").RateLimitStatus;
+}
+/**
+ * Create a new agent channel
+ */
+export declare function createAgentChannel(options: AgentChannelOptions): AgentChannel;
+/**
+ * Create multiple channels for an agent
+ */
+export declare function createAgentChannels(localIdentity: AgentIdentity, localKeyPair: KeyPair, remoteAgentIds: string[], connectionManager?: PeerConnectionManager, config?: Partial<ChannelConfig>): Map<string, AgentChannel>;
+//# sourceMappingURL=AgentChannel.d.ts.map

package/dist/edge/p2p/protocol/AgentChannel.d.ts.map

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