@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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tool-paths.d.ts","sourceRoot":"","sources":["../../src/internal/tool-paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,MAAM,CAKR"}
@@ -0,0 +1,12 @@
1
+ /**
2
+ * The SDK's file tools normalize every path to POSIX form with a leading
3
+ * `/`, so a Windows path such as `C:\Users\me\a.txt` reaches a FileSystem
4
+ * as `/C:/Users/me/a.txt`. Strip that leading `/` on Windows so the host
5
+ * path module sees a drive path.
6
+ */
7
+ export function hostPathFromToolPath(input, platform = process.platform) {
8
+ if (platform === "win32" && /^\/[A-Za-z]:(?:[\\/]|$)/.test(input)) {
9
+ return input.slice(1);
10
+ }
11
+ return input;
12
+ }
@@ -0,0 +1,27 @@
1
+ import type { FileSystem } from "@cursor/sdk";
2
+ /**
3
+ * A host directory as a tree rooted at `/`: `/src/a.ts` is `<dir>/src/a.ts`.
4
+ * A path that resolves outside the directory, through `..` or a symlink, is
5
+ * refused. Results and error messages name tree paths, never host paths.
6
+ */
7
+ export declare function hostDirectoryTree(dir: string): FileSystem;
8
+ /** Where a confined host workspace is mounted when the agent sets no `workspace`. */
9
+ export declare const DEFAULT_TREE_WORKSPACE = "/workspace";
10
+ /**
11
+ * Whether a host-disk agent runs on its session workspace as a tree: it is
12
+ * sandboxed, its `tools` grant a file tool, and they grant no shell. Its
13
+ * reads then stay inside the workspace without a shell that could read
14
+ * around them.
15
+ */
16
+ export declare function confinesWorkspaceReads(agent: {
17
+ readonly local?: {
18
+ readonly sandbox?: boolean;
19
+ };
20
+ readonly tools?: readonly string[];
21
+ }): boolean;
22
+ /** `tools` without the ones a tree cannot back, and the names it dropped. */
23
+ export declare function treeToolAllowlist<T extends string>(tools: readonly T[]): {
24
+ tools: T[];
25
+ dropped: T[];
26
+ };
27
+ //# sourceMappingURL=workspace-tree.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workspace-tree.d.ts","sourceRoot":"","sources":["../../src/internal/workspace-tree.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAY,UAAU,EAAgB,MAAM,aAAa,CAAC;AAGtE;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CA4EzD;AAED,qFAAqF;AACrF,eAAO,MAAM,sBAAsB,eAAe,CAAC;AAanD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,GAAG,OAAO,CAMV;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAChD,KAAK,EAAE,SAAS,CAAC,EAAE,GAClB;IAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAAC,OAAO,EAAE,CAAC,EAAE,CAAA;CAAE,CAG9B"}
@@ -0,0 +1,106 @@
1
+ import { realpath } from "node:fs/promises";
2
+ import path from "node:path";
3
+ import { localFileSystem } from "../filesystem.js";
4
+ /**
5
+ * A host directory as a tree rooted at `/`: `/src/a.ts` is `<dir>/src/a.ts`.
6
+ * A path that resolves outside the directory, through `..` or a symlink, is
7
+ * refused. Results and error messages name tree paths, never host paths.
8
+ */
9
+ export function hostDirectoryTree(dir) {
10
+ const host = localFileSystem({ cwd: dir, confineToWorkspace: true });
11
+ const roots = realpath(dir).then((real) => [...new Set([real, path.resolve(dir)])], () => [path.resolve(dir)]);
12
+ const toTree = async (hostPath) => {
13
+ for (const root of await roots) {
14
+ const relative = path.relative(root, hostPath);
15
+ if (relative !== ".." &&
16
+ !relative.startsWith(`..${path.sep}`) &&
17
+ !path.isAbsolute(relative)) {
18
+ return relative === "" ? "/" : `/${relative.split(path.sep).join("/")}`;
19
+ }
20
+ }
21
+ return hostPath;
22
+ };
23
+ const scrub = async (error) => {
24
+ if (error instanceof Error) {
25
+ for (const root of await roots) {
26
+ error.message = error.message.split(`${root}${path.sep}`).join("/").split(root).join("/");
27
+ }
28
+ const located = error;
29
+ if (typeof located.path === "string") {
30
+ located.path = await toTree(located.path);
31
+ }
32
+ }
33
+ throw error;
34
+ };
35
+ const guard = async (run) => {
36
+ try {
37
+ return await run();
38
+ }
39
+ catch (error) {
40
+ return scrub(error);
41
+ }
42
+ };
43
+ async function* entries(source) {
44
+ try {
45
+ for await (const entry of source) {
46
+ yield { ...entry, path: await toTree(entry.path) };
47
+ }
48
+ }
49
+ catch (error) {
50
+ await scrub(error);
51
+ }
52
+ }
53
+ async function* matches(source) {
54
+ try {
55
+ for await (const match of source) {
56
+ yield { ...match, path: await toTree(match.path) };
57
+ }
58
+ }
59
+ catch (error) {
60
+ await scrub(error);
61
+ }
62
+ }
63
+ return {
64
+ list: (prefix, options) => entries(host.list(prefix === undefined ? undefined : hostPath(prefix), options)),
65
+ stat: (probe) => guard(() => host.stat(hostPath(probe))),
66
+ read: (file) => guard(() => host.read(hostPath(file))),
67
+ glob: (pattern, globDir, options) => entries(host.glob(pattern, globDir === undefined ? undefined : hostPath(globDir), options)),
68
+ grep: (query) => matches(host.grep(query.path === undefined ? query : { ...query, path: hostPath(query.path) })),
69
+ write: (file, contents) => guard(() => host.write(hostPath(file), contents)),
70
+ delete: (file) => guard(() => host.delete(hostPath(file))),
71
+ };
72
+ }
73
+ /** Where a confined host workspace is mounted when the agent sets no `workspace`. */
74
+ export const DEFAULT_TREE_WORKSPACE = "/workspace";
75
+ const FILE_TOOLS = new Set(["read", "grep", "glob", "ls", "edit", "delete"]);
76
+ /** Tools a tree cannot back. A tree agent's `tools` drops them. */
77
+ const HOST_ONLY_TOOLS = new Set([
78
+ "readlints",
79
+ "applyagentdiff",
80
+ "computeruse",
81
+ "recordscreen",
82
+ "writeshellstdin",
83
+ ]);
84
+ /**
85
+ * Whether a host-disk agent runs on its session workspace as a tree: it is
86
+ * sandboxed, its `tools` grant a file tool, and they grant no shell. Its
87
+ * reads then stay inside the workspace without a shell that could read
88
+ * around them.
89
+ */
90
+ export function confinesWorkspaceReads(agent) {
91
+ if (agent.local?.sandbox !== true || agent.tools === undefined) {
92
+ return false;
93
+ }
94
+ const names = agent.tools.map((name) => name.toLowerCase());
95
+ return !names.includes("shell") && names.some((name) => FILE_TOOLS.has(name));
96
+ }
97
+ /** `tools` without the ones a tree cannot back, and the names it dropped. */
98
+ export function treeToolAllowlist(tools) {
99
+ const dropped = tools.filter((name) => HOST_ONLY_TOOLS.has(name.toLowerCase()));
100
+ return { tools: tools.filter((name) => !dropped.includes(name)), dropped };
101
+ }
102
+ /** A tree path as a path relative to the directory; `..` cannot climb out of `/`. */
103
+ function hostPath(treePath) {
104
+ const relative = path.posix.normalize(`/${treePath.replace(/\\/g, "/")}`).slice(1);
105
+ return relative === "" ? "." : relative;
106
+ }