@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.
- package/dist/channels/slack/cli-project.js +1 -1
- package/dist/channels/slack/slack-channel.d.ts.map +1 -1
- package/dist/channels/slack/slack-channel.js +27 -14
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DMrZKFjI.js → app.BSH__xV4.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.Bo3ct-rf.js +6 -0
- package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +1 -1
- package/dist/docs/assets/changelog.md.b6H_ea44.js +1 -0
- package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.DQvuw1KA.js → VPLocalSearchBox.Cadl7A0k.js} +1 -1
- package/dist/docs/assets/chunks/{arc.ahOG-Qza.js → arc.K7t9nNY6.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.BcgfYNO_.js → architectureDiagram-Q4EWVU46.SlHEknkX.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.DeIYZrWh.js → baseUniq.DJLRMLkz.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.HjJ2goMX.js → blockDiagram-DXYQGD6D.Bs6XxFpe.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.C1QTb9GM.js → c4Diagram-AHTNJAMY.CyLg6Ovc.js} +1 -1
- package/dist/docs/assets/chunks/channel.CVTdqYx0.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.UuZiDiVp.js → chunk-4BX2VUAB.DTQ4TinT.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.5A3YmkhI.js → chunk-4TB4RGXK.Es84IgcH.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.B4uf1yYV.js → chunk-55IACEB6.Clm3cGPQ.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CoXBce8t.js → chunk-EDXVE4YY.DE4CRkS5.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DnC5NO4e.js → chunk-FMBD7UC4.Bf8HCvqp.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CzfHCeIi.js → chunk-OYMX7WX6.eub-7nSx.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.C6tcwkVd.js → chunk-QZHKN3VN.WyP9VAS_.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM._oboyZ1A.js → chunk-YZCP3GAM.LO9ohhDE.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +1 -0
- package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BfPVKeId.js → cose-bilkent-S5V4N54A.D5za6aH0.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CLMLc0lD.js → dagre-KV5264BT.Dq1daUru.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.C7OF7UfH.js → diagram-5BDNPKRD.j1YL5BKS.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Dpao0Bl1.js → diagram-G4DWMVQ6.Bi1aLdhC.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.DLnM9eLp.js → diagram-MMDJMWI5.BOzMEkAr.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.BcpVgA_M.js → diagram-TYMM5635.Dx2FVhCr.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.CsL5JuCV.js → erDiagram-SMLLAGMA.DI4TNkye.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.MFihq9AF.js → flowDiagram-DWJPFMVM.C58Z9uPK.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.CJeLodyG.js → ganttDiagram-T4ZO3ILL.DXSpW809.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.1HhlE45Z.js → gitGraphDiagram-UUTBAWPF.B955oaFl.js} +1 -1
- package/dist/docs/assets/chunks/{graph.BS02KkWA.js → graph.BQXhKtxS.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.fp5gvytQ.js → infoDiagram-42DDH7IO.Dozj_-Gm.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js → ishikawaDiagram-UXIWVN3A.D2140OzH.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.qJt4uJ_H.js → journeyDiagram-VCZTEJTY.DrqrMhCk.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.z2tG9kly.js → kanban-definition-6JOO6SKY.Dv-LTrlw.js} +1 -1
- package/dist/docs/assets/chunks/{layout.BPCkdejr.js → layout.CGtHp49X.js} +1 -1
- package/dist/docs/assets/chunks/{linear.CL3TC3u7.js → linear.CHZLYB52.js} +1 -1
- package/dist/docs/assets/chunks/{min.SPrSp704.js → min.D4Vt3eIy.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.DgrQRFZW.js → mindmap-definition-QFDTVHPH.BBfpYTea.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.Ba7yxiW2.js → pieDiagram-DEJITSTG.BVYvElmY.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.Bvskad4p.js → quadrantDiagram-34T5L4WZ.C6Gc2mdY.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.Ce70ugV9.js → requirementDiagram-MS252O5E.DWa8b4cn.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BJ5OEULO.js → sankeyDiagram-XADWPNL6.Bi-g4ajv.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.C8a1hDs6.js → sequenceDiagram-FGHM5R23.DlU3vVN9.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.D2D8A5CK.js → stateDiagram-FHFEXIEX.CeqJRqnU.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +1 -0
- package/dist/docs/assets/chunks/{theme.DRciHmS1.js → theme.DGq7D4tt.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C4ePrY8-.js → timeline-definition-GMOUNBTQ.Cqf2kjq9.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.Dzso6dEA.js → vennDiagram-DHZGUBPP.BeOpE_lM.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.djgXR0ar.js → wardley-RL74JXVD.FMQXA-6q.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.Bf2ICxjh.js → wardleyDiagram-NUSXRM2D.BXS65dAC.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.DEH4BcVJ.js → xychartDiagram-5P7HB3ND.haEiSxqc.js} +1 -1
- package/dist/docs/assets/deployment.md.DJtuDVLh.js +31 -0
- package/dist/docs/assets/{deployment.md.KW0Ni_rY.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
- package/dist/docs/assets/evals.md.Dne6VRmZ.js +49 -0
- package/dist/docs/assets/evals.md.Dne6VRmZ.lean.js +1 -0
- package/dist/docs/assets/{guides_agent-to-agent.md.D1D5f6Jc.js → guides_agent-to-agent.md.DcB3nhOz.js} +8 -8
- package/dist/docs/assets/guides_agent-to-agent.md.DcB3nhOz.lean.js +1 -0
- package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.js → guides_bitbucket.md.BiA6ZMFW.js} +27 -27
- package/dist/docs/assets/{guides_bitbucket.md.DkjkBRU8.lean.js → guides_bitbucket.md.BiA6ZMFW.lean.js} +1 -1
- package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +9 -0
- package/dist/docs/assets/{guides_cloud-agents.md.Ceyjv0ul.lean.js → guides_cloud-agents.md.CiXAW6on.lean.js} +1 -1
- package/dist/docs/assets/guides_convert-automation.md.BvTxsJ8J.js +26 -0
- package/dist/docs/assets/{guides_convert-automation.md.BjraCvok.lean.js → guides_convert-automation.md.BvTxsJ8J.lean.js} +1 -1
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.js → guides_github.md.CcuZ7keS.js} +11 -19
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.CcuZ7keS.lean.js} +1 -1
- package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.js → guides_gitlab.md.DcKusOcU.js} +63 -73
- package/dist/docs/assets/{guides_gitlab.md.DCE0p7_w.lean.js → guides_gitlab.md.DcKusOcU.lean.js} +1 -1
- package/dist/docs/assets/guides_improve.md.o3WOGR7n.js +16 -0
- package/dist/docs/assets/{guides_improve.md.BFYtrtLE.lean.js → guides_improve.md.o3WOGR7n.lean.js} +1 -1
- package/dist/docs/assets/{guides_jev.md.CEqLgjj9.js → guides_jev.md.DGCzkMUN.js} +20 -60
- package/dist/docs/assets/{guides_jev.md.CEqLgjj9.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.js → guides_mcp-oauth.md.GVPMKcYl.js} +3 -5
- package/dist/docs/assets/{guides_mcp-oauth.md.DrGY92u4.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.B8CZxnnX.js +3 -0
- package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +1 -1
- package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.js +26 -0
- package/dist/docs/assets/guides_opentelemetry.md.BRSktBHt.lean.js +1 -0
- package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.js +61 -0
- package/dist/docs/assets/guides_pagerduty.md.pMXUkZZc.lean.js +1 -0
- package/dist/docs/assets/guides_slack.md.D7Rwyva4.js +82 -0
- package/dist/docs/assets/{guides_slack.md.BwXHURvY.lean.js → guides_slack.md.D7Rwyva4.lean.js} +1 -1
- package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.js → guides_webhooks.md.B5DXt2v1.js} +7 -7
- package/dist/docs/assets/{guides_webhooks.md.BJk63ZTs.lean.js → guides_webhooks.md.B5DXt2v1.lean.js} +1 -1
- package/dist/docs/assets/hillclimbing.md.M51bF-oT.js +5 -0
- package/dist/docs/assets/hillclimbing.md.M51bF-oT.lean.js +1 -0
- package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
- package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
- package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
- package/dist/docs/assets/{quickstart.md.CljDaJBi.lean.js → quickstart.md.r-oE8nkX.lean.js} +1 -1
- package/dist/docs/assets/reference_access.md.C5lblfUC.js +1 -0
- package/dist/docs/assets/reference_access.md.C5lblfUC.lean.js +1 -0
- package/dist/docs/assets/reference_agent-config.md.BSNp2uJ7.js +27 -0
- package/dist/docs/assets/{reference_agent-config.md.Ck29qYNj.lean.js → reference_agent-config.md.BSNp2uJ7.lean.js} +1 -1
- package/dist/docs/assets/reference_artifacts.md.BJpAI7h9.js +17 -0
- package/dist/docs/assets/{reference_artifacts.md.C-hKR2hp.lean.js → reference_artifacts.md.BJpAI7h9.lean.js} +1 -1
- package/dist/docs/assets/reference_channels.md.CPWOpdsC.js +21 -0
- package/dist/docs/assets/{reference_channels.md.DsJfGSBJ.lean.js → reference_channels.md.CPWOpdsC.lean.js} +1 -1
- package/dist/docs/assets/reference_cli.md.DHm6DmYk.js +83 -0
- package/dist/docs/assets/reference_cli.md.DHm6DmYk.lean.js +1 -0
- package/dist/docs/assets/reference_connections.md.DoY4vrDH.js +54 -0
- package/dist/docs/assets/{reference_connections.md.BoAotr7_.lean.js → reference_connections.md.DoY4vrDH.lean.js} +1 -1
- package/dist/docs/assets/reference_evals.md.DgfUtfIc.js +69 -0
- package/dist/docs/assets/{reference_evals.md.2BXeMiO2.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.js → reference_extensions.md.DHbW6eOf.js} +6 -8
- package/dist/docs/assets/{reference_extensions.md.DI5X5x8p.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
- package/dist/docs/assets/reference_hooks.md.vbIM394-.js +39 -0
- package/dist/docs/assets/reference_hooks.md.vbIM394-.lean.js +1 -0
- package/dist/docs/assets/reference_http-api.md.C7Cb0r2J.js +7 -0
- package/dist/docs/assets/{reference_http-api.md._RWELr3d.lean.js → reference_http-api.md.C7Cb0r2J.lean.js} +1 -1
- package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.js +14 -0
- package/dist/docs/assets/reference_instructions.md.CV6Qq0UX.lean.js +1 -0
- package/dist/docs/assets/reference_limits.md.CbdtFr4T.js +8 -0
- package/dist/docs/assets/reference_limits.md.CbdtFr4T.lean.js +1 -0
- package/dist/docs/assets/reference_memory.md.CdoJISM-.js +3 -0
- package/dist/docs/assets/{reference_memory.md.Dd7cyV9V.lean.js → reference_memory.md.CdoJISM-.lean.js} +1 -1
- package/dist/docs/assets/reference_playground.md.DIUsRAcy.js +1 -0
- package/dist/docs/assets/{reference_playground.md.CQiJk9CM.lean.js → reference_playground.md.DIUsRAcy.lean.js} +1 -1
- package/dist/docs/assets/reference_project-layout.md.9DiKoE16.js +26 -0
- package/dist/docs/assets/reference_project-layout.md.9DiKoE16.lean.js +1 -0
- package/dist/docs/assets/reference_schedules.md.Dd8_d0WG.js +45 -0
- package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +1 -1
- package/dist/docs/assets/reference_sessions.md.NXVQt9mP.js +22 -0
- package/dist/docs/assets/{reference_sessions.md.C7KFhWXV.lean.js → reference_sessions.md.NXVQt9mP.lean.js} +1 -1
- package/dist/docs/assets/{reference_skills.md.Dej2zQxi.js → reference_skills.md.DzCPNPkG.js} +4 -4
- package/dist/docs/assets/{reference_skills.md.Dej2zQxi.lean.js → reference_skills.md.DzCPNPkG.lean.js} +1 -1
- package/dist/docs/assets/reference_subagents.md.Dvpq2sUu.js +10 -0
- package/dist/docs/assets/{reference_subagents.md.CAhvW4yS.lean.js → reference_subagents.md.Dvpq2sUu.lean.js} +1 -1
- package/dist/docs/assets/reference_tools.md.B2OaR1Nb.js +62 -0
- package/dist/docs/assets/{reference_tools.md.DQr7Fnhu.lean.js → reference_tools.md.B2OaR1Nb.lean.js} +1 -1
- package/dist/docs/assets/templates_agentic-owners.md.B6ZmKAzT.js +13 -0
- package/dist/docs/assets/{templates_agentic-owners.md.Dh2nDSqg.lean.js → templates_agentic-owners.md.B6ZmKAzT.lean.js} +1 -1
- package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.js +10 -0
- package/dist/docs/assets/templates_reviews.md.dr9Xv_KM.lean.js +1 -0
- package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +3 -0
- package/dist/docs/assets/{troubleshooting.md.CGOdNVAL.lean.js → troubleshooting.md.DfKKvW1R.lean.js} +1 -1
- package/dist/docs/building-with-agents.html +41 -44
- package/dist/docs/building-with-agents.md +11 -104
- package/dist/docs/changelog.html +37 -37
- package/dist/docs/changelog.md +14 -145
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +97 -270
- package/dist/docs/evals.html +52 -71
- package/dist/docs/evals.md +33 -129
- package/dist/docs/guides/agent-to-agent.html +43 -43
- package/dist/docs/guides/agent-to-agent.md +29 -64
- package/dist/docs/guides/bitbucket.html +62 -62
- package/dist/docs/guides/bitbucket.md +73 -134
- package/dist/docs/guides/cloud-agents.html +37 -37
- package/dist/docs/guides/cloud-agents.md +23 -53
- package/dist/docs/guides/convert-automation.html +39 -56
- package/dist/docs/guides/convert-automation.md +31 -115
- package/dist/docs/guides/github.html +46 -54
- package/dist/docs/guides/github.md +49 -131
- package/dist/docs/guides/gitlab.html +98 -108
- package/dist/docs/guides/gitlab.md +104 -184
- package/dist/docs/guides/improve.html +38 -43
- package/dist/docs/guides/improve.md +24 -90
- package/dist/docs/guides/jev.html +55 -95
- package/dist/docs/guides/jev.md +53 -160
- package/dist/docs/guides/mcp-oauth.html +38 -40
- package/dist/docs/guides/mcp-oauth.md +33 -67
- package/dist/docs/guides/migrate.html +38 -43
- package/dist/docs/guides/migrate.md +56 -130
- package/dist/docs/guides/opentelemetry.html +41 -43
- package/dist/docs/guides/opentelemetry.md +32 -27
- package/dist/docs/guides/pagerduty.html +50 -49
- package/dist/docs/guides/pagerduty.md +65 -199
- package/dist/docs/guides/slack.html +51 -57
- package/dist/docs/guides/slack.md +76 -204
- package/dist/docs/guides/webhooks.html +42 -42
- package/dist/docs/guides/webhooks.md +64 -146
- package/dist/docs/hashmap.json +1 -1
- package/dist/docs/hillclimbing.html +40 -42
- package/dist/docs/hillclimbing.md +40 -102
- package/dist/docs/index.html +49 -61
- package/dist/docs/index.md +42 -82
- package/dist/docs/llms-full.txt +2272 -5711
- package/dist/docs/llms.txt +9 -14
- package/dist/docs/quickstart.html +95 -152
- package/dist/docs/quickstart.md +91 -180
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/access.md +7 -12
- package/dist/docs/reference/agent-config.html +45 -58
- package/dist/docs/reference/agent-config.md +92 -176
- package/dist/docs/reference/artifacts.html +38 -39
- package/dist/docs/reference/artifacts.md +38 -62
- package/dist/docs/reference/channels.html +38 -39
- package/dist/docs/reference/channels.md +102 -151
- package/dist/docs/reference/cli.html +68 -84
- package/dist/docs/reference/cli.md +232 -697
- package/dist/docs/reference/connections.html +45 -57
- package/dist/docs/reference/connections.md +83 -164
- package/dist/docs/reference/evals.html +47 -54
- package/dist/docs/reference/evals.md +75 -141
- package/dist/docs/reference/extensions.html +41 -43
- package/dist/docs/reference/extensions.md +37 -70
- package/dist/docs/reference/hooks.html +40 -52
- package/dist/docs/reference/hooks.md +62 -133
- package/dist/docs/reference/http-api.html +38 -42
- package/dist/docs/reference/http-api.md +66 -118
- package/dist/docs/reference/instructions.html +39 -39
- package/dist/docs/reference/instructions.md +19 -29
- package/dist/docs/reference/limits.html +38 -38
- package/dist/docs/reference/limits.md +9 -21
- package/dist/docs/reference/memory.html +37 -38
- package/dist/docs/reference/memory.md +38 -75
- package/dist/docs/reference/playground.html +36 -36
- package/dist/docs/reference/playground.md +14 -22
- package/dist/docs/reference/project-layout.html +49 -48
- package/dist/docs/reference/project-layout.md +38 -84
- package/dist/docs/reference/schedules.html +44 -46
- package/dist/docs/reference/schedules.md +59 -90
- package/dist/docs/reference/sessions.html +37 -37
- package/dist/docs/reference/sessions.md +66 -113
- package/dist/docs/reference/skills.html +39 -39
- package/dist/docs/reference/skills.md +11 -31
- package/dist/docs/reference/subagents.html +37 -37
- package/dist/docs/reference/subagents.md +17 -31
- package/dist/docs/reference/tools.html +47 -64
- package/dist/docs/reference/tools.md +48 -130
- package/dist/docs/templates/agentic-owners.html +38 -38
- package/dist/docs/templates/agentic-owners.md +50 -74
- package/dist/docs/templates/reviews.html +69 -0
- package/dist/docs/templates/reviews.md +71 -0
- package/dist/docs/troubleshooting.html +38 -36
- package/dist/docs/troubleshooting.md +48 -101
- package/dist/filesystem.d.ts +7 -320
- package/dist/filesystem.d.ts.map +1 -1
- package/dist/filesystem.js +10 -691
- package/dist/index.d.ts +1 -1
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/internal/authored-alias-hooks.d.ts +6 -0
- package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
- package/dist/internal/authored-alias-hooks.js +12 -0
- package/dist/internal/authored-loaders.js +10 -1
- package/dist/internal/cli/commands/scaffold.js +1 -1
- package/dist/internal/cli-deploy.js +1 -1
- package/dist/internal/cli-docs.js +1 -1
- package/dist/internal/cli-images.js +1 -1
- package/dist/internal/cli-skills.js +1 -1
- package/dist/internal/continuation-session-ids.d.ts +15 -0
- package/dist/internal/continuation-session-ids.d.ts.map +1 -0
- package/dist/internal/continuation-session-ids.js +43 -0
- package/dist/internal/cursor/credentials.js +1 -1
- package/dist/internal/deploy-manifest.d.ts +1 -0
- package/dist/internal/deploy-manifest.d.ts.map +1 -1
- package/dist/internal/deploy-manifest.js +0 -1
- package/dist/internal/discovery/agent-config.d.ts +2 -6
- package/dist/internal/discovery/agent-config.d.ts.map +1 -1
- package/dist/internal/discovery/agent-config.js +8 -25
- package/dist/internal/discovery/agent.d.ts.map +1 -1
- package/dist/internal/discovery/agent.js +2 -3
- package/dist/internal/discovery/project.d.ts.map +1 -1
- package/dist/internal/discovery/project.js +15 -0
- package/dist/internal/filesystem/walk.d.ts +1 -5
- package/dist/internal/filesystem/walk.d.ts.map +1 -1
- package/dist/internal/filesystem/walk.js +1 -9
- package/dist/internal/hosted-catch-protocol.d.ts +3 -3
- package/dist/internal/hosted-catch-protocol.js +3 -3
- package/dist/internal/hosted-fetch.d.ts +7 -0
- package/dist/internal/hosted-fetch.d.ts.map +1 -0
- package/dist/internal/hosted-fetch.js +26 -0
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +7 -5
- package/dist/internal/install-cursor-skills.d.ts +5 -6
- package/dist/internal/install-cursor-skills.d.ts.map +1 -1
- package/dist/internal/install-cursor-skills.js +19 -4
- package/dist/internal/mcp-endpoint.js +4 -4
- package/dist/internal/model-config.d.ts.map +1 -1
- package/dist/internal/model-config.js +11 -4
- package/dist/internal/platform-timers.d.ts +3 -7
- package/dist/internal/platform-timers.d.ts.map +1 -1
- package/dist/internal/platform-timers.js +10 -51
- package/dist/internal/reminder-runner.js +1 -1
- package/dist/internal/server.d.ts.map +1 -1
- package/dist/internal/server.js +6 -1
- package/dist/internal/session-engine.d.ts +3 -0
- package/dist/internal/session-engine.d.ts.map +1 -1
- package/dist/internal/session-engine.js +13 -4
- package/dist/internal/shallow-clone.js +1 -1
- package/dist/playground/assets/index-Bno25Cg0.css +1 -0
- package/dist/playground/assets/index-SGKsaznh.js +62 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +6 -17
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +2 -2
- package/docs/README.md +42 -82
- package/docs/building-with-agents.md +11 -104
- package/docs/changelog.md +15 -146
- package/docs/deployment.md +97 -270
- package/docs/evals.md +34 -130
- package/docs/guides/agent-to-agent.md +29 -64
- package/docs/guides/bitbucket.md +73 -134
- package/docs/guides/cloud-agents.md +23 -53
- package/docs/guides/convert-automation.md +31 -115
- package/docs/guides/github.md +49 -131
- package/docs/guides/gitlab.md +104 -184
- package/docs/guides/improve.md +24 -90
- package/docs/guides/jev.md +53 -160
- package/docs/guides/mcp-oauth.md +33 -67
- package/docs/guides/migrate.md +56 -130
- package/docs/guides/opentelemetry.md +37 -27
- package/docs/guides/pagerduty.md +68 -200
- package/docs/guides/slack.md +76 -204
- package/docs/guides/webhooks.md +64 -146
- package/docs/hillclimbing.md +41 -103
- package/docs/quickstart.md +91 -180
- package/docs/reference/access.md +7 -12
- package/docs/reference/agent-config.md +92 -176
- package/docs/reference/artifacts.md +38 -62
- package/docs/reference/channels.md +102 -151
- package/docs/reference/cli.md +232 -697
- package/docs/reference/connections.md +83 -164
- package/docs/reference/evals.md +75 -141
- package/docs/reference/extensions.md +37 -70
- package/docs/reference/hooks.md +61 -132
- package/docs/reference/http-api.md +66 -118
- package/docs/reference/instructions.md +20 -30
- package/docs/reference/limits.md +10 -22
- package/docs/reference/memory.md +38 -75
- package/docs/reference/playground.md +14 -22
- package/docs/reference/project-layout.md +38 -84
- package/docs/reference/schedules.md +59 -90
- package/docs/reference/sessions.md +66 -113
- package/docs/reference/skills.md +12 -32
- package/docs/reference/subagents.md +17 -31
- package/docs/reference/tools.md +48 -130
- package/docs/templates/agentic-owners.md +50 -74
- package/docs/templates/reviews.md +76 -0
- package/docs/troubleshooting.md +48 -101
- package/package.json +4 -4
- package/skills/cli/SKILL.md +1 -1
- package/skills/create-agent/SKILL.md +61 -7
- package/skills/debug/SKILL.md +1 -1
- package/skills/deploy/SKILL.md +3 -3
- package/skills/evals/SKILL.md +1 -1
- package/skills/framework-map/SKILL.md +2 -2
- package/skills/github/SKILL.md +1 -1
- package/skills/hillclimb/SKILL.md +1 -1
- package/skills/mcp-auth/SKILL.md +1 -1
- package/skills/migrate-v2/SKILL.md +2 -3
- package/skills/otel/SKILL.md +1 -1
- package/skills/setup-slack/SKILL.md +2 -2
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
- package/dist/docs/assets/changelog.md.DrLFQUlu.js +0 -1
- package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +0 -1
- package/dist/docs/assets/chunks/channel._fZX_hvU.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +0 -1
- package/dist/docs/assets/chunks/clone.W1Phdw9P.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +0 -1
- package/dist/docs/assets/deployment.md.KW0Ni_rY.js +0 -31
- package/dist/docs/assets/evals.md.DiljU__Z.js +0 -68
- package/dist/docs/assets/evals.md.DiljU__Z.lean.js +0 -1
- package/dist/docs/assets/guides_agent-to-agent.md.D1D5f6Jc.lean.js +0 -1
- package/dist/docs/assets/guides_cloud-agents.md.Ceyjv0ul.js +0 -9
- package/dist/docs/assets/guides_convert-automation.md.BjraCvok.js +0 -43
- package/dist/docs/assets/guides_hooks.md.BjeEiM7s.js +0 -54
- package/dist/docs/assets/guides_hooks.md.BjeEiM7s.lean.js +0 -1
- package/dist/docs/assets/guides_improve.md.BFYtrtLE.js +0 -21
- package/dist/docs/assets/guides_migrate.md.RS9Eu-Xh.js +0 -8
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.js +0 -28
- package/dist/docs/assets/guides_opentelemetry.md.CoZ1kNyd.lean.js +0 -1
- package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.js +0 -60
- package/dist/docs/assets/guides_pagerduty.md.mnKXe9U0.lean.js +0 -1
- package/dist/docs/assets/guides_slack.md.BwXHURvY.js +0 -88
- package/dist/docs/assets/hillclimbing.md.By61f3uq.js +0 -7
- package/dist/docs/assets/hillclimbing.md.By61f3uq.lean.js +0 -1
- package/dist/docs/assets/index.md.CAruw_rp.js +0 -26
- package/dist/docs/assets/index.md.CAruw_rp.lean.js +0 -1
- package/dist/docs/assets/quickstart.md.CljDaJBi.js +0 -170
- package/dist/docs/assets/reference_access.md.CEtibb4i.js +0 -1
- package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +0 -1
- package/dist/docs/assets/reference_agent-config.md.Ck29qYNj.js +0 -40
- package/dist/docs/assets/reference_artifacts.md.C-hKR2hp.js +0 -18
- package/dist/docs/assets/reference_channels.md.DsJfGSBJ.js +0 -22
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.js +0 -99
- package/dist/docs/assets/reference_cli.md.BkdLRbXg.lean.js +0 -1
- package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
- package/dist/docs/assets/reference_evals.md.2BXeMiO2.js +0 -76
- package/dist/docs/assets/reference_hooks.md.B-bwJuiG.js +0 -51
- package/dist/docs/assets/reference_hooks.md.B-bwJuiG.lean.js +0 -1
- package/dist/docs/assets/reference_http-api.md._RWELr3d.js +0 -11
- package/dist/docs/assets/reference_instructions.md.yL2hXLnl.js +0 -14
- package/dist/docs/assets/reference_instructions.md.yL2hXLnl.lean.js +0 -1
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.js +0 -8
- package/dist/docs/assets/reference_limits.md.BCCnvt3o.lean.js +0 -1
- package/dist/docs/assets/reference_memory.md.Dd7cyV9V.js +0 -4
- package/dist/docs/assets/reference_playground.md.CQiJk9CM.js +0 -1
- package/dist/docs/assets/reference_project-layout.md.BamcPDUn.js +0 -25
- package/dist/docs/assets/reference_project-layout.md.BamcPDUn.lean.js +0 -1
- package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.js +0 -9
- package/dist/docs/assets/reference_prompt.md.BMjm1Jp3.lean.js +0 -1
- package/dist/docs/assets/reference_schedules.md.RC47aFm4.js +0 -47
- package/dist/docs/assets/reference_sessions.md.C7KFhWXV.js +0 -22
- package/dist/docs/assets/reference_subagents.md.CAhvW4yS.js +0 -10
- package/dist/docs/assets/reference_tools.md.DQr7Fnhu.js +0 -79
- package/dist/docs/assets/templates_agentic-owners.md.Dh2nDSqg.js +0 -13
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.js +0 -3
- package/dist/docs/assets/templates_security-reviewer.md.DnwXdnB5.lean.js +0 -1
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.js +0 -3
- package/dist/docs/assets/templates_thermo-quality-review.md.MJIdHkzE.lean.js +0 -1
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.js +0 -3
- package/dist/docs/assets/templates_thermo-review.md.DfN1OFOl.lean.js +0 -1
- package/dist/docs/assets/templates_triage.md.BYWMloV4.js +0 -9
- package/dist/docs/assets/templates_triage.md.BYWMloV4.lean.js +0 -1
- package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +0 -1
- package/dist/docs/guides/hooks.html +0 -113
- package/dist/docs/guides/hooks.md +0 -116
- package/dist/docs/package/skills/create-agent/SKILL.md +0 -178
- package/dist/docs/package/skills/evals/SKILL.md +0 -145
- package/dist/docs/package/skills/github/SKILL.md +0 -133
- package/dist/docs/package/skills/hillclimb/SKILL.md +0 -63
- package/dist/docs/package/skills/mcp-auth/SKILL.md +0 -60
- package/dist/docs/package/skills/migrate-v2/SKILL.md +0 -394
- package/dist/docs/package/skills/setup-slack/SKILL.md +0 -136
- package/dist/docs/reference/prompt.html +0 -68
- package/dist/docs/reference/prompt.md +0 -47
- package/dist/docs/templates/security-reviewer.html +0 -62
- package/dist/docs/templates/security-reviewer.md +0 -81
- package/dist/docs/templates/thermo-quality-review.html +0 -62
- package/dist/docs/templates/thermo-quality-review.md +0 -75
- package/dist/docs/templates/thermo-review.html +0 -62
- package/dist/docs/templates/thermo-review.md +0 -75
- package/dist/docs/templates/triage.html +0 -68
- package/dist/docs/templates/triage.md +0 -101
- package/dist/internal/filesystem/errors.d.ts +0 -64
- package/dist/internal/filesystem/errors.d.ts.map +0 -1
- package/dist/internal/filesystem/errors.js +0 -180
- package/dist/internal/filesystem/merge.d.ts +0 -34
- package/dist/internal/filesystem/merge.d.ts.map +0 -1
- package/dist/internal/filesystem/merge.js +0 -154
- package/dist/playground/assets/index-Cl9zvmmf.js +0 -62
- package/dist/playground/assets/index-F8b5WvWi.css +0 -1
- package/docs/guides/hooks.md +0 -121
- package/docs/reference/prompt.md +0 -52
- package/docs/templates/security-reviewer.md +0 -86
- package/docs/templates/thermo-quality-review.md +0 -80
- package/docs/templates/thermo-review.md +0 -80
- package/docs/templates/triage.md +0 -106
|
@@ -1,34 +1,34 @@
|
|
|
1
|
-
# Slack
|
|
1
|
+
# Slack Agents
|
|
2
2
|
|
|
3
|
-
|
|
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
|
-
|
|
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
|
-
|
|
14
|
-
|
|
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
|
|
29
|
-
|
|
30
|
-
|
|
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
|
-
|
|
52
|
-
|
|
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
|
|
70
|
-
|
|
71
|
-
|
|
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
|
-
|
|
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
|
-
|
|
101
|
-
|
|
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`
|
|
108
|
-
|
|
|
109
|
-
| `{ display: "timeline" }` (default) |
|
|
110
|
-
| `{ display: "plan" }`
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
|
145
|
-
|
|
146
|
-
|
|
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
|
-
|
|
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
|
|
182
|
-
|
|
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
|
-
|
|
189
|
-
|
|
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
|
-
|
|
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
|
|
211
|
-
|
|
212
|
-
|
|
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
|
-
|
|
254
|
-
|
|
255
|
-
|
|
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
|
-
|
|
285
|
-
|
|
286
|
-
|
|
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
|
|
289
|
-
|
|
290
|
-
|
|
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
|
-
`
|
|
298
|
-
`
|
|
299
|
-
`
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
369
|
-
|
|
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
|
-
|
|
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
|
-
-
|
|
374
|
-
|
|
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.
|