@agent-watch-ai/edge 0.2.5

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 (364) hide show
  1. package/CHANGELOG.md +251 -0
  2. package/LICENSE +21 -0
  3. package/README.md +168 -0
  4. package/dist/billing/billing-mode.d.ts +16 -0
  5. package/dist/billing/billing-mode.js +139 -0
  6. package/dist/billing/constants/billing.constants.d.ts +37 -0
  7. package/dist/billing/constants/billing.constants.js +38 -0
  8. package/dist/billing/index.d.ts +6 -0
  9. package/dist/billing/index.js +6 -0
  10. package/dist/cli/args.d.ts +29 -0
  11. package/dist/cli/args.js +61 -0
  12. package/dist/cli/constants/cli.constants.d.ts +60 -0
  13. package/dist/cli/constants/cli.constants.js +60 -0
  14. package/dist/cli/context.d.ts +51 -0
  15. package/dist/cli/context.js +108 -0
  16. package/dist/cli/doctor.d.ts +15 -0
  17. package/dist/cli/doctor.js +416 -0
  18. package/dist/cli/hook.d.ts +20 -0
  19. package/dist/cli/hook.js +166 -0
  20. package/dist/cli/index.d.ts +13 -0
  21. package/dist/cli/index.js +8 -0
  22. package/dist/cli/misc.d.ts +31 -0
  23. package/dist/cli/misc.js +63 -0
  24. package/dist/cli/setup.d.ts +32 -0
  25. package/dist/cli/setup.js +298 -0
  26. package/dist/cli/status.d.ts +11 -0
  27. package/dist/cli/status.js +174 -0
  28. package/dist/cli/types/cli.types.d.ts +69 -0
  29. package/dist/cli/types/cli.types.js +1 -0
  30. package/dist/cli/ui.d.ts +41 -0
  31. package/dist/cli/ui.js +78 -0
  32. package/dist/cli/uninstall.d.ts +13 -0
  33. package/dist/cli/uninstall.js +83 -0
  34. package/dist/cli.d.ts +2 -0
  35. package/dist/cli.js +124 -0
  36. package/dist/config/config-store.d.ts +29 -0
  37. package/dist/config/config-store.js +75 -0
  38. package/dist/config/config.d.ts +73 -0
  39. package/dist/config/config.js +115 -0
  40. package/dist/config/constants/config.constants.d.ts +62 -0
  41. package/dist/config/constants/config.constants.js +70 -0
  42. package/dist/config/index.d.ts +10 -0
  43. package/dist/config/index.js +5 -0
  44. package/dist/config/repo-config.d.ts +37 -0
  45. package/dist/config/repo-config.js +178 -0
  46. package/dist/config/schemas/config.schema.d.ts +409 -0
  47. package/dist/config/schemas/config.schema.js +97 -0
  48. package/dist/config/types/config.types.d.ts +33 -0
  49. package/dist/config/types/config.types.js +1 -0
  50. package/dist/core/async.d.ts +20 -0
  51. package/dist/core/async.js +32 -0
  52. package/dist/core/constants/core.constants.d.ts +18 -0
  53. package/dist/core/constants/core.constants.js +18 -0
  54. package/dist/core/env.d.ts +12 -0
  55. package/dist/core/env.js +20 -0
  56. package/dist/core/index.d.ts +13 -0
  57. package/dist/core/index.js +8 -0
  58. package/dist/core/logger.d.ts +27 -0
  59. package/dist/core/logger.js +82 -0
  60. package/dist/core/number.d.ts +33 -0
  61. package/dist/core/number.js +47 -0
  62. package/dist/core/object.d.ts +78 -0
  63. package/dist/core/object.js +127 -0
  64. package/dist/core/pipe.d.ts +55 -0
  65. package/dist/core/pipe.js +81 -0
  66. package/dist/core/types/core.types.d.ts +54 -0
  67. package/dist/core/types/core.types.js +4 -0
  68. package/dist/core/version.d.ts +19 -0
  69. package/dist/core/version.js +35 -0
  70. package/dist/core/which.d.ts +13 -0
  71. package/dist/core/which.js +57 -0
  72. package/dist/enforcement/constants/enforcement.constants.d.ts +23 -0
  73. package/dist/enforcement/constants/enforcement.constants.js +22 -0
  74. package/dist/enforcement/decision-cache.d.ts +57 -0
  75. package/dist/enforcement/decision-cache.js +138 -0
  76. package/dist/enforcement/decision-client.d.ts +14 -0
  77. package/dist/enforcement/decision-client.js +84 -0
  78. package/dist/enforcement/enforcement.d.ts +17 -0
  79. package/dist/enforcement/enforcement.js +90 -0
  80. package/dist/enforcement/index.d.ts +11 -0
  81. package/dist/enforcement/index.js +10 -0
  82. package/dist/enforcement/schemas/enforcement.schema.d.ts +30 -0
  83. package/dist/enforcement/schemas/enforcement.schema.js +36 -0
  84. package/dist/enforcement/types/enforcement.types.d.ts +59 -0
  85. package/dist/enforcement/types/enforcement.types.js +1 -0
  86. package/dist/enrollment/constants/enrollment.constants.d.ts +6 -0
  87. package/dist/enrollment/constants/enrollment.constants.js +6 -0
  88. package/dist/enrollment/enrollment-provider.d.ts +5 -0
  89. package/dist/enrollment/enrollment-provider.js +1 -0
  90. package/dist/enrollment/index.d.ts +7 -0
  91. package/dist/enrollment/index.js +1 -0
  92. package/dist/enrollment/manual-enrollment.d.ts +32 -0
  93. package/dist/enrollment/manual-enrollment.js +72 -0
  94. package/dist/enrollment/types/enrollment.types.d.ts +25 -0
  95. package/dist/enrollment/types/enrollment.types.js +1 -0
  96. package/dist/events/canonical-event.d.ts +10 -0
  97. package/dist/events/canonical-event.js +9 -0
  98. package/dist/events/constants/enrich.constants.d.ts +14 -0
  99. package/dist/events/constants/enrich.constants.js +15 -0
  100. package/dist/events/constants/events.constants.d.ts +35 -0
  101. package/dist/events/constants/events.constants.js +57 -0
  102. package/dist/events/enrich.d.ts +16 -0
  103. package/dist/events/enrich.js +226 -0
  104. package/dist/events/event-id.d.ts +32 -0
  105. package/dist/events/event-id.js +49 -0
  106. package/dist/events/index.d.ts +14 -0
  107. package/dist/events/index.js +5 -0
  108. package/dist/events/llm-call.d.ts +14 -0
  109. package/dist/events/llm-call.js +84 -0
  110. package/dist/events/product-event.d.ts +39 -0
  111. package/dist/events/product-event.js +19 -0
  112. package/dist/events/types/enrich.types.d.ts +25 -0
  113. package/dist/events/types/enrich.types.js +1 -0
  114. package/dist/events/types/events.types.d.ts +112 -0
  115. package/dist/events/types/events.types.js +1 -0
  116. package/dist/events/types/llm-call.types.d.ts +79 -0
  117. package/dist/events/types/llm-call.types.js +1 -0
  118. package/dist/events/types/repo-snapshot.types.d.ts +32 -0
  119. package/dist/events/types/repo-snapshot.types.js +1 -0
  120. package/dist/feature/constants/feature.constants.d.ts +10 -0
  121. package/dist/feature/constants/feature.constants.js +10 -0
  122. package/dist/feature/index.d.ts +6 -0
  123. package/dist/feature/index.js +6 -0
  124. package/dist/feature/ticket-candidates.d.ts +13 -0
  125. package/dist/feature/ticket-candidates.js +26 -0
  126. package/dist/git/constants/git.constants.d.ts +84 -0
  127. package/dist/git/constants/git.constants.js +113 -0
  128. package/dist/git/git-context.d.ts +52 -0
  129. package/dist/git/git-context.js +226 -0
  130. package/dist/git/index.d.ts +9 -0
  131. package/dist/git/index.js +3 -0
  132. package/dist/git/remote-sanitize.d.ts +26 -0
  133. package/dist/git/remote-sanitize.js +92 -0
  134. package/dist/git/repo-snapshot.d.ts +40 -0
  135. package/dist/git/repo-snapshot.js +95 -0
  136. package/dist/git/types/git.types.d.ts +36 -0
  137. package/dist/git/types/git.types.js +1 -0
  138. package/dist/git/types/snapshot.types.d.ts +25 -0
  139. package/dist/git/types/snapshot.types.js +1 -0
  140. package/dist/otlp/constants/otlp.constants.d.ts +84 -0
  141. package/dist/otlp/constants/otlp.constants.js +99 -0
  142. package/dist/otlp/http.d.ts +24 -0
  143. package/dist/otlp/http.js +37 -0
  144. package/dist/otlp/index.d.ts +9 -0
  145. package/dist/otlp/index.js +3 -0
  146. package/dist/otlp/normalize.d.ts +14 -0
  147. package/dist/otlp/normalize.js +404 -0
  148. package/dist/otlp/types/otlp.types.d.ts +69 -0
  149. package/dist/otlp/types/otlp.types.js +1 -0
  150. package/dist/pipeline/constants/pipeline.constants.d.ts +23 -0
  151. package/dist/pipeline/constants/pipeline.constants.js +22 -0
  152. package/dist/pipeline/hook-pipeline.d.ts +14 -0
  153. package/dist/pipeline/hook-pipeline.js +297 -0
  154. package/dist/pipeline/index.d.ts +6 -0
  155. package/dist/pipeline/index.js +1 -0
  156. package/dist/pipeline/types/pipeline.types.d.ts +48 -0
  157. package/dist/pipeline/types/pipeline.types.js +1 -0
  158. package/dist/privacy/constants/privacy.constants.d.ts +23 -0
  159. package/dist/privacy/constants/privacy.constants.js +38 -0
  160. package/dist/privacy/index.d.ts +7 -0
  161. package/dist/privacy/index.js +2 -0
  162. package/dist/privacy/sanitizer.d.ts +20 -0
  163. package/dist/privacy/sanitizer.js +52 -0
  164. package/dist/privacy/types/privacy.types.d.ts +13 -0
  165. package/dist/privacy/types/privacy.types.js +1 -0
  166. package/dist/providers/antigravity/antigravity.adapter.d.ts +54 -0
  167. package/dist/providers/antigravity/antigravity.adapter.js +311 -0
  168. package/dist/providers/antigravity/antigravity.detect.d.ts +25 -0
  169. package/dist/providers/antigravity/antigravity.detect.js +64 -0
  170. package/dist/providers/antigravity/antigravity.hooks.d.ts +24 -0
  171. package/dist/providers/antigravity/antigravity.hooks.js +126 -0
  172. package/dist/providers/antigravity/antigravity.provider.d.ts +2 -0
  173. package/dist/providers/antigravity/antigravity.provider.js +22 -0
  174. package/dist/providers/antigravity/constants/antigravity.constants.d.ts +72 -0
  175. package/dist/providers/antigravity/constants/antigravity.constants.js +75 -0
  176. package/dist/providers/antigravity/schemas/antigravity.schema.d.ts +521 -0
  177. package/dist/providers/antigravity/schemas/antigravity.schema.js +64 -0
  178. package/dist/providers/antigravity/types/antigravity.types.d.ts +13 -0
  179. package/dist/providers/antigravity/types/antigravity.types.js +1 -0
  180. package/dist/providers/claude/claude.adapter.d.ts +15 -0
  181. package/dist/providers/claude/claude.adapter.js +141 -0
  182. package/dist/providers/claude/claude.detect.d.ts +20 -0
  183. package/dist/providers/claude/claude.detect.js +57 -0
  184. package/dist/providers/claude/claude.hooks.d.ts +23 -0
  185. package/dist/providers/claude/claude.hooks.js +94 -0
  186. package/dist/providers/claude/claude.otel.d.ts +95 -0
  187. package/dist/providers/claude/claude.otel.js +331 -0
  188. package/dist/providers/claude/claude.provider.d.ts +2 -0
  189. package/dist/providers/claude/claude.provider.js +26 -0
  190. package/dist/providers/claude/constants/claude.constants.d.ts +34 -0
  191. package/dist/providers/claude/constants/claude.constants.js +54 -0
  192. package/dist/providers/claude/constants/claude.otel.constants.d.ts +17 -0
  193. package/dist/providers/claude/constants/claude.otel.constants.js +17 -0
  194. package/dist/providers/claude/schemas/claude.schema.d.ts +72 -0
  195. package/dist/providers/claude/schemas/claude.schema.js +32 -0
  196. package/dist/providers/claude/types/claude.types.d.ts +3 -0
  197. package/dist/providers/claude/types/claude.types.js +1 -0
  198. package/dist/providers/codex/codex.adapter.d.ts +11 -0
  199. package/dist/providers/codex/codex.adapter.js +106 -0
  200. package/dist/providers/codex/codex.detect.d.ts +30 -0
  201. package/dist/providers/codex/codex.detect.js +58 -0
  202. package/dist/providers/codex/codex.hooks.d.ts +27 -0
  203. package/dist/providers/codex/codex.hooks.js +129 -0
  204. package/dist/providers/codex/codex.otel.d.ts +51 -0
  205. package/dist/providers/codex/codex.otel.js +325 -0
  206. package/dist/providers/codex/codex.provider.d.ts +2 -0
  207. package/dist/providers/codex/codex.provider.js +25 -0
  208. package/dist/providers/codex/constants/codex.constants.d.ts +41 -0
  209. package/dist/providers/codex/constants/codex.constants.js +62 -0
  210. package/dist/providers/codex/constants/codex.otel.constants.d.ts +22 -0
  211. package/dist/providers/codex/constants/codex.otel.constants.js +22 -0
  212. package/dist/providers/codex/schemas/codex.schema.d.ts +70 -0
  213. package/dist/providers/codex/schemas/codex.schema.js +32 -0
  214. package/dist/providers/codex/types/codex.types.d.ts +3 -0
  215. package/dist/providers/codex/types/codex.types.js +1 -0
  216. package/dist/providers/constants/provider.constants.d.ts +33 -0
  217. package/dist/providers/constants/provider.constants.js +33 -0
  218. package/dist/providers/cursor/constants/cursor.constants.d.ts +58 -0
  219. package/dist/providers/cursor/constants/cursor.constants.js +95 -0
  220. package/dist/providers/cursor/cursor.adapter.d.ts +11 -0
  221. package/dist/providers/cursor/cursor.adapter.js +331 -0
  222. package/dist/providers/cursor/cursor.detect.d.ts +23 -0
  223. package/dist/providers/cursor/cursor.detect.js +66 -0
  224. package/dist/providers/cursor/cursor.hooks.d.ts +25 -0
  225. package/dist/providers/cursor/cursor.hooks.js +95 -0
  226. package/dist/providers/cursor/cursor.provider.d.ts +2 -0
  227. package/dist/providers/cursor/cursor.provider.js +27 -0
  228. package/dist/providers/cursor/schemas/cursor.schema.d.ts +130 -0
  229. package/dist/providers/cursor/schemas/cursor.schema.js +62 -0
  230. package/dist/providers/cursor/types/cursor.types.d.ts +3 -0
  231. package/dist/providers/cursor/types/cursor.types.js +1 -0
  232. package/dist/providers/gemini/constants/gemini.constants.d.ts +36 -0
  233. package/dist/providers/gemini/constants/gemini.constants.js +58 -0
  234. package/dist/providers/gemini/constants/gemini.otel.constants.d.ts +34 -0
  235. package/dist/providers/gemini/constants/gemini.otel.constants.js +48 -0
  236. package/dist/providers/gemini/gemini.adapter.d.ts +15 -0
  237. package/dist/providers/gemini/gemini.adapter.js +146 -0
  238. package/dist/providers/gemini/gemini.detect.d.ts +23 -0
  239. package/dist/providers/gemini/gemini.detect.js +78 -0
  240. package/dist/providers/gemini/gemini.hooks.d.ts +22 -0
  241. package/dist/providers/gemini/gemini.hooks.js +93 -0
  242. package/dist/providers/gemini/gemini.otel.d.ts +62 -0
  243. package/dist/providers/gemini/gemini.otel.js +274 -0
  244. package/dist/providers/gemini/gemini.provider.d.ts +2 -0
  245. package/dist/providers/gemini/gemini.provider.js +22 -0
  246. package/dist/providers/gemini/schemas/gemini.schema.d.ts +81 -0
  247. package/dist/providers/gemini/schemas/gemini.schema.js +35 -0
  248. package/dist/providers/gemini/types/gemini.types.d.ts +3 -0
  249. package/dist/providers/gemini/types/gemini.types.js +1 -0
  250. package/dist/providers/index.d.ts +14 -0
  251. package/dist/providers/index.js +8 -0
  252. package/dist/providers/provider.d.ts +16 -0
  253. package/dist/providers/provider.js +149 -0
  254. package/dist/providers/registry.d.ts +12 -0
  255. package/dist/providers/registry.js +23 -0
  256. package/dist/providers/shared/constants/hook-refusal.constants.d.ts +6 -0
  257. package/dist/providers/shared/constants/hook-refusal.constants.js +6 -0
  258. package/dist/providers/shared/constants/tooling.constants.d.ts +25 -0
  259. package/dist/providers/shared/constants/tooling.constants.js +25 -0
  260. package/dist/providers/shared/event-builder.d.ts +85 -0
  261. package/dist/providers/shared/event-builder.js +166 -0
  262. package/dist/providers/shared/hook-config.d.ts +80 -0
  263. package/dist/providers/shared/hook-config.js +164 -0
  264. package/dist/providers/shared/hook-refusal.d.ts +16 -0
  265. package/dist/providers/shared/hook-refusal.js +33 -0
  266. package/dist/providers/shared/install-record.d.ts +75 -0
  267. package/dist/providers/shared/install-record.js +113 -0
  268. package/dist/providers/shared/tooling.d.ts +58 -0
  269. package/dist/providers/shared/tooling.js +103 -0
  270. package/dist/providers/shared/types/adapter.types.d.ts +54 -0
  271. package/dist/providers/shared/types/adapter.types.js +1 -0
  272. package/dist/providers/shared/types/hook-config.types.d.ts +32 -0
  273. package/dist/providers/shared/types/hook-config.types.js +1 -0
  274. package/dist/providers/types/provider.types.d.ts +98 -0
  275. package/dist/providers/types/provider.types.js +1 -0
  276. package/dist/snapshot/branch-selection.d.ts +37 -0
  277. package/dist/snapshot/branch-selection.js +69 -0
  278. package/dist/snapshot/budget.d.ts +41 -0
  279. package/dist/snapshot/budget.js +67 -0
  280. package/dist/snapshot/constants/snapshot-stages.constants.d.ts +11 -0
  281. package/dist/snapshot/constants/snapshot-stages.constants.js +11 -0
  282. package/dist/snapshot/constants/snapshot.constants.d.ts +56 -0
  283. package/dist/snapshot/constants/snapshot.constants.js +56 -0
  284. package/dist/snapshot/index.d.ts +16 -0
  285. package/dist/snapshot/index.js +6 -0
  286. package/dist/snapshot/snapshot-event.d.ts +17 -0
  287. package/dist/snapshot/snapshot-event.js +66 -0
  288. package/dist/snapshot/snapshot-pipeline.d.ts +14 -0
  289. package/dist/snapshot/snapshot-pipeline.js +163 -0
  290. package/dist/snapshot/snapshot-state.d.ts +55 -0
  291. package/dist/snapshot/snapshot-state.js +100 -0
  292. package/dist/snapshot/types/snapshot.types.d.ts +86 -0
  293. package/dist/snapshot/types/snapshot.types.js +1 -0
  294. package/dist/storage/atomic-file.d.ts +25 -0
  295. package/dist/storage/atomic-file.js +76 -0
  296. package/dist/storage/constants/storage.constants.d.ts +34 -0
  297. package/dist/storage/constants/storage.constants.js +35 -0
  298. package/dist/storage/index.d.ts +10 -0
  299. package/dist/storage/index.js +5 -0
  300. package/dist/storage/install-state.d.ts +20 -0
  301. package/dist/storage/install-state.js +40 -0
  302. package/dist/storage/json-file.d.ts +13 -0
  303. package/dist/storage/json-file.js +31 -0
  304. package/dist/storage/lock.d.ts +15 -0
  305. package/dist/storage/lock.js +70 -0
  306. package/dist/storage/paths.d.ts +14 -0
  307. package/dist/storage/paths.js +42 -0
  308. package/dist/storage/schemas/storage.schema.d.ts +128 -0
  309. package/dist/storage/schemas/storage.schema.js +27 -0
  310. package/dist/storage/types/storage.types.d.ts +36 -0
  311. package/dist/storage/types/storage.types.js +1 -0
  312. package/dist/transport/constants/transport.constants.d.ts +47 -0
  313. package/dist/transport/constants/transport.constants.js +47 -0
  314. package/dist/transport/cooldown.d.ts +35 -0
  315. package/dist/transport/cooldown.js +62 -0
  316. package/dist/transport/delivery-stats.d.ts +65 -0
  317. package/dist/transport/delivery-stats.js +186 -0
  318. package/dist/transport/delivery.d.ts +26 -0
  319. package/dist/transport/delivery.js +80 -0
  320. package/dist/transport/headers.d.ts +12 -0
  321. package/dist/transport/headers.js +19 -0
  322. package/dist/transport/http-transport.d.ts +39 -0
  323. package/dist/transport/http-transport.js +106 -0
  324. package/dist/transport/index.d.ts +13 -0
  325. package/dist/transport/index.js +7 -0
  326. package/dist/transport/queue.d.ts +177 -0
  327. package/dist/transport/queue.js +474 -0
  328. package/dist/transport/schemas/queue.schema.d.ts +30 -0
  329. package/dist/transport/schemas/queue.schema.js +18 -0
  330. package/dist/transport/transport.d.ts +6 -0
  331. package/dist/transport/transport.js +1 -0
  332. package/dist/transport/types/transport.types.d.ts +102 -0
  333. package/dist/transport/types/transport.types.js +1 -0
  334. package/dist/turns/aggregate-usage.d.ts +20 -0
  335. package/dist/turns/aggregate-usage.js +269 -0
  336. package/dist/turns/claude-transcript.d.ts +18 -0
  337. package/dist/turns/claude-transcript.js +80 -0
  338. package/dist/turns/constants/turns.constants.d.ts +69 -0
  339. package/dist/turns/constants/turns.constants.js +86 -0
  340. package/dist/turns/cursor-transcript.d.ts +21 -0
  341. package/dist/turns/cursor-transcript.js +66 -0
  342. package/dist/turns/index.d.ts +17 -0
  343. package/dist/turns/index.js +7 -0
  344. package/dist/turns/transcript.d.ts +74 -0
  345. package/dist/turns/transcript.js +188 -0
  346. package/dist/turns/turn-state.d.ts +94 -0
  347. package/dist/turns/turn-state.js +234 -0
  348. package/dist/turns/turn-summary.d.ts +27 -0
  349. package/dist/turns/turn-summary.js +164 -0
  350. package/dist/turns/turn-tracker.d.ts +14 -0
  351. package/dist/turns/turn-tracker.js +521 -0
  352. package/dist/turns/types/aggregate-usage.types.d.ts +26 -0
  353. package/dist/turns/types/aggregate-usage.types.js +1 -0
  354. package/dist/turns/types/transcript.types.d.ts +41 -0
  355. package/dist/turns/types/transcript.types.js +1 -0
  356. package/dist/turns/types/turn-state.types.d.ts +37 -0
  357. package/dist/turns/types/turn-state.types.js +1 -0
  358. package/dist/turns/types/turn-summary.types.d.ts +106 -0
  359. package/dist/turns/types/turn-summary.types.js +1 -0
  360. package/dist/turns/types/turn-tracker.types.d.ts +27 -0
  361. package/dist/turns/types/turn-tracker.types.js +1 -0
  362. package/example/README.md +43 -0
  363. package/example/server.mjs +240 -0
  364. package/package.json +89 -0
@@ -0,0 +1,39 @@
1
+ import type { ProductEvent } from '../events/product-event.js';
2
+ import type { DeliveryResult, EventTransport, HttpTransportOptions } from './types/transport.types.js';
3
+ export type { HttpTransportOptions } from './types/transport.types.js';
4
+ /**
5
+ * POST `{events: [...]}` to the configured backend.
6
+ *
7
+ * Bounded by a short timeout: this runs on the coding agent's critical path, so
8
+ * a slow backend must cost the developer milliseconds, not seconds.
9
+ */
10
+ export declare class HttpTransport implements EventTransport {
11
+ private readonly options;
12
+ private readonly fetchFn;
13
+ /**
14
+ * Bind the transport to one backend.
15
+ *
16
+ * @param options - Destination, credentials, timeout and fetch override.
17
+ */
18
+ constructor(options: HttpTransportOptions);
19
+ /**
20
+ * Where this transport sends events.
21
+ *
22
+ * @returns The events URL.
23
+ */
24
+ get destination(): string;
25
+ /**
26
+ * Send one batch.
27
+ *
28
+ * @param events - Product events to deliver.
29
+ * @returns Whether the backend took them, and whether a failure is worth
30
+ * retrying.
31
+ */
32
+ send(events: readonly ProductEvent[]): Promise<DeliveryResult>;
33
+ /**
34
+ * Headers for one request.
35
+ *
36
+ * @returns The header map.
37
+ */
38
+ private headers;
39
+ }
@@ -0,0 +1,106 @@
1
+ import { CONTENT_TYPE_HEADER, JSON_CONTENT_TYPE, RETRYABLE_STATUSES } from './constants/transport.constants.js';
2
+ import { edgeHeaders } from './headers.js';
3
+ /**
4
+ * POST `{events: [...]}` to the configured backend.
5
+ *
6
+ * Bounded by a short timeout: this runs on the coding agent's critical path, so
7
+ * a slow backend must cost the developer milliseconds, not seconds.
8
+ */
9
+ export class HttpTransport {
10
+ options;
11
+ fetchFn;
12
+ /**
13
+ * Bind the transport to one backend.
14
+ *
15
+ * @param options - Destination, credentials, timeout and fetch override.
16
+ */
17
+ constructor(options) {
18
+ this.options = options;
19
+ this.fetchFn = options.fetchFn ?? fetch;
20
+ }
21
+ /**
22
+ * Where this transport sends events.
23
+ *
24
+ * @returns The events URL.
25
+ */
26
+ get destination() {
27
+ return this.options.eventsUrl;
28
+ }
29
+ /**
30
+ * Send one batch.
31
+ *
32
+ * @param events - Product events to deliver.
33
+ * @returns Whether the backend took them, and whether a failure is worth
34
+ * retrying.
35
+ */
36
+ async send(events) {
37
+ if (events.length === 0)
38
+ return { ok: true, retryable: false };
39
+ try {
40
+ const response = await this.fetchFn(this.options.eventsUrl, {
41
+ method: 'POST',
42
+ headers: this.headers(),
43
+ body: JSON.stringify({ events }),
44
+ signal: AbortSignal.timeout(this.options.timeoutMs)
45
+ });
46
+ if (response.ok) {
47
+ return { ok: true, status: response.status, retryable: false, counters: await readCounters(response) };
48
+ }
49
+ return { ok: false, status: response.status, retryable: isRetryableStatus(response.status), error: `HTTP ${response.status}` };
50
+ }
51
+ catch (error) {
52
+ // Never include response or request bodies in errors: they carry event
53
+ // content, and this string ends up in logs.
54
+ return { ok: false, retryable: true, error: error.name || 'network error' };
55
+ }
56
+ }
57
+ /**
58
+ * Headers for one request.
59
+ *
60
+ * @returns The header map.
61
+ */
62
+ headers() {
63
+ return {
64
+ [CONTENT_TYPE_HEADER]: JSON_CONTENT_TYPE,
65
+ ...edgeHeaders(this.options.token, this.options.installationId)
66
+ };
67
+ }
68
+ }
69
+ /**
70
+ * Per-event counters from an accepted batch.
71
+ *
72
+ * A 202 can still carry per-event rejections, and the batch "succeeding" while
73
+ * events inside it were dropped is exactly the case the caller must see. A
74
+ * backend that returns no JSON body is treated as counter-less, not failed.
75
+ *
76
+ * @param response - The backend's response.
77
+ * @returns The counters, or undefined when the body carried none.
78
+ */
79
+ async function readCounters(response) {
80
+ try {
81
+ const body = (await response.json());
82
+ const numeric = (key) => (typeof body[key] === 'number' ? body[key] : 0);
83
+ return {
84
+ accepted: numeric('accepted'),
85
+ duplicate: numeric('duplicate'),
86
+ rejected: numeric('rejected'),
87
+ failed: numeric('failed')
88
+ };
89
+ }
90
+ catch {
91
+ return undefined;
92
+ }
93
+ }
94
+ /**
95
+ * Whether a failing status is worth retrying.
96
+ *
97
+ * Auth and rate-limit problems are usually transient misconfiguration, so they
98
+ * count as retryable; retries are capped by `delivery.maxAttempts`, so they
99
+ * cannot accumulate forever.
100
+ *
101
+ * @param status - HTTP status.
102
+ * @returns True when the batch should be queued for another attempt.
103
+ */
104
+ function isRetryableStatus(status) {
105
+ return status >= 500 || RETRYABLE_STATUSES.has(status);
106
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * Getting product records to the backend without ever losing one and without
3
+ * ever making the coding agent wait: one bounded direct send, a persisted
4
+ * circuit breaker, and a file-per-event offline queue behind it.
5
+ */
6
+ export type { DeliveryCounters, DeliveryOutcome, DeliveryResult, DeliveryStatsSnapshot, DrainStats, DrainStatsRecorder, EventTransport, HttpTransportOptions, QueueEntry, QueueOptions } from './types/transport.types.js';
7
+ export { ANY_DESTINATION, BACKEND_COOLDOWN_MS } from './constants/transport.constants.js';
8
+ export { HttpTransport } from './http-transport.js';
9
+ export { edgeHeaders } from './headers.js';
10
+ export { EventQueue } from './queue.js';
11
+ export { BackendCooldown } from './cooldown.js';
12
+ export { DeliveryStats } from './delivery-stats.js';
13
+ export { deliverEvents } from './delivery.js';
@@ -0,0 +1,7 @@
1
+ export { ANY_DESTINATION, BACKEND_COOLDOWN_MS } from './constants/transport.constants.js';
2
+ export { HttpTransport } from './http-transport.js';
3
+ export { edgeHeaders } from './headers.js';
4
+ export { EventQueue } from './queue.js';
5
+ export { BackendCooldown } from './cooldown.js';
6
+ export { DeliveryStats } from './delivery-stats.js';
7
+ export { deliverEvents } from './delivery.js';
@@ -0,0 +1,177 @@
1
+ import type { ProductEvent } from '../events/product-event.js';
2
+ import type { DrainStats, DrainStatsRecorder, EventTransport, QueueOptions } from './types/transport.types.js';
3
+ export { ANY_DESTINATION } from './constants/transport.constants.js';
4
+ export type { DrainStats, DrainStatsRecorder, QueueEntry, QueueOptions } from './types/transport.types.js';
5
+ /**
6
+ * File-per-event offline queue.
7
+ *
8
+ * The filename *is* the deterministic event id, which is what makes enqueueing
9
+ * idempotent: the same event can never be queued twice, however many hooks race
10
+ * to write it.
11
+ */
12
+ export declare class EventQueue {
13
+ private readonly options;
14
+ private readonly now;
15
+ /**
16
+ * Bind the queue to its directories and bounds.
17
+ *
18
+ * @param options - Directories, bounds and the clock.
19
+ */
20
+ constructor(options: QueueOptions);
21
+ /**
22
+ * Persist events for a later attempt.
23
+ *
24
+ * @param events - Events to keep.
25
+ * @param destination - Events URL they are pinned to, when one is configured.
26
+ */
27
+ enqueue(events: readonly ProductEvent[], destination?: string): Promise<void>;
28
+ /**
29
+ * How many events are waiting.
30
+ *
31
+ * @returns The entry count.
32
+ */
33
+ pendingCount(): Promise<number>;
34
+ /**
35
+ * Age of the oldest waiting event.
36
+ *
37
+ * @returns Milliseconds, or undefined when the queue is empty.
38
+ */
39
+ oldestPendingAgeMs(): Promise<number | undefined>;
40
+ /**
41
+ * Send due queued events through the transport.
42
+ *
43
+ * Serialized by a lock so concurrent hook invocations cannot double-send, and
44
+ * bounded by maxBatch because this runs inside the agent's hook process.
45
+ *
46
+ * The recorder's methods must not throw: failures have to be swallowed by the
47
+ * implementation, because drain is on the critical path and is not wrapped
48
+ * against recorder errors.
49
+ *
50
+ * @param transport - Where to send.
51
+ * @param maxBatch - Ceiling on events sent in one pass.
52
+ * @param statsRecorder - Optional sink for what this pass lost.
53
+ * @returns What the pass sent, failed, dropped and had rejected.
54
+ */
55
+ drain(transport: EventTransport, maxBatch: number, statsRecorder?: DrainStatsRecorder): Promise<DrainStats>;
56
+ /**
57
+ * Re-pin entries queued for one destination to another.
58
+ *
59
+ * Setup calls this — with the user's explicit consent — after the backend URL
60
+ * changes, so the backlog follows instead of expiring pinned to a URL nothing
61
+ * will ever drain. Entries pinned to any *other* backend stay untouched: this
62
+ * re-routes one reconfigured destination, it is not a license to replay one
63
+ * backend's data to another.
64
+ *
65
+ * Runs under the drain lock so a concurrent drain cannot resurrect the old
66
+ * destination from a stale in-memory copy.
67
+ *
68
+ * @param destination - The new events URL.
69
+ * @param previousDestination - The URL being replaced.
70
+ * @returns False when the lock never freed and nothing was re-pinned.
71
+ */
72
+ retarget(destination: string, previousDestination: string): Promise<boolean>;
73
+ /**
74
+ * Entries pinned to exactly this destination; legacy and ANY entries are not
75
+ * counted, because they are not stranded.
76
+ *
77
+ * @param destination - Events URL to count for.
78
+ * @returns The entry count.
79
+ */
80
+ pendingFor(destination: string): Promise<number>;
81
+ /**
82
+ * Entries due for this transport, dropping the ones that can never be sent.
83
+ *
84
+ * @param transport - Where the pass will send.
85
+ * @param nowMs - This pass's clock reading.
86
+ * @returns The due entries and what collecting them dropped.
87
+ */
88
+ private collectDue;
89
+ /**
90
+ * Send one batch, isolating a poison entry when the backend refuses it.
91
+ *
92
+ * @param transport - Where to send.
93
+ * @param batch - Entries to send.
94
+ * @param nowMs - This pass's clock reading.
95
+ * @returns What the send accomplished and cost.
96
+ */
97
+ private sendBatch;
98
+ /**
99
+ * Retry a refused batch one entry at a time.
100
+ *
101
+ * The backend rejected the batch outright, but that verdict belongs to at most
102
+ * a few events. Sending entries alone stops one poison record taking its
103
+ * healthy co-batched neighbours down with it. The probes are capped: drain runs
104
+ * inside the agent's hook process and each send can cost the full transport
105
+ * timeout, so the remainder keeps its backoff and is probed on a later drain.
106
+ *
107
+ * @param transport - Where to send.
108
+ * @param batch - Entries the batch send refused.
109
+ * @param nowMs - This pass's clock reading.
110
+ * @returns What the probes accomplished and cost.
111
+ */
112
+ private isolateBatch;
113
+ /**
114
+ * Acquire the drain lock, waiting a bounded time.
115
+ *
116
+ * @returns The release function, or undefined on timeout.
117
+ */
118
+ private waitForDrainLock;
119
+ /**
120
+ * Back a failed entry off, or drop it once its budget is spent.
121
+ *
122
+ * Even a "permanent" HTTP status can be a transient route or schema mismatch
123
+ * on the backend, so an entry is dropped only once maxAttempts (or the age
124
+ * bound) is exhausted — never on the first refusal.
125
+ *
126
+ * @param file - The entry's file.
127
+ * @param entry - The entry.
128
+ * @param nowMs - This pass's clock reading.
129
+ * @returns Whether the entry was backed off or lost.
130
+ */
131
+ private recordFailure;
132
+ /**
133
+ * File one event is queued in.
134
+ *
135
+ * @param eventId - The deterministic event id.
136
+ * @returns Absolute file path.
137
+ */
138
+ private fileFor;
139
+ /**
140
+ * Queue filenames, sorted.
141
+ *
142
+ * @returns The names, or an empty list when the directory is absent.
143
+ */
144
+ private listFiles;
145
+ /**
146
+ * Read and validate one entry.
147
+ *
148
+ * @param file - Entry file.
149
+ * @returns The entry, or undefined when it cannot be used.
150
+ */
151
+ private readEntry;
152
+ /**
153
+ * Whether an entry has outlived the age bound.
154
+ *
155
+ * @param entry - The entry.
156
+ * @param nowMs - This pass's clock reading.
157
+ * @returns True when it should be dropped.
158
+ */
159
+ private isExpired;
160
+ /**
161
+ * Keep the queue bounded, sacrificing the entries that have waited longest.
162
+ *
163
+ * The oldest are the least likely to still be deliverable, and an unbounded
164
+ * queue on a developer machine is a disk-space bug.
165
+ */
166
+ private enforceBound;
167
+ /**
168
+ * When an entry was first queued, falling back to the file clock.
169
+ *
170
+ * An unreadable entry still has to age out, or it would pin the queue at its
171
+ * bound forever.
172
+ *
173
+ * @param full - Entry file.
174
+ * @returns Epoch milliseconds, or undefined when the file vanished.
175
+ */
176
+ private queuedAt;
177
+ }