@agent-watch-ai/edge 0.5.0 → 0.7.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 (298) hide show
  1. package/CHANGELOG.md +238 -7
  2. package/README.md +308 -8
  3. package/dist/billing/billing-mode.d.ts +37 -5
  4. package/dist/billing/billing-mode.js +28 -19
  5. package/dist/billing/constants/billing.constants.d.ts +0 -2
  6. package/dist/billing/constants/billing.constants.js +0 -2
  7. package/dist/billing/index.d.ts +2 -1
  8. package/dist/billing/index.js +1 -1
  9. package/dist/billing/session-billing.d.ts +3 -2
  10. package/dist/billing/session-billing.js +8 -8
  11. package/dist/billing/types/billing.types.d.ts +7 -0
  12. package/dist/capture/capture-env.d.ts +147 -0
  13. package/dist/capture/capture-env.js +301 -0
  14. package/dist/capture/captured-step.d.ts +88 -0
  15. package/dist/capture/captured-step.js +479 -0
  16. package/dist/capture/constants/capture.constants.d.ts +70 -0
  17. package/dist/capture/constants/capture.constants.js +72 -0
  18. package/dist/capture/launched-runs.d.ts +16 -0
  19. package/dist/capture/launched-runs.js +151 -0
  20. package/dist/capture/node.cjs +697 -0
  21. package/dist/capture/node.d.cts +32 -0
  22. package/dist/capture/python/sitecustomize.py +823 -0
  23. package/dist/capture/schemas/capture.schema.d.ts +35 -0
  24. package/dist/capture/schemas/capture.schema.js +31 -0
  25. package/dist/capture/types/capture.types.d.ts +20 -0
  26. package/dist/cli/constants/cli.constants.d.ts +2 -6
  27. package/dist/cli/constants/cli.constants.js +3 -7
  28. package/dist/cli/context.d.ts +19 -22
  29. package/dist/cli/context.js +23 -54
  30. package/dist/cli/doctor-run-capture.d.ts +13 -0
  31. package/dist/cli/doctor-run-capture.js +19 -0
  32. package/dist/cli/doctor.js +16 -67
  33. package/dist/cli/hook.d.ts +14 -0
  34. package/dist/cli/hook.js +40 -0
  35. package/dist/cli/index.d.ts +1 -1
  36. package/dist/cli/index.js +1 -1
  37. package/dist/cli/misc.js +10 -2
  38. package/dist/cli/replay.d.ts +33 -0
  39. package/dist/cli/replay.js +193 -0
  40. package/dist/cli/setup.d.ts +10 -2
  41. package/dist/cli/setup.js +154 -26
  42. package/dist/cli/status.js +45 -5
  43. package/dist/cli/toggle.js +10 -0
  44. package/dist/cli/types/cli.types.d.ts +15 -1
  45. package/dist/cli/uninstall.js +8 -22
  46. package/dist/cli.js +104 -17
  47. package/dist/config/config.d.ts +0 -2
  48. package/dist/config/config.js +0 -1
  49. package/dist/config/constants/config.constants.js +2 -0
  50. package/dist/config/events-transport.d.ts +15 -0
  51. package/dist/config/events-transport.js +29 -0
  52. package/dist/config/index.d.ts +2 -1
  53. package/dist/config/index.js +1 -0
  54. package/dist/config/root-config.d.ts +12 -0
  55. package/dist/config/root-config.js +24 -0
  56. package/dist/config/schemas/config.schema.d.ts +13 -0
  57. package/dist/config/schemas/config.schema.js +42 -6
  58. package/dist/config/types/config.types.d.ts +7 -0
  59. package/dist/core/index.d.ts +1 -1
  60. package/dist/core/index.js +1 -1
  61. package/dist/core/version.d.ts +9 -0
  62. package/dist/core/version.js +14 -0
  63. package/dist/core/which.d.ts +11 -0
  64. package/dist/core/which.js +18 -0
  65. package/dist/credentials/cloud-claim.d.ts +32 -0
  66. package/dist/credentials/cloud-claim.js +42 -0
  67. package/dist/credentials/constants/credentials.constants.d.ts +8 -1
  68. package/dist/credentials/constants/credentials.constants.js +9 -2
  69. package/dist/credentials/device-api.d.ts +15 -1
  70. package/dist/credentials/device-api.js +12 -1
  71. package/dist/credentials/sign-in.d.ts +27 -0
  72. package/dist/credentials/sign-in.js +31 -1
  73. package/dist/credentials/token-refresher.d.ts +5 -1
  74. package/dist/credentials/token-refresher.js +10 -2
  75. package/dist/events/constants/events.constants.d.ts +8 -2
  76. package/dist/events/constants/events.constants.js +7 -1
  77. package/dist/events/index.d.ts +2 -0
  78. package/dist/events/product-event.d.ts +10 -4
  79. package/dist/events/types/events.types.d.ts +6 -0
  80. package/dist/events/types/replay-progress.types.d.ts +26 -0
  81. package/dist/events/types/replay-progress.types.js +1 -0
  82. package/dist/events/types/repo-snapshot.types.d.ts +1 -4
  83. package/dist/events/types/repo-tree.types.d.ts +25 -0
  84. package/dist/events/types/repo-tree.types.js +1 -0
  85. package/dist/feature/ticket-candidates.d.ts +1 -1
  86. package/dist/git/checkout-root.d.ts +15 -0
  87. package/dist/git/checkout-root.js +18 -0
  88. package/dist/git/code-state.d.ts +2 -16
  89. package/dist/git/code-state.js +11 -12
  90. package/dist/git/constants/git.constants.d.ts +31 -11
  91. package/dist/git/constants/git.constants.js +36 -12
  92. package/dist/git/constants/tree.constants.d.ts +71 -0
  93. package/dist/git/constants/tree.constants.js +92 -0
  94. package/dist/git/fingerprint.d.ts +3 -6
  95. package/dist/git/fingerprint.js +5 -8
  96. package/dist/git/git-context.d.ts +1 -0
  97. package/dist/git/git-context.js +8 -3
  98. package/dist/git/index.d.ts +1 -2
  99. package/dist/git/index.js +1 -1
  100. package/dist/git/repo-snapshot.d.ts +13 -4
  101. package/dist/git/repo-snapshot.js +47 -9
  102. package/dist/git/repo-tree.d.ts +69 -0
  103. package/dist/git/repo-tree.js +130 -0
  104. package/dist/git/types/git.types.d.ts +5 -2
  105. package/dist/git/types/snapshot.types.d.ts +14 -0
  106. package/dist/pipeline/constants/pipeline.constants.d.ts +3 -0
  107. package/dist/pipeline/constants/pipeline.constants.js +3 -0
  108. package/dist/pipeline/hook-pipeline.js +112 -72
  109. package/dist/privacy/product-capture.js +36 -5
  110. package/dist/providers/antigravity/antigravity.capture.d.ts +2 -0
  111. package/dist/providers/antigravity/antigravity.capture.js +5 -0
  112. package/dist/providers/antigravity/antigravity.detect.js +8 -22
  113. package/dist/providers/antigravity/antigravity.provider.js +10 -3
  114. package/dist/providers/antigravity/constants/antigravity.constants.d.ts +1 -0
  115. package/dist/providers/antigravity/constants/antigravity.constants.js +1 -0
  116. package/dist/providers/claude/claude.adapter.js +9 -6
  117. package/dist/providers/claude/claude.detect.js +2 -17
  118. package/dist/providers/claude/claude.otel.d.ts +21 -3
  119. package/dist/providers/claude/claude.otel.js +216 -61
  120. package/dist/providers/claude/claude.provider.js +17 -1
  121. package/dist/providers/claude/claude.version.d.ts +9 -0
  122. package/dist/providers/claude/claude.version.js +28 -0
  123. package/dist/providers/claude/constants/claude.constants.d.ts +27 -0
  124. package/dist/providers/claude/constants/claude.constants.js +27 -0
  125. package/dist/providers/claude/constants/claude.otel.constants.d.ts +27 -0
  126. package/dist/providers/claude/constants/claude.otel.constants.js +45 -5
  127. package/dist/providers/claude/types/claude.types.d.ts +13 -0
  128. package/dist/providers/codex/codex.capture.d.ts +76 -0
  129. package/dist/providers/codex/codex.capture.js +454 -0
  130. package/dist/providers/codex/codex.detect.js +2 -4
  131. package/dist/providers/codex/codex.otel.d.ts +38 -2
  132. package/dist/providers/codex/codex.otel.js +50 -6
  133. package/dist/providers/codex/codex.provider.js +8 -0
  134. package/dist/providers/codex/codex.surface.d.ts +9 -0
  135. package/dist/{turns/codex-originator.js → providers/codex/codex.surface.js} +17 -3
  136. package/dist/providers/codex/codex.titles.d.ts +14 -0
  137. package/dist/providers/codex/codex.titles.js +35 -0
  138. package/dist/providers/codex/constants/codex.constants.d.ts +4 -0
  139. package/dist/providers/codex/constants/codex.constants.js +4 -0
  140. package/dist/providers/cursor/constants/cursor.constants.d.ts +17 -4
  141. package/dist/providers/cursor/constants/cursor.constants.js +25 -5
  142. package/dist/providers/cursor/cursor-mcp-memo.d.ts +34 -0
  143. package/dist/providers/cursor/cursor-mcp-memo.js +94 -0
  144. package/dist/providers/cursor/cursor.adapter.js +20 -82
  145. package/dist/providers/cursor/cursor.capture.d.ts +1 -0
  146. package/dist/providers/cursor/cursor.capture.js +4 -0
  147. package/dist/providers/cursor/cursor.detect.d.ts +5 -1
  148. package/dist/providers/cursor/cursor.detect.js +11 -26
  149. package/dist/providers/cursor/cursor.hooks.js +2 -2
  150. package/dist/providers/cursor/cursor.provider.js +16 -7
  151. package/dist/providers/cursor/cursor.titles.d.ts +14 -0
  152. package/dist/providers/cursor/cursor.titles.js +20 -0
  153. package/dist/providers/cursor/schemas/cursor.schema.d.ts +3 -3
  154. package/dist/providers/cursor/schemas/cursor.schema.js +5 -3
  155. package/dist/providers/gemini/constants/gemini.constants.d.ts +16 -0
  156. package/dist/providers/gemini/constants/gemini.constants.js +17 -0
  157. package/dist/providers/gemini/gemini.capture.d.ts +81 -0
  158. package/dist/providers/gemini/gemini.capture.js +210 -0
  159. package/dist/providers/gemini/gemini.detect.js +57 -24
  160. package/dist/providers/gemini/gemini.otel.d.ts +38 -2
  161. package/dist/providers/gemini/gemini.otel.js +56 -125
  162. package/dist/providers/gemini/gemini.provider.js +5 -0
  163. package/dist/providers/index.d.ts +1 -0
  164. package/dist/providers/index.js +1 -0
  165. package/dist/providers/provider.d.ts +8 -0
  166. package/dist/providers/provider.js +9 -0
  167. package/dist/providers/registry.d.ts +14 -0
  168. package/dist/providers/registry.js +14 -0
  169. package/dist/providers/shared/constants/hook-config.constants.d.ts +2 -0
  170. package/dist/providers/shared/constants/hook-config.constants.js +2 -0
  171. package/dist/providers/shared/constants/terminal-capture.constants.d.ts +6 -0
  172. package/dist/providers/shared/constants/terminal-capture.constants.js +6 -0
  173. package/dist/providers/shared/editor-paths.d.ts +8 -0
  174. package/dist/providers/shared/editor-paths.js +18 -0
  175. package/dist/providers/shared/hook-config.d.ts +5 -0
  176. package/dist/providers/shared/hook-config.js +39 -1
  177. package/dist/providers/shared/hooks-marker.d.ts +14 -0
  178. package/dist/providers/shared/hooks-marker.js +23 -0
  179. package/dist/providers/shared/install-record.d.ts +29 -0
  180. package/dist/providers/shared/install-record.js +52 -0
  181. package/dist/providers/shared/session-title-store.d.ts +23 -0
  182. package/dist/providers/shared/session-title-store.js +50 -0
  183. package/dist/providers/shared/terminal-capture.d.ts +41 -0
  184. package/dist/providers/shared/terminal-capture.js +109 -0
  185. package/dist/providers/shared/tooling.d.ts +21 -0
  186. package/dist/providers/shared/tooling.js +36 -1
  187. package/dist/providers/types/provider.types.d.ts +57 -4
  188. package/dist/replay/checkout-resolver.d.ts +29 -0
  189. package/dist/replay/checkout-resolver.js +69 -0
  190. package/dist/replay/codex-turns.d.ts +24 -0
  191. package/dist/replay/codex-turns.js +221 -0
  192. package/dist/replay/constants/replay.constants.d.ts +99 -0
  193. package/dist/replay/constants/replay.constants.js +102 -0
  194. package/dist/replay/describe.d.ts +10 -0
  195. package/dist/replay/describe.js +31 -0
  196. package/dist/replay/gemini-turns.d.ts +36 -0
  197. package/dist/replay/gemini-turns.js +192 -0
  198. package/dist/replay/machine.d.ts +34 -0
  199. package/dist/replay/machine.js +68 -0
  200. package/dist/replay/progress-event.d.ts +21 -0
  201. package/dist/replay/progress-event.js +45 -0
  202. package/dist/replay/replay-runner.d.ts +58 -0
  203. package/dist/replay/replay-runner.js +529 -0
  204. package/dist/replay/replay-scan.d.ts +83 -0
  205. package/dist/replay/replay-scan.js +170 -0
  206. package/dist/replay/replay-state.d.ts +108 -0
  207. package/dist/replay/replay-state.js +199 -0
  208. package/dist/replay/resume.d.ts +18 -0
  209. package/dist/replay/resume.js +34 -0
  210. package/dist/replay/start.d.ts +23 -0
  211. package/dist/replay/start.js +39 -0
  212. package/dist/replay/throttle.d.ts +35 -0
  213. package/dist/replay/throttle.js +41 -0
  214. package/dist/replay/transcript-turns.d.ts +35 -0
  215. package/dist/replay/transcript-turns.js +215 -0
  216. package/dist/replay/turn-event.d.ts +38 -0
  217. package/dist/replay/turn-event.js +116 -0
  218. package/dist/replay/types/replay.types.d.ts +162 -0
  219. package/dist/replay/types/replay.types.js +1 -0
  220. package/dist/replay/window.d.ts +28 -0
  221. package/dist/replay/window.js +41 -0
  222. package/dist/snapshot/branch-selection.d.ts +40 -23
  223. package/dist/snapshot/branch-selection.js +74 -42
  224. package/dist/snapshot/budget.js +2 -2
  225. package/dist/snapshot/constants/snapshot-stages.constants.d.ts +10 -0
  226. package/dist/snapshot/constants/snapshot-stages.constants.js +10 -0
  227. package/dist/snapshot/constants/snapshot.constants.d.ts +37 -4
  228. package/dist/snapshot/constants/snapshot.constants.js +37 -4
  229. package/dist/snapshot/index.d.ts +6 -1
  230. package/dist/snapshot/index.js +3 -1
  231. package/dist/snapshot/snapshot-event.d.ts +7 -0
  232. package/dist/snapshot/snapshot-event.js +8 -5
  233. package/dist/snapshot/snapshot-pipeline.js +89 -26
  234. package/dist/snapshot/snapshot-state.js +24 -2
  235. package/dist/snapshot/tree-event.d.ts +14 -0
  236. package/dist/snapshot/tree-event.js +91 -0
  237. package/dist/snapshot/tree-pipeline.d.ts +12 -0
  238. package/dist/snapshot/tree-pipeline.js +172 -0
  239. package/dist/snapshot/types/snapshot.types.d.ts +62 -2
  240. package/dist/storage/schemas/storage.schema.d.ts +2 -0
  241. package/dist/storage/schemas/storage.schema.js +6 -0
  242. package/dist/transport/constants/transport.constants.d.ts +5 -0
  243. package/dist/transport/constants/transport.constants.js +5 -0
  244. package/dist/transport/delivery-stats.d.ts +13 -1
  245. package/dist/transport/delivery-stats.js +18 -2
  246. package/dist/transport/delivery.d.ts +4 -3
  247. package/dist/transport/delivery.js +21 -7
  248. package/dist/transport/identity-delivery.d.ts +20 -0
  249. package/dist/transport/identity-delivery.js +41 -0
  250. package/dist/transport/index.d.ts +2 -0
  251. package/dist/transport/index.js +1 -0
  252. package/dist/transport/queue.js +40 -6
  253. package/dist/transport/types/delivery-flow.types.d.ts +7 -0
  254. package/dist/turns/claude-transcript.js +4 -12
  255. package/dist/turns/codex-transcript.d.ts +9 -0
  256. package/dist/turns/codex-transcript.js +27 -19
  257. package/dist/turns/constants/turns.constants.d.ts +13 -12
  258. package/dist/turns/constants/turns.constants.js +15 -19
  259. package/dist/turns/gemini-transcript.d.ts +19 -1
  260. package/dist/turns/gemini-transcript.js +29 -18
  261. package/dist/turns/index.d.ts +3 -4
  262. package/dist/turns/index.js +2 -3
  263. package/dist/turns/run-state.d.ts +71 -0
  264. package/dist/turns/run-state.js +114 -0
  265. package/dist/turns/tool-events.d.ts +11 -1
  266. package/dist/turns/tool-events.js +32 -9
  267. package/dist/turns/transcript.d.ts +15 -14
  268. package/dist/turns/transcript.js +23 -4
  269. package/dist/turns/turn-state.d.ts +49 -7
  270. package/dist/turns/turn-state.js +78 -10
  271. package/dist/turns/turn-summary.js +10 -6
  272. package/dist/turns/turn-tracker.d.ts +9 -16
  273. package/dist/turns/turn-tracker.js +162 -86
  274. package/dist/turns/types/transcript.types.d.ts +11 -1
  275. package/dist/turns/types/turn-provider.types.d.ts +33 -0
  276. package/dist/turns/types/turn-provider.types.js +1 -0
  277. package/dist/turns/types/turn-state.types.d.ts +9 -0
  278. package/dist/turns/types/turn-summary.types.d.ts +20 -6
  279. package/dist/turns/types/turn-tracker.types.d.ts +3 -1
  280. package/dist/turns/work-checkout.js +1 -2
  281. package/docs/AUDIT_PROMPT.md +10 -0
  282. package/docs/DATA_HANDLING.md +269 -32
  283. package/docs/ENTERPRISE_DEPLOYMENT.md +1 -1
  284. package/docs/PERFORMANCE.md +27 -0
  285. package/package.json +3 -2
  286. package/dist/events/canonical-event.d.ts +0 -10
  287. package/dist/events/canonical-event.js +0 -9
  288. package/dist/git/repository-root.d.ts +0 -39
  289. package/dist/git/repository-root.js +0 -131
  290. package/dist/git/types/repository-root.types.d.ts +0 -11
  291. package/dist/transport/transport.d.ts +0 -6
  292. package/dist/turns/codex-originator.d.ts +0 -11
  293. package/dist/turns/cursor-transcript.d.ts +0 -21
  294. package/dist/turns/cursor-transcript.js +0 -66
  295. package/dist/turns/native-session-titles.d.ts +0 -26
  296. package/dist/turns/native-session-titles.js +0 -102
  297. /package/dist/{git/types/repository-root.types.js → billing/types/billing.types.js} +0 -0
  298. /package/dist/{transport/transport.js → capture/types/capture.types.js} +0 -0
@@ -0,0 +1,170 @@
1
+ import fs from 'node:fs';
2
+ import fsp from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import readline from 'node:readline';
5
+ import { sleep } from '../core/async.js';
6
+ import { CLAUDE_PROVIDER_ID } from '../providers/claude/constants/claude.constants.js';
7
+ import { CLAUDE_PROJECTS_SEGMENTS } from './constants/replay.constants.js';
8
+ import { readTranscriptTurns } from './transcript-turns.js';
9
+ /** The pause after each hundred project folders, so a thousand of them are not one burst of disk reads. */
10
+ const FOLDER_BURST = 100;
11
+ const FOLDER_PAUSE_MS = 20;
12
+ const TRANSCRIPT_SUFFIX = '.jsonl';
13
+ /** The leading fields of a prompt line a person typed, before its message: no braces, so no nesting to scan. */
14
+ const RE_TYPED_PROMPT = /^\{[^{}]{0,400}"isSidechain":false[^{}]{0,400}"type":"user","message":\{"role":"user","content":"(?!<command-|<local-command|\[Request interrupted)/;
15
+ const TIMESTAMP_KEY = '"timestamp":"';
16
+ /**
17
+ * Files and built turns per agent, for the dry run.
18
+ *
19
+ * @param files - The files the run read.
20
+ * @param entries - The record's file map that lists them.
21
+ * @param builtBy - Turns built per agent.
22
+ * @returns The counts.
23
+ */
24
+ export function countsByAgent(files, entries, builtBy) {
25
+ const counts = {};
26
+ for (const file of files) {
27
+ const agent = entries[file]?.agent ?? CLAUDE_PROVIDER_ID;
28
+ counts[agent] = { files: (counts[agent]?.files ?? 0) + 1, turns: builtBy.get(agent) ?? 0 };
29
+ }
30
+ return counts;
31
+ }
32
+ /**
33
+ * Where Claude Code keeps its transcripts.
34
+ *
35
+ * @param home - The developer's home.
36
+ * @returns `~/.claude/projects`.
37
+ */
38
+ export function claudeProjectsDir(home) {
39
+ return path.join(home, ...CLAUDE_PROJECTS_SEGMENTS);
40
+ }
41
+ /**
42
+ * Claude Code's transcripts as a replay source.
43
+ *
44
+ * @param projectsDir - `~/.claude/projects`.
45
+ * @returns The source.
46
+ */
47
+ export function claudeSource(projectsDir) {
48
+ return {
49
+ agent: CLAUDE_PROVIDER_ID,
50
+ list: (sinceMs) => listTranscripts(projectsDir, sinceMs),
51
+ estimate: (file, sinceMs) => estimateTurns(file, sinceMs),
52
+ read: readTranscriptTurns
53
+ };
54
+ }
55
+ /**
56
+ * Every source's files, newest first, each tagged with its source.
57
+ *
58
+ * @param sources - The agents to list.
59
+ * @param sinceMs - The window's start.
60
+ * @returns The files.
61
+ */
62
+ export async function listSources(sources, sinceMs) {
63
+ const found = [];
64
+ for (const source of sources)
65
+ for (const file of await source.list(sinceMs))
66
+ found.push({ ...file, agent: source.agent });
67
+ return found.sort((a, b) => b.mtimeMs - a.mtimeMs);
68
+ }
69
+ /**
70
+ * The source a counted file belongs to. A file counted before Codex and Gemini replay carries no agent: it is Claude Code's.
71
+ *
72
+ * @param sources - The run's sources.
73
+ * @param entry - The file's entry in the record.
74
+ * @returns The source, or undefined when this run has no source for it.
75
+ */
76
+ export function sourceOf(sources, entry) {
77
+ const agent = entry?.agent ?? CLAUDE_PROVIDER_ID;
78
+ return sources.find((source) => source.agent === agent);
79
+ }
80
+ /**
81
+ * The transcripts that may hold a turn from the window, newest first.
82
+ *
83
+ * A file last written before the window began cannot hold a turn inside it, so
84
+ * one `stat` rules it out without opening it. Only `<project>/<session>.jsonl`
85
+ * is listed: the sub-agent files below a session are counted in their parent's
86
+ * turn, as live hooks count them.
87
+ *
88
+ * @param projectsDir - `~/.claude/projects`.
89
+ * @param sinceMs - The window's start.
90
+ * @returns The files, most recently written first; empty when Claude Code has left none.
91
+ */
92
+ export async function listTranscripts(projectsDir, sinceMs) {
93
+ const folders = await fsp.readdir(projectsDir, { withFileTypes: true }).catch(() => []);
94
+ const found = [];
95
+ let seen = 0;
96
+ for (const folder of folders) {
97
+ if (!folder.isDirectory())
98
+ continue;
99
+ seen += 1;
100
+ if (seen % FOLDER_BURST === 0)
101
+ await sleep(FOLDER_PAUSE_MS);
102
+ found.push(...(await recentFiles(path.join(projectsDir, folder.name), sinceMs)));
103
+ }
104
+ return found.sort((a, b) => b.mtimeMs - a.mtimeMs);
105
+ }
106
+ /**
107
+ * The `.jsonl` files directly in a folder last written inside the window: one `stat` each, no open.
108
+ *
109
+ * @param dir - The folder.
110
+ * @param sinceMs - The window's start.
111
+ * @param prefix - A name prefix the files must carry, if any.
112
+ * @returns The files; empty when the folder is missing.
113
+ */
114
+ export async function recentFiles(dir, sinceMs, prefix = '') {
115
+ const names = await fsp.readdir(dir).catch(() => []);
116
+ const found = [];
117
+ for (const name of names) {
118
+ if (!name.startsWith(prefix) || !name.endsWith(TRANSCRIPT_SUFFIX))
119
+ continue;
120
+ const file = path.join(dir, name);
121
+ const stat = await fsp.stat(file).catch(() => undefined);
122
+ if (stat?.isFile() && stat.mtimeMs >= sinceMs)
123
+ found.push({ file, mtimeMs: stat.mtimeMs, size: stat.size });
124
+ }
125
+ return found;
126
+ }
127
+ /**
128
+ * About how many prompts a file holds from the window, without parsing it.
129
+ *
130
+ * Reads the file as text and tests each line against a pattern: no JSON is
131
+ * decoded, which is what makes the count pass cheap. It is an estimate for the
132
+ * progress bar (it counts a prompt that got no answer, which is never sent);
133
+ * the sent total replaces it when the replay ends.
134
+ *
135
+ * @param file - A transcript file.
136
+ * @param sinceMs - The window's start.
137
+ * @param opensTurn - What a line that opens a turn looks like; Claude Code's typed prompt by default.
138
+ * @returns The estimate.
139
+ */
140
+ export async function estimateTurns(file, sinceMs, opensTurn = RE_TYPED_PROMPT) {
141
+ const lines = readline.createInterface({ input: fs.createReadStream(file, { encoding: 'utf8' }), crlfDelay: Infinity });
142
+ let turns = 0;
143
+ try {
144
+ for await (const line of lines) {
145
+ if (!opensTurn.test(line) || timestampOf(line) < sinceMs)
146
+ continue;
147
+ turns += 1;
148
+ }
149
+ }
150
+ catch {
151
+ return turns;
152
+ }
153
+ finally {
154
+ lines.close();
155
+ }
156
+ return turns;
157
+ }
158
+ /**
159
+ * The time a transcript line carries, read off its last `timestamp` key.
160
+ *
161
+ * @param line - The verbatim line.
162
+ * @returns Epoch ms; 0 when the line has none, so it counts as outside the window.
163
+ */
164
+ function timestampOf(line) {
165
+ const at = line.lastIndexOf(TIMESTAMP_KEY);
166
+ if (at < 0)
167
+ return 0;
168
+ const from = at + TIMESTAMP_KEY.length;
169
+ return Date.parse(line.slice(from, line.indexOf('"', from))) || 0;
170
+ }
@@ -0,0 +1,108 @@
1
+ import type { ReplayRecord } from './types/replay.types.js';
2
+ /**
3
+ * Where an identity's replay state lives: beside its stats and credential files.
4
+ *
5
+ * @param statsFile - The identity's stats file, which names its state directory.
6
+ * @returns The replay state file.
7
+ */
8
+ export declare function replayStateFile(statsFile: string): string;
9
+ /**
10
+ * A replay's persisted state, when there is one that parses.
11
+ *
12
+ * @param file - The replay state file.
13
+ * @returns The record, or undefined when nothing was ever written or it is unreadable.
14
+ */
15
+ export declare function readReplayRecord(file: string): Promise<ReplayRecord | undefined>;
16
+ /**
17
+ * Persist the record, atomically, so a crash leaves the last whole one.
18
+ *
19
+ * @param file - The replay state file.
20
+ * @param record - The state.
21
+ */
22
+ export declare function writeReplayRecord(file: string, record: ReplayRecord): Promise<void>;
23
+ /**
24
+ * Claim setup's one automatic replay for this machine.
25
+ *
26
+ * The marker is credential-independent: signing in again must not resend the
27
+ * same local history. Existing per-identity state from older Edge versions is
28
+ * adopted as an earlier attempt before the marker is claimed atomically.
29
+ *
30
+ * @param configDir - Durable machine configuration directory.
31
+ * @param dataDir - Machine state directory containing identity partitions.
32
+ * @returns True only for the caller that may start the automatic replay.
33
+ */
34
+ export declare function claimAutomaticReplay(configDir: string, dataDir: string): Promise<boolean>;
35
+ /**
36
+ * Whether setup's automatic replay has already been attempted on this machine.
37
+ *
38
+ * Per-identity records predate the machine marker. Finding one adopts it by
39
+ * writing the marker, so a credential change cannot make old installs repeat.
40
+ *
41
+ * @param configDir - Durable machine configuration directory.
42
+ * @param dataDir - Machine state directory containing identity partitions.
43
+ * @returns True when setup must not launch another automatic replay.
44
+ */
45
+ export declare function automaticReplayAttempted(configDir: string, dataDir: string): Promise<boolean>;
46
+ /**
47
+ * Whether a process is working on this replay right now.
48
+ *
49
+ * The heartbeat is what counts: a pid can be reused, and a lock file is broken
50
+ * after 30 s while a run lasts minutes. A live heartbeat from a process that
51
+ * answers signal 0 is a run; anything else is a run that died.
52
+ *
53
+ * @param record - The persisted state.
54
+ * @param nowMs - The clock.
55
+ * @param alive - Whether a pid exists; injectable for tests.
56
+ * @returns True when a run holds it.
57
+ */
58
+ export declare function isRunning(record: ReplayRecord, nowMs: number, alive?: (pid: number) => boolean): boolean;
59
+ /** What a replay was asked to do, as {@link decideStart} reads it. */
60
+ export interface StartRequest {
61
+ /** Fingerprint of the identity this run sends as. */
62
+ readonly identity: string;
63
+ /** `replay --resume`: continue an unfinished one, never begin one. */
64
+ readonly resume: boolean;
65
+ /** Setup's start: never repeat an earlier replay attempt for this identity. */
66
+ readonly skipIfExisting: boolean;
67
+ readonly nowMs: number;
68
+ }
69
+ /** What to do about the replay already on disk, if any. */
70
+ export type StartDecision = {
71
+ readonly action: 'skip';
72
+ readonly message: string;
73
+ } | {
74
+ readonly action: 'continue';
75
+ readonly record: ReplayRecord;
76
+ } | {
77
+ readonly action: 'fresh';
78
+ };
79
+ /**
80
+ * Whether a run begins a replay, continues one or leaves it.
81
+ *
82
+ * Pure so every combination is a test: a second `setup`, a hook that finds an
83
+ * unfinished replay, `--resume` after `--stop`, a different identity.
84
+ *
85
+ * @param existing - The persisted state, if any.
86
+ * @param request - What was asked.
87
+ * @param alive - Whether a pid exists; injectable for tests.
88
+ * @returns The decision.
89
+ */
90
+ export declare function decideStart(existing: ReplayRecord | undefined, request: StartRequest, alive?: (pid: number) => boolean): StartDecision;
91
+ /**
92
+ * The marker that says a replay is unfinished.
93
+ *
94
+ * Beside the state file, and empty: the hook asks "is anything owed?" with one
95
+ * `stat` of this, where reading the state file (a map of every transcript) on
96
+ * every hook would cost real time.
97
+ *
98
+ * @param stateFile - The replay state file.
99
+ * @returns The marker's path.
100
+ */
101
+ export declare function pendingMarker(stateFile: string): string;
102
+ /**
103
+ * Create the marker, or remove it.
104
+ *
105
+ * @param stateFile - The replay state file.
106
+ * @param pending - Whether a replay is unfinished.
107
+ */
108
+ export declare function setPending(stateFile: string, pending: boolean): Promise<void>;
@@ -0,0 +1,199 @@
1
+ import fs from 'node:fs/promises';
2
+ import path from 'node:path';
3
+ import { SECRET_FILE_MODE } from '../storage/constants/storage.constants.js';
4
+ import { writeFileAtomic } from '../storage/atomic-file.js';
5
+ import { readJsonFile } from '../storage/json-file.js';
6
+ import { IDENTITY_STATE_DIR_NAME } from '../transport/constants/transport.constants.js';
7
+ import { REPLAY_ATTEMPTED_FILE_NAME, REPLAY_HEARTBEAT_STALE_MS, REPLAY_PENDING_FILE_NAME, REPLAY_STATE_FILE_NAME } from './constants/replay.constants.js';
8
+ /**
9
+ * Where an identity's replay state lives: beside its stats and credential files.
10
+ *
11
+ * @param statsFile - The identity's stats file, which names its state directory.
12
+ * @returns The replay state file.
13
+ */
14
+ export function replayStateFile(statsFile) {
15
+ return path.join(path.dirname(statsFile), REPLAY_STATE_FILE_NAME);
16
+ }
17
+ /**
18
+ * A replay's persisted state, when there is one that parses.
19
+ *
20
+ * @param file - The replay state file.
21
+ * @returns The record, or undefined when nothing was ever written or it is unreadable.
22
+ */
23
+ export async function readReplayRecord(file) {
24
+ const read = await readJsonFile(file);
25
+ if (read.state !== 'ok')
26
+ return undefined;
27
+ const record = read.value;
28
+ if (!record || typeof record.replayId !== 'string' || typeof record.state !== 'string' || typeof record.files !== 'object')
29
+ return undefined;
30
+ return record;
31
+ }
32
+ /**
33
+ * Persist the record, atomically, so a crash leaves the last whole one.
34
+ *
35
+ * @param file - The replay state file.
36
+ * @param record - The state.
37
+ */
38
+ export async function writeReplayRecord(file, record) {
39
+ await writeFileAtomic(file, `${JSON.stringify(record)}\n`, SECRET_FILE_MODE);
40
+ }
41
+ /**
42
+ * Claim setup's one automatic replay for this machine.
43
+ *
44
+ * The marker is credential-independent: signing in again must not resend the
45
+ * same local history. Existing per-identity state from older Edge versions is
46
+ * adopted as an earlier attempt before the marker is claimed atomically.
47
+ *
48
+ * @param configDir - Durable machine configuration directory.
49
+ * @param dataDir - Machine state directory containing identity partitions.
50
+ * @returns True only for the caller that may start the automatic replay.
51
+ */
52
+ export async function claimAutomaticReplay(configDir, dataDir) {
53
+ if (await automaticReplayAttempted(configDir, dataDir))
54
+ return false;
55
+ const marker = path.join(configDir, REPLAY_ATTEMPTED_FILE_NAME);
56
+ return createClaim(marker);
57
+ }
58
+ /**
59
+ * Whether setup's automatic replay has already been attempted on this machine.
60
+ *
61
+ * Per-identity records predate the machine marker. Finding one adopts it by
62
+ * writing the marker, so a credential change cannot make old installs repeat.
63
+ *
64
+ * @param configDir - Durable machine configuration directory.
65
+ * @param dataDir - Machine state directory containing identity partitions.
66
+ * @returns True when setup must not launch another automatic replay.
67
+ */
68
+ export async function automaticReplayAttempted(configDir, dataDir) {
69
+ const marker = path.join(configDir, REPLAY_ATTEMPTED_FILE_NAME);
70
+ if (await hasFile(marker))
71
+ return true;
72
+ if (await hasReplayRecord(dataDir)) {
73
+ await createClaim(marker);
74
+ return true;
75
+ }
76
+ return false;
77
+ }
78
+ async function hasReplayRecord(dataDir) {
79
+ const root = path.join(dataDir, IDENTITY_STATE_DIR_NAME);
80
+ let entries;
81
+ try {
82
+ entries = await fs.readdir(root, { withFileTypes: true });
83
+ }
84
+ catch (error) {
85
+ if (error.code === 'ENOENT')
86
+ return false;
87
+ throw error;
88
+ }
89
+ for (const entry of entries) {
90
+ if (!entry.isDirectory())
91
+ continue;
92
+ if (await readReplayRecord(path.join(root, entry.name, REPLAY_STATE_FILE_NAME)))
93
+ return true;
94
+ }
95
+ return false;
96
+ }
97
+ async function createClaim(marker) {
98
+ await fs.mkdir(path.dirname(marker), { recursive: true });
99
+ try {
100
+ await fs.writeFile(marker, '', { flag: 'wx', mode: SECRET_FILE_MODE });
101
+ return true;
102
+ }
103
+ catch (error) {
104
+ if (error.code === 'EEXIST')
105
+ return false;
106
+ throw error;
107
+ }
108
+ }
109
+ async function hasFile(file) {
110
+ try {
111
+ await fs.stat(file);
112
+ return true;
113
+ }
114
+ catch (error) {
115
+ if (error.code === 'ENOENT')
116
+ return false;
117
+ throw error;
118
+ }
119
+ }
120
+ /**
121
+ * Whether a process is working on this replay right now.
122
+ *
123
+ * The heartbeat is what counts: a pid can be reused, and a lock file is broken
124
+ * after 30 s while a run lasts minutes. A live heartbeat from a process that
125
+ * answers signal 0 is a run; anything else is a run that died.
126
+ *
127
+ * @param record - The persisted state.
128
+ * @param nowMs - The clock.
129
+ * @param alive - Whether a pid exists; injectable for tests.
130
+ * @returns True when a run holds it.
131
+ */
132
+ export function isRunning(record, nowMs, alive = pidExists) {
133
+ if (record.pid === undefined || record.heartbeatAt === undefined)
134
+ return false;
135
+ if (nowMs - Date.parse(record.heartbeatAt) > REPLAY_HEARTBEAT_STALE_MS)
136
+ return false;
137
+ return alive(record.pid);
138
+ }
139
+ function pidExists(pid) {
140
+ try {
141
+ process.kill(pid, 0);
142
+ return true;
143
+ }
144
+ catch (error) {
145
+ return error.code === 'EPERM';
146
+ }
147
+ }
148
+ /**
149
+ * Whether a run begins a replay, continues one or leaves it.
150
+ *
151
+ * Pure so every combination is a test: a second `setup`, a hook that finds an
152
+ * unfinished replay, `--resume` after `--stop`, a different identity.
153
+ *
154
+ * @param existing - The persisted state, if any.
155
+ * @param request - What was asked.
156
+ * @param alive - Whether a pid exists; injectable for tests.
157
+ * @returns The decision.
158
+ */
159
+ export function decideStart(existing, request, alive) {
160
+ if (existing && isRunning(existing, request.nowMs, alive))
161
+ return { action: 'skip', message: 'a replay is already running' };
162
+ const mine = existing?.identity === request.identity ? existing : undefined;
163
+ if (request.resume) {
164
+ if (!mine || mine.state === 'done')
165
+ return { action: 'skip', message: 'no unfinished replay to resume' };
166
+ return { action: 'continue', record: mine };
167
+ }
168
+ if (request.skipIfExisting && mine)
169
+ return { action: 'skip', message: 'setup already attempted a replay for this identity' };
170
+ return { action: 'fresh' };
171
+ }
172
+ /**
173
+ * The marker that says a replay is unfinished.
174
+ *
175
+ * Beside the state file, and empty: the hook asks "is anything owed?" with one
176
+ * `stat` of this, where reading the state file (a map of every transcript) on
177
+ * every hook would cost real time.
178
+ *
179
+ * @param stateFile - The replay state file.
180
+ * @returns The marker's path.
181
+ */
182
+ export function pendingMarker(stateFile) {
183
+ return path.join(path.dirname(stateFile), REPLAY_PENDING_FILE_NAME);
184
+ }
185
+ /**
186
+ * Create the marker, or remove it.
187
+ *
188
+ * @param stateFile - The replay state file.
189
+ * @param pending - Whether a replay is unfinished.
190
+ */
191
+ export async function setPending(stateFile, pending) {
192
+ const marker = pendingMarker(stateFile);
193
+ if (!pending) {
194
+ await fs.rm(marker, { force: true });
195
+ return;
196
+ }
197
+ await fs.mkdir(path.dirname(marker), { recursive: true });
198
+ await fs.writeFile(marker, '', { flag: 'a', mode: SECRET_FILE_MODE });
199
+ }
@@ -0,0 +1,18 @@
1
+ import type { Env } from '../core/types/core.types.js';
2
+ import type { AgentWatchPaths } from '../storage/types/storage.types.js';
3
+ /**
4
+ * Pick an unfinished replay up again, from the hook that opens a session.
5
+ *
6
+ * The common case is one `stat` of a marker that does not exist. When it does,
7
+ * its mtime is the last time anyone looked: only after five minutes is the
8
+ * state read, and the marker touched first so the next sessions skip it.
9
+ * A replay that is running (a live heartbeat) is left alone; one that paused
10
+ * for its budget, died with the laptop's lid, or was never finished is started
11
+ * again with `--resume`. A stopped one has no marker.
12
+ *
13
+ * @param env - Ambient environment.
14
+ * @param paths - Where the edge keeps its state.
15
+ * @param token - The identity's install key or `device:<id>`.
16
+ * @param root - The configured root identity, or none for the machine identity.
17
+ */
18
+ export declare function resumeReplayIfOwed(env: Env, paths: AgentWatchPaths, token: string | undefined, root?: string): Promise<void>;
@@ -0,0 +1,34 @@
1
+ import fs from 'node:fs/promises';
2
+ import { identityPaths } from '../transport/queue-partition.js';
3
+ import { REPLAY_RESUME_INTERVAL_MS } from './constants/replay.constants.js';
4
+ import { isRunning, pendingMarker, readReplayRecord, replayStateFile } from './replay-state.js';
5
+ import { startReplayDetached } from './start.js';
6
+ /**
7
+ * Pick an unfinished replay up again, from the hook that opens a session.
8
+ *
9
+ * The common case is one `stat` of a marker that does not exist. When it does,
10
+ * its mtime is the last time anyone looked: only after five minutes is the
11
+ * state read, and the marker touched first so the next sessions skip it.
12
+ * A replay that is running (a live heartbeat) is left alone; one that paused
13
+ * for its budget, died with the laptop's lid, or was never finished is started
14
+ * again with `--resume`. A stopped one has no marker.
15
+ *
16
+ * @param env - Ambient environment.
17
+ * @param paths - Where the edge keeps its state.
18
+ * @param token - The identity's install key or `device:<id>`.
19
+ * @param root - The configured root identity, or none for the machine identity.
20
+ */
21
+ export async function resumeReplayIfOwed(env, paths, token, root) {
22
+ const stateFile = replayStateFile(identityPaths(paths, token).statsFile);
23
+ const marker = pendingMarker(stateFile);
24
+ const stat = await fs.stat(marker).catch(() => undefined);
25
+ const now = env.now();
26
+ if (!stat || now.getTime() - stat.mtimeMs < REPLAY_RESUME_INTERVAL_MS)
27
+ return;
28
+ await fs.utimes(marker, now, now);
29
+ const record = await readReplayRecord(stateFile);
30
+ if (!record || record.state === 'done' || record.state === 'stopped' || isRunning(record, now.getTime()))
31
+ return;
32
+ const selector = root === undefined ? ['--machine'] : ['--root', root];
33
+ startReplayDetached(env, ['replay', ...selector, '--resume'], root ?? env.home);
34
+ }
@@ -0,0 +1,23 @@
1
+ import type { Env } from '../core/types/core.types.js';
2
+ /**
3
+ * Start `agentwatch replay …` as a process of its own, detached from the caller.
4
+ *
5
+ * Setup must not wait for a replay and a hook must not carry one, so the replay
6
+ * outlives both. Only from the built CLI: run from source there is nothing to
7
+ * start. A spawn that fails emits 'error'; unheard, it would crash the caller.
8
+ *
9
+ * @param env - Its `startDetached` when injected (tests); otherwise the built CLI is spawned.
10
+ * @param args - The arguments after `agentwatch`.
11
+ * @param cwd - Where to run: the replay picks its identity from it, as a hook does.
12
+ */
13
+ export declare function startReplayDetached(env: Env, args: readonly string[], cwd: string): void;
14
+ /**
15
+ * Run this `agentwatch replay` again under {@link REPLAY_NODE_FLAGS}, when it was not started with them.
16
+ *
17
+ * The flags cannot be set from inside a running Node, and a replay started by
18
+ * hand should weigh what one started by setup does.
19
+ *
20
+ * @param argv - The arguments after `agentwatch`.
21
+ * @returns The child's exit code, or undefined when this process already has the flags (or there is no built CLI to run).
22
+ */
23
+ export declare function runWithSmallHeap(argv: readonly string[]): number | undefined;
@@ -0,0 +1,39 @@
1
+ import { spawn, spawnSync } from 'node:child_process';
2
+ import fs from 'node:fs';
3
+ import process from 'node:process';
4
+ import { fileURLToPath } from 'node:url';
5
+ import { REPLAY_NODE_FLAGS } from './constants/replay.constants.js';
6
+ /**
7
+ * Start `agentwatch replay …` as a process of its own, detached from the caller.
8
+ *
9
+ * Setup must not wait for a replay and a hook must not carry one, so the replay
10
+ * outlives both. Only from the built CLI: run from source there is nothing to
11
+ * start. A spawn that fails emits 'error'; unheard, it would crash the caller.
12
+ *
13
+ * @param env - Its `startDetached` when injected (tests); otherwise the built CLI is spawned.
14
+ * @param args - The arguments after `agentwatch`.
15
+ * @param cwd - Where to run: the replay picks its identity from it, as a hook does.
16
+ */
17
+ export function startReplayDetached(env, args, cwd) {
18
+ if (env.startDetached)
19
+ return env.startDetached(args);
20
+ const cli = fileURLToPath(new URL('../cli.js', import.meta.url));
21
+ if (!fs.existsSync(cli))
22
+ return;
23
+ spawn(process.execPath, [...REPLAY_NODE_FLAGS, cli, ...args], { cwd, detached: true, stdio: 'ignore', windowsHide: true }).on('error', () => undefined).unref();
24
+ }
25
+ /**
26
+ * Run this `agentwatch replay` again under {@link REPLAY_NODE_FLAGS}, when it was not started with them.
27
+ *
28
+ * The flags cannot be set from inside a running Node, and a replay started by
29
+ * hand should weigh what one started by setup does.
30
+ *
31
+ * @param argv - The arguments after `agentwatch`.
32
+ * @returns The child's exit code, or undefined when this process already has the flags (or there is no built CLI to run).
33
+ */
34
+ export function runWithSmallHeap(argv) {
35
+ const cli = fileURLToPath(new URL('../cli.js', import.meta.url));
36
+ if (REPLAY_NODE_FLAGS.every((flag) => process.execArgv.includes(flag)) || !fs.existsSync(cli))
37
+ return undefined;
38
+ return spawnSync(process.execPath, [...REPLAY_NODE_FLAGS, cli, ...argv], { stdio: 'inherit' }).status ?? 1;
39
+ }
@@ -0,0 +1,35 @@
1
+ import type { MachineLoad, ReplayPause } from './types/replay.types.js';
2
+ /** Whether replay may send now, and if not why and for how long. */
3
+ export type ThrottleVerdict = {
4
+ readonly go: true;
5
+ } | {
6
+ readonly go: false;
7
+ readonly pause: ReplayPause;
8
+ readonly waitMs: number;
9
+ };
10
+ /**
11
+ * Whether the machine can spare a batch right now.
12
+ *
13
+ * Checked before every batch, cheapest reason first. An agent closing a turn
14
+ * means a person is working: replay waits for the hook's quiet, not for the
15
+ * load to show it. Load and battery are the two things a laptop owner feels.
16
+ *
17
+ * @param machine - What the machine says about itself.
18
+ * @returns Go, or the reason and the wait.
19
+ */
20
+ export declare function throttleVerdict(machine: MachineLoad): ThrottleVerdict;
21
+ /**
22
+ * How long to wait after another failed request: 10 s, doubling, never over 5 minutes.
23
+ *
24
+ * @param previousMs - The wait that just failed, or undefined for the first failure.
25
+ * @returns The next wait.
26
+ */
27
+ export declare function nextBackoff(previousMs: number | undefined): number;
28
+ /**
29
+ * Whether a response is one to wait out rather than to give up on.
30
+ *
31
+ * @param status - The HTTP status, absent for a network failure.
32
+ * @param retryable - What the transport judged.
33
+ * @returns True for 429, 5xx, a timeout or a network error.
34
+ */
35
+ export declare function isWorthWaiting(status: number | undefined, retryable: boolean): boolean;
@@ -0,0 +1,41 @@
1
+ import { REPLAY_BASE_BACKOFF_MS, REPLAY_BUSY_LOAD_PER_CORE, REPLAY_BUSY_PAUSE_MS, REPLAY_HOOK_QUIET_MS, REPLAY_MAX_BACKOFF_MS } from './constants/replay.constants.js';
2
+ /**
3
+ * Whether the machine can spare a batch right now.
4
+ *
5
+ * Checked before every batch, cheapest reason first. An agent closing a turn
6
+ * means a person is working: replay waits for the hook's quiet, not for the
7
+ * load to show it. Load and battery are the two things a laptop owner feels.
8
+ *
9
+ * @param machine - What the machine says about itself.
10
+ * @returns Go, or the reason and the wait.
11
+ */
12
+ export function throttleVerdict(machine) {
13
+ if (machine.hookAgeMs < REPLAY_HOOK_QUIET_MS)
14
+ return { go: false, pause: 'agent-active', waitMs: REPLAY_HOOK_QUIET_MS - machine.hookAgeMs };
15
+ if (machine.onBattery)
16
+ return { go: false, pause: 'battery', waitMs: REPLAY_BUSY_PAUSE_MS };
17
+ if (machine.load1 > machine.cores * REPLAY_BUSY_LOAD_PER_CORE)
18
+ return { go: false, pause: 'busy', waitMs: REPLAY_BUSY_PAUSE_MS };
19
+ return { go: true };
20
+ }
21
+ /**
22
+ * How long to wait after another failed request: 10 s, doubling, never over 5 minutes.
23
+ *
24
+ * @param previousMs - The wait that just failed, or undefined for the first failure.
25
+ * @returns The next wait.
26
+ */
27
+ export function nextBackoff(previousMs) {
28
+ if (previousMs === undefined)
29
+ return REPLAY_BASE_BACKOFF_MS;
30
+ return Math.min(previousMs * 2, REPLAY_MAX_BACKOFF_MS);
31
+ }
32
+ /**
33
+ * Whether a response is one to wait out rather than to give up on.
34
+ *
35
+ * @param status - The HTTP status, absent for a network failure.
36
+ * @param retryable - What the transport judged.
37
+ * @returns True for 429, 5xx, a timeout or a network error.
38
+ */
39
+ export function isWorthWaiting(status, retryable) {
40
+ return retryable || status === undefined || status === 429 || status >= 500;
41
+ }