BoundedMemory

Capacity-capped memory with confidence decay, expiration, and safe handling of missing entities.

Constructor

new BoundedMemory(configopt)

Parameters:
NameTypeAttributesDescription
configObject<optional>

Classes

BoundedMemory

Methods

clear()

Clears all memory records.

decay(deltaTimeopt)

Decays confidence over time and forgets expired entries.

Parameters:
NameTypeAttributesDefaultDescription
deltaTimenumber<optional>
1

forget(target) → {boolean}

Forgets a target immediately.

Parameters:
NameTypeDescription
targetObject | string
Returns:
Type: 
boolean

get(target) → {Object|null}

Retrieves an entry for a target, handling destroyed and expired entities.

Parameters:
NameTypeDescription
targetObject | string
Returns:
Type: 
Object | null

getKnownTargets() → {Array}

Returns all active remembered entities.

Returns:
Type: 
Array

has(target) → {boolean}

Returns true if target is remembered with valid confidence.

Parameters:
NameTypeDescription
targetObject | string
Returns:
Type: 
boolean

pruneDestroyed() → {number}

Removes all destroyed entities currently held in memory.

Returns:
Type: 
number

record(target, optionsopt) → {Object|null}

Records or refreshes an observation record in memory.

Parameters:
NameTypeAttributesDescription
targetObject | string
optionsObject<optional>
Returns:
Type: 
Object | null

remember(target, optionsopt) → {Object|null}

Alias for record.

Parameters:
NameTypeAttributesDescription
targetObject | string
optionsObject<optional>
Returns:
Type: 
Object | null

restore(snapshot, entityResolveropt) → {BoundedMemory}

Restores memory state from a snapshot.

Parameters:
NameTypeAttributesDefaultDescription
snapshotObject
entityResolverfunction<optional>
null
Returns:
Type: 
BoundedMemory

serialize() → {Object}

Serializes memory state for save game snapshot.

Returns:
Type: 
Object

toJSON() → {Object}

JSON serialization support.

Returns:
Type: 
Object

update(deltaTimeopt)

Alias for decay.

Parameters:
NameTypeAttributesDefaultDescription
deltaTimenumber<optional>
1

values() → {Array}

Returns all active, non-expired memory records.

Returns:
Type: 
Array