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,872 @@
1
+ /**
2
+ * Wake-retry queue — timer wake reliability.
3
+ *
4
+ * Four related guarantees live here:
5
+ *
6
+ * 1. FAILED-WAKE RETRY: a wake fire (triggerTurn:true) whose turn
7
+ * FAILS with a provider/auth error (assistant stopReason "error") must not
8
+ * sit in history until an unrelated turn processes it, surfacing hours
9
+ * later. The queue tracks every delivered wake fire as "outstanding"; a
10
+ * failed run (onAgentEnd(true) + onAgentSettled()) re-arms it for
11
+ * redelivery with bounded exponential backoff (5s/15s/45s/2m/5m, capped —
12
+ * default 3 redeliveries, braid.timers.maxWakeAttempts). A wake whose turn
13
+ * never produced an outcome (pi-core pre-flight abort emits NO extension
14
+ * event) times out after WAKE_OUTCOME_TIMEOUT_MS and retries anyway. A
15
+ * wake fire is therefore never silently lost.
16
+ *
17
+ * 1b. BUSY-SEND DEFERRAL: a wake whose SEND was held back because the
18
+ * session was busy at send time (isAgentBusy() — compaction or run
19
+ * bookkeeping; a raw triggerTurn there would start a competing agent
20
+ * run) re-enters this queue via deferBusyWake() and redelivers on the
21
+ * same bounded ladder, with an honest "held while busy" cause so the
22
+ * redelivery text does not claim a failed turn. The outstanding entry is
23
+ * marked busy-deferred until a redelivery actually sends: a settle of an
24
+ * unrelated run that merely overlaps the deferral window must not
25
+ * resolve the wake as delivered. When the bounded ladder is spent and
26
+ * nothing FAILED, the fire is PARKED (parkedBusy) rather than dropped:
27
+ * drainParkedBusy() hands it to one late delivery at the next idle tick
28
+ * (the settle's own drain), with the hold duration in the text. The cap
29
+ * bounds the retries, not the delivery — a session busy longer than the
30
+ * ladder still receives the fire exactly once, and a busy-held fire
31
+ * never enters the exhausted set (the watchdog's "permanently
32
+ * undelivered" page stays reserved for genuinely unsalvageable cases).
33
+ *
34
+ * 2. RECOVERED-FIRE DEFERRAL: recoverPersistedTimers
35
+ * (scheduling/timer/recovery.ts) must not deliver expired persisted fires
36
+ * INLINE inside before_agent_start — a turn is already starting, so a
37
+ * triggerTurn there races the pre-flight (pi-core activeRun guard) and a
38
+ * steer dies with the run if the pre-flight aborts. Recovery parks fires
39
+ * via deferRecoveredFire(); the timer extension's agent_settled handler
40
+ * calls flushRecoveredFires(), which delivers AFTER the run has fully
41
+ * settled — where a wake:true fire safely starts its own turn — and feeds
42
+ * failed deliveries into the retry machinery above.
43
+ *
44
+ * 3. DRAIN LIVENESS: the retry queue is drained by the SAME ticks
45
+ * that fire expired timers (TimerPoller poll tick and the
46
+ * TOOL_EXECUTION_END / TURN_END fireExpired path) — retries never wait
47
+ * for a user turn.
48
+ *
49
+ * 4. HONEST ATTRIBUTION, CANCEL RETIREMENT, LONG-RUN GRACE: a redelivery
50
+ * carries a WakeRetryCause rendered verbatim in its text — "failed"
51
+ * (the turn's settle was a provider/auth error), "busy" (the send was
52
+ * deferred), or "timeout" (the outcome window elapsed with no settle and
53
+ * no run in flight). The outcome timeout must not claim a failed turn.
54
+ * LONG-RUN GRACE: drainDue does not arm (or count) an outcome timeout
55
+ * while an agent run is active for a wake whose send was not busy-
56
+ * deferred — the run is plausibly the wake's own turn and a merely-long
57
+ * run is not a lost send; the 240s window keeps its job for the send
58
+ * that never started a turn (pre-flight abort). The active-run predicate
59
+ * is wired by timer/index.ts from the captured session ctx; absent or
60
+ * throwing it degrades to the pre-grace arming (never suppress retries
61
+ * on a broken reader). CANCEL RETIREMENT: cancelTimer/cancelTimersByTag
62
+ * (and the session-shutdown clear) withdraw the fire with the timer —
63
+ * retireTimer/retireTimersWhere drop the outstanding wake, the armed
64
+ * ladder, parked recovered fires, and the timeout-count bookkeeping, and
65
+ * mark the id retired so an in-flight deferred send (fireTimer or a
66
+ * popped redelivery) is suppressed at send time. Retirement is a
67
+ * WITHDRAWAL, not a delivery: stats.succeeded stays untouched.
68
+ *
69
+ * Mitigations (wake-retry flood):
70
+ *
71
+ * a. Outcome window: legitimate wake turns run 2-4min; a shorter window
72
+ * arms spurious "false timeout" retries mid-turn (the 5s backoff usually
73
+ * drains before the settle's success-clear can cancel).
74
+ *
75
+ * b. Retryable-failure hold: pi-core auto-retries a RETRYABLE provider
76
+ * failure (transport/timeout/5xx — RETRYABLE_PROVIDER_ERROR_PATTERN
77
+ * classes) inside the SAME run, and those auto_retry_start/end events
78
+ * are NOT surfaceable to extensions (absent from ExtensionAPI's
79
+ * ExtensionEvent union), so the queue instead mirrors pi-core's
80
+ * retryable classes (isRetryableWakeError) and HOLDS the outcome
81
+ * timeout for a bounded window matching pi-core's retry budget
82
+ * (baseDelayMs * 2^maxRetries, read from settings.json `retry` —
83
+ * getWakeRetryHoldMs). While the hold is active, drainDue cannot arm a
84
+ * mid-cycle redelivery; the settle (which fires only after pi-core's
85
+ * retry loop is done) is the sole arming authority for retryable
86
+ * failures — final failure arms exactly one ladder, success clears
87
+ * everything. A hold expires harmlessly: the next drainDue tick
88
+ * after expiry re-checks the (still missing) outcome and arms.
89
+ *
90
+ * c. Redelivery cap (WAKE_RETRY_MAX_ATTEMPTS), owner-tunable via
91
+ * braid.timers.maxWakeAttempts (braid-settings.ts) — a deep ladder on a
92
+ * flaky provider out-floods the session.
93
+ *
94
+ * Failure detection: agent_end carries the run's messages; the LAST assistant
95
+ * message's stopReason === "error" marks the run failed (provider 401/413/5xx
96
+ * path). "aborted" is deliberate user action — the content is already in
97
+ * history, so it resolves as delivered, not retried.
98
+ *
99
+ * All pi event wiring lives in timer/index.ts; this module holds no event
100
+ * listeners and no module-level mutable state beyond the exported singleton
101
+ * (class instance — same pattern as timerManager).
102
+ */
103
+ import { createLogger } from "../../../lib/core/logger.js";
104
+ import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
105
+ import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
106
+ import { describeFireTiming } from "./fire-timing.js";
107
+ import { MAX_WAKE_ATTEMPTS_DEFAULT, getMaxWakeAttempts, getTerminalBreakerConfig, getWakeRetryHoldMs, } from "../../../lib/config/braid-settings.js";
108
+ import { getTurnStartGate } from "../../../lib/state/global-state.js";
109
+ const log = createLogger("timer-wake-retry");
110
+ /**
111
+ * Consumer gate shared by the wake sends: is the terminal-error breaker open,
112
+ * so this fire must ride non-waking? Asks the published turn-start gate one
113
+ * latch question and nothing else. Flag read once per fire; a missing ctx, a
114
+ * missing gate or a broken reader fails open (never silently drop a wake).
115
+ * Mirrors the helper in index.ts — kept here so the recovered-fire flush can
116
+ * use it without importing back from the module that imports this one.
117
+ */
118
+ function terminalBreakerBlocksWake(ctx) {
119
+ try {
120
+ if (!ctx)
121
+ return false;
122
+ const cfg = getTerminalBreakerConfig();
123
+ if (!cfg.enabled)
124
+ return false;
125
+ const gate = getTurnStartGate();
126
+ if (!gate)
127
+ return false;
128
+ return gate.isBlocked(ctx, cfg.threshold);
129
+ }
130
+ catch {
131
+ return false;
132
+ }
133
+ }
134
+ /** Outcome window: a wake with no agent_end/agent_settled within this window
135
+ * (e.g. pi-core pre-flight abort — no extension event on that path) is
136
+ * re-armed for retry. 240s comfortably exceeds a normal long turn (babysit
137
+ * wake turns run 2-4min); a shorter window arms a spurious retry mid-run.
138
+ * A genuinely hung run is rarer than a long one. */
139
+ export const WAKE_OUTCOME_TIMEOUT_MS = 240_000;
140
+ /** Backoff tiers between redelivery attempts (index = attempt - 1). */
141
+ export const WAKE_RETRY_BACKOFF_MS = [5_000, 15_000, 45_000, 120_000, 300_000];
142
+ /** Redelivery bound. Attempt > the effective cap (WAKE_RETRY_MAX_ATTEMPTS
143
+ * default, owner-tunable via braid.timers.maxWakeAttempts) exhausts the
144
+ * fire — a deep ladder on a flaky provider out-floods the session. */
145
+ export const WAKE_RETRY_MAX_ATTEMPTS = MAX_WAKE_ATTEMPTS_DEFAULT;
146
+ // retryable-failure classification (pi-core mirror)
147
+ /** Quota/billing-class failures pi-ai never retries: the same literals pi-ai
148
+ * builds NON_RETRYABLE_PROVIDER_LIMIT_ERROR_PATTERN from
149
+ * (pi-ai/dist/utils/retry.js). Checked first: pi-ai refuses to retry these, so
150
+ * the run's outcome is final and the wake must never be held for an auto-retry
151
+ * that will not come. The bare phrase "usage limit" is deliberately absent: it
152
+ * also vetoes texts pi-ai DOES retry (a 429 whose body mentions a usage limit),
153
+ * which suppresses the hold that retry needs.
154
+ *
155
+ * Pinned by test/runtime/lib/test-wake-retry-nonretryable-mirror.mjs, which
156
+ * reads the token array out of the installed pi-ai module and requires each
157
+ * one to be vetoed here. The retryable side below is NOT pinned: it is a
158
+ * hand-written subset of pi-ai's retryable classes, so a failure pi-ai retries
159
+ * but this mirror does not match settles with no hold. */
160
+ const WAKE_NON_RETRYABLE_ERROR_PATTERN = new RegExp([
161
+ "GoUsageLimitError",
162
+ "FreeUsageLimitError",
163
+ "Monthly usage limit reached",
164
+ "available balance",
165
+ "insufficient_quota",
166
+ "out of budget",
167
+ "quota exceeded",
168
+ "billing",
169
+ "subscription_sharing_usage_limit_exceeded",
170
+ ].join("|"), "i");
171
+ /** The retryable classes braid mirrors from pi-core's
172
+ * RETRYABLE_PROVIDER_ERROR_PATTERN (pi-ai/dist/utils/retry.js): transport
173
+ * failures, premature stream endings, timeouts, HTTP 5xx/429. A failed
174
+ * agent_end matching this means pi-core will auto-retry inside the SAME
175
+ * run — the run's outcome is not final yet (see the hold in
176
+ * onAgentEnd/drainDue). */
177
+ const WAKE_RETRYABLE_ERROR_PATTERN = new RegExp([
178
+ "overloaded",
179
+ "rate.?limit",
180
+ "too many requests",
181
+ "\\b429\\b",
182
+ "\\b5\\d\\d\\b",
183
+ "service.?unavailable",
184
+ "server.?error",
185
+ "network.?error",
186
+ "connection.?error",
187
+ "connection.?refused",
188
+ "other side closed",
189
+ "fetch failed",
190
+ "upstream.?connect",
191
+ "socket hang up",
192
+ "timed? out",
193
+ "timeout",
194
+ "terminated",
195
+ "ended without",
196
+ "stream ended before",
197
+ ].join("|"), "i");
198
+ /** Whether an agent_end errorMessage belongs to a failure class pi-core
199
+ * auto-retries (hold the wake outcome); quota/auth-class errors never hold. */
200
+ export function isRetryableWakeError(errorMessage) {
201
+ if (!errorMessage)
202
+ return false;
203
+ if (WAKE_NON_RETRYABLE_ERROR_PATTERN.test(errorMessage))
204
+ return false;
205
+ return WAKE_RETRYABLE_ERROR_PATTERN.test(errorMessage);
206
+ }
207
+ export class WakeRetryQueue {
208
+ outstanding = new Map();
209
+ retries = [];
210
+ exhaustedFires = [];
211
+ deferredRecovered = [];
212
+ lastRunFailed = null;
213
+ /** Timer ids whose injected messages were present in the just-ended run's
214
+ * messages (extracted from agent_end by the timer extension). A fire on
215
+ * this list was DELIVERED — a later run failure is the agent's own work
216
+ * failing, not the delivery, and must not re-arm it. */
217
+ landedTimerIds = null;
218
+ stats = {
219
+ tracked: 0,
220
+ succeeded: 0,
221
+ timedOut: 0,
222
+ exhausted: 0,
223
+ heldBusy: 0,
224
+ };
225
+ now = () => Date.now();
226
+ /** While set and not expired, the outcome timeout must not arm —
227
+ * pi-core may still be auto-retrying the run (outcome undecided). */
228
+ retryHoldUntil = null;
229
+ /** Test hooks: pin the hold window / redelivery cap. null restores the
230
+ * settings-derived values (getWakeRetryHoldMs / braid.timers
231
+ * .maxWakeAttempts). */
232
+ retryHoldOverrideMs = null;
233
+ maxAttemptsOverride = null;
234
+ /** Cumulative outcome-timeout count per timer id, across the fire's whole
235
+ * redelivery chain (original + redeliveries). Feeds the repeated-timeout
236
+ * stall signal: one 240s window is a normal long turn, a SECOND one for
237
+ * the same fire is a wedged loop. Cleared when the fire resolves delivered
238
+ * or exhausts. Factory/instance state — never a module-level let. */
239
+ timeoutCounts = new Map();
240
+ /** Optional liveness observer (timer/index.ts wires the watchdog feed). */
241
+ wakeObserver = null;
242
+ /** Live read-only predicate: is an agent run (or its pre-flight /
243
+ * compaction tail) active right now? Wired by timer/index.ts from the
244
+ * captured session ctx. Absent or throwing = not active — the arming
245
+ * behavior degrades to the pre-grace form (a wake is never silently
246
+ * lost, so a broken reader must not suppress retries). */
247
+ activeRunCheck = null;
248
+ /** Timer ids retired by a cancel (the fire and its ladder withdrawn by
249
+ * the owner). Guards the in-flight windows: a fire deferred inside the
250
+ * poller (checkExpired -> setTimeout(0)) and a redelivery popped from
251
+ * the ladder (drainDue -> setTimeout(0)) both re-check this mark at
252
+ * send time, so a cancel landing inside either window suppresses the
253
+ * send. Cleared by trackWake — a fresh fire of the same id (recovered
254
+ * after a restart, say) re-arms its own chain. */
255
+ retired = new Set();
256
+ /** Set (or clear with null) the wake-liveness observer. Invoked at the
257
+ * timeout-arming and delivered-resolve points only; never on the send
258
+ * path. */
259
+ setWakeObserver(observer) {
260
+ this.wakeObserver = observer;
261
+ }
262
+ /** Test hook: pin the clock (backoff/timeout math). null restores Date.now(). */
263
+ _setClockForTests(fn) {
264
+ this.now = fn ?? (() => Date.now());
265
+ }
266
+ /** Test hook: pin the retryable-failure hold window (ms). */
267
+ _setRetryHoldForTests(ms) {
268
+ this.retryHoldOverrideMs = ms;
269
+ }
270
+ /** Test hook: pin the redelivery cap. */
271
+ _setMaxAttemptsForTests(n) {
272
+ this.maxAttemptsOverride = n;
273
+ }
274
+ /** Wire (or clear with null) the live active-run predicate. Consulted by
275
+ * drainDue's outcome-timeout path: while a run is active for a wake whose
276
+ * send was NOT busy-deferred, the run is plausibly the wake's own turn —
277
+ * a merely-long run must not arm a redelivery (and via the observer, a
278
+ * page). See the long-run grace contract in the module header. */
279
+ setActiveRunCheck(fn) {
280
+ this.activeRunCheck = fn;
281
+ }
282
+ isFireTurnRunning() {
283
+ const fn = this.activeRunCheck;
284
+ if (!fn)
285
+ return false;
286
+ try {
287
+ return fn() === true;
288
+ }
289
+ catch {
290
+ return false;
291
+ }
292
+ }
293
+ /** Effective redelivery cap: braid.timers.maxWakeAttempts (default 3). */
294
+ getMaxAttempts() {
295
+ return this.maxAttemptsOverride ?? getMaxWakeAttempts();
296
+ }
297
+ holdWindowMs() {
298
+ return this.retryHoldOverrideMs ?? getWakeRetryHoldMs();
299
+ }
300
+ /**
301
+ * Track a wake fire BEFORE (or at) delivery so its turn outcome can be
302
+ * resolved. `attempt` 0 = original fire; the redelivery path re-tracks with
303
+ * the drained attempt number. Re-tracking the same timer id refreshes the
304
+ * outcome window (the newest delivery is the one whose outcome matters).
305
+ *
306
+ * `continueHold` marks an attempt-0 re-track that continues the SAME fire's
307
+ * delivery chain (the parked handoff in deliverParkedBusyFire) instead of
308
+ * starting a newer fire's. Only a chain continuation keeps a busy-deferred
309
+ * predecessor's hold origin; a numbered re-track (attempt >= 1) is one by
310
+ * construction, since the ladder redelivers the fire that armed it.
311
+ */
312
+ trackWake(timer, attempt = 0, options) {
313
+ // A newer delivery of the same timer supersedes any pending redelivery of
314
+ // an older instance (recurring overlap): letting it fire alongside the
315
+ // newer delivery duplicates the reason content. Safe for the redelivery
316
+ // path itself — it re-tracks only after its retry was popped from the
317
+ // list by drainDue.
318
+ this.cancelPendingRetries(timer.id);
319
+ // A fresh fire of a previously-cancelled id re-arms its own chain.
320
+ this.retired.delete(timer.id);
321
+ // A re-track of a busy-deferred delivery keeps the original hold start —
322
+ // the late-delivery text must state the WHOLE held window, not just the
323
+ // last ladder rung. Only a chain continuation keeps it: a NEWER fire of
324
+ // the same id (a recurring cadence) supersedes the parked predecessor and
325
+ // starts its own hold origin, so its late-delivery text reports its own
326
+ // hold and not the predecessor chain's.
327
+ const prev = this.outstanding.get(timer.id);
328
+ const continuesChain = attempt >= 1 || options?.continueHold === true;
329
+ const heldSince = continuesChain && prev?.busyDeferred ? prev.heldSince : undefined;
330
+ this.outstanding.set(timer.id, { timer, attempt, sentAt: this.now(), heldSince });
331
+ this.stats.tracked++;
332
+ }
333
+ /**
334
+ * Record the outcome of the run that just ended. Called from agent_end.
335
+ * A retryable errorMessage (transport/timeout/5xx — pi-core
336
+ * auto-retries inside the SAME run) starts a hold window that defers the
337
+ * outcome-timeout arming in drainUntil the retry cycle resolves; the hold
338
+ * is refreshed on every retryable failure so a long multi-attempt cycle
339
+ * stays covered. Non-retryable failures (auth/quota) arm at settle
340
+ * immediately, as before.
341
+ */
342
+ onAgentEnd(failed, errorMessage, landedTimerIds) {
343
+ this.lastRunFailed = failed;
344
+ // Accumulate across the run's agent_end events: pi-core emits one per
345
+ // loop (main run + every continuation), each carrying only its own
346
+ // messages — the settled landed set is their union. Consumed and cleared
347
+ // at settle.
348
+ if (landedTimerIds) {
349
+ this.landedTimerIds ??= new Set();
350
+ for (const id of landedTimerIds)
351
+ this.landedTimerIds.add(id);
352
+ }
353
+ if (failed && isRetryableWakeError(errorMessage)) {
354
+ this.retryHoldUntil = this.now() + this.holdWindowMs();
355
+ }
356
+ }
357
+ /**
358
+ * Resolve outstanding wakes at the settle boundary (agent_settled — fired
359
+ * after retries/compaction/continuations are done, even for failed runs).
360
+ * A failed run re-arms every outstanding wake; anything else (success or
361
+ * user abort) counts as delivered. Idempotent: a second call with no
362
+ * outstanding wakes is a no-op, so multiple settle listeners cannot
363
+ * double-schedule.
364
+ *
365
+ * A SUCCESSFUL wake turn also clears the pending retry chain for its
366
+ * timer id. Without this, the outcome-timeout path (drainDue) can arm a
367
+ * retry for a fire whose turn is merely LONG (>60s), the turn then settles
368
+ * successfully, the armed retry still fires, and the chain re-delivers a
369
+ * fire whose failure no longer exists — burning the retry cap on
370
+ * duplicates. Only genuinely-failed fires keep retrying to the cap.
371
+ */
372
+ onAgentSettled() {
373
+ const failed = this.lastRunFailed === true;
374
+ const landed = this.landedTimerIds;
375
+ this.lastRunFailed = null;
376
+ this.landedTimerIds = null;
377
+ // The settle fires after pi-core's retry loop is done (it lives in
378
+ // _runAgentPrompt's finally) — the outcome is final, any hold is void.
379
+ this.retryHoldUntil = null;
380
+ const now = this.now();
381
+ for (const [id, w] of this.outstanding) {
382
+ if (w.busyDeferred) {
383
+ // No turn ran for this wake (send deferred: session busy at send
384
+ // time). This settle belongs to an unrelated run — it must neither
385
+ // resolve the wake as delivered nor clear its armed retry, and the
386
+ // entry is KEPT: the pending busy rung, or the parked late delivery,
387
+ // owns its liveness past this settle.
388
+ continue;
389
+ }
390
+ if (failed && !landed?.has(w.timer.id)) {
391
+ this.scheduleRetry(w.timer, w.attempt + 1, now);
392
+ }
393
+ else {
394
+ this.stats.succeeded++;
395
+ this.timeoutCounts.delete(w.timer.id);
396
+ this.cancelPendingRetries(w.timer.id);
397
+ try {
398
+ this.wakeObserver?.onWakeDelivered?.(w.timer);
399
+ }
400
+ catch {
401
+ // alerting must never break outcome resolution
402
+ }
403
+ try {
404
+ // The wake path is the layer that knows a TURN completed cleanly —
405
+ // an internal LLM call cannot distinguish itself — so the breaker's
406
+ // clean-turn reset lives here, not in the raw success counter.
407
+ this.wakeObserver?.onCleanTurn?.();
408
+ }
409
+ catch {
410
+ // a throwing observer must never break settlement
411
+ }
412
+ }
413
+ this.outstanding.delete(id);
414
+ }
415
+ }
416
+ /**
417
+ * Arm a redelivery for a wake whose SEND was deferred: the session was
418
+ * busy at send time (ctx.signal undefined while ctx.isIdle() is false —
419
+ * compaction / run bookkeeping; a raw triggerTurn there would start a
420
+ * competing agent run). Rides the same bounded backoff ladder and cap as
421
+ * failed-turn redeliveries; the redelivery text says "held while the
422
+ * session was busy" instead of claiming a failed turn. The outstanding
423
+ * entry is marked busy-deferred so a settle of an unrelated run that
424
+ * overlaps the deferral window cannot resolve the wake as delivered.
425
+ *
426
+ * When the ladder is spent the fire is PARKED, never dropped: nothing
427
+ * failed, so the exhausted path (and the watchdog's undelivered page) does
428
+ * not apply. drainParkedBusy() then hands it to one late delivery once the
429
+ * session is idle, with the full hold duration in the text.
430
+ */
431
+ deferBusyWake(timer, attempt) {
432
+ const now = this.now();
433
+ const w = this.outstanding.get(timer.id);
434
+ if (w) {
435
+ w.busyDeferred = true;
436
+ if (w.heldSince === undefined)
437
+ w.heldSince = now;
438
+ }
439
+ if (attempt + 1 > this.getMaxAttempts()) {
440
+ this.parkBusyFire(timer, w, attempt, now);
441
+ return;
442
+ }
443
+ const armed = this.scheduleRetry(timer, attempt + 1, now, "busy");
444
+ if (armed && w) {
445
+ // The deferral armed the ladder itself: mark the entry so the outcome
446
+ // window neither re-arms it (which would only push the redelivery
447
+ // back out) nor feeds the repeated-timeout stall signal. The ladder
448
+ // drains at its own backoff; the wake resolves delivered when its
449
+ // eventual turn settles.
450
+ w.timedOut = true;
451
+ }
452
+ }
453
+ /** Park a busy-held fire whose bounded ladder is spent. The fire is NOT
454
+ * dropped and NOT counted as exhausted: it waits for one late delivery at
455
+ * the next idle drain. An untracked deferral (a wiring defect — every wake
456
+ * path tracks before sending) is parked on a fresh entry so a held wake
457
+ * can never be lost here. */
458
+ parkBusyFire(timer, w, attempt, now) {
459
+ if (w) {
460
+ w.parkedBusy = true;
461
+ w.timedOut = true;
462
+ }
463
+ else {
464
+ this.outstanding.set(timer.id, {
465
+ timer,
466
+ attempt,
467
+ sentAt: now,
468
+ busyDeferred: true,
469
+ heldSince: now,
470
+ parkedBusy: true,
471
+ timedOut: true,
472
+ });
473
+ log.warn(`[timer] busy deferral for an untracked fire — parked it directly: ${timer.id}`);
474
+ }
475
+ this.timeoutCounts.delete(timer.id);
476
+ this.stats.heldBusy++;
477
+ log.info(`[timer] wake fire held while the session was busy — ` +
478
+ `${this.getMaxAttempts()} attempt(s) spent, parked for one late delivery: ${timer.id}`);
479
+ }
480
+ /**
481
+ * Hand off parked busy-held fires that can be delivered now: the session is
482
+ * not positively busy (an active run / pre-flight / compaction keeps them
483
+ * parked — the send's own onBusy hook would only hold the fire again, so
484
+ * waiting keeps this to one handoff per settle rather than one attempt per
485
+ * poll tick). Each handed-off fire is marked in-flight so a concurrent tick
486
+ * cannot hand it off twice; the caller re-tracks it (trackWake) and a send
487
+ * that is deferred again is held again — one fresh rung, then a re-park once
488
+ * the cap is hit again.
489
+ */
490
+ drainParkedBusy() {
491
+ if (this.isFireTurnRunning())
492
+ return [];
493
+ const now = this.now();
494
+ const out = [];
495
+ for (const [, w] of this.outstanding) {
496
+ if (!w.parkedBusy || w.parkedDelivering)
497
+ continue;
498
+ w.parkedDelivering = true;
499
+ out.push({ timer: w.timer, heldMs: Math.max(0, now - (w.heldSince ?? w.sentAt)) });
500
+ }
501
+ return out;
502
+ }
503
+ /** Forget a parked busy-held fire without a late delivery — its content was
504
+ * shown non-waking (terminal-error breaker) or the caller withdrew it. */
505
+ forgetParkedBusy(timerId) {
506
+ if (this.outstanding.get(timerId)?.parkedBusy)
507
+ this.outstanding.delete(timerId);
508
+ }
509
+ /**
510
+ * Called on every poll tick / TOOL_EXECUTION_END / TURN_END (the same
511
+ * ticks that fire expired timers). First re-arms outstanding wakes that
512
+ * never got an outcome (timeout fallback), then returns retries whose
513
+ * backoff has elapsed. The CALLER performs the redelivery (deferred via
514
+ * setTimeout(0), like every fire-path send) and re-tracks the outcome via
515
+ * trackWake(timer, attempt).
516
+ */
517
+ drainDue() {
518
+ const now = this.now();
519
+ // A retryable failure may still be inside pi-core's auto-retry
520
+ // cycle — the run's final outcome is undecided, so the outcome timeout
521
+ // must NOT arm a mid-cycle redelivery (the flood source). After the hold
522
+ // expires the normal timeout math applies (bounded re-check); a settle
523
+ // in the meantime clears the hold entirely.
524
+ const holdActive = this.retryHoldUntil !== null && now < this.retryHoldUntil;
525
+ // Long-run grace: an outcome window that elapses while a run is active
526
+ // for a wake whose send was NOT busy-deferred is a merely-long turn, not
527
+ // a lost send. Do not arm (and do not count it toward the repeated-
528
+ // timeout stall signal): the run's own settle resolves the wake. The
529
+ // 240s window keeps its job for the send that never started a turn
530
+ // (pre-flight abort — no run is active then, so the timeout arms with
531
+ // the honest "timeout" cause and the recovery path survives).
532
+ const runActive = !holdActive && this.isFireTurnRunning();
533
+ for (const [id, w] of this.outstanding) {
534
+ if (w.timedOut)
535
+ continue; // A retry is already armed for this delivery
536
+ if (holdActive)
537
+ continue;
538
+ if (runActive && !w.busyDeferred)
539
+ continue; // long-run grace
540
+ if (now - w.sentAt < WAKE_OUTCOME_TIMEOUT_MS)
541
+ continue;
542
+ this.stats.timedOut++;
543
+ const timeouts = (this.timeoutCounts.get(id) ?? 0) + 1;
544
+ this.timeoutCounts.set(id, timeouts);
545
+ log.warn(`[timer] wake outcome timeout (${WAKE_OUTCOME_TIMEOUT_MS}ms, #${timeouts} for this fire) for ${id} — re-arming for retry`);
546
+ try {
547
+ this.wakeObserver?.onOutcomeTimeout?.(w.timer, timeouts);
548
+ }
549
+ catch {
550
+ // alerting must never break the retry arming
551
+ }
552
+ const armed = this.scheduleRetry(w.timer, w.attempt + 1, now, w.busyDeferred ? "busy" : "timeout");
553
+ if (armed) {
554
+ // Keep the entry (marked) so the eventual settle of this
555
+ // delivery — success OR failure — still resolves it. Deleting here
556
+ // orphaned the chain: the later successful settle found
557
+ // an empty outstanding map and the armed retry kept firing.
558
+ w.timedOut = true;
559
+ }
560
+ else {
561
+ // Exhausted (pre-flight-abort chain): nothing left to resolve.
562
+ this.outstanding.delete(id);
563
+ }
564
+ }
565
+ const due = [];
566
+ const remaining = [];
567
+ for (const r of this.retries) {
568
+ if (r.nextAttemptAt <= now) {
569
+ due.push({ timer: r.timer, attempt: r.attempt, cause: r.cause });
570
+ }
571
+ else {
572
+ remaining.push(r);
573
+ }
574
+ }
575
+ this.retries = remaining;
576
+ return due;
577
+ }
578
+ /** Fires dropped after exceeding the redelivery bound (for a final notice). */
579
+ takeExhausted() {
580
+ const out = this.exhaustedFires;
581
+ this.exhaustedFires = [];
582
+ return out;
583
+ }
584
+ /** Park a recovered persisted fire for post-settle delivery (fix 3). */
585
+ deferRecoveredFire(fire) {
586
+ this.deferredRecovered.push(fire);
587
+ }
588
+ /** Drain parked recovered fires (one-shot; re-park on delivery failure). */
589
+ takeRecoveredFires() {
590
+ const out = this.deferredRecovered;
591
+ this.deferredRecovered = [];
592
+ return out;
593
+ }
594
+ deferredRecoveredCount() {
595
+ return this.deferredRecovered.length;
596
+ }
597
+ outstandingCount() {
598
+ return this.outstanding.size;
599
+ }
600
+ /**
601
+ * Whether any OUTSTANDING wake is a redelivery
602
+ * (attempt >= 1 — re-tracked via trackWake(timer, attempt) by the
603
+ * redelivery path). While true, a wake fire re-delivered after a failed
604
+ * turn is in flight and its outcome has not settled. Read-only query —
605
+ * NO redelivery behavior change (redelivery logic itself is out of scope
606
+ * for callers of this accessor).
607
+ *
608
+ * Precision note: if the wake-gate rewrote the retry into a queued steer
609
+ * inside an active run, this stays true until that run settles, so one
610
+ * unrelated mid-run judge opportunity may be skipped. A skipped judge is
611
+ * merely delayed (next non-redelivery turn judges); a false FAIL audit of
612
+ * a fragment turn is the failure mode this gate exists to prevent.
613
+ */
614
+ hasOutstandingRedelivery() {
615
+ for (const w of this.outstanding.values()) {
616
+ if (w.attempt >= 1)
617
+ return true;
618
+ }
619
+ return false;
620
+ }
621
+ pendingRetryCount() {
622
+ return this.retries.length;
623
+ }
624
+ /**
625
+ * Retire a cancelled timer's fire: drop its outstanding wake (if any), its
626
+ * armed ladder, any parked recovered fire for the id, and the repeated-
627
+ * timeout bookkeeping. Marks the id retired so an in-flight send is
628
+ * suppressed (see `retired`). Called from cancelTimer — including when the
629
+ * timer is no longer in the manager map (a fired one-shot is deleted from
630
+ * it at expiry, but its wake ladder may still be armed; the cancel must
631
+ * reach it). Retirement is a WITHDRAWAL, not a delivery: stats.succeeded
632
+ * stays untouched.
633
+ */
634
+ retireTimer(timerId) {
635
+ const hadOutstanding = this.outstanding.delete(timerId);
636
+ const retriesBefore = this.retries.length;
637
+ this.retries = this.retries.filter((r) => r.timer.id !== timerId);
638
+ const droppedRetries = retriesBefore - this.retries.length;
639
+ const recoveredBefore = this.deferredRecovered.length;
640
+ this.deferredRecovered = this.deferredRecovered.filter((f) => f.id !== timerId);
641
+ const droppedRecovered = recoveredBefore - this.deferredRecovered.length;
642
+ this.timeoutCounts.delete(timerId);
643
+ this.retired.add(timerId);
644
+ if (hadOutstanding || droppedRetries > 0 || droppedRecovered > 0) {
645
+ log.info(`[timer] timer cancelled — retired its fire ` +
646
+ `(outstanding wake: ${hadOutstanding ? "cleared" : "none"}, ` +
647
+ `pending retries: ${droppedRetries}, parked recovered fires: ${droppedRecovered}): ${timerId}`);
648
+ }
649
+ }
650
+ /**
651
+ * Retire every fire matching the predicate (tag/session-scoped cancels).
652
+ * Walks the queue's own records — the outstanding wakes, the armed
653
+ * ladders, and the parked recovered fires — so it also reaches fires that
654
+ * already left the manager map (fired one-shots; delete-on-detection).
655
+ * Returns the retired timer ids.
656
+ */
657
+ retireTimersWhere(predicate) {
658
+ const ids = new Set();
659
+ for (const [, w] of this.outstanding)
660
+ if (predicate(w.timer))
661
+ ids.add(w.timer.id);
662
+ for (const r of this.retries)
663
+ if (predicate(r.timer))
664
+ ids.add(r.timer.id);
665
+ for (const f of this.deferredRecovered) {
666
+ if (f.wake && f.sessionId) {
667
+ const asTimer = {
668
+ id: f.id,
669
+ sessionId: f.sessionId,
670
+ firesAt: f.firesAt ?? 0,
671
+ reason: f.reason,
672
+ tag: f.tag,
673
+ createdAt: f.createdAt ?? 0,
674
+ wake: true,
675
+ };
676
+ if (predicate(asTimer))
677
+ ids.add(f.id);
678
+ }
679
+ }
680
+ const out = [...ids];
681
+ for (const id of out)
682
+ this.retireTimer(id);
683
+ return out;
684
+ }
685
+ /** Whether the id is retired (cancel guard for in-flight sends). */
686
+ isRetired(timerId) {
687
+ return this.retired.has(timerId);
688
+ }
689
+ /** Whether any live wake state exists for the id (outstanding wake, armed
690
+ * ladder, parked recovered fire). Read BEFORE a cancel so the caller can
691
+ * distinguish "nothing to cancel" from "the fire already left the timer
692
+ * map but its ladder was retired". */
693
+ hasWakeFireState(timerId) {
694
+ if (this.outstanding.has(timerId))
695
+ return true;
696
+ if (this.retries.some((r) => r.timer.id === timerId))
697
+ return true;
698
+ return this.deferredRecovered.some((f) => f.id === timerId);
699
+ }
700
+ getStats() {
701
+ return { ...this.stats };
702
+ }
703
+ /** Reset all state. Test helper (process-lifetime singleton). */
704
+ resetForTests() {
705
+ this.outstanding.clear();
706
+ this.retries = [];
707
+ this.exhaustedFires = [];
708
+ this.deferredRecovered = [];
709
+ this.lastRunFailed = null;
710
+ this.landedTimerIds = null;
711
+ this.retryHoldUntil = null;
712
+ this.retryHoldOverrideMs = null;
713
+ this.maxAttemptsOverride = null;
714
+ this.timeoutCounts.clear();
715
+ this.retired.clear();
716
+ // setWakeObserver wiring deliberately survives: it is production wiring,
717
+ // not per-test outcome state (the timer extension sets it once at load).
718
+ // The active-run predicate survives the same way.
719
+ this.stats = { tracked: 0, succeeded: 0, timedOut: 0, exhausted: 0, heldBusy: 0 };
720
+ }
721
+ /** Drop pending redeliveries for a timer id (success clears the chain). */
722
+ cancelPendingRetries(timerId) {
723
+ const before = this.retries.length;
724
+ this.retries = this.retries.filter((r) => r.timer.id !== timerId);
725
+ if (this.retries.length < before) {
726
+ log.info(`[timer] wake turn succeeded — cleared ${before - this.retries.length} pending retry(ies) for ${timerId}`);
727
+ }
728
+ }
729
+ /**
730
+ * Arm (or replace) the pending redelivery for a fire. Replace-by-id —
731
+ * the outcome-timeout path may already have armed a retry while the failed
732
+ * turn was still running; a genuine settle-failure must escalate that entry
733
+ * in place, never stack a second redelivery for the same fire.
734
+ * Returns true if armed, false if the bound is exhausted.
735
+ */
736
+ scheduleRetry(timer, attempt, now, cause = "failed") {
737
+ const maxAttempts = this.getMaxAttempts();
738
+ if (attempt > maxAttempts) {
739
+ this.stats.exhausted++;
740
+ this.timeoutCounts.delete(timer.id);
741
+ this.exhaustedFires.push(timer);
742
+ log.error(`[timer] wake fire permanently undelivered after ${maxAttempts} redeliveries: ` +
743
+ `${timer.id} (${timer.reason})`);
744
+ return false;
745
+ }
746
+ const backoff = WAKE_RETRY_BACKOFF_MS[Math.min(attempt - 1, WAKE_RETRY_BACKOFF_MS.length - 1)];
747
+ this.retries = this.retries.filter((r) => r.timer.id !== timer.id);
748
+ this.retries.push({ timer, attempt, nextAttemptAt: now + backoff, cause });
749
+ log.info(`[timer] wake fire undelivered (attempt ${attempt}/${maxAttempts}, ${cause}) — retry in ${backoff}ms: ${timer.id}`);
750
+ return true;
751
+ }
752
+ }
753
+ /** The process-wide queue (single pi session per process). */
754
+ export const wakeRetryQueue = new WakeRetryQueue();
755
+ /**
756
+ * Read accessor: is a wake-retry redelivery (attempt >= 1)
757
+ * currently in flight (tracked, outcome not settled)? The enforcement
758
+ * verification judge uses this to SKIP auditing the redelivered tail turn —
759
+ * a fragment the judge would otherwise treat as the whole task. Read-only;
760
+ * no redelivery behavior change.
761
+ */
762
+ export function isWakeRedeliveryInFlight() {
763
+ return wakeRetryQueue.hasOutstandingRedelivery();
764
+ }
765
+ /**
766
+ * Deliver parked recovered fires post-settle. Called from
767
+ * agent_settled handlers (timer extension primary + prompt-builder fallback —
768
+ * takeRecoveredFires() drains, so double registration cannot double-deliver;
769
+ * onAgentSettled() is idempotent, so outcome resolution is order-safe).
770
+ *
771
+ * wake:true fires start their own turn (safe here: the run has fully settled
772
+ * and pi-core released activeRun; the triggerTurn deferral in
773
+ * sendTrackedMessage keeps the macrotask boundary). If the session is busy
774
+ * at flush time anyway (an overlapping compaction, say), the busy hook
775
+ * re-parks the fire — the next settle flushes it; never silently lost.
776
+ * wake:false fires ride as advisory steers, as before. Every delivered wake
777
+ * is tracked so a failed delivery retries with backoff.
778
+ */
779
+ export function flushRecoveredFires(pi, ctx) {
780
+ const fires = wakeRetryQueue.takeRecoveredFires();
781
+ // Resolve any outstanding wake outcomes FIRST so the freshly-flushed fires
782
+ // are never mis-attributed to the previous run's failure.
783
+ wakeRetryQueue.onAgentSettled();
784
+ if (fires.length === 0)
785
+ return;
786
+ log.info(`[timer] flushing ${fires.length} recovered persisted fire(s) post-settle`);
787
+ for (const t of fires) {
788
+ // Every recovered fire carries the SAME timing marker as a live fire
789
+ // (fire-timing.ts): a fire recovered after a restart can be very late,
790
+ // and a bare reason line reads as on-time — the agent needs the drift
791
+ // to reason about what it is resuming.
792
+ const { fireTiming, elapsedSec, driftLabel } = describeFireTiming(t.createdAt, t.firesAt, Date.now());
793
+ if (driftLabel !== "0m") {
794
+ log.info(`[timer] recovered fire ${t.id} delivered late by ${driftLabel}`);
795
+ }
796
+ const text = t.wake === true
797
+ ? `${t.reason} - ${fireTiming}. ${elapsedSec}s elapsed since scheduled. Resume the task.`
798
+ : `${t.reason} (${fireTiming}) (recovered after restart)`;
799
+ try {
800
+ if (t.wake === true && terminalBreakerBlocksWake(ctx)) {
801
+ // Terminal-error breaker open: the recovered reminder is still shown,
802
+ // but rides non-waking and is not tracked (no turn to resolve).
803
+ log.info(`[timer] recovered fire ${t.id} demoted to non-waking (turn-start blocked)`);
804
+ sendTrackedMessage(pi, {
805
+ customType: "timer-fire",
806
+ content: [{ type: "text", text }],
807
+ display: true,
808
+ details: {
809
+ [BRAID_INJECTED]: true,
810
+ [BRAID_SOURCE]: "timer/persisted-fire",
811
+ timerId: t.id,
812
+ sessionId: t.sessionId,
813
+ recovered: true,
814
+ wake: true,
815
+ breakerSuppressed: true,
816
+ },
817
+ }, { delivery: "park", deliverAs: "steer" }, { type: "heartbeat", source: "timer/persisted-fire" }, { bypassFloodCap: true });
818
+ continue;
819
+ }
820
+ if (t.wake === true) {
821
+ wakeRetryQueue.trackWake({
822
+ id: t.id,
823
+ sessionId: t.sessionId,
824
+ firesAt: t.firesAt ?? Date.now(),
825
+ reason: t.reason,
826
+ tag: t.tag,
827
+ createdAt: t.createdAt ?? Date.now(),
828
+ wake: true,
829
+ });
830
+ sendTrackedMessage(pi, {
831
+ customType: "timer-fire",
832
+ content: [{ type: "text", text }],
833
+ display: true,
834
+ details: {
835
+ [BRAID_INJECTED]: true,
836
+ [BRAID_SOURCE]: "timer/persisted-fire",
837
+ timerId: t.id,
838
+ sessionId: t.sessionId,
839
+ recovered: true,
840
+ wake: true,
841
+ },
842
+ }, { triggerTurn: true }, { type: "heartbeat", source: "timer/persisted-fire" }, { bypassFloodCap: true }, {
843
+ onBusy: () => {
844
+ // Session busy at send time: re-park; the next settle flushes.
845
+ wakeRetryQueue.deferRecoveredFire(t);
846
+ },
847
+ });
848
+ }
849
+ else {
850
+ sendTrackedMessage(pi, {
851
+ customType: "timer",
852
+ content: [{ type: "text", text }],
853
+ display: true,
854
+ details: {
855
+ [BRAID_INJECTED]: true,
856
+ [BRAID_SOURCE]: "timer/persisted-fire",
857
+ timerId: t.id,
858
+ recovered: true,
859
+ wake: false,
860
+ },
861
+ }, { delivery: "park", deliverAs: "steer" }, { type: "heartbeat", source: "timer/persisted-fire" }, { bypassFloodCap: true });
862
+ }
863
+ }
864
+ catch (e) {
865
+ // Send failed: park it again — the next settle retries. Never
866
+ // silently lose a recovered fire.
867
+ log.warn(`[timer] recovered fire delivery failed, re-deferred: ${e.message}`);
868
+ wakeRetryQueue.deferRecoveredFire(t);
869
+ }
870
+ }
871
+ }
872
+ //# sourceMappingURL=wake-retry.js.map