@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,469 +0,0 @@
1
- import { describe, expect, it } from "vitest";
2
- import type {
3
- ArtifactsApi,
4
- ChannelSession,
5
- SendMessageFn,
6
- } from "../../types.js";
7
- import { blockActionAuth } from "./auth.js";
8
- import {
9
- mrkdwnSections,
10
- SLACK_SECTION_MRKDWN_MAX,
11
- SLACK_TABLE_MAX_COLUMNS,
12
- SLACK_TABLE_MAX_ROWS,
13
- slackLinkCell,
14
- slackRawTextCell,
15
- slackTableBlock,
16
- } from "./blocks.js";
17
- import { createSlackLogger } from "./index.js";
18
- import {
19
- dispatchBlockAction,
20
- parseSlackBlockAction,
21
- resolveBlockActionCard,
22
- } from "./interactive.js";
23
- import type { SlackBlockAction } from "./types.js";
24
-
25
- const testAuth = {
26
- authenticator: "slack",
27
- principalId: "slack:T1:C9:5.0",
28
- principalType: "user" as const,
29
- attributes: { channel_id: "C9", thread_ts: "5.0", user_id: "U7" },
30
- };
31
-
32
- function mockSession(id = "ses_click"): ChannelSession {
33
- return {
34
- id,
35
- continuationToken: null,
36
- isNew: true,
37
- info: {
38
- id,
39
- channelId: "slack",
40
- mode: "chat",
41
- auth: testAuth,
42
- },
43
- getEventStream: async () => new ReadableStream(),
44
- waitForCompletion: async () => ({ status: "finished" }),
45
- setContinuationToken: async () => undefined,
46
- };
47
- }
48
-
49
- function createSendRecorder(): {
50
- send: SendMessageFn;
51
- calls: Array<{ message: string; options: Parameters<SendMessageFn>[1] }>;
52
- } {
53
- const calls: Array<{
54
- message: string;
55
- options: Parameters<SendMessageFn>[1];
56
- }> = [];
57
- const send: SendMessageFn = async (message, sendOptions) => {
58
- calls.push({ message, options: sendOptions });
59
- return mockSession();
60
- };
61
- return { send, calls };
62
- }
63
-
64
- function testArtifacts(): ArtifactsApi {
65
- return {
66
- tag: async () => {
67
- throw new Error("artifacts not configured in test");
68
- },
69
- list: async () => [],
70
- };
71
- }
72
-
73
- function testHost() {
74
- return {
75
- mcp: {
76
- names: () => [] as string[],
77
- listTools: async () => [],
78
- callTool: async () => ({ content: [] }),
79
- },
80
- github: {
81
- getOctokit: async () => {
82
- throw new Error("github client not configured in test");
83
- },
84
- },
85
- slack: {
86
- getClient: async () => {
87
- throw new Error("slack client not configured in test");
88
- },
89
- },
90
- kv: {
91
- get: async () => undefined,
92
- put: async () => {},
93
- delete: async () => {},
94
- },
95
- };
96
- }
97
-
98
- function blockActionsPayload(
99
- overrides: { actionId?: string; value?: string; threadTs?: string } = {}
100
- ): Record<string, unknown> {
101
- return {
102
- type: "block_actions",
103
- team: { id: "T1", domain: "acme" },
104
- user: { id: "U7", username: "netto", team_id: "T1" },
105
- channel: { id: "C9", name: "deploys" },
106
- container: { type: "message", message_ts: "5.0", channel_id: "C9" },
107
- message: {
108
- ts: "5.0",
109
- text: "the ask",
110
- ...(overrides.threadTs === undefined
111
- ? {}
112
- : { thread_ts: overrides.threadTs }),
113
- blocks: [{ type: "section" }, { type: "actions", block_id: "b1" }],
114
- },
115
- actions: [
116
- {
117
- type: "button",
118
- action_id: overrides.actionId ?? "my_button",
119
- block_id: "b1",
120
- value: overrides.value ?? '{"pr":"https://example.test/pr/1"}',
121
- text: { type: "plain_text", text: "Deploy" },
122
- action_ts: "6.123456",
123
- },
124
- ],
125
- };
126
- }
127
-
128
- describe("parseSlackBlockAction", () => {
129
- it("parses a button click with label, clicker, and message blocks", () => {
130
- const action = parseSlackBlockAction(blockActionsPayload());
131
- expect(action).toMatchObject({
132
- actionId: "my_button",
133
- blockId: "b1",
134
- value: '{"pr":"https://example.test/pr/1"}',
135
- label: "Deploy",
136
- channelId: "C9",
137
- // Top-level message: the click stays in that message's thread.
138
- threadTs: "5.0",
139
- messageTs: "5.0",
140
- userId: "U7",
141
- userName: "netto",
142
- teamId: "T1",
143
- actionTs: "6.123456",
144
- });
145
- expect(action?.messageBlocks).toHaveLength(2);
146
- });
147
-
148
- it("prefers the message thread_ts for replies", () => {
149
- const action = parseSlackBlockAction(
150
- blockActionsPayload({ threadTs: "1.0" })
151
- );
152
- expect(action?.threadTs).toBe("1.0");
153
- expect(action?.messageTs).toBe("5.0");
154
- });
155
-
156
- it("defaults a missing button value to the empty string", () => {
157
- const payload = blockActionsPayload();
158
- delete (
159
- (payload.actions as Array<Record<string, unknown>>)[0] as Record<
160
- string,
161
- unknown
162
- >
163
- ).value;
164
- expect(parseSlackBlockAction(payload)?.value).toBe("");
165
- });
166
-
167
- it("returns null for non-block_actions payloads", () => {
168
- expect(parseSlackBlockAction({ type: "view_submission" })).toBeNull();
169
- expect(parseSlackBlockAction(null)).toBeNull();
170
- expect(
171
- parseSlackBlockAction({ type: "block_actions", actions: [] })
172
- ).toBeNull();
173
- });
174
- });
175
-
176
- describe("dispatchBlockAction", () => {
177
- it("dispatches the handler decision on the click's thread", async () => {
178
- const { send, calls } = createSendRecorder();
179
- const seen: SlackBlockAction[] = [];
180
- const handled = await dispatchBlockAction(blockActionsPayload(), {
181
- handler: (_ctx, action) => {
182
- seen.push(action);
183
- return { auth: testAuth, message: "U7 clicked Deploy — ship it." };
184
- },
185
- send,
186
- credentials: undefined,
187
- artifacts: testArtifacts(),
188
- host: testHost(),
189
- log: createSlackLogger(() => undefined),
190
- });
191
- expect(handled).toBe(true);
192
- expect(seen).toHaveLength(1);
193
- expect(seen[0]?.actionId).toBe("my_button");
194
- expect(calls).toHaveLength(1);
195
- expect(calls[0]?.options?.continuationToken).toBe("C9:5.0");
196
- expect(calls[0]?.message).toContain("<slack_context>");
197
- expect(calls[0]?.message).toContain("U7 clicked Deploy — ship it.");
198
- const state = calls[0]?.options?.state as {
199
- channelId?: string;
200
- threadTs?: string;
201
- triggeringUserId?: string;
202
- };
203
- expect(state.channelId).toBe("C9");
204
- expect(state.threadTs).toBe("5.0");
205
- expect(state.triggeringUserId).toBe("U7");
206
- });
207
-
208
- it("skips clicks without an action_ts (would alias dedupe keys)", async () => {
209
- const { send, calls } = createSendRecorder();
210
- const payload = blockActionsPayload();
211
- delete (
212
- (payload.actions as Array<Record<string, unknown>>)[0] as Record<
213
- string,
214
- unknown
215
- >
216
- ).action_ts;
217
- const handled = await dispatchBlockAction(payload, {
218
- handler: () => ({ auth: testAuth }),
219
- send,
220
- credentials: undefined,
221
- artifacts: testArtifacts(),
222
- host: testHost(),
223
- log: createSlackLogger(() => undefined),
224
- });
225
- expect(handled).toBe(true);
226
- expect(calls).toHaveLength(0);
227
- });
228
-
229
- it("skips dispatch when the handler returns null", async () => {
230
- const { send, calls } = createSendRecorder();
231
- const handled = await dispatchBlockAction(blockActionsPayload(), {
232
- handler: () => null,
233
- send,
234
- credentials: undefined,
235
- artifacts: testArtifacts(),
236
- host: testHost(),
237
- log: createSlackLogger(() => undefined),
238
- });
239
- expect(handled).toBe(true);
240
- expect(calls).toHaveLength(0);
241
- });
242
-
243
- it("returns false for payloads that are not block actions", async () => {
244
- const { send, calls } = createSendRecorder();
245
- const handled = await dispatchBlockAction(
246
- { type: "view_submission" },
247
- {
248
- handler: () => ({ auth: testAuth }),
249
- send,
250
- credentials: undefined,
251
- artifacts: testArtifacts(),
252
- host: testHost(),
253
- log: createSlackLogger(() => undefined),
254
- }
255
- );
256
- expect(handled).toBe(false);
257
- expect(calls).toHaveLength(0);
258
- });
259
- });
260
-
261
- describe("resolveBlockActionCard", () => {
262
- function parsedAction(): SlackBlockAction {
263
- const action = parseSlackBlockAction(blockActionsPayload());
264
- if (action === null) {
265
- throw new Error("fixture must parse");
266
- }
267
- return action;
268
- }
269
-
270
- it("swaps only the clicked actions row for the note", async () => {
271
- const calls: Array<{ method: string; args: Record<string, unknown> }> = [];
272
- const action = parsedAction();
273
- action.messageBlocks = [
274
- ...(action.messageBlocks ?? []),
275
- { type: "actions", block_id: "someone_elses_row" },
276
- ];
277
- const ok = await resolveBlockActionCard({
278
- botToken: {
279
- kind: "api-transport",
280
- label: "test",
281
- async call(method: string, args: Record<string, unknown>) {
282
- calls.push({ method, args });
283
- return { ok: true };
284
- },
285
- },
286
- action,
287
- note: "resolved by <@U7>",
288
- });
289
- expect(ok).toBe(true);
290
- expect(calls).toHaveLength(1);
291
- expect(calls[0]?.method).toBe("chat.update");
292
- expect(calls[0]?.args.ts).toBe("5.0");
293
- const updated = JSON.stringify(calls[0]?.args.blocks);
294
- expect(updated).not.toContain('"block_id":"b1"');
295
- expect(updated).toContain("someone_elses_row");
296
- expect(updated).toContain("resolved by <@U7>");
297
- });
298
-
299
- it("returns false when the payload carried no message blocks", async () => {
300
- const action = parsedAction();
301
- action.messageBlocks = undefined;
302
- const ok = await resolveBlockActionCard({
303
- botToken: {
304
- kind: "api-transport",
305
- label: "test",
306
- async call() {
307
- throw new Error("must not call Slack");
308
- },
309
- },
310
- action,
311
- note: "resolved",
312
- });
313
- expect(ok).toBe(false);
314
- });
315
- });
316
-
317
- describe("blockActionAuth", () => {
318
- it("builds the click's thread-scoped principal with the clicker", () => {
319
- const action = parseSlackBlockAction(blockActionsPayload());
320
- const auth = blockActionAuth(action as SlackBlockAction);
321
- expect(auth.principalId).toBe("slack:T1:C9:5.0");
322
- expect(auth.attributes?.user_id).toBe("U7");
323
- expect(auth.attributes?.user_name).toBe("netto");
324
- });
325
- });
326
-
327
- describe("mrkdwnSections", () => {
328
- it("packs lines into capped sections preserving order", () => {
329
- const lines = Array.from(
330
- { length: 200 },
331
- (_, i) => `• item-${i}-${"x".repeat(20)}`
332
- );
333
- const sections = mrkdwnSections(["Header:", ...lines]) as Array<{
334
- type: string;
335
- text: { type: string; text: string };
336
- }>;
337
- expect(sections.length).toBeGreaterThan(1);
338
- for (const section of sections) {
339
- expect(section.type).toBe("section");
340
- expect(section.text.text.length).toBeLessThanOrEqual(
341
- SLACK_SECTION_MRKDWN_MAX
342
- );
343
- }
344
- const joined = sections.map((section) => section.text.text).join("\n");
345
- expect(joined.startsWith("Header:")).toBe(true);
346
- for (const line of lines) {
347
- expect(joined).toContain(line);
348
- }
349
- });
350
-
351
- it("keeps a short list in one section", () => {
352
- expect(mrkdwnSections(["Header:", "• a", "• b"])).toHaveLength(1);
353
- });
354
-
355
- it("hard-splits a single oversized line at the cap", () => {
356
- const sections = mrkdwnSections([
357
- "x".repeat(SLACK_SECTION_MRKDWN_MAX + 500),
358
- ]) as Array<{ text: { text: string } }>;
359
- expect(sections).toHaveLength(2);
360
- expect(sections[0]?.text.text.length).toBe(SLACK_SECTION_MRKDWN_MAX);
361
- expect(sections[1]?.text.text.length).toBe(500);
362
- });
363
- });
364
-
365
- describe("slackTableBlock", () => {
366
- it("builds a native table with header + rich_text link cells", () => {
367
- const block = slackTableBlock({
368
- headers: ["Service", "SHA", "Anyship", "Logs"],
369
- columnSettings: [
370
- { is_wrapped: true },
371
- { align: "left" },
372
- { align: "left" },
373
- { align: "left" },
374
- ],
375
- rows: [
376
- [
377
- slackRawTextCell("portal-website"),
378
- slackLinkCell({
379
- url: "https://github.com/anysphere/everysphere/commit/abc",
380
- text: "abcdef0",
381
- }),
382
- slackLinkCell({
383
- url: "https://anytool.corp.anysphere.co/anyship/deployments?deployment=d1",
384
- text: "open",
385
- }),
386
- slackRawTextCell("—"),
387
- ],
388
- ],
389
- });
390
- expect(block).toEqual({
391
- type: "table",
392
- column_settings: [
393
- { is_wrapped: true },
394
- { align: "left" },
395
- { align: "left" },
396
- { align: "left" },
397
- ],
398
- rows: [
399
- [
400
- { type: "raw_text", text: "Service" },
401
- { type: "raw_text", text: "SHA" },
402
- { type: "raw_text", text: "Anyship" },
403
- { type: "raw_text", text: "Logs" },
404
- ],
405
- [
406
- { type: "raw_text", text: "portal-website" },
407
- {
408
- type: "rich_text",
409
- elements: [
410
- {
411
- type: "rich_text_section",
412
- elements: [
413
- {
414
- type: "link",
415
- url: "https://github.com/anysphere/everysphere/commit/abc",
416
- text: "abcdef0",
417
- },
418
- ],
419
- },
420
- ],
421
- },
422
- {
423
- type: "rich_text",
424
- elements: [
425
- {
426
- type: "rich_text_section",
427
- elements: [
428
- {
429
- type: "link",
430
- url: "https://anytool.corp.anysphere.co/anyship/deployments?deployment=d1",
431
- text: "open",
432
- },
433
- ],
434
- },
435
- ],
436
- },
437
- { type: "raw_text", text: "—" },
438
- ],
439
- ],
440
- });
441
- });
442
-
443
- it("returns undefined for empty headers", () => {
444
- expect(slackTableBlock({ headers: [], rows: [] })).toBeUndefined();
445
- });
446
-
447
- it("rejects oversized or jagged tables", () => {
448
- expect(() =>
449
- slackTableBlock({
450
- headers: Array.from({ length: SLACK_TABLE_MAX_COLUMNS + 1 }, () => "c"),
451
- rows: [],
452
- })
453
- ).toThrow(/columns exceeds/);
454
- expect(() =>
455
- slackTableBlock({
456
- headers: ["A"],
457
- rows: Array.from({ length: SLACK_TABLE_MAX_ROWS }, () => [
458
- slackRawTextCell("x"),
459
- ]),
460
- })
461
- ).toThrow(/rows exceeds/);
462
- expect(() =>
463
- slackTableBlock({
464
- headers: ["A", "B"],
465
- rows: [[slackRawTextCell("only-one")]],
466
- })
467
- ).toThrow(/expected 2/);
468
- });
469
- });