@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,154 +0,0 @@
1
- /**
2
- * K-way merge of already-sorted streams. Each source must be ordered
3
- * under the same `compare`; the merge does not re-sort a source.
4
- *
5
- * A binary heap of heads keeps the next yield O(log k) in the number of
6
- * sources. `unique` skips later copies of a key so an earlier source can
7
- * shadow a later one (the union rule).
8
- */
9
- /**
10
- * Merge already-sorted iterables / async iterables under `compare`.
11
- * Equal keys (`compare === 0`) keep source order: earlier `sources`
12
- * index wins. With `unique`, those later copies are skipped.
13
- */
14
- export async function* mergeSorted(sources, options) {
15
- const { compare, unique = false } = options;
16
- const heap = new MinHeap((left, right) => {
17
- const byValue = compare(left.value, right.value);
18
- return byValue !== 0 ? byValue : left.source - right.source;
19
- });
20
- const iterators = sources.map((source, sourceIndex) => {
21
- const iterator = Symbol.asyncIterator in source
22
- ? source[Symbol.asyncIterator]()
23
- : (async function* () {
24
- yield* source;
25
- })();
26
- return { iterator, sourceIndex };
27
- });
28
- await Promise.all(iterators.map(async ({ iterator, sourceIndex }) => {
29
- const next = await iterator.next();
30
- if (!next.done) {
31
- heap.push({ value: next.value, iterator, source: sourceIndex });
32
- }
33
- }));
34
- while (heap.size > 0) {
35
- const best = heap.pop();
36
- if (best === undefined) {
37
- return;
38
- }
39
- yield best.value;
40
- if (unique) {
41
- await advanceMatching(heap, best, compare);
42
- }
43
- else {
44
- await pushNext(heap, best);
45
- }
46
- }
47
- }
48
- async function pushNext(heap, head) {
49
- const next = await head.iterator.next();
50
- if (!next.done) {
51
- heap.push({
52
- value: next.value,
53
- iterator: head.iterator,
54
- source: head.source,
55
- });
56
- }
57
- }
58
- /** Advance every head whose key equals `best` (compare === 0). */
59
- async function advanceMatching(heap, best, compare) {
60
- await pushNext(heap, best);
61
- while (heap.size > 0) {
62
- const peek = heap.peek();
63
- if (peek === undefined || compare(peek.value, best.value) !== 0) {
64
- return;
65
- }
66
- const duplicate = heap.pop();
67
- if (duplicate === undefined) {
68
- return;
69
- }
70
- await pushNext(heap, duplicate);
71
- }
72
- }
73
- /**
74
- * Binary min-heap. `compare(a, b) < 0` means `a` is before `b`.
75
- * Exported for the invariant tests; composers use {@link mergeSorted}.
76
- */
77
- export class MinHeap {
78
- constructor(compare) {
79
- this.compare = compare;
80
- this.items = [];
81
- }
82
- get size() {
83
- return this.items.length;
84
- }
85
- peek() {
86
- return this.items[0];
87
- }
88
- push(item) {
89
- this.items.push(item);
90
- this.bubbleUp(this.items.length - 1);
91
- }
92
- pop() {
93
- const first = this.items[0];
94
- if (first === undefined) {
95
- return undefined;
96
- }
97
- const last = this.items.pop();
98
- if (last === undefined || this.items.length === 0) {
99
- return first;
100
- }
101
- this.items[0] = last;
102
- this.bubbleDown(0);
103
- return first;
104
- }
105
- bubbleUp(index) {
106
- let current = index;
107
- while (current > 0) {
108
- const parent = Math.floor((current - 1) / 2);
109
- const parentItem = this.items[parent];
110
- const currentItem = this.items[current];
111
- if (parentItem === undefined ||
112
- currentItem === undefined ||
113
- this.compare(currentItem, parentItem) >= 0) {
114
- return;
115
- }
116
- this.items[parent] = currentItem;
117
- this.items[current] = parentItem;
118
- current = parent;
119
- }
120
- }
121
- bubbleDown(index) {
122
- let current = index;
123
- for (;;) {
124
- const left = current * 2 + 1;
125
- const right = left + 1;
126
- let smallest = current;
127
- const currentItem = this.items[smallest];
128
- const leftItem = this.items[left];
129
- if (leftItem !== undefined &&
130
- currentItem !== undefined &&
131
- this.compare(leftItem, currentItem) < 0) {
132
- smallest = left;
133
- }
134
- const smallestItem = this.items[smallest];
135
- const rightItem = this.items[right];
136
- if (rightItem !== undefined &&
137
- smallestItem !== undefined &&
138
- this.compare(rightItem, smallestItem) < 0) {
139
- smallest = right;
140
- }
141
- if (smallest === current) {
142
- return;
143
- }
144
- const swapCurrent = this.items[current];
145
- const swapSmallest = this.items[smallest];
146
- if (swapCurrent === undefined || swapSmallest === undefined) {
147
- return;
148
- }
149
- this.items[current] = swapSmallest;
150
- this.items[smallest] = swapCurrent;
151
- current = smallest;
152
- }
153
- }
154
- }
@@ -1,15 +0,0 @@
1
- /**
2
- * Parent-listing neighbors for a Read / LS miss. FileSystem has no
3
- * catalog API; `list(dirname(path))` is the sibling set. Immediate
4
- * children only — a recursive mount must not dump its whole subtree.
5
- */
6
- import { type FileSystem } from "../../filesystem.js";
7
- export declare function nearestListedNames(query: string, names: readonly string[], limit?: number): string[];
8
- export declare function formatMissNeighborHint(path: string, neighbors: readonly string[]): string | undefined;
9
- /**
10
- * One-line miss hint when the parent directory listed siblings.
11
- * `undefined` leaves the caller to throw the ordinary miss.
12
- * @deprecated Deprecated on the package root.
13
- */
14
- export declare function nearestNeighborMissHint(root: Pick<FileSystem, "list">, path: string): Promise<string | undefined>;
15
- //# sourceMappingURL=nearest.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"nearest.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/nearest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,UAAU,EAA2C,MAAM,qBAAqB,CAAC;AAK/F,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,GAAE,MAAuB,GAC7B,MAAM,EAAE,CAeV;AAED,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,MAAM,GAAG,SAAS,CAKpB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,EAC9B,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B"}
@@ -1,90 +0,0 @@
1
- /**
2
- * Parent-listing neighbors for a Read / LS miss. FileSystem has no
3
- * catalog API; `list(dirname(path))` is the sibling set. Immediate
4
- * children only — a recursive mount must not dump its whole subtree.
5
- */
6
- import { posix } from "node:path";
7
- import { FILE_SYSTEM_SCAN_LIMIT, normalizeFsPath } from "../../filesystem.js";
8
- import { collectList } from "./walk.js";
9
- const NEIGHBOR_LIMIT = 5;
10
- export function nearestListedNames(query, names, limit = NEIGHBOR_LIMIT) {
11
- const queryKey = rankKey(query);
12
- return [...names]
13
- .sort((left, right) => {
14
- const leftKey = rankKey(left);
15
- const rightKey = rankKey(right);
16
- const leftPrefix = isPrefixRelated(queryKey, leftKey) ? 0 : 1;
17
- const rightPrefix = isPrefixRelated(queryKey, rightKey) ? 0 : 1;
18
- if (leftPrefix !== rightPrefix) {
19
- return leftPrefix - rightPrefix;
20
- }
21
- const distance = editDistance(queryKey, leftKey) - editDistance(queryKey, rightKey);
22
- return distance !== 0 ? distance : left.localeCompare(right);
23
- })
24
- .slice(0, limit);
25
- }
26
- export function formatMissNeighborHint(path, neighbors) {
27
- if (neighbors.length === 0) {
28
- return undefined;
29
- }
30
- return `not found: ${path}. nearest: ${neighbors.join(", ")}. do not retry.`;
31
- }
32
- /**
33
- * One-line miss hint when the parent directory listed siblings.
34
- * `undefined` leaves the caller to throw the ordinary miss.
35
- * @deprecated Deprecated on the package root.
36
- */
37
- export async function nearestNeighborMissHint(root, path) {
38
- const missed = normalizeFsPath(path);
39
- const parent = parentDir(missed);
40
- const files = await collectList(root, parent, {
41
- limit: FILE_SYSTEM_SCAN_LIMIT,
42
- });
43
- const names = [
44
- ...new Set(files
45
- .map((file) => relativeToParent(file.path, parent))
46
- .filter((name) => name.length > 0 && !name.includes("/"))),
47
- ].filter((name) => name !== posix.basename(missed));
48
- return formatMissNeighborHint(missed, nearestListedNames(posix.basename(missed), names));
49
- }
50
- function rankKey(name) {
51
- const base = posix.basename(name);
52
- const dot = base.lastIndexOf(".");
53
- return dot > 0 ? base.slice(0, dot) : base;
54
- }
55
- function isPrefixRelated(left, right) {
56
- return left.startsWith(right) || right.startsWith(left);
57
- }
58
- function editDistance(left, right) {
59
- const previous = Array.from({ length: right.length + 1 }, (_, index) => index);
60
- for (let i = 0; i < left.length; i += 1) {
61
- let diagonal = i;
62
- previous[0] = i + 1;
63
- for (let j = 0; j < right.length; j += 1) {
64
- const insertion = (previous[j + 1] ?? 0) + 1;
65
- const deletion = (previous[j] ?? 0) + 1;
66
- const substitution = diagonal + (left[i] === right[j] ? 0 : 1);
67
- diagonal = previous[j + 1] ?? 0;
68
- previous[j + 1] = Math.min(insertion, deletion, substitution);
69
- }
70
- }
71
- return previous[right.length] ?? right.length;
72
- }
73
- function parentDir(path) {
74
- const dir = posix.dirname(path);
75
- return dir === "." || dir === path ? "/" : dir;
76
- }
77
- function relativeToParent(filePath, parent) {
78
- const file = normalizeFsPath(filePath);
79
- const root = parent === "/" || parent === "" ? "/" : normalizeFsPath(parent);
80
- if (root === "/") {
81
- return file.startsWith("/") ? file.slice(1) : file;
82
- }
83
- if (file === root) {
84
- return posix.basename(file);
85
- }
86
- if (file.startsWith(`${root}/`)) {
87
- return file.slice(root.length + 1);
88
- }
89
- return posix.basename(file);
90
- }
@@ -1,60 +0,0 @@
1
- /**
2
- * Host `~/.cursor/projects/{slug(cwd)}/agent-tools/{uuid}.txt` → `/tmp/{uuid}.txt`.
3
- *
4
- * Native WebSearch / WebFetch and oversized MCP results still scratch
5
- * large output on the host, under the Cursor SDK's project dir for the
6
- * harness cwd. The session engine mounts `tempFs()` at `/tmp` with
7
- * `unionFs` and copies only those files onto that tree. This module is
8
- * the host-path translation, not a FileSystem type.
9
- */
10
- import type { FileSystem } from "../../filesystem.js";
11
- export declare const TMP_SCRATCH_PREFIX = "/tmp";
12
- export declare const HOST_AGENT_TOOLS_DIR = "agent-tools";
13
- export declare const WEB_SCRATCH_TOOLS: readonly ["webSearch", "webFetch"];
14
- export declare function isWebScratchTool(name: string | undefined): boolean;
15
- export declare function tmpScratchPath(fileName: string): string;
16
- export declare function hostAgentToolsDir(cwd: string): string;
17
- /**
18
- * Basename of `{hostAgentToolsDir(cwd)}/{uuid}.txt`, or undefined. Other
19
- * paths in a result are ignored.
20
- */
21
- export declare function hostAgentToolsFileName(args: {
22
- cwd: string;
23
- candidate: string;
24
- }): string | undefined;
25
- export declare function remapScratchPath(args: {
26
- cwd: string;
27
- path: string;
28
- }): string;
29
- export declare function remapScratchPaths(input: Record<string, unknown>, cwd: string): Record<string, unknown>;
30
- export declare function rewriteWebScratchText(args: {
31
- cwd: string;
32
- text: string;
33
- }): string;
34
- /** Rewrite host agent-tools paths in a string or a structured tool result. */
35
- export declare function rewriteWebScratchValue(args: {
36
- cwd: string;
37
- value: unknown;
38
- }): unknown;
39
- /**
40
- * WebSearch / WebFetch result. Ingest the host spill and rewrite
41
- * paths onto `/tmp`. Other tools are a no-op.
42
- */
43
- export declare function finishWebScratchTool(args: {
44
- toolName: string | undefined;
45
- result: unknown;
46
- cwd: string;
47
- root: FileSystem;
48
- }): Promise<unknown>;
49
- /** Finish a native web tool on the SDK update that carried its result. */
50
- export declare function applyWebScratchUpdate<T>(args: {
51
- cwd: string;
52
- root: FileSystem;
53
- update: T;
54
- }): Promise<T>;
55
- export declare function ingestHostAgentToolsScratch(args: {
56
- cwd: string;
57
- root: FileSystem;
58
- hostPath?: string;
59
- }): Promise<string[]>;
60
- //# sourceMappingURL=scratch.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"scratch.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/scratch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD,eAAO,MAAM,kBAAkB,SAAS,CAAC;AACzC,eAAO,MAAM,oBAAoB,gBAAgB,CAAC;AAClD,eAAO,MAAM,iBAAiB,YAAI,WAAW,EAAE,UAAU,CAAU,CAAC;AAEpE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAElE;AASD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,GAAG,SAAS,CAUrB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAM5E;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAUjF;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAgBrF;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,IAAI,EAAE;IAC/C,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,OAAO,CAAC,OAAO,CAAC,CAMnB;AAyBD,0EAA0E;AAC1E,wBAAsB,qBAAqB,CAAC,CAAC,EAAE,IAAI,EAAE;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,CAAC,CAAC;CACX,GAAG,OAAO,CAAC,CAAC,CAAC,CAYb;AAED,wBAAsB,2BAA2B,CAAC,IAAI,EAAE;IACtD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAepB"}
@@ -1,187 +0,0 @@
1
- /**
2
- * Host `~/.cursor/projects/{slug(cwd)}/agent-tools/{uuid}.txt` → `/tmp/{uuid}.txt`.
3
- *
4
- * Native WebSearch / WebFetch and oversized MCP results still scratch
5
- * large output on the host, under the Cursor SDK's project dir for the
6
- * harness cwd. The session engine mounts `tempFs()` at `/tmp` with
7
- * `unionFs` and copies only those files onto that tree. This module is
8
- * the host-path translation, not a FileSystem type.
9
- */
10
- import { readdir, readFile, rm } from "node:fs/promises";
11
- import { homedir } from "node:os";
12
- import path from "node:path";
13
- export const TMP_SCRATCH_PREFIX = "/tmp";
14
- export const HOST_AGENT_TOOLS_DIR = "agent-tools";
15
- export const WEB_SCRATCH_TOOLS = ["webSearch", "webFetch"];
16
- export function isWebScratchTool(name) {
17
- return name === "webSearch" || name === "webFetch";
18
- }
19
- const UUID_TXT = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\.txt$/i;
20
- const HOST_FOLLOW_UP = /Use shell \/ grep \/ read_file on this path to inspect the page/g;
21
- const OVERLAY_FOLLOW_UP = "Use Read / Grep on this path to inspect the page";
22
- const PATH_KEYS = ["path", "dir", "targetDirectory", "target_directory"];
23
- export function tmpScratchPath(fileName) {
24
- return `${TMP_SCRATCH_PREFIX}/${fileName}`;
25
- }
26
- export function hostAgentToolsDir(cwd) {
27
- const slug = cwd
28
- .replace(/[^a-zA-Z0-9]/g, "-")
29
- .replace(/-+/g, "-")
30
- .replace(/^-+|-+$/g, "");
31
- return path.join(homedir(), ".cursor", "projects", slug, HOST_AGENT_TOOLS_DIR);
32
- }
33
- /**
34
- * Basename of `{hostAgentToolsDir(cwd)}/{uuid}.txt`, or undefined. Other
35
- * paths in a result are ignored.
36
- */
37
- export function hostAgentToolsFileName(args) {
38
- if (args.candidate === "") {
39
- return undefined;
40
- }
41
- const resolved = path.resolve(args.candidate);
42
- if (path.dirname(resolved) !== hostAgentToolsDir(args.cwd)) {
43
- return undefined;
44
- }
45
- const base = path.basename(resolved);
46
- return UUID_TXT.test(base) ? base : undefined;
47
- }
48
- export function remapScratchPath(args) {
49
- const fileName = hostAgentToolsFileName({
50
- cwd: args.cwd,
51
- candidate: args.path,
52
- });
53
- return fileName === undefined ? args.path : tmpScratchPath(fileName);
54
- }
55
- export function remapScratchPaths(input, cwd) {
56
- const next = { ...input };
57
- for (const key of PATH_KEYS) {
58
- const value = next[key];
59
- if (typeof value === "string") {
60
- next[key] = remapScratchPath({ cwd, path: value });
61
- }
62
- }
63
- return next;
64
- }
65
- export function rewriteWebScratchText(args) {
66
- const dir = hostAgentToolsDir(args.cwd);
67
- const escaped = dir.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
68
- const pattern = new RegExp(`${escaped}[/\\\\]([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\\.txt)`, "gi");
69
- return args.text
70
- .replace(pattern, (_match, fileName) => tmpScratchPath(fileName))
71
- .replace(HOST_FOLLOW_UP, OVERLAY_FOLLOW_UP);
72
- }
73
- /** Rewrite host agent-tools paths in a string or a structured tool result. */
74
- export function rewriteWebScratchValue(args) {
75
- const { cwd, value } = args;
76
- if (typeof value === "string") {
77
- return rewriteWebScratchText({ cwd, text: value });
78
- }
79
- if (Array.isArray(value)) {
80
- return value.map((item) => rewriteWebScratchValue({ cwd, value: item }));
81
- }
82
- if (value !== null && typeof value === "object") {
83
- const next = {};
84
- for (const [key, item] of Object.entries(value)) {
85
- next[key] = rewriteWebScratchValue({ cwd, value: item });
86
- }
87
- return next;
88
- }
89
- return value;
90
- }
91
- /**
92
- * WebSearch / WebFetch result. Ingest the host spill and rewrite
93
- * paths onto `/tmp`. Other tools are a no-op.
94
- */
95
- export async function finishWebScratchTool(args) {
96
- if (!isWebScratchTool(args.toolName)) {
97
- return args.result;
98
- }
99
- await ingestHostAgentToolsScratch({ cwd: args.cwd, root: args.root });
100
- return rewriteWebScratchValue({ cwd: args.cwd, value: args.result });
101
- }
102
- function completedWebToolCall(update) {
103
- if (update === null || typeof update !== "object") {
104
- return undefined;
105
- }
106
- const rec = update;
107
- const call = rec.type === "tool-call-completed"
108
- ? rec.toolCall
109
- : rec.type === "tool-call-delta" && rec.taskUpdate?.type === "tool-call-completed"
110
- ? rec.taskUpdate.toolCall
111
- : undefined;
112
- if (call === undefined || !isWebScratchTool(call.type)) {
113
- return undefined;
114
- }
115
- return call;
116
- }
117
- /** Finish a native web tool on the SDK update that carried its result. */
118
- export async function applyWebScratchUpdate(args) {
119
- const call = completedWebToolCall(args.update);
120
- if (call === undefined) {
121
- return args.update;
122
- }
123
- call.result = await finishWebScratchTool({
124
- toolName: call.type,
125
- result: call.result,
126
- cwd: args.cwd,
127
- root: args.root,
128
- });
129
- return args.update;
130
- }
131
- export async function ingestHostAgentToolsScratch(args) {
132
- const written = [];
133
- const names = args.hostPath === undefined ? await listHostAgentToolsFiles(args.cwd) : [args.hostPath];
134
- for (const hostPath of names) {
135
- const dest = await copyHostAgentToolsFile({
136
- cwd: args.cwd,
137
- root: args.root,
138
- hostPath,
139
- });
140
- if (dest !== undefined) {
141
- written.push(dest);
142
- }
143
- }
144
- return written;
145
- }
146
- async function listHostAgentToolsFiles(cwd) {
147
- const dir = hostAgentToolsDir(cwd);
148
- try {
149
- const entries = await readdir(dir, { withFileTypes: true });
150
- return entries
151
- .filter((entry) => entry.isFile() && UUID_TXT.test(entry.name))
152
- .map((entry) => path.join(dir, entry.name));
153
- }
154
- catch (error) {
155
- if (isEnoent(error)) {
156
- return [];
157
- }
158
- throw error;
159
- }
160
- }
161
- async function copyHostAgentToolsFile(args) {
162
- const fileName = hostAgentToolsFileName({
163
- cwd: args.cwd,
164
- candidate: args.hostPath,
165
- });
166
- if (fileName === undefined) {
167
- return undefined;
168
- }
169
- const dest = tmpScratchPath(fileName);
170
- const hostPath = path.resolve(args.hostPath);
171
- let bytes;
172
- try {
173
- bytes = await readFile(hostPath);
174
- }
175
- catch (error) {
176
- if (isEnoent(error)) {
177
- return undefined;
178
- }
179
- throw error;
180
- }
181
- await args.root.write(dest, bytes.toString("utf8"));
182
- await rm(hostPath, { force: true });
183
- return dest;
184
- }
185
- function isEnoent(error) {
186
- return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
187
- }
@@ -1,29 +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
- export declare const sdkReadArgs: z.ZodType;
15
- export declare const sdkReadResult: z.ZodType;
16
- export declare const sdkWriteArgs: z.ZodType;
17
- export declare const sdkWriteResult: z.ZodType;
18
- export declare const sdkDeleteArgs: z.ZodType;
19
- export declare const sdkDeleteResult: z.ZodType;
20
- export declare const sdkGlobArgs: z.ZodType;
21
- export declare const sdkGlobResult: z.ZodType;
22
- export declare const sdkGrepArgs: z.ZodType;
23
- export declare const sdkGrepResult: z.ZodType;
24
- export declare const sdkLsArgs: z.ZodType;
25
- export declare const sdkLsResult: z.ZodType;
26
- /** StrReplace is SDK `edit` plus the str-replace args the model actually sends. */
27
- export declare const sdkStrReplaceArgs: z.ZodType;
28
- export declare const sdkEditResult: z.ZodType;
29
- //# sourceMappingURL=sdk-schemas.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"sdk-schemas.d.ts","sourceRoot":"","sources":["../../../src/internal/filesystem/sdk-schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAmB5B,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAE1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAM7B,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,CAAC,CAAC,OAI3B,CAAC;AAEH,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,OAO9B,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAE5B,CAAC;AAEH,eAAO,MAAM,eAAe,EAAE,CAAC,CAAC,OAI/B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAG1B,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAO7B,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAe1B,CAAC;AAuCH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAK7B,CAAC;AAEF,eAAO,MAAM,SAAS,EAAE,CAAC,CAAC,OAGxB,CAAC;AAgBH,eAAO,MAAM,WAAW,EAAE,CAAC,CAAC,OAI3B,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAKhC,CAAC;AAEH,eAAO,MAAM,aAAa,EAAE,CAAC,CAAC,OAM7B,CAAC"}