@cursor/july 0.1.24 → 0.1.25

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 (195) hide show
  1. package/dist/bin/agent-serve.js +0 -0
  2. package/dist/channels/github/instrument.d.ts +20 -0
  3. package/dist/channels/github/instrument.d.ts.map +1 -0
  4. package/dist/docs/404.html +1 -1
  5. package/dist/docs/ab.html +2 -2
  6. package/dist/docs/assets/{app.CvSGaAxk.js → app.DYcC9FY-.js} +1 -1
  7. package/dist/docs/assets/chunks/@localSearchIndexroot.BQTzJjR_.js +1 -0
  8. package/dist/docs/assets/chunks/{VPLocalSearchBox.J1jJbCvs.js → VPLocalSearchBox.o4N_knTV.js} +1 -1
  9. package/dist/docs/assets/chunks/{theme.C7vfzr7h.js → theme.DQ-njyo0.js} +2 -2
  10. package/dist/docs/building-with-agents.html +2 -2
  11. package/dist/docs/concepts.html +2 -2
  12. package/dist/docs/deployment.html +2 -2
  13. package/dist/docs/evals.html +2 -2
  14. package/dist/docs/example-agents/approval-buddy.html +2 -2
  15. package/dist/docs/example-agents/benny.html +2 -2
  16. package/dist/docs/example-agents/bugbot.html +2 -2
  17. package/dist/docs/example-agents/codebase-wiki.html +2 -2
  18. package/dist/docs/example-agents/codeowners-review.html +2 -2
  19. package/dist/docs/example-agents/concierge.html +2 -2
  20. package/dist/docs/example-agents/fsd.html +2 -2
  21. package/dist/docs/example-agents/index.html +2 -2
  22. package/dist/docs/example-agents/knowledge-base.html +2 -2
  23. package/dist/docs/example-agents/oncall.html +2 -2
  24. package/dist/docs/example-agents/security-reviewer.html +2 -2
  25. package/dist/docs/example-agents/slack-agent.html +2 -2
  26. package/dist/docs/example-agents/weather-agent.html +2 -2
  27. package/dist/docs/guides/agent-to-agent.html +2 -2
  28. package/dist/docs/guides/cloud-runtime.html +2 -2
  29. package/dist/docs/guides/github.html +2 -2
  30. package/dist/docs/guides/human-in-the-loop.html +2 -2
  31. package/dist/docs/guides/mcp-oauth.html +2 -2
  32. package/dist/docs/guides/slack.html +2 -2
  33. package/dist/docs/guides/webhooks.html +2 -2
  34. package/dist/docs/hillclimbing.html +2 -2
  35. package/dist/docs/index.html +2 -2
  36. package/dist/docs/quickstart.html +2 -2
  37. package/dist/docs/reference/agent-config.html +2 -2
  38. package/dist/docs/reference/channels.html +2 -2
  39. package/dist/docs/reference/cli.html +2 -2
  40. package/dist/docs/reference/connections.html +2 -2
  41. package/dist/docs/reference/hooks.html +2 -2
  42. package/dist/docs/reference/http-api.html +2 -2
  43. package/dist/docs/reference/instructions.html +2 -2
  44. package/dist/docs/reference/playground.html +2 -2
  45. package/dist/docs/reference/project-layout.html +2 -2
  46. package/dist/docs/reference/prompt.html +2 -2
  47. package/dist/docs/reference/schedules.html +2 -2
  48. package/dist/docs/reference/sessions.html +2 -2
  49. package/dist/docs/reference/skills.html +2 -2
  50. package/dist/docs/reference/subagents.html +2 -2
  51. package/dist/docs/reference/tools.html +2 -2
  52. package/dist/docs/scaffolding-agents.html +2 -2
  53. package/dist/docs/storage.html +2 -2
  54. package/dist/docs/troubleshooting.html +2 -2
  55. package/dist/internal/json-dir-store.d.ts +32 -0
  56. package/dist/internal/json-dir-store.d.ts.map +1 -0
  57. package/dist/internal/json-dir-store.js +100 -0
  58. package/dist/playground/assets/index-CjOQ4hN9.css +1 -0
  59. package/dist/playground/assets/{index-DTG9OsPV.js → index-DqXdAFGa.js} +41 -41
  60. package/dist/playground/index.html +2 -2
  61. package/package.json +31 -24
  62. package/src/artifacts.ts +78 -0
  63. package/src/bin/agent-serve.version.test.ts +64 -0
  64. package/src/channels/github/api.test.ts +64 -0
  65. package/src/channels/github/auth.test.ts +105 -0
  66. package/src/channels/github/cursor-account.test.ts +204 -0
  67. package/src/channels/github/forward.test.ts +457 -0
  68. package/src/channels/github/github.test.ts +943 -0
  69. package/src/channels/github/replay.test.ts +179 -0
  70. package/src/channels/slack/api.post-message.test.ts +148 -0
  71. package/src/channels/slack/approvals.test.ts +328 -0
  72. package/src/channels/slack/block-actions.test.ts +452 -0
  73. package/src/channels/slack/bot-mentions.test.ts +267 -0
  74. package/src/channels/slack/channel-watch.test.ts +363 -0
  75. package/src/channels/slack/cursor-account.test.ts +253 -0
  76. package/src/channels/slack/defaults.final-post.test.ts +182 -0
  77. package/src/channels/slack/dispatch.test.ts +795 -0
  78. package/src/channels/slack/eval-directive.test.ts +273 -0
  79. package/src/channels/slack/message-body.test.ts +54 -0
  80. package/src/channels/slack/nudge-store.test.ts +143 -0
  81. package/src/channels/slack/slack.test.ts +391 -0
  82. package/src/channels/slack/stop.test.ts +23 -0
  83. package/src/channels/slack/thread-context.test.ts +202 -0
  84. package/src/evals/assertions.test.ts +617 -0
  85. package/src/evals/assertions.ts +37 -1
  86. package/src/evals/expect.test.ts +144 -0
  87. package/src/evals/judge.test.ts +181 -0
  88. package/src/evals/loaders.test.ts +132 -0
  89. package/src/evals/matchers.test.ts +95 -0
  90. package/src/evals/reporters.test.ts +303 -0
  91. package/src/evals/run-facts.test.ts +259 -0
  92. package/src/evals.ts +1 -0
  93. package/src/index.ts +1 -0
  94. package/src/internal/ab-snapshot.test.ts +325 -0
  95. package/src/internal/approval-gate.test.ts +49 -0
  96. package/src/internal/approvals.integration.test.ts +383 -0
  97. package/src/internal/artifacts-store.test.ts +283 -0
  98. package/src/internal/artifacts-store.ts +290 -0
  99. package/src/internal/authored-loaders.test.ts +31 -0
  100. package/src/internal/builtin-tools/artifacts.test.ts +247 -0
  101. package/src/internal/builtin-tools/artifacts.ts +74 -0
  102. package/src/internal/builtin-tools/index.ts +21 -0
  103. package/src/internal/builtin-tools/reminders.test.ts +201 -0
  104. package/src/internal/channel-route-schema.test.ts +294 -0
  105. package/src/internal/chat-attach.test.ts +262 -0
  106. package/src/internal/cli-deploy.test.ts +1991 -0
  107. package/src/internal/cli-docs.test.ts +161 -0
  108. package/src/internal/cli-mcp.test.ts +789 -0
  109. package/src/internal/cli-skills.test.ts +133 -0
  110. package/src/internal/cli-slack.test.ts +1654 -0
  111. package/src/internal/cli-slack.ts +13 -4
  112. package/src/internal/cloud-merge.test.ts +74 -0
  113. package/src/internal/cron.test.ts +22 -0
  114. package/src/internal/cursor/account-mcp.test.ts +807 -0
  115. package/src/internal/cursor/backend-client.test.ts +591 -0
  116. package/src/internal/cursor/credentials.test.ts +351 -0
  117. package/src/internal/cursor/github-credentials.test.ts +136 -0
  118. package/src/internal/cursor-account-mcp-auth.test.ts +310 -0
  119. package/src/internal/cursor-account.integration.test.ts +441 -0
  120. package/src/internal/cursor-event-relay.test.ts +746 -0
  121. package/src/internal/cursor-github-credentials.integration.test.ts +271 -0
  122. package/src/internal/cursor-slack-relay.test.ts +525 -0
  123. package/src/internal/deploy-source.test.ts +111 -0
  124. package/src/internal/discovery.artifact-tool.test.ts +136 -0
  125. package/src/internal/discovery.artifacts.test.ts +119 -0
  126. package/src/internal/discovery.builtin-tools.test.ts +94 -0
  127. package/src/internal/discovery.concurrency.test.ts +60 -0
  128. package/src/internal/discovery.cursor-account.test.ts +133 -0
  129. package/src/internal/discovery.cwd.test.ts +83 -0
  130. package/src/internal/discovery.hosting.test.ts +80 -0
  131. package/src/internal/discovery.identity.test.ts +44 -0
  132. package/src/internal/discovery.ts +102 -1
  133. package/src/internal/distribution.ts +1 -0
  134. package/src/internal/docs-site.test.ts +66 -0
  135. package/src/internal/duration.test.ts +29 -0
  136. package/src/internal/eval-judge-model.test.ts +187 -0
  137. package/src/internal/eval-run-store.cancel.test.ts +142 -0
  138. package/src/internal/eval-run-store.storage.test.ts +211 -0
  139. package/src/internal/eval-runner.http.test.ts +403 -0
  140. package/src/internal/eval-runner.run.test.ts +928 -0
  141. package/src/internal/evals-client.test.ts +307 -0
  142. package/src/internal/event-mapper.test.ts +243 -0
  143. package/src/internal/github-fanout.test.ts +213 -0
  144. package/src/internal/handleAgentServeTrigger.test.ts +185 -0
  145. package/src/internal/host-kv.test.ts +82 -0
  146. package/src/internal/host-platforms.test.ts +126 -0
  147. package/src/internal/http-channel.test.ts +402 -0
  148. package/src/internal/init-project.test.ts +270 -0
  149. package/src/internal/install-cursor-skills.test.ts +262 -0
  150. package/src/internal/local-env.test.ts +120 -0
  151. package/src/internal/log-ring.test.ts +31 -0
  152. package/src/internal/logs-client.test.ts +350 -0
  153. package/src/internal/mcp-endpoint.test.ts +436 -0
  154. package/src/internal/mcp-host.test.ts +298 -0
  155. package/src/internal/mcp-oauth.test.ts +148 -0
  156. package/src/internal/net.test.ts +17 -0
  157. package/src/internal/peer-connections.test.ts +128 -0
  158. package/src/internal/peer-mcp.integration.test.ts +289 -0
  159. package/src/internal/playground/toolchain.test.ts +53 -0
  160. package/src/internal/playground-cli.test.ts +187 -0
  161. package/src/internal/playground-proxy.test.ts +376 -0
  162. package/src/internal/prompt-context.integration.test.ts +232 -0
  163. package/src/internal/prompt-context.test.ts +127 -0
  164. package/src/internal/reminder-runner.test.ts +390 -0
  165. package/src/internal/reminder-store.test.ts +53 -0
  166. package/src/internal/request-headers.test.ts +27 -0
  167. package/src/internal/resolve-prod-target.test.ts +787 -0
  168. package/src/internal/resolved-connections.test.ts +295 -0
  169. package/src/internal/router.test.ts +57 -0
  170. package/src/internal/sdk-runner.test.ts +290 -0
  171. package/src/internal/server.artifacts.test.ts +303 -0
  172. package/src/internal/server.ts +43 -0
  173. package/src/internal/session-engine.artifacts.test.ts +243 -0
  174. package/src/internal/session-engine.coalesce.test.ts +169 -0
  175. package/src/internal/session-engine.concurrency.test.ts +250 -0
  176. package/src/internal/session-engine.host-oauth-mcp.test.ts +110 -0
  177. package/src/internal/session-engine.interrupt.test.ts +577 -0
  178. package/src/internal/session-engine.storage.test.ts +547 -0
  179. package/src/internal/session-engine.ts +125 -0
  180. package/src/internal/session-urls.test.ts +28 -0
  181. package/src/internal/sessions-client.test.ts +518 -0
  182. package/src/internal/storage-coordinator.test.ts +517 -0
  183. package/src/internal/storage-coordinator.ts +62 -0
  184. package/src/internal/tool-call.test.ts +458 -0
  185. package/src/internal/tool-result.test.ts +52 -0
  186. package/src/internal/trajectory.approvals.test.ts +83 -0
  187. package/src/internal/trajectory.subagents.test.ts +198 -0
  188. package/src/internal/turn-governor.test.ts +137 -0
  189. package/src/internal/update-check.test.ts +485 -0
  190. package/src/internal/workspace.test.ts +207 -0
  191. package/src/storage-backends/cursor-hosted.test.ts +121 -0
  192. package/src/storage.ts +6 -0
  193. package/src/types.ts +134 -1
  194. package/dist/docs/assets/chunks/@localSearchIndexroot.CL2Y0Zmh.js +0 -1
  195. package/dist/playground/assets/index-CidizGZv.css +0 -1
@@ -0,0 +1,262 @@
1
+ import { once } from "node:events";
2
+ import { createServer, type Server } from "node:http";
3
+ import type { AddressInfo } from "node:net";
4
+ import { afterEach, describe, expect, it, vi } from "vitest";
5
+ import { runChat } from "./chat-client.js";
6
+
7
+ interface StubAgent {
8
+ url: string;
9
+ close: () => Promise<void>;
10
+ followUps: Array<{ message: string; continuationToken: unknown }>;
11
+ }
12
+
13
+ async function startStub(opts: {
14
+ sessions: Array<{
15
+ sessionId: string;
16
+ continuationToken: string | null;
17
+ mode?: string;
18
+ }>;
19
+ events: unknown[];
20
+ }): Promise<StubAgent> {
21
+ const followUps: StubAgent["followUps"] = [];
22
+ const server: Server = createServer((req, res) => {
23
+ let raw = "";
24
+ req.on("data", (chunk: Buffer) => {
25
+ raw += chunk.toString("utf8");
26
+ });
27
+ req.on("end", () => {
28
+ const url = new URL(req.url ?? "/", "http://localhost");
29
+ const send = (status: number, body: unknown): void => {
30
+ res.writeHead(status, { "content-type": "application/json" });
31
+ res.end(JSON.stringify(body));
32
+ };
33
+ const sendNdjson = (lines: unknown[]): void => {
34
+ res.writeHead(200, { "content-type": "application/x-ndjson" });
35
+ res.end(`${lines.map((line) => JSON.stringify(line)).join("\n")}\n`);
36
+ };
37
+
38
+ if (req.method === "GET" && url.pathname === "/v1/health") {
39
+ send(200, { ok: true, name: "stub" });
40
+ return;
41
+ }
42
+ if (req.method === "GET" && url.pathname === "/v1/info") {
43
+ send(200, { name: "stub", model: "composer-2", tools: [] });
44
+ return;
45
+ }
46
+ if (req.method === "GET" && url.pathname === "/v1/sessions") {
47
+ send(200, { sessions: opts.sessions });
48
+ return;
49
+ }
50
+ if (
51
+ req.method === "GET" &&
52
+ url.pathname === "/v1/session/ses_attach/events"
53
+ ) {
54
+ if (url.searchParams.get("format") === "json") {
55
+ send(200, { events: opts.events });
56
+ return;
57
+ }
58
+ sendNdjson(opts.events);
59
+ return;
60
+ }
61
+ if (req.method === "POST" && url.pathname === "/v1/session/ses_attach") {
62
+ const body = JSON.parse(raw || "{}") as {
63
+ message?: string;
64
+ continuationToken?: string;
65
+ };
66
+ followUps.push({
67
+ message: body.message ?? "",
68
+ continuationToken: body.continuationToken,
69
+ });
70
+ send(200, {
71
+ ok: true,
72
+ sessionId: "ses_attach",
73
+ continuationToken: "http:rotated",
74
+ });
75
+ return;
76
+ }
77
+ if (
78
+ req.method === "GET" &&
79
+ url.pathname === "/v1/session/ses_attach/stream"
80
+ ) {
81
+ const start = Number(url.searchParams.get("startIndex") ?? "0");
82
+ sendNdjson([
83
+ {
84
+ index: start,
85
+ sessionId: "ses_attach",
86
+ turnId: "turn_2",
87
+ type: "turn.started",
88
+ data: {},
89
+ },
90
+ {
91
+ index: start + 1,
92
+ sessionId: "ses_attach",
93
+ turnId: "turn_2",
94
+ type: "message.completed",
95
+ data: { text: "follow-up reply", finishReason: "stop" },
96
+ },
97
+ {
98
+ index: start + 2,
99
+ sessionId: "ses_attach",
100
+ turnId: "turn_2",
101
+ type: "turn.completed",
102
+ data: { result: "follow-up reply" },
103
+ },
104
+ {
105
+ index: start + 3,
106
+ sessionId: "ses_attach",
107
+ type: "session.waiting",
108
+ data: {},
109
+ },
110
+ ]);
111
+ return;
112
+ }
113
+ send(404, { ok: false, error: "not_found" });
114
+ });
115
+ });
116
+
117
+ server.listen(0, "127.0.0.1");
118
+ await once(server, "listening");
119
+ const { port } = server.address() as AddressInfo;
120
+ return {
121
+ url: `http://127.0.0.1:${port}`,
122
+ followUps,
123
+ close: () =>
124
+ new Promise<void>((resolvePromise, reject) =>
125
+ server.close((error) => (error ? reject(error) : resolvePromise()))
126
+ ),
127
+ };
128
+ }
129
+
130
+ const priorEvents = [
131
+ {
132
+ index: 0,
133
+ sessionId: "ses_attach",
134
+ type: "session.started",
135
+ data: { channelId: "http" },
136
+ },
137
+ {
138
+ index: 1,
139
+ sessionId: "ses_attach",
140
+ turnId: "turn_1",
141
+ type: "message.received",
142
+ data: { text: "hello prior" },
143
+ },
144
+ {
145
+ index: 2,
146
+ sessionId: "ses_attach",
147
+ turnId: "turn_1",
148
+ type: "message.completed",
149
+ data: { text: "hi from prior turn", finishReason: "stop" },
150
+ },
151
+ {
152
+ index: 3,
153
+ sessionId: "ses_attach",
154
+ turnId: "turn_1",
155
+ type: "turn.completed",
156
+ data: { result: "hi from prior turn" },
157
+ },
158
+ {
159
+ index: 4,
160
+ sessionId: "ses_attach",
161
+ type: "session.waiting",
162
+ data: {},
163
+ },
164
+ ];
165
+
166
+ describe("chat --session reattach", () => {
167
+ let stub: StubAgent | undefined;
168
+ const writes: string[] = [];
169
+
170
+ afterEach(async () => {
171
+ await stub?.close();
172
+ stub = undefined;
173
+ writes.length = 0;
174
+ vi.restoreAllMocks();
175
+ });
176
+
177
+ it("looks up the continuation token and sends a follow-up", async () => {
178
+ stub = await startStub({
179
+ sessions: [
180
+ {
181
+ sessionId: "ses_attach",
182
+ continuationToken: "http:prior",
183
+ mode: "chat",
184
+ },
185
+ ],
186
+ events: priorEvents,
187
+ });
188
+
189
+ const stdoutWrite = vi.spyOn(process.stdout, "write").mockImplementation(((
190
+ chunk: string | Uint8Array
191
+ ) => {
192
+ writes.push(typeof chunk === "string" ? chunk : chunk.toString());
193
+ return true;
194
+ }) as typeof process.stdout.write);
195
+
196
+ await runChat({
197
+ baseUrl: stub.url,
198
+ sessionId: "ses_attach",
199
+ message: "follow up please",
200
+ oneShot: true,
201
+ noColor: true,
202
+ });
203
+
204
+ stdoutWrite.mockRestore();
205
+ const out = writes.join("");
206
+ expect(out).toContain("reattached ses_attach");
207
+ expect(out).toContain("hello prior");
208
+ expect(out).toContain("hi from prior turn");
209
+ expect(stub.followUps).toEqual([
210
+ { message: "follow up please", continuationToken: "http:prior" },
211
+ ]);
212
+ });
213
+
214
+ it("uses an explicit --continuation-token without listing", async () => {
215
+ stub = await startStub({
216
+ sessions: [], // empty — lookup would fail
217
+ events: priorEvents,
218
+ });
219
+
220
+ await runChat({
221
+ baseUrl: stub.url,
222
+ sessionId: "ses_attach",
223
+ continuationToken: "http:explicit",
224
+ message: "again",
225
+ oneShot: true,
226
+ noColor: true,
227
+ });
228
+
229
+ expect(stub.followUps).toEqual([
230
+ { message: "again", continuationToken: "http:explicit" },
231
+ ]);
232
+ });
233
+
234
+ it("fails when the session is missing from /v1/sessions", async () => {
235
+ stub = await startStub({ sessions: [], events: [] });
236
+ await expect(
237
+ runChat({
238
+ baseUrl: stub.url,
239
+ sessionId: "ses_missing",
240
+ oneShot: true,
241
+ noColor: true,
242
+ })
243
+ ).rejects.toThrow(/not found in \/v1\/sessions/);
244
+ });
245
+
246
+ it("fails when the session has no continuation token", async () => {
247
+ stub = await startStub({
248
+ sessions: [
249
+ { sessionId: "ses_attach", continuationToken: null, mode: "task" },
250
+ ],
251
+ events: [],
252
+ });
253
+ await expect(
254
+ runChat({
255
+ baseUrl: stub.url,
256
+ sessionId: "ses_attach",
257
+ oneShot: true,
258
+ noColor: true,
259
+ })
260
+ ).rejects.toThrow(/no continuation token.*task/);
261
+ });
262
+ });