pi-braid 0.0.0-stage → 0.40.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1011) hide show
  1. package/AGENTS.md +195 -0
  2. package/CONTRIBUTING.md +302 -0
  3. package/LICENSE +21 -0
  4. package/README.md +266 -2
  5. package/TOOLS.md +147 -0
  6. package/dist/extensions/cognitive/mars-reflector/index.d.ts +82 -0
  7. package/dist/extensions/cognitive/mars-reflector/index.js +327 -0
  8. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.d.ts +23 -0
  9. package/dist/extensions/cognitive/metacognition/handlers/claim-verification.js +233 -0
  10. package/dist/extensions/cognitive/metacognition/handlers/finalize.d.ts +27 -0
  11. package/dist/extensions/cognitive/metacognition/handlers/finalize.js +557 -0
  12. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.d.ts +19 -0
  13. package/dist/extensions/cognitive/metacognition/handlers/hypothesize.js +291 -0
  14. package/dist/extensions/cognitive/metacognition/handlers/scoring.d.ts +28 -0
  15. package/dist/extensions/cognitive/metacognition/handlers/scoring.js +173 -0
  16. package/dist/extensions/cognitive/metacognition/handlers/think-budget.d.ts +85 -0
  17. package/dist/extensions/cognitive/metacognition/handlers/think-budget.js +164 -0
  18. package/dist/extensions/cognitive/metacognition/handlers/think.d.ts +27 -0
  19. package/dist/extensions/cognitive/metacognition/handlers/think.js +374 -0
  20. package/dist/extensions/cognitive/metacognition/handlers/verify.d.ts +53 -0
  21. package/dist/extensions/cognitive/metacognition/handlers/verify.js +321 -0
  22. package/dist/extensions/cognitive/metacognition/index.d.ts +10 -0
  23. package/dist/extensions/cognitive/metacognition/index.js +90 -0
  24. package/dist/extensions/cognitive/reasoning/index.d.ts +43 -0
  25. package/dist/extensions/cognitive/reasoning/index.js +99 -0
  26. package/dist/extensions/cognitive/sycophancy-detector/index.d.ts +16 -0
  27. package/dist/extensions/cognitive/sycophancy-detector/index.js +203 -0
  28. package/dist/extensions/cognitive/topic-drift/index.d.ts +51 -0
  29. package/dist/extensions/cognitive/topic-drift/index.js +346 -0
  30. package/dist/extensions/cognitive/turn-outcome/index.d.ts +35 -0
  31. package/dist/extensions/cognitive/turn-outcome/index.js +163 -0
  32. package/dist/extensions/context-management/index.d.ts +77 -0
  33. package/dist/extensions/context-management/index.js +339 -0
  34. package/dist/extensions/core/agent-environment/index.d.ts +30 -0
  35. package/dist/extensions/core/agent-environment/index.js +89 -0
  36. package/dist/extensions/core/polyfill/index.d.ts +28 -0
  37. package/dist/extensions/core/polyfill/index.js +474 -0
  38. package/dist/extensions/core/prompt-builder/awareness-whisper.d.ts +74 -0
  39. package/dist/extensions/core/prompt-builder/awareness-whisper.js +116 -0
  40. package/dist/extensions/core/prompt-builder/context-section.d.ts +41 -0
  41. package/dist/extensions/core/prompt-builder/context-section.js +101 -0
  42. package/dist/extensions/core/prompt-builder/custom-sections.d.ts +21 -0
  43. package/dist/extensions/core/prompt-builder/custom-sections.js +11 -0
  44. package/dist/extensions/core/prompt-builder/external-tool-guidelines.d.ts +23 -0
  45. package/dist/extensions/core/prompt-builder/external-tool-guidelines.js +37 -0
  46. package/dist/extensions/core/prompt-builder/identity.d.ts +33 -0
  47. package/dist/extensions/core/prompt-builder/identity.js +77 -0
  48. package/dist/extensions/core/prompt-builder/index.d.ts +33 -0
  49. package/dist/extensions/core/prompt-builder/index.js +496 -0
  50. package/dist/extensions/core/prompt-builder/inspect.d.ts +58 -0
  51. package/dist/extensions/core/prompt-builder/inspect.js +182 -0
  52. package/dist/extensions/core/prompt-builder/instance-composition.d.ts +101 -0
  53. package/dist/extensions/core/prompt-builder/instance-composition.js +416 -0
  54. package/dist/extensions/core/prompt-builder/memory-section.d.ts +20 -0
  55. package/dist/extensions/core/prompt-builder/memory-section.js +60 -0
  56. package/dist/extensions/core/prompt-builder/pi-reference-section.d.ts +17 -0
  57. package/dist/extensions/core/prompt-builder/pi-reference-section.js +11 -0
  58. package/dist/extensions/core/prompt-builder/project-docs-section.d.ts +42 -0
  59. package/dist/extensions/core/prompt-builder/project-docs-section.js +72 -0
  60. package/dist/extensions/core/prompt-builder/section-parity.d.ts +36 -0
  61. package/dist/extensions/core/prompt-builder/section-parity.js +66 -0
  62. package/dist/extensions/core/prompt-builder/section-publish.d.ts +30 -0
  63. package/dist/extensions/core/prompt-builder/section-publish.js +16 -0
  64. package/dist/extensions/core/prompt-builder/section.d.ts +75 -0
  65. package/dist/extensions/core/prompt-builder/section.js +127 -0
  66. package/dist/extensions/core/prompt-builder/surface-discipline-section.d.ts +18 -0
  67. package/dist/extensions/core/prompt-builder/surface-discipline-section.js +20 -0
  68. package/dist/extensions/core/prompt-builder/system-info-tool.d.ts +27 -0
  69. package/dist/extensions/core/prompt-builder/system-info-tool.js +67 -0
  70. package/dist/extensions/core/prompt-builder/tool-description-trim.d.ts +56 -0
  71. package/dist/extensions/core/prompt-builder/tool-description-trim.js +129 -0
  72. package/dist/extensions/core/prompt-builder/tool-guidelines.d.ts +80 -0
  73. package/dist/extensions/core/prompt-builder/tool-guidelines.js +179 -0
  74. package/dist/extensions/core/prompt-builder/tool-pipelines.d.ts +50 -0
  75. package/dist/extensions/core/prompt-builder/tool-pipelines.js +69 -0
  76. package/dist/extensions/core/prompt-builder/top-level-extensions.d.ts +44 -0
  77. package/dist/extensions/core/prompt-builder/top-level-extensions.js +300 -0
  78. package/dist/extensions/core/skills-tool/auto-inject.d.ts +333 -0
  79. package/dist/extensions/core/skills-tool/auto-inject.js +817 -0
  80. package/dist/extensions/core/skills-tool/index.d.ts +56 -0
  81. package/dist/extensions/core/skills-tool/index.js +200 -0
  82. package/dist/extensions/core/skills-tool/loading-guidance.d.ts +50 -0
  83. package/dist/extensions/core/skills-tool/loading-guidance.js +87 -0
  84. package/dist/extensions/core/skills-tool/session-records.d.ts +114 -0
  85. package/dist/extensions/core/skills-tool/session-records.js +268 -0
  86. package/dist/extensions/core/skills-tool/skill-triggers.d.ts +48 -0
  87. package/dist/extensions/core/skills-tool/skill-triggers.js +113 -0
  88. package/dist/extensions/enforcement/detection/malformed.d.ts +9 -0
  89. package/dist/extensions/enforcement/detection/malformed.js +30 -0
  90. package/dist/extensions/enforcement/detection/verification.d.ts +10 -0
  91. package/dist/extensions/enforcement/detection/verification.js +34 -0
  92. package/dist/extensions/enforcement/enforcement-types.d.ts +33 -0
  93. package/dist/extensions/enforcement/enforcement-types.js +24 -0
  94. package/dist/extensions/enforcement/handler-registry.d.ts +12 -0
  95. package/dist/extensions/enforcement/handler-registry.js +196 -0
  96. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.d.ts +10 -0
  97. package/dist/extensions/enforcement/handlers/analysis/bpe-handler.js +37 -0
  98. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.d.ts +6 -0
  99. package/dist/extensions/enforcement/handlers/analysis/dreamer-handler.js +60 -0
  100. package/dist/extensions/enforcement/handlers/analysis/drift-handler.d.ts +6 -0
  101. package/dist/extensions/enforcement/handlers/analysis/drift-handler.js +75 -0
  102. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.d.ts +6 -0
  103. package/dist/extensions/enforcement/handlers/analysis/feedback-handler.js +19 -0
  104. package/dist/extensions/enforcement/handlers/analysis/mars-handler.d.ts +14 -0
  105. package/dist/extensions/enforcement/handlers/analysis/mars-handler.js +99 -0
  106. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.d.ts +6 -0
  107. package/dist/extensions/enforcement/handlers/analysis/reflection-handler.js +16 -0
  108. package/dist/extensions/enforcement/handlers/blocking.d.ts +16 -0
  109. package/dist/extensions/enforcement/handlers/blocking.js +33 -0
  110. package/dist/extensions/enforcement/handlers/message-analysis.d.ts +25 -0
  111. package/dist/extensions/enforcement/handlers/message-analysis.js +70 -0
  112. package/dist/extensions/enforcement/handlers/orphan-chains.d.ts +14 -0
  113. package/dist/extensions/enforcement/handlers/orphan-chains.js +44 -0
  114. package/dist/extensions/enforcement/handlers/over-correction-gate.d.ts +73 -0
  115. package/dist/extensions/enforcement/handlers/over-correction-gate.js +565 -0
  116. package/dist/extensions/enforcement/handlers/probe-handler.d.ts +31 -0
  117. package/dist/extensions/enforcement/handlers/probe-handler.js +111 -0
  118. package/dist/extensions/enforcement/handlers/register-adherence-meter.d.ts +52 -0
  119. package/dist/extensions/enforcement/handlers/register-adherence-meter.js +158 -0
  120. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.d.ts +3 -0
  121. package/dist/extensions/enforcement/handlers/register-agent-end-api-error.js +69 -0
  122. package/dist/extensions/enforcement/handlers/register-input-handler.d.ts +10 -0
  123. package/dist/extensions/enforcement/handlers/register-input-handler.js +35 -0
  124. package/dist/extensions/enforcement/handlers/register-message-end.d.ts +6 -0
  125. package/dist/extensions/enforcement/handlers/register-message-end.js +388 -0
  126. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.d.ts +25 -0
  127. package/dist/extensions/enforcement/handlers/register-post-cycle-hygiene.js +143 -0
  128. package/dist/extensions/enforcement/handlers/register-session-compact.d.ts +50 -0
  129. package/dist/extensions/enforcement/handlers/register-session-compact.js +207 -0
  130. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.d.ts +21 -0
  131. package/dist/extensions/enforcement/handlers/register-session-shutdown-resumption.js +116 -0
  132. package/dist/extensions/enforcement/handlers/register-session-shutdown.d.ts +6 -0
  133. package/dist/extensions/enforcement/handlers/register-session-shutdown.js +38 -0
  134. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.d.ts +34 -0
  135. package/dist/extensions/enforcement/handlers/register-session-start-discoverability.js +240 -0
  136. package/dist/extensions/enforcement/handlers/register-session-start.d.ts +16 -0
  137. package/dist/extensions/enforcement/handlers/register-session-start.js +198 -0
  138. package/dist/extensions/enforcement/handlers/register-tool-call.d.ts +6 -0
  139. package/dist/extensions/enforcement/handlers/register-tool-call.js +132 -0
  140. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.d.ts +18 -0
  141. package/dist/extensions/enforcement/handlers/register-tool-result-formatting.js +56 -0
  142. package/dist/extensions/enforcement/handlers/register-tool-result.d.ts +6 -0
  143. package/dist/extensions/enforcement/handlers/register-tool-result.js +91 -0
  144. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.d.ts +35 -0
  145. package/dist/extensions/enforcement/handlers/register-turn-end-hygiene.js +385 -0
  146. package/dist/extensions/enforcement/handlers/routing-handler.d.ts +42 -0
  147. package/dist/extensions/enforcement/handlers/routing-handler.js +135 -0
  148. package/dist/extensions/enforcement/handlers/tool-tracker.d.ts +9 -0
  149. package/dist/extensions/enforcement/handlers/tool-tracker.js +122 -0
  150. package/dist/extensions/enforcement/handlers/turn-analysis.d.ts +41 -0
  151. package/dist/extensions/enforcement/handlers/turn-analysis.js +109 -0
  152. package/dist/extensions/enforcement/handlers/turn-end-handler.d.ts +9 -0
  153. package/dist/extensions/enforcement/handlers/turn-end-handler.js +451 -0
  154. package/dist/extensions/enforcement/index.d.ts +15 -0
  155. package/dist/extensions/enforcement/index.js +22 -0
  156. package/dist/extensions/enforcement/judge-utils.d.ts +73 -0
  157. package/dist/extensions/enforcement/judge-utils.js +83 -0
  158. package/dist/extensions/enforcement/nudge-manager.d.ts +106 -0
  159. package/dist/extensions/enforcement/nudge-manager.js +203 -0
  160. package/dist/extensions/enforcement/self-state-claims.d.ts +79 -0
  161. package/dist/extensions/enforcement/self-state-claims.js +167 -0
  162. package/dist/extensions/enforcement/session-health.d.ts +107 -0
  163. package/dist/extensions/enforcement/session-health.js +251 -0
  164. package/dist/extensions/enforcement/signals.d.ts +54 -0
  165. package/dist/extensions/enforcement/signals.js +47 -0
  166. package/dist/extensions/enforcement/similarity.d.ts +16 -0
  167. package/dist/extensions/enforcement/similarity.js +64 -0
  168. package/dist/extensions/enforcement/state.d.ts +40 -0
  169. package/dist/extensions/enforcement/state.js +74 -0
  170. package/dist/extensions/enforcement/substate/context-hygiene-state.d.ts +88 -0
  171. package/dist/extensions/enforcement/substate/context-hygiene-state.js +119 -0
  172. package/dist/extensions/enforcement/substate/error-tracking-state.d.ts +20 -0
  173. package/dist/extensions/enforcement/substate/error-tracking-state.js +37 -0
  174. package/dist/extensions/enforcement/substate/memory-hygiene-state.d.ts +24 -0
  175. package/dist/extensions/enforcement/substate/memory-hygiene-state.js +37 -0
  176. package/dist/extensions/enforcement/substate/session-state.d.ts +34 -0
  177. package/dist/extensions/enforcement/substate/session-state.js +45 -0
  178. package/dist/extensions/enforcement/substate/thought-chain-state.d.ts +23 -0
  179. package/dist/extensions/enforcement/substate/thought-chain-state.js +43 -0
  180. package/dist/extensions/enforcement/substate/tool-tracking-state.d.ts +71 -0
  181. package/dist/extensions/enforcement/substate/tool-tracking-state.js +99 -0
  182. package/dist/extensions/enforcement/substate/verification-judge-state.d.ts +17 -0
  183. package/dist/extensions/enforcement/substate/verification-judge-state.js +39 -0
  184. package/dist/extensions/enforcement/task-evidence.d.ts +108 -0
  185. package/dist/extensions/enforcement/task-evidence.js +335 -0
  186. package/dist/extensions/enforcement/types.d.ts +35 -0
  187. package/dist/extensions/enforcement/types.js +5 -0
  188. package/dist/extensions/enforcement/validation.d.ts +12 -0
  189. package/dist/extensions/enforcement/validation.js +151 -0
  190. package/dist/extensions/enforcement/verification-judge.d.ts +110 -0
  191. package/dist/extensions/enforcement/verification-judge.js +214 -0
  192. package/dist/extensions/enforcement/whisper.d.ts +46 -0
  193. package/dist/extensions/enforcement/whisper.js +104 -0
  194. package/dist/extensions/heartbeat/analytics/ab-variant.d.ts +19 -0
  195. package/dist/extensions/heartbeat/analytics/ab-variant.js +86 -0
  196. package/dist/extensions/heartbeat/analytics/core.d.ts +12 -0
  197. package/dist/extensions/heartbeat/analytics/core.js +201 -0
  198. package/dist/extensions/heartbeat/analytics/format.d.ts +7 -0
  199. package/dist/extensions/heartbeat/analytics/format.js +111 -0
  200. package/dist/extensions/heartbeat/analytics/index.d.ts +14 -0
  201. package/dist/extensions/heartbeat/analytics/index.js +352 -0
  202. package/dist/extensions/heartbeat/analytics/shared.d.ts +85 -0
  203. package/dist/extensions/heartbeat/analytics/shared.js +69 -0
  204. package/dist/extensions/heartbeat/heartbeat-scheduler/index.d.ts +31 -0
  205. package/dist/extensions/heartbeat/heartbeat-scheduler/index.js +881 -0
  206. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.d.ts +10 -0
  207. package/dist/extensions/heartbeat/heartbeat-scheduler/meta-learning.js +49 -0
  208. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.d.ts +17 -0
  209. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.js +161 -0
  210. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.d.ts +13 -0
  211. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/budget.js +101 -0
  212. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.d.ts +10 -0
  213. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.js +221 -0
  214. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.d.ts +9 -0
  215. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/evolver.js +65 -0
  216. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.d.ts +8 -0
  217. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/measurement.js +32 -0
  218. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.d.ts +9 -0
  219. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/recaller.js +75 -0
  220. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.d.ts +9 -0
  221. package/dist/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.js +98 -0
  222. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.d.ts +14 -0
  223. package/dist/extensions/heartbeat/heartbeat-scheduler/policies.js +149 -0
  224. package/dist/extensions/heartbeat/heartbeat-scheduler/state.d.ts +22 -0
  225. package/dist/extensions/heartbeat/heartbeat-scheduler/state.js +82 -0
  226. package/dist/extensions/heartbeat/heartbeat-scheduler/types.d.ts +124 -0
  227. package/dist/extensions/heartbeat/heartbeat-scheduler/types.js +7 -0
  228. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.d.ts +52 -0
  229. package/dist/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.js +83 -0
  230. package/dist/extensions/manifest.d.ts +32 -0
  231. package/dist/extensions/manifest.js +251 -0
  232. package/dist/extensions/memory/context-lifecycle/helpers.d.ts +55 -0
  233. package/dist/extensions/memory/context-lifecycle/helpers.js +142 -0
  234. package/dist/extensions/memory/context-lifecycle/index.d.ts +17 -0
  235. package/dist/extensions/memory/context-lifecycle/index.js +977 -0
  236. package/dist/extensions/memory/context-lifecycle/policy-engine.d.ts +50 -0
  237. package/dist/extensions/memory/context-lifecycle/policy-engine.js +196 -0
  238. package/dist/extensions/memory/context-lifecycle/signal-detector.d.ts +28 -0
  239. package/dist/extensions/memory/context-lifecycle/signal-detector.js +224 -0
  240. package/dist/extensions/memory/context-lifecycle/state.d.ts +98 -0
  241. package/dist/extensions/memory/context-lifecycle/state.js +90 -0
  242. package/dist/extensions/memory/context-lifecycle/types.d.ts +132 -0
  243. package/dist/extensions/memory/context-lifecycle/types.js +273 -0
  244. package/dist/extensions/memory/context-manager/analysis.d.ts +47 -0
  245. package/dist/extensions/memory/context-manager/analysis.js +264 -0
  246. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.d.ts +159 -0
  247. package/dist/extensions/memory/context-manager/handlers/compaction-chunked.js +658 -0
  248. package/dist/extensions/memory/context-manager/handlers/compaction-retry.d.ts +29 -0
  249. package/dist/extensions/memory/context-manager/handlers/compaction-retry.js +410 -0
  250. package/dist/extensions/memory/context-manager/handlers/compaction-trace.d.ts +74 -0
  251. package/dist/extensions/memory/context-manager/handlers/compaction-trace.js +180 -0
  252. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.d.ts +69 -0
  253. package/dist/extensions/memory/context-manager/handlers/compaction-watchdog.js +297 -0
  254. package/dist/extensions/memory/context-manager/handlers/compaction.d.ts +37 -0
  255. package/dist/extensions/memory/context-manager/handlers/compaction.js +2150 -0
  256. package/dist/extensions/memory/context-manager/handlers/context-emergency.d.ts +124 -0
  257. package/dist/extensions/memory/context-manager/handlers/context-emergency.js +364 -0
  258. package/dist/extensions/memory/context-manager/handlers/events.d.ts +5 -0
  259. package/dist/extensions/memory/context-manager/handlers/events.js +314 -0
  260. package/dist/extensions/memory/context-manager/handlers/navigation.d.ts +5 -0
  261. package/dist/extensions/memory/context-manager/handlers/navigation.js +86 -0
  262. package/dist/extensions/memory/context-manager/handlers/offload.d.ts +94 -0
  263. package/dist/extensions/memory/context-manager/handlers/offload.js +248 -0
  264. package/dist/extensions/memory/context-manager/handlers/rotation.d.ts +6 -0
  265. package/dist/extensions/memory/context-manager/handlers/rotation.js +304 -0
  266. package/dist/extensions/memory/context-manager/handlers/shared.d.ts +410 -0
  267. package/dist/extensions/memory/context-manager/handlers/shared.js +579 -0
  268. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.d.ts +55 -0
  269. package/dist/extensions/memory/context-manager/handlers/tool-batch-boundary.js +190 -0
  270. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.d.ts +21 -0
  271. package/dist/extensions/memory/context-manager/handlers/toolresult-capture-cap.js +155 -0
  272. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.d.ts +90 -0
  273. package/dist/extensions/memory/context-manager/handlers/tools/context-compress.js +1156 -0
  274. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.d.ts +16 -0
  275. package/dist/extensions/memory/context-manager/handlers/tools/context-inspect.js +276 -0
  276. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.d.ts +19 -0
  277. package/dist/extensions/memory/context-manager/handlers/tools/context-navigate.js +378 -0
  278. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.d.ts +13 -0
  279. package/dist/extensions/memory/context-manager/handlers/tools/offload-recover.js +181 -0
  280. package/dist/extensions/memory/context-manager/index.d.ts +3 -0
  281. package/dist/extensions/memory/context-manager/index.js +88 -0
  282. package/dist/extensions/memory/context-manager/pruning.d.ts +47 -0
  283. package/dist/extensions/memory/context-manager/pruning.js +406 -0
  284. package/dist/extensions/memory/context-manager/semantic-compress.d.ts +71 -0
  285. package/dist/extensions/memory/context-manager/semantic-compress.js +279 -0
  286. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.d.ts +20 -0
  287. package/dist/extensions/memory/memory-agent-bridge/conflict-qa-tool.js +71 -0
  288. package/dist/extensions/memory/memory-agent-bridge/explore-paths.d.ts +30 -0
  289. package/dist/extensions/memory/memory-agent-bridge/explore-paths.js +231 -0
  290. package/dist/extensions/memory/memory-agent-bridge/index.d.ts +28 -0
  291. package/dist/extensions/memory/memory-agent-bridge/index.js +124 -0
  292. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.d.ts +21 -0
  293. package/dist/extensions/memory/memory-agent-bridge/memory-store-tool.js +194 -0
  294. package/dist/extensions/memory/memory-agent-bridge/memory-tool.d.ts +22 -0
  295. package/dist/extensions/memory/memory-agent-bridge/memory-tool.js +548 -0
  296. package/dist/extensions/memory/scratchpad/format.d.ts +19 -0
  297. package/dist/extensions/memory/scratchpad/format.js +135 -0
  298. package/dist/extensions/memory/scratchpad/handlers.d.ts +53 -0
  299. package/dist/extensions/memory/scratchpad/handlers.js +469 -0
  300. package/dist/extensions/memory/scratchpad/index.d.ts +17 -0
  301. package/dist/extensions/memory/scratchpad/index.js +168 -0
  302. package/dist/extensions/memory/scratchpad/persistence.d.ts +46 -0
  303. package/dist/extensions/memory/scratchpad/persistence.js +343 -0
  304. package/dist/extensions/memory/scratchpad/types.d.ts +124 -0
  305. package/dist/extensions/memory/scratchpad/types.js +8 -0
  306. package/dist/extensions/memory/scratchpad/utils.d.ts +76 -0
  307. package/dist/extensions/memory/scratchpad/utils.js +236 -0
  308. package/dist/extensions/memory/session-recall/analyze.d.ts +58 -0
  309. package/dist/extensions/memory/session-recall/analyze.js +478 -0
  310. package/dist/extensions/memory/session-recall/context-aggregate.d.ts +117 -0
  311. package/dist/extensions/memory/session-recall/context-aggregate.js +315 -0
  312. package/dist/extensions/memory/session-recall/index.d.ts +29 -0
  313. package/dist/extensions/memory/session-recall/index.js +820 -0
  314. package/dist/extensions/memory/session-recall/query.d.ts +15 -0
  315. package/dist/extensions/memory/session-recall/query.js +38 -0
  316. package/dist/extensions/memory/session-recall/rank.d.ts +71 -0
  317. package/dist/extensions/memory/session-recall/rank.js +85 -0
  318. package/dist/extensions/memory/session-recall/search.d.ts +159 -0
  319. package/dist/extensions/memory/session-recall/search.js +682 -0
  320. package/dist/extensions/memory/session-recall/stats.d.ts +34 -0
  321. package/dist/extensions/memory/session-recall/stats.js +67 -0
  322. package/dist/extensions/memory/session-recall/text-utils.d.ts +82 -0
  323. package/dist/extensions/memory/session-recall/text-utils.js +184 -0
  324. package/dist/extensions/memory/three-memory-stores/episodes-disk.d.ts +43 -0
  325. package/dist/extensions/memory/three-memory-stores/episodes-disk.js +125 -0
  326. package/dist/extensions/memory/three-memory-stores/episodes.d.ts +46 -0
  327. package/dist/extensions/memory/three-memory-stores/episodes.js +299 -0
  328. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.d.ts +25 -0
  329. package/dist/extensions/memory/three-memory-stores/handlers/whisper-recall.js +112 -0
  330. package/dist/extensions/memory/three-memory-stores/heuristics.d.ts +19 -0
  331. package/dist/extensions/memory/three-memory-stores/heuristics.js +89 -0
  332. package/dist/extensions/memory/three-memory-stores/index.d.ts +34 -0
  333. package/dist/extensions/memory/three-memory-stores/index.js +436 -0
  334. package/dist/extensions/memory/three-memory-stores/tool-reliability.d.ts +11 -0
  335. package/dist/extensions/memory/three-memory-stores/tool-reliability.js +38 -0
  336. package/dist/extensions/memory/three-memory-stores/types.d.ts +69 -0
  337. package/dist/extensions/memory/three-memory-stores/types.js +2 -0
  338. package/dist/extensions/memory/workspace-snapshot/index.d.ts +19 -0
  339. package/dist/extensions/memory/workspace-snapshot/index.js +363 -0
  340. package/dist/extensions/orchestrator/index.d.ts +19 -0
  341. package/dist/extensions/orchestrator/index.js +796 -0
  342. package/dist/extensions/scheduling/timer/fire-timing.d.ts +25 -0
  343. package/dist/extensions/scheduling/timer/fire-timing.js +28 -0
  344. package/dist/extensions/scheduling/timer/index.d.ts +102 -0
  345. package/dist/extensions/scheduling/timer/index.js +1143 -0
  346. package/dist/extensions/scheduling/timer/poller.d.ts +52 -0
  347. package/dist/extensions/scheduling/timer/poller.js +135 -0
  348. package/dist/extensions/scheduling/timer/recovery.d.ts +145 -0
  349. package/dist/extensions/scheduling/timer/recovery.js +445 -0
  350. package/dist/extensions/scheduling/timer/store-file.d.ts +38 -0
  351. package/dist/extensions/scheduling/timer/store-file.js +59 -0
  352. package/dist/extensions/scheduling/timer/timer-manager.d.ts +21 -0
  353. package/dist/extensions/scheduling/timer/timer-manager.js +143 -0
  354. package/dist/extensions/scheduling/timer/wake-retry.d.ts +455 -0
  355. package/dist/extensions/scheduling/timer/wake-retry.js +872 -0
  356. package/dist/extensions/self/auto-recovery/index.d.ts +20 -0
  357. package/dist/extensions/self/auto-recovery/index.js +89 -0
  358. package/dist/extensions/self/error-tracking/index.d.ts +3 -0
  359. package/dist/extensions/self/error-tracking/index.js +244 -0
  360. package/dist/extensions/self/health-maintenance/format.d.ts +3 -0
  361. package/dist/extensions/self/health-maintenance/format.js +60 -0
  362. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.d.ts +23 -0
  363. package/dist/extensions/self/health-maintenance/handlers/session-health-tool.js +158 -0
  364. package/dist/extensions/self/health-maintenance/helpers.d.ts +25 -0
  365. package/dist/extensions/self/health-maintenance/helpers.js +67 -0
  366. package/dist/extensions/self/health-maintenance/index.d.ts +6 -0
  367. package/dist/extensions/self/health-maintenance/index.js +238 -0
  368. package/dist/extensions/self/health-maintenance/types.d.ts +14 -0
  369. package/dist/extensions/self/health-maintenance/types.js +2 -0
  370. package/dist/extensions/self/latent-activator/index.d.ts +12 -0
  371. package/dist/extensions/self/latent-activator/index.js +173 -0
  372. package/dist/extensions/self/latent-activator/mixes.d.ts +9 -0
  373. package/dist/extensions/self/latent-activator/mixes.js +20 -0
  374. package/dist/extensions/self/latent-activator/signals.d.ts +17 -0
  375. package/dist/extensions/self/latent-activator/signals.js +228 -0
  376. package/dist/extensions/self/latent-activator/state.d.ts +43 -0
  377. package/dist/extensions/self/latent-activator/state.js +59 -0
  378. package/dist/extensions/self/latent-activator/types.d.ts +8 -0
  379. package/dist/extensions/self/latent-activator/types.js +8 -0
  380. package/dist/extensions/self/watchdog/config.d.ts +4 -0
  381. package/dist/extensions/self/watchdog/config.js +79 -0
  382. package/dist/extensions/self/watchdog/engine.d.ts +256 -0
  383. package/dist/extensions/self/watchdog/engine.js +935 -0
  384. package/dist/extensions/self/watchdog/index.d.ts +23 -0
  385. package/dist/extensions/self/watchdog/index.js +485 -0
  386. package/dist/index.d.ts +25 -0
  387. package/dist/index.js +81 -0
  388. package/dist/lib/ai/consolidated-claim-critic.d.ts +84 -0
  389. package/dist/lib/ai/consolidated-claim-critic.js +191 -0
  390. package/dist/lib/ai/cost-report.d.ts +83 -0
  391. package/dist/lib/ai/cost-report.js +116 -0
  392. package/dist/lib/ai/critic-cache.d.ts +57 -0
  393. package/dist/lib/ai/critic-cache.js +100 -0
  394. package/dist/lib/ai/critic-fallbacks.d.ts +37 -0
  395. package/dist/lib/ai/critic-fallbacks.js +75 -0
  396. package/dist/lib/ai/critic-gate.d.ts +75 -0
  397. package/dist/lib/ai/critic-gate.js +81 -0
  398. package/dist/lib/ai/critic-helpers.d.ts +26 -0
  399. package/dist/lib/ai/critic-helpers.js +131 -0
  400. package/dist/lib/ai/critic-registry.d.ts +417 -0
  401. package/dist/lib/ai/critic-registry.js +639 -0
  402. package/dist/lib/ai/critic-stats.d.ts +78 -0
  403. package/dist/lib/ai/critic-stats.js +90 -0
  404. package/dist/lib/ai/judge-budget.d.ts +138 -0
  405. package/dist/lib/ai/judge-budget.js +143 -0
  406. package/dist/lib/ai/language-hint.d.ts +21 -0
  407. package/dist/lib/ai/language-hint.js +58 -0
  408. package/dist/lib/ai/llm-call.d.ts +141 -0
  409. package/dist/lib/ai/llm-call.js +745 -0
  410. package/dist/lib/ai/model-resolver.d.ts +90 -0
  411. package/dist/lib/ai/model-resolver.js +185 -0
  412. package/dist/lib/ai/models-init.d.ts +46 -0
  413. package/dist/lib/ai/models-init.js +65 -0
  414. package/dist/lib/ai/payload-hygiene.d.ts +74 -0
  415. package/dist/lib/ai/payload-hygiene.js +240 -0
  416. package/dist/lib/ai/post-loop-classify.d.ts +128 -0
  417. package/dist/lib/ai/post-loop-classify.js +87 -0
  418. package/dist/lib/ai/text-classifier.d.ts +142 -0
  419. package/dist/lib/ai/text-classifier.js +548 -0
  420. package/dist/lib/cognitive/hints.d.ts +33 -0
  421. package/dist/lib/cognitive/hints.js +223 -0
  422. package/dist/lib/cognitive/openspec.d.ts +29 -0
  423. package/dist/lib/cognitive/openspec.js +108 -0
  424. package/dist/lib/config/braid-paths.d.ts +188 -0
  425. package/dist/lib/config/braid-paths.js +340 -0
  426. package/dist/lib/config/braid-settings.d.ts +489 -0
  427. package/dist/lib/config/braid-settings.js +938 -0
  428. package/dist/lib/config/per-tool-settings.d.ts +95 -0
  429. package/dist/lib/config/per-tool-settings.js +161 -0
  430. package/dist/lib/config/session-profiles.d.ts +68 -0
  431. package/dist/lib/config/session-profiles.js +143 -0
  432. package/dist/lib/constants/injection-details.d.ts +30 -0
  433. package/dist/lib/constants/injection-details.js +30 -0
  434. package/dist/lib/constants/session-thresholds.d.ts +42 -0
  435. package/dist/lib/constants/session-thresholds.js +54 -0
  436. package/dist/lib/constants/tool-constants.d.ts +11 -0
  437. package/dist/lib/constants/tool-constants.js +12 -0
  438. package/dist/lib/core/event-names.d.ts +23 -0
  439. package/dist/lib/core/event-names.js +26 -0
  440. package/dist/lib/core/logger.d.ts +102 -0
  441. package/dist/lib/core/logger.js +274 -0
  442. package/dist/lib/detection/compression-strategy.d.ts +38 -0
  443. package/dist/lib/detection/compression-strategy.js +147 -0
  444. package/dist/lib/detection/consolidated-topic-critic.d.ts +51 -0
  445. package/dist/lib/detection/consolidated-topic-critic.js +132 -0
  446. package/dist/lib/detection/context-density.d.ts +70 -0
  447. package/dist/lib/detection/context-density.js +193 -0
  448. package/dist/lib/detection/context-thresholds.d.ts +88 -0
  449. package/dist/lib/detection/context-thresholds.js +107 -0
  450. package/dist/lib/detection/context-tiers.d.ts +80 -0
  451. package/dist/lib/detection/context-tiers.js +144 -0
  452. package/dist/lib/detection/context-usage.d.ts +75 -0
  453. package/dist/lib/detection/context-usage.js +209 -0
  454. package/dist/lib/detection/degradation-detector.d.ts +74 -0
  455. package/dist/lib/detection/degradation-detector.js +454 -0
  456. package/dist/lib/detection/test-burst.d.ts +77 -0
  457. package/dist/lib/detection/test-burst.js +126 -0
  458. package/dist/lib/detection/tool-loop-detector.d.ts +125 -0
  459. package/dist/lib/detection/tool-loop-detector.js +302 -0
  460. package/dist/lib/detection/topic-drift-detector.d.ts +80 -0
  461. package/dist/lib/detection/topic-drift-detector.js +252 -0
  462. package/dist/lib/enforcement/adherence-meter.d.ts +240 -0
  463. package/dist/lib/enforcement/adherence-meter.js +420 -0
  464. package/dist/lib/enforcement/turn-dedup.d.ts +106 -0
  465. package/dist/lib/enforcement/turn-dedup.js +195 -0
  466. package/dist/lib/errors/llm-error.d.ts +79 -0
  467. package/dist/lib/errors/llm-error.js +241 -0
  468. package/dist/lib/events/consolidation-channel.d.ts +109 -0
  469. package/dist/lib/events/consolidation-channel.js +374 -0
  470. package/dist/lib/events/consolidation-scoring.d.ts +59 -0
  471. package/dist/lib/events/consolidation-scoring.js +95 -0
  472. package/dist/lib/events/event-bus.d.ts +123 -0
  473. package/dist/lib/events/event-bus.js +108 -0
  474. package/dist/lib/events/event-types.d.ts +39 -0
  475. package/dist/lib/events/event-types.js +30 -0
  476. package/dist/lib/events/timer-bus.d.ts +21 -0
  477. package/dist/lib/events/timer-bus.js +41 -0
  478. package/dist/lib/events/timer-types.d.ts +64 -0
  479. package/dist/lib/events/timer-types.js +8 -0
  480. package/dist/lib/events/turn-end-coordinator.d.ts +52 -0
  481. package/dist/lib/events/turn-end-coordinator.js +89 -0
  482. package/dist/lib/harness/failure-trace-collector.d.ts +31 -0
  483. package/dist/lib/harness/failure-trace-collector.js +114 -0
  484. package/dist/lib/harness/index.d.ts +20 -0
  485. package/dist/lib/harness/index.js +21 -0
  486. package/dist/lib/harness/types.d.ts +85 -0
  487. package/dist/lib/harness/types.js +20 -0
  488. package/dist/lib/harness/weakness-miner.d.ts +29 -0
  489. package/dist/lib/harness/weakness-miner.js +165 -0
  490. package/dist/lib/memory/constants.d.ts +11 -0
  491. package/dist/lib/memory/constants.js +29 -0
  492. package/dist/lib/memory/index.d.ts +147 -0
  493. package/dist/lib/memory/index.js +564 -0
  494. package/dist/lib/memory/lifecycle.d.ts +50 -0
  495. package/dist/lib/memory/lifecycle.js +139 -0
  496. package/dist/lib/memory/past-insights.d.ts +35 -0
  497. package/dist/lib/memory/past-insights.js +189 -0
  498. package/dist/lib/memory/storage.d.ts +38 -0
  499. package/dist/lib/memory/storage.js +167 -0
  500. package/dist/lib/memory/store-lock.d.ts +23 -0
  501. package/dist/lib/memory/store-lock.js +69 -0
  502. package/dist/lib/memory/store-merge.d.ts +38 -0
  503. package/dist/lib/memory/store-merge.js +73 -0
  504. package/dist/lib/memory/types.d.ts +65 -0
  505. package/dist/lib/memory/types.js +5 -0
  506. package/dist/lib/memory/utils.d.ts +35 -0
  507. package/dist/lib/memory/utils.js +156 -0
  508. package/dist/lib/memory/write-log.d.ts +85 -0
  509. package/dist/lib/memory/write-log.js +124 -0
  510. package/dist/lib/memory/write-quality.d.ts +197 -0
  511. package/dist/lib/memory/write-quality.js +314 -0
  512. package/dist/lib/orchestrator/branch.d.ts +63 -0
  513. package/dist/lib/orchestrator/branch.js +192 -0
  514. package/dist/lib/orchestrator/index.d.ts +14 -0
  515. package/dist/lib/orchestrator/index.js +11 -0
  516. package/dist/lib/orchestrator/locks.d.ts +46 -0
  517. package/dist/lib/orchestrator/locks.js +122 -0
  518. package/dist/lib/orchestrator/slop-scanner.d.ts +31 -0
  519. package/dist/lib/orchestrator/slop-scanner.js +207 -0
  520. package/dist/lib/orchestrator/workers.d.ts +453 -0
  521. package/dist/lib/orchestrator/workers.js +1001 -0
  522. package/dist/lib/public.d.ts +18 -0
  523. package/dist/lib/public.js +23 -0
  524. package/dist/lib/reasoning/advice-tracker.d.ts +51 -0
  525. package/dist/lib/reasoning/advice-tracker.js +177 -0
  526. package/dist/lib/reasoning/belief-policy-engine.d.ts +48 -0
  527. package/dist/lib/reasoning/belief-policy-engine.js +268 -0
  528. package/dist/lib/reasoning/belief-types.d.ts +32 -0
  529. package/dist/lib/reasoning/belief-types.js +8 -0
  530. package/dist/lib/reasoning/classifier-offline.d.ts +72 -0
  531. package/dist/lib/reasoning/classifier-offline.js +75 -0
  532. package/dist/lib/reasoning/dreamer.d.ts +37 -0
  533. package/dist/lib/reasoning/dreamer.js +169 -0
  534. package/dist/lib/reasoning/nudge-analytics.d.ts +18 -0
  535. package/dist/lib/reasoning/nudge-analytics.js +62 -0
  536. package/dist/lib/reasoning/policy-rules.d.ts +18 -0
  537. package/dist/lib/reasoning/policy-rules.js +153 -0
  538. package/dist/lib/reasoning/reasoning-metrics.d.ts +42 -0
  539. package/dist/lib/reasoning/reasoning-metrics.js +174 -0
  540. package/dist/lib/reasoning/reasoning-summary.d.ts +34 -0
  541. package/dist/lib/reasoning/reasoning-summary.js +122 -0
  542. package/dist/lib/reasoning/tool-usage-analyzer.d.ts +50 -0
  543. package/dist/lib/reasoning/tool-usage-analyzer.js +188 -0
  544. package/dist/lib/state/async-storage.d.ts +52 -0
  545. package/dist/lib/state/async-storage.js +171 -0
  546. package/dist/lib/state/extension-state.d.ts +184 -0
  547. package/dist/lib/state/extension-state.js +373 -0
  548. package/dist/lib/state/global-state.d.ts +358 -0
  549. package/dist/lib/state/global-state.js +741 -0
  550. package/dist/lib/state/metacognitive-state.d.ts +21 -0
  551. package/dist/lib/state/metacognitive-state.js +50 -0
  552. package/dist/lib/state/session-manager.d.ts +32 -0
  553. package/dist/lib/state/session-manager.js +11 -0
  554. package/dist/lib/state/session-start-queue.d.ts +42 -0
  555. package/dist/lib/state/session-start-queue.js +105 -0
  556. package/dist/lib/state/state-checkpoint.d.ts +72 -0
  557. package/dist/lib/state/state-checkpoint.js +252 -0
  558. package/dist/lib/state/telegram-poller-liveness.d.ts +54 -0
  559. package/dist/lib/state/telegram-poller-liveness.js +67 -0
  560. package/dist/lib/state/tool-provenance.d.ts +22 -0
  561. package/dist/lib/state/tool-provenance.js +25 -0
  562. package/dist/lib/state/workspace-snapshot.d.ts +111 -0
  563. package/dist/lib/state/workspace-snapshot.js +372 -0
  564. package/dist/lib/store/belief-store.d.ts +112 -0
  565. package/dist/lib/store/belief-store.js +252 -0
  566. package/dist/lib/store/bidirectional-verifier.d.ts +87 -0
  567. package/dist/lib/store/bidirectional-verifier.js +242 -0
  568. package/dist/lib/store/claim-tracker.d.ts +66 -0
  569. package/dist/lib/store/claim-tracker.js +276 -0
  570. package/dist/lib/store/conflict-qa.d.ts +96 -0
  571. package/dist/lib/store/conflict-qa.js +283 -0
  572. package/dist/lib/store/evidence-pool.d.ts +185 -0
  573. package/dist/lib/store/evidence-pool.js +598 -0
  574. package/dist/lib/telemetry/context-heartbeat.d.ts +122 -0
  575. package/dist/lib/telemetry/context-heartbeat.js +449 -0
  576. package/dist/lib/telemetry/drift-signals.d.ts +46 -0
  577. package/dist/lib/telemetry/drift-signals.js +75 -0
  578. package/dist/lib/telemetry/rss-telemetry.d.ts +41 -0
  579. package/dist/lib/telemetry/rss-telemetry.js +53 -0
  580. package/dist/lib/types/episode-types.d.ts +31 -0
  581. package/dist/lib/types/episode-types.js +9 -0
  582. package/dist/lib/types/standard-result.d.ts +32 -0
  583. package/dist/lib/types/standard-result.js +22 -0
  584. package/dist/lib/utils/async-fs.d.ts +17 -0
  585. package/dist/lib/utils/async-fs.js +22 -0
  586. package/dist/lib/utils/bounded.d.ts +38 -0
  587. package/dist/lib/utils/bounded.js +59 -0
  588. package/dist/lib/utils/dedup.d.ts +40 -0
  589. package/dist/lib/utils/dedup.js +43 -0
  590. package/dist/lib/utils/error-guard.d.ts +15 -0
  591. package/dist/lib/utils/error-guard.js +22 -0
  592. package/dist/lib/utils/extension-utils.d.ts +36 -0
  593. package/dist/lib/utils/extension-utils.js +65 -0
  594. package/dist/lib/utils/extract-json.d.ts +23 -0
  595. package/dist/lib/utils/extract-json.js +90 -0
  596. package/dist/lib/utils/file-mutation-queue.d.ts +33 -0
  597. package/dist/lib/utils/file-mutation-queue.js +150 -0
  598. package/dist/lib/utils/filter-safe-to-remove.d.ts +26 -0
  599. package/dist/lib/utils/filter-safe-to-remove.js +256 -0
  600. package/dist/lib/utils/format-tool-result.d.ts +47 -0
  601. package/dist/lib/utils/format-tool-result.js +88 -0
  602. package/dist/lib/utils/id.d.ts +44 -0
  603. package/dist/lib/utils/id.js +59 -0
  604. package/dist/lib/utils/injection-tracker.d.ts +317 -0
  605. package/dist/lib/utils/injection-tracker.js +840 -0
  606. package/dist/lib/utils/local-time.d.ts +57 -0
  607. package/dist/lib/utils/local-time.js +181 -0
  608. package/dist/lib/utils/memory-fence.d.ts +55 -0
  609. package/dist/lib/utils/memory-fence.js +66 -0
  610. package/dist/lib/utils/sop-extractor.d.ts +75 -0
  611. package/dist/lib/utils/sop-extractor.js +259 -0
  612. package/dist/lib/utils/sop-suggestion.d.ts +34 -0
  613. package/dist/lib/utils/sop-suggestion.js +336 -0
  614. package/dist/lib/utils/wake-gate.d.ts +151 -0
  615. package/dist/lib/utils/wake-gate.js +265 -0
  616. package/dist/lib/utils/whisper-format.d.ts +95 -0
  617. package/dist/lib/utils/whisper-format.js +115 -0
  618. package/dist/lib/verification/coordination-checker.d.ts +72 -0
  619. package/dist/lib/verification/coordination-checker.js +126 -0
  620. package/dist/loader/api.d.ts +19 -0
  621. package/dist/loader/api.js +114 -0
  622. package/dist/loader/loader.d.ts +85 -0
  623. package/dist/loader/loader.js +534 -0
  624. package/docs/BEGINNERS.md +166 -0
  625. package/docs/COMPACTION-LOSS-INVESTIGATION.md +179 -0
  626. package/docs/CONTEXT-MAP.md +220 -0
  627. package/docs/CONTEXT-POLICY.md +86 -0
  628. package/docs/HISTORY.md +110 -0
  629. package/docs/LOCAL_DEV.md +246 -0
  630. package/docs/ROADMAP.md +107 -0
  631. package/docs/SETUP.md +502 -0
  632. package/package.json +97 -4
  633. package/skills/agent-testing/SKILL.md +214 -0
  634. package/skills/braid-reference/SKILL.md +88 -0
  635. package/skills/code-refactoring/SKILL.md +211 -0
  636. package/skills/code-search/SKILL.md +14 -0
  637. package/skills/documentation/SKILL.md +89 -0
  638. package/skills/dox/AGENTS.md.template +83 -0
  639. package/skills/dox/SKILL.md +86 -0
  640. package/skills/healthcheck/SKILL.md +65 -0
  641. package/skills/herdr-topology/SKILL.md +269 -0
  642. package/skills/meta-cognition/SKILL.md +24 -0
  643. package/skills/meta-improvement/SKILL.md +180 -0
  644. package/skills/misdirection-audit/SKILL.md +66 -0
  645. package/skills/pi-reference/SKILL.md +104 -0
  646. package/skills/placement-discipline/SKILL.md +69 -0
  647. package/skills/probe-evaluation/SKILL.md +85 -0
  648. package/skills/release-pipeline/SKILL.md +191 -0
  649. package/skills/research/SKILL.md +166 -0
  650. package/skills/skill-usage/SKILL.md +81 -0
  651. package/skills/software-engineer/SKILL.md +83 -0
  652. package/skills/subagent-orchestration/SKILL.md +454 -0
  653. package/skills/subagent-orchestration/scripts/workers.mjs +283 -0
  654. package/skills/subagent-verification/SKILL.md +127 -0
  655. package/skills/tone-quality/SKILL.md +176 -0
  656. package/skills/voice-replies/SKILL.md +125 -0
  657. package/src/AGENTS.md +111 -0
  658. package/src/extensions/cognitive/AGENTS.md +29 -0
  659. package/src/extensions/cognitive/mars-reflector/index.ts +415 -0
  660. package/src/extensions/cognitive/metacognition/handlers/AGENTS.md +30 -0
  661. package/src/extensions/cognitive/metacognition/handlers/claim-verification.ts +295 -0
  662. package/src/extensions/cognitive/metacognition/handlers/finalize.ts +648 -0
  663. package/src/extensions/cognitive/metacognition/handlers/hypothesize.ts +368 -0
  664. package/src/extensions/cognitive/metacognition/handlers/scoring.ts +242 -0
  665. package/src/extensions/cognitive/metacognition/handlers/think-budget.ts +199 -0
  666. package/src/extensions/cognitive/metacognition/handlers/think.ts +489 -0
  667. package/src/extensions/cognitive/metacognition/handlers/verify.ts +440 -0
  668. package/src/extensions/cognitive/metacognition/index.ts +109 -0
  669. package/src/extensions/cognitive/reasoning/index.ts +168 -0
  670. package/src/extensions/cognitive/sycophancy-detector/index.ts +286 -0
  671. package/src/extensions/cognitive/topic-drift/index.ts +429 -0
  672. package/src/extensions/cognitive/turn-outcome/index.ts +209 -0
  673. package/src/extensions/context-management/README.md +102 -0
  674. package/src/extensions/context-management/index.ts +383 -0
  675. package/src/extensions/core/AGENTS.md +34 -0
  676. package/src/extensions/core/agent-environment/index.ts +135 -0
  677. package/src/extensions/core/polyfill/index.ts +617 -0
  678. package/src/extensions/core/prompt-builder/AGENTS.md +151 -0
  679. package/src/extensions/core/prompt-builder/awareness-whisper.ts +162 -0
  680. package/src/extensions/core/prompt-builder/context-section.ts +120 -0
  681. package/src/extensions/core/prompt-builder/custom-sections.ts +27 -0
  682. package/src/extensions/core/prompt-builder/external-tool-guidelines.ts +41 -0
  683. package/src/extensions/core/prompt-builder/identity.ts +98 -0
  684. package/src/extensions/core/prompt-builder/index.ts +602 -0
  685. package/src/extensions/core/prompt-builder/inspect.ts +227 -0
  686. package/src/extensions/core/prompt-builder/instance-composition.ts +515 -0
  687. package/src/extensions/core/prompt-builder/memory-section.ts +76 -0
  688. package/src/extensions/core/prompt-builder/pi-reference-section.ts +26 -0
  689. package/src/extensions/core/prompt-builder/project-docs-section.ts +105 -0
  690. package/src/extensions/core/prompt-builder/section-parity.ts +108 -0
  691. package/src/extensions/core/prompt-builder/section-publish.ts +43 -0
  692. package/src/extensions/core/prompt-builder/section.ts +150 -0
  693. package/src/extensions/core/prompt-builder/surface-discipline-section.ts +21 -0
  694. package/src/extensions/core/prompt-builder/system-info-tool.ts +87 -0
  695. package/src/extensions/core/prompt-builder/tool-description-trim.ts +127 -0
  696. package/src/extensions/core/prompt-builder/tool-guidelines.ts +226 -0
  697. package/src/extensions/core/prompt-builder/tool-pipelines.ts +78 -0
  698. package/src/extensions/core/prompt-builder/top-level-extensions.ts +338 -0
  699. package/src/extensions/core/skills-tool/auto-inject.ts +1004 -0
  700. package/src/extensions/core/skills-tool/index.ts +240 -0
  701. package/src/extensions/core/skills-tool/loading-guidance.ts +89 -0
  702. package/src/extensions/core/skills-tool/session-records.ts +328 -0
  703. package/src/extensions/core/skills-tool/skill-triggers.ts +119 -0
  704. package/src/extensions/enforcement/AGENTS.md +69 -0
  705. package/src/extensions/enforcement/detection/malformed.ts +42 -0
  706. package/src/extensions/enforcement/detection/verification.ts +52 -0
  707. package/src/extensions/enforcement/enforcement-types.ts +42 -0
  708. package/src/extensions/enforcement/handler-registry.ts +225 -0
  709. package/src/extensions/enforcement/handlers/AGENTS.md +68 -0
  710. package/src/extensions/enforcement/handlers/analysis/AGENTS.md +40 -0
  711. package/src/extensions/enforcement/handlers/analysis/bpe-handler.ts +53 -0
  712. package/src/extensions/enforcement/handlers/analysis/dreamer-handler.ts +73 -0
  713. package/src/extensions/enforcement/handlers/analysis/drift-handler.ts +100 -0
  714. package/src/extensions/enforcement/handlers/analysis/feedback-handler.ts +22 -0
  715. package/src/extensions/enforcement/handlers/analysis/mars-handler.ts +121 -0
  716. package/src/extensions/enforcement/handlers/analysis/reflection-handler.ts +22 -0
  717. package/src/extensions/enforcement/handlers/blocking.ts +50 -0
  718. package/src/extensions/enforcement/handlers/message-analysis.ts +95 -0
  719. package/src/extensions/enforcement/handlers/orphan-chains.ts +53 -0
  720. package/src/extensions/enforcement/handlers/over-correction-gate.ts +634 -0
  721. package/src/extensions/enforcement/handlers/probe-handler.ts +133 -0
  722. package/src/extensions/enforcement/handlers/register-adherence-meter.ts +216 -0
  723. package/src/extensions/enforcement/handlers/register-agent-end-api-error.ts +82 -0
  724. package/src/extensions/enforcement/handlers/register-input-handler.ts +36 -0
  725. package/src/extensions/enforcement/handlers/register-message-end.ts +477 -0
  726. package/src/extensions/enforcement/handlers/register-post-cycle-hygiene.ts +166 -0
  727. package/src/extensions/enforcement/handlers/register-session-compact.ts +248 -0
  728. package/src/extensions/enforcement/handlers/register-session-shutdown-resumption.ts +138 -0
  729. package/src/extensions/enforcement/handlers/register-session-shutdown.ts +46 -0
  730. package/src/extensions/enforcement/handlers/register-session-start-discoverability.ts +270 -0
  731. package/src/extensions/enforcement/handlers/register-session-start.ts +240 -0
  732. package/src/extensions/enforcement/handlers/register-tool-call.ts +160 -0
  733. package/src/extensions/enforcement/handlers/register-tool-result-formatting.ts +73 -0
  734. package/src/extensions/enforcement/handlers/register-tool-result.ts +108 -0
  735. package/src/extensions/enforcement/handlers/register-turn-end-hygiene.ts +456 -0
  736. package/src/extensions/enforcement/handlers/routing-handler.ts +191 -0
  737. package/src/extensions/enforcement/handlers/tool-tracker.ts +145 -0
  738. package/src/extensions/enforcement/handlers/turn-analysis.ts +156 -0
  739. package/src/extensions/enforcement/handlers/turn-end-handler.ts +538 -0
  740. package/src/extensions/enforcement/index.ts +28 -0
  741. package/src/extensions/enforcement/judge-utils.ts +106 -0
  742. package/src/extensions/enforcement/nudge-manager.ts +298 -0
  743. package/src/extensions/enforcement/self-state-claims.ts +204 -0
  744. package/src/extensions/enforcement/session-health.ts +317 -0
  745. package/src/extensions/enforcement/signals.ts +88 -0
  746. package/src/extensions/enforcement/similarity.ts +76 -0
  747. package/src/extensions/enforcement/state.ts +115 -0
  748. package/src/extensions/enforcement/substate/context-hygiene-state.ts +212 -0
  749. package/src/extensions/enforcement/substate/error-tracking-state.ts +50 -0
  750. package/src/extensions/enforcement/substate/memory-hygiene-state.ts +54 -0
  751. package/src/extensions/enforcement/substate/session-state.ts +79 -0
  752. package/src/extensions/enforcement/substate/thought-chain-state.ts +62 -0
  753. package/src/extensions/enforcement/substate/tool-tracking-state.ts +166 -0
  754. package/src/extensions/enforcement/substate/verification-judge-state.ts +52 -0
  755. package/src/extensions/enforcement/task-evidence.ts +436 -0
  756. package/src/extensions/enforcement/types.ts +38 -0
  757. package/src/extensions/enforcement/validation.ts +194 -0
  758. package/src/extensions/enforcement/verification-judge.ts +317 -0
  759. package/src/extensions/enforcement/whisper.ts +120 -0
  760. package/src/extensions/heartbeat/AGENTS.md +47 -0
  761. package/src/extensions/heartbeat/analytics/AGENTS.md +57 -0
  762. package/src/extensions/heartbeat/analytics/ab-variant.ts +106 -0
  763. package/src/extensions/heartbeat/analytics/core.ts +222 -0
  764. package/src/extensions/heartbeat/analytics/format.ts +144 -0
  765. package/src/extensions/heartbeat/analytics/index.ts +373 -0
  766. package/src/extensions/heartbeat/analytics/shared.ts +149 -0
  767. package/src/extensions/heartbeat/heartbeat-scheduler/AGENTS.md +84 -0
  768. package/src/extensions/heartbeat/heartbeat-scheduler/index.ts +1095 -0
  769. package/src/extensions/heartbeat/heartbeat-scheduler/meta-learning.ts +75 -0
  770. package/src/extensions/heartbeat/heartbeat-scheduler/modules/behavioral-drift.ts +200 -0
  771. package/src/extensions/heartbeat/heartbeat-scheduler/modules/budget.ts +113 -0
  772. package/src/extensions/heartbeat/heartbeat-scheduler/modules/context-hygiene.ts +288 -0
  773. package/src/extensions/heartbeat/heartbeat-scheduler/modules/evolver.ts +88 -0
  774. package/src/extensions/heartbeat/heartbeat-scheduler/modules/measurement.ts +47 -0
  775. package/src/extensions/heartbeat/heartbeat-scheduler/modules/recaller.ts +99 -0
  776. package/src/extensions/heartbeat/heartbeat-scheduler/modules/reflection-consolidator.ts +114 -0
  777. package/src/extensions/heartbeat/heartbeat-scheduler/policies.ts +193 -0
  778. package/src/extensions/heartbeat/heartbeat-scheduler/state.ts +88 -0
  779. package/src/extensions/heartbeat/heartbeat-scheduler/types.ts +128 -0
  780. package/src/extensions/heartbeat/heartbeat-scheduler/whisper-batcher.ts +98 -0
  781. package/src/extensions/manifest.ts +293 -0
  782. package/src/extensions/memory/AGENTS.md +93 -0
  783. package/src/extensions/memory/context-lifecycle/AGENTS.md +62 -0
  784. package/src/extensions/memory/context-lifecycle/helpers.ts +167 -0
  785. package/src/extensions/memory/context-lifecycle/index.ts +1232 -0
  786. package/src/extensions/memory/context-lifecycle/policy-engine.ts +287 -0
  787. package/src/extensions/memory/context-lifecycle/signal-detector.ts +293 -0
  788. package/src/extensions/memory/context-lifecycle/state.ts +165 -0
  789. package/src/extensions/memory/context-lifecycle/types.ts +441 -0
  790. package/src/extensions/memory/context-manager/analysis.ts +344 -0
  791. package/src/extensions/memory/context-manager/handlers/AGENTS.md +37 -0
  792. package/src/extensions/memory/context-manager/handlers/compaction-chunked.ts +800 -0
  793. package/src/extensions/memory/context-manager/handlers/compaction-retry.ts +556 -0
  794. package/src/extensions/memory/context-manager/handlers/compaction-trace.ts +243 -0
  795. package/src/extensions/memory/context-manager/handlers/compaction-watchdog.ts +366 -0
  796. package/src/extensions/memory/context-manager/handlers/compaction.ts +2552 -0
  797. package/src/extensions/memory/context-manager/handlers/context-emergency.ts +470 -0
  798. package/src/extensions/memory/context-manager/handlers/events.ts +430 -0
  799. package/src/extensions/memory/context-manager/handlers/navigation.ts +94 -0
  800. package/src/extensions/memory/context-manager/handlers/offload.ts +330 -0
  801. package/src/extensions/memory/context-manager/handlers/rotation.ts +363 -0
  802. package/src/extensions/memory/context-manager/handlers/shared.ts +961 -0
  803. package/src/extensions/memory/context-manager/handlers/tool-batch-boundary.ts +219 -0
  804. package/src/extensions/memory/context-manager/handlers/toolresult-capture-cap.ts +176 -0
  805. package/src/extensions/memory/context-manager/handlers/tools/context-compress.ts +1333 -0
  806. package/src/extensions/memory/context-manager/handlers/tools/context-inspect.ts +343 -0
  807. package/src/extensions/memory/context-manager/handlers/tools/context-navigate.ts +423 -0
  808. package/src/extensions/memory/context-manager/handlers/tools/offload-recover.ts +234 -0
  809. package/src/extensions/memory/context-manager/index.ts +111 -0
  810. package/src/extensions/memory/context-manager/pruning.ts +479 -0
  811. package/src/extensions/memory/context-manager/semantic-compress.ts +321 -0
  812. package/src/extensions/memory/memory-agent-bridge/AGENTS.md +62 -0
  813. package/src/extensions/memory/memory-agent-bridge/conflict-qa-tool.ts +106 -0
  814. package/src/extensions/memory/memory-agent-bridge/explore-paths.ts +283 -0
  815. package/src/extensions/memory/memory-agent-bridge/index.ts +163 -0
  816. package/src/extensions/memory/memory-agent-bridge/memory-store-tool.ts +284 -0
  817. package/src/extensions/memory/memory-agent-bridge/memory-tool.ts +746 -0
  818. package/src/extensions/memory/scratchpad/AGENTS.md +148 -0
  819. package/src/extensions/memory/scratchpad/format.ts +161 -0
  820. package/src/extensions/memory/scratchpad/handlers.ts +601 -0
  821. package/src/extensions/memory/scratchpad/index.ts +230 -0
  822. package/src/extensions/memory/scratchpad/persistence.ts +374 -0
  823. package/src/extensions/memory/scratchpad/types.ts +149 -0
  824. package/src/extensions/memory/scratchpad/utils.ts +268 -0
  825. package/src/extensions/memory/session-recall/AGENTS.md +104 -0
  826. package/src/extensions/memory/session-recall/analyze.ts +605 -0
  827. package/src/extensions/memory/session-recall/context-aggregate.ts +381 -0
  828. package/src/extensions/memory/session-recall/index.ts +956 -0
  829. package/src/extensions/memory/session-recall/query.ts +44 -0
  830. package/src/extensions/memory/session-recall/rank.ts +121 -0
  831. package/src/extensions/memory/session-recall/search.ts +801 -0
  832. package/src/extensions/memory/session-recall/stats.ts +93 -0
  833. package/src/extensions/memory/session-recall/text-utils.ts +209 -0
  834. package/src/extensions/memory/three-memory-stores/AGENTS.md +66 -0
  835. package/src/extensions/memory/three-memory-stores/episodes-disk.ts +138 -0
  836. package/src/extensions/memory/three-memory-stores/episodes.ts +371 -0
  837. package/src/extensions/memory/three-memory-stores/handlers/whisper-recall.ts +132 -0
  838. package/src/extensions/memory/three-memory-stores/heuristics.ts +109 -0
  839. package/src/extensions/memory/three-memory-stores/index.ts +549 -0
  840. package/src/extensions/memory/three-memory-stores/tool-reliability.ts +58 -0
  841. package/src/extensions/memory/three-memory-stores/types.ts +74 -0
  842. package/src/extensions/memory/workspace-snapshot/AGENTS.md +19 -0
  843. package/src/extensions/memory/workspace-snapshot/index.ts +455 -0
  844. package/src/extensions/orchestrator/index.ts +1141 -0
  845. package/src/extensions/scheduling/AGENTS.md +26 -0
  846. package/src/extensions/scheduling/timer/AGENTS.md +259 -0
  847. package/src/extensions/scheduling/timer/fire-timing.ts +46 -0
  848. package/src/extensions/scheduling/timer/index.ts +1331 -0
  849. package/src/extensions/scheduling/timer/poller.ts +138 -0
  850. package/src/extensions/scheduling/timer/recovery.ts +462 -0
  851. package/src/extensions/scheduling/timer/store-file.ts +59 -0
  852. package/src/extensions/scheduling/timer/timer-manager.ts +161 -0
  853. package/src/extensions/scheduling/timer/wake-retry.ts +1057 -0
  854. package/src/extensions/self/AGENTS.md +30 -0
  855. package/src/extensions/self/auto-recovery/index.ts +112 -0
  856. package/src/extensions/self/error-tracking/AGENTS.md +38 -0
  857. package/src/extensions/self/error-tracking/index.ts +299 -0
  858. package/src/extensions/self/health-maintenance/AGENTS.md +42 -0
  859. package/src/extensions/self/health-maintenance/format.ts +87 -0
  860. package/src/extensions/self/health-maintenance/handlers/session-health-tool.ts +182 -0
  861. package/src/extensions/self/health-maintenance/helpers.ts +78 -0
  862. package/src/extensions/self/health-maintenance/index.ts +308 -0
  863. package/src/extensions/self/health-maintenance/types.ts +14 -0
  864. package/src/extensions/self/latent-activator/AGENTS.md +64 -0
  865. package/src/extensions/self/latent-activator/index.ts +206 -0
  866. package/src/extensions/self/latent-activator/mixes.ts +22 -0
  867. package/src/extensions/self/latent-activator/signals.ts +237 -0
  868. package/src/extensions/self/latent-activator/state.ts +79 -0
  869. package/src/extensions/self/latent-activator/types.ts +47 -0
  870. package/src/extensions/self/watchdog/AGENTS.md +27 -0
  871. package/src/extensions/self/watchdog/config.ts +73 -0
  872. package/src/extensions/self/watchdog/engine.ts +1246 -0
  873. package/src/extensions/self/watchdog/index.ts +577 -0
  874. package/src/index.ts +93 -0
  875. package/src/lib/AGENTS.md +39 -0
  876. package/src/lib/ai/AGENTS.md +37 -0
  877. package/src/lib/ai/consolidated-claim-critic.ts +287 -0
  878. package/src/lib/ai/cost-report.ts +206 -0
  879. package/src/lib/ai/critic-cache.ts +122 -0
  880. package/src/lib/ai/critic-fallbacks.ts +74 -0
  881. package/src/lib/ai/critic-gate.ts +135 -0
  882. package/src/lib/ai/critic-helpers.ts +135 -0
  883. package/src/lib/ai/critic-registry.ts +754 -0
  884. package/src/lib/ai/critic-stats.ts +158 -0
  885. package/src/lib/ai/judge-budget.ts +241 -0
  886. package/src/lib/ai/language-hint.ts +70 -0
  887. package/src/lib/ai/llm-call.ts +975 -0
  888. package/src/lib/ai/model-resolver.ts +224 -0
  889. package/src/lib/ai/models-init.ts +68 -0
  890. package/src/lib/ai/payload-hygiene.ts +265 -0
  891. package/src/lib/ai/post-loop-classify.ts +185 -0
  892. package/src/lib/ai/text-classifier.ts +746 -0
  893. package/src/lib/cognitive/AGENTS.md +40 -0
  894. package/src/lib/cognitive/hints.ts +254 -0
  895. package/src/lib/cognitive/openspec.ts +124 -0
  896. package/src/lib/config/AGENTS.md +17 -0
  897. package/src/lib/config/braid-paths.ts +401 -0
  898. package/src/lib/config/braid-settings.ts +1442 -0
  899. package/src/lib/config/per-tool-settings.ts +197 -0
  900. package/src/lib/config/session-profiles.ts +165 -0
  901. package/src/lib/constants/AGENTS.md +15 -0
  902. package/src/lib/constants/injection-details.ts +32 -0
  903. package/src/lib/constants/session-thresholds.ts +64 -0
  904. package/src/lib/constants/tool-constants.ts +16 -0
  905. package/src/lib/core/AGENTS.md +23 -0
  906. package/src/lib/core/event-names.ts +31 -0
  907. package/src/lib/core/logger.ts +334 -0
  908. package/src/lib/detection/AGENTS.md +21 -0
  909. package/src/lib/detection/compression-strategy.ts +183 -0
  910. package/src/lib/detection/consolidated-topic-critic.ts +188 -0
  911. package/src/lib/detection/context-density.ts +237 -0
  912. package/src/lib/detection/context-thresholds.ts +132 -0
  913. package/src/lib/detection/context-tiers.ts +201 -0
  914. package/src/lib/detection/context-usage.ts +270 -0
  915. package/src/lib/detection/degradation-detector.ts +583 -0
  916. package/src/lib/detection/test-burst.ts +170 -0
  917. package/src/lib/detection/tool-loop-detector.ts +364 -0
  918. package/src/lib/detection/topic-drift-detector.ts +323 -0
  919. package/src/lib/enforcement/AGENTS.md +20 -0
  920. package/src/lib/enforcement/adherence-meter.ts +578 -0
  921. package/src/lib/enforcement/turn-dedup.ts +246 -0
  922. package/src/lib/errors/llm-error.ts +288 -0
  923. package/src/lib/events/AGENTS.md +23 -0
  924. package/src/lib/events/consolidation-channel.ts +493 -0
  925. package/src/lib/events/consolidation-scoring.ts +112 -0
  926. package/src/lib/events/event-bus.ts +213 -0
  927. package/src/lib/events/event-types.ts +53 -0
  928. package/src/lib/events/timer-bus.ts +53 -0
  929. package/src/lib/events/timer-types.ts +64 -0
  930. package/src/lib/events/turn-end-coordinator.ts +108 -0
  931. package/src/lib/harness/AGENTS.md +20 -0
  932. package/src/lib/harness/failure-trace-collector.ts +157 -0
  933. package/src/lib/harness/index.ts +41 -0
  934. package/src/lib/harness/types.ts +122 -0
  935. package/src/lib/harness/weakness-miner.ts +209 -0
  936. package/src/lib/memory/AGENTS.md +36 -0
  937. package/src/lib/memory/constants.ts +34 -0
  938. package/src/lib/memory/index.ts +705 -0
  939. package/src/lib/memory/lifecycle.ts +159 -0
  940. package/src/lib/memory/past-insights.ts +221 -0
  941. package/src/lib/memory/storage.ts +187 -0
  942. package/src/lib/memory/store-lock.ts +70 -0
  943. package/src/lib/memory/store-merge.ts +100 -0
  944. package/src/lib/memory/types.ts +82 -0
  945. package/src/lib/memory/utils.ts +173 -0
  946. package/src/lib/memory/write-log.ts +174 -0
  947. package/src/lib/memory/write-quality.ts +383 -0
  948. package/src/lib/orchestrator/branch.ts +193 -0
  949. package/src/lib/orchestrator/index.ts +78 -0
  950. package/src/lib/orchestrator/locks.ts +160 -0
  951. package/src/lib/orchestrator/slop-scanner.ts +258 -0
  952. package/src/lib/orchestrator/workers.ts +1382 -0
  953. package/src/lib/public.ts +43 -0
  954. package/src/lib/reasoning/AGENTS.md +25 -0
  955. package/src/lib/reasoning/advice-tracker.ts +244 -0
  956. package/src/lib/reasoning/belief-policy-engine.ts +342 -0
  957. package/src/lib/reasoning/belief-types.ts +45 -0
  958. package/src/lib/reasoning/classifier-offline.ts +111 -0
  959. package/src/lib/reasoning/dreamer.ts +215 -0
  960. package/src/lib/reasoning/nudge-analytics.ts +85 -0
  961. package/src/lib/reasoning/policy-rules.ts +172 -0
  962. package/src/lib/reasoning/reasoning-metrics.ts +202 -0
  963. package/src/lib/reasoning/reasoning-summary.ts +154 -0
  964. package/src/lib/reasoning/tool-usage-analyzer.ts +248 -0
  965. package/src/lib/state/AGENTS.md +192 -0
  966. package/src/lib/state/async-storage.ts +189 -0
  967. package/src/lib/state/extension-state.ts +419 -0
  968. package/src/lib/state/global-state.ts +1046 -0
  969. package/src/lib/state/metacognitive-state.ts +65 -0
  970. package/src/lib/state/session-manager.ts +43 -0
  971. package/src/lib/state/session-start-queue.ts +135 -0
  972. package/src/lib/state/state-checkpoint.ts +352 -0
  973. package/src/lib/state/telegram-poller-liveness.ts +75 -0
  974. package/src/lib/state/tool-provenance.ts +26 -0
  975. package/src/lib/state/workspace-snapshot.ts +466 -0
  976. package/src/lib/store/AGENTS.md +24 -0
  977. package/src/lib/store/belief-store.ts +325 -0
  978. package/src/lib/store/bidirectional-verifier.ts +316 -0
  979. package/src/lib/store/claim-tracker.ts +382 -0
  980. package/src/lib/store/conflict-qa.ts +385 -0
  981. package/src/lib/store/evidence-pool.ts +779 -0
  982. package/src/lib/telemetry/AGENTS.md +28 -0
  983. package/src/lib/telemetry/context-heartbeat.ts +555 -0
  984. package/src/lib/telemetry/drift-signals.ts +105 -0
  985. package/src/lib/telemetry/rss-telemetry.ts +57 -0
  986. package/src/lib/types/AGENTS.md +21 -0
  987. package/src/lib/types/episode-types.ts +31 -0
  988. package/src/lib/types/standard-result.ts +40 -0
  989. package/src/lib/utils/AGENTS.md +30 -0
  990. package/src/lib/utils/async-fs.ts +23 -0
  991. package/src/lib/utils/bounded.ts +58 -0
  992. package/src/lib/utils/dedup.ts +44 -0
  993. package/src/lib/utils/error-guard.ts +27 -0
  994. package/src/lib/utils/extension-utils.ts +72 -0
  995. package/src/lib/utils/extract-json.ts +89 -0
  996. package/src/lib/utils/file-mutation-queue.ts +172 -0
  997. package/src/lib/utils/filter-safe-to-remove.ts +301 -0
  998. package/src/lib/utils/format-tool-result.ts +109 -0
  999. package/src/lib/utils/id.ts +64 -0
  1000. package/src/lib/utils/injection-tracker.ts +1014 -0
  1001. package/src/lib/utils/local-time.ts +196 -0
  1002. package/src/lib/utils/memory-fence.ts +70 -0
  1003. package/src/lib/utils/sop-extractor.ts +329 -0
  1004. package/src/lib/utils/sop-suggestion.ts +426 -0
  1005. package/src/lib/utils/wake-gate.ts +318 -0
  1006. package/src/lib/utils/whisper-format.ts +120 -0
  1007. package/src/lib/verification/coordination-checker.ts +183 -0
  1008. package/src/loader/AGENTS.md +32 -0
  1009. package/src/loader/api.ts +138 -0
  1010. package/src/loader/loader.ts +600 -0
  1011. package/src/types/extension-context.d.ts +85 -0
@@ -0,0 +1,796 @@
1
+ /**
2
+ * Orchestrator extension — multi-agent coordination.
3
+ *
4
+ * Registers the `orchestrate` tool for managing parallel agent workers.
5
+ * Supports branch-per-worker, a per-project worker registry (admission,
6
+ * lifecycle, structured result-location verdicts), file-lock awareness,
7
+ * conflict detection, and merge verification.
8
+ *
9
+ * Git operations auto-detect the repo root from the `files` parameter,
10
+ * so orchestrate works from ANY cwd (including ~/.pi/agent). Falls back
11
+ * to lock-only coordination when no git repo is found.
12
+ *
13
+ * Workers can be spawned via herdr (recommended) or manual instructions.
14
+ *
15
+ * This is the implementation counterpart to skills/orchestrator/SKILL.md.
16
+ */
17
+ import { execFileSync } from "node:child_process";
18
+ import { Type } from "typebox";
19
+ import { createLogger } from "../../lib/core/logger.js";
20
+ import { acquireLock, releaseLock, getConflicts, getAllLocks, createWorkerBranch, deleteWorkerBranch, getDiff, getCurrentBranch, findRepoRoot, branchExists, gitAvailable, worktreeForBranch, scanAddedLinesForSlop, registerWorker, updateWorker, closeWorker, recordWorkerMerge, readWorkers, checkWorker, parseWorkerStatus, parseWorkerOutcome, decideAdmission, recordAdmissionRefusal, resolveRequestId, computeWorkerStats, workerEffectEvidenceForEntry, WORKER_EFFECT_EVIDENCE_FLAG, WORKER_SPECS, WORKER_OUTCOMES, WORKER_STATUSES, WORKER_STATUS_LAYERS, } from "../../lib/orchestrator/index.js";
21
+ const log = createLogger("orchestrator");
22
+ // Helpers
23
+ /**
24
+ * Resolve the repo root: explicit `cwd` param wins, otherwise auto-detect
25
+ * from file paths. Returns undefined if no git repo is found.
26
+ */
27
+ function resolveCwd(cwd, files) {
28
+ if (cwd)
29
+ return cwd;
30
+ if (files && files.length > 0)
31
+ return findRepoRoot(files);
32
+ return undefined;
33
+ }
34
+ /**
35
+ * The files in `files` currently held by a worker other than `workerId`.
36
+ * The read-only half of lock booking: a caller uses it to refuse before it
37
+ * mutates anything (spawn-worker checks before it creates a branch).
38
+ */
39
+ function filesHeldByOthers(files, workerId, cwd) {
40
+ if (!files || files.length === 0)
41
+ return [];
42
+ return getConflicts(files, cwd).filter((c) => c.lockedBy !== workerId);
43
+ }
44
+ /**
45
+ * Write the worker's lock rows for its declared files — the one seat where
46
+ * spawn-worker, register-worker and update-worker turn files into locks, so
47
+ * the three cannot drift on which files a worker holds. A file another worker
48
+ * holds blocks the whole booking and nothing is written; a row the same worker
49
+ * already holds is refreshed with the current branch. `files` absent or empty
50
+ * is a no-op. Returns the blocking rows (empty on success).
51
+ */
52
+ function bookWorkerLocks(workerId, files, branch, cwd) {
53
+ if (!files || files.length === 0)
54
+ return [];
55
+ const blockers = filesHeldByOthers(files, workerId, cwd);
56
+ if (blockers.length > 0)
57
+ return blockers;
58
+ if (!acquireLock(files, workerId, branch, cwd)) {
59
+ return filesHeldByOthers(files, workerId, cwd);
60
+ }
61
+ return [];
62
+ }
63
+ /** Render lock conflicts as the indented block the CONFLICT refusals print. */
64
+ function conflictLines(conflicts) {
65
+ return conflicts.map((c) => ` ${c.file} — locked by ${c.lockedBy} (${c.branch})`).join("\n");
66
+ }
67
+ /**
68
+ * Git plumbing for the merge path. verify-and-merge must be able to read and
69
+ * advance a ref without checking it out: the shared worktree is usually parked
70
+ * on a worker branch and other agents read it, so switching branches is not
71
+ * ours to do. These helpers return undefined/no on any git failure rather than
72
+ * throwing, so a merge refusal is always reported, never a crash.
73
+ */
74
+ function git(repoRoot, args) {
75
+ try {
76
+ return execFileSync("git", ["-C", repoRoot, ...args], {
77
+ encoding: "utf-8",
78
+ stdio: ["ignore", "pipe", "pipe"],
79
+ }).trim();
80
+ }
81
+ catch {
82
+ return undefined;
83
+ }
84
+ }
85
+ /** Resolve a ref to its commit SHA, or undefined when the ref does not exist. */
86
+ function revParse(ref, repoRoot) {
87
+ return git(repoRoot, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]);
88
+ }
89
+ /** True when `ancestor` is reachable from `descendant`. */
90
+ function isAncestor(ancestor, descendant, repoRoot) {
91
+ return git(repoRoot, ["merge-base", "--is-ancestor", ancestor, descendant]) !== undefined;
92
+ }
93
+ /** Reject a ref git could read as an option, or that carries shell metacharacters. */
94
+ function isSafeRef(ref) {
95
+ return /^[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(ref);
96
+ }
97
+ /**
98
+ * Resolve the merge base explicitly, then merge the worker branch into it and
99
+ * assert the base actually moved. Never infers the base from HEAD; never leaves
100
+ * the worktree on a different branch; never claims a merge it did not perform.
101
+ */
102
+ function verifyAndMergeBase(workerId, workerBranch, base, repoRoot) {
103
+ /** A refusal or no-op: nothing was merged, so nothing may be marked merged. */
104
+ const nothingMerged = (report) => ({
105
+ report,
106
+ mergeSha: null,
107
+ worktreeBranch: getCurrentBranch(repoRoot),
108
+ });
109
+ if (!repoRoot || !gitAvailable(repoRoot)) {
110
+ return nothingMerged(`Cannot verify ${workerBranch}: no git repository resolved (pass cwd). No merge performed.`);
111
+ }
112
+ if (!isSafeRef(base) || !isSafeRef(workerBranch)) {
113
+ return nothingMerged(`Refusing to merge: unsafe ref name (base="${base}", branch="${workerBranch}").`);
114
+ }
115
+ if (!branchExists(workerBranch, repoRoot)) {
116
+ return nothingMerged(`Cannot verify ${workerBranch}: branch does not exist. No merge performed.`);
117
+ }
118
+ const baseBefore = revParse(base, repoRoot);
119
+ if (!baseBefore) {
120
+ return nothingMerged(`Cannot merge into "${base}": base branch not found. No merge performed.`);
121
+ }
122
+ const tip = revParse(workerBranch, repoRoot);
123
+ if (!tip) {
124
+ return nothingMerged(`Cannot verify ${workerBranch}: branch has no commit. No merge performed.`);
125
+ }
126
+ const short = (sha) => sha.slice(0, 12);
127
+ const diff = getDiff(workerBranch, base, repoRoot);
128
+ const scan = surfaceScanReport(diff);
129
+ const finish = (lead, deletedLead, mergeSha, extraWorktreeNote = "") => {
130
+ // Where the caller's tree sits is part of the merge result, not a detail:
131
+ // this tool never switches the shared worktree's branch, so after a merge
132
+ // made from a tree parked on the worker branch, the next commit lands on
133
+ // that branch, not on the base. Say so on a line of its own.
134
+ const head = getCurrentBranch(repoRoot);
135
+ const onWorkerBranch = head === workerBranch;
136
+ const worktreeNote = head === base
137
+ ? `\nWorktree: on ${base} (the merge target).`
138
+ : `\nWorktree: ${repoRoot} stays on ${head}, not ${base} (this tool never switches branches), so a commit made there now lands on ${head}. Switch it first: git -C ${repoRoot} checkout ${base}`;
139
+ const settleBlock = extraWorktreeNote ? `\n${extraWorktreeNote}` : "";
140
+ releaseLock(workerId, repoRoot);
141
+ deleteWorkerBranch(workerBranch, repoRoot);
142
+ const deleted = !branchExists(workerBranch, repoRoot);
143
+ // The third thing a finished merge does, beside releasing locks and
144
+ // dropping the branch: mark the worker's audit row. It rides on the line
145
+ // below the merge claim so a reader cannot take the claim without seeing
146
+ // what the registry now says.
147
+ const audit = mergeAuditNote(workerId, mergeSha, repoRoot);
148
+ return {
149
+ report: `${lead}${audit}\nBranch: ${workerBranch} (${deleted ? "deleted" : onWorkerBranch ? "kept: this worktree is on it" : deletedLead})${worktreeNote}${settleBlock}\nDiff summary:\n${diff.slice(0, 2000)}\n${scan}`,
150
+ mergeSha,
151
+ worktreeBranch: head,
152
+ };
153
+ };
154
+ // The base already holds the worker's work: nothing to merge, and saying
155
+ // "merged" here would be a false success.
156
+ if (isAncestor(tip, base, repoRoot)) {
157
+ return finish(`Worker ${workerId} already contained in ${base}: ${short(tip)} is an ancestor of ${base} (${short(baseBefore)}). Nothing merged.`, "kept: still checked out", null);
158
+ }
159
+ // Set when the fast-forward happened in a worktree other than the caller's;
160
+ // the report names where the base's tree moved, so a reader can act on it.
161
+ let settleNote = "";
162
+ const current = getCurrentBranch(repoRoot);
163
+ if (current === base) {
164
+ // The base is the checked-out branch, so merging in place is the only
165
+ // result that keeps index and worktree coherent. Refuse when the worktree
166
+ // carries uncommitted changes: a merge would sweep another worker's edits
167
+ // into the commit.
168
+ const dirty = git(repoRoot, ["status", "--porcelain", "--untracked-files=no"]);
169
+ if (dirty === undefined || dirty.length > 0) {
170
+ return nothingMerged(`NOT merged: worktree on ${base} has uncommitted changes; refusing to merge over them. Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
171
+ }
172
+ if (git(repoRoot, ["merge", "--no-edit", workerBranch]) === undefined) {
173
+ return nothingMerged(`NOT merged: git merge ${workerBranch} into ${base} failed (conflict or refusal). Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
174
+ }
175
+ }
176
+ else {
177
+ // The base is not checked out in the caller's worktree. It may still be
178
+ // checked out in another one (the primary checkout holding main while the
179
+ // seat's cwd is a worker worktree is the normal flow). Advancing the ref
180
+ // with plumbing there moves HEAD to the merge commit while leaving that
181
+ // worktree's index and files on the old tip: `git status` reads as a staged
182
+ // inverse of the merge and the merged files are absent from its tree. Merge
183
+ // in the worktree that holds the base so ref and tree move together.
184
+ if (!isAncestor(base, workerBranch, repoRoot)) {
185
+ return nothingMerged(`NOT merged: ${base} and ${workerBranch} have diverged, and the caller's worktree is on ${current}. Refusing to change a worktree's checkout to resolve it. Merge ${base} manually. Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
186
+ }
187
+ const holder = worktreeForBranch(base, repoRoot);
188
+ if (holder) {
189
+ // The holder is a different worktree: `current === base` was handled
190
+ // above. Refuse over uncommitted changes there, since a merge would fold
191
+ // another seat's edits into the ref move.
192
+ const dirty = git(holder, ["status", "--porcelain", "--untracked-files=no"]);
193
+ if (dirty === undefined || dirty.length > 0) {
194
+ return nothingMerged(`NOT merged: worktree ${holder} holds ${base} with uncommitted changes; refusing to merge over them. Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
195
+ }
196
+ if (git(holder, ["merge", "--ff-only", workerBranch]) === undefined) {
197
+ return nothingMerged(`NOT merged: fast-forward of ${base} in ${holder} to ${short(tip)} failed. Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
198
+ }
199
+ settleNote = `The base worktree ${holder} was fast-forwarded in place, so its ref and files moved together.`;
200
+ }
201
+ else if (git(repoRoot, ["update-ref", `refs/heads/${base}`, tip]) === undefined) {
202
+ // No worktree has the base, so the ref is the only place the merge lives:
203
+ // advancing it alone leaves no tree inconsistent.
204
+ return nothingMerged(`NOT merged: fast-forward of ${base} to ${short(tip)} failed. Base unchanged at ${short(baseBefore)}. Locks and branch kept.`);
205
+ }
206
+ }
207
+ // Verify before reporting: the base ref must actually hold the worker's work.
208
+ const baseAfter = revParse(base, repoRoot);
209
+ if (!baseAfter || baseAfter === baseBefore) {
210
+ return nothingMerged(`NOT merged: ${base} did not move (still ${short(baseBefore)}) after the merge attempt. No merge is claimed. Locks and branch kept.`);
211
+ }
212
+ return finish(`Worker ${workerId} merged into ${base} at ${short(baseAfter)} (was ${short(baseBefore)}).`, "kept: branch is checked out in a worktree", baseAfter, settleNote);
213
+ }
214
+ /**
215
+ * The audit-row half of a merge report, on the line below the merge claim. A
216
+ * merge that moved the base must leave the worker's registry row present and
217
+ * marked with the sha it landed on, so `close-worker` still finds the row and a
218
+ * later reader can see what became of the worker. A merge that finds no row
219
+ * says so here, at merge time, instead of surfacing as an inexplicable "No
220
+ * registry entry" at close time. Empty when no merge happened: a refusal
221
+ * changes no audit state.
222
+ */
223
+ function mergeAuditNote(workerId, mergeSha, cwd) {
224
+ if (!mergeSha)
225
+ return "";
226
+ const stamped = recordWorkerMerge(workerId, { mergeSha, cwd });
227
+ if (!stamped) {
228
+ return `\nAudit row: NO registry entry for ${workerId}; the merge is recorded in git only. Register the row if this worker needs closing.`;
229
+ }
230
+ return `\nAudit row: ${workerId} marked merged at ${mergeSha.slice(0, 12)} (status ${stamped.status}).`;
231
+ }
232
+ /**
233
+ * Advisory surface-discipline check over the worker diff. Returns a short
234
+ * report block: findings listed as warnings, or a note that the scan was
235
+ * unavailable. A scanner failure must never fail the merge path — this is
236
+ * a shadow gate until false-positive data justifies hardening it.
237
+ */
238
+ function surfaceScanReport(diff) {
239
+ try {
240
+ const hits = scanAddedLinesForSlop(diff);
241
+ if (hits.length === 0)
242
+ return "";
243
+ const listed = hits
244
+ .slice(0, 20)
245
+ .map((h) => ` [${h.pattern}] added-line ${h.line}: ${h.excerpt}`)
246
+ .join("\n");
247
+ const overflow = hits.length > 20 ? `\n … ${hits.length - 20} more` : "";
248
+ return `Surface-discipline warning (advisory, non-blocking): ${hits.length} added-line hit(s):
249
+ ${listed}${overflow}
250
+ `;
251
+ }
252
+ catch (err) {
253
+ const reason = err instanceof Error ? err.message : String(err);
254
+ return `Surface-discipline scan unavailable (advisory): ${reason}\n`;
255
+ }
256
+ }
257
+ /** Uniform tool-result shape for the registry actions. */
258
+ function textResult(text, details = {}) {
259
+ return { content: [{ type: "text", text }], details };
260
+ }
261
+ /** One-line registry listing for a worker entry. */
262
+ function workerLine(entry) {
263
+ const closed = entry.closedAt ? ` closed=${entry.closedAt}` : "";
264
+ return ` ${entry.workerId} spec=${entry.spec} status=${entry.status} pane=${entry.pane ?? "-"} session=${entry.workerSession ?? "-"} output=${entry.outputFile ?? "-"} branch=${entry.branch ?? "-"}${closed}`;
265
+ }
266
+ /**
267
+ * Render the fleet statistics as the block `list-workers` appends when stats
268
+ * are requested. The latency line prints its sample, so a median over a
269
+ * handful of rows cannot read as a distribution.
270
+ */
271
+ function formatWorkerStats(stats) {
272
+ const rate = stats.completionRate === null
273
+ ? "no closed rows"
274
+ : `${(stats.completionRate * 100).toFixed(1)}%`;
275
+ const latency = stats.latency.sample === 0
276
+ ? "no result times recorded"
277
+ : `median=${stats.latency.medianMs}ms min=${stats.latency.minMs}ms max=${stats.latency.maxMs}ms`;
278
+ return [
279
+ `stats: closed=${stats.closed}/${stats.total} completed=${stats.completed} (${rate})`,
280
+ ` spawn->result: ${latency} (sample ${stats.latency.sample})`,
281
+ ` duplicate admissions refused: ${stats.admissionRefusals}`,
282
+ ].join("\n");
283
+ }
284
+ /** Render the check-worker verdict as a labeled block (details carry the object). */
285
+ function formatCheckVerdict(verdict) {
286
+ const age = verdict.outputExists ? `age ${verdict.outputAgeSec}s` : "missing";
287
+ return [
288
+ `Worker ${verdict.workerId}`,
289
+ `status: ${verdict.status}`,
290
+ `reason: ${verdict.reason}`,
291
+ `outputFile: ${verdict.outputFile ?? "-"} (${age})`,
292
+ `sessionGrowthAgeSec: ${verdict.sessionGrowthAgeSec ?? "-"}`,
293
+ `branchAhead: ${verdict.branchAhead ?? "-"}`,
294
+ `schemaValid: ${verdict.schemaValid}`,
295
+ `resultSchemaMessageOffset: ${verdict.resultSchemaMessageOffset ?? "-"}`,
296
+ `requestId: ${verdict.requestId ?? "-"}`,
297
+ `checkpoint: ${verdict.checkpoint
298
+ ? `${verdict.checkpoint.phase}/${verdict.checkpoint.step} (${verdict.checkpoint.at})`
299
+ : "-"}`,
300
+ `gateSummary: ${verdict.gateSummary}`,
301
+ `effectEvidence: ${formatEffectEvidence(verdict.effectEvidence)}`,
302
+ ].join("\n");
303
+ }
304
+ /**
305
+ * Render the effect-evidence field of a verdict: the three kinds as flags,
306
+ * or the declared flag phrase when none holds. Null (not a terminal
307
+ * completion) reads like the other absent fields.
308
+ */
309
+ function formatEffectEvidence(evidence) {
310
+ if (!evidence)
311
+ return "-";
312
+ const parts = [
313
+ `output=${evidence.outputWritten}`,
314
+ `branch=${evidence.branchAdvanced}`,
315
+ `gate=${evidence.gatePassed}`,
316
+ ];
317
+ return evidence.none ? `${WORKER_EFFECT_EVIDENCE_FLAG} (${parts.join(" ")})` : parts.join(" ");
318
+ }
319
+ /** The gaps a no-effect-evidence flag names, as the close report prints them. */
320
+ function effectEvidenceGaps(evidence) {
321
+ const gaps = [];
322
+ if (!evidence.outputWritten)
323
+ gaps.push("no output file written during the run");
324
+ if (!evidence.branchAdvanced)
325
+ gaps.push("no branch advance or recorded merge");
326
+ if (!evidence.gatePassed)
327
+ gaps.push("no passing gate");
328
+ return gaps.join(", ");
329
+ }
330
+ /**
331
+ * What a reused admission reports: the live entry's own facts, so the caller
332
+ * resumes the worker that already exists instead of the one it thought it was
333
+ * creating. Reuse is read-only — no branch, no lock, no second row.
334
+ */
335
+ function reuseReport(entry, requestId) {
336
+ const checkpoint = entry.checkpoint
337
+ ? `${entry.checkpoint.phase}/${entry.checkpoint.step} (${entry.checkpoint.at})`
338
+ : "none recorded";
339
+ return `Worker ${entry.workerId} is already admitted under requestId ${requestId} (status ${entry.status}); reusing that entry, no duplicate was created.
340
+ Branch: ${entry.branch ?? "-"} (existing)
341
+ Files locked: ${entry.files.length > 0 ? entry.files.join(", ") : "-"}
342
+ Spec: ${entry.spec}
343
+ Output: ${entry.outputFile ?? "-"}
344
+ Checkpoint: ${checkpoint}
345
+
346
+ Resume the worker from its checkpoint, or close it (orchestrate action=close-worker) to admit a fresh attempt.`;
347
+ }
348
+ // Tool Definition
349
+ /**
350
+ * The four lifecycle vocabularies as one clause, rendered from
351
+ * WORKER_STATUS_LAYERS so the tool schema never restates a vocabulary value.
352
+ */
353
+ function renderStatusLayers() {
354
+ return WORKER_STATUS_LAYERS.map((layer) => `${layer.role} (${layer.values.join("|")}), ${layer.states}`).join("; ");
355
+ }
356
+ const orchestrateTool = {
357
+ name: "orchestrate",
358
+ label: "Orchestrate",
359
+ promptSnippet: "Coordinate parallel agent workers (spawn/check/merge, locks)",
360
+ description: "Coordinate parallel agent workers to prevent edit conflicts. Auto-detects the repo root (cwd overrides); without git, lock-only. verify-and-merge requires workerId, merges into an explicit base branch (default main), and claims success only when that base ref actually advanced. It never switches a worktree's branch: the caller's tree is left on the branch it was on, named in the report, and a branch is dropped only when it is actually gone. " +
361
+ `Worker lifecycle speaks in four vocabularies: ${renderStatusLayers()}.`,
362
+ parameters: Type.Object({
363
+ action: Type.Union([
364
+ Type.Literal("spawn-worker"),
365
+ Type.Literal("register-worker"),
366
+ Type.Literal("update-worker"),
367
+ Type.Literal("check-worker"),
368
+ Type.Literal("list-workers"),
369
+ Type.Literal("close-worker"),
370
+ Type.Literal("verify-and-merge"),
371
+ Type.Literal("release-locks"),
372
+ Type.Literal("list-locks"),
373
+ Type.Literal("check-conflicts"),
374
+ ], { description: "The orchestration action to perform" }),
375
+ workerId: Type.Optional(Type.String({
376
+ description: "Unique worker identifier (e.g. w1). Required by spawn-worker, register-worker, update-worker, check-worker, close-worker, and verify-and-merge.",
377
+ })),
378
+ slug: Type.Optional(Type.String({ description: "Kebab-case task description. Required for spawn-worker." })),
379
+ files: Type.Optional(Type.Array(Type.String(), {
380
+ description: "File paths the worker will modify. Required for spawn-worker and check-conflicts; register/update-worker book them as lock rows.",
381
+ })),
382
+ branch: Type.Optional(Type.String({
383
+ description: "Branch name. register/update-worker record it; verify-and-merge resolves it from this argument, the worker's entry, or its lock rows.",
384
+ })),
385
+ requestId: Type.Optional(Type.String({
386
+ description: "spawn-worker/register-worker: exactly-once request id for this submission, defaulting to `<workerId>:1` (the workerId plus submission-step key). A retried admission of the same work reuses the entry that request admitted instead of admitting a duplicate.",
387
+ })),
388
+ baseBranch: Type.Optional(Type.String({
389
+ description: "verify-and-merge: the branch the worker's work is merged into (default: main).",
390
+ })),
391
+ cwd: Type.Optional(Type.String({ description: "Git repo root (auto-detected from files if omitted)." })),
392
+ spec: Type.Optional(Type.String({
393
+ description: `Worker spec (${WORKER_SPECS.join("|")}). Required for spawn-worker and register-worker.`,
394
+ })),
395
+ outputFile: Type.Optional(Type.String({
396
+ description: "Deliverable path the worker must produce. Required for spawn-worker; also register/update-worker.",
397
+ })),
398
+ pane: Type.Optional(Type.String({
399
+ description: "Worker pane ID (register-worker/update-worker). Recorded as a handle only: check-worker does not read it as liveness.",
400
+ })),
401
+ workspace: Type.Optional(Type.String({ description: "Worker workspace ID (update-worker)." })),
402
+ workerSession: Type.Optional(Type.String({
403
+ description: "Worker session .jsonl path (register-worker/update-worker). check-worker reads its mtime: a session file written within the last 600s reports status working without a live state.",
404
+ })),
405
+ status: Type.Optional(Type.String({
406
+ description: "Lifecycle status for update-worker (see the tool description).",
407
+ })),
408
+ phase: Type.Optional(Type.String({
409
+ description: "update-worker: checkpoint phase the worker is in (e.g. impl, gates). Requires lastStep; the registry stamps the time.",
410
+ })),
411
+ lastStep: Type.Optional(Type.String({
412
+ description: "update-worker: last completed step within phase (e.g. commit, typecheck). Requires phase. check-worker reports this checkpoint when the worker is mid-flight with no live evidence.",
413
+ })),
414
+ outcome: Type.Optional(Type.String({
415
+ description: `Terminal outcome for close-worker (${WORKER_OUTCOMES.join("|")}).`,
416
+ })),
417
+ gates: Type.Optional(Type.Array(Type.Object({ cmd: Type.String(), exit: Type.Number() }), {
418
+ description: "Gate evidence for close-worker: command plus exit code, recorded with a timestamp. " +
419
+ `A completed close whose entry carries none of a fresh output file, a branch advance or ` +
420
+ `merge, and a passing gate is flagged "${WORKER_EFFECT_EVIDENCE_FLAG}" (advisory, non-blocking).`,
421
+ })),
422
+ includeClosed: Type.Optional(Type.Boolean({ description: "list-workers: include closed entries (default false)." })),
423
+ includeStats: Type.Optional(Type.Boolean({
424
+ description: "list-workers: append fleet statistics (spawn->result latency, completion rate, duplicate admissions refused) after the listing (default false). The latency line prints its own sample size.",
425
+ })),
426
+ liveStatus: Type.Optional(Type.String({
427
+ description: "check-worker: herdr lifecycle state (idle|working|blocked|done|unknown) passed by the parent; the tool never queries herdr itself.",
428
+ })),
429
+ }),
430
+ execute: async (_id, params, _signal, _onUpdate, _ctx) => {
431
+ const { action, workerId, slug, files, branch, baseBranch, cwd: explicitCwd, spec, outputFile, pane, workspace, workerSession, status, phase, lastStep, requestId, outcome, gates, includeClosed, includeStats, liveStatus, } = params;
432
+ const repoRoot = resolveCwd(explicitCwd, files);
433
+ switch (action) {
434
+ case "spawn-worker": {
435
+ if (!workerId || !slug || !files || files.length === 0) {
436
+ throw new Error("spawn-worker requires workerId, slug, and files");
437
+ }
438
+ if (!spec || !outputFile) {
439
+ throw new Error("spawn-worker requires spec and outputFile: both are written into the worker registry " +
440
+ "entry, and a worker with no registry entry is invisible to list-workers and check-worker.");
441
+ }
442
+ // The registry key is the same project key the locks use, so a repo-less
443
+ // spawn still lands beside its lock file and list-workers sees it.
444
+ const projectCwd = repoRoot ?? process.cwd();
445
+ // Identity before admission: a retried spawn carries the same
446
+ // (workerId, step) request id as the submission it is retrying, so it
447
+ // reuses the entry that submission admitted instead of adding a second
448
+ // live row for one worker. A different request, or the same id
449
+ // describing different work, is refused with both ids named.
450
+ const effectiveRequestId = resolveRequestId(workerId, requestId);
451
+ const existing = readWorkers(projectCwd).workers[workerId];
452
+ const decision = decideAdmission(existing, effectiveRequestId, { spec, files });
453
+ if (decision.action === "reuse" && decision.entry) {
454
+ return textResult(reuseReport(decision.entry, effectiveRequestId), {
455
+ entry: decision.entry,
456
+ reused: true,
457
+ });
458
+ }
459
+ if (decision.action === "refuse") {
460
+ // Record the refusal before it is reported: the fleet's refusal count
461
+ // is registry fact, and this pre-check is where a duplicate spawn is
462
+ // turned away. No branch or lock exists yet, so nothing else to undo.
463
+ recordAdmissionRefusal(workerId, effectiveRequestId, projectCwd);
464
+ throw new Error(`spawn-worker: ${decision.reason}.`);
465
+ }
466
+ const conflicts = filesHeldByOthers(files, workerId, repoRoot);
467
+ if (conflicts.length > 0) {
468
+ return textResult(`CONFLICT: ${conflicts.length} file(s) already locked by other workers:\n${conflictLines(conflicts)}\n\nResolve conflicts before spawning this worker.`);
469
+ }
470
+ const branchName = createWorkerBranch(workerId, slug, undefined, repoRoot);
471
+ // Re-booked after branch creation: a file grabbed between the gate
472
+ // above and here still loses the race, and the branch goes with it.
473
+ if (bookWorkerLocks(workerId, files, branchName, repoRoot).length > 0) {
474
+ deleteWorkerBranch(branchName, repoRoot);
475
+ return textResult("Failed to acquire locks (race condition). Try again.");
476
+ }
477
+ let registered;
478
+ try {
479
+ registered = registerWorker({
480
+ workerId,
481
+ spec,
482
+ cwd: projectCwd,
483
+ files,
484
+ branch: branchName,
485
+ outputFile,
486
+ requestId: effectiveRequestId,
487
+ }, projectCwd);
488
+ }
489
+ catch (err) {
490
+ releaseLock(workerId, repoRoot);
491
+ deleteWorkerBranch(branchName, repoRoot);
492
+ const reason = err instanceof Error ? err.message : String(err);
493
+ throw new Error(`spawn-worker: registering ${workerId} failed (${reason}). Locks released and branch ` +
494
+ `${branchName} deleted; no half-made worker.`, { cause: err });
495
+ }
496
+ if (!registered.ok) {
497
+ releaseLock(workerId, repoRoot);
498
+ deleteWorkerBranch(branchName, repoRoot);
499
+ return textResult(`Worker ${workerId} not spawned: ${registered.reason}. Locks released and branch ` +
500
+ `${branchName} deleted; no half-made worker.`);
501
+ }
502
+ // The same request landed between the decision above and this write.
503
+ // The entry that request admitted is the worker; the branch created
504
+ // here is stray unless it is that entry's own, and reporting it as the
505
+ // worker's branch would be a false statement about where the work is.
506
+ if (registered.reused && registered.entry) {
507
+ if (registered.entry.branch !== branchName)
508
+ deleteWorkerBranch(branchName, repoRoot);
509
+ return textResult(reuseReport(registered.entry, effectiveRequestId), {
510
+ entry: registered.entry,
511
+ reused: true,
512
+ });
513
+ }
514
+ return textResult(`Worker ${workerId} ready and registered.
515
+ Branch: ${branchName}
516
+ Files locked: ${files.join(", ")}
517
+ Spec: ${spec}
518
+ Output: ${outputFile}
519
+
520
+ To spawn the worker:
521
+ 1. Use herdr to create a new pane
522
+ 2. Pass the branch name and locked files to the worker
523
+ 3. The worker should: git checkout ${branchName}, make changes, commit, then signal completion
524
+
525
+ When the worker signals completion, use orchestrate action=verify-and-merge to review and merge.`, { entry: registered.entry });
526
+ }
527
+ case "register-worker": {
528
+ if (!workerId || !spec || !explicitCwd) {
529
+ throw new Error("register-worker requires workerId, spec, and cwd");
530
+ }
531
+ // A live entry refuses re-registration; surface the canonical refusal
532
+ // before booking anything so a duplicate mutates nothing.
533
+ const live = readWorkers(explicitCwd).workers[workerId];
534
+ if (live && !live.closedAt) {
535
+ const result = registerWorker({
536
+ workerId,
537
+ spec,
538
+ cwd: explicitCwd,
539
+ files,
540
+ branch,
541
+ outputFile,
542
+ pane,
543
+ workerSession,
544
+ requestId,
545
+ }, explicitCwd);
546
+ // A reuse is reported in the result itself: `reused: true` with the
547
+ // live entry, so a caller parsing the JSON sees that its request was
548
+ // already admitted and no second row was written.
549
+ return textResult(JSON.stringify(result, null, 2));
550
+ }
551
+ // Registering is admission, so the entry is written only once its
552
+ // declared files are actually locked — the same booking spawn-worker
553
+ // performs, at the same project key.
554
+ const conflicts = bookWorkerLocks(workerId, files, branch ?? "", explicitCwd);
555
+ if (conflicts.length > 0) {
556
+ return textResult(`CONFLICT: ${conflicts.length} file(s) already locked by other workers:\n${conflictLines(conflicts)}\n\nResolve conflicts before registering this worker.`);
557
+ }
558
+ const result = registerWorker({
559
+ workerId,
560
+ spec,
561
+ cwd: explicitCwd,
562
+ files,
563
+ branch,
564
+ outputFile,
565
+ pane,
566
+ workerSession,
567
+ requestId,
568
+ }, explicitCwd);
569
+ return textResult(JSON.stringify(result, null, 2));
570
+ }
571
+ case "update-worker": {
572
+ if (!workerId) {
573
+ throw new Error("update-worker requires workerId");
574
+ }
575
+ const patch = {};
576
+ if (pane !== undefined)
577
+ patch.pane = pane;
578
+ if (workspace !== undefined)
579
+ patch.workspace = workspace;
580
+ if (workerSession !== undefined)
581
+ patch.workerSession = workerSession;
582
+ if (outputFile !== undefined)
583
+ patch.outputFile = outputFile;
584
+ if (branch !== undefined)
585
+ patch.branch = branch;
586
+ if (files !== undefined)
587
+ patch.files = files;
588
+ if (status !== undefined)
589
+ patch.status = parseWorkerStatus(status);
590
+ if (phase !== undefined || lastStep !== undefined) {
591
+ if (!phase || !lastStep) {
592
+ throw new Error("update-worker: a checkpoint needs both phase and lastStep (the last completed step within that phase).");
593
+ }
594
+ patch.checkpoint = { phase, step: lastStep };
595
+ }
596
+ const updated = updateWorker(workerId, patch, repoRoot);
597
+ if (!updated) {
598
+ return textResult(`No registry entry for worker ${workerId}.`);
599
+ }
600
+ // Repair/refresh pass: an entry admitted without files has no lock rows,
601
+ // so an update that names files books them here. Rows already held are
602
+ // refreshed with the current branch and never dropped; a closed worker
603
+ // is not re-locked.
604
+ let lockNote = "";
605
+ if (files !== undefined && !updated.closedAt) {
606
+ const conflicts = bookWorkerLocks(workerId, files, updated.branch ?? "", repoRoot);
607
+ if (conflicts.length > 0) {
608
+ lockNote = `\nWARNING: locks not booked for ${conflicts.length} file(s) held by other workers:\n${conflictLines(conflicts)}`;
609
+ }
610
+ else if (files.length > 0) {
611
+ lockNote = `\nLocks booked: ${files.join(", ")}`;
612
+ }
613
+ }
614
+ return textResult(`Worker ${workerId} updated.\n${JSON.stringify(updated, null, 2)}${lockNote}`, {
615
+ entry: updated,
616
+ });
617
+ }
618
+ case "list-workers": {
619
+ const registry = readWorkers(repoRoot);
620
+ const all = Object.values(registry.workers);
621
+ const shown = includeClosed ? all : all.filter((entry) => !entry.closedAt);
622
+ // Statistics are opt-in: the ordinary listing stays byte-for-byte the
623
+ // same, and a caller that wants fleet numbers asks for them.
624
+ const stats = includeStats ? computeWorkerStats(registry) : null;
625
+ const statsSuffix = stats ? `\n${formatWorkerStats(stats)}` : "";
626
+ const details = stats ? { stats } : {};
627
+ if (shown.length === 0) {
628
+ return textResult((all.length === 0
629
+ ? "No workers registered."
630
+ : `No live workers (${all.length} closed). Pass includeClosed=true to show them.`) +
631
+ statsSuffix, details);
632
+ }
633
+ const counts = new Map();
634
+ for (const entry of all)
635
+ counts.set(entry.status, (counts.get(entry.status) ?? 0) + 1);
636
+ const closedCount = all.filter((entry) => entry.closedAt).length;
637
+ const byStatus = WORKER_STATUSES.map((s) => `${s}=${counts.get(s) ?? 0}`).join(" ");
638
+ const lines = shown.map(workerLine).join("\n");
639
+ return textResult(`Workers (${repoRoot ?? process.cwd()}):\n${lines}\ncounts: total=${all.length} live=${all.length - closedCount} closed=${closedCount} | ${byStatus}${statsSuffix}`, details);
640
+ }
641
+ case "close-worker": {
642
+ if (!workerId || !outcome) {
643
+ throw new Error("close-worker requires workerId and outcome");
644
+ }
645
+ const closed = closeWorker(workerId, parseWorkerOutcome(outcome), gates, repoRoot);
646
+ if (!closed) {
647
+ return textResult(`No registry entry for worker ${workerId}.`);
648
+ }
649
+ // A terminal completion carries its effect evidence on the close
650
+ // result: a completed close whose row shows none of the three kinds
651
+ // is flagged in the report. The flag is advisory — the close itself
652
+ // stands, and the parent decides what the missing evidence means.
653
+ const effectEvidence = closed.closedAt && closed.status === "completed"
654
+ ? workerEffectEvidenceForEntry(closed, { cwd: repoRoot })
655
+ : null;
656
+ const flagNote = effectEvidence && effectEvidence.none
657
+ ? `\n${WORKER_EFFECT_EVIDENCE_FLAG}: ${effectEvidenceGaps(effectEvidence)}`
658
+ : "";
659
+ return textResult(`Worker ${workerId} closed: ${closed.status}.${flagNote}\n${JSON.stringify(closed, null, 2)}`, {
660
+ entry: closed,
661
+ effectEvidence,
662
+ });
663
+ }
664
+ case "check-worker": {
665
+ if (!workerId) {
666
+ throw new Error("check-worker requires workerId");
667
+ }
668
+ // The lock table is the fallback branch source for an entry whose own
669
+ // branch is null; checkWorker reads it at the entry's own project key.
670
+ const verdict = checkWorker(workerId, { liveStatus, cwd: repoRoot });
671
+ if (verdict) {
672
+ return textResult(formatCheckVerdict(verdict), { ...verdict });
673
+ }
674
+ const locks = getAllLocks(repoRoot);
675
+ const workerFiles = Object.entries(locks).filter(([, entry]) => entry.workerId === workerId);
676
+ if (workerFiles.length === 0) {
677
+ return textResult(`No registry entry and no locks for worker ${workerId}. Register it with orchestrate action=register-worker.`);
678
+ }
679
+ const wBranch = workerFiles[0][1].branch;
680
+ const currentBranch = getCurrentBranch(repoRoot);
681
+ return textResult(`Worker ${workerId} has no registry entry (lock-only).
682
+ Branch: ${wBranch}
683
+ Current branch: ${currentBranch}
684
+ Locked files: ${workerFiles.map(([f]) => f).join(", ")}
685
+
686
+ Register the worker (orchestrate action=register-worker) for a structured verdict.`);
687
+ }
688
+ case "verify-and-merge": {
689
+ if (!workerId) {
690
+ throw new Error("verify-and-merge requires workerId");
691
+ }
692
+ // Locks are a conflict-prevention device, not the statement of which
693
+ // branch to merge: resolve the branch from the explicit argument, the
694
+ // registry entry, or the worker's lock rows, and block only when none
695
+ // of the three yields one.
696
+ const lockRows = getAllLocks(repoRoot);
697
+ const lockBranch = Object.values(lockRows).find((row) => row.workerId === workerId)?.branch;
698
+ const entryBranch = readWorkers(repoRoot).workers[workerId]?.branch ?? undefined;
699
+ const workerBranch = branch ?? entryBranch ?? lockBranch;
700
+ if (!workerBranch) {
701
+ return textResult(`Worker ${workerId} has no branch to verify: no branch argument, no branch on its ` +
702
+ `registry entry, and no lock rows. Nothing to verify.`);
703
+ }
704
+ const outcome = verifyAndMergeBase(workerId, workerBranch, baseBranch ?? "main", repoRoot);
705
+ // The merge sha travels in details as well as in the report, so a
706
+ // parent can verify the claim it was handed without parsing prose; the
707
+ // worktree branch travels with it, because a merge that leaves the
708
+ // caller parked on the worker branch is a fact the caller acts on.
709
+ return textResult(outcome.report, {
710
+ ...(outcome.mergeSha ? { mergeSha: outcome.mergeSha } : {}),
711
+ baseBranch: baseBranch ?? "main",
712
+ worktreeBranch: outcome.worktreeBranch,
713
+ });
714
+ }
715
+ case "release-locks": {
716
+ if (!workerId) {
717
+ throw new Error("release-locks requires workerId");
718
+ }
719
+ releaseLock(workerId, repoRoot);
720
+ return {
721
+ content: [
722
+ {
723
+ type: "text",
724
+ text: `Released all locks for worker ${workerId}.`,
725
+ },
726
+ ],
727
+ details: {},
728
+ };
729
+ }
730
+ case "list-locks": {
731
+ const locks = getAllLocks(repoRoot);
732
+ const entries = Object.entries(locks);
733
+ if (entries.length === 0) {
734
+ return {
735
+ content: [
736
+ {
737
+ type: "text",
738
+ text: "No locks held.",
739
+ },
740
+ ],
741
+ details: {},
742
+ };
743
+ }
744
+ const detail = entries
745
+ .map(([file, entry]) => ` ${file} → ${entry.workerId} (${entry.branch})`)
746
+ .join("\n");
747
+ return {
748
+ content: [
749
+ {
750
+ type: "text",
751
+ text: `Current locks:\n${detail}`,
752
+ },
753
+ ],
754
+ details: {},
755
+ };
756
+ }
757
+ case "check-conflicts": {
758
+ if (!files) {
759
+ throw new Error("check-conflicts requires files");
760
+ }
761
+ const conflicts = getConflicts(files, repoRoot);
762
+ if (conflicts.length === 0) {
763
+ return {
764
+ content: [
765
+ {
766
+ type: "text",
767
+ text: "No conflicts detected. All files are available.",
768
+ },
769
+ ],
770
+ details: {},
771
+ };
772
+ }
773
+ const detail = conflicts
774
+ .map((c) => ` ${c.file} → ${c.lockedBy} (${c.branch})`)
775
+ .join("\n");
776
+ return {
777
+ content: [
778
+ {
779
+ type: "text",
780
+ text: `Conflicts detected:\n${detail}`,
781
+ },
782
+ ],
783
+ details: {},
784
+ };
785
+ }
786
+ default:
787
+ throw new Error(`Unknown action: ${action}`);
788
+ }
789
+ },
790
+ };
791
+ // Extension Factory
792
+ export default function orchestratorExtension(pi) {
793
+ pi.registerTool(orchestrateTool);
794
+ log.info("[orchestrator] registered orchestrate tool");
795
+ }
796
+ //# sourceMappingURL=index.js.map