@grok/agent-sdk 0.2.28 → 0.2.29

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 (339) hide show
  1. package/AGENTS.md +29 -29
  2. package/dist/bin/agent-serve.d.ts +2 -2
  3. package/dist/bin/agent-serve.js +3 -3
  4. package/dist/channels/pagerduty/api.js +1 -1
  5. package/dist/channels/pagerduty/pagerduty-channel.d.ts +1 -1
  6. package/dist/channels/pagerduty/pagerduty-channel.d.ts.map +1 -1
  7. package/dist/channels/pagerduty/pagerduty-channel.js +1 -1
  8. package/dist/channels/pagerduty/replay.d.ts +1 -1
  9. package/dist/channels/pagerduty/replay.js +4 -4
  10. package/dist/docs/404.html +2 -2
  11. package/dist/docs/assets/{app.DF9vlcdn.js → app.DMrZKFjI.js} +4 -4
  12. package/dist/docs/assets/changelog.md.DrLFQUlu.js +1 -0
  13. package/dist/docs/assets/changelog.md.DrLFQUlu.lean.js +1 -0
  14. package/dist/docs/assets/chunks/@localSearchIndexroot.Dpd_wxVU.js +1 -0
  15. package/dist/docs/assets/chunks/{VPLocalSearchBox.D8OuwKO0.js → VPLocalSearchBox.DQvuw1KA.js} +1 -1
  16. package/dist/docs/assets/chunks/{arc.DCq_TCYV.js → arc.ahOG-Qza.js} +1 -1
  17. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.PWRNTPbk.js → architectureDiagram-Q4EWVU46.BcgfYNO_.js} +1 -1
  18. package/dist/docs/assets/chunks/{baseUniq.BeRPvRUL.js → baseUniq.DeIYZrWh.js} +1 -1
  19. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.BuRmZVSo.js → blockDiagram-DXYQGD6D.HjJ2goMX.js} +1 -1
  20. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.7DKSMwuv.js → c4Diagram-AHTNJAMY.C1QTb9GM.js} +1 -1
  21. package/dist/docs/assets/chunks/channel._fZX_hvU.js +1 -0
  22. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.7VrO9-9i.js → chunk-4BX2VUAB.UuZiDiVp.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.CHystNE2.js → chunk-4TB4RGXK.5A3YmkhI.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-55IACEB6.Nuh9TbTq.js → chunk-55IACEB6.B4uf1yYV.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.CA0EKugm.js → chunk-EDXVE4YY.CoXBce8t.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.F9_mp7U8.js → chunk-FMBD7UC4.DnC5NO4e.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.CEU4QfE1.js → chunk-OYMX7WX6.CzfHCeIi.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.B8h_x9_i.js → chunk-QZHKN3VN.C6tcwkVd.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.Btfb-rKg.js → chunk-YZCP3GAM._oboyZ1A.js} +1 -1
  30. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.eClS1Q0E.js +1 -0
  31. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.eClS1Q0E.js +1 -0
  32. package/dist/docs/assets/chunks/clone.W1Phdw9P.js +1 -0
  33. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DKvc96Wa.js → cose-bilkent-S5V4N54A.BfPVKeId.js} +1 -1
  34. package/dist/docs/assets/chunks/{dagre-KV5264BT.CMo0cy1b.js → dagre-KV5264BT.CLMLc0lD.js} +1 -1
  35. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.DDgMOQhB.js → diagram-5BDNPKRD.C7OF7UfH.js} +1 -1
  36. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.BdJnoIsU.js → diagram-G4DWMVQ6.Dpao0Bl1.js} +1 -1
  37. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.oSvhAZaL.js → diagram-MMDJMWI5.DLnM9eLp.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-TYMM5635.C9zZLIE-.js → diagram-TYMM5635.BcpVgA_M.js} +1 -1
  39. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.BNhVyccy.js → erDiagram-SMLLAGMA.CsL5JuCV.js} +1 -1
  40. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BEFLLBiU.js → flowDiagram-DWJPFMVM.MFihq9AF.js} +1 -1
  41. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.BdUzXBgY.js → ganttDiagram-T4ZO3ILL.CJeLodyG.js} +1 -1
  42. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.Rd3LlOIJ.js → gitGraphDiagram-UUTBAWPF.1HhlE45Z.js} +1 -1
  43. package/dist/docs/assets/chunks/{graph.DnJC1GpG.js → graph.BS02KkWA.js} +1 -1
  44. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.xv0xntDJ.js → infoDiagram-42DDH7IO.fp5gvytQ.js} +1 -1
  45. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.BaGIlviU.js → ishikawaDiagram-UXIWVN3A.C6Wk1V4I.js} +1 -1
  46. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.Cof_h0fp.js → journeyDiagram-VCZTEJTY.qJt4uJ_H.js} +1 -1
  47. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.C5GozFuU.js → kanban-definition-6JOO6SKY.z2tG9kly.js} +1 -1
  48. package/dist/docs/assets/chunks/{layout.zc9UShLc.js → layout.BPCkdejr.js} +1 -1
  49. package/dist/docs/assets/chunks/{linear.BoqrFVcJ.js → linear.CL3TC3u7.js} +1 -1
  50. package/dist/docs/assets/chunks/{min.DwIfr8hG.js → min.SPrSp704.js} +1 -1
  51. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.Dkq2yTtp.js → mindmap-definition-QFDTVHPH.DgrQRFZW.js} +1 -1
  52. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.B4CpTmHK.js → pieDiagram-DEJITSTG.Ba7yxiW2.js} +1 -1
  53. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.BqXnFC9C.js → quadrantDiagram-34T5L4WZ.Bvskad4p.js} +1 -1
  54. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DhIN2z-E.js → requirementDiagram-MS252O5E.Ce70ugV9.js} +1 -1
  55. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.BhxUAmg2.js → sankeyDiagram-XADWPNL6.BJ5OEULO.js} +1 -1
  56. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.BqgU7HU-.js → sequenceDiagram-FGHM5R23.C8a1hDs6.js} +1 -1
  57. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.B1BCO18N.js → stateDiagram-FHFEXIEX.D2D8A5CK.js} +1 -1
  58. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.77yf4kRr.js +1 -0
  59. package/dist/docs/assets/chunks/{theme.oV7rddEz.js → theme.DRciHmS1.js} +2 -2
  60. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.oRI8UwMC.js → timeline-definition-GMOUNBTQ.C4ePrY8-.js} +1 -1
  61. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.DmuWrIxN.js → vennDiagram-DHZGUBPP.Dzso6dEA.js} +1 -1
  62. package/dist/docs/assets/chunks/{wardley-RL74JXVD.CEBjM5ov.js → wardley-RL74JXVD.djgXR0ar.js} +1 -1
  63. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.m5zsCOF9.js → wardleyDiagram-NUSXRM2D.Bf2ICxjh.js} +1 -1
  64. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.cPN-587n.js → xychartDiagram-5P7HB3ND.DEH4BcVJ.js} +1 -1
  65. package/dist/docs/assets/{deployment.md.DDmjAVbg.js → deployment.md.KW0Ni_rY.js} +5 -5
  66. package/dist/docs/assets/{evals.md.OjKb7tNA.js → evals.md.DiljU__Z.js} +1 -1
  67. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.js → guides_jev.md.CEqLgjj9.js} +2 -2
  68. package/dist/docs/assets/{guides_jev.md.Ccw4pedT.lean.js → guides_jev.md.CEqLgjj9.lean.js} +1 -1
  69. package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.js → guides_mcp-oauth.md.DrGY92u4.js} +1 -1
  70. package/dist/docs/assets/{guides_slack.md.BqiGSYGX.js → guides_slack.md.BwXHURvY.js} +1 -1
  71. package/dist/docs/assets/index.md.CAruw_rp.js +26 -0
  72. package/dist/docs/assets/{index.md.CVRjO09Y.lean.js → index.md.CAruw_rp.lean.js} +1 -1
  73. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.js → quickstart.md.CljDaJBi.js} +3 -3
  74. package/dist/docs/assets/{quickstart.md.DaLk4ZIF.lean.js → quickstart.md.CljDaJBi.lean.js} +1 -1
  75. package/dist/docs/assets/reference_access.md.CEtibb4i.js +1 -0
  76. package/dist/docs/assets/reference_access.md.CEtibb4i.lean.js +1 -0
  77. package/dist/docs/assets/{reference_agent-config.md.11E_xe--.js → reference_agent-config.md.Ck29qYNj.js} +1 -1
  78. package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.js → reference_cli.md.BkdLRbXg.js} +5 -5
  79. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.js → reference_evals.md.2BXeMiO2.js} +23 -3
  80. package/dist/docs/assets/{reference_evals.md.DYKjGFi-.lean.js → reference_evals.md.2BXeMiO2.lean.js} +1 -1
  81. package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.js → reference_extensions.md.DI5X5x8p.js} +1 -1
  82. package/dist/docs/assets/{reference_limits.md.Da1HegjB.js → reference_limits.md.BCCnvt3o.js} +2 -2
  83. package/dist/docs/assets/{reference_limits.md.Da1HegjB.lean.js → reference_limits.md.BCCnvt3o.lean.js} +1 -1
  84. package/dist/docs/assets/troubleshooting.md.CGOdNVAL.js +1 -0
  85. package/dist/docs/building-with-agents.html +35 -35
  86. package/dist/docs/building-with-agents.md +5 -5
  87. package/dist/docs/changelog.html +36 -36
  88. package/dist/docs/changelog.md +10 -0
  89. package/dist/docs/deployment.html +41 -41
  90. package/dist/docs/deployment.md +8 -8
  91. package/dist/docs/evals.html +37 -37
  92. package/dist/docs/evals.md +4 -2
  93. package/dist/docs/guides/agent-to-agent.html +35 -35
  94. package/dist/docs/guides/bitbucket.html +35 -35
  95. package/dist/docs/guides/cloud-agents.html +36 -36
  96. package/dist/docs/guides/convert-automation.html +35 -35
  97. package/dist/docs/guides/github.html +35 -35
  98. package/dist/docs/guides/github.md +1 -1
  99. package/dist/docs/guides/gitlab.html +35 -35
  100. package/dist/docs/guides/hooks.html +35 -35
  101. package/dist/docs/guides/improve.html +36 -36
  102. package/dist/docs/guides/jev.html +36 -36
  103. package/dist/docs/guides/jev.md +5 -0
  104. package/dist/docs/guides/mcp-oauth.html +37 -37
  105. package/dist/docs/guides/mcp-oauth.md +2 -3
  106. package/dist/docs/guides/migrate.html +35 -35
  107. package/dist/docs/guides/migrate.md +2 -2
  108. package/dist/docs/guides/opentelemetry.html +35 -35
  109. package/dist/docs/guides/pagerduty.html +35 -35
  110. package/dist/docs/guides/slack.html +37 -37
  111. package/dist/docs/guides/slack.md +5 -6
  112. package/dist/docs/guides/webhooks.html +35 -35
  113. package/dist/docs/hashmap.json +1 -1
  114. package/dist/docs/hillclimbing.html +35 -35
  115. package/dist/docs/hillclimbing.md +2 -2
  116. package/dist/docs/index.html +51 -52
  117. package/dist/docs/index.md +17 -16
  118. package/dist/docs/llms-full.txt +120 -199
  119. package/dist/docs/llms.txt +0 -1
  120. package/dist/docs/package/skills/create-agent/SKILL.md +178 -0
  121. package/dist/docs/package/skills/evals/SKILL.md +145 -0
  122. package/dist/docs/package/skills/github/SKILL.md +133 -0
  123. package/dist/docs/package/skills/hillclimb/SKILL.md +63 -0
  124. package/dist/docs/package/skills/mcp-auth/SKILL.md +60 -0
  125. package/dist/docs/package/skills/migrate-v2/SKILL.md +394 -0
  126. package/dist/docs/package/skills/setup-slack/SKILL.md +136 -0
  127. package/dist/docs/quickstart.html +38 -38
  128. package/dist/docs/quickstart.md +5 -1
  129. package/dist/docs/reference/access.html +36 -36
  130. package/dist/docs/reference/access.md +3 -3
  131. package/dist/docs/reference/agent-config.html +37 -37
  132. package/dist/docs/reference/agent-config.md +1 -1
  133. package/dist/docs/reference/artifacts.html +35 -35
  134. package/dist/docs/reference/channels.html +35 -35
  135. package/dist/docs/reference/cli.html +41 -41
  136. package/dist/docs/reference/cli.md +6 -6
  137. package/dist/docs/reference/connections.html +35 -35
  138. package/dist/docs/reference/connections.md +1 -1
  139. package/dist/docs/reference/evals.html +57 -37
  140. package/dist/docs/reference/evals.md +35 -0
  141. package/dist/docs/reference/extensions.html +37 -37
  142. package/dist/docs/reference/extensions.md +2 -2
  143. package/dist/docs/reference/hooks.html +35 -35
  144. package/dist/docs/reference/http-api.html +35 -35
  145. package/dist/docs/reference/instructions.html +35 -35
  146. package/dist/docs/reference/limits.html +37 -37
  147. package/dist/docs/reference/limits.md +2 -2
  148. package/dist/docs/reference/memory.html +35 -35
  149. package/dist/docs/reference/playground.html +35 -35
  150. package/dist/docs/reference/project-layout.html +35 -35
  151. package/dist/docs/reference/prompt.html +35 -35
  152. package/dist/docs/reference/schedules.html +35 -35
  153. package/dist/docs/reference/sessions.html +35 -35
  154. package/dist/docs/reference/skills.html +35 -35
  155. package/dist/docs/reference/subagents.html +35 -35
  156. package/dist/docs/reference/tools.html +35 -35
  157. package/dist/docs/templates/agentic-owners.html +35 -35
  158. package/dist/docs/templates/security-reviewer.html +35 -35
  159. package/dist/docs/templates/thermo-quality-review.html +35 -35
  160. package/dist/docs/templates/thermo-review.html +35 -35
  161. package/dist/docs/templates/triage.html +35 -35
  162. package/dist/docs/troubleshooting.html +36 -36
  163. package/dist/docs/troubleshooting.md +4 -4
  164. package/dist/evals.d.ts +2 -2
  165. package/dist/extensions/jev/extension.d.ts +12 -2
  166. package/dist/extensions/jev/extension.d.ts.map +1 -1
  167. package/dist/extensions/jev/extension.js +4 -0
  168. package/dist/extensions/jev/lib/evaluate.d.ts +31 -4
  169. package/dist/extensions/jev/lib/evaluate.d.ts.map +1 -1
  170. package/dist/extensions/jev/lib/evaluate.js +18 -4
  171. package/dist/internal/cli/command.d.ts +1 -1
  172. package/dist/internal/cli/command.js +1 -1
  173. package/dist/internal/cli/commands/channels.js +6 -6
  174. package/dist/internal/cli/commands/develop.d.ts.map +1 -1
  175. package/dist/internal/cli/commands/develop.js +23 -14
  176. package/dist/internal/cli/commands/hosted.js +4 -4
  177. package/dist/internal/cli/commands/index.d.ts +1 -1
  178. package/dist/internal/cli/commands/index.d.ts.map +1 -1
  179. package/dist/internal/cli/commands/index.js +1 -1
  180. package/dist/internal/cli/commands/mcp.js +1 -1
  181. package/dist/internal/cli/commands/project.js +4 -4
  182. package/dist/internal/cli/commands/scaffold.d.ts.map +1 -1
  183. package/dist/internal/cli/commands/scaffold.js +9 -6
  184. package/dist/internal/cli/commands/serve.d.ts +1 -1
  185. package/dist/internal/cli/commands/serve.js +5 -5
  186. package/dist/internal/cli/commands/session.d.ts.map +1 -1
  187. package/dist/internal/cli/commands/session.js +12 -7
  188. package/dist/internal/cli/dispatch.d.ts +3 -3
  189. package/dist/internal/cli/dispatch.js +3 -3
  190. package/dist/internal/cli/errors.d.ts +1 -1
  191. package/dist/internal/cli/errors.d.ts.map +1 -1
  192. package/dist/internal/cli/errors.js +1 -1
  193. package/dist/internal/cli/flags.d.ts +2 -2
  194. package/dist/internal/cli/flags.d.ts.map +1 -1
  195. package/dist/internal/cli/flags.js +2 -2
  196. package/dist/internal/cli/help-command.d.ts +1 -1
  197. package/dist/internal/cli/help-command.js +2 -2
  198. package/dist/internal/cli/help.d.ts +7 -7
  199. package/dist/internal/cli/help.d.ts.map +1 -1
  200. package/dist/internal/cli/help.js +8 -8
  201. package/dist/internal/cli-ax.d.ts.map +1 -1
  202. package/dist/internal/cli-ax.js +3 -0
  203. package/dist/internal/cli-convert-automation.d.ts +1 -1
  204. package/dist/internal/cli-convert-automation.js +1 -1
  205. package/dist/internal/cli-migrate.d.ts +1 -1
  206. package/dist/internal/cli-migrate.js +1 -1
  207. package/dist/internal/cli-pagerduty.d.ts +1 -1
  208. package/dist/internal/cli-pagerduty.js +1 -1
  209. package/dist/internal/convert-automation/types.d.ts +1 -1
  210. package/dist/internal/convert-automation/types.js +1 -1
  211. package/dist/internal/deploy-client.d.ts +2 -2
  212. package/dist/internal/deploy-client.d.ts.map +1 -1
  213. package/dist/internal/init-project.d.ts +7 -3
  214. package/dist/internal/init-project.d.ts.map +1 -1
  215. package/dist/internal/init-project.js +53 -7
  216. package/dist/internal/init-scaffold.d.ts +2 -1
  217. package/dist/internal/init-scaffold.d.ts.map +1 -1
  218. package/dist/internal/init-scaffold.js +20 -7
  219. package/dist/internal/peer-connections.js +1 -1
  220. package/dist/internal/server.d.ts +1 -1
  221. package/dist/internal/session-cost.d.ts +4 -4
  222. package/dist/internal/session-cost.d.ts.map +1 -1
  223. package/dist/internal/session-cost.js +4 -4
  224. package/dist/internal/session-engine.d.ts +1 -1
  225. package/dist/internal/session-engine.js +1 -1
  226. package/dist/playground/assets/{index-_3zz3yh8.js → index-Cl9zvmmf.js} +40 -40
  227. package/dist/playground/assets/index-F8b5WvWi.css +1 -0
  228. package/dist/playground/index.html +2 -2
  229. package/dist/types.d.ts +5 -5
  230. package/docs/README.md +17 -16
  231. package/docs/changelog.md +10 -0
  232. package/docs/deployment.md +8 -8
  233. package/docs/evals.md +3 -1
  234. package/docs/guides/jev.md +5 -0
  235. package/docs/guides/mcp-oauth.md +1 -2
  236. package/docs/guides/slack.md +3 -4
  237. package/docs/quickstart.md +5 -1
  238. package/docs/reference/access.md +3 -3
  239. package/docs/reference/agent-config.md +1 -1
  240. package/docs/reference/cli.md +6 -6
  241. package/docs/reference/evals.md +35 -0
  242. package/docs/reference/extensions.md +2 -2
  243. package/docs/reference/limits.md +2 -2
  244. package/docs/troubleshooting.md +4 -4
  245. package/package.json +2 -8
  246. package/skills/cli/SKILL.md +15 -15
  247. package/skills/create-agent/SKILL.md +20 -19
  248. package/skills/debug/SKILL.md +4 -4
  249. package/skills/deploy/SKILL.md +2 -2
  250. package/skills/evals/SKILL.md +8 -8
  251. package/skills/framework-map/SKILL.md +3 -3
  252. package/skills/github/SKILL.md +7 -7
  253. package/skills/hillclimb/SKILL.md +4 -4
  254. package/skills/mcp-auth/SKILL.md +3 -3
  255. package/skills/migrate-v2/SKILL.md +40 -40
  256. package/skills/otel/SKILL.md +2 -2
  257. package/skills/setup-slack/SKILL.md +8 -8
  258. package/templates/agentic-owners/README.md +5 -5
  259. package/templates/agentic-owners/bot/tools/record_review.ts +1 -1
  260. package/templates/agentic-owners/package.json +1 -1
  261. package/templates/agents-md/README.md +4 -4
  262. package/templates/agents-md/package.json +1 -1
  263. package/templates/code-wiki/README.md +3 -3
  264. package/templates/code-wiki/package.json +1 -1
  265. package/templates/demo/README.md +3 -3
  266. package/templates/demo/package.json +1 -1
  267. package/templates/pr-autofixer/package.json +1 -1
  268. package/templates/security-help/README.md +5 -5
  269. package/templates/security-help/package.json +1 -1
  270. package/templates/security-reviewer/README.md +3 -3
  271. package/templates/security-reviewer/package.json +1 -1
  272. package/templates/thermo-quality-review/README.md +4 -4
  273. package/templates/thermo-quality-review/package.json +1 -1
  274. package/templates/thermo-review/README.md +4 -4
  275. package/templates/thermo-review/package.json +1 -1
  276. package/templates/triage/README.md +3 -3
  277. package/templates/triage/overlays/jira/README.md +3 -3
  278. package/templates/triage/overlays/linear/README.md +3 -3
  279. package/templates/triage/package.json +1 -1
  280. package/dist/docs/assets/changelog.md.fZ-NNFeJ.js +0 -1
  281. package/dist/docs/assets/changelog.md.fZ-NNFeJ.lean.js +0 -1
  282. package/dist/docs/assets/chunks/@localSearchIndexroot.mfzjiOsL.js +0 -1
  283. package/dist/docs/assets/chunks/channel.goFR5lbe.js +0 -1
  284. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.B2yLtFja.js +0 -1
  285. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.B2yLtFja.js +0 -1
  286. package/dist/docs/assets/chunks/clone.CztV97Wu.js +0 -1
  287. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CZlVHdDZ.js +0 -1
  288. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.js +0 -15
  289. package/dist/docs/assets/guides_grokbot-agents.md.D0PpM_Gf.lean.js +0 -1
  290. package/dist/docs/assets/index.md.CVRjO09Y.js +0 -27
  291. package/dist/docs/assets/reference_access.md.CExlH_mR.js +0 -1
  292. package/dist/docs/assets/reference_access.md.CExlH_mR.lean.js +0 -1
  293. package/dist/docs/assets/troubleshooting.md.AGJ3jDzj.js +0 -1
  294. package/dist/docs/guides/grokbot-agents.html +0 -74
  295. package/dist/docs/guides/grokbot-agents.md +0 -129
  296. package/dist/extensions/cursor-grokbot-agents/extension.d.ts +0 -71
  297. package/dist/extensions/cursor-grokbot-agents/extension.d.ts.map +0 -1
  298. package/dist/extensions/cursor-grokbot-agents/extension.js +0 -64
  299. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts +0 -11
  300. package/dist/extensions/cursor-grokbot-agents/lib/agents.d.ts.map +0 -1
  301. package/dist/extensions/cursor-grokbot-agents/lib/agents.js +0 -31
  302. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts +0 -56
  303. package/dist/extensions/cursor-grokbot-agents/lib/backend.d.ts.map +0 -1
  304. package/dist/extensions/cursor-grokbot-agents/lib/backend.js +0 -139
  305. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts +0 -28
  306. package/dist/extensions/cursor-grokbot-agents/lib/contacts.d.ts.map +0 -1
  307. package/dist/extensions/cursor-grokbot-agents/lib/contacts.js +0 -46
  308. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts +0 -53
  309. package/dist/extensions/cursor-grokbot-agents/lib/conversation.d.ts.map +0 -1
  310. package/dist/extensions/cursor-grokbot-agents/lib/conversation.js +0 -186
  311. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts +0 -4
  312. package/dist/extensions/cursor-grokbot-agents/lib/inputs.d.ts.map +0 -1
  313. package/dist/extensions/cursor-grokbot-agents/lib/inputs.js +0 -15
  314. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts +0 -12
  315. package/dist/extensions/cursor-grokbot-agents/lib/lock.d.ts.map +0 -1
  316. package/dist/extensions/cursor-grokbot-agents/lib/lock.js +0 -24
  317. package/dist/extensions/cursor-grokbot-agents/skills/consult.md +0 -40
  318. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts +0 -4
  319. package/dist/extensions/cursor-grokbot-agents/tools/ask.d.ts.map +0 -1
  320. package/dist/extensions/cursor-grokbot-agents/tools/ask.js +0 -26
  321. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts +0 -4
  322. package/dist/extensions/cursor-grokbot-agents/tools/check.d.ts.map +0 -1
  323. package/dist/extensions/cursor-grokbot-agents/tools/check.js +0 -21
  324. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts +0 -4
  325. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.d.ts.map +0 -1
  326. package/dist/extensions/cursor-grokbot-agents/tools/interrupt.js +0 -13
  327. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts +0 -4
  328. package/dist/extensions/cursor-grokbot-agents/tools/list.d.ts.map +0 -1
  329. package/dist/extensions/cursor-grokbot-agents/tools/list.js +0 -22
  330. package/dist/playground/assets/index-BMpVzZzC.css +0 -1
  331. package/docs/guides/grokbot-agents.md +0 -134
  332. /package/dist/docs/assets/{deployment.md.DDmjAVbg.lean.js → deployment.md.KW0Ni_rY.lean.js} +0 -0
  333. /package/dist/docs/assets/{evals.md.OjKb7tNA.lean.js → evals.md.DiljU__Z.lean.js} +0 -0
  334. /package/dist/docs/assets/{guides_mcp-oauth.md.ekpWOZCC.lean.js → guides_mcp-oauth.md.DrGY92u4.lean.js} +0 -0
  335. /package/dist/docs/assets/{guides_slack.md.BqiGSYGX.lean.js → guides_slack.md.BwXHURvY.lean.js} +0 -0
  336. /package/dist/docs/assets/{reference_agent-config.md.11E_xe--.lean.js → reference_agent-config.md.Ck29qYNj.lean.js} +0 -0
  337. /package/dist/docs/assets/{reference_cli.md.DQ3dCgmk.lean.js → reference_cli.md.BkdLRbXg.lean.js} +0 -0
  338. /package/dist/docs/assets/{reference_extensions.md.pEVj72Xo.lean.js → reference_extensions.md.DI5X5x8p.lean.js} +0 -0
  339. /package/dist/docs/assets/{troubleshooting.md.AGJ3jDzj.lean.js → troubleshooting.md.CGOdNVAL.lean.js} +0 -0
@@ -1 +0,0 @@
1
- {"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../src/extensions/cursor-grokbot-agents/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,WAAW,0BAA0B;IACzC;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,sBAAsB,CAAC,CAAC;IAChD;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,gEAAgE;AAChE,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wCAAwC;AACxC,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAmCzC,QAAA,MAAM,mBAAmB,EAAE,SAAS,CAClC,yBAAyB,EACzB,0BAA0B,GAAG,SAAS,CAKtC,CAAC;eAEY,mBAAmB"}
@@ -1,64 +0,0 @@
1
- /**
2
- * Your Grok Bot agents as an extension. Mount it and the agent can talk to
3
- * the Grok Bot agents of the host's account: send a message, read the
4
- * reply, keep waiting on a long turn, interrupt one.
5
- *
6
- * ```ts
7
- * // agent/extensions/grokbot.ts
8
- * import cursorGrokBotAgents from "@grok/agent-sdk/extensions/cursor-grokbot-agents";
9
- *
10
- * export default cursorGrokBotAgents({
11
- * agents: [
12
- * { name: "Plan Keeper", description: "Keeps or moves outdoor plans." },
13
- * ],
14
- * });
15
- * ```
16
- *
17
- * Contributes `grokbot__ask`, `grokbot__check`, `grokbot__interrupt`,
18
- * `grokbot__list` and the `grokbot__consult` skill (the namespace is the
19
- * mount filename), over the public `/v0/grokbot` session API, under the
20
- * serve host's Cursor API key (`CURSOR_API_KEY`, key file, or `login`).
21
- * Agents are addressed by name and resolved on the account the key belongs
22
- * to; a message lands in that account's own conversation with the agent,
23
- * and the reply is what the agent sends back during that turn. The tools
24
- * run on the serve host, so they need the local runtime.
25
- */
26
- import * as z from "zod/v4";
27
- import { defineExtension } from "../../extensions.js";
28
- /** The backend's session name limit. */
29
- export const AGENT_NAME_MAX_LENGTH = 255;
30
- const DEFAULT_POLL_INTERVAL_MS = 750;
31
- const agentName = z
32
- .string()
33
- .trim()
34
- .min(1, "Grok Bot agent names must not be empty.")
35
- .max(AGENT_NAME_MAX_LENGTH);
36
- const configuredAgent = z
37
- .union([agentName, z.object({ name: agentName, description: z.string().optional() })])
38
- .transform((agent) => (typeof agent === "string" ? { name: agent } : agent));
39
- const agents = z
40
- .array(configuredAgent)
41
- .min(1, "agents must name at least one Grok Bot agent; omit it to allow any.")
42
- .refine((list) => new Set(list.map((agent) => agent.name.toLowerCase())).size === list.length, {
43
- message: "agents must not repeat a name (names match case-insensitively).",
44
- // An element that failed `agentName` never reached the transform, so it has no `name`.
45
- when: (payload) => payload.issues.length === 0,
46
- });
47
- const config = z
48
- .object({
49
- agents: agents.optional(),
50
- needsApproval: z.boolean().optional(),
51
- apiKey: z.string().optional(),
52
- pollIntervalMs: z.number().int().min(1).default(DEFAULT_POLL_INTERVAL_MS),
53
- })
54
- .prefault({})
55
- .transform((options) => ({
56
- ...options,
57
- needsApproval: options.needsApproval ?? options.agents === undefined,
58
- }));
59
- const cursorGrokBotAgents = defineExtension({
60
- root: import.meta.dirname,
61
- description: "Talk to your Grok Bot agents and read their replies.",
62
- config,
63
- });
64
- export default cursorGrokBotAgents;
@@ -1,11 +0,0 @@
1
- /**
2
- * Which Grok Bot agent a call addresses. The model names one per call, but
3
- * the author's `agents` are the allowlist: with them configured, a name
4
- * outside the list is refused (the backend would create an agent of that
5
- * name), and a lone configured agent stands in when the call names none.
6
- * Matching is case-insensitive and resolves to the configured spelling,
7
- * since the backend looks names up exactly.
8
- */
9
- import type { ConfiguredGrokBotAgent } from "../extension.js";
10
- export declare function resolveAgentName(requested: string | undefined, configured: ConfiguredGrokBotAgent[] | undefined): string;
11
- //# sourceMappingURL=agents.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/agents.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAE9D,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,UAAU,EAAE,sBAAsB,EAAE,GAAG,SAAS,GAC/C,MAAM,CA2BR"}
@@ -1,31 +0,0 @@
1
- /**
2
- * Which Grok Bot agent a call addresses. The model names one per call, but
3
- * the author's `agents` are the allowlist: with them configured, a name
4
- * outside the list is refused (the backend would create an agent of that
5
- * name), and a lone configured agent stands in when the call names none.
6
- * Matching is case-insensitive and resolves to the configured spelling,
7
- * since the backend looks names up exactly.
8
- */
9
- export function resolveAgentName(requested, configured) {
10
- const name = requested?.trim();
11
- if (configured === undefined) {
12
- if (name === undefined || name === "") {
13
- throw new Error("`agent` is required: this extension has no configured Grok Bot agents.");
14
- }
15
- return name;
16
- }
17
- const names = configured.map((agent) => `"${agent.name}"`).join(", ");
18
- if (name === undefined || name === "") {
19
- const only = configured.length === 1 ? configured[0] : undefined;
20
- if (only === undefined) {
21
- throw new Error(`\`agent\` is required: this extension configures several Grok Bot agents (${names}).`);
22
- }
23
- return only.name;
24
- }
25
- const match = configured.find((agent) => agent.name === name) ??
26
- configured.find((agent) => agent.name.toLowerCase() === name.toLowerCase());
27
- if (match === undefined) {
28
- throw new Error(`"${name}" is not one of this extension's configured Grok Bot agents (${names}).`);
29
- }
30
- return match.name;
31
- }
@@ -1,56 +0,0 @@
1
- /**
2
- * The `/v0/grokbot` session API as the tools use it. Four routes on the
3
- * external API host (`api.cursor.com`; they 404 on api2), under the host's
4
- * Cursor API key. A session is a hosted Grok Bot agent of the key's
5
- * account, get-or-created by name; messages go into its one conversation,
6
- * and the transcript is read back as entries after a cursor, with the
7
- * turn's status alongside.
8
- */
9
- export declare class GrokBotApiError extends Error {
10
- readonly status?: number | undefined;
11
- constructor(message: string, status?: number | undefined);
12
- }
13
- export type GrokBotSession = {
14
- /** The hosted agent's durable id; every other route addresses it. */
15
- sessionId: string;
16
- /** The name as the backend stores it (trimmed). */
17
- name: string;
18
- createdAtMs: number;
19
- /** Transcript tail: reading after it skips the conversation's history. */
20
- latestUpdatedSeq: string;
21
- };
22
- export type GrokBotEntry = {
23
- seq: string;
24
- updatedSeq: string;
25
- kind: string;
26
- role?: string;
27
- text?: string;
28
- createdAtMs: number;
29
- };
30
- export type GrokBotTurnStatus = {
31
- idle: boolean;
32
- inFlight: boolean;
33
- queued: number;
34
- };
35
- export type GrokBotEntriesPage = {
36
- entries: GrokBotEntry[];
37
- latestUpdatedSeq: string;
38
- turn: GrokBotTurnStatus;
39
- };
40
- export declare class GrokBotAgentsBackend {
41
- private readonly apiKey;
42
- private readonly fetchImpl;
43
- constructor(apiKey: () => string, fetchImpl?: typeof fetch);
44
- /** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
45
- session(name: string): Promise<GrokBotSession>;
46
- /** Deliver one user message to the agent's conversation. */
47
- send(sessionId: string, text: string): Promise<void>;
48
- /** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
49
- entries(sessionId: string, afterUpdatedSeq: string): Promise<GrokBotEntriesPage>;
50
- interrupt(sessionId: string, reason: string): Promise<void>;
51
- private request;
52
- }
53
- /** The process-wide backend for this mount, built on first use. */
54
- export declare function grokBotAgentsBackend(): GrokBotAgentsBackend;
55
- export declare function apiKey(): string;
56
- //# sourceMappingURL=backend.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/backend.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,qBAAa,eAAgB,SAAQ,KAAK;IAGtC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAF1B,YACE,OAAO,EAAE,MAAM,EACN,MAAM,CAAC,EAAE,MAAM,YAAA,EAIzB;CACF;AAGD,MAAM,MAAM,cAAc,GAAG;IAC3B,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,IAAI,EAAE,iBAAiB,CAAC;CACzB,CAAC;AAiCF,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAF5B,YACmB,MAAM,EAAE,MAAM,MAAM,EACpB,SAAS,GAAE,OAAO,KAAa,EAC9C;IAEJ,2FAA2F;IACrF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAYnD;IAED,4DAA4D;IACtD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYzD;IAED,wFAAwF;IAClF,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAOrF;IAEK,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;YAEa,OAAO;CA+BtB;AAID,mEAAmE;AACnE,wBAAgB,oBAAoB,IAAI,oBAAoB,CAG3D;AAED,wBAAgB,MAAM,IAAI,MAAM,CAO/B"}
@@ -1,139 +0,0 @@
1
- /**
2
- * The `/v0/grokbot` session API as the tools use it. Four routes on the
3
- * external API host (`api.cursor.com`; they 404 on api2), under the host's
4
- * Cursor API key. A session is a hosted Grok Bot agent of the key's
5
- * account, get-or-created by name; messages go into its one conversation,
6
- * and the transcript is read back as entries after a cursor, with the
7
- * turn's status alongside.
8
- */
9
- import { randomUUID } from "node:crypto";
10
- import * as z from "zod/v4";
11
- import { cursorExternalApiUrl, resolveApiKeySync, SIGN_IN_HINT, } from "../../../internal/cursor/credentials.js";
12
- import extension from "../extension.js";
13
- import { isRecord } from "../../../internal/is-record.js";
14
- const REQUEST_TIMEOUT_MS = 60_000;
15
- export class GrokBotApiError extends Error {
16
- constructor(message, status) {
17
- super(message);
18
- this.status = status;
19
- this.name = "GrokBotApiError";
20
- }
21
- }
22
- const sessionSchema = z.object({
23
- id: z.string(),
24
- name: z.string(),
25
- createdAtMs: z.number(),
26
- latestUpdatedSeq: z.string(),
27
- });
28
- const sendSchema = z.object({
29
- messageId: z.string(),
30
- delivery: z.string(),
31
- });
32
- const entriesSchema = z.object({
33
- entries: z.array(z.object({
34
- seq: z.string(),
35
- updatedSeq: z.string(),
36
- kind: z.string(),
37
- role: z.string().optional(),
38
- text: z.string().optional(),
39
- createdAtMs: z.number(),
40
- })),
41
- latestUpdatedSeq: z.string(),
42
- turn: z.object({
43
- idle: z.boolean(),
44
- inFlight: z.boolean(),
45
- queued: z.number(),
46
- }),
47
- });
48
- export class GrokBotAgentsBackend {
49
- constructor(apiKey, fetchImpl = fetch) {
50
- this.apiKey = apiKey;
51
- this.fetchImpl = fetchImpl;
52
- }
53
- /** `POST /v0/grokbot/sessions`: the account's agent of that name, created when missing. */
54
- async session(name) {
55
- // No `instructions`: the agent is somebody's, configured in the app, and
56
- // an omitted field never touches its stored profile.
57
- const parsed = sessionSchema.parse(await this.request("POST", "/v0/grokbot/sessions", { name }));
58
- return {
59
- sessionId: parsed.id,
60
- name: parsed.name,
61
- createdAtMs: parsed.createdAtMs,
62
- latestUpdatedSeq: parsed.latestUpdatedSeq,
63
- };
64
- }
65
- /** Deliver one user message to the agent's conversation. */
66
- async send(sessionId, text) {
67
- const { delivery } = sendSchema.parse(await this.request("POST", `/v0/grokbot/sessions/${sessionId}/messages`, {
68
- text,
69
- messageId: randomUUID(),
70
- }));
71
- if (delivery !== "accepted_temporal" && delivery !== "duplicate") {
72
- throw new GrokBotApiError(`The Grok Bot agent's harness did not accept the message (delivery: ${delivery}).`);
73
- }
74
- }
75
- /** Transcript entries after `afterUpdatedSeq`, oldest first, with the turn's status. */
76
- async entries(sessionId, afterUpdatedSeq) {
77
- return entriesSchema.parse(await this.request("GET", `/v0/grokbot/sessions/${sessionId}/entries?afterUpdatedSeq=${encodeURIComponent(afterUpdatedSeq)}`));
78
- }
79
- async interrupt(sessionId, reason) {
80
- await this.request("POST", `/v0/grokbot/sessions/${sessionId}/interrupt`, {
81
- reason,
82
- });
83
- }
84
- async request(method, path, body) {
85
- const headers = {
86
- authorization: `Bearer ${this.apiKey()}`,
87
- "x-cursor-client-type": "agent-serve",
88
- "x-request-id": randomUUID(),
89
- };
90
- if (body !== undefined) {
91
- headers["content-type"] = "application/json";
92
- }
93
- let response;
94
- try {
95
- response = await this.fetchImpl(`${cursorExternalApiUrl()}${path}`, {
96
- method,
97
- headers,
98
- body: body === undefined ? undefined : JSON.stringify(body),
99
- signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
100
- });
101
- }
102
- catch (error) {
103
- throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed: ${error instanceof Error ? error.message : String(error)}`);
104
- }
105
- const text = await response.text();
106
- if (!response.ok) {
107
- throw new GrokBotApiError(`Grok Bot API ${method} ${path} failed (${response.status}): ${apiErrorMessage(text)}`, response.status);
108
- }
109
- return JSON.parse(text);
110
- }
111
- }
112
- let backend;
113
- /** The process-wide backend for this mount, built on first use. */
114
- export function grokBotAgentsBackend() {
115
- backend ??= new GrokBotAgentsBackend(apiKey);
116
- return backend;
117
- }
118
- export function apiKey() {
119
- // Read per call: the host can sign in after the mount.
120
- const key = resolveApiKeySync({ apiKey: extension.config.apiKey });
121
- if (key === undefined) {
122
- throw new Error(`Grok Bot agents need a Cursor API key. ${SIGN_IN_HINT}`);
123
- }
124
- return key.apiKey;
125
- }
126
- /** The route's `{ error }` envelope when it is one, the raw body otherwise. */
127
- function apiErrorMessage(text) {
128
- try {
129
- const parsed = JSON.parse(text);
130
- const message = isRecord(parsed) ? (parsed.error ?? parsed.message) : undefined;
131
- if (typeof message === "string" && message !== "") {
132
- return message;
133
- }
134
- }
135
- catch {
136
- // Not JSON; fall through to the raw body.
137
- }
138
- return text.slice(0, 300);
139
- }
@@ -1,28 +0,0 @@
1
- /**
2
- * Who has talked to which Grok Bot agent, and how far into its transcript
3
- * they have read. The tools authenticate with the serve host's one Cursor
4
- * API key, so every agent is that account's; what the host keeps per
5
- * principal is the read cursor, so `check` returns what the agent said
6
- * since that caller last read, and a lookup by name for `check` and
7
- * `interrupt`, which never create an agent the caller has not spoken to.
8
- */
9
- import type { ToolContext } from "../../../types.js";
10
- export type Contact = {
11
- /** The agent's name as the backend stores it. */
12
- name: string;
13
- /** The hosted agent's `/v0/grokbot` session id. */
14
- sessionId: string;
15
- /** Newest transcript `updatedSeq` this principal has read. */
16
- cursor: string;
17
- firstContactAt: string;
18
- lastContactAt: string;
19
- };
20
- /** Unauthenticated sessions (local dev, direct calls) share one principal. */
21
- export declare function principalOf(ctx: ToolContext): string;
22
- /** The caller's contacts, most recently spoken to first. */
23
- export declare function listContacts(ctx: ToolContext): Promise<Contact[]>;
24
- /** The contact of that name, exact spelling first, then case-insensitively. */
25
- export declare function findContact(contacts: Contact[], name: string): Contact | undefined;
26
- /** Insert or replace the caller's record of one agent, newest first. */
27
- export declare function saveContact(ctx: ToolContext, contact: Contact): Promise<void>;
28
- //# sourceMappingURL=contacts.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/contacts.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAMrD,MAAM,MAAM,OAAO,GAAG;IACpB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAcF,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,GAAG,EAAE,WAAW,GAAG,MAAM,CAGpD;AAED,4DAA4D;AAC5D,wBAAsB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGvE;AAED,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMlF;AAED,wEAAwE;AACxE,wBAAsB,WAAW,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAQnF"}
@@ -1,46 +0,0 @@
1
- /**
2
- * Who has talked to which Grok Bot agent, and how far into its transcript
3
- * they have read. The tools authenticate with the serve host's one Cursor
4
- * API key, so every agent is that account's; what the host keeps per
5
- * principal is the read cursor, so `check` returns what the agent said
6
- * since that caller last read, and a lookup by name for `check` and
7
- * `interrupt`, which never create an agent the caller has not spoken to.
8
- */
9
- import * as z from "zod/v4";
10
- import { KeyedLock } from "./lock.js";
11
- const PREFIX = "grokbot-agents";
12
- const contactsSchema = z.array(z.object({
13
- name: z.string(),
14
- sessionId: z.string(),
15
- cursor: z.string(),
16
- firstContactAt: z.string(),
17
- lastContactAt: z.string(),
18
- }));
19
- const locks = new KeyedLock();
20
- /** Unauthenticated sessions (local dev, direct calls) share one principal. */
21
- export function principalOf(ctx) {
22
- const auth = ctx.session.auth;
23
- return auth === null ? "anonymous" : `${auth.principalType}:${auth.principalId}`;
24
- }
25
- /** The caller's contacts, most recently spoken to first. */
26
- export async function listContacts(ctx) {
27
- const contacts = contactsSchema.safeParse(await ctx.host.kv.get(contactsKey(principalOf(ctx))));
28
- return contacts.success ? contacts.data : [];
29
- }
30
- /** The contact of that name, exact spelling first, then case-insensitively. */
31
- export function findContact(contacts, name) {
32
- const wanted = name.trim();
33
- return (contacts.find((contact) => contact.name === wanted) ??
34
- contacts.find((contact) => contact.name.toLowerCase() === wanted.toLowerCase()));
35
- }
36
- /** Insert or replace the caller's record of one agent, newest first. */
37
- export async function saveContact(ctx, contact) {
38
- const key = contactsKey(principalOf(ctx));
39
- await locks.run(key, async () => {
40
- const others = (await listContacts(ctx)).filter((existing) => existing.sessionId !== contact.sessionId);
41
- await ctx.host.kv.put(key, [contact, ...others]);
42
- });
43
- }
44
- function contactsKey(principal) {
45
- return `${PREFIX}/principals/${encodeURIComponent(principal)}`;
46
- }
@@ -1,53 +0,0 @@
1
- /**
2
- * One exchange with a hosted Grok Bot agent: send a user message, then
3
- * read the transcript until the agent's turn settles. Only `send-message`
4
- * entries (what the agent delivers through SendToUser) are the reply; its
5
- * internal work never appears in the transcript. Waits are bounded, so a
6
- * long turn comes back as `running` and `check` picks it up from the
7
- * caller's cursor.
8
- *
9
- * Sends and reads on one hosted agent are chained within this process, and
10
- * a send waits for an in-flight turn to settle first, so a reply always
11
- * attributes to the message that prompted it.
12
- */
13
- import type { ToolContext } from "../../../types.js";
14
- export declare const DEFAULT_WAIT_SECONDS = 120;
15
- export declare const MAX_WAIT_SECONDS = 600;
16
- export type ReplyStatus = "finished" | "running";
17
- export type AskResult = {
18
- agent: string;
19
- sessionId: string;
20
- status: ReplyStatus;
21
- /** What the agent sent back, in order; absent when it sent nothing (yet). */
22
- reply?: string;
23
- /** Replies to earlier messages that this caller had not read yet. */
24
- earlierReplies?: string[];
25
- /** The account had no agent of that name; this call created an empty one. */
26
- created?: true;
27
- note?: string;
28
- };
29
- export type CheckResult = {
30
- agent: string;
31
- sessionId: string;
32
- status: ReplyStatus;
33
- reply?: string;
34
- note?: string;
35
- };
36
- export type InterruptResult = {
37
- agent: string;
38
- sessionId: string;
39
- interrupted: true;
40
- };
41
- export declare function ask(ctx: ToolContext, input: {
42
- agent?: string;
43
- message: string;
44
- waitSeconds: number;
45
- }): Promise<AskResult>;
46
- export declare function check(ctx: ToolContext, input: {
47
- agent?: string;
48
- waitSeconds: number;
49
- }): Promise<CheckResult>;
50
- export declare function interrupt(ctx: ToolContext, input: {
51
- agent?: string;
52
- }): Promise<InterruptResult>;
53
- //# sourceMappingURL=conversation.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/conversation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAWrD,eAAO,MAAM,oBAAoB,MAAM,CAAC;AACxC,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAkBpC,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,CAAC;AAGjD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,IAAI,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,IAAI,CAAC;CACnB,CAAC;AAWF,wBAAsB,GAAG,CACvB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D,OAAO,CAAC,SAAS,CAAC,CA0DpB;AAED,wBAAsB,KAAK,CACzB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,WAAW,CAAC,CAsBtB;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB,OAAO,CAAC,eAAe,CAAC,CAQ1B"}
@@ -1,186 +0,0 @@
1
- /**
2
- * One exchange with a hosted Grok Bot agent: send a user message, then
3
- * read the transcript until the agent's turn settles. Only `send-message`
4
- * entries (what the agent delivers through SendToUser) are the reply; its
5
- * internal work never appears in the transcript. Waits are bounded, so a
6
- * long turn comes back as `running` and `check` picks it up from the
7
- * caller's cursor.
8
- *
9
- * Sends and reads on one hosted agent are chained within this process, and
10
- * a send waits for an in-flight turn to settle first, so a reply always
11
- * attributes to the message that prompted it.
12
- */
13
- import extension from "../extension.js";
14
- import { resolveAgentName } from "./agents.js";
15
- import { grokBotAgentsBackend, } from "./backend.js";
16
- import { findContact, listContacts, saveContact } from "./contacts.js";
17
- import { KeyedLock } from "./lock.js";
18
- export const DEFAULT_WAIT_SECONDS = 120;
19
- export const MAX_WAIT_SECONDS = 600;
20
- /**
21
- * Idle polls required before a turn counts as settled when the workflow
22
- * never reported busy: covers the window between an accepted send and the
23
- * workflow picking the signal up, which a `check` right after a short `ask`
24
- * can still be inside.
25
- */
26
- const MIN_IDLE_POLLS_WITHOUT_BUSY = 4;
27
- /**
28
- * A session whose row is this young, and whose transcript is still empty,
29
- * was created by the call that fetched it; the allowance covers clock skew
30
- * between this host and the backend.
31
- */
32
- const CREATED_WINDOW_MS = 60_000;
33
- /** The transcript tail of an agent nobody has spoken to. */
34
- const EMPTY_TRANSCRIPT_TAIL = "-1";
35
- const agentLocks = new KeyedLock();
36
- export async function ask(ctx, input) {
37
- const name = resolveAgentName(input.agent, extension.config.agents);
38
- const backend = grokBotAgentsBackend();
39
- const startedAt = Date.now();
40
- const session = await backend.session(name);
41
- return agentLocks.run(session.sessionId, async () => {
42
- const contact = (await listContacts(ctx)).find((candidate) => candidate.sessionId === session.sessionId);
43
- const created = contact === undefined &&
44
- session.latestUpdatedSeq === EMPTY_TRANSCRIPT_TAIL &&
45
- session.createdAtMs >= startedAt - CREATED_WINDOW_MS;
46
- const deadline = Date.now() + input.waitSeconds * 1000;
47
- // A turn already in flight, from an earlier message or from the person
48
- // in the app, must settle first; otherwise its deliveries would read as
49
- // the reply to this message. Nothing is persisted on the way out, so
50
- // `check` still returns whatever landed meanwhile.
51
- const before = await collectReplies(backend, session.sessionId, {
52
- cursor: contact?.cursor ?? session.latestUpdatedSeq,
53
- deadline,
54
- confirmIdle: false,
55
- });
56
- if (before.status === "running") {
57
- throw new Error(`"${session.name}" is still working on an earlier message; nothing was sent. Call check to read that reply, wait, or interrupt it.`);
58
- }
59
- await backend.send(session.sessionId, input.message);
60
- const replies = await collectReplies(backend, session.sessionId, {
61
- cursor: before.cursor,
62
- deadline,
63
- confirmIdle: true,
64
- });
65
- const now = ctx.now().toISOString();
66
- await saveContact(ctx, {
67
- name: session.name,
68
- sessionId: session.sessionId,
69
- cursor: replies.cursor,
70
- firstContactAt: contact?.firstContactAt ?? now,
71
- lastContactAt: now,
72
- });
73
- const notes = [
74
- created
75
- ? `No Grok Bot agent named "${session.name}" existed on this account, so an empty one was created. Check the name if that is unexpected.`
76
- : undefined,
77
- runningNote(session.name, replies.status),
78
- ].filter((note) => note !== undefined);
79
- return {
80
- agent: session.name,
81
- sessionId: session.sessionId,
82
- status: replies.status,
83
- reply: joinReplies(replies.deliveries),
84
- earlierReplies: before.deliveries.length === 0 ? undefined : before.deliveries,
85
- created: created ? true : undefined,
86
- note: notes.length === 0 ? undefined : notes.join(" "),
87
- };
88
- });
89
- }
90
- export async function check(ctx, input) {
91
- const contact = await knownContact(ctx, input.agent);
92
- const backend = grokBotAgentsBackend();
93
- return agentLocks.run(contact.sessionId, async () => {
94
- // Re-read under the lock: a parallel call may have moved the cursor.
95
- const current = (await listContacts(ctx)).find((candidate) => candidate.sessionId === contact.sessionId) ??
96
- contact;
97
- const replies = await collectReplies(backend, current.sessionId, {
98
- cursor: current.cursor,
99
- deadline: Date.now() + input.waitSeconds * 1000,
100
- confirmIdle: true,
101
- });
102
- await saveContact(ctx, { ...current, cursor: replies.cursor });
103
- return {
104
- agent: current.name,
105
- sessionId: current.sessionId,
106
- status: replies.status,
107
- reply: joinReplies(replies.deliveries),
108
- note: runningNote(current.name, replies.status),
109
- };
110
- });
111
- }
112
- export async function interrupt(ctx, input) {
113
- const contact = await knownContact(ctx, input.agent);
114
- await grokBotAgentsBackend().interrupt(contact.sessionId, "Interrupted from the Agent SDK.");
115
- return {
116
- agent: contact.name,
117
- sessionId: contact.sessionId,
118
- interrupted: true,
119
- };
120
- }
121
- /**
122
- * The caller's record of the named agent. Only `ask` resolves a name on the
123
- * backend, because that creates an agent when none matches; the other tools
124
- * reach agents the caller has already spoken to.
125
- */
126
- async function knownContact(ctx, requested) {
127
- const name = resolveAgentName(requested, extension.config.agents);
128
- const contact = findContact(await listContacts(ctx), name);
129
- if (contact === undefined) {
130
- throw new Error(`You have not asked "${name}" anything yet; call ask first.`);
131
- }
132
- return contact;
133
- }
134
- /**
135
- * Read the transcript after `cursor` until the agent's turn settles or the
136
- * deadline passes. Only an empty page can settle the turn, so a backlog
137
- * drains page by page first. With `confirmIdle`, an idle report may predate
138
- * the workflow picking a message up, so settling takes
139
- * {@link MIN_IDLE_POLLS_WITHOUT_BUSY} idle polls unless the turn was seen
140
- * busy; without it, the first idle report settles.
141
- */
142
- async function collectReplies(backend, sessionId, options) {
143
- const deliveries = [];
144
- let cursor = options.cursor;
145
- let sawBusy = false;
146
- let idlePolls = 0;
147
- while (true) {
148
- const page = await backend.entries(sessionId, cursor);
149
- cursor = page.latestUpdatedSeq;
150
- for (const entry of page.entries) {
151
- if (entry.kind === "send-message" && entry.text !== undefined) {
152
- deliveries.push(entry.text);
153
- }
154
- }
155
- const busy = isBusy(page.turn);
156
- if (busy) {
157
- sawBusy = true;
158
- }
159
- if (page.entries.length === 0 && !busy && page.turn.idle) {
160
- idlePolls += 1;
161
- if (sawBusy || !options.confirmIdle || idlePolls >= MIN_IDLE_POLLS_WITHOUT_BUSY) {
162
- return { status: "finished", deliveries, cursor };
163
- }
164
- }
165
- if (Date.now() >= options.deadline) {
166
- return { status: "running", deliveries, cursor };
167
- }
168
- await sleep(extension.config.pollIntervalMs);
169
- }
170
- }
171
- function isBusy(turn) {
172
- return turn.inFlight || turn.queued > 0;
173
- }
174
- function joinReplies(deliveries) {
175
- return deliveries.length === 0 ? undefined : deliveries.join("\n\n");
176
- }
177
- function runningNote(name, status) {
178
- return status === "running"
179
- ? `"${name}" is still replying. Call check with the same agent to keep waiting; a reply so far, if any, is above.`
180
- : undefined;
181
- }
182
- function sleep(ms) {
183
- return new Promise((resolve) => {
184
- setTimeout(resolve, ms);
185
- });
186
- }
@@ -1,4 +0,0 @@
1
- import * as z from "zod/v4";
2
- export declare const agentName: z.ZodOptional<z.ZodString>;
3
- export declare const waitSeconds: z.ZodDefault<z.ZodNumber>;
4
- //# sourceMappingURL=inputs.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../../../../src/extensions/cursor-grokbot-agents/lib/inputs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAM9C,CAAC;AAEJ,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAQ/C,CAAC"}