@cursor/bdk 0.2.2 → 0.2.4

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 (697) hide show
  1. package/AGENTS.md +1 -1
  2. package/dist/bin/agent-serve.js +32 -8
  3. package/dist/channels/github/auth.d.ts.map +1 -1
  4. package/dist/channels/github/auth.js +36 -5
  5. package/dist/channels/slack/attachments.d.ts +2 -1
  6. package/dist/channels/slack/attachments.d.ts.map +1 -1
  7. package/dist/channels/slack/attachments.js +19 -9
  8. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  9. package/dist/channels/slack/dispatch.js +26 -24
  10. package/dist/channels/slack/thread-context.d.ts +21 -11
  11. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  12. package/dist/channels/slack/thread-context.js +75 -27
  13. package/dist/connections.d.ts +1 -1
  14. package/dist/connections.js +1 -1
  15. package/dist/docs/404.html +2 -2
  16. package/dist/docs/assets/{app.DtYVVVyK.js → app.4kQ8Db_q.js} +4 -4
  17. package/dist/docs/assets/chunks/@localSearchIndexroot.CvuAJ0My.js +1 -0
  18. package/dist/docs/assets/chunks/{VPLocalSearchBox.D47xT7J4.js → VPLocalSearchBox.DY1RwB8Q.js} +1 -1
  19. package/dist/docs/assets/chunks/{arc.CDJ6xzxR.js → arc.CxE_fSPK.js} +1 -1
  20. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.l1Xnjd3N.js → architectureDiagram-Q4EWVU46.CPX426ui.js} +1 -1
  21. package/dist/docs/assets/chunks/{baseUniq.x-finShZ.js → baseUniq.CB52JrKG.js} +1 -1
  22. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.COC3qynH.js → blockDiagram-DXYQGD6D.J0cNaQCL.js} +1 -1
  23. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DdQO850E.js → c4Diagram-AHTNJAMY.DJn3vEGT.js} +1 -1
  24. package/dist/docs/assets/chunks/channel.BoNycAoN.js +1 -0
  25. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.Dpn8omLk.js → chunk-4BX2VUAB.Dao618F6.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.C0XWStUN.js → chunk-4TB4RGXK.QW8Rhjai.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-55IACEB6.DsKSZfIM.js → chunk-55IACEB6.DfRLLKF_.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.dNU6JDu6.js → chunk-EDXVE4YY.CIV2ApKQ.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DN41fxKE.js → chunk-FMBD7UC4.BEheSuxp.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.COpKCZus.js → chunk-OYMX7WX6.CUN88ENB.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.HDB-azx2.js → chunk-QZHKN3VN.CgqCs8b_.js} +1 -1
  32. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DEeX_a2j.js → chunk-YZCP3GAM.iCH0nnTJ.js} +1 -1
  33. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.C4x07Gkj.js +1 -0
  34. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.C4x07Gkj.js +1 -0
  35. package/dist/docs/assets/chunks/clone.Db22cH_-.js +1 -0
  36. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.C3yGL2A8.js → cose-bilkent-S5V4N54A.BLcUxhWE.js} +1 -1
  37. package/dist/docs/assets/chunks/{dagre-KV5264BT.Bpl24en4.js → dagre-KV5264BT.Ep7LofOm.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.nFco6seU.js → diagram-5BDNPKRD.Bzf4GSQ4.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DXhA6DWR.js → diagram-G4DWMVQ6.DD6Jh-eM.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.8GoOYcwk.js → diagram-MMDJMWI5.oOIl8bWd.js} +1 -1
  41. package/dist/docs/assets/chunks/{diagram-TYMM5635.DDBlqvlJ.js → diagram-TYMM5635.DHs85Ade.js} +1 -1
  42. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.vl_N81P4.js → erDiagram-SMLLAGMA.BIb5ghCk.js} +1 -1
  43. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.Cteg8g7I.js → flowDiagram-DWJPFMVM.DV4paY9k.js} +1 -1
  44. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.D4aMhlMM.js → ganttDiagram-T4ZO3ILL.AyEKA6_v.js} +1 -1
  45. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.DF_J0D4q.js → gitGraphDiagram-UUTBAWPF.BltiCDFo.js} +1 -1
  46. package/dist/docs/assets/chunks/{graph.DJs0LDCf.js → graph.DzuEYGdC.js} +1 -1
  47. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.Bb-4RQwg.js → infoDiagram-42DDH7IO.BV2l981J.js} +1 -1
  48. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.DEtQRSbc.js → ishikawaDiagram-UXIWVN3A.BA4Izf-m.js} +1 -1
  49. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.DhQQ75FA.js → journeyDiagram-VCZTEJTY.DjaFbFS3.js} +1 -1
  50. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C4gEw3Rk.js → kanban-definition-6JOO6SKY.CfTFieDs.js} +1 -1
  51. package/dist/docs/assets/chunks/{layout.DT-PGlXa.js → layout.DzfWqTBV.js} +1 -1
  52. package/dist/docs/assets/chunks/{linear.BMMe__JW.js → linear.BO6mpulV.js} +1 -1
  53. package/dist/docs/assets/chunks/{min.XyaU9K9Q.js → min.BGgTadgT.js} +1 -1
  54. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CbBM6xZ-.js → mindmap-definition-QFDTVHPH.DPuIXVWY.js} +1 -1
  55. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.DFJoIVou.js → pieDiagram-DEJITSTG.BOnl3bBg.js} +1 -1
  56. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CQjkDYqb.js → quadrantDiagram-34T5L4WZ.DNB6Ckdc.js} +1 -1
  57. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.D-mK-JQu.js → requirementDiagram-MS252O5E.D5-Qo7vb.js} +1 -1
  58. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BStQInpd.js → sankeyDiagram-XADWPNL6.8t65cesf.js} +1 -1
  59. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.CA_eooPJ.js → sequenceDiagram-FGHM5R23.CaG07BdS.js} +1 -1
  60. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.BXl-b7ad.js → stateDiagram-FHFEXIEX.TKOweTB6.js} +1 -1
  61. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CuqmyQc4.js +1 -0
  62. package/dist/docs/assets/chunks/{theme.q37tOs4x.js → theme.Dx-JhpTB.js} +2 -2
  63. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.vjuaGOSe.js → timeline-definition-GMOUNBTQ.fE53zQ2s.js} +1 -1
  64. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.BxduJl-F.js → vennDiagram-DHZGUBPP.DJsZZaJg.js} +1 -1
  65. package/dist/docs/assets/chunks/wardley-RL74JXVD.844kyrjl.js +162 -0
  66. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.D1z3ds0D.js → wardleyDiagram-NUSXRM2D.CMZ-Ru_t.js} +1 -1
  67. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.CRU5Ti9b.js → xychartDiagram-5P7HB3ND.XXrhBc7a.js} +1 -1
  68. package/dist/docs/assets/{deployment.md.nGo1yIsa.js → deployment.md.UhnJIMr-.js} +6 -9
  69. package/dist/docs/assets/{deployment.md.nGo1yIsa.lean.js → deployment.md.UhnJIMr-.lean.js} +1 -1
  70. package/dist/docs/assets/{guides_github.md.C2_DSWlE.js → guides_github.md.Bq9kQU9B.js} +9 -3
  71. package/dist/docs/assets/{guides_github.md.C2_DSWlE.lean.js → guides_github.md.Bq9kQU9B.lean.js} +1 -1
  72. package/dist/docs/assets/{guides_jev.md.BNDm14Gy.js → guides_jev.md.CRcgmjDb.js} +2 -2
  73. package/dist/docs/assets/{guides_jev.md.BNDm14Gy.lean.js → guides_jev.md.CRcgmjDb.lean.js} +1 -1
  74. package/dist/docs/assets/{guides_slack.md.ZbHQETOT.js → guides_slack.md.diqqXTTm.js} +2 -2
  75. package/dist/docs/assets/{guides_slack.md.ZbHQETOT.lean.js → guides_slack.md.diqqXTTm.lean.js} +1 -1
  76. package/dist/docs/assets/{quickstart.md.wG4shE1f.js → quickstart.md.CHpHPBUN.js} +5 -3
  77. package/dist/docs/assets/{quickstart.md.wG4shE1f.lean.js → quickstart.md.CHpHPBUN.lean.js} +1 -1
  78. package/dist/docs/assets/{reference_agent-config.md.DzGI777n.js → reference_agent-config.md.Cj5uBKp4.js} +1 -1
  79. package/dist/docs/assets/{reference_artifacts.md.CFMNPreZ.js → reference_artifacts.md.CQfKq8F2.js} +1 -1
  80. package/dist/docs/assets/reference_cli.md.DgeLTO18.js +91 -0
  81. package/dist/docs/assets/reference_cli.md.DgeLTO18.lean.js +1 -0
  82. package/dist/docs/assets/{reference_connections.md._XpKiOaF.js → reference_connections.md.COq--gAm.js} +7 -3
  83. package/dist/docs/assets/{reference_connections.md._XpKiOaF.lean.js → reference_connections.md.COq--gAm.lean.js} +1 -1
  84. package/dist/docs/assets/{reference_evals.md.DqNyHMA6.js → reference_evals.md.CJm3uCUm.js} +4 -4
  85. package/dist/docs/assets/{reference_evals.md.DqNyHMA6.lean.js → reference_evals.md.CJm3uCUm.lean.js} +1 -1
  86. package/dist/docs/assets/{reference_extensions.md.CPPrkWlJ.js → reference_extensions.md.pa2tN-e4.js} +4 -3
  87. package/dist/docs/assets/{reference_extensions.md.CPPrkWlJ.lean.js → reference_extensions.md.pa2tN-e4.lean.js} +1 -1
  88. package/dist/docs/assets/{reference_skills.md.CRFTxt9M.js → reference_skills.md.Cy00QMKS.js} +3 -3
  89. package/dist/docs/assets/{reference_skills.md.CRFTxt9M.lean.js → reference_skills.md.Cy00QMKS.lean.js} +1 -1
  90. package/dist/docs/assets/troubleshooting.md.Cw5PKa3t.js +1 -0
  91. package/dist/docs/assets/{troubleshooting.md.BzZSu1Gz.lean.js → troubleshooting.md.Cw5PKa3t.lean.js} +1 -1
  92. package/dist/docs/building-with-agents.html +35 -35
  93. package/dist/docs/deployment.html +41 -44
  94. package/dist/docs/deployment.md +49 -16
  95. package/dist/docs/evals.html +35 -35
  96. package/dist/docs/guides/agent-to-agent.html +35 -35
  97. package/dist/docs/guides/bitbucket.html +35 -35
  98. package/dist/docs/guides/cloud-agents.html +35 -35
  99. package/dist/docs/guides/convert-automation.html +35 -35
  100. package/dist/docs/guides/github.html +43 -37
  101. package/dist/docs/guides/github.md +34 -0
  102. package/dist/docs/guides/gitlab.html +35 -35
  103. package/dist/docs/guides/grokbot-agents.html +35 -35
  104. package/dist/docs/guides/hooks.html +35 -35
  105. package/dist/docs/guides/improve.html +35 -35
  106. package/dist/docs/guides/jev.html +37 -37
  107. package/dist/docs/guides/jev.md +7 -0
  108. package/dist/docs/guides/mcp-oauth.html +35 -35
  109. package/dist/docs/guides/opentelemetry.html +35 -35
  110. package/dist/docs/guides/slack.html +37 -37
  111. package/dist/docs/guides/slack.md +5 -0
  112. package/dist/docs/guides/webhooks.html +35 -35
  113. package/dist/docs/hashmap.json +1 -1
  114. package/dist/docs/hillclimbing.html +35 -35
  115. package/dist/docs/index.html +35 -35
  116. package/dist/docs/llms-full.txt +223 -94
  117. package/dist/docs/quickstart.html +40 -38
  118. package/dist/docs/quickstart.md +7 -1
  119. package/dist/docs/reference/agent-config.html +37 -37
  120. package/dist/docs/reference/agent-config.md +1 -1
  121. package/dist/docs/reference/artifacts.html +37 -37
  122. package/dist/docs/reference/artifacts.md +1 -1
  123. package/dist/docs/reference/channels.html +35 -35
  124. package/dist/docs/reference/cli.html +55 -61
  125. package/dist/docs/reference/cli.md +65 -63
  126. package/dist/docs/reference/connections.html +42 -38
  127. package/dist/docs/reference/connections.md +28 -2
  128. package/dist/docs/reference/evals.html +39 -39
  129. package/dist/docs/reference/evals.md +6 -7
  130. package/dist/docs/reference/extensions.html +39 -38
  131. package/dist/docs/reference/extensions.md +13 -0
  132. package/dist/docs/reference/hooks.html +35 -35
  133. package/dist/docs/reference/http-api.html +35 -35
  134. package/dist/docs/reference/instructions.html +35 -35
  135. package/dist/docs/reference/playground.html +35 -35
  136. package/dist/docs/reference/project-layout.html +35 -35
  137. package/dist/docs/reference/prompt.html +35 -35
  138. package/dist/docs/reference/schedules.html +35 -35
  139. package/dist/docs/reference/sessions.html +35 -35
  140. package/dist/docs/reference/skills.html +38 -38
  141. package/dist/docs/reference/subagents.html +35 -35
  142. package/dist/docs/reference/tools.html +35 -35
  143. package/dist/docs/templates/agentic-owners.html +35 -35
  144. package/dist/docs/templates/security-reviewer.html +35 -35
  145. package/dist/docs/templates/thermo-quality-review.html +35 -35
  146. package/dist/docs/templates/thermo-review.html +35 -35
  147. package/dist/docs/templates/triage.html +35 -35
  148. package/dist/docs/troubleshooting.html +36 -36
  149. package/dist/docs/troubleshooting.md +7 -3
  150. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +77 -0
  151. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +1 -0
  152. package/dist/extensions/cursor-grokbot-agents/extension.js +63 -0
  153. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +11 -0
  154. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +1 -0
  155. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +31 -0
  156. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +56 -0
  157. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +1 -0
  158. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +158 -0
  159. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +28 -0
  160. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +1 -0
  161. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +59 -0
  162. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +53 -0
  163. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +1 -0
  164. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +206 -0
  165. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +4 -0
  166. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +1 -0
  167. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +15 -0
  168. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +12 -0
  169. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +1 -0
  170. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +25 -0
  171. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +40 -0
  172. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +4 -0
  173. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +1 -0
  174. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +37 -0
  175. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +4 -0
  176. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +1 -0
  177. package/dist/extensions/cursor-grokbot-agents/tools/check.js +32 -0
  178. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +4 -0
  179. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +1 -0
  180. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +24 -0
  181. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +4 -0
  182. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +1 -0
  183. package/dist/extensions/cursor-grokbot-agents/tools/list.js +34 -0
  184. package/dist/extensions/jev/extension.d.ts +3 -0
  185. package/dist/extensions/jev/extension.d.ts.map +1 -1
  186. package/dist/extensions/jev/extension.js +10 -1
  187. package/dist/extensions/jev/lib/evaluate.d.ts +4 -0
  188. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  189. package/dist/extensions/jev/lib/evaluate.js +6 -2
  190. package/dist/extensions.d.ts +4 -2
  191. package/dist/extensions.d.ts.map +1 -1
  192. package/dist/extensions.js +5 -2
  193. package/dist/internal/cli-ax.d.ts +1 -0
  194. package/dist/internal/cli-ax.d.ts.map +1 -1
  195. package/dist/internal/cli-ax.js +43 -10
  196. package/dist/internal/cli-deploy.d.ts +5 -1
  197. package/dist/internal/cli-deploy.d.ts.map +1 -1
  198. package/dist/internal/cli-deploy.js +41 -9
  199. package/dist/internal/cli-mcp-oauth.d.ts.map +1 -1
  200. package/dist/internal/cli-mcp-oauth.js +2 -1
  201. package/dist/internal/cli-skills.d.ts +1 -1
  202. package/dist/internal/cli-skills.d.ts.map +1 -1
  203. package/dist/internal/cli-skills.js +5 -5
  204. package/dist/internal/connection-env.d.ts +31 -0
  205. package/dist/internal/connection-env.d.ts.map +1 -0
  206. package/dist/internal/connection-env.js +84 -0
  207. package/dist/internal/cursor/backend-client.js +5 -0
  208. package/dist/internal/deploy-client.d.ts +30 -6
  209. package/dist/internal/deploy-client.d.ts.map +1 -1
  210. package/dist/internal/deploy-client.js +45 -9
  211. package/dist/internal/discovery/agent-config.d.ts +6 -5
  212. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  213. package/dist/internal/discovery/agent-config.js +29 -28
  214. package/dist/internal/discovery/agent.js +1 -1
  215. package/dist/internal/discovery/connections.d.ts.map +1 -1
  216. package/dist/internal/discovery/connections.js +11 -0
  217. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  218. package/dist/internal/discovery/extensions.js +12 -0
  219. package/dist/internal/hosted-delivery-protocol.d.ts +36 -11
  220. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  221. package/dist/internal/hosted-delivery-protocol.js +31 -8
  222. package/dist/internal/hosted-delivery.d.ts +2 -2
  223. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  224. package/dist/internal/hosted-delivery.js +228 -48
  225. package/dist/internal/hosting.d.ts +10 -2
  226. package/dist/internal/hosting.d.ts.map +1 -1
  227. package/dist/internal/hosting.js +33 -3
  228. package/dist/internal/install-cursor-skills.d.ts +20 -24
  229. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  230. package/dist/internal/install-cursor-skills.js +50 -48
  231. package/dist/internal/legacy-command-guard.d.ts +2 -0
  232. package/dist/internal/legacy-command-guard.d.ts.map +1 -1
  233. package/dist/internal/legacy-command-guard.js +10 -1
  234. package/dist/internal/mcp-host.d.ts +6 -0
  235. package/dist/internal/mcp-host.d.ts.map +1 -1
  236. package/dist/internal/mcp-host.js +35 -16
  237. package/dist/internal/sdk-runner.d.ts +2 -0
  238. package/dist/internal/sdk-runner.d.ts.map +1 -1
  239. package/dist/internal/sdk-runner.js +10 -0
  240. package/dist/internal/server.d.ts.map +1 -1
  241. package/dist/internal/server.js +11 -1
  242. package/dist/internal/session-engine.d.ts.map +1 -1
  243. package/dist/internal/session-engine.js +9 -5
  244. package/dist/types.d.ts +29 -3
  245. package/dist/types.d.ts.map +1 -1
  246. package/docs/deployment.md +49 -16
  247. package/docs/guides/github.md +34 -0
  248. package/docs/guides/jev.md +7 -0
  249. package/docs/guides/slack.md +5 -0
  250. package/docs/quickstart.md +7 -1
  251. package/docs/reference/agent-config.md +1 -1
  252. package/docs/reference/artifacts.md +1 -1
  253. package/docs/reference/cli.md +65 -63
  254. package/docs/reference/connections.md +28 -2
  255. package/docs/reference/evals.md +6 -7
  256. package/docs/reference/extensions.md +13 -0
  257. package/docs/troubleshooting.md +7 -3
  258. package/package.json +1 -11
  259. package/scripts/install-cursor-skills.mjs +1 -1
  260. package/skills/create-agent/SKILL.md +1 -1
  261. package/skills/debug/SKILL.md +1 -1
  262. package/skills/deploy/SKILL.md +1 -1
  263. package/skills/evals/SKILL.md +1 -1
  264. package/skills/framework-map/SKILL.md +1 -1
  265. package/skills/github/SKILL.md +1 -1
  266. package/skills/hillclimb/SKILL.md +1 -1
  267. package/skills/mcp-auth/SKILL.md +1 -1
  268. package/skills/otel/SKILL.md +1 -1
  269. package/skills/setup-slack/SKILL.md +1 -1
  270. package/templates/agents-md/bot/lib/collect.ts +1 -4
  271. package/templates/code-wiki/bot/channels/github.ts +2 -2
  272. package/templates/demo/bot/channels/github.ts +5 -1
  273. package/templates/pr-autofixer/bot/lib/start-drive.ts +4 -4
  274. package/templates/triage/bot/lib/types.ts +6 -6
  275. package/dist/docs/assets/chunks/@localSearchIndexroot.BgTA2tV1.js +0 -1
  276. package/dist/docs/assets/chunks/channel.B2nMEx82.js +0 -1
  277. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.D8iCH2ve.js +0 -1
  278. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.D8iCH2ve.js +0 -1
  279. package/dist/docs/assets/chunks/clone.5XNLjby0.js +0 -1
  280. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.yGM2uLZQ.js +0 -1
  281. package/dist/docs/assets/chunks/wardley-RL74JXVD.DKfyIejL.js +0 -162
  282. package/dist/docs/assets/reference_cli.md.BK2QUH67.js +0 -97
  283. package/dist/docs/assets/reference_cli.md.BK2QUH67.lean.js +0 -1
  284. package/dist/docs/assets/troubleshooting.md.BzZSu1Gz.js +0 -1
  285. package/src/artifacts.ts +0 -68
  286. package/src/bin/agent-serve.ts +0 -1833
  287. package/src/channels/bitbucket/api.ts +0 -891
  288. package/src/channels/bitbucket/binding.ts +0 -417
  289. package/src/channels/bitbucket/bitbucket-channel.ts +0 -162
  290. package/src/channels/bitbucket/bitbucket-webhook.ts +0 -519
  291. package/src/channels/bitbucket/checks.ts +0 -146
  292. package/src/channels/bitbucket/cursor-account.ts +0 -106
  293. package/src/channels/bitbucket/defaults.ts +0 -100
  294. package/src/channels/bitbucket/events.ts +0 -74
  295. package/src/channels/bitbucket/index.ts +0 -51
  296. package/src/channels/bitbucket/replay.ts +0 -421
  297. package/src/channels/bitbucket/state.ts +0 -59
  298. package/src/channels/bitbucket/types.ts +0 -261
  299. package/src/channels/change-monitors/change-monitors-channel.ts +0 -63
  300. package/src/channels/change-monitors/index.ts +0 -8
  301. package/src/channels/change-monitors/types.ts +0 -42
  302. package/src/channels/checks.ts +0 -185
  303. package/src/channels/deployments/deployments-channel.ts +0 -224
  304. package/src/channels/deployments/index.ts +0 -25
  305. package/src/channels/deployments/types.ts +0 -92
  306. package/src/channels/github/api.ts +0 -526
  307. package/src/channels/github/auth.ts +0 -254
  308. package/src/channels/github/binding.ts +0 -233
  309. package/src/channels/github/checks.ts +0 -145
  310. package/src/channels/github/cursor-account.ts +0 -303
  311. package/src/channels/github/defaults.ts +0 -168
  312. package/src/channels/github/events.ts +0 -67
  313. package/src/channels/github/forward.ts +0 -359
  314. package/src/channels/github/github-channel.ts +0 -2334
  315. package/src/channels/github/index.ts +0 -54
  316. package/src/channels/github/progress.ts +0 -365
  317. package/src/channels/github/replay.ts +0 -372
  318. package/src/channels/github/state.ts +0 -124
  319. package/src/channels/github/types.ts +0 -590
  320. package/src/channels/gitlab/api.ts +0 -329
  321. package/src/channels/gitlab/binding.ts +0 -231
  322. package/src/channels/gitlab/checks.ts +0 -228
  323. package/src/channels/gitlab/cursor-account.ts +0 -105
  324. package/src/channels/gitlab/defaults.ts +0 -80
  325. package/src/channels/gitlab/events.ts +0 -37
  326. package/src/channels/gitlab/gitlab-channel.ts +0 -160
  327. package/src/channels/gitlab/gitlab-webhook.ts +0 -509
  328. package/src/channels/gitlab/index.ts +0 -44
  329. package/src/channels/gitlab/replay.ts +0 -328
  330. package/src/channels/gitlab/state.ts +0 -55
  331. package/src/channels/gitlab/types.ts +0 -247
  332. package/src/channels/issues/index.ts +0 -9
  333. package/src/channels/issues/issues-channel.ts +0 -45
  334. package/src/channels/issues/types.ts +0 -38
  335. package/src/channels/origin/api.ts +0 -507
  336. package/src/channels/origin/binding.ts +0 -114
  337. package/src/channels/origin/checks.ts +0 -250
  338. package/src/channels/origin/cursor-account.ts +0 -58
  339. package/src/channels/origin/defaults.ts +0 -140
  340. package/src/channels/origin/events.ts +0 -35
  341. package/src/channels/origin/index.ts +0 -35
  342. package/src/channels/origin/origin-channel.ts +0 -815
  343. package/src/channels/origin/origin-webhook.ts +0 -296
  344. package/src/channels/origin/reactions.ts +0 -72
  345. package/src/channels/origin/state.ts +0 -54
  346. package/src/channels/origin/types.ts +0 -295
  347. package/src/channels/slack/agentic-delivery.ts +0 -634
  348. package/src/channels/slack/agentic-posted.ts +0 -135
  349. package/src/channels/slack/agentic-signals.ts +0 -231
  350. package/src/channels/slack/api.ts +0 -761
  351. package/src/channels/slack/approvals.ts +0 -279
  352. package/src/channels/slack/assistant.ts +0 -76
  353. package/src/channels/slack/attachments.ts +0 -596
  354. package/src/channels/slack/auth.ts +0 -127
  355. package/src/channels/slack/blocks.ts +0 -131
  356. package/src/channels/slack/bot-mentions.ts +0 -318
  357. package/src/channels/slack/channel-watch.ts +0 -314
  358. package/src/channels/slack/cli-project.ts +0 -249
  359. package/src/channels/slack/code-fences.ts +0 -171
  360. package/src/channels/slack/constants.ts +0 -38
  361. package/src/channels/slack/credentials.ts +0 -88
  362. package/src/channels/slack/defaults.ts +0 -714
  363. package/src/channels/slack/dispatch.ts +0 -1060
  364. package/src/channels/slack/doctor.ts +0 -338
  365. package/src/channels/slack/eval-directive.ts +0 -306
  366. package/src/channels/slack/event-id-dedupe.ts +0 -30
  367. package/src/channels/slack/external-policy.ts +0 -75
  368. package/src/channels/slack/footer.ts +0 -106
  369. package/src/channels/slack/inbound.ts +0 -416
  370. package/src/channels/slack/index.ts +0 -53
  371. package/src/channels/slack/init.ts +0 -169
  372. package/src/channels/slack/interactive.ts +0 -406
  373. package/src/channels/slack/links.ts +0 -23
  374. package/src/channels/slack/live-delivery.ts +0 -489
  375. package/src/channels/slack/log.ts +0 -70
  376. package/src/channels/slack/manifest.ts +0 -240
  377. package/src/channels/slack/message-body.ts +0 -82
  378. package/src/channels/slack/nudge-carrier.ts +0 -224
  379. package/src/channels/slack/nudge-store.ts +0 -334
  380. package/src/channels/slack/paint-start.ts +0 -93
  381. package/src/channels/slack/placeholder.ts +0 -358
  382. package/src/channels/slack/pr-ref.ts +0 -74
  383. package/src/channels/slack/progress-delivery.ts +0 -138
  384. package/src/channels/slack/reasoning-card.ts +0 -125
  385. package/src/channels/slack/reasoning-chip.ts +0 -41
  386. package/src/channels/slack/recording-sink.ts +0 -167
  387. package/src/channels/slack/redact.ts +0 -6
  388. package/src/channels/slack/reply-options.ts +0 -279
  389. package/src/channels/slack/setup.ts +0 -125
  390. package/src/channels/slack/slack-channel.ts +0 -744
  391. package/src/channels/slack/socket-mode.ts +0 -140
  392. package/src/channels/slack/stop.ts +0 -25
  393. package/src/channels/slack/stream.ts +0 -66
  394. package/src/channels/slack/thread-context.ts +0 -485
  395. package/src/channels/slack/tool-approval-events.ts +0 -233
  396. package/src/channels/slack/tool-cards.ts +0 -198
  397. package/src/channels/slack/tool-chip.ts +0 -34
  398. package/src/channels/slack/types.ts +0 -787
  399. package/src/channels/slack/upload.ts +0 -137
  400. package/src/channels.ts +0 -543
  401. package/src/connections.ts +0 -153
  402. package/src/dashboard-session-url.ts +0 -30
  403. package/src/evals/assertions.ts +0 -688
  404. package/src/evals/expect.ts +0 -250
  405. package/src/evals/judge.ts +0 -329
  406. package/src/evals/loaders.ts +0 -111
  407. package/src/evals/matchers.ts +0 -223
  408. package/src/evals/reporters.ts +0 -257
  409. package/src/evals/results.ts +0 -130
  410. package/src/evals/run-facts.ts +0 -306
  411. package/src/evals.ts +0 -709
  412. package/src/extensions/cursor-cloud-agents/extension.ts +0 -131
  413. package/src/extensions/cursor-cloud-agents/lib/backend.ts +0 -386
  414. package/src/extensions/cursor-cloud-agents/lib/channels.ts +0 -11
  415. package/src/extensions/cursor-cloud-agents/lib/fleet.ts +0 -98
  416. package/src/extensions/cursor-cloud-agents/lib/inputs.ts +0 -5
  417. package/src/extensions/cursor-cloud-agents/lib/repos.ts +0 -80
  418. package/src/extensions/cursor-cloud-agents/lib/transcript.ts +0 -19
  419. package/src/extensions/cursor-cloud-agents/skills/handoff.md +0 -37
  420. package/src/extensions/cursor-cloud-agents/tools/cancel.ts +0 -21
  421. package/src/extensions/cursor-cloud-agents/tools/dump.ts +0 -47
  422. package/src/extensions/cursor-cloud-agents/tools/get.ts +0 -18
  423. package/src/extensions/cursor-cloud-agents/tools/launch.ts +0 -62
  424. package/src/extensions/cursor-cloud-agents/tools/list.ts +0 -31
  425. package/src/extensions/cursor-cloud-agents/tools/reply.ts +0 -36
  426. package/src/extensions/improve/extension.ts +0 -69
  427. package/src/extensions/improve/skills/yourself.ts +0 -50
  428. package/src/extensions/jev/extension.ts +0 -95
  429. package/src/extensions/jev/lib/evaluate.ts +0 -266
  430. package/src/extensions/jev/skills/gated-write.md +0 -25
  431. package/src/extensions/jev/skills/questions.md +0 -33
  432. package/src/extensions/jev/tools/evaluate.ts +0 -82
  433. package/src/extensions/slack-communication/evals/harness.ts +0 -705
  434. package/src/extensions/slack-communication/evals/slack-communication.eval.ts +0 -830
  435. package/src/extensions/slack-communication/evals/slack-placeholder.eval.ts +0 -172
  436. package/src/extensions/slack-communication/extension.ts +0 -44
  437. package/src/extensions/slack-communication/skills/slack-voice.ts +0 -56
  438. package/src/extensions/slack-communication/tools/delete-message.ts +0 -33
  439. package/src/extensions/slack-communication/tools/edit-message.ts +0 -42
  440. package/src/extensions/slack-communication/tools/post-card.ts +0 -28
  441. package/src/extensions/slack-communication/tools/post-file.ts +0 -82
  442. package/src/extensions/slack-communication/tools/post-update.ts +0 -40
  443. package/src/extensions/slack-communication/tools/react.ts +0 -30
  444. package/src/extensions/slack-communication/tools/set-status.ts +0 -21
  445. package/src/extensions.ts +0 -179
  446. package/src/files-backends/agent-store-presigned-url.ts +0 -11
  447. package/src/files-backends/cursor-hosted.ts +0 -1212
  448. package/src/files-backends/local-fs.ts +0 -163
  449. package/src/files.ts +0 -293
  450. package/src/filesystem.ts +0 -2005
  451. package/src/hooks.ts +0 -30
  452. package/src/index.ts +0 -259
  453. package/src/internal/advertise-tools.ts +0 -370
  454. package/src/internal/approval-gate.ts +0 -103
  455. package/src/internal/artifacts-store.ts +0 -836
  456. package/src/internal/as-of.ts +0 -257
  457. package/src/internal/auth.ts +0 -46
  458. package/src/internal/authored-alias-hooks.ts +0 -138
  459. package/src/internal/authored-loaders.ts +0 -188
  460. package/src/internal/bounded-int.ts +0 -24
  461. package/src/internal/bounded.ts +0 -25
  462. package/src/internal/brand.ts +0 -28
  463. package/src/internal/browser-origin-guard.ts +0 -67
  464. package/src/internal/builtin-tools/artifacts.ts +0 -62
  465. package/src/internal/builtin-tools/index.ts +0 -53
  466. package/src/internal/builtin-tools/reminders.ts +0 -145
  467. package/src/internal/channel-dispatch.ts +0 -129
  468. package/src/internal/channel-route-dispatch.ts +0 -58
  469. package/src/internal/channel-state.ts +0 -83
  470. package/src/internal/chat-client.ts +0 -594
  471. package/src/internal/cli-ax.ts +0 -2273
  472. package/src/internal/cli-bitbucket.ts +0 -438
  473. package/src/internal/cli-convert-automation.ts +0 -335
  474. package/src/internal/cli-cursor.ts +0 -282
  475. package/src/internal/cli-deploy.ts +0 -2486
  476. package/src/internal/cli-docs.ts +0 -192
  477. package/src/internal/cli-github.ts +0 -806
  478. package/src/internal/cli-gitlab.ts +0 -452
  479. package/src/internal/cli-images.ts +0 -672
  480. package/src/internal/cli-manifest.ts +0 -56
  481. package/src/internal/cli-mcp-oauth.ts +0 -395
  482. package/src/internal/cli-mcp.ts +0 -808
  483. package/src/internal/cli-skills.ts +0 -99
  484. package/src/internal/cli-slack-manual.ts +0 -418
  485. package/src/internal/cli-slack.ts +0 -874
  486. package/src/internal/cloud-merge.ts +0 -51
  487. package/src/internal/cloud-turn-cost.ts +0 -159
  488. package/src/internal/continuation-channel.ts +0 -233
  489. package/src/internal/continuation-identity.ts +0 -935
  490. package/src/internal/conversation-mirror.ts +0 -423
  491. package/src/internal/convert-automation/convert-workflow.ts +0 -1377
  492. package/src/internal/convert-automation/slug.ts +0 -29
  493. package/src/internal/convert-automation/types.ts +0 -212
  494. package/src/internal/cron.ts +0 -76
  495. package/src/internal/cursor/account-mcp.ts +0 -692
  496. package/src/internal/cursor/backend-client.ts +0 -978
  497. package/src/internal/cursor/bound-secret-file.ts +0 -101
  498. package/src/internal/cursor/credentials.ts +0 -560
  499. package/src/internal/cursor/cursor-api-transport.ts +0 -65
  500. package/src/internal/cursor/github-credentials.ts +0 -228
  501. package/src/internal/cursor/hosted-bound-secrets.ts +0 -71
  502. package/src/internal/cursor/hosted-deployment-secrets.ts +0 -100
  503. package/src/internal/cursor/hosted-store-secrets.ts +0 -152
  504. package/src/internal/cursor/session-token.ts +0 -111
  505. package/src/internal/cursor/store-api-client.ts +0 -323
  506. package/src/internal/cursor-account-mcp-auth.ts +0 -303
  507. package/src/internal/cursor-agent-template.ts +0 -50
  508. package/src/internal/cursor-deployment-relay.ts +0 -315
  509. package/src/internal/cursor-event-relay.ts +0 -675
  510. package/src/internal/cursor-relay-core.ts +0 -563
  511. package/src/internal/deferred-channel-session.ts +0 -61
  512. package/src/internal/deploy-client.ts +0 -1504
  513. package/src/internal/deploy-manifest.ts +0 -361
  514. package/src/internal/deploy-source.ts +0 -144
  515. package/src/internal/describe-error.ts +0 -32
  516. package/src/internal/dev-mode.ts +0 -20
  517. package/src/internal/discovery/agent-config.ts +0 -288
  518. package/src/internal/discovery/agent.ts +0 -381
  519. package/src/internal/discovery/channels.ts +0 -100
  520. package/src/internal/discovery/connections.ts +0 -505
  521. package/src/internal/discovery/context.ts +0 -38
  522. package/src/internal/discovery/cursor-plugin.ts +0 -628
  523. package/src/internal/discovery/extension-overlay.ts +0 -247
  524. package/src/internal/discovery/extensions.ts +0 -490
  525. package/src/internal/discovery/fs.ts +0 -103
  526. package/src/internal/discovery/hooks.ts +0 -63
  527. package/src/internal/discovery/info.ts +0 -174
  528. package/src/internal/discovery/instructions.ts +0 -98
  529. package/src/internal/discovery/modules.ts +0 -107
  530. package/src/internal/discovery/names.ts +0 -45
  531. package/src/internal/discovery/project.ts +0 -319
  532. package/src/internal/discovery/reminders.ts +0 -65
  533. package/src/internal/discovery/runtime.ts +0 -158
  534. package/src/internal/discovery/schedules.ts +0 -120
  535. package/src/internal/discovery/seed-files.ts +0 -34
  536. package/src/internal/discovery/services.ts +0 -151
  537. package/src/internal/discovery/skills.ts +0 -174
  538. package/src/internal/discovery/subagent.ts +0 -138
  539. package/src/internal/discovery/tools.ts +0 -170
  540. package/src/internal/discovery.ts +0 -27
  541. package/src/internal/distribution.ts +0 -126
  542. package/src/internal/docs-site.ts +0 -248
  543. package/src/internal/duration.ts +0 -37
  544. package/src/internal/env-file.ts +0 -83
  545. package/src/internal/eval-judge-model.ts +0 -142
  546. package/src/internal/eval-run-store.ts +0 -585
  547. package/src/internal/eval-runner.ts +0 -823
  548. package/src/internal/evals-client.ts +0 -475
  549. package/src/internal/event-log.ts +0 -342
  550. package/src/internal/event-mapper.ts +0 -811
  551. package/src/internal/expected-delivery-failure.ts +0 -34
  552. package/src/internal/factory-resource-channel.ts +0 -103
  553. package/src/internal/filesystem/errors.ts +0 -207
  554. package/src/internal/filesystem/format.ts +0 -253
  555. package/src/internal/filesystem/merge.ts +0 -192
  556. package/src/internal/filesystem/nearest.ts +0 -112
  557. package/src/internal/filesystem/scratch.ts +0 -239
  558. package/src/internal/filesystem/sdk-schemas.ts +0 -204
  559. package/src/internal/filesystem/tools.ts +0 -804
  560. package/src/internal/filesystem/walk.ts +0 -366
  561. package/src/internal/fixtures/units-server.ts +0 -52
  562. package/src/internal/framework-file-storage.ts +0 -357
  563. package/src/internal/framework-storage-selection.ts +0 -156
  564. package/src/internal/frontmatter.ts +0 -108
  565. package/src/internal/github-fanout.ts +0 -144
  566. package/src/internal/guest-network.ts +0 -391
  567. package/src/internal/handleAgentServeTrigger.ts +0 -286
  568. package/src/internal/host-files.ts +0 -341
  569. package/src/internal/host-kv.ts +0 -81
  570. package/src/internal/host-otel.ts +0 -231
  571. package/src/internal/host-platforms.ts +0 -170
  572. package/src/internal/hosted-admission-adapter.ts +0 -47
  573. package/src/internal/hosted-admission-context.ts +0 -37
  574. package/src/internal/hosted-catch-protocol.ts +0 -112
  575. package/src/internal/hosted-catch.ts +0 -179
  576. package/src/internal/hosted-delivery-protocol.ts +0 -787
  577. package/src/internal/hosted-delivery.ts +0 -1152
  578. package/src/internal/hosted-execution-diag.ts +0 -291
  579. package/src/internal/hosted-execution-flush.ts +0 -136
  580. package/src/internal/hosted-execution-latency.ts +0 -301
  581. package/src/internal/hosted-managed-automation.ts +0 -116
  582. package/src/internal/hosting.ts +0 -107
  583. package/src/internal/http-channel-define.ts +0 -25
  584. package/src/internal/http-channel.ts +0 -669
  585. package/src/internal/http-control-plane-session.ts +0 -110
  586. package/src/internal/ids.ts +0 -39
  587. package/src/internal/incoming-headers-to-fetch.ts +0 -45
  588. package/src/internal/init-interview.ts +0 -360
  589. package/src/internal/init-project.ts +0 -711
  590. package/src/internal/init-scaffold.ts +0 -182
  591. package/src/internal/inline-stdio-define-stub.ts +0 -4
  592. package/src/internal/inline-stdio-mcp.ts +0 -230
  593. package/src/internal/install-cursor-skills.ts +0 -601
  594. package/src/internal/is-record.ts +0 -3
  595. package/src/internal/json-schema.ts +0 -95
  596. package/src/internal/legacy-command-guard.ts +0 -54
  597. package/src/internal/listen-port.ts +0 -85
  598. package/src/internal/local-control-plane.ts +0 -442
  599. package/src/internal/local-env.ts +0 -59
  600. package/src/internal/local-ingress.ts +0 -90
  601. package/src/internal/log-ring.ts +0 -59
  602. package/src/internal/logs-client.ts +0 -477
  603. package/src/internal/map-pool.ts +0 -39
  604. package/src/internal/mcp-endpoint.ts +0 -747
  605. package/src/internal/mcp-host.ts +0 -481
  606. package/src/internal/mcp-oauth-on-demand.ts +0 -337
  607. package/src/internal/mcp-oauth-persist.ts +0 -118
  608. package/src/internal/mcp-oauth.ts +0 -549
  609. package/src/internal/net.ts +0 -29
  610. package/src/internal/open-browser.ts +0 -41
  611. package/src/internal/otel/attrs.ts +0 -16
  612. package/src/internal/otel/collector.ts +0 -937
  613. package/src/internal/otel/config.ts +0 -287
  614. package/src/internal/otel/http.ts +0 -122
  615. package/src/internal/otel/mcp.ts +0 -56
  616. package/src/internal/otel/propagation.ts +0 -17
  617. package/src/internal/otel/runtime.ts +0 -441
  618. package/src/internal/package-inline-stdio.ts +0 -114
  619. package/src/internal/peer-connections.ts +0 -96
  620. package/src/internal/platform-schedule-sync.ts +0 -75
  621. package/src/internal/platform-timers.ts +0 -365
  622. package/src/internal/playground/static.ts +0 -278
  623. package/src/internal/playground/toolchain.ts +0 -270
  624. package/src/internal/playground-proxy.ts +0 -564
  625. package/src/internal/process-memory-telemetry.ts +0 -334
  626. package/src/internal/project-layout.ts +0 -31
  627. package/src/internal/prompt-context.ts +0 -116
  628. package/src/internal/reminder-control-plane-protocol.ts +0 -482
  629. package/src/internal/reminder-runner.ts +0 -1559
  630. package/src/internal/reminder-schedule.ts +0 -104
  631. package/src/internal/reminder-store.ts +0 -176
  632. package/src/internal/request-error-status.ts +0 -95
  633. package/src/internal/request-headers.ts +0 -21
  634. package/src/internal/resolve-prod-target.ts +0 -334
  635. package/src/internal/resolved-connections.ts +0 -190
  636. package/src/internal/router.ts +0 -143
  637. package/src/internal/run-client.ts +0 -354
  638. package/src/internal/runtime-dispatch-runner.ts +0 -50
  639. package/src/internal/sanitize-mcp-tool-name.ts +0 -31
  640. package/src/internal/schedule-runner.ts +0 -154
  641. package/src/internal/scm/pr-url.ts +0 -245
  642. package/src/internal/sdk-runner.ts +0 -948
  643. package/src/internal/serve-restart.ts +0 -113
  644. package/src/internal/server.ts +0 -3135
  645. package/src/internal/session-cost.ts +0 -208
  646. package/src/internal/session-engine.ts +0 -5618
  647. package/src/internal/session-links.ts +0 -84
  648. package/src/internal/session-run-log.ts +0 -535
  649. package/src/internal/session-store.ts +0 -307
  650. package/src/internal/session-urls.ts +0 -32
  651. package/src/internal/sessions-client.ts +0 -239
  652. package/src/internal/skill-catalog.ts +0 -66
  653. package/src/internal/skills-sync.ts +0 -55
  654. package/src/internal/slack-provision-client.ts +0 -544
  655. package/src/internal/slack-thread-key.ts +0 -11
  656. package/src/internal/sleep.ts +0 -3
  657. package/src/internal/start-log-store.ts +0 -164
  658. package/src/internal/steering.ts +0 -17
  659. package/src/internal/storage-coordinator.ts +0 -800
  660. package/src/internal/storage-roles.ts +0 -86
  661. package/src/internal/storage.ts +0 -1
  662. package/src/internal/store-api-protocol.ts +0 -205
  663. package/src/internal/store-mirror.ts +0 -73
  664. package/src/internal/stream-progress.ts +0 -294
  665. package/src/internal/terminal-style.ts +0 -133
  666. package/src/internal/testing/factory-resource-fixtures.ts +0 -84
  667. package/src/internal/testing/scm-continuation-fixtures.ts +0 -285
  668. package/src/internal/tool-catalog.ts +0 -104
  669. package/src/internal/tool-policy.ts +0 -222
  670. package/src/internal/tool-result.ts +0 -50
  671. package/src/internal/trajectory.ts +0 -418
  672. package/src/internal/turn-cost.ts +0 -136
  673. package/src/internal/turn-governor.ts +0 -145
  674. package/src/internal/turn-lease-store.ts +0 -144
  675. package/src/internal/turn-outbox.ts +0 -77
  676. package/src/internal/update-check.ts +0 -517
  677. package/src/internal/v2-hosting.ts +0 -52
  678. package/src/internal/workspace-sync.ts +0 -114
  679. package/src/internal/workspace.ts +0 -505
  680. package/src/kv/memory-kv.ts +0 -94
  681. package/src/kv.ts +0 -18
  682. package/src/memory.ts +0 -487
  683. package/src/otel-public.ts +0 -24
  684. package/src/otel.ts +0 -320
  685. package/src/prompt.ts +0 -80
  686. package/src/reminders.ts +0 -65
  687. package/src/schedules.ts +0 -31
  688. package/src/skills.ts +0 -27
  689. package/src/storage-backends/cursor-hosted-v2.ts +0 -204
  690. package/src/storage-backends/cursor-hosted.ts +0 -388
  691. package/src/storage-backends/file-kv.ts +0 -276
  692. package/src/storage-protocol.ts +0 -261
  693. package/src/storage.ts +0 -408
  694. package/src/tools.ts +0 -166
  695. package/src/types.ts +0 -3766
  696. /package/dist/docs/assets/{reference_agent-config.md.DzGI777n.lean.js → reference_agent-config.md.Cj5uBKp4.lean.js} +0 -0
  697. /package/dist/docs/assets/{reference_artifacts.md.CFMNPreZ.lean.js → reference_artifacts.md.CQfKq8F2.lean.js} +0 -0
@@ -1,761 +0,0 @@
1
- /**
2
- * Slack Web API helpers used by the channel pack (`@slack/web-api`).
3
- */
4
-
5
- import { ErrorCode, type WebAPIPlatformError, WebClient } from "@slack/web-api";
6
- import { slackifyMarkdown } from "slackify-markdown";
7
- import { slackThreadKey } from "../../internal/slack-thread-key.js";
8
- import type { ArtifactsApi, HostContext } from "../../types.js";
9
- import { highlightCodeFences } from "./code-fences.js";
10
- import {
11
- SLACK_DEFAULT_LOADING_MESSAGES,
12
- SLACK_LOADING_MESSAGE_MAX_LEN,
13
- SLACK_LOADING_MESSAGES_MAX,
14
- SLACK_STATUS_MAX_LEN,
15
- SLACK_TITLE_MAX_LEN,
16
- SLACK_TYPING_MIN_INTERVAL_MS,
17
- SLACK_UNSUPPORTED_ERRORS,
18
- } from "./constants.js";
19
- import { tryResolveAppToken, tryResolveBotToken } from "./credentials.js";
20
- import { defaultSlackLog, type SlackLog } from "./log.js";
21
- import type { StreamChunk } from "./stream.js";
22
- import type {
23
- SlackApiTransport,
24
- SlackBinding,
25
- SlackBotToken,
26
- SlackCredentials,
27
- SlackSuggestedPrompt,
28
- SoftSlackResult,
29
- } from "./types.js";
30
-
31
- /** Whether a bot token slot holds an API transport instead of a token. */
32
- export function isSlackApiTransport(token: SlackBotToken | undefined): token is SlackApiTransport {
33
- return (
34
- typeof token === "object" &&
35
- token !== null &&
36
- (token as SlackApiTransport).kind === "api-transport"
37
- );
38
- }
39
-
40
- export async function resolveBotToken(credentials: SlackCredentials | undefined): Promise<string> {
41
- const token = await tryResolveBotToken(credentials);
42
- if (token === undefined) {
43
- throw new Error(
44
- "SLACK_BOT_TOKEN is required (set credentials.botToken, envPrefix, or the env var).",
45
- );
46
- }
47
- return token;
48
- }
49
-
50
- /** Resolve the Socket Mode app-level token (`xapp-…`). */
51
- export async function resolveAppToken(credentials: SlackCredentials | undefined): Promise<string> {
52
- const token = await tryResolveAppToken(credentials);
53
- if (token === undefined) {
54
- throw new Error(
55
- "SLACK_APP_TOKEN is required for Socket Mode (set credentials.appToken, envPrefix, or the env var).",
56
- );
57
- }
58
- return token;
59
- }
60
-
61
- /** Channel-local continuation key. IMs are the channel; threads keep ts. */
62
- export function slackContinuationKey(channelId: string, threadTs: string): string {
63
- return slackThreadKey(channelId, threadTs);
64
- }
65
-
66
- function isPlatformError(error: unknown): error is WebAPIPlatformError {
67
- return (
68
- typeof error === "object" &&
69
- error !== null &&
70
- "code" in error &&
71
- (error as { code: unknown }).code === ErrorCode.PlatformError &&
72
- "data" in error
73
- );
74
- }
75
-
76
- async function createWebClient(botToken: SlackBotToken | undefined): Promise<WebClient> {
77
- return new WebClient(await resolveBotToken({ botToken }));
78
- }
79
-
80
- /**
81
- * Call a Slack Web API method. Platform errors (`ok: false`) are returned as
82
- * the response body (not thrown) so callers can soft-fail cleanly. When the
83
- * bot token slot holds a {@link SlackApiTransport} (e.g. the Cursor account
84
- * proxy), the call is executed by the transport instead of `@slack/web-api`.
85
- */
86
- export async function callSlackApi(args: {
87
- botToken: SlackBotToken | undefined;
88
- operation: string;
89
- body: Record<string, unknown>;
90
- }): Promise<Record<string, unknown>> {
91
- if (isSlackApiTransport(args.botToken)) {
92
- return args.botToken.call(args.operation, args.body);
93
- }
94
- const client = await createWebClient(args.botToken);
95
- try {
96
- const result = await client.apiCall(args.operation, args.body);
97
- return result as unknown as Record<string, unknown>;
98
- } catch (error) {
99
- if (isPlatformError(error)) {
100
- return error.data as unknown as Record<string, unknown>;
101
- }
102
- throw error;
103
- }
104
- }
105
-
106
- /**
107
- * Soft-fail wrapper: never throws for Slack API errors. Network/throw
108
- * errors become `{ ok: false, error }`. Unsupported feature errors set
109
- * `unsupported: true`.
110
- */
111
- export async function callSlackApiSoft(args: {
112
- botToken: SlackBotToken | undefined;
113
- operation: string;
114
- body: Record<string, unknown>;
115
- }): Promise<SoftSlackResult> {
116
- try {
117
- const response = await callSlackApi(args);
118
- if (response.ok === true) {
119
- return { ok: true, ...response };
120
- }
121
- const error = typeof response.error === "string" ? response.error : "unknown_error";
122
- return {
123
- ok: false,
124
- error,
125
- ...(SLACK_UNSUPPORTED_ERRORS.has(error) ? { unsupported: true } : {}),
126
- };
127
- } catch (error) {
128
- return {
129
- ok: false,
130
- error: error instanceof Error ? error.message : String(error),
131
- };
132
- }
133
- }
134
-
135
- export function truncateTypingStatus(status: string, max?: number): string {
136
- const limit = max ?? SLACK_STATUS_MAX_LEN;
137
- const trimmed = status.trim().replace(/\s+/g, " ");
138
- if (trimmed.length <= limit) {
139
- return trimmed;
140
- }
141
- return `${trimmed.slice(0, limit - 1)}…`;
142
- }
143
-
144
- /**
145
- * Slack caps `loading_messages` at 5. When the cleaned list is longer,
146
- * send a wrapping time-based window of 5 so later strings still appear.
147
- */
148
- export function truncateLoadingMessages(messages: string[], nowMs: number = Date.now()): string[] {
149
- const cleaned = messages
150
- .map(message => truncateTypingStatus(message, SLACK_LOADING_MESSAGE_MAX_LEN))
151
- .filter(message => message.length > 0);
152
- if (cleaned.length <= SLACK_LOADING_MESSAGES_MAX) {
153
- return cleaned;
154
- }
155
- const start = Math.floor(nowMs / SLACK_TYPING_MIN_INTERVAL_MS) % cleaned.length;
156
- const window: string[] = [];
157
- for (let i = 0; i < SLACK_LOADING_MESSAGES_MAX; i++) {
158
- const message = cleaned[(start + i) % cleaned.length];
159
- if (message === undefined) {
160
- break;
161
- }
162
- window.push(message);
163
- }
164
- return window;
165
- }
166
-
167
- export function truncateTitle(title: string, max?: number): string {
168
- const limit = max ?? SLACK_TITLE_MAX_LEN;
169
- const trimmed = title.trim().replace(/\s+/g, " ");
170
- if (trimmed.length <= limit) {
171
- return trimmed;
172
- }
173
- return `${trimmed.slice(0, limit - 1)}…`;
174
- }
175
-
176
- // ---------------------------------------------------------------------------
177
- // Assistant / stream helpers
178
- // ---------------------------------------------------------------------------
179
-
180
- /**
181
- * Show or clear the status chip under the thread.
182
- *
183
- * Status text goes through `assistant.threads.setStatus` alone. The agent
184
- * session is only written when clearing: Agent UX ignores an empty assistant
185
- * status, so `agents.sessions.setStatus` `active` is what actually drops the
186
- * chip. That same write must not accompany status text — Slack applies it
187
- * asynchronously and it blanks the chip when it lands after the text, which
188
- * reads as flicker between updates. A `processing` write would be worse:
189
- * Agent UX paints its own generic "is working…" over the assistant text
190
- * while the session is `processing`. An open `chat.startStream` also flips
191
- * the session to `processing` on Slack's side, so status text only shows on
192
- * non-streaming turns. The empty assistant call stays for older workspaces.
193
- */
194
- export async function setThreadStatus(args: {
195
- botToken: SlackBotToken | undefined;
196
- channelId: string;
197
- threadTs: string;
198
- status: string;
199
- loadingMessages?: string[];
200
- }): Promise<SoftSlackResult> {
201
- if (args.channelId === "" || args.threadTs === "") {
202
- return { ok: false, error: "missing_channel_or_thread" };
203
- }
204
- const status = truncateTypingStatus(args.status);
205
- const body: Record<string, unknown> = {
206
- channel_id: args.channelId,
207
- thread_ts: args.threadTs,
208
- status,
209
- };
210
-
211
- if (status.length > 0) {
212
- const loadingRaw =
213
- args.loadingMessages !== undefined && args.loadingMessages.length > 0
214
- ? args.loadingMessages
215
- : [status, ...SLACK_DEFAULT_LOADING_MESSAGES.filter(m => m !== status)];
216
- const loading_messages = truncateLoadingMessages(loadingRaw);
217
- if (loading_messages.length > 0) {
218
- body.loading_messages = loading_messages;
219
- }
220
- return callSlackApiSoft({
221
- botToken: args.botToken,
222
- operation: "assistant.threads.setStatus",
223
- body,
224
- });
225
- }
226
-
227
- const sessionResult = await callSlackApiSoft({
228
- botToken: args.botToken,
229
- operation: "agents.sessions.setStatus",
230
- body: {
231
- channel_id: args.channelId,
232
- thread_ts: args.threadTs,
233
- status: "active",
234
- },
235
- });
236
- const assistantResult = await callSlackApiSoft({
237
- botToken: args.botToken,
238
- operation: "assistant.threads.setStatus",
239
- body,
240
- });
241
-
242
- if (sessionResult.ok) {
243
- return sessionResult;
244
- }
245
- if (sessionResult.unsupported === true || assistantResult.ok) {
246
- return assistantResult;
247
- }
248
- return sessionResult;
249
- }
250
-
251
- export async function setThreadTitle(args: {
252
- botToken: SlackBotToken | undefined;
253
- channelId: string;
254
- threadTs: string;
255
- title: string;
256
- }): Promise<SoftSlackResult> {
257
- return callSlackApiSoft({
258
- botToken: args.botToken,
259
- operation: "assistant.threads.setTitle",
260
- body: {
261
- channel_id: args.channelId,
262
- thread_ts: args.threadTs,
263
- title: truncateTitle(args.title),
264
- },
265
- });
266
- }
267
-
268
- export async function setSuggestedPrompts(args: {
269
- botToken: SlackBotToken | undefined;
270
- channelId: string;
271
- threadTs?: string;
272
- prompts: SlackSuggestedPrompt[];
273
- title?: string;
274
- }): Promise<SoftSlackResult> {
275
- const body: Record<string, unknown> = {
276
- channel_id: args.channelId,
277
- prompts: args.prompts.map(p => ({
278
- title: p.title,
279
- message: p.message,
280
- })),
281
- };
282
- if (args.threadTs !== undefined && args.threadTs !== "") {
283
- body.thread_ts = args.threadTs;
284
- }
285
- if (args.title !== undefined && args.title !== "") {
286
- body.title = args.title;
287
- }
288
- return callSlackApiSoft({
289
- botToken: args.botToken,
290
- operation: "assistant.threads.setSuggestedPrompts",
291
- body,
292
- });
293
- }
294
-
295
- export async function startChatStream(args: {
296
- botToken: SlackBotToken | undefined;
297
- channel: string;
298
- thread_ts?: string;
299
- markdown_text?: string;
300
- chunks?: StreamChunk[];
301
- recipient_user_id?: string;
302
- recipient_team_id?: string;
303
- }): Promise<SoftSlackResult<{ ts: string; channel: string }>> {
304
- const body: Record<string, unknown> = {
305
- channel: args.channel,
306
- };
307
- // Empty markdown_text is rejected or opens a stream the assistant pane
308
- // never attaches. Recipients are required outside DMs.
309
- if (args.thread_ts !== undefined && args.thread_ts !== "") {
310
- body.thread_ts = args.thread_ts;
311
- }
312
- if (args.markdown_text !== undefined && args.markdown_text !== "") {
313
- body.markdown_text = args.markdown_text;
314
- }
315
- if (args.chunks !== undefined && args.chunks.length > 0) {
316
- body.chunks = args.chunks;
317
- }
318
- if (args.recipient_user_id !== undefined && args.recipient_user_id !== "") {
319
- body.recipient_user_id = args.recipient_user_id;
320
- }
321
- if (args.recipient_team_id !== undefined && args.recipient_team_id !== "") {
322
- body.recipient_team_id = args.recipient_team_id;
323
- }
324
- const result = await callSlackApiSoft({
325
- botToken: args.botToken,
326
- operation: "chat.startStream",
327
- body,
328
- });
329
- if (!result.ok) {
330
- return result;
331
- }
332
- const ts = typeof result.ts === "string" ? result.ts : "";
333
- const channel = typeof result.channel === "string" ? result.channel : args.channel;
334
- if (ts === "") {
335
- return { ok: false, error: "missing_ts" };
336
- }
337
- return { ok: true, ts, channel };
338
- }
339
-
340
- export async function appendChatStream(args: {
341
- botToken: SlackBotToken | undefined;
342
- channel: string;
343
- ts: string;
344
- markdown_text?: string;
345
- chunks?: StreamChunk[];
346
- }): Promise<SoftSlackResult> {
347
- const body: Record<string, unknown> = {
348
- channel: args.channel,
349
- ts: args.ts,
350
- };
351
- if (args.markdown_text !== undefined) {
352
- body.markdown_text = args.markdown_text;
353
- }
354
- if (args.chunks !== undefined && args.chunks.length > 0) {
355
- body.chunks = args.chunks;
356
- }
357
- return callSlackApiSoft({
358
- botToken: args.botToken,
359
- operation: "chat.appendStream",
360
- body,
361
- });
362
- }
363
-
364
- export async function stopChatStream(args: {
365
- botToken: SlackBotToken | undefined;
366
- channel: string;
367
- ts: string;
368
- markdown_text?: string;
369
- chunks?: StreamChunk[];
370
- blocks?: unknown[];
371
- }): Promise<SoftSlackResult> {
372
- const body: Record<string, unknown> = {
373
- channel: args.channel,
374
- ts: args.ts,
375
- };
376
- if (args.markdown_text !== undefined) {
377
- body.markdown_text = args.markdown_text;
378
- }
379
- if (args.chunks !== undefined && args.chunks.length > 0) {
380
- body.chunks = args.chunks;
381
- }
382
- if (args.blocks !== undefined && args.blocks.length > 0) {
383
- body.blocks = args.blocks;
384
- }
385
- return callSlackApiSoft({
386
- botToken: args.botToken,
387
- operation: "chat.stopStream",
388
- body,
389
- });
390
- }
391
-
392
- const SLACK_MRKDWN_LITERAL_PATTERN = /<(?:[@#!][^>\r\n]+|(?:https?|ftp|mailto|tel):[^>\r\n]+)>/gi;
393
- const SLACK_MRKDWN_LINK_PATTERN = /<https?:\/\/[^|>]+\|/;
394
-
395
- /**
396
- * Convert CommonMark accepted by `markdown_text` to Slack's legacy mrkdwn
397
- * without letting the CommonMark parser reinterpret Slack-native syntax.
398
- */
399
- export function markdownToSlackMrkdwn(markdown: string): string {
400
- const literals: string[] = [];
401
- const placeholder = (index: number): string => `\ue000SLACK_LITERAL_${index}\ue001`;
402
- const protectedMarkdown = markdown.replace(SLACK_MRKDWN_LITERAL_PATTERN, literal => {
403
- const index = literals.push(literal) - 1;
404
- return placeholder(index);
405
- });
406
-
407
- let converted = slackifyMarkdown(protectedMarkdown);
408
- if (!markdown.endsWith("\n") && converted.endsWith("\n")) {
409
- converted = converted.slice(0, -1);
410
- }
411
- for (const [index, literal] of literals.entries()) {
412
- converted = converted.replaceAll(placeholder(index), literal);
413
- }
414
- return converted;
415
- }
416
-
417
- function requiresMrkdwnText(text: string): boolean {
418
- return text.includes("<!subteam^") || SLACK_MRKDWN_LINK_PATTERN.test(text);
419
- }
420
-
421
- export async function postMessage(args: {
422
- botToken: SlackBotToken | undefined;
423
- channel: string;
424
- text: string;
425
- threadTs?: string;
426
- blocks?: unknown[];
427
- /**
428
- * Skip `markdown_text` and post with plain `text` only (Deploy Buddy /
429
- * host-report pattern). Prefer this for large structured bodies — Slack
430
- * `markdown_text` hard-caps at 12k while `text` allows ~40k.
431
- */
432
- plainText?: boolean;
433
- /** Slack message metadata (`{ event_type, event_payload }`). */
434
- metadata?: Record<string, unknown>;
435
- }): Promise<{ ts: string; channel: string }> {
436
- // Slack treats markdown_text as mutually exclusive with text and blocks
437
- // (error: markdown_text_conflict). Prefer markdown when we have no
438
- // blocks; with Block Kit or plainText, use text as body/fallback.
439
- const base: Record<string, unknown> = {
440
- channel: args.channel,
441
- unfurl_links: false,
442
- unfurl_media: false,
443
- };
444
- if (args.threadTs !== undefined && args.threadTs !== "") {
445
- base.thread_ts = args.threadTs;
446
- }
447
- if (args.metadata !== undefined) {
448
- base.metadata = args.metadata;
449
- }
450
- const hasBlocks = args.blocks !== undefined && args.blocks.length > 0;
451
- const convertToMrkdwn = args.plainText !== true && !hasBlocks && requiresMrkdwnText(args.text);
452
- // User-group mentions (`<!subteam^…>`) and Slack mrkdwn links
453
- // (`<https://…|label>`) only render correctly via mrkdwn `text`,
454
- // not `markdown_text`.
455
- const useText = args.plainText === true || hasBlocks || convertToMrkdwn;
456
-
457
- let response: Record<string, unknown>;
458
- if (useText) {
459
- response = await callSlackApi({
460
- botToken: args.botToken,
461
- operation: "chat.postMessage",
462
- body: {
463
- ...base,
464
- text: convertToMrkdwn ? markdownToSlackMrkdwn(args.text) : args.text,
465
- ...(hasBlocks ? { blocks: args.blocks } : {}),
466
- },
467
- });
468
- } else {
469
- response = await callSlackApi({
470
- botToken: args.botToken,
471
- operation: "chat.postMessage",
472
- body: {
473
- ...base,
474
- markdown_text: highlightCodeFences(args.text),
475
- },
476
- });
477
- // Older workspaces / scopes may not accept markdown_text — retry with text.
478
- // Also fall back when markdown_text hits its 12k limit (msg_too_long) while
479
- // plain text still allows up to ~40k.
480
- if (
481
- response.ok !== true &&
482
- (response.error === "markdown_text_conflict" ||
483
- response.error === "invalid_arguments" ||
484
- response.error === "invalid_blocks" ||
485
- response.error === "msg_too_long" ||
486
- SLACK_UNSUPPORTED_ERRORS.has(String(response.error ?? "")))
487
- ) {
488
- response = await callSlackApi({
489
- botToken: args.botToken,
490
- operation: "chat.postMessage",
491
- body: {
492
- ...base,
493
- text: markdownToSlackMrkdwn(args.text),
494
- },
495
- });
496
- }
497
- }
498
- if (response.ok !== true) {
499
- throw new Error(`Slack chat.postMessage failed: ${String(response.error ?? "unknown_error")}`);
500
- }
501
- // Slack requires thread_ts as a string. A numeric ts (JSON number) silently
502
- // drops threading server-side — never coerce via Number.
503
- const ts = typeof response.ts === "string" ? response.ts : "";
504
- if (ts === "") {
505
- throw new Error(`Slack chat.postMessage ok but missing string ts (got ${typeof response.ts})`);
506
- }
507
- // When we asked to thread, confirm Slack honored it — but only when the
508
- // response includes a thread_ts. Some proxy / customize-username payloads
509
- // omit `message.thread_ts` even for successful threaded posts; treating
510
- // that as failure retries (or deletes) replies and leaves empty threads.
511
- const requestedThreadTs = args.threadTs;
512
- if (requestedThreadTs !== undefined && requestedThreadTs !== "") {
513
- const message = response.message;
514
- if (typeof message === "object" && message !== null && !Array.isArray(message)) {
515
- const applied =
516
- typeof (message as { thread_ts?: unknown }).thread_ts === "string"
517
- ? (message as { thread_ts: string }).thread_ts
518
- : "";
519
- if (applied !== "" && applied !== requestedThreadTs) {
520
- throw new Error(
521
- `Slack chat.postMessage ignored thread_ts (requested ${requestedThreadTs}, got ${applied})`,
522
- );
523
- }
524
- }
525
- }
526
- // Slack returns the resolved channel ID (C…) even when the request used a name.
527
- const channel =
528
- typeof response.channel === "string" && response.channel !== ""
529
- ? response.channel
530
- : args.channel;
531
- return { ts, channel };
532
- }
533
-
534
- /** Replace an existing message (e.g. strip Approve/Deny after a decision). */
535
- export async function updateMessage(args: {
536
- botToken: SlackBotToken | undefined;
537
- channel: string;
538
- ts: string;
539
- text: string;
540
- blocks?: unknown[];
541
- /** Skip `markdown_text` and update with plain `text` only. */
542
- plainText?: boolean;
543
- }): Promise<SoftSlackResult> {
544
- const base: Record<string, unknown> = {
545
- channel: args.channel,
546
- ts: args.ts,
547
- };
548
- const useRawText = args.blocks !== undefined || args.plainText === true;
549
- const convertToMrkdwn = !useRawText && requiresMrkdwnText(args.text);
550
- if (useRawText || convertToMrkdwn) {
551
- // Blocks / plainText / user-group mentions / mrkdwn links force the
552
- // legacy text path (same as postMessage).
553
- return callSlackApiSoft({
554
- botToken: args.botToken,
555
- operation: "chat.update",
556
- body: {
557
- ...base,
558
- text: convertToMrkdwn ? markdownToSlackMrkdwn(args.text) : args.text,
559
- ...(args.blocks !== undefined ? { blocks: args.blocks } : {}),
560
- },
561
- });
562
- }
563
- let result = await callSlackApiSoft({
564
- botToken: args.botToken,
565
- operation: "chat.update",
566
- body: {
567
- ...base,
568
- markdown_text: args.text,
569
- },
570
- });
571
- // Older workspaces / scopes may not accept markdown_text — retry with text.
572
- // Also fall back when markdown_text hits its 12k limit (msg_too_long).
573
- if (
574
- !result.ok &&
575
- (result.error === "markdown_text_conflict" ||
576
- result.error === "invalid_arguments" ||
577
- result.error === "invalid_blocks" ||
578
- result.error === "msg_too_long" ||
579
- SLACK_UNSUPPORTED_ERRORS.has(String(result.error ?? "")))
580
- ) {
581
- result = await callSlackApiSoft({
582
- botToken: args.botToken,
583
- operation: "chat.update",
584
- body: {
585
- ...base,
586
- text: markdownToSlackMrkdwn(args.text),
587
- },
588
- });
589
- }
590
- return result;
591
- }
592
-
593
- /**
594
- * Delete a message (`chat.delete`). Soft-fails — used best-effort to remove an
595
- * orphaned skeleton before falling back to a fresh post, so a failed delete
596
- * never blocks delivery of the reply.
597
- */
598
- export async function deleteMessage(args: {
599
- botToken: SlackBotToken | undefined;
600
- channel: string;
601
- ts: string;
602
- }): Promise<SoftSlackResult> {
603
- if (args.channel === "" || args.ts === "") {
604
- return { ok: false, error: "missing_channel_or_ts" };
605
- }
606
- return callSlackApiSoft({
607
- botToken: args.botToken,
608
- operation: "chat.delete",
609
- body: {
610
- channel: args.channel,
611
- ts: args.ts,
612
- },
613
- });
614
- }
615
-
616
- /** Add an emoji reaction (`reactions.add`). Soft-fails. */
617
- export async function addReaction(args: {
618
- botToken: SlackBotToken | undefined;
619
- channel: string;
620
- ts: string;
621
- name: string;
622
- }): Promise<SoftSlackResult> {
623
- if (args.channel === "" || args.ts === "" || args.name === "") {
624
- return { ok: false, error: "missing_channel_ts_or_name" };
625
- }
626
- return callSlackApiSoft({
627
- botToken: args.botToken,
628
- operation: "reactions.add",
629
- body: {
630
- channel: args.channel,
631
- timestamp: args.ts,
632
- name: args.name,
633
- },
634
- });
635
- }
636
-
637
- /** Remove an emoji reaction (`reactions.remove`). Soft-fails. */
638
- export async function removeReaction(args: {
639
- botToken: SlackBotToken | undefined;
640
- channel: string;
641
- ts: string;
642
- name: string;
643
- }): Promise<SoftSlackResult> {
644
- if (args.channel === "" || args.ts === "" || args.name === "") {
645
- return { ok: false, error: "missing_channel_ts_or_name" };
646
- }
647
- return callSlackApiSoft({
648
- botToken: args.botToken,
649
- operation: "reactions.remove",
650
- body: {
651
- channel: args.channel,
652
- timestamp: args.ts,
653
- name: args.name,
654
- },
655
- });
656
- }
657
-
658
- export function buildSlackBinding(args: {
659
- botToken: SlackBotToken | undefined;
660
- channelId: string;
661
- threadTs: string;
662
- teamId?: string;
663
- host: HostContext;
664
- artifacts: ArtifactsApi;
665
- onThreadTsChanged?: (threadTs: string) => void;
666
- log?: SlackLog;
667
- }): SlackBinding {
668
- let threadTs = args.threadTs;
669
- const log = args.log ?? defaultSlackLog;
670
-
671
- const thread = {
672
- async post(text: string, options?: { blocks?: unknown[] }): Promise<{ ts: string }> {
673
- const result = await postMessage({
674
- botToken: args.botToken,
675
- channel: args.channelId,
676
- text,
677
- threadTs,
678
- ...(options?.blocks === undefined ? {} : { blocks: options.blocks }),
679
- });
680
- if (result.ts !== "" && threadTs === "") {
681
- threadTs = result.ts;
682
- args.onThreadTsChanged?.(result.ts);
683
- }
684
- log.info("postMessage ok", {
685
- channel: args.channelId,
686
- thread_ts: threadTs,
687
- message_ts: result.ts,
688
- });
689
- return { ts: result.ts };
690
- },
691
- async startTyping(status: string, loadingMessages?: string[]): Promise<void> {
692
- if (args.channelId === "" || threadTs === "") {
693
- return;
694
- }
695
- const result = await setThreadStatus({
696
- botToken: args.botToken,
697
- channelId: args.channelId,
698
- threadTs,
699
- status,
700
- ...(loadingMessages === undefined ? {} : { loadingMessages }),
701
- });
702
- if (!result.ok) {
703
- log.warn("slack setStatus not-ok", {
704
- error: result.error,
705
- channel: args.channelId,
706
- thread_ts: threadTs,
707
- });
708
- }
709
- },
710
- async setTitle(title: string): Promise<void> {
711
- if (args.channelId === "" || threadTs === "") {
712
- return;
713
- }
714
- const result = await setThreadTitle({
715
- botToken: args.botToken,
716
- channelId: args.channelId,
717
- threadTs,
718
- title,
719
- });
720
- if (!result.ok) {
721
- log.warn("assistant.threads.setTitle not-ok", {
722
- error: result.error,
723
- channel: args.channelId,
724
- thread_ts: threadTs,
725
- });
726
- }
727
- },
728
- async setSuggestedPrompts(prompts: SlackSuggestedPrompt[], title?: string): Promise<void> {
729
- if (args.channelId === "" || threadTs === "" || prompts.length === 0) {
730
- return;
731
- }
732
- const result = await setSuggestedPrompts({
733
- botToken: args.botToken,
734
- channelId: args.channelId,
735
- threadTs,
736
- prompts,
737
- ...(title === undefined ? {} : { title }),
738
- });
739
- if (!result.ok) {
740
- log.warn("assistant.threads.setSuggestedPrompts not-ok", {
741
- error: result.error,
742
- channel: args.channelId,
743
- thread_ts: threadTs,
744
- });
745
- }
746
- },
747
- };
748
-
749
- return {
750
- thread,
751
- slack: {
752
- channelId: args.channelId,
753
- get threadTs() {
754
- return threadTs;
755
- },
756
- ...(args.teamId === undefined ? {} : { teamId: args.teamId }),
757
- },
758
- host: args.host,
759
- artifacts: args.artifacts,
760
- };
761
- }