@olane/o-tool 0.7.12-alpha.1 → 0.7.12-alpha.11

package/LICENSE

@@ -0,0 +1,34 @@
+# Dual License: MIT OR Apache-2.0
+
+Copyright (c) 2025 Olane Inc.
+
+Olane OS is dual-licensed under your choice of either:
+
+- **MIT License** (LICENSE-MIT or https://opensource.org/licenses/MIT)
+- **Apache License, Version 2.0** (LICENSE-APACHE or https://www.apache.org/licenses/LICENSE-2.0)
+
+## Why Dual Licensing?
+
+Dual licensing provides developers with flexibility when integrating Olane OS into their projects:
+
+- **Choose MIT**: If you prefer a simple, permissive license without patent provisions
+- **Choose Apache 2.0**: If you desire explicit patent protection and other features of the Apache license
+
+You may choose either license to govern your use of this software.
+
+## License Terms
+
+### MIT License
+The MIT license is very permissive and allows users to do almost anything with the software, including using, copying, modifying, merging, publishing, distributing, and selling it. The primary requirement is that the original copyright and license notice must be included in all copies of the software.
+
+See LICENSE-MIT for the full license text.
+
+### Apache License 2.0
+The Apache License 2.0 is also a permissive free software license. It grants users the right to use, modify, and distribute the software. It also includes provisions regarding patent grants, which are not present in the MIT license.
+
+See LICENSE-APACHE for the full license text.
+
+## Contributing
+
+Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be dual-licensed as above, without any additional terms or conditions.
+

package/dist/src/o-tool.base.d.ts

@@ -1,4 +1,4 @@
-import { oAddress, oConnection, oCore, oRequest } from '@olane/o-core';
+import { oAddress, oConnection, oCore, oRequest, oNotificationManager } from '@olane/o-core';
 import { Stream } from '@olane/o-config';
 import { RunResult } from './interfaces/run-result.interface.js';
 import { ToolResult } from './interfaces/tool-result.interface.js';
@@ -15,6 +15,7 @@ export declare class oToolBase extends oCore {
     initializeRouter(): Promise<void>;
     unregister(): Promise<void>;
     register(): Promise<void>;
+    protected createNotificationManager(): oNotificationManager;
     execute(req: oRequest, stream?: Stream): Promise<RunResult>;
     run(request: oRequest, stream?: Stream): Promise<RunResult>;
     myTools(obj?: any): Promise<string[]>;

package/dist/src/o-tool.base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"o-tool.base.d.ts","sourceRoot":"","sources":["../../src/o-tool.base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,KAAK,EAGL,QAAQ,EAET,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAInE;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO,CAAC,OAAO,CAAkB;IAEjC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAY7C,mBAAmB,IAAI,GAAG,EAAE;IAI5B,OAAO,CACL,cAAc,EAAE,QAAQ,EACxB,aAAa,EAAE,QAAQ,GACtB,OAAO,CAAC,WAAW,CAAC;IAGvB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAInB,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA8B3D,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BjE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS/B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIvD,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBnE,KAAK;;;;;;;IA4FL,MAAM;;;;CAQb"}
+{"version":3,"file":"o-tool.base.d.ts","sourceRoot":"","sources":["../../src/o-tool.base.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,WAAW,EACX,KAAK,EAGL,QAAQ,EAER,oBAAoB,EACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAInE;;;;GAIG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAClC,OAAO,CAAC,OAAO,CAAkB;IAEjC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAY7C,mBAAmB,IAAI,GAAG,EAAE;IAI5B,OAAO,CACL,cAAc,EAAE,QAAQ,EACxB,aAAa,EAAE,QAAQ,GACtB,OAAO,CAAC,WAAW,CAAC;IAGvB,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAG3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAIzB,SAAS,CAAC,yBAAyB,IAAI,oBAAoB;IAOrD,OAAO,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA8B3D,GAAG,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA2BjE,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAS/B,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAIvD,UAAU,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBnE,KAAK;;;;;;;IA4FL,MAAM;;;;CAQb"}

package/dist/src/o-tool.base.js

@@ -38,6 +38,9 @@ export class oToolBase extends oCore {
     register() {
         throw new oError(oErrorCodes.NOT_IMPLEMENTED, 'Register not implemented');
     }
+    createNotificationManager() {
+        throw new oError(oErrorCodes.NOT_IMPLEMENTED, 'createNotificationManager not implemented');
+    }
     async execute(req, stream) {
         let request = req;
         const requestConfig = req.toJSON();

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

@@ -1 +1 @@
-{"version":3,"file":"o-tool.d.ts","sourceRoot":"","sources":["../../src/o-tool.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAoH7E"}
+{"version":3,"file":"o-tool.d.ts","sourceRoot":"","sources":["../../src/o-tool.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAI7C;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,SAAS,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAgQ7E"}

package/dist/src/o-tool.js

@@ -1,4 +1,4 @@
-import { oError, oErrorCodes, oRequest, } from '@olane/o-core';
+import { oAddress, oError, oErrorCodes, oRequest, oNotificationEvent, } from '@olane/o-core';
 /**
  * oTool is a mixin that extends the base class and implements the oTool interface
  * @param Base - The base class to extend
@@ -96,5 +96,112 @@ export function oTool(Base) {
                 message: 'Request cancelled',
             };
         }
+        /**
+         * Emit a notification event to all subscribers
+         * Can be called remotely to trigger events on this node
+         */
+        async _tool_notify(request) {
+            const { eventType, eventData } = request.params;
+            if (!eventType) {
+                throw new oError(oErrorCodes.MISSING_PARAMETERS, 'eventType is required');
+            }
+            this.logger.debug(`Received remote notification: ${eventType}`);
+            // Create a generic notification event from the data
+            if (this.notificationManager) {
+                // Create a custom event class
+                class CustomNotificationEvent extends oNotificationEvent {
+                    constructor(type, source, data) {
+                        super({
+                            type,
+                            source,
+                            metadata: data || {},
+                        });
+                    }
+                }
+                // Emit as a custom event with the provided data
+                const sourceAddress = request.params.source
+                    ? new oAddress(request.params.source)
+                    : new oAddress('o://unknown');
+                const event = new CustomNotificationEvent(eventType, sourceAddress, eventData);
+                this.notificationManager.emit(event);
+            }
+            return {
+                success: true,
+                message: `Notification ${eventType} emitted`,
+            };
+        }
+        /**
+         * Get connection health status (for nodes with heartbeat monitoring)
+         */
+        async _tool_get_connection_health(request) {
+            // Check if this node has a connectionHeartbeatManager
+            const heartbeatManager = this.connectionHeartbeatManager;
+            if (!heartbeatManager) {
+                return {
+                    enabled: false,
+                    message: 'Connection heartbeat not enabled on this node',
+                };
+            }
+            const healthStatus = heartbeatManager.getHealthStatus();
+            return {
+                enabled: true,
+                connections: healthStatus.map((h) => ({
+                    address: h.address.toString(),
+                    peerId: h.peerId,
+                    status: h.status,
+                    lastSuccessfulPing: new Date(h.lastSuccessfulPing).toISOString(),
+                    consecutiveFailures: h.consecutiveFailures,
+                    averageLatencyMs: Math.round(h.averageLatency),
+                })),
+            };
+        }
+        /**
+         * Get leader health status and retry configuration
+         */
+        async _tool_get_leader_health(request) {
+            const heartbeatManager = this.connectionHeartbeatManager;
+            const leaderRequestWrapper = this.leaderRequestWrapper;
+            if (!heartbeatManager && !leaderRequestWrapper) {
+                return {
+                    enabled: false,
+                    message: 'Leader monitoring not available on this node',
+                };
+            }
+            const result = {
+                heartbeat: { enabled: false },
+                retry: { enabled: false },
+            };
+            // Get heartbeat health for leader
+            if (heartbeatManager) {
+                const config = heartbeatManager.getConfig();
+                result.heartbeat.enabled = config.checkLeader;
+                if (config.checkLeader) {
+                    const healthStatus = heartbeatManager.getHealthStatus();
+                    const leaderHealth = healthStatus.find((h) => h.address.toString().includes('leader'));
+                    if (leaderHealth) {
+                        result.heartbeat.status = leaderHealth.status;
+                        result.heartbeat.lastSuccessfulPing = new Date(leaderHealth.lastSuccessfulPing).toISOString();
+                        result.heartbeat.consecutiveFailures =
+                            leaderHealth.consecutiveFailures;
+                        result.heartbeat.averageLatencyMs = Math.round(leaderHealth.averageLatency);
+                    }
+                    else {
+                        result.heartbeat.status = 'not_monitored';
+                    }
+                }
+            }
+            // Get retry configuration
+            if (leaderRequestWrapper) {
+                const retryConfig = leaderRequestWrapper.getConfig();
+                result.retry = {
+                    enabled: retryConfig.enabled,
+                    maxAttempts: retryConfig.maxAttempts,
+                    baseDelayMs: retryConfig.baseDelayMs,
+                    maxDelayMs: retryConfig.maxDelayMs,
+                    timeoutMs: retryConfig.timeoutMs,
+                };
+            }
+            return result;
+        }
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@olane/o-tool",
-  "version": "0.7.12-alpha.1",
+  "version": "0.7.12-alpha.11",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",
@@ -54,10 +54,11 @@
     "typescript": "^5.8.3"
   },
   "dependencies": {
-    "@olane/o-config": "^0.7.11",
-    "@olane/o-core": "^0.7.11",
-    "@olane/o-protocol": "^0.7.11",
+    "@olane/o-config": "0.7.12-alpha.11",
+    "@olane/o-core": "0.7.12-alpha.11",
+    "@olane/o-protocol": "0.7.12-alpha.11",
     "debug": "^4.4.1",
     "dotenv": "^16.5.0"
-  }
+  },
+  "gitHead": "59f569c0b70a69ea7695f73fa568599ff4a7cb10"
 }