@grok/agent-sdk 0.4.0 → 0.6.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 (218) 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/manifest.d.ts.map +1 -1
  11. package/dist/channels/slack/manifest.js +2 -15
  12. package/dist/docs/404.html +2 -2
  13. package/dist/docs/assets/{app.BSH__xV4.js → app.lt-BYgI2.js} +4 -4
  14. package/dist/docs/assets/changelog.md.DVNB-ApU.js +1 -0
  15. package/dist/docs/assets/changelog.md.DVNB-ApU.lean.js +1 -0
  16. package/dist/docs/assets/chunks/@localSearchIndexroot.DdlR-9Oe.js +1 -0
  17. package/dist/docs/assets/chunks/{VPLocalSearchBox.Cadl7A0k.js → VPLocalSearchBox.v_dV4U2Q.js} +1 -1
  18. package/dist/docs/assets/chunks/{arc.K7t9nNY6.js → arc.5o92kOg5.js} +1 -1
  19. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.SlHEknkX.js → architectureDiagram-Q4EWVU46.C-oTwnNq.js} +1 -1
  20. package/dist/docs/assets/chunks/{baseUniq.DJLRMLkz.js → baseUniq.zJ-VNOib.js} +1 -1
  21. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.Bs6XxFpe.js → blockDiagram-DXYQGD6D.B9ZJZuPd.js} +1 -1
  22. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.CyLg6Ovc.js → c4Diagram-AHTNJAMY.BBMwSIaN.js} +1 -1
  23. package/dist/docs/assets/chunks/channel.CdyTxaXV.js +1 -0
  24. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.DTQ4TinT.js → chunk-4BX2VUAB.D8qAJpDD.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.Es84IgcH.js → chunk-4TB4RGXK.B8QR5cdE.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-55IACEB6.Clm3cGPQ.js → chunk-55IACEB6.BsWxVuew.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DE4CRkS5.js → chunk-EDXVE4YY.BeGygY_i.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.Bf8HCvqp.js → chunk-FMBD7UC4.DdwgH-ZH.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.eub-7nSx.js → chunk-OYMX7WX6.B9zC_ALe.js} +1 -1
  30. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.WyP9VAS_.js → chunk-QZHKN3VN.BIxJ0rcL.js} +1 -1
  31. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.LO9ohhDE.js → chunk-YZCP3GAM.qiM_23_f.js} +1 -1
  32. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CeUcN6TW.js +1 -0
  33. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CeUcN6TW.js +1 -0
  34. package/dist/docs/assets/chunks/clone.DpIwUbur.js +1 -0
  35. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.D5za6aH0.js → cose-bilkent-S5V4N54A.BKB971D5.js} +1 -1
  36. package/dist/docs/assets/chunks/{dagre-KV5264BT.Dq1daUru.js → dagre-KV5264BT.CcILjJgp.js} +1 -1
  37. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.j1YL5BKS.js → diagram-5BDNPKRD.DkY9A0nu.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Bi1aLdhC.js → diagram-G4DWMVQ6.BbdzmjMt.js} +1 -1
  39. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.BOzMEkAr.js → diagram-MMDJMWI5.Be0zy1cM.js} +1 -1
  40. package/dist/docs/assets/chunks/{diagram-TYMM5635.Dx2FVhCr.js → diagram-TYMM5635.zOiEycLe.js} +1 -1
  41. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DI4TNkye.js → erDiagram-SMLLAGMA.DUd_9HMF.js} +1 -1
  42. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.C58Z9uPK.js → flowDiagram-DWJPFMVM.2KPYoZBO.js} +1 -1
  43. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DXSpW809.js → ganttDiagram-T4ZO3ILL.DqE8_YpP.js} +1 -1
  44. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B955oaFl.js → gitGraphDiagram-UUTBAWPF.CO0Tk47h.js} +1 -1
  45. package/dist/docs/assets/chunks/{graph.BQXhKtxS.js → graph.CNe5KbNy.js} +1 -1
  46. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.Dozj_-Gm.js → infoDiagram-42DDH7IO.BBhJ1X1B.js} +1 -1
  47. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D2140OzH.js → ishikawaDiagram-UXIWVN3A.KSIw9w3I.js} +1 -1
  48. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.DrqrMhCk.js → journeyDiagram-VCZTEJTY.BN2Y5oUJ.js} +1 -1
  49. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Dv-LTrlw.js → kanban-definition-6JOO6SKY.2KFuDYn_.js} +1 -1
  50. package/dist/docs/assets/chunks/{layout.CGtHp49X.js → layout.Demb_pzL.js} +1 -1
  51. package/dist/docs/assets/chunks/{linear.CHZLYB52.js → linear.kYKxzbbR.js} +1 -1
  52. package/dist/docs/assets/chunks/{min.D4Vt3eIy.js → min.DwmCN5dF.js} +1 -1
  53. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BBfpYTea.js → mindmap-definition-QFDTVHPH.CGlz01QG.js} +1 -1
  54. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BVYvElmY.js → pieDiagram-DEJITSTG.n3qsq4nA.js} +1 -1
  55. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.C6Gc2mdY.js → quadrantDiagram-34T5L4WZ.CGNJ1GSb.js} +1 -1
  56. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DWa8b4cn.js → requirementDiagram-MS252O5E.VhAzHDwQ.js} +1 -1
  57. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.Bi-g4ajv.js → sankeyDiagram-XADWPNL6.DmHA5pW-.js} +1 -1
  58. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.DlU3vVN9.js → sequenceDiagram-FGHM5R23._TC1aKhg.js} +1 -1
  59. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.CeqJRqnU.js → stateDiagram-FHFEXIEX.B-kLjV3O.js} +1 -1
  60. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.HtBkUH4J.js +1 -0
  61. package/dist/docs/assets/chunks/{theme.DGq7D4tt.js → theme.BaVlHHL-.js} +2 -2
  62. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.Cqf2kjq9.js → timeline-definition-GMOUNBTQ.CresbphV.js} +1 -1
  63. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.BeOpE_lM.js → vennDiagram-DHZGUBPP.CegHD8Y4.js} +1 -1
  64. package/dist/docs/assets/chunks/{wardley-RL74JXVD.FMQXA-6q.js → wardley-RL74JXVD.DjCmZrUO.js} +1 -1
  65. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BXS65dAC.js → wardleyDiagram-NUSXRM2D.BJ7s1zdZ.js} +1 -1
  66. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.haEiSxqc.js → xychartDiagram-5P7HB3ND.IrEXlemI.js} +1 -1
  67. package/dist/docs/assets/{reference_agent-config.md.BSNp2uJ7.js → reference_agent-config.md.Bbqf0lgS.js} +11 -3
  68. package/dist/docs/assets/{reference_agent-config.md.BSNp2uJ7.lean.js → reference_agent-config.md.Bbqf0lgS.lean.js} +1 -1
  69. package/dist/docs/assets/{reference_schedules.md.Dd8_d0WG.js → reference_schedules.md.RhQ9ZLo1.js} +3 -3
  70. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.js → reference_tools.md.BhqW6neF.js} +4 -2
  71. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.lean.js → reference_tools.md.BhqW6neF.lean.js} +1 -1
  72. package/dist/docs/building-with-agents.html +35 -35
  73. package/dist/docs/changelog.html +36 -36
  74. package/dist/docs/changelog.md +47 -7
  75. package/dist/docs/deployment.html +35 -35
  76. package/dist/docs/evals.html +35 -35
  77. package/dist/docs/guides/agent-to-agent.html +35 -35
  78. package/dist/docs/guides/bitbucket.html +35 -35
  79. package/dist/docs/guides/cloud-agents.html +35 -35
  80. package/dist/docs/guides/convert-automation.html +35 -35
  81. package/dist/docs/guides/github.html +35 -35
  82. package/dist/docs/guides/gitlab.html +35 -35
  83. package/dist/docs/guides/improve.html +35 -35
  84. package/dist/docs/guides/jev.html +35 -35
  85. package/dist/docs/guides/mcp-oauth.html +35 -35
  86. package/dist/docs/guides/migrate.html +35 -35
  87. package/dist/docs/guides/opentelemetry.html +35 -35
  88. package/dist/docs/guides/pagerduty.html +35 -35
  89. package/dist/docs/guides/slack.html +35 -35
  90. package/dist/docs/guides/webhooks.html +35 -35
  91. package/dist/docs/hashmap.json +1 -1
  92. package/dist/docs/hillclimbing.html +35 -35
  93. package/dist/docs/index.html +35 -35
  94. package/dist/docs/llms-full.txt +129 -11
  95. package/dist/docs/quickstart.html +35 -35
  96. package/dist/docs/reference/access.html +35 -35
  97. package/dist/docs/reference/agent-config.html +45 -37
  98. package/dist/docs/reference/agent-config.md +70 -4
  99. package/dist/docs/reference/artifacts.html +35 -35
  100. package/dist/docs/reference/channels.html +35 -35
  101. package/dist/docs/reference/cli.html +35 -35
  102. package/dist/docs/reference/connections.html +35 -35
  103. package/dist/docs/reference/evals.html +35 -35
  104. package/dist/docs/reference/extensions.html +35 -35
  105. package/dist/docs/reference/hooks.html +35 -35
  106. package/dist/docs/reference/http-api.html +35 -35
  107. package/dist/docs/reference/instructions.html +35 -35
  108. package/dist/docs/reference/limits.html +35 -35
  109. package/dist/docs/reference/memory.html +35 -35
  110. package/dist/docs/reference/playground.html +35 -35
  111. package/dist/docs/reference/project-layout.html +35 -35
  112. package/dist/docs/reference/schedules.html +38 -38
  113. package/dist/docs/reference/sessions.html +35 -35
  114. package/dist/docs/reference/skills.html +35 -35
  115. package/dist/docs/reference/subagents.html +35 -35
  116. package/dist/docs/reference/tools.html +39 -37
  117. package/dist/docs/reference/tools.md +12 -0
  118. package/dist/docs/templates/agentic-owners.html +35 -35
  119. package/dist/docs/templates/reviews.html +35 -35
  120. package/dist/docs/troubleshooting.html +35 -35
  121. package/dist/filesystem.d.ts +10 -97
  122. package/dist/filesystem.d.ts.map +1 -1
  123. package/dist/filesystem.js +28 -290
  124. package/dist/index.d.ts +0 -2
  125. package/dist/index.d.ts.map +1 -1
  126. package/dist/index.js +0 -2
  127. package/dist/internal/cli-deploy.d.ts.map +1 -1
  128. package/dist/internal/cli-deploy.js +12 -7
  129. package/dist/internal/continuation-channel.d.ts +3 -3
  130. package/dist/internal/continuation-channel.js +3 -3
  131. package/dist/internal/continuation-identity.d.ts +6 -5
  132. package/dist/internal/continuation-identity.d.ts.map +1 -1
  133. package/dist/internal/continuation-identity.js +17 -2
  134. package/dist/internal/direct-file-tools.d.ts +21 -0
  135. package/dist/internal/direct-file-tools.d.ts.map +1 -0
  136. package/dist/internal/direct-file-tools.js +60 -0
  137. package/dist/internal/discovery/agent.d.ts.map +1 -1
  138. package/dist/internal/discovery/agent.js +71 -66
  139. package/dist/internal/filesystem/walk.d.ts +4 -52
  140. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  141. package/dist/internal/filesystem/walk.js +4 -190
  142. package/dist/internal/hosted-delivery-protocol.d.ts +3 -0
  143. package/dist/internal/hosted-delivery-protocol.d.ts.map +1 -1
  144. package/dist/internal/hosted-delivery-protocol.js +2 -0
  145. package/dist/internal/hosted-delivery.d.ts.map +1 -1
  146. package/dist/internal/hosted-delivery.js +25 -10
  147. package/dist/internal/hosted-execution-latency.d.ts +3 -0
  148. package/dist/internal/hosted-execution-latency.d.ts.map +1 -1
  149. package/dist/internal/hosted-execution-latency.js +11 -0
  150. package/dist/internal/hosted-managed-automation.js +1 -1
  151. package/dist/internal/otel/http.d.ts +2 -1
  152. package/dist/internal/otel/http.d.ts.map +1 -1
  153. package/dist/internal/otel/http.js +2 -3
  154. package/dist/internal/sdk-runner.d.ts +1 -1
  155. package/dist/internal/sdk-runner.d.ts.map +1 -1
  156. package/dist/internal/sdk-runner.js +28 -40
  157. package/dist/internal/server.d.ts.map +1 -1
  158. package/dist/internal/server.js +8 -4
  159. package/dist/internal/session-engine.d.ts +34 -19
  160. package/dist/internal/session-engine.d.ts.map +1 -1
  161. package/dist/internal/session-engine.js +196 -251
  162. package/dist/internal/tcp-address.d.ts +3 -1
  163. package/dist/internal/tcp-address.d.ts.map +1 -1
  164. package/dist/internal/tcp-address.js +6 -0
  165. package/dist/internal/tool-paths.d.ts +8 -0
  166. package/dist/internal/tool-paths.d.ts.map +1 -0
  167. package/dist/internal/tool-paths.js +12 -0
  168. package/dist/internal/workspace-tree.d.ts +27 -0
  169. package/dist/internal/workspace-tree.d.ts.map +1 -0
  170. package/dist/internal/workspace-tree.js +106 -0
  171. package/dist/playground/assets/index-CnFd5R1_.js +62 -0
  172. package/dist/playground/assets/index-DNzRv6G8.css +1 -0
  173. package/dist/playground/index.html +2 -2
  174. package/dist/types.d.ts +48 -23
  175. package/dist/types.d.ts.map +1 -1
  176. package/docs/changelog.md +47 -7
  177. package/docs/reference/agent-config.md +70 -4
  178. package/docs/reference/tools.md +12 -0
  179. package/package.json +9 -14
  180. package/skills/deploy/SKILL.md +1 -1
  181. package/dist/docs/assets/changelog.md.b6H_ea44.js +0 -1
  182. package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +0 -1
  183. package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +0 -1
  184. package/dist/docs/assets/chunks/channel.CVTdqYx0.js +0 -1
  185. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +0 -1
  186. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +0 -1
  187. package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +0 -1
  188. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +0 -1
  189. package/dist/executors.d.ts +0 -11
  190. package/dist/executors.d.ts.map +0 -1
  191. package/dist/executors.js +0 -21
  192. package/dist/internal/filesystem/format.d.ts +0 -28
  193. package/dist/internal/filesystem/format.d.ts.map +0 -1
  194. package/dist/internal/filesystem/format.js +0 -209
  195. package/dist/internal/filesystem/nearest.d.ts +0 -15
  196. package/dist/internal/filesystem/nearest.d.ts.map +0 -1
  197. package/dist/internal/filesystem/nearest.js +0 -90
  198. package/dist/internal/filesystem/scratch.d.ts +0 -60
  199. package/dist/internal/filesystem/scratch.d.ts.map +0 -1
  200. package/dist/internal/filesystem/scratch.js +0 -187
  201. package/dist/internal/filesystem/sdk-schemas.d.ts +0 -29
  202. package/dist/internal/filesystem/sdk-schemas.d.ts.map +0 -1
  203. package/dist/internal/filesystem/sdk-schemas.js +0 -148
  204. package/dist/internal/filesystem/subagent-inherit.d.ts +0 -39
  205. package/dist/internal/filesystem/subagent-inherit.d.ts.map +0 -1
  206. package/dist/internal/filesystem/subagent-inherit.js +0 -96
  207. package/dist/internal/filesystem/tools.d.ts +0 -59
  208. package/dist/internal/filesystem/tools.d.ts.map +0 -1
  209. package/dist/internal/filesystem/tools.js +0 -634
  210. package/dist/internal/otel/propagation.d.ts +0 -7
  211. package/dist/internal/otel/propagation.d.ts.map +0 -1
  212. package/dist/internal/otel/propagation.js +0 -15
  213. package/dist/internal/sdk-subagent-inherit-support.d.ts +0 -9
  214. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +0 -1
  215. package/dist/internal/sdk-subagent-inherit-support.js +0 -90
  216. package/dist/playground/assets/index-Bno25Cg0.css +0 -1
  217. package/dist/playground/assets/index-SGKsaznh.js +0 -62
  218. /package/dist/docs/assets/{reference_schedules.md.Dd8_d0WG.lean.js → reference_schedules.md.RhQ9ZLo1.lean.js} +0 -0
@@ -1,4 +1,6 @@
1
- import type { AddressInfo, Server } from "node:net";
1
+ import { type AddressInfo, type Server } from "node:net";
2
2
  /** TCP address of a listening server. A pipe or a closed server throws. */
3
3
  export declare function tcpAddress(server: Server): AddressInfo;
4
+ /** `http:` origin of a server bound to `host`; a wildcard bind is reached on 127.0.0.1. */
5
+ export declare function serveOrigin(host: string, port: number): string;
4
6
  //# sourceMappingURL=tcp-address.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"tcp-address.d.ts","sourceRoot":"","sources":["../../src/internal/tcp-address.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEpD,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAMtD"}
1
+ {"version":3,"file":"tcp-address.d.ts","sourceRoot":"","sources":["../../src/internal/tcp-address.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAU,KAAK,MAAM,EAAE,MAAM,UAAU,CAAC;AAEjE,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,CAMtD;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9D"}
@@ -1,3 +1,4 @@
1
+ import { isIPv6 } from "node:net";
1
2
  /** TCP address of a listening server. A pipe or a closed server throws. */
2
3
  export function tcpAddress(server) {
3
4
  const address = server.address();
@@ -6,3 +7,8 @@ export function tcpAddress(server) {
6
7
  }
7
8
  return address;
8
9
  }
10
+ /** `http:` origin of a server bound to `host`; a wildcard bind is reached on 127.0.0.1. */
11
+ export function serveOrigin(host, port) {
12
+ const reachable = host === "0.0.0.0" || host === "::" ? "127.0.0.1" : host;
13
+ return `http://${isIPv6(reachable) ? `[${reachable}]` : reachable}:${port}`;
14
+ }
@@ -0,0 +1,8 @@
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 declare function hostPathFromToolPath(input: string, platform?: NodeJS.Platform): string;
8
+ //# sourceMappingURL=tool-paths.d.ts.map
@@ -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
+ }