@modelprofile.com/mcp-crossharness 5.0.0

package/dist_ts/classes.connectionregistry.js

@@ -0,0 +1,246 @@
+import * as plugins from './plugins.js';
+import { OpencodeConnection } from './classes.connection.opencode.js';
+import { CodexConnection } from './classes.connection.codex.js';
+export class ConnectionRegistry {
+    connections = new Map();
+    connecting = new Map();
+    closingConnections = new Map();
+    allowedServerUrls;
+    maxConnections;
+    openCodeCredentials;
+    closing = false;
+    closingTasks = new Map();
+    shutdownPromise;
+    constructor(optionsArg = {}) {
+        const configured = optionsArg.allowedServerUrls ??
+            (process.env.CROSSHARNESS_ALLOWED_SERVER_URLS ?? '')
+                .split(',')
+                .map((entry) => entry.trim())
+                .filter(Boolean);
+        this.allowedServerUrls = new Set(configured.map((entry) => this.normalizeUrl(entry).toString()));
+        this.maxConnections = optionsArg.maxConnections ?? 32;
+        if (!Number.isInteger(this.maxConnections) || this.maxConnections < 1) {
+            throw new Error('maxConnections must be a positive integer');
+        }
+        if (optionsArg.openCodeCredentials) {
+            const { serverUrl, username, password } = optionsArg.openCodeCredentials;
+            const credentialUrl = this.normalizeUrl(serverUrl);
+            if (serverUrl.length > 2048
+                || serverUrl.includes('?')
+                || serverUrl.includes('#')
+                || credentialUrl.username
+                || credentialUrl.password
+                || credentialUrl.search
+                || credentialUrl.hash
+                || credentialUrl.pathname !== '/'
+                || !['http:', 'https:'].includes(credentialUrl.protocol)
+                || !this.allowedServerUrls.has(credentialUrl.toString())
+                || (credentialUrl.protocol === 'http:'
+                    && !['127.0.0.1', '[::1]', '::1', 'localhost'].includes(credentialUrl.hostname))
+                || typeof password !== 'string'
+                || password.length === 0
+                || Buffer.byteLength(password, 'utf8') > 1024
+                || password.includes('\r')
+                || password.includes('\n')
+                || (username !== undefined && (typeof username !== 'string'
+                    || username.length === 0
+                    || Buffer.byteLength(username, 'utf8') > 1024
+                    || username.includes('\r')
+                    || username.includes('\n'))))
+                throw new Error('openCodeCredentials are invalid');
+            this.openCodeCredentials = {
+                serverUrl: credentialUrl.toString(),
+                password,
+                ...(username === undefined ? {} : { username }),
+            };
+        }
+    }
+    async connect(harnessArg, serverUrlArg, directoryArg, signalArg) {
+        if (signalArg?.aborted)
+            throw this.abortError(signalArg.reason);
+        if (this.closing) {
+            throw new Error('connection registry is closing');
+        }
+        if (harnessArg === 'claudecode') {
+            throw new Error('Claude Code 2.1.219 exposes no URL-addressable session server; connection-first Crossharness cannot connect to it');
+        }
+        if (!directoryArg.startsWith('/')) {
+            throw new Error('connection directory must be an absolute path on the harness server');
+        }
+        if (directoryArg.length > 4096) {
+            throw new Error('connection directory exceeds 4096 characters');
+        }
+        if (serverUrlArg.length > 2048) {
+            throw new Error('server URL exceeds 2048 characters');
+        }
+        const url = this.validateAllowedUrl(harnessArg, serverUrlArg);
+        if (this.connections.size + this.connecting.size + this.closingConnections.size >=
+            this.maxConnections) {
+            throw new Error(`connection registry is full (maximum ${this.maxConnections})`);
+        }
+        const duplicate = [
+            ...this.connections.values(),
+            ...this.connecting.values(),
+            ...this.closingConnections.values(),
+        ].find((connection) => connection.harness === harnessArg &&
+            connection.serverUrl === url.toString() &&
+            connection.directory === directoryArg);
+        if (duplicate) {
+            throw new Error(`a ${harnessArg} connection already exists for ${url.toString()} and ${directoryArg}`);
+        }
+        const connectionId = `c-${plugins.crypto.randomBytes(8).toString('hex')}`;
+        const markClosingConnection = () => {
+            this.connections.delete(connectionId);
+            this.connecting.delete(connectionId);
+            this.closingConnections.set(connectionId, connection);
+        };
+        const removeClosedConnection = () => {
+            this.connections.delete(connectionId);
+            this.connecting.delete(connectionId);
+            this.closingConnections.delete(connectionId);
+        };
+        const connection = harnessArg === 'opencode'
+            ? new OpencodeConnection(connectionId, url.toString(), directoryArg, markClosingConnection, removeClosedConnection, this.openCodeCredentials?.serverUrl === url.toString()
+                ? this.openCodeCredentials
+                : undefined)
+            : new CodexConnection(connectionId, url.toString(), directoryArg, markClosingConnection, removeClosedConnection);
+        this.connecting.set(connectionId, connection);
+        let abortCleanupTask;
+        const abortHandler = signalArg
+            ? () => {
+                abortCleanupTask ??= this.closeConnection(connection, this.abortError(signalArg.reason).message);
+                void abortCleanupTask.catch(() => undefined);
+            }
+            : undefined;
+        if (abortHandler)
+            signalArg.addEventListener('abort', abortHandler, { once: true });
+        try {
+            await connection.connect();
+            if (signalArg?.aborted)
+                throw this.abortError(signalArg.reason);
+            if (this.closing) {
+                throw new Error('connection registry closed during setup');
+            }
+            this.connections.set(connectionId, connection);
+            return connection.getInfo();
+        }
+        catch (errorArg) {
+            const operationError = signalArg?.aborted ? this.abortError(signalArg.reason) : errorArg;
+            try {
+                await (abortCleanupTask ?? this.closeConnection(connection, 'connection setup failed'));
+            }
+            catch (cleanupErrorArg) {
+                throw new AggregateError([operationError, cleanupErrorArg], 'Connection setup failed and cleanup is incomplete.');
+            }
+            throw operationError;
+        }
+        finally {
+            if (abortHandler)
+                signalArg.removeEventListener('abort', abortHandler);
+            this.connecting.delete(connectionId);
+        }
+    }
+    get(connectionIdArg) {
+        const connection = this.connections.get(connectionIdArg);
+        if (!connection) {
+            throw new Error(`unknown connectionId ${connectionIdArg}`);
+        }
+        return connection;
+    }
+    list() {
+        return [...this.connections.values()].map((connection) => connection.getInfo());
+    }
+    async disconnect(connectionIdArg) {
+        const connection = this.connections.get(connectionIdArg)
+            ?? this.closingConnections.get(connectionIdArg);
+        if (!connection)
+            throw new Error(`unknown connectionId ${connectionIdArg}`);
+        await this.closeConnection(connection, 'connection explicitly disconnected');
+        return connection.getInfo();
+    }
+    async closeAll() {
+        if (this.shutdownPromise)
+            return this.shutdownPromise;
+        this.closing = true;
+        const connections = [
+            ...new Set([
+                ...this.connections.values(),
+                ...this.connecting.values(),
+                ...this.closingConnections.values(),
+            ]),
+        ];
+        const shutdownPromise = Promise.allSettled(connections.map((connection) => this.closeConnection(connection, 'Crossharness MCP transport closed'))).then((results) => {
+            const errors = results.flatMap((result) => (result.status === 'rejected' ? [result.reason] : []));
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1) {
+                throw new AggregateError(errors, 'Closing Crossharness connections failed.');
+            }
+        });
+        this.shutdownPromise = shutdownPromise;
+        try {
+            await shutdownPromise;
+        }
+        finally {
+            if (this.shutdownPromise === shutdownPromise)
+                this.shutdownPromise = undefined;
+        }
+    }
+    closeConnection(connectionArg, reasonArg) {
+        const connectionId = connectionArg.connectionId;
+        const existing = this.closingTasks.get(connectionId);
+        if (existing)
+            return existing;
+        this.connections.delete(connectionId);
+        this.connecting.delete(connectionId);
+        this.closingConnections.set(connectionId, connectionArg);
+        let task;
+        task = Promise.resolve().then(() => connectionArg.close(reasonArg)).then(() => {
+            if (this.closingConnections.get(connectionId) === connectionArg) {
+                this.closingConnections.delete(connectionId);
+            }
+        }, (errorArg) => {
+            this.connections.delete(connectionId);
+            this.connecting.delete(connectionId);
+            this.closingConnections.set(connectionId, connectionArg);
+            throw errorArg;
+        }).finally(() => {
+            if (this.closingTasks.get(connectionId) === task)
+                this.closingTasks.delete(connectionId);
+        });
+        this.closingTasks.set(connectionId, task);
+        return task;
+    }
+    validateAllowedUrl(harnessArg, valueArg) {
+        const url = this.normalizeUrl(valueArg);
+        if (url.username || url.password || url.search || url.hash) {
+            throw new Error('server URL must not contain credentials, query parameters, or a fragment');
+        }
+        if (url.pathname !== '/') {
+            throw new Error('server URL must be an origin with no path');
+        }
+        const protocols = harnessArg === 'opencode' ? ['http:', 'https:'] : ['ws:', 'wss:'];
+        if (!protocols.includes(url.protocol)) {
+            throw new Error(`${harnessArg} server URL must use ${protocols.join(' or ')}`);
+        }
+        if (!this.allowedServerUrls.has(url.toString())) {
+            throw new Error(`server URL ${url.toString()} is not in CROSSHARNESS_ALLOWED_SERVER_URLS`);
+        }
+        return url;
+    }
+    normalizeUrl(valueArg) {
+        let url;
+        try {
+            url = new URL(valueArg);
+        }
+        catch {
+            throw new Error(`invalid server URL: ${valueArg}`);
+        }
+        url.pathname = url.pathname || '/';
+        return url;
+    }
+    abortError(reasonArg) {
+        return reasonArg instanceof Error ? reasonArg : new Error('connection cancelled');
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5jb25uZWN0aW9ucmVnaXN0cnkuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9jbGFzc2VzLmNvbm5lY3Rpb25yZWdpc3RyeS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGNBQWMsQ0FBQztBQUN4QyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsTUFBTSxrQ0FBa0MsQ0FBQztBQUN0RSxPQUFPLEVBQUUsZUFBZSxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFlaEUsTUFBTSxPQUFPLGtCQUFrQjtJQUNyQixXQUFXLEdBQUcsSUFBSSxHQUFHLEVBQXlDLENBQUM7SUFDL0QsVUFBVSxHQUFHLElBQUksR0FBRyxFQUF5QyxDQUFDO0lBQzlELGtCQUFrQixHQUFHLElBQUksR0FBRyxFQUF5QyxDQUFDO0lBQ3RFLGlCQUFpQixDQUFjO0lBQy9CLGNBQWMsQ0FBUztJQUN2QixtQkFBbUIsQ0FBbUM7SUFDdEQsT0FBTyxHQUFHLEtBQUssQ0FBQztJQUNoQixZQUFZLEdBQUcsSUFBSSxHQUFHLEVBQXlCLENBQUM7SUFDaEQsZUFBZSxDQUE0QjtJQUVuRCxZQUFZLGFBQXlDLEVBQUU7UUFDckQsTUFBTSxVQUFVLEdBQ2QsVUFBVSxDQUFDLGlCQUFpQjtZQUM1QixDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsZ0NBQWdDLElBQUksRUFBRSxDQUFDO2lCQUNqRCxLQUFLLENBQUMsR0FBRyxDQUFDO2lCQUNWLEdBQUcsQ0FBQyxDQUFDLEtBQUssRUFBRSxFQUFFLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxDQUFDO2lCQUM1QixNQUFNLENBQUMsT0FBTyxDQUFDLENBQUM7UUFDckIsSUFBSSxDQUFDLGlCQUFpQixHQUFHLElBQUksR0FBRyxDQUFDLFVBQVUsQ0FBQyxHQUFHLENBQUMsQ0FBQyxLQUFLLEVBQUUsRUFBRSxDQUFDLElBQUksQ0FBQyxZQUFZLENBQUMsS0FBSyxDQUFDLENBQUMsUUFBUSxF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

package/dist_ts/classes.dispatchregistry.d.ts

@@ -0,0 +1,39 @@
+import type * as interfaces from './interfaces.js';
+export type TDispatchStatus = 'working' | 'completed' | 'failed';
+export interface IDispatchRecord {
+    dispatchId: string;
+    connectionId: string;
+    harness: interfaces.THarnessName;
+    chatId: string;
+    startedAt: string;
+    completedAt?: string;
+    status: TDispatchStatus;
+    reply?: string;
+    via?: string;
+    error?: string;
+}
+export interface IDispatchRegistryOptions {
+    maxRecords?: number;
+    completedTtlMs?: number;
+}
+export declare class DispatchRegistry {
+    private options;
+    private records;
+    private expiryTimers;
+    private waiters;
+    private waiterCount;
+    private counter;
+    private instancePrefix;
+    private disposed;
+    constructor(options?: IDispatchRegistryOptions);
+    track(connectionIdArg: string, harnessArg: interfaces.THarnessName, chatIdArg: string, sendFactoryArg: () => Promise<interfaces.ISendResult>): IDispatchRecord;
+    get(connectionIdArg: string, dispatchIdArg: string): IDispatchRecord | undefined;
+    waitFor(connectionIdArg: string, dispatchIdArg: string, waitMsArg: number, signalArg?: AbortSignal): Promise<IDispatchRecord | undefined>;
+    dispose(): void;
+    private prune;
+    private scheduleExpiry;
+    private reserveCapacity;
+    private forget;
+    private notifyWaiters;
+    private removeWaiter;
+}

package/dist_ts/classes.dispatchregistry.js

@@ -0,0 +1,177 @@
+export class DispatchRegistry {
+    options;
+    records = new Map();
+    expiryTimers = new Map();
+    waiters = new Map();
+    waiterCount = 0;
+    counter = 0;
+    instancePrefix = Math.random().toString(36).slice(2, 7);
+    disposed = false;
+    constructor(options = {}) {
+        this.options = options;
+        if (!Number.isInteger(options.maxRecords ?? 100) || (options.maxRecords ?? 100) < 1) {
+            throw new Error('dispatch maxRecords must be a positive integer');
+        }
+        if ((options.completedTtlMs ?? 2 * 60 * 60 * 1000) < 0) {
+            throw new Error('dispatch completedTtlMs must not be negative');
+        }
+    }
+    track(connectionIdArg, harnessArg, chatIdArg, sendFactoryArg) {
+        if (this.disposed)
+            throw new Error('dispatch registry is closed');
+        this.reserveCapacity();
+        const record = {
+            dispatchId: `d-${this.instancePrefix}-${++this.counter}`,
+            connectionId: connectionIdArg,
+            harness: harnessArg,
+            chatId: chatIdArg,
+            startedAt: new Date().toISOString(),
+            status: 'working',
+        };
+        this.records.set(record.dispatchId, record);
+        Promise.resolve().then(sendFactoryArg).then((result) => {
+            if (this.disposed || record.status !== 'working')
+                return;
+            record.status = 'completed';
+            record.completedAt = new Date().toISOString();
+            record.reply = result.reply.slice(0, 100000);
+            record.via = result.via;
+            this.notifyWaiters(record.dispatchId, record);
+            this.scheduleExpiry(record.dispatchId);
+            this.prune();
+        }, (error) => {
+            if (this.disposed || record.status !== 'working')
+                return;
+            record.status = 'failed';
+            record.completedAt = new Date().toISOString();
+            record.error = (error instanceof Error ? error.message : String(error)).slice(0, 4000);
+            this.notifyWaiters(record.dispatchId, record);
+            this.scheduleExpiry(record.dispatchId);
+            this.prune();
+        });
+        return record;
+    }
+    get(connectionIdArg, dispatchIdArg) {
+        this.prune();
+        const record = this.records.get(dispatchIdArg);
+        return record?.connectionId === connectionIdArg ? record : undefined;
+    }
+    async waitFor(connectionIdArg, dispatchIdArg, waitMsArg, signalArg) {
+        const deadline = Date.now() + waitMsArg;
+        const record = this.get(connectionIdArg, dispatchIdArg);
+        if (!record || record.status !== 'working' || waitMsArg <= 0)
+            return record;
+        if (signalArg?.aborted)
+            return record;
+        if (this.waiterCount >= 1000)
+            return record;
+        return new Promise((resolve) => {
+            const waiter = {
+                resolve,
+                timer: setTimeout(() => {
+                    this.removeWaiter(dispatchIdArg, waiter);
+                    resolve(this.get(connectionIdArg, dispatchIdArg));
+                }, Math.max(0, deadline - Date.now())),
+                signal: signalArg,
+            };
+            if (signalArg) {
+                waiter.abortHandler = () => {
+                    this.removeWaiter(dispatchIdArg, waiter);
+                    resolve(this.get(connectionIdArg, dispatchIdArg));
+                };
+                signalArg.addEventListener('abort', waiter.abortHandler, { once: true });
+            }
+            const dispatchWaiters = this.waiters.get(dispatchIdArg) ?? new Set();
+            dispatchWaiters.add(waiter);
+            this.waiterCount++;
+            this.waiters.set(dispatchIdArg, dispatchWaiters);
+            const current = this.get(connectionIdArg, dispatchIdArg);
+            if (!current || current.status !== 'working') {
+                this.notifyWaiters(dispatchIdArg, current);
+            }
+        });
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        for (const timer of this.expiryTimers.values())
+            clearTimeout(timer);
+        this.expiryTimers.clear();
+        for (const dispatchId of [...this.waiters.keys()]) {
+            this.notifyWaiters(dispatchId, undefined);
+        }
+        this.records.clear();
+    }
+    prune() {
+        const completedTtlMs = this.options.completedTtlMs ?? 2 * 60 * 60 * 1000;
+        const now = Date.now();
+        for (const [dispatchId, record] of this.records) {
+            if (record.status !== 'working' &&
+                record.completedAt &&
+                now - Date.parse(record.completedAt) > completedTtlMs) {
+                this.forget(dispatchId);
+            }
+        }
+    }
+    scheduleExpiry(dispatchIdArg) {
+        const existingTimer = this.expiryTimers.get(dispatchIdArg);
+        if (existingTimer)
+            clearTimeout(existingTimer);
+        const timer = setTimeout(() => {
+            this.expiryTimers.delete(dispatchIdArg);
+            this.records.delete(dispatchIdArg);
+        }, this.options.completedTtlMs ?? 2 * 60 * 60 * 1000);
+        this.expiryTimers.set(dispatchIdArg, timer);
+        timer.unref();
+    }
+    reserveCapacity() {
+        this.prune();
+        const maxRecords = this.options.maxRecords ?? 100;
+        for (const [dispatchId, record] of this.records) {
+            if (this.records.size < maxRecords)
+                break;
+            if (record.status !== 'working')
+                this.forget(dispatchId);
+        }
+        if (this.records.size >= maxRecords) {
+            throw new Error('dispatch registry is full of active sends');
+        }
+    }
+    forget(dispatchIdArg) {
+        this.records.delete(dispatchIdArg);
+        const timer = this.expiryTimers.get(dispatchIdArg);
+        if (timer)
+            clearTimeout(timer);
+        this.expiryTimers.delete(dispatchIdArg);
+        this.notifyWaiters(dispatchIdArg, undefined);
+    }
+    notifyWaiters(dispatchIdArg, recordArg) {
+        const dispatchWaiters = this.waiters.get(dispatchIdArg);
+        if (!dispatchWaiters)
+            return;
+        this.waiters.delete(dispatchIdArg);
+        this.waiterCount -= dispatchWaiters.size;
+        for (const waiter of dispatchWaiters) {
+            clearTimeout(waiter.timer);
+            if (waiter.abortHandler)
+                waiter.signal?.removeEventListener('abort', waiter.abortHandler);
+            waiter.resolve(recordArg);
+        }
+    }
+    removeWaiter(dispatchIdArg, waiterArg) {
+        const dispatchWaiters = this.waiters.get(dispatchIdArg);
+        if (!dispatchWaiters)
+            return;
+        if (dispatchWaiters.delete(waiterArg)) {
+            this.waiterCount--;
+            clearTimeout(waiterArg.timer);
+            if (waiterArg.abortHandler) {
+                waiterArg.signal?.removeEventListener('abort', waiterArg.abortHandler);
+            }
+        }
+        if (dispatchWaiters.size === 0)
+            this.waiters.delete(dispatchIdArg);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kaXNwYXRjaHJlZ2lzdHJ5LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvY2xhc3Nlcy5kaXNwYXRjaHJlZ2lzdHJ5LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQTZCQSxNQUFNLE9BQU8sZ0JBQWdCO0lBU1A7SUFSWixPQUFPLEdBQUcsSUFBSSxHQUFHLEVBQTJCLENBQUM7SUFDN0MsWUFBWSxHQUFHLElBQUksR0FBRyxFQUF5QyxDQUFDO0lBQ2hFLE9BQU8sR0FBRyxJQUFJLEdBQUcsRUFBZ0MsQ0FBQztJQUNsRCxXQUFXLEdBQUcsQ0FBQyxDQUFDO0lBQ2hCLE9BQU8sR0FBRyxDQUFDLENBQUM7SUFDWixjQUFjLEdBQUcsSUFBSSxDQUFDLE1BQU0sRUFBRSxDQUFDLFFBQVEsQ0FBQyxFQUFFLENBQUMsQ0FBQyxLQUFLLENBQUMsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ3hELFFBQVEsR0FBRyxLQUFLLENBQUM7SUFFekIsWUFBb0IsVUFBb0MsRUFBRTtRQUF0QyxZQUFPLEdBQVAsT0FBTyxDQUErQjtRQUN4RCxJQUFJLENBQUMsTUFBTSxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsVUFBVSxJQUFJLEdBQUcsQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLFVBQVUsSUFBSSxHQUFHLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUNwRixNQUFNLElBQUksS0FBSyxDQUFDLGdEQUFnRCxDQUFDLENBQUM7UUFDcEUsQ0FBQztRQUNELElBQUksQ0FBQyxPQUFPLENBQUMsY0FBYyxJQUFJLENBQUMsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ3ZELE1BQU0sSUFBSSxLQUFLLENBQUMsOENBQThDLENBQUMsQ0FBQztRQUNsRSxDQUFDO0lBQ0gsQ0FBQztJQUVNLEtBQUssQ0FDVixlQUF1QixFQUN2QixVQUFtQyxFQUNuQyxTQUFpQixFQUNqQixjQUFxRDtR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

package/dist_ts/classes.mcpserver.d.ts

@@ -0,0 +1,21 @@
+import * as plugins from './plugins.js';
+import { ConnectionRegistry } from './classes.connectionregistry.js';
+import { DispatchRegistry } from './classes.dispatchregistry.js';
+export declare class CrossHarnessMcpServer {
+    readonly connections: ConnectionRegistry;
+    readonly dispatches: DispatchRegistry;
+    private activeServer;
+    private stdinEndHandler;
+    private stdinEndSource;
+    private closePromise;
+    private resourceShutdownPromise;
+    private startCalled;
+    constructor(connectionsArg?: ConnectionRegistry, dispatchesArg?: DispatchRegistry);
+    start(transportArg?: plugins.Transport, stdinArg?: NodeJS.ReadableStream): Promise<void>;
+    close(): Promise<void>;
+    private triggerClose;
+    private ensureResourceShutdown;
+    private clearTransportReferences;
+    private describeConnection;
+    private wrapToolCall;
+}