@cursor/july 0.1.26 → 0.1.28

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 (324) 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 +43 -12
  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/auth.d.ts +13 -13
  17. package/dist/channels/slack/auth.d.ts.map +1 -1
  18. package/dist/channels/slack/auth.js +19 -10
  19. package/dist/channels/slack/cursor-account.d.ts +2 -1
  20. package/dist/channels/slack/cursor-account.d.ts.map +1 -1
  21. package/dist/channels/slack/cursor-account.js +3 -1
  22. package/dist/channels/slack/defaults.d.ts +7 -4
  23. package/dist/channels/slack/defaults.d.ts.map +1 -1
  24. package/dist/channels/slack/defaults.js +14 -4
  25. package/dist/channels/slack/dispatch.d.ts +10 -1
  26. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  27. package/dist/channels/slack/dispatch.js +59 -21
  28. package/dist/channels/slack/external-policy.d.ts +27 -0
  29. package/dist/channels/slack/external-policy.d.ts.map +1 -0
  30. package/dist/channels/slack/external-policy.js +53 -0
  31. package/dist/channels/slack/index.d.ts +1 -0
  32. package/dist/channels/slack/index.d.ts.map +1 -1
  33. package/dist/channels/slack/index.js +1 -0
  34. package/dist/channels/slack/interactive.d.ts +8 -1
  35. package/dist/channels/slack/interactive.d.ts.map +1 -1
  36. package/dist/channels/slack/interactive.js +43 -15
  37. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  38. package/dist/channels/slack/slack-channel.js +22 -8
  39. package/dist/channels/slack/types.d.ts +16 -1
  40. package/dist/channels/slack/types.d.ts.map +1 -1
  41. package/dist/docs/404.html +2 -2
  42. package/dist/docs/ab.html +3 -3
  43. package/dist/docs/assets/{app.DYcC9FY-.js → app.CqjrYaT2.js} +1 -1
  44. package/dist/docs/assets/chunks/@localSearchIndexroot.VWQoPFJ1.js +1 -0
  45. package/dist/docs/assets/chunks/{VPLocalSearchBox.o4N_knTV.js → VPLocalSearchBox.ag-MwUel.js} +1 -1
  46. package/dist/docs/assets/chunks/{theme.DQ-njyo0.js → theme.BS-DJWat.js} +2 -2
  47. package/dist/docs/assets/{guides_slack.md.D_xFKlnF.js → guides_slack.md.CjmJSvZS.js} +8 -4
  48. package/dist/docs/assets/guides_slack.md.CjmJSvZS.lean.js +1 -0
  49. package/dist/docs/assets/guides_webhooks.md.wSOYas3X.js +183 -0
  50. package/dist/docs/assets/{guides_webhooks.md.B1EswtUu.lean.js → guides_webhooks.md.wSOYas3X.lean.js} +1 -1
  51. package/dist/docs/assets/{index.md.Dfv5ic9t.js → index.md.CH_s5uZe.js} +1 -1
  52. package/dist/docs/assets/{reference_channels.md.DdmiKgqf.js → reference_channels.md.CDhTRfUz.js} +2 -2
  53. package/dist/docs/assets/{reference_channels.md.DdmiKgqf.lean.js → reference_channels.md.CDhTRfUz.lean.js} +1 -1
  54. package/dist/docs/building-with-agents.html +3 -3
  55. package/dist/docs/concepts.html +3 -3
  56. package/dist/docs/deployment.html +3 -3
  57. package/dist/docs/evals.html +3 -3
  58. package/dist/docs/example-agents/approval-buddy.html +3 -3
  59. package/dist/docs/example-agents/benny.html +3 -3
  60. package/dist/docs/example-agents/bugbot.html +3 -3
  61. package/dist/docs/example-agents/codebase-wiki.html +3 -3
  62. package/dist/docs/example-agents/codeowners-review.html +3 -3
  63. package/dist/docs/example-agents/concierge.html +3 -3
  64. package/dist/docs/example-agents/fsd.html +3 -3
  65. package/dist/docs/example-agents/index.html +3 -3
  66. package/dist/docs/example-agents/knowledge-base.html +3 -3
  67. package/dist/docs/example-agents/oncall.html +3 -3
  68. package/dist/docs/example-agents/security-reviewer.html +3 -3
  69. package/dist/docs/example-agents/slack-agent.html +3 -3
  70. package/dist/docs/example-agents/weather-agent.html +3 -3
  71. package/dist/docs/guides/agent-to-agent.html +3 -3
  72. package/dist/docs/guides/cloud-runtime.html +3 -3
  73. package/dist/docs/guides/github.html +3 -3
  74. package/dist/docs/guides/human-in-the-loop.html +3 -3
  75. package/dist/docs/guides/mcp-oauth.html +3 -3
  76. package/dist/docs/guides/slack.html +11 -7
  77. package/dist/docs/guides/webhooks.html +138 -5
  78. package/dist/docs/hashmap.json +1 -1
  79. package/dist/docs/hillclimbing.html +3 -3
  80. package/dist/docs/index.html +5 -5
  81. package/dist/docs/quickstart.html +3 -3
  82. package/dist/docs/reference/agent-config.html +3 -3
  83. package/dist/docs/reference/channels.html +5 -5
  84. package/dist/docs/reference/cli.html +3 -3
  85. package/dist/docs/reference/connections.html +3 -3
  86. package/dist/docs/reference/hooks.html +3 -3
  87. package/dist/docs/reference/http-api.html +3 -3
  88. package/dist/docs/reference/instructions.html +3 -3
  89. package/dist/docs/reference/playground.html +3 -3
  90. package/dist/docs/reference/project-layout.html +3 -3
  91. package/dist/docs/reference/prompt.html +3 -3
  92. package/dist/docs/reference/schedules.html +3 -3
  93. package/dist/docs/reference/sessions.html +3 -3
  94. package/dist/docs/reference/skills.html +3 -3
  95. package/dist/docs/reference/subagents.html +3 -3
  96. package/dist/docs/reference/tools.html +3 -3
  97. package/dist/docs/scaffolding-agents.html +3 -3
  98. package/dist/docs/storage.html +3 -3
  99. package/dist/docs/troubleshooting.html +3 -3
  100. package/dist/evals/assertions.d.ts +10 -1
  101. package/dist/evals/assertions.d.ts.map +1 -1
  102. package/dist/evals/assertions.js +12 -0
  103. package/dist/evals.d.ts +1 -1
  104. package/dist/evals.d.ts.map +1 -1
  105. package/dist/index.d.ts +1 -0
  106. package/dist/index.d.ts.map +1 -1
  107. package/dist/index.js +1 -0
  108. package/dist/internal/ab-fold.d.ts.map +1 -1
  109. package/dist/internal/ab-fold.js +4 -0
  110. package/dist/internal/ab-snapshot.d.ts.map +1 -1
  111. package/dist/internal/ab-snapshot.js +1 -0
  112. package/dist/internal/artifacts-store.d.ts +45 -0
  113. package/dist/internal/artifacts-store.d.ts.map +1 -0
  114. package/dist/internal/artifacts-store.js +250 -0
  115. package/dist/internal/builtin-tools/artifacts.d.ts +10 -0
  116. package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -0
  117. package/dist/internal/builtin-tools/artifacts.js +73 -0
  118. package/dist/internal/builtin-tools/index.d.ts +8 -1
  119. package/dist/internal/builtin-tools/index.d.ts.map +1 -1
  120. package/dist/internal/builtin-tools/index.js +15 -0
  121. package/dist/internal/cli-ax.d.ts +19 -0
  122. package/dist/internal/cli-ax.d.ts.map +1 -1
  123. package/dist/internal/cli-ax.js +196 -57
  124. package/dist/internal/cli-slack.d.ts.map +1 -1
  125. package/dist/internal/cli-slack.js +14 -6
  126. package/dist/internal/cursor-slack-relay.d.ts +2 -0
  127. package/dist/internal/cursor-slack-relay.d.ts.map +1 -1
  128. package/dist/internal/cursor-slack-relay.js +1 -0
  129. package/dist/internal/deploy-client.d.ts +2 -0
  130. package/dist/internal/deploy-client.d.ts.map +1 -1
  131. package/dist/internal/deploy-client.js +1 -0
  132. package/dist/internal/discovery.d.ts.map +1 -1
  133. package/dist/internal/discovery.js +91 -3
  134. package/dist/internal/distribution.d.ts.map +1 -1
  135. package/dist/internal/distribution.js +1 -0
  136. package/dist/internal/model-pricing.d.ts +49 -0
  137. package/dist/internal/model-pricing.d.ts.map +1 -0
  138. package/dist/internal/model-pricing.js +377 -0
  139. package/dist/internal/reminder-runner.d.ts.map +1 -1
  140. package/dist/internal/reminder-runner.js +1 -0
  141. package/dist/internal/schedule-runner.d.ts.map +1 -1
  142. package/dist/internal/schedule-runner.js +1 -0
  143. package/dist/internal/sdk-runner.d.ts.map +1 -1
  144. package/dist/internal/sdk-runner.js +9 -1
  145. package/dist/internal/server.d.ts.map +1 -1
  146. package/dist/internal/server.js +49 -5
  147. package/dist/internal/session-cost.d.ts +49 -0
  148. package/dist/internal/session-cost.d.ts.map +1 -0
  149. package/dist/internal/session-cost.js +175 -0
  150. package/dist/internal/session-engine.d.ts +35 -1
  151. package/dist/internal/session-engine.d.ts.map +1 -1
  152. package/dist/internal/session-engine.js +128 -7
  153. package/dist/internal/storage-coordinator.d.ts +15 -0
  154. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  155. package/dist/internal/storage-coordinator.js +52 -0
  156. package/dist/internal/trajectory.d.ts +9 -1
  157. package/dist/internal/trajectory.d.ts.map +1 -1
  158. package/dist/internal/trajectory.js +32 -5
  159. package/dist/playground/assets/index-Bul1WfrB.css +1 -0
  160. package/dist/playground/assets/index-CkN74U_L.js +87 -0
  161. package/dist/playground/index.html +2 -2
  162. package/dist/storage.d.ts +4 -0
  163. package/dist/storage.d.ts.map +1 -1
  164. package/dist/storage.js +4 -0
  165. package/dist/types.d.ts +164 -1
  166. package/dist/types.d.ts.map +1 -1
  167. package/docs/README.md +1 -0
  168. package/docs/guides/slack.md +32 -7
  169. package/docs/guides/webhooks.md +183 -0
  170. package/docs/reference/channels.md +2 -1
  171. package/package.json +26 -26
  172. package/skills/setup-slack/SKILL.md +3 -0
  173. package/src/ab.ts +7 -0
  174. package/src/bin/agent-serve.ts +42 -5
  175. package/src/channels/slack/auth.ts +29 -22
  176. package/src/channels/slack/cursor-account.ts +2 -0
  177. package/src/channels/slack/defaults.ts +24 -4
  178. package/src/channels/slack/dispatch.ts +42 -1
  179. package/src/channels/slack/external-policy.ts +62 -0
  180. package/src/channels/slack/index.ts +1 -0
  181. package/src/channels/slack/interactive.ts +42 -10
  182. package/src/channels/slack/slack-channel.ts +20 -3
  183. package/src/channels/slack/types.ts +12 -0
  184. package/src/internal/ab-fold.ts +4 -0
  185. package/src/internal/ab-snapshot.ts +1 -0
  186. package/src/internal/cli-ax.ts +205 -34
  187. package/src/internal/cursor-slack-relay.ts +3 -0
  188. package/src/internal/deploy-client.ts +3 -0
  189. package/src/internal/discovery.ts +8 -1
  190. package/src/internal/model-pricing.ts +426 -0
  191. package/src/internal/sdk-runner.ts +10 -2
  192. package/src/internal/server.ts +9 -5
  193. package/src/internal/session-cost.ts +231 -0
  194. package/src/internal/session-engine.ts +28 -0
  195. package/src/internal/trajectory.ts +45 -3
  196. package/src/types.ts +24 -1
  197. package/dist/channels/github/instrument.d.ts +0 -20
  198. package/dist/channels/github/instrument.d.ts.map +0 -1
  199. package/dist/docs/assets/chunks/@localSearchIndexroot.BQTzJjR_.js +0 -1
  200. package/dist/docs/assets/guides_slack.md.D_xFKlnF.lean.js +0 -1
  201. package/dist/docs/assets/guides_webhooks.md.B1EswtUu.js +0 -50
  202. package/dist/internal/json-dir-store.d.ts +0 -32
  203. package/dist/internal/json-dir-store.d.ts.map +0 -1
  204. package/dist/internal/json-dir-store.js +0 -100
  205. package/dist/playground/assets/index-CjOQ4hN9.css +0 -1
  206. package/dist/playground/assets/index-DqXdAFGa.js +0 -85
  207. package/src/bin/agent-serve.version.test.ts +0 -64
  208. package/src/channels/github/api.test.ts +0 -64
  209. package/src/channels/github/auth.test.ts +0 -105
  210. package/src/channels/github/cursor-account.test.ts +0 -204
  211. package/src/channels/github/forward.test.ts +0 -457
  212. package/src/channels/github/github.test.ts +0 -985
  213. package/src/channels/github/replay.test.ts +0 -179
  214. package/src/channels/slack/api.post-message.test.ts +0 -148
  215. package/src/channels/slack/approvals.test.ts +0 -328
  216. package/src/channels/slack/block-actions.test.ts +0 -469
  217. package/src/channels/slack/bot-mentions.test.ts +0 -267
  218. package/src/channels/slack/channel-watch.test.ts +0 -363
  219. package/src/channels/slack/cursor-account.test.ts +0 -301
  220. package/src/channels/slack/defaults.final-post.test.ts +0 -182
  221. package/src/channels/slack/dispatch.test.ts +0 -875
  222. package/src/channels/slack/eval-directive.test.ts +0 -273
  223. package/src/channels/slack/message-body.test.ts +0 -54
  224. package/src/channels/slack/nudge-store.test.ts +0 -143
  225. package/src/channels/slack/slack.test.ts +0 -391
  226. package/src/channels/slack/stop.test.ts +0 -23
  227. package/src/channels/slack/thread-context.test.ts +0 -202
  228. package/src/evals/assertions.test.ts +0 -617
  229. package/src/evals/expect.test.ts +0 -144
  230. package/src/evals/judge.test.ts +0 -181
  231. package/src/evals/loaders.test.ts +0 -132
  232. package/src/evals/matchers.test.ts +0 -95
  233. package/src/evals/reporters.test.ts +0 -303
  234. package/src/evals/run-facts.test.ts +0 -259
  235. package/src/internal/ab-snapshot.test.ts +0 -325
  236. package/src/internal/approval-gate.test.ts +0 -49
  237. package/src/internal/approvals.integration.test.ts +0 -383
  238. package/src/internal/artifacts-store.test.ts +0 -283
  239. package/src/internal/authored-loaders.test.ts +0 -31
  240. package/src/internal/builtin-tools/artifacts.test.ts +0 -247
  241. package/src/internal/builtin-tools/reminders.test.ts +0 -201
  242. package/src/internal/channel-route-schema.test.ts +0 -294
  243. package/src/internal/chat-attach.test.ts +0 -262
  244. package/src/internal/cli-deploy.test.ts +0 -1991
  245. package/src/internal/cli-docs.test.ts +0 -161
  246. package/src/internal/cli-mcp.test.ts +0 -789
  247. package/src/internal/cli-skills.test.ts +0 -133
  248. package/src/internal/cli-slack.test.ts +0 -1654
  249. package/src/internal/cloud-merge.test.ts +0 -74
  250. package/src/internal/cron.test.ts +0 -22
  251. package/src/internal/cursor/account-mcp.test.ts +0 -807
  252. package/src/internal/cursor/backend-client.test.ts +0 -591
  253. package/src/internal/cursor/credentials.test.ts +0 -351
  254. package/src/internal/cursor/github-credentials.test.ts +0 -136
  255. package/src/internal/cursor-account-mcp-auth.test.ts +0 -310
  256. package/src/internal/cursor-account.integration.test.ts +0 -441
  257. package/src/internal/cursor-event-relay.test.ts +0 -746
  258. package/src/internal/cursor-github-credentials.integration.test.ts +0 -271
  259. package/src/internal/cursor-slack-relay.test.ts +0 -525
  260. package/src/internal/deploy-source.test.ts +0 -111
  261. package/src/internal/discovery.artifact-tool.test.ts +0 -136
  262. package/src/internal/discovery.artifacts.test.ts +0 -119
  263. package/src/internal/discovery.builtin-tools.test.ts +0 -94
  264. package/src/internal/discovery.concurrency.test.ts +0 -60
  265. package/src/internal/discovery.cursor-account.test.ts +0 -133
  266. package/src/internal/discovery.cwd.test.ts +0 -83
  267. package/src/internal/discovery.hosting.test.ts +0 -80
  268. package/src/internal/discovery.identity.test.ts +0 -44
  269. package/src/internal/docs-site.test.ts +0 -66
  270. package/src/internal/duration.test.ts +0 -29
  271. package/src/internal/eval-judge-model.test.ts +0 -187
  272. package/src/internal/eval-run-store.cancel.test.ts +0 -142
  273. package/src/internal/eval-run-store.storage.test.ts +0 -211
  274. package/src/internal/eval-runner.http.test.ts +0 -403
  275. package/src/internal/eval-runner.run.test.ts +0 -928
  276. package/src/internal/evals-client.test.ts +0 -307
  277. package/src/internal/event-mapper.test.ts +0 -243
  278. package/src/internal/github-fanout.test.ts +0 -213
  279. package/src/internal/handleAgentServeTrigger.test.ts +0 -185
  280. package/src/internal/host-kv.test.ts +0 -82
  281. package/src/internal/host-platforms.test.ts +0 -126
  282. package/src/internal/http-channel.test.ts +0 -402
  283. package/src/internal/init-project.test.ts +0 -270
  284. package/src/internal/install-cursor-skills.test.ts +0 -262
  285. package/src/internal/local-env.test.ts +0 -120
  286. package/src/internal/log-ring.test.ts +0 -31
  287. package/src/internal/logs-client.test.ts +0 -350
  288. package/src/internal/mcp-endpoint.test.ts +0 -436
  289. package/src/internal/mcp-host.test.ts +0 -298
  290. package/src/internal/mcp-oauth.test.ts +0 -148
  291. package/src/internal/net.test.ts +0 -17
  292. package/src/internal/peer-connections.test.ts +0 -128
  293. package/src/internal/peer-mcp.integration.test.ts +0 -289
  294. package/src/internal/playground/toolchain.test.ts +0 -53
  295. package/src/internal/playground-cli.test.ts +0 -187
  296. package/src/internal/playground-proxy.test.ts +0 -376
  297. package/src/internal/prompt-context.integration.test.ts +0 -232
  298. package/src/internal/prompt-context.test.ts +0 -127
  299. package/src/internal/reminder-runner.test.ts +0 -432
  300. package/src/internal/reminder-store.test.ts +0 -53
  301. package/src/internal/request-headers.test.ts +0 -27
  302. package/src/internal/resolve-prod-target.test.ts +0 -787
  303. package/src/internal/resolved-connections.test.ts +0 -295
  304. package/src/internal/router.test.ts +0 -57
  305. package/src/internal/sdk-runner.test.ts +0 -290
  306. package/src/internal/server.artifacts.test.ts +0 -334
  307. package/src/internal/session-engine.artifacts.test.ts +0 -293
  308. package/src/internal/session-engine.coalesce.test.ts +0 -169
  309. package/src/internal/session-engine.concurrency.test.ts +0 -250
  310. package/src/internal/session-engine.host-oauth-mcp.test.ts +0 -110
  311. package/src/internal/session-engine.interrupt.test.ts +0 -577
  312. package/src/internal/session-engine.storage.test.ts +0 -547
  313. package/src/internal/session-urls.test.ts +0 -28
  314. package/src/internal/sessions-client.test.ts +0 -518
  315. package/src/internal/storage-coordinator.test.ts +0 -517
  316. package/src/internal/tool-call.test.ts +0 -458
  317. package/src/internal/tool-result.test.ts +0 -52
  318. package/src/internal/trajectory.approvals.test.ts +0 -83
  319. package/src/internal/trajectory.subagents.test.ts +0 -198
  320. package/src/internal/turn-governor.test.ts +0 -137
  321. package/src/internal/update-check.test.ts +0 -485
  322. package/src/internal/workspace.test.ts +0 -207
  323. package/src/storage-backends/cursor-hosted.test.ts +0 -121
  324. /package/dist/docs/assets/{index.md.Dfv5ic9t.lean.js → index.md.CH_s5uZe.lean.js} +0 -0
@@ -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
- });