@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,36 @@
1
+ /** Repository context attached to canonical events. */
2
+ export interface GitContext {
3
+ readonly repositoryRoot?: string;
4
+ readonly repository?: string;
5
+ readonly remote?: string;
6
+ readonly repositoryHash?: string;
7
+ readonly branch?: string;
8
+ readonly commit?: string;
9
+ readonly workingDirectory?: string;
10
+ readonly changedFiles?: readonly string[];
11
+ }
12
+ export interface GitContextOptions {
13
+ readonly cwd: string;
14
+ readonly includeChangedFiles: boolean;
15
+ readonly timeoutMs?: number;
16
+ readonly maxChangedFiles?: number;
17
+ /**
18
+ * Resolve only the repository root (one git process) and skip
19
+ * branch/commit/remote/status. Hooks on the agent's critical path need the
20
+ * root for path rewriting but none of the expensive details — those are only
21
+ * consumed when a turn closes.
22
+ */
23
+ readonly rootOnly?: boolean;
24
+ }
25
+ /** Runs one git command and returns its trimmed stdout, or undefined. */
26
+ export type GitRunner = (args: readonly string[], cwd: string, timeoutMs: number, home?: string) => Promise<string | undefined>;
27
+ export interface GitUserEmailOptions {
28
+ readonly timeoutMs?: number;
29
+ readonly home?: string;
30
+ readonly run?: GitRunner;
31
+ }
32
+ /** Host and path of a remote, once credentials are stripped. */
33
+ export interface RemoteParts {
34
+ readonly host: string;
35
+ readonly path: string;
36
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,25 @@
1
+ /** One branch as `for-each-ref` reported it, before any log ran. */
2
+ export interface BranchRef {
3
+ readonly name: string;
4
+ readonly headSha: string;
5
+ readonly lastCommitAt?: string;
6
+ }
7
+ /** One commit in a branch's delta against its default branch. */
8
+ export interface BranchCommit {
9
+ readonly sha: string;
10
+ readonly subject: string;
11
+ readonly authoredAt?: string;
12
+ }
13
+ /** A branch with the commits that are its own. */
14
+ export interface SnapshotBranch extends BranchRef {
15
+ readonly commits: readonly BranchCommit[];
16
+ }
17
+ export interface CollectRefsOptions {
18
+ readonly cwd: string;
19
+ readonly branchCount: number;
20
+ }
21
+ export interface CollectCommitsOptions {
22
+ readonly cwd: string;
23
+ readonly defaultBranch?: string;
24
+ readonly commitCount: number;
25
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,84 @@
1
+ /**
2
+ * OTLP attribute vocabularies and provider-detection patterns.
3
+ *
4
+ * The names below are the parts most likely to silently disagree with the
5
+ * platform's own copy of this logic (`@agent-watch/otlp`) when the two drift,
6
+ * so they live together in one file rather than being scattered through the
7
+ * normalizer.
8
+ */
9
+ /** OTLP/JSON envelope keys. */
10
+ export declare const RESOURCE_LOGS_KEY = "resourceLogs";
11
+ export declare const SCOPE_LOGS_KEY = "scopeLogs";
12
+ export declare const LOG_RECORDS_KEY = "logRecords";
13
+ /** Value wrappers proto3 JSON uses for an OTLP AnyValue, in read order. */
14
+ export declare const OTLP_VALUE_KEYS: readonly ["stringValue", "intValue", "doubleValue", "boolValue"];
15
+ /** Where an event's name and type may be found. */
16
+ export declare const EVENT_NAME_KEYS: readonly ["event.name", "name"];
17
+ export declare const EVENT_TYPE_KEYS: readonly ["event.type", "event.kind", "type", "sse_event.type", "response.type"];
18
+ /** Session identity, per provider: Claude only ever uses the dotted form. */
19
+ export declare const CLAUDE_SESSION_KEYS: readonly ["session.id"];
20
+ export declare const GENERIC_SESSION_KEYS: readonly ["conversation.id", "thread.id", "session.id"];
21
+ export declare const CODEX_SESSION_KEYS: readonly ["conversation.id", "thread.id"];
22
+ export declare const THREAD_KEYS: readonly ["thread.id"];
23
+ /** Gemini names the turn `prompt_id`; the dotted form is Claude's. */
24
+ export declare const TURN_KEYS: readonly ["prompt.id", "prompt_id", "turn.id", "turn_id"];
25
+ export declare const REQUEST_ID_KEYS: readonly ["request_id", "request.id", "response.id", "response_id", "client_request_id"];
26
+ export declare const SEQUENCE_KEYS: readonly ["event.sequence", "sequence"];
27
+ export declare const TIMESTAMP_KEYS: readonly ["event.timestamp", "timestamp"];
28
+ export declare const MODEL_KEYS: readonly ["model", "gen_ai.request.model", "gen_ai.response.model"];
29
+ export declare const DURATION_KEYS: readonly ["duration_ms", "request.duration_ms", "codex.api_request.duration_ms"];
30
+ export declare const COST_KEYS: readonly ["cost_usd", "cost.usd"];
31
+ export declare const ERROR_KEYS: readonly ["error", "error.message"];
32
+ export declare const BILLING_MODE_KEYS: readonly ["billing_mode", "auth_mode"];
33
+ export declare const AGENT_ID_KEYS: readonly ["agent_id", "agent.id", "subagent.id"];
34
+ export declare const AGENT_TYPE_KEYS: readonly ["query_source", "agent.name", "agent.type", "subagent.type"];
35
+ export declare const PROVIDER_SYSTEM_KEYS: readonly ["gen_ai.system", "gen_ai.provider.name"];
36
+ /**
37
+ * Token-count attribute names, under every name an agent gives them.
38
+ *
39
+ * `cached_content_token_count`, `thoughts_token_count` and `total_token_count`
40
+ * are Gemini's; omitting the first prices a cache read at full input cost.
41
+ */
42
+ export declare const INPUT_TOKEN_KEYS: readonly ["input_tokens", "input_token_count", "gen_ai.usage.input_tokens", "codex.turn.token_usage.input_tokens"];
43
+ export declare const CACHED_INPUT_TOKEN_KEYS: readonly ["cache_read_tokens", "cached_input_tokens", "cached_input_token_count", "cached_content_token_count", "gen_ai.usage.cache_read.input_tokens"];
44
+ export declare const CACHE_CREATION_TOKEN_KEYS: readonly ["cache_creation_tokens", "cache_write_input_tokens", "gen_ai.usage.cache_write.input_tokens"];
45
+ export declare const OUTPUT_TOKEN_KEYS: readonly ["output_tokens", "output_token_count", "gen_ai.usage.output_tokens", "codex.turn.token_usage.output_tokens"];
46
+ export declare const REASONING_TOKEN_KEYS: readonly ["reasoning_output_tokens", "reasoning_token_count", "thoughts_token_count", "codex.usage.reasoning_output_tokens"];
47
+ export declare const TOTAL_TOKEN_KEYS: readonly ["total_tokens", "total_token_count", "codex.usage.total_tokens", "codex.turn.token_usage.total_tokens"];
48
+ /** Log-record fields read directly rather than from attributes. */
49
+ export declare const TRACE_ID_KEYS: readonly ["traceId"];
50
+ export declare const SPAN_ID_KEYS: readonly ["spanId"];
51
+ export declare const TIME_NANO_KEYS: readonly ["timeUnixNano", "observedTimeUnixNano"];
52
+ /** Provider-detection patterns. */
53
+ export declare const RE_CODEX_EVENT: RegExp;
54
+ export declare const RE_RESPONSE_COMPLETED: RegExp;
55
+ export declare const RE_CLAUDE_EVENT: RegExp;
56
+ export declare const RE_GEMINI_EVENT: RegExp;
57
+ export declare const RE_API_REQUEST: RegExp;
58
+ export declare const RE_CODEX_COMPLETED: RegExp;
59
+ export declare const RE_GEMINI_COMPLETED: RegExp;
60
+ /**
61
+ * `gen_ai.system` / `gen_ai.provider.name` values that mean Gemini.
62
+ *
63
+ * Gemini CLI's real event names are `gemini_cli.api_request`,
64
+ * `gemini_cli.api_response` and `gemini_cli.api_error`, and the attribute that
65
+ * names the provider is `gen_ai.provider.name` (`gcp.gen_ai` / `gcp.vertex_ai`),
66
+ * never `gen_ai.system`.
67
+ */
68
+ export declare const GEMINI_SYSTEM_VALUES: ReadonlySet<string>;
69
+ /** Public provider label per detected internal provider. */
70
+ export declare const CANONICAL_PROVIDER_NAMES: Readonly<Record<string, string>>;
71
+ /** Default surface when correlation supplies none. */
72
+ export declare const DEFAULT_SURFACE = "cli";
73
+ /** Prefix on a call id we had to derive ourselves. */
74
+ export declare const DERIVED_CALL_ID_PREFIX = "derived_";
75
+ /** Hex characters kept from a derived call id's digest. */
76
+ export declare const DERIVED_CALL_ID_HEX_LENGTH = 40;
77
+ /** Nanoseconds per millisecond, for OTLP timestamps. */
78
+ export declare const NANOS_PER_MILLI = 1000000n;
79
+ /** proto3 JSON encodes an unset uint64 as the string "0". */
80
+ export declare const UNSET_TIME_VALUES: ReadonlySet<string | number>;
81
+ /** OTLP/HTTP signals the example receiver serves. */
82
+ export declare const OTLP_HTTP_SIGNALS: readonly ["logs", "traces", "metrics"];
83
+ /** The only OTLP/HTTP routes the example receiver answers on. */
84
+ export declare const RE_OTLP_HTTP_PATH: RegExp;
@@ -0,0 +1,99 @@
1
+ /**
2
+ * OTLP attribute vocabularies and provider-detection patterns.
3
+ *
4
+ * The names below are the parts most likely to silently disagree with the
5
+ * platform's own copy of this logic (`@agent-watch/otlp`) when the two drift,
6
+ * so they live together in one file rather than being scattered through the
7
+ * normalizer.
8
+ */
9
+ /** OTLP/JSON envelope keys. */
10
+ export const RESOURCE_LOGS_KEY = 'resourceLogs';
11
+ export const SCOPE_LOGS_KEY = 'scopeLogs';
12
+ export const LOG_RECORDS_KEY = 'logRecords';
13
+ /** Value wrappers proto3 JSON uses for an OTLP AnyValue, in read order. */
14
+ export const OTLP_VALUE_KEYS = ['stringValue', 'intValue', 'doubleValue', 'boolValue'];
15
+ /** Where an event's name and type may be found. */
16
+ export const EVENT_NAME_KEYS = ['event.name', 'name'];
17
+ export const EVENT_TYPE_KEYS = ['event.type', 'event.kind', 'type', 'sse_event.type', 'response.type'];
18
+ /** Session identity, per provider: Claude only ever uses the dotted form. */
19
+ export const CLAUDE_SESSION_KEYS = ['session.id'];
20
+ export const GENERIC_SESSION_KEYS = ['conversation.id', 'thread.id', 'session.id'];
21
+ export const CODEX_SESSION_KEYS = ['conversation.id', 'thread.id'];
22
+ export const THREAD_KEYS = ['thread.id'];
23
+ /** Gemini names the turn `prompt_id`; the dotted form is Claude's. */
24
+ export const TURN_KEYS = ['prompt.id', 'prompt_id', 'turn.id', 'turn_id'];
25
+ export const REQUEST_ID_KEYS = ['request_id', 'request.id', 'response.id', 'response_id', 'client_request_id'];
26
+ export const SEQUENCE_KEYS = ['event.sequence', 'sequence'];
27
+ export const TIMESTAMP_KEYS = ['event.timestamp', 'timestamp'];
28
+ export const MODEL_KEYS = ['model', 'gen_ai.request.model', 'gen_ai.response.model'];
29
+ export const DURATION_KEYS = ['duration_ms', 'request.duration_ms', 'codex.api_request.duration_ms'];
30
+ export const COST_KEYS = ['cost_usd', 'cost.usd'];
31
+ export const ERROR_KEYS = ['error', 'error.message'];
32
+ export const BILLING_MODE_KEYS = ['billing_mode', 'auth_mode'];
33
+ export const AGENT_ID_KEYS = ['agent_id', 'agent.id', 'subagent.id'];
34
+ export const AGENT_TYPE_KEYS = ['query_source', 'agent.name', 'agent.type', 'subagent.type'];
35
+ export const PROVIDER_SYSTEM_KEYS = ['gen_ai.system', 'gen_ai.provider.name'];
36
+ /**
37
+ * Token-count attribute names, under every name an agent gives them.
38
+ *
39
+ * `cached_content_token_count`, `thoughts_token_count` and `total_token_count`
40
+ * are Gemini's; omitting the first prices a cache read at full input cost.
41
+ */
42
+ export const INPUT_TOKEN_KEYS = ['input_tokens', 'input_token_count', 'gen_ai.usage.input_tokens', 'codex.turn.token_usage.input_tokens'];
43
+ export const CACHED_INPUT_TOKEN_KEYS = [
44
+ 'cache_read_tokens',
45
+ 'cached_input_tokens',
46
+ 'cached_input_token_count',
47
+ 'cached_content_token_count',
48
+ 'gen_ai.usage.cache_read.input_tokens'
49
+ ];
50
+ export const CACHE_CREATION_TOKEN_KEYS = ['cache_creation_tokens', 'cache_write_input_tokens', 'gen_ai.usage.cache_write.input_tokens'];
51
+ export const OUTPUT_TOKEN_KEYS = ['output_tokens', 'output_token_count', 'gen_ai.usage.output_tokens', 'codex.turn.token_usage.output_tokens'];
52
+ export const REASONING_TOKEN_KEYS = [
53
+ 'reasoning_output_tokens',
54
+ 'reasoning_token_count',
55
+ 'thoughts_token_count',
56
+ 'codex.usage.reasoning_output_tokens'
57
+ ];
58
+ export const TOTAL_TOKEN_KEYS = ['total_tokens', 'total_token_count', 'codex.usage.total_tokens', 'codex.turn.token_usage.total_tokens'];
59
+ /** Log-record fields read directly rather than from attributes. */
60
+ export const TRACE_ID_KEYS = ['traceId'];
61
+ export const SPAN_ID_KEYS = ['spanId'];
62
+ export const TIME_NANO_KEYS = ['timeUnixNano', 'observedTimeUnixNano'];
63
+ /** Provider-detection patterns. */
64
+ export const RE_CODEX_EVENT = /codex[._](sse_event|api_request)/;
65
+ export const RE_RESPONSE_COMPLETED = /response\.completed/;
66
+ export const RE_CLAUDE_EVENT = /claude_code[._](api_request|llm_request)/;
67
+ export const RE_GEMINI_EVENT = /gemini[._\w]*[._](api_request|api_response|api_error|llm_request)|gemini_code/;
68
+ export const RE_API_REQUEST = /api_request/;
69
+ export const RE_CODEX_COMPLETED = /codex[._]api_request|response\.completed/;
70
+ export const RE_GEMINI_COMPLETED = /api_response|api_error|generate_content|generateContent|response\.completed/;
71
+ /**
72
+ * `gen_ai.system` / `gen_ai.provider.name` values that mean Gemini.
73
+ *
74
+ * Gemini CLI's real event names are `gemini_cli.api_request`,
75
+ * `gemini_cli.api_response` and `gemini_cli.api_error`, and the attribute that
76
+ * names the provider is `gen_ai.provider.name` (`gcp.gen_ai` / `gcp.vertex_ai`),
77
+ * never `gen_ai.system`.
78
+ */
79
+ export const GEMINI_SYSTEM_VALUES = new Set(['gemini', 'gcp.gen_ai', 'gcp.vertex_ai']);
80
+ /** Public provider label per detected internal provider. */
81
+ export const CANONICAL_PROVIDER_NAMES = {
82
+ claude: 'claude-code',
83
+ codex: 'codex',
84
+ gemini: 'gemini'
85
+ };
86
+ /** Default surface when correlation supplies none. */
87
+ export const DEFAULT_SURFACE = 'cli';
88
+ /** Prefix on a call id we had to derive ourselves. */
89
+ export const DERIVED_CALL_ID_PREFIX = 'derived_';
90
+ /** Hex characters kept from a derived call id's digest. */
91
+ export const DERIVED_CALL_ID_HEX_LENGTH = 40;
92
+ /** Nanoseconds per millisecond, for OTLP timestamps. */
93
+ export const NANOS_PER_MILLI = 1000000n;
94
+ /** proto3 JSON encodes an unset uint64 as the string "0". */
95
+ export const UNSET_TIME_VALUES = new Set(['0', 0]);
96
+ /** OTLP/HTTP signals the example receiver serves. */
97
+ export const OTLP_HTTP_SIGNALS = ['logs', 'traces', 'metrics'];
98
+ /** The only OTLP/HTTP routes the example receiver answers on. */
99
+ export const RE_OTLP_HTTP_PATH = /^\/v1\/otlp\/v1\/(logs|traces|metrics)$/;
@@ -0,0 +1,24 @@
1
+ import type { DecodedOtlpJson, OtlpHttpSignal } from './types/otlp.types.js';
2
+ export { OTLP_HTTP_SIGNALS } from './constants/otlp.constants.js';
3
+ export type { DecodedOtlpJson, OtlpHttpSignal } from './types/otlp.types.js';
4
+ /**
5
+ * Which OTLP signal a request path names.
6
+ *
7
+ * Matches only the endpoints the example receiver actually serves: an
8
+ * unrecognized path must 404 rather than be silently accepted, or an exporter
9
+ * misconfiguration looks like success while the data goes nowhere.
10
+ *
11
+ * @param requestPath - Request path.
12
+ * @returns The signal, or undefined when the path is not one of ours.
13
+ */
14
+ export declare function otlpSignalFromPath(requestPath: string): OtlpHttpSignal | undefined;
15
+ /**
16
+ * Decode an OTLP/JSON request body.
17
+ *
18
+ * A malformed payload is reported rather than acknowledged: an exporter that
19
+ * receives 200 for a body nobody could read will never retry it.
20
+ *
21
+ * @param body - Raw request bytes.
22
+ * @returns The decoded envelope, or a failure.
23
+ */
24
+ export declare function decodeOtlpJson(body: Uint8Array): DecodedOtlpJson;
@@ -0,0 +1,37 @@
1
+ import { asRecord } from '../core/object.js';
2
+ import { OTLP_HTTP_SIGNALS, RE_OTLP_HTTP_PATH } from './constants/otlp.constants.js';
3
+ export { OTLP_HTTP_SIGNALS } from './constants/otlp.constants.js';
4
+ /**
5
+ * Which OTLP signal a request path names.
6
+ *
7
+ * Matches only the endpoints the example receiver actually serves: an
8
+ * unrecognized path must 404 rather than be silently accepted, or an exporter
9
+ * misconfiguration looks like success while the data goes nowhere.
10
+ *
11
+ * @param requestPath - Request path.
12
+ * @returns The signal, or undefined when the path is not one of ours.
13
+ */
14
+ export function otlpSignalFromPath(requestPath) {
15
+ const signal = RE_OTLP_HTTP_PATH.exec(requestPath)?.[1];
16
+ return OTLP_HTTP_SIGNALS.find((candidate) => candidate === signal);
17
+ }
18
+ /**
19
+ * Decode an OTLP/JSON request body.
20
+ *
21
+ * A malformed payload is reported rather than acknowledged: an exporter that
22
+ * receives 200 for a body nobody could read will never retry it.
23
+ *
24
+ * @param body - Raw request bytes.
25
+ * @returns The decoded envelope, or a failure.
26
+ */
27
+ export function decodeOtlpJson(body) {
28
+ try {
29
+ const payload = asRecord(JSON.parse(Buffer.from(body).toString('utf8')));
30
+ if (!payload)
31
+ return { ok: false };
32
+ return { ok: true, payload };
33
+ }
34
+ catch {
35
+ return { ok: false };
36
+ }
37
+ }
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Decoding agents' own OpenTelemetry export into the atomic usage ledger.
3
+ * Published as `@agent-watch-ai/edge/otlp` for backends that ingest it
4
+ * themselves.
5
+ */
6
+ export type { Attributes, DecodedOtlpJson, NormalizeOtlpOptions, OtlpCallIdentity, OtlpCorrelationContext, OtlpHttpSignal, OtlpProvider, OtlpUsage, RecordIdentity } from './types/otlp.types.js';
7
+ export { OTLP_HTTP_SIGNALS } from './constants/otlp.constants.js';
8
+ export { normalizeOtlpLogs } from './normalize.js';
9
+ export { decodeOtlpJson, otlpSignalFromPath } from './http.js';
@@ -0,0 +1,3 @@
1
+ export { OTLP_HTTP_SIGNALS } from './constants/otlp.constants.js';
2
+ export { normalizeOtlpLogs } from './normalize.js';
3
+ export { decodeOtlpJson, otlpSignalFromPath } from './http.js';
@@ -0,0 +1,14 @@
1
+ import type { LlmCallEvent } from '../events/types/llm-call.types.js';
2
+ import type { NormalizeOtlpOptions } from './types/otlp.types.js';
3
+ export type { DecodedOtlpJson, NormalizeOtlpOptions, OtlpCallIdentity, OtlpCorrelationContext, OtlpHttpSignal } from './types/otlp.types.js';
4
+ /**
5
+ * Normalize OTLP/JSON logs into the only atomic usage record: llm.call.
6
+ *
7
+ * Duplicate OTLP delivery is safe because call ids and event ids are stable;
8
+ * the backend must upsert on call_id, scoped by provider.
9
+ *
10
+ * @param payload - A decoded OTLP/JSON logs envelope.
11
+ * @param options - Correlation lookup and the batch's ingest time.
12
+ * @returns One llm.call per usable record, in envelope order.
13
+ */
14
+ export declare function normalizeOtlpLogs(payload: unknown, options?: NormalizeOtlpOptions): LlmCallEvent[];