@theihtisham/agent-shadow-brain 5.2.0 → 6.0.2

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 (301) hide show
  1. package/README.md +310 -1014
  2. package/dist/brain/agent-firewall.d.ts +7 -0
  3. package/dist/brain/agent-firewall.d.ts.map +1 -0
  4. package/dist/brain/agent-firewall.js +152 -0
  5. package/dist/brain/agent-firewall.js.map +1 -0
  6. package/dist/brain/agent-handoff.d.ts +19 -0
  7. package/dist/brain/agent-handoff.d.ts.map +1 -0
  8. package/dist/brain/agent-handoff.js +127 -0
  9. package/dist/brain/agent-handoff.js.map +1 -0
  10. package/dist/brain/air-gap.d.ts +23 -0
  11. package/dist/brain/air-gap.d.ts.map +1 -0
  12. package/dist/brain/air-gap.js +137 -0
  13. package/dist/brain/air-gap.js.map +1 -0
  14. package/dist/brain/attention-heatmap.d.ts +24 -0
  15. package/dist/brain/attention-heatmap.d.ts.map +1 -0
  16. package/dist/brain/attention-heatmap.js +108 -0
  17. package/dist/brain/attention-heatmap.js.map +1 -0
  18. package/dist/brain/auto-setup.js +19 -14
  19. package/dist/brain/auto-setup.js.map +1 -1
  20. package/dist/brain/auto-update.js +1 -1
  21. package/dist/brain/brain-3d.d.ts +79 -0
  22. package/dist/brain/brain-3d.d.ts.map +1 -0
  23. package/dist/brain/brain-3d.js +468 -0
  24. package/dist/brain/brain-3d.js.map +1 -0
  25. package/dist/brain/brain-active-learner.d.ts +74 -0
  26. package/dist/brain/brain-active-learner.d.ts.map +1 -0
  27. package/dist/brain/brain-active-learner.js +425 -0
  28. package/dist/brain/brain-active-learner.js.map +1 -0
  29. package/dist/brain/brain-ascii.d.ts +32 -0
  30. package/dist/brain/brain-ascii.d.ts.map +1 -0
  31. package/dist/brain/brain-ascii.js +402 -0
  32. package/dist/brain/brain-ascii.js.map +1 -0
  33. package/dist/brain/brain-chat.d.ts +42 -0
  34. package/dist/brain/brain-chat.d.ts.map +1 -0
  35. package/dist/brain/brain-chat.js +162 -0
  36. package/dist/brain/brain-chat.js.map +1 -0
  37. package/dist/brain/brain-cinema.d.ts +45 -0
  38. package/dist/brain/brain-cinema.d.ts.map +1 -0
  39. package/dist/brain/brain-cinema.js +393 -0
  40. package/dist/brain/brain-cinema.js.map +1 -0
  41. package/dist/brain/brain-coach.d.ts +45 -0
  42. package/dist/brain/brain-coach.d.ts.map +1 -0
  43. package/dist/brain/brain-coach.js +383 -0
  44. package/dist/brain/brain-coach.js.map +1 -0
  45. package/dist/brain/brain-consolidator.d.ts +56 -0
  46. package/dist/brain/brain-consolidator.d.ts.map +1 -0
  47. package/dist/brain/brain-consolidator.js +386 -0
  48. package/dist/brain/brain-consolidator.js.map +1 -0
  49. package/dist/brain/brain-contradictions.d.ts +57 -0
  50. package/dist/brain/brain-contradictions.d.ts.map +1 -0
  51. package/dist/brain/brain-contradictions.js +443 -0
  52. package/dist/brain/brain-contradictions.js.map +1 -0
  53. package/dist/brain/brain-diff.d.ts +61 -0
  54. package/dist/brain/brain-diff.d.ts.map +1 -0
  55. package/dist/brain/brain-diff.js +439 -0
  56. package/dist/brain/brain-diff.js.map +1 -0
  57. package/dist/brain/brain-dna.d.ts +59 -0
  58. package/dist/brain/brain-dna.d.ts.map +1 -0
  59. package/dist/brain/brain-dna.js +336 -0
  60. package/dist/brain/brain-dna.js.map +1 -0
  61. package/dist/brain/brain-doppelganger.d.ts +32 -0
  62. package/dist/brain/brain-doppelganger.d.ts.map +1 -0
  63. package/dist/brain/brain-doppelganger.js +417 -0
  64. package/dist/brain/brain-doppelganger.js.map +1 -0
  65. package/dist/brain/brain-encryption.d.ts +14 -0
  66. package/dist/brain/brain-encryption.d.ts.map +1 -0
  67. package/dist/brain/brain-encryption.js +68 -0
  68. package/dist/brain/brain-encryption.js.map +1 -0
  69. package/dist/brain/brain-exchange.d.ts +30 -0
  70. package/dist/brain/brain-exchange.d.ts.map +1 -0
  71. package/dist/brain/brain-exchange.js +106 -0
  72. package/dist/brain/brain-exchange.js.map +1 -0
  73. package/dist/brain/brain-garden.d.ts +18 -0
  74. package/dist/brain/brain-garden.d.ts.map +1 -0
  75. package/dist/brain/brain-garden.js +81 -0
  76. package/dist/brain/brain-garden.js.map +1 -0
  77. package/dist/brain/brain-graph-walker.d.ts +54 -0
  78. package/dist/brain/brain-graph-walker.d.ts.map +1 -0
  79. package/dist/brain/brain-graph-walker.js +412 -0
  80. package/dist/brain/brain-graph-walker.js.map +1 -0
  81. package/dist/brain/brain-holiday-card.d.ts +50 -0
  82. package/dist/brain/brain-holiday-card.d.ts.map +1 -0
  83. package/dist/brain/brain-holiday-card.js +432 -0
  84. package/dist/brain/brain-holiday-card.js.map +1 -0
  85. package/dist/brain/brain-memes.d.ts +44 -0
  86. package/dist/brain/brain-memes.d.ts.map +1 -0
  87. package/dist/brain/brain-memes.js +438 -0
  88. package/dist/brain/brain-memes.js.map +1 -0
  89. package/dist/brain/brain-memory-tiers.d.ts +67 -0
  90. package/dist/brain/brain-memory-tiers.d.ts.map +1 -0
  91. package/dist/brain/brain-memory-tiers.js +292 -0
  92. package/dist/brain/brain-memory-tiers.js.map +1 -0
  93. package/dist/brain/brain-notebook.d.ts +68 -0
  94. package/dist/brain/brain-notebook.d.ts.map +1 -0
  95. package/dist/brain/brain-notebook.js +379 -0
  96. package/dist/brain/brain-notebook.js.map +1 -0
  97. package/dist/brain/brain-portability.js +1 -1
  98. package/dist/brain/brain-quantize.d.ts +62 -0
  99. package/dist/brain/brain-quantize.d.ts.map +1 -0
  100. package/dist/brain/brain-quantize.js +346 -0
  101. package/dist/brain/brain-quantize.js.map +1 -0
  102. package/dist/brain/brain-query-expander.d.ts +31 -0
  103. package/dist/brain/brain-query-expander.d.ts.map +1 -0
  104. package/dist/brain/brain-query-expander.js +417 -0
  105. package/dist/brain/brain-query-expander.js.map +1 -0
  106. package/dist/brain/brain-quest.d.ts +58 -0
  107. package/dist/brain/brain-quest.d.ts.map +1 -0
  108. package/dist/brain/brain-quest.js +541 -0
  109. package/dist/brain/brain-quest.js.map +1 -0
  110. package/dist/brain/brain-recall-cache.d.ts +73 -0
  111. package/dist/brain/brain-recall-cache.d.ts.map +1 -0
  112. package/dist/brain/brain-recall-cache.js +444 -0
  113. package/dist/brain/brain-recall-cache.js.map +1 -0
  114. package/dist/brain/brain-reflex.d.ts +55 -0
  115. package/dist/brain/brain-reflex.d.ts.map +1 -0
  116. package/dist/brain/brain-reflex.js +364 -0
  117. package/dist/brain/brain-reflex.js.map +1 -0
  118. package/dist/brain/brain-replay.d.ts +74 -0
  119. package/dist/brain/brain-replay.d.ts.map +1 -0
  120. package/dist/brain/brain-replay.js +336 -0
  121. package/dist/brain/brain-replay.js.map +1 -0
  122. package/dist/brain/brain-rerank.d.ts +39 -0
  123. package/dist/brain/brain-rerank.d.ts.map +1 -0
  124. package/dist/brain/brain-rerank.js +216 -0
  125. package/dist/brain/brain-rerank.js.map +1 -0
  126. package/dist/brain/brain-roast.d.ts +44 -0
  127. package/dist/brain/brain-roast.d.ts.map +1 -0
  128. package/dist/brain/brain-roast.js +566 -0
  129. package/dist/brain/brain-roast.js.map +1 -0
  130. package/dist/brain/brain-sonification.d.ts +57 -0
  131. package/dist/brain/brain-sonification.d.ts.map +1 -0
  132. package/dist/brain/brain-sonification.js +286 -0
  133. package/dist/brain/brain-sonification.js.map +1 -0
  134. package/dist/brain/brain-tarot.d.ts +49 -0
  135. package/dist/brain/brain-tarot.d.ts.map +1 -0
  136. package/dist/brain/brain-tarot.js +634 -0
  137. package/dist/brain/brain-tarot.js.map +1 -0
  138. package/dist/brain/brain-time-capsule.d.ts +80 -0
  139. package/dist/brain/brain-time-capsule.d.ts.map +1 -0
  140. package/dist/brain/brain-time-capsule.js +289 -0
  141. package/dist/brain/brain-time-capsule.js.map +1 -0
  142. package/dist/brain/brain-trophies.d.ts +60 -0
  143. package/dist/brain/brain-trophies.d.ts.map +1 -0
  144. package/dist/brain/brain-trophies.js +431 -0
  145. package/dist/brain/brain-trophies.js.map +1 -0
  146. package/dist/brain/brain-working-memory.d.ts +78 -0
  147. package/dist/brain/brain-working-memory.d.ts.map +1 -0
  148. package/dist/brain/brain-working-memory.js +367 -0
  149. package/dist/brain/brain-working-memory.js.map +1 -0
  150. package/dist/brain/branch-brain.d.ts +23 -0
  151. package/dist/brain/branch-brain.d.ts.map +1 -0
  152. package/dist/brain/branch-brain.js +159 -0
  153. package/dist/brain/branch-brain.js.map +1 -0
  154. package/dist/brain/calibration-monitor.d.ts +20 -0
  155. package/dist/brain/calibration-monitor.d.ts.map +1 -0
  156. package/dist/brain/calibration-monitor.js +144 -0
  157. package/dist/brain/calibration-monitor.js.map +1 -0
  158. package/dist/brain/causal-chains.d.ts +37 -0
  159. package/dist/brain/causal-chains.d.ts.map +1 -0
  160. package/dist/brain/causal-chains.js +250 -0
  161. package/dist/brain/causal-chains.js.map +1 -0
  162. package/dist/brain/collision-detective.d.ts +32 -0
  163. package/dist/brain/collision-detective.d.ts.map +1 -0
  164. package/dist/brain/collision-detective.js +233 -0
  165. package/dist/brain/collision-detective.js.map +1 -0
  166. package/dist/brain/confidence-gate.d.ts +69 -0
  167. package/dist/brain/confidence-gate.d.ts.map +1 -0
  168. package/dist/brain/confidence-gate.js +244 -0
  169. package/dist/brain/confidence-gate.js.map +1 -0
  170. package/dist/brain/constitution.d.ts +59 -0
  171. package/dist/brain/constitution.d.ts.map +1 -0
  172. package/dist/brain/constitution.js +315 -0
  173. package/dist/brain/constitution.js.map +1 -0
  174. package/dist/brain/cost-aware-spawner.d.ts +7 -0
  175. package/dist/brain/cost-aware-spawner.d.ts.map +1 -0
  176. package/dist/brain/cost-aware-spawner.js +77 -0
  177. package/dist/brain/cost-aware-spawner.js.map +1 -0
  178. package/dist/brain/dream-engine.d.ts +35 -0
  179. package/dist/brain/dream-engine.d.ts.map +1 -0
  180. package/dist/brain/dream-engine.js +273 -0
  181. package/dist/brain/dream-engine.js.map +1 -0
  182. package/dist/brain/embeddings-v2.d.ts +58 -0
  183. package/dist/brain/embeddings-v2.d.ts.map +1 -0
  184. package/dist/brain/embeddings-v2.js +344 -0
  185. package/dist/brain/embeddings-v2.js.map +1 -0
  186. package/dist/brain/embeddings.d.ts +27 -0
  187. package/dist/brain/embeddings.d.ts.map +1 -0
  188. package/dist/brain/embeddings.js +175 -0
  189. package/dist/brain/embeddings.js.map +1 -0
  190. package/dist/brain/forgetting-curve.d.ts +21 -0
  191. package/dist/brain/forgetting-curve.d.ts.map +1 -0
  192. package/dist/brain/forgetting-curve.js +174 -0
  193. package/dist/brain/forgetting-curve.js.map +1 -0
  194. package/dist/brain/formal-verification-bridge.d.ts +26 -0
  195. package/dist/brain/formal-verification-bridge.d.ts.map +1 -0
  196. package/dist/brain/formal-verification-bridge.js +219 -0
  197. package/dist/brain/formal-verification-bridge.js.map +1 -0
  198. package/dist/brain/global-brain.d.ts +8 -1
  199. package/dist/brain/global-brain.d.ts.map +1 -1
  200. package/dist/brain/global-brain.js +24 -0
  201. package/dist/brain/global-brain.js.map +1 -1
  202. package/dist/brain/hallucination-quarantine.d.ts +26 -0
  203. package/dist/brain/hallucination-quarantine.d.ts.map +1 -0
  204. package/dist/brain/hallucination-quarantine.js +135 -0
  205. package/dist/brain/hallucination-quarantine.js.map +1 -0
  206. package/dist/brain/hive-accelerator.d.ts +39 -0
  207. package/dist/brain/hive-accelerator.d.ts.map +1 -0
  208. package/dist/brain/hive-accelerator.js +152 -0
  209. package/dist/brain/hive-accelerator.js.map +1 -0
  210. package/dist/brain/hive-voice.d.ts +71 -0
  211. package/dist/brain/hive-voice.d.ts.map +1 -0
  212. package/dist/brain/hive-voice.js +352 -0
  213. package/dist/brain/hive-voice.js.map +1 -0
  214. package/dist/brain/json-output.d.ts +26 -0
  215. package/dist/brain/json-output.d.ts.map +1 -0
  216. package/dist/brain/json-output.js +112 -0
  217. package/dist/brain/json-output.js.map +1 -0
  218. package/dist/brain/l0-cache.js +1 -1
  219. package/dist/brain/l0-cache.js.map +1 -1
  220. package/dist/brain/local-llm.d.ts +20 -0
  221. package/dist/brain/local-llm.d.ts.map +1 -0
  222. package/dist/brain/local-llm.js +132 -0
  223. package/dist/brain/local-llm.js.map +1 -0
  224. package/dist/brain/markdown-export.d.ts +48 -0
  225. package/dist/brain/markdown-export.d.ts.map +1 -0
  226. package/dist/brain/markdown-export.js +382 -0
  227. package/dist/brain/markdown-export.js.map +1 -0
  228. package/dist/brain/mcp-server.d.ts +40 -0
  229. package/dist/brain/mcp-server.d.ts.map +1 -1
  230. package/dist/brain/mcp-server.js +395 -12
  231. package/dist/brain/mcp-server.js.map +1 -1
  232. package/dist/brain/model-registry.d.ts +96 -0
  233. package/dist/brain/model-registry.d.ts.map +1 -0
  234. package/dist/brain/model-registry.js +585 -0
  235. package/dist/brain/model-registry.js.map +1 -0
  236. package/dist/brain/multimodal-vision.d.ts +38 -0
  237. package/dist/brain/multimodal-vision.d.ts.map +1 -0
  238. package/dist/brain/multimodal-vision.js +257 -0
  239. package/dist/brain/multimodal-vision.js.map +1 -0
  240. package/dist/brain/orchestrator.js +1 -1
  241. package/dist/brain/otel-lite.d.ts +71 -0
  242. package/dist/brain/otel-lite.d.ts.map +1 -0
  243. package/dist/brain/otel-lite.js +232 -0
  244. package/dist/brain/otel-lite.js.map +1 -0
  245. package/dist/brain/pr-auto-review.d.ts +17 -0
  246. package/dist/brain/pr-auto-review.d.ts.map +1 -0
  247. package/dist/brain/pr-auto-review.js +73 -0
  248. package/dist/brain/pr-auto-review.js.map +1 -0
  249. package/dist/brain/pre-mortem.d.ts +21 -0
  250. package/dist/brain/pre-mortem.d.ts.map +1 -0
  251. package/dist/brain/pre-mortem.js +210 -0
  252. package/dist/brain/pre-mortem.js.map +1 -0
  253. package/dist/brain/prompt-cache.d.ts +54 -0
  254. package/dist/brain/prompt-cache.d.ts.map +1 -0
  255. package/dist/brain/prompt-cache.js +105 -0
  256. package/dist/brain/prompt-cache.js.map +1 -0
  257. package/dist/brain/reputation-ledger.d.ts +42 -0
  258. package/dist/brain/reputation-ledger.d.ts.map +1 -0
  259. package/dist/brain/reputation-ledger.js +326 -0
  260. package/dist/brain/reputation-ledger.js.map +1 -0
  261. package/dist/brain/session-hooks.d.ts +19 -0
  262. package/dist/brain/session-hooks.d.ts.map +1 -1
  263. package/dist/brain/session-hooks.js +249 -18
  264. package/dist/brain/session-hooks.js.map +1 -1
  265. package/dist/brain/subagent-bridge.d.ts +46 -0
  266. package/dist/brain/subagent-bridge.d.ts.map +1 -0
  267. package/dist/brain/subagent-bridge.js +364 -0
  268. package/dist/brain/subagent-bridge.js.map +1 -0
  269. package/dist/brain/swarm-debate.d.ts +22 -0
  270. package/dist/brain/swarm-debate.d.ts.map +1 -0
  271. package/dist/brain/swarm-debate.js +134 -0
  272. package/dist/brain/swarm-debate.js.map +1 -0
  273. package/dist/brain/team-brain-sync.d.ts +22 -0
  274. package/dist/brain/team-brain-sync.d.ts.map +1 -0
  275. package/dist/brain/team-brain-sync.js +132 -0
  276. package/dist/brain/team-brain-sync.js.map +1 -0
  277. package/dist/brain/token-economy.d.ts +25 -0
  278. package/dist/brain/token-economy.d.ts.map +1 -0
  279. package/dist/brain/token-economy.js +216 -0
  280. package/dist/brain/token-economy.js.map +1 -0
  281. package/dist/brain/voice-mode.d.ts +15 -0
  282. package/dist/brain/voice-mode.d.ts.map +1 -0
  283. package/dist/brain/voice-mode.js +97 -0
  284. package/dist/brain/voice-mode.js.map +1 -0
  285. package/dist/cli.js +1702 -4
  286. package/dist/cli.js.map +1 -1
  287. package/dist/dashboard/server.d.ts +6 -0
  288. package/dist/dashboard/server.d.ts.map +1 -1
  289. package/dist/dashboard/server.js +1118 -368
  290. package/dist/dashboard/server.js.map +1 -1
  291. package/dist/dashboard/v6-dashboard-html.d.ts +2 -0
  292. package/dist/dashboard/v6-dashboard-html.d.ts.map +1 -0
  293. package/dist/dashboard/v6-dashboard-html.js +2474 -0
  294. package/dist/dashboard/v6-dashboard-html.js.map +1 -0
  295. package/dist/index.d.ts +27 -0
  296. package/dist/index.d.ts.map +1 -1
  297. package/dist/index.js +29 -1
  298. package/dist/index.js.map +1 -1
  299. package/dist/types.d.ts +518 -2
  300. package/dist/types.d.ts.map +1 -1
  301. package/package.json +33 -4
@@ -0,0 +1,367 @@
1
+ // src/brain/brain-working-memory.ts — Predictive prefetch LRU for brain recall
2
+ // v6.0.2 — Hive Mind Edition
3
+ //
4
+ // The "RAM" of the brain. A small hot cache of "what's about to be needed"
5
+ // keyed by query string. Predicts next likely queries from session context
6
+ // (active file, recent edits, agent type, recent queries) and pre-warms the
7
+ // embeddings index so in-context recall is sub-10ms on hit.
8
+ //
9
+ // Heuristics are deterministic (no LLM):
10
+ // - File-pattern: auth.ts → "auth handling", "session", "login"
11
+ // - Recent-query continuation: pulls related neighbors from the brain
12
+ // - Agent-specific: Cursor leans completion-style; Claude Code diagnostic
13
+ //
14
+ // Persisted to ~/.shadow-brain/working-memory.json so warm survives restarts.
15
+ // LRU evictions are tracked; capacity auto-grows (256 → 1024) when hit rate
16
+ // drops below 0.5.
17
+ //
18
+ // Exposed: BrainWorkingMemory, getBrainWorkingMemory(),
19
+ // resetBrainWorkingMemoryForTests().
20
+ import * as fs from 'fs';
21
+ import * as path from 'path';
22
+ import * as os from 'os';
23
+ import { getEmbeddingsV2 } from './embeddings-v2.js';
24
+ const STORE_DIR = path.join(os.homedir(), '.shadow-brain');
25
+ const STORE_PATH = path.join(STORE_DIR, 'working-memory.json');
26
+ const CONFIG_PATH = path.join(STORE_DIR, 'config.json');
27
+ const DEFAULT_CAPACITY = 256;
28
+ const MAX_CAPACITY = 1024;
29
+ const GROW_THRESHOLD = 0.5;
30
+ const MIN_SAMPLES_BEFORE_GROW = 50;
31
+ const PERSIST_EVERY_N_WRITES = 10;
32
+ const FILE_PATTERN_HINTS = [
33
+ { match: /auth/i, queries: ['auth handling', 'session', 'login', 'token', 'permissions'] },
34
+ { match: /login|signin/i, queries: ['login flow', 'credentials', 'session', 'oauth'] },
35
+ { match: /pay|billing|invoice|stripe/i, queries: ['payment', 'billing', 'invoice', 'refund'] },
36
+ { match: /user|account|profile/i, queries: ['user model', 'profile', 'account settings'] },
37
+ { match: /db|database|schema|migration|prisma|drizzle/i, queries: ['schema', 'migration', 'query', 'index'] },
38
+ { match: /route|router|controller/i, queries: ['routing', 'endpoint', 'handler', 'middleware'] },
39
+ { match: /test|spec/i, queries: ['testing', 'mock', 'fixture', 'coverage'] },
40
+ { match: /config|env|settings/i, queries: ['configuration', 'environment', 'settings'] },
41
+ { match: /cache|redis|memcache/i, queries: ['caching', 'ttl', 'eviction', 'hit rate'] },
42
+ { match: /queue|worker|job/i, queries: ['background job', 'queue', 'worker', 'retry'] },
43
+ { match: /api|client|fetch|axios/i, queries: ['api client', 'request', 'response', 'error handling'] },
44
+ { match: /component|view|page/i, queries: ['component', 'render', 'state', 'props'] },
45
+ { match: /style|css|theme/i, queries: ['styling', 'theme', 'css', 'responsive'] },
46
+ { match: /security|crypt|hash/i, queries: ['security', 'encryption', 'hash', 'token'] },
47
+ { match: /log|monitor|metric|trace/i, queries: ['logging', 'monitoring', 'metrics'] },
48
+ { match: /websocket|socket|realtime|sse/i, queries: ['realtime', 'websocket', 'event stream'] },
49
+ { match: /upload|file|media|image/i, queries: ['file upload', 'storage', 'media handling'] },
50
+ ];
51
+ const AGENT_BIASES = {
52
+ cursor: ['autocomplete context', 'symbol reference', 'usage example', 'inline doc'],
53
+ 'claude-code': ['root cause', 'why does', 'fix for', 'related test', 'recent change'],
54
+ copilot: ['similar function', 'imports', 'type definition'],
55
+ windsurf: ['workspace layout', 'related file', 'pattern reference'],
56
+ cline: ['plan step', 'todo', 'next action'],
57
+ };
58
+ export class BrainWorkingMemory {
59
+ constructor(opts) {
60
+ this.capacity = DEFAULT_CAPACITY;
61
+ this.lru = new Map();
62
+ this.hits = 0;
63
+ this.misses = 0;
64
+ this.prefetchHits = 0;
65
+ this.prefetchedTotal = 0;
66
+ this.evictionsCount = 0;
67
+ this.prefetchedKeys = new Set();
68
+ this.writesSinceFlush = 0;
69
+ this.latestContext = null;
70
+ this.initialized = false;
71
+ this.index = opts?.index ?? getEmbeddingsV2();
72
+ }
73
+ /** Lazy init — loads persisted entries + config. Safe to call repeatedly. */
74
+ init() {
75
+ if (this.initialized)
76
+ return;
77
+ try {
78
+ fs.mkdirSync(STORE_DIR, { recursive: true });
79
+ }
80
+ catch { /* non-fatal */ }
81
+ this.loadConfig();
82
+ this.loadStore();
83
+ this.initialized = true;
84
+ }
85
+ /** Feed the latest session context. Used for predictions on next get/prefetch. */
86
+ observe(context) {
87
+ this.init();
88
+ this.latestContext = { ...context };
89
+ }
90
+ /** Sub-10ms fast path. Returns null if not cached. */
91
+ async get(query) {
92
+ this.init();
93
+ const key = this.keyOf(query, this.latestContext?.project);
94
+ const entry = this.lru.get(key);
95
+ if (!entry) {
96
+ this.misses++;
97
+ return null;
98
+ }
99
+ // LRU touch — re-insert at end.
100
+ this.lru.delete(key);
101
+ this.lru.set(key, entry);
102
+ this.hits++;
103
+ if (this.prefetchedKeys.has(key)) {
104
+ this.prefetchHits++;
105
+ this.prefetchedKeys.delete(key);
106
+ }
107
+ this.maybeGrow();
108
+ return entry;
109
+ }
110
+ /** Predict next likely queries from the latest context. Deterministic, no LLM. */
111
+ async predictNext(opts) {
112
+ this.init();
113
+ const topK = Math.max(1, Math.min(64, opts?.topK ?? 8));
114
+ const ctx = this.latestContext;
115
+ if (!ctx)
116
+ return [];
117
+ const scored = new Map();
118
+ const bump = (q, w) => {
119
+ const norm = q.trim().toLowerCase();
120
+ if (!norm)
121
+ return;
122
+ scored.set(norm, (scored.get(norm) ?? 0) + w);
123
+ };
124
+ // File-pattern hints (active file weighs more than recent).
125
+ if (ctx.activeFile) {
126
+ for (const q of hintsForPath(ctx.activeFile))
127
+ bump(q, 3);
128
+ }
129
+ for (const rf of (ctx.recentFiles ?? []).slice(0, 5)) {
130
+ for (const q of hintsForPath(rf))
131
+ bump(q, 1.5);
132
+ }
133
+ for (const e of (ctx.recentEdits ?? []).slice(0, 5)) {
134
+ for (const q of hintsForPath(e.file))
135
+ bump(q, 2);
136
+ }
137
+ // Agent bias.
138
+ const agentKey = (ctx.activeAgent ?? '').toLowerCase();
139
+ const biases = AGENT_BIASES[agentKey] ?? AGENT_BIASES[agentKey.replace(/[^a-z]/g, '')] ?? [];
140
+ for (const b of biases)
141
+ bump(b, 1);
142
+ // Recent-query continuation — pull neighbor candidates from the brain index.
143
+ const recentQ = (ctx.recentQueries ?? []).slice(-3);
144
+ for (const rq of recentQ) {
145
+ bump(rq, 0.5); // baseline weight for the query itself
146
+ try {
147
+ const hits = await this.index.search(rq, 4);
148
+ for (const h of hits) {
149
+ // Use the first sentence of the brain text as a "follow-up" candidate query.
150
+ const seed = firstSentence(h.text);
151
+ if (seed)
152
+ bump(seed, 0.6);
153
+ }
154
+ }
155
+ catch { /* ignore index errors */ }
156
+ }
157
+ return Array.from(scored.entries())
158
+ .sort((a, b) => b[1] - a[1])
159
+ .slice(0, topK)
160
+ .map(([q]) => q);
161
+ }
162
+ /** Fire-and-forget warm. Queries are embedded + searched, results cached. */
163
+ async prefetch(queries, project) {
164
+ this.init();
165
+ const t0 = Date.now();
166
+ let prefetched = 0;
167
+ const unique = Array.from(new Set(queries.map(q => q.trim()).filter(Boolean)));
168
+ for (const q of unique) {
169
+ const key = this.keyOf(q, project);
170
+ if (this.lru.has(key))
171
+ continue;
172
+ try {
173
+ const hits = await this.index.search(q, 10);
174
+ const value = {
175
+ query: q,
176
+ project,
177
+ hits: hits.map(h => ({ id: h.id, score: h.score, text: h.text })),
178
+ storedAt: Date.now(),
179
+ source: 'prefetch',
180
+ };
181
+ this.putEntry(key, value);
182
+ this.prefetchedKeys.add(key);
183
+ prefetched++;
184
+ this.prefetchedTotal++;
185
+ }
186
+ catch { /* skip on error */ }
187
+ }
188
+ return { prefetched, durationMs: Date.now() - t0 };
189
+ }
190
+ stats() {
191
+ this.init();
192
+ const total = this.hits + this.misses;
193
+ const hitRate = total > 0 ? +(this.hits / total).toFixed(4) : 0;
194
+ const prefetchHitRate = this.prefetchedTotal > 0
195
+ ? +(this.prefetchHits / this.prefetchedTotal).toFixed(4)
196
+ : 0;
197
+ return {
198
+ capacity: this.capacity,
199
+ used: this.lru.size,
200
+ hitRate,
201
+ evictionsCount: this.evictionsCount,
202
+ prefetchHitRate,
203
+ };
204
+ }
205
+ /** Persist current contents to disk. */
206
+ async flush() {
207
+ this.init();
208
+ await this.persist();
209
+ }
210
+ /** Wipe contents + metrics. Persistence is cleared. */
211
+ reset() {
212
+ this.lru.clear();
213
+ this.prefetchedKeys.clear();
214
+ this.hits = 0;
215
+ this.misses = 0;
216
+ this.prefetchHits = 0;
217
+ this.prefetchedTotal = 0;
218
+ this.evictionsCount = 0;
219
+ this.writesSinceFlush = 0;
220
+ try {
221
+ if (fs.existsSync(STORE_PATH))
222
+ fs.unlinkSync(STORE_PATH);
223
+ }
224
+ catch { /* non-fatal */ }
225
+ }
226
+ // ── Internals ─────────────────────────────────────────────────────────
227
+ putEntry(key, value) {
228
+ if (this.lru.has(key))
229
+ this.lru.delete(key);
230
+ this.lru.set(key, value);
231
+ while (this.lru.size > this.capacity) {
232
+ const oldest = this.lru.keys().next().value;
233
+ if (oldest === undefined)
234
+ break;
235
+ this.lru.delete(oldest);
236
+ this.prefetchedKeys.delete(oldest);
237
+ this.evictionsCount++;
238
+ }
239
+ this.writesSinceFlush++;
240
+ if (this.writesSinceFlush >= PERSIST_EVERY_N_WRITES) {
241
+ this.writesSinceFlush = 0;
242
+ this.persist().catch(() => { });
243
+ }
244
+ }
245
+ maybeGrow() {
246
+ const total = this.hits + this.misses;
247
+ if (total < MIN_SAMPLES_BEFORE_GROW)
248
+ return;
249
+ if (this.capacity >= MAX_CAPACITY)
250
+ return;
251
+ const hitRate = this.hits / total;
252
+ if (hitRate < GROW_THRESHOLD) {
253
+ this.capacity = Math.min(MAX_CAPACITY, Math.max(this.capacity * 2, this.capacity + 64));
254
+ this.persistConfig().catch(() => { });
255
+ }
256
+ }
257
+ keyOf(query, project) {
258
+ const p = (project ?? '').trim().toLowerCase();
259
+ const q = query.trim().toLowerCase();
260
+ return p + '' + q;
261
+ }
262
+ loadConfig() {
263
+ try {
264
+ if (!fs.existsSync(CONFIG_PATH))
265
+ return;
266
+ const raw = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
267
+ const cap = raw.workingMemory?.capacity;
268
+ if (typeof cap === 'number' && cap > 0 && cap <= MAX_CAPACITY)
269
+ this.capacity = Math.floor(cap);
270
+ }
271
+ catch { /* fall back to defaults */ }
272
+ }
273
+ async persistConfig() {
274
+ try {
275
+ let existing = {};
276
+ if (fs.existsSync(CONFIG_PATH)) {
277
+ try {
278
+ existing = JSON.parse(fs.readFileSync(CONFIG_PATH, 'utf-8'));
279
+ }
280
+ catch {
281
+ existing = {};
282
+ }
283
+ }
284
+ existing.workingMemory = { capacity: this.capacity };
285
+ const tmp = CONFIG_PATH + '.tmp';
286
+ fs.writeFileSync(tmp, JSON.stringify(existing, null, 2));
287
+ fs.renameSync(tmp, CONFIG_PATH);
288
+ }
289
+ catch { /* non-fatal */ }
290
+ }
291
+ loadStore() {
292
+ try {
293
+ if (!fs.existsSync(STORE_PATH))
294
+ return;
295
+ const raw = fs.readFileSync(STORE_PATH, 'utf-8');
296
+ const parsed = JSON.parse(raw);
297
+ if (parsed.schemaVersion !== 1)
298
+ return;
299
+ this.capacity = Math.min(MAX_CAPACITY, Math.max(parsed.capacity || DEFAULT_CAPACITY, 1));
300
+ this.hits = parsed.metrics?.hits ?? 0;
301
+ this.misses = parsed.metrics?.misses ?? 0;
302
+ this.prefetchHits = parsed.metrics?.prefetchHits ?? 0;
303
+ this.prefetchedTotal = parsed.metrics?.prefetchedTotal ?? 0;
304
+ this.evictionsCount = parsed.metrics?.evictionsCount ?? 0;
305
+ for (const { key, value } of parsed.entries ?? []) {
306
+ this.lru.set(key, value);
307
+ if (this.lru.size > this.capacity) {
308
+ const oldest = this.lru.keys().next().value;
309
+ if (oldest !== undefined)
310
+ this.lru.delete(oldest);
311
+ }
312
+ }
313
+ }
314
+ catch { /* skip corrupt store */ }
315
+ }
316
+ async persist() {
317
+ try {
318
+ const payload = {
319
+ schemaVersion: 1,
320
+ capacity: this.capacity,
321
+ entries: Array.from(this.lru.entries()).map(([key, value]) => ({ key, value })),
322
+ metrics: {
323
+ hits: this.hits,
324
+ misses: this.misses,
325
+ prefetchHits: this.prefetchHits,
326
+ prefetchedTotal: this.prefetchedTotal,
327
+ evictionsCount: this.evictionsCount,
328
+ },
329
+ };
330
+ const tmp = STORE_PATH + '.tmp';
331
+ fs.writeFileSync(tmp, JSON.stringify(payload));
332
+ fs.renameSync(tmp, STORE_PATH);
333
+ }
334
+ catch { /* non-fatal */ }
335
+ }
336
+ }
337
+ function hintsForPath(filePath) {
338
+ const base = filePath.split(/[\\/]/).pop() ?? filePath;
339
+ const out = [];
340
+ for (const rule of FILE_PATTERN_HINTS) {
341
+ if (rule.match.test(base) || rule.match.test(filePath)) {
342
+ for (const q of rule.queries)
343
+ out.push(q);
344
+ }
345
+ }
346
+ // Also seed a query from the bare module name (auth.ts → "auth").
347
+ const stem = base.replace(/\.[^.]+$/, '').replace(/[-_]/g, ' ').trim();
348
+ if (stem && stem.length <= 40)
349
+ out.push(stem);
350
+ return out;
351
+ }
352
+ function firstSentence(text) {
353
+ if (!text)
354
+ return '';
355
+ const t = text.replace(/\s+/g, ' ').trim();
356
+ const cut = t.search(/[.!?]\s/);
357
+ const seed = cut > 0 ? t.slice(0, cut) : t.slice(0, 80);
358
+ return seed.length > 4 ? seed : '';
359
+ }
360
+ let _instance = null;
361
+ export function getBrainWorkingMemory() {
362
+ if (!_instance)
363
+ _instance = new BrainWorkingMemory();
364
+ return _instance;
365
+ }
366
+ export function resetBrainWorkingMemoryForTests() { _instance = null; }
367
+ //# sourceMappingURL=brain-working-memory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"brain-working-memory.js","sourceRoot":"","sources":["../../src/brain/brain-working-memory.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,23 @@
1
+ import { BranchBrainState, BranchMemoryTag } from '../types.js';
2
+ export declare class BranchBrain {
3
+ private brain;
4
+ private tags;
5
+ private lastBranchByProject;
6
+ private initialized;
7
+ constructor();
8
+ init(): Promise<void>;
9
+ /** Current branch from git for the given project dir. */
10
+ currentBranch(projectDir: string): Promise<string>;
11
+ /** Tag a memory as either global or branch-scoped. */
12
+ tag(memoryId: string, branch: string, scope?: 'branch' | 'global'): Promise<BranchMemoryTag>;
13
+ /** Return the set of memory IDs active for a branch (branch-scoped + global). */
14
+ activeMemoryIds(branch: string): string[];
15
+ /** Compute + return the current branch brain state. */
16
+ getState(projectDir: string): Promise<BranchBrainState>;
17
+ /** Promote a branch-scoped memory to global (e.g., after merging). */
18
+ promoteToGlobal(memoryId: string): Promise<boolean>;
19
+ private persist;
20
+ }
21
+ export declare function getBranchBrain(): BranchBrain;
22
+ export declare function resetBranchBrainForTests(): void;
23
+ //# sourceMappingURL=branch-brain.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch-brain.d.ts","sourceRoot":"","sources":["../../src/brain/branch-brain.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,gBAAgB,EAChB,eAAe,EAChB,MAAM,aAAa,CAAC;AAWrB,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,IAAI,CAA6C;IACzD,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,WAAW,CAAS;;IAMtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB3B,yDAAyD;IACnD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxD,sDAAsD;IAChD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,QAAQ,GAAG,QAAmB,GAAG,OAAO,CAAC,eAAe,CAAC;IAe5G,iFAAiF;IACjF,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE;IAazC,uDAAuD;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAyC7D,sEAAsE;IAChE,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;YAW3C,OAAO;CAgBtB;AAID,wBAAgB,cAAc,IAAI,WAAW,CAG5C;AAED,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C"}
@@ -0,0 +1,159 @@
1
+ // src/brain/branch-brain.ts — Branch Brains (git-aware memory context)
2
+ // v6.0.0 — Hive Mind Edition
3
+ //
4
+ // When you switch git branches, the brain's active memory set switches too.
5
+ // Memories are tagged `branch:<name>` or `global` when created. Git-aware
6
+ // filtering keeps the mental model aligned with the branch you're on.
7
+ import * as fs from 'fs';
8
+ import * as path from 'path';
9
+ import * as os from 'os';
10
+ import { getGlobalBrain, GlobalBrain } from './global-brain.js';
11
+ const TAGS_PATH = path.join(os.homedir(), '.shadow-brain', 'branch-tags.json');
12
+ export class BranchBrain {
13
+ constructor() {
14
+ this.tags = new Map(); // memoryId → tags
15
+ this.lastBranchByProject = new Map();
16
+ this.initialized = false;
17
+ this.brain = getGlobalBrain();
18
+ }
19
+ async init() {
20
+ if (this.initialized)
21
+ return;
22
+ fs.mkdirSync(path.dirname(TAGS_PATH), { recursive: true });
23
+ await this.brain.init();
24
+ if (fs.existsSync(TAGS_PATH)) {
25
+ try {
26
+ const parsed = JSON.parse(fs.readFileSync(TAGS_PATH, 'utf-8'));
27
+ for (const t of parsed.tags ?? []) {
28
+ const rehy = { ...t, taggedAt: new Date(t.taggedAt) };
29
+ const existing = this.tags.get(rehy.memoryId) ?? [];
30
+ existing.push(rehy);
31
+ this.tags.set(rehy.memoryId, existing);
32
+ }
33
+ for (const [proj, br] of Object.entries(parsed.lastBranchByProject ?? {})) {
34
+ this.lastBranchByProject.set(proj, br);
35
+ }
36
+ }
37
+ catch {
38
+ /* skip */
39
+ }
40
+ }
41
+ this.initialized = true;
42
+ }
43
+ /** Current branch from git for the given project dir. */
44
+ async currentBranch(projectDir) {
45
+ try {
46
+ const { execa } = await import('execa');
47
+ const { stdout } = await execa('git', ['branch', '--show-current'], { cwd: projectDir, reject: false });
48
+ return stdout.trim() || 'HEAD';
49
+ }
50
+ catch {
51
+ return 'HEAD';
52
+ }
53
+ }
54
+ /** Tag a memory as either global or branch-scoped. */
55
+ async tag(memoryId, branch, scope = 'branch') {
56
+ await this.init();
57
+ const tag = {
58
+ memoryId,
59
+ branch,
60
+ scope,
61
+ taggedAt: new Date(),
62
+ };
63
+ const existing = this.tags.get(memoryId) ?? [];
64
+ existing.push(tag);
65
+ this.tags.set(memoryId, existing);
66
+ await this.persist();
67
+ return tag;
68
+ }
69
+ /** Return the set of memory IDs active for a branch (branch-scoped + global). */
70
+ activeMemoryIds(branch) {
71
+ const ids = new Set();
72
+ for (const [memoryId, tagList] of this.tags) {
73
+ for (const t of tagList) {
74
+ if (t.scope === 'global' || t.branch === branch) {
75
+ ids.add(memoryId);
76
+ break;
77
+ }
78
+ }
79
+ }
80
+ return Array.from(ids);
81
+ }
82
+ /** Compute + return the current branch brain state. */
83
+ async getState(projectDir) {
84
+ await this.init();
85
+ const branch = await this.currentBranch(projectDir);
86
+ const projectId = GlobalBrain.projectIdFor(projectDir);
87
+ const last = this.lastBranchByProject.get(projectId);
88
+ let branchCount = 0;
89
+ let globalCount = 0;
90
+ const branchCategories = new Set();
91
+ const activeIds = this.activeMemoryIds(branch);
92
+ const branchActiveOnly = new Set();
93
+ for (const [memoryId, tagList] of this.tags) {
94
+ const hasGlobal = tagList.some(t => t.scope === 'global');
95
+ const hasThisBranch = tagList.some(t => t.scope === 'branch' && t.branch === branch);
96
+ if (hasGlobal)
97
+ globalCount++;
98
+ if (hasThisBranch) {
99
+ branchCount++;
100
+ branchActiveOnly.add(memoryId);
101
+ }
102
+ }
103
+ // Enrich branch categories from the brain
104
+ const branchEntries = this.brain.recallByIds(Array.from(branchActiveOnly));
105
+ for (const e of branchEntries)
106
+ branchCategories.add(e.category);
107
+ if (last !== branch) {
108
+ this.lastBranchByProject.set(projectId, branch);
109
+ await this.persist();
110
+ }
111
+ return {
112
+ currentBranch: branch,
113
+ activeMemoryIds: activeIds,
114
+ branchMemoryCount: branchCount,
115
+ globalMemoryCount: globalCount,
116
+ lastSwitchAt: new Date(),
117
+ branchSpecificCategories: Array.from(branchCategories),
118
+ };
119
+ }
120
+ /** Promote a branch-scoped memory to global (e.g., after merging). */
121
+ async promoteToGlobal(memoryId) {
122
+ await this.init();
123
+ const list = this.tags.get(memoryId);
124
+ if (!list)
125
+ return false;
126
+ list.push({ memoryId, branch: '*', scope: 'global', taggedAt: new Date() });
127
+ await this.persist();
128
+ return true;
129
+ }
130
+ // ── Internals ─────────────────────────────────────────────────────────────
131
+ async persist() {
132
+ try {
133
+ const flat = [];
134
+ for (const list of this.tags.values())
135
+ flat.push(...list);
136
+ const payload = {
137
+ schemaVersion: 1,
138
+ tags: flat,
139
+ lastBranchByProject: Object.fromEntries(this.lastBranchByProject.entries()),
140
+ };
141
+ const tmp = TAGS_PATH + '.tmp';
142
+ fs.writeFileSync(tmp, JSON.stringify(payload, null, 2));
143
+ fs.renameSync(tmp, TAGS_PATH);
144
+ }
145
+ catch {
146
+ /* non-fatal */
147
+ }
148
+ }
149
+ }
150
+ let _instance = null;
151
+ export function getBranchBrain() {
152
+ if (!_instance)
153
+ _instance = new BranchBrain();
154
+ return _instance;
155
+ }
156
+ export function resetBranchBrainForTests() {
157
+ _instance = null;
158
+ }
159
+ //# sourceMappingURL=branch-brain.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"branch-brain.js","sourceRoot":"","sources":["../../src/brain/branch-brain.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import { AgentTool, CalibrationRecord, CalibrationScore } from '../types.js';
2
+ export declare class CalibrationMonitor {
3
+ private records;
4
+ private scores;
5
+ private initialized;
6
+ init(): Promise<void>;
7
+ record(rec: Omit<CalibrationRecord, 'recordedAt'> & {
8
+ recordedAt?: Date;
9
+ }): Promise<CalibrationScore>;
10
+ getScore(agentTool: AgentTool, category: string): CalibrationScore | null;
11
+ listScores(limit?: number): CalibrationScore[];
12
+ /** Multiplicative trust weight for a given agent+category (1.0 = as claimed). */
13
+ trustWeight(agentTool: AgentTool, category: string): number;
14
+ private recomputeScore;
15
+ private keyFor;
16
+ private persist;
17
+ }
18
+ export declare function getCalibrationMonitor(): CalibrationMonitor;
19
+ export declare function resetCalibrationMonitorForTests(): void;
20
+ //# sourceMappingURL=calibration-monitor.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"calibration-monitor.d.ts","sourceRoot":"","sources":["../../src/brain/calibration-monitor.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,SAAS,EACT,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAUrB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,WAAW,CAAS;IAEtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqBrB,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAa3G,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIzE,UAAU,CAAC,KAAK,SAAK,GAAG,gBAAgB,EAAE;IAM1C,iFAAiF;IACjF,WAAW,CAAC,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQ3D,OAAO,CAAC,cAAc;IAiDtB,OAAO,CAAC,MAAM;YAIA,OAAO;CActB;AAID,wBAAgB,qBAAqB,IAAI,kBAAkB,CAG1D;AAED,wBAAgB,+BAA+B,IAAI,IAAI,CAEtD"}