@alife-sdk/ai 0.1.0

package/dist/perception/PerceptionQuery.js

@@ -0,0 +1,199 @@
+// perception/PerceptionQuery.ts
+// Pure math functions for spatial perception queries.
+// No side effects, no state — all functions are deterministic.
+// ---------------------------------------------------------------------------
+// Reusable scratch arrays — one per filter function.
+// Single-threaded, safe to reuse between calls.
+// ---------------------------------------------------------------------------
+const _visibleScratch = [];
+const _hearingScratch = [];
+const _hostileScratch = [];
+const _friendlyScratch = [];
+/**
+ * Check if a target is within a vision cone.
+ *
+ * Uses squared-distance for the range check (no sqrt).
+ * The vision cone is defined by a half-angle from the facing direction.
+ *
+ * @returns true if target is within range AND within the cone angle
+ */
+export function isInFOV(origin, facingAngle, target, visionRange, visionHalfAngle) {
+    const dx = target.x - origin.x;
+    const dy = target.y - origin.y;
+    const dSq = dx * dx + dy * dy;
+    if (dSq > visionRange * visionRange)
+        return false;
+    if (dSq === 0)
+        return true;
+    // Dot-product cone test — avoids Math.atan2 + normalizeAngle
+    const facingDx = Math.cos(facingAngle);
+    const facingDy = Math.sin(facingAngle);
+    const dot = dx * facingDx + dy * facingDy;
+    if (dot <= 0)
+        return false;
+    const cosHalfSq = Math.cos(visionHalfAngle) ** 2;
+    return dot * dot >= cosHalfSq * dSq;
+}
+/**
+ * Filter entities that are visible to the observer.
+ *
+ * Combines FOV cone test with alive check.
+ * O(n) where n = candidate count.
+ * Precomputes trig values once per call (same pattern as scanForEnemies).
+ * Returns a reusable scratch array — do not hold a reference across calls.
+ */
+export function filterVisibleEntities(origin, facingAngle, candidates, config) {
+    _visibleScratch.length = 0;
+    const rangeSq = config.visionRange * config.visionRange;
+    // Precompute trig once per observer — avoids per-entity cos/sin in isInFOV
+    const facingDx = Math.cos(facingAngle);
+    const facingDy = Math.sin(facingAngle);
+    const cosHalfSq = Math.cos(config.visionHalfAngle) ** 2;
+    for (const entity of candidates) {
+        if (!entity.isAlive)
+            continue;
+        const dx = entity.position.x - origin.x;
+        const dy = entity.position.y - origin.y;
+        const dSq = dx * dx + dy * dy;
+        if (dSq > rangeSq)
+            continue;
+        if (dSq === 0) {
+            _visibleScratch.push(entity);
+            continue;
+        }
+        // Dot-product cone test
+        const dot = dx * facingDx + dy * facingDy;
+        if (dot > 0 && dot * dot >= cosHalfSq * dSq) {
+            _visibleScratch.push(entity);
+        }
+    }
+    return _visibleScratch;
+}
+/**
+ * Filter entities that can hear a sound from a source.
+ *
+ * Sound is omnidirectional — no cone test, just distance.
+ * Uses squared-distance for performance.
+ * Returns a reusable scratch array — do not hold a reference across calls.
+ *
+ * @param source - Sound origin point
+ * @param soundRange - Maximum propagation range (px)
+ * @param entities - All candidate listeners
+ * @param hearingRange - Per-listener hearing range (overrides soundRange if smaller)
+ */
+export function filterHearingEntities(source, soundRange, entities, hearingRange) {
+    _hearingScratch.length = 0;
+    const effectiveRange = hearingRange !== undefined
+        ? Math.min(soundRange, hearingRange)
+        : soundRange;
+    const rangeSq = effectiveRange * effectiveRange;
+    for (const entity of entities) {
+        if (!entity.isAlive)
+            continue;
+        const dx = entity.position.x - source.x;
+        const dy = entity.position.y - source.y;
+        if (dx * dx + dy * dy <= rangeSq) {
+            _hearingScratch.push(entity);
+        }
+    }
+    return _hearingScratch;
+}
+/**
+ * Filter entities by faction hostility.
+ * Returns a reusable scratch array — do not hold a reference across calls.
+ *
+ * @param entities - Entity candidates
+ * @param observerFactionId - The observer's faction
+ * @param isHostile - Callback checking if two factions are hostile
+ */
+export function filterHostileEntities(entities, observerFactionId, isHostile) {
+    _hostileScratch.length = 0;
+    for (const entity of entities) {
+        if (entity.factionId === observerFactionId)
+            continue;
+        if (isHostile(observerFactionId, entity.factionId)) {
+            _hostileScratch.push(entity);
+        }
+    }
+    return _hostileScratch;
+}
+/**
+ * Filter entities that are friendlies (same faction OR non-hostile).
+ * Returns a reusable scratch array — do not hold a reference across calls.
+ */
+export function filterFriendlyEntities(entities, observerFactionId, isHostile) {
+    _friendlyScratch.length = 0;
+    for (const entity of entities) {
+        if (entity.factionId === observerFactionId) {
+            _friendlyScratch.push(entity);
+            continue;
+        }
+        if (!isHostile(observerFactionId, entity.factionId)) {
+            _friendlyScratch.push(entity);
+        }
+    }
+    return _friendlyScratch;
+}
+/**
+ * Calculate squared distance between two points.
+ * Avoid sqrt when only comparing relative distances.
+ */
+export function distanceSq(a, b) {
+    const dx = a.x - b.x;
+    const dy = a.y - b.y;
+    return dx * dx + dy * dy;
+}
+/**
+ * Find the closest entity to a position.
+ * Returns null if array is empty.
+ */
+export function findClosest(origin, entities) {
+    let best = null;
+    let bestDist = Infinity;
+    for (const entity of entities) {
+        const dist = distanceSq(origin, entity.position);
+        if (dist < bestDist) {
+            bestDist = dist;
+            best = entity;
+        }
+    }
+    return best;
+}
+/**
+ * Full perception scan: find visible hostile entities.
+ *
+ * Combines FOV filtering + faction filtering in a single pass.
+ * This is the primary query used by GOAP world state building.
+ */
+export function scanForEnemies(origin, facingAngle, candidates, observerFactionId, isHostile, config) {
+    const result = [];
+    const rangeSq = config.visionRange * config.visionRange;
+    // Precompute once per observer — avoid per-entity atan2
+    const facingDx = Math.cos(facingAngle);
+    const facingDy = Math.sin(facingAngle);
+    const cosHalfSq = Math.cos(config.visionHalfAngle) ** 2;
+    for (const entity of candidates) {
+        if (!entity.isAlive)
+            continue;
+        if (entity.factionId === observerFactionId)
+            continue;
+        if (!isHostile(observerFactionId, entity.factionId))
+            continue;
+        const dx = entity.position.x - origin.x;
+        const dy = entity.position.y - origin.y;
+        const dSq = dx * dx + dy * dy;
+        if (dSq > rangeSq)
+            continue;
+        if (dSq === 0) {
+            result.push(entity);
+            continue;
+        }
+        // Dot-product cone test
+        const dot = dx * facingDx + dy * facingDy;
+        if (dot > 0 && dot * dot >= cosHalfSq * dSq) {
+            result.push(entity);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=PerceptionQuery.js.map

package/dist/perception/PerceptionQuery.js.map

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

package/dist/perception/index.d.ts

@@ -0,0 +1,4 @@
+export { isInFOV, filterVisibleEntities, filterHearingEntities, filterHostileEntities, filterFriendlyEntities, distanceSq, findClosest, scanForEnemies, } from './PerceptionQuery';
+export { NPCSensors, filterFreshIntel } from './NPCSensors';
+export type { IPerceptibleEntity, IDetectionEvent, INPCSensorsConfig, } from './NPCSensors';
+//# sourceMappingURL=index.d.ts.map

package/dist/perception/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/perception/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC5D,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,cAAc,CAAC"}

package/dist/perception/index.js

@@ -0,0 +1,4 @@
+// perception sub-path barrel
+export { isInFOV, filterVisibleEntities, filterHearingEntities, filterHostileEntities, filterFriendlyEntities, distanceSq, findClosest, scanForEnemies, } from './PerceptionQuery';
+export { NPCSensors, filterFreshIntel } from './NPCSensors';
+//# sourceMappingURL=index.js.map

package/dist/perception/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/perception/index.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,OAAO,EACL,OAAO,EACP,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,UAAU,EACV,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/plugin/AIPlugin.d.ts

@@ -0,0 +1,71 @@
+import type { IALifePlugin, ALifeKernel, IRandom } from '@alife-sdk/core';
+import type { IOnlineAIConfig } from '../types/IOnlineAIConfig';
+import type { ICoverAccess } from '../states/INPCContext';
+import { CoverRegistry } from '../cover/CoverRegistry';
+import { CoverLockRegistry } from '../cover/CoverLockRegistry';
+import type { ICoverLockConfig } from '../cover/ICoverLockConfig';
+import { RestrictedZoneManager } from '../navigation/RestrictedZoneManager';
+/**
+ * Configuration for the AI plugin.
+ */
+export interface IAIPluginConfig {
+    readonly ai: IOnlineAIConfig;
+    /** Optional cover lock config overrides. Set to false to disable locking entirely. */
+    readonly coverLock?: Partial<ICoverLockConfig> | false;
+}
+export declare function createDefaultAIPluginConfig(): IAIPluginConfig;
+/**
+ * A-Life AI Plugin — tactical AI subsystem.
+ *
+ * Provides:
+ * - CoverRegistry for tactical cover management
+ * - RestrictedZoneManager for movement constraints
+ * - All pure-function utilities (weapon selection, transitions, animation)
+ *
+ * Optional port: ICoverPointSource for auto-populating cover points.
+ *
+ * @example
+ * ```ts
+ * const aiPlugin = new AIPlugin(random, config);
+ * kernel.use(aiPlugin);
+ *
+ * // After init:
+ * const cover = aiPlugin.coverRegistry;
+ * const zones = aiPlugin.restrictedZones;
+ * ```
+ */
+export declare class AIPlugin implements IALifePlugin {
+    readonly name = "ai";
+    readonly dependencies: readonly [];
+    readonly coverRegistry: CoverRegistry;
+    readonly coverLockRegistry: CoverLockRegistry | null;
+    readonly restrictedZones: RestrictedZoneManager;
+    private kernel;
+    private readonly config;
+    /**
+     * @param random     - Deterministic random source.
+     * @param config     - Plugin configuration overrides.
+     * @param timeFn     - Time source for cover lock TTL (ms). Required when
+     *                     cover locking is enabled (default). Pass `() => Date.now()`
+     *                     for real-time locking or integrate with your game clock.
+     */
+    constructor(random: IRandom, config?: Partial<IAIPluginConfig>, timeFn?: () => number);
+    install(kernel: ALifeKernel): void;
+    init(): void;
+    destroy(): void;
+    serialize(): Record<string, unknown>;
+    restore(state: Record<string, unknown>): void;
+    /**
+     * Create a per-NPC `ICoverAccess` adapter backed by this plugin's registries.
+     *
+     * The returned adapter is stateful — it tracks the last cover point found so
+     * that `lockLastFound()` can acquire a TTL lock without the caller managing
+     * point IDs. Create one adapter per NPC entity; do not share across entities.
+     *
+     * @param npcId - Stable NPC identifier (used for occupancy filtering and locking).
+     */
+    createCoverAccess(npcId: string): ICoverAccess;
+    /** Get the AI configuration. */
+    getConfig(): IOnlineAIConfig;
+}
+//# sourceMappingURL=AIPlugin.d.ts.map

package/dist/plugin/AIPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIPlugin.d.ts","sourceRoot":"","sources":["../../src/plugin/AIPlugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,qCAAqC,CAAC;AAGlG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,eAAe,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,KAAK,CAAC;CACxD;AAED,wBAAgB,2BAA2B,IAAI,eAAe,CAE7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,QAAS,YAAW,YAAY;IAC3C,QAAQ,CAAC,IAAI,QAAQ;IACrB,QAAQ,CAAC,YAAY,cAAe;IAEpC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,qBAAqB,CAAC;IAEhD,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IAEzC;;;;;;OAMG;gBACS,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,MAAM;IA2BrF,OAAO,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIlC,IAAI,IAAI,IAAI;IAcZ,OAAO,IAAI,IAAI;IAOf,SAAS,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmBpC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAoB7C;;;;;;;;OAQG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY;IAI9C,gCAAgC;IAChC,SAAS,IAAI,eAAe;CAG7B"}

package/dist/plugin/AIPlugin.js

@@ -0,0 +1,134 @@
+// plugin/AIPlugin.ts
+// A-Life AI plugin — registers the tactical AI subsystem with the kernel.
+import { createDefaultAIConfig } from '../config/createDefaultAIConfig';
+import { CoverRegistry } from '../cover/CoverRegistry';
+import { CoverLockRegistry } from '../cover/CoverLockRegistry';
+import { CoverAccessAdapter } from '../cover/CoverAccessAdapter';
+import { RestrictedZoneManager } from '../navigation/RestrictedZoneManager';
+import { AIPorts } from '../ports/AIPorts';
+export function createDefaultAIPluginConfig() {
+    return { ai: createDefaultAIConfig() };
+}
+/**
+ * A-Life AI Plugin — tactical AI subsystem.
+ *
+ * Provides:
+ * - CoverRegistry for tactical cover management
+ * - RestrictedZoneManager for movement constraints
+ * - All pure-function utilities (weapon selection, transitions, animation)
+ *
+ * Optional port: ICoverPointSource for auto-populating cover points.
+ *
+ * @example
+ * ```ts
+ * const aiPlugin = new AIPlugin(random, config);
+ * kernel.use(aiPlugin);
+ *
+ * // After init:
+ * const cover = aiPlugin.coverRegistry;
+ * const zones = aiPlugin.restrictedZones;
+ * ```
+ */
+export class AIPlugin {
+    /**
+     * @param random     - Deterministic random source.
+     * @param config     - Plugin configuration overrides.
+     * @param timeFn     - Time source for cover lock TTL (ms). Required when
+     *                     cover locking is enabled (default). Pass `() => Date.now()`
+     *                     for real-time locking or integrate with your game clock.
+     */
+    constructor(random, config, timeFn) {
+        this.name = 'ai';
+        this.dependencies = [];
+        this.kernel = null;
+        const merged = {
+            ai: createDefaultAIConfig(config?.ai),
+            coverLock: config?.coverLock,
+        };
+        this.config = merged;
+        // Create lock registry unless explicitly disabled.
+        const lockCfg = merged.coverLock;
+        if (lockCfg !== false) {
+            const fn = timeFn ?? (() => Date.now());
+            this.coverLockRegistry = new CoverLockRegistry(fn, lockCfg);
+        }
+        else {
+            this.coverLockRegistry = null;
+        }
+        this.coverRegistry = new CoverRegistry(merged.ai.cover, random, this.coverLockRegistry ?? undefined);
+        this.restrictedZones = new RestrictedZoneManager(merged.ai.navigation.restrictedZoneSafeMargin);
+    }
+    install(kernel) {
+        this.kernel = kernel;
+    }
+    init() {
+        // Auto-populate cover points if the host provided a source.
+        const source = this.kernel?.portRegistry.tryGet(AIPorts.CoverPointSource);
+        if (source) {
+            const points = source.getPoints({
+                minX: -Infinity,
+                minY: -Infinity,
+                maxX: Infinity,
+                maxY: Infinity,
+            });
+            this.coverRegistry.addPoints(points);
+        }
+    }
+    destroy() {
+        this.coverRegistry.clear();
+        this.coverLockRegistry?.clear();
+        this.restrictedZones.clear();
+        this.kernel = null;
+    }
+    serialize() {
+        // Cover locks are intentionally NOT serialized — they are ephemeral TTL
+        // reservations that expire within seconds. Persisting stale locks across
+        // save/load cycles would permanently block cover points with no recovery
+        // path. NPCs will re-acquire locks naturally on their next TakeCover/Retreat
+        // state entry after loading.
+        const zones = this.restrictedZones.getAllZones().map((z) => ({
+            id: z.id,
+            type: z.type,
+            x: z.x,
+            y: z.y,
+            radius: z.radius,
+            active: z.active,
+            metadata: z.metadata,
+        }));
+        return { zones };
+    }
+    restore(state) {
+        this.restrictedZones.clear();
+        const zones = state.zones;
+        if (zones) {
+            for (const z of zones) {
+                this.restrictedZones.addZone({
+                    id: z.id,
+                    type: z.type,
+                    x: z.x,
+                    y: z.y,
+                    radius: z.radius,
+                    active: z.active,
+                    metadata: z.metadata,
+                });
+            }
+        }
+    }
+    /**
+     * Create a per-NPC `ICoverAccess` adapter backed by this plugin's registries.
+     *
+     * The returned adapter is stateful — it tracks the last cover point found so
+     * that `lockLastFound()` can acquire a TTL lock without the caller managing
+     * point IDs. Create one adapter per NPC entity; do not share across entities.
+     *
+     * @param npcId - Stable NPC identifier (used for occupancy filtering and locking).
+     */
+    createCoverAccess(npcId) {
+        return new CoverAccessAdapter(this.coverRegistry, this.coverLockRegistry, npcId);
+    }
+    /** Get the AI configuration. */
+    getConfig() {
+        return this.config.ai;
+    }
+}
+//# sourceMappingURL=AIPlugin.js.map

package/dist/plugin/AIPlugin.js.map

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

package/dist/plugin/index.d.ts

@@ -0,0 +1,3 @@
+export { AIPlugin, createDefaultAIPluginConfig } from './AIPlugin';
+export type { IAIPluginConfig } from './AIPlugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AACnE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,3 @@
+// plugin sub-path barrel
+export { AIPlugin, createDefaultAIPluginConfig } from './AIPlugin';
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,OAAO,EAAE,QAAQ,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC"}

package/dist/ports/AIPorts.d.ts

@@ -0,0 +1,13 @@
+import type { ICoverPointSource } from './ICoverPointSource';
+import type { IPerceptionProvider } from './IPerceptionProvider';
+/**
+ * AI subsystem port tokens.
+ *
+ * All AI ports are optional — the plugin works without them but
+ * gains additional capabilities when they're provided.
+ */
+export declare const AIPorts: {
+    readonly CoverPointSource: import("@alife-sdk/core").PortToken<ICoverPointSource>;
+    readonly PerceptionProvider: import("@alife-sdk/core").PortToken<IPerceptionProvider>;
+};
+//# sourceMappingURL=AIPorts.d.ts.map

package/dist/ports/AIPorts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIPorts.d.ts","sourceRoot":"","sources":["../../src/ports/AIPorts.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,OAAO;;;CASV,CAAC"}

package/dist/ports/AIPorts.js

@@ -0,0 +1,14 @@
+// ports/AIPorts.ts
+// Port tokens for the AI plugin.
+import { createPortToken } from '@alife-sdk/core';
+/**
+ * AI subsystem port tokens.
+ *
+ * All AI ports are optional — the plugin works without them but
+ * gains additional capabilities when they're provided.
+ */
+export const AIPorts = {
+    CoverPointSource: createPortToken('coverPointSource', 'Provides cover point positions from host level data'),
+    PerceptionProvider: createPortToken('perceptionProvider', 'Provides spatial entity queries for perception system'),
+};
+//# sourceMappingURL=AIPorts.js.map

package/dist/ports/AIPorts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AIPorts.js","sourceRoot":"","sources":["../../src/ports/AIPorts.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,iCAAiC;AAEjC,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,gBAAgB,EAAE,eAAe,CAC/B,kBAAkB,EAClB,qDAAqD,CACtD;IACD,kBAAkB,EAAE,eAAe,CACjC,oBAAoB,EACpB,uDAAuD,CACxD;CACO,CAAC"}

package/dist/ports/ICoverPointSource.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Minimal cover point data from the host.
+ * The AI plugin converts these to full ICoverPoint objects.
+ */
+export interface ICoverPointData {
+    readonly x: number;
+    readonly y: number;
+    readonly radius?: number;
+}
+/**
+ * Port interface for providing cover point data to the AI system.
+ *
+ * The host implements this to feed cover point positions from its
+ * tilemap, level editor, or procedural generation system.
+ *
+ * This is an optional port — if not provided, cover points must
+ * be registered manually via `CoverRegistry.addPoint()`.
+ */
+export interface ICoverPointSource {
+    getPoints(bounds: {
+        readonly minX: number;
+        readonly minY: number;
+        readonly maxX: number;
+        readonly maxY: number;
+    }): readonly ICoverPointData[];
+}
+//# sourceMappingURL=ICoverPointSource.d.ts.map

package/dist/ports/ICoverPointSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoverPointSource.d.ts","sourceRoot":"","sources":["../../src/ports/ICoverPointSource.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,MAAM,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,GAAG,SAAS,eAAe,EAAE,CAAC;CAChC"}

package/dist/ports/ICoverPointSource.js

@@ -0,0 +1,4 @@
+// ports/ICoverPointSource.ts
+// Optional port — host can provide custom cover point data.
+export {};
+//# sourceMappingURL=ICoverPointSource.js.map

package/dist/ports/ICoverPointSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ICoverPointSource.js","sourceRoot":"","sources":["../../src/ports/ICoverPointSource.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,4DAA4D"}

package/dist/ports/IPerceptionProvider.d.ts

@@ -0,0 +1,42 @@
+import type { Vec2 } from '@alife-sdk/core';
+import type { IPerceivedEntity } from '../types/IPerceptionTypes';
+/**
+ * Port providing spatial entity queries for perception.
+ *
+ * The host implements this to bridge between the game's entity storage
+ * (e.g. Phaser sprites, ECS, etc.) and the SDK's pure perception queries.
+ *
+ * @example
+ * ```ts
+ * // Host implementation using Phaser scene
+ * const provider: IPerceptionProvider = {
+ *   getEntitiesInRadius(center, radius) {
+ *     return scene.physics.overlapCirc(center.x, center.y, radius)
+ *       .map(body => ({
+ *         entityId: body.gameObject.getData('npcId'),
+ *         position: { x: body.x, y: body.y },
+ *         factionId: body.gameObject.getData('factionId'),
+ *         isAlive: body.gameObject.active,
+ *       }));
+ *   },
+ *   isLineOfSightClear(from, to) {
+ *     // Raycast using physics engine
+ *     return !scene.physics.world.raycast(from, to).hasHit;
+ *   },
+ * };
+ * ```
+ */
+export interface IPerceptionProvider {
+    /**
+     * Get all perceivable entities within a radius.
+     * Used for both vision and hearing queries.
+     */
+    getEntitiesInRadius(center: Vec2, radius: number): readonly IPerceivedEntity[];
+    /**
+     * Check if there is a clear line of sight between two points.
+     * Used to refine vision checks (walls, obstacles).
+     * Optional — if not provided, LOS is assumed clear.
+     */
+    isLineOfSightClear?(from: Vec2, to: Vec2): boolean;
+}
+//# sourceMappingURL=IPerceptionProvider.d.ts.map

package/dist/ports/IPerceptionProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPerceptionProvider.d.ts","sourceRoot":"","sources":["../../src/ports/IPerceptionProvider.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,mBAAmB,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,gBAAgB,EAAE,CAAC;IAE/E;;;;OAIG;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC;CACpD"}

package/dist/ports/IPerceptionProvider.js

@@ -0,0 +1,4 @@
+// ports/IPerceptionProvider.ts
+// Port interface for entity perception data from the host.
+export {};
+//# sourceMappingURL=IPerceptionProvider.js.map

package/dist/ports/IPerceptionProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPerceptionProvider.js","sourceRoot":"","sources":["../../src/ports/IPerceptionProvider.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2DAA2D"}

package/dist/ports/index.d.ts

@@ -0,0 +1,4 @@
+export { AIPorts } from './AIPorts';
+export type { ICoverPointSource, ICoverPointData } from './ICoverPointSource';
+export type { IPerceptionProvider } from './IPerceptionProvider';
+//# sourceMappingURL=index.d.ts.map

package/dist/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC9E,YAAY,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/ports/index.js

@@ -0,0 +1,3 @@
+// ports sub-path barrel
+export { AIPorts } from './AIPorts';
+//# sourceMappingURL=index.js.map

package/dist/ports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ports/index.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC"}