@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
@@ -1,4 +1,4 @@
1
- import{_ as s,c as t,o as a,a3 as i}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives.","frontmatter":{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives."},"headers":[],"relativePath":"reference/sessions.md","filePath":"reference/sessions.md"}'),n={name:"reference/sessions.md"};function d(o,e,r,l,h,c){return a(),t("div",null,[...e[0]||(e[0]=[i(`<h1 id="sessions-events-and-streaming" tabindex="-1">Sessions, events, and streaming <a class="header-anchor" href="#sessions-events-and-streaming" aria-label="Permalink to &quot;Sessions, events, and streaming&quot;">​</a></h1><p>A session keeps one conversation, its workspace, and an append-only record of every message and tool call.</p><h2 id="session-contents" tabindex="-1">Session contents <a class="header-anchor" href="#session-contents" aria-label="Permalink to &quot;Session contents&quot;">​</a></h2><p>Each session also has a channel, an authenticated caller, an NDJSON event stream, and state that survives a restart. Sessions belong to the principal that created them. Another caller gets <code>403</code> from that session&#39;s routes.</p><h2 id="session-identifiers" tabindex="-1">Session identifiers <a class="header-anchor" href="#session-identifiers" aria-label="Permalink to &quot;Session identifiers&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Identifier</th><th>Use it for</th></tr></thead><tbody><tr><td><code>continuationToken</code></td><td>Continue a conversation through its channel</td></tr><tr><td><code>sessionId</code></td><td>Stream events, inspect state, or run a session-bound tool call</td></tr></tbody></table><p>Each channel picks its token format, such as a Slack thread or <code>pr:owner/repo#1</code>. The built-in HTTP API returns an opaque token and rotates it after each accepted follow-up, so a stale HTTP token returns <code>409</code>.</p><h2 id="session-modes" tabindex="-1">Session modes <a class="header-anchor" href="#session-modes" aria-label="Permalink to &quot;Session modes&quot;">​</a></h2><p>HTTP sessions, channel <code>send</code>, Slack, and MCP <code>ask</code> create <code>chat</code> sessions, which wait in <code>session.waiting</code> for follow-ups. Markdown schedules and fire-and-forget dispatch create <code>task</code> sessions, which end in <code>session.completed</code> or <code>session.failed</code>. A follow-up to a task session returns <code>409</code>.</p><h2 id="follow-ups" tabindex="-1">Follow-ups <a class="header-anchor" href="#follow-ups" aria-label="Permalink to &quot;Follow-ups&quot;">​</a></h2><p>A follow-up starts a turn right away on an idle session. On a busy one, the channel decides what happens.</p><table tabindex="0"><thead><tr><th>Path</th><th>Busy-session policy</th></tr></thead><tbody><tr><td>HTTP playground, <code>POST /v1/session/:id</code>, MCP <code>ask</code></td><td>Preempt (the default). Interrupts the running turn, then runs the new message</td></tr><tr><td>Slack mentions, DMs, alert-watch</td><td>Coalesce. The running turn may pick up the follow-up at a tool boundary, and the rest become one turn when it finishes</td></tr></tbody></table><p>Pass <code>admission: &quot;coalesce&quot;</code> on <code>send()</code> to use the Slack policy from other callers.</p><p><code>POST /v1/session/:id/stop</code> interrupts a turn without sending a message. The stream records <code>turn.failed</code> with <code>status: &quot;cancelled&quot;</code>, and the session can take another follow-up. A Slack message that is only <code>stop</code> or <code>@agent stop</code> does the same for its thread and clears pending coalesced follow-ups.</p><h3 id="track-which-follow-up-reached-the-agent" tabindex="-1">Track which follow-up reached the agent <a class="header-anchor" href="#track-which-follow-up-reached-the-agent" aria-label="Permalink to &quot;Track which follow-up reached the agent&quot;">​</a></h3><p>Every <code>send()</code> returns a <code>deliveryId</code>. Pass your own, such as a webhook delivery ID, or omit it to get a fresh <code>dlv_…</code> ID. A coalesced follow-up reaches the agent in one of two ways.</p><table tabindex="0"><thead><tr><th>Path</th><th>Event</th><th>Field</th></tr></thead><tbody><tr><td>Steered into the running turn</td><td><code>nudge.delivered</code></td><td><code>data.deliveryId</code></td></tr><tr><td>Fell back to the next turn</td><td>That turn&#39;s <code>message.received</code></td><td><code>data.deliveryIds</code></td></tr></tbody></table><p><code>message.received</code> lists every send its prompt carries in arrival order, so one turn can carry several IDs.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// In a route or channel hook: name the steer after the webhook delivery.</span></span>
1
+ import{_ as s,c as t,o as a,a3 as n}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives.","frontmatter":{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives."},"headers":[],"relativePath":"reference/sessions.md","filePath":"reference/sessions.md"}'),i={name:"reference/sessions.md"};function d(o,e,r,l,h,c){return a(),t("div",null,[...e[0]||(e[0]=[n(`<h1 id="sessions-events-and-streaming" tabindex="-1">Sessions, events, and streaming <a class="header-anchor" href="#sessions-events-and-streaming" aria-label="Permalink to &quot;Sessions, events, and streaming&quot;">​</a></h1><p>A session keeps one conversation, its workspace, and an append-only record of every message and tool call.</p><h2 id="session-contents" tabindex="-1">Session contents <a class="header-anchor" href="#session-contents" aria-label="Permalink to &quot;Session contents&quot;">​</a></h2><p>Each session also has a channel, an authenticated caller, an NDJSON event stream, and state that survives a restart. Sessions belong to the principal that created them. Another caller gets <code>403</code> from that session&#39;s routes.</p><h2 id="session-identifiers" tabindex="-1">Session identifiers <a class="header-anchor" href="#session-identifiers" aria-label="Permalink to &quot;Session identifiers&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Identifier</th><th>Use it for</th></tr></thead><tbody><tr><td><code>continuationToken</code></td><td>Continue a conversation through its channel</td></tr><tr><td><code>sessionId</code></td><td>Stream events, inspect state, or run a session-bound tool call</td></tr></tbody></table><p>Each channel picks its token format, such as a Slack thread or <code>pr:owner/repo#1</code>. The built-in HTTP API returns an opaque token and rotates it after each accepted follow-up, so a stale HTTP token returns <code>409</code>.</p><h2 id="session-modes" tabindex="-1">Session modes <a class="header-anchor" href="#session-modes" aria-label="Permalink to &quot;Session modes&quot;">​</a></h2><p>HTTP sessions, channel <code>send</code>, Slack, and MCP <code>ask</code> create <code>chat</code> sessions, which wait in <code>session.waiting</code> for follow-ups. Markdown schedules and fire-and-forget dispatch create <code>task</code> sessions, which end in <code>session.completed</code> or <code>session.failed</code>. A follow-up to a task session returns <code>409</code>.</p><h2 id="follow-ups" tabindex="-1">Follow-ups <a class="header-anchor" href="#follow-ups" aria-label="Permalink to &quot;Follow-ups&quot;">​</a></h2><p>A follow-up starts a turn right away on an idle session. On a busy one, the channel decides what happens.</p><table tabindex="0"><thead><tr><th>Path</th><th>Busy-session policy</th></tr></thead><tbody><tr><td>HTTP playground, <code>POST /v1/session/:id</code>, MCP <code>ask</code></td><td>Preempt (the default). Interrupts the running turn, then runs the new message</td></tr><tr><td>Slack mentions, DMs, alert-watch</td><td>Coalesce. The running turn may pick up the follow-up at a tool boundary, and the rest become one turn when it finishes</td></tr></tbody></table><p>Pass <code>admission: &quot;coalesce&quot;</code> on <code>send()</code> to use the Slack policy from other callers.</p><p><code>POST /v1/session/:id/stop</code> interrupts a turn without sending a message. The stream records <code>turn.failed</code> with <code>status: &quot;cancelled&quot;</code>, and the session can take another follow-up. A Slack message that is only <code>stop</code> or <code>@agent stop</code> does the same for its thread and clears pending coalesced follow-ups.</p><h3 id="track-which-follow-up-reached-the-agent" tabindex="-1">Track which follow-up reached the agent <a class="header-anchor" href="#track-which-follow-up-reached-the-agent" aria-label="Permalink to &quot;Track which follow-up reached the agent&quot;">​</a></h3><p>Every <code>send()</code> returns a <code>deliveryId</code>. Pass your own, such as a webhook delivery ID, or omit it to get a fresh <code>dlv_…</code> ID. A coalesced follow-up reaches the agent in one of two ways.</p><table tabindex="0"><thead><tr><th>Path</th><th>Event</th><th>Field</th></tr></thead><tbody><tr><td>Steered into the running turn</td><td><code>nudge.delivered</code></td><td><code>data.deliveryId</code></td></tr><tr><td>Fell back to the next turn</td><td>That turn&#39;s <code>message.received</code></td><td><code>data.deliveryIds</code></td></tr></tbody></table><p><code>message.received</code> lists every send its prompt carries in arrival order, so one turn can carry several IDs.</p><div class="language-ts vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">ts</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;">// In a route or channel hook: name the steer after the webhook delivery.</span></span>
2
2
  <span class="line"><span style="--shiki-light:#D73A49;--shiki-dark:#F97583;">await</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;"> send</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">\`Incident \${</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">incident</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">.</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">id</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">} was acknowledged.\`</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">, {</span></span>
3
3
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> continuationToken: incident.id,</span></span>
4
4
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> admission: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;coalesce&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
@@ -19,4 +19,4 @@ import{_ as s,c as t,o as a,a3 as i}from"./chunks/framework.BNw1pucY.js";const k
19
19
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> prompted.</span><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">add</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">(id);</span></span>
20
20
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> }</span></span>
21
21
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
22
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">};</span></span></code></pre></div><p>In a local Slack session, a <code>nudge.delivered</code> event with no <code>deliveryId</code> came from a new Slack message, not from a <code>send()</code> call.</p><h2 id="stream-events" tabindex="-1">Stream events <a class="header-anchor" href="#stream-events" aria-label="Permalink to &quot;Stream events&quot;">​</a></h2><p>Each NDJSON line is a <code>{ type, index, sessionId, turnId?, at, data }</code> envelope. The <code>index</code> increases within one session, and <code>at</code> is an ISO-8601 timestamp.</p><table tabindex="0"><thead><tr><th>Phase</th><th>Events</th><th>What they tell you</th></tr></thead><tbody><tr><td>Session</td><td><code>session.started</code>, <code>session.waiting</code>, <code>session.completed</code>, <code>session.failed</code></td><td>Creation, readiness, and task completion</td></tr><tr><td>Input</td><td><code>message.received</code>, <code>nudge.delivered</code></td><td>A prompt was accepted or reached a running turn. Both carry <a href="#track-which-follow-up-reached-the-agent">delivery IDs</a></td></tr><tr><td>Turn</td><td><code>turn.queued</code>, <code>turn.started</code>, <code>turn.completed</code>, <code>turn.failed</code></td><td>Queueing under <a href="./agent-config.html#concurrency"><code>maxRunningTurns</code></a>, then status, result, and token usage</td></tr><tr><td>Steps</td><td><code>step.started</code>, <code>step.completed</code></td><td>Model step boundaries and duration</td></tr><tr><td>Reasoning</td><td><code>reasoning.appended</code>, <code>reasoning.completed</code></td><td>Streamed reasoning blocks</td></tr><tr><td>Reply</td><td><code>message.appended</code>, <code>message.completed</code></td><td>Text deltas and finished assistant messages</td></tr><tr><td>Tools</td><td><code>actions.requested</code>, <code>actions.completed</code>, <code>action.result</code>, <code>action.tool_retry</code></td><td>Tool names, arguments, outputs, and errors. <code>action.tool_retry</code> marks a read retried after a transient failure</td></tr><tr><td>Subagents</td><td><code>subagent.called</code>, <code>subagent.completed</code></td><td>Delegated work</td></tr><tr><td>Artifacts</td><td><code>artifact.tagged</code></td><td>An <a href="./artifacts.html">artifact</a> was tagged</td></tr></tbody></table><p><code>actions.requested</code> and <code>actions.completed</code> bracket each model step&#39;s tool batch, and <code>action.result</code> carries each call live. Read <code>turn.completed.data.usage</code> for token counts. <a href="./http-api.html#stream-or-replay-session-events">HTTP API</a> shows how to follow the stream.</p><h2 id="local-session-workspace" tabindex="-1">Local session workspace <a class="header-anchor" href="#local-session-workspace" aria-label="Permalink to &quot;Local session workspace&quot;">​</a></h2><p>Agent SDK creates a workspace before the first local turn.</p><table tabindex="0"><thead><tr><th>Source path</th><th>Lands as</th></tr></thead><tbody><tr><td><code>skills/*</code></td><td><code>.cursor/skills/&lt;name&gt;/SKILL.md</code></td></tr><tr><td>agent tools (<code>execution: &quot;agent&quot;</code>)</td><td>Scripts listed in the system prompt</td></tr><tr><td><code>sandbox/workspace/**</code></td><td>Seed files</td></tr><tr><td>per-send <code>workspaceFiles</code></td><td>Files written before the turn</td></tr></tbody></table><p>On a local turn, Agent SDK sends the instructions as the system prompt, and on a turn in the cloud it includes them in the first user message. Nothing is written into the session workspace as <code>AGENTS.md</code>. See <a href="./instructions.html">Instructions</a>.</p><p>A channel can give one session a different directory, such as a PR worktree. <a href="./agent-config.html#local-cwd">Agent config</a> covers what parent directories add.</p><h2 id="session-storage" tabindex="-1">Session storage <a class="header-anchor" href="#session-storage" aria-label="Permalink to &quot;Session storage&quot;">​</a></h2><p>Local session state lives under <code>--state-root</code>, in a subdirectory named for the slug on a slugged mount. Deleting a session directory removes the session from the server.</p><h2 id="inspect-a-saved-event-stream" tabindex="-1">Inspect a saved event stream <a class="header-anchor" href="#inspect-a-saved-event-stream" aria-label="Permalink to &quot;Inspect a saved event stream&quot;">​</a></h2><p><code>agent-sdk session get --file &lt;state-root&gt;/traces/&lt;sessionId&gt;.ndjson</code> prints a saved trace&#39;s tool calls, reply, and token usage in the same JSON shape as <code>run</code>. For a session on a running server, <code>agent-sdk session get &lt;sessionId&gt; --view events</code> prints the raw event list. The playground&#39;s <strong>Trace</strong> view shows a timeline.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./http-api.html">HTTP API</a></li><li><a href="./hooks.html">Hooks</a></li><li><a href="./tools.html">Tools</a></li></ul>`,35)])])}const g=s(n,[["render",d]]);export{k as __pageData,g as default};
22
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">};</span></span></code></pre></div><p>In a local Slack session, a <code>nudge.delivered</code> event with no <code>deliveryId</code> came from a new Slack message, not from a <code>send()</code> call.</p><h3 id="steer-the-agent-s-own-running-turn" tabindex="-1">Steer the agent&#39;s own running turn <a class="header-anchor" href="#steer-the-agent-s-own-running-turn" aria-label="Permalink to &quot;Steer the agent&#39;s own running turn&quot;">​</a></h3><p>A tool or a channel <code>events</code> handler can add a message to the turn it runs in with <code>ctx.steer(message, { deliveryId })</code>. The message lands through the Cursor SDK&#39;s <code>Run.steer</code> and is recorded like a steered <code>send()</code>, with <code>message.received</code> and <code>nudge.delivered</code>. It never starts a turn, opens a session, or queues the message. It resolves to <code>{ status: &quot;steered&quot;, turnId, deliveryId }</code>, to <code>{ status: &quot;no_turn&quot; }</code> when the context&#39;s turn is no longer running, or to <code>{ status: &quot;not_delivered&quot;, reason }</code> when the running turn didn&#39;t take the message.</p><h2 id="stream-events" tabindex="-1">Stream events <a class="header-anchor" href="#stream-events" aria-label="Permalink to &quot;Stream events&quot;">​</a></h2><p>Each NDJSON line is a <code>{ type, index, sessionId, turnId?, at, data }</code> envelope. The <code>index</code> increases within one session, and <code>at</code> is an ISO-8601 timestamp.</p><table tabindex="0"><thead><tr><th>Phase</th><th>Events</th><th>What they tell you</th></tr></thead><tbody><tr><td>Session</td><td><code>session.started</code>, <code>session.waiting</code>, <code>session.completed</code>, <code>session.failed</code></td><td>Creation, readiness, and task completion</td></tr><tr><td>Input</td><td><code>message.received</code>, <code>nudge.delivered</code></td><td>A prompt was accepted or reached a running turn. Both carry <a href="#track-which-follow-up-reached-the-agent">delivery IDs</a></td></tr><tr><td>Turn</td><td><code>turn.queued</code>, <code>turn.started</code>, <code>turn.completed</code>, <code>turn.failed</code></td><td>Queueing under <a href="./agent-config.html#concurrency"><code>maxRunningTurns</code></a>, then status, result, and token usage</td></tr><tr><td>Steps</td><td><code>step.started</code>, <code>step.completed</code></td><td>Model step boundaries and duration</td></tr><tr><td>Model calls</td><td><code>model_call.completed</code></td><td>One model call&#39;s token usage, as soon as the call finishes. Needs a Cursor SDK that reports per-call usage</td></tr><tr><td>Reasoning</td><td><code>reasoning.appended</code>, <code>reasoning.completed</code></td><td>Streamed reasoning blocks</td></tr><tr><td>Reply</td><td><code>message.appended</code>, <code>message.completed</code></td><td>Text deltas and finished assistant messages</td></tr><tr><td>Tools</td><td><code>actions.requested</code>, <code>actions.completed</code>, <code>action.result</code>, <code>action.tool_retry</code></td><td>Tool names, arguments, outputs, and errors. <code>action.tool_retry</code> marks a read retried after a transient failure</td></tr><tr><td>Subagents</td><td><code>subagent.called</code>, <code>subagent.completed</code></td><td>Delegated work</td></tr><tr><td>Artifacts</td><td><code>artifact.tagged</code></td><td>An <a href="./artifacts.html">artifact</a> was tagged</td></tr></tbody></table><p><code>actions.requested</code> and <code>actions.completed</code> bracket each model step&#39;s tool batch, and <code>action.result</code> carries each call live. Read <code>turn.completed.data.usage</code> for token counts. <a href="./http-api.html#stream-or-replay-session-events">HTTP API</a> shows how to follow the stream.</p><h2 id="local-session-workspace" tabindex="-1">Local session workspace <a class="header-anchor" href="#local-session-workspace" aria-label="Permalink to &quot;Local session workspace&quot;">​</a></h2><p>Agent SDK creates a workspace before the first local turn.</p><table tabindex="0"><thead><tr><th>Source path</th><th>Lands as</th></tr></thead><tbody><tr><td><code>skills/*</code></td><td><code>.cursor/skills/&lt;name&gt;/SKILL.md</code></td></tr><tr><td>agent tools (<code>execution: &quot;agent&quot;</code>)</td><td>Scripts listed in the system prompt</td></tr><tr><td><code>sandbox/workspace/**</code></td><td>Seed files</td></tr><tr><td>per-send <code>workspaceFiles</code></td><td>Files written before the turn</td></tr></tbody></table><p>On a local turn, Agent SDK sends the instructions as the system prompt, and on a turn in the cloud it includes them in the first user message. Nothing is written into the session workspace as <code>AGENTS.md</code>. See <a href="./instructions.html">Instructions</a>.</p><p>A channel can give one session a different directory, such as a PR worktree. <a href="./agent-config.html#local-cwd">Agent config</a> covers what parent directories add.</p><h2 id="session-storage" tabindex="-1">Session storage <a class="header-anchor" href="#session-storage" aria-label="Permalink to &quot;Session storage&quot;">​</a></h2><p>Local session state lives under <code>--state-root</code>, in a subdirectory named for the slug on a slugged mount. Deleting a session directory removes the session from the server.</p><h2 id="inspect-a-saved-event-stream" tabindex="-1">Inspect a saved event stream <a class="header-anchor" href="#inspect-a-saved-event-stream" aria-label="Permalink to &quot;Inspect a saved event stream&quot;">​</a></h2><p><code>agent-sdk session get --file &lt;state-root&gt;/traces/&lt;sessionId&gt;.ndjson</code> prints a saved trace&#39;s tool calls, reply, and token usage in the same JSON shape as <code>run</code>. For a session on a running server, <code>agent-sdk session get &lt;sessionId&gt; --view events</code> prints the raw event list. The playground&#39;s <strong>Trace</strong> view shows a timeline.</p><h2 id="related" tabindex="-1">Related <a class="header-anchor" href="#related" aria-label="Permalink to &quot;Related&quot;">​</a></h2><ul><li><a href="./http-api.html">HTTP API</a></li><li><a href="./hooks.html">Hooks</a></li><li><a href="./tools.html">Tools</a></li></ul>`,37)])])}const u=s(i,[["render",d]]);export{k as __pageData,u as default};
@@ -1 +1 @@
1
- import{_ as s,c as t,o as a,a3 as i}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives.","frontmatter":{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives."},"headers":[],"relativePath":"reference/sessions.md","filePath":"reference/sessions.md"}'),n={name:"reference/sessions.md"};function d(o,e,r,l,h,c){return a(),t("div",null,[...e[0]||(e[0]=[i("",35)])])}const g=s(n,[["render",d]]);export{k as __pageData,g as default};
1
+ import{_ as s,c as t,o as a,a3 as n}from"./chunks/framework.BNw1pucY.js";const k=JSON.parse('{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives.","frontmatter":{"title":"Sessions, events, and streaming","description":"Understand how conversations continue, how events stream, and where session data lives."},"headers":[],"relativePath":"reference/sessions.md","filePath":"reference/sessions.md"}'),i={name:"reference/sessions.md"};function d(o,e,r,l,h,c){return a(),t("div",null,[...e[0]||(e[0]=[n("",37)])])}const u=s(i,[["render",d]]);export{k as __pageData,u as default};
@@ -1,6 +1,6 @@
1
- import{_ as i,c as e,o as t,a3 as a}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms.","frontmatter":{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms."},"headers":[],"relativePath":"reference/skills.md","filePath":"reference/skills.md"}'),n={name:"reference/skills.md"};function l(h,s,r,o,d,k){return t(),e("div",null,[...s[0]||(s[0]=[a(`<h1 id="skills" tabindex="-1">Skills <a class="header-anchor" href="#skills" aria-label="Permalink to &quot;Skills&quot;">​</a></h1><p>A skill is an on-demand procedure in the <code>SKILL.md</code> convention. Agent SDK advertises each skill by its description, and the model loads a skill only when the task calls for it. Skills give an agent a multi-step workflow without carrying it in the always-on <a href="./instructions.html">instructions</a>.</p><h2 id="authoring-forms" tabindex="-1">Authoring forms <a class="header-anchor" href="#authoring-forms" aria-label="Permalink to &quot;Authoring forms&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Form</th><th>Reach for it when</th></tr></thead><tbody><tr><td><code>bot/skills/&lt;name&gt;.md</code></td><td>Static Markdown. <code>description</code> frontmatter is optional and falls back to the first body line</td></tr><tr><td><code>bot/skills/&lt;name&gt;/SKILL.md</code> plus siblings</td><td>A packaged directory with reference files. Requires <code>description</code> frontmatter</td></tr><tr><td><code>bot/skills/&lt;name&gt;.ts</code></td><td>Generated content, with <code>defineSkill</code> from <code>@grok/agent-sdk/skills</code></td></tr></tbody></table><p>Use flat Markdown for static content:</p><div class="language-md vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">md</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">---</span></span>
2
- <span class="line"><span style="--shiki-light:#22863A;--shiki-dark:#85E89D;">description</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">Use when a pull request needs a structured approval checklist.</span></span>
3
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">---</span></span>
1
+ import{_ as i,c as e,o as t,a3 as a}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms.","frontmatter":{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms."},"headers":[],"relativePath":"reference/skills.md","filePath":"reference/skills.md"}'),n={name:"reference/skills.md"};function l(h,s,r,o,d,k){return t(),e("div",null,[...s[0]||(s[0]=[a(`<h1 id="skills" tabindex="-1">Skills <a class="header-anchor" href="#skills" aria-label="Permalink to &quot;Skills&quot;">​</a></h1><p>A skill is an on-demand procedure in the <code>SKILL.md</code> convention. Agent SDK advertises each skill by its description, and the model loads a skill only when the task calls for it. Skills give an agent a multi-step workflow without carrying it in the always-on <a href="./instructions.html">instructions</a>.</p><h2 id="authoring-forms" tabindex="-1">Authoring forms <a class="header-anchor" href="#authoring-forms" aria-label="Permalink to &quot;Authoring forms&quot;">​</a></h2><table tabindex="0"><thead><tr><th>Form</th><th>Reach for it when</th></tr></thead><tbody><tr><td><code>bot/skills/&lt;name&gt;.md</code></td><td>Static Markdown. <code>description</code> frontmatter is optional and falls back to the first body line</td></tr><tr><td><code>bot/skills/&lt;name&gt;/SKILL.md</code> plus siblings</td><td>A packaged directory with reference files. Requires <code>description</code> frontmatter</td></tr><tr><td><code>bot/skills/&lt;name&gt;.ts</code></td><td>Generated content, with <code>defineSkill</code> from <code>@grok/agent-sdk/skills</code></td></tr></tbody></table><p>Use flat Markdown for static content:</p><div class="language-md vp-adaptive-theme"><button title="Copy Code" class="copy"></button><span class="lang">md</span><pre class="shiki shiki-themes github-light github-dark vp-code" tabindex="0"><code><span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">---</span></span>
2
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">description: Use when a pull request needs a structured approval checklist.</span></span>
3
+ <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;">---</span></span>
4
4
  <span class="line"></span>
5
5
  <span class="line"><span style="--shiki-light:#005CC5;--shiki-light-font-weight:bold;--shiki-dark:#79B8FF;--shiki-dark-font-weight:bold;"># PR review checklist</span></span>
6
6
  <span class="line"></span>
@@ -12,4 +12,4 @@ import{_ as i,c as e,o as t,a3 as a}from"./chunks/framework.BNw1pucY.js";const c
12
12
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> description: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Research unfamiliar topics before answering.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
13
13
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> markdown: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;Gather evidence first, then answer with the key facts.&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">,</span></span>
14
14
  <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> files: { </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;references/checklist.md&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">: </span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;# Checklist</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\n\\n</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">- Find sources.</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;">\\n</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;">&quot;</span><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;"> },</span></span>
15
- <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="skill-delivery" tabindex="-1">Skill delivery <a class="header-anchor" href="#skill-delivery" aria-label="Permalink to &quot;Skill delivery&quot;">​</a></h2><p>Local sessions get each skill at <code>.cursor/skills/&lt;name&gt;/SKILL.md</code> in the session workspace, and the agent lists and loads them from there.</p><h2 id="skills-instructions-and-tools" tabindex="-1">Skills, instructions, and tools <a class="header-anchor" href="#skills-instructions-and-tools" aria-label="Permalink to &quot;Skills, instructions, and tools&quot;">​</a></h2><p>Instructions stay in context on every turn. Skills hold procedures, checklists, and house style that the model needs only sometimes. Put anything that must be correct every time in a typed <a href="./tools.html">tool</a>, where the model can&#39;t paraphrase it.</p><p>A description is a routing hint, so say when to use the skill, as the checklist example does. The model sees only the description before it decides to load the skill.</p>`,13)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
15
+ <span class="line"><span style="--shiki-light:#24292E;--shiki-dark:#E1E4E8;">});</span></span></code></pre></div><h2 id="skill-delivery" tabindex="-1">Skill delivery <a class="header-anchor" href="#skill-delivery" aria-label="Permalink to &quot;Skill delivery&quot;">​</a></h2><p>Local sessions get each skill at <code>.cursor/skills/&lt;name&gt;/SKILL.md</code> in the session workspace, and the agent lists and loads them from there.</p><h2 id="skills-instructions-and-tools" tabindex="-1">Skills, instructions, and tools <a class="header-anchor" href="#skills-instructions-and-tools" aria-label="Permalink to &quot;Skills, instructions, and tools&quot;">​</a></h2><p>Instructions stay in context on every turn. Skills hold procedures, checklists, and house style that the model needs only sometimes. Put anything that must be correct every time in a typed <a href="./tools.html">tool</a>, where the model can&#39;t paraphrase it.</p><p>A description is a routing hint, so say when to use the skill, as the checklist example does. The model sees only the description before it decides to load the skill.</p>`,13)])])}const g=i(n,[["render",l]]);export{c as __pageData,g as default};
@@ -1 +1 @@
1
- import{_ as i,c as e,o as t,a3 as a}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms.","frontmatter":{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms."},"headers":[],"relativePath":"reference/skills.md","filePath":"reference/skills.md"}'),n={name:"reference/skills.md"};function l(h,s,r,o,d,k){return t(),e("div",null,[...s[0]||(s[0]=[a("",13)])])}const E=i(n,[["render",l]]);export{c as __pageData,E as default};
1
+ import{_ as i,c as e,o as t,a3 as a}from"./chunks/framework.BNw1pucY.js";const c=JSON.parse('{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms.","frontmatter":{"title":"Skills","description":"On-demand procedures the model loads only when relevant, in three authoring forms."},"headers":[],"relativePath":"reference/skills.md","filePath":"reference/skills.md"}'),n={name:"reference/skills.md"};function l(h,s,r,o,d,k){return t(),e("div",null,[...s[0]||(s[0]=[a("",13)])])}const g=i(n,[["render",l]]);export{c as __pageData,g as default};