@ai-rpg-engine/modules 1.0.0

package/dist/belief-provenance.d.ts

@@ -0,0 +1,41 @@
+import type { EngineModule, WorldState, ScalarValue } from '@ai-rpg-engine/core';
+export type TraceStep = {
+    tick: number;
+    type: 'source-event' | 'perceived' | 'missed' | 'belief-formed' | 'rumor-scheduled' | 'rumor-delivered' | 'faction-belief-updated' | 'decayed' | 'reinforced' | 'pruned';
+    description: string;
+    data: Record<string, unknown>;
+};
+export type BeliefTrace = {
+    subject: string;
+    key: string;
+    holder: {
+        type: 'entity';
+        id: string;
+    } | {
+        type: 'faction';
+        id: string;
+    };
+    currentValue: ScalarValue | undefined;
+    currentConfidence: number;
+    chain: TraceStep[];
+};
+export declare function createBeliefProvenance(): EngineModule;
+/**
+ * Trace the provenance of an entity's belief.
+ * Reconstructs the chain: source event → perception → belief formation → rumor → faction.
+ */
+export declare function traceEntityBelief(world: WorldState, entityId: string, subject: string, key: string): BeliefTrace;
+/**
+ * Trace the provenance of a faction's belief.
+ * Reconstructs: source events → entity perceptions → rumors → faction belief.
+ */
+export declare function traceFactionBelief(world: WorldState, factionId: string, subject: string, key: string): BeliefTrace;
+/**
+ * Trace all beliefs held about a subject across all entities and factions.
+ */
+export declare function traceSubject(world: WorldState, subject: string): BeliefTrace[];
+/**
+ * Format a belief trace as a human-readable forensic narrative.
+ */
+export declare function formatBeliefTrace(trace: BeliefTrace): string;
+//# sourceMappingURL=belief-provenance.d.ts.map

package/dist/belief-provenance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"belief-provenance.d.ts","sourceRoot":"","sources":["../src/belief-provenance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EAEV,WAAW,EACZ,MAAM,qBAAqB,CAAC;AAY7B,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,QAAQ,GAAG,eAAe,GAC3D,iBAAiB,GAAG,iBAAiB,GAAG,wBAAwB,GAChE,SAAS,GAAG,YAAY,GAAG,QAAQ,CAAC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,YAAY,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB,CAAC;AAIF,wBAAgB,sBAAsB,IAAI,YAAY,CAWrD;AAID;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,UAAU,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,WAAW,CA+Fb;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,GACV,WAAW,CAgEb;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,MAAM,GACd,WAAW,EAAE,CA6Bf;AAID;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAuB5D"}

package/dist/belief-provenance.js

@@ -0,0 +1,254 @@
+// belief-provenance — end-to-end belief trace reconstruction
+// Answers "why does X believe Y?" by correlating data from perception,
+// cognition, rumor, and faction modules. No new state — reads existing logs.
+import { getCognition, getBelief } from './cognition-core.js';
+import { getPerceptionLog } from './perception-filter.js';
+import { getFactionCognition, getFactionBelief } from './faction-cognition.js';
+import { getRumorLog, getRumorsToFaction } from './rumor-propagation.js';
+// --- Module ---
+export function createBeliefProvenance() {
+    return {
+        id: 'belief-provenance',
+        version: '0.1.0',
+        dependsOn: ['cognition-core'],
+        register(_ctx) {
+            // Pure query module — no state, no event listeners
+            // All trace reconstruction happens via exported functions
+        },
+    };
+}
+// --- Trace API ---
+/**
+ * Trace the provenance of an entity's belief.
+ * Reconstructs the chain: source event → perception → belief formation → rumor → faction.
+ */
+export function traceEntityBelief(world, entityId, subject, key) {
+    const cognition = getCognition(world, entityId);
+    const belief = getBelief(cognition, subject, key);
+    const chain = [];
+    // Step 1: Find source events involving the subject
+    const relevantEvents = findRelevantEvents(world, subject, key);
+    for (const event of relevantEvents) {
+        chain.push({
+            tick: event.tick,
+            type: 'source-event',
+            description: `${event.type} involving ${subject}`,
+            data: {
+                eventId: event.id,
+                eventType: event.type,
+                actorId: event.actorId,
+                targetIds: event.targetIds,
+            },
+        });
+        // Step 2: Check if this entity perceived the event
+        if (world.modules['perception-filter']) {
+            const perceptionLog = getPerceptionLog(world, entityId);
+            const perception = perceptionLog.find((p) => p.eventId === event.id);
+            if (perception) {
+                chain.push({
+                    tick: perception.tick,
+                    type: perception.detected ? 'perceived' : 'missed',
+                    description: perception.detected
+                        ? `${entityId} detected via ${perception.sense} (clarity: ${perception.clarity.toFixed(2)})`
+                        : `${entityId} missed via ${perception.sense} (clarity: ${perception.clarity.toFixed(2)})`,
+                    data: {
+                        eventId: event.id,
+                        entityId,
+                        sense: perception.sense,
+                        clarity: perception.clarity,
+                        interpretation: perception.interpretation,
+                    },
+                });
+            }
+        }
+    }
+    // Step 3: Record belief formation
+    if (belief) {
+        chain.push({
+            tick: belief.tick,
+            type: 'belief-formed',
+            description: `${entityId} believes ${subject}.${key} = ${belief.value} (confidence: ${belief.confidence.toFixed(2)}, source: ${belief.source})`,
+            data: {
+                entityId,
+                subject: belief.subject,
+                key: belief.key,
+                value: belief.value,
+                confidence: belief.confidence,
+                source: belief.source,
+            },
+        });
+    }
+    // Step 4: Check for rumor propagation from this entity
+    if (world.modules['rumor-propagation']) {
+        const rumors = getRumorLog(world).filter((r) => r.sourceEntityId === entityId && r.subject === subject && r.key === key);
+        for (const rumor of rumors) {
+            chain.push({
+                tick: rumor.originTick,
+                type: 'rumor-scheduled',
+                description: `${entityId} rumored ${subject}.${key} to faction ${rumor.targetFactionId} (distortion: ${rumor.distortion.toFixed(3)})`,
+                data: {
+                    rumorId: rumor.id,
+                    sourceEntityId: rumor.sourceEntityId,
+                    targetFactionId: rumor.targetFactionId,
+                    confidence: rumor.confidence,
+                    distortion: rumor.distortion,
+                    hops: rumor.hops,
+                },
+            });
+        }
+    }
+    // Sort chain chronologically
+    chain.sort((a, b) => a.tick - b.tick);
+    return {
+        subject,
+        key,
+        holder: { type: 'entity', id: entityId },
+        currentValue: belief?.value,
+        currentConfidence: belief?.confidence ?? 0,
+        chain,
+    };
+}
+/**
+ * Trace the provenance of a faction's belief.
+ * Reconstructs: source events → entity perceptions → rumors → faction belief.
+ */
+export function traceFactionBelief(world, factionId, subject, key) {
+    const factionCog = getFactionCognition(world, factionId);
+    const factionBelief = getFactionBelief(factionCog, subject, key);
+    const chain = [];
+    // Find rumors that contributed to this faction belief
+    const rumors = getRumorsToFaction(world, factionId).filter((r) => r.subject === subject && r.key === key);
+    for (const rumor of rumors) {
+        // Trace back to the entity's belief and perception
+        const entityTrace = traceEntityBelief(world, rumor.sourceEntityId, subject, key);
+        // Include entity chain steps (avoiding duplicates)
+        for (const step of entityTrace.chain) {
+            if (!chain.find((s) => s.tick === step.tick && s.type === step.type && s.data.entityId === step.data.entityId)) {
+                chain.push(step);
+            }
+        }
+        // Add rumor delivery
+        chain.push({
+            tick: rumor.originTick + 1, // approximate delivery tick
+            type: 'rumor-delivered',
+            description: `Rumor from ${rumor.sourceEntityId} delivered to faction ${factionId} (confidence: ${rumor.confidence.toFixed(2)}, distortion: ${rumor.distortion.toFixed(3)})`,
+            data: {
+                rumorId: rumor.id,
+                sourceEntityId: rumor.sourceEntityId,
+                factionId,
+                confidence: rumor.confidence,
+                distortion: rumor.distortion,
+            },
+        });
+    }
+    // Add faction belief state
+    if (factionBelief) {
+        chain.push({
+            tick: factionBelief.lastUpdateTick,
+            type: 'faction-belief-updated',
+            description: `Faction ${factionId} believes ${subject}.${key} = ${factionBelief.value} (confidence: ${factionBelief.confidence.toFixed(2)}, ${factionBelief.sourceEntities.length} sources)`,
+            data: {
+                factionId,
+                subject: factionBelief.subject,
+                key: factionBelief.key,
+                value: factionBelief.value,
+                confidence: factionBelief.confidence,
+                sourceEntities: factionBelief.sourceEntities,
+                distortion: factionBelief.distortion,
+            },
+        });
+    }
+    // Sort chronologically
+    chain.sort((a, b) => a.tick - b.tick);
+    return {
+        subject,
+        key,
+        holder: { type: 'faction', id: factionId },
+        currentValue: factionBelief?.value,
+        currentConfidence: factionBelief?.confidence ?? 0,
+        chain,
+    };
+}
+/**
+ * Trace all beliefs held about a subject across all entities and factions.
+ */
+export function traceSubject(world, subject) {
+    const traces = [];
+    // Check all entity cognitions
+    const cogStates = world.modules['cognition-core']?.entityCognition ?? {};
+    for (const [entityId, cog] of Object.entries(cogStates)) {
+        const beliefs = cog.beliefs.filter((b) => b.subject === subject);
+        for (const belief of beliefs) {
+            traces.push(traceEntityBelief(world, entityId, subject, belief.key));
+        }
+    }
+    // Check all faction beliefs
+    if (world.modules['faction-cognition']) {
+        const factionState = world.modules['faction-cognition'];
+        for (const [factionId, fCog] of Object.entries(factionState.factionCognition)) {
+            const beliefs = fCog.beliefs.filter((b) => b.subject === subject);
+            for (const belief of beliefs) {
+                traces.push(traceFactionBelief(world, factionId, subject, belief.key));
+            }
+        }
+    }
+    return traces;
+}
+// --- Formatting (B3) ---
+/**
+ * Format a belief trace as a human-readable forensic narrative.
+ */
+export function formatBeliefTrace(trace) {
+    const lines = [];
+    const holderLabel = trace.holder.type === 'entity'
+        ? `Entity ${trace.holder.id}`
+        : `Faction ${trace.holder.id}`;
+    lines.push(`Belief Trace: ${holderLabel}`);
+    lines.push(`  Subject: ${trace.subject}`);
+    lines.push(`  Key: ${trace.key}`);
+    lines.push(`  Current: ${trace.currentValue ?? 'none'} (confidence: ${trace.currentConfidence.toFixed(2)})`);
+    lines.push('');
+    lines.push('  Chain:');
+    for (const step of trace.chain) {
+        const icon = getStepIcon(step.type);
+        lines.push(`    [tick ${step.tick}] ${icon} ${step.description}`);
+    }
+    if (trace.chain.length === 0) {
+        lines.push('    (no trace data available)');
+    }
+    return lines.join('\n');
+}
+function getStepIcon(type) {
+    switch (type) {
+        case 'source-event': return 'EVENT';
+        case 'perceived': return 'SEEN';
+        case 'missed': return 'MISSED';
+        case 'belief-formed': return 'BELIEF';
+        case 'rumor-scheduled': return 'RUMOR>';
+        case 'rumor-delivered': return 'RUMOR<';
+        case 'faction-belief-updated': return 'FACTION';
+        case 'decayed': return 'DECAY';
+        case 'reinforced': return 'REINF';
+        case 'pruned': return 'PRUNED';
+        default: return '???';
+    }
+}
+// --- Internal ---
+function findRelevantEvents(world, subject, key) {
+    return world.eventLog.filter((event) => {
+        // Events where the subject is involved
+        if (event.actorId === subject)
+            return true;
+        if (event.targetIds?.includes(subject))
+            return true;
+        // Events with matching payload fields
+        if (event.payload.entityId === subject)
+            return true;
+        if (event.payload.attackerId === subject)
+            return true;
+        if (event.payload.targetId === subject)
+            return true;
+        return false;
+    });
+}
+//# sourceMappingURL=belief-provenance.js.map

package/dist/belief-provenance.js.map

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

package/dist/belief-provenance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=belief-provenance.test.d.ts.map

package/dist/belief-provenance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"belief-provenance.test.d.ts","sourceRoot":"","sources":["../src/belief-provenance.test.ts"],"names":[],"mappings":""}

package/dist/belief-provenance.test.js

@@ -0,0 +1,139 @@
+import { describe, it, expect } from 'vitest';
+import { Engine } from '@ai-rpg-engine/core';
+import { traversalCore, combatCore, createCognitionCore, createPerceptionFilter, createEnvironmentCore, createFactionCognition, createRumorPropagation, createBeliefProvenance, traceEntityBelief, traceFactionBelief, traceSubject, formatBeliefTrace, } from './index.js';
+const manifest = {
+    id: 'provenance-test', title: '', version: '0.1.0',
+    engineVersion: '0.1.0', ruleset: 'test', modules: [], contentPacks: [],
+};
+const zones = [
+    { id: 'hall', roomId: 'r1', name: 'Hall', tags: [], neighbors: ['chamber'], light: 5 },
+    { id: 'chamber', roomId: 'r1', name: 'Chamber', tags: [], neighbors: ['hall'], light: 3 },
+];
+const player = {
+    id: 'player', blueprintId: 'p', type: 'player', name: 'Player',
+    tags: ['player'], stats: { vigor: 5, instinct: 6 }, resources: { hp: 20, stamina: 8 },
+    statuses: [], zoneId: 'hall',
+};
+const guard = {
+    id: 'guard', blueprintId: 'g', type: 'enemy', name: 'Guard',
+    tags: ['enemy'], stats: { vigor: 4, instinct: 5 }, resources: { hp: 15, stamina: 4 },
+    statuses: [], zoneId: 'chamber',
+    ai: { profileId: 'aggressive', goals: [], fears: [], alertLevel: 0, knowledge: {} },
+};
+function createTestEngine() {
+    const engine = new Engine({
+        manifest,
+        seed: 42,
+        modules: [
+            traversalCore,
+            combatCore,
+            createCognitionCore(),
+            createPerceptionFilter(),
+            createEnvironmentCore(),
+            createFactionCognition({
+                factions: [{ factionId: 'patrol', entityIds: ['guard'], cohesion: 0.9 }],
+            }),
+            createRumorPropagation({ propagationDelay: 1 }),
+            createBeliefProvenance(),
+        ],
+    });
+    for (const zone of zones)
+        engine.store.addZone(zone);
+    engine.store.addEntity({ ...player });
+    engine.store.addEntity({ ...guard });
+    engine.store.state.playerId = 'player';
+    engine.store.state.locationId = 'hall';
+    return engine;
+}
+describe('Belief Provenance', () => {
+    it('traces direct perception belief', () => {
+        const engine = createTestEngine();
+        // Player enters guard's zone → guard perceives player
+        engine.submitAction('move', { targetIds: ['chamber'] });
+        const trace = traceEntityBelief(engine.world, 'guard', 'player', 'present');
+        expect(trace.holder).toEqual({ type: 'entity', id: 'guard' });
+        expect(trace.subject).toBe('player');
+        expect(trace.key).toBe('present');
+        expect(trace.currentValue).toBe(true);
+        expect(trace.chain.length).toBeGreaterThan(0);
+        // Should have source-event and perceived steps
+        const types = trace.chain.map((s) => s.type);
+        expect(types).toContain('source-event');
+        expect(types).toContain('belief-formed');
+    });
+    it('traces combat belief through perception', () => {
+        const engine = createTestEngine();
+        engine.store.state.entities['player'].zoneId = 'chamber';
+        engine.store.state.locationId = 'chamber';
+        engine.submitAction('attack', { targetIds: ['guard'] });
+        const trace = traceEntityBelief(engine.world, 'guard', 'player', 'hostile');
+        expect(trace.currentValue).toBe(true);
+        expect(trace.currentConfidence).toBeGreaterThan(0);
+        expect(trace.chain.some((s) => s.type === 'source-event')).toBe(true);
+        expect(trace.chain.some((s) => s.type === 'belief-formed')).toBe(true);
+    });
+    it('traces faction belief through rumor chain', () => {
+        const engine = createTestEngine();
+        engine.store.state.entities['player'].zoneId = 'chamber';
+        engine.store.state.locationId = 'chamber';
+        // Attack guard → guard gets hostile belief → rumor scheduled
+        engine.submitAction('attack', { targetIds: ['guard'] });
+        // Advance ticks to deliver rumor
+        engine.submitAction('faction-tick');
+        engine.submitAction('faction-tick');
+        const trace = traceFactionBelief(engine.world, 'patrol', 'player', 'hostile');
+        expect(trace.holder).toEqual({ type: 'faction', id: 'patrol' });
+        expect(trace.currentValue).toBe(true);
+        expect(trace.currentConfidence).toBeGreaterThan(0);
+        const types = trace.chain.map((s) => s.type);
+        expect(types).toContain('rumor-scheduled');
+        expect(types).toContain('rumor-delivered');
+        expect(types).toContain('faction-belief-updated');
+    });
+    it('traceSubject finds all beliefs about a subject', () => {
+        const engine = createTestEngine();
+        engine.store.state.entities['player'].zoneId = 'chamber';
+        engine.store.state.locationId = 'chamber';
+        engine.submitAction('attack', { targetIds: ['guard'] });
+        engine.submitAction('faction-tick');
+        engine.submitAction('faction-tick');
+        const traces = traceSubject(engine.world, 'player');
+        expect(traces.length).toBeGreaterThan(0);
+        // Should have both entity and faction traces
+        const entityTraces = traces.filter((t) => t.holder.type === 'entity');
+        const factionTraces = traces.filter((t) => t.holder.type === 'faction');
+        expect(entityTraces.length).toBeGreaterThan(0);
+        expect(factionTraces.length).toBeGreaterThan(0);
+    });
+    it('formatBeliefTrace produces readable output', () => {
+        const engine = createTestEngine();
+        engine.store.state.entities['player'].zoneId = 'chamber';
+        engine.store.state.locationId = 'chamber';
+        engine.submitAction('attack', { targetIds: ['guard'] });
+        const trace = traceEntityBelief(engine.world, 'guard', 'player', 'hostile');
+        const formatted = formatBeliefTrace(trace);
+        expect(formatted).toContain('Belief Trace: Entity guard');
+        expect(formatted).toContain('Subject: player');
+        expect(formatted).toContain('Key: hostile');
+        expect(formatted).toContain('Chain:');
+        expect(formatted).toContain('EVENT');
+    });
+    it('handles missing belief gracefully', () => {
+        const engine = createTestEngine();
+        const trace = traceEntityBelief(engine.world, 'guard', 'nonexistent', 'unknown');
+        expect(trace.currentValue).toBeUndefined();
+        expect(trace.currentConfidence).toBe(0);
+        expect(trace.chain.length).toBe(0);
+    });
+    it('chain is sorted chronologically', () => {
+        const engine = createTestEngine();
+        engine.store.state.entities['player'].zoneId = 'chamber';
+        engine.store.state.locationId = 'chamber';
+        engine.submitAction('attack', { targetIds: ['guard'] });
+        const trace = traceEntityBelief(engine.world, 'guard', 'player', 'hostile');
+        for (let i = 1; i < trace.chain.length; i++) {
+            expect(trace.chain[i].tick).toBeGreaterThanOrEqual(trace.chain[i - 1].tick);
+        }
+    });
+});
+//# sourceMappingURL=belief-provenance.test.js.map

package/dist/belief-provenance.test.js.map

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

package/dist/cognition-core.d.ts

@@ -0,0 +1,89 @@
+import type { EngineModule, EntityState, WorldState, ScalarValue } from '@ai-rpg-engine/core';
+export type Belief = {
+    subject: string;
+    key: string;
+    value: ScalarValue;
+    confidence: number;
+    source: string;
+    tick: number;
+};
+export type Memory = {
+    id: string;
+    type: string;
+    tick: number;
+    entityId?: string;
+    zoneId?: string;
+    data: Record<string, ScalarValue>;
+};
+export type BeliefDecayConfig = {
+    /** Base decay rate per tick (default: 0.02) */
+    baseRate: number;
+    /** Minimum confidence before belief is pruned (default: 0.05) */
+    pruneThreshold: number;
+    /** Environmental instability multiplier (default: 0.5) */
+    instabilityFactor: number;
+};
+export type CognitionState = {
+    beliefs: Belief[];
+    memories: Memory[];
+    currentIntent: string | null;
+    morale: number;
+    suspicion: number;
+};
+export type PerceptionCheck = {
+    /** Can the observer detect the target? */
+    observerId: string;
+    targetId: string;
+    /** Detection difficulty (higher = harder to detect) */
+    difficulty: number;
+    /** What stat governs perception for this check */
+    stat: string;
+    /** Environment modifiers */
+    modifiers: {
+        source: string;
+        value: number;
+    }[];
+};
+export type PerceptionResult = {
+    detected: boolean;
+    roll: number;
+    threshold: number;
+    observerId: string;
+    targetId: string;
+};
+export type IntentOption = {
+    verb: string;
+    targetIds?: string[];
+    priority: number;
+    reason: string;
+};
+export type IntentProfile = {
+    id: string;
+    /** Generate possible intents given entity state and cognition */
+    evaluate: (entity: EntityState, cognition: CognitionState, world: WorldState) => IntentOption[];
+};
+export type CognitionCoreConfig = {
+    profiles?: IntentProfile[];
+    decay?: Partial<BeliefDecayConfig>;
+};
+export declare function createCognitionCore(configOrProfiles?: CognitionCoreConfig | IntentProfile[]): EngineModule;
+export declare function getCognition(world: WorldState, entityId: string): CognitionState;
+export declare function setBelief(cognition: CognitionState, subject: string, key: string, value: ScalarValue, confidence: number, source: string, tick: number): void;
+export declare function getBelief(cognition: CognitionState, subject: string, key: string): Belief | undefined;
+export declare function getBeliefValue(cognition: CognitionState, subject: string, key: string): ScalarValue | undefined;
+/** Does this entity believe something to be true? */
+export declare function believes(cognition: CognitionState, subject: string, key: string, value?: ScalarValue): boolean;
+export declare function addMemory(cognition: CognitionState, type: string, tick: number, data: Record<string, ScalarValue>, entityId?: string, zoneId?: string): void;
+export declare function getMemories(cognition: CognitionState, type?: string): Memory[];
+export declare function getRecentMemories(cognition: CognitionState, withinTicks: number, currentTick: number): Memory[];
+export declare function checkPerception(observer: EntityState, target: EntityState, world: WorldState, perceptionStat: string, baseDifficulty: number): PerceptionResult;
+export declare function selectIntent(entity: EntityState, cognition: CognitionState, world: WorldState, profile: IntentProfile): IntentOption | null;
+/** Built-in aggressive profile: attack visible hostiles, flee when low morale */
+export declare const aggressiveProfile: IntentProfile;
+/** Built-in cautious profile: observe first, attack only when confident */
+export declare const cautiousProfile: IntentProfile;
+/** Reinforce a belief by resetting its tick to current (prevents decay) */
+export declare function reinforceBelief(cognition: CognitionState, subject: string, key: string, tick: number, confidenceBoost?: number): boolean;
+/** Process belief decay for all entities */
+export declare function processBeliefDecay(world: WorldState, decayConfig: BeliefDecayConfig): void;
+//# sourceMappingURL=cognition-core.d.ts.map

package/dist/cognition-core.d.ts.map

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