@alife-sdk/ai 0.1.0

package/dist/states/handlers/PatrolState.js

@@ -0,0 +1,137 @@
+// states/handlers/PatrolState.ts
+// NPC moves toward the current patrol waypoint stored in ctx.state.
+//
+// Waypoint management:
+//   The handler does NOT own the waypoint list. Instead it moves toward the
+//   target position stored in ctx.state.coverPointX / coverPointY (repurposed
+//   as the "current patrol point"). External code (e.g. PatrolRouteTracker,
+//   A-Life brain hooks) is responsible for writing the next target into these
+//   fields before entering PATROL state.
+//
+//   When the NPC arrives within cfg.waypointArriveThreshold pixels it halts
+//   and transitions to IDLE so the host can assign the next waypoint.
+//
+// Transitions out of PATROL:
+//   - visible enemy detected via ctx.perception        → ALERT
+//   - squad intel received (opt-in)                    → ALERT (via patrolOnSquadIntel)
+//   - accumulated suspicion exceeds threshold (opt-in) → ALERT (via patrolOnSuspicious)
+//   - wounded ally detected (opt-in)                   → HELP_WOUNDED (via patrolOnWoundedAlly)
+//   - friendly corpse seen (opt-in)                    → suspicion.add(BODY_FOUND) → cascades
+//   - arrived at patrol target                         → IDLE
+//   - no patrol target set (both coords are 0)         → IDLE
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+import { SuspicionStimuli } from '../../suspicion/SuspicionAccumulator';
+/**
+ * Stateless patrol-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class PatrolState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        // Velocity will be set in update once we resolve the patrol target.
+        ctx.halt();
+    }
+    update(ctx, _deltaMs) {
+        // --- Perception: any visible enemy → ALERT ---
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            ctx.halt();
+            ctx.transition(this.tr.patrolOnEnemy);
+            return;
+        }
+        // --- Squad intel check (opt-in) ---
+        // Silently skips when ctx.squad is null or getSharedTarget is not implemented.
+        const shared = ctx.squad?.getSharedTarget?.() ?? null;
+        if (shared !== null) {
+            ctx.state.lastKnownEnemyX = shared.x;
+            ctx.state.lastKnownEnemyY = shared.y;
+            ctx.halt();
+            ctx.transition(this.tr.patrolOnSquadIntel);
+            return;
+        }
+        // --- Pack alert check (opt-in) ---
+        if (ctx.pack) {
+            const level = ctx.pack.getPackAlertLevel();
+            if (level !== 'NONE') {
+                const pt = ctx.pack.getPackTarget();
+                if (pt) {
+                    ctx.state.lastKnownEnemyX = pt.x;
+                    ctx.state.lastKnownEnemyY = pt.y;
+                }
+                ctx.halt();
+                ctx.transition(this.tr.patrolOnPackAlert);
+                return;
+            }
+        }
+        // --- Suspicion check (opt-in) ---
+        // Silently skips when ctx.suspicion is null (not registered by host).
+        if (ctx.suspicion?.hasReachedAlert(this.cfg.suspicionAlertThreshold)) {
+            const pos = ctx.suspicion.getLastKnownPosition();
+            if (pos) {
+                ctx.state.lastKnownEnemyX = pos.x;
+                ctx.state.lastKnownEnemyY = pos.y;
+            }
+            ctx.suspicion.clear();
+            ctx.halt();
+            ctx.transition(this.tr.patrolOnSuspicious);
+            return;
+        }
+        // --- Wounded ally check (opt-in via getWoundedAllies) ---
+        // Silently skips when perception is null or getWoundedAllies is not implemented.
+        const woundedAllies = ctx.perception?.getWoundedAllies?.() ?? [];
+        if (woundedAllies.length > 0) {
+            const ally = woundedAllies[0];
+            ctx.state.helpWoundedTargetId = ally.id;
+            ctx.state.helpWoundedX = ally.x;
+            ctx.state.helpWoundedY = ally.y;
+            ctx.halt();
+            ctx.transition(this.tr.patrolOnWoundedAlly);
+            return;
+        }
+        // --- Corpse detection (opt-in via getVisibleCorpses + suspicion) ---
+        // Feeds suspicion accumulator; the existing suspicion check above handles transition.
+        if (ctx.suspicion) {
+            for (const c of ctx.perception?.getVisibleCorpses?.() ?? []) {
+                ctx.suspicion.add(SuspicionStimuli.BODY_FOUND, this.cfg.corpseFoundSuspicion, c.x, c.y);
+            }
+        }
+        // --- Patrol target check ---
+        // ctx.state.coverPointX/Y stores the current waypoint destination.
+        // If both are 0 we have no assignment — fall back to IDLE.
+        const targetX = ctx.state.coverPointX;
+        const targetY = ctx.state.coverPointY;
+        if (targetX === 0 && targetY === 0) {
+            ctx.halt();
+            ctx.transition(this.tr.patrolOnNoWaypoint);
+            return;
+        }
+        // --- Arrival check ---
+        const dx = targetX - ctx.x;
+        const dy = targetY - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const thresh = this.cfg.waypointArriveThreshold;
+        if (distSq <= thresh * thresh) {
+            ctx.halt();
+            // Signal arrival: clear the target so the host knows to assign the next
+            // waypoint, then fall back to IDLE until re-assigned.
+            ctx.state.coverPointX = 0;
+            ctx.state.coverPointY = 0;
+            ctx.transition(this.tr.patrolOnNoWaypoint);
+            return;
+        }
+        // --- Move toward target ---
+        moveToward(ctx, targetX, targetY, this.cfg.approachSpeed);
+    }
+    exit(ctx) {
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=PatrolState.js.map

package/dist/states/handlers/PatrolState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PatrolState.js","sourceRoot":"","sources":["../../../src/states/handlers/PatrolState.ts"],"names":[],"mappings":"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"}

package/dist/states/handlers/PsiAttackState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless Controller PSI attack handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class PsiAttackState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=PsiAttackState.d.ts.map

package/dist/states/handlers/PsiAttackState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PsiAttackState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/PsiAttackState.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,cAAe,YAAW,mBAAmB;IAItD,OAAO,CAAC,QAAQ,CAAC,GAAG;IAHtB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAGtB,GAAG,EAAE,YAAY,EAClC,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKnC,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IA8B7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqDhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/handlers/PsiAttackState.js

@@ -0,0 +1,101 @@
+// states/handlers/PsiAttackState.ts
+// Controller PSI ranged channeled attack state.
+//
+// Phase pipeline (stored in ctx.state.psiPhase):
+//   CHANNEL — Controller stands still; emitPsiAttackStart() fires on enter for
+//             VFX/audio. Counts down psiChannelMs.
+//             Once complete: emit PSI damage via emitMeleeHit (weaponType-agnostic),
+//             then transition (tr.psiOnComplete).
+//
+// Early abort:
+//   - No visible enemy during channel → transition (tr.psiOnNoEnemy).
+//
+// All mutable state lives in INPCOnlineState.psiPhase so this handler is
+// stateless and safe to share across all NPC entities.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless Controller PSI attack handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class PsiAttackState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        var _a;
+        const now = ctx.now();
+        // Update last known target position before channeling begins.
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        if (enemies.length > 0) {
+            ctx.state.lastKnownEnemyX = enemies[0].x;
+            ctx.state.lastKnownEnemyY = enemies[0].y;
+            ctx.state.targetId = enemies[0].id;
+        }
+        // Lazy-initialise PSI phase data if not yet present.
+        (_a = ctx.state).psiPhase ?? (_a.psiPhase = { active: false, channelStartMs: 0 });
+        ctx.state.psiPhase.active = true;
+        ctx.state.psiPhase.channelStartMs = now;
+        // Stand still while channeling.
+        ctx.halt();
+        // Face the target.
+        const dx = ctx.state.lastKnownEnemyX - ctx.x;
+        const dy = ctx.state.lastKnownEnemyY - ctx.y;
+        if (dx !== 0 || dy !== 0) {
+            ctx.setRotation(Math.atan2(dy, dx));
+        }
+        // Notify VFX/audio systems that PSI channel has begun.
+        ctx.emitPsiAttackStart(ctx.x, ctx.y);
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // -----------------------------------------------------------------------
+        // Abort: no visible enemy → psiOnNoEnemy
+        // -----------------------------------------------------------------------
+        const hasEnemy = ctx.perception?.hasVisibleEnemy() ?? false;
+        if (!hasEnemy) {
+            ctx.transition(this.tr.psiOnNoEnemy);
+            return;
+        }
+        // Refresh target position each frame during the channel.
+        const enemies = ctx.perception?.getVisibleEnemies() ?? [];
+        if (enemies.length > 0) {
+            ctx.state.lastKnownEnemyX = enemies[0].x;
+            ctx.state.lastKnownEnemyY = enemies[0].y;
+            ctx.state.targetId = enemies[0].id;
+        }
+        // -----------------------------------------------------------------------
+        // CHANNEL phase — stay still, face target, count down psiChannelMs
+        // -----------------------------------------------------------------------
+        const elapsed = now - ctx.state.psiPhase.channelStartMs;
+        // Face the target while channeling.
+        const dx = ctx.state.lastKnownEnemyX - ctx.x;
+        const dy = ctx.state.lastKnownEnemyY - ctx.y;
+        if (dx !== 0 || dy !== 0) {
+            ctx.setRotation(Math.atan2(dy, dx));
+        }
+        // Ensure NPC stays still during channel.
+        ctx.halt();
+        if (elapsed < this.cfg.psiChannelMs) {
+            // Still channeling.
+            return;
+        }
+        // -----------------------------------------------------------------------
+        // Channel complete — emit PSI damage and transition
+        // -----------------------------------------------------------------------
+        ctx.state.lastMeleeMs = now;
+        ctx.emitMeleeHit({
+            npcId: ctx.npcId,
+            targetId: ctx.state.targetId ?? '',
+            damage: this.cfg.meleeDamage,
+        });
+        ctx.transition(this.tr.psiOnComplete);
+    }
+    exit(ctx) {
+        if (ctx.state.psiPhase) {
+            ctx.state.psiPhase.active = false;
+        }
+    }
+}
+//# sourceMappingURL=PsiAttackState.js.map

package/dist/states/handlers/PsiAttackState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PsiAttackState.js","sourceRoot":"","sources":["../../../src/states/handlers/PsiAttackState.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,gDAAgD;AAChD,EAAE;AACF,iDAAiD;AACjD,+EAA+E;AAC/E,mDAAmD;AACnD,qFAAqF;AACrF,kDAAkD;AAClD,EAAE;AACF,eAAe;AACf,sEAAsE;AACtE,EAAE;AACF,yEAAyE;AACzE,uDAAuD;AAMvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAGzB,YACmB,GAAiB,EAClC,EAAiC;QADhB,QAAG,GAAH,GAAG,CAAc;QAGlC,IAAI,CAAC,EAAE,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAgB;;QACpB,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAEtB,8DAA8D;QAC9D,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC;QAED,qDAAqD;QACrD,MAAA,GAAG,CAAC,KAAK,EAAC,QAAQ,QAAR,QAAQ,GAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,EAAE,EAAC;QAC5D,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC;QACjC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,cAAc,GAAG,GAAG,CAAC;QAExC,gCAAgC;QAChC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEX,mBAAmB;QACnB,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,uDAAuD;QACvD,GAAG,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,GAAgB,EAAE,QAAgB;QACvC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAEtB,0EAA0E;QAC1E,yCAAyC;QACzC,0EAA0E;QAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,IAAI,KAAK,CAAC;QAC5D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,yDAAyD;QACzD,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;QAC1D,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,CAAC;QAED,0EAA0E;QAC1E,mEAAmE;QACnE,0EAA0E;QAC1E,MAAM,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,QAAS,CAAC,cAAc,CAAC;QAEzD,oCAAoC;QACpC,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,GAAG,CAAC,CAAC,CAAC;QAC7C,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,yCAAyC;QACzC,GAAG,CAAC,IAAI,EAAE,CAAC;QAEX,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;YACpC,oBAAoB;YACpB,OAAO;QACT,CAAC;QAED,0EAA0E;QAC1E,oDAAoD;QACpD,0EAA0E;QAC1E,GAAG,CAAC,KAAK,CAAC,WAAW,GAAG,GAAG,CAAC;QAC5B,GAAG,CAAC,YAAY,CAAC;YACf,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE;YAClC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW;SAC7B,CAAC,CAAC;QAEH,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,GAAgB;QACnB,IAAI,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;YACvB,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC;QACpC,CAAC;IACH,CAAC;CACF"}

package/dist/states/handlers/RetreatState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless retreat-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class RetreatState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=RetreatState.d.ts.map

package/dist/states/handlers/RetreatState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetreatState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/RetreatState.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,YAAa,YAAW,mBAAmB;IACtD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAmC7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAiFhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAI7B"}

package/dist/states/handlers/RetreatState.js

@@ -0,0 +1,131 @@
+// states/handlers/RetreatState.ts
+// NPC makes a tactical retreat to FAR cover while periodically firing
+// suppressive shots toward the last known enemy position.
+//
+// Behaviour summary:
+//   enter()  — find FAR cover via ctx.cover?.findCover('FAR', ...).
+//              Store cover destination in ctx.state.coverPointX/Y.
+//   update() — per frame:
+//              1. If morale PANICKED → FLEE (panic overrides tactics).
+//              2. Move toward the cover point at approachSpeed.
+//              3. At cover: fire suppressive burst every retreatFireIntervalMs
+//                 via ctx.emitShoot(); wait for morale to recover.
+//              4. If morale recovers to STABLE while at cover → COMBAT.
+//              5. If no visible enemy and at cover → SEARCH.
+//              6. If no cover found: flee away from last known enemy.
+//   exit()   — halt().
+//
+// State ID: 'RETREAT'
+// Transitions: → 'FLEE' (panic) | 'COMBAT' (morale stable) | 'SEARCH' (no enemy)
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward, awayFrom } from './_utils';
+/**
+ * Stateless retreat-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class RetreatState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        // Determine enemy reference position for cover query.
+        const enemyX = ctx.state.lastKnownEnemyX;
+        const enemyY = ctx.state.lastKnownEnemyY;
+        // Find a FAR cover point — maximises distance from the known threat.
+        const coverPoint = ctx.cover?.findCover(ctx.x, ctx.y, enemyX, enemyY, 'FAR') ?? null;
+        if (coverPoint) {
+            // Lock the cover point; if contested, treat as no cover found.
+            const locked = ctx.cover?.lockLastFound?.(ctx.npcId) ?? true;
+            if (locked) {
+                ctx.state.coverPointX = coverPoint.x;
+                ctx.state.coverPointY = coverPoint.y;
+                ctx.state.hasTakenCover = false;
+            }
+            else {
+                ctx.state.hasTakenCover = false;
+                ctx.state.coverPointX = ctx.x;
+                ctx.state.coverPointY = ctx.y;
+            }
+        }
+        else {
+            // No cover found — mark as unavailable; update() will flee from threat.
+            ctx.state.hasTakenCover = false;
+            ctx.state.coverPointX = ctx.x;
+            ctx.state.coverPointY = ctx.y;
+        }
+        // Allow an immediate first suppressive burst on enter.
+        ctx.state.lastSupressiveFireMs = 0;
+    }
+    update(ctx, _deltaMs) {
+        // --- PANICKED: panic overrides all tactical behaviour → FLEE ---
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.halt();
+            ctx.transition(this.tr.retreatOnPanicked);
+            return;
+        }
+        const now = ctx.now();
+        const dx = ctx.state.coverPointX - ctx.x;
+        const dy = ctx.state.coverPointY - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const arrived = distSq <= this.cfg.arriveThreshold * this.cfg.arriveThreshold;
+        if (!arrived) {
+            // --- Move toward the FAR cover point at normal approach speed ---
+            const hasCoverDest = ctx.state.coverPointX !== ctx.x || ctx.state.coverPointY !== ctx.y;
+            if (hasCoverDest) {
+                moveToward(ctx, ctx.state.coverPointX, ctx.state.coverPointY, this.cfg.approachSpeed);
+            }
+            else {
+                // No cover destination — run away from last known enemy.
+                awayFrom(ctx, ctx.state.lastKnownEnemyX, ctx.state.lastKnownEnemyY, this.cfg.approachSpeed);
+            }
+            return;
+        }
+        // --- Arrived at cover ---
+        ctx.halt();
+        // --- Suppressive fire: emit shoot every retreatFireIntervalMs ---
+        const timeSinceFire = now - ctx.state.lastSupressiveFireMs;
+        if (timeSinceFire >= this.cfg.retreatFireIntervalMs) {
+            ctx.state.lastSupressiveFireMs = now;
+            // Use visible enemy position or fall back to last known.
+            let targetX = ctx.state.lastKnownEnemyX;
+            let targetY = ctx.state.lastKnownEnemyY;
+            if (ctx.perception?.hasVisibleEnemy()) {
+                const enemies = ctx.perception.getVisibleEnemies();
+                if (enemies.length > 0) {
+                    targetX = enemies[0].x;
+                    targetY = enemies[0].y;
+                }
+            }
+            // Only emit shoot if we have a non-trivial direction.
+            const sdx = targetX - ctx.x;
+            const sdy = targetY - ctx.y;
+            if (sdx !== 0 || sdy !== 0) {
+                ctx.emitShoot({
+                    npcId: ctx.npcId,
+                    x: ctx.x,
+                    y: ctx.y,
+                    targetX,
+                    targetY,
+                    weaponType: ctx.state.primaryWeapon ?? 'rifle',
+                });
+            }
+        }
+        // --- Morale recovered while at cover → return to COMBAT ---
+        if (ctx.state.moraleState === 'STABLE') {
+            ctx.transition(this.tr.retreatOnStable);
+            return;
+        }
+        // --- No visible enemy while at cover → SEARCH ---
+        if (ctx.perception !== null && !ctx.perception.hasVisibleEnemy()) {
+            ctx.transition(this.tr.retreatOnNoEnemy);
+            return;
+        }
+    }
+    exit(ctx) {
+        ctx.halt();
+        ctx.cover?.unlockAll?.(ctx.npcId);
+    }
+}
+//# sourceMappingURL=RetreatState.js.map

package/dist/states/handlers/RetreatState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetreatState.js","sourceRoot":"","sources":["../../../src/states/handlers/RetreatState.ts"],"names":[],"mappings":"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"}

package/dist/states/handlers/SearchState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless search-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class SearchState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=SearchState.d.ts.map

package/dist/states/handlers/SearchState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/SearchState.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGlE;;;;GAIG;AACH,qBAAa,WAAY,YAAW,mBAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAM7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAsChD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAG7B"}

package/dist/states/handlers/SearchState.js

@@ -0,0 +1,64 @@
+// states/handlers/SearchState.ts
+// NPC lost visual contact on the enemy and moves to the last known position
+// to check if it is still there.
+//
+// Transitions out of SEARCH:
+//   - visible enemy spotted again              → ALERT  (re-escalate)
+//   - search timer (cfg.searchDuration) expired → IDLE   (gave up)
+//   - arrived at last known position           → wait in place until timer
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless search-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class SearchState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.searchStartMs = ctx.now();
+        // Do not overwrite lastKnownEnemyX/Y here — the caller (e.g. CombatState
+        // transitioning to SEARCH) has already set the last confirmed position.
+    }
+    update(ctx, _deltaMs) {
+        // --- Perception: enemy becomes visible → re-escalate to ALERT ---
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            ctx.transition(this.tr.searchOnEnemy);
+            return;
+        }
+        // --- Timer countdown ---
+        const elapsed = ctx.now() - ctx.state.searchStartMs;
+        if (elapsed >= this.cfg.searchDuration) {
+            // Gave up searching — clear target lock, return to idle.
+            ctx.state.targetId = null;
+            ctx.halt();
+            ctx.transition(this.tr.searchOnTimeout);
+            return;
+        }
+        // --- Move toward last known enemy position ---
+        const targetX = ctx.state.lastKnownEnemyX;
+        const targetY = ctx.state.lastKnownEnemyY;
+        const dx = targetX - ctx.x;
+        const dy = targetY - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const thresh = this.cfg.arriveThreshold;
+        if (distSq <= thresh * thresh) {
+            // Reached the last known position; nothing here — wait for timer.
+            ctx.halt();
+        }
+        else {
+            moveToward(ctx, targetX, targetY, this.cfg.approachSpeed);
+        }
+    }
+    exit(ctx) {
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=SearchState.js.map

package/dist/states/handlers/SearchState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SearchState.js","sourceRoot":"","sources":["../../../src/states/handlers/SearchState.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,4EAA4E;AAC5E,iCAAiC;AACjC,EAAE;AACF,6BAA6B;AAC7B,sEAAsE;AACtE,mEAAmE;AACnE,2EAA2E;AAK3E,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAItB,YAAY,GAAiB,EAAE,EAAiC;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,EAAE,GAAG,0BAA0B,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,GAAgB;QACpB,GAAG,CAAC,KAAK,CAAC,aAAa,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QACpC,yEAAyE;QACzE,wEAAwE;IAC1E,CAAC;IAED,MAAM,CAAC,GAAgB,EAAE,QAAgB;QACvC,mEAAmE;QACnE,IAAI,GAAG,CAAC,UAAU,EAAE,eAAe,EAAE,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,iBAAiB,EAAE,CAAC;YACnD,MAAM,MAAM,GAAI,OAAO,CAAC,CAAC,CAAC,CAAC;YAC3B,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,KAAK,CAAC,eAAe,GAAG,MAAM,CAAC,CAAC,CAAC;YACrC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,0BAA0B;QAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC;QACpD,IAAI,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YACvC,yDAAyD;YACzD,GAAG,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC1B,GAAG,CAAC,IAAI,EAAE,CAAC;YACX,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,gDAAgD;QAChD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC;QAE1C,MAAM,EAAE,GAAO,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAO,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,eAAe,CAAC;QAExC,IAAI,MAAM,IAAI,MAAM,GAAG,MAAM,EAAE,CAAC;YAC9B,kEAAkE;YAClE,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,IAAI,CAAC,GAAgB;QACnB,GAAG,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;CACF"}

package/dist/states/handlers/SleepState.d.ts

@@ -0,0 +1,18 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless sleep-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class SleepState implements IOnlineStateHandler {
+    private readonly cfg;
+    private readonly tr;
+    constructor(cfg: IStateConfig, tr?: Partial<IStateTransitionMap>);
+    enter(ctx: INPCContext): void;
+    update(ctx: INPCContext, _deltaMs: number): void;
+    exit(ctx: INPCContext): void;
+}
+//# sourceMappingURL=SleepState.d.ts.map

package/dist/states/handlers/SleepState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/SleepState.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAMlE;;;;GAIG;AACH,qBAAa,UAAW,YAAW,mBAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAsB;gBAE7B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAS7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA0DhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAM7B"}