@herdctl/core 0.0.1 → 0.1.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 (284) hide show
  1. package/dist/config/__tests__/agent.test.js +61 -13
  2. package/dist/config/__tests__/agent.test.js.map +1 -1
  3. package/dist/config/__tests__/merge.test.js +10 -3
  4. package/dist/config/__tests__/merge.test.js.map +1 -1
  5. package/dist/config/__tests__/schema.test.js +350 -1
  6. package/dist/config/__tests__/schema.test.js.map +1 -1
  7. package/dist/config/index.d.ts +1 -1
  8. package/dist/config/index.d.ts.map +1 -1
  9. package/dist/config/index.js +3 -1
  10. package/dist/config/index.js.map +1 -1
  11. package/dist/config/schema.d.ts +841 -27
  12. package/dist/config/schema.d.ts.map +1 -1
  13. package/dist/config/schema.js +129 -10
  14. package/dist/config/schema.js.map +1 -1
  15. package/dist/fleet-manager/__tests__/coverage.test.js +14 -331
  16. package/dist/fleet-manager/__tests__/coverage.test.js.map +1 -1
  17. package/dist/fleet-manager/__tests__/errors.test.js +1 -49
  18. package/dist/fleet-manager/__tests__/errors.test.js.map +1 -1
  19. package/dist/fleet-manager/__tests__/integration.test.js +114 -0
  20. package/dist/fleet-manager/__tests__/integration.test.js.map +1 -1
  21. package/dist/fleet-manager/__tests__/job-control.test.js +13 -14
  22. package/dist/fleet-manager/__tests__/job-control.test.js.map +1 -1
  23. package/dist/fleet-manager/__tests__/reload.test.js +12 -2
  24. package/dist/fleet-manager/__tests__/reload.test.js.map +1 -1
  25. package/dist/fleet-manager/__tests__/status-queries.test.js +6 -0
  26. package/dist/fleet-manager/__tests__/status-queries.test.js.map +1 -1
  27. package/dist/fleet-manager/__tests__/trigger.test.js +10 -2
  28. package/dist/fleet-manager/__tests__/trigger.test.js.map +1 -1
  29. package/dist/fleet-manager/config-reload.d.ts +164 -0
  30. package/dist/fleet-manager/config-reload.d.ts.map +1 -0
  31. package/dist/fleet-manager/config-reload.js +445 -0
  32. package/dist/fleet-manager/config-reload.js.map +1 -0
  33. package/dist/fleet-manager/context.d.ts +76 -0
  34. package/dist/fleet-manager/context.d.ts.map +1 -0
  35. package/dist/fleet-manager/context.js +11 -0
  36. package/dist/fleet-manager/context.js.map +1 -0
  37. package/dist/fleet-manager/errors.d.ts +0 -25
  38. package/dist/fleet-manager/errors.d.ts.map +1 -1
  39. package/dist/fleet-manager/errors.js +0 -38
  40. package/dist/fleet-manager/errors.js.map +1 -1
  41. package/dist/fleet-manager/event-emitters.d.ts +123 -0
  42. package/dist/fleet-manager/event-emitters.d.ts.map +1 -0
  43. package/dist/fleet-manager/event-emitters.js +136 -0
  44. package/dist/fleet-manager/event-emitters.js.map +1 -0
  45. package/dist/fleet-manager/event-types.d.ts +0 -15
  46. package/dist/fleet-manager/event-types.d.ts.map +1 -1
  47. package/dist/fleet-manager/fleet-manager.d.ts +40 -653
  48. package/dist/fleet-manager/fleet-manager.d.ts.map +1 -1
  49. package/dist/fleet-manager/fleet-manager.js +95 -1720
  50. package/dist/fleet-manager/fleet-manager.js.map +1 -1
  51. package/dist/fleet-manager/index.d.ts +13 -2
  52. package/dist/fleet-manager/index.d.ts.map +1 -1
  53. package/dist/fleet-manager/index.js +19 -6
  54. package/dist/fleet-manager/index.js.map +1 -1
  55. package/dist/fleet-manager/job-control.d.ts +67 -0
  56. package/dist/fleet-manager/job-control.d.ts.map +1 -0
  57. package/dist/fleet-manager/job-control.js +333 -0
  58. package/dist/fleet-manager/job-control.js.map +1 -0
  59. package/dist/fleet-manager/log-streaming.d.ts +171 -0
  60. package/dist/fleet-manager/log-streaming.d.ts.map +1 -0
  61. package/dist/fleet-manager/log-streaming.js +503 -0
  62. package/dist/fleet-manager/log-streaming.js.map +1 -0
  63. package/dist/fleet-manager/schedule-executor.d.ts +63 -0
  64. package/dist/fleet-manager/schedule-executor.d.ts.map +1 -0
  65. package/dist/fleet-manager/schedule-executor.js +209 -0
  66. package/dist/fleet-manager/schedule-executor.js.map +1 -0
  67. package/dist/fleet-manager/schedule-management.d.ts +71 -0
  68. package/dist/fleet-manager/schedule-management.d.ts.map +1 -0
  69. package/dist/fleet-manager/schedule-management.js +171 -0
  70. package/dist/fleet-manager/schedule-management.js.map +1 -0
  71. package/dist/fleet-manager/status-queries.d.ts +105 -0
  72. package/dist/fleet-manager/status-queries.d.ts.map +1 -0
  73. package/dist/fleet-manager/status-queries.js +247 -0
  74. package/dist/fleet-manager/status-queries.js.map +1 -0
  75. package/dist/fleet-manager/types.d.ts +0 -39
  76. package/dist/fleet-manager/types.d.ts.map +1 -1
  77. package/dist/runner/__tests__/job-executor.test.js +206 -1
  78. package/dist/runner/__tests__/job-executor.test.js.map +1 -1
  79. package/dist/runner/job-executor.d.ts +9 -0
  80. package/dist/runner/job-executor.d.ts.map +1 -1
  81. package/dist/runner/job-executor.js +78 -4
  82. package/dist/runner/job-executor.js.map +1 -1
  83. package/dist/runner/message-processor.d.ts.map +1 -1
  84. package/dist/runner/message-processor.js +53 -0
  85. package/dist/runner/message-processor.js.map +1 -1
  86. package/dist/runner/types.d.ts +3 -1
  87. package/dist/runner/types.d.ts.map +1 -1
  88. package/dist/scheduler/__tests__/cron.test.d.ts +2 -0
  89. package/dist/scheduler/__tests__/cron.test.d.ts.map +1 -0
  90. package/dist/scheduler/__tests__/cron.test.js +867 -0
  91. package/dist/scheduler/__tests__/cron.test.js.map +1 -0
  92. package/dist/scheduler/__tests__/scheduler.test.js +164 -5
  93. package/dist/scheduler/__tests__/scheduler.test.js.map +1 -1
  94. package/dist/scheduler/cron.d.ts +126 -0
  95. package/dist/scheduler/cron.d.ts.map +1 -0
  96. package/dist/scheduler/cron.js +390 -0
  97. package/dist/scheduler/cron.js.map +1 -0
  98. package/dist/scheduler/errors.d.ts +81 -1
  99. package/dist/scheduler/errors.d.ts.map +1 -1
  100. package/dist/scheduler/errors.js +81 -6
  101. package/dist/scheduler/errors.js.map +1 -1
  102. package/dist/scheduler/index.d.ts +1 -0
  103. package/dist/scheduler/index.d.ts.map +1 -1
  104. package/dist/scheduler/index.js +2 -0
  105. package/dist/scheduler/index.js.map +1 -1
  106. package/dist/scheduler/schedule-runner.d.ts +2 -2
  107. package/dist/scheduler/schedule-runner.d.ts.map +1 -1
  108. package/dist/scheduler/schedule-runner.js +20 -8
  109. package/dist/scheduler/schedule-runner.js.map +1 -1
  110. package/dist/scheduler/scheduler.d.ts +4 -4
  111. package/dist/scheduler/scheduler.d.ts.map +1 -1
  112. package/dist/scheduler/scheduler.js +95 -20
  113. package/dist/scheduler/scheduler.js.map +1 -1
  114. package/dist/scheduler/types.d.ts +1 -1
  115. package/dist/scheduler/types.d.ts.map +1 -1
  116. package/dist/state/schemas/job-metadata.d.ts +2 -2
  117. package/package.json +33 -8
  118. package/.turbo/turbo-build.log +0 -4
  119. package/.turbo/turbo-test.log +0 -219
  120. package/.turbo/turbo-typecheck.log +0 -4
  121. package/coverage/base.css +0 -224
  122. package/coverage/block-navigation.js +0 -87
  123. package/coverage/coverage-final.json +0 -51
  124. package/coverage/favicon.png +0 -0
  125. package/coverage/index.html +0 -251
  126. package/coverage/prettify.css +0 -1
  127. package/coverage/prettify.js +0 -2
  128. package/coverage/sort-arrow-sprite.png +0 -0
  129. package/coverage/sorter.js +0 -210
  130. package/coverage/src/config/index.html +0 -191
  131. package/coverage/src/config/index.ts.html +0 -442
  132. package/coverage/src/config/interpolate.ts.html +0 -652
  133. package/coverage/src/config/loader.ts.html +0 -1501
  134. package/coverage/src/config/merge.ts.html +0 -823
  135. package/coverage/src/config/parser.ts.html +0 -1213
  136. package/coverage/src/config/schema.ts.html +0 -1123
  137. package/coverage/src/fleet-manager/errors.ts.html +0 -2326
  138. package/coverage/src/fleet-manager/event-types.ts.html +0 -1219
  139. package/coverage/src/fleet-manager/fleet-manager.ts.html +0 -7030
  140. package/coverage/src/fleet-manager/index.html +0 -206
  141. package/coverage/src/fleet-manager/index.ts.html +0 -469
  142. package/coverage/src/fleet-manager/job-manager.ts.html +0 -2074
  143. package/coverage/src/fleet-manager/job-queue.ts.html +0 -2479
  144. package/coverage/src/fleet-manager/types.ts.html +0 -2602
  145. package/coverage/src/index.html +0 -116
  146. package/coverage/src/index.ts.html +0 -181
  147. package/coverage/src/runner/errors.ts.html +0 -1006
  148. package/coverage/src/runner/index.html +0 -191
  149. package/coverage/src/runner/index.ts.html +0 -256
  150. package/coverage/src/runner/job-executor.ts.html +0 -1429
  151. package/coverage/src/runner/message-processor.ts.html +0 -1150
  152. package/coverage/src/runner/sdk-adapter.ts.html +0 -658
  153. package/coverage/src/runner/types.ts.html +0 -559
  154. package/coverage/src/scheduler/errors.ts.html +0 -388
  155. package/coverage/src/scheduler/index.html +0 -206
  156. package/coverage/src/scheduler/index.ts.html +0 -244
  157. package/coverage/src/scheduler/interval.ts.html +0 -652
  158. package/coverage/src/scheduler/schedule-runner.ts.html +0 -1411
  159. package/coverage/src/scheduler/schedule-state.ts.html +0 -718
  160. package/coverage/src/scheduler/scheduler.ts.html +0 -1795
  161. package/coverage/src/scheduler/types.ts.html +0 -733
  162. package/coverage/src/state/directory.ts.html +0 -736
  163. package/coverage/src/state/errors.ts.html +0 -376
  164. package/coverage/src/state/fleet-state.ts.html +0 -937
  165. package/coverage/src/state/index.html +0 -221
  166. package/coverage/src/state/index.ts.html +0 -322
  167. package/coverage/src/state/job-metadata.ts.html +0 -1420
  168. package/coverage/src/state/job-output.ts.html +0 -1033
  169. package/coverage/src/state/schemas/fleet-state.ts.html +0 -445
  170. package/coverage/src/state/schemas/index.html +0 -176
  171. package/coverage/src/state/schemas/index.ts.html +0 -286
  172. package/coverage/src/state/schemas/job-metadata.ts.html +0 -628
  173. package/coverage/src/state/schemas/job-output.ts.html +0 -616
  174. package/coverage/src/state/schemas/session-info.ts.html +0 -361
  175. package/coverage/src/state/session.ts.html +0 -844
  176. package/coverage/src/state/types.ts.html +0 -262
  177. package/coverage/src/state/utils/atomic.ts.html +0 -748
  178. package/coverage/src/state/utils/index.html +0 -146
  179. package/coverage/src/state/utils/index.ts.html +0 -103
  180. package/coverage/src/state/utils/reads.ts.html +0 -1621
  181. package/coverage/src/work-sources/adapters/github.ts.html +0 -3583
  182. package/coverage/src/work-sources/adapters/index.html +0 -131
  183. package/coverage/src/work-sources/adapters/index.ts.html +0 -277
  184. package/coverage/src/work-sources/errors.ts.html +0 -298
  185. package/coverage/src/work-sources/index.html +0 -176
  186. package/coverage/src/work-sources/index.ts.html +0 -529
  187. package/coverage/src/work-sources/manager.ts.html +0 -1324
  188. package/coverage/src/work-sources/registry.ts.html +0 -619
  189. package/coverage/src/work-sources/types.ts.html +0 -568
  190. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts +0 -7
  191. package/dist/fleet-manager/__tests__/event-helpers.test.d.ts.map +0 -1
  192. package/dist/fleet-manager/__tests__/event-helpers.test.js +0 -368
  193. package/dist/fleet-manager/__tests__/event-helpers.test.js.map +0 -1
  194. package/src/config/__tests__/agent.test.ts +0 -864
  195. package/src/config/__tests__/interpolate.test.ts +0 -644
  196. package/src/config/__tests__/loader.test.ts +0 -784
  197. package/src/config/__tests__/merge.test.ts +0 -751
  198. package/src/config/__tests__/parser.test.ts +0 -533
  199. package/src/config/__tests__/schema.test.ts +0 -873
  200. package/src/config/index.ts +0 -119
  201. package/src/config/interpolate.ts +0 -189
  202. package/src/config/loader.ts +0 -472
  203. package/src/config/merge.ts +0 -246
  204. package/src/config/parser.ts +0 -376
  205. package/src/config/schema.ts +0 -346
  206. package/src/fleet-manager/__tests__/coverage.test.ts +0 -2869
  207. package/src/fleet-manager/__tests__/errors.test.ts +0 -660
  208. package/src/fleet-manager/__tests__/event-helpers.test.ts +0 -448
  209. package/src/fleet-manager/__tests__/integration.test.ts +0 -1209
  210. package/src/fleet-manager/__tests__/job-control.test.ts +0 -283
  211. package/src/fleet-manager/__tests__/job-manager.test.ts +0 -869
  212. package/src/fleet-manager/__tests__/job-queue.test.ts +0 -401
  213. package/src/fleet-manager/__tests__/reload.test.ts +0 -751
  214. package/src/fleet-manager/__tests__/status-queries.test.ts +0 -595
  215. package/src/fleet-manager/__tests__/trigger.test.ts +0 -601
  216. package/src/fleet-manager/errors.ts +0 -747
  217. package/src/fleet-manager/event-types.ts +0 -378
  218. package/src/fleet-manager/fleet-manager.ts +0 -2315
  219. package/src/fleet-manager/index.ts +0 -128
  220. package/src/fleet-manager/job-manager.ts +0 -663
  221. package/src/fleet-manager/job-queue.ts +0 -798
  222. package/src/fleet-manager/types.ts +0 -839
  223. package/src/index.ts +0 -32
  224. package/src/runner/__tests__/errors.test.ts +0 -382
  225. package/src/runner/__tests__/job-executor.test.ts +0 -1708
  226. package/src/runner/__tests__/message-processor.test.ts +0 -960
  227. package/src/runner/__tests__/sdk-adapter.test.ts +0 -626
  228. package/src/runner/errors.ts +0 -307
  229. package/src/runner/index.ts +0 -57
  230. package/src/runner/job-executor.ts +0 -448
  231. package/src/runner/message-processor.ts +0 -355
  232. package/src/runner/sdk-adapter.ts +0 -191
  233. package/src/runner/types.ts +0 -158
  234. package/src/scheduler/__tests__/errors.test.ts +0 -159
  235. package/src/scheduler/__tests__/interval.test.ts +0 -515
  236. package/src/scheduler/__tests__/schedule-runner.test.ts +0 -798
  237. package/src/scheduler/__tests__/schedule-state.test.ts +0 -671
  238. package/src/scheduler/__tests__/scheduler.test.ts +0 -1280
  239. package/src/scheduler/errors.ts +0 -101
  240. package/src/scheduler/index.ts +0 -53
  241. package/src/scheduler/interval.ts +0 -189
  242. package/src/scheduler/schedule-runner.ts +0 -442
  243. package/src/scheduler/schedule-state.ts +0 -211
  244. package/src/scheduler/scheduler.ts +0 -570
  245. package/src/scheduler/types.ts +0 -216
  246. package/src/state/__tests__/directory.test.ts +0 -595
  247. package/src/state/__tests__/fleet-state.test.ts +0 -868
  248. package/src/state/__tests__/job-metadata-schema.test.ts +0 -414
  249. package/src/state/__tests__/job-metadata.test.ts +0 -831
  250. package/src/state/__tests__/job-output.test.ts +0 -856
  251. package/src/state/__tests__/session-schema.test.ts +0 -378
  252. package/src/state/__tests__/session.test.ts +0 -604
  253. package/src/state/directory.ts +0 -217
  254. package/src/state/errors.ts +0 -97
  255. package/src/state/fleet-state.ts +0 -284
  256. package/src/state/index.ts +0 -79
  257. package/src/state/job-metadata.ts +0 -445
  258. package/src/state/job-output.ts +0 -316
  259. package/src/state/schemas/__tests__/job-output.test.ts +0 -338
  260. package/src/state/schemas/fleet-state.ts +0 -120
  261. package/src/state/schemas/index.ts +0 -67
  262. package/src/state/schemas/job-metadata.ts +0 -181
  263. package/src/state/schemas/job-output.ts +0 -177
  264. package/src/state/schemas/session-info.ts +0 -92
  265. package/src/state/session.ts +0 -253
  266. package/src/state/types.ts +0 -59
  267. package/src/state/utils/__tests__/atomic.test.ts +0 -723
  268. package/src/state/utils/__tests__/reads.test.ts +0 -1071
  269. package/src/state/utils/atomic.ts +0 -221
  270. package/src/state/utils/index.ts +0 -6
  271. package/src/state/utils/reads.ts +0 -512
  272. package/src/work-sources/__tests__/github.test.ts +0 -1800
  273. package/src/work-sources/__tests__/manager.test.ts +0 -529
  274. package/src/work-sources/__tests__/registry.test.ts +0 -477
  275. package/src/work-sources/__tests__/types.test.ts +0 -479
  276. package/src/work-sources/adapters/github.ts +0 -1166
  277. package/src/work-sources/adapters/index.ts +0 -64
  278. package/src/work-sources/errors.ts +0 -71
  279. package/src/work-sources/index.ts +0 -148
  280. package/src/work-sources/manager.ts +0 -413
  281. package/src/work-sources/registry.ts +0 -178
  282. package/src/work-sources/types.ts +0 -161
  283. package/tsconfig.json +0 -9
  284. package/vitest.config.ts +0 -19
@@ -1,869 +0,0 @@
1
- /**
2
- * Tests for JobManager (US-4)
3
- *
4
- * Tests job history queries, output streaming, and retention management.
5
- */
6
-
7
- import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
8
- import { mkdtemp, rm, mkdir, writeFile, appendFile } from "fs/promises";
9
- import { tmpdir } from "os";
10
- import { join } from "path";
11
- import { JobManager } from "../job-manager.js";
12
- import { JobNotFoundError } from "../errors.js";
13
- import { createJob, updateJob } from "../../state/job-metadata.js";
14
- import { appendJobOutput } from "../../state/job-output.js";
15
- import type { JobMetadata } from "../../state/schemas/job-metadata.js";
16
-
17
- describe("JobManager", () => {
18
- let tempDir: string;
19
- let jobsDir: string;
20
-
21
- beforeEach(async () => {
22
- // Create temp directory for test
23
- tempDir = await mkdtemp(join(tmpdir(), "job-manager-test-"));
24
- jobsDir = join(tempDir, ".herdctl", "jobs");
25
- await mkdir(jobsDir, { recursive: true });
26
- });
27
-
28
- afterEach(async () => {
29
- // Cleanup
30
- await rm(tempDir, { recursive: true, force: true });
31
- });
32
-
33
- // Helper to create a test job
34
- async function createTestJob(options: {
35
- agent: string;
36
- status?: "pending" | "running" | "completed" | "failed" | "cancelled";
37
- startedAt?: Date;
38
- prompt?: string;
39
- }): Promise<JobMetadata> {
40
- const job = await createJob(jobsDir, {
41
- agent: options.agent,
42
- trigger_type: "manual",
43
- prompt: options.prompt ?? "Test prompt",
44
- });
45
-
46
- if (options.status && options.status !== "pending") {
47
- return await updateJob(jobsDir, job.id, {
48
- status: options.status,
49
- finished_at:
50
- options.status === "running" ? undefined : new Date().toISOString(),
51
- exit_reason:
52
- options.status === "completed"
53
- ? "success"
54
- : options.status === "failed"
55
- ? "error"
56
- : options.status === "cancelled"
57
- ? "cancelled"
58
- : undefined,
59
- });
60
- }
61
-
62
- return job;
63
- }
64
-
65
- describe("getJobs()", () => {
66
- it("returns empty list when no jobs exist", async () => {
67
- const manager = new JobManager({ jobsDir });
68
- const result = await manager.getJobs();
69
-
70
- expect(result.jobs).toEqual([]);
71
- expect(result.total).toBe(0);
72
- expect(result.errors).toBe(0);
73
- });
74
-
75
- it("returns all jobs when no filter specified", async () => {
76
- const manager = new JobManager({ jobsDir });
77
-
78
- await createTestJob({ agent: "agent-1" });
79
- await createTestJob({ agent: "agent-2" });
80
- await createTestJob({ agent: "agent-1" });
81
-
82
- const result = await manager.getJobs();
83
-
84
- expect(result.jobs).toHaveLength(3);
85
- expect(result.total).toBe(3);
86
- });
87
-
88
- it("filters by agent name", async () => {
89
- const manager = new JobManager({ jobsDir });
90
-
91
- await createTestJob({ agent: "agent-1" });
92
- await createTestJob({ agent: "agent-2" });
93
- await createTestJob({ agent: "agent-1" });
94
-
95
- const result = await manager.getJobs({ agent: "agent-1" });
96
-
97
- expect(result.jobs).toHaveLength(2);
98
- expect(result.total).toBe(2);
99
- expect(result.jobs.every((j) => j.agent === "agent-1")).toBe(true);
100
- });
101
-
102
- it("filters by status", async () => {
103
- const manager = new JobManager({ jobsDir });
104
-
105
- await createTestJob({ agent: "agent-1", status: "completed" });
106
- await createTestJob({ agent: "agent-1", status: "failed" });
107
- await createTestJob({ agent: "agent-1", status: "completed" });
108
-
109
- const result = await manager.getJobs({ status: "completed" });
110
-
111
- expect(result.jobs).toHaveLength(2);
112
- expect(result.total).toBe(2);
113
- expect(result.jobs.every((j) => j.status === "completed")).toBe(true);
114
- });
115
-
116
- it("filters by date range", async () => {
117
- const manager = new JobManager({ jobsDir });
118
-
119
- // Create jobs (they will all have "now" as started_at)
120
- await createTestJob({ agent: "agent-1" });
121
- await createTestJob({ agent: "agent-1" });
122
-
123
- // Filter for jobs after a past date
124
- const pastDate = new Date(Date.now() - 60000); // 1 minute ago
125
- const result = await manager.getJobs({ startedAfter: pastDate });
126
-
127
- expect(result.jobs).toHaveLength(2);
128
- });
129
-
130
- it("applies limit correctly", async () => {
131
- const manager = new JobManager({ jobsDir });
132
-
133
- await createTestJob({ agent: "agent-1" });
134
- await createTestJob({ agent: "agent-1" });
135
- await createTestJob({ agent: "agent-1" });
136
-
137
- const result = await manager.getJobs({ limit: 2 });
138
-
139
- expect(result.jobs).toHaveLength(2);
140
- expect(result.total).toBe(3); // Total still shows all matching
141
- });
142
-
143
- it("applies offset correctly", async () => {
144
- const manager = new JobManager({ jobsDir });
145
-
146
- await createTestJob({ agent: "agent-1" });
147
- await createTestJob({ agent: "agent-1" });
148
- await createTestJob({ agent: "agent-1" });
149
-
150
- const result = await manager.getJobs({ offset: 1 });
151
-
152
- expect(result.jobs).toHaveLength(2);
153
- expect(result.total).toBe(3);
154
- });
155
-
156
- it("applies limit and offset together", async () => {
157
- const manager = new JobManager({ jobsDir });
158
-
159
- await createTestJob({ agent: "agent-1" });
160
- await createTestJob({ agent: "agent-1" });
161
- await createTestJob({ agent: "agent-1" });
162
- await createTestJob({ agent: "agent-1" });
163
-
164
- const result = await manager.getJobs({ limit: 2, offset: 1 });
165
-
166
- expect(result.jobs).toHaveLength(2);
167
- expect(result.total).toBe(4);
168
- });
169
-
170
- it("combines multiple filters", async () => {
171
- const manager = new JobManager({ jobsDir });
172
-
173
- await createTestJob({ agent: "agent-1", status: "completed" });
174
- await createTestJob({ agent: "agent-1", status: "failed" });
175
- await createTestJob({ agent: "agent-2", status: "completed" });
176
- await createTestJob({ agent: "agent-1", status: "completed" });
177
-
178
- const result = await manager.getJobs({
179
- agent: "agent-1",
180
- status: "completed",
181
- });
182
-
183
- expect(result.jobs).toHaveLength(2);
184
- expect(result.total).toBe(2);
185
- expect(
186
- result.jobs.every(
187
- (j) => j.agent === "agent-1" && j.status === "completed"
188
- )
189
- ).toBe(true);
190
- });
191
-
192
- it("returns jobs sorted by started_at descending", async () => {
193
- const manager = new JobManager({ jobsDir });
194
-
195
- // Create jobs with small delays to ensure different timestamps
196
- const job1 = await createTestJob({ agent: "agent-1" });
197
- await new Promise((resolve) => setTimeout(resolve, 10));
198
- const job2 = await createTestJob({ agent: "agent-1" });
199
- await new Promise((resolve) => setTimeout(resolve, 10));
200
- const job3 = await createTestJob({ agent: "agent-1" });
201
-
202
- const result = await manager.getJobs();
203
-
204
- // Most recent (job3) should be first
205
- expect(result.jobs[0].id).toBe(job3.id);
206
- expect(result.jobs[1].id).toBe(job2.id);
207
- expect(result.jobs[2].id).toBe(job1.id);
208
- });
209
- });
210
-
211
- describe("getJob()", () => {
212
- it("returns job by ID", async () => {
213
- const manager = new JobManager({ jobsDir });
214
- const created = await createTestJob({ agent: "test-agent" });
215
-
216
- const job = await manager.getJob(created.id);
217
-
218
- expect(job.id).toBe(created.id);
219
- expect(job.agent).toBe("test-agent");
220
- });
221
-
222
- it("throws JobNotFoundError for unknown ID", async () => {
223
- const manager = new JobManager({ jobsDir });
224
-
225
- await expect(manager.getJob("job-2099-01-01-xxxxxx")).rejects.toThrow(
226
- JobNotFoundError
227
- );
228
-
229
- await expect(manager.getJob("job-2099-01-01-xxxxxx")).rejects.toMatchObject(
230
- {
231
- name: "JobNotFoundError",
232
- jobId: "job-2099-01-01-xxxxxx",
233
- }
234
- );
235
- });
236
-
237
- it("returns job without output by default", async () => {
238
- const manager = new JobManager({ jobsDir });
239
- const created = await createTestJob({ agent: "test-agent" });
240
-
241
- // Add some output
242
- await appendJobOutput(jobsDir, created.id, {
243
- type: "assistant",
244
- content: "Hello",
245
- });
246
-
247
- const job = await manager.getJob(created.id);
248
-
249
- expect(job.output).toBeUndefined();
250
- });
251
-
252
- it("includes output when requested", async () => {
253
- const manager = new JobManager({ jobsDir });
254
- const created = await createTestJob({ agent: "test-agent" });
255
-
256
- // Add some output
257
- await appendJobOutput(jobsDir, created.id, {
258
- type: "assistant",
259
- content: "Hello",
260
- });
261
- await appendJobOutput(jobsDir, created.id, {
262
- type: "assistant",
263
- content: "World",
264
- });
265
-
266
- const job = await manager.getJob(created.id, { includeOutput: true });
267
-
268
- expect(job.output).toBeDefined();
269
- expect(job.output).toHaveLength(2);
270
- expect(job.output![0].type).toBe("assistant");
271
- expect((job.output![0] as { content?: string }).content).toBe("Hello");
272
- });
273
- });
274
-
275
- describe("streamJobOutput()", () => {
276
- it("throws JobNotFoundError for unknown job", async () => {
277
- const manager = new JobManager({ jobsDir });
278
-
279
- await expect(
280
- manager.streamJobOutput("job-2099-01-01-xxxxxx")
281
- ).rejects.toThrow(JobNotFoundError);
282
- });
283
-
284
- it("emits existing messages immediately", async () => {
285
- const manager = new JobManager({ jobsDir });
286
- const created = await createTestJob({
287
- agent: "test-agent",
288
- status: "completed",
289
- });
290
-
291
- // Add some output before streaming
292
- await appendJobOutput(jobsDir, created.id, {
293
- type: "assistant",
294
- content: "Message 1",
295
- });
296
- await appendJobOutput(jobsDir, created.id, {
297
- type: "assistant",
298
- content: "Message 2",
299
- });
300
-
301
- const messages: unknown[] = [];
302
- const stream = await manager.streamJobOutput(created.id);
303
-
304
- stream.on("message", (msg) => {
305
- messages.push(msg);
306
- });
307
-
308
- // Wait a bit for messages to be emitted
309
- await new Promise((resolve) => setTimeout(resolve, 100));
310
-
311
- stream.stop();
312
-
313
- expect(messages.length).toBeGreaterThanOrEqual(2);
314
- });
315
-
316
- it("emits end event for completed jobs", async () => {
317
- const manager = new JobManager({ jobsDir });
318
- const created = await createTestJob({
319
- agent: "test-agent",
320
- status: "completed",
321
- });
322
-
323
- const stream = await manager.streamJobOutput(created.id);
324
- let ended = false;
325
-
326
- stream.on("end", () => {
327
- ended = true;
328
- });
329
-
330
- // Wait for end event
331
- await new Promise((resolve) => setTimeout(resolve, 100));
332
-
333
- stream.stop();
334
-
335
- expect(ended).toBe(true);
336
- });
337
-
338
- it("can be stopped", async () => {
339
- const manager = new JobManager({ jobsDir });
340
- const created = await createTestJob({
341
- agent: "test-agent",
342
- status: "running",
343
- });
344
-
345
- const stream = await manager.streamJobOutput(created.id);
346
-
347
- // Should not throw
348
- stream.stop();
349
- });
350
- });
351
-
352
- describe("applyRetention()", () => {
353
- it("keeps jobs within per-agent limit", async () => {
354
- const manager = new JobManager({
355
- jobsDir,
356
- retention: { maxJobsPerAgent: 2 },
357
- });
358
-
359
- // Create 3 jobs for same agent
360
- await createTestJob({ agent: "agent-1", status: "completed" });
361
- await new Promise((resolve) => setTimeout(resolve, 10));
362
- await createTestJob({ agent: "agent-1", status: "completed" });
363
- await new Promise((resolve) => setTimeout(resolve, 10));
364
- await createTestJob({ agent: "agent-1", status: "completed" });
365
-
366
- // Apply retention
367
- const deleted = await manager.applyRetention();
368
-
369
- expect(deleted).toBe(1);
370
-
371
- // Verify only 2 remain
372
- const result = await manager.getJobs({ agent: "agent-1" });
373
- expect(result.total).toBe(2);
374
- });
375
-
376
- it("respects per-agent limit independently", async () => {
377
- const manager = new JobManager({
378
- jobsDir,
379
- retention: { maxJobsPerAgent: 2 },
380
- });
381
-
382
- // Create 3 jobs for agent-1
383
- await createTestJob({ agent: "agent-1", status: "completed" });
384
- await new Promise((resolve) => setTimeout(resolve, 10));
385
- await createTestJob({ agent: "agent-1", status: "completed" });
386
- await new Promise((resolve) => setTimeout(resolve, 10));
387
- await createTestJob({ agent: "agent-1", status: "completed" });
388
-
389
- // Create 2 jobs for agent-2
390
- await createTestJob({ agent: "agent-2", status: "completed" });
391
- await createTestJob({ agent: "agent-2", status: "completed" });
392
-
393
- // Apply retention
394
- const deleted = await manager.applyRetention();
395
-
396
- expect(deleted).toBe(1); // Only 1 from agent-1
397
-
398
- // Verify counts
399
- const agent1Result = await manager.getJobs({ agent: "agent-1" });
400
- const agent2Result = await manager.getJobs({ agent: "agent-2" });
401
-
402
- expect(agent1Result.total).toBe(2);
403
- expect(agent2Result.total).toBe(2);
404
- });
405
-
406
- it("applies fleet-wide limit", async () => {
407
- const manager = new JobManager({
408
- jobsDir,
409
- retention: { maxJobsPerAgent: 100, maxTotalJobs: 3 },
410
- });
411
-
412
- // Create 5 jobs across different agents
413
- await createTestJob({ agent: "agent-1", status: "completed" });
414
- await new Promise((resolve) => setTimeout(resolve, 10));
415
- await createTestJob({ agent: "agent-2", status: "completed" });
416
- await new Promise((resolve) => setTimeout(resolve, 10));
417
- await createTestJob({ agent: "agent-3", status: "completed" });
418
- await new Promise((resolve) => setTimeout(resolve, 10));
419
- await createTestJob({ agent: "agent-4", status: "completed" });
420
- await new Promise((resolve) => setTimeout(resolve, 10));
421
- await createTestJob({ agent: "agent-5", status: "completed" });
422
-
423
- // Apply retention
424
- const deleted = await manager.applyRetention();
425
-
426
- expect(deleted).toBe(2);
427
-
428
- // Verify total count
429
- const result = await manager.getJobs();
430
- expect(result.total).toBe(3);
431
- });
432
-
433
- it("deletes oldest jobs first", async () => {
434
- const manager = new JobManager({
435
- jobsDir,
436
- retention: { maxJobsPerAgent: 2 },
437
- });
438
-
439
- // Create jobs with increasing timestamps
440
- const oldest = await createTestJob({
441
- agent: "agent-1",
442
- status: "completed",
443
- });
444
- await new Promise((resolve) => setTimeout(resolve, 10));
445
- const middle = await createTestJob({
446
- agent: "agent-1",
447
- status: "completed",
448
- });
449
- await new Promise((resolve) => setTimeout(resolve, 10));
450
- const newest = await createTestJob({
451
- agent: "agent-1",
452
- status: "completed",
453
- });
454
-
455
- // Apply retention
456
- await manager.applyRetention();
457
-
458
- // Verify oldest was deleted
459
- const result = await manager.getJobs({ agent: "agent-1" });
460
- const ids = result.jobs.map((j) => j.id);
461
-
462
- expect(ids).toContain(newest.id);
463
- expect(ids).toContain(middle.id);
464
- expect(ids).not.toContain(oldest.id);
465
- });
466
-
467
- it("uses default per-agent limit of 100", async () => {
468
- const manager = new JobManager({ jobsDir });
469
- const config = manager.getRetentionConfig();
470
-
471
- expect(config.maxJobsPerAgent).toBe(100);
472
- expect(config.maxTotalJobs).toBe(0); // 0 means no limit
473
- });
474
- });
475
-
476
- describe("getRetentionConfig()", () => {
477
- it("returns configured retention settings", async () => {
478
- const manager = new JobManager({
479
- jobsDir,
480
- retention: { maxJobsPerAgent: 50, maxTotalJobs: 500 },
481
- });
482
-
483
- const config = manager.getRetentionConfig();
484
-
485
- expect(config.maxJobsPerAgent).toBe(50);
486
- expect(config.maxTotalJobs).toBe(500);
487
- });
488
-
489
- it("returns copy of config", async () => {
490
- const manager = new JobManager({
491
- jobsDir,
492
- retention: { maxJobsPerAgent: 50 },
493
- });
494
-
495
- const config1 = manager.getRetentionConfig();
496
- const config2 = manager.getRetentionConfig();
497
-
498
- expect(config1).toEqual(config2);
499
- expect(config1).not.toBe(config2); // Different object instances
500
- });
501
- });
502
-
503
- describe("job persistence survives restarts", () => {
504
- it("jobs persist after creating new JobManager instance", async () => {
505
- // Create first manager and add jobs
506
- const manager1 = new JobManager({ jobsDir });
507
- const created = await createTestJob({ agent: "test-agent" });
508
-
509
- // Create new manager instance (simulating restart)
510
- const manager2 = new JobManager({ jobsDir });
511
-
512
- // Job should still be accessible
513
- const job = await manager2.getJob(created.id);
514
- expect(job.id).toBe(created.id);
515
- expect(job.agent).toBe("test-agent");
516
- });
517
-
518
- it("job output persists after creating new JobManager instance", async () => {
519
- // Create first manager and add job with output
520
- const manager1 = new JobManager({ jobsDir });
521
- const created = await createTestJob({ agent: "test-agent" });
522
-
523
- await appendJobOutput(jobsDir, created.id, {
524
- type: "assistant",
525
- content: "Persistent message",
526
- });
527
-
528
- // Create new manager instance (simulating restart)
529
- const manager2 = new JobManager({ jobsDir });
530
-
531
- // Output should still be accessible
532
- const job = await manager2.getJob(created.id, { includeOutput: true });
533
- expect(job.output).toBeDefined();
534
- expect(job.output).toHaveLength(1);
535
- expect((job.output![0] as { content?: string }).content).toBe(
536
- "Persistent message"
537
- );
538
- });
539
- });
540
-
541
- describe("streamJobOutput() edge cases", () => {
542
- it("streams messages from a running job", async () => {
543
- const manager = new JobManager({ jobsDir });
544
- const created = await createTestJob({
545
- agent: "test-agent",
546
- status: "running",
547
- });
548
-
549
- // Add output before starting stream
550
- await appendJobOutput(jobsDir, created.id, {
551
- type: "assistant",
552
- content: "Initial message",
553
- });
554
-
555
- const messages: unknown[] = [];
556
- const stream = await manager.streamJobOutput(created.id);
557
-
558
- stream.on("message", (msg) => {
559
- messages.push(msg);
560
- });
561
-
562
- // Wait for messages to be processed
563
- await new Promise((resolve) => setTimeout(resolve, 100));
564
-
565
- // Add more output while streaming
566
- await appendJobOutput(jobsDir, created.id, {
567
- type: "assistant",
568
- content: "New message",
569
- });
570
-
571
- // Wait a bit more
572
- await new Promise((resolve) => setTimeout(resolve, 200));
573
-
574
- stream.stop();
575
-
576
- expect(messages.length).toBeGreaterThanOrEqual(1);
577
- });
578
-
579
- it("handles error event", async () => {
580
- const manager = new JobManager({ jobsDir });
581
- const created = await createTestJob({
582
- agent: "test-agent",
583
- status: "completed",
584
- });
585
-
586
- const stream = await manager.streamJobOutput(created.id);
587
- let errorReceived = false;
588
-
589
- stream.on("error", () => {
590
- errorReceived = true;
591
- });
592
-
593
- // Give time for processing
594
- await new Promise((resolve) => setTimeout(resolve, 100));
595
-
596
- stream.stop();
597
-
598
- // Error might not be received for normal completed jobs
599
- // This just tests the event listener is properly attached
600
- expect(typeof errorReceived).toBe("boolean");
601
- });
602
-
603
- it("can use off to unsubscribe from events", async () => {
604
- const manager = new JobManager({ jobsDir });
605
- const created = await createTestJob({
606
- agent: "test-agent",
607
- status: "completed",
608
- });
609
-
610
- const stream = await manager.streamJobOutput(created.id);
611
- let messageCount = 0;
612
- const handler = () => {
613
- messageCount++;
614
- };
615
-
616
- stream.on("message", handler);
617
- stream.off("message", handler);
618
-
619
- await new Promise((resolve) => setTimeout(resolve, 100));
620
- stream.stop();
621
-
622
- // Messages should not be counted after unsubscribing
623
- expect(messageCount).toBe(0);
624
- });
625
-
626
- it("handles job that has no output file yet", async () => {
627
- const manager = new JobManager({ jobsDir });
628
- const created = await createTestJob({
629
- agent: "test-agent",
630
- status: "running",
631
- });
632
-
633
- // Don't add any output - output file doesn't exist yet
634
- const stream = await manager.streamJobOutput(created.id);
635
- const messages: unknown[] = [];
636
-
637
- stream.on("message", (msg) => {
638
- messages.push(msg);
639
- });
640
-
641
- // Wait a bit
642
- await new Promise((resolve) => setTimeout(resolve, 100));
643
-
644
- stream.stop();
645
-
646
- // Should not crash, just return no messages
647
- expect(messages.length).toBe(0);
648
- });
649
-
650
- it("logs warning for malformed JSON in output file", async () => {
651
- const warnMessages: string[] = [];
652
- const manager = new JobManager({
653
- jobsDir,
654
- logger: {
655
- warn: (msg) => warnMessages.push(msg),
656
- debug: vi.fn(),
657
- },
658
- });
659
-
660
- const created = await createTestJob({
661
- agent: "test-agent",
662
- status: "completed",
663
- });
664
-
665
- // Write invalid JSON directly to output file (correct path format)
666
- const outputPath = join(jobsDir, `${created.id}.jsonl`);
667
- await writeFile(
668
- outputPath,
669
- 'not valid json\n{"type": "assistant", "content": "valid"}\n'
670
- );
671
-
672
- const messages: unknown[] = [];
673
- const stream = await manager.streamJobOutput(created.id);
674
-
675
- stream.on("message", (msg) => {
676
- messages.push(msg);
677
- });
678
-
679
- // Wait for processing
680
- await new Promise((resolve) => setTimeout(resolve, 150));
681
-
682
- stream.stop();
683
-
684
- // Should have logged a warning about malformed JSON
685
- expect(warnMessages.some((m) => m.includes("malformed JSON"))).toBe(true);
686
- // Should still have parsed the valid message
687
- expect(messages.length).toBeGreaterThanOrEqual(1);
688
- });
689
-
690
- it("emits end when polling detects job completion", async () => {
691
- const manager = new JobManager({ jobsDir });
692
-
693
- // Create a running job
694
- const created = await createTestJob({
695
- agent: "test-agent",
696
- status: "running",
697
- });
698
-
699
- const stream = await manager.streamJobOutput(created.id);
700
- let endReceived = false;
701
-
702
- stream.on("end", () => {
703
- endReceived = true;
704
- });
705
-
706
- // Complete the job while streaming
707
- await updateJob(jobsDir, created.id, {
708
- status: "completed",
709
- finished_at: new Date().toISOString(),
710
- exit_reason: "success",
711
- });
712
-
713
- // Wait for polling to detect completion (poll interval is 1000ms)
714
- await new Promise((resolve) => setTimeout(resolve, 1500));
715
-
716
- stream.stop();
717
-
718
- expect(endReceived).toBe(true);
719
- });
720
-
721
- it("handles stream stop during polling", async () => {
722
- const manager = new JobManager({ jobsDir });
723
-
724
- // Create a running job
725
- const created = await createTestJob({
726
- agent: "test-agent",
727
- status: "running",
728
- });
729
-
730
- const stream = await manager.streamJobOutput(created.id);
731
-
732
- // Immediately stop the stream
733
- stream.stop();
734
-
735
- // Wait to ensure polling would have run
736
- await new Promise((resolve) => setTimeout(resolve, 150));
737
-
738
- // Should not crash
739
- expect(true).toBe(true);
740
- });
741
- });
742
-
743
- describe("applyRetention() edge cases", () => {
744
- it("handles empty jobs directory", async () => {
745
- const manager = new JobManager({
746
- jobsDir,
747
- retention: { maxJobsPerAgent: 2 },
748
- });
749
-
750
- // No jobs created
751
- const deleted = await manager.applyRetention();
752
- expect(deleted).toBe(0);
753
- });
754
-
755
- it("handles jobs within retention limits", async () => {
756
- const manager = new JobManager({
757
- jobsDir,
758
- retention: { maxJobsPerAgent: 10, maxTotalJobs: 100 },
759
- });
760
-
761
- // Create fewer jobs than limits
762
- await createTestJob({ agent: "agent-1", status: "completed" });
763
- await createTestJob({ agent: "agent-1", status: "completed" });
764
-
765
- const deleted = await manager.applyRetention();
766
- expect(deleted).toBe(0);
767
-
768
- const result = await manager.getJobs();
769
- expect(result.total).toBe(2);
770
- });
771
-
772
- it("deletes output files when applying retention", async () => {
773
- const manager = new JobManager({
774
- jobsDir,
775
- retention: { maxJobsPerAgent: 1 },
776
- });
777
-
778
- // Create job with output
779
- const job1 = await createTestJob({
780
- agent: "agent-1",
781
- status: "completed",
782
- });
783
- await appendJobOutput(jobsDir, job1.id, {
784
- type: "assistant",
785
- content: "Output to be deleted",
786
- });
787
-
788
- await new Promise((resolve) => setTimeout(resolve, 10));
789
-
790
- // Create newer job
791
- await createTestJob({ agent: "agent-1", status: "completed" });
792
-
793
- // Apply retention
794
- await manager.applyRetention();
795
-
796
- // Old job and its output should be deleted
797
- const result = await manager.getJobs();
798
- expect(result.total).toBe(1);
799
- });
800
-
801
- it("logs warning when delete output file fails (non-ENOENT)", async () => {
802
- const warnMessages: string[] = [];
803
- const manager = new JobManager({
804
- jobsDir,
805
- retention: { maxJobsPerAgent: 1 },
806
- logger: {
807
- warn: (msg) => warnMessages.push(msg),
808
- debug: vi.fn(),
809
- },
810
- });
811
-
812
- // Create two jobs so one will be deleted
813
- const job1 = await createTestJob({
814
- agent: "agent-1",
815
- status: "completed",
816
- });
817
- await new Promise((resolve) => setTimeout(resolve, 10));
818
- await createTestJob({ agent: "agent-1", status: "completed" });
819
-
820
- // Make the output path a directory so unlink will fail with EISDIR
821
- // (correct path format without .output.)
822
- const outputDir = join(jobsDir, `${job1.id}.jsonl`);
823
- await mkdir(outputDir, { recursive: true });
824
-
825
- // Apply retention
826
- await manager.applyRetention();
827
-
828
- // Should have logged a warning about failing to delete output file
829
- expect(warnMessages.some((m) => m.includes("Failed to delete output file"))).toBe(true);
830
- });
831
- });
832
-
833
- describe("logger functionality", () => {
834
- it("uses provided logger", async () => {
835
- const warnMessages: string[] = [];
836
- const debugMessages: string[] = [];
837
-
838
- const manager = new JobManager({
839
- jobsDir,
840
- retention: { maxJobsPerAgent: 1 },
841
- logger: {
842
- warn: (msg) => warnMessages.push(msg),
843
- debug: (msg) => debugMessages.push(msg),
844
- },
845
- });
846
-
847
- // Create jobs to trigger retention
848
- await createTestJob({ agent: "agent-1", status: "completed" });
849
- await new Promise((resolve) => setTimeout(resolve, 10));
850
- await createTestJob({ agent: "agent-1", status: "completed" });
851
-
852
- await manager.applyRetention();
853
-
854
- // Debug message should have been logged
855
- expect(debugMessages.some((m) => m.includes("retention"))).toBe(true);
856
- });
857
-
858
- it("uses default console logger when none provided", async () => {
859
- // Just verify it doesn't crash
860
- const manager = new JobManager({ jobsDir });
861
- await createTestJob({ agent: "agent-1", status: "completed" });
862
-
863
- const job = await manager.getJob(
864
- (await manager.getJobs()).jobs[0].id
865
- );
866
- expect(job).toBeDefined();
867
- });
868
- });
869
- });