pi-braid 0.0.0-stage → 0.40.1

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 (1011) hide show
  1. package/AGENTS.md +195 -0
  2. package/CONTRIBUTING.md +302 -0
  3. package/LICENSE +21 -0
  4. package/README.md +266 -2
  5. package/TOOLS.md +147 -0
  6. package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
  7. package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
  8. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
  9. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
  10. package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
  11. package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
  12. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
  13. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
  14. package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
  15. package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
  16. package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
  17. package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
  18. package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
  19. package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
  20. package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
  21. package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
  22. package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
  23. package/dist/extensions/cognitive/metacognition/index.js +90 -0
  24. package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
  25. package/dist/extensions/cognitive/reasoning/index.js +99 -0
  26. package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
  27. package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
  28. package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
  29. package/dist/extensions/cognitive/topic-drift/index.js +346 -0
  30. package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
  31. package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
  32. package/dist/extensions/context-management/index.d.ts +77 -0
  33. package/dist/extensions/context-management/index.js +339 -0
  34. package/dist/extensions/core/agent-environment/index.d.ts +30 -0
  35. package/dist/extensions/core/agent-environment/index.js +89 -0
  36. package/dist/extensions/core/polyfill/index.d.ts +28 -0
  37. package/dist/extensions/core/polyfill/index.js +474 -0
  38. package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
  39. package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
  40. package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
  41. package/dist/extensions/core/prompt-builder/context-section.js +101 -0
  42. package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
  43. package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
  44. package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
  45. package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
  46. package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
  47. package/dist/extensions/core/prompt-builder/identity.js +77 -0
  48. package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
  49. package/dist/extensions/core/prompt-builder/index.js +496 -0
  50. package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
  51. package/dist/extensions/core/prompt-builder/inspect.js +182 -0
  52. package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
  53. package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
  54. package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
  55. package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
  56. package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
  57. package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
  58. package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
  59. package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
  60. package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
  61. package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
  62. package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
  63. package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
  64. package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
  65. package/dist/extensions/core/prompt-builder/section.js +127 -0
  66. package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
  67. package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
  68. package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
  69. package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
  70. package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
  71. package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
  72. package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
  73. package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
  74. package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
  75. package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
  76. package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
  77. package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
  78. package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
  79. package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
  80. package/dist/extensions/core/skills-tool/index.d.ts +56 -0
  81. package/dist/extensions/core/skills-tool/index.js +200 -0
  82. package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
  83. package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
  84. package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
  85. package/dist/extensions/core/skills-tool/session-records.js +268 -0
  86. package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
  87. package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
  88. package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
  89. package/dist/extensions/enforcement/detection/malformed.js +30 -0
  90. package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
  91. package/dist/extensions/enforcement/detection/verification.js +34 -0
  92. package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
  93. package/dist/extensions/enforcement/enforcement-types.js +24 -0
  94. package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
  95. package/dist/extensions/enforcement/handler-registry.js +196 -0
  96. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
  97. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
  98. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
  99. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
  100. package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
  101. package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
  102. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
  103. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
  104. package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
  105. package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
  106. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
  107. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
  108. package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
  109. package/dist/extensions/enforcement/handlers/blocking.js +33 -0
  110. package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
  111. package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
  112. package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
  113. package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
  114. package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
  115. package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
  116. package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
  117. package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
  118. package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
  119. package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
  120. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
  121. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
  122. package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
  123. package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
  124. package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
  125. package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
  126. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
  127. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
  128. package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
  129. package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
  130. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
  131. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
  132. package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
  133. package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
  134. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
  135. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
  136. package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
  137. package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
  138. package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
  139. package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
  140. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
  141. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
  142. package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
  143. package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
  144. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
  145. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
  146. package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
  147. package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
  148. package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
  149. package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
  150. package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
  151. package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
  152. package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
  153. package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
  154. package/dist/extensions/enforcement/index.d.ts +15 -0
  155. package/dist/extensions/enforcement/index.js +22 -0
  156. package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
  157. package/dist/extensions/enforcement/judge-utils.js +83 -0
  158. package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
  159. package/dist/extensions/enforcement/nudge-manager.js +203 -0
  160. package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
  161. package/dist/extensions/enforcement/self-state-claims.js +167 -0
  162. package/dist/extensions/enforcement/session-health.d.ts +107 -0
  163. package/dist/extensions/enforcement/session-health.js +251 -0
  164. package/dist/extensions/enforcement/signals.d.ts +54 -0
  165. package/dist/extensions/enforcement/signals.js +47 -0
  166. package/dist/extensions/enforcement/similarity.d.ts +16 -0
  167. package/dist/extensions/enforcement/similarity.js +64 -0
  168. package/dist/extensions/enforcement/state.d.ts +40 -0
  169. package/dist/extensions/enforcement/state.js +74 -0
  170. package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
  171. package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
  172. package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
  173. package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
  174. package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
  175. package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
  176. package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
  177. package/dist/extensions/enforcement/substate/session-state.js +45 -0
  178. package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
  179. package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
  180. package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
  181. package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
  182. package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
  183. package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
  184. package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
  185. package/dist/extensions/enforcement/task-evidence.js +335 -0
  186. package/dist/extensions/enforcement/types.d.ts +35 -0
  187. package/dist/extensions/enforcement/types.js +5 -0
  188. package/dist/extensions/enforcement/validation.d.ts +12 -0
  189. package/dist/extensions/enforcement/validation.js +151 -0
  190. package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
  191. package/dist/extensions/enforcement/verification-judge.js +214 -0
  192. package/dist/extensions/enforcement/whisper.d.ts +46 -0
  193. package/dist/extensions/enforcement/whisper.js +104 -0
  194. package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
  195. package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
  196. package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
  197. package/dist/extensions/heartbeat/analytics/core.js +201 -0
  198. package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
  199. package/dist/extensions/heartbeat/analytics/format.js +111 -0
  200. package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
  201. package/dist/extensions/heartbeat/analytics/index.js +352 -0
  202. package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
  203. package/dist/extensions/heartbeat/analytics/shared.js +69 -0
  204. package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
  205. package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
  206. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
  207. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
  208. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
  209. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
  210. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
  211. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
  212. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
  213. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
  214. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
  215. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
  216. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
  217. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
  218. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
  219. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
  220. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
  221. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
  222. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
  223. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
  224. package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
  225. package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
  226. package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
  227. package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
  228. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
  229. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
  230. package/dist/extensions/manifest.d.ts +32 -0
  231. package/dist/extensions/manifest.js +251 -0
  232. package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
  233. package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
  234. package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
  235. package/dist/extensions/memory/context-lifecycle/index.js +977 -0
  236. package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
  237. package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
  238. package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
  239. package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
  240. package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
  241. package/dist/extensions/memory/context-lifecycle/state.js +90 -0
  242. package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
  243. package/dist/extensions/memory/context-lifecycle/types.js +273 -0
  244. package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
  245. package/dist/extensions/memory/context-manager/analysis.js +264 -0
  246. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
  247. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
  248. package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
  249. package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
  250. package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
  251. package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
  252. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
  253. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
  254. package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
  255. package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
  256. package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
  257. package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
  258. package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
  259. package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
  260. package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
  261. package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
  262. package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
  263. package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
  264. package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
  265. package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
  266. package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
  267. package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
  268. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
  269. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
  270. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
  271. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
  272. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
  273. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
  274. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
  275. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
  276. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
  277. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
  278. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
  279. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
  280. package/dist/extensions/memory/context-manager/index.d.ts +3 -0
  281. package/dist/extensions/memory/context-manager/index.js +88 -0
  282. package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
  283. package/dist/extensions/memory/context-manager/pruning.js +406 -0
  284. package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
  285. package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
  286. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
  287. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
  288. package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
  289. package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
  290. package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
  291. package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
  292. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
  293. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
  294. package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
  295. package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
  296. package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
  297. package/dist/extensions/memory/scratchpad/format.js +135 -0
  298. package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
  299. package/dist/extensions/memory/scratchpad/handlers.js +469 -0
  300. package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
  301. package/dist/extensions/memory/scratchpad/index.js +168 -0
  302. package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
  303. package/dist/extensions/memory/scratchpad/persistence.js +343 -0
  304. package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
  305. package/dist/extensions/memory/scratchpad/types.js +8 -0
  306. package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
  307. package/dist/extensions/memory/scratchpad/utils.js +236 -0
  308. package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
  309. package/dist/extensions/memory/session-recall/analyze.js +478 -0
  310. package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
  311. package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
  312. package/dist/extensions/memory/session-recall/index.d.ts +29 -0
  313. package/dist/extensions/memory/session-recall/index.js +820 -0
  314. package/dist/extensions/memory/session-recall/query.d.ts +15 -0
  315. package/dist/extensions/memory/session-recall/query.js +38 -0
  316. package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
  317. package/dist/extensions/memory/session-recall/rank.js +85 -0
  318. package/dist/extensions/memory/session-recall/search.d.ts +159 -0
  319. package/dist/extensions/memory/session-recall/search.js +682 -0
  320. package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
  321. package/dist/extensions/memory/session-recall/stats.js +67 -0
  322. package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
  323. package/dist/extensions/memory/session-recall/text-utils.js +184 -0
  324. package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
  325. package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
  326. package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
  327. package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
  328. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
  329. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
  330. package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
  331. package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
  332. package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
  333. package/dist/extensions/memory/three-memory-stores/index.js +436 -0
  334. package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
  335. package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
  336. package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
  337. package/dist/extensions/memory/three-memory-stores/types.js +2 -0
  338. package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
  339. package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
  340. package/dist/extensions/orchestrator/index.d.ts +19 -0
  341. package/dist/extensions/orchestrator/index.js +796 -0
  342. package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
  343. package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
  344. package/dist/extensions/scheduling/timer/index.d.ts +102 -0
  345. package/dist/extensions/scheduling/timer/index.js +1143 -0
  346. package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
  347. package/dist/extensions/scheduling/timer/poller.js +135 -0
  348. package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
  349. package/dist/extensions/scheduling/timer/recovery.js +445 -0
  350. package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
  351. package/dist/extensions/scheduling/timer/store-file.js +59 -0
  352. package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
  353. package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
  354. package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
  355. package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
  356. package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
  357. package/dist/extensions/self/auto-recovery/index.js +89 -0
  358. package/dist/extensions/self/error-tracking/index.d.ts +3 -0
  359. package/dist/extensions/self/error-tracking/index.js +244 -0
  360. package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
  361. package/dist/extensions/self/health-maintenance/format.js +60 -0
  362. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
  363. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
  364. package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
  365. package/dist/extensions/self/health-maintenance/helpers.js +67 -0
  366. package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
  367. package/dist/extensions/self/health-maintenance/index.js +238 -0
  368. package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
  369. package/dist/extensions/self/health-maintenance/types.js +2 -0
  370. package/dist/extensions/self/latent-activator/index.d.ts +12 -0
  371. package/dist/extensions/self/latent-activator/index.js +173 -0
  372. package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
  373. package/dist/extensions/self/latent-activator/mixes.js +20 -0
  374. package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
  375. package/dist/extensions/self/latent-activator/signals.js +228 -0
  376. package/dist/extensions/self/latent-activator/state.d.ts +43 -0
  377. package/dist/extensions/self/latent-activator/state.js +59 -0
  378. package/dist/extensions/self/latent-activator/types.d.ts +8 -0
  379. package/dist/extensions/self/latent-activator/types.js +8 -0
  380. package/dist/extensions/self/watchdog/config.d.ts +4 -0
  381. package/dist/extensions/self/watchdog/config.js +79 -0
  382. package/dist/extensions/self/watchdog/engine.d.ts +256 -0
  383. package/dist/extensions/self/watchdog/engine.js +935 -0
  384. package/dist/extensions/self/watchdog/index.d.ts +23 -0
  385. package/dist/extensions/self/watchdog/index.js +485 -0
  386. package/dist/index.d.ts +25 -0
  387. package/dist/index.js +81 -0
  388. package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
  389. package/dist/lib/ai/consolidated-claim-critic.js +191 -0
  390. package/dist/lib/ai/cost-report.d.ts +83 -0
  391. package/dist/lib/ai/cost-report.js +116 -0
  392. package/dist/lib/ai/critic-cache.d.ts +57 -0
  393. package/dist/lib/ai/critic-cache.js +100 -0
  394. package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
  395. package/dist/lib/ai/critic-fallbacks.js +75 -0
  396. package/dist/lib/ai/critic-gate.d.ts +75 -0
  397. package/dist/lib/ai/critic-gate.js +81 -0
  398. package/dist/lib/ai/critic-helpers.d.ts +26 -0
  399. package/dist/lib/ai/critic-helpers.js +131 -0
  400. package/dist/lib/ai/critic-registry.d.ts +417 -0
  401. package/dist/lib/ai/critic-registry.js +639 -0
  402. package/dist/lib/ai/critic-stats.d.ts +78 -0
  403. package/dist/lib/ai/critic-stats.js +90 -0
  404. package/dist/lib/ai/judge-budget.d.ts +138 -0
  405. package/dist/lib/ai/judge-budget.js +143 -0
  406. package/dist/lib/ai/language-hint.d.ts +21 -0
  407. package/dist/lib/ai/language-hint.js +58 -0
  408. package/dist/lib/ai/llm-call.d.ts +141 -0
  409. package/dist/lib/ai/llm-call.js +745 -0
  410. package/dist/lib/ai/model-resolver.d.ts +90 -0
  411. package/dist/lib/ai/model-resolver.js +185 -0
  412. package/dist/lib/ai/models-init.d.ts +46 -0
  413. package/dist/lib/ai/models-init.js +65 -0
  414. package/dist/lib/ai/payload-hygiene.d.ts +74 -0
  415. package/dist/lib/ai/payload-hygiene.js +240 -0
  416. package/dist/lib/ai/post-loop-classify.d.ts +128 -0
  417. package/dist/lib/ai/post-loop-classify.js +87 -0
  418. package/dist/lib/ai/text-classifier.d.ts +142 -0
  419. package/dist/lib/ai/text-classifier.js +548 -0
  420. package/dist/lib/cognitive/hints.d.ts +33 -0
  421. package/dist/lib/cognitive/hints.js +223 -0
  422. package/dist/lib/cognitive/openspec.d.ts +29 -0
  423. package/dist/lib/cognitive/openspec.js +108 -0
  424. package/dist/lib/config/braid-paths.d.ts +188 -0
  425. package/dist/lib/config/braid-paths.js +340 -0
  426. package/dist/lib/config/braid-settings.d.ts +489 -0
  427. package/dist/lib/config/braid-settings.js +938 -0
  428. package/dist/lib/config/per-tool-settings.d.ts +95 -0
  429. package/dist/lib/config/per-tool-settings.js +161 -0
  430. package/dist/lib/config/session-profiles.d.ts +68 -0
  431. package/dist/lib/config/session-profiles.js +143 -0
  432. package/dist/lib/constants/injection-details.d.ts +30 -0
  433. package/dist/lib/constants/injection-details.js +30 -0
  434. package/dist/lib/constants/session-thresholds.d.ts +42 -0
  435. package/dist/lib/constants/session-thresholds.js +54 -0
  436. package/dist/lib/constants/tool-constants.d.ts +11 -0
  437. package/dist/lib/constants/tool-constants.js +12 -0
  438. package/dist/lib/core/event-names.d.ts +23 -0
  439. package/dist/lib/core/event-names.js +26 -0
  440. package/dist/lib/core/logger.d.ts +102 -0
  441. package/dist/lib/core/logger.js +274 -0
  442. package/dist/lib/detection/compression-strategy.d.ts +38 -0
  443. package/dist/lib/detection/compression-strategy.js +147 -0
  444. package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
  445. package/dist/lib/detection/consolidated-topic-critic.js +132 -0
  446. package/dist/lib/detection/context-density.d.ts +70 -0
  447. package/dist/lib/detection/context-density.js +193 -0
  448. package/dist/lib/detection/context-thresholds.d.ts +88 -0
  449. package/dist/lib/detection/context-thresholds.js +107 -0
  450. package/dist/lib/detection/context-tiers.d.ts +80 -0
  451. package/dist/lib/detection/context-tiers.js +144 -0
  452. package/dist/lib/detection/context-usage.d.ts +75 -0
  453. package/dist/lib/detection/context-usage.js +209 -0
  454. package/dist/lib/detection/degradation-detector.d.ts +74 -0
  455. package/dist/lib/detection/degradation-detector.js +454 -0
  456. package/dist/lib/detection/test-burst.d.ts +77 -0
  457. package/dist/lib/detection/test-burst.js +126 -0
  458. package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
  459. package/dist/lib/detection/tool-loop-detector.js +302 -0
  460. package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
  461. package/dist/lib/detection/topic-drift-detector.js +252 -0
  462. package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
  463. package/dist/lib/enforcement/adherence-meter.js +420 -0
  464. package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
  465. package/dist/lib/enforcement/turn-dedup.js +195 -0
  466. package/dist/lib/errors/llm-error.d.ts +79 -0
  467. package/dist/lib/errors/llm-error.js +241 -0
  468. package/dist/lib/events/consolidation-channel.d.ts +109 -0
  469. package/dist/lib/events/consolidation-channel.js +374 -0
  470. package/dist/lib/events/consolidation-scoring.d.ts +59 -0
  471. package/dist/lib/events/consolidation-scoring.js +95 -0
  472. package/dist/lib/events/event-bus.d.ts +123 -0
  473. package/dist/lib/events/event-bus.js +108 -0
  474. package/dist/lib/events/event-types.d.ts +39 -0
  475. package/dist/lib/events/event-types.js +30 -0
  476. package/dist/lib/events/timer-bus.d.ts +21 -0
  477. package/dist/lib/events/timer-bus.js +41 -0
  478. package/dist/lib/events/timer-types.d.ts +64 -0
  479. package/dist/lib/events/timer-types.js +8 -0
  480. package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
  481. package/dist/lib/events/turn-end-coordinator.js +89 -0
  482. package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
  483. package/dist/lib/harness/failure-trace-collector.js +114 -0
  484. package/dist/lib/harness/index.d.ts +20 -0
  485. package/dist/lib/harness/index.js +21 -0
  486. package/dist/lib/harness/types.d.ts +85 -0
  487. package/dist/lib/harness/types.js +20 -0
  488. package/dist/lib/harness/weakness-miner.d.ts +29 -0
  489. package/dist/lib/harness/weakness-miner.js +165 -0
  490. package/dist/lib/memory/constants.d.ts +11 -0
  491. package/dist/lib/memory/constants.js +29 -0
  492. package/dist/lib/memory/index.d.ts +147 -0
  493. package/dist/lib/memory/index.js +564 -0
  494. package/dist/lib/memory/lifecycle.d.ts +50 -0
  495. package/dist/lib/memory/lifecycle.js +139 -0
  496. package/dist/lib/memory/past-insights.d.ts +35 -0
  497. package/dist/lib/memory/past-insights.js +189 -0
  498. package/dist/lib/memory/storage.d.ts +38 -0
  499. package/dist/lib/memory/storage.js +167 -0
  500. package/dist/lib/memory/store-lock.d.ts +23 -0
  501. package/dist/lib/memory/store-lock.js +69 -0
  502. package/dist/lib/memory/store-merge.d.ts +38 -0
  503. package/dist/lib/memory/store-merge.js +73 -0
  504. package/dist/lib/memory/types.d.ts +65 -0
  505. package/dist/lib/memory/types.js +5 -0
  506. package/dist/lib/memory/utils.d.ts +35 -0
  507. package/dist/lib/memory/utils.js +156 -0
  508. package/dist/lib/memory/write-log.d.ts +85 -0
  509. package/dist/lib/memory/write-log.js +124 -0
  510. package/dist/lib/memory/write-quality.d.ts +197 -0
  511. package/dist/lib/memory/write-quality.js +314 -0
  512. package/dist/lib/orchestrator/branch.d.ts +63 -0
  513. package/dist/lib/orchestrator/branch.js +192 -0
  514. package/dist/lib/orchestrator/index.d.ts +14 -0
  515. package/dist/lib/orchestrator/index.js +11 -0
  516. package/dist/lib/orchestrator/locks.d.ts +46 -0
  517. package/dist/lib/orchestrator/locks.js +122 -0
  518. package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
  519. package/dist/lib/orchestrator/slop-scanner.js +207 -0
  520. package/dist/lib/orchestrator/workers.d.ts +453 -0
  521. package/dist/lib/orchestrator/workers.js +1001 -0
  522. package/dist/lib/public.d.ts +18 -0
  523. package/dist/lib/public.js +23 -0
  524. package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
  525. package/dist/lib/reasoning/advice-tracker.js +177 -0
  526. package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
  527. package/dist/lib/reasoning/belief-policy-engine.js +268 -0
  528. package/dist/lib/reasoning/belief-types.d.ts +32 -0
  529. package/dist/lib/reasoning/belief-types.js +8 -0
  530. package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
  531. package/dist/lib/reasoning/classifier-offline.js +75 -0
  532. package/dist/lib/reasoning/dreamer.d.ts +37 -0
  533. package/dist/lib/reasoning/dreamer.js +169 -0
  534. package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
  535. package/dist/lib/reasoning/nudge-analytics.js +62 -0
  536. package/dist/lib/reasoning/policy-rules.d.ts +18 -0
  537. package/dist/lib/reasoning/policy-rules.js +153 -0
  538. package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
  539. package/dist/lib/reasoning/reasoning-metrics.js +174 -0
  540. package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
  541. package/dist/lib/reasoning/reasoning-summary.js +122 -0
  542. package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
  543. package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
  544. package/dist/lib/state/async-storage.d.ts +52 -0
  545. package/dist/lib/state/async-storage.js +171 -0
  546. package/dist/lib/state/extension-state.d.ts +184 -0
  547. package/dist/lib/state/extension-state.js +373 -0
  548. package/dist/lib/state/global-state.d.ts +358 -0
  549. package/dist/lib/state/global-state.js +741 -0
  550. package/dist/lib/state/metacognitive-state.d.ts +21 -0
  551. package/dist/lib/state/metacognitive-state.js +50 -0
  552. package/dist/lib/state/session-manager.d.ts +32 -0
  553. package/dist/lib/state/session-manager.js +11 -0
  554. package/dist/lib/state/session-start-queue.d.ts +42 -0
  555. package/dist/lib/state/session-start-queue.js +105 -0
  556. package/dist/lib/state/state-checkpoint.d.ts +72 -0
  557. package/dist/lib/state/state-checkpoint.js +252 -0
  558. package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
  559. package/dist/lib/state/telegram-poller-liveness.js +67 -0
  560. package/dist/lib/state/tool-provenance.d.ts +22 -0
  561. package/dist/lib/state/tool-provenance.js +25 -0
  562. package/dist/lib/state/workspace-snapshot.d.ts +111 -0
  563. package/dist/lib/state/workspace-snapshot.js +372 -0
  564. package/dist/lib/store/belief-store.d.ts +112 -0
  565. package/dist/lib/store/belief-store.js +252 -0
  566. package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
  567. package/dist/lib/store/bidirectional-verifier.js +242 -0
  568. package/dist/lib/store/claim-tracker.d.ts +66 -0
  569. package/dist/lib/store/claim-tracker.js +276 -0
  570. package/dist/lib/store/conflict-qa.d.ts +96 -0
  571. package/dist/lib/store/conflict-qa.js +283 -0
  572. package/dist/lib/store/evidence-pool.d.ts +185 -0
  573. package/dist/lib/store/evidence-pool.js +598 -0
  574. package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
  575. package/dist/lib/telemetry/context-heartbeat.js +449 -0
  576. package/dist/lib/telemetry/drift-signals.d.ts +46 -0
  577. package/dist/lib/telemetry/drift-signals.js +75 -0
  578. package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
  579. package/dist/lib/telemetry/rss-telemetry.js +53 -0
  580. package/dist/lib/types/episode-types.d.ts +31 -0
  581. package/dist/lib/types/episode-types.js +9 -0
  582. package/dist/lib/types/standard-result.d.ts +32 -0
  583. package/dist/lib/types/standard-result.js +22 -0
  584. package/dist/lib/utils/async-fs.d.ts +17 -0
  585. package/dist/lib/utils/async-fs.js +22 -0
  586. package/dist/lib/utils/bounded.d.ts +38 -0
  587. package/dist/lib/utils/bounded.js +59 -0
  588. package/dist/lib/utils/dedup.d.ts +40 -0
  589. package/dist/lib/utils/dedup.js +43 -0
  590. package/dist/lib/utils/error-guard.d.ts +15 -0
  591. package/dist/lib/utils/error-guard.js +22 -0
  592. package/dist/lib/utils/extension-utils.d.ts +36 -0
  593. package/dist/lib/utils/extension-utils.js +65 -0
  594. package/dist/lib/utils/extract-json.d.ts +23 -0
  595. package/dist/lib/utils/extract-json.js +90 -0
  596. package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
  597. package/dist/lib/utils/file-mutation-queue.js +150 -0
  598. package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
  599. package/dist/lib/utils/filter-safe-to-remove.js +256 -0
  600. package/dist/lib/utils/format-tool-result.d.ts +47 -0
  601. package/dist/lib/utils/format-tool-result.js +88 -0
  602. package/dist/lib/utils/id.d.ts +44 -0
  603. package/dist/lib/utils/id.js +59 -0
  604. package/dist/lib/utils/injection-tracker.d.ts +317 -0
  605. package/dist/lib/utils/injection-tracker.js +840 -0
  606. package/dist/lib/utils/local-time.d.ts +57 -0
  607. package/dist/lib/utils/local-time.js +181 -0
  608. package/dist/lib/utils/memory-fence.d.ts +55 -0
  609. package/dist/lib/utils/memory-fence.js +66 -0
  610. package/dist/lib/utils/sop-extractor.d.ts +75 -0
  611. package/dist/lib/utils/sop-extractor.js +259 -0
  612. package/dist/lib/utils/sop-suggestion.d.ts +34 -0
  613. package/dist/lib/utils/sop-suggestion.js +336 -0
  614. package/dist/lib/utils/wake-gate.d.ts +151 -0
  615. package/dist/lib/utils/wake-gate.js +265 -0
  616. package/dist/lib/utils/whisper-format.d.ts +95 -0
  617. package/dist/lib/utils/whisper-format.js +115 -0
  618. package/dist/lib/verification/coordination-checker.d.ts +72 -0
  619. package/dist/lib/verification/coordination-checker.js +126 -0
  620. package/dist/loader/api.d.ts +19 -0
  621. package/dist/loader/api.js +114 -0
  622. package/dist/loader/loader.d.ts +85 -0
  623. package/dist/loader/loader.js +534 -0
  624. package/docs/BEGINNERS.md +166 -0
  625. package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
  626. package/docs/CONTEXT-MAP.md +220 -0
  627. package/docs/CONTEXT-POLICY.md +86 -0
  628. package/docs/HISTORY.md +110 -0
  629. package/docs/LOCAL_DEV.md +246 -0
  630. package/docs/ROADMAP.md +107 -0
  631. package/docs/SETUP.md +502 -0
  632. package/package.json +97 -4
  633. package/skills/agent-testing/SKILL.md +214 -0
  634. package/skills/braid-reference/SKILL.md +88 -0
  635. package/skills/code-refactoring/SKILL.md +211 -0
  636. package/skills/code-search/SKILL.md +14 -0
  637. package/skills/documentation/SKILL.md +89 -0
  638. package/skills/dox/AGENTS.md.template +83 -0
  639. package/skills/dox/SKILL.md +86 -0
  640. package/skills/healthcheck/SKILL.md +65 -0
  641. package/skills/herdr-topology/SKILL.md +269 -0
  642. package/skills/meta-cognition/SKILL.md +24 -0
  643. package/skills/meta-improvement/SKILL.md +180 -0
  644. package/skills/misdirection-audit/SKILL.md +66 -0
  645. package/skills/pi-reference/SKILL.md +104 -0
  646. package/skills/placement-discipline/SKILL.md +69 -0
  647. package/skills/probe-evaluation/SKILL.md +85 -0
  648. package/skills/release-pipeline/SKILL.md +191 -0
  649. package/skills/research/SKILL.md +166 -0
  650. package/skills/skill-usage/SKILL.md +81 -0
  651. package/skills/software-engineer/SKILL.md +83 -0
  652. package/skills/subagent-orchestration/SKILL.md +454 -0
  653. package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
  654. package/skills/subagent-verification/SKILL.md +127 -0
  655. package/skills/tone-quality/SKILL.md +176 -0
  656. package/skills/voice-replies/SKILL.md +125 -0
  657. package/src/AGENTS.md +111 -0
  658. package/src/extensions/cognitive/AGENTS.md +29 -0
  659. package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
  660. package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
  661. package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
  662. package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
  663. package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
  664. package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
  665. package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
  666. package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
  667. package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
  668. package/src/extensions/cognitive/metacognition/index.ts +109 -0
  669. package/src/extensions/cognitive/reasoning/index.ts +168 -0
  670. package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
  671. package/src/extensions/cognitive/topic-drift/index.ts +429 -0
  672. package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
  673. package/src/extensions/context-management/README.md +102 -0
  674. package/src/extensions/context-management/index.ts +383 -0
  675. package/src/extensions/core/AGENTS.md +34 -0
  676. package/src/extensions/core/agent-environment/index.ts +135 -0
  677. package/src/extensions/core/polyfill/index.ts +617 -0
  678. package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
  679. package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
  680. package/src/extensions/core/prompt-builder/context-section.ts +120 -0
  681. package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
  682. package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
  683. package/src/extensions/core/prompt-builder/identity.ts +98 -0
  684. package/src/extensions/core/prompt-builder/index.ts +602 -0
  685. package/src/extensions/core/prompt-builder/inspect.ts +227 -0
  686. package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
  687. package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
  688. package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
  689. package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
  690. package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
  691. package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
  692. package/src/extensions/core/prompt-builder/section.ts +150 -0
  693. package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
  694. package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
  695. package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
  696. package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
  697. package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
  698. package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
  699. package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
  700. package/src/extensions/core/skills-tool/index.ts +240 -0
  701. package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
  702. package/src/extensions/core/skills-tool/session-records.ts +328 -0
  703. package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
  704. package/src/extensions/enforcement/AGENTS.md +69 -0
  705. package/src/extensions/enforcement/detection/malformed.ts +42 -0
  706. package/src/extensions/enforcement/detection/verification.ts +52 -0
  707. package/src/extensions/enforcement/enforcement-types.ts +42 -0
  708. package/src/extensions/enforcement/handler-registry.ts +225 -0
  709. package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
  710. package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
  711. package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
  712. package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
  713. package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
  714. package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
  715. package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
  716. package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
  717. package/src/extensions/enforcement/handlers/blocking.ts +50 -0
  718. package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
  719. package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
  720. package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
  721. package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
  722. package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
  723. package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
  724. package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
  725. package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
  726. package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
  727. package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
  728. package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
  729. package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
  730. package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
  731. package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
  732. package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
  733. package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
  734. package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
  735. package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
  736. package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
  737. package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
  738. package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
  739. package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
  740. package/src/extensions/enforcement/index.ts +28 -0
  741. package/src/extensions/enforcement/judge-utils.ts +106 -0
  742. package/src/extensions/enforcement/nudge-manager.ts +298 -0
  743. package/src/extensions/enforcement/self-state-claims.ts +204 -0
  744. package/src/extensions/enforcement/session-health.ts +317 -0
  745. package/src/extensions/enforcement/signals.ts +88 -0
  746. package/src/extensions/enforcement/similarity.ts +76 -0
  747. package/src/extensions/enforcement/state.ts +115 -0
  748. package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
  749. package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
  750. package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
  751. package/src/extensions/enforcement/substate/session-state.ts +79 -0
  752. package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
  753. package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
  754. package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
  755. package/src/extensions/enforcement/task-evidence.ts +436 -0
  756. package/src/extensions/enforcement/types.ts +38 -0
  757. package/src/extensions/enforcement/validation.ts +194 -0
  758. package/src/extensions/enforcement/verification-judge.ts +317 -0
  759. package/src/extensions/enforcement/whisper.ts +120 -0
  760. package/src/extensions/heartbeat/AGENTS.md +47 -0
  761. package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
  762. package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
  763. package/src/extensions/heartbeat/analytics/core.ts +222 -0
  764. package/src/extensions/heartbeat/analytics/format.ts +144 -0
  765. package/src/extensions/heartbeat/analytics/index.ts +373 -0
  766. package/src/extensions/heartbeat/analytics/shared.ts +149 -0
  767. package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
  768. package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
  769. package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
  770. package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
  771. package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
  772. package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
  773. package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
  774. package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
  775. package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
  776. package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
  777. package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
  778. package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
  779. package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
  780. package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
  781. package/src/extensions/manifest.ts +293 -0
  782. package/src/extensions/memory/AGENTS.md +93 -0
  783. package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
  784. package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
  785. package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
  786. package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
  787. package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
  788. package/src/extensions/memory/context-lifecycle/state.ts +165 -0
  789. package/src/extensions/memory/context-lifecycle/types.ts +441 -0
  790. package/src/extensions/memory/context-manager/analysis.ts +344 -0
  791. package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
  792. package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
  793. package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
  794. package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
  795. package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
  796. package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
  797. package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
  798. package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
  799. package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
  800. package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
  801. package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
  802. package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
  803. package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
  804. package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
  805. package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
  806. package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
  807. package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
  808. package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
  809. package/src/extensions/memory/context-manager/index.ts +111 -0
  810. package/src/extensions/memory/context-manager/pruning.ts +479 -0
  811. package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
  812. package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
  813. package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
  814. package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
  815. package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
  816. package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
  817. package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
  818. package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
  819. package/src/extensions/memory/scratchpad/format.ts +161 -0
  820. package/src/extensions/memory/scratchpad/handlers.ts +601 -0
  821. package/src/extensions/memory/scratchpad/index.ts +230 -0
  822. package/src/extensions/memory/scratchpad/persistence.ts +374 -0
  823. package/src/extensions/memory/scratchpad/types.ts +149 -0
  824. package/src/extensions/memory/scratchpad/utils.ts +268 -0
  825. package/src/extensions/memory/session-recall/AGENTS.md +104 -0
  826. package/src/extensions/memory/session-recall/analyze.ts +605 -0
  827. package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
  828. package/src/extensions/memory/session-recall/index.ts +956 -0
  829. package/src/extensions/memory/session-recall/query.ts +44 -0
  830. package/src/extensions/memory/session-recall/rank.ts +121 -0
  831. package/src/extensions/memory/session-recall/search.ts +801 -0
  832. package/src/extensions/memory/session-recall/stats.ts +93 -0
  833. package/src/extensions/memory/session-recall/text-utils.ts +209 -0
  834. package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
  835. package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
  836. package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
  837. package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
  838. package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
  839. package/src/extensions/memory/three-memory-stores/index.ts +549 -0
  840. package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
  841. package/src/extensions/memory/three-memory-stores/types.ts +74 -0
  842. package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
  843. package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
  844. package/src/extensions/orchestrator/index.ts +1141 -0
  845. package/src/extensions/scheduling/AGENTS.md +26 -0
  846. package/src/extensions/scheduling/timer/AGENTS.md +259 -0
  847. package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
  848. package/src/extensions/scheduling/timer/index.ts +1331 -0
  849. package/src/extensions/scheduling/timer/poller.ts +138 -0
  850. package/src/extensions/scheduling/timer/recovery.ts +462 -0
  851. package/src/extensions/scheduling/timer/store-file.ts +59 -0
  852. package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
  853. package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
  854. package/src/extensions/self/AGENTS.md +30 -0
  855. package/src/extensions/self/auto-recovery/index.ts +112 -0
  856. package/src/extensions/self/error-tracking/AGENTS.md +38 -0
  857. package/src/extensions/self/error-tracking/index.ts +299 -0
  858. package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
  859. package/src/extensions/self/health-maintenance/format.ts +87 -0
  860. package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
  861. package/src/extensions/self/health-maintenance/helpers.ts +78 -0
  862. package/src/extensions/self/health-maintenance/index.ts +308 -0
  863. package/src/extensions/self/health-maintenance/types.ts +14 -0
  864. package/src/extensions/self/latent-activator/AGENTS.md +64 -0
  865. package/src/extensions/self/latent-activator/index.ts +206 -0
  866. package/src/extensions/self/latent-activator/mixes.ts +22 -0
  867. package/src/extensions/self/latent-activator/signals.ts +237 -0
  868. package/src/extensions/self/latent-activator/state.ts +79 -0
  869. package/src/extensions/self/latent-activator/types.ts +47 -0
  870. package/src/extensions/self/watchdog/AGENTS.md +27 -0
  871. package/src/extensions/self/watchdog/config.ts +73 -0
  872. package/src/extensions/self/watchdog/engine.ts +1246 -0
  873. package/src/extensions/self/watchdog/index.ts +577 -0
  874. package/src/index.ts +93 -0
  875. package/src/lib/AGENTS.md +39 -0
  876. package/src/lib/ai/AGENTS.md +37 -0
  877. package/src/lib/ai/consolidated-claim-critic.ts +287 -0
  878. package/src/lib/ai/cost-report.ts +206 -0
  879. package/src/lib/ai/critic-cache.ts +122 -0
  880. package/src/lib/ai/critic-fallbacks.ts +74 -0
  881. package/src/lib/ai/critic-gate.ts +135 -0
  882. package/src/lib/ai/critic-helpers.ts +135 -0
  883. package/src/lib/ai/critic-registry.ts +754 -0
  884. package/src/lib/ai/critic-stats.ts +158 -0
  885. package/src/lib/ai/judge-budget.ts +241 -0
  886. package/src/lib/ai/language-hint.ts +70 -0
  887. package/src/lib/ai/llm-call.ts +975 -0
  888. package/src/lib/ai/model-resolver.ts +224 -0
  889. package/src/lib/ai/models-init.ts +68 -0
  890. package/src/lib/ai/payload-hygiene.ts +265 -0
  891. package/src/lib/ai/post-loop-classify.ts +185 -0
  892. package/src/lib/ai/text-classifier.ts +746 -0
  893. package/src/lib/cognitive/AGENTS.md +40 -0
  894. package/src/lib/cognitive/hints.ts +254 -0
  895. package/src/lib/cognitive/openspec.ts +124 -0
  896. package/src/lib/config/AGENTS.md +17 -0
  897. package/src/lib/config/braid-paths.ts +401 -0
  898. package/src/lib/config/braid-settings.ts +1442 -0
  899. package/src/lib/config/per-tool-settings.ts +197 -0
  900. package/src/lib/config/session-profiles.ts +165 -0
  901. package/src/lib/constants/AGENTS.md +15 -0
  902. package/src/lib/constants/injection-details.ts +32 -0
  903. package/src/lib/constants/session-thresholds.ts +64 -0
  904. package/src/lib/constants/tool-constants.ts +16 -0
  905. package/src/lib/core/AGENTS.md +23 -0
  906. package/src/lib/core/event-names.ts +31 -0
  907. package/src/lib/core/logger.ts +334 -0
  908. package/src/lib/detection/AGENTS.md +21 -0
  909. package/src/lib/detection/compression-strategy.ts +183 -0
  910. package/src/lib/detection/consolidated-topic-critic.ts +188 -0
  911. package/src/lib/detection/context-density.ts +237 -0
  912. package/src/lib/detection/context-thresholds.ts +132 -0
  913. package/src/lib/detection/context-tiers.ts +201 -0
  914. package/src/lib/detection/context-usage.ts +270 -0
  915. package/src/lib/detection/degradation-detector.ts +583 -0
  916. package/src/lib/detection/test-burst.ts +170 -0
  917. package/src/lib/detection/tool-loop-detector.ts +364 -0
  918. package/src/lib/detection/topic-drift-detector.ts +323 -0
  919. package/src/lib/enforcement/AGENTS.md +20 -0
  920. package/src/lib/enforcement/adherence-meter.ts +578 -0
  921. package/src/lib/enforcement/turn-dedup.ts +246 -0
  922. package/src/lib/errors/llm-error.ts +288 -0
  923. package/src/lib/events/AGENTS.md +23 -0
  924. package/src/lib/events/consolidation-channel.ts +493 -0
  925. package/src/lib/events/consolidation-scoring.ts +112 -0
  926. package/src/lib/events/event-bus.ts +213 -0
  927. package/src/lib/events/event-types.ts +53 -0
  928. package/src/lib/events/timer-bus.ts +53 -0
  929. package/src/lib/events/timer-types.ts +64 -0
  930. package/src/lib/events/turn-end-coordinator.ts +108 -0
  931. package/src/lib/harness/AGENTS.md +20 -0
  932. package/src/lib/harness/failure-trace-collector.ts +157 -0
  933. package/src/lib/harness/index.ts +41 -0
  934. package/src/lib/harness/types.ts +122 -0
  935. package/src/lib/harness/weakness-miner.ts +209 -0
  936. package/src/lib/memory/AGENTS.md +36 -0
  937. package/src/lib/memory/constants.ts +34 -0
  938. package/src/lib/memory/index.ts +705 -0
  939. package/src/lib/memory/lifecycle.ts +159 -0
  940. package/src/lib/memory/past-insights.ts +221 -0
  941. package/src/lib/memory/storage.ts +187 -0
  942. package/src/lib/memory/store-lock.ts +70 -0
  943. package/src/lib/memory/store-merge.ts +100 -0
  944. package/src/lib/memory/types.ts +82 -0
  945. package/src/lib/memory/utils.ts +173 -0
  946. package/src/lib/memory/write-log.ts +174 -0
  947. package/src/lib/memory/write-quality.ts +383 -0
  948. package/src/lib/orchestrator/branch.ts +193 -0
  949. package/src/lib/orchestrator/index.ts +78 -0
  950. package/src/lib/orchestrator/locks.ts +160 -0
  951. package/src/lib/orchestrator/slop-scanner.ts +258 -0
  952. package/src/lib/orchestrator/workers.ts +1382 -0
  953. package/src/lib/public.ts +43 -0
  954. package/src/lib/reasoning/AGENTS.md +25 -0
  955. package/src/lib/reasoning/advice-tracker.ts +244 -0
  956. package/src/lib/reasoning/belief-policy-engine.ts +342 -0
  957. package/src/lib/reasoning/belief-types.ts +45 -0
  958. package/src/lib/reasoning/classifier-offline.ts +111 -0
  959. package/src/lib/reasoning/dreamer.ts +215 -0
  960. package/src/lib/reasoning/nudge-analytics.ts +85 -0
  961. package/src/lib/reasoning/policy-rules.ts +172 -0
  962. package/src/lib/reasoning/reasoning-metrics.ts +202 -0
  963. package/src/lib/reasoning/reasoning-summary.ts +154 -0
  964. package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
  965. package/src/lib/state/AGENTS.md +192 -0
  966. package/src/lib/state/async-storage.ts +189 -0
  967. package/src/lib/state/extension-state.ts +419 -0
  968. package/src/lib/state/global-state.ts +1046 -0
  969. package/src/lib/state/metacognitive-state.ts +65 -0
  970. package/src/lib/state/session-manager.ts +43 -0
  971. package/src/lib/state/session-start-queue.ts +135 -0
  972. package/src/lib/state/state-checkpoint.ts +352 -0
  973. package/src/lib/state/telegram-poller-liveness.ts +75 -0
  974. package/src/lib/state/tool-provenance.ts +26 -0
  975. package/src/lib/state/workspace-snapshot.ts +466 -0
  976. package/src/lib/store/AGENTS.md +24 -0
  977. package/src/lib/store/belief-store.ts +325 -0
  978. package/src/lib/store/bidirectional-verifier.ts +316 -0
  979. package/src/lib/store/claim-tracker.ts +382 -0
  980. package/src/lib/store/conflict-qa.ts +385 -0
  981. package/src/lib/store/evidence-pool.ts +779 -0
  982. package/src/lib/telemetry/AGENTS.md +28 -0
  983. package/src/lib/telemetry/context-heartbeat.ts +555 -0
  984. package/src/lib/telemetry/drift-signals.ts +105 -0
  985. package/src/lib/telemetry/rss-telemetry.ts +57 -0
  986. package/src/lib/types/AGENTS.md +21 -0
  987. package/src/lib/types/episode-types.ts +31 -0
  988. package/src/lib/types/standard-result.ts +40 -0
  989. package/src/lib/utils/AGENTS.md +30 -0
  990. package/src/lib/utils/async-fs.ts +23 -0
  991. package/src/lib/utils/bounded.ts +58 -0
  992. package/src/lib/utils/dedup.ts +44 -0
  993. package/src/lib/utils/error-guard.ts +27 -0
  994. package/src/lib/utils/extension-utils.ts +72 -0
  995. package/src/lib/utils/extract-json.ts +89 -0
  996. package/src/lib/utils/file-mutation-queue.ts +172 -0
  997. package/src/lib/utils/filter-safe-to-remove.ts +301 -0
  998. package/src/lib/utils/format-tool-result.ts +109 -0
  999. package/src/lib/utils/id.ts +64 -0
  1000. package/src/lib/utils/injection-tracker.ts +1014 -0
  1001. package/src/lib/utils/local-time.ts +196 -0
  1002. package/src/lib/utils/memory-fence.ts +70 -0
  1003. package/src/lib/utils/sop-extractor.ts +329 -0
  1004. package/src/lib/utils/sop-suggestion.ts +426 -0
  1005. package/src/lib/utils/wake-gate.ts +318 -0
  1006. package/src/lib/utils/whisper-format.ts +120 -0
  1007. package/src/lib/verification/coordination-checker.ts +183 -0
  1008. package/src/loader/AGENTS.md +32 -0
  1009. package/src/loader/api.ts +138 -0
  1010. package/src/loader/loader.ts +600 -0
  1011. package/src/types/extension-context.d.ts +85 -0
@@ -0,0 +1,881 @@
1
+ /**
2
+ * Heartbeat Scheduler - proactive cognitive scheduling based on paper 2604.14178.
3
+ *
4
+ * Triggers interventions before problems arise: silence, context overflow, error accumulation.
5
+ * This file is the extension entry point. Logic is decomposed into sub-modules:
6
+ * - types.ts Type definitions
7
+ * - state.ts State management and configuration
8
+ * - policies.ts Default policies (verification, context monitor)
9
+ * - meta-learning.ts Adaptive tick interval adjustment
10
+ * - modules/ Individual cognitive modules (recaller, reflection-consolidator,
11
+ * context-hygiene, evolver, ...). `dreamerModule` is the test-facing alias
12
+ * re-exported below, not a module file.
13
+ */
14
+ import { createPolicyEngine, getPolicyEngine, getBeliefStore, cleanupSession, } from "../../../lib/store/belief-store.js";
15
+ import { createLogger } from "../../../lib/core/logger.js";
16
+ import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
17
+ import { getExtensionState } from "../../../lib/state/extension-state.js";
18
+ import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
19
+ import { fenceMemoryContext } from "../../../lib/utils/memory-fence.js";
20
+ import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
21
+ import { eventBus } from "../../../lib/events/event-bus.js";
22
+ import { getRssGrowthWhisperShown, markRssGrowthWhisperShown, getContextEmergencyOffloadRunner, } from "../../../lib/state/global-state.js";
23
+ import { processConsolidationTick, executeConsolidation, } from "../../../lib/events/consolidation-channel.js";
24
+ import { heartbeatCheckpointTick } from "../../../lib/state/state-checkpoint.js";
25
+ import { getSessionHealth, recordConsolidationSkip } from "../../enforcement/session-health.js";
26
+ import { extractSOP } from "../../../lib/utils/sop-extractor.js";
27
+ import { injectSopSuggestions, trackSuggestionFeedback, } from "../../../lib/utils/sop-suggestion.js";
28
+ import { isDegraded, recordTurnMetrics, captureSystemMetrics, } from "../../../lib/detection/degradation-detector.js";
29
+ import { collectAndEmitContextHeartbeat, noteAssistantMessageEnd, } from "../../../lib/telemetry/context-heartbeat.js";
30
+ import { retrieveEpisodes, addEpisode } from "../../memory/three-memory-stores/index.js";
31
+ import { getSessionIdSafe } from "../../../lib/state/extension-state.js";
32
+ import { deriveProjectIdFromCwd } from "../../../lib/memory/past-insights.js";
33
+ import { shouldWriteOutcomeEpisode } from "../../../lib/memory/write-quality.js";
34
+ import { getMemoryWriteGateConfig } from "../../../lib/config/braid-settings.js";
35
+ import { formatLocalTime } from "../../../lib/utils/local-time.js";
36
+ /** Derive a short project id from the current working directory. */
37
+ function deriveProject(ctx) {
38
+ return typeof ctx.cwd === "string" ? deriveProjectIdFromCwd(ctx.cwd) : "unknown";
39
+ }
40
+ function getTurnStartPrompt(ctx) {
41
+ return getExtensionState(ctx, "turn-start-prompt", () => ({ prompt: "" }));
42
+ }
43
+ /**
44
+ * Newest user-role text in the live branch, for runs whose prompt this process
45
+ * never saw: a resumed session's first turn has no before_agent_start capture,
46
+ * and pi appends the user message in its message_end handler, after
47
+ * turn_start(0). Branch entries wrap the message - a user turn is
48
+ * entry.type === "message" with entry.message.role === "user".
49
+ */
50
+ function newestUserText(ctx) {
51
+ try {
52
+ const sm = ctx.sessionManager;
53
+ const branch = sm?.getBranch?.() ?? [];
54
+ for (let i = branch.length - 1; i >= 0; i--) {
55
+ const entry = branch[i];
56
+ if (entry?.type !== "message" || entry.message?.role !== "user")
57
+ continue;
58
+ const content = entry.message.content;
59
+ if (typeof content === "string")
60
+ return content;
61
+ if (Array.isArray(content)) {
62
+ return content
63
+ .map((part) => part)
64
+ .filter((part) => part?.type === "text" && typeof part.text === "string")
65
+ .map((part) => part.text)
66
+ .join("\n");
67
+ }
68
+ return "";
69
+ }
70
+ }
71
+ catch {
72
+ // Best-effort: a stale ctx or an absent tree yields no text.
73
+ }
74
+ return "";
75
+ }
76
+ import { DEFAULT_CONFIG, getState, getMemoryState } from "./state.js";
77
+ import { updateMetaLearning, getAdaptiveInterval } from "./meta-learning.js";
78
+ import { createDefaultPolicies, VERIFICATION_TOOLS, WEB_TOOLS, CODE_TOOLS } from "./policies.js";
79
+ import { formatPendingCompactionsLine, maybeArmAutoCompaction, } from "../../memory/context-manager/handlers/tools/context-compress.js";
80
+ import { pushBounded } from "../../../lib/utils/bounded.js";
81
+ import { RSS_RING_CAP } from "../../../lib/telemetry/rss-telemetry.js";
82
+ import { recallerModule } from "./modules/recaller.js";
83
+ import { reflectionConsolidatorModule } from "./modules/reflection-consolidator.js";
84
+ import { contextHygieneModule } from "./modules/context-hygiene.js";
85
+ import { measurementModule } from "./modules/measurement.js";
86
+ import { budgetModule } from "./modules/budget.js";
87
+ import { evolverModule } from "./modules/evolver.js";
88
+ import { behavioralDriftModule } from "./modules/behavioral-drift.js";
89
+ import { TURN_END, TOOL_CALL, SESSION_SHUTDOWN, MESSAGE_END, AGENT_END, } from "../../../lib/core/event-names.js";
90
+ export { reflectionConsolidatorModule as dreamerModule };
91
+ const log = createLogger("heartbeat");
92
+ const _heartbeatWhisperBuffer = new Map();
93
+ // Outcome-episode write gate.
94
+ // Review-before-write quality gate on the session_outcome sender. The hasSignal
95
+ // tripwire + settings toggle + cooldown live in lib/memory/write-quality.ts;
96
+ // lastWriteAt is owned here (module scope, survives across sessions within the
97
+ // process) so the cooldown actually throttles back-to-back session ends.
98
+ let _lastOutcomeWriteAt = 0;
99
+ function bufferHeartbeatWhisper(sessionId, message, priority, source) {
100
+ let buffer = _heartbeatWhisperBuffer.get(sessionId);
101
+ if (!buffer) {
102
+ buffer = [];
103
+ _heartbeatWhisperBuffer.set(sessionId, buffer);
104
+ }
105
+ // The buffer normally drains on the next before_agent_start, but
106
+ // ticks can pile up while the session is idle (no before_agent_start to
107
+ // flush). Cap at 100 entries per session, drop-oldest — stale heartbeat
108
+ // messages past 100 are noise by definition.
109
+ pushBounded(buffer, { message, priority, source }, 100);
110
+ }
111
+ function flushDelayedWhispers(sessionId, pi, selfState) {
112
+ const buffer = _heartbeatWhisperBuffer.get(sessionId);
113
+ if (!buffer || buffer.length === 0)
114
+ return;
115
+ const batch = buffer.splice(0);
116
+ // Deduplicate near-duplicate messages: extract a semantic type key from
117
+ // each message. Messages of the same type (e.g., "Context at 40%..." and
118
+ // "Context at 50%...") collapse to one, so the Heartbeat Summary never
119
+ // lists 9 near-identical context-percentage messages with slightly
120
+ // different token counts.
121
+ function dedupKey(message) {
122
+ // Context percentage messages: "Context at 40%. context_tag..."
123
+ if (/^Context at \d+%/.test(message))
124
+ return "context-percentage";
125
+ // Duplicate count messages: "39 near-duplicate messages..."
126
+ if (/^\d+ near-duplicate messages/.test(message))
127
+ return "duplicate-count";
128
+ // Context density messages
129
+ if (/^Low context density/.test(message))
130
+ return "density-low";
131
+ if (/^High density/.test(message))
132
+ return "density-high";
133
+ if (/^Context density still low/.test(message))
134
+ return "density-low-persistent";
135
+ // Proactive projection messages
136
+ if (/^\[proactive\]/.test(message))
137
+ return "proactive-projection";
138
+ // Degradation messages
139
+ if (/^Degradation detected/.test(message))
140
+ return "degradation";
141
+ // Fallback: use first 80 chars
142
+ return message.slice(0, 80);
143
+ }
144
+ const deduped = [];
145
+ const seen = new Set();
146
+ for (const entry of batch) {
147
+ const key = dedupKey(entry.message);
148
+ if (seen.has(key))
149
+ continue;
150
+ seen.add(key);
151
+ deduped.push({ message: entry.message, priority: entry.priority });
152
+ }
153
+ // Aggregate by priority tier
154
+ const groups = new Map();
155
+ for (const entry of deduped) {
156
+ const p = entry.priority;
157
+ if (!groups.has(p))
158
+ groups.set(p, []);
159
+ groups.get(p).push(entry.message);
160
+ }
161
+ for (const [, messages] of groups) {
162
+ // Fresh clock: every Heartbeat Summary carries a `now:` line (date +
163
+ // owner-TZ time via the ONE formatter) so a long session never reasons on
164
+ // a stale clock — the heartbeat is the only mid-session channel guaranteed
165
+ // to re-fire. One context-health line follows the clock (tokens /
166
+ // cache-hit / near-dups / tok-s trend), so every heartbeat delivery is
167
+ // also a self-state checkpoint.
168
+ const nowLine = `now: ${formatLocalTime(new Date(), true)}`;
169
+ const selfStateSuffix = selfState ? `\n${selfState}` : "";
170
+ const text = messages.length === 1
171
+ ? `${nowLine}${selfStateSuffix}\n${messages[0]}`
172
+ : `[Heartbeat Summary]\n${nowLine}${selfStateSuffix}\n${messages.map((m, i) => `${i + 1}. ${m}`).join("\n")}`;
173
+ try {
174
+ sendTrackedMessage(pi, {
175
+ customType: "heartbeat",
176
+ content: [{ type: "text", text }],
177
+ display: true,
178
+ details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "heartbeat/delayed" },
179
+ }, { delivery: "park", deliverAs: "steer" }, { type: "heartbeat", source: "heartbeat/delayed" });
180
+ }
181
+ catch (err) {
182
+ log.warn(`[heartbeat] delayed whisper flush failed: ${err}`);
183
+ }
184
+ }
185
+ }
186
+ // SOP Formatting
187
+ /** Format SOP (3-tier hierarchy) for whispering to agent */
188
+ export function formatSOPForWhisper(episode) {
189
+ const parts = [];
190
+ if (episode.strategicSOP) {
191
+ parts.push(`**Strategy**: ${episode.strategicSOP}`);
192
+ }
193
+ if (episode.functionalSOP && episode.functionalSOP.length > 0) {
194
+ const steps = episode.functionalSOP.map((step, i) => `${i + 1}. ${step}`).join("\n");
195
+ parts.push(`**Key Steps**:\n${steps}`);
196
+ }
197
+ if (episode.atomicSOP && episode.atomicSOP.length > 0) {
198
+ parts.push(`**Tools**: ${episode.atomicSOP.join(" -> ")}`);
199
+ }
200
+ return parts.length > 0 ? parts.join("\n\n") : `SOP for: ${episode.task.slice(0, 100)}`;
201
+ }
202
+ /**
203
+ * Deliver the SOP coach whisper through the tracked channel.
204
+ *
205
+ * `ctx.whisper` is a type-only augmentation with no runtime implementation —
206
+ * a whisper sent there silently never fires, and would bypass the per-source
207
+ * flood cap, injection tracking, and the universal
208
+ * `[braid-whisper - heartbeat]` envelope. `sendTrackedMessage` (the trunk)
209
+ * is the delivery path; see `lib/utils/whisper-format.ts`.
210
+ */
211
+ export function sendSopCoachWhisper(pi, message) {
212
+ sendTrackedMessage(pi, {
213
+ customType: "heartbeat",
214
+ content: [{ type: "text", text: message }],
215
+ display: true,
216
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "heartbeat/sop-coach" });
217
+ }
218
+ // Whisper Batching
219
+ // flushWhisperBuffer lives in ./whisper-batcher.ts. The tick function
220
+ // imports it to flush module whispers as aggregated messages.
221
+ import { flushWhisperBuffer } from "./whisper-batcher.js";
222
+ import { buildSelfStateLine } from "./whisper-batcher.js";
223
+ import { getSelfStateSample } from "../../../lib/telemetry/context-heartbeat.js";
224
+ // Tick Engine
225
+ function tick(pi, state, config, ctx) {
226
+ state.stats.totalTicks++;
227
+ // Real telemetry: collect live context/RSS/session metrics, append the
228
+ // JSONL heartbeat line, and feed recordTurnMetrics real values (not
229
+ // placeholder constants). Sink failures are non-fatal inside the
230
+ // telemetry module; the degradation feed below tolerates unavailable
231
+ // samples (zeros).
232
+ const telemetry = collectAndEmitContextHeartbeat(ctx, {
233
+ turnNumber: state.turnCount,
234
+ healthMode: getSessionHealth(ctx).mode,
235
+ source: "heartbeat",
236
+ });
237
+ // Tool outcome stats from the capped trajectory (real error accounting).
238
+ const trajectory = state.metaLearning.toolTracking.trajectory ?? [];
239
+ const trajectoryErrors = trajectory.reduce((n, t) => n + (t.success ? 0 : 1), 0);
240
+ let trailingErrors = 0;
241
+ for (let i = trajectory.length - 1; i >= 0; i--) {
242
+ if (trajectory[i].success)
243
+ break;
244
+ trailingErrors++;
245
+ }
246
+ recordTurnMetrics(ctx, {
247
+ turnNumber: state.turnCount,
248
+ avgTurnDurationMs: telemetry.lastAssistantDurationMs ?? 0,
249
+ inputTokens: telemetry.inputTokens,
250
+ outputTokens: telemetry.outputTokens,
251
+ toolCalls: state.metaLearning.toolTracking.totalToolsUsed,
252
+ errors: trajectoryErrors,
253
+ errorRate: trajectory.length > 0 ? trajectoryErrors / trajectory.length : 0,
254
+ toolSuccessRate: trajectory.length > 0
255
+ ? ((trajectory.length - trajectoryErrors) / trajectory.length) * 100
256
+ : 100,
257
+ consecutiveErrors: trailingErrors,
258
+ tokenUsage: { input: telemetry.inputTokens, output: telemetry.outputTokens },
259
+ memoryUsagePercent: captureSystemMetrics().memoryUsagePercent,
260
+ });
261
+ // sustained RSS growth advisory (ONE per boot, no spam)
262
+ // The ring + baseline + verdict come from the telemetry module above. A
263
+ // FULL 24-sample ring sitting entirely above 2x the boot baseline is the
264
+ // accumulator-growth signature; the latch (process-global, global-state.ts)
265
+ // guarantees at most one advisory per boot. Advisory: buffered heartbeat
266
+ // message, never a wake.
267
+ if (telemetry.rssSustainedGrowth && !getRssGrowthWhisperShown()) {
268
+ markRssGrowthWhisperShown();
269
+ const baseMb = ((telemetry.rssBaselineBytes ?? 0) / 1048576).toFixed(0);
270
+ const curBytes = telemetry.rssRing[telemetry.rssRing.length - 1] ?? 0;
271
+ const curMb = (curBytes / 1048576).toFixed(0);
272
+ const sid0 = getSessionIdSafe(ctx) ?? "anonymous";
273
+ bufferHeartbeatWhisper(sid0, `[memory] Sustained RSS growth: ${curMb}MB now vs ${baseMb}MB boot baseline ` +
274
+ `(>2x across ${RSS_RING_CAP} heartbeat samples). Unbounded in-memory accumulator ` +
275
+ `likely — investigate (context_inspect, /logs) before the next OOM. ` +
276
+ `This advisory fires once per boot.`, "medium", "heartbeat/rss-growth");
277
+ log.warn(`[heartbeat] RSS sustained-growth advisory fired: ${(curBytes / 1048576).toFixed(0)}MB vs ${baseMb}MB baseline (${RSS_RING_CAP}-sample ring)`);
278
+ }
279
+ // armed-compaction visibility + usage-driven auto-arm
280
+ // A compaction armed by context_compress fires at the next turn boundary
281
+ // (turn_end) or at run settle. While it sits armed, live usage reads
282
+ // pre-compaction state — the pending state must stay visible in every
283
+ // heartbeat summary until it lands (a once-per-tier advisory went quiet
284
+ // exactly while nothing was landing), and usage sustained above the
285
+ // configured threshold must arm relief on its own: same pending queue,
286
+ // same boundary discipline (arming only queues; the compact still fires at
287
+ // a safe boundary, never mid-run). Best-effort: neither surface may break
288
+ // the tick.
289
+ try {
290
+ const pendingLine = formatPendingCompactionsLine(ctx);
291
+ if (pendingLine) {
292
+ bufferHeartbeatWhisper(getSessionIdSafe(ctx) ?? "anonymous", pendingLine, "high", "heartbeat/pending-compaction");
293
+ }
294
+ }
295
+ catch (err) {
296
+ log.warn(`[heartbeat] pending-compaction advisory failed: ${err}`);
297
+ }
298
+ try {
299
+ maybeArmAutoCompaction(pi, ctx);
300
+ }
301
+ catch (err) {
302
+ log.warn(`[heartbeat] context auto-arm check failed: ${err}`);
303
+ }
304
+ try {
305
+ eventBus.emit({
306
+ type: "heartbeat_tick",
307
+ turn: state.turnCount,
308
+ tickCount: state.stats.totalTicks,
309
+ timestamp: Date.now(),
310
+ });
311
+ }
312
+ catch (err) {
313
+ log.warn(`[heartbeat] Could not emit tick event: ${err}`);
314
+ }
315
+ state.policyTurnCount++;
316
+ updateMetaLearning(state);
317
+ // Evaluate policies on each tick
318
+ if (state.policyEngineReady) {
319
+ const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
320
+ const engine = getPolicyEngine(sessionId);
321
+ if (engine) {
322
+ const policyCtx = {
323
+ sessionId,
324
+ turnNumber: state.policyTurnCount,
325
+ toolStats: new Map(),
326
+ cwd: ctx.cwd ?? ".",
327
+ getContextUsage: () => ctx.getContextUsage(),
328
+ };
329
+ engine
330
+ .evaluate(policyCtx)
331
+ .then((fired) => {
332
+ if (fired.length > 0) {
333
+ log.info(`Policies fired: ${fired.map((p) => p.id).join(", ")}`);
334
+ }
335
+ })
336
+ .catch((err) => {
337
+ log.error("Policy evaluation error:", err);
338
+ });
339
+ }
340
+ }
341
+ // Build module context from heartbeat state. Modules call context.whisper()
342
+ // (not ctx.whisper?.()) to honor the flood cap: the whisperBuffer collects
343
+ // all module whispers; the tick handler flushes them via sendTrackedMessage.
344
+ const whisperBuffer = [];
345
+ // Per-tick AbortController for ESC propagation
346
+ // Create a fresh AbortController for this tick; modules receive it
347
+ // as context.abortSignal for cancellation-aware calls. On
348
+ // session_shutdown, the controller is aborted, cancelling any
349
+ // in-flight call instead of letting it run for its full timeout
350
+ // (10m default) after the session ends.
351
+ const tickController = new AbortController();
352
+ const abortState = getExtensionState(ctx, "heartbeat-abort", () => ({ controller: null }));
353
+ abortState.controller = tickController;
354
+ const moduleContext = {
355
+ ctx,
356
+ abortSignal: tickController.signal,
357
+ turnCount: state.turnCount,
358
+ lastActivation: state.lastActivation,
359
+ sessionAge: state.turnCount,
360
+ toolCallsSinceLastTick: [],
361
+ totalToolCalls: state.metaLearning.toolTracking.totalToolsUsed,
362
+ silentTurns: state.stats.totalTicks > 0
363
+ ? Math.max(0, state.stats.totalTicks - (state.metaLearning.toolTracking.lastToolCallTurn || 0))
364
+ : 0,
365
+ metadata: {
366
+ toolFailures: state.metaLearning.toolTracking.totalToolsUsed > 10
367
+ ? Math.max(0, Math.floor(state.metaLearning.toolTracking.totalToolsUsed * 0.15))
368
+ : 0,
369
+ decompositionDepth: 0,
370
+ },
371
+ whisper: (msg, opts) => {
372
+ whisperBuffer.push({ message: msg, priority: opts?.priority ?? "low" });
373
+ },
374
+ };
375
+ // Evaluate which modules should activate
376
+ const candidates = [];
377
+ for (const [, reg] of state.modules) {
378
+ if (!reg.enabled)
379
+ continue;
380
+ try {
381
+ if (reg.module.shouldActivate(moduleContext)) {
382
+ candidates.push({ module: reg.module, priority: reg.module.priority, reg });
383
+ }
384
+ }
385
+ catch (err) {
386
+ log.error(`Module "${reg.module.name}" shouldActivate error:`, err);
387
+ }
388
+ }
389
+ // Whisper batching: moduleContext.whisper() is the API modules call; it
390
+ // pushes to whisperBuffer (declared above) instead of mutating ctx.
391
+ // Modules that still call ctx.whisper directly bypass the per-source flood
392
+ // cap; future module migrations should adopt context.whisper().
393
+ candidates
394
+ .sort((a, b) => b.priority - a.priority)
395
+ .slice(0, config.maxActivationsPerTick)
396
+ .forEach(async ({ module, reg }) => {
397
+ try {
398
+ await module.activate(moduleContext);
399
+ reg.activations++;
400
+ reg.lastActivated = state.turnCount;
401
+ state.lastActivation.set(module.name, state.turnCount);
402
+ state.stats.totalActivations++;
403
+ state.stats.activationsByModule[module.name] =
404
+ (state.stats.activationsByModule[module.name] ?? 0) + 1;
405
+ state.activationHistory.push({
406
+ tick: state.stats.totalTicks,
407
+ moduleName: module.name,
408
+ timestamp: Date.now(),
409
+ reason: "heartbeat",
410
+ });
411
+ if (state.activationHistory.length > 100) {
412
+ state.activationHistory.shift();
413
+ }
414
+ state.metaLearning.pendingSignals.set(module.name, state.turnCount);
415
+ state.metaLearning.activationSignalWindow.set(module.name, state.turnCount);
416
+ log.info(`Activated module "${module.name}" (priority ${module.priority.toFixed(1)})`);
417
+ }
418
+ catch (err) {
419
+ log.error(`Module "${module.name}" activate error:`, err);
420
+ }
421
+ });
422
+ // Auto-checkpoint + auto-rollback
423
+ const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
424
+ // Consolidation Channel - fire-and-forget
425
+ processConsolidationTick(ctx).catch((err) => {
426
+ log.error("Consolidation tick error:", err);
427
+ });
428
+ heartbeatCheckpointTick(ctx, state.turnCount, sessionId, isDegraded(ctx))
429
+ .then((result) => {
430
+ if (result.checkpointCreated) {
431
+ log.info(`Auto-checkpoint created at turn ${state.turnCount}`);
432
+ }
433
+ if (result.rollbackPerformed) {
434
+ log.warn(`Auto-rollback performed: ${result.message}`);
435
+ whisperBuffer.push({
436
+ message: `Auto-rollback: ${result.message}`,
437
+ priority: "high",
438
+ });
439
+ }
440
+ if (result.rollbackSuppressed) {
441
+ // Test-debug guard: destructive rollback withheld on a
442
+ // test-runner-dominated error burst. Advice stays, action withheld —
443
+ // the agent hears the degradation signal without a conversation rewind.
444
+ log.warn(`Auto-rollback suppressed (test-debug loop): ${result.message}`);
445
+ whisperBuffer.push({
446
+ message: `Degradation detected but the recent error burst is test-runner dominated — ` +
447
+ `auto-rollback withheld (failing tests are expected in TDD/gate triage). ` +
448
+ `If this is NOT an intentional test loop, run health_maintenance(action="check").`,
449
+ priority: "medium",
450
+ });
451
+ }
452
+ })
453
+ .catch((err) => {
454
+ log.error("Checkpoint tick error:", err);
455
+ })
456
+ .finally(() => {
457
+ // Flush via the proper tracked channel: the buffer is collected by
458
+ // moduleContext.whisper(). Modules that still call ctx.whisper directly
459
+ // (not yet migrated) go through the original sendTrackedMessage channel
460
+ // so they still get batched + flood-capped.
461
+ const sendFn = (msg, opts) => {
462
+ const sid = getSessionIdSafe(ctx) ?? "anonymous";
463
+ bufferHeartbeatWhisper(sid, msg, opts?.priority ?? "low", "heartbeat/whisper-batcher");
464
+ };
465
+ // Self-state (Refine-2): the tick summary carries the self-state
466
+ // line (fresh telemetry was collected at the top of this tick).
467
+ flushWhisperBuffer(whisperBuffer, sendFn, buildSelfStateLine(getSelfStateSample(ctx)));
468
+ });
469
+ }
470
+ // Extension
471
+ export default function heartbeatExtension(pi) {
472
+ const config = { ...DEFAULT_CONFIG };
473
+ // Register built-in modules. Timer reminders are not a module: the timer
474
+ // extension's own wake/reminder delivery (timer/index.ts) is the
475
+ // canonical path — one timer fire, one whisper.
476
+ const builtInModules = [
477
+ recallerModule,
478
+ reflectionConsolidatorModule,
479
+ contextHygieneModule,
480
+ measurementModule,
481
+ evolverModule,
482
+ budgetModule,
483
+ behavioralDriftModule,
484
+ ];
485
+ // Event: turn_end
486
+ pi.on(TURN_END, async (_event, ctx) => {
487
+ const state = getState(ctx);
488
+ if (!state.enabled || !config.enabled)
489
+ return;
490
+ state.turnCount++;
491
+ eventBus.emit({
492
+ type: "turn_complete",
493
+ turn: state.turnCount,
494
+ duration: Date.now(),
495
+ });
496
+ const interval = getAdaptiveInterval(state);
497
+ if (state.turnCount % interval !== 0)
498
+ return;
499
+ tick(pi, state, config, ctx);
500
+ });
501
+ // Event: before_agent_start - flush delayed whispers
502
+ // Deliver buffered heartbeat whispers as part of the turn context,
503
+ // not as standalone messages between turns. This prevents the
504
+ // conversational adjacency confusion where the agent treats a
505
+ // between-turn whisper as user input.
506
+ pi.on("before_agent_start", (event, ctx) => {
507
+ const sid = getSessionIdSafe(ctx) ?? "anonymous";
508
+ // turn_start carries no user text (TurnStartEvent = type/turnIndex/timestamp),
509
+ // so capture the run's prompt here - the last point pi exposes it before
510
+ // turn 0. A failed capture leaves the slot untouched: empty on the session's
511
+ // first capture, so the branch fallback takes over; otherwise the previous
512
+ // capture stands.
513
+ const prompt = event?.prompt;
514
+ if (typeof prompt === "string" && prompt.length > 0) {
515
+ getTurnStartPrompt(ctx).prompt = prompt;
516
+ }
517
+ // Self-state (Refine-2): every heartbeat-family delivery carries the
518
+ // self-state line. Sampling never throws; missing telemetry -> "n/a".
519
+ flushDelayedWhispers(sid, pi, buildSelfStateLine(getSelfStateSample(ctx)));
520
+ });
521
+ // Event: tool_call
522
+ pi.on(TOOL_CALL, async (event, ctx) => {
523
+ const state = getState(ctx);
524
+ try {
525
+ const toolName = event?.toolName;
526
+ if (toolName)
527
+ trackSuggestionFeedback(ctx, toolName);
528
+ }
529
+ catch {
530
+ // Suggestion telemetry is observational — a malformed event must not
531
+ // break the tool-execution pipeline it observes.
532
+ }
533
+ // Meta-learning signal detection
534
+ if (state.metaLearning.pendingSignals.size > 0) {
535
+ state.metaLearning.postActivationToolCount++;
536
+ }
537
+ state.metaLearning.toolTracking.totalToolsUsed++;
538
+ state.metaLearning.toolTracking.lastToolCallTurn = state.policyTurnCount;
539
+ const toolName = event?.toolName;
540
+ if (!toolName)
541
+ return;
542
+ if (VERIFICATION_TOOLS.has(toolName)) {
543
+ state.metaLearning.toolTracking.verificationCount++;
544
+ state.metaLearning.toolTracking.lastVerificationTurn = state.policyTurnCount;
545
+ }
546
+ if (WEB_TOOLS.has(toolName)) {
547
+ state.metaLearning.toolTracking.lastWebFetchTurn = state.policyTurnCount;
548
+ }
549
+ if (CODE_TOOLS.has(toolName)) {
550
+ state.metaLearning.toolTracking.lastCodeExecutionTurn = state.policyTurnCount;
551
+ }
552
+ const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
553
+ const store = getBeliefStore(sessionId);
554
+ if (store) {
555
+ store.add({
556
+ id: `tool-${toolName}-${Date.now()}`,
557
+ content: `Tool ${toolName} executed at turn ${state.policyTurnCount}`,
558
+ source: "observation",
559
+ confidence: 0.9,
560
+ timestamp: Date.now(),
561
+ tags: ["tool", toolName],
562
+ });
563
+ }
564
+ });
565
+ // Event: message_end - assistant tps telemetry feed
566
+ // Duration = now - message.timestamp
567
+ // (stream-start proxy), usage.input/output from the final assistant
568
+ // message. Feeds tokensPerSec + the real token metrics in tick().
569
+ // No LLM calls, no whispering — pure observation.
570
+ pi.on(MESSAGE_END, (event, ctx) => {
571
+ try {
572
+ noteAssistantMessageEnd(ctx, event?.message);
573
+ }
574
+ catch {
575
+ // telemetry never fatal
576
+ }
577
+ });
578
+ // Event: tool_result - collect tool success/failure for trajectory enrichment
579
+ pi.on("tool_result", (event, ctx) => {
580
+ const state = getState(ctx);
581
+ const toolName = event?.toolName;
582
+ if (!toolName)
583
+ return;
584
+ // Track tool outcome for richer SOP extraction
585
+ const success = !event?.isError;
586
+ state.metaLearning.toolTracking.trajectory ??= [];
587
+ state.metaLearning.toolTracking.trajectory.push({
588
+ toolName,
589
+ success,
590
+ turn: state.policyTurnCount,
591
+ });
592
+ // Cap trajectory length
593
+ if (state.metaLearning.toolTracking.trajectory.length > 200) {
594
+ state.metaLearning.toolTracking.trajectory =
595
+ state.metaLearning.toolTracking.trajectory.slice(-100);
596
+ }
597
+ });
598
+ // Event: session_start
599
+ registerSessionStartHandler(pi, SessionPhase.MemoryState, async (_event, ctx) => {
600
+ const state = getState(ctx);
601
+ for (const module of builtInModules) {
602
+ if (!state.modules.has(module.name)) {
603
+ state.modules.set(module.name, {
604
+ module,
605
+ enabled: true,
606
+ activations: 0,
607
+ lastActivated: 0,
608
+ effectiveness: 0.5,
609
+ });
610
+ log.info(`Registered module "${module.name}"`);
611
+ }
612
+ }
613
+ const sessionId = getSessionIdSafe(ctx) ?? ctx.cwd ?? String(process.pid);
614
+ const engine = createPolicyEngine(sessionId);
615
+ state.policyTurnCount = 0;
616
+ state.policyEngineReady = true;
617
+ const onSignal = (type, _data) => {
618
+ state.activationHistory.push({
619
+ tick: state.stats.totalTicks,
620
+ moduleName: type,
621
+ timestamp: Date.now(),
622
+ reason: "policy",
623
+ });
624
+ };
625
+ const defaultPolicies = createDefaultPolicies(() => state.metaLearning.toolTracking, onSignal,
626
+ // Policy engine whisper uses the proper sendTrackedMessage channel
627
+ // (honors flood cap and injection tracking) instead of ctx.whisper.
628
+ // The per-tick aggregation (whisperBuffer) is for module whispers;
629
+ // policy whispers are signal-triggered and fire independently of the
630
+ // tick.
631
+ //
632
+ // Policy whispers are buffered and delivered on the next
633
+ // before_agent_start instead of immediately, preventing
634
+ // conversational adjacency confusion (the agent treating a
635
+ // between-turn whisper as user input). The auto-finalize callback
636
+ // (below) still delivers immediately because it uses
637
+ // deliverAs:"steer" and is time-critical (at ≥90% context the
638
+ // whisper may never get a next turn — steer it into the current run).
639
+ (msg) => {
640
+ const sid = getSessionIdSafe(ctx) ?? "anonymous";
641
+ bufferHeartbeatWhisper(sid, msg, "medium", "heartbeat/policy");
642
+ }, (msg) => {
643
+ sendTrackedMessage(pi, {
644
+ customType: "heartbeat",
645
+ content: [{ type: "text", text: msg }],
646
+ display: true,
647
+ }, { delivery: "live", deliverAs: "steer" }, { type: "heartbeat", source: "heartbeat/auto-finalize" });
648
+ });
649
+ for (const policy of defaultPolicies) {
650
+ engine.register(policy);
651
+ }
652
+ log.info(`Policy engine initialized with ${defaultPolicies.length} default policies (tool tracking active)`);
653
+ // Activate policy engine wrapper
654
+ activatePolicyEngine(engine, state, ctx);
655
+ // SOP Retrieval + Coach Decision
656
+ try {
657
+ const memState = getMemoryState(ctx);
658
+ if (memState) {
659
+ const project = ctx.cwd ?? "unknown";
660
+ const episodes = retrieveEpisodes(memState, project, 3, project);
661
+ if (episodes && episodes.length > 0) {
662
+ const topEpisode = episodes[0];
663
+ if (topEpisode.similarity > 0.3) {
664
+ // Recalled episode SOPs are fenced non-user context.
665
+ const sopSummary = fenceMemoryContext(formatSOPForWhisper(topEpisode));
666
+ // Deliver via the tracked channel so the whisper actually
667
+ // fires (ctx.whisper is a type-only augmentation, no runtime
668
+ // implementation) and carries the [braid-whisper - heartbeat]
669
+ // envelope.
670
+ sendSopCoachWhisper(pi, sopSummary);
671
+ log.info(`Coach: Whispered SOP from past episode ${topEpisode.id}`);
672
+ }
673
+ }
674
+ }
675
+ }
676
+ catch (err) {
677
+ log.debug(`SOP retrieval skipped: ${err.message}`);
678
+ }
679
+ });
680
+ // Event: turn_start - inject relevant SOPs from past episodes
681
+ pi.on("turn_start", async (_event, ctx) => {
682
+ try {
683
+ const memState = getMemoryState(ctx);
684
+ if (memState && memState.episodes) {
685
+ // The turn's user text is not on the event; consult the prompt
686
+ // captured at before_agent_start, falling back to the live branch.
687
+ const userText = getTurnStartPrompt(ctx).prompt || newestUserText(ctx);
688
+ if (userText.length > 5) {
689
+ try {
690
+ const sopState = getExtensionState(ctx, "sop-suggestion", () => ({
691
+ suggestedEpisodeIds: new Set(),
692
+ }));
693
+ // Derive project ID from cwd (last 2 path components)
694
+ const cwdParts = (ctx.cwd ?? "").replace(/\\/g, "/").split("/").filter(Boolean);
695
+ const currentProject = cwdParts.length >= 2 ? cwdParts.slice(-2).join("/") : (ctx.cwd ?? "unknown");
696
+ injectSopSuggestions(pi, ctx, userText, memState.episodes, sopState.suggestedEpisodeIds, currentProject);
697
+ }
698
+ catch {
699
+ // Non-fatal: basic suggestion without dedup
700
+ const cwdParts = (ctx.cwd ?? "").replace(/\\/g, "/").split("/").filter(Boolean);
701
+ const currentProject = cwdParts.length >= 2 ? cwdParts.slice(-2).join("/") : (ctx.cwd ?? "unknown");
702
+ injectSopSuggestions(pi, ctx, userText, memState.episodes, undefined, currentProject);
703
+ }
704
+ }
705
+ }
706
+ }
707
+ catch (err) {
708
+ log.debug(`SOP suggestion skipped: ${err.message}`);
709
+ }
710
+ });
711
+ // Event: agent_end
712
+ pi.on(AGENT_END, async (_event, ctx) => {
713
+ const state = getState(ctx);
714
+ // agent_end carries only `messages`; the run outcome is the final
715
+ // assistant message's stopReason, classified the way pi classifies its
716
+ // own activity outcome (agent-session _dispatchTurnEndBoundary).
717
+ const messages = Array.isArray(_event?.messages) ? _event.messages : [];
718
+ const lastAssistant = [...messages].reverse().find((m) => m?.role === "assistant");
719
+ const outcome = lastAssistant?.stopReason === "aborted"
720
+ ? "aborted"
721
+ : lastAssistant?.stopReason === "error"
722
+ ? "error"
723
+ : "completed";
724
+ log.info(`Session ended. Ticks: ${state.stats.totalTicks}, ` +
725
+ `Activations: ${state.stats.totalActivations}, ` +
726
+ `Tools: ${state.metaLearning.toolTracking.totalToolsUsed}, ` +
727
+ `Outcome: ${outcome}`);
728
+ for (const [name, count] of Object.entries(state.stats.activationsByModule)) {
729
+ log.info(` ${name}: ${count} activations`);
730
+ }
731
+ try {
732
+ const memState = getMemoryState(ctx);
733
+ if (memState) {
734
+ // agent_end carries no task descriptor; the sentinel is the fallback
735
+ // the write gate and the recall filter already expect.
736
+ const taskDesc = "session_outcome";
737
+ const success = outcome === "completed";
738
+ // Use enriched trajectory from tool_end tracking (has success/failure data)
739
+ // Fall back to activation history if tool_end wasn't available
740
+ const enrichedTrajectory = state.metaLearning.toolTracking.trajectory ?? [];
741
+ const trajectory = enrichedTrajectory.length > 0
742
+ ? enrichedTrajectory.map((t) => ({
743
+ toolName: t.toolName,
744
+ success: t.success,
745
+ }))
746
+ : state.activationHistory
747
+ .filter((h) => h.moduleName === "tool_call" || h.reason === "tool")
748
+ .map((h) => ({ toolName: h.moduleName, success: true }));
749
+ // Extract SOP from the trajectory (uses LLM pattern detection when ctx available)
750
+ const sop = await extractSOP({
751
+ task: taskDesc,
752
+ trajectory,
753
+ solution: `Ticks:${state.stats.totalTicks} Tools:${state.metaLearning.toolTracking.totalToolsUsed}`,
754
+ outcome: success ? "success" : "partial",
755
+ ctx,
756
+ });
757
+ // Review-before-write quality gate (hasSignal tripwire + settings
758
+ // toggle + cooldown) decides "is this episode worth writing?" before
759
+ // addEpisode on this sender. The shared hasSignal suppressor lives in
760
+ // lib/memory/write-quality.ts; the config is read fresh each event
761
+ // (settings-over-env via braid-settings.ts). Cooldown state is owned
762
+ // at module scope so back-to-back session ends never thrash. With the
763
+ // toggle OFF only the literal "session_outcome" sentinel kill applies.
764
+ const writeGate = getMemoryWriteGateConfig();
765
+ if (shouldWriteOutcomeEpisode(writeGate, taskDesc, sop.strategicSOP, _lastOutcomeWriteAt)) {
766
+ if (writeGate.enabled)
767
+ _lastOutcomeWriteAt = Date.now(); // gated writes only
768
+ addEpisode(memState, taskDesc, sop.strategicSOP, success ? "success" : "partial", sop.atomicSOP, ["session", "outcome", success ? "success" : "partial"], deriveProject(ctx), // project
769
+ sop.strategicSOP, sop.functionalSOP, sop.atomicSOP);
770
+ log.info(`[heartbeat] Outcome episode recorded: ${success ? "success" : "partial"} ` +
771
+ `(SOP: ${sop.functionalSOP.length} steps, ${sop.atomicSOP.length} tools)`);
772
+ }
773
+ else {
774
+ log.debug(`[heartbeat] Outcome episode skipped by write-quality gate ` +
775
+ `(task=${JSON.stringify(taskDesc)})`);
776
+ }
777
+ if (success) {
778
+ // Layer 6: gate consolidation on session health.
779
+ // When the LLM provider is unavailable (balance, auth) or the
780
+ // session is degraded, the consolidation pipeline is a 402
781
+ // waiting to happen. Score the candidate (so it persists) but
782
+ // skip execution; the SessionHealthState tracks this so the
783
+ // next healthy session drains the queue.
784
+ const health = getSessionHealth(ctx);
785
+ if (health.mode === "balance" || health.mode === "auth" || health.mode === "degraded") {
786
+ // Counts consolidation skips per health mode; without it, a
787
+ // latched auth mode runs for minutes with zero visibility.
788
+ recordConsolidationSkip(ctx, health.mode);
789
+ log.warn(`[heartbeat] Skipping consolidation: session health is ${health.mode} ` +
790
+ `(consecutive errors: ${health.consecutiveErrors})`);
791
+ // Still record the episode - we want the history even when we can't act on it.
792
+ // The episode will surface in the next healthy session via retrieveEpisodes().
793
+ }
794
+ else if (health.mode === "context_overflow") {
795
+ // Health-gate exception: a context_window error latches
796
+ // context_overflow and this gate then blocks every shrink that
797
+ // could fix it — the consolidation pipeline (an LLM call)
798
+ // is indeed a 402/413 waiting to happen in this mode, but the
799
+ // emergency offloader is NOT an LLM pipeline: it is a
800
+ // deterministic, lossless size-driven shrink (largest toolResults
801
+ // → disk + stubs). Run it here so the session actually shrinks
802
+ // while the mode is latched; consolidation itself stays skipped.
803
+ const runner = getContextEmergencyOffloadRunner();
804
+ if (runner) {
805
+ try {
806
+ const offload = await runner(ctx, "heartbeat-gate");
807
+ if (offload.offloaded > 0) {
808
+ log.warn(`[heartbeat] context_overflow: emergency offload freed ` +
809
+ `${offload.charsSaved} chars (${offload.offloaded} oversized ` +
810
+ `toolResult(s) stubbed); consolidation stays skipped in this mode`);
811
+ }
812
+ }
813
+ catch (err) {
814
+ log.warn(`[heartbeat] context_overflow emergency offload failed: ${err}`);
815
+ }
816
+ }
817
+ recordConsolidationSkip(ctx, "context_overflow");
818
+ }
819
+ else {
820
+ try {
821
+ const result = await executeConsolidation({
822
+ id: `ep-${Date.now()}`,
823
+ task: taskDesc,
824
+ outcome: "success",
825
+ strategicSOP: sop.strategicSOP,
826
+ functionalSOP: sop.functionalSOP,
827
+ toolSequence: sop.atomicSOP,
828
+ });
829
+ if (result) {
830
+ log.info(`[heartbeat] Consolidation candidate enqueued ` +
831
+ `(score=${result.consolidationScore.toFixed(2)})`);
832
+ }
833
+ }
834
+ catch (err) {
835
+ log.warn(`[heartbeat] Could not score consolidation candidate: ${err}`);
836
+ }
837
+ }
838
+ }
839
+ }
840
+ }
841
+ catch (err) {
842
+ log.warn(`[heartbeat] Could not record outcome episode: ${err}`);
843
+ }
844
+ });
845
+ // Event: session_shutdown
846
+ pi.on(SESSION_SHUTDOWN, async (_event, ctx) => {
847
+ // CleanupSession must target the SAME key the BeliefStore was
848
+ // created under (getSessionIdSafe at session_start), not just ctx.cwd —
849
+ // passing only ctx.cwd leaked the per-session store in the process-global
850
+ // stores/engines Maps whenever the key was a real session id. Delete
851
+ // both candidate keys defensively.
852
+ const shutdownSid = getSessionIdSafe(ctx);
853
+ if (shutdownSid && shutdownSid !== "?")
854
+ cleanupSession(shutdownSid);
855
+ cleanupSession(ctx.cwd);
856
+ const sid = getSessionIdSafe(ctx) ?? "anonymous";
857
+ _heartbeatWhisperBuffer.delete(sid);
858
+ // Abort any in-flight heartbeat LLM calls (ESC for background tasks)
859
+ const abortCtl = getExtensionState(ctx, "heartbeat-abort", () => ({ controller: null }));
860
+ if (abortCtl.controller) {
861
+ abortCtl.controller.abort();
862
+ abortCtl.controller = null;
863
+ }
864
+ log.info("Heartbeat scheduler shutting down");
865
+ });
866
+ // Policy Engine Activation
867
+ function activatePolicyEngine(engine, state, _ctx) {
868
+ const originalEvaluate = engine.evaluate.bind(engine);
869
+ engine.evaluate = async (context) => {
870
+ const fired = await originalEvaluate(context);
871
+ if (fired.length > 0) {
872
+ for (const policy of fired) {
873
+ state.policyLastFire.set(policy.id, state.policyTurnCount);
874
+ }
875
+ }
876
+ return fired;
877
+ };
878
+ log.info("[heartbeat] Policy engine activated - cognitive modules will fire on turns");
879
+ }
880
+ }
881
+ //# sourceMappingURL=index.js.map