@agent-watch-ai/edge 0.2.5 → 0.4.0

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 (348) hide show
  1. package/CHANGELOG.md +558 -0
  2. package/README.md +222 -97
  3. package/SECURITY.md +72 -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 +52 -4
  9. package/dist/cli/constants/cli.constants.js +56 -5
  10. package/dist/cli/context.d.ts +33 -2
  11. package/dist/cli/context.js +84 -14
  12. package/dist/cli/doctor.js +321 -33
  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 +553 -103
  26. package/dist/cli/status.js +82 -13
  27. package/dist/cli/toggle.d.ts +9 -0
  28. package/dist/cli/toggle.js +117 -0
  29. package/dist/cli/types/cli.types.d.ts +43 -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 +110 -12
  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 +116 -6
  41. package/dist/config/constants/config.constants.js +131 -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 +831 -84
  51. package/dist/config/schemas/config.schema.js +398 -16
  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 +119 -0
  71. package/dist/credentials/constants/credentials.constants.js +120 -0
  72. package/dist/credentials/credential-status.d.ts +14 -0
  73. package/dist/credentials/credential-status.js +38 -0
  74. package/dist/credentials/credentials.d.ts +86 -0
  75. package/dist/credentials/credentials.js +278 -0
  76. package/dist/credentials/device-api.d.ts +73 -0
  77. package/dist/credentials/device-api.js +161 -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 +73 -0
  81. package/dist/credentials/identity.js +101 -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 +31 -0
  93. package/dist/credentials/sign-in.js +105 -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 +206 -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 +64 -17
  104. package/dist/enforcement/enforcement.d.ts +23 -2
  105. package/dist/enforcement/enforcement.js +107 -17
  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 +66 -2
  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 +10 -0
  160. package/dist/pipeline/constants/pipeline.constants.js +10 -0
  161. package/dist/pipeline/hook-pipeline.js +410 -33
  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 +75 -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 +36 -3
  197. package/dist/providers/codex/codex.otel.js +199 -32
  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 +10 -0
  202. package/dist/providers/codex/constants/codex.otel.constants.js +10 -0
  203. package/dist/providers/constants/provider.constants.d.ts +8 -3
  204. package/dist/providers/constants/provider.constants.js +8 -3
  205. package/dist/providers/cursor/constants/cursor.constants.d.ts +9 -0
  206. package/dist/providers/cursor/constants/cursor.constants.js +9 -0
  207. package/dist/providers/cursor/cursor.adapter.d.ts +33 -1
  208. package/dist/providers/cursor/cursor.adapter.js +129 -4
  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 +9 -1
  215. package/dist/providers/gemini/constants/gemini.otel.constants.js +9 -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 +30 -21
  221. package/dist/providers/gemini/gemini.otel.js +166 -22
  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/bearer-rewrite.d.ts +19 -0
  232. package/dist/providers/shared/bearer-rewrite.js +46 -0
  233. package/dist/providers/shared/constants/hook-refusal.constants.d.ts +7 -0
  234. package/dist/providers/shared/constants/hook-refusal.constants.js +7 -0
  235. package/dist/providers/shared/constants/shell-directories.constants.d.ts +30 -0
  236. package/dist/providers/shared/constants/shell-directories.constants.js +39 -0
  237. package/dist/providers/shared/constants/tooling.constants.d.ts +24 -2
  238. package/dist/providers/shared/constants/tooling.constants.js +25 -3
  239. package/dist/providers/shared/event-builder.d.ts +12 -14
  240. package/dist/providers/shared/event-builder.js +20 -14
  241. package/dist/providers/shared/exporter-allowlist.d.ts +20 -0
  242. package/dist/providers/shared/exporter-allowlist.js +49 -0
  243. package/dist/providers/shared/hook-config.d.ts +2 -21
  244. package/dist/providers/shared/hook-config.js +5 -4
  245. package/dist/providers/shared/hook-refusal.d.ts +12 -0
  246. package/dist/providers/shared/hook-refusal.js +17 -1
  247. package/dist/providers/shared/install-record.d.ts +12 -2
  248. package/dist/providers/shared/install-record.js +5 -2
  249. package/dist/providers/shared/shell-directories.d.ts +24 -0
  250. package/dist/providers/shared/shell-directories.js +90 -0
  251. package/dist/providers/shared/tooling.d.ts +40 -1
  252. package/dist/providers/shared/tooling.js +70 -1
  253. package/dist/providers/shared/types/adapter.types.d.ts +1 -2
  254. package/dist/providers/types/provider.types.d.ts +81 -1
  255. package/dist/snapshot/constants/snapshot.constants.d.ts +32 -0
  256. package/dist/snapshot/constants/snapshot.constants.js +33 -0
  257. package/dist/snapshot/snapshot-event.js +52 -11
  258. package/dist/snapshot/snapshot-pipeline.js +1 -1
  259. package/dist/snapshot/types/snapshot.types.d.ts +2 -0
  260. package/dist/storage/atomic-file.d.ts +21 -0
  261. package/dist/storage/atomic-file.js +20 -1
  262. package/dist/storage/constants/storage.constants.d.ts +19 -0
  263. package/dist/storage/constants/storage.constants.js +19 -0
  264. package/dist/storage/disabled.d.ts +13 -0
  265. package/dist/storage/disabled.js +24 -0
  266. package/dist/storage/index.d.ts +2 -0
  267. package/dist/storage/index.js +2 -0
  268. package/dist/storage/paths.js +3 -2
  269. package/dist/storage/schemas/storage.schema.d.ts +72 -0
  270. package/dist/storage/schemas/storage.schema.js +6 -0
  271. package/dist/storage/sweep-marker.d.ts +19 -0
  272. package/dist/storage/sweep-marker.js +55 -0
  273. package/dist/storage/types/storage.types.d.ts +2 -0
  274. package/dist/storage/uninstalled.d.ts +58 -0
  275. package/dist/storage/uninstalled.js +107 -0
  276. package/dist/transport/auth-block.d.ts +66 -0
  277. package/dist/transport/auth-block.js +129 -0
  278. package/dist/transport/constants/transport.constants.d.ts +82 -3
  279. package/dist/transport/constants/transport.constants.js +83 -4
  280. package/dist/transport/cooldown.js +8 -1
  281. package/dist/transport/delivery.d.ts +14 -6
  282. package/dist/transport/delivery.js +80 -55
  283. package/dist/transport/http-transport.d.ts +1 -0
  284. package/dist/transport/http-transport.js +52 -10
  285. package/dist/transport/index.d.ts +6 -3
  286. package/dist/transport/index.js +3 -0
  287. package/dist/transport/queue-partition.d.ts +91 -0
  288. package/dist/transport/queue-partition.js +143 -0
  289. package/dist/transport/queue.d.ts +99 -20
  290. package/dist/transport/queue.js +210 -69
  291. package/dist/transport/response-body.d.ts +25 -0
  292. package/dist/transport/response-body.js +64 -0
  293. package/dist/transport/send.d.ts +11 -0
  294. package/dist/transport/send.js +17 -0
  295. package/dist/transport/types/delivery-flow.types.d.ts +19 -0
  296. package/dist/transport/types/delivery-flow.types.js +1 -0
  297. package/dist/transport/types/transport.types.d.ts +45 -0
  298. package/dist/turns/claude-transcript.d.ts +19 -1
  299. package/dist/turns/claude-transcript.js +46 -1
  300. package/dist/turns/codex-originator.d.ts +11 -0
  301. package/dist/turns/codex-originator.js +31 -0
  302. package/dist/turns/codex-transcript.d.ts +30 -0
  303. package/dist/turns/codex-transcript.js +88 -0
  304. package/dist/turns/constants/turns.constants.d.ts +141 -5
  305. package/dist/turns/constants/turns.constants.js +155 -5
  306. package/dist/turns/file-identity.d.ts +27 -0
  307. package/dist/turns/file-identity.js +48 -0
  308. package/dist/turns/gemini-transcript.d.ts +30 -0
  309. package/dist/turns/gemini-transcript.js +96 -0
  310. package/dist/turns/index.d.ts +3 -3
  311. package/dist/turns/index.js +1 -1
  312. package/dist/turns/inherited-checkout.d.ts +54 -0
  313. package/dist/turns/inherited-checkout.js +155 -0
  314. package/dist/turns/native-session-titles.d.ts +26 -0
  315. package/dist/turns/native-session-titles.js +102 -0
  316. package/dist/turns/transcript.d.ts +3 -2
  317. package/dist/turns/transcript.js +5 -1
  318. package/dist/turns/turn-state.d.ts +224 -3
  319. package/dist/turns/turn-state.js +456 -21
  320. package/dist/turns/turn-summary.d.ts +1 -14
  321. package/dist/turns/turn-summary.js +87 -51
  322. package/dist/turns/turn-tracker.d.ts +21 -2
  323. package/dist/turns/turn-tracker.js +379 -56
  324. package/dist/turns/types/transcript.types.d.ts +5 -0
  325. package/dist/turns/types/turn-state.types.d.ts +116 -5
  326. package/dist/turns/types/turn-summary.types.d.ts +64 -14
  327. package/dist/turns/types/turn-tracker.types.d.ts +27 -1
  328. package/dist/turns/work-checkout.d.ts +67 -0
  329. package/dist/turns/work-checkout.js +700 -0
  330. package/dist/untraced/constants/untraced.constants.d.ts +31 -0
  331. package/dist/untraced/constants/untraced.constants.js +63 -0
  332. package/dist/untraced/untraced.d.ts +35 -0
  333. package/dist/untraced/untraced.js +105 -0
  334. package/dist/update/constants/update.constants.d.ts +18 -0
  335. package/dist/update/constants/update.constants.js +20 -0
  336. package/dist/update/update-check.d.ts +52 -0
  337. package/dist/update/update-check.js +113 -0
  338. package/docs/AUDIT_PROMPT.md +129 -0
  339. package/docs/DATA_HANDLING.md +655 -0
  340. package/docs/ENTERPRISE_DEPLOYMENT.md +194 -0
  341. package/docs/PERFORMANCE.md +81 -0
  342. package/package.json +14 -4
  343. package/dist/enrollment/enrollment-provider.d.ts +0 -5
  344. package/dist/enrollment/manual-enrollment.d.ts +0 -32
  345. package/dist/enrollment/manual-enrollment.js +0 -72
  346. package/example/README.md +0 -43
  347. package/example/server.mjs +0 -240
  348. /package/dist/{enrollment/enrollment-provider.js → config/types/destination.types.js} +0 -0
@@ -1,5 +1,5 @@
1
1
  import type { CanonicalEventType, ContentEvidence } from '../../events/types/events.types.js';
2
- import type { McpToolName, ToolKind } from '../types/provider.types.js';
2
+ import type { McpToolName, ShellCall, ToolKind } from '../types/provider.types.js';
3
3
  export type { McpToolName, ToolKind } from '../types/provider.types.js';
4
4
  /**
5
5
  * What kind of thing a tool call is, whatever the agent calls it.
@@ -32,6 +32,34 @@ export declare function toolCompleteType(kind: ToolKind): CanonicalEventType;
32
32
  * @returns The server and tool, or an empty object for a non-MCP name.
33
33
  */
34
34
  export declare function parseMcpToolName(toolName: string): McpToolName;
35
+ /**
36
+ * The `tools_used` key of an MCP call: `mcp__<server>__<tool>`, no arguments.
37
+ *
38
+ * One builder for every provider so the backend can split the key back apart.
39
+ * Scrubbed and cut at the bridge's bound, because a server can come from a
40
+ * URL host or a command and must never carry a credential into a key.
41
+ *
42
+ * @param server - Server's logical name, host or command base name.
43
+ * @param tool - Tool name on that server.
44
+ * @returns The key.
45
+ */
46
+ export declare function mcpToolKey(server: string, tool: string): string;
47
+ /**
48
+ * Fold every `mcp__*` key of a `tools_used` map into `mcp`, keeping the count.
49
+ *
50
+ * @param toolsUsed - Per-tool call counts.
51
+ * @returns The counts with MCP server and tool names withheld.
52
+ */
53
+ export declare function foldMcpNames(toolsUsed: Readonly<Record<string, number>>): Record<string, number>;
54
+ /**
55
+ * Server name of a Cursor MCP hook that carries no `mcp__` name: the host of a
56
+ * remote endpoint, else the base name of a stdio command (first word, quote-aware).
57
+ *
58
+ * @param url - The remote endpoint, if any.
59
+ * @param command - The stdio command line, if any.
60
+ * @returns The server, or undefined when neither yields one.
61
+ */
62
+ export declare function mcpServerFromEndpoint(url: string | undefined, command: string | undefined): string | undefined;
35
63
  /**
36
64
  * Length and hash of text, as evidence for content we may not transmit.
37
65
  *
@@ -56,3 +84,14 @@ export declare function extractFilePath(toolInput: unknown): string | undefined;
56
84
  * @returns The command, or undefined when the input names none.
57
85
  */
58
86
  export declare function extractCommand(toolInput: unknown): string | undefined;
87
+ /**
88
+ * A shell call out of untrusted payload fields, type-checked.
89
+ *
90
+ * A working directory counts only when it is an absolute path: a relative one
91
+ * would have to be resolved against a guess.
92
+ *
93
+ * @param command - The command field as the payload carries it.
94
+ * @param workdir - The working-directory field as the payload carries it.
95
+ * @returns The call, or undefined when neither field is usable.
96
+ */
97
+ export declare function shellCallOf(command: unknown, workdir: unknown): ShellCall | undefined;
@@ -1,6 +1,8 @@
1
+ import path from 'node:path';
1
2
  import { asRecord, firstString } from '../../core/object.js';
3
+ import { sanitizeText } from '../../privacy/sanitizer.js';
2
4
  import { sha256Hex } from '../../events/event-id.js';
3
- import { COMMAND_KEYS, FILE_EDIT_TOOLS, FILE_PATH_KEYS, FILE_READ_TOOLS, MCP_TOOL_PREFIX, MCP_TOOL_SEPARATOR, SHELL_TOOLS } from './constants/tooling.constants.js';
5
+ import { COMMAND_KEYS, FILE_EDIT_TOOLS, FILE_PATH_KEYS, FILE_READ_TOOLS, COMMAND_HEAD, MAX_TOOL_KEY_LENGTH, MCP_FOLDED_KEY, MCP_TOOL_PREFIX, MCP_TOOL_SEPARATOR, SHELL_TOOLS } from './constants/tooling.constants.js';
4
6
  /**
5
7
  * What kind of thing a tool call is, whatever the agent calls it.
6
8
  *
@@ -65,6 +67,56 @@ export function parseMcpToolName(toolName) {
65
67
  const parts = toolName.split(MCP_TOOL_SEPARATOR);
66
68
  return { server: parts[1], tool: parts.slice(2).join(MCP_TOOL_SEPARATOR) || undefined };
67
69
  }
70
+ /**
71
+ * The `tools_used` key of an MCP call: `mcp__<server>__<tool>`, no arguments.
72
+ *
73
+ * One builder for every provider so the backend can split the key back apart.
74
+ * Scrubbed and cut at the bridge's bound, because a server can come from a
75
+ * URL host or a command and must never carry a credential into a key.
76
+ *
77
+ * @param server - Server's logical name, host or command base name.
78
+ * @param tool - Tool name on that server.
79
+ * @returns The key.
80
+ */
81
+ export function mcpToolKey(server, tool) {
82
+ return sanitizeText(`${MCP_TOOL_PREFIX}${server}${MCP_TOOL_SEPARATOR}${tool}`).slice(0, MAX_TOOL_KEY_LENGTH);
83
+ }
84
+ /**
85
+ * Fold every `mcp__*` key of a `tools_used` map into `mcp`, keeping the count.
86
+ *
87
+ * @param toolsUsed - Per-tool call counts.
88
+ * @returns The counts with MCP server and tool names withheld.
89
+ */
90
+ export function foldMcpNames(toolsUsed) {
91
+ const folded = {};
92
+ for (const [name, count] of Object.entries(toolsUsed)) {
93
+ const key = name.startsWith(MCP_TOOL_PREFIX) ? MCP_FOLDED_KEY : name;
94
+ folded[key] = (folded[key] ?? 0) + count;
95
+ }
96
+ return folded;
97
+ }
98
+ /**
99
+ * Server name of a Cursor MCP hook that carries no `mcp__` name: the host of a
100
+ * remote endpoint, else the base name of a stdio command (first word, quote-aware).
101
+ *
102
+ * @param url - The remote endpoint, if any.
103
+ * @param command - The stdio command line, if any.
104
+ * @returns The server, or undefined when neither yields one.
105
+ */
106
+ export function mcpServerFromEndpoint(url, command) {
107
+ if (url) {
108
+ try {
109
+ return new URL(url).host || undefined;
110
+ }
111
+ catch {
112
+ return undefined;
113
+ }
114
+ }
115
+ const executable = command ? COMMAND_HEAD.exec(command) : null;
116
+ const head = executable?.[1] ?? executable?.[2] ?? executable?.[3];
117
+ // ponytail: an unquoted path with spaces is ambiguous and splits at the first space; npx/uvx/docker name the launcher, not the server.
118
+ return head ? head.split(/[\\/]/).pop() || undefined : undefined;
119
+ }
68
120
  /**
69
121
  * Length and hash of text, as evidence for content we may not transmit.
70
122
  *
@@ -101,3 +153,20 @@ export function extractCommand(toolInput) {
101
153
  return undefined;
102
154
  return firstString(record, COMMAND_KEYS);
103
155
  }
156
+ /**
157
+ * A shell call out of untrusted payload fields, type-checked.
158
+ *
159
+ * A working directory counts only when it is an absolute path: a relative one
160
+ * would have to be resolved against a guess.
161
+ *
162
+ * @param command - The command field as the payload carries it.
163
+ * @param workdir - The working-directory field as the payload carries it.
164
+ * @returns The call, or undefined when neither field is usable.
165
+ */
166
+ export function shellCallOf(command, workdir) {
167
+ const call = {
168
+ command: typeof command === 'string' && command.length > 0 ? command : undefined,
169
+ workdir: typeof workdir === 'string' && path.isAbsolute(workdir) ? workdir : undefined
170
+ };
171
+ return call.command || call.workdir ? call : undefined;
172
+ }
@@ -44,8 +44,7 @@ export interface ToolCallInput {
44
44
  }
45
45
  /** What the effective config allows to be captured. */
46
46
  export interface CapturePolicy {
47
- readonly prompts: boolean;
48
- readonly responses: boolean;
47
+ readonly promptText: boolean;
49
48
  readonly toolInput: boolean;
50
49
  readonly toolOutput: boolean;
51
50
  readonly files: boolean;
@@ -1,4 +1,4 @@
1
- import type { AgentWatchConfig } from '../../config/types/config.types.js';
1
+ import type { AgentWatchConfig, OtelSignalName } from '../../config/types/config.types.js';
2
2
  import type { Env } from '../../core/types/core.types.js';
3
3
  import type { AgentWatchEvent } from '../../events/types/events.types.js';
4
4
  import type { AgentWatchPaths, InstallState } from '../../storage/types/storage.types.js';
@@ -20,6 +20,23 @@ export interface SetupContext {
20
20
  readonly hookCommand: string;
21
21
  /** What setup has recorded so far; an operation returns the next version. */
22
22
  readonly installState: InstallState;
23
+ /**
24
+ * The bearer an agent's own config may hold (Codex, Gemini): the machine's
25
+ * device access token, which the hook path rewrites as it rotates. Never the
26
+ * install key or the device secret (SPEC R8). Absent writes no header.
27
+ */
28
+ readonly bearer?: string;
29
+ }
30
+ /** What a hook needs to swap the bearer in an agent's config for a newer one. */
31
+ export interface BearerRewriteContext {
32
+ /** The file setup recorded, which a hook's environment may not point at. */
33
+ readonly configPath: string;
34
+ /** Which entries are AgentWatch's to touch. */
35
+ readonly installState: InstallState;
36
+ /** The machine's current access token. */
37
+ readonly bearer: string;
38
+ /** The agent's config file as the caller just read it. */
39
+ readonly raw: string;
23
40
  }
24
41
  export interface SetupOutcome {
25
42
  readonly ok: boolean;
@@ -57,6 +74,30 @@ export interface NativeTelemetryConfigurator {
57
74
  inspect(context: SetupContext): Promise<NativeTelemetryStatus>;
58
75
  configure(context: SetupContext): Promise<SetupOutcome>;
59
76
  uninstall(context: SetupContext): Promise<SetupOutcome>;
77
+ /**
78
+ * Where the AgentWatch-owned exporter config sends, as the agent's file says
79
+ * now: exactly the entries `uninstall` would remove, so a refused host is only
80
+ * ever cleared from what AgentWatch can show it wrote. Empty when there is none.
81
+ */
82
+ exporterEndpoints(context: SetupContext): Promise<readonly string[]>;
83
+ /**
84
+ * Signals this machine asked for that the agent will not be given, because
85
+ * the content its logs carry has no consent.
86
+ *
87
+ * Doctor reports the gate, and the only truthful answer is the configurator's
88
+ * own rule: Codex takes logs and traces all-or-nothing on the two tool flags,
89
+ * Gemini never gets traces, which carry prompts past the edge's scrubber. An
90
+ * agent with no content gate — Claude, which has per-field switches — omits
91
+ * this and is never reported as held back.
92
+ */
93
+ withheldSignals?(config: AgentWatchConfig): readonly OtelSignalName[];
94
+ /**
95
+ * Swap the bearer an earlier `configure` wrote for the current one, touching
96
+ * nothing else, atomically at 0600. For agents that read a literal header
97
+ * once at session start (Codex, Gemini): the hook keeps their file on the
98
+ * live access token so the next session starts with one.
99
+ */
100
+ rewriteBearer?(context: BearerRewriteContext): Promise<boolean>;
60
101
  }
61
102
  export interface AgentProvider {
62
103
  readonly id: string;
@@ -78,6 +119,12 @@ export interface AgentProvider {
78
119
  * how to say it.
79
120
  */
80
121
  getBlockResponse?(payload: unknown, message: string): ProviderHookResponse | undefined;
122
+ /**
123
+ * How to show the developer one line after a tool ran, without blocking or
124
+ * informing the model. Undefined means this hook (or this agent) has no such
125
+ * channel, and the line is not shown.
126
+ */
127
+ getNoticeResponse?(payload: unknown, message: string): ProviderHookResponse | undefined;
81
128
  /**
82
129
  * Working directory this payload was produced in, when the provider does not
83
130
  * report it as a top-level `cwd`. Git context, repository config and ticket
@@ -85,8 +132,28 @@ export interface AgentProvider {
85
132
  * reports `common.workspacePaths`) has to say where it is.
86
133
  */
87
134
  resolveCwd?(payload: unknown): string | undefined;
135
+ /**
136
+ * The shell command a tool-start payload is about to run, and the directory
137
+ * it runs in when the agent reports one apart from `cwd`.
138
+ *
139
+ * Read by one pipeline stage only, in memory, for the directory names in it;
140
+ * the text is dropped there and never reaches an event, a record or a log.
141
+ * Undefined for any payload that is not a shell call.
142
+ */
143
+ shellCall?(payload: unknown): ShellCall | undefined;
144
+ /**
145
+ * The folders the agent has open, when it reports them apart from `cwd`
146
+ * (Cursor's `workspace_roots`). Candidates for the checkout a turn worked in,
147
+ * as weak as the cwd: git decides whether the turn changed one.
148
+ */
149
+ workspaceRoots?(payload: unknown): readonly string[] | undefined;
88
150
  readonly nativeTelemetry?: NativeTelemetryConfigurator;
89
151
  }
152
+ /** A shell call as the agent is about to run it. Memory only; see `AgentProvider.shellCall`. */
153
+ export interface ShellCall {
154
+ readonly command?: string;
155
+ readonly workdir?: string;
156
+ }
90
157
  /** How a tool call is classified for canonical event mapping. */
91
158
  export type ToolKind = 'shell' | 'mcp' | 'file-read' | 'file-edit' | 'other';
92
159
  /** Lifecycle position of a tool event. */
@@ -96,3 +163,16 @@ export interface McpToolName {
96
163
  readonly server?: string;
97
164
  readonly tool?: string;
98
165
  }
166
+ /** One agent whose AgentWatch-owned exporter sent somewhere the edge would not. */
167
+ export interface RefusedExporter {
168
+ readonly agent: string;
169
+ /** Whether its owned entries are gone; false when the agent's file could not be changed. */
170
+ readonly removed: boolean;
171
+ /** One line naming the agent, the refused origin and the outcome. */
172
+ readonly message: string;
173
+ }
174
+ /** What a pass over the agents' exporters did, and the install state after it. */
175
+ export interface ExporterSweep {
176
+ readonly installState: InstallState;
177
+ readonly refused: readonly RefusedExporter[];
178
+ }
@@ -52,5 +52,37 @@ export declare const SNAPSHOT_MAX_SUBJECT_LENGTH = 200;
52
52
  * would report work under a name that does not exist.
53
53
  */
54
54
  export declare const SNAPSHOT_MAX_BRANCH_NAME_LENGTH = 255;
55
+ /**
56
+ * How many changed files one branch may name across its commits (AWT-323).
57
+ *
58
+ * Newest commit first, so the work being done now is what survives the cap; a
59
+ * single commit may use all of it, which is also the backend's per-commit cap.
60
+ * The files are what lets grouping compare branches by content rather than by
61
+ * title, and a few hundred is plenty; past it is a vendored tree, a mass rename
62
+ * or generated churn. The rest are dropped, in git's (alphabetical) order
63
+ * within a commit, and nothing marks that they were.
64
+ *
65
+ * Per branch rather than only per commit because the queue drains by count, not
66
+ * bytes: ten branches of twenty two-hundred-file commits would be ~3 MB per
67
+ * snapshot, and twenty-five of those in one drain pass is a 413, which loses
68
+ * the batch. With {@link SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH} beside it, a
69
+ * snapshot's files stay under ~210 KB however long the paths are.
70
+ */
71
+ export declare const SNAPSHOT_MAX_FILES_PER_BRANCH = 200;
72
+ /**
73
+ * And how many bytes of path one branch may spend, for the same reason: two
74
+ * hundred paths of a thousand characters would be ten times the size the count
75
+ * alone suggests. 16 KiB is two hundred paths of ~80 bytes, past every branch
76
+ * measured (docs/PERFORMANCE.md).
77
+ */
78
+ export declare const SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH: number;
79
+ /** The longest path the backend stores; a longer one is dropped, as it would be there. */
80
+ export declare const SNAPSHOT_MAX_PATH_LENGTH = 1024;
81
+ /**
82
+ * A path holding one of these is not sent: git `-z` prints it raw, and a newline
83
+ * or the listing's own record separator inside it is what a truncated or
84
+ * mis-split listing is made of.
85
+ */
86
+ export declare const SNAPSHOT_RE_CONTROL_CHARACTER: RegExp;
55
87
  /** Hex characters kept from the repository digest that names a state file. */
56
88
  export declare const SNAPSHOT_STATE_HASH_LENGTH = 32;
@@ -52,5 +52,38 @@ export const SNAPSHOT_MAX_SUBJECT_LENGTH = 200;
52
52
  * would report work under a name that does not exist.
53
53
  */
54
54
  export const SNAPSHOT_MAX_BRANCH_NAME_LENGTH = 255;
55
+ /**
56
+ * How many changed files one branch may name across its commits (AWT-323).
57
+ *
58
+ * Newest commit first, so the work being done now is what survives the cap; a
59
+ * single commit may use all of it, which is also the backend's per-commit cap.
60
+ * The files are what lets grouping compare branches by content rather than by
61
+ * title, and a few hundred is plenty; past it is a vendored tree, a mass rename
62
+ * or generated churn. The rest are dropped, in git's (alphabetical) order
63
+ * within a commit, and nothing marks that they were.
64
+ *
65
+ * Per branch rather than only per commit because the queue drains by count, not
66
+ * bytes: ten branches of twenty two-hundred-file commits would be ~3 MB per
67
+ * snapshot, and twenty-five of those in one drain pass is a 413, which loses
68
+ * the batch. With {@link SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH} beside it, a
69
+ * snapshot's files stay under ~210 KB however long the paths are.
70
+ */
71
+ export const SNAPSHOT_MAX_FILES_PER_BRANCH = 200;
72
+ /**
73
+ * And how many bytes of path one branch may spend, for the same reason: two
74
+ * hundred paths of a thousand characters would be ten times the size the count
75
+ * alone suggests. 16 KiB is two hundred paths of ~80 bytes, past every branch
76
+ * measured (docs/PERFORMANCE.md).
77
+ */
78
+ export const SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH = 16 * 1024;
79
+ /** The longest path the backend stores; a longer one is dropped, as it would be there. */
80
+ export const SNAPSHOT_MAX_PATH_LENGTH = 1024;
81
+ /**
82
+ * A path holding one of these is not sent: git `-z` prints it raw, and a newline
83
+ * or the listing's own record separator inside it is what a truncated or
84
+ * mis-split listing is made of.
85
+ */
86
+ // eslint-disable-next-line no-control-regex -- matching control characters is the point
87
+ export const SNAPSHOT_RE_CONTROL_CHARACTER = /[\x00-\x1f\x7f]/;
55
88
  /** Hex characters kept from the repository digest that names a state file. */
56
89
  export const SNAPSHOT_STATE_HASH_LENGTH = 32;
@@ -1,7 +1,9 @@
1
+ import path from 'node:path';
1
2
  import { compact } from '../core/object.js';
2
3
  import { deriveEventId, sha256Hex } from '../events/event-id.js';
3
4
  import { EVENT_SCHEMA_VERSION } from '../events/constants/events.constants.js';
4
- import { SNAPSHOT_MAX_BRANCH_NAME_LENGTH, SNAPSHOT_MAX_SUBJECT_LENGTH } from './constants/snapshot.constants.js';
5
+ import { RE_SECRET_FILE } from '../git/constants/git.constants.js';
6
+ import { SNAPSHOT_MAX_BRANCH_NAME_LENGTH, SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH, SNAPSHOT_MAX_FILES_PER_BRANCH, SNAPSHOT_MAX_PATH_LENGTH, SNAPSHOT_MAX_SUBJECT_LENGTH, SNAPSHOT_RE_CONTROL_CHARACTER } from './constants/snapshot.constants.js';
5
7
  /**
6
8
  * Build the record one repository's changed branches become.
7
9
  *
@@ -42,18 +44,57 @@ export function buildRepoSnapshot(input) {
42
44
  // A name the backend cannot store costs that branch its row, and a
43
45
  // branch name that long is not a name anyone typed.
44
46
  .filter((branch) => branch.name.length <= SNAPSHOT_MAX_BRANCH_NAME_LENGTH)
45
- .map((branch) => compact({
46
- name: branch.name,
47
- head_sha: branch.headSha,
48
- last_commit_at: branch.lastCommitAt,
49
- commits: branch.commits.map((commit) => compact({
50
- sha: commit.sha,
51
- subject: commit.subject.slice(0, SNAPSHOT_MAX_SUBJECT_LENGTH),
52
- authored_at: commit.authoredAt
53
- }))
54
- }))
47
+ .map((branch) => {
48
+ const files = branchFiles(branch.commits);
49
+ return compact({
50
+ name: branch.name,
51
+ head_sha: branch.headSha,
52
+ last_commit_at: branch.lastCommitAt,
53
+ commits: branch.commits.map((commit, index) => compact({
54
+ sha: commit.sha,
55
+ subject: commit.subject.slice(0, SNAPSHOT_MAX_SUBJECT_LENGTH),
56
+ authored_at: commit.authoredAt,
57
+ files: files[index]
58
+ }))
59
+ });
60
+ })
55
61
  });
56
62
  }
63
+ /**
64
+ * The files each commit of one branch sends: names only, within the branch's
65
+ * cap, newest commit first so the cap keeps the current work.
66
+ *
67
+ * A withheld name is dropped before the cap is counted, so it can never cost a
68
+ * real path its place, and a path too long for what is left is skipped while a
69
+ * shorter one after it may still fit.
70
+ *
71
+ * @param commits - The branch's commits, newest first, as git listed them.
72
+ * @returns Per commit, the files to send, or undefined for none known.
73
+ */
74
+ function branchFiles(commits) {
75
+ let files = SNAPSHOT_MAX_FILES_PER_BRANCH;
76
+ let bytes = SNAPSHOT_MAX_FILE_BYTES_PER_BRANCH;
77
+ return commits.map((commit) => {
78
+ const kept = [];
79
+ for (const file of (commit.files ?? []).filter((entry) => sendable(entry.path))) {
80
+ const size = Buffer.byteLength(file.path);
81
+ if (files === 0)
82
+ break;
83
+ if (size > bytes)
84
+ continue;
85
+ files -= 1;
86
+ bytes -= size;
87
+ kept.push(file);
88
+ }
89
+ // Empty only when git listed nothing: a commit whose every file was withheld
90
+ // or capped did change something, and an empty list would say it had not.
91
+ return kept.length > 0 || commit.files?.length === 0 ? kept : undefined;
92
+ });
93
+ }
94
+ /** Whether a path may be named at all: not over-long, no control characters, not a credential file. */
95
+ function sendable(filePath) {
96
+ return filePath.length <= SNAPSHOT_MAX_PATH_LENGTH && !SNAPSHOT_RE_CONTROL_CHARACTER.test(filePath) && !RE_SECRET_FILE.test(path.posix.basename(filePath));
97
+ }
57
98
  /**
58
99
  * What makes this send different from the one before it.
59
100
  *
@@ -96,7 +96,7 @@ async function collectCommits(state) {
96
96
  for (const ref of state.selected) {
97
97
  if (remainingMs(deadline) === 0)
98
98
  break;
99
- const commits = await collectBranchCommits(ref.name, { cwd, defaultBranch: state.defaultBranch, commitCount: SNAPSHOT_COMMITS_PER_BRANCH }, state.run);
99
+ const commits = await collectBranchCommits(ref.name, { cwd, defaultBranch: state.defaultBranch, commitCount: SNAPSHOT_COMMITS_PER_BRANCH, withFiles: state.input.files }, state.run);
100
100
  branches.push({ ...ref, commits });
101
101
  }
102
102
  if (branches.length === 0)
@@ -39,6 +39,8 @@ export interface SnapshotIdentity {
39
39
  /** Everything the snapshot flow needs to decide and build one event. */
40
40
  export interface SnapshotFlowInput extends SnapshotIdentity {
41
41
  readonly cwd: string;
42
+ /** Whether the effective capture policy allows file names; when not, no files listing runs. */
43
+ readonly files: boolean;
42
44
  readonly deadline: number;
43
45
  readonly run: GitRunner;
44
46
  }
@@ -14,6 +14,20 @@
14
14
  * target's.
15
15
  */
16
16
  export declare function writeFileAtomic(filePath: string, contents: string, mode?: number): Promise<void>;
17
+ /**
18
+ * Replace another tool's file only if it still holds what we read.
19
+ *
20
+ * For a write the edge makes while that tool may be running and rewriting the
21
+ * file itself (Codex re-serializes its config.toml): a change since our read is
22
+ * the tool's, and it wins. The window left is the re-read to the rename.
23
+ *
24
+ * @param filePath - The file.
25
+ * @param read - Its contents when the change was computed.
26
+ * @param contents - The new contents.
27
+ * @param mode - Permission bits to force.
28
+ * @returns True when the file was written.
29
+ */
30
+ export declare function writeIfUnchanged(filePath: string, read: string, contents: string, mode: number): Promise<boolean>;
17
31
  /**
18
32
  * Copy a file into the backups directory before we mutate it.
19
33
  *
@@ -23,3 +37,10 @@ export declare function writeFileAtomic(filePath: string, contents: string, mode
23
37
  * @returns The backup path, or undefined when there was nothing to copy.
24
38
  */
25
39
  export declare function backupFile(filePath: string, backupsDir: string, now: Date): Promise<string | undefined>;
40
+ /**
41
+ * Permission bits of an existing file.
42
+ *
43
+ * @param filePath - File to inspect.
44
+ * @returns Its mode, or undefined when the file does not exist.
45
+ */
46
+ export declare function currentMode(filePath: string): Promise<number | undefined>;
@@ -38,6 +38,25 @@ export async function writeFileAtomic(filePath, contents, mode) {
38
38
  throw error;
39
39
  }
40
40
  }
41
+ /**
42
+ * Replace another tool's file only if it still holds what we read.
43
+ *
44
+ * For a write the edge makes while that tool may be running and rewriting the
45
+ * file itself (Codex re-serializes its config.toml): a change since our read is
46
+ * the tool's, and it wins. The window left is the re-read to the rename.
47
+ *
48
+ * @param filePath - The file.
49
+ * @param read - Its contents when the change was computed.
50
+ * @param contents - The new contents.
51
+ * @param mode - Permission bits to force.
52
+ * @returns True when the file was written.
53
+ */
54
+ export async function writeIfUnchanged(filePath, read, contents, mode) {
55
+ if ((await fs.readFile(filePath, 'utf8').catch(() => undefined)) !== read)
56
+ return false;
57
+ await writeFileAtomic(filePath, contents, mode);
58
+ return true;
59
+ }
41
60
  /**
42
61
  * Copy a file into the backups directory before we mutate it.
43
62
  *
@@ -65,7 +84,7 @@ export async function backupFile(filePath, backupsDir, now) {
65
84
  * @param filePath - File to inspect.
66
85
  * @returns Its mode, or undefined when the file does not exist.
67
86
  */
68
- async function currentMode(filePath) {
87
+ export async function currentMode(filePath) {
69
88
  try {
70
89
  return (await fs.stat(filePath)).mode & PERMISSION_MASK;
71
90
  }
@@ -4,6 +4,17 @@ export declare const AGENTWATCH_HOME_DIR_NAME = ".agentwatch";
4
4
  /** Environment overrides for the two roots, used by the test suite. */
5
5
  export declare const CONFIG_DIR_VAR = "AGENTWATCH_CONFIG_DIR";
6
6
  export declare const DATA_DIR_VAR = "AGENTWATCH_DATA_DIR";
7
+ /**
8
+ * Enrollment token, for a setup nobody is watching.
9
+ *
10
+ * An MDM policy runs as root with no terminal and has to get the token in
11
+ * somehow; `--token` puts it on a command line, where `ps` and shell history
12
+ * can see it. This is the private channel for that one case — the flag still
13
+ * wins, so an interactive run is unaffected.
14
+ */
15
+ export declare const TOKEN_VAR = "AGENTWATCH_TOKEN";
16
+ /** An admin-issued enrollment code for an unattended setup: never argv, where `ps` reads it (SPEC R4). */
17
+ export declare const ENROLLMENT_CODE_VAR = "AGENTWATCH_ENROLLMENT_CODE";
7
18
  export declare const CONFIG_FILE_NAME = "config.json";
8
19
  export declare const INSTALL_STATE_FILE_NAME = "install-state.json";
9
20
  /** Sub-directories of the data root. */
@@ -13,6 +24,8 @@ export declare const BACKUPS_DIR_NAME = "backups";
13
24
  export declare const TURNS_DIR_NAME = "turns";
14
25
  /** What the last repository snapshot reported, so the next one can send only changes. */
15
26
  export declare const SNAPSHOTS_DIR_NAME = "snapshots";
27
+ /** One remembered remote per checkout, so the gate spawns git once and not per prompt. */
28
+ export declare const CHECKOUTS_DIR_NAME = "checkouts";
16
29
  /** XDG / Windows locations consulted for the data root, in order. */
17
30
  export declare const LOCAL_APP_DATA_VAR = "LOCALAPPDATA";
18
31
  export declare const XDG_DATA_HOME_VAR = "XDG_DATA_HOME";
@@ -32,3 +45,9 @@ export declare const STALE_LOCK_MS = 30000;
32
45
  export declare const LOCK_ACQUIRE_ATTEMPTS = 2;
33
46
  /** Characters that are unsafe in a timestamped backup filename. */
34
47
  export declare const RE_UNSAFE_STAMP_CHARS: RegExp;
48
+ /** Marker whose mtime records the last sweep, written inside the swept directory. */
49
+ export declare const SWEEP_MARKER_FILE = ".sweep";
50
+ /** The marker `uninstall` leaves beside config.json (AWT-275). */
51
+ export declare const UNINSTALLED_FILE_NAME = "uninstalled.json";
52
+ /** The uninstall marker's name for the machine entry; a root is named by its resolved path. */
53
+ export declare const MACHINE_SCOPE = "machine";
@@ -5,6 +5,17 @@ export const AGENTWATCH_HOME_DIR_NAME = '.agentwatch';
5
5
  /** Environment overrides for the two roots, used by the test suite. */
6
6
  export const CONFIG_DIR_VAR = 'AGENTWATCH_CONFIG_DIR';
7
7
  export const DATA_DIR_VAR = 'AGENTWATCH_DATA_DIR';
8
+ /**
9
+ * Enrollment token, for a setup nobody is watching.
10
+ *
11
+ * An MDM policy runs as root with no terminal and has to get the token in
12
+ * somehow; `--token` puts it on a command line, where `ps` and shell history
13
+ * can see it. This is the private channel for that one case — the flag still
14
+ * wins, so an interactive run is unaffected.
15
+ */
16
+ export const TOKEN_VAR = 'AGENTWATCH_TOKEN';
17
+ /** An admin-issued enrollment code for an unattended setup: never argv, where `ps` reads it (SPEC R4). */
18
+ export const ENROLLMENT_CODE_VAR = 'AGENTWATCH_ENROLLMENT_CODE';
8
19
  export const CONFIG_FILE_NAME = 'config.json';
9
20
  export const INSTALL_STATE_FILE_NAME = 'install-state.json';
10
21
  /** Sub-directories of the data root. */
@@ -14,6 +25,8 @@ export const BACKUPS_DIR_NAME = 'backups';
14
25
  export const TURNS_DIR_NAME = 'turns';
15
26
  /** What the last repository snapshot reported, so the next one can send only changes. */
16
27
  export const SNAPSHOTS_DIR_NAME = 'snapshots';
28
+ /** One remembered remote per checkout, so the gate spawns git once and not per prompt. */
29
+ export const CHECKOUTS_DIR_NAME = 'checkouts';
17
30
  /** XDG / Windows locations consulted for the data root, in order. */
18
31
  export const LOCAL_APP_DATA_VAR = 'LOCALAPPDATA';
19
32
  export const XDG_DATA_HOME_VAR = 'XDG_DATA_HOME';
@@ -33,3 +46,9 @@ export const STALE_LOCK_MS = 30_000;
33
46
  export const LOCK_ACQUIRE_ATTEMPTS = 2;
34
47
  /** Characters that are unsafe in a timestamped backup filename. */
35
48
  export const RE_UNSAFE_STAMP_CHARS = /[:.]/g;
49
+ /** Marker whose mtime records the last sweep, written inside the swept directory. */
50
+ export const SWEEP_MARKER_FILE = '.sweep';
51
+ /** The marker `uninstall` leaves beside config.json (AWT-275). */
52
+ export const UNINSTALLED_FILE_NAME = 'uninstalled.json';
53
+ /** The uninstall marker's name for the machine entry; a root is named by its resolved path. */
54
+ export const MACHINE_SCOPE = 'machine';
@@ -0,0 +1,13 @@
1
+ import type { AgentWatchPaths } from './types/storage.types.js';
2
+ /**
3
+ * Resolve the local stop marker independently of configuration validity.
4
+ * @param paths - User data paths.
5
+ * @returns The marker path.
6
+ */
7
+ export declare function disabledFile(paths: AgentWatchPaths): string;
8
+ /**
9
+ * An unreadable marker must not accidentally resume collection.
10
+ * @param paths - User data paths.
11
+ * @returns Whether collection must remain stopped.
12
+ */
13
+ export declare function isDisabled(paths: AgentWatchPaths): Promise<boolean>;
@@ -0,0 +1,24 @@
1
+ import fs from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ /**
4
+ * Resolve the local stop marker independently of configuration validity.
5
+ * @param paths - User data paths.
6
+ * @returns The marker path.
7
+ */
8
+ export function disabledFile(paths) {
9
+ return path.join(paths.dataDir, 'disabled.json');
10
+ }
11
+ /**
12
+ * An unreadable marker must not accidentally resume collection.
13
+ * @param paths - User data paths.
14
+ * @returns Whether collection must remain stopped.
15
+ */
16
+ export async function isDisabled(paths) {
17
+ try {
18
+ await fs.lstat(disabledFile(paths));
19
+ return true;
20
+ }
21
+ catch (error) {
22
+ return error.code !== 'ENOENT';
23
+ }
24
+ }
@@ -4,6 +4,8 @@
4
4
  */
5
5
  export type { AgentInstallState, AgentWatchPaths, InstallState, JsonReadResult, ReleaseLock } from './types/storage.types.js';
6
6
  export { resolvePaths } from './paths.js';
7
+ export { disabledFile, isDisabled } from './disabled.js';
8
+ export { isUninstalled, uninstalledFile } from './uninstalled.js';
7
9
  export { readJsonFile } from './json-file.js';
8
10
  export { backupFile, writeFileAtomic } from './atomic-file.js';
9
11
  export { acquireLock } from './lock.js';
@@ -1,4 +1,6 @@
1
1
  export { resolvePaths } from './paths.js';
2
+ export { disabledFile, isDisabled } from './disabled.js';
3
+ export { isUninstalled, uninstalledFile } from './uninstalled.js';
2
4
  export { readJsonFile } from './json-file.js';
3
5
  export { backupFile, writeFileAtomic } from './atomic-file.js';
4
6
  export { acquireLock } from './lock.js';