@cursor/july 0.1.25 → 0.1.27

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 (288) hide show
  1. package/dist/ab.d.ts +6 -0
  2. package/dist/ab.d.ts.map +1 -1
  3. package/dist/ab.js +1 -0
  4. package/dist/artifacts.d.ts +34 -0
  5. package/dist/artifacts.d.ts.map +1 -0
  6. package/dist/artifacts.js +57 -0
  7. package/dist/bin/agent-serve.js +31 -9
  8. package/dist/channels/github/github-channel.d.ts +1 -1
  9. package/dist/channels/github/github-channel.d.ts.map +1 -1
  10. package/dist/channels/github/github-channel.js +14 -1
  11. package/dist/channels/github/types.d.ts +6 -1
  12. package/dist/channels/github/types.d.ts.map +1 -1
  13. package/dist/channels/slack/api.d.ts +2 -1
  14. package/dist/channels/slack/api.d.ts.map +1 -1
  15. package/dist/channels/slack/api.js +1 -0
  16. package/dist/channels/slack/cursor-account.d.ts +2 -1
  17. package/dist/channels/slack/cursor-account.d.ts.map +1 -1
  18. package/dist/channels/slack/cursor-account.js +1 -1
  19. package/dist/channels/slack/dispatch.d.ts +4 -1
  20. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  21. package/dist/channels/slack/dispatch.js +3 -3
  22. package/dist/channels/slack/interactive.d.ts +2 -1
  23. package/dist/channels/slack/interactive.d.ts.map +1 -1
  24. package/dist/channels/slack/interactive.js +1 -0
  25. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  26. package/dist/channels/slack/slack-channel.js +4 -3
  27. package/dist/channels/slack/types.d.ts +6 -1
  28. package/dist/channels/slack/types.d.ts.map +1 -1
  29. package/dist/docs/404.html +1 -1
  30. package/dist/docs/ab.html +2 -2
  31. package/dist/docs/assets/{app.DYcC9FY-.js → app.BICLoJYF.js} +1 -1
  32. package/dist/docs/assets/chunks/@localSearchIndexroot.CQJytDwU.js +1 -0
  33. package/dist/docs/assets/chunks/{VPLocalSearchBox.o4N_knTV.js → VPLocalSearchBox.wN4Ko9dT.js} +1 -1
  34. package/dist/docs/assets/chunks/{theme.DQ-njyo0.js → theme.dnnTE-Co.js} +2 -2
  35. package/dist/docs/building-with-agents.html +2 -2
  36. package/dist/docs/concepts.html +2 -2
  37. package/dist/docs/deployment.html +2 -2
  38. package/dist/docs/evals.html +2 -2
  39. package/dist/docs/example-agents/approval-buddy.html +2 -2
  40. package/dist/docs/example-agents/benny.html +2 -2
  41. package/dist/docs/example-agents/bugbot.html +2 -2
  42. package/dist/docs/example-agents/codebase-wiki.html +2 -2
  43. package/dist/docs/example-agents/codeowners-review.html +2 -2
  44. package/dist/docs/example-agents/concierge.html +2 -2
  45. package/dist/docs/example-agents/fsd.html +2 -2
  46. package/dist/docs/example-agents/index.html +2 -2
  47. package/dist/docs/example-agents/knowledge-base.html +2 -2
  48. package/dist/docs/example-agents/oncall.html +2 -2
  49. package/dist/docs/example-agents/security-reviewer.html +2 -2
  50. package/dist/docs/example-agents/slack-agent.html +2 -2
  51. package/dist/docs/example-agents/weather-agent.html +2 -2
  52. package/dist/docs/guides/agent-to-agent.html +2 -2
  53. package/dist/docs/guides/cloud-runtime.html +2 -2
  54. package/dist/docs/guides/github.html +2 -2
  55. package/dist/docs/guides/human-in-the-loop.html +2 -2
  56. package/dist/docs/guides/mcp-oauth.html +2 -2
  57. package/dist/docs/guides/slack.html +2 -2
  58. package/dist/docs/guides/webhooks.html +2 -2
  59. package/dist/docs/hillclimbing.html +2 -2
  60. package/dist/docs/index.html +2 -2
  61. package/dist/docs/quickstart.html +2 -2
  62. package/dist/docs/reference/agent-config.html +2 -2
  63. package/dist/docs/reference/channels.html +2 -2
  64. package/dist/docs/reference/cli.html +2 -2
  65. package/dist/docs/reference/connections.html +2 -2
  66. package/dist/docs/reference/hooks.html +2 -2
  67. package/dist/docs/reference/http-api.html +2 -2
  68. package/dist/docs/reference/instructions.html +2 -2
  69. package/dist/docs/reference/playground.html +2 -2
  70. package/dist/docs/reference/project-layout.html +2 -2
  71. package/dist/docs/reference/prompt.html +2 -2
  72. package/dist/docs/reference/schedules.html +2 -2
  73. package/dist/docs/reference/sessions.html +2 -2
  74. package/dist/docs/reference/skills.html +2 -2
  75. package/dist/docs/reference/subagents.html +2 -2
  76. package/dist/docs/reference/tools.html +2 -2
  77. package/dist/docs/scaffolding-agents.html +2 -2
  78. package/dist/docs/storage.html +2 -2
  79. package/dist/docs/troubleshooting.html +2 -2
  80. package/dist/evals/assertions.d.ts +10 -1
  81. package/dist/evals/assertions.d.ts.map +1 -1
  82. package/dist/evals/assertions.js +12 -0
  83. package/dist/evals.d.ts +1 -1
  84. package/dist/evals.d.ts.map +1 -1
  85. package/dist/index.d.ts +1 -0
  86. package/dist/index.d.ts.map +1 -1
  87. package/dist/index.js +1 -0
  88. package/dist/internal/ab-fold.d.ts.map +1 -1
  89. package/dist/internal/ab-fold.js +4 -0
  90. package/dist/internal/ab-snapshot.d.ts.map +1 -1
  91. package/dist/internal/ab-snapshot.js +1 -0
  92. package/dist/internal/artifacts-store.d.ts +45 -0
  93. package/dist/internal/artifacts-store.d.ts.map +1 -0
  94. package/dist/internal/artifacts-store.js +250 -0
  95. package/dist/internal/builtin-tools/artifacts.d.ts +10 -0
  96. package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -0
  97. package/dist/internal/builtin-tools/artifacts.js +73 -0
  98. package/dist/internal/builtin-tools/index.d.ts +8 -1
  99. package/dist/internal/builtin-tools/index.d.ts.map +1 -1
  100. package/dist/internal/builtin-tools/index.js +15 -0
  101. package/dist/internal/cli-ax.d.ts +11 -0
  102. package/dist/internal/cli-ax.d.ts.map +1 -1
  103. package/dist/internal/cli-ax.js +80 -0
  104. package/dist/internal/cli-slack.d.ts.map +1 -1
  105. package/dist/internal/cli-slack.js +14 -6
  106. package/dist/internal/discovery.d.ts.map +1 -1
  107. package/dist/internal/discovery.js +83 -2
  108. package/dist/internal/distribution.d.ts.map +1 -1
  109. package/dist/internal/distribution.js +1 -0
  110. package/dist/internal/model-pricing.d.ts +49 -0
  111. package/dist/internal/model-pricing.d.ts.map +1 -0
  112. package/dist/internal/model-pricing.js +377 -0
  113. package/dist/internal/reminder-runner.d.ts.map +1 -1
  114. package/dist/internal/reminder-runner.js +1 -0
  115. package/dist/internal/schedule-runner.d.ts.map +1 -1
  116. package/dist/internal/schedule-runner.js +1 -0
  117. package/dist/internal/sdk-runner.d.ts.map +1 -1
  118. package/dist/internal/sdk-runner.js +9 -1
  119. package/dist/internal/server.d.ts.map +1 -1
  120. package/dist/internal/server.js +39 -0
  121. package/dist/internal/session-cost.d.ts +49 -0
  122. package/dist/internal/session-cost.d.ts.map +1 -0
  123. package/dist/internal/session-cost.js +175 -0
  124. package/dist/internal/session-engine.d.ts +35 -1
  125. package/dist/internal/session-engine.d.ts.map +1 -1
  126. package/dist/internal/session-engine.js +128 -7
  127. package/dist/internal/storage-coordinator.d.ts +15 -0
  128. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  129. package/dist/internal/storage-coordinator.js +52 -0
  130. package/dist/internal/trajectory.d.ts +9 -1
  131. package/dist/internal/trajectory.d.ts.map +1 -1
  132. package/dist/internal/trajectory.js +32 -5
  133. package/dist/playground/assets/index-BDCeW4uc.js +86 -0
  134. package/dist/playground/assets/index-Bul1WfrB.css +1 -0
  135. package/dist/playground/index.html +2 -2
  136. package/dist/storage.d.ts +4 -0
  137. package/dist/storage.d.ts.map +1 -1
  138. package/dist/storage.js +4 -0
  139. package/dist/types.d.ts +164 -1
  140. package/dist/types.d.ts.map +1 -1
  141. package/package.json +26 -26
  142. package/src/ab.ts +7 -0
  143. package/src/bin/agent-serve.ts +30 -2
  144. package/src/channels/github/github-channel.ts +19 -2
  145. package/src/channels/github/types.ts +6 -0
  146. package/src/channels/slack/api.ts +3 -1
  147. package/src/channels/slack/cursor-account.ts +3 -1
  148. package/src/channels/slack/dispatch.ts +12 -1
  149. package/src/channels/slack/interactive.ts +3 -0
  150. package/src/channels/slack/slack-channel.ts +6 -0
  151. package/src/channels/slack/types.ts +6 -0
  152. package/src/internal/ab-fold.ts +4 -0
  153. package/src/internal/ab-snapshot.ts +1 -0
  154. package/src/internal/cli-ax.ts +95 -0
  155. package/src/internal/model-pricing.ts +426 -0
  156. package/src/internal/reminder-runner.ts +1 -0
  157. package/src/internal/schedule-runner.ts +1 -0
  158. package/src/internal/sdk-runner.ts +10 -2
  159. package/src/internal/server.ts +2 -0
  160. package/src/internal/session-cost.ts +231 -0
  161. package/src/internal/session-engine.ts +32 -1
  162. package/src/internal/trajectory.ts +45 -3
  163. package/src/types.ts +42 -2
  164. package/dist/channels/github/instrument.d.ts +0 -20
  165. package/dist/channels/github/instrument.d.ts.map +0 -1
  166. package/dist/docs/assets/chunks/@localSearchIndexroot.BQTzJjR_.js +0 -1
  167. package/dist/internal/json-dir-store.d.ts +0 -32
  168. package/dist/internal/json-dir-store.d.ts.map +0 -1
  169. package/dist/internal/json-dir-store.js +0 -100
  170. package/dist/playground/assets/index-CjOQ4hN9.css +0 -1
  171. package/dist/playground/assets/index-DqXdAFGa.js +0 -85
  172. package/src/bin/agent-serve.version.test.ts +0 -64
  173. package/src/channels/github/api.test.ts +0 -64
  174. package/src/channels/github/auth.test.ts +0 -105
  175. package/src/channels/github/cursor-account.test.ts +0 -204
  176. package/src/channels/github/forward.test.ts +0 -457
  177. package/src/channels/github/github.test.ts +0 -943
  178. package/src/channels/github/replay.test.ts +0 -179
  179. package/src/channels/slack/api.post-message.test.ts +0 -148
  180. package/src/channels/slack/approvals.test.ts +0 -328
  181. package/src/channels/slack/block-actions.test.ts +0 -452
  182. package/src/channels/slack/bot-mentions.test.ts +0 -267
  183. package/src/channels/slack/channel-watch.test.ts +0 -363
  184. package/src/channels/slack/cursor-account.test.ts +0 -253
  185. package/src/channels/slack/defaults.final-post.test.ts +0 -182
  186. package/src/channels/slack/dispatch.test.ts +0 -795
  187. package/src/channels/slack/eval-directive.test.ts +0 -273
  188. package/src/channels/slack/message-body.test.ts +0 -54
  189. package/src/channels/slack/nudge-store.test.ts +0 -143
  190. package/src/channels/slack/slack.test.ts +0 -391
  191. package/src/channels/slack/stop.test.ts +0 -23
  192. package/src/channels/slack/thread-context.test.ts +0 -202
  193. package/src/evals/assertions.test.ts +0 -617
  194. package/src/evals/expect.test.ts +0 -144
  195. package/src/evals/judge.test.ts +0 -181
  196. package/src/evals/loaders.test.ts +0 -132
  197. package/src/evals/matchers.test.ts +0 -95
  198. package/src/evals/reporters.test.ts +0 -303
  199. package/src/evals/run-facts.test.ts +0 -259
  200. package/src/internal/ab-snapshot.test.ts +0 -325
  201. package/src/internal/approval-gate.test.ts +0 -49
  202. package/src/internal/approvals.integration.test.ts +0 -383
  203. package/src/internal/artifacts-store.test.ts +0 -283
  204. package/src/internal/authored-loaders.test.ts +0 -31
  205. package/src/internal/builtin-tools/artifacts.test.ts +0 -247
  206. package/src/internal/builtin-tools/reminders.test.ts +0 -201
  207. package/src/internal/channel-route-schema.test.ts +0 -294
  208. package/src/internal/chat-attach.test.ts +0 -262
  209. package/src/internal/cli-deploy.test.ts +0 -1991
  210. package/src/internal/cli-docs.test.ts +0 -161
  211. package/src/internal/cli-mcp.test.ts +0 -789
  212. package/src/internal/cli-skills.test.ts +0 -133
  213. package/src/internal/cli-slack.test.ts +0 -1654
  214. package/src/internal/cloud-merge.test.ts +0 -74
  215. package/src/internal/cron.test.ts +0 -22
  216. package/src/internal/cursor/account-mcp.test.ts +0 -807
  217. package/src/internal/cursor/backend-client.test.ts +0 -591
  218. package/src/internal/cursor/credentials.test.ts +0 -351
  219. package/src/internal/cursor/github-credentials.test.ts +0 -136
  220. package/src/internal/cursor-account-mcp-auth.test.ts +0 -310
  221. package/src/internal/cursor-account.integration.test.ts +0 -441
  222. package/src/internal/cursor-event-relay.test.ts +0 -746
  223. package/src/internal/cursor-github-credentials.integration.test.ts +0 -271
  224. package/src/internal/cursor-slack-relay.test.ts +0 -525
  225. package/src/internal/deploy-source.test.ts +0 -111
  226. package/src/internal/discovery.artifact-tool.test.ts +0 -136
  227. package/src/internal/discovery.artifacts.test.ts +0 -119
  228. package/src/internal/discovery.builtin-tools.test.ts +0 -94
  229. package/src/internal/discovery.concurrency.test.ts +0 -60
  230. package/src/internal/discovery.cursor-account.test.ts +0 -133
  231. package/src/internal/discovery.cwd.test.ts +0 -83
  232. package/src/internal/discovery.hosting.test.ts +0 -80
  233. package/src/internal/discovery.identity.test.ts +0 -44
  234. package/src/internal/docs-site.test.ts +0 -66
  235. package/src/internal/duration.test.ts +0 -29
  236. package/src/internal/eval-judge-model.test.ts +0 -187
  237. package/src/internal/eval-run-store.cancel.test.ts +0 -142
  238. package/src/internal/eval-run-store.storage.test.ts +0 -211
  239. package/src/internal/eval-runner.http.test.ts +0 -403
  240. package/src/internal/eval-runner.run.test.ts +0 -928
  241. package/src/internal/evals-client.test.ts +0 -307
  242. package/src/internal/event-mapper.test.ts +0 -243
  243. package/src/internal/github-fanout.test.ts +0 -213
  244. package/src/internal/handleAgentServeTrigger.test.ts +0 -185
  245. package/src/internal/host-kv.test.ts +0 -82
  246. package/src/internal/host-platforms.test.ts +0 -126
  247. package/src/internal/http-channel.test.ts +0 -402
  248. package/src/internal/init-project.test.ts +0 -270
  249. package/src/internal/install-cursor-skills.test.ts +0 -262
  250. package/src/internal/local-env.test.ts +0 -120
  251. package/src/internal/log-ring.test.ts +0 -31
  252. package/src/internal/logs-client.test.ts +0 -350
  253. package/src/internal/mcp-endpoint.test.ts +0 -436
  254. package/src/internal/mcp-host.test.ts +0 -298
  255. package/src/internal/mcp-oauth.test.ts +0 -148
  256. package/src/internal/net.test.ts +0 -17
  257. package/src/internal/peer-connections.test.ts +0 -128
  258. package/src/internal/peer-mcp.integration.test.ts +0 -289
  259. package/src/internal/playground/toolchain.test.ts +0 -53
  260. package/src/internal/playground-cli.test.ts +0 -187
  261. package/src/internal/playground-proxy.test.ts +0 -376
  262. package/src/internal/prompt-context.integration.test.ts +0 -232
  263. package/src/internal/prompt-context.test.ts +0 -127
  264. package/src/internal/reminder-runner.test.ts +0 -390
  265. package/src/internal/reminder-store.test.ts +0 -53
  266. package/src/internal/request-headers.test.ts +0 -27
  267. package/src/internal/resolve-prod-target.test.ts +0 -787
  268. package/src/internal/resolved-connections.test.ts +0 -295
  269. package/src/internal/router.test.ts +0 -57
  270. package/src/internal/sdk-runner.test.ts +0 -290
  271. package/src/internal/server.artifacts.test.ts +0 -303
  272. package/src/internal/session-engine.artifacts.test.ts +0 -243
  273. package/src/internal/session-engine.coalesce.test.ts +0 -169
  274. package/src/internal/session-engine.concurrency.test.ts +0 -250
  275. package/src/internal/session-engine.host-oauth-mcp.test.ts +0 -110
  276. package/src/internal/session-engine.interrupt.test.ts +0 -577
  277. package/src/internal/session-engine.storage.test.ts +0 -547
  278. package/src/internal/session-urls.test.ts +0 -28
  279. package/src/internal/sessions-client.test.ts +0 -518
  280. package/src/internal/storage-coordinator.test.ts +0 -517
  281. package/src/internal/tool-call.test.ts +0 -458
  282. package/src/internal/tool-result.test.ts +0 -52
  283. package/src/internal/trajectory.approvals.test.ts +0 -83
  284. package/src/internal/trajectory.subagents.test.ts +0 -198
  285. package/src/internal/turn-governor.test.ts +0 -137
  286. package/src/internal/update-check.test.ts +0 -485
  287. package/src/internal/workspace.test.ts +0 -207
  288. package/src/storage-backends/cursor-hosted.test.ts +0 -121
@@ -1,518 +0,0 @@
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 { SessionSummary } from "../types.js";
6
- import { cmdChat, cmdResume, cmdSession, cmdSessions } from "./cli-ax.js";
7
- import { PROD_ENGINE_WAKE_HEADERS } from "./resolve-prod-target.js";
8
- import {
9
- fetchSessionEvents,
10
- formatSessionsTable,
11
- listSessions,
12
- listSessionsWithSource,
13
- pickPreviousSession,
14
- resolvePreviousSessionId,
15
- } from "./sessions-client.js";
16
-
17
- interface StubServer {
18
- url: string;
19
- close: () => Promise<void>;
20
- requests: Array<{ path: string; headers: Record<string, string> }>;
21
- }
22
-
23
- async function startStub(opts: {
24
- sessions?: unknown[];
25
- source?: "cursor-hosted" | "local";
26
- events?: unknown[];
27
- eventsStatus?: number;
28
- /** When set, follow-up POSTs + stream succeed for `chat --json --resume`. */
29
- acceptFollowUp?: boolean;
30
- }): Promise<StubServer> {
31
- const requests: StubServer["requests"] = [];
32
- const server: Server = createServer((req, res) => {
33
- const url = new URL(req.url ?? "/", "http://localhost");
34
- const headers: Record<string, string> = {};
35
- for (const [key, value] of Object.entries(req.headers)) {
36
- if (typeof value === "string") {
37
- headers[key] = value;
38
- }
39
- }
40
- requests.push({
41
- path: `${req.method} ${url.pathname}${url.search}`,
42
- headers,
43
- });
44
-
45
- const send = (status: number, body: unknown): void => {
46
- res.writeHead(status, { "content-type": "application/json" });
47
- res.end(JSON.stringify(body));
48
- };
49
- const sendNdjson = (lines: unknown[]): void => {
50
- res.writeHead(200, { "content-type": "application/x-ndjson" });
51
- res.end(`${lines.map((line) => JSON.stringify(line)).join("\n")}\n`);
52
- };
53
-
54
- if (req.method === "GET" && url.pathname === "/v1/sessions") {
55
- send(200, {
56
- sessions: opts.sessions ?? [],
57
- ...(opts.source === undefined ? {} : { source: opts.source }),
58
- });
59
- return;
60
- }
61
- if (
62
- req.method === "GET" &&
63
- url.pathname.startsWith("/v1/session/") &&
64
- url.pathname.endsWith("/events")
65
- ) {
66
- const status = opts.eventsStatus ?? 200;
67
- if (status !== 200) {
68
- send(status, { error: "nope" });
69
- return;
70
- }
71
- if (url.searchParams.get("format") === "json") {
72
- send(200, { sessionId: "ses_1", events: opts.events ?? [] });
73
- return;
74
- }
75
- sendNdjson(opts.events ?? []);
76
- return;
77
- }
78
- if (
79
- opts.acceptFollowUp === true &&
80
- req.method === "POST" &&
81
- /^\/v1\/session\/[^/]+$/.test(url.pathname)
82
- ) {
83
- const sessionId = url.pathname.split("/").pop() ?? "ses_unknown";
84
- req.resume();
85
- req.on("end", () => {
86
- send(200, {
87
- ok: true,
88
- sessionId,
89
- continuationToken: "http:tok",
90
- });
91
- });
92
- return;
93
- }
94
- if (
95
- opts.acceptFollowUp === true &&
96
- req.method === "GET" &&
97
- /^\/v1\/session\/[^/]+\/stream$/.test(url.pathname)
98
- ) {
99
- const sessionId = url.pathname.split("/")[3] ?? "ses_a";
100
- const start = Number(url.searchParams.get("startIndex") ?? "0");
101
- sendNdjson([
102
- {
103
- type: "turn.started",
104
- index: start,
105
- sessionId,
106
- turnId: "turn_resume",
107
- at: "2026-07-17T12:00:00.000Z",
108
- data: {},
109
- },
110
- {
111
- type: "message.completed",
112
- index: start + 1,
113
- sessionId,
114
- turnId: "turn_resume",
115
- at: "2026-07-17T12:00:01.000Z",
116
- data: { text: "resumed reply", finishReason: "stop" },
117
- },
118
- {
119
- type: "session.completed",
120
- index: start + 2,
121
- sessionId,
122
- at: "2026-07-17T12:00:02.000Z",
123
- data: {},
124
- },
125
- ]);
126
- return;
127
- }
128
- send(404, { error: "not found" });
129
- });
130
- server.listen(0, "127.0.0.1");
131
- await once(server, "listening");
132
- const { port } = server.address() as AddressInfo;
133
- return {
134
- url: `http://127.0.0.1:${port}`,
135
- requests,
136
- close: () =>
137
- new Promise<void>((resolvePromise, reject) =>
138
- server.close((error) => (error ? reject(error) : resolvePromise()))
139
- ),
140
- };
141
- }
142
-
143
- const sampleSessions = [
144
- {
145
- sessionId: "ses_a",
146
- channelId: "http",
147
- mode: "chat",
148
- turnCount: 2,
149
- running: false,
150
- createdAt: "2026-07-17T10:00:00.000Z",
151
- updatedAt: "2026-07-17T10:05:00.000Z",
152
- continuationToken: "http:tok",
153
- },
154
- {
155
- sessionId: "ses_b",
156
- channelId: "slack",
157
- mode: "task",
158
- turnCount: 1,
159
- running: true,
160
- createdAt: "2026-07-17T11:00:00.000Z",
161
- updatedAt: "2026-07-17T11:01:00.000Z",
162
- continuationToken: null,
163
- },
164
- ];
165
-
166
- const sampleEvents = [
167
- {
168
- type: "session.started",
169
- index: 0,
170
- sessionId: "ses_a",
171
- at: "2026-07-17T10:00:00.000Z",
172
- data: {},
173
- },
174
- {
175
- type: "message.received",
176
- index: 1,
177
- sessionId: "ses_a",
178
- at: "2026-07-17T10:00:01.000Z",
179
- turnId: "t1",
180
- data: { text: "hello", channelId: "http" },
181
- },
182
- {
183
- type: "message.completed",
184
- index: 2,
185
- sessionId: "ses_a",
186
- at: "2026-07-17T10:00:02.000Z",
187
- turnId: "t1",
188
- data: { text: "hi there", finishReason: "stop" },
189
- },
190
- {
191
- type: "turn.completed",
192
- index: 3,
193
- sessionId: "ses_a",
194
- at: "2026-07-17T10:00:03.000Z",
195
- turnId: "t1",
196
- data: {
197
- usage: { inputTokens: 1, outputTokens: 2 },
198
- },
199
- },
200
- ];
201
-
202
- describe("sessions-client", () => {
203
- let stub: StubServer | undefined;
204
-
205
- afterEach(async () => {
206
- await stub?.close();
207
- stub = undefined;
208
- });
209
-
210
- it("lists sessions", async () => {
211
- stub = await startStub({ sessions: sampleSessions });
212
- const sessions = await listSessions({ baseUrl: stub.url });
213
- expect(sessions).toHaveLength(2);
214
- expect(sessions[0]?.sessionId).toBe("ses_a");
215
- });
216
-
217
- it("formats a table", () => {
218
- const table = formatSessionsTable(sampleSessions as never);
219
- expect(table).toContain("ses_a");
220
- expect(table).toContain("slack");
221
- expect(table).toContain("SESSION");
222
- });
223
-
224
- it("fetches session events as JSON", async () => {
225
- stub = await startStub({ events: sampleEvents });
226
- const events = await fetchSessionEvents({
227
- baseUrl: stub.url,
228
- sessionId: "ses_a",
229
- });
230
- expect(events).toHaveLength(4);
231
- expect(stub.requests[0]?.path).toContain("format=json");
232
- });
233
- });
234
-
235
- describe("pickPreviousSession", () => {
236
- let stub: StubServer | undefined;
237
-
238
- afterEach(async () => {
239
- await stub?.close();
240
- stub = undefined;
241
- });
242
-
243
- it("picks the most recently updated followable session", () => {
244
- const sessions: SessionSummary[] = [
245
- {
246
- sessionId: "ses_old",
247
- channelId: "http",
248
- mode: "chat",
249
- turnCount: 1,
250
- running: false,
251
- createdAt: "2026-07-17T09:00:00.000Z",
252
- updatedAt: "2026-07-17T09:05:00.000Z",
253
- continuationToken: "http:old",
254
- },
255
- {
256
- sessionId: "ses_new",
257
- channelId: "http",
258
- mode: "chat",
259
- turnCount: 2,
260
- running: false,
261
- createdAt: "2026-07-17T10:00:00.000Z",
262
- updatedAt: "2026-07-17T12:00:00.000Z",
263
- continuationToken: "http:new",
264
- },
265
- {
266
- sessionId: "ses_task",
267
- channelId: "slack",
268
- mode: "task",
269
- turnCount: 1,
270
- running: false,
271
- createdAt: "2026-07-17T13:00:00.000Z",
272
- updatedAt: "2026-07-17T13:01:00.000Z",
273
- continuationToken: null,
274
- },
275
- ];
276
- expect(pickPreviousSession(sessions)?.sessionId).toBe("ses_new");
277
- });
278
-
279
- it("returns undefined when nothing is followable", () => {
280
- expect(pickPreviousSession([])).toBeUndefined();
281
- expect(
282
- pickPreviousSession([
283
- {
284
- sessionId: "ses_task",
285
- channelId: "slack",
286
- mode: "task",
287
- turnCount: 1,
288
- running: false,
289
- createdAt: "2026-07-17T13:00:00.000Z",
290
- updatedAt: "2026-07-17T13:01:00.000Z",
291
- continuationToken: null,
292
- },
293
- ])
294
- ).toBeUndefined();
295
- });
296
-
297
- it("resolvePreviousSessionId hits /v1/sessions", async () => {
298
- stub = await startStub({ sessions: sampleSessions });
299
- await expect(resolvePreviousSessionId({ baseUrl: stub.url })).resolves.toBe(
300
- "ses_a"
301
- );
302
- });
303
- });
304
-
305
- describe("cmdSessions / cmdSession", () => {
306
- let stub: StubServer;
307
- let stdoutWrite: typeof process.stdout.write;
308
- let stderrWrite: typeof process.stderr.write;
309
- let out: string;
310
- let err: string;
311
-
312
- const captureIo = (): void => {
313
- out = "";
314
- err = "";
315
- stdoutWrite = process.stdout.write.bind(process.stdout);
316
- stderrWrite = process.stderr.write.bind(process.stderr);
317
- process.stdout.write = ((chunk: string | Uint8Array) => {
318
- out += typeof chunk === "string" ? chunk : chunk.toString();
319
- return true;
320
- }) as typeof process.stdout.write;
321
- process.stderr.write = ((chunk: string | Uint8Array) => {
322
- err += typeof chunk === "string" ? chunk : chunk.toString();
323
- return true;
324
- }) as typeof process.stderr.write;
325
- };
326
-
327
- afterEach(async () => {
328
- process.stdout.write = stdoutWrite;
329
- process.stderr.write = stderrWrite;
330
- await stub.close();
331
- });
332
-
333
- it("prints a sessions table and JSON", async () => {
334
- stub = await startStub({
335
- sessions: sampleSessions,
336
- source: "cursor-hosted",
337
- });
338
- captureIo();
339
- const code = await cmdSessions({
340
- dir: ".",
341
- url: stub.url,
342
- });
343
- expect(code).toBe(0);
344
- expect(out).toContain("ses_a");
345
- expect(out).toContain("SESSION");
346
- expect(out).toContain("Listing from cursor-hosted storage (durable DB).");
347
-
348
- out = "";
349
- const jsonCode = await cmdSessions({
350
- dir: ".",
351
- url: stub.url,
352
- json: true,
353
- });
354
- expect(jsonCode).toBe(0);
355
- const parsed = JSON.parse(out) as {
356
- sessions: unknown[];
357
- source?: string;
358
- };
359
- expect(parsed.sessions).toHaveLength(2);
360
- expect(parsed.source).toBe("cursor-hosted");
361
- });
362
-
363
- it("surfaces local source when the server reports it", async () => {
364
- stub = await startStub({ sessions: [], source: "local" });
365
- captureIo();
366
- const code = await cmdSessions({ dir: ".", url: stub.url });
367
- expect(code).toBe(0);
368
- expect(out).toContain("Listing from local session store.");
369
- expect(out).toContain("No sessions.");
370
- await expect(
371
- listSessionsWithSource({ baseUrl: stub.url })
372
- ).resolves.toEqual({ sessions: [], source: "local" });
373
- });
374
-
375
- it("prints a session trajectory", async () => {
376
- stub = await startStub({ events: sampleEvents });
377
- captureIo();
378
- const code = await cmdSession("ses_a", { dir: ".", url: stub.url });
379
- expect(code).toBe(0);
380
- expect(out).toContain("hello");
381
- expect(out).toContain("hi there");
382
- });
383
-
384
- it("sends --prod headers and keeps customer output infra-free", async () => {
385
- stub = await startStub({ sessions: sampleSessions });
386
- captureIo();
387
- const sessions = await listSessions({
388
- baseUrl: stub.url,
389
- auth: {
390
- headers: {
391
- "x-anyrun-port-token": "port-tok",
392
- ...PROD_ENGINE_WAKE_HEADERS,
393
- },
394
- },
395
- });
396
- expect(sessions).toHaveLength(2);
397
- expect(stub.requests[0]?.headers["x-anyrun-port-token"]).toBe("port-tok");
398
-
399
- const code = await cmdSessions({ dir: ".", url: stub.url });
400
- expect(code).toBe(0);
401
- expect(`${out}${err}`).not.toMatch(/engine access|anyrun|cursorvm/i);
402
- });
403
-
404
- it("rejects missing session id", async () => {
405
- stub = await startStub({});
406
- captureIo();
407
- const code = await cmdSession(undefined, { dir: ".", url: stub.url });
408
- expect(code).toBe(2);
409
- expect(err).toContain("Usage:");
410
- });
411
- });
412
-
413
- describe("cmdResume / chat --resume", () => {
414
- let stub: StubServer | undefined;
415
- let stdoutWrite: typeof process.stdout.write;
416
- let stderrWrite: typeof process.stderr.write;
417
- let out: string;
418
- let err: string;
419
-
420
- const captureIo = (): void => {
421
- out = "";
422
- err = "";
423
- stdoutWrite = process.stdout.write.bind(process.stdout);
424
- stderrWrite = process.stderr.write.bind(process.stderr);
425
- process.stdout.write = ((chunk: string | Uint8Array) => {
426
- out += typeof chunk === "string" ? chunk : chunk.toString();
427
- return true;
428
- }) as typeof process.stdout.write;
429
- process.stderr.write = ((chunk: string | Uint8Array) => {
430
- err += typeof chunk === "string" ? chunk : chunk.toString();
431
- return true;
432
- }) as typeof process.stderr.write;
433
- };
434
-
435
- afterEach(async () => {
436
- process.stdout.write = stdoutWrite;
437
- process.stderr.write = stderrWrite;
438
- await stub?.close();
439
- stub = undefined;
440
- });
441
-
442
- it("errors when there is no previous followable session", async () => {
443
- stub = await startStub({ sessions: [] });
444
- captureIo();
445
- const code = await cmdResume(undefined, { dir: ".", url: stub.url });
446
- expect(code).toBe(1);
447
- expect(err).toContain("No previous followable session");
448
- });
449
-
450
- it("resumes the previous session without an id (json one-shot)", async () => {
451
- stub = await startStub({
452
- sessions: sampleSessions,
453
- acceptFollowUp: true,
454
- });
455
- captureIo();
456
- const code = await cmdResume(undefined, {
457
- dir: ".",
458
- url: stub.url,
459
- json: true,
460
- messages: ["continue"],
461
- });
462
- expect(code).toBe(0);
463
- // Only ses_a is followable in sampleSessions (ses_b has no token).
464
- expect(
465
- stub.requests.some((r) => r.path.startsWith("POST /v1/session/ses_a"))
466
- ).toBe(true);
467
- });
468
-
469
- it("chat --resume picks the previous session", async () => {
470
- stub = await startStub({
471
- sessions: [
472
- ...sampleSessions,
473
- {
474
- sessionId: "ses_newer",
475
- channelId: "http",
476
- mode: "chat",
477
- turnCount: 3,
478
- running: false,
479
- createdAt: "2026-07-17T12:00:00.000Z",
480
- updatedAt: "2026-07-17T14:00:00.000Z",
481
- continuationToken: "http:newer",
482
- },
483
- ],
484
- acceptFollowUp: true,
485
- });
486
- captureIo();
487
- const code = await cmdChat({
488
- dir: ".",
489
- url: stub.url,
490
- resume: true,
491
- json: true,
492
- messages: ["ping"],
493
- });
494
- expect(code).toBe(0);
495
- const followUp = stub.requests.find((r) =>
496
- r.path.startsWith("POST /v1/session/ses_newer")
497
- );
498
- expect(followUp).toBeDefined();
499
- });
500
-
501
- it("still accepts an explicit session id", async () => {
502
- stub = await startStub({
503
- sessions: sampleSessions,
504
- acceptFollowUp: true,
505
- });
506
- captureIo();
507
- const code = await cmdResume("ses_a", {
508
- dir: ".",
509
- url: stub.url,
510
- json: true,
511
- messages: ["hi again"],
512
- });
513
- expect(code).toBe(0);
514
- expect(
515
- stub.requests.some((r) => r.path.startsWith("POST /v1/session/ses_a"))
516
- ).toBe(true);
517
- });
518
- });