pi-braid 0.0.0-stage → 0.40.0

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 +260 -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 +144 -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 +459 -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,961 @@
1
+ // Context-Manager Shared State & Helpers
2
+ // Shared across all handler modules. Module-level singletons + session-scoped factories.
3
+
4
+ import { getExtensionState } from "../../../../lib/state/extension-state.js";
5
+ import { createLogger } from "../../../../lib/core/logger.js";
6
+ import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
7
+ import { createPruningState } from "../pruning.js";
8
+ import { getSessionManager } from "../../../../lib/state/session-manager.js";
9
+ import { sendTrackedMessage } from "../../../../lib/utils/injection-tracker.js";
10
+ import { getRotationState } from "../../../../lib/state/global-state.js";
11
+
12
+ export const log = createLogger("context-manager");
13
+
14
+ // Internal tool detection
15
+ export const INTERNAL_TOOLS = new Set([
16
+ "context_navigate",
17
+ "context_compress",
18
+ "context_inspect",
19
+ "context_proposals",
20
+ "offload_recover",
21
+ "think",
22
+ "hypothesize",
23
+ "finalize",
24
+ "heuristics_evaluate",
25
+ "cognition_evaluate",
26
+ "memory_store",
27
+ "memory",
28
+ "goal",
29
+ "plan",
30
+ "scratchpad",
31
+ "health_maintenance",
32
+ ]);
33
+
34
+ export function isInternal(toolName: string): boolean {
35
+ return INTERNAL_TOOLS.has(toolName);
36
+ }
37
+
38
+ // Session-scoped state
39
+ import type { CompressionStats } from "../semantic-compress.js";
40
+
41
+ interface CmState {
42
+ checkoutParams: { target: string; newId: string; targetId: string; backupTag?: string } | null;
43
+ pruningState: any;
44
+ overflowNotified?: boolean;
45
+ // H5: Retry guards for compaction/overflow (prevents double-trigger)
46
+ compactionRetryActive?: boolean;
47
+ overflowRetryActive?: boolean;
48
+ /**
49
+ * Consecutive compaction cycles that ended without landing an entry
50
+ * (failure, abort, or verify rejection) while the session sat at or above
51
+ * the critical usage band. Reset by any landed compaction. Read by the
52
+ * failure routing: at COMPACTION_NO_PROGRESS_LIMIT the next cycle takes the
53
+ * deterministic cut instead of trying a summarizer that has already failed.
54
+ */
55
+ compactionNoProgress?: number;
56
+ /**
57
+ * The deterministic cut armed for the next compaction cycle. Present means
58
+ * the session is known to be unable to summarize its own context at this
59
+ * usage; the next session_before_compact returns this cut instead of
60
+ * handing a span to a summarizer (pi-core consumes an extension compaction
61
+ * result verbatim and skips its own call). One-shot, and cleared by any
62
+ * landed compaction.
63
+ */
64
+ compactionFailsafeCut?: FailsafeCutState;
65
+ /** Compression metadata from the last semantic compression pass. */
66
+ lastCompressionStats?: CompressionStats & {
67
+ turnRange: { from: number; to: number };
68
+ timestamp: number;
69
+ };
70
+ /** Slide-mode state for deterministic sliding-window compaction. */
71
+ slideMode?: SlideModeState | null;
72
+ /** Archive range-mode state for commitment-preserving archive compactions. */
73
+ rangeMode?: RangeModeState | null;
74
+ /**
75
+ * Bounded-recovery state armed by a summary token-cap failure; consumed by
76
+ * the retry cycle's session_before_compact (chunked summarization, reasoning
77
+ * off). Cleared by the consuming branch, the success handler, and the
78
+ * failure routing so a stale flag never hijacks an unrelated cycle.
79
+ */
80
+ pendingSummaryCapRecovery?: SummaryCapRecoveryState;
81
+ /**
82
+ * The declared range stashed by the range branch so a failed range-archive
83
+ * cycle can be re-armed as range mode on its summary-cap retry cycle
84
+ * (retry cycles recompute pi-core's default span, which would silently drop
85
+ * the declaration). Cleared on success and consumed by the failure routing.
86
+ */
87
+ pendingRangeArchive?: RangeModeState;
88
+ /**
89
+ * Thinking level captured when the summarizer thinking-off switch armed,
90
+ * restored at the cycle outcome. Absent means the switch is not armed.
91
+ */
92
+ pendingSummarizerThinkingLevel?: string;
93
+ /**
94
+ * Whether a compaction was already in-flight when the current cycle's
95
+ * session_before_compact firing began (P2a). Captured BEFORE the cycle is
96
+ * marked active, carried to the session_compact_failed abort branch to tag
97
+ * the abort telemetry.
98
+ */
99
+ inFlightBeforeCapture?: boolean;
100
+ /**
101
+ * Monotonic counter of this session's compaction cycle firings, incremented
102
+ * at session_before_compact (the watchdog arm site) and written into every
103
+ * compaction trace as `cycleId`. Without it a retry ladder is reconstructable
104
+ * only by entry ordering; with it, an outcome names the attempt it belongs
105
+ * to. Mirrors the watchdog's own per-arm counter.
106
+ */
107
+ compactionCycleId?: number;
108
+ /**
109
+ * Fingerprint of the current compaction cycle's INPUT (Pattern 8 delta-only
110
+ * skip). Computed at session_before_compact (before the branch is mutated),
111
+ * recorded into lastCompactionFingerprints on successful compaction, cleared
112
+ * on failure/abort.
113
+ */
114
+ pendingCompactionFingerprint?: string;
115
+ /**
116
+ * Per-leaf (sessionId::leafId) fingerprints of the last SUCCESSFUL compaction
117
+ * input. A later auto-compaction whose input fingerprint matches is skipped
118
+ * (no re-summarization of identical content — silent re-prime starvation).
119
+ */
120
+ lastCompactionFingerprints?: Record<string, string>;
121
+ /**
122
+ * Pre-compaction context usage (percent) captured at session_before_compact
123
+ * (the session_before_compact stage). Reuses the analyzeSession already performed there; consumed
124
+ * by the session_compact verify stage to check that the compaction actually
125
+ * recovered budget (post-compaction usage strictly below this, <=1pp slack).
126
+ * Cleared at the start of each compaction cycle so a stale value from a
127
+ * previous cycle can never trigger a false budget failure.
128
+ */
129
+ preCompactionUsagePercent?: number;
130
+ /**
131
+ * Set when the session_compact verify stage rejects a "successful" compaction
132
+ * (empty/boilerplate summary or budget not recovered). Records the failure
133
+ * truthfully on the archive path; it is NOT a gate anymore (the append-only
134
+ * originals archive is always-on per option B P1). Cleared by
135
+ * writeOriginalsArchive's finally, along with the capture.
136
+ */
137
+ verifyFailed?: boolean;
138
+ /**
139
+ * Who cancelled the current cycle, when the cancellation came from inside
140
+ * this extension: "extension" (a session_before_compact cancel return, e.g.
141
+ * the fingerprint skip), "watchdog" (the stall watchdog's ctx.abort()), or
142
+ * "summary-cap" (the bounded chunked path itself failed with a
143
+ * summary-cap-class error and the cycle was cancelled instead of falling
144
+ * through to pi-core's unbounded summarizer). Read and cleared by the
145
+ * session_compact_failed handler so an abort can be attributed (user Escape
146
+ * leaves it unset). Cleared at fresh-cycle start so a stale source never
147
+ * mislabels a later abort.
148
+ */
149
+ cancelSource?: "extension" | "watchdog" | "summary-cap";
150
+ /**
151
+ * The chunked summary's error text behind a "summary-cap" cancelSource
152
+ * cancel. Read and cleared by the session_compact_failed handler (the
153
+ * retry warn and the trace name the real error); cleared at fresh-cycle
154
+ * start with cancelSource so a stale text never mislabels a later cycle.
155
+ */
156
+ summaryCapCancelError?: string;
157
+ /**
158
+ * JSON serialization of the RAW compaction input (prep.messagesToSummarize)
159
+ * captured at session_before_compact — AFTER the fingerprint
160
+ * block, BEFORE the semantic-compression block (which replaces
161
+ * prep.messagesToSummarize in place, so the capture must see the raw
162
+ * originals). Consumed by the session_compact append-only originals archive
163
+ * write (always-on, on both the success and verify-failure
164
+ * paths); cleared on the session_compact outcome stage and on every
165
+ * session_compact_failed path so a stale capture never leaks into a later
166
+ * cycle.
167
+ */
168
+ pendingCompactionOriginals?: string;
169
+ /**
170
+ * Lazy per-session navigation-adoption counters.
171
+ * Created ONLY when a navigation/compression action actually succeeds —
172
+ * absent means the agent has not steered anywhere this session.
173
+ */
174
+ navigationAdoption?: NavigationAdoption;
175
+ /**
176
+ * ToolCallId → ISO timestamp of the first offloader flush, so the stub
177
+ * rendered into the per-request context stays byte-identical across LLM
178
+ * calls within a session (idempotent substitution). Lazily initialized by
179
+ * the offloader handler when the setting is enabled.
180
+ */
181
+ offloadIsoByToolCallId?: Record<string, string>;
182
+ /**
183
+ * ToolCallId → emergency stub record. Populated ONLY by an
184
+ * emergency offload run (context_window/413 error path); consumed by the
185
+ * context-emergency `context` handler to substitute stubs into the
186
+ * per-request context on every LLM call until the session rotates. Session-
187
+ * scoped via getExtensionState — never process-global.
188
+ */
189
+ emergencyStubsByToolCallId?: Record<string, import("./context-emergency.js").EmergencyStubRecord>;
190
+ }
191
+
192
+ /**
193
+ * State for the sliding-window compaction action (action="slide").
194
+ * Stored per-session via getExtensionState, consumed by session_before_compact.
195
+ */
196
+ export interface SlideModeState {
197
+ /** Whether slide mode is active for the current compaction cycle. */
198
+ active: boolean;
199
+ /** Entry ID to start keeping from (cut point). */
200
+ cutEntryId: string;
201
+ /** Number of entries to keep (the `keep` parameter). */
202
+ keepCount: number;
203
+ /** Number of entries dropped before the cut point. */
204
+ droppedCount: number;
205
+ /** Timestamp when slide mode was activated. */
206
+ timestamp: number;
207
+ }
208
+
209
+ /**
210
+ * State for the declared archive range (action="archive").
211
+ * Stored per-session via getExtensionState, consumed by session_before_compact.
212
+ * Carries the user's `summary` as the commitment-preserving anchor so the
213
+ * compaction summarizing LLM folds intent/changes/decisions/next-steps forward.
214
+ */
215
+ export interface RangeModeState {
216
+ /** Whether range mode is active for the current compaction cycle. */
217
+ active: boolean;
218
+ /** First entry index of the declared span. */
219
+ startIndex: number;
220
+ /** Last entry index of the declared span (inclusive). */
221
+ endIndex: number;
222
+ /** User-provided summary that must anchor the compaction summary. */
223
+ summary: string;
224
+ /** Topic label for the declared span. */
225
+ topic: string;
226
+ /** Entry id at endIndex+1 — the compaction boundary AFTER the declared span. */
227
+ firstKeptEntryId?: string;
228
+ /** True when the declared span reaches the branch end (no post-span entry to keep). */
229
+ boundaryIsBranchEnd: boolean;
230
+ /** Timestamp when range mode was activated. */
231
+ timestamp: number;
232
+ }
233
+
234
+ /**
235
+ * Recovery state armed by a summary token-cap failure (class "summary-cap").
236
+ * Consumed by the retry cycle's session_before_compact, which replaces the
237
+ * default summarization with a bounded chunked summary (reasoning off).
238
+ */
239
+ export interface SummaryCapRecoveryState {
240
+ /** Retry attempt the recovery was armed for (1-based, mirrors compactionRetryState). */
241
+ attempt: number;
242
+ /** Epoch ms when the recovery was armed (diagnostics only). */
243
+ armedAt: number;
244
+ /** Range anchor to fold into the chunked summary, when the failed cycle was a range archive. */
245
+ anchor?: { topic: string; summary: string };
246
+ }
247
+
248
+ export function getCmState(ctx: ExtensionContext): CmState {
249
+ return getExtensionState<CmState>(ctx, "context-manager", () => ({
250
+ checkoutParams: null,
251
+ pruningState: createPruningState(),
252
+ overflowNotified: false,
253
+ // H5: Retry guards initialized to false (prevents double-trigger)
254
+ compactionRetryActive: false,
255
+ overflowRetryActive: false,
256
+ compactionNoProgress: 0,
257
+ compactionFailsafeCut: undefined,
258
+ slideMode: null,
259
+ rangeMode: null,
260
+ pendingCompactionFingerprint: undefined,
261
+ lastCompactionFingerprints: {},
262
+ preCompactionUsagePercent: undefined,
263
+ verifyFailed: false,
264
+ pendingCompactionOriginals: undefined,
265
+ cancelSource: undefined,
266
+ summaryCapCancelError: undefined,
267
+ compactionCycleId: 0,
268
+ }));
269
+ }
270
+
271
+ // Navigation Adoption Counters
272
+ // Per-session counters measuring whether the agent STEERS with
273
+ // loss-preferring navigation (tag/checkout/log/archive/slide) instead of
274
+ // destructive compact. Fixed 7 kinds — no free-form counters. LONG-
275
+ // RUNNING-SESSIONS.md success metrics: "navigation adoption per long
276
+ // session ... trending up, compaction-per-session trending down". The block
277
+ // is lazily initialized by recordNavigationAction so an untouched session
278
+ // stays free of the field.
279
+
280
+ export interface NavigationAdoption {
281
+ tags: number;
282
+ checkouts: number;
283
+ logs: number;
284
+ archives: number;
285
+ slides: number;
286
+ compacts: number;
287
+ deepCleans: number;
288
+ }
289
+
290
+ export type NavigationActionKind =
291
+ | "tag"
292
+ | "checkout"
293
+ | "log"
294
+ | "archive"
295
+ | "slide"
296
+ | "compact"
297
+ | "deep_clean";
298
+
299
+ const NAVIGATION_KIND_FIELD: Record<NavigationActionKind, keyof NavigationAdoption> = {
300
+ tag: "tags",
301
+ checkout: "checkouts",
302
+ log: "logs",
303
+ archive: "archives",
304
+ slide: "slides",
305
+ compact: "compacts",
306
+ deep_clean: "deepCleans",
307
+ };
308
+
309
+ /**
310
+ * Lazily initialize the session navigation-adoption counter block and
311
+ * increment one fixed kind. Callers invoke this ONLY after the action has
312
+ * truly succeeded (the archive was declared, the compact was scheduled, the
313
+ * tag was written) — abort/error/no-op paths must never reach this helper so
314
+ * the counters measure real steering, not intent.
315
+ */
316
+ export function recordNavigationAction(ctx: ExtensionContext, kind: NavigationActionKind): void {
317
+ const state = getCmState(ctx);
318
+ if (!state.navigationAdoption) {
319
+ state.navigationAdoption = {
320
+ tags: 0,
321
+ checkouts: 0,
322
+ logs: 0,
323
+ archives: 0,
324
+ slides: 0,
325
+ compacts: 0,
326
+ deepCleans: 0,
327
+ };
328
+ }
329
+ state.navigationAdoption[NAVIGATION_KIND_FIELD[kind]]++;
330
+ }
331
+
332
+ /**
333
+ * One-line navigation-adoption summary for context_inspect detail=detailed.
334
+ * Loss-preferring navigation (tag/checkout/archive/slide, plus deep-cleans)
335
+ * is visually separated from destructive compacts. Returns null when no
336
+ * navigation action has succeeded yet (must not show an empty line).
337
+ */
338
+ export function formatNavigationAdoptionLine(na?: NavigationAdoption): string | null {
339
+ if (!na) return null;
340
+ return (
341
+ `navigation: ${na.tags} tags / ${na.checkouts} checkouts / ${na.logs} logs · ` +
342
+ `archives ${na.archives} / slides ${na.slides} (deep-cleans ${na.deepCleans}) vs compacts ${na.compacts}`
343
+ );
344
+ }
345
+
346
+ // Module-level retry state (process-scoped, not session-scoped)
347
+ export interface RetryState {
348
+ attempt: number;
349
+ lastError: string;
350
+ lastReason: string;
351
+ retryTimeout: ReturnType<typeof setTimeout> | null;
352
+ /**
353
+ * True from the moment a retry of this ladder is dispatched (the timer
354
+ * fired and ctx.compact() was called) until that cycle reports its outcome.
355
+ *
356
+ * The dispatch is pi-core's MANUAL compaction entry point, which begins by
357
+ * aborting the in-flight turn and every in-flight compaction controller, so
358
+ * the resulting turn_end lands BEFORE the dispatched cycle's own outcome.
359
+ * The turn-end reset keys on the absence of a pending timer, which the
360
+ * dispatch has already cleared - so without this flag the reset erases the
361
+ * attempt the retry was spending, every later failure restarts at attempt 1,
362
+ * and the exhausted rungs (the ladder's only terminal states) stay
363
+ * unreachable.
364
+ */
365
+ inFlight: boolean;
366
+ }
367
+
368
+ export const compactionRetryState: RetryState = {
369
+ attempt: 0,
370
+ lastError: "",
371
+ lastReason: "",
372
+ retryTimeout: null,
373
+ inFlight: false,
374
+ };
375
+
376
+ export const overflowRetryState: RetryState = {
377
+ attempt: 0,
378
+ lastError: "",
379
+ lastReason: "",
380
+ retryTimeout: null,
381
+ inFlight: false,
382
+ };
383
+
384
+ // Compaction-active state is per-session. The accessor functions here are
385
+ // a stable API; the underlying storage is session-scoped via
386
+ // getExtensionState (a module-level flag would leak across sessions).
387
+
388
+ interface CompactionActiveState {
389
+ active: boolean;
390
+ }
391
+
392
+ function getCompactionActiveState(ctx: ExtensionContext): CompactionActiveState {
393
+ return getExtensionState(ctx, "context-manager/compaction-active", () => ({
394
+ active: false,
395
+ }));
396
+ }
397
+
398
+ export function isCompactionActive(ctx?: ExtensionContext): boolean {
399
+ // Module-level call (no ctx) is supported for backward compat; returns
400
+ // the FIRST session's value, which is OK in pi's single-session-per-process.
401
+ if (!ctx) {
402
+ return _fallbackActive;
403
+ }
404
+ return getCompactionActiveState(ctx).active;
405
+ }
406
+
407
+ export function setCompactionActive(value: boolean, ctx: ExtensionContext): void {
408
+ getCompactionActiveState(ctx).active = value;
409
+ // Mirror to module-level fallback for ctx-less callers.
410
+ _fallbackActive = value;
411
+ }
412
+
413
+ // Module-level fallback used when callers don't have ctx. Updated by
414
+ // setCompactionActive() with the most recent value. In pi-core's
415
+ // single-session-per-process model this is equivalent to per-session.
416
+ let _fallbackActive = false;
417
+
418
+ // Constants
419
+ export const COMPACTION_RETRY_MAX_ATTEMPTS = 3;
420
+ export const OVERFLOW_RETRY_MAX_ATTEMPTS = 3;
421
+ export const OVERFLOW_RETRY_KEEP_REDUCTION_FACTOR = 0.6;
422
+ export const COMPACTION_RETRY_CUSTOM_TYPE = "__compaction_retry_trigger";
423
+
424
+ // Navigation helpers.
425
+ // Contract: resolveTarget returns null for any target that does not resolve
426
+ // to a real entry in the current session — passing a non-existent target to
427
+ // sm.branchWithSummary() fails upstream ("Entry not found"), and aborting on
428
+ // it kills the turn with a half-checked-out session. The caller is responsible
429
+ // for proposing a recovery via getRecoveryFallback() rather than dead-ending
430
+ // the turn.
431
+ export function resolveTarget(ctx: ExtensionContext, target?: string): string | null {
432
+ if (!target) return null;
433
+ const sm = getSessionManager(ctx);
434
+ const tree = sm.getTree();
435
+ if (tree.length === 0) return null;
436
+
437
+ if (target.toLowerCase() === "root") {
438
+ return tree[0].entry.id;
439
+ }
440
+
441
+ // Accept an 8+ hex-char ID only if it actually exists in the current
442
+ // session — a blind accept would let cross-session IDs leak through and
443
+ // fail upstream.
444
+ if (/^[0-9a-f]{8,}$/i.test(target)) {
445
+ for (const node of tree) {
446
+ if (node.entry.id === target) return target;
447
+ }
448
+ return null;
449
+ }
450
+
451
+ // Label lookup.
452
+ for (const node of tree) {
453
+ if (sm.getLabel(node.entry.id) === target) return node.entry.id;
454
+ }
455
+ return null;
456
+ }
457
+
458
+ /**
459
+ * Get a recovery target when the requested target is not in the current
460
+ * session. Priority: (1) most recent tag, (2) the most recent non-internal
461
+ * user/assistant message, (3) the session root. Returns null when the
462
+ * session is empty.
463
+ *
464
+ * Used by `context_navigate` checkout to avoid the "Entry not found"
465
+ * dead-end that was corrupting the session.
466
+ */
467
+ export function getRecoveryFallback(
468
+ ctx: ExtensionContext,
469
+ _requested: string,
470
+ ): { id: string; label: string; reason: string } | null {
471
+ const sm = getSessionManager(ctx);
472
+ const branch = sm.getBranch();
473
+ if (branch.length === 0) return null;
474
+
475
+ // Priority 1: most recent tag in the current branch.
476
+ for (let i = branch.length - 1; i >= 0; i--) {
477
+ const label = sm.getLabel(branch[i].id);
478
+ if (label) {
479
+ return { id: branch[i].id, label, reason: "most-recent-tag" };
480
+ }
481
+ }
482
+
483
+ // Priority 2: session root.
484
+ const tree = sm.getTree();
485
+ if (tree.length > 0) {
486
+ return { id: tree[0].entry.id, label: "root", reason: "session-root" };
487
+ }
488
+
489
+ return null;
490
+ }
491
+
492
+ export function findByLabel(ctx: ExtensionContext, label: string): string | null {
493
+ const sm = getSessionManager(ctx);
494
+ const tree = sm.getTree();
495
+ for (const node of tree) {
496
+ if (sm.getLabel(node.entry.id) === label) return node.entry.id;
497
+ }
498
+ return null;
499
+ }
500
+
501
+ export function resolveDefaultTarget(ctx: ExtensionContext): string | null {
502
+ const sm = getSessionManager(ctx);
503
+ const branch = sm.getBranch();
504
+ let targetId: string | null = null;
505
+ for (let i = branch.length - 1; i >= 0; i--) {
506
+ const entry = branch[i];
507
+ if (entry.type === "message") {
508
+ const msg = entry.message;
509
+ if (msg?.role === "toolResult") {
510
+ if (!isInternal(String(msg.toolName ?? ""))) {
511
+ targetId = entry.id;
512
+ break;
513
+ }
514
+ } else if (msg?.role === "assistant") {
515
+ const hasInternal =
516
+ Array.isArray(msg.content) &&
517
+ msg.content.some(
518
+ (c: { type?: string; name?: string }) =>
519
+ c.type === "toolCall" && isInternal(String(c.name ?? "")),
520
+ );
521
+ if (!hasInternal) {
522
+ targetId = entry.id;
523
+ break;
524
+ }
525
+ }
526
+ }
527
+ break;
528
+ }
529
+ if (!targetId && branch.length > 0) targetId = sm.getLeafId();
530
+ return targetId;
531
+ }
532
+
533
+ // Retry helpers
534
+ export function resetCompactionRetry(): void {
535
+ if (compactionRetryState.retryTimeout) clearTimeout(compactionRetryState.retryTimeout);
536
+ compactionRetryState.attempt = 0;
537
+ compactionRetryState.lastError = "";
538
+ compactionRetryState.lastReason = "";
539
+ compactionRetryState.retryTimeout = null;
540
+ compactionRetryState.inFlight = false;
541
+ }
542
+
543
+ export function resetOverflowRetry(): void {
544
+ if (overflowRetryState.retryTimeout) clearTimeout(overflowRetryState.retryTimeout);
545
+ overflowRetryState.attempt = 0;
546
+ overflowRetryState.lastError = "";
547
+ overflowRetryState.lastReason = "";
548
+ overflowRetryState.retryTimeout = null;
549
+ overflowRetryState.inFlight = false;
550
+ }
551
+
552
+ /**
553
+ * The dispatched cycle reported an outcome: the dispatch is over. Only the
554
+ * in-flight marker is cleared - the attempt counter is the ladder's progress
555
+ * and survives until the ladder itself settles.
556
+ */
557
+ export function settleCompactionRetry(): void {
558
+ compactionRetryState.inFlight = false;
559
+ }
560
+
561
+ export function settleOverflowRetry(): void {
562
+ overflowRetryState.inFlight = false;
563
+ }
564
+
565
+ // Compaction Fail-Safe Ladder
566
+ // The ladder above bounds how many times a cycle may fail before it is
567
+ // declared exhausted. It cannot bound the case that motivated this state: at
568
+ // or above the critical usage band pi-core re-fires threshold compaction on
569
+ // every turn, and a cycle that ends with no entry (an aborted cycle carries no
570
+ // error text at all) leaves the session exactly as full as it was. Nothing in
571
+ // the per-cycle routing can see that repetition, so the repetition itself is
572
+ // the signal: N consecutive cycles with no landed entry while the session is
573
+ // over the threshold means no summarizer run is going to land, and the next
574
+ // cycle must compact deterministically instead.
575
+
576
+ /**
577
+ * Consecutive no-progress cycles tolerated above the critical band before the
578
+ * deterministic cut is armed. One abort is an operator Escape and two can be a
579
+ * coincidence; three cycles that each leave the session over its threshold is
580
+ * a loop.
581
+ */
582
+ export const COMPACTION_NO_PROGRESS_LIMIT = 3;
583
+
584
+ /** The deterministic cut armed for the next compaction cycle. */
585
+ export interface FailsafeCutState {
586
+ /** Why the cut was armed - carried into the landed summary. */
587
+ reason: string;
588
+ /** Epoch ms the cut was armed (diagnostics only). */
589
+ armedAt: number;
590
+ }
591
+
592
+ /**
593
+ * Count one cycle that landed no compaction entry. Returns the running count
594
+ * for this session, so the caller decides on the value it just produced.
595
+ */
596
+ export function noteCompactionNoProgress(ctx: ExtensionContext): number {
597
+ const cmState = getCmState(ctx);
598
+ cmState.compactionNoProgress = (cmState.compactionNoProgress ?? 0) + 1;
599
+ return cmState.compactionNoProgress;
600
+ }
601
+
602
+ /**
603
+ * A compaction landed: the no-progress ladder is broken, so neither the count
604
+ * nor an armed cut outlives it.
605
+ */
606
+ export function clearCompactionFailsafe(ctx: ExtensionContext): void {
607
+ const cmState = getCmState(ctx);
608
+ cmState.compactionNoProgress = 0;
609
+ cmState.compactionFailsafeCut = undefined;
610
+ }
611
+
612
+ /**
613
+ * Arm the deterministic cut for the next cycle. Idempotent: returns true only
614
+ * for the call that armed it, so one no-progress sequence dispatches exactly
615
+ * one compaction.
616
+ */
617
+ export function armCompactionFailsafeCut(ctx: ExtensionContext, reason: string): boolean {
618
+ const cmState = getCmState(ctx);
619
+ if (cmState.compactionFailsafeCut) return false;
620
+ cmState.compactionFailsafeCut = { reason, armedAt: Date.now() };
621
+ return true;
622
+ }
623
+
624
+ /**
625
+ * Take the armed cut, if any, for the cycle that is starting. The cut is
626
+ * one-shot: the consuming cycle owns the outcome, and a landed compaction
627
+ * clears the whole fail-safe state.
628
+ */
629
+ export function consumeCompactionFailsafeCut(ctx: ExtensionContext): FailsafeCutState | undefined {
630
+ const cmState = getCmState(ctx);
631
+ const armed = cmState.compactionFailsafeCut;
632
+ cmState.compactionFailsafeCut = undefined;
633
+ return armed;
634
+ }
635
+
636
+ export function getCompactionRetryDelay(attempt: number): number {
637
+ return 3000 * Math.pow(2, attempt - 1); // 3s, 6s, 12s
638
+ }
639
+
640
+ export function getOverflowRetryDelay(attempt: number): number {
641
+ return 2000 * Math.pow(2, attempt - 1); // 2s, 4s, 8s
642
+ }
643
+
644
+ export function isTransientCompactionError(errorMessage?: string): boolean {
645
+ if (!errorMessage) return false;
646
+ const transientPatterns = [
647
+ /529/,
648
+ /overloaded/i,
649
+ /rate.?limit/i,
650
+ /too many requests/i,
651
+ /server error/i,
652
+ /service unavailable/i,
653
+ /503/,
654
+ /502/,
655
+ /network/i,
656
+ /timeout/i,
657
+ /ECONNRESET/i,
658
+ ];
659
+ return transientPatterns.some((p) => p.test(errorMessage));
660
+ }
661
+
662
+ export function isContextWindowError(errorMessage?: string): boolean {
663
+ if (!errorMessage) return false;
664
+ const contextWindowPatterns = [
665
+ /context window exceeds limit/i,
666
+ /context length exceeded/i,
667
+ /maximum context length/i,
668
+ /token limit exceeded/i,
669
+ /too many tokens/i,
670
+ /invalid_request_error.*context/i,
671
+ ];
672
+ return contextWindowPatterns.some((p) => p.test(errorMessage));
673
+ }
674
+
675
+ // Rotation utilities (the cyclic-import-free home for the rotation summary).
676
+
677
+ /**
678
+ * Build a summary of the current session for continuity across rotations.
679
+ */
680
+ export function buildContinuationSummary(ctx: ExtensionContext): string {
681
+ try {
682
+ const sm = ctx.sessionManager as {
683
+ getBranch?(): Array<{
684
+ id: string;
685
+ type?: string;
686
+ message?: { role?: string; content?: string | Array<{ text?: string }> };
687
+ }>;
688
+ getLabel?(id: string): string | undefined;
689
+ };
690
+ const branch = sm.getBranch?.() ?? [];
691
+ const tags: string[] = [];
692
+
693
+ for (const entry of branch) {
694
+ const label = sm.getLabel?.(entry.id);
695
+ if (label) tags.push(label);
696
+ }
697
+
698
+ const lines: string[] = [
699
+ "## Session Continuation",
700
+ "",
701
+ "This session continues from a previous session that was rotated.",
702
+ "",
703
+ `Previous session: ${branch.length} entries, ${tags.length} tags`,
704
+ ];
705
+
706
+ if (tags.length > 0) {
707
+ lines.push(`Tags preserved: ${tags.join(", ")}`);
708
+ }
709
+
710
+ const recentUserMessages: string[] = [];
711
+ for (let i = branch.length - 1; i >= Math.max(0, branch.length - 5); i--) {
712
+ const entry = branch[i];
713
+ if (entry.type === "message" && entry.message?.role === "user") {
714
+ const text =
715
+ typeof entry.message.content === "string"
716
+ ? entry.message.content
717
+ : (entry.message.content?.[0]?.text ?? "");
718
+ if (text) recentUserMessages.unshift(text.slice(0, 200));
719
+ }
720
+ }
721
+
722
+ if (recentUserMessages.length > 0) {
723
+ lines.push("", "Recent context:");
724
+ for (const msg of recentUserMessages.slice(-3)) {
725
+ lines.push(`- ${msg}`);
726
+ }
727
+ }
728
+
729
+ lines.push("", "Use the `memory` tool to retrieve cross-session knowledge.");
730
+
731
+ return lines.join("\n");
732
+ } catch {
733
+ return "Session continuation from rotated session. Use the `memory` tool for context.";
734
+ }
735
+ }
736
+
737
+ /**
738
+ * Emergency rotation trigger - called when context overflow is imminent.
739
+ */
740
+ export function triggerEmergencyRotation(pi: ExtensionAPI, ctx: ExtensionContext): void {
741
+ try {
742
+ const state = getRotationState();
743
+ if (state.pendingRotation) {
744
+ log.info("[Emergency] Rotation already pending, skipping duplicate trigger");
745
+ return;
746
+ }
747
+
748
+ state.pendingRotation = true;
749
+ state.emergencyRotation = true;
750
+ state.continuationSummary = buildContinuationSummary(ctx);
751
+
752
+ sendTrackedMessage(
753
+ pi,
754
+ {
755
+ customType: "context",
756
+ content: [
757
+ {
758
+ type: "text" as const,
759
+ text: [
760
+ "## Session Rotation Required",
761
+ "",
762
+ "Context overflow detected. Automatic rotation triggered to prevent data loss.",
763
+ "",
764
+ "Please call `finalize()` to complete this task and start fresh.",
765
+ "",
766
+ "Rotation will happen automatically on next `finalize()`.",
767
+ ].join("\n"),
768
+ },
769
+ ],
770
+ display: true,
771
+ },
772
+ { deliverAs: "steer", triggerTurn: true },
773
+ { type: "context", source: "context-manager/rotation" },
774
+ );
775
+
776
+ log.info("[Emergency] Rotation triggered due to context overflow risk");
777
+ } catch (err) {
778
+ log.error("[Emergency] Rotation trigger failed:", err);
779
+ }
780
+ }
781
+
782
+ // Compaction Health Metrics
783
+ // Tracks compaction outcomes across sessions for analytics and retry tuning.
784
+
785
+ export interface CompactionHealth {
786
+ totalCompactions: number;
787
+ totalFailures: number;
788
+ /** Total aborted (user-cancelled) compactions, counted distinctly from failures. */
789
+ totalAborted: number;
790
+ /** Aborted compactions where another compaction was in-flight when the aborted cycle began. */
791
+ inFlightAborted: number;
792
+ totalTokensBefore: number;
793
+ totalTokensAfter: number;
794
+ totalEntriesRemoved: number;
795
+ /** Verify-stage rejections (rollback count): a compaction the coherence/budget verify rejected. */
796
+ totalVerifyFailures: number;
797
+ /** Option B always-on originals archives actually appended to disk (coverage, NOT loss). */
798
+ totalArchivesWritten: number;
799
+ /**
800
+ * Last successful compaction (surface): raw summarization-input
801
+ * message count from the cycle's originals capture. Absent = never measured
802
+ * (degrade-to-absent telemetry, never wrong).
803
+ */
804
+ lastCompactedMessages?: number;
805
+ /** Last successful compaction: live messages kept from the first-kept anchor. Absent = never measured. */
806
+ lastKeptMessages?: number;
807
+ lastOutcome: "success" | "failure" | "partial" | "aborted" | null;
808
+ lastErrorMessage?: string;
809
+ }
810
+
811
+ const compactionHealth: CompactionHealth = {
812
+ totalCompactions: 0,
813
+ totalFailures: 0,
814
+ totalAborted: 0,
815
+ inFlightAborted: 0,
816
+ totalTokensBefore: 0,
817
+ totalTokensAfter: 0,
818
+ totalEntriesRemoved: 0,
819
+ totalVerifyFailures: 0,
820
+ totalArchivesWritten: 0,
821
+ lastOutcome: null,
822
+ };
823
+
824
+ export function getCompactionHealth(): CompactionHealth {
825
+ return compactionHealth;
826
+ }
827
+
828
+ /** Reset all compaction-health counters. Used by tests and session-start resets. */
829
+ export function resetCompactionHealth(): void {
830
+ compactionHealth.totalCompactions = 0;
831
+ compactionHealth.totalFailures = 0;
832
+ compactionHealth.totalAborted = 0;
833
+ compactionHealth.inFlightAborted = 0;
834
+ compactionHealth.totalTokensBefore = 0;
835
+ compactionHealth.totalTokensAfter = 0;
836
+ compactionHealth.totalEntriesRemoved = 0;
837
+ compactionHealth.totalVerifyFailures = 0;
838
+ compactionHealth.totalArchivesWritten = 0;
839
+ compactionHealth.lastOutcome = null;
840
+ delete compactionHealth.lastCompactedMessages;
841
+ delete compactionHealth.lastKeptMessages;
842
+ delete compactionHealth.lastErrorMessage;
843
+ }
844
+
845
+ /**
846
+ * One-line compaction summary for context_inspect / heartbeat analytics.
847
+ * Returns null only when there is nothing worth reporting: no loss signals
848
+ * AND no originals archives written (i.e. no compaction activity at all).
849
+ *
850
+ * Loss gate: ONLY loss signals (aborts, generic failures, verify rollbacks)
851
+ * keep the loss portion alive. Archives-written is COVERAGE, not loss — it
852
+ * never contributes to the gate, but is reported as non-loss telemetry
853
+ * whenever compaction activity happened (even with zero failures), so the
854
+ * always-on archive surface is measurable.
855
+ */
856
+ export function formatCompactionLossLine(): string | null {
857
+ const bad =
858
+ compactionHealth.totalAborted +
859
+ compactionHealth.totalFailures +
860
+ compactionHealth.inFlightAborted +
861
+ compactionHealth.totalVerifyFailures;
862
+ const archives = compactionHealth.totalArchivesWritten;
863
+ const lastCompacted = compactionHealth.lastCompactedMessages;
864
+ // A last-compaction measurement is compaction activity worth surfacing —
865
+ // include it in the gate alongside loss signals and archive coverage.
866
+ if (bad === 0 && archives === 0 && lastCompacted === undefined) return null;
867
+ const parts: string[] = [];
868
+ if (bad > 0) {
869
+ parts.push(
870
+ `compaction loss: ${compactionHealth.inFlightAborted} in-flight aborts, ` +
871
+ `${compactionHealth.totalFailures} failures, ${compactionHealth.totalCompactions} compacts`,
872
+ );
873
+ }
874
+ // A verify rejection is a loss signal (a rollback happened) — report it
875
+ // next to the failure counts.
876
+ if (compactionHealth.totalVerifyFailures > 0) {
877
+ parts.push(`verify rollbacks: ${compactionHealth.totalVerifyFailures}`);
878
+ }
879
+ // Coverage telemetry, NOT loss: emitted only when archives actually exist —
880
+ // still reported when failures are zero, so a bare abort/loss with no
881
+ // archives never gains an `archives: 0` suffix.
882
+ if (archives > 0) {
883
+ parts.push(`archives: ${archives}`);
884
+ }
885
+ // The compacted-vs-kept counters of the last successful
886
+ // compaction (kept side degrades to "?" when its source was absent).
887
+ if (lastCompacted !== undefined) {
888
+ parts.push(
889
+ `last compaction: ${lastCompacted} compacted → ${compactionHealth.lastKeptMessages ?? "?"} kept`,
890
+ );
891
+ }
892
+ return parts.join(" · ");
893
+ }
894
+
895
+ export function recordCompactionOutcome(
896
+ outcome: CompactionHealth["lastOutcome"],
897
+ details?: {
898
+ tokensBefore?: number;
899
+ tokensAfter?: number;
900
+ entriesRemoved?: number;
901
+ errorMessage?: string;
902
+ /** Whether another compaction was in-flight when this cycle began (abort tagging, P2a). */
903
+ inFlight?: boolean;
904
+ /** Surface: this cycle's raw summarization-input count (absent = not measured). */
905
+ compactedMessages?: number;
906
+ /** Surface: live messages kept from the first-kept anchor (absent = not measured). */
907
+ keptMessages?: number;
908
+ },
909
+ ): void {
910
+ compactionHealth.lastOutcome = outcome;
911
+ if (outcome === "success") {
912
+ compactionHealth.totalCompactions++;
913
+ if (details?.tokensBefore) compactionHealth.totalTokensBefore += details.tokensBefore;
914
+ if (details?.tokensAfter) compactionHealth.totalTokensAfter += details.tokensAfter;
915
+ if (details?.entriesRemoved) compactionHealth.totalEntriesRemoved += details.entriesRemoved;
916
+ // Last-compaction counters (reassigned every success so a
917
+ // stale value from an earlier cycle can never masquerade as current).
918
+ compactionHealth.lastCompactedMessages = details?.compactedMessages;
919
+ compactionHealth.lastKeptMessages = details?.keptMessages;
920
+ } else if (outcome === "aborted") {
921
+ // P2a: aborts are counted distinctly from failures and successes.
922
+ compactionHealth.totalAborted++;
923
+ if (details?.inFlight) compactionHealth.inFlightAborted++;
924
+ compactionHealth.lastErrorMessage = details?.errorMessage;
925
+ } else {
926
+ compactionHealth.totalFailures++;
927
+ compactionHealth.lastErrorMessage = details?.errorMessage;
928
+ }
929
+ }
930
+
931
+ /**
932
+ * Increment a non-outcome CompactionHealth counter.
933
+ * Distinct from recordCompactionOutcome (which encodes the cycle outcome as a
934
+ * whole): these two counters measure the real state — every verify
935
+ * rejection is a rollback (loss), every originals archive append is coverage
936
+ * (not loss). Callers only bump the archive counter AFTER a successful
937
+ * appendFileSync so a failed write never inflates coverage.
938
+ */
939
+ export function recordCompactionHealth(
940
+ counter: "totalVerifyFailures" | "totalArchivesWritten",
941
+ ): void {
942
+ compactionHealth[counter]++;
943
+ }
944
+
945
+ // Formatting helpers
946
+
947
+ export function formatPruneCandidates(candidates: any[], count?: number): string {
948
+ const lines: string[] = [];
949
+ for (let i = 0; i < (count ?? candidates.length); i++) {
950
+ const c = candidates[i];
951
+ if (!c) break;
952
+ const role = c.role || "?";
953
+ const preview = (c.preview || "").slice(0, 60);
954
+ const reason = c.reason || "unknown";
955
+ const age = c.age !== undefined ? `${c.age} turns` : "?";
956
+ const score = c.score !== undefined ? `${(c.score * 100).toFixed(0)}%` : "?";
957
+ lines.push(`${i + 1}. [${role}] ${preview} (age: ${age}, score: ${score})`);
958
+ lines.push(` Reason: ${reason}`);
959
+ }
960
+ return lines.join("\n");
961
+ }