@grok/agent-sdk 0.3.0 → 0.5.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 (289) hide show
  1. package/dist/channels/match-ready/index.d.ts +4 -0
  2. package/dist/channels/match-ready/index.d.ts.map +1 -0
  3. package/dist/channels/match-ready/index.js +2 -0
  4. package/dist/channels/match-ready/match-ready-channel.d.ts +5 -0
  5. package/dist/channels/match-ready/match-ready-channel.d.ts.map +1 -0
  6. package/dist/channels/match-ready/match-ready-channel.js +42 -0
  7. package/dist/channels/match-ready/types.d.ts +25 -0
  8. package/dist/channels/match-ready/types.d.ts.map +1 -0
  9. package/dist/channels/match-ready/types.js +1 -0
  10. package/dist/channels/slack/slack-channel.d.ts.map +1 -1
  11. package/dist/channels/slack/slack-channel.js +27 -14
  12. package/dist/docs/404.html +2 -2
  13. package/dist/docs/assets/{app.BzTUBOAD.js → app.CYdjweqP.js} +4 -4
  14. package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.js → building-with-agents.md.Bo3ct-rf.js} +1 -1
  15. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +1 -0
  16. package/dist/docs/assets/changelog.md.BMrJ5WxW.lean.js +1 -0
  17. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +1 -0
  18. package/dist/docs/assets/chunks/{VPLocalSearchBox.DsnRlUT5.js → VPLocalSearchBox.CRATKS9J.js} +1 -1
  19. package/dist/docs/assets/chunks/{arc.DH8GOhiv.js → arc.BxM78ISR.js} +1 -1
  20. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.9m9ObyuE.js → architectureDiagram-Q4EWVU46.Bi6MuKaU.js} +1 -1
  21. package/dist/docs/assets/chunks/{baseUniq.BXHpx1lE.js → baseUniq.L47qqpDG.js} +1 -1
  22. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.xY3EX59q.js → blockDiagram-DXYQGD6D.kHFF2FK5.js} +1 -1
  23. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.DnqgMVgc.js → c4Diagram-AHTNJAMY.BTW85ll3.js} +1 -1
  24. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +1 -0
  25. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.BjFxK2A3.js → chunk-4BX2VUAB.Bbh3_48g.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.BujS_Spt.js → chunk-4TB4RGXK.WeAmK3fK.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-55IACEB6.YbTjhdaM.js → chunk-55IACEB6.DTdUiVHf.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DnQ8t4GC.js → chunk-EDXVE4YY.n5XzANDz.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.B67AwAmj.js → chunk-FMBD7UC4.D51eewCb.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.DrZIAFOm.js → chunk-OYMX7WX6.BrY0U7ZV.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.BLmmydkn.js → chunk-QZHKN3VN.B0OA4aFV.js} +1 -1
  32. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.DaoOfw0O.js → chunk-YZCP3GAM.Djt3Mjft.js} +1 -1
  33. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +1 -0
  34. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +1 -0
  35. package/dist/docs/assets/chunks/clone.BDtbEo69.js +1 -0
  36. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.DMQuNhM5.js → cose-bilkent-S5V4N54A.DiMcA6Q8.js} +1 -1
  37. package/dist/docs/assets/chunks/{dagre-KV5264BT.CZoGVuUf.js → dagre-KV5264BT.BGqI4vrS.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.CLt9uOyL.js → diagram-5BDNPKRD.bDqFuMoH.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.DpczEm1G.js → diagram-G4DWMVQ6.Y0sxaXRU.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.D4r13DvJ.js → diagram-MMDJMWI5.Bg43b0yi.js} +1 -1
  41. package/dist/docs/assets/chunks/{diagram-TYMM5635.CYU9eGFu.js → diagram-TYMM5635.DCfVasEC.js} +1 -1
  42. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.QA9naWEw.js → erDiagram-SMLLAGMA.C72GaD16.js} +1 -1
  43. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.BbNoVZYd.js → flowDiagram-DWJPFMVM.DxRQj7pP.js} +1 -1
  44. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.IHjDoG7r.js → ganttDiagram-T4ZO3ILL.DiLZy5Q4.js} +1 -1
  45. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B21VMdf5.js → gitGraphDiagram-UUTBAWPF.DL8XkRvh.js} +1 -1
  46. package/dist/docs/assets/chunks/{graph.DgJ4L-8V.js → graph.3Xub80xJ.js} +1 -1
  47. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.CQjrcthc.js → infoDiagram-42DDH7IO.O3lGaspu.js} +1 -1
  48. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D4tPGtVo.js → ishikawaDiagram-UXIWVN3A.w-pCiQzn.js} +1 -1
  49. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.BD3WaNbQ.js → journeyDiagram-VCZTEJTY.Cg_oBs9j.js} +1 -1
  50. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Ca0o4Tqz.js → kanban-definition-6JOO6SKY.BpfMGPwn.js} +1 -1
  51. package/dist/docs/assets/chunks/{layout.DXXqX4MQ.js → layout.CtwXs__p.js} +1 -1
  52. package/dist/docs/assets/chunks/{linear.5c61gNw4.js → linear.NmCskOrP.js} +1 -1
  53. package/dist/docs/assets/chunks/{min.B1-NAjHX.js → min.DpQtsLKs.js} +1 -1
  54. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BELznv3-.js → mindmap-definition-QFDTVHPH.B-P-aKVp.js} +1 -1
  55. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.qPzO1mq5.js → pieDiagram-DEJITSTG.BfjjqK7j.js} +1 -1
  56. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.CxIvzbjX.js → quadrantDiagram-34T5L4WZ.BTzHo53F.js} +1 -1
  57. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.CqA0iJx8.js → requirementDiagram-MS252O5E.DIT2FIKr.js} +1 -1
  58. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.XRTutBnb.js → sankeyDiagram-XADWPNL6.NK1wCsgt.js} +1 -1
  59. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.E--7bRLQ.js → sequenceDiagram-FGHM5R23.D9oElkvo.js} +1 -1
  60. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.C4vGu8zq.js → stateDiagram-FHFEXIEX.IPksnixH.js} +1 -1
  61. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +1 -0
  62. package/dist/docs/assets/chunks/{theme.DMj_7q3B.js → theme.CgKu7tr3.js} +2 -2
  63. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.C7LgNVAL.js → timeline-definition-GMOUNBTQ.CuAtJapY.js} +1 -1
  64. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.HUwoZcy_.js → vennDiagram-DHZGUBPP.B87nNW9E.js} +1 -1
  65. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +162 -0
  66. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.B2pSo5rB.js → wardleyDiagram-NUSXRM2D.BELjSq8w.js} +1 -1
  67. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.NQhMiOOL.js → xychartDiagram-5P7HB3ND.5zN5ZGsz.js} +1 -1
  68. package/dist/docs/assets/{deployment.md.BtqJrHhp.js → deployment.md.DJtuDVLh.js} +3 -3
  69. package/dist/docs/assets/{deployment.md.BtqJrHhp.lean.js → deployment.md.DJtuDVLh.lean.js} +1 -1
  70. package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.js → guides_agent-to-agent.md.DcB3nhOz.js} +1 -1
  71. package/dist/docs/assets/{guides_github.md.6jiEH7dg.js → guides_github.md.CcuZ7keS.js} +1 -1
  72. package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.js → guides_mcp-oauth.md.GVPMKcYl.js} +1 -1
  73. package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.js → guides_migrate.md.B8CZxnnX.js} +1 -1
  74. package/dist/docs/assets/{guides_slack.md.BgIGG9ur.js → guides_slack.md.D7Rwyva4.js} +1 -1
  75. package/dist/docs/assets/{hillclimbing.md.3TkdF79A.js → hillclimbing.md.M51bF-oT.js} +1 -1
  76. package/dist/docs/assets/index.md.DnJPj_B6.js +14 -0
  77. package/dist/docs/assets/index.md.DnJPj_B6.lean.js +1 -0
  78. package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.js → reference_agent-config.md.Bbqf0lgS.js} +13 -5
  79. package/dist/docs/assets/{reference_agent-config.md.C0Tp_Fk9.lean.js → reference_agent-config.md.Bbqf0lgS.lean.js} +1 -1
  80. package/dist/docs/assets/{reference_cli.md.B8GdpaRj.js → reference_cli.md.DHm6DmYk.js} +2 -2
  81. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.js → reference_hooks.md.vbIM394-.js} +2 -2
  82. package/dist/docs/assets/{reference_hooks.md.CSWmOwMM.lean.js → reference_hooks.md.vbIM394-.lean.js} +1 -1
  83. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.js → reference_tools.md.BhqW6neF.js} +4 -2
  84. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.lean.js → reference_tools.md.BhqW6neF.lean.js} +1 -1
  85. package/dist/docs/building-with-agents.html +36 -36
  86. package/dist/docs/building-with-agents.md +3 -3
  87. package/dist/docs/changelog.html +36 -36
  88. package/dist/docs/changelog.md +44 -1
  89. package/dist/docs/deployment.html +37 -37
  90. package/dist/docs/deployment.md +22 -16
  91. package/dist/docs/evals.html +35 -35
  92. package/dist/docs/guides/agent-to-agent.html +37 -37
  93. package/dist/docs/guides/agent-to-agent.md +4 -2
  94. package/dist/docs/guides/bitbucket.html +35 -35
  95. package/dist/docs/guides/cloud-agents.html +35 -35
  96. package/dist/docs/guides/convert-automation.html +35 -35
  97. package/dist/docs/guides/github.html +37 -37
  98. package/dist/docs/guides/github.md +1 -1
  99. package/dist/docs/guides/gitlab.html +35 -35
  100. package/dist/docs/guides/improve.html +35 -35
  101. package/dist/docs/guides/jev.html +35 -35
  102. package/dist/docs/guides/mcp-oauth.html +37 -37
  103. package/dist/docs/guides/mcp-oauth.md +1 -1
  104. package/dist/docs/guides/migrate.html +37 -37
  105. package/dist/docs/guides/migrate.md +1 -1
  106. package/dist/docs/guides/opentelemetry.html +35 -35
  107. package/dist/docs/guides/pagerduty.html +35 -35
  108. package/dist/docs/guides/slack.html +37 -37
  109. package/dist/docs/guides/slack.md +1 -1
  110. package/dist/docs/guides/webhooks.html +35 -35
  111. package/dist/docs/hashmap.json +1 -1
  112. package/dist/docs/hillclimbing.html +36 -36
  113. package/dist/docs/hillclimbing.md +1 -1
  114. package/dist/docs/index.html +42 -48
  115. package/dist/docs/index.md +8 -14
  116. package/dist/docs/llms-full.txt +176 -54
  117. package/dist/docs/quickstart.html +35 -35
  118. package/dist/docs/reference/access.html +35 -35
  119. package/dist/docs/reference/agent-config.html +47 -39
  120. package/dist/docs/reference/agent-config.md +75 -10
  121. package/dist/docs/reference/artifacts.html +35 -35
  122. package/dist/docs/reference/channels.html +35 -35
  123. package/dist/docs/reference/cli.html +38 -38
  124. package/dist/docs/reference/cli.md +2 -2
  125. package/dist/docs/reference/connections.html +35 -35
  126. package/dist/docs/reference/evals.html +35 -35
  127. package/dist/docs/reference/extensions.html +35 -35
  128. package/dist/docs/reference/hooks.html +37 -37
  129. package/dist/docs/reference/hooks.md +1 -1
  130. package/dist/docs/reference/http-api.html +35 -35
  131. package/dist/docs/reference/instructions.html +35 -35
  132. package/dist/docs/reference/limits.html +35 -35
  133. package/dist/docs/reference/memory.html +35 -35
  134. package/dist/docs/reference/playground.html +35 -35
  135. package/dist/docs/reference/project-layout.html +35 -35
  136. package/dist/docs/reference/schedules.html +35 -35
  137. package/dist/docs/reference/sessions.html +35 -35
  138. package/dist/docs/reference/skills.html +35 -35
  139. package/dist/docs/reference/subagents.html +35 -35
  140. package/dist/docs/reference/tools.html +39 -37
  141. package/dist/docs/reference/tools.md +12 -0
  142. package/dist/docs/templates/agentic-owners.html +35 -35
  143. package/dist/docs/templates/reviews.html +35 -35
  144. package/dist/docs/troubleshooting.html +35 -35
  145. package/dist/filesystem.d.ts +12 -412
  146. package/dist/filesystem.d.ts.map +1 -1
  147. package/dist/filesystem.js +37 -980
  148. package/dist/index.d.ts +1 -3
  149. package/dist/index.d.ts.map +1 -1
  150. package/dist/index.js +1 -3
  151. package/dist/internal/authored-alias-hooks.d.ts +6 -0
  152. package/dist/internal/authored-alias-hooks.d.ts.map +1 -1
  153. package/dist/internal/authored-alias-hooks.js +12 -0
  154. package/dist/internal/authored-loaders.js +10 -1
  155. package/dist/internal/cli/commands/scaffold.js +1 -1
  156. package/dist/internal/continuation-channel.d.ts +3 -3
  157. package/dist/internal/continuation-channel.js +3 -3
  158. package/dist/internal/continuation-identity.d.ts +6 -5
  159. package/dist/internal/continuation-identity.d.ts.map +1 -1
  160. package/dist/internal/continuation-identity.js +17 -2
  161. package/dist/internal/continuation-session-ids.d.ts +15 -0
  162. package/dist/internal/continuation-session-ids.d.ts.map +1 -0
  163. package/dist/internal/continuation-session-ids.js +43 -0
  164. package/dist/internal/direct-file-tools.d.ts +21 -0
  165. package/dist/internal/direct-file-tools.d.ts.map +1 -0
  166. package/dist/internal/direct-file-tools.js +60 -0
  167. package/dist/internal/discovery/agent.d.ts.map +1 -1
  168. package/dist/internal/discovery/agent.js +71 -66
  169. package/dist/internal/filesystem/walk.d.ts +4 -56
  170. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  171. package/dist/internal/filesystem/walk.js +4 -198
  172. package/dist/internal/hosted-catch-protocol.d.ts +3 -3
  173. package/dist/internal/hosted-catch-protocol.js +3 -3
  174. package/dist/internal/hosted-fetch.d.ts +7 -0
  175. package/dist/internal/hosted-fetch.d.ts.map +1 -0
  176. package/dist/internal/hosted-fetch.js +26 -0
  177. package/dist/internal/hosted-managed-automation.js +1 -1
  178. package/dist/internal/install-cursor-skills.d.ts +5 -6
  179. package/dist/internal/install-cursor-skills.d.ts.map +1 -1
  180. package/dist/internal/install-cursor-skills.js +19 -4
  181. package/dist/internal/mcp-endpoint.js +4 -4
  182. package/dist/internal/model-config.d.ts.map +1 -1
  183. package/dist/internal/model-config.js +11 -4
  184. package/dist/internal/otel/http.d.ts +2 -1
  185. package/dist/internal/otel/http.d.ts.map +1 -1
  186. package/dist/internal/otel/http.js +2 -3
  187. package/dist/internal/platform-timers.d.ts +3 -7
  188. package/dist/internal/platform-timers.d.ts.map +1 -1
  189. package/dist/internal/platform-timers.js +10 -51
  190. package/dist/internal/sdk-runner.d.ts.map +1 -1
  191. package/dist/internal/sdk-runner.js +22 -40
  192. package/dist/internal/server.d.ts.map +1 -1
  193. package/dist/internal/server.js +6 -1
  194. package/dist/internal/session-engine.d.ts +36 -19
  195. package/dist/internal/session-engine.d.ts.map +1 -1
  196. package/dist/internal/session-engine.js +182 -254
  197. package/dist/internal/tool-paths.d.ts +8 -0
  198. package/dist/internal/tool-paths.d.ts.map +1 -0
  199. package/dist/internal/tool-paths.js +12 -0
  200. package/dist/internal/workspace-tree.d.ts +27 -0
  201. package/dist/internal/workspace-tree.d.ts.map +1 -0
  202. package/dist/internal/workspace-tree.js +106 -0
  203. package/dist/playground/assets/index-D0-FHg1x.css +1 -0
  204. package/dist/playground/assets/index-D5SLKUy6.js +62 -0
  205. package/dist/playground/index.html +2 -2
  206. package/dist/types.d.ts +43 -23
  207. package/dist/types.d.ts.map +1 -1
  208. package/dist/types.js +2 -2
  209. package/docs/README.md +8 -14
  210. package/docs/building-with-agents.md +3 -3
  211. package/docs/changelog.md +44 -1
  212. package/docs/deployment.md +22 -16
  213. package/docs/guides/agent-to-agent.md +4 -2
  214. package/docs/guides/github.md +1 -1
  215. package/docs/guides/mcp-oauth.md +1 -1
  216. package/docs/guides/migrate.md +1 -1
  217. package/docs/guides/slack.md +1 -1
  218. package/docs/hillclimbing.md +1 -1
  219. package/docs/reference/agent-config.md +75 -10
  220. package/docs/reference/cli.md +2 -2
  221. package/docs/reference/hooks.md +1 -1
  222. package/docs/reference/tools.md +12 -0
  223. package/package.json +10 -15
  224. package/skills/cli/SKILL.md +1 -1
  225. package/skills/create-agent/SKILL.md +61 -7
  226. package/skills/debug/SKILL.md +1 -1
  227. package/skills/deploy/SKILL.md +3 -3
  228. package/skills/evals/SKILL.md +1 -1
  229. package/skills/framework-map/SKILL.md +2 -2
  230. package/skills/github/SKILL.md +1 -1
  231. package/skills/hillclimb/SKILL.md +1 -1
  232. package/skills/mcp-auth/SKILL.md +1 -1
  233. package/skills/migrate-v2/SKILL.md +2 -2
  234. package/skills/otel/SKILL.md +1 -1
  235. package/skills/setup-slack/SKILL.md +2 -2
  236. package/dist/docs/assets/changelog.md.BWhC6DET.js +0 -1
  237. package/dist/docs/assets/changelog.md.BWhC6DET.lean.js +0 -1
  238. package/dist/docs/assets/chunks/@localSearchIndexroot.CWxwVoCG.js +0 -1
  239. package/dist/docs/assets/chunks/channel.Cctv0f7X.js +0 -1
  240. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.DU5sqchW.js +0 -1
  241. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.DU5sqchW.js +0 -1
  242. package/dist/docs/assets/chunks/clone.B9rdNt6j.js +0 -1
  243. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.ECMu2BdJ.js +0 -1
  244. package/dist/docs/assets/chunks/wardley-RL74JXVD.BxFEFYZS.js +0 -162
  245. package/dist/docs/assets/index.md.DRfaoRCZ.js +0 -20
  246. package/dist/docs/assets/index.md.DRfaoRCZ.lean.js +0 -1
  247. package/dist/executors.d.ts +0 -11
  248. package/dist/executors.d.ts.map +0 -1
  249. package/dist/executors.js +0 -21
  250. package/dist/internal/filesystem/errors.d.ts +0 -64
  251. package/dist/internal/filesystem/errors.d.ts.map +0 -1
  252. package/dist/internal/filesystem/errors.js +0 -180
  253. package/dist/internal/filesystem/format.d.ts +0 -28
  254. package/dist/internal/filesystem/format.d.ts.map +0 -1
  255. package/dist/internal/filesystem/format.js +0 -209
  256. package/dist/internal/filesystem/merge.d.ts +0 -34
  257. package/dist/internal/filesystem/merge.d.ts.map +0 -1
  258. package/dist/internal/filesystem/merge.js +0 -154
  259. package/dist/internal/filesystem/nearest.d.ts +0 -15
  260. package/dist/internal/filesystem/nearest.d.ts.map +0 -1
  261. package/dist/internal/filesystem/nearest.js +0 -90
  262. package/dist/internal/filesystem/scratch.d.ts +0 -60
  263. package/dist/internal/filesystem/scratch.d.ts.map +0 -1
  264. package/dist/internal/filesystem/scratch.js +0 -187
  265. package/dist/internal/filesystem/sdk-schemas.d.ts +0 -29
  266. package/dist/internal/filesystem/sdk-schemas.d.ts.map +0 -1
  267. package/dist/internal/filesystem/sdk-schemas.js +0 -148
  268. package/dist/internal/filesystem/subagent-inherit.d.ts +0 -39
  269. package/dist/internal/filesystem/subagent-inherit.d.ts.map +0 -1
  270. package/dist/internal/filesystem/subagent-inherit.js +0 -96
  271. package/dist/internal/filesystem/tools.d.ts +0 -59
  272. package/dist/internal/filesystem/tools.d.ts.map +0 -1
  273. package/dist/internal/filesystem/tools.js +0 -634
  274. package/dist/internal/otel/propagation.d.ts +0 -7
  275. package/dist/internal/otel/propagation.d.ts.map +0 -1
  276. package/dist/internal/otel/propagation.js +0 -15
  277. package/dist/internal/sdk-subagent-inherit-support.d.ts +0 -9
  278. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +0 -1
  279. package/dist/internal/sdk-subagent-inherit-support.js +0 -90
  280. package/dist/playground/assets/index-D6mVn9og.js +0 -62
  281. package/dist/playground/assets/index-DlALM6gr.css +0 -1
  282. /package/dist/docs/assets/{building-with-agents.md.BqJ7AAjG.lean.js → building-with-agents.md.Bo3ct-rf.lean.js} +0 -0
  283. /package/dist/docs/assets/{guides_agent-to-agent.md.BcmSqL2z.lean.js → guides_agent-to-agent.md.DcB3nhOz.lean.js} +0 -0
  284. /package/dist/docs/assets/{guides_github.md.6jiEH7dg.lean.js → guides_github.md.CcuZ7keS.lean.js} +0 -0
  285. /package/dist/docs/assets/{guides_mcp-oauth.md.C-Sx_IPa.lean.js → guides_mcp-oauth.md.GVPMKcYl.lean.js} +0 -0
  286. /package/dist/docs/assets/{guides_migrate.md.BbhHYeCr.lean.js → guides_migrate.md.B8CZxnnX.lean.js} +0 -0
  287. /package/dist/docs/assets/{guides_slack.md.BgIGG9ur.lean.js → guides_slack.md.D7Rwyva4.lean.js} +0 -0
  288. /package/dist/docs/assets/{hillclimbing.md.3TkdF79A.lean.js → hillclimbing.md.M51bF-oT.lean.js} +0 -0
  289. /package/dist/docs/assets/{reference_cli.md.B8GdpaRj.lean.js → reference_cli.md.DHm6DmYk.lean.js} +0 -0
@@ -1,148 +0,0 @@
1
- /**
2
- * Advertised native-tool schemas. These are the `@cursor/sdk`
3
- * tool-call types (`@anysphere/cursor-sdk-shared/tool-call-types`)
4
- * reconstructed here so `@grok/agent-sdk` does not take an unpublished
5
- * workspace dependency. The contract test pins JSON-schema equality
6
- * against the SDK originals.
7
- *
8
- * Runtime aliases (`contents` → `fileText`, `old_string` → `oldText`)
9
- * live on the `defineTool` input schema, not on these objects. The args
10
- * objects are strict so their input JSON Schema keeps
11
- * `additionalProperties: false`.
12
- */
13
- import * as z from "zod/v4";
14
- const simpleError = z.object({
15
- message: z.string(),
16
- });
17
- function resultSchema(success) {
18
- return z.discriminatedUnion("status", [
19
- z.object({
20
- status: z.literal("success"),
21
- value: success,
22
- }),
23
- z.object({
24
- status: z.literal("error"),
25
- error: simpleError,
26
- }),
27
- ]);
28
- }
29
- export const sdkReadArgs = z.strictObject({
30
- path: z.string(),
31
- });
32
- export const sdkReadResult = resultSchema(z.object({
33
- content: z.string(),
34
- totalLines: z.number(),
35
- fileSize: z.number(),
36
- }));
37
- export const sdkWriteArgs = z.strictObject({
38
- path: z.string(),
39
- fileText: z.string(),
40
- returnFileContentAfterWrite: z.boolean().optional(),
41
- });
42
- export const sdkWriteResult = resultSchema(z.object({
43
- path: z.string(),
44
- linesCreated: z.number(),
45
- fileSize: z.number(),
46
- fileContentAfterWrite: z.string().optional(),
47
- }));
48
- export const sdkDeleteArgs = z.strictObject({
49
- path: z.string(),
50
- });
51
- export const sdkDeleteResult = resultSchema(z.object({
52
- fileSize: z.number(),
53
- }));
54
- export const sdkGlobArgs = z.strictObject({
55
- targetDirectory: z.string().optional(),
56
- globPattern: z.string(),
57
- });
58
- export const sdkGlobResult = resultSchema(z.object({
59
- files: z.array(z.string()),
60
- totalFiles: z.number(),
61
- clientTruncated: z.boolean(),
62
- ripgrepTruncated: z.boolean(),
63
- }));
64
- export const sdkGrepArgs = z.strictObject({
65
- pattern: z.string(),
66
- path: z.string().optional(),
67
- glob: z.string().optional(),
68
- outputMode: z.string().optional(),
69
- contextBefore: z.number().optional(),
70
- contextAfter: z.number().optional(),
71
- context: z.number().optional(),
72
- caseInsensitive: z.boolean().optional(),
73
- type: z.string().optional(),
74
- headLimit: z.number().optional(),
75
- offset: z.number().optional(),
76
- multiline: z.boolean().optional(),
77
- sort: z.string().optional(),
78
- sortAscending: z.boolean().optional(),
79
- });
80
- const grepContentMatch = z.object({
81
- file: z.string(),
82
- lineNumber: z.number().optional(),
83
- line: z.string(),
84
- beforeContext: z.array(z.string()).optional(),
85
- afterContext: z.array(z.string()).optional(),
86
- });
87
- const grepFileCount = z.object({
88
- file: z.string(),
89
- count: z.number(),
90
- });
91
- const grepUnion = z.discriminatedUnion("type", [
92
- z.object({
93
- type: z.literal("content"),
94
- output: z.object({
95
- matches: z.array(grepContentMatch),
96
- totalMatches: z.number(),
97
- }),
98
- }),
99
- z.object({
100
- type: z.literal("files"),
101
- output: z.object({
102
- files: z.array(z.string()),
103
- count: z.number(),
104
- }),
105
- }),
106
- z.object({
107
- type: z.literal("count"),
108
- output: z.object({
109
- counts: z.array(grepFileCount),
110
- total: z.number(),
111
- }),
112
- }),
113
- ]);
114
- export const sdkGrepResult = resultSchema(z.object({
115
- workspaceResults: z.record(z.string(), grepUnion).optional(),
116
- activeEditorResult: grepUnion.optional(),
117
- }));
118
- export const sdkLsArgs = z.strictObject({
119
- path: z.string(),
120
- ignore: z.array(z.string()).optional(),
121
- });
122
- const lsDirectoryTreeNodeFile = z.object({
123
- name: z.string(),
124
- });
125
- // Not z.lazy: the advertised schema stays inline, with no `$defs` reference.
126
- const lsDirectoryTreeNode = z.object({
127
- absPath: z.string(),
128
- childrenDirs: z.array(z.unknown()),
129
- childrenFiles: z.array(lsDirectoryTreeNodeFile),
130
- childrenWereProcessed: z.boolean(),
131
- fullSubtreeExtensionCounts: z.record(z.string(), z.number()),
132
- numFiles: z.number(),
133
- });
134
- export const sdkLsResult = resultSchema(z.object({
135
- directoryTreeRoot: lsDirectoryTreeNode,
136
- }));
137
- /** StrReplace is SDK `edit` plus the str-replace args the model actually sends. */
138
- export const sdkStrReplaceArgs = z.strictObject({
139
- path: z.string(),
140
- oldText: z.string(),
141
- newText: z.string(),
142
- replaceAll: z.boolean().optional(),
143
- });
144
- export const sdkEditResult = resultSchema(z.object({
145
- linesAdded: z.number().optional(),
146
- linesRemoved: z.number().optional(),
147
- diffString: z.string().optional(),
148
- }));
@@ -1,39 +0,0 @@
1
- /**
2
- * Task-child inherit for an authored virtual root.
3
- *
4
- * The SDK calls `resourceProviderOptions` once per child session id,
5
- * including nested `Task` grandchildren, and reuses that result for the
6
- * child runtime. Each id gets its own {@link childOverlayFs} over the
7
- * session union (authored tree plus `/tmp` scratch), so a child write
8
- * cannot clobber the parent or a sibling. The FileSystem handle is not
9
- * placed on the SDK request.
10
- *
11
- * Native executor overrides load on the first child. A static import
12
- * would pull workspace-only packages into every CLI start. The published
13
- * package omits that module; children then keep shell suppressed and
14
- * reach the same overlay through synthesized file tools.
15
- */
16
- import type { LocalSubagentInherit, LocalSubagentResourceProviderFields } from "@cursor/sdk";
17
- import { type FileSystem } from "../../filesystem.js";
18
- /**
19
- * Structural view of the checkout-only executor module. Naming that module
20
- * in a type query would pull it into `tsc -p tsconfig.build.json` even
21
- * though the build config excludes it, and the published program cannot
22
- * see its workspace-only imports.
23
- */
24
- type ChildToolExecutor = NonNullable<LocalSubagentResourceProviderFields["overrideReadExecutor"]>;
25
- interface FileSystemExecutorModule {
26
- createFileSystemReadExecutor(root: FileSystem): ChildToolExecutor;
27
- createFileSystemWriteExecutor(root: FileSystem): ChildToolExecutor;
28
- createFileSystemGrepExecutor(root: FileSystem): ChildToolExecutor;
29
- createFileSystemLsExecutor(root: FileSystem): ChildToolExecutor;
30
- }
31
- export interface RootSubagentBinding {
32
- readonly inherit: LocalSubagentInherit;
33
- /** Overlay for a Task child. Do not pass the parent session id. */
34
- fileSystemForSession(sessionId: string): FileSystem;
35
- }
36
- export declare function createRootSubagentInherit(parent: FileSystem): RootSubagentBinding;
37
- export declare function resourceFieldsForChild(overlay: FileSystem, executors: FileSystemExecutorModule | undefined): LocalSubagentResourceProviderFields;
38
- export {};
39
- //# sourceMappingURL=subagent-inherit.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"subagent-inherit.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/subagent-inherit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mCAAmC,EAAE,MAAM,aAAa,CAAC;AAC7F,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtE;;;;;GAKG;AACH,KAAK,iBAAiB,GAAG,WAAW,CAAC,mCAAmC,CAAC,sBAAsB,CAAC,CAAC,CAAC;AAElG,UAAU,wBAAwB;IAChC,4BAA4B,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;IAClE,6BAA6B,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;IACnE,4BAA4B,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;IAClE,0BAA0B,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;CACjE;AAUD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,mEAAmE;IACnE,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAAC;CACrD;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,GAAG,mBAAmB,CAcjF;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,UAAU,EACnB,SAAS,EAAE,wBAAwB,GAAG,SAAS,GAC9C,mCAAmC,CAWrC"}
@@ -1,96 +0,0 @@
1
- /**
2
- * Task-child inherit for an authored virtual root.
3
- *
4
- * The SDK calls `resourceProviderOptions` once per child session id,
5
- * including nested `Task` grandchildren, and reuses that result for the
6
- * child runtime. Each id gets its own {@link childOverlayFs} over the
7
- * session union (authored tree plus `/tmp` scratch), so a child write
8
- * cannot clobber the parent or a sibling. The FileSystem handle is not
9
- * placed on the SDK request.
10
- *
11
- * Native executor overrides load on the first child. A static import
12
- * would pull workspace-only packages into every CLI start. The published
13
- * package omits that module; children then keep shell suppressed and
14
- * reach the same overlay through synthesized file tools.
15
- */
16
- import { childOverlayFs } from "../../filesystem.js";
17
- /**
18
- * Widened to `string` on purpose. A string-literal dynamic import is still
19
- * a static dependency, so the published declaration build would compile the
20
- * excluded executor module. Node and the test runner resolve this relative
21
- * to this file.
22
- */
23
- const FILE_SYSTEM_EXECUTORS_SPECIFIER = "../../filesystem-executors.js";
24
- export function createRootSubagentInherit(parent) {
25
- const overlays = new Map();
26
- return {
27
- inherit: {
28
- reportedWorkspacePath: "/",
29
- resourceProviderOptions: async (context) => {
30
- const overlay = childOverlayFor(overlays, parent, context.sessionId);
31
- return resourceFieldsForChild(overlay, await loadFileSystemExecutors());
32
- },
33
- },
34
- fileSystemForSession(sessionId) {
35
- return childOverlayFor(overlays, parent, sessionId);
36
- },
37
- };
38
- }
39
- export function resourceFieldsForChild(overlay, executors) {
40
- if (executors === undefined) {
41
- return { suppressDefaultShellExecutor: true };
42
- }
43
- return {
44
- overrideReadExecutor: executors.createFileSystemReadExecutor(overlay),
45
- overrideWriteExecutor: executors.createFileSystemWriteExecutor(overlay),
46
- overrideGrepExecutor: executors.createFileSystemGrepExecutor(overlay),
47
- overrideLsExecutor: executors.createFileSystemLsExecutor(overlay),
48
- suppressDefaultShellExecutor: true,
49
- };
50
- }
51
- async function loadFileSystemExecutors() {
52
- try {
53
- const loaded = await import(FILE_SYSTEM_EXECUTORS_SPECIFIER);
54
- if (!isFileSystemExecutorModule(loaded)) {
55
- throw new Error("filesystem executors module is missing its factories");
56
- }
57
- return loaded;
58
- }
59
- catch (error) {
60
- if (isMissingModule(error)) {
61
- return undefined;
62
- }
63
- throw error;
64
- }
65
- }
66
- function isFileSystemExecutorModule(value) {
67
- if (typeof value !== "object" || value === null) {
68
- return false;
69
- }
70
- const candidate = value;
71
- return (typeof candidate.createFileSystemReadExecutor === "function" &&
72
- typeof candidate.createFileSystemWriteExecutor === "function" &&
73
- typeof candidate.createFileSystemGrepExecutor === "function" &&
74
- typeof candidate.createFileSystemLsExecutor === "function");
75
- }
76
- function isMissingModule(error) {
77
- if (typeof error !== "object" || error === null) {
78
- return false;
79
- }
80
- if ("code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
81
- return true;
82
- }
83
- return "cause" in error && isMissingModule(error.cause);
84
- }
85
- function childOverlayFor(overlays, parent, sessionId) {
86
- if (sessionId === undefined || sessionId === "") {
87
- return childOverlayFs(parent);
88
- }
89
- const existing = overlays.get(sessionId);
90
- if (existing !== undefined) {
91
- return existing;
92
- }
93
- const created = childOverlayFs(parent);
94
- overlays.set(sessionId, created);
95
- return created;
96
- }
@@ -1,59 +0,0 @@
1
- /**
2
- * Native file tools synthesized from a bound {@link FileSystem}.
3
- *
4
- * Advertised name / input / output match `@cursor/sdk` tool-call types.
5
- * Each tool is a `defineTool` whose runtime `inputSchema` accepts those
6
- * fields plus the native aliases the harness still sends.
7
- */
8
- import { type FileSystem, type FileSystemToolName } from "../../filesystem.js";
9
- import type { DiscoveredTool } from "../../types.js";
10
- export declare const SYNTHESIZED_FILE_SYSTEM_TOOL_NAMES: readonly ["Read", "LS", "Glob", "Grep", "Write", "StrReplace", "Delete"];
11
- export type SynthesizedFileSystemToolName = (typeof SYNTHESIZED_FILE_SYSTEM_TOOL_NAMES)[number];
12
- export declare function isSynthesizedFileSystemToolName(name: string): boolean;
13
- export declare function rootFileToolsFromAuthored(tools: readonly string[] | undefined): FileSystemToolName[] | undefined;
14
- /**
15
- * Host-default file-tool filter. Omitted `tools` keeps the default
16
- * seven-tool set (`undefined`). A listed allowlist is closed: names that
17
- * are not FileSystem methods synthesize nothing, so agents that already
18
- * replaced natives with authored VFS tools (`tools: ["updateTodos"]` plus
19
- * `agent/tools/Delete.ts`) do not also get host-disk Delete.
20
- *
21
- * Authored `root` still uses {@link rootFileToolsFromAuthored}, where a
22
- * no-file-name allowlist means the default-on file layer.
23
- */
24
- export declare function hostFileToolsFromAuthored(tools: readonly string[] | undefined): FileSystemToolName[] | undefined;
25
- /**
26
- * Names July will actually synthesize for this agent. Discovery reserves
27
- * only this set, not every FileSystem alias.
28
- */
29
- export declare function synthesizedFileSystemToolNames(options: {
30
- hasRoot: boolean;
31
- tools?: readonly string[];
32
- }): readonly SynthesizedFileSystemToolName[];
33
- /**
34
- * Canonical tool a name and payload will run. Legacy `edit` with
35
- * `fileText` or `contents` is Write. Every other `edit` payload is StrReplace.
36
- */
37
- export declare function resolvedFileSystemToolName(name: string, input?: Record<string, unknown>): FileSystemToolName | undefined;
38
- /**
39
- * True when a direct call may run this file-tool alias. The set is the
40
- * same one a turn synthesizes from `tools`.
41
- */
42
- export declare function isDirectFileToolAdmitted(options: {
43
- toolName: string;
44
- input: unknown;
45
- hasRoot: boolean;
46
- tools?: readonly string[];
47
- }): boolean;
48
- /** Look up the `defineTool` factory for a native or allowlist name. */
49
- export declare function fileSystemTool(root: FileSystem, name: string, input?: Record<string, unknown>): DiscoveredTool | undefined;
50
- /** Validate and run the same tool a turn or `callTool` would. */
51
- export declare function runFileSystemTool(root: FileSystem, name: string, input?: Record<string, unknown>): Promise<unknown>;
52
- /**
53
- * Run `fn` with synthesized file tools bound to `root`. Task children use
54
- * this so Read/Write/Delete hit their overlay instead of the parent tree
55
- * the tools were built against.
56
- */
57
- export declare function runWithFileSystem<T>(root: FileSystem, fn: () => Promise<T>): Promise<T>;
58
- export declare function synthesizeFileSystemTools(root: FileSystem, filter?: readonly FileSystemToolName[]): DiscoveredTool[];
59
- //# sourceMappingURL=tools.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAIL,KAAK,UAAU,EACf,KAAK,kBAAkB,EAWxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,EAAE,cAAc,EAA6B,MAAM,gBAAgB,CAAC;AA8BhF,eAAO,MAAM,kCAAkC,YAC7C,MAAM,EACN,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,QAAQ,CACA,CAAC;AAEX,MAAM,MAAM,6BAA6B,GAAG,CAAC,OAAO,kCAAkC,CAAC,CAAC,MAAM,CAAC,CAAC;AAIhG,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAMrE;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAmBlC;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACnC,kBAAkB,EAAE,GAAG,SAAS,CAKlC;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,SAAS,6BAA6B,EAAE,CAQ3C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,kBAAkB,GAAG,SAAS,CAKhC;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3B,GAAG,OAAO,CAUV;AAqjBD,uEAAuE;AACvE,wBAAgB,cAAc,CAC5B,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,cAAc,GAAG,SAAS,CAM5B;AAED,iEAAiE;AACjE,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,UAAU,EAChB,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAClC,OAAO,CAAC,OAAO,CAAC,CAelB;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAEvF;AA8BD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,SAAS,kBAAkB,EAAE,GACrC,cAAc,EAAE,CAQlB"}