@animalabs/agent-framework 0.1.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.
Files changed (212) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +233 -0
  3. package/dist/src/agent.d.ts +130 -0
  4. package/dist/src/agent.d.ts.map +1 -0
  5. package/dist/src/agent.js +406 -0
  6. package/dist/src/agent.js.map +1 -0
  7. package/dist/src/api/mcp-server.d.ts +37 -0
  8. package/dist/src/api/mcp-server.d.ts.map +1 -0
  9. package/dist/src/api/mcp-server.js +598 -0
  10. package/dist/src/api/mcp-server.js.map +1 -0
  11. package/dist/src/api/server.d.ts +83 -0
  12. package/dist/src/api/server.d.ts.map +1 -0
  13. package/dist/src/api/server.js +785 -0
  14. package/dist/src/api/server.js.map +1 -0
  15. package/dist/src/api/types.d.ts +395 -0
  16. package/dist/src/api/types.d.ts.map +1 -0
  17. package/dist/src/api/types.js +5 -0
  18. package/dist/src/api/types.js.map +1 -0
  19. package/dist/src/framework.d.ts +309 -0
  20. package/dist/src/framework.d.ts.map +1 -0
  21. package/dist/src/framework.js +2309 -0
  22. package/dist/src/framework.js.map +1 -0
  23. package/dist/src/gate/event-gate.d.ts +75 -0
  24. package/dist/src/gate/event-gate.d.ts.map +1 -0
  25. package/dist/src/gate/event-gate.js +503 -0
  26. package/dist/src/gate/event-gate.js.map +1 -0
  27. package/dist/src/gate/index.d.ts +3 -0
  28. package/dist/src/gate/index.d.ts.map +1 -0
  29. package/dist/src/gate/index.js +2 -0
  30. package/dist/src/gate/index.js.map +1 -0
  31. package/dist/src/gate/types.d.ts +82 -0
  32. package/dist/src/gate/types.d.ts.map +1 -0
  33. package/dist/src/gate/types.js +9 -0
  34. package/dist/src/gate/types.js.map +1 -0
  35. package/dist/src/index.d.ts +17 -0
  36. package/dist/src/index.d.ts.map +1 -0
  37. package/dist/src/index.js +18 -0
  38. package/dist/src/index.js.map +1 -0
  39. package/dist/src/mcpl/channel-registry.d.ts +141 -0
  40. package/dist/src/mcpl/channel-registry.d.ts.map +1 -0
  41. package/dist/src/mcpl/channel-registry.js +647 -0
  42. package/dist/src/mcpl/channel-registry.js.map +1 -0
  43. package/dist/src/mcpl/checkpoint-manager.d.ts +79 -0
  44. package/dist/src/mcpl/checkpoint-manager.d.ts.map +1 -0
  45. package/dist/src/mcpl/checkpoint-manager.js +430 -0
  46. package/dist/src/mcpl/checkpoint-manager.js.map +1 -0
  47. package/dist/src/mcpl/errors.d.ts +52 -0
  48. package/dist/src/mcpl/errors.d.ts.map +1 -0
  49. package/dist/src/mcpl/errors.js +93 -0
  50. package/dist/src/mcpl/errors.js.map +1 -0
  51. package/dist/src/mcpl/feature-set-manager.d.ts +91 -0
  52. package/dist/src/mcpl/feature-set-manager.d.ts.map +1 -0
  53. package/dist/src/mcpl/feature-set-manager.js +250 -0
  54. package/dist/src/mcpl/feature-set-manager.js.map +1 -0
  55. package/dist/src/mcpl/hook-orchestrator.d.ts +51 -0
  56. package/dist/src/mcpl/hook-orchestrator.d.ts.map +1 -0
  57. package/dist/src/mcpl/hook-orchestrator.js +217 -0
  58. package/dist/src/mcpl/hook-orchestrator.js.map +1 -0
  59. package/dist/src/mcpl/index.d.ts +14 -0
  60. package/dist/src/mcpl/index.d.ts.map +1 -0
  61. package/dist/src/mcpl/index.js +21 -0
  62. package/dist/src/mcpl/index.js.map +1 -0
  63. package/dist/src/mcpl/inference-router.d.ts +67 -0
  64. package/dist/src/mcpl/inference-router.d.ts.map +1 -0
  65. package/dist/src/mcpl/inference-router.js +249 -0
  66. package/dist/src/mcpl/inference-router.js.map +1 -0
  67. package/dist/src/mcpl/push-handler.d.ts +60 -0
  68. package/dist/src/mcpl/push-handler.d.ts.map +1 -0
  69. package/dist/src/mcpl/push-handler.js +162 -0
  70. package/dist/src/mcpl/push-handler.js.map +1 -0
  71. package/dist/src/mcpl/scope-manager.d.ts +76 -0
  72. package/dist/src/mcpl/scope-manager.d.ts.map +1 -0
  73. package/dist/src/mcpl/scope-manager.js +213 -0
  74. package/dist/src/mcpl/scope-manager.js.map +1 -0
  75. package/dist/src/mcpl/server-connection.d.ts +174 -0
  76. package/dist/src/mcpl/server-connection.d.ts.map +1 -0
  77. package/dist/src/mcpl/server-connection.js +559 -0
  78. package/dist/src/mcpl/server-connection.js.map +1 -0
  79. package/dist/src/mcpl/server-registry.d.ts +63 -0
  80. package/dist/src/mcpl/server-registry.d.ts.map +1 -0
  81. package/dist/src/mcpl/server-registry.js +119 -0
  82. package/dist/src/mcpl/server-registry.js.map +1 -0
  83. package/dist/src/mcpl/types.d.ts +755 -0
  84. package/dist/src/mcpl/types.d.ts.map +1 -0
  85. package/dist/src/mcpl/types.js +48 -0
  86. package/dist/src/mcpl/types.js.map +1 -0
  87. package/dist/src/module-registry.d.ts +93 -0
  88. package/dist/src/module-registry.d.ts.map +1 -0
  89. package/dist/src/module-registry.js +386 -0
  90. package/dist/src/module-registry.js.map +1 -0
  91. package/dist/src/modules/api/index.d.ts +22 -0
  92. package/dist/src/modules/api/index.d.ts.map +1 -0
  93. package/dist/src/modules/api/index.js +63 -0
  94. package/dist/src/modules/api/index.js.map +1 -0
  95. package/dist/src/modules/discord/discord-js-client.d.ts +58 -0
  96. package/dist/src/modules/discord/discord-js-client.d.ts.map +1 -0
  97. package/dist/src/modules/discord/discord-js-client.js +273 -0
  98. package/dist/src/modules/discord/discord-js-client.js.map +1 -0
  99. package/dist/src/modules/discord/index.d.ts +82 -0
  100. package/dist/src/modules/discord/index.d.ts.map +1 -0
  101. package/dist/src/modules/discord/index.js +959 -0
  102. package/dist/src/modules/discord/index.js.map +1 -0
  103. package/dist/src/modules/discord/types.d.ts +327 -0
  104. package/dist/src/modules/discord/types.d.ts.map +1 -0
  105. package/dist/src/modules/discord/types.js +5 -0
  106. package/dist/src/modules/discord/types.js.map +1 -0
  107. package/dist/src/modules/index.d.ts +11 -0
  108. package/dist/src/modules/index.d.ts.map +1 -0
  109. package/dist/src/modules/index.js +7 -0
  110. package/dist/src/modules/index.js.map +1 -0
  111. package/dist/src/modules/workspace/index.d.ts +59 -0
  112. package/dist/src/modules/workspace/index.d.ts.map +1 -0
  113. package/dist/src/modules/workspace/index.js +831 -0
  114. package/dist/src/modules/workspace/index.js.map +1 -0
  115. package/dist/src/modules/workspace/sync.d.ts +48 -0
  116. package/dist/src/modules/workspace/sync.d.ts.map +1 -0
  117. package/dist/src/modules/workspace/sync.js +253 -0
  118. package/dist/src/modules/workspace/sync.js.map +1 -0
  119. package/dist/src/modules/workspace/types.d.ts +166 -0
  120. package/dist/src/modules/workspace/types.d.ts.map +1 -0
  121. package/dist/src/modules/workspace/types.js +5 -0
  122. package/dist/src/modules/workspace/types.js.map +1 -0
  123. package/dist/src/modules/workspace/watcher.d.ts +43 -0
  124. package/dist/src/modules/workspace/watcher.d.ts.map +1 -0
  125. package/dist/src/modules/workspace/watcher.js +120 -0
  126. package/dist/src/modules/workspace/watcher.js.map +1 -0
  127. package/dist/src/queue.d.ts +50 -0
  128. package/dist/src/queue.d.ts.map +1 -0
  129. package/dist/src/queue.js +95 -0
  130. package/dist/src/queue.js.map +1 -0
  131. package/dist/src/safe-slice.d.ts +8 -0
  132. package/dist/src/safe-slice.d.ts.map +1 -0
  133. package/dist/src/safe-slice.js +18 -0
  134. package/dist/src/safe-slice.js.map +1 -0
  135. package/dist/src/types/agent.d.ts +118 -0
  136. package/dist/src/types/agent.d.ts.map +1 -0
  137. package/dist/src/types/agent.js +2 -0
  138. package/dist/src/types/agent.js.map +1 -0
  139. package/dist/src/types/events.d.ts +220 -0
  140. package/dist/src/types/events.d.ts.map +1 -0
  141. package/dist/src/types/events.js +2 -0
  142. package/dist/src/types/events.js.map +1 -0
  143. package/dist/src/types/framework.d.ts +184 -0
  144. package/dist/src/types/framework.d.ts.map +1 -0
  145. package/dist/src/types/framework.js +2 -0
  146. package/dist/src/types/framework.js.map +1 -0
  147. package/dist/src/types/index.d.ts +7 -0
  148. package/dist/src/types/index.d.ts.map +1 -0
  149. package/dist/src/types/index.js +7 -0
  150. package/dist/src/types/index.js.map +1 -0
  151. package/dist/src/types/inference-log.d.ts +64 -0
  152. package/dist/src/types/inference-log.d.ts.map +1 -0
  153. package/dist/src/types/inference-log.js +5 -0
  154. package/dist/src/types/inference-log.js.map +1 -0
  155. package/dist/src/types/module.d.ts +302 -0
  156. package/dist/src/types/module.d.ts.map +1 -0
  157. package/dist/src/types/module.js +2 -0
  158. package/dist/src/types/module.js.map +1 -0
  159. package/dist/src/types/trace.d.ts +173 -0
  160. package/dist/src/types/trace.d.ts.map +1 -0
  161. package/dist/src/types/trace.js +2 -0
  162. package/dist/src/types/trace.js.map +1 -0
  163. package/dist/test/event-gate.test.d.ts +2 -0
  164. package/dist/test/event-gate.test.d.ts.map +1 -0
  165. package/dist/test/event-gate.test.js +535 -0
  166. package/dist/test/event-gate.test.js.map +1 -0
  167. package/dist/test/framework.test.d.ts +5 -0
  168. package/dist/test/framework.test.d.ts.map +1 -0
  169. package/dist/test/framework.test.js +738 -0
  170. package/dist/test/framework.test.js.map +1 -0
  171. package/dist/tsconfig.tsbuildinfo +1 -0
  172. package/package.json +58 -0
  173. package/src/agent.ts +512 -0
  174. package/src/api/mcp-server.ts +687 -0
  175. package/src/api/server.ts +1023 -0
  176. package/src/api/types.ts +542 -0
  177. package/src/framework.ts +2784 -0
  178. package/src/gate/event-gate.ts +623 -0
  179. package/src/gate/index.ts +12 -0
  180. package/src/gate/types.ts +112 -0
  181. package/src/index.ts +63 -0
  182. package/src/mcpl/channel-registry.ts +824 -0
  183. package/src/mcpl/checkpoint-manager.ts +545 -0
  184. package/src/mcpl/errors.ts +114 -0
  185. package/src/mcpl/feature-set-manager.ts +333 -0
  186. package/src/mcpl/hook-orchestrator.ts +281 -0
  187. package/src/mcpl/index.ts +134 -0
  188. package/src/mcpl/inference-router.ts +335 -0
  189. package/src/mcpl/push-handler.ts +232 -0
  190. package/src/mcpl/scope-manager.ts +262 -0
  191. package/src/mcpl/server-connection.ts +694 -0
  192. package/src/mcpl/server-registry.ts +144 -0
  193. package/src/mcpl/types.ts +991 -0
  194. package/src/module-registry.ts +547 -0
  195. package/src/modules/api/index.ts +94 -0
  196. package/src/modules/discord/discord-js-client.ts +353 -0
  197. package/src/modules/discord/index.ts +1146 -0
  198. package/src/modules/discord/types.ts +465 -0
  199. package/src/modules/index.ts +43 -0
  200. package/src/modules/workspace/index.ts +969 -0
  201. package/src/modules/workspace/sync.ts +314 -0
  202. package/src/modules/workspace/types.ts +202 -0
  203. package/src/modules/workspace/watcher.ts +142 -0
  204. package/src/queue.ts +106 -0
  205. package/src/safe-slice.ts +18 -0
  206. package/src/types/agent.ts +119 -0
  207. package/src/types/events.ts +252 -0
  208. package/src/types/framework.ts +211 -0
  209. package/src/types/index.ts +6 -0
  210. package/src/types/inference-log.ts +64 -0
  211. package/src/types/module.ts +367 -0
  212. package/src/types/trace.ts +196 -0
@@ -0,0 +1,503 @@
1
+ /**
2
+ * EventGate — file-driven inference gating with per-policy debounce.
3
+ *
4
+ * Reads policies from a `gate.json` config file. Policies are evaluated in
5
+ * order — first match wins. Each policy specifies a behavior: "always"
6
+ * (trigger immediately), "skip" (don't trigger), or { debounce: ms }
7
+ * (batch events per-policy, deliver when timer fires).
8
+ *
9
+ * The gate controls inference triggering only. Events always enter context
10
+ * and are always dispatched to modules — the gate decides whether to spend
11
+ * inference tokens, not whether the agent should know about the event.
12
+ */
13
+ import { existsSync, readFileSync, statSync, writeFileSync, mkdirSync } from 'node:fs';
14
+ import { dirname } from 'node:path';
15
+ // ---------------------------------------------------------------------------
16
+ // Constants
17
+ // ---------------------------------------------------------------------------
18
+ /** Max content length stored in pending debounce events. */
19
+ const MAX_CONTENT_SNIPPET = 200;
20
+ /** Max content length shown in onWake trace summaries. */
21
+ const MAX_TRACE_SNIPPET = 80;
22
+ /** Max events buffered during inference before oldest are dropped. */
23
+ const MAX_INFERENCE_BUFFER = 100;
24
+ /** Minimum interval between filesystem checks for config changes (ms). */
25
+ const RELOAD_THROTTLE_MS = 1000;
26
+ /** Minimum debounce value (ms). */
27
+ const MIN_DEBOUNCE_MS = 100;
28
+ /** Maximum debounce value (ms). */
29
+ const MAX_DEBOUNCE_MS = 300_000;
30
+ // ---------------------------------------------------------------------------
31
+ // Default config
32
+ // ---------------------------------------------------------------------------
33
+ const DEFAULT_CONFIG = {
34
+ policies: [],
35
+ default: 'always',
36
+ };
37
+ // ---------------------------------------------------------------------------
38
+ // Glob matching (simple * wildcards)
39
+ // ---------------------------------------------------------------------------
40
+ function compileGlob(pattern) {
41
+ // Escape everything except *, then replace * with .*
42
+ const escaped = pattern.replace(/[.+?^${}()|[\]\\]/g, '\\$&');
43
+ if (!pattern.includes('*')) {
44
+ return new RegExp('^' + escaped + '$');
45
+ }
46
+ return new RegExp('^' + escaped.replace(/\*/g, '.*') + '$');
47
+ }
48
+ // ---------------------------------------------------------------------------
49
+ // Config validation
50
+ // ---------------------------------------------------------------------------
51
+ function validateConfig(raw) {
52
+ if (!raw || typeof raw !== 'object') {
53
+ throw new Error('gate.json must be a JSON object');
54
+ }
55
+ const obj = raw;
56
+ const defaultBehavior = obj.default ?? 'always';
57
+ if (defaultBehavior !== 'always' && defaultBehavior !== 'skip') {
58
+ throw new Error(`gate.json "default" must be "always" or "skip", got: ${defaultBehavior}`);
59
+ }
60
+ const policies = [];
61
+ if (Array.isArray(obj.policies)) {
62
+ for (const p of obj.policies) {
63
+ policies.push(validatePolicy(p));
64
+ }
65
+ }
66
+ return { policies, default: defaultBehavior };
67
+ }
68
+ function validatePolicy(raw) {
69
+ if (!raw || typeof raw !== 'object') {
70
+ throw new Error('Each gate policy must be an object');
71
+ }
72
+ const obj = raw;
73
+ if (typeof obj.name !== 'string' || !obj.name) {
74
+ throw new Error('Gate policy must have a "name" string');
75
+ }
76
+ // Validate behavior
77
+ let behavior;
78
+ if (obj.behavior === 'always' || obj.behavior === 'skip') {
79
+ behavior = obj.behavior;
80
+ }
81
+ else if (obj.behavior && typeof obj.behavior === 'object') {
82
+ const b = obj.behavior;
83
+ if (typeof b.debounce === 'number' && b.debounce > 0) {
84
+ if (b.debounce < MIN_DEBOUNCE_MS) {
85
+ throw new Error(`Policy "${obj.name}": debounce must be >= ${MIN_DEBOUNCE_MS}ms, got ${b.debounce}`);
86
+ }
87
+ if (b.debounce > MAX_DEBOUNCE_MS) {
88
+ throw new Error(`Policy "${obj.name}": debounce must be <= ${MAX_DEBOUNCE_MS}ms, got ${b.debounce}`);
89
+ }
90
+ behavior = { debounce: b.debounce };
91
+ }
92
+ else {
93
+ throw new Error(`Policy "${obj.name}": debounce must be a positive number`);
94
+ }
95
+ }
96
+ else {
97
+ behavior = 'always';
98
+ }
99
+ // Validate match (lenient — missing fields mean "match all")
100
+ const match = {};
101
+ if (obj.match && typeof obj.match === 'object') {
102
+ const m = obj.match;
103
+ if (Array.isArray(m.scope))
104
+ match.scope = m.scope.filter(s => typeof s === 'string');
105
+ if (typeof m.source === 'string')
106
+ match.source = m.source;
107
+ if (typeof m.channel === 'string')
108
+ match.channel = m.channel;
109
+ if (m.filter && typeof m.filter === 'object') {
110
+ const f = m.filter;
111
+ if ((f.type === 'text' || f.type === 'regex') && typeof f.pattern === 'string') {
112
+ match.filter = { type: f.type, pattern: f.pattern };
113
+ if (f.type === 'regex') {
114
+ try {
115
+ new RegExp(f.pattern);
116
+ }
117
+ catch (e) {
118
+ throw new Error(`Policy "${obj.name}": invalid regex pattern: ${e}`);
119
+ }
120
+ }
121
+ }
122
+ }
123
+ }
124
+ return { name: obj.name, match, behavior };
125
+ }
126
+ // ---------------------------------------------------------------------------
127
+ // EventGate
128
+ // ---------------------------------------------------------------------------
129
+ export class EventGate {
130
+ configPath;
131
+ config;
132
+ compiledPolicies = [];
133
+ configMtime = 0;
134
+ lastReloadCheck = 0;
135
+ configSource = 'default';
136
+ lastReloadTimestamp = null;
137
+ configErrors = [];
138
+ // Debounce state
139
+ debounceTimers = new Map();
140
+ // Inference buffering
141
+ inferring = new Set();
142
+ inferenceBuffer = [];
143
+ // Per-policy stats
144
+ stats = new Map();
145
+ // Dependency-injected callbacks
146
+ emitTrace;
147
+ addMessageFn;
148
+ requestInferenceFn;
149
+ getAgentNamesFn;
150
+ constructor(opts) {
151
+ this.configPath = opts.configPath;
152
+ this.emitTrace = opts.emitTrace;
153
+ this.addMessageFn = opts.addMessage;
154
+ this.requestInferenceFn = opts.requestInference;
155
+ this.getAgentNamesFn = opts.getAgentNames;
156
+ // Seed config file if it doesn't exist
157
+ if (opts.initialConfig && !existsSync(this.configPath)) {
158
+ try {
159
+ mkdirSync(dirname(this.configPath), { recursive: true });
160
+ writeFileSync(this.configPath, JSON.stringify(opts.initialConfig, null, 2) + '\n');
161
+ }
162
+ catch (err) {
163
+ this.configErrors.push(`Failed to seed gate.json: ${err}`);
164
+ }
165
+ }
166
+ // Load config
167
+ this.config = this.loadConfig() ?? opts.initialConfig ?? { ...DEFAULT_CONFIG };
168
+ this.compiledPolicies = this.compilePolicies(this.config);
169
+ }
170
+ // =========================================================================
171
+ // Config loading
172
+ // =========================================================================
173
+ loadConfig() {
174
+ if (!existsSync(this.configPath)) {
175
+ return null;
176
+ }
177
+ try {
178
+ const raw = readFileSync(this.configPath, 'utf-8');
179
+ const stat = statSync(this.configPath);
180
+ this.configMtime = stat.mtimeMs;
181
+ const config = validateConfig(JSON.parse(raw));
182
+ this.configSource = 'file';
183
+ this.configErrors = [];
184
+ return config;
185
+ }
186
+ catch (err) {
187
+ const msg = err instanceof Error ? err.message : String(err);
188
+ this.configErrors = [msg];
189
+ this.emitTrace({
190
+ type: 'gate:config-error',
191
+ error: msg,
192
+ configPath: this.configPath,
193
+ timestamp: Date.now(),
194
+ });
195
+ return null; // Caller keeps previous config
196
+ }
197
+ }
198
+ compilePolicies(config) {
199
+ return config.policies.map(policy => {
200
+ const compiled = { policy };
201
+ if (policy.match.filter?.type === 'regex') {
202
+ try {
203
+ compiled.filterRegex = new RegExp(policy.match.filter.pattern, 'i');
204
+ }
205
+ catch { /* skip */ }
206
+ }
207
+ if (policy.match.source) {
208
+ compiled.sourceRegex = compileGlob(policy.match.source);
209
+ }
210
+ if (policy.match.channel) {
211
+ compiled.channelRegex = compileGlob(policy.match.channel);
212
+ }
213
+ return compiled;
214
+ });
215
+ }
216
+ reloadIfChanged() {
217
+ const now = Date.now();
218
+ if (now - this.lastReloadCheck < RELOAD_THROTTLE_MS)
219
+ return;
220
+ this.lastReloadCheck = now;
221
+ try {
222
+ if (!existsSync(this.configPath))
223
+ return;
224
+ const stat = statSync(this.configPath);
225
+ if (stat.mtimeMs === this.configMtime)
226
+ return;
227
+ const newConfig = this.loadConfig();
228
+ if (!newConfig)
229
+ return; // Parse error — keep previous config
230
+ // Clean up debounce timers for removed policies
231
+ const newPolicyNames = new Set(newConfig.policies.map(p => p.name));
232
+ for (const [name, state] of this.debounceTimers) {
233
+ if (!newPolicyNames.has(name)) {
234
+ clearTimeout(state.timer);
235
+ if (state.events.length > 0) {
236
+ this.deliverEvents(state.events);
237
+ }
238
+ this.debounceTimers.delete(name);
239
+ }
240
+ }
241
+ // Reset stats for removed policies
242
+ for (const name of this.stats.keys()) {
243
+ if (!newPolicyNames.has(name)) {
244
+ this.stats.delete(name);
245
+ }
246
+ }
247
+ this.config = newConfig;
248
+ this.compiledPolicies = this.compilePolicies(newConfig);
249
+ this.lastReloadTimestamp = now;
250
+ this.emitTrace({
251
+ type: 'gate:config-reloaded',
252
+ configPath: this.configPath,
253
+ policyCount: newConfig.policies.length,
254
+ timestamp: now,
255
+ });
256
+ }
257
+ catch {
258
+ // Ignore stat errors
259
+ }
260
+ }
261
+ // =========================================================================
262
+ // Policy matching — first match wins
263
+ // =========================================================================
264
+ matchPolicy(info) {
265
+ for (const compiled of this.compiledPolicies) {
266
+ if (this.compiledMatches(compiled, info)) {
267
+ return compiled.policy;
268
+ }
269
+ }
270
+ return null;
271
+ }
272
+ compiledMatches(compiled, info) {
273
+ const match = compiled.policy.match;
274
+ // Scope check
275
+ if (match.scope && match.scope.length > 0 && !match.scope.includes(info.eventType)) {
276
+ return false;
277
+ }
278
+ // Source check (serverId)
279
+ if (compiled.sourceRegex && !compiled.sourceRegex.test(info.serverId)) {
280
+ return false;
281
+ }
282
+ // Channel check
283
+ if (compiled.channelRegex && !compiled.channelRegex.test(info.channelId)) {
284
+ return false;
285
+ }
286
+ // Content filter check
287
+ if (match.filter) {
288
+ if (match.filter.type === 'text') {
289
+ if (!info.content.toLowerCase().includes(match.filter.pattern.toLowerCase())) {
290
+ return false;
291
+ }
292
+ }
293
+ else if (compiled.filterRegex) {
294
+ if (!compiled.filterRegex.test(info.content)) {
295
+ return false;
296
+ }
297
+ }
298
+ else {
299
+ return false; // Regex failed to compile
300
+ }
301
+ }
302
+ return true;
303
+ }
304
+ // =========================================================================
305
+ // Evaluate — main entry point
306
+ // =========================================================================
307
+ evaluate(info) {
308
+ this.reloadIfChanged();
309
+ const policy = this.matchPolicy(info);
310
+ if (!policy) {
311
+ // No policy matched — use default
312
+ const trigger = (this.config.default ?? 'always') === 'always';
313
+ return { trigger, policyName: null, behavior: this.config.default ?? 'always' };
314
+ }
315
+ // Record stats
316
+ const policyStats = this.stats.get(policy.name) ?? { matchCount: 0, lastMatchTimestamp: null };
317
+ policyStats.matchCount++;
318
+ policyStats.lastMatchTimestamp = Date.now();
319
+ this.stats.set(policy.name, policyStats);
320
+ // Emit trace
321
+ this.emitTrace({
322
+ type: 'gate:policy-matched',
323
+ policyName: policy.name,
324
+ behavior: typeof policy.behavior === 'object' ? `debounce:${policy.behavior.debounce}` : policy.behavior,
325
+ eventType: info.eventType,
326
+ source: info.serverId || undefined,
327
+ timestamp: Date.now(),
328
+ });
329
+ if (policy.behavior === 'skip') {
330
+ return { trigger: false, policyName: policy.name, behavior: 'skip' };
331
+ }
332
+ if (policy.behavior === 'always') {
333
+ return { trigger: true, policyName: policy.name, behavior: 'always' };
334
+ }
335
+ // Debounce
336
+ this.handleDebounce(policy, info);
337
+ return { trigger: false, policyName: policy.name, behavior: policy.behavior };
338
+ }
339
+ // =========================================================================
340
+ // shouldTriggerInference callback adapter
341
+ // =========================================================================
342
+ /**
343
+ * Returns a callback compatible with McplServerConfig.shouldTriggerInference.
344
+ * Used by the framework to wire the gate into PushHandler and ChannelRegistry.
345
+ */
346
+ asShouldTriggerCallback() {
347
+ return (content, metadata) => {
348
+ const decision = this.evaluate({
349
+ content,
350
+ eventType: metadata.eventType ?? 'unknown',
351
+ serverId: metadata.serverId ?? '',
352
+ channelId: metadata.channelId ?? '',
353
+ metadata,
354
+ });
355
+ return decision.trigger;
356
+ };
357
+ }
358
+ // =========================================================================
359
+ // Debounce
360
+ // =========================================================================
361
+ handleDebounce(policy, info) {
362
+ const debounceMs = policy.behavior.debounce;
363
+ const event = {
364
+ policyName: policy.name,
365
+ content: info.content.length > MAX_CONTENT_SNIPPET
366
+ ? info.content.slice(0, MAX_CONTENT_SNIPPET) + '...'
367
+ : info.content,
368
+ eventType: info.eventType,
369
+ timestamp: Date.now(),
370
+ };
371
+ const existing = this.debounceTimers.get(policy.name);
372
+ if (existing) {
373
+ clearTimeout(existing.timer);
374
+ existing.events.push(event);
375
+ existing.timer = setTimeout(() => this.fireDebounce(policy.name), debounceMs);
376
+ }
377
+ else {
378
+ const timer = setTimeout(() => this.fireDebounce(policy.name), debounceMs);
379
+ this.debounceTimers.set(policy.name, { timer, events: [event] });
380
+ }
381
+ }
382
+ fireDebounce(policyName) {
383
+ const state = this.debounceTimers.get(policyName);
384
+ if (!state || state.events.length === 0) {
385
+ this.debounceTimers.delete(policyName);
386
+ return;
387
+ }
388
+ const events = state.events;
389
+ this.debounceTimers.delete(policyName);
390
+ // If any agent is currently inferring, buffer for later (with cap)
391
+ if (this.inferring.size > 0) {
392
+ this.bufferForInference(events);
393
+ return;
394
+ }
395
+ this.deliverEvents(events);
396
+ this.emitTrace({
397
+ type: 'gate:debounce-delivered',
398
+ policyName,
399
+ eventCount: events.length,
400
+ timestamp: Date.now(),
401
+ });
402
+ }
403
+ // =========================================================================
404
+ // Event delivery
405
+ // =========================================================================
406
+ deliverEvents(events) {
407
+ if (events.length === 0)
408
+ return;
409
+ const policyNames = [...new Set(events.map(e => e.policyName))];
410
+ const lines = events
411
+ .map(e => `- [${e.policyName}] (${e.eventType}): ${e.content}`)
412
+ .join('\n');
413
+ const text = `[Gate: ${events.length} event${events.length > 1 ? 's' : ''} matched]\n\n${lines}`;
414
+ this.addMessageFn('user', [{ type: 'text', text }], {
415
+ source: 'gate:debounce',
416
+ policies: policyNames,
417
+ });
418
+ for (const agentName of this.getAgentNamesFn()) {
419
+ this.requestInferenceFn(agentName, 'gate:debounce', 'gate');
420
+ }
421
+ }
422
+ // =========================================================================
423
+ // Inference lifecycle
424
+ // =========================================================================
425
+ onInferenceStarted(agentName) {
426
+ this.inferring.add(agentName);
427
+ }
428
+ onInferenceEnded(agentName) {
429
+ this.inferring.delete(agentName);
430
+ // Flush inference buffer if no agents are inferring
431
+ if (this.inferring.size === 0 && this.inferenceBuffer.length > 0) {
432
+ const events = this.inferenceBuffer.splice(0);
433
+ // Defer to avoid re-entrancy inside trace callbacks
434
+ queueMicrotask(() => this.deliverEvents(events));
435
+ }
436
+ }
437
+ // =========================================================================
438
+ // Inference buffer cap
439
+ // =========================================================================
440
+ /** Called internally when debounce fires during inference. */
441
+ bufferForInference(events) {
442
+ for (const event of events) {
443
+ if (this.inferenceBuffer.length >= MAX_INFERENCE_BUFFER) {
444
+ this.inferenceBuffer.shift(); // Drop oldest
445
+ }
446
+ this.inferenceBuffer.push(event);
447
+ }
448
+ }
449
+ // =========================================================================
450
+ // Tool: gate:status
451
+ // =========================================================================
452
+ getToolDefinition() {
453
+ return {
454
+ name: 'gate:status',
455
+ description: 'Show the current EventGate configuration, per-policy match counts, debounce state, and any config errors.',
456
+ inputSchema: {
457
+ type: 'object',
458
+ },
459
+ };
460
+ }
461
+ async handleToolCall() {
462
+ const status = this.getStatus();
463
+ return { success: true, data: status };
464
+ }
465
+ getStatus() {
466
+ const policies = this.config.policies.map(p => {
467
+ const stats = this.stats.get(p.name);
468
+ const debounce = this.debounceTimers.get(p.name);
469
+ const result = {
470
+ name: p.name,
471
+ behavior: p.behavior,
472
+ matchCount: stats?.matchCount ?? 0,
473
+ lastMatchTimestamp: stats?.lastMatchTimestamp ?? null,
474
+ };
475
+ if (typeof p.behavior === 'object' && 'debounce' in p.behavior) {
476
+ result.debounceState = {
477
+ pendingCount: debounce?.events.length ?? 0,
478
+ nextDeliveryMs: null, // Timer internals not easily inspectable
479
+ };
480
+ }
481
+ return result;
482
+ });
483
+ return {
484
+ configPath: this.configPath,
485
+ configSource: this.configSource,
486
+ lastReloadTimestamp: this.lastReloadTimestamp,
487
+ default: this.config.default ?? 'always',
488
+ policies,
489
+ errors: [...this.configErrors],
490
+ };
491
+ }
492
+ // =========================================================================
493
+ // Cleanup
494
+ // =========================================================================
495
+ dispose() {
496
+ for (const state of this.debounceTimers.values()) {
497
+ clearTimeout(state.timer);
498
+ }
499
+ this.debounceTimers.clear();
500
+ this.inferenceBuffer = [];
501
+ }
502
+ }
503
+ //# sourceMappingURL=event-gate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"event-gate.js","sourceRoot":"","sources":["../../../src/gate/event-gate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,3 @@
1
+ export { EventGate } from './event-gate.js';
2
+ export type { GateConfig, GateOptions, GatePolicy, GatePolicyMatch, GateBehavior, GateDecision, GateEventInfo, GateStatus, GatePolicyStats, } from './types.js';
3
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC"}
@@ -0,0 +1,2 @@
1
+ export { EventGate } from './event-gate.js';
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/gate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC"}
@@ -0,0 +1,82 @@
1
+ /**
2
+ * EventGate type definitions.
3
+ *
4
+ * The EventGate is a core framework component that evaluates incoming events
5
+ * against declarative policies to decide whether they should trigger inference.
6
+ * Policies are read from a `gate.json` file with hot-reload support.
7
+ */
8
+ /** How a matching policy affects inference triggering. */
9
+ export type GateBehavior = 'always' | 'skip' | {
10
+ debounce: number;
11
+ };
12
+ /** Criteria for matching an event. All specified fields must match (AND logic). */
13
+ export interface GatePolicyMatch {
14
+ /** Event types to match (exact). Empty/omitted = all. */
15
+ scope?: string[];
16
+ /** ServerId to match (exact or glob with *). */
17
+ source?: string;
18
+ /** ChannelId to match (exact or glob with *). */
19
+ channel?: string;
20
+ /** Content text filter. */
21
+ filter?: {
22
+ type: 'text' | 'regex';
23
+ pattern: string;
24
+ };
25
+ }
26
+ /** A single gate policy — one rule in the ordered policy list. */
27
+ export interface GatePolicy {
28
+ name: string;
29
+ match: GatePolicyMatch;
30
+ behavior: GateBehavior;
31
+ }
32
+ /** Top-level gate configuration, stored in gate.json. */
33
+ export interface GateConfig {
34
+ policies: GatePolicy[];
35
+ /** Behavior when no policy matches. Default: 'always'. */
36
+ default?: 'always' | 'skip';
37
+ }
38
+ /** Options for configuring the EventGate via FrameworkConfig. */
39
+ export interface GateOptions {
40
+ /** Path to gate.json. Default: derived from storePath. */
41
+ configPath?: string;
42
+ /** Initial config, seeded to gate.json if the file doesn't exist. */
43
+ config?: GateConfig;
44
+ }
45
+ /** The result of evaluating an event against the gate. */
46
+ export interface GateDecision {
47
+ /** Whether to trigger inference. */
48
+ trigger: boolean;
49
+ /** Name of the matching policy (null if default applied). */
50
+ policyName: string | null;
51
+ /** The behavior that was applied. */
52
+ behavior: GateBehavior;
53
+ }
54
+ /** Information about an event being evaluated. */
55
+ export interface GateEventInfo {
56
+ content: string;
57
+ eventType: string;
58
+ serverId: string;
59
+ channelId: string;
60
+ metadata?: Record<string, unknown>;
61
+ }
62
+ /** Per-policy runtime statistics (for gate:status). */
63
+ export interface GatePolicyStats {
64
+ name: string;
65
+ behavior: GateBehavior;
66
+ matchCount: number;
67
+ lastMatchTimestamp: number | null;
68
+ debounceState?: {
69
+ pendingCount: number;
70
+ nextDeliveryMs: number | null;
71
+ };
72
+ }
73
+ /** Full gate status returned by gate:status tool. */
74
+ export interface GateStatus {
75
+ configPath: string;
76
+ configSource: 'file' | 'initial' | 'default';
77
+ lastReloadTimestamp: number | null;
78
+ default: 'always' | 'skip';
79
+ policies: GatePolicyStats[];
80
+ errors: string[];
81
+ }
82
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/gate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GACpB,QAAQ,GACR,MAAM,GACN;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMzB,mFAAmF;AACnF,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,gDAAgD;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2BAA2B;IAC3B,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtD;AAMD,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,eAAe,CAAC;IACvB,QAAQ,EAAE,YAAY,CAAC;CACxB;AAMD,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC7B;AAMD,iEAAiE;AACjE,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAMD,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,oCAAoC;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,QAAQ,EAAE,YAAY,CAAC;CACxB;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,aAAa,CAAC,EAAE;QACd,YAAY,EAAE,MAAM,CAAC;QACrB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;KAC/B,CAAC;CACH;AAED,qDAAqD;AACrD,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC7C,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC3B,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * EventGate type definitions.
3
+ *
4
+ * The EventGate is a core framework component that evaluates incoming events
5
+ * against declarative policies to decide whether they should trigger inference.
6
+ * Policies are read from a `gate.json` file with hot-reload support.
7
+ */
8
+ export {};
9
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/gate/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}