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,101 @@
1
+ /**
2
+ * Cookie sanitizer types.
3
+ *
4
+ * The data model is intentionally simple and explicit. Cookies flow in
5
+ * from one of two input formats (Netscape, EditThisCookie JSON), are
6
+ * normalised here into a canonical record, and written out as a single
7
+ * standard Netscape file by the writer.
8
+ *
9
+ * Cookie values are NEVER logged anywhere. They live in memory only
10
+ * for the duration of one parse → normalize → write cycle.
11
+ */
12
+
13
+ /** Provider identifier — inferred from filename or dominant cookie domain. */
14
+ export type ProviderId =
15
+ | "minimax"
16
+ | "anthropic"
17
+ | "openai"
18
+ | "glm"
19
+ | "openrouter"
20
+ | string;
21
+
22
+ /** Input file format. */
23
+ export type CookieFileFormat = "netscape" | "edit-this-cookie-json";
24
+
25
+ /** A single cookie in canonical (post-normalize) form. */
26
+ export interface CanonicalCookie {
27
+ /** Provider this cookie belongs to. Set during infer-provider pass. */
28
+ provider?: ProviderId;
29
+ /** Cookie name (e.g. "_token", "_ga"). Must be non-empty after normalization. */
30
+ name: string;
31
+ /** Cookie value. NEVER logged. */
32
+ value: string;
33
+ /** Cookie domain (e.g. ".minimax.io", "platform.minimax.io"). */
34
+ domain: string;
35
+ /** URL path this cookie applies to (default "/"). */
36
+ path: string;
37
+ /** Expires at — Unix seconds since epoch. NaN or undefined = session cookie. */
38
+ expires?: number;
39
+ /** Whether this is a Secure-only cookie (HTTPS-only). */
40
+ secure: boolean;
41
+ /** Whether this cookie is HTTP-only (no JS access). */
42
+ httpOnly: boolean;
43
+ }
44
+
45
+ /** Result of detecting a single file's format. */
46
+ export interface DetectedFile {
47
+ /** Absolute path (or relative, in tests). */
48
+ path: string;
49
+ /** Filename only (no directory). Used for log lines — never the full path contents. */
50
+ basename: string;
51
+ /** Detected format. */
52
+ format: CookieFileFormat | null;
53
+ /** Raw text content (truncated to first 4096 chars for safety in debug logs). */
54
+ text: string;
55
+ /** Parse error if format is null. Null error means format is unknown. */
56
+ error?: string;
57
+ }
58
+
59
+ /** Sync result for the whole drop folder. */
60
+ export interface SyncResult {
61
+ /** Provider that was inferred. Null if inference failed. */
62
+ provider: ProviderId | null;
63
+ /** Files considered (readable, recognized format). */
64
+ processedFiles: string[];
65
+ /** Files skipped (unreadable, unknown format). */
66
+ skippedFiles: Array<{ basename: string; reason: string }>;
67
+ /** Total cookies after dedupe across all files. */
68
+ totalCookies: number;
69
+ /** Path the canonical cache was written to (relative or absolute). */
70
+ cachePath: string;
71
+ /** Source path the cookies came from. */
72
+ sourceDir: string;
73
+ /** True if the cache was actually written (no-op if no new data). */
74
+ wrote: boolean;
75
+ /** Errors during sync (per-file, never value-bearing). */
76
+ errors: Array<{ basename: string; message: string }>;
77
+ }
78
+
79
+ /** Sync options. */
80
+ export interface SyncOptions {
81
+ /** Override the default drop-folder location. */
82
+ dropDir?: string;
83
+ /** Override the default canonical cache location. */
84
+ cachePath?: string;
85
+ /** Provider hint (skips filename/domain inference). */
86
+ providerHint?: ProviderId;
87
+ /** Skip writing the cache file even if normalization produced cookies. */
88
+ dryRun?: boolean;
89
+ }
90
+
91
+ /** Watcher events emitted by the live watcher. */
92
+ export type WatcherEvent =
93
+ | {
94
+ kind: "sync-ok";
95
+ provider: ProviderId;
96
+ cachePath: string;
97
+ cookies: number;
98
+ }
99
+ | { kind: "sync-skip"; reason: string }
100
+ | { kind: "sync-error"; message: string }
101
+ | { kind: "watcher-error"; message: string };
@@ -0,0 +1,180 @@
1
+ /**
2
+ * Live cookie-folder watcher.
3
+ *
4
+ * Wraps chokidar v5 with the project-specific options:
5
+ * - `atomic: 100` — EditThisCookie / browser exporters use atomic write
6
+ * - `awaitWriteFinish` — wait for size to settle before triggering
7
+ * - `ignoreInitial: true` — startup is handled by sync.ts separately
8
+ * - `depth: 2` — one level + one subfolder
9
+ * - editor temp ignored
10
+ *
11
+ * Sec-001: Cookie values are NEVER logged. Diagnostics use only
12
+ * basenames, file paths, and event kinds.
13
+ */
14
+
15
+ import chokidar, { type FSWatcher } from "chokidar";
16
+ import { join } from "node:path";
17
+ import { sync, type SyncOptions } from "./sync.js";
18
+ import type { WatcherEvent } from "./types.js";
19
+
20
+ /** Public watcher config. */
21
+ export interface CookieWatcherConfig {
22
+ /** Folder to watch. Default: ~/.pi-harness-runtime/cookies/ */
23
+ dropDir: string;
24
+ /** Sync options passed through to the sync orchestrator. */
25
+ syncOptions?: SyncOptions;
26
+ /** Event sink. Required. */
27
+ onEvent: (event: WatcherEvent) => void;
28
+ /** Override the debounce window (ms). Default 250. */
29
+ debounceMs?: number;
30
+ /** Optional logger (defaults to console). */
31
+ logger?: (msg: string) => void;
32
+ }
33
+
34
+ const DEFAULT_DEBOUNCE_MS = 250;
35
+
36
+ /** Wraps a chokidar watcher for the drop folder. */
37
+ export class CookieWatcher {
38
+ private watcher: FSWatcher | null = null;
39
+ private debounceMs: number;
40
+ private debounceTimer: ReturnType<typeof setTimeout> | null = null;
41
+ private log: (msg: string) => void;
42
+ private cfg: CookieWatcherConfig;
43
+ private running = false;
44
+
45
+ constructor(config: CookieWatcherConfig) {
46
+ this.cfg = config;
47
+ this.debounceMs = config.debounceMs ?? DEFAULT_DEBOUNCE_MS;
48
+ this.log = config.logger ?? ((m) => console.log(`[cookie-sanitizer] ${m}`));
49
+ }
50
+
51
+ /** Start watching. Idempotent — calling twice is a no-op. */
52
+ start(): void {
53
+ if (this.running) return;
54
+ this.running = true;
55
+
56
+ this.watcher = chokidar.watch(this.cfg.dropDir, {
57
+ ignored: (targetPath: string) => {
58
+ const base = targetPath.split("/").pop() ?? "";
59
+ if (base.startsWith(".")) return true;
60
+ if (base.endsWith("~") || base.endsWith(".swp")) return true;
61
+ if (base.endsWith(".tmp")) return true;
62
+ // Exclude the canonical cache file (if specified) so the
63
+ // sanitizer's own write doesn't trigger a re-sync.
64
+ if (
65
+ this.cfg.syncOptions?.cachePath &&
66
+ targetPath === this.cfg.syncOptions.cachePath
67
+ ) {
68
+ return true;
69
+ }
70
+ return false;
71
+ },
72
+ ignoreInitial: true,
73
+ persistent: true,
74
+ depth: 2,
75
+ atomic: 100,
76
+ awaitWriteFinish: {
77
+ stabilityThreshold: 200,
78
+ pollInterval: 50,
79
+ },
80
+ });
81
+
82
+ this.watcher.on("add", () => this.schedule());
83
+ this.watcher.on("change", () => this.schedule());
84
+ this.watcher.on("unlink", () => this.schedule());
85
+ this.watcher.on("error", (err: unknown) => {
86
+ this.log(
87
+ `watcher error: ${err instanceof Error ? err.message : String(err)}`,
88
+ );
89
+ this.cfg.onEvent({
90
+ kind: "watcher-error",
91
+ message: err instanceof Error ? err.message : String(err),
92
+ });
93
+ });
94
+
95
+ this.log(`watching ${this.cfg.dropDir}`);
96
+ }
97
+
98
+ /** Stop watching. Idempotent. */
99
+ async stop(): Promise<void> {
100
+ if (!this.running) return;
101
+ this.running = false;
102
+ if (this.debounceTimer) {
103
+ clearTimeout(this.debounceTimer);
104
+ this.debounceTimer = null;
105
+ }
106
+ if (this.watcher) {
107
+ await this.watcher.close();
108
+ this.watcher = null;
109
+ }
110
+ this.log("stopped");
111
+ }
112
+
113
+ /** Trigger a sync immediately (bypass debounce). */
114
+ triggerNow(): void {
115
+ if (this.debounceTimer) {
116
+ clearTimeout(this.debounceTimer);
117
+ this.debounceTimer = null;
118
+ }
119
+ this.runSync();
120
+ }
121
+
122
+ private schedule(): void {
123
+ if (this.debounceTimer) clearTimeout(this.debounceTimer);
124
+ this.debounceTimer = setTimeout(() => {
125
+ this.debounceTimer = null;
126
+ this.runSync();
127
+ }, this.debounceMs);
128
+ }
129
+
130
+ private runSync(): void {
131
+ try {
132
+ const result = sync(this.cfg.syncOptions ?? {});
133
+ if (result.errors.length > 0) {
134
+ for (const err of result.errors) {
135
+ this.cfg.onEvent({
136
+ kind: "sync-error",
137
+ message: `${err.basename}: ${err.message}`,
138
+ });
139
+ }
140
+ }
141
+ if (result.provider && result.wrote) {
142
+ this.cfg.onEvent({
143
+ kind: "sync-ok",
144
+ provider: result.provider,
145
+ cachePath: result.cachePath,
146
+ cookies: result.totalCookies,
147
+ });
148
+ } else if (
149
+ result.processedFiles.length === 0 &&
150
+ result.provider === null
151
+ ) {
152
+ this.cfg.onEvent({
153
+ kind: "sync-skip",
154
+ reason: "no usable cookies found",
155
+ });
156
+ }
157
+ } catch (e) {
158
+ this.cfg.onEvent({
159
+ kind: "sync-error",
160
+ message: e instanceof Error ? e.message : String(e),
161
+ });
162
+ }
163
+ }
164
+ }
165
+
166
+ /** Factory: a watcher that writes to a default no-op logger. */
167
+ export function createWatcher(
168
+ dropDir: string,
169
+ syncOptions: SyncOptions,
170
+ onEvent: (event: WatcherEvent) => void,
171
+ ): CookieWatcher {
172
+ return new CookieWatcher({ dropDir, syncOptions, onEvent });
173
+ }
174
+
175
+ /** Compute a sensible dropDir for a given HOME override (test seam). */
176
+ export function defaultDropDir(
177
+ home: string = process.env.HOME ?? "/tmp",
178
+ ): string {
179
+ return join(home, ".pi-harness-runtime", "cookies");
180
+ }
@@ -0,0 +1,138 @@
1
+ /**
2
+ * Budget Management Functions (RFC-0055)
3
+ */
4
+
5
+ import type {
6
+ BudgetStatus,
7
+ CostBudget,
8
+ CostEntry,
9
+ CostPeriod,
10
+ } from "./types.js";
11
+ import { isInPeriod } from "./tracker.js";
12
+ // Note: getPeriodBoundaries is used internally by tracker.js
13
+
14
+ /**
15
+ * Calculate budget status for all periods
16
+ */
17
+ export function calculateBudgetStatus(
18
+ entries: CostEntry[],
19
+ budget: CostBudget,
20
+ ): BudgetStatus {
21
+ const now = new Date();
22
+
23
+ // Daily period
24
+ const dailyPeriod: CostPeriod = { start: "", end: "", type: "day" };
25
+ dailyPeriod.start = new Date(
26
+ now.getFullYear(),
27
+ now.getMonth(),
28
+ now.getDate(),
29
+ ).toISOString();
30
+ dailyPeriod.end = now.toISOString();
31
+ const dailyUsed = calculatePeriodTotal(entries, dailyPeriod);
32
+
33
+ // Weekly period
34
+ const weeklyPeriod: CostPeriod = { start: "", end: "", type: "week" };
35
+ const weekStart = new Date(now);
36
+ weekStart.setDate(now.getDate() - now.getDay());
37
+ weekStart.setHours(0, 0, 0, 0);
38
+ weeklyPeriod.start = weekStart.toISOString();
39
+ weeklyPeriod.end = now.toISOString();
40
+ const weeklyUsed = calculatePeriodTotal(entries, weeklyPeriod);
41
+
42
+ // Monthly period
43
+ const monthlyPeriod: CostPeriod = { start: "", end: "", type: "month" };
44
+ const monthStart = new Date(now.getFullYear(), now.getMonth(), 1);
45
+ monthlyPeriod.start = monthStart.toISOString();
46
+ monthlyPeriod.end = now.toISOString();
47
+ const monthlyUsed = calculatePeriodTotal(entries, monthlyPeriod);
48
+
49
+ // Calculate exhausted state
50
+ const exhausted =
51
+ (budget.daily !== undefined && dailyUsed >= budget.daily) ||
52
+ (budget.weekly !== undefined && weeklyUsed >= budget.weekly) ||
53
+ (budget.monthly !== undefined && monthlyUsed >= budget.monthly);
54
+
55
+ // Calculate next reset time (simplified - daily reset at midnight)
56
+ const nextReset = new Date(now);
57
+ nextReset.setDate(nextReset.getDate() + 1);
58
+ nextReset.setHours(0, 0, 0, 0);
59
+
60
+ return {
61
+ daily: {
62
+ used: dailyUsed,
63
+ budget: budget.daily ?? 0,
64
+ remaining: Math.max(0, (budget.daily ?? Infinity) - dailyUsed),
65
+ },
66
+ weekly: {
67
+ used: weeklyUsed,
68
+ budget: budget.weekly ?? 0,
69
+ remaining: Math.max(0, (budget.weekly ?? Infinity) - weeklyUsed),
70
+ },
71
+ monthly: {
72
+ used: monthlyUsed,
73
+ budget: budget.monthly ?? 0,
74
+ remaining: Math.max(0, (budget.monthly ?? Infinity) - monthlyUsed),
75
+ },
76
+ exhausted,
77
+ nextReset: exhausted ? nextReset.toISOString() : undefined,
78
+ };
79
+ }
80
+
81
+ /**
82
+ * Calculate total cost for a period
83
+ */
84
+ function calculatePeriodTotal(
85
+ entries: CostEntry[],
86
+ period: CostPeriod,
87
+ ): number {
88
+ return entries
89
+ .filter((e) => isInPeriod(e.timestamp, period))
90
+ .reduce((sum, e) => sum + e.cost, 0);
91
+ }
92
+
93
+ /**
94
+ * Check if a cost exceeds budget
95
+ */
96
+ export function exceedsBudget(
97
+ _cost: number, // eslint-disable-line @typescript-eslint/no-unused-vars
98
+ budget: CostBudget,
99
+ status: BudgetStatus,
100
+ ): boolean {
101
+ if (budget.daily !== undefined && _cost > status.daily.remaining) {
102
+ return true;
103
+ }
104
+ if (budget.weekly !== undefined && _cost > status.weekly.remaining) {
105
+ return true;
106
+ }
107
+ if (budget.monthly !== undefined && _cost > status.monthly.remaining) {
108
+ return true;
109
+ }
110
+ return false;
111
+ }
112
+
113
+ /**
114
+ * Get the most restrictive remaining budget
115
+ */
116
+ export function getMostRestrictiveBudget(
117
+ _cost: number, // eslint-disable-line @typescript-eslint/no-unused-vars
118
+ budget: CostBudget,
119
+ status: BudgetStatus,
120
+ ): { period: string; remaining: number } | null {
121
+ const candidates: { period: string; remaining: number }[] = [];
122
+
123
+ if (budget.daily !== undefined) {
124
+ candidates.push({ period: "daily", remaining: status.daily.remaining });
125
+ }
126
+ if (budget.weekly !== undefined) {
127
+ candidates.push({ period: "weekly", remaining: status.weekly.remaining });
128
+ }
129
+ if (budget.monthly !== undefined) {
130
+ candidates.push({ period: "monthly", remaining: status.monthly.remaining });
131
+ }
132
+
133
+ if (candidates.length === 0) return null;
134
+
135
+ return candidates.reduce((most, current) =>
136
+ current.remaining < most.remaining ? current : most,
137
+ );
138
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * Cost Optimizer Configuration (RFC-0055)
3
+ */
4
+
5
+ import type { CostOptimizerConfig } from "./types.js";
6
+
7
+ export const DEFAULT_CONFIG: CostOptimizerConfig = {
8
+ defaultBudget: {
9
+ daily: 10,
10
+ weekly: 50,
11
+ monthly: 200,
12
+ },
13
+ currency: "USD",
14
+ alertThreshold: 0.8, // 80%
15
+ autoSwitchToCheaper: false,
16
+ maxQualityLossPercent: 15,
17
+ };
18
+
19
+ /**
20
+ * Create a custom optimizer config
21
+ */
22
+ export function createOptimizerConfig(
23
+ overrides: Partial<CostOptimizerConfig>,
24
+ ): CostOptimizerConfig {
25
+ const result: CostOptimizerConfig = {
26
+ ...DEFAULT_CONFIG,
27
+ ...overrides,
28
+ defaultBudget: {
29
+ ...DEFAULT_CONFIG.defaultBudget,
30
+ ...(overrides.defaultBudget ?? {}),
31
+ },
32
+ };
33
+ return result;
34
+ }
@@ -0,0 +1,59 @@
1
+ /**
2
+ * Cost Forecasting Functions (RFC-0055)
3
+ */
4
+
5
+ import type { CostForecast, TaskRequirements } from "./types.js";
6
+
7
+ // Default model cost per 1K tokens (input + output average)
8
+ const AVG_COST_PER_1K = 0.003; // $0.003 per 1K tokens average
9
+
10
+ /**
11
+ * Forecast costs for a set of job requirements
12
+ */
13
+ export function forecastCosts(
14
+ requirements: TaskRequirements[],
15
+ options?: { confidence?: number },
16
+ ): CostForecast {
17
+ const byTaskType: Record<string, number> = {};
18
+ let total = 0;
19
+ const assumptions: string[] = [];
20
+
21
+ for (const req of requirements) {
22
+ // Estimate based on average cost per token
23
+ const avgCostPerToken = AVG_COST_PER_1K / 1000;
24
+ const estimated =
25
+ (req.estimatedInputTokens + req.estimatedOutputTokens) * avgCostPerToken;
26
+ const rounded = Math.round(estimated * 10000) / 10000;
27
+
28
+ const taskType = req.requiredCapabilities[0] ?? "general";
29
+ byTaskType[taskType] = (byTaskType[taskType] ?? 0) + rounded;
30
+ total += rounded;
31
+ }
32
+
33
+ assumptions.push("Based on average model costs across providers");
34
+ assumptions.push("Does not account for provider-specific pricing variations");
35
+ assumptions.push("Actual costs may vary based on usage patterns");
36
+
37
+ // Confidence decreases with more tasks
38
+ const baseConfidence = options?.confidence ?? 0.8;
39
+ const taskCountFactor = Math.max(0.5, 1 - requirements.length * 0.02);
40
+ const confidence = Math.round(baseConfidence * taskCountFactor * 100) / 100;
41
+
42
+ return {
43
+ estimatedTotal: Math.round(total * 100) / 100,
44
+ byTaskType,
45
+ confidence,
46
+ assumptions,
47
+ };
48
+ }
49
+
50
+ /**
51
+ * Quick forecast for a single task
52
+ */
53
+ export function quickForecast(
54
+ inputTokens: number,
55
+ outputTokens: number,
56
+ ): number {
57
+ const totalTokens = inputTokens + outputTokens;
58
+ return Math.round(((totalTokens * AVG_COST_PER_1K) / 1000) * 10000) / 10000;
59
+ }
@@ -0,0 +1,74 @@
1
+ /**
2
+ * Cost Optimizer Package (RFC-0055)
3
+ *
4
+ * Intelligent cost management with budget tracking, forecasting, and model selection.
5
+ *
6
+ * @example
7
+ * ```typescript
8
+ * import { createCostOptimizer } from "@pi-harness/cost-optimizer";
9
+ *
10
+ * const optimizer = createCostOptimizer();
11
+ *
12
+ * // Track a cost
13
+ * optimizer.trackCost({ jobId: "job-1", cost: 0.5, ... });
14
+ *
15
+ * // Check budget
16
+ * const status = optimizer.getBudgetStatus();
17
+ *
18
+ * // Get optimization suggestions
19
+ * const selections = optimizer.optimizeModelSelection("task-1", requirements);
20
+ * ```
21
+ */
22
+
23
+ // Types
24
+ export type {
25
+ CostEntry,
26
+ CostBudget,
27
+ BudgetStatus,
28
+ CostSummary,
29
+ CostPeriod,
30
+ CostOptimizerConfig,
31
+ SwitchOptions,
32
+ ModelSwitchRecommendation,
33
+ CostForecast,
34
+ TaskRequirements,
35
+ OptimizedSelection,
36
+ CostOptimizer,
37
+ CostOptimizerEvent,
38
+ } from "./types.js";
39
+
40
+ // Optimizer
41
+ export { InMemoryCostOptimizer, createCostOptimizer } from "./optimizer.js";
42
+
43
+ // Config
44
+ export { DEFAULT_CONFIG, createOptimizerConfig } from "./config.js";
45
+
46
+ // Tracker utilities
47
+ export {
48
+ generateCostId,
49
+ createCostEntry,
50
+ getPeriodBoundaries,
51
+ isInPeriod,
52
+ calculateSummary,
53
+ getTotalCost,
54
+ } from "./tracker.js";
55
+
56
+ // Budget utilities
57
+ export {
58
+ calculateBudgetStatus,
59
+ exceedsBudget,
60
+ getMostRestrictiveBudget,
61
+ } from "./budget.js";
62
+
63
+ // Selection utilities
64
+ export {
65
+ calculateModelCost,
66
+ calculateQualityImpact,
67
+ getQualityScore,
68
+ findCheaperAlternatives,
69
+ generateSwitchRecommendation,
70
+ optimizeModelSelection,
71
+ } from "./selection.js";
72
+
73
+ // Forecast utilities
74
+ export { forecastCosts, quickForecast } from "./forecast.js";