pi-braid 0.0.0-stage → 0.40.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1011) hide show
  1. package/AGENTS.md +195 -0
  2. package/CONTRIBUTING.md +302 -0
  3. package/LICENSE +21 -0
  4. package/README.md +266 -2
  5. package/TOOLS.md +147 -0
  6. package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
  7. package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
  8. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
  9. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
  10. package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
  11. package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
  12. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
  13. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
  14. package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
  15. package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
  16. package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
  17. package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
  18. package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
  19. package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
  20. package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
  21. package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
  22. package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
  23. package/dist/extensions/cognitive/metacognition/index.js +90 -0
  24. package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
  25. package/dist/extensions/cognitive/reasoning/index.js +99 -0
  26. package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
  27. package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
  28. package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
  29. package/dist/extensions/cognitive/topic-drift/index.js +346 -0
  30. package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
  31. package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
  32. package/dist/extensions/context-management/index.d.ts +77 -0
  33. package/dist/extensions/context-management/index.js +339 -0
  34. package/dist/extensions/core/agent-environment/index.d.ts +30 -0
  35. package/dist/extensions/core/agent-environment/index.js +89 -0
  36. package/dist/extensions/core/polyfill/index.d.ts +28 -0
  37. package/dist/extensions/core/polyfill/index.js +474 -0
  38. package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
  39. package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
  40. package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
  41. package/dist/extensions/core/prompt-builder/context-section.js +101 -0
  42. package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
  43. package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
  44. package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
  45. package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
  46. package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
  47. package/dist/extensions/core/prompt-builder/identity.js +77 -0
  48. package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
  49. package/dist/extensions/core/prompt-builder/index.js +496 -0
  50. package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
  51. package/dist/extensions/core/prompt-builder/inspect.js +182 -0
  52. package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
  53. package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
  54. package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
  55. package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
  56. package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
  57. package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
  58. package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
  59. package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
  60. package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
  61. package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
  62. package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
  63. package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
  64. package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
  65. package/dist/extensions/core/prompt-builder/section.js +127 -0
  66. package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
  67. package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
  68. package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
  69. package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
  70. package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
  71. package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
  72. package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
  73. package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
  74. package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
  75. package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
  76. package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
  77. package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
  78. package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
  79. package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
  80. package/dist/extensions/core/skills-tool/index.d.ts +56 -0
  81. package/dist/extensions/core/skills-tool/index.js +200 -0
  82. package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
  83. package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
  84. package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
  85. package/dist/extensions/core/skills-tool/session-records.js +268 -0
  86. package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
  87. package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
  88. package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
  89. package/dist/extensions/enforcement/detection/malformed.js +30 -0
  90. package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
  91. package/dist/extensions/enforcement/detection/verification.js +34 -0
  92. package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
  93. package/dist/extensions/enforcement/enforcement-types.js +24 -0
  94. package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
  95. package/dist/extensions/enforcement/handler-registry.js +196 -0
  96. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
  97. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
  98. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
  99. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
  100. package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
  101. package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
  102. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
  103. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
  104. package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
  105. package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
  106. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
  107. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
  108. package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
  109. package/dist/extensions/enforcement/handlers/blocking.js +33 -0
  110. package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
  111. package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
  112. package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
  113. package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
  114. package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
  115. package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
  116. package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
  117. package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
  118. package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
  119. package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
  120. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
  121. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
  122. package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
  123. package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
  124. package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
  125. package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
  126. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
  127. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
  128. package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
  129. package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
  130. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
  131. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
  132. package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
  133. package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
  134. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
  135. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
  136. package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
  137. package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
  138. package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
  139. package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
  140. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
  141. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
  142. package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
  143. package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
  144. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
  145. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
  146. package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
  147. package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
  148. package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
  149. package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
  150. package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
  151. package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
  152. package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
  153. package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
  154. package/dist/extensions/enforcement/index.d.ts +15 -0
  155. package/dist/extensions/enforcement/index.js +22 -0
  156. package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
  157. package/dist/extensions/enforcement/judge-utils.js +83 -0
  158. package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
  159. package/dist/extensions/enforcement/nudge-manager.js +203 -0
  160. package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
  161. package/dist/extensions/enforcement/self-state-claims.js +167 -0
  162. package/dist/extensions/enforcement/session-health.d.ts +107 -0
  163. package/dist/extensions/enforcement/session-health.js +251 -0
  164. package/dist/extensions/enforcement/signals.d.ts +54 -0
  165. package/dist/extensions/enforcement/signals.js +47 -0
  166. package/dist/extensions/enforcement/similarity.d.ts +16 -0
  167. package/dist/extensions/enforcement/similarity.js +64 -0
  168. package/dist/extensions/enforcement/state.d.ts +40 -0
  169. package/dist/extensions/enforcement/state.js +74 -0
  170. package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
  171. package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
  172. package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
  173. package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
  174. package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
  175. package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
  176. package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
  177. package/dist/extensions/enforcement/substate/session-state.js +45 -0
  178. package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
  179. package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
  180. package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
  181. package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
  182. package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
  183. package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
  184. package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
  185. package/dist/extensions/enforcement/task-evidence.js +335 -0
  186. package/dist/extensions/enforcement/types.d.ts +35 -0
  187. package/dist/extensions/enforcement/types.js +5 -0
  188. package/dist/extensions/enforcement/validation.d.ts +12 -0
  189. package/dist/extensions/enforcement/validation.js +151 -0
  190. package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
  191. package/dist/extensions/enforcement/verification-judge.js +214 -0
  192. package/dist/extensions/enforcement/whisper.d.ts +46 -0
  193. package/dist/extensions/enforcement/whisper.js +104 -0
  194. package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
  195. package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
  196. package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
  197. package/dist/extensions/heartbeat/analytics/core.js +201 -0
  198. package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
  199. package/dist/extensions/heartbeat/analytics/format.js +111 -0
  200. package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
  201. package/dist/extensions/heartbeat/analytics/index.js +352 -0
  202. package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
  203. package/dist/extensions/heartbeat/analytics/shared.js +69 -0
  204. package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
  205. package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
  206. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
  207. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
  208. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
  209. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
  210. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
  211. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
  212. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
  213. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
  214. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
  215. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
  216. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
  217. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
  218. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
  219. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
  220. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
  221. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
  222. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
  223. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
  224. package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
  225. package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
  226. package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
  227. package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
  228. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
  229. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
  230. package/dist/extensions/manifest.d.ts +32 -0
  231. package/dist/extensions/manifest.js +251 -0
  232. package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
  233. package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
  234. package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
  235. package/dist/extensions/memory/context-lifecycle/index.js +977 -0
  236. package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
  237. package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
  238. package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
  239. package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
  240. package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
  241. package/dist/extensions/memory/context-lifecycle/state.js +90 -0
  242. package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
  243. package/dist/extensions/memory/context-lifecycle/types.js +273 -0
  244. package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
  245. package/dist/extensions/memory/context-manager/analysis.js +264 -0
  246. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
  247. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
  248. package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
  249. package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
  250. package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
  251. package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
  252. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
  253. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
  254. package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
  255. package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
  256. package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
  257. package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
  258. package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
  259. package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
  260. package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
  261. package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
  262. package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
  263. package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
  264. package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
  265. package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
  266. package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
  267. package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
  268. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
  269. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
  270. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
  271. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
  272. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
  273. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
  274. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
  275. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
  276. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
  277. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
  278. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
  279. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
  280. package/dist/extensions/memory/context-manager/index.d.ts +3 -0
  281. package/dist/extensions/memory/context-manager/index.js +88 -0
  282. package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
  283. package/dist/extensions/memory/context-manager/pruning.js +406 -0
  284. package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
  285. package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
  286. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
  287. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
  288. package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
  289. package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
  290. package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
  291. package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
  292. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
  293. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
  294. package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
  295. package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
  296. package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
  297. package/dist/extensions/memory/scratchpad/format.js +135 -0
  298. package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
  299. package/dist/extensions/memory/scratchpad/handlers.js +469 -0
  300. package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
  301. package/dist/extensions/memory/scratchpad/index.js +168 -0
  302. package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
  303. package/dist/extensions/memory/scratchpad/persistence.js +343 -0
  304. package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
  305. package/dist/extensions/memory/scratchpad/types.js +8 -0
  306. package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
  307. package/dist/extensions/memory/scratchpad/utils.js +236 -0
  308. package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
  309. package/dist/extensions/memory/session-recall/analyze.js +478 -0
  310. package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
  311. package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
  312. package/dist/extensions/memory/session-recall/index.d.ts +29 -0
  313. package/dist/extensions/memory/session-recall/index.js +820 -0
  314. package/dist/extensions/memory/session-recall/query.d.ts +15 -0
  315. package/dist/extensions/memory/session-recall/query.js +38 -0
  316. package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
  317. package/dist/extensions/memory/session-recall/rank.js +85 -0
  318. package/dist/extensions/memory/session-recall/search.d.ts +159 -0
  319. package/dist/extensions/memory/session-recall/search.js +682 -0
  320. package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
  321. package/dist/extensions/memory/session-recall/stats.js +67 -0
  322. package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
  323. package/dist/extensions/memory/session-recall/text-utils.js +184 -0
  324. package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
  325. package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
  326. package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
  327. package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
  328. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
  329. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
  330. package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
  331. package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
  332. package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
  333. package/dist/extensions/memory/three-memory-stores/index.js +436 -0
  334. package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
  335. package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
  336. package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
  337. package/dist/extensions/memory/three-memory-stores/types.js +2 -0
  338. package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
  339. package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
  340. package/dist/extensions/orchestrator/index.d.ts +19 -0
  341. package/dist/extensions/orchestrator/index.js +796 -0
  342. package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
  343. package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
  344. package/dist/extensions/scheduling/timer/index.d.ts +102 -0
  345. package/dist/extensions/scheduling/timer/index.js +1143 -0
  346. package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
  347. package/dist/extensions/scheduling/timer/poller.js +135 -0
  348. package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
  349. package/dist/extensions/scheduling/timer/recovery.js +445 -0
  350. package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
  351. package/dist/extensions/scheduling/timer/store-file.js +59 -0
  352. package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
  353. package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
  354. package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
  355. package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
  356. package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
  357. package/dist/extensions/self/auto-recovery/index.js +89 -0
  358. package/dist/extensions/self/error-tracking/index.d.ts +3 -0
  359. package/dist/extensions/self/error-tracking/index.js +244 -0
  360. package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
  361. package/dist/extensions/self/health-maintenance/format.js +60 -0
  362. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
  363. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
  364. package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
  365. package/dist/extensions/self/health-maintenance/helpers.js +67 -0
  366. package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
  367. package/dist/extensions/self/health-maintenance/index.js +238 -0
  368. package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
  369. package/dist/extensions/self/health-maintenance/types.js +2 -0
  370. package/dist/extensions/self/latent-activator/index.d.ts +12 -0
  371. package/dist/extensions/self/latent-activator/index.js +173 -0
  372. package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
  373. package/dist/extensions/self/latent-activator/mixes.js +20 -0
  374. package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
  375. package/dist/extensions/self/latent-activator/signals.js +228 -0
  376. package/dist/extensions/self/latent-activator/state.d.ts +43 -0
  377. package/dist/extensions/self/latent-activator/state.js +59 -0
  378. package/dist/extensions/self/latent-activator/types.d.ts +8 -0
  379. package/dist/extensions/self/latent-activator/types.js +8 -0
  380. package/dist/extensions/self/watchdog/config.d.ts +4 -0
  381. package/dist/extensions/self/watchdog/config.js +79 -0
  382. package/dist/extensions/self/watchdog/engine.d.ts +256 -0
  383. package/dist/extensions/self/watchdog/engine.js +935 -0
  384. package/dist/extensions/self/watchdog/index.d.ts +23 -0
  385. package/dist/extensions/self/watchdog/index.js +485 -0
  386. package/dist/index.d.ts +25 -0
  387. package/dist/index.js +81 -0
  388. package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
  389. package/dist/lib/ai/consolidated-claim-critic.js +191 -0
  390. package/dist/lib/ai/cost-report.d.ts +83 -0
  391. package/dist/lib/ai/cost-report.js +116 -0
  392. package/dist/lib/ai/critic-cache.d.ts +57 -0
  393. package/dist/lib/ai/critic-cache.js +100 -0
  394. package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
  395. package/dist/lib/ai/critic-fallbacks.js +75 -0
  396. package/dist/lib/ai/critic-gate.d.ts +75 -0
  397. package/dist/lib/ai/critic-gate.js +81 -0
  398. package/dist/lib/ai/critic-helpers.d.ts +26 -0
  399. package/dist/lib/ai/critic-helpers.js +131 -0
  400. package/dist/lib/ai/critic-registry.d.ts +417 -0
  401. package/dist/lib/ai/critic-registry.js +639 -0
  402. package/dist/lib/ai/critic-stats.d.ts +78 -0
  403. package/dist/lib/ai/critic-stats.js +90 -0
  404. package/dist/lib/ai/judge-budget.d.ts +138 -0
  405. package/dist/lib/ai/judge-budget.js +143 -0
  406. package/dist/lib/ai/language-hint.d.ts +21 -0
  407. package/dist/lib/ai/language-hint.js +58 -0
  408. package/dist/lib/ai/llm-call.d.ts +141 -0
  409. package/dist/lib/ai/llm-call.js +745 -0
  410. package/dist/lib/ai/model-resolver.d.ts +90 -0
  411. package/dist/lib/ai/model-resolver.js +185 -0
  412. package/dist/lib/ai/models-init.d.ts +46 -0
  413. package/dist/lib/ai/models-init.js +65 -0
  414. package/dist/lib/ai/payload-hygiene.d.ts +74 -0
  415. package/dist/lib/ai/payload-hygiene.js +240 -0
  416. package/dist/lib/ai/post-loop-classify.d.ts +128 -0
  417. package/dist/lib/ai/post-loop-classify.js +87 -0
  418. package/dist/lib/ai/text-classifier.d.ts +142 -0
  419. package/dist/lib/ai/text-classifier.js +548 -0
  420. package/dist/lib/cognitive/hints.d.ts +33 -0
  421. package/dist/lib/cognitive/hints.js +223 -0
  422. package/dist/lib/cognitive/openspec.d.ts +29 -0
  423. package/dist/lib/cognitive/openspec.js +108 -0
  424. package/dist/lib/config/braid-paths.d.ts +188 -0
  425. package/dist/lib/config/braid-paths.js +340 -0
  426. package/dist/lib/config/braid-settings.d.ts +489 -0
  427. package/dist/lib/config/braid-settings.js +938 -0
  428. package/dist/lib/config/per-tool-settings.d.ts +95 -0
  429. package/dist/lib/config/per-tool-settings.js +161 -0
  430. package/dist/lib/config/session-profiles.d.ts +68 -0
  431. package/dist/lib/config/session-profiles.js +143 -0
  432. package/dist/lib/constants/injection-details.d.ts +30 -0
  433. package/dist/lib/constants/injection-details.js +30 -0
  434. package/dist/lib/constants/session-thresholds.d.ts +42 -0
  435. package/dist/lib/constants/session-thresholds.js +54 -0
  436. package/dist/lib/constants/tool-constants.d.ts +11 -0
  437. package/dist/lib/constants/tool-constants.js +12 -0
  438. package/dist/lib/core/event-names.d.ts +23 -0
  439. package/dist/lib/core/event-names.js +26 -0
  440. package/dist/lib/core/logger.d.ts +102 -0
  441. package/dist/lib/core/logger.js +274 -0
  442. package/dist/lib/detection/compression-strategy.d.ts +38 -0
  443. package/dist/lib/detection/compression-strategy.js +147 -0
  444. package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
  445. package/dist/lib/detection/consolidated-topic-critic.js +132 -0
  446. package/dist/lib/detection/context-density.d.ts +70 -0
  447. package/dist/lib/detection/context-density.js +193 -0
  448. package/dist/lib/detection/context-thresholds.d.ts +88 -0
  449. package/dist/lib/detection/context-thresholds.js +107 -0
  450. package/dist/lib/detection/context-tiers.d.ts +80 -0
  451. package/dist/lib/detection/context-tiers.js +144 -0
  452. package/dist/lib/detection/context-usage.d.ts +75 -0
  453. package/dist/lib/detection/context-usage.js +209 -0
  454. package/dist/lib/detection/degradation-detector.d.ts +74 -0
  455. package/dist/lib/detection/degradation-detector.js +454 -0
  456. package/dist/lib/detection/test-burst.d.ts +77 -0
  457. package/dist/lib/detection/test-burst.js +126 -0
  458. package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
  459. package/dist/lib/detection/tool-loop-detector.js +302 -0
  460. package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
  461. package/dist/lib/detection/topic-drift-detector.js +252 -0
  462. package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
  463. package/dist/lib/enforcement/adherence-meter.js +420 -0
  464. package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
  465. package/dist/lib/enforcement/turn-dedup.js +195 -0
  466. package/dist/lib/errors/llm-error.d.ts +79 -0
  467. package/dist/lib/errors/llm-error.js +241 -0
  468. package/dist/lib/events/consolidation-channel.d.ts +109 -0
  469. package/dist/lib/events/consolidation-channel.js +374 -0
  470. package/dist/lib/events/consolidation-scoring.d.ts +59 -0
  471. package/dist/lib/events/consolidation-scoring.js +95 -0
  472. package/dist/lib/events/event-bus.d.ts +123 -0
  473. package/dist/lib/events/event-bus.js +108 -0
  474. package/dist/lib/events/event-types.d.ts +39 -0
  475. package/dist/lib/events/event-types.js +30 -0
  476. package/dist/lib/events/timer-bus.d.ts +21 -0
  477. package/dist/lib/events/timer-bus.js +41 -0
  478. package/dist/lib/events/timer-types.d.ts +64 -0
  479. package/dist/lib/events/timer-types.js +8 -0
  480. package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
  481. package/dist/lib/events/turn-end-coordinator.js +89 -0
  482. package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
  483. package/dist/lib/harness/failure-trace-collector.js +114 -0
  484. package/dist/lib/harness/index.d.ts +20 -0
  485. package/dist/lib/harness/index.js +21 -0
  486. package/dist/lib/harness/types.d.ts +85 -0
  487. package/dist/lib/harness/types.js +20 -0
  488. package/dist/lib/harness/weakness-miner.d.ts +29 -0
  489. package/dist/lib/harness/weakness-miner.js +165 -0
  490. package/dist/lib/memory/constants.d.ts +11 -0
  491. package/dist/lib/memory/constants.js +29 -0
  492. package/dist/lib/memory/index.d.ts +147 -0
  493. package/dist/lib/memory/index.js +564 -0
  494. package/dist/lib/memory/lifecycle.d.ts +50 -0
  495. package/dist/lib/memory/lifecycle.js +139 -0
  496. package/dist/lib/memory/past-insights.d.ts +35 -0
  497. package/dist/lib/memory/past-insights.js +189 -0
  498. package/dist/lib/memory/storage.d.ts +38 -0
  499. package/dist/lib/memory/storage.js +167 -0
  500. package/dist/lib/memory/store-lock.d.ts +23 -0
  501. package/dist/lib/memory/store-lock.js +69 -0
  502. package/dist/lib/memory/store-merge.d.ts +38 -0
  503. package/dist/lib/memory/store-merge.js +73 -0
  504. package/dist/lib/memory/types.d.ts +65 -0
  505. package/dist/lib/memory/types.js +5 -0
  506. package/dist/lib/memory/utils.d.ts +35 -0
  507. package/dist/lib/memory/utils.js +156 -0
  508. package/dist/lib/memory/write-log.d.ts +85 -0
  509. package/dist/lib/memory/write-log.js +124 -0
  510. package/dist/lib/memory/write-quality.d.ts +197 -0
  511. package/dist/lib/memory/write-quality.js +314 -0
  512. package/dist/lib/orchestrator/branch.d.ts +63 -0
  513. package/dist/lib/orchestrator/branch.js +192 -0
  514. package/dist/lib/orchestrator/index.d.ts +14 -0
  515. package/dist/lib/orchestrator/index.js +11 -0
  516. package/dist/lib/orchestrator/locks.d.ts +46 -0
  517. package/dist/lib/orchestrator/locks.js +122 -0
  518. package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
  519. package/dist/lib/orchestrator/slop-scanner.js +207 -0
  520. package/dist/lib/orchestrator/workers.d.ts +453 -0
  521. package/dist/lib/orchestrator/workers.js +1001 -0
  522. package/dist/lib/public.d.ts +18 -0
  523. package/dist/lib/public.js +23 -0
  524. package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
  525. package/dist/lib/reasoning/advice-tracker.js +177 -0
  526. package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
  527. package/dist/lib/reasoning/belief-policy-engine.js +268 -0
  528. package/dist/lib/reasoning/belief-types.d.ts +32 -0
  529. package/dist/lib/reasoning/belief-types.js +8 -0
  530. package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
  531. package/dist/lib/reasoning/classifier-offline.js +75 -0
  532. package/dist/lib/reasoning/dreamer.d.ts +37 -0
  533. package/dist/lib/reasoning/dreamer.js +169 -0
  534. package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
  535. package/dist/lib/reasoning/nudge-analytics.js +62 -0
  536. package/dist/lib/reasoning/policy-rules.d.ts +18 -0
  537. package/dist/lib/reasoning/policy-rules.js +153 -0
  538. package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
  539. package/dist/lib/reasoning/reasoning-metrics.js +174 -0
  540. package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
  541. package/dist/lib/reasoning/reasoning-summary.js +122 -0
  542. package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
  543. package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
  544. package/dist/lib/state/async-storage.d.ts +52 -0
  545. package/dist/lib/state/async-storage.js +171 -0
  546. package/dist/lib/state/extension-state.d.ts +184 -0
  547. package/dist/lib/state/extension-state.js +373 -0
  548. package/dist/lib/state/global-state.d.ts +358 -0
  549. package/dist/lib/state/global-state.js +741 -0
  550. package/dist/lib/state/metacognitive-state.d.ts +21 -0
  551. package/dist/lib/state/metacognitive-state.js +50 -0
  552. package/dist/lib/state/session-manager.d.ts +32 -0
  553. package/dist/lib/state/session-manager.js +11 -0
  554. package/dist/lib/state/session-start-queue.d.ts +42 -0
  555. package/dist/lib/state/session-start-queue.js +105 -0
  556. package/dist/lib/state/state-checkpoint.d.ts +72 -0
  557. package/dist/lib/state/state-checkpoint.js +252 -0
  558. package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
  559. package/dist/lib/state/telegram-poller-liveness.js +67 -0
  560. package/dist/lib/state/tool-provenance.d.ts +22 -0
  561. package/dist/lib/state/tool-provenance.js +25 -0
  562. package/dist/lib/state/workspace-snapshot.d.ts +111 -0
  563. package/dist/lib/state/workspace-snapshot.js +372 -0
  564. package/dist/lib/store/belief-store.d.ts +112 -0
  565. package/dist/lib/store/belief-store.js +252 -0
  566. package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
  567. package/dist/lib/store/bidirectional-verifier.js +242 -0
  568. package/dist/lib/store/claim-tracker.d.ts +66 -0
  569. package/dist/lib/store/claim-tracker.js +276 -0
  570. package/dist/lib/store/conflict-qa.d.ts +96 -0
  571. package/dist/lib/store/conflict-qa.js +283 -0
  572. package/dist/lib/store/evidence-pool.d.ts +185 -0
  573. package/dist/lib/store/evidence-pool.js +598 -0
  574. package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
  575. package/dist/lib/telemetry/context-heartbeat.js +449 -0
  576. package/dist/lib/telemetry/drift-signals.d.ts +46 -0
  577. package/dist/lib/telemetry/drift-signals.js +75 -0
  578. package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
  579. package/dist/lib/telemetry/rss-telemetry.js +53 -0
  580. package/dist/lib/types/episode-types.d.ts +31 -0
  581. package/dist/lib/types/episode-types.js +9 -0
  582. package/dist/lib/types/standard-result.d.ts +32 -0
  583. package/dist/lib/types/standard-result.js +22 -0
  584. package/dist/lib/utils/async-fs.d.ts +17 -0
  585. package/dist/lib/utils/async-fs.js +22 -0
  586. package/dist/lib/utils/bounded.d.ts +38 -0
  587. package/dist/lib/utils/bounded.js +59 -0
  588. package/dist/lib/utils/dedup.d.ts +40 -0
  589. package/dist/lib/utils/dedup.js +43 -0
  590. package/dist/lib/utils/error-guard.d.ts +15 -0
  591. package/dist/lib/utils/error-guard.js +22 -0
  592. package/dist/lib/utils/extension-utils.d.ts +36 -0
  593. package/dist/lib/utils/extension-utils.js +65 -0
  594. package/dist/lib/utils/extract-json.d.ts +23 -0
  595. package/dist/lib/utils/extract-json.js +90 -0
  596. package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
  597. package/dist/lib/utils/file-mutation-queue.js +150 -0
  598. package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
  599. package/dist/lib/utils/filter-safe-to-remove.js +256 -0
  600. package/dist/lib/utils/format-tool-result.d.ts +47 -0
  601. package/dist/lib/utils/format-tool-result.js +88 -0
  602. package/dist/lib/utils/id.d.ts +44 -0
  603. package/dist/lib/utils/id.js +59 -0
  604. package/dist/lib/utils/injection-tracker.d.ts +317 -0
  605. package/dist/lib/utils/injection-tracker.js +840 -0
  606. package/dist/lib/utils/local-time.d.ts +57 -0
  607. package/dist/lib/utils/local-time.js +181 -0
  608. package/dist/lib/utils/memory-fence.d.ts +55 -0
  609. package/dist/lib/utils/memory-fence.js +66 -0
  610. package/dist/lib/utils/sop-extractor.d.ts +75 -0
  611. package/dist/lib/utils/sop-extractor.js +259 -0
  612. package/dist/lib/utils/sop-suggestion.d.ts +34 -0
  613. package/dist/lib/utils/sop-suggestion.js +336 -0
  614. package/dist/lib/utils/wake-gate.d.ts +151 -0
  615. package/dist/lib/utils/wake-gate.js +265 -0
  616. package/dist/lib/utils/whisper-format.d.ts +95 -0
  617. package/dist/lib/utils/whisper-format.js +115 -0
  618. package/dist/lib/verification/coordination-checker.d.ts +72 -0
  619. package/dist/lib/verification/coordination-checker.js +126 -0
  620. package/dist/loader/api.d.ts +19 -0
  621. package/dist/loader/api.js +114 -0
  622. package/dist/loader/loader.d.ts +85 -0
  623. package/dist/loader/loader.js +534 -0
  624. package/docs/BEGINNERS.md +166 -0
  625. package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
  626. package/docs/CONTEXT-MAP.md +220 -0
  627. package/docs/CONTEXT-POLICY.md +86 -0
  628. package/docs/HISTORY.md +110 -0
  629. package/docs/LOCAL_DEV.md +246 -0
  630. package/docs/ROADMAP.md +107 -0
  631. package/docs/SETUP.md +502 -0
  632. package/package.json +97 -4
  633. package/skills/agent-testing/SKILL.md +214 -0
  634. package/skills/braid-reference/SKILL.md +88 -0
  635. package/skills/code-refactoring/SKILL.md +211 -0
  636. package/skills/code-search/SKILL.md +14 -0
  637. package/skills/documentation/SKILL.md +89 -0
  638. package/skills/dox/AGENTS.md.template +83 -0
  639. package/skills/dox/SKILL.md +86 -0
  640. package/skills/healthcheck/SKILL.md +65 -0
  641. package/skills/herdr-topology/SKILL.md +269 -0
  642. package/skills/meta-cognition/SKILL.md +24 -0
  643. package/skills/meta-improvement/SKILL.md +180 -0
  644. package/skills/misdirection-audit/SKILL.md +66 -0
  645. package/skills/pi-reference/SKILL.md +104 -0
  646. package/skills/placement-discipline/SKILL.md +69 -0
  647. package/skills/probe-evaluation/SKILL.md +85 -0
  648. package/skills/release-pipeline/SKILL.md +191 -0
  649. package/skills/research/SKILL.md +166 -0
  650. package/skills/skill-usage/SKILL.md +81 -0
  651. package/skills/software-engineer/SKILL.md +83 -0
  652. package/skills/subagent-orchestration/SKILL.md +454 -0
  653. package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
  654. package/skills/subagent-verification/SKILL.md +127 -0
  655. package/skills/tone-quality/SKILL.md +176 -0
  656. package/skills/voice-replies/SKILL.md +125 -0
  657. package/src/AGENTS.md +111 -0
  658. package/src/extensions/cognitive/AGENTS.md +29 -0
  659. package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
  660. package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
  661. package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
  662. package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
  663. package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
  664. package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
  665. package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
  666. package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
  667. package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
  668. package/src/extensions/cognitive/metacognition/index.ts +109 -0
  669. package/src/extensions/cognitive/reasoning/index.ts +168 -0
  670. package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
  671. package/src/extensions/cognitive/topic-drift/index.ts +429 -0
  672. package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
  673. package/src/extensions/context-management/README.md +102 -0
  674. package/src/extensions/context-management/index.ts +383 -0
  675. package/src/extensions/core/AGENTS.md +34 -0
  676. package/src/extensions/core/agent-environment/index.ts +135 -0
  677. package/src/extensions/core/polyfill/index.ts +617 -0
  678. package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
  679. package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
  680. package/src/extensions/core/prompt-builder/context-section.ts +120 -0
  681. package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
  682. package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
  683. package/src/extensions/core/prompt-builder/identity.ts +98 -0
  684. package/src/extensions/core/prompt-builder/index.ts +602 -0
  685. package/src/extensions/core/prompt-builder/inspect.ts +227 -0
  686. package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
  687. package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
  688. package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
  689. package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
  690. package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
  691. package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
  692. package/src/extensions/core/prompt-builder/section.ts +150 -0
  693. package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
  694. package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
  695. package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
  696. package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
  697. package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
  698. package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
  699. package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
  700. package/src/extensions/core/skills-tool/index.ts +240 -0
  701. package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
  702. package/src/extensions/core/skills-tool/session-records.ts +328 -0
  703. package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
  704. package/src/extensions/enforcement/AGENTS.md +69 -0
  705. package/src/extensions/enforcement/detection/malformed.ts +42 -0
  706. package/src/extensions/enforcement/detection/verification.ts +52 -0
  707. package/src/extensions/enforcement/enforcement-types.ts +42 -0
  708. package/src/extensions/enforcement/handler-registry.ts +225 -0
  709. package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
  710. package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
  711. package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
  712. package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
  713. package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
  714. package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
  715. package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
  716. package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
  717. package/src/extensions/enforcement/handlers/blocking.ts +50 -0
  718. package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
  719. package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
  720. package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
  721. package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
  722. package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
  723. package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
  724. package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
  725. package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
  726. package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
  727. package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
  728. package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
  729. package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
  730. package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
  731. package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
  732. package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
  733. package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
  734. package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
  735. package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
  736. package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
  737. package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
  738. package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
  739. package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
  740. package/src/extensions/enforcement/index.ts +28 -0
  741. package/src/extensions/enforcement/judge-utils.ts +106 -0
  742. package/src/extensions/enforcement/nudge-manager.ts +298 -0
  743. package/src/extensions/enforcement/self-state-claims.ts +204 -0
  744. package/src/extensions/enforcement/session-health.ts +317 -0
  745. package/src/extensions/enforcement/signals.ts +88 -0
  746. package/src/extensions/enforcement/similarity.ts +76 -0
  747. package/src/extensions/enforcement/state.ts +115 -0
  748. package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
  749. package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
  750. package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
  751. package/src/extensions/enforcement/substate/session-state.ts +79 -0
  752. package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
  753. package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
  754. package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
  755. package/src/extensions/enforcement/task-evidence.ts +436 -0
  756. package/src/extensions/enforcement/types.ts +38 -0
  757. package/src/extensions/enforcement/validation.ts +194 -0
  758. package/src/extensions/enforcement/verification-judge.ts +317 -0
  759. package/src/extensions/enforcement/whisper.ts +120 -0
  760. package/src/extensions/heartbeat/AGENTS.md +47 -0
  761. package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
  762. package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
  763. package/src/extensions/heartbeat/analytics/core.ts +222 -0
  764. package/src/extensions/heartbeat/analytics/format.ts +144 -0
  765. package/src/extensions/heartbeat/analytics/index.ts +373 -0
  766. package/src/extensions/heartbeat/analytics/shared.ts +149 -0
  767. package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
  768. package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
  769. package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
  770. package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
  771. package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
  772. package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
  773. package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
  774. package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
  775. package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
  776. package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
  777. package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
  778. package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
  779. package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
  780. package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
  781. package/src/extensions/manifest.ts +293 -0
  782. package/src/extensions/memory/AGENTS.md +93 -0
  783. package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
  784. package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
  785. package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
  786. package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
  787. package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
  788. package/src/extensions/memory/context-lifecycle/state.ts +165 -0
  789. package/src/extensions/memory/context-lifecycle/types.ts +441 -0
  790. package/src/extensions/memory/context-manager/analysis.ts +344 -0
  791. package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
  792. package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
  793. package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
  794. package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
  795. package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
  796. package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
  797. package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
  798. package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
  799. package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
  800. package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
  801. package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
  802. package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
  803. package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
  804. package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
  805. package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
  806. package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
  807. package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
  808. package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
  809. package/src/extensions/memory/context-manager/index.ts +111 -0
  810. package/src/extensions/memory/context-manager/pruning.ts +479 -0
  811. package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
  812. package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
  813. package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
  814. package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
  815. package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
  816. package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
  817. package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
  818. package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
  819. package/src/extensions/memory/scratchpad/format.ts +161 -0
  820. package/src/extensions/memory/scratchpad/handlers.ts +601 -0
  821. package/src/extensions/memory/scratchpad/index.ts +230 -0
  822. package/src/extensions/memory/scratchpad/persistence.ts +374 -0
  823. package/src/extensions/memory/scratchpad/types.ts +149 -0
  824. package/src/extensions/memory/scratchpad/utils.ts +268 -0
  825. package/src/extensions/memory/session-recall/AGENTS.md +104 -0
  826. package/src/extensions/memory/session-recall/analyze.ts +605 -0
  827. package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
  828. package/src/extensions/memory/session-recall/index.ts +956 -0
  829. package/src/extensions/memory/session-recall/query.ts +44 -0
  830. package/src/extensions/memory/session-recall/rank.ts +121 -0
  831. package/src/extensions/memory/session-recall/search.ts +801 -0
  832. package/src/extensions/memory/session-recall/stats.ts +93 -0
  833. package/src/extensions/memory/session-recall/text-utils.ts +209 -0
  834. package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
  835. package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
  836. package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
  837. package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
  838. package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
  839. package/src/extensions/memory/three-memory-stores/index.ts +549 -0
  840. package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
  841. package/src/extensions/memory/three-memory-stores/types.ts +74 -0
  842. package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
  843. package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
  844. package/src/extensions/orchestrator/index.ts +1141 -0
  845. package/src/extensions/scheduling/AGENTS.md +26 -0
  846. package/src/extensions/scheduling/timer/AGENTS.md +259 -0
  847. package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
  848. package/src/extensions/scheduling/timer/index.ts +1331 -0
  849. package/src/extensions/scheduling/timer/poller.ts +138 -0
  850. package/src/extensions/scheduling/timer/recovery.ts +462 -0
  851. package/src/extensions/scheduling/timer/store-file.ts +59 -0
  852. package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
  853. package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
  854. package/src/extensions/self/AGENTS.md +30 -0
  855. package/src/extensions/self/auto-recovery/index.ts +112 -0
  856. package/src/extensions/self/error-tracking/AGENTS.md +38 -0
  857. package/src/extensions/self/error-tracking/index.ts +299 -0
  858. package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
  859. package/src/extensions/self/health-maintenance/format.ts +87 -0
  860. package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
  861. package/src/extensions/self/health-maintenance/helpers.ts +78 -0
  862. package/src/extensions/self/health-maintenance/index.ts +308 -0
  863. package/src/extensions/self/health-maintenance/types.ts +14 -0
  864. package/src/extensions/self/latent-activator/AGENTS.md +64 -0
  865. package/src/extensions/self/latent-activator/index.ts +206 -0
  866. package/src/extensions/self/latent-activator/mixes.ts +22 -0
  867. package/src/extensions/self/latent-activator/signals.ts +237 -0
  868. package/src/extensions/self/latent-activator/state.ts +79 -0
  869. package/src/extensions/self/latent-activator/types.ts +47 -0
  870. package/src/extensions/self/watchdog/AGENTS.md +27 -0
  871. package/src/extensions/self/watchdog/config.ts +73 -0
  872. package/src/extensions/self/watchdog/engine.ts +1246 -0
  873. package/src/extensions/self/watchdog/index.ts +577 -0
  874. package/src/index.ts +93 -0
  875. package/src/lib/AGENTS.md +39 -0
  876. package/src/lib/ai/AGENTS.md +37 -0
  877. package/src/lib/ai/consolidated-claim-critic.ts +287 -0
  878. package/src/lib/ai/cost-report.ts +206 -0
  879. package/src/lib/ai/critic-cache.ts +122 -0
  880. package/src/lib/ai/critic-fallbacks.ts +74 -0
  881. package/src/lib/ai/critic-gate.ts +135 -0
  882. package/src/lib/ai/critic-helpers.ts +135 -0
  883. package/src/lib/ai/critic-registry.ts +754 -0
  884. package/src/lib/ai/critic-stats.ts +158 -0
  885. package/src/lib/ai/judge-budget.ts +241 -0
  886. package/src/lib/ai/language-hint.ts +70 -0
  887. package/src/lib/ai/llm-call.ts +975 -0
  888. package/src/lib/ai/model-resolver.ts +224 -0
  889. package/src/lib/ai/models-init.ts +68 -0
  890. package/src/lib/ai/payload-hygiene.ts +265 -0
  891. package/src/lib/ai/post-loop-classify.ts +185 -0
  892. package/src/lib/ai/text-classifier.ts +746 -0
  893. package/src/lib/cognitive/AGENTS.md +40 -0
  894. package/src/lib/cognitive/hints.ts +254 -0
  895. package/src/lib/cognitive/openspec.ts +124 -0
  896. package/src/lib/config/AGENTS.md +17 -0
  897. package/src/lib/config/braid-paths.ts +401 -0
  898. package/src/lib/config/braid-settings.ts +1442 -0
  899. package/src/lib/config/per-tool-settings.ts +197 -0
  900. package/src/lib/config/session-profiles.ts +165 -0
  901. package/src/lib/constants/AGENTS.md +15 -0
  902. package/src/lib/constants/injection-details.ts +32 -0
  903. package/src/lib/constants/session-thresholds.ts +64 -0
  904. package/src/lib/constants/tool-constants.ts +16 -0
  905. package/src/lib/core/AGENTS.md +23 -0
  906. package/src/lib/core/event-names.ts +31 -0
  907. package/src/lib/core/logger.ts +334 -0
  908. package/src/lib/detection/AGENTS.md +21 -0
  909. package/src/lib/detection/compression-strategy.ts +183 -0
  910. package/src/lib/detection/consolidated-topic-critic.ts +188 -0
  911. package/src/lib/detection/context-density.ts +237 -0
  912. package/src/lib/detection/context-thresholds.ts +132 -0
  913. package/src/lib/detection/context-tiers.ts +201 -0
  914. package/src/lib/detection/context-usage.ts +270 -0
  915. package/src/lib/detection/degradation-detector.ts +583 -0
  916. package/src/lib/detection/test-burst.ts +170 -0
  917. package/src/lib/detection/tool-loop-detector.ts +364 -0
  918. package/src/lib/detection/topic-drift-detector.ts +323 -0
  919. package/src/lib/enforcement/AGENTS.md +20 -0
  920. package/src/lib/enforcement/adherence-meter.ts +578 -0
  921. package/src/lib/enforcement/turn-dedup.ts +246 -0
  922. package/src/lib/errors/llm-error.ts +288 -0
  923. package/src/lib/events/AGENTS.md +23 -0
  924. package/src/lib/events/consolidation-channel.ts +493 -0
  925. package/src/lib/events/consolidation-scoring.ts +112 -0
  926. package/src/lib/events/event-bus.ts +213 -0
  927. package/src/lib/events/event-types.ts +53 -0
  928. package/src/lib/events/timer-bus.ts +53 -0
  929. package/src/lib/events/timer-types.ts +64 -0
  930. package/src/lib/events/turn-end-coordinator.ts +108 -0
  931. package/src/lib/harness/AGENTS.md +20 -0
  932. package/src/lib/harness/failure-trace-collector.ts +157 -0
  933. package/src/lib/harness/index.ts +41 -0
  934. package/src/lib/harness/types.ts +122 -0
  935. package/src/lib/harness/weakness-miner.ts +209 -0
  936. package/src/lib/memory/AGENTS.md +36 -0
  937. package/src/lib/memory/constants.ts +34 -0
  938. package/src/lib/memory/index.ts +705 -0
  939. package/src/lib/memory/lifecycle.ts +159 -0
  940. package/src/lib/memory/past-insights.ts +221 -0
  941. package/src/lib/memory/storage.ts +187 -0
  942. package/src/lib/memory/store-lock.ts +70 -0
  943. package/src/lib/memory/store-merge.ts +100 -0
  944. package/src/lib/memory/types.ts +82 -0
  945. package/src/lib/memory/utils.ts +173 -0
  946. package/src/lib/memory/write-log.ts +174 -0
  947. package/src/lib/memory/write-quality.ts +383 -0
  948. package/src/lib/orchestrator/branch.ts +193 -0
  949. package/src/lib/orchestrator/index.ts +78 -0
  950. package/src/lib/orchestrator/locks.ts +160 -0
  951. package/src/lib/orchestrator/slop-scanner.ts +258 -0
  952. package/src/lib/orchestrator/workers.ts +1382 -0
  953. package/src/lib/public.ts +43 -0
  954. package/src/lib/reasoning/AGENTS.md +25 -0
  955. package/src/lib/reasoning/advice-tracker.ts +244 -0
  956. package/src/lib/reasoning/belief-policy-engine.ts +342 -0
  957. package/src/lib/reasoning/belief-types.ts +45 -0
  958. package/src/lib/reasoning/classifier-offline.ts +111 -0
  959. package/src/lib/reasoning/dreamer.ts +215 -0
  960. package/src/lib/reasoning/nudge-analytics.ts +85 -0
  961. package/src/lib/reasoning/policy-rules.ts +172 -0
  962. package/src/lib/reasoning/reasoning-metrics.ts +202 -0
  963. package/src/lib/reasoning/reasoning-summary.ts +154 -0
  964. package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
  965. package/src/lib/state/AGENTS.md +192 -0
  966. package/src/lib/state/async-storage.ts +189 -0
  967. package/src/lib/state/extension-state.ts +419 -0
  968. package/src/lib/state/global-state.ts +1046 -0
  969. package/src/lib/state/metacognitive-state.ts +65 -0
  970. package/src/lib/state/session-manager.ts +43 -0
  971. package/src/lib/state/session-start-queue.ts +135 -0
  972. package/src/lib/state/state-checkpoint.ts +352 -0
  973. package/src/lib/state/telegram-poller-liveness.ts +75 -0
  974. package/src/lib/state/tool-provenance.ts +26 -0
  975. package/src/lib/state/workspace-snapshot.ts +466 -0
  976. package/src/lib/store/AGENTS.md +24 -0
  977. package/src/lib/store/belief-store.ts +325 -0
  978. package/src/lib/store/bidirectional-verifier.ts +316 -0
  979. package/src/lib/store/claim-tracker.ts +382 -0
  980. package/src/lib/store/conflict-qa.ts +385 -0
  981. package/src/lib/store/evidence-pool.ts +779 -0
  982. package/src/lib/telemetry/AGENTS.md +28 -0
  983. package/src/lib/telemetry/context-heartbeat.ts +555 -0
  984. package/src/lib/telemetry/drift-signals.ts +105 -0
  985. package/src/lib/telemetry/rss-telemetry.ts +57 -0
  986. package/src/lib/types/AGENTS.md +21 -0
  987. package/src/lib/types/episode-types.ts +31 -0
  988. package/src/lib/types/standard-result.ts +40 -0
  989. package/src/lib/utils/AGENTS.md +30 -0
  990. package/src/lib/utils/async-fs.ts +23 -0
  991. package/src/lib/utils/bounded.ts +58 -0
  992. package/src/lib/utils/dedup.ts +44 -0
  993. package/src/lib/utils/error-guard.ts +27 -0
  994. package/src/lib/utils/extension-utils.ts +72 -0
  995. package/src/lib/utils/extract-json.ts +89 -0
  996. package/src/lib/utils/file-mutation-queue.ts +172 -0
  997. package/src/lib/utils/filter-safe-to-remove.ts +301 -0
  998. package/src/lib/utils/format-tool-result.ts +109 -0
  999. package/src/lib/utils/id.ts +64 -0
  1000. package/src/lib/utils/injection-tracker.ts +1014 -0
  1001. package/src/lib/utils/local-time.ts +196 -0
  1002. package/src/lib/utils/memory-fence.ts +70 -0
  1003. package/src/lib/utils/sop-extractor.ts +329 -0
  1004. package/src/lib/utils/sop-suggestion.ts +426 -0
  1005. package/src/lib/utils/wake-gate.ts +318 -0
  1006. package/src/lib/utils/whisper-format.ts +120 -0
  1007. package/src/lib/verification/coordination-checker.ts +183 -0
  1008. package/src/loader/AGENTS.md +32 -0
  1009. package/src/loader/api.ts +138 -0
  1010. package/src/loader/loader.ts +600 -0
  1011. package/src/types/extension-context.d.ts +85 -0
@@ -0,0 +1,975 @@
1
+ /**
2
+ * [stakes-invariant]: this module and the rest of lib/ai/ must never
3
+ * include downstream-stakes signals in the LLM call context. The judge
4
+ * (whether human, LLM-as-judge, or programmatic) evaluates pure
5
+ * correctness; the agent being judged sees no signal about what the
6
+ * judgment is for, and the prompt carries no stakes-awareness block.
7
+ * The test-arxiv-citations.mjs and test-prompt-builder-directive.mjs
8
+ * suites verify the agent-side invariant.
9
+ *
10
+ * Dispatches auxiliary LLM calls through the session's model registry
11
+ * (ctx.modelRegistry.streamSimple, read from the published extension context)
12
+ * with a two-tier retry strategy:
13
+ *
14
+ * Tier 1 - Provider SDK: Handles fast transient blips (quick network drops)
15
+ * via the registry call's maxRetries (default: 3 SDK-level retries).
16
+ * Tier 2 - This module: Handles sustained rate limits with longer backoff
17
+ * (5s -> 15s -> 30s -> 60s) so the provider gets real cooldown time.
18
+ *
19
+ * When no context has been published, the call degrades to pi-ai's compat
20
+ * transport (credential only, no session id or configured headers) so an
21
+ * auxiliary role keeps working; one warning per process announces it. See
22
+ * completeAuxCall.
23
+ *
24
+ * A rate-limit circuit breaker skips calls for 60s after a 429 to avoid
25
+ * cascading failures during provider congestion.
26
+ *
27
+ * Usage:
28
+ * callLlm(model, apiKey, systemPrompt, userPrompt, options)
29
+ * Returns { text } on success or { error } on failure (discriminated union).
30
+ * const text = result.text;
31
+ */
32
+
33
+ import type {
34
+ Api,
35
+ AssistantMessage,
36
+ Context,
37
+ Model,
38
+ ModelThinkingLevel,
39
+ ModelsSimpleStreamOptions,
40
+ } from "@earendil-works/pi-ai";
41
+ // Degraded transport only: see completeAuxCall below. Compat resolves the
42
+ // credential from the model and the apiKey argument and nothing else, which is
43
+ // exactly the case it is reserved for (no published context, so no registry to
44
+ // resolve headers or the session id through).
45
+ import { completeSimple } from "@earendil-works/pi-ai/compat";
46
+ // Auxiliary calls dispatch through the session's model registry (see the
47
+ // completion-dispatch block below): pi-ai's compat entrypoint resolves an api
48
+ // key from the model and nothing else, so registry-resolved headers, configured
49
+ // provider headers, and the session id never reach a compat request. Compat is
50
+ // kept only as the degraded fallback for the no-context case. The registry is
51
+ // also where braid's own providers are registered (pi.registerProvider), so it
52
+ // is the one handle that reaches both built-in and custom providers.
53
+ import { createLogger } from "../core/logger.js";
54
+ import { isRateLimitText } from "../errors/llm-error.js";
55
+ import { isContextWindowErrorText } from "../errors/llm-error.js";
56
+ import { sanitizeLlmErrorForLog, sanitizeLlmRequestText } from "./payload-hygiene.js";
57
+ import {
58
+ getContextEmergencyOffloadRunner,
59
+ getExtensionCtxProvider,
60
+ hasWarnedAuxDegradedTransport,
61
+ markAuxDegradedTransportWarned,
62
+ } from "../state/global-state.js";
63
+
64
+ const log = createLogger("llm-call");
65
+
66
+ // ── Completion dispatch ──────────────────────────────────────────────────────
67
+ //
68
+ // An auxiliary request is dispatched exactly like a session request: through
69
+ // ctx.modelRegistry, so pi-core resolves the credential, the configured and
70
+ // provider-declared headers, and the transport before the provider object
71
+ // sees it. `streamSimple` rather than `complete` because the options built
72
+ // below are provider-neutral (`reasoning` among them) and only the simple
73
+ // path maps them per API (thinking-level clamping, max-token clamping).
74
+ //
75
+ // lib/ai has no ctx of its own, so the registry is read from the extension
76
+ // context the enforcement session-start handler publishes (global-state.ts),
77
+ // per attempt: a retry can outlive the session that started it.
78
+
79
+ /** The slice of the published extension context this module reads. */
80
+ interface AuxCallContext {
81
+ modelRegistry?: {
82
+ streamSimple(
83
+ model: Model<Api>,
84
+ context: Context,
85
+ options: ModelsSimpleStreamOptions,
86
+ ): { result(): Promise<AssistantMessage> };
87
+ };
88
+ sessionManager?: { getSessionId?: () => string };
89
+ }
90
+
91
+ /** Read the published extension context, or null when none was published. */
92
+ function readAuxContext(): AuxCallContext | null {
93
+ const provider = getExtensionCtxProvider();
94
+ if (!provider) return null;
95
+ try {
96
+ return (provider() as AuxCallContext | null) ?? null;
97
+ } catch {
98
+ return null;
99
+ }
100
+ }
101
+
102
+ /**
103
+ * Session id for the request (per-conversation routing and prompt-cache
104
+ * affinity). Undefined when no session manager is readable, never a sentinel:
105
+ * an invented id would route the request to a conversation that does not
106
+ * exist. Which header the id becomes is the provider's own business.
107
+ */
108
+ function resolveSessionId(): string | undefined {
109
+ try {
110
+ const id = readAuxContext()?.sessionManager?.getSessionId?.();
111
+ return typeof id === "string" && id.length > 0 ? id : undefined;
112
+ } catch {
113
+ return undefined;
114
+ }
115
+ }
116
+
117
+ /**
118
+ * Production completion. Primary path: the session's model registry, the same
119
+ * path the session's own requests take, so pi-core resolves the credential,
120
+ * the configured and provider-declared headers, the session id (which a
121
+ * provider may turn into a routing header), and the transport.
122
+ *
123
+ * Degraded path: pi-ai's compat entrypoint, used only when nothing has
124
+ * published a context. Compat resolves the credential from the model and the
125
+ * apiKey argument and carries nothing else: no session id, no configured
126
+ * provider headers. Auxiliary calls must still complete when the publisher
127
+ * never ran (the publisher is the enforcement extension's session-start
128
+ * handler, and enforcement is disableable), but the degradation is announced
129
+ * once per process by warnDegradedTransportOnce so it is never mistaken for
130
+ * the full path.
131
+ */
132
+ async function completeAuxCall(
133
+ model: Model<Api>,
134
+ context: Context,
135
+ options: ModelsSimpleStreamOptions,
136
+ ): Promise<AssistantMessage> {
137
+ const registry = readAuxContext()?.modelRegistry;
138
+ if (registry) {
139
+ return registry.streamSimple(model, context, options).result();
140
+ }
141
+ warnDegradedTransportOnce();
142
+ return completeSimple(model, context, options as unknown as Parameters<typeof completeSimple>[2]);
143
+ }
144
+
145
+ /**
146
+ * Announce the degraded transport exactly once per process, naming the
147
+ * publisher that did not run and what the fallback does not carry. Silence
148
+ * after the first line keeps a degraded session from flooding the log; the
149
+ * latch is process-global (global-state.ts) so it survives session boundaries
150
+ * and module re-evaluation on /reload.
151
+ */
152
+ function warnDegradedTransportOnce(): void {
153
+ if (hasWarnedAuxDegradedTransport()) return;
154
+ markAuxDegradedTransportWarned();
155
+ log.warn(
156
+ "No session context published for auxiliary LLM calls (the enforcement " +
157
+ "extension publishes it at session_start; enforcement is disableable). " +
158
+ "Falling back to pi-ai's compat transport: the request carries the " +
159
+ "model's credential only, without the session id or configured provider " +
160
+ "headers. Auxiliary calls are degraded until the publisher runs.",
161
+ );
162
+ }
163
+
164
+ // Test-only injection point: production dispatches through the registry
165
+ // (above). Behavioral tests
166
+ // (timeout, signal abort, retry behavior) need to stub that call without a
167
+ // real provider, and the injection is opt-in: production behavior is
168
+ // identical unless `__setCompleteSimpleForTest` is called. The setter is
169
+ // intentionally a module-private mutation (not a parameter on callLlm)
170
+ // because adding test-only parameters to the public API would pollute the
171
+ // surface and invite callers to "configure" test hooks by accident.
172
+ //
173
+ // Usage in tests:
174
+ // import { __setCompleteSimpleForTest, __resetCompleteSimpleForTest } from "...";
175
+ // __setCompleteSimpleForTest(async (model, ctx, opts) => {
176
+ // // hang until aborted, then return error
177
+ // return new Promise((resolve) => {
178
+ // opts.signal.addEventListener("abort", () => resolve({ ... }));
179
+ // });
180
+ // });
181
+ // // ... run test ...
182
+ // __resetCompleteSimpleForTest();
183
+ //
184
+ // The setter only takes effect for the current process. There is no
185
+ // global state mutation across test files unless they import the
186
+ // module in the same process - which is fine for the test runner we
187
+ // use (one process per .mjs file via spawnSync).
188
+
189
+ /** One provider-neutral completion call. */
190
+ type CompletionFn = (
191
+ model: Model<Api>,
192
+ context: Context,
193
+ options: ModelsSimpleStreamOptions,
194
+ ) => Promise<AssistantMessage>;
195
+
196
+ // The override slot is for test injection only; production uses the registry.
197
+ let _completionOverride: CompletionFn | null = null;
198
+
199
+ function _resolveCompletion(): CompletionFn {
200
+ return _completionOverride ?? completeAuxCall;
201
+ }
202
+
203
+ /**
204
+ * @internal Test-only: override the completion call for behavioral testing.
205
+ * Pass `null` to reset to the production implementation. NOT for use
206
+ * in production code paths.
207
+ */
208
+ export function __setCompleteSimpleForTest(fn: CompletionFn | null): void {
209
+ _completionOverride = fn ?? null;
210
+ }
211
+
212
+ /** Track the cooldown expiration deadline. */
213
+ let rateLimitCooldownUntil = 0;
214
+
215
+ /**
216
+ * @internal Test-only: clear the rate-limit circuit-breaker cooldown so
217
+ * behavioral tests don't inherit it from a prior rate-limited stub call
218
+ * (the cooldown is process-global and shared across tests in one file).
219
+ * NOT for production use.
220
+ */
221
+ export function __resetRateLimitCooldownForTest(): void {
222
+ rateLimitCooldownUntil = 0;
223
+ }
224
+
225
+ // ── Constants ──────────────────────────────────────────────────────────────────
226
+
227
+ /** Default outer retry attempts (each may trigger SDK inner retries). */
228
+ const DEFAULT_MAX_RETRIES = 5;
229
+
230
+ /** SDK-level retries per attempt. */
231
+ const DEFAULT_SDK_RETRIES = 3;
232
+
233
+ /** Cooldown after a rate-limit hit before attempting calls again. */
234
+ const RATE_LIMIT_COOLDOWN_MS = 60_000;
235
+
236
+ /**
237
+ * Hard ceiling on any single retry backoff. During the network
238
+ * outage a retry ladder was observed live sleeping ~9.2 HOURS on one attempt
239
+ * ("Retrying (14/15) in 33033s") — the agent sat wedged silently with no
240
+ * signal that anything was wrong. Whatever the ladder computes (exponential
241
+ * growth, jitter, or future edits that raise the per-step base), the
242
+ * per-attempt backoff must stay bounded, so both retry sites clamp the
243
+ * computed delay to this ceiling. Attempt counts, SDK retries,
244
+ * circuit-breaker logic, and abort handling are intentionally untouched.
245
+ */
246
+ const MAX_RETRY_BACKOFF_MS = 120_000;
247
+
248
+ // ── Per-model concurrency limiter ────────────────────────────────────────────
249
+
250
+ /** Max concurrent in-flight LLM calls per model. Provider-side rate
251
+ * limits are typically expressed as requests-per-second or concurrent-
252
+ * connections; serializing bursts through a small pool prevents a
253
+ * 4-way Promise.allSettled batch of classify() calls from triggering
254
+ * rate-limits. The default of 2 means at most 2 calls
255
+ * to a given model are in-flight at any time; the rest queue. */
256
+ const MAX_CONCURRENT_PER_MODEL = 2;
257
+
258
+ /** Per-model semaphore: active count + waiters. */
259
+ type ModelLock = { active: number; waiters: Array<() => void> };
260
+ const _modelLocks = new Map<string, ModelLock>();
261
+
262
+ // ── LLM call listeners (Layer 2 wiring) ─────────────────────────────────────
263
+ //
264
+ // The session-recovery proposal routes every LLM call outcome
265
+ // through SessionHealthState. To avoid forcing every call site to pass a
266
+ // callback, we expose a process-wide listener registration. The enforcement
267
+ // extension registers listeners at session_start with a closure over the
268
+ // current ctx; calls go to whichever listener is currently registered.
269
+ //
270
+ // Single-listener design: only one consumer is expected (the enforcement
271
+ // extension). Multi-session / multi-consumer scenarios are a future concern.
272
+ //
273
+ // Listener slots live in `lib/state/global-state.ts` to satisfy the
274
+ // no-module-level-let contract; this file uses getter/setter wrappers.
275
+ import {
276
+ setLlmCallListeners,
277
+ getLlmErrorListener,
278
+ getLlmSuccessListener,
279
+ getKeyRingFeedbackHandler,
280
+ type LlmErrorListener,
281
+ type LlmSuccessListener,
282
+ } from "../state/global-state.js";
283
+
284
+ // Re-export the setter so existing callers (enforcement extension) keep
285
+ // working without changes.
286
+ export { setLlmCallListeners };
287
+ export type { LlmErrorListener, LlmSuccessListener };
288
+
289
+ async function acquireModelSlot(modelId: string): Promise<void> {
290
+ let lock = _modelLocks.get(modelId);
291
+ if (!lock) {
292
+ lock = { active: 0, waiters: [] };
293
+ _modelLocks.set(modelId, lock);
294
+ }
295
+ if (lock.active < MAX_CONCURRENT_PER_MODEL) {
296
+ lock.active++;
297
+ return;
298
+ }
299
+ return new Promise<void>((resolve) => {
300
+ lock!.waiters.push(() => {
301
+ lock!.active++;
302
+ resolve();
303
+ });
304
+ });
305
+ }
306
+
307
+ function releaseModelSlot(modelId: string): void {
308
+ const lock = _modelLocks.get(modelId);
309
+ if (!lock) return;
310
+ lock.active = Math.max(0, lock.active - 1);
311
+ const next = lock.waiters.shift();
312
+ if (next) next();
313
+ }
314
+
315
+ // ── Options ────────────────────────────────────────────────────────────────────
316
+
317
+ export interface LlmCallOptions {
318
+ /** Temperature for generation. Default: 0.1 */
319
+ temperature?: number;
320
+ /** Max output tokens. Default: auto from prompt length (1000-4000) */
321
+ maxTokens?: number;
322
+ /**
323
+ * Reasoning effort level - the SDK's own thinking-level union, so every
324
+ * level pi-ai defines is nameable here: "off" through "max". Pass "off"
325
+ * to disable thinking entirely for short mechanical tasks (yes/no
326
+ * classification, polishing). Pass "high" / "xhigh" / "max" for tasks
327
+ * that benefit from extended thinking (e.g. the think tool's review pass).
328
+ *
329
+ * Reasoning tokens count against max_tokens for most providers, so a
330
+ * yes/no classifier with default reasoning enabled will burn its entire
331
+ * budget on thinking and produce 0 output tokens (the empty-string
332
+ * symptom).
333
+ *
334
+ * "off" is not part of the SDK's stream-options `ThinkingLevel` union;
335
+ * pi-ai's clampThinkingLevel takes it and maps it anyway:
336
+ * - Models with "off" in their thinkingLevelMap: thinking disabled
337
+ * entirely (most efficient)
338
+ * - Models without "off" support: clamped to the lowest available level
339
+ * (e.g. "minimal")
340
+ * The value therefore crosses the stream-options boundary through the
341
+ * single cast in toSimpleStreamOptions.
342
+ *
343
+ * Default: undefined (provider default).
344
+ */
345
+ reasoning?: ModelThinkingLevel;
346
+ /** Per-attempt timeout in ms. Default: 600000 (10 min) */
347
+ timeoutMs?: number;
348
+ /** Outer retry attempts. Default: 5 */
349
+ maxRetries?: number;
350
+ /** Inner SDK retries per attempt. Default: 3 */
351
+ sdkRetries?: number;
352
+ /** Optional AbortSignal for cancellation */
353
+ signal?: AbortSignal;
354
+ }
355
+
356
+ // ── Public API ─────────────────────────────────────────────────────────────────
357
+
358
+ /**
359
+ * Make an LLM call with two-tier retry, backoff, and rate-limit circuit breaker.
360
+ *
361
+ * Uses AbortSignal for timeout to avoid orphaned Promise.race timeouts.
362
+ *
363
+ * @param model - pi-ai Model to call
364
+ * @param apiKey - API key for the provider
365
+ * @param systemPrompt - System prompt text
366
+ * @param userPrompt - User message text
367
+ * @param options - Optional configuration
368
+ * @returns `{ text }` on success or `{ error }` on failure
369
+ */
370
+ export async function callLlm(
371
+ model: Model<Api>,
372
+ apiKey: string | undefined,
373
+ systemPrompt: string,
374
+ userPrompt: string,
375
+ options: LlmCallOptions = {},
376
+ ): Promise<
377
+ | {
378
+ text: string;
379
+ stopReason?: string;
380
+ usage?: { input?: number; output?: number; totalTokens?: number };
381
+ }
382
+ | { error: string }
383
+ > {
384
+ // Circuit breaker: skip while a recent 429 cooldown is active ───────
385
+ const now = Date.now();
386
+ if (rateLimitCooldownUntil > 0 && now < rateLimitCooldownUntil) {
387
+ const remaining = rateLimitCooldownUntil - now;
388
+ log.debug(`Skipping LLM call - rate-limit cooldown ${remaining}ms remaining`);
389
+ return { error: "Rate-limit cooldown active" };
390
+ }
391
+
392
+ const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
393
+
394
+ const maxTokens =
395
+ options.maxTokens ?? Math.min(Math.max(1000, Math.floor(userPrompt.length / 8)), 4000);
396
+ // 10-minute default (was 30s). Aborts should be signal-driven (ESC,
397
+ // session shutdown), not timeout-driven. A timeout here is a fallback
398
+ // for orphaned calls (caller crashed, signal never fired) -- not the
399
+ // normal cancellation path. Callers can still pass a tighter
400
+ // timeoutMs if they want a hard ceiling.
401
+ const timeoutMs = options.timeoutMs ?? 600_000;
402
+ const temperature = options.temperature ?? 0.1;
403
+ const sdkMaxRetries = options.sdkRetries ?? DEFAULT_SDK_RETRIES;
404
+ const signal = options.signal;
405
+
406
+ // Internal-call body hygiene: redact raw edge/WAF page dumps, asset-sized
407
+ // base64 runs, and the edge filter's own request trigger before they are
408
+ // sent — a re-sent page fragment can trigger the same edge block that
409
+ // produced it. No-op for normal prompts (identity).
410
+ const systemSafe = sanitizeLlmRequestText(systemPrompt);
411
+ const userSafe = sanitizeLlmRequestText(userPrompt);
412
+ const requestRedactions = systemSafe.redactions + userSafe.redactions;
413
+ if (requestRedactions > 0) {
414
+ log.warn(
415
+ `LLM request body sanitized before send (${requestRedactions} fragment(s) rewritten; edge/WAF hygiene)`,
416
+ );
417
+ }
418
+
419
+ const context: Context = {
420
+ systemPrompt: systemSafe.text,
421
+ messages: [{ role: "user", content: userSafe.text, timestamp: Date.now() }],
422
+ };
423
+
424
+ // ── per-model concurrency limiter: acquire ONCE at function entry, release in finally ──
425
+ // (One slot per callLlm invocation, not per retry - otherwise retries could
426
+ // pile up beyond MAX_CONCURRENT_PER_MODEL.)
427
+ await acquireModelSlot(model.id);
428
+
429
+ // Emergency retry bookkeeping. A context_window (413) error
430
+ // means the payload is too big — retrying the same payload is the quota
431
+ // burn this fixes. On the FIRST such error we run the published emergency
432
+ // offloader (deterministic size-driven shrink of the live session's largest
433
+ // toolResults) and retry EXACTLY ONCE with the shrunk context. Never a
434
+ // second emergency retry in one callLlm invocation: if the shrunk payload
435
+ // still 413s, the error propagates (compaction/rotation owns the next move).
436
+ let emergencyRetryUsed = false;
437
+
438
+ try {
439
+ for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
440
+ // ── circuit breaker re-check inside retry loop ──
441
+ if (rateLimitCooldownUntil > 0 && Date.now() < rateLimitCooldownUntil) {
442
+ log.warn(`Skipping retry ${attempt} - rate-limit cooldown active`);
443
+ return { error: "Rate-limit cooldown active" };
444
+ }
445
+
446
+ // ── ESC check: if the external signal already fired (e.g. during
447
+ // backoff sleep), don't attempt another call. Without this, the
448
+ // retry loop continues after abortable sleep resolves early, but
449
+ // combineSignals returns only the timeout signal (s1 already
450
+ // aborted -> returns s2), so the next attempt hangs until timeout.
451
+ if (signal?.aborted) {
452
+ log.debug("LLM call aborted (signal fired before retry attempt)");
453
+ return { error: "Request was aborted" };
454
+ }
455
+
456
+ // Use AbortSignal for timeout instead of Promise.race - avoids orphaned timer
457
+ const timeoutController = new AbortController();
458
+ const timeoutId = setTimeout(
459
+ () => timeoutController.abort(new Error("LLM call timeout")),
460
+ timeoutMs,
461
+ );
462
+
463
+ // Combine external signal with timeout signal
464
+ const combinedSignal = signal
465
+ ? combineSignals(signal, timeoutController.signal)
466
+ : timeoutController.signal;
467
+
468
+ // Helper: clean up timeout + combined signal listeners after
469
+ // each attempt. Aborting timeoutController triggers combineSignals'
470
+ // built-in listener removal (onAbort removes itself from both
471
+ // parent signals). Without this, stale listeners accumulate on
472
+ // the external signal across retries -- a listener leak.
473
+ const cleanupAttempt = (): void => {
474
+ clearTimeout(timeoutId);
475
+ // Abort the timeout controller to trigger combineSignals cleanup.
476
+ // The combined controller is already abandoned (we have the result),
477
+ // so aborting it is harmless.
478
+ if (!timeoutController.signal.aborted) {
479
+ timeoutController.abort();
480
+ }
481
+ };
482
+
483
+ try {
484
+ // Build the options object explicitly: `reasoning` is typed as the
485
+ // SDK's ModelThinkingLevel (which includes "off") and crosses into
486
+ // the registry's streamSimple through the single cast in
487
+ // toSimpleStreamOptions.
488
+ //
489
+ // We always pass the reasoning value when set, including "off" -
490
+ // pi-ai's clampThinkingLevel takes "off" and maps it (off if the
491
+ // model supports it, else the lowest available level like "minimal").
492
+ const simpleOptions: {
493
+ apiKey: string | undefined;
494
+ maxTokens: number;
495
+ temperature: number;
496
+ maxRetries: number;
497
+ reasoning?: ModelThinkingLevel;
498
+ signal: AbortSignal;
499
+ sessionId?: string;
500
+ } = {
501
+ apiKey,
502
+ maxTokens,
503
+ temperature,
504
+ maxRetries: sdkMaxRetries,
505
+ signal: combinedSignal,
506
+ };
507
+ if (options.reasoning !== undefined) {
508
+ simpleOptions.reasoning = options.reasoning;
509
+ }
510
+ const sessionId = resolveSessionId();
511
+ if (sessionId !== undefined) {
512
+ simpleOptions.sessionId = sessionId;
513
+ }
514
+ const result = await _resolveCompletion()(
515
+ model as Model<Api>,
516
+ context,
517
+ toSimpleStreamOptions(simpleOptions),
518
+ );
519
+
520
+ cleanupAttempt();
521
+
522
+ if (result.errorMessage) {
523
+ // Raw text drives classification and the key-ring feed-back below;
524
+ // the sanitized copy is what log lines and the caller see, so raw
525
+ // HTTP block pages never reach either. See payload-hygiene.ts.
526
+ const rawError = result.errorMessage;
527
+ const safeError = sanitizeLlmErrorForLog(rawError);
528
+ // ── emergency size-driven offload on 413 ──
529
+ // The error classifier says context_window → the payload is too
530
+ // big and shrinking it is the ONLY useful action. Run the
531
+ // published emergency offloader (bypasses the health-gate by
532
+ // construction: this path never consults SessionHealthState) and
533
+ // retry exactly once. Consumer without the context-manager loaded
534
+ // (runner or ctx provider absent) → fall through to the normal
535
+ // error path, lossy-safe.
536
+ if (!emergencyRetryUsed && isContextWindowErrorText(rawError)) {
537
+ emergencyRetryUsed = true;
538
+ const offloadResult = await runEmergencyOffloadForCall();
539
+ if (offloadResult > 0) {
540
+ log.warn(
541
+ `LLM context-window error (413); emergency offload shrank the ` +
542
+ `context (${offloadResult} oversized toolResult(s) stubbed) — ` +
543
+ `retrying once with the shrunken payload`,
544
+ );
545
+ cleanupAttempt();
546
+ attempt--; // do not burn a retry-ladder slot on the shrink
547
+ continue;
548
+ }
549
+ emergencyRetryUsed = false; // nothing shrank — do not block a later retry
550
+ }
551
+
552
+ if (attempt <= maxRetries && isTransientError(rawError)) {
553
+ const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
554
+ log.warn(
555
+ `LLM transient error (attempt ${attempt}/${maxRetries + 1}), ` +
556
+ `retrying in ${delay}ms: ${safeError}`,
557
+ );
558
+
559
+ if (isRateLimitError(rawError)) {
560
+ rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
561
+ }
562
+
563
+ // Pass signal so ESC during backoff aborts the retry
564
+ // instead of letting it fire after the delay.
565
+ await sleep(delay, signal);
566
+ continue;
567
+ }
568
+
569
+ // Non-retryable or exhausted - log and return
570
+ if (isRateLimitError(rawError)) {
571
+ rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
572
+ log.warn(
573
+ `LLM rate-limited, giving up (cooldown ${RATE_LIMIT_COOLDOWN_MS}ms): ${safeError}`,
574
+ );
575
+ } else if (
576
+ // Demote "Request was aborted" to debug when caused by the
577
+ // caller's external signal (ESC, session shutdown). These
578
+ // are expected cancellations, not real errors. Without
579
+ // this gate, the user sees an ERROR line every time they
580
+ // press ESC during a turn that had braid LLM calls in
581
+ // flight (consolidation, classify, sop-extract, etc.).
582
+ //
583
+ // The distinguishing signal is `signal.aborted` - it becomes
584
+ // true when EITHER the timeout fires OR the external signal
585
+ // fires. We can't tell them apart from `result.errorMessage`
586
+ // alone (pi-ai returns "Request was aborted" for both), so
587
+ // we check the original external signal: if it was set and
588
+ // is now aborted, this is a user-driven cancellation.
589
+ //
590
+ // Universal fallback: if the error message contains
591
+ // "abort" (any case) we also demote to debug. This covers
592
+ // post-loop callers (heartbeat, context-hygiene) where
593
+ // ctx.signal is undefined and the only abort source is
594
+ // the timeout itself firing under session-end load - the
595
+ // user didn't ask for that to be logged at ERROR.
596
+ signal?.aborted === true ||
597
+ /abort/i.test(rawError)
598
+ ) {
599
+ log.debug(
600
+ `LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeError})`,
601
+ );
602
+ } else {
603
+ log.error("LLM error:", safeError);
604
+ }
605
+ // Notify listener (Layer 2 wiring) - non-fatal if it throws.
606
+ try {
607
+ // The session-health listener classifies the RAW text — a
608
+ // sanitized page would lose its rate-limit/edge category.
609
+ getLlmErrorListener()?.(rawError);
610
+ } catch {
611
+ // non-fatal
612
+ }
613
+ // Feed the failure back into the key ring that owns this model so a
614
+ // direct (non-message_end) 429/403 exhausts + rotates the same way
615
+ // handleMessageEnd does. No-op when providers hasn't
616
+ // published a handler or the model is foreign (lossy-safe).
617
+ // Same for the key ring: its WAF/rotation classifier needs the raw
618
+ // markup markers ("cf-ray", "<html", …) the sanitizer removes.
619
+ reportLlmFailureToKeyRing(model, rawError);
620
+ return { error: safeError };
621
+ }
622
+
623
+ // Success - extract text content
624
+ const textContent = result.content.filter(
625
+ (c): c is { type: "text"; text: string } => c.type === "text",
626
+ );
627
+ const text = textContent.length > 0 ? textContent[0].text : "";
628
+
629
+ // Notify listener (Layer 2 wiring) - non-fatal if the listener throws.
630
+ try {
631
+ getLlmSuccessListener()?.();
632
+ } catch {
633
+ // non-fatal
634
+ }
635
+ // Feed the success back so the serving key's backoff is healed.
636
+ reportLlmSuccessToKeyRing(model);
637
+
638
+ // Surface stopReason and usage so callers can diagnose empty
639
+ // responses (e.g. "stopReason=length" means the model hit the
640
+ // max_tokens ceiling, which is why the response is empty).
641
+ // pi-ai's Usage has fields { input, output, totalTokens, ... }
642
+ // (not { inputTokens, outputTokens }) - the field names below
643
+ // mirror the upstream type.
644
+ //
645
+ // Telemetry note (investigation): direct calls never pass
646
+ // through pi-core's message pipeline, so this usage is returned
647
+ // to the caller and has NO session-JSONL feed — all-zero usage
648
+ // entries in session files are error-path zero-fills from failed
649
+ // agent-loop requests (stopReason: "error", e.g. "Connection
650
+ // error."), not unparsed direct-call usage. Verified:
651
+ // 94/94 zero-usage entries across 22 sessions were error markers.
652
+ return {
653
+ text,
654
+ stopReason: result.stopReason,
655
+ usage: result.usage
656
+ ? {
657
+ input: result.usage.input,
658
+ output: result.usage.output,
659
+ totalTokens: result.usage.totalTokens,
660
+ }
661
+ : undefined,
662
+ };
663
+ } catch (err) {
664
+ cleanupAttempt();
665
+ const message = err instanceof Error ? err.message : String(err);
666
+ const safeMessage = sanitizeLlmErrorForLog(message);
667
+ const isTimeout =
668
+ message.includes("timeout") ||
669
+ message.includes("Timed") ||
670
+ (err instanceof Error && err.name === "AbortError");
671
+ // ── same emergency-offload exception as the
672
+ // result.errorMessage path above — provider SDKs that THROW on 413
673
+ // (instead of returning errorMessage) must get the same one-time
674
+ // shrink + retry, or the quota-burn loop survives in that shape.
675
+ if (!emergencyRetryUsed && isContextWindowErrorText(message)) {
676
+ emergencyRetryUsed = true;
677
+ const offloadResult = await runEmergencyOffloadForCall();
678
+ if (offloadResult > 0) {
679
+ log.warn(
680
+ `LLM context-window error (413); emergency offload shrank the ` +
681
+ `context (${offloadResult} oversized toolResult(s) stubbed) — ` +
682
+ `retrying once with the shrunken payload`,
683
+ );
684
+ attempt--; // do not burn a retry-ladder slot on the shrink
685
+ continue;
686
+ }
687
+ emergencyRetryUsed = false; // nothing shrank — do not block a later retry
688
+ }
689
+ if (attempt <= maxRetries && (isTimeout || isTransientError(message))) {
690
+ const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
691
+ log.warn(
692
+ `LLM error (attempt ${attempt}/${maxRetries + 1}), ` +
693
+ `retrying in ${delay}ms: ${safeMessage}`,
694
+ );
695
+ // Pass signal so ESC during backoff aborts the retry.
696
+ await sleep(delay, signal);
697
+ continue;
698
+ }
699
+ // Demote to debug when an external signal (ESC / session shutdown)
700
+ // caused the abort, OR when the message is itself an abort
701
+ // (covered by the universal /abort/i fallback in the
702
+ // result.errorMessage branch above). This matches the
703
+ // demotion there. Without this, the catch path still emits
704
+ // ERROR lines for expected cancellations and post-loop
705
+ // timeouts fired under session-end load.
706
+ if (signal?.aborted === true || /abort/i.test(message)) {
707
+ log.debug(
708
+ `LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeMessage})`,
709
+ );
710
+ } else {
711
+ log.error(
712
+ isTimeout
713
+ ? `LLM call timed out after ${maxRetries + 1} attempts`
714
+ : `LLM call failed: ${safeMessage}`,
715
+ );
716
+ }
717
+ // Notify listener (Layer 2 wiring) - non-fatal if it throws.
718
+ try {
719
+ getLlmErrorListener()?.(message);
720
+ } catch {
721
+ // non-fatal
722
+ }
723
+ // Feed the failure back into the key ring — same seam as the
724
+ // result.errorMessage path above (raw text for the same reason).
725
+ reportLlmFailureToKeyRing(model, message);
726
+ return { error: safeMessage };
727
+ }
728
+ }
729
+
730
+ return { error: `LLM call failed after ${maxRetries + 1} attempts` };
731
+ } finally {
732
+ releaseModelSlot(model.id);
733
+ }
734
+ }
735
+
736
+ // ── Helpers ────────────────────────────────────────────────────────────────────
737
+
738
+ /**
739
+ * Run the published emergency offloader (context-manager's
740
+ * context-emergency.ts) against the current session context. Lossy-safe:
741
+ * when the runner or ctx provider has not been published (extension not
742
+ * loaded), or either throws, this returns 0 — the caller then takes the
743
+ * normal error path. Returns the number of oversized toolResults stubbed
744
+ * (0 = nothing shrank — the caller must NOT retry).
745
+ */
746
+ function runEmergencyOffloadForCall(): Promise<number> {
747
+ const runner = getContextEmergencyOffloadRunner();
748
+ const provider = getExtensionCtxProvider();
749
+ if (!runner || !provider) return Promise.resolve(0);
750
+ let ctx: unknown;
751
+ try {
752
+ ctx = provider();
753
+ } catch {
754
+ return Promise.resolve(0);
755
+ }
756
+ if (!ctx) return Promise.resolve(0);
757
+ return Promise.resolve(runner(ctx, "llm-retry")).then(
758
+ (r) => (r && r.offloaded > 0 ? r.offloaded : 0),
759
+ () => 0,
760
+ );
761
+ }
762
+
763
+ /**
764
+ * Feed a failed callLlm back into the key ring that owns this model, so a
765
+ * direct (non-message_end) 429/403 exhausts + rotates instead of leaving no
766
+ * trace in the ring. The providers extension publishes a handler
767
+ * into a process-global slot at load; with no handler registered (e.g. the
768
+ * providers extension isn't loaded) this is a silent no-op — lossy-safe.
769
+ * Attribution is per-call (this model's own id/provider); the handler resolves
770
+ * the owning ring, so two providers' rings can never be confused.
771
+ */
772
+ function reportLlmFailureToKeyRing(
773
+ model: { id: string; provider?: string },
774
+ errText: unknown,
775
+ ): void {
776
+ const handler = getKeyRingFeedbackHandler();
777
+ if (!handler) return;
778
+ try {
779
+ handler.reportFailure(model.id, model.provider, String(errText ?? ""));
780
+ } catch {
781
+ // non-fatal — the ring must never break an LLM call
782
+ }
783
+ }
784
+
785
+ /**
786
+ * Feed a successful callLlm back so the serving key's backoff is healed
787
+ * (mirrors handleMessageEnd's success path). No-op when no handler is
788
+ * published, and the handler itself skips foreign models / healthy keys.
789
+ */
790
+ function reportLlmSuccessToKeyRing(model: { id: string; provider?: string }): void {
791
+ const handler = getKeyRingFeedbackHandler();
792
+ if (!handler) return;
793
+ try {
794
+ handler.reportSuccess(model.id, model.provider);
795
+ } catch {
796
+ // non-fatal
797
+ }
798
+ }
799
+
800
+ /**
801
+ * (provider, model) pairs whose unusable answer was already reported this
802
+ * process. Bounded by the route table times the model ids in play, and cleared
803
+ * when the module is re-evaluated (/reload), which is the sense in which the
804
+ * notice is once per process.
805
+ */
806
+ const reportedUnusableModels = new Set<string>();
807
+
808
+ /**
809
+ * The skip notice, once per (provider, model) per process, through the same
810
+ * log channel every other auxiliary-call diagnostic uses. Repeats are silent,
811
+ * so a session that keeps re-resolving an unusable model writes one line.
812
+ */
813
+ function reportUnusableModelOnce(model: { id: string; provider?: string }): void {
814
+ const provider = model.provider ?? "unknown";
815
+ const key = `${provider}/${model.id}`;
816
+ if (reportedUnusableModels.has(key)) return;
817
+ reportedUnusableModels.add(key);
818
+ log.info(
819
+ `Skipping auxiliary model ${provider}/${model.id}: the provider reports it ` +
820
+ `unusable right now (no usable key, or a request it just rejected).`,
821
+ );
822
+ }
823
+
824
+ /**
825
+ * The one yes/no question core asks the providers seam before re-using a
826
+ * (provider, model) pair for an auxiliary call: can this pair serve a request
827
+ * right now? The handler owns the answer, so core learns no route vocabulary:
828
+ * it asks and skips, it does not interpret.
829
+ *
830
+ * Fail-open by construction: with nothing published, no query method, or a
831
+ * throwing query, the answer is true, so auxiliary calls behave exactly as they
832
+ * did before the seam existed. A false answer is reported once.
833
+ */
834
+ export function isModelRouteUsable(model: { id: string; provider?: string }): boolean {
835
+ const handler = getKeyRingFeedbackHandler();
836
+ const query = handler && (handler as { routeUsable?: unknown }).routeUsable;
837
+ if (typeof query !== "function") return true;
838
+ let usable: boolean;
839
+ try {
840
+ usable =
841
+ (query as (modelId: string, providerId: string | undefined) => boolean).call(
842
+ handler,
843
+ model.id,
844
+ model.provider,
845
+ ) !== false;
846
+ } catch {
847
+ return true; // the seam must never break an auxiliary call
848
+ }
849
+ if (!usable) reportUnusableModelOnce(model);
850
+ return usable;
851
+ }
852
+
853
+ /**
854
+ * Combine two AbortSignals into one. When either signal aborts, the combined signal aborts.
855
+ *
856
+ * If either parent signal is already aborted, returns just the *other* signal unmodified
857
+ * rather than creating an immediately-aborted controller. This prevents stale external
858
+ * signals (e.g. from timed-out tool executions) from instant-killing the combined signal
859
+ * on retry.
860
+ *
861
+ * Cleans up event listeners after the combined signal fires to prevent memory leaks
862
+ * across repeated calls (e.g. retry loops creating new combined signals).
863
+ *
864
+ * @internal Exported for behavioral testing (test-call-llm-behavior.mjs).
865
+ * Production code should not call this directly.
866
+ */
867
+ export function combineSignals(s1: AbortSignal, s2: AbortSignal): AbortSignal {
868
+ // If either signal is already dead, just return the other - combining into an
869
+ // already-aborted signal is a no-op that would only propagate the stale abort.
870
+ if (s1.aborted) return s2;
871
+ if (s2.aborted) return s1;
872
+
873
+ const controller = new AbortController();
874
+ const onAbort = () => {
875
+ controller.abort();
876
+ s1.removeEventListener("abort", onAbort);
877
+ s2.removeEventListener("abort", onAbort);
878
+ };
879
+ s1.addEventListener("abort", onAbort);
880
+ s2.addEventListener("abort", onAbort);
881
+ return controller.signal;
882
+ }
883
+
884
+ /** Detect errors that are worth retrying. */
885
+ function isTransientError(message: string): boolean {
886
+ return isRateLimitError(message) || matchesTransientOnly(message);
887
+ }
888
+
889
+ /**
890
+ * Check if an error message indicates a rate-limit condition specifically.
891
+ * Delegates to the canonical patterns in lib/errors/llm-error.ts (dedupe:
892
+ * the former local substring list had drifted — no "429"-anywhere, no
893
+ * "rate_limit"/"too_many_requests" underscore forms, no "throttle/-ing").
894
+ */
895
+ function isRateLimitError(message: string): boolean {
896
+ return isRateLimitText(message);
897
+ }
898
+
899
+ /** Patterns that indicate transient failure but not rate-limit. */
900
+ const TRANSIENT_ONLY_PATTERNS = [
901
+ "overloaded",
902
+ "service unavailable",
903
+ "temporarily",
904
+ "try again later",
905
+ "please retry",
906
+ "network connection lost",
907
+ "upstream connect",
908
+ "connection refused",
909
+ ] as const;
910
+ const TRANSIENT_ONLY_CODES = ["529", "502", "503", "504"] as const;
911
+
912
+ function matchesTransientOnly(message: string): boolean {
913
+ if (TRANSIENT_ONLY_CODES.some((code) => message.startsWith(code))) return true;
914
+ const lower = message.toLowerCase();
915
+ return TRANSIENT_ONLY_PATTERNS.some((p) => lower.includes(p));
916
+ }
917
+
918
+ /**
919
+ * Compute exponential backoff delay.
920
+ * attempt 1 -> 5s, attempt 2 -> 15s, attempt 3 -> 30s, attempt 4 -> 60s
921
+ * With +/-20% jitter. Capped at 60s.
922
+ */
923
+ /**
924
+ * Cast our locally-typed `simpleOptions` to the options shape the registry's
925
+ * `streamSimple` expects.
926
+ *
927
+ * Why this exists: `reasoning` is typed `ModelThinkingLevel`, which includes
928
+ * "off", while the SDK's stream-options `ThinkingLevel` does not list it.
929
+ * pi-ai's runtime takes "off" and maps it (off if the model supports it,
930
+ * else the lowest available level like "minimal"), so the value is sound at
931
+ * runtime. One helper keeps the boundary explicit and findable; when the
932
+ * SDK's stream-options type gains "off", this becomes an identity cast.
933
+ */
934
+ function toSimpleStreamOptions(opts: {
935
+ apiKey: string | undefined;
936
+ maxTokens: number;
937
+ temperature: number;
938
+ maxRetries: number;
939
+ reasoning?: ModelThinkingLevel;
940
+ signal: AbortSignal;
941
+ sessionId?: string;
942
+ }): ModelsSimpleStreamOptions {
943
+ return opts as unknown as ModelsSimpleStreamOptions;
944
+ }
945
+
946
+ function backoffDelay(attempt: number): number {
947
+ const delays = [5_000, 15_000, 30_000, 60_000];
948
+ const base = delays[Math.min(attempt - 1, delays.length - 1)];
949
+ const jitter = Math.round(base * (0.8 + Math.random() * 0.4));
950
+ return Math.min(jitter, 60_000);
951
+ }
952
+
953
+ /**
954
+ * Abortable sleep. Resolves immediately if signal fires during the wait.
955
+ *
956
+ * Without this, pressing ESC during a retry backoff (5-60s) would
957
+ * leave the sleep running -- the retry would fire after the backoff,
958
+ * then hang until the new timeout fires. The signal was only checked
959
+ * at the next combineSignals call, not during the backoff itself.
960
+ */
961
+ function sleep(ms: number, signal?: AbortSignal): Promise<void> {
962
+ if (!signal) return new Promise((r) => setTimeout(r, ms));
963
+ if (signal.aborted) return Promise.resolve();
964
+ return new Promise((resolve) => {
965
+ const timer = setTimeout(() => {
966
+ signal.removeEventListener("abort", onAbort);
967
+ resolve();
968
+ }, ms);
969
+ const onAbort = () => {
970
+ clearTimeout(timer);
971
+ resolve();
972
+ };
973
+ signal.addEventListener("abort", onAbort, { once: true });
974
+ });
975
+ }