pi-harness-runtime 0.10.11 → 0.10.12

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 (584) hide show
  1. package/cli.ts +111 -0
  2. package/footer-status.ts +204 -0
  3. package/harness/agent-handoff.ts +189 -0
  4. package/harness/auto-compact.ts +309 -0
  5. package/harness/auto-quota-resume.ts +132 -0
  6. package/harness/autonomous-review.ts +88 -0
  7. package/harness/blackboard.ts +291 -0
  8. package/harness/context-compact-orchestrator.ts +551 -0
  9. package/harness/context-window-manager.ts +464 -0
  10. package/harness/continue-prompt.ts +242 -0
  11. package/harness/e2e/index.ts +44 -0
  12. package/harness/e2e/minimax-quota-parser.ts +88 -0
  13. package/harness/e2e/minimax-quota-scraper.ts +609 -0
  14. package/harness/e2e/openai-quota-scraper.ts +447 -0
  15. package/harness/e2e/playwright-runner.ts +204 -0
  16. package/harness/e2e/quota-status.ts +194 -0
  17. package/harness/e2e/test-engine.ts +398 -0
  18. package/harness/forked-summarizer.ts +304 -0
  19. package/harness/herdr-agents.ts +91 -0
  20. package/harness/index.ts +232 -0
  21. package/harness/job-state-machine.ts +363 -0
  22. package/harness/loop-code-agent.ts +284 -0
  23. package/harness/loop-controller.ts +201 -0
  24. package/harness/loop-review-agent.ts +295 -0
  25. package/harness/loop-runtime.ts +760 -0
  26. package/harness/loop-types.ts +118 -0
  27. package/harness/master-planner.ts +327 -0
  28. package/harness/notification-events.ts +299 -0
  29. package/harness/output-limit-handler.ts +316 -0
  30. package/harness/partial-recovery.ts +531 -0
  31. package/harness/project-detector/detector.ts +328 -0
  32. package/harness/repair-engine.ts +340 -0
  33. package/harness/session-memory.ts +401 -0
  34. package/harness/task-graph.d.ts +51 -0
  35. package/harness/task-graph.ts +143 -0
  36. package/mirror.ts +278 -0
  37. package/package.json +8 -12
  38. package/packages/a2a-adapter/src/agent.ts +139 -0
  39. package/packages/a2a-adapter/src/client.ts +107 -0
  40. package/packages/a2a-adapter/src/discovery.ts +106 -0
  41. package/packages/a2a-adapter/src/index.ts +38 -0
  42. package/packages/a2a-adapter/src/protocol.ts +46 -0
  43. package/packages/a2a-adapter/src/transport.ts +142 -0
  44. package/packages/a2a-adapter/src/types.ts +117 -0
  45. package/packages/auth/src/minimax-browser-auth.ts +1109 -0
  46. package/packages/auth/src/run-minimax-auth.ts +150 -0
  47. package/packages/autonomous-refactor/src/detector.ts +219 -0
  48. package/packages/autonomous-refactor/src/index.ts +16 -0
  49. package/packages/autonomous-refactor/src/planner.ts +99 -0
  50. package/packages/autonomous-refactor/src/types.ts +57 -0
  51. package/packages/autonomous-runtime/src/inbox.ts +266 -0
  52. package/packages/autonomous-runtime/src/index.ts +22 -0
  53. package/packages/autonomous-runtime/src/lease.ts +318 -0
  54. package/packages/autonomous-runtime/src/types.ts +257 -0
  55. package/packages/cache-strategy/src/cache.ts +213 -0
  56. package/packages/cache-strategy/src/index.ts +6 -0
  57. package/packages/cache-strategy/src/types.ts +40 -0
  58. package/packages/capability-registry/src/defaults.ts +247 -0
  59. package/packages/capability-registry/src/index.ts +43 -0
  60. package/packages/capability-registry/src/query.ts +99 -0
  61. package/packages/capability-registry/src/registry.ts +222 -0
  62. package/packages/capability-registry/src/types.d.ts +47 -0
  63. package/packages/capability-registry/src/types.js +10 -0
  64. package/packages/capability-registry/src/types.ts +83 -0
  65. package/packages/checkpoint/src/checkpoint-manager.ts +33 -0
  66. package/packages/checkpoint/src/differ.ts +281 -0
  67. package/packages/checkpoint/src/engine.ts +532 -0
  68. package/packages/checkpoint/src/index.ts +48 -0
  69. package/packages/checkpoint/src/storage.ts +439 -0
  70. package/packages/checkpoint/src/types.ts +348 -0
  71. package/packages/cli-plugin-sdk/src/index.ts +169 -0
  72. package/packages/cli-plugin-sdk/src/plugin-fs.ts +91 -0
  73. package/packages/cli-plugin-sdk/src/registry.ts +55 -0
  74. package/packages/cli-plugin-sdk/src/types.ts +32 -0
  75. package/packages/clipboard/dist/src/clipboard.d.ts +11 -0
  76. package/packages/clipboard/dist/src/clipboard.js +51 -0
  77. package/packages/clipboard/dist/src/copy-sync.d.ts +27 -0
  78. package/packages/clipboard/dist/src/copy-sync.js +170 -0
  79. package/packages/clipboard/dist/src/gist-relay.d.ts +48 -0
  80. package/packages/clipboard/dist/src/gist-relay.js +186 -0
  81. package/packages/clipboard/dist/src/github-login.d.ts +16 -0
  82. package/packages/clipboard/dist/src/github-login.js +69 -0
  83. package/packages/clipboard/dist/src/index.d.ts +4 -0
  84. package/packages/clipboard/dist/src/index.js +3 -0
  85. package/packages/clipboard/dist/src/types.d.ts +13 -0
  86. package/packages/clipboard/dist/src/types.js +5 -0
  87. package/packages/clipboard/src/clipboard.ts +59 -0
  88. package/packages/clipboard/src/copy-sync.ts +201 -0
  89. package/packages/clipboard/src/gist-relay.ts +240 -0
  90. package/packages/clipboard/src/github-login.ts +107 -0
  91. package/packages/clipboard/src/index.ts +3 -0
  92. package/packages/clipboard/src/types.ts +14 -0
  93. package/packages/code-generation/src/faker.ts +461 -0
  94. package/packages/code-generation/src/generator.ts +421 -0
  95. package/packages/code-generation/src/index.ts +56 -0
  96. package/packages/code-generation/src/templates/ejs-renderer.ts +142 -0
  97. package/packages/code-generation/src/templates/registry.ts +174 -0
  98. package/packages/code-generation/src/types.ts +373 -0
  99. package/packages/code-review/src/engine.ts +408 -0
  100. package/packages/code-review/src/index.ts +46 -0
  101. package/packages/code-review/src/reports/html.ts +143 -0
  102. package/packages/code-review/src/reports/markdown.ts +197 -0
  103. package/packages/code-review/src/reports/text.ts +171 -0
  104. package/packages/code-review/src/types.ts +324 -0
  105. package/packages/codex-adapter/src/executor.ts +83 -0
  106. package/packages/codex-adapter/src/index.ts +16 -0
  107. package/packages/codex-adapter/src/provider.ts +213 -0
  108. package/packages/codex-adapter/src/types.ts +118 -0
  109. package/packages/config-capture/src/index.ts +357 -0
  110. package/packages/context-compiler/src/budget.ts +122 -0
  111. package/packages/context-compiler/src/cache.ts +134 -0
  112. package/packages/context-compiler/src/compiler.ts +314 -0
  113. package/packages/context-compiler/src/deduplicate.ts +171 -0
  114. package/packages/context-compiler/src/filter.ts +135 -0
  115. package/packages/context-compiler/src/index.ts +61 -0
  116. package/packages/context-compiler/src/okf-loader.ts +86 -0
  117. package/packages/context-compiler/src/score.ts +130 -0
  118. package/packages/context-compiler/src/types.ts +246 -0
  119. package/packages/context-discovery/dist/src/discover.d.ts +3 -0
  120. package/packages/context-discovery/dist/src/discover.js +42 -0
  121. package/packages/context-discovery/dist/src/discovery.d.ts +28 -0
  122. package/packages/context-discovery/dist/src/discovery.js +21 -0
  123. package/packages/context-discovery/dist/src/index.d.ts +3 -0
  124. package/packages/context-discovery/dist/src/index.js +2 -0
  125. package/packages/context-discovery/dist/src/types.d.ts +16 -0
  126. package/packages/context-discovery/dist/src/types.js +2 -0
  127. package/packages/context-discovery/src/discover.ts +42 -0
  128. package/packages/context-discovery/src/discovery.ts +44 -0
  129. package/packages/context-discovery/src/index.ts +2 -0
  130. package/packages/context-discovery/src/types.ts +15 -0
  131. package/packages/context-manager/src/compaction.ts +139 -0
  132. package/packages/context-manager/src/core.ts +85 -0
  133. package/packages/context-manager/src/index.ts +22 -0
  134. package/packages/context-manager/src/types.ts +44 -0
  135. package/packages/cookie-sanitizer/src/atomic-write.ts +79 -0
  136. package/packages/cookie-sanitizer/src/detect-format.ts +102 -0
  137. package/packages/cookie-sanitizer/src/index.ts +89 -0
  138. package/packages/cookie-sanitizer/src/infer-provider.ts +103 -0
  139. package/packages/cookie-sanitizer/src/normalize.ts +92 -0
  140. package/packages/cookie-sanitizer/src/parse-json.ts +122 -0
  141. package/packages/cookie-sanitizer/src/parse-netscape.ts +118 -0
  142. package/packages/cookie-sanitizer/src/sync.ts +312 -0
  143. package/packages/cookie-sanitizer/src/types.ts +101 -0
  144. package/packages/cookie-sanitizer/src/watcher.ts +180 -0
  145. package/packages/cost-optimizer/src/budget.ts +138 -0
  146. package/packages/cost-optimizer/src/config.ts +34 -0
  147. package/packages/cost-optimizer/src/forecast.ts +59 -0
  148. package/packages/cost-optimizer/src/index.ts +74 -0
  149. package/packages/cost-optimizer/src/optimizer.ts +277 -0
  150. package/packages/cost-optimizer/src/selection.ts +264 -0
  151. package/packages/cost-optimizer/src/tracker.ts +122 -0
  152. package/packages/cost-optimizer/src/types.ts +134 -0
  153. package/packages/dependency-analyzer/dist/src/analyzer.d.ts +17 -0
  154. package/packages/dependency-analyzer/dist/src/analyzer.js +119 -0
  155. package/packages/dependency-analyzer/dist/src/imports.d.ts +12 -0
  156. package/packages/dependency-analyzer/dist/src/imports.js +73 -0
  157. package/packages/dependency-analyzer/dist/src/index.d.ts +4 -0
  158. package/packages/dependency-analyzer/dist/src/index.js +3 -0
  159. package/packages/dependency-analyzer/dist/src/types.d.ts +28 -0
  160. package/packages/dependency-analyzer/dist/src/types.js +5 -0
  161. package/packages/dependency-analyzer/src/analyzer.ts +140 -0
  162. package/packages/dependency-analyzer/src/imports.ts +93 -0
  163. package/packages/dependency-analyzer/src/index.ts +9 -0
  164. package/packages/dependency-analyzer/src/types.ts +38 -0
  165. package/packages/django-plugin/src/analyzer.ts +284 -0
  166. package/packages/django-plugin/src/index.ts +39 -0
  167. package/packages/django-plugin/src/types.ts +35 -0
  168. package/packages/doc-generator/src/detector.ts +113 -0
  169. package/packages/doc-generator/src/docs.ts +158 -0
  170. package/packages/doc-generator/src/index.ts +7 -0
  171. package/packages/doc-generator/src/types.ts +58 -0
  172. package/packages/evaluation-engine/src/engine.ts +488 -0
  173. package/packages/evaluation-engine/src/index.ts +23 -0
  174. package/packages/evaluation-engine/src/types.ts +136 -0
  175. package/packages/evaluation-runner/src/index.ts +6 -0
  176. package/packages/evaluation-runner/src/runner.ts +182 -0
  177. package/packages/evaluation-runner/src/types.ts +51 -0
  178. package/packages/event-bus/dist/src/bus.d.ts +15 -0
  179. package/packages/event-bus/dist/src/bus.js +98 -0
  180. package/packages/event-bus/dist/src/herdr-bus.d.ts +121 -0
  181. package/packages/event-bus/dist/src/herdr-bus.js +322 -0
  182. package/packages/event-bus/dist/src/index.d.ts +6 -0
  183. package/packages/event-bus/dist/src/index.js +4 -0
  184. package/packages/event-bus/dist/src/types.d.ts +27 -0
  185. package/packages/event-bus/dist/src/types.js +10 -0
  186. package/packages/event-bus/src/bus.ts +111 -0
  187. package/packages/event-bus/src/herdr-bus.ts +525 -0
  188. package/packages/event-bus/src/index.ts +38 -0
  189. package/packages/event-bus/src/types.ts +59 -0
  190. package/packages/event-store/dist/src/index.d.ts +3 -0
  191. package/packages/event-store/dist/src/index.js +2 -0
  192. package/packages/event-store/dist/src/store.d.ts +15 -0
  193. package/packages/event-store/dist/src/store.js +139 -0
  194. package/packages/event-store/dist/src/types.d.ts +48 -0
  195. package/packages/event-store/dist/src/types.js +5 -0
  196. package/packages/event-store/src/index.ts +11 -0
  197. package/packages/event-store/src/store.ts +168 -0
  198. package/packages/event-store/src/types.d.ts +48 -0
  199. package/packages/event-store/src/types.js +5 -0
  200. package/packages/event-store/src/types.ts +65 -0
  201. package/packages/experience-replay/src/index.ts +19 -0
  202. package/packages/experience-replay/src/replay.ts +348 -0
  203. package/packages/experience-replay/src/types.ts +128 -0
  204. package/packages/feedback-collector/src/collector.ts +160 -0
  205. package/packages/feedback-collector/src/index.ts +6 -0
  206. package/packages/feedback-collector/src/types.ts +51 -0
  207. package/packages/framework-detector/src/detector.ts +586 -0
  208. package/packages/framework-detector/src/index.ts +46 -0
  209. package/packages/framework-detector/src/signatures/registry.ts +648 -0
  210. package/packages/framework-detector/src/types.ts +299 -0
  211. package/packages/framework-plugin-sdk/src/index.ts +45 -0
  212. package/packages/framework-plugin-sdk/src/manager.ts +525 -0
  213. package/packages/framework-plugin-sdk/src/types.ts +449 -0
  214. package/packages/frappe-plugin/src/analyzer.ts +454 -0
  215. package/packages/frappe-plugin/src/index.ts +72 -0
  216. package/packages/frappe-plugin/src/types.ts +135 -0
  217. package/packages/generic-web-plugin/src/analyzer.ts +347 -0
  218. package/packages/generic-web-plugin/src/index.ts +61 -0
  219. package/packages/generic-web-plugin/src/types.ts +41 -0
  220. package/packages/health-monitor/src/index.ts +16 -0
  221. package/packages/health-monitor/src/monitor.ts +216 -0
  222. package/packages/health-monitor/src/types.ts +45 -0
  223. package/packages/intent-analyzer/dist/src/analyzer.d.ts +13 -0
  224. package/packages/intent-analyzer/dist/src/analyzer.js +239 -0
  225. package/packages/intent-analyzer/dist/src/index.d.ts +3 -0
  226. package/packages/intent-analyzer/dist/src/index.js +2 -0
  227. package/packages/intent-analyzer/dist/src/types.d.ts +26 -0
  228. package/packages/intent-analyzer/dist/src/types.js +7 -0
  229. package/packages/intent-analyzer/src/analyzer.ts +259 -0
  230. package/packages/intent-analyzer/src/index.ts +8 -0
  231. package/packages/intent-analyzer/src/types.ts +44 -0
  232. package/packages/knowledge-retrieval/src/index.ts +18 -0
  233. package/packages/knowledge-retrieval/src/mcp-client.ts +212 -0
  234. package/packages/knowledge-retrieval/src/types.ts +112 -0
  235. package/packages/laravel-plugin/src/analyzer.ts +323 -0
  236. package/packages/laravel-plugin/src/index.ts +40 -0
  237. package/packages/laravel-plugin/src/types.ts +24 -0
  238. package/packages/learning-engine/src/engine.ts +391 -0
  239. package/packages/learning-engine/src/index.ts +26 -0
  240. package/packages/learning-engine/src/types.ts +201 -0
  241. package/packages/mcp-adapter/src/index.ts +20 -0
  242. package/packages/mcp-adapter/src/server.ts +273 -0
  243. package/packages/mcp-adapter/src/tools.ts +220 -0
  244. package/packages/mcp-adapter/src/types.ts +79 -0
  245. package/packages/memory-engine/src/engine.ts +615 -0
  246. package/packages/memory-engine/src/index.ts +20 -0
  247. package/packages/memory-engine/src/types.ts +159 -0
  248. package/packages/model-registry/src/cost.ts +80 -0
  249. package/packages/model-registry/src/defaults.ts +178 -0
  250. package/packages/model-registry/src/index.ts +57 -0
  251. package/packages/model-registry/src/query.ts +85 -0
  252. package/packages/model-registry/src/registry.ts +188 -0
  253. package/packages/model-registry/src/types.d.ts +63 -0
  254. package/packages/model-registry/src/types.js +5 -0
  255. package/packages/model-registry/src/types.ts +69 -0
  256. package/packages/nextjs-plugin/src/analyzer.ts +247 -0
  257. package/packages/nextjs-plugin/src/index.ts +41 -0
  258. package/packages/nextjs-plugin/src/types.ts +36 -0
  259. package/packages/notification/src/adapters/email-adapter.ts +126 -0
  260. package/packages/notification/src/adapters/ntfy-adapter.ts +100 -0
  261. package/packages/notification/src/adapters/telegram-adapter.ts +107 -0
  262. package/packages/notification/src/adapters/webhook-adapter.ts +75 -0
  263. package/packages/notification/src/base-adapter.ts +75 -0
  264. package/packages/notification/src/index.ts +9 -0
  265. package/packages/notification/src/notification-center.ts +286 -0
  266. package/packages/notification/src/types.ts +89 -0
  267. package/packages/observability/src/alerts.ts +355 -0
  268. package/packages/observability/src/health.ts +325 -0
  269. package/packages/observability/src/index.ts +79 -0
  270. package/packages/observability/src/logger.ts +373 -0
  271. package/packages/observability/src/metrics.ts +475 -0
  272. package/packages/observability/src/tracer.ts +336 -0
  273. package/packages/observability/src/types.ts +391 -0
  274. package/packages/okf-indexer/src/cli.ts +25 -0
  275. package/packages/okf-indexer/src/indexer.ts +186 -0
  276. package/packages/performance-optimizer/src/index.ts +20 -0
  277. package/packages/performance-optimizer/src/optimizer.ts +428 -0
  278. package/packages/performance-optimizer/src/types.ts +112 -0
  279. package/packages/privilege-broker/src/approval.ts +70 -0
  280. package/packages/privilege-broker/src/audit.ts +142 -0
  281. package/packages/privilege-broker/src/executor.ts +110 -0
  282. package/packages/privilege-broker/src/index.ts +46 -0
  283. package/packages/privilege-broker/src/registry.ts +98 -0
  284. package/packages/privilege-broker/src/types.ts +105 -0
  285. package/packages/project-analyzer/src/analyzer.ts +683 -0
  286. package/packages/project-analyzer/src/cache.ts +329 -0
  287. package/packages/project-analyzer/src/command-discovery.ts +239 -0
  288. package/packages/project-analyzer/src/index.ts +123 -0
  289. package/packages/project-analyzer/src/plugins/index.ts +16 -0
  290. package/packages/project-analyzer/src/rule-discovery.ts +282 -0
  291. package/packages/project-analyzer/src/signals.ts +355 -0
  292. package/packages/project-analyzer/src/types.ts +412 -0
  293. package/packages/project-analyzer/src/walker.ts +366 -0
  294. package/packages/projection-engine/dist/src/engine.d.ts +61 -0
  295. package/packages/projection-engine/dist/src/engine.js +87 -0
  296. package/packages/projection-engine/dist/src/index.d.ts +2 -0
  297. package/packages/projection-engine/dist/src/index.js +2 -0
  298. package/packages/projection-engine/dist/src/project.d.ts +3 -0
  299. package/packages/projection-engine/dist/src/project.js +24 -0
  300. package/packages/projection-engine/dist/src/types.d.ts +55 -0
  301. package/packages/projection-engine/dist/src/types.js +5 -0
  302. package/packages/projection-engine/src/engine.ts +134 -0
  303. package/packages/projection-engine/src/index.ts +8 -0
  304. package/packages/projection-engine/src/project.ts +24 -0
  305. package/packages/projection-engine/src/types.d.ts +55 -0
  306. package/packages/projection-engine/src/types.js +5 -0
  307. package/packages/projection-engine/src/types.ts +60 -0
  308. package/packages/prompt-compiler/src/budget.ts +170 -0
  309. package/packages/prompt-compiler/src/compiler.ts +188 -0
  310. package/packages/prompt-compiler/src/deduplicate.ts +84 -0
  311. package/packages/prompt-compiler/src/index.ts +50 -0
  312. package/packages/prompt-compiler/src/normalize.ts +140 -0
  313. package/packages/prompt-compiler/src/render.ts +105 -0
  314. package/packages/prompt-compiler/src/section-builder.ts +279 -0
  315. package/packages/prompt-compiler/src/types.ts +263 -0
  316. package/packages/prompt-compiler/src/validate.ts +157 -0
  317. package/packages/prompt-versioning/src/index.ts +6 -0
  318. package/packages/prompt-versioning/src/types.ts +41 -0
  319. package/packages/prompt-versioning/src/versioning.ts +149 -0
  320. package/packages/provider-adapter-sdk/dist/src/builder.d.ts +140 -0
  321. package/packages/provider-adapter-sdk/dist/src/builder.js +332 -0
  322. package/packages/provider-adapter-sdk/dist/src/errors.d.ts +71 -0
  323. package/packages/provider-adapter-sdk/dist/src/errors.js +111 -0
  324. package/packages/provider-adapter-sdk/dist/src/index.d.ts +15 -0
  325. package/packages/provider-adapter-sdk/dist/src/index.js +19 -0
  326. package/packages/provider-adapter-sdk/dist/src/registry.d.ts +108 -0
  327. package/packages/provider-adapter-sdk/dist/src/registry.js +301 -0
  328. package/packages/provider-adapter-sdk/dist/src/tester.d.ts +71 -0
  329. package/packages/provider-adapter-sdk/dist/src/tester.js +392 -0
  330. package/packages/provider-adapter-sdk/dist/src/types.d.ts +182 -0
  331. package/packages/provider-adapter-sdk/dist/src/types.js +11 -0
  332. package/packages/provider-adapter-sdk/src/builder.ts +442 -0
  333. package/packages/provider-adapter-sdk/src/errors.ts +153 -0
  334. package/packages/provider-adapter-sdk/src/index.ts +84 -0
  335. package/packages/provider-adapter-sdk/src/registry.ts +486 -0
  336. package/packages/provider-adapter-sdk/src/tester.ts +483 -0
  337. package/packages/provider-adapter-sdk/src/types.ts +293 -0
  338. package/packages/provider-router/dist/capability-registry/src/types.d.ts +47 -0
  339. package/packages/provider-router/dist/capability-registry/src/types.js +10 -0
  340. package/packages/provider-router/dist/provider-router/src/index.d.ts +23 -0
  341. package/packages/provider-router/dist/provider-router/src/index.js +25 -0
  342. package/packages/provider-router/dist/provider-router/src/policy.d.ts +10 -0
  343. package/packages/provider-router/dist/provider-router/src/policy.js +45 -0
  344. package/packages/provider-router/dist/provider-router/src/provider-router.d.ts +56 -0
  345. package/packages/provider-router/dist/provider-router/src/provider-router.js +222 -0
  346. package/packages/provider-router/dist/provider-router/src/strategies.d.ts +19 -0
  347. package/packages/provider-router/dist/provider-router/src/strategies.js +110 -0
  348. package/packages/provider-router/dist/provider-router/src/types.d.ts +91 -0
  349. package/packages/provider-router/dist/provider-router/src/types.js +10 -0
  350. package/packages/provider-router/dist/src/index.d.ts +23 -0
  351. package/packages/provider-router/dist/src/index.js +25 -0
  352. package/packages/provider-router/dist/src/policy.d.ts +10 -0
  353. package/packages/provider-router/dist/src/policy.js +45 -0
  354. package/packages/provider-router/dist/src/provider-router.d.ts +56 -0
  355. package/packages/provider-router/dist/src/provider-router.js +222 -0
  356. package/packages/provider-router/dist/src/strategies.d.ts +19 -0
  357. package/packages/provider-router/dist/src/strategies.js +110 -0
  358. package/packages/provider-router/dist/src/types.d.ts +91 -0
  359. package/packages/provider-router/dist/src/types.js +10 -0
  360. package/packages/provider-router/dist/types/src/runtime-types.d.ts +412 -0
  361. package/packages/provider-router/dist/types/src/runtime-types.js +2 -0
  362. package/packages/provider-router/src/index.ts +49 -0
  363. package/packages/provider-router/src/policy.ts +50 -0
  364. package/packages/provider-router/src/provider-router.ts +315 -0
  365. package/packages/provider-router/src/strategies.ts +158 -0
  366. package/packages/provider-router/src/types.ts +130 -0
  367. package/packages/provider-selector/src/index.ts +13 -0
  368. package/packages/provider-selector/src/selector.ts +120 -0
  369. package/packages/provider-selector/src/types.ts +33 -0
  370. package/packages/providers/dist/src/adapters.d.ts +133 -0
  371. package/packages/providers/dist/src/adapters.js +236 -0
  372. package/packages/providers/dist/src/deepagents-adapter.d.ts +78 -0
  373. package/packages/providers/dist/src/deepagents-adapter.js +323 -0
  374. package/packages/providers/dist/src/glm-usage.d.ts +102 -0
  375. package/packages/providers/dist/src/glm-usage.js +197 -0
  376. package/packages/providers/dist/src/index.d.ts +11 -0
  377. package/packages/providers/dist/src/index.js +11 -0
  378. package/packages/providers/dist/src/openai-usage.d.ts +103 -0
  379. package/packages/providers/dist/src/openai-usage.js +208 -0
  380. package/packages/providers/dist/src/provider-id.d.ts +46 -0
  381. package/packages/providers/dist/src/provider-id.js +113 -0
  382. package/packages/providers/src/adapters.ts +362 -0
  383. package/packages/providers/src/deepagents-adapter.ts +458 -0
  384. package/packages/providers/src/glm-usage.ts +248 -0
  385. package/packages/providers/src/index.ts +11 -0
  386. package/packages/providers/src/openai-usage.ts +263 -0
  387. package/packages/providers/src/provider-id.ts +129 -0
  388. package/packages/quota-manager/dist/src/examples/tui-usage-integration.d.ts +35 -0
  389. package/packages/quota-manager/dist/src/examples/tui-usage-integration.js +73 -0
  390. package/packages/quota-manager/dist/src/index.d.ts +8 -0
  391. package/packages/quota-manager/dist/src/index.js +8 -0
  392. package/packages/quota-manager/dist/src/quota-manager.d.ts +70 -0
  393. package/packages/quota-manager/dist/src/quota-manager.js +260 -0
  394. package/packages/quota-manager/dist/src/tui-usage-monitor.d.ts +96 -0
  395. package/packages/quota-manager/dist/src/tui-usage-monitor.js +268 -0
  396. package/packages/quota-manager/src/examples/tui-usage-integration.ts +72 -0
  397. package/packages/quota-manager/src/index.ts +8 -0
  398. package/packages/quota-manager/src/quota-manager.ts +336 -0
  399. package/packages/quota-manager/src/tui-usage-monitor.ts +355 -0
  400. package/packages/rate-limiter/src/index.ts +6 -0
  401. package/packages/rate-limiter/src/limiter.ts +122 -0
  402. package/packages/rate-limiter/src/types.ts +41 -0
  403. package/packages/react-vite-plugin/src/analyzer.ts +226 -0
  404. package/packages/react-vite-plugin/src/index.ts +39 -0
  405. package/packages/react-vite-plugin/src/types.ts +28 -0
  406. package/packages/release-manager/src/changelog.ts +148 -0
  407. package/packages/release-manager/src/index.ts +21 -0
  408. package/packages/release-manager/src/types.ts +50 -0
  409. package/packages/release-manager/src/version.ts +52 -0
  410. package/packages/requirement-compiler/src/ambiguity-detector.ts +302 -0
  411. package/packages/requirement-compiler/src/classifier.ts +145 -0
  412. package/packages/requirement-compiler/src/compiler.ts +328 -0
  413. package/packages/requirement-compiler/src/extractor.ts +155 -0
  414. package/packages/requirement-compiler/src/index.ts +36 -0
  415. package/packages/requirement-compiler/src/normalizer.ts +161 -0
  416. package/packages/requirement-compiler/src/risk-detector.ts +58 -0
  417. package/packages/requirement-compiler/src/types.ts +596 -0
  418. package/packages/runtime/dist/src/command-executor.d.ts +129 -0
  419. package/packages/runtime/dist/src/command-executor.js +383 -0
  420. package/packages/runtime/dist/src/index.d.ts +11 -0
  421. package/packages/runtime/dist/src/index.js +11 -0
  422. package/packages/runtime/dist/src/local-runtime-agent.d.ts +111 -0
  423. package/packages/runtime/dist/src/local-runtime-agent.js +356 -0
  424. package/packages/runtime/dist/src/policy-engine.d.ts +203 -0
  425. package/packages/runtime/dist/src/policy-engine.js +592 -0
  426. package/packages/runtime/dist/src/runtime-api.d.ts +137 -0
  427. package/packages/runtime/dist/src/runtime-api.js +454 -0
  428. package/packages/runtime/dist/src/workspace-manager.d.ts +162 -0
  429. package/packages/runtime/dist/src/workspace-manager.js +451 -0
  430. package/packages/runtime/src/command-executor.ts +523 -0
  431. package/packages/runtime/src/index.ts +11 -0
  432. package/packages/runtime/src/local-runtime-agent.ts +480 -0
  433. package/packages/runtime/src/policy-engine.ts +813 -0
  434. package/packages/runtime/src/runtime-api.ts +665 -0
  435. package/packages/runtime/src/workspace-manager.ts +591 -0
  436. package/packages/scheduler/src/scheduler.ts +50 -0
  437. package/packages/scheduler-adapter/src/cron.ts +123 -0
  438. package/packages/scheduler-adapter/src/index.ts +9 -0
  439. package/packages/scheduler-adapter/src/interface.ts +61 -0
  440. package/packages/scheduler-adapter/src/internal.ts +99 -0
  441. package/packages/scheduler-adapter/src/systemd.ts +221 -0
  442. package/packages/session/src/history.ts +353 -0
  443. package/packages/session/src/index.ts +53 -0
  444. package/packages/session/src/manager.ts +481 -0
  445. package/packages/session/src/policy.ts +363 -0
  446. package/packages/session/src/store.ts +348 -0
  447. package/packages/session/src/types.ts +275 -0
  448. package/packages/session-api/dist/src/api.d.ts +83 -0
  449. package/packages/session-api/dist/src/api.js +49 -0
  450. package/packages/session-api/dist/src/index.d.ts +2 -0
  451. package/packages/session-api/dist/src/index.js +2 -0
  452. package/packages/session-api/dist/src/types.d.ts +22 -0
  453. package/packages/session-api/dist/src/types.js +5 -0
  454. package/packages/session-api/src/api.ts +117 -0
  455. package/packages/session-api/src/index.ts +1 -0
  456. package/packages/session-api/src/types.ts +23 -0
  457. package/packages/session-export/dist/src/exporter.d.ts +28 -0
  458. package/packages/session-export/dist/src/exporter.js +42 -0
  459. package/packages/session-export/dist/src/index.d.ts +2 -0
  460. package/packages/session-export/dist/src/index.js +2 -0
  461. package/packages/session-export/dist/src/types.d.ts +20 -0
  462. package/packages/session-export/dist/src/types.js +5 -0
  463. package/packages/session-export/src/exporter.ts +81 -0
  464. package/packages/session-export/src/index.ts +1 -0
  465. package/packages/session-export/src/types.ts +22 -0
  466. package/packages/shared-context/src/index.ts +7 -0
  467. package/packages/shared-context/src/shared-context.ts +42 -0
  468. package/packages/skill-registry/src/defaults.ts +146 -0
  469. package/packages/skill-registry/src/index.ts +48 -0
  470. package/packages/skill-registry/src/matching.ts +118 -0
  471. package/packages/skill-registry/src/registry.ts +211 -0
  472. package/packages/skill-registry/src/types.ts +97 -0
  473. package/packages/sprint-planner/src/decomposer.ts +57 -0
  474. package/packages/sprint-planner/src/index.ts +16 -0
  475. package/packages/sprint-planner/src/planner.ts +150 -0
  476. package/packages/sprint-planner/src/types.ts +59 -0
  477. package/packages/subscription-engine/dist/src/engine.d.ts +13 -0
  478. package/packages/subscription-engine/dist/src/engine.js +40 -0
  479. package/packages/subscription-engine/dist/src/index.d.ts +2 -0
  480. package/packages/subscription-engine/dist/src/index.js +2 -0
  481. package/packages/subscription-engine/dist/src/subscriptions.d.ts +19 -0
  482. package/packages/subscription-engine/dist/src/subscriptions.js +39 -0
  483. package/packages/subscription-engine/dist/src/types.d.ts +24 -0
  484. package/packages/subscription-engine/dist/src/types.js +5 -0
  485. package/packages/subscription-engine/src/engine.ts +55 -0
  486. package/packages/subscription-engine/src/index.ts +6 -0
  487. package/packages/subscription-engine/src/subscriptions.ts +55 -0
  488. package/packages/subscription-engine/src/types.ts +27 -0
  489. package/packages/task-compiler/src/command-policy.ts +193 -0
  490. package/packages/task-compiler/src/compiler.ts +114 -0
  491. package/packages/task-compiler/src/decompose.ts +265 -0
  492. package/packages/task-compiler/src/file-scope.ts +240 -0
  493. package/packages/task-compiler/src/graph.ts +144 -0
  494. package/packages/task-compiler/src/index.ts +38 -0
  495. package/packages/task-compiler/src/types.ts +225 -0
  496. package/packages/task-compiler/src/validate.ts +218 -0
  497. package/packages/task-compiler/src/verification.ts +248 -0
  498. package/packages/tencentdb-memory/src/client.ts +130 -0
  499. package/packages/tencentdb-memory/src/index.ts +32 -0
  500. package/packages/tencentdb-memory/src/loader.ts +150 -0
  501. package/packages/tencentdb-memory/src/mcp-tools.ts +213 -0
  502. package/packages/tencentdb-memory/src/types.ts +101 -0
  503. package/packages/tencentdb-sync/src/cli.ts +363 -0
  504. package/packages/tencentdb-sync/src/client.ts +268 -0
  505. package/packages/tencentdb-sync/src/config.ts +139 -0
  506. package/packages/tencentdb-sync/src/index.ts +15 -0
  507. package/packages/test-data-generator/src/faker-adapter.ts +657 -0
  508. package/packages/test-data-generator/src/generator.ts +461 -0
  509. package/packages/test-data-generator/src/index.ts +48 -0
  510. package/packages/test-data-generator/src/types.ts +421 -0
  511. package/packages/test-generator/src/generator.ts +144 -0
  512. package/packages/test-generator/src/index.ts +11 -0
  513. package/packages/test-generator/src/types.ts +39 -0
  514. package/packages/todo-bd-sync/src/detector.ts +171 -0
  515. package/packages/todo-bd-sync/src/extension.ts +129 -0
  516. package/packages/todo-bd-sync/src/index.ts +401 -0
  517. package/packages/todo-bd-sync/src/sync.ts +322 -0
  518. package/packages/todo-bd-sync/src/task-analyzer.ts +314 -0
  519. package/packages/todo-bd-sync/src/todo-reminder.ts +418 -0
  520. package/packages/todo-bd-sync/src/types.ts +137 -0
  521. package/packages/token-estimation/src/index.ts +192 -0
  522. package/packages/token-optimizer/src/index.ts +15 -0
  523. package/packages/token-optimizer/src/optimizer.ts +150 -0
  524. package/packages/token-optimizer/src/types.ts +47 -0
  525. package/packages/types/src/agent-worker-types.d.ts +206 -0
  526. package/packages/types/src/agent-worker-types.js +41 -0
  527. package/packages/types/src/agent-worker-types.ts +264 -0
  528. package/packages/types/src/ai-providers.d.ts +36 -0
  529. package/packages/types/src/ai-providers.js +66 -0
  530. package/packages/types/src/ai-providers.ts +73 -0
  531. package/packages/types/src/runtime-types.d.ts +418 -0
  532. package/packages/types/src/runtime-types.js +3 -0
  533. package/packages/types/src/runtime-types.ts +588 -0
  534. package/packages/workflow-events/dist/src/events.d.ts +38 -0
  535. package/packages/workflow-events/dist/src/events.js +55 -0
  536. package/packages/workflow-events/dist/src/index.d.ts +2 -0
  537. package/packages/workflow-events/dist/src/index.js +2 -0
  538. package/packages/workflow-events/dist/src/pipeline.d.ts +21 -0
  539. package/packages/workflow-events/dist/src/pipeline.js +36 -0
  540. package/packages/workflow-events/dist/src/types.d.ts +110 -0
  541. package/packages/workflow-events/dist/src/types.js +5 -0
  542. package/packages/workflow-events/src/events.ts +86 -0
  543. package/packages/workflow-events/src/index.ts +19 -0
  544. package/packages/workflow-events/src/pipeline.ts +41 -0
  545. package/packages/workflow-events/src/types.d.ts +110 -0
  546. package/packages/workflow-events/src/types.js +5 -0
  547. package/packages/workflow-events/src/types.ts +139 -0
  548. package/packages/workspace-scanner/dist/src/detect.d.ts +3 -0
  549. package/packages/workspace-scanner/dist/src/detect.js +60 -0
  550. package/packages/workspace-scanner/dist/src/git.d.ts +7 -0
  551. package/packages/workspace-scanner/dist/src/git.js +75 -0
  552. package/packages/workspace-scanner/dist/src/index.d.ts +5 -0
  553. package/packages/workspace-scanner/dist/src/index.js +4 -0
  554. package/packages/workspace-scanner/dist/src/scanner.d.ts +11 -0
  555. package/packages/workspace-scanner/dist/src/scanner.js +59 -0
  556. package/packages/workspace-scanner/dist/src/types.d.ts +35 -0
  557. package/packages/workspace-scanner/dist/src/types.js +5 -0
  558. package/packages/workspace-scanner/src/detect.ts +77 -0
  559. package/packages/workspace-scanner/src/git.ts +83 -0
  560. package/packages/workspace-scanner/src/index.ts +9 -0
  561. package/packages/workspace-scanner/src/scanner.ts +73 -0
  562. package/packages/workspace-scanner/src/types.ts +48 -0
  563. package/packages/worktree/dist/src/index.d.ts +7 -0
  564. package/packages/worktree/dist/src/index.js +7 -0
  565. package/packages/worktree/dist/src/worktree.d.ts +88 -0
  566. package/packages/worktree/dist/src/worktree.js +239 -0
  567. package/packages/worktree/src/index.ts +7 -0
  568. package/packages/worktree/src/worktree.ts +290 -0
  569. package/packages/write-review/src/blackboard.ts +249 -0
  570. package/packages/write-review/src/gate.ts +169 -0
  571. package/packages/write-review/src/index.ts +18 -0
  572. package/packages/write-review/src/injection.ts +170 -0
  573. package/packages/write-review/src/review.ts +206 -0
  574. package/packages/write-review/src/trigger.ts +133 -0
  575. package/packages/write-review/src/types.ts +90 -0
  576. package/proactive-compact.ts +90 -0
  577. package/prompts/tencentdb-connect.md +35 -0
  578. package/prompts/tencentdb-setup.md +101 -0
  579. package/prompts/tencentdb.md +88 -0
  580. package/renderer.ts +205 -0
  581. package/skills/harness-runtime/SKILL.md +237 -0
  582. package/status-parsers.ts +84 -0
  583. package/tracker.ts +72 -0
  584. package/windows.ts +121 -0
@@ -0,0 +1,357 @@
1
+ /**
2
+ * Config Capture Extension
3
+ *
4
+ * Automatically detects API responses containing constant configuration values
5
+ * (DNS records, routes, feature flags, etc.) and logs a suggestion to document
6
+ * them to AGENTS.md.
7
+ *
8
+ * Pattern: Like todo-bd-sync, this listens to tool execution end events
9
+ * and logs when constant config is detected. The agent decides whether to
10
+ * document based on context.
11
+ *
12
+ * Usage:
13
+ * import { registerConfigCapture } from "@moocoding/config-capture";
14
+ * registerConfigCapture(pi);
15
+ */
16
+
17
+ // ─── Types ────────────────────────────────────────────────────────────────────
18
+
19
+ export type ConfigType =
20
+ | "dns_records"
21
+ | "routes"
22
+ | "feature_flags"
23
+ | "environment_config"
24
+ | "integration_ids"
25
+ | "webhook_urls"
26
+ | "redirect_rules"
27
+ | "unknown";
28
+
29
+ export interface ConfigDetection {
30
+ detected: boolean;
31
+ configType: ConfigType | null;
32
+ confidence: "high" | "medium" | "low";
33
+ sampleData?: string;
34
+ }
35
+
36
+ // ─── Config Type Detection ────────────────────────────────────────────────────
37
+
38
+ const DNS_PATTERNS = [
39
+ "zone_id",
40
+ "zoneId",
41
+ "dns_record",
42
+ "dns-record",
43
+ "cloudflare",
44
+ "name_servers",
45
+ "@",
46
+ "ttl",
47
+ "proxied",
48
+ "record_type",
49
+ " a ",
50
+ "aaaa",
51
+ "cname",
52
+ "txt",
53
+ "mx",
54
+ "ns",
55
+ "spf",
56
+ ];
57
+
58
+ const ROUTE_PATTERNS = [
59
+ "routes",
60
+ "endpoints",
61
+ "api_routes",
62
+ "api_rout",
63
+ "path",
64
+ "method",
65
+ " get ",
66
+ " post ",
67
+ " put ",
68
+ " delete ",
69
+ " patch ",
70
+ "/api/",
71
+ "route_path",
72
+ ];
73
+
74
+ const FEATURE_FLAG_PATTERNS = [
75
+ "feature_flags",
76
+ "feature-flags",
77
+ "feature_toggle",
78
+ "feature-toggle",
79
+ "enabled",
80
+ "disabled",
81
+ "rollout",
82
+ "variants",
83
+ ];
84
+
85
+ const INTEGRATION_PATTERNS = [
86
+ "integration_id",
87
+ "integrationId",
88
+ "webhook_url",
89
+ "webhookUrl",
90
+ "webhook_id",
91
+ "redirect_url",
92
+ "account_id",
93
+ "project_id",
94
+ ];
95
+
96
+ // ─── Detection Logic ─────────────────────────────────────────────────────────
97
+
98
+ /**
99
+ * Detect if a tool result contains constant configuration data
100
+ */
101
+ export function detectConfig(result: unknown): ConfigDetection {
102
+ if (!result || typeof result !== "object") {
103
+ return { detected: false, configType: null, confidence: "low" };
104
+ }
105
+
106
+ const resultStr = JSON.stringify(result).toLowerCase();
107
+ const scores: { type: ConfigType; score: number }[] = [
108
+ { type: "dns_records", score: countMatches(resultStr, DNS_PATTERNS) },
109
+ { type: "routes", score: countMatches(resultStr, ROUTE_PATTERNS) },
110
+ { type: "feature_flags", score: countMatches(resultStr, FEATURE_FLAG_PATTERNS) },
111
+ { type: "integration_ids", score: countMatches(resultStr, INTEGRATION_PATTERNS) },
112
+ ];
113
+
114
+ // Sort by score descending
115
+ scores.sort((a, b) => b.score - a.score);
116
+
117
+ const best = scores[0];
118
+ if (best.score < 2) {
119
+ return { detected: false, configType: null, confidence: "low" };
120
+ }
121
+
122
+ // Check for array of objects (typical config structure)
123
+ const hasArrayOfObjects = detectArrayOfObjects(result);
124
+
125
+ let confidence: "high" | "medium" | "low" = "low";
126
+ if (best.score >= 4 || (best.score >= 2 && hasArrayOfObjects)) {
127
+ confidence = "high";
128
+ } else if (best.score >= 2) {
129
+ confidence = "medium";
130
+ }
131
+
132
+ // Extract sample data for logging
133
+ const sampleData = extractSampleData(result, best.type);
134
+
135
+ return {
136
+ detected: true,
137
+ configType: best.type,
138
+ confidence,
139
+ sampleData,
140
+ };
141
+ }
142
+
143
+ function countMatches(text: string, patterns: string[]): number {
144
+ return patterns.filter((p) => text.includes(p.toLowerCase())).length;
145
+ }
146
+
147
+ function detectArrayOfObjects(result: unknown): boolean {
148
+ if (Array.isArray(result)) {
149
+ return result.some((item) => typeof item === "object" && item !== null);
150
+ }
151
+ if (typeof result === "object" && result !== null) {
152
+ const values = Object.values(result);
153
+ return values.some((v) => Array.isArray(v) && v.length > 0 && typeof v[0] === "object");
154
+ }
155
+ return false;
156
+ }
157
+
158
+ function extractSampleData(result: unknown, _type: ConfigType): string | undefined {
159
+ if (!Array.isArray(result) || result.length === 0) return undefined;
160
+
161
+ const sample = result[0];
162
+ if (typeof sample !== "object" || sample === null) return undefined;
163
+
164
+ const entries = Object.entries(sample).slice(0, 5);
165
+ if (entries.length === 0) return undefined;
166
+
167
+ const lines = entries.map(([k, v]) => `${k}: ${JSON.stringify(v)}`);
168
+ return lines.join(", ");
169
+ }
170
+
171
+ // ─── Privacy Filter ────────────────────────────────────────────────────────────
172
+
173
+ const SENSITIVE_PATTERNS = [
174
+ "token",
175
+ "secret",
176
+ "password",
177
+ "key",
178
+ "credential",
179
+ "auth",
180
+ "api_key",
181
+ "apiKey",
182
+ "bearer",
183
+ "authorization",
184
+ "private_",
185
+ "private-",
186
+ ];
187
+
188
+ /**
189
+ * Check if a field name is sensitive (should not be documented)
190
+ */
191
+ export function isSensitiveField(fieldName: string): boolean {
192
+ const lower = fieldName.toLowerCase();
193
+ return SENSITIVE_PATTERNS.some((p) => lower.includes(p));
194
+ }
195
+
196
+ /**
197
+ * Remove sensitive fields from a config object
198
+ */
199
+ export function removeSensitiveFields<T extends object>(config: T): Partial<T> {
200
+ const sanitized: Record<string, unknown> = {};
201
+
202
+ for (const [key, value] of Object.entries(config)) {
203
+ if (!isSensitiveField(key)) {
204
+ sanitized[key] = value;
205
+ }
206
+ }
207
+
208
+ return sanitized as Partial<T>;
209
+ }
210
+
211
+ // ─── Format Output ────────────────────────────────────────────────────────────
212
+
213
+ export type OutputFormat = "markdown" | "json" | "brief";
214
+
215
+ /**
216
+ * Format detected config for AGENTS.md
217
+ */
218
+ export function formatForAgentsMd(
219
+ detection: ConfigDetection,
220
+ sampleData?: string,
221
+ ): string {
222
+ const lines: string[] = [];
223
+
224
+ switch (detection.configType) {
225
+ case "dns_records":
226
+ lines.push("### DNS Records");
227
+ lines.push("");
228
+ lines.push("| Name | Type | Content | Notes |");
229
+ lines.push("|------|------|---------|-------|");
230
+ lines.push("| ... | ... | ... | ... |");
231
+ lines.push("");
232
+ lines.push("*Source: Auto-captured from API*");
233
+ break;
234
+
235
+ case "routes":
236
+ lines.push("### API Routes");
237
+ lines.push("");
238
+ lines.push("- `GET /api/resource` - Description");
239
+ lines.push("- `POST /api/resource` - Create");
240
+ lines.push("");
241
+ lines.push("*Source: Auto-captured from API*");
242
+ break;
243
+
244
+ case "feature_flags":
245
+ lines.push("### Feature Flags");
246
+ lines.push("");
247
+ lines.push("| Flag | Enabled | Notes |");
248
+ lines.push("|------|---------|-------|");
249
+ lines.push("| flag_name | true/false | ... |");
250
+ lines.push("");
251
+ lines.push("*Source: Auto-captured from API*");
252
+ break;
253
+
254
+ default:
255
+ lines.push("### Configuration");
256
+ lines.push("");
257
+ if (sampleData) {
258
+ lines.push("```");
259
+ lines.push(sampleData);
260
+ lines.push("```");
261
+ }
262
+ lines.push("");
263
+ lines.push("*Source: Auto-captured from API*");
264
+ }
265
+
266
+ return lines.join("\n");
267
+ }
268
+
269
+ // ─── Extension Registration ────────────────────────────────────────────────────
270
+
271
+ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
272
+
273
+ // Type for tool_execution_end event
274
+ interface ToolExecutionEndEvent {
275
+ type: "tool_execution_end";
276
+ toolCallId: string;
277
+ toolName: string;
278
+ result: unknown;
279
+ isError: boolean;
280
+ }
281
+
282
+ interface ConfigCaptureConfig {
283
+ /** Enable debug logging */
284
+ debug?: boolean;
285
+ /** Minimum confidence to trigger capture */
286
+ minConfidence?: "high" | "medium" | "low";
287
+ }
288
+
289
+ const DEFAULT_CONFIG = {
290
+ debug: false,
291
+ minConfidence: "medium" as const,
292
+ };
293
+
294
+ /**
295
+ * Register the config-capture extension
296
+ */
297
+ export function registerConfigCapture(
298
+ pi: ExtensionAPI,
299
+ config: ConfigCaptureConfig = {},
300
+ ): void {
301
+ const cfg = { ...DEFAULT_CONFIG, ...config };
302
+
303
+ // Track if we've already suggested documenting this config in this session
304
+ const documentedConfigs = new Set<string>();
305
+
306
+ // Listen to tool execution end
307
+ pi.on("tool_execution_end", (event: ToolExecutionEndEvent) => {
308
+ // Skip errors
309
+ if (event.isError) return;
310
+
311
+ // Skip non-API tools (focus on bash/curl/http calls)
312
+ const apiTools = ["bash", "http_request", "fetch", "curl"];
313
+ if (!apiTools.includes(event.toolName)) return;
314
+
315
+ // Detect config in result
316
+ const detection = detectConfig(event.result);
317
+
318
+ if (!detection.detected) return;
319
+
320
+ // Check confidence threshold
321
+ const confidenceLevels = { low: 0, medium: 1, high: 2 };
322
+ const minLevel = confidenceLevels[cfg.minConfidence!];
323
+ const currentLevel = confidenceLevels[detection.confidence];
324
+
325
+ if (currentLevel < minLevel) return;
326
+
327
+ // Create a unique key for this config type + rough content hash
328
+ const contentStr = JSON.stringify(event.result).slice(0, 100);
329
+ const configKey = `${detection.configType}-${contentStr}`;
330
+
331
+ // Skip if already suggested in this session
332
+ if (documentedConfigs.has(configKey)) return;
333
+
334
+ // Log detection
335
+ if (cfg.debug) {
336
+ console.log(`[config-capture] Detected ${detection.configType} (${detection.confidence})`);
337
+ console.log(`[config-capture] Sample: ${detection.sampleData}`);
338
+ }
339
+
340
+ // Mark as documented
341
+ documentedConfigs.add(configKey);
342
+
343
+ // Log the suggestion - agent will notice this
344
+ console.log(`[config-capture] Config detected: ${detection.configType}`);
345
+ console.log(`[config-capture] Confidence: ${detection.confidence}`);
346
+ console.log(`[config-capture] Sample: ${detection.sampleData?.slice(0, 200)}`);
347
+
348
+ // Suggest action
349
+ const actionMsg = `[config-capture] Consider documenting this to AGENTS.md section "Discovered Configuration"`;
350
+ console.log(actionMsg);
351
+ });
352
+
353
+ console.log("[config-capture] Started - detecting API config responses");
354
+ }
355
+
356
+ // Default export
357
+ export default registerConfigCapture;
@@ -0,0 +1,122 @@
1
+ /**
2
+ * Context Compiler - Token Budget Fitting
3
+ *
4
+ * Fits optional candidates into the available token budget.
5
+ * Required candidates always fit first.
6
+ * Uses the RFC-0041 character-based estimation (1 token ≈ 4 characters).
7
+ */
8
+
9
+ import type {
10
+ CompiledContextItem,
11
+ ContextCandidate,
12
+ OmittedItem,
13
+ } from "./types.js";
14
+
15
+ /**
16
+ * Result of budget fitting.
17
+ */
18
+ export interface BudgetFitResult {
19
+ included: ContextCandidate[];
20
+ omitted: OmittedItem[];
21
+ estimatedTokens: number;
22
+ }
23
+
24
+ /**
25
+ * Estimate tokens from content using 4 chars/token approximation.
26
+ */
27
+ export function estimateTokens(content: string): number {
28
+ if (!content || content.trim() === "") return 0;
29
+ return Math.ceil(content.length / 4);
30
+ }
31
+
32
+ /**
33
+ * Fit candidates into the token budget.
34
+ *
35
+ * Algorithm:
36
+ * 1. Always include required candidates
37
+ * 2. Sort optional by score (descending)
38
+ * 3. Greedily add optional until budget exhausted
39
+ * 4. Record all omitted with reason "budget"
40
+ *
41
+ * @param candidates - Ranked candidates (highest score first)
42
+ * @param maximumTokens - Available budget
43
+ * @returns Candidates to include and items to omit
44
+ */
45
+ export function fitToBudget(
46
+ candidates: Array<{ candidate: ContextCandidate; score: number }>,
47
+ maximumTokens: number,
48
+ ): BudgetFitResult {
49
+ const included: ContextCandidate[] = [];
50
+ const omitted: OmittedItem[] = [];
51
+
52
+ let usedTokens = 0;
53
+
54
+ for (const { candidate } of candidates) {
55
+ const tokens = estimateTokens(candidate.content);
56
+
57
+ // Optional items with no content are omitted (broken/unavailable)
58
+ if (
59
+ !candidate.required &&
60
+ (!candidate.content || candidate.content.trim() === "")
61
+ ) {
62
+ omitted.push({
63
+ id: candidate.id,
64
+ kind: candidate.kind,
65
+ reason: "source_unavailable",
66
+ reasonDetail: "no content",
67
+ estimatedTokens: 0,
68
+ });
69
+ continue;
70
+ }
71
+
72
+ if (candidate.required) {
73
+ // Required: always include
74
+ included.push(candidate);
75
+ usedTokens += tokens;
76
+ continue;
77
+ }
78
+
79
+ // Optional: check budget
80
+ if (usedTokens + tokens <= maximumTokens) {
81
+ included.push(candidate);
82
+ usedTokens += tokens;
83
+ } else {
84
+ omitted.push({
85
+ id: candidate.id,
86
+ kind: candidate.kind,
87
+ reason: "budget",
88
+ reasonDetail: `estimated ${tokens} tokens, only ${maximumTokens - usedTokens} remaining`,
89
+ estimatedTokens: tokens,
90
+ });
91
+ }
92
+ }
93
+
94
+ return {
95
+ included,
96
+ omitted,
97
+ estimatedTokens: usedTokens,
98
+ };
99
+ }
100
+
101
+ /**
102
+ * Convert included candidates to compiled items.
103
+ */
104
+ export function toCompiledItems(
105
+ candidates: ContextCandidate[],
106
+ ): CompiledContextItem[] {
107
+ return candidates.map((c) => ({
108
+ id: c.id,
109
+ kind: c.kind,
110
+ content: c.content,
111
+ source: c.source,
112
+ priority: c.priority,
113
+ required: c.required,
114
+ trust: c.trust,
115
+ estimatedTokens: estimateTokens(c.content),
116
+ contentHash: c.contentHash,
117
+ filePath: c.filePath,
118
+ startLine: c.startLine,
119
+ endLine: c.endLine,
120
+ symbols: c.symbols,
121
+ }));
122
+ }
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Context Compiler - Cache & Invalidation
3
+ *
4
+ * Generates deterministic cache keys from selected source hashes.
5
+ * Tracks invalidation triggers.
6
+ */
7
+
8
+ import type {
9
+ CompiledContext,
10
+ CompiledContextItem,
11
+ ContextInvalidation,
12
+ } from "./types.js";
13
+
14
+ /**
15
+ * Generate a deterministic cache key from compiled context items.
16
+ * Includes source file hashes for content invalidation.
17
+ */
18
+ export function generateCacheKey(
19
+ taskId: string,
20
+ items: CompiledContextItem[],
21
+ taskObjective: string,
22
+ ): string {
23
+ // Sort by source path for determinism
24
+ const hashes = items
25
+ .filter((item) => item.contentHash)
26
+ .map((item) => `${item.source}:${item.contentHash}`)
27
+ .sort();
28
+
29
+ const objectiveHash = simpleHash(taskObjective);
30
+ const combined = `${taskId}:${objectiveHash}:${hashes.join(",")}`;
31
+
32
+ return `ctx:${simpleHash(combined)}`;
33
+ }
34
+
35
+ /**
36
+ * Check if a compiled context should be invalidated.
37
+ *
38
+ * Invalidation triggers:
39
+ * - A selected source file hash changed
40
+ * - A project rule changed
41
+ * - A required OKF concept changed
42
+ * - The task objective changed
43
+ * - A test failure superseded an old one
44
+ * - Worktree branch/HEAD changed
45
+ */
46
+ export function shouldInvalidate(
47
+ previous: CompiledContext,
48
+ invalidation: ContextInvalidation,
49
+ currentItemHashes: Map<string, string>,
50
+ ): boolean {
51
+ switch (invalidation.reason) {
52
+ case "source_hash_changed": {
53
+ const changed = invalidation.details?.sourcePath as string | undefined;
54
+ if (!changed) return true;
55
+ const item = previous.items.find((i) => i.source === changed);
56
+ if (!item) return false;
57
+ const currentHash = currentItemHashes.get(changed);
58
+ return currentHash !== item.contentHash;
59
+ }
60
+
61
+ case "project_rule_changed": {
62
+ const rulePath = invalidation.details?.rulePath as string | undefined;
63
+ const ruleItem = previous.items.find(
64
+ (i) =>
65
+ i.kind === "project_rule" &&
66
+ (i.source === rulePath || i.filePath === rulePath),
67
+ );
68
+ return ruleItem !== undefined;
69
+ }
70
+
71
+ case "required_okf_changed": {
72
+ const okfId = invalidation.details?.okfId as string | undefined;
73
+ return (
74
+ previous.items.find(
75
+ (i) => i.kind === "okf_concept" && i.id === okfId && i.required,
76
+ ) !== undefined
77
+ );
78
+ }
79
+
80
+ case "task_objective_changed": {
81
+ return true; // Always invalidate on objective change
82
+ }
83
+
84
+ case "test_failure_superseded": {
85
+ const oldFailure = invalidation.details?.oldFailureId as
86
+ | string
87
+ | undefined;
88
+ if (!oldFailure) return false;
89
+ const existingFailure = previous.items.find(
90
+ (i) => i.kind === "test_failure" && i.id === oldFailure,
91
+ );
92
+ return existingFailure !== undefined;
93
+ }
94
+
95
+ case "worktree_branch_changed": {
96
+ const oldBranch = invalidation.details?.oldBranch as string | undefined;
97
+ const newBranch = invalidation.details?.newBranch as string | undefined;
98
+ // Invalidate if any source file changed or if branch changed
99
+ return oldBranch !== newBranch;
100
+ }
101
+
102
+ default:
103
+ return false;
104
+ }
105
+ }
106
+
107
+ /**
108
+ * Generate current item hashes from a compiled context.
109
+ */
110
+ export function extractItemHashes(
111
+ items: CompiledContextItem[],
112
+ ): Map<string, string> {
113
+ const map = new Map<string, string>();
114
+ for (const item of items) {
115
+ if (item.contentHash) {
116
+ map.set(item.source, item.contentHash);
117
+ }
118
+ }
119
+ return map;
120
+ }
121
+
122
+ /**
123
+ * Simple deterministic hash for strings.
124
+ * Used for cache keys when crypto is unavailable.
125
+ */
126
+ export function simpleHash(text: string): string {
127
+ let hash = 0;
128
+ for (let i = 0; i < text.length; i++) {
129
+ const char = text.charCodeAt(i);
130
+ hash = (hash << 5) - hash + char;
131
+ hash |= 0;
132
+ }
133
+ return Math.abs(hash).toString(16).padStart(8, "0");
134
+ }