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,760 @@
1
+ /**
2
+ * Loop Runtime — RFC-0001
3
+ *
4
+ * Core execution loop for the harness runtime.
5
+ * Runs the repeated cycle:
6
+ * pick task -> assign model -> code -> run tests -> review diff
7
+ * -> if failed: repair
8
+ * -> if quota_limit: pause and resume later
9
+ * -> if context_full: compact + auto-resume
10
+ *
11
+ * Compact integration (RFC-0028):
12
+ * Uses CompactOrchestrator to proactively manage context window.
13
+ * On context_full: full compact + continue prompt + auto-retry
14
+ * On quota: pause job for later resume
15
+ */
16
+
17
+ import type {
18
+ LoopConfig,
19
+ LoopState,
20
+ JobStatus,
21
+ RuntimeCheckpoint,
22
+ RuntimeTask,
23
+ CompactableMessage,
24
+ InvokeWithCompactOptions,
25
+ InvokeResult,
26
+ CompactResult,
27
+ RuntimeEvent,
28
+ } from "../packages/types/src/runtime-types.js";
29
+ import { MirrorStore } from "../mirror.js";
30
+ import {
31
+ JobStateMachine,
32
+ type CheckpointManager,
33
+ } from "./job-state-machine.js";
34
+ import {
35
+ CompactOrchestrator,
36
+ type CompactOrchestratorCallbacks,
37
+ } from "./context-compact-orchestrator.js";
38
+ import {
39
+ type SessionMemoryManager,
40
+ createSessionMemoryManager,
41
+ } from "./session-memory.js";
42
+ import { AutoCompactEngine } from "./auto-compact.js";
43
+ import { OutputLimitHandler } from "./output-limit-handler.js";
44
+ import {
45
+ type ForkedSummarizer,
46
+ createForkedSummarizer,
47
+ } from "./forked-summarizer.js";
48
+
49
+ // --- Constants ----------------------------------------------------------------
50
+
51
+ const DEFAULT_MAX_COMPACT_RETRIES = 3;
52
+ const DEFAULT_MAX_OUTPUT_TOKENS = 4096;
53
+
54
+ // --- Lifecycle Callbacks ----------------------------------------------------
55
+
56
+ export interface LoopCallbacks {
57
+ /** Fetch next task from queue */
58
+ onPickTask?: () => Promise<RuntimeTask | null>;
59
+ /** Pick the best model for a task */
60
+ onPickModel?: (task: RuntimeTask) => Promise<string>;
61
+ /** Invoke the agent (returns full assistant text) */
62
+ onInvokeAgent?: (opts: InvokeWithCompactOptions) => Promise<InvokeResult>;
63
+ /** Run local tests */
64
+ onRunTests?: (task: RuntimeTask) => Promise<boolean>;
65
+ /** Run E2E tests */
66
+ onRunE2E?: (task: RuntimeTask) => Promise<boolean>;
67
+ /** Review the diff and decide next step */
68
+ onReview?: (
69
+ task: RuntimeTask,
70
+ testResults: { unit: boolean; e2e: boolean },
71
+ ) => Promise<"approve" | "repair" | "escalate">;
72
+ /** Repair a failed task */
73
+ onRepair?: (
74
+ task: RuntimeTask,
75
+ error: string,
76
+ ) => Promise<{ success: boolean; patch?: string }>;
77
+ /** Escalate to human */
78
+ onEscalate?: (task: RuntimeTask, reason: string) => Promise<void>;
79
+ /** Notify on quota events */
80
+ onQuotaEvent?: (
81
+ event: "paused" | "resumed" | "exhausted",
82
+ provider?: string,
83
+ ) => Promise<void>;
84
+ /** Get current checkpoint (used by auto-resume to read resumeAt) */
85
+ onGetCheckpoint?: () => Promise<RuntimeCheckpoint | null>;
86
+ /** Check mirror for a provider (used by auto-resume to detect early reset) */
87
+ onCheckMirror?: (
88
+ provider: string,
89
+ ) => Promise<{ h5_used_pct?: number } | null>;
90
+ /** Generic notify (used by auto-resume to tell user wait time) */
91
+ onNotify?: (msg: string, type?: string) => Promise<void>;
92
+ /** Save checkpoint (call persistence layer) */
93
+ onCheckpoint?: (checkpoint: RuntimeCheckpoint) => Promise<void>;
94
+ /** Notify each loop iteration */
95
+ onIteration?: (iteration: number, status: JobStatus) => void;
96
+ /** Called after every compaction with summary */
97
+ onCompaction?: (result: CompactResult) => void;
98
+ }
99
+
100
+ // --- Loop Result -----------------------------------------------------------
101
+
102
+ export interface LoopResult {
103
+ success: boolean;
104
+ completed: boolean;
105
+ iterations: number;
106
+ error?: string;
107
+ finalCheckpoint?: RuntimeCheckpoint;
108
+ /** Total compactions performed */
109
+ totalCompactions?: number;
110
+ }
111
+
112
+ // --- Loop Runtime -----------------------------------------------------------
113
+
114
+ export class LoopRuntime {
115
+ private readonly config: Required<LoopConfig>;
116
+ private readonly state: LoopState;
117
+ private readonly jobState: JobStateMachine;
118
+ private readonly mirrorStore: MirrorStore;
119
+ private readonly callbacks: LoopCallbacks;
120
+ private running = false;
121
+ private paused = false;
122
+
123
+ // Compact-related state
124
+ private readonly maxCompactRetries: number;
125
+ private readonly maxOutputTokens: number;
126
+ private compactOrchestrator?: CompactOrchestrator;
127
+ private forkedSummarizer?: ForkedSummarizer;
128
+ private sessionMemory?: SessionMemoryManager;
129
+ private autoCompactEngine?: AutoCompactEngine;
130
+ private totalCompactions = 0;
131
+
132
+ constructor(
133
+ config: LoopConfig,
134
+ callbacks: LoopCallbacks & {
135
+ /** Provider for compact orchestrator */
136
+ provider?: string;
137
+ /** Model for summarization */
138
+ summarizerModel?: string;
139
+ /** Context window size */
140
+ contextWindowSize?: number;
141
+ },
142
+ ) {
143
+ this.callbacks = callbacks;
144
+ this.maxCompactRetries =
145
+ config.maxRepairAttempts ?? DEFAULT_MAX_COMPACT_RETRIES;
146
+ this.maxOutputTokens = DEFAULT_MAX_OUTPUT_TOKENS;
147
+
148
+ this.config = {
149
+ jobId: config.jobId,
150
+ requirement: config.requirement,
151
+ providerPolicy: config.providerPolicy ?? {
152
+ plannerProvider: "openai",
153
+ codeProviders: ["openai"],
154
+ reviewProvider: "openai",
155
+ fallbackProviders: [],
156
+ },
157
+ maxIterations: config.maxIterations ?? 1000,
158
+ autoCheckpoint: config.autoCheckpoint ?? true,
159
+ checkpointInterval: config.checkpointInterval ?? 50,
160
+ pauseOnQuota: config.pauseOnQuota ?? true,
161
+ maxRepairAttempts: config.maxRepairAttempts ?? 3,
162
+ };
163
+
164
+ this.state = {
165
+ jobId: config.jobId,
166
+ iteration: 0,
167
+ status: "created",
168
+ currentTaskId: null,
169
+ lastCheckpoint: null,
170
+ };
171
+
172
+ this.jobState = new JobStateMachine({
173
+ checkpointManager: {
174
+ async save(ckpt: Parameters<CheckpointManager["save"]>[0]) {
175
+ await callbacks.onCheckpoint?.(ckpt);
176
+ },
177
+ async load(_jobId: string) {
178
+ return null;
179
+ },
180
+ async appendEvent(_jobId: string, _event: RuntimeEvent) {
181
+ // no-op for now
182
+ },
183
+ },
184
+ });
185
+ this.mirrorStore = new MirrorStore();
186
+
187
+ // Initialize session memory
188
+ this.sessionMemory = createSessionMemoryManager(config.jobId);
189
+
190
+ // Initialize auto-compact engine
191
+ this.autoCompactEngine = new AutoCompactEngine({
192
+ jobId: config.jobId,
193
+ requirement: config.requirement,
194
+ });
195
+
196
+ // Initialize compact orchestrator if agent callback provided
197
+ if (callbacks.onInvokeAgent) {
198
+ this.compactOrchestrator = new CompactOrchestrator({
199
+ jobId: config.jobId,
200
+ provider: callbacks.provider ?? "openai",
201
+ model: callbacks.summarizerModel ?? "gpt-4",
202
+ contextWindowSize: callbacks.contextWindowSize,
203
+ });
204
+
205
+ // Initialize forked summarizer if model provided
206
+ if (callbacks.summarizerModel && callbacks.onInvokeAgent) {
207
+ // Wrap onInvokeAgent to match ForkedSummarizer's InvokeOptions
208
+ const wrappedInvoke = async (opts: {
209
+ messages: Array<{ role: string; content: string }>;
210
+ model: string;
211
+ maxOutputTokens: number;
212
+ systemPrompt?: string;
213
+ }) => {
214
+ return callbacks.onInvokeAgent!(opts as InvokeWithCompactOptions);
215
+ };
216
+ this.forkedSummarizer = createForkedSummarizer(
217
+ callbacks.summarizerModel,
218
+ wrappedInvoke,
219
+ );
220
+ }
221
+ }
222
+ }
223
+
224
+ // --- Public API ---------------------------------------------------------
225
+
226
+ async run(): Promise<LoopResult> {
227
+ this.running = true;
228
+
229
+ // --- Auto-resume from quota pause ----------------------------------
230
+ const checkpoint = await this.callbacks.onGetCheckpoint?.();
231
+ if (checkpoint?.status === "paused_quota" && checkpoint.resumeAt) {
232
+ const resumeMs = new Date(checkpoint.resumeAt).getTime();
233
+ const now = Date.now();
234
+ const waitMs = resumeMs - now;
235
+ if (waitMs > 0) {
236
+ const waitMin = Math.ceil(waitMs / 60_000);
237
+ const notify = this.callbacks.onNotify ?? (() => {});
238
+ await notify(
239
+ `Quota reset in ${waitMin} min — auto-resuming at ${checkpoint.resumeAt}`,
240
+ "info",
241
+ );
242
+ // Wait in 5-minute chunks so we don't block forever if quota resets early
243
+ while (this.running && Date.now() < resumeMs) {
244
+ await new Promise((r) => setTimeout(r, 5 * 60_000)); // 5 min
245
+ // Re-check mirror — quota may have reset early
246
+ const fresh = await this.callbacks.onCheckMirror?.("minimax");
247
+ if (
248
+ fresh &&
249
+ fresh.h5_used_pct !== undefined &&
250
+ fresh.h5_used_pct < 100
251
+ ) {
252
+ break; // quota reset early, resume now
253
+ }
254
+ }
255
+ // Transition back to running
256
+ await this.jobState.transition("running");
257
+ this.callbacks.onQuotaEvent?.("resumed");
258
+ }
259
+ }
260
+
261
+ this.state.status = "running";
262
+
263
+ try {
264
+ while (this.running) {
265
+ // Check for pause
266
+ if (this.paused) {
267
+ await this.saveCheckpoint();
268
+ break;
269
+ }
270
+
271
+ this.state.iteration++;
272
+
273
+ // Check iteration limit
274
+ if (this.state.iteration > this.config.maxIterations) {
275
+ return {
276
+ success: false,
277
+ completed: false,
278
+ iterations: this.state.iteration,
279
+ error: "Max iterations exceeded",
280
+ totalCompactions: this.totalCompactions,
281
+ };
282
+ }
283
+
284
+ this.callbacks.onIteration?.(this.state.iteration, this.state.status);
285
+
286
+ // Check job status
287
+ const statusSummary = await this.jobState.getStatusSummary();
288
+ if (statusSummary?.status === "paused_quota") {
289
+ await this.handleQuotaPause();
290
+ continue;
291
+ }
292
+
293
+ // Pick a task
294
+ const task = await this.callbacks.onPickTask?.();
295
+ if (!task) {
296
+ this.state.status = "archived";
297
+ break;
298
+ }
299
+
300
+ this.state.currentTaskId = task.id;
301
+ await this.executeTaskWithCompact(task);
302
+
303
+ // Auto-checkpoint
304
+ if (
305
+ this.config.autoCheckpoint &&
306
+ this.state.iteration % this.config.checkpointInterval === 0
307
+ ) {
308
+ await this.saveCheckpoint();
309
+ }
310
+ }
311
+
312
+ return {
313
+ success: this.state.status !== "archived",
314
+ completed: this.state.status === "archived",
315
+ iterations: this.state.iteration,
316
+ finalCheckpoint: this.state.lastCheckpoint ?? undefined,
317
+ totalCompactions: this.totalCompactions,
318
+ };
319
+ } finally {
320
+ this.running = false;
321
+ }
322
+ }
323
+
324
+ pause(): void {
325
+ this.paused = true;
326
+ }
327
+
328
+ resume(): void {
329
+ this.paused = false;
330
+ this.state.status = "running";
331
+ }
332
+
333
+ stop(): void {
334
+ this.running = false;
335
+ }
336
+
337
+ getState(): Readonly<LoopState> {
338
+ return { ...this.state };
339
+ }
340
+
341
+ /** Get compact orchestrator for external access */
342
+ getCompactOrchestrator(): CompactOrchestrator | undefined {
343
+ return this.compactOrchestrator;
344
+ }
345
+
346
+ /** Get session memory manager */
347
+ getSessionMemory(): SessionMemoryManager | undefined {
348
+ return this.sessionMemory;
349
+ }
350
+
351
+ // --- Task Execution with Compact ---------------------------------------
352
+
353
+ private async executeTaskWithCompact(task: RuntimeTask): Promise<void> {
354
+ // 1. Pick model
355
+ const model = (await this.callbacks.onPickModel?.(task)) ?? "claude";
356
+
357
+ // 2. Build compactable messages
358
+ const compactMessages: CompactableMessage[] = [
359
+ {
360
+ role: "system",
361
+ content: this.buildSystemPrompt(task),
362
+ timestamp: Date.now(),
363
+ },
364
+ {
365
+ role: "user",
366
+ content: `Task: ${task.id}\nObjective: ${task.description ?? "See task graph."}`,
367
+ timestamp: Date.now(),
368
+ },
369
+ ];
370
+
371
+ // 3. Inject session memory if available
372
+ const sessionMemoryContext = this.sessionMemory?.getMemoryForContext();
373
+ if (sessionMemoryContext) {
374
+ compactMessages.push({
375
+ role: "system",
376
+ content: sessionMemoryContext,
377
+ timestamp: Date.now(),
378
+ metadata: { sessionMemory: true },
379
+ });
380
+ }
381
+
382
+ const outputLimitHandler = new OutputLimitHandler({
383
+ jobId: this.config.jobId,
384
+ taskId: task.id,
385
+ });
386
+
387
+ // 4. Execute with compact support
388
+ let compactRetries = 0;
389
+
390
+ while (compactRetries < this.maxCompactRetries) {
391
+ // Build invoke options
392
+ const invokeOptions: InvokeWithCompactOptions = {
393
+ messages: compactMessages,
394
+ model,
395
+ maxOutputTokens: this.maxOutputTokens,
396
+ tools: task.tools,
397
+ systemPrompt: task.instructions,
398
+ };
399
+
400
+ // Use compact orchestrator if available
401
+ if (this.compactOrchestrator && this.callbacks.onInvokeAgent) {
402
+ const orchestratorCallbacks = this.buildCompactCallbacks(task, model);
403
+ const result = await this.compactOrchestrator.invokeWithCompact(
404
+ invokeOptions,
405
+ orchestratorCallbacks,
406
+ );
407
+
408
+ if (result.success) {
409
+ const continued = await this.handleAutoContinuation(
410
+ compactMessages,
411
+ result,
412
+ task,
413
+ outputLimitHandler,
414
+ );
415
+ if (continued) {
416
+ continue;
417
+ }
418
+
419
+ this.handleInvokeSuccess(compactMessages, result, task);
420
+ outputLimitHandler.reset();
421
+ await this.runTestsAndReview(task, compactMessages);
422
+ return;
423
+ }
424
+
425
+ // Check for circuit breaker
426
+ if (this.compactOrchestrator.isCircuitBroken()) {
427
+ this.state.status = "blocked";
428
+ throw new Error(
429
+ `Compact circuit breaker engaged after ${this.compactOrchestrator.getConsecutiveFailures()} failures.`,
430
+ );
431
+ }
432
+
433
+ // Compact happened — retry
434
+ if (result.compactResult) {
435
+ compactRetries++;
436
+ this.totalCompactions++;
437
+ this.onCompactionOccurred(result.compactResult);
438
+
439
+ // Append continue message
440
+ if (result.continueMessage) {
441
+ compactMessages.push({
442
+ role: "user",
443
+ content: result.continueMessage,
444
+ timestamp: Date.now(),
445
+ });
446
+ }
447
+ continue;
448
+ }
449
+
450
+ // Error without compact — surface it
451
+ throw new Error(result.error ?? "Unknown invoke error");
452
+ }
453
+
454
+ // Fallback: direct invoke without orchestrator
455
+ const result = await this.callbacks.onInvokeAgent?.(invokeOptions);
456
+ if (!result || !result.success) {
457
+ throw new Error(result?.error ?? "Invoke failed");
458
+ }
459
+
460
+ const continued = await this.handleAutoContinuation(
461
+ compactMessages,
462
+ result,
463
+ task,
464
+ outputLimitHandler,
465
+ );
466
+ if (continued) {
467
+ continue;
468
+ }
469
+
470
+ this.handleInvokeSuccess(compactMessages, result, task);
471
+ outputLimitHandler.reset();
472
+ await this.runTestsAndReview(task, compactMessages);
473
+ return;
474
+ }
475
+
476
+ // Max compact retries exceeded
477
+ this.state.status = "blocked";
478
+ throw new Error(`Max compact retries (${this.maxCompactRetries}) exceeded`);
479
+ }
480
+
481
+ private async handleAutoContinuation(
482
+ messages: CompactableMessage[],
483
+ result: InvokeResult,
484
+ task: RuntimeTask,
485
+ outputLimitHandler: OutputLimitHandler,
486
+ ): Promise<boolean> {
487
+ const output = result.output ?? "";
488
+ const hitOutputLimit = outputLimitHandler.detectOutputLimit(result.error, {
489
+ finishReason: result.finishReason,
490
+ });
491
+ const hitCompactionBoundary =
492
+ this.autoCompactEngine?.detectCompaction(output) ?? false;
493
+
494
+ if (!hitOutputLimit && !hitCompactionBoundary) {
495
+ return false;
496
+ }
497
+
498
+ if (!outputLimitHandler.shouldContinue()) {
499
+ throw new Error(
500
+ `Output limit recovery exhausted after ${outputLimitHandler.getAttempts()} attempts for task ${task.id}.`,
501
+ );
502
+ }
503
+
504
+ this.handleInvokeSuccess(messages, result, task);
505
+ await outputLimitHandler.handleOutputLimit(
506
+ output,
507
+ result.finishReason ?? "length",
508
+ );
509
+
510
+ const continueMessage = hitCompactionBoundary
511
+ ? (this.autoCompactEngine?.buildContinueMessage() ?? "continue")
512
+ : "Output token limit hit. Resume directly — no apology, no recap of what you were doing. Pick up mid-thought if needed and continue the same task.";
513
+ messages.push({
514
+ role: "user",
515
+ content: continueMessage,
516
+ timestamp: Date.now(),
517
+ metadata: {
518
+ autoContinuation: true,
519
+ reason: hitCompactionBoundary ? "compaction" : "output_limit",
520
+ attempt: outputLimitHandler.getAttempts(),
521
+ },
522
+ });
523
+ return true;
524
+ }
525
+
526
+ /**
527
+ * Build compact callbacks for the orchestrator
528
+ */
529
+ private buildCompactCallbacks(
530
+ task: RuntimeTask,
531
+ _model: string,
532
+ ): CompactOrchestratorCallbacks {
533
+ return {
534
+ invokeAgent: async (opts) => {
535
+ return (
536
+ (await this.callbacks.onInvokeAgent?.(opts)) ?? {
537
+ success: false,
538
+ error: "No agent",
539
+ }
540
+ );
541
+ },
542
+
543
+ onCheckpoint: async (result) => {
544
+ this.callbacks.onCompaction?.(result);
545
+ await this.saveCheckpoint();
546
+ },
547
+
548
+ onPreCompact: async (_reason) => {
549
+ // Save partial artifacts before compact
550
+ // Note: we don't have beforeTokens here, but we save the state
551
+ this.autoCompactEngine?.saveCompactionArtifact({
552
+ timestamp: new Date().toISOString(),
553
+ jobId: this.config.jobId,
554
+ taskId: task.id,
555
+ compactedFromTokens: 0,
556
+ reason: _reason,
557
+ } as any);
558
+ },
559
+
560
+ onPostCompact: async (result) => {
561
+ // Extract facts from compacted messages for session memory
562
+ this.sessionMemory?.extractFacts([]);
563
+ this.callbacks.onCompaction?.(result);
564
+ },
565
+
566
+ onQuotaEvent: this.callbacks.onQuotaEvent,
567
+
568
+ summarizeViaForkedAgent: async (messages, reason) => {
569
+ if (this.forkedSummarizer) {
570
+ return this.forkedSummarizer.summarize(messages, {
571
+ focusOn: "work_done",
572
+ });
573
+ }
574
+ // Fallback to heuristic
575
+ return {
576
+ summary: `[Compact: ${reason}] Conversation summarised.`,
577
+ droppedCount: messages.length,
578
+ };
579
+ },
580
+ };
581
+ }
582
+
583
+ /**
584
+ * Handle successful invoke result
585
+ */
586
+ private handleInvokeSuccess(
587
+ messages: CompactableMessage[],
588
+ result: InvokeResult,
589
+ _task: RuntimeTask,
590
+ ): void {
591
+ // Append assistant response to messages
592
+ messages.push({
593
+ role: "assistant",
594
+ content: result.output ?? "",
595
+ timestamp: Date.now(),
596
+ metadata: {
597
+ model: result.model,
598
+ usage: result.usage,
599
+ },
600
+ });
601
+
602
+ // Extract facts from output for session memory
603
+ if (result.output) {
604
+ this.sessionMemory?.extractFacts([
605
+ {
606
+ role: "assistant",
607
+ content: result.output,
608
+ timestamp: Date.now(),
609
+ },
610
+ ]);
611
+ }
612
+ }
613
+
614
+ /**
615
+ * Called when compaction occurs
616
+ */
617
+ private onCompactionOccurred(result: CompactResult): void {
618
+ // Update session memory with compacted content
619
+ this.sessionMemory?.extractFacts([]);
620
+
621
+ // Save compaction event
622
+ this.autoCompactEngine?.saveCompactionArtifact({
623
+ timestamp: new Date().toISOString(),
624
+ jobId: this.config.jobId,
625
+ taskId: this.state.currentTaskId ?? "unknown",
626
+ compactedFromTokens: result.beforeTokens,
627
+ reason: result.trigger,
628
+ continuePrompt: result.summary,
629
+ } as any);
630
+
631
+ // Notify callbacks
632
+ this.callbacks.onCompaction?.(result);
633
+ }
634
+
635
+ /**
636
+ * Run tests and review
637
+ */
638
+ private async runTestsAndReview(
639
+ task: RuntimeTask,
640
+ messages: CompactableMessage[],
641
+ ): Promise<void> {
642
+ // Run tests
643
+ const unitPassed = (await this.callbacks.onRunTests?.(task)) ?? true;
644
+ const e2ePassed = (await this.callbacks.onRunE2E?.(task)) ?? true;
645
+
646
+ // Update session memory with test results
647
+ this.sessionMemory?.addTestResult(task.id, unitPassed && e2ePassed);
648
+
649
+ // Review
650
+ const verdict = await this.callbacks.onReview?.(task, {
651
+ unit: unitPassed,
652
+ e2e: e2ePassed,
653
+ });
654
+
655
+ if (verdict === "escalate") {
656
+ this.state.status = "waiting_human";
657
+ await this.callbacks.onEscalate?.(task, "Human review required");
658
+ this.paused = true;
659
+ } else if (verdict === "repair") {
660
+ // Append repair instruction
661
+ messages.push({
662
+ role: "user",
663
+ content:
664
+ "Tests failed. Please fix the issues and ensure all tests pass.",
665
+ timestamp: Date.now(),
666
+ });
667
+ }
668
+ }
669
+
670
+ /**
671
+ * Build system prompt for task
672
+ */
673
+ private buildSystemPrompt(task: RuntimeTask): string {
674
+ const parts = [
675
+ task.instructions ?? "Complete the assigned task.",
676
+ "",
677
+ "## Context Management",
678
+ "- Keep responses concise and focused",
679
+ "- If context becomes full, the system will compact automatically",
680
+ "- Do not repeat work already done",
681
+ ];
682
+
683
+ if (task.acceptanceCriteria && task.acceptanceCriteria.length > 0) {
684
+ parts.push("", "## Acceptance Criteria");
685
+ for (const criteria of task.acceptanceCriteria) {
686
+ parts.push(`- ${criteria}`);
687
+ }
688
+ }
689
+
690
+ return parts.join("\n");
691
+ }
692
+
693
+ // --- Quota Handling ----------------------------------------------------
694
+
695
+ private async handleQuotaPause(): Promise<void> {
696
+ this.paused = true;
697
+ this.state.status = "paused_quota";
698
+ this.jobState.transition("paused_quota");
699
+
700
+ // Set resumeAt from the mirror's known reset epoch so the auto-resume
701
+ // timer knows when to wake this job up.
702
+ const mirror = this.mirrorStore.readProvider("minimax");
703
+ const epoch = mirror?.h5_resets_at_epoch;
704
+ if (epoch) {
705
+ const resumeAt = new Date(epoch).toISOString();
706
+ await this.jobState.setResumeTime(resumeAt);
707
+ // console.log(
708
+ // `[LoopRuntime] Paused for 5h quota. Auto-resume at ${resumeAt}`,
709
+ // );
710
+ } else {
711
+ // console.log(
712
+ // "[LoopRuntime] Paused for quota but no reset time known yet.",
713
+ // );
714
+ }
715
+
716
+ await this.callbacks.onQuotaEvent?.("paused");
717
+ await this.saveCheckpoint();
718
+ }
719
+
720
+ // --- Persistence --------------------------------------------------------
721
+
722
+ private async saveCheckpoint(): Promise<void> {
723
+ const now = new Date().toISOString();
724
+ const checkpoint: RuntimeCheckpoint = {
725
+ version: 1,
726
+ jobId: this.state.jobId,
727
+ requirement: this.config.requirement,
728
+ taskId: this.state.currentTaskId ?? undefined,
729
+ iteration: this.state.iteration,
730
+ status: this.state.status,
731
+ createdAt: now,
732
+ updatedAt: now,
733
+ };
734
+ this.state.lastCheckpoint = checkpoint;
735
+ await this.jobState.transition(this.state.status);
736
+ await this.callbacks.onCheckpoint?.(checkpoint);
737
+ }
738
+
739
+ // --- Resume from Checkpoint --------------------------------------------
740
+
741
+ async resumeFromCheckpoint(
742
+ checkpoint: RuntimeCheckpoint,
743
+ ): Promise<LoopResult> {
744
+ this.state.iteration = checkpoint.iteration ?? 0;
745
+ this.state.currentTaskId = checkpoint.taskId ?? null;
746
+ this.state.status = checkpoint.status ?? "running";
747
+ this.paused = false;
748
+
749
+ // Check for pending continue prompt
750
+ if (this.autoCompactEngine?.hasContinuePrompt()) {
751
+ const continuePrompt = this.autoCompactEngine.loadContinuePrompt();
752
+ if (continuePrompt) {
753
+ // Resume will inject the continue prompt
754
+ this.callbacks.onIteration?.(this.state.iteration, this.state.status);
755
+ }
756
+ }
757
+
758
+ return this.run();
759
+ }
760
+ }