@directivegames/genesys.js 3.1.24

package/dist/src/navigation/RecastNavigationServer.js

@@ -0,0 +1,325 @@
+/**
+ * RecastNavigationServer integrates the `recast-navigation` library for AI pathfinding.
+ *
+ * It wraps Recast's navmesh generation and query APIs so actors can request
+ * paths or validate positions against the generated mesh. The server maintains
+ * a single navigation mesh and lazily creates query objects as needed. By
+ * centralizing this logic, the rest of the engine can issue navigation requests
+ * without importing Recast-specific types directly.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Feed a simplified THREE.Mesh into `createNavigationMesh` to build the navmesh.
+ * - Call `calculatePath` each frame an agent needs a new route.
+ * - Use `isPointOnNavigationMesh` or `getClosestPointOnNavigationMesh` before repositioning actors.
+ * - Remember to destroy the server when changing scenes to avoid memory leaks.
+ */
+import { DebugDrawer, threeToSoloNavMesh } from '@recast-navigation/three';
+import { exportNavMesh, importNavMesh, init, NavMesh, NavMeshQuery } from 'recast-navigation';
+import { generateSoloNavMesh } from 'recast-navigation/generators';
+import * as THREE from 'three';
+import { deinterleaveGeometry } from 'three/examples/jsm/utils/BufferGeometryUtils.js';
+import { NAVMESH_EXT } from '../const.js';
+import { projectInfo } from '../storage/projectContext.js';
+import { AssetPath } from '../storage/storageProvider.js';
+export class RecastNavigationServer {
+    constructor() {
+        // Set from NavigationOptions
+        Object.defineProperty(this, "options", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        // Runtime properties
+        Object.defineProperty(this, "navigationMesh", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "navMeshQuery", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+    }
+    // TODO: use a proper type for this
+    static get DEFAULT_OPTIONS() {
+        return {
+            borderSize: 0,
+            cs: 1,
+            ch: 0.2,
+            walkableSlopeAngle: 35,
+            walkableHeight: 1,
+            walkableClimb: 1,
+            walkableRadius: 1,
+            maxEdgeLen: 12,
+            maxSimplificationError: 1.3,
+            minRegionArea: 8,
+            mergeRegionArea: 20,
+            maxVertsPerPoly: 6,
+            detailSampleDist: 6,
+            detailSampleMaxError: 1,
+        };
+    }
+    initialize(options) {
+        this.options = options.options;
+        return init().then(() => true);
+    }
+    destroy() {
+        // Properly dispose of WASM objects to free memory
+        if (this.navMeshQuery) {
+            this.navMeshQuery.destroy();
+            this.navMeshQuery = null;
+        }
+        if (this.navigationMesh) {
+            this.navigationMesh.destroy();
+            this.navigationMesh = null;
+        }
+    }
+    createNavigationMesh(mesh) {
+        const positions = mesh.geometry.attributes.position.array;
+        const indices = mesh.geometry.index?.array;
+        if (!positions) {
+            console.error('[RecastNavigationServer] createNavigationMesh failed: Positions could not be determined from mesh.');
+            return Promise.resolve(false);
+        }
+        if (!indices) {
+            console.error('[RecastNavigationServer] createNavigationMesh failed: Indices could not be determined from mesh.');
+            return Promise.resolve(false);
+        }
+        const result = generateSoloNavMesh(positions, indices, this.options);
+        this.setNavigationMesh(result.navMesh);
+        return Promise.resolve(true);
+    }
+    createNavigationMeshFromMeshes(meshes, overrideOptions) {
+        console.log(`[RecastNavigationServer] Creating navigation mesh from ${meshes.length} meshes ...`);
+        if (meshes.length === 0) {
+            console.warn('[RecastNavigationServer] No meshes provided for navigation mesh generation');
+            return Promise.resolve(false);
+        }
+        try {
+            // Deinterleave meshes before processing to ensure proper geometry formatting
+            const deinterleavedMeshes = this.deinterleaveMeshes(meshes);
+            const result = threeToSoloNavMesh(deinterleavedMeshes, overrideOptions ?? this.options);
+            if (result.success) {
+                this.setNavigationMesh(result.navMesh);
+                console.log('[RecastNavigationServer] Navigation mesh created successfully');
+            }
+            else {
+                const errorMessage = result.error || 'Unknown error during navigation mesh generation';
+                console.error('[RecastNavigationServer] threeToSoloNavMesh failed:', errorMessage);
+            }
+            return Promise.resolve(result.success);
+        }
+        catch (error) {
+            console.error('[RecastNavigationServer] Runtime error while creating navigation mesh:', error);
+            return Promise.resolve(false);
+        }
+    }
+    setNavigationMesh(navMesh) {
+        if (!navMesh) {
+            console.error('[RecastNavigationServer] setNavigationMesh: Navigation mesh not initialized');
+            return;
+        }
+        if (navMesh instanceof NavMesh) {
+            // Clean up previous instances to prevent memory leaks
+            if (this.navMeshQuery) {
+                this.navMeshQuery.destroy();
+                this.navMeshQuery = null;
+            }
+            if (this.navigationMesh) {
+                this.navigationMesh.destroy();
+                this.navigationMesh = null;
+            }
+            // Set new navigation mesh and create query instance
+            this.navigationMesh = navMesh;
+            this.navMeshQuery = new NavMeshQuery(this.navigationMesh);
+        }
+        else {
+            console.error('[RecastNavigationServer] setNavigationMesh: Navigation mesh is not a valid NavMesh instance');
+        }
+    }
+    /**
+     * Clear the current navigation mesh
+     */
+    clearNavigationMesh() {
+        console.log('[RecastNavigationServer] clearNavigationMesh: Clearing current navigation mesh');
+        // Clean up previous instances to prevent memory leaks
+        if (this.navMeshQuery) {
+            this.navMeshQuery.destroy();
+            this.navMeshQuery = null;
+        }
+        if (this.navigationMesh) {
+            this.navigationMesh.destroy();
+            this.navigationMesh = null;
+        }
+    }
+    /**
+     * Deinterleaves mesh geometry data only if it actually has interleaved buffer attributes.
+     * Uses the proper deinterleaveGeometry utility that checks for InterleavedBufferAttribute.
+     * @param meshes Array of THREE.Mesh objects to potentially deinterleave
+     * @returns Array of meshes with deinterleaved geometry data where needed
+     */
+    deinterleaveMeshes(meshes) {
+        return meshes.map(mesh => {
+            // Clone geometry first since deinterleaveGeometry modifies in-place
+            const clonedGeometry = mesh.geometry.clone();
+            deinterleaveGeometry(clonedGeometry);
+            // Just replace the geometry on the existing mesh
+            mesh.geometry = clonedGeometry;
+            return mesh;
+        });
+    }
+    calculatePath(start, end) {
+        if (!this.navigationMesh || !this.navMeshQuery) {
+            console.error('[RecastNavigationServer] calculatePath: Navigation mesh not initialized');
+            return [];
+        }
+        const startInfo = this.navMeshQuery.findNearestPoly(start);
+        const endInfo = this.navMeshQuery.findNearestPoly(end);
+        const pathResult = this.navMeshQuery.computePath(startInfo.nearestPoint, endInfo.nearestPoint);
+        return pathResult.path.map(point => new THREE.Vector3(point.x, point.y, point.z));
+    }
+    /**
+     * Checks if a point is on the navigation mesh
+     * @param point The point to check
+     * @returns True if the point is on the navigation mesh, false otherwise
+     */
+    isPointOnNavigationMesh(point) {
+        if (!this.navigationMesh || !this.navMeshQuery) {
+            console.error('[RecastNavigationServer] isPointOnNavigationMesh: Navigation mesh not initialized');
+            return false;
+        }
+        const result = this.navMeshQuery.findNearestPoly(point);
+        // Check if a valid polygon reference was found
+        // and if the point is directly over that polygon (isOverPoly property)
+        if (result.nearestRef && result.isOverPoly) {
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Gets the closest point on the navigation mesh to the specified point
+     * @param point The reference point
+     * @returns The closest point on the navigation mesh, or the original point if the navigation mesh is not initialized
+     */
+    getClosestPointOnNavigationMesh(point) {
+        if (!this.navigationMesh || !this.navMeshQuery) {
+            console.error('[RecastNavigationServer] getClosestPointOnNavigationMesh: Navigation mesh not initialized');
+            return point.clone();
+        }
+        const result = this.navMeshQuery.findNearestPoly(point);
+        if (result.nearestPoint) {
+            return new THREE.Vector3(result.nearestPoint.x, result.nearestPoint.y, result.nearestPoint.z);
+        }
+        // If no nearest point could be found, return the original point
+        return point.clone();
+    }
+    /**
+     * Create debug visualization for the navigation mesh
+     * @returns A DebugDrawer instance that can be added to the scene, or null if no navigation mesh exists
+     */
+    createDebugVisualization() {
+        if (!this.navigationMesh) {
+            console.warn('[RecastNavigationServer] createDebugVisualization: No navigation mesh available');
+            return null;
+        }
+        try {
+            const debugDrawer = new DebugDrawer();
+            debugDrawer.drawNavMesh(this.navigationMesh, 0);
+            return debugDrawer;
+        }
+        catch (error) {
+            console.error('[RecastNavigationServer] createDebugVisualization: Failed to create debug visualization:', error);
+            return null;
+        }
+    }
+    /**
+     * Export the current navigation mesh to a binary file
+     * @param scenePath The path to the scene file (used to determine navmesh file path)
+     * @returns Promise resolving to export result with data and filename
+     */
+    async exportNavigationMesh(scenePath) {
+        if (!this.navigationMesh) {
+            console.error('[RecastNavigationServer] exportNavigationMesh: No navigation mesh available');
+            return { success: false };
+        }
+        try {
+            // Use the proper recast-navigation exportNavMesh function
+            const navMeshData = exportNavMesh(this.navigationMesh);
+            console.log('[RecastNavigationServer] exportNavigationMesh: NavMesh serialized');
+            console.log('  Data size:', navMeshData.length, 'bytes');
+            // Determine filename - basing it off the scene path minus the scene extension
+            const filename = `${scenePath.initialPath.split('/').pop()?.replace(/\.[^.]+$/, '') ?? 'navmesh'}${NAVMESH_EXT}`;
+            // Convert Uint8Array to ArrayBuffer for consistency with other export APIs
+            // Ensure we return ArrayBuffer, not SharedArrayBuffer by creating a new buffer
+            const arrayBuffer = new ArrayBuffer(navMeshData.length);
+            new Uint8Array(arrayBuffer).set(navMeshData);
+            console.log(`[RecastNavigationServer] exportNavigationMesh: NavMesh data prepared for export as ${filename}`);
+            return { success: true, data: arrayBuffer, filename };
+        }
+        catch (error) {
+            console.error('[RecastNavigationServer] exportNavigationMesh: Export failed:', error);
+            return { success: false };
+        }
+    }
+    /**
+     * Import a navigation mesh from a binary file
+     * @param scenePath The path to the scene file (used to determine navmesh file path)
+     * @returns Promise resolving to success/failure
+     */
+    async importNavigationMesh(scenePath) {
+        try {
+            // Determine input path basing it off the scene path minus the scene extension
+            const pathWithoutExt = scenePath.initialPath.replace(/\.[^.]+$/, '');
+            const navmeshPath = `${pathWithoutExt}${NAVMESH_EXT}`;
+            // Load the NavMesh file
+            const provider = projectInfo.storageProvider;
+            if (!provider) {
+                console.error('[RecastNavigationServer] importNavigationMesh: No storage provider available');
+                return false;
+            }
+            const navMeshBuffer = await provider.downloadFileAsBuffer(new AssetPath(navmeshPath));
+            // Use the data-based import method
+            return await this.importNavigationMeshFromData(navMeshBuffer);
+        }
+        catch (error) {
+            console.error('[RecastNavigationServer] importNavigationMesh: Import failed:', error);
+            return false;
+        }
+    }
+    /**
+     * Import a navigation mesh from NavMesh data directly
+     * @param navMeshData The NavMesh data as ArrayBuffer (from recast-navigation export)
+     * @returns Promise resolving to success/failure
+     */
+    async importNavigationMeshFromData(navMeshData) {
+        try {
+            // Convert ArrayBuffer to Uint8Array for recast-navigation
+            const uint8Array = new Uint8Array(navMeshData);
+            console.log('[RecastNavigationServer] importNavigationMeshFromData: NavMesh data received');
+            console.log('  Data size:', uint8Array.length, 'bytes');
+            // Use the proper recast-navigation importNavMesh function
+            const result = importNavMesh(uint8Array);
+            if (!result || !result.navMesh) {
+                console.error('[RecastNavigationServer] importNavigationMeshFromData: Failed to import navigation mesh');
+                console.error('  importNavMesh result:', result);
+                return false;
+            }
+            // Set the new navigation mesh
+            this.navigationMesh = result.navMesh;
+            console.log('[RecastNavigationServer] Navigation mesh imported from data successfully');
+            return true;
+        }
+        catch (error) {
+            console.error('[RecastNavigationServer] importNavigationMeshFromData: Import failed:', error);
+            return false;
+        }
+    }
+    isReady() {
+        return this.navigationMesh !== null;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiUmVjYXN0TmF2aWdhdGlvblNlcnZlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9uYXZpZ2F0aW9uL1JlY2FzdE5hdmlnYXRpb25TZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFFSCxPQUFPLEVBQUUsV0FBVyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sMEJBQTBCLENBQUM7QUFDM0UsT0FBTyxFQUFFLGFBQWEsRUFBRSxhQUFhLEVBQUUsSUFBSSxFQUFFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUM5RixPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUNuRSxPQUFPLEtBQUssS0FBSyxNQUFNLE9BQU8sQ0FBQztBQUMvQixPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxpREFBaUQsQ0FBQztBQUV2RixPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sYUFBYSxDQUFDO0FBQzFDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSw4QkFBOEIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsU0FBUyxFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFNMUQsTUFBTSxPQUFPLHNCQUFzQjtJQUFuQztRQUNFLDZCQUE2QjtRQUNyQjs7Ozs7V0FBYTtRQUVyQixxQkFBcUI7UUFDYjs7OzttQkFBaUMsSUFBSTtXQUFDO1FBQ3RDOzs7O21CQUFvQyxJQUFJO1dBQUM7SUE2VW5ELENBQUM7SUEzVUMsbUNBQW1DO0lBQ25DLE1BQU0sS0FBSyxlQUFlO1FBQ3hCLE9BQU87WUFDTCxVQUFVLEVBQUUsQ0FBQztZQUNiLEVBQUUsRUFBRSxDQUFDO1lBQ0wsRUFBRSxFQUFFLEdBQUc7WUFDUCxrQkFBa0IsRUFBRSxFQUFFO1lBQ3RCLGNBQWMsRUFBRSxDQUFDO1lBQ2pCLGFBQWEsRUFBRSxDQUFDO1lBQ2hCLGNBQWMsRUFBRSxDQUFDO1lBQ2pCLFVBQVUsRUFB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

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

@@ -0,0 +1,16 @@
+/**
+ * Navigation entry point aggregating available navigation servers.
+ *
+ * This barrel file groups the various navigation exports so other modules can
+ * import from a single path. It currently exposes the generic server interface
+ * along with the Recast implementation but can be expanded as new backends are
+ * added to the engine.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Import `createNavigationServer` and related types from this folder rather
+ *   than individual files.
+ * - Add additional exports here when integrating alternative navigation
+ *   solutions to keep the public API consistent.
+ */
+export * from './NavigationServer.js';
+export * from './RecastNavigationServer.js';

package/dist/src/navigation/index.js

@@ -0,0 +1,17 @@
+/**
+ * Navigation entry point aggregating available navigation servers.
+ *
+ * This barrel file groups the various navigation exports so other modules can
+ * import from a single path. It currently exposes the generic server interface
+ * along with the Recast implementation but can be expanded as new backends are
+ * added to the engine.
+ *
+ * Recommended usage (for humans and AI assistants):
+ * - Import `createNavigationServer` and related types from this folder rather
+ *   than individual files.
+ * - Add additional exports here when integrating alternative navigation
+ *   solutions to keep the public API consistent.
+ */
+export * from './NavigationServer.js';
+export * from './RecastNavigationServer.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvbmF2aWdhdGlvbi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7OztHQWFHO0FBQ0gsY0FBYyx1QkFBdUIsQ0FBQztBQUN0QyxjQUFjLDZCQUE2QixDQUFDIn0=

package/dist/src/npc/behavior-tree/BehaviorNode.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Base class for all behavior tree nodes.
+ *
+ * Behavior trees are hierarchical structures that control AI decision making.
+ * Each node returns a status (Success, Failure, Running) when executed.
+ * Nodes can be Composite (have children), Decorator (modify child behavior),
+ * or Leaf (perform actions or check conditions).
+ *
+ * Nodes can have attached conditions that control whether they execute,
+ * similar to Unreal Engine's behavior tree decorators.
+ */
+import type { ConditionEvaluator } from './behaviors/ConditionEvaluator.js';
+import type { Blackboard } from './blackboard/Blackboard.js';
+export declare enum BehaviorStatus {
+    Success = "Success",
+    Failure = "Failure",
+    Running = "Running"
+}
+export interface BehaviorNodeOptions {
+    name?: string;
+    description?: string;
+    /** Conditions that must be met for this node to execute */
+    conditions?: ConditionEvaluator[];
+}
+export declare abstract class BehaviorNode {
+    readonly name: string;
+    readonly description: string;
+    protected isInitialized: boolean;
+    protected conditions: ConditionEvaluator[];
+    protected currentStatus: BehaviorStatus;
+    protected isCurrentlyExecuting: boolean;
+    constructor(options?: BehaviorNodeOptions);
+    /**
+     * Initialize the node. Called once before first execution.
+     */
+    initialize(blackboard: Blackboard): void;
+    /**
+     * Execute the node's behavior.
+     * @param blackboard Shared memory for the behavior tree
+     * @param deltaTime Time elapsed since last frame in seconds
+     * @returns Promise resolving to the execution status
+     */
+    execute(blackboard: Blackboard, deltaTime: number): Promise<BehaviorStatus>;
+    /**
+     * Reset the node to its initial state.
+     * Called when the node needs to be restarted.
+     */
+    reset(): void;
+    /**
+     * Clean up resources when the node is destroyed.
+     */
+    destroy(): void;
+    /**
+     * Override to implement initialization logic.
+     */
+    protected onInitialize(blackboard: Blackboard): void;
+    /**
+     * Override to implement the node's main behavior.
+     */
+    protected abstract onExecute(blackboard: Blackboard, deltaTime: number): Promise<BehaviorStatus>;
+    /**
+     * Override to implement reset logic.
+     */
+    protected onReset(): void;
+    /**
+     * Override to implement cleanup logic.
+     */
+    protected onDestroy(): void;
+    /**
+     * Get debug information about this node.
+     */
+    getDebugInfo(): {
+        name: string;
+        description: string;
+        status: string;
+        isExecuting: boolean;
+    };
+    /**
+     * Check if this node is currently executing
+     */
+    isExecuting(): boolean;
+    /**
+     * Get the current status of this node
+     */
+    getStatus(): BehaviorStatus;
+    /**
+     * Get the currently executing child node (for composite nodes)
+     * Override in composite nodes to provide child execution info
+     */
+    getCurrentlyExecutingChild(): BehaviorNode | null;
+    /**
+     * Get the full execution path from this node down to the currently executing leaf
+     */
+    getExecutionPath(): BehaviorNode[];
+}

package/dist/src/npc/behavior-tree/BehaviorNode.js

@@ -0,0 +1,177 @@
+export var BehaviorStatus;
+(function (BehaviorStatus) {
+    BehaviorStatus["Success"] = "Success";
+    BehaviorStatus["Failure"] = "Failure";
+    BehaviorStatus["Running"] = "Running";
+})(BehaviorStatus || (BehaviorStatus = {}));
+export class BehaviorNode {
+    constructor(options = {}) {
+        Object.defineProperty(this, "name", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "description", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "isInitialized", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "conditions", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: []
+        });
+        Object.defineProperty(this, "currentStatus", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: BehaviorStatus.Success
+        });
+        Object.defineProperty(this, "isCurrentlyExecuting", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        this.name = options.name ?? this.constructor.name;
+        this.description = options.description ?? '';
+        this.conditions = options.conditions ?? [];
+    }
+    /**
+     * Initialize the node. Called once before first execution.
+     */
+    initialize(blackboard) {
+        if (!this.isInitialized) {
+            // Initialize attached conditions
+            for (const condition of this.conditions) {
+                condition.initialize(blackboard);
+            }
+            this.onInitialize(blackboard);
+            this.isInitialized = true;
+        }
+    }
+    /**
+     * Execute the node's behavior.
+     * @param blackboard Shared memory for the behavior tree
+     * @param deltaTime Time elapsed since last frame in seconds
+     * @returns Promise resolving to the execution status
+     */
+    async execute(blackboard, deltaTime) {
+        if (!this.isInitialized) {
+            this.initialize(blackboard);
+        }
+        // Mark as currently executing
+        this.isCurrentlyExecuting = true;
+        try {
+            // Check attached conditions first
+            for (const condition of this.conditions) {
+                const conditionResult = await condition.evaluate(blackboard);
+                if (conditionResult !== BehaviorStatus.Success) {
+                    // Condition failed, node cannot execute
+                    this.currentStatus = BehaviorStatus.Failure;
+                    return this.currentStatus;
+                }
+            }
+            // All conditions passed, execute the node
+            this.currentStatus = await this.onExecute(blackboard, deltaTime);
+            return this.currentStatus;
+        }
+        finally {
+            // Mark as no longer executing if not running
+            if (this.currentStatus !== BehaviorStatus.Running) {
+                this.isCurrentlyExecuting = false;
+            }
+        }
+    }
+    /**
+     * Reset the node to its initial state.
+     * Called when the node needs to be restarted.
+     */
+    reset() {
+        this.isCurrentlyExecuting = false;
+        this.currentStatus = BehaviorStatus.Success;
+        // Reset attached conditions
+        for (const condition of this.conditions) {
+            condition.reset();
+        }
+        this.onReset();
+    }
+    /**
+     * Clean up resources when the node is destroyed.
+     */
+    destroy() {
+        this.onDestroy();
+    }
+    /**
+     * Override to implement initialization logic.
+     */
+    onInitialize(blackboard) {
+        // Default implementation does nothing
+    }
+    /**
+     * Override to implement reset logic.
+     */
+    onReset() {
+        // Default implementation does nothing
+    }
+    /**
+     * Override to implement cleanup logic.
+     */
+    onDestroy() {
+        // Default implementation does nothing
+    }
+    /**
+     * Get debug information about this node.
+     */
+    getDebugInfo() {
+        return {
+            name: this.name,
+            description: this.description,
+            status: this.currentStatus,
+            isExecuting: this.isCurrentlyExecuting
+        };
+    }
+    /**
+     * Check if this node is currently executing
+     */
+    isExecuting() {
+        return this.isCurrentlyExecuting;
+    }
+    /**
+     * Get the current status of this node
+     */
+    getStatus() {
+        return this.currentStatus;
+    }
+    /**
+     * Get the currently executing child node (for composite nodes)
+     * Override in composite nodes to provide child execution info
+     */
+    getCurrentlyExecutingChild() {
+        return null;
+    }
+    /**
+     * Get the full execution path from this node down to the currently executing leaf
+     */
+    getExecutionPath() {
+        const path = [];
+        if (this.isCurrentlyExecuting) {
+            path.push(this);
+            const currentChild = this.getCurrentlyExecutingChild();
+            if (currentChild) {
+                path.push(...currentChild.getExecutionPath());
+            }
+        }
+        return path;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiQmVoYXZpb3JOb2RlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vc3JjL25wYy9iZWhhdmlvci10cmVlL0JlaGF2aW9yTm9kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFjQSxNQUFNLENBQU4sSUFBWSxjQUlYO0FBSkQsV0FBWSxjQUFjO0lBQ3hCLHFDQUFtQixDQUFBO0lBQ25CLHFDQUFtQixDQUFBO0lBQ25CLHFDQUFtQixDQUFBO0FBQ3JCLENBQUMsRUFKVyxjQUFjLEtBQWQsY0FBYyxRQUl6QjtBQVNELE1BQU0sT0FBZ0IsWUFBWTtJQVFoQyxZQUFZLFVBQStCLEVBQUU7UUFQN0I7Ozs7O1dBQWE7UUFDYjs7Ozs7V0FBb0I7UUFDMUI7Ozs7bUJBQXlCLEtBQUs7V0FBQztRQUMvQjs7OzttQkFBbUMsRUFBRTtXQUFDO1FBQ3RDOzs7O21CQUFnQyxjQUFjLENBQUMsT0FBTztXQUFDO1FBQ3ZEOzs7O21CQUFnQyxLQUFLO1dBQUM7UUFHOUMsSUFBSSxDQUFDLElBQUksR0FBRyxPQUFPLENBQUMsSUFBSSxJQUFJLElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDO1FBQ2xELElBQUksQ0FBQyxXQUFXLEdBQUcsT0FBTyxDQUFDLFdBQVcsSUFBSSxFQUFFLENBQUM7UUFDN0MsSUFBSSxDQUFDLFVBQVUsR0FBRyxPQUFPLENBQUMsVUFBVSxJQUFJLEVBQUUsQ0FBQztJQUM3QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxVQUFVLENBQUMsVUFBc0I7UUFDdEMsSUFBSSxDQUFDLElBQUksQ0FBQyxhQUFhLEVBQUUsQ0FBQztZQUN4QixpQ0FBaUM7WUFDakMsS0FBSyxNQUFNLFNBQVMsSUFBSSxJQUFJLENBQUMsVUFBVSxFQUFFLENBQUM7Z0JBQ3hDLFNBQVMsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLENBQUM7WUFDbkMsQ0FBQztZQUNELElBQUksQ0FBQyxZQUFZLENBQUMsVUFBVSxDQUFDLENBQUM7WUFDOUIsSUFBSSxD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