pi-braid 0.0.0-stage → 0.40.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1011) hide show
  1. package/AGENTS.md +195 -0
  2. package/CONTRIBUTING.md +302 -0
  3. package/LICENSE +21 -0
  4. package/README.md +260 -2
  5. package/TOOLS.md +147 -0
  6. package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
  7. package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
  8. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
  9. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
  10. package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
  11. package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
  12. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
  13. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
  14. package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
  15. package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
  16. package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
  17. package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
  18. package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
  19. package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
  20. package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
  21. package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
  22. package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
  23. package/dist/extensions/cognitive/metacognition/index.js +90 -0
  24. package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
  25. package/dist/extensions/cognitive/reasoning/index.js +99 -0
  26. package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
  27. package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
  28. package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
  29. package/dist/extensions/cognitive/topic-drift/index.js +346 -0
  30. package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
  31. package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
  32. package/dist/extensions/context-management/index.d.ts +77 -0
  33. package/dist/extensions/context-management/index.js +339 -0
  34. package/dist/extensions/core/agent-environment/index.d.ts +30 -0
  35. package/dist/extensions/core/agent-environment/index.js +89 -0
  36. package/dist/extensions/core/polyfill/index.d.ts +28 -0
  37. package/dist/extensions/core/polyfill/index.js +474 -0
  38. package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
  39. package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
  40. package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
  41. package/dist/extensions/core/prompt-builder/context-section.js +101 -0
  42. package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
  43. package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
  44. package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
  45. package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
  46. package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
  47. package/dist/extensions/core/prompt-builder/identity.js +77 -0
  48. package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
  49. package/dist/extensions/core/prompt-builder/index.js +496 -0
  50. package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
  51. package/dist/extensions/core/prompt-builder/inspect.js +182 -0
  52. package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
  53. package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
  54. package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
  55. package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
  56. package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
  57. package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
  58. package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
  59. package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
  60. package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
  61. package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
  62. package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
  63. package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
  64. package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
  65. package/dist/extensions/core/prompt-builder/section.js +127 -0
  66. package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
  67. package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
  68. package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
  69. package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
  70. package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
  71. package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
  72. package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
  73. package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
  74. package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
  75. package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
  76. package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
  77. package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
  78. package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
  79. package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
  80. package/dist/extensions/core/skills-tool/index.d.ts +56 -0
  81. package/dist/extensions/core/skills-tool/index.js +200 -0
  82. package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
  83. package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
  84. package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
  85. package/dist/extensions/core/skills-tool/session-records.js +268 -0
  86. package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
  87. package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
  88. package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
  89. package/dist/extensions/enforcement/detection/malformed.js +30 -0
  90. package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
  91. package/dist/extensions/enforcement/detection/verification.js +34 -0
  92. package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
  93. package/dist/extensions/enforcement/enforcement-types.js +24 -0
  94. package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
  95. package/dist/extensions/enforcement/handler-registry.js +196 -0
  96. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
  97. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
  98. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
  99. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
  100. package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
  101. package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
  102. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
  103. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
  104. package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
  105. package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
  106. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
  107. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
  108. package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
  109. package/dist/extensions/enforcement/handlers/blocking.js +33 -0
  110. package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
  111. package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
  112. package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
  113. package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
  114. package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
  115. package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
  116. package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
  117. package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
  118. package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
  119. package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
  120. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
  121. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
  122. package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
  123. package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
  124. package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
  125. package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
  126. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
  127. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
  128. package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
  129. package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
  130. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
  131. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
  132. package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
  133. package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
  134. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
  135. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
  136. package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
  137. package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
  138. package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
  139. package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
  140. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
  141. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
  142. package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
  143. package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
  144. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
  145. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
  146. package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
  147. package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
  148. package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
  149. package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
  150. package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
  151. package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
  152. package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
  153. package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
  154. package/dist/extensions/enforcement/index.d.ts +15 -0
  155. package/dist/extensions/enforcement/index.js +22 -0
  156. package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
  157. package/dist/extensions/enforcement/judge-utils.js +83 -0
  158. package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
  159. package/dist/extensions/enforcement/nudge-manager.js +203 -0
  160. package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
  161. package/dist/extensions/enforcement/self-state-claims.js +167 -0
  162. package/dist/extensions/enforcement/session-health.d.ts +107 -0
  163. package/dist/extensions/enforcement/session-health.js +251 -0
  164. package/dist/extensions/enforcement/signals.d.ts +54 -0
  165. package/dist/extensions/enforcement/signals.js +47 -0
  166. package/dist/extensions/enforcement/similarity.d.ts +16 -0
  167. package/dist/extensions/enforcement/similarity.js +64 -0
  168. package/dist/extensions/enforcement/state.d.ts +40 -0
  169. package/dist/extensions/enforcement/state.js +74 -0
  170. package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
  171. package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
  172. package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
  173. package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
  174. package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
  175. package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
  176. package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
  177. package/dist/extensions/enforcement/substate/session-state.js +45 -0
  178. package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
  179. package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
  180. package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
  181. package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
  182. package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
  183. package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
  184. package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
  185. package/dist/extensions/enforcement/task-evidence.js +335 -0
  186. package/dist/extensions/enforcement/types.d.ts +35 -0
  187. package/dist/extensions/enforcement/types.js +5 -0
  188. package/dist/extensions/enforcement/validation.d.ts +12 -0
  189. package/dist/extensions/enforcement/validation.js +151 -0
  190. package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
  191. package/dist/extensions/enforcement/verification-judge.js +214 -0
  192. package/dist/extensions/enforcement/whisper.d.ts +46 -0
  193. package/dist/extensions/enforcement/whisper.js +104 -0
  194. package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
  195. package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
  196. package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
  197. package/dist/extensions/heartbeat/analytics/core.js +201 -0
  198. package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
  199. package/dist/extensions/heartbeat/analytics/format.js +111 -0
  200. package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
  201. package/dist/extensions/heartbeat/analytics/index.js +352 -0
  202. package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
  203. package/dist/extensions/heartbeat/analytics/shared.js +69 -0
  204. package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
  205. package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
  206. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
  207. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
  208. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
  209. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
  210. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
  211. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
  212. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
  213. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
  214. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
  215. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
  216. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
  217. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
  218. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
  219. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
  220. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
  221. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
  222. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
  223. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
  224. package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
  225. package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
  226. package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
  227. package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
  228. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
  229. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
  230. package/dist/extensions/manifest.d.ts +32 -0
  231. package/dist/extensions/manifest.js +251 -0
  232. package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
  233. package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
  234. package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
  235. package/dist/extensions/memory/context-lifecycle/index.js +977 -0
  236. package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
  237. package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
  238. package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
  239. package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
  240. package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
  241. package/dist/extensions/memory/context-lifecycle/state.js +90 -0
  242. package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
  243. package/dist/extensions/memory/context-lifecycle/types.js +273 -0
  244. package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
  245. package/dist/extensions/memory/context-manager/analysis.js +264 -0
  246. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
  247. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
  248. package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
  249. package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
  250. package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
  251. package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
  252. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
  253. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
  254. package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
  255. package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
  256. package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
  257. package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
  258. package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
  259. package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
  260. package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
  261. package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
  262. package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
  263. package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
  264. package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
  265. package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
  266. package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
  267. package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
  268. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
  269. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
  270. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
  271. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
  272. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
  273. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
  274. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
  275. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
  276. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
  277. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
  278. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
  279. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
  280. package/dist/extensions/memory/context-manager/index.d.ts +3 -0
  281. package/dist/extensions/memory/context-manager/index.js +88 -0
  282. package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
  283. package/dist/extensions/memory/context-manager/pruning.js +406 -0
  284. package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
  285. package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
  286. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
  287. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
  288. package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
  289. package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
  290. package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
  291. package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
  292. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
  293. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
  294. package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
  295. package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
  296. package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
  297. package/dist/extensions/memory/scratchpad/format.js +135 -0
  298. package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
  299. package/dist/extensions/memory/scratchpad/handlers.js +469 -0
  300. package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
  301. package/dist/extensions/memory/scratchpad/index.js +168 -0
  302. package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
  303. package/dist/extensions/memory/scratchpad/persistence.js +343 -0
  304. package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
  305. package/dist/extensions/memory/scratchpad/types.js +8 -0
  306. package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
  307. package/dist/extensions/memory/scratchpad/utils.js +236 -0
  308. package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
  309. package/dist/extensions/memory/session-recall/analyze.js +478 -0
  310. package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
  311. package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
  312. package/dist/extensions/memory/session-recall/index.d.ts +29 -0
  313. package/dist/extensions/memory/session-recall/index.js +820 -0
  314. package/dist/extensions/memory/session-recall/query.d.ts +15 -0
  315. package/dist/extensions/memory/session-recall/query.js +38 -0
  316. package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
  317. package/dist/extensions/memory/session-recall/rank.js +85 -0
  318. package/dist/extensions/memory/session-recall/search.d.ts +159 -0
  319. package/dist/extensions/memory/session-recall/search.js +682 -0
  320. package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
  321. package/dist/extensions/memory/session-recall/stats.js +67 -0
  322. package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
  323. package/dist/extensions/memory/session-recall/text-utils.js +184 -0
  324. package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
  325. package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
  326. package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
  327. package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
  328. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
  329. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
  330. package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
  331. package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
  332. package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
  333. package/dist/extensions/memory/three-memory-stores/index.js +436 -0
  334. package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
  335. package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
  336. package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
  337. package/dist/extensions/memory/three-memory-stores/types.js +2 -0
  338. package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
  339. package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
  340. package/dist/extensions/orchestrator/index.d.ts +19 -0
  341. package/dist/extensions/orchestrator/index.js +796 -0
  342. package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
  343. package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
  344. package/dist/extensions/scheduling/timer/index.d.ts +102 -0
  345. package/dist/extensions/scheduling/timer/index.js +1143 -0
  346. package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
  347. package/dist/extensions/scheduling/timer/poller.js +135 -0
  348. package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
  349. package/dist/extensions/scheduling/timer/recovery.js +445 -0
  350. package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
  351. package/dist/extensions/scheduling/timer/store-file.js +59 -0
  352. package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
  353. package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
  354. package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
  355. package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
  356. package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
  357. package/dist/extensions/self/auto-recovery/index.js +89 -0
  358. package/dist/extensions/self/error-tracking/index.d.ts +3 -0
  359. package/dist/extensions/self/error-tracking/index.js +244 -0
  360. package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
  361. package/dist/extensions/self/health-maintenance/format.js +60 -0
  362. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
  363. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
  364. package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
  365. package/dist/extensions/self/health-maintenance/helpers.js +67 -0
  366. package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
  367. package/dist/extensions/self/health-maintenance/index.js +238 -0
  368. package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
  369. package/dist/extensions/self/health-maintenance/types.js +2 -0
  370. package/dist/extensions/self/latent-activator/index.d.ts +12 -0
  371. package/dist/extensions/self/latent-activator/index.js +173 -0
  372. package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
  373. package/dist/extensions/self/latent-activator/mixes.js +20 -0
  374. package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
  375. package/dist/extensions/self/latent-activator/signals.js +228 -0
  376. package/dist/extensions/self/latent-activator/state.d.ts +43 -0
  377. package/dist/extensions/self/latent-activator/state.js +59 -0
  378. package/dist/extensions/self/latent-activator/types.d.ts +8 -0
  379. package/dist/extensions/self/latent-activator/types.js +8 -0
  380. package/dist/extensions/self/watchdog/config.d.ts +4 -0
  381. package/dist/extensions/self/watchdog/config.js +79 -0
  382. package/dist/extensions/self/watchdog/engine.d.ts +256 -0
  383. package/dist/extensions/self/watchdog/engine.js +935 -0
  384. package/dist/extensions/self/watchdog/index.d.ts +23 -0
  385. package/dist/extensions/self/watchdog/index.js +485 -0
  386. package/dist/index.d.ts +25 -0
  387. package/dist/index.js +81 -0
  388. package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
  389. package/dist/lib/ai/consolidated-claim-critic.js +191 -0
  390. package/dist/lib/ai/cost-report.d.ts +83 -0
  391. package/dist/lib/ai/cost-report.js +116 -0
  392. package/dist/lib/ai/critic-cache.d.ts +57 -0
  393. package/dist/lib/ai/critic-cache.js +100 -0
  394. package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
  395. package/dist/lib/ai/critic-fallbacks.js +75 -0
  396. package/dist/lib/ai/critic-gate.d.ts +75 -0
  397. package/dist/lib/ai/critic-gate.js +81 -0
  398. package/dist/lib/ai/critic-helpers.d.ts +26 -0
  399. package/dist/lib/ai/critic-helpers.js +131 -0
  400. package/dist/lib/ai/critic-registry.d.ts +417 -0
  401. package/dist/lib/ai/critic-registry.js +639 -0
  402. package/dist/lib/ai/critic-stats.d.ts +78 -0
  403. package/dist/lib/ai/critic-stats.js +90 -0
  404. package/dist/lib/ai/judge-budget.d.ts +138 -0
  405. package/dist/lib/ai/judge-budget.js +143 -0
  406. package/dist/lib/ai/language-hint.d.ts +21 -0
  407. package/dist/lib/ai/language-hint.js +58 -0
  408. package/dist/lib/ai/llm-call.d.ts +141 -0
  409. package/dist/lib/ai/llm-call.js +745 -0
  410. package/dist/lib/ai/model-resolver.d.ts +90 -0
  411. package/dist/lib/ai/model-resolver.js +185 -0
  412. package/dist/lib/ai/models-init.d.ts +46 -0
  413. package/dist/lib/ai/models-init.js +65 -0
  414. package/dist/lib/ai/payload-hygiene.d.ts +74 -0
  415. package/dist/lib/ai/payload-hygiene.js +240 -0
  416. package/dist/lib/ai/post-loop-classify.d.ts +128 -0
  417. package/dist/lib/ai/post-loop-classify.js +87 -0
  418. package/dist/lib/ai/text-classifier.d.ts +142 -0
  419. package/dist/lib/ai/text-classifier.js +548 -0
  420. package/dist/lib/cognitive/hints.d.ts +33 -0
  421. package/dist/lib/cognitive/hints.js +223 -0
  422. package/dist/lib/cognitive/openspec.d.ts +29 -0
  423. package/dist/lib/cognitive/openspec.js +108 -0
  424. package/dist/lib/config/braid-paths.d.ts +188 -0
  425. package/dist/lib/config/braid-paths.js +340 -0
  426. package/dist/lib/config/braid-settings.d.ts +489 -0
  427. package/dist/lib/config/braid-settings.js +938 -0
  428. package/dist/lib/config/per-tool-settings.d.ts +95 -0
  429. package/dist/lib/config/per-tool-settings.js +161 -0
  430. package/dist/lib/config/session-profiles.d.ts +68 -0
  431. package/dist/lib/config/session-profiles.js +143 -0
  432. package/dist/lib/constants/injection-details.d.ts +30 -0
  433. package/dist/lib/constants/injection-details.js +30 -0
  434. package/dist/lib/constants/session-thresholds.d.ts +42 -0
  435. package/dist/lib/constants/session-thresholds.js +54 -0
  436. package/dist/lib/constants/tool-constants.d.ts +11 -0
  437. package/dist/lib/constants/tool-constants.js +12 -0
  438. package/dist/lib/core/event-names.d.ts +23 -0
  439. package/dist/lib/core/event-names.js +26 -0
  440. package/dist/lib/core/logger.d.ts +102 -0
  441. package/dist/lib/core/logger.js +274 -0
  442. package/dist/lib/detection/compression-strategy.d.ts +38 -0
  443. package/dist/lib/detection/compression-strategy.js +147 -0
  444. package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
  445. package/dist/lib/detection/consolidated-topic-critic.js +132 -0
  446. package/dist/lib/detection/context-density.d.ts +70 -0
  447. package/dist/lib/detection/context-density.js +193 -0
  448. package/dist/lib/detection/context-thresholds.d.ts +88 -0
  449. package/dist/lib/detection/context-thresholds.js +107 -0
  450. package/dist/lib/detection/context-tiers.d.ts +80 -0
  451. package/dist/lib/detection/context-tiers.js +144 -0
  452. package/dist/lib/detection/context-usage.d.ts +75 -0
  453. package/dist/lib/detection/context-usage.js +209 -0
  454. package/dist/lib/detection/degradation-detector.d.ts +74 -0
  455. package/dist/lib/detection/degradation-detector.js +454 -0
  456. package/dist/lib/detection/test-burst.d.ts +77 -0
  457. package/dist/lib/detection/test-burst.js +126 -0
  458. package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
  459. package/dist/lib/detection/tool-loop-detector.js +302 -0
  460. package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
  461. package/dist/lib/detection/topic-drift-detector.js +252 -0
  462. package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
  463. package/dist/lib/enforcement/adherence-meter.js +420 -0
  464. package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
  465. package/dist/lib/enforcement/turn-dedup.js +195 -0
  466. package/dist/lib/errors/llm-error.d.ts +79 -0
  467. package/dist/lib/errors/llm-error.js +241 -0
  468. package/dist/lib/events/consolidation-channel.d.ts +109 -0
  469. package/dist/lib/events/consolidation-channel.js +374 -0
  470. package/dist/lib/events/consolidation-scoring.d.ts +59 -0
  471. package/dist/lib/events/consolidation-scoring.js +95 -0
  472. package/dist/lib/events/event-bus.d.ts +123 -0
  473. package/dist/lib/events/event-bus.js +108 -0
  474. package/dist/lib/events/event-types.d.ts +39 -0
  475. package/dist/lib/events/event-types.js +30 -0
  476. package/dist/lib/events/timer-bus.d.ts +21 -0
  477. package/dist/lib/events/timer-bus.js +41 -0
  478. package/dist/lib/events/timer-types.d.ts +64 -0
  479. package/dist/lib/events/timer-types.js +8 -0
  480. package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
  481. package/dist/lib/events/turn-end-coordinator.js +89 -0
  482. package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
  483. package/dist/lib/harness/failure-trace-collector.js +114 -0
  484. package/dist/lib/harness/index.d.ts +20 -0
  485. package/dist/lib/harness/index.js +21 -0
  486. package/dist/lib/harness/types.d.ts +85 -0
  487. package/dist/lib/harness/types.js +20 -0
  488. package/dist/lib/harness/weakness-miner.d.ts +29 -0
  489. package/dist/lib/harness/weakness-miner.js +165 -0
  490. package/dist/lib/memory/constants.d.ts +11 -0
  491. package/dist/lib/memory/constants.js +29 -0
  492. package/dist/lib/memory/index.d.ts +147 -0
  493. package/dist/lib/memory/index.js +564 -0
  494. package/dist/lib/memory/lifecycle.d.ts +50 -0
  495. package/dist/lib/memory/lifecycle.js +139 -0
  496. package/dist/lib/memory/past-insights.d.ts +35 -0
  497. package/dist/lib/memory/past-insights.js +189 -0
  498. package/dist/lib/memory/storage.d.ts +38 -0
  499. package/dist/lib/memory/storage.js +167 -0
  500. package/dist/lib/memory/store-lock.d.ts +23 -0
  501. package/dist/lib/memory/store-lock.js +69 -0
  502. package/dist/lib/memory/store-merge.d.ts +38 -0
  503. package/dist/lib/memory/store-merge.js +73 -0
  504. package/dist/lib/memory/types.d.ts +65 -0
  505. package/dist/lib/memory/types.js +5 -0
  506. package/dist/lib/memory/utils.d.ts +35 -0
  507. package/dist/lib/memory/utils.js +156 -0
  508. package/dist/lib/memory/write-log.d.ts +85 -0
  509. package/dist/lib/memory/write-log.js +124 -0
  510. package/dist/lib/memory/write-quality.d.ts +197 -0
  511. package/dist/lib/memory/write-quality.js +314 -0
  512. package/dist/lib/orchestrator/branch.d.ts +63 -0
  513. package/dist/lib/orchestrator/branch.js +192 -0
  514. package/dist/lib/orchestrator/index.d.ts +14 -0
  515. package/dist/lib/orchestrator/index.js +11 -0
  516. package/dist/lib/orchestrator/locks.d.ts +46 -0
  517. package/dist/lib/orchestrator/locks.js +122 -0
  518. package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
  519. package/dist/lib/orchestrator/slop-scanner.js +207 -0
  520. package/dist/lib/orchestrator/workers.d.ts +453 -0
  521. package/dist/lib/orchestrator/workers.js +1001 -0
  522. package/dist/lib/public.d.ts +18 -0
  523. package/dist/lib/public.js +23 -0
  524. package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
  525. package/dist/lib/reasoning/advice-tracker.js +177 -0
  526. package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
  527. package/dist/lib/reasoning/belief-policy-engine.js +268 -0
  528. package/dist/lib/reasoning/belief-types.d.ts +32 -0
  529. package/dist/lib/reasoning/belief-types.js +8 -0
  530. package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
  531. package/dist/lib/reasoning/classifier-offline.js +75 -0
  532. package/dist/lib/reasoning/dreamer.d.ts +37 -0
  533. package/dist/lib/reasoning/dreamer.js +169 -0
  534. package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
  535. package/dist/lib/reasoning/nudge-analytics.js +62 -0
  536. package/dist/lib/reasoning/policy-rules.d.ts +18 -0
  537. package/dist/lib/reasoning/policy-rules.js +153 -0
  538. package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
  539. package/dist/lib/reasoning/reasoning-metrics.js +174 -0
  540. package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
  541. package/dist/lib/reasoning/reasoning-summary.js +122 -0
  542. package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
  543. package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
  544. package/dist/lib/state/async-storage.d.ts +52 -0
  545. package/dist/lib/state/async-storage.js +171 -0
  546. package/dist/lib/state/extension-state.d.ts +184 -0
  547. package/dist/lib/state/extension-state.js +373 -0
  548. package/dist/lib/state/global-state.d.ts +358 -0
  549. package/dist/lib/state/global-state.js +741 -0
  550. package/dist/lib/state/metacognitive-state.d.ts +21 -0
  551. package/dist/lib/state/metacognitive-state.js +50 -0
  552. package/dist/lib/state/session-manager.d.ts +32 -0
  553. package/dist/lib/state/session-manager.js +11 -0
  554. package/dist/lib/state/session-start-queue.d.ts +42 -0
  555. package/dist/lib/state/session-start-queue.js +105 -0
  556. package/dist/lib/state/state-checkpoint.d.ts +72 -0
  557. package/dist/lib/state/state-checkpoint.js +252 -0
  558. package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
  559. package/dist/lib/state/telegram-poller-liveness.js +67 -0
  560. package/dist/lib/state/tool-provenance.d.ts +22 -0
  561. package/dist/lib/state/tool-provenance.js +25 -0
  562. package/dist/lib/state/workspace-snapshot.d.ts +111 -0
  563. package/dist/lib/state/workspace-snapshot.js +372 -0
  564. package/dist/lib/store/belief-store.d.ts +112 -0
  565. package/dist/lib/store/belief-store.js +252 -0
  566. package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
  567. package/dist/lib/store/bidirectional-verifier.js +242 -0
  568. package/dist/lib/store/claim-tracker.d.ts +66 -0
  569. package/dist/lib/store/claim-tracker.js +276 -0
  570. package/dist/lib/store/conflict-qa.d.ts +96 -0
  571. package/dist/lib/store/conflict-qa.js +283 -0
  572. package/dist/lib/store/evidence-pool.d.ts +185 -0
  573. package/dist/lib/store/evidence-pool.js +598 -0
  574. package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
  575. package/dist/lib/telemetry/context-heartbeat.js +449 -0
  576. package/dist/lib/telemetry/drift-signals.d.ts +46 -0
  577. package/dist/lib/telemetry/drift-signals.js +75 -0
  578. package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
  579. package/dist/lib/telemetry/rss-telemetry.js +53 -0
  580. package/dist/lib/types/episode-types.d.ts +31 -0
  581. package/dist/lib/types/episode-types.js +9 -0
  582. package/dist/lib/types/standard-result.d.ts +32 -0
  583. package/dist/lib/types/standard-result.js +22 -0
  584. package/dist/lib/utils/async-fs.d.ts +17 -0
  585. package/dist/lib/utils/async-fs.js +22 -0
  586. package/dist/lib/utils/bounded.d.ts +38 -0
  587. package/dist/lib/utils/bounded.js +59 -0
  588. package/dist/lib/utils/dedup.d.ts +40 -0
  589. package/dist/lib/utils/dedup.js +43 -0
  590. package/dist/lib/utils/error-guard.d.ts +15 -0
  591. package/dist/lib/utils/error-guard.js +22 -0
  592. package/dist/lib/utils/extension-utils.d.ts +36 -0
  593. package/dist/lib/utils/extension-utils.js +65 -0
  594. package/dist/lib/utils/extract-json.d.ts +23 -0
  595. package/dist/lib/utils/extract-json.js +90 -0
  596. package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
  597. package/dist/lib/utils/file-mutation-queue.js +150 -0
  598. package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
  599. package/dist/lib/utils/filter-safe-to-remove.js +256 -0
  600. package/dist/lib/utils/format-tool-result.d.ts +47 -0
  601. package/dist/lib/utils/format-tool-result.js +88 -0
  602. package/dist/lib/utils/id.d.ts +44 -0
  603. package/dist/lib/utils/id.js +59 -0
  604. package/dist/lib/utils/injection-tracker.d.ts +317 -0
  605. package/dist/lib/utils/injection-tracker.js +840 -0
  606. package/dist/lib/utils/local-time.d.ts +57 -0
  607. package/dist/lib/utils/local-time.js +181 -0
  608. package/dist/lib/utils/memory-fence.d.ts +55 -0
  609. package/dist/lib/utils/memory-fence.js +66 -0
  610. package/dist/lib/utils/sop-extractor.d.ts +75 -0
  611. package/dist/lib/utils/sop-extractor.js +259 -0
  612. package/dist/lib/utils/sop-suggestion.d.ts +34 -0
  613. package/dist/lib/utils/sop-suggestion.js +336 -0
  614. package/dist/lib/utils/wake-gate.d.ts +151 -0
  615. package/dist/lib/utils/wake-gate.js +265 -0
  616. package/dist/lib/utils/whisper-format.d.ts +95 -0
  617. package/dist/lib/utils/whisper-format.js +115 -0
  618. package/dist/lib/verification/coordination-checker.d.ts +72 -0
  619. package/dist/lib/verification/coordination-checker.js +126 -0
  620. package/dist/loader/api.d.ts +19 -0
  621. package/dist/loader/api.js +114 -0
  622. package/dist/loader/loader.d.ts +85 -0
  623. package/dist/loader/loader.js +534 -0
  624. package/docs/BEGINNERS.md +144 -0
  625. package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
  626. package/docs/CONTEXT-MAP.md +220 -0
  627. package/docs/CONTEXT-POLICY.md +86 -0
  628. package/docs/HISTORY.md +110 -0
  629. package/docs/LOCAL_DEV.md +246 -0
  630. package/docs/ROADMAP.md +107 -0
  631. package/docs/SETUP.md +459 -0
  632. package/package.json +97 -4
  633. package/skills/agent-testing/SKILL.md +214 -0
  634. package/skills/braid-reference/SKILL.md +88 -0
  635. package/skills/code-refactoring/SKILL.md +211 -0
  636. package/skills/code-search/SKILL.md +14 -0
  637. package/skills/documentation/SKILL.md +89 -0
  638. package/skills/dox/AGENTS.md.template +83 -0
  639. package/skills/dox/SKILL.md +86 -0
  640. package/skills/healthcheck/SKILL.md +65 -0
  641. package/skills/herdr-topology/SKILL.md +269 -0
  642. package/skills/meta-cognition/SKILL.md +24 -0
  643. package/skills/meta-improvement/SKILL.md +180 -0
  644. package/skills/misdirection-audit/SKILL.md +66 -0
  645. package/skills/pi-reference/SKILL.md +104 -0
  646. package/skills/placement-discipline/SKILL.md +69 -0
  647. package/skills/probe-evaluation/SKILL.md +85 -0
  648. package/skills/release-pipeline/SKILL.md +191 -0
  649. package/skills/research/SKILL.md +166 -0
  650. package/skills/skill-usage/SKILL.md +81 -0
  651. package/skills/software-engineer/SKILL.md +83 -0
  652. package/skills/subagent-orchestration/SKILL.md +454 -0
  653. package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
  654. package/skills/subagent-verification/SKILL.md +127 -0
  655. package/skills/tone-quality/SKILL.md +176 -0
  656. package/skills/voice-replies/SKILL.md +125 -0
  657. package/src/AGENTS.md +111 -0
  658. package/src/extensions/cognitive/AGENTS.md +29 -0
  659. package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
  660. package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
  661. package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
  662. package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
  663. package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
  664. package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
  665. package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
  666. package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
  667. package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
  668. package/src/extensions/cognitive/metacognition/index.ts +109 -0
  669. package/src/extensions/cognitive/reasoning/index.ts +168 -0
  670. package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
  671. package/src/extensions/cognitive/topic-drift/index.ts +429 -0
  672. package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
  673. package/src/extensions/context-management/README.md +102 -0
  674. package/src/extensions/context-management/index.ts +383 -0
  675. package/src/extensions/core/AGENTS.md +34 -0
  676. package/src/extensions/core/agent-environment/index.ts +135 -0
  677. package/src/extensions/core/polyfill/index.ts +617 -0
  678. package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
  679. package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
  680. package/src/extensions/core/prompt-builder/context-section.ts +120 -0
  681. package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
  682. package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
  683. package/src/extensions/core/prompt-builder/identity.ts +98 -0
  684. package/src/extensions/core/prompt-builder/index.ts +602 -0
  685. package/src/extensions/core/prompt-builder/inspect.ts +227 -0
  686. package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
  687. package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
  688. package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
  689. package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
  690. package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
  691. package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
  692. package/src/extensions/core/prompt-builder/section.ts +150 -0
  693. package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
  694. package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
  695. package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
  696. package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
  697. package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
  698. package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
  699. package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
  700. package/src/extensions/core/skills-tool/index.ts +240 -0
  701. package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
  702. package/src/extensions/core/skills-tool/session-records.ts +328 -0
  703. package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
  704. package/src/extensions/enforcement/AGENTS.md +69 -0
  705. package/src/extensions/enforcement/detection/malformed.ts +42 -0
  706. package/src/extensions/enforcement/detection/verification.ts +52 -0
  707. package/src/extensions/enforcement/enforcement-types.ts +42 -0
  708. package/src/extensions/enforcement/handler-registry.ts +225 -0
  709. package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
  710. package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
  711. package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
  712. package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
  713. package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
  714. package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
  715. package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
  716. package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
  717. package/src/extensions/enforcement/handlers/blocking.ts +50 -0
  718. package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
  719. package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
  720. package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
  721. package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
  722. package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
  723. package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
  724. package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
  725. package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
  726. package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
  727. package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
  728. package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
  729. package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
  730. package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
  731. package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
  732. package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
  733. package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
  734. package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
  735. package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
  736. package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
  737. package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
  738. package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
  739. package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
  740. package/src/extensions/enforcement/index.ts +28 -0
  741. package/src/extensions/enforcement/judge-utils.ts +106 -0
  742. package/src/extensions/enforcement/nudge-manager.ts +298 -0
  743. package/src/extensions/enforcement/self-state-claims.ts +204 -0
  744. package/src/extensions/enforcement/session-health.ts +317 -0
  745. package/src/extensions/enforcement/signals.ts +88 -0
  746. package/src/extensions/enforcement/similarity.ts +76 -0
  747. package/src/extensions/enforcement/state.ts +115 -0
  748. package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
  749. package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
  750. package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
  751. package/src/extensions/enforcement/substate/session-state.ts +79 -0
  752. package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
  753. package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
  754. package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
  755. package/src/extensions/enforcement/task-evidence.ts +436 -0
  756. package/src/extensions/enforcement/types.ts +38 -0
  757. package/src/extensions/enforcement/validation.ts +194 -0
  758. package/src/extensions/enforcement/verification-judge.ts +317 -0
  759. package/src/extensions/enforcement/whisper.ts +120 -0
  760. package/src/extensions/heartbeat/AGENTS.md +47 -0
  761. package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
  762. package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
  763. package/src/extensions/heartbeat/analytics/core.ts +222 -0
  764. package/src/extensions/heartbeat/analytics/format.ts +144 -0
  765. package/src/extensions/heartbeat/analytics/index.ts +373 -0
  766. package/src/extensions/heartbeat/analytics/shared.ts +149 -0
  767. package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
  768. package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
  769. package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
  770. package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
  771. package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
  772. package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
  773. package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
  774. package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
  775. package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
  776. package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
  777. package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
  778. package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
  779. package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
  780. package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
  781. package/src/extensions/manifest.ts +293 -0
  782. package/src/extensions/memory/AGENTS.md +93 -0
  783. package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
  784. package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
  785. package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
  786. package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
  787. package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
  788. package/src/extensions/memory/context-lifecycle/state.ts +165 -0
  789. package/src/extensions/memory/context-lifecycle/types.ts +441 -0
  790. package/src/extensions/memory/context-manager/analysis.ts +344 -0
  791. package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
  792. package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
  793. package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
  794. package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
  795. package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
  796. package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
  797. package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
  798. package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
  799. package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
  800. package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
  801. package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
  802. package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
  803. package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
  804. package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
  805. package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
  806. package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
  807. package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
  808. package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
  809. package/src/extensions/memory/context-manager/index.ts +111 -0
  810. package/src/extensions/memory/context-manager/pruning.ts +479 -0
  811. package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
  812. package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
  813. package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
  814. package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
  815. package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
  816. package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
  817. package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
  818. package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
  819. package/src/extensions/memory/scratchpad/format.ts +161 -0
  820. package/src/extensions/memory/scratchpad/handlers.ts +601 -0
  821. package/src/extensions/memory/scratchpad/index.ts +230 -0
  822. package/src/extensions/memory/scratchpad/persistence.ts +374 -0
  823. package/src/extensions/memory/scratchpad/types.ts +149 -0
  824. package/src/extensions/memory/scratchpad/utils.ts +268 -0
  825. package/src/extensions/memory/session-recall/AGENTS.md +104 -0
  826. package/src/extensions/memory/session-recall/analyze.ts +605 -0
  827. package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
  828. package/src/extensions/memory/session-recall/index.ts +956 -0
  829. package/src/extensions/memory/session-recall/query.ts +44 -0
  830. package/src/extensions/memory/session-recall/rank.ts +121 -0
  831. package/src/extensions/memory/session-recall/search.ts +801 -0
  832. package/src/extensions/memory/session-recall/stats.ts +93 -0
  833. package/src/extensions/memory/session-recall/text-utils.ts +209 -0
  834. package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
  835. package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
  836. package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
  837. package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
  838. package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
  839. package/src/extensions/memory/three-memory-stores/index.ts +549 -0
  840. package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
  841. package/src/extensions/memory/three-memory-stores/types.ts +74 -0
  842. package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
  843. package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
  844. package/src/extensions/orchestrator/index.ts +1141 -0
  845. package/src/extensions/scheduling/AGENTS.md +26 -0
  846. package/src/extensions/scheduling/timer/AGENTS.md +259 -0
  847. package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
  848. package/src/extensions/scheduling/timer/index.ts +1331 -0
  849. package/src/extensions/scheduling/timer/poller.ts +138 -0
  850. package/src/extensions/scheduling/timer/recovery.ts +462 -0
  851. package/src/extensions/scheduling/timer/store-file.ts +59 -0
  852. package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
  853. package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
  854. package/src/extensions/self/AGENTS.md +30 -0
  855. package/src/extensions/self/auto-recovery/index.ts +112 -0
  856. package/src/extensions/self/error-tracking/AGENTS.md +38 -0
  857. package/src/extensions/self/error-tracking/index.ts +299 -0
  858. package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
  859. package/src/extensions/self/health-maintenance/format.ts +87 -0
  860. package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
  861. package/src/extensions/self/health-maintenance/helpers.ts +78 -0
  862. package/src/extensions/self/health-maintenance/index.ts +308 -0
  863. package/src/extensions/self/health-maintenance/types.ts +14 -0
  864. package/src/extensions/self/latent-activator/AGENTS.md +64 -0
  865. package/src/extensions/self/latent-activator/index.ts +206 -0
  866. package/src/extensions/self/latent-activator/mixes.ts +22 -0
  867. package/src/extensions/self/latent-activator/signals.ts +237 -0
  868. package/src/extensions/self/latent-activator/state.ts +79 -0
  869. package/src/extensions/self/latent-activator/types.ts +47 -0
  870. package/src/extensions/self/watchdog/AGENTS.md +27 -0
  871. package/src/extensions/self/watchdog/config.ts +73 -0
  872. package/src/extensions/self/watchdog/engine.ts +1246 -0
  873. package/src/extensions/self/watchdog/index.ts +577 -0
  874. package/src/index.ts +93 -0
  875. package/src/lib/AGENTS.md +39 -0
  876. package/src/lib/ai/AGENTS.md +37 -0
  877. package/src/lib/ai/consolidated-claim-critic.ts +287 -0
  878. package/src/lib/ai/cost-report.ts +206 -0
  879. package/src/lib/ai/critic-cache.ts +122 -0
  880. package/src/lib/ai/critic-fallbacks.ts +74 -0
  881. package/src/lib/ai/critic-gate.ts +135 -0
  882. package/src/lib/ai/critic-helpers.ts +135 -0
  883. package/src/lib/ai/critic-registry.ts +754 -0
  884. package/src/lib/ai/critic-stats.ts +158 -0
  885. package/src/lib/ai/judge-budget.ts +241 -0
  886. package/src/lib/ai/language-hint.ts +70 -0
  887. package/src/lib/ai/llm-call.ts +975 -0
  888. package/src/lib/ai/model-resolver.ts +224 -0
  889. package/src/lib/ai/models-init.ts +68 -0
  890. package/src/lib/ai/payload-hygiene.ts +265 -0
  891. package/src/lib/ai/post-loop-classify.ts +185 -0
  892. package/src/lib/ai/text-classifier.ts +746 -0
  893. package/src/lib/cognitive/AGENTS.md +40 -0
  894. package/src/lib/cognitive/hints.ts +254 -0
  895. package/src/lib/cognitive/openspec.ts +124 -0
  896. package/src/lib/config/AGENTS.md +17 -0
  897. package/src/lib/config/braid-paths.ts +401 -0
  898. package/src/lib/config/braid-settings.ts +1442 -0
  899. package/src/lib/config/per-tool-settings.ts +197 -0
  900. package/src/lib/config/session-profiles.ts +165 -0
  901. package/src/lib/constants/AGENTS.md +15 -0
  902. package/src/lib/constants/injection-details.ts +32 -0
  903. package/src/lib/constants/session-thresholds.ts +64 -0
  904. package/src/lib/constants/tool-constants.ts +16 -0
  905. package/src/lib/core/AGENTS.md +23 -0
  906. package/src/lib/core/event-names.ts +31 -0
  907. package/src/lib/core/logger.ts +334 -0
  908. package/src/lib/detection/AGENTS.md +21 -0
  909. package/src/lib/detection/compression-strategy.ts +183 -0
  910. package/src/lib/detection/consolidated-topic-critic.ts +188 -0
  911. package/src/lib/detection/context-density.ts +237 -0
  912. package/src/lib/detection/context-thresholds.ts +132 -0
  913. package/src/lib/detection/context-tiers.ts +201 -0
  914. package/src/lib/detection/context-usage.ts +270 -0
  915. package/src/lib/detection/degradation-detector.ts +583 -0
  916. package/src/lib/detection/test-burst.ts +170 -0
  917. package/src/lib/detection/tool-loop-detector.ts +364 -0
  918. package/src/lib/detection/topic-drift-detector.ts +323 -0
  919. package/src/lib/enforcement/AGENTS.md +20 -0
  920. package/src/lib/enforcement/adherence-meter.ts +578 -0
  921. package/src/lib/enforcement/turn-dedup.ts +246 -0
  922. package/src/lib/errors/llm-error.ts +288 -0
  923. package/src/lib/events/AGENTS.md +23 -0
  924. package/src/lib/events/consolidation-channel.ts +493 -0
  925. package/src/lib/events/consolidation-scoring.ts +112 -0
  926. package/src/lib/events/event-bus.ts +213 -0
  927. package/src/lib/events/event-types.ts +53 -0
  928. package/src/lib/events/timer-bus.ts +53 -0
  929. package/src/lib/events/timer-types.ts +64 -0
  930. package/src/lib/events/turn-end-coordinator.ts +108 -0
  931. package/src/lib/harness/AGENTS.md +20 -0
  932. package/src/lib/harness/failure-trace-collector.ts +157 -0
  933. package/src/lib/harness/index.ts +41 -0
  934. package/src/lib/harness/types.ts +122 -0
  935. package/src/lib/harness/weakness-miner.ts +209 -0
  936. package/src/lib/memory/AGENTS.md +36 -0
  937. package/src/lib/memory/constants.ts +34 -0
  938. package/src/lib/memory/index.ts +705 -0
  939. package/src/lib/memory/lifecycle.ts +159 -0
  940. package/src/lib/memory/past-insights.ts +221 -0
  941. package/src/lib/memory/storage.ts +187 -0
  942. package/src/lib/memory/store-lock.ts +70 -0
  943. package/src/lib/memory/store-merge.ts +100 -0
  944. package/src/lib/memory/types.ts +82 -0
  945. package/src/lib/memory/utils.ts +173 -0
  946. package/src/lib/memory/write-log.ts +174 -0
  947. package/src/lib/memory/write-quality.ts +383 -0
  948. package/src/lib/orchestrator/branch.ts +193 -0
  949. package/src/lib/orchestrator/index.ts +78 -0
  950. package/src/lib/orchestrator/locks.ts +160 -0
  951. package/src/lib/orchestrator/slop-scanner.ts +258 -0
  952. package/src/lib/orchestrator/workers.ts +1382 -0
  953. package/src/lib/public.ts +43 -0
  954. package/src/lib/reasoning/AGENTS.md +25 -0
  955. package/src/lib/reasoning/advice-tracker.ts +244 -0
  956. package/src/lib/reasoning/belief-policy-engine.ts +342 -0
  957. package/src/lib/reasoning/belief-types.ts +45 -0
  958. package/src/lib/reasoning/classifier-offline.ts +111 -0
  959. package/src/lib/reasoning/dreamer.ts +215 -0
  960. package/src/lib/reasoning/nudge-analytics.ts +85 -0
  961. package/src/lib/reasoning/policy-rules.ts +172 -0
  962. package/src/lib/reasoning/reasoning-metrics.ts +202 -0
  963. package/src/lib/reasoning/reasoning-summary.ts +154 -0
  964. package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
  965. package/src/lib/state/AGENTS.md +192 -0
  966. package/src/lib/state/async-storage.ts +189 -0
  967. package/src/lib/state/extension-state.ts +419 -0
  968. package/src/lib/state/global-state.ts +1046 -0
  969. package/src/lib/state/metacognitive-state.ts +65 -0
  970. package/src/lib/state/session-manager.ts +43 -0
  971. package/src/lib/state/session-start-queue.ts +135 -0
  972. package/src/lib/state/state-checkpoint.ts +352 -0
  973. package/src/lib/state/telegram-poller-liveness.ts +75 -0
  974. package/src/lib/state/tool-provenance.ts +26 -0
  975. package/src/lib/state/workspace-snapshot.ts +466 -0
  976. package/src/lib/store/AGENTS.md +24 -0
  977. package/src/lib/store/belief-store.ts +325 -0
  978. package/src/lib/store/bidirectional-verifier.ts +316 -0
  979. package/src/lib/store/claim-tracker.ts +382 -0
  980. package/src/lib/store/conflict-qa.ts +385 -0
  981. package/src/lib/store/evidence-pool.ts +779 -0
  982. package/src/lib/telemetry/AGENTS.md +28 -0
  983. package/src/lib/telemetry/context-heartbeat.ts +555 -0
  984. package/src/lib/telemetry/drift-signals.ts +105 -0
  985. package/src/lib/telemetry/rss-telemetry.ts +57 -0
  986. package/src/lib/types/AGENTS.md +21 -0
  987. package/src/lib/types/episode-types.ts +31 -0
  988. package/src/lib/types/standard-result.ts +40 -0
  989. package/src/lib/utils/AGENTS.md +30 -0
  990. package/src/lib/utils/async-fs.ts +23 -0
  991. package/src/lib/utils/bounded.ts +58 -0
  992. package/src/lib/utils/dedup.ts +44 -0
  993. package/src/lib/utils/error-guard.ts +27 -0
  994. package/src/lib/utils/extension-utils.ts +72 -0
  995. package/src/lib/utils/extract-json.ts +89 -0
  996. package/src/lib/utils/file-mutation-queue.ts +172 -0
  997. package/src/lib/utils/filter-safe-to-remove.ts +301 -0
  998. package/src/lib/utils/format-tool-result.ts +109 -0
  999. package/src/lib/utils/id.ts +64 -0
  1000. package/src/lib/utils/injection-tracker.ts +1014 -0
  1001. package/src/lib/utils/local-time.ts +196 -0
  1002. package/src/lib/utils/memory-fence.ts +70 -0
  1003. package/src/lib/utils/sop-extractor.ts +329 -0
  1004. package/src/lib/utils/sop-suggestion.ts +426 -0
  1005. package/src/lib/utils/wake-gate.ts +318 -0
  1006. package/src/lib/utils/whisper-format.ts +120 -0
  1007. package/src/lib/verification/coordination-checker.ts +183 -0
  1008. package/src/loader/AGENTS.md +32 -0
  1009. package/src/loader/api.ts +138 -0
  1010. package/src/loader/loader.ts +600 -0
  1011. package/src/types/extension-context.d.ts +85 -0
@@ -0,0 +1,746 @@
1
+ /**
2
+ * Text Classifier - lightweight classification with a configurable role model.
3
+ *
4
+ * Four-tier fallback (logit-probe first):
5
+ * Tier 0 (binary gate): Ultra-cheap yes/no pre-check via maxTokens=1, temperature=0.
6
+ * Cost: 1 output token. Returns the model's argmax prediction for yes/no.
7
+ * Falls through on any non-yes/no response. Enabled via binaryGate: true.
8
+ * Tier 1: Heuristic fallback callback (caller-provided). Fast, free.
9
+ * If it returns a clear "yes"/"no", use it with 0.7 confidence.
10
+ * Tier 2: Merged role model (utilityModel, via /utility-model or settings.json)
11
+ * Tier 3: Session model (ctx.model)
12
+ *
13
+ * The merged role is the one auxiliary role: "quality" puts the session model
14
+ * first, every other preference puts the role first, and a model configured
15
+ * once can no longer appear as two tiers.
16
+ *
17
+ * The heuristic tier is preferred over LLM because it's instant and costs nothing.
18
+ * The binary gate is preferred over heuristic because it costs 1 token and gives
19
+ * a calibrated LLM judgment (not a fragile regex).
20
+ */
21
+
22
+ import { callLlm } from "../ai/llm-call.js";
23
+ import { resolveUtilityModel } from "../ai/model-resolver.js";
24
+ import { createLogger } from "../core/logger.js";
25
+ import { recordCriticCall } from "./critic-stats.js";
26
+ import { getCacheKey, getCachedResult, setCachedResult } from "./critic-cache.js";
27
+ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
28
+ import type { Api, Model } from "@earendil-works/pi-ai";
29
+
30
+ const log = createLogger("text-classifier");
31
+
32
+ // ── Types ────────────────────────────────────────────────────────────────────
33
+
34
+ export interface ClassifierCriteria {
35
+ /** System prompt: role description for the classifier model. */
36
+ systemPrompt: string;
37
+ /** User prompt with {{key}} placeholders for substitution. */
38
+ userPrompt: string;
39
+ }
40
+
41
+ export interface ClassificationResult {
42
+ /** Parsed label - "yes" | "no" | fallback value. */
43
+ label: string;
44
+ /** Confidence estimate: utility=0.9, session=0.6, heuristic=0.7, failed=0. */
45
+ confidence: number;
46
+ /** Raw model output text. */
47
+ raw: string;
48
+ /** Which tier produced this result. */
49
+ tier: "utility" | "session" | "heuristic" | "failed" | "cache" | "gate";
50
+ /** Latency in milliseconds. */
51
+ latencyMs: number;
52
+ }
53
+
54
+ export interface ClassifierOptions {
55
+ maxTokens?: number;
56
+ timeoutMs?: number;
57
+ /** Heuristic fallback function - called first. If it returns a clear yes/no, skip LLM. */
58
+ fallback?: () => Promise<string> | string;
59
+ /**
60
+ * Tier policy controls when the heuristic is consulted.
61
+ * - "prefer-heuristic" (default): try heuristic first, fall through to LLM on ambiguity.
62
+ * - "fallback-only": heuristic is best-effort and its label is treated as low-confidence
63
+ * (0.5). Used when the heuristic is known-fragile but still useful.
64
+ * - "always-llm": skip heuristic entirely. Required for accuracy-critical classifiers
65
+ * where a wrong heuristic answer is worse than an LLM cost.
66
+ */
67
+ tierPolicy?: "prefer-heuristic" | "fallback-only" | "always-llm";
68
+ /**
69
+ * Enable Tier 0 binary gate: ultra-cheap yes/no pre-check via maxTokens=1, temperature=0.
70
+ * Cost: 1 output token per call (vs ~30-50 for full cascade). Returns the model's argmax
71
+ * prediction on the first forward pass. Falls through to the existing cascade on any
72
+ * non-yes/no response. Only effective for binary (yes/no) classifiers.
73
+ *
74
+ * Based on research: logit-probing / logprob-based classification (arXiv 2407.01122,
75
+ * arcturus-labs.com 2025). For binary decisions, the model's first-token logits encode
76
+ * the full classification — no need to generate 30+ tokens of structured output.
77
+ */
78
+ binaryGate?: boolean;
79
+ /**
80
+ * Optional whitelist of valid labels. If set and the heuristic returns a label
81
+ * NOT in this set, fall through to the LLM. Useful for multi-class classifiers
82
+ * where the heuristic might guess a wrong category.
83
+ */
84
+ validLabels?: string[];
85
+ /** Optional human-readable label for runtime observability (critic-stats tracking). */
86
+ label?: string;
87
+ /**
88
+ * Model preference selects the tier ORDERING strategy.
89
+ * Each strategy defines which LLM tiers to try and in what order.
90
+ * All strategies start with heuristic (tier 1) if applicable.
91
+ *
92
+ * "balanced" (default): role -> session
93
+ * Good default: the merged role first, session as backup.
94
+ *
95
+ * "quality": session -> role
96
+ * Try the session (conversation) model first since it may already be
97
+ * powerful; the merged role is the fallback.
98
+ *
99
+ * "speed" / "max": role -> session
100
+ * The values stay accepted for callers; both mean the same order as
101
+ * "balanced" (there is no separate max-power tier).
102
+ */
103
+ modelPreference?: "balanced" | "quality" | "speed" | "max";
104
+ /**
105
+ * Best-effort mode: shorter timeout, demote failure warns to debug.
106
+ * Use for post-loop / session-end analysis where the result is nice-to-have
107
+ * and aborts are expected (the session signal cascades to in-flight calls
108
+ * when the agent's main turn ends). The classifier still returns a result
109
+ * (label: "unknown" on failure), but the logs stay clean.
110
+ *
111
+ * Default: false (use 8s timeout + warn on failure).
112
+ */
113
+ bestEffort?: boolean;
114
+ }
115
+
116
+ // ── Tier Descriptor ────────────────────────────────────────────────────────
117
+
118
+ /** A single tier in the LLM fallback chain with model eagerly resolved. */
119
+ interface TierDescriptor {
120
+ name: "utility" | "session";
121
+ model: Model<Api>;
122
+ confidence: number;
123
+ }
124
+
125
+ /**
126
+ * Build the ordered list of LLM tiers based on the modelPreference strategy.
127
+ *
128
+ * The merged role supplies the one auxiliary model: "quality" keeps the
129
+ * session model first, every other preference puts the role first. Tiers that
130
+ * resolve to the same provider/model pair are deduped, so a role configured
131
+ * to the session model does not cost two attempts.
132
+ *
133
+ * The heuristic (tier 1) is always evaluated before this function is called.
134
+ */
135
+ function buildTierOrder(
136
+ modelPreference: NonNullable<ClassifierOptions["modelPreference"]>,
137
+ ctx: ExtensionContext,
138
+ ): TierDescriptor[] {
139
+ const utility = resolveUtilityModel(ctx);
140
+ const session = ctx.model;
141
+
142
+ const roleTier: TierDescriptor | undefined = utility
143
+ ? { name: "utility", model: utility, confidence: 0.9 }
144
+ : undefined;
145
+ const sessionTier: TierDescriptor | undefined = session
146
+ ? { name: "session", model: session, confidence: 0.6 }
147
+ : undefined;
148
+
149
+ const ordered = modelPreference === "quality" ? [sessionTier, roleTier] : [roleTier, sessionTier];
150
+
151
+ const seen = new Set<string>();
152
+ const tiers: TierDescriptor[] = [];
153
+ for (const tier of ordered) {
154
+ if (!tier) continue;
155
+ const key = `${tier.model.provider ?? "unknown"}/${tier.model.id}`;
156
+ if (seen.has(key)) continue;
157
+ seen.add(key);
158
+ tiers.push(tier);
159
+ }
160
+ return tiers;
161
+ }
162
+
163
+ // ── Binary Gate (Tier 0) ─────────────────────────────────────────────────────
164
+
165
+ /**
166
+ * Tier 0: Binary gate — ultra-cheap yes/no pre-check.
167
+ *
168
+ * For binary classification, the model's first-token logits already encode the
169
+ * full decision. We don't need 30-50 tokens of structured output — just 1 token
170
+ * at temperature=0 gives the model's argmax prediction.
171
+ *
172
+ * Based on research:
173
+ * - "Calibrated Large Language Models for Binary Question Answering" (2407.01122)
174
+ * - Logit probing / logprob-based classification (arcturus-labs.com 2025)
175
+ * - Token-level probability estimation (ericjinks.com 2025)
176
+ *
177
+ * Strategy:
178
+ * 1. Try the utility model first (cheapest available)
179
+ * 2. Fall back to the session model
180
+ * 3. If neither produces a clear yes/no, return null → falls through to existing cascade
181
+ *
182
+ * Cost: 1 output token on success (vs ~30-50 for full cascade).
183
+ * Timeout: 10s per model (fast failure is better than waiting).
184
+ */
185
+ async function binaryGate(
186
+ ctx: ExtensionContext,
187
+ systemPrompt: string,
188
+ userMessage: string,
189
+ signal: AbortSignal | undefined,
190
+ ): Promise<string | null> {
191
+ const utilityModel = resolveUtilityModel(ctx);
192
+ const models = [
193
+ { name: "utility", model: utilityModel },
194
+ { name: "session", model: ctx.model },
195
+ ].filter((m) => m.model !== undefined);
196
+
197
+ for (const { name, model } of models) {
198
+ try {
199
+ const apiKey = await ctx.modelRegistry.getApiKeyForProvider(model!.provider);
200
+ if (!apiKey) continue;
201
+
202
+ const result = await callLlm(model!, apiKey, systemPrompt, userMessage, {
203
+ maxTokens: 1,
204
+ temperature: 0,
205
+ reasoning: "off",
206
+ timeoutMs: 10_000,
207
+ ...(signal ? { signal } : {}),
208
+ });
209
+
210
+ if ("error" in result) {
211
+ log.debug(`[text-classifier] binary gate (${name}) error: ${result.error}`);
212
+ continue;
213
+ }
214
+
215
+ const raw = result.text.trim().toLowerCase();
216
+ if (raw === "yes" || raw === "no") {
217
+ log.debug(`[text-classifier] binary gate (${name}): "${raw}" (1 token)`);
218
+ return raw;
219
+ }
220
+
221
+ log.debug(`[text-classifier] binary gate (${name}) ambiguous: "${raw}"`);
222
+ } catch (e) {
223
+ log.debug(`[text-classifier] binary gate (${name}) threw: ${(e as Error).message}`);
224
+ }
225
+ }
226
+
227
+ return null;
228
+ }
229
+
230
+ // ── Classify ─────────────────────────────────────────────────────────────────
231
+
232
+ /**
233
+ * Classify text using the four-tier fallback system (heuristic-first).
234
+ *
235
+ * Tier 1 (heuristic) runs first - it's fast and free. Only if the heuristic
236
+ * returns something ambiguous or isn't provided do we consult LLM tiers.
237
+ *
238
+ * Tier flow by modelPreference (see ClassifierOptions for details):
239
+ * "balanced" (default): heuristic -> role -> session
240
+ * "quality": heuristic -> session -> role
241
+ * "speed" / "max": heuristic -> role -> session (same as balanced)
242
+ *
243
+ * @param ctx - Extension context for model resolution + API keys.
244
+ * @param criteria - Prompt templates (system + user with {{key}} placeholders).
245
+ * @param substitutions - Key-value pairs to replace `{{key}}` in prompts.
246
+ * @param options - Optional: maxTokens, timeoutMs, heuristic fallback, modelPreference.
247
+ * @returns ClassificationResult with label, confidence, tier, and latency.
248
+ */
249
+ export async function classify(
250
+ ctx: ExtensionContext,
251
+ criteria: ClassifierCriteria,
252
+ substitutions: Record<string, string>,
253
+ options?: ClassifierOptions,
254
+ ): Promise<ClassificationResult> {
255
+ const start = Date.now();
256
+ // Default maxTokens: undefined (was 64, was 16, was 10).
257
+ //
258
+ // Why we removed the default entirely:
259
+ // 1. Yes/no answers are 1-2 tokens. The model can stop early
260
+ // without us capping it.
261
+ // 2. Setting maxTokens too LOW (10, 16) caused the empty-string
262
+ // bug for reasoning-capable models (mistral-small,
263
+ // minimax-m3) - thinking tokens ate the budget and
264
+ // produced 0 output tokens.
265
+ // 3. Setting maxTokens too HIGH (64, 1000) is a no-op for
266
+ // classification - the model uses 1-2 tokens either way.
267
+ //
268
+ // Undefined does NOT mean "no cap": callLlm sizes a default from the
269
+ // prompt length (1000-4000 tokens). A reasoning-capable model that
270
+ // ignores `reasoning: "off"` can burn that entire budget on its
271
+ // thinking channel and return no text at all (stopReason=length, the
272
+ // empty-label symptom). tryModelCall's one-shot enlarged-budget retry
273
+ // covers that signature.
274
+ //
275
+ // Callers can still pass `maxTokens` explicitly if they need a
276
+ // hard cap (e.g., for a custom reason).
277
+ const maxTokens = options?.maxTokens;
278
+ // 10-minute default per tier (was 8s; bestEffort was 3s). Aborts
279
+ // should be signal-driven (ESC, session shutdown), not
280
+ // timeout-driven. A timeout here is a fallback for orphaned calls
281
+ // (caller crashed, signal never fired) - not the normal
282
+ // cancellation path. Slow models (minimax-m3, mistral-small)
283
+ // regularly take 3-5s for a single classification, but worst-case
284
+ // paths (large prompts, network jitter, session-end backpressure)
285
+ // can take 30s+. Callers can still pass a tighter timeoutMs if
286
+ // they want a hard ceiling.
287
+ //
288
+ // The bestEffort flag no longer affects the timeout - it now only
289
+ // demotes failure logs to debug. Both modes get the same 10-min
290
+ // default; the difference is just whether aborts are noisy.
291
+ const timeoutMs = options?.timeoutMs ?? 600_000;
292
+ // Demote the per-tier failure warns and the "ALL TIERS FAILED" warn
293
+ // to debug when bestEffort is set OR the failure was an abort.
294
+ // Aborts at session end are expected behavior (the session signal
295
+ // cascades to in-flight calls), not real failures.
296
+ const logTierFailure = (reason: string): void => {
297
+ if (options?.bestEffort || /abort/i.test(reason)) {
298
+ log.debug(`[text-classifier] ${reason}`);
299
+ } else {
300
+ log.warn(`[text-classifier] ${reason}`);
301
+ }
302
+ };
303
+
304
+ // Build prompts (needed early for LLM tiers)
305
+ const userMessage = replacePlaceholders(criteria.userPrompt, substitutions);
306
+
307
+ // ── Tier 0: Binary gate (ultra-cheap, 1 token) ───────────────────────────
308
+ // For binary yes/no classifiers, the model's first-token logits at
309
+ // temperature=0 give the argmax prediction for the cost of 1 output token.
310
+ // Falls through to the heuristic + LLM cascade on any non-yes/no response.
311
+ //
312
+ // Default: enabled for all binary (yes/no) classifiers. Disabled for
313
+ // multi-class classifiers (those with validLabels) since the gate only
314
+ // handles yes/no. Callers can explicitly set binaryGate: false to opt out.
315
+ const opts = options;
316
+ const useBinaryGate =
317
+ opts?.binaryGate ?? (!opts?.validLabels || (opts.validLabels?.length ?? 0) === 0);
318
+ if (useBinaryGate && opts?.tierPolicy !== "always-llm") {
319
+ const gateLabel = await binaryGate(ctx, criteria.systemPrompt, userMessage, ctx.signal);
320
+ if (gateLabel) {
321
+ const latency = Date.now() - start;
322
+ log.debug(`[text-classifier] TIER 0 (binary gate): "${gateLabel}" ${latency}ms (1 token)`);
323
+ if (opts?.label) recordCriticCall(opts.label, "gate", latency);
324
+ // Cache the binary gate result so subsequent identical calls
325
+ // skip the gate entirely (cache hit returns instantly).
326
+ if (opts?.label) {
327
+ setCachedResult(getCacheKey(opts.label, criteria.systemPrompt, userMessage), {
328
+ label: gateLabel,
329
+ confidence: 0.5,
330
+ raw: gateLabel,
331
+ tier: "gate",
332
+ latencyMs: latency,
333
+ });
334
+ }
335
+ return {
336
+ label: gateLabel,
337
+ confidence: 0.5,
338
+ raw: gateLabel,
339
+ tier: "gate",
340
+ latencyMs: latency,
341
+ };
342
+ }
343
+ log.debug("[text-classifier] TIER 0 (binary gate) ambiguous, falling to TIER 1");
344
+ }
345
+
346
+ // ── Tier 1: Heuristic fallback (fast, no LLM cost) ──────────────────────
347
+ // Skipped entirely when tierPolicy === "always-llm" (accuracy-critical
348
+ // classifiers where a wrong heuristic answer is worse than LLM cost).
349
+ if (options?.fallback && options?.tierPolicy !== "always-llm") {
350
+ const heuristicLabel = await options.fallback();
351
+ const lower = heuristicLabel?.trim().toLowerCase();
352
+ // Accept any non-empty short string as a valid fallback label.
353
+ // Previously the check was `=== "yes" || === "no"` which silently
354
+ // dropped fallbacks returning labels like "positive"/"negative",
355
+ // "rate_limit"/"server_error", "SHALL"/"MUST"/"SHOULD"/"MAY",
356
+ // "STABLE"/"DEGRADED", "pipeline"/"loop"/"info"/"edit" -- and
357
+ // consulted the LLM anyway, defeating the "fast and free" promise
358
+ // of tier 1 for ~30% of critics.
359
+ //
360
+ // Sanity cap at 20 chars: a real classification label is short;
361
+ // anything longer is probably a verbose error message and should
362
+ // fall through to the LLM.
363
+ if (lower && lower.length > 0 && lower.length <= 20) {
364
+ // If a validLabels whitelist is set, the heuristic's answer must
365
+ // match. Otherwise fall through to LLM. This prevents the
366
+ // tier-1 widening bug from silently accepting wrong categories.
367
+ const inValidSet = !options.validLabels || options.validLabels.includes(lower);
368
+ if (inValidSet) {
369
+ // tierPolicy === "fallback-only" reduces confidence to 0.5 to
370
+ // signal the heuristic is known-fragile; downstream code can
371
+ // treat this as "trust but verify".
372
+ const confidence = options.tierPolicy === "fallback-only" ? 0.5 : 0.7;
373
+ const latency = Date.now() - start;
374
+ log.debug(`[text-classifier] TIER 1 (heuristic): "${lower}" ${latency}ms`);
375
+ if (options.label) recordCriticCall(options.label, "heuristic", latency);
376
+ return {
377
+ label: lower,
378
+ confidence,
379
+ raw: heuristicLabel,
380
+ tier: "heuristic",
381
+ latencyMs: latency,
382
+ };
383
+ }
384
+ log.debug(
385
+ `[text-classifier] TIER 1 heuristic "${lower}" not in validLabels, falling to TIER 2`,
386
+ );
387
+ }
388
+ // Heuristic was ambiguous - fall through to LLM
389
+ log.debug("[text-classifier] Heuristic ambiguous, falling to TIER 2");
390
+ } else if (options?.tierPolicy === "always-llm") {
391
+ log.debug("[text-classifier] TIER 1 skipped (tierPolicy=always-llm)");
392
+ }
393
+
394
+ // ── Cache check: between Tier 1 (heuristic) and Tier 2 (LLM) ─────────────
395
+ // Skip the cache for tierPolicy=always-llm (the caller explicitly wants
396
+ // an LLM call, not a cached or heuristic result). Also skip when no
397
+ // label is provided (we have nothing to record the cache hit against
398
+ // and the caller doesn't care about analytics).
399
+ if (options?.label && options?.tierPolicy !== "always-llm") {
400
+ const cacheKey = getCacheKey(options.label, criteria.systemPrompt, userMessage);
401
+ const cached = getCachedResult(cacheKey);
402
+ if (cached) {
403
+ const latency = Date.now() - start;
404
+ log.debug(
405
+ `[text-classifier] CACHE HIT for "${options.label}" ${latency}ms (was ${cached.tier})`,
406
+ );
407
+ // Record as "cache" tier with the cached usage (0 tokens since the
408
+ // result was from cache, not an LLM call) so analytics can
409
+ // distinguish cache hits from heuristic wins.
410
+ recordCriticCall(options.label, "cache", latency, {
411
+ input: 0,
412
+ output: 0,
413
+ });
414
+ return {
415
+ label: cached.label,
416
+ confidence: cached.confidence,
417
+ raw: cached.raw,
418
+ tier: "cache",
419
+ latencyMs: latency,
420
+ };
421
+ }
422
+ }
423
+
424
+ // ── LLM Tier loop: strategy-driven ordering ─────────────────────────────
425
+ // Build the ordered list of model tiers based on modelPreference strategy.
426
+ // Each tier is tried in sequence; the first success wins.
427
+ const tierOrder = buildTierOrder(options?.modelPreference ?? "balanced", ctx);
428
+ const failureReasons: string[] = [];
429
+
430
+ for (const [tierIndex, tier] of tierOrder.entries()) {
431
+ const tierNum = tierIndex + 2; // LLM tiers start at 2 (tier 1 = heuristic)
432
+
433
+ const result = await tryModelCall(
434
+ ctx,
435
+ tier.model,
436
+ criteria.systemPrompt,
437
+ userMessage,
438
+ maxTokens,
439
+ timeoutMs,
440
+ 0, // maxRetries: 0 - classify calls should fail fast, not retry
441
+ options?.validLabels,
442
+ );
443
+
444
+ if (result && result.ok) {
445
+ const latency = Date.now() - start;
446
+ log.debug(
447
+ `[text-classifier] TIER ${tierNum} (${tier.name} -> ${tier.model.id}): "${result.label}" ${latency}ms`,
448
+ );
449
+ if (options?.label) recordCriticCall(options.label, tier.name, latency, result.usage);
450
+ // Cache the result for future identical calls within TTL
451
+ if (options?.label) {
452
+ setCachedResult(getCacheKey(options.label, criteria.systemPrompt, userMessage), {
453
+ label: result.label,
454
+ confidence: tier.confidence,
455
+ raw: result.raw,
456
+ tier: tier.name,
457
+ latencyMs: latency,
458
+ });
459
+ }
460
+ return {
461
+ label: result.label,
462
+ confidence: tier.confidence,
463
+ raw: result.raw,
464
+ tier: tier.name,
465
+ latencyMs: latency,
466
+ };
467
+ }
468
+
469
+ const reason = result && !result.ok ? result.reason : "unknown failure";
470
+ failureReasons.push(`TIER ${tierNum} (${tier.name} '${tier.model.id}'): ${reason}`);
471
+ logTierFailure(`TIER ${tierNum} failed (${tier.name} model '${tier.model.id}'): ${reason}.`);
472
+ }
473
+
474
+ const latency = Date.now() - start;
475
+ const allFailedMsg =
476
+ `ALL TIERS FAILED - returning "unknown" ${latency}ms. ` + failureReasons.join(" ");
477
+ logTierFailure(allFailedMsg);
478
+ if (options?.label) recordCriticCall(options.label, "failed", latency);
479
+ return { label: "unknown", confidence: 0, raw: "", tier: "failed", latencyMs: latency };
480
+ }
481
+
482
+ // ── Internals ────────────────────────────────────────────────────────────────
483
+
484
+ /**
485
+ * Normalize a model response to a valid label.
486
+ *
487
+ * - If `validLabels` is provided, accept any label in that set
488
+ * (case-insensitive exact match). This is the multi-class path used by
489
+ * critics like `trajectoryPattern` that return hyphenated pattern names
490
+ * like "Read-Edit-Bash" instead of yes/no.
491
+ * - Otherwise fall back to binary yes/no (the default for ~30 critics).
492
+ *
493
+ * Returns null if the response doesn't match. The classifier then falls
494
+ * through to the next tier, rather than silently defaulting to "no" which
495
+ * would mask the underlying prompt/model issue.
496
+ *
497
+ * Exported for testing.
498
+ */
499
+ export function normalizeLabel(raw: string, validLabels?: string[]): string | null {
500
+ const trimmed = raw.trim();
501
+ // Empty or whitespace-only response: the model returned nothing.
502
+ // Some smaller models (mistral-small, Venice-routed) do this when
503
+ // uncertain or when the prompt format confuses them. We treat this
504
+ // as unparseable (return null) so the classifier falls through to
505
+ // the next tier, rather than silently defaulting to "no" which
506
+ // would mask the underlying prompt/model issue.
507
+ if (trimmed.length === 0) return null;
508
+ const lower = trimmed.toLowerCase();
509
+ // Multi-class path: any label in the whitelist is accepted verbatim.
510
+ // We compare case-insensitively because some models (mistral-small
511
+ // in particular) return "read-edit-bash" instead of "Read-Edit-Bash".
512
+ if (validLabels && validLabels.length > 0) {
513
+ const validSet = new Set(validLabels.map((l) => l.toLowerCase()));
514
+ if (validSet.has(lower)) return lower;
515
+ // Don't return null yet - fall through to the yes/no check below
516
+ // in case the critic's validLabels is a small whitelist and the
517
+ // model produced a "yes"/"no" answer (e.g. when uncertain about
518
+ // which pattern fits). This is a defensive fallback.
519
+ }
520
+ // Binary yes/no path (default for the majority of critics).
521
+ if (/^yes\b/.test(lower) || lower === "yes") return "yes";
522
+ if (/^no\b/.test(lower) || lower === "no") return "no";
523
+ return null;
524
+ }
525
+
526
+ /**
527
+ * Budget for the one-shot retry after a model exhausts its output budget
528
+ * without emitting text. Thinking spurts of ~3.3k tokens were observed for
529
+ * deepseek-v4-1-flash on a hard classification prompt; 8k leaves headroom
530
+ * while still bounding the worst-case burn of a single retry.
531
+ */
532
+ const RETRY_BUDGET_TOKENS = 8_192;
533
+
534
+ /**
535
+ * Attempt a single classification model call, plus a one-shot
536
+ * enlarged-budget retry when the model exhausted its budget on reasoning.
537
+ *
538
+ * Retry rationale: `reasoning: "off"` is advisory. Providers that do not
539
+ * honor it (venice-routed deepseek-v4-1-flash defaults to thinking when no
540
+ * explicit effort is sent) let the thinking channel count against the
541
+ * output budget; if it consumes the whole budget the response is
542
+ * stopReason=length with no text at all. That is recoverable by giving the
543
+ * model room to finish. Exactly one retry, only on that signature and only
544
+ * on the default-budget path: an explicit maxTokens is the caller's hard
545
+ * cap, and a non-empty unparseable answer is a prompt-format problem a
546
+ * larger budget will not fix.
547
+ *
548
+ * Returns the full trimmed lowercase response on success, null on any failure.
549
+ * The caller should use normalizeLabel() to parse the result.
550
+ *
551
+ * Signal handling:
552
+ * Threads `ctx.signal` (when present) through to callLlm. Without this,
553
+ * pressing ESC during the user's main turn only aborts the turn's LLM
554
+ * call - braid's parallel classify() / consolidation / sop-extractor
555
+ * calls keep running until their own internal timeouts fire, producing
556
+ * misleading "Request was aborted" error logs long after the user
557
+ * already moved.
558
+ *
559
+ * ctx.signal is defined when the agent is streaming OR when its session
560
+ * signal is still active. For post-loop best-effort callers (e.g.
561
+ * detectPatternWithLLM from agent_end), ctx.signal is typically undefined
562
+ * because the agent is idle - in that case the internal timeout is the
563
+ * only abort path. That's the right behavior: post-loop work shouldn't
564
+ * abort when the agent goes idle.
565
+ */
566
+ async function tryModelCall(
567
+ ctx: ExtensionContext,
568
+ model: Model<Api>,
569
+ systemPrompt: string,
570
+ userMessage: string,
571
+ maxTokens: number | undefined,
572
+ timeoutMs: number,
573
+ maxRetries = 0,
574
+ validLabels?: string[],
575
+ ): Promise<ModelCallOutcome> {
576
+ const first = await attemptModelCall(
577
+ ctx,
578
+ model,
579
+ systemPrompt,
580
+ userMessage,
581
+ maxTokens,
582
+ timeoutMs,
583
+ maxRetries,
584
+ validLabels,
585
+ );
586
+ if (!first || first.ok || !first.budgetExhausted) return first;
587
+ // An explicit budget is the caller's hard cap - never exceed it. The
588
+ // retry exists for the default path, where callLlm sizes a budget
589
+ // (1000-4000) without knowing the model thinks past it.
590
+ if (maxTokens !== undefined) return first;
591
+
592
+ const retryMaxTokens = Math.min(
593
+ RETRY_BUDGET_TOKENS,
594
+ // Never exceed the model's own output ceiling - a budget above it is a
595
+ // client-side error, not a bigger answer.
596
+ model.maxTokens ?? Number.POSITIVE_INFINITY,
597
+ );
598
+ log.debug(
599
+ `[text-classifier] ${model.id} exhausted its output budget with no text; ` +
600
+ `retrying once with maxTokens=${retryMaxTokens}`,
601
+ );
602
+ const retry = await attemptModelCall(
603
+ ctx,
604
+ model,
605
+ systemPrompt,
606
+ userMessage,
607
+ retryMaxTokens,
608
+ timeoutMs,
609
+ maxRetries,
610
+ validLabels,
611
+ );
612
+ // Prefer the retry's outcome either way: on success it carries the label,
613
+ // on failure its reason contains the enlarged-budget diagnostic.
614
+ return retry ?? first;
615
+ }
616
+
617
+ type ModelCallOutcome =
618
+ | {
619
+ ok: true;
620
+ raw: string;
621
+ label: string;
622
+ usage: { input?: number; output?: number; totalTokens?: number } | undefined;
623
+ }
624
+ | { ok: false; reason: string; budgetExhausted?: boolean }
625
+ | null;
626
+
627
+ /**
628
+ * A single model call. Returns the parsed label on success, a failure
629
+ * reason otherwise. `budgetExhausted` marks the stopReason=length + empty
630
+ * response signature that tryModelCall retries with an enlarged budget.
631
+ */
632
+ async function attemptModelCall(
633
+ ctx: ExtensionContext,
634
+ model: Model<Api>,
635
+ systemPrompt: string,
636
+ userMessage: string,
637
+ maxTokens: number | undefined,
638
+ timeoutMs: number,
639
+ maxRetries = 0,
640
+ validLabels?: string[],
641
+ ): Promise<ModelCallOutcome> {
642
+ try {
643
+ const apiKey = await ctx.modelRegistry.getApiKeyForProvider(model.provider);
644
+ if (!apiKey) return { ok: false, reason: `no API key for provider ${model.provider}` };
645
+
646
+ const result = await callLlm(model, apiKey, systemPrompt, userMessage, {
647
+ // maxTokens is conditionally included so undefined defaults
648
+ // (let the provider / pi-ai decide) take effect. Passing
649
+ // `undefined` explicitly would be a no-op in TypeScript but
650
+ // the spread pattern is clearer at the call site.
651
+ ...(maxTokens !== undefined ? { maxTokens } : {}),
652
+ temperature: 0,
653
+ // Disable reasoning for yes/no classification.
654
+ // Many modern models (mistral-small, minimax-m3, ...) have
655
+ // `reasoning: true` by default. Thinking tokens count
656
+ // against max_tokens, so even a generous budget can burn
657
+ // entirely on thinking and produce 0 output tokens - the
658
+ // 'unparseable label: ""' symptom. pi-ai's clampThinkingLevel
659
+ // accepts "off" and gracefully maps it:
660
+ // - Models with "off" in their thinkingLevelMap: thinking
661
+ // disabled entirely (most efficient)
662
+ // - Models without "off" support: clamped to the lowest
663
+ // available level (e.g. "minimal")
664
+ // For classification, "off" is the right choice - yes/no
665
+ // is mechanical, no thinking needed.
666
+ reasoning: "off",
667
+ timeoutMs,
668
+ maxRetries,
669
+ // Thread the session signal so ESC + session-shutdown aborts
670
+ // braid's parallel LLM calls cleanly instead of letting them
671
+ // run until the internal timeout fires. ctx.signal is undefined
672
+ // when the agent is idle (e.g. detectPatternWithLLM from agent_end),
673
+ // so the spread skips cleanly and only the timeout-based abort
674
+ // path remains.
675
+ ...(ctx.signal ? { signal: ctx.signal } : {}),
676
+ });
677
+
678
+ if ("error" in result) {
679
+ // Surface the actual error to the caller's log so the operator
680
+ // can diagnose why the classifier is failing. The classify()
681
+ // function threads this into the TIER 2/3 failed warn so the
682
+ // user sees the actual underlying error in the TUI without
683
+ // having to dig into /logs.
684
+ log.debug(`[text-classifier] ${model.id} callLlm error: ${result.error}`);
685
+ return { ok: false, reason: result.error };
686
+ }
687
+
688
+ const raw = result.text.trim();
689
+ const label = normalizeLabel(raw, validLabels);
690
+ if (!label) {
691
+ // Model responded but with unparseable text. Distinguish the
692
+ // "stopReason=length" case (model hit the output ceiling) from the
693
+ // "model returned a wrong-format answer" case. Only the former is
694
+ // recoverable - the caller retries it once at a larger budget; the
695
+ // latter is a prompt-format issue and benefits from a clear
696
+ // diagnostic in the user-facing warn.
697
+ const stopReason = result.stopReason;
698
+ // The retryable signature: the model spent its whole budget without
699
+ // emitting any text at all (thinking-channel burn). A non-empty
700
+ // answer that fails to parse is NOT retried.
701
+ const budgetExhausted = stopReason === "length" && raw.length === 0;
702
+ // When maxTokens is undefined (the new default for classifier
703
+ // calls), we don't show the limit - the provider decides.
704
+ const limitInfo = maxTokens !== undefined ? `/${maxTokens}` : "";
705
+ const usageInfo = result.usage
706
+ ? `, used ${result.usage.output ?? "?"}${limitInfo} tokens`
707
+ : "";
708
+ log.debug(
709
+ `[text-classifier] ${model.id} returned unparseable label: ` +
710
+ `${JSON.stringify(raw).slice(0, 200)} (stopReason=${stopReason ?? "?"}${usageInfo})`,
711
+ );
712
+ return {
713
+ ok: false,
714
+ reason:
715
+ `unparseable label: ${JSON.stringify(raw).slice(0, 80)}` +
716
+ (stopReason
717
+ ? ` (stopReason=${stopReason}` +
718
+ (result.usage?.output !== undefined
719
+ ? `, used ${result.usage.output}${limitInfo} tokens`
720
+ : "") +
721
+ ")"
722
+ : ""),
723
+ budgetExhausted,
724
+ };
725
+ }
726
+
727
+ return { ok: true, raw, label, usage: result.usage };
728
+ } catch (e) {
729
+ const message = (e as Error).message;
730
+ log.debug(`[text-classifier] ${model.id} threw: ${message}`);
731
+ return { ok: false, reason: `threw: ${message}` };
732
+ }
733
+ }
734
+
735
+ /**
736
+ * Replace `{{key}}` placeholders with values from the substitutions map.
737
+ * Uses single-pass regex to prevent cross-key injection:
738
+ * if a substitution value contains `{{otherKey}}`, it won't be re-processed.
739
+ * Exported for testing.
740
+ */
741
+ export function replacePlaceholders(
742
+ template: string,
743
+ substitutions: Record<string, string>,
744
+ ): string {
745
+ return template.replace(/\{\{(\w+)\}\}/g, (_, key) => substitutions[key] ?? `{{${key}}}`);
746
+ }