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,977 @@
1
+ /**
2
+ * Context Lifecycle Extension - S-MMU Active Context Management
3
+ *
4
+ * AUTOMATION layer that works WITH context-manager.
5
+ * NO new tools - uses existing context_navigate, context_compress, etc.
6
+ *
7
+ * R-CCAM-inspired loop:
8
+ * - Retrieval: Signal detection from session content
9
+ * - Cognition: Policy evaluation with governance
10
+ * - Control: Action selection with constraint checking
11
+ * - Action: Proposal injection or immediate execution
12
+ * - Memory: CustomEntry persistence with outcome tracking
13
+ */
14
+ import { StringEnum } from "@earendil-works/pi-ai";
15
+ import { Type } from "typebox";
16
+ import { createLogger } from "../../../lib/core/logger.js";
17
+ import { applyWhisperEnvelope } from "../../../lib/utils/whisper-format.js";
18
+ import { formatTokensK } from "../../../lib/detection/context-usage.js";
19
+ import { existsSync, readFileSync } from "node:fs";
20
+ import * as path from "node:path";
21
+ import { braidDir, tagsSlugFromCwd } from "../../../lib/config/braid-paths.js";
22
+ import { registerSessionStartHandler, SessionPhase, } from "../../../lib/state/session-start-queue.js";
23
+ import { getExtensionState, getCachedSessionManager } from "../../../lib/state/extension-state.js";
24
+ import { getSessionManager } from "../../../lib/state/session-manager.js";
25
+ import { loadScratchpadFromDisk, projectSlugFromCwd } from "../../memory/scratchpad/persistence.js";
26
+ import { handleUpdateSession } from "../../memory/scratchpad/handlers.js";
27
+ import { eventBus } from "../../../lib/events/event-bus.js";
28
+ import { createProposal, createSnapshot, isProposalEntry, PROPOSAL_CUSTOM_TYPE, SNAPSHOT_CUSTOM_TYPE, } from "./types.js";
29
+ import { evaluatePolicies, generateDensitySignals } from "./policy-engine.js";
30
+ import { detectSignals, queueSignal, detectCompletionPattern } from "./signal-detector.js";
31
+ // Module State
32
+ const log = createLogger("context-lifecycle");
33
+ // Proposal rate limiting
34
+ const MAX_PROPOSALS_PER_TURN = 2;
35
+ const MAX_PROPOSALS_SESSION = 10;
36
+ // proposal real-need GATE + same-suggestion DEDUPE
37
+ // The benchmark measured context-lifecycle:proposal as the #1
38
+ // de-bloat target: 2,546 deliveries / 69,558 tokens at 4% acted-on, with
39
+ // 33% of deliveries being exact-repeat same-session bodies re-injected turn
40
+ // after turn. Two independent levers suppress that class at the single
41
+ // proposal-send chokepoint (queueProposal):
42
+ //
43
+ // GATE (fire only on real need): proposals triggered by PERSISTENT
44
+ // conditions (usage %, token counts, density) only fire when context
45
+ // state actually warrants them - usage above an actionable floor or a
46
+ // concrete compression signal present, the agent has NOT just acted on
47
+ // context, and the same suggestion class was not just declined.
48
+ // DEDUPE (never re-send a still-actionable suggestion): the same body ->
49
+ // same suggested tool is not re-sent within a session while the previous
50
+ // one is still actionable (pending, or delivered and not yet acted on).
51
+ //
52
+ // Each knob is a named constant so volume reduction and usefulness are
53
+ // independently adjustable, and urgency is preserved: a proposal whose usage
54
+ // crosses PROPOSAL_URGENT_USAGE (or is high-priority) bypasses both levers.
55
+ const PROPOSAL_ACTIONABLE_USAGE = 55; // [gate] below this %, advisory proposals = no real need (unless a density signal backs them)
56
+ // Token arm: the % floor is unreachable at
57
+ // a 1M window (20% ≈ 200k tokens) and a measured session fired ZERO
58
+ // high-context advisories across 154 turns at 150-238k tokens — persistent
59
+ // policies triggered on tokens but this gate suppressed them all. The gate
60
+ // now opens on EITHER arm: usage >= PROPOSAL_ACTIONABLE_USAGE OR tokens >=
61
+ // PROPOSAL_ACTIONABLE_TOKENS (min(percent, token) semantics).
62
+ const PROPOSAL_ACTIONABLE_TOKENS = USAGE_TOKENS_CRITICAL(); // [gate, tokens] either arm opens the gate (act arm, min(0.60W, 130k))
63
+ const PROPOSAL_ACTED_SUPPRESS_TURNS = 3; // [gate] quiet window after the agent acts on context (opportunity already taken)
64
+ const PROPOSAL_URGENT_USAGE = 75; // [gate] = USAGE_WHISPER_CRITICAL - genuinely urgent nudge bypasses gate + dedupe (keep urgency)
65
+ const PROPOSAL_URGENT_TOKENS = HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(); // [gate, tokens] hard-backstop band is urgent at any window
66
+ const PROPOSAL_DEDUPE_COOLDOWN_MS = 20 * 60 * 1000; // [dedupe] a delivered suggestion stays "in effect" this long (mirrors reprime)
67
+ const PROPOSAL_IGNORED_BACKOFF_TURNS = 8; // [dedupe/compliance, independent] after a same-class proposal was ignored, back off N turns
68
+ // Compaction Escalation Thresholds
69
+ // When the agent ignores 3+ compaction nudges at >=85% usage, auto-compact with timer.
70
+ const COMPACT_ESCALATION_THRESHOLD = 3;
71
+ const COMPACT_ESCALATION_USAGE = 85;
72
+ // Token constants for the ADVISORY path:
73
+ // single owner is lib/detection/context-thresholds.ts — import, never restate.
74
+ import { USAGE_TOKENS_CRITICAL, HYGIENE_AUTO_COMPACT_HARD_BACKSTOP, USAGE_TOKENS_ESCALATE, } from "../../../lib/detection/context-thresholds.js";
75
+ // Context management tools that count as "agent acted on compaction nudge"
76
+ const CONTEXT_MGMT_TOOLS = new Set([
77
+ "context_compress",
78
+ "context_inspect",
79
+ "context_navigate",
80
+ "context_proposals",
81
+ ]);
82
+ // Policy engine + signal-detector state are per-session fields of
83
+ // ContextLifecycleState (see ./state.ts): each session starts with a fresh
84
+ // engine + detector. Access via `state(ctx).policyEngine` / `.detector`.
85
+ // Outcome tracking (closed-loop feedback) with TTL eviction, session-scoped
86
+ const MAX_OUTCOMES = 100;
87
+ const OUTCOME_TTL_MS = 30 * 60 * 1000;
88
+ // Outcome interface now lives in ./state.ts (extracted to break the state<->helpers cycle)
89
+ function evictOldOutcomes(s) {
90
+ const now = Date.now();
91
+ const before = s.outcomes.length;
92
+ while (s.outcomes.length > 0 && now - s.outcomes[0].timestamp > OUTCOME_TTL_MS) {
93
+ s.outcomes.shift();
94
+ }
95
+ while (s.outcomes.length > MAX_OUTCOMES) {
96
+ s.outcomes.shift();
97
+ }
98
+ if (s.outcomes.length < before) {
99
+ log.info(`Evicted ${before - s.outcomes.length} old outcomes`);
100
+ }
101
+ }
102
+ // Note: turn_end handlers in this module use the session-scoped getState(ctx)
103
+ // pattern to read the latest state. Module-level `state()` is the fallback
104
+ // when ctx is not available.
105
+ import { state, resetState } from "./state.js";
106
+ // Note: state.ts types and functions are intentionally NOT re-exported.
107
+ // All consumers (this file, helpers.ts) access them via the import above.
108
+ // External callers should depend on `./state.js` directly if they need
109
+ // access to state types or functions. This removes the public-API surface
110
+ // area (it has zero external callers, so nothing depends on it).
111
+ // Schema
112
+ const contextProposalsSchema = Type.Object({
113
+ action: StringEnum(["list", "approve", "reject", "snapshots", "stats"]),
114
+ id: Type.Optional(Type.String({ description: "Proposal ID to approve/reject" })),
115
+ });
116
+ import { getContextUsage, getContextTokens, getAllEntries, getBranchEntries, readProposalsFromSession, readSnapshotsFromSession, formatDuration, interpolateMessage, proposalKeyFor, } from "./helpers.js";
117
+ // Re-export for backward compat
118
+ export { getContextUsage, getContextTokens, getAllEntries, getBranchEntries, readProposalsFromSession, readSnapshotsFromSession, formatDuration, interpolateMessage, proposalKeyFor, } from "./helpers.js";
119
+ // Action Execution
120
+ /**
121
+ * Send a compact nudge to the agent via tracked message. Shared by
122
+ * executeAction and the before_agent_start handler.
123
+ */
124
+ function sendCompactNudge(pi, evaluated, usage, tokens) {
125
+ // Tag/branch is preferred over compaction - preserves session history
126
+ // while freeing working context.
127
+ // Advisory ladder (token arms; single owner context-thresholds.ts):
128
+ // >= USAGE_TOKENS_ESCALATE (0.85W) escalated wording (archive-or-handoff)
129
+ // >= HARD_BACKSTOP (0.90W) or usage >= 80 full pipeline message
130
+ // else light tag/checkout message
131
+ // Percent stays as the secondary trigger (sub-1M windows).
132
+ const tokensK = formatTokensK(tokens);
133
+ const pipelineMsg = tokens >= USAGE_TOKENS_ESCALATE()
134
+ ? `Context at ${Math.round(usage)}% (~${tokensK} tokens). Escalated: archive the current phase with context_compress(action="archive"), or hand off to a fresh session (write a handoff note first).`
135
+ : usage >= 80 || tokens >= HYGIENE_AUTO_COMPACT_HARD_BACKSTOP()
136
+ ? `Context at ${Math.round(usage)}% (~${tokensK} tokens). Pipeline: context_navigate(action="tag") -> context_navigate(action="checkout") -> context_compress(action="archive") -> context_compress(action="slide").`
137
+ : `Context at ${Math.round(usage)}% (~${tokensK} tokens). Tag with context_navigate(action="tag"), then context_navigate(action="checkout") to branch with a summary.`;
138
+ sendTrackedMessage(pi, {
139
+ customType: "context-lifecycle",
140
+ content: [
141
+ {
142
+ type: "text",
143
+ text: `${evaluated.policy.name} - ${pipelineMsg}`,
144
+ },
145
+ ],
146
+ display: true,
147
+ details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "context-lifecycle/compact-suggestion" },
148
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/compact-suggestion" });
149
+ log.info(`Suggested compact: ${evaluated.policy.name} (context ${Math.round(usage)}%, ` +
150
+ `priority ${evaluated.policy.priority})`);
151
+ }
152
+ /**
153
+ * Execute auto-compaction.
154
+ * This is the escalation path: when the agent ignores compaction nudges,
155
+ * we auto-trigger compaction. The agent loop automatically continues after
156
+ * compaction completes (pi-core's _runAutoCompaction() returns `true` →
157
+ * agent.continue()). No resume timer is needed.
158
+ */
159
+ async function executeAutoCompact(pi, ctx) {
160
+ try {
161
+ // 1. Cancel stale resume timers from previous compaction cycles
162
+ try {
163
+ // Cancel any stale resume timer from a previous compaction cycle
164
+ // (manual or auto). Without this, an old timer can fire later during
165
+ // an unrelated TURN_END and produce a stray [timer] whisper.
166
+ //
167
+ // CRITICAL: scope to current session - see the timer module for why:
168
+ // an unscoped timer map leaks across pi sessions.
169
+ const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "anonymous";
170
+ timerMod.cancelTimersByTag(sessionId, "compaction-resume");
171
+ timerMod.cancelTimersByTag(sessionId, "auto-compaction-resume");
172
+ // NOTE: no scheduleTimer() here — pi-core's agent loop automatically
173
+ // continues after compaction (_runAutoCompaction() returns `true` →
174
+ // agent.continue()); a fallback resume timer fires as spurious noise
175
+ // the agent ignores.
176
+ }
177
+ catch {
178
+ log.warn("Timer unavailable for auto-compaction - agent must type to resume");
179
+ }
180
+ // 2. Send visible notification
181
+ sendTrackedMessage(pi, {
182
+ customType: "context-lifecycle",
183
+ content: [
184
+ {
185
+ type: "text",
186
+ text: [
187
+ "## ⚡ Auto-compacting context",
188
+ "Compaction nudges were ignored. Auto-tagging then compacting to prevent overflow.",
189
+ 'Use context_navigate(action="tag") proactively next time to avoid losing the completion summary.',
190
+ ].join("\n"),
191
+ },
192
+ ],
193
+ display: true,
194
+ details: { [BRAID_INJECTED]: true, [BRAID_SOURCE]: "context-lifecycle/auto-compact" },
195
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/auto-compact" });
196
+ // 3. Trigger compaction (this aborts the agent loop, timer resumes later)
197
+ ctx.compact();
198
+ log.warn("Auto-compaction triggered (escalation path)");
199
+ }
200
+ catch (err) {
201
+ log.error("Auto-compaction failed:", err);
202
+ }
203
+ }
204
+ function executeAction(evaluated, pi, ctx, usage, branchLength) {
205
+ const action = evaluated.action;
206
+ switch (action.type) {
207
+ case "compact":
208
+ if (evaluated.canExecute) {
209
+ // Advisory wording ladder also token-gated (see sendCompactNudge).
210
+ sendCompactNudge(pi, evaluated, usage, getContextTokens(ctx));
211
+ }
212
+ break;
213
+ case "snapshot":
214
+ if (evaluated.canExecute) {
215
+ const snapshot = createSnapshot(action.reason, branchLength, Math.round(usage * 2));
216
+ pi.appendEntry(SNAPSHOT_CUSTOM_TYPE, snapshot);
217
+ log.debug(`Created snapshot: ${snapshot.id}`);
218
+ }
219
+ break;
220
+ case "nudge":
221
+ if (evaluated.canExecute) {
222
+ const msg = interpolateMessage(action.message, ctx, evaluated.signal?.data);
223
+ // Non-critical context awareness - use hint, visible in TUI but no hidden turn
224
+ sendTrackedMessage(pi, {
225
+ customType: "context-lifecycle",
226
+ content: [{ type: "text", text: msg }],
227
+ display: true,
228
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/nudge" });
229
+ }
230
+ break;
231
+ }
232
+ }
233
+ // proposal gate + dedupe helpers
234
+ /**
235
+ * True when an evaluated propose-action carries a concrete compression
236
+ * signal (density low / high / duplicates / redundancy). Presence of such a
237
+ * signal means there IS a real need even when usage % looks low.
238
+ */
239
+ function hasConcreteCompressionSignal(evaluated) {
240
+ const t = evaluated.signal?.type;
241
+ return (t === "context_density_low" ||
242
+ t === "context_density_high" ||
243
+ t === "context_duplicates" ||
244
+ t === "redundancy_detected");
245
+ }
246
+ /**
247
+ * Proposals triggered by PERSISTENT conditions - usage %, token counts,
248
+ * density - stay true across turns, so the policy re-fires every cooldown
249
+ * with a fresh copy of the SAME advice ("Context at 55%. Consider archive").
250
+ * This is the measured 33% exact-repeat class. Event-triggered proposals
251
+ * (topic_shift, task_boundary, task_complexity, decision_density,
252
+ * task_completion_candidate) fire on discrete moments and are NOT this class
253
+ * - they skip the real-need gate but still pass through the dedupe.
254
+ */
255
+ function isPersistentConditionProposal(evaluated) {
256
+ const trigger = evaluated.policy.trigger;
257
+ if (trigger.type === "context_usage" || trigger.type === "context_usage_tokens")
258
+ return true;
259
+ if (trigger.type === "signal") {
260
+ switch (trigger.signal) {
261
+ case "context_pressure":
262
+ case "context_density_low":
263
+ case "context_density_high":
264
+ case "context_duplicates":
265
+ case "redundancy_detected":
266
+ case "compaction_opportunity":
267
+ case "checkpoint_opportunity":
268
+ return true;
269
+ default:
270
+ return false;
271
+ }
272
+ }
273
+ return false;
274
+ }
275
+ /**
276
+ * Genuinely urgent nudge - bypasses the gate + dedupe so a critical
277
+ * compact/archive suggestion still lands with its current delivery behavior.
278
+ */
279
+ function isUrgentProposal(evaluated, usage, tokens) {
280
+ if (evaluated.action.type === "propose" && evaluated.action.priority === "high")
281
+ return true;
282
+ // Urgent on EITHER arm — percent band (sub-1M windows) or the
283
+ // hard-backstop token band (any window).
284
+ if (usage >= PROPOSAL_URGENT_USAGE)
285
+ return true;
286
+ if (tokens >= PROPOSAL_URGENT_TOKENS)
287
+ return true;
288
+ const percent = evaluated.signal?.data?.percent ?? 0;
289
+ return evaluated.signal?.type === "context_pressure" && percent >= PROPOSAL_URGENT_USAGE;
290
+ }
291
+ /**
292
+ * Seed the per-session dedupe map from persisted proposals so a resumed /
293
+ * compacted session does not re-inject a suggestion that was already delivered
294
+ * (persisted custom_message entries are replayed into context). Runs once per
295
+ * session (lazy) - state is fresh on session_start.
296
+ */
297
+ function ensureProposalKeysSeeded(ctx, existingProposals) {
298
+ const s = state(ctx);
299
+ if (s.proposalKeysSeeded)
300
+ return;
301
+ s.proposalKeysSeeded = true;
302
+ for (const p of existingProposals) {
303
+ const key = proposalKeyFor(p.message, p.suggested_action);
304
+ if (!s.proposalKeys.has(key)) {
305
+ s.proposalKeys.set(key, p.created_at);
306
+ }
307
+ }
308
+ }
309
+ /**
310
+ * Decide whether a candidate propose-action should be suppressed before it
311
+ * reaches the agent. Returns a human-readable reason string, or null to allow
312
+ * delivery. This is the SINGLE decision point for the proposal-noise class -
313
+ * both the real-need gate and the same-suggestion dedupe live here.
314
+ */
315
+ function proposeSuppressionCause(ctx, evaluated, existingProposals, usage, tokens) {
316
+ if (evaluated.action.type !== "propose")
317
+ return null;
318
+ const s = state(ctx);
319
+ const now = Date.now();
320
+ const isUrgent = isUrgentProposal(evaluated, usage, tokens);
321
+ const key = proposalKeyFor(interpolateMessage(evaluated.action.message, ctx, evaluated.signal?.data), evaluated.policy.suggested_action);
322
+ // GATE: persistent-condition proposals need a real need
323
+ if (isPersistentConditionProposal(evaluated) && !isUrgent) {
324
+ // (a) No actionable need: usage below the floor AND no concrete
325
+ // compression signal backs this advisory re-fire.
326
+ // Token arm: either arm satisfies the floor (min(percent, token)).
327
+ if (usage < PROPOSAL_ACTIONABLE_USAGE &&
328
+ tokens < PROPOSAL_ACTIONABLE_TOKENS &&
329
+ !hasConcreteCompressionSignal(evaluated)) {
330
+ return "no-actionable-need";
331
+ }
332
+ // (b) Agent just acted on context - the opportunity was taken / is being
333
+ // handled; a fresh advisory would fight the action it just took.
334
+ if (s.lastContextActionTurn > 0 &&
335
+ s.turnCount - s.lastContextActionTurn <= PROPOSAL_ACTED_SUPPRESS_TURNS) {
336
+ return "agent-just-acted";
337
+ }
338
+ // (c) Compliance feedback: the agent declined this exact suggestion class
339
+ // via context_proposals reject - back off re-proposing it.
340
+ if (s.declinedKeys.has(key)) {
341
+ return "declined-same-class";
342
+ }
343
+ }
344
+ // DEDUPE: same suggestion must not re-send while still actionable
345
+ if (!isUrgent) {
346
+ // Persisted pending proposal of the same class = already delivered and
347
+ // unresolved (still actionable), and persisted entries are replayed into
348
+ // context on resume - re-sending would double-inject.
349
+ if (existingProposals.some((p) => !p.resolution && proposalKeyFor(p.message, p.suggested_action) === key)) {
350
+ return "proposal-pending";
351
+ }
352
+ // Session-hot: we delivered this class and the agent has not acted since
353
+ // (proposalKeys is cleared on action) - keep it suppressed for the window.
354
+ const lastSentAt = s.proposalKeys.get(key);
355
+ if (lastSentAt !== undefined && now - lastSentAt < PROPOSAL_DEDUPE_COOLDOWN_MS) {
356
+ return "repeat-session";
357
+ }
358
+ // Compliance feedback: a same-class suggestion was ignored recently
359
+ // (implicitly approved = agent never acted) - back off for an independent,
360
+ // session-scoped window so usefulness and volume are separately tunable.
361
+ const ignoredTurn = s.proposalIgnoredTurns.get(key);
362
+ if (ignoredTurn !== undefined && s.turnCount - ignoredTurn <= PROPOSAL_IGNORED_BACKOFF_TURNS) {
363
+ return "ignored-backoff";
364
+ }
365
+ }
366
+ return null;
367
+ }
368
+ async function queueProposal(evaluated, pi, ctx, branchLength) {
369
+ if (evaluated.action.type !== "propose")
370
+ return;
371
+ const action = evaluated.action;
372
+ const existingEntries = getAllEntries(ctx);
373
+ const existingProposals = readProposalsFromSession(existingEntries);
374
+ const usage = getContextUsage(ctx);
375
+ const tokens = getContextTokens(ctx);
376
+ // real-need GATE + same-suggestion DEDUPE
377
+ // Seed the per-session dedupe map from persisted proposals (resume /
378
+ // compaction replay must not re-inject), then decide in ONE place whether
379
+ // this candidate may reach the agent. Possible reasons:
380
+ // no-actionable-need / agent-just-acted / declined-same-class /
381
+ // proposal-pending / repeat-session / ignored-backoff
382
+ ensureProposalKeysSeeded(ctx, existingProposals);
383
+ const suppressReason = proposeSuppressionCause(ctx, evaluated, existingProposals, usage, tokens);
384
+ if (!suppressReason) {
385
+ // Rate limiting: only delivered proposals consume the caps
386
+ state(ctx).proposalsThisTurn++;
387
+ state(ctx).proposalsTotal++;
388
+ if (state(ctx).proposalsThisTurn > MAX_PROPOSALS_PER_TURN) {
389
+ log.debug(`Rate limited: ${state(ctx).proposalsThisTurn} proposals this turn (max ${MAX_PROPOSALS_PER_TURN})`);
390
+ }
391
+ else if (state(ctx).proposalsTotal > MAX_PROPOSALS_SESSION) {
392
+ log.debug(`Session limit reached: ${state(ctx).proposalsTotal} proposals (max ${MAX_PROPOSALS_SESSION})`);
393
+ }
394
+ else {
395
+ const proposal = createProposal("compact", interpolateMessage(action.message, ctx, evaluated.signal?.data), evaluated.policy.id, branchLength, action.priority, 0.7, evaluated.policy.suggested_action);
396
+ const sm = getCachedSessionManager(ctx);
397
+ // Apply the universal whisper envelope + [braid-whisper-end] marker to
398
+ // the proposal content array. appendCustomMessageEntry bypasses the
399
+ // sendTrackedMessage trunk, so the envelope must be applied here -- this
400
+ // is the sole call site for that channel. The end-marker is essential
401
+ // because the proposal is persisted as a custom_message entry and replayed
402
+ // into agent context on session resume/compaction: without it the agent
403
+ // has no unambiguous boundary for the suggestion body.
404
+ const proposalContent = [
405
+ { type: "text", text: `Context Suggestion: ${proposal.message}` },
406
+ ];
407
+ // The envelope source was "memory/context-lifecycle",
408
+ // whose first segment maps to `[braid-whisper - memory]` — misattributing
409
+ // these context-lifecycle proposal bodies to the memory family (114
410
+ // measured deliveries). The source must be the TRUE family, so the
411
+ // envelope says context-lifecycle.
412
+ applyWhisperEnvelope(proposalContent, "context-lifecycle/proposal");
413
+ sm?.appendCustomMessageEntry?.(PROPOSAL_CUSTOM_TYPE, proposalContent, true, proposal);
414
+ // Record the suggestion class so a repeat re-fire is suppressed while
415
+ // this one is still actionable (gate + dedupe rely on this map).
416
+ state(ctx).proposalKeys.set(proposalKeyFor(proposal.message, proposal.suggested_action), Date.now());
417
+ log.debug(`Created proposal: ${proposal.id}`);
418
+ }
419
+ }
420
+ else {
421
+ log.info(`Proposal suppressed (${suppressReason}) policy=${evaluated.policy.id} "${action.message.slice(0, 48)}"`);
422
+ }
423
+ // Phase boundary enforcement: upgrade topic_shift and task_boundary
424
+ // proposals to enforcement whispers with auto-tagging. This ensures the
425
+ // agent preserves context before switching between investigation,
426
+ // implementation, and verification phases.
427
+ if (evaluated.signal?.type === "topic_shift" || evaluated.signal?.type === "task_boundary") {
428
+ const signalType = evaluated.signal.type;
429
+ const signalData = evaluated.signal.data || {};
430
+ // Auto-tag current position
431
+ let tagName;
432
+ if (signalType === "topic_shift") {
433
+ const to = signalData.to || "next-phase";
434
+ tagName = `before-${to}`;
435
+ }
436
+ else {
437
+ tagName = `before-task-boundary`;
438
+ }
439
+ try {
440
+ const sessionManager = getSessionManager(ctx);
441
+ const leafId = sessionManager.getLeafId();
442
+ pi.setLabel(leafId, tagName);
443
+ log.info(`Auto-tagged position as "${tagName}" on ${signalType} signal`);
444
+ }
445
+ catch (err) {
446
+ log.debug(`Auto-tag failed (non-fatal): ${err}`);
447
+ }
448
+ // Auto-set SessionPhase in scratchpad when topic_shift is detected
449
+ if (signalType === "topic_shift") {
450
+ const to = signalData.to || "";
451
+ const phaseMap = {
452
+ exploration: "exploring",
453
+ implementation: "implementing",
454
+ verification: "verifying",
455
+ debugging: "debugging",
456
+ documentation: "documenting",
457
+ planning: "planning",
458
+ testing: "verifying",
459
+ refactoring: "implementing",
460
+ };
461
+ const newPhase = phaseMap[to];
462
+ if (newPhase) {
463
+ try {
464
+ const cwd = ctx.cwd ?? "";
465
+ const slug = projectSlugFromCwd(cwd);
466
+ const pad = await loadScratchpadFromDisk(slug);
467
+ if (pad) {
468
+ await handleUpdateSession(pad, { phase: newPhase, turn: state(ctx).turnCount });
469
+ log.info(`Auto-set scratchpad phase to "${newPhase}"`);
470
+ }
471
+ }
472
+ catch (err) {
473
+ log.debug(`Auto-set SessionPhase failed (non-fatal): ${err}`);
474
+ }
475
+ }
476
+ }
477
+ // Send enforcement whisper with triggerTurn to wake the agent
478
+ const msg = signalType === "topic_shift"
479
+ ? `**Phase transition detected:** from "${signalData.from || "previous"}" to "${signalData.to || "next"}".\n\n` +
480
+ `Auto-tagged position as \`${tagName}\`. Use \`context_navigate(action="checkout", target="${tagName}")\` to return to this point.\n\n` +
481
+ `Update your scratchpad phase: \`scratchpad(action="update_session", phase="${signalData.to || "implementing"}")\`.\n\n` +
482
+ `Consider archiving the previous phase with \`context_compress(action="archive", topic="${signalData.from || "previous"}")\` to free context.`
483
+ : `**Task boundary detected** (explore → implement → verify pattern).\n\n` +
484
+ `Auto-tagged position as \`${tagName}\`. Consider archiving the current phase with \`context_compress(action="archive")\` before proceeding.`;
485
+ sendTrackedMessage(pi, {
486
+ customType: "context-lifecycle",
487
+ content: [{ type: "text", text: msg }],
488
+ display: true,
489
+ }, { deliverAs: "steer", triggerTurn: true }, { type: "context", source: "context-lifecycle/phase-boundary-enforcement" });
490
+ // Track navigation whisper for escalation monitoring
491
+ state(ctx).lastNavigationWhisperTurn = state(ctx).turnCount;
492
+ }
493
+ }
494
+ // Extension Factory
495
+ import { clearInjections, sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
496
+ import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
497
+ import { TOOL_CALL } from "../../../lib/core/event-names.js";
498
+ import * as timerMod from "../../scheduling/timer/index.js";
499
+ export default function contextLifecycleExtension(pi) {
500
+ // session_start
501
+ registerSessionStartHandler(pi, SessionPhase.MemoryState, async (_event, ctx) => {
502
+ resetState(ctx);
503
+ // state(ctx) is fresh per session; the policy
504
+ // engine and signal detector live inside the per-session state, so
505
+ // no manual reset is needed for them. clearInjections() is a
506
+ // process-global tracker (see lib/utils/injection-tracker.ts) and
507
+ // must be cleared explicitly on session boundaries.
508
+ state(ctx).outcomes.length = 0;
509
+ clearInjections();
510
+ });
511
+ // Subscribe to memory_evict events to adjust compact nudge escalation
512
+ eventBus.on("memory_evict", (event) => {
513
+ log.debug(`[context-lifecycle] Memory eviction: ${event.reason} (${event.count} entries)`);
514
+ // Large evictions increase compact urgency for the next proposal check
515
+ if (event.count > 5) {
516
+ const s = state();
517
+ s.ignoredCompactNudges = Math.min(5, s.ignoredCompactNudges + 1);
518
+ }
519
+ });
520
+ // before_agent_start
521
+ // R-CCAM loop: Retrieval -> Cognition -> Control -> Action
522
+ pi.on("before_agent_start", async (_event, ctx) => {
523
+ // RE-ENTRANCY GUARD
524
+ // If sendTrackedMessage -> pi.sendMessage(steer) fires before_agent_start
525
+ // synchronously, prevent unbounded recursion. Without this guard, a
526
+ // nudge that triggers a steer can create a loop:
527
+ // before_agent_start -> sendCompactNudge -> sendTrackedMessage ->
528
+ // pi.sendMessage(steer) -> before_agent_start -> ... (stack overflow)
529
+ const reentrancy = getExtensionState(ctx, "context-lifecycle/reentrancy", () => ({
530
+ inBeforeAgentStart: false,
531
+ }));
532
+ if (reentrancy.inBeforeAgentStart) {
533
+ log.warn("Re-entrant before_agent_start detected - skipping to prevent stack overflow");
534
+ return;
535
+ }
536
+ reentrancy.inBeforeAgentStart = true;
537
+ try {
538
+ state(ctx).turnCount++;
539
+ state(ctx).proposalsThisTurn = 0; // Reset per-turn counter
540
+ // Evict old outcomes on each turn (sliding window TTL)
541
+ evictOldOutcomes(state(ctx));
542
+ const usage = getContextUsage(ctx);
543
+ const entries = getAllEntries(ctx);
544
+ const branch = getBranchEntries(ctx);
545
+ // COMPACTION ESCALATION CHECK
546
+ // If we sent a compact nudge last turn and the agent didn't use any
547
+ // context management tool, increment the ignored counter.
548
+ // If they DID use a tool, reset the counter.
549
+ if (state(ctx).compactNudgeActive) {
550
+ if (state(ctx).agentActedOnContext) {
551
+ state(ctx).ignoredCompactNudges = 0;
552
+ state(ctx).compactNudgeActive = false;
553
+ log.debug("Compact nudge acknowledged - agent used a context management tool");
554
+ }
555
+ else if (state(ctx).turnCount - state(ctx).lastCompactNudgeTurn > 0) {
556
+ // Agent had a turn to respond but didn't act
557
+ state(ctx).ignoredCompactNudges++;
558
+ log.info(`Compact nudge ignored (${state(ctx).ignoredCompactNudges}/${COMPACT_ESCALATION_THRESHOLD}) ` +
559
+ `usage=${usage.toFixed(0)}%`);
560
+ }
561
+ }
562
+ // NAVIGATION PROPOSAL ESCALATION
563
+ // Mirror the compaction escalation pattern: if the agent ignores
564
+ // navigation enforcement whispers, increment the count and escalate.
565
+ // The enforcement whisper is sent from queueProposal() with triggerTurn.
566
+ // If the agent ignores 3+ whispers, auto-tag and send a stronger message.
567
+ if (state(ctx).lastNavigationWhisperTurn > 0) {
568
+ if (state(ctx).agentActedOnContext) {
569
+ state(ctx).ignoredNavigationProposals = 0;
570
+ log.debug("Navigation proposal acknowledged - agent used a context management tool");
571
+ }
572
+ else if (state(ctx).turnCount - state(ctx).lastNavigationWhisperTurn > 0) {
573
+ state(ctx).ignoredNavigationProposals++;
574
+ log.info(`Navigation proposal ignored (${state(ctx).ignoredNavigationProposals}/3)`);
575
+ // Escalate: after 3 ignored proposals, auto-tag and send stronger whisper
576
+ if (state(ctx).ignoredNavigationProposals >= 3) {
577
+ state(ctx).ignoredNavigationProposals = 0;
578
+ state(ctx).lastNavigationWhisperTurn = 0;
579
+ // Auto-tag position
580
+ try {
581
+ const sm = getSessionManager(ctx);
582
+ const leafId = sm.getLeafId();
583
+ pi.setLabel(leafId, `auto-tag-${state(ctx).turnCount}`);
584
+ log.info(`Auto-tagged position on escalation (turn ${state(ctx).turnCount})`);
585
+ }
586
+ catch {
587
+ // Session manager may be detached mid-escalation; the tag is
588
+ // cosmetic — navigation still works untagged.
589
+ }
590
+ sendTrackedMessage(pi, {
591
+ customType: "context-lifecycle",
592
+ content: [
593
+ {
594
+ type: "text",
595
+ text: `## ⚡ Navigation enforcement escalated\n\n` +
596
+ `Navigation proposals were ignored ${COMPACT_ESCALATION_THRESHOLD} times. ` +
597
+ `Auto-tagged current position.\n\n` +
598
+ `Use \`context_compress(action="archive")\` to free context before continuing.\n` +
599
+ `Use \`context_navigate(action="checkout", target="auto-tag-${state(ctx).turnCount}")\` to return to this point.`,
600
+ },
601
+ ],
602
+ display: true,
603
+ }, { deliverAs: "steer", triggerTurn: true }, { type: "context", source: "context-lifecycle/navigation-escalation" });
604
+ }
605
+ }
606
+ }
607
+ state(ctx).agentActedOnContext = false;
608
+ // RETRIEVAL: Detect signals from session content
609
+ const s = state(ctx);
610
+ const signals = await detectSignals(s.detector, entries, ctx, usage);
611
+ // DENSITY: Generate context density signals (SimpleMem 2601.02553)
612
+ // These feed into density-aware policies (prune, compress, dedup)
613
+ const densitySignals = generateDensitySignals(ctx);
614
+ if (densitySignals.length > 0) {
615
+ signals.push(...densitySignals);
616
+ }
617
+ // COGNITION: Evaluate policies against signals
618
+ const redundancyCount = signals.filter((s) => s.type === "redundancy_detected").length;
619
+ // TASK COMPLETION DETECTION
620
+ if (detectCompletionPattern(s.detector)) {
621
+ queueSignal(s.detector, "task_completion_candidate", {
622
+ topicHistory: s.detector.topicHistory.slice(-3),
623
+ uniqueTools: new Set(s.detector.toolSequence.slice(-10)).size,
624
+ });
625
+ }
626
+ const completionSignals = [...s.detector.pendingSignals];
627
+ s.detector.pendingSignals = [];
628
+ if (completionSignals.length > 0) {
629
+ signals.push(...completionSignals);
630
+ }
631
+ const evaluated = evaluatePolicies(s.policyEngine, {
632
+ signals,
633
+ contextUsage: usage,
634
+ contextTokens: getContextTokens(ctx),
635
+ turnCount: branch.length,
636
+ redundancyCount,
637
+ });
638
+ // CONTROL: Validate and select actions
639
+ for (const ev of evaluated) {
640
+ if (!ev.validation.valid) {
641
+ log.warn(`Governance blocked: ${ev.validation.messages.join(", ")}`);
642
+ }
643
+ else if (ev.validation.severity === "warn") {
644
+ log.warn(`Governance warning: ${ev.validation.messages.join(", ")}`);
645
+ }
646
+ // ACTION: Execute or queue
647
+ if (ev.action.type === "propose") {
648
+ await queueProposal(ev, pi, ctx, branch.length);
649
+ }
650
+ else if (ev.action.type === "compact" && ev.canExecute) {
651
+ // ESCALATION GATE
652
+ // If the agent has ignored 3+ compaction nudges and context is
653
+ // still above 85%, auto-compact with a pre-scheduled resume timer.
654
+ // This avoids the mid-task overflow death spiral (scenario 2.2).
655
+ if (state(ctx).ignoredCompactNudges >= COMPACT_ESCALATION_THRESHOLD &&
656
+ usage >= COMPACT_ESCALATION_USAGE) {
657
+ log.warn(`Escalating: auto-compacting (${state(ctx).ignoredCompactNudges} ignored nudges, ` +
658
+ `usage=${usage.toFixed(0)}%)`);
659
+ await executeAutoCompact(pi, ctx);
660
+ state(ctx).ignoredCompactNudges = 0;
661
+ state(ctx).compactNudgeActive = false;
662
+ }
663
+ else {
664
+ // Normal: send compact nudge
665
+ sendCompactNudge(pi, ev, usage, getContextTokens(ctx));
666
+ state(ctx).compactNudgeActive = true;
667
+ state(ctx).lastCompactNudgeTurn = state(ctx).turnCount;
668
+ state(ctx).lastCompactNudgeUsage = usage;
669
+ }
670
+ }
671
+ else {
672
+ executeAction(ev, pi, ctx, usage, branch.length);
673
+ }
674
+ }
675
+ // MEMORY: Track implicit approvals
676
+ const proposalEntries = entries.filter(isProposalEntry);
677
+ for (const entry of proposalEntries) {
678
+ const proposal = entry.details;
679
+ if (proposal?.resolution)
680
+ continue;
681
+ if (Date.now() - proposal.created_at > 120_000) {
682
+ proposal.resolution = "implicit_approved";
683
+ proposal.resolved_at = Date.now();
684
+ state(ctx).proposalsByEntryId.set(entry.id, proposal);
685
+ // Track outcome for closed-loop feedback
686
+ state(ctx).outcomes.push({
687
+ proposalId: proposal.id,
688
+ resolution: "implicit_approved",
689
+ turnsToResolve: state(ctx).turnCount - proposal.turn,
690
+ timestamp: Date.now(),
691
+ });
692
+ // A same-class suggestion the agent never acted on
693
+ // was implicitly approved = ignored. Record the class so the
694
+ // compliance-feedback backoff suppresses re-proposing it for
695
+ // PROPOSAL_IGNORED_BACKOFF_TURNS.
696
+ state(ctx).proposalIgnoredTurns.set(proposalKeyFor(proposal.message, proposal.suggested_action), state(ctx).turnCount);
697
+ }
698
+ }
699
+ }
700
+ finally {
701
+ reentrancy.inBeforeAgentStart = false;
702
+ }
703
+ });
704
+ // tool_call: Capture agent signals + compaction escalation reset
705
+ pi.on(TOOL_CALL, async (event, ctx) => {
706
+ const toolName = event.toolName;
707
+ // Task boundary signals
708
+ const detectorState = state(ctx).detector;
709
+ if (toolName === "context_navigate") {
710
+ const action = event.input?.action;
711
+ if (action === "tag") {
712
+ queueSignal(detectorState, "task_boundary", { action: "tag", target: toolName });
713
+ }
714
+ else if (action === "checkout") {
715
+ queueSignal(detectorState, "task_boundary", { action: "checkout" });
716
+ }
717
+ }
718
+ else if (toolName === "context_compress") {
719
+ const action = event.input?.action;
720
+ if (action === "archive" || action === "compact") {
721
+ queueSignal(detectorState, "task_boundary", { action: "compress" });
722
+ }
723
+ }
724
+ // Compaction escalation reset
725
+ // If the agent calls any context management tool, the compaction nudge
726
+ // is considered "acted upon" and we reset the escalation counter.
727
+ if (CONTEXT_MGMT_TOOLS.has(toolName)) {
728
+ state(ctx).agentActedOnContext = true;
729
+ state(ctx).ignoredCompactNudges = 0;
730
+ state(ctx).compactNudgeActive = false;
731
+ state(ctx).ignoredNavigationProposals = 0;
732
+ // The agent acted on a context suggestion — re-arm
733
+ // the proposal dedupe (the actionable suggestions are no longer
734
+ // pending) and remember the turn so recently-acting suppresses fresh
735
+ // advisory proposals instead of fighting the action just taken.
736
+ state(ctx).proposalKeys.clear();
737
+ state(ctx).lastContextActionTurn = state(ctx).turnCount;
738
+ log.debug(`Context management tool "${toolName}" called - reset compaction and navigation escalation`);
739
+ }
740
+ // Auto-navigate back to investigation checkpoint
741
+ // When the agent finalizes a task, check if there are tagged checkpoints
742
+ // from the investigation phase and suggest navigating back.
743
+ if (toolName === "finalize") {
744
+ try {
745
+ const sm = getSessionManager(ctx);
746
+ const branch = sm.getBranch();
747
+ const tags = [];
748
+ for (const entry of branch) {
749
+ try {
750
+ const label = sm.getLabel(entry.id);
751
+ if (label && label.startsWith("before-")) {
752
+ tags.push(label);
753
+ }
754
+ }
755
+ catch {
756
+ // entry may not have a label
757
+ }
758
+ }
759
+ const cwd = ctx.cwd ?? "";
760
+ const slug = tagsSlugFromCwd(cwd);
761
+ const tagsFile = path.join(braidDir(), "tags", `${slug}.json`);
762
+ let fileTags = [];
763
+ try {
764
+ if (existsSync(tagsFile)) {
765
+ const content = readFileSync(tagsFile, "utf-8");
766
+ fileTags = Object.keys(JSON.parse(content)).filter((t) => t.startsWith("before-"));
767
+ }
768
+ }
769
+ catch {
770
+ // Corrupt/absent tags file — proposal merge proceeds with session
771
+ // tags only; nothing durable is at risk.
772
+ }
773
+ const allTags = [...new Set([...tags, ...fileTags])];
774
+ if (allTags.length > 0) {
775
+ const tagList = allTags
776
+ .slice(0, 3)
777
+ .map((t) => `\`${t}\``)
778
+ .join(", ");
779
+ sendTrackedMessage(pi, {
780
+ customType: "context-lifecycle",
781
+ content: [
782
+ {
783
+ type: "text",
784
+ text: `Task finalized. Previous investigation checkpoints found: ${tagList}.\n\n` +
785
+ `Navigate back to review: \`context_navigate(action="checkout", target="${allTags[0]}")\`\n` +
786
+ `Use \`context_compress(action="archive")\` to free context before starting the next phase.`,
787
+ },
788
+ ],
789
+ display: true,
790
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "context-lifecycle/navigate-back-suggestion" });
791
+ log.info(`Suggested navigating back to checkpoint: ${allTags[0]}`);
792
+ }
793
+ }
794
+ catch {
795
+ // Suggestion path is advisory steering; a missing checkpoint target
796
+ // must not fail the escalation flow that produced it.
797
+ }
798
+ }
799
+ });
800
+ // Proposals Tool
801
+ pi.registerTool({
802
+ name: "context_proposals",
803
+ exposure: "deferred",
804
+ label: "Context Proposals",
805
+ promptSnippet: "View and manage auto-generated context proposals",
806
+ description: "List, approve, or reject auto-generated context proposals (pending compaction/archive suggestions).",
807
+ parameters: contextProposalsSchema,
808
+ execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
809
+ const entries = getAllEntries(ctx);
810
+ const proposals = readProposalsFromSession(entries);
811
+ const pending = proposals.filter((p) => !p.resolution);
812
+ const snapshots = readSnapshotsFromSession(entries);
813
+ switch (params.action) {
814
+ case "list": {
815
+ if (pending.length === 0) {
816
+ return {
817
+ content: [{ type: "text", text: "[v] No pending proposals." }],
818
+ details: { pending: 0 },
819
+ };
820
+ }
821
+ const lines = pending.map((p) => {
822
+ const age = Date.now() - p.created_at;
823
+ const icon = p.priority === "high" ? "[high]" : p.priority === "medium" ? "[med]" : "[low]";
824
+ return `${icon} **${p.id}** (${p.priority}) ${p.message}\n └─ ${formatDuration(age)} ago`;
825
+ });
826
+ return {
827
+ content: [
828
+ {
829
+ type: "text",
830
+ text: `## Pending Proposals (${pending.length})\n\n${lines.join("\n\n")}\n\nUse context_proposals(action="approve", id="<id>") or the suggested tool.`,
831
+ },
832
+ ],
833
+ details: { pending: pending.length, proposals },
834
+ };
835
+ }
836
+ case "approve": {
837
+ const id = params.id;
838
+ if (!id) {
839
+ return {
840
+ content: [{ type: "text", text: "Proposal ID required." }],
841
+ details: { error: "missing_id" },
842
+ };
843
+ }
844
+ const proposal = pending.find((p) => p.id === id);
845
+ if (!proposal) {
846
+ return {
847
+ content: [{ type: "text", text: `Proposal ${id} not found.` }],
848
+ details: { error: "not_found" },
849
+ };
850
+ }
851
+ proposal.resolution = "approved";
852
+ proposal.resolved_at = Date.now();
853
+ state(ctx).proposalsByEntryId.set(id, proposal);
854
+ state(ctx).outcomes.push({
855
+ proposalId: id,
856
+ resolution: "approved",
857
+ turnsToResolve: state(ctx).turnCount - proposal.turn,
858
+ timestamp: Date.now(),
859
+ });
860
+ return {
861
+ content: [
862
+ { type: "text", text: `[v] Approved **${id}**: ${proposal.message}` },
863
+ ],
864
+ details: {
865
+ approved: id,
866
+ proposal,
867
+ nextStep: { tool: "context_inspect", detail: "quick" },
868
+ },
869
+ };
870
+ }
871
+ case "reject": {
872
+ const id = params.id;
873
+ if (!id) {
874
+ return {
875
+ content: [{ type: "text", text: "Proposal ID required." }],
876
+ details: { error: "missing_id" },
877
+ };
878
+ }
879
+ const proposal = pending.find((p) => p.id === id);
880
+ if (!proposal) {
881
+ return {
882
+ content: [{ type: "text", text: `Proposal ${id} not found.` }],
883
+ details: { error: "not_found" },
884
+ };
885
+ }
886
+ proposal.resolution = "rejected";
887
+ proposal.resolved_at = Date.now();
888
+ state(ctx).proposalsByEntryId.set(id, proposal);
889
+ state(ctx).outcomes.push({
890
+ proposalId: id,
891
+ resolution: "rejected",
892
+ turnsToResolve: state(ctx).turnCount - proposal.turn,
893
+ timestamp: Date.now(),
894
+ });
895
+ // Remember that this suggestion class was declined
896
+ // so the real-need gate backs off re-proposing it (compliance
897
+ // feedback) for the rest of the session.
898
+ state(ctx).declinedKeys.add(proposalKeyFor(proposal.message, proposal.suggested_action));
899
+ return {
900
+ content: [{ type: "text", text: `[x] Rejected **${id}**.` }],
901
+ details: { rejected: id },
902
+ };
903
+ }
904
+ case "snapshots": {
905
+ if (snapshots.length === 0) {
906
+ return {
907
+ content: [{ type: "text", text: "No snapshots available." }],
908
+ details: { count: 0 },
909
+ };
910
+ }
911
+ const lines = snapshots.slice(0, 10).map((s) => {
912
+ const expiresIn = s.expires_at - Date.now();
913
+ return `- **${s.id}** (turn ${s.turn}) ${s.reason} | expires in ${formatDuration(expiresIn)}`;
914
+ });
915
+ return {
916
+ content: [
917
+ {
918
+ type: "text",
919
+ text: `## Snapshots (${snapshots.length})\n\n${lines.join("\n\n")}`,
920
+ },
921
+ ],
922
+ details: { count: snapshots.length, snapshots },
923
+ };
924
+ }
925
+ case "stats": {
926
+ // Policies, governance, topicHistory come
927
+ // from the per-session state via state(ctx).policyEngine /
928
+ // state(ctx).detector. Each session sees its own engine.
929
+ const ctxState = state(ctx);
930
+ const policies = ctxState.policyEngine.policies;
931
+ const governance = ctxState.policyEngine.governance;
932
+ const total = ctxState.outcomes.length;
933
+ const approved = ctxState.outcomes.filter((o) => o.resolution === "approved" || o.resolution === "implicit_approved").length;
934
+ const avgTurns = total > 0 ? ctxState.outcomes.reduce((sum, o) => sum + o.turnsToResolve, 0) / total : 0;
935
+ return {
936
+ content: [
937
+ {
938
+ type: "text",
939
+ text: [
940
+ "## S-MMU Statistics",
941
+ `**Session:** ${ctxState.turnCount} turns | ${formatDuration(Date.now() - ctxState.sessionStartMs)}`,
942
+ `**Proposals:** ${pending.length} pending, ${proposals.filter((p) => p.resolution).length} resolved`,
943
+ `**Outcomes:** ${approved}/${total} approved (${avgTurns.toFixed(1)} turns avg)`,
944
+ `**Policies:** ${policies.length} active`,
945
+ `**Governance:** ${governance.length} constraints`,
946
+ "",
947
+ "### Topic History",
948
+ ...ctxState.detector.topicHistory
949
+ .slice(-5)
950
+ .map((h) => `- Turn ${h.turn}: ${h.topic}`),
951
+ ].join("\n"),
952
+ },
953
+ ],
954
+ details: {
955
+ turns: ctxState.turnCount,
956
+ proposals,
957
+ outcomes: ctxState.outcomes,
958
+ policies,
959
+ governance,
960
+ topicHistory: ctxState.detector.topicHistory,
961
+ },
962
+ };
963
+ }
964
+ default:
965
+ return {
966
+ content: [{ type: "text", text: `Unknown action: ${params.action}` }],
967
+ details: { error: "unknown_action" },
968
+ };
969
+ }
970
+ },
971
+ });
972
+ // No context_signal tool (internal API, not agent-facing). queueSignal()
973
+ // remains exported from signal-detector.ts for direct extension use:
974
+ // import { queueSignal, createDetectorState } from "./signal-detector.js";
975
+ // queueSignal(detectorState, "task_boundary", { action: "tag" });
976
+ }
977
+ //# sourceMappingURL=index.js.map