@cursor/july 0.1.26 → 0.1.28

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