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,286 @@
1
+ /**
2
+ * Notification Center — RFC-0022
3
+ *
4
+ * Main orchestration class for sending notifications across multiple channels.
5
+ *
6
+ * Security Rules (RFC-0022):
7
+ * - Do not send raw cookies, passwords, provider tokens
8
+ * - Redact sensitive data before sending
9
+ * - Notification failure does not crash runtime
10
+ */
11
+
12
+ import type {
13
+ NotificationEvent,
14
+ NotificationPayload,
15
+ NotificationConfig,
16
+ NotificationChannelConfig,
17
+ NotificationResult,
18
+ NotificationContext,
19
+ } from "./types.js";
20
+ import type { ChannelAdapter } from "./base-adapter.js";
21
+ import { TelegramAdapter } from "./adapters/telegram-adapter.js";
22
+ import { NtfyAdapter } from "./adapters/ntfy-adapter.js";
23
+ import { EmailAdapter } from "./adapters/email-adapter.js";
24
+ import { WebhookAdapter } from "./adapters/webhook-adapter.js";
25
+
26
+ export class NotificationCenter {
27
+ private adapters: Map<string, ChannelAdapter> = new Map();
28
+ private redactPatterns: RegExp[];
29
+
30
+ constructor(config?: NotificationConfig) {
31
+ this.redactPatterns =
32
+ config?.redactPatterns ?? this.getDefaultRedactPatterns();
33
+
34
+ if (config?.channels) {
35
+ for (const channelConfig of config.channels) {
36
+ if (channelConfig.enabled) {
37
+ this.registerAdapter(channelConfig);
38
+ }
39
+ }
40
+ }
41
+ }
42
+
43
+ /**
44
+ * Register a new adapter
45
+ */
46
+ registerAdapter(config: NotificationChannelConfig): boolean {
47
+ try {
48
+ const adapter = this.createAdapter(config);
49
+ if (adapter && adapter.isConfigured()) {
50
+ this.adapters.set(config.id, adapter);
51
+ return true;
52
+ }
53
+ } catch (error) {
54
+ console.error(
55
+ `[NotificationCenter] Failed to register adapter: ${error}`,
56
+ );
57
+ }
58
+ return false;
59
+ }
60
+
61
+ /**
62
+ * Initialize all registered adapters
63
+ */
64
+ async initialize(): Promise<void> {
65
+ const adapterEntries = Array.from(this.adapters.entries());
66
+ for (const [id, adapter] of adapterEntries) {
67
+ try {
68
+ const ok = await adapter.initialize();
69
+ if (!ok) {
70
+ console.warn(
71
+ `[NotificationCenter] Adapter ${id} initialization failed`,
72
+ );
73
+ }
74
+ } catch (error) {
75
+ console.warn(
76
+ `[NotificationCenter] Adapter ${id} initialization error: ${error}`,
77
+ );
78
+ }
79
+ }
80
+ }
81
+
82
+ /**
83
+ * Send a notification to all configured channels
84
+ */
85
+ async notify(
86
+ event: NotificationEvent,
87
+ context: NotificationContext,
88
+ ): Promise<NotificationResult[]> {
89
+ const payload = this.buildPayload(event, context);
90
+ const results: NotificationResult[] = [];
91
+
92
+ // Send to all adapters in parallel
93
+ const adapterEntries = Array.from(this.adapters.entries());
94
+ const promises = adapterEntries.map(async ([id, adapter]) => {
95
+ try {
96
+ // Redact sensitive data
97
+ const redactedPayload = this.redact(payload);
98
+ const result = await adapter.send(redactedPayload);
99
+ results.push(result);
100
+ } catch (error) {
101
+ // Never crash the runtime due to notification failure
102
+ results.push({
103
+ success: false,
104
+ channel: id,
105
+ error: String(error),
106
+ });
107
+ }
108
+ });
109
+
110
+ await Promise.all(promises);
111
+ return results;
112
+ }
113
+
114
+ /**
115
+ * Send notification to a specific channel
116
+ */
117
+ async notifyChannel(
118
+ channelId: string,
119
+ event: NotificationEvent,
120
+ context: NotificationContext,
121
+ ): Promise<NotificationResult> {
122
+ const adapter = this.adapters.get(channelId);
123
+ if (!adapter) {
124
+ return { success: false, channel: channelId, error: "Adapter not found" };
125
+ }
126
+
127
+ try {
128
+ const payload = this.redact(this.buildPayload(event, context));
129
+ return await adapter.send(payload);
130
+ } catch (error) {
131
+ return { success: false, channel: channelId, error: String(error) };
132
+ }
133
+ }
134
+
135
+ /**
136
+ * Check if any notifications are configured
137
+ */
138
+ hasChannels(): boolean {
139
+ return this.adapters.size > 0;
140
+ }
141
+
142
+ /**
143
+ * List all configured channels
144
+ */
145
+ listChannels(): string[] {
146
+ return Array.from(this.adapters.keys());
147
+ }
148
+
149
+ // --- Private Methods ------------------------------------------------
150
+
151
+ private createAdapter(
152
+ config: NotificationChannelConfig,
153
+ ): ChannelAdapter | null {
154
+ switch (config.type) {
155
+ case "telegram":
156
+ return new TelegramAdapter(
157
+ config.config as import("./types.js").TelegramConfig,
158
+ );
159
+ case "ntfy":
160
+ return new NtfyAdapter(
161
+ config.config as import("./types.js").NtfyConfig,
162
+ );
163
+ case "email":
164
+ return new EmailAdapter(
165
+ config.config as import("./types.js").EmailConfig,
166
+ );
167
+ case "webhook":
168
+ return new WebhookAdapter(
169
+ config.config as import("./types.js").WebhookConfig,
170
+ );
171
+ default:
172
+ return null;
173
+ }
174
+ }
175
+
176
+ private buildPayload(
177
+ event: NotificationEvent,
178
+ context: NotificationContext,
179
+ ): NotificationPayload {
180
+ const { title, message } = this.getEventContent(event, context);
181
+
182
+ return {
183
+ event,
184
+ jobId: context.jobId,
185
+ timestamp: new Date().toISOString(),
186
+ title,
187
+ message,
188
+ details: {
189
+ jobId: context.jobId,
190
+ requirement: context.requirement,
191
+ ...(context.taskId && { taskId: context.taskId }),
192
+ ...(context.taskTitle && { taskTitle: context.taskTitle }),
193
+ ...(context.error && { error: context.error }),
194
+ },
195
+ };
196
+ }
197
+
198
+ private getEventContent(
199
+ event: NotificationEvent,
200
+ context: NotificationContext,
201
+ ): { title: string; message: string } {
202
+ const requirement =
203
+ context.requirement.length > 50
204
+ ? context.requirement.slice(0, 50) + "..."
205
+ : context.requirement;
206
+
207
+ const map: Record<NotificationEvent, { title: string; message: string }> = {
208
+ JobStarted: {
209
+ title: "Job Started",
210
+ message: `Harness job started for: "${requirement}"`,
211
+ },
212
+ TaskCompleted: {
213
+ title: "Task Completed",
214
+ message: `Task "${context.taskTitle ?? "Unknown"}" completed successfully`,
215
+ },
216
+ TaskFailed: {
217
+ title: "Task Failed",
218
+ message: `Task "${context.taskTitle ?? "Unknown"}" failed${context.error ? `: ${context.error}` : ""}`,
219
+ },
220
+ QuotaPaused: {
221
+ title: "Quota Paused",
222
+ message: `Job paused due to quota limit. Will auto-resume when quota resets.`,
223
+ },
224
+ ResumeScheduled: {
225
+ title: "Resume Scheduled",
226
+ message: `Job will resume work on: "${requirement}"`,
227
+ },
228
+ ContextCompacted: {
229
+ title: "Context Compacted",
230
+ message: `Session context was compacted to continue work on: "${requirement}"`,
231
+ },
232
+ OutputLimitContinued: {
233
+ title: "Output Limit Continued",
234
+ message: `Response was continued after hitting output token limit`,
235
+ },
236
+ E2EFailed: {
237
+ title: "E2E Test Failed",
238
+ message: `End-to-end tests failed for job: "${requirement}"`,
239
+ },
240
+ HumanReviewNeeded: {
241
+ title: "Human Review Needed",
242
+ message: `Job blocked. Please review and take action.`,
243
+ },
244
+ ReadyForClient: {
245
+ title: "Ready for Review",
246
+ message: `Job completed successfully and ready for your review: "${requirement}"`,
247
+ },
248
+ JobCancelled: {
249
+ title: "Job Cancelled",
250
+ message: `Job was cancelled: "${requirement}"`,
251
+ },
252
+ Error: {
253
+ title: "Runtime Error",
254
+ message: `An error occurred${context.error ? `: ${context.error}` : ""}`,
255
+ },
256
+ };
257
+
258
+ return map[event] ?? { title: event, message: `Event: ${event}` };
259
+ }
260
+
261
+ private redact(payload: NotificationPayload): NotificationPayload {
262
+ const details = payload.details ? { ...payload.details } : {};
263
+
264
+ // Redact sensitive patterns
265
+ for (const pattern of this.redactPatterns) {
266
+ for (const [key, value] of Object.entries(details)) {
267
+ if (typeof value === "string" && pattern.test(value)) {
268
+ details[key] = "[REDACTED]";
269
+ }
270
+ }
271
+ }
272
+
273
+ return { ...payload, details };
274
+ }
275
+
276
+ private getDefaultRedactPatterns(): RegExp[] {
277
+ return [
278
+ /Bearer\s+[\w-]+/gi, // Bearer tokens
279
+ /password["\s:=]+[^\s,}]+/gi, // passwords
280
+ /cookie["\s:=]+[^\s,}]+/gi, // cookies
281
+ /secret["\s:=]+[^\s,}]+/gi, // secrets
282
+ /api[_-]?key["\s:=]+[^\s,}]+/gi, // API keys
283
+ /auth["\s:=]+[^\s,}]+/gi, // auth tokens
284
+ ];
285
+ }
286
+ }
@@ -0,0 +1,89 @@
1
+ /**
2
+ * Notification Center Types — RFC-0022
3
+ *
4
+ * Type definitions for notification events, channels, and payloads.
5
+ */
6
+
7
+ export type NotificationEvent =
8
+ | "JobStarted"
9
+ | "TaskCompleted"
10
+ | "TaskFailed"
11
+ | "QuotaPaused"
12
+ | "ResumeScheduled"
13
+ | "ContextCompacted"
14
+ | "OutputLimitContinued"
15
+ | "E2EFailed"
16
+ | "HumanReviewNeeded"
17
+ | "ReadyForClient"
18
+ | "JobCancelled"
19
+ | "Error";
20
+
21
+ export interface NotificationPayload {
22
+ event: NotificationEvent;
23
+ jobId: string;
24
+ timestamp: string;
25
+ title: string;
26
+ message: string;
27
+ details?: Record<string, unknown>;
28
+ // Redacted fields for security
29
+ redacted?: string[];
30
+ }
31
+
32
+ export interface NotificationConfig {
33
+ channels: NotificationChannelConfig[];
34
+ // Global settings
35
+ enabled?: boolean;
36
+ redactPatterns?: RegExp[];
37
+ }
38
+
39
+ export interface NotificationChannelConfig {
40
+ id: string;
41
+ type: NotificationChannelType;
42
+ enabled: boolean;
43
+ config: TelegramConfig | NtfyConfig | EmailConfig | WebhookConfig;
44
+ }
45
+
46
+ export type NotificationChannelType = "telegram" | "ntfy" | "email" | "webhook";
47
+
48
+ export interface TelegramConfig {
49
+ botToken: string;
50
+ chatId: string;
51
+ parseMode?: "MarkdownV2" | "HTML" | "Markdown";
52
+ }
53
+
54
+ export interface NtfyConfig {
55
+ server: string; // e.g., "https://ntfy.sh"
56
+ topic: string;
57
+ authToken?: string;
58
+ }
59
+
60
+ export interface EmailConfig {
61
+ smtpHost: string;
62
+ smtpPort: number;
63
+ smtpUser: string;
64
+ smtpPassword: string;
65
+ from: string;
66
+ to: string[];
67
+ tls?: boolean;
68
+ }
69
+
70
+ export interface WebhookConfig {
71
+ url: string;
72
+ method?: "POST" | "PUT";
73
+ headers?: Record<string, string>;
74
+ authToken?: string;
75
+ }
76
+
77
+ export interface NotificationResult {
78
+ success: boolean;
79
+ channel: string;
80
+ error?: string;
81
+ }
82
+
83
+ export interface NotificationContext {
84
+ jobId: string;
85
+ requirement: string;
86
+ taskId?: string;
87
+ taskTitle?: string;
88
+ error?: string;
89
+ }
@@ -0,0 +1,355 @@
1
+ /**
2
+ * Observability Package - Alert Engine
3
+ *
4
+ * Alert rule evaluation and alerting.
5
+ */
6
+
7
+ import type { Alert, AlertAction, AlertCondition, AlertRule } from "./types.js";
8
+ import { Logger } from "./logger.js";
9
+
10
+ // --- Alert Engine Class -------------------------------------------------
11
+
12
+ export class AlertEngine {
13
+ private readonly rules: Map<string, AlertRule> = new Map();
14
+ private readonly activeAlerts: Map<string, Alert> = new Map();
15
+ private readonly alertHistory: Alert[] = [];
16
+ private readonly logger: Logger;
17
+
18
+ constructor(logger?: Logger, _maxHistory = 1000) {
19
+ this.logger = logger ?? new Logger({ level: "warn" });
20
+ }
21
+
22
+ /**
23
+ * Register an alert rule
24
+ */
25
+ registerRule(rule: AlertRule): void {
26
+ this.rules.set(rule.name, { ...rule, enabled: rule.enabled ?? true });
27
+ this.logger.debug(`Alert rule registered: ${rule.name}`);
28
+ }
29
+
30
+ /**
31
+ * Unregister an alert rule
32
+ */
33
+ unregisterRule(name: string): void {
34
+ this.rules.delete(name);
35
+ this.logger.debug(`Alert rule unregistered: ${name}`);
36
+ }
37
+
38
+ /**
39
+ * Get a rule by name
40
+ */
41
+ getRule(name: string): AlertRule | undefined {
42
+ return this.rules.get(name);
43
+ }
44
+
45
+ /**
46
+ * Enable or disable a rule
47
+ */
48
+ setRuleEnabled(name: string, enabled: boolean): void {
49
+ const rule = this.rules.get(name);
50
+ if (rule) {
51
+ rule.enabled = enabled;
52
+ }
53
+ }
54
+
55
+ /**
56
+ * Evaluate all rules
57
+ */
58
+ async evaluate(metrics: Record<string, number>): Promise<Alert[]> {
59
+ const alerts: Alert[] = [];
60
+
61
+ for (const rule of this.rules.values()) {
62
+ if (!rule.enabled) continue;
63
+
64
+ const fired = this.evaluateCondition(rule.condition, metrics);
65
+
66
+ if (fired) {
67
+ // Check cooldown
68
+ const existingAlert = this.activeAlerts.get(rule.name);
69
+ if (existingAlert) {
70
+ const cooldownEnd =
71
+ new Date(existingAlert.triggeredAt).getTime() + rule.cooldown;
72
+ if (Date.now() < cooldownEnd) {
73
+ continue; // Still in cooldown
74
+ }
75
+ }
76
+
77
+ const alert = this.createAlert(rule);
78
+ alerts.push(alert);
79
+ this.activeAlerts.set(rule.name, alert);
80
+ } else {
81
+ // Resolve existing alert
82
+ const existingAlert = this.activeAlerts.get(rule.name);
83
+ if (existingAlert && existingAlert.fired) {
84
+ existingAlert.fired = false;
85
+ existingAlert.resolvedAt = new Date().toISOString();
86
+ }
87
+ }
88
+ }
89
+
90
+ // Trigger actions for new alerts
91
+ for (const alert of alerts) {
92
+ await this.triggerActions(alert);
93
+ }
94
+
95
+ return alerts;
96
+ }
97
+
98
+ /**
99
+ * Evaluate a single condition
100
+ */
101
+ private evaluateCondition(
102
+ condition: AlertCondition,
103
+ metrics: Record<string, number>,
104
+ ): boolean {
105
+ switch (condition.type) {
106
+ case "threshold": {
107
+ const value = metrics[condition.metric] ?? 0;
108
+ switch (condition.operator) {
109
+ case ">":
110
+ return value > condition.value;
111
+ case "<":
112
+ return value < condition.value;
113
+ case ">=":
114
+ return value >= condition.value;
115
+ case "<=":
116
+ return value <= condition.value;
117
+ case "==":
118
+ return value === condition.value;
119
+ default:
120
+ return false;
121
+ }
122
+ }
123
+
124
+ case "rate": {
125
+ // Rate is typically calculated over a window
126
+ // For simplicity, we just check if the metric exists
127
+ const value = metrics[condition.metric] ?? 0;
128
+ return value > condition.threshold;
129
+ }
130
+
131
+ case "error_rate": {
132
+ // Error rate check - would need additional context
133
+ const value = metrics[`${condition.component}_errors_total`] ?? 0;
134
+ const total = metrics[`${condition.component}_total`] ?? 1;
135
+ const rate = total > 0 ? value / total : 0;
136
+ return rate > condition.threshold;
137
+ }
138
+
139
+ default:
140
+ return false;
141
+ }
142
+ }
143
+
144
+ /**
145
+ * Create an alert from a rule
146
+ */
147
+ private createAlert(rule: AlertRule): Alert {
148
+ return {
149
+ ruleName: rule.name,
150
+ severity: rule.severity,
151
+ message: this.formatAlertMessage(rule),
152
+ triggeredAt: new Date().toISOString(),
153
+ fired: true,
154
+ };
155
+ }
156
+
157
+ /**
158
+ * Format alert message
159
+ */
160
+ private formatAlertMessage(rule: AlertRule): string {
161
+ switch (rule.condition.type) {
162
+ case "threshold":
163
+ return `${rule.name}: ${rule.condition.metric} ${rule.condition.operator} ${rule.condition.value}`;
164
+ case "rate":
165
+ return `${rule.name}: ${rule.condition.metric} rate > ${rule.condition.threshold}`;
166
+ case "error_rate":
167
+ return `${rule.name}: ${rule.condition.component} error rate > ${rule.condition.threshold}`;
168
+ default:
169
+ return rule.name;
170
+ }
171
+ }
172
+
173
+ /**
174
+ * Trigger alert actions
175
+ */
176
+ private async triggerActions(alert: Alert): Promise<void> {
177
+ const rule = this.rules.get(alert.ruleName);
178
+ if (!rule) return;
179
+
180
+ for (const action of rule.actions) {
181
+ await this.executeAction(action, alert);
182
+ }
183
+ }
184
+
185
+ /**
186
+ * Execute a single action
187
+ */
188
+ private async executeAction(
189
+ action: AlertAction,
190
+ alert: Alert,
191
+ ): Promise<void> {
192
+ switch (action.type) {
193
+ case "log":
194
+ this.logAlert(alert, action.level);
195
+ break;
196
+
197
+ case "notify":
198
+ await this.sendNotification(alert, action.channel, action.message);
199
+ break;
200
+
201
+ case "webhook":
202
+ await this.sendWebhook(alert, action);
203
+ break;
204
+
205
+ case "execute":
206
+ await this.executeCommand(alert, action.command);
207
+ break;
208
+ }
209
+ }
210
+
211
+ /**
212
+ * Log an alert
213
+ */
214
+ private logAlert(alert: Alert, level: string): void {
215
+ const message = `[ALERT] ${alert.severity.toUpperCase()}: ${alert.message}`;
216
+
217
+ switch (level) {
218
+ case "debug":
219
+ this.logger.debug(message);
220
+ break;
221
+ case "info":
222
+ this.logger.info(message);
223
+ break;
224
+ case "warn":
225
+ this.logger.warn(message);
226
+ break;
227
+ case "error":
228
+ this.logger.error(message);
229
+ break;
230
+ case "fatal":
231
+ this.logger.fatal(message);
232
+ break;
233
+ default:
234
+ this.logger.warn(message);
235
+ }
236
+ }
237
+
238
+ /**
239
+ * Send a notification
240
+ */
241
+ private async sendNotification(
242
+ alert: Alert,
243
+ channel: string,
244
+ message: string,
245
+ ): Promise<void> {
246
+ // In a real implementation, this would send to Slack, PagerDuty, etc.
247
+ this.logger.info(
248
+ `Notification to ${channel}: ${message} - ${alert.message}`,
249
+ );
250
+ }
251
+
252
+ /**
253
+ * Send a webhook
254
+ */
255
+ private async sendWebhook(
256
+ alert: Alert,
257
+ action: { url: string; method?: string; headers?: Record<string, string> },
258
+ ): Promise<void> {
259
+ try {
260
+ const response = (await fetch(action.url, {
261
+ method: action.method ?? "POST",
262
+ headers: {
263
+ "Content-Type": "application/json",
264
+ ...action.headers,
265
+ },
266
+ body: JSON.stringify({
267
+ alert,
268
+ timestamp: new Date().toISOString(),
269
+ }),
270
+ })) as Response & { ok: boolean; status: number };
271
+
272
+ if (!response.ok) {
273
+ this.logger.error(`Webhook failed: ${response.status}`);
274
+ }
275
+ } catch (error) {
276
+ this.logger.error(
277
+ "Webhook error",
278
+ error instanceof Error ? error : new Error(String(error)),
279
+ );
280
+ }
281
+ }
282
+
283
+ /**
284
+ * Execute a command
285
+ */
286
+ private async executeCommand(alert: Alert, command: string): Promise<void> {
287
+ // In a real implementation, this would run a command
288
+ this.logger.info(
289
+ `Executing command: ${command} for alert ${alert.ruleName}`,
290
+ );
291
+ }
292
+
293
+ /**
294
+ * Get active alerts
295
+ */
296
+ getActiveAlerts(): Alert[] {
297
+ return Array.from(this.activeAlerts.values()).filter((a) => a.fired);
298
+ }
299
+
300
+ /**
301
+ * Get alert history
302
+ */
303
+ getAlertHistory(limit?: number): Alert[] {
304
+ const history = [...this.alertHistory].reverse();
305
+ if (limit) {
306
+ return history.slice(0, limit);
307
+ }
308
+ return history;
309
+ }
310
+
311
+ /**
312
+ * Clear alert history
313
+ */
314
+ clearHistory(): void {
315
+ this.alertHistory.length = 0;
316
+ }
317
+
318
+ /**
319
+ * List all rules
320
+ */
321
+ listRules(): AlertRule[] {
322
+ return Array.from(this.rules.values());
323
+ }
324
+
325
+ /**
326
+ * Get rule count
327
+ */
328
+ getRuleCount(): { total: number; enabled: number; disabled: number } {
329
+ let enabled = 0;
330
+ let disabled = 0;
331
+
332
+ for (const rule of this.rules.values()) {
333
+ if (rule.enabled) {
334
+ enabled++;
335
+ } else {
336
+ disabled++;
337
+ }
338
+ }
339
+
340
+ return {
341
+ total: this.rules.size,
342
+ enabled,
343
+ disabled,
344
+ };
345
+ }
346
+ }
347
+
348
+ // --- Factory Function --------------------------------------------------------
349
+
350
+ /**
351
+ * Create an alert engine
352
+ */
353
+ export function createAlertEngine(logger?: Logger): AlertEngine {
354
+ return new AlertEngine(logger);
355
+ }