@grok/agent-sdk 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (521) hide show
  1. package/AGENTS.md +40 -0
  2. package/dist/channels/github/forward.d.ts +5 -0
  3. package/dist/channels/github/forward.d.ts.map +1 -1
  4. package/dist/channels/github/forward.js +6 -3
  5. package/dist/channels/slack/api.d.ts +18 -0
  6. package/dist/channels/slack/api.d.ts.map +1 -1
  7. package/dist/channels/slack/api.js +31 -0
  8. package/dist/channels/slack/approvals.d.ts +19 -2
  9. package/dist/channels/slack/approvals.d.ts.map +1 -1
  10. package/dist/channels/slack/approvals.js +90 -19
  11. package/dist/channels/slack/attachments.d.ts +7 -2
  12. package/dist/channels/slack/attachments.d.ts.map +1 -1
  13. package/dist/channels/slack/attachments.js +318 -156
  14. package/dist/channels/slack/connect-card.d.ts +16 -0
  15. package/dist/channels/slack/connect-card.d.ts.map +1 -0
  16. package/dist/channels/slack/connect-card.js +31 -0
  17. package/dist/channels/slack/credentials.d.ts +10 -2
  18. package/dist/channels/slack/credentials.d.ts.map +1 -1
  19. package/dist/channels/slack/credentials.js +17 -15
  20. package/dist/channels/slack/defaults.d.ts.map +1 -1
  21. package/dist/channels/slack/defaults.js +18 -9
  22. package/dist/channels/slack/dispatch.d.ts +1 -1
  23. package/dist/channels/slack/dispatch.d.ts.map +1 -1
  24. package/dist/channels/slack/dispatch.js +19 -3
  25. package/dist/channels/slack/inbound.d.ts +8 -2
  26. package/dist/channels/slack/inbound.d.ts.map +1 -1
  27. package/dist/channels/slack/inbound.js +25 -4
  28. package/dist/channels/slack/index.d.ts +3 -2
  29. package/dist/channels/slack/index.d.ts.map +1 -1
  30. package/dist/channels/slack/index.js +3 -2
  31. package/dist/channels/slack/init.d.ts.map +1 -1
  32. package/dist/channels/slack/init.js +2 -1
  33. package/dist/channels/slack/mentions.d.ts +28 -0
  34. package/dist/channels/slack/mentions.d.ts.map +1 -0
  35. package/dist/channels/slack/mentions.js +178 -0
  36. package/dist/channels/slack/setup.js +1 -1
  37. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  38. package/dist/channels/slack/slack-channel.js +46 -3
  39. package/dist/channels/slack/stop.d.ts.map +1 -1
  40. package/dist/channels/slack/stop.js +7 -1
  41. package/dist/channels/slack/thread-context.d.ts +3 -0
  42. package/dist/channels/slack/thread-context.d.ts.map +1 -1
  43. package/dist/channels/slack/thread-context.js +17 -7
  44. package/dist/channels/slack/tool-approval-events.d.ts.map +1 -1
  45. package/dist/channels/slack/tool-approval-events.js +55 -2
  46. package/dist/channels/slack/types.d.ts +2 -0
  47. package/dist/channels/slack/types.d.ts.map +1 -1
  48. package/dist/channels/teams/activity.d.ts +33 -0
  49. package/dist/channels/teams/activity.d.ts.map +1 -0
  50. package/dist/channels/teams/activity.js +213 -0
  51. package/dist/channels/teams/auth.d.ts +25 -0
  52. package/dist/channels/teams/auth.d.ts.map +1 -0
  53. package/dist/channels/teams/auth.js +55 -0
  54. package/dist/channels/teams/bot-framework-auth.d.ts +33 -0
  55. package/dist/channels/teams/bot-framework-auth.d.ts.map +1 -0
  56. package/dist/channels/teams/bot-framework-auth.js +154 -0
  57. package/dist/channels/teams/cards.d.ts +23 -0
  58. package/dist/channels/teams/cards.d.ts.map +1 -0
  59. package/dist/channels/teams/cards.js +107 -0
  60. package/dist/channels/teams/connector.d.ts +48 -0
  61. package/dist/channels/teams/connector.d.ts.map +1 -0
  62. package/dist/channels/teams/connector.js +159 -0
  63. package/dist/channels/teams/credentials.d.ts +65 -0
  64. package/dist/channels/teams/credentials.d.ts.map +1 -0
  65. package/dist/channels/teams/credentials.js +84 -0
  66. package/dist/channels/teams/delivery.d.ts +14 -0
  67. package/dist/channels/teams/delivery.d.ts.map +1 -0
  68. package/dist/channels/teams/delivery.js +169 -0
  69. package/dist/channels/teams/dispatch.d.ts +45 -0
  70. package/dist/channels/teams/dispatch.d.ts.map +1 -0
  71. package/dist/channels/teams/dispatch.js +402 -0
  72. package/dist/channels/teams/engagement.d.ts +32 -0
  73. package/dist/channels/teams/engagement.d.ts.map +1 -0
  74. package/dist/channels/teams/engagement.js +120 -0
  75. package/dist/channels/teams/index.d.ts +21 -0
  76. package/dist/channels/teams/index.d.ts.map +1 -0
  77. package/dist/channels/teams/index.js +19 -0
  78. package/dist/channels/teams/marks.d.ts +19 -0
  79. package/dist/channels/teams/marks.d.ts.map +1 -0
  80. package/dist/channels/teams/marks.js +96 -0
  81. package/dist/channels/teams/senders.d.ts +27 -0
  82. package/dist/channels/teams/senders.d.ts.map +1 -0
  83. package/dist/channels/teams/senders.js +72 -0
  84. package/dist/channels/teams/teams-channel.d.ts +43 -0
  85. package/dist/channels/teams/teams-channel.d.ts.map +1 -0
  86. package/dist/channels/teams/teams-channel.js +278 -0
  87. package/dist/channels/teams/text.d.ts +7 -0
  88. package/dist/channels/teams/text.d.ts.map +1 -0
  89. package/dist/channels/teams/text.js +63 -0
  90. package/dist/channels/teams/types.d.ts +306 -0
  91. package/dist/channels/teams/types.d.ts.map +1 -0
  92. package/dist/channels/teams/types.js +1 -0
  93. package/dist/channels.d.ts +31 -0
  94. package/dist/channels.d.ts.map +1 -1
  95. package/dist/channels.js +37 -0
  96. package/dist/connections.d.ts +1 -1
  97. package/dist/connections.d.ts.map +1 -1
  98. package/dist/docs/404.html +3 -3
  99. package/dist/docs/assets/{app.lt-BYgI2.js → app.Ch-048af.js} +4 -4
  100. package/dist/docs/assets/changelog.md.SoN0MK7o.js +1 -0
  101. package/dist/docs/assets/{changelog.md.DVNB-ApU.lean.js → changelog.md.SoN0MK7o.lean.js} +1 -1
  102. package/dist/docs/assets/chunks/@localSearchIndexroot.BdYoBKxY.js +1 -0
  103. package/dist/docs/assets/chunks/{VPLocalSearchBox.v_dV4U2Q.js → VPLocalSearchBox.D7BIa9Su.js} +2 -2
  104. package/dist/docs/assets/chunks/{arc.5o92kOg5.js → arc.BIzu7OVF.js} +1 -1
  105. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.C-oTwnNq.js → architectureDiagram-Q4EWVU46.DNznI0Sn.js} +1 -1
  106. package/dist/docs/assets/chunks/{baseUniq.zJ-VNOib.js → baseUniq.B4y6Y5eG.js} +1 -1
  107. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.B9ZJZuPd.js → blockDiagram-DXYQGD6D.BudnBsgw.js} +1 -1
  108. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.BBMwSIaN.js → c4Diagram-AHTNJAMY._bB00GdB.js} +1 -1
  109. package/dist/docs/assets/chunks/channel.CgxlmuBS.js +1 -0
  110. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.D8qAJpDD.js → chunk-4BX2VUAB.CRftnUwS.js} +1 -1
  111. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.B8QR5cdE.js → chunk-4TB4RGXK.CSx1x2Ob.js} +1 -1
  112. package/dist/docs/assets/chunks/{chunk-55IACEB6.BsWxVuew.js → chunk-55IACEB6.KkLHAAbH.js} +1 -1
  113. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.BeGygY_i.js → chunk-EDXVE4YY.DDeKCCtX.js} +1 -1
  114. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.DdwgH-ZH.js → chunk-FMBD7UC4.DrLlsD9m.js} +1 -1
  115. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.B9zC_ALe.js → chunk-OYMX7WX6.DeVYOGcT.js} +1 -1
  116. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BIxJ0rcL.js → chunk-QZHKN3VN.Cz4_bS6p.js} +1 -1
  117. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.qiM_23_f.js → chunk-YZCP3GAM.CwrYtDVo.js} +1 -1
  118. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DWroREP-.js +1 -0
  119. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DWroREP-.js +1 -0
  120. package/dist/docs/assets/chunks/clone.F824-PNx.js +1 -0
  121. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.BKB971D5.js → cose-bilkent-S5V4N54A.3d8hflz6.js} +1 -1
  122. package/dist/docs/assets/chunks/{dagre-KV5264BT.CcILjJgp.js → dagre-KV5264BT.BVEgjiPg.js} +1 -1
  123. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DkY9A0nu.js → diagram-5BDNPKRD.j7dZpUK_.js} +1 -1
  124. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BbdzmjMt.js → diagram-G4DWMVQ6.4flIgIon.js} +1 -1
  125. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.Be0zy1cM.js → diagram-MMDJMWI5.BlJiFh-S.js} +1 -1
  126. package/dist/docs/assets/chunks/{diagram-TYMM5635.zOiEycLe.js → diagram-TYMM5635.DHAOHEyM.js} +1 -1
  127. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DUd_9HMF.js → erDiagram-SMLLAGMA.DkmyG7xK.js} +1 -1
  128. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.2KPYoZBO.js → flowDiagram-DWJPFMVM.L_WiaAU6.js} +1 -1
  129. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DqE8_YpP.js → ganttDiagram-T4ZO3ILL.CT6kOI2a.js} +1 -1
  130. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.CO0Tk47h.js → gitGraphDiagram-UUTBAWPF.D8CRlLqh.js} +1 -1
  131. package/dist/docs/assets/chunks/{graph.CNe5KbNy.js → graph.CdOyJvsX.js} +1 -1
  132. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.BBhJ1X1B.js → infoDiagram-42DDH7IO.DcmXeSos.js} +1 -1
  133. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.KSIw9w3I.js → ishikawaDiagram-UXIWVN3A.BBjY4mxr.js} +1 -1
  134. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BN2Y5oUJ.js → journeyDiagram-VCZTEJTY.BrXteAB6.js} +1 -1
  135. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.2KFuDYn_.js → kanban-definition-6JOO6SKY.OlHsUJVV.js} +1 -1
  136. package/dist/docs/assets/chunks/{layout.Demb_pzL.js → layout.DDwvoQlY.js} +1 -1
  137. package/dist/docs/assets/chunks/{linear.kYKxzbbR.js → linear.BRXPDWj3.js} +1 -1
  138. package/dist/docs/assets/chunks/{min.DwmCN5dF.js → min.3YwC0t3o.js} +1 -1
  139. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.CGlz01QG.js → mindmap-definition-QFDTVHPH.mPHnT2lN.js} +1 -1
  140. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.n3qsq4nA.js → pieDiagram-DEJITSTG.DEK2--em.js} +1 -1
  141. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CGNJ1GSb.js → quadrantDiagram-34T5L4WZ.NCdRAOzK.js} +1 -1
  142. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.VhAzHDwQ.js → requirementDiagram-MS252O5E.DLAocFWZ.js} +1 -1
  143. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.DmHA5pW-.js → sankeyDiagram-XADWPNL6.afIOqpyT.js} +1 -1
  144. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23._TC1aKhg.js → sequenceDiagram-FGHM5R23.DXBjvkkE.js} +1 -1
  145. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B-kLjV3O.js → stateDiagram-FHFEXIEX.B_SGgvgs.js} +1 -1
  146. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.OKAy5Bz7.js +1 -0
  147. package/dist/docs/assets/chunks/{theme.BaVlHHL-.js → theme.bNyH5NPA.js} +2 -2
  148. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.CresbphV.js → timeline-definition-GMOUNBTQ.CE6S1iSb.js} +1 -1
  149. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.CegHD8Y4.js → vennDiagram-DHZGUBPP.Blk7wb8V.js} +1 -1
  150. package/dist/docs/assets/chunks/{wardley-RL74JXVD.DjCmZrUO.js → wardley-RL74JXVD.DQqE3WF8.js} +1 -1
  151. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js → wardleyDiagram-NUSXRM2D.MUEQyRnz.js} +1 -1
  152. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.IrEXlemI.js → xychartDiagram-5P7HB3ND.DnJA2aXp.js} +1 -1
  153. package/dist/docs/assets/{deployment.md.DJtuDVLh.js → deployment.md.N9S5KC5R.js} +2 -2
  154. package/dist/docs/assets/{deployment.md.DJtuDVLh.lean.js → deployment.md.N9S5KC5R.lean.js} +1 -1
  155. package/dist/docs/assets/guides_cloud-agents.md.BdWqmUGb.js +14 -0
  156. package/dist/docs/assets/{guides_cloud-agents.md.CiXAW6on.lean.js → guides_cloud-agents.md.BdWqmUGb.lean.js} +1 -1
  157. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.js +50 -0
  158. package/dist/docs/assets/guides_teams.md.7Lz2sbqB.lean.js +1 -0
  159. package/dist/docs/assets/{reference_channels.md.CPWOpdsC.js → reference_channels.md.CRvqgU0n.js} +1 -1
  160. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.js → reference_cli.md.NS6U5a-7.js} +14 -4
  161. package/dist/docs/assets/{reference_cli.md.DHm6DmYk.lean.js → reference_cli.md.NS6U5a-7.lean.js} +1 -1
  162. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.js → reference_limits.md.CW9PTdxr.js} +3 -3
  163. package/dist/docs/assets/{reference_limits.md.CbdtFr4T.lean.js → reference_limits.md.CW9PTdxr.lean.js} +1 -1
  164. package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.js → reference_schedules.md.Dd8_d0WG.js} +3 -3
  165. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.js → reference_sessions.md.CoCyQLEz.js} +2 -2
  166. package/dist/docs/assets/{reference_sessions.md.NXVQt9mP.lean.js → reference_sessions.md.CoCyQLEz.lean.js} +1 -1
  167. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.js → reference_skills.md.SFRZDC41.js} +4 -4
  168. package/dist/docs/assets/{reference_skills.md.DzCPNPkG.lean.js → reference_skills.md.SFRZDC41.lean.js} +1 -1
  169. package/dist/docs/assets/{style.DK0YX1WL.css → style.B7zPxANR.css} +1 -1
  170. package/dist/docs/assets/troubleshooting.md.CsQTleto.js +3 -0
  171. package/dist/docs/assets/{troubleshooting.md.DfKKvW1R.lean.js → troubleshooting.md.CsQTleto.lean.js} +1 -1
  172. package/dist/docs/building-with-agents.html +37 -37
  173. package/dist/docs/changelog.html +37 -37
  174. package/dist/docs/changelog.md +35 -0
  175. package/dist/docs/deployment.html +39 -39
  176. package/dist/docs/deployment.md +10 -0
  177. package/dist/docs/evals.html +37 -37
  178. package/dist/docs/guides/agent-to-agent.html +37 -37
  179. package/dist/docs/guides/bitbucket.html +37 -37
  180. package/dist/docs/guides/cloud-agents.html +43 -38
  181. package/dist/docs/guides/cloud-agents.md +47 -0
  182. package/dist/docs/guides/convert-automation.html +37 -37
  183. package/dist/docs/guides/github.html +37 -37
  184. package/dist/docs/guides/gitlab.html +37 -37
  185. package/dist/docs/guides/improve.html +37 -37
  186. package/dist/docs/guides/jev.html +37 -37
  187. package/dist/docs/guides/mcp-oauth.html +37 -37
  188. package/dist/docs/guides/migrate.html +37 -37
  189. package/dist/docs/guides/opentelemetry.html +37 -37
  190. package/dist/docs/guides/pagerduty.html +37 -37
  191. package/dist/docs/guides/slack.html +37 -37
  192. package/dist/docs/guides/teams.html +109 -0
  193. package/dist/docs/guides/teams.md +384 -0
  194. package/dist/docs/guides/webhooks.html +37 -37
  195. package/dist/docs/hashmap.json +1 -1
  196. package/dist/docs/hillclimbing.html +37 -37
  197. package/dist/docs/index.html +37 -37
  198. package/dist/docs/llms-full.txt +636 -4
  199. package/dist/docs/llms.txt +1 -0
  200. package/dist/docs/quickstart.html +37 -37
  201. package/dist/docs/reference/access.html +36 -36
  202. package/dist/docs/reference/agent-config.html +37 -37
  203. package/dist/docs/reference/artifacts.html +37 -37
  204. package/dist/docs/reference/channels.html +38 -38
  205. package/dist/docs/reference/channels.md +1 -0
  206. package/dist/docs/reference/cli.html +50 -40
  207. package/dist/docs/reference/cli.md +116 -0
  208. package/dist/docs/reference/connections.html +37 -37
  209. package/dist/docs/reference/evals.html +37 -37
  210. package/dist/docs/reference/extensions.html +37 -37
  211. package/dist/docs/reference/hooks.html +37 -37
  212. package/dist/docs/reference/http-api.html +37 -37
  213. package/dist/docs/reference/instructions.html +37 -37
  214. package/dist/docs/reference/limits.html +39 -39
  215. package/dist/docs/reference/limits.md +4 -4
  216. package/dist/docs/reference/memory.html +37 -37
  217. package/dist/docs/reference/playground.html +36 -36
  218. package/dist/docs/reference/project-layout.html +37 -37
  219. package/dist/docs/reference/schedules.html +40 -40
  220. package/dist/docs/reference/sessions.html +38 -38
  221. package/dist/docs/reference/sessions.md +13 -0
  222. package/dist/docs/reference/skills.html +40 -40
  223. package/dist/docs/reference/subagents.html +37 -37
  224. package/dist/docs/reference/tools.html +37 -37
  225. package/dist/docs/templates/agentic-owners.html +37 -37
  226. package/dist/docs/templates/reviews.html +37 -37
  227. package/dist/docs/troubleshooting.html +38 -38
  228. package/dist/docs/troubleshooting.md +21 -0
  229. package/dist/evals/run-facts.d.ts.map +1 -1
  230. package/dist/evals/run-facts.js +4 -0
  231. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts +12 -0
  232. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.d.ts.map +1 -0
  233. package/dist/extensions/cursor-cloud-agents/channels/cursor-cloud-agents.js +42 -0
  234. package/dist/extensions/cursor-cloud-agents/extension.d.ts +10 -7
  235. package/dist/extensions/cursor-cloud-agents/extension.d.ts.map +1 -1
  236. package/dist/extensions/cursor-cloud-agents/extension.js +3 -2
  237. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts +5 -0
  238. package/dist/extensions/cursor-cloud-agents/lib/agent-id.d.ts.map +1 -0
  239. package/dist/extensions/cursor-cloud-agents/lib/agent-id.js +10 -0
  240. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts +57 -3
  241. package/dist/extensions/cursor-cloud-agents/lib/backend.d.ts.map +1 -1
  242. package/dist/extensions/cursor-cloud-agents/lib/backend.js +150 -35
  243. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts +32 -4
  244. package/dist/extensions/cursor-cloud-agents/lib/fleet.d.ts.map +1 -1
  245. package/dist/extensions/cursor-cloud-agents/lib/fleet.js +93 -7
  246. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts +24 -7
  247. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.d.ts.map +1 -1
  248. package/dist/extensions/cursor-cloud-agents/lib/launch-agent.js +158 -25
  249. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts +18 -0
  250. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.d.ts.map +1 -0
  251. package/dist/extensions/cursor-cloud-agents/lib/stop-signal.js +27 -0
  252. package/dist/extensions/cursor-cloud-agents/lib/transcript.d.ts.map +1 -1
  253. package/dist/extensions/cursor-cloud-agents/lib/transcript.js +2 -3
  254. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts +26 -12
  255. package/dist/extensions/cursor-cloud-agents/lib/watch.d.ts.map +1 -1
  256. package/dist/extensions/cursor-cloud-agents/lib/watch.js +115 -46
  257. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts +16 -5
  258. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.d.ts.map +1 -1
  259. package/dist/extensions/cursor-cloud-agents/reminders/cloud-agent-stop-watch.js +76 -20
  260. package/dist/extensions/cursor-cloud-agents/skills/handoff.md +2 -2
  261. package/dist/extensions/cursor-cloud-agents/tools/get.js +2 -2
  262. package/dist/extensions/cursor-cloud-agents/tools/launch.js +1 -1
  263. package/dist/extensions.d.ts.map +1 -1
  264. package/dist/extensions.js +18 -3
  265. package/dist/files-backends/agent-store-presigned-url.js +5 -1
  266. package/dist/index.d.ts +1 -0
  267. package/dist/index.d.ts.map +1 -1
  268. package/dist/index.js +1 -0
  269. package/dist/internal/approval-gate.d.ts +6 -1
  270. package/dist/internal/approval-gate.d.ts.map +1 -1
  271. package/dist/internal/approval-gate.js +13 -2
  272. package/dist/internal/authored-loaders.js +1 -1
  273. package/dist/internal/channel-architecture.d.ts.map +1 -1
  274. package/dist/internal/channel-architecture.js +3 -1
  275. package/dist/internal/cli/commands/channels.d.ts +9 -3
  276. package/dist/internal/cli/commands/channels.d.ts.map +1 -1
  277. package/dist/internal/cli/commands/channels.js +193 -4
  278. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  279. package/dist/internal/cli/commands/index.js +6 -1
  280. package/dist/internal/cli/commands/serve.d.ts.map +1 -1
  281. package/dist/internal/cli/commands/serve.js +25 -5
  282. package/dist/internal/cli/dispatch.d.ts.map +1 -1
  283. package/dist/internal/cli/dispatch.js +22 -8
  284. package/dist/internal/cli/flags.d.ts +14 -0
  285. package/dist/internal/cli/flags.d.ts.map +1 -1
  286. package/dist/internal/cli/flags.js +14 -0
  287. package/dist/internal/cli/help.d.ts.map +1 -1
  288. package/dist/internal/cli/help.js +3 -1
  289. package/dist/internal/cli-cursor.js +2 -2
  290. package/dist/internal/cli-deploy.d.ts +1 -0
  291. package/dist/internal/cli-deploy.d.ts.map +1 -1
  292. package/dist/internal/cli-deploy.js +19 -1
  293. package/dist/internal/cli-mcp.d.ts.map +1 -1
  294. package/dist/internal/cli-mcp.js +5 -3
  295. package/dist/internal/cli-teams-doctor.d.ts +39 -0
  296. package/dist/internal/cli-teams-doctor.d.ts.map +1 -0
  297. package/dist/internal/cli-teams-doctor.js +508 -0
  298. package/dist/internal/cli-teams-forward.d.ts +84 -0
  299. package/dist/internal/cli-teams-forward.d.ts.map +1 -0
  300. package/dist/internal/cli-teams-forward.js +386 -0
  301. package/dist/internal/cli-teams-package.d.ts +26 -0
  302. package/dist/internal/cli-teams-package.d.ts.map +1 -0
  303. package/dist/internal/cli-teams-package.js +123 -0
  304. package/dist/internal/cli-teams.d.ts +15 -0
  305. package/dist/internal/cli-teams.d.ts.map +1 -0
  306. package/dist/internal/cli-teams.js +253 -0
  307. package/dist/internal/connect-click.d.ts +12 -0
  308. package/dist/internal/connect-click.d.ts.map +1 -0
  309. package/dist/internal/connect-click.js +22 -0
  310. package/dist/internal/continuation-channel.d.ts +5 -1
  311. package/dist/internal/continuation-channel.d.ts.map +1 -1
  312. package/dist/internal/continuation-channel.js +34 -0
  313. package/dist/internal/continuation-identity.d.ts +7 -4
  314. package/dist/internal/continuation-identity.d.ts.map +1 -1
  315. package/dist/internal/continuation-identity.js +66 -1
  316. package/dist/internal/convert-automation/convert-workflow.js +2 -2
  317. package/dist/internal/credential-env-names.d.ts +36 -0
  318. package/dist/internal/credential-env-names.d.ts.map +1 -0
  319. package/dist/internal/credential-env-names.js +68 -0
  320. package/dist/internal/cursor/account-mcp.d.ts +67 -9
  321. package/dist/internal/cursor/account-mcp.d.ts.map +1 -1
  322. package/dist/internal/cursor/account-mcp.js +206 -25
  323. package/dist/internal/cursor/backend-client.d.ts +10 -1
  324. package/dist/internal/cursor/backend-client.d.ts.map +1 -1
  325. package/dist/internal/cursor/backend-client.js +19 -7
  326. package/dist/internal/cursor/cloud-agent-identity.d.ts +81 -0
  327. package/dist/internal/cursor/cloud-agent-identity.d.ts.map +1 -0
  328. package/dist/internal/cursor/cloud-agent-identity.js +224 -0
  329. package/dist/internal/cursor/credentials.d.ts.map +1 -1
  330. package/dist/internal/cursor/credentials.js +3 -1
  331. package/dist/internal/cursor-account-mcp-auth.d.ts +1 -0
  332. package/dist/internal/cursor-account-mcp-auth.d.ts.map +1 -1
  333. package/dist/internal/cursor-account-mcp-auth.js +2 -1
  334. package/dist/internal/deploy-client.d.ts.map +1 -1
  335. package/dist/internal/deploy-client.js +34 -2
  336. package/dist/internal/deploy-manifest.d.ts +51 -3
  337. package/dist/internal/deploy-manifest.d.ts.map +1 -1
  338. package/dist/internal/deploy-manifest.js +96 -7
  339. package/dist/internal/discovery/agent-config.d.ts.map +1 -1
  340. package/dist/internal/discovery/agent-config.js +6 -1
  341. package/dist/internal/discovery/connections.d.ts.map +1 -1
  342. package/dist/internal/discovery/connections.js +53 -0
  343. package/dist/internal/discovery/extensions.d.ts.map +1 -1
  344. package/dist/internal/discovery/extensions.js +2 -0
  345. package/dist/internal/discovery/info.d.ts.map +1 -1
  346. package/dist/internal/discovery/info.js +4 -0
  347. package/dist/internal/env-file.d.ts +1 -0
  348. package/dist/internal/env-file.d.ts.map +1 -1
  349. package/dist/internal/env-file.js +18 -17
  350. package/dist/internal/env-prefix.d.ts +11 -0
  351. package/dist/internal/env-prefix.d.ts.map +1 -0
  352. package/dist/internal/env-prefix.js +23 -0
  353. package/dist/internal/event-id-dedupe.d.ts +12 -0
  354. package/dist/internal/event-id-dedupe.d.ts.map +1 -0
  355. package/dist/{channels/slack → internal}/event-id-dedupe.js +7 -4
  356. package/dist/internal/event-mapper.d.ts +7 -2
  357. package/dist/internal/event-mapper.d.ts.map +1 -1
  358. package/dist/internal/event-mapper.js +7 -0
  359. package/dist/internal/expected-delivery-failure.d.ts.map +1 -1
  360. package/dist/internal/expected-delivery-failure.js +3 -0
  361. package/dist/internal/extension-namespace.d.ts +9 -0
  362. package/dist/internal/extension-namespace.d.ts.map +1 -0
  363. package/dist/internal/extension-namespace.js +14 -0
  364. package/dist/internal/guid.d.ts +2 -0
  365. package/dist/internal/guid.d.ts.map +1 -0
  366. package/dist/internal/guid.js +4 -0
  367. package/dist/internal/host-kv-cas.d.ts +13 -0
  368. package/dist/internal/host-kv-cas.d.ts.map +1 -0
  369. package/dist/internal/host-kv-cas.js +8 -0
  370. package/dist/internal/host-kv.d.ts +4 -1
  371. package/dist/internal/host-kv.d.ts.map +1 -1
  372. package/dist/internal/host-kv.js +15 -2
  373. package/dist/internal/hosted-catch-protocol.d.ts +5 -0
  374. package/dist/internal/hosted-catch-protocol.d.ts.map +1 -1
  375. package/dist/internal/hosted-catch-protocol.js +5 -0
  376. package/dist/internal/hosted-catch.d.ts +2 -0
  377. package/dist/internal/hosted-catch.d.ts.map +1 -1
  378. package/dist/internal/hosted-catch.js +6 -1
  379. package/dist/internal/hosted-delivery-protocol.d.ts +3 -0
  380. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  381. package/dist/internal/hosted-delivery-protocol.js +69 -1
  382. package/dist/internal/hosted-delivery.d.ts +5 -2
  383. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  384. package/dist/internal/hosted-delivery.js +11 -2
  385. package/dist/internal/hosted-session-fixture.js +1 -1
  386. package/dist/internal/hosting.d.ts +5 -0
  387. package/dist/internal/hosting.d.ts.map +1 -1
  388. package/dist/internal/hosting.js +7 -1
  389. package/dist/internal/install-cursor-skills.d.ts +6 -7
  390. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  391. package/dist/internal/install-cursor-skills.js +15 -9
  392. package/dist/internal/interview/agent-questions.d.ts +1 -1
  393. package/dist/internal/interview/agent-questions.d.ts.map +1 -1
  394. package/dist/internal/interview/agent-questions.js +4 -3
  395. package/dist/internal/local-control-plane.d.ts.map +1 -1
  396. package/dist/internal/local-control-plane.js +24 -0
  397. package/dist/internal/mcp-allowlist-in-use.d.ts +23 -0
  398. package/dist/internal/mcp-allowlist-in-use.d.ts.map +1 -0
  399. package/dist/internal/mcp-allowlist-in-use.js +93 -0
  400. package/dist/internal/mcp-endpoint.d.ts.map +1 -1
  401. package/dist/internal/mcp-endpoint.js +8 -10
  402. package/dist/internal/mcp-host.d.ts +19 -1
  403. package/dist/internal/mcp-host.d.ts.map +1 -1
  404. package/dist/internal/mcp-host.js +67 -3
  405. package/dist/internal/mcp-oauth.d.ts.map +1 -1
  406. package/dist/internal/mcp-oauth.js +5 -7
  407. package/dist/internal/oidcAudiences.d.ts +22 -0
  408. package/dist/internal/oidcAudiences.d.ts.map +1 -0
  409. package/dist/internal/oidcAudiences.js +35 -0
  410. package/dist/internal/otel/collector.d.ts.map +1 -1
  411. package/dist/internal/otel/collector.js +2 -0
  412. package/dist/internal/platform-timers.d.ts +2 -0
  413. package/dist/internal/platform-timers.d.ts.map +1 -1
  414. package/dist/internal/platform-timers.js +14 -0
  415. package/dist/internal/private-file.d.ts +32 -1
  416. package/dist/internal/private-file.d.ts.map +1 -1
  417. package/dist/internal/private-file.js +209 -7
  418. package/dist/internal/redact-values.d.ts +3 -0
  419. package/dist/internal/redact-values.d.ts.map +1 -0
  420. package/dist/internal/redact-values.js +19 -0
  421. package/dist/internal/reminder-control-plane-protocol.d.ts +7 -1
  422. package/dist/internal/reminder-control-plane-protocol.d.ts.map +1 -1
  423. package/dist/internal/reminder-followup-error.d.ts +23 -0
  424. package/dist/internal/reminder-followup-error.d.ts.map +1 -0
  425. package/dist/internal/reminder-followup-error.js +12 -0
  426. package/dist/internal/reminder-runner.d.ts +15 -1
  427. package/dist/internal/reminder-runner.d.ts.map +1 -1
  428. package/dist/internal/reminder-runner.js +95 -21
  429. package/dist/internal/resolved-connections.d.ts.map +1 -1
  430. package/dist/internal/resolved-connections.js +23 -3
  431. package/dist/internal/run-client.js +2 -1
  432. package/dist/internal/run-program.d.ts +31 -0
  433. package/dist/internal/run-program.d.ts.map +1 -0
  434. package/dist/internal/run-program.js +150 -0
  435. package/dist/internal/sdk-runner.d.ts +28 -2
  436. package/dist/internal/sdk-runner.d.ts.map +1 -1
  437. package/dist/internal/sdk-runner.js +298 -38
  438. package/dist/internal/server.d.ts.map +1 -1
  439. package/dist/internal/server.js +45 -4
  440. package/dist/internal/session-credential.d.ts +14 -0
  441. package/dist/internal/session-credential.d.ts.map +1 -0
  442. package/dist/internal/session-credential.js +25 -0
  443. package/dist/internal/session-engine.d.ts +136 -5
  444. package/dist/internal/session-engine.d.ts.map +1 -1
  445. package/dist/internal/session-engine.js +580 -92
  446. package/dist/internal/storage-coordinator.d.ts +3 -1
  447. package/dist/internal/storage-coordinator.d.ts.map +1 -1
  448. package/dist/internal/storage-coordinator.js +13 -0
  449. package/dist/internal/storage-roles.d.ts +9 -1
  450. package/dist/internal/storage-roles.d.ts.map +1 -1
  451. package/dist/internal/teams-channel-profile.d.ts +41 -0
  452. package/dist/internal/teams-channel-profile.d.ts.map +1 -0
  453. package/dist/internal/teams-channel-profile.js +91 -0
  454. package/dist/internal/teams-devtunnel.d.ts +55 -0
  455. package/dist/internal/teams-devtunnel.d.ts.map +1 -0
  456. package/dist/internal/teams-devtunnel.js +205 -0
  457. package/dist/internal/teams-tunnel-proxy.d.ts +17 -0
  458. package/dist/internal/teams-tunnel-proxy.d.ts.map +1 -0
  459. package/dist/internal/teams-tunnel-proxy.js +100 -0
  460. package/dist/internal/testing/conversation-identity-vectors.d.ts +7 -1
  461. package/dist/internal/testing/conversation-identity-vectors.d.ts.map +1 -1
  462. package/dist/internal/testing/conversation-identity-vectors.js +67 -0
  463. package/dist/internal/testing/hosted-http.d.ts +15 -0
  464. package/dist/internal/testing/hosted-http.d.ts.map +1 -0
  465. package/dist/internal/testing/hosted-http.js +86 -0
  466. package/dist/internal/testing/teams-activity-fixtures.d.ts +28 -0
  467. package/dist/internal/testing/teams-activity-fixtures.d.ts.map +1 -0
  468. package/dist/internal/testing/teams-activity-fixtures.js +236 -0
  469. package/dist/internal/testing/teams-doctor-fixtures.d.ts +76 -0
  470. package/dist/internal/testing/teams-doctor-fixtures.d.ts.map +1 -0
  471. package/dist/internal/testing/teams-doctor-fixtures.js +216 -0
  472. package/dist/internal/tunnel-process.d.ts +29 -0
  473. package/dist/internal/tunnel-process.d.ts.map +1 -0
  474. package/dist/internal/tunnel-process.js +105 -0
  475. package/dist/internal/turn-context.d.ts +28 -0
  476. package/dist/internal/turn-context.d.ts.map +1 -0
  477. package/dist/internal/turn-context.js +1 -0
  478. package/dist/oidc-token.d.ts +127 -0
  479. package/dist/oidc-token.d.ts.map +1 -0
  480. package/dist/oidc-token.js +221 -0
  481. package/dist/playground/assets/index-BaBSZXki.css +1 -0
  482. package/dist/playground/assets/index-BkAF8YlO.js +62 -0
  483. package/dist/playground/index.html +2 -2
  484. package/dist/teams-app-package.d.ts +78 -0
  485. package/dist/teams-app-package.d.ts.map +1 -0
  486. package/dist/teams-app-package.js +204 -0
  487. package/dist/tools.d.ts +1 -1
  488. package/dist/tools.d.ts.map +1 -1
  489. package/dist/types.d.ts +271 -2
  490. package/dist/types.d.ts.map +1 -1
  491. package/docs/changelog.md +35 -0
  492. package/docs/deployment.md +10 -0
  493. package/docs/guides/cloud-agents.md +47 -0
  494. package/docs/guides/teams.md +389 -0
  495. package/docs/reference/channels.md +1 -0
  496. package/docs/reference/cli.md +116 -0
  497. package/docs/reference/limits.md +4 -4
  498. package/docs/reference/sessions.md +13 -0
  499. package/docs/troubleshooting.md +21 -0
  500. package/package.json +21 -46
  501. package/skills/create-agent/SKILL.md +17 -4
  502. package/skills/debug/SKILL.md +1 -0
  503. package/skills/deploy/SKILL.md +1 -1
  504. package/skills/framework-map/SKILL.md +1 -0
  505. package/skills/setup-teams/SKILL.md +141 -0
  506. package/templates/agentic-owners/bot/lib/owners/parse.ts +1 -0
  507. package/dist/channels/slack/event-id-dedupe.d.ts +0 -10
  508. package/dist/channels/slack/event-id-dedupe.d.ts.map +0 -1
  509. package/dist/docs/assets/changelog.md.DVNB-ApU.js +0 -1
  510. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +0 -1
  511. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +0 -1
  512. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +0 -1
  513. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +0 -1
  514. package/dist/docs/assets/chunks/clone.DpIwUbur.js +0 -1
  515. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +0 -1
  516. package/dist/docs/assets/guides_cloud-agents.md.CiXAW6on.js +0 -9
  517. package/dist/docs/assets/troubleshooting.md.DfKKvW1R.js +0 -3
  518. package/dist/playground/assets/index-CnFd5R1_.js +0 -62
  519. package/dist/playground/assets/index-DNzRv6G8.css +0 -1
  520. /package/dist/docs/assets/{reference_channels.md.CPWOpdsC.lean.js → reference_channels.md.CRvqgU0n.lean.js} +0 -0
  521. /package/dist/docs/assets/{reference_schedules.md.RhQ9ZLo1.lean.js → reference_schedules.md.Dd8_d0WG.lean.js} +0 -0
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@grok/agent-sdk",
3
- "version": "0.6.0",
3
+ "version": "0.7.0",
4
4
  "description": "Build, test, and deploy agents as code on Cursor's agent harness.",
5
5
  "license": "SEE LICENSE IN LICENSE.md",
6
6
  "repository": {
@@ -25,10 +25,12 @@
25
25
  "!dist/internal/managed-delivery.*",
26
26
  "!dist/internal/factory-registration.*",
27
27
  "!dist/internal/testing/factory-resource-fixtures.*",
28
+ "!dist/internal/testing/teams-test-harness.*",
28
29
  "!dist/internal/hosted/**",
29
30
  "!dist/internal/tenant-mcp/**",
30
31
  "!dist/internal/tenant-slack/**",
31
32
  "!dist/internal/review-comments*",
33
+ "!dist/internal/review-discussion.*",
32
34
  "skills/**/*",
33
35
  "templates/**/*",
34
36
  "!templates/pr-autofixer/README.md",
@@ -45,230 +47,198 @@
45
47
  ],
46
48
  "exports": {
47
49
  ".": {
48
- "anysphere-source": "./src/index.ts",
49
50
  "types": "./dist/index.d.ts",
50
51
  "import": "./dist/index.js",
51
52
  "default": "./dist/index.js"
52
53
  },
53
- "./internal/hosted": {
54
- "anysphere-source": "./src/internal/hosted/index.ts",
55
- "types": "./src/internal/hosted/index.ts",
56
- "default": null
57
- },
58
- "./cli": {
59
- "anysphere-source": "./src/bin/agent-serve.ts",
60
- "default": null
61
- },
62
54
  "./tools": {
63
- "anysphere-source": "./src/tools.ts",
64
55
  "types": "./dist/tools.d.ts",
65
56
  "import": "./dist/tools.js",
66
57
  "default": "./dist/tools.js"
67
58
  },
68
59
  "./channels": {
69
- "anysphere-source": "./src/channels.ts",
70
60
  "types": "./dist/channels.d.ts",
71
61
  "import": "./dist/channels.js",
72
62
  "default": "./dist/channels.js"
73
63
  },
74
64
  "./channels/slack": {
75
- "anysphere-source": "./src/channels/slack/index.ts",
76
65
  "types": "./dist/channels/slack/index.d.ts",
77
66
  "import": "./dist/channels/slack/index.js",
78
67
  "default": "./dist/channels/slack/index.js"
79
68
  },
69
+ "./channels/teams": {
70
+ "bun": "./dist/channels/teams/index.js",
71
+ "types": "./dist/channels/teams/index.d.ts",
72
+ "import": "./dist/channels/teams/index.js",
73
+ "default": "./dist/channels/teams/index.js"
74
+ },
80
75
  "./channels/github": {
81
- "anysphere-source": "./src/channels/github/index.ts",
82
76
  "types": "./dist/channels/github/index.d.ts",
83
77
  "import": "./dist/channels/github/index.js",
84
78
  "default": "./dist/channels/github/index.js"
85
79
  },
86
80
  "./channels/origin": {
87
- "anysphere-source": "./src/channels/origin/index.ts",
88
81
  "types": "./dist/channels/origin/index.d.ts",
89
82
  "import": "./dist/channels/origin/index.js",
90
83
  "default": "./dist/channels/origin/index.js"
91
84
  },
92
85
  "./channels/gitlab": {
93
- "anysphere-source": "./src/channels/gitlab/index.ts",
94
86
  "types": "./dist/channels/gitlab/index.d.ts",
95
87
  "import": "./dist/channels/gitlab/index.js",
96
88
  "default": "./dist/channels/gitlab/index.js"
97
89
  },
98
90
  "./channels/change-monitors": {
99
- "anysphere-source": "./src/channels/change-monitors/index.ts",
100
91
  "types": "./dist/channels/change-monitors/index.d.ts",
101
92
  "import": "./dist/channels/change-monitors/index.js",
102
93
  "default": "./dist/channels/change-monitors/index.js"
103
94
  },
104
95
  "./channels/issues": {
105
- "anysphere-source": "./src/channels/issues/index.ts",
106
96
  "types": "./dist/channels/issues/index.d.ts",
107
97
  "import": "./dist/channels/issues/index.js",
108
98
  "default": "./dist/channels/issues/index.js"
109
99
  },
110
100
  "./channels/runs": {
111
- "anysphere-source": "./src/channels/runs/index.ts",
112
101
  "bun": "./dist/channels/runs/index.js",
113
102
  "types": "./dist/channels/runs/index.d.ts",
114
103
  "import": "./dist/channels/runs/index.js",
115
104
  "default": "./dist/channels/runs/index.js"
116
105
  },
117
106
  "./channels/match-ready": {
118
- "anysphere-source": "./src/channels/match-ready/index.ts",
119
107
  "bun": "./dist/channels/match-ready/index.js",
120
108
  "types": "./dist/channels/match-ready/index.d.ts",
121
109
  "import": "./dist/channels/match-ready/index.js",
122
110
  "default": "./dist/channels/match-ready/index.js"
123
111
  },
124
112
  "./channels/bitbucket": {
125
- "anysphere-source": "./src/channels/bitbucket/index.ts",
126
113
  "types": "./dist/channels/bitbucket/index.d.ts",
127
114
  "import": "./dist/channels/bitbucket/index.js",
128
115
  "default": "./dist/channels/bitbucket/index.js"
129
116
  },
130
117
  "./channels/pagerduty": {
131
- "anysphere-source": "./src/channels/pagerduty/index.ts",
132
118
  "bun": "./dist/channels/pagerduty/index.js",
133
119
  "types": "./dist/channels/pagerduty/index.d.ts",
134
120
  "import": "./dist/channels/pagerduty/index.js",
135
121
  "default": "./dist/channels/pagerduty/index.js"
136
122
  },
137
123
  "./channels/deployments": {
138
- "anysphere-source": "./src/channels/deployments/index.ts",
139
124
  "types": "./dist/channels/deployments/index.d.ts",
140
125
  "import": "./dist/channels/deployments/index.js",
141
126
  "default": "./dist/channels/deployments/index.js"
142
127
  },
143
128
  "./skills": {
144
- "anysphere-source": "./src/skills.ts",
145
129
  "types": "./dist/skills.d.ts",
146
130
  "import": "./dist/skills.js",
147
131
  "default": "./dist/skills.js"
148
132
  },
149
133
  "./extensions": {
150
- "anysphere-source": "./src/extensions.ts",
151
134
  "bun": "./dist/extensions.js",
152
135
  "types": "./dist/extensions.d.ts",
153
136
  "import": "./dist/extensions.js",
154
137
  "default": "./dist/extensions.js"
155
138
  },
156
139
  "./extensions/cursor-cloud-agents": {
157
- "anysphere-source": "./src/extensions/cursor-cloud-agents/extension.ts",
158
140
  "bun": "./dist/extensions/cursor-cloud-agents/extension.js",
159
141
  "types": "./dist/extensions/cursor-cloud-agents/extension.d.ts",
160
142
  "import": "./dist/extensions/cursor-cloud-agents/extension.js",
161
143
  "default": "./dist/extensions/cursor-cloud-agents/extension.js"
162
144
  },
163
145
  "./extensions/improve": {
164
- "anysphere-source": "./src/extensions/improve/extension.ts",
165
146
  "bun": "./dist/extensions/improve/extension.js",
166
147
  "types": "./dist/extensions/improve/extension.d.ts",
167
148
  "import": "./dist/extensions/improve/extension.js",
168
149
  "default": "./dist/extensions/improve/extension.js"
169
150
  },
170
151
  "./extensions/jev": {
171
- "anysphere-source": "./src/extensions/jev/extension.ts",
172
152
  "bun": "./dist/extensions/jev/extension.js",
173
153
  "types": "./dist/extensions/jev/extension.d.ts",
174
154
  "import": "./dist/extensions/jev/extension.js",
175
155
  "default": "./dist/extensions/jev/extension.js"
176
156
  },
177
157
  "./extensions/slack-communication": {
178
- "anysphere-source": "./src/extensions/slack-communication/extension.ts",
179
158
  "bun": "./dist/extensions/slack-communication/extension.js",
180
159
  "types": "./dist/extensions/slack-communication/extension.d.ts",
181
160
  "import": "./dist/extensions/slack-communication/extension.js",
182
161
  "default": "./dist/extensions/slack-communication/extension.js"
183
162
  },
184
163
  "./schedules": {
185
- "anysphere-source": "./src/schedules.ts",
186
164
  "types": "./dist/schedules.d.ts",
187
165
  "import": "./dist/schedules.js",
188
166
  "default": "./dist/schedules.js"
189
167
  },
190
168
  "./scm": {
191
- "anysphere-source": "./src/scm.ts",
192
169
  "types": "./dist/scm.d.ts",
193
170
  "import": "./dist/scm.js",
194
171
  "default": "./dist/scm.js"
195
172
  },
196
173
  "./reminders": {
197
- "anysphere-source": "./src/reminders.ts",
198
174
  "types": "./dist/reminders.d.ts",
199
175
  "import": "./dist/reminders.js",
200
176
  "default": "./dist/reminders.js"
201
177
  },
202
178
  "./connections": {
203
- "anysphere-source": "./src/connections.ts",
204
179
  "types": "./dist/connections.d.ts",
205
180
  "import": "./dist/connections.js",
206
181
  "default": "./dist/connections.js"
207
182
  },
208
183
  "./hooks": {
209
- "anysphere-source": "./src/hooks.ts",
210
184
  "types": "./dist/hooks.d.ts",
211
185
  "import": "./dist/hooks.js",
212
186
  "default": "./dist/hooks.js"
213
187
  },
214
188
  "./memory": {
215
- "anysphere-source": "./src/memory.ts",
216
189
  "types": "./dist/memory.d.ts",
217
190
  "import": "./dist/memory.js",
218
191
  "default": "./dist/memory.js"
219
192
  },
220
193
  "./prompt": {
221
- "anysphere-source": "./src/prompt.ts",
222
194
  "types": "./dist/prompt.d.ts",
223
195
  "import": "./dist/prompt.js",
224
196
  "default": "./dist/prompt.js"
225
197
  },
226
198
  "./evals": {
227
- "anysphere-source": "./src/evals.ts",
228
199
  "types": "./dist/evals.d.ts",
229
200
  "import": "./dist/evals.js",
230
201
  "default": "./dist/evals.js"
231
202
  },
232
203
  "./evals/reporters": {
233
- "anysphere-source": "./src/evals/reporters.ts",
234
204
  "types": "./dist/evals/reporters.d.ts",
235
205
  "import": "./dist/evals/reporters.js",
236
206
  "default": "./dist/evals/reporters.js"
237
207
  },
238
208
  "./evals/loaders": {
239
- "anysphere-source": "./src/evals/loaders.ts",
240
209
  "types": "./dist/evals/loaders.d.ts",
241
210
  "import": "./dist/evals/loaders.js",
242
211
  "default": "./dist/evals/loaders.js"
243
212
  },
244
213
  "./artifacts": {
245
- "anysphere-source": "./src/artifacts.ts",
246
214
  "types": "./dist/artifacts.d.ts",
247
215
  "import": "./dist/artifacts.js",
248
216
  "default": "./dist/artifacts.js"
249
217
  },
250
218
  "./kv": {
251
- "anysphere-source": "./src/kv.ts",
252
219
  "bun": "./dist/kv.js",
253
220
  "types": "./dist/kv.d.ts",
254
221
  "import": "./dist/kv.js",
255
222
  "default": "./dist/kv.js"
256
223
  },
257
224
  "./otel": {
258
- "anysphere-source": "./src/otel-public.ts",
259
225
  "types": "./dist/otel-public.d.ts",
260
226
  "import": "./dist/otel-public.js",
261
227
  "default": "./dist/otel-public.js"
262
228
  },
229
+ "./teams-app-package": {
230
+ "bun": "./dist/teams-app-package.js",
231
+ "types": "./dist/teams-app-package.d.ts",
232
+ "import": "./dist/teams-app-package.js",
233
+ "default": "./dist/teams-app-package.js"
234
+ },
263
235
  "./telemetry": {
264
- "anysphere-source": "./src/telemetry.ts",
265
236
  "bun": "./dist/telemetry.js",
266
237
  "types": "./dist/telemetry.d.ts",
267
238
  "import": "./dist/telemetry.js",
268
239
  "default": "./dist/telemetry.js"
269
240
  },
270
241
  "./package.json": {
271
- "anysphere-source": "./package.json",
272
242
  "bun": "./package.json",
273
243
  "types": "./package.json",
274
244
  "import": "./package.json",
@@ -280,7 +250,7 @@
280
250
  },
281
251
  "dependencies": {
282
252
  "@bazel/runfiles": "6.5.0",
283
- "@cursor/sdk": "1.3.0",
253
+ "@cursor/sdk": "1.4.2",
284
254
  "@modelcontextprotocol/sdk": "^1.32.1",
285
255
  "@octokit/auth-app": "^7.2.0",
286
256
  "@octokit/rest": "^21.1.1",
@@ -304,6 +274,7 @@
304
274
  "@slack/web-api": "^7.18.0",
305
275
  "croner": "^8.0.1",
306
276
  "esbuild": "^0.25.0",
277
+ "fflate": "0.8.3",
307
278
  "javascript-time-ago": "^2.6.4",
308
279
  "js-yaml": "4.3.2",
309
280
  "minimatch": "^10.2.5",
@@ -319,6 +290,8 @@
319
290
  },
320
291
  "devDependencies": {
321
292
  "@anysphere/agent-store-sync": "1.0.0",
293
+ "@anysphere/context": "1.0.0",
294
+ "@anysphere/mcp-agent-exec": "1.0.0",
322
295
  "@anysphere/ui": "1.0.0",
323
296
  "@braintree/sanitize-url": "7.1.2",
324
297
  "@microsoft/api-extractor": "7.59.4",
@@ -334,6 +307,8 @@
334
307
  "@types/react-dom": "19.3.0",
335
308
  "@typescript/native": "npm:typescript@^7.0.2",
336
309
  "@vitejs/plugin-react": "6.1.2",
310
+ "ajv": "8.20.0",
311
+ "ajv-draft-04": "1.0.0",
337
312
  "cytoscape": "3.33.3",
338
313
  "cytoscape-cose-bilkent": "4.1.0",
339
314
  "dayjs": "1.11.20",
@@ -2,8 +2,9 @@
2
2
  name: agent-sdk-create-agent
3
3
  description: >-
4
4
  Scaffold a new Agent SDK agent: short AskQuestion interview, then
5
- verify a turn and hand off to hillclimb. Use when creating a new
6
- agent. Ask only what the invoking message left open.
5
+ verify a turn and hand off to hillclimb. Use to build or create a
6
+ new bot or agent with the agent-sdk, the Agent SDK, `@grok/agent-sdk`,
7
+ or BDK. Ask only what the invoking message left open.
7
8
  ---
8
9
 
9
10
  # Create an Agent SDK agent
@@ -22,6 +23,14 @@ Read `skills/framework-map/SKILL.md` if you have not. CLI is
22
23
  `node_modules/@grok/agent-sdk/dist/docs/llms.txt` or `/docs/llms.txt`
23
24
  on a running host.
24
25
 
26
+ If a linked skill is not available, read its docs page instead:
27
+
28
+ - `agent-sdk-framework-map`: https://cursor.com/docs/agent-sdk/reference/project-layout
29
+ - `agent-sdk-hillclimb`: https://cursor.com/docs/agent-sdk/hillclimbing
30
+ - `agent-sdk-evals`: https://cursor.com/docs/agent-sdk/evals
31
+ - `agent-sdk-setup-slack`: https://cursor.com/docs/agent-sdk/guides/slack
32
+ - `agent-sdk-github`: https://cursor.com/docs/agent-sdk/guides/github
33
+
25
34
  ## Interview
26
35
 
27
36
  `AskQuestion`: batched, recommended option first and labeled
@@ -50,7 +59,7 @@ on a running host.
50
59
  | Question | Options | Guidance |
51
60
  | --- | --- | --- |
52
61
  | **Model** | `grok-4.7` + `reasoning_effort=high`, `fast=true` · Other id | Params, not id suffixes: `{ id: "grok-4.7", params: [{ id: "reasoning_effort", value: "high" }, { id: "fast", value: "true" }] }` |
53
- | **Channels** (multi) | playground + HTTP (always on) · Slack · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord/Teams pack; offer custom webhook. |
62
+ | **Channels** (multi) | playground + HTTP (always on) · Slack · Microsoft Teams · GitHub · custom webhook · schedule | Slack: `skills/setup-slack/SKILL.md`. Teams: `skills/setup-teams/SKILL.md`. GitHub: `skills/github/SKILL.md`. No Discord pack; offer custom webhook. |
54
63
  | **MCP** (multi) | none · remote URL · local stdio · Cursor account connectors · Other | One file under `bot/mcp-connections/`. Account file is `account.ts`, never `cursor.ts`. Named local tools need `advertiseTools: true`. Privileged servers go in `bot/host-connections/`. |
55
64
  | **Capabilities** (multi) | server tools · agent tools · skills · subagents · hooks · sandbox seeds · evals (recommend) | Always recommend one smoke eval. |
56
65
  <!-- interview:end -->
@@ -67,6 +76,7 @@ something". Write files only after approval.
67
76
  | Purpose | Shape |
68
77
  | --- | --- |
69
78
  | Slack chat | `slackChannel({ envPrefix })` + suggested prompts. `agent-sdk slack create` mints the bot. Prefix: `skills/setup-slack/SKILL.md` |
79
+ | Teams chat | `teamsChannel()`, or `teamsChannel({ envPrefix })` for one bot per agent. `agent-sdk channels teams init` writes it for the user's Azure Bot. Setup: `skills/setup-teams/SKILL.md` |
70
80
  | PR review with host prep | Channel `callTool` into a trimmed workspace `pr/` tree |
71
81
  | GitHub automation | `githubChannel()` hooks, replay fixtures |
72
82
  | Domain assistant | Server tools + one MCP connection + a skill |
@@ -125,7 +135,9 @@ agent-sdk init ./<slug>
125
135
  Slack: `agent-sdk slack create --dir ./<slug> --name "<Name>"`,
126
136
  not a hand-written channel. Manual Slack app:
127
137
  `agent-sdk slack init --manual` (Slack CLI, or paste at
128
- api.slack.com).
138
+ api.slack.com). Teams: `agent-sdk channels teams init --dir ./<slug>
139
+ --app-id <id> --tenant-id <id>` with the client secret on stdin,
140
+ not a hand-written channel.
129
141
  4. Blank init writes `evals/evals.config.ts` (`maxConcurrency: 20`,
130
142
  cap 200) and `evals/smoke.eval.ts`. The smoke case uses `echo`
131
143
  and asserts `t.succeeded()` and `t.calledTool("echo")`. Replace
@@ -176,6 +188,7 @@ the hand-over commands above in "Test it locally".
176
188
  ## Channel setup
177
189
 
178
190
  - **Slack.** `skills/setup-slack/SKILL.md`
191
+ - **Microsoft Teams.** `skills/setup-teams/SKILL.md`
179
192
  - **GitHub.** `skills/github/SKILL.md`
180
193
  - **Custom webhook.** `POST /v1/channels/<id>/<route>`.
181
194
  Loopback-only until you add `bearerAuth(...)`. Hosted callers
@@ -33,6 +33,7 @@ Local `agent-sdk serve`. Hosted start failures:
33
33
  | `403` on stream | Wrong principal. Same auth as create; beyond loopback send `--bearer-token`. |
34
34
  | Works on loopback, blocked via tunnel | `localDevStrict()` rejects forwarded headers. Use `--bearer-token`. Never `--allow-anonymous` with account MCP. |
35
35
  | Slack `channel idle … missing credentials` | Expected. `slack doctor --prefix <PREFIX>`. |
36
+ | Teams bot silent | `channels teams doctor --dir . --endpoint <URL dev printed>`. It names the failing part: env names, token, Azure Bot endpoint, Teams channel, or path. The cloudflared URL changes on every `dev` start; `--tunnel devtunnel` keeps one. `warning: Teams tunnel:` means the tunnel binary is missing or exited. |
36
37
  | Immediate API-key error | Model turns need a Cursor credential (`CURSOR_API_KEY`, then `CURSOR_API_KEY_FILE`, then `CURSOR_SERVICE_ACCOUNT_KEY`, then `agent-sdk login`). |
37
38
  | `validate` clean, CI typecheck fails | tsx skipped types. JSON-shaped returns; `type` not `interface`. |
38
39
  | `validate`: `architecture "v2" requires a named secret` | Getter or literal SCM credential. Use the quoted `{ secretName: "NAME" }`; `secrets set <slug> NAME` after deploy. |
@@ -39,7 +39,7 @@ the value. Do not run `agent-sdk login`.
39
39
  On Linux and macOS, run every Agent SDK command through this wrapper:
40
40
 
41
41
  ```bash
42
- BDK_VERSION="0.6.0"
42
+ BDK_VERSION="0.7.0"
43
43
  BDK_PACKAGE="@grok/agent-sdk"
44
44
  case "$BDK_VERSION" in
45
45
  __BDK_V*)
@@ -123,6 +123,7 @@ only this agent's directory.
123
123
  | OpenTelemetry | `skills/otel/SKILL.md` |
124
124
  | GitHub | `skills/github/SKILL.md` |
125
125
  | Slack | `skills/setup-slack/SKILL.md` |
126
+ | Microsoft Teams | `skills/setup-teams/SKILL.md` |
126
127
  | Host MCP OAuth | `skills/mcp-auth/SKILL.md` |
127
128
  | Managed deployment | `skills/deploy/SKILL.md` |
128
129
  | Local triage | `skills/debug/SKILL.md` |
@@ -0,0 +1,141 @@
1
+ ---
2
+ name: agent-sdk-setup-teams
3
+ description: >-
4
+ Wire Microsoft Teams to an Agent SDK agent with an Azure Bot the user
5
+ owns. Write its credentials with channels teams init, build the app
6
+ zip with channels teams package, run dev for a tunnel, then check
7
+ every part with channels teams doctor. Use when adding Teams.
8
+ ---
9
+
10
+ # Setup Microsoft Teams for the Agent SDK
11
+
12
+ The user brings an Azure Bot: its Microsoft App ID, a client secret,
13
+ and the App Tenant ID. Cursor does not create the bot. Never print the
14
+ client secret, and never pass it on argv.
15
+
16
+ Teams has no Socket Mode. Azure posts each activity to a public HTTPS
17
+ messaging endpoint, so local dev needs a tunnel. `agent-sdk dev` opens
18
+ a cloudflared quick tunnel and prints that endpoint. `cloudflared` must
19
+ be on PATH. `--tunnel devtunnel` uses a Microsoft dev tunnel instead,
20
+ which keeps one URL across restarts.
21
+
22
+ Guide: `docs/guides/teams.md`.
23
+
24
+ ## 1. Azure Bot (human)
25
+
26
+ `agent-sdk channels teams setup` prints these steps. Stop and ask the user to:
27
+
28
+ 1. Create an **Azure Bot** in the Azure portal. Type of App: **Single
29
+ Tenant**. Creation type: **Create new Microsoft App ID**.
30
+ 2. On **Configuration**, copy the **Microsoft App ID** and the **App
31
+ Tenant ID**.
32
+ 3. **Manage Password** → **New client secret**. Copy the secret value.
33
+ 4. **Channels** → **Microsoft Teams** → **Apply**.
34
+
35
+ ## 2. Credentials
36
+
37
+ ```bash
38
+ printf %s "$CLIENT_SECRET" | agent-sdk channels teams init --dir . \
39
+ --app-id <microsoft-app-id> --tenant-id <app-tenant-id>
40
+ ```
41
+
42
+ On a terminal, drop the pipe, and the user types the secret at the hidden
43
+ prompt. `init` checks that both ids are GUIDs, writes
44
+ `bot/channels/teams.ts` when it is missing, and writes
45
+ `TEAMS_APP_ID`, `TEAMS_APP_PASSWORD`, and `TEAMS_TENANT_ID` to
46
+ `.env.local` (mode 600, gitignored).
47
+
48
+ For one Azure Bot per agent in a multi-agent serve, pass
49
+ `--prefix JENNY`. `init` then writes `envPrefix: "JENNY"` into the new
50
+ channel file and the `JENNY_TEAMS_*` names. The prefix must start with a
51
+ letter. When `bot/channels/teams.ts` exists, `init` keeps it and writes
52
+ the names it reads; a `--prefix` that disagrees stops with an error.
53
+ Rerun `init` to rotate the secret. `--dry-run` reads no secret and
54
+ writes nothing.
55
+
56
+ ## 3. App package (human uploads)
57
+
58
+ ```bash
59
+ agent-sdk channels teams package --dir .
60
+ ```
61
+
62
+ It writes `<slug>-teams-app.zip` (`manifest.json`, a color icon, and
63
+ an outline icon) and adds `*-teams-app.zip` to `.gitignore`.
64
+ `--out <file>` writes it elsewhere. The manifest names the bot by its
65
+ app id and lists the scopes the channel answers in. With
66
+ `engagement.channelPosts`, it also asks for `ChannelMessage.Read.Group`
67
+ consent. `--name` sets the app name. `--icon` takes a 192 by 192 PNG.
68
+ `--app-version` sets the version. The default grows with the time, so
69
+ a new zip updates the app. After a custom `--app-version` such as
70
+ `2.0.0`, the default is lower and Teams refuses the update, so keep
71
+ passing a higher version.
72
+
73
+ Ask the user to upload the zip in Teams: **Apps** → **Manage your
74
+ apps** → **Upload an app**. A Teams admin can publish it to the
75
+ organization from the Teams admin center instead. To update the app,
76
+ build a new zip and upload it the same way.
77
+
78
+ ## 4. Serve
79
+
80
+ ```bash
81
+ agent-sdk dev .
82
+ ```
83
+
84
+ `dev` prints `Teams messaging endpoint:` and a URL such as
85
+ `https://<random>.trycloudflare.com/jenny/v1/channels/teams`. Ask the
86
+ user to set it on the Azure Bot: **Configuration** → **Messaging
87
+ endpoint** → **Apply**. The cloudflared URL changes each time `dev`
88
+ starts, so set it again after a restart.
89
+
90
+ To set it once, use a dev tunnel. The user must run `devtunnel user
91
+ login` first.
92
+
93
+ ```bash
94
+ agent-sdk dev . --tunnel devtunnel
95
+ ```
96
+
97
+ The first start creates the tunnel and saves `TEAMS_DEVTUNNEL_ID` in
98
+ `.env.local`. Later starts print the same URL. Microsoft deletes a dev
99
+ tunnel after 30 days without use, and the next start creates it again
100
+ under the same id. The tunnel owns port 3978, so run the agent on
101
+ another `--port`. The tunnel stops when it publishes any other port;
102
+ remove that port with `devtunnel port delete <id> -p <port>`.
103
+
104
+ Next to a plain `agent-sdk serve`, `agent-sdk channels teams forward --dir .`
105
+ opens the same tunnel and takes the same `--tunnel` flags. The tunnel
106
+ forwards only `POST` to the Teams messaging paths. Every other path on
107
+ it is a 404, so sessions, tools, MCP, and evals stay local.
108
+
109
+ ## 5. Doctor
110
+
111
+ ```bash
112
+ agent-sdk channels teams doctor --dir . --endpoint <printed URL>
113
+ ```
114
+
115
+ `doctor` reads the env names the loaded channel declares. Green is `env`, `token`, `bot-tenant`, `bot-endpoint`,
116
+ `teams-channel`, and `endpoint`.
117
+
118
+ - `token`: Entra issued a Bot Framework token, so the app id, secret,
119
+ and tenant match.
120
+ - `bot-tenant`: the Azure Bot is Single Tenant, in the tenant the
121
+ channel's tenant id variable holds. Any other bot type fails.
122
+ - `endpoint`: the URL's path names this channel, and an unsigned `POST`
123
+ got `401`: `invalid_token` from the channel, or `Unauthorized` from
124
+ Cursor-managed hosting. `503 teams_not_configured` means the server
125
+ lacks the secrets. `404` or a path for another channel means a wrong
126
+ URL.
127
+ - A channel that sets `credentials` in code has no env names to read:
128
+ doctor prints `env: set in code` and skips `env`, `token`, and the Azure
129
+ checks; `package` and `init` stop with an error.
130
+ - `bot-tenant`, `bot-endpoint`, and `teams-channel` need a logged-in
131
+ Azure CLI (`az login`). Without it they are skipped (`--`), not
132
+ passed. When no Azure Bot in the subscription has the app id, they
133
+ fail.
134
+
135
+ ## 6. Smoke test (human)
136
+
137
+ 1. **Channels** → **Microsoft Teams** → **Open in Teams** starts a 1:1
138
+ chat.
139
+ 2. For channels and group chats, add the uploaded app to the team or
140
+ chat.
141
+ 3. `@mention` the bot or send it a message.
@@ -144,6 +144,7 @@ function parseGlobalExclusions({
144
144
  }
145
145
 
146
146
  const GLOBAL_OVERRIDE_KEYS = [
147
+ "name",
147
148
  "paths",
148
149
  "team",
149
150
  "teams",
@@ -1,10 +0,0 @@
1
- /**
2
- * FIFO-capped event_id dedupe for Slack Events API / Socket Mode.
3
- * One instance per channel mount — not process-global.
4
- */
5
- export interface EventIdDedupe {
6
- /** Returns true the first time an id is seen; false if already seen. */
7
- tryHandle(eventId: string): boolean;
8
- }
9
- export declare function createEventIdDedupe(cap?: number): EventIdDedupe;
10
- //# sourceMappingURL=event-id-dedupe.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"event-id-dedupe.d.ts","sourceRoot":"","sources":["../../../src/channels/slack/event-id-dedupe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAoB,GAAG,aAAa,CAiB5E"}
@@ -1 +0,0 @@
1
- import{_ as o,c as a,o as t,a3 as s}from"./chunks/framework.BNw1pucY.js";const g=JSON.parse('{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases.","frontmatter":{"title":"Changelog","description":"Changelog for @grok/agent-sdk releases."},"headers":[],"relativePath":"changelog.md","filePath":"changelog.md"}'),i={name:"changelog.md"};function n(l,e,r,c,d,h){return t(),a("div",null,[...e[0]||(e[0]=[s('<h1 id="changelog" tabindex="-1">Changelog <a class="header-anchor" href="#changelog" aria-label="Permalink to &quot;Changelog&quot;">​</a></h1><h2 id="_0-6-0-2026-11-03" tabindex="-1">0.6.0 (2026-11-03) <a class="header-anchor" href="#_0-6-0-2026-11-03" aria-label="Permalink to &quot;0.6.0 (2026-11-03)&quot;">​</a></h2><h3 id="minimum-versions" tabindex="-1">Minimum versions <a class="header-anchor" href="#minimum-versions" aria-label="Permalink to &quot;Minimum versions&quot;">​</a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.3.0.</li></ul><h3 id="behavior-changes" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li>On Cursor-managed hosting, when the team turns on its Cloud Agent Allowlist, a turn checks the <code>url:</code> and <code>command:</code> connections it opens against that list. It also checks their network hosts against the team&#39;s network allowlist for Cloud Agents. Before, it used the team&#39;s MCP Allowlist. Agents that you run with <code>agent-sdk serve</code> keep the MCP Allowlist.</li><li>On Cursor-managed hosting, when the team turns on its Cloud Agent Allowlist, the Cursor backend checks each <code>cursorAccount</code> connection against that list. The turn&#39;s local MCP checks no longer refuse these connections.</li><li>An agent with <code>cursorAccount</code> connections starts its shared workspace after those connections resolve. Other agents still start it when the server starts.</li></ul><h2 id="_0-5-0-2026-10-28" tabindex="-1">0.5.0 (2026-10-28) <a class="header-anchor" href="#_0-5-0-2026-10-28" aria-label="Permalink to &quot;0.5.0 (2026-10-28)&quot;">​</a></h2><h3 id="breaking-changes" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>No change to which file tools an <code>fs</code> agent has or what they do. Their results now use Cursor&#39;s native tool-call shape instead of Agent SDK&#39;s earlier MCP-style text, in <code>tool_call</code> events, transcripts, and direct tool calls. The same holds without <code>fs</code>. Update code that parses these results. For example, a direct <code>read</code> call returns <code>{ status: &quot;success&quot;, value: { content } }</code> instead of numbered lines.</li><li>With <code>fs</code>, a <code>tools</code> list gets only the file tools it names. Add <code>&quot;read&quot;</code>, <code>&quot;ls&quot;</code>, <code>&quot;glob&quot;</code>, <code>&quot;grep&quot;</code>, <code>&quot;edit&quot;</code>, and <code>&quot;delete&quot;</code> to keep them.</li><li><code>@grok/agent-sdk/executors</code> is removed. Remove that import. The npm package has no replacement.</li><li><code>synthesizeFileSystemTools</code> is removed. Pass your tree as <code>fs</code>.</li><li><code>nearestNeighborMissHint</code> is removed. Read suggests nearby names when a file is missing.</li><li><code>RunnerTurnRequest</code> carries <code>fs</code>, <code>reportedWorkspacePath</code>, and <code>settingSources</code> instead of <code>root</code> and <code>subagentInherit</code>.</li></ul><h3 id="minimum-versions-1" tabindex="-1">Minimum versions <a class="header-anchor" href="#minimum-versions-1" aria-label="Permalink to &quot;Minimum versions&quot;">​</a></h3><ul><li><code>@grok/agent-sdk</code> requires <code>@cursor/sdk</code> 1.2.0.</li></ul><h3 id="behavior-changes-1" tabindex="-1">Behavior changes <a class="header-anchor" href="#behavior-changes-1" aria-label="Permalink to &quot;Behavior changes&quot;">​</a></h3><ul><li>With <code>fs</code>, <code>AGENTS.md</code> and <code>.cursor/rules/</code> in the workspace load as project rules, as they do on the host. Don&#39;t make a checkout you don&#39;t trust the workspace.</li><li>With <code>fs</code>, omitting <code>tools</code> gives every tool the tree can back, including subagents, web search, web fetch, todos, and MCP.</li><li>With <code>fs</code>, a <code>tools</code> list that names a tool the tree can&#39;t run, such as <code>readLints</code>, leaves it out with a warning. Before, <code>readLints</code> with <code>fs</code> failed validation.</li><li>With <code>fs</code>, LS, Grep, and Glob search the workspace when a call names no path.</li><li>With <code>fs</code>, each turn gets an empty <code>/tmp</code>. Large web results are written there.</li><li>With <code>fs</code>, subagents work on the agent&#39;s tree, and their writes land in it as the agent&#39;s own do. Before, each subagent wrote to its own copy.</li><li><code>local.sandbox</code> works with <code>fs</code>. A tool call that needs approval, such as an external MCP call, fails closed. File access doesn&#39;t change.</li><li>With <code>local.sandbox</code> and no <code>fs</code>, an agent with shell in <code>tools</code>, or with <code>tools</code> omitted, can read outside the session workspace with the file tools, as its shell already could. Writes and deletes outside it are still refused.</li><li>With <code>local.sandbox</code> and no <code>fs</code>, an agent whose <code>tools</code> list file tools and no shell runs on its session workspace, mounted at <code>/workspace</code>, and its reads stay inside it. Cursor hooks don&#39;t run for it, so a Slack follow-up waits for the turn to end. <code>.cursor/mcp.json</code> from its working directory isn&#39;t loaded, host git status doesn&#39;t reach the model, and its skills are at <code>/agent/skills</code>.</li><li>An agent tool can be named <code>Read</code>, <code>Grep</code>, or another file tool&#39;s name.</li></ul><h3 id="new" tabindex="-1">New <a class="header-anchor" href="#new" aria-label="Permalink to &quot;New&quot;">​</a></h3><ul><li><code>workspace</code> sets the folder inside <code>fs</code> that the agent works in. For a sandboxed agent without shell, it sets where the session workspace is mounted.</li></ul><h3 id="fixes" tabindex="-1">Fixes <a class="header-anchor" href="#fixes" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>An agent that exports OpenTelemetry traces no longer logs a duplicate propagator registration error on its first HTTP request.</li></ul><h2 id="_0-4-0-2026-10-27" tabindex="-1">0.4.0 (2026-10-27) <a class="header-anchor" href="#_0-4-0-2026-10-27" aria-label="Permalink to &quot;0.4.0 (2026-10-27)&quot;">​</a></h2><h3 id="breaking-changes-1" tabindex="-1">Breaking changes <a class="header-anchor" href="#breaking-changes-1" aria-label="Permalink to &quot;Breaking changes&quot;">​</a></h3><ul><li>The <code>FileSystem</code> type, its helpers, and its errors match the file tools, and the package root exports <code>readOnlyFs</code>.</li></ul><h3 id="fixes-1" tabindex="-1">Fixes <a class="header-anchor" href="#fixes-1" aria-label="Permalink to &quot;Fixes&quot;">​</a></h3><ul><li>A reply in a Slack thread that a schedule started continues that session.</li><li>A hosted Slack agent with <code>botMentions.allowFrom</code> starts a session when an allowed bot mentions it.</li></ul><h2 id="_0-3-0-2026-10-25" tabindex="-1">0.3.0 (2026-10-25) <a class="header-anchor" href="#_0-3-0-2026-10-25" aria-label="Permalink to &quot;0.3.0 (2026-10-25)&quot;">​</a></h2><ul><li>GA Release</li><li><code>persistent</code> option is removed from <code>defineAgent</code></li></ul><h2 id="_0-2-29-2026-10-23" tabindex="-1">0.2.29 (2026-10-23) <a class="header-anchor" href="#_0-2-29-2026-10-23" aria-label="Permalink to &quot;0.2.29 (2026-10-23)&quot;">​</a></h2><ul><li>Bug Fixes</li></ul>',26)])])}const m=o(i,[["render",n]]);export{g as __pageData,m as default};