@cursor/july 0.1.23 → 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 (174) hide show
  1. package/dist/bin/agent-serve.js +0 -0
  2. package/dist/docs/404.html +1 -1
  3. package/dist/docs/ab.html +2 -2
  4. package/dist/docs/assets/{app.DYcC9FY-.js → app.CvSGaAxk.js} +1 -1
  5. package/dist/docs/assets/chunks/@localSearchIndexroot.CL2Y0Zmh.js +1 -0
  6. package/dist/docs/assets/chunks/{VPLocalSearchBox.o4N_knTV.js → VPLocalSearchBox.J1jJbCvs.js} +1 -1
  7. package/dist/docs/assets/chunks/{theme.DQ-njyo0.js → theme.C7vfzr7h.js} +2 -2
  8. package/dist/docs/building-with-agents.html +2 -2
  9. package/dist/docs/concepts.html +2 -2
  10. package/dist/docs/deployment.html +2 -2
  11. package/dist/docs/evals.html +2 -2
  12. package/dist/docs/example-agents/approval-buddy.html +2 -2
  13. package/dist/docs/example-agents/benny.html +2 -2
  14. package/dist/docs/example-agents/bugbot.html +2 -2
  15. package/dist/docs/example-agents/codebase-wiki.html +2 -2
  16. package/dist/docs/example-agents/codeowners-review.html +2 -2
  17. package/dist/docs/example-agents/concierge.html +2 -2
  18. package/dist/docs/example-agents/fsd.html +2 -2
  19. package/dist/docs/example-agents/index.html +2 -2
  20. package/dist/docs/example-agents/knowledge-base.html +2 -2
  21. package/dist/docs/example-agents/oncall.html +2 -2
  22. package/dist/docs/example-agents/security-reviewer.html +2 -2
  23. package/dist/docs/example-agents/slack-agent.html +2 -2
  24. package/dist/docs/example-agents/weather-agent.html +2 -2
  25. package/dist/docs/guides/agent-to-agent.html +2 -2
  26. package/dist/docs/guides/cloud-runtime.html +2 -2
  27. package/dist/docs/guides/github.html +2 -2
  28. package/dist/docs/guides/human-in-the-loop.html +2 -2
  29. package/dist/docs/guides/mcp-oauth.html +2 -2
  30. package/dist/docs/guides/slack.html +2 -2
  31. package/dist/docs/guides/webhooks.html +2 -2
  32. package/dist/docs/hillclimbing.html +2 -2
  33. package/dist/docs/index.html +2 -2
  34. package/dist/docs/quickstart.html +2 -2
  35. package/dist/docs/reference/agent-config.html +2 -2
  36. package/dist/docs/reference/channels.html +2 -2
  37. package/dist/docs/reference/cli.html +2 -2
  38. package/dist/docs/reference/connections.html +2 -2
  39. package/dist/docs/reference/hooks.html +2 -2
  40. package/dist/docs/reference/http-api.html +2 -2
  41. package/dist/docs/reference/instructions.html +2 -2
  42. package/dist/docs/reference/playground.html +2 -2
  43. package/dist/docs/reference/project-layout.html +2 -2
  44. package/dist/docs/reference/prompt.html +2 -2
  45. package/dist/docs/reference/schedules.html +2 -2
  46. package/dist/docs/reference/sessions.html +2 -2
  47. package/dist/docs/reference/skills.html +2 -2
  48. package/dist/docs/reference/subagents.html +2 -2
  49. package/dist/docs/reference/tools.html +2 -2
  50. package/dist/docs/scaffolding-agents.html +2 -2
  51. package/dist/docs/storage.html +2 -2
  52. package/dist/docs/troubleshooting.html +2 -2
  53. package/dist/playground/assets/index-CidizGZv.css +1 -0
  54. package/dist/playground/assets/{index-DqXdAFGa.js → index-DTG9OsPV.js} +41 -41
  55. package/dist/playground/index.html +2 -2
  56. package/package.json +24 -24
  57. package/dist/channels/github/instrument.d.ts +0 -20
  58. package/dist/channels/github/instrument.d.ts.map +0 -1
  59. package/dist/docs/assets/chunks/@localSearchIndexroot.BQTzJjR_.js +0 -1
  60. package/dist/internal/json-dir-store.d.ts +0 -32
  61. package/dist/internal/json-dir-store.d.ts.map +0 -1
  62. package/dist/internal/json-dir-store.js +0 -100
  63. package/dist/playground/assets/index-CjOQ4hN9.css +0 -1
  64. package/src/bin/agent-serve.version.test.ts +0 -64
  65. package/src/channels/github/api.test.ts +0 -64
  66. package/src/channels/github/auth.test.ts +0 -105
  67. package/src/channels/github/cursor-account.test.ts +0 -204
  68. package/src/channels/github/forward.test.ts +0 -457
  69. package/src/channels/github/github.test.ts +0 -937
  70. package/src/channels/github/replay.test.ts +0 -179
  71. package/src/channels/slack/api.post-message.test.ts +0 -148
  72. package/src/channels/slack/approvals.test.ts +0 -328
  73. package/src/channels/slack/block-actions.test.ts +0 -452
  74. package/src/channels/slack/bot-mentions.test.ts +0 -267
  75. package/src/channels/slack/channel-watch.test.ts +0 -363
  76. package/src/channels/slack/cursor-account.test.ts +0 -253
  77. package/src/channels/slack/defaults.final-post.test.ts +0 -182
  78. package/src/channels/slack/dispatch.test.ts +0 -795
  79. package/src/channels/slack/eval-directive.test.ts +0 -273
  80. package/src/channels/slack/message-body.test.ts +0 -54
  81. package/src/channels/slack/nudge-store.test.ts +0 -143
  82. package/src/channels/slack/slack.test.ts +0 -391
  83. package/src/channels/slack/stop.test.ts +0 -23
  84. package/src/channels/slack/thread-context.test.ts +0 -202
  85. package/src/evals/assertions.test.ts +0 -580
  86. package/src/evals/expect.test.ts +0 -144
  87. package/src/evals/judge.test.ts +0 -181
  88. package/src/evals/loaders.test.ts +0 -132
  89. package/src/evals/matchers.test.ts +0 -95
  90. package/src/evals/reporters.test.ts +0 -303
  91. package/src/evals/run-facts.test.ts +0 -259
  92. package/src/internal/ab-snapshot.test.ts +0 -325
  93. package/src/internal/approval-gate.test.ts +0 -49
  94. package/src/internal/approvals.integration.test.ts +0 -383
  95. package/src/internal/authored-loaders.test.ts +0 -31
  96. package/src/internal/builtin-tools/reminders.test.ts +0 -201
  97. package/src/internal/channel-route-schema.test.ts +0 -294
  98. package/src/internal/chat-attach.test.ts +0 -262
  99. package/src/internal/cli-deploy.test.ts +0 -1991
  100. package/src/internal/cli-docs.test.ts +0 -161
  101. package/src/internal/cli-mcp.test.ts +0 -789
  102. package/src/internal/cli-skills.test.ts +0 -133
  103. package/src/internal/cli-slack.test.ts +0 -1647
  104. package/src/internal/cloud-merge.test.ts +0 -74
  105. package/src/internal/cron.test.ts +0 -22
  106. package/src/internal/cursor/account-mcp.test.ts +0 -807
  107. package/src/internal/cursor/backend-client.test.ts +0 -591
  108. package/src/internal/cursor/credentials.test.ts +0 -351
  109. package/src/internal/cursor/github-credentials.test.ts +0 -136
  110. package/src/internal/cursor-account-mcp-auth.test.ts +0 -310
  111. package/src/internal/cursor-account.integration.test.ts +0 -441
  112. package/src/internal/cursor-event-relay.test.ts +0 -746
  113. package/src/internal/cursor-github-credentials.integration.test.ts +0 -271
  114. package/src/internal/cursor-slack-relay.test.ts +0 -525
  115. package/src/internal/deploy-source.test.ts +0 -111
  116. package/src/internal/discovery.builtin-tools.test.ts +0 -94
  117. package/src/internal/discovery.concurrency.test.ts +0 -60
  118. package/src/internal/discovery.cursor-account.test.ts +0 -133
  119. package/src/internal/discovery.cwd.test.ts +0 -83
  120. package/src/internal/discovery.hosting.test.ts +0 -80
  121. package/src/internal/discovery.identity.test.ts +0 -44
  122. package/src/internal/docs-site.test.ts +0 -66
  123. package/src/internal/duration.test.ts +0 -29
  124. package/src/internal/eval-judge-model.test.ts +0 -187
  125. package/src/internal/eval-run-store.cancel.test.ts +0 -142
  126. package/src/internal/eval-run-store.storage.test.ts +0 -211
  127. package/src/internal/eval-runner.http.test.ts +0 -403
  128. package/src/internal/eval-runner.run.test.ts +0 -928
  129. package/src/internal/evals-client.test.ts +0 -307
  130. package/src/internal/event-mapper.test.ts +0 -243
  131. package/src/internal/github-fanout.test.ts +0 -213
  132. package/src/internal/handleAgentServeTrigger.test.ts +0 -179
  133. package/src/internal/host-kv.test.ts +0 -82
  134. package/src/internal/host-platforms.test.ts +0 -126
  135. package/src/internal/http-channel.test.ts +0 -402
  136. package/src/internal/init-project.test.ts +0 -270
  137. package/src/internal/install-cursor-skills.test.ts +0 -262
  138. package/src/internal/local-env.test.ts +0 -120
  139. package/src/internal/log-ring.test.ts +0 -31
  140. package/src/internal/logs-client.test.ts +0 -350
  141. package/src/internal/mcp-endpoint.test.ts +0 -436
  142. package/src/internal/mcp-host.test.ts +0 -298
  143. package/src/internal/mcp-oauth.test.ts +0 -148
  144. package/src/internal/net.test.ts +0 -17
  145. package/src/internal/peer-connections.test.ts +0 -128
  146. package/src/internal/peer-mcp.integration.test.ts +0 -289
  147. package/src/internal/playground/toolchain.test.ts +0 -53
  148. package/src/internal/playground-cli.test.ts +0 -187
  149. package/src/internal/playground-proxy.test.ts +0 -376
  150. package/src/internal/prompt-context.integration.test.ts +0 -232
  151. package/src/internal/prompt-context.test.ts +0 -127
  152. package/src/internal/reminder-runner.test.ts +0 -390
  153. package/src/internal/reminder-store.test.ts +0 -53
  154. package/src/internal/request-headers.test.ts +0 -27
  155. package/src/internal/resolve-prod-target.test.ts +0 -787
  156. package/src/internal/resolved-connections.test.ts +0 -295
  157. package/src/internal/router.test.ts +0 -57
  158. package/src/internal/sdk-runner.test.ts +0 -290
  159. package/src/internal/session-engine.coalesce.test.ts +0 -169
  160. package/src/internal/session-engine.concurrency.test.ts +0 -250
  161. package/src/internal/session-engine.host-oauth-mcp.test.ts +0 -110
  162. package/src/internal/session-engine.interrupt.test.ts +0 -577
  163. package/src/internal/session-engine.storage.test.ts +0 -547
  164. package/src/internal/session-urls.test.ts +0 -28
  165. package/src/internal/sessions-client.test.ts +0 -518
  166. package/src/internal/storage-coordinator.test.ts +0 -517
  167. package/src/internal/tool-call.test.ts +0 -458
  168. package/src/internal/tool-result.test.ts +0 -52
  169. package/src/internal/trajectory.approvals.test.ts +0 -83
  170. package/src/internal/trajectory.subagents.test.ts +0 -198
  171. package/src/internal/turn-governor.test.ts +0 -137
  172. package/src/internal/update-check.test.ts +0 -485
  173. package/src/internal/workspace.test.ts +0 -207
  174. 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
- });