@alife-sdk/ai 0.1.0

package/dist/states/handlers/HelpWoundedState.js

@@ -0,0 +1,131 @@
+// states/handlers/HelpWoundedState.ts
+// NPC detected a wounded ally and moves toward them to provide assistance.
+// Softer social response — not combat, no weapon use.
+//
+// Phase 1 — APPROACH: Move toward the wounded ally at approachSpeed.
+//   - Panicked morale (PANICKED)                → helpWoundedOnPanic (FLEE)
+//   - Visible enemy detected via ctx.perception → helpWoundedOnEnemy (ALERT)
+//   - Overall timeout (helpWoundedMaxDurationMs) → helpWoundedOnComplete (PATROL)
+//   - Ally gone from getWoundedAllies() list    → helpWoundedOnComplete (PATROL)
+//   - Arrived within arriveThreshold            → begin Phase 2
+//
+// Phase 2 — ASSIST: Halt next to ally, hold position for helpWoundedAssistMs.
+//   - Panicked morale (PANICKED)                → helpWoundedOnPanic (FLEE)
+//   - Visible enemy detected via ctx.perception → helpWoundedOnEnemy (ALERT)
+//   - Ally gone from getWoundedAllies() list    → helpWoundedOnComplete (healed or dead)
+//   - Assist timer expires                      → helpWoundedOnComplete (PATROL)
+//
+// Pre-conditions set by calling state (PatrolState / IdleState):
+//   ctx.state.helpWoundedTargetId = ally.id
+//   ctx.state.helpWoundedX        = ally.x
+//   ctx.state.helpWoundedY        = ally.y
+//
+// Opt-in integration:
+//   Requires ctx.perception?.getWoundedAllies?.() to be implemented.
+//   Without it, Phase 1 immediately transitions to helpWoundedOnComplete.
+//
+// Stateless: a single instance can be shared across all NPC entities.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless two-phase help-wounded handler (X-Ray 16 `xr_help_wounded` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation:
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   patrolOnWoundedAlly: 'HELP_WOUNDED',
+ *   idleOnWoundedAlly:   'HELP_WOUNDED',
+ * });
+ * handlers.register('HELP_WOUNDED', new HelpWoundedState(cfg));
+ * ```
+ */
+export class HelpWoundedState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.helpWoundedStartMs = ctx.now();
+        ctx.state.helpWoundedAssistStartMs = -1; // -1 = not yet arrived
+        ctx.halt();
+        ctx.emitVocalization('HELP_WOUNDED_MOVING');
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // ── Priority 1 — Panic → flee ───────────────────────────────────────────
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.halt();
+            ctx.transition(this.tr.helpWoundedOnPanic);
+            return;
+        }
+        // ── Priority 2 — Visible enemy → abandon help, fight ────────────────────
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            ctx.state.targetId = target.id;
+            ctx.halt();
+            ctx.transition(this.tr.helpWoundedOnEnemy);
+            return;
+        }
+        // ── Phase 2 — ASSIST (arrived, helpWoundedAssistStartMs >= 0) ────────────
+        if (ctx.state.helpWoundedAssistStartMs >= 0) {
+            ctx.halt();
+            // Re-check if ally is still wounded (opt-in)
+            const allies = ctx.perception?.getWoundedAllies?.() ?? [];
+            const stillWounded = allies.find(a => a.id === ctx.state.helpWoundedTargetId);
+            if (!stillWounded) {
+                ctx.transition(this.tr.helpWoundedOnComplete); // healed or died
+                return;
+            }
+            // Assist timer
+            if (now - ctx.state.helpWoundedAssistStartMs >= this.cfg.helpWoundedAssistMs) {
+                ctx.transition(this.tr.helpWoundedOnComplete);
+            }
+            return;
+        }
+        // ── Phase 1 — APPROACH ───────────────────────────────────────────────────
+        // Overall timeout — prevents infinite approach on unreachable ally
+        if (now - ctx.state.helpWoundedStartMs >= this.cfg.helpWoundedMaxDurationMs) {
+            ctx.halt();
+            ctx.transition(this.tr.helpWoundedOnComplete);
+            return;
+        }
+        // Update ally position from fresh perception each frame (ally may crawl)
+        const allies = ctx.perception?.getWoundedAllies?.() ?? [];
+        const target = allies.find(a => a.id === ctx.state.helpWoundedTargetId) ?? null;
+        if (!target) {
+            // Ally healed, died, or left perception range
+            ctx.halt();
+            ctx.transition(this.tr.helpWoundedOnComplete);
+            return;
+        }
+        // Keep destination current
+        ctx.state.helpWoundedX = target.x;
+        ctx.state.helpWoundedY = target.y;
+        const dx = target.x - ctx.x;
+        const dy = target.y - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const thresh = this.cfg.arriveThreshold;
+        if (distSq <= thresh * thresh) {
+            // Arrived — begin assist phase
+            ctx.state.helpWoundedAssistStartMs = now;
+            ctx.halt();
+            ctx.emitVocalization('HELP_WOUNDED_ASSIST');
+            return;
+        }
+        moveToward(ctx, target.x, target.y, this.cfg.approachSpeed);
+    }
+    exit(ctx) {
+        ctx.state.helpWoundedStartMs = 0;
+        ctx.state.helpWoundedAssistStartMs = -1;
+        ctx.state.helpWoundedTargetId = null;
+        ctx.state.helpWoundedX = 0;
+        ctx.state.helpWoundedY = 0;
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=HelpWoundedState.js.map

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

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

package/dist/states/handlers/IdleState.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 idle-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export declare class IdleState 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=IdleState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"IdleState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/IdleState.ts"],"names":[],"mappings":"AAcA,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;AAIlE;;;;GAIG;AACH,qBAAa,SAAU,YAAW,mBAAmB;IACnD,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;IAwGhD,IAAI,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;CAG9B"}

package/dist/states/handlers/IdleState.js

@@ -0,0 +1,127 @@
+// states/handlers/IdleState.ts
+// NPC stands still and waits. Lowest-activity state for non-sleeping NPCs.
+//
+// Transitions out of IDLE:
+//   - visible enemy detected via ctx.perception         → ALERT
+//   - NPC standing inside a DANGER restricted zone      → ALERT (walk away first)
+//   - accumulated suspicion exceeds threshold (opt-in)  → ALERT (via idleOnSuspicious)
+//   - wounded ally detected (opt-in)                    → HELP_WOUNDED (via idleOnWoundedAlly)
+//   - friendly corpse seen (opt-in)                     → suspicion.add(BODY_FOUND) → cascades
+//   - condition channel above threshold (opt-in)        → CAMP  (via idleOnTired)
+//
+// Note: this is the "calm" default fallback. When the NPC has a patrol task
+// assigned, the host should put it in PATROL instead.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+import { SuspicionStimuli } from '../../suspicion/SuspicionAccumulator';
+/**
+ * Stateless idle-state handler.
+ *
+ * A single instance can be shared across all NPC entities.
+ */
+export class IdleState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.halt();
+        // Seed the zone check timer so the check fires on the first update tick.
+        ctx.state.lastIdleAnimChangeMs = ctx.now() - this.cfg.restrictedZoneCheckIntervalMs;
+    }
+    update(ctx, _deltaMs) {
+        // --- Perception: any visible enemy → go 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.idleOnEnemy);
+            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.transition(this.tr.idleOnPackAlert);
+                return;
+            }
+        }
+        // --- Restricted zone DANGER check (throttled) ---
+        // Use lastIdleAnimChangeMs as the zone-check timestamp to avoid adding a
+        // new field — the semantics ("last periodic check") are close enough.
+        const now = ctx.now();
+        const timeSinceCheck = now - ctx.state.lastIdleAnimChangeMs;
+        if (timeSinceCheck >= this.cfg.restrictedZoneCheckIntervalMs &&
+            ctx.restrictedZones !== null) {
+            ctx.state.lastIdleAnimChangeMs = now;
+            if (!ctx.restrictedZones.isAccessible(ctx.x, ctx.y)) {
+                // NPC is standing inside a restricted/dangerous zone.
+                // Escape direction: pick a safe nearby point by filtering a small set of
+                // cardinal candidate positions and walking toward the first accessible one.
+                const step = this.cfg.approachSpeed * 2;
+                const candidates = [
+                    { x: ctx.x + step, y: ctx.y },
+                    { x: ctx.x - step, y: ctx.y },
+                    { x: ctx.x, y: ctx.y + step },
+                    { x: ctx.x, y: ctx.y - step },
+                ];
+                const safe = ctx.restrictedZones.filterAccessible(candidates);
+                if (safe.length > 0) {
+                    const dest = safe[0];
+                    ctx.state.lastKnownEnemyX = dest.x;
+                    ctx.state.lastKnownEnemyY = dest.y;
+                    moveToward(ctx, dest.x, dest.y, this.cfg.approachSpeed);
+                }
+                ctx.transition(this.tr.idleOnEnemy);
+                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.transition(this.tr.idleOnSuspicious);
+            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.transition(this.tr.idleOnWoundedAlly);
+            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);
+            }
+        }
+        // --- Condition check (opt-in) ---
+        // Silently skips when ctx.conditions is null or not registered.
+        if (ctx.conditions?.hasCondition(this.cfg.idleConditionChannel, this.cfg.idleConditionThreshold)) {
+            ctx.transition(this.tr.idleOnTired);
+            return;
+        }
+    }
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    exit(_ctx) {
+        // Nothing to clean up.
+    }
+}
+//# sourceMappingURL=IdleState.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless two-phase investigate handler (X-Ray 16 `xr_investigator` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation — wire suspicion to INVESTIGATE instead of ALERT:
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   patrolOnSuspicious: 'INVESTIGATE',
+ *   idleOnSuspicious:   'INVESTIGATE',
+ * });
+ * handlers.register('INVESTIGATE', new InvestigateState(cfg));
+ * ```
+ */
+export declare class InvestigateState 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=InvestigateState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InvestigateState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/InvestigateState.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAe,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAc,iBAAiB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAO,wBAAwB,CAAC;AAGnE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAuB;gBAE9B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAO7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAmGhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAK7B"}

package/dist/states/handlers/InvestigateState.js

@@ -0,0 +1,145 @@
+// states/handlers/InvestigateState.ts
+// NPC received a suspicious stimulus and moves toward the last known position
+// to investigate. Softer than ALERT — no combat assumption, calm approach.
+//
+// Phase 1 — APPROACH: Move toward ctx.state.lastKnownEnemyX/Y at approachSpeed.
+//   - Panicked morale (PANICKED)                → investigateOnPanic (FLEE)
+//   - Visible enemy detected via ctx.perception → investigateOnEnemy (ALERT)
+//   - Suspicion re-accumulates above threshold  → investigateOnEnemy (ALERT)
+//   - Overall timeout (investigateMaxDurationMs) → investigateOnTimeout (PATROL)
+//   - Arrived within arriveThreshold            → begin Phase 2
+//
+// Phase 2 — LOOK_AROUND: Halt at the location, rotate, wait investigateLookAroundMs.
+//   - Panicked morale (PANICKED)                → investigateOnPanic (FLEE)
+//   - Visible enemy detected via ctx.perception → investigateOnEnemy (ALERT)
+//   - Suspicion re-accumulates above threshold  → investigateOnEnemy (ALERT)
+//   - Look-around timer expires, nothing found  → investigateOnTimeout (PATROL)
+//
+// Opt-in integration:
+//   ctx.suspicion may be null — all suspicion checks use optional chaining.
+//   To activate: register this handler and set patrolOnSuspicious/idleOnSuspicious to 'INVESTIGATE'.
+//
+// Stateless: a single instance can be shared across all NPC entities.
+//
+// Sentinel: investigateLookAroundStartMs uses -1 to mean "not yet arrived",
+//   avoiding collision with ctx.now() === 0 on the very first frame.
+import { createDefaultTransitionMap } from '../IStateTransitionMap';
+import { moveToward } from './_utils';
+/**
+ * Stateless two-phase investigate handler (X-Ray 16 `xr_investigator` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation — wire suspicion to INVESTIGATE instead of ALERT:
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   patrolOnSuspicious: 'INVESTIGATE',
+ *   idleOnSuspicious:   'INVESTIGATE',
+ * });
+ * handlers.register('INVESTIGATE', new InvestigateState(cfg));
+ * ```
+ */
+export class InvestigateState {
+    constructor(cfg, tr) {
+        this.cfg = cfg;
+        this.tr = createDefaultTransitionMap(tr);
+    }
+    enter(ctx) {
+        ctx.state.investigateStartMs = ctx.now();
+        ctx.state.investigateLookAroundStartMs = -1; // -1 = not yet arrived
+        ctx.halt();
+        ctx.emitVocalization('INVESTIGATE_START');
+    }
+    update(ctx, _deltaMs) {
+        const now = ctx.now();
+        // ── Priority 1 — Panic → abort investigation, flee immediately ──────────
+        if (ctx.state.moraleState === 'PANICKED') {
+            ctx.halt();
+            ctx.transition(this.tr.investigateOnPanic);
+            return;
+        }
+        // ── Priority 2 — Visible enemy → escalate immediately ───────────────────
+        if (ctx.perception?.hasVisibleEnemy()) {
+            const enemies = ctx.perception.getVisibleEnemies();
+            const target = enemies[0];
+            ctx.state.lastKnownEnemyX = target.x;
+            ctx.state.lastKnownEnemyY = target.y;
+            ctx.state.targetId = target.id;
+            ctx.halt();
+            ctx.transition(this.tr.investigateOnEnemy);
+            return;
+        }
+        // ── Phase 2 — LOOK_AROUND (entered when investigateLookAroundStartMs >= 0) ──
+        if (ctx.state.investigateLookAroundStartMs >= 0) {
+            ctx.halt();
+            // Rotate to simulate scanning — two full sweeps over the look-around window.
+            // Jitter is derived deterministically from arrival timestamp to avoid
+            // consuming ctx.random() budget every frame.
+            const elapsed = now - ctx.state.investigateLookAroundStartMs;
+            const jitter = (ctx.state.investigateLookAroundStartMs % 1000) / 1000 * 0.2;
+            const sweepAngle = (elapsed / this.cfg.investigateLookAroundMs) * Math.PI * 4 + jitter;
+            ctx.setRotation(sweepAngle);
+            // Suspicion re-accumulation during look-around (opt-in)
+            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.investigateOnEnemy);
+                return;
+            }
+            // Timer expired → nothing found, deescalate
+            if (elapsed >= this.cfg.investigateLookAroundMs) {
+                ctx.suspicion?.clear();
+                ctx.halt();
+                ctx.transition(this.tr.investigateOnTimeout);
+            }
+            return;
+        }
+        // ── Phase 1 — APPROACH: move toward investigate target ──────────────────
+        // Overall timeout guard — prevents infinite approach on unreachable points
+        if (now - ctx.state.investigateStartMs >= this.cfg.investigateMaxDurationMs) {
+            ctx.suspicion?.clear();
+            ctx.halt();
+            ctx.transition(this.tr.investigateOnTimeout);
+            return;
+        }
+        // Suspicion re-spike during approach → skip look-around, escalate directly
+        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.investigateOnEnemy);
+            return;
+        }
+        const destX = ctx.state.lastKnownEnemyX;
+        const destY = ctx.state.lastKnownEnemyY;
+        const dx = destX - ctx.x;
+        const dy = destY - ctx.y;
+        const distSq = dx * dx + dy * dy;
+        const thresh = this.cfg.arriveThreshold;
+        if (distSq <= thresh * thresh) {
+            // Arrived — begin look-around phase
+            ctx.state.investigateLookAroundStartMs = now;
+            ctx.halt();
+            if (dx !== 0 || dy !== 0) {
+                ctx.setRotation(Math.atan2(dy, dx));
+            }
+            return;
+        }
+        moveToward(ctx, destX, destY, this.cfg.approachSpeed);
+    }
+    exit(ctx) {
+        ctx.state.investigateStartMs = 0;
+        ctx.state.investigateLookAroundStartMs = -1;
+        ctx.halt();
+    }
+}
+//# sourceMappingURL=InvestigateState.js.map

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

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

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

@@ -0,0 +1,27 @@
+import type { IOnlineStateHandler } from '../IOnlineStateHandler';
+import type { INPCContext } from '../INPCContext';
+import type { IStateConfig } from '../IStateConfig';
+import type { IStateTransitionMap } from '../IStateTransitionMap';
+/**
+ * Stateless five-phase kill-wounded handler (X-Ray 16 `stalker_kill_wounded` equivalent).
+ *
+ * A single instance can be shared across all NPC entities.
+ *
+ * Opt-in activation (add to the handler registry):
+ * ```ts
+ * const handlers = buildDefaultHandlerMap(cfg, {
+ *   combatOnKillWounded: 'KILL_WOUNDED',
+ *   alertOnKillWounded:  'KILL_WOUNDED',
+ * });
+ * handlers.register('KILL_WOUNDED', new KillWoundedState(cfg));
+ * ```
+ */
+export declare class KillWoundedState 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=KillWoundedState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KillWoundedState.d.ts","sourceRoot":"","sources":["../../../src/states/handlers/KillWoundedState.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAS,wBAAwB,CAAC;AACrE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAiB,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAgB,iBAAiB,CAAC;AAE9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAS,wBAAwB,CAAC;AAGrE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,mBAAmB;IAC1D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAuB;gBAE9B,GAAG,EAAE,YAAY,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC;IAKhE,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;IAU7B,MAAM,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA0HhD,IAAI,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAY7B"}