@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,331 @@
1
+ import { asRecord, omitKeys } from '../../core/object.js';
2
+ import { enabledSignalNames, otelEnabled, otlpBaseUrl } from '../../config/config.js';
3
+ import { backupFile } from '../../storage/atomic-file.js';
4
+ import { readJsonFile } from '../../storage/json-file.js';
5
+ import { writeJsonValidated } from '../shared/hook-config.js';
6
+ import { withOtelInstall, withoutOtelInstall } from '../shared/install-record.js';
7
+ import { HOOK_COMMAND_MARKER } from '../constants/provider.constants.js';
8
+ import { claudeSettingsPath } from './claude.detect.js';
9
+ import { CLAUDE_PROVIDER_ID } from './constants/claude.constants.js';
10
+ import { ENV_BLOCK_KEY, HEADERS_HELPER_KEY, OTEL_EXPORTER_NONE, OTEL_EXPORTER_OTLP, OTLP_PROTOCOL, RE_HOOK_SUFFIX } from './constants/claude.otel.constants.js';
11
+ /**
12
+ * The telemetry environment AgentWatch wants in Claude Code's settings.
13
+ *
14
+ * Claude Code's native OpenTelemetry (verified against
15
+ * code.claude.com/docs/en/monitoring-usage, 2026-08) is configured through the
16
+ * settings.json `env` block. Each `claude_code.api_request` log becomes one
17
+ * llm.call; the enhanced-traces beta adds `claude_code.llm_request` spans
18
+ * carrying query_source/agent_id, which is what keeps child-agent traffic from
19
+ * being folded into the main agent.
20
+ *
21
+ * @param context - Environment, paths and effective config.
22
+ * @returns The desired variables, or undefined when telemetry is off or no
23
+ * backend is configured.
24
+ */
25
+ export function desiredClaudeOtelEnv(context) {
26
+ const otlpBase = otlpBaseUrl(context.config);
27
+ if (!otlpBase || !otelEnabled(context.config))
28
+ return undefined;
29
+ const signals = context.config.otel;
30
+ return {
31
+ CLAUDE_CODE_ENABLE_TELEMETRY: '1',
32
+ OTEL_METRICS_EXPORTER: signals.metrics ? OTEL_EXPORTER_OTLP : OTEL_EXPORTER_NONE,
33
+ OTEL_LOGS_EXPORTER: signals.logs ? OTEL_EXPORTER_OTLP : OTEL_EXPORTER_NONE,
34
+ OTEL_TRACES_EXPORTER: signals.traces ? OTEL_EXPORTER_OTLP : OTEL_EXPORTER_NONE,
35
+ // No default protocol exists; it has to be explicit.
36
+ OTEL_EXPORTER_OTLP_PROTOCOL: OTLP_PROTOCOL,
37
+ OTEL_EXPORTER_OTLP_ENDPOINT: otlpBase,
38
+ // The beta flag only adds the llm_request spans; it stays tied to traces.
39
+ ...(signals.traces ? { CLAUDE_CODE_ENHANCED_TELEMETRY_BETA: '1' } : {})
40
+ };
41
+ }
42
+ /**
43
+ * The `agentwatch otel-headers` command for this install.
44
+ *
45
+ * Bearer auth goes through Claude's documented header-helper hook so the token
46
+ * never lands in the settings file — which is world-readable, committed by some
47
+ * users, and backed up by others.
48
+ *
49
+ * @param hookCommand - The generated `<bin> hook --agent claude` command.
50
+ * @returns The helper command reusing the same binary path.
51
+ */
52
+ export function headersHelperCommand(hookCommand) {
53
+ return `${hookCommand.replace(RE_HOOK_SUFFIX, '')} otel-headers`;
54
+ }
55
+ /**
56
+ * Configures Claude Code's own OTLP export, which is where the llm.call usage
57
+ * ledger comes from.
58
+ */
59
+ export class ClaudeOtelConfigurator {
60
+ /**
61
+ * Whether this agent can export native telemetry at all.
62
+ *
63
+ * @param _env - Unused; Claude Code always supports it.
64
+ * @returns Always true.
65
+ */
66
+ async supported(_env) {
67
+ return true;
68
+ }
69
+ /**
70
+ * Report whether the machine's telemetry configuration matches what we want.
71
+ *
72
+ * @param context - Environment, paths, config and install state.
73
+ * @returns The status, naming any foreign configuration in the way.
74
+ */
75
+ async inspect(context) {
76
+ const disabled = !otelEnabled(context.config);
77
+ const settingsPath = claudeSettingsPath(context.env);
78
+ const read = await readJsonFile(settingsPath);
79
+ const settings = read.state === 'ok' ? asRecord(read.value) : undefined;
80
+ if (!settings) {
81
+ if (disabled && read.state === 'missing')
82
+ return { supported: true, configured: true, detail: 'disabled in config (otel)' };
83
+ return { supported: true, configured: false, detail: read.state === 'invalid' ? 'settings unparseable' : 'no settings file' };
84
+ }
85
+ const envBlock = asRecord(settings[ENV_BLOCK_KEY]) ?? {};
86
+ const ownedKeys = this.ownedKeys(context);
87
+ if (disabled)
88
+ return inspectDisabled(settings, envBlock, ownedKeys);
89
+ const desired = desiredClaudeOtelEnv(context);
90
+ if (!desired)
91
+ return { supported: true, configured: false, detail: 'no backend endpoint configured' };
92
+ if (Object.entries(desired).every(([key, value]) => envBlock[key] === value)) {
93
+ return { supported: true, configured: true };
94
+ }
95
+ const conflicting = foreignKeys(envBlock, desired, ownedKeys);
96
+ if (conflicting.length > 0) {
97
+ return { supported: true, configured: false, conflict: `existing telemetry env vars: ${conflicting.join(', ')}` };
98
+ }
99
+ return { supported: true, configured: false };
100
+ }
101
+ /**
102
+ * Write the telemetry configuration into Claude Code's settings.
103
+ *
104
+ * Refuses rather than overwrites when a telemetry variable is already set to
105
+ * something we did not write: the user may be exporting to their own
106
+ * collector, and silently redirecting that would be the worst possible
107
+ * outcome of installing a telemetry edge.
108
+ *
109
+ * @param context - Environment, paths, config and install state.
110
+ * @returns Whether the file changed, what to tell the user, and the next
111
+ * install state.
112
+ */
113
+ async configure(context) {
114
+ const desired = desiredClaudeOtelEnv(context);
115
+ if (!desired)
116
+ return this.configureDisabled(context);
117
+ const settingsPath = claudeSettingsPath(context.env);
118
+ const read = await readJsonFile(settingsPath);
119
+ if (read.state === 'invalid') {
120
+ return { ok: false, changed: false, messages: [`refusing to modify unparseable ${settingsPath} (${read.error})`] };
121
+ }
122
+ if (read.state === 'ok' && !asRecord(read.value)) {
123
+ return { ok: false, changed: false, messages: [`refusing to modify ${settingsPath}: top level is not an object`] };
124
+ }
125
+ const settings = (read.state === 'ok' ? asRecord(read.value) : undefined) ?? {};
126
+ const envBlock = asRecord(settings[ENV_BLOCK_KEY]) ?? {};
127
+ const ownedKeys = this.ownedKeys(context);
128
+ const conflicting = foreignKeys(envBlock, desired, ownedKeys);
129
+ if (conflicting.length > 0) {
130
+ return {
131
+ ok: false,
132
+ changed: false,
133
+ messages: [`skipping native OpenTelemetry: ${conflicting.join(', ')} already set in ${settingsPath} (not AgentWatch-owned)`]
134
+ };
135
+ }
136
+ // Signals disabled since the previous run leave stale AgentWatch-owned keys
137
+ // behind — the enhanced-telemetry flag, once traces go off.
138
+ const stale = new Set(ownedKeys.filter((key) => key !== HEADERS_HELPER_KEY && desired[key] === undefined));
139
+ const withEnv = { ...settings, [ENV_BLOCK_KEY]: { ...omitKeys(envBlock, stale), ...desired } };
140
+ const helper = this.applyHeadersHelper(withEnv, context);
141
+ if ('conflict' in helper) {
142
+ return { ok: false, changed: false, messages: [helper.conflict] };
143
+ }
144
+ const changed = JSON.stringify(helper.settings) !== JSON.stringify(settings);
145
+ if (changed) {
146
+ await backupFile(settingsPath, context.paths.backupsDir, context.env.now());
147
+ await writeJsonValidated(settingsPath, helper.settings);
148
+ }
149
+ return {
150
+ ok: true,
151
+ changed,
152
+ messages: changed
153
+ ? [`native OpenTelemetry configured (signals: ${enabledSignalNames(context.config.otel).join(', ')})`, 'restart running Claude Code sessions to pick it up']
154
+ : ['native OpenTelemetry already configured'],
155
+ installState: withOtelInstall(context.installState, CLAUDE_PROVIDER_ID, {
156
+ configPath: settingsPath,
157
+ ownedKeys: [...Object.keys(desired), ...helper.ownedExtra],
158
+ configuredAt: context.env.now()
159
+ })
160
+ };
161
+ }
162
+ /**
163
+ * Remove the telemetry configuration AgentWatch wrote.
164
+ *
165
+ * Only our own keys go. Without a recorded key list we fall back to the
166
+ * well-known ones, and then only when their values are the ones we would have
167
+ * written — user-owned telemetry config is never removed.
168
+ *
169
+ * @param context - Environment, paths, config and install state.
170
+ * @returns Whether the file changed, what to tell the user, and the next
171
+ * install state.
172
+ */
173
+ async uninstall(context) {
174
+ const settingsPath = claudeSettingsPath(context.env);
175
+ const read = await readJsonFile(settingsPath);
176
+ if (read.state === 'missing')
177
+ return { ok: true, changed: false, messages: ['no Claude settings file'] };
178
+ const settings = read.state === 'ok' ? asRecord(read.value) : undefined;
179
+ if (!settings)
180
+ return { ok: false, changed: false, messages: [`cannot parse ${settingsPath}; not modified`] };
181
+ const desired = desiredClaudeOtelEnv(context) ?? {};
182
+ const recorded = this.ownedKeys(context);
183
+ const envBlock = asRecord(settings[ENV_BLOCK_KEY]);
184
+ const removable = removableEnvKeys(envBlock, recorded, desired);
185
+ const helperRemoved = isOurHelper(settings[HEADERS_HELPER_KEY]);
186
+ const changed = removable.size > 0 || helperRemoved;
187
+ if (changed) {
188
+ await backupFile(settingsPath, context.paths.backupsDir, context.env.now());
189
+ await writeJsonValidated(settingsPath, strippedSettings(settings, envBlock, removable, helperRemoved));
190
+ }
191
+ return {
192
+ ok: true,
193
+ changed,
194
+ messages: changed ? ['native OpenTelemetry configuration removed'] : ['no AgentWatch telemetry configuration found'],
195
+ installState: withoutOtelInstall(context.installState, CLAUDE_PROVIDER_ID)
196
+ };
197
+ }
198
+ /**
199
+ * Handle `configure` when telemetry is off or unconfigurable.
200
+ *
201
+ * @param context - Environment, paths, config and install state.
202
+ * @returns The outcome.
203
+ */
204
+ async configureDisabled(context) {
205
+ if (otelEnabled(context.config))
206
+ return { ok: false, changed: false, messages: ['no backend endpoint configured'] };
207
+ // Deliberately off: the desired state is "no AgentWatch telemetry", which
208
+ // means removing whatever a previous setup left behind.
209
+ const removed = await this.uninstall(context);
210
+ if (!removed.ok)
211
+ return removed;
212
+ return {
213
+ ok: true,
214
+ changed: removed.changed,
215
+ messages: [
216
+ removed.changed
217
+ ? 'native OpenTelemetry disabled in config; previous configuration removed'
218
+ : 'native OpenTelemetry disabled in config (otel: none)'
219
+ ],
220
+ installState: removed.installState
221
+ };
222
+ }
223
+ /**
224
+ * Add the header-helper command when a token needs one.
225
+ *
226
+ * @param settings - Settings with the env block already updated.
227
+ * @param context - Environment, paths, config and install state.
228
+ * @returns The next settings and the extra owned key, or a conflict message.
229
+ */
230
+ applyHeadersHelper(settings, context) {
231
+ if (!context.config.token)
232
+ return { settings, ownedExtra: [] };
233
+ const helperCommand = headersHelperCommand(context.hookCommand);
234
+ const existing = settings[HEADERS_HELPER_KEY];
235
+ if (typeof existing === 'string' && !existing.includes(HOOK_COMMAND_MARKER) && existing !== helperCommand) {
236
+ return { conflict: `skipping native OpenTelemetry: ${HEADERS_HELPER_KEY} already set to a non-AgentWatch helper` };
237
+ }
238
+ return { settings: { ...settings, [HEADERS_HELPER_KEY]: helperCommand }, ownedExtra: [HEADERS_HELPER_KEY] };
239
+ }
240
+ /**
241
+ * Settings keys a previous AgentWatch setup recorded as its own.
242
+ *
243
+ * @param context - Install state carrier.
244
+ * @returns The recorded keys.
245
+ */
246
+ ownedKeys(context) {
247
+ return context.installState.agents[CLAUDE_PROVIDER_ID]?.otelOwnedKeys ?? [];
248
+ }
249
+ }
250
+ /**
251
+ * Status when telemetry is deliberately off.
252
+ *
253
+ * @param settings - The whole settings object.
254
+ * @param envBlock - Its env block.
255
+ * @param ownedKeys - Keys a previous setup recorded.
256
+ * @returns Configured, unless our own leftovers are still in place.
257
+ */
258
+ function inspectDisabled(settings, envBlock, ownedKeys) {
259
+ const leftover = ownedKeys.some((key) => (key === HEADERS_HELPER_KEY ? settings[key] !== undefined : envBlock[key] !== undefined));
260
+ if (!leftover)
261
+ return { supported: true, configured: true, detail: 'disabled in config (otel)' };
262
+ return {
263
+ supported: true,
264
+ configured: false,
265
+ detail: 'disabled in config, but previous telemetry env vars remain — run `agentwatch setup`'
266
+ };
267
+ }
268
+ /**
269
+ * Desired keys already set to a value we did not write.
270
+ *
271
+ * @param envBlock - Current env block.
272
+ * @param desired - What we want to write.
273
+ * @param ownedKeys - Keys a previous setup recorded as ours.
274
+ * @returns The conflicting key names.
275
+ */
276
+ function foreignKeys(envBlock, desired, ownedKeys) {
277
+ const owned = new Set(ownedKeys);
278
+ return Object.keys(desired).filter((key) => envBlock[key] !== undefined && envBlock[key] !== desired[key] && !owned.has(key));
279
+ }
280
+ /**
281
+ * Env keys uninstall is allowed to remove.
282
+ *
283
+ * @param envBlock - Current env block, when there is one.
284
+ * @param recorded - Keys a previous setup recorded as ours.
285
+ * @param desired - What this config would write, for the value check.
286
+ * @returns The keys to drop.
287
+ */
288
+ function removableEnvKeys(envBlock, recorded, desired) {
289
+ const removable = new Set();
290
+ if (!envBlock)
291
+ return removable;
292
+ const candidates = recorded.length > 0 ? recorded : Object.keys(desired);
293
+ for (const key of candidates) {
294
+ if (key === HEADERS_HELPER_KEY || envBlock[key] === undefined)
295
+ continue;
296
+ // Without a recorded list we are guessing, so a value we would not have
297
+ // written belongs to the user and stays.
298
+ if (recorded.length === 0 && desired[key] !== undefined && envBlock[key] !== desired[key])
299
+ continue;
300
+ removable.add(key);
301
+ }
302
+ return removable;
303
+ }
304
+ /**
305
+ * Settings with our telemetry keys removed.
306
+ *
307
+ * @param settings - The whole settings object.
308
+ * @param envBlock - Its env block, when there is one.
309
+ * @param removable - Env keys to drop.
310
+ * @param helperRemoved - Whether the header helper is ours to drop.
311
+ * @returns The next settings object.
312
+ */
313
+ function strippedSettings(settings, envBlock, removable, helperRemoved) {
314
+ const withoutHelper = helperRemoved ? omitKeys(settings, new Set([HEADERS_HELPER_KEY])) : settings;
315
+ if (!envBlock)
316
+ return withoutHelper;
317
+ const nextEnv = omitKeys(envBlock, removable);
318
+ // An emptied env block is dropped rather than left as `"env": {}`.
319
+ if (Object.keys(nextEnv).length === 0)
320
+ return omitKeys(withoutHelper, new Set([ENV_BLOCK_KEY]));
321
+ return { ...withoutHelper, [ENV_BLOCK_KEY]: nextEnv };
322
+ }
323
+ /**
324
+ * Whether the configured header helper is one we wrote.
325
+ *
326
+ * @param helper - Current value of the helper key.
327
+ * @returns True when it is ours.
328
+ */
329
+ function isOurHelper(helper) {
330
+ return typeof helper === 'string' && helper.includes(HOOK_COMMAND_MARKER);
331
+ }
@@ -0,0 +1,2 @@
1
+ import type { AgentProvider } from '../provider.js';
2
+ export declare const claudeProvider: AgentProvider;
@@ -0,0 +1,26 @@
1
+ import { hookRefusal } from '../shared/hook-refusal.js';
2
+ import { CLAUDE_PROMPT_SUBMIT_EVENTS } from './constants/claude.constants.js';
3
+ import { detectClaude } from './claude.detect.js';
4
+ import { installClaudeHooks, uninstallClaudeHooks } from './claude.hooks.js';
5
+ import { parseClaudeHookEvent } from './claude.adapter.js';
6
+ import { ClaudeOtelConfigurator } from './claude.otel.js';
7
+ export const claudeProvider = {
8
+ id: 'claude',
9
+ displayName: 'Claude Code',
10
+ detect: detectClaude,
11
+ installHooks: installClaudeHooks,
12
+ uninstallHooks: uninstallClaudeHooks,
13
+ parseHookEvent: async (payload, context) => parseClaudeHookEvent(payload, context),
14
+ /**
15
+ * Exit 0 with empty stdout: stdout of UserPromptSubmit/SessionStart hooks is
16
+ * injected into the model's context, so a passive observer must stay silent.
17
+ */
18
+ getHookResponse: (_payload) => ({ exitCode: 0 }),
19
+ /**
20
+ * A budget refusal on `UserPromptSubmit`: Claude erases the prompt and shows
21
+ * the reason. Any other hook gets nothing, so no tool call and no session
22
+ * event can be refused by this path.
23
+ */
24
+ getBlockResponse: (payload, message) => hookRefusal(payload, CLAUDE_PROMPT_SUBMIT_EVENTS, { decision: 'block', reason: message }),
25
+ nativeTelemetry: new ClaudeOtelConfigurator()
26
+ };
@@ -0,0 +1,34 @@
1
+ import type { CanonicalEventType } from '../../../events/types/events.types.js';
2
+ export declare const CLAUDE_PROVIDER_ID = "claude";
3
+ export declare const CLAUDE_DISPLAY_NAME = "Claude Code";
4
+ /** Directory and settings file Claude Code reads its configuration from. */
5
+ export declare const CLAUDE_HOME_DIR = ".claude";
6
+ export declare const CLAUDE_SETTINGS_FILE = "settings.json";
7
+ export declare const CLAUDE_EXECUTABLE = "claude";
8
+ /**
9
+ * Hook events AgentWatch registers in Claude Code.
10
+ *
11
+ * Schema: hooks -> EventName -> [{matcher?, hooks: [{type:"command", command,
12
+ * timeout}]}] (verified against code.claude.com/docs/en/hooks, 2026-08).
13
+ */
14
+ export declare const CLAUDE_HOOK_EVENTS: readonly ["SessionStart", "SessionEnd", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PostToolUseFailure", "PermissionRequest", "Stop", "SubagentStart", "SubagentStop"];
15
+ /** Tool-scoped events take a tool-name matcher; "*" observes every tool. */
16
+ export declare const CLAUDE_MATCHED_EVENTS: ReadonlySet<string>;
17
+ /** Claude Code reads this field as seconds. */
18
+ export declare const CLAUDE_HOOK_TIMEOUT_SECONDS = 30;
19
+ /** Provider hook name to canonical event type, where the mapping is direct. */
20
+ export declare const CLAUDE_EVENT_TYPE_MAP: Readonly<Record<string, CanonicalEventType>>;
21
+ /** Hooks whose canonical type depends on which tool ran. */
22
+ export declare const CLAUDE_TOOL_EVENTS: ReadonlySet<string>;
23
+ /** Hooks that report a tool call as starting rather than finishing. */
24
+ export declare const CLAUDE_TOOL_START_EVENTS: ReadonlySet<string>;
25
+ /**
26
+ * The one hook a budget refusal may travel on.
27
+ *
28
+ * `UserPromptSubmit` is the last moment before the turn's first request, and
29
+ * Claude Code documents `{"decision":"block","reason":…}` there as "the prompt
30
+ * is erased and the reason is shown to the user" — exactly the refusal this
31
+ * feature needs, with the platform's sentence as the reason.
32
+ */
33
+ export declare const CLAUDE_PROMPT_SUBMIT_EVENTS: ReadonlySet<string>;
34
+ export declare const CLAUDE_UNKNOWN_EVENT = "unknown";
@@ -0,0 +1,54 @@
1
+ export const CLAUDE_PROVIDER_ID = 'claude';
2
+ export const CLAUDE_DISPLAY_NAME = 'Claude Code';
3
+ /** Directory and settings file Claude Code reads its configuration from. */
4
+ export const CLAUDE_HOME_DIR = '.claude';
5
+ export const CLAUDE_SETTINGS_FILE = 'settings.json';
6
+ export const CLAUDE_EXECUTABLE = 'claude';
7
+ /**
8
+ * Hook events AgentWatch registers in Claude Code.
9
+ *
10
+ * Schema: hooks -> EventName -> [{matcher?, hooks: [{type:"command", command,
11
+ * timeout}]}] (verified against code.claude.com/docs/en/hooks, 2026-08).
12
+ */
13
+ export const CLAUDE_HOOK_EVENTS = [
14
+ 'SessionStart',
15
+ 'SessionEnd',
16
+ 'UserPromptSubmit',
17
+ 'PreToolUse',
18
+ 'PostToolUse',
19
+ 'PostToolUseFailure',
20
+ 'PermissionRequest',
21
+ 'Stop',
22
+ 'SubagentStart',
23
+ 'SubagentStop'
24
+ ];
25
+ /** Tool-scoped events take a tool-name matcher; "*" observes every tool. */
26
+ export const CLAUDE_MATCHED_EVENTS = new Set(['PreToolUse', 'PostToolUse', 'PostToolUseFailure', 'PermissionRequest']);
27
+ /** Claude Code reads this field as seconds. */
28
+ export const CLAUDE_HOOK_TIMEOUT_SECONDS = 30;
29
+ /** Provider hook name to canonical event type, where the mapping is direct. */
30
+ export const CLAUDE_EVENT_TYPE_MAP = {
31
+ SessionStart: 'session.started',
32
+ SessionEnd: 'session.ended',
33
+ UserPromptSubmit: 'prompt.submitted',
34
+ PermissionRequest: 'permission.requested',
35
+ Stop: 'generation.completed',
36
+ SubagentStart: 'subagent.started',
37
+ SubagentStop: 'subagent.completed',
38
+ PreCompact: 'compaction.started',
39
+ PostCompact: 'compaction.completed'
40
+ };
41
+ /** Hooks whose canonical type depends on which tool ran. */
42
+ export const CLAUDE_TOOL_EVENTS = new Set(['PreToolUse', 'PostToolUse', 'PostToolUseFailure', 'PermissionRequest']);
43
+ /** Hooks that report a tool call as starting rather than finishing. */
44
+ export const CLAUDE_TOOL_START_EVENTS = new Set(['PreToolUse', 'PermissionRequest']);
45
+ /**
46
+ * The one hook a budget refusal may travel on.
47
+ *
48
+ * `UserPromptSubmit` is the last moment before the turn's first request, and
49
+ * Claude Code documents `{"decision":"block","reason":…}` there as "the prompt
50
+ * is erased and the reason is shown to the user" — exactly the refusal this
51
+ * feature needs, with the platform's sentence as the reason.
52
+ */
53
+ export const CLAUDE_PROMPT_SUBMIT_EVENTS = new Set(['UserPromptSubmit']);
54
+ export const CLAUDE_UNKNOWN_EVENT = 'unknown';
@@ -0,0 +1,17 @@
1
+ /** Settings key Claude Code reads the OTLP header helper command from. */
2
+ export declare const HEADERS_HELPER_KEY = "otelHeadersHelper";
3
+ /** Settings key holding the environment block telemetry is configured through. */
4
+ export declare const ENV_BLOCK_KEY = "env";
5
+ /**
6
+ * Environment variables that switch Claude Code's exporters on.
7
+ *
8
+ * A disabled exporter is written as an explicit 'none' rather than omitted, so
9
+ * a stale ambient OTEL_* default in the developer's shell can never re-enable a
10
+ * signal the user turned off.
11
+ */
12
+ export declare const OTEL_EXPORTER_NONE = "none";
13
+ export declare const OTEL_EXPORTER_OTLP = "otlp";
14
+ /** JSON, so the backend receives one wire format from every agent. */
15
+ export declare const OTLP_PROTOCOL = "http/json";
16
+ /** Trailing `hook --agent <id>` of a hook command, stripped to reuse the binary. */
17
+ export declare const RE_HOOK_SUFFIX: RegExp;
@@ -0,0 +1,17 @@
1
+ /** Settings key Claude Code reads the OTLP header helper command from. */
2
+ export const HEADERS_HELPER_KEY = 'otelHeadersHelper';
3
+ /** Settings key holding the environment block telemetry is configured through. */
4
+ export const ENV_BLOCK_KEY = 'env';
5
+ /**
6
+ * Environment variables that switch Claude Code's exporters on.
7
+ *
8
+ * A disabled exporter is written as an explicit 'none' rather than omitted, so
9
+ * a stale ambient OTEL_* default in the developer's shell can never re-enable a
10
+ * signal the user turned off.
11
+ */
12
+ export const OTEL_EXPORTER_NONE = 'none';
13
+ export const OTEL_EXPORTER_OTLP = 'otlp';
14
+ /** JSON, so the backend receives one wire format from every agent. */
15
+ export const OTLP_PROTOCOL = 'http/json';
16
+ /** Trailing `hook --agent <id>` of a hook command, stripped to reuse the binary. */
17
+ export const RE_HOOK_SUFFIX = /\s+hook\s+--agent\s+\S+\s*$/;
@@ -0,0 +1,72 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Claude Code hook payload (verified against code.claude.com/docs/en/hooks,
4
+ * 2026-08).
5
+ *
6
+ * Everything optional and passthrough: payloads are untrusted, and a field
7
+ * added by a new Claude Code release must never crash the agent's hook.
8
+ */
9
+ export declare const claudePayloadSchema: z.ZodObject<{
10
+ hook_event_name: z.ZodOptional<z.ZodString>;
11
+ session_id: z.ZodOptional<z.ZodString>;
12
+ prompt_id: z.ZodOptional<z.ZodString>;
13
+ transcript_path: z.ZodOptional<z.ZodString>;
14
+ cwd: z.ZodOptional<z.ZodString>;
15
+ permission_mode: z.ZodOptional<z.ZodString>;
16
+ agent_id: z.ZodOptional<z.ZodString>;
17
+ agent_type: z.ZodOptional<z.ZodString>;
18
+ tool_name: z.ZodOptional<z.ZodString>;
19
+ tool_use_id: z.ZodOptional<z.ZodString>;
20
+ tool_input: z.ZodOptional<z.ZodUnknown>;
21
+ tool_response: z.ZodOptional<z.ZodUnknown>;
22
+ tool_error: z.ZodOptional<z.ZodUnknown>;
23
+ prompt: z.ZodOptional<z.ZodString>;
24
+ source: z.ZodOptional<z.ZodString>;
25
+ model: z.ZodOptional<z.ZodString>;
26
+ reason: z.ZodOptional<z.ZodString>;
27
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
28
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
29
+ denialReason: z.ZodOptional<z.ZodString>;
30
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
31
+ hook_event_name: z.ZodOptional<z.ZodString>;
32
+ session_id: z.ZodOptional<z.ZodString>;
33
+ prompt_id: z.ZodOptional<z.ZodString>;
34
+ transcript_path: z.ZodOptional<z.ZodString>;
35
+ cwd: z.ZodOptional<z.ZodString>;
36
+ permission_mode: z.ZodOptional<z.ZodString>;
37
+ agent_id: z.ZodOptional<z.ZodString>;
38
+ agent_type: z.ZodOptional<z.ZodString>;
39
+ tool_name: z.ZodOptional<z.ZodString>;
40
+ tool_use_id: z.ZodOptional<z.ZodString>;
41
+ tool_input: z.ZodOptional<z.ZodUnknown>;
42
+ tool_response: z.ZodOptional<z.ZodUnknown>;
43
+ tool_error: z.ZodOptional<z.ZodUnknown>;
44
+ prompt: z.ZodOptional<z.ZodString>;
45
+ source: z.ZodOptional<z.ZodString>;
46
+ model: z.ZodOptional<z.ZodString>;
47
+ reason: z.ZodOptional<z.ZodString>;
48
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
49
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
50
+ denialReason: z.ZodOptional<z.ZodString>;
51
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
52
+ hook_event_name: z.ZodOptional<z.ZodString>;
53
+ session_id: z.ZodOptional<z.ZodString>;
54
+ prompt_id: z.ZodOptional<z.ZodString>;
55
+ transcript_path: z.ZodOptional<z.ZodString>;
56
+ cwd: z.ZodOptional<z.ZodString>;
57
+ permission_mode: z.ZodOptional<z.ZodString>;
58
+ agent_id: z.ZodOptional<z.ZodString>;
59
+ agent_type: z.ZodOptional<z.ZodString>;
60
+ tool_name: z.ZodOptional<z.ZodString>;
61
+ tool_use_id: z.ZodOptional<z.ZodString>;
62
+ tool_input: z.ZodOptional<z.ZodUnknown>;
63
+ tool_response: z.ZodOptional<z.ZodUnknown>;
64
+ tool_error: z.ZodOptional<z.ZodUnknown>;
65
+ prompt: z.ZodOptional<z.ZodString>;
66
+ source: z.ZodOptional<z.ZodString>;
67
+ model: z.ZodOptional<z.ZodString>;
68
+ reason: z.ZodOptional<z.ZodString>;
69
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
70
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
71
+ denialReason: z.ZodOptional<z.ZodString>;
72
+ }, z.ZodTypeAny, "passthrough">>;
@@ -0,0 +1,32 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Claude Code hook payload (verified against code.claude.com/docs/en/hooks,
4
+ * 2026-08).
5
+ *
6
+ * Everything optional and passthrough: payloads are untrusted, and a field
7
+ * added by a new Claude Code release must never crash the agent's hook.
8
+ */
9
+ export const claudePayloadSchema = z
10
+ .object({
11
+ hook_event_name: z.string().optional(),
12
+ session_id: z.string().optional(),
13
+ prompt_id: z.string().optional(),
14
+ transcript_path: z.string().optional(),
15
+ cwd: z.string().optional(),
16
+ permission_mode: z.string().optional(),
17
+ agent_id: z.string().optional(),
18
+ agent_type: z.string().optional(),
19
+ tool_name: z.string().optional(),
20
+ tool_use_id: z.string().optional(),
21
+ tool_input: z.unknown().optional(),
22
+ tool_response: z.unknown().optional(),
23
+ tool_error: z.unknown().optional(),
24
+ prompt: z.string().optional(),
25
+ source: z.string().optional(),
26
+ model: z.string().optional(),
27
+ reason: z.string().optional(),
28
+ last_assistant_message: z.string().nullable().optional(),
29
+ stop_hook_active: z.boolean().optional(),
30
+ denialReason: z.string().optional()
31
+ })
32
+ .passthrough();
@@ -0,0 +1,3 @@
1
+ import type { z } from 'zod';
2
+ import type { claudePayloadSchema } from '../schemas/claude.schema.js';
3
+ export type ClaudePayload = z.infer<typeof claudePayloadSchema>;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,11 @@
1
+ import type { AgentWatchEvent } from '../../events/types/events.types.js';
2
+ import type { HookContext } from '../types/provider.types.js';
3
+ export type { CodexPayload } from './types/codex.types.js';
4
+ /**
5
+ * Translate one Codex hook payload into canonical events.
6
+ *
7
+ * @param rawPayload - Raw JSON from the hook's stdin.
8
+ * @param context - Environment and effective config.
9
+ * @returns The canonical events, or an empty list for an unusable payload.
10
+ */
11
+ export declare function parseCodexHookEvent(rawPayload: unknown, context: HookContext): AgentWatchEvent[];