@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,325 @@
1
+ import fs from 'node:fs/promises';
2
+ import { parse as parseToml } from 'smol-toml';
3
+ import { asRecord } from '../../core/object.js';
4
+ import { joinUrl, otlpBaseUrl } from '../../config/config.js';
5
+ import { backupFile, writeFileAtomic } from '../../storage/atomic-file.js';
6
+ import { SECRET_FILE_MODE } from '../../storage/constants/storage.constants.js';
7
+ import { withOtelInstall, withoutOtelInstall } from '../shared/install-record.js';
8
+ import { codexConfigTomlPath } from './codex.detect.js';
9
+ import { CODEX_PROVIDER_ID } from './constants/codex.constants.js';
10
+ import { BLOCK_END, BLOCK_START, CODEX_OTEL_SIGNALS, LOGS_PATH, OTEL_TABLE_KEY, RE_LEADING_NEWLINE, RE_TOML_BACKSLASH, RE_TOML_QUOTE, RE_TRAILING_NEWLINES, TRACES_PATH } from './constants/codex.otel.constants.js';
11
+ /**
12
+ * Configures Codex's own OTLP export.
13
+ *
14
+ * Logs give one `response.completed` / `codex.api_request` usage record per
15
+ * provider request; traces carry thread.id, turn.id and multi-agent linkage.
16
+ * The backend normalizes both into llm.call.
17
+ */
18
+ export class CodexOtelConfigurator {
19
+ /**
20
+ * Whether this agent can export native telemetry at all.
21
+ *
22
+ * @param _env - Unused; Codex always supports it.
23
+ * @returns Always true.
24
+ */
25
+ async supported(_env) {
26
+ return true;
27
+ }
28
+ /**
29
+ * Report whether the machine's telemetry configuration matches what we want.
30
+ *
31
+ * @param context - Environment, paths and config.
32
+ * @returns The status, naming any foreign configuration in the way.
33
+ */
34
+ async inspect(context) {
35
+ const disabled = !codexOtelEnabled(context.config);
36
+ const raw = await readFileOrUndefined(codexConfigTomlPath(context.env));
37
+ if (raw === undefined) {
38
+ if (disabled)
39
+ return { supported: true, configured: true, detail: 'disabled in config (otel)' };
40
+ return { supported: true, configured: false, detail: 'no config.toml' };
41
+ }
42
+ const hasBlock = raw.includes(BLOCK_START);
43
+ if (disabled)
44
+ return inspectDisabled(hasBlock);
45
+ if (hasBlock)
46
+ return inspectManagedBlock(raw, context.config);
47
+ const parsed = tryParseToml(raw);
48
+ if (parsed === undefined)
49
+ return { supported: true, configured: false, detail: 'config.toml unparseable' };
50
+ if (parsed[OTEL_TABLE_KEY] !== undefined) {
51
+ return { supported: true, configured: false, conflict: 'an [otel] section not owned by AgentWatch already exists' };
52
+ }
53
+ return { supported: true, configured: false };
54
+ }
55
+ /**
56
+ * Write the managed `[otel]` block into Codex's config.toml.
57
+ *
58
+ * @param context - Environment, paths, config and install state.
59
+ * @returns Whether the file changed, what to tell the user, and the next
60
+ * install state.
61
+ */
62
+ async configure(context) {
63
+ if (!codexOtelEnabled(context.config))
64
+ return this.configureDisabled(context);
65
+ const otlpBase = otlpBaseUrl(context.config);
66
+ if (!otlpBase)
67
+ return { ok: false, changed: false, messages: ['no backend endpoint configured'] };
68
+ const configPath = codexConfigTomlPath(context.env);
69
+ const raw = (await readFileOrUndefined(configPath)) ?? '';
70
+ const block = renderBlock(otlpBase, context.config.token, context.config.otel);
71
+ const next = raw.includes(BLOCK_START) ? replaceBlock(raw, block) : appendBlock(raw, block);
72
+ if (typeof next !== 'string')
73
+ return { ok: false, changed: false, messages: [next.error(configPath)] };
74
+ if (next === raw)
75
+ return { ok: true, changed: false, messages: ['native OpenTelemetry already configured'] };
76
+ // Belt and braces: a generated file the agent cannot parse would disable
77
+ // every other setting in it, not just telemetry.
78
+ if (tryParseToml(next) === undefined) {
79
+ return { ok: false, changed: false, messages: ['internal error: generated config.toml would not parse; nothing written'] };
80
+ }
81
+ await backupFile(configPath, context.paths.backupsDir, context.env.now());
82
+ // The managed block may carry the bearer token, so the file becomes private.
83
+ await writeFileAtomic(configPath, next, context.config.token ? SECRET_FILE_MODE : undefined);
84
+ return {
85
+ ok: true,
86
+ changed: true,
87
+ messages: [`native OpenTelemetry configured (signals: ${codexSignalNames(context.config.otel).join(', ')})`, 'restart running Codex sessions to pick it up'],
88
+ installState: withOtelInstall(context.installState, CODEX_PROVIDER_ID, {
89
+ configPath,
90
+ ownedKeys: [OTEL_TABLE_KEY],
91
+ configuredAt: context.env.now()
92
+ })
93
+ };
94
+ }
95
+ /**
96
+ * Remove the managed block from Codex's config.toml.
97
+ *
98
+ * Only the marker-delimited region goes; everything the developer wrote
99
+ * around it — comments included — is preserved byte for byte.
100
+ *
101
+ * @param context - Environment, paths and install state.
102
+ * @returns Whether the file changed, what to tell the user, and the next
103
+ * install state.
104
+ */
105
+ async uninstall(context) {
106
+ const configPath = codexConfigTomlPath(context.env);
107
+ const raw = await readFileOrUndefined(configPath);
108
+ if (raw === undefined || !raw.includes(BLOCK_START)) {
109
+ return { ok: true, changed: false, messages: ['no AgentWatch telemetry configuration found'] };
110
+ }
111
+ const next = replaceBlock(raw, undefined);
112
+ if (typeof next !== 'string')
113
+ return { ok: false, changed: false, messages: [next.error(configPath)] };
114
+ await backupFile(configPath, context.paths.backupsDir, context.env.now());
115
+ await writeFileAtomic(configPath, next);
116
+ return {
117
+ ok: true,
118
+ changed: true,
119
+ messages: ['native OpenTelemetry configuration removed'],
120
+ installState: withoutOtelInstall(context.installState, CODEX_PROVIDER_ID)
121
+ };
122
+ }
123
+ /**
124
+ * Handle `configure` when Codex telemetry is deliberately off.
125
+ *
126
+ * @param context - Environment, paths and install state.
127
+ * @returns The outcome.
128
+ */
129
+ async configureDisabled(context) {
130
+ const removed = await this.uninstall(context);
131
+ if (!removed.ok)
132
+ return removed;
133
+ return {
134
+ ok: true,
135
+ changed: removed.changed,
136
+ messages: [
137
+ removed.changed
138
+ ? 'native OpenTelemetry disabled in config; previous configuration removed'
139
+ : 'native OpenTelemetry disabled in config (otel: none)'
140
+ ],
141
+ installState: removed.installState
142
+ };
143
+ }
144
+ }
145
+ /**
146
+ * Whether Codex has any signal to export.
147
+ *
148
+ * Codex exports logs and traces only; `otel.metrics` has no effect here.
149
+ *
150
+ * @param config - Effective configuration.
151
+ * @returns True when logs or traces are on.
152
+ */
153
+ function codexOtelEnabled(config) {
154
+ return config.otel.logs || config.otel.traces;
155
+ }
156
+ /**
157
+ * Names of the Codex-relevant signals that are on.
158
+ *
159
+ * @param signals - The signal selection.
160
+ * @returns Enabled signal names.
161
+ */
162
+ function codexSignalNames(signals) {
163
+ return CODEX_OTEL_SIGNALS.filter((name) => signals[name]);
164
+ }
165
+ /**
166
+ * Status when Codex telemetry is deliberately off.
167
+ *
168
+ * @param hasBlock - Whether our managed block is still in the file.
169
+ * @returns Configured, unless our leftovers are still there.
170
+ */
171
+ function inspectDisabled(hasBlock) {
172
+ if (!hasBlock)
173
+ return { supported: true, configured: true, detail: 'disabled in config (otel)' };
174
+ return {
175
+ supported: true,
176
+ configured: false,
177
+ detail: 'disabled in config, but the AgentWatch [otel] block remains — run `agentwatch setup`'
178
+ };
179
+ }
180
+ /**
181
+ * Status when our managed block is present: does it say what it should?
182
+ *
183
+ * @param raw - The whole config.toml.
184
+ * @param config - Effective configuration.
185
+ * @returns The status.
186
+ */
187
+ function inspectManagedBlock(raw, config) {
188
+ const otlpBase = otlpBaseUrl(config);
189
+ if (!otlpBase)
190
+ return { supported: true, configured: false, detail: 'no backend endpoint configured' };
191
+ const actual = extractBlock(raw);
192
+ const expected = renderBlock(otlpBase, config.token, config.otel).trim();
193
+ if (actual === expected)
194
+ return { supported: true, configured: true };
195
+ return { supported: true, configured: false, detail: 'AgentWatch [otel] block is incomplete or stale — run `agentwatch setup`' };
196
+ }
197
+ /**
198
+ * The managed block, rendered for this configuration.
199
+ *
200
+ * A disabled signal is written as an explicit `"none"` rather than omitted, so
201
+ * an ambient default can never re-enable it.
202
+ *
203
+ * @param otlpBase - Backend OTLP base URL.
204
+ * @param token - Bearer token, when one is configured.
205
+ * @param signals - The signal selection.
206
+ * @returns The block text, newline-terminated.
207
+ */
208
+ function renderBlock(otlpBase, token, signals) {
209
+ const headers = token ? `, headers = { "Authorization" = "Bearer ${escapeTomlString(token)}" }` : '';
210
+ return [
211
+ BLOCK_START,
212
+ `[${OTEL_TABLE_KEY}]`,
213
+ signals.logs
214
+ ? `exporter = { otlp-http = { endpoint = "${escapeTomlString(joinUrl(otlpBase, LOGS_PATH))}", protocol = "json"${headers} } }`
215
+ : 'exporter = "none"',
216
+ signals.traces
217
+ ? `trace_exporter = { otlp-http = { endpoint = "${escapeTomlString(joinUrl(otlpBase, TRACES_PATH))}", protocol = "json"${headers} } }`
218
+ : 'trace_exporter = "none"',
219
+ // Codex has no useful OTLP metrics; off regardless of otel.metrics.
220
+ 'metrics_exporter = "none"',
221
+ BLOCK_END,
222
+ ''
223
+ ].join('\n');
224
+ }
225
+ /**
226
+ * Replace, or remove, the marker-delimited block.
227
+ *
228
+ * @param raw - The whole config.toml.
229
+ * @param block - The new block, or undefined to remove it.
230
+ * @returns The next contents, or a failure when the markers are malformed.
231
+ */
232
+ function replaceBlock(raw, block) {
233
+ const bounds = blockBounds(raw);
234
+ if (!bounds)
235
+ return malformedMarkers;
236
+ const head = raw.slice(0, bounds.start);
237
+ const tail = raw.slice(bounds.end).replace(RE_LEADING_NEWLINE, '');
238
+ if (block === undefined)
239
+ return head.replace(RE_TRAILING_NEWLINES, '\n') + tail;
240
+ return head + block + tail;
241
+ }
242
+ /**
243
+ * Append the managed block to a config that has none.
244
+ *
245
+ * @param raw - The whole config.toml, possibly empty.
246
+ * @param block - The block to add.
247
+ * @returns The next contents, or a failure when the file cannot be touched.
248
+ */
249
+ function appendBlock(raw, block) {
250
+ const parsed = tryParseToml(raw);
251
+ if (raw.trim() !== '' && parsed === undefined)
252
+ return unparseableConfig;
253
+ if (parsed?.[OTEL_TABLE_KEY] !== undefined)
254
+ return foreignOtelTable;
255
+ const separator = raw === '' || raw.endsWith('\n') ? '' : '\n';
256
+ const blankLine = raw.trim() === '' ? '' : '\n';
257
+ return raw + separator + blankLine + block;
258
+ }
259
+ /**
260
+ * Our block's boundaries inside the file.
261
+ *
262
+ * @param raw - The whole config.toml.
263
+ * @returns The start and end offsets, or undefined when the markers are broken.
264
+ */
265
+ function blockBounds(raw) {
266
+ const start = raw.indexOf(BLOCK_START);
267
+ const endMarker = raw.indexOf(BLOCK_END);
268
+ if (start === -1 || endMarker === -1 || endMarker < start)
269
+ return undefined;
270
+ return { start, end: endMarker + BLOCK_END.length };
271
+ }
272
+ /**
273
+ * The managed block as it currently stands in the file.
274
+ *
275
+ * @param raw - The whole config.toml.
276
+ * @returns The block text, or undefined when the markers are broken.
277
+ */
278
+ function extractBlock(raw) {
279
+ const bounds = blockBounds(raw);
280
+ if (!bounds)
281
+ return undefined;
282
+ return raw.slice(bounds.start, bounds.end).trim();
283
+ }
284
+ /**
285
+ * Escape a string for a TOML basic-string literal.
286
+ *
287
+ * @param value - Raw value, possibly a token.
288
+ * @returns The escaped form.
289
+ */
290
+ function escapeTomlString(value) {
291
+ return value.replace(RE_TOML_BACKSLASH, '\\\\').replace(RE_TOML_QUOTE, '\\"');
292
+ }
293
+ /**
294
+ * Read a file, treating any failure as "not there".
295
+ *
296
+ * @param filePath - File to read.
297
+ * @returns Its contents, or undefined.
298
+ */
299
+ async function readFileOrUndefined(filePath) {
300
+ try {
301
+ return await fs.readFile(filePath, 'utf8');
302
+ }
303
+ catch {
304
+ return undefined;
305
+ }
306
+ }
307
+ /**
308
+ * Parse TOML, treating any failure as unparseable.
309
+ *
310
+ * @param raw - TOML text.
311
+ * @returns The parsed table, or undefined.
312
+ */
313
+ function tryParseToml(raw) {
314
+ try {
315
+ return asRecord(parseToml(raw));
316
+ }
317
+ catch {
318
+ return undefined;
319
+ }
320
+ }
321
+ const malformedMarkers = { error: (configPath) => `malformed AgentWatch block markers in ${configPath}; fix manually` };
322
+ const unparseableConfig = { error: (configPath) => `refusing to modify unparseable ${configPath}` };
323
+ const foreignOtelTable = {
324
+ error: (configPath) => `skipping native OpenTelemetry: ${configPath} already has an [otel] section (not AgentWatch-owned)`
325
+ };
@@ -0,0 +1,2 @@
1
+ import type { AgentProvider } from '../provider.js';
2
+ export declare const codexProvider: AgentProvider;
@@ -0,0 +1,25 @@
1
+ import { hookRefusal } from '../shared/hook-refusal.js';
2
+ import { CODEX_PROMPT_SUBMIT_EVENTS } from './constants/codex.constants.js';
3
+ import { detectCodex } from './codex.detect.js';
4
+ import { installCodexHooks, uninstallCodexHooks } from './codex.hooks.js';
5
+ import { parseCodexHookEvent } from './codex.adapter.js';
6
+ import { CodexOtelConfigurator } from './codex.otel.js';
7
+ export const codexProvider = {
8
+ id: 'codex',
9
+ displayName: 'OpenAI Codex',
10
+ detect: detectCodex,
11
+ installHooks: installCodexHooks,
12
+ uninstallHooks: uninstallCodexHooks,
13
+ parseHookEvent: async (payload, context) => parseCodexHookEvent(payload, context),
14
+ /**
15
+ * Codex treats empty stdout + exit 0 as explicit success (verified in
16
+ * output_parser.rs). Anything else risks tripping its strict JSON parser.
17
+ */
18
+ getHookResponse: (_payload) => ({ exitCode: 0 }),
19
+ /**
20
+ * A budget refusal on `UserPromptSubmit`, in the only fields Codex's strict
21
+ * parser accepts.
22
+ */
23
+ getBlockResponse: (payload, message) => hookRefusal(payload, CODEX_PROMPT_SUBMIT_EVENTS, { continue: false, stopReason: message, systemMessage: message }),
24
+ nativeTelemetry: new CodexOtelConfigurator()
25
+ };
@@ -0,0 +1,41 @@
1
+ import type { CanonicalEventType } from '../../../events/types/events.types.js';
2
+ export declare const CODEX_PROVIDER_ID = "codex";
3
+ export declare const CODEX_DISPLAY_NAME = "OpenAI Codex";
4
+ /** Codex's config root, overridable through its own environment variable. */
5
+ export declare const CODEX_HOME_VAR = "CODEX_HOME";
6
+ export declare const CODEX_HOME_DIR = ".codex";
7
+ export declare const CODEX_HOOKS_FILE = "hooks.json";
8
+ export declare const CODEX_CONFIG_FILE = "config.toml";
9
+ export declare const CODEX_EXECUTABLE = "codex";
10
+ /**
11
+ * Codex lifecycle hooks (verified against openai/codex source, 2026-08).
12
+ *
13
+ * File: `~/.codex/hooks.json`. Its top level is strictly
14
+ * `{description?, hooks}` (serde `deny_unknown_fields`), so we must not add any
15
+ * other key. The matcher is optional — absent means match everything. Hooks are
16
+ * enabled by default, but NON-MANAGED HOOKS DO NOT RUN UNTIL THE USER TRUSTS
17
+ * THEM via `/hooks` in the Codex TUI.
18
+ */
19
+ export declare const CODEX_HOOK_EVENTS: readonly ["SessionStart", "SessionEnd", "UserPromptSubmit", "PreToolUse", "PostToolUse", "PermissionRequest", "Stop", "SubagentStart", "SubagentStop", "PreCompact", "PostCompact"];
20
+ /** Codex reads this field as seconds. */
21
+ export declare const CODEX_HOOK_TIMEOUT_SECONDS = 30;
22
+ /** The only two top-level keys Codex's parser accepts in hooks.json. */
23
+ export declare const CODEX_ALLOWED_TOP_LEVEL_KEYS: ReadonlySet<string>;
24
+ /** Manual step Codex requires before a newly registered hook will run. */
25
+ export declare const CODEX_TRUST_NOTE = "Codex requires trusting new hooks: run `codex`, then `/hooks`, and trust the AgentWatch entries.";
26
+ export declare const CODEX_HOOKS_DISABLED_WARNING = "warning: [features] hooks = false in ~/.codex/config.toml \u2014 Codex hooks are disabled";
27
+ /** Provider hook name to canonical event type, where the mapping is direct. */
28
+ export declare const CODEX_EVENT_TYPE_MAP: Readonly<Record<string, CanonicalEventType>>;
29
+ /** Hooks whose canonical type depends on which tool ran. */
30
+ export declare const CODEX_TOOL_EVENTS: ReadonlySet<string>;
31
+ /**
32
+ * The one hook a budget refusal may travel on.
33
+ *
34
+ * Codex's hook result accepts `{continue, stopReason, suppressOutput,
35
+ * systemMessage}` under `deny_unknown_fields`, so a refusal uses only those:
36
+ * `continue: false` stops the turn, `stopReason` is what its parser reads and
37
+ * `systemMessage` is what the user is shown. Both carry the same sentence
38
+ * because the developer and the transcript both need it.
39
+ */
40
+ export declare const CODEX_PROMPT_SUBMIT_EVENTS: ReadonlySet<string>;
41
+ export declare const CODEX_UNKNOWN_EVENT = "unknown";
@@ -0,0 +1,62 @@
1
+ export const CODEX_PROVIDER_ID = 'codex';
2
+ export const CODEX_DISPLAY_NAME = 'OpenAI Codex';
3
+ /** Codex's config root, overridable through its own environment variable. */
4
+ export const CODEX_HOME_VAR = 'CODEX_HOME';
5
+ export const CODEX_HOME_DIR = '.codex';
6
+ export const CODEX_HOOKS_FILE = 'hooks.json';
7
+ export const CODEX_CONFIG_FILE = 'config.toml';
8
+ export const CODEX_EXECUTABLE = 'codex';
9
+ /**
10
+ * Codex lifecycle hooks (verified against openai/codex source, 2026-08).
11
+ *
12
+ * File: `~/.codex/hooks.json`. Its top level is strictly
13
+ * `{description?, hooks}` (serde `deny_unknown_fields`), so we must not add any
14
+ * other key. The matcher is optional — absent means match everything. Hooks are
15
+ * enabled by default, but NON-MANAGED HOOKS DO NOT RUN UNTIL THE USER TRUSTS
16
+ * THEM via `/hooks` in the Codex TUI.
17
+ */
18
+ export const CODEX_HOOK_EVENTS = [
19
+ 'SessionStart',
20
+ 'SessionEnd',
21
+ 'UserPromptSubmit',
22
+ 'PreToolUse',
23
+ 'PostToolUse',
24
+ 'PermissionRequest',
25
+ 'Stop',
26
+ 'SubagentStart',
27
+ 'SubagentStop',
28
+ 'PreCompact',
29
+ 'PostCompact'
30
+ ];
31
+ /** Codex reads this field as seconds. */
32
+ export const CODEX_HOOK_TIMEOUT_SECONDS = 30;
33
+ /** The only two top-level keys Codex's parser accepts in hooks.json. */
34
+ export const CODEX_ALLOWED_TOP_LEVEL_KEYS = new Set(['description', 'hooks']);
35
+ /** Manual step Codex requires before a newly registered hook will run. */
36
+ export const CODEX_TRUST_NOTE = 'Codex requires trusting new hooks: run `codex`, then `/hooks`, and trust the AgentWatch entries.';
37
+ export const CODEX_HOOKS_DISABLED_WARNING = 'warning: [features] hooks = false in ~/.codex/config.toml — Codex hooks are disabled';
38
+ /** Provider hook name to canonical event type, where the mapping is direct. */
39
+ export const CODEX_EVENT_TYPE_MAP = {
40
+ SessionStart: 'session.started',
41
+ SessionEnd: 'session.ended',
42
+ UserPromptSubmit: 'prompt.submitted',
43
+ PermissionRequest: 'permission.requested',
44
+ Stop: 'generation.completed',
45
+ SubagentStart: 'subagent.started',
46
+ SubagentStop: 'subagent.completed',
47
+ PreCompact: 'compaction.started',
48
+ PostCompact: 'compaction.completed'
49
+ };
50
+ /** Hooks whose canonical type depends on which tool ran. */
51
+ export const CODEX_TOOL_EVENTS = new Set(['PreToolUse', 'PostToolUse', 'PermissionRequest']);
52
+ /**
53
+ * The one hook a budget refusal may travel on.
54
+ *
55
+ * Codex's hook result accepts `{continue, stopReason, suppressOutput,
56
+ * systemMessage}` under `deny_unknown_fields`, so a refusal uses only those:
57
+ * `continue: false` stops the turn, `stopReason` is what its parser reads and
58
+ * `systemMessage` is what the user is shown. Both carry the same sentence
59
+ * because the developer and the transcript both need it.
60
+ */
61
+ export const CODEX_PROMPT_SUBMIT_EVENTS = new Set(['UserPromptSubmit']);
62
+ export const CODEX_UNKNOWN_EVENT = 'unknown';
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Markers delimiting the block AgentWatch owns inside the user's config.toml.
3
+ *
4
+ * Codex's telemetry lives in a `[otel]` table in `~/.codex/config.toml`
5
+ * (project-level files ignore the key, so only the user-level one works).
6
+ * Rewriting that file through a TOML serializer would destroy the developer's
7
+ * comments and formatting, so instead we own a marker-delimited block appended
8
+ * to it — and only when no foreign `[otel]` table already exists.
9
+ */
10
+ export declare const BLOCK_START = "# >>> agentwatch managed block \u2014 do not edit; `agentwatch uninstall` removes it >>>";
11
+ export declare const BLOCK_END = "# <<< agentwatch managed block <<<";
12
+ /** The one config key the managed block owns. */
13
+ export declare const OTEL_TABLE_KEY = "otel";
14
+ /** Signals Codex actually exports; `metrics` has no effect there. */
15
+ export declare const CODEX_OTEL_SIGNALS: readonly ["logs", "traces"];
16
+ /** OTLP/HTTP signal routes; Codex needs full endpoints, not a base. */
17
+ export declare const LOGS_PATH = "/v1/logs";
18
+ export declare const TRACES_PATH = "/v1/traces";
19
+ export declare const RE_LEADING_NEWLINE: RegExp;
20
+ export declare const RE_TRAILING_NEWLINES: RegExp;
21
+ export declare const RE_TOML_BACKSLASH: RegExp;
22
+ export declare const RE_TOML_QUOTE: RegExp;
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Markers delimiting the block AgentWatch owns inside the user's config.toml.
3
+ *
4
+ * Codex's telemetry lives in a `[otel]` table in `~/.codex/config.toml`
5
+ * (project-level files ignore the key, so only the user-level one works).
6
+ * Rewriting that file through a TOML serializer would destroy the developer's
7
+ * comments and formatting, so instead we own a marker-delimited block appended
8
+ * to it — and only when no foreign `[otel]` table already exists.
9
+ */
10
+ export const BLOCK_START = '# >>> agentwatch managed block — do not edit; `agentwatch uninstall` removes it >>>';
11
+ export const BLOCK_END = '# <<< agentwatch managed block <<<';
12
+ /** The one config key the managed block owns. */
13
+ export const OTEL_TABLE_KEY = 'otel';
14
+ /** Signals Codex actually exports; `metrics` has no effect there. */
15
+ export const CODEX_OTEL_SIGNALS = ['logs', 'traces'];
16
+ /** OTLP/HTTP signal routes; Codex needs full endpoints, not a base. */
17
+ export const LOGS_PATH = '/v1/logs';
18
+ export const TRACES_PATH = '/v1/traces';
19
+ export const RE_LEADING_NEWLINE = /^\n/;
20
+ export const RE_TRAILING_NEWLINES = /\n+$/;
21
+ export const RE_TOML_BACKSLASH = /\\/g;
22
+ export const RE_TOML_QUOTE = /"/g;
@@ -0,0 +1,70 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Codex hook payload (verified against openai/codex generated hook schemas,
4
+ * 2026-08): session_id (thread UUID), turn_id, cwd, hook_event_name, model,
5
+ * permission_mode, transcript_path; tool events add
6
+ * tool_name/tool_use_id/tool_input/tool_response.
7
+ *
8
+ * Loose and passthrough: the input is untrusted.
9
+ */
10
+ export declare const codexPayloadSchema: z.ZodObject<{
11
+ hook_event_name: z.ZodOptional<z.ZodString>;
12
+ session_id: z.ZodOptional<z.ZodString>;
13
+ thread_id: z.ZodOptional<z.ZodString>;
14
+ turn_id: z.ZodOptional<z.ZodString>;
15
+ cwd: z.ZodOptional<z.ZodString>;
16
+ model: z.ZodOptional<z.ZodString>;
17
+ permission_mode: z.ZodOptional<z.ZodString>;
18
+ agent_id: z.ZodOptional<z.ZodString>;
19
+ agent_type: z.ZodOptional<z.ZodString>;
20
+ tool_name: z.ZodOptional<z.ZodString>;
21
+ tool_use_id: z.ZodOptional<z.ZodString>;
22
+ tool_input: z.ZodOptional<z.ZodUnknown>;
23
+ tool_response: z.ZodOptional<z.ZodUnknown>;
24
+ prompt: z.ZodOptional<z.ZodString>;
25
+ source: z.ZodOptional<z.ZodString>;
26
+ reason: z.ZodOptional<z.ZodString>;
27
+ trigger: z.ZodOptional<z.ZodString>;
28
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
29
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
30
+ }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
31
+ hook_event_name: z.ZodOptional<z.ZodString>;
32
+ session_id: z.ZodOptional<z.ZodString>;
33
+ thread_id: z.ZodOptional<z.ZodString>;
34
+ turn_id: z.ZodOptional<z.ZodString>;
35
+ cwd: z.ZodOptional<z.ZodString>;
36
+ model: z.ZodOptional<z.ZodString>;
37
+ permission_mode: z.ZodOptional<z.ZodString>;
38
+ agent_id: z.ZodOptional<z.ZodString>;
39
+ agent_type: z.ZodOptional<z.ZodString>;
40
+ tool_name: z.ZodOptional<z.ZodString>;
41
+ tool_use_id: z.ZodOptional<z.ZodString>;
42
+ tool_input: z.ZodOptional<z.ZodUnknown>;
43
+ tool_response: z.ZodOptional<z.ZodUnknown>;
44
+ prompt: z.ZodOptional<z.ZodString>;
45
+ source: z.ZodOptional<z.ZodString>;
46
+ reason: z.ZodOptional<z.ZodString>;
47
+ trigger: z.ZodOptional<z.ZodString>;
48
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
49
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
50
+ }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
51
+ hook_event_name: z.ZodOptional<z.ZodString>;
52
+ session_id: z.ZodOptional<z.ZodString>;
53
+ thread_id: z.ZodOptional<z.ZodString>;
54
+ turn_id: z.ZodOptional<z.ZodString>;
55
+ cwd: z.ZodOptional<z.ZodString>;
56
+ model: 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
+ prompt: z.ZodOptional<z.ZodString>;
65
+ source: z.ZodOptional<z.ZodString>;
66
+ reason: z.ZodOptional<z.ZodString>;
67
+ trigger: z.ZodOptional<z.ZodString>;
68
+ last_assistant_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
69
+ stop_hook_active: z.ZodOptional<z.ZodBoolean>;
70
+ }, z.ZodTypeAny, "passthrough">>;
@@ -0,0 +1,32 @@
1
+ import { z } from 'zod';
2
+ /**
3
+ * Codex hook payload (verified against openai/codex generated hook schemas,
4
+ * 2026-08): session_id (thread UUID), turn_id, cwd, hook_event_name, model,
5
+ * permission_mode, transcript_path; tool events add
6
+ * tool_name/tool_use_id/tool_input/tool_response.
7
+ *
8
+ * Loose and passthrough: the input is untrusted.
9
+ */
10
+ export const codexPayloadSchema = z
11
+ .object({
12
+ hook_event_name: z.string().optional(),
13
+ session_id: z.string().optional(),
14
+ thread_id: z.string().optional(),
15
+ turn_id: z.string().optional(),
16
+ cwd: z.string().optional(),
17
+ model: z.string().optional(),
18
+ permission_mode: z.string().optional(),
19
+ agent_id: z.string().optional(),
20
+ agent_type: z.string().optional(),
21
+ tool_name: z.string().optional(),
22
+ tool_use_id: z.string().optional(),
23
+ tool_input: z.unknown().optional(),
24
+ tool_response: z.unknown().optional(),
25
+ prompt: z.string().optional(),
26
+ source: z.string().optional(),
27
+ reason: z.string().optional(),
28
+ trigger: z.string().optional(),
29
+ last_assistant_message: z.string().nullable().optional(),
30
+ stop_hook_active: z.boolean().optional()
31
+ })
32
+ .passthrough();
@@ -0,0 +1,3 @@
1
+ import type { z } from 'zod';
2
+ import type { codexPayloadSchema } from '../schemas/codex.schema.js';
3
+ export type CodexPayload = z.infer<typeof codexPayloadSchema>;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,33 @@
1
+ /** Substring identifying AgentWatch-owned hook entries in agent configs. */
2
+ export declare const HOOK_COMMAND_MARKER = "agentwatch";
3
+ /**
4
+ * Agent ids a hook command may name.
5
+ *
6
+ * The allowlist is what stops a foreign `my-tool hook --agent x` from being
7
+ * claimed — and then deleted — as AgentWatch's own.
8
+ */
9
+ export declare const KNOWN_AGENT_IDS: ReadonlySet<string>;
10
+ /** An executable named `agentwatch`, with or without a platform suffix. */
11
+ export declare const RE_AGENTWATCH_BINARY: RegExp;
12
+ /**
13
+ * A Node-compatible runtime.
14
+ *
15
+ * buildHookCommand embeds process.execPath, so hooks written by earlier
16
+ * installs may name any of these — including versioned binaries (node22) and
17
+ * TypeScript runners (tsx, deno). Failing to recognize one would leave the
18
+ * stale hook in place next to a fresh duplicate, and every turn would then be
19
+ * processed — and counted — twice.
20
+ */
21
+ export declare const RE_NODE_BINARY: RegExp;
22
+ /** The CLI entry point, in any form the build or a dev run produces. */
23
+ export declare const RE_CLI_SCRIPT: RegExp;
24
+ /** Path separator, either platform's. */
25
+ export declare const RE_PATH_SEPARATOR: RegExp;
26
+ /** Shell control operators; their presence disqualifies a command outright. */
27
+ export declare const RE_SHELL_CONTROL: RegExp;
28
+ /** Characters a double quote still escapes inside a quoted argument. */
29
+ export declare const RE_DOUBLE_QUOTE_ESCAPABLE: RegExp;
30
+ export declare const RE_WHITESPACE: RegExp;
31
+ /** Argument shape that forces quoting when a hook command is generated. */
32
+ export declare const RE_NEEDS_QUOTING: RegExp;
33
+ export declare const RE_QUOTE_ESCAPE: RegExp;