@grok/agent-sdk 0.2.29 → 0.4.0

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 (451) hide show
  1. package/dist/channels/slack/cli-project.js +1 -1
  2. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  3. package/dist/channels/slack/slack-channel.js +27 -14
  4. package/dist/docs/404.html +2 -2
  5. package/dist/docs/assets/{app.DMrZKFjI.js → app.BSH__xV4.js} +4 -4
  6. package/dist/docs/assets/building-with-agents.md.Bo3ct-rf.js +6 -0
  7. package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +1 -1
  8. package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
  9. package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +1 -0
  10. package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
  11. package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
  12. package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.K7t9nNY6.js} +1 -1
  13. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
  14. package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.DJLRMLkz.js} +1 -1
  15. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
  16. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
  17. package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
  18. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
  19. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
  20. package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
  21. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
  22. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
  26. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
  27. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
  28. package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
  29. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
  30. package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
  31. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
  32. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
  33. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
  34. package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
  35. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
  36. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
  37. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
  38. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
  39. package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.BQXhKtxS.js} +1 -1
  40. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
  41. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
  42. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
  43. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
  44. package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.CGtHp49X.js} +1 -1
  45. package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.CHZLYB52.js} +1 -1
  46. package/dist/docs/assets/chunks/{min.SPrSp704.js → min.D4Vt3eIy.js} +1 -1
  47. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
  48. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
  49. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
  50. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
  51. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
  52. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
  53. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
  54. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
  55. package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DGq7D4tt.js} +2 -2
  56. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
  57. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
  58. package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
  59. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
  60. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
  61. package/dist/docs/assets/deployment.md.DJtuDVLh.js +31 -0
  62. package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
  63. package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
  64. package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
  65. package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.DcB3nhOz.js} +8 -8
  66. package/dist/docs/assets/guides_agent-to-agent.md.DcB3nhOz.lean.js +1 -0
  67. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
  68. package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
  69. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
  70. package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
  71. package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
  72. package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
  73. package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.CcuZ7keS.js} +11 -19
  74. package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.CcuZ7keS.lean.js} +1 -1
  75. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
  76. package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
  77. package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
  78. package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
  79. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.js → guides_jev.md.DGCzkMUN.js} +20 -60
  80. package/dist/docs/assets/{guides_jev.md.CEqLgjj9.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
  81. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.js → guides_mcp-oauth.md.GVPMKcYl.js} +3 -5
  82. package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +1 -1
  83. package/dist/docs/assets/guides_migrate.md.B8CZxnnX.js +3 -0
  84. package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +1 -1
  85. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
  86. package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
  87. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
  88. package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
  89. package/dist/docs/assets/guides_slack.md.D7Rwyva4.js +82 -0
  90. package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.D7Rwyva4.lean.js} +1 -1
  91. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
  92. package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
  93. package/dist/docs/assets/hillclimbing.md.M51bF-oT.js +5 -0
  94. package/dist/docs/assets/hillclimbing.md.M51bF-oT.lean.js +1 -0
  95. package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
  96. package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
  97. package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
  98. package/dist/docs/assets/{quickstart.md.CljDaJBi.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
  99. package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
  100. package/dist/docs/assets/reference_access.md.C5lblfUC.lean.js +1 -0
  101. package/dist/docs/assets/reference_agent-config.md.BSNp2uJ7.js +27 -0
  102. package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.BSNp2uJ7.lean.js} +1 -1
  103. package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
  104. package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
  105. package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
  106. package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
  107. package/dist/docs/assets/reference_cli.md.DHm6DmYk.js +83 -0
  108. package/dist/docs/assets/reference_cli.md.DHm6DmYk.lean.js +1 -0
  109. package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
  110. package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
  111. package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
  112. package/dist/docs/assets/{reference_evals.md.2BXeMiO2.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
  113. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.js → reference_extensions.md.DHbW6eOf.js} +6 -8
  114. package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
  115. package/dist/docs/assets/reference_hooks.md.vbIM394-.js +39 -0
  116. package/dist/docs/assets/reference_hooks.md.vbIM394-.lean.js +1 -0
  117. package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
  118. package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
  119. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
  120. package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
  121. package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
  122. package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
  123. package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
  124. package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
  125. package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
  126. package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
  127. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
  128. package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
  129. package/dist/docs/assets/reference_schedules.md.Dd8_d0WG.js +45 -0
  130. package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +1 -1
  131. package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
  132. package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
  133. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
  134. package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
  135. package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
  136. package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
  137. package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
  138. package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
  139. package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
  140. package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
  141. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
  142. package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
  143. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
  144. package/dist/docs/assets/{troubleshooting.md.CGOdNVAL.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
  145. package/dist/docs/building-with-agents.html +41 -44
  146. package/dist/docs/building-with-agents.md +11 -104
  147. package/dist/docs/changelog.html +37 -37
  148. package/dist/docs/changelog.md +14 -145
  149. package/dist/docs/deployment.html +54 -54
  150. package/dist/docs/deployment.md +97 -270
  151. package/dist/docs/evals.html +52 -71
  152. package/dist/docs/evals.md +33 -129
  153. package/dist/docs/guides/agent-to-agent.html +43 -43
  154. package/dist/docs/guides/agent-to-agent.md +29 -64
  155. package/dist/docs/guides/bitbucket.html +62 -62
  156. package/dist/docs/guides/bitbucket.md +73 -134
  157. package/dist/docs/guides/cloud-agents.html +37 -37
  158. package/dist/docs/guides/cloud-agents.md +23 -53
  159. package/dist/docs/guides/convert-automation.html +39 -56
  160. package/dist/docs/guides/convert-automation.md +31 -115
  161. package/dist/docs/guides/github.html +46 -54
  162. package/dist/docs/guides/github.md +49 -131
  163. package/dist/docs/guides/gitlab.html +98 -108
  164. package/dist/docs/guides/gitlab.md +104 -184
  165. package/dist/docs/guides/improve.html +38 -43
  166. package/dist/docs/guides/improve.md +24 -90
  167. package/dist/docs/guides/jev.html +55 -95
  168. package/dist/docs/guides/jev.md +53 -160
  169. package/dist/docs/guides/mcp-oauth.html +38 -40
  170. package/dist/docs/guides/mcp-oauth.md +33 -67
  171. package/dist/docs/guides/migrate.html +38 -43
  172. package/dist/docs/guides/migrate.md +56 -130
  173. package/dist/docs/guides/opentelemetry.html +41 -43
  174. package/dist/docs/guides/opentelemetry.md +32 -27
  175. package/dist/docs/guides/pagerduty.html +50 -49
  176. package/dist/docs/guides/pagerduty.md +65 -199
  177. package/dist/docs/guides/slack.html +51 -57
  178. package/dist/docs/guides/slack.md +76 -204
  179. package/dist/docs/guides/webhooks.html +42 -42
  180. package/dist/docs/guides/webhooks.md +64 -146
  181. package/dist/docs/hashmap.json +1 -1
  182. package/dist/docs/hillclimbing.html +40 -42
  183. package/dist/docs/hillclimbing.md +40 -102
  184. package/dist/docs/index.html +49 -61
  185. package/dist/docs/index.md +42 -82
  186. package/dist/docs/llms-full.txt +2272 -5711
  187. package/dist/docs/llms.txt +9 -14
  188. package/dist/docs/quickstart.html +95 -152
  189. package/dist/docs/quickstart.md +91 -180
  190. package/dist/docs/reference/access.html +36 -36
  191. package/dist/docs/reference/access.md +7 -12
  192. package/dist/docs/reference/agent-config.html +45 -58
  193. package/dist/docs/reference/agent-config.md +92 -176
  194. package/dist/docs/reference/artifacts.html +38 -39
  195. package/dist/docs/reference/artifacts.md +38 -62
  196. package/dist/docs/reference/channels.html +38 -39
  197. package/dist/docs/reference/channels.md +102 -151
  198. package/dist/docs/reference/cli.html +68 -84
  199. package/dist/docs/reference/cli.md +232 -697
  200. package/dist/docs/reference/connections.html +45 -57
  201. package/dist/docs/reference/connections.md +83 -164
  202. package/dist/docs/reference/evals.html +47 -54
  203. package/dist/docs/reference/evals.md +75 -141
  204. package/dist/docs/reference/extensions.html +41 -43
  205. package/dist/docs/reference/extensions.md +37 -70
  206. package/dist/docs/reference/hooks.html +40 -52
  207. package/dist/docs/reference/hooks.md +62 -133
  208. package/dist/docs/reference/http-api.html +38 -42
  209. package/dist/docs/reference/http-api.md +66 -118
  210. package/dist/docs/reference/instructions.html +39 -39
  211. package/dist/docs/reference/instructions.md +19 -29
  212. package/dist/docs/reference/limits.html +38 -38
  213. package/dist/docs/reference/limits.md +9 -21
  214. package/dist/docs/reference/memory.html +37 -38
  215. package/dist/docs/reference/memory.md +38 -75
  216. package/dist/docs/reference/playground.html +36 -36
  217. package/dist/docs/reference/playground.md +14 -22
  218. package/dist/docs/reference/project-layout.html +49 -48
  219. package/dist/docs/reference/project-layout.md +38 -84
  220. package/dist/docs/reference/schedules.html +44 -46
  221. package/dist/docs/reference/schedules.md +59 -90
  222. package/dist/docs/reference/sessions.html +37 -37
  223. package/dist/docs/reference/sessions.md +66 -113
  224. package/dist/docs/reference/skills.html +39 -39
  225. package/dist/docs/reference/skills.md +11 -31
  226. package/dist/docs/reference/subagents.html +37 -37
  227. package/dist/docs/reference/subagents.md +17 -31
  228. package/dist/docs/reference/tools.html +47 -64
  229. package/dist/docs/reference/tools.md +48 -130
  230. package/dist/docs/templates/agentic-owners.html +38 -38
  231. package/dist/docs/templates/agentic-owners.md +50 -74
  232. package/dist/docs/templates/reviews.html +69 -0
  233. package/dist/docs/templates/reviews.md +71 -0
  234. package/dist/docs/troubleshooting.html +38 -36
  235. package/dist/docs/troubleshooting.md +48 -101
  236. package/dist/filesystem.d.ts +7 -320
  237. package/dist/filesystem.d.ts.map +1 -1
  238. package/dist/filesystem.js +10 -691
  239. package/dist/index.d.ts +1 -1
  240. package/dist/index.d.ts.map +1 -1
  241. package/dist/index.js +1 -1
  242. package/dist/internal/authored-alias-hooks.d.ts +6 -0
  243. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  244. package/dist/internal/authored-alias-hooks.js +12 -0
  245. package/dist/internal/authored-loaders.js +10 -1
  246. package/dist/internal/cli/commands/scaffold.js +1 -1
  247. package/dist/internal/cli-deploy.js +1 -1
  248. package/dist/internal/cli-docs.js +1 -1
  249. package/dist/internal/cli-images.js +1 -1
  250. package/dist/internal/cli-skills.js +1 -1
  251. package/dist/internal/continuation-session-ids.d.ts +15 -0
  252. package/dist/internal/continuation-session-ids.d.ts.map +1 -0
  253. package/dist/internal/continuation-session-ids.js +43 -0
  254. package/dist/internal/cursor/credentials.js +1 -1
  255. package/dist/internal/deploy-manifest.d.ts +1 -0
  256. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  257. package/dist/internal/deploy-manifest.js +0 -1
  258. package/dist/internal/discovery/agent-config.d.ts +2 -6
  259. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  260. package/dist/internal/discovery/agent-config.js +8 -25
  261. package/dist/internal/discovery/agent.d.ts.map +1 -1
  262. package/dist/internal/discovery/agent.js +2 -3
  263. package/dist/internal/discovery/project.d.ts.map +1 -1
  264. package/dist/internal/discovery/project.js +15 -0
  265. package/dist/internal/filesystem/walk.d.ts +1 -5
  266. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  267. package/dist/internal/filesystem/walk.js +1 -9
  268. package/dist/internal/hosted-catch-protocol.d.ts +3 -3
  269. package/dist/internal/hosted-catch-protocol.js +3 -3
  270. package/dist/internal/hosted-fetch.d.ts +7 -0
  271. package/dist/internal/hosted-fetch.d.ts.map +1 -0
  272. package/dist/internal/hosted-fetch.js +26 -0
  273. package/dist/internal/init-project.d.ts.map +1 -1
  274. package/dist/internal/init-project.js +7 -5
  275. package/dist/internal/install-cursor-skills.d.ts +5 -6
  276. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  277. package/dist/internal/install-cursor-skills.js +19 -4
  278. package/dist/internal/mcp-endpoint.js +4 -4
  279. package/dist/internal/model-config.d.ts.map +1 -1
  280. package/dist/internal/model-config.js +11 -4
  281. package/dist/internal/platform-timers.d.ts +3 -7
  282. package/dist/internal/platform-timers.d.ts.map +1 -1
  283. package/dist/internal/platform-timers.js +10 -51
  284. package/dist/internal/reminder-runner.js +1 -1
  285. package/dist/internal/server.d.ts.map +1 -1
  286. package/dist/internal/server.js +6 -1
  287. package/dist/internal/session-engine.d.ts +3 -0
  288. package/dist/internal/session-engine.d.ts.map +1 -1
  289. package/dist/internal/session-engine.js +13 -4
  290. package/dist/internal/shallow-clone.js +1 -1
  291. package/dist/playground/assets/index-Bno25Cg0.css +1 -0
  292. package/dist/playground/assets/index-SGKsaznh.js +62 -0
  293. package/dist/playground/index.html +2 -2
  294. package/dist/types.d.ts +6 -17
  295. package/dist/types.d.ts.map +1 -1
  296. package/dist/types.js +2 -2
  297. package/docs/README.md +42 -82
  298. package/docs/building-with-agents.md +11 -104
  299. package/docs/changelog.md +15 -146
  300. package/docs/deployment.md +97 -270
  301. package/docs/evals.md +34 -130
  302. package/docs/guides/agent-to-agent.md +29 -64
  303. package/docs/guides/bitbucket.md +73 -134
  304. package/docs/guides/cloud-agents.md +23 -53
  305. package/docs/guides/convert-automation.md +31 -115
  306. package/docs/guides/github.md +49 -131
  307. package/docs/guides/gitlab.md +104 -184
  308. package/docs/guides/improve.md +24 -90
  309. package/docs/guides/jev.md +53 -160
  310. package/docs/guides/mcp-oauth.md +33 -67
  311. package/docs/guides/migrate.md +56 -130
  312. package/docs/guides/opentelemetry.md +37 -27
  313. package/docs/guides/pagerduty.md +68 -200
  314. package/docs/guides/slack.md +76 -204
  315. package/docs/guides/webhooks.md +64 -146
  316. package/docs/hillclimbing.md +41 -103
  317. package/docs/quickstart.md +91 -180
  318. package/docs/reference/access.md +7 -12
  319. package/docs/reference/agent-config.md +92 -176
  320. package/docs/reference/artifacts.md +38 -62
  321. package/docs/reference/channels.md +102 -151
  322. package/docs/reference/cli.md +232 -697
  323. package/docs/reference/connections.md +83 -164
  324. package/docs/reference/evals.md +75 -141
  325. package/docs/reference/extensions.md +37 -70
  326. package/docs/reference/hooks.md +61 -132
  327. package/docs/reference/http-api.md +66 -118
  328. package/docs/reference/instructions.md +20 -30
  329. package/docs/reference/limits.md +10 -22
  330. package/docs/reference/memory.md +38 -75
  331. package/docs/reference/playground.md +14 -22
  332. package/docs/reference/project-layout.md +38 -84
  333. package/docs/reference/schedules.md +59 -90
  334. package/docs/reference/sessions.md +66 -113
  335. package/docs/reference/skills.md +12 -32
  336. package/docs/reference/subagents.md +17 -31
  337. package/docs/reference/tools.md +48 -130
  338. package/docs/templates/agentic-owners.md +50 -74
  339. package/docs/templates/reviews.md +76 -0
  340. package/docs/troubleshooting.md +48 -101
  341. package/package.json +4 -4
  342. package/skills/cli/SKILL.md +1 -1
  343. package/skills/create-agent/SKILL.md +61 -7
  344. package/skills/debug/SKILL.md +1 -1
  345. package/skills/deploy/SKILL.md +3 -3
  346. package/skills/evals/SKILL.md +1 -1
  347. package/skills/framework-map/SKILL.md +2 -2
  348. package/skills/github/SKILL.md +1 -1
  349. package/skills/hillclimb/SKILL.md +1 -1
  350. package/skills/mcp-auth/SKILL.md +1 -1
  351. package/skills/migrate-v2/SKILL.md +2 -3
  352. package/skills/otel/SKILL.md +1 -1
  353. package/skills/setup-slack/SKILL.md +2 -2
  354. package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
  355. package/dist/docs/assets/changelog.md.DrLFQUlu.js +0 -1
  356. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +0 -1
  357. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +0 -1
  358. package/dist/docs/assets/chunks/channel._fZX_hvU.js +0 -1
  359. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +0 -1
  360. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +0 -1
  361. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +0 -1
  362. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +0 -1
  363. package/dist/docs/assets/deployment.md.KW0Ni_rY.js +0 -31
  364. package/dist/docs/assets/evals.md.DiljU__Z.js +0 -68
  365. package/dist/docs/assets/evals.md.DiljU__Z.lean.js +0 -1
  366. package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
  367. package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
  368. package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
  369. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
  370. package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
  371. package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
  372. package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
  373. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
  374. package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
  375. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
  376. package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
  377. package/dist/docs/assets/guides_slack.md.BwXHURvY.js +0 -88
  378. package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
  379. package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
  380. package/dist/docs/assets/index.md.CAruw_rp.js +0 -26
  381. package/dist/docs/assets/index.md.CAruw_rp.lean.js +0 -1
  382. package/dist/docs/assets/quickstart.md.CljDaJBi.js +0 -170
  383. package/dist/docs/assets/reference_access.md.CEtibb4i.js +0 -1
  384. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +0 -1
  385. package/dist/docs/assets/reference_agent-config.md.Ck29qYNj.js +0 -40
  386. package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
  387. package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
  388. package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +0 -99
  389. package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +0 -1
  390. package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
  391. package/dist/docs/assets/reference_evals.md.2BXeMiO2.js +0 -76
  392. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
  393. package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
  394. package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
  395. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
  396. package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
  397. package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +0 -8
  398. package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +0 -1
  399. package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
  400. package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
  401. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
  402. package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
  403. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
  404. package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
  405. package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
  406. package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
  407. package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
  408. package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
  409. package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
  410. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
  411. package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
  412. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
  413. package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
  414. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
  415. package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
  416. package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
  417. package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
  418. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +0 -1
  419. package/dist/docs/guides/hooks.html +0 -113
  420. package/dist/docs/guides/hooks.md +0 -116
  421. package/dist/docs/package/skills/create-agent/SKILL.md +0 -178
  422. package/dist/docs/package/skills/evals/SKILL.md +0 -145
  423. package/dist/docs/package/skills/github/SKILL.md +0 -133
  424. package/dist/docs/package/skills/hillclimb/SKILL.md +0 -63
  425. package/dist/docs/package/skills/mcp-auth/SKILL.md +0 -60
  426. package/dist/docs/package/skills/migrate-v2/SKILL.md +0 -394
  427. package/dist/docs/package/skills/setup-slack/SKILL.md +0 -136
  428. package/dist/docs/reference/prompt.html +0 -68
  429. package/dist/docs/reference/prompt.md +0 -47
  430. package/dist/docs/templates/security-reviewer.html +0 -62
  431. package/dist/docs/templates/security-reviewer.md +0 -81
  432. package/dist/docs/templates/thermo-quality-review.html +0 -62
  433. package/dist/docs/templates/thermo-quality-review.md +0 -75
  434. package/dist/docs/templates/thermo-review.html +0 -62
  435. package/dist/docs/templates/thermo-review.md +0 -75
  436. package/dist/docs/templates/triage.html +0 -68
  437. package/dist/docs/templates/triage.md +0 -101
  438. package/dist/internal/filesystem/errors.d.ts +0 -64
  439. package/dist/internal/filesystem/errors.d.ts.map +0 -1
  440. package/dist/internal/filesystem/errors.js +0 -180
  441. package/dist/internal/filesystem/merge.d.ts +0 -34
  442. package/dist/internal/filesystem/merge.d.ts.map +0 -1
  443. package/dist/internal/filesystem/merge.js +0 -154
  444. package/dist/playground/assets/index-Cl9zvmmf.js +0 -62
  445. package/dist/playground/assets/index-F8b5WvWi.css +0 -1
  446. package/docs/guides/hooks.md +0 -121
  447. package/docs/reference/prompt.md +0 -52
  448. package/docs/templates/security-reviewer.md +0 -86
  449. package/docs/templates/thermo-quality-review.md +0 -80
  450. package/docs/templates/thermo-review.md +0 -80
  451. package/docs/templates/triage.md +0 -106
@@ -3,37 +3,37 @@ title: "Slack"
3
3
  description: "Wake your agent from mentions, DMs, and watched posts, then reply in the thread."
4
4
  ---
5
5
 
6
- # Slack agents
6
+ # Slack Agents
7
7
 
8
- A Slack agent wakes when someone mentions it, sends it a DM, or posts
9
- in a channel it watches. From there, it keeps the conversation in one
10
- thread and can reply all at once, stream the answer live, or decide for
11
- itself when to post updates.
8
+ Agent SDK makes it easy to build agents that work in Slack.
12
9
 
13
- Run `agent-sdk slack create --dir .`, then `agent-sdk slack doctor`.
10
+ A Slack agent wakes when someone mentions it, sends it a DM, or posts in a channel it watches. From
11
+ there, it keeps the conversation in one thread and can reply all at once, stream the answer live, or
12
+ decide for itself when to post updates. [Connect](#connect) sets up the Slack app.
14
13
 
15
14
  ## Answer a mention or DM
16
15
 
17
- Mention the bot in a channel or send it a DM, and it will answer in a
18
- thread on that message. Any follow-up in the same thread continues the
19
- conversation where it left off.
16
+ Mention the bot in a channel or send it a DM, and it will answer in a thread on that message. Any
17
+ follow-up in the same thread continues the conversation where it left off. All messages in one DM
18
+ share a session by default. Set `continuation: "slack.dmthread/v2"` to give each top-level DM its
19
+ own session and thread.
20
20
 
21
21
  ```ts
22
22
  // bot/channels/slack.ts
23
23
  import { slackChannel } from "@grok/agent-sdk/channels/slack";
24
24
 
25
25
  export default slackChannel({
26
- // TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN
26
+ // Reads TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN, so two bots
27
+ // on one host don't collide.
27
28
  envPrefix: "TRIAGE",
28
29
  });
29
30
  ```
30
31
 
31
32
  ## Post one reply with a status chip
32
33
 
33
- By default, Slack shows a status chip beneath the thread while the turn
34
- runs, cycling through idle messages until reasoning or tool activity
35
- gives it something more specific to show. When the turn finishes, the
36
- chip disappears and one complete reply lands in the thread.
34
+ By default, Slack shows a status chip under the thread while the turn runs, with idle messages until
35
+ reasoning or tool activity gives it more to show. When the turn finishes, the chip disappears and
36
+ one complete reply lands in the thread.
37
37
 
38
38
  ```ts
39
39
  export default slackChannel({
@@ -52,10 +52,9 @@ export default slackChannel({
52
52
 
53
53
  ## Stream a live reply
54
54
 
55
- In stream mode, the reply appears immediately and grows as the model
56
- writes. Slack shows its generic "is working..." state until the stream
57
- ends, while optional reasoning and tool cards keep progress inside the
58
- same message.
55
+ In stream mode, the reply appears immediately and grows as the model writes. Slack shows its generic
56
+ "is working..." state until the stream ends, while optional reasoning and tool cards keep progress
57
+ inside the same message.
59
58
 
60
59
  ```ts
61
60
  export default slackChannel({
@@ -71,24 +70,19 @@ export default slackChannel({
71
70
 
72
71
  ## Let the agent own every message
73
72
 
74
- Use agentic mode when the agent should decide how to communicate, not
75
- only what to say. The bot reacts to the parent message with eyes and
76
- shows a thinking chip, then the agent chooses when to post progress and
77
- how to deliver the final reply.
73
+ Use agentic mode when the agent should decide how to communicate as well as what to say. The bot
74
+ reacts to the parent message with eyes and shows a thinking chip, then the agent chooses when to
75
+ post progress and how to deliver the final reply.
78
76
 
79
- `slack-communication` gives those posts a Slack-aware voice by default:
80
- lead with the result, share progress when the picture changes, and keep
81
- tool chatter off the thread. Use `tone` for the rest of the
82
- communication contract, including voice, level of detail, formatting,
83
- and how updates should be structured.
77
+ `slack-communication` gives those posts a Slack-aware voice by default. Use `tone` to set the voice,
78
+ level of detail, formatting, and structure of updates.
84
79
 
85
80
  ```ts
86
81
  // bot/extensions/slack.ts
87
82
  import slackCommunication from "@grok/agent-sdk/extensions/slack-communication";
88
83
 
89
84
  export default slackCommunication({
90
- tone:
91
- "Be concise but warm. Use bullets for evidence and end with the next action.",
85
+ tone: "Be concise but warm. Use bullets for evidence and end with the next action.",
92
86
  });
93
87
  ```
94
88
 
@@ -101,20 +95,16 @@ export default slackChannel({
101
95
 
102
96
  ### Show steps as cards or as a checklist
103
97
 
104
- The agent calls `post-card` to show one step of its work, such as
105
- "Scan the repo". Each card has an `id`, a `title`, a `status`, and
106
- optional `details`. When the agent calls `post-card` again with the same
107
- `id`, Slack updates that card. The agent uses this to move a step from
108
- `in_progress` to `complete`.
98
+ The agent calls `post-card` to show one step of its work, such as "Scan the repo", with an `id`, a
99
+ `title`, a `status`, and optional `details`. Calling it again with the same `id` updates that card,
100
+ for example from `in_progress` to `complete`.
109
101
 
110
102
  `cards` sets how Slack draws these steps:
111
103
 
112
- | `cards` | What Slack shows | Use it when |
113
- | --- | --- | --- |
114
- | `{ display: "timeline" }` (default) | Each step is a separate card in the thread. | The turn has one or two short steps. |
115
- | `{ display: "plan" }` | All steps from one turn are in one checklist. | The turn has several steps, and readers want to see progress in one place. |
116
-
117
- This bot shows its steps as one checklist with the title "Release check":
104
+ | `cards` | What Slack shows | Use it when |
105
+ | ----------------------------------- | ------------------------------------------- | --------------------------------------------- |
106
+ | `{ display: "timeline" }` (default) | A separate card in the thread for each step | One or two short steps |
107
+ | `{ display: "plan" }` | One checklist for every step in the turn | Several steps that readers track in one place |
118
108
 
119
109
  ```ts
120
110
  export default slackChannel({
@@ -125,33 +115,17 @@ export default slackChannel({
125
115
  });
126
116
  ```
127
117
 
128
- Know these rules for a plan:
129
-
130
- - The `title` is optional. It can have at most 256 characters.
131
- - You set the `title` in the channel configuration. The agent cannot
132
- change the title.
133
- - Each turn starts a new checklist with the same title.
134
- - The `pending` status shows a step that has not started. Use `pending`
135
- only in a plan.
136
- - `slackChannel` stops at startup if `cards` is not valid. For example,
137
- a `title` with `display: "timeline"` stops startup.
138
-
139
- `display` is Slack's
140
- [`task_display_mode`](https://docs.slack.dev/reference/methods/chat.startStream/),
141
- and the channel sends `title` as a `plan_update` chunk.
118
+ - `title` is optional and can be up to 256 characters.
119
+ - `pending` only works when `display` is `"plan"`.
142
120
 
143
121
  ## Wake on a channel post
144
122
 
145
- This example watches `#triage-alerts`, so any substantial top-level
146
- message starts a thread even when nobody mentions the bot. The length
147
- guard filters out short posts before they can start a turn.
123
+ This example watches `#triage-alerts`, so any substantial top-level message starts a thread even
124
+ when nobody mentions the bot.
148
125
 
149
- Mentions work in any channel the bot has joined. Listening without a
150
- mention requires an explicit allowlist with at least one channel ID
151
- starting with `C` or `G` and at most 10 distinct IDs. You can add
152
- `#name` entries for readability. A lone `"*"` watches replies in every
153
- joined channel (`posts: "replies"`), but it does not wake on top-level
154
- posts. Do not mix `"*"` with channel IDs.
126
+ Mentions work in any channel the bot has joined. To listen without a mention, list between 1 and 10
127
+ channel IDs that start with `C` or `G`, plus optional `#name` entries for readability. On its own,
128
+ `"*"` watches thread replies in every joined channel but never wakes on top-level posts.
155
129
 
156
130
  ```ts
157
131
  export default slackChannel({
@@ -172,97 +146,44 @@ export default slackChannel({
172
146
  });
173
147
  ```
174
148
 
175
- When you create the app, pass `--channel-posts` and invite the bot to
176
- every channel in the allowlist.
177
-
178
- On Cursor-managed hosting, the channel IDs in `allow` define which
179
- top-level posts can wake the agent. Replies in threads the agent has
180
- already joined still arrive. `debounceMs` applies only when you
181
- self-host. Add the `channels:read` scope when you include `#name`
182
- labels.
149
+ When you create the app, pass `--channel-posts` and invite the bot to every channel in the
150
+ allowlist. Add the `channels:read` scope when you use `#name` entries. On Cursor hosting,
151
+ `debounceMs` has no effect.
183
152
 
184
153
  ## Control who can message
185
154
 
186
- By default, people outside your workspace get no reply. This matters
187
- most in Slack Connect channels, where external collaborators share the
188
- channel and can mention or reply to bots installed by your
189
- organization. Keeping `blockExternals` on prevents them from starting
190
- or steering an agent session and, through it, directing any tools
191
- available to the agent.
155
+ By default, the agent doesn't reply to people outside your workspace, such as Slack Connect guests.
156
+ Set `blockExternals: false` only if those people should be able to use the agent.
192
157
 
193
- Set `blockExternals: false` only when external collaborators are
194
- intended users of the agent.
158
+ Anyone in a thread can continue its session by default. To keep the conversation between the agent
159
+ and the person who started it, set `respondTo: "author"`.
195
160
 
196
161
  ```ts
197
162
  export default slackChannel({
198
- // Let external collaborators start and continue agent sessions.
199
- policy: { blockExternals: false },
200
- });
201
- ```
202
-
203
- Anyone in a thread can continue its session by default. If the
204
- conversation should stay between the agent and its original author,
205
- set `respondTo: "author"`.
206
-
207
- ```ts
208
- export default slackChannel({
209
- policy: { respondTo: "author" },
163
+ policy: { blockExternals: false, respondTo: "author" },
210
164
  });
211
165
  ```
212
166
 
213
167
  ## Events
214
168
 
215
- Mentions and DMs wake the agent automatically, while `onChannelPost`
216
- runs for messages in watched channels. Declare `onAppMention` or
217
- `onDirectMessage` when you need to filter those default wakes; each
218
- handler returns `{}` to start a turn or `null` to skip it.
219
-
220
- For example, this handler only starts a turn for DMs prefixed with
221
- `triage:`:
169
+ Mentions and DMs wake the agent automatically. Declare `onAppMention` or `onDirectMessage` to filter
170
+ them. Like `onChannelPost`, each handler returns `{}` to start a turn or `null` to skip the message.
171
+ This handler only starts a turn for DMs that begin with `triage:`:
222
172
 
223
173
  ```ts
224
174
  onDirectMessage: async (_ctx, message) => {
225
175
  if (!message.markdown.startsWith("triage:")) {
226
176
  return null;
227
177
  }
228
- // `{}` starts a model turn as the sender.
229
178
  return {};
230
179
  },
231
180
  ```
232
181
 
233
- ## Thread affinity
234
-
235
- Mention the bot in a channel and it answers in a thread on that message.
236
- Follow-ups in the same thread continue that session.
237
-
238
- A direct message continues the one session for that DM, including replies
239
- under later top-level messages. To give each top-level DM its own session,
240
- and keep replies in that message's thread on it, set the continuation
241
- selector:
242
-
243
- ```ts
244
- export default slackChannel({
245
- continuation: "slack.dmthread/v2",
246
- });
247
- ```
248
-
249
- Under `slack.dmthread/v2`, a DM thread behaves like a channel thread: a
250
- reply loads the thread's history, the turn edits only its own placeholder,
251
- and an approval click must come from that thread.
252
-
253
- Channel threads keep one session per thread with either selector.
254
- `slack.none/v2` starts a new session on every delivery.
255
-
256
182
  ## Call Slack from deterministic code via `ctx`
257
183
 
258
- Channel hooks can post before starting the model turn, which is useful
259
- for deterministic acknowledgements such as `Looking at this now.` The
260
- same bot credential also lets tools call Slack later in the turn:
261
-
262
- - Channel hooks: `ctx.thread.post()`, `ctx.slack.channelId`,
263
- `ctx.slack.threadTs`
264
-
265
- - Tools: `ctx.host.slack.getClient()`
184
+ A hook can post a fixed acknowledgement before the model turn starts, using `ctx.thread.post()`,
185
+ `ctx.slack.channelId`, and `ctx.slack.threadTs`, while tools call the Slack Web API with
186
+ `ctx.host.slack.getClient()`.
266
187
 
267
188
  ```ts
268
189
  onAppMention: async (ctx, message) => {
@@ -274,38 +195,36 @@ onAppMention: async (ctx, message) => {
274
195
  },
275
196
  ```
276
197
 
277
- Use the IDs on the hook `ctx` when handling an event, and
278
- `ctx.host.slack.getClient()` when a tool needs the Slack Web API.
279
-
280
198
  ## Connect
281
199
 
282
200
  ```bash
283
201
  agent-sdk login
284
202
  agent-sdk slack create --dir .
285
203
  agent-sdk slack doctor --prefix TRIAGE
204
+ agent-sdk serve --dir . --dev
286
205
  ```
287
206
 
288
- After you sign in, `slack create` opens **Add Slack to this agent** in
289
- the browser and writes the resulting tokens to `.env.local` without
290
- printing them. You can open the same wizard from **Integrations** on
291
- [Deployed Agents](https://cursor.com/dashboard/deployed-agents).
207
+ After you sign in, `slack create` opens **Add Slack to this agent** in the browser and writes the
208
+ resulting tokens to `.env.local` without printing them. You can open the same wizard from
209
+ **Integrations** on [Deployed Agents](https://cursor.com/dashboard/deployed-agents). `doctor`
210
+ catches missing credentials before you start the agent. The
211
+ [CLI reference](../reference/cli.md#slack) covers each `slack` command.
292
212
 
293
- If Slack requires workspace-admin approval, keep `slack create` running and
294
- open the **Request approval** link printed by the CLI. Installing from
295
- [Deployed Agents](https://cursor.com/dashboard/deployed-agents) doesn't send that request for you. After an admin approves it, return to the **Add Slack** wizard there and select **Retry**.
213
+ If your workspace requires admin approval, keep `slack create` running and open the **Request
214
+ approval** link it prints. Installing from Deployed Agents doesn't send that request. After an admin
215
+ approves, select **Retry** in the **Add Slack** wizard there.
296
216
 
297
217
  ### Choose the bot scopes
298
218
 
299
219
  A Cursor-managed app requests these bot scopes by default:
300
220
 
301
- `app_mentions:read`, `assistant:write`, `channels:history`,
302
- `channels:read`, `chat:write`, `files:read`, `files:write`,
303
- `groups:history`, `groups:read`, `im:history`, `im:read`, `im:write`,
304
- `mpim:history`, `reactions:read`, `reactions:write`, `usergroups:read`,
305
- `users:read`, `users:read.email`
221
+ `app_mentions:read`, `assistant:write`, `channels:history`, `channels:read`, `chat:write`,
222
+ `files:read`, `files:write`, `groups:history`, `groups:read`, `im:history`, `im:read`, `im:write`,
223
+ `mpim:history`, `reactions:read`, `reactions:write`, `usergroups:read`, `users:read`,
224
+ `users:read.email`
306
225
 
307
- To request a different list, set `botScopes` in `slack-manifest.json` at
308
- the root of the agent project. The app then requests exactly that list:
226
+ To request a different list, set `botScopes` in `slack-manifest.json` at the root of the agent
227
+ project. The app then requests exactly that list:
309
228
 
310
229
  ```json
311
230
  {
@@ -322,63 +241,16 @@ the root of the agent project. The app then requests exactly that list:
322
241
  }
323
242
  ```
324
243
 
325
- Then run `agent-sdk slack create` again (add `--env prod` for the production
326
- app). The CLI shows the list before it opens the browser. Slack updates
327
- the app and installs it again. If the workspace requires admin approval,
328
- the approval request lists every scope the app requests.
329
-
330
- - The list must include the required scopes: `app_mentions:read`,
331
- `assistant:write`, `channels:history`, `chat:write`, `groups:history`,
332
- `im:history`, and `reactions:read`. The Slack channel needs them to
333
- receive mentions, DMs, channel posts, and reactions, and to reply.
334
- - If you remove a default scope, the features that use it stop working.
335
- For example, file uploads need `files:write`.
336
- - Use bot scopes only, at most 50. User scopes are not supported.
337
- - Cursor rejects scopes in the Slack Marketplace forbidden families:
338
- `admin.*`, `identity.*`, `search:read*`, `triggers:*`,
339
- `apps_configuration:*`, and `workflow.steps:execute`.
340
- - Without `botScopes`, the app requests the default list plus any other
341
- scopes it already has. To remove a scope you added, list the scopes you
342
- want and run `agent-sdk slack create` again.
343
-
344
- The person who runs `agent-sdk slack create` also grants Cursor three user
345
- scopes in their own Slack account: `app_configurations:read`,
346
- `app_configurations:write`, and `managed_apps:install`. Cursor uses them
347
- to create, update, and install the agent's app. They are not scopes of
348
- the agent's app, and `botScopes` does not change them.
349
-
350
- If you already own the Slack app, initialize it with
351
- `agent-sdk slack init --manual --dir . --name "Triage"` and follow the
352
- [Slack setup skill](../../skills/setup-slack/SKILL.md) for installation
353
- and tokens.
354
-
355
- ## Test locally
356
-
357
- Run `doctor` first to catch missing credentials, then start the agent
358
- and send it the same mention or DM a teammate would.
359
-
360
- ```bash
361
- agent-sdk slack doctor --prefix TRIAGE
362
- agent-sdk serve --dir . --dev
363
- ```
364
-
365
- ## Practices
366
-
367
- - If the tokens are missing, the Slack channel stays idle while the
368
- rest of `serve` starts normally.
369
-
370
- - Keep `channelPosts.allow` narrow because each qualifying post can
371
- start a model turn.
244
+ Then run `agent-sdk slack create` again (add `--env prod` for the production app), and Slack updates
245
+ and reinstalls the app.
372
246
 
373
- - Set `envPrefix` when two Slack bots share a host so the token names
374
- do not collide.
247
+ - The list must include `app_mentions:read`, `assistant:write`, `channels:history`, `chat:write`,
248
+ `groups:history`, `im:history`, and `reactions:read`.
249
+ - Cursor rejects scopes in the Slack Marketplace forbidden families: `admin.*`, `identity.*`,
250
+ `search:read*`, `triggers:*`, `apps_configuration:*`, and `workflow.steps:execute`.
375
251
 
376
- ## Related
252
+ The person who runs `slack create` grants Cursor three user scopes on their own account so it can
253
+ create and install the app, and `botScopes` doesn't change them.
377
254
 
378
- - [CLI reference](../reference/cli.md#slack): `slack create`,
379
- `doctor`, `init --manual`
380
- - [`skills/setup-slack/SKILL.md`](../../skills/setup-slack/SKILL.md):
381
- the companion skill for coding agents
382
- - [Webhooks and custom channels](./webhooks.md): host prep on mention
383
- and DM handlers
384
- - [Evals](../evals.md): freeze a mention as a regression check
255
+ If you already own the Slack app, run `agent-sdk slack init --manual --dir . --name "Triage"` and
256
+ follow the `agent-sdk-setup-slack` skill for installation and tokens.