@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
@@ -1,34 +1,34 @@
1
- # Slack agents
1
+ # Slack Agents
2
2
 
3
- A Slack agent wakes when someone mentions it, sends it a DM, or posts
4
- in a channel it watches. From there, it keeps the conversation in one
5
- thread and can reply all at once, stream the answer live, or decide for
6
- itself when to post updates.
3
+ Agent SDK makes it easy to build agents that work in Slack.
7
4
 
8
- Run `agent-sdk slack create --dir .`, then `agent-sdk slack doctor`.
5
+ A Slack agent wakes when someone mentions it, sends it a DM, or posts in a channel it watches. From
6
+ there, it keeps the conversation in one thread and can reply all at once, stream the answer live, or
7
+ decide for itself when to post updates. [Connect](#connect) sets up the Slack app.
9
8
 
10
9
  ## Answer a mention or DM
11
10
 
12
- Mention the bot in a channel or send it a DM, and it will answer in a
13
- thread on that message. Any follow-up in the same thread continues the
14
- conversation where it left off.
11
+ Mention the bot in a channel or send it a DM, and it will answer in a thread on that message. Any
12
+ follow-up in the same thread continues the conversation where it left off. All messages in one DM
13
+ share a session by default. Set `continuation: "slack.dmthread/v2"` to give each top-level DM its
14
+ own session and thread.
15
15
 
16
16
  ```ts
17
17
  // bot/channels/slack.ts
18
18
  import { slackChannel } from "@grok/agent-sdk/channels/slack";
19
19
 
20
20
  export default slackChannel({
21
- // TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN
21
+ // Reads TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN, so two bots
22
+ // on one host don't collide.
22
23
  envPrefix: "TRIAGE",
23
24
  });
24
25
  ```
25
26
 
26
27
  ## Post one reply with a status chip
27
28
 
28
- By default, Slack shows a status chip beneath the thread while the turn
29
- runs, cycling through idle messages until reasoning or tool activity
30
- gives it something more specific to show. When the turn finishes, the
31
- chip disappears and one complete reply lands in the thread.
29
+ By default, Slack shows a status chip under the thread while the turn runs, with idle messages until
30
+ reasoning or tool activity gives it more to show. When the turn finishes, the chip disappears and
31
+ one complete reply lands in the thread.
32
32
 
33
33
  ```ts
34
34
  export default slackChannel({
@@ -47,10 +47,9 @@ export default slackChannel({
47
47
 
48
48
  ## Stream a live reply
49
49
 
50
- In stream mode, the reply appears immediately and grows as the model
51
- writes. Slack shows its generic "is working..." state until the stream
52
- ends, while optional reasoning and tool cards keep progress inside the
53
- same message.
50
+ In stream mode, the reply appears immediately and grows as the model writes. Slack shows its generic
51
+ "is working..." state until the stream ends, while optional reasoning and tool cards keep progress
52
+ inside the same message.
54
53
 
55
54
  ```ts
56
55
  export default slackChannel({
@@ -66,24 +65,19 @@ export default slackChannel({
66
65
 
67
66
  ## Let the agent own every message
68
67
 
69
- Use agentic mode when the agent should decide how to communicate, not
70
- only what to say. The bot reacts to the parent message with eyes and
71
- shows a thinking chip, then the agent chooses when to post progress and
72
- how to deliver the final reply.
68
+ Use agentic mode when the agent should decide how to communicate as well as what to say. The bot
69
+ reacts to the parent message with eyes and shows a thinking chip, then the agent chooses when to
70
+ post progress and how to deliver the final reply.
73
71
 
74
- `slack-communication` gives those posts a Slack-aware voice by default:
75
- lead with the result, share progress when the picture changes, and keep
76
- tool chatter off the thread. Use `tone` for the rest of the
77
- communication contract, including voice, level of detail, formatting,
78
- and how updates should be structured.
72
+ `slack-communication` gives those posts a Slack-aware voice by default. Use `tone` to set the voice,
73
+ level of detail, formatting, and structure of updates.
79
74
 
80
75
  ```ts
81
76
  // bot/extensions/slack.ts
82
77
  import slackCommunication from "@grok/agent-sdk/extensions/slack-communication";
83
78
 
84
79
  export default slackCommunication({
85
- tone:
86
- "Be concise but warm. Use bullets for evidence and end with the next action.",
80
+ tone: "Be concise but warm. Use bullets for evidence and end with the next action.",
87
81
  });
88
82
  ```
89
83
 
@@ -96,20 +90,16 @@ export default slackChannel({
96
90
 
97
91
  ### Show steps as cards or as a checklist
98
92
 
99
- The agent calls `post-card` to show one step of its work, such as
100
- "Scan the repo". Each card has an `id`, a `title`, a `status`, and
101
- optional `details`. When the agent calls `post-card` again with the same
102
- `id`, Slack updates that card. The agent uses this to move a step from
103
- `in_progress` to `complete`.
93
+ The agent calls `post-card` to show one step of its work, such as "Scan the repo", with an `id`, a
94
+ `title`, a `status`, and optional `details`. Calling it again with the same `id` updates that card,
95
+ for example from `in_progress` to `complete`.
104
96
 
105
97
  `cards` sets how Slack draws these steps:
106
98
 
107
- | `cards` | What Slack shows | Use it when |
108
- | --- | --- | --- |
109
- | `{ display: "timeline" }` (default) | Each step is a separate card in the thread. | The turn has one or two short steps. |
110
- | `{ 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. |
111
-
112
- This bot shows its steps as one checklist with the title "Release check":
99
+ | `cards` | What Slack shows | Use it when |
100
+ | ----------------------------------- | ------------------------------------------- | --------------------------------------------- |
101
+ | `{ display: "timeline" }` (default) | A separate card in the thread for each step | One or two short steps |
102
+ | `{ display: "plan" }` | One checklist for every step in the turn | Several steps that readers track in one place |
113
103
 
114
104
  ```ts
115
105
  export default slackChannel({
@@ -120,33 +110,17 @@ export default slackChannel({
120
110
  });
121
111
  ```
122
112
 
123
- Know these rules for a plan:
124
-
125
- - The `title` is optional. It can have at most 256 characters.
126
- - You set the `title` in the channel configuration. The agent cannot
127
- change the title.
128
- - Each turn starts a new checklist with the same title.
129
- - The `pending` status shows a step that has not started. Use `pending`
130
- only in a plan.
131
- - `slackChannel` stops at startup if `cards` is not valid. For example,
132
- a `title` with `display: "timeline"` stops startup.
133
-
134
- `display` is Slack's
135
- [`task_display_mode`](https://docs.slack.dev/reference/methods/chat.startStream/),
136
- and the channel sends `title` as a `plan_update` chunk.
113
+ - `title` is optional and can be up to 256 characters.
114
+ - `pending` only works when `display` is `"plan"`.
137
115
 
138
116
  ## Wake on a channel post
139
117
 
140
- This example watches `#triage-alerts`, so any substantial top-level
141
- message starts a thread even when nobody mentions the bot. The length
142
- guard filters out short posts before they can start a turn.
118
+ This example watches `#triage-alerts`, so any substantial top-level message starts a thread even
119
+ when nobody mentions the bot.
143
120
 
144
- Mentions work in any channel the bot has joined. Listening without a
145
- mention requires an explicit allowlist with at least one channel ID
146
- starting with `C` or `G` and at most 10 distinct IDs. You can add
147
- `#name` entries for readability. A lone `"*"` watches replies in every
148
- joined channel (`posts: "replies"`), but it does not wake on top-level
149
- posts. Do not mix `"*"` with channel IDs.
121
+ Mentions work in any channel the bot has joined. To listen without a mention, list between 1 and 10
122
+ channel IDs that start with `C` or `G`, plus optional `#name` entries for readability. On its own,
123
+ `"*"` watches thread replies in every joined channel but never wakes on top-level posts.
150
124
 
151
125
  ```ts
152
126
  export default slackChannel({
@@ -167,97 +141,44 @@ export default slackChannel({
167
141
  });
168
142
  ```
169
143
 
170
- When you create the app, pass `--channel-posts` and invite the bot to
171
- every channel in the allowlist.
172
-
173
- On Cursor-managed hosting, the channel IDs in `allow` define which
174
- top-level posts can wake the agent. Replies in threads the agent has
175
- already joined still arrive. `debounceMs` applies only when you
176
- self-host. Add the `channels:read` scope when you include `#name`
177
- labels.
144
+ When you create the app, pass `--channel-posts` and invite the bot to every channel in the
145
+ allowlist. Add the `channels:read` scope when you use `#name` entries. On Cursor hosting,
146
+ `debounceMs` has no effect.
178
147
 
179
148
  ## Control who can message
180
149
 
181
- By default, people outside your workspace get no reply. This matters
182
- most in Slack Connect channels, where external collaborators share the
183
- channel and can mention or reply to bots installed by your
184
- organization. Keeping `blockExternals` on prevents them from starting
185
- or steering an agent session and, through it, directing any tools
186
- available to the agent.
150
+ By default, the agent doesn't reply to people outside your workspace, such as Slack Connect guests.
151
+ Set `blockExternals: false` only if those people should be able to use the agent.
187
152
 
188
- Set `blockExternals: false` only when external collaborators are
189
- intended users of the agent.
153
+ Anyone in a thread can continue its session by default. To keep the conversation between the agent
154
+ and the person who started it, set `respondTo: "author"`.
190
155
 
191
156
  ```ts
192
157
  export default slackChannel({
193
- // Let external collaborators start and continue agent sessions.
194
- policy: { blockExternals: false },
195
- });
196
- ```
197
-
198
- Anyone in a thread can continue its session by default. If the
199
- conversation should stay between the agent and its original author,
200
- set `respondTo: "author"`.
201
-
202
- ```ts
203
- export default slackChannel({
204
- policy: { respondTo: "author" },
158
+ policy: { blockExternals: false, respondTo: "author" },
205
159
  });
206
160
  ```
207
161
 
208
162
  ## Events
209
163
 
210
- Mentions and DMs wake the agent automatically, while `onChannelPost`
211
- runs for messages in watched channels. Declare `onAppMention` or
212
- `onDirectMessage` when you need to filter those default wakes; each
213
- handler returns `{}` to start a turn or `null` to skip it.
214
-
215
- For example, this handler only starts a turn for DMs prefixed with
216
- `triage:`:
164
+ Mentions and DMs wake the agent automatically. Declare `onAppMention` or `onDirectMessage` to filter
165
+ them. Like `onChannelPost`, each handler returns `{}` to start a turn or `null` to skip the message.
166
+ This handler only starts a turn for DMs that begin with `triage:`:
217
167
 
218
168
  ```ts
219
169
  onDirectMessage: async (_ctx, message) => {
220
170
  if (!message.markdown.startsWith("triage:")) {
221
171
  return null;
222
172
  }
223
- // `{}` starts a model turn as the sender.
224
173
  return {};
225
174
  },
226
175
  ```
227
176
 
228
- ## Thread affinity
229
-
230
- Mention the bot in a channel and it answers in a thread on that message.
231
- Follow-ups in the same thread continue that session.
232
-
233
- A direct message continues the one session for that DM, including replies
234
- under later top-level messages. To give each top-level DM its own session,
235
- and keep replies in that message's thread on it, set the continuation
236
- selector:
237
-
238
- ```ts
239
- export default slackChannel({
240
- continuation: "slack.dmthread/v2",
241
- });
242
- ```
243
-
244
- Under `slack.dmthread/v2`, a DM thread behaves like a channel thread: a
245
- reply loads the thread's history, the turn edits only its own placeholder,
246
- and an approval click must come from that thread.
247
-
248
- Channel threads keep one session per thread with either selector.
249
- `slack.none/v2` starts a new session on every delivery.
250
-
251
177
  ## Call Slack from deterministic code via `ctx`
252
178
 
253
- Channel hooks can post before starting the model turn, which is useful
254
- for deterministic acknowledgements such as `Looking at this now.` The
255
- same bot credential also lets tools call Slack later in the turn:
256
-
257
- - Channel hooks: `ctx.thread.post()`, `ctx.slack.channelId`,
258
- `ctx.slack.threadTs`
259
-
260
- - Tools: `ctx.host.slack.getClient()`
179
+ A hook can post a fixed acknowledgement before the model turn starts, using `ctx.thread.post()`,
180
+ `ctx.slack.channelId`, and `ctx.slack.threadTs`, while tools call the Slack Web API with
181
+ `ctx.host.slack.getClient()`.
261
182
 
262
183
  ```ts
263
184
  onAppMention: async (ctx, message) => {
@@ -269,38 +190,36 @@ onAppMention: async (ctx, message) => {
269
190
  },
270
191
  ```
271
192
 
272
- Use the IDs on the hook `ctx` when handling an event, and
273
- `ctx.host.slack.getClient()` when a tool needs the Slack Web API.
274
-
275
193
  ## Connect
276
194
 
277
195
  ```bash
278
196
  agent-sdk login
279
197
  agent-sdk slack create --dir .
280
198
  agent-sdk slack doctor --prefix TRIAGE
199
+ agent-sdk serve --dir . --dev
281
200
  ```
282
201
 
283
- After you sign in, `slack create` opens **Add Slack to this agent** in
284
- the browser and writes the resulting tokens to `.env.local` without
285
- printing them. You can open the same wizard from **Integrations** on
286
- [Deployed Agents](https://cursor.com/dashboard/deployed-agents).
202
+ After you sign in, `slack create` opens **Add Slack to this agent** in the browser and writes the
203
+ resulting tokens to `.env.local` without printing them. You can open the same wizard from
204
+ **Integrations** on [Deployed Agents](https://cursor.com/dashboard/deployed-agents). `doctor`
205
+ catches missing credentials before you start the agent. The
206
+ [CLI reference](/docs/reference/cli.md#slack) covers each `slack` command.
287
207
 
288
- If Slack requires workspace-admin approval, keep `slack create` running and
289
- open the **Request approval** link printed by the CLI. Installing from
290
- [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**.
208
+ If your workspace requires admin approval, keep `slack create` running and open the **Request
209
+ approval** link it prints. Installing from Deployed Agents doesn't send that request. After an admin
210
+ approves, select **Retry** in the **Add Slack** wizard there.
291
211
 
292
212
  ### Choose the bot scopes
293
213
 
294
214
  A Cursor-managed app requests these bot scopes by default:
295
215
 
296
- `app_mentions:read`, `assistant:write`, `channels:history`,
297
- `channels:read`, `chat:write`, `files:read`, `files:write`,
298
- `groups:history`, `groups:read`, `im:history`, `im:read`, `im:write`,
299
- `mpim:history`, `reactions:read`, `reactions:write`, `usergroups:read`,
300
- `users:read`, `users:read.email`
216
+ `app_mentions:read`, `assistant:write`, `channels:history`, `channels:read`, `chat:write`,
217
+ `files:read`, `files:write`, `groups:history`, `groups:read`, `im:history`, `im:read`, `im:write`,
218
+ `mpim:history`, `reactions:read`, `reactions:write`, `usergroups:read`, `users:read`,
219
+ `users:read.email`
301
220
 
302
- To request a different list, set `botScopes` in `slack-manifest.json` at
303
- the root of the agent project. The app then requests exactly that list:
221
+ To request a different list, set `botScopes` in `slack-manifest.json` at the root of the agent
222
+ project. The app then requests exactly that list:
304
223
 
305
224
  ```json
306
225
  {
@@ -317,63 +236,16 @@ the root of the agent project. The app then requests exactly that list:
317
236
  }
318
237
  ```
319
238
 
320
- Then run `agent-sdk slack create` again (add `--env prod` for the production
321
- app). The CLI shows the list before it opens the browser. Slack updates
322
- the app and installs it again. If the workspace requires admin approval,
323
- the approval request lists every scope the app requests.
324
-
325
- - The list must include the required scopes: `app_mentions:read`,
326
- `assistant:write`, `channels:history`, `chat:write`, `groups:history`,
327
- `im:history`, and `reactions:read`. The Slack channel needs them to
328
- receive mentions, DMs, channel posts, and reactions, and to reply.
329
- - If you remove a default scope, the features that use it stop working.
330
- For example, file uploads need `files:write`.
331
- - Use bot scopes only, at most 50. User scopes are not supported.
332
- - Cursor rejects scopes in the Slack Marketplace forbidden families:
333
- `admin.*`, `identity.*`, `search:read*`, `triggers:*`,
334
- `apps_configuration:*`, and `workflow.steps:execute`.
335
- - Without `botScopes`, the app requests the default list plus any other
336
- scopes it already has. To remove a scope you added, list the scopes you
337
- want and run `agent-sdk slack create` again.
338
-
339
- The person who runs `agent-sdk slack create` also grants Cursor three user
340
- scopes in their own Slack account: `app_configurations:read`,
341
- `app_configurations:write`, and `managed_apps:install`. Cursor uses them
342
- to create, update, and install the agent's app. They are not scopes of
343
- the agent's app, and `botScopes` does not change them.
344
-
345
- If you already own the Slack app, initialize it with
346
- `agent-sdk slack init --manual --dir . --name "Triage"` and follow the
347
- [Slack setup skill](/docs/package/skills/setup-slack/SKILL.md) for installation
348
- and tokens.
349
-
350
- ## Test locally
351
-
352
- Run `doctor` first to catch missing credentials, then start the agent
353
- and send it the same mention or DM a teammate would.
354
-
355
- ```bash
356
- agent-sdk slack doctor --prefix TRIAGE
357
- agent-sdk serve --dir . --dev
358
- ```
359
-
360
- ## Practices
361
-
362
- - If the tokens are missing, the Slack channel stays idle while the
363
- rest of `serve` starts normally.
364
-
365
- - Keep `channelPosts.allow` narrow because each qualifying post can
366
- start a model turn.
239
+ Then run `agent-sdk slack create` again (add `--env prod` for the production app), and Slack updates
240
+ and reinstalls the app.
367
241
 
368
- - Set `envPrefix` when two Slack bots share a host so the token names
369
- do not collide.
242
+ - The list must include `app_mentions:read`, `assistant:write`, `channels:history`, `chat:write`,
243
+ `groups:history`, `im:history`, and `reactions:read`.
244
+ - Cursor rejects scopes in the Slack Marketplace forbidden families: `admin.*`, `identity.*`,
245
+ `search:read*`, `triggers:*`, `apps_configuration:*`, and `workflow.steps:execute`.
370
246
 
371
- ## Related
247
+ The person who runs `slack create` grants Cursor three user scopes on their own account so it can
248
+ create and install the app, and `botScopes` doesn't change them.
372
249
 
373
- - [CLI reference](/docs/reference/cli.md#slack): `slack create`,
374
- `doctor`, `init --manual`
375
- - [`skills/setup-slack/SKILL.md`](/docs/package/skills/setup-slack/SKILL.md):
376
- the companion skill for coding agents
377
- - [Webhooks and custom channels](/docs/guides/webhooks.md): host prep on mention
378
- and DM handlers
379
- - [Evals](/docs/evals.md): freeze a mention as a regression check
250
+ If you already own the Slack app, run `agent-sdk slack init --manual --dir . --name "Triage"` and
251
+ follow the `agent-sdk-setup-slack` skill for installation and tokens.