@ai-rpg-engine/campaign-memory 2.1.7 → 2.5.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/LICENSE +21 -0
- package/README.es.md +45 -45
- package/README.fr.md +45 -45
- package/README.hi.md +45 -45
- package/README.it.md +45 -45
- package/README.ja.md +45 -45
- package/README.md +104 -104
- package/README.pt-BR.md +45 -45
- package/README.zh.md +45 -45
- package/dist/finale.js +2 -2
- package/dist/finale.js.map +1 -1
- package/dist/index.d.ts +2 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/dist/journal.d.ts +29 -5
- package/dist/journal.d.ts.map +1 -1
- package/dist/journal.js +80 -14
- package/dist/journal.js.map +1 -1
- package/dist/memory-bank.d.ts +17 -2
- package/dist/memory-bank.d.ts.map +1 -1
- package/dist/memory-bank.js +85 -5
- package/dist/memory-bank.js.map +1 -1
- package/dist/types.d.ts +24 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +9 -0
- package/dist/types.js.map +1 -1
- package/package.json +1 -1
package/dist/journal.js
CHANGED
|
@@ -1,13 +1,19 @@
|
|
|
1
1
|
// CampaignJournal — persistent record of significant campaign events
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
return `cr_${nextRecordId++}`;
|
|
5
|
-
}
|
|
2
|
+
import { CAMPAIGN_MEMORY_VERSION } from './types.js';
|
|
3
|
+
import { validateCampaignRecord } from './validate.js';
|
|
6
4
|
export class CampaignJournal {
|
|
7
5
|
records = new Map();
|
|
6
|
+
/**
|
|
7
|
+
* Per-instance ID counter. Record IDs depend only on (this journal's history),
|
|
8
|
+
* never on cross-instance order — see CP-01. Two journals number independently.
|
|
9
|
+
*/
|
|
10
|
+
nextRecordId = 1;
|
|
11
|
+
generateId() {
|
|
12
|
+
return `cr_${this.nextRecordId++}`;
|
|
13
|
+
}
|
|
8
14
|
/** Record a significant event. Returns the created record with generated ID. */
|
|
9
15
|
record(entry) {
|
|
10
|
-
const record = { id: generateId(), ...entry };
|
|
16
|
+
const record = { id: this.generateId(), ...entry };
|
|
11
17
|
this.records.set(record.id, record);
|
|
12
18
|
return record;
|
|
13
19
|
}
|
|
@@ -45,25 +51,85 @@ export class CampaignJournal {
|
|
|
45
51
|
size() {
|
|
46
52
|
return this.records.size;
|
|
47
53
|
}
|
|
48
|
-
/**
|
|
54
|
+
/**
|
|
55
|
+
* Serializable state for persistence, wrapped in a versioned envelope (CM-01)
|
|
56
|
+
* so a future record-schema change has a number to migrate on.
|
|
57
|
+
*/
|
|
49
58
|
serialize() {
|
|
50
|
-
return
|
|
59
|
+
return {
|
|
60
|
+
version: CAMPAIGN_MEMORY_VERSION,
|
|
61
|
+
records: Array.from(this.records.values()).sort((a, b) => a.tick - b.tick),
|
|
62
|
+
};
|
|
51
63
|
}
|
|
52
|
-
/**
|
|
53
|
-
|
|
64
|
+
/**
|
|
65
|
+
* Restore from serialized state. Accepts the versioned envelope written by
|
|
66
|
+
* `serialize()` AND the legacy bare-array format (saves written before
|
|
67
|
+
* CAMPAIGN_MEMORY_VERSION existed) — legacy saves upgrade to the envelope on
|
|
68
|
+
* their next serialize().
|
|
69
|
+
*
|
|
70
|
+
* CA-06: guards malformed input with a clear, actionable error instead of letting a raw
|
|
71
|
+
* TypeError escape ("records is not iterable", "cannot read 'id' of null"). The thrown
|
|
72
|
+
* Error names the offending element index/field and how to fix it.
|
|
73
|
+
*
|
|
74
|
+
* CM-01 extends the guard below the top level: an envelope stamped with a
|
|
75
|
+
* NEWER schema version is rejected (upgrade the package), and every record is
|
|
76
|
+
* validated field-by-field (tick, category, significance, witnesses, …) so a
|
|
77
|
+
* corrupt record fails HERE instead of NaN-sorting inside query() or throwing
|
|
78
|
+
* deep in buildFinaleOutline().
|
|
79
|
+
*/
|
|
80
|
+
static deserialize(input) {
|
|
81
|
+
let records;
|
|
82
|
+
if (Array.isArray(input)) {
|
|
83
|
+
// Legacy pre-versioning format: a bare array of records.
|
|
84
|
+
records = input;
|
|
85
|
+
}
|
|
86
|
+
else if (typeof input === 'object' && input !== null) {
|
|
87
|
+
const version = input.version;
|
|
88
|
+
if (typeof version !== 'number' || !Number.isFinite(version)) {
|
|
89
|
+
throw new Error(`CampaignJournal.deserialize: envelope version must be a number (got ${typeof version}) — expected the { version, records } value returned by serialize(), or a legacy array of records`);
|
|
90
|
+
}
|
|
91
|
+
if (version > CAMPAIGN_MEMORY_VERSION) {
|
|
92
|
+
throw new Error(`CampaignJournal.deserialize: save version ${version} is newer than supported version ${CAMPAIGN_MEMORY_VERSION} — upgrade @ai-rpg-engine/campaign-memory to load this save`);
|
|
93
|
+
}
|
|
94
|
+
const envRecords = input.records;
|
|
95
|
+
if (!Array.isArray(envRecords)) {
|
|
96
|
+
throw new Error(`CampaignJournal.deserialize: envelope records must be an array (got ${envRecords === null ? 'null' : typeof envRecords})`);
|
|
97
|
+
}
|
|
98
|
+
records = envRecords;
|
|
99
|
+
}
|
|
100
|
+
else {
|
|
101
|
+
throw new Error(`CampaignJournal.deserialize: expected an array of records or a { version, records } envelope (got ${input === null ? 'null' : typeof input}) — pass the value returned by serialize()`);
|
|
102
|
+
}
|
|
54
103
|
const journal = new CampaignJournal();
|
|
55
|
-
|
|
56
|
-
|
|
104
|
+
const restored = [];
|
|
105
|
+
for (let i = 0; i < records.length; i++) {
|
|
106
|
+
const record = records[i];
|
|
107
|
+
if (typeof record !== 'object' || record === null) {
|
|
108
|
+
throw new Error(`CampaignJournal.deserialize: record[${i}] must be an object (got ${record === null ? 'null' : typeof record})`);
|
|
109
|
+
}
|
|
110
|
+
if (typeof record.id !== 'string') {
|
|
111
|
+
throw new Error(`CampaignJournal.deserialize: record[${i}] is missing a string "id" — each record needs an id like "cr_1"`);
|
|
112
|
+
}
|
|
113
|
+
// CM-01: full per-record substructure validation (tick, category,
|
|
114
|
+
// significance, witnesses, …) via the shared validator.
|
|
115
|
+
const errors = validateCampaignRecord(record);
|
|
116
|
+
if (errors.length > 0) {
|
|
117
|
+
const detail = errors.map((e) => `${e.field} ${e.message}`).join('; ');
|
|
118
|
+
throw new Error(`CampaignJournal.deserialize: record[${i}] is invalid — ${detail}`);
|
|
119
|
+
}
|
|
120
|
+
const valid = record;
|
|
121
|
+
journal.records.set(valid.id, valid);
|
|
122
|
+
restored.push(valid);
|
|
57
123
|
}
|
|
58
|
-
//
|
|
124
|
+
// Advance THIS instance's counter past the highest restored id (CP-01).
|
|
59
125
|
let maxNum = 0;
|
|
60
|
-
for (const r of
|
|
126
|
+
for (const r of restored) {
|
|
61
127
|
const match = r.id.match(/^cr_(\d+)$/);
|
|
62
128
|
if (match) {
|
|
63
129
|
maxNum = Math.max(maxNum, parseInt(match[1], 10));
|
|
64
130
|
}
|
|
65
131
|
}
|
|
66
|
-
nextRecordId = maxNum + 1;
|
|
132
|
+
journal.nextRecordId = maxNum + 1;
|
|
67
133
|
return journal;
|
|
68
134
|
}
|
|
69
135
|
}
|
package/dist/journal.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"AAAA,qEAAqE;
|
|
1
|
+
{"version":3,"file":"journal.js","sourceRoot":"","sources":["../src/journal.ts"],"names":[],"mappings":"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"}
|
package/dist/memory-bank.d.ts
CHANGED
|
@@ -23,9 +23,24 @@ export declare class NpcMemoryBank {
|
|
|
23
23
|
knownSubjects(): string[];
|
|
24
24
|
/** Get the full memory entry for a subject */
|
|
25
25
|
getEntry(subjectId: string): NpcMemoryEntry | undefined;
|
|
26
|
-
/** Serializable state */
|
|
26
|
+
/** Serializable state, stamped with the current schema version (CM-02). */
|
|
27
27
|
serialize(): NpcMemoryState;
|
|
28
|
-
/**
|
|
28
|
+
/**
|
|
29
|
+
* Restore from serialized state.
|
|
30
|
+
*
|
|
31
|
+
* CA-06: guards malformed state with a clear, actionable error instead of building a
|
|
32
|
+
* half-formed bank that throws a raw TypeError on the next call. The thrown Error names
|
|
33
|
+
* the offending field and how to fix it.
|
|
34
|
+
*
|
|
35
|
+
* CM-02 extends the guard below the top level:
|
|
36
|
+
* - schema version check — a save stamped with a NEWER version than this
|
|
37
|
+
* package supports is rejected (upgrade the package); a save with no
|
|
38
|
+
* version is legacy v1 and loads normally.
|
|
39
|
+
* - per-subject validation — relationship axes, memory fragments, and
|
|
40
|
+
* interaction counters are checked, so a corrupt subject entry fails HERE
|
|
41
|
+
* (naming the subject and field) rather than as a raw TypeError deep in
|
|
42
|
+
* recall()/consolidate().
|
|
43
|
+
*/
|
|
29
44
|
static deserialize(state: NpcMemoryState, config?: CampaignMemoryConfig): NpcMemoryBank;
|
|
30
45
|
private getOrCreateEntry;
|
|
31
46
|
}
|
|
@@ -1 +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;
|
|
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;AAWpB,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;IAyBtC,+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;IAUvD,2EAA2E;IAC3E,SAAS,IAAI,cAAc;IAO3B;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa;IAgDvF,OAAO,CAAC,gBAAgB;CAYzB"}
|
package/dist/memory-bank.js
CHANGED
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
// NpcMemoryBank — per-NPC memory with relationship tracking and consolidation
|
|
2
|
-
import { createDefaultRelationship } from './types.js';
|
|
2
|
+
import { CAMPAIGN_MEMORY_VERSION, createDefaultRelationship } from './types.js';
|
|
3
|
+
import { validateMemoryFragment, validateRelationshipAxes } from './validate.js';
|
|
3
4
|
const DEFAULT_CONFIG = {
|
|
4
5
|
fadeThreshold: 0.3,
|
|
5
6
|
dimThreshold: 0.1,
|
|
@@ -152,14 +153,60 @@ export class NpcMemoryBank {
|
|
|
152
153
|
memories: entry.memories.map((m) => ({ ...m })),
|
|
153
154
|
};
|
|
154
155
|
}
|
|
155
|
-
/** Serializable state */
|
|
156
|
+
/** Serializable state, stamped with the current schema version (CM-02). */
|
|
156
157
|
serialize() {
|
|
157
|
-
return
|
|
158
|
+
return {
|
|
159
|
+
version: CAMPAIGN_MEMORY_VERSION,
|
|
160
|
+
...JSON.parse(JSON.stringify(this.state)),
|
|
161
|
+
};
|
|
158
162
|
}
|
|
159
|
-
/**
|
|
163
|
+
/**
|
|
164
|
+
* Restore from serialized state.
|
|
165
|
+
*
|
|
166
|
+
* CA-06: guards malformed state with a clear, actionable error instead of building a
|
|
167
|
+
* half-formed bank that throws a raw TypeError on the next call. The thrown Error names
|
|
168
|
+
* the offending field and how to fix it.
|
|
169
|
+
*
|
|
170
|
+
* CM-02 extends the guard below the top level:
|
|
171
|
+
* - schema version check — a save stamped with a NEWER version than this
|
|
172
|
+
* package supports is rejected (upgrade the package); a save with no
|
|
173
|
+
* version is legacy v1 and loads normally.
|
|
174
|
+
* - per-subject validation — relationship axes, memory fragments, and
|
|
175
|
+
* interaction counters are checked, so a corrupt subject entry fails HERE
|
|
176
|
+
* (naming the subject and field) rather than as a raw TypeError deep in
|
|
177
|
+
* recall()/consolidate().
|
|
178
|
+
*/
|
|
160
179
|
static deserialize(state, config) {
|
|
180
|
+
if (typeof state !== 'object' || state === null || Array.isArray(state)) {
|
|
181
|
+
throw new Error(`NpcMemoryBank.deserialize: expected a state object (got ${state === null ? 'null' : Array.isArray(state) ? 'array' : typeof state}) — pass the value returned by serialize()`);
|
|
182
|
+
}
|
|
183
|
+
const version = state.version;
|
|
184
|
+
if (version !== undefined) {
|
|
185
|
+
if (typeof version !== 'number' || !Number.isFinite(version)) {
|
|
186
|
+
throw new Error(`NpcMemoryBank.deserialize: state.version must be a number (got ${typeof version}) — legacy saves omit it entirely`);
|
|
187
|
+
}
|
|
188
|
+
if (version > CAMPAIGN_MEMORY_VERSION) {
|
|
189
|
+
throw new Error(`NpcMemoryBank.deserialize: state version ${version} is newer than supported version ${CAMPAIGN_MEMORY_VERSION} — upgrade @ai-rpg-engine/campaign-memory to load this save`);
|
|
190
|
+
}
|
|
191
|
+
}
|
|
192
|
+
if (typeof state.entityId !== 'string') {
|
|
193
|
+
throw new Error('NpcMemoryBank.deserialize: state is missing a string "entityId" — this is the NPC the bank belongs to');
|
|
194
|
+
}
|
|
195
|
+
const subjects = state.subjects;
|
|
196
|
+
if (typeof subjects !== 'object' || subjects === null || Array.isArray(subjects)) {
|
|
197
|
+
throw new Error(`NpcMemoryBank.deserialize: state.subjects must be an object mapping subjectId → entry (got ${subjects === undefined ? 'undefined' : subjects === null ? 'null' : Array.isArray(subjects) ? 'array' : typeof subjects})`);
|
|
198
|
+
}
|
|
199
|
+
for (const [subjectId, entry] of Object.entries(subjects)) {
|
|
200
|
+
validateSubjectEntry(subjectId, entry);
|
|
201
|
+
}
|
|
161
202
|
const bank = new NpcMemoryBank(state.entityId, config);
|
|
162
|
-
|
|
203
|
+
// Store WITHOUT the version stamp — the runtime state has no use for it,
|
|
204
|
+
// and serialize() re-stamps the current version (which also upgrades
|
|
205
|
+
// legacy saves on their next write).
|
|
206
|
+
bank.state = {
|
|
207
|
+
entityId: state.entityId,
|
|
208
|
+
subjects: JSON.parse(JSON.stringify(subjects)),
|
|
209
|
+
};
|
|
163
210
|
return bank;
|
|
164
211
|
}
|
|
165
212
|
// --- Internal ---
|
|
@@ -179,4 +226,37 @@ export class NpcMemoryBank {
|
|
|
179
226
|
function clamp(value, min, max) {
|
|
180
227
|
return Math.max(min, Math.min(max, value));
|
|
181
228
|
}
|
|
229
|
+
/**
|
|
230
|
+
* CM-02 per-subject guard. Throws an Error naming the offending subject and
|
|
231
|
+
* field. Reuses the validate.js helpers so the boundary check and the public
|
|
232
|
+
* validators cannot drift apart.
|
|
233
|
+
*/
|
|
234
|
+
function validateSubjectEntry(subjectId, entry) {
|
|
235
|
+
const at = `subjects["${subjectId}"]`;
|
|
236
|
+
if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
|
|
237
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at} must be an entry object (got ${entry === null ? 'null' : Array.isArray(entry) ? 'array' : typeof entry})`);
|
|
238
|
+
}
|
|
239
|
+
const e = entry;
|
|
240
|
+
const relErrors = validateRelationshipAxes(e.relationship);
|
|
241
|
+
if (relErrors.length > 0) {
|
|
242
|
+
const first = relErrors[0];
|
|
243
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at}.relationship${first.field === 'root' ? '' : '.' + first.field} ${first.message}`);
|
|
244
|
+
}
|
|
245
|
+
if (!Array.isArray(e.memories)) {
|
|
246
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at}.memories must be an array of memory fragments (got ${e.memories === null ? 'null' : typeof e.memories})`);
|
|
247
|
+
}
|
|
248
|
+
for (let i = 0; i < e.memories.length; i++) {
|
|
249
|
+
const fragErrors = validateMemoryFragment(e.memories[i]);
|
|
250
|
+
if (fragErrors.length > 0) {
|
|
251
|
+
const first = fragErrors[0];
|
|
252
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at}.memories[${i}]${first.field === 'root' ? '' : '.' + first.field} ${first.message}`);
|
|
253
|
+
}
|
|
254
|
+
}
|
|
255
|
+
if (typeof e.lastInteractionTick !== 'number' || Number.isNaN(e.lastInteractionTick)) {
|
|
256
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at}.lastInteractionTick must be a number (got ${typeof e.lastInteractionTick})`);
|
|
257
|
+
}
|
|
258
|
+
if (typeof e.interactionCount !== 'number' || Number.isNaN(e.interactionCount)) {
|
|
259
|
+
throw new Error(`NpcMemoryBank.deserialize: ${at}.interactionCount must be a number (got ${typeof e.interactionCount})`);
|
|
260
|
+
}
|
|
261
|
+
}
|
|
182
262
|
//# sourceMappingURL=memory-bank.js.map
|
package/dist/memory-bank.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"memory-bank.js","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"memory-bank.js","sourceRoot":"","sources":["../src/memory-bank.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAW9E,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAEjF,MAAM,cAAc,GAAmC;IACrD,aAAa,EAAE,GAAG;IAClB,YAAY,EAAE,GAAG;IACjB,SAAS,EAAE,KAAK;IAChB,qBAAqB,EAAE,EAAE;CAC1B,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,KAAK,CAAiB;IACtB,MAAM,CAAiC;IAE/C,YAAY,QAAgB,EAAE,MAA6B;QACzD,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,oDAAoD;IACpD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;IAED,kEAAkE;IAClE,QAAQ,CAAC,MAAsB,EAAE,QAAgB,EAAE,eAAuB;QACxE,yEAAyE;QACzE,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ;YACtD,CAAC,CAAC,MAAM,CAAC,QAAQ;YACjB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAEnB,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC,IAAI,CAAC;QACxC,KAAK,CAAC,gBAAgB,EAAE,CAAC;QAEzB,0BAA0B;QAC1B,MAAM,QAAQ,GAAmB;YAC/B,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC5C,eAAe,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC;YAC3D,aAAa,EAAE,OAAO;YACtB,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;QAEF,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAE9B,iEAAiE;QACjE,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAC9D,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;YACvD,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,8CAA8C;IAC9C,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,yBAAyB,EAAE,CAAC;QAC/C,OAAO,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,kBAAkB,CAAC,SAAiB,EAAE,MAAiC;QACrE,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,KAAK,CAAC,YAAY,CAAC;QAE7B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjD,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;YACpC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,CAAC,CAAC,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,MAAM,CAAC,KAAkB;QACvB,IAAI,OAAO,GAAqB,EAAE,CAAC;QAEnC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YACrD,IAAI,CAAC,KAAK;gBAAE,OAAO,EAAE,CAAC;YACtB,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACvD,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAED,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACpC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,IAAI,KAAK,CAAC,WAAY,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACtC,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,IAAI,KAAK,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;YACrD,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACzD,CAAC;IAED,gDAAgD;IAChD,eAAe,CAAC,SAAiB;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QAE5D,IAAI,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACpD,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gFAAgF;IAChF,WAAW,CAAC,WAAmB;QAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC;gBACvC,IAAI,OAAO,IAAI,CAAC;oBAAE,SAAS;gBAE3B,iBAAiB;gBACjB,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,OAAO,CAAC,CAAC;gBAC3E,GAAG,CAAC,IAAI,GAAG,WAAW,CAAC;gBAEvB,6BAA6B;gBAC7B,IAAI,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;oBAC5C,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC;gBAC5B,CAAC;qBAAM,IAAI,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;oBACpD,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC;gBAC9B,CAAC;YACH,CAAC;YAED,4DAA4D;YAC5D,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,CAAC,aAAa,KAAK,KAAK,CACnD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+CAA+C;IAC/C,SAAS,CAAC,QAAgB;QACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,EAAE,CAAC;gBACxD,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qDAAqD;IACrD,aAAa;QACX,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,8CAA8C;IAC9C,QAAQ,CAAC,SAAiB;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,OAAO;YACL,GAAG,KAAK;YACR,YAAY,EAAE,EAAE,GAAG,KAAK,CAAC,YAAY,EAAE;YACvC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;SAChD,CAAC;IACJ,CAAC;IAED,2EAA2E;IAC3E,SAAS;QACP,OAAO;YACL,OAAO,EAAE,uBAAuB;YAChC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;SAC1C,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,WAAW,CAAC,KAAqB,EAAE,MAA6B;QACrE,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACxE,MAAM,IAAI,KAAK,CACb,2DAA2D,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,4CAA4C,CAC/K,CAAC;QACJ,CAAC;QACD,MAAM,OAAO,GAAI,KAA+B,CAAC,OAAO,CAAC;QACzD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,KAAK,CACb,kEAAkE,OAAO,OAAO,mCAAmC,CACpH,CAAC;YACJ,CAAC;YACD,IAAI,OAAO,GAAG,uBAAuB,EAAE,CAAC;gBACtC,MAAM,IAAI,KAAK,CACb,4CAA4C,OAAO,oCAAoC,uBAAuB,6DAA6D,CAC5K,CAAC;YACJ,CAAC;QACH,CAAC;QACD,IAAI,OAAQ,KAAgC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnE,MAAM,IAAI,KAAK,CACb,uGAAuG,CACxG,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAI,KAAgC,CAAC,QAAQ,CAAC;QAC5D,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YACjF,MAAM,IAAI,KAAK,CACb,8FACE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,QACjH,GAAG,CACJ,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAmC,CAAC,EAAE,CAAC;YACrF,oBAAoB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvD,yEAAyE;QACzE,qEAAqE;QACrE,qCAAqC;QACrC,IAAI,CAAC,KAAK,GAAG;YACX,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;SAC/C,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB;IAEX,gBAAgB,CAAC,SAAiB;QACxC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG;gBAC/B,SAAS;gBACT,YAAY,EAAE,yBAAyB,EAAE;gBACzC,QAAQ,EAAE,EAAE;gBACZ,mBAAmB,EAAE,CAAC;gBACtB,gBAAgB,EAAE,CAAC;aACpB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACxC,CAAC;CACF;AAED,SAAS,KAAK,CAAC,KAAa,EAAE,GAAW,EAAE,GAAW;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;;;GAIG;AACH,SAAS,oBAAoB,CAAC,SAAiB,EAAE,KAAc;IAC7D,MAAM,EAAE,GAAG,aAAa,SAAS,IAAI,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,iCAAiC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,KAAK,GAAG,CAC5I,CAAC;IACJ,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAE3C,MAAM,SAAS,GAAG,wBAAwB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IAC3D,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,gBAAgB,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CACnH,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,uDAAuD,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,GAAG,CAC3I,CAAC;IACJ,CAAC;IACD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3C,MAAM,UAAU,GAAG,sBAAsB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,aAAa,CAAC,IAAI,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CACrH,CAAC;QACJ,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,CAAC,mBAAmB,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACrF,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,8CAA8C,OAAO,CAAC,CAAC,mBAAmB,GAAG,CAC9G,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,CAAC,gBAAgB,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CACb,8BAA8B,EAAE,2CAA2C,OAAO,CAAC,CAAC,gBAAgB,GAAG,CACxG,CAAC;IACJ,CAAC;AACH,CAAC"}
|
package/dist/types.d.ts
CHANGED
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Current campaign-memory schema version (CM-01/CM-02). Stamped into every
|
|
3
|
+
* value returned by `NpcMemoryBank.serialize()` / `CampaignJournal.serialize()`
|
|
4
|
+
* and checked by both `deserialize()`s: saves with a NEWER version are rejected
|
|
5
|
+
* with an actionable error; saves with no version (written before this constant
|
|
6
|
+
* existed) load as legacy v1. Mirrors character-profile's PROFILE_VERSION so a
|
|
7
|
+
* future schema change has a number to migrate on.
|
|
8
|
+
*/
|
|
9
|
+
export declare const CAMPAIGN_MEMORY_VERSION = 1;
|
|
1
10
|
/** Multi-axis relationship model beyond boolean hostile */
|
|
2
11
|
export type RelationshipAxes = {
|
|
3
12
|
/** -1 (distrust) to 1 (trust) */
|
|
@@ -45,9 +54,24 @@ export type NpcMemoryEntry = {
|
|
|
45
54
|
};
|
|
46
55
|
/** Full NPC memory state */
|
|
47
56
|
export type NpcMemoryState = {
|
|
57
|
+
/**
|
|
58
|
+
* Schema version, stamped by `NpcMemoryBank.serialize()`. Optional because
|
|
59
|
+
* legacy saves (pre-versioning) lack it — `deserialize()` treats a missing
|
|
60
|
+
* version as v1 and re-stamps on the next serialize.
|
|
61
|
+
*/
|
|
62
|
+
version?: number;
|
|
48
63
|
entityId: string;
|
|
49
64
|
subjects: Record<string, NpcMemoryEntry>;
|
|
50
65
|
};
|
|
66
|
+
/**
|
|
67
|
+
* Versioned journal save envelope, returned by `CampaignJournal.serialize()`.
|
|
68
|
+
* `CampaignJournal.deserialize()` also accepts a bare `CampaignRecord[]`
|
|
69
|
+
* (the legacy pre-versioning format).
|
|
70
|
+
*/
|
|
71
|
+
export type SerializedJournal = {
|
|
72
|
+
version: number;
|
|
73
|
+
records: CampaignRecord[];
|
|
74
|
+
};
|
|
51
75
|
/** Query filters for NPC memories */
|
|
52
76
|
export type MemoryQuery = {
|
|
53
77
|
aboutEntity?: string;
|
package/dist/types.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAEzC,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,GACP,kBAAkB,GAClB,oBAAoB,GACpB,oBAAoB,GACpB,wBAAwB,GACxB,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,iBAAiB,GACjB,kBAAkB,GAClB,sBAAsB,GACtB,uBAAuB,GACvB,oBAAoB,GACpB,uBAAuB,GACvB,kBAAkB,GAClB,oBAAoB,CAAC;AAEzB,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;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B,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,EAQ5C,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAAE,SAAS,aAAa,EAE/C,CAAC;AAEX,wBAAgB,yBAAyB,IAAI,gBAAgB,CAE5D"}
|
package/dist/types.js
CHANGED
|
@@ -1,4 +1,13 @@
|
|
|
1
1
|
// Campaign memory types — persistent NPC memory and relationship model
|
|
2
|
+
/**
|
|
3
|
+
* Current campaign-memory schema version (CM-01/CM-02). Stamped into every
|
|
4
|
+
* value returned by `NpcMemoryBank.serialize()` / `CampaignJournal.serialize()`
|
|
5
|
+
* and checked by both `deserialize()`s: saves with a NEWER version are rejected
|
|
6
|
+
* with an actionable error; saves with no version (written before this constant
|
|
7
|
+
* existed) load as legacy v1. Mirrors character-profile's PROFILE_VERSION so a
|
|
8
|
+
* future schema change has a number to migrate on.
|
|
9
|
+
*/
|
|
10
|
+
export const CAMPAIGN_MEMORY_VERSION = 1;
|
|
2
11
|
export const VALID_CATEGORIES = [
|
|
3
12
|
'action', 'combat', 'kill', 'betrayal', 'gift', 'theft',
|
|
4
13
|
'debt', 'discovery', 'alliance', 'insult', 'rescue', 'death',
|
package/dist/types.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;
|
|
1
|
+
{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AA4HzC,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;IAC5D,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB;IAC9D,wBAAwB,EAAE,gBAAgB;IAC1C,eAAe,EAAE,WAAW,EAAE,iBAAiB,EAAE,kBAAkB;IACnE,sBAAsB,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,uBAAuB;IAC9F,kBAAkB,EAAE,oBAAoB;CAChC,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"}
|
package/package.json
CHANGED