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