@cursor/july 0.1.19 → 0.1.21

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 (217) hide show
  1. package/AGENTS.md +10 -0
  2. package/dist/bin/agent-serve.js +0 -0
  3. package/dist/channels/github/instrument.d.ts +20 -0
  4. package/dist/channels/github/instrument.d.ts.map +1 -0
  5. package/dist/channels/slack/api.d.ts +2 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +3 -0
  8. package/dist/channels/slack/bot-mentions.d.ts +106 -0
  9. package/dist/channels/slack/bot-mentions.d.ts.map +1 -0
  10. package/dist/channels/slack/bot-mentions.js +243 -0
  11. package/dist/channels/slack/dispatch.d.ts +6 -0
  12. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  13. package/dist/channels/slack/dispatch.js +24 -3
  14. package/dist/channels/slack/inbound.d.ts +10 -1
  15. package/dist/channels/slack/inbound.d.ts.map +1 -1
  16. package/dist/channels/slack/inbound.js +12 -4
  17. package/dist/channels/slack/index.d.ts +1 -0
  18. package/dist/channels/slack/index.d.ts.map +1 -1
  19. package/dist/channels/slack/index.js +1 -0
  20. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  21. package/dist/channels/slack/slack-channel.js +61 -22
  22. package/dist/channels/slack/types.d.ts +58 -0
  23. package/dist/channels/slack/types.d.ts.map +1 -1
  24. package/dist/docs/404.html +1 -1
  25. package/dist/docs/ab.html +2 -2
  26. package/dist/docs/assets/{app.CrsWMchO.js → app.jDxLzWv4.js} +1 -1
  27. package/dist/docs/assets/chunks/@localSearchIndexroot.DoJHJjqF.js +1 -0
  28. package/dist/docs/assets/chunks/{VPLocalSearchBox.D1JqzSh8.js → VPLocalSearchBox.Y6bDR1-a.js} +1 -1
  29. package/dist/docs/assets/chunks/{theme.DaBvZYwl.js → theme.CLazCWlJ.js} +2 -2
  30. package/dist/docs/building-with-agents.html +2 -2
  31. package/dist/docs/concepts.html +2 -2
  32. package/dist/docs/deployment.html +2 -2
  33. package/dist/docs/evals.html +2 -2
  34. package/dist/docs/example-agents/approval-buddy.html +2 -2
  35. package/dist/docs/example-agents/benny.html +2 -2
  36. package/dist/docs/example-agents/bugbot.html +2 -2
  37. package/dist/docs/example-agents/codebase-wiki.html +2 -2
  38. package/dist/docs/example-agents/codeowners-review.html +2 -2
  39. package/dist/docs/example-agents/concierge.html +2 -2
  40. package/dist/docs/example-agents/fsd.html +2 -2
  41. package/dist/docs/example-agents/index.html +2 -2
  42. package/dist/docs/example-agents/knowledge-base.html +2 -2
  43. package/dist/docs/example-agents/oncall.html +2 -2
  44. package/dist/docs/example-agents/security-reviewer.html +2 -2
  45. package/dist/docs/example-agents/slack-agent.html +2 -2
  46. package/dist/docs/example-agents/weather-agent.html +2 -2
  47. package/dist/docs/guides/agent-to-agent.html +2 -2
  48. package/dist/docs/guides/cloud-runtime.html +2 -2
  49. package/dist/docs/guides/github.html +2 -2
  50. package/dist/docs/guides/human-in-the-loop.html +2 -2
  51. package/dist/docs/guides/mcp-oauth.html +2 -2
  52. package/dist/docs/guides/slack.html +2 -2
  53. package/dist/docs/guides/webhooks.html +2 -2
  54. package/dist/docs/hillclimbing.html +2 -2
  55. package/dist/docs/index.html +2 -2
  56. package/dist/docs/quickstart.html +2 -2
  57. package/dist/docs/reference/agent-config.html +2 -2
  58. package/dist/docs/reference/channels.html +2 -2
  59. package/dist/docs/reference/cli.html +2 -2
  60. package/dist/docs/reference/connections.html +2 -2
  61. package/dist/docs/reference/hooks.html +2 -2
  62. package/dist/docs/reference/http-api.html +2 -2
  63. package/dist/docs/reference/instructions.html +2 -2
  64. package/dist/docs/reference/playground.html +2 -2
  65. package/dist/docs/reference/project-layout.html +2 -2
  66. package/dist/docs/reference/prompt.html +2 -2
  67. package/dist/docs/reference/schedules.html +2 -2
  68. package/dist/docs/reference/sessions.html +2 -2
  69. package/dist/docs/reference/skills.html +2 -2
  70. package/dist/docs/reference/subagents.html +2 -2
  71. package/dist/docs/reference/tools.html +2 -2
  72. package/dist/docs/scaffolding-agents.html +2 -2
  73. package/dist/docs/storage.html +2 -2
  74. package/dist/docs/troubleshooting.html +2 -2
  75. package/dist/internal/json-dir-store.d.ts +32 -0
  76. package/dist/internal/json-dir-store.d.ts.map +1 -0
  77. package/dist/internal/json-dir-store.js +100 -0
  78. package/dist/internal/resolved-connections.d.ts +1 -1
  79. package/dist/internal/resolved-connections.d.ts.map +1 -1
  80. package/dist/internal/resolved-connections.js +10 -0
  81. package/dist/internal/session-engine.d.ts +4 -1
  82. package/dist/internal/session-engine.d.ts.map +1 -1
  83. package/dist/internal/session-engine.js +13 -2
  84. package/dist/playground/assets/index-CjOQ4hN9.css +1 -0
  85. package/dist/playground/assets/{index-C2SU2xV5.js → index-dshZQJCp.js} +46 -46
  86. package/dist/playground/index.html +2 -2
  87. package/dist/types.d.ts +7 -0
  88. package/dist/types.d.ts.map +1 -1
  89. package/dist/types.js +9 -0
  90. package/package.json +25 -25
  91. package/skills/create-agent/SKILL.md +36 -4
  92. package/skills/evals/SKILL.md +3 -0
  93. package/skills/framework-map/SKILL.md +14 -0
  94. package/skills/github/SKILL.md +6 -1
  95. package/skills/hillclimb/SKILL.md +28 -7
  96. package/src/bin/agent-serve.version.test.ts +62 -0
  97. package/src/channels/github/api.test.ts +64 -0
  98. package/src/channels/github/auth.test.ts +105 -0
  99. package/src/channels/github/cursor-account.test.ts +204 -0
  100. package/src/channels/github/forward.test.ts +457 -0
  101. package/src/channels/github/github.test.ts +937 -0
  102. package/src/channels/github/replay.test.ts +179 -0
  103. package/src/channels/slack/api.post-message.test.ts +148 -0
  104. package/src/channels/slack/api.ts +5 -0
  105. package/src/channels/slack/approvals.test.ts +328 -0
  106. package/src/channels/slack/block-actions.test.ts +452 -0
  107. package/src/channels/slack/bot-mentions.test.ts +217 -0
  108. package/src/channels/slack/bot-mentions.ts +315 -0
  109. package/src/channels/slack/channel-watch.test.ts +363 -0
  110. package/src/channels/slack/cursor-account.test.ts +253 -0
  111. package/src/channels/slack/defaults.final-post.test.ts +182 -0
  112. package/src/channels/slack/dispatch.test.ts +795 -0
  113. package/src/channels/slack/dispatch.ts +27 -1
  114. package/src/channels/slack/eval-directive.test.ts +273 -0
  115. package/src/channels/slack/inbound.ts +25 -4
  116. package/src/channels/slack/index.ts +1 -0
  117. package/src/channels/slack/message-body.test.ts +54 -0
  118. package/src/channels/slack/nudge-store.test.ts +143 -0
  119. package/src/channels/slack/slack-channel.ts +66 -8
  120. package/src/channels/slack/slack.test.ts +391 -0
  121. package/src/channels/slack/stop.test.ts +23 -0
  122. package/src/channels/slack/thread-context.test.ts +202 -0
  123. package/src/channels/slack/types.ts +60 -0
  124. package/src/evals/assertions.test.ts +580 -0
  125. package/src/evals/expect.test.ts +144 -0
  126. package/src/evals/judge.test.ts +181 -0
  127. package/src/evals/loaders.test.ts +132 -0
  128. package/src/evals/matchers.test.ts +95 -0
  129. package/src/evals/reporters.test.ts +303 -0
  130. package/src/evals/run-facts.test.ts +259 -0
  131. package/src/internal/ab-snapshot.test.ts +325 -0
  132. package/src/internal/approval-gate.test.ts +49 -0
  133. package/src/internal/approvals.integration.test.ts +383 -0
  134. package/src/internal/authored-loaders.test.ts +31 -0
  135. package/src/internal/builtin-tools/reminders.test.ts +201 -0
  136. package/src/internal/channel-route-schema.test.ts +294 -0
  137. package/src/internal/chat-attach.test.ts +262 -0
  138. package/src/internal/cli-deploy.test.ts +1991 -0
  139. package/src/internal/cli-mcp.test.ts +789 -0
  140. package/src/internal/cli-skills.test.ts +133 -0
  141. package/src/internal/cli-slack.test.ts +1647 -0
  142. package/src/internal/cloud-merge.test.ts +74 -0
  143. package/src/internal/cron.test.ts +22 -0
  144. package/src/internal/cursor/account-mcp.test.ts +807 -0
  145. package/src/internal/cursor/backend-client.test.ts +591 -0
  146. package/src/internal/cursor/credentials.test.ts +351 -0
  147. package/src/internal/cursor/github-credentials.test.ts +136 -0
  148. package/src/internal/cursor-account-mcp-auth.test.ts +310 -0
  149. package/src/internal/cursor-account.integration.test.ts +441 -0
  150. package/src/internal/cursor-event-relay.test.ts +746 -0
  151. package/src/internal/cursor-github-credentials.integration.test.ts +271 -0
  152. package/src/internal/cursor-slack-relay.test.ts +525 -0
  153. package/src/internal/deploy-source.test.ts +111 -0
  154. package/src/internal/discovery.builtin-tools.test.ts +94 -0
  155. package/src/internal/discovery.concurrency.test.ts +60 -0
  156. package/src/internal/discovery.cursor-account.test.ts +133 -0
  157. package/src/internal/discovery.cwd.test.ts +83 -0
  158. package/src/internal/discovery.hosting.test.ts +80 -0
  159. package/src/internal/discovery.identity.test.ts +44 -0
  160. package/src/internal/docs-site.test.ts +66 -0
  161. package/src/internal/duration.test.ts +29 -0
  162. package/src/internal/eval-judge-model.test.ts +187 -0
  163. package/src/internal/eval-run-store.cancel.test.ts +142 -0
  164. package/src/internal/eval-run-store.storage.test.ts +211 -0
  165. package/src/internal/eval-runner.http.test.ts +403 -0
  166. package/src/internal/eval-runner.run.test.ts +928 -0
  167. package/src/internal/evals-client.test.ts +307 -0
  168. package/src/internal/event-mapper.test.ts +243 -0
  169. package/src/internal/github-fanout.test.ts +213 -0
  170. package/src/internal/handleAgentServeTrigger.test.ts +179 -0
  171. package/src/internal/host-kv.test.ts +82 -0
  172. package/src/internal/host-platforms.test.ts +126 -0
  173. package/src/internal/http-channel.test.ts +402 -0
  174. package/src/internal/init-project.test.ts +269 -0
  175. package/src/internal/install-cursor-skills.test.ts +262 -0
  176. package/src/internal/local-env.test.ts +100 -0
  177. package/src/internal/log-ring.test.ts +31 -0
  178. package/src/internal/logs-client.test.ts +350 -0
  179. package/src/internal/mcp-endpoint.test.ts +436 -0
  180. package/src/internal/mcp-host.test.ts +298 -0
  181. package/src/internal/mcp-oauth.test.ts +148 -0
  182. package/src/internal/net.test.ts +17 -0
  183. package/src/internal/peer-connections.test.ts +128 -0
  184. package/src/internal/peer-mcp.integration.test.ts +289 -0
  185. package/src/internal/playground/toolchain.test.ts +53 -0
  186. package/src/internal/playground-cli.test.ts +187 -0
  187. package/src/internal/playground-proxy.test.ts +376 -0
  188. package/src/internal/prompt-context.integration.test.ts +232 -0
  189. package/src/internal/prompt-context.test.ts +127 -0
  190. package/src/internal/reminder-runner.test.ts +390 -0
  191. package/src/internal/reminder-store.test.ts +53 -0
  192. package/src/internal/request-headers.test.ts +27 -0
  193. package/src/internal/resolve-prod-target.test.ts +787 -0
  194. package/src/internal/resolved-connections.test.ts +295 -0
  195. package/src/internal/resolved-connections.ts +18 -1
  196. package/src/internal/router.test.ts +57 -0
  197. package/src/internal/sdk-runner.test.ts +290 -0
  198. package/src/internal/session-engine.coalesce.test.ts +169 -0
  199. package/src/internal/session-engine.concurrency.test.ts +250 -0
  200. package/src/internal/session-engine.host-oauth-mcp.test.ts +110 -0
  201. package/src/internal/session-engine.interrupt.test.ts +577 -0
  202. package/src/internal/session-engine.storage.test.ts +547 -0
  203. package/src/internal/session-engine.ts +15 -1
  204. package/src/internal/session-urls.test.ts +28 -0
  205. package/src/internal/sessions-client.test.ts +518 -0
  206. package/src/internal/storage-coordinator.test.ts +517 -0
  207. package/src/internal/tool-call.test.ts +458 -0
  208. package/src/internal/tool-result.test.ts +52 -0
  209. package/src/internal/trajectory.approvals.test.ts +83 -0
  210. package/src/internal/trajectory.subagents.test.ts +198 -0
  211. package/src/internal/turn-governor.test.ts +137 -0
  212. package/src/internal/update-check.test.ts +485 -0
  213. package/src/internal/workspace.test.ts +81 -0
  214. package/src/storage-backends/cursor-hosted.test.ts +121 -0
  215. package/src/types.ts +12 -0
  216. package/dist/docs/assets/chunks/@localSearchIndexroot.BnHRjfoe.js +0 -1
  217. package/dist/playground/assets/index-CidizGZv.css +0 -1
@@ -0,0 +1,350 @@
1
+ import { once } from "node:events";
2
+ import { createServer, type Server } from "node:http";
3
+ import type { AddressInfo } from "node:net";
4
+ import { afterEach, describe, expect, it } from "vitest";
5
+ import type { DeploymentDetail } from "./deploy-client.js";
6
+ import {
7
+ fetchLogs,
8
+ progressMessage,
9
+ runLogsTail,
10
+ sanitizeCustomerError,
11
+ } from "./logs-client.js";
12
+ import { PROD_ENGINE_WAKE_HEADERS } from "./resolve-prod-target.js";
13
+
14
+ interface StubLogsServer {
15
+ url: string;
16
+ close: () => Promise<void>;
17
+ requests: Array<{ after: string | null; headers: Record<string, string> }>;
18
+ setEntries: (
19
+ entries: Array<{ index: number; at: string; line: string }>
20
+ ) => void;
21
+ }
22
+
23
+ async function startStubLogsServer(): Promise<StubLogsServer> {
24
+ let entries: Array<{ index: number; at: string; line: string }> = [];
25
+ const requests: StubLogsServer["requests"] = [];
26
+ const server: Server = createServer((req, res) => {
27
+ const url = new URL(req.url ?? "/", "http://localhost");
28
+ if (req.method === "GET" && url.pathname === "/v1/logs") {
29
+ const headers: Record<string, string> = {};
30
+ for (const [key, value] of Object.entries(req.headers)) {
31
+ if (typeof value === "string") {
32
+ headers[key] = value;
33
+ }
34
+ }
35
+ requests.push({ after: url.searchParams.get("after"), headers });
36
+ const afterRaw = url.searchParams.get("after");
37
+ const after =
38
+ afterRaw === null || afterRaw === ""
39
+ ? -1
40
+ : Number.parseInt(afterRaw, 10);
41
+ const cursor = Number.isFinite(after) ? after : -1;
42
+ const batch = entries.filter((e) => e.index > cursor);
43
+ res.writeHead(200, { "content-type": "application/json" });
44
+ res.end(
45
+ JSON.stringify({
46
+ entries: batch,
47
+ nextAfter:
48
+ batch.length === 0
49
+ ? cursor
50
+ : (batch[batch.length - 1]?.index ?? cursor),
51
+ })
52
+ );
53
+ return;
54
+ }
55
+ res.writeHead(404);
56
+ res.end();
57
+ });
58
+ server.listen(0, "127.0.0.1");
59
+ await once(server, "listening");
60
+ const { port } = server.address() as AddressInfo;
61
+ return {
62
+ url: `http://127.0.0.1:${port}`,
63
+ requests,
64
+ setEntries: (next) => {
65
+ entries = next;
66
+ },
67
+ close: () =>
68
+ new Promise<void>((resolvePromise, reject) =>
69
+ server.close((error) => (error ? reject(error) : resolvePromise()))
70
+ ),
71
+ };
72
+ }
73
+
74
+ describe("sanitizeCustomerError / progressMessage", () => {
75
+ it("scrubs hosting URLs and jargon", () => {
76
+ expect(
77
+ sanitizeCustomerError(
78
+ "setup: https://foo.cursorvm.com/x pod-abc anyrun PROVISIONING"
79
+ )
80
+ ).not.toMatch(/cursorvm|anyrun|pod-abc|PROVISIONING/i);
81
+ });
82
+
83
+ it("rewrites git clone process names for customers", () => {
84
+ expect(
85
+ sanitizeCustomerError(
86
+ "setup: Process gitCloneCheckout failed with exit code 128"
87
+ )
88
+ ).toContain("git clone");
89
+ expect(
90
+ sanitizeCustomerError(
91
+ "setup: Process gitCloneCheckout failed with exit code 128"
92
+ )
93
+ ).not.toContain("gitCloneCheckout");
94
+ });
95
+
96
+ it("formats failed progress with sanitized lastError", () => {
97
+ expect(
98
+ progressMessage("failed", "setup: https://secret.example/fail")
99
+ ).toBe("Deploy failed: setup: [url]");
100
+ });
101
+
102
+ it("prefers statusMessage over the coarse progress vocabulary", () => {
103
+ expect(progressMessage("building", null, "Checking out source…")).toBe(
104
+ "Checking out source…"
105
+ );
106
+ expect(progressMessage("building", null, "Installing dependencies…")).toBe(
107
+ "Installing dependencies…"
108
+ );
109
+ });
110
+ });
111
+
112
+ describe("fetchLogs / runLogsTail", () => {
113
+ let stub: StubLogsServer;
114
+
115
+ afterEach(async () => {
116
+ await stub.close();
117
+ });
118
+
119
+ it("dumps current buffer with --once", async () => {
120
+ stub = await startStubLogsServer();
121
+ stub.setEntries([
122
+ { index: 0, at: "2026-07-17T00:00:00.000Z", line: "hello" },
123
+ { index: 1, at: "2026-07-17T00:00:01.000Z", line: "world" },
124
+ ]);
125
+ const out: string[] = [];
126
+ await runLogsTail({
127
+ dir: ".",
128
+ url: stub.url,
129
+ once: true,
130
+ write: (t) => out.push(t),
131
+ err: () => {},
132
+ });
133
+ expect(out.join("")).toBe("hello\nworld\n");
134
+ });
135
+
136
+ it("follows and advances the after cursor until aborted", async () => {
137
+ stub = await startStubLogsServer();
138
+ stub.setEntries([
139
+ { index: 0, at: "2026-07-17T00:00:00.000Z", line: "one" },
140
+ ]);
141
+ const out: string[] = [];
142
+ const controller = new AbortController();
143
+ let polls = 0;
144
+ await runLogsTail({
145
+ dir: ".",
146
+ url: stub.url,
147
+ write: (t) => out.push(t),
148
+ err: () => {},
149
+ signal: controller.signal,
150
+ intervalMs: 10,
151
+ sleep: async () => {
152
+ polls += 1;
153
+ if (polls === 1) {
154
+ stub.setEntries([
155
+ { index: 0, at: "2026-07-17T00:00:00.000Z", line: "one" },
156
+ { index: 1, at: "2026-07-17T00:00:01.000Z", line: "two" },
157
+ ]);
158
+ }
159
+ if (polls >= 2) {
160
+ controller.abort();
161
+ }
162
+ },
163
+ });
164
+ expect(out.join("")).toContain("one\n");
165
+ expect(out.join("")).toContain("two\n");
166
+ expect(stub.requests.some((r) => r.after === "0")).toBe(true);
167
+ });
168
+
169
+ it("prints --prod progress once without handing off when not running", async () => {
170
+ stub = await startStubLogsServer();
171
+ const out: string[] = [];
172
+ const err: string[] = [];
173
+ await runLogsTail({
174
+ prod: true,
175
+ dir: ".",
176
+ slug: "buddy",
177
+ once: true,
178
+ write: (t) => out.push(t),
179
+ err: (t) => err.push(t),
180
+ getDeployment: async () =>
181
+ ({
182
+ id: 1,
183
+ slug: "buddy",
184
+ teamId: 1,
185
+ deploymentKind: "repo",
186
+ status: "pending",
187
+ progress: "queued",
188
+ generation: 1,
189
+ engineAlias: "/alias",
190
+ lastError: null,
191
+ }) satisfies DeploymentDetail,
192
+ resolveRuntime: async () => ({ agentUrl: stub.url }),
193
+ });
194
+ expect(out.join("")).toBe("Waiting to start…\n");
195
+ expect(`${out.join("")}${err.join("")}`).not.toMatch(
196
+ /engine access|anyrun|cursorvm|PROVISIONING/i
197
+ );
198
+ });
199
+
200
+ it("follows --prod from building to runtime logs without leaking infra", async () => {
201
+ stub = await startStubLogsServer();
202
+ stub.setEntries([
203
+ { index: 0, at: "2026-07-17T00:00:00.000Z", line: "agent booted" },
204
+ ]);
205
+
206
+ const queue: DeploymentDetail[] = [
207
+ {
208
+ id: 1,
209
+ slug: "buddy",
210
+ teamId: 1,
211
+ deploymentKind: "repo",
212
+ status: "deploying",
213
+ progress: "building",
214
+ generation: 1,
215
+ engineAlias: "/alias",
216
+ lastError: null,
217
+ },
218
+ {
219
+ id: 1,
220
+ slug: "buddy",
221
+ teamId: 1,
222
+ deploymentKind: "repo",
223
+ status: "running",
224
+ progress: "running",
225
+ generation: 1,
226
+ engineAlias: "/alias",
227
+ lastError: null,
228
+ },
229
+ ];
230
+
231
+ const out: string[] = [];
232
+ const err: string[] = [];
233
+ const controller = new AbortController();
234
+ await runLogsTail({
235
+ prod: true,
236
+ dir: ".",
237
+ slug: "buddy",
238
+ write: (t) => out.push(t),
239
+ err: (t) => err.push(t),
240
+ signal: controller.signal,
241
+ getDeployment: async () => {
242
+ const next = queue.shift();
243
+ if (next === undefined) {
244
+ return {
245
+ id: 1,
246
+ slug: "buddy",
247
+ teamId: 1,
248
+ deploymentKind: "repo",
249
+ status: "running",
250
+ progress: "running",
251
+ generation: 1,
252
+ engineAlias: "/alias",
253
+ lastError: null,
254
+ };
255
+ }
256
+ return next;
257
+ },
258
+ resolveRuntime: async () => ({
259
+ agentUrl: stub.url,
260
+ headers: {
261
+ "x-anyrun-port-token": "port-tok",
262
+ ...PROD_ENGINE_WAKE_HEADERS,
263
+ },
264
+ }),
265
+ intervalMs: 1,
266
+ sleep: async () => {
267
+ if (out.some((line) => line.includes("agent booted"))) {
268
+ controller.abort();
269
+ }
270
+ },
271
+ });
272
+
273
+ const text = `${out.join("")}\n${err.join("")}`;
274
+ expect(out.join("")).toContain("Checking out source…");
275
+ expect(out.join("")).toContain("agent booted\n");
276
+ expect(out.join("")).not.toContain("Deployment running");
277
+ expect(text).not.toMatch(/engine access|anyrun|cursorvm|PROVISIONING/i);
278
+ expect(stub.requests[0]?.headers["x-anyrun-port-token"]).toBe("port-tok");
279
+ expect(
280
+ stub.requests[0]?.headers["x-anyrun-hibernation-lower-bound-s"]
281
+ ).toBe(PROD_ENGINE_WAKE_HEADERS["x-anyrun-hibernation-lower-bound-s"]);
282
+ });
283
+
284
+ it("fetchLogs returns entries", async () => {
285
+ stub = await startStubLogsServer();
286
+ stub.setEntries([{ index: 3, at: "2026-07-17T00:00:00.000Z", line: "x" }]);
287
+ const result = await fetchLogs({ baseUrl: stub.url, after: 2 });
288
+ expect(result.entries).toHaveLength(1);
289
+ expect(result.nextAfter).toBe(3);
290
+ });
291
+
292
+ it("emits NDJSON progress and log events with --json", async () => {
293
+ stub = await startStubLogsServer();
294
+ stub.setEntries([
295
+ { index: 0, at: "2026-07-17T00:00:00.000Z", line: "booted" },
296
+ ]);
297
+ const queue: DeploymentDetail[] = [
298
+ {
299
+ id: 1,
300
+ slug: "buddy",
301
+ teamId: 1,
302
+ deploymentKind: "repo",
303
+ status: "deploying",
304
+ progress: "building",
305
+ generation: 1,
306
+ engineAlias: "/alias",
307
+ lastError: null,
308
+ },
309
+ {
310
+ id: 1,
311
+ slug: "buddy",
312
+ teamId: 1,
313
+ deploymentKind: "repo",
314
+ status: "running",
315
+ progress: "running",
316
+ generation: 1,
317
+ engineAlias: "/alias",
318
+ lastError: null,
319
+ },
320
+ ];
321
+ const out: string[] = [];
322
+ const controller = new AbortController();
323
+ await runLogsTail({
324
+ prod: true,
325
+ dir: ".",
326
+ slug: "buddy",
327
+ json: true,
328
+ write: (t) => out.push(t),
329
+ err: () => {},
330
+ signal: controller.signal,
331
+ getDeployment: async () => queue.shift()!,
332
+ resolveRuntime: async () => ({ agentUrl: stub.url }),
333
+ intervalMs: 1,
334
+ sleep: async () => {
335
+ if (out.some((line) => line.includes('"type":"log"'))) {
336
+ controller.abort();
337
+ }
338
+ },
339
+ });
340
+ const events = out
341
+ .join("")
342
+ .trim()
343
+ .split("\n")
344
+ .map((line) => JSON.parse(line) as { type: string });
345
+ expect(events.some((e) => e.type === "progress")).toBe(true);
346
+ expect(events.some((e) => e.type === "log")).toBe(true);
347
+ expect(out.join("")).toContain('"progress":"building"');
348
+ expect(out.join("")).toContain('"line":"booted"');
349
+ });
350
+ });