@cursor/july 0.1.25 → 0.1.27

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 (288) hide show
  1. package/dist/ab.d.ts +6 -0
  2. package/dist/ab.d.ts.map +1 -1
  3. package/dist/ab.js +1 -0
  4. package/dist/artifacts.d.ts +34 -0
  5. package/dist/artifacts.d.ts.map +1 -0
  6. package/dist/artifacts.js +57 -0
  7. package/dist/bin/agent-serve.js +31 -9
  8. package/dist/channels/github/github-channel.d.ts +1 -1
  9. package/dist/channels/github/github-channel.d.ts.map +1 -1
  10. package/dist/channels/github/github-channel.js +14 -1
  11. package/dist/channels/github/types.d.ts +6 -1
  12. package/dist/channels/github/types.d.ts.map +1 -1
  13. package/dist/channels/slack/api.d.ts +2 -1
  14. package/dist/channels/slack/api.d.ts.map +1 -1
  15. package/dist/channels/slack/api.js +1 -0
  16. package/dist/channels/slack/cursor-account.d.ts +2 -1
  17. package/dist/channels/slack/cursor-account.d.ts.map +1 -1
  18. package/dist/channels/slack/cursor-account.js +1 -1
  19. package/dist/channels/slack/dispatch.d.ts +4 -1
  20. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  21. package/dist/channels/slack/dispatch.js +3 -3
  22. package/dist/channels/slack/interactive.d.ts +2 -1
  23. package/dist/channels/slack/interactive.d.ts.map +1 -1
  24. package/dist/channels/slack/interactive.js +1 -0
  25. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  26. package/dist/channels/slack/slack-channel.js +4 -3
  27. package/dist/channels/slack/types.d.ts +6 -1
  28. package/dist/channels/slack/types.d.ts.map +1 -1
  29. package/dist/docs/404.html +1 -1
  30. package/dist/docs/ab.html +2 -2
  31. package/dist/docs/assets/{app.DYcC9FY-.js → app.BICLoJYF.js} +1 -1
  32. package/dist/docs/assets/chunks/@localSearchIndexroot.CQJytDwU.js +1 -0
  33. package/dist/docs/assets/chunks/{VPLocalSearchBox.o4N_knTV.js → VPLocalSearchBox.wN4Ko9dT.js} +1 -1
  34. package/dist/docs/assets/chunks/{theme.DQ-njyo0.js → theme.dnnTE-Co.js} +2 -2
  35. package/dist/docs/building-with-agents.html +2 -2
  36. package/dist/docs/concepts.html +2 -2
  37. package/dist/docs/deployment.html +2 -2
  38. package/dist/docs/evals.html +2 -2
  39. package/dist/docs/example-agents/approval-buddy.html +2 -2
  40. package/dist/docs/example-agents/benny.html +2 -2
  41. package/dist/docs/example-agents/bugbot.html +2 -2
  42. package/dist/docs/example-agents/codebase-wiki.html +2 -2
  43. package/dist/docs/example-agents/codeowners-review.html +2 -2
  44. package/dist/docs/example-agents/concierge.html +2 -2
  45. package/dist/docs/example-agents/fsd.html +2 -2
  46. package/dist/docs/example-agents/index.html +2 -2
  47. package/dist/docs/example-agents/knowledge-base.html +2 -2
  48. package/dist/docs/example-agents/oncall.html +2 -2
  49. package/dist/docs/example-agents/security-reviewer.html +2 -2
  50. package/dist/docs/example-agents/slack-agent.html +2 -2
  51. package/dist/docs/example-agents/weather-agent.html +2 -2
  52. package/dist/docs/guides/agent-to-agent.html +2 -2
  53. package/dist/docs/guides/cloud-runtime.html +2 -2
  54. package/dist/docs/guides/github.html +2 -2
  55. package/dist/docs/guides/human-in-the-loop.html +2 -2
  56. package/dist/docs/guides/mcp-oauth.html +2 -2
  57. package/dist/docs/guides/slack.html +2 -2
  58. package/dist/docs/guides/webhooks.html +2 -2
  59. package/dist/docs/hillclimbing.html +2 -2
  60. package/dist/docs/index.html +2 -2
  61. package/dist/docs/quickstart.html +2 -2
  62. package/dist/docs/reference/agent-config.html +2 -2
  63. package/dist/docs/reference/channels.html +2 -2
  64. package/dist/docs/reference/cli.html +2 -2
  65. package/dist/docs/reference/connections.html +2 -2
  66. package/dist/docs/reference/hooks.html +2 -2
  67. package/dist/docs/reference/http-api.html +2 -2
  68. package/dist/docs/reference/instructions.html +2 -2
  69. package/dist/docs/reference/playground.html +2 -2
  70. package/dist/docs/reference/project-layout.html +2 -2
  71. package/dist/docs/reference/prompt.html +2 -2
  72. package/dist/docs/reference/schedules.html +2 -2
  73. package/dist/docs/reference/sessions.html +2 -2
  74. package/dist/docs/reference/skills.html +2 -2
  75. package/dist/docs/reference/subagents.html +2 -2
  76. package/dist/docs/reference/tools.html +2 -2
  77. package/dist/docs/scaffolding-agents.html +2 -2
  78. package/dist/docs/storage.html +2 -2
  79. package/dist/docs/troubleshooting.html +2 -2
  80. package/dist/evals/assertions.d.ts +10 -1
  81. package/dist/evals/assertions.d.ts.map +1 -1
  82. package/dist/evals/assertions.js +12 -0
  83. package/dist/evals.d.ts +1 -1
  84. package/dist/evals.d.ts.map +1 -1
  85. package/dist/index.d.ts +1 -0
  86. package/dist/index.d.ts.map +1 -1
  87. package/dist/index.js +1 -0
  88. package/dist/internal/ab-fold.d.ts.map +1 -1
  89. package/dist/internal/ab-fold.js +4 -0
  90. package/dist/internal/ab-snapshot.d.ts.map +1 -1
  91. package/dist/internal/ab-snapshot.js +1 -0
  92. package/dist/internal/artifacts-store.d.ts +45 -0
  93. package/dist/internal/artifacts-store.d.ts.map +1 -0
  94. package/dist/internal/artifacts-store.js +250 -0
  95. package/dist/internal/builtin-tools/artifacts.d.ts +10 -0
  96. package/dist/internal/builtin-tools/artifacts.d.ts.map +1 -0
  97. package/dist/internal/builtin-tools/artifacts.js +73 -0
  98. package/dist/internal/builtin-tools/index.d.ts +8 -1
  99. package/dist/internal/builtin-tools/index.d.ts.map +1 -1
  100. package/dist/internal/builtin-tools/index.js +15 -0
  101. package/dist/internal/cli-ax.d.ts +11 -0
  102. package/dist/internal/cli-ax.d.ts.map +1 -1
  103. package/dist/internal/cli-ax.js +80 -0
  104. package/dist/internal/cli-slack.d.ts.map +1 -1
  105. package/dist/internal/cli-slack.js +14 -6
  106. package/dist/internal/discovery.d.ts.map +1 -1
  107. package/dist/internal/discovery.js +83 -2
  108. package/dist/internal/distribution.d.ts.map +1 -1
  109. package/dist/internal/distribution.js +1 -0
  110. package/dist/internal/model-pricing.d.ts +49 -0
  111. package/dist/internal/model-pricing.d.ts.map +1 -0
  112. package/dist/internal/model-pricing.js +377 -0
  113. package/dist/internal/reminder-runner.d.ts.map +1 -1
  114. package/dist/internal/reminder-runner.js +1 -0
  115. package/dist/internal/schedule-runner.d.ts.map +1 -1
  116. package/dist/internal/schedule-runner.js +1 -0
  117. package/dist/internal/sdk-runner.d.ts.map +1 -1
  118. package/dist/internal/sdk-runner.js +9 -1
  119. package/dist/internal/server.d.ts.map +1 -1
  120. package/dist/internal/server.js +39 -0
  121. package/dist/internal/session-cost.d.ts +49 -0
  122. package/dist/internal/session-cost.d.ts.map +1 -0
  123. package/dist/internal/session-cost.js +175 -0
  124. package/dist/internal/session-engine.d.ts +35 -1
  125. package/dist/internal/session-engine.d.ts.map +1 -1
  126. package/dist/internal/session-engine.js +128 -7
  127. package/dist/internal/storage-coordinator.d.ts +15 -0
  128. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  129. package/dist/internal/storage-coordinator.js +52 -0
  130. package/dist/internal/trajectory.d.ts +9 -1
  131. package/dist/internal/trajectory.d.ts.map +1 -1
  132. package/dist/internal/trajectory.js +32 -5
  133. package/dist/playground/assets/index-BDCeW4uc.js +86 -0
  134. package/dist/playground/assets/index-Bul1WfrB.css +1 -0
  135. package/dist/playground/index.html +2 -2
  136. package/dist/storage.d.ts +4 -0
  137. package/dist/storage.d.ts.map +1 -1
  138. package/dist/storage.js +4 -0
  139. package/dist/types.d.ts +164 -1
  140. package/dist/types.d.ts.map +1 -1
  141. package/package.json +26 -26
  142. package/src/ab.ts +7 -0
  143. package/src/bin/agent-serve.ts +30 -2
  144. package/src/channels/github/github-channel.ts +19 -2
  145. package/src/channels/github/types.ts +6 -0
  146. package/src/channels/slack/api.ts +3 -1
  147. package/src/channels/slack/cursor-account.ts +3 -1
  148. package/src/channels/slack/dispatch.ts +12 -1
  149. package/src/channels/slack/interactive.ts +3 -0
  150. package/src/channels/slack/slack-channel.ts +6 -0
  151. package/src/channels/slack/types.ts +6 -0
  152. package/src/internal/ab-fold.ts +4 -0
  153. package/src/internal/ab-snapshot.ts +1 -0
  154. package/src/internal/cli-ax.ts +95 -0
  155. package/src/internal/model-pricing.ts +426 -0
  156. package/src/internal/reminder-runner.ts +1 -0
  157. package/src/internal/schedule-runner.ts +1 -0
  158. package/src/internal/sdk-runner.ts +10 -2
  159. package/src/internal/server.ts +2 -0
  160. package/src/internal/session-cost.ts +231 -0
  161. package/src/internal/session-engine.ts +32 -1
  162. package/src/internal/trajectory.ts +45 -3
  163. package/src/types.ts +42 -2
  164. package/dist/channels/github/instrument.d.ts +0 -20
  165. package/dist/channels/github/instrument.d.ts.map +0 -1
  166. package/dist/docs/assets/chunks/@localSearchIndexroot.BQTzJjR_.js +0 -1
  167. package/dist/internal/json-dir-store.d.ts +0 -32
  168. package/dist/internal/json-dir-store.d.ts.map +0 -1
  169. package/dist/internal/json-dir-store.js +0 -100
  170. package/dist/playground/assets/index-CjOQ4hN9.css +0 -1
  171. package/dist/playground/assets/index-DqXdAFGa.js +0 -85
  172. package/src/bin/agent-serve.version.test.ts +0 -64
  173. package/src/channels/github/api.test.ts +0 -64
  174. package/src/channels/github/auth.test.ts +0 -105
  175. package/src/channels/github/cursor-account.test.ts +0 -204
  176. package/src/channels/github/forward.test.ts +0 -457
  177. package/src/channels/github/github.test.ts +0 -943
  178. package/src/channels/github/replay.test.ts +0 -179
  179. package/src/channels/slack/api.post-message.test.ts +0 -148
  180. package/src/channels/slack/approvals.test.ts +0 -328
  181. package/src/channels/slack/block-actions.test.ts +0 -452
  182. package/src/channels/slack/bot-mentions.test.ts +0 -267
  183. package/src/channels/slack/channel-watch.test.ts +0 -363
  184. package/src/channels/slack/cursor-account.test.ts +0 -253
  185. package/src/channels/slack/defaults.final-post.test.ts +0 -182
  186. package/src/channels/slack/dispatch.test.ts +0 -795
  187. package/src/channels/slack/eval-directive.test.ts +0 -273
  188. package/src/channels/slack/message-body.test.ts +0 -54
  189. package/src/channels/slack/nudge-store.test.ts +0 -143
  190. package/src/channels/slack/slack.test.ts +0 -391
  191. package/src/channels/slack/stop.test.ts +0 -23
  192. package/src/channels/slack/thread-context.test.ts +0 -202
  193. package/src/evals/assertions.test.ts +0 -617
  194. package/src/evals/expect.test.ts +0 -144
  195. package/src/evals/judge.test.ts +0 -181
  196. package/src/evals/loaders.test.ts +0 -132
  197. package/src/evals/matchers.test.ts +0 -95
  198. package/src/evals/reporters.test.ts +0 -303
  199. package/src/evals/run-facts.test.ts +0 -259
  200. package/src/internal/ab-snapshot.test.ts +0 -325
  201. package/src/internal/approval-gate.test.ts +0 -49
  202. package/src/internal/approvals.integration.test.ts +0 -383
  203. package/src/internal/artifacts-store.test.ts +0 -283
  204. package/src/internal/authored-loaders.test.ts +0 -31
  205. package/src/internal/builtin-tools/artifacts.test.ts +0 -247
  206. package/src/internal/builtin-tools/reminders.test.ts +0 -201
  207. package/src/internal/channel-route-schema.test.ts +0 -294
  208. package/src/internal/chat-attach.test.ts +0 -262
  209. package/src/internal/cli-deploy.test.ts +0 -1991
  210. package/src/internal/cli-docs.test.ts +0 -161
  211. package/src/internal/cli-mcp.test.ts +0 -789
  212. package/src/internal/cli-skills.test.ts +0 -133
  213. package/src/internal/cli-slack.test.ts +0 -1654
  214. package/src/internal/cloud-merge.test.ts +0 -74
  215. package/src/internal/cron.test.ts +0 -22
  216. package/src/internal/cursor/account-mcp.test.ts +0 -807
  217. package/src/internal/cursor/backend-client.test.ts +0 -591
  218. package/src/internal/cursor/credentials.test.ts +0 -351
  219. package/src/internal/cursor/github-credentials.test.ts +0 -136
  220. package/src/internal/cursor-account-mcp-auth.test.ts +0 -310
  221. package/src/internal/cursor-account.integration.test.ts +0 -441
  222. package/src/internal/cursor-event-relay.test.ts +0 -746
  223. package/src/internal/cursor-github-credentials.integration.test.ts +0 -271
  224. package/src/internal/cursor-slack-relay.test.ts +0 -525
  225. package/src/internal/deploy-source.test.ts +0 -111
  226. package/src/internal/discovery.artifact-tool.test.ts +0 -136
  227. package/src/internal/discovery.artifacts.test.ts +0 -119
  228. package/src/internal/discovery.builtin-tools.test.ts +0 -94
  229. package/src/internal/discovery.concurrency.test.ts +0 -60
  230. package/src/internal/discovery.cursor-account.test.ts +0 -133
  231. package/src/internal/discovery.cwd.test.ts +0 -83
  232. package/src/internal/discovery.hosting.test.ts +0 -80
  233. package/src/internal/discovery.identity.test.ts +0 -44
  234. package/src/internal/docs-site.test.ts +0 -66
  235. package/src/internal/duration.test.ts +0 -29
  236. package/src/internal/eval-judge-model.test.ts +0 -187
  237. package/src/internal/eval-run-store.cancel.test.ts +0 -142
  238. package/src/internal/eval-run-store.storage.test.ts +0 -211
  239. package/src/internal/eval-runner.http.test.ts +0 -403
  240. package/src/internal/eval-runner.run.test.ts +0 -928
  241. package/src/internal/evals-client.test.ts +0 -307
  242. package/src/internal/event-mapper.test.ts +0 -243
  243. package/src/internal/github-fanout.test.ts +0 -213
  244. package/src/internal/handleAgentServeTrigger.test.ts +0 -185
  245. package/src/internal/host-kv.test.ts +0 -82
  246. package/src/internal/host-platforms.test.ts +0 -126
  247. package/src/internal/http-channel.test.ts +0 -402
  248. package/src/internal/init-project.test.ts +0 -270
  249. package/src/internal/install-cursor-skills.test.ts +0 -262
  250. package/src/internal/local-env.test.ts +0 -120
  251. package/src/internal/log-ring.test.ts +0 -31
  252. package/src/internal/logs-client.test.ts +0 -350
  253. package/src/internal/mcp-endpoint.test.ts +0 -436
  254. package/src/internal/mcp-host.test.ts +0 -298
  255. package/src/internal/mcp-oauth.test.ts +0 -148
  256. package/src/internal/net.test.ts +0 -17
  257. package/src/internal/peer-connections.test.ts +0 -128
  258. package/src/internal/peer-mcp.integration.test.ts +0 -289
  259. package/src/internal/playground/toolchain.test.ts +0 -53
  260. package/src/internal/playground-cli.test.ts +0 -187
  261. package/src/internal/playground-proxy.test.ts +0 -376
  262. package/src/internal/prompt-context.integration.test.ts +0 -232
  263. package/src/internal/prompt-context.test.ts +0 -127
  264. package/src/internal/reminder-runner.test.ts +0 -390
  265. package/src/internal/reminder-store.test.ts +0 -53
  266. package/src/internal/request-headers.test.ts +0 -27
  267. package/src/internal/resolve-prod-target.test.ts +0 -787
  268. package/src/internal/resolved-connections.test.ts +0 -295
  269. package/src/internal/router.test.ts +0 -57
  270. package/src/internal/sdk-runner.test.ts +0 -290
  271. package/src/internal/server.artifacts.test.ts +0 -303
  272. package/src/internal/session-engine.artifacts.test.ts +0 -243
  273. package/src/internal/session-engine.coalesce.test.ts +0 -169
  274. package/src/internal/session-engine.concurrency.test.ts +0 -250
  275. package/src/internal/session-engine.host-oauth-mcp.test.ts +0 -110
  276. package/src/internal/session-engine.interrupt.test.ts +0 -577
  277. package/src/internal/session-engine.storage.test.ts +0 -547
  278. package/src/internal/session-urls.test.ts +0 -28
  279. package/src/internal/sessions-client.test.ts +0 -518
  280. package/src/internal/storage-coordinator.test.ts +0 -517
  281. package/src/internal/tool-call.test.ts +0 -458
  282. package/src/internal/tool-result.test.ts +0 -52
  283. package/src/internal/trajectory.approvals.test.ts +0 -83
  284. package/src/internal/trajectory.subagents.test.ts +0 -198
  285. package/src/internal/turn-governor.test.ts +0 -137
  286. package/src/internal/update-check.test.ts +0 -485
  287. package/src/internal/workspace.test.ts +0 -207
  288. 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
- });