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,151 @@
1
+ /**
2
+ * Wake Gate - prevents triggerTurn wakes from re-entering pi-core's agent
3
+ * loop while a session prompt is being prepared (the pre-flight window).
4
+ *
5
+ * PROBLEM (pi-core 1.0.2):
6
+ * pi-core's sendCustomMessage routes triggerTurn:true to `_runAgentPrompt`
7
+ * whenever the SESSION-level isStreaming flag (`_isAgentRunActive`) is false.
8
+ * But `_isAgentRunActive` is only set inside `_runAgentPrompt`
9
+ * (agent-session.js) and cleared in `_emitAgentSettled`. The session
10
+ * `prompt()` PRE-FLIGHT (model/auth checks, `_checkCompaction`,
11
+ * `emitBeforeAgentStart`) runs with isStreaming=false. A triggerTurn wake
12
+ * that lands during that pre-flight starts a COMPETING agent run; when
13
+ * the outer `prompt()` then reaches `_runAgentPrompt` ->
14
+ * `agent.prompt()`, pi-agent-core's activeRun guard throws
15
+ * "Agent is already processing a prompt. Use steer() or followUp() ...".
16
+ * The compaction boundary is the worst offender: `_checkCompaction`'s LLM
17
+ * summarization is a multi-second await inside the pre-flight, so a
18
+ * deferred wake (timer fires are setTimeout(0)-deferred) has ample time to
19
+ * land there.
20
+ *
21
+ * GATE (this module): the pre-flight START is not observable by extensions,
22
+ * but its TAIL and the run itself are:
23
+ * - before_agent_start (mid pre-flight)
24
+ * - session_before_compact (compaction start)
25
+ * - agent_start (core run start)
26
+ * From the first of {input (idle), before_agent_start,
27
+ * session_before_compact} until agent_start (or session_compact, for the
28
+ * manual-compaction path where no run follows), a triggerTurn wake is gated
29
+ * into a live-delivery send instead of a raw re-entry: triggerTurn is
30
+ * dropped, so pi-core routes the wake by live state - steer (branch 2)
31
+ * while a run is streaming, session append (branch 5) in the pre-flight.
32
+ * Either route reaches the run that is active or imminent and neither
33
+ * starts a competing one. After agent_start the session isStreaming flag
34
+ * is true, so pi-core's own sendCustomMessage already queues wakes; the
35
+ * gate RELEASES at agent_start to keep the post-run settle window
36
+ * triggerTurn capable (a wake there is a safe re-entry: core has already
37
+ * released activeRun). session_compact also releases: in the MANUAL-
38
+ * compaction path the agent is aborted and idle (no run follows), so the
39
+ * post-compaction auto-resume wake (register-session-compact,
40
+ * triggerTurn:true) must pass through ungated - gating it would
41
+ * re-introduce the post-compaction loop stop. In the AUTO path
42
+ * isStreaming is true from _runAgentPrompt entry through the post-run
43
+ * loop, so releasing at session_compact is safe there too.
44
+ *
45
+ * STATE-BASED DEFERRAL (send-time busy check): the region flag is a
46
+ * heuristic window; the load-bearing decision is the LIVE agent state at
47
+ * wake send time. registerWakeGate captures the session ctx from the
48
+ * events it already subscribes to, and isAgentBusy() reads it live:
49
+ * `ctx.signal === undefined && !ctx.isIdle()` — the session is in run
50
+ * bookkeeping or compaction while NO streaming run holds pi-core's queue
51
+ * (isIdle is false through both; signal is undefined outside a run). A
52
+ * raw triggerTurn landing there routes to _runAgentPrompt and starts a
53
+ * COMPETING run (the activeRun guard throws). sendTrackedMessage's
54
+ * deferred macrotask consults isAgentBusy() and, when the caller supplied
55
+ * a re-queue hook (timer wakes: the wake-retry queue), parks the wake
56
+ * instead of sending; the redelivery re-checks and starts its own turn
57
+ * once the session is idle. Wakes without a hook (and an unreadable
58
+ * state) fail open to the region-gate behavior above. Mid-run steering is
59
+ * untouched: signal defined means the run is live and pi-core queues the
60
+ * send itself.
61
+ *
62
+ * RESIDUAL GAP (pi-core): pi-core emits `input` to extension handlers at
63
+ * session.prompt() ENTRY (before the auth/compaction pre-flight and before
64
+ * before_agent_start), so an idle prompt arms the gate from the first
65
+ * await of the pre-flight. The arm is conditional: `input` carries
66
+ * `streamingBehavior` ONLY when the prompt is a steer/followUp into an
67
+ * ACTIVE run; such a prompt queues and returns without starting a run,
68
+ * and agent_start will not re-fire for it, so arming there would leak the
69
+ * gate up to the 120s fail-safe past the run's end. The one uncovered
70
+ * slice is the synchronous pre-input section of prompt() (extension
71
+ * `/command` dispatch), which returns before any await. The definitive
72
+ * fix stays in pi-core: set `_isAgentRunActive` at session.prompt()
73
+ * entry, or gate sendCustomMessage's triggerTurn branch on the CORE
74
+ * activeRun (`this.agent.signal`).
75
+ *
76
+ * FAIL-SAFE: pi-core emits NO event when the pre-flight ABORTS (auth/quota
77
+ * errors: before_agent_start fires, then the pre-flight catch rethrows and
78
+ * agent_start is never emitted — no extension event on that path). Without
79
+ * a clear, a gate armed by an aborted turn stays true for the whole idle
80
+ * period: every wake:true timer fire routes to a queued steer that never
81
+ * starts a turn, and periodic fires batch behind the next user prompt. The
82
+ * fail-safe below auto-clears the gate RUN_REGION_MAX_MS after the last
83
+ * arming event, so a stuck gate self-heals without needing an abort event
84
+ * that pi-core does not provide. For wakes WITH a re-queue hook the
85
+ * fail-safe is not load-bearing: a fail-safe clear during a still-busy
86
+ * session does not re-expose the wake (the live-state check defers it, so
87
+ * a clear cannot cause a throw on that path); the region flag + fail-safe
88
+ * remain the catch-all rewrite for senders without a re-queue path.
89
+ *
90
+ * Scope: single-process-per-session (see injection-tracker.ts header) —
91
+ * module-level flag is process-global but every pi session registers once,
92
+ * so in practice it tracks the single live session.
93
+ */
94
+ /**
95
+ * Whether the session is busy in the state that makes a raw triggerTurn
96
+ * send dangerous: no streaming run holds the queue (`signal` undefined) but
97
+ * the session is not idle either (`isIdle` false — compaction, or run
98
+ * pre-flight/bookkeeping). pi-core's sendCustomMessage would route such a
99
+ * send to `_runAgentPrompt` and start a competing agent run.
100
+ *
101
+ * Fails open (false) unless busy is POSITIVELY determined: no ctx captured
102
+ * yet, a ctx without live readers, or a stale ctx (its getters throw after
103
+ * session replacement) all mean "unknown" — the region gate above stays the
104
+ * safety net for those.
105
+ */
106
+ export declare function isAgentBusy(): boolean;
107
+ export declare const RUN_REGION_MAX_MS = 120000;
108
+ /** Whether a triggerTurn send should be gated (pre-flight tail in progress). */
109
+ export declare function isRunRegionActive(): boolean;
110
+ /** Test hook: reset module state between fixtures (also cancels the fail-safe). */
111
+ export declare function resetWakeGateForTests(): void;
112
+ /** Test hook: shorten/extend the fail-safe bound (null restores the default). */
113
+ export declare function _setWakeGateFailSafeMsForTests(ms: number | null): void;
114
+ /**
115
+ * Register the wake-gate event subscriptions. Call once per pi session
116
+ * (alongside registerInjectionTracker — the enforcement bootstrap in
117
+ * handler-registry.ts wires both).
118
+ *
119
+ * The local `on` type widens ExtensionAPI's overloaded on() so we can pass
120
+ * plain event names without TypeScript picking an overload.
121
+ */
122
+ export declare function registerWakeGate(pi: {
123
+ on: (event: string, handler: (...args: any[]) => any) => void;
124
+ }): void;
125
+ /** Delivery options handed to pi.sendMessage / sendTrackedMessage. */
126
+ export interface WakeDeliveryOptions {
127
+ triggerTurn?: boolean;
128
+ deliverAs?: string;
129
+ }
130
+ /**
131
+ * Gate a triggerTurn send on the run-region state.
132
+ *
133
+ * - Not a triggerTurn, or no run region active -> options unchanged (wake hits
134
+ * pi-core's triggerTurn branch exactly as before: idle wake preserved).
135
+ * - Run region active -> triggerTurn is dropped entirely and the send takes
136
+ * the funnel's live shape `{ deliverAs }` (steer by default, preserving an
137
+ * explicit deliverAs). pi-core 1.0.2 routes that shape by live state
138
+ * (dist/core/agent-session.js:1759-1782): while a run is streaming it steers
139
+ * into that run (branch 2); in the pre-flight (isStreaming false) it is
140
+ * appended to the session immediately (branch 5), so the imminent run reads
141
+ * it. Neither route starts a competing run. Returning
142
+ * `triggerTurn: false` instead would park the wake to the end-of-turn flush
143
+ * (branch 4) - pi 0.84.2 made that shape park (PR #8022), which is what
144
+ * this gate used to return.
145
+ *
146
+ * REVERT-PROOF contract: removing the gate (or never registering it) means
147
+ * `_runRegionActive` stays false and every triggerTurn send passes through
148
+ * ungated — the fixture test in test-wake-gate.mjs fails, pinning the gate.
149
+ */
150
+ export declare function gateTriggerTurnOptions(options: WakeDeliveryOptions | undefined): WakeDeliveryOptions | undefined;
151
+ //# sourceMappingURL=wake-gate.d.ts.map
@@ -0,0 +1,265 @@
1
+ /**
2
+ * Wake Gate - prevents triggerTurn wakes from re-entering pi-core's agent
3
+ * loop while a session prompt is being prepared (the pre-flight window).
4
+ *
5
+ * PROBLEM (pi-core 1.0.2):
6
+ * pi-core's sendCustomMessage routes triggerTurn:true to `_runAgentPrompt`
7
+ * whenever the SESSION-level isStreaming flag (`_isAgentRunActive`) is false.
8
+ * But `_isAgentRunActive` is only set inside `_runAgentPrompt`
9
+ * (agent-session.js) and cleared in `_emitAgentSettled`. The session
10
+ * `prompt()` PRE-FLIGHT (model/auth checks, `_checkCompaction`,
11
+ * `emitBeforeAgentStart`) runs with isStreaming=false. A triggerTurn wake
12
+ * that lands during that pre-flight starts a COMPETING agent run; when
13
+ * the outer `prompt()` then reaches `_runAgentPrompt` ->
14
+ * `agent.prompt()`, pi-agent-core's activeRun guard throws
15
+ * "Agent is already processing a prompt. Use steer() or followUp() ...".
16
+ * The compaction boundary is the worst offender: `_checkCompaction`'s LLM
17
+ * summarization is a multi-second await inside the pre-flight, so a
18
+ * deferred wake (timer fires are setTimeout(0)-deferred) has ample time to
19
+ * land there.
20
+ *
21
+ * GATE (this module): the pre-flight START is not observable by extensions,
22
+ * but its TAIL and the run itself are:
23
+ * - before_agent_start (mid pre-flight)
24
+ * - session_before_compact (compaction start)
25
+ * - agent_start (core run start)
26
+ * From the first of {input (idle), before_agent_start,
27
+ * session_before_compact} until agent_start (or session_compact, for the
28
+ * manual-compaction path where no run follows), a triggerTurn wake is gated
29
+ * into a live-delivery send instead of a raw re-entry: triggerTurn is
30
+ * dropped, so pi-core routes the wake by live state - steer (branch 2)
31
+ * while a run is streaming, session append (branch 5) in the pre-flight.
32
+ * Either route reaches the run that is active or imminent and neither
33
+ * starts a competing one. After agent_start the session isStreaming flag
34
+ * is true, so pi-core's own sendCustomMessage already queues wakes; the
35
+ * gate RELEASES at agent_start to keep the post-run settle window
36
+ * triggerTurn capable (a wake there is a safe re-entry: core has already
37
+ * released activeRun). session_compact also releases: in the MANUAL-
38
+ * compaction path the agent is aborted and idle (no run follows), so the
39
+ * post-compaction auto-resume wake (register-session-compact,
40
+ * triggerTurn:true) must pass through ungated - gating it would
41
+ * re-introduce the post-compaction loop stop. In the AUTO path
42
+ * isStreaming is true from _runAgentPrompt entry through the post-run
43
+ * loop, so releasing at session_compact is safe there too.
44
+ *
45
+ * STATE-BASED DEFERRAL (send-time busy check): the region flag is a
46
+ * heuristic window; the load-bearing decision is the LIVE agent state at
47
+ * wake send time. registerWakeGate captures the session ctx from the
48
+ * events it already subscribes to, and isAgentBusy() reads it live:
49
+ * `ctx.signal === undefined && !ctx.isIdle()` — the session is in run
50
+ * bookkeeping or compaction while NO streaming run holds pi-core's queue
51
+ * (isIdle is false through both; signal is undefined outside a run). A
52
+ * raw triggerTurn landing there routes to _runAgentPrompt and starts a
53
+ * COMPETING run (the activeRun guard throws). sendTrackedMessage's
54
+ * deferred macrotask consults isAgentBusy() and, when the caller supplied
55
+ * a re-queue hook (timer wakes: the wake-retry queue), parks the wake
56
+ * instead of sending; the redelivery re-checks and starts its own turn
57
+ * once the session is idle. Wakes without a hook (and an unreadable
58
+ * state) fail open to the region-gate behavior above. Mid-run steering is
59
+ * untouched: signal defined means the run is live and pi-core queues the
60
+ * send itself.
61
+ *
62
+ * RESIDUAL GAP (pi-core): pi-core emits `input` to extension handlers at
63
+ * session.prompt() ENTRY (before the auth/compaction pre-flight and before
64
+ * before_agent_start), so an idle prompt arms the gate from the first
65
+ * await of the pre-flight. The arm is conditional: `input` carries
66
+ * `streamingBehavior` ONLY when the prompt is a steer/followUp into an
67
+ * ACTIVE run; such a prompt queues and returns without starting a run,
68
+ * and agent_start will not re-fire for it, so arming there would leak the
69
+ * gate up to the 120s fail-safe past the run's end. The one uncovered
70
+ * slice is the synchronous pre-input section of prompt() (extension
71
+ * `/command` dispatch), which returns before any await. The definitive
72
+ * fix stays in pi-core: set `_isAgentRunActive` at session.prompt()
73
+ * entry, or gate sendCustomMessage's triggerTurn branch on the CORE
74
+ * activeRun (`this.agent.signal`).
75
+ *
76
+ * FAIL-SAFE: pi-core emits NO event when the pre-flight ABORTS (auth/quota
77
+ * errors: before_agent_start fires, then the pre-flight catch rethrows and
78
+ * agent_start is never emitted — no extension event on that path). Without
79
+ * a clear, a gate armed by an aborted turn stays true for the whole idle
80
+ * period: every wake:true timer fire routes to a queued steer that never
81
+ * starts a turn, and periodic fires batch behind the next user prompt. The
82
+ * fail-safe below auto-clears the gate RUN_REGION_MAX_MS after the last
83
+ * arming event, so a stuck gate self-heals without needing an abort event
84
+ * that pi-core does not provide. For wakes WITH a re-queue hook the
85
+ * fail-safe is not load-bearing: a fail-safe clear during a still-busy
86
+ * session does not re-expose the wake (the live-state check defers it, so
87
+ * a clear cannot cause a throw on that path); the region flag + fail-safe
88
+ * remain the catch-all rewrite for senders without a re-queue path.
89
+ *
90
+ * Scope: single-process-per-session (see injection-tracker.ts header) —
91
+ * module-level flag is process-global but every pi session registers once,
92
+ * so in practice it tracks the single live session.
93
+ */
94
+ import { createLogger } from "../core/logger.js";
95
+ import { SESSION_BEFORE_COMPACT, SESSION_START, SESSION_SHUTDOWN } from "../core/event-names.js";
96
+ const log = createLogger("wake-gate");
97
+ // True while a session prompt is being prepared (pre-flight tail) so that a
98
+ // triggerTurn wake would start a COMPETING run. Cleared at agent_start: from
99
+ // then on pi-core's own isStreaming queueing takes over.
100
+ let _runRegionActive = false;
101
+ // The most recently observed session ctx, captured from wake-gate's own
102
+ // event handlers. Its getters stay live across events, so a ctx captured
103
+ // at session start still reads current state when a wake sends minutes
104
+ // later.
105
+ let _lastAgentCtx = null;
106
+ function captureAgentCtx(ctx) {
107
+ if (ctx && typeof ctx === "object")
108
+ _lastAgentCtx = ctx;
109
+ }
110
+ /**
111
+ * Whether the session is busy in the state that makes a raw triggerTurn
112
+ * send dangerous: no streaming run holds the queue (`signal` undefined) but
113
+ * the session is not idle either (`isIdle` false — compaction, or run
114
+ * pre-flight/bookkeeping). pi-core's sendCustomMessage would route such a
115
+ * send to `_runAgentPrompt` and start a competing agent run.
116
+ *
117
+ * Fails open (false) unless busy is POSITIVELY determined: no ctx captured
118
+ * yet, a ctx without live readers, or a stale ctx (its getters throw after
119
+ * session replacement) all mean "unknown" — the region gate above stays the
120
+ * safety net for those.
121
+ */
122
+ export function isAgentBusy() {
123
+ const ctx = _lastAgentCtx;
124
+ if (!ctx || typeof ctx.isIdle !== "function")
125
+ return false;
126
+ try {
127
+ return ctx.signal === undefined && ctx.isIdle() === false;
128
+ }
129
+ catch {
130
+ return false;
131
+ }
132
+ }
133
+ // Fail-safe bound: how long a run region may stay armed without a release
134
+ // event before the gate auto-clears. Covers the legitimate pre-flight tail
135
+ // (sub-second) and a compaction summarization (session_before_compact re-arms
136
+ // the timer, so the bound only needs to exceed a single compaction). Guards
137
+ // against a pre-flight abort (auth/quota) leaving the gate stuck true, which
138
+ // rewrites every triggerTurn wake to a queued steer that never starts a turn.
139
+ export const RUN_REGION_MAX_MS = 120_000;
140
+ let _failSafeHandle = null;
141
+ // Test hook: override the fail-safe bound (null restores the default).
142
+ let _failSafeMsOverride = null;
143
+ function failSafeMs() {
144
+ return _failSafeMsOverride ?? RUN_REGION_MAX_MS;
145
+ }
146
+ function clearFailSafe() {
147
+ if (_failSafeHandle) {
148
+ clearTimeout(_failSafeHandle);
149
+ _failSafeHandle = null;
150
+ }
151
+ }
152
+ /** Arm the gate (or re-arm it, resetting the fail-safe window). */
153
+ function armRunRegion() {
154
+ _runRegionActive = true;
155
+ clearFailSafe();
156
+ _failSafeHandle = setTimeout(() => {
157
+ _failSafeHandle = null;
158
+ _runRegionActive = false;
159
+ log.warn(`[wake-gate] fail-safe: run region auto-cleared after ${failSafeMs()}ms without a release event ` +
160
+ `(pre-flight abort?) — triggerTurn wakes ungated again`);
161
+ }, failSafeMs());
162
+ // Do not keep the process alive for a stuck gate.
163
+ if (typeof _failSafeHandle?.unref === "function") {
164
+ _failSafeHandle.unref();
165
+ }
166
+ }
167
+ /** Release the gate and cancel the fail-safe timer. */
168
+ function releaseRunRegion() {
169
+ _runRegionActive = false;
170
+ clearFailSafe();
171
+ }
172
+ /** Whether a triggerTurn send should be gated (pre-flight tail in progress). */
173
+ export function isRunRegionActive() {
174
+ return _runRegionActive;
175
+ }
176
+ /** Test hook: reset module state between fixtures (also cancels the fail-safe). */
177
+ export function resetWakeGateForTests() {
178
+ releaseRunRegion();
179
+ _lastAgentCtx = null;
180
+ _failSafeMsOverride = null;
181
+ }
182
+ /** Test hook: shorten/extend the fail-safe bound (null restores the default). */
183
+ export function _setWakeGateFailSafeMsForTests(ms) {
184
+ _failSafeMsOverride = ms;
185
+ }
186
+ /**
187
+ * Register the wake-gate event subscriptions. Call once per pi session
188
+ * (alongside registerInjectionTracker — the enforcement bootstrap in
189
+ * handler-registry.ts wires both).
190
+ *
191
+ * The local `on` type widens ExtensionAPI's overloaded on() so we can pass
192
+ * plain event names without TypeScript picking an overload.
193
+ */
194
+ export function registerWakeGate(pi) {
195
+ pi.on("before_agent_start", (_event, ctx) => {
196
+ captureAgentCtx(ctx);
197
+ armRunRegion();
198
+ });
199
+ // `input` fires at session.prompt() ENTRY — before the pre-flight
200
+ // (model/auth checks, _checkCompaction) and before before_agent_start.
201
+ // Arming here closes the prompt-entry competing-run window for
202
+ // extension-originated sends (a wake landing between prompt entry and
203
+ // before_agent_start was previously ungated). Arm ONLY when the prompt
204
+ // will start a NEW run: `streamingBehavior` is set exactly when the input
205
+ // is a steer/followUp into an ACTIVE run (pi-core queues it without
206
+ // starting a run, and agent_start will not re-fire) — arming there would
207
+ // leak the gate past the run's end until the fail-safe. Input arms use the
208
+ // same armRunRegion path, so the 120s fail-safe semantics apply unchanged.
209
+ pi.on("input", (event, ctx) => {
210
+ captureAgentCtx(ctx);
211
+ if (event?.streamingBehavior === undefined)
212
+ armRunRegion();
213
+ });
214
+ pi.on(SESSION_BEFORE_COMPACT, (_event, ctx) => {
215
+ captureAgentCtx(ctx);
216
+ armRunRegion();
217
+ });
218
+ pi.on("agent_start", (_event, ctx) => {
219
+ captureAgentCtx(ctx);
220
+ releaseRunRegion();
221
+ });
222
+ // Manual compaction: agent is aborted + idle (no run follows) — release so
223
+ // the post-compaction auto-resume wake passes through ungated.
224
+ pi.on("session_compact", (_event, ctx) => {
225
+ captureAgentCtx(ctx);
226
+ releaseRunRegion();
227
+ });
228
+ pi.on(SESSION_START, (_event, ctx) => {
229
+ captureAgentCtx(ctx);
230
+ releaseRunRegion();
231
+ });
232
+ pi.on(SESSION_SHUTDOWN, () => {
233
+ releaseRunRegion();
234
+ _lastAgentCtx = null; // no live session after shutdown: fail open until the next capture
235
+ });
236
+ }
237
+ /**
238
+ * Gate a triggerTurn send on the run-region state.
239
+ *
240
+ * - Not a triggerTurn, or no run region active -> options unchanged (wake hits
241
+ * pi-core's triggerTurn branch exactly as before: idle wake preserved).
242
+ * - Run region active -> triggerTurn is dropped entirely and the send takes
243
+ * the funnel's live shape `{ deliverAs }` (steer by default, preserving an
244
+ * explicit deliverAs). pi-core 1.0.2 routes that shape by live state
245
+ * (dist/core/agent-session.js:1759-1782): while a run is streaming it steers
246
+ * into that run (branch 2); in the pre-flight (isStreaming false) it is
247
+ * appended to the session immediately (branch 5), so the imminent run reads
248
+ * it. Neither route starts a competing run. Returning
249
+ * `triggerTurn: false` instead would park the wake to the end-of-turn flush
250
+ * (branch 4) - pi 0.84.2 made that shape park (PR #8022), which is what
251
+ * this gate used to return.
252
+ *
253
+ * REVERT-PROOF contract: removing the gate (or never registering it) means
254
+ * `_runRegionActive` stays false and every triggerTurn send passes through
255
+ * ungated — the fixture test in test-wake-gate.mjs fails, pinning the gate.
256
+ */
257
+ export function gateTriggerTurnOptions(options) {
258
+ if (!options?.triggerTurn)
259
+ return options;
260
+ if (!_runRegionActive)
261
+ return options;
262
+ log.info(`[wake-gate] triggerTurn wake gated to live delivery (run region active) - deliverAs=${options.deliverAs ?? "steer"}`);
263
+ return { deliverAs: options.deliverAs ?? "steer" };
264
+ }
265
+ //# sourceMappingURL=wake-gate.js.map
@@ -0,0 +1,95 @@
1
+ /**
2
+ * Whisper Envelope - Universal prefix for system-injected messages.
3
+ *
4
+ * Every message sent via `sendTrackedMessage` is wrapped with a
5
+ * `[braid-whisper - <subsystem> @ <time>]` envelope and closed with an
6
+ * explicit `[braid-whisper-end]` end-marker so the agent can reliably
7
+ * distinguish system-injected signals from human user input, can
8
+ * unambiguously detect where a (possibly multiline) whisper body ends,
9
+ * and can tell a fresh whisper from a stale re-injection (header clock).
10
+ *
11
+ * The envelope AND the end-marker are added centrally in
12
+ * `sendTrackedMessage` (the trunk) so all 30+ call sites automatically
13
+ * benefit without per-site changes.
14
+ *
15
+ * The subsystem is derived from the source path's first segment
16
+ * (e.g. "enforcement/whisper" -> "enforcement",
17
+ * "memory/context-manager" -> "memory",
18
+ * "cognitive/sycophancy-detector" -> "cognitive").
19
+ *
20
+ * The full source is preserved in the message metadata
21
+ * (`details._braidSource`) for debugging and analytics.
22
+ *
23
+ * Filters: the subsystem name is a substring of the envelope
24
+ * ("enforcement" matches "[braid-whisper - enforcement]"), so bare-name
25
+ * filters keep working; bracket-prefix filters
26
+ * (`grep '\[enforcement\]'`) need the canonical form
27
+ * `grep '\[braid-whisper - enforcement\]'`. Body-level sub-tags
28
+ * (`[<subsystem>-<event>]`) can still be added inside the message body
29
+ * as a second filter level - the envelope is one level above them.
30
+ */
31
+ /**
32
+ * Format the universal envelope line for a given source.
33
+ * Returns "[braid-whisper - <subsystem> @ 17:05 MSK]" with no trailing
34
+ * whitespace.
35
+ *
36
+ * The subsystem is the first segment of the source path. If the source
37
+ * is empty or has no "/", the literal "system" is used as the fallback.
38
+ *
39
+ * The `@ HH:MM TZ` timestamp is the
40
+ * generation time in the owner time zone (lib/utils/local-time.ts) — it
41
+ * lets the agent tell a fresh whisper from a stale re-injection. It is
42
+ * rendered by the ONE formatter (formatWhisperClock) so whisper headers
43
+ * and body time strings never diverge.
44
+ *
45
+ * @param source source path; first segment becomes the subsystem tag
46
+ * @param now clock instant (default now; test hook setLocalTimeClockForTests
47
+ * pins it for deterministic assertions)
48
+ */
49
+ export declare function formatWhisperEnvelope(source: string, now?: Date): string;
50
+ /**
51
+ * Format the explicit end-marker that closes every braid whisper.
52
+ * Returns "[braid-whisper-end]" with no trailing whitespace.
53
+ *
54
+ * The marker is delivered as its own final text element (see
55
+ * applyWhisperEnvelope) so a multiline whisper body has an
56
+ * unambiguous end boundary even when the body itself spans
57
+ * several lines.
58
+ */
59
+ export declare function formatWhisperEndMarker(): string;
60
+ /**
61
+ * Apply the universal envelope to a content array in place.
62
+ * Prepends the envelope line (with `@ HH:MM TZ` generation timestamp) to the
63
+ * first text element, separated by `\n` so the opening tag line carries
64
+ * nothing after `]` and the body starts on the next line. If no text element
65
+ * exists, a new text element is prepended. Always appends a final
66
+ * `[braid-whisper-end]` marker as the LAST text element so every whisper has
67
+ * an unambiguous end boundary.
68
+ *
69
+ * The end-marker is added as a separate trailing text element (rather
70
+ * than being appended inside the last element's text) so the envelope
71
+ * prefix on the first element is never clobbered and the marker always
72
+ * lands on its own line when pi renders multi-part text content.
73
+ *
74
+ * Mutates the input array. This is acceptable because all callers
75
+ * create the content array inline and do not reuse it after delivery.
76
+ *
77
+ * @param content message content array (mutated in place)
78
+ * @param source source path; first segment becomes the subsystem tag
79
+ * @param now clock instant for the header timestamp (default now;
80
+ * test hook pins it)
81
+ *
82
+ * Example:
83
+ * Input: [{ type: "text", text: "Error burst detected" }]
84
+ * Source: "enforcement/whisper"
85
+ * After: [
86
+ * { type: "text", text: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected" },
87
+ * { type: "text", text: "[braid-whisper-end]" },
88
+ * ]
89
+ * Rendered: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected\n[braid-whisper-end]"
90
+ */
91
+ export declare function applyWhisperEnvelope(content: {
92
+ type: string;
93
+ text?: string;
94
+ }[], source: string, now?: Date): void;
95
+ //# sourceMappingURL=whisper-format.d.ts.map
@@ -0,0 +1,115 @@
1
+ /**
2
+ * Whisper Envelope - Universal prefix for system-injected messages.
3
+ *
4
+ * Every message sent via `sendTrackedMessage` is wrapped with a
5
+ * `[braid-whisper - <subsystem> @ <time>]` envelope and closed with an
6
+ * explicit `[braid-whisper-end]` end-marker so the agent can reliably
7
+ * distinguish system-injected signals from human user input, can
8
+ * unambiguously detect where a (possibly multiline) whisper body ends,
9
+ * and can tell a fresh whisper from a stale re-injection (header clock).
10
+ *
11
+ * The envelope AND the end-marker are added centrally in
12
+ * `sendTrackedMessage` (the trunk) so all 30+ call sites automatically
13
+ * benefit without per-site changes.
14
+ *
15
+ * The subsystem is derived from the source path's first segment
16
+ * (e.g. "enforcement/whisper" -> "enforcement",
17
+ * "memory/context-manager" -> "memory",
18
+ * "cognitive/sycophancy-detector" -> "cognitive").
19
+ *
20
+ * The full source is preserved in the message metadata
21
+ * (`details._braidSource`) for debugging and analytics.
22
+ *
23
+ * Filters: the subsystem name is a substring of the envelope
24
+ * ("enforcement" matches "[braid-whisper - enforcement]"), so bare-name
25
+ * filters keep working; bracket-prefix filters
26
+ * (`grep '\[enforcement\]'`) need the canonical form
27
+ * `grep '\[braid-whisper - enforcement\]'`. Body-level sub-tags
28
+ * (`[<subsystem>-<event>]`) can still be added inside the message body
29
+ * as a second filter level - the envelope is one level above them.
30
+ */
31
+ import { formatWhisperClock, nowOrOverride } from "./local-time.js";
32
+ /**
33
+ * Format the universal envelope line for a given source.
34
+ * Returns "[braid-whisper - <subsystem> @ 17:05 MSK]" with no trailing
35
+ * whitespace.
36
+ *
37
+ * The subsystem is the first segment of the source path. If the source
38
+ * is empty or has no "/", the literal "system" is used as the fallback.
39
+ *
40
+ * The `@ HH:MM TZ` timestamp is the
41
+ * generation time in the owner time zone (lib/utils/local-time.ts) — it
42
+ * lets the agent tell a fresh whisper from a stale re-injection. It is
43
+ * rendered by the ONE formatter (formatWhisperClock) so whisper headers
44
+ * and body time strings never diverge.
45
+ *
46
+ * @param source source path; first segment becomes the subsystem tag
47
+ * @param now clock instant (default now; test hook setLocalTimeClockForTests
48
+ * pins it for deterministic assertions)
49
+ */
50
+ export function formatWhisperEnvelope(source, now = nowOrOverride()) {
51
+ const subsystem = source.split("/")[0] || "system";
52
+ return `[braid-whisper - ${subsystem} @ ${formatWhisperClock(now)}]`;
53
+ }
54
+ /**
55
+ * Format the explicit end-marker that closes every braid whisper.
56
+ * Returns "[braid-whisper-end]" with no trailing whitespace.
57
+ *
58
+ * The marker is delivered as its own final text element (see
59
+ * applyWhisperEnvelope) so a multiline whisper body has an
60
+ * unambiguous end boundary even when the body itself spans
61
+ * several lines.
62
+ */
63
+ export function formatWhisperEndMarker() {
64
+ return "[braid-whisper-end]";
65
+ }
66
+ /**
67
+ * Apply the universal envelope to a content array in place.
68
+ * Prepends the envelope line (with `@ HH:MM TZ` generation timestamp) to the
69
+ * first text element, separated by `\n` so the opening tag line carries
70
+ * nothing after `]` and the body starts on the next line. If no text element
71
+ * exists, a new text element is prepended. Always appends a final
72
+ * `[braid-whisper-end]` marker as the LAST text element so every whisper has
73
+ * an unambiguous end boundary.
74
+ *
75
+ * The end-marker is added as a separate trailing text element (rather
76
+ * than being appended inside the last element's text) so the envelope
77
+ * prefix on the first element is never clobbered and the marker always
78
+ * lands on its own line when pi renders multi-part text content.
79
+ *
80
+ * Mutates the input array. This is acceptable because all callers
81
+ * create the content array inline and do not reuse it after delivery.
82
+ *
83
+ * @param content message content array (mutated in place)
84
+ * @param source source path; first segment becomes the subsystem tag
85
+ * @param now clock instant for the header timestamp (default now;
86
+ * test hook pins it)
87
+ *
88
+ * Example:
89
+ * Input: [{ type: "text", text: "Error burst detected" }]
90
+ * Source: "enforcement/whisper"
91
+ * After: [
92
+ * { type: "text", text: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected" },
93
+ * { type: "text", text: "[braid-whisper-end]" },
94
+ * ]
95
+ * Rendered: "[braid-whisper - enforcement @ 17:05 MSK]\nError burst detected\n[braid-whisper-end]"
96
+ */
97
+ export function applyWhisperEnvelope(content, source, now = nowOrOverride()) {
98
+ const envelope = formatWhisperEnvelope(source, now);
99
+ if (content.length === 0) {
100
+ content.unshift({ type: "text", text: `${envelope}\n` });
101
+ }
102
+ else {
103
+ const firstText = content.find((c) => c.type === "text");
104
+ if (firstText) {
105
+ const currentText = firstText.text ?? "";
106
+ firstText.text =
107
+ currentText.length > 0 ? `${envelope}\n${currentText}` : `${envelope}\n`;
108
+ }
109
+ else {
110
+ content.unshift({ type: "text", text: `${envelope}\n` });
111
+ }
112
+ }
113
+ content.push({ type: "text", text: formatWhisperEndMarker() });
114
+ }
115
+ //# sourceMappingURL=whisper-format.js.map