@olane/o-node 0.7.12-alpha.11 → 0.7.12-alpha.13

package/dist/src/interfaces/i-heartbeatable-node.d.ts

@@ -0,0 +1,49 @@
+import { oNotificationManager } from '@olane/o-core';
+import { Libp2p } from '@olane/o-config';
+import { oNodeAddress } from '../router/o-node.address.js';
+/**
+ * Interface for nodes that support connection heartbeat monitoring.
+ * This interface defines the contract that oConnectionHeartbeatManager needs
+ * to access live hierarchy state without holding stale references.
+ */
+export interface IHeartbeatableNode {
+    /**
+     * The node's current address
+     */
+    address: oNodeAddress;
+    /**
+     * The notification manager for emitting heartbeat events
+     */
+    notificationManager: oNotificationManager;
+    /**
+     * The underlying libp2p node for ping operations
+     */
+    p2pNode: Libp2p;
+    /**
+     * The current parent address (with live transport updates)
+     * @returns Parent address or null if no parent
+     */
+    parent: oNodeAddress | null;
+    /**
+     * Get the current list of leader addresses
+     * @returns Array of leader addresses (empty if this node is the leader)
+     */
+    getLeaders(): oNodeAddress[];
+    /**
+     * Get the current list of parent addresses
+     * @returns Array of parent addresses
+     */
+    getParents(): oNodeAddress[];
+    /**
+     * Get the current list of child addresses
+     * @returns Array of child addresses
+     */
+    getChildren(): oNodeAddress[];
+    /**
+     * Remove a child from the hierarchy
+     * @param childAddress The address of the child to remove
+     */
+    removeChild(childAddress: oNodeAddress): void;
+    use(param1: any, param2: any): Promise<any>;
+}
+//# sourceMappingURL=i-heartbeatable-node.d.ts.map

package/dist/src/interfaces/i-heartbeatable-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-heartbeatable-node.d.ts","sourceRoot":"","sources":["../../../src/interfaces/i-heartbeatable-node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IAEtB;;OAEG;IACH,mBAAmB,EAAE,oBAAoB,CAAC;IAE1C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;OAGG;IACH,UAAU,IAAI,YAAY,EAAE,CAAC;IAE7B;;;OAGG;IACH,WAAW,IAAI,YAAY,EAAE,CAAC;IAE9B;;;OAGG;IACH,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAE9C,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;CAC7C"}

package/dist/src/interfaces/i-heartbeatable-node.js

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

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

@@ -39,6 +39,12 @@ export interface oNodeConfig extends oCoreConfig {
         baseDelayMs?: number;
         maxDelayMs?: number;
         timeoutMs?: number;
+        circuitBreaker?: {
+            enabled?: boolean;
+            failureThreshold?: number;
+            openTimeoutMs?: number;
+            halfOpenMaxAttempts?: number;
+        };
     };
 }
 //# 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,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,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,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH"}
+{"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,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,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,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACpC,CAAC;IAEF;;;OAGG;IACH,WAAW,CAAC,EAAE;QACZ,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE;YACf,OAAO,CAAC,EAAE,OAAO,CAAC;YAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;YAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;SAC9B,CAAC;KACH,CAAC;CACH"}

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

@@ -1,8 +1,6 @@
-import { Libp2p } from '@olane/o-config';
 import { oObject } from '@olane/o-core';
 import { oNodeAddress } from '../router/o-node.address.js';
-import { oNodeHierarchyManager } from '../o-node.hierarchy-manager.js';
-import { oNotificationManager } from '@olane/o-core';
+import { IHeartbeatableNode } from '../interfaces/i-heartbeatable-node.js';
 export interface HeartbeatConfig {
     enabled: boolean;
     intervalMs: number;
@@ -35,17 +33,15 @@ export interface ConnectionHealth {
  * - Emits ParentDisconnectedEvent when parent dies (triggers reconnection)
  */
 export declare class oConnectionHeartbeatManager extends oObject {
-    private p2pNode;
-    private hierarchyManager;
-    private notificationManager;
-    private address;
+    private node;
     private config;
     private heartbeatInterval?;
     private healthMap;
-    constructor(p2pNode: Libp2p, hierarchyManager: oNodeHierarchyManager, notificationManager: oNotificationManager, address: oNodeAddress, config: HeartbeatConfig);
+    constructor(node: IHeartbeatableNode, config: HeartbeatConfig);
     start(): Promise<void>;
     stop(): Promise<void>;
     private performHeartbeatCycle;
+    private doPing;
     private pingTarget;
     private handleConnectionDead;
     private emitConnectionDegradedEvent;

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,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EACL,OAAO,EAMR,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAErD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,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;;;;;;;;;;;;;GAaG;AACH,qBAAa,2BAA4B,SAAQ,OAAO;IAKpD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,mBAAmB;IAC3B,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IARhB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAuC;gBAG9C,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,qBAAqB,EACvC,mBAAmB,EAAE,oBAAoB,EACzC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe;IAK3B,KAAK;IAqBL,IAAI;YAQI,qBAAqB;YAuCrB,UAAU;IA2FxB,OAAO,CAAC,oBAAoB;IAyD5B,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,4BAA4B;IAiBpC,OAAO,CAAC,wBAAwB;IAahC;;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,SAAS,EAAE,MAAM,CAAC;IAClB,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;;;;;;;;;;;;;GAaG;AACH,qBAAa,2BAA4B,SAAQ,OAAO;IAKpD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,MAAM;IALhB,OAAO,CAAC,iBAAiB,CAAC,CAAiB;IAC3C,OAAO,CAAC,SAAS,CAAuC;gBAG9C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,eAAe;IAK3B,KAAK;IAqBL,IAAI;YAQI,qBAAqB;IA0CnC,OAAO,CAAC,MAAM;YAOA,UAAU;IAuFxB,OAAO,CAAC,oBAAoB;IAyD5B,OAAO,CAAC,2BAA2B;IAmBnC,OAAO,CAAC,4BAA4B;IAiBpC,OAAO,CAAC,wBAAwB;IAahC;;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

@@ -14,12 +14,9 @@ import { oObject, ChildLeftEvent, ParentDisconnectedEvent, LeaderDisconnectedEve
  * - Emits ParentDisconnectedEvent when parent dies (triggers reconnection)
  */
 export class oConnectionHeartbeatManager extends oObject {
-    constructor(p2pNode, hierarchyManager, notificationManager, address, config) {
+    constructor(node, config) {
         super();
-        this.p2pNode = p2pNode;
-        this.hierarchyManager = hierarchyManager;
-        this.notificationManager = notificationManager;
-        this.address = address;
+        this.node = node;
         this.config = config;
         this.healthMap = new Map();
     }
@@ -45,24 +42,27 @@ export class oConnectionHeartbeatManager extends oObject {
     async performHeartbeatCycle() {
         const targets = [];
         // Check if this is a leader node (no leader in hierarchy = we are leader)
-        const isLeaderNode = this.hierarchyManager.getLeaders().length === 0;
+        const isLeaderNode = this.node.getLeaders().length === 0;
         // Collect leader (if enabled and we're not the leader)
         if (!isLeaderNode) {
-            const leaders = this.hierarchyManager.getLeaders();
+            const leaders = this.node.getLeaders();
             for (const leader of leaders) {
                 targets.push({ address: leader, role: 'leader' });
             }
         }
         // Collect parent
         if (this.config.checkParent && !isLeaderNode) {
-            const parents = this.hierarchyManager.getParents();
-            for (const parent of parents) {
+            // Use this.node.parent getter to get the current parent address with transports
+            // rather than getParents() which may have a stale reference
+            const parent = this.node.parent;
+            this.logger.debug('Parent address:', parent);
+            if (parent) {
                 targets.push({ address: parent, role: 'parent' });
             }
         }
         // Collect children
         if (this.config.checkChildren) {
-            const children = this.hierarchyManager.getChildren();
+            const children = this.node.getChildren();
             for (const child of children) {
                 targets.push({ address: child, role: 'child' });
             }
@@ -70,12 +70,17 @@ export class oConnectionHeartbeatManager extends oObject {
         // Ping all targets in parallel
         await Promise.allSettled(targets.map((target) => this.pingTarget(target.address, target.role)));
     }
+    doPing(address) {
+        return this.node.use(address, {
+            method: 'ping',
+            params: {},
+        });
+    }
     async pingTarget(address, role) {
         if (!address.libp2pTransports.length) {
-            this.logger.warn(`No transports found for ${address}`);
+            this.logger.debug(`${role} has no transports, skipping ping`, address);
             return;
         }
-        const transports = address.libp2pTransports;
         const key = address.toString();
         let health = this.healthMap.get(key);
         if (!health) {
@@ -98,10 +103,7 @@ export class oConnectionHeartbeatManager extends oObject {
             });
             // Race between ping and timeout
             // The ping service accepts PeerId as string or object
-            await Promise.race([
-                this.p2pNode.services.ping.ping(transports[0].toMultiaddr()),
-                timeoutPromise,
-            ]);
+            await Promise.race([this.doPing(address), timeoutPromise]);
             const latency = Date.now() - startTime;
             // Success - update health
             health.lastSuccessfulPing = Date.now();
@@ -121,7 +123,7 @@ export class oConnectionHeartbeatManager extends oObject {
         }
         catch (error) {
             health.consecutiveFailures++;
-            this.logger.warn(`Ping failed: ${address} (failures: ${health.consecutiveFailures}/${this.config.failureThreshold})`);
+            this.logger.warn(`Ping failed: ${address} (failures: ${health.consecutiveFailures}/${this.config.failureThreshold})`, error);
             // Update status based on failure count
             if (health.consecutiveFailures >= this.config.failureThreshold) {
                 this.handleConnectionDead(address, role, health);
@@ -141,20 +143,20 @@ export class oConnectionHeartbeatManager extends oObject {
         // Emit events based on role
         if (role === 'child') {
             // Remove dead child from hierarchy
-            this.hierarchyManager.removeChild(address);
+            this.node.removeChild(address);
             // Emit child left event
-            this.notificationManager.emit(new ChildLeftEvent({
-                source: this.address,
+            this.node.notificationManager.emit(new ChildLeftEvent({
+                source: this.node.address,
                 childAddress: address,
-                parentAddress: this.address,
+                parentAddress: this.node.address,
                 reason: `heartbeat_failed_${health.consecutiveFailures}_times`,
             }));
             this.logger.warn(`Removed dead child: ${address}`);
         }
         else if (role === 'parent') {
             // Emit parent disconnected event
-            this.notificationManager.emit(new ParentDisconnectedEvent({
-                source: this.address,
+            this.node.notificationManager.emit(new ParentDisconnectedEvent({
+                source: this.node.address,
                 parentAddress: address,
                 reason: `heartbeat_failed_${health.consecutiveFailures}_times`,
             }));
@@ -163,8 +165,8 @@ export class oConnectionHeartbeatManager extends oObject {
         }
         else if (role === 'leader') {
             // Emit leader disconnected event
-            this.notificationManager.emit(new LeaderDisconnectedEvent({
-                source: this.address,
+            this.node.notificationManager.emit(new LeaderDisconnectedEvent({
+                source: this.node.address,
                 leaderAddress: address,
                 reason: `heartbeat_failed_${health.consecutiveFailures}_times`,
             }));
@@ -175,8 +177,8 @@ export class oConnectionHeartbeatManager extends oObject {
     emitConnectionDegradedEvent(address, role, failures) {
         // ConnectionDegradedEvent only supports parent/child, so we map leader to parent
         const eventRole = role === 'leader' ? 'parent' : role === 'child' ? 'child' : 'parent';
-        this.notificationManager.emit(new ConnectionDegradedEvent({
-            source: this.address,
+        this.node.notificationManager.emit(new ConnectionDegradedEvent({
+            source: this.node.address,
             targetAddress: address,
             role: eventRole,
             consecutiveFailures: failures,
@@ -185,8 +187,8 @@ export class oConnectionHeartbeatManager extends oObject {
     emitConnectionRecoveredEvent(address, role) {
         // ConnectionRecoveredEvent only supports parent/child, so we map leader to parent
         const eventRole = role === 'leader' ? 'parent' : role === 'child' ? 'child' : 'parent';
-        this.notificationManager.emit(new ConnectionRecoveredEvent({
-            source: this.address,
+        this.node.notificationManager.emit(new ConnectionRecoveredEvent({
+            source: this.node.address,
             targetAddress: address,
             role: eventRole,
         }));

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

@@ -41,7 +41,7 @@ export declare class oReconnectionManager extends oObject {
     /**
      * Wait for non-leader parent to appear in registry and reconnect
      */
-    private waitForParentAndReconnect;
+    waitForParentAndReconnect(): Promise<void>;
     private handleReconnectionFailure;
     private calculateNodeLevel;
     private calculateBackoffDelay;

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,EAQR,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;YAoBb,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAkDX,2BAA2B;YAiB3B,iBAAiB;IAgB/B;;;OAGG;YACW,yBAAyB;IA8EvC;;OAEG;YACW,yBAAyB;IA8FvC,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,EAQR,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;YAoBb,wBAAwB;YAaxB,wBAAwB;YAexB,wBAAwB;IAehC,mBAAmB;YAgDX,2BAA2B;YAiB3B,iBAAiB;IAkB/B;;;OAGG;YACW,yBAAyB;IAiFvC;;OAEG;IACG,yBAAyB;IAiG/B,OAAO,CAAC,yBAAyB;IAajC,OAAO,CAAC,kBAAkB;IAI1B,OAAO,CAAC,qBAAqB;IAK7B,OAAO,CAAC,KAAK;CAGd"}

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

@@ -45,6 +45,7 @@ export declare class oNode extends oToolBase {
     configure(): Promise<Libp2pConfig>;
     protected createNode(): Promise<Libp2p>;
     connect(nextHopAddress: oNodeAddress, targetAddress: oNodeAddress): Promise<oNodeConnection>;
+    postInitialize(): Promise<void>;
     initialize(): Promise<void>;
     /**
      * Override use() to wrap leader/registry requests with retry logic
@@ -57,5 +58,9 @@ export declare class oNode extends oToolBase {
         id?: string;
     }): Promise<any>;
     teardown(): Promise<void>;
+    getLeaders(): oNodeAddress[];
+    getParents(): oNodeAddress[];
+    getChildren(): oNodeAddress[];
+    removeChild(childAddress: oNodeAddress): void;
 }
 //# sourceMappingURL=o-node.d.ts.map

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":"AAAA,OAAO,EAGL,MAAM,EACN,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAIL,QAAQ,EACR,QAAQ,EAER,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGnF,OAAO,EAAmB,SAAS,EAAE,MAAM,eAAe,CAAC;AAI3D,OAAO,EAAE,2BAA2B,EAAE,MAAM,8CAA8C,CAAC;AAC3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE,qBAAa,KAAM,SAAQ,SAAS;IAC3B,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,EAAG,MAAM,CAAC;IACjB,OAAO,EAAG,YAAY,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,EAAG,sBAAsB,CAAC;IAC3C,gBAAgB,EAAG,qBAAqB,CAAC;IACzC,0BAA0B,CAAC,EAAE,2BAA2B,CAAC;IACzD,mBAAmB,CAAC,EAAE,oBAAoB,CAAC;IAC3C,oBAAoB,EAAG,oBAAoB,CAAC;IACnD,SAAS,CAAC,WAAW,EAAE,OAAO,CAAS;gBAE3B,MAAM,EAAE,WAAW;IAK/B,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;IAED,IAAI,aAAa,IAAI,YAAY,CAKhC;IAED,IAAI,YAAY,IAAI,MAAM,GAAG,IAAI,CAOhC;IAED,mBAAmB,IAAI,GAAG,EAAE;IAItB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IASvC,SAAS,CAAC,yBAAyB,IAAI,oBAAoB;IAQ3D,IAAI,aAAa,IAAI,YAAY,CAEhC;IAED,IAAI,gBAAgB,IAAI,cAAc,EAAE,CAEvC;IAED,IAAI,UAAU,IAAI,cAAc,EAAE,CAIjC;IAEK,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAsD3B,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B/B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC/B,aAAa,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM;IAItC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAetB,mBAAmB,CAAC,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC;IAG1D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC;cA0FxB,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAMvC,OAAO,CACX,cAAc,EAAE,YAAY,EAC5B,aAAa,EAAE,YAAY,GAC1B,OAAO,CAAC,eAAe,CAAC;IA0BrB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+FjC;;OAEG;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,GAAG,CAAC;IAST,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhC"}
+{"version":3,"file":"o-node.d.ts","sourceRoot":"","sources":["../../src/o-node.ts"],"names":[],"mappings":"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"}

package/dist/src/o-node.js

@@ -110,11 +110,20 @@ export class oNode extends oToolBase {
             this.logger.debug('Skipping parent registration, node is leader');
             return;
         }
+        if (!this.parent?.libp2pTransports?.length) {
+            this.logger.debug('Parent has no transports, waiting for reconnection & leader ack');
+            if (this.parent?.toString() === oAddress.leader().toString()) {
+                this.parent.setTransports(this.leader?.libp2pTransports || []);
+            }
+            else {
+                await this.reconnectionManager?.waitForParentAndReconnect();
+            }
+        }
         // if no parent transports, register with the parent to get them
         // TODO: should we remove the transports check to make this more consistent?
-        if (this.config.parent && this.config.parent.transports.length === 0) {
+        if (this.config.parent) {
             this.logger.debug('Registering node with parent...', this.config.parent);
-            const parentRegistration = await this.use(this.config.parent, {
+            await this.use(this.config.parent, {
                 method: 'child_register',
                 params: {
                     address: this.address.toString(),
@@ -123,9 +132,6 @@ export class oNode extends oToolBase {
                     _token: this.config.joinToken,
                 },
             });
-            const { parentTransports } = parentRegistration.result.data;
-            // update the parent transports
-            this.config.parent.setTransports(parentTransports.map((t) => new oNodeTransport(t)));
         }
     }
     async register() {
@@ -281,6 +287,20 @@ export class oNode extends oToolBase {
         }
         return connection;
     }
+    async postInitialize() {
+        // Initialize connection heartbeat manager
+        this.connectionHeartbeatManager = new oConnectionHeartbeatManager(this, {
+            enabled: this.config.connectionHeartbeat?.enabled ?? true,
+            intervalMs: this.config.connectionHeartbeat?.intervalMs ?? 15000,
+            timeoutMs: this.config.connectionHeartbeat?.timeoutMs ?? 15000,
+            failureThreshold: this.config.connectionHeartbeat?.failureThreshold ?? 3,
+            checkChildren: this.config.connectionHeartbeat?.checkChildren ?? false,
+            checkParent: this.config.connectionHeartbeat?.checkParent ?? true,
+            checkLeader: true,
+        });
+        this.logger.info(`Connection heartbeat config: leader=${this.connectionHeartbeatManager.getConfig().checkLeader}, ` +
+            `parent=${this.connectionHeartbeatManager.getConfig().checkParent}`);
+    }
     async initialize() {
         this.logger.debug('Initializing node...');
         if (this.p2pNode && this.state !== NodeState.STOPPED) {
@@ -300,16 +320,23 @@ export class oNode extends oToolBase {
         this.connectionManager = new oNodeConnectionManager({
             p2pNode: this.p2pNode,
         });
-        // Initialize leader request wrapper
+        // Initialize leader request wrapper with circuit breaker
         this.leaderRequestWrapper = new LeaderRequestWrapper({
             enabled: this.config.leaderRetry?.enabled ?? true,
             maxAttempts: this.config.leaderRetry?.maxAttempts ?? 20,
             baseDelayMs: this.config.leaderRetry?.baseDelayMs ?? 2000,
             maxDelayMs: this.config.leaderRetry?.maxDelayMs ?? 30000,
             timeoutMs: this.config.leaderRetry?.timeoutMs ?? 120000,
+            circuitBreaker: {
+                enabled: this.config.leaderRetry?.circuitBreaker?.enabled ?? true,
+                failureThreshold: this.config.leaderRetry?.circuitBreaker?.failureThreshold ?? 3,
+                openTimeoutMs: this.config.leaderRetry?.circuitBreaker?.openTimeoutMs ?? 30000,
+                halfOpenMaxAttempts: this.config.leaderRetry?.circuitBreaker?.halfOpenMaxAttempts ?? 1,
+            },
         });
         this.logger.info(`Leader retry config: enabled=${this.leaderRequestWrapper.getConfig().enabled}, ` +
-            `maxAttempts=${this.leaderRequestWrapper.getConfig().maxAttempts}`);
+            `maxAttempts=${this.leaderRequestWrapper.getConfig().maxAttempts}, ` +
+            `circuitBreaker.enabled=${this.leaderRequestWrapper.getConfig().circuitBreaker?.enabled}`);
         // initialize address resolution
         this.router.addResolver(new oMethodResolver(this.address));
         this.router.addResolver(new oNodeResolver(this.address));
@@ -321,18 +348,6 @@ export class oNode extends oToolBase {
         // Read ENABLE_LEADER_HEARTBEAT environment variable
         const enableLeaderHeartbeat = this.parent?.toString() === oAddress.leader().toString();
         this.logger.debug(`Enable leader heartbeat: ${enableLeaderHeartbeat}`);
-        // Initialize connection heartbeat manager
-        this.connectionHeartbeatManager = new oConnectionHeartbeatManager(this.p2pNode, this.hierarchyManager, this.notificationManager, this.address, {
-            enabled: this.config.connectionHeartbeat?.enabled ?? true,
-            intervalMs: this.config.connectionHeartbeat?.intervalMs ?? 15000,
-            timeoutMs: this.config.connectionHeartbeat?.timeoutMs ?? 5000,
-            failureThreshold: this.config.connectionHeartbeat?.failureThreshold ?? 3,
-            checkChildren: this.config.connectionHeartbeat?.checkChildren ?? true,
-            checkParent: this.config.connectionHeartbeat?.checkParent ?? true,
-            checkLeader: enableLeaderHeartbeat,
-        });
-        this.logger.info(`Connection heartbeat config: leader=${this.connectionHeartbeatManager.getConfig().checkLeader}, ` +
-            `parent=${this.connectionHeartbeatManager.getConfig().checkParent}`);
         // Initialize reconnection manager
         if (this.config.reconnection?.enabled !== false) {
             this.reconnectionManager = new oReconnectionManager(this, {
@@ -364,4 +379,17 @@ export class oNode extends oToolBase {
             await this.p2pNode.stop();
         }
     }
+    // IHeartbeatableNode interface methods
+    getLeaders() {
+        return [this.leader];
+    }
+    getParents() {
+        return this.hierarchyManager.getParents();
+    }
+    getChildren() {
+        return this.hierarchyManager.getChildren();
+    }
+    removeChild(childAddress) {
+        this.hierarchyManager.removeChild(childAddress);
+    }
 }

package/dist/src/router/o-node.routing-policy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node.routing-policy.d.ts","sourceRoot":"","sources":["../../../src/router/o-node.routing-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1C;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;IAkB1D;;;;;;;;OAQG;IACH,0BAA0B,CACxB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,GACV,aAAa,GAAG,IAAI;CAuBxB"}
+{"version":3,"file":"o-node.routing-policy.d.ts","sourceRoot":"","sources":["../../../src/router/o-node.routing-policy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAG1C;;;GAGG;AACH,qBAAa,kBAAmB,SAAQ,cAAc;IACpD;;;;;;;;;OASG;IACH,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;IAkB1D;;;;;;;;OAQG;IACH,0BAA0B,CACxB,OAAO,EAAE,QAAQ,EACjB,IAAI,EAAE,KAAK,GACV,aAAa,GAAG,IAAI;CAsBxB"}

package/dist/src/router/o-node.routing-policy.js

@@ -21,7 +21,8 @@ export class oNodeRoutingPolicy extends oRoutingPolicy {
             nodeAddress.libp2pTransports?.length > 0) {
             // transports are provided, let's see if they match our known leaders
             const isLeaderRef = nodeAddress.toString() === oAddress.leader().toString();
-            const isOurLeaderRef = node.hierarchyManager.leaders.some((l) => l.equals(nodeAddress));
+            const isOurLeaderRef = node.address.equals(nodeAddress) ||
+                node.hierarchyManager.leaders.some((l) => l.equals(nodeAddress));
             return isLeaderRef || isOurLeaderRef;
         }
         return true;
@@ -40,7 +41,7 @@ export class oNodeRoutingPolicy extends oRoutingPolicy {
         const isInternal = this.isInternalAddress(address, node);
         if (!isInternal) {
             // external address, so we need to route
-            this.logger.debug('Address is external, routing...', nodeAddress.toString(), nodeAddress.libp2pTransports.map((t) => t.toString()));
+            this.logger.debug('Address is external, routing...', nodeAddress.toString());
             // route to leader of external OS
             return {
                 nextHopAddress: new oNodeAddress(oAddress.leader().toString(), nodeAddress.libp2pTransports),

package/dist/src/router/resolvers/o-node.search-resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-node.search-resolver.d.ts","sourceRoot":"","sources":["../../../../src/router/resolvers/o-node.search-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,KAAK,EAEL,UAAU,EACV,cAAc,EAEd,aAAa,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ;gBAAjB,OAAO,EAAE,QAAQ;IAIhD,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAED;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC;;;;OAIG;IACH,SAAS,CAAC,eAAe,IAAI,MAAM;IAInC;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,GAAG,GAAG;IAOnD;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,GAAG,EAAE;IASjE;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI;IAIlD;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,cAAc,EAAE;IAOtD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,wBAAwB,CAChC,OAAO,EAAE,QAAQ,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,IAAI,EAAE,KAAK,GACV,cAAc,EAAE;IAgBnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,SAAS,CAAC,gBAAgB,CACxB,IAAI,EAAE,KAAK,EACX,qBAAqB,EAAE,QAAQ,EAC/B,YAAY,EAAE,GAAG,GAChB,QAAQ;IAsBL,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CAoE/D"}
+{"version":3,"file":"o-node.search-resolver.d.ts","sourceRoot":"","sources":["../../../../src/router/resolvers/o-node.search-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,KAAK,EAEL,UAAU,EACV,cAAc,EAEd,aAAa,EAEd,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,qBAAa,eAAgB,SAAQ,gBAAgB;IACvC,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,QAAQ;gBAAjB,OAAO,EAAE,QAAQ;IAIhD,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IAED;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,QAAQ;IAIxC;;;;OAIG;IACH,SAAS,CAAC,eAAe,IAAI,MAAM;IAInC;;;;;OAKG;IACH,SAAS,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,GAAG,GAAG;IAOnD;;;;;;OAMG;IACH,SAAS,CAAC,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,GAAG,EAAE;IASjE;;;;;OAKG;IACH,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI;IAIlD;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,GAAG,cAAc,EAAE;IAOtD;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,wBAAwB,CAChC,OAAO,EAAE,QAAQ,EACjB,gBAAgB,EAAE,cAAc,EAAE,EAClC,IAAI,EAAE,KAAK,GACV,cAAc,EAAE;IAgBnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAyCG;IACH,SAAS,CAAC,gBAAgB,CACxB,IAAI,EAAE,KAAK,EACX,qBAAqB,EAAE,QAAQ,EAC/B,YAAY,EAAE,GAAG,GAChB,QAAQ;IAeL,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;CA8F/D"}

package/dist/src/router/resolvers/o-node.search-resolver.js

@@ -201,7 +201,6 @@ export class oSearchResolver extends oAddressResolver {
     determineNextHop(node, resolvedTargetAddress, searchResult) {
         // Determine next hop using standard hierarchy logic
         const nextHopAddress = oAddress.next(node.address, resolvedTargetAddress);
-        this.logger.debug('determineNextHop with params', 'node.address: ' + node.address.toString(), 'resolvedTargetAddress: ' + resolvedTargetAddress.toString(), 'searchResult.address: ' + searchResult.address, 'next hop: ' + nextHopAddress.toString());
         // Map transports from search result
         const targetTransports = this.mapTransports(searchResult);
         // Set transports on the next hop based on routing logic
@@ -218,13 +217,33 @@ export class oSearchResolver extends oAddressResolver {
                 requestOverride: resolveRequest,
             };
         }
-        // Perform registry search
+        // Perform registry search with error handling
         const searchParams = this.buildSearchParams(address);
         const registryAddress = this.getRegistryAddress();
-        const searchResponse = await node.use(registryAddress, {
-            method: this.getSearchMethod(),
-            params: searchParams,
-        });
+        let searchResponse;
+        try {
+            searchResponse = await node.use(registryAddress, {
+                method: this.getSearchMethod(),
+                params: searchParams,
+            });
+        }
+        catch (error) {
+            // Log the error but don't throw - allow fallback resolvers to handle it
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            // Check if this is a circuit breaker error (fast-fail scenario)
+            if (errorMessage.includes('Circuit breaker is OPEN')) {
+                this.logger.warn(`Registry search blocked by circuit breaker for ${address.toString()}: ${errorMessage}`);
+            }
+            else {
+                this.logger.error(`Registry search failed for ${address.toString()}: ${errorMessage}`);
+            }
+            // Return original address without transports, letting next resolver in chain handle it
+            return {
+                nextHopAddress: address,
+                targetAddress: targetAddress,
+                requestOverride: resolveRequest,
+            };
+        }
         // Filter and select result
         const filteredResults = this.filterSearchResults(searchResponse.result.data, node);
         const selectedResult = this.selectResult(filteredResults);
@@ -240,7 +259,6 @@ export class oSearchResolver extends oAddressResolver {
         const extraParams = address
             .toString() // o://embeddings-text replace o://embeddings-text = ''
             .replace(address.toRootAddress().toString(), '');
-        this.logger.debug('Extra params:', extraParams);
         // Check if selectedResult.address already contains the complete path
         // This happens when registry finds via staticAddress - the returned address
         // is the canonical hierarchical location, so we shouldn't append extraParams

package/dist/src/utils/circuit-breaker.d.ts

@@ -0,0 +1,107 @@
+import { oObject } from '@olane/o-core';
+export declare enum CircuitState {
+    CLOSED = "CLOSED",// Normal operation, requests pass through
+    OPEN = "OPEN",// Circuit broken, requests fast-fail
+    HALF_OPEN = "HALF_OPEN"
+}
+export interface CircuitBreakerConfig {
+    failureThreshold: number;
+    openTimeoutMs: number;
+    halfOpenMaxAttempts: number;
+    enabled: boolean;
+}
+export interface CircuitStats {
+    state: CircuitState;
+    consecutiveFailures: number;
+    totalFailures: number;
+    totalSuccesses: number;
+    lastFailureTime?: number;
+    lastSuccessTime?: number;
+    openedAt?: number;
+}
+/**
+ * Circuit Breaker Pattern Implementation
+ *
+ * Prevents cascading failures by "breaking the circuit" when a service
+ * experiences persistent failures. This allows the system to fail fast
+ * rather than wasting resources on retries that are likely to fail.
+ *
+ * States:
+ * - CLOSED: Normal operation, all requests pass through
+ * - OPEN: Circuit broken due to failures, requests fail immediately
+ * - HALF_OPEN: Testing recovery, limited requests allowed
+ *
+ * Flow:
+ * 1. CLOSED -> OPEN: After N consecutive failures
+ * 2. OPEN -> HALF_OPEN: After timeout period
+ * 3. HALF_OPEN -> CLOSED: After successful request
+ * 4. HALF_OPEN -> OPEN: After failure in recovery
+ *
+ * @example
+ * ```typescript
+ * const breaker = new CircuitBreaker('registry', {
+ *   failureThreshold: 3,
+ *   openTimeoutMs: 30000,
+ *   halfOpenMaxAttempts: 1,
+ *   enabled: true,
+ * });
+ *
+ * // Before making request
+ * if (!breaker.shouldAllowRequest()) {
+ *   throw new Error('Circuit breaker is open');
+ * }
+ *
+ * try {
+ *   const result = await makeRequest();
+ *   breaker.recordSuccess();
+ *   return result;
+ * } catch (error) {
+ *   breaker.recordFailure();
+ *   throw error;
+ * }
+ * ```
+ */
+export declare class CircuitBreaker extends oObject {
+    private readonly serviceName;
+    private readonly config;
+    private state;
+    private consecutiveFailures;
+    private totalFailures;
+    private totalSuccesses;
+    private lastFailureTime?;
+    private lastSuccessTime?;
+    private openedAt?;
+    private halfOpenAttempts;
+    constructor(serviceName: string, config: CircuitBreakerConfig);
+    /**
+     * Check if a request should be allowed through the circuit breaker
+     * @returns true if request should proceed, false if should fast-fail
+     */
+    shouldAllowRequest(): boolean;
+    /**
+     * Record a successful request
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed request
+     */
+    recordFailure(): void;
+    /**
+     * Get current statistics
+     */
+    getStats(): CircuitStats;
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Force reset the circuit breaker to CLOSED state
+     * Use with caution - mainly for testing or manual recovery
+     */
+    reset(): void;
+    /**
+     * Transition to a new state
+     */
+    private transitionTo;
+}
+//# sourceMappingURL=circuit-breaker.d.ts.map

package/dist/src/utils/circuit-breaker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"circuit-breaker.d.ts","sourceRoot":"","sources":["../../../src/utils/circuit-breaker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAExC,oBAAY,YAAY;IACtB,MAAM,WAAW,CAAE,0CAA0C;IAC7D,IAAI,SAAS,CAAE,qCAAqC;IACpD,SAAS,cAAc;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,YAAY,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,qBAAa,cAAe,SAAQ,OAAO;IAWvC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAXzB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,mBAAmB,CAAa;IACxC,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,cAAc,CAAa;IACnC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,eAAe,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAS;IAC1B,OAAO,CAAC,gBAAgB,CAAa;gBAGlB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,oBAAoB;IAW/C;;;OAGG;IACH,kBAAkB,IAAI,OAAO;IA2C7B;;OAEG;IACH,aAAa,IAAI,IAAI;IAkBrB;;OAEG;IACH,aAAa,IAAI,IAAI;IA+BrB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAYxB;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;;OAGG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,CAAC,YAAY;CAOrB"}