@olane/o-node 0.7.53 → 0.7.55

package/dist/src/connection/interfaces/o-node-connection.config.d.ts

@@ -1,8 +1,9 @@
-import { Connection } from '@olane/o-config';
+import { Connection, Libp2p } from '@olane/o-config';
 import { oConnectionConfig } from '@olane/o-core';
 import type { StreamReusePolicy } from '../stream-handler.config.js';
 export interface oNodeConnectionConfig extends oConnectionConfig {
     p2pConnection: Connection;
+    p2pNode?: Libp2p;
     runOnLimitedConnection?: boolean;
     reusePolicy?: StreamReusePolicy;
 }

package/dist/src/connection/interfaces/o-node-connection.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node-connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/o-node-connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,aAAa,EAAE,UAAU,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}
+{"version":3,"file":"o-node-connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/o-node-connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,aAAa,EAAE,UAAU,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,WAAW,CAAC,EAAE,iBAAiB,CAAC;CACjC"}

package/dist/src/connection/interfaces/stream-init-message.d.ts

@@ -1,6 +1,6 @@
 /**
- * Message sent by limited connection clients to identify their dedicated reader stream
- * This allows the receiver to identify which stream to use for sending requests back to the caller
+ * Message sent by limited connection clients to identify their dedicated persistent streams
+ * This allows the receiver to identify which streams to use for bidirectional communication
  */
 export interface StreamInitMessage {
     /**
@@ -9,10 +9,11 @@ export interface StreamInitMessage {
     type: 'stream-init';
     /**
      * Role of this stream
-     * - 'reader': Dedicated reader stream for receiving requests
+     * - 'reader': Dedicated reader stream for receiving requests from receiver
+     * - 'writer': Dedicated writer stream for sending responses back to receiver
      * - 'standard': Standard request-response stream
      */
-    role: 'reader' | 'standard';
+    role: 'reader' | 'writer' | 'standard';
     /**
      * Timestamp when the stream was created
      */
@@ -26,4 +27,38 @@ export interface StreamInitMessage {
  * Type guard to check if a message is a StreamInitMessage
  */
 export declare function isStreamInitMessage(message: any): message is StreamInitMessage;
+/**
+ * Acknowledgment message sent by receiver in response to stream-init
+ * This confirms that the receiver has processed and registered the stream
+ */
+export interface StreamInitAckMessage {
+    /**
+     * Message type identifier
+     */
+    type: 'stream-init-ack';
+    /**
+     * Status of the initialization
+     */
+    status: 'success' | 'error';
+    /**
+     * The stream ID that was registered
+     */
+    streamId: string;
+    /**
+     * The role that was registered
+     */
+    role: 'reader' | 'writer' | 'standard';
+    /**
+     * Optional error message if status is 'error'
+     */
+    error?: string;
+    /**
+     * Timestamp when the ack was sent
+     */
+    timestamp: number;
+}
+/**
+ * Type guard to check if a message is a StreamInitAckMessage
+ */
+export declare function isStreamInitAckMessage(message: any): message is StreamInitAckMessage;
 //# sourceMappingURL=stream-init-message.d.ts.map

package/dist/src/connection/interfaces/stream-init-message.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-init-message.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/stream-init-message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;OAIG;IACH,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,iBAAiB,CAM9E"}
+{"version":3,"file":"stream-init-message.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/stream-init-message.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,IAAI,EAAE,aAAa,CAAC;IAEpB;;;;;OAKG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,IAAI,iBAAiB,CAM9E;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,IAAI,EAAE,iBAAiB,CAAC;IAExB;;OAEG;IACH,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;IAEvC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,GAAG,GACX,OAAO,IAAI,oBAAoB,CAQjC"}

package/dist/src/connection/interfaces/stream-init-message.js

@@ -3,6 +3,16 @@
  */
 export function isStreamInitMessage(message) {
     return (message?.type === 'stream-init' &&
-        (message.role === 'reader' || message.role === 'standard') &&
+        (message.role === 'reader' || message.role === 'writer' || message.role === 'standard') &&
+        typeof message.timestamp === 'number');
+}
+/**
+ * Type guard to check if a message is a StreamInitAckMessage
+ */
+export function isStreamInitAckMessage(message) {
+    return (message?.type === 'stream-init-ack' &&
+        (message.status === 'success' || message.status === 'error') &&
+        typeof message.streamId === 'string' &&
+        (message.role === 'reader' || message.role === 'writer' || message.role === 'standard') &&
         typeof message.timestamp === 'number');
 }

package/dist/src/connection/o-node-connection.d.ts

@@ -1,27 +1,73 @@
-import { Connection } from '@olane/o-config';
-import { oConnection, oRequest, oResponse } from '@olane/o-core';
+import { Connection, Libp2p, Multiaddr } from '@olane/o-config';
+import { oAddress, oConnection, oRequest, oResponse } from '@olane/o-core';
 import { oNodeConnectionConfig } from './interfaces/o-node-connection.config.js';
 import type { StreamReusePolicy } from './stream-handler.config.js';
 import { oNodeAddress } from '../router/o-node.address.js';
 import { oNodeStream } from './o-node-stream.js';
 import { oNodeStreamManager } from './o-node-stream.manager.js';
+interface CachedIdentifyData {
+    protocols: string[];
+    agentVersion?: string;
+    protocolVersion?: string;
+    listenAddrs: Multiaddr[];
+    observedAddr?: Multiaddr;
+    timestamp: number;
+}
 export declare class oNodeConnection extends oConnection {
     protected readonly config: oNodeConnectionConfig;
     p2pConnection: Connection;
     protected reusePolicy: StreamReusePolicy;
     streamManager: oNodeStreamManager;
+    protected p2pNode?: Libp2p;
+    protected identifyData?: CachedIdentifyData;
+    protected identifyListener?: (evt: any) => void;
     constructor(config: oNodeConnectionConfig);
     get remotePeerId(): import("@olane/o-config").PeerId;
-    get remoteAddr(): import("@olane/o-config").Multiaddr;
+    get remoteAddr(): Multiaddr;
     /**
      * Get the connection configuration for compatibility checking.
      */
     get connectionConfig(): oNodeConnectionConfig;
     supportsAddress(address: oNodeAddress): boolean;
     get streams(): oNodeStream[];
+    /**
+     * Get cached identify data for the remote peer.
+     * Returns undefined if identify event hasn't been received yet.
+     */
+    get cachedIdentifyData(): CachedIdentifyData | undefined;
+    /**
+     * Get protocols supported by the remote peer from cached identify data.
+     * Returns empty array if identify data not available yet.
+     */
+    get remoteProtocols(): string[];
+    /**
+     * Get agent version of the remote peer from cached identify data.
+     */
+    get remoteAgentVersion(): string | undefined;
+    /**
+     * Get protocol version of the remote peer from cached identify data.
+     */
+    get remoteProtocolVersion(): string | undefined;
+    /**
+     * Get listen addresses advertised by the remote peer.
+     * Returns empty array if identify data not available yet.
+     */
+    get remoteListenAddrs(): Multiaddr[];
+    /**
+     * Get our observed address as seen by the remote peer.
+     */
+    get observedAddress(): Multiaddr | undefined;
+    get address(): oAddress;
+    get nextHopAddress(): oAddress;
+    get callerAddress(): oAddress | undefined;
     transmit(request: oRequest): Promise<oResponse>;
     postTransmit(stream: oNodeStream): Promise<void>;
+    /**
+     * Set up persistent listener for identify events from the remote peer
+     */
+    protected setupIdentifyListener(): void;
     abort(error: Error): Promise<void>;
     close(): Promise<void>;
 }
+export {};
 //# sourceMappingURL=o-node-connection.d.ts.map

package/dist/src/connection/o-node-connection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAU,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAEL,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,qBAAa,eAAgB,SAAQ,WAAW;IAKlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAJrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAClC,aAAa,EAAE,kBAAkB,CAAC;gBAEV,MAAM,EAAE,qBAAqB;IAW5D,IAAI,YAAY,qCAEf;IAED,IAAI,UAAU,wCAEb;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,qBAAqB,CAE5C;IAED,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAM/C,IAAI,OAAO,IAAI,WAAW,EAAE,CAE3B;IAEK,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA2D/C,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhD,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CASZ"}
+{"version":3,"file":"o-node-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAU,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAEL,QAAQ,EACR,WAAW,EAGX,QAAQ,EACR,SAAS,EACV,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,SAAS,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,eAAgB,SAAQ,WAAW;IAQlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAPrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAClC,aAAa,EAAE,kBAAkB,CAAC;IACzC,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,YAAY,CAAC,EAAE,kBAAkB,CAAC;IAC5C,SAAS,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;gBAEjB,MAAM,EAAE,qBAAqB;IAe5D,IAAI,YAAY,qCAEf;IAED,IAAI,UAAU,cAEb;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,qBAAqB,CAE5C;IAED,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAM/C,IAAI,OAAO,IAAI,WAAW,EAAE,CAE3B;IAED;;;OAGG;IACH,IAAI,kBAAkB,IAAI,kBAAkB,GAAG,SAAS,CAEvD;IAED;;;OAGG;IACH,IAAI,eAAe,IAAI,MAAM,EAAE,CAE9B;IAED;;OAEG;IACH,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED;;OAEG;IACH,IAAI,qBAAqB,IAAI,MAAM,GAAG,SAAS,CAE9C;IAED;;;OAGG;IACH,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAEnC;IAED;;OAEG;IACH,IAAI,eAAe,IAAI,SAAS,GAAG,SAAS,CAE3C;IAED,IAAI,OAAO,IAAI,QAAQ,CActB;IAED,IAAI,cAAc,IAAI,QAAQ,CAK7B;IAED,IAAI,aAAa,IAAI,QAAQ,GAAG,SAAS,CAMxC;IAEK,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAkF/C,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD;;OAEG;IACH,SAAS,CAAC,qBAAqB,IAAI,IAAI;IAsCjC,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CAcZ"}

package/dist/src/connection/o-node-connection.js

@@ -1,4 +1,5 @@
 import { oConnection, oError, oErrorCodes, } from '@olane/o-core';
+import { oNodeAddress } from '../router/o-node.address.js';
 import { oNodeStreamManager } from './o-node-stream.manager.js';
 export class oNodeConnection extends oConnection {
     constructor(config) {
@@ -6,10 +7,13 @@ export class oNodeConnection extends oConnection {
         this.config = config;
         this.p2pConnection = config.p2pConnection;
         this.reusePolicy = config.reusePolicy ?? 'none';
+        this.p2pNode = config.p2pNode;
         // Initialize oNodeStreamManager (stream lifecycle and protocol management)
         this.streamManager = new oNodeStreamManager({
             p2pConnection: this.p2pConnection,
         });
+        // Set up persistent identify event listener
+        this.setupIdentifyListener();
     }
     get remotePeerId() {
         return this.p2pConnection.remotePeer;
@@ -31,11 +35,74 @@ export class oNodeConnection extends oConnection {
     get streams() {
         return this.streamManager.getAllStreams();
     }
+    /**
+     * Get cached identify data for the remote peer.
+     * Returns undefined if identify event hasn't been received yet.
+     */
+    get cachedIdentifyData() {
+        return this.identifyData;
+    }
+    /**
+     * Get protocols supported by the remote peer from cached identify data.
+     * Returns empty array if identify data not available yet.
+     */
+    get remoteProtocols() {
+        return this.identifyData?.protocols || [];
+    }
+    /**
+     * Get agent version of the remote peer from cached identify data.
+     */
+    get remoteAgentVersion() {
+        return this.identifyData?.agentVersion;
+    }
+    /**
+     * Get protocol version of the remote peer from cached identify data.
+     */
+    get remoteProtocolVersion() {
+        return this.identifyData?.protocolVersion;
+    }
+    /**
+     * Get listen addresses advertised by the remote peer.
+     * Returns empty array if identify data not available yet.
+     */
+    get remoteListenAddrs() {
+        return this.identifyData?.listenAddrs || [];
+    }
+    /**
+     * Get our observed address as seen by the remote peer.
+     */
+    get observedAddress() {
+        return this.identifyData?.observedAddr;
+    }
+    get address() {
+        if (this.identifyData?.protocols &&
+            this.identifyData.protocols.length > 0) {
+            const filtered = this.identifyData.protocols.filter((p) => p.startsWith('/o/'));
+            if (filtered.length > 0) {
+                const remoteAddress = oNodeAddress.fromProtocol(filtered[0]);
+                return remoteAddress;
+            }
+        }
+        return this.config.address;
+    }
+    get nextHopAddress() {
+        if (this.config.nextHopAddress.value === 'o://unknown') {
+            return this.address;
+        }
+        return this.config.nextHopAddress;
+    }
+    get callerAddress() {
+        if (this.p2pConnection.direction === 'inbound') {
+            return this.address;
+        }
+        return this.config.callerAddress;
+    }
     async transmit(request) {
         try {
             // Build protocol string
             const protocol = this.nextHopAddress.protocol +
                 (this.reusePolicy === 'reuse' ? '/reuse' : '');
+            this.logger.debug('Transmitting request on limited connection?', this.config.runOnLimitedConnection);
             const streamConfig = {
                 signal: this.abortSignal,
                 drainTimeoutMs: this.config.drainTimeoutMs,
@@ -43,7 +110,7 @@ export class oNodeConnection extends oConnection {
                 maxOutboundStreams: process.env.MAX_OUTBOUND_STREAMS
                     ? parseInt(process.env.MAX_OUTBOUND_STREAMS)
                     : 1000,
-                runOnLimitedConnection: this.config.runOnLimitedConnection ?? true,
+                runOnLimitedConnection: this.config.runOnLimitedConnection ?? false,
             };
             // Get stream from StreamManager
             const wrappedStream = await this.streamManager.getOrCreateStream(protocol, this.nextHopAddress, streamConfig);
@@ -53,9 +120,27 @@ export class oNodeConnection extends oConnection {
             // Send the request with backpressure handling
             const data = new TextEncoder().encode(request.toString());
             await this.streamManager.sendLengthPrefixed(stream, data, streamConfig);
+            // Determine which stream to wait for response on
+            // If _streamId is specified, use that stream (for limited connections with persistent writer stream)
+            let responseStream = stream;
+            if (request.params._streamId) {
+                const specifiedStream = this.streamManager.getStreamById(request.params._streamId);
+                if (specifiedStream) {
+                    responseStream = specifiedStream;
+                    this.logger.debug('Using specified stream for response', {
+                        requestStreamId: stream.id,
+                        responseStreamId: specifiedStream.id,
+                    });
+                }
+                else {
+                    this.logger.warn('Specified response stream not found, using request stream', {
+                        streamId: request.params._streamId,
+                    });
+                }
+            }
             // Handle response using StreamManager
             // Pass request ID to enable proper response correlation on shared streams
-            const response = await this.streamManager.handleOutgoingStream(stream, this.emitter, streamConfig, request.id);
+            const response = await this.streamManager.handleOutgoingStream(responseStream, this.emitter, streamConfig, request.id);
             // Handle cleanup of the stream
             await this.postTransmit(wrappedStream);
             return response;
@@ -71,6 +156,35 @@ export class oNodeConnection extends oConnection {
         // Always cleanup streams (no reuse at base layer)
         await this.streamManager.releaseStream(stream.p2pStream.id);
     }
+    /**
+     * Set up persistent listener for identify events from the remote peer
+     */
+    setupIdentifyListener() {
+        if (!this.p2pNode) {
+            return;
+        }
+        this.identifyListener = (evt) => {
+            const { peerId, protocols, agentVersion, protocolVersion, listenAddrs, observedAddr, } = evt.detail;
+            // Only cache if this event is for our remote peer
+            if (peerId?.toString() === this.remotePeerId.toString()) {
+                this.identifyData = {
+                    protocols: protocols || [],
+                    agentVersion,
+                    protocolVersion,
+                    listenAddrs: listenAddrs || [],
+                    observedAddr,
+                    timestamp: Date.now(),
+                };
+                this.logger.debug('Cached identify data for peer', {
+                    peerId: peerId.toString(),
+                    protocols: this.identifyData.protocols,
+                    agentVersion: this.identifyData.agentVersion,
+                });
+            }
+        };
+        this.p2pNode.addEventListener('peer:identify', this.identifyListener);
+        this.logger.debug('Identify listener set up for connection');
+    }
     async abort(error) {
         this.logger.debug('Aborting connection');
         await this.p2pConnection.abort(error);
@@ -78,6 +192,10 @@ export class oNodeConnection extends oConnection {
     }
     async close() {
         this.logger.debug('Closing connection');
+        // Remove identify listener
+        if (this.p2pNode && this.identifyListener) {
+            this.p2pNode.removeEventListener('peer:identify', this.identifyListener);
+        }
         // Close stream manager (handles all stream cleanup)
         await this.streamManager.close();
         await this.p2pConnection.close();

package/dist/src/connection/o-node-connection.manager.d.ts

@@ -2,53 +2,34 @@ import { oAddress, oConnectionConfig, oConnectionManager } from '@olane/o-core';
 import { Libp2p, Connection } from '@olane/o-config';
 import { oNodeConnectionManagerConfig } from './interfaces/o-node-connection-manager.config.js';
 import { oNodeConnection } from './o-node-connection.js';
+/**
+ * Manages oNodeConnection instances, reusing connections when possible.
+ */
 export declare class oNodeConnectionManager extends oConnectionManager {
     readonly config: oNodeConnectionManagerConfig;
     protected p2pNode: Libp2p;
     protected defaultReadTimeoutMs?: number;
     protected defaultDrainTimeoutMs?: number;
     /** Single cache of oNodeConnection instances keyed by address */
-    protected cachedConnections: Map<string, oNodeConnection[]>;
+    protected cachedConnections: Map<string, oNodeConnection>;
     protected pendingDialsByAddress: Map<string, Promise<Connection>>;
     constructor(config: oNodeConnectionManagerConfig);
     /**
      * Set up listeners to maintain connection cache state
      */
     protected setupConnectionListeners(): void;
-    /**
-     * Build a stable cache key from an address.
-     *
-     * We key the cache by address value (e.g., "o://my-tool") to maintain
-     * a simple one-to-one mapping between addresses and connections.
-     */
-    protected getAddressKey(address: oAddress): string | null;
     /**
      * Extract peer ID string from an address
      * @param address - The address to extract peer ID from
      * @returns The peer ID string or null if not found
      */
     protected getPeerIdFromAddress(address: oAddress): string | null;
-    /**
-     * Get the first valid (open) connection for the given address key.
-     * Cleans up stale connections from the cache automatically.
-     *
-     * @param addressKey - The address key to look up
-     * @returns A valid oNodeConnection or null if none found
-     */
-    protected getValidConnection(addressKey: string): oNodeConnection | null;
     /**
      * Cache an oNodeConnection by its address key.
      * @param conn - The oNodeConnection to cache
      * @param addressKey - The address key to cache under
      */
-    protected cacheConnection(conn: oNodeConnection, addressKey: string): void;
-    /**
-     * Get oNodeConnection by libp2p Connection reference
-     * Used to find the correct oNodeConnection for incoming streams
-     * @param p2pConnection - The libp2p connection to search for
-     * @returns The oNodeConnection or undefined if not found
-     */
-    getConnectionByP2pConnection(p2pConnection: Connection): oNodeConnection | undefined;
+    protected cacheConnection(conn: oNodeConnection): void;
     /**
      * Get or create a raw p2p connection to the given address.
      * Subclasses can override connect() and use this method to get the underlying p2p connection.
@@ -59,42 +40,12 @@ export declare class oNodeConnectionManager extends oConnectionManager {
         p2pConnection: Connection;
         reuse?: boolean;
     }): Promise<oNodeConnection>;
+    getConnectionFromAddress(address: oAddress): oNodeConnection | null;
     /**
      * Connect to a given address, reusing oNodeConnection when possible
      * @param config - Connection configuration
      * @returns The connection object
      */
     connect(config: oConnectionConfig): Promise<oNodeConnection>;
-    /**
-     * Check if we have an active connection to the target peer
-     * @param address - The address to check
-     * @returns true if an active connection exists
-     */
-    isCached(address: oAddress): boolean;
-    /**
-     * Get an existing cached oNodeConnection for the target address
-     * @param address - The address to get a connection for
-     * @returns The oNodeConnection or null if not found
-     */
-    getCachedConnection(address: oAddress): oNodeConnection | null;
-    /**
-     * Get cache statistics for monitoring and debugging
-     * @returns Object containing cache statistics
-     */
-    getCacheStats(): {
-        cachedAddresses: number;
-        totalCachedConnections: number;
-        pendingDials: number;
-        connectionsByPeer: Array<{
-            peerId: string;
-            status: string;
-            addressKey: string;
-        }>;
-    };
-    /**
-     * Clean up all stale (non-open) connections from cache
-     * @returns Number of connections removed
-     */
-    cleanupStaleConnections(): number;
 }
 //# sourceMappingURL=o-node-connection.manager.d.ts.map

package/dist/src/connection/o-node-connection.manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node-connection.manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,qBAAa,sBAAuB,SAAQ,kBAAkB;IAQhD,QAAQ,CAAC,MAAM,EAAE,4BAA4B;IAPzD,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACxC,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACzC,iEAAiE;IACjE,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAa;IACxE,SAAS,CAAC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAa;gBAEzD,MAAM,EAAE,4BAA4B;IAWzD;;OAEG;IACH,SAAS,CAAC,wBAAwB,IAAI,IAAI;IA+B1C;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IASzD;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAahE;;;;;;OAMG;IACH,SAAS,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI;IAkBxE;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAY1E;;;;;OAKG;IACH,4BAA4B,CAC1B,aAAa,EAAE,UAAU,GACxB,eAAe,GAAG,SAAS;IAa9B;;;OAGG;cACa,wBAAwB,CACtC,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;cAoCN,WAAW,CACzB,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;IAqBhB,MAAM,CACV,MAAM,EAAE,iBAAiB,GAAG;QAAE,aAAa,EAAE,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzE,OAAO,CAAC,eAAe,CAAC;IA4D3B;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAwDlE;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAcpC;;;;OAIG;IACH,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI;IAc9D;;;OAGG;IACH,aAAa,IAAI;QACf,eAAe,EAAE,MAAM,CAAC;QACxB,sBAAsB,EAAE,MAAM,CAAC;QAC/B,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,KAAK,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC;YACf,MAAM,EAAE,MAAM,CAAC;YACf,UAAU,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;KACJ;IAyBD;;;OAGG;IACH,uBAAuB,IAAI,MAAM;CAuBlC"}
+{"version":3,"file":"o-node-connection.manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-node-connection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,4BAA4B,EAAE,MAAM,kDAAkD,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,kBAAkB;IAQhD,QAAQ,CAAC,MAAM,EAAE,4BAA4B;IAPzD,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACxC,SAAS,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IACzC,iEAAiE;IACjE,SAAS,CAAC,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAa;IACtE,SAAS,CAAC,qBAAqB,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAa;gBAEzD,MAAM,EAAE,4BAA4B;IAWzD;;OAEG;IACH,SAAS,CAAC,wBAAwB,IAAI,IAAI;IAY1C;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,QAAQ,GAAG,MAAM,GAAG,IAAI;IAahE;;;;OAIG;IACH,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAWtD;;;OAGG;cACa,wBAAwB,CACtC,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;cAoBN,WAAW,CACzB,cAAc,EAAE,QAAQ,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,CAAC;IAqBhB,MAAM,CACV,MAAM,EAAE,iBAAiB,GAAG;QAAE,aAAa,EAAE,UAAU,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GACzE,OAAO,CAAC,eAAe,CAAC;IAgD3B,wBAAwB,CAAC,OAAO,EAAE,QAAQ,GAAG,eAAe,GAAG,IAAI;IAkBnE;;;;OAIG;IACG,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;CAqDnE"}