@olane/o-core 0.6.13 → 0.7.2

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

@@ -0,0 +1,190 @@
+import { oCoreConfig } from './interfaces/o-core.config.js';
+import { NodeState } from './interfaces/state.enum.js';
+import { oAddress } from '../router/o-address.js';
+import { NodeType } from './interfaces/node-type.enum.js';
+import { oConnectionManager } from '../connection/o-connection-manager.js';
+import { oResponse } from '../connection/o-response.js';
+import { oConnection } from '../connection/o-connection.js';
+import { oMethod } from '@olane/o-protocol';
+import { oDependency } from './o-dependency.js';
+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 { oTransport } from '../transports/o-transport.js';
+import { oRouter } from '../router/o-router.js';
+import { oRequest } from '../connection/o-request.js';
+export declare abstract class oCore extends oObject {
+    readonly config: oCoreConfig;
+    address: oAddress;
+    state: NodeState;
+    errors: Error[];
+    connectionManager: oConnectionManager;
+    hierarchyManager: oHierarchyManager;
+    metrics: oMetrics;
+    requestManager: oRequestManager;
+    router: oRouter;
+    constructor(config: oCoreConfig);
+    get isLeader(): boolean;
+    get leader(): oAddress | null;
+    abstract configureTransports(): any[];
+    /**
+     * Sends a request to a remote node in the O-Lane network using the specified address and optional data payload.
+     *
+     * This method handles the complete communication flow:
+     * 1. Validates the target address format
+     * 2. Resolves the routing path through the network
+     * 3. Establishes a connection to the target node
+     * 4. Sends the request payload and waits for response
+     * 5. Handles errors and throws them as oError instances
+     *
+     * @param address - The target node address in O-Lane format (must start with 'o://')
+     * @param data - Optional request data containing method, parameters, and request ID
+     * @param data.method - The method name to invoke on the target node
+     * @param data.params - Key-value pairs of parameters to pass to the method
+     * @param data.id - Unique identifier for the request (for tracking purposes)
+     * @returns Promise that resolves to an oResponse containing the result from the target node
+     * @throws {Error} When the address is invalid (doesn't pass validation)
+     * @throws {oError} When the target node returns an error response
+     *
+     * @example
+     * ```typescript
+     * // Basic usage - call a method on a remote node
+     * const response = await node.use(
+     *   new oAddress('o://calculator/add'),
+     *   {
+     *     method: 'add',
+     *     params: { a: 5, b: 3 },
+     *     id: 'calc-001'
+     *   }
+     * );
+     * console.log(response.result); // { result: 8 }
+     *
+     * // Minimal usage - just specify the address
+     * const response = await node.use(
+     *   new oAddress('o://status/health')
+     * );
+     * console.log(response.result); // { status: 'healthy' }
+     *
+     * // Error handling
+     * try {
+     *   const response = await node.use(
+     *     new oAddress('o://calculator/divide'),
+     *     { method: 'divide', params: { a: 10, b: 0 } }
+     *   );
+     * } catch (error) {
+     *   if (error instanceof oError) {
+     *     console.error(`Node error ${error.code}: ${error.message}`);
+     *   } else {
+     *     console.error('Invalid address or connection error:', error.message);
+     *   }
+     * }
+     * ```
+     */
+    use(address: oAddress, data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<oResponse>;
+    abstract execute(request: oRequest): Promise<any>;
+    useSelf(data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<oResponse>;
+    useChild(childAddress: oAddress, data?: {
+        method?: string;
+        params?: {
+            [key: string]: any;
+        };
+        id?: string;
+    }): Promise<oResponse>;
+    addChildNode(node: oCore): void;
+    removeChildNode(node: oCore): void;
+    abstract connect(nextHopAddress: oAddress, targetAddress: oAddress): Promise<oConnection>;
+    abstract initializeRouter(): void;
+    abstract unregister(): Promise<void>;
+    abstract register(): Promise<void>;
+    initialize(): Promise<void>;
+    get isRunning(): boolean;
+    /**
+     * Starts the node by transitioning through initialization and registration phases.
+     *
+     * This method performs the following operations in sequence:
+     * 1. Validates that the node is in STOPPED state
+     * 2. Sets state to STARTING
+     * 3. Calls initialize() to set up the node's core components
+     * 4. Attempts registration with the network (registration errors are logged but don't fail startup)
+     * 5. Sets state to RUNNING on success
+     *
+     * @throws {Error} If the node is not in STOPPED state or initialization fails
+     * @returns {Promise<void>} Resolves when the node is successfully started and running
+     *
+     * @example
+     * ```typescript
+     * const node = new oNode(config);
+     * try {
+     *   await node.start();
+     *   console.log('Node is now running');
+     * } catch (error) {
+     *   console.error('Failed to start node:', error);
+     * }
+     * ```
+     *
+     * @remarks
+     * - If the node is already running or starting, the method will log a warning and return early
+     * - Registration failures are logged but do not prevent the node from starting
+     * - On any initialization error, the node state is set to ERROR and teardown() is called
+     * - The node must be in STOPPED state before calling this method
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the node by performing cleanup and transitioning to a stopped state.
+     *
+     * This method performs the following operations in sequence:
+     * 1. Sets state to STOPPING
+     * 2. Calls teardown() to clean up node resources and connections
+     * 3. Sets state to STOPPED on successful completion
+     *
+     * @throws {Error} If teardown operations fail, the node state will be set to ERROR
+     * @returns {Promise<void>} Resolves when the node is successfully stopped
+     *
+     * @example
+     * ```typescript
+     * const node = new oNode(config);
+     * await node.start();
+     *
+     * // Later, when shutting down
+     * try {
+     *   await node.stop();
+     *   console.log('Node stopped successfully');
+     * } catch (error) {
+     *   console.error('Failed to stop node:', error);
+     * }
+     * ```
+     *
+     * @remarks
+     * - This method can be called from any node state
+     * - If teardown fails, errors are logged and the node state is set to ERROR
+     * - All cleanup operations are performed through the teardown() method
+     * - The method will attempt to stop gracefully even if the node is in an error state
+     */
+    stop(): Promise<void>;
+    teardown(): Promise<void>;
+    get dependencies(): oDependency[];
+    get methods(): {
+        [key: string]: oMethod;
+    };
+    get description(): string;
+    get staticAddress(): oAddress;
+    get type(): NodeType;
+    get transports(): oTransport[];
+    get parent(): oAddress | null;
+    get parentTransports(): oTransport[];
+    whoami(): Promise<any>;
+}
+//# sourceMappingURL=o-core.d.ts.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,334 @@
+import { NodeState } from './interfaces/state.enum.js';
+import { oAddress } from '../router/o-address.js';
+import { NodeType } from './interfaces/node-type.enum.js';
+import { oDependency } from './o-dependency.js';
+import { oError } from '../error/o-error.js';
+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';
+export class oCore extends oObject {
+    constructor(config) {
+        super((config.name ? `:${config.name}` : '') + ':' + config.address.toString());
+        this.config = config;
+        this.state = NodeState.STOPPED;
+        this.errors = [];
+        this.metrics = new oMetrics();
+        this.requestManager = new oRequestManager();
+        this.address = config.address || new oAddress('o://node');
+        this.hierarchyManager = new oHierarchyManager({
+            leaders: this.config.leader ? [this.config.leader] : [],
+            parents: this.config.parent ? [this.config.parent] : [],
+        });
+    }
+    get isLeader() {
+        return this.config.type === NodeType.LEADER;
+    }
+    get leader() {
+        return this.isLeader ? this.address : this.config?.leader || null;
+    }
+    /**
+     * Sends a request to a remote node in the O-Lane network using the specified address and optional data payload.
+     *
+     * This method handles the complete communication flow:
+     * 1. Validates the target address format
+     * 2. Resolves the routing path through the network
+     * 3. Establishes a connection to the target node
+     * 4. Sends the request payload and waits for response
+     * 5. Handles errors and throws them as oError instances
+     *
+     * @param address - The target node address in O-Lane format (must start with 'o://')
+     * @param data - Optional request data containing method, parameters, and request ID
+     * @param data.method - The method name to invoke on the target node
+     * @param data.params - Key-value pairs of parameters to pass to the method
+     * @param data.id - Unique identifier for the request (for tracking purposes)
+     * @returns Promise that resolves to an oResponse containing the result from the target node
+     * @throws {Error} When the address is invalid (doesn't pass validation)
+     * @throws {oError} When the target node returns an error response
+     *
+     * @example
+     * ```typescript
+     * // Basic usage - call a method on a remote node
+     * const response = await node.use(
+     *   new oAddress('o://calculator/add'),
+     *   {
+     *     method: 'add',
+     *     params: { a: 5, b: 3 },
+     *     id: 'calc-001'
+     *   }
+     * );
+     * console.log(response.result); // { result: 8 }
+     *
+     * // Minimal usage - just specify the address
+     * const response = await node.use(
+     *   new oAddress('o://status/health')
+     * );
+     * console.log(response.result); // { status: 'healthy' }
+     *
+     * // Error handling
+     * try {
+     *   const response = await node.use(
+     *     new oAddress('o://calculator/divide'),
+     *     { method: 'divide', params: { a: 10, b: 0 } }
+     *   );
+     * } catch (error) {
+     *   if (error instanceof oError) {
+     *     console.error(`Node error ${error.code}: ${error.message}`);
+     *   } else {
+     *     console.error('Invalid address or connection error:', error.message);
+     *   }
+     * }
+     * ```
+     */
+    async use(address, data) {
+        if (!this.isRunning) {
+            throw new Error('Node is not running');
+        }
+        if (!address.validate()) {
+            throw new Error('Invalid address');
+        }
+        this.logger.debug('Using address: ', address.toString());
+        if (address.toStaticAddress().equals(this.address.toStaticAddress())) {
+            return this.useSelf(data);
+        }
+        const { nextHopAddress, targetAddress } = await this.router.translate(address, this);
+        if (nextHopAddress.toStaticAddress().equals(this.address.toStaticAddress())) {
+            return this.useSelf(data);
+        }
+        const connection = await this.connect(nextHopAddress, targetAddress);
+        // communicate the payload to the target node
+        const response = await connection.send({
+            address: targetAddress?.toString() || '',
+            payload: data || {},
+            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);
+        }
+        return response;
+    }
+    async useSelf(data) {
+        if (!this.isRunning) {
+            throw new Error('Node is not running');
+        }
+        // let's call our own tool
+        this.logger.debug('Calling ourselves, skipping...', data);
+        const request = new oRequest({
+            method: data?.method,
+            params: {
+                _connectionId: 0,
+                _requestMethod: data?.method,
+                ...data?.params,
+            },
+            id: 0,
+        });
+        let success = true;
+        const result = await this.execute(request).catch((error) => {
+            this.logger.error('Error executing tool: ', error);
+            success = false;
+            const responseError = error instanceof oError
+                ? error
+                : new oError(oErrorCodes.UNKNOWN, error.message);
+            return {
+                error: responseError.toJSON(),
+            };
+        });
+        if (success) {
+            this.metrics.successCount++;
+        }
+        else {
+            this.metrics.errorCount++;
+        }
+        return CoreUtils.buildResponse(request, result, result?.error);
+    }
+    async useChild(childAddress, data) {
+        if (!this.isRunning) {
+            throw new Error('Node is not running');
+        }
+        if (!childAddress.transports) {
+            this.logger.warn('Child address has no transports, this might break!');
+        }
+        const connection = await this.connect(childAddress, childAddress);
+        // communicate the payload to the target node
+        const response = await connection.send({
+            address: childAddress?.toString() || '',
+            payload: data || {},
+            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);
+        }
+        return response;
+    }
+    // hierarchy
+    addChildNode(node) {
+        this.logger.debug('Adding virtual node: ' + node.address.toString());
+        this.hierarchyManager.addChild(node.address);
+    }
+    removeChildNode(node) {
+        this.hierarchyManager.removeChild(node.address);
+    }
+    // initialize
+    async initialize() { }
+    get isRunning() {
+        return this.state < NodeState.STOPPING;
+    }
+    /**
+     * Starts the node by transitioning through initialization and registration phases.
+     *
+     * This method performs the following operations in sequence:
+     * 1. Validates that the node is in STOPPED state
+     * 2. Sets state to STARTING
+     * 3. Calls initialize() to set up the node's core components
+     * 4. Attempts registration with the network (registration errors are logged but don't fail startup)
+     * 5. Sets state to RUNNING on success
+     *
+     * @throws {Error} If the node is not in STOPPED state or initialization fails
+     * @returns {Promise<void>} Resolves when the node is successfully started and running
+     *
+     * @example
+     * ```typescript
+     * const node = new oNode(config);
+     * try {
+     *   await node.start();
+     *   console.log('Node is now running');
+     * } catch (error) {
+     *   console.error('Failed to start node:', error);
+     * }
+     * ```
+     *
+     * @remarks
+     * - If the node is already running or starting, the method will log a warning and return early
+     * - Registration failures are logged but do not prevent the node from starting
+     * - On any initialization error, the node state is set to ERROR and teardown() is called
+     * - The node must be in STOPPED state before calling this method
+     */
+    async start() {
+        if (this.state !== NodeState.STOPPED) {
+            this.logger.warn('Node is not stopped, skipping start');
+            return;
+        }
+        this.state = NodeState.STARTING;
+        try {
+            await this.initialize();
+            await this.register().catch((error) => {
+                this.logger.error('Failed to register node', error);
+            });
+            this.state = NodeState.RUNNING;
+        }
+        catch (error) {
+            this.logger.error('Failed to start node', error);
+            this.errors.push(error);
+            this.state = NodeState.ERROR;
+            await this.teardown();
+        }
+    }
+    /**
+     * Stops the node by performing cleanup and transitioning to a stopped state.
+     *
+     * This method performs the following operations in sequence:
+     * 1. Sets state to STOPPING
+     * 2. Calls teardown() to clean up node resources and connections
+     * 3. Sets state to STOPPED on successful completion
+     *
+     * @throws {Error} If teardown operations fail, the node state will be set to ERROR
+     * @returns {Promise<void>} Resolves when the node is successfully stopped
+     *
+     * @example
+     * ```typescript
+     * const node = new oNode(config);
+     * await node.start();
+     *
+     * // Later, when shutting down
+     * try {
+     *   await node.stop();
+     *   console.log('Node stopped successfully');
+     * } catch (error) {
+     *   console.error('Failed to stop node:', error);
+     * }
+     * ```
+     *
+     * @remarks
+     * - This method can be called from any node state
+     * - If teardown fails, errors are logged and the node state is set to ERROR
+     * - All cleanup operations are performed through the teardown() method
+     * - The method will attempt to stop gracefully even if the node is in an error state
+     */
+    async stop() {
+        this.logger.debug('Stop node called...');
+        if (this.state !== NodeState.RUNNING) {
+            this.logger.warn('Node is not running, skipping stop');
+            return;
+        }
+        this.state = NodeState.STOPPING;
+        try {
+            await this.teardown();
+            this.state = NodeState.STOPPED;
+            this.logger.debug('Node stopped!');
+        }
+        catch (error) {
+            this.errors.push(error);
+            this.state = NodeState.ERROR;
+            this.logger.error('Node failed to stop', error);
+        }
+    }
+    async teardown() {
+        this.logger.debug('Tearing down node...');
+        this.state = NodeState.STOPPING;
+        for (const child of this.hierarchyManager.children) {
+            this.logger.debug('Stopping child: ' + child.toString());
+            await this.useChild(child, {
+                method: 'stop',
+                params: {},
+            }).catch((error) => {
+                if (error.message === 'No data received') {
+                    // ignore
+                }
+                else {
+                    this.logger.error('Potential error stopping child', error);
+                }
+            });
+            this.logger.debug('Child stopped: ' + child.toString());
+        }
+        this.hierarchyManager.clear();
+    }
+    get dependencies() {
+        return this.config.dependencies?.map((d) => new oDependency(d)) || [];
+    }
+    get methods() {
+        return this.config.methods || {};
+    }
+    get description() {
+        return this.config.description || '';
+    }
+    get staticAddress() {
+        return this.config.address;
+    }
+    get type() {
+        return this.config.type || NodeType.UNKNOWN;
+    }
+    get transports() {
+        return [];
+    }
+    get parent() {
+        return this.config.parent || null;
+    }
+    get parentTransports() {
+        return this.parent?.transports || [];
+    }
+    async whoami() {
+        return {
+            address: this.address.toString(),
+            type: this.type,
+            description: this.description,
+            methods: this.methods,
+        };
+    }
+}

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

@@ -0,0 +1,7 @@
+import { Logger } from '../utils/logger.js';
+export declare class oObject {
+    logger: Logger;
+    constructor(name?: string);
+    static log(...args: any[]): void;
+}
+//# sourceMappingURL=o-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"o-object.d.ts","sourceRoot":"","sources":["../../../src/core/o-object.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,qBAAa,OAAO;IACX,MAAM,EAAE,MAAM,CAAC;gBACV,IAAI,CAAC,EAAE,MAAM;IAIzB,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE;CAI1B"}

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

@@ -0,0 +1,10 @@
+import { Logger } from '../utils/logger.js';
+export class oObject {
+    constructor(name) {
+        this.logger = new Logger(this.constructor.name + (name ? `:${name}` : ''));
+    }
+    static log(...args) {
+        const l = new Logger(this.constructor.name);
+        l.debug(...args);
+    }
+}

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

@@ -1,16 +1,18 @@
-export declare enum oToolErrorCodes {
-    TOOL_ERROR = 1001,
-    TOOL_NOT_FOUND = 1002,
-    TOOL_NOT_IMPLEMENTED = 1003,
-    TOOL_NOT_CONFIGURED = 1004,
-    TOOL_NOT_AUTHORIZED = 1005,
-    TOOL_MISSING_PARAMETERS = 1006,
-    TOOL_INVALID_PARAMETERS = 1007,
-    TOOL_INVALID_RESPONSE = 1008,
-    TOOL_INVALID_REQUEST = 1009,
-    TOOL_INVALID_STATE = 1010,
-    TOOL_INVALID_ACTION = 1011,
-    TOOL_INVALID_CREDENTIALS = 1012,
-    TOOL_TRANSPORT_NOT_SUPPORTED = 1013
+export declare enum oErrorCodes {
+    UNKNOWN = 1001,
+    NOT_FOUND = 1002,
+    NOT_IMPLEMENTED = 1003,
+    NOT_CONFIGURED = 1004,
+    NOT_AUTHORIZED = 1005,
+    MISSING_PARAMETERS = 1006,
+    INVALID_PARAMETERS = 1007,
+    INVALID_RESPONSE = 1008,
+    INVALID_REQUEST = 1009,
+    INVALID_STATE = 1010,
+    INVALID_ACTION = 1011,
+    INVALID_CREDENTIALS = 1012,
+    TRANSPORT_NOT_SUPPORTED = 1013,
+    FAILED_TO_DIAL_TARGET = 1014,
+    INVALID_CAPABILITY = 1015
 }
 //# 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,eAAe;IACzB,UAAU,OAAO;IACjB,cAAc,OAAO;IACrB,oBAAoB,OAAO;IAC3B,mBAAmB,OAAO;IAC1B,mBAAmB,OAAO;IAC1B,uBAAuB,OAAO;IAC9B,uBAAuB,OAAO;IAC9B,qBAAqB,OAAO;IAC5B,oBAAoB,OAAO;IAC3B,kBAAkB,OAAO;IACzB,mBAAmB,OAAO;IAC1B,wBAAwB,OAAO;IAC/B,4BAA4B,OAAO;CACpC"}
+{"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;CAC1B"}

package/dist/src/error/enums/codes.error.js

@@ -1,16 +1,18 @@
-export var oToolErrorCodes;
-(function (oToolErrorCodes) {
-    oToolErrorCodes[oToolErrorCodes["TOOL_ERROR"] = 1001] = "TOOL_ERROR";
-    oToolErrorCodes[oToolErrorCodes["TOOL_NOT_FOUND"] = 1002] = "TOOL_NOT_FOUND";
-    oToolErrorCodes[oToolErrorCodes["TOOL_NOT_IMPLEMENTED"] = 1003] = "TOOL_NOT_IMPLEMENTED";
-    oToolErrorCodes[oToolErrorCodes["TOOL_NOT_CONFIGURED"] = 1004] = "TOOL_NOT_CONFIGURED";
-    oToolErrorCodes[oToolErrorCodes["TOOL_NOT_AUTHORIZED"] = 1005] = "TOOL_NOT_AUTHORIZED";
-    oToolErrorCodes[oToolErrorCodes["TOOL_MISSING_PARAMETERS"] = 1006] = "TOOL_MISSING_PARAMETERS";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_PARAMETERS"] = 1007] = "TOOL_INVALID_PARAMETERS";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_RESPONSE"] = 1008] = "TOOL_INVALID_RESPONSE";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_REQUEST"] = 1009] = "TOOL_INVALID_REQUEST";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_STATE"] = 1010] = "TOOL_INVALID_STATE";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_ACTION"] = 1011] = "TOOL_INVALID_ACTION";
-    oToolErrorCodes[oToolErrorCodes["TOOL_INVALID_CREDENTIALS"] = 1012] = "TOOL_INVALID_CREDENTIALS";
-    oToolErrorCodes[oToolErrorCodes["TOOL_TRANSPORT_NOT_SUPPORTED"] = 1013] = "TOOL_TRANSPORT_NOT_SUPPORTED";
-})(oToolErrorCodes || (oToolErrorCodes = {}));
+export var oErrorCodes;
+(function (oErrorCodes) {
+    oErrorCodes[oErrorCodes["UNKNOWN"] = 1001] = "UNKNOWN";
+    oErrorCodes[oErrorCodes["NOT_FOUND"] = 1002] = "NOT_FOUND";
+    oErrorCodes[oErrorCodes["NOT_IMPLEMENTED"] = 1003] = "NOT_IMPLEMENTED";
+    oErrorCodes[oErrorCodes["NOT_CONFIGURED"] = 1004] = "NOT_CONFIGURED";
+    oErrorCodes[oErrorCodes["NOT_AUTHORIZED"] = 1005] = "NOT_AUTHORIZED";
+    oErrorCodes[oErrorCodes["MISSING_PARAMETERS"] = 1006] = "MISSING_PARAMETERS";
+    oErrorCodes[oErrorCodes["INVALID_PARAMETERS"] = 1007] = "INVALID_PARAMETERS";
+    oErrorCodes[oErrorCodes["INVALID_RESPONSE"] = 1008] = "INVALID_RESPONSE";
+    oErrorCodes[oErrorCodes["INVALID_REQUEST"] = 1009] = "INVALID_REQUEST";
+    oErrorCodes[oErrorCodes["INVALID_STATE"] = 1010] = "INVALID_STATE";
+    oErrorCodes[oErrorCodes["INVALID_ACTION"] = 1011] = "INVALID_ACTION";
+    oErrorCodes[oErrorCodes["INVALID_CREDENTIALS"] = 1012] = "INVALID_CREDENTIALS";
+    oErrorCodes[oErrorCodes["TRANSPORT_NOT_SUPPORTED"] = 1013] = "TRANSPORT_NOT_SUPPORTED";
+    oErrorCodes[oErrorCodes["FAILED_TO_DIAL_TARGET"] = 1014] = "FAILED_TO_DIAL_TARGET";
+    oErrorCodes[oErrorCodes["INVALID_CAPABILITY"] = 1015] = "INVALID_CAPABILITY";
+})(oErrorCodes || (oErrorCodes = {}));

package/dist/src/error/index.d.ts

@@ -1,3 +1,3 @@
-export * from './tool.error.js';
+export * from './o-error.js';
 export * from './enums/codes.error.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/error/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/error/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,wBAAwB,CAAC"}

package/dist/src/error/index.js

@@ -1,2 +1,2 @@
-export * from './tool.error.js';
+export * from './o-error.js';
 export * from './enums/codes.error.js';

package/dist/src/error/interfaces/o-error.interface.d.ts

@@ -0,0 +1,6 @@
+export interface oErrorInterface {
+    code: number;
+    message: string;
+    details?: any;
+}
+//# sourceMappingURL=o-error.interface.d.ts.map

package/dist/src/error/interfaces/o-error.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"o-error.interface.d.ts","sourceRoot":"","sources":["../../../../src/error/interfaces/o-error.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,GAAG,CAAC;CACf"}