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,132 @@
1
+ /**
2
+ * Consolidated Topic Critic -- single LLM call for all 3 topic-drift checks.
3
+ *
4
+ * Replaces 3 parallel classify() calls (topicCoverage, topicDivergence,
5
+ * topicCompleteness) with one structured-output LLM call that returns all
6
+ * three verdicts as JSON. Falls back to conservative heuristic fallbacks
7
+ * (topicDriftFallback -> "no" for all dimensions) on failure.
8
+ *
9
+ * Benefits:
10
+ * - 3x fewer LLM calls -> ~66% latency reduction at turn_end
11
+ * - Single system prompt shared across all three dimensions
12
+ * - Model can cross-reference dimensions (e.g., divergence vs coverage)
13
+ * - Same return interface -- drop-in replacement for both call sites
14
+ * (lib/detection/topic-drift-detector.ts and the extension handler)
15
+ *
16
+ * Output budget: the answer is ~40 tokens of JSON, but thinking tokens count
17
+ * against max_tokens on every reasoning model braid routes to, and the channel
18
+ * cannot be switched off for a model whose thinkingLevelMap declares no "off"
19
+ * level (pi-ai clamps "off" to the lowest declared level). So a small explicit
20
+ * ceiling is a ceiling on thinking and the JSON body never gets written. The
21
+ * mechanism that answers this - first completion with no maxTokens, one
22
+ * enlarged-budget retry when a completion ends at its ceiling without a
23
+ * verdict - lives in lib/ai/judge-budget.ts and is shared with the other two
24
+ * consolidated judges.
25
+ */
26
+ import { extractJson } from "../../lib/utils/extract-json.js";
27
+ import { createLogger } from "../../lib/core/logger.js";
28
+ import { judgeAcrossTiers, } from "../../lib/ai/judge-budget.js";
29
+ const log = createLogger("consolidated-topic-critic");
30
+ // ── Consolidated Prompt ──────────────────────────────────────────────────────
31
+ const SYSTEM_PROMPT = "You are a topic-drift analyzer. You do one thing: " +
32
+ "read an original request and an agent response inside XML tags, " +
33
+ "and rate the response on three binary dimensions. " +
34
+ "Respond with a valid JSON object containing exactly these three fields. " +
35
+ "No explanation, no markdown, no other text.";
36
+ const USER_PROMPT = "Analyze the response against the original request. Respond with valid JSON only:\n" +
37
+ "{\n" +
38
+ ' "coversTopic": true|false, // Does the response still address the original request? (true = yes, still relevant)\n' +
39
+ ' "hasDiverged": true|false, // Has the response shifted to a substantially different topic? (true = yes, drifted away)\n' +
40
+ ' "isComplete": true|false // Does the response cover all key topics from the request? (true = complete)\n' +
41
+ "}\n\n" +
42
+ "<original>\n{{original}}\n</original>\n\n" +
43
+ "<response>\n{{response}}\n</response>";
44
+ // ── Main Function ────────────────────────────────────────────────────────────
45
+ /**
46
+ * Consolidated topic critique -- single LLM call for all 3 drift dimensions.
47
+ *
48
+ * Model tier strategy (modelPreference: "quality"):
49
+ * 1. Try session model (cheap, may already be powerful)
50
+ * 2. If session fails, try utility model
51
+ * 3. If both fail, try max-power model (accuracy-critical safety net)
52
+ * 4. If all fail, use conservative defaults (no drift detected)
53
+ */
54
+ export async function consolidatedTopicCritique(original, response, ctx) {
55
+ const truncatedOriginal = original.length > 2000 ? original.slice(0, 2000) + "..." : original;
56
+ const truncatedResponse = response.length > 2000 ? response.slice(0, 2000) + "..." : response;
57
+ const start = Date.now();
58
+ // ── Attempt consolidated LLM call ──────────────────────────────────────
59
+ const verdict = await tryConsolidatedCall(truncatedOriginal, truncatedResponse, ctx);
60
+ if (verdict) {
61
+ const latency = Date.now() - start;
62
+ log.debug(`[consolidated-topic] OK ${latency}ms: ${JSON.stringify(verdict)}`);
63
+ return {
64
+ // coverage="no" -> bad (does NOT address request), so invert coversTopic
65
+ coverage: verdict.coversTopic,
66
+ divergence: verdict.hasDiverged,
67
+ completeness: verdict.isComplete,
68
+ classifierDown: false,
69
+ };
70
+ }
71
+ // ── Fallback: conservative defaults (no drift) ─────────────────────────
72
+ log.debug("[consolidated-topic] LLM failed, using conservative defaults");
73
+ return {
74
+ coverage: true,
75
+ divergence: false,
76
+ completeness: true,
77
+ classifierDown: true,
78
+ };
79
+ }
80
+ // ── Internal Helpers ─────────────────────────────────────────────────────────
81
+ /**
82
+ * The consolidated judge, across the model tiers, on the shared output-budget
83
+ * contract (lib/ai/judge-budget.ts): session model first, then utility, then
84
+ * max-power as safety net, each with at most one enlarged-budget retry.
85
+ */
86
+ async function tryConsolidatedCall(original, response, ctx) {
87
+ const userMessage = USER_PROMPT.replace("{{original}}", original).replace("{{response}}", response);
88
+ const outcome = await judgeAcrossTiers({
89
+ ctx,
90
+ systemPrompt: SYSTEM_PROMPT,
91
+ userMessage,
92
+ read: readTopicVerdict,
93
+ label: "consolidated-topic",
94
+ });
95
+ return outcome.ok ? outcome.verdict : null;
96
+ }
97
+ /**
98
+ * Read one completion as a topic-drift verdict. The mapping from "what the
99
+ * model said" to "why there is no verdict" is this judge's business; the retry
100
+ * decision above it is not.
101
+ */
102
+ function readTopicVerdict(view) {
103
+ const jsonStr = extractJson(view.text);
104
+ if (!jsonStr) {
105
+ log.debug(`[consolidated-topic] No JSON found from ${view.model.id} ${view.elapsedMs}ms: ${view.text.slice(0, 100)}`);
106
+ return {
107
+ ok: false,
108
+ reason: view.atCeiling ? "budget-exhausted" : "unparseable",
109
+ detail: `${view.text.length} chars of response, no JSON`,
110
+ };
111
+ }
112
+ let parsed;
113
+ try {
114
+ parsed = JSON.parse(jsonStr);
115
+ }
116
+ catch {
117
+ log.debug(`[consolidated-topic] Unparseable JSON from ${view.model.id}: ${jsonStr.slice(0, 100)}`);
118
+ return {
119
+ ok: false,
120
+ reason: view.atCeiling ? "budget-exhausted" : "unparseable",
121
+ detail: `enclosed object is not parseable JSON`,
122
+ };
123
+ }
124
+ if (typeof parsed.coversTopic === "boolean" &&
125
+ typeof parsed.hasDiverged === "boolean" &&
126
+ typeof parsed.isComplete === "boolean") {
127
+ return { ok: true, verdict: parsed };
128
+ }
129
+ log.debug(`[consolidated-topic] Invalid fields from ${view.model.id}: ${jsonStr}`);
130
+ return { ok: false, reason: "invalid-fields", detail: `JSON without the three boolean fields` };
131
+ }
132
+ //# sourceMappingURL=consolidated-topic-critic.js.map
@@ -0,0 +1,70 @@
1
+ /**
2
+ * Context Information Density Evaluator
3
+ *
4
+ * Measures signal-to-noise ratio in context to predict when context management
5
+ * is needed. Based on:
6
+ * - SimpleMem (2601.02553): 30x token reduction via semantic structured compression
7
+ * - GenericAgent (2604.17091): Information density, not length, determines performance
8
+ *
9
+ * Key insight: Count-based thresholds miss the real problem. A 50-message context with
10
+ * high signal is better than a 10-message context with mostly boilerplate.
11
+ *
12
+ * Density evaluation uses a two-tier approach:
13
+ * Tier 1 (default): Fast heuristic - token counting + sample-based LLM judge
14
+ * Tier 2 (opt-in): Full LLM judge via contextDensity critic for overall assessment
15
+ */
16
+ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
17
+ export interface DensityResult {
18
+ /** Signal / (signal + noise), 0-1. Higher = more informative context. */
19
+ density: number;
20
+ /** Messages with meaningful, non-boilerplate content. */
21
+ signalMessages: number;
22
+ /** Messages that are pure boilerplate, duplication, or noise. */
23
+ noisyMessages: number;
24
+ /** Messages that appear nearly identical to previous messages. */
25
+ duplicates: number;
26
+ /** Estimated token count of context. */
27
+ totalTokens: number;
28
+ /** tokens / tokenLimit, 0-1. */
29
+ tokenRatio: number;
30
+ /** LLM judge density label if evaluateContextDensityWithJudge was used. */
31
+ judgeLabel?: "HIGH" | "MEDIUM" | "LOW";
32
+ }
33
+ export type CompressionStrategy = "aggressive" | "semantic" | "conservative" | "none";
34
+ /**
35
+ * Evaluate the information density of a session's context.
36
+ *
37
+ * Uses fast heuristic (token counting + hash-based dedup). For semantic
38
+ * density assessment, call evaluateContextDensityWithJudge() instead.
39
+ *
40
+ * @param ctx - ExtensionContext to access session entries
41
+ * @returns DensityResult with aggregate metrics
42
+ */
43
+ export declare function evaluateContextDensity(ctx: ExtensionContext): DensityResult;
44
+ /**
45
+ * Evaluate context density using an LLM judge for semantic assessment.
46
+ *
47
+ * Samples messages from the context and uses classify() with the
48
+ * contextDensity critic to assess signal-to-noise ratio holistically.
49
+ * Falls back to fast heuristic when LLM is unavailable.
50
+ *
51
+ * Call this when you need a deeper understanding of context quality
52
+ * (e.g., before deciding whether to compress or archive).
53
+ *
54
+ * NOTE: Defined but never called. The context-density heuristic path
55
+ * (evaluateContextDensity) is used instead. Kept for future wiring
56
+ * when LLM-based density assessment is needed.
57
+ *
58
+ * @param ctx - ExtensionContext
59
+ * @returns DensityResult with an additional judgeLabel field
60
+ */
61
+ export declare function evaluateContextDensityWithJudge(ctx: ExtensionContext): Promise<DensityResult>;
62
+ /**
63
+ * Recommend a compression strategy based on context density.
64
+ *
65
+ * Low density (< 0.4): Aggressive pruning - remove noise, keep signal
66
+ * Medium density (0.4-0.7): Semantic compression - summarize without losing meaning
67
+ * High density (> 0.7): Conservative - only compress if context is large
68
+ */
69
+ export declare function recommendCompressionStrategy(density: DensityResult): CompressionStrategy;
70
+ //# sourceMappingURL=context-density.d.ts.map
@@ -0,0 +1,193 @@
1
+ /**
2
+ * Context Information Density Evaluator
3
+ *
4
+ * Measures signal-to-noise ratio in context to predict when context management
5
+ * is needed. Based on:
6
+ * - SimpleMem (2601.02553): 30x token reduction via semantic structured compression
7
+ * - GenericAgent (2604.17091): Information density, not length, determines performance
8
+ *
9
+ * Key insight: Count-based thresholds miss the real problem. A 50-message context with
10
+ * high signal is better than a 10-message context with mostly boilerplate.
11
+ *
12
+ * Density evaluation uses a two-tier approach:
13
+ * Tier 1 (default): Fast heuristic - token counting + sample-based LLM judge
14
+ * Tier 2 (opt-in): Full LLM judge via contextDensity critic for overall assessment
15
+ */
16
+ import { classify } from "../ai/text-classifier.js";
17
+ import { CRITICS } from "../ai/critic-registry.js";
18
+ import { getResolvedContextWindow } from "../config/braid-settings.js";
19
+ const MIN_SIGNAL_LENGTH = 30;
20
+ const CHARS_PER_TOKEN = 4;
21
+ function countTokens(text) {
22
+ return Math.ceil(text.length / CHARS_PER_TOKEN);
23
+ }
24
+ /** Simple string hash for duplicate detection. */
25
+ function simpleHash(s) {
26
+ let h = 0;
27
+ for (let i = 0; i < Math.min(s.length, 200); i++) {
28
+ h = (Math.imul(31, h) + s.charCodeAt(i)) | 0;
29
+ }
30
+ return h;
31
+ }
32
+ // ── Main Evaluator (heuristic + optional LLM judge) ──────────────────────────
33
+ /**
34
+ * Evaluate the information density of a session's context.
35
+ *
36
+ * Uses fast heuristic (token counting + hash-based dedup). For semantic
37
+ * density assessment, call evaluateContextDensityWithJudge() instead.
38
+ *
39
+ * @param ctx - ExtensionContext to access session entries
40
+ * @returns DensityResult with aggregate metrics
41
+ */
42
+ export function evaluateContextDensity(ctx) {
43
+ let entries = [];
44
+ try {
45
+ entries = ctx.sessionManager?.getEntries?.() ?? [];
46
+ }
47
+ catch {
48
+ /* fallback: empty */
49
+ }
50
+ let totalTokens = 0;
51
+ let signalMessages = 0;
52
+ let noisyMessages = 0;
53
+ let duplicates = 0;
54
+ // Deduplication: track recent message hashes
55
+ const recentHashes = new Set();
56
+ const MAX_RECENT = 20;
57
+ for (const entry of entries) {
58
+ let content = "";
59
+ if (entry.type === "message" && entry.message) {
60
+ const msg = entry.message;
61
+ content =
62
+ typeof msg.content === "string"
63
+ ? msg.content
64
+ : Array.isArray(msg.content)
65
+ ? msg.content.map((c) => c.text ?? "").join(" ")
66
+ : "";
67
+ }
68
+ else if (entry.type === "tool_result" && entry.result) {
69
+ content = typeof entry.result === "string" ? entry.result : JSON.stringify(entry.result);
70
+ }
71
+ else if (entry.type === "custom") {
72
+ // Skip custom entries (memory, retry state, etc.)
73
+ continue;
74
+ }
75
+ if (!content)
76
+ continue;
77
+ const tokens = countTokens(content);
78
+ const clean = content.trim();
79
+ const isTooShort = clean.length < MIN_SIGNAL_LENGTH;
80
+ // Duplicate detection: hash of first 200 chars + length
81
+ const hashKey = `${simpleHash(clean)}:${clean.length}`;
82
+ const isDuplicate = recentHashes.has(hashKey);
83
+ if (isDuplicate)
84
+ duplicates++;
85
+ recentHashes.add(hashKey);
86
+ if (recentHashes.size > MAX_RECENT) {
87
+ const first = recentHashes.values().next().value;
88
+ if (first !== undefined)
89
+ recentHashes.delete(first);
90
+ }
91
+ totalTokens += tokens;
92
+ if (isTooShort || isDuplicate)
93
+ noisyMessages++;
94
+ else
95
+ signalMessages++;
96
+ }
97
+ // Effective window via the ONE resolver - braid.context.contextLimitTokens
98
+ // override, else the model's provider-truth window. 100k only when neither is
99
+ // known (the former hardcoded default; it fired density triggers ~3x too early
100
+ // at a 262k window).
101
+ const tokenLimit = getResolvedContextWindow(ctx.model?.contextWindow) ?? 100_000;
102
+ const tokenRatio = tokenLimit > 0 ? Math.min(totalTokens / tokenLimit, 1) : 0;
103
+ const totalMessages = signalMessages + noisyMessages;
104
+ const density = totalMessages > 0 ? signalMessages / totalMessages : 1;
105
+ return { density, signalMessages, noisyMessages, duplicates, totalTokens, tokenRatio };
106
+ }
107
+ // ── LLM Judge Evaluation ─────────────────────────────────────────────────────
108
+ /**
109
+ * Evaluate context density using an LLM judge for semantic assessment.
110
+ *
111
+ * Samples messages from the context and uses classify() with the
112
+ * contextDensity critic to assess signal-to-noise ratio holistically.
113
+ * Falls back to fast heuristic when LLM is unavailable.
114
+ *
115
+ * Call this when you need a deeper understanding of context quality
116
+ * (e.g., before deciding whether to compress or archive).
117
+ *
118
+ * NOTE: Defined but never called. The context-density heuristic path
119
+ * (evaluateContextDensity) is used instead. Kept for future wiring
120
+ * when LLM-based density assessment is needed.
121
+ *
122
+ * @param ctx - ExtensionContext
123
+ * @returns DensityResult with an additional judgeLabel field
124
+ */
125
+ export async function evaluateContextDensityWithJudge(ctx) {
126
+ const base = evaluateContextDensity(ctx);
127
+ // Build a sample of message content for the judge
128
+ let entries = [];
129
+ try {
130
+ entries = ctx.sessionManager?.getEntries?.() ?? [];
131
+ }
132
+ catch {
133
+ /* fallback */
134
+ }
135
+ // Sample up to 10 messages: evenly spaced across the context
136
+ const sampleSize = Math.min(10, entries.length);
137
+ const step = entries.length > sampleSize ? Math.floor(entries.length / sampleSize) : 1;
138
+ const sample = [];
139
+ for (let i = 0; i < entries.length && sample.length < sampleSize; i += step) {
140
+ const entry = entries[i];
141
+ let text = "";
142
+ if (entry.type === "message" && entry.message) {
143
+ const msg = entry.message;
144
+ text =
145
+ typeof msg.content === "string"
146
+ ? msg.content.slice(0, 200)
147
+ : Array.isArray(msg.content)
148
+ ? msg.content.map((c) => (c.text ?? "").slice(0, 100)).join(" ")
149
+ : "";
150
+ }
151
+ else if (entry.type === "tool_result" && entry.result) {
152
+ text = (typeof entry.result === "string" ? entry.result : JSON.stringify(entry.result)).slice(0, 200);
153
+ }
154
+ if (text.trim())
155
+ sample.push(`[${entry.type}] ${text}`);
156
+ }
157
+ const messagesText = sample.map((m, i) => `--- Message ${i + 1} ---\n${m}`).join("\n\n");
158
+ try {
159
+ const result = await classify(ctx, CRITICS.contextDensity.criteria, { sampleCount: String(sample.length), messages: messagesText }, { timeoutMs: 60_000, label: CRITICS.contextDensity.label });
160
+ const label = result.label.toUpperCase();
161
+ const judgeLabel = label === "HIGH" || label === "MEDIUM" || label === "LOW" ? label : undefined;
162
+ return { ...base, judgeLabel };
163
+ }
164
+ catch {
165
+ // LLM unavailable - return base heuristic result
166
+ return base;
167
+ }
168
+ }
169
+ // ── Compression Strategy Recommendation ───────────────────────────────────────────
170
+ /**
171
+ * Recommend a compression strategy based on context density.
172
+ *
173
+ * Low density (< 0.4): Aggressive pruning - remove noise, keep signal
174
+ * Medium density (0.4-0.7): Semantic compression - summarize without losing meaning
175
+ * High density (> 0.7): Conservative - only compress if context is large
176
+ */
177
+ export function recommendCompressionStrategy(density) {
178
+ // If LLM judge says LOW density, escalate
179
+ if (density.judgeLabel === "LOW")
180
+ return "aggressive";
181
+ if (density.tokenRatio > 0.85) {
182
+ return density.density < 0.4 ? "aggressive" : "semantic";
183
+ }
184
+ if (density.tokenRatio > 0.6) {
185
+ if (density.density < 0.4)
186
+ return "semantic";
187
+ if (density.density < 0.6)
188
+ return "conservative";
189
+ return "none";
190
+ }
191
+ return "none";
192
+ }
193
+ //# sourceMappingURL=context-density.js.map
@@ -0,0 +1,88 @@
1
+ /**
2
+ * Context Management Thresholds - single source of truth.
3
+ *
4
+ * Separates two semantically distinct concepts:
5
+ * CONTEXT_USAGE - how full the token window is (% of limit filled)
6
+ * DENSITY - signal-to-noise ratio of content (0-1)
7
+ *
8
+ * Tune these values to adjust reminder cadence without hunting through 6+ files.
9
+ */
10
+ /** First soft whisper - inspect context, start tracking. */
11
+ export declare const USAGE_WHISPER_SOFT = 30;
12
+ /** Advisory - suggest light pruning or archiving completed work. */
13
+ export declare const USAGE_WHISPER_ADVISORY = 50;
14
+ /** Warning - suggest deep compaction and compression. */
15
+ export declare const USAGE_WHISPER_WARNING = 65;
16
+ /** Critical - high priority, force immediate hygiene. */
17
+ export declare const USAGE_WHISPER_CRITICAL = 75;
18
+ /** Auto-compaction: medium level at this usage. */
19
+ export declare const USAGE_COMPACT_MEDIUM = 80;
20
+ /** Auto-compaction: aggressive level at this usage. */
21
+ export declare const USAGE_COMPACT_AGGRESSIVE = 90;
22
+ /** Reset the fired-threshold set when usage drops below this. */
23
+ export declare const USAGE_FIRED_RESET_BELOW = 50;
24
+ /**
25
+ * Compaction hard-refuse threshold: above this usage percent, destructive
26
+ * AI-supervised compaction is refused/redirected to deterministic slide-mode
27
+ * (max-call-stack crash + session-corruption guard at high usage).
28
+ *
29
+ * Single home for the 70% compaction-refusal literals: the context_compress(action="compact")
30
+ * refusal, the session_before_compact slide guard, the compaction
31
+ * summarization-aggressiveness tier, the audit branching trigger, and the
32
+ * context_inspect steer bands. Consumers import this constant; do not
33
+ * restate the number. Behavior note: it is a hard ceiling for LLM-supervised
34
+ * compaction, NOT an auto-compact trigger (that is USAGE_COMPACT_MEDIUM).
35
+ */
36
+ export declare const CONTEXT_COMPACT_REFUSE_PERCENT = 70;
37
+ /**
38
+ * Turn-end ACT re-arm: the token arm that gates the hygiene act
39
+ * (min(0.60W, ACT_ARM_TOKEN_CEILING)).
40
+ */
41
+ export declare function USAGE_TOKENS_CRITICAL(window?: number | null): number;
42
+ /**
43
+ * Turn-end auto-compact HARD BACKSTOP (0.90W): bounds runaway growth the
44
+ * re-arm spacing could otherwise sail past between checks.
45
+ */
46
+ export declare function HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(window?: number | null): number;
47
+ /**
48
+ * ADVISORY ESCALATION BAND (0.85W): distinct from the backstop so both arms
49
+ * can be evaluated in order; escalate wording fires first, backstop acts.
50
+ */
51
+ export declare function USAGE_TOKENS_ESCALATE(window?: number | null): number;
52
+ /**
53
+ * Turn-end auto-compact re-arm spacing (turns between hygiene ACTs).
54
+ * The ACT may fire again once this many turns have passed since the last
55
+ * attempt, for every arm (token, percent, backstop): the turn-based
56
+ * cooldown guarantees the act cannot run every turn.
57
+ */
58
+ export declare const HYGIENE_AUTO_COMPACT_MIN_TURNS = 3;
59
+ /** Below this -> "low density" signal emitted -> suggest pruning. */
60
+ export declare const DENSITY_LOW = 0.4;
61
+ /** Below this -> high-priority density whisper. */
62
+ export declare const DENSITY_VERY_LOW = 0.25;
63
+ /** Above this (when token ratio also high) -> "high density" signal. */
64
+ export declare const DENSITY_HIGH = 0.7;
65
+ /** Token ratio above this -> large-context whisper fires alongside density checks. */
66
+ export declare const TOKEN_RATIO_LARGE_CONTEXT = 0.6;
67
+ /** Analytics: emit context_full event when density exceeds this (NOT usage). */
68
+ export declare const ANALYTICS_DENSITY_FULL_EVENT = 70;
69
+ /** Consecutive low-density ticks before suggesting auto-compact. */
70
+ export declare const HYGIENE_LOW_DENSITY_CONSECUTIVE_MIN = 2;
71
+ /** Cooldown between low-density whisphers (turns). */
72
+ export declare const HYGIENE_DENSITY_WHISPER_COOLDOWN_TURNS = 20;
73
+ /** Cooldown between large-context whispers (turns). */
74
+ export declare const HYGIENE_LARGE_CONTEXT_COOLDOWN_TURNS = 15;
75
+ /**
76
+ * Cooldown between auto-compact SUGGESTION whispers (heartbeat context-hygiene
77
+ * module cadence). The turn-end hygiene ACT itself spaces acts with
78
+ * HYGIENE_AUTO_COMPACT_MIN_TURNS across all arms.
79
+ */
80
+ export declare const HYGIENE_AUTO_COMPACT_COOLDOWN_TURNS = 15;
81
+ /**
82
+ * Watchdog escalation injection budget per condition per session: after this many escalation injections for one
83
+ * condition, only a crossing of the final REWARN_MILESTONE (500) still
84
+ * escalates. Caps the watchdog's own contribution to context mass (the
85
+ * measured 143-escalation flap storm carried 33.6k chars, 5.1% of peak).
86
+ */
87
+ export declare const WATCHDOG_ESCALATION_BUDGET_PER_SESSION = 12;
88
+ //# sourceMappingURL=context-thresholds.d.ts.map
@@ -0,0 +1,107 @@
1
+ import { tokenArms } from "./context-usage.js";
2
+ /**
3
+ * Context Management Thresholds - single source of truth.
4
+ *
5
+ * Separates two semantically distinct concepts:
6
+ * CONTEXT_USAGE - how full the token window is (% of limit filled)
7
+ * DENSITY - signal-to-noise ratio of content (0-1)
8
+ *
9
+ * Tune these values to adjust reminder cadence without hunting through 6+ files.
10
+ */
11
+ // CONTEXT USAGE THRESHOLDS (% of context window filled)
12
+ /** First soft whisper - inspect context, start tracking. */
13
+ export const USAGE_WHISPER_SOFT = 30;
14
+ /** Advisory - suggest light pruning or archiving completed work. */
15
+ export const USAGE_WHISPER_ADVISORY = 50;
16
+ /** Warning - suggest deep compaction and compression. */
17
+ export const USAGE_WHISPER_WARNING = 65;
18
+ /** Critical - high priority, force immediate hygiene. */
19
+ export const USAGE_WHISPER_CRITICAL = 75;
20
+ /** Auto-compaction: medium level at this usage. */
21
+ export const USAGE_COMPACT_MEDIUM = 80;
22
+ /** Auto-compaction: aggressive level at this usage. */
23
+ export const USAGE_COMPACT_AGGRESSIVE = 90;
24
+ /** Reset the fired-threshold set when usage drops below this. */
25
+ export const USAGE_FIRED_RESET_BELOW = 50;
26
+ /**
27
+ * Compaction hard-refuse threshold: above this usage percent, destructive
28
+ * AI-supervised compaction is refused/redirected to deterministic slide-mode
29
+ * (max-call-stack crash + session-corruption guard at high usage).
30
+ *
31
+ * Single home for the 70% compaction-refusal literals: the context_compress(action="compact")
32
+ * refusal, the session_before_compact slide guard, the compaction
33
+ * summarization-aggressiveness tier, the audit branching trigger, and the
34
+ * context_inspect steer bands. Consumers import this constant; do not
35
+ * restate the number. Behavior note: it is a hard ceiling for LLM-supervised
36
+ * compaction, NOT an auto-compact trigger (that is USAGE_COMPACT_MEDIUM).
37
+ */
38
+ export const CONTEXT_COMPACT_REFUSE_PERCENT = 70;
39
+ // TOKEN-COUNT THRESHOLDS (absolute tokens, model-agnostic early warnings)
40
+ // Percent arms fire too late on large or configured windows, so the token
41
+ // ladder is expressed as fractions of the resolved window W (the same value
42
+ // the live metric reports): soft 0.18W, advisory 0.30W, warning 0.45W,
43
+ // act min(0.60W, ACT_ARM_TOKEN_CEILING), escalate 0.85W, backstop 0.90W.
44
+ // The numeric table lives in lib/detection/context-usage.ts (tokenArms);
45
+ // these thin accessors keep the long-standing names. A configured window change
46
+ // is reflected without a code edit because the resolver reads settings on
47
+ // every call.
48
+ /**
49
+ * Turn-end ACT re-arm: the token arm that gates the hygiene act
50
+ * (min(0.60W, ACT_ARM_TOKEN_CEILING)).
51
+ */
52
+ export function USAGE_TOKENS_CRITICAL(window) {
53
+ return tokenArms(window).act;
54
+ }
55
+ /**
56
+ * Turn-end auto-compact HARD BACKSTOP (0.90W): bounds runaway growth the
57
+ * re-arm spacing could otherwise sail past between checks.
58
+ */
59
+ export function HYGIENE_AUTO_COMPACT_HARD_BACKSTOP(window) {
60
+ return tokenArms(window).backstop;
61
+ }
62
+ /**
63
+ * ADVISORY ESCALATION BAND (0.85W): distinct from the backstop so both arms
64
+ * can be evaluated in order; escalate wording fires first, backstop acts.
65
+ */
66
+ export function USAGE_TOKENS_ESCALATE(window) {
67
+ return tokenArms(window).escalate;
68
+ }
69
+ /**
70
+ * Turn-end auto-compact re-arm spacing (turns between hygiene ACTs).
71
+ * The ACT may fire again once this many turns have passed since the last
72
+ * attempt, for every arm (token, percent, backstop): the turn-based
73
+ * cooldown guarantees the act cannot run every turn.
74
+ */
75
+ export const HYGIENE_AUTO_COMPACT_MIN_TURNS = 3;
76
+ // DENSITY THRESHOLDS (signal/noise ratio, 0-1)
77
+ /** Below this -> "low density" signal emitted -> suggest pruning. */
78
+ export const DENSITY_LOW = 0.4;
79
+ /** Below this -> high-priority density whisper. */
80
+ export const DENSITY_VERY_LOW = 0.25;
81
+ /** Above this (when token ratio also high) -> "high density" signal. */
82
+ export const DENSITY_HIGH = 0.7;
83
+ /** Token ratio above this -> large-context whisper fires alongside density checks. */
84
+ export const TOKEN_RATIO_LARGE_CONTEXT = 0.6;
85
+ /** Analytics: emit context_full event when density exceeds this (NOT usage). */
86
+ export const ANALYTICS_DENSITY_FULL_EVENT = 70;
87
+ // CONTEXT HYGIENE MODULE CONSTANTS
88
+ /** Consecutive low-density ticks before suggesting auto-compact. */
89
+ export const HYGIENE_LOW_DENSITY_CONSECUTIVE_MIN = 2;
90
+ /** Cooldown between low-density whisphers (turns). */
91
+ export const HYGIENE_DENSITY_WHISPER_COOLDOWN_TURNS = 20;
92
+ /** Cooldown between large-context whispers (turns). */
93
+ export const HYGIENE_LARGE_CONTEXT_COOLDOWN_TURNS = 15;
94
+ /**
95
+ * Cooldown between auto-compact SUGGESTION whispers (heartbeat context-hygiene
96
+ * module cadence). The turn-end hygiene ACT itself spaces acts with
97
+ * HYGIENE_AUTO_COMPACT_MIN_TURNS across all arms.
98
+ */
99
+ export const HYGIENE_AUTO_COMPACT_COOLDOWN_TURNS = 15;
100
+ /**
101
+ * Watchdog escalation injection budget per condition per session: after this many escalation injections for one
102
+ * condition, only a crossing of the final REWARN_MILESTONE (500) still
103
+ * escalates. Caps the watchdog's own contribution to context mass (the
104
+ * measured 143-escalation flap storm carried 33.6k chars, 5.1% of peak).
105
+ */
106
+ export const WATCHDOG_ESCALATION_BUDGET_PER_SESSION = 12;
107
+ //# sourceMappingURL=context-thresholds.js.map
@@ -0,0 +1,80 @@
1
+ /**
2
+ * Context-usage → tier nudge resolution + duck-typed extraction.
3
+ *
4
+ * centralization (). The context-usage→tier nudge cascade
5
+ * (percent tiers soft/advisory/warning/critical/compact → message) and the
6
+ * `getContextUsage()` duck-typed extraction were duplicated across:
7
+ * - extensions/heartbeat/heartbeat-scheduler/policies.ts
8
+ * - extensions/enforcement/handlers/register-turn-end-hygiene.ts
9
+ * - extensions/enforcement/handlers/turn-end-handler.ts
10
+ * - extensions/core/prompt-builder/context-section.ts
11
+ * - extensions/memory/context-manager/analysis.ts
12
+ * - extensions/memory/context-manager/handlers/tools/context-navigate.ts
13
+ * - extensions/memory/context-lifecycle/helpers.ts
14
+ *
15
+ * Threshold VALUES still live in context-thresholds.ts (the existing
16
+ * single source of truth). This module maps a usage percent onto the
17
+ * tier ladder (tier labels + verbal priority per tier) and owns the ONE
18
+ * duck-typed getContextUsage() accessor. Each site keeps its own
19
+ * default/fallback semantics by applying them to the raw usage object
20
+ * returned here, so behavior is preserved per site.
21
+ *
22
+ * The enforcement nudge message text is byte-identical across the three
23
+ * enforcement cascade sites (verified in by grid-checking every
24
+ * site's cascade over usage/token samples), so the message text lives
25
+ * here in a single copy too. Sites with different copy (heartbeat
26
+ * policies) keep their own messages and only share the tier mapping.
27
+ */
28
+ export type ContextUsageTier = "compact" | "critical" | "warning" | "advisory" | "soft";
29
+ export type ContextUsagePriority = "high" | "medium" | "low";
30
+ export interface ContextUsageTierInfo {
31
+ tier: ContextUsageTier;
32
+ /** Percent threshold for this tier (from context-thresholds.ts). */
33
+ threshold: number;
34
+ /** Verbal priority used by nudge copy (heartbeat policies ladder). */
35
+ priority: ContextUsagePriority;
36
+ }
37
+ /**
38
+ * Tier ladder, highest first: compact(80) → critical(75) → warning(65)
39
+ * → advisory(50) → soft(30). Thresholds come from context-thresholds.ts.
40
+ */
41
+ export declare const CONTEXT_USAGE_TIERS: readonly ContextUsageTierInfo[];
42
+ /**
43
+ * The highest tier reached by the given usage percent, or null when below
44
+ * soft. Equates to the enforcement cascades' if/else-if order
45
+ * (compact → critical → warning → advisory → soft).
46
+ */
47
+ export declare function contextUsageTier(usagePercent: number): ContextUsageTierInfo | null;
48
+ /** Percent-tier nudge message text (identical at every enforcement site). */
49
+ export declare function contextUsageTierMessage(tier: ContextUsageTier, usagePercent: number): string;
50
+ /**
51
+ * Token-tier nudge message text (identical at every enforcement site).
52
+ * `level` mirrors the tier reached by the token-count check; arms are
53
+ * fractions of the resolved window (0.45W warning, 0.18W soft).
54
+ */
55
+ export declare function contextUsageTokenMessage(level: "warning" | "soft", usagePercent: number, usageTokens: number): string;
56
+ /**
57
+ * Combined enforcement cascade: token tiers first (0.45W/0.18W — fire earlier
58
+ * for large context windows), then the percent tiers (30/50/65/75/80).
59
+ * Returns null when no tier is reached.
60
+ */
61
+ export declare function contextUsageNudgeMessage(usagePercent: number, usageTokens: number, window?: number | null): string | null;
62
+ /** The duck-typed usage shape current sites read. percent may be null (no data). */
63
+ export interface ContextUsageLike {
64
+ percent?: number | null;
65
+ tokens?: number;
66
+ contextWindow?: number;
67
+ }
68
+ /**
69
+ * ONE duck-typed `getContextUsage()` extraction. Mirrors the fallbacks
70
+ * used by every current site: a missing ctx, a non-function accessor, or
71
+ * an accessor that throws all yield undefined. Each caller applies its own
72
+ * defaulting (percent ?? 0, contextWindow ?? 200000, etc.), exactly as the
73
+ * inline sites did — nothing is flattened away here. The one normalization
74
+ * applied here: the reported `contextWindow` is the effective window
75
+ * from the single contextLimitTokens resolver — braid.context.contextLimitTokens
76
+ * overrides the accessor's provider-truth window, and `percent` is recomputed
77
+ * against it when `tokens` is known so the two stay consistent.
78
+ */
79
+ export declare function getContextUsage(ctx: unknown): ContextUsageLike | undefined;
80
+ //# sourceMappingURL=context-tiers.d.ts.map