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,1156 @@
1
+ /**
2
+ * context_compress - Free up context space by compaction, archiving, or deep-clean.
3
+ *
4
+ * One tool for context_compact, context_archive, context_prune, and the
5
+ * tag-based/percentage/keepRecentTurns range params.
6
+ *
7
+ * Capabilities:
8
+ * - Tag-based archive range (startTag / endTag / beforeTag)
9
+ * - Percentage-based range (range: "80%")
10
+ * - Keep-recent-turns shortcut (keepRecentTurns: 20)
11
+ * - Token-savings feedback after archive
12
+ * - "deep_clean" meta-action: tag + archive + compact in one call
13
+ */
14
+ import { Type } from "typebox";
15
+ import { getExtensionState, readExtensionState } from "../../../../../lib/state/extension-state.js";
16
+ import { onEvent } from "../../../../../lib/events/event-types.js";
17
+ import { TOOL_EXECUTION_START, TOOL_EXECUTION_END, AGENT_SETTLED, TURN_END, } from "../../../../../lib/core/event-names.js";
18
+ import { analyzeSession } from "../../analysis.js";
19
+ import * as timerMod from "../../../../scheduling/timer/index.js";
20
+ import { getState } from "../../../../enforcement/state.js";
21
+ import { CONTEXT_COMPACT_REFUSE_PERCENT } from "../../../../../lib/detection/context-thresholds.js";
22
+ import { getCmState, isCompactionActive, log, recordNavigationAction } from "../shared.js";
23
+ import { snapBoundaryOutsideToolBatch } from "../tool-batch-boundary.js";
24
+ import { formatTokensK } from "../../../../../lib/detection/context-usage.js";
25
+ import { formatLocalTime } from "../../../../../lib/utils/local-time.js";
26
+ import { getAutoCompactConfig, } from "../../../../../lib/config/braid-settings.js";
27
+ // Helpers
28
+ /**
29
+ * Resolve a tag name to a branch entry index by scanning the session branch
30
+ * for entries whose label matches `tagName`. Returns -1 if not found.
31
+ */
32
+ function resolveTagToIndex(ctx, tagName) {
33
+ try {
34
+ const sm = ctx.sessionManager;
35
+ if (!sm)
36
+ return -1;
37
+ const branch = sm.getBranch() ?? [];
38
+ for (let i = 0; i < branch.length; i++) {
39
+ const label = sm.getLabel?.(branch[i].id);
40
+ if (label === tagName)
41
+ return i;
42
+ }
43
+ return -1;
44
+ }
45
+ catch {
46
+ return -1;
47
+ }
48
+ }
49
+ /**
50
+ * Capture current context usage for pre/post feedback.
51
+ */
52
+ function captureUsage(ctx) {
53
+ try {
54
+ const audit = analyzeSession(ctx);
55
+ return audit.usage;
56
+ }
57
+ catch {
58
+ return null;
59
+ }
60
+ }
61
+ /**
62
+ * The pending list is bounded: one entry per armed action, capped so a
63
+ * pathological re-arming loop cannot grow it without bound. Beyond the cap the
64
+ * NEWEST entry is dropped (log) — at drain time the FIRST-armed entry is the
65
+ * one that fires (first-armed-wins for LLM-class, earliest-cut for slides), so
66
+ * dropping the oldest would discard the very compaction the queue exists to
67
+ * land. Slides beyond the first are redundant by construction (the drain
68
+ * coalesces to the earliest cut), so a dropped newest entry loses nothing.
69
+ */
70
+ const PENDING_COMPACT_QUEUE_MAX = 8;
71
+ function getBatchSettleState(ctx) {
72
+ return getExtensionState(ctx, "context-manager/batch-settle", () => ({
73
+ inFlight: 0,
74
+ pending: [],
75
+ }));
76
+ }
77
+ /**
78
+ * Read the pending queue without creating state (inspect surfaces it).
79
+ * Exported so context_inspect and the heartbeat advisory can report
80
+ * armed-but-unfired compactions.
81
+ */
82
+ export function readPendingCompactions(ctx) {
83
+ try {
84
+ const st = readExtensionState(ctx, "context-manager/batch-settle");
85
+ return (st?.pending ?? []).map(({ kind, armedAt }) => ({ kind, armedAt }));
86
+ }
87
+ catch {
88
+ return [];
89
+ }
90
+ }
91
+ /** LLM-class kinds carry a declared range/anchor state at arm time. */
92
+ function isLlmClass(kind) {
93
+ return kind === "compact" || kind === "archive" || kind === "deep_clean";
94
+ }
95
+ /**
96
+ * True when an LLM-class compaction is already armed and unfired. A second
97
+ * LLM-class arm must be refused BEFORE it writes its own range/anchor state:
98
+ * the drain fires the first-armed trigger, so a later arm would silently
99
+ * overwrite the range state the first trigger consumes (clobber-class loss).
100
+ */
101
+ export function hasPendingLlmCompaction(ctx) {
102
+ return readPendingCompactions(ctx).some((p) => isLlmClass(p.kind));
103
+ }
104
+ /**
105
+ * One pending-state line for the armed-but-unfired compaction queue
106
+ * ("slide armed 17:28 — fires at the next turn boundary; live usage drops
107
+ * when it lands"). Null when nothing is pending: no surface may fabricate an
108
+ * expectation of a drop that is not armed. Shared by context_inspect and the
109
+ * heartbeat advisory so both state the same fact the same way.
110
+ */
111
+ export function formatPendingCompactionsLine(ctx) {
112
+ const pending = readPendingCompactions(ctx);
113
+ if (pending.length === 0)
114
+ return null;
115
+ const newest = pending.reduce((a, b) => (b.armedAt > a.armedAt ? b : a));
116
+ const kinds = [...new Set(pending.map((p) => p.kind))].join("+");
117
+ const armedClock = formatLocalTime(new Date(newest.armedAt));
118
+ return (`${kinds} armed ${armedClock} — fires at the next turn boundary (turn end or run settle); ` +
119
+ `until then live usage reads pre-compaction state`);
120
+ }
121
+ /**
122
+ * Coalesce a multi-entry queue into ONE deterministic slide compaction:
123
+ * the cut lands at the EARLIEST declared boundary (a pending slide's cut or
124
+ * an archive's firstKeptEntryId), so everything each declaration promised to
125
+ * keep stays live, and the archive anchor/summary record (appended to the
126
+ * session at arm time, inside the kept span) survives. Returns the trigger
127
+ * to fire, or null when no cut point resolves (fire-first fallback).
128
+ */
129
+ function coalesceIntoSlide(ctx, queue) {
130
+ try {
131
+ const branch = ctx?.sessionManager?.getBranch?.() ?? [];
132
+ const indexById = new Map(branch.map((e, i) => [e.id, i]));
133
+ let cutIndex = -1;
134
+ for (const entry of queue) {
135
+ const id = entry.kind === "slide" ? entry.cutEntryId : entry.firstKeptEntryId;
136
+ if (!id)
137
+ continue;
138
+ const idx = indexById.get(id);
139
+ if (idx !== undefined && (cutIndex === -1 || idx < cutIndex))
140
+ cutIndex = idx;
141
+ }
142
+ if (cutIndex < 0)
143
+ return null;
144
+ // The coalesced cut is a supplied boundary: snap it out of any tool batch
145
+ // it lands in (HTTP 400: a kept slice that opens with a tool result has no
146
+ // preceding tool_calls).
147
+ const snappedIndex = snapBoundaryOutsideToolBatch(branch, cutIndex);
148
+ const cutEntryId = branch[snappedIndex].id;
149
+ // Re-point the slide state the SLIDE_MODE compaction branch consumes.
150
+ getCmState(ctx).slideMode = {
151
+ active: true,
152
+ cutEntryId,
153
+ keepCount: branch.length - snappedIndex,
154
+ droppedCount: snappedIndex,
155
+ timestamp: Date.now(),
156
+ };
157
+ const slideEntry = queue.find((p) => p.kind === "slide");
158
+ return { trigger: slideEntry.trigger };
159
+ }
160
+ catch {
161
+ return null;
162
+ }
163
+ }
164
+ function firePendingCompactionsIfSettled(ctx, st) {
165
+ if (st.pending.length === 0 || st.inFlight > 0)
166
+ return;
167
+ const queue = st.pending;
168
+ st.pending = [];
169
+ let trigger = queue[0].trigger;
170
+ let summary = queue.map((p) => p.kind).join(", ");
171
+ if (queue.length > 1) {
172
+ const coalesced = queue.some((p) => p.kind === "slide") ? coalesceIntoSlide(ctx, queue) : null;
173
+ if (coalesced) {
174
+ trigger = coalesced.trigger;
175
+ summary = `slide subsuming (${summary})`;
176
+ }
177
+ else if (queue.some((p) => p.kind === "slide")) {
178
+ // Slide present but no cut point resolved: the slide trigger still runs
179
+ // (its own slide state was armed at arm time).
180
+ trigger = queue.find((p) => p.kind === "slide").trigger;
181
+ summary = `slide-first (${summary})`;
182
+ }
183
+ else {
184
+ // LLM-class only (compact/archive/deep_clean): the FIRST armed wins.
185
+ // Its range/anchor state was persisted at arm time and steers the
186
+ // compaction it fires; a second back-to-back LLM compaction would run
187
+ // on the first's output for nothing.
188
+ summary = `first-armed (${summary})`;
189
+ }
190
+ log.info(`[context-compress] ${queue.length} pending compactions coalesced at settle: ${summary}`);
191
+ }
192
+ // Defer to a macrotask so the current batch's tool-result messages (emitted
193
+ // right after each tool_execution_end) land before the aborting compact.
194
+ setTimeout(() => {
195
+ try {
196
+ trigger();
197
+ }
198
+ catch {
199
+ // Tool already disconnected - non-fatal
200
+ }
201
+ }, 0);
202
+ }
203
+ /**
204
+ * Bounded deferral for the DEGRADED compaction path (batch-settle bookkeeping
205
+ * unavailable): a few ticks so a still-executing parallel sibling has a chance
206
+ * to land its result, but NEVER a raw setTimeout(0) — that is the exact
207
+ * mid-batch abort race this scheduler exists to remove. Exported (with
208
+ * `scheduleDegradedCompact`) so the deferral contract is directly testable.
209
+ */
210
+ export const DEGRADED_DEFERRAL_MS = 150;
211
+ /** Schedule `trigger` on the bounded degraded deferral (see DEGRADED_DEFERRAL_MS). */
212
+ export function scheduleDegradedCompact(trigger) {
213
+ setTimeout(trigger, DEGRADED_DEFERRAL_MS);
214
+ }
215
+ /**
216
+ * Arm a one-shot compaction at a safe boundary (next turn end or run settle).
217
+ * Returns "pending-exists" when an LLM-class compaction is already armed: the
218
+ * caller must NOT have written its own range/anchor state in that case (the
219
+ * drain fires the first-armed trigger with the FIRST declaration's state).
220
+ * If batch-settle bookkeeping is unavailable (extension state failed), falls
221
+ * back to a bounded DEGRADED_DEFERRAL_MS deferral so a sibling still executing
222
+ * at schedule time has a chance to land its result before the aborting compact
223
+ * fires — never a raw setTimeout(0) (the mid-batch abort race this scheduler
224
+ * removes).
225
+ */
226
+ function scheduleCompactionAtBatchSettle(pi, ctx, options, meta = {
227
+ kind: "compact",
228
+ }) {
229
+ const trigger = () => {
230
+ try {
231
+ // Signal to session_compact handler that this is agent-initiated
232
+ // compaction (via context_compress tool), so it should auto-resume.
233
+ // If user typed /compress, this flag is NOT set.
234
+ getState(ctx).autoResumeAfterCompaction = true;
235
+ }
236
+ catch {
237
+ // Non-fatal - enforcement state unavailable
238
+ }
239
+ ctx.compact(options);
240
+ };
241
+ try {
242
+ const st = getBatchSettleState(ctx);
243
+ // LLM-class dedup at arm: a second LLM-class arm while one is pending is
244
+ // refused here so its range/anchor state never clobbers the first's (the
245
+ // drain fires the first-armed trigger). Slides always queue — the drain
246
+ // coalesces them to the earliest cut.
247
+ if (isLlmClass(meta.kind) && st.pending.some((p) => isLlmClass(p.kind))) {
248
+ log.info(`[context-compress] ${meta.kind} arm refused: an LLM-class compaction is ` +
249
+ `already armed and will fire at the next boundary.`);
250
+ return "pending-exists";
251
+ }
252
+ st.pending.push({ trigger, armedAt: Date.now(), ...meta });
253
+ if (st.pending.length > PENDING_COMPACT_QUEUE_MAX) {
254
+ const dropped = st.pending.pop();
255
+ log.warn(`[context-compress] Pending queue overflow: dropped the newest armed ${dropped?.kind}` +
256
+ ` (cap ${PENDING_COMPACT_QUEUE_MAX}); the first-armed entry still fires.`);
257
+ }
258
+ firePendingCompactionsIfSettled(ctx, st);
259
+ return "queued";
260
+ }
261
+ catch {
262
+ // Degraded path: batch-settle bookkeeping is unavailable (extension state
263
+ // failed), so we cannot track in-flight tool executions. Do NOT fall back
264
+ // to a raw setTimeout(0) — that is the exact mid-batch abort race this
265
+ // scheduler exists to remove (a still-running parallel sibling's result
266
+ // would be discarded). Use the bounded DEGRADED_DEFERRAL_MS deferral
267
+ // instead so a sibling still executing at schedule time has a chance to
268
+ // land its result before the aborting compact fires; the compact is still
269
+ // best-effort here, but the race window is materially narrowed.
270
+ scheduleDegradedCompact(trigger);
271
+ return "queued";
272
+ }
273
+ }
274
+ /**
275
+ * Arm a deterministic slide compaction (no LLM call): cut the oldest entries
276
+ * so the most recent `keepCount` stay live. Shared by the slide tool action
277
+ * and the usage-driven auto-arm, so both produce the same cut shape: the
278
+ * boundary is snapped out of any tool batch, the slide state is persisted for
279
+ * the SLIDE_MODE compaction branch, an audit entry is appended, and the
280
+ * trigger is queued for the next safe boundary. Returns null when the branch
281
+ * is not longer than the keep window (nothing to slide).
282
+ */
283
+ function armSlideCompaction(pi, ctx, keepCount) {
284
+ const sm = ctx.sessionManager;
285
+ if (!sm || typeof sm.getBranch !== "function")
286
+ return null;
287
+ const branch = sm.getBranch() ?? [];
288
+ if (branch.length <= keepCount)
289
+ return null;
290
+ // The slide cut is a supplied boundary: snap it out of any tool batch it
291
+ // lands in (HTTP 400: a kept slice that opens with a tool result has no
292
+ // preceding tool_calls).
293
+ const cutIndex = snapBoundaryOutsideToolBatch(branch, branch.length - keepCount);
294
+ const cutEntryId = branch[cutIndex].id;
295
+ const keptCount = branch.length - cutIndex;
296
+ const droppedCount = cutIndex;
297
+ // Persist slide-mode state for session_before_compact to consume.
298
+ try {
299
+ getCmState(ctx).slideMode = {
300
+ active: true,
301
+ cutEntryId,
302
+ keepCount: keptCount,
303
+ droppedCount,
304
+ timestamp: Date.now(),
305
+ };
306
+ }
307
+ catch {
308
+ log.warn("[context-compress] Failed to persist slideMode");
309
+ }
310
+ // Record the slide operation as a custom entry for audit trail.
311
+ try {
312
+ pi.appendEntry("context_compress_slide", {
313
+ keep: keepCount,
314
+ dropped: droppedCount,
315
+ branchLength: branch.length,
316
+ timestamp: Date.now(),
317
+ });
318
+ }
319
+ catch {
320
+ // Non-fatal - audit trail is best-effort
321
+ }
322
+ // Cancel stale resume timers from previous compaction cycles.
323
+ try {
324
+ const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "anonymous";
325
+ timerMod.cancelTimersByTag(sessionId, "compaction-resume");
326
+ timerMod.cancelTimersByTag(sessionId, "auto-compaction-resume");
327
+ }
328
+ catch {
329
+ // Non-fatal
330
+ }
331
+ scheduleCompactionAtBatchSettle(pi, ctx, { customInstructions: "SLIDE_MODE:true" }, { kind: "slide", cutEntryId });
332
+ return { cutEntryId, keptCount, droppedCount };
333
+ }
334
+ /**
335
+ * Keep window for an auto-armed slide: the recent HALF of the branch, floor
336
+ * 10 kept entries. Entry-proportional because the arming trigger is usage,
337
+ * not size — a fixed keep (the slide tool's 50) refuses on small fat branches
338
+ * and over-cuts relative to a session's own scale; halving a sustained-
339
+ * over-threshold branch lands post-cut usage near the low band, and the
340
+ * dropped span stays recoverable in the session file.
341
+ */
342
+ export function resolveAutoSlideKeep(branchLength) {
343
+ return Math.max(10, Math.ceil(branchLength / 2));
344
+ }
345
+ function getAutoArmState(ctx) {
346
+ return getExtensionState(ctx, "context-manager/auto-arm", () => ({ aboveCount: 0 }));
347
+ }
348
+ /**
349
+ * Usage-driven auto-arm: when live usage sits above the configured threshold
350
+ * for `confirmTicks` consecutive observations, arm ONE deterministic slide so
351
+ * a session that never gets a manual cleanup still gets relief. Reuses the
352
+ * accounting context_inspect computes (analyzeSession), the same pending
353
+ * queue the tool arms drain through, and the same boundary discipline: arming
354
+ * only queues; the compaction itself still fires at the next turn boundary or
355
+ * settle, never mid-run.
356
+ *
357
+ * Called from the heartbeat tick — the only cadence that runs while a session
358
+ * works. Returns what happened and why, so the caller can log it.
359
+ */
360
+ export function maybeArmAutoCompaction(pi, ctx) {
361
+ const config = getAutoCompactConfig();
362
+ if (!config.enabled)
363
+ return { armed: false, reason: "disabled" };
364
+ if (isCompactionActive(ctx))
365
+ return { armed: false, reason: "compaction-active" };
366
+ if (readPendingCompactions(ctx).length > 0) {
367
+ return { armed: false, reason: "already-pending" };
368
+ }
369
+ const usage = captureUsage(ctx);
370
+ if (!usage)
371
+ return { armed: false, reason: "usage-unavailable" };
372
+ if (usage.percent < config.armPercent) {
373
+ getAutoArmState(ctx).aboveCount = 0;
374
+ return { armed: false, reason: `below-arm-percent (${usage.percent.toFixed(1)}%)` };
375
+ }
376
+ const st = getAutoArmState(ctx);
377
+ st.aboveCount += 1;
378
+ if (st.aboveCount < config.confirmTicks) {
379
+ return { armed: false, reason: `warming ${st.aboveCount}/${config.confirmTicks}` };
380
+ }
381
+ const branchLength = ctx?.sessionManager?.getBranch?.().length ?? 0;
382
+ const keep = resolveAutoSlideKeep(branchLength);
383
+ const armed = armSlideCompaction(pi, ctx, keep);
384
+ st.aboveCount = 0;
385
+ if (!armed)
386
+ return { armed: false, reason: "branch-too-short" };
387
+ log.info(`[context-compress] Auto-arm: usage sustained at ${usage.percent.toFixed(1)}% ` +
388
+ `(>= ${config.armPercent}% for ${config.confirmTicks} observations) — slide armed ` +
389
+ `(${armed.droppedCount} entries before the cut), fires at the next boundary.`);
390
+ return { armed: true, reason: `usage ${usage.percent.toFixed(1)}% sustained` };
391
+ }
392
+ // Schema
393
+ export const contextCompressSchema = Type.Object({
394
+ action: Type.String({
395
+ enum: ["compact", "archive", "deep_clean", "slide"],
396
+ description: "compact = remove obsolete/duplicate entries (like context_compact). " +
397
+ "archive = compress a range of messages into a topic summary (like context_archive). " +
398
+ "deep_clean = tag current position, archive everything before the tag, then compact. All-in-one. " +
399
+ "slide = deterministic sliding-window compaction. Drops oldest entries, keeps recent N intact. No LLM summarization.",
400
+ }),
401
+ // compact params (also used by slide)
402
+ keep: Type.Optional(Type.Number({
403
+ description: "Messages to preserve: action=compact (token-based LLM) or action=slide (deterministic, no LLM). Default slide: 50.",
404
+ })),
405
+ // archive params (original numeric range)
406
+ startIndex: Type.Optional(Type.Number({
407
+ description: "First message index to compress (auto when omitted); action=archive only.",
408
+ })),
409
+ endIndex: Type.Optional(Type.Number({
410
+ description: "Last message index to compress (auto when omitted); action=archive only.",
411
+ })),
412
+ // archive params (tag-based range)
413
+ startTag: Type.Optional(Type.String({
414
+ description: "Archive start-boundary tag; overrides startIndex; action=archive only.",
415
+ })),
416
+ endTag: Type.Optional(Type.String({
417
+ description: "Archive end-boundary tag; overrides endIndex; action=archive only.",
418
+ })),
419
+ beforeTag: Type.Optional(Type.String({
420
+ description: "Archive all entries before this tag; equals startTag+endIndex; action=archive only.",
421
+ })),
422
+ // percentage-based range,
423
+ range: Type.Optional(Type.String({
424
+ description: 'Percent of session to archive (e.g. "80%"); overrides startIndex/endIndex; action=archive only.',
425
+ })),
426
+ // keep-recent-turns shortcut,
427
+ keepRecentTurns: Type.Optional(Type.Number({
428
+ description: "Keep last N user turns, archive the rest; overrides startIndex/endIndex; action=archive only.",
429
+ })),
430
+ // archive params (shared)
431
+ topic: Type.Optional(Type.String({
432
+ description: "Topic label; required for action=archive and action=deep_clean.",
433
+ })),
434
+ summary: Type.Optional(Type.String({
435
+ description: "Summary of what was accomplished; required for archive/deep_clean. Use explicit speaker labels to prevent misattribution.",
436
+ })),
437
+ // deep_clean params
438
+ tagName: Type.Optional(Type.String({
439
+ description: "Tag to create at current position; deep_clean only. Default: 'before-cleanup'.",
440
+ })),
441
+ });
442
+ export function registerContextCompress(pi) {
443
+ // Batch-settle scheduling: track in-flight tool executions per session and
444
+ // fire the deferred compaction ONLY at agent_settled — the moment the whole
445
+ // agent run settles (session idle/promptable). Never mid-batch (would drop
446
+ // a parallel sibling's result) and never at tool_execution_end (the run is
447
+ // still live there — an aborting compact would surface a spurious
448
+ // "This operation was aborted" error and tear the finishing turn).
449
+ onEvent(pi, TOOL_EXECUTION_START, (_event, ctx) => {
450
+ try {
451
+ getBatchSettleState(ctx).inFlight++;
452
+ }
453
+ catch {
454
+ // Settle tracking is unavailable — the pending compact then only fires
455
+ // via AGENT_SETTLED below, which is the conservative path.
456
+ }
457
+ });
458
+ onEvent(pi, TOOL_EXECUTION_END, (_event, ctx) => {
459
+ try {
460
+ const st = getBatchSettleState(ctx);
461
+ if (st.inFlight > 0)
462
+ st.inFlight--;
463
+ // NOTE: do NOT fire here. The run is still active (the agent is
464
+ // processing this tool's result and streaming its next response); an
465
+ // aborting compact now would surface a spurious "This operation was
466
+ // aborted" error and tear the finishing turn. Safe boundaries are
467
+ // turn_end (below) and agent_settled.
468
+ }
469
+ catch {
470
+ // Settle tracking unavailable — see TOOL_EXECUTION_START above; the
471
+ // AGENT_SETTLED handler remains the conservative trigger.
472
+ }
473
+ });
474
+ onEvent(pi, TURN_END, (_event, ctx) => {
475
+ // Between-turns boundary: the turn's assistant message and tool results
476
+ // are already persisted when turn_end fires, so the abort inside
477
+ // ctx.compact() cannot tear a live turn or drop a sibling result. A run
478
+ // kept alive by continuous steers never reaches agent_settled — this
479
+ // boundary keeps an armed compaction from stalling behind live work. A
480
+ // steer queued at this moment survives: the loop appends it before the
481
+ // aborted response stream, and its turn runs on the post-compaction
482
+ // resume. inFlight is NOT reset here (only agent_settled owns that
483
+ // backstop); a missed tool_execution_end keeps the boundary conservative.
484
+ try {
485
+ const st = getBatchSettleState(ctx);
486
+ if (st.pending.length === 0 || st.inFlight > 0)
487
+ return;
488
+ if (isCompactionActive(ctx))
489
+ return;
490
+ firePendingCompactionsIfSettled(ctx, st);
491
+ }
492
+ catch {
493
+ // A failed boundary drain must not tear the turn_end event pipeline;
494
+ // the pending compactions retry on the next boundary.
495
+ }
496
+ });
497
+ onEvent(pi, AGENT_SETTLED, (_event, ctx) => {
498
+ // Backstop boundary: the run has fully settled, so ctx.compact()'s
499
+ // abort() is a clean no-op — no spurious abort error, no torn turn, and
500
+ // the post-compaction resume wake lands when the session is
501
+ // idle/promptable. The whole pending queue drains here (coalesced);
502
+ // inFlight is reset so parked compactions always fire even if a
503
+ // sibling's end event never arrived. Turn boundaries drain first when a
504
+ // run stays alive; this handler catches everything they cannot reach.
505
+ try {
506
+ const st = getBatchSettleState(ctx);
507
+ st.inFlight = 0;
508
+ firePendingCompactionsIfSettled(ctx, st);
509
+ }
510
+ catch {
511
+ // A failed settle trigger must not tear down the AGENT_SETTLED event
512
+ // pipeline; the pending compactions retry on the next settle cycle.
513
+ }
514
+ });
515
+ pi.registerTool({
516
+ name: "context_compress",
517
+ label: "Context Compress",
518
+ promptSnippet: "Free context space by compaction or archiving; archive first, slide or compact when it can run safely",
519
+ description: "Free up context space; prefer archive over compact. " +
520
+ "For long sessions, tag your position with context_navigate(action=tag) and archive deliberately with " +
521
+ "context_compress(action=archive) BEFORE considering compaction — compaction is a bounded safety net " +
522
+ "(substantive, skippable when input unchanged, verifiable, originals recoverable). " +
523
+ "Never in a parallel batch (it aborts the turn). Use explicit speaker labels in summaries.",
524
+ parameters: contextCompressSchema,
525
+ execute: async (_toolCallId, params, _signal, _onUpdate, ctx) => {
526
+ const action = params.action;
527
+ // COMPACT
528
+ if (action === "compact") {
529
+ try {
530
+ const usage = captureUsage(ctx);
531
+ // SAFETY GUARD: compaction (action="compact") causes "max call stack" errors
532
+ // when context exceeds the CONTEXT_COMPACT_REFUSE_PERCENT threshold (owner:
533
+ // lib/detection/context-thresholds.ts). The destructive AI-supervised compaction can
534
+ // leave the session in an unstable state (corrupted messages, 403 blocks).
535
+ // Use action="slide" instead — it's deterministic, entry-based, no LLM call.
536
+ if (usage && usage.percent > CONTEXT_COMPACT_REFUSE_PERCENT) {
537
+ return {
538
+ content: [
539
+ {
540
+ type: "text",
541
+ text: [
542
+ `**Compact refused — context at ${usage.percent.toFixed(1)}% (>${CONTEXT_COMPACT_REFUSE_PERCENT}% threshold).**`,
543
+ `Destructive AI-supervised compaction (action="compact") causes max-call-stack`,
544
+ `crashes and session corruption above ${CONTEXT_COMPACT_REFUSE_PERCENT}% usage.`,
545
+ ``,
546
+ `Use **action="slide"** instead — deterministic, entry-based, no LLM:`,
547
+ ` context_compress(action="slide")`,
548
+ ` context_compress(action="slide", keep=80) # keep recent 80 entries`,
549
+ ``,
550
+ `Run context_inspect(detail="quick") first to assess current state.`,
551
+ ].join("\n"),
552
+ },
553
+ ],
554
+ details: {
555
+ action,
556
+ refused: true,
557
+ reason: `context ${usage.percent.toFixed(1)}% > ${CONTEXT_COMPACT_REFUSE_PERCENT}% threshold`,
558
+ suggestion: { tool: "context_compress", action: "slide" },
559
+ },
560
+ };
561
+ }
562
+ const usageLine2 = usage
563
+ ? `${usage.percent.toFixed(1)}% used (${formatTokensK(usage.tokens)} tokens)`
564
+ : "unknown";
565
+ const result = {
566
+ content: [
567
+ {
568
+ type: "text",
569
+ text: [
570
+ `**Compaction scheduled.**`,
571
+ ` Before: ${usageLine2}`,
572
+ ` Keep recent: ${params?.keep ?? "auto"}`,
573
+ ``,
574
+ `Compaction armed; it fires at the next turn boundary (turn end or run settle) — live usage will NOT drop until it lands.`,
575
+ `Agent will resume automatically after compaction completes.`,
576
+ `Run context_inspect(detail='quick') after resume to verify.`,
577
+ ].join("\n"),
578
+ },
579
+ ],
580
+ details: {
581
+ action,
582
+ compactionTriggered: true,
583
+ keep: params?.keep ?? "auto",
584
+ nextStep: { tool: "context_inspect", detail: "quick", note: "after auto-resume" },
585
+ },
586
+ };
587
+ try {
588
+ // Cancel any stale resume timer from a previous compaction cycle.
589
+ const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "anonymous";
590
+ timerMod.cancelTimersByTag(sessionId, "compaction-resume");
591
+ timerMod.cancelTimersByTag(sessionId, "auto-compaction-resume");
592
+ }
593
+ catch {
594
+ // Non-fatal - timer unavailable
595
+ }
596
+ const options = {};
597
+ if (params?.keep != null) {
598
+ options.customInstructions = `Keep the most recent ${params.keep} messages.`;
599
+ }
600
+ // Skip compact if context is already low — pi-core returns
601
+ // "nothing to compact" as a whisper, which is confusing noise.
602
+ if (usage && usage.percent < 30) {
603
+ return {
604
+ ...result,
605
+ content: [
606
+ {
607
+ type: "text",
608
+ text: [
609
+ `**Compact skipped — context at ${usage.percent.toFixed(1)}% (already low).**`,
610
+ `No compaction needed. Use context_inspect(detail="quick") to verify.`,
611
+ ].join("\n"),
612
+ },
613
+ ],
614
+ details: {
615
+ ...result.details,
616
+ skipped: true,
617
+ reason: `context ${usage.percent.toFixed(1)}% < 30% threshold`,
618
+ },
619
+ };
620
+ }
621
+ scheduleCompactionAtBatchSettle(pi, ctx, options, { kind: "compact" });
622
+ // Compact was scheduled (a real compaction is armed) — count it.
623
+ recordNavigationAction(ctx, "compact");
624
+ return result;
625
+ }
626
+ catch (e) {
627
+ return {
628
+ content: [{ type: "text", text: `Failed to compact: ${e.message}` }],
629
+ details: { action, error: e.message },
630
+ };
631
+ }
632
+ }
633
+ // ARCHIVE
634
+ if (action === "archive") {
635
+ const { topic, summary } = params;
636
+ if (!topic || !summary) {
637
+ return {
638
+ content: [
639
+ {
640
+ type: "text",
641
+ text: "topic and summary are required for action=archive",
642
+ },
643
+ ],
644
+ details: { action, error: "missing required params" },
645
+ };
646
+ }
647
+ // LLM-class dedup: refuse BEFORE any state write. An already-armed
648
+ // compaction fires at the next boundary with the FIRST declaration's
649
+ // range; a second arm here would overwrite rangeMode (clobber-class
650
+ // loss) and queue an entry that can never fire.
651
+ if (hasPendingLlmCompaction(ctx)) {
652
+ return {
653
+ content: [
654
+ {
655
+ type: "text",
656
+ text: [
657
+ `**Archive skipped — a compaction is already armed and will fire at the next turn boundary.**`,
658
+ `Nothing was recorded for "${topic}"; the pending compaction covers the cleanup.`,
659
+ `After it lands, re-run this archive if the range still needs a record.`,
660
+ ].join("\n"),
661
+ },
662
+ ],
663
+ details: {
664
+ action,
665
+ skipped: true,
666
+ reason: "compaction-already-pending",
667
+ topic,
668
+ },
669
+ };
670
+ }
671
+ const usageBefore = captureUsage(ctx);
672
+ const sessionLength = analyzeSession(ctx).branchLength;
673
+ // Resolve range via priority: startTag/endTag > beforeTag > range > keepRecentTurns > startIndex/endIndex > auto
674
+ let startIndex = params.startIndex;
675
+ let endIndex = params.endIndex;
676
+ // Priority 1: Tag-based range
677
+ if (params.startTag !== undefined) {
678
+ const idx = resolveTagToIndex(ctx, params.startTag);
679
+ if (idx < 0) {
680
+ return {
681
+ content: [
682
+ {
683
+ type: "text",
684
+ text: `Tag '${params.startTag}' not found in session branch. Use context_navigate action=log to see available tags.`,
685
+ },
686
+ ],
687
+ details: { action, error: `tag not found: ${params.startTag}` },
688
+ };
689
+ }
690
+ startIndex = idx;
691
+ if (params.endTag !== undefined) {
692
+ const idxEnd = resolveTagToIndex(ctx, params.endTag);
693
+ if (idxEnd < 0) {
694
+ return {
695
+ content: [
696
+ {
697
+ type: "text",
698
+ text: `Tag '${params.endTag}' not found in session branch. Use context_navigate action=log to see available tags.`,
699
+ },
700
+ ],
701
+ details: { action, error: `tag not found: ${params.endTag}` },
702
+ };
703
+ }
704
+ endIndex = idxEnd;
705
+ }
706
+ }
707
+ // Priority 1b: beforeTag convenience (archive everything before this tag)
708
+ if (startIndex === undefined && params.beforeTag !== undefined) {
709
+ const idx = resolveTagToIndex(ctx, params.beforeTag);
710
+ if (idx < 0) {
711
+ return {
712
+ content: [
713
+ {
714
+ type: "text",
715
+ text: `Tag '${params.beforeTag}' not found in session branch. Use context_navigate action=log to see available tags.`,
716
+ },
717
+ ],
718
+ details: { action, error: `tag not found: ${params.beforeTag}` },
719
+ };
720
+ }
721
+ startIndex = 0;
722
+ endIndex = Math.max(0, idx - 1);
723
+ }
724
+ // Priority 2: Percentage-based range
725
+ if (params.range !== undefined && (startIndex === undefined || endIndex === undefined)) {
726
+ const match = String(params.range).match(/^(\d+)%$/);
727
+ if (!match) {
728
+ return {
729
+ content: [
730
+ {
731
+ type: "text",
732
+ text: `Invalid range format: '${params.range}'. Use 'N%' e.g. '80%'.`,
733
+ },
734
+ ],
735
+ details: { action, error: `invalid range: ${params.range}` },
736
+ };
737
+ }
738
+ const pct = parseInt(match[1], 10);
739
+ if (pct <= 0 || pct > 100) {
740
+ return {
741
+ content: [
742
+ {
743
+ type: "text",
744
+ text: `Range must be 1-100%. Got ${pct}%.`,
745
+ },
746
+ ],
747
+ details: { action, error: `invalid percentage: ${pct}` },
748
+ };
749
+ }
750
+ const count = Math.max(1, Math.floor((sessionLength * pct) / 100));
751
+ startIndex = 0;
752
+ endIndex = count - 1;
753
+ }
754
+ // Priority 3: Keep-recent-turns
755
+ if ((startIndex === undefined || endIndex === undefined) &&
756
+ params.keepRecentTurns !== undefined) {
757
+ const keep = params.keepRecentTurns;
758
+ if (keep <= 0) {
759
+ return {
760
+ content: [
761
+ {
762
+ type: "text",
763
+ text: "keepRecentTurns must be >= 1.",
764
+ },
765
+ ],
766
+ details: { action, error: "invalid keepRecentTurns" },
767
+ };
768
+ }
769
+ const sm = ctx.sessionManager;
770
+ const branch = sm.getBranch() ?? [];
771
+ // Branch entries wrap the message: a user turn is
772
+ // entry.type === "message" with entry.message.role === "user".
773
+ // Matching entry.type/entry.role directly never matches, which
774
+ // collapsed every keepRecentTurns span to [0..0].
775
+ let userMessagesSeen = 0;
776
+ let cutIndex = 0;
777
+ for (let i = branch.length - 1; i >= 0; i--) {
778
+ const entry = branch[i];
779
+ if (entry?.type === "message" && entry.message?.role === "user") {
780
+ userMessagesSeen++;
781
+ if (userMessagesSeen >= keep) {
782
+ cutIndex = i;
783
+ break;
784
+ }
785
+ }
786
+ }
787
+ startIndex = 0;
788
+ endIndex = Math.max(0, cutIndex - 1);
789
+ }
790
+ // Default: auto-select oldest ~20%
791
+ if (startIndex === undefined || endIndex === undefined) {
792
+ const archiveCount = Math.min(Math.max(Math.floor(sessionLength * 0.2), 10), 100);
793
+ startIndex = 0;
794
+ endIndex = archiveCount - 1;
795
+ }
796
+ if (startIndex < 0 || endIndex < startIndex) {
797
+ return {
798
+ content: [
799
+ {
800
+ type: "text",
801
+ text: "Invalid range: startIndex must be >= 0 and endIndex must be >= startIndex",
802
+ },
803
+ ],
804
+ details: { action, error: true },
805
+ };
806
+ }
807
+ const sm = ctx.sessionManager;
808
+ // Persist range-mode state so session_before_compact honors the declared
809
+ // range as the real compaction boundary (commitment-preserving anchor).
810
+ const branch = typeof sm.getBranch === "function" ? (sm.getBranch() ?? []) : [];
811
+ // The declared boundary is a supplied one: snap it out of any tool
812
+ // batch it lands in (HTTP 400: a kept slice that opens with a tool
813
+ // result has no preceding tool_calls). A boundary at the branch end
814
+ // stays undefined - there is no entry to keep.
815
+ const candidateBoundary = endIndex + 1;
816
+ const boundaryIndex = candidateBoundary < branch.length
817
+ ? snapBoundaryOutsideToolBatch(branch, candidateBoundary)
818
+ : candidateBoundary;
819
+ const firstKeptEntryId = branch[boundaryIndex]?.id;
820
+ try {
821
+ const cmState = getCmState(ctx);
822
+ cmState.rangeMode = {
823
+ active: true,
824
+ startIndex,
825
+ endIndex,
826
+ summary,
827
+ topic,
828
+ firstKeptEntryId,
829
+ boundaryIsBranchEnd: boundaryIndex >= branch.length,
830
+ timestamp: Date.now(),
831
+ };
832
+ }
833
+ catch {
834
+ log.warn("[context-compress] Failed to persist rangeMode");
835
+ }
836
+ pi.appendEntry("context_compression", {
837
+ topic,
838
+ startIndex,
839
+ endIndex,
840
+ summary,
841
+ timestamp: Date.now(),
842
+ });
843
+ // Honest-by-understatement feedback.
844
+ // The declared range + summary are recorded as the archive anchor
845
+ // (audit metadata entry + rangeMode), but the feedback NEVER claims a
846
+ // specific removed range ("entries N..M removed" / "Compressed N
847
+ // messages") and never promises a specific boundary — the actual cut
848
+ // is pi-core's compaction decision, so the tool reports an ESTIMATED
849
+ // cut only. Contract: claim less than what happened, never more. The
850
+ // REAL before-% is still reported (no fabricated post-% — a
851
+ // linear-token estimate would be misleading).
852
+ const count = endIndex - startIndex + 1;
853
+ const feedbackLines = [
854
+ `Archive recorded: "${topic}" — ~${count} entries before the archive point, estimated.`,
855
+ ];
856
+ if (usageBefore) {
857
+ feedbackLines.push(` Before: ${usageBefore.percent.toFixed(1)}% used (${formatTokensK(usageBefore.tokens)} tokens)`);
858
+ }
859
+ feedbackLines.push("", "Compaction is armed and fires at the next turn boundary (turn end or run settle) — it may " +
860
+ "land while the run stays alive; live usage will NOT drop until it fires.", "Verify after it lands: context_inspect(detail='quick') shows the drop and any still-pending arm.");
861
+ // Cancel any stale resume timer from a previous compaction cycle.
862
+ try {
863
+ const sessionId = ctx?.sessionManager?.getSessionId?.() ?? "anonymous";
864
+ timerMod.cancelTimersByTag(sessionId, "compaction-resume");
865
+ timerMod.cancelTimersByTag(sessionId, "auto-compaction-resume");
866
+ }
867
+ catch {
868
+ // Non-fatal - timer unavailable
869
+ }
870
+ // Skip follow-up compact only when REAL usage is genuinely low (<30%).
871
+ // Never skip on a linear-token estimate — that drops a needed
872
+ // compaction while claiming a freed percentage.
873
+ let compactionTriggered = true;
874
+ if (usageBefore && usageBefore.percent < 30) {
875
+ compactionTriggered = false;
876
+ feedbackLines.push("", ` Skipped follow-up compact (real context ${usageBefore.percent.toFixed(1)}% — already low). No estimation used.`);
877
+ }
878
+ else {
879
+ scheduleCompactionAtBatchSettle(pi, ctx, {}, {
880
+ kind: "archive",
881
+ firstKeptEntryId,
882
+ });
883
+ }
884
+ // The archive range was declared and compaction armed — count it.
885
+ recordNavigationAction(ctx, "archive");
886
+ // An untagged session just archived without a
887
+ // navigation checkpoint — gently remind that tagging before archiving
888
+ // makes recovery lossless. Only on the archive SUCCESS path, only when
889
+ // the session has zero recorded tags (adopters are not nagged).
890
+ if ((getCmState(ctx).navigationAdoption?.tags ?? 0) === 0) {
891
+ feedbackLines.push("", "Tip: context_navigate(action=tag) before archives makes recovery lossless.");
892
+ }
893
+ return {
894
+ content: [
895
+ {
896
+ type: "text",
897
+ text: feedbackLines.join("\n"),
898
+ },
899
+ ],
900
+ details: {
901
+ action,
902
+ compressed: count,
903
+ topic,
904
+ startIndex,
905
+ endIndex,
906
+ honorRange: true,
907
+ compactionTriggered,
908
+ nextStep: { tool: "context_inspect", detail: "quick", note: "after auto-resume" },
909
+ },
910
+ };
911
+ }
912
+ // DEEP_CLEAN
913
+ if (action === "deep_clean") {
914
+ const topic = params.topic;
915
+ const summary = params.summary;
916
+ if (!topic || !summary) {
917
+ return {
918
+ content: [
919
+ {
920
+ type: "text",
921
+ text: "topic and summary are required for action=deep_clean",
922
+ },
923
+ ],
924
+ details: { action, error: "missing required params" },
925
+ };
926
+ }
927
+ // LLM-class dedup (same contract as archive): an armed compaction
928
+ // fires at the next boundary; refuse before writing the tag or the
929
+ // archive anchor so the first declaration stands unmodified.
930
+ if (hasPendingLlmCompaction(ctx)) {
931
+ return {
932
+ content: [
933
+ {
934
+ type: "text",
935
+ text: [
936
+ `**Deep clean skipped — a compaction is already armed and will fire at the next turn boundary.**`,
937
+ `Nothing was tagged for "${topic}"; the pending compaction covers the cleanup.`,
938
+ ].join("\n"),
939
+ },
940
+ ],
941
+ details: {
942
+ action,
943
+ skipped: true,
944
+ reason: "compaction-already-pending",
945
+ topic,
946
+ },
947
+ };
948
+ }
949
+ const tagName = params.tagName ?? "before-cleanup";
950
+ const usageBefore = captureUsage(ctx);
951
+ try {
952
+ const sm = ctx.sessionManager;
953
+ const branch = sm.getBranch() ?? [];
954
+ const currentLeaf = branch.length > 0 ? branch[branch.length - 1].id : null;
955
+ if (currentLeaf) {
956
+ sm.appendLabelChange(currentLeaf, tagName);
957
+ }
958
+ const tagIndex = currentLeaf ? resolveTagToIndex(ctx, tagName) : -1;
959
+ const archiveEnd = tagIndex > 0 ? tagIndex - 1 : -1;
960
+ if (archiveEnd >= 0) {
961
+ pi.appendEntry("context_compression", {
962
+ topic,
963
+ startIndex: 0,
964
+ endIndex: archiveEnd,
965
+ summary,
966
+ timestamp: Date.now(),
967
+ fromDeepClean: true,
968
+ });
969
+ }
970
+ const options = {};
971
+ scheduleCompactionAtBatchSettle(pi, ctx, options, { kind: "deep_clean" });
972
+ // The deep-clean pipeline actually ran (tag + archive + compact).
973
+ recordNavigationAction(ctx, "deep_clean");
974
+ const count = archiveEnd >= 0 ? archiveEnd + 1 : 0;
975
+ const usageLine = usageBefore ? ` (before: ${usageBefore.percent.toFixed(1)}%)` : "";
976
+ return {
977
+ content: [
978
+ {
979
+ type: "text",
980
+ text: [
981
+ `**Deep clean triggered.**`,
982
+ ` 1. Tagged '${tagName}' at current position`,
983
+ ` 2. ~${count} entries before the tag point, estimated`,
984
+ ` 3. Compaction scheduled${usageLine}`,
985
+ "",
986
+ `Compaction armed; it fires at the next turn boundary (turn end or run settle) — live usage will NOT drop until it lands.`,
987
+ `Agent will resume automatically after compaction completes.`,
988
+ `Run context_inspect(detail='quick') after resume to verify.`,
989
+ "",
990
+ `Topic: ${topic}`,
991
+ ].join("\n"),
992
+ },
993
+ ],
994
+ details: {
995
+ action: "deep_clean",
996
+ tagName,
997
+ archived: count,
998
+ compactionTriggered: true,
999
+ topic,
1000
+ nextStep: { tool: "context_inspect", detail: "quick", note: "after auto-resume" },
1001
+ },
1002
+ };
1003
+ }
1004
+ catch (e) {
1005
+ return {
1006
+ content: [
1007
+ {
1008
+ type: "text",
1009
+ text: `Failed to deep clean: ${e.message}`,
1010
+ },
1011
+ ],
1012
+ details: { action, error: e.message },
1013
+ };
1014
+ }
1015
+ }
1016
+ // SLIDE
1017
+ if (action === "slide") {
1018
+ try {
1019
+ const sm = ctx.sessionManager;
1020
+ if (!sm || typeof sm.getBranch !== "function") {
1021
+ return {
1022
+ content: [
1023
+ {
1024
+ type: "text",
1025
+ text: "Session manager not available.",
1026
+ },
1027
+ ],
1028
+ details: { action, error: "no session manager" },
1029
+ };
1030
+ }
1031
+ const keepCount = params?.keep != null ? params.keep : 50;
1032
+ if (typeof keepCount !== "number" || keepCount < 1 || !Number.isFinite(keepCount)) {
1033
+ return {
1034
+ content: [
1035
+ {
1036
+ type: "text",
1037
+ text: "keep must be a positive integer >= 1.",
1038
+ },
1039
+ ],
1040
+ details: { action, error: "invalid keep" },
1041
+ };
1042
+ }
1043
+ const branch = sm.getBranch() ?? [];
1044
+ if (branch.length <= keepCount) {
1045
+ return {
1046
+ content: [
1047
+ {
1048
+ type: "text",
1049
+ text: `Branch has ${branch.length} entries, which is <= keep (${keepCount}). Nothing to slide.`,
1050
+ },
1051
+ ],
1052
+ details: {
1053
+ action,
1054
+ keep: keepCount,
1055
+ branchLength: branch.length,
1056
+ slid: 0,
1057
+ },
1058
+ };
1059
+ }
1060
+ const usage = captureUsage(ctx);
1061
+ const usageLine = usage
1062
+ ? `${usage.percent.toFixed(1)}% used (${formatTokensK(usage.tokens)} tokens)`
1063
+ : "unknown";
1064
+ // Skip slide compact if context is already low — pi-core returns
1065
+ // "nothing to compact" as a confusing whisper. Checked BEFORE any
1066
+ // state write: a skipped slide must not leave slideMode armed for a
1067
+ // later compaction cycle to consume.
1068
+ if (usage && usage.percent < 30) {
1069
+ return {
1070
+ content: [
1071
+ {
1072
+ type: "text",
1073
+ text: [
1074
+ `**Slide skipped — context at ${usage.percent.toFixed(1)}% (already low).**`,
1075
+ `No entries need dropping. Use context_inspect(detail="quick") to verify.`,
1076
+ ].join("\n"),
1077
+ },
1078
+ ],
1079
+ details: {
1080
+ action,
1081
+ skipped: true,
1082
+ reason: `context ${usage.percent.toFixed(1)}% < 30% threshold`,
1083
+ branchLength: branch.length,
1084
+ },
1085
+ };
1086
+ }
1087
+ const armedSlide = armSlideCompaction(pi, ctx, keepCount);
1088
+ if (!armedSlide) {
1089
+ return {
1090
+ content: [
1091
+ {
1092
+ type: "text",
1093
+ text: "Session manager not available.",
1094
+ },
1095
+ ],
1096
+ details: { action, error: "no session manager" },
1097
+ };
1098
+ }
1099
+ const { keptCount, droppedCount } = armedSlide;
1100
+ // Slide window armed — count it as navigation adoption.
1101
+ recordNavigationAction(ctx, "slide");
1102
+ return {
1103
+ content: [
1104
+ {
1105
+ type: "text",
1106
+ text: [
1107
+ `**Slide window compaction triggered.**`,
1108
+ ` Keep recent: ${keptCount} entries`,
1109
+ ` ~${droppedCount} entries before the slide point, estimated`,
1110
+ ` Before: ${usageLine}`,
1111
+ ``,
1112
+ `Compaction armed; it fires at the next turn boundary (turn end or run settle) — live usage will NOT drop until it lands.`,
1113
+ `Agent will resume automatically after compaction completes.`,
1114
+ `Run context_inspect(detail='quick') after resume to verify.`,
1115
+ ].join("\n"),
1116
+ },
1117
+ ],
1118
+ details: {
1119
+ action,
1120
+ slideTriggered: true,
1121
+ keep: keepCount,
1122
+ dropped: droppedCount,
1123
+ branchLength: branch.length,
1124
+ nextStep: {
1125
+ tool: "context_inspect",
1126
+ detail: "quick",
1127
+ note: "after auto-resume",
1128
+ },
1129
+ },
1130
+ };
1131
+ }
1132
+ catch (e) {
1133
+ return {
1134
+ content: [
1135
+ {
1136
+ type: "text",
1137
+ text: `Failed to slide: ${e.message}`,
1138
+ },
1139
+ ],
1140
+ details: { action, error: e.message },
1141
+ };
1142
+ }
1143
+ }
1144
+ return {
1145
+ content: [
1146
+ {
1147
+ type: "text",
1148
+ text: "Unknown action. Use compact, archive, deep_clean, or slide.",
1149
+ },
1150
+ ],
1151
+ details: { action, error: true },
1152
+ };
1153
+ },
1154
+ });
1155
+ }
1156
+ //# sourceMappingURL=context-compress.js.map