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,745 @@
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
+ // Degraded transport only: see completeAuxCall below. Compat resolves the
33
+ // credential from the model and the apiKey argument and nothing else, which is
34
+ // exactly the case it is reserved for (no published context, so no registry to
35
+ // resolve headers or the session id through).
36
+ import { completeSimple } from "@earendil-works/pi-ai/compat";
37
+ // Auxiliary calls dispatch through the session's model registry (see the
38
+ // completion-dispatch block below): pi-ai's compat entrypoint resolves an api
39
+ // key from the model and nothing else, so registry-resolved headers, configured
40
+ // provider headers, and the session id never reach a compat request. Compat is
41
+ // kept only as the degraded fallback for the no-context case. The registry is
42
+ // also where braid's own providers are registered (pi.registerProvider), so it
43
+ // is the one handle that reaches both built-in and custom providers.
44
+ import { createLogger } from "../core/logger.js";
45
+ import { isRateLimitText } from "../errors/llm-error.js";
46
+ import { isContextWindowErrorText } from "../errors/llm-error.js";
47
+ import { sanitizeLlmErrorForLog, sanitizeLlmRequestText } from "./payload-hygiene.js";
48
+ import { getContextEmergencyOffloadRunner, getExtensionCtxProvider, hasWarnedAuxDegradedTransport, markAuxDegradedTransportWarned, } from "../state/global-state.js";
49
+ const log = createLogger("llm-call");
50
+ /** Read the published extension context, or null when none was published. */
51
+ function readAuxContext() {
52
+ const provider = getExtensionCtxProvider();
53
+ if (!provider)
54
+ return null;
55
+ try {
56
+ return provider() ?? null;
57
+ }
58
+ catch {
59
+ return null;
60
+ }
61
+ }
62
+ /**
63
+ * Session id for the request (per-conversation routing and prompt-cache
64
+ * affinity). Undefined when no session manager is readable, never a sentinel:
65
+ * an invented id would route the request to a conversation that does not
66
+ * exist. Which header the id becomes is the provider's own business.
67
+ */
68
+ function resolveSessionId() {
69
+ try {
70
+ const id = readAuxContext()?.sessionManager?.getSessionId?.();
71
+ return typeof id === "string" && id.length > 0 ? id : undefined;
72
+ }
73
+ catch {
74
+ return undefined;
75
+ }
76
+ }
77
+ /**
78
+ * Production completion. Primary path: the session's model registry, the same
79
+ * path the session's own requests take, so pi-core resolves the credential,
80
+ * the configured and provider-declared headers, the session id (which a
81
+ * provider may turn into a routing header), and the transport.
82
+ *
83
+ * Degraded path: pi-ai's compat entrypoint, used only when nothing has
84
+ * published a context. Compat resolves the credential from the model and the
85
+ * apiKey argument and carries nothing else: no session id, no configured
86
+ * provider headers. Auxiliary calls must still complete when the publisher
87
+ * never ran (the publisher is the enforcement extension's session-start
88
+ * handler, and enforcement is disableable), but the degradation is announced
89
+ * once per process by warnDegradedTransportOnce so it is never mistaken for
90
+ * the full path.
91
+ */
92
+ async function completeAuxCall(model, context, options) {
93
+ const registry = readAuxContext()?.modelRegistry;
94
+ if (registry) {
95
+ return registry.streamSimple(model, context, options).result();
96
+ }
97
+ warnDegradedTransportOnce();
98
+ return completeSimple(model, context, options);
99
+ }
100
+ /**
101
+ * Announce the degraded transport exactly once per process, naming the
102
+ * publisher that did not run and what the fallback does not carry. Silence
103
+ * after the first line keeps a degraded session from flooding the log; the
104
+ * latch is process-global (global-state.ts) so it survives session boundaries
105
+ * and module re-evaluation on /reload.
106
+ */
107
+ function warnDegradedTransportOnce() {
108
+ if (hasWarnedAuxDegradedTransport())
109
+ return;
110
+ markAuxDegradedTransportWarned();
111
+ log.warn("No session context published for auxiliary LLM calls (the enforcement " +
112
+ "extension publishes it at session_start; enforcement is disableable). " +
113
+ "Falling back to pi-ai's compat transport: the request carries the " +
114
+ "model's credential only, without the session id or configured provider " +
115
+ "headers. Auxiliary calls are degraded until the publisher runs.");
116
+ }
117
+ // The override slot is for test injection only; production uses the registry.
118
+ let _completionOverride = null;
119
+ function _resolveCompletion() {
120
+ return _completionOverride ?? completeAuxCall;
121
+ }
122
+ /**
123
+ * @internal Test-only: override the completion call for behavioral testing.
124
+ * Pass `null` to reset to the production implementation. NOT for use
125
+ * in production code paths.
126
+ */
127
+ export function __setCompleteSimpleForTest(fn) {
128
+ _completionOverride = fn ?? null;
129
+ }
130
+ /** Track the cooldown expiration deadline. */
131
+ let rateLimitCooldownUntil = 0;
132
+ /**
133
+ * @internal Test-only: clear the rate-limit circuit-breaker cooldown so
134
+ * behavioral tests don't inherit it from a prior rate-limited stub call
135
+ * (the cooldown is process-global and shared across tests in one file).
136
+ * NOT for production use.
137
+ */
138
+ export function __resetRateLimitCooldownForTest() {
139
+ rateLimitCooldownUntil = 0;
140
+ }
141
+ // ── Constants ──────────────────────────────────────────────────────────────────
142
+ /** Default outer retry attempts (each may trigger SDK inner retries). */
143
+ const DEFAULT_MAX_RETRIES = 5;
144
+ /** SDK-level retries per attempt. */
145
+ const DEFAULT_SDK_RETRIES = 3;
146
+ /** Cooldown after a rate-limit hit before attempting calls again. */
147
+ const RATE_LIMIT_COOLDOWN_MS = 60_000;
148
+ /**
149
+ * Hard ceiling on any single retry backoff. During the network
150
+ * outage a retry ladder was observed live sleeping ~9.2 HOURS on one attempt
151
+ * ("Retrying (14/15) in 33033s") — the agent sat wedged silently with no
152
+ * signal that anything was wrong. Whatever the ladder computes (exponential
153
+ * growth, jitter, or future edits that raise the per-step base), the
154
+ * per-attempt backoff must stay bounded, so both retry sites clamp the
155
+ * computed delay to this ceiling. Attempt counts, SDK retries,
156
+ * circuit-breaker logic, and abort handling are intentionally untouched.
157
+ */
158
+ const MAX_RETRY_BACKOFF_MS = 120_000;
159
+ // ── Per-model concurrency limiter ────────────────────────────────────────────
160
+ /** Max concurrent in-flight LLM calls per model. Provider-side rate
161
+ * limits are typically expressed as requests-per-second or concurrent-
162
+ * connections; serializing bursts through a small pool prevents a
163
+ * 4-way Promise.allSettled batch of classify() calls from triggering
164
+ * rate-limits. The default of 2 means at most 2 calls
165
+ * to a given model are in-flight at any time; the rest queue. */
166
+ const MAX_CONCURRENT_PER_MODEL = 2;
167
+ const _modelLocks = new Map();
168
+ // ── LLM call listeners (Layer 2 wiring) ─────────────────────────────────────
169
+ //
170
+ // The session-recovery proposal routes every LLM call outcome
171
+ // through SessionHealthState. To avoid forcing every call site to pass a
172
+ // callback, we expose a process-wide listener registration. The enforcement
173
+ // extension registers listeners at session_start with a closure over the
174
+ // current ctx; calls go to whichever listener is currently registered.
175
+ //
176
+ // Single-listener design: only one consumer is expected (the enforcement
177
+ // extension). Multi-session / multi-consumer scenarios are a future concern.
178
+ //
179
+ // Listener slots live in `lib/state/global-state.ts` to satisfy the
180
+ // no-module-level-let contract; this file uses getter/setter wrappers.
181
+ import { setLlmCallListeners, getLlmErrorListener, getLlmSuccessListener, getKeyRingFeedbackHandler, } from "../state/global-state.js";
182
+ // Re-export the setter so existing callers (enforcement extension) keep
183
+ // working without changes.
184
+ export { setLlmCallListeners };
185
+ async function acquireModelSlot(modelId) {
186
+ let lock = _modelLocks.get(modelId);
187
+ if (!lock) {
188
+ lock = { active: 0, waiters: [] };
189
+ _modelLocks.set(modelId, lock);
190
+ }
191
+ if (lock.active < MAX_CONCURRENT_PER_MODEL) {
192
+ lock.active++;
193
+ return;
194
+ }
195
+ return new Promise((resolve) => {
196
+ lock.waiters.push(() => {
197
+ lock.active++;
198
+ resolve();
199
+ });
200
+ });
201
+ }
202
+ function releaseModelSlot(modelId) {
203
+ const lock = _modelLocks.get(modelId);
204
+ if (!lock)
205
+ return;
206
+ lock.active = Math.max(0, lock.active - 1);
207
+ const next = lock.waiters.shift();
208
+ if (next)
209
+ next();
210
+ }
211
+ // ── Public API ─────────────────────────────────────────────────────────────────
212
+ /**
213
+ * Make an LLM call with two-tier retry, backoff, and rate-limit circuit breaker.
214
+ *
215
+ * Uses AbortSignal for timeout to avoid orphaned Promise.race timeouts.
216
+ *
217
+ * @param model - pi-ai Model to call
218
+ * @param apiKey - API key for the provider
219
+ * @param systemPrompt - System prompt text
220
+ * @param userPrompt - User message text
221
+ * @param options - Optional configuration
222
+ * @returns `{ text }` on success or `{ error }` on failure
223
+ */
224
+ export async function callLlm(model, apiKey, systemPrompt, userPrompt, options = {}) {
225
+ // Circuit breaker: skip while a recent 429 cooldown is active ───────
226
+ const now = Date.now();
227
+ if (rateLimitCooldownUntil > 0 && now < rateLimitCooldownUntil) {
228
+ const remaining = rateLimitCooldownUntil - now;
229
+ log.debug(`Skipping LLM call - rate-limit cooldown ${remaining}ms remaining`);
230
+ return { error: "Rate-limit cooldown active" };
231
+ }
232
+ const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
233
+ const maxTokens = options.maxTokens ?? Math.min(Math.max(1000, Math.floor(userPrompt.length / 8)), 4000);
234
+ // 10-minute default (was 30s). Aborts should be signal-driven (ESC,
235
+ // session shutdown), not timeout-driven. A timeout here is a fallback
236
+ // for orphaned calls (caller crashed, signal never fired) -- not the
237
+ // normal cancellation path. Callers can still pass a tighter
238
+ // timeoutMs if they want a hard ceiling.
239
+ const timeoutMs = options.timeoutMs ?? 600_000;
240
+ const temperature = options.temperature ?? 0.1;
241
+ const sdkMaxRetries = options.sdkRetries ?? DEFAULT_SDK_RETRIES;
242
+ const signal = options.signal;
243
+ // Internal-call body hygiene: redact raw edge/WAF page dumps, asset-sized
244
+ // base64 runs, and the edge filter's own request trigger before they are
245
+ // sent — a re-sent page fragment can trigger the same edge block that
246
+ // produced it. No-op for normal prompts (identity).
247
+ const systemSafe = sanitizeLlmRequestText(systemPrompt);
248
+ const userSafe = sanitizeLlmRequestText(userPrompt);
249
+ const requestRedactions = systemSafe.redactions + userSafe.redactions;
250
+ if (requestRedactions > 0) {
251
+ log.warn(`LLM request body sanitized before send (${requestRedactions} fragment(s) rewritten; edge/WAF hygiene)`);
252
+ }
253
+ const context = {
254
+ systemPrompt: systemSafe.text,
255
+ messages: [{ role: "user", content: userSafe.text, timestamp: Date.now() }],
256
+ };
257
+ // ── per-model concurrency limiter: acquire ONCE at function entry, release in finally ──
258
+ // (One slot per callLlm invocation, not per retry - otherwise retries could
259
+ // pile up beyond MAX_CONCURRENT_PER_MODEL.)
260
+ await acquireModelSlot(model.id);
261
+ // Emergency retry bookkeeping. A context_window (413) error
262
+ // means the payload is too big — retrying the same payload is the quota
263
+ // burn this fixes. On the FIRST such error we run the published emergency
264
+ // offloader (deterministic size-driven shrink of the live session's largest
265
+ // toolResults) and retry EXACTLY ONCE with the shrunk context. Never a
266
+ // second emergency retry in one callLlm invocation: if the shrunk payload
267
+ // still 413s, the error propagates (compaction/rotation owns the next move).
268
+ let emergencyRetryUsed = false;
269
+ try {
270
+ for (let attempt = 1; attempt <= maxRetries + 1; attempt++) {
271
+ // ── circuit breaker re-check inside retry loop ──
272
+ if (rateLimitCooldownUntil > 0 && Date.now() < rateLimitCooldownUntil) {
273
+ log.warn(`Skipping retry ${attempt} - rate-limit cooldown active`);
274
+ return { error: "Rate-limit cooldown active" };
275
+ }
276
+ // ── ESC check: if the external signal already fired (e.g. during
277
+ // backoff sleep), don't attempt another call. Without this, the
278
+ // retry loop continues after abortable sleep resolves early, but
279
+ // combineSignals returns only the timeout signal (s1 already
280
+ // aborted -> returns s2), so the next attempt hangs until timeout.
281
+ if (signal?.aborted) {
282
+ log.debug("LLM call aborted (signal fired before retry attempt)");
283
+ return { error: "Request was aborted" };
284
+ }
285
+ // Use AbortSignal for timeout instead of Promise.race - avoids orphaned timer
286
+ const timeoutController = new AbortController();
287
+ const timeoutId = setTimeout(() => timeoutController.abort(new Error("LLM call timeout")), timeoutMs);
288
+ // Combine external signal with timeout signal
289
+ const combinedSignal = signal
290
+ ? combineSignals(signal, timeoutController.signal)
291
+ : timeoutController.signal;
292
+ // Helper: clean up timeout + combined signal listeners after
293
+ // each attempt. Aborting timeoutController triggers combineSignals'
294
+ // built-in listener removal (onAbort removes itself from both
295
+ // parent signals). Without this, stale listeners accumulate on
296
+ // the external signal across retries -- a listener leak.
297
+ const cleanupAttempt = () => {
298
+ clearTimeout(timeoutId);
299
+ // Abort the timeout controller to trigger combineSignals cleanup.
300
+ // The combined controller is already abandoned (we have the result),
301
+ // so aborting it is harmless.
302
+ if (!timeoutController.signal.aborted) {
303
+ timeoutController.abort();
304
+ }
305
+ };
306
+ try {
307
+ // Build the options object explicitly: `reasoning` is typed as the
308
+ // SDK's ModelThinkingLevel (which includes "off") and crosses into
309
+ // the registry's streamSimple through the single cast in
310
+ // toSimpleStreamOptions.
311
+ //
312
+ // We always pass the reasoning value when set, including "off" -
313
+ // pi-ai's clampThinkingLevel takes "off" and maps it (off if the
314
+ // model supports it, else the lowest available level like "minimal").
315
+ const simpleOptions = {
316
+ apiKey,
317
+ maxTokens,
318
+ temperature,
319
+ maxRetries: sdkMaxRetries,
320
+ signal: combinedSignal,
321
+ };
322
+ if (options.reasoning !== undefined) {
323
+ simpleOptions.reasoning = options.reasoning;
324
+ }
325
+ const sessionId = resolveSessionId();
326
+ if (sessionId !== undefined) {
327
+ simpleOptions.sessionId = sessionId;
328
+ }
329
+ const result = await _resolveCompletion()(model, context, toSimpleStreamOptions(simpleOptions));
330
+ cleanupAttempt();
331
+ if (result.errorMessage) {
332
+ // Raw text drives classification and the key-ring feed-back below;
333
+ // the sanitized copy is what log lines and the caller see, so raw
334
+ // HTTP block pages never reach either. See payload-hygiene.ts.
335
+ const rawError = result.errorMessage;
336
+ const safeError = sanitizeLlmErrorForLog(rawError);
337
+ // ── emergency size-driven offload on 413 ──
338
+ // The error classifier says context_window → the payload is too
339
+ // big and shrinking it is the ONLY useful action. Run the
340
+ // published emergency offloader (bypasses the health-gate by
341
+ // construction: this path never consults SessionHealthState) and
342
+ // retry exactly once. Consumer without the context-manager loaded
343
+ // (runner or ctx provider absent) → fall through to the normal
344
+ // error path, lossy-safe.
345
+ if (!emergencyRetryUsed && isContextWindowErrorText(rawError)) {
346
+ emergencyRetryUsed = true;
347
+ const offloadResult = await runEmergencyOffloadForCall();
348
+ if (offloadResult > 0) {
349
+ log.warn(`LLM context-window error (413); emergency offload shrank the ` +
350
+ `context (${offloadResult} oversized toolResult(s) stubbed) — ` +
351
+ `retrying once with the shrunken payload`);
352
+ cleanupAttempt();
353
+ attempt--; // do not burn a retry-ladder slot on the shrink
354
+ continue;
355
+ }
356
+ emergencyRetryUsed = false; // nothing shrank — do not block a later retry
357
+ }
358
+ if (attempt <= maxRetries && isTransientError(rawError)) {
359
+ const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
360
+ log.warn(`LLM transient error (attempt ${attempt}/${maxRetries + 1}), ` +
361
+ `retrying in ${delay}ms: ${safeError}`);
362
+ if (isRateLimitError(rawError)) {
363
+ rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
364
+ }
365
+ // Pass signal so ESC during backoff aborts the retry
366
+ // instead of letting it fire after the delay.
367
+ await sleep(delay, signal);
368
+ continue;
369
+ }
370
+ // Non-retryable or exhausted - log and return
371
+ if (isRateLimitError(rawError)) {
372
+ rateLimitCooldownUntil = Date.now() + RATE_LIMIT_COOLDOWN_MS;
373
+ log.warn(`LLM rate-limited, giving up (cooldown ${RATE_LIMIT_COOLDOWN_MS}ms): ${safeError}`);
374
+ }
375
+ else if (
376
+ // Demote "Request was aborted" to debug when caused by the
377
+ // caller's external signal (ESC, session shutdown). These
378
+ // are expected cancellations, not real errors. Without
379
+ // this gate, the user sees an ERROR line every time they
380
+ // press ESC during a turn that had braid LLM calls in
381
+ // flight (consolidation, classify, sop-extract, etc.).
382
+ //
383
+ // The distinguishing signal is `signal.aborted` - it becomes
384
+ // true when EITHER the timeout fires OR the external signal
385
+ // fires. We can't tell them apart from `result.errorMessage`
386
+ // alone (pi-ai returns "Request was aborted" for both), so
387
+ // we check the original external signal: if it was set and
388
+ // is now aborted, this is a user-driven cancellation.
389
+ //
390
+ // Universal fallback: if the error message contains
391
+ // "abort" (any case) we also demote to debug. This covers
392
+ // post-loop callers (heartbeat, context-hygiene) where
393
+ // ctx.signal is undefined and the only abort source is
394
+ // the timeout itself firing under session-end load - the
395
+ // user didn't ask for that to be logged at ERROR.
396
+ signal?.aborted === true ||
397
+ /abort/i.test(rawError)) {
398
+ log.debug(`LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeError})`);
399
+ }
400
+ else {
401
+ log.error("LLM error:", safeError);
402
+ }
403
+ // Notify listener (Layer 2 wiring) - non-fatal if it throws.
404
+ try {
405
+ // The session-health listener classifies the RAW text — a
406
+ // sanitized page would lose its rate-limit/edge category.
407
+ getLlmErrorListener()?.(rawError);
408
+ }
409
+ catch {
410
+ // non-fatal
411
+ }
412
+ // Feed the failure back into the key ring that owns this model so a
413
+ // direct (non-message_end) 429/403 exhausts + rotates the same way
414
+ // handleMessageEnd does. No-op when providers hasn't
415
+ // published a handler or the model is foreign (lossy-safe).
416
+ // Same for the key ring: its WAF/rotation classifier needs the raw
417
+ // markup markers ("cf-ray", "<html", …) the sanitizer removes.
418
+ reportLlmFailureToKeyRing(model, rawError);
419
+ return { error: safeError };
420
+ }
421
+ // Success - extract text content
422
+ const textContent = result.content.filter((c) => c.type === "text");
423
+ const text = textContent.length > 0 ? textContent[0].text : "";
424
+ // Notify listener (Layer 2 wiring) - non-fatal if the listener throws.
425
+ try {
426
+ getLlmSuccessListener()?.();
427
+ }
428
+ catch {
429
+ // non-fatal
430
+ }
431
+ // Feed the success back so the serving key's backoff is healed.
432
+ reportLlmSuccessToKeyRing(model);
433
+ // Surface stopReason and usage so callers can diagnose empty
434
+ // responses (e.g. "stopReason=length" means the model hit the
435
+ // max_tokens ceiling, which is why the response is empty).
436
+ // pi-ai's Usage has fields { input, output, totalTokens, ... }
437
+ // (not { inputTokens, outputTokens }) - the field names below
438
+ // mirror the upstream type.
439
+ //
440
+ // Telemetry note (investigation): direct calls never pass
441
+ // through pi-core's message pipeline, so this usage is returned
442
+ // to the caller and has NO session-JSONL feed — all-zero usage
443
+ // entries in session files are error-path zero-fills from failed
444
+ // agent-loop requests (stopReason: "error", e.g. "Connection
445
+ // error."), not unparsed direct-call usage. Verified:
446
+ // 94/94 zero-usage entries across 22 sessions were error markers.
447
+ return {
448
+ text,
449
+ stopReason: result.stopReason,
450
+ usage: result.usage
451
+ ? {
452
+ input: result.usage.input,
453
+ output: result.usage.output,
454
+ totalTokens: result.usage.totalTokens,
455
+ }
456
+ : undefined,
457
+ };
458
+ }
459
+ catch (err) {
460
+ cleanupAttempt();
461
+ const message = err instanceof Error ? err.message : String(err);
462
+ const safeMessage = sanitizeLlmErrorForLog(message);
463
+ const isTimeout = message.includes("timeout") ||
464
+ message.includes("Timed") ||
465
+ (err instanceof Error && err.name === "AbortError");
466
+ // ── same emergency-offload exception as the
467
+ // result.errorMessage path above — provider SDKs that THROW on 413
468
+ // (instead of returning errorMessage) must get the same one-time
469
+ // shrink + retry, or the quota-burn loop survives in that shape.
470
+ if (!emergencyRetryUsed && isContextWindowErrorText(message)) {
471
+ emergencyRetryUsed = true;
472
+ const offloadResult = await runEmergencyOffloadForCall();
473
+ if (offloadResult > 0) {
474
+ log.warn(`LLM context-window error (413); emergency offload shrank the ` +
475
+ `context (${offloadResult} oversized toolResult(s) stubbed) — ` +
476
+ `retrying once with the shrunken payload`);
477
+ attempt--; // do not burn a retry-ladder slot on the shrink
478
+ continue;
479
+ }
480
+ emergencyRetryUsed = false; // nothing shrank — do not block a later retry
481
+ }
482
+ if (attempt <= maxRetries && (isTimeout || isTransientError(message))) {
483
+ const delay = Math.min(backoffDelay(attempt), MAX_RETRY_BACKOFF_MS);
484
+ log.warn(`LLM error (attempt ${attempt}/${maxRetries + 1}), ` +
485
+ `retrying in ${delay}ms: ${safeMessage}`);
486
+ // Pass signal so ESC during backoff aborts the retry.
487
+ await sleep(delay, signal);
488
+ continue;
489
+ }
490
+ // Demote to debug when an external signal (ESC / session shutdown)
491
+ // caused the abort, OR when the message is itself an abort
492
+ // (covered by the universal /abort/i fallback in the
493
+ // result.errorMessage branch above). This matches the
494
+ // demotion there. Without this, the catch path still emits
495
+ // ERROR lines for expected cancellations and post-loop
496
+ // timeouts fired under session-end load.
497
+ if (signal?.aborted === true || /abort/i.test(message)) {
498
+ log.debug(`LLM call aborted (signal=${signal ? "set" : "unset"}, message=${safeMessage})`);
499
+ }
500
+ else {
501
+ log.error(isTimeout
502
+ ? `LLM call timed out after ${maxRetries + 1} attempts`
503
+ : `LLM call failed: ${safeMessage}`);
504
+ }
505
+ // Notify listener (Layer 2 wiring) - non-fatal if it throws.
506
+ try {
507
+ getLlmErrorListener()?.(message);
508
+ }
509
+ catch {
510
+ // non-fatal
511
+ }
512
+ // Feed the failure back into the key ring — same seam as the
513
+ // result.errorMessage path above (raw text for the same reason).
514
+ reportLlmFailureToKeyRing(model, message);
515
+ return { error: safeMessage };
516
+ }
517
+ }
518
+ return { error: `LLM call failed after ${maxRetries + 1} attempts` };
519
+ }
520
+ finally {
521
+ releaseModelSlot(model.id);
522
+ }
523
+ }
524
+ // ── Helpers ────────────────────────────────────────────────────────────────────
525
+ /**
526
+ * Run the published emergency offloader (context-manager's
527
+ * context-emergency.ts) against the current session context. Lossy-safe:
528
+ * when the runner or ctx provider has not been published (extension not
529
+ * loaded), or either throws, this returns 0 — the caller then takes the
530
+ * normal error path. Returns the number of oversized toolResults stubbed
531
+ * (0 = nothing shrank — the caller must NOT retry).
532
+ */
533
+ function runEmergencyOffloadForCall() {
534
+ const runner = getContextEmergencyOffloadRunner();
535
+ const provider = getExtensionCtxProvider();
536
+ if (!runner || !provider)
537
+ return Promise.resolve(0);
538
+ let ctx;
539
+ try {
540
+ ctx = provider();
541
+ }
542
+ catch {
543
+ return Promise.resolve(0);
544
+ }
545
+ if (!ctx)
546
+ return Promise.resolve(0);
547
+ return Promise.resolve(runner(ctx, "llm-retry")).then((r) => (r && r.offloaded > 0 ? r.offloaded : 0), () => 0);
548
+ }
549
+ /**
550
+ * Feed a failed callLlm back into the key ring that owns this model, so a
551
+ * direct (non-message_end) 429/403 exhausts + rotates instead of leaving no
552
+ * trace in the ring. The providers extension publishes a handler
553
+ * into a process-global slot at load; with no handler registered (e.g. the
554
+ * providers extension isn't loaded) this is a silent no-op — lossy-safe.
555
+ * Attribution is per-call (this model's own id/provider); the handler resolves
556
+ * the owning ring, so two providers' rings can never be confused.
557
+ */
558
+ function reportLlmFailureToKeyRing(model, errText) {
559
+ const handler = getKeyRingFeedbackHandler();
560
+ if (!handler)
561
+ return;
562
+ try {
563
+ handler.reportFailure(model.id, model.provider, String(errText ?? ""));
564
+ }
565
+ catch {
566
+ // non-fatal — the ring must never break an LLM call
567
+ }
568
+ }
569
+ /**
570
+ * Feed a successful callLlm back so the serving key's backoff is healed
571
+ * (mirrors handleMessageEnd's success path). No-op when no handler is
572
+ * published, and the handler itself skips foreign models / healthy keys.
573
+ */
574
+ function reportLlmSuccessToKeyRing(model) {
575
+ const handler = getKeyRingFeedbackHandler();
576
+ if (!handler)
577
+ return;
578
+ try {
579
+ handler.reportSuccess(model.id, model.provider);
580
+ }
581
+ catch {
582
+ // non-fatal
583
+ }
584
+ }
585
+ /**
586
+ * (provider, model) pairs whose unusable answer was already reported this
587
+ * process. Bounded by the route table times the model ids in play, and cleared
588
+ * when the module is re-evaluated (/reload), which is the sense in which the
589
+ * notice is once per process.
590
+ */
591
+ const reportedUnusableModels = new Set();
592
+ /**
593
+ * The skip notice, once per (provider, model) per process, through the same
594
+ * log channel every other auxiliary-call diagnostic uses. Repeats are silent,
595
+ * so a session that keeps re-resolving an unusable model writes one line.
596
+ */
597
+ function reportUnusableModelOnce(model) {
598
+ const provider = model.provider ?? "unknown";
599
+ const key = `${provider}/${model.id}`;
600
+ if (reportedUnusableModels.has(key))
601
+ return;
602
+ reportedUnusableModels.add(key);
603
+ log.info(`Skipping auxiliary model ${provider}/${model.id}: the provider reports it ` +
604
+ `unusable right now (no usable key, or a request it just rejected).`);
605
+ }
606
+ /**
607
+ * The one yes/no question core asks the providers seam before re-using a
608
+ * (provider, model) pair for an auxiliary call: can this pair serve a request
609
+ * right now? The handler owns the answer, so core learns no route vocabulary:
610
+ * it asks and skips, it does not interpret.
611
+ *
612
+ * Fail-open by construction: with nothing published, no query method, or a
613
+ * throwing query, the answer is true, so auxiliary calls behave exactly as they
614
+ * did before the seam existed. A false answer is reported once.
615
+ */
616
+ export function isModelRouteUsable(model) {
617
+ const handler = getKeyRingFeedbackHandler();
618
+ const query = handler && handler.routeUsable;
619
+ if (typeof query !== "function")
620
+ return true;
621
+ let usable;
622
+ try {
623
+ usable =
624
+ query.call(handler, model.id, model.provider) !== false;
625
+ }
626
+ catch {
627
+ return true; // the seam must never break an auxiliary call
628
+ }
629
+ if (!usable)
630
+ reportUnusableModelOnce(model);
631
+ return usable;
632
+ }
633
+ /**
634
+ * Combine two AbortSignals into one. When either signal aborts, the combined signal aborts.
635
+ *
636
+ * If either parent signal is already aborted, returns just the *other* signal unmodified
637
+ * rather than creating an immediately-aborted controller. This prevents stale external
638
+ * signals (e.g. from timed-out tool executions) from instant-killing the combined signal
639
+ * on retry.
640
+ *
641
+ * Cleans up event listeners after the combined signal fires to prevent memory leaks
642
+ * across repeated calls (e.g. retry loops creating new combined signals).
643
+ *
644
+ * @internal Exported for behavioral testing (test-call-llm-behavior.mjs).
645
+ * Production code should not call this directly.
646
+ */
647
+ export function combineSignals(s1, s2) {
648
+ // If either signal is already dead, just return the other - combining into an
649
+ // already-aborted signal is a no-op that would only propagate the stale abort.
650
+ if (s1.aborted)
651
+ return s2;
652
+ if (s2.aborted)
653
+ return s1;
654
+ const controller = new AbortController();
655
+ const onAbort = () => {
656
+ controller.abort();
657
+ s1.removeEventListener("abort", onAbort);
658
+ s2.removeEventListener("abort", onAbort);
659
+ };
660
+ s1.addEventListener("abort", onAbort);
661
+ s2.addEventListener("abort", onAbort);
662
+ return controller.signal;
663
+ }
664
+ /** Detect errors that are worth retrying. */
665
+ function isTransientError(message) {
666
+ return isRateLimitError(message) || matchesTransientOnly(message);
667
+ }
668
+ /**
669
+ * Check if an error message indicates a rate-limit condition specifically.
670
+ * Delegates to the canonical patterns in lib/errors/llm-error.ts (dedupe:
671
+ * the former local substring list had drifted — no "429"-anywhere, no
672
+ * "rate_limit"/"too_many_requests" underscore forms, no "throttle/-ing").
673
+ */
674
+ function isRateLimitError(message) {
675
+ return isRateLimitText(message);
676
+ }
677
+ /** Patterns that indicate transient failure but not rate-limit. */
678
+ const TRANSIENT_ONLY_PATTERNS = [
679
+ "overloaded",
680
+ "service unavailable",
681
+ "temporarily",
682
+ "try again later",
683
+ "please retry",
684
+ "network connection lost",
685
+ "upstream connect",
686
+ "connection refused",
687
+ ];
688
+ const TRANSIENT_ONLY_CODES = ["529", "502", "503", "504"];
689
+ function matchesTransientOnly(message) {
690
+ if (TRANSIENT_ONLY_CODES.some((code) => message.startsWith(code)))
691
+ return true;
692
+ const lower = message.toLowerCase();
693
+ return TRANSIENT_ONLY_PATTERNS.some((p) => lower.includes(p));
694
+ }
695
+ /**
696
+ * Compute exponential backoff delay.
697
+ * attempt 1 -> 5s, attempt 2 -> 15s, attempt 3 -> 30s, attempt 4 -> 60s
698
+ * With +/-20% jitter. Capped at 60s.
699
+ */
700
+ /**
701
+ * Cast our locally-typed `simpleOptions` to the options shape the registry's
702
+ * `streamSimple` expects.
703
+ *
704
+ * Why this exists: `reasoning` is typed `ModelThinkingLevel`, which includes
705
+ * "off", while the SDK's stream-options `ThinkingLevel` does not list it.
706
+ * pi-ai's runtime takes "off" and maps it (off if the model supports it,
707
+ * else the lowest available level like "minimal"), so the value is sound at
708
+ * runtime. One helper keeps the boundary explicit and findable; when the
709
+ * SDK's stream-options type gains "off", this becomes an identity cast.
710
+ */
711
+ function toSimpleStreamOptions(opts) {
712
+ return opts;
713
+ }
714
+ function backoffDelay(attempt) {
715
+ const delays = [5_000, 15_000, 30_000, 60_000];
716
+ const base = delays[Math.min(attempt - 1, delays.length - 1)];
717
+ const jitter = Math.round(base * (0.8 + Math.random() * 0.4));
718
+ return Math.min(jitter, 60_000);
719
+ }
720
+ /**
721
+ * Abortable sleep. Resolves immediately if signal fires during the wait.
722
+ *
723
+ * Without this, pressing ESC during a retry backoff (5-60s) would
724
+ * leave the sleep running -- the retry would fire after the backoff,
725
+ * then hang until the new timeout fires. The signal was only checked
726
+ * at the next combineSignals call, not during the backoff itself.
727
+ */
728
+ function sleep(ms, signal) {
729
+ if (!signal)
730
+ return new Promise((r) => setTimeout(r, ms));
731
+ if (signal.aborted)
732
+ return Promise.resolve();
733
+ return new Promise((resolve) => {
734
+ const timer = setTimeout(() => {
735
+ signal.removeEventListener("abort", onAbort);
736
+ resolve();
737
+ }, ms);
738
+ const onAbort = () => {
739
+ clearTimeout(timer);
740
+ resolve();
741
+ };
742
+ signal.addEventListener("abort", onAbort, { once: true });
743
+ });
744
+ }
745
+ //# sourceMappingURL=llm-call.js.map