@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,41 @@
1
+ import type { CheckLevel, LevelSymbols } from './types/cli.types.js';
2
+ export type { CheckLevel, LevelSymbols } from './types/cli.types.js';
3
+ /** Status glyphs, one per outcome. */
4
+ export declare const symbols: LevelSymbols;
5
+ /**
6
+ * Emphasize a heading.
7
+ *
8
+ * @param text - The text.
9
+ * @returns The text, bold when the terminal supports it.
10
+ */
11
+ export declare function bold(text: string): string;
12
+ /**
13
+ * De-emphasize a detail.
14
+ *
15
+ * @param text - The text.
16
+ * @returns The text, dimmed when the terminal supports it.
17
+ */
18
+ export declare function dim(text: string): string;
19
+ /**
20
+ * The glyph for one check outcome.
21
+ *
22
+ * @param level - The outcome.
23
+ * @returns Its glyph.
24
+ */
25
+ export declare function levelSymbol(level: CheckLevel): string;
26
+ /**
27
+ * Write one line to stdout.
28
+ *
29
+ * @param line - The line, without its newline.
30
+ */
31
+ export declare function println(line?: string): void;
32
+ /**
33
+ * Write one line to stderr.
34
+ *
35
+ * Refusals go here, not to stdout: a scripted rollout reads the exit code and
36
+ * the error stream, and a failure printed among the progress lines is a failure
37
+ * nobody sees.
38
+ *
39
+ * @param line - The line, without its newline.
40
+ */
41
+ export declare function printErrln(line?: string): void;
package/dist/cli/ui.js ADDED
@@ -0,0 +1,78 @@
1
+ import process from 'node:process';
2
+ import { COLOR_BOLD, COLOR_GREEN, COLOR_GREY, COLOR_RED, COLOR_RESET, COLOR_YELLOW, ESC, NO_COLOR_VAR } from './constants/cli.constants.js';
3
+ /**
4
+ * Human-facing output helpers.
5
+ *
6
+ * Only setup, status and doctor use these. A hook execution never writes to
7
+ * stdout through this module: stdout belongs to the agent's hook protocol, and
8
+ * a stray line there is a protocol error.
9
+ */
10
+ const useColor = Boolean(process.stdout.isTTY) && !process.env[NO_COLOR_VAR];
11
+ /** Status glyphs, one per outcome. */
12
+ export const symbols = {
13
+ ok: paint('✓', COLOR_GREEN),
14
+ warn: paint('!', COLOR_YELLOW),
15
+ fail: paint('✗', COLOR_RED),
16
+ off: paint('○', COLOR_GREY)
17
+ };
18
+ /**
19
+ * Emphasize a heading.
20
+ *
21
+ * @param text - The text.
22
+ * @returns The text, bold when the terminal supports it.
23
+ */
24
+ export function bold(text) {
25
+ return paint(text, COLOR_BOLD);
26
+ }
27
+ /**
28
+ * De-emphasize a detail.
29
+ *
30
+ * @param text - The text.
31
+ * @returns The text, dimmed when the terminal supports it.
32
+ */
33
+ export function dim(text) {
34
+ return paint(text, COLOR_GREY);
35
+ }
36
+ /**
37
+ * The glyph for one check outcome.
38
+ *
39
+ * @param level - The outcome.
40
+ * @returns Its glyph.
41
+ */
42
+ export function levelSymbol(level) {
43
+ if (level === 'ok')
44
+ return symbols.ok;
45
+ if (level === 'warn')
46
+ return symbols.warn;
47
+ return symbols.fail;
48
+ }
49
+ /**
50
+ * Write one line to stdout.
51
+ *
52
+ * @param line - The line, without its newline.
53
+ */
54
+ export function println(line = '') {
55
+ process.stdout.write(line + '\n');
56
+ }
57
+ /**
58
+ * Write one line to stderr.
59
+ *
60
+ * Refusals go here, not to stdout: a scripted rollout reads the exit code and
61
+ * the error stream, and a failure printed among the progress lines is a failure
62
+ * nobody sees.
63
+ *
64
+ * @param line - The line, without its newline.
65
+ */
66
+ export function printErrln(line = '') {
67
+ process.stderr.write(line + '\n');
68
+ }
69
+ /**
70
+ * Wrap text in an ANSI colour, when the terminal wants colour at all.
71
+ *
72
+ * @param text - The text.
73
+ * @param code - SGR parameter.
74
+ * @returns The wrapped, or bare, text.
75
+ */
76
+ function paint(text, code) {
77
+ return useColor ? `${ESC}[${code}m${text}${ESC}[${COLOR_RESET}m` : text;
78
+ }
@@ -0,0 +1,13 @@
1
+ import type { UninstallOptions } from './types/cli.types.js';
2
+ export type { UninstallOptions } from './types/cli.types.js';
3
+ /**
4
+ * `agentwatch uninstall` — remove AgentWatch's own entries from agent configs.
5
+ *
6
+ * Only our entries: a user's own hooks, and every unrelated setting in the same
7
+ * files, survive. Local configuration and the queue are kept unless `--purge`
8
+ * asks for them, because a reinstall should not have to be re-configured.
9
+ *
10
+ * @param options - Environment, optional single agent, purge flag.
11
+ * @returns 0 when every step succeeded, else 1.
12
+ */
13
+ export declare function runUninstall(options: UninstallOptions): Promise<number>;
@@ -0,0 +1,83 @@
1
+ import fs from 'node:fs/promises';
2
+ import { getProvider, providerIds, providers } from '../providers/registry.js';
3
+ import { saveInstallState } from '../storage/install-state.js';
4
+ import { buildCliContext, buildHookCommand } from './context.js';
5
+ import { bold, println, symbols } from './ui.js';
6
+ /**
7
+ * `agentwatch uninstall` — remove AgentWatch's own entries from agent configs.
8
+ *
9
+ * Only our entries: a user's own hooks, and every unrelated setting in the same
10
+ * files, survive. Local configuration and the queue are kept unless `--purge`
11
+ * asks for them, because a reinstall should not have to be re-configured.
12
+ *
13
+ * @param options - Environment, optional single agent, purge flag.
14
+ * @returns 0 when every step succeeded, else 1.
15
+ */
16
+ export async function runUninstall(options) {
17
+ const context = await buildCliContext(options.env);
18
+ println(bold('AgentWatch Uninstall'));
19
+ println();
20
+ const targets = resolveTargets(options.agent);
21
+ if (!targets) {
22
+ println(`${symbols.fail} unknown agent "${options.agent}" (known: ${providerIds.join(', ')})`);
23
+ return 1;
24
+ }
25
+ let installState = context.installState;
26
+ let failures = 0;
27
+ for (const provider of targets) {
28
+ println(bold(provider.displayName));
29
+ const setupContext = {
30
+ env: options.env,
31
+ paths: context.paths,
32
+ config: context.config,
33
+ hookCommand: buildHookCommand(options.env, provider.id),
34
+ installState
35
+ };
36
+ const hooks = await provider.uninstallHooks(setupContext);
37
+ installState = report(hooks, installState);
38
+ if (!hooks.ok)
39
+ failures++;
40
+ if (provider.nativeTelemetry) {
41
+ const otel = await provider.nativeTelemetry.uninstall({ ...setupContext, installState });
42
+ installState = report(otel, installState);
43
+ if (!otel.ok)
44
+ failures++;
45
+ }
46
+ println();
47
+ }
48
+ await saveInstallState(context.paths, installState);
49
+ if (options.purge && !options.agent) {
50
+ await fs.rm(context.paths.dataDir, { recursive: true, force: true });
51
+ await fs.rm(context.paths.configDir, { recursive: true, force: true });
52
+ println(`${symbols.ok} local configuration and queued data removed`);
53
+ }
54
+ if (!options.purge || options.agent) {
55
+ println(`local config kept at ${context.paths.configFile} (use --purge to remove)`);
56
+ }
57
+ return failures === 0 ? 0 : 1;
58
+ }
59
+ /**
60
+ * Which providers this run touches.
61
+ *
62
+ * @param agent - Value of `--agent`, when given.
63
+ * @returns The providers, or undefined when the named agent is unknown.
64
+ */
65
+ function resolveTargets(agent) {
66
+ if (!agent)
67
+ return providers;
68
+ const provider = getProvider(agent);
69
+ return provider ? [provider] : undefined;
70
+ }
71
+ /**
72
+ * Print an outcome and carry its install state forward.
73
+ *
74
+ * @param outcome - What the operation reported.
75
+ * @param current - Install state before it ran.
76
+ * @returns The install state to pass to the next operation.
77
+ */
78
+ function report(outcome, current) {
79
+ for (const message of outcome.messages) {
80
+ println(`${outcome.ok ? symbols.ok : symbols.fail} ${message}`);
81
+ }
82
+ return outcome.installState ?? current;
83
+ }
package/dist/cli.d.ts ADDED
@@ -0,0 +1,2 @@
1
+ #!/usr/bin/env node
2
+ export {};
package/dist/cli.js ADDED
@@ -0,0 +1,124 @@
1
+ #!/usr/bin/env node
2
+ import process from 'node:process';
3
+ import { realEnv } from './core/env.js';
4
+ import { setVerbose } from './core/logger.js';
5
+ // Parsing lives in its own module so tests can import it without executing
6
+ // main(); command modules stay lazily loaded off the hook critical path.
7
+ import { boolFlag, parseArgs, stringFlag } from './cli/args.js';
8
+ const HELP = `agentwatch — telemetry edge for AI coding agents
9
+
10
+ Usage:
11
+ agentwatch setup [enrollment-url] [--endpoint <url>] [--token <token>] [--developer-email <email>] [--otel <signals>] [--yes]
12
+ agentwatch status
13
+ agentwatch doctor [--json]
14
+ agentwatch uninstall [--agent <id>] [--purge]
15
+ agentwatch hook --agent <id> [--dry-run] (invoked by agents; reads stdin)
16
+ agentwatch agents
17
+ agentwatch config
18
+ agentwatch otel-headers
19
+
20
+ Flags:
21
+ --endpoint <url> backend base URL events are sent to
22
+ --token <token> bearer token for the backend
23
+ --developer-email <email> identity attached to turn summaries and keyed on by per-developer
24
+ enforcement (default: git config user.email; setup fails when neither
25
+ names a developer)
26
+ --otel <signals> native OTLP signals agents export to the backend: comma list of
27
+ logs,traces,metrics, or "all"/"none" (default: logs — the
28
+ per-request usage/cost ledger the backend turns into llm.call)
29
+ --yes non-interactive: never prompt, fail if required values are missing
30
+ (alias: --non-interactive)
31
+ --agent <id> limit the command to one agent (claude | codex | cursor)
32
+ --purge uninstall: also delete ~/.agentwatch and queued local data
33
+ --dry-run hook: print resulting events to stdout instead of sending
34
+ --json doctor: machine-readable output
35
+ --verbose extra diagnostics on stderr
36
+ --version print version
37
+
38
+ Configuration:
39
+ global ~/.agentwatch/config.json (written by setup)
40
+ per repository .agentwatch.json in the repo root — overrides the global
41
+ config for work in that repo; "token", "installationId",
42
+ "developerEmail", "endpoint", "eventsUrl" and "otlpUrl"
43
+ are global-only and ignored there
44
+ `;
45
+ /**
46
+ * Dispatch one CLI invocation.
47
+ *
48
+ * Command modules are imported lazily: the `hook` subcommand runs on the coding
49
+ * agent's critical path, and loading setup, doctor and status on the way to it
50
+ * would cost every hook their startup.
51
+ *
52
+ * @returns The process exit code.
53
+ */
54
+ async function main() {
55
+ const parsed = parseArgs(process.argv.slice(2));
56
+ if (boolFlag(parsed, 'verbose'))
57
+ setVerbose(true);
58
+ const env = realEnv();
59
+ switch (parsed.command) {
60
+ case 'hook': {
61
+ const { runHook } = await import('./cli/hook.js');
62
+ return runHook(stringFlag(parsed, 'agent') ?? '', { env, dryRun: boolFlag(parsed, 'dry-run') });
63
+ }
64
+ case 'setup': {
65
+ const { runSetup } = await import('./cli/setup.js');
66
+ return runSetup({
67
+ env,
68
+ setupUrl: parsed.positional[0],
69
+ endpoint: stringFlag(parsed, 'endpoint'),
70
+ token: stringFlag(parsed, 'token'),
71
+ developerEmail: stringFlag(parsed, 'developer-email'),
72
+ otel: stringFlag(parsed, 'otel'),
73
+ yes: boolFlag(parsed, 'yes') || boolFlag(parsed, 'non-interactive')
74
+ });
75
+ }
76
+ case 'status': {
77
+ const { runStatus } = await import('./cli/status.js');
78
+ return runStatus(env);
79
+ }
80
+ case 'doctor': {
81
+ const { runDoctor } = await import('./cli/doctor.js');
82
+ return runDoctor(env, { json: boolFlag(parsed, 'json') });
83
+ }
84
+ case 'uninstall': {
85
+ const { runUninstall } = await import('./cli/uninstall.js');
86
+ return runUninstall({ env, agent: stringFlag(parsed, 'agent'), purge: boolFlag(parsed, 'purge') });
87
+ }
88
+ case 'agents': {
89
+ const { runAgents } = await import('./cli/misc.js');
90
+ return runAgents(env);
91
+ }
92
+ case 'config': {
93
+ const { runConfig } = await import('./cli/misc.js');
94
+ return runConfig(env);
95
+ }
96
+ case 'otel-headers': {
97
+ const { runOtelHeaders } = await import('./cli/misc.js');
98
+ return runOtelHeaders(env);
99
+ }
100
+ default:
101
+ return runFallback(parsed);
102
+ }
103
+ }
104
+ /**
105
+ * Handle `--version`, `help`, and an unrecognized command.
106
+ *
107
+ * @param parsed - Parsed arguments.
108
+ * @returns The process exit code.
109
+ */
110
+ async function runFallback(parsed) {
111
+ if (boolFlag(parsed, 'version')) {
112
+ const { createRequire } = await import('node:module');
113
+ const pkg = createRequire(import.meta.url)('../package.json');
114
+ process.stdout.write(pkg.version + '\n');
115
+ return 0;
116
+ }
117
+ process.stdout.write(HELP);
118
+ return parsed.command === undefined || parsed.command === 'help' ? 0 : 1;
119
+ }
120
+ main().then((code) => process.exit(code), (error) => {
121
+ process.stderr.write(`[agentwatch] fatal: ${error.stack ?? error}\n`);
122
+ // A crashing hook must not break the calling agent.
123
+ process.exit(process.argv[2] === 'hook' ? 0 : 1);
124
+ });
@@ -0,0 +1,29 @@
1
+ import type { AgentWatchPaths } from '../storage/types/storage.types.js';
2
+ import type { AgentWatchConfig, ConfigLoadResult } from './types/config.types.js';
3
+ export type { ConfigLoadResult } from './types/config.types.js';
4
+ /**
5
+ * Read the global config.
6
+ *
7
+ * Never throws and never returns without a usable config: hooks run inside the
8
+ * coding agent, and a broken config file must degrade behaviour, not break the
9
+ * agent. The caller distinguishes the three outcomes to decide what to *say*
10
+ * about it.
11
+ *
12
+ * @param paths - Resolved AgentWatch paths.
13
+ * @returns The load state and a config to run with.
14
+ */
15
+ export declare function loadConfig(paths: AgentWatchPaths): Promise<ConfigLoadResult>;
16
+ /**
17
+ * Persist the global config atomically.
18
+ *
19
+ * @param paths - Resolved AgentWatch paths.
20
+ * @param config - Config to write.
21
+ */
22
+ export declare function saveConfig(paths: AgentWatchPaths, config: AgentWatchConfig): Promise<void>;
23
+ /**
24
+ * The config with an installation id, generating one on first use.
25
+ *
26
+ * @param config - Config to complete.
27
+ * @returns The same config, or a copy carrying a fresh id.
28
+ */
29
+ export declare function ensureInstallationId(config: AgentWatchConfig): AgentWatchConfig;
@@ -0,0 +1,75 @@
1
+ import crypto from 'node:crypto';
2
+ import { readJsonFile } from '../storage/json-file.js';
3
+ import { writeFileAtomic } from '../storage/atomic-file.js';
4
+ import { SECRET_FILE_MODE } from '../storage/constants/storage.constants.js';
5
+ import { defaultConfig } from './config.js';
6
+ import { configSchema } from './schemas/config.schema.js';
7
+ /**
8
+ * Read the global config.
9
+ *
10
+ * Never throws and never returns without a usable config: hooks run inside the
11
+ * coding agent, and a broken config file must degrade behaviour, not break the
12
+ * agent. The caller distinguishes the three outcomes to decide what to *say*
13
+ * about it.
14
+ *
15
+ * @param paths - Resolved AgentWatch paths.
16
+ * @returns The load state and a config to run with.
17
+ */
18
+ export async function loadConfig(paths) {
19
+ const result = await readJsonFile(paths.configFile);
20
+ if (result.state === 'missing')
21
+ return { state: 'missing', config: fallbackConfig() };
22
+ if (result.state === 'invalid')
23
+ return { state: 'invalid', error: result.error, config: fallbackConfig() };
24
+ const parsed = configSchema.safeParse(result.value);
25
+ if (!parsed.success)
26
+ return { state: 'invalid', error: describeIssues(parsed.error.issues), config: fallbackConfig() };
27
+ return { state: 'ok', config: parsed.data };
28
+ }
29
+ /**
30
+ * Persist the global config atomically.
31
+ *
32
+ * @param paths - Resolved AgentWatch paths.
33
+ * @param config - Config to write.
34
+ */
35
+ export async function saveConfig(paths, config) {
36
+ // 0600: the file may contain a backend token.
37
+ await writeFileAtomic(paths.configFile, JSON.stringify(config, null, 2) + '\n', SECRET_FILE_MODE);
38
+ }
39
+ /**
40
+ * The config with an installation id, generating one on first use.
41
+ *
42
+ * @param config - Config to complete.
43
+ * @returns The same config, or a copy carrying a fresh id.
44
+ */
45
+ export function ensureInstallationId(config) {
46
+ if (config.installationId)
47
+ return config;
48
+ return { ...config, installationId: crypto.randomUUID() };
49
+ }
50
+ /**
51
+ * Fail-safe runtime config for a missing or corrupt file.
52
+ *
53
+ * Hooks keep running, but content capture is OFF: an accidental config wipe
54
+ * must not silently start collecting prompts and tool I/O. Deliberately
55
+ * different from `defaultConfig()`, which is what setup writes when the user
56
+ * asked for an install.
57
+ *
58
+ * @returns A metadata-only config.
59
+ */
60
+ function fallbackConfig() {
61
+ const config = defaultConfig();
62
+ return {
63
+ ...config,
64
+ capture: { ...config.capture, prompts: false, responses: false, toolInput: false, toolOutput: false }
65
+ };
66
+ }
67
+ /**
68
+ * Render schema issues as one human-readable line.
69
+ *
70
+ * @param issues - Zod issues from a failed parse.
71
+ * @returns The joined description.
72
+ */
73
+ function describeIssues(issues) {
74
+ return issues.map((issue) => `${issue.path.join('.')}: ${issue.message}`).join('; ');
75
+ }
@@ -0,0 +1,73 @@
1
+ import type { AgentWatchConfig, OtelConfig, OtelSignalName } from './types/config.types.js';
2
+ export { captureSchema, configSchema, deliverySchema, emitSchema, enforcementSchema, otelSchema } from './schemas/config.schema.js';
3
+ export type { AgentWatchConfig, CaptureConfig, EnforcementConfig, OtelConfig, OtelSignalName } from './types/config.types.js';
4
+ /**
5
+ * The configuration a deliberate `agentwatch setup` writes: full capture.
6
+ *
7
+ * Distinct from the runtime fallback in config-store, which is what a
8
+ * *missing* config degrades to.
9
+ *
10
+ * @returns A config with every default applied.
11
+ */
12
+ export declare function defaultConfig(): AgentWatchConfig;
13
+ /**
14
+ * Whether any native OTLP signal is enabled.
15
+ *
16
+ * @param config - Effective configuration.
17
+ * @returns True when at least one signal is on.
18
+ */
19
+ export declare function otelEnabled(config: AgentWatchConfig): boolean;
20
+ /**
21
+ * Names of the enabled OTLP signals, for setup and status messages.
22
+ *
23
+ * @param otel - The signal selection.
24
+ * @returns Enabled signal names in canonical order.
25
+ */
26
+ export declare function enabledSignalNames(otel: OtelConfig): OtelSignalName[];
27
+ /**
28
+ * Parse the `--otel` CLI value: "all", "none", or a comma list of
29
+ * logs/traces/metrics.
30
+ *
31
+ * Returns undefined — rather than ignoring the bad name — so setup can fail
32
+ * the whole run on a typo instead of silently configuring the wrong signals.
33
+ *
34
+ * @param value - Raw flag value.
35
+ * @returns The selection, or undefined when a name is unknown.
36
+ */
37
+ export declare function parseOtelSignals(value: string): OtelConfig | undefined;
38
+ /**
39
+ * Where product events are POSTed.
40
+ *
41
+ * @param config - Effective configuration.
42
+ * @returns The events URL, or undefined when no backend is configured.
43
+ */
44
+ export declare function eventsUrl(config: AgentWatchConfig): string | undefined;
45
+ /**
46
+ * Base URL agents' native OTLP exporters point at.
47
+ *
48
+ * Standard OTLP/HTTP exporters append /v1/logs, /v1/traces and /v1/metrics to
49
+ * this base themselves, so it must stay a base and not a signal route.
50
+ *
51
+ * @param config - Effective configuration.
52
+ * @returns The OTLP base URL, or undefined when no backend is configured.
53
+ */
54
+ export declare function otlpBaseUrl(config: AgentWatchConfig): string | undefined;
55
+ /**
56
+ * Where the pre-turn budget check asks its question.
57
+ *
58
+ * Derived from the same base as everything else, so a tenant configures one
59
+ * endpoint; the override exists for the same reason the other two do — a
60
+ * deployment that does not put every route behind one host.
61
+ *
62
+ * @param config - Effective configuration.
63
+ * @returns The decision URL, or undefined when no backend is configured.
64
+ */
65
+ export declare function enforcementUrl(config: AgentWatchConfig): string | undefined;
66
+ /**
67
+ * Join a base URL and a path without doubling the separator.
68
+ *
69
+ * @param base - Base URL, with or without a trailing slash.
70
+ * @param suffix - Path beginning with a slash.
71
+ * @returns The joined URL.
72
+ */
73
+ export declare function joinUrl(base: string, suffix: string): string;
@@ -0,0 +1,115 @@
1
+ import { ENFORCEMENT_PATH, EVENTS_PATH, OTEL_ALL, OTEL_NONE, OTEL_SIGNAL_NAMES, OTEL_SIGNAL_NAME_SET, OTLP_BASE_PATH, RE_TRAILING_SLASHES } from './constants/config.constants.js';
2
+ import { configSchema } from './schemas/config.schema.js';
3
+ export { captureSchema, configSchema, deliverySchema, emitSchema, enforcementSchema, otelSchema } from './schemas/config.schema.js';
4
+ /**
5
+ * The configuration a deliberate `agentwatch setup` writes: full capture.
6
+ *
7
+ * Distinct from the runtime fallback in config-store, which is what a
8
+ * *missing* config degrades to.
9
+ *
10
+ * @returns A config with every default applied.
11
+ */
12
+ export function defaultConfig() {
13
+ return configSchema.parse({});
14
+ }
15
+ /**
16
+ * Whether any native OTLP signal is enabled.
17
+ *
18
+ * @param config - Effective configuration.
19
+ * @returns True when at least one signal is on.
20
+ */
21
+ export function otelEnabled(config) {
22
+ return config.otel.logs || config.otel.traces || config.otel.metrics;
23
+ }
24
+ /**
25
+ * Names of the enabled OTLP signals, for setup and status messages.
26
+ *
27
+ * @param otel - The signal selection.
28
+ * @returns Enabled signal names in canonical order.
29
+ */
30
+ export function enabledSignalNames(otel) {
31
+ return OTEL_SIGNAL_NAMES.filter((name) => otel[name]);
32
+ }
33
+ /**
34
+ * Parse the `--otel` CLI value: "all", "none", or a comma list of
35
+ * logs/traces/metrics.
36
+ *
37
+ * Returns undefined — rather than ignoring the bad name — so setup can fail
38
+ * the whole run on a typo instead of silently configuring the wrong signals.
39
+ *
40
+ * @param value - Raw flag value.
41
+ * @returns The selection, or undefined when a name is unknown.
42
+ */
43
+ export function parseOtelSignals(value) {
44
+ const normalized = value.trim().toLowerCase();
45
+ if (normalized === OTEL_ALL)
46
+ return { logs: true, traces: true, metrics: true };
47
+ if (normalized === OTEL_NONE)
48
+ return { logs: false, traces: false, metrics: false };
49
+ const signals = { logs: false, traces: false, metrics: false };
50
+ for (const part of normalized.split(',')) {
51
+ const name = part.trim();
52
+ if (name === '')
53
+ continue;
54
+ if (!OTEL_SIGNAL_NAME_SET.has(name))
55
+ return undefined;
56
+ signals[name] = true;
57
+ }
58
+ return signals;
59
+ }
60
+ /**
61
+ * Where product events are POSTed.
62
+ *
63
+ * @param config - Effective configuration.
64
+ * @returns The events URL, or undefined when no backend is configured.
65
+ */
66
+ export function eventsUrl(config) {
67
+ if (config.eventsUrl)
68
+ return config.eventsUrl;
69
+ if (!config.endpoint)
70
+ return undefined;
71
+ return joinUrl(config.endpoint, EVENTS_PATH);
72
+ }
73
+ /**
74
+ * Base URL agents' native OTLP exporters point at.
75
+ *
76
+ * Standard OTLP/HTTP exporters append /v1/logs, /v1/traces and /v1/metrics to
77
+ * this base themselves, so it must stay a base and not a signal route.
78
+ *
79
+ * @param config - Effective configuration.
80
+ * @returns The OTLP base URL, or undefined when no backend is configured.
81
+ */
82
+ export function otlpBaseUrl(config) {
83
+ if (config.otlpUrl)
84
+ return config.otlpUrl;
85
+ if (!config.endpoint)
86
+ return undefined;
87
+ return joinUrl(config.endpoint, OTLP_BASE_PATH);
88
+ }
89
+ /**
90
+ * Where the pre-turn budget check asks its question.
91
+ *
92
+ * Derived from the same base as everything else, so a tenant configures one
93
+ * endpoint; the override exists for the same reason the other two do — a
94
+ * deployment that does not put every route behind one host.
95
+ *
96
+ * @param config - Effective configuration.
97
+ * @returns The decision URL, or undefined when no backend is configured.
98
+ */
99
+ export function enforcementUrl(config) {
100
+ if (config.enforcementUrl)
101
+ return config.enforcementUrl;
102
+ if (!config.endpoint)
103
+ return undefined;
104
+ return joinUrl(config.endpoint, ENFORCEMENT_PATH);
105
+ }
106
+ /**
107
+ * Join a base URL and a path without doubling the separator.
108
+ *
109
+ * @param base - Base URL, with or without a trailing slash.
110
+ * @param suffix - Path beginning with a slash.
111
+ * @returns The joined URL.
112
+ */
113
+ export function joinUrl(base, suffix) {
114
+ return base.replace(RE_TRAILING_SLASHES, '') + suffix;
115
+ }