@daniel.stefan/metalink 1.3.1

package/packages/core/dist/http-client.d.ts

@@ -0,0 +1,207 @@
+/**
+ * HTTP Client for MCP Streamable HTTP Protocol
+ *
+ * Implements MCP 2025-06-18 Streamable HTTP transport for communicating with
+ * remote HTTP-based MCP servers (e.g., Windmill, custom HTTP endpoints).
+ *
+ * Features:
+ * - Session management with Mcp-Session-Id header
+ * - SSE (Server-Sent Events) streaming support
+ * - HTTP-stream response batching
+ * - Authentication (Bearer, API-Key, OAuth2)
+ * - Automatic session resumption via Last-Event-ID
+ * - Request/response correlation with JSON-RPC IDs
+ * - Request concurrency limits (max 10 concurrent requests)
+ */
+import { EventEmitter } from 'events';
+import { HttpServerConfig } from './config/index.js';
+import { CircuitBreaker } from './server/circuit-breaker.js';
+export interface McpStreamableRequest {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+    id?: string | number | null;
+}
+export interface McpStreamableResponse {
+    jsonrpc: '2.0';
+    result?: unknown;
+    error?: McpError;
+    id?: string | number | null;
+}
+export interface McpError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+export interface ConnectionPoolConfig {
+    keepAlive?: boolean;
+    keepAliveMsecs?: number;
+    maxSockets?: number;
+    maxFreeSockets?: number;
+    timeout?: number;
+}
+export interface ConnectionPoolMetrics {
+    activeSockets: number;
+    freeSockets: number;
+    pendingRequests: number;
+    totalConnections: number;
+}
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    jitterMs: number;
+}
+interface HttpClientSession {
+    id: string;
+    createdAt: number;
+    lastEventId?: number;
+    lastActivity: number;
+}
+/**
+ * HTTP Client for remote MCP servers
+ * Handles Streamable HTTP protocol with session management and request concurrency limits
+ */
+export declare class HttpClient extends EventEmitter {
+    private config;
+    private session;
+    private pendingRequests;
+    private requestId;
+    private sseEventBuffer;
+    private isConnected;
+    private isConnecting;
+    private requestQueue;
+    private activeRequests;
+    private readonly MAX_CONCURRENT_REQUESTS;
+    private agent;
+    private poolMetrics;
+    private retryConfig;
+    private activeStreams;
+    private streamTimeouts;
+    private circuitBreaker?;
+    constructor(config: HttpServerConfig, circuitBreaker?: CircuitBreaker);
+    /**
+     * Initialize or restore session
+     */
+    private initializeSession;
+    /**
+     * Generate unique session ID (UUID v4)
+     */
+    private generateSessionId;
+    /**
+     * Initialize undici Agent with connection pooling
+     */
+    private initializeAgent;
+    /**
+     * Set retry configuration
+     */
+    setRetryConfig(config: Partial<RetryConfig>): void;
+    /**
+     * Check if an error or response is retryable
+     */
+    private isRetryable;
+    /**
+     * Calculate exponential backoff delay with jitter
+     */
+    private calculateBackoffDelay;
+    /**
+     * Sleep for specified duration
+     */
+    private sleep;
+    /**
+     * Execute function with concurrency limit
+     * Queues requests when at max concurrency, releases from queue on completion
+     *
+     * @param fn - Async function to execute
+     * @returns Promise resolving to function result
+     */
+    private executeWithConcurrencyLimit;
+    /**
+     * Process queued requests, executing them in FIFO order
+     */
+    private processQueue;
+    /**
+     * Build HTTP headers with auth and session info
+     */
+    private buildHeaders;
+    /**
+     * Resolve ${secret:name} syntax to actual values
+     * (In production, this would fetch from secure storage)
+     */
+    private resolveSecret;
+    /**
+     * Execute a tool via HTTP call with concurrency limit
+     */
+    call(method: string, params?: unknown): Promise<McpStreamableResponse>;
+    /**
+     * Send HTTP request to server with exponential backoff retry
+     * Includes automatic session reinitialize on 404 session errors (MCP spec compliance)
+     *
+     * @param request - The MCP request to send
+     * @param sessionReinitAttempted - Flag to prevent infinite reinitialize loops (max 1 per request)
+     */
+    private sendRequest;
+    /**
+     * Handle SSE (Server-Sent Events) streaming response
+     */
+    private handleSSEResponse;
+    /**
+     * Handle individual SSE event
+     */
+    private handleSSEEvent;
+    /**
+     * Handle HTTP-stream response (batch of JSON objects)
+     */
+    private handleStreamResponse;
+    /**
+     * Resolve pending request with response
+     */
+    private resolveRequest;
+    /**
+     * Connect to HTTP server
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from HTTP server
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Health check - ping the server
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Check if client is connected
+     */
+    getConnected(): boolean;
+    /**
+     * Get session info
+     */
+    getSession(): HttpClientSession | null;
+    /**
+     * Get concurrency metrics for monitoring
+     */
+    getConcurrencyMetrics(): {
+        activeRequests: number;
+        queuedRequests: number;
+        maxConcurrentRequests: number;
+    };
+    /**
+     * Collect connection pool metrics from agent
+     */
+    private collectPoolMetrics;
+    /**
+     * Get connection pool metrics
+     */
+    getPoolMetrics(): ConnectionPoolMetrics;
+}
+/**
+ * Factory for creating HTTP clients from config
+ * @param config - HTTP server configuration
+ * @param circuitBreaker - Optional circuit breaker for resilience
+ */
+export declare function createHttpClient(config: HttpServerConfig, circuitBreaker?: CircuitBreaker): HttpClient;
+export {};
+//# sourceMappingURL=http-client.d.ts.map

package/packages/core/dist/http-client.d.ts.map

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