@olane/o-node 0.7.29 → 0.7.33

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

@@ -3,5 +3,10 @@ import { oConnectionConfig } from '@olane/o-core';
 export interface oNodeConnectionConfig extends oConnectionConfig {
     p2pConnection: Connection;
     runOnLimitedConnection?: boolean;
+    /**
+     * Enable length-prefixed streaming (libp2p v3 best practice)
+     * @default false (for backward compatibility)
+     */
+    useLengthPrefixing?: boolean;
 }
 //# sourceMappingURL=o-node-connection.config.d.ts.map

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;AAElD,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,aAAa,EAAE,UAAU,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC"}
+{"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;AAElD,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,aAAa,EAAE,UAAU,CAAC;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

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,EAAE,MAAM,EAAE,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,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,qBAAa,eAAgB,SAAQ,WAAW;IAIlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAHrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;gBAER,MAAM,EAAE,qBAAqB;IAM5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAmBlB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAkBpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IA0C/C,YAAY,CAAC,MAAM,EAAE,MAAM;IAQ3B,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CAKZ"}
+{"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,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,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,qBAAa,eAAgB,SAAQ,WAAW;IAIlC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB;IAHrD,aAAa,EAAE,UAAU,CAAC;IACjC,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;gBAER,MAAM,EAAE,qBAAqB;IAM5D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAmBlB,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAmBpC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAkD/C,YAAY,CAAC,MAAM,EAAE,MAAM;IAQ3B,KAAK,CAAC,KAAK,EAAE,KAAK;IAMlB,KAAK;CAKZ"}

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

@@ -28,6 +28,7 @@ export class oNodeConnection extends oConnection {
             runOnLimitedConnection: this.config.runOnLimitedConnection ?? false,
             reusePolicy: 'none', // Default policy, can be overridden in subclasses
             drainTimeoutMs: this.config.drainTimeoutMs,
+            useLengthPrefixing: true,
         };
         return this.streamHandler.getOrCreateStream(this.p2pConnection, this.nextHopAddress.protocol, streamConfig);
     }
@@ -42,10 +43,18 @@ export class oNodeConnection extends oConnection {
                 signal: this.abortSignal,
                 drainTimeoutMs: this.config.drainTimeoutMs,
                 reusePolicy: 'none', // Default policy
+                useLengthPrefixing: this.config.useLengthPrefixing ?? true,
             };
             // Send the request with backpressure handling
             const data = new TextEncoder().encode(request.toString());
-            await this.streamHandler.send(stream, data, streamConfig);
+            // Use length-prefixed encoding if enabled
+            if (streamConfig.useLengthPrefixing) {
+                this.logger.info('Length prefix enabled...');
+                await this.streamHandler.sendLengthPrefixed(stream, data, streamConfig);
+            }
+            else {
+                await this.streamHandler.send(stream, data, streamConfig);
+            }
             // Handle response using StreamHandler
             // Pass request handler if configured to enable bidirectional stream processing
             // Pass request ID to enable proper response correlation on shared streams

package/dist/src/connection/stream-handler.config.d.ts

@@ -34,6 +34,19 @@ export interface StreamHandlerConfig {
      * AbortSignal for cancellation
      */
     signal?: AbortSignal;
+    /**
+     * Enable length-prefixed streaming (libp2p v3 best practice)
+     * When enabled, all messages are prefixed with a varint indicating message length
+     * This provides proper message boundaries and eliminates concatenation issues
+     * @default false (for backward compatibility)
+     */
+    useLengthPrefixing?: boolean;
+    /**
+     * Auto-detect protocol (length-prefixed vs raw JSON)
+     * When enabled, automatically detects the protocol by examining first byte
+     * @default false
+     */
+    autoDetectProtocol?: boolean;
 }
 /**
  * Context for stream lifecycle operations

package/dist/src/connection/stream-handler.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-handler.config.d.ts","sourceRoot":"","sources":["../../../src/connection/stream-handler.config.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}
+{"version":3,"file":"stream-handler.config.d.ts","sourceRoot":"","sources":["../../../src/connection/stream-handler.config.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;OAGG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,mBAAmB,CAAC;CAC7B"}

package/dist/src/connection/stream-handler.d.ts

@@ -47,6 +47,16 @@ export declare class StreamHandler {
      * @param config - Configuration for timeout and other options
      */
     send(stream: Stream, data: Uint8Array, config?: StreamHandlerConfig): Promise<void>;
+    /**
+     * Sends data through a stream using length-prefixed encoding (libp2p v3 best practice)
+     * Each message is automatically prefixed with a varint indicating the message length
+     * This ensures proper message boundaries and eliminates concatenation issues
+     *
+     * @param stream - The stream to send data through
+     * @param data - The data to send
+     * @param config - Configuration for timeout and other options
+     */
+    sendLengthPrefixed(stream: Stream, data: Uint8Array, config?: StreamHandlerConfig): Promise<void>;
     /**
      * Closes a stream safely with error handling
      *
@@ -54,6 +64,16 @@ export declare class StreamHandler {
      * @param config - Configuration including reuse policy
      */
     close(stream: Stream, config?: StreamHandlerConfig): Promise<void>;
+    /**
+     * Handles an incoming stream on the server side using length-prefixed protocol
+     * Uses async read loops instead of event listeners (libp2p v3 best practice)
+     * Processes complete messages with proper boundaries
+     *
+     * @param stream - The incoming stream
+     * @param connection - The connection the stream belongs to
+     * @param toolExecutor - Function to execute tools for requests
+     */
+    handleIncomingStreamLP(stream: Stream, connection: Connection, toolExecutor: (request: oRequest, stream: Stream) => Promise<RunResult>): Promise<void>;
     /**
      * Handles an incoming stream on the server side
      * Attaches message listener immediately (libp2p v3 best practice)
@@ -62,16 +82,30 @@ export declare class StreamHandler {
      * @param stream - The incoming stream
      * @param connection - The connection the stream belongs to
      * @param toolExecutor - Function to execute tools for requests
+     * @param config - Configuration to determine protocol handling
      */
-    handleIncomingStream(stream: Stream, connection: Connection, toolExecutor: (request: oRequest, stream: Stream) => Promise<RunResult>): Promise<void>;
+    handleIncomingStream(stream: Stream, connection: Connection, toolExecutor: (request: oRequest, stream: Stream) => Promise<RunResult>, config?: StreamHandlerConfig): Promise<void>;
     /**
      * Handles a request message by executing the tool and sending response
      *
      * @param message - The decoded request message
      * @param stream - The stream to send the response on
      * @param toolExecutor - Function to execute the tool
+     * @param useLengthPrefixing - Whether to use length-prefixed response encoding
      */
     private handleRequestMessage;
+    /**
+     * Handles an outgoing stream on the client side using length-prefixed protocol
+     * Uses async read loops to process responses with proper message boundaries
+     *
+     * @param stream - The outgoing stream
+     * @param emitter - Event emitter for chunk events
+     * @param config - Configuration including abort signal
+     * @param requestHandler - Optional handler for processing router requests received on this stream
+     * @param requestId - Optional request ID to filter responses (for stream reuse scenarios)
+     * @returns Promise that resolves with the final response
+     */
+    handleOutgoingStreamLP(stream: Stream, emitter: EventEmitter, config?: StreamHandlerConfig, requestHandler?: (request: oRequest, stream: Stream) => Promise<RunResult>, requestId?: string | number): Promise<oResponse>;
     /**
      * Handles an outgoing stream on the client side
      * Listens for response messages and emits them via the event emitter

package/dist/src/connection/stream-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-handler.d.ts","sourceRoot":"","sources":["../../../src/connection/stream-handler.ts"],"names":[],"mappings":";AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EACL,QAAQ,EACR,SAAS,EAIT,MAAM,EAEP,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,CAAC,EAAE,MAAM;IAI3B;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAIhC;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO;IAIjC;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAI7C;;;;;;OAMG;IACG,iBAAiB,CACrB,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,EAChB,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,MAAM,CAAC;IAoClB;;;;;;OAMG;IACG,IAAI,CACR,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,IAAI,CAAC;IAiBhB;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB5E;;;;;;;;OAQG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,GACtE,OAAO,CAAC,IAAI,CAAC;IAsChB;;;;;;OAMG;YACW,oBAAoB;IA4BlC;;;;;;;;;;;OAWG;IACG,oBAAoB,CACxB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,YAAY,EACrB,MAAM,GAAE,mBAAwB,EAChC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,EAC1E,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAC1B,OAAO,CAAC,SAAS,CAAC;IA8GrB;;;;;;;OAOG;IACG,cAAc,CAClB,OAAO,EAAE,cAAc,EACvB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,CAAC,GAChD,OAAO,CAAC,IAAI,CAAC;CAyBjB"}
+{"version":3,"file":"stream-handler.d.ts","sourceRoot":"","sources":["../../../src/connection/stream-handler.ts"],"names":[],"mappings":"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"}

package/dist/src/connection/stream-handler.js

@@ -1,4 +1,5 @@
-import { oRequest, CoreUtils, oError, oErrorCodes, Logger, ResponseBuilder, } from '@olane/o-core';
+import { oRequest, oResponse, CoreUtils, oError, oErrorCodes, Logger, ResponseBuilder, } from '@olane/o-core';
+import { lpStream } from '@olane/o-config';
 /**
  * StreamHandler centralizes all stream-related functionality including:
  * - Message type detection (request vs response)
@@ -82,6 +83,19 @@ export class StreamHandler {
             this.logger.debug('Stream drained successfully');
         }
     }
+    /**
+     * Sends data through a stream using length-prefixed encoding (libp2p v3 best practice)
+     * Each message is automatically prefixed with a varint indicating the message length
+     * This ensures proper message boundaries and eliminates concatenation issues
+     *
+     * @param stream - The stream to send data through
+     * @param data - The data to send
+     * @param config - Configuration for timeout and other options
+     */
+    async sendLengthPrefixed(stream, data, config = {}) {
+        const lp = lpStream(stream);
+        await lp.write(data, { signal: config.signal });
+    }
     /**
      * Closes a stream safely with error handling
      *
@@ -104,6 +118,45 @@ export class StreamHandler {
             }
         }
     }
+    /**
+     * Handles an incoming stream on the server side using length-prefixed protocol
+     * Uses async read loops instead of event listeners (libp2p v3 best practice)
+     * Processes complete messages with proper boundaries
+     *
+     * @param stream - The incoming stream
+     * @param connection - The connection the stream belongs to
+     * @param toolExecutor - Function to execute tools for requests
+     */
+    async handleIncomingStreamLP(stream, connection, toolExecutor) {
+        const lp = lpStream(stream);
+        try {
+            while (stream.status === 'open') {
+                // Read complete length-prefixed message
+                const messageBytes = await lp.read();
+                const decoded = new TextDecoder().decode(messageBytes.subarray());
+                // Ignore non-JSON messages
+                if (!decoded.startsWith('{')) {
+                    continue;
+                }
+                const message = JSON.parse(decoded);
+                if (this.isRequest(message)) {
+                    await this.handleRequestMessage(message, stream, toolExecutor, true);
+                }
+                else if (this.isResponse(message)) {
+                    this.logger.warn('Received response message on server-side stream, ignoring', message);
+                }
+                else {
+                    this.logger.warn('Received unknown message type', message);
+                }
+            }
+        }
+        catch (error) {
+            // Stream closed or error occurred
+            if (stream.status === 'open') {
+                this.logger.error('Error in length-prefixed stream handler:', error);
+            }
+        }
+    }
     /**
      * Handles an incoming stream on the server side
      * Attaches message listener immediately (libp2p v3 best practice)
@@ -112,8 +165,13 @@ export class StreamHandler {
      * @param stream - The incoming stream
      * @param connection - The connection the stream belongs to
      * @param toolExecutor - Function to execute tools for requests
+     * @param config - Configuration to determine protocol handling
      */
-    async handleIncomingStream(stream, connection, toolExecutor) {
+    async handleIncomingStream(stream, connection, toolExecutor, config = {}) {
+        // Route to length-prefixed handler if enabled
+        if (config.useLengthPrefixing) {
+            return this.handleIncomingStreamLP(stream, connection, toolExecutor);
+        }
         // CRITICAL: Attach message listener immediately to prevent buffer overflow (libp2p v3)
         const messageHandler = async (event) => {
             try {
@@ -153,8 +211,9 @@ export class StreamHandler {
      * @param message - The decoded request message
      * @param stream - The stream to send the response on
      * @param toolExecutor - Function to execute the tool
+     * @param useLengthPrefixing - Whether to use length-prefixed response encoding
      */
-    async handleRequestMessage(message, stream, toolExecutor) {
+    async handleRequestMessage(message, stream, toolExecutor, useLengthPrefixing = false) {
         const request = new oRequest(message);
         const responseBuilder = ResponseBuilder.create();
         try {
@@ -163,13 +222,88 @@ export class StreamHandler {
             // );
             const result = await toolExecutor(request, stream);
             const response = await responseBuilder.build(request, result, null);
-            await CoreUtils.sendResponse(response, stream);
+            // Use length-prefixed encoding if enabled
+            if (useLengthPrefixing) {
+                await CoreUtils.sendResponseLP(response, stream);
+            }
+            else {
+                await CoreUtils.sendResponse(response, stream);
+            }
             this.logger.debug(`Successfully processed request: method=${request.method}, id=${request.id}`);
         }
         catch (error) {
             this.logger.error(`Error processing request: method=${request.method}, id=${request.id}`, error);
             const errorResponse = await responseBuilder.buildError(request, error);
-            await CoreUtils.sendResponse(errorResponse, stream);
+            // Use length-prefixed encoding if enabled
+            if (useLengthPrefixing) {
+                await CoreUtils.sendResponseLP(errorResponse, stream);
+            }
+            else {
+                await CoreUtils.sendResponse(errorResponse, stream);
+            }
+        }
+    }
+    /**
+     * Handles an outgoing stream on the client side using length-prefixed protocol
+     * Uses async read loops to process responses with proper message boundaries
+     *
+     * @param stream - The outgoing stream
+     * @param emitter - Event emitter for chunk events
+     * @param config - Configuration including abort signal
+     * @param requestHandler - Optional handler for processing router requests received on this stream
+     * @param requestId - Optional request ID to filter responses (for stream reuse scenarios)
+     * @returns Promise that resolves with the final response
+     */
+    async handleOutgoingStreamLP(stream, emitter, config = {}, requestHandler, requestId) {
+        const lp = lpStream(stream);
+        try {
+            while (stream.status === 'open') {
+                // Read complete length-prefixed message
+                const messageBytes = await lp.read({ signal: config.signal });
+                const decoded = new TextDecoder().decode(messageBytes.subarray());
+                // Ignore non-JSON messages
+                if (!decoded.startsWith('{')) {
+                    continue;
+                }
+                const message = JSON.parse(decoded);
+                if (this.isResponse(message)) {
+                    const response = new oResponse({
+                        ...message.result,
+                        id: message.id,
+                    });
+                    // Filter by request ID if provided
+                    if (requestId !== undefined && response.id !== requestId) {
+                        this.logger.debug(`Ignoring response for different request (expected: ${requestId}, received: ${response.id})`);
+                        continue;
+                    }
+                    // Emit chunk for streaming responses
+                    emitter.emit('chunk', response);
+                    // Check if this is the last chunk
+                    if (response.result._last || !response.result._isStreaming) {
+                        return response;
+                    }
+                }
+                else if (this.isRequest(message)) {
+                    // Process incoming router requests if handler is provided
+                    if (requestHandler) {
+                        this.logger.debug('Received router request on client-side stream, processing...', message);
+                        await this.handleRequestMessage(message, stream, requestHandler, true);
+                    }
+                    else {
+                        this.logger.warn('Received request message on client-side stream, ignoring (no handler)', message);
+                    }
+                }
+                else {
+                    this.logger.warn('Received unknown message type', message);
+                }
+            }
+            throw new oError(oErrorCodes.TIMEOUT, 'Stream closed before response received');
+        }
+        catch (error) {
+            if (config.signal?.aborted) {
+                throw new oError(oErrorCodes.TIMEOUT, 'Request aborted');
+            }
+            throw error;
         }
     }
     /**
@@ -185,6 +319,10 @@ export class StreamHandler {
      * @returns Promise that resolves with the final response
      */
     async handleOutgoingStream(stream, emitter, config = {}, requestHandler, requestId) {
+        // Route to length-prefixed handler if enabled
+        if (config.useLengthPrefixing) {
+            return this.handleOutgoingStreamLP(stream, emitter, config, requestHandler, requestId);
+        }
         return new Promise((resolve, reject) => {
             let lastResponse;
             const messageHandler = async (event) => {

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

@@ -32,5 +32,12 @@ export interface oNodeConfig extends oCoreConfig {
         drainTimeoutMs?: number;
     };
     runOnLimitedConnection?: boolean;
+    /**
+     * Enable length-prefixed streaming (libp2p v3 best practice)
+     * When enabled, all messages are prefixed with a varint indicating message length
+     * This provides proper message boundaries and eliminates concatenation issues
+     * @default false (for backward compatibility)
+     */
+    useLengthPrefixing?: boolean;
 }
 //# sourceMappingURL=o-node.config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"o-node.config.d.ts","sourceRoot":"","sources":["../../../src/interfaces/o-node.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QACnB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC"}
+{"version":3,"file":"o-node.config.d.ts","sourceRoot":"","sources":["../../../src/interfaces/o-node.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,mBAAmB,CAAC,EAAE;QACpB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;IAEF;;;OAGG;IACH,kBAAkB,CAAC,EAAE;QACnB;;;WAGG;QACH,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB;;;WAGG;QACH,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;IAEF,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B"}

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

@@ -1 +1 @@
-{"version":3,"file":"o-connection-heartbeat.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-connection-heartbeat.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAOR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,2BAA4B,SAAQ,OAAO;IAMpD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,SAAS,CAAS;gBAGhB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,eAAe;IAK3B,KAAK;IAqBL,IAAI;YAQI,uBAAuB;IAgDrC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;YA8Cf,WAAW;IAoEzB,OAAO,CAAC,oBAAoB;IAyD5B,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAIrC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS;IAIxE;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B"}
+{"version":3,"file":"o-connection-heartbeat.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-connection-heartbeat.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EAOR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;CACzC;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,2BAA4B,SAAQ,OAAO;IAMpD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IANhB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,SAAS,CAAS;gBAGhB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,eAAe;IAK3B,KAAK;IAqBL,IAAI;YAQI,uBAAuB;IAgDrC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;YAgDf,WAAW;IAoEzB,OAAO,CAAC,oBAAoB;IAyD5B,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,4BAA4B;IAiBpC;;OAEG;IACH,eAAe,IAAI,gBAAgB,EAAE;IAIrC;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,gBAAgB,GAAG,SAAS;IAIxE;;OAEG;IACH,SAAS,IAAI,eAAe;CAG7B"}

package/dist/src/managers/o-connection-heartbeat.manager.js

@@ -1,4 +1,5 @@
 import { oObject, ChildLeftEvent, ParentDisconnectedEvent, LeaderDisconnectedEvent, ConnectionDegradedEvent, ConnectionRecoveredEvent, oAddress, } from '@olane/o-core';
+import { oNodeAddress } from '../router/o-node.address.js';
 /**
  * Connection Health Monitor
  *
@@ -100,9 +101,11 @@ export class oConnectionHeartbeatManager extends oObject {
                 return true;
             }
             // check via ping
-            const pingResponse = this.node.use(address, {
-                method: 'ping'
-            }).catch((err) => {
+            const pingResponse = this.node
+                .use(new oNodeAddress(address?.value), {
+                method: 'ping',
+            })
+                .catch((err) => {
                 if (err.message === 'Can not dial self') {
                     return true;
                 }

package/dist/src/managers/o-reconnection.manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-reconnection.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-reconnection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EASR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAI3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAI7C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,YAAY,CAAS;gBAGnB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,kBAAkB;IAMpC,OAAO,CAAC,mBAAmB;IAyBrB,mBAAmB,CAAC,KAAK,EAAE,GAAG;YAatB,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAgDX,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;OAGG;YACW,yBAAyB;IAiFvC;;OAEG;IACG,yBAAyB;IAwG/B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"o-reconnection.manager.d.ts","sourceRoot":"","sources":["../../../src/managers/o-reconnection.manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EASR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAI3E,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,oBAAqB,SAAQ,OAAO;IAI7C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IAJhB,OAAO,CAAC,YAAY,CAAS;gBAGnB,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,kBAAkB;IAMpC,OAAO,CAAC,mBAAmB;IAyBrB,mBAAmB,CAAC,KAAK,EAAE,GAAG;YAoBtB,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAgDX,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;OAGG;YACW,yBAAyB;IAiFvC;;OAEG;IACG,yBAAyB;IA4G/B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAGd"}

package/dist/src/managers/o-reconnection.manager.js

@@ -32,6 +32,7 @@ export class oReconnectionManager extends oObject {
     }
     async handleNodeConnected(event) {
         const connectedEvent = event;
+        // if leader is back online re-register
         if (connectedEvent.nodeAddress.toString() === oAddress.leader().toString()) {
             // the leader is back online, let's re-register & tell sub-graphs to re-register
             await this.node.useSelf({
@@ -39,6 +40,10 @@ export class oReconnectionManager extends oObject {
                 params: {},
             });
         }
+        if (connectedEvent.nodeAddress.toString() === this.node.config.parent?.value) {
+            // connect to the parent and register
+            await this.node.registerParent();
+        }
     }
     async handleConnectionDegraded(event) {
         const degradedEvent = event;
@@ -73,26 +78,32 @@ export class oReconnectionManager extends oObject {
         }
         this.reconnecting = true;
         let attempt = 0;
-        while (attempt < this.config.maxAttempts) {
-            attempt++;
-            this.logger.info(`Reconnection attempt ${attempt}/${this.config.maxAttempts} to parent: ${this.node.config.parent}`);
-            try {
-                // Strategy 1: Try direct parent reconnection
-                await this.tryDirectParentReconnection();
-                // Success!
-                this.reconnecting = false;
-                this.logger.info(`Successfully reconnected to parent after ${attempt} attempts`);
-                return;
-            }
-            catch (error) {
-                this.logger.warn(`Reconnection attempt ${attempt} failed:`, error instanceof Error ? error.message : error);
-                if (attempt < this.config.maxAttempts) {
-                    const delay = this.calculateBackoffDelay(attempt);
-                    this.logger.debug(`Waiting ${delay}ms before next attempt...`);
-                    await this.sleep(delay);
-                }
-            }
-        }
+        // while (attempt < this.config.maxAttempts) {
+        //   attempt++;
+        //   this.logger.info(
+        //     `Reconnection attempt ${attempt}/${this.config.maxAttempts} to parent: ${this.node.config.parent}`,
+        //   );
+        //   try {
+        //     // Strategy 1: Try direct parent reconnection
+        //     await this.tryDirectParentReconnection();
+        //     // Success!
+        //     this.reconnecting = false;
+        //     this.logger.info(
+        //       `Successfully reconnected to parent after ${attempt} attempts`,
+        //     );
+        //     return;
+        //   } catch (error) {
+        //     this.logger.warn(
+        //       `Reconnection attempt ${attempt} failed:`,
+        //       error instanceof Error ? error.message : error,
+        //     );
+        //     if (attempt < this.config.maxAttempts) {
+        //       const delay = this.calculateBackoffDelay(attempt);
+        //       this.logger.debug(`Waiting ${delay}ms before next attempt...`);
+        //       await this.sleep(delay);
+        //     }
+        //   }
+        // }
         // All direct attempts failed - try leader fallback
         if (this.config.useLeaderFallback) {
             await this.tryLeaderFallback();
@@ -186,6 +197,7 @@ export class oReconnectionManager extends oObject {
      * Wait for non-leader parent to appear in registry and reconnect
      */
     async waitForParentAndReconnect() {
+        this.logger.debug('waitForParentAndReconnect...');
         const startTime = Date.now();
         let attempt = 0;
         let currentDelay = this.config.parentDiscoveryIntervalMs;
@@ -202,7 +214,8 @@ export class oReconnectionManager extends oObject {
                 if (!this.node.config.parent) {
                     throw new Error('Invalid parent definition');
                 }
-                const response = await this.node.use(this.node.config.parent, {
+                this.logger.debug('Calling parent identify');
+                const response = await this.node.use(new oNodeAddress(this.node.config.parent.value), {
                     method: 'identify',
                     params: {},
                 });

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

@@ -21,6 +21,8 @@ export declare class oNode extends oToolBase {
     connectionHeartbeatManager?: oConnectionHeartbeatManager;
     protected reconnectionManager?: oReconnectionManager;
     protected didRegister: boolean;
+    protected hooksStartFinished: any[];
+    protected hooksInitFinished: any[];
     constructor(config: oNodeConfig);
     get leader(): oNodeAddress | null;
     get networkConfig(): Libp2pConfig;
@@ -47,8 +49,10 @@ export declare class oNode extends oToolBase {
     protected createNode(): Promise<Libp2p>;
     connect(config: oNodeConnectionConfig): Promise<oNodeConnection>;
     initConnectionManager(): Promise<void>;
-    hookInitializeFinished(): Promise<void>;
-    hookStartFinished(): Promise<void>;
+    protected hookInitializeFinished(): Promise<void>;
+    onInitFinished(cb: Function): void;
+    onStartFinished(cb: Function): void;
+    protected hookStartFinished(): Promise<void>;
     /**
      * Validates that if a leader address is defined, it has associated transports.
      * This is critical for non-leader nodes to be able to connect to their leader.

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

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

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

@@ -1,15 +1,56 @@
 import { oHierarchyManager, oHierarchyManagerConfig } from '@olane/o-core';
 import { oNodeAddress } from './router/o-node.address.js';
+import { oNodeNotificationManager } from './o-node.notification-manager.js';
 export interface oNodeHierarchyManagerConfig extends oHierarchyManagerConfig {
     leaders: oNodeAddress[];
     children: oNodeAddress[];
     parents: oNodeAddress[];
+    notificationManager?: oNodeNotificationManager;
+    address: oNodeAddress;
 }
 export declare class oNodeHierarchyManager extends oHierarchyManager {
     leaders: oNodeAddress[];
     children: oNodeAddress[];
     parents: oNodeAddress[];
+    private notificationManager?;
+    private address;
     constructor(config: oNodeHierarchyManagerConfig);
+    /**
+     * Set up event listeners to react to notification manager's peer events
+     */
+    setupEventListeners(notificationManager: oNodeNotificationManager): void;
     get leader(): oNodeAddress | null;
+    /**
+     * Handle peer connected event from notification manager
+     * Resolves peer ID to address and emits hierarchy-aware events
+     */
+    private handlePeerConnected;
+    /**
+     * Handle peer disconnected event from notification manager
+     * Resolves peer ID to address and emits hierarchy-aware events
+     */
+    private handlePeerDisconnected;
+    /**
+     * Handle peer discovered event from notification manager
+     * Resolves peer ID to address and emits node discovered event
+     */
+    private handlePeerDiscovered;
+    /**
+     * Resolve a libp2p peer ID to an Olane address
+     * Checks children, parents, and leaders for matching transports
+     */
+    peerIdToAddress(peerId: string): oNodeAddress | null;
+    /**
+     * Check if an address is a direct child
+     */
+    isChild(address: oNodeAddress): boolean;
+    /**
+     * Check if an address is a parent
+     */
+    isParent(address: oNodeAddress): boolean;
+    /**
+     * Check if an address is a leader
+     */
+    isLeader(address: oNodeAddress): boolean;
 }
 //# sourceMappingURL=o-node.hierarchy-manager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"o-node.hierarchy-manager.d.ts","sourceRoot":"","sources":["../../src/o-node.hierarchy-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;IACnD,OAAO,EAAE,YAAY,EAAE,CAAM;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAM;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAM;gBAExB,MAAM,EAAE,2BAA2B;IAO/C,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;CACF"}
+{"version":3,"file":"o-node.hierarchy-manager.d.ts","sourceRoot":"","sources":["../../src/o-node.hierarchy-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EAaxB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mBAAmB,CAAC,EAAE,wBAAwB,CAAC;IAC/C,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,qBAAa,qBAAsB,SAAQ,iBAAiB;IACnD,OAAO,EAAE,YAAY,EAAE,CAAM;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAM;IAC9B,OAAO,EAAE,YAAY,EAAE,CAAM;IACpC,OAAO,CAAC,mBAAmB,CAAC,CAA2B;IACvD,OAAO,CAAC,OAAO,CAAe;gBAElB,MAAM,EAAE,2BAA2B;IAW/C;;OAEG;IACH,mBAAmB,CAAC,mBAAmB,EAAE,wBAAwB,GAAG,IAAI;IAqBxE,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;IAED;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IA8C3B;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAuD9B;;;OAGG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAqCpD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAMvC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;IAMxC;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO;CAKzC"}