@agent-watch-ai/edge 0.2.5 → 0.3.1

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 (346) hide show
  1. package/CHANGELOG.md +512 -0
  2. package/README.md +217 -96
  3. package/SECURITY.md +69 -0
  4. package/dist/billing/session-billing.d.ts +19 -0
  5. package/dist/billing/session-billing.js +52 -0
  6. package/dist/cli/args.d.ts +10 -0
  7. package/dist/cli/args.js +20 -0
  8. package/dist/cli/constants/cli.constants.d.ts +50 -4
  9. package/dist/cli/constants/cli.constants.js +54 -5
  10. package/dist/cli/context.d.ts +33 -2
  11. package/dist/cli/context.js +84 -14
  12. package/dist/cli/doctor.js +309 -32
  13. package/dist/cli/hook-check.d.ts +23 -0
  14. package/dist/cli/hook-check.js +114 -0
  15. package/dist/cli/hook.js +118 -7
  16. package/dist/cli/index.d.ts +3 -1
  17. package/dist/cli/index.js +3 -1
  18. package/dist/cli/misc.d.ts +11 -0
  19. package/dist/cli/misc.js +80 -4
  20. package/dist/cli/npx-install.d.ts +37 -0
  21. package/dist/cli/npx-install.js +79 -0
  22. package/dist/cli/open-browser.d.ts +39 -0
  23. package/dist/cli/open-browser.js +62 -0
  24. package/dist/cli/setup.d.ts +17 -8
  25. package/dist/cli/setup.js +439 -98
  26. package/dist/cli/status.js +82 -13
  27. package/dist/cli/toggle.d.ts +9 -0
  28. package/dist/cli/toggle.js +113 -0
  29. package/dist/cli/types/cli.types.d.ts +37 -3
  30. package/dist/cli/ui.d.ts +7 -0
  31. package/dist/cli/ui.js +10 -1
  32. package/dist/cli/uninstall.js +39 -2
  33. package/dist/cli/update.d.ts +17 -0
  34. package/dist/cli/update.js +76 -0
  35. package/dist/cli.js +100 -13
  36. package/dist/config/config-store.d.ts +57 -0
  37. package/dist/config/config-store.js +250 -12
  38. package/dist/config/config.d.ts +53 -6
  39. package/dist/config/config.js +66 -6
  40. package/dist/config/constants/config.constants.d.ts +113 -6
  41. package/dist/config/constants/config.constants.js +126 -8
  42. package/dist/config/destination.d.ts +24 -0
  43. package/dist/config/destination.js +33 -0
  44. package/dist/config/index.d.ts +7 -4
  45. package/dist/config/index.js +5 -3
  46. package/dist/config/repo-config.d.ts +11 -7
  47. package/dist/config/repo-config.js +64 -15
  48. package/dist/config/root-config.d.ts +72 -0
  49. package/dist/config/root-config.js +170 -0
  50. package/dist/config/schemas/config.schema.d.ts +721 -84
  51. package/dist/config/schemas/config.schema.js +388 -15
  52. package/dist/config/types/config.types.d.ts +15 -1
  53. package/dist/config/types/destination.types.d.ts +8 -0
  54. package/dist/core/async.d.ts +36 -0
  55. package/dist/core/async.js +68 -0
  56. package/dist/core/index.d.ts +1 -1
  57. package/dist/core/index.js +1 -1
  58. package/dist/core/object.d.ts +5 -0
  59. package/dist/core/object.js +9 -4
  60. package/dist/core/pipe.d.ts +0 -13
  61. package/dist/core/pipe.js +1 -9
  62. package/dist/core/types/core.types.d.ts +9 -0
  63. package/dist/core/types/core.types.js +0 -3
  64. package/dist/core/which.d.ts +14 -0
  65. package/dist/core/which.js +43 -3
  66. package/dist/credentials/budget.d.ts +9 -0
  67. package/dist/credentials/budget.js +16 -0
  68. package/dist/credentials/command-runner.d.ts +16 -0
  69. package/dist/credentials/command-runner.js +37 -0
  70. package/dist/credentials/constants/credentials.constants.d.ts +111 -0
  71. package/dist/credentials/constants/credentials.constants.js +112 -0
  72. package/dist/credentials/credential-status.d.ts +14 -0
  73. package/dist/credentials/credential-status.js +34 -0
  74. package/dist/credentials/credentials.d.ts +72 -0
  75. package/dist/credentials/credentials.js +253 -0
  76. package/dist/credentials/device-api.d.ts +64 -0
  77. package/dist/credentials/device-api.js +150 -0
  78. package/dist/credentials/device-state.d.ts +31 -0
  79. package/dist/credentials/device-state.js +51 -0
  80. package/dist/credentials/identity.d.ts +62 -0
  81. package/dist/credentials/identity.js +90 -0
  82. package/dist/credentials/index.d.ts +7 -0
  83. package/dist/credentials/index.js +5 -0
  84. package/dist/credentials/migration.d.ts +46 -0
  85. package/dist/credentials/migration.js +164 -0
  86. package/dist/credentials/schemas/device-api.schema.d.ts +77 -0
  87. package/dist/credentials/schemas/device-api.schema.js +33 -0
  88. package/dist/credentials/schemas/device-state.schema.d.ts +51 -0
  89. package/dist/credentials/schemas/device-state.schema.js +20 -0
  90. package/dist/credentials/secret-store.d.ts +54 -0
  91. package/dist/credentials/secret-store.js +217 -0
  92. package/dist/credentials/sign-in.d.ts +18 -0
  93. package/dist/credentials/sign-in.js +86 -0
  94. package/dist/credentials/token-refresher.d.ts +39 -0
  95. package/dist/credentials/token-refresher.js +185 -0
  96. package/dist/credentials/types/credentials.types.d.ts +195 -0
  97. package/dist/credentials/types/credentials.types.js +1 -0
  98. package/dist/enforcement/constants/enforcement.constants.d.ts +47 -1
  99. package/dist/enforcement/constants/enforcement.constants.js +56 -0
  100. package/dist/enforcement/decision-cache.d.ts +20 -1
  101. package/dist/enforcement/decision-cache.js +65 -2
  102. package/dist/enforcement/decision-client.d.ts +9 -8
  103. package/dist/enforcement/decision-client.js +62 -16
  104. package/dist/enforcement/enforcement.d.ts +23 -2
  105. package/dist/enforcement/enforcement.js +103 -15
  106. package/dist/enforcement/index.d.ts +4 -3
  107. package/dist/enforcement/index.js +3 -2
  108. package/dist/enforcement/types/enforcement.types.d.ts +64 -0
  109. package/dist/enrollment/constants/enrollment.constants.d.ts +2 -6
  110. package/dist/enrollment/constants/enrollment.constants.js +2 -6
  111. package/dist/enrollment/enrollment.d.ts +16 -0
  112. package/dist/enrollment/enrollment.js +54 -0
  113. package/dist/enrollment/index.d.ts +3 -7
  114. package/dist/enrollment/index.js +1 -1
  115. package/dist/enrollment/types/enrollment.types.d.ts +9 -13
  116. package/dist/events/constants/enrich.constants.d.ts +15 -0
  117. package/dist/events/constants/enrich.constants.js +15 -0
  118. package/dist/events/constants/events.constants.d.ts +6 -2
  119. package/dist/events/constants/events.constants.js +5 -1
  120. package/dist/events/enrich.js +92 -10
  121. package/dist/events/event-id.d.ts +0 -8
  122. package/dist/events/event-id.js +0 -10
  123. package/dist/events/index.d.ts +2 -2
  124. package/dist/events/index.js +1 -1
  125. package/dist/events/product-event.d.ts +9 -6
  126. package/dist/events/types/repo-snapshot.types.d.ts +7 -0
  127. package/dist/events/types/session-billing.types.d.ts +16 -0
  128. package/dist/events/types/session-billing.types.js +1 -0
  129. package/dist/feature/constants/feature.constants.d.ts +7 -0
  130. package/dist/feature/constants/feature.constants.js +7 -0
  131. package/dist/feature/index.d.ts +1 -1
  132. package/dist/feature/index.js +1 -1
  133. package/dist/feature/ticket-candidates.d.ts +14 -0
  134. package/dist/feature/ticket-candidates.js +26 -8
  135. package/dist/git/blob-hash.d.ts +21 -0
  136. package/dist/git/blob-hash.js +69 -0
  137. package/dist/git/checkout-root.d.ts +27 -0
  138. package/dist/git/checkout-root.js +75 -0
  139. package/dist/git/constants/git.constants.d.ts +160 -0
  140. package/dist/git/constants/git.constants.js +181 -0
  141. package/dist/git/fingerprint.d.ts +74 -0
  142. package/dist/git/fingerprint.js +219 -0
  143. package/dist/git/gate-checkout.d.ts +44 -0
  144. package/dist/git/gate-checkout.js +201 -0
  145. package/dist/git/git-context.d.ts +45 -0
  146. package/dist/git/git-context.js +61 -3
  147. package/dist/git/index.d.ts +4 -2
  148. package/dist/git/index.js +2 -1
  149. package/dist/git/manifest-repository.d.ts +13 -0
  150. package/dist/git/manifest-repository.js +92 -0
  151. package/dist/git/repo-snapshot.d.ts +29 -3
  152. package/dist/git/repo-snapshot.js +110 -7
  153. package/dist/git/repository-root.d.ts +39 -0
  154. package/dist/git/repository-root.js +131 -0
  155. package/dist/git/types/git.types.d.ts +55 -0
  156. package/dist/git/types/repository-root.types.d.ts +11 -0
  157. package/dist/git/types/repository-root.types.js +1 -0
  158. package/dist/git/types/snapshot.types.d.ts +9 -0
  159. package/dist/pipeline/constants/pipeline.constants.d.ts +7 -0
  160. package/dist/pipeline/constants/pipeline.constants.js +7 -0
  161. package/dist/pipeline/hook-pipeline.js +360 -32
  162. package/dist/pipeline/types/pipeline.types.d.ts +39 -4
  163. package/dist/privacy/constants/privacy.constants.js +15 -1
  164. package/dist/privacy/index.d.ts +1 -0
  165. package/dist/privacy/index.js +1 -0
  166. package/dist/privacy/product-capture.d.ts +12 -0
  167. package/dist/privacy/product-capture.js +73 -0
  168. package/dist/privacy/sanitizer.d.ts +21 -3
  169. package/dist/privacy/sanitizer.js +52 -8
  170. package/dist/process/ancestors.d.ts +39 -0
  171. package/dist/process/ancestors.js +121 -0
  172. package/dist/process/constants/process.constants.d.ts +34 -0
  173. package/dist/process/constants/process.constants.js +34 -0
  174. package/dist/process/index.d.ts +7 -0
  175. package/dist/process/index.js +2 -0
  176. package/dist/process/types/process.types.d.ts +23 -0
  177. package/dist/process/types/process.types.js +1 -0
  178. package/dist/providers/antigravity/antigravity.adapter.d.ts +12 -1
  179. package/dist/providers/antigravity/antigravity.adapter.js +21 -3
  180. package/dist/providers/antigravity/antigravity.detect.d.ts +0 -9
  181. package/dist/providers/antigravity/antigravity.detect.js +1 -1
  182. package/dist/providers/antigravity/antigravity.provider.js +3 -2
  183. package/dist/providers/antigravity/constants/antigravity.constants.d.ts +2 -0
  184. package/dist/providers/antigravity/constants/antigravity.constants.js +2 -0
  185. package/dist/providers/claude/claude.adapter.d.ts +11 -1
  186. package/dist/providers/claude/claude.adapter.js +26 -5
  187. package/dist/providers/claude/claude.otel.d.ts +32 -18
  188. package/dist/providers/claude/claude.otel.js +81 -6
  189. package/dist/providers/claude/claude.provider.js +5 -2
  190. package/dist/providers/claude/constants/claude.constants.d.ts +2 -0
  191. package/dist/providers/claude/constants/claude.constants.js +2 -0
  192. package/dist/providers/claude/constants/claude.otel.constants.d.ts +4 -0
  193. package/dist/providers/claude/constants/claude.otel.constants.js +8 -0
  194. package/dist/providers/codex/codex.adapter.d.ts +15 -1
  195. package/dist/providers/codex/codex.adapter.js +29 -5
  196. package/dist/providers/codex/codex.otel.d.ts +24 -2
  197. package/dist/providers/codex/codex.otel.js +147 -30
  198. package/dist/providers/codex/codex.provider.js +5 -2
  199. package/dist/providers/codex/constants/codex.constants.d.ts +2 -0
  200. package/dist/providers/codex/constants/codex.constants.js +16 -0
  201. package/dist/providers/codex/constants/codex.otel.constants.d.ts +5 -0
  202. package/dist/providers/codex/constants/codex.otel.constants.js +5 -0
  203. package/dist/providers/constants/provider.constants.d.ts +0 -3
  204. package/dist/providers/constants/provider.constants.js +0 -3
  205. package/dist/providers/cursor/constants/cursor.constants.d.ts +7 -0
  206. package/dist/providers/cursor/constants/cursor.constants.js +7 -0
  207. package/dist/providers/cursor/cursor.adapter.d.ts +33 -1
  208. package/dist/providers/cursor/cursor.adapter.js +52 -3
  209. package/dist/providers/cursor/cursor.detect.d.ts +0 -7
  210. package/dist/providers/cursor/cursor.detect.js +1 -1
  211. package/dist/providers/cursor/cursor.provider.js +5 -2
  212. package/dist/providers/gemini/constants/gemini.constants.d.ts +9 -0
  213. package/dist/providers/gemini/constants/gemini.constants.js +9 -0
  214. package/dist/providers/gemini/constants/gemini.otel.constants.d.ts +3 -1
  215. package/dist/providers/gemini/constants/gemini.otel.constants.js +3 -0
  216. package/dist/providers/gemini/gemini.adapter.d.ts +14 -1
  217. package/dist/providers/gemini/gemini.adapter.js +25 -5
  218. package/dist/providers/gemini/gemini.detect.d.ts +0 -7
  219. package/dist/providers/gemini/gemini.detect.js +1 -1
  220. package/dist/providers/gemini/gemini.otel.d.ts +19 -20
  221. package/dist/providers/gemini/gemini.otel.js +121 -17
  222. package/dist/providers/gemini/gemini.provider.js +2 -1
  223. package/dist/providers/index.d.ts +1 -1
  224. package/dist/providers/index.js +1 -1
  225. package/dist/providers/loaders.d.ts +10 -0
  226. package/dist/providers/loaders.js +40 -0
  227. package/dist/providers/provider.d.ts +11 -0
  228. package/dist/providers/provider.js +1 -1
  229. package/dist/providers/registry.d.ts +11 -8
  230. package/dist/providers/registry.js +11 -15
  231. package/dist/providers/shared/constants/hook-refusal.constants.d.ts +7 -0
  232. package/dist/providers/shared/constants/hook-refusal.constants.js +7 -0
  233. package/dist/providers/shared/constants/shell-directories.constants.d.ts +30 -0
  234. package/dist/providers/shared/constants/shell-directories.constants.js +39 -0
  235. package/dist/providers/shared/constants/tooling.constants.d.ts +18 -2
  236. package/dist/providers/shared/constants/tooling.constants.js +19 -3
  237. package/dist/providers/shared/event-builder.d.ts +12 -14
  238. package/dist/providers/shared/event-builder.js +20 -14
  239. package/dist/providers/shared/exporter-allowlist.d.ts +20 -0
  240. package/dist/providers/shared/exporter-allowlist.js +49 -0
  241. package/dist/providers/shared/hook-config.d.ts +2 -21
  242. package/dist/providers/shared/hook-config.js +5 -4
  243. package/dist/providers/shared/hook-refusal.d.ts +12 -0
  244. package/dist/providers/shared/hook-refusal.js +17 -1
  245. package/dist/providers/shared/install-record.d.ts +12 -2
  246. package/dist/providers/shared/install-record.js +5 -2
  247. package/dist/providers/shared/shell-directories.d.ts +24 -0
  248. package/dist/providers/shared/shell-directories.js +90 -0
  249. package/dist/providers/shared/tooling.d.ts +12 -1
  250. package/dist/providers/shared/tooling.js +18 -0
  251. package/dist/providers/shared/types/adapter.types.d.ts +1 -2
  252. package/dist/providers/types/provider.types.d.ts +57 -1
  253. package/dist/snapshot/constants/snapshot.constants.d.ts +32 -0
  254. package/dist/snapshot/constants/snapshot.constants.js +33 -0
  255. package/dist/snapshot/snapshot-event.js +52 -11
  256. package/dist/snapshot/snapshot-pipeline.js +1 -1
  257. package/dist/snapshot/types/snapshot.types.d.ts +2 -0
  258. package/dist/storage/atomic-file.d.ts +7 -0
  259. package/dist/storage/atomic-file.js +1 -1
  260. package/dist/storage/constants/storage.constants.d.ts +17 -0
  261. package/dist/storage/constants/storage.constants.js +17 -0
  262. package/dist/storage/disabled.d.ts +13 -0
  263. package/dist/storage/disabled.js +24 -0
  264. package/dist/storage/index.d.ts +2 -0
  265. package/dist/storage/index.js +2 -0
  266. package/dist/storage/paths.js +3 -2
  267. package/dist/storage/schemas/storage.schema.d.ts +72 -0
  268. package/dist/storage/schemas/storage.schema.js +6 -0
  269. package/dist/storage/sweep-marker.d.ts +19 -0
  270. package/dist/storage/sweep-marker.js +55 -0
  271. package/dist/storage/types/storage.types.d.ts +2 -0
  272. package/dist/storage/uninstalled.d.ts +58 -0
  273. package/dist/storage/uninstalled.js +107 -0
  274. package/dist/transport/auth-block.d.ts +66 -0
  275. package/dist/transport/auth-block.js +129 -0
  276. package/dist/transport/constants/transport.constants.d.ts +82 -3
  277. package/dist/transport/constants/transport.constants.js +83 -4
  278. package/dist/transport/cooldown.js +8 -1
  279. package/dist/transport/delivery.d.ts +14 -6
  280. package/dist/transport/delivery.js +80 -55
  281. package/dist/transport/http-transport.d.ts +1 -0
  282. package/dist/transport/http-transport.js +52 -10
  283. package/dist/transport/index.d.ts +6 -3
  284. package/dist/transport/index.js +3 -0
  285. package/dist/transport/queue-partition.d.ts +91 -0
  286. package/dist/transport/queue-partition.js +143 -0
  287. package/dist/transport/queue.d.ts +99 -20
  288. package/dist/transport/queue.js +210 -69
  289. package/dist/transport/response-body.d.ts +25 -0
  290. package/dist/transport/response-body.js +64 -0
  291. package/dist/transport/send.d.ts +11 -0
  292. package/dist/transport/send.js +17 -0
  293. package/dist/transport/types/delivery-flow.types.d.ts +19 -0
  294. package/dist/transport/types/delivery-flow.types.js +1 -0
  295. package/dist/transport/types/transport.types.d.ts +45 -0
  296. package/dist/turns/claude-transcript.d.ts +19 -1
  297. package/dist/turns/claude-transcript.js +46 -1
  298. package/dist/turns/codex-originator.d.ts +11 -0
  299. package/dist/turns/codex-originator.js +31 -0
  300. package/dist/turns/codex-transcript.d.ts +30 -0
  301. package/dist/turns/codex-transcript.js +88 -0
  302. package/dist/turns/constants/turns.constants.d.ts +141 -5
  303. package/dist/turns/constants/turns.constants.js +155 -5
  304. package/dist/turns/file-identity.d.ts +27 -0
  305. package/dist/turns/file-identity.js +48 -0
  306. package/dist/turns/gemini-transcript.d.ts +30 -0
  307. package/dist/turns/gemini-transcript.js +96 -0
  308. package/dist/turns/index.d.ts +3 -3
  309. package/dist/turns/index.js +1 -1
  310. package/dist/turns/inherited-checkout.d.ts +54 -0
  311. package/dist/turns/inherited-checkout.js +155 -0
  312. package/dist/turns/native-session-titles.d.ts +26 -0
  313. package/dist/turns/native-session-titles.js +102 -0
  314. package/dist/turns/transcript.d.ts +3 -2
  315. package/dist/turns/transcript.js +5 -1
  316. package/dist/turns/turn-state.d.ts +224 -3
  317. package/dist/turns/turn-state.js +456 -21
  318. package/dist/turns/turn-summary.d.ts +1 -14
  319. package/dist/turns/turn-summary.js +87 -51
  320. package/dist/turns/turn-tracker.d.ts +21 -2
  321. package/dist/turns/turn-tracker.js +379 -56
  322. package/dist/turns/types/transcript.types.d.ts +5 -0
  323. package/dist/turns/types/turn-state.types.d.ts +116 -5
  324. package/dist/turns/types/turn-summary.types.d.ts +64 -14
  325. package/dist/turns/types/turn-tracker.types.d.ts +27 -1
  326. package/dist/turns/work-checkout.d.ts +65 -0
  327. package/dist/turns/work-checkout.js +666 -0
  328. package/dist/untraced/constants/untraced.constants.d.ts +31 -0
  329. package/dist/untraced/constants/untraced.constants.js +63 -0
  330. package/dist/untraced/untraced.d.ts +35 -0
  331. package/dist/untraced/untraced.js +105 -0
  332. package/dist/update/constants/update.constants.d.ts +18 -0
  333. package/dist/update/constants/update.constants.js +20 -0
  334. package/dist/update/update-check.d.ts +52 -0
  335. package/dist/update/update-check.js +113 -0
  336. package/docs/AUDIT_PROMPT.md +129 -0
  337. package/docs/DATA_HANDLING.md +648 -0
  338. package/docs/ENTERPRISE_DEPLOYMENT.md +179 -0
  339. package/docs/PERFORMANCE.md +81 -0
  340. package/package.json +14 -4
  341. package/dist/enrollment/enrollment-provider.d.ts +0 -5
  342. package/dist/enrollment/manual-enrollment.d.ts +0 -32
  343. package/dist/enrollment/manual-enrollment.js +0 -72
  344. package/example/README.md +0 -43
  345. package/example/server.mjs +0 -240
  346. /package/dist/{enrollment/enrollment-provider.js → config/types/destination.types.js} +0 -0
@@ -1,240 +0,0 @@
1
- #!/usr/bin/env node
2
- /**
3
- * Example AgentWatch backend: a zero-dependency Node.js server that accepts
4
- * everything the Edge and the agents' native OpenTelemetry send, and logs
5
- * it to the console. For local testing only.
6
- *
7
- * npm run example # listens on http://127.0.0.1:8787
8
- * PORT=9000 npm run example
9
- * JSON=1 npm run example # also print each event as full JSON
10
- * BLOCK=1 npm run example # answer every enforcement check with "block"
11
- * BLOCK=dev@acme.test ... # block just that developer
12
- *
13
- * Endpoints:
14
- * POST /v1/events turn.summary records (JSON)
15
- * GET /v1/enforcement/decision pre-turn budget check (allow / block)
16
- * POST /v1/otlp/v1/metrics
17
- * POST /v1/otlp/v1/logs
18
- * POST /v1/otlp/v1/traces
19
- * GET / health check
20
- */
21
- import http from 'node:http';
22
- import { decodeOtlpJson, otlpSignalFromPath } from '../dist/otlp/http.js';
23
- import { normalizeOtlpLogs } from '../dist/otlp/normalize.js';
24
-
25
- const PORT = Number(process.env.PORT ?? 8787);
26
- const PRINT_JSON = process.env.JSON === '1';
27
- // Which developer the pre-turn check refuses: "1" for everyone, an identity for
28
- // one person, unset for nobody. The Edge blocks a turn only on an explicit
29
- // block, so leaving this unset is how the check stays invisible.
30
- const BLOCK = process.env.BLOCK ?? '';
31
- const BLOCK_MESSAGE = process.env.BLOCK_MESSAGE ?? 'You passed your $500 monthly hard limit; ask your admin to raise the cap or dismiss the alert.';
32
- const isTTY = process.stdout.isTTY;
33
- const paint = (code, text) => (isTTY ? `\u001b[${code}m${text}\u001b[0m` : text);
34
- const dim = (text) => paint('90', text);
35
- const timestamp = () => new Date().toISOString().slice(11, 23);
36
-
37
- let eventCount = 0;
38
- let otlpCount = 0;
39
- let llmCallCount = 0;
40
-
41
- function log(tag, tagColor, message) {
42
- console.log(`${dim(timestamp())} ${paint(tagColor, tag.padEnd(8))} ${message}`);
43
- }
44
-
45
- function shortId(id) {
46
- return typeof id === 'string' && id.length > 8 ? id.slice(0, 8) : (id ?? '-');
47
- }
48
-
49
- function describeEvent(event) {
50
- const parts = [
51
- paint('36', (event.agent?.provider ?? '?').padEnd(6)),
52
- paint('1', (event.event?.type ?? '?').padEnd(20)),
53
- dim(`session=${shortId(event.session?.id)}`)
54
- ];
55
- if (event.tool?.name) parts.push(`tool=${event.tool.name}`);
56
- if (event.metadata?.filePath) parts.push(`file=${event.metadata.filePath}`);
57
- if (event.metadata?.command) parts.push(`cmd=${JSON.stringify(event.metadata.command)}`);
58
- const model = event.ai?.model ?? event.model;
59
- if (model) parts.push(`model=${model}`);
60
- const billing = event.ai?.billingMode ?? event.billing_mode;
61
- if (billing) parts.push(paint('35', billing));
62
- const usage = event.ai?.usage ?? (event.output_tokens !== undefined ? { inputTokens: event.input_tokens, outputTokens: event.output_tokens, cachedInputTokens: event.cached_input_tokens } : undefined);
63
- if (usage?.outputTokens !== undefined) {
64
- const cached = usage.cachedInputTokens !== undefined ? ` cached=${usage.cachedInputTokens}` : '';
65
- parts.push(paint('33', `tokens[in=${usage.inputTokens ?? 0} out=${usage.outputTokens}${cached}]`));
66
- }
67
- // Product events (llm.call, turn.summary) carry flat git/ticket fields;
68
- // other canonical events still use the nested git/feature envelope.
69
- const branch = event.branch ?? event.git?.branch;
70
- if (branch) parts.push(dim(`${event.repository ?? event.git?.repository ?? ''}@${branch}`));
71
- const tickets = event.jira_ids ?? event.feature?.candidates?.map((c) => c.value);
72
- if (tickets?.length) parts.push(paint('33', `ticket=${tickets.join(',')}`));
73
- return parts.join(' ');
74
- }
75
-
76
- /** Pull readable metric/event names out of an OTLP protobuf body (demo aid). */
77
- function sniffOtlpNames(body) {
78
- const text = body.toString('latin1');
79
- const names = new Set();
80
- for (const match of text.matchAll(/(?:claude_code|codex|gen_ai)[.\w]+/g)) {
81
- names.add(match[0]);
82
- if (names.size >= 8) break;
83
- }
84
- return [...names];
85
- }
86
-
87
- /** Flatten OTLP JSON KeyValue attributes into a plain object. */
88
- function otlpAttributes(list) {
89
- const out = {};
90
- for (const { key, value } of list ?? []) {
91
- if (!value) continue;
92
- out[key] = value.stringValue ?? value.intValue ?? value.doubleValue ?? value.boolValue ?? undefined;
93
- }
94
- return out;
95
- }
96
-
97
- /** One readable line per OTLP JSON log record / metric (demo aid). */
98
- function describeOtlpJson(signal, payload) {
99
- const lines = [];
100
- if (signal === 'logs') {
101
- for (const resource of payload.resourceLogs ?? []) {
102
- for (const scope of resource.scopeLogs ?? []) {
103
- for (const record of scope.logRecords ?? []) {
104
- const attrs = otlpAttributes(record.attributes);
105
- const name = attrs['event.name'] ?? record.body?.stringValue ?? 'log';
106
- const parts = [paint('1', String(name).padEnd(28))];
107
- if (attrs['session.id']) parts.push(dim(`session=${shortId(attrs['session.id'])}`));
108
- if (attrs['model']) parts.push(`model=${attrs['model']}`);
109
- const tokens = ['input_tokens', 'output_tokens', 'cache_read_tokens', 'cache_creation_tokens']
110
- .filter((key) => attrs[key] !== undefined)
111
- .map((key) => `${key.replace('_tokens', '')}=${attrs[key]}`);
112
- if (tokens.length > 0) parts.push(paint('33', `tokens[${tokens.join(' ')}]`));
113
- if (attrs['cost_usd'] !== undefined) parts.push(paint('32', `$${Number(attrs['cost_usd']).toFixed(6)}`));
114
- lines.push(parts.join(' '));
115
- }
116
- }
117
- }
118
- }
119
- if (signal === 'metrics') {
120
- for (const resource of payload.resourceMetrics ?? []) {
121
- for (const scope of resource.scopeMetrics ?? []) {
122
- for (const metric of scope.metrics ?? []) {
123
- const points = metric.sum?.dataPoints ?? metric.gauge?.dataPoints ?? metric.histogram?.dataPoints ?? [];
124
- lines.push(`${paint('1', String(metric.name ?? 'metric').padEnd(28))} ${dim(`${points.length} datapoint(s)`)}`);
125
- }
126
- }
127
- }
128
- }
129
- return lines;
130
- }
131
-
132
- const server = http.createServer(async (req, res) => {
133
- const chunks = [];
134
- for await (const chunk of req) chunks.push(chunk);
135
- const body = Buffer.concat(chunks);
136
- const url = (req.url ?? '/').split('?')[0];
137
- const auth = req.headers.authorization ? dim(' auth=bearer') : '';
138
-
139
- if (req.method === 'POST' && url === '/v1/events') {
140
- try {
141
- const payload = JSON.parse(body.toString('utf8'));
142
- const events = Array.isArray(payload.events) ? payload.events : [];
143
- eventCount += events.length;
144
- for (const event of events) {
145
- log('TURN.SUMMARY', '32', describeEvent(event) + auth);
146
- if (PRINT_JSON) console.log(dim(JSON.stringify(event, null, 2)));
147
- }
148
- if (events.length === 0) log('TURN.SUMMARY', '32', dim('empty batch (connectivity probe)') + auth);
149
- res.writeHead(200, { 'content-type': 'application/json' });
150
- res.end(JSON.stringify({ ok: true, received: events.length, total: eventCount }));
151
- } catch (error) {
152
- log('TURN.SUMMARY', '31', `bad JSON: ${error.message}`);
153
- res.writeHead(400, { 'content-type': 'application/json' });
154
- res.end(JSON.stringify({ ok: false }));
155
- }
156
- return;
157
- }
158
-
159
- const otlpSignal = otlpSignalFromPath(url);
160
- if (req.method === 'POST' && otlpSignal) {
161
- const signal = otlpSignal;
162
- const contentType = req.headers['content-type'] ?? '';
163
- let detail = `${body.length} bytes (${contentType})`;
164
- let recordLines = [];
165
- if (contentType.includes('json')) {
166
- const decoded = decodeOtlpJson(body);
167
- if (!decoded.ok) {
168
- log(`OTLP:${signal}`, '31', `${detail} ${dim('(invalid JSON payload)')}` + auth);
169
- res.writeHead(400, { 'content-type': 'application/json' });
170
- res.end(JSON.stringify({ code: 3, message: 'invalid OTLP JSON payload' }));
171
- return;
172
- }
173
- const payload = decoded.payload;
174
- recordLines = describeOtlpJson(signal, payload);
175
- if (signal === 'logs') {
176
- const calls = normalizeOtlpLogs(payload, { receivedAt: new Date().toISOString() });
177
- llmCallCount += calls.length;
178
- for (const call of calls) {
179
- log('LLM.CALL', '36', describeEvent(call) + ` call=${shortId(call.call_id)}` + auth);
180
- if (PRINT_JSON) console.log(dim(JSON.stringify(call, null, 2)));
181
- }
182
- }
183
- // Raw OTLP payloads are never dumped: the two product events
184
- // (llm.call, turn.summary) are the only JSON worth reading.
185
- } else {
186
- const names = sniffOtlpNames(body);
187
- if (names.length > 0) detail += ' ' + paint('33', names.join(' '));
188
- }
189
- otlpCount += 1;
190
- // Logs batches are already shown as LLM.CALL lines above; raw OTLP output is noise.
191
- if (signal !== 'logs') {
192
- log(`OTLP:${signal}`, '35', detail + auth);
193
- for (const line of recordLines) console.log(`${dim(timestamp())} ${' '.repeat(9)}${line}`);
194
- }
195
- // OTLP/HTTP: the response must use the same encoding as the request.
196
- if (contentType.includes('json')) {
197
- res.writeHead(200, { 'content-type': 'application/json' });
198
- res.end('{}'); // empty Export*ServiceResponse
199
- } else {
200
- res.writeHead(200, { 'content-type': 'application/x-protobuf' });
201
- res.end(); // empty message is a valid Export*ServiceResponse
202
- }
203
- return;
204
- }
205
-
206
- if (req.method === 'GET' && url === '/v1/enforcement/decision') {
207
- const developerId = new URL(req.url ?? '/', 'http://127.0.0.1').searchParams.get('developer_id') ?? '';
208
- if (developerId === '') {
209
- log('ENFORCE', '31', `missing developer_id -> 400${auth}`);
210
- res.writeHead(400, { 'content-type': 'application/json' });
211
- res.end(JSON.stringify({ message: 'developer_id is required' }));
212
- return;
213
- }
214
- const blocked = BLOCK === '1' || BLOCK === developerId;
215
- const decision = blocked ? { decision: 'block', message: BLOCK_MESSAGE } : { decision: 'allow' };
216
- log('ENFORCE', blocked ? '31' : '32', `${developerId} -> ${decision.decision}${auth}`);
217
- res.writeHead(200, { 'content-type': 'application/json' });
218
- res.end(JSON.stringify(decision));
219
- return;
220
- }
221
-
222
- if (req.method === 'GET' && url === '/') {
223
- res.writeHead(200, { 'content-type': 'application/json' });
224
- res.end(JSON.stringify({ ok: true, summaries: eventCount, llmCalls: llmCallCount, otlpBatches: otlpCount }));
225
- return;
226
- }
227
-
228
- log('HTTP', '33', `${req.method} ${url} -> 404`);
229
- res.writeHead(404, { 'content-type': 'application/json' });
230
- res.end(JSON.stringify({ ok: false, error: 'not found' }));
231
- });
232
-
233
- server.listen(PORT, '127.0.0.1', () => {
234
- console.log(paint('1', `AgentWatch example backend listening on http://127.0.0.1:${PORT}`));
235
- console.log(dim(' summary: POST /v1/events'));
236
- console.log(dim(` otlp: POST /v1/otlp/v1/{logs,traces,metrics}`));
237
- console.log(dim(` budget: GET /v1/enforcement/decision${BLOCK === '' ? ' (allowing everyone; set BLOCK=1 to refuse)' : ` (blocking ${BLOCK === '1' ? 'everyone' : BLOCK})`}`));
238
- console.log(dim(` connect the edge: agentwatch setup --endpoint http://127.0.0.1:${PORT} --yes`));
239
- console.log();
240
- });