@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,63 @@
1
+ import process from 'node:process';
2
+ import { loadEffectiveConfig } from '../config/repo-config.js';
3
+ import { providers } from '../providers/registry.js';
4
+ import { buildCliContext } from './context.js';
5
+ import { REDACTED_TOKEN } from './constants/cli.constants.js';
6
+ import { bold, dim, println, symbols } from './ui.js';
7
+ /**
8
+ * `agentwatch agents` — detection details for debugging.
9
+ *
10
+ * @param env - Ambient environment.
11
+ * @returns Exit code 0; detection is informational.
12
+ */
13
+ export async function runAgents(env) {
14
+ for (const provider of providers) {
15
+ const detection = await provider.detect(env);
16
+ println(bold(`${provider.displayName} (${provider.id})`));
17
+ println(`${detection.detected ? symbols.ok : symbols.off} ${detection.detected ? 'detected' : 'not detected'}`);
18
+ for (const evidence of detection.evidence)
19
+ println(dim(` - ${evidence}`));
20
+ println(dim(` hook config: ${detection.hookConfigPath}`));
21
+ println(dim(` hooks installed: ${detection.hooksInstalled ? 'yes' : 'no'}`));
22
+ println();
23
+ }
24
+ return 0;
25
+ }
26
+ /**
27
+ * `agentwatch config` — the effective configuration for this directory, with
28
+ * the token redacted.
29
+ *
30
+ * Effective, not global: what hooks actually do here is the global file plus the
31
+ * repository overlay, and showing only the former would answer the wrong
32
+ * question.
33
+ *
34
+ * @param env - Ambient environment.
35
+ * @returns 1 when the global config is invalid, else 0.
36
+ */
37
+ export async function runConfig(env) {
38
+ const context = await buildCliContext(env);
39
+ println(dim(`# global: ${context.paths.configFile} (${context.configState})`));
40
+ const effective = await loadEffectiveConfig(context.paths, env.cwd);
41
+ if (effective.repoConfigFile)
42
+ println(dim(`# repo overrides: ${effective.repoConfigFile}`));
43
+ for (const warning of effective.warnings)
44
+ println(dim(`# warning: ${warning}`));
45
+ println(JSON.stringify({ ...effective.config, token: effective.config.token ? REDACTED_TOKEN : undefined }, null, 2));
46
+ return context.configState === 'invalid' ? 1 : 0;
47
+ }
48
+ /**
49
+ * `agentwatch otel-headers` — Claude Code's otelHeadersHelper contract.
50
+ *
51
+ * Print a JSON object of OTLP headers on stdout and nothing else: this is how
52
+ * the bearer token reaches the exporter without ever being written into Claude's
53
+ * settings file.
54
+ *
55
+ * @param env - Ambient environment.
56
+ * @returns Exit code 0.
57
+ */
58
+ export async function runOtelHeaders(env) {
59
+ const context = await buildCliContext(env);
60
+ const headers = context.config.token ? { Authorization: `Bearer ${context.config.token}` } : {};
61
+ process.stdout.write(JSON.stringify(headers));
62
+ return 0;
63
+ }
@@ -0,0 +1,32 @@
1
+ import type { AgentWatchConfig } from '../config/types/config.types.js';
2
+ import type { SetupOptions } from './types/cli.types.js';
3
+ export type { SetupOptions } from './types/cli.types.js';
4
+ /**
5
+ * `agentwatch setup` — configure the backend, then register hooks and native
6
+ * telemetry in every detected agent.
7
+ *
8
+ * Ordered so nothing is written until everything that can be validated has
9
+ * been: a `--otel` typo, an unparseable existing config or a missing endpoint
10
+ * fails the run before the first file is touched.
11
+ *
12
+ * @param options - Environment, flags and the interactive prompt.
13
+ * @returns 0 when every step succeeded, else 1.
14
+ */
15
+ export declare function runSetup(options: SetupOptions): Promise<number>;
16
+ /**
17
+ * The developer identity this install will be attributed to.
18
+ *
19
+ * Resolution runs through `developerIdentity()` — the same function the hook
20
+ * path and the pre-turn budget check use — so what setup writes is exactly what
21
+ * the gate will later ask the platform about. The flag is the only override,
22
+ * for a machine whose git identity is someone else's.
23
+ *
24
+ * Nothing is asked when the identity is already known: the prompt exists for
25
+ * the machine that has no answer, not to re-confirm one we already trust.
26
+ *
27
+ * @param options - Flags, environment and the git runner override.
28
+ * @param baseConfig - Config the run starts from.
29
+ * @param ask - The prompt, when the run is interactive.
30
+ * @returns The identity, or undefined when nothing names the developer.
31
+ */
32
+ export declare function resolveDeveloperEmail(options: SetupOptions, baseConfig: AgentWatchConfig, ask: ((question: string) => Promise<string>) | undefined): Promise<string | undefined>;
@@ -0,0 +1,298 @@
1
+ import process from 'node:process';
2
+ import readline from 'node:readline/promises';
3
+ import { defaultConfig, enabledSignalNames, eventsUrl, parseOtelSignals } from '../config/config.js';
4
+ import { ensureInstallationId, saveConfig } from '../config/config-store.js';
5
+ import { collectGitContext, developerIdentity } from '../git/git-context.js';
6
+ import { ManualEnrollmentProvider } from '../enrollment/manual-enrollment.js';
7
+ import { providers } from '../providers/registry.js';
8
+ import { saveInstallState } from '../storage/install-state.js';
9
+ import { buildCliContext, buildHookCommand, buildQueue } from './context.js';
10
+ import { DEVELOPER_EMAIL_PROMPT, DEVELOPER_IDENTITY_REMEDIES, NO_CONFIG_WRITTEN, NO_DEVELOPER_IDENTITY } from './constants/cli.constants.js';
11
+ import { bold, dim, printErrln, println, symbols } from './ui.js';
12
+ /**
13
+ * `agentwatch setup` — configure the backend, then register hooks and native
14
+ * telemetry in every detected agent.
15
+ *
16
+ * Ordered so nothing is written until everything that can be validated has
17
+ * been: a `--otel` typo, an unparseable existing config or a missing endpoint
18
+ * fails the run before the first file is touched.
19
+ *
20
+ * @param options - Environment, flags and the interactive prompt.
21
+ * @returns 0 when every step succeeded, else 1.
22
+ */
23
+ export async function runSetup(options) {
24
+ const context = await buildCliContext(options.env);
25
+ println(bold('AgentWatch Setup'));
26
+ println();
27
+ if (context.configState === 'invalid') {
28
+ println(`${symbols.fail} existing config at ${context.paths.configFile} is invalid: ${context.configError}`);
29
+ println(' fix or delete it, then re-run setup');
30
+ return 1;
31
+ }
32
+ // A fresh install starts from the real defaults (full capture), not the
33
+ // fail-safe metadata-only fallback the hook runtime uses.
34
+ const baseConfig = context.configState === 'missing' ? defaultConfig() : context.config;
35
+ const otel = resolveOtel(baseConfig, options.otel);
36
+ if (!otel) {
37
+ println(`${symbols.fail} invalid --otel value "${options.otel}" (expected "all", "none" or a comma list of logs,traces,metrics)`);
38
+ return 1;
39
+ }
40
+ reportRepository(await collectGitContext({ cwd: options.env.cwd, includeChangedFiles: false }));
41
+ println();
42
+ const detected = await reportDetection(options);
43
+ if (detected.length === 0) {
44
+ println('No supported agents found. Install Claude Code or Codex and re-run `agentwatch setup`.');
45
+ return 1;
46
+ }
47
+ const ask = interactivePrompt(options);
48
+ const enrolled = await enroll(options, baseConfig, ask);
49
+ if ('error' in enrolled) {
50
+ println(`${symbols.fail} ${enrolled.error}`);
51
+ return 1;
52
+ }
53
+ const developerEmail = await resolveDeveloperEmail(options, baseConfig, ask);
54
+ if (!developerEmail) {
55
+ reportMissingIdentity();
56
+ return 1;
57
+ }
58
+ const config = ensureInstallationId({
59
+ ...baseConfig,
60
+ endpoint: enrolled.endpoint,
61
+ token: enrolled.token,
62
+ developerEmail,
63
+ otel,
64
+ emit: { ...baseConfig.emit, llmCalls: true }
65
+ });
66
+ await saveConfig(context.paths, config);
67
+ await offerBacklogRetarget(context, baseConfig, config, ask);
68
+ println(`${symbols.ok} backend: ${config.endpoint}`);
69
+ println(`${symbols.ok} developer: ${developerEmail}`);
70
+ println(`${symbols.ok} otel signals: ${enabledSignalNames(otel).join(', ') || 'none'}`);
71
+ println(dim(` config: ${context.paths.configFile}`));
72
+ println();
73
+ const failures = await installAgents(options, context, config, detected);
74
+ println(failures === 0 ? `${symbols.ok} setup complete` : `${symbols.warn} setup finished with ${failures} skipped step(s) — see above`);
75
+ println(dim(' run `agentwatch status` anytime, `agentwatch doctor` to diagnose'));
76
+ return failures === 0 ? 0 : 1;
77
+ }
78
+ /**
79
+ * The OTLP signal selection for this run.
80
+ *
81
+ * Validated before any prompt or file write: a typo must fail the whole run
82
+ * rather than silently configure the wrong signals.
83
+ *
84
+ * @param baseConfig - Config the run starts from.
85
+ * @param flag - Raw `--otel` value, when given.
86
+ * @returns The selection, or undefined when the flag is invalid.
87
+ */
88
+ function resolveOtel(baseConfig, flag) {
89
+ if (flag === undefined)
90
+ return baseConfig.otel;
91
+ return parseOtelSignals(flag);
92
+ }
93
+ /**
94
+ * Print the repository context. Informational; never fails the run.
95
+ *
96
+ * @param git - Collected git context.
97
+ */
98
+ function reportRepository(git) {
99
+ if (!git.repositoryRoot) {
100
+ println(`${symbols.off} no Git repository detected here (that's fine)`);
101
+ return;
102
+ }
103
+ println(`${symbols.ok} repository: ${git.repository ?? git.repositoryRoot}${git.branch ? dim(` (branch: ${git.branch})`) : ''}`);
104
+ }
105
+ /**
106
+ * Detect every supported agent and report what was found.
107
+ *
108
+ * @param options - Environment.
109
+ * @returns The agents that were detected.
110
+ */
111
+ async function reportDetection(options) {
112
+ println(bold('Detected coding agents:'));
113
+ const results = await Promise.all(providers.map(async (provider) => ({ provider, detection: await provider.detect(options.env) })));
114
+ for (const { provider, detection } of results) {
115
+ println(detection.detected ? `${symbols.ok} ${provider.displayName}` : `${symbols.off} ${provider.displayName} not detected`);
116
+ }
117
+ println();
118
+ return results.filter(({ detection }) => detection.detected);
119
+ }
120
+ /**
121
+ * Acquire the backend endpoint and token.
122
+ *
123
+ * @param options - Flags and the interactive prompt.
124
+ * @param baseConfig - Config the run starts from.
125
+ * @param ask - The prompt, when the run is interactive.
126
+ * @returns The enrollment result, or the message to show.
127
+ */
128
+ async function enroll(options, baseConfig, ask) {
129
+ try {
130
+ return await new ManualEnrollmentProvider().enroll({
131
+ setupUrl: options.setupUrl,
132
+ endpoint: options.endpoint ?? baseConfig.endpoint,
133
+ token: options.token ?? baseConfig.token,
134
+ ask
135
+ });
136
+ }
137
+ catch (error) {
138
+ return { error: error.message };
139
+ }
140
+ }
141
+ /**
142
+ * The developer identity this install will be attributed to.
143
+ *
144
+ * Resolution runs through `developerIdentity()` — the same function the hook
145
+ * path and the pre-turn budget check use — so what setup writes is exactly what
146
+ * the gate will later ask the platform about. The flag is the only override,
147
+ * for a machine whose git identity is someone else's.
148
+ *
149
+ * Nothing is asked when the identity is already known: the prompt exists for
150
+ * the machine that has no answer, not to re-confirm one we already trust.
151
+ *
152
+ * @param options - Flags, environment and the git runner override.
153
+ * @param baseConfig - Config the run starts from.
154
+ * @param ask - The prompt, when the run is interactive.
155
+ * @returns The identity, or undefined when nothing names the developer.
156
+ */
157
+ export async function resolveDeveloperEmail(options, baseConfig, ask) {
158
+ const flag = options.developerEmail?.trim();
159
+ if (flag)
160
+ return flag;
161
+ const detected = await developerIdentity(baseConfig.developerEmail, options.env.cwd, { home: options.env.home, run: options.gitRun });
162
+ if (detected)
163
+ return detected;
164
+ if (!ask)
165
+ return undefined;
166
+ return (await ask(DEVELOPER_EMAIL_PROMPT)).trim() || undefined;
167
+ }
168
+ /**
169
+ * Refuse the install, naming both ways to fix it.
170
+ *
171
+ * An install nobody can be attributed to reports success while enforcing
172
+ * nothing: every per-developer decision is keyed on this identity, and an
173
+ * unknown one is allowed silently. Better a loud non-zero exit here than a
174
+ * customer who believes they are covered.
175
+ */
176
+ function reportMissingIdentity() {
177
+ printErrln(`${symbols.fail} ${NO_DEVELOPER_IDENTITY}`);
178
+ printErrln(` ${DEVELOPER_IDENTITY_REMEDIES}`);
179
+ printErrln(` ${NO_CONFIG_WRITTEN}`);
180
+ }
181
+ /**
182
+ * Offer to re-route a backlog queued for a previous backend.
183
+ *
184
+ * Backlog queued for the previous backend must not silently expire pinned to a
185
+ * URL nothing will ever drain — but moving captured content to a *different*
186
+ * backend is a routing decision only the user can make, because the previous URL
187
+ * may belong to another organization. So: ask, never assume.
188
+ *
189
+ * @param context - Resolved CLI context.
190
+ * @param previousConfig - Config before this run.
191
+ * @param config - Config this run just wrote.
192
+ * @param ask - The prompt, when the run is interactive.
193
+ */
194
+ async function offerBacklogRetarget(context, previousConfig, config, ask) {
195
+ const previousUrl = eventsUrl(previousConfig);
196
+ const configuredUrl = eventsUrl(config);
197
+ if (!previousUrl || !configuredUrl || previousUrl === configuredUrl)
198
+ return;
199
+ const queue = buildQueue({ ...context, config });
200
+ const stranded = await queue.pendingFor(previousUrl);
201
+ if (stranded === 0)
202
+ return;
203
+ const answer = ask
204
+ ? (await ask(`${stranded} offline event(s) are queued for the previous backend (${previousUrl}). Deliver them to the new backend? [y/N]: `)).trim().toLowerCase()
205
+ : '';
206
+ if (answer !== 'y' && answer !== 'yes') {
207
+ println(`${symbols.warn} keeping ${stranded} offline event(s) pinned to the previous backend; they expire after ${config.delivery.maxEventAgeDays} day(s)`);
208
+ return;
209
+ }
210
+ const retargeted = await queue.retarget(configuredUrl, previousUrl);
211
+ println(retargeted ? `${symbols.ok} offline backlog re-routed to the new backend` : `${symbols.warn} queue busy; backlog not re-routed — re-run setup to retry`);
212
+ }
213
+ /**
214
+ * Register hooks and native telemetry in every detected agent.
215
+ *
216
+ * Install state is threaded from one operation to the next and persisted once at
217
+ * the end, so a failure part-way through cannot leave a record claiming
218
+ * something was installed that was not.
219
+ *
220
+ * @param options - Environment and the hook-command override.
221
+ * @param context - Resolved CLI context.
222
+ * @param config - The configuration just written.
223
+ * @param detected - Agents to install into.
224
+ * @returns How many steps were skipped or failed.
225
+ */
226
+ async function installAgents(options, context, config, detected) {
227
+ let installState = context.installState;
228
+ let failures = 0;
229
+ for (const { provider } of detected) {
230
+ println(bold(provider.displayName));
231
+ const setupContext = {
232
+ env: options.env,
233
+ paths: context.paths,
234
+ config,
235
+ hookCommand: (options.hookCommandFor ?? ((id) => buildHookCommand(options.env, id)))(provider.id),
236
+ installState
237
+ };
238
+ const hooks = await provider.installHooks(setupContext);
239
+ installState = printOutcome(hooks, installState);
240
+ if (!hooks.ok)
241
+ failures++;
242
+ if (provider.nativeTelemetry && (await provider.nativeTelemetry.supported(options.env))) {
243
+ const otel = await provider.nativeTelemetry.configure({ ...setupContext, installState });
244
+ installState = printOutcome(otel, installState);
245
+ if (!otel.ok)
246
+ failures++;
247
+ }
248
+ println();
249
+ }
250
+ await saveInstallState(context.paths, installState);
251
+ return failures;
252
+ }
253
+ /**
254
+ * Print an outcome and carry its install state forward.
255
+ *
256
+ * @param outcome - What the operation reported.
257
+ * @param current - Install state before it ran.
258
+ * @returns The install state to pass to the next operation.
259
+ */
260
+ function printOutcome(outcome, current) {
261
+ for (const message of outcome.messages) {
262
+ println(`${outcome.ok ? symbols.ok : symbols.warn} ${message}`);
263
+ }
264
+ return outcome.installState ?? current;
265
+ }
266
+ /**
267
+ * The prompt this run may use, if any.
268
+ *
269
+ * `--yes` wins over an injected prompt as well as over the terminal: the
270
+ * command a developer copies out of the product carries it, and that command
271
+ * has to run to completion on a machine where nobody is typing.
272
+ *
273
+ * @param options - Flags and the injected prompt.
274
+ * @returns The prompt, or undefined when the run must not block on input.
275
+ */
276
+ function interactivePrompt(options) {
277
+ if (options.yes)
278
+ return undefined;
279
+ return options.ask ?? defaultAsk();
280
+ }
281
+ /**
282
+ * The terminal prompt, when there is a terminal.
283
+ *
284
+ * @returns The prompt, or undefined when stdin is not a TTY.
285
+ */
286
+ function defaultAsk() {
287
+ if (!process.stdin.isTTY)
288
+ return undefined;
289
+ return async (question) => {
290
+ const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
291
+ try {
292
+ return await rl.question(question);
293
+ }
294
+ finally {
295
+ rl.close();
296
+ }
297
+ };
298
+ }
@@ -0,0 +1,11 @@
1
+ import type { Env } from '../core/types/core.types.js';
2
+ /**
3
+ * `agentwatch status` — is telemetry actually flowing, and if not, why.
4
+ *
5
+ * Reads as the four questions a developer has: is a backend configured, where
6
+ * am I, is each agent wired up, and is anything stuck or lost.
7
+ *
8
+ * @param env - Ambient environment.
9
+ * @returns Exit code 0; status reports, it does not judge.
10
+ */
11
+ export declare function runStatus(env: Env): Promise<number>;
@@ -0,0 +1,174 @@
1
+ import { eventsUrl } from '../config/config.js';
2
+ import { collectGitContext } from '../git/git-context.js';
3
+ import { providers } from '../providers/registry.js';
4
+ import { buildCliContext, buildDeliveryStats, buildHookCommand, buildQueue, buildTransport } from './context.js';
5
+ import { STATUS_SEND_TIMEOUT_MS } from './constants/cli.constants.js';
6
+ import { bold, dim, println, symbols } from './ui.js';
7
+ /**
8
+ * `agentwatch status` — is telemetry actually flowing, and if not, why.
9
+ *
10
+ * Reads as the four questions a developer has: is a backend configured, where
11
+ * am I, is each agent wired up, and is anything stuck or lost.
12
+ *
13
+ * @param env - Ambient environment.
14
+ * @returns Exit code 0; status reports, it does not judge.
15
+ */
16
+ export async function runStatus(env) {
17
+ const context = await buildCliContext(env);
18
+ println(bold('AgentWatch Edge'));
19
+ println();
20
+ reportBackend(context);
21
+ println();
22
+ reportRepository(await collectGitContext({ cwd: env.cwd, includeChangedFiles: false }));
23
+ println();
24
+ println(bold('Agents'));
25
+ for (const provider of providers) {
26
+ await reportAgent(provider, context);
27
+ }
28
+ println();
29
+ await reportDelivery(context);
30
+ return 0;
31
+ }
32
+ /**
33
+ * Whether a backend is configured.
34
+ *
35
+ * @param context - Resolved CLI context.
36
+ */
37
+ function reportBackend(context) {
38
+ println(bold('Backend'));
39
+ if (context.configState === 'invalid') {
40
+ println(`${symbols.fail} config invalid: ${context.configError}`);
41
+ return;
42
+ }
43
+ if (context.config.endpoint) {
44
+ println(`${symbols.ok} ${context.config.endpoint}`);
45
+ reportEnforcement(context);
46
+ return;
47
+ }
48
+ println(`${symbols.off} not configured — run \`agentwatch setup\``);
49
+ }
50
+ /**
51
+ * Whether a budget cap marked `block` is acted on here.
52
+ *
53
+ * Worth a line of its own: it is the one setting that can stop a developer's
54
+ * turn, so a developer whose prompt was refused should be able to see where that
55
+ * came from without reading the config file.
56
+ *
57
+ * @param context - Resolved CLI context.
58
+ */
59
+ function reportEnforcement(context) {
60
+ if (!context.config.enforcement.enabled) {
61
+ println(`${symbols.off} budget enforcement: off`);
62
+ return;
63
+ }
64
+ println(`${symbols.ok} budget enforcement: on — a turn stops only when the backend answers "block"`);
65
+ }
66
+ /**
67
+ * Where this command was run.
68
+ *
69
+ * @param git - Collected git context.
70
+ */
71
+ function reportRepository(git) {
72
+ println(bold('Repository'));
73
+ if (!git.repositoryRoot) {
74
+ println(`${symbols.off} not inside a Git repository`);
75
+ return;
76
+ }
77
+ println(`${symbols.ok} ${git.repository ?? git.repositoryRoot}`);
78
+ if (git.branch)
79
+ println(dim(` branch: ${git.branch}`));
80
+ }
81
+ /**
82
+ * Whether one agent is detected, hooked and exporting telemetry.
83
+ *
84
+ * @param provider - The agent's provider.
85
+ * @param context - Resolved CLI context.
86
+ */
87
+ async function reportAgent(provider, context) {
88
+ const detection = await provider.detect(context.env);
89
+ println();
90
+ println(provider.displayName);
91
+ if (!detection.detected) {
92
+ println(`${symbols.off} not detected`);
93
+ return;
94
+ }
95
+ println(`${symbols.ok} detected ${dim(`(${detection.evidence[0] ?? ''})`)}`);
96
+ println(detection.hooksInstalled ? `${symbols.ok} hooks installed` : `${symbols.off} hooks not installed`);
97
+ if (!provider.nativeTelemetry)
98
+ return;
99
+ const setupContext = {
100
+ env: context.env,
101
+ paths: context.paths,
102
+ config: context.config,
103
+ hookCommand: buildHookCommand(context.env, provider.id),
104
+ installState: context.installState
105
+ };
106
+ const otel = await provider.nativeTelemetry.inspect(setupContext);
107
+ if (otel.configured) {
108
+ println(`${symbols.ok} native OpenTelemetry ${otel.detail ?? 'configured'}`);
109
+ return;
110
+ }
111
+ println(otel.conflict ? `${symbols.warn} native OpenTelemetry: ${otel.conflict}` : `${symbols.off} native OpenTelemetry not configured`);
112
+ }
113
+ /**
114
+ * The backlog, and everything the queue has lost.
115
+ *
116
+ * A pending backlog is retried here first: we are already out of every agent's
117
+ * critical path, so this is the reasonable moment to try again.
118
+ *
119
+ * @param context - Resolved CLI context.
120
+ */
121
+ async function reportDelivery(context) {
122
+ println(bold('Delivery'));
123
+ const queue = buildQueue(context);
124
+ const deliveryStats = buildDeliveryStats(context);
125
+ const pending = await retryBacklog(context, queue, deliveryStats);
126
+ println(pending === 0 ? `${symbols.ok} healthy` : `${symbols.warn} backlog`);
127
+ println(`${pending} pending event(s)`);
128
+ reportLosses(context, await deliveryStats.read());
129
+ }
130
+ /**
131
+ * Drain what can be drained, and report the backlog that remains.
132
+ *
133
+ * @param context - Resolved CLI context.
134
+ * @param queue - The offline queue.
135
+ * @param deliveryStats - Sink for anything the drain loses.
136
+ * @returns The remaining entry count.
137
+ */
138
+ async function retryBacklog(context, queue, deliveryStats) {
139
+ const pending = await queue.pendingCount();
140
+ if (pending === 0 || !eventsUrl(context.config))
141
+ return pending;
142
+ const transport = buildTransport(context, STATUS_SEND_TIMEOUT_MS);
143
+ if (!transport)
144
+ return pending;
145
+ const drained = await queue.drain(transport, context.config.delivery.drainBatchSize, deliveryStats);
146
+ if (drained.sent > 0)
147
+ println(dim(` retried: ${drained.sent} event(s) delivered`));
148
+ return queue.pendingCount();
149
+ }
150
+ /**
151
+ * What the queue has permanently lost, and what to do about it.
152
+ *
153
+ * @param context - Resolved CLI context.
154
+ * @param stats - The persisted tally, when there is one.
155
+ */
156
+ function reportLosses(context, stats) {
157
+ if (!stats)
158
+ return;
159
+ if (stats.totalRejected > 0) {
160
+ const last = stats.lastRejectedAt ? ` (last ${stats.lastRejectedCount} at ${stats.lastRejectedAt})` : '';
161
+ println(`${symbols.warn} ${stats.totalRejected} event(s) permanently rejected by the backend${last}`);
162
+ }
163
+ if (stats.totalDropped > 0) {
164
+ const last = stats.lastDroppedAt ? ` (last ${stats.lastDroppedCount} at ${stats.lastDroppedAt})` : '';
165
+ // Attempts exhausted, past the age bound, or unreadable on disk: whichever
166
+ // it was, the event is gone — and used to be gone silently.
167
+ println(`${symbols.warn} ${stats.totalDropped} event(s) lost from the local queue${last}`);
168
+ println(dim(` the queue gives up after ${context.config.delivery.maxAttempts} attempts or ${context.config.delivery.maxEventAgeDays} day(s)`));
169
+ }
170
+ if (stats.lastRefusalStatus > 0) {
171
+ println(`${symbols.warn} backend last refused a batch with HTTP ${stats.lastRefusalStatus}${stats.lastRefusalAt ? ` at ${stats.lastRefusalAt}` : ''}`);
172
+ println(dim(' a refusal is not retried on its own; check the endpoint, the token and the event schema'));
173
+ }
174
+ }
@@ -0,0 +1,69 @@
1
+ import type { AgentWatchConfig, ConfigLoadResult } from '../../config/types/config.types.js';
2
+ import type { Env } from '../../core/types/core.types.js';
3
+ import type { GitRunner } from '../../git/types/git.types.js';
4
+ import type { AgentWatchPaths, InstallState } from '../../storage/types/storage.types.js';
5
+ /** Parsed argv. */
6
+ export interface ParsedArgs {
7
+ readonly command?: string;
8
+ readonly positional: readonly string[];
9
+ readonly flags: Readonly<Record<string, string | boolean>>;
10
+ }
11
+ /** Everything a command needs, resolved once at its start. */
12
+ export interface CliContext {
13
+ readonly env: Env;
14
+ readonly paths: AgentWatchPaths;
15
+ readonly config: AgentWatchConfig;
16
+ readonly configState: ConfigLoadResult['state'];
17
+ readonly configError?: string;
18
+ readonly installState: InstallState;
19
+ }
20
+ export interface HookRunOptions {
21
+ readonly env: Env;
22
+ /** Raw stdin payload; tests inject a string instead of reading process.stdin. */
23
+ readonly input?: string;
24
+ readonly dryRun?: boolean;
25
+ readonly writeStdout?: (text: string) => void;
26
+ }
27
+ export interface SetupOptions {
28
+ readonly env: Env;
29
+ readonly setupUrl?: string;
30
+ readonly endpoint?: string;
31
+ readonly token?: string;
32
+ /** Developer identity for turn summaries; falls back to `git config user.email`. */
33
+ readonly developerEmail?: string;
34
+ /** OTLP signal selection: "all", "none" or a comma list of logs,traces,metrics. */
35
+ readonly otel?: string;
36
+ /** Non-interactive: fail instead of prompting. */
37
+ readonly yes?: boolean;
38
+ readonly ask?: (question: string) => Promise<string>;
39
+ readonly hookCommandFor?: (providerId: string) => string;
40
+ /** Git runner override; tests resolve the identity without a real git. */
41
+ readonly gitRun?: GitRunner;
42
+ }
43
+ /** What `agentwatch doctor` was asked to report. */
44
+ export interface DoctorOptions {
45
+ /** Emit machine-readable JSON instead of the human report. */
46
+ readonly json?: boolean;
47
+ /** Git runner override; tests resolve the identity without a real git. */
48
+ readonly gitRun?: GitRunner;
49
+ }
50
+ export interface UninstallOptions {
51
+ readonly env: Env;
52
+ readonly agent?: string;
53
+ /** Also delete local config, queue and state. Off by default. */
54
+ readonly purge?: boolean;
55
+ }
56
+ /** Severity of one doctor finding. */
57
+ export type CheckLevel = 'ok' | 'warn' | 'fail';
58
+ export interface Check {
59
+ readonly name: string;
60
+ readonly level: CheckLevel;
61
+ readonly detail?: string;
62
+ }
63
+ /** Terminal symbols, one per level. */
64
+ export interface LevelSymbols {
65
+ readonly ok: string;
66
+ readonly warn: string;
67
+ readonly fail: string;
68
+ readonly off: string;
69
+ }
@@ -0,0 +1 @@
1
+ export {};