@olane/o-core 0.7.12-alpha.9 → 0.7.12

package/dist/src/connection/interfaces/connection-manager.config.d.ts

@@ -1,3 +1,15 @@
 export interface oConnectionManagerConfig {
+    /**
+     * Default timeout in milliseconds for reading response data from a stream.
+     * Can be overridden per connection.
+     * Default: 120000 (2 minutes)
+     */
+    defaultReadTimeoutMs?: number;
+    /**
+     * Default timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs.
+     * Can be overridden per connection.
+     * Default: 30000 (30 seconds)
+     */
+    defaultDrainTimeoutMs?: number;
 }
 //# sourceMappingURL=connection-manager.config.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;CAAG"}
+{"version":3,"file":"connection-manager.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-manager.config.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB;IACvC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts

@@ -4,5 +4,6 @@ export interface ConnectionSendParams {
         [key: string]: unknown;
     };
     id?: string;
+    isStream?: boolean;
 }
 //# sourceMappingURL=connection-send-params.interface.d.ts.map

package/dist/src/connection/interfaces/connection-send-params.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;CACb"}
+{"version":3,"file":"connection-send-params.interface.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection-send-params.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE;QACP,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB"}

package/dist/src/connection/interfaces/connection.config.d.ts

@@ -1,7 +1,28 @@
 import { oAddress } from '../../router/o-address.js';
+import type { oRequest } from '../o-request.js';
+import type { Stream } from '@libp2p/interface';
+import type { RunResult } from '@olane/o-tool';
 export interface oConnectionConfig {
     nextHopAddress: oAddress;
     callerAddress?: oAddress;
     address: oAddress;
+    /**
+     * Timeout in milliseconds for reading response data from a stream.
+     * Default: 120000 (2 minutes)
+     */
+    readTimeoutMs?: number;
+    /**
+     * Timeout in milliseconds for waiting for stream buffer to drain when backpressure occurs.
+     * Default: 30000 (30 seconds)
+     */
+    drainTimeoutMs?: number;
+    isStream?: boolean;
+    abortSignal?: AbortSignal;
+    /**
+     * Optional handler for processing router requests received on outgoing streams
+     * This enables bidirectional communication where the client can receive and process
+     * router requests while waiting for responses
+     */
+    requestHandler?: (request: oRequest, stream: Stream) => Promise<RunResult>;
 }
 //# sourceMappingURL=connection.config.d.ts.map

package/dist/src/connection/interfaces/connection.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;CACnB"}
+{"version":3,"file":"connection.config.d.ts","sourceRoot":"","sources":["../../../../src/connection/interfaces/connection.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,QAAQ,CAAC;IACzB,aAAa,CAAC,EAAE,QAAQ,CAAC;IACzB,OAAO,EAAE,QAAQ,CAAC;IAClB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B;;;;OAIG;IACH,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,CAAC,CAAC;CAC5E"}

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

@@ -5,7 +5,6 @@ import { oObject } from '../core/o-object.js';
 import { oConnectionConfig } from './interfaces/connection.config.js';
 export declare abstract class oConnectionManager extends oObject {
     readonly config: oConnectionManagerConfig;
-    protected cache: Map<string, oConnection>;
     constructor(config: oConnectionManagerConfig);
     /**
      * Connect to a given address

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

@@ -1 +1 @@
-{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,kBAAmB,SAAQ,OAAO;IAG1C,QAAQ,CAAC,MAAM,EAAE,wBAAwB;IAFrD,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAa;gBAEjC,MAAM,EAAE,wBAAwB;IAIrD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAe3D"}
+{"version":3,"file":"o-connection-manager.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AACrF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,kBAAmB,SAAQ,OAAO;IAC1C,QAAQ,CAAC,MAAM,EAAE,wBAAwB;gBAAhC,MAAM,EAAE,wBAAwB;IAIrD;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,WAAW,CAAC;IAEjE,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO;IAIpC,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,WAAW,GAAG,IAAI;CAG3D"}

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

@@ -3,25 +3,11 @@ export class oConnectionManager extends oObject {
     constructor(config) {
         super();
         this.config = config;
-        this.cache = new Map();
     }
     isCached(address) {
-        return this.cache.has(address.toString());
+        return false;
     }
     getCachedConnection(address) {
-        const key = address.toString();
-        try {
-            const connection = this.cache.get(key);
-            if (!connection) {
-                throw new Error('Connection not found in cache');
-            }
-            connection.validate();
-            return connection;
-        }
-        catch (error) {
-            this.cache.delete(key);
-            this.logger.error('Error getting cached connection:', error);
-        }
         return null;
     }
 }

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

@@ -4,14 +4,18 @@ import { oResponse } from './o-response.js';
 import { ConnectionSendParams } from './interfaces/connection-send-params.interface.js';
 import { oObject } from '../core/o-object.js';
 import { oConnectionConfig } from './interfaces/connection.config.js';
+import { EventEmitter } from 'events';
 export declare abstract class oConnection extends oObject {
     protected readonly config: oConnectionConfig;
     readonly id: string;
     readonly address: oAddress;
     readonly nextHopAddress: oAddress;
     readonly callerAddress: oAddress | undefined;
+    protected readonly emitter: EventEmitter;
     constructor(config: oConnectionConfig);
-    validate(): void;
+    get abortSignal(): AbortSignal | undefined;
+    onChunk(listener: (response: oResponse) => void): void;
+    validate(dto?: any): void;
     createRequest(method: string, params: ConnectionSendParams): oRequest;
     abstract transmit(request: oRequest): Promise<oResponse>;
     send(data: ConnectionSendParams): Promise<oResponse>;

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

@@ -1 +1 @@
-{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEtE,8BAAsB,WAAY,SAAQ,OAAO;IAMnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IALxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;gBAErB,MAAM,EAAE,iBAAiB;IAgBxD,QAAQ,IAAI,IAAI;IAMhB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAarE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAOpD,KAAK;CAGZ"}
+{"version":3,"file":"o-connection.d.ts","sourceRoot":"","sources":["../../../src/connection/o-connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,kDAAkD,CAAC;AAExF,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,8BAAsB,WAAY,SAAQ,OAAO;IAOnC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB;IANxD,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,SAAgB,OAAO,EAAE,QAAQ,CAAC;IAClC,SAAgB,cAAc,EAAE,QAAQ,CAAC;IACzC,SAAgB,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC;IACpD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAsB;gBAE/B,MAAM,EAAE,iBAAiB;IAgBxD,IAAI,WAAW,IAAI,WAAW,GAAG,SAAS,CAEzC;IAED,OAAO,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,SAAS,KAAK,IAAI;IAI/C,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI;IAMzB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,QAAQ;IAcrE,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IAElD,IAAI,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC;IAMpD,KAAK;CAGZ"}

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

@@ -2,10 +2,12 @@ import { oRequest } from './o-request.js';
 import { oProtocolMethods } from '@olane/o-protocol';
 import { v4 as uuidv4 } from 'uuid';
 import { oObject } from '../core/o-object.js';
+import { EventEmitter } from 'events';
 export class oConnection extends oObject {
     constructor(config) {
         super();
         this.config = config;
+        this.emitter = new EventEmitter();
         this.id = uuidv4();
         this.address = config.address;
         this.nextHopAddress = config.nextHopAddress;
@@ -17,7 +19,13 @@ export class oConnection extends oObject {
             ']:' +
             this.id);
     }
-    validate() {
+    get abortSignal() {
+        return this.config.abortSignal;
+    }
+    onChunk(listener) {
+        this.emitter.addListener('chunk', listener);
+    }
+    validate(dto) {
         if (!this.address || !this.nextHopAddress || !this.callerAddress) {
             throw new Error('Connection configuration is invalid');
         }
@@ -29,6 +37,7 @@ export class oConnection extends oObject {
                 _connectionId: this.id,
                 _requestMethod: method,
                 _callerAddress: this.callerAddress?.value,
+                _isStreaming: this.config.isStream ?? false,
                 ...params,
             },
             id: params.id || uuidv4(),
@@ -37,8 +46,7 @@ export class oConnection extends oObject {
     async send(data) {
         // proxy through the router tool
         const request = this.createRequest(oProtocolMethods.ROUTE, data);
-        const result = await this.transmit(request);
-        return result;
+        return this.transmit(request);
     }
     async close() {
         this.logger.debug('Closing connection...');

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

@@ -8,5 +8,6 @@ export declare class oResponse implements Response {
     });
     toJSON(): any;
     toString(): string;
+    static fromJSON(json: any): oResponse;
 }
 //# sourceMappingURL=o-response.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"o-response.d.ts","sourceRoot":"","sources":["../../../src/connection/o-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,SAAS,IAAI,QAAQ,EACrB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,YAAW,QAAQ;IACxC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;IAM9C,MAAM,IAAI,GAAG;IAQb,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"o-response.d.ts","sourceRoot":"","sources":["../../../src/connection/o-response.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,SAAS,EACT,SAAS,IAAI,QAAQ,EACrB,MAAM,EACP,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,SAAU,YAAW,QAAQ;IACxC,OAAO,EAAE,OAAO,eAAe,CAAC;IAChC,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;gBAEH,MAAM,EAAE,MAAM,GAAG;QAAE,EAAE,EAAE,SAAS,CAAA;KAAE;IAM9C,MAAM,IAAI,GAAG;IAQb,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,SAAS;CAQtC"}

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

@@ -15,4 +15,12 @@ export class oResponse {
     toString() {
         return JSON.stringify(this);
     }
+    static fromJSON(json) {
+        return new oResponse({
+            ...json.result,
+            id: json.id, // Preserve request ID for proper request/response correlation
+            _connectionId: json.result?._connectionId,
+            _requestMethod: json.result?._requestMethod,
+        });
+    }
 }

package/dist/src/core/defaults/config.js

@@ -1,5 +1,5 @@
-import path from 'path';
-import os from 'os';
+import * as path from 'path';
+import * as os from 'os';
 export const DEFAULT_CONFIG_PATH = path.join(os.homedir(), '.olane');
 export const DEFAULT_INSTANCE_PATH = path.join(DEFAULT_CONFIG_PATH, 'os-instances');
 export const DEFAULT_CONFIG_FILE = path.join(DEFAULT_CONFIG_PATH, 'config.json');

package/dist/src/core/interfaces/index.d.ts

@@ -1,4 +1,7 @@
 export * from './o-core.config.js';
 export * from './node-type.enum.js';
 export * from './state.enum.js';
+export * from './use-options.interface.js';
+export * from './o-core.interface.js';
+export * from './use-stream-options.interface.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/core/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,mCAAmC,CAAC"}

package/dist/src/core/interfaces/index.js

@@ -1,3 +1,6 @@
 export * from './o-core.config.js';
 export * from './node-type.enum.js';
 export * from './state.enum.js';
+export * from './use-options.interface.js';
+export * from './o-core.interface.js';
+export * from './use-stream-options.interface.js';

package/dist/src/core/interfaces/use-options.interface.d.ts

@@ -0,0 +1,10 @@
+import { oResponse } from '../../connection/o-response.js';
+export interface UseOptions {
+    readTimeoutMs?: number;
+    drainTimeoutMs?: number;
+    isStream?: boolean;
+    onChunk?: (chunk: oResponse) => void;
+    noRouting?: boolean;
+    abortSignal?: AbortSignal;
+}
+//# sourceMappingURL=use-options.interface.d.ts.map

package/dist/src/core/interfaces/use-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/use-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAE3D,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B"}

package/dist/src/core/interfaces/use-options.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/interfaces/use-stream-options.interface.d.ts

@@ -0,0 +1,4 @@
+import { UseOptions } from './use-options.interface';
+export interface UseStreamOptions extends Omit<UseOptions, 'isStream'> {
+}
+//# sourceMappingURL=use-stream-options.interface.d.ts.map

package/dist/src/core/interfaces/use-stream-options.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-stream-options.interface.d.ts","sourceRoot":"","sources":["../../../../src/core/interfaces/use-stream-options.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC;CAAG"}

package/dist/src/core/interfaces/use-stream-options.interface.js

@@ -0,0 +1 @@
+export {};

package/dist/src/core/lib/o-notification.manager.js

@@ -79,13 +79,13 @@ export class oNotificationManager extends oObject {
         if (subscriptionsForType.size === 0) {
             this.subscriptions.delete(subscription.eventType);
         }
-        this.logger.debug(`Unsubscribed from ${subscription.eventType} with ID ${subscription.id}`);
+        this.logger.verbose(`Unsubscribed from ${subscription.eventType} with ID ${subscription.id}`);
     }
     /**
      * Emit a notification event
      */
     emit(event) {
-        this.logger.debug(`Emitting event: ${event.type}`, event.toJSON());
+        this.logger.verbose(`Emitting event: ${event.type}`, event.toJSON());
         const customEvent = new CustomEvent(event.type, {
             detail: event,
         });

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

@@ -16,6 +16,9 @@ import { oRouter } from '../router/o-router.js';
 import { oRequest } from '../connection/o-request.js';
 import { oNotificationManager } from './lib/o-notification.manager.js';
 import { oNotificationEvent, EventFilter, NotificationHandler, Subscription } from './lib/events/index.js';
+import { oConnectionConfig } from '../connection/index.js';
+import { UseOptions } from './interfaces/use-options.interface.js';
+import { UseStreamOptions } from './interfaces/use-stream-options.interface.js';
 export declare abstract class oCore extends oObject {
     readonly config: oCoreConfig;
     address: oAddress;
@@ -32,6 +35,20 @@ export declare abstract class oCore extends oObject {
     get isLeader(): boolean;
     get leader(): oAddress | null;
     abstract configureTransports(): any[];
+    useStream(address: oAddress, data: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }, options: UseStreamOptions): Promise<oResponse>;
+    useDirect(address: oAddress, data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<oResponse>;
     /**
      * Sends a request to a remote node in the O-Lane network using the specified address and optional data payload.
      *
@@ -91,8 +108,19 @@ export declare abstract class oCore extends oObject {
             [key: string]: any;
         };
         id?: string;
-    }): Promise<oResponse>;
+    }, options?: UseOptions): Promise<oResponse>;
     abstract execute(request: oRequest): Promise<any>;
+    /**
+     * Helper method to handle response errors
+     * @param response The response to check for errors
+     * @throws oError if the response contains an error
+     */
+    private handleResponseError;
+    /**
+     * Helper method to validate node is running
+     * @throws Error if node is not running
+     */
+    private validateRunning;
     useSelf(data?: {
         method?: string;
         params?: {
@@ -106,10 +134,13 @@ export declare abstract class oCore extends oObject {
             [key: string]: any;
         };
         id?: string;
+    }, options?: {
+        isStream?: boolean;
+        onChunk?: (chunk: oResponse) => void;
     }): Promise<oResponse>;
     addChildNode(node: oCore): void;
     removeChildNode(node: oCore): void;
-    abstract connect(nextHopAddress: oAddress, targetAddress: oAddress): Promise<oConnection>;
+    abstract connect(config: oConnectionConfig): Promise<oConnection>;
     abstract initializeRouter(): void;
     abstract unregister(): Promise<void>;
     abstract register(): Promise<void>;
@@ -124,6 +155,7 @@ export declare abstract class oCore extends oObject {
     protected onNotification(eventType: string, handler: NotificationHandler, filter?: EventFilter): Subscription;
     initialize(): Promise<void>;
     get isRunning(): boolean;
+    hookStartFinished(): Promise<void>;
     /**
      * Starts the node by transitioning through initialization and registration phases.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"o-core.d.ts","sourceRoot":"","sources":["../../../src/core/o-core.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGhD,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,mBAAmB,EACnB,YAAY,EACb,MAAM,uBAAuB,CAAC;AAE/B,8BAAsB,KAAM,SAAQ,OAAO;IAY7B,QAAQ,CAAC,MAAM,EAAE,WAAW;IAXjC,OAAO,EAAE,QAAQ,CAAC;IAClB,KAAK,EAAE,SAAS,CAAqB;IACrC,MAAM,EAAE,KAAK,EAAE,CAAM;IACrB,iBAAiB,EAAG,kBAAkB,CAAC;IACvC,gBAAgB,EAAE,iBAAiB,CAAC;IACpC,OAAO,EAAE,QAAQ,CAAkB;IACnC,cAAc,EAAE,eAAe,CAAyB;IACxD,MAAM,EAAG,OAAO,CAAC;IACjB,mBAAmB,EAAG,oBAAoB,CAAC;IAClD,OAAO,CAAC,iBAAiB,CAAC,CAAiB;gBAEtB,MAAM,EAAE,WAAW;IAWxC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,IAAI,MAAM,IAAI,QAAQ,GAAG,IAAI,CAE5B;IAGD,QAAQ,CAAC,mBAAmB,IAAI,GAAG,EAAE;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAoDG;IACG,GAAG,CACP,OAAO,EAAE,QAAQ,EACjB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAChC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GACA,OAAO,CAAC,SAAS,CAAC;IAgDrB,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAE3C,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAChC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GAAG,OAAO,CAAC,SAAS,CAAC;IAqChB,QAAQ,CACZ,YAAY,EAAE,QAAQ,EACtB,IAAI,CAAC,EAAE;QACL,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAC;QAChC,EAAE,CAAC,EAAE,MAAM,CAAC;KACb,GACA,OAAO,CAAC,SAAS,CAAC;IAsCrB,YAAY,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAI/B,eAAe,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAKlC,QAAQ,CAAC,OAAO,CACd,cAAc,EAAE,QAAQ,EACxB,aAAa,EAAE,QAAQ,GACtB,OAAO,CAAC,WAAW,CAAC;IAGvB,QAAQ,CAAC,gBAAgB,IAAI,IAAI;IAGjC,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IACpC,QAAQ,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAGlC,SAAS,CAAC,QAAQ,CAAC,yBAAyB,IAAI,oBAAoB;IAEpE;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAMjD;;OAEG;IACH,SAAS,CAAC,cAAc,CACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,CAAC,EAAE,WAAW,GACnB,YAAY;IAQT,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,IAAI,SAAS,IAAI,OAAO,CAMvB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA6BnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBrB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBtC,IAAI,YAAY,IAAI,WAAW,EAAE,CAEhC;IAED;;;OAGG;IACH,OAAO,CAAC,cAAc;IAmCtB,IAAI,OAAO,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAExC;IAED,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,IAAI,aAAa,IAAI,QAAQ,CAE5B;IAED,IAAI,IAAI,IAAI,QAAQ,CAEnB;IAED,IAAI,UAAU,IAAI,UAAU,EAAE,CAE7B;IAED,IAAI,MAAM,IAAI,QAAQ,GAAG,IAAI,CAE5B;IAED,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAEK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC;CAQ7B"}
+{"version":3,"file":"o-core.d.ts","sourceRoot":"","sources":["../../../src/core/o-core.ts"],"names":[],"mappings":"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"}

package/dist/src/core/o-core.js

@@ -7,9 +7,8 @@ import { oObject } from './o-object.js';
 import { oMetrics } from './lib/o-metrics.js';
 import { oHierarchyManager } from './lib/o-hierarchy.manager.js';
 import { oRequestManager } from './lib/o-request.manager.js';
-import { CoreUtils } from '../utils/core.utils.js';
-import { oErrorCodes } from '../error/index.js';
 import { oRequest } from '../connection/o-request.js';
+import { ResponseBuilder } from '../response/response-builder.js';
 export class oCore extends oObject {
     constructor(config) {
         super((config.name ? `:${config.name}` : '') + ':' + config.address.toString());
@@ -30,6 +29,21 @@ export class oCore extends oObject {
     get leader() {
         return this.isLeader ? this.address : this.config?.leader || null;
     }
+    async useStream(address, data, options) {
+        return this.use(address, {
+            ...data,
+            params: {
+                ...data.params,
+                _isStreaming: true,
+            },
+        }, {
+            ...options,
+            isStream: true,
+        });
+    }
+    async useDirect(address, data) {
+        return this.use(address, data, { noRouting: true });
+    }
     /**
      * Sends a request to a remote node in the O-Lane network using the specified address and optional data payload.
      *
@@ -83,11 +97,8 @@ export class oCore extends oObject {
      * }
      * ```
      */
-    async use(address, data) {
-        if (!this.isRunning) {
-            this.logger.error('Node is not running', this.state);
-            throw new Error('Node is not running');
-        }
+    async use(address, data, options) {
+        this.validateRunning();
         if (!address.validate()) {
             throw new Error('Invalid address');
         }
@@ -96,28 +107,66 @@ export class oCore extends oObject {
         if (address.toStaticAddress().equals(this.address.toStaticAddress())) {
             return this.useSelf(data);
         }
-        const { nextHopAddress, targetAddress } = await this.router.translate(address, this);
+        // if no routing is requested, use the address as is
+        if (options?.noRouting) {
+            this.logger.debug('No routing requested, using address as is', address.toString());
+        }
+        const { nextHopAddress, targetAddress } = options?.noRouting
+            ? { nextHopAddress: address, targetAddress: address }
+            : await this.router.translate(address, this);
         if (nextHopAddress.toStaticAddress().equals(this.address.toStaticAddress())) {
             return this.useSelf(data);
         }
-        const connection = await this.connect(nextHopAddress, targetAddress);
+        const connection = await this.connect({
+            nextHopAddress: nextHopAddress,
+            address: targetAddress,
+            callerAddress: this.address,
+            readTimeoutMs: options?.readTimeoutMs,
+            drainTimeoutMs: options?.drainTimeoutMs,
+            isStream: options?.isStream,
+            abortSignal: options?.abortSignal,
+        });
+        if (options?.isStream) {
+            connection.onChunk((response) => {
+                options.onChunk?.(response);
+            });
+        }
         // communicate the payload to the target node
         const response = await connection.send({
             address: targetAddress?.toString() || '',
             payload: data || {},
             id: data?.id,
         });
+        // we handle streaming response differently
+        if (options?.isStream) {
+            return response;
+        }
         // if there is an error, throw it to continue to bubble up
+        this.handleResponseError(response);
+        return response;
+    }
+    /**
+     * Helper method to handle response errors
+     * @param response The response to check for errors
+     * @throws oError if the response contains an error
+     */
+    handleResponseError(response) {
         if (response.result.error) {
-            this.logger.error('response.result.error', JSON.stringify(response.result.error, null, 2));
             throw oError.fromJSON(response.result.error);
         }
-        return response;
     }
-    async useSelf(data) {
+    /**
+     * Helper method to validate node is running
+     * @throws Error if node is not running
+     */
+    validateRunning() {
         if (!this.isRunning) {
+            this.logger.error('Node is not running', this.state);
             throw new Error('Node is not running');
         }
+    }
+    async useSelf(data) {
+        this.validateRunning();
         // let's call our own tool
         this.logger.debug('Calling ourselves, skipping...', data);
         const request = new oRequest({
@@ -129,29 +178,19 @@ export class oCore extends oObject {
             },
             id: 0,
         });
-        let success = true;
-        const result = await this.execute(request).catch((error) => {
-            this.logger.error('Error executing tool [self]: ', error);
-            success = false;
-            const responseError = error instanceof oError
-                ? error
-                : new oError(oErrorCodes.UNKNOWN, error.message);
-            return {
-                error: responseError.toJSON(),
-            };
-        });
-        if (success) {
-            this.metrics.successCount++;
+        // Use ResponseBuilder with automatic error handling and metrics tracking
+        const responseBuilder = ResponseBuilder.create().withMetrics(this.metrics);
+        try {
+            const result = await this.execute(request);
+            return await responseBuilder.build(request, result, null);
         }
-        else {
-            this.metrics.errorCount++;
+        catch (error) {
+            this.logger.error('Error executing tool [self]: ', error);
+            return await responseBuilder.buildError(request, error);
         }
-        return CoreUtils.buildResponse(request, result, result?.error);
     }
-    async useChild(childAddress, data) {
-        if (!this.isRunning) {
-            throw new Error('Node is not running');
-        }
+    async useChild(childAddress, data, options) {
+        this.validateRunning();
         if (!childAddress.transports) {
             const child = this.hierarchyManager.getChild(childAddress);
             if (!child) {
@@ -162,7 +201,17 @@ export class oCore extends oObject {
                 childAddress.setTransports(child?.transports || []);
             }
         }
-        const connection = await this.connect(childAddress, childAddress);
+        const connection = await this.connect({
+            nextHopAddress: childAddress,
+            address: childAddress,
+            callerAddress: this.address,
+            isStream: options?.isStream,
+        });
+        if (options?.isStream) {
+            connection.onChunk((response) => {
+                options.onChunk?.(response);
+            });
+        }
         // communicate the payload to the target node
         const response = await connection.send({
             address: childAddress?.toString() || '',
@@ -170,10 +219,7 @@ export class oCore extends oObject {
             id: data?.id,
         });
         // if there is an error, throw it to continue to bubble up
-        if (response.result.error) {
-            this.logger.error('response.result.error', JSON.stringify(response.result.error, null, 2));
-            throw oError.fromJSON(response.result.error);
-        }
+        this.handleResponseError(response);
         return response;
     }
     // hierarchy
@@ -211,6 +257,7 @@ export class oCore extends oObject {
             this.state === NodeState.STOPPING ||
             this.state === NodeState.STARTING);
     }
+    async hookStartFinished() { }
     /**
      * Starts the node by transitioning through initialization and registration phases.
      *
@@ -252,6 +299,7 @@ export class oCore extends oObject {
             await this.register().catch((error) => {
                 this.logger.error('Failed to register node', error);
             });
+            await this.hookStartFinished();
             this.state = NodeState.RUNNING;
             // Start optional heartbeat to monitor if enabled
             if (process.env.MONITOR_ENABLED === 'true' &&
@@ -357,17 +405,22 @@ export class oCore extends oObject {
         this.logger.debug(`Starting heartbeat to ${monitorAddress.toString()} every ${interval}ms`);
         this.heartbeatInterval = setInterval(async () => {
             try {
+                const metrics = {
+                    successCount: this.metrics.successCount,
+                    errorCount: this.metrics.errorCount,
+                    activeRequests: this.requestManager.activeRequests.length,
+                    state: this.state,
+                };
+                // Add stream count if available (oNode instances have this method)
+                if (typeof this.getStreamCount === 'function') {
+                    metrics.streamCount = this.getStreamCount();
+                }
                 await this.use(monitorAddress, {
                     method: 'record_heartbeat',
                     params: {
                         address: this.address.toString(),
                         timestamp: Date.now(),
-                        metrics: {
-                            successCount: this.metrics.successCount,
-                            errorCount: this.metrics.errorCount,
-                            activeRequests: this.requestManager.activeRequests.length,
-                            state: this.state,
-                        },
+                        metrics,
                     },
                 });
             }

package/dist/src/error/enums/codes.error.d.ts

@@ -14,6 +14,7 @@ export declare enum oErrorCodes {
     TRANSPORT_NOT_SUPPORTED = 1013,
     FAILED_TO_DIAL_TARGET = 1014,
     INVALID_CAPABILITY = 1015,
-    CONNECTION_LIMIT_REACHED = 1016
+    CONNECTION_LIMIT_REACHED = 1016,
+    TIMEOUT = 1017
 }
 //# sourceMappingURL=codes.error.d.ts.map

package/dist/src/error/enums/codes.error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"codes.error.d.ts","sourceRoot":"","sources":["../../../../src/error/enums/codes.error.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,eAAe,OAAO;IACtB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,qBAAqB,OAAO;IAC5B,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;CAChC"}
+{"version":3,"file":"codes.error.d.ts","sourceRoot":"","sources":["../../../../src/error/enums/codes.error.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,eAAe,OAAO;IACtB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,kBAAkB,OAAO;IACzB,kBAAkB,OAAO;IACzB,gBAAgB,OAAO;IACvB,eAAe,OAAO;IACtB,aAAa,OAAO;IACpB,cAAc,OAAO;IACrB,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,qBAAqB,OAAO;IAC5B,kBAAkB,OAAO;IACzB,wBAAwB,OAAO;IAC/B,OAAO,OAAO;CACf"}