@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,106 @@
1
+ import type { AgentWatchEvent, ContentEvidence, EventGit, FeatureCandidate, UsageBillingMode } from '../../events/types/events.types.js';
2
+ import type { PromptRecord, ToolRecord } from './turn-state.types.js';
3
+ import type { TurnUsage } from './transcript.types.js';
4
+ /**
5
+ * Usage attributed to one agent inside a turn — the main agent, or one of the
6
+ * child agents it spawned — derived from the same call ledger as the totals.
7
+ */
8
+ export interface AgentUsageSummary {
9
+ readonly agent_id?: string;
10
+ readonly parent_agent_id?: string;
11
+ readonly agent_type?: string;
12
+ readonly llm_calls: number;
13
+ readonly input_tokens?: number;
14
+ readonly cached_input_tokens?: number;
15
+ readonly cache_creation_input_tokens?: number;
16
+ readonly output_tokens?: number;
17
+ readonly reasoning_output_tokens?: number;
18
+ readonly total_tokens?: number;
19
+ readonly cost_usd?: number;
20
+ }
21
+ /**
22
+ * How much of the turn's usage is settled.
23
+ *
24
+ * `pending` — nothing yet. `provisional` — read from the agent's transcript,
25
+ * good enough to show. `partial` — the llm.call ledger has spoken but more
26
+ * batches may still arrive. `complete` — the backend has decided none can.
27
+ */
28
+ export type TurnUsageStatus = 'pending' | 'provisional' | 'complete' | 'partial';
29
+ /**
30
+ * One prompt→response turn, flattened for direct backend consumption: who
31
+ * (developer), where (repo/branch/commit/ticket), what (prompt, response,
32
+ * tools, files) and how much it cost.
33
+ *
34
+ * The only product record the hook path emits; the backend finalizes its usage
35
+ * from the atomic llm.call rows.
36
+ */
37
+ export interface TurnSummaryEvent extends AgentWatchEvent<'turn.summary'> {
38
+ readonly provider: string;
39
+ readonly surface: string;
40
+ readonly session_id?: string;
41
+ readonly turn_id?: string;
42
+ readonly developer_id?: string;
43
+ readonly repository?: string;
44
+ readonly branch?: string;
45
+ readonly commit?: string;
46
+ readonly jira_ids?: readonly string[];
47
+ /** Working-tree changes reported by git at the end of the turn. */
48
+ readonly files_changed?: readonly string[];
49
+ /** Files edited by the agent's tools during this turn (repo-relative). */
50
+ readonly files_touched?: readonly string[];
51
+ /** Files the agent's tools only read during this turn (repo-relative). */
52
+ readonly files_read?: readonly string[];
53
+ readonly prompt?: string;
54
+ readonly prompt_evidence?: ContentEvidence;
55
+ readonly response?: string;
56
+ readonly response_evidence?: ContentEvidence;
57
+ readonly tool_calls: number;
58
+ readonly tools_used: Readonly<Record<string, number>>;
59
+ readonly model?: string;
60
+ /** subscription (flat plan) vs api (per-token billing); see billing-mode.ts. */
61
+ readonly billing_mode?: UsageBillingMode;
62
+ readonly input_tokens?: number;
63
+ readonly cached_input_tokens?: number;
64
+ readonly cache_creation_input_tokens?: number;
65
+ readonly output_tokens?: number;
66
+ readonly reasoning_output_tokens?: number;
67
+ readonly total_tokens?: number;
68
+ readonly cost_usd?: number;
69
+ /** Filled by the backend from unique llm.call records. */
70
+ readonly llm_calls?: number;
71
+ /** Main-agent and child-agent usage, derived from the same call ledger. */
72
+ readonly agent_usage?: readonly AgentUsageSummary[];
73
+ /** Hook summaries start pending/provisional; only backend aggregation is complete. */
74
+ readonly usage_status: TurnUsageStatus;
75
+ readonly started_at?: string;
76
+ readonly ended_at: string;
77
+ }
78
+ /** The response the user actually saw, however the provider delivered it. */
79
+ export interface TurnResponse {
80
+ readonly text?: string;
81
+ readonly evidence?: ContentEvidence;
82
+ }
83
+ export interface BuildTurnSummaryInput {
84
+ /** Internal provider id ('claude' | 'codex' | ...); mapped to the public label. */
85
+ readonly provider: string;
86
+ readonly surface: string;
87
+ readonly sessionId?: string;
88
+ readonly turnId?: string;
89
+ readonly developerId?: string;
90
+ readonly installationId?: string;
91
+ readonly git?: EventGit;
92
+ readonly featureCandidates?: readonly FeatureCandidate[];
93
+ readonly prompts: readonly PromptRecord[];
94
+ readonly tools: readonly ToolRecord[];
95
+ readonly response?: TurnResponse;
96
+ readonly usage?: TurnUsage;
97
+ readonly model?: string;
98
+ readonly billingMode?: UsageBillingMode;
99
+ readonly endedAt: string;
100
+ }
101
+ /** Files the turn's tools read versus modified. */
102
+ export interface TouchedFiles {
103
+ readonly toolsUsed: Readonly<Record<string, number>>;
104
+ readonly filesTouched: readonly string[];
105
+ readonly filesRead: readonly string[];
106
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,27 @@
1
+ import type { AgentWatchConfig } from '../../config/types/config.types.js';
2
+ import type { Env } from '../../core/types/core.types.js';
3
+ import type { AgentWatchEvent } from '../../events/types/events.types.js';
4
+ export interface TrackTurnOptions {
5
+ readonly agentId: string;
6
+ /** Raw provider payload; source of the transcript path. */
7
+ readonly rawPayload: unknown;
8
+ /** Enriched + sanitized canonical events produced from this payload. */
9
+ readonly events: readonly AgentWatchEvent[];
10
+ readonly config: AgentWatchConfig;
11
+ readonly turnsDir: string;
12
+ readonly locksDir: string;
13
+ readonly env: Env;
14
+ readonly cwd: string;
15
+ /** Preview a Stop without appending, consuming, claiming, or sweeping state. */
16
+ readonly readOnly?: boolean;
17
+ }
18
+ /** The window a closing turn may claim transcript usage from. */
19
+ export interface TurnWindow {
20
+ readonly startedAt?: string;
21
+ /**
22
+ * Upper bound for transcript entries. Cut at the next prompt's start when
23
+ * one raced into our window: those tokens belong to (and are counted by)
24
+ * that turn, which is what keeps attribution exactly-once.
25
+ */
26
+ readonly untilIso: string;
27
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,43 @@
1
+ # Example backend
2
+
3
+ A zero-dependency logging server for trying AgentWatch Edge locally. It accepts
4
+ `turn.summary` on `/v1/events` and native agent OTLP on
5
+ `/v1/otlp/v1/{logs,traces,metrics}`. A production receiver must normalize completed requests
6
+ to `llm.call` and durably upsert before acknowledging OTLP.
7
+
8
+ ## Try it end to end
9
+
10
+ Terminal 1 — start the backend:
11
+
12
+ ```bash
13
+ npm run build
14
+ npm run example # http://127.0.0.1:8787
15
+ # JSON=1 npm run example — also print each event as full JSON
16
+ ```
17
+
18
+ Terminal 2 — point the edge at it:
19
+
20
+ ```bash
21
+ node dist/cli.js setup --endpoint http://127.0.0.1:8787 --yes
22
+ # or, with a global install/npm link: agentwatch setup --endpoint http://127.0.0.1:8787 --yes
23
+ ```
24
+
25
+ Then open a **new** Claude Code, Codex or Cursor session in any repository and do something.
26
+ Terminal 1 prints a `TURN.SUMMARY` for each completed turn. Claude Code and Codex also produce
27
+ normalized `LLM.CALL` records and `OTLP:*` diagnostics; Cursor has no native OTel export.
28
+
29
+ For Codex, remember the one-time trust step: run `codex`, type `/hooks`, trust the AgentWatch
30
+ entries.
31
+
32
+ Check edge health anytime:
33
+
34
+ ```bash
35
+ node dist/cli.js status
36
+ node dist/cli.js doctor
37
+ ```
38
+
39
+ Cleanup when done:
40
+
41
+ ```bash
42
+ node dist/cli.js uninstall # removes hooks + OTel config (add --purge for local data)
43
+ ```
@@ -0,0 +1,240 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Example AgentWatch backend: a zero-dependency Node.js server that accepts
4
+ * everything the Edge and the agents' native OpenTelemetry send, and logs
5
+ * it to the console. For local testing only.
6
+ *
7
+ * npm run example # listens on http://127.0.0.1:8787
8
+ * PORT=9000 npm run example
9
+ * JSON=1 npm run example # also print each event as full JSON
10
+ * BLOCK=1 npm run example # answer every enforcement check with "block"
11
+ * BLOCK=dev@acme.test ... # block just that developer
12
+ *
13
+ * Endpoints:
14
+ * POST /v1/events turn.summary records (JSON)
15
+ * GET /v1/enforcement/decision pre-turn budget check (allow / block)
16
+ * POST /v1/otlp/v1/metrics
17
+ * POST /v1/otlp/v1/logs
18
+ * POST /v1/otlp/v1/traces
19
+ * GET / health check
20
+ */
21
+ import http from 'node:http';
22
+ import { decodeOtlpJson, otlpSignalFromPath } from '../dist/otlp/http.js';
23
+ import { normalizeOtlpLogs } from '../dist/otlp/normalize.js';
24
+
25
+ const PORT = Number(process.env.PORT ?? 8787);
26
+ const PRINT_JSON = process.env.JSON === '1';
27
+ // Which developer the pre-turn check refuses: "1" for everyone, an identity for
28
+ // one person, unset for nobody. The Edge blocks a turn only on an explicit
29
+ // block, so leaving this unset is how the check stays invisible.
30
+ const BLOCK = process.env.BLOCK ?? '';
31
+ const BLOCK_MESSAGE = process.env.BLOCK_MESSAGE ?? 'You passed your $500 monthly hard limit; ask your admin to raise the cap or dismiss the alert.';
32
+ const isTTY = process.stdout.isTTY;
33
+ const paint = (code, text) => (isTTY ? `\u001b[${code}m${text}\u001b[0m` : text);
34
+ const dim = (text) => paint('90', text);
35
+ const timestamp = () => new Date().toISOString().slice(11, 23);
36
+
37
+ let eventCount = 0;
38
+ let otlpCount = 0;
39
+ let llmCallCount = 0;
40
+
41
+ function log(tag, tagColor, message) {
42
+ console.log(`${dim(timestamp())} ${paint(tagColor, tag.padEnd(8))} ${message}`);
43
+ }
44
+
45
+ function shortId(id) {
46
+ return typeof id === 'string' && id.length > 8 ? id.slice(0, 8) : (id ?? '-');
47
+ }
48
+
49
+ function describeEvent(event) {
50
+ const parts = [
51
+ paint('36', (event.agent?.provider ?? '?').padEnd(6)),
52
+ paint('1', (event.event?.type ?? '?').padEnd(20)),
53
+ dim(`session=${shortId(event.session?.id)}`)
54
+ ];
55
+ if (event.tool?.name) parts.push(`tool=${event.tool.name}`);
56
+ if (event.metadata?.filePath) parts.push(`file=${event.metadata.filePath}`);
57
+ if (event.metadata?.command) parts.push(`cmd=${JSON.stringify(event.metadata.command)}`);
58
+ const model = event.ai?.model ?? event.model;
59
+ if (model) parts.push(`model=${model}`);
60
+ const billing = event.ai?.billingMode ?? event.billing_mode;
61
+ if (billing) parts.push(paint('35', billing));
62
+ const usage = event.ai?.usage ?? (event.output_tokens !== undefined ? { inputTokens: event.input_tokens, outputTokens: event.output_tokens, cachedInputTokens: event.cached_input_tokens } : undefined);
63
+ if (usage?.outputTokens !== undefined) {
64
+ const cached = usage.cachedInputTokens !== undefined ? ` cached=${usage.cachedInputTokens}` : '';
65
+ parts.push(paint('33', `tokens[in=${usage.inputTokens ?? 0} out=${usage.outputTokens}${cached}]`));
66
+ }
67
+ // Product events (llm.call, turn.summary) carry flat git/ticket fields;
68
+ // other canonical events still use the nested git/feature envelope.
69
+ const branch = event.branch ?? event.git?.branch;
70
+ if (branch) parts.push(dim(`${event.repository ?? event.git?.repository ?? ''}@${branch}`));
71
+ const tickets = event.jira_ids ?? event.feature?.candidates?.map((c) => c.value);
72
+ if (tickets?.length) parts.push(paint('33', `ticket=${tickets.join(',')}`));
73
+ return parts.join(' ');
74
+ }
75
+
76
+ /** Pull readable metric/event names out of an OTLP protobuf body (demo aid). */
77
+ function sniffOtlpNames(body) {
78
+ const text = body.toString('latin1');
79
+ const names = new Set();
80
+ for (const match of text.matchAll(/(?:claude_code|codex|gen_ai)[.\w]+/g)) {
81
+ names.add(match[0]);
82
+ if (names.size >= 8) break;
83
+ }
84
+ return [...names];
85
+ }
86
+
87
+ /** Flatten OTLP JSON KeyValue attributes into a plain object. */
88
+ function otlpAttributes(list) {
89
+ const out = {};
90
+ for (const { key, value } of list ?? []) {
91
+ if (!value) continue;
92
+ out[key] = value.stringValue ?? value.intValue ?? value.doubleValue ?? value.boolValue ?? undefined;
93
+ }
94
+ return out;
95
+ }
96
+
97
+ /** One readable line per OTLP JSON log record / metric (demo aid). */
98
+ function describeOtlpJson(signal, payload) {
99
+ const lines = [];
100
+ if (signal === 'logs') {
101
+ for (const resource of payload.resourceLogs ?? []) {
102
+ for (const scope of resource.scopeLogs ?? []) {
103
+ for (const record of scope.logRecords ?? []) {
104
+ const attrs = otlpAttributes(record.attributes);
105
+ const name = attrs['event.name'] ?? record.body?.stringValue ?? 'log';
106
+ const parts = [paint('1', String(name).padEnd(28))];
107
+ if (attrs['session.id']) parts.push(dim(`session=${shortId(attrs['session.id'])}`));
108
+ if (attrs['model']) parts.push(`model=${attrs['model']}`);
109
+ const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_creation_tokens']
110
+ .filter((key) => attrs[key] !== undefined)
111
+ .map((key) => `${key.replace('_tokens', '')}=${attrs[key]}`);
112
+ if (tokens.length > 0) parts.push(paint('33', `tokens[${tokens.join(' ')}]`));
113
+ if (attrs['cost_usd'] !== undefined) parts.push(paint('32', `$${Number(attrs['cost_usd']).toFixed(6)}`));
114
+ lines.push(parts.join(' '));
115
+ }
116
+ }
117
+ }
118
+ }
119
+ if (signal === 'metrics') {
120
+ for (const resource of payload.resourceMetrics ?? []) {
121
+ for (const scope of resource.scopeMetrics ?? []) {
122
+ for (const metric of scope.metrics ?? []) {
123
+ const points = metric.sum?.dataPoints ?? metric.gauge?.dataPoints ?? metric.histogram?.dataPoints ?? [];
124
+ lines.push(`${paint('1', String(metric.name ?? 'metric').padEnd(28))} ${dim(`${points.length} datapoint(s)`)}`);
125
+ }
126
+ }
127
+ }
128
+ }
129
+ return lines;
130
+ }
131
+
132
+ const server = http.createServer(async (req, res) => {
133
+ const chunks = [];
134
+ for await (const chunk of req) chunks.push(chunk);
135
+ const body = Buffer.concat(chunks);
136
+ const url = (req.url ?? '/').split('?')[0];
137
+ const auth = req.headers.authorization ? dim(' auth=bearer') : '';
138
+
139
+ if (req.method === 'POST' && url === '/v1/events') {
140
+ try {
141
+ const payload = JSON.parse(body.toString('utf8'));
142
+ const events = Array.isArray(payload.events) ? payload.events : [];
143
+ eventCount += events.length;
144
+ for (const event of events) {
145
+ log('TURN.SUMMARY', '32', describeEvent(event) + auth);
146
+ if (PRINT_JSON) console.log(dim(JSON.stringify(event, null, 2)));
147
+ }
148
+ if (events.length === 0) log('TURN.SUMMARY', '32', dim('empty batch (connectivity probe)') + auth);
149
+ res.writeHead(200, { 'content-type': 'application/json' });
150
+ res.end(JSON.stringify({ ok: true, received: events.length, total: eventCount }));
151
+ } catch (error) {
152
+ log('TURN.SUMMARY', '31', `bad JSON: ${error.message}`);
153
+ res.writeHead(400, { 'content-type': 'application/json' });
154
+ res.end(JSON.stringify({ ok: false }));
155
+ }
156
+ return;
157
+ }
158
+
159
+ const otlpSignal = otlpSignalFromPath(url);
160
+ if (req.method === 'POST' && otlpSignal) {
161
+ const signal = otlpSignal;
162
+ const contentType = req.headers['content-type'] ?? '';
163
+ let detail = `${body.length} bytes (${contentType})`;
164
+ let recordLines = [];
165
+ if (contentType.includes('json')) {
166
+ const decoded = decodeOtlpJson(body);
167
+ if (!decoded.ok) {
168
+ log(`OTLP:${signal}`, '31', `${detail} ${dim('(invalid JSON payload)')}` + auth);
169
+ res.writeHead(400, { 'content-type': 'application/json' });
170
+ res.end(JSON.stringify({ code: 3, message: 'invalid OTLP JSON payload' }));
171
+ return;
172
+ }
173
+ const payload = decoded.payload;
174
+ recordLines = describeOtlpJson(signal, payload);
175
+ if (signal === 'logs') {
176
+ const calls = normalizeOtlpLogs(payload, { receivedAt: new Date().toISOString() });
177
+ llmCallCount += calls.length;
178
+ for (const call of calls) {
179
+ log('LLM.CALL', '36', describeEvent(call) + ` call=${shortId(call.call_id)}` + auth);
180
+ if (PRINT_JSON) console.log(dim(JSON.stringify(call, null, 2)));
181
+ }
182
+ }
183
+ // Raw OTLP payloads are never dumped: the two product events
184
+ // (llm.call, turn.summary) are the only JSON worth reading.
185
+ } else {
186
+ const names = sniffOtlpNames(body);
187
+ if (names.length > 0) detail += ' ' + paint('33', names.join(' '));
188
+ }
189
+ otlpCount += 1;
190
+ // Logs batches are already shown as LLM.CALL lines above; raw OTLP output is noise.
191
+ if (signal !== 'logs') {
192
+ log(`OTLP:${signal}`, '35', detail + auth);
193
+ for (const line of recordLines) console.log(`${dim(timestamp())} ${' '.repeat(9)}${line}`);
194
+ }
195
+ // OTLP/HTTP: the response must use the same encoding as the request.
196
+ if (contentType.includes('json')) {
197
+ res.writeHead(200, { 'content-type': 'application/json' });
198
+ res.end('{}'); // empty Export*ServiceResponse
199
+ } else {
200
+ res.writeHead(200, { 'content-type': 'application/x-protobuf' });
201
+ res.end(); // empty message is a valid Export*ServiceResponse
202
+ }
203
+ return;
204
+ }
205
+
206
+ if (req.method === 'GET' && url === '/v1/enforcement/decision') {
207
+ const developerId = new URL(req.url ?? '/', 'http://127.0.0.1').searchParams.get('developer_id') ?? '';
208
+ if (developerId === '') {
209
+ log('ENFORCE', '31', `missing developer_id -> 400${auth}`);
210
+ res.writeHead(400, { 'content-type': 'application/json' });
211
+ res.end(JSON.stringify({ message: 'developer_id is required' }));
212
+ return;
213
+ }
214
+ const blocked = BLOCK === '1' || BLOCK === developerId;
215
+ const decision = blocked ? { decision: 'block', message: BLOCK_MESSAGE } : { decision: 'allow' };
216
+ log('ENFORCE', blocked ? '31' : '32', `${developerId} -> ${decision.decision}${auth}`);
217
+ res.writeHead(200, { 'content-type': 'application/json' });
218
+ res.end(JSON.stringify(decision));
219
+ return;
220
+ }
221
+
222
+ if (req.method === 'GET' && url === '/') {
223
+ res.writeHead(200, { 'content-type': 'application/json' });
224
+ res.end(JSON.stringify({ ok: true, summaries: eventCount, llmCalls: llmCallCount, otlpBatches: otlpCount }));
225
+ return;
226
+ }
227
+
228
+ log('HTTP', '33', `${req.method} ${url} -> 404`);
229
+ res.writeHead(404, { 'content-type': 'application/json' });
230
+ res.end(JSON.stringify({ ok: false, error: 'not found' }));
231
+ });
232
+
233
+ server.listen(PORT, '127.0.0.1', () => {
234
+ console.log(paint('1', `AgentWatch example backend listening on http://127.0.0.1:${PORT}`));
235
+ console.log(dim(' summary: POST /v1/events'));
236
+ console.log(dim(` otlp: POST /v1/otlp/v1/{logs,traces,metrics}`));
237
+ console.log(dim(` budget: GET /v1/enforcement/decision${BLOCK === '' ? ' (allowing everyone; set BLOCK=1 to refuse)' : ` (blocking ${BLOCK === '1' ? 'everyone' : BLOCK})`}`));
238
+ console.log(dim(` connect the edge: agentwatch setup --endpoint http://127.0.0.1:${PORT} --yes`));
239
+ console.log();
240
+ });
package/package.json ADDED
@@ -0,0 +1,89 @@
1
+ {
2
+ "name": "@agent-watch-ai/edge",
3
+ "version": "0.2.5",
4
+ "description": "Connect Claude Code, Codex and Cursor telemetry to your backend with turn, Git and ticket-key attribution.",
5
+ "license": "MIT",
6
+ "type": "module",
7
+ "engines": {
8
+ "node": ">=20"
9
+ },
10
+ "bin": {
11
+ "agentwatch": "./dist/cli.js"
12
+ },
13
+ "exports": {
14
+ "./events": {
15
+ "types": "./dist/events/product-event.d.ts",
16
+ "default": "./dist/events/product-event.js"
17
+ },
18
+ "./llm-call": {
19
+ "types": "./dist/events/llm-call.d.ts",
20
+ "default": "./dist/events/llm-call.js"
21
+ },
22
+ "./otlp": {
23
+ "types": "./dist/otlp/normalize.d.ts",
24
+ "default": "./dist/otlp/normalize.js"
25
+ },
26
+ "./aggregate-turn": {
27
+ "types": "./dist/turns/aggregate-usage.d.ts",
28
+ "default": "./dist/turns/aggregate-usage.js"
29
+ },
30
+ "./turn-summary": {
31
+ "types": "./dist/turns/turn-summary.d.ts",
32
+ "default": "./dist/turns/turn-summary.js"
33
+ }
34
+ },
35
+ "files": [
36
+ "dist",
37
+ "example",
38
+ "README.md",
39
+ "LICENSE",
40
+ "CHANGELOG.md"
41
+ ],
42
+ "scripts": {
43
+ "build": "tsc -p tsconfig.build.json",
44
+ "typecheck": "tsc --noEmit",
45
+ "lint": "eslint src tests",
46
+ "lint:fix": "eslint src tests --fix",
47
+ "test": "vitest run",
48
+ "test:watch": "vitest",
49
+ "example": "node example/server.mjs",
50
+ "prepack": "npm run build",
51
+ "prepare": "npm run build"
52
+ },
53
+ "repository": {
54
+ "type": "git",
55
+ "url": "git+https://github.com/agent-watch-ai/agent-watch-edge.git"
56
+ },
57
+ "homepage": "https://github.com/agent-watch-ai/agent-watch-edge#readme",
58
+ "bugs": {
59
+ "url": "https://github.com/agent-watch-ai/agent-watch-edge/issues"
60
+ },
61
+ "keywords": [
62
+ "telemetry",
63
+ "opentelemetry",
64
+ "claude-code",
65
+ "codex",
66
+ "ai-coding-agents",
67
+ "ai-cost",
68
+ "cost-attribution",
69
+ "feature-cost",
70
+ "observability",
71
+ "hooks"
72
+ ],
73
+ "dependencies": {
74
+ "smol-toml": "^1.3.1",
75
+ "zod": "^3.24.0"
76
+ },
77
+ "devDependencies": {
78
+ "@eslint/js": "^9.17.0",
79
+ "@stylistic/eslint-plugin": "^5.10.0",
80
+ "@types/node": "^22.10.0",
81
+ "eslint": "^9.17.0",
82
+ "eslint-plugin-import-x": "^4.17.1",
83
+ "eslint-plugin-jsdoc": "^63.3.3",
84
+ "patch-package": "^8.0.1",
85
+ "typescript": "^5.7.0",
86
+ "typescript-eslint": "^8.19.0",
87
+ "vitest": "^2.1.8"
88
+ }
89
+ }