@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,294 +0,0 @@
1
- import { mkdtemp, rm } from "node:fs/promises";
2
- import { tmpdir } from "node:os";
3
- import { join } from "node:path";
4
- import { afterEach, describe, expect, it } from "vitest";
5
- import { z } from "zod";
6
- import { defineChannel, GET, httpChannel, POST } from "../channels.js";
7
- import type { AgentProject } from "../types.js";
8
- import { projectInfo } from "./discovery.js";
9
- import { toolInputJsonSchema, validateToolInput } from "./json-schema.js";
10
- import { type AgentMount, startServer } from "./server.js";
11
-
12
- const cleanups: Array<() => Promise<void>> = [];
13
-
14
- afterEach(async () => {
15
- while (cleanups.length > 0) {
16
- const cleanup = cleanups.pop();
17
- if (cleanup !== undefined) await cleanup();
18
- }
19
- });
20
-
21
- describe("channel route schemas", () => {
22
- it("requires bodySchema on POST and querySchema on GET", () => {
23
- const bodySchema = z.object({ pr: z.string() });
24
- const querySchema = z.object({ status: z.string().optional() });
25
- const channel = defineChannel({
26
- routes: [
27
- POST("/", {
28
- description: "start",
29
- bodySchema,
30
- handler: async () => Response.json({ ok: true }),
31
- }),
32
- GET("/findings", {
33
- querySchema,
34
- handler: async () => Response.json({ ok: true }),
35
- }),
36
- ],
37
- });
38
-
39
- const post = channel.routes?.[0];
40
- const get = channel.routes?.[1];
41
- expect(post?.method).toBe("POST");
42
- expect(post?.description).toBe("start");
43
- expect(post?.bodySchema).toBe(bodySchema);
44
- expect(get?.querySchema).toBe(querySchema);
45
- });
46
-
47
- it("converts Zod bodySchema to JSON Schema like tools", () => {
48
- const schema = z.object({
49
- pr: z.string(),
50
- mode: z.enum(["suggest", "apply"]).optional(),
51
- });
52
- const json = toolInputJsonSchema(schema);
53
- expect(json.type).toBe("object");
54
- expect(json.properties).toMatchObject({
55
- pr: { type: "string" },
56
- });
57
- });
58
-
59
- it("validateToolInput rejects invalid channel bodies", () => {
60
- const schema = z.object({ pr: z.string() });
61
- const bad = validateToolInput(schema, { mode: "suggest" });
62
- expect(bad.ok).toBe(false);
63
- if (!bad.ok) {
64
- expect(bad.message).toContain("pr");
65
- }
66
- const good = validateToolInput(schema, { pr: "acme/repo#1" });
67
- expect(good.ok).toBe(true);
68
- });
69
-
70
- it("projectInfo exposes bodySchema and querySchema on channel routes", () => {
71
- const bodySchema = z.object({ pr: z.string() });
72
- const querySchema = z.object({ status: z.string().optional() });
73
- const channel = defineChannel({
74
- routes: [
75
- POST("/", {
76
- bodySchema,
77
- handler: async () => Response.json({ ok: true }),
78
- }),
79
- GET("/items", {
80
- querySchema,
81
- handler: async () => Response.json({ ok: true }),
82
- }),
83
- ],
84
- });
85
- const project: AgentProject = {
86
- rootDir: "/tmp/demo",
87
- agentDir: "/tmp/demo/agent",
88
- name: "demo",
89
- agent: {
90
- name: "demo",
91
- runtime: "local",
92
- instructions: "test",
93
- tools: [],
94
- skills: [],
95
- connections: [],
96
- subagents: [],
97
- seedFiles: [],
98
- },
99
- httpChannel: httpChannel(),
100
- channels: [{ id: "demo", definition: channel }],
101
- schedules: [],
102
- hooks: [],
103
- abs: [],
104
- diagnostics: [],
105
- };
106
- const info = projectInfo(project);
107
- const demo = info.channels.find((c) => c.id === "demo");
108
- expect(demo?.routes).toEqual([
109
- expect.objectContaining({
110
- method: "POST",
111
- url: "/v1/channels/demo/",
112
- bodySchema: toolInputJsonSchema(bodySchema),
113
- }),
114
- expect.objectContaining({
115
- method: "GET",
116
- url: "/v1/channels/demo/items",
117
- querySchema: toolInputJsonSchema(querySchema),
118
- }),
119
- ]);
120
- });
121
-
122
- it("projectInfo surfaces channel meta (kind, slackChannelPosts)", () => {
123
- const channel = defineChannel({
124
- meta: { kind: "slack", slackChannelPosts: ["#issues-glass"] },
125
- });
126
- const project: AgentProject = {
127
- rootDir: "/tmp/demo",
128
- agentDir: "/tmp/demo/agent",
129
- name: "demo",
130
- agent: {
131
- name: "demo",
132
- runtime: "local",
133
- instructions: "test",
134
- tools: [],
135
- skills: [],
136
- connections: [],
137
- subagents: [],
138
- seedFiles: [],
139
- },
140
- httpChannel: httpChannel(),
141
- channels: [{ id: "slack", definition: channel }],
142
- schedules: [],
143
- hooks: [],
144
- abs: [],
145
- diagnostics: [],
146
- };
147
- const info = projectInfo(project);
148
- const slack = info.channels.find((c) => c.id === "slack");
149
- expect(slack?.kind).toBe("slack");
150
- expect(slack?.slackChannelPosts).toEqual(["#issues-glass"]);
151
- });
152
- });
153
-
154
- describe("channel route HTTP validation", () => {
155
- async function startSchemaChannelServer(): Promise<{ url: string }> {
156
- const stateRoot = await mkdtemp(join(tmpdir(), "agent-serve-chschema-"));
157
- cleanups.push(() => rm(stateRoot, { recursive: true, force: true }));
158
- const bodySchema = z.object({ pr: z.string().min(1) });
159
- const querySchema = z.object({ status: z.string().optional() });
160
- const channel = defineChannel({
161
- routes: [
162
- POST("/", {
163
- bodySchema,
164
- handler: async (_req, args) =>
165
- Response.json({ body: args.body ?? null }),
166
- }),
167
- GET("/items", {
168
- querySchema,
169
- handler: async (_req, args) =>
170
- Response.json({ query: args.query ?? null }),
171
- }),
172
- ],
173
- });
174
- const project: AgentProject = {
175
- rootDir: stateRoot,
176
- agentDir: join(stateRoot, "agent"),
177
- name: "schema-test",
178
- agent: {
179
- name: "schema-test",
180
- runtime: "local",
181
- instructions: "test",
182
- tools: [],
183
- skills: [],
184
- connections: [],
185
- subagents: [],
186
- seedFiles: [],
187
- },
188
- httpChannel: httpChannel(),
189
- channels: [{ id: "schema", definition: channel }],
190
- schedules: [],
191
- hooks: [],
192
- abs: [],
193
- diagnostics: [],
194
- };
195
- const mounts: AgentMount[] = [{ slug: "", project }];
196
- const handle = await startServer(mounts, {
197
- port: 0,
198
- stateRoot,
199
- playground: false,
200
- schedules: false,
201
- logger: () => {},
202
- });
203
- cleanups.push(() => handle.close());
204
- return { url: handle.url };
205
- }
206
-
207
- it("returns 400 for invalid body before the handler runs", async () => {
208
- const { url } = await startSchemaChannelServer();
209
- const response = await fetch(`${url}/v1/channels/schema/`, {
210
- method: "POST",
211
- headers: { "content-type": "application/json" },
212
- body: JSON.stringify({}),
213
- });
214
- expect(response.status).toBe(400);
215
- const body = (await response.json()) as { error: string };
216
- expect(body.error).toContain("pr");
217
- });
218
-
219
- it("accepts an empty request body for z.object({}) routes", async () => {
220
- const stateRoot = await mkdtemp(join(tmpdir(), "agent-serve-empty-body-"));
221
- cleanups.push(() => rm(stateRoot, { recursive: true, force: true }));
222
- const emptyBodySchema = z.object({});
223
- const channel = defineChannel({
224
- routes: [
225
- POST("/noop", {
226
- bodySchema: emptyBodySchema,
227
- handler: async (_req, args) =>
228
- Response.json({ body: args.body ?? null }),
229
- }),
230
- ],
231
- });
232
- const project: AgentProject = {
233
- rootDir: stateRoot,
234
- agentDir: join(stateRoot, "agent"),
235
- name: "empty-body-test",
236
- agent: {
237
- name: "empty-body-test",
238
- runtime: "local",
239
- instructions: "test",
240
- tools: [],
241
- skills: [],
242
- connections: [],
243
- subagents: [],
244
- seedFiles: [],
245
- },
246
- httpChannel: httpChannel(),
247
- channels: [{ id: "noop", definition: channel }],
248
- schedules: [],
249
- hooks: [],
250
- abs: [],
251
- diagnostics: [],
252
- };
253
- const handle = await startServer([{ slug: "", project }], {
254
- port: 0,
255
- stateRoot,
256
- playground: false,
257
- schedules: false,
258
- logger: () => {},
259
- });
260
- cleanups.push(() => handle.close());
261
-
262
- const response = await fetch(`${handle.url}/v1/channels/noop/noop`, {
263
- method: "POST",
264
- headers: { "content-type": "application/json" },
265
- });
266
- expect(response.status).toBe(200);
267
- expect(
268
- ((await response.json()) as { body: Record<string, never> }).body
269
- ).toEqual({});
270
- });
271
-
272
- it("passes validated body and query to the handler", async () => {
273
- const { url } = await startSchemaChannelServer();
274
- const post = await fetch(`${url}/v1/channels/schema/`, {
275
- method: "POST",
276
- headers: { "content-type": "application/json" },
277
- body: JSON.stringify({ pr: "acme/repo#1" }),
278
- });
279
- expect(post.status).toBe(200);
280
- expect(((await post.json()) as { body: { pr: string } }).body).toEqual({
281
- pr: "acme/repo#1",
282
- });
283
-
284
- const get = await fetch(
285
- `${url}/v1/channels/schema/items?status=OPEN&ignored=1`
286
- );
287
- expect(get.status).toBe(200);
288
- expect(((await get.json()) as { query: { status: string } }).query).toEqual(
289
- {
290
- status: "OPEN",
291
- }
292
- );
293
- });
294
- });
@@ -1,262 +0,0 @@
1
- import { once } from "node:events";
2
- import { createServer, type Server } from "node:http";
3
- import type { AddressInfo } from "node:net";
4
- import { afterEach, describe, expect, it, 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
- });