@grok/agent-sdk 0.2.28 → 0.3.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/AGENTS.md +29 -29
- package/dist/bin/agent-serve.d.ts +2 -2
- package/dist/bin/agent-serve.js +3 -3
- package/dist/channels/pagerduty/api.js +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
- package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
- package/dist/channels/pagerduty/replay.d.ts +1 -1
- package/dist/channels/pagerduty/replay.js +4 -4
- package/dist/channels/slack/cli-project.js +1 -1
- package/dist/docs/404.html +2 -2
- package/dist/docs/assets/{app.DF9vlcdn.js → app.BzTUBOAD.js} +4 -4
- package/dist/docs/assets/building-with-agents.md.BqJ7AAjG.js +6 -0
- package/dist/docs/assets/{building-with-agents.md.Bf1yH2tG.lean.js → building-with-agents.md.BqJ7AAjG.lean.js} +1 -1
- package/dist/docs/assets/changelog.md.BWhC6DET.js +1 -0
- package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +1 -0
- package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +1 -0
- package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DsnRlUT5.js} +1 -1
- package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.DH8GOhiv.js} +1 -1
- package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.9m9ObyuE.js} +1 -1
- package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.BXHpx1lE.js} +1 -1
- package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.xY3EX59q.js} +1 -1
- package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.DnqgMVgc.js} +1 -1
- package/dist/docs/assets/chunks/channel.Cctv0f7X.js +1 -0
- package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.BjFxK2A3.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.BujS_Spt.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.YbTjhdaM.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.DnQ8t4GC.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.B67AwAmj.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.DrZIAFOm.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.BLmmydkn.js} +1 -1
- package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM.DaoOfw0O.js} +1 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +1 -0
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +1 -0
- package/dist/docs/assets/chunks/clone.B9rdNt6j.js +1 -0
- package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.DMQuNhM5.js} +1 -1
- package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CZoGVuUf.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.CLt9uOyL.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.DpczEm1G.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.D4r13DvJ.js} +1 -1
- package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.CYU9eGFu.js} +1 -1
- package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.QA9naWEw.js} +1 -1
- package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.BbNoVZYd.js} +1 -1
- package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.IHjDoG7r.js} +1 -1
- package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.B21VMdf5.js} +1 -1
- package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.DgJ4L-8V.js} +1 -1
- package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.CQjrcthc.js} +1 -1
- package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.D4tPGtVo.js} +1 -1
- package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.BD3WaNbQ.js} +1 -1
- package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.Ca0o4Tqz.js} +1 -1
- package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.DXXqX4MQ.js} +1 -1
- package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.5c61gNw4.js} +1 -1
- package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.B1-NAjHX.js} +1 -1
- package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.BELznv3-.js} +1 -1
- package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.qPzO1mq5.js} +1 -1
- package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.CxIvzbjX.js} +1 -1
- package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.CqA0iJx8.js} +1 -1
- package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.XRTutBnb.js} +1 -1
- package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.E--7bRLQ.js} +1 -1
- package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.C4vGu8zq.js} +1 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +1 -0
- package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DMj_7q3B.js} +2 -2
- package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C7LgNVAL.js} +1 -1
- package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.HUwoZcy_.js} +1 -1
- package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.BxFEFYZS.js} +1 -1
- package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.B2pSo5rB.js} +1 -1
- package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.NQhMiOOL.js} +1 -1
- package/dist/docs/assets/deployment.md.BtqJrHhp.js +31 -0
- package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.BtqJrHhp.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.BcmSqL2z.js} +8 -8
- package/dist/docs/assets/guides_agent-to-agent.md.BcmSqL2z.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.6jiEH7dg.js} +11 -19
- package/dist/docs/assets/{guides_github.md.CgN5sNbW.lean.js → guides_github.md.6jiEH7dg.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.Ccw4pedT.js → guides_jev.md.DGCzkMUN.js} +20 -60
- package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.DGCzkMUN.lean.js} +1 -1
- package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.C-Sx_IPa.js} +3 -5
- package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.C-Sx_IPa.lean.js} +1 -1
- package/dist/docs/assets/guides_migrate.md.BbhHYeCr.js +3 -0
- package/dist/docs/assets/{guides_migrate.md.RS9Eu-Xh.lean.js → guides_migrate.md.BbhHYeCr.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.BgIGG9ur.js +82 -0
- package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BgIGG9ur.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.3TkdF79A.js +5 -0
- package/dist/docs/assets/hillclimbing.md.3TkdF79A.lean.js +1 -0
- package/dist/docs/assets/index.md.DRfaoRCZ.js +20 -0
- package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +1 -0
- package/dist/docs/assets/quickstart.md.r-oE8nkX.js +113 -0
- package/dist/docs/assets/{quickstart.md.DaLk4ZIF.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.CExlH_mR.lean.js → reference_access.md.C5lblfUC.lean.js} +1 -1
- package/dist/docs/assets/reference_agent-config.md.C0Tp_Fk9.js +27 -0
- package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.C0Tp_Fk9.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.B8GdpaRj.js +83 -0
- package/dist/docs/assets/reference_cli.md.B8GdpaRj.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.DYKjGFi-.lean.js → reference_evals.md.DgfUtfIc.lean.js} +1 -1
- package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DHbW6eOf.js} +6 -8
- package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DHbW6eOf.lean.js} +1 -1
- package/dist/docs/assets/reference_hooks.md.CSWmOwMM.js +39 -0
- package/dist/docs/assets/reference_hooks.md.CSWmOwMM.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.RhQ9ZLo1.js +45 -0
- package/dist/docs/assets/{reference_schedules.md.RC47aFm4.lean.js → reference_schedules.md.RhQ9ZLo1.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.AGJ3jDzj.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 +5 -145
- package/dist/docs/deployment.html +54 -54
- package/dist/docs/deployment.md +86 -265
- package/dist/docs/evals.html +52 -71
- package/dist/docs/evals.md +33 -127
- package/dist/docs/guides/agent-to-agent.html +43 -43
- package/dist/docs/guides/agent-to-agent.md +27 -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 +57 -159
- package/dist/docs/guides/mcp-oauth.html +38 -40
- package/dist/docs/guides/mcp-oauth.md +34 -69
- 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 -205
- 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 +55 -62
- package/dist/docs/index.md +49 -82
- package/dist/docs/llms-full.txt +2292 -5830
- package/dist/docs/llms.txt +9 -15
- package/dist/docs/quickstart.html +96 -153
- package/dist/docs/quickstart.md +93 -178
- package/dist/docs/reference/access.html +36 -36
- package/dist/docs/reference/access.md +7 -12
- package/dist/docs/reference/agent-config.html +43 -56
- package/dist/docs/reference/agent-config.md +93 -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 +233 -698
- package/dist/docs/reference/connections.html +45 -57
- package/dist/docs/reference/connections.md +83 -164
- package/dist/docs/reference/evals.html +66 -53
- package/dist/docs/reference/evals.md +97 -128
- 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 +46 -48
- 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/evals.d.ts +2 -2
- package/dist/extensions/jev/extension.d.ts +12 -2
- package/dist/extensions/jev/extension.d.ts.map +1 -1
- package/dist/extensions/jev/extension.js +4 -0
- package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
- package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
- package/dist/extensions/jev/lib/evaluate.js +18 -4
- package/dist/internal/cli/command.d.ts +1 -1
- package/dist/internal/cli/command.js +1 -1
- package/dist/internal/cli/commands/channels.js +6 -6
- package/dist/internal/cli/commands/develop.d.ts.map +1 -1
- package/dist/internal/cli/commands/develop.js +23 -14
- package/dist/internal/cli/commands/hosted.js +4 -4
- package/dist/internal/cli/commands/index.d.ts +1 -1
- package/dist/internal/cli/commands/index.d.ts.map +1 -1
- package/dist/internal/cli/commands/index.js +1 -1
- package/dist/internal/cli/commands/mcp.js +1 -1
- package/dist/internal/cli/commands/project.js +4 -4
- package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
- package/dist/internal/cli/commands/scaffold.js +9 -6
- package/dist/internal/cli/commands/serve.d.ts +1 -1
- package/dist/internal/cli/commands/serve.js +5 -5
- package/dist/internal/cli/commands/session.d.ts.map +1 -1
- package/dist/internal/cli/commands/session.js +12 -7
- package/dist/internal/cli/dispatch.d.ts +3 -3
- package/dist/internal/cli/dispatch.js +3 -3
- package/dist/internal/cli/errors.d.ts +1 -1
- package/dist/internal/cli/errors.d.ts.map +1 -1
- package/dist/internal/cli/errors.js +1 -1
- package/dist/internal/cli/flags.d.ts +2 -2
- package/dist/internal/cli/flags.d.ts.map +1 -1
- package/dist/internal/cli/flags.js +2 -2
- package/dist/internal/cli/help-command.d.ts +1 -1
- package/dist/internal/cli/help-command.js +2 -2
- package/dist/internal/cli/help.d.ts +7 -7
- package/dist/internal/cli/help.d.ts.map +1 -1
- package/dist/internal/cli/help.js +8 -8
- package/dist/internal/cli-ax.d.ts.map +1 -1
- package/dist/internal/cli-ax.js +3 -0
- package/dist/internal/cli-convert-automation.d.ts +1 -1
- package/dist/internal/cli-convert-automation.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-migrate.d.ts +1 -1
- package/dist/internal/cli-migrate.js +1 -1
- package/dist/internal/cli-pagerduty.d.ts +1 -1
- package/dist/internal/cli-pagerduty.js +1 -1
- package/dist/internal/cli-skills.js +1 -1
- package/dist/internal/convert-automation/types.d.ts +1 -1
- package/dist/internal/convert-automation/types.js +1 -1
- package/dist/internal/cursor/credentials.js +1 -1
- package/dist/internal/deploy-client.d.ts +2 -2
- package/dist/internal/deploy-client.d.ts.map +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/init-project.d.ts +7 -3
- package/dist/internal/init-project.d.ts.map +1 -1
- package/dist/internal/init-project.js +60 -12
- package/dist/internal/init-scaffold.d.ts +2 -1
- package/dist/internal/init-scaffold.d.ts.map +1 -1
- package/dist/internal/init-scaffold.js +20 -7
- package/dist/internal/peer-connections.js +1 -1
- package/dist/internal/reminder-runner.js +1 -1
- package/dist/internal/server.d.ts +1 -1
- package/dist/internal/session-cost.d.ts +4 -4
- package/dist/internal/session-cost.d.ts.map +1 -1
- package/dist/internal/session-cost.js +4 -4
- package/dist/internal/session-engine.d.ts +1 -1
- package/dist/internal/session-engine.js +2 -2
- package/dist/internal/shallow-clone.js +1 -1
- package/dist/playground/assets/index-D6mVn9og.js +62 -0
- package/dist/playground/assets/index-DlALM6gr.css +1 -0
- package/dist/playground/index.html +2 -2
- package/dist/types.d.ts +9 -22
- package/dist/types.d.ts.map +1 -1
- package/docs/README.md +49 -82
- package/docs/building-with-agents.md +11 -104
- package/docs/changelog.md +6 -146
- package/docs/deployment.md +86 -265
- package/docs/evals.md +34 -128
- package/docs/guides/agent-to-agent.md +27 -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 +57 -159
- package/docs/guides/mcp-oauth.md +34 -69
- 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 -205
- package/docs/guides/webhooks.md +64 -146
- package/docs/hillclimbing.md +41 -103
- package/docs/quickstart.md +93 -178
- package/docs/reference/access.md +7 -12
- package/docs/reference/agent-config.md +93 -176
- package/docs/reference/artifacts.md +38 -62
- package/docs/reference/channels.md +102 -151
- package/docs/reference/cli.md +233 -698
- package/docs/reference/connections.md +83 -164
- package/docs/reference/evals.md +97 -128
- 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 +3 -9
- package/skills/cli/SKILL.md +15 -15
- package/skills/create-agent/SKILL.md +20 -19
- package/skills/debug/SKILL.md +4 -4
- package/skills/deploy/SKILL.md +2 -2
- package/skills/evals/SKILL.md +8 -8
- package/skills/framework-map/SKILL.md +3 -3
- package/skills/github/SKILL.md +7 -7
- package/skills/hillclimb/SKILL.md +4 -4
- package/skills/mcp-auth/SKILL.md +3 -3
- package/skills/migrate-v2/SKILL.md +40 -41
- package/skills/otel/SKILL.md +2 -2
- package/skills/setup-slack/SKILL.md +8 -8
- package/templates/agentic-owners/README.md +5 -5
- package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
- package/templates/agentic-owners/package.json +1 -1
- package/templates/agents-md/README.md +4 -4
- package/templates/agents-md/package.json +1 -1
- package/templates/code-wiki/README.md +3 -3
- package/templates/code-wiki/package.json +1 -1
- package/templates/demo/README.md +3 -3
- package/templates/demo/package.json +1 -1
- package/templates/pr-autofixer/package.json +1 -1
- package/templates/security-help/README.md +5 -5
- package/templates/security-help/package.json +1 -1
- package/templates/security-reviewer/README.md +3 -3
- package/templates/security-reviewer/package.json +1 -1
- package/templates/thermo-quality-review/README.md +4 -4
- package/templates/thermo-quality-review/package.json +1 -1
- package/templates/thermo-review/README.md +4 -4
- package/templates/thermo-review/package.json +1 -1
- package/templates/triage/README.md +3 -3
- package/templates/triage/overlays/jira/README.md +3 -3
- package/templates/triage/overlays/linear/README.md +3 -3
- package/templates/triage/package.json +1 -1
- package/dist/docs/assets/building-with-agents.md.Bf1yH2tG.js +0 -9
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
- package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
- package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
- package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
- package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
- package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
- package/dist/docs/assets/deployment.md.DDmjAVbg.js +0 -31
- package/dist/docs/assets/evals.md.OjKb7tNA.js +0 -68
- package/dist/docs/assets/evals.md.OjKb7tNA.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_grokbot-agents.md.D0PpM_Gf.js +0 -15
- package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
- 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.BqiGSYGX.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.CVRjO09Y.js +0 -27
- package/dist/docs/assets/index.md.CVRjO09Y.lean.js +0 -1
- package/dist/docs/assets/quickstart.md.DaLk4ZIF.js +0 -170
- package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
- package/dist/docs/assets/reference_agent-config.md.11E_xe--.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.DQ3dCgmk.js +0 -99
- package/dist/docs/assets/reference_cli.md.DQ3dCgmk.lean.js +0 -1
- package/dist/docs/assets/reference_connections.md.BoAotr7_.js +0 -66
- package/dist/docs/assets/reference_evals.md.DYKjGFi-.js +0 -56
- 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.Da1HegjB.js +0 -8
- package/dist/docs/assets/reference_limits.md.Da1HegjB.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.AGJ3jDzj.js +0 -1
- package/dist/docs/guides/grokbot-agents.html +0 -74
- package/dist/docs/guides/grokbot-agents.md +0 -129
- package/dist/docs/guides/hooks.html +0 -113
- package/dist/docs/guides/hooks.md +0 -116
- 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/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
- package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
- package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
- package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
- package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
- package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
- package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
- package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
- package/dist/playground/assets/index-BMpVzZzC.css +0 -1
- package/dist/playground/assets/index-_3zz3yh8.js +0 -62
- package/docs/guides/grokbot-agents.md +0 -134
- 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
package/docs/guides/slack.md
CHANGED
|
@@ -3,37 +3,37 @@ title: "Slack"
|
|
|
3
3
|
description: "Wake your agent from mentions, DMs, and watched posts, then reply in the thread."
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# Slack
|
|
6
|
+
# Slack Agents
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
in a channel it watches. From there, it keeps the conversation in one
|
|
10
|
-
thread and can reply all at once, stream the answer live, or decide for
|
|
11
|
-
itself when to post updates.
|
|
8
|
+
Agent SDK makes it easy to build agents that work in Slack.
|
|
12
9
|
|
|
13
|
-
|
|
10
|
+
A Slack agent wakes when someone mentions it, sends it a DM, or posts in a channel it watches. From
|
|
11
|
+
there, it keeps the conversation in one thread and can reply all at once, stream the answer live, or
|
|
12
|
+
decide for itself when to post updates. [Connect](#connect) sets up the Slack app.
|
|
14
13
|
|
|
15
14
|
## Answer a mention or DM
|
|
16
15
|
|
|
17
|
-
Mention the bot in a channel or send it a DM, and it will answer in a
|
|
18
|
-
|
|
19
|
-
|
|
16
|
+
Mention the bot in a channel or send it a DM, and it will answer in a thread on that message. Any
|
|
17
|
+
follow-up in the same thread continues the conversation where it left off. All messages in one DM
|
|
18
|
+
share a session by default. Set `continuation: "slack.dmthread/v2"` to give each top-level DM its
|
|
19
|
+
own session and thread.
|
|
20
20
|
|
|
21
21
|
```ts
|
|
22
22
|
// bot/channels/slack.ts
|
|
23
23
|
import { slackChannel } from "@grok/agent-sdk/channels/slack";
|
|
24
24
|
|
|
25
25
|
export default slackChannel({
|
|
26
|
-
// TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN
|
|
26
|
+
// Reads TRIAGE_SLACK_BOT_TOKEN and TRIAGE_SLACK_APP_TOKEN, so two bots
|
|
27
|
+
// on one host don't collide.
|
|
27
28
|
envPrefix: "TRIAGE",
|
|
28
29
|
});
|
|
29
30
|
```
|
|
30
31
|
|
|
31
32
|
## Post one reply with a status chip
|
|
32
33
|
|
|
33
|
-
By default, Slack shows a status chip
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
chip disappears and one complete reply lands in the thread.
|
|
34
|
+
By default, Slack shows a status chip under the thread while the turn runs, with idle messages until
|
|
35
|
+
reasoning or tool activity gives it more to show. When the turn finishes, the chip disappears and
|
|
36
|
+
one complete reply lands in the thread.
|
|
37
37
|
|
|
38
38
|
```ts
|
|
39
39
|
export default slackChannel({
|
|
@@ -52,10 +52,9 @@ export default slackChannel({
|
|
|
52
52
|
|
|
53
53
|
## Stream a live reply
|
|
54
54
|
|
|
55
|
-
In stream mode, the reply appears immediately and grows as the model
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
same message.
|
|
55
|
+
In stream mode, the reply appears immediately and grows as the model writes. Slack shows its generic
|
|
56
|
+
"is working..." state until the stream ends, while optional reasoning and tool cards keep progress
|
|
57
|
+
inside the same message.
|
|
59
58
|
|
|
60
59
|
```ts
|
|
61
60
|
export default slackChannel({
|
|
@@ -71,24 +70,19 @@ export default slackChannel({
|
|
|
71
70
|
|
|
72
71
|
## Let the agent own every message
|
|
73
72
|
|
|
74
|
-
Use agentic mode when the agent should decide how to communicate
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
how to deliver the final reply.
|
|
73
|
+
Use agentic mode when the agent should decide how to communicate as well as what to say. The bot
|
|
74
|
+
reacts to the parent message with eyes and shows a thinking chip, then the agent chooses when to
|
|
75
|
+
post progress and how to deliver the final reply.
|
|
78
76
|
|
|
79
|
-
`slack-communication` gives those posts a Slack-aware voice by default
|
|
80
|
-
|
|
81
|
-
tool chatter off the thread. Use `tone` for the rest of the
|
|
82
|
-
communication contract, including voice, level of detail, formatting,
|
|
83
|
-
and how updates should be structured.
|
|
77
|
+
`slack-communication` gives those posts a Slack-aware voice by default. Use `tone` to set the voice,
|
|
78
|
+
level of detail, formatting, and structure of updates.
|
|
84
79
|
|
|
85
80
|
```ts
|
|
86
81
|
// bot/extensions/slack.ts
|
|
87
82
|
import slackCommunication from "@grok/agent-sdk/extensions/slack-communication";
|
|
88
83
|
|
|
89
84
|
export default slackCommunication({
|
|
90
|
-
tone:
|
|
91
|
-
"Be concise but warm. Use bullets for evidence and end with the next action.",
|
|
85
|
+
tone: "Be concise but warm. Use bullets for evidence and end with the next action.",
|
|
92
86
|
});
|
|
93
87
|
```
|
|
94
88
|
|
|
@@ -101,20 +95,16 @@ export default slackChannel({
|
|
|
101
95
|
|
|
102
96
|
### Show steps as cards or as a checklist
|
|
103
97
|
|
|
104
|
-
The agent calls `post-card` to show one step of its work, such as
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
`id`, Slack updates that card. The agent uses this to move a step from
|
|
108
|
-
`in_progress` to `complete`.
|
|
98
|
+
The agent calls `post-card` to show one step of its work, such as "Scan the repo", with an `id`, a
|
|
99
|
+
`title`, a `status`, and optional `details`. Calling it again with the same `id` updates that card,
|
|
100
|
+
for example from `in_progress` to `complete`.
|
|
109
101
|
|
|
110
102
|
`cards` sets how Slack draws these steps:
|
|
111
103
|
|
|
112
|
-
| `cards`
|
|
113
|
-
|
|
|
114
|
-
| `{ display: "timeline" }` (default) |
|
|
115
|
-
| `{ display: "plan" }`
|
|
116
|
-
|
|
117
|
-
This bot shows its steps as one checklist with the title "Release check":
|
|
104
|
+
| `cards` | What Slack shows | Use it when |
|
|
105
|
+
| ----------------------------------- | ------------------------------------------- | --------------------------------------------- |
|
|
106
|
+
| `{ display: "timeline" }` (default) | A separate card in the thread for each step | One or two short steps |
|
|
107
|
+
| `{ display: "plan" }` | One checklist for every step in the turn | Several steps that readers track in one place |
|
|
118
108
|
|
|
119
109
|
```ts
|
|
120
110
|
export default slackChannel({
|
|
@@ -125,33 +115,17 @@ export default slackChannel({
|
|
|
125
115
|
});
|
|
126
116
|
```
|
|
127
117
|
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
- The `title` is optional. It can have at most 256 characters.
|
|
131
|
-
- You set the `title` in the channel configuration. The agent cannot
|
|
132
|
-
change the title.
|
|
133
|
-
- Each turn starts a new checklist with the same title.
|
|
134
|
-
- The `pending` status shows a step that has not started. Use `pending`
|
|
135
|
-
only in a plan.
|
|
136
|
-
- `slackChannel` stops at startup if `cards` is not valid. For example,
|
|
137
|
-
a `title` with `display: "timeline"` stops startup.
|
|
138
|
-
|
|
139
|
-
`display` is Slack's
|
|
140
|
-
[`task_display_mode`](https://docs.slack.dev/reference/methods/chat.startStream/),
|
|
141
|
-
and the channel sends `title` as a `plan_update` chunk.
|
|
118
|
+
- `title` is optional and can be up to 256 characters.
|
|
119
|
+
- `pending` only works when `display` is `"plan"`.
|
|
142
120
|
|
|
143
121
|
## Wake on a channel post
|
|
144
122
|
|
|
145
|
-
This example watches `#triage-alerts`, so any substantial top-level
|
|
146
|
-
|
|
147
|
-
guard filters out short posts before they can start a turn.
|
|
123
|
+
This example watches `#triage-alerts`, so any substantial top-level message starts a thread even
|
|
124
|
+
when nobody mentions the bot.
|
|
148
125
|
|
|
149
|
-
Mentions work in any channel the bot has joined.
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
`#name` entries for readability. A lone `"*"` watches replies in every
|
|
153
|
-
joined channel (`posts: "replies"`), but it does not wake on top-level
|
|
154
|
-
posts. Do not mix `"*"` with channel IDs.
|
|
126
|
+
Mentions work in any channel the bot has joined. To listen without a mention, list between 1 and 10
|
|
127
|
+
channel IDs that start with `C` or `G`, plus optional `#name` entries for readability. On its own,
|
|
128
|
+
`"*"` watches thread replies in every joined channel but never wakes on top-level posts.
|
|
155
129
|
|
|
156
130
|
```ts
|
|
157
131
|
export default slackChannel({
|
|
@@ -172,97 +146,44 @@ export default slackChannel({
|
|
|
172
146
|
});
|
|
173
147
|
```
|
|
174
148
|
|
|
175
|
-
When you create the app, pass `--channel-posts` and invite the bot to
|
|
176
|
-
|
|
177
|
-
|
|
178
|
-
On Cursor-managed hosting, the channel IDs in `allow` define which
|
|
179
|
-
top-level posts can wake the agent. Replies in threads the agent has
|
|
180
|
-
already joined still arrive. `debounceMs` applies only when you
|
|
181
|
-
self-host. Add the `channels:read` scope when you include `#name`
|
|
182
|
-
labels.
|
|
149
|
+
When you create the app, pass `--channel-posts` and invite the bot to every channel in the
|
|
150
|
+
allowlist. Add the `channels:read` scope when you use `#name` entries. On Cursor hosting,
|
|
151
|
+
`debounceMs` has no effect.
|
|
183
152
|
|
|
184
153
|
## Control who can message
|
|
185
154
|
|
|
186
|
-
By default, people outside your workspace
|
|
187
|
-
|
|
188
|
-
channel and can mention or reply to bots installed by your
|
|
189
|
-
organization. Keeping `blockExternals` on prevents them from starting
|
|
190
|
-
or steering an agent session and, through it, directing any tools
|
|
191
|
-
available to the agent.
|
|
155
|
+
By default, the agent doesn't reply to people outside your workspace, such as Slack Connect guests.
|
|
156
|
+
Set `blockExternals: false` only if those people should be able to use the agent.
|
|
192
157
|
|
|
193
|
-
|
|
194
|
-
|
|
158
|
+
Anyone in a thread can continue its session by default. To keep the conversation between the agent
|
|
159
|
+
and the person who started it, set `respondTo: "author"`.
|
|
195
160
|
|
|
196
161
|
```ts
|
|
197
162
|
export default slackChannel({
|
|
198
|
-
|
|
199
|
-
policy: { blockExternals: false },
|
|
200
|
-
});
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
Anyone in a thread can continue its session by default. If the
|
|
204
|
-
conversation should stay between the agent and its original author,
|
|
205
|
-
set `respondTo: "author"`.
|
|
206
|
-
|
|
207
|
-
```ts
|
|
208
|
-
export default slackChannel({
|
|
209
|
-
policy: { respondTo: "author" },
|
|
163
|
+
policy: { blockExternals: false, respondTo: "author" },
|
|
210
164
|
});
|
|
211
165
|
```
|
|
212
166
|
|
|
213
167
|
## Events
|
|
214
168
|
|
|
215
|
-
Mentions and DMs wake the agent automatically
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
handler returns `{}` to start a turn or `null` to skip it.
|
|
219
|
-
|
|
220
|
-
For example, this handler only starts a turn for DMs prefixed with
|
|
221
|
-
`triage:`:
|
|
169
|
+
Mentions and DMs wake the agent automatically. Declare `onAppMention` or `onDirectMessage` to filter
|
|
170
|
+
them. Like `onChannelPost`, each handler returns `{}` to start a turn or `null` to skip the message.
|
|
171
|
+
This handler only starts a turn for DMs that begin with `triage:`:
|
|
222
172
|
|
|
223
173
|
```ts
|
|
224
174
|
onDirectMessage: async (_ctx, message) => {
|
|
225
175
|
if (!message.markdown.startsWith("triage:")) {
|
|
226
176
|
return null;
|
|
227
177
|
}
|
|
228
|
-
// `{}` starts a model turn as the sender.
|
|
229
178
|
return {};
|
|
230
179
|
},
|
|
231
180
|
```
|
|
232
181
|
|
|
233
|
-
## Thread affinity
|
|
234
|
-
|
|
235
|
-
Mention the bot in a channel and it answers in a thread on that message.
|
|
236
|
-
Follow-ups in the same thread continue that session.
|
|
237
|
-
|
|
238
|
-
A direct message continues the one session for that DM, including replies
|
|
239
|
-
under later top-level messages. To give each top-level DM its own session,
|
|
240
|
-
and keep replies in that message's thread on it, set the continuation
|
|
241
|
-
selector:
|
|
242
|
-
|
|
243
|
-
```ts
|
|
244
|
-
export default slackChannel({
|
|
245
|
-
continuation: "slack.dmthread/v2",
|
|
246
|
-
});
|
|
247
|
-
```
|
|
248
|
-
|
|
249
|
-
Under `slack.dmthread/v2`, a DM thread behaves like a channel thread: a
|
|
250
|
-
reply loads the thread's history, the turn edits only its own placeholder,
|
|
251
|
-
and an approval click must come from that thread.
|
|
252
|
-
|
|
253
|
-
Channel threads keep one session per thread with either selector.
|
|
254
|
-
`slack.none/v2` starts a new session on every delivery.
|
|
255
|
-
|
|
256
182
|
## Call Slack from deterministic code via `ctx`
|
|
257
183
|
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
- Channel hooks: `ctx.thread.post()`, `ctx.slack.channelId`,
|
|
263
|
-
`ctx.slack.threadTs`
|
|
264
|
-
|
|
265
|
-
- Tools: `ctx.host.slack.getClient()`
|
|
184
|
+
A hook can post a fixed acknowledgement before the model turn starts, using `ctx.thread.post()`,
|
|
185
|
+
`ctx.slack.channelId`, and `ctx.slack.threadTs`, while tools call the Slack Web API with
|
|
186
|
+
`ctx.host.slack.getClient()`.
|
|
266
187
|
|
|
267
188
|
```ts
|
|
268
189
|
onAppMention: async (ctx, message) => {
|
|
@@ -274,39 +195,36 @@ onAppMention: async (ctx, message) => {
|
|
|
274
195
|
},
|
|
275
196
|
```
|
|
276
197
|
|
|
277
|
-
Use the IDs on the hook `ctx` when handling an event, and
|
|
278
|
-
`ctx.host.slack.getClient()` when a tool needs the Slack Web API.
|
|
279
|
-
|
|
280
198
|
## Connect
|
|
281
199
|
|
|
282
200
|
```bash
|
|
283
201
|
agent-sdk login
|
|
284
202
|
agent-sdk slack create --dir .
|
|
285
203
|
agent-sdk slack doctor --prefix TRIAGE
|
|
204
|
+
agent-sdk serve --dir . --dev
|
|
286
205
|
```
|
|
287
206
|
|
|
288
|
-
After you sign in, `slack create` opens **Add Slack to this agent** in
|
|
289
|
-
|
|
290
|
-
|
|
291
|
-
|
|
207
|
+
After you sign in, `slack create` opens **Add Slack to this agent** in the browser and writes the
|
|
208
|
+
resulting tokens to `.env.local` without printing them. You can open the same wizard from
|
|
209
|
+
**Integrations** on [Deployed Agents](https://cursor.com/dashboard/deployed-agents). `doctor`
|
|
210
|
+
catches missing credentials before you start the agent. The
|
|
211
|
+
[CLI reference](../reference/cli.md#slack) covers each `slack` command.
|
|
292
212
|
|
|
293
|
-
If
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
return to the dashboard's **Add Slack** wizard and select **Retry**.
|
|
213
|
+
If your workspace requires admin approval, keep `slack create` running and open the **Request
|
|
214
|
+
approval** link it prints. Installing from Deployed Agents doesn't send that request. After an admin
|
|
215
|
+
approves, select **Retry** in the **Add Slack** wizard there.
|
|
297
216
|
|
|
298
217
|
### Choose the bot scopes
|
|
299
218
|
|
|
300
219
|
A Cursor-managed app requests these bot scopes by default:
|
|
301
220
|
|
|
302
|
-
`app_mentions:read`, `assistant:write`, `channels:history`,
|
|
303
|
-
`
|
|
304
|
-
`
|
|
305
|
-
`
|
|
306
|
-
`users:read`, `users:read.email`
|
|
221
|
+
`app_mentions:read`, `assistant:write`, `channels:history`, `channels:read`, `chat:write`,
|
|
222
|
+
`files:read`, `files:write`, `groups:history`, `groups:read`, `im:history`, `im:read`, `im:write`,
|
|
223
|
+
`mpim:history`, `reactions:read`, `reactions:write`, `usergroups:read`, `users:read`,
|
|
224
|
+
`users:read.email`
|
|
307
225
|
|
|
308
|
-
To request a different list, set `botScopes` in `slack-manifest.json` at
|
|
309
|
-
|
|
226
|
+
To request a different list, set `botScopes` in `slack-manifest.json` at the root of the agent
|
|
227
|
+
project. The app then requests exactly that list:
|
|
310
228
|
|
|
311
229
|
```json
|
|
312
230
|
{
|
|
@@ -323,63 +241,16 @@ the root of the agent project. The app then requests exactly that list:
|
|
|
323
241
|
}
|
|
324
242
|
```
|
|
325
243
|
|
|
326
|
-
Then run `agent-sdk slack create` again (add `--env prod` for the production
|
|
327
|
-
|
|
328
|
-
the app and installs it again. If the workspace requires admin approval,
|
|
329
|
-
the approval request lists every scope the app requests.
|
|
330
|
-
|
|
331
|
-
- The list must include the required scopes: `app_mentions:read`,
|
|
332
|
-
`assistant:write`, `channels:history`, `chat:write`, `groups:history`,
|
|
333
|
-
`im:history`, and `reactions:read`. The Slack channel needs them to
|
|
334
|
-
receive mentions, DMs, channel posts, and reactions, and to reply.
|
|
335
|
-
- If you remove a default scope, the features that use it stop working.
|
|
336
|
-
For example, file uploads need `files:write`.
|
|
337
|
-
- Use bot scopes only, at most 50. User scopes are not supported.
|
|
338
|
-
- Cursor rejects scopes in the Slack Marketplace forbidden families:
|
|
339
|
-
`admin.*`, `identity.*`, `search:read*`, `triggers:*`,
|
|
340
|
-
`apps_configuration:*`, and `workflow.steps:execute`.
|
|
341
|
-
- Without `botScopes`, the app requests the default list plus any other
|
|
342
|
-
scopes it already has. To remove a scope you added, list the scopes you
|
|
343
|
-
want and run `agent-sdk slack create` again.
|
|
344
|
-
|
|
345
|
-
The person who runs `agent-sdk slack create` also grants Cursor three user
|
|
346
|
-
scopes in their own Slack account: `app_configurations:read`,
|
|
347
|
-
`app_configurations:write`, and `managed_apps:install`. Cursor uses them
|
|
348
|
-
to create, update, and install the agent's app. They are not scopes of
|
|
349
|
-
the agent's app, and `botScopes` does not change them.
|
|
350
|
-
|
|
351
|
-
If you already own the Slack app, initialize it with
|
|
352
|
-
`agent-sdk slack init --manual --dir . --name "Triage"` and follow the
|
|
353
|
-
[Slack setup skill](../../skills/setup-slack/SKILL.md) for installation
|
|
354
|
-
and tokens.
|
|
355
|
-
|
|
356
|
-
## Test locally
|
|
357
|
-
|
|
358
|
-
Run `doctor` first to catch missing credentials, then start the agent
|
|
359
|
-
and send it the same mention or DM a teammate would.
|
|
360
|
-
|
|
361
|
-
```bash
|
|
362
|
-
agent-sdk slack doctor --prefix TRIAGE
|
|
363
|
-
agent-sdk serve --dir . --dev
|
|
364
|
-
```
|
|
365
|
-
|
|
366
|
-
## Practices
|
|
367
|
-
|
|
368
|
-
- If the tokens are missing, the Slack channel stays idle while the
|
|
369
|
-
rest of `serve` starts normally.
|
|
370
|
-
|
|
371
|
-
- Keep `channelPosts.allow` narrow because each qualifying post can
|
|
372
|
-
start a model turn.
|
|
244
|
+
Then run `agent-sdk slack create` again (add `--env prod` for the production app), and Slack updates
|
|
245
|
+
and reinstalls the app.
|
|
373
246
|
|
|
374
|
-
-
|
|
375
|
-
|
|
247
|
+
- The list must include `app_mentions:read`, `assistant:write`, `channels:history`, `chat:write`,
|
|
248
|
+
`groups:history`, `im:history`, and `reactions:read`.
|
|
249
|
+
- Cursor rejects scopes in the Slack Marketplace forbidden families: `admin.*`, `identity.*`,
|
|
250
|
+
`search:read*`, `triggers:*`, `apps_configuration:*`, and `workflow.steps:execute`.
|
|
376
251
|
|
|
377
|
-
|
|
252
|
+
The person who runs `slack create` grants Cursor three user scopes on their own account so it can
|
|
253
|
+
create and install the app, and `botScopes` doesn't change them.
|
|
378
254
|
|
|
379
|
-
-
|
|
380
|
-
|
|
381
|
-
- [`skills/setup-slack/SKILL.md`](../../skills/setup-slack/SKILL.md):
|
|
382
|
-
the companion skill for coding agents
|
|
383
|
-
- [Webhooks and custom channels](./webhooks.md): host prep on mention
|
|
384
|
-
and DM handlers
|
|
385
|
-
- [Evals](../evals.md): freeze a mention as a regression check
|
|
255
|
+
If you already own the Slack app, run `agent-sdk slack init --manual --dir . --name "Triage"` and
|
|
256
|
+
follow the `bdk-setup-slack` skill for installation and tokens.
|