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,817 @@
1
+ /**
2
+ * Skills Auto-Injection — relevant skill suggestion via steer whisper.
3
+ *
4
+ * Agenda:
5
+ * Instead of requiring the agent to discover skills via `list_skills` tool,
6
+ * proactively detect when a skill is relevant to the current task and inject
7
+ * a suggestion via the steer whisper pattern.
8
+ *
9
+ * Design:
10
+ * 1. Relevance detection: keyword match of skill name/description plus
11
+ * frontmatter trigger phrases against the user's current prompt.
12
+ * Qualification bar: a skill whose match never touches its NAME (name
13
+ * token or trigger phrase) must reach a score of at least
14
+ * MIN_NON_NAME_SCORE — a lone description/path keyword hit is too weak
15
+ * a signal: it fires broad skills on almost any prompt.
16
+ * Keywords are stemmed with one suffix rule (trailing s/es) so plural
17
+ * prompts hit singular name tokens ("skills" → "skill").
18
+ * 2. Session-scoped state: track which skills were injected on which turn.
19
+ * Cooldown is per-skill on top of the global floor: an injected skill
20
+ * cools down at least COOLDOWN_TURNS, and once it was actually loaded
21
+ * (detected read) it cools down LOADED_COOLDOWN_TURNS — re-suggesting
22
+ * a skill that is already in context is noise.
23
+ * 3. Slot management: at most MAX_INJECTED skills hold a slot. A loaded
24
+ * skill releases its slot — it is in the agent's context now. A slot
25
+ * whose skill was never loaded stays held until its entry ages out of
26
+ * the cooldown history: measured over the recorded suggestion corpus,
27
+ * every recycling variant (score-margin eviction, windowed slots, a
28
+ * third slot) admits fills that convert far below the incumbent rate,
29
+ * so the cap deliberately throttles. Injection history is pruned once
30
+ * every cooldown window it can influence has expired.
31
+ * 4. Injection: sendTrackedMessage with deliverAs: "steer", triggerTurn: false,
32
+ * bypassing the per-turn whisper cap. The steer whisper is non-blocking
33
+ * (the agent reads it but does not pause its turn loop). The bypass is
34
+ * the module's delivery guarantee: this whisper is the only channel that
35
+ * can surface a matching skill, it is bounded by the module's own budget
36
+ * (COOLDOWN_TURNS, MAX_INJECTED, one send per turn), and the
37
+ * once-per-session hygiene whisper is delivered earlier in the same
38
+ * before_agent_start at the same priority, so without the bypass the
39
+ * cap would drop the suggestion exactly in the turn where a skill is
40
+ * most likely to match.
41
+ * `sendTrackedMessage` reports whether the message was accepted; a
42
+ * suppressed suggestion is neither sent nor counted.
43
+ * 5. Content delivery: the whisper carries a BOUNDED
44
+ * excerpt of the matching skill's SKILL.md body (frontmatter stripped,
45
+ * ≤ MAX_EXCERPT_CHARS) plus an explicit read pointer to the full file —
46
+ * so skill content actually reaches the agent's view at the moment a
47
+ * domain matches, not just a truncated description. Best-effort: an
48
+ * unreadable file falls back to the description.
49
+ * 6. No reply ritual: the whisper points at the SKILL.md read and stops
50
+ * there — a read is the conversion signal, and the solicited one-line
51
+ * reply is honored 2% of the time (channel noise, not information).
52
+ * 7. Adoption counter: per-skill `suggested`/`loaded` counters,
53
+ * incremented on delivery and on load, surfaced by the `skill_stats`
54
+ * tool. `suggested` counts DELIVERED suggestions: the counter increments
55
+ * only after `sendTrackedMessage` reports the whisper was accepted, so
56
+ * the number measures the suggestion channel rather than the intent to
57
+ * use it. A load has two evidence grades — a verbal claim (the LOADED
58
+ * probe reply, an honor-system grade the whisper does not solicit; the
59
+ * counter stays monotone for the store's series) and a detected actual
60
+ * load (SKILL.md read seen by the tool_result read-detector; failed
61
+ * reads are skipped — an error result is not a load). Both increment
62
+ * `loaded`, so the all-time series stays continuous;
63
+ * `claimed`/`actual` record which trigger fired, and the detected read
64
+ * is the primary signal — sessionHasSkillLoad gates on actual loads
65
+ * only. Durable store rows carry an `epoch` marking which counting
66
+ * regime their `suggested` number mixes (rows written before the
67
+ * delivered-only regime normalize to "mixed": inflated, not comparable
68
+ * to delivered-regime counts), and rows written before the
69
+ * claimed/actual split normalize with actual = loaded, claimed = 0.
70
+ * 8. Discovery record: after a compaction, pi's section rebuild can put
71
+ * the stock skill catalog back into the persisted transcript (braid
72
+ * suppresses it per-turn, but the post-compaction diff runs against
73
+ * pi's own options). The module records whether the catalog is present
74
+ * and surfaces the state through skill_stats instead of mutating the
75
+ * transcript.
76
+ * 9. Best-effort: failures are non-fatal, logged at debug level.
77
+ *
78
+ * Structure matches the existing steer whisper pattern used by topic-drift,
79
+ * turn-outcome, compaction-retry, context-lifecycle, and others.
80
+ *
81
+ * Integration:
82
+ * Registered in skills-tool/index.ts extension factory.
83
+ * Consumes the module-level skill cache populated by prompt-builder's
84
+ * before_agent_start handler.
85
+ */
86
+ import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
87
+ import { dirname } from "node:path";
88
+ import { createLogger } from "../../../lib/core/logger.js";
89
+ import { sendTrackedMessage } from "../../../lib/utils/injection-tracker.js";
90
+ import { getExtensionState } from "../../../lib/state/extension-state.js";
91
+ import { BRAID_INJECTED, BRAID_SOURCE } from "../../../lib/constants/injection-details.js";
92
+ import { getSkillsUsageFilePath } from "../../../lib/config/braid-paths.js";
93
+ import { SESSION_COMPACT, AGENT_SETTLED } from "../../../lib/core/event-names.js";
94
+ import { getSessionProfile, recordSessionSkillLoad, recordSessionStart, } from "./session-records.js";
95
+ import { triggerMatches } from "./skill-triggers.js";
96
+ const log = createLogger("skills-auto-inject");
97
+ // Constants
98
+ /**
99
+ * Max skill suggestions holding a slot at any time.
100
+ *
101
+ * The cap is the channel's throttle, and measurement says it must stay 2: a
102
+ * third slot's fills convert far below the incumbent rate, and every
103
+ * eviction/recycling variant that frees slots admits fills no better — the
104
+ * loads a bigger cap would "recover" were outranked by other live matches,
105
+ * not starved of slots.
106
+ */
107
+ export const MAX_INJECTED = 2;
108
+ /**
109
+ * Global cooldown floor: minimum turns before ANY skill can be re-injected.
110
+ * Every injected skill cools down at least this long, whatever its own history.
111
+ */
112
+ export const COOLDOWN_TURNS = 10;
113
+ /**
114
+ * Per-skill cooldown extension: a suggested skill that was actually loaded
115
+ * sits in the agent's context, so after its load it cools down for
116
+ * LOADED_COOLDOWN_TURNS (3× the floor) and releases its suggestion slot for
117
+ * the next match — re-suggesting an in-context skill is noise.
118
+ */
119
+ export const LOADED_COOLDOWN_TURNS = 30;
120
+ /** Minimum keyword length to consider significant. */
121
+ const MIN_KEYWORD_LENGTH = 4;
122
+ /**
123
+ * Max characters of SKILL.md body content carried in a suggestion whisper,
124
+ * per skill. Bounded so the steer stays a whisper (~2 skills × 300 chars +
125
+ * boilerplate). The whisper always points at the full file for the rest.
126
+ */
127
+ export const MAX_EXCERPT_CHARS = 300;
128
+ /**
129
+ * Minimum score for a skill whose match never touches its NAME (description
130
+ * and/or filePath keyword hits only). Name matches qualify at any score.
131
+ */
132
+ export const MIN_NON_NAME_SCORE = 2;
133
+ /**
134
+ * Common English words to exclude from keyword matching.
135
+ * Kept small — only the most frequent noise words that would
136
+ * produce false positives across many skills.
137
+ *
138
+ * NOT the same set as lib/ai/critic-helpers.ts STOP_WORDS:
139
+ * that list is a grammatical/text-normalization stop list for similarity
140
+ * scoring; this one additionally filters domain noise words (work, tool,
141
+ * code, file, task) for skill keyword extraction and deliberately omits
142
+ * most function words (keyword matching needs them rare-but-meaningful).
143
+ * Different sets with different jobs — deliberately not merged.
144
+ */
145
+ const KEYWORD_STOP_WORDS = new Set([
146
+ "this",
147
+ "that",
148
+ "with",
149
+ "from",
150
+ "have",
151
+ "been",
152
+ "were",
153
+ "they",
154
+ "what",
155
+ "when",
156
+ "where",
157
+ "which",
158
+ "about",
159
+ "into",
160
+ "than",
161
+ "then",
162
+ "also",
163
+ "just",
164
+ "some",
165
+ "more",
166
+ "make",
167
+ "like",
168
+ "know",
169
+ "will",
170
+ "would",
171
+ "could",
172
+ "should",
173
+ "their",
174
+ "them",
175
+ "very",
176
+ "your",
177
+ "over",
178
+ "such",
179
+ "each",
180
+ "only",
181
+ "other",
182
+ "after",
183
+ "before",
184
+ "work",
185
+ "tool",
186
+ "code",
187
+ "file",
188
+ "task",
189
+ "need",
190
+ "look",
191
+ ]);
192
+ const STATE_KEY = "skills-auto-inject";
193
+ function getState(ctx) {
194
+ return getExtensionState(ctx, STATE_KEY, () => ({
195
+ injected: [],
196
+ currentTurn: 0,
197
+ hintSent: false,
198
+ }));
199
+ }
200
+ // Shared module-level variable rather than a per-module copy: the import
201
+ // cycle is safe — index.ts calls setCachedSkills, auto-inject reads
202
+ // getCachedSkills.
203
+ let _skillsCache = [];
204
+ /** Called by index.ts's setCachedSkills to keep the auto-inject cache in sync. */
205
+ export function updateSkillCache(skills) {
206
+ _skillsCache = skills;
207
+ }
208
+ // Keyword Extraction
209
+ /**
210
+ * One-rule stemmer: strip a trailing plural s/es so "skills" matches the
211
+ * "skill" name token. Kept deliberately crude — one suffix rule, no
212
+ * dictionary — because the matcher needs recall on plurals, not linguistics:
213
+ * "sses"/"xes"/"zes"/"ches"/"shes" → strip es (classes→class, boxes→box)
214
+ * other trailing s (not ss) → strip s (skills→skill, memes→meme)
215
+ * Everything else passes through unchanged.
216
+ */
217
+ export function stemKeyword(word) {
218
+ if (/sses$/.test(word) || /(?:x|z|ch|sh)es$/.test(word))
219
+ return word.slice(0, -2);
220
+ if (word.endsWith("s") && !word.endsWith("ss"))
221
+ return word.slice(0, -1);
222
+ return word;
223
+ }
224
+ /**
225
+ * Extract significant keywords from a text string.
226
+ * Filters out stop words, short words, and non-alphabetic tokens, then stems
227
+ * trailing plurals; the stem result must still pass the length and stop-word
228
+ * bar (stemming "tasks" lands on the noise word "task", which stays out).
229
+ */
230
+ export function extractKeywords(text) {
231
+ const words = text
232
+ .toLowerCase()
233
+ .split(/[^a-z0-9]+/)
234
+ .filter((w) => w.length >= MIN_KEYWORD_LENGTH && !KEYWORD_STOP_WORDS.has(w) && /[a-z]/.test(w))
235
+ .map(stemKeyword)
236
+ .filter((w) => w.length >= MIN_KEYWORD_LENGTH && !KEYWORD_STOP_WORDS.has(w));
237
+ return [...new Set(words)];
238
+ }
239
+ // Relevance Scoring
240
+ /**
241
+ * Score a skill against a set of keywords.
242
+ *
243
+ * Scoring rules:
244
+ * +3 skill name contains a keyword (exact match)
245
+ * +2 skill name contains a keyword as substring
246
+ * +2 a frontmatter trigger phrase occurs in the prompt (word-bounded)
247
+ * +1 skill description contains a keyword
248
+ * +1 skill filePath contains a keyword (e.g. "research" in "research/SKILL.md")
249
+ *
250
+ * A trigger hit counts as a name hit: the phrase is the skill author's own
251
+ * relevance signal, so it qualifies the skill the same way a name match does.
252
+ *
253
+ * Qualification bar: a skill whose match never touches its NAME (description
254
+ * and/or filePath hits only) must reach a total score of at least
255
+ * MIN_NON_NAME_SCORE — one description keyword is too weak a signal and
256
+ * lets generic skills fire on almost any prompt. Name and trigger matches
257
+ * always qualify.
258
+ *
259
+ * `promptText` (lowercased by the caller or raw — matching is case-insensitive
260
+ * on our side) enables trigger matching; omit it where the raw prompt is not
261
+ * available and only keyword scoring should run.
262
+ *
263
+ * Returns 0 if the skill does not qualify.
264
+ */
265
+ export function scoreSkill(skill, keywords, promptText) {
266
+ let score = 0;
267
+ let nameHit = false;
268
+ const name = skill.name.toLowerCase();
269
+ const desc = skill.description.toLowerCase();
270
+ const path = skill.filePath.toLowerCase();
271
+ for (const trig of skill.triggers ?? []) {
272
+ if (triggerMatches(trig, promptText ?? "")) {
273
+ score += 2;
274
+ nameHit = true;
275
+ }
276
+ }
277
+ for (const kw of keywords) {
278
+ // Exact token match in name
279
+ if (name.split(/[^a-z0-9]+/).includes(kw)) {
280
+ score += 3;
281
+ nameHit = true;
282
+ continue;
283
+ }
284
+ // Substring match in name (catches compound names like "code-search")
285
+ if (name.includes(kw)) {
286
+ score += 2;
287
+ nameHit = true;
288
+ continue;
289
+ }
290
+ // Description contains keyword
291
+ if (desc.includes(kw)) {
292
+ score += 1;
293
+ continue;
294
+ }
295
+ // File path matches (e.g. "research" in "research/SKILL.md")
296
+ if (path.includes(kw)) {
297
+ score += 1;
298
+ }
299
+ }
300
+ if (!nameHit && score < MIN_NON_NAME_SCORE)
301
+ return 0;
302
+ return score;
303
+ }
304
+ /**
305
+ * Decide which scored skills to suggest given the session injection state.
306
+ * Pure — mirrors the handler's decision path so it can be unit-tested:
307
+ * sort (score desc, name asc) → cooldown filter (global floor + per-skill
308
+ * loaded extension) → slot budget over ACTIVE held slots (a loaded skill
309
+ * released its slot) → top-N slice.
310
+ *
311
+ * Returns the chosen scored items (empty when nothing qualifies). The
312
+ * caller is responsible for recording the picks in session state.
313
+ */
314
+ export function selectSuggestions(scored, injected, currentTurn) {
315
+ if (!scored.length)
316
+ return [];
317
+ const sorted = [...scored].sort((a, b) => b.score - a.score || a.skill.name.localeCompare(b.skill.name));
318
+ const available = sorted.filter((s) => !onCooldown(s.skill.name, injected, currentTurn));
319
+ if (!available.length)
320
+ return [];
321
+ // Active slots: not-yet-loaded injections. A loaded skill sits in the
322
+ // agent's context — its slot is released for the next match.
323
+ const active = injected.filter((i) => i.loadedTurn === undefined);
324
+ const slotBudget = MAX_INJECTED - active.length;
325
+ if (slotBudget <= 0)
326
+ return [];
327
+ return available.slice(0, slotBudget);
328
+ }
329
+ /**
330
+ * Cooldown gate: the global floor applies to every injection; a skill that
331
+ * was loaded after its injection additionally cools down for
332
+ * LOADED_COOLDOWN_TURNS from the load (it is already in context).
333
+ */
334
+ function onCooldown(name, injected, currentTurn) {
335
+ const prev = injected.find((i) => i.name === name);
336
+ if (!prev)
337
+ return false;
338
+ if (currentTurn - prev.turnNumber < COOLDOWN_TURNS)
339
+ return true;
340
+ if (prev.loadedTurn !== undefined && currentTurn - prev.loadedTurn < LOADED_COOLDOWN_TURNS) {
341
+ return true;
342
+ }
343
+ return false;
344
+ }
345
+ // Steer Whisper Content
346
+ /**
347
+ * Strip YAML frontmatter from a SKILL.md body. Pure.
348
+ *
349
+ * Agent Skills files open with `---\nkey: value...\n---`; the frontmatter
350
+ * duplicates the metadata we already have (name/description), so the excerpt
351
+ * starts at the actual instructions. Tolerant: files without frontmatter
352
+ * (or with an unclosed `---` block) are returned as-is.
353
+ */
354
+ export function stripSkillFrontmatter(content) {
355
+ const text = content.replace(/^\uFEFF/, "");
356
+ if (!text.startsWith("---"))
357
+ return text;
358
+ const lines = text.split(/\r?\n/);
359
+ if (lines.length < 3)
360
+ return text;
361
+ for (let i = 1; i < lines.length; i++) {
362
+ if (lines[i].trim() === "---") {
363
+ return lines
364
+ .slice(i + 1)
365
+ .join("\n")
366
+ .trim();
367
+ }
368
+ }
369
+ return text; // no closing delimiter — treat the whole doc as body
370
+ }
371
+ /**
372
+ * Bounded excerpt of a skill body: strip frontmatter, trim, cap at maxChars,
373
+ * mark truncation. Pure.
374
+ */
375
+ export function extractSkillExcerpt(content, maxChars = MAX_EXCERPT_CHARS) {
376
+ const body = stripSkillFrontmatter(content).trim();
377
+ if (body.length <= maxChars)
378
+ return body;
379
+ const cut = body.slice(0, maxChars);
380
+ // Cut at a word boundary when possible; always collapse trailing whitespace.
381
+ const boundary = cut.lastIndexOf(" ");
382
+ const slice = (boundary > maxChars * 0.6 ? cut.slice(0, boundary) : cut).trimEnd();
383
+ return slice + "…";
384
+ }
385
+ /**
386
+ * Read a SKILL.md from disk and return a bounded body excerpt.
387
+ * Returns "" on any error (missing file, unreadable) — the caller falls
388
+ * back to the skill description.
389
+ */
390
+ export function readSkillExcerpt(filePath, maxChars = MAX_EXCERPT_CHARS) {
391
+ try {
392
+ return extractSkillExcerpt(readFileSync(filePath, "utf-8"), maxChars);
393
+ }
394
+ catch {
395
+ return "";
396
+ }
397
+ }
398
+ /** Collapse whitespace/newlines to single spaces for a one-line whisper bullet. */
399
+ function toOneLine(text) {
400
+ return text.replace(/\s+/g, " ").trim();
401
+ }
402
+ /**
403
+ * Format the steer whisper content for a set of recommended skills.
404
+ *
405
+ * Each bullet carries a BOUNDED excerpt of the SKILL.md body (frontmatter
406
+ * stripped, ≤ MAX_EXCERPT_CHARS, collapsed to one line) plus an explicit
407
+ * read pointer to the full file — the agent sees real skill content at the
408
+ * moment of domain match, not just a truncated description. Unreadable
409
+ * files fall back to the description (also bounded, one line).
410
+ */
411
+ export function formatWhisper(skills) {
412
+ const lines = skills.map((s) => {
413
+ const excerpt = readSkillExcerpt(s.filePath) || s.description;
414
+ // Strip the truncation mark (if any) — the read pointer follows immediately.
415
+ const lead = toOneLine(excerpt)
416
+ .slice(0, MAX_EXCERPT_CHARS)
417
+ .replace(/\.\.\.$/, "")
418
+ .replace(/…$/, "");
419
+ return `- ${s.name}: ${lead} — read \`${s.filePath}\` for the full skill.`;
420
+ });
421
+ return (`[SKILL SUGGESTION] These skills match your current task; their content is excerpted below:\n` +
422
+ lines.join("\n") +
423
+ `\n(Use \`list_skills\` to see all available skills; read a SKILL.md file for full context.)`);
424
+ }
425
+ const STATS_KEY = "skills-usage-stats";
426
+ function getStats(ctx) {
427
+ return getExtensionState(ctx, STATS_KEY, () => ({}));
428
+ }
429
+ /** Read the session's per-skill usage counters (for the skill_stats tool). */
430
+ export function getSkillStats(ctx) {
431
+ return getStats(ctx);
432
+ }
433
+ /** Increment `suggested` for each skill name — called only AFTER a whisper
434
+ * was accepted for delivery, so the counter measures arrivals. */
435
+ export function recordSkillSuggestion(ctx, names) {
436
+ const stats = getStats(ctx);
437
+ for (const name of names) {
438
+ const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
439
+ s.suggested++;
440
+ recordDurable(name, "suggested");
441
+ }
442
+ }
443
+ /**
444
+ * Record a DETECTED load (SKILL.md read via the read tool) — the primary,
445
+ * verified load signal. Increments `loaded` + `actual`, and flips the
446
+ * session's durable adoption record to hadSkillLoad (the monthly rollup
447
+ * numerator; claims never set it).
448
+ */
449
+ export function recordSkillLoad(ctx, name) {
450
+ if (!name)
451
+ return;
452
+ const stats = getStats(ctx);
453
+ const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
454
+ s.loaded++;
455
+ s.actual++;
456
+ recordDurable(name, "actual");
457
+ recordSessionSkillLoad(ctx);
458
+ }
459
+ /**
460
+ * Record a CLAIMED load (a verbal "LOADED <name>" reply — the honor-system
461
+ * signal). The suggestion whisper does not solicit the reply, so this has no
462
+ * production caller; the export exists to keep `claimed` monotone in the
463
+ * durable store's published series. Increments `loaded` + `claimed`.
464
+ */
465
+ export function recordSkillClaim(ctx, name) {
466
+ if (!name)
467
+ return;
468
+ const stats = getStats(ctx);
469
+ const s = (stats[name] ??= { suggested: 0, loaded: 0, claimed: 0, actual: 0 });
470
+ s.loaded++;
471
+ s.claimed++;
472
+ recordDurable(name, "claim");
473
+ }
474
+ let _durableStore;
475
+ /** Normalize one raw file entry; undefined when the entry is not usable. */
476
+ function normalizeDurableEntry(raw) {
477
+ if (!raw || typeof raw !== "object" || Array.isArray(raw))
478
+ return undefined;
479
+ const r = raw;
480
+ const suggested = typeof r.suggested === "number" && Number.isFinite(r.suggested) ? r.suggested : 0;
481
+ const loaded = typeof r.loaded === "number" && Number.isFinite(r.loaded) ? r.loaded : 0;
482
+ const claimed = typeof r.claimed === "number" && Number.isFinite(r.claimed) ? r.claimed : 0;
483
+ // Rows written before the claimed/actual split carry only `loaded`:
484
+ // treat the whole count as actual (claimed 0) — no migration needed.
485
+ const actual = typeof r.actual === "number" && Number.isFinite(r.actual)
486
+ ? r.actual
487
+ : Math.max(0, loaded - claimed);
488
+ return {
489
+ suggested,
490
+ loaded,
491
+ claimed,
492
+ actual,
493
+ lastAt: typeof r.lastAt === "string" ? r.lastAt : "",
494
+ // Rows without an epoch predate the split: their `suggested` may mix
495
+ // pre-delivery-regime increments with delivered ones.
496
+ epoch: r.epoch === "delivered" ? "delivered" : "mixed",
497
+ };
498
+ }
499
+ /**
500
+ * Read the durable store from disk. Missing OR corrupt file → fresh start
501
+ * ({}). Never throws: the suggestion path depends on this staying safe.
502
+ */
503
+ function readDurableStore() {
504
+ try {
505
+ const parsed = JSON.parse(readFileSync(getSkillsUsageFilePath(), "utf-8"));
506
+ if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
507
+ return {};
508
+ const out = {};
509
+ for (const [name, entry] of Object.entries(parsed)) {
510
+ const normalized = normalizeDurableEntry(entry);
511
+ if (normalized)
512
+ out[name] = normalized;
513
+ }
514
+ return out;
515
+ }
516
+ catch {
517
+ return {}; // missing or corrupt → fresh start
518
+ }
519
+ }
520
+ /** In-memory durable store, lazily loaded once per process. */
521
+ function getDurableStore() {
522
+ if (!_durableStore)
523
+ _durableStore = readDurableStore();
524
+ return _durableStore;
525
+ }
526
+ /**
527
+ * Best-effort atomic-ish write (temp file + rename) of the durable store.
528
+ * Swallows every error: this runs on the whisper path — a stats failure must
529
+ * NEVER break suggestions. The first refusal in a process still warns (the
530
+ * sink may be refusing because no absolute braid root resolves); later ones
531
+ * stay at debug.
532
+ */
533
+ function persistDurableStore() {
534
+ try {
535
+ if (!_durableStore)
536
+ return;
537
+ const file = getSkillsUsageFilePath();
538
+ mkdirSync(dirname(file), { recursive: true });
539
+ const tmp = `${file}.${process.pid}.tmp`;
540
+ writeFileSync(tmp, JSON.stringify(_durableStore, null, 2));
541
+ renameSync(tmp, file);
542
+ }
543
+ catch (err) {
544
+ reportDurableFailure("write", err);
545
+ }
546
+ }
547
+ /** Warned once per process about a refused durable skills store. */
548
+ let _warnedDurableFailure = false;
549
+ function reportDurableFailure(action, err) {
550
+ const message = err instanceof Error ? err.message : String(err);
551
+ if (_warnedDurableFailure) {
552
+ log.debug(`[skills-auto-inject] durable stats ${action} failed (best-effort): ${message}`);
553
+ return;
554
+ }
555
+ _warnedDurableFailure = true;
556
+ log.warn(`[skills-auto-inject] durable stats ${action} failed (best-effort): ${message}`);
557
+ }
558
+ /** Record one durable event and flush to disk (best-effort). */
559
+ function recordDurable(name, kind) {
560
+ try {
561
+ const store = getDurableStore();
562
+ const entry = (store[name] ??= {
563
+ suggested: 0,
564
+ loaded: 0,
565
+ claimed: 0,
566
+ actual: 0,
567
+ lastAt: "",
568
+ epoch: "delivered",
569
+ });
570
+ if (kind === "suggested") {
571
+ entry.suggested++;
572
+ }
573
+ else {
574
+ entry.loaded++;
575
+ if (kind === "claim")
576
+ entry.claimed++;
577
+ else
578
+ entry.actual++;
579
+ }
580
+ entry.lastAt = new Date().toISOString();
581
+ persistDurableStore();
582
+ }
583
+ catch (err) {
584
+ reportDurableFailure("update", err);
585
+ }
586
+ }
587
+ /** Read the durable per-skill counters (for the skill_stats tool). */
588
+ export function getDurableSkillStats() {
589
+ return getDurableStore();
590
+ }
591
+ /**
592
+ * Resolve a skill name from a read-tool result: the SKILL.md frontmatter
593
+ * signature (`---\nname: <name>`) first, then the file path against the
594
+ * cached catalog. Returns undefined when the read is not a skill load.
595
+ *
596
+ * Exported for the read-detector tests (the list→read load path): the
597
+ * function is pure given the module-level cache, which tests seed via
598
+ * updateSkillCache().
599
+ */
600
+ export function skillNameFromRead(filePath, text) {
601
+ const fm = text.match(/^\s*---\s*\r?\n\s*name:\s*([^\s]+)/);
602
+ if (fm)
603
+ return fm[1];
604
+ if (filePath) {
605
+ const hit = _skillsCache.find((s) => s.filePath === filePath);
606
+ if (hit)
607
+ return hit.name;
608
+ const base = filePath.split(/[\\/]/).pop() ?? "";
609
+ if (base === "SKILL.md") {
610
+ const dir = filePath.split(/[\\/]/).slice(-2, -1)[0] ?? "";
611
+ const byDir = _skillsCache.find((s) => s.name === dir);
612
+ if (byDir)
613
+ return byDir.name;
614
+ }
615
+ }
616
+ return undefined;
617
+ }
618
+ const DISCOVERY_STATE_KEY = "skills-discovery";
619
+ /** The stock catalog's own tag — braid never writes this section itself. */
620
+ const STOCK_SKILLS_MARKER = "<available_skills>";
621
+ function getDiscoveryState(ctx) {
622
+ return getExtensionState(ctx, DISCOVERY_STATE_KEY, () => ({
623
+ compactions: 0,
624
+ pendingCatalogCheck: false,
625
+ }));
626
+ }
627
+ /** True when a persisted system message carries pi's stock skill catalog. */
628
+ function transcriptHasStockCatalog(ctx) {
629
+ const entries = ctx.sessionManager?.getEntries?.() ?? [];
630
+ return entries.some((entry) => {
631
+ const msg = entry
632
+ ?.message;
633
+ if (msg?.role !== "system" || typeof msg.sections?.skills !== "string")
634
+ return false;
635
+ return msg.sections.skills.includes(STOCK_SKILLS_MARKER);
636
+ });
637
+ }
638
+ /**
639
+ * Run the pending transcript check (one per compaction) and record the
640
+ * discovery mode. Returns the current record for skill_stats.
641
+ */
642
+ export function resolveDiscoveryMode(ctx) {
643
+ const state = getDiscoveryState(ctx);
644
+ if (state.pendingCatalogCheck) {
645
+ state.pendingCatalogCheck = false;
646
+ state.stockCatalogSeen = transcriptHasStockCatalog(ctx);
647
+ state.checkedAt = new Date().toISOString();
648
+ if (state.stockCatalogSeen) {
649
+ log.info(`[skills-auto-inject] stock skill catalog present in the transcript after compaction ` +
650
+ `(reason: ${state.lastCompactionReason ?? "unknown"})`);
651
+ }
652
+ }
653
+ return state;
654
+ }
655
+ // Main Handler
656
+ /**
657
+ * Register the auto-inject handler on before_agent_start plus the
658
+ * read-tool load detector on tool_result.
659
+ *
660
+ * Call this from the skills-tool extension factory, after registering
661
+ * the list_skills tool.
662
+ */
663
+ export function registerAutoInject(pi) {
664
+ // Count SKILL.md reads (the list→read load path) via the read tool, and
665
+ // per-skill: mark the matching injection as loaded (releases its slot and
666
+ // extends its cooldown — the skill is in the agent's context now).
667
+ pi.on("tool_result", (event, ctx) => {
668
+ try {
669
+ const ev = event;
670
+ if (ev?.toolName !== "read")
671
+ return;
672
+ // A failed read returns the error text, not the file — counting it
673
+ // inflated `loaded` with phantom loads (the read-detector never saw
674
+ // the skill content, and no SKILL.md was opened).
675
+ if (ev.isError)
676
+ return;
677
+ const text = (ev.content ?? []).map((c) => c.text ?? "").join("\n");
678
+ const name = skillNameFromRead(ev.input?.path, text);
679
+ if (name) {
680
+ const state = getState(ctx);
681
+ const held = state.injected.find((i) => i.name === name && i.loadedTurn === undefined);
682
+ if (held)
683
+ held.loadedTurn = state.currentTurn;
684
+ recordSkillLoad(ctx, name);
685
+ log.debug(`[skills-auto-inject] counted actual load of "${name}" via read`);
686
+ }
687
+ }
688
+ catch {
689
+ // best-effort — never break the tool loop over a counter
690
+ }
691
+ });
692
+ // Post-compaction the transcript can regain pi's stock skill catalog (the
693
+ // section diff is computed against pi's own prompt options, not braid's
694
+ // mutated ones). Recording that state change keeps the discovery surface
695
+ // honest; stripping the block would mean mutating persisted session
696
+ // entries — no sanctioned seam, not worth it.
697
+ pi.on(SESSION_COMPACT, (event, ctx) => {
698
+ try {
699
+ const state = getDiscoveryState(ctx);
700
+ state.compactions++;
701
+ state.lastCompactionReason =
702
+ typeof event?.reason === "string"
703
+ ? event.reason
704
+ : undefined;
705
+ state.pendingCatalogCheck = true;
706
+ }
707
+ catch {
708
+ // best-effort
709
+ }
710
+ });
711
+ // The rebuilt system message persists when the post-compaction run starts,
712
+ // so the check runs at settle — after the run's entries are on disk.
713
+ pi.on(AGENT_SETTLED, (_event, ctx) => {
714
+ try {
715
+ resolveDiscoveryMode(ctx);
716
+ }
717
+ catch {
718
+ // best-effort
719
+ }
720
+ });
721
+ pi.on("before_agent_start", async (event, ctx) => {
722
+ try {
723
+ // Once-per-session durable adoption record (the rollup denominator).
724
+ recordSessionStart(ctx);
725
+ const state = getState(ctx);
726
+ state.currentTurn++;
727
+ // Explicit-invocation-only skills are not advertised: pi hides them
728
+ // from its prompt block, so the suggestion whisper must not put them
729
+ // back in front of the model. The unfiltered cache still resolves an
730
+ // explicit read in skillNameFromRead().
731
+ const skills = _skillsCache.filter((s) => !s.disableModelInvocation);
732
+ const ev = event;
733
+ const prompt = ev.prompt ?? "";
734
+ if (!prompt.trim()) {
735
+ return; // No user input to match against
736
+ }
737
+ // One-shot profile hint: the first non-empty prompt of a session whose
738
+ // configured profile carries a hint gets exactly one steer — the hint
739
+ // text itself, byte-for-byte. Profiles without a hint and sessions
740
+ // matching no profile get nothing; an empty first prompt defers the
741
+ // fire to the next non-empty prompt, still once per session. Sent
742
+ // before the keyword path so the hint reaches the agent even when the
743
+ // skill cache is not populated yet.
744
+ const profile = getSessionProfile(ctx);
745
+ if (!state.hintSent && profile.hint) {
746
+ state.hintSent = true;
747
+ log.info(`[skills-auto-inject] profile hint whisper (profile "${profile.name}", first non-empty prompt)`);
748
+ sendTrackedMessage(pi, {
749
+ customType: "skills-boot",
750
+ content: [{ type: "text", text: profile.hint }],
751
+ display: true,
752
+ details: {
753
+ [BRAID_INJECTED]: true,
754
+ [BRAID_SOURCE]: "skills-auto-inject",
755
+ },
756
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "skills-auto-inject" });
757
+ }
758
+ if (!skills.length) {
759
+ return; // No skills loaded yet — nothing to suggest
760
+ }
761
+ const keywords = extractKeywords(prompt);
762
+ if (!keywords.length) {
763
+ return; // No significant keywords to match
764
+ }
765
+ // Score each skill. The raw prompt rides along for trigger matching.
766
+ const scored = skills
767
+ .map((s) => ({ skill: s, score: scoreSkill(s, keywords, prompt) }))
768
+ .filter((s) => s.score > 0);
769
+ if (!scored.length) {
770
+ return; // No relevant skills found
771
+ }
772
+ // Cooldown + slot budget (pure decision, exported for tests).
773
+ const toInject = selectSuggestions(scored, state.injected, state.currentTurn);
774
+ if (!toInject.length) {
775
+ return;
776
+ }
777
+ const skillsToInject = toInject.map((s) => s.skill);
778
+ const text = formatWhisper(skillsToInject);
779
+ // Delivery first, bookkeeping second: a suggestion that a suppression
780
+ // path drops must neither consume its cooldown slot nor move a counter.
781
+ // See the module header for why the cap is bypassed here.
782
+ const delivered = sendTrackedMessage(pi, {
783
+ customType: "skills-suggestion",
784
+ content: [{ type: "text", text }],
785
+ display: true,
786
+ details: {
787
+ [BRAID_INJECTED]: true,
788
+ [BRAID_SOURCE]: "skills-auto-inject",
789
+ skills: skillsToInject.map((s) => s.name),
790
+ },
791
+ }, { delivery: "park", deliverAs: "steer" }, { type: "context", source: "skills-auto-inject" }, { bypassFloodCap: true });
792
+ if (!delivered) {
793
+ log.debug("[skills-auto-inject] suggestion suppressed before delivery; not counted");
794
+ return;
795
+ }
796
+ log.info(`[skills-auto-inject] Suggesting ${skillsToInject.map((s) => s.name).join(", ")} ` +
797
+ `(turn ${state.currentTurn}, keywords: ${keywords.slice(0, 5).join(", ")})`);
798
+ for (const item of toInject) {
799
+ state.injected.push({
800
+ name: item.skill.name,
801
+ turnNumber: state.currentTurn,
802
+ filePath: item.skill.filePath,
803
+ });
804
+ }
805
+ // Bound the history: an entry whose loaded cooldown fully expired can
806
+ // no longer affect any cooldown or slot decision.
807
+ state.injected = state.injected.filter((i) => state.currentTurn - i.turnNumber < LOADED_COOLDOWN_TURNS ||
808
+ (i.loadedTurn !== undefined && state.currentTurn - i.loadedTurn < LOADED_COOLDOWN_TURNS));
809
+ // E3: per-skill suggestion counter — counts deliveries, not intent.
810
+ recordSkillSuggestion(ctx, skillsToInject.map((s) => s.name));
811
+ }
812
+ catch (err) {
813
+ log.debug(`[skills-auto-inject] Error in before_agent_start: ${err}`);
814
+ }
815
+ });
816
+ }
817
+ //# sourceMappingURL=auto-inject.js.map