@chatwarden/core 0.1.7 → 0.1.8

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.
Files changed (126) hide show
  1. package/README.md +124 -4
  2. package/dist/src/ai/case.d.ts +3 -3
  3. package/dist/src/ai/case.d.ts.map +1 -1
  4. package/dist/src/ai/case.js +1 -1
  5. package/dist/src/ai/case.js.map +1 -1
  6. package/dist/src/ai/hash.d.ts +3 -1
  7. package/dist/src/ai/hash.d.ts.map +1 -1
  8. package/dist/src/ai/hash.js +5 -2
  9. package/dist/src/ai/hash.js.map +1 -1
  10. package/dist/src/ai/prompt.d.ts +6 -2
  11. package/dist/src/ai/prompt.d.ts.map +1 -1
  12. package/dist/src/ai/prompt.js +11 -0
  13. package/dist/src/ai/prompt.js.map +1 -1
  14. package/dist/src/ai/service.d.ts +5 -1
  15. package/dist/src/ai/service.d.ts.map +1 -1
  16. package/dist/src/ai/service.js +2 -0
  17. package/dist/src/ai/service.js.map +1 -1
  18. package/dist/src/ai/types.d.ts +18 -2
  19. package/dist/src/ai/types.d.ts.map +1 -1
  20. package/dist/src/ai/types.js +2 -2
  21. package/dist/src/ai/types.js.map +1 -1
  22. package/dist/src/ai/worker.d.ts +3 -1
  23. package/dist/src/ai/worker.d.ts.map +1 -1
  24. package/dist/src/ai/worker.js +10 -3
  25. package/dist/src/ai/worker.js.map +1 -1
  26. package/dist/src/chat.d.ts +39 -1
  27. package/dist/src/chat.d.ts.map +1 -1
  28. package/dist/src/chat.js +85 -6
  29. package/dist/src/chat.js.map +1 -1
  30. package/dist/src/chatwarden.d.ts +68 -1
  31. package/dist/src/chatwarden.d.ts.map +1 -1
  32. package/dist/src/chatwarden.js +119 -5
  33. package/dist/src/chatwarden.js.map +1 -1
  34. package/dist/src/documents.d.ts +1 -1
  35. package/dist/src/documents.d.ts.map +1 -1
  36. package/dist/src/documents.js +3 -1
  37. package/dist/src/documents.js.map +1 -1
  38. package/dist/src/freeze.d.ts +3 -0
  39. package/dist/src/freeze.d.ts.map +1 -0
  40. package/dist/src/freeze.js +10 -0
  41. package/dist/src/freeze.js.map +1 -0
  42. package/dist/src/index.d.ts +13 -6
  43. package/dist/src/index.d.ts.map +1 -1
  44. package/dist/src/index.js +7 -2
  45. package/dist/src/index.js.map +1 -1
  46. package/dist/src/ladder.d.ts +28 -0
  47. package/dist/src/ladder.d.ts.map +1 -1
  48. package/dist/src/ladder.js +37 -1
  49. package/dist/src/ladder.js.map +1 -1
  50. package/dist/src/pace.d.ts +66 -0
  51. package/dist/src/pace.d.ts.map +1 -0
  52. package/dist/src/pace.js +111 -0
  53. package/dist/src/pace.js.map +1 -0
  54. package/dist/src/pacing.d.ts +63 -0
  55. package/dist/src/pacing.d.ts.map +1 -0
  56. package/dist/src/pacing.js +198 -0
  57. package/dist/src/pacing.js.map +1 -0
  58. package/dist/src/policy.d.ts +57 -1
  59. package/dist/src/policy.d.ts.map +1 -1
  60. package/dist/src/policy.js +67 -4
  61. package/dist/src/policy.js.map +1 -1
  62. package/dist/src/profile.d.ts +35 -8
  63. package/dist/src/profile.d.ts.map +1 -1
  64. package/dist/src/profile.js +57 -25
  65. package/dist/src/profile.js.map +1 -1
  66. package/dist/src/profileError.d.ts +10 -0
  67. package/dist/src/profileError.d.ts.map +1 -0
  68. package/dist/src/profileError.js +17 -0
  69. package/dist/src/profileError.js.map +1 -0
  70. package/dist/src/retention.d.ts +9 -0
  71. package/dist/src/retention.d.ts.map +1 -1
  72. package/dist/src/retention.js +10 -1
  73. package/dist/src/retention.js.map +1 -1
  74. package/dist/src/signalCounts.d.ts +37 -0
  75. package/dist/src/signalCounts.d.ts.map +1 -0
  76. package/dist/src/signalCounts.js +117 -0
  77. package/dist/src/signalCounts.js.map +1 -0
  78. package/dist/src/signalInert.d.ts +10 -0
  79. package/dist/src/signalInert.d.ts.map +1 -0
  80. package/dist/src/signalInert.js +28 -0
  81. package/dist/src/signalInert.js.map +1 -0
  82. package/dist/src/signalService.d.ts +101 -0
  83. package/dist/src/signalService.d.ts.map +1 -0
  84. package/dist/src/signalService.js +383 -0
  85. package/dist/src/signalService.js.map +1 -0
  86. package/dist/src/signals.d.ts +186 -0
  87. package/dist/src/signals.d.ts.map +1 -0
  88. package/dist/src/signals.js +361 -0
  89. package/dist/src/signals.js.map +1 -0
  90. package/dist/src/subjects.d.ts +2 -0
  91. package/dist/src/subjects.d.ts.map +1 -1
  92. package/dist/src/subjects.js +4 -0
  93. package/dist/src/subjects.js.map +1 -1
  94. package/dist/src/team.d.ts +27 -0
  95. package/dist/src/team.d.ts.map +1 -1
  96. package/dist/src/team.js +92 -4
  97. package/dist/src/team.js.map +1 -1
  98. package/dist/src/types.d.ts +56 -1
  99. package/dist/src/types.d.ts.map +1 -1
  100. package/dist/src/types.js.map +1 -1
  101. package/package.json +2 -2
  102. package/src/ai/case.ts +4 -4
  103. package/src/ai/hash.ts +5 -2
  104. package/src/ai/prompt.ts +16 -1
  105. package/src/ai/service.ts +8 -2
  106. package/src/ai/types.ts +19 -2
  107. package/src/ai/worker.ts +12 -4
  108. package/src/chat.ts +109 -8
  109. package/src/chatwarden.ts +184 -7
  110. package/src/documents.ts +5 -3
  111. package/src/freeze.ts +8 -0
  112. package/src/index.ts +41 -3
  113. package/src/ladder.ts +59 -1
  114. package/src/pace.ts +139 -0
  115. package/src/pacing.ts +242 -0
  116. package/src/policy.ts +107 -7
  117. package/src/profile.ts +83 -25
  118. package/src/profileError.ts +17 -0
  119. package/src/retention.ts +17 -1
  120. package/src/signalCounts.ts +133 -0
  121. package/src/signalInert.ts +31 -0
  122. package/src/signalService.ts +406 -0
  123. package/src/signals.ts +489 -0
  124. package/src/subjects.ts +5 -0
  125. package/src/team.ts +93 -5
  126. package/src/types.ts +65 -1
@@ -0,0 +1,111 @@
1
+ import { deepFreeze } from './freeze.js';
2
+ import { ProfileError } from './profileError.js';
3
+ // The pace settings: how a room paces a player's lines (a gap, a burst limit, no repeats). Pure data and validation, no state and no
4
+ // clock; the limiter that applies them is pacing.ts. Every setting is off until set, so a kit that sets none behaves as before.
5
+ /** The reasons a line can be refused for pacing, in the order they are checked. */
6
+ export const PACE_REASONS = ['slow_mode', 'flood', 'duplicate'];
7
+ /** A normalized line shorter than this (in characters) is never a duplicate, so "gg" and "ok" stay free. */
8
+ export const DUPLICATE_MIN_CHARS = 3;
9
+ /** How many of a player's most recent line hashes a repeat is compared with. */
10
+ export const DUPLICATE_RECENT = 8;
11
+ /**
12
+ * The most (room, player) states the limiter holds; the oldest go. A state is small (a time, a digest or two) but a burst of 100 lines
13
+ * keeps up to 100 times and 8 digests per player, roughly 1.5 KB: at the cap with the largest settings that is about 70 MB, so a game
14
+ * that sets `burst.lines` high and has very many players in one process should budget for it.
15
+ */
16
+ export const PACE_KEYS_MAX = 50_000;
17
+ /** The allowed whole-number range of each number setting. */
18
+ const RANGES = {
19
+ slowModeMs: [500, 600_000],
20
+ lines: [2, 100],
21
+ windowMs: [1000, 600_000],
22
+ duplicateWindowMs: [1000, 3_600_000],
23
+ };
24
+ const BURST_KEYS = ['lines', 'windowMs'];
25
+ const PACE_KEYS = ['slowModeMs', 'burst', 'duplicateWindowMs'];
26
+ /**
27
+ * Values the hub offers behind "Use suggested values". Never applied by themselves.
28
+ * @experimental
29
+ */
30
+ export const PACE_SUGGESTIONS = deepFreeze({
31
+ relaxed: { slowModeMs: null, burst: { lines: 10, windowMs: 10_000 }, duplicateWindowMs: 10_000 },
32
+ standard: { slowModeMs: null, burst: { lines: 6, windowMs: 10_000 }, duplicateWindowMs: 15_000 },
33
+ strict: { slowModeMs: 2000, burst: { lines: 5, windowMs: 10_000 }, duplicateWindowMs: 30_000 },
34
+ });
35
+ function isPlain(v) {
36
+ if (typeof v !== 'object' || v === null || Array.isArray(v))
37
+ return false;
38
+ const proto = Object.getPrototypeOf(v);
39
+ return proto === Object.prototype || proto === null;
40
+ }
41
+ /** An own, defined value: a key left out, `undefined` and an inherited property all read as "not given". */
42
+ function given(o, key) {
43
+ return Object.hasOwn(o, key) ? o[key] : undefined;
44
+ }
45
+ /** `o` must be a plain object with no key outside `allowed`; a refusal names the key. */
46
+ function plain(o, allowed, path, what) {
47
+ if (!isPlain(o))
48
+ throw new ProfileError(path, what);
49
+ for (const k of Object.keys(o))
50
+ if (!allowed.includes(k))
51
+ throw new ProfileError(`${path}.${k}`, 'is not a known setting');
52
+ return o;
53
+ }
54
+ function whole(v, key, path) {
55
+ const [lo, hi] = RANGES[key];
56
+ if (typeof v !== 'number' || !Number.isSafeInteger(v) || v < lo || v > hi)
57
+ throw new ProfileError(path, `must be a whole number from ${lo} to ${hi}`);
58
+ return v;
59
+ }
60
+ function checkBurst(v, path) {
61
+ const o = plain(v, BURST_KEYS, path, 'must be an object with lines and windowMs, or null');
62
+ for (const k of BURST_KEYS)
63
+ if (given(o, k) === undefined)
64
+ throw new ProfileError(`${path}.${k}`, 'is required');
65
+ return { lines: whole(o['lines'], 'lines', `${path}.lines`), windowMs: whole(o['windowMs'], 'windowMs', `${path}.windowMs`) };
66
+ }
67
+ /**
68
+ * Check the shape and ranges of `input` and return what is set, as a new object that shares nothing with it: a key is present only
69
+ * when it was given a value (`null` included), and each value was read from `input` exactly once, so what was validated is what is
70
+ * returned even for an object with getters. Throws ProfileError like {@link resolvePace}. For a caller that must keep the override a
71
+ * room was given (`cw.rooms.setPace`).
72
+ * @experimental
73
+ */
74
+ export function checkPace(input, path = 'pace') {
75
+ return checked(input, path);
76
+ }
77
+ function checked(input, path) {
78
+ const o = plain(input, PACE_KEYS, path, 'must be an object');
79
+ const out = {};
80
+ for (const k of PACE_KEYS) {
81
+ const v = given(o, k);
82
+ if (v !== undefined)
83
+ out[k] = v === null ? null : k === 'burst' ? checkBurst(v, `${path}.${k}`) : whole(v, k, `${path}.${k}`);
84
+ }
85
+ return out;
86
+ }
87
+ /**
88
+ * Validate and fill. Throws ProfileError naming the field (`pace.burst.lines`), never echoing the value. `path` names the settings in
89
+ * the error (default `pace`). The result is a new object that shares nothing with the input.
90
+ * @experimental
91
+ */
92
+ export function resolvePace(input, path = 'pace') {
93
+ if (input === undefined)
94
+ return { slowModeMs: null, burst: null, duplicateWindowMs: null };
95
+ const set = checked(input, path);
96
+ return { slowModeMs: set.slowModeMs ?? null, burst: set.burst ?? null, duplicateWindowMs: set.duplicateWindowMs ?? null };
97
+ }
98
+ /**
99
+ * `over` on top of `base`: a field left out inherits, `null` turns it off, a value sets it. `burst` is replaced whole, never merged by
100
+ * member. `over` is validated (a ProfileError with the path `pace...`). Neither argument is changed or shared with the result.
101
+ * @experimental
102
+ */
103
+ export function mergePace(base, over) {
104
+ const set = checked(over, 'pace');
105
+ return {
106
+ slowModeMs: set.slowModeMs !== undefined ? set.slowModeMs : base.slowModeMs,
107
+ burst: set.burst !== undefined ? set.burst : base.burst === null ? null : { lines: base.burst.lines, windowMs: base.burst.windowMs },
108
+ duplicateWindowMs: set.duplicateWindowMs !== undefined ? set.duplicateWindowMs : base.duplicateWindowMs,
109
+ };
110
+ }
111
+ //# sourceMappingURL=pace.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pace.js","sourceRoot":"","sources":["../../src/pace.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import type { PaceReason, ResolvedPace } from './pace.js';
2
+ import type { Clock } from './types.js';
3
+ /** Who a line is paced as: the room, and the canonical subject (or `seat:<seatId>` for a guest). */
4
+ export interface PaceKey {
5
+ roomId: string;
6
+ who: string;
7
+ }
8
+ /** The answer to one line. `retryAfterMs` is a whole number from 1 up to the window of the check that refused. */
9
+ export type PaceVerdict = {
10
+ ok: true;
11
+ } | {
12
+ ok: false;
13
+ reason: PaceReason;
14
+ retryAfterMs: number;
15
+ signalFlood: boolean;
16
+ };
17
+ export interface Pacer {
18
+ /** Should this line be refused? Reads state, changes no timing state. Order: `slow_mode`, `flood`, `duplicate`. */
19
+ check(key: PaceKey, line: string): PaceVerdict;
20
+ /** Record that a line was accepted: it now counts toward the next check. A no-op while every check is off. */
21
+ commit(key: PaceKey, line: string): void;
22
+ /** Is any check on for this room right now? When not, `check` and `commit` do nothing and the caller need not build a key. */
23
+ active(roomId: string): boolean;
24
+ /** The line `check` accepted will not be committed (the fixed rate refused it): drop the digest memo that holds its text. */
25
+ discard(): void;
26
+ /** Is a line's text held in the digest memo (between a `check` that passed and its `commit` or `discard`)? A diagnostic. */
27
+ holdsText(): boolean;
28
+ /** Forget every key of a room in one step. */
29
+ dropRoom(roomId: string): void;
30
+ /** Keys held. A diagnostic: it stays at or under {@link PACE_KEYS_MAX}. */
31
+ size(): number;
32
+ }
33
+ /** What the pacer keeps for one player in one room. @internal */
34
+ export interface KeyState {
35
+ /** When the last committed line was accepted. */
36
+ lastAt: number;
37
+ /** The times of the last committed lines, oldest first (at most the burst's `lines`). */
38
+ stamps: number[];
39
+ /** Digests of the last {@link DUPLICATE_RECENT} committed lines of enough length, oldest first. */
40
+ recent: Array<{
41
+ h: string;
42
+ at: number;
43
+ }>;
44
+ /** When `check` last reported a flood for this key, or null. */
45
+ floodSignalAt: number | null;
46
+ }
47
+ /**
48
+ * NFKC, lower-case, then only letters, digits and the combining marks that belong to them: what "the same line again" means. Marks stay
49
+ * because in many scripts (Devanagari, Thai) the vowel signs are marks, and without them different words look alike. Variation
50
+ * selectors (U+FE00 to U+FE0F, which pick text or emoji presentation) are marks too but carry no meaning of their own, so they go
51
+ * first: `1\uFE0F\u20E3` and `1\u20E3` are one line, and an emoji line leaves nothing to count. Never stored.
52
+ */
53
+ export declare function normalizeForRepeat(text: string): string;
54
+ /**
55
+ * `tap` is a test seam: it is handed the state (rooms by key) once, so a test can look at what a pacer holds. Nothing in the kit passes it.
56
+ * @internal
57
+ */
58
+ export declare function createPacer(opts: {
59
+ clock: Clock;
60
+ settings: (roomId: string) => ResolvedPace;
61
+ tap?: (rooms: ReadonlyMap<string, ReadonlyMap<string, Readonly<KeyState>>>) => void;
62
+ }): Pacer;
63
+ //# sourceMappingURL=pacing.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pacing.d.ts","sourceRoot":"","sources":["../../src/pacing.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAiBxC,oGAAoG;AACpG,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,kHAAkH;AAClH,MAAM,MAAM,WAAW,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAAC;AAEvH,MAAM,WAAW,KAAK;IACpB,mHAAmH;IACnH,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC/C,8GAA8G;IAC9G,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,8HAA8H;IAC9H,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChC,6HAA6H;IAC7H,OAAO,IAAI,IAAI,CAAC;IAChB,4HAA4H;IAC5H,SAAS,IAAI,OAAO,CAAC;IACrB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,2EAA2E;IAC3E,IAAI,IAAI,MAAM,CAAC;CAChB;AAED,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,mGAAmG;IACnG,MAAM,EAAE,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzC,gEAAgE;IAChE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD;AAsBD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,YAAY,CAAC;IAAC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;CAAE,GAAG,KAAK,CAqJ1L"}
@@ -0,0 +1,198 @@
1
+ import { sha256Hex } from './crypto.js';
2
+ import { DUPLICATE_MIN_CHARS, DUPLICATE_RECENT, PACE_KEYS_MAX } from './pace.js';
3
+ // The pacer: the in-memory limiter behind slow mode, the burst limit and repeat refusal. Pure and clocked: it reads the settings
4
+ // through a function on every call, holds no line text (a repeat is remembered as a short digest of the normalized line), and its
5
+ // `check` is timing-pure: a refusal changes nothing the next check reads. The one write `check` makes is the `floodSignalAt`
6
+ // bookkeeping, set when it returns `signalFlood: true`, so a flood is reported at most once per burst window.
7
+ //
8
+ // State is per process, a map of maps by room (so a room goes in one delete), swept every SWEEP_EVERY checks against the longest
9
+ // window the room has configured, and capped at PACE_KEYS_MAX keys (the oldest go).
10
+ /** Sweep quiet keys after this many `check` calls (the same cadence as `slidingWindow`). */
11
+ const SWEEP_EVERY = 256;
12
+ /** When the cap is hit, this many of the oldest keys go at once, so the scan is paid for once per batch and not once per new key. */
13
+ const EVICT_BATCH = Math.ceil(PACE_KEYS_MAX / 8);
14
+ /** Hex characters of the digest kept for a repeat: enough that two different lines do not meet, far too few to recover a line. */
15
+ const DIGEST_CHARS = 16;
16
+ /**
17
+ * NFKC, lower-case, then only letters, digits and the combining marks that belong to them: what "the same line again" means. Marks stay
18
+ * because in many scripts (Devanagari, Thai) the vowel signs are marks, and without them different words look alike. Variation
19
+ * selectors (U+FE00 to U+FE0F, which pick text or emoji presentation) are marks too but carry no meaning of their own, so they go
20
+ * first: `1\uFE0F\u20E3` and `1\u20E3` are one line, and an emoji line leaves nothing to count. Never stored.
21
+ */
22
+ export function normalizeForRepeat(text) {
23
+ return text.normalize('NFKC').toLowerCase().replace(/[\uFE00-\uFE0F]/g, '').replace(/[^\p{L}\p{N}\p{M}]/gu, '');
24
+ }
25
+ /** Letters and digits in a normalized line: marks do not count toward the minimum length, so a line of marks alone is never a repeat. */
26
+ const baseChars = (normalized) => Array.from(normalized.replace(/\p{M}/gu, '')).length;
27
+ const OK = Object.freeze({ ok: true });
28
+ const allOff = (p) => p.slowModeMs === null && p.burst === null && p.duplicateWindowMs === null;
29
+ /** A refusal with a whole-number wait of at least 1 and at most the refusing check's own window (a clock that stepped back cannot exceed it). */
30
+ function refusal(reason, waitMs, windowMs, signalFlood) {
31
+ const wait = Number.isFinite(waitMs) ? Math.min(windowMs, Math.max(1, Math.ceil(waitMs))) : windowMs;
32
+ return { ok: false, reason, retryAfterMs: wait, signalFlood };
33
+ }
34
+ /** The longest window a room has configured, or 0 when every check is off. */
35
+ function longestWindow(p) {
36
+ return Math.max(p.slowModeMs ?? 0, p.burst?.windowMs ?? 0, p.duplicateWindowMs ?? 0);
37
+ }
38
+ const touchedAt = (s) => (s.floodSignalAt !== null && s.floodSignalAt > s.lastAt ? s.floodSignalAt : s.lastAt);
39
+ /**
40
+ * `tap` is a test seam: it is handed the state (rooms by key) once, so a test can look at what a pacer holds. Nothing in the kit passes it.
41
+ * @internal
42
+ */
43
+ export function createPacer(opts) {
44
+ const { clock, settings } = opts;
45
+ const rooms = new Map();
46
+ opts.tap?.(rooms);
47
+ let keys = 0;
48
+ let calls = 0;
49
+ const sweep = (now) => {
50
+ for (const [roomId, room] of rooms) {
51
+ let longest;
52
+ try {
53
+ longest = longestWindow(settings(roomId));
54
+ }
55
+ catch {
56
+ continue;
57
+ }
58
+ if (longest === 0) {
59
+ keys -= room.size;
60
+ rooms.delete(roomId);
61
+ continue;
62
+ }
63
+ for (const [who, state] of room) {
64
+ if (now - touchedAt(state) >= longest) {
65
+ room.delete(who);
66
+ keys -= 1;
67
+ }
68
+ }
69
+ if (room.size === 0)
70
+ rooms.delete(roomId);
71
+ }
72
+ };
73
+ /** Over the cap: drop the oldest keys, a batch at a time. */
74
+ const evict = () => {
75
+ const all = [];
76
+ for (const [roomId, room] of rooms)
77
+ for (const [who, state] of room)
78
+ all.push({ roomId, who, at: touchedAt(state) });
79
+ all.sort((a, b) => a.at - b.at);
80
+ const drop = Math.min(all.length, keys - PACE_KEYS_MAX + EVICT_BATCH);
81
+ for (let i = 0; i < drop; i += 1) {
82
+ const { roomId, who } = all[i];
83
+ const room = rooms.get(roomId);
84
+ if (room?.delete(who) === true)
85
+ keys -= 1;
86
+ if (room !== undefined && room.size === 0)
87
+ rooms.delete(roomId);
88
+ }
89
+ };
90
+ const digest = (normalized) => sha256Hex(normalized).slice(0, DIGEST_CHARS);
91
+ /**
92
+ * The digest `check` made of the line it just accepted, so `commit` of the same line does not hash it again. It holds that one line
93
+ * only from the check to the commit that follows it in the same call (and is replaced or cleared by the next call): the keyed state
94
+ * below never holds text.
95
+ */
96
+ let memo = null;
97
+ /** A normalized line long enough to be called a repeat, as its digest; null for one that is not. */
98
+ const repeatHash = (line) => {
99
+ if (memo !== null && memo.line === line)
100
+ return memo.h;
101
+ const normalized = normalizeForRepeat(line);
102
+ return baseChars(normalized) < DUPLICATE_MIN_CHARS ? null : digest(normalized);
103
+ };
104
+ const pacer = {
105
+ active: (roomId) => !allOff(settings(roomId)),
106
+ check(key, line) {
107
+ const now = clock.now();
108
+ memo = null;
109
+ if (++calls % SWEEP_EVERY === 0)
110
+ sweep(now);
111
+ const pace = settings(key.roomId);
112
+ if (allOff(pace))
113
+ return OK;
114
+ const state = rooms.get(key.roomId)?.get(key.who);
115
+ if (state === undefined)
116
+ return OK;
117
+ const { slowModeMs, burst, duplicateWindowMs } = pace;
118
+ // State stamped after `now` (the clock stepped back) is stale, not "in the future": it never refuses, so a step back cannot lock
119
+ // a player out. The refusal clamp below is then a guard only.
120
+ if (slowModeMs !== null && state.lastAt <= now && now - state.lastAt < slowModeMs) {
121
+ return refusal('slow_mode', state.lastAt + slowModeMs - now, slowModeMs, false);
122
+ }
123
+ if (burst !== null) {
124
+ const live = state.stamps.filter((t) => t <= now && now - t < burst.windowMs).sort((a, b) => a - b);
125
+ if (live.length >= burst.lines) {
126
+ // Enough must age out to leave room for one more: with exactly `lines` live that is the oldest, with more (a burst
127
+ // narrowed after the lines were sent) it is the one that leaves `lines - 1`.
128
+ const oldest = live[live.length - burst.lines];
129
+ const signal = state.floodSignalAt === null || now < state.floodSignalAt || now - state.floodSignalAt >= burst.windowMs;
130
+ if (signal)
131
+ state.floodSignalAt = now;
132
+ return refusal('flood', oldest + burst.windowMs - now, burst.windowMs, signal);
133
+ }
134
+ }
135
+ if (duplicateWindowMs !== null && state.recent.length > 0) {
136
+ const h = repeatHash(line);
137
+ if (h !== null) {
138
+ const seen = state.recent.find((e) => e.h === h && e.at <= now && now - e.at < duplicateWindowMs);
139
+ if (seen !== undefined)
140
+ return refusal('duplicate', seen.at + duplicateWindowMs - now, duplicateWindowMs, false);
141
+ memo = { line, h };
142
+ }
143
+ else
144
+ memo = { line, h: null };
145
+ }
146
+ return OK;
147
+ },
148
+ commit(key, line) {
149
+ const now = clock.now();
150
+ const pace = settings(key.roomId);
151
+ if (allOff(pace))
152
+ return;
153
+ let room = rooms.get(key.roomId);
154
+ let state = room?.get(key.who);
155
+ if (state === undefined) {
156
+ if (keys >= PACE_KEYS_MAX)
157
+ evict();
158
+ if (room === undefined || !rooms.has(key.roomId)) {
159
+ room = new Map();
160
+ rooms.set(key.roomId, room);
161
+ }
162
+ state = { lastAt: now, stamps: [], recent: [], floodSignalAt: null };
163
+ room.set(key.who, state);
164
+ keys += 1;
165
+ }
166
+ state.lastAt = now;
167
+ const { burst, duplicateWindowMs } = pace;
168
+ if (burst === null)
169
+ state.stamps = [];
170
+ else
171
+ state.stamps = [...state.stamps.filter((t) => t <= now && now - t < burst.windowMs), now].slice(-burst.lines);
172
+ if (duplicateWindowMs === null)
173
+ state.recent = [];
174
+ else {
175
+ const h = repeatHash(line);
176
+ const kept = state.recent.filter((e) => e.h !== h && e.at <= now && now - e.at < duplicateWindowMs);
177
+ if (h !== null)
178
+ kept.push({ h, at: now });
179
+ state.recent = kept.slice(-DUPLICATE_RECENT);
180
+ }
181
+ memo = null;
182
+ },
183
+ discard() {
184
+ memo = null;
185
+ },
186
+ holdsText: () => memo !== null,
187
+ dropRoom(roomId) {
188
+ const room = rooms.get(roomId);
189
+ if (room === undefined)
190
+ return;
191
+ keys -= room.size;
192
+ rooms.delete(roomId);
193
+ },
194
+ size: () => keys,
195
+ };
196
+ return pacer;
197
+ }
198
+ //# sourceMappingURL=pacing.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"pacing.js","sourceRoot":"","sources":["../../src/pacing.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,7 @@
1
1
  import type { PolicyLayer, PolicySection, ResolvedProfile } from './profile.js';
2
2
  import type { PlayerReporting } from './reporting.js';
3
3
  import type { RuleRef } from './rules.js';
4
+ import type { SignalDropReason } from './signals.js';
4
5
  import type { Clock, ConductLevel, Logger, Store } from './types.js';
5
6
  /**
6
7
  * The editable moderation profile at runtime. The profile given in code (a preset plus `overrides`) is the BASE. A moderator's
@@ -11,13 +12,39 @@ import type { Clock, ConductLevel, Logger, Store } from './types.js';
11
12
  */
12
13
  /** How often a read may look at the store for a newer version: 10 seconds. */
13
14
  export declare const POLICY_REFRESH_MS = 10000;
15
+ /**
16
+ * A stored signal feed that was dropped when the layer was read: the feed (`record`, `queue`, `ladder`, `ai`, or `unknown` for a name the kit
17
+ * does not have) and why. A code only: never a kind id, a rule id, a label or a number from the stored layer.
18
+ * @experimental
19
+ */
20
+ export interface PolicyDropped {
21
+ feed: string;
22
+ reason: SignalDropReason;
23
+ }
24
+ /**
25
+ * The kit's own numbers the settings screens need, read only: they come from `createChatwarden` (`limits.chatRate`, `retention.signalsMs`), are
26
+ * never part of the stored layer, and a save cannot change them.
27
+ * @experimental
28
+ */
29
+ export interface PolicyLimits {
30
+ /** The chat rate the kit enforces per room and seat: at most `count` lines in any `windowMs` (default 3 per 5 000 ms). Slow mode and burst sit beside it. */
31
+ chatRate: {
32
+ count: number;
33
+ windowMs: number;
34
+ };
35
+ /** How long signal rows are kept, ms: the longest window a signal feed may look back (default 90 days, never less than 14). */
36
+ signalsMs: number;
37
+ }
14
38
  /** What {@link PolicyService.get} answers. */
15
39
  export interface PolicyState {
16
40
  /** The profile in force: base, then the stored layer. Deep-frozen. */
17
41
  effective: ResolvedProfile;
18
42
  /** The profile from code (preset and overrides), without the stored layer. Deep-frozen. */
19
43
  base: ResolvedProfile;
20
- /** The stored layer as last read (`{}` when none), deep-frozen. */
44
+ /**
45
+ * The layer in force, as last read (`{}` when none), deep-frozen: the stored layer with any signal feed that could no longer be used
46
+ * taken out (see `dropped`). Send it back to `save` and the save is accepted, and repairs the stored row.
47
+ */
21
48
  layer: PolicyLayer;
22
49
  /** The stored layer's version; 0 when nothing was ever saved. Pass it back to `save`. */
23
50
  version: number;
@@ -33,6 +60,19 @@ export interface PolicyState {
33
60
  path: string;
34
61
  kind: 'unreadable' | 'invalid';
35
62
  };
63
+ /**
64
+ * Present only when the stored layer held signal feeds that could no longer be used (the code stopped declaring their kind, or a
65
+ * window is longer than the retention now allows) and were left out of `layer` and of what is in force. One entry per feed, with the
66
+ * reason of the first thing lost from it. The stored row itself is rewritten by the next save.
67
+ * @experimental
68
+ */
69
+ dropped?: readonly PolicyDropped[];
70
+ /**
71
+ * The chat rate limit actually in force and the signals retention window, so a settings screen can say what slow mode sits beside and how
72
+ * far back a feed may look. Read only, deep-frozen.
73
+ * @experimental
74
+ */
75
+ limits: PolicyLimits;
36
76
  }
37
77
  /** What {@link PolicyService.save} and {@link PolicyService.reset} answer. */
38
78
  export type PolicySaveResult = {
@@ -81,17 +121,33 @@ export declare class PolicyService {
81
121
  private state;
82
122
  /** When the store was last looked at (epoch ms), or null before the first read. */
83
123
  private lastCheck;
124
+ /** How long signal rows are kept, ms: a feed window longer than this could never be met. */
125
+ private readonly signalsMs;
126
+ /** The chat rate in force (`limits.chatRate`), for `get().limits`. */
127
+ private readonly chatRate;
84
128
  constructor(deps: {
85
129
  store: Store;
86
130
  clock: Clock;
87
131
  logger: Logger | undefined;
88
132
  base: ResolvedProfile;
133
+ signalsMs?: () => number;
134
+ chatRate?: {
135
+ count: number;
136
+ windowMs: number;
137
+ };
89
138
  });
90
139
  private get supported();
91
140
  /** Read the stored layer once, at creation. A store failure here is the caller's (like every other load). */
92
141
  load(): void;
93
142
  /** Make `stored` the layer in force: the effective profile is rebuilt, or the base kept when the layer cannot be used. */
94
143
  private adopt;
144
+ /**
145
+ * The stored layer with any signal feed that can no longer be used taken out (it names a kind the code stopped declaring, or a window
146
+ * longer than the retention now allows), and what was taken out. Without this one stale feed would make the whole layer unusable and
147
+ * silently drop the owner's other edits too. Logged by feed name only. Anything else wrong with the layer is left for
148
+ * `applyPolicyLayer` to refuse; a layer with nothing to drop comes back as it is.
149
+ */
150
+ private withoutStaleFeeds;
95
151
  /** Look at the store now and adopt a strictly newer version (an older one, say a restored backup, never regresses what is in force). A store failure throws. */
96
152
  private reload;
97
153
  /** The cheap check every read does: at most one store look per {@link POLICY_REFRESH_MS}; a failure keeps what is in force. */
@@ -1 +1 @@
1
- {"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/policy.ts"],"names":[],"mappings":"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"}
@@ -3,6 +3,9 @@ import { suggest } from './ladder.js';
3
3
  import { applyPolicyLayer, changedSections, frozenCopy, layerSections, POLICY_SECTIONS, ProfileError } from './profile.js';
4
4
  import { playerReporting } from './reporting.js';
5
5
  import { errorClass, safeWarn } from './log.js';
6
+ import { RETENTION_DEFAULTS } from './retention.js';
7
+ import { checkSignalFeeds, pruneSignalFeeds, SIGNAL_FEED_NAMES } from './signals.js';
8
+ import { RATE_LIMIT, RATE_WINDOW_MS } from './chat.js';
6
9
  import { retryBusy } from './team.js';
7
10
  import { CONDUCT_LEVELS } from './types.js';
8
11
  /**
@@ -34,7 +37,13 @@ export class PolicyService {
34
37
  state;
35
38
  /** When the store was last looked at (epoch ms), or null before the first read. */
36
39
  lastCheck = null;
40
+ /** How long signal rows are kept, ms: a feed window longer than this could never be met. */
41
+ signalsMs;
42
+ /** The chat rate in force (`limits.chatRate`), for `get().limits`. */
43
+ chatRate;
37
44
  constructor(deps) {
45
+ this.signalsMs = deps.signalsMs ?? (() => RETENTION_DEFAULTS.signalsMs);
46
+ this.chatRate = Object.freeze({ count: deps.chatRate?.count ?? RATE_LIMIT, windowMs: deps.chatRate?.windowMs ?? RATE_WINDOW_MS });
38
47
  this.store = deps.store;
39
48
  this.clock = deps.clock;
40
49
  this.logger = deps.logger;
@@ -58,7 +67,10 @@ export class PolicyService {
58
67
  const raw = stored === null ? {} : stored.layer;
59
68
  const layer = frozenCopy(raw);
60
69
  try {
61
- this.state = { effective: applyPolicyLayer(this.base, layer), layer, version };
70
+ // What is read and shown is the layer in force: the stale feeds are out of it, so a save that sends it back is never refused for them.
71
+ const { layer: inForce, dropped } = this.withoutStaleFeeds(layer);
72
+ const shown = dropped.length === 0 ? layer : frozenCopy(inForce);
73
+ this.state = { effective: applyPolicyLayer(this.base, shown), layer: shown, version, ...(dropped.length === 0 ? {} : { dropped: Object.freeze(dropped.map((d) => Object.freeze(d))) }) };
62
74
  }
63
75
  catch (err) {
64
76
  if (!(err instanceof ProfileError))
@@ -71,6 +83,39 @@ export class PolicyService {
71
83
  safeWarn(this.logger, 'chatwarden.policy_layer_invalid', { version, path: err.path });
72
84
  }
73
85
  }
86
+ /**
87
+ * The stored layer with any signal feed that can no longer be used taken out (it names a kind the code stopped declaring, or a window
88
+ * longer than the retention now allows), and what was taken out. Without this one stale feed would make the whole layer unusable and
89
+ * silently drop the owner's other edits too. Logged by feed name only. Anything else wrong with the layer is left for
90
+ * `applyPolicyLayer` to refuse; a layer with nothing to drop comes back as it is.
91
+ */
92
+ withoutStaleFeeds(layer) {
93
+ const dropped = [];
94
+ const signals = typeof layer === 'object' && layer !== null && !Array.isArray(layer) ? layer.signals : undefined;
95
+ const feeds = typeof signals === 'object' && signals !== null && !Array.isArray(signals) ? signals.feeds : undefined;
96
+ if (typeof feeds !== 'object' || feeds === null || Array.isArray(feeds))
97
+ return { layer, dropped };
98
+ const pruned = pruneSignalFeeds(feeds, this.base.signals.kinds, {
99
+ signalsMs: this.signalsMs(),
100
+ onDrop: (name, reason) => {
101
+ const feed = SIGNAL_FEED_NAMES.includes(name) ? name : 'unknown';
102
+ safeWarn(this.logger, 'chatwarden.signal_feed_dropped', { feed });
103
+ dropped.push({ feed, reason });
104
+ },
105
+ });
106
+ if (dropped.length === 0)
107
+ return { layer, dropped };
108
+ // Nothing usable is left of the section: it is not shown at all, so the code's own feeds are what is in force (a section with a `feeds`
109
+ // key replaces them wholesale, and an empty one would keep them off for a reason nobody can see).
110
+ const { feeds: _gone, ...others } = signals;
111
+ void _gone;
112
+ const rest = { ...layer };
113
+ if (Object.keys(pruned).length === 0 && Object.keys(others).length === 0)
114
+ delete rest['signals'];
115
+ else
116
+ rest['signals'] = Object.keys(pruned).length === 0 ? others : { ...others, feeds: pruned };
117
+ return { layer: rest, dropped };
118
+ }
74
119
  /** Look at the store now and adopt a strictly newer version (an older one, say a restored backup, never regresses what is in force). A store failure throws. */
75
120
  reload() {
76
121
  const stored = this.store.loadPolicyLayer?.() ?? null;
@@ -106,8 +151,17 @@ export class PolicyService {
106
151
  }
107
152
  get() {
108
153
  this.maybeRefresh();
109
- const { effective, layer, version, layerError } = this.state;
110
- return { effective, base: this.base, layer, version, canSave: this.supported, ...(layerError === undefined ? {} : { layerError: { ...layerError } }) };
154
+ const { effective, layer, version, layerError, dropped } = this.state;
155
+ return {
156
+ effective,
157
+ base: this.base,
158
+ layer,
159
+ version,
160
+ canSave: this.supported,
161
+ ...(layerError === undefined ? {} : { layerError: { ...layerError } }),
162
+ ...(dropped === undefined ? {} : { dropped }),
163
+ limits: Object.freeze({ chatRate: this.chatRate, signalsMs: this.signalsMs() }),
164
+ };
111
165
  }
112
166
  /** Look at the store now, whatever the interval. A store failure throws. */
113
167
  refresh() {
@@ -131,6 +185,11 @@ export class PolicyService {
131
185
  return { ok: false, error: 'conflict' };
132
186
  }
133
187
  const changed = changedSections(before, layer);
188
+ // The layer this save was judged against had feeds taken out of it (`dropped`): the stored row loses them now, so `signals` changed.
189
+ if (this.state.version === expected && this.state.dropped !== undefined && !changed.includes('signals')) {
190
+ changed.push('signals');
191
+ changed.sort((a, b) => POLICY_SECTIONS.indexOf(a) - POLICY_SECTIONS.indexOf(b));
192
+ }
134
193
  this.lastCheck = this.clock.now();
135
194
  this.adopt({ layer, version: next });
136
195
  return { ok: true, version: next, changed };
@@ -155,7 +214,9 @@ export class PolicyService {
155
214
  return { ok: false, error: 'invalid', path: 'reason' };
156
215
  }
157
216
  try {
158
- applyPolicyLayer(this.base, layer);
217
+ const effective = applyPolicyLayer(this.base, layer);
218
+ // The windows are checked against the retention here, where it is known: a window longer than it could never be met.
219
+ checkSignalFeeds(effective.signals.feeds, effective.signals.kinds, { signalsMs: this.signalsMs() }, 'layer.signals.feeds');
159
220
  }
160
221
  catch (err) {
161
222
  if (err instanceof ProfileError)
@@ -215,6 +276,8 @@ export class PolicyService {
215
276
  let candidate;
216
277
  try {
217
278
  candidate = applyPolicyLayer(this.base, layer);
279
+ // As save: a window longer than the retention could never be met, so the candidate is refused here too, not only when it is saved.
280
+ checkSignalFeeds(candidate.signals.feeds, candidate.signals.kinds, { signalsMs: this.signalsMs() }, 'layer.signals.feeds');
218
281
  }
219
282
  catch (err) {
220
283
  if (err instanceof ProfileError)