@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,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
- });