@grok/agent-sdk 0.4.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 (201) 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/docs/404.html +2 -2
  11. package/dist/docs/assets/{app.BSH__xV4.js → app.CYdjweqP.js} +4 -4
  12. package/dist/docs/assets/changelog.md.BMrJ5WxW.js +1 -0
  13. package/dist/docs/assets/changelog.md.BMrJ5WxW.lean.js +1 -0
  14. package/dist/docs/assets/chunks/@localSearchIndexroot.dUaE1f8e.js +1 -0
  15. package/dist/docs/assets/chunks/{VPLocalSearchBox.Cadl7A0k.js → VPLocalSearchBox.CRATKS9J.js} +1 -1
  16. package/dist/docs/assets/chunks/{arc.K7t9nNY6.js → arc.BxM78ISR.js} +1 -1
  17. package/dist/docs/assets/chunks/{architectureDiagram-Q4EWVU46.SlHEknkX.js → architectureDiagram-Q4EWVU46.Bi6MuKaU.js} +1 -1
  18. package/dist/docs/assets/chunks/{baseUniq.DJLRMLkz.js → baseUniq.L47qqpDG.js} +1 -1
  19. package/dist/docs/assets/chunks/{blockDiagram-DXYQGD6D.Bs6XxFpe.js → blockDiagram-DXYQGD6D.kHFF2FK5.js} +1 -1
  20. package/dist/docs/assets/chunks/{c4Diagram-AHTNJAMY.CyLg6Ovc.js → c4Diagram-AHTNJAMY.BTW85ll3.js} +1 -1
  21. package/dist/docs/assets/chunks/channel.ljJtQtBi.js +1 -0
  22. package/dist/docs/assets/chunks/{chunk-4BX2VUAB.DTQ4TinT.js → chunk-4BX2VUAB.Bbh3_48g.js} +1 -1
  23. package/dist/docs/assets/chunks/{chunk-4TB4RGXK.Es84IgcH.js → chunk-4TB4RGXK.WeAmK3fK.js} +1 -1
  24. package/dist/docs/assets/chunks/{chunk-55IACEB6.Clm3cGPQ.js → chunk-55IACEB6.DTdUiVHf.js} +1 -1
  25. package/dist/docs/assets/chunks/{chunk-EDXVE4YY.DE4CRkS5.js → chunk-EDXVE4YY.n5XzANDz.js} +1 -1
  26. package/dist/docs/assets/chunks/{chunk-FMBD7UC4.Bf8HCvqp.js → chunk-FMBD7UC4.D51eewCb.js} +1 -1
  27. package/dist/docs/assets/chunks/{chunk-OYMX7WX6.eub-7nSx.js → chunk-OYMX7WX6.BrY0U7ZV.js} +1 -1
  28. package/dist/docs/assets/chunks/{chunk-QZHKN3VN.WyP9VAS_.js → chunk-QZHKN3VN.B0OA4aFV.js} +1 -1
  29. package/dist/docs/assets/chunks/{chunk-YZCP3GAM.LO9ohhDE.js → chunk-YZCP3GAM.Djt3Mjft.js} +1 -1
  30. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.BZ3Uc-XU.js +1 -0
  31. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.BZ3Uc-XU.js +1 -0
  32. package/dist/docs/assets/chunks/clone.BDtbEo69.js +1 -0
  33. package/dist/docs/assets/chunks/{cose-bilkent-S5V4N54A.D5za6aH0.js → cose-bilkent-S5V4N54A.DiMcA6Q8.js} +1 -1
  34. package/dist/docs/assets/chunks/{dagre-KV5264BT.Dq1daUru.js → dagre-KV5264BT.BGqI4vrS.js} +1 -1
  35. package/dist/docs/assets/chunks/{diagram-5BDNPKRD.j1YL5BKS.js → diagram-5BDNPKRD.bDqFuMoH.js} +1 -1
  36. package/dist/docs/assets/chunks/{diagram-G4DWMVQ6.Bi1aLdhC.js → diagram-G4DWMVQ6.Y0sxaXRU.js} +1 -1
  37. package/dist/docs/assets/chunks/{diagram-MMDJMWI5.BOzMEkAr.js → diagram-MMDJMWI5.Bg43b0yi.js} +1 -1
  38. package/dist/docs/assets/chunks/{diagram-TYMM5635.Dx2FVhCr.js → diagram-TYMM5635.DCfVasEC.js} +1 -1
  39. package/dist/docs/assets/chunks/{erDiagram-SMLLAGMA.DI4TNkye.js → erDiagram-SMLLAGMA.C72GaD16.js} +1 -1
  40. package/dist/docs/assets/chunks/{flowDiagram-DWJPFMVM.C58Z9uPK.js → flowDiagram-DWJPFMVM.DxRQj7pP.js} +1 -1
  41. package/dist/docs/assets/chunks/{ganttDiagram-T4ZO3ILL.DXSpW809.js → ganttDiagram-T4ZO3ILL.DiLZy5Q4.js} +1 -1
  42. package/dist/docs/assets/chunks/{gitGraphDiagram-UUTBAWPF.B955oaFl.js → gitGraphDiagram-UUTBAWPF.DL8XkRvh.js} +1 -1
  43. package/dist/docs/assets/chunks/{graph.BQXhKtxS.js → graph.3Xub80xJ.js} +1 -1
  44. package/dist/docs/assets/chunks/{infoDiagram-42DDH7IO.Dozj_-Gm.js → infoDiagram-42DDH7IO.O3lGaspu.js} +1 -1
  45. package/dist/docs/assets/chunks/{ishikawaDiagram-UXIWVN3A.D2140OzH.js → ishikawaDiagram-UXIWVN3A.w-pCiQzn.js} +1 -1
  46. package/dist/docs/assets/chunks/{journeyDiagram-VCZTEJTY.DrqrMhCk.js → journeyDiagram-VCZTEJTY.Cg_oBs9j.js} +1 -1
  47. package/dist/docs/assets/chunks/{kanban-definition-6JOO6SKY.Dv-LTrlw.js → kanban-definition-6JOO6SKY.BpfMGPwn.js} +1 -1
  48. package/dist/docs/assets/chunks/{layout.CGtHp49X.js → layout.CtwXs__p.js} +1 -1
  49. package/dist/docs/assets/chunks/{linear.CHZLYB52.js → linear.NmCskOrP.js} +1 -1
  50. package/dist/docs/assets/chunks/{min.D4Vt3eIy.js → min.DpQtsLKs.js} +1 -1
  51. package/dist/docs/assets/chunks/{mindmap-definition-QFDTVHPH.BBfpYTea.js → mindmap-definition-QFDTVHPH.B-P-aKVp.js} +1 -1
  52. package/dist/docs/assets/chunks/{pieDiagram-DEJITSTG.BVYvElmY.js → pieDiagram-DEJITSTG.BfjjqK7j.js} +1 -1
  53. package/dist/docs/assets/chunks/{quadrantDiagram-34T5L4WZ.C6Gc2mdY.js → quadrantDiagram-34T5L4WZ.BTzHo53F.js} +1 -1
  54. package/dist/docs/assets/chunks/{requirementDiagram-MS252O5E.DWa8b4cn.js → requirementDiagram-MS252O5E.DIT2FIKr.js} +1 -1
  55. package/dist/docs/assets/chunks/{sankeyDiagram-XADWPNL6.Bi-g4ajv.js → sankeyDiagram-XADWPNL6.NK1wCsgt.js} +1 -1
  56. package/dist/docs/assets/chunks/{sequenceDiagram-FGHM5R23.DlU3vVN9.js → sequenceDiagram-FGHM5R23.D9oElkvo.js} +1 -1
  57. package/dist/docs/assets/chunks/{stateDiagram-FHFEXIEX.CeqJRqnU.js → stateDiagram-FHFEXIEX.IPksnixH.js} +1 -1
  58. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.CbhzVsQE.js +1 -0
  59. package/dist/docs/assets/chunks/{theme.DGq7D4tt.js → theme.CgKu7tr3.js} +2 -2
  60. package/dist/docs/assets/chunks/{timeline-definition-GMOUNBTQ.Cqf2kjq9.js → timeline-definition-GMOUNBTQ.CuAtJapY.js} +1 -1
  61. package/dist/docs/assets/chunks/{vennDiagram-DHZGUBPP.BeOpE_lM.js → vennDiagram-DHZGUBPP.B87nNW9E.js} +1 -1
  62. package/dist/docs/assets/chunks/wardley-RL74JXVD.BFIVMaoi.js +162 -0
  63. package/dist/docs/assets/chunks/{wardleyDiagram-NUSXRM2D.BXS65dAC.js → wardleyDiagram-NUSXRM2D.BELjSq8w.js} +1 -1
  64. package/dist/docs/assets/chunks/{xychartDiagram-5P7HB3ND.haEiSxqc.js → xychartDiagram-5P7HB3ND.5zN5ZGsz.js} +1 -1
  65. package/dist/docs/assets/{reference_agent-config.md.BSNp2uJ7.js → reference_agent-config.md.Bbqf0lgS.js} +11 -3
  66. package/dist/docs/assets/{reference_agent-config.md.BSNp2uJ7.lean.js → reference_agent-config.md.Bbqf0lgS.lean.js} +1 -1
  67. package/dist/docs/assets/{reference_schedules.md.Dd8_d0WG.js → reference_schedules.md.RhQ9ZLo1.js} +3 -3
  68. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.js → reference_tools.md.BhqW6neF.js} +4 -2
  69. package/dist/docs/assets/{reference_tools.md.B2OaR1Nb.lean.js → reference_tools.md.BhqW6neF.lean.js} +1 -1
  70. package/dist/docs/building-with-agents.html +35 -35
  71. package/dist/docs/changelog.html +36 -36
  72. package/dist/docs/changelog.md +31 -7
  73. package/dist/docs/deployment.html +35 -35
  74. package/dist/docs/evals.html +35 -35
  75. package/dist/docs/guides/agent-to-agent.html +35 -35
  76. package/dist/docs/guides/bitbucket.html +35 -35
  77. package/dist/docs/guides/cloud-agents.html +35 -35
  78. package/dist/docs/guides/convert-automation.html +35 -35
  79. package/dist/docs/guides/github.html +35 -35
  80. package/dist/docs/guides/gitlab.html +35 -35
  81. package/dist/docs/guides/improve.html +35 -35
  82. package/dist/docs/guides/jev.html +35 -35
  83. package/dist/docs/guides/mcp-oauth.html +35 -35
  84. package/dist/docs/guides/migrate.html +35 -35
  85. package/dist/docs/guides/opentelemetry.html +35 -35
  86. package/dist/docs/guides/pagerduty.html +35 -35
  87. package/dist/docs/guides/slack.html +35 -35
  88. package/dist/docs/guides/webhooks.html +35 -35
  89. package/dist/docs/hashmap.json +1 -1
  90. package/dist/docs/hillclimbing.html +35 -35
  91. package/dist/docs/index.html +35 -35
  92. package/dist/docs/llms-full.txt +113 -11
  93. package/dist/docs/quickstart.html +35 -35
  94. package/dist/docs/reference/access.html +35 -35
  95. package/dist/docs/reference/agent-config.html +45 -37
  96. package/dist/docs/reference/agent-config.md +70 -4
  97. package/dist/docs/reference/artifacts.html +35 -35
  98. package/dist/docs/reference/channels.html +35 -35
  99. package/dist/docs/reference/cli.html +35 -35
  100. package/dist/docs/reference/connections.html +35 -35
  101. package/dist/docs/reference/evals.html +35 -35
  102. package/dist/docs/reference/extensions.html +35 -35
  103. package/dist/docs/reference/hooks.html +35 -35
  104. package/dist/docs/reference/http-api.html +35 -35
  105. package/dist/docs/reference/instructions.html +35 -35
  106. package/dist/docs/reference/limits.html +35 -35
  107. package/dist/docs/reference/memory.html +35 -35
  108. package/dist/docs/reference/playground.html +35 -35
  109. package/dist/docs/reference/project-layout.html +35 -35
  110. package/dist/docs/reference/schedules.html +38 -38
  111. package/dist/docs/reference/sessions.html +35 -35
  112. package/dist/docs/reference/skills.html +35 -35
  113. package/dist/docs/reference/subagents.html +35 -35
  114. package/dist/docs/reference/tools.html +39 -37
  115. package/dist/docs/reference/tools.md +12 -0
  116. package/dist/docs/templates/agentic-owners.html +35 -35
  117. package/dist/docs/templates/reviews.html +35 -35
  118. package/dist/docs/troubleshooting.html +35 -35
  119. package/dist/filesystem.d.ts +10 -97
  120. package/dist/filesystem.d.ts.map +1 -1
  121. package/dist/filesystem.js +28 -290
  122. package/dist/index.d.ts +0 -2
  123. package/dist/index.d.ts.map +1 -1
  124. package/dist/index.js +0 -2
  125. package/dist/internal/continuation-channel.d.ts +3 -3
  126. package/dist/internal/continuation-channel.js +3 -3
  127. package/dist/internal/continuation-identity.d.ts +6 -5
  128. package/dist/internal/continuation-identity.d.ts.map +1 -1
  129. package/dist/internal/continuation-identity.js +17 -2
  130. package/dist/internal/direct-file-tools.d.ts +21 -0
  131. package/dist/internal/direct-file-tools.d.ts.map +1 -0
  132. package/dist/internal/direct-file-tools.js +60 -0
  133. package/dist/internal/discovery/agent.d.ts.map +1 -1
  134. package/dist/internal/discovery/agent.js +71 -66
  135. package/dist/internal/filesystem/walk.d.ts +4 -52
  136. package/dist/internal/filesystem/walk.d.ts.map +1 -1
  137. package/dist/internal/filesystem/walk.js +4 -190
  138. package/dist/internal/hosted-managed-automation.js +1 -1
  139. package/dist/internal/otel/http.d.ts +2 -1
  140. package/dist/internal/otel/http.d.ts.map +1 -1
  141. package/dist/internal/otel/http.js +2 -3
  142. package/dist/internal/sdk-runner.d.ts.map +1 -1
  143. package/dist/internal/sdk-runner.js +22 -40
  144. package/dist/internal/session-engine.d.ts +33 -19
  145. package/dist/internal/session-engine.d.ts.map +1 -1
  146. package/dist/internal/session-engine.js +170 -251
  147. package/dist/internal/tool-paths.d.ts +8 -0
  148. package/dist/internal/tool-paths.d.ts.map +1 -0
  149. package/dist/internal/tool-paths.js +12 -0
  150. package/dist/internal/workspace-tree.d.ts +27 -0
  151. package/dist/internal/workspace-tree.d.ts.map +1 -0
  152. package/dist/internal/workspace-tree.js +106 -0
  153. package/dist/playground/assets/index-D0-FHg1x.css +1 -0
  154. package/dist/playground/assets/index-D5SLKUy6.js +62 -0
  155. package/dist/playground/index.html +2 -2
  156. package/dist/types.d.ts +41 -23
  157. package/dist/types.d.ts.map +1 -1
  158. package/docs/changelog.md +31 -7
  159. package/docs/reference/agent-config.md +70 -4
  160. package/docs/reference/tools.md +12 -0
  161. package/package.json +9 -14
  162. package/skills/deploy/SKILL.md +1 -1
  163. package/dist/docs/assets/changelog.md.b6H_ea44.js +0 -1
  164. package/dist/docs/assets/changelog.md.b6H_ea44.lean.js +0 -1
  165. package/dist/docs/assets/chunks/@localSearchIndexroot.CiRGcfZg.js +0 -1
  166. package/dist/docs/assets/chunks/channel.CVTdqYx0.js +0 -1
  167. package/dist/docs/assets/chunks/classDiagram-6PBFFD2Q.CsJJyx6-.js +0 -1
  168. package/dist/docs/assets/chunks/classDiagram-v2-HSJHXN6E.CsJJyx6-.js +0 -1
  169. package/dist/docs/assets/chunks/clone.Dk8KvtOB.js +0 -1
  170. package/dist/docs/assets/chunks/stateDiagram-v2-QKLJ7IA2.DE0BnUZh.js +0 -1
  171. package/dist/docs/assets/chunks/wardley-RL74JXVD.FMQXA-6q.js +0 -162
  172. package/dist/executors.d.ts +0 -11
  173. package/dist/executors.d.ts.map +0 -1
  174. package/dist/executors.js +0 -21
  175. package/dist/internal/filesystem/format.d.ts +0 -28
  176. package/dist/internal/filesystem/format.d.ts.map +0 -1
  177. package/dist/internal/filesystem/format.js +0 -209
  178. package/dist/internal/filesystem/nearest.d.ts +0 -15
  179. package/dist/internal/filesystem/nearest.d.ts.map +0 -1
  180. package/dist/internal/filesystem/nearest.js +0 -90
  181. package/dist/internal/filesystem/scratch.d.ts +0 -60
  182. package/dist/internal/filesystem/scratch.d.ts.map +0 -1
  183. package/dist/internal/filesystem/scratch.js +0 -187
  184. package/dist/internal/filesystem/sdk-schemas.d.ts +0 -29
  185. package/dist/internal/filesystem/sdk-schemas.d.ts.map +0 -1
  186. package/dist/internal/filesystem/sdk-schemas.js +0 -148
  187. package/dist/internal/filesystem/subagent-inherit.d.ts +0 -39
  188. package/dist/internal/filesystem/subagent-inherit.d.ts.map +0 -1
  189. package/dist/internal/filesystem/subagent-inherit.js +0 -96
  190. package/dist/internal/filesystem/tools.d.ts +0 -59
  191. package/dist/internal/filesystem/tools.d.ts.map +0 -1
  192. package/dist/internal/filesystem/tools.js +0 -634
  193. package/dist/internal/otel/propagation.d.ts +0 -7
  194. package/dist/internal/otel/propagation.d.ts.map +0 -1
  195. package/dist/internal/otel/propagation.js +0 -15
  196. package/dist/internal/sdk-subagent-inherit-support.d.ts +0 -9
  197. package/dist/internal/sdk-subagent-inherit-support.d.ts.map +0 -1
  198. package/dist/internal/sdk-subagent-inherit-support.js +0 -90
  199. package/dist/playground/assets/index-Bno25Cg0.css +0 -1
  200. package/dist/playground/assets/index-SGKsaznh.js +0 -62
  201. /package/dist/docs/assets/{reference_schedules.md.Dd8_d0WG.lean.js → reference_schedules.md.RhQ9ZLo1.lean.js} +0 -0
@@ -1,107 +1,21 @@
1
1
  import { Buffer } from "node:buffer";
2
2
  import { lstat, mkdir, readdir, readFile, readlink, realpath, rm, stat, writeFile, } from "node:fs/promises";
3
3
  import path from "node:path";
4
- import { FileNotFoundError, InvalidGrepPatternError, PathError, tempFs, unionFs, WriteFailedError, } from "@cursor/sdk";
4
+ import { FileNotFoundError, InvalidGrepPatternError, PathError, unionFs, WriteFailedError, } from "@cursor/sdk";
5
5
  import { minimatch } from "minimatch";
6
6
  import { FileConflictError } from "./files.js";
7
7
  import { MEMORY_DIR_NAME } from "./internal/memory-dir.js";
8
+ import { hostPathFromToolPath } from "./internal/tool-paths.js";
8
9
  import { isExcludedPath, listFilesFromPaths, statFromFilePaths, } from "./internal/filesystem/walk.js";
9
10
  export { childOverlayFs, DeleteNotSupportedError, EditError, emptyFs, FILE_SYSTEM_SCAN_LIMIT, FileNotFoundError, InvalidGrepPatternError, isFileNotFoundError, isInvalidGrepPatternError, NoMountError, overlayFs, PathError, ReadOnlyMountError, readOnlyFs, remapPathError, strReplaceOnFileSystem, tempFs, unionFs, WriteFailedError, } from "@cursor/sdk";
10
- export const FILE_SYSTEM_TOOL_NAMES = [
11
- "Read",
12
- "LS",
13
- "Glob",
14
- "Grep",
15
- "Write",
16
- "StrReplace",
17
- "Delete",
18
- ];
19
- const FILE_SYSTEM_TOOL_NAME_SET = new Set(FILE_SYSTEM_TOOL_NAMES);
20
- const FILE_SYSTEM_TOOL_ALIASES = {
21
- read: "Read",
22
- Read: "Read",
23
- ls: "LS",
24
- LS: "LS",
25
- glob: "Glob",
26
- Glob: "Glob",
27
- grep: "Grep",
28
- Grep: "Grep",
29
- write: "Write",
30
- Write: "Write",
31
- edit: "StrReplace",
32
- StrReplace: "StrReplace",
33
- delete: "Delete",
34
- Delete: "Delete",
35
- };
36
- export function canonicalizeFileSystemToolName(name) {
37
- return FILE_SYSTEM_TOOL_ALIASES[name];
38
- }
39
- export function isFileSystemToolName(name) {
40
- return FILE_SYSTEM_TOOL_NAME_SET.has(name);
41
- }
42
- export function isFileSystemToolAlias(name) {
43
- return canonicalizeFileSystemToolName(name) !== undefined;
44
- }
45
- /** Direct `callTool` names that mutate the tree and must wait on a busy turn. */
46
- export function isMutatingFileSystemTool(name) {
47
- const canonical = canonicalizeFileSystemToolName(name);
48
- return canonical === "Write" || canonical === "StrReplace" || canonical === "Delete";
49
- }
50
- export function isFileSystemMethodPresent(root, method) {
51
- return typeof root[method] === "function";
52
- }
53
- const ADVERTISED_FILE_SYSTEM_TOOL_NAMES = [
54
- "Read",
55
- "LS",
56
- "Glob",
57
- "Grep",
58
- "Write",
59
- "StrReplace",
60
- "Delete",
61
- ];
62
- export function fileSystemToolNames(_root) {
63
- return [...ADVERTISED_FILE_SYSTEM_TOOL_NAMES];
64
- }
65
- function fileSystemMethodForTool(name) {
66
- switch (name) {
67
- case "Read":
68
- return "read";
69
- case "LS":
70
- return "list";
71
- case "Glob":
72
- return "glob";
73
- case "Grep":
74
- return "grep";
75
- case "Write":
76
- case "StrReplace":
77
- return "write";
78
- case "Delete":
79
- return "delete";
80
- default: {
81
- const unexpected = name;
82
- return unexpected;
83
- }
84
- }
85
- }
86
- function fileSystemSatisfiesFileTool(root, name) {
87
- const canonical = canonicalizeFileSystemToolName(name);
88
- if (canonical === undefined) {
89
- return true;
90
- }
91
- const method = fileSystemMethodForTool(canonical);
92
- return method !== undefined && isFileSystemMethodPresent(root, method);
93
- }
94
11
  export class FileSystemConfigError extends Error {
95
12
  constructor(message) {
96
13
  super(message);
97
14
  this.name = "FileSystemConfigError";
98
15
  }
99
16
  }
100
- function allowlistHas(tools, ...names) {
101
- return tools.some((name) => names.includes(name));
102
- }
103
17
  /**
104
- * Native semantic-search built-in. Host-default turns disallow it.
18
+ * Native semantic-search built-in. Host-disk turns disallow it.
105
19
  * The name is assembled so a source search for the old spelling does not
106
20
  * treat this disallow list as a live tool.
107
21
  */
@@ -127,87 +41,23 @@ export function assertNoRemovedFileSearchTools(tools) {
127
41
  }
128
42
  throw new FileSystemConfigError(`Semantic search has been removed. Use Grep. \`tools\` lists ${listed.join(", ")}.`);
129
43
  }
130
- export function resolveRootHarnessAllowlist(tools) {
131
- assertNoRemovedFileSearchTools(tools);
132
- if (tools === undefined) {
133
- // File verbs are synthesized from the tree. Web tools are safe under the `/tmp` scratch
134
- // overlay. Todos are harness conversation state. `task`
135
- // children inherit filesystem executors and this allowlist.
136
- // Do not unlock shell.
137
- return ["webSearch", "webFetch", "updateTodos", "readTodos", "task", "mcp"];
138
- }
139
- if (allowlistHas(tools, "shell", "Shell")) {
140
- throw new FileSystemConfigError('`fs` cannot be combined with `tools` containing `"shell"`. ' +
141
- "Shell is not a FileSystem method and must not bind the host shell onto a virtual tree.");
142
- }
143
- if (allowlistHas(tools, "readLints", "ReadLints")) {
144
- throw new FileSystemConfigError("`fs` cannot list `readLints`: FileSystem has no diagnostics " +
145
- "verb, so the host language service would run against the real workspace.");
146
- }
147
- const extras = tools.filter((name) => !isFileSystemToolAlias(name));
148
- return withMcpGrant(extras);
149
- }
150
- export function resolveFileSystemTools(options) {
151
- const harness = resolveRootHarnessAllowlist(options.tools);
152
- if (options.tools === undefined) {
153
- return harness;
154
- }
155
- const implemented = fileSystemToolNames(options.root);
156
- const missing = [];
157
- for (const name of options.tools) {
158
- if (!fileSystemSatisfiesFileTool(options.root, name)) {
159
- missing.push(name);
160
- }
161
- }
162
- if (missing.length > 0) {
163
- throw new FileSystemConfigError(`\`tools\` names FileSystem method(s) that are not implemented: ${missing.join(", ")}. ` +
164
- `Implemented file tools: ${implemented.length > 0 ? implemented.join(", ") : "(none)"}.`);
165
- }
166
- return harness;
167
- }
168
44
  export function withMcpGrant(tools) {
169
45
  return tools.includes("mcp") ? [...tools] : [...tools, "mcp"];
170
46
  }
171
47
  /**
172
- * Native Cursor SDK file tools replaced by synthesized FileSystem tools
173
- * on every local turn. SDK allowlist names (`edit`, not `Write`).
174
- */
175
- export const REPLACED_NATIVE_FILE_TOOLS = [
176
- "read",
177
- "ls",
178
- "grep",
179
- "glob",
180
- "edit",
181
- "delete",
182
- removedNativeFileSearchTool(),
183
- ];
184
- /**
185
- * Host-default harness options: keep shell / webSearch / sandbox, but
186
- * hide the native file tools the synthesized FileSystem now owns.
187
- *
188
- * Omitted `tools` leaves the SDK default set and only excludes the
189
- * replaced natives. `[]` stays empty. A non-empty allowlist drops file
190
- * aliases (those ride synthesized tools) and grants `mcp`.
48
+ * Host-disk harness options. Omitted `tools` keeps the SDK default set
49
+ * without semantic search. `[]` stays empty. A non-empty allowlist
50
+ * grants `mcp`, which carries the agent's own server tools.
191
51
  */
192
52
  export function resolveHostHarnessToolOptions(tools) {
193
53
  if (tools === undefined) {
194
- return { disallowedTools: [...REPLACED_NATIVE_FILE_TOOLS] };
54
+ return { disallowedTools: [removedNativeFileSearchTool()] };
195
55
  }
196
56
  if (tools.length === 0) {
197
57
  return { tools: [] };
198
58
  }
199
59
  assertNoRemovedFileSearchTools(tools);
200
- return {
201
- tools: withMcpGrant(tools.filter((name) => !isReplacedHostFileAlias(name))),
202
- };
203
- }
204
- /** File aliases host-default synthesizes in place of the native tools. */
205
- function isReplacedHostFileAlias(name) {
206
- return canonicalizeFileSystemToolName(name) !== undefined;
207
- }
208
- /** Decode a {@link FileSystem.read} result as UTF-8 text. */
209
- export function fileSystemText(content) {
210
- return typeof content === "string" ? content : Buffer.from(content).toString("utf8");
60
+ return { tools: withMcpGrant(tools) };
211
61
  }
212
62
  /**
213
63
  * Native Read image formats. Magic bytes first, then extension.
@@ -256,16 +106,6 @@ export function detectImageMimeType(bytes, filePath) {
256
106
  }
257
107
  return undefined;
258
108
  }
259
- export function fileSystemImage(content, path) {
260
- if (!(content instanceof Uint8Array)) {
261
- return undefined;
262
- }
263
- const mimeType = detectImageMimeType(content, path);
264
- if (mimeType === undefined) {
265
- return undefined;
266
- }
267
- return { mimeType, bytes: content };
268
- }
269
109
  function compileGrepPattern(pattern, caseInsensitive, path = "/") {
270
110
  try {
271
111
  return new RegExp(pattern, caseInsensitive === true ? "i" : undefined);
@@ -303,104 +143,6 @@ async function* limitResults(source, maxResults) {
303
143
  }
304
144
  }
305
145
  }
306
- function grepPushdownLimit(query, opts) {
307
- // Count and files_with_matches paginate after grouping by file.
308
- // A line-level cap would hide later files once one file fills the window.
309
- if (opts.outputMode === "count" || opts.outputMode === "files_with_matches") {
310
- return query.maxResults;
311
- }
312
- const headLimit = opts.headLimit !== undefined && opts.headLimit > 0 ? opts.headLimit : undefined;
313
- if (headLimit === undefined) {
314
- return query.maxResults;
315
- }
316
- const toolCap = opts.offset + headLimit;
317
- return query.maxResults === undefined ? toolCap : Math.min(query.maxResults, toolCap);
318
- }
319
- function compareGrepResult(left, right) {
320
- return left.path < right.path
321
- ? -1
322
- : left.path > right.path
323
- ? 1
324
- : left.lineNumber - right.lineNumber;
325
- }
326
- export async function collectGrepMatches(root, query, opts) {
327
- const matches = [];
328
- const offset = opts.offset !== undefined && opts.offset > 0 ? opts.offset : 0;
329
- const headLimit = opts.headLimit !== undefined && opts.headLimit > 0 ? opts.headLimit : undefined;
330
- const skippedFiles = new Set();
331
- const acceptedFiles = new Set();
332
- let skippedItems = 0;
333
- let takenItems = 0;
334
- const pushdown = grepPushdownLimit(query, {
335
- outputMode: opts.outputMode,
336
- offset,
337
- ...(opts.headLimit === undefined ? {} : { headLimit: opts.headLimit }),
338
- });
339
- const grepQuery = pushdown === undefined ? query : { ...query, maxResults: pushdown };
340
- for await (const match of root.grep(grepQuery)) {
341
- if (opts.outputMode === "content") {
342
- if (skippedItems < offset) {
343
- skippedItems++;
344
- continue;
345
- }
346
- matches.push(match);
347
- takenItems++;
348
- if (headLimit !== undefined && takenItems >= headLimit) {
349
- break;
350
- }
351
- continue;
352
- }
353
- if (skippedFiles.has(match.path)) {
354
- continue;
355
- }
356
- if (!acceptedFiles.has(match.path)) {
357
- if (skippedItems < offset) {
358
- skippedFiles.add(match.path);
359
- skippedItems++;
360
- continue;
361
- }
362
- if (headLimit !== undefined && takenItems >= headLimit) {
363
- break;
364
- }
365
- acceptedFiles.add(match.path);
366
- takenItems++;
367
- }
368
- matches.push(match);
369
- }
370
- return matches;
371
- }
372
- export function shapeGrepUnion(matches, outputMode) {
373
- if (outputMode === "files_with_matches") {
374
- const files = [...new Set(matches.map((match) => match.path))];
375
- return { type: "files", output: { files, count: files.length } };
376
- }
377
- if (outputMode === "count") {
378
- const counts = new Map();
379
- for (const match of matches) {
380
- counts.set(match.path, (counts.get(match.path) ?? 0) + 1);
381
- }
382
- return {
383
- type: "count",
384
- output: {
385
- counts: [...counts].map(([file, count]) => ({ file, count })),
386
- total: matches.length,
387
- },
388
- };
389
- }
390
- return {
391
- type: "content",
392
- output: {
393
- matches: matches.map((match) => ({
394
- file: match.path,
395
- lineNumber: match.lineNumber,
396
- line: match.line,
397
- ...(match.beforeContext === undefined ? {} : { beforeContext: match.beforeContext }),
398
- ...(match.afterContext === undefined ? {} : { afterContext: match.afterContext }),
399
- })),
400
- totalMatches: matches.length,
401
- },
402
- };
403
- }
404
146
  export function normalizeFsPath(input) {
405
147
  const slashes = input.replace(/\\/g, "/");
406
148
  if (slashes === "") {
@@ -492,19 +234,6 @@ export async function writeWorkspaceFilesToRoot(root, files) {
492
234
  }
493
235
  }
494
236
  }
495
- /** Native Read offset/limit: 1-indexed, negative offset counts from the end. */
496
- export function sliceReadContent(content, offset, limit) {
497
- if (offset === undefined && limit === undefined) {
498
- return content;
499
- }
500
- const lines = content === "" ? [] : content.split("\n");
501
- const total = lines.length;
502
- const effectiveOffset = offset ?? 1;
503
- const effectiveLimit = limit ?? (effectiveOffset < 0 ? Math.abs(effectiveOffset) : total);
504
- const startIndex = effectiveOffset < 0 ? Math.max(0, total + effectiveOffset) : Math.max(0, effectiveOffset - 1);
505
- const endIndex = Math.min(total, startIndex + effectiveLimit);
506
- return lines.slice(startIndex, endIndex).join("\n");
507
- }
508
237
  function fsErrorMessage(error, fallback) {
509
238
  return error instanceof Error ? error.message : fallback;
510
239
  }
@@ -657,8 +386,13 @@ export function localFileSystem(options) {
657
386
  const cwd = path.resolve(options.cwd);
658
387
  const confineToWorkspace = options.confineToWorkspace === true;
659
388
  const readOnlyRoots = (options.readOnlyRoots ?? []).map((root) => path.resolve(root));
660
- const resolvePath = (input) => path.isAbsolute(input) ? path.resolve(input) : path.resolve(cwd, input);
661
- const resolveWritable = (input) => confineToWorkspace ? confinedHostPath(cwd, input) : Promise.resolve(resolvePath(input));
389
+ const resolvePath = (toolPath) => {
390
+ const input = hostPathFromToolPath(toolPath);
391
+ return path.isAbsolute(input) ? path.resolve(input) : path.resolve(cwd, input);
392
+ };
393
+ const resolveWritable = (toolPath) => confineToWorkspace
394
+ ? confinedHostPath(cwd, hostPathFromToolPath(toolPath))
395
+ : Promise.resolve(resolvePath(toolPath));
662
396
  const resolveLocated = async (input) => {
663
397
  try {
664
398
  return await resolveWritable(input);
@@ -786,20 +520,24 @@ function omittedScan(path) {
786
520
  return path === undefined || path === "";
787
521
  }
788
522
  /**
789
- * The turn tree: authored files at `/`, scratch at `/tmp`, and an optional
790
- * skills mount. An omitted `grep` or `glob` path searches the authored
791
- * tree only, so a tree that narrows that call (for example to `/repo`)
792
- * does not also scan skills or scratch. An explicit path searches every
793
- * mount under it.
523
+ * The session tree: authored files at `/` and an optional skills mount.
524
+ * `scratch`, when given, is mounted at `/tmp`; a turn leaves it out
525
+ * because the SDK mounts its own `/tmp` for each run. An omitted `grep`
526
+ * or `glob` path searches the authored tree only, so a tree that narrows
527
+ * that call (for example to `/repo`) does not also scan skills or
528
+ * scratch. An explicit path searches every mount under it.
794
529
  */
795
530
  export function sessionFileSystem(options) {
796
- const mounts = {
797
- "/": options.authored,
798
- "/tmp": options.scratch ?? tempFs(),
799
- };
531
+ const mounts = { "/": options.authored };
532
+ if (options.scratch !== undefined) {
533
+ mounts["/tmp"] = options.scratch;
534
+ }
800
535
  if (options.skills !== undefined) {
801
536
  mounts[options.skills.path] = options.skills.fs;
802
537
  }
538
+ if (Object.keys(mounts).length === 1) {
539
+ return options.authored;
540
+ }
803
541
  const union = unionFs(mounts);
804
542
  return {
805
543
  list: (prefix, listOptions) => union.list(prefix, listOptions),
package/dist/index.d.ts CHANGED
@@ -25,13 +25,11 @@ export type { ContinuationBuiltin, ContinuationClaim, ContinuationIdentity, Cont
25
25
  export { classifyExpectedDeliveryFailure, type ExpectedDeliveryFailureReason, } from "./internal/expected-delivery-failure.js";
26
26
  export { cursorExternalApiUrl, resolveApiKeySync, type ResolvedApiKey, } from "./internal/cursor/credentials.js";
27
27
  export { parseScmPrUrl, type ParsedScmPrUrl } from "./internal/scm/pr-url.js";
28
- export { synthesizeFileSystemTools } from "./internal/filesystem/tools.js";
29
28
  export { validateToolInput, type ToolInputValidation } from "./internal/json-schema.js";
30
29
  export { normalizeToolResult } from "./internal/tool-result.js";
31
30
  export { resolveAgentV2Hosting, type AgentV2HostingKind } from "./agent-v2-hosting.js";
32
31
  export type { LoadAgentProjectOptions } from "./public-deprecated.js";
33
32
  export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, mintClaim, projectInfo, resolveAgentMounts, } from "./public-deprecated.js";
34
- export { nearestNeighborMissHint } from "./internal/filesystem/nearest.js";
35
33
  export type { AgentServeGitHubTriggerEvent, AgentServeGitHubTriggerTarget, AgentServeOriginTriggerEvent, AgentServeOriginTriggerTarget, AgentServeTriggerEvent, AgentServeTriggerResult, AgentServeTriggerTargetResult, } from "./internal/handleAgentServeTrigger.js";
36
34
  export { collectGitHubTriggerTargets, collectOriginTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
37
35
  export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPOINT_PATH, } from "./internal/mcp-endpoint.js";
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/dist/index.js CHANGED
@@ -29,12 +29,10 @@ export { InvalidAsOfError, VacuousTimeArgsError } from "./internal/as-of.js";
29
29
  export { classifyExpectedDeliveryFailure, } from "./internal/expected-delivery-failure.js";
30
30
  export { cursorExternalApiUrl, resolveApiKeySync, } from "./internal/cursor/credentials.js";
31
31
  export { parseScmPrUrl } from "./internal/scm/pr-url.js";
32
- export { synthesizeFileSystemTools } from "./internal/filesystem/tools.js";
33
32
  export { validateToolInput } from "./internal/json-schema.js";
34
33
  export { normalizeToolResult } from "./internal/tool-result.js";
35
34
  export { resolveAgentV2Hosting } from "./agent-v2-hosting.js";
36
35
  export { formatDiagnostics, hasErrorDiagnostics, isAgentProjectDir, loadAgentProject, loadAgentProjects, mintClaim, projectInfo, resolveAgentMounts, } from "./public-deprecated.js";
37
- export { nearestNeighborMissHint } from "./internal/filesystem/nearest.js";
38
36
  export { collectGitHubTriggerTargets, collectOriginTriggerTargets, handleAgentServeTrigger, } from "./internal/handleAgentServeTrigger.js";
39
37
  export { MCP_CHANNEL_ID, MCP_ENDPOINT_PATH, mcpEndpointToolNames, TOOL_MCP_ENDPOINT_PATH, } from "./internal/mcp-endpoint.js";
40
38
  export { REMINDER_ARGS_MAX_BYTES, ReminderValidationError, rejectAnonymousReminderHandlers, UnknownReminderError, } from "./internal/reminder-runner.js";
@@ -6,9 +6,9 @@ export declare function httpContinuationIdentity(httpChannel: HttpChannelDefinit
6
6
  * Stamp `/v2` continuation defaults onto channel constructors that omitted
7
7
  * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
8
8
  * type (`pr` / `issue` / `none`) follows declared webhook events.
9
- * Deployments default to `deployments.deployment/v2`. Change Monitors
10
- * and issues default to `change_monitors.checkpoint/v2` and
11
- * `issues.issue/v2`.
9
+ * Deployments default to `deployments.deployment/v2`. Change Monitors,
10
+ * issues, runs, and match-ready default to `change_monitors.checkpoint/v2`,
11
+ * `issues.issue/v2`, `runs.run/v2`, and `match_ready.monitor/v2`.
12
12
  * Explicit per-channel selectors are left alone. Idempotent.
13
13
  */
14
14
  export declare function applyAgentContinuationDefaults(project: {
@@ -66,9 +66,9 @@ export function httpContinuationIdentity(httpChannel) {
66
66
  * Stamp `/v2` continuation defaults onto channel constructors that omitted
67
67
  * `continuation` when the agent deploys onto v2 architecture. GitHub/Origin
68
68
  * type (`pr` / `issue` / `none`) follows declared webhook events.
69
- * Deployments default to `deployments.deployment/v2`. Change Monitors
70
- * and issues default to `change_monitors.checkpoint/v2` and
71
- * `issues.issue/v2`.
69
+ * Deployments default to `deployments.deployment/v2`. Change Monitors,
70
+ * issues, runs, and match-ready default to `change_monitors.checkpoint/v2`,
71
+ * `issues.issue/v2`, `runs.run/v2`, and `match_ready.monitor/v2`.
72
72
  * Explicit per-channel selectors are left alone. Idempotent.
73
73
  */
74
74
  export function applyAgentContinuationDefaults(project) {
@@ -12,22 +12,23 @@
12
12
  * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
13
13
  * `github.none/v2`, `slack.thread/v2`, `origin.pr/v2`,
14
14
  * `deployments.deployment/v2`, `change_monitors.checkpoint/v2`,
15
- * `issues.issue/v2`, …) onto every channel that omitted a
16
- * selector. An explicit per-channel selector still overrides. JSONPath
15
+ * `issues.issue/v2`, `runs.run/v2`, `match_ready.monitor/v2`, …) onto
16
+ * every channel that omitted a selector. An explicit per-channel selector
17
+ * still overrides. JSONPath
17
18
  * and per-agent format strings are rejected.
18
19
  */
19
20
  import { type SlackDmScope } from "./slack-thread-key.js";
20
21
  export type ConversationType = "pr" | "issue" | "thread" | "dm-thread" | "origin-pr" | "gitlab-mr" | "bitbucket-pr" | "deployment" | "run" | "pagerduty-incident";
21
22
  /** Factory kinds registered by the hosted entry. They stay off the public union. */
22
- type RuntimeConversationType = ConversationType | "change-monitor-checkpoint" | "factory-issue";
23
+ type RuntimeConversationType = ConversationType | "change-monitor-checkpoint" | "factory-issue" | "match-ready";
23
24
  type RuntimeParsedContinuation = {
24
25
  selector: ContinuationSelector;
25
26
  version: 1 | 2;
26
27
  type: RuntimeConversationType | "none";
27
28
  kind: ContinuationKind;
28
29
  };
29
- export type ContinuationKind = "github" | "slack" | "origin" | "gitlab" | "bitbucket" | "deployments" | "change_monitors" | "issues" | "runs" | "pagerduty" | "http";
30
- export declare const CONTINUATION_SELECTORS: readonly ["github.pr/v1", "github.pr/v2", "github.issue/v1", "github.issue/v2", "github.none/v2", "slack.thread/v1", "slack.thread/v2", "slack.dmthread/v2", "slack.none/v2", "origin.pr/v1", "origin.pr/v2", "origin.none/v2", "gitlab.mr/v2", "gitlab.none/v2", "bitbucket.pr/v2", "bitbucket.none/v2", "deployments.none/v1", "deployments.none/v2", "deployments.deployment/v2", "change_monitors.checkpoint/v2", "issues.issue/v2", "runs.run/v2", "pagerduty.incident/v2", "pagerduty.none/v2", "none/v1", "none/v2"];
30
+ export type ContinuationKind = "github" | "slack" | "origin" | "gitlab" | "bitbucket" | "deployments" | "change_monitors" | "issues" | "runs" | "match_ready" | "pagerduty" | "http";
31
+ export declare const CONTINUATION_SELECTORS: readonly ["github.pr/v1", "github.pr/v2", "github.issue/v1", "github.issue/v2", "github.none/v2", "slack.thread/v1", "slack.thread/v2", "slack.dmthread/v2", "slack.none/v2", "origin.pr/v1", "origin.pr/v2", "origin.none/v2", "gitlab.mr/v2", "gitlab.none/v2", "bitbucket.pr/v2", "bitbucket.none/v2", "deployments.none/v1", "deployments.none/v2", "deployments.deployment/v2", "change_monitors.checkpoint/v2", "issues.issue/v2", "runs.run/v2", "match_ready.monitor/v2", "pagerduty.incident/v2", "pagerduty.none/v2", "none/v1", "none/v2"];
31
32
  export type ContinuationSelector = (typeof CONTINUATION_SELECTORS)[number];
32
33
  export type ContinuationIdentity = ContinuationSelector;
33
34
  /** Agent-root protocol version. Omit / `"v1"` keeps engine minting. */
@@ -1 +1 @@
1
- {"version":3,"file":"continuation-identity.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-identity.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"continuation-identity.d.ts","sourceRoot":"","sources":["../../src/internal/continuation-identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAE,KAAK,YAAY,EAAuC,MAAM,uBAAuB,CAAC;AAE/F,MAAM,MAAM,gBAAgB,GACxB,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,WAAW,GACX,WAAW,GACX,WAAW,GACX,cAAc,GACd,YAAY,GACZ,KAAK,GACL,oBAAoB,CAAC;AAEzB,oFAAoF;AACpF,KAAK,uBAAuB,GACxB,gBAAgB,GAChB,2BAA2B,GAC3B,eAAe,GACf,aAAa,CAAC;AAElB,KAAK,yBAAyB,GAAG;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,uBAAuB,GAAG,MAAM,CAAC;IACvC,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,aAAa,GACb,iBAAiB,GACjB,QAAQ,GACR,MAAM,GACN,aAAa,GACb,WAAW,GACX,MAAM,CAAC;AAEX,eAAO,MAAM,sBAAsB,YACjC,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,+BAA+B,EAC/B,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,SAAS,EACT,SAAS,CACD,CAAC;AAEX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AACxD,uEAAuE;AACvE,MAAM,MAAM,2BAA2B,GAAG,IAAI,GAAG,IAAI,CAAC;AAEtD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACf,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAChC,IAAI,EAAE,gBAAgB,CAAC;CACxB,CAAC;AAIF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF,8EAA8E;AAC9E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,GAClD,cAAc,CAIhB;AAUD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,gBAAgB,CAAC;IACvB,QAAQ,EACJ;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9D;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACvC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GACnD;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GACxB;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GACpC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,YACzC,oBAAoB,EACpB,uBAAuB,EACvB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,2BAA2B,EAC3B,gCAAgC,EAChC,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,EAC5B,kCAAkC,EAClC,oCAAoC,EACpC,sCAAsC,EACtC,2BAA2B,EAC3B,6BAA6B,CACrB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,gBAAgB,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IACxC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAWF,eAAO,MAAM,QAAQ,EAAE,SAAS,mBAAmB,EAkGzC,CAAC;AAEX,qBAAa,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AA8DD,wBAAgB,2BAA2B,CACzC,IAAI,CAAC,EAAE,MAAM,EACb,OAAO,GAAE,2BAAkC,EAC3C,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B,oBAAoB,CAwDtB;AA4CD,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,uBAAuB,GAAG,SAAS,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,QAAQ,EAAE,oBAAoB,CAAC;IAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAqB/E;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,GAAG,SAAS,CAKjG;AAWD,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAEnF;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAE7E;AAMD,wBAAgB,kBAAkB,CAChC,QAAQ,CAAC,EAAE,oBAAoB,EAC/B,IAAI,CAAC,EAAE,MAAM,GACZ,QAAQ,GAAG,eAAe,CAE5B;AAED,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/D;AAED,4FAA4F;AAC5F,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE7D;AAoHD,wBAAgB,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,cAAc,GAAG,MAAM,CAK3E;AAyGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,oBAAoB,CAAC;CACjC,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqC9C;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,uBAAuB,EAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,MAAM,GAAG,SAAS,CA2CpB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,oBAAoB,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,GACZ,mBAAmB,CAarB;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,oBAAoB,EAC9B,OAAO,EAAE;IACP,KAAK,CAAC,EAAE,iBAAiB,GAAG,cAAc,CAAC;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,EACD,IAAI,CAAC,EAAE,MAAM,GACZ,MAAM,CA0BR;AAED,wBAAgB,2BAA2B,CACzC,QAAQ,EACR,QAAQ,SAAS;IAAE,mBAAmB,CAAC,EAAE,mBAAmB,CAAA;CAAE,EAE9D,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,EAChE,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,KAAK,OAAO,CAAC,QAAQ,CAAC,CAU5D"}
@@ -12,8 +12,9 @@
12
12
  * the channel kind and declared events (`github.pr/v2`, `github.issue/v2`,
13
13
  * `github.none/v2`, `slack.thread/v2`, `origin.pr/v2`,
14
14
  * `deployments.deployment/v2`, `change_monitors.checkpoint/v2`,
15
- * `issues.issue/v2`, …) onto every channel that omitted a
16
- * selector. An explicit per-channel selector still overrides. JSONPath
15
+ * `issues.issue/v2`, `runs.run/v2`, `match_ready.monitor/v2`, …) onto
16
+ * every channel that omitted a selector. An explicit per-channel selector
17
+ * still overrides. JSONPath
17
18
  * and per-agent format strings are rejected.
18
19
  */
19
20
  import { randomBytes } from "node:crypto";
@@ -43,6 +44,7 @@ export const CONTINUATION_SELECTORS = [
43
44
  "change_monitors.checkpoint/v2",
44
45
  "issues.issue/v2",
45
46
  "runs.run/v2",
47
+ "match_ready.monitor/v2",
46
48
  "pagerduty.incident/v2",
47
49
  "pagerduty.none/v2",
48
50
  "none/v1",
@@ -237,6 +239,11 @@ const SELECTOR_FIELDS = {
237
239
  type: "run",
238
240
  kind: "runs",
239
241
  },
242
+ "match_ready.monitor/v2": {
243
+ version: 2,
244
+ type: "match-ready",
245
+ kind: "match_ready",
246
+ },
240
247
  "pagerduty.incident/v2": {
241
248
  version: 2,
242
249
  type: "pagerduty-incident",
@@ -283,6 +290,8 @@ export function defaultContinuationSelector(kind, version = "v1", eventTypes) {
283
290
  return membershipOrNone(eventTypes, "factory-issue", "issues.issue/v2", "none/v2");
284
291
  case "runs":
285
292
  return membershipOrNone(eventTypes, "run", "runs.run/v2", "none/v2");
293
+ case "match_ready":
294
+ return membershipOrNone(eventTypes, "match-ready", "match_ready.monitor/v2", "none/v2");
286
295
  case "pagerduty":
287
296
  return membershipOrNone(eventTypes, "pagerduty-incident", "pagerduty.incident/v2", "pagerduty.none/v2");
288
297
  default:
@@ -316,6 +325,7 @@ const OMITTED_V2_TYPED_TYPE = {
316
325
  change_monitors: "change-monitor-checkpoint",
317
326
  issues: "factory-issue",
318
327
  runs: "run",
328
+ match_ready: "match-ready",
319
329
  pagerduty: "pagerduty-incident",
320
330
  };
321
331
  function isOmittedV2Kind(kind) {
@@ -400,6 +410,7 @@ function isRegisteredKind(kind) {
400
410
  case "change_monitors":
401
411
  case "issues":
402
412
  case "runs":
413
+ case "match_ready":
403
414
  case "pagerduty":
404
415
  return true;
405
416
  default:
@@ -441,6 +452,8 @@ function formatConversationKey(type, fields) {
441
452
  return `issues:${fields.issueName}`;
442
453
  case "run":
443
454
  return `runs:${fields.monitorId}:${fields.runId}`;
455
+ case "match-ready":
456
+ return `match_ready:${fields.changeMonitorName}`;
444
457
  case "pagerduty-incident":
445
458
  return `pagerduty:incident:${fields.incidentId}`;
446
459
  default: {
@@ -636,6 +649,8 @@ export function extractContinuation(type, eventName, payload) {
636
649
  return extractNamedResource("factory-issue", "issueName", payload, "issue");
637
650
  case "run":
638
651
  return extractRun(payload);
652
+ case "match-ready":
653
+ return extractNamedResource("match-ready", "changeMonitorName", payload, "changeMonitor");
639
654
  case "pagerduty-incident":
640
655
  return extractPagerDuty(payload);
641
656
  default: {
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Native file tools for direct tool calls (`POST /v1/tools/:toolName`).
3
+ * The tools themselves are the SDK's `createFileSystemTools`; this module
4
+ * only maps the names a caller may use onto them and applies the agent's
5
+ * `tools` allowlist the way a turn does.
6
+ */
7
+ import type { FileSystemTools, ToolName } from "@cursor/sdk";
8
+ export type DirectFileToolName = keyof FileSystemTools;
9
+ /**
10
+ * The file tool a direct call runs. `edit` with `fileText` or `contents`
11
+ * is Write; any other `edit` is StrReplace.
12
+ */
13
+ export declare function directFileToolName(name: string, input: unknown): DirectFileToolName | undefined;
14
+ /** Omitted `tools` allows every file tool, as it does in a turn. */
15
+ export declare function directFileToolAllowed(name: DirectFileToolName, tools: readonly ToolName[] | undefined): boolean;
16
+ /**
17
+ * Where the SDK spills large WebFetch and WebSearch output for a host
18
+ * cwd. Direct Read calls on a host-disk agent may read it.
19
+ */
20
+ export declare function hostAgentToolsDir(cwd: string): string;
21
+ //# sourceMappingURL=direct-file-tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"direct-file-tools.d.ts","sourceRoot":"","sources":["../../src/internal/direct-file-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG7D,MAAM,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC;AA6BvD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAM/F;AAED,oEAAoE;AACpE,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG,SAAS,GACrC,OAAO,CAET;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAMrD"}