@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,402 +0,0 @@
1
- import { describe, expect, it, vi } from "vitest";
2
- import { httpChannel } from "../channels.js";
3
- import type { SessionRecord } from "../types.js";
4
- import { buildHttpChannelRoutes } from "./http-channel.js";
5
- import type { SessionEngine } from "./session-engine.js";
6
- import { HTTP_CHANNEL_ID } from "./session-engine.js";
7
-
8
- function sessionRecord(overrides: Partial<SessionRecord> = {}): SessionRecord {
9
- const now = new Date().toISOString();
10
- return {
11
- sessionId: "ses_test",
12
- channelId: HTTP_CHANNEL_ID,
13
- mode: "chat",
14
- continuationKey: "cont_key",
15
- auth: null,
16
- turnCount: 1,
17
- createdAt: now,
18
- updatedAt: now,
19
- ...overrides,
20
- };
21
- }
22
-
23
- describe("buildHttpChannelRoutes", () => {
24
- it("does not accept caller workspaceDir on POST /v1/session", async () => {
25
- const send = vi.fn(async () => ({
26
- id: "ses_test",
27
- continuationToken: "cont",
28
- isNew: true,
29
- waitForCompletion: async () => ({ status: "completed" as const }),
30
- }));
31
- const engine = { send } as unknown as SessionEngine;
32
- const createRoute = buildHttpChannelRoutes({
33
- engine,
34
- config: httpChannel(),
35
- auth: [],
36
- }).find(
37
- (route) => route.method === "POST" && route.pattern === "/v1/session"
38
- );
39
- expect(createRoute).toBeDefined();
40
-
41
- const response = await createRoute!.handler(
42
- new Request("http://127.0.0.1:3000/v1/session", {
43
- method: "POST",
44
- headers: { "content-type": "application/json" },
45
- body: JSON.stringify({
46
- message: "review",
47
- workspaceDir: "/tmp/attacker-chosen",
48
- workspaceFiles: { "pr/MANIFEST.md": "# evidence" },
49
- }),
50
- }),
51
- { auth: null, params: {}, requestIp: "127.0.0.1" }
52
- );
53
-
54
- expect(response.status).toBe(200);
55
- expect(send).toHaveBeenCalledWith(HTTP_CHANNEL_ID, "review", {
56
- auth: null,
57
- workspaceFiles: { "pr/MANIFEST.md": "# evidence" },
58
- });
59
- });
60
-
61
- it("forwards purpose:eval on POST /v1/session for the eval harness", async () => {
62
- const send = vi.fn(async () => ({
63
- id: "ses_eval",
64
- continuationToken: "cont",
65
- isNew: true,
66
- waitForCompletion: async () => ({ status: "completed" as const }),
67
- }));
68
- const engine = { send } as unknown as SessionEngine;
69
- const createRoute = buildHttpChannelRoutes({
70
- engine,
71
- config: httpChannel(),
72
- auth: [],
73
- }).find(
74
- (route) => route.method === "POST" && route.pattern === "/v1/session"
75
- );
76
- expect(createRoute).toBeDefined();
77
-
78
- const response = await createRoute!.handler(
79
- new Request("http://127.0.0.1:3000/v1/session", {
80
- method: "POST",
81
- headers: { "content-type": "application/json" },
82
- body: JSON.stringify({ message: "eval case", purpose: "eval" }),
83
- }),
84
- { auth: null, params: {}, requestIp: "127.0.0.1" }
85
- );
86
-
87
- expect(response.status).toBe(200);
88
- expect(send).toHaveBeenCalledWith(HTTP_CHANNEL_ID, "eval case", {
89
- auth: null,
90
- purpose: "eval",
91
- });
92
- });
93
-
94
- it("forwards per-session cloud options on POST /v1/session", async () => {
95
- const send = vi.fn(async () => ({
96
- id: "ses_cloud",
97
- continuationToken: "cont",
98
- isNew: true,
99
- waitForCompletion: async () => ({ status: "completed" as const }),
100
- }));
101
- const engine = { send } as unknown as SessionEngine;
102
- const createRoute = buildHttpChannelRoutes({
103
- engine,
104
- config: httpChannel(),
105
- auth: [],
106
- }).find(
107
- (route) => route.method === "POST" && route.pattern === "/v1/session"
108
- );
109
- expect(createRoute).toBeDefined();
110
-
111
- const cloud = {
112
- repos: [
113
- {
114
- url: "https://github.com/vercel-labs/deepsec",
115
- startingRef: "f75a16803ec5250938bacfe41571d929e8564f45",
116
- },
117
- ],
118
- autoCreatePR: false,
119
- };
120
- const response = await createRoute!.handler(
121
- new Request("http://127.0.0.1:3000/v1/session", {
122
- method: "POST",
123
- headers: { "content-type": "application/json" },
124
- body: JSON.stringify({
125
- message: "scan fixture",
126
- purpose: "eval",
127
- cloud,
128
- }),
129
- }),
130
- { auth: null, params: {}, requestIp: "127.0.0.1" }
131
- );
132
-
133
- expect(response.status).toBe(200);
134
- expect(send).toHaveBeenCalledWith(HTTP_CHANNEL_ID, "scan fixture", {
135
- auth: null,
136
- purpose: "eval",
137
- cloud,
138
- });
139
- });
140
-
141
- it("accepts playground follow-ups on non-http chat sessions", async () => {
142
- const record = sessionRecord({
143
- sessionId: "ses_drive",
144
- channelId: "drive",
145
- continuationKey: "drive_key",
146
- auth: {
147
- authenticator: "local-dev",
148
- principalId: "loopback",
149
- principalType: "runtime",
150
- },
151
- });
152
- const send = vi.fn(async () => ({
153
- id: record.sessionId,
154
- continuationToken: "drive_key",
155
- isNew: false,
156
- waitForCompletion: async () => ({ status: "completed" as const }),
157
- }));
158
- const setContinuationToken = vi.fn(async () => undefined);
159
- const engine = {
160
- send,
161
- setContinuationToken,
162
- getOrRestoreSession: vi.fn(async () => record),
163
- } as unknown as SessionEngine;
164
-
165
- const followUpRoute = buildHttpChannelRoutes({
166
- engine,
167
- config: httpChannel(),
168
- auth: [],
169
- relaxSessionReadAuth: true,
170
- }).find(
171
- (route) =>
172
- route.method === "POST" && route.pattern === "/v1/session/:sessionId"
173
- );
174
- expect(followUpRoute).toBeDefined();
175
-
176
- const response = await followUpRoute!.handler(
177
- new Request("http://127.0.0.1:3000/v1/session/ses_drive", {
178
- method: "POST",
179
- headers: { "content-type": "application/json" },
180
- body: JSON.stringify({
181
- message: "look again at CI",
182
- continuationToken: "drive:drive_key",
183
- }),
184
- }),
185
- {
186
- auth: null,
187
- params: { sessionId: "ses_drive" },
188
- requestIp: "127.0.0.1",
189
- }
190
- );
191
-
192
- expect(response.status).toBe(200);
193
- const body = (await response.json()) as {
194
- ok: boolean;
195
- continuationToken: string;
196
- };
197
- expect(body.ok).toBe(true);
198
- expect(body.continuationToken.startsWith("drive:")).toBe(true);
199
- expect(send).toHaveBeenCalledWith("drive", "look again at CI", {
200
- auth: record.auth,
201
- continuationToken: "drive_key",
202
- });
203
- expect(setContinuationToken).toHaveBeenCalledWith(
204
- "ses_drive",
205
- expect.any(String)
206
- );
207
- });
208
-
209
- it("rejects follow-ups on task sessions", async () => {
210
- const record = sessionRecord({
211
- mode: "task",
212
- channelId: "schedule",
213
- });
214
- const engine = {
215
- send: vi.fn(),
216
- getOrRestoreSession: vi.fn(async () => record),
217
- } as unknown as SessionEngine;
218
-
219
- const followUpRoute = buildHttpChannelRoutes({
220
- engine,
221
- config: httpChannel(),
222
- auth: [],
223
- relaxSessionReadAuth: true,
224
- }).find(
225
- (route) =>
226
- route.method === "POST" && route.pattern === "/v1/session/:sessionId"
227
- );
228
- expect(followUpRoute).toBeDefined();
229
-
230
- const response = await followUpRoute!.handler(
231
- new Request("http://127.0.0.1:3000/v1/session/ses_test", {
232
- method: "POST",
233
- headers: { "content-type": "application/json" },
234
- body: JSON.stringify({
235
- message: "ping",
236
- continuationToken: "schedule:cont_key",
237
- }),
238
- }),
239
- {
240
- auth: null,
241
- params: { sessionId: "ses_test" },
242
- requestIp: "127.0.0.1",
243
- }
244
- );
245
-
246
- expect(response.status).toBe(409);
247
- const body = (await response.json()) as { error: string };
248
- expect(body.error).toBe("session_not_followable");
249
- });
250
-
251
- it("stops an in-flight turn via POST /v1/session/:sessionId/stop", async () => {
252
- const record = sessionRecord();
253
- const interrupt = vi.fn(async () => true);
254
- const engine = {
255
- interrupt,
256
- getOrRestoreSession: vi.fn(async () => record),
257
- } as unknown as SessionEngine;
258
-
259
- const stopRoute = buildHttpChannelRoutes({
260
- engine,
261
- config: httpChannel(),
262
- auth: [],
263
- }).find(
264
- (route) =>
265
- route.method === "POST" &&
266
- route.pattern === "/v1/session/:sessionId/stop"
267
- );
268
- expect(stopRoute).toBeDefined();
269
-
270
- const response = await stopRoute!.handler(
271
- new Request("http://127.0.0.1:3000/v1/session/ses_test/stop", {
272
- method: "POST",
273
- }),
274
- {
275
- auth: null,
276
- params: { sessionId: "ses_test" },
277
- requestIp: "127.0.0.1",
278
- }
279
- );
280
-
281
- expect(response.status).toBe(200);
282
- const body = (await response.json()) as {
283
- ok: boolean;
284
- interrupted: boolean;
285
- };
286
- expect(body).toEqual({ ok: true, interrupted: true });
287
- expect(interrupt).toHaveBeenCalledWith("ses_test");
288
- });
289
-
290
- it("returns interrupted:false when stop finds no active turn", async () => {
291
- const record = sessionRecord();
292
- const interrupt = vi.fn(async () => false);
293
- const engine = {
294
- interrupt,
295
- getOrRestoreSession: vi.fn(async () => record),
296
- } as unknown as SessionEngine;
297
-
298
- const stopRoute = buildHttpChannelRoutes({
299
- engine,
300
- config: httpChannel(),
301
- auth: [],
302
- }).find(
303
- (route) =>
304
- route.method === "POST" &&
305
- route.pattern === "/v1/session/:sessionId/stop"
306
- );
307
- expect(stopRoute).toBeDefined();
308
-
309
- const response = await stopRoute!.handler(
310
- new Request("http://127.0.0.1:3000/v1/session/ses_test/stop", {
311
- method: "POST",
312
- }),
313
- {
314
- auth: null,
315
- params: { sessionId: "ses_test" },
316
- requestIp: "127.0.0.1",
317
- }
318
- );
319
-
320
- expect(response.status).toBe(200);
321
- expect(await response.json()).toEqual({ ok: true, interrupted: false });
322
- });
323
-
324
- it("lazy-restores by id before streaming events after redeploy", async () => {
325
- const record = sessionRecord({ sessionId: "ses_eval_trace" });
326
- const getOrRestoreSession = vi.fn(async () => record);
327
- const listEvents = vi.fn(async () => [
328
- {
329
- index: 0,
330
- sessionId: "ses_eval_trace",
331
- at: new Date().toISOString(),
332
- type: "session.started",
333
- data: {},
334
- },
335
- ]);
336
- const engine = {
337
- getOrRestoreSession,
338
- listEvents,
339
- } as unknown as SessionEngine;
340
-
341
- const eventsRoute = buildHttpChannelRoutes({
342
- engine,
343
- config: httpChannel(),
344
- auth: [],
345
- relaxSessionReadAuth: true,
346
- }).find(
347
- (route) =>
348
- route.method === "GET" &&
349
- route.pattern === "/v1/session/:sessionId/events"
350
- );
351
- expect(eventsRoute).toBeDefined();
352
-
353
- const response = await eventsRoute!.handler(
354
- new Request(
355
- "http://127.0.0.1:3000/v1/session/ses_eval_trace/events?format=json"
356
- ),
357
- {
358
- auth: null,
359
- params: { sessionId: "ses_eval_trace" },
360
- requestIp: "127.0.0.1",
361
- }
362
- );
363
-
364
- expect(response.status).toBe(200);
365
- expect(getOrRestoreSession).toHaveBeenCalledWith("ses_eval_trace");
366
- const body = (await response.json()) as {
367
- sessionId: string;
368
- events: unknown[];
369
- };
370
- expect(body.sessionId).toBe("ses_eval_trace");
371
- expect(body.events).toHaveLength(1);
372
- });
373
-
374
- it("allows cross-principal session reads for --allow-anonymous beyond loopback", async () => {
375
- const { requireSessionOwner } = await import("./http-channel.js");
376
- const record = sessionRecord({
377
- auth: {
378
- authenticator: "slack",
379
- principalId: "slack:T:C:1.0",
380
- principalType: "user",
381
- },
382
- });
383
- const caller = {
384
- authenticator: "allow-all",
385
- principalId: "anonymous",
386
- principalType: "user" as const,
387
- };
388
- expect(
389
- requireSessionOwner(record, caller, {
390
- relax: true,
391
- beyondLoopback: true,
392
- requestIp: "10.0.0.5",
393
- })
394
- ).toBeUndefined();
395
- const denied = requireSessionOwner(record, caller, {
396
- relax: true,
397
- beyondLoopback: false,
398
- requestIp: "10.0.0.5",
399
- });
400
- expect(denied?.status).toBe(403);
401
- });
402
- });
@@ -1,270 +0,0 @@
1
- import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import { afterEach, beforeEach, describe, expect, it } from "vitest";
5
- import { CLI_COMMAND_NAME } from "./distribution.js";
6
- import {
7
- formatInitSummary,
8
- initProject,
9
- installScaffoldDependencies,
10
- } from "./init-project.js";
11
-
12
- describe("initProject", () => {
13
- let dir: string;
14
-
15
- beforeEach(async () => {
16
- dir = await mkdtemp(join(tmpdir(), "agent-serve-init-"));
17
- });
18
-
19
- afterEach(async () => {
20
- await rm(dir, { recursive: true, force: true });
21
- });
22
-
23
- it("scaffolds a fresh directory, including nested tool files", async () => {
24
- const target = join(dir, "my-agent");
25
- const result = await initProject({ dir: target });
26
-
27
- expect(result.rootDir).toBe(target);
28
- expect(result.created.sort()).toEqual([
29
- "agent/ab/.gitkeep",
30
- "agent/agent.ts",
31
- "agent/channels/.gitkeep",
32
- "agent/hooks/.gitkeep",
33
- "agent/hooks/memory.ts",
34
- "agent/instructions.md",
35
- "agent/lib/.gitkeep",
36
- "agent/mcp-connections/.gitkeep",
37
- "agent/sandbox/workspace/.gitkeep",
38
- "agent/schedules/.gitkeep",
39
- "agent/skills/.gitkeep",
40
- "agent/subagents/.gitkeep",
41
- "agent/tools/echo.ts",
42
- "evals/.gitkeep",
43
- "package.json",
44
- "tsconfig.json",
45
- ]);
46
- expect(result.skipped).toEqual([]);
47
- expect(result.files.every((entry) => entry.action === "create")).toBe(true);
48
-
49
- const agentTs = await readFile(join(target, "agent/agent.ts"), "utf8");
50
- expect(agentTs).toContain('id: "grok-4.5"');
51
- expect(agentTs).toContain('{ id: "effort", value: "high" }');
52
- expect(agentTs).toContain('{ id: "fast", value: "true" }');
53
- const echoTs = await readFile(join(target, "agent/tools/echo.ts"), "utf8");
54
- expect(echoTs).toContain("defineTool");
55
- });
56
-
57
- it("scaffolds a type-checkable project (tsconfig + typescript dev deps)", async () => {
58
- const target = join(dir, "typed");
59
- await initProject({ dir: target });
60
-
61
- const pkg = JSON.parse(
62
- await readFile(join(target, "package.json"), "utf8")
63
- ) as {
64
- scripts: Record<string, string>;
65
- devDependencies: Record<string, string>;
66
- };
67
- expect(pkg.scripts.check).toBe("tsc --noEmit");
68
- expect(pkg.devDependencies.typescript).toBeDefined();
69
- expect(pkg.devDependencies["@types/node"]).toBeDefined();
70
-
71
- // JSONC (tsc allows comments), so assert on content instead of parsing.
72
- const tsconfig = await readFile(join(target, "tsconfig.json"), "utf8");
73
- expect(tsconfig).toContain('"moduleResolution": "bundler"');
74
- expect(tsconfig).toContain('"strict": true');
75
- expect(tsconfig).toContain('"noEmit": true');
76
- expect(tsconfig).toContain('"include": ["agent/**/*", "evals/**/*"]');
77
- });
78
-
79
- it("honors name and model overrides", async () => {
80
- const target = join(dir, "custom");
81
- await initProject({ dir: target, name: "Custom Agent", model: "gpt-5.2" });
82
-
83
- const pkg = JSON.parse(
84
- await readFile(join(target, "package.json"), "utf8")
85
- ) as { name: string };
86
- expect(pkg.name).toBe("Custom Agent");
87
- const agentTs = await readFile(join(target, "agent/agent.ts"), "utf8");
88
- expect(agentTs).toContain('model: "gpt-5.2"');
89
- });
90
-
91
- it("skips existing files and fills in the missing ones", async () => {
92
- const target = join(dir, "twice");
93
- await initProject({ dir: target });
94
- await writeFile(
95
- join(target, "agent/instructions.md"),
96
- "# custom instructions\n",
97
- "utf8"
98
- );
99
-
100
- const second = await initProject({ dir: target });
101
- expect(second.created).toEqual([]);
102
- expect(second.skipped).toContain("agent/instructions.md");
103
- expect(second.skipped).toContain("agent/skills/.gitkeep");
104
- expect(second.skipped).toContain("evals/.gitkeep");
105
- expect(await readFile(join(target, "agent/instructions.md"), "utf8")).toBe(
106
- "# custom instructions\n"
107
- );
108
- });
109
-
110
- it("creates only the missing files when some already exist", async () => {
111
- const target = join(dir, "partial");
112
- await mkdir(target, { recursive: true });
113
- await writeFile(
114
- join(target, "package.json"),
115
- `${JSON.stringify({ name: "keep-me" }, null, 2)}\n`
116
- );
117
-
118
- const result = await initProject({ dir: target });
119
- expect(result.skipped).toEqual(["package.json"]);
120
- expect(result.created).toContain("agent/agent.ts");
121
- expect(result.created).toContain("tsconfig.json");
122
- expect(result.created).toContain("agent/lib/.gitkeep");
123
- expect(result.created).toContain("evals/.gitkeep");
124
- const pkg = JSON.parse(
125
- await readFile(join(target, "package.json"), "utf8")
126
- ) as { name: string };
127
- expect(pkg.name).toBe("keep-me");
128
- });
129
- });
130
-
131
- describe("installScaffoldDependencies", () => {
132
- it("runs npm install in the project directory", async () => {
133
- const calls: Array<{ command: string; args: string[]; cwd: string }> = [];
134
- const result = await installScaffoldDependencies("/tmp/agent", {
135
- stdio: "pipe",
136
- runner: async ({ command, args, cwd }) => {
137
- calls.push({ command, args, cwd });
138
- return { exitCode: 0, stderr: "" };
139
- },
140
- });
141
- expect(result.ok).toBe(true);
142
- expect(calls).toEqual([
143
- {
144
- command: process.platform === "win32" ? "npm.cmd" : "npm",
145
- args: ["install", "--no-fund", "--no-audit"],
146
- cwd: "/tmp/agent",
147
- },
148
- ]);
149
- });
150
-
151
- it("surfaces a failed install exit code", async () => {
152
- const result = await installScaffoldDependencies("/tmp/agent", {
153
- stdio: "pipe",
154
- runner: async () => ({ exitCode: 1, stderr: "boom" }),
155
- });
156
- expect(result).toEqual({ ok: false, exitCode: 1, stderr: "boom" });
157
- });
158
- });
159
-
160
- describe("formatInitSummary", () => {
161
- const files = [
162
- { path: "package.json", action: "create" as const },
163
- { path: "agent/agent.ts", action: "create" as const },
164
- { path: "agent/instructions.md", action: "exist" as const },
165
- { path: "agent/tools/echo.ts", action: "create" as const },
166
- ];
167
-
168
- it("lists created files, the project path, login, and dev", () => {
169
- const summary = formatInitSummary({
170
- rootDir: "/home/user/code/danny",
171
- files,
172
- cwd: "/home/user/code",
173
- signedIn: false,
174
- });
175
-
176
- expect(summary).toContain("Initialized agent danny");
177
- expect(summary).toContain("Project: /home/user/code/danny");
178
- expect(summary).toContain(" create package.json");
179
- expect(summary).toContain(" exist agent/instructions.md");
180
- expect(summary).not.toContain(".gitkeep");
181
- expect(summary).toContain("1. cd danny");
182
- expect(summary).toContain(`2. ${CLI_COMMAND_NAME} login`);
183
- expect(summary).toContain(`3. ${CLI_COMMAND_NAME} dev`);
184
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} dev danny`);
185
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} serve`);
186
- // Scaffold block comes before next steps (init prints them around login).
187
- expect(summary.indexOf("Project:")).toBeLessThan(
188
- summary.indexOf("Next steps:")
189
- );
190
- });
191
-
192
- it("omits .gitkeep placeholders from the printed file list", () => {
193
- const summary = formatInitSummary({
194
- rootDir: "/home/user/code/danny",
195
- files: [
196
- { path: "package.json", action: "create" },
197
- { path: "agent/skills/.gitkeep", action: "create" },
198
- { path: "evals/.gitkeep", action: "exist" },
199
- ],
200
- cwd: "/home/user/code",
201
- signedIn: true,
202
- });
203
-
204
- expect(summary).toContain(" create package.json");
205
- expect(summary).not.toContain("skills");
206
- expect(summary).not.toContain(".gitkeep");
207
- });
208
-
209
- it("skips the login step when a credential already resolves", () => {
210
- const summary = formatInitSummary({
211
- rootDir: "/home/user/code/danny",
212
- files,
213
- cwd: "/home/user/code",
214
- signedIn: true,
215
- });
216
-
217
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} login`);
218
- expect(summary).toContain("1. cd danny");
219
- expect(summary).toContain(`2. ${CLI_COMMAND_NAME} dev`);
220
- });
221
-
222
- it("omits cd when init ran inside the target directory", () => {
223
- const summary = formatInitSummary({
224
- rootDir: "/home/user/code/danny",
225
- files,
226
- cwd: "/home/user/code/danny",
227
- signedIn: false,
228
- });
229
-
230
- expect(summary).not.toContain("cd ");
231
- expect(summary).toContain(`1. ${CLI_COMMAND_NAME} login`);
232
- expect(summary).toMatch(
233
- new RegExp(`2\\. ${CLI_COMMAND_NAME} dev\\s+# start the local playground`)
234
- );
235
- });
236
-
237
- it("uses an absolute cd path for targets outside the cwd", () => {
238
- const summary = formatInitSummary({
239
- rootDir: "/srv/agents/danny",
240
- files,
241
- cwd: "/home/user/code",
242
- signedIn: true,
243
- });
244
-
245
- expect(summary).toContain("cd /srv/agents/danny");
246
- expect(summary).toContain(`${CLI_COMMAND_NAME} dev`);
247
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} dev /`);
248
- });
249
-
250
- it("dims secondary scaffold and next-step note text when color is on", () => {
251
- const summary = formatInitSummary({
252
- rootDir: "/home/user/code/danny",
253
- files,
254
- cwd: "/home/user/code",
255
- signedIn: true,
256
- color: true,
257
- });
258
-
259
- expect(summary).toContain("\u001b[2m create package.json\u001b[0m");
260
- expect(summary).toContain(
261
- "\u001b[2mProject: /home/user/code/danny\u001b[0m"
262
- );
263
- expect(summary).toContain("\u001b[2m# start the local playground\u001b[0m");
264
- // Primary headings stay undimmed.
265
- expect(summary).toContain("Initialized agent danny");
266
- expect(summary).not.toContain("\u001b[2mInitialized agent danny\u001b[0m");
267
- expect(summary).toContain("Next steps:");
268
- expect(summary).not.toContain("\u001b[2mNext steps:\u001b[0m");
269
- });
270
- });