@ai-rpg-engine/campaign-memory 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +104 -0
- package/dist/index.d.ts +9 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +7 -0
- package/dist/index.js.map +1 -0
- package/dist/journal.d.ts +26 -0
- package/dist/journal.d.ts.map +1 -0
- package/dist/journal.js +70 -0
- package/dist/journal.js.map +1 -0
- package/dist/journal.test.d.ts +2 -0
- package/dist/journal.test.d.ts.map +1 -0
- package/dist/journal.test.js +104 -0
- package/dist/journal.test.js.map +1 -0
- package/dist/memory-bank.d.ts +32 -0
- package/dist/memory-bank.d.ts.map +1 -0
- package/dist/memory-bank.js +174 -0
- package/dist/memory-bank.js.map +1 -0
- package/dist/memory-bank.test.d.ts +2 -0
- package/dist/memory-bank.test.d.ts.map +1 -0
- package/dist/memory-bank.test.js +162 -0
- package/dist/memory-bank.test.js.map +1 -0
- package/dist/relationship-effects.d.ts +14 -0
- package/dist/relationship-effects.d.ts.map +1 -0
- package/dist/relationship-effects.js +49 -0
- package/dist/relationship-effects.js.map +1 -0
- package/dist/types.d.ts +74 -0
- package/dist/types.d.ts.map +1 -0
- package/dist/types.js +12 -0
- package/dist/types.js.map +1 -0
- package/dist/validate.d.ts +11 -0
- package/dist/validate.d.ts.map +1 -0
- package/dist/validate.js +78 -0
- package/dist/validate.js.map +1 -0
- package/package.json +34 -0
package/README.md
ADDED
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
<p align="center">
|
|
2
|
+
<img src="https://raw.githubusercontent.com/mcp-tool-shop-org/brand/main/logos/ai-rpg-engine/readme.png" width="400" alt="AI RPG Engine">
|
|
3
|
+
</p>
|
|
4
|
+
|
|
5
|
+
# @ai-rpg-engine/campaign-memory
|
|
6
|
+
|
|
7
|
+
[](https://www.npmjs.com/package/@ai-rpg-engine/campaign-memory)
|
|
8
|
+
[](https://github.com/mcp-tool-shop-org/ai-rpg-engine/blob/main/LICENSE)
|
|
9
|
+
|
|
10
|
+
Persistent NPC memory, multi-axis relationships, and campaign journal for [AI RPG Engine](https://github.com/mcp-tool-shop-org/ai-rpg-engine).
|
|
11
|
+
|
|
12
|
+
## Install
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm install @ai-rpg-engine/campaign-memory
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## What It Does
|
|
19
|
+
|
|
20
|
+
NPCs remember what happened. Not just "hostile: true" — they track trust, fear, admiration, and familiarity across every interaction. Memories fade over time: vivid → faded → dim → forgotten. The campaign journal persists significant events across sessions.
|
|
21
|
+
|
|
22
|
+
## Usage
|
|
23
|
+
|
|
24
|
+
### Campaign Journal
|
|
25
|
+
|
|
26
|
+
```typescript
|
|
27
|
+
import { CampaignJournal } from '@ai-rpg-engine/campaign-memory';
|
|
28
|
+
|
|
29
|
+
const journal = new CampaignJournal();
|
|
30
|
+
|
|
31
|
+
// Record a significant event
|
|
32
|
+
const record = journal.record({
|
|
33
|
+
tick: 42,
|
|
34
|
+
category: 'kill',
|
|
35
|
+
actorId: 'player',
|
|
36
|
+
targetId: 'merchant_1',
|
|
37
|
+
zoneId: 'market',
|
|
38
|
+
description: 'Player killed the merchant during a robbery',
|
|
39
|
+
significance: 0.9,
|
|
40
|
+
witnesses: ['guard_1', 'bystander_2'],
|
|
41
|
+
data: { weapon: 'dagger' },
|
|
42
|
+
});
|
|
43
|
+
|
|
44
|
+
// Query the journal
|
|
45
|
+
const playerActions = journal.query({ actorId: 'player', category: 'kill' });
|
|
46
|
+
const merchantHistory = journal.getInvolving('merchant_1');
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### NPC Memory Bank
|
|
50
|
+
|
|
51
|
+
```typescript
|
|
52
|
+
import { NpcMemoryBank, applyRelationshipEffect } from '@ai-rpg-engine/campaign-memory';
|
|
53
|
+
|
|
54
|
+
const guardMemory = new NpcMemoryBank('guard_1');
|
|
55
|
+
|
|
56
|
+
// Guard witnesses the player killing a merchant
|
|
57
|
+
guardMemory.remember(record, 0.9, -0.8); // high salience, very negative
|
|
58
|
+
applyRelationshipEffect(guardMemory, record, 'witness');
|
|
59
|
+
|
|
60
|
+
// Check how the guard feels about the player
|
|
61
|
+
const rel = guardMemory.getRelationship('player');
|
|
62
|
+
// { trust: -0.15, fear: 0.25, admiration: -0.05, familiarity: 0 }
|
|
63
|
+
|
|
64
|
+
// Later, memories fade
|
|
65
|
+
guardMemory.consolidate(currentTick);
|
|
66
|
+
const memories = guardMemory.recall({ aboutEntity: 'player', minSalience: 0.5 });
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Relationship Axes
|
|
70
|
+
|
|
71
|
+
| Axis | Range | Meaning |
|
|
72
|
+
|------|-------|---------|
|
|
73
|
+
| trust | -1 to 1 | Distrust → Trust |
|
|
74
|
+
| fear | 0 to 1 | Unafraid → Terrified |
|
|
75
|
+
| admiration | -1 to 1 | Contempt → Admiration |
|
|
76
|
+
| familiarity | 0 to 1 | Stranger → Intimate |
|
|
77
|
+
|
|
78
|
+
### Record Categories
|
|
79
|
+
|
|
80
|
+
`action` · `combat` · `kill` · `betrayal` · `gift` · `theft` · `debt` · `discovery` · `alliance` · `insult` · `rescue` · `death`
|
|
81
|
+
|
|
82
|
+
Each category has default relationship effects. A rescue builds trust (+0.4) and admiration (+0.3). A betrayal destroys trust (-0.5).
|
|
83
|
+
|
|
84
|
+
### Memory Consolidation
|
|
85
|
+
|
|
86
|
+
Memories decay over time through three stages:
|
|
87
|
+
|
|
88
|
+
- **vivid** — high salience, recently formed
|
|
89
|
+
- **faded** — salience dropped below fade threshold
|
|
90
|
+
- **dim** — barely remembered, about to be forgotten
|
|
91
|
+
|
|
92
|
+
Configure decay rates per-NPC or globally.
|
|
93
|
+
|
|
94
|
+
## Serialization
|
|
95
|
+
|
|
96
|
+
Both `CampaignJournal` and `NpcMemoryBank` support `serialize()` and `deserialize()` for persistence across sessions.
|
|
97
|
+
|
|
98
|
+
## Part of AI RPG Engine
|
|
99
|
+
|
|
100
|
+
This package is part of the [AI RPG Engine](https://github.com/mcp-tool-shop-org/ai-rpg-engine) monorepo. It works standalone or integrates with the engine's cognition and rumor systems.
|
|
101
|
+
|
|
102
|
+
## License
|
|
103
|
+
|
|
104
|
+
MIT
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
export type { RelationshipAxes, RecordCategory, CampaignRecord, Consolidation, MemoryFragment, NpcMemoryEntry, NpcMemoryState, MemoryQuery, CampaignMemoryConfig, } from './types.js';
|
|
2
|
+
export { VALID_CATEGORIES, VALID_CONSOLIDATIONS, createDefaultRelationship, } from './types.js';
|
|
3
|
+
export { CampaignJournal } from './journal.js';
|
|
4
|
+
export type { JournalQueryFilters } from './journal.js';
|
|
5
|
+
export { NpcMemoryBank } from './memory-bank.js';
|
|
6
|
+
export { DEFAULT_RELATIONSHIP_EFFECTS, applyRelationshipEffect, } from './relationship-effects.js';
|
|
7
|
+
export type { ValidationError } from './validate.js';
|
|
8
|
+
export { validateCampaignRecord, validateRelationshipAxes, validateMemoryFragment, isValidCampaignRecord, isValidRelationshipAxes, } from './validate.js';
|
|
9
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,gBAAgB,EAChB,cAAc,EACd,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,cAAc,EACd,WAAW,EACX,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,eAAe,CAAC"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,7 @@
|
|
|
1
|
+
// @ai-rpg-engine/campaign-memory — persistent NPC memory and relationship model
|
|
2
|
+
export { VALID_CATEGORIES, VALID_CONSOLIDATIONS, createDefaultRelationship, } from './types.js';
|
|
3
|
+
export { CampaignJournal } from './journal.js';
|
|
4
|
+
export { NpcMemoryBank } from './memory-bank.js';
|
|
5
|
+
export { DEFAULT_RELATIONSHIP_EFFECTS, applyRelationshipEffect, } from './relationship-effects.js';
|
|
6
|
+
export { validateCampaignRecord, validateRelationshipAxes, validateMemoryFragment, isValidCampaignRecord, isValidRelationshipAxes, } from './validate.js';
|
|
7
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAchF,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,yBAAyB,GAC1B,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EACL,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,eAAe,CAAC"}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
import type { CampaignRecord, RecordCategory } from './types.js';
|
|
2
|
+
export type JournalQueryFilters = {
|
|
3
|
+
actorId?: string;
|
|
4
|
+
targetId?: string;
|
|
5
|
+
category?: RecordCategory;
|
|
6
|
+
minSignificance?: number;
|
|
7
|
+
afterTick?: number;
|
|
8
|
+
};
|
|
9
|
+
export declare class CampaignJournal {
|
|
10
|
+
private records;
|
|
11
|
+
/** Record a significant event. Returns the created record with generated ID. */
|
|
12
|
+
record(entry: Omit<CampaignRecord, 'id'>): CampaignRecord;
|
|
13
|
+
/** Get a specific record by ID */
|
|
14
|
+
get(id: string): CampaignRecord | undefined;
|
|
15
|
+
/** Query records by filters. All filters are ANDed together. */
|
|
16
|
+
query(filters: JournalQueryFilters): CampaignRecord[];
|
|
17
|
+
/** Get all records involving an entity (as actor or target) */
|
|
18
|
+
getInvolving(entityId: string): CampaignRecord[];
|
|
19
|
+
/** Number of records in the journal */
|
|
20
|
+
size(): number;
|
|
21
|
+
/** Serializable state for persistence */
|
|
22
|
+
serialize(): CampaignRecord[];
|
|
23
|
+
/** Restore from serialized state */
|
|
24
|
+
static deserialize(records: CampaignRecord[]): CampaignJournal;
|
|
25
|
+
}
|
|
26
|
+
//# sourceMappingURL=journal.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.d.ts","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAQjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAA0C;IAEzD,gFAAgF;IAChF,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,GAAG,cAAc;IAMzD,kCAAkC;IAClC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAI3C,gEAAgE;IAChE,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,cAAc,EAAE;IAsBrD,+DAA+D;IAC/D,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE;IAMhD,uCAAuC;IACvC,IAAI,IAAI,MAAM;IAId,yCAAyC;IACzC,SAAS,IAAI,cAAc,EAAE;IAI7B,oCAAoC;IACpC,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,eAAe;CAgB/D"}
|
package/dist/journal.js
ADDED
|
@@ -0,0 +1,70 @@
|
|
|
1
|
+
// CampaignJournal — persistent record of significant campaign events
|
|
2
|
+
let nextRecordId = 1;
|
|
3
|
+
function generateId() {
|
|
4
|
+
return `cr_${nextRecordId++}`;
|
|
5
|
+
}
|
|
6
|
+
export class CampaignJournal {
|
|
7
|
+
records = new Map();
|
|
8
|
+
/** Record a significant event. Returns the created record with generated ID. */
|
|
9
|
+
record(entry) {
|
|
10
|
+
const record = { id: generateId(), ...entry };
|
|
11
|
+
this.records.set(record.id, record);
|
|
12
|
+
return record;
|
|
13
|
+
}
|
|
14
|
+
/** Get a specific record by ID */
|
|
15
|
+
get(id) {
|
|
16
|
+
return this.records.get(id);
|
|
17
|
+
}
|
|
18
|
+
/** Query records by filters. All filters are ANDed together. */
|
|
19
|
+
query(filters) {
|
|
20
|
+
let results = Array.from(this.records.values());
|
|
21
|
+
if (filters.actorId !== undefined) {
|
|
22
|
+
results = results.filter((r) => r.actorId === filters.actorId);
|
|
23
|
+
}
|
|
24
|
+
if (filters.targetId !== undefined) {
|
|
25
|
+
results = results.filter((r) => r.targetId === filters.targetId);
|
|
26
|
+
}
|
|
27
|
+
if (filters.category !== undefined) {
|
|
28
|
+
results = results.filter((r) => r.category === filters.category);
|
|
29
|
+
}
|
|
30
|
+
if (filters.minSignificance !== undefined) {
|
|
31
|
+
results = results.filter((r) => r.significance >= filters.minSignificance);
|
|
32
|
+
}
|
|
33
|
+
if (filters.afterTick !== undefined) {
|
|
34
|
+
results = results.filter((r) => r.tick > filters.afterTick);
|
|
35
|
+
}
|
|
36
|
+
return results.sort((a, b) => a.tick - b.tick);
|
|
37
|
+
}
|
|
38
|
+
/** Get all records involving an entity (as actor or target) */
|
|
39
|
+
getInvolving(entityId) {
|
|
40
|
+
return Array.from(this.records.values())
|
|
41
|
+
.filter((r) => r.actorId === entityId || r.targetId === entityId)
|
|
42
|
+
.sort((a, b) => a.tick - b.tick);
|
|
43
|
+
}
|
|
44
|
+
/** Number of records in the journal */
|
|
45
|
+
size() {
|
|
46
|
+
return this.records.size;
|
|
47
|
+
}
|
|
48
|
+
/** Serializable state for persistence */
|
|
49
|
+
serialize() {
|
|
50
|
+
return Array.from(this.records.values()).sort((a, b) => a.tick - b.tick);
|
|
51
|
+
}
|
|
52
|
+
/** Restore from serialized state */
|
|
53
|
+
static deserialize(records) {
|
|
54
|
+
const journal = new CampaignJournal();
|
|
55
|
+
for (const record of records) {
|
|
56
|
+
journal.records.set(record.id, record);
|
|
57
|
+
}
|
|
58
|
+
// Ensure ID counter is ahead of existing records
|
|
59
|
+
let maxNum = 0;
|
|
60
|
+
for (const r of records) {
|
|
61
|
+
const match = r.id.match(/^cr_(\d+)$/);
|
|
62
|
+
if (match) {
|
|
63
|
+
maxNum = Math.max(maxNum, parseInt(match[1], 10));
|
|
64
|
+
}
|
|
65
|
+
}
|
|
66
|
+
nextRecordId = maxNum + 1;
|
|
67
|
+
return journal;
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
//# sourceMappingURL=journal.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.test.d.ts","sourceRoot":"","sources":["../src/journal.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,104 @@
|
|
|
1
|
+
import { describe, test, expect } from 'vitest';
|
|
2
|
+
import { CampaignJournal } from './journal.js';
|
|
3
|
+
function makeRecord(overrides = {}) {
|
|
4
|
+
return {
|
|
5
|
+
tick: 10,
|
|
6
|
+
category: 'combat',
|
|
7
|
+
actorId: 'player',
|
|
8
|
+
targetId: 'guard_1',
|
|
9
|
+
zoneId: 'hall',
|
|
10
|
+
description: 'Player attacked the guard',
|
|
11
|
+
significance: 0.7,
|
|
12
|
+
witnesses: ['bystander_1'],
|
|
13
|
+
data: { damage: 15 },
|
|
14
|
+
...overrides,
|
|
15
|
+
};
|
|
16
|
+
}
|
|
17
|
+
describe('CampaignJournal', () => {
|
|
18
|
+
test('record creates entry with generated ID', () => {
|
|
19
|
+
const journal = new CampaignJournal();
|
|
20
|
+
const record = journal.record(makeRecord());
|
|
21
|
+
expect(record.id).toMatch(/^cr_\d+$/);
|
|
22
|
+
expect(record.actorId).toBe('player');
|
|
23
|
+
expect(journal.size()).toBe(1);
|
|
24
|
+
});
|
|
25
|
+
test('get retrieves by ID', () => {
|
|
26
|
+
const journal = new CampaignJournal();
|
|
27
|
+
const record = journal.record(makeRecord());
|
|
28
|
+
expect(journal.get(record.id)).toBe(record);
|
|
29
|
+
expect(journal.get('nonexistent')).toBeUndefined();
|
|
30
|
+
});
|
|
31
|
+
test('query filters by actorId', () => {
|
|
32
|
+
const journal = new CampaignJournal();
|
|
33
|
+
journal.record(makeRecord({ actorId: 'player' }));
|
|
34
|
+
journal.record(makeRecord({ actorId: 'guard_1' }));
|
|
35
|
+
journal.record(makeRecord({ actorId: 'player' }));
|
|
36
|
+
const results = journal.query({ actorId: 'player' });
|
|
37
|
+
expect(results).toHaveLength(2);
|
|
38
|
+
expect(results.every((r) => r.actorId === 'player')).toBe(true);
|
|
39
|
+
});
|
|
40
|
+
test('query filters by category', () => {
|
|
41
|
+
const journal = new CampaignJournal();
|
|
42
|
+
journal.record(makeRecord({ category: 'combat' }));
|
|
43
|
+
journal.record(makeRecord({ category: 'gift' }));
|
|
44
|
+
journal.record(makeRecord({ category: 'combat' }));
|
|
45
|
+
const results = journal.query({ category: 'gift' });
|
|
46
|
+
expect(results).toHaveLength(1);
|
|
47
|
+
expect(results[0].category).toBe('gift');
|
|
48
|
+
});
|
|
49
|
+
test('query filters by minSignificance', () => {
|
|
50
|
+
const journal = new CampaignJournal();
|
|
51
|
+
journal.record(makeRecord({ significance: 0.2 }));
|
|
52
|
+
journal.record(makeRecord({ significance: 0.5 }));
|
|
53
|
+
journal.record(makeRecord({ significance: 0.9 }));
|
|
54
|
+
const results = journal.query({ minSignificance: 0.5 });
|
|
55
|
+
expect(results).toHaveLength(2);
|
|
56
|
+
expect(results.every((r) => r.significance >= 0.5)).toBe(true);
|
|
57
|
+
});
|
|
58
|
+
test('query filters by afterTick', () => {
|
|
59
|
+
const journal = new CampaignJournal();
|
|
60
|
+
journal.record(makeRecord({ tick: 5 }));
|
|
61
|
+
journal.record(makeRecord({ tick: 10 }));
|
|
62
|
+
journal.record(makeRecord({ tick: 15 }));
|
|
63
|
+
const results = journal.query({ afterTick: 10 });
|
|
64
|
+
expect(results).toHaveLength(1);
|
|
65
|
+
expect(results[0].tick).toBe(15);
|
|
66
|
+
});
|
|
67
|
+
test('query combines multiple filters', () => {
|
|
68
|
+
const journal = new CampaignJournal();
|
|
69
|
+
journal.record(makeRecord({ actorId: 'player', category: 'combat', significance: 0.8 }));
|
|
70
|
+
journal.record(makeRecord({ actorId: 'player', category: 'gift', significance: 0.9 }));
|
|
71
|
+
journal.record(makeRecord({ actorId: 'guard', category: 'combat', significance: 0.9 }));
|
|
72
|
+
const results = journal.query({ actorId: 'player', category: 'combat' });
|
|
73
|
+
expect(results).toHaveLength(1);
|
|
74
|
+
});
|
|
75
|
+
test('getInvolving returns records where entity is actor or target', () => {
|
|
76
|
+
const journal = new CampaignJournal();
|
|
77
|
+
journal.record(makeRecord({ actorId: 'player', targetId: 'guard_1' }));
|
|
78
|
+
journal.record(makeRecord({ actorId: 'guard_1', targetId: 'merchant' }));
|
|
79
|
+
journal.record(makeRecord({ actorId: 'merchant', targetId: 'thief' }));
|
|
80
|
+
const results = journal.getInvolving('guard_1');
|
|
81
|
+
expect(results).toHaveLength(2);
|
|
82
|
+
});
|
|
83
|
+
test('serialize and deserialize roundtrip', () => {
|
|
84
|
+
const journal = new CampaignJournal();
|
|
85
|
+
journal.record(makeRecord({ tick: 5 }));
|
|
86
|
+
journal.record(makeRecord({ tick: 10 }));
|
|
87
|
+
const serialized = journal.serialize();
|
|
88
|
+
expect(serialized).toHaveLength(2);
|
|
89
|
+
const restored = CampaignJournal.deserialize(serialized);
|
|
90
|
+
expect(restored.size()).toBe(2);
|
|
91
|
+
expect(restored.get(serialized[0].id)).toBeDefined();
|
|
92
|
+
});
|
|
93
|
+
test('results are sorted by tick', () => {
|
|
94
|
+
const journal = new CampaignJournal();
|
|
95
|
+
journal.record(makeRecord({ tick: 20 }));
|
|
96
|
+
journal.record(makeRecord({ tick: 5 }));
|
|
97
|
+
journal.record(makeRecord({ tick: 15 }));
|
|
98
|
+
const results = journal.query({});
|
|
99
|
+
expect(results[0].tick).toBe(5);
|
|
100
|
+
expect(results[1].tick).toBe(15);
|
|
101
|
+
expect(results[2].tick).toBe(20);
|
|
102
|
+
});
|
|
103
|
+
});
|
|
104
|
+
//# sourceMappingURL=journal.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"journal.test.js","sourceRoot":"","sources":["../src/journal.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
import type { CampaignRecord, CampaignMemoryConfig, MemoryFragment, MemoryQuery, NpcMemoryEntry, NpcMemoryState, RelationshipAxes } from './types.js';
|
|
2
|
+
export declare class NpcMemoryBank {
|
|
3
|
+
private state;
|
|
4
|
+
private config;
|
|
5
|
+
constructor(entityId: string, config?: CampaignMemoryConfig);
|
|
6
|
+
/** Get the entity ID this memory bank belongs to */
|
|
7
|
+
get entityId(): string;
|
|
8
|
+
/** Record that this NPC witnessed/experienced a campaign event */
|
|
9
|
+
remember(record: CampaignRecord, salience: number, emotionalCharge: number): void;
|
|
10
|
+
/** Get relationship with a specific entity */
|
|
11
|
+
getRelationship(subjectId: string): RelationshipAxes;
|
|
12
|
+
/** Adjust relationship axes. Values are clamped to valid ranges. */
|
|
13
|
+
adjustRelationship(subjectId: string, deltas: Partial<RelationshipAxes>): void;
|
|
14
|
+
/** Query memories across all subjects, filtered */
|
|
15
|
+
recall(query: MemoryQuery): MemoryFragment[];
|
|
16
|
+
/** Get the most salient memory about someone */
|
|
17
|
+
strongestMemory(subjectId: string): MemoryFragment | undefined;
|
|
18
|
+
/** Process memory decay — salience decreases over time, consolidation shifts */
|
|
19
|
+
consolidate(currentTick: number): void;
|
|
20
|
+
/** Does this NPC remember a specific event? */
|
|
21
|
+
remembers(recordId: string): boolean;
|
|
22
|
+
/** Get all entity IDs this NPC has memories about */
|
|
23
|
+
knownSubjects(): string[];
|
|
24
|
+
/** Get the full memory entry for a subject */
|
|
25
|
+
getEntry(subjectId: string): NpcMemoryEntry | undefined;
|
|
26
|
+
/** Serializable state */
|
|
27
|
+
serialize(): NpcMemoryState;
|
|
28
|
+
/** Restore from serialized state */
|
|
29
|
+
static deserialize(state: NpcMemoryState, config?: CampaignMemoryConfig): NpcMemoryBank;
|
|
30
|
+
private getOrCreateEntry;
|
|
31
|
+
}
|
|
32
|
+
//# sourceMappingURL=memory-bank.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-bank.d.ts","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAUpB,qBAAa,aAAa;IACxB,OAAO,CAAC,KAAK,CAAiB;IAC9B,OAAO,CAAC,MAAM,CAAiC;gBAEnC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,oBAAoB;IAK3D,oDAAoD;IACpD,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,kEAAkE;IAClE,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,IAAI;IA8BjF,8CAA8C;IAC9C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAMpD,oEAAoE;IACpE,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAkB9E,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,EAAE;IA2B5C,gDAAgD;IAChD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAa9D,gFAAgF;IAChF,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAwBtC,+CAA+C;IAC/C,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IASpC,qDAAqD;IACrD,aAAa,IAAI,MAAM,EAAE;IAIzB,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS;IAIvD,yBAAyB;IACzB,SAAS,IAAI,cAAc;IAI3B,oCAAoC;IACpC,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAQvF,OAAO,CAAC,gBAAgB;CAYzB"}
|
|
@@ -0,0 +1,174 @@
|
|
|
1
|
+
// NpcMemoryBank — per-NPC memory with relationship tracking and consolidation
|
|
2
|
+
import { createDefaultRelationship } from './types.js';
|
|
3
|
+
const DEFAULT_CONFIG = {
|
|
4
|
+
fadeThreshold: 0.3,
|
|
5
|
+
dimThreshold: 0.1,
|
|
6
|
+
decayRate: 0.005,
|
|
7
|
+
maxMemoriesPerSubject: 20,
|
|
8
|
+
};
|
|
9
|
+
export class NpcMemoryBank {
|
|
10
|
+
state;
|
|
11
|
+
config;
|
|
12
|
+
constructor(entityId, config) {
|
|
13
|
+
this.config = { ...DEFAULT_CONFIG, ...config };
|
|
14
|
+
this.state = { entityId, subjects: {} };
|
|
15
|
+
}
|
|
16
|
+
/** Get the entity ID this memory bank belongs to */
|
|
17
|
+
get entityId() {
|
|
18
|
+
return this.state.entityId;
|
|
19
|
+
}
|
|
20
|
+
/** Record that this NPC witnessed/experienced a campaign event */
|
|
21
|
+
remember(record, salience, emotionalCharge) {
|
|
22
|
+
// Determine the subject — the "other" entity from this NPC's perspective
|
|
23
|
+
const subjectId = record.actorId === this.state.entityId
|
|
24
|
+
? record.targetId
|
|
25
|
+
: record.actorId;
|
|
26
|
+
if (!subjectId)
|
|
27
|
+
return;
|
|
28
|
+
const entry = this.getOrCreateEntry(subjectId);
|
|
29
|
+
entry.lastInteractionTick = record.tick;
|
|
30
|
+
entry.interactionCount++;
|
|
31
|
+
// Add the memory fragment
|
|
32
|
+
const fragment = {
|
|
33
|
+
recordId: record.id,
|
|
34
|
+
salience: Math.max(0, Math.min(1, salience)),
|
|
35
|
+
emotionalCharge: Math.max(-1, Math.min(1, emotionalCharge)),
|
|
36
|
+
consolidation: 'vivid',
|
|
37
|
+
tick: record.tick,
|
|
38
|
+
};
|
|
39
|
+
entry.memories.push(fragment);
|
|
40
|
+
// Enforce max memories — drop lowest salience dim memories first
|
|
41
|
+
if (entry.memories.length > this.config.maxMemoriesPerSubject) {
|
|
42
|
+
entry.memories.sort((a, b) => b.salience - a.salience);
|
|
43
|
+
entry.memories.length = this.config.maxMemoriesPerSubject;
|
|
44
|
+
}
|
|
45
|
+
}
|
|
46
|
+
/** Get relationship with a specific entity */
|
|
47
|
+
getRelationship(subjectId) {
|
|
48
|
+
const entry = this.state.subjects[subjectId];
|
|
49
|
+
if (!entry)
|
|
50
|
+
return createDefaultRelationship();
|
|
51
|
+
return { ...entry.relationship };
|
|
52
|
+
}
|
|
53
|
+
/** Adjust relationship axes. Values are clamped to valid ranges. */
|
|
54
|
+
adjustRelationship(subjectId, deltas) {
|
|
55
|
+
const entry = this.getOrCreateEntry(subjectId);
|
|
56
|
+
const r = entry.relationship;
|
|
57
|
+
if (deltas.trust !== undefined) {
|
|
58
|
+
r.trust = clamp(r.trust + deltas.trust, -1, 1);
|
|
59
|
+
}
|
|
60
|
+
if (deltas.fear !== undefined) {
|
|
61
|
+
r.fear = clamp(r.fear + deltas.fear, 0, 1);
|
|
62
|
+
}
|
|
63
|
+
if (deltas.admiration !== undefined) {
|
|
64
|
+
r.admiration = clamp(r.admiration + deltas.admiration, -1, 1);
|
|
65
|
+
}
|
|
66
|
+
if (deltas.familiarity !== undefined) {
|
|
67
|
+
r.familiarity = clamp(r.familiarity + deltas.familiarity, 0, 1);
|
|
68
|
+
}
|
|
69
|
+
}
|
|
70
|
+
/** Query memories across all subjects, filtered */
|
|
71
|
+
recall(query) {
|
|
72
|
+
let results = [];
|
|
73
|
+
if (query.aboutEntity) {
|
|
74
|
+
const entry = this.state.subjects[query.aboutEntity];
|
|
75
|
+
if (!entry)
|
|
76
|
+
return [];
|
|
77
|
+
results = [...entry.memories];
|
|
78
|
+
}
|
|
79
|
+
else {
|
|
80
|
+
for (const entry of Object.values(this.state.subjects)) {
|
|
81
|
+
results.push(...entry.memories);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
if (query.minSalience !== undefined) {
|
|
85
|
+
results = results.filter((m) => m.salience >= query.minSalience);
|
|
86
|
+
}
|
|
87
|
+
if (query.consolidation !== undefined) {
|
|
88
|
+
results = results.filter((m) => m.consolidation === query.consolidation);
|
|
89
|
+
}
|
|
90
|
+
if (query.withinTicks !== undefined && query.currentTick !== undefined) {
|
|
91
|
+
const cutoff = query.currentTick - query.withinTicks;
|
|
92
|
+
results = results.filter((m) => m.tick >= cutoff);
|
|
93
|
+
}
|
|
94
|
+
return results.sort((a, b) => b.salience - a.salience);
|
|
95
|
+
}
|
|
96
|
+
/** Get the most salient memory about someone */
|
|
97
|
+
strongestMemory(subjectId) {
|
|
98
|
+
const entry = this.state.subjects[subjectId];
|
|
99
|
+
if (!entry || entry.memories.length === 0)
|
|
100
|
+
return undefined;
|
|
101
|
+
let strongest = entry.memories[0];
|
|
102
|
+
for (let i = 1; i < entry.memories.length; i++) {
|
|
103
|
+
if (entry.memories[i].salience > strongest.salience) {
|
|
104
|
+
strongest = entry.memories[i];
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
return strongest;
|
|
108
|
+
}
|
|
109
|
+
/** Process memory decay — salience decreases over time, consolidation shifts */
|
|
110
|
+
consolidate(currentTick) {
|
|
111
|
+
for (const entry of Object.values(this.state.subjects)) {
|
|
112
|
+
for (const mem of entry.memories) {
|
|
113
|
+
const elapsed = currentTick - mem.tick;
|
|
114
|
+
if (elapsed <= 0)
|
|
115
|
+
continue;
|
|
116
|
+
// Decay salience
|
|
117
|
+
mem.salience = Math.max(0, mem.salience - this.config.decayRate * elapsed);
|
|
118
|
+
// Update consolidation state
|
|
119
|
+
if (mem.salience < this.config.dimThreshold) {
|
|
120
|
+
mem.consolidation = 'dim';
|
|
121
|
+
}
|
|
122
|
+
else if (mem.salience < this.config.fadeThreshold) {
|
|
123
|
+
mem.consolidation = 'faded';
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
// Remove completely forgotten memories (salience 0 and dim)
|
|
127
|
+
entry.memories = entry.memories.filter((m) => m.salience > 0 || m.consolidation !== 'dim');
|
|
128
|
+
}
|
|
129
|
+
}
|
|
130
|
+
/** Does this NPC remember a specific event? */
|
|
131
|
+
remembers(recordId) {
|
|
132
|
+
for (const entry of Object.values(this.state.subjects)) {
|
|
133
|
+
if (entry.memories.some((m) => m.recordId === recordId)) {
|
|
134
|
+
return true;
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
return false;
|
|
138
|
+
}
|
|
139
|
+
/** Get all entity IDs this NPC has memories about */
|
|
140
|
+
knownSubjects() {
|
|
141
|
+
return Object.keys(this.state.subjects);
|
|
142
|
+
}
|
|
143
|
+
/** Get the full memory entry for a subject */
|
|
144
|
+
getEntry(subjectId) {
|
|
145
|
+
return this.state.subjects[subjectId];
|
|
146
|
+
}
|
|
147
|
+
/** Serializable state */
|
|
148
|
+
serialize() {
|
|
149
|
+
return JSON.parse(JSON.stringify(this.state));
|
|
150
|
+
}
|
|
151
|
+
/** Restore from serialized state */
|
|
152
|
+
static deserialize(state, config) {
|
|
153
|
+
const bank = new NpcMemoryBank(state.entityId, config);
|
|
154
|
+
bank.state = JSON.parse(JSON.stringify(state));
|
|
155
|
+
return bank;
|
|
156
|
+
}
|
|
157
|
+
// --- Internal ---
|
|
158
|
+
getOrCreateEntry(subjectId) {
|
|
159
|
+
if (!this.state.subjects[subjectId]) {
|
|
160
|
+
this.state.subjects[subjectId] = {
|
|
161
|
+
subjectId,
|
|
162
|
+
relationship: createDefaultRelationship(),
|
|
163
|
+
memories: [],
|
|
164
|
+
lastInteractionTick: 0,
|
|
165
|
+
interactionCount: 0,
|
|
166
|
+
};
|
|
167
|
+
}
|
|
168
|
+
return this.state.subjects[subjectId];
|
|
169
|
+
}
|
|
170
|
+
}
|
|
171
|
+
function clamp(value, min, max) {
|
|
172
|
+
return Math.max(min, Math.min(max, value));
|
|
173
|
+
}
|
|
174
|
+
//# sourceMappingURL=memory-bank.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-bank.js","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-bank.test.d.ts","sourceRoot":"","sources":["../src/memory-bank.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
import { describe, test, expect } from 'vitest';
|
|
2
|
+
import { NpcMemoryBank } from './memory-bank.js';
|
|
3
|
+
import { applyRelationshipEffect } from './relationship-effects.js';
|
|
4
|
+
function makeRecord(overrides = {}) {
|
|
5
|
+
return {
|
|
6
|
+
id: `cr_${Math.floor(Math.random() * 10000)}`,
|
|
7
|
+
tick: 10,
|
|
8
|
+
category: 'combat',
|
|
9
|
+
actorId: 'player',
|
|
10
|
+
targetId: 'guard_1',
|
|
11
|
+
zoneId: 'hall',
|
|
12
|
+
description: 'Player attacked the guard',
|
|
13
|
+
significance: 0.7,
|
|
14
|
+
witnesses: [],
|
|
15
|
+
data: {},
|
|
16
|
+
...overrides,
|
|
17
|
+
};
|
|
18
|
+
}
|
|
19
|
+
describe('NpcMemoryBank', () => {
|
|
20
|
+
test('remember stores a memory fragment', () => {
|
|
21
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
22
|
+
const record = makeRecord({ actorId: 'player', targetId: 'guard_1' });
|
|
23
|
+
bank.remember(record, 0.8, -0.5);
|
|
24
|
+
const memories = bank.recall({ aboutEntity: 'player' });
|
|
25
|
+
expect(memories).toHaveLength(1);
|
|
26
|
+
expect(memories[0].salience).toBe(0.8);
|
|
27
|
+
expect(memories[0].emotionalCharge).toBe(-0.5);
|
|
28
|
+
expect(memories[0].consolidation).toBe('vivid');
|
|
29
|
+
});
|
|
30
|
+
test('remember determines subject from perspective', () => {
|
|
31
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
32
|
+
// Guard is the target, so subject should be the actor (player)
|
|
33
|
+
bank.remember(makeRecord({ actorId: 'player', targetId: 'guard_1' }), 0.7, -0.3);
|
|
34
|
+
expect(bank.knownSubjects()).toEqual(['player']);
|
|
35
|
+
// Guard is the actor, so subject should be the target
|
|
36
|
+
const bank2 = new NpcMemoryBank('guard_1');
|
|
37
|
+
bank2.remember(makeRecord({ actorId: 'guard_1', targetId: 'merchant' }), 0.5, 0.1);
|
|
38
|
+
expect(bank2.knownSubjects()).toEqual(['merchant']);
|
|
39
|
+
});
|
|
40
|
+
test('getRelationship returns default for unknown entity', () => {
|
|
41
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
42
|
+
const rel = bank.getRelationship('unknown');
|
|
43
|
+
expect(rel.trust).toBe(0);
|
|
44
|
+
expect(rel.fear).toBe(0);
|
|
45
|
+
expect(rel.admiration).toBe(0);
|
|
46
|
+
expect(rel.familiarity).toBe(0);
|
|
47
|
+
});
|
|
48
|
+
test('adjustRelationship modifies axes and clamps values', () => {
|
|
49
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
50
|
+
bank.adjustRelationship('player', { trust: -0.3, fear: 0.5 });
|
|
51
|
+
const rel = bank.getRelationship('player');
|
|
52
|
+
expect(rel.trust).toBeCloseTo(-0.3);
|
|
53
|
+
expect(rel.fear).toBeCloseTo(0.5);
|
|
54
|
+
// Clamp test — push past bounds
|
|
55
|
+
bank.adjustRelationship('player', { trust: -2.0, fear: 2.0 });
|
|
56
|
+
const clamped = bank.getRelationship('player');
|
|
57
|
+
expect(clamped.trust).toBe(-1);
|
|
58
|
+
expect(clamped.fear).toBe(1);
|
|
59
|
+
});
|
|
60
|
+
test('recall filters by minSalience', () => {
|
|
61
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
62
|
+
bank.remember(makeRecord({ id: 'r1', actorId: 'player', targetId: 'guard_1' }), 0.9, -0.5);
|
|
63
|
+
bank.remember(makeRecord({ id: 'r2', actorId: 'player', targetId: 'guard_1' }), 0.2, -0.1);
|
|
64
|
+
const vivid = bank.recall({ aboutEntity: 'player', minSalience: 0.5 });
|
|
65
|
+
expect(vivid).toHaveLength(1);
|
|
66
|
+
expect(vivid[0].salience).toBe(0.9);
|
|
67
|
+
});
|
|
68
|
+
test('strongestMemory returns highest salience', () => {
|
|
69
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
70
|
+
bank.remember(makeRecord({ id: 'r1', actorId: 'player', targetId: 'guard_1' }), 0.3, -0.1);
|
|
71
|
+
bank.remember(makeRecord({ id: 'r2', actorId: 'player', targetId: 'guard_1' }), 0.9, -0.8);
|
|
72
|
+
bank.remember(makeRecord({ id: 'r3', actorId: 'player', targetId: 'guard_1' }), 0.5, -0.3);
|
|
73
|
+
const strongest = bank.strongestMemory('player');
|
|
74
|
+
expect(strongest?.salience).toBe(0.9);
|
|
75
|
+
});
|
|
76
|
+
test('consolidate decays salience and updates consolidation', () => {
|
|
77
|
+
const bank = new NpcMemoryBank('guard_1', { decayRate: 0.1, fadeThreshold: 0.5, dimThreshold: 0.2 });
|
|
78
|
+
bank.remember(makeRecord({ id: 'r1', actorId: 'player', targetId: 'guard_1', tick: 0 }), 0.8, -0.5);
|
|
79
|
+
// After 5 ticks with 0.1 decay rate: salience = 0.8 - 0.1 * 5 = 0.3
|
|
80
|
+
bank.consolidate(5);
|
|
81
|
+
const memories = bank.recall({ aboutEntity: 'player' });
|
|
82
|
+
expect(memories).toHaveLength(1);
|
|
83
|
+
expect(memories[0].salience).toBeCloseTo(0.3);
|
|
84
|
+
expect(memories[0].consolidation).toBe('faded');
|
|
85
|
+
});
|
|
86
|
+
test('consolidate removes fully forgotten memories', () => {
|
|
87
|
+
const bank = new NpcMemoryBank('guard_1', { decayRate: 0.1, dimThreshold: 0.05 });
|
|
88
|
+
bank.remember(makeRecord({ id: 'r1', actorId: 'player', targetId: 'guard_1', tick: 0 }), 0.3, -0.1);
|
|
89
|
+
// After 10 ticks: salience = 0.3 - 0.1 * 10 = -0.7 → clamped to 0
|
|
90
|
+
bank.consolidate(10);
|
|
91
|
+
const memories = bank.recall({ aboutEntity: 'player' });
|
|
92
|
+
expect(memories).toHaveLength(0);
|
|
93
|
+
});
|
|
94
|
+
test('remembers checks if a specific record is remembered', () => {
|
|
95
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
96
|
+
const record = makeRecord({ actorId: 'player', targetId: 'guard_1' });
|
|
97
|
+
bank.remember(record, 0.7, -0.3);
|
|
98
|
+
expect(bank.remembers(record.id)).toBe(true);
|
|
99
|
+
expect(bank.remembers('nonexistent')).toBe(false);
|
|
100
|
+
});
|
|
101
|
+
test('enforces maxMemoriesPerSubject', () => {
|
|
102
|
+
const bank = new NpcMemoryBank('guard_1', { maxMemoriesPerSubject: 3 });
|
|
103
|
+
for (let i = 0; i < 5; i++) {
|
|
104
|
+
bank.remember(makeRecord({ id: `r${i}`, actorId: 'player', targetId: 'guard_1' }), i * 0.2, // salience: 0, 0.2, 0.4, 0.6, 0.8
|
|
105
|
+
0);
|
|
106
|
+
}
|
|
107
|
+
const memories = bank.recall({ aboutEntity: 'player' });
|
|
108
|
+
expect(memories).toHaveLength(3);
|
|
109
|
+
// Should keep highest salience
|
|
110
|
+
expect(memories[0].salience).toBe(0.8);
|
|
111
|
+
});
|
|
112
|
+
test('serialize and deserialize roundtrip', () => {
|
|
113
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
114
|
+
bank.remember(makeRecord({ actorId: 'player', targetId: 'guard_1' }), 0.8, -0.5);
|
|
115
|
+
bank.adjustRelationship('player', { trust: -0.4, fear: 0.3 });
|
|
116
|
+
const state = bank.serialize();
|
|
117
|
+
const restored = NpcMemoryBank.deserialize(state);
|
|
118
|
+
expect(restored.entityId).toBe('guard_1');
|
|
119
|
+
expect(restored.recall({ aboutEntity: 'player' })).toHaveLength(1);
|
|
120
|
+
const rel = restored.getRelationship('player');
|
|
121
|
+
expect(rel.trust).toBeCloseTo(-0.4);
|
|
122
|
+
expect(rel.fear).toBeCloseTo(0.3);
|
|
123
|
+
});
|
|
124
|
+
});
|
|
125
|
+
describe('applyRelationshipEffect', () => {
|
|
126
|
+
test('applies target perspective deltas for combat', () => {
|
|
127
|
+
const bank = new NpcMemoryBank('guard_1');
|
|
128
|
+
const record = makeRecord({ actorId: 'player', targetId: 'guard_1', category: 'combat' });
|
|
129
|
+
applyRelationshipEffect(bank, record, 'target');
|
|
130
|
+
const rel = bank.getRelationship('player');
|
|
131
|
+
expect(rel.trust).toBeCloseTo(-0.1);
|
|
132
|
+
expect(rel.fear).toBeCloseTo(0.2);
|
|
133
|
+
});
|
|
134
|
+
test('applies witness perspective with 50% scaling', () => {
|
|
135
|
+
const bank = new NpcMemoryBank('bystander');
|
|
136
|
+
const record = makeRecord({ actorId: 'player', targetId: 'guard_1', category: 'kill' });
|
|
137
|
+
applyRelationshipEffect(bank, record, 'witness');
|
|
138
|
+
const rel = bank.getRelationship('player');
|
|
139
|
+
// kill: trust -0.3, fear 0.5, admiration -0.1 → halved for witness
|
|
140
|
+
expect(rel.trust).toBeCloseTo(-0.15);
|
|
141
|
+
expect(rel.fear).toBeCloseTo(0.25);
|
|
142
|
+
});
|
|
143
|
+
test('actor perspective increases familiarity', () => {
|
|
144
|
+
const bank = new NpcMemoryBank('player');
|
|
145
|
+
const record = makeRecord({ actorId: 'player', targetId: 'guard_1', category: 'gift' });
|
|
146
|
+
applyRelationshipEffect(bank, record, 'actor');
|
|
147
|
+
const rel = bank.getRelationship('guard_1');
|
|
148
|
+
// gift: trust 0.2, admiration 0.1, familiarity 0.1 + 0.05 actor bonus
|
|
149
|
+
expect(rel.trust).toBeCloseTo(0.2);
|
|
150
|
+
expect(rel.familiarity).toBeCloseTo(0.15);
|
|
151
|
+
});
|
|
152
|
+
test('rescue has strong positive effects', () => {
|
|
153
|
+
const bank = new NpcMemoryBank('merchant');
|
|
154
|
+
const record = makeRecord({ actorId: 'player', targetId: 'merchant', category: 'rescue' });
|
|
155
|
+
applyRelationshipEffect(bank, record, 'target');
|
|
156
|
+
const rel = bank.getRelationship('player');
|
|
157
|
+
expect(rel.trust).toBeCloseTo(0.4);
|
|
158
|
+
expect(rel.admiration).toBeCloseTo(0.3);
|
|
159
|
+
expect(rel.fear).toBeCloseTo(-0.1); // clamped to 0
|
|
160
|
+
});
|
|
161
|
+
});
|
|
162
|
+
//# sourceMappingURL=memory-bank.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"memory-bank.test.js","sourceRoot":"","sources":["../src/memory-bank.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import type { RecordCategory, RelationshipAxes, CampaignRecord } from './types.js';
|
|
2
|
+
import type { NpcMemoryBank } from './memory-bank.js';
|
|
3
|
+
/** Default relationship deltas per event category (from target's perspective) */
|
|
4
|
+
export declare const DEFAULT_RELATIONSHIP_EFFECTS: Record<RecordCategory, Partial<RelationshipAxes>>;
|
|
5
|
+
/**
|
|
6
|
+
* Apply default relationship effects for a campaign event.
|
|
7
|
+
*
|
|
8
|
+
* The `perspective` parameter controls how the deltas are applied:
|
|
9
|
+
* - `actor`: This NPC performed the action → familiarity increases
|
|
10
|
+
* - `target`: This NPC was the target → full default deltas apply
|
|
11
|
+
* - `witness`: This NPC observed the action → reduced deltas (50%)
|
|
12
|
+
*/
|
|
13
|
+
export declare function applyRelationshipEffect(bank: NpcMemoryBank, record: CampaignRecord, perspective: 'actor' | 'target' | 'witness'): void;
|
|
14
|
+
//# sourceMappingURL=relationship-effects.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relationship-effects.d.ts","sourceRoot":"","sources":["../src/relationship-effects.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACnF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,iFAAiF;AACjF,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAa1F,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,aAAa,EACnB,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,GAC1C,IAAI,CA2BN"}
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
// Default relationship effects — maps event categories to relationship deltas
|
|
2
|
+
/** Default relationship deltas per event category (from target's perspective) */
|
|
3
|
+
export const DEFAULT_RELATIONSHIP_EFFECTS = {
|
|
4
|
+
action: {},
|
|
5
|
+
combat: { trust: -0.1, fear: 0.2 },
|
|
6
|
+
kill: { trust: -0.3, fear: 0.5, admiration: -0.1 },
|
|
7
|
+
betrayal: { trust: -0.5, admiration: -0.2 },
|
|
8
|
+
gift: { trust: 0.2, admiration: 0.1, familiarity: 0.1 },
|
|
9
|
+
theft: { trust: -0.3 },
|
|
10
|
+
debt: { trust: -0.1 },
|
|
11
|
+
discovery: {},
|
|
12
|
+
alliance: { trust: 0.3, familiarity: 0.2 },
|
|
13
|
+
insult: { trust: -0.1, admiration: -0.2 },
|
|
14
|
+
rescue: { trust: 0.4, admiration: 0.3, fear: -0.1 },
|
|
15
|
+
death: { fear: 0.3 },
|
|
16
|
+
};
|
|
17
|
+
/**
|
|
18
|
+
* Apply default relationship effects for a campaign event.
|
|
19
|
+
*
|
|
20
|
+
* The `perspective` parameter controls how the deltas are applied:
|
|
21
|
+
* - `actor`: This NPC performed the action → familiarity increases
|
|
22
|
+
* - `target`: This NPC was the target → full default deltas apply
|
|
23
|
+
* - `witness`: This NPC observed the action → reduced deltas (50%)
|
|
24
|
+
*/
|
|
25
|
+
export function applyRelationshipEffect(bank, record, perspective) {
|
|
26
|
+
const baseDelta = DEFAULT_RELATIONSHIP_EFFECTS[record.category];
|
|
27
|
+
if (!baseDelta || Object.keys(baseDelta).length === 0)
|
|
28
|
+
return;
|
|
29
|
+
// Determine whose relationship is being affected
|
|
30
|
+
const subjectId = perspective === 'actor'
|
|
31
|
+
? record.targetId
|
|
32
|
+
: record.actorId;
|
|
33
|
+
if (!subjectId)
|
|
34
|
+
return;
|
|
35
|
+
// Scale deltas by perspective
|
|
36
|
+
const scale = perspective === 'witness' ? 0.5 : 1.0;
|
|
37
|
+
const scaled = {};
|
|
38
|
+
for (const [key, value] of Object.entries(baseDelta)) {
|
|
39
|
+
if (value !== undefined) {
|
|
40
|
+
scaled[key] = value * scale;
|
|
41
|
+
}
|
|
42
|
+
}
|
|
43
|
+
// For actors, always increase familiarity slightly
|
|
44
|
+
if (perspective === 'actor') {
|
|
45
|
+
scaled.familiarity = (scaled.familiarity ?? 0) + 0.05;
|
|
46
|
+
}
|
|
47
|
+
bank.adjustRelationship(subjectId, scaled);
|
|
48
|
+
}
|
|
49
|
+
//# sourceMappingURL=relationship-effects.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"relationship-effects.js","sourceRoot":"","sources":["../src/relationship-effects.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAK9E,iFAAiF;AACjF,MAAM,CAAC,MAAM,4BAA4B,GAAsD;IAC7F,MAAM,EAAK,EAAE;IACb,MAAM,EAAK,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;IACrC,IAAI,EAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;IACvD,QAAQ,EAAG,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;IAC5C,IAAI,EAAO,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;IAC5D,KAAK,EAAM,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE;IAC1B,IAAI,EAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE;IAC1B,SAAS,EAAE,EAAE;IACb,QAAQ,EAAG,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE;IAC3C,MAAM,EAAK,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,GAAG,EAAE;IAC5C,MAAM,EAAK,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE;IACtD,KAAK,EAAM,EAAE,IAAI,EAAE,GAAG,EAAE;CACzB,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAmB,EACnB,MAAsB,EACtB,WAA2C;IAE3C,MAAM,SAAS,GAAG,4BAA4B,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChE,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAE9D,iDAAiD;IACjD,MAAM,SAAS,GAAG,WAAW,KAAK,OAAO;QACvC,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAEnB,IAAI,CAAC,SAAS;QAAE,OAAO;IAEvB,8BAA8B;IAC9B,MAAM,KAAK,GAAG,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACpD,MAAM,MAAM,GAA8B,EAAE,CAAC;IAE7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACvB,MAAc,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,KAAK,CAAC;QACvC,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,WAAW,KAAK,OAAO,EAAE,CAAC;QAC5B,MAAM,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IACxD,CAAC;IAED,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}
|
package/dist/types.d.ts
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
/** Multi-axis relationship model beyond boolean hostile */
|
|
2
|
+
export type RelationshipAxes = {
|
|
3
|
+
/** -1 (distrust) to 1 (trust) */
|
|
4
|
+
trust: number;
|
|
5
|
+
/** 0 (unafraid) to 1 (terrified) */
|
|
6
|
+
fear: number;
|
|
7
|
+
/** -1 (contempt) to 1 (admiration) */
|
|
8
|
+
admiration: number;
|
|
9
|
+
/** 0 (stranger) to 1 (intimate) */
|
|
10
|
+
familiarity: number;
|
|
11
|
+
};
|
|
12
|
+
export type RecordCategory = 'action' | 'combat' | 'kill' | 'betrayal' | 'gift' | 'theft' | 'debt' | 'discovery' | 'alliance' | 'insult' | 'rescue' | 'death';
|
|
13
|
+
/** Persistent record of a significant action/event */
|
|
14
|
+
export type CampaignRecord = {
|
|
15
|
+
id: string;
|
|
16
|
+
tick: number;
|
|
17
|
+
category: RecordCategory;
|
|
18
|
+
actorId: string;
|
|
19
|
+
targetId?: string;
|
|
20
|
+
zoneId?: string;
|
|
21
|
+
description: string;
|
|
22
|
+
/** 0-1, how important this event is */
|
|
23
|
+
significance: number;
|
|
24
|
+
witnesses: string[];
|
|
25
|
+
data: Record<string, unknown>;
|
|
26
|
+
};
|
|
27
|
+
export type Consolidation = 'vivid' | 'faded' | 'dim';
|
|
28
|
+
/** Individual memory fragment held by an NPC */
|
|
29
|
+
export type MemoryFragment = {
|
|
30
|
+
recordId: string;
|
|
31
|
+
/** 0-1, how vivid/important to this NPC */
|
|
32
|
+
salience: number;
|
|
33
|
+
/** -1 (negative) to 1 (positive) */
|
|
34
|
+
emotionalCharge: number;
|
|
35
|
+
consolidation: Consolidation;
|
|
36
|
+
tick: number;
|
|
37
|
+
};
|
|
38
|
+
/** Per-NPC memory about a specific entity */
|
|
39
|
+
export type NpcMemoryEntry = {
|
|
40
|
+
subjectId: string;
|
|
41
|
+
relationship: RelationshipAxes;
|
|
42
|
+
memories: MemoryFragment[];
|
|
43
|
+
lastInteractionTick: number;
|
|
44
|
+
interactionCount: number;
|
|
45
|
+
};
|
|
46
|
+
/** Full NPC memory state */
|
|
47
|
+
export type NpcMemoryState = {
|
|
48
|
+
entityId: string;
|
|
49
|
+
subjects: Record<string, NpcMemoryEntry>;
|
|
50
|
+
};
|
|
51
|
+
/** Query filters for NPC memories */
|
|
52
|
+
export type MemoryQuery = {
|
|
53
|
+
aboutEntity?: string;
|
|
54
|
+
category?: RecordCategory;
|
|
55
|
+
minSalience?: number;
|
|
56
|
+
consolidation?: Consolidation;
|
|
57
|
+
withinTicks?: number;
|
|
58
|
+
currentTick?: number;
|
|
59
|
+
};
|
|
60
|
+
/** Campaign memory configuration */
|
|
61
|
+
export type CampaignMemoryConfig = {
|
|
62
|
+
/** Salience threshold below which memories consolidate to faded (default: 0.3) */
|
|
63
|
+
fadeThreshold?: number;
|
|
64
|
+
/** Salience threshold below which faded memories become dim (default: 0.1) */
|
|
65
|
+
dimThreshold?: number;
|
|
66
|
+
/** Salience decay rate per tick (default: 0.005) */
|
|
67
|
+
decayRate?: number;
|
|
68
|
+
/** Maximum memories per NPC per subject (default: 20) */
|
|
69
|
+
maxMemoriesPerSubject?: number;
|
|
70
|
+
};
|
|
71
|
+
export declare const VALID_CATEGORIES: readonly RecordCategory[];
|
|
72
|
+
export declare const VALID_CONSOLIDATIONS: readonly Consolidation[];
|
|
73
|
+
export declare function createDefaultRelationship(): RelationshipAxes;
|
|
74
|
+
//# sourceMappingURL=types.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,2DAA2D;AAC3D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,UAAU,GACV,MAAM,GACN,OAAO,GACP,MAAM,GACN,WAAW,GACX,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,OAAO,CAAC;AAEZ,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,KAAK,CAAC;AAEtD,gDAAgD;AAChD,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,aAAa,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,6CAA6C;AAC7C,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C,CAAC;AAEF,qCAAqC;AACrC,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,oBAAoB,GAAG;IACjC,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oDAAoD;IACpD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAG5C,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAE/C,CAAC;AAEX,wBAAgB,yBAAyB,IAAI,gBAAgB,CAE5D"}
|
package/dist/types.js
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
// Campaign memory types — persistent NPC memory and relationship model
|
|
2
|
+
export const VALID_CATEGORIES = [
|
|
3
|
+
'action', 'combat', 'kill', 'betrayal', 'gift', 'theft',
|
|
4
|
+
'debt', 'discovery', 'alliance', 'insult', 'rescue', 'death',
|
|
5
|
+
];
|
|
6
|
+
export const VALID_CONSOLIDATIONS = [
|
|
7
|
+
'vivid', 'faded', 'dim',
|
|
8
|
+
];
|
|
9
|
+
export function createDefaultRelationship() {
|
|
10
|
+
return { trust: 0, fear: 0, admiration: 0, familiarity: 0 };
|
|
11
|
+
}
|
|
12
|
+
//# sourceMappingURL=types.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AA6FvE,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO;IACvD,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO;CACpD,CAAC;AAEX,MAAM,CAAC,MAAM,oBAAoB,GAA6B;IAC5D,OAAO,EAAE,OAAO,EAAE,KAAK;CACf,CAAC;AAEX,MAAM,UAAU,yBAAyB;IACvC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;AAC9D,CAAC"}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
import type { CampaignRecord, RelationshipAxes } from './types.js';
|
|
2
|
+
export type ValidationError = {
|
|
3
|
+
field: string;
|
|
4
|
+
message: string;
|
|
5
|
+
};
|
|
6
|
+
export declare function validateCampaignRecord(record: unknown): ValidationError[];
|
|
7
|
+
export declare function validateRelationshipAxes(axes: unknown): ValidationError[];
|
|
8
|
+
export declare function validateMemoryFragment(fragment: unknown): ValidationError[];
|
|
9
|
+
export declare function isValidCampaignRecord(record: unknown): record is CampaignRecord;
|
|
10
|
+
export declare function isValidRelationshipAxes(axes: unknown): axes is RelationshipAxes;
|
|
11
|
+
//# sourceMappingURL=validate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EACd,gBAAgB,EAGjB,MAAM,YAAY,CAAC;AAGpB,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,EAAE,CA8BzE;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAqBzE;AAED,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,eAAe,EAAE,CAqB3E;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,cAAc,CAE/E;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,gBAAgB,CAE/E"}
|
package/dist/validate.js
ADDED
|
@@ -0,0 +1,78 @@
|
|
|
1
|
+
// Validation helpers for campaign memory types
|
|
2
|
+
import { VALID_CATEGORIES, VALID_CONSOLIDATIONS } from './types.js';
|
|
3
|
+
export function validateCampaignRecord(record) {
|
|
4
|
+
const errors = [];
|
|
5
|
+
if (!record || typeof record !== 'object') {
|
|
6
|
+
return [{ field: 'root', message: 'must be an object' }];
|
|
7
|
+
}
|
|
8
|
+
const r = record;
|
|
9
|
+
if (typeof r.id !== 'string' || r.id.length === 0) {
|
|
10
|
+
errors.push({ field: 'id', message: 'must be a non-empty string' });
|
|
11
|
+
}
|
|
12
|
+
if (typeof r.tick !== 'number' || r.tick < 0) {
|
|
13
|
+
errors.push({ field: 'tick', message: 'must be a non-negative number' });
|
|
14
|
+
}
|
|
15
|
+
if (!VALID_CATEGORIES.includes(r.category)) {
|
|
16
|
+
errors.push({ field: 'category', message: `must be one of: ${VALID_CATEGORIES.join(', ')}` });
|
|
17
|
+
}
|
|
18
|
+
if (typeof r.actorId !== 'string' || r.actorId.length === 0) {
|
|
19
|
+
errors.push({ field: 'actorId', message: 'must be a non-empty string' });
|
|
20
|
+
}
|
|
21
|
+
if (typeof r.description !== 'string') {
|
|
22
|
+
errors.push({ field: 'description', message: 'must be a string' });
|
|
23
|
+
}
|
|
24
|
+
if (typeof r.significance !== 'number' || r.significance < 0 || r.significance > 1) {
|
|
25
|
+
errors.push({ field: 'significance', message: 'must be a number between 0 and 1' });
|
|
26
|
+
}
|
|
27
|
+
if (!Array.isArray(r.witnesses)) {
|
|
28
|
+
errors.push({ field: 'witnesses', message: 'must be an array' });
|
|
29
|
+
}
|
|
30
|
+
return errors;
|
|
31
|
+
}
|
|
32
|
+
export function validateRelationshipAxes(axes) {
|
|
33
|
+
const errors = [];
|
|
34
|
+
if (!axes || typeof axes !== 'object') {
|
|
35
|
+
return [{ field: 'root', message: 'must be an object' }];
|
|
36
|
+
}
|
|
37
|
+
const a = axes;
|
|
38
|
+
if (typeof a.trust !== 'number' || a.trust < -1 || a.trust > 1) {
|
|
39
|
+
errors.push({ field: 'trust', message: 'must be a number between -1 and 1' });
|
|
40
|
+
}
|
|
41
|
+
if (typeof a.fear !== 'number' || a.fear < 0 || a.fear > 1) {
|
|
42
|
+
errors.push({ field: 'fear', message: 'must be a number between 0 and 1' });
|
|
43
|
+
}
|
|
44
|
+
if (typeof a.admiration !== 'number' || a.admiration < -1 || a.admiration > 1) {
|
|
45
|
+
errors.push({ field: 'admiration', message: 'must be a number between -1 and 1' });
|
|
46
|
+
}
|
|
47
|
+
if (typeof a.familiarity !== 'number' || a.familiarity < 0 || a.familiarity > 1) {
|
|
48
|
+
errors.push({ field: 'familiarity', message: 'must be a number between 0 and 1' });
|
|
49
|
+
}
|
|
50
|
+
return errors;
|
|
51
|
+
}
|
|
52
|
+
export function validateMemoryFragment(fragment) {
|
|
53
|
+
const errors = [];
|
|
54
|
+
if (!fragment || typeof fragment !== 'object') {
|
|
55
|
+
return [{ field: 'root', message: 'must be an object' }];
|
|
56
|
+
}
|
|
57
|
+
const f = fragment;
|
|
58
|
+
if (typeof f.recordId !== 'string' || f.recordId.length === 0) {
|
|
59
|
+
errors.push({ field: 'recordId', message: 'must be a non-empty string' });
|
|
60
|
+
}
|
|
61
|
+
if (typeof f.salience !== 'number' || f.salience < 0 || f.salience > 1) {
|
|
62
|
+
errors.push({ field: 'salience', message: 'must be a number between 0 and 1' });
|
|
63
|
+
}
|
|
64
|
+
if (typeof f.emotionalCharge !== 'number' || f.emotionalCharge < -1 || f.emotionalCharge > 1) {
|
|
65
|
+
errors.push({ field: 'emotionalCharge', message: 'must be a number between -1 and 1' });
|
|
66
|
+
}
|
|
67
|
+
if (!VALID_CONSOLIDATIONS.includes(f.consolidation)) {
|
|
68
|
+
errors.push({ field: 'consolidation', message: `must be one of: ${VALID_CONSOLIDATIONS.join(', ')}` });
|
|
69
|
+
}
|
|
70
|
+
return errors;
|
|
71
|
+
}
|
|
72
|
+
export function isValidCampaignRecord(record) {
|
|
73
|
+
return validateCampaignRecord(record).length === 0;
|
|
74
|
+
}
|
|
75
|
+
export function isValidRelationshipAxes(axes) {
|
|
76
|
+
return validateRelationshipAxes(axes).length === 0;
|
|
77
|
+
}
|
|
78
|
+
//# sourceMappingURL=validate.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAQ/C,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIpE,MAAM,UAAU,sBAAsB,CAAC,MAAe;IACpD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,CAAC,GAAG,MAAiC,CAAC;IAE5C,IAAI,OAAO,CAAC,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAe,CAAC,EAAE,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,mBAAmB,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;QACnF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,kBAAkB,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAa;IACpD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,CAAC,GAAG,IAA+B,CAAC;IAE1C,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC9E,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,CAAC,WAAW,GAAG,CAAC,EAAE,CAAC;QAChF,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,MAAM,MAAM,GAAsB,EAAE,CAAC;IACrC,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,EAAE,CAAC,CAAC;IAC3D,CAAC;IACD,MAAM,CAAC,GAAG,QAAmC,CAAC;IAE9C,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,4BAA4B,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,GAAG,CAAC,EAAE,CAAC;QACvE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,QAAQ,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,GAAG,CAAC,EAAE,CAAC;QAC7F,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mCAAmC,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAoB,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,mBAAmB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACzG,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,OAAO,sBAAsB,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAa;IACnD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;AACrD,CAAC"}
|
package/package.json
ADDED
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@ai-rpg-engine/campaign-memory",
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Persistent NPC memory, relationship axes, and campaign journal for AI RPG Engine",
|
|
5
|
+
"type": "module",
|
|
6
|
+
"main": "./dist/index.js",
|
|
7
|
+
"types": "./dist/index.d.ts",
|
|
8
|
+
"exports": {
|
|
9
|
+
".": {
|
|
10
|
+
"types": "./dist/index.d.ts",
|
|
11
|
+
"import": "./dist/index.js"
|
|
12
|
+
}
|
|
13
|
+
},
|
|
14
|
+
"files": ["dist"],
|
|
15
|
+
"scripts": {
|
|
16
|
+
"build": "tsc",
|
|
17
|
+
"test": "vitest run"
|
|
18
|
+
},
|
|
19
|
+
"license": "MIT",
|
|
20
|
+
"author": "mcp-tool-shop",
|
|
21
|
+
"homepage": "https://mcp-tool-shop-org.github.io/ai-rpg-engine/",
|
|
22
|
+
"repository": {
|
|
23
|
+
"type": "git",
|
|
24
|
+
"url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine.git",
|
|
25
|
+
"directory": "packages/campaign-memory"
|
|
26
|
+
},
|
|
27
|
+
"keywords": ["rpg", "npc", "memory", "relationship", "campaign", "journal", "game-engine"],
|
|
28
|
+
"bugs": {
|
|
29
|
+
"url": "https://github.com/mcp-tool-shop-org/ai-rpg-engine/issues"
|
|
30
|
+
},
|
|
31
|
+
"engines": {
|
|
32
|
+
"node": ">=20"
|
|
33
|
+
}
|
|
34
|
+
}
|