@cursor/july 0.1.22 → 0.1.24

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 (219) hide show
  1. package/README.md +5 -5
  2. package/dist/bin/agent-serve.d.ts +1 -0
  3. package/dist/bin/agent-serve.d.ts.map +1 -1
  4. package/dist/bin/agent-serve.js +21 -3
  5. package/dist/docs/404.html +2 -2
  6. package/dist/docs/ab.html +3 -3
  7. package/dist/docs/assets/{app.BKNKMLp4.js → app.CvSGaAxk.js} +1 -1
  8. package/dist/docs/assets/chunks/@localSearchIndexroot.CL2Y0Zmh.js +1 -0
  9. package/dist/docs/assets/chunks/{VPLocalSearchBox.sOSfEZR6.js → VPLocalSearchBox.J1jJbCvs.js} +1 -1
  10. package/dist/docs/assets/chunks/{theme.BvCHT5lj.js → theme.C7vfzr7h.js} +2 -2
  11. package/dist/docs/assets/index.md.Dfv5ic9t.js +20 -0
  12. package/dist/docs/assets/{index.md.t0TM2Qzz.lean.js → index.md.Dfv5ic9t.lean.js} +1 -1
  13. package/dist/docs/assets/{reference_cli.md.DnYfr5V2.js → reference_cli.md.ccoKOoXt.js} +4 -3
  14. package/dist/docs/assets/{reference_cli.md.DnYfr5V2.lean.js → reference_cli.md.ccoKOoXt.lean.js} +1 -1
  15. package/dist/docs/building-with-agents.html +3 -3
  16. package/dist/docs/concepts.html +3 -3
  17. package/dist/docs/deployment.html +3 -3
  18. package/dist/docs/evals.html +3 -3
  19. package/dist/docs/example-agents/approval-buddy.html +3 -3
  20. package/dist/docs/example-agents/benny.html +3 -3
  21. package/dist/docs/example-agents/bugbot.html +3 -3
  22. package/dist/docs/example-agents/codebase-wiki.html +3 -3
  23. package/dist/docs/example-agents/codeowners-review.html +3 -3
  24. package/dist/docs/example-agents/concierge.html +3 -3
  25. package/dist/docs/example-agents/fsd.html +3 -3
  26. package/dist/docs/example-agents/index.html +3 -3
  27. package/dist/docs/example-agents/knowledge-base.html +3 -3
  28. package/dist/docs/example-agents/oncall.html +3 -3
  29. package/dist/docs/example-agents/security-reviewer.html +3 -3
  30. package/dist/docs/example-agents/slack-agent.html +3 -3
  31. package/dist/docs/example-agents/weather-agent.html +3 -3
  32. package/dist/docs/guides/agent-to-agent.html +3 -3
  33. package/dist/docs/guides/cloud-runtime.html +3 -3
  34. package/dist/docs/guides/github.html +3 -3
  35. package/dist/docs/guides/human-in-the-loop.html +3 -3
  36. package/dist/docs/guides/mcp-oauth.html +3 -3
  37. package/dist/docs/guides/slack.html +3 -3
  38. package/dist/docs/guides/webhooks.html +3 -3
  39. package/dist/docs/hashmap.json +1 -1
  40. package/dist/docs/hillclimbing.html +3 -3
  41. package/dist/docs/index.html +6 -6
  42. package/dist/docs/quickstart.html +3 -3
  43. package/dist/docs/reference/agent-config.html +3 -3
  44. package/dist/docs/reference/channels.html +3 -3
  45. package/dist/docs/reference/cli.html +7 -6
  46. package/dist/docs/reference/connections.html +3 -3
  47. package/dist/docs/reference/hooks.html +3 -3
  48. package/dist/docs/reference/http-api.html +3 -3
  49. package/dist/docs/reference/instructions.html +3 -3
  50. package/dist/docs/reference/playground.html +3 -3
  51. package/dist/docs/reference/project-layout.html +3 -3
  52. package/dist/docs/reference/prompt.html +3 -3
  53. package/dist/docs/reference/schedules.html +3 -3
  54. package/dist/docs/reference/sessions.html +3 -3
  55. package/dist/docs/reference/skills.html +3 -3
  56. package/dist/docs/reference/subagents.html +3 -3
  57. package/dist/docs/reference/tools.html +3 -3
  58. package/dist/docs/scaffolding-agents.html +3 -3
  59. package/dist/docs/storage.html +3 -3
  60. package/dist/docs/troubleshooting.html +3 -3
  61. package/dist/index.d.ts +2 -0
  62. package/dist/index.d.ts.map +1 -1
  63. package/dist/index.js +1 -0
  64. package/dist/internal/cli-docs.d.ts +34 -0
  65. package/dist/internal/cli-docs.d.ts.map +1 -0
  66. package/dist/internal/cli-docs.js +162 -0
  67. package/dist/internal/distribution.d.ts +2 -1
  68. package/dist/internal/distribution.d.ts.map +1 -1
  69. package/dist/internal/distribution.js +3 -1
  70. package/dist/internal/docs-site.d.ts +4 -2
  71. package/dist/internal/docs-site.d.ts.map +1 -1
  72. package/dist/internal/docs-site.js +15 -11
  73. package/dist/internal/init-project.d.ts.map +1 -1
  74. package/dist/internal/init-project.js +19 -0
  75. package/dist/internal/session-engine.d.ts.map +1 -1
  76. package/dist/internal/session-engine.js +5 -0
  77. package/dist/internal/workspace.d.ts +9 -0
  78. package/dist/internal/workspace.d.ts.map +1 -1
  79. package/dist/internal/workspace.js +52 -5
  80. package/dist/memory.d.ts +79 -0
  81. package/dist/memory.d.ts.map +1 -0
  82. package/dist/memory.js +164 -0
  83. package/dist/playground/assets/index-CidizGZv.css +1 -0
  84. package/dist/playground/assets/index-DTG9OsPV.js +85 -0
  85. package/dist/playground/index.html +2 -2
  86. package/dist/types.d.ts +11 -0
  87. package/dist/types.d.ts.map +1 -1
  88. package/docs/README.md +8 -1
  89. package/docs/reference/cli.md +20 -4
  90. package/package.json +32 -24
  91. package/src/bin/agent-serve.ts +23 -3
  92. package/src/index.ts +2 -0
  93. package/src/internal/cli-docs.ts +191 -0
  94. package/src/internal/distribution.ts +3 -1
  95. package/src/internal/docs-site.ts +19 -11
  96. package/src/internal/init-project.ts +22 -0
  97. package/src/internal/session-engine.ts +5 -0
  98. package/src/internal/workspace.ts +81 -5
  99. package/src/memory.ts +215 -0
  100. package/src/types.ts +11 -0
  101. package/dist/channels/github/instrument.d.ts +0 -20
  102. package/dist/channels/github/instrument.d.ts.map +0 -1
  103. package/dist/docs/assets/chunks/@localSearchIndexroot.YFE6WoMB.js +0 -1
  104. package/dist/docs/assets/index.md.t0TM2Qzz.js +0 -20
  105. package/dist/internal/json-dir-store.d.ts +0 -32
  106. package/dist/internal/json-dir-store.d.ts.map +0 -1
  107. package/dist/internal/json-dir-store.js +0 -100
  108. package/dist/playground/assets/index-CjOQ4hN9.css +0 -1
  109. package/dist/playground/assets/index-dshZQJCp.js +0 -85
  110. package/src/bin/agent-serve.version.test.ts +0 -62
  111. package/src/channels/github/api.test.ts +0 -64
  112. package/src/channels/github/auth.test.ts +0 -105
  113. package/src/channels/github/cursor-account.test.ts +0 -204
  114. package/src/channels/github/forward.test.ts +0 -457
  115. package/src/channels/github/github.test.ts +0 -937
  116. package/src/channels/github/replay.test.ts +0 -179
  117. package/src/channels/slack/api.post-message.test.ts +0 -148
  118. package/src/channels/slack/approvals.test.ts +0 -328
  119. package/src/channels/slack/block-actions.test.ts +0 -452
  120. package/src/channels/slack/bot-mentions.test.ts +0 -267
  121. package/src/channels/slack/channel-watch.test.ts +0 -363
  122. package/src/channels/slack/cursor-account.test.ts +0 -253
  123. package/src/channels/slack/defaults.final-post.test.ts +0 -182
  124. package/src/channels/slack/dispatch.test.ts +0 -795
  125. package/src/channels/slack/eval-directive.test.ts +0 -273
  126. package/src/channels/slack/message-body.test.ts +0 -54
  127. package/src/channels/slack/nudge-store.test.ts +0 -143
  128. package/src/channels/slack/slack.test.ts +0 -391
  129. package/src/channels/slack/stop.test.ts +0 -23
  130. package/src/channels/slack/thread-context.test.ts +0 -202
  131. package/src/evals/assertions.test.ts +0 -580
  132. package/src/evals/expect.test.ts +0 -144
  133. package/src/evals/judge.test.ts +0 -181
  134. package/src/evals/loaders.test.ts +0 -132
  135. package/src/evals/matchers.test.ts +0 -95
  136. package/src/evals/reporters.test.ts +0 -303
  137. package/src/evals/run-facts.test.ts +0 -259
  138. package/src/internal/ab-snapshot.test.ts +0 -325
  139. package/src/internal/approval-gate.test.ts +0 -49
  140. package/src/internal/approvals.integration.test.ts +0 -383
  141. package/src/internal/authored-loaders.test.ts +0 -31
  142. package/src/internal/builtin-tools/reminders.test.ts +0 -201
  143. package/src/internal/channel-route-schema.test.ts +0 -294
  144. package/src/internal/chat-attach.test.ts +0 -262
  145. package/src/internal/cli-deploy.test.ts +0 -1991
  146. package/src/internal/cli-mcp.test.ts +0 -789
  147. package/src/internal/cli-skills.test.ts +0 -133
  148. package/src/internal/cli-slack.test.ts +0 -1647
  149. package/src/internal/cloud-merge.test.ts +0 -74
  150. package/src/internal/cron.test.ts +0 -22
  151. package/src/internal/cursor/account-mcp.test.ts +0 -807
  152. package/src/internal/cursor/backend-client.test.ts +0 -591
  153. package/src/internal/cursor/credentials.test.ts +0 -351
  154. package/src/internal/cursor/github-credentials.test.ts +0 -136
  155. package/src/internal/cursor-account-mcp-auth.test.ts +0 -310
  156. package/src/internal/cursor-account.integration.test.ts +0 -441
  157. package/src/internal/cursor-event-relay.test.ts +0 -746
  158. package/src/internal/cursor-github-credentials.integration.test.ts +0 -271
  159. package/src/internal/cursor-slack-relay.test.ts +0 -525
  160. package/src/internal/deploy-source.test.ts +0 -111
  161. package/src/internal/discovery.builtin-tools.test.ts +0 -94
  162. package/src/internal/discovery.concurrency.test.ts +0 -60
  163. package/src/internal/discovery.cursor-account.test.ts +0 -133
  164. package/src/internal/discovery.cwd.test.ts +0 -83
  165. package/src/internal/discovery.hosting.test.ts +0 -80
  166. package/src/internal/discovery.identity.test.ts +0 -44
  167. package/src/internal/docs-site.test.ts +0 -66
  168. package/src/internal/duration.test.ts +0 -29
  169. package/src/internal/eval-judge-model.test.ts +0 -187
  170. package/src/internal/eval-run-store.cancel.test.ts +0 -142
  171. package/src/internal/eval-run-store.storage.test.ts +0 -211
  172. package/src/internal/eval-runner.http.test.ts +0 -403
  173. package/src/internal/eval-runner.run.test.ts +0 -928
  174. package/src/internal/evals-client.test.ts +0 -307
  175. package/src/internal/event-mapper.test.ts +0 -243
  176. package/src/internal/github-fanout.test.ts +0 -213
  177. package/src/internal/handleAgentServeTrigger.test.ts +0 -179
  178. package/src/internal/host-kv.test.ts +0 -82
  179. package/src/internal/host-platforms.test.ts +0 -126
  180. package/src/internal/http-channel.test.ts +0 -402
  181. package/src/internal/init-project.test.ts +0 -269
  182. package/src/internal/install-cursor-skills.test.ts +0 -262
  183. package/src/internal/local-env.test.ts +0 -120
  184. package/src/internal/log-ring.test.ts +0 -31
  185. package/src/internal/logs-client.test.ts +0 -350
  186. package/src/internal/mcp-endpoint.test.ts +0 -436
  187. package/src/internal/mcp-host.test.ts +0 -298
  188. package/src/internal/mcp-oauth.test.ts +0 -148
  189. package/src/internal/net.test.ts +0 -17
  190. package/src/internal/peer-connections.test.ts +0 -128
  191. package/src/internal/peer-mcp.integration.test.ts +0 -289
  192. package/src/internal/playground/toolchain.test.ts +0 -53
  193. package/src/internal/playground-cli.test.ts +0 -187
  194. package/src/internal/playground-proxy.test.ts +0 -376
  195. package/src/internal/prompt-context.integration.test.ts +0 -232
  196. package/src/internal/prompt-context.test.ts +0 -127
  197. package/src/internal/reminder-runner.test.ts +0 -390
  198. package/src/internal/reminder-store.test.ts +0 -53
  199. package/src/internal/request-headers.test.ts +0 -27
  200. package/src/internal/resolve-prod-target.test.ts +0 -787
  201. package/src/internal/resolved-connections.test.ts +0 -295
  202. package/src/internal/router.test.ts +0 -57
  203. package/src/internal/sdk-runner.test.ts +0 -290
  204. package/src/internal/session-engine.coalesce.test.ts +0 -169
  205. package/src/internal/session-engine.concurrency.test.ts +0 -250
  206. package/src/internal/session-engine.host-oauth-mcp.test.ts +0 -110
  207. package/src/internal/session-engine.interrupt.test.ts +0 -577
  208. package/src/internal/session-engine.storage.test.ts +0 -547
  209. package/src/internal/session-urls.test.ts +0 -28
  210. package/src/internal/sessions-client.test.ts +0 -518
  211. package/src/internal/storage-coordinator.test.ts +0 -517
  212. package/src/internal/tool-call.test.ts +0 -458
  213. package/src/internal/tool-result.test.ts +0 -52
  214. package/src/internal/trajectory.approvals.test.ts +0 -83
  215. package/src/internal/trajectory.subagents.test.ts +0 -198
  216. package/src/internal/turn-governor.test.ts +0 -137
  217. package/src/internal/update-check.test.ts +0 -485
  218. package/src/internal/workspace.test.ts +0 -81
  219. 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,269 +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/instructions.md",
34
- "agent/lib/.gitkeep",
35
- "agent/mcp-connections/.gitkeep",
36
- "agent/sandbox/workspace/.gitkeep",
37
- "agent/schedules/.gitkeep",
38
- "agent/skills/.gitkeep",
39
- "agent/subagents/.gitkeep",
40
- "agent/tools/echo.ts",
41
- "evals/.gitkeep",
42
- "package.json",
43
- "tsconfig.json",
44
- ]);
45
- expect(result.skipped).toEqual([]);
46
- expect(result.files.every((entry) => entry.action === "create")).toBe(true);
47
-
48
- const agentTs = await readFile(join(target, "agent/agent.ts"), "utf8");
49
- expect(agentTs).toContain('id: "grok-4.5"');
50
- expect(agentTs).toContain('{ id: "effort", value: "high" }');
51
- expect(agentTs).toContain('{ id: "fast", value: "true" }');
52
- const echoTs = await readFile(join(target, "agent/tools/echo.ts"), "utf8");
53
- expect(echoTs).toContain("defineTool");
54
- });
55
-
56
- it("scaffolds a type-checkable project (tsconfig + typescript dev deps)", async () => {
57
- const target = join(dir, "typed");
58
- await initProject({ dir: target });
59
-
60
- const pkg = JSON.parse(
61
- await readFile(join(target, "package.json"), "utf8")
62
- ) as {
63
- scripts: Record<string, string>;
64
- devDependencies: Record<string, string>;
65
- };
66
- expect(pkg.scripts.check).toBe("tsc --noEmit");
67
- expect(pkg.devDependencies.typescript).toBeDefined();
68
- expect(pkg.devDependencies["@types/node"]).toBeDefined();
69
-
70
- // JSONC (tsc allows comments), so assert on content instead of parsing.
71
- const tsconfig = await readFile(join(target, "tsconfig.json"), "utf8");
72
- expect(tsconfig).toContain('"moduleResolution": "bundler"');
73
- expect(tsconfig).toContain('"strict": true');
74
- expect(tsconfig).toContain('"noEmit": true');
75
- expect(tsconfig).toContain('"include": ["agent/**/*", "evals/**/*"]');
76
- });
77
-
78
- it("honors name and model overrides", async () => {
79
- const target = join(dir, "custom");
80
- await initProject({ dir: target, name: "Custom Agent", model: "gpt-5.2" });
81
-
82
- const pkg = JSON.parse(
83
- await readFile(join(target, "package.json"), "utf8")
84
- ) as { name: string };
85
- expect(pkg.name).toBe("Custom Agent");
86
- const agentTs = await readFile(join(target, "agent/agent.ts"), "utf8");
87
- expect(agentTs).toContain('model: "gpt-5.2"');
88
- });
89
-
90
- it("skips existing files and fills in the missing ones", async () => {
91
- const target = join(dir, "twice");
92
- await initProject({ dir: target });
93
- await writeFile(
94
- join(target, "agent/instructions.md"),
95
- "# custom instructions\n",
96
- "utf8"
97
- );
98
-
99
- const second = await initProject({ dir: target });
100
- expect(second.created).toEqual([]);
101
- expect(second.skipped).toContain("agent/instructions.md");
102
- expect(second.skipped).toContain("agent/skills/.gitkeep");
103
- expect(second.skipped).toContain("evals/.gitkeep");
104
- expect(await readFile(join(target, "agent/instructions.md"), "utf8")).toBe(
105
- "# custom instructions\n"
106
- );
107
- });
108
-
109
- it("creates only the missing files when some already exist", async () => {
110
- const target = join(dir, "partial");
111
- await mkdir(target, { recursive: true });
112
- await writeFile(
113
- join(target, "package.json"),
114
- `${JSON.stringify({ name: "keep-me" }, null, 2)}\n`
115
- );
116
-
117
- const result = await initProject({ dir: target });
118
- expect(result.skipped).toEqual(["package.json"]);
119
- expect(result.created).toContain("agent/agent.ts");
120
- expect(result.created).toContain("tsconfig.json");
121
- expect(result.created).toContain("agent/lib/.gitkeep");
122
- expect(result.created).toContain("evals/.gitkeep");
123
- const pkg = JSON.parse(
124
- await readFile(join(target, "package.json"), "utf8")
125
- ) as { name: string };
126
- expect(pkg.name).toBe("keep-me");
127
- });
128
- });
129
-
130
- describe("installScaffoldDependencies", () => {
131
- it("runs npm install in the project directory", async () => {
132
- const calls: Array<{ command: string; args: string[]; cwd: string }> = [];
133
- const result = await installScaffoldDependencies("/tmp/agent", {
134
- stdio: "pipe",
135
- runner: async ({ command, args, cwd }) => {
136
- calls.push({ command, args, cwd });
137
- return { exitCode: 0, stderr: "" };
138
- },
139
- });
140
- expect(result.ok).toBe(true);
141
- expect(calls).toEqual([
142
- {
143
- command: process.platform === "win32" ? "npm.cmd" : "npm",
144
- args: ["install", "--no-fund", "--no-audit"],
145
- cwd: "/tmp/agent",
146
- },
147
- ]);
148
- });
149
-
150
- it("surfaces a failed install exit code", async () => {
151
- const result = await installScaffoldDependencies("/tmp/agent", {
152
- stdio: "pipe",
153
- runner: async () => ({ exitCode: 1, stderr: "boom" }),
154
- });
155
- expect(result).toEqual({ ok: false, exitCode: 1, stderr: "boom" });
156
- });
157
- });
158
-
159
- describe("formatInitSummary", () => {
160
- const files = [
161
- { path: "package.json", action: "create" as const },
162
- { path: "agent/agent.ts", action: "create" as const },
163
- { path: "agent/instructions.md", action: "exist" as const },
164
- { path: "agent/tools/echo.ts", action: "create" as const },
165
- ];
166
-
167
- it("lists created files, the project path, login, and dev", () => {
168
- const summary = formatInitSummary({
169
- rootDir: "/home/user/code/danny",
170
- files,
171
- cwd: "/home/user/code",
172
- signedIn: false,
173
- });
174
-
175
- expect(summary).toContain("Initialized agent danny");
176
- expect(summary).toContain("Project: /home/user/code/danny");
177
- expect(summary).toContain(" create package.json");
178
- expect(summary).toContain(" exist agent/instructions.md");
179
- expect(summary).not.toContain(".gitkeep");
180
- expect(summary).toContain("1. cd danny");
181
- expect(summary).toContain(`2. ${CLI_COMMAND_NAME} login`);
182
- expect(summary).toContain(`3. ${CLI_COMMAND_NAME} dev`);
183
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} dev danny`);
184
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} serve`);
185
- // Scaffold block comes before next steps (init prints them around login).
186
- expect(summary.indexOf("Project:")).toBeLessThan(
187
- summary.indexOf("Next steps:")
188
- );
189
- });
190
-
191
- it("omits .gitkeep placeholders from the printed file list", () => {
192
- const summary = formatInitSummary({
193
- rootDir: "/home/user/code/danny",
194
- files: [
195
- { path: "package.json", action: "create" },
196
- { path: "agent/skills/.gitkeep", action: "create" },
197
- { path: "evals/.gitkeep", action: "exist" },
198
- ],
199
- cwd: "/home/user/code",
200
- signedIn: true,
201
- });
202
-
203
- expect(summary).toContain(" create package.json");
204
- expect(summary).not.toContain("skills");
205
- expect(summary).not.toContain(".gitkeep");
206
- });
207
-
208
- it("skips the login step when a credential already resolves", () => {
209
- const summary = formatInitSummary({
210
- rootDir: "/home/user/code/danny",
211
- files,
212
- cwd: "/home/user/code",
213
- signedIn: true,
214
- });
215
-
216
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} login`);
217
- expect(summary).toContain("1. cd danny");
218
- expect(summary).toContain(`2. ${CLI_COMMAND_NAME} dev`);
219
- });
220
-
221
- it("omits cd when init ran inside the target directory", () => {
222
- const summary = formatInitSummary({
223
- rootDir: "/home/user/code/danny",
224
- files,
225
- cwd: "/home/user/code/danny",
226
- signedIn: false,
227
- });
228
-
229
- expect(summary).not.toContain("cd ");
230
- expect(summary).toContain(`1. ${CLI_COMMAND_NAME} login`);
231
- expect(summary).toMatch(
232
- new RegExp(`2\\. ${CLI_COMMAND_NAME} dev\\s+# start the local playground`)
233
- );
234
- });
235
-
236
- it("uses an absolute cd path for targets outside the cwd", () => {
237
- const summary = formatInitSummary({
238
- rootDir: "/srv/agents/danny",
239
- files,
240
- cwd: "/home/user/code",
241
- signedIn: true,
242
- });
243
-
244
- expect(summary).toContain("cd /srv/agents/danny");
245
- expect(summary).toContain(`${CLI_COMMAND_NAME} dev`);
246
- expect(summary).not.toContain(`${CLI_COMMAND_NAME} dev /`);
247
- });
248
-
249
- it("dims secondary scaffold and next-step note text when color is on", () => {
250
- const summary = formatInitSummary({
251
- rootDir: "/home/user/code/danny",
252
- files,
253
- cwd: "/home/user/code",
254
- signedIn: true,
255
- color: true,
256
- });
257
-
258
- expect(summary).toContain("\u001b[2m create package.json\u001b[0m");
259
- expect(summary).toContain(
260
- "\u001b[2mProject: /home/user/code/danny\u001b[0m"
261
- );
262
- expect(summary).toContain("\u001b[2m# start the local playground\u001b[0m");
263
- // Primary headings stay undimmed.
264
- expect(summary).toContain("Initialized agent danny");
265
- expect(summary).not.toContain("\u001b[2mInitialized agent danny\u001b[0m");
266
- expect(summary).toContain("Next steps:");
267
- expect(summary).not.toContain("\u001b[2mNext steps:\u001b[0m");
268
- });
269
- });