@1mcp/agent 0.37.0 → 0.38.0

package/build/sdk/legacy/client/runtime/clientManager.d.ts

@@ -0,0 +1,94 @@
+import { EventEmitter } from 'node:events';
+import { InstructionAggregator } from '../../../../core/instructions/instructionAggregator.js';
+import { type BackendSupervisionSnapshot } from '../../../../core/server/backendStdioSupervisor.js';
+import { OperationOptions, OutboundConnections, ServerCapability } from '../../../../core/types/index.js';
+import type { Client } from '../../../../sdk/legacy/client/index.js';
+import { type LegacyOutboundConnection } from './legacyOutboundConnection.js';
+import type { AuthProviderTransport } from './legacyTransport.js';
+import { OAuthRequiredError } from './types.js';
+export { OAuthRequiredError };
+export declare const enum ClientManagerEvent {
+    BackendSupervisionStateChanged = "backend-supervision-state-changed"
+}
+export declare class ClientManager extends EventEmitter {
+    private static instance;
+    private outboundConns;
+    private transports;
+    private connectionSemaphore;
+    private bulkConnectionOperations;
+    private sessionLossRecoveries;
+    private instructionAggregator?;
+    private clientFactory;
+    private connectionHandler;
+    private oauthFlowHandler;
+    private transportRecreator;
+    private backendSupervisors;
+    private backendAvailabilityHandler?;
+    private isShuttingDown;
+    private shutdownPromise?;
+    private constructor();
+    static getOrCreateInstance(): ClientManager;
+    static get current(): ClientManager;
+    static resetInstance(): void;
+    static shutdownCurrent(): Promise<void>;
+    setInstructionAggregator(aggregator: InstructionAggregator): void;
+    setBackendAvailabilityHandler(handler: (name: string, snapshot: BackendSupervisionSnapshot) => void | Promise<void>): void;
+    private extractAndCacheInstructions;
+    private setupConnectionHandlers;
+    /**
+     * Reconnects a backend whose Streamable HTTP / SSE session was invalidated
+     * server-side (typically because the backend process restarted and lost its
+     * in-memory session store). Without this, the client keeps reusing the dead
+     * session ID on every subsequent request and the backend never recovers
+     * until the whole 1MCP process is restarted.
+     */
+    private recoverFromSessionLoss;
+    /**
+     * Create multiple MCP clients in parallel with controlled concurrency
+     *
+     * @remarks Uses ParallelExecutor to create clients concurrently with a maximum
+     * of DEFAULT_MAX_CONCURRENT_LOADS (5) simultaneous connections. Individual
+     * client creation failures are captured in the OutboundConnections map with
+     * appropriate error status, allowing other clients to continue loading.
+     *
+     * Error handling details:
+     * - OAuthRequiredError: Client status set to AwaitingOAuth
+     * - Other errors: Client status set to Error with lastError populated
+     *
+     * @param transports - Map of server names to their transport configurations
+     * @returns Map of all attempted connections (successful, failed, and awaiting OAuth)
+     */
+    createClients(transports: Record<string, AuthProviderTransport>): Promise<OutboundConnections>;
+    private createClient;
+    private handleClientCreationError;
+    getClient(clientName: string): LegacyOutboundConnection;
+    getClients(): OutboundConnections;
+    createSingleClient(name: string, transport: AuthProviderTransport, abortSignal?: AbortSignal): Promise<void>;
+    private createSingleClientInternal;
+    private prepareTransportForAttempt;
+    private recordConnectedClient;
+    private disposeSupersededConnection;
+    private handleSingleClientError;
+    initializeClientsAsync(transports: Record<string, AuthProviderTransport>): OutboundConnections;
+    getTransport(name: string): AuthProviderTransport | undefined;
+    getTransportNames(): string[];
+    completeOAuthAndReconnect(serverName: string, authorizationCode: string | URLSearchParams): Promise<void>;
+    executeClientOperation<T>(clientName: string, operation: (clientInfo: LegacyOutboundConnection) => Promise<T>, options?: OperationOptions, requiredCapability?: ServerCapability): Promise<T>;
+    createClientInstance(): Client;
+    initiateOAuth(serverName: string): Promise<void>;
+    createPooledClientInstance(): Client;
+    removeClient(name: string): Promise<void>;
+    restartBackend(name: string): Promise<BackendSupervisionSnapshot>;
+    getBackendSupervision(name: string): BackendSupervisionSnapshot | undefined;
+    publishBackendSupervisionState(name: string, snapshot: BackendSupervisionSnapshot): void;
+    shutdown(): Promise<void>;
+    private performShutdown;
+    private getOrCreateBackendSupervisor;
+    private recoverSupervisedBackend;
+    private applyBackendSupervisionState;
+    private getTransportPid;
+    private assertActive;
+    private disposeConnectedClient;
+}
+export default ClientManager;
+//# sourceMappingURL=clientManager.d.ts.map

package/build/sdk/legacy/client/runtime/clientManager.d.ts.map

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