mervexai 0.0.97

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 (782) hide show
  1. package/AGENTS.md +131 -0
  2. package/Dockerfile +18 -0
  3. package/README.md +15 -0
  4. package/bin/mervex +222 -0
  5. package/bunfig.toml +7 -0
  6. package/git +0 -0
  7. package/migration/20260511173437_session-metadata/migration.sql +1 -0
  8. package/migration/20260511173437_session-metadata/snapshot.json +1500 -0
  9. package/package.json +159 -0
  10. package/parsers-config.ts +1 -0
  11. package/script/bench-search.ts +94 -0
  12. package/script/bench-test-suite.ts +52 -0
  13. package/script/build.ts +257 -0
  14. package/script/generate.ts +14 -0
  15. package/script/httpapi-exercise.ts +1 -0
  16. package/script/postinstall.mjs +185 -0
  17. package/script/profile-test-files.ts +42 -0
  18. package/script/publish.ts +213 -0
  19. package/script/run-workspace-server +106 -0
  20. package/script/schema.ts +77 -0
  21. package/script/time.ts +6 -0
  22. package/script/trace-imports.ts +153 -0
  23. package/specs/effect/error-boundaries-plan.md +235 -0
  24. package/specs/effect/errors.md +207 -0
  25. package/specs/effect/facades.md +218 -0
  26. package/specs/effect/guide.md +247 -0
  27. package/specs/effect/instance-context.md +13 -0
  28. package/specs/effect/loose-ends.md +30 -0
  29. package/specs/effect/migration.md +62 -0
  30. package/specs/effect/routes.md +61 -0
  31. package/specs/effect/schema.md +88 -0
  32. package/specs/effect/server-package.md +58 -0
  33. package/specs/effect/todo.md +241 -0
  34. package/specs/effect/tools.md +88 -0
  35. package/specs/openapi-translation-cleanup.md +204 -0
  36. package/specs/tui-plugins.md +544 -0
  37. package/specs/v2/api.ts +67 -0
  38. package/specs/v2/message-shape.md +136 -0
  39. package/specs/v2/notifications.md +13 -0
  40. package/specs/v2/tui-command-shim.md +67 -0
  41. package/src/account/account.ts +481 -0
  42. package/src/account/repo.ts +171 -0
  43. package/src/account/schema.ts +99 -0
  44. package/src/account/url.ts +8 -0
  45. package/src/acp/agent.ts +95 -0
  46. package/src/acp/config-option.ts +203 -0
  47. package/src/acp/content.ts +269 -0
  48. package/src/acp/directory.ts +212 -0
  49. package/src/acp/error.ts +97 -0
  50. package/src/acp/event.ts +421 -0
  51. package/src/acp/permission.ts +254 -0
  52. package/src/acp/profile.ts +42 -0
  53. package/src/acp/service.ts +1105 -0
  54. package/src/acp/session.ts +232 -0
  55. package/src/acp/tool.ts +364 -0
  56. package/src/acp/usage.ts +243 -0
  57. package/src/agent/agent.ts +508 -0
  58. package/src/agent/generate.txt +75 -0
  59. package/src/agent/prompt/architect.txt +7 -0
  60. package/src/agent/prompt/ask.txt +7 -0
  61. package/src/agent/prompt/compaction.txt +5 -0
  62. package/src/agent/prompt/explore.txt +18 -0
  63. package/src/agent/prompt/summary.txt +11 -0
  64. package/src/agent/prompt/title.txt +44 -0
  65. package/src/agent/subagent-permissions.ts +27 -0
  66. package/src/audio.d.ts +14 -0
  67. package/src/auth/index.ts +97 -0
  68. package/src/background/job.ts +37 -0
  69. package/src/bus/global.ts +22 -0
  70. package/src/cli/bootstrap.ts +11 -0
  71. package/src/cli/cmd/account.ts +264 -0
  72. package/src/cli/cmd/acp.ts +73 -0
  73. package/src/cli/cmd/agent.ts +259 -0
  74. package/src/cli/cmd/attach.ts +148 -0
  75. package/src/cli/cmd/cmd.ts +7 -0
  76. package/src/cli/cmd/db.ts +62 -0
  77. package/src/cli/cmd/debug/agent.handler.ts +193 -0
  78. package/src/cli/cmd/debug/agent.ts +27 -0
  79. package/src/cli/cmd/debug/config.ts +14 -0
  80. package/src/cli/cmd/debug/file.ts +73 -0
  81. package/src/cli/cmd/debug/index.ts +87 -0
  82. package/src/cli/cmd/debug/lsp.ts +50 -0
  83. package/src/cli/cmd/debug/ripgrep.ts +79 -0
  84. package/src/cli/cmd/debug/scrap.ts +16 -0
  85. package/src/cli/cmd/debug/skill.ts +15 -0
  86. package/src/cli/cmd/debug/snapshot.ts +50 -0
  87. package/src/cli/cmd/debug/startup.ts +11 -0
  88. package/src/cli/cmd/debug/v2.ts +42 -0
  89. package/src/cli/cmd/export.ts +292 -0
  90. package/src/cli/cmd/generate.ts +54 -0
  91. package/src/cli/cmd/github.handler.ts +1606 -0
  92. package/src/cli/cmd/github.shared.ts +30 -0
  93. package/src/cli/cmd/github.ts +42 -0
  94. package/src/cli/cmd/import.ts +230 -0
  95. package/src/cli/cmd/mcp.ts +840 -0
  96. package/src/cli/cmd/models.ts +66 -0
  97. package/src/cli/cmd/plug.ts +230 -0
  98. package/src/cli/cmd/pr.ts +115 -0
  99. package/src/cli/cmd/prompt-display.ts +1 -0
  100. package/src/cli/cmd/providers.ts +594 -0
  101. package/src/cli/cmd/repair.ts +231 -0
  102. package/src/cli/cmd/run/demo.ts +1274 -0
  103. package/src/cli/cmd/run/entry.body.ts +205 -0
  104. package/src/cli/cmd/run/footer.command.tsx +1070 -0
  105. package/src/cli/cmd/run/footer.menu.tsx +351 -0
  106. package/src/cli/cmd/run/footer.permission.tsx +472 -0
  107. package/src/cli/cmd/run/footer.prompt.tsx +1306 -0
  108. package/src/cli/cmd/run/footer.question.tsx +573 -0
  109. package/src/cli/cmd/run/footer.subagent.tsx +175 -0
  110. package/src/cli/cmd/run/footer.ts +1129 -0
  111. package/src/cli/cmd/run/footer.view.tsx +945 -0
  112. package/src/cli/cmd/run/footer.width.ts +27 -0
  113. package/src/cli/cmd/run/permission.shared.ts +256 -0
  114. package/src/cli/cmd/run/prompt.editor.ts +157 -0
  115. package/src/cli/cmd/run/prompt.shared.ts +153 -0
  116. package/src/cli/cmd/run/question.shared.ts +340 -0
  117. package/src/cli/cmd/run/runtime.boot.ts +202 -0
  118. package/src/cli/cmd/run/runtime.lifecycle.ts +406 -0
  119. package/src/cli/cmd/run/runtime.queue.ts +349 -0
  120. package/src/cli/cmd/run/runtime.shared.ts +17 -0
  121. package/src/cli/cmd/run/runtime.stdin.ts +37 -0
  122. package/src/cli/cmd/run/runtime.ts +814 -0
  123. package/src/cli/cmd/run/scrollback.shared.ts +92 -0
  124. package/src/cli/cmd/run/scrollback.surface.ts +431 -0
  125. package/src/cli/cmd/run/scrollback.writer.tsx +352 -0
  126. package/src/cli/cmd/run/session-data.ts +1113 -0
  127. package/src/cli/cmd/run/session-replay.ts +374 -0
  128. package/src/cli/cmd/run/session.shared.ts +196 -0
  129. package/src/cli/cmd/run/splash.ts +280 -0
  130. package/src/cli/cmd/run/stream.transport.ts +1462 -0
  131. package/src/cli/cmd/run/stream.ts +175 -0
  132. package/src/cli/cmd/run/subagent-data.ts +876 -0
  133. package/src/cli/cmd/run/theme.ts +690 -0
  134. package/src/cli/cmd/run/tool.ts +1486 -0
  135. package/src/cli/cmd/run/trace.ts +94 -0
  136. package/src/cli/cmd/run/turn-summary.ts +47 -0
  137. package/src/cli/cmd/run/types.ts +350 -0
  138. package/src/cli/cmd/run/variant.shared.ts +216 -0
  139. package/src/cli/cmd/run.ts +1104 -0
  140. package/src/cli/cmd/serve.ts +24 -0
  141. package/src/cli/cmd/session.ts +147 -0
  142. package/src/cli/cmd/stats.ts +393 -0
  143. package/src/cli/cmd/tui.ts +317 -0
  144. package/src/cli/cmd/uninstall.ts +353 -0
  145. package/src/cli/cmd/upgrade.ts +74 -0
  146. package/src/cli/cmd/web.ts +84 -0
  147. package/src/cli/effect/prompt.ts +37 -0
  148. package/src/cli/effect-cmd.ts +96 -0
  149. package/src/cli/error.ts +130 -0
  150. package/src/cli/heap.ts +45 -0
  151. package/src/cli/logo.ts +1 -0
  152. package/src/cli/network.ts +80 -0
  153. package/src/cli/tui/layer.ts +8 -0
  154. package/src/cli/tui/validate-session.ts +29 -0
  155. package/src/cli/tui/worker.ts +80 -0
  156. package/src/cli/ui.ts +131 -0
  157. package/src/cli/upgrade.ts +68 -0
  158. package/src/command/index.ts +328 -0
  159. package/src/command/template/initialize.txt +66 -0
  160. package/src/command/template/review.txt +101 -0
  161. package/src/config/agent.ts +59 -0
  162. package/src/config/command.ts +39 -0
  163. package/src/config/config.ts +720 -0
  164. package/src/config/entry-name.ts +19 -0
  165. package/src/config/managed.ts +69 -0
  166. package/src/config/markdown.ts +36 -0
  167. package/src/config/parse.ts +61 -0
  168. package/src/config/paths.ts +45 -0
  169. package/src/config/plugin.ts +79 -0
  170. package/src/config/tui-cwd.ts +5 -0
  171. package/src/config/tui-host-attention.ts +21 -0
  172. package/src/config/tui-migrate.ts +132 -0
  173. package/src/config/tui.ts +276 -0
  174. package/src/config/variable.ts +91 -0
  175. package/src/control-plane/adapters/index.ts +41 -0
  176. package/src/control-plane/adapters/worktree.ts +96 -0
  177. package/src/control-plane/dev/README.md +19 -0
  178. package/src/control-plane/dev/debug-workspace-plugin.ts +73 -0
  179. package/src/control-plane/types.ts +59 -0
  180. package/src/control-plane/util.ts +39 -0
  181. package/src/control-plane/workspace-adapter-runtime.ts +51 -0
  182. package/src/control-plane/workspace-context.ts +26 -0
  183. package/src/control-plane/workspace.ts +966 -0
  184. package/src/effect/app-node-builder-v1.ts +12 -0
  185. package/src/effect/app-runtime.ts +135 -0
  186. package/src/effect/bootstrap-runtime.ts +19 -0
  187. package/src/effect/bridge.ts +84 -0
  188. package/src/effect/config-service.ts +67 -0
  189. package/src/effect/instance-ref.ts +11 -0
  190. package/src/effect/instance-registry.ts +12 -0
  191. package/src/effect/instance-state.ts +69 -0
  192. package/src/effect/promise.ts +17 -0
  193. package/src/effect/run-service.ts +47 -0
  194. package/src/effect/runner.ts +217 -0
  195. package/src/effect/runtime-flags.ts +78 -0
  196. package/src/env/index.ts +41 -0
  197. package/src/event-manifest.ts +3 -0
  198. package/src/event-v2-bridge.ts +71 -0
  199. package/src/format/formatter.ts +404 -0
  200. package/src/format/index.ts +203 -0
  201. package/src/format/output-style.ts +84 -0
  202. package/src/git/auto-commit.ts +70 -0
  203. package/src/git/index.ts +348 -0
  204. package/src/hooks/index.ts +172 -0
  205. package/src/id/id.ts +80 -0
  206. package/src/ide/index.ts +54 -0
  207. package/src/image/image.ts +172 -0
  208. package/src/index.ts +229 -0
  209. package/src/installation/index.ts +336 -0
  210. package/src/lsp/client.ts +650 -0
  211. package/src/lsp/diagnostic.ts +29 -0
  212. package/src/lsp/language.ts +121 -0
  213. package/src/lsp/launch.ts +21 -0
  214. package/src/lsp/lsp.ts +507 -0
  215. package/src/lsp/server.ts +1983 -0
  216. package/src/markdown.d.ts +4 -0
  217. package/src/mcp/auth.ts +163 -0
  218. package/src/mcp/browser.ts +37 -0
  219. package/src/mcp/catalog.ts +170 -0
  220. package/src/mcp/index.ts +1007 -0
  221. package/src/mcp/oauth-callback.ts +194 -0
  222. package/src/mcp/oauth-provider.ts +259 -0
  223. package/src/node.ts +4 -0
  224. package/src/patch/index.ts +686 -0
  225. package/src/permission/arity.ts +163 -0
  226. package/src/permission/evaluate.ts +1 -0
  227. package/src/permission/index.ts +223 -0
  228. package/src/permission/sandbox.ts +150 -0
  229. package/src/plugin/azure.ts +26 -0
  230. package/src/plugin/cerebras.ts +11 -0
  231. package/src/plugin/cloudflare.ts +65 -0
  232. package/src/plugin/digitalocean.ts +325 -0
  233. package/src/plugin/index.ts +316 -0
  234. package/src/plugin/install.ts +439 -0
  235. package/src/plugin/loader.ts +237 -0
  236. package/src/plugin/meta.ts +188 -0
  237. package/src/plugin/modal/modal.ts +17 -0
  238. package/src/plugin/modal/models.ts +133 -0
  239. package/src/plugin/openai/README.md +31 -0
  240. package/src/plugin/openai/codex.ts +572 -0
  241. package/src/plugin/openai/ws-pool.ts +271 -0
  242. package/src/plugin/openai/ws.ts +383 -0
  243. package/src/plugin/pty-environment.ts +24 -0
  244. package/src/plugin/shared.ts +323 -0
  245. package/src/plugin/snowflake-cortex.ts +507 -0
  246. package/src/plugin/tui/internal.ts +10 -0
  247. package/src/plugin/tui/runtime.ts +1131 -0
  248. package/src/plugin/xai.ts +339 -0
  249. package/src/project/bootstrap-service.ts +9 -0
  250. package/src/project/bootstrap.ts +58 -0
  251. package/src/project/instance-context.ts +24 -0
  252. package/src/project/instance-runtime.ts +16 -0
  253. package/src/project/instance-store.ts +213 -0
  254. package/src/project/project.ts +483 -0
  255. package/src/project/vcs.ts +423 -0
  256. package/src/provider/auth.ts +229 -0
  257. package/src/provider/error.ts +195 -0
  258. package/src/provider/model-status.ts +8 -0
  259. package/src/provider/provider.ts +2399 -0
  260. package/src/provider/transform.ts +1856 -0
  261. package/src/question/index.ts +161 -0
  262. package/src/question/schema.ts +4 -0
  263. package/src/server/auth.ts +48 -0
  264. package/src/server/event.ts +10 -0
  265. package/src/server/global-lifecycle.ts +28 -0
  266. package/src/server/init-projectors.ts +3 -0
  267. package/src/server/mdns.ts +47 -0
  268. package/src/server/projectors.ts +1 -0
  269. package/src/server/proxy-util.ts +48 -0
  270. package/src/server/routes/instance/httpapi/AGENTS.md +39 -0
  271. package/src/server/routes/instance/httpapi/api.ts +97 -0
  272. package/src/server/routes/instance/httpapi/errors.ts +193 -0
  273. package/src/server/routes/instance/httpapi/groups/config.ts +65 -0
  274. package/src/server/routes/instance/httpapi/groups/control-plane.ts +35 -0
  275. package/src/server/routes/instance/httpapi/groups/control.ts +76 -0
  276. package/src/server/routes/instance/httpapi/groups/event.ts +29 -0
  277. package/src/server/routes/instance/httpapi/groups/experimental.ts +275 -0
  278. package/src/server/routes/instance/httpapi/groups/file.ts +185 -0
  279. package/src/server/routes/instance/httpapi/groups/global.ts +163 -0
  280. package/src/server/routes/instance/httpapi/groups/instance.ts +206 -0
  281. package/src/server/routes/instance/httpapi/groups/mcp.ts +156 -0
  282. package/src/server/routes/instance/httpapi/groups/metadata.ts +18 -0
  283. package/src/server/routes/instance/httpapi/groups/permission.ts +61 -0
  284. package/src/server/routes/instance/httpapi/groups/project-copy.ts +32 -0
  285. package/src/server/routes/instance/httpapi/groups/project.ts +93 -0
  286. package/src/server/routes/instance/httpapi/groups/provider.ts +101 -0
  287. package/src/server/routes/instance/httpapi/groups/pty.ts +172 -0
  288. package/src/server/routes/instance/httpapi/groups/query.ts +12 -0
  289. package/src/server/routes/instance/httpapi/groups/question.ts +74 -0
  290. package/src/server/routes/instance/httpapi/groups/session.ts +462 -0
  291. package/src/server/routes/instance/httpapi/groups/sync.ts +113 -0
  292. package/src/server/routes/instance/httpapi/groups/tui.ts +208 -0
  293. package/src/server/routes/instance/httpapi/groups/workspace.ts +141 -0
  294. package/src/server/routes/instance/httpapi/handlers/config.ts +34 -0
  295. package/src/server/routes/instance/httpapi/handlers/control-plane.ts +37 -0
  296. package/src/server/routes/instance/httpapi/handlers/control.ts +43 -0
  297. package/src/server/routes/instance/httpapi/handlers/event.ts +99 -0
  298. package/src/server/routes/instance/httpapi/handlers/experimental.ts +193 -0
  299. package/src/server/routes/instance/httpapi/handlers/file.ts +139 -0
  300. package/src/server/routes/instance/httpapi/handlers/global.ts +144 -0
  301. package/src/server/routes/instance/httpapi/handlers/instance.ts +110 -0
  302. package/src/server/routes/instance/httpapi/handlers/mcp.ts +111 -0
  303. package/src/server/routes/instance/httpapi/handlers/permission.ts +41 -0
  304. package/src/server/routes/instance/httpapi/handlers/project-copy.ts +83 -0
  305. package/src/server/routes/instance/httpapi/handlers/project.ts +63 -0
  306. package/src/server/routes/instance/httpapi/handlers/provider.ts +116 -0
  307. package/src/server/routes/instance/httpapi/handlers/pty.ts +273 -0
  308. package/src/server/routes/instance/httpapi/handlers/question.ts +54 -0
  309. package/src/server/routes/instance/httpapi/handlers/session-errors.ts +21 -0
  310. package/src/server/routes/instance/httpapi/handlers/session.ts +442 -0
  311. package/src/server/routes/instance/httpapi/handlers/sync.ts +89 -0
  312. package/src/server/routes/instance/httpapi/handlers/tui.ts +131 -0
  313. package/src/server/routes/instance/httpapi/handlers/workspace.ts +102 -0
  314. package/src/server/routes/instance/httpapi/lifecycle.ts +54 -0
  315. package/src/server/routes/instance/httpapi/middleware/authorization.ts +150 -0
  316. package/src/server/routes/instance/httpapi/middleware/compression.ts +64 -0
  317. package/src/server/routes/instance/httpapi/middleware/cors-vary.ts +29 -0
  318. package/src/server/routes/instance/httpapi/middleware/error.ts +43 -0
  319. package/src/server/routes/instance/httpapi/middleware/fence.ts +25 -0
  320. package/src/server/routes/instance/httpapi/middleware/instance-context.ts +43 -0
  321. package/src/server/routes/instance/httpapi/middleware/proxy.ts +131 -0
  322. package/src/server/routes/instance/httpapi/middleware/schema-error.ts +41 -0
  323. package/src/server/routes/instance/httpapi/middleware/workspace-routing.ts +250 -0
  324. package/src/server/routes/instance/httpapi/public.ts +537 -0
  325. package/src/server/routes/instance/httpapi/server.ts +325 -0
  326. package/src/server/routes/instance/httpapi/websocket-tracker.ts +60 -0
  327. package/src/server/server.ts +227 -0
  328. package/src/server/shared/fence.ts +60 -0
  329. package/src/server/shared/pty-ticket.ts +15 -0
  330. package/src/server/shared/public-ui.ts +12 -0
  331. package/src/server/shared/tui-control.ts +28 -0
  332. package/src/server/shared/ui.ts +108 -0
  333. package/src/server/shared/workspace-routing.ts +45 -0
  334. package/src/server/tui-event.ts +1 -0
  335. package/src/session/auto-skill.ts +71 -0
  336. package/src/session/compaction.ts +637 -0
  337. package/src/session/instruction.ts +237 -0
  338. package/src/session/llm/AGENTS.md +90 -0
  339. package/src/session/llm/ai-sdk.ts +291 -0
  340. package/src/session/llm/native-request.ts +196 -0
  341. package/src/session/llm/native-runtime.ts +195 -0
  342. package/src/session/llm/request.ts +229 -0
  343. package/src/session/llm.ts +404 -0
  344. package/src/session/message-error.ts +14 -0
  345. package/src/session/message-v2.ts +737 -0
  346. package/src/session/message.ts +148 -0
  347. package/src/session/overflow.ts +69 -0
  348. package/src/session/processor.ts +718 -0
  349. package/src/session/prompt/anthropic.txt +105 -0
  350. package/src/session/prompt/beast.txt +147 -0
  351. package/src/session/prompt/build-switch.txt +5 -0
  352. package/src/session/prompt/codex.txt +79 -0
  353. package/src/session/prompt/copilot-gpt-5.txt +143 -0
  354. package/src/session/prompt/default.txt +95 -0
  355. package/src/session/prompt/gemini.txt +155 -0
  356. package/src/session/prompt/gpt.txt +107 -0
  357. package/src/session/prompt/kimi.txt +95 -0
  358. package/src/session/prompt/meta.txt +65 -0
  359. package/src/session/prompt/plan-mode.txt +70 -0
  360. package/src/session/prompt/plan-reminder-anthropic.txt +67 -0
  361. package/src/session/prompt/plan.txt +26 -0
  362. package/src/session/prompt/trinity.txt +97 -0
  363. package/src/session/prompt.ts +2151 -0
  364. package/src/session/rate-limit.ts +176 -0
  365. package/src/session/reminders.ts +92 -0
  366. package/src/session/retry.ts +211 -0
  367. package/src/session/revert.ts +136 -0
  368. package/src/session/run-state.ts +151 -0
  369. package/src/session/schema.ts +26 -0
  370. package/src/session/session.ts +1050 -0
  371. package/src/session/speculation.ts +88 -0
  372. package/src/session/status.ts +56 -0
  373. package/src/session/summary.ts +164 -0
  374. package/src/session/system.ts +152 -0
  375. package/src/session/todo.ts +74 -0
  376. package/src/session/tools.ts +626 -0
  377. package/src/session/watch.ts +86 -0
  378. package/src/share/session.ts +58 -0
  379. package/src/share/share-next.ts +371 -0
  380. package/src/skill/discovery.ts +140 -0
  381. package/src/skill/index.ts +430 -0
  382. package/src/skill/restriction.ts +62 -0
  383. package/src/snapshot/index.ts +807 -0
  384. package/src/sql.d.ts +4 -0
  385. package/src/storage/schema.ts +5 -0
  386. package/src/storage/storage.ts +327 -0
  387. package/src/sync/README.md +179 -0
  388. package/src/sync/schema.ts +11 -0
  389. package/src/temporary.ts +31 -0
  390. package/src/tool/apply_patch.ts +313 -0
  391. package/src/tool/apply_patch.txt +33 -0
  392. package/src/tool/audio-gen.ts +50 -0
  393. package/src/tool/code-mode.ts +310 -0
  394. package/src/tool/diff-context.ts +64 -0
  395. package/src/tool/edit.ts +749 -0
  396. package/src/tool/edit.txt +10 -0
  397. package/src/tool/external-directory.ts +49 -0
  398. package/src/tool/glob.ts +76 -0
  399. package/src/tool/glob.txt +6 -0
  400. package/src/tool/grep.ts +115 -0
  401. package/src/tool/grep.txt +8 -0
  402. package/src/tool/image-gen.ts +50 -0
  403. package/src/tool/invalid.ts +21 -0
  404. package/src/tool/json-schema.ts +164 -0
  405. package/src/tool/lsp.ts +113 -0
  406. package/src/tool/lsp.txt +24 -0
  407. package/src/tool/mcp-websearch.ts +96 -0
  408. package/src/tool/plan-enter.txt +14 -0
  409. package/src/tool/plan-exit.txt +13 -0
  410. package/src/tool/plan.ts +79 -0
  411. package/src/tool/question.ts +44 -0
  412. package/src/tool/question.txt +10 -0
  413. package/src/tool/read.ts +386 -0
  414. package/src/tool/read.txt +14 -0
  415. package/src/tool/registry.ts +478 -0
  416. package/src/tool/repomap.ts +287 -0
  417. package/src/tool/schema.ts +14 -0
  418. package/src/tool/shell/id.ts +19 -0
  419. package/src/tool/shell/prompt.ts +295 -0
  420. package/src/tool/shell/shell.txt +21 -0
  421. package/src/tool/shell.ts +684 -0
  422. package/src/tool/skill.ts +81 -0
  423. package/src/tool/skill.txt +5 -0
  424. package/src/tool/task.ts +461 -0
  425. package/src/tool/task.txt +21 -0
  426. package/src/tool/todo.ts +46 -0
  427. package/src/tool/todowrite.txt +44 -0
  428. package/src/tool/tool.ts +183 -0
  429. package/src/tool/truncate.ts +156 -0
  430. package/src/tool/truncation-dir.ts +4 -0
  431. package/src/tool/video-gen.ts +50 -0
  432. package/src/tool/webfetch.ts +192 -0
  433. package/src/tool/webfetch.txt +13 -0
  434. package/src/tool/websearch.ts +143 -0
  435. package/src/tool/websearch.txt +14 -0
  436. package/src/tool/write.ts +117 -0
  437. package/src/tool/write.txt +8 -0
  438. package/src/util/archive.ts +17 -0
  439. package/src/util/bom.ts +27 -0
  440. package/src/util/data-url.ts +9 -0
  441. package/src/util/defer.ts +10 -0
  442. package/src/util/effect-http-client.ts +11 -0
  443. package/src/util/error.ts +1 -0
  444. package/src/util/filesystem.ts +251 -0
  445. package/src/util/html.ts +8 -0
  446. package/src/util/iife.ts +3 -0
  447. package/src/util/lazy.ts +20 -0
  448. package/src/util/local-context.ts +25 -0
  449. package/src/util/locale.ts +2 -0
  450. package/src/util/media.ts +26 -0
  451. package/src/util/process.ts +177 -0
  452. package/src/util/proxy-env.ts +72 -0
  453. package/src/util/queue.ts +32 -0
  454. package/src/util/record.ts +1 -0
  455. package/src/util/repository.ts +232 -0
  456. package/src/util/rpc.ts +66 -0
  457. package/src/util/signal.ts +12 -0
  458. package/src/util/timeout.ts +13 -0
  459. package/src/util/token.ts +1 -0
  460. package/src/util/wildcard.ts +59 -0
  461. package/src/verify/verify.ts +106 -0
  462. package/src/worktree/index.ts +623 -0
  463. package/sst-env.d.ts +10 -0
  464. package/test/AGENTS.md +204 -0
  465. package/test/EFFECT_TEST_MIGRATION.md +169 -0
  466. package/test/account/repo.test.ts +355 -0
  467. package/test/account/service.test.ts +524 -0
  468. package/test/acp/config-option.test.ts +229 -0
  469. package/test/acp/content.test.ts +235 -0
  470. package/test/acp/directory.test.ts +188 -0
  471. package/test/acp/error.test.ts +67 -0
  472. package/test/acp/event.test.ts +751 -0
  473. package/test/acp/permission.test.ts +401 -0
  474. package/test/acp/service-session.test.ts +1374 -0
  475. package/test/acp/session.test.ts +201 -0
  476. package/test/acp/tool.test.ts +298 -0
  477. package/test/acp/usage.test.ts +318 -0
  478. package/test/agent/agent.test.ts +755 -0
  479. package/test/agent/plan-mode-subagent-bypass.test.ts +160 -0
  480. package/test/agent/plugin-agent-regression.test.ts +51 -0
  481. package/test/auth/auth.test.ts +75 -0
  482. package/test/background/job.test.ts +244 -0
  483. package/test/cli/account.test.ts +30 -0
  484. package/test/cli/acp/acp-test-client.ts +97 -0
  485. package/test/cli/acp/config-options.test.ts +103 -0
  486. package/test/cli/acp/helpers.ts +96 -0
  487. package/test/cli/acp/initialize-auth.test.ts +61 -0
  488. package/test/cli/acp/lifecycle.test.ts +118 -0
  489. package/test/cli/acp/prompt-content.test.ts +97 -0
  490. package/test/cli/acp/skills.test.ts +38 -0
  491. package/test/cli/cmd/tui/attention.test.ts +484 -0
  492. package/test/cli/effect-cmd-instance-als.test.ts +40 -0
  493. package/test/cli/error.test.ts +95 -0
  494. package/test/cli/github-action.test.ts +199 -0
  495. package/test/cli/github-remote.test.ts +90 -0
  496. package/test/cli/help/__snapshots__/help-snapshots.test.ts.snap +623 -0
  497. package/test/cli/help/help-snapshots.test.ts +140 -0
  498. package/test/cli/import.test.ts +90 -0
  499. package/test/cli/mcp-add.test.ts +74 -0
  500. package/test/cli/plugin-auth-picker.test.ts +120 -0
  501. package/test/cli/run/entry.body.test.ts +536 -0
  502. package/test/cli/run/footer.menu.test.ts +43 -0
  503. package/test/cli/run/footer.view.test.tsx +1411 -0
  504. package/test/cli/run/footer.width.test.ts +35 -0
  505. package/test/cli/run/permission.shared.test.ts +144 -0
  506. package/test/cli/run/prompt.editor.test.ts +101 -0
  507. package/test/cli/run/prompt.shared.test.ts +101 -0
  508. package/test/cli/run/question.shared.test.ts +115 -0
  509. package/test/cli/run/run-process.test.ts +338 -0
  510. package/test/cli/run/runtime.boot.test.ts +283 -0
  511. package/test/cli/run/runtime.queue.test.ts +481 -0
  512. package/test/cli/run/runtime.stdin.test.ts +71 -0
  513. package/test/cli/run/runtime.test.ts +238 -0
  514. package/test/cli/run/scrollback.surface.test.ts +1092 -0
  515. package/test/cli/run/session-data.test.ts +593 -0
  516. package/test/cli/run/session-replay.test.ts +691 -0
  517. package/test/cli/run/session.shared.test.ts +247 -0
  518. package/test/cli/run/stream.test.ts +56 -0
  519. package/test/cli/run/stream.transport.test.ts +2363 -0
  520. package/test/cli/run/subagent-data.test.ts +547 -0
  521. package/test/cli/run/theme.test.ts +177 -0
  522. package/test/cli/run/variant.shared.test.ts +218 -0
  523. package/test/cli/serve/serve-process.test.ts +61 -0
  524. package/test/cli/smokes/read-only.test.ts +115 -0
  525. package/test/cli/tui/attach.test.ts +11 -0
  526. package/test/cli/tui/editor-context-zed.test.ts +379 -0
  527. package/test/cli/tui/editor-context.test.tsx +297 -0
  528. package/test/cli/tui/plugin-add.test.ts +110 -0
  529. package/test/cli/tui/plugin-install.test.ts +87 -0
  530. package/test/cli/tui/plugin-lifecycle.test.ts +224 -0
  531. package/test/cli/tui/plugin-loader-entrypoint.test.ts +485 -0
  532. package/test/cli/tui/plugin-loader-pure.test.ts +72 -0
  533. package/test/cli/tui/plugin-loader.test.ts +1332 -0
  534. package/test/cli/tui/plugin-toggle.test.ts +264 -0
  535. package/test/cli/tui/thread.test.ts +101 -0
  536. package/test/config/agent-color.test.ts +47 -0
  537. package/test/config/config.test.ts +2047 -0
  538. package/test/config/entry-name.test.ts +57 -0
  539. package/test/config/fixtures/empty-frontmatter.md +4 -0
  540. package/test/config/fixtures/frontmatter.md +28 -0
  541. package/test/config/fixtures/markdown-header.md +11 -0
  542. package/test/config/fixtures/no-frontmatter.md +1 -0
  543. package/test/config/fixtures/weird-model-id.md +13 -0
  544. package/test/config/lsp.test.ts +69 -0
  545. package/test/config/markdown.test.ts +228 -0
  546. package/test/config/plugin.test.ts +0 -0
  547. package/test/config/tui.test.ts +894 -0
  548. package/test/control-plane/adapters.test.ts +71 -0
  549. package/test/control-plane/workspace.test.ts +1717 -0
  550. package/test/effect/app-runtime-logger.test.ts +101 -0
  551. package/test/effect/config-service.test.ts +65 -0
  552. package/test/effect/instance-state.test.ts +392 -0
  553. package/test/effect/run-service.test.ts +89 -0
  554. package/test/effect/runner.test.ts +514 -0
  555. package/test/effect/runtime-flags.test.ts +374 -0
  556. package/test/event-manifest.test.ts +24 -0
  557. package/test/fake/account.ts +9 -0
  558. package/test/fake/auth.ts +8 -0
  559. package/test/fake/npm.ts +8 -0
  560. package/test/fake/provider.ts +83 -0
  561. package/test/fake/skill.ts +8 -0
  562. package/test/filesystem/filesystem.test.ts +318 -0
  563. package/test/fixture/agent-plugin.constants.ts +6 -0
  564. package/test/fixture/agent-plugin.ts +12 -0
  565. package/test/fixture/config.ts +24 -0
  566. package/test/fixture/db.ts +11 -0
  567. package/test/fixture/fixture.test.ts +26 -0
  568. package/test/fixture/fixture.ts +228 -0
  569. package/test/fixture/flag.ts +20 -0
  570. package/test/fixture/flock-worker.ts +72 -0
  571. package/test/fixture/lsp/fake-lsp-server.js +249 -0
  572. package/test/fixture/mcp-lifecycle-stdio.ts +26 -0
  573. package/test/fixture/mcp-session-recovery.ts +50 -0
  574. package/test/fixture/plug-worker.ts +93 -0
  575. package/test/fixture/plugin-meta-worker.ts +19 -0
  576. package/test/fixture/plugin.ts +10 -0
  577. package/test/fixture/skills/agents-sdk/SKILL.md +152 -0
  578. package/test/fixture/skills/agents-sdk/references/callable.md +92 -0
  579. package/test/fixture/skills/cloudflare/SKILL.md +211 -0
  580. package/test/fixture/skills/index.json +6 -0
  581. package/test/fixture/tui-environment.tsx +32 -0
  582. package/test/fixture/tui-plugin.ts +355 -0
  583. package/test/fixture/tui-runtime.ts +56 -0
  584. package/test/fixture/tui-sdk.ts +82 -0
  585. package/test/fixture/workspace.ts +34 -0
  586. package/test/fixtures/recordings/session/native-anthropic-tool-loop.json +49 -0
  587. package/test/fixtures/recordings/session/native-openai-oauth-tool-loop.json +45 -0
  588. package/test/fixtures/recordings/session/native-zen-tool-loop.json +49 -0
  589. package/test/format/format.test.ts +235 -0
  590. package/test/git/auto-commit.test.ts +63 -0
  591. package/test/git/git.test.ts +179 -0
  592. package/test/ide/ide.test.ts +82 -0
  593. package/test/image/fixtures/picture-5mb-base64.png +0 -0
  594. package/test/image/image.test.ts +121 -0
  595. package/test/installation/installation.test.ts +240 -0
  596. package/test/lib/cli-process.ts +535 -0
  597. package/test/lib/effect.ts +177 -0
  598. package/test/lib/filesystem.ts +10 -0
  599. package/test/lib/llm-server.ts +779 -0
  600. package/test/lib/snapshot.ts +73 -0
  601. package/test/lib/test-provider.ts +37 -0
  602. package/test/lib/websocket.ts +46 -0
  603. package/test/lsp/client.test.ts +488 -0
  604. package/test/lsp/index.test.ts +231 -0
  605. package/test/lsp/jdtls-root.test.ts +459 -0
  606. package/test/lsp/launch.test.ts +22 -0
  607. package/test/lsp/lifecycle.test.ts +160 -0
  608. package/test/mcp/auth.test.ts +78 -0
  609. package/test/mcp/catalog.test.ts +107 -0
  610. package/test/mcp/headers.test.ts +102 -0
  611. package/test/mcp/lifecycle.test.ts +560 -0
  612. package/test/mcp/oauth-auto-connect.test.ts +300 -0
  613. package/test/mcp/oauth-browser.test.ts +225 -0
  614. package/test/mcp/oauth-callback.test.ts +114 -0
  615. package/test/mcp/oauth-provider.test.ts +102 -0
  616. package/test/mcp/session-recovery.test.ts +27 -0
  617. package/test/mcp/transport.test.ts +38 -0
  618. package/test/patch/patch.test.ts +384 -0
  619. package/test/permission/arity.test.ts +33 -0
  620. package/test/permission/next.test.ts +1174 -0
  621. package/test/permission/sandbox.test.ts +89 -0
  622. package/test/permission-task.test.ts +319 -0
  623. package/test/plugin/auth-override.test.ts +101 -0
  624. package/test/plugin/cerebras.test.ts +47 -0
  625. package/test/plugin/cloudflare.test.ts +25 -0
  626. package/test/plugin/codex.test.ts +463 -0
  627. package/test/plugin/install-concurrency.test.ts +140 -0
  628. package/test/plugin/install.test.ts +570 -0
  629. package/test/plugin/loader-shared.test.ts +1306 -0
  630. package/test/plugin/meta.test.ts +137 -0
  631. package/test/plugin/modal-models.test.ts +198 -0
  632. package/test/plugin/openai-rollout.test.ts +17 -0
  633. package/test/plugin/openai-ws.test.ts +909 -0
  634. package/test/plugin/shared.test.ts +88 -0
  635. package/test/plugin/snowflake-cortex.test.ts +278 -0
  636. package/test/plugin/trigger.test.ts +108 -0
  637. package/test/plugin/workspace-adapter.test.ts +111 -0
  638. package/test/plugin/xai.test.ts +585 -0
  639. package/test/preload.ts +92 -0
  640. package/test/project/instance-bootstrap.test.ts +115 -0
  641. package/test/project/instance.test.ts +248 -0
  642. package/test/project/migrate-global.test.ts +168 -0
  643. package/test/project/project-directory.test.ts +202 -0
  644. package/test/project/project.test.ts +808 -0
  645. package/test/project/vcs.test.ts +335 -0
  646. package/test/project/worktree-remove.test.ts +128 -0
  647. package/test/project/worktree.test.ts +324 -0
  648. package/test/provider/amazon-bedrock.test.ts +361 -0
  649. package/test/provider/cf-ai-gateway-e2e.test.ts +320 -0
  650. package/test/provider/digitalocean.test.ts +124 -0
  651. package/test/provider/error.test.ts +24 -0
  652. package/test/provider/gitlab-duo.test.ts +412 -0
  653. package/test/provider/header-timeout.test.ts +234 -0
  654. package/test/provider/model-status.test.ts +61 -0
  655. package/test/provider/provider.test.ts +2118 -0
  656. package/test/provider/transform.test.ts +5682 -0
  657. package/test/question/question.test.ts +459 -0
  658. package/test/server/AGENTS.md +15 -0
  659. package/test/server/auth.test.ts +59 -0
  660. package/test/server/global-bus.ts +31 -0
  661. package/test/server/global-session-list.test.ts +108 -0
  662. package/test/server/httpapi-authorization.test.ts +174 -0
  663. package/test/server/httpapi-compression.test.ts +151 -0
  664. package/test/server/httpapi-config.test.ts +110 -0
  665. package/test/server/httpapi-control-plane.test.ts +63 -0
  666. package/test/server/httpapi-cors-vary.test.ts +63 -0
  667. package/test/server/httpapi-cors.test.ts +122 -0
  668. package/test/server/httpapi-error-middleware.test.ts +101 -0
  669. package/test/server/httpapi-event.test.ts +94 -0
  670. package/test/server/httpapi-exercise/assertions.ts +64 -0
  671. package/test/server/httpapi-exercise/backend.ts +144 -0
  672. package/test/server/httpapi-exercise/dsl.ts +210 -0
  673. package/test/server/httpapi-exercise/environment.ts +40 -0
  674. package/test/server/httpapi-exercise/index.ts +1802 -0
  675. package/test/server/httpapi-exercise/report.ts +66 -0
  676. package/test/server/httpapi-exercise/routing.ts +96 -0
  677. package/test/server/httpapi-exercise/runner.ts +267 -0
  678. package/test/server/httpapi-exercise/runtime.ts +52 -0
  679. package/test/server/httpapi-exercise/types.ts +127 -0
  680. package/test/server/httpapi-experimental.test.ts +298 -0
  681. package/test/server/httpapi-file.test.ts +83 -0
  682. package/test/server/httpapi-global.test.ts +90 -0
  683. package/test/server/httpapi-instance-context.test.ts +352 -0
  684. package/test/server/httpapi-instance-route-auth.test.ts +81 -0
  685. package/test/server/httpapi-instance.test.ts +265 -0
  686. package/test/server/httpapi-layer.ts +33 -0
  687. package/test/server/httpapi-listen.test.ts +465 -0
  688. package/test/server/httpapi-mcp-oauth.test.ts +73 -0
  689. package/test/server/httpapi-mcp.test.ts +223 -0
  690. package/test/server/httpapi-mdns.test.ts +79 -0
  691. package/test/server/httpapi-promptasync-context.test.ts +212 -0
  692. package/test/server/httpapi-provider.test.ts +401 -0
  693. package/test/server/httpapi-pty.test.ts +299 -0
  694. package/test/server/httpapi-public-openapi.test.ts +350 -0
  695. package/test/server/httpapi-query-schema-drift.test.ts +330 -0
  696. package/test/server/httpapi-reference.test.ts +63 -0
  697. package/test/server/httpapi-schema-error-body.test.ts +166 -0
  698. package/test/server/httpapi-sdk.test.ts +913 -0
  699. package/test/server/httpapi-session.test.ts +1090 -0
  700. package/test/server/httpapi-sync.test.ts +149 -0
  701. package/test/server/httpapi-ui.test.ts +457 -0
  702. package/test/server/httpapi-v2-location.test.ts +126 -0
  703. package/test/server/httpapi-v2-pty.test.ts +250 -0
  704. package/test/server/httpapi-workspace-routing.test.ts +552 -0
  705. package/test/server/httpapi-workspace.test.ts +506 -0
  706. package/test/server/negative-tokens-regression.test.ts +84 -0
  707. package/test/server/project-copy.test.ts +127 -0
  708. package/test/server/project-init-git.test.ts +118 -0
  709. package/test/server/proxy-util.test.ts +113 -0
  710. package/test/server/sdk-error-shape.test.ts +81 -0
  711. package/test/server/sdk-v1-smoke.test.ts +57 -0
  712. package/test/server/session-actions.test.ts +110 -0
  713. package/test/server/session-diff-missing-patch.test.ts +97 -0
  714. package/test/server/session-list.test.ts +302 -0
  715. package/test/server/session-messages.test.ts +180 -0
  716. package/test/server/session-select.test.ts +67 -0
  717. package/test/server/workspace-proxy.test.ts +181 -0
  718. package/test/server/workspace-routing.test.ts +101 -0
  719. package/test/server/worktree-endpoint-repro.test.ts +307 -0
  720. package/test/session/compaction.test.ts +1975 -0
  721. package/test/session/instruction.test.ts +264 -0
  722. package/test/session/llm-native-recorded.test.ts +413 -0
  723. package/test/session/llm-native.test.ts +761 -0
  724. package/test/session/llm.test.ts +2249 -0
  725. package/test/session/message-v2.test.ts +1729 -0
  726. package/test/session/messages-pagination.test.ts +1057 -0
  727. package/test/session/processor-effect.test.ts +1171 -0
  728. package/test/session/prompt.test.ts +2470 -0
  729. package/test/session/retry.test.ts +521 -0
  730. package/test/session/revert-compact.test.ts +683 -0
  731. package/test/session/schema-decoding.test.ts +313 -0
  732. package/test/session/session-schema.test.ts +78 -0
  733. package/test/session/session.test.ts +285 -0
  734. package/test/session/snapshot-tool-race.test.ts +189 -0
  735. package/test/session/structured-output-integration.test.ts +235 -0
  736. package/test/session/structured-output.test.ts +387 -0
  737. package/test/session/system.test.ts +168 -0
  738. package/test/share/share-next.test.ts +324 -0
  739. package/test/skill/discovery.test.ts +186 -0
  740. package/test/skill/restriction.test.ts +57 -0
  741. package/test/skill/skill.test.ts +588 -0
  742. package/test/snapshot/snapshot.test.ts +1218 -0
  743. package/test/storage/storage.test.ts +297 -0
  744. package/test/tool/__snapshots__/parameters.test.ts.snap +466 -0
  745. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  746. package/test/tool/apply_patch.test.ts +529 -0
  747. package/test/tool/code-mode-integration.test.ts +331 -0
  748. package/test/tool/code-mode.test.ts +730 -0
  749. package/test/tool/edit.test.ts +576 -0
  750. package/test/tool/external-directory.test.ts +156 -0
  751. package/test/tool/fixtures/large-image.png +0 -0
  752. package/test/tool/fixtures/models-api.json +172692 -0
  753. package/test/tool/glob.test.ts +132 -0
  754. package/test/tool/grep.test.ts +223 -0
  755. package/test/tool/lsp.test.ts +184 -0
  756. package/test/tool/parameters.test.ts +290 -0
  757. package/test/tool/question.test.ts +133 -0
  758. package/test/tool/read.test.ts +608 -0
  759. package/test/tool/registry.test.ts +572 -0
  760. package/test/tool/shell.test.ts +1199 -0
  761. package/test/tool/skill.test.ts +134 -0
  762. package/test/tool/task.test.ts +1101 -0
  763. package/test/tool/tool-define.test.ts +154 -0
  764. package/test/tool/truncation.test.ts +266 -0
  765. package/test/tool/webfetch.test.ts +119 -0
  766. package/test/tool/websearch.test.ts +100 -0
  767. package/test/tool/write.test.ts +281 -0
  768. package/test/util/data-url.test.ts +14 -0
  769. package/test/util/error.test.ts +16 -0
  770. package/test/util/filesystem.test.ts +656 -0
  771. package/test/util/glob.test.ts +164 -0
  772. package/test/util/html.test.ts +15 -0
  773. package/test/util/iife.test.ts +36 -0
  774. package/test/util/lazy.test.ts +50 -0
  775. package/test/util/module.test.ts +59 -0
  776. package/test/util/process.test.ts +128 -0
  777. package/test/util/repository.test.ts +93 -0
  778. package/test/util/timeout.test.ts +21 -0
  779. package/test/util/wildcard.test.ts +90 -0
  780. package/test/v2/session-message-updater.test.ts +269 -0
  781. package/test/verify/verify.test.ts +61 -0
  782. package/tsconfig.json +16 -0
@@ -0,0 +1,749 @@
1
+ // the approaches in this edit tool are sourced from
2
+ // https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-23-25.ts
3
+ // https://github.com/google-gemini/gemini-cli/blob/main/packages/core/src/utils/editCorrector.ts
4
+ // https://github.com/cline/cline/blob/main/evals/diff-edits/diff-apply/diff-06-26-25.ts
5
+
6
+ import * as path from "path"
7
+ import { Effect, Schema, Semaphore } from "effect"
8
+ import * as Tool from "./tool"
9
+ import { LSP } from "@/lsp/lsp"
10
+ import { createTwoFilesPatch, diffLines } from "diff"
11
+ import DESCRIPTION from "./edit.txt"
12
+ import { FileSystem } from "@msrfteam/core/filesystem"
13
+ import { Watcher } from "@msrfteam/core/filesystem/watcher"
14
+ import { EventV2Bridge } from "@/event-v2-bridge"
15
+ import { Config } from "@/config/config"
16
+ import { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner"
17
+ import { Verify } from "@/verify/verify"
18
+ import { Format } from "../format"
19
+ import { InstanceState } from "@/effect/instance-state"
20
+ import { Snapshot } from "@/snapshot"
21
+ import { assertExternalDirectoryEffect } from "./external-directory"
22
+ import { FSUtil } from "@msrfteam/core/fs-util"
23
+ import * as Bom from "@/util/bom"
24
+
25
+ function normalizeLineEndings(text: string): string {
26
+ return text.replaceAll("\r\n", "\n")
27
+ }
28
+
29
+ function detectLineEnding(text: string): "\n" | "\r\n" {
30
+ return text.includes("\r\n") ? "\r\n" : "\n"
31
+ }
32
+
33
+ function convertToLineEnding(text: string, ending: "\n" | "\r\n"): string {
34
+ if (ending === "\n") return text
35
+ return text.replaceAll("\n", "\r\n")
36
+ }
37
+
38
+ const locks = new Map<string, Semaphore.Semaphore>()
39
+
40
+ function lock(filePath: string) {
41
+ const resolvedFilePath = FSUtil.resolve(filePath)
42
+ const hit = locks.get(resolvedFilePath)
43
+ if (hit) return hit
44
+
45
+ const next = Semaphore.makeUnsafe(1)
46
+ locks.set(resolvedFilePath, next)
47
+ return next
48
+ }
49
+
50
+ export const Parameters = Schema.Struct({
51
+ filePath: Schema.String.annotate({ description: "The absolute path to the file to modify" }),
52
+ oldString: Schema.String.annotate({ description: "The text to replace" }),
53
+ newString: Schema.String.annotate({
54
+ description: "The text to replace it with (must be different from oldString)",
55
+ }),
56
+ replaceAll: Schema.optional(Schema.Boolean).annotate({
57
+ description: "Replace all occurrences of oldString (default false)",
58
+ }),
59
+ })
60
+
61
+ export const EditTool = Tool.define(
62
+ "edit",
63
+ Effect.gen(function* () {
64
+ const lsp = yield* LSP.Service
65
+ const afs = yield* FSUtil.Service
66
+ const format = yield* Format.Service
67
+ const events = yield* EventV2Bridge.Service
68
+ const config = yield* Config.Service
69
+ const spawner = yield* ChildProcessSpawner
70
+
71
+ return {
72
+ description: DESCRIPTION,
73
+ parameters: Parameters,
74
+ execute: (params: Schema.Schema.Type<typeof Parameters>, ctx: Tool.Context) =>
75
+ Effect.gen(function* () {
76
+ if (!params.filePath) {
77
+ throw new Error("filePath is required")
78
+ }
79
+
80
+ if (params.oldString === params.newString) {
81
+ throw new Error("No changes to apply: oldString and newString are identical.")
82
+ }
83
+
84
+ const instance = yield* InstanceState.context
85
+ const filePath = path.isAbsolute(params.filePath)
86
+ ? params.filePath
87
+ : path.join(instance.directory, params.filePath)
88
+ yield* assertExternalDirectoryEffect(ctx, filePath)
89
+
90
+ let diff = ""
91
+ let contentOld = ""
92
+ let contentNew = ""
93
+ yield* lock(filePath).withPermits(1)(
94
+ Effect.gen(function* () {
95
+ if (params.oldString === "") {
96
+ const existed = yield* afs.existsSafe(filePath)
97
+ if (existed) {
98
+ throw new Error(
99
+ "oldString cannot be empty when editing an existing file. Provide the exact text to replace, or use write for an intentional full-file replacement.",
100
+ )
101
+ }
102
+ const next = Bom.split(params.newString)
103
+ const desiredBom = next.bom
104
+ contentOld = ""
105
+ contentNew = next.text
106
+ diff = trimDiff(createTwoFilesPatch(filePath, filePath, contentOld, contentNew))
107
+ yield* ctx.ask({
108
+ permission: "edit",
109
+ patterns: [path.relative(instance.worktree, filePath)],
110
+ always: ["*"],
111
+ metadata: {
112
+ filepath: filePath,
113
+ diff,
114
+ },
115
+ })
116
+ yield* afs.writeWithDirs(filePath, Bom.join(contentNew, desiredBom))
117
+ if (yield* format.file(filePath)) {
118
+ contentNew = yield* Bom.syncFile(afs, filePath, desiredBom)
119
+ }
120
+ yield* events.publish(FileSystem.Event.Edited, { file: filePath })
121
+ yield* events.publish(Watcher.Event.Updated, {
122
+ file: filePath,
123
+ event: "add",
124
+ })
125
+ return
126
+ }
127
+
128
+ const info = yield* afs.stat(filePath).pipe(Effect.catch(() => Effect.succeed(undefined)))
129
+ if (!info) throw new Error(`File ${filePath} not found`)
130
+ if (info.type === "Directory") throw new Error(`Path is a directory, not a file: ${filePath}`)
131
+ const source = yield* Bom.readFile(afs, filePath)
132
+ contentOld = source.text
133
+
134
+ const ending = detectLineEnding(contentOld)
135
+ const old = convertToLineEnding(normalizeLineEndings(params.oldString), ending)
136
+ const replacement = convertToLineEnding(normalizeLineEndings(params.newString), ending)
137
+
138
+ const next = Bom.split(replace(contentOld, old, replacement, params.replaceAll))
139
+ const desiredBom = source.bom || next.bom
140
+ contentNew = next.text
141
+
142
+ diff = trimDiff(
143
+ createTwoFilesPatch(
144
+ filePath,
145
+ filePath,
146
+ normalizeLineEndings(contentOld),
147
+ normalizeLineEndings(contentNew),
148
+ ),
149
+ )
150
+ yield* ctx.ask({
151
+ permission: "edit",
152
+ patterns: [path.relative(instance.worktree, filePath)],
153
+ always: ["*"],
154
+ metadata: {
155
+ filepath: filePath,
156
+ diff,
157
+ },
158
+ })
159
+
160
+ yield* afs.writeWithDirs(filePath, Bom.join(contentNew, desiredBom))
161
+ if (yield* format.file(filePath)) {
162
+ contentNew = yield* Bom.syncFile(afs, filePath, desiredBom)
163
+ }
164
+ yield* events.publish(FileSystem.Event.Edited, { file: filePath })
165
+ yield* events.publish(Watcher.Event.Updated, {
166
+ file: filePath,
167
+ event: "change",
168
+ })
169
+ diff = trimDiff(
170
+ createTwoFilesPatch(
171
+ filePath,
172
+ filePath,
173
+ normalizeLineEndings(contentOld),
174
+ normalizeLineEndings(contentNew),
175
+ ),
176
+ )
177
+ }).pipe(Effect.orDie),
178
+ )
179
+
180
+ let additions = 0
181
+ let deletions = 0
182
+ for (const change of diffLines(contentOld, contentNew)) {
183
+ if (change.added) additions += change.count || 0
184
+ if (change.removed) deletions += change.count || 0
185
+ }
186
+ const filediff: Snapshot.FileDiff = {
187
+ file: filePath,
188
+ patch: diff,
189
+ additions,
190
+ deletions,
191
+ }
192
+
193
+ yield* ctx.metadata({
194
+ metadata: {
195
+ diff,
196
+ filediff,
197
+ diagnostics: {},
198
+ },
199
+ })
200
+
201
+ let output = "Edit applied successfully."
202
+ yield* lsp.touchFile(filePath, "document")
203
+ const diagnostics = yield* lsp.diagnostics()
204
+ const normalizedFilePath = FSUtil.normalizePath(filePath)
205
+ const block = LSP.Diagnostic.report(filePath, diagnostics[normalizedFilePath] ?? [])
206
+ if (block) output += `\n\nLSP errors detected in this file, please fix:\n${block}`
207
+
208
+ const verifyBlock = yield* Verify.afterEdit({
209
+ verify: (yield* config.get()).verify,
210
+ cwd: instance.directory,
211
+ spawner,
212
+ })
213
+ if (verifyBlock) output += `\n\n${verifyBlock}`
214
+
215
+ return {
216
+ metadata: {
217
+ diagnostics,
218
+ diff,
219
+ filediff,
220
+ },
221
+ title: `${path.relative(instance.worktree, filePath)}`,
222
+ output,
223
+ }
224
+ }),
225
+ }
226
+ }),
227
+ )
228
+
229
+ export type Replacer = (content: string, find: string) => Generator<string, void, unknown>
230
+
231
+ // Similarity thresholds for block anchor fallback matching
232
+ const SINGLE_CANDIDATE_SIMILARITY_THRESHOLD = 0.65
233
+ const MULTIPLE_CANDIDATES_SIMILARITY_THRESHOLD = 0.65
234
+
235
+ /**
236
+ * Levenshtein distance algorithm implementation
237
+ */
238
+ function levenshtein(a: string, b: string): number {
239
+ // Handle empty strings
240
+ if (a === "" || b === "") {
241
+ return Math.max(a.length, b.length)
242
+ }
243
+ const matrix = Array.from({ length: a.length + 1 }, (_, i) =>
244
+ Array.from({ length: b.length + 1 }, (_, j) => (i === 0 ? j : j === 0 ? i : 0)),
245
+ )
246
+
247
+ for (let i = 1; i <= a.length; i++) {
248
+ for (let j = 1; j <= b.length; j++) {
249
+ const cost = a[i - 1] === b[j - 1] ? 0 : 1
250
+ matrix[i][j] = Math.min(matrix[i - 1][j] + 1, matrix[i][j - 1] + 1, matrix[i - 1][j - 1] + cost)
251
+ }
252
+ }
253
+ return matrix[a.length][b.length]
254
+ }
255
+
256
+ export const SimpleReplacer: Replacer = function* (_content, find) {
257
+ yield find
258
+ }
259
+
260
+ export const LineTrimmedReplacer: Replacer = function* (content, find) {
261
+ const originalLines = content.split("\n")
262
+ const searchLines = find.split("\n")
263
+
264
+ if (searchLines[searchLines.length - 1] === "") {
265
+ searchLines.pop()
266
+ }
267
+
268
+ for (let i = 0; i <= originalLines.length - searchLines.length; i++) {
269
+ let matches = true
270
+
271
+ for (let j = 0; j < searchLines.length; j++) {
272
+ const originalTrimmed = originalLines[i + j].trim()
273
+ const searchTrimmed = searchLines[j].trim()
274
+
275
+ if (originalTrimmed !== searchTrimmed) {
276
+ matches = false
277
+ break
278
+ }
279
+ }
280
+
281
+ if (matches) {
282
+ let matchStartIndex = 0
283
+ for (let k = 0; k < i; k++) {
284
+ matchStartIndex += originalLines[k].length + 1
285
+ }
286
+
287
+ let matchEndIndex = matchStartIndex
288
+ for (let k = 0; k < searchLines.length; k++) {
289
+ matchEndIndex += originalLines[i + k].length
290
+ if (k < searchLines.length - 1) {
291
+ matchEndIndex += 1 // Add newline character except for the last line
292
+ }
293
+ }
294
+
295
+ yield content.substring(matchStartIndex, matchEndIndex)
296
+ }
297
+ }
298
+ }
299
+
300
+ export const BlockAnchorReplacer: Replacer = function* (content, find) {
301
+ const originalLines = content.split("\n")
302
+ const searchLines = find.split("\n")
303
+
304
+ if (searchLines.length < 3) {
305
+ return
306
+ }
307
+
308
+ if (searchLines[searchLines.length - 1] === "") {
309
+ searchLines.pop()
310
+ }
311
+
312
+ const firstLineSearch = searchLines[0].trim()
313
+ const lastLineSearch = searchLines[searchLines.length - 1].trim()
314
+ const searchBlockSize = searchLines.length
315
+ const maxLineDelta = Math.max(1, Math.floor(searchBlockSize * 0.25))
316
+
317
+ // Collect all candidate positions where both anchors match
318
+ const candidates: Array<{ startLine: number; endLine: number }> = []
319
+ for (let i = 0; i < originalLines.length; i++) {
320
+ if (originalLines[i].trim() !== firstLineSearch) {
321
+ continue
322
+ }
323
+
324
+ // Look for the matching last line after this first line
325
+ for (let j = i + 2; j < originalLines.length; j++) {
326
+ if (originalLines[j].trim() === lastLineSearch) {
327
+ const actualBlockSize = j - i + 1
328
+ if (Math.abs(actualBlockSize - searchBlockSize) <= maxLineDelta) {
329
+ candidates.push({ startLine: i, endLine: j })
330
+ }
331
+ break // Only match the first occurrence of the last line
332
+ }
333
+ }
334
+ }
335
+
336
+ // Return immediately if no candidates
337
+ if (candidates.length === 0) {
338
+ return
339
+ }
340
+
341
+ // Handle single candidate scenario (using relaxed threshold)
342
+ if (candidates.length === 1) {
343
+ const { startLine, endLine } = candidates[0]
344
+ const actualBlockSize = endLine - startLine + 1
345
+
346
+ let similarity = 0
347
+ const linesToCheck = Math.min(searchBlockSize - 2, actualBlockSize - 2) // Middle lines only
348
+
349
+ if (linesToCheck > 0) {
350
+ for (let j = 1; j < searchBlockSize - 1 && j < actualBlockSize - 1; j++) {
351
+ const originalLine = originalLines[startLine + j].trim()
352
+ const searchLine = searchLines[j].trim()
353
+ const maxLen = Math.max(originalLine.length, searchLine.length)
354
+ if (maxLen === 0) {
355
+ continue
356
+ }
357
+ const distance = levenshtein(originalLine, searchLine)
358
+ similarity += (1 - distance / maxLen) / linesToCheck
359
+
360
+ // Exit early when threshold is reached
361
+ if (similarity >= SINGLE_CANDIDATE_SIMILARITY_THRESHOLD) {
362
+ break
363
+ }
364
+ }
365
+ } else {
366
+ // No middle lines to compare, just accept based on anchors
367
+ similarity = 1.0
368
+ }
369
+
370
+ if (similarity >= SINGLE_CANDIDATE_SIMILARITY_THRESHOLD) {
371
+ let matchStartIndex = 0
372
+ for (let k = 0; k < startLine; k++) {
373
+ matchStartIndex += originalLines[k].length + 1
374
+ }
375
+ let matchEndIndex = matchStartIndex
376
+ for (let k = startLine; k <= endLine; k++) {
377
+ matchEndIndex += originalLines[k].length
378
+ if (k < endLine) {
379
+ matchEndIndex += 1 // Add newline character except for the last line
380
+ }
381
+ }
382
+ yield content.substring(matchStartIndex, matchEndIndex)
383
+ }
384
+ return
385
+ }
386
+
387
+ // Calculate similarity for multiple candidates
388
+ let bestMatch: { startLine: number; endLine: number } | null = null
389
+ let maxSimilarity = -1
390
+
391
+ for (const candidate of candidates) {
392
+ const { startLine, endLine } = candidate
393
+ const actualBlockSize = endLine - startLine + 1
394
+
395
+ let similarity = 0
396
+ const linesToCheck = Math.min(searchBlockSize - 2, actualBlockSize - 2) // Middle lines only
397
+
398
+ if (linesToCheck > 0) {
399
+ for (let j = 1; j < searchBlockSize - 1 && j < actualBlockSize - 1; j++) {
400
+ const originalLine = originalLines[startLine + j].trim()
401
+ const searchLine = searchLines[j].trim()
402
+ const maxLen = Math.max(originalLine.length, searchLine.length)
403
+ if (maxLen === 0) {
404
+ continue
405
+ }
406
+ const distance = levenshtein(originalLine, searchLine)
407
+ similarity += 1 - distance / maxLen
408
+ }
409
+ similarity /= linesToCheck // Average similarity
410
+ } else {
411
+ // No middle lines to compare, just accept based on anchors
412
+ similarity = 1.0
413
+ }
414
+
415
+ if (similarity > maxSimilarity) {
416
+ maxSimilarity = similarity
417
+ bestMatch = candidate
418
+ }
419
+ }
420
+
421
+ // Threshold judgment
422
+ if (maxSimilarity >= MULTIPLE_CANDIDATES_SIMILARITY_THRESHOLD && bestMatch) {
423
+ const { startLine, endLine } = bestMatch
424
+ let matchStartIndex = 0
425
+ for (let k = 0; k < startLine; k++) {
426
+ matchStartIndex += originalLines[k].length + 1
427
+ }
428
+ let matchEndIndex = matchStartIndex
429
+ for (let k = startLine; k <= endLine; k++) {
430
+ matchEndIndex += originalLines[k].length
431
+ if (k < endLine) {
432
+ matchEndIndex += 1
433
+ }
434
+ }
435
+ yield content.substring(matchStartIndex, matchEndIndex)
436
+ }
437
+ }
438
+
439
+ export const WhitespaceNormalizedReplacer: Replacer = function* (content, find) {
440
+ const normalizeWhitespace = (text: string) => text.replace(/\s+/g, " ").trim()
441
+ const normalizedFind = normalizeWhitespace(find)
442
+
443
+ // Handle single line matches
444
+ const lines = content.split("\n")
445
+ for (let i = 0; i < lines.length; i++) {
446
+ const line = lines[i]
447
+ if (normalizeWhitespace(line) === normalizedFind) {
448
+ yield line
449
+ } else {
450
+ // Only check for substring matches if the full line doesn't match
451
+ const normalizedLine = normalizeWhitespace(line)
452
+ if (normalizedLine.includes(normalizedFind)) {
453
+ // Find the actual substring in the original line that matches
454
+ const words = find.trim().split(/\s+/)
455
+ if (words.length > 0) {
456
+ const pattern = words.map((word) => word.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("\\s+")
457
+ try {
458
+ const regex = new RegExp(pattern)
459
+ const match = line.match(regex)
460
+ if (match) {
461
+ yield match[0]
462
+ }
463
+ } catch {
464
+ // Invalid regex pattern, skip
465
+ }
466
+ }
467
+ }
468
+ }
469
+ }
470
+
471
+ // Handle multi-line matches
472
+ const findLines = find.split("\n")
473
+ if (findLines.length > 1) {
474
+ for (let i = 0; i <= lines.length - findLines.length; i++) {
475
+ const block = lines.slice(i, i + findLines.length)
476
+ if (normalizeWhitespace(block.join("\n")) === normalizedFind) {
477
+ yield block.join("\n")
478
+ }
479
+ }
480
+ }
481
+ }
482
+
483
+ export const IndentationFlexibleReplacer: Replacer = function* (content, find) {
484
+ const removeIndentation = (text: string) => {
485
+ const lines = text.split("\n")
486
+ const nonEmptyLines = lines.filter((line) => line.trim().length > 0)
487
+ if (nonEmptyLines.length === 0) return text
488
+
489
+ const minIndent = Math.min(
490
+ ...nonEmptyLines.map((line) => {
491
+ const match = line.match(/^(\s*)/)
492
+ return match ? match[1].length : 0
493
+ }),
494
+ )
495
+
496
+ return lines.map((line) => (line.trim().length === 0 ? line : line.slice(minIndent))).join("\n")
497
+ }
498
+
499
+ const normalizedFind = removeIndentation(find)
500
+ const contentLines = content.split("\n")
501
+ const findLines = find.split("\n")
502
+
503
+ for (let i = 0; i <= contentLines.length - findLines.length; i++) {
504
+ const block = contentLines.slice(i, i + findLines.length).join("\n")
505
+ if (removeIndentation(block) === normalizedFind) {
506
+ yield block
507
+ }
508
+ }
509
+ }
510
+
511
+ export const EscapeNormalizedReplacer: Replacer = function* (content, find) {
512
+ const unescapeString = (str: string): string => {
513
+ return str.replace(/\\(n|t|r|'|"|`|\\|\n|\$)/g, (match, capturedChar) => {
514
+ switch (capturedChar) {
515
+ case "n":
516
+ return "\n"
517
+ case "t":
518
+ return "\t"
519
+ case "r":
520
+ return "\r"
521
+ case "'":
522
+ return "'"
523
+ case '"':
524
+ return '"'
525
+ case "`":
526
+ return "`"
527
+ case "\\":
528
+ return "\\"
529
+ case "\n":
530
+ return "\n"
531
+ case "$":
532
+ return "$"
533
+ default:
534
+ return match
535
+ }
536
+ })
537
+ }
538
+
539
+ const unescapedFind = unescapeString(find)
540
+
541
+ // Try direct match with unescaped find string
542
+ if (content.includes(unescapedFind)) {
543
+ yield unescapedFind
544
+ }
545
+
546
+ // Also try finding escaped versions in content that match unescaped find
547
+ const lines = content.split("\n")
548
+ const findLines = unescapedFind.split("\n")
549
+
550
+ for (let i = 0; i <= lines.length - findLines.length; i++) {
551
+ const block = lines.slice(i, i + findLines.length).join("\n")
552
+ const unescapedBlock = unescapeString(block)
553
+
554
+ if (unescapedBlock === unescapedFind) {
555
+ yield block
556
+ }
557
+ }
558
+ }
559
+
560
+ export const MultiOccurrenceReplacer: Replacer = function* (content, find) {
561
+ // This replacer yields all exact matches, allowing the replace function
562
+ // to handle multiple occurrences based on replaceAll parameter
563
+ let startIndex = 0
564
+
565
+ while (true) {
566
+ const index = content.indexOf(find, startIndex)
567
+ if (index === -1) break
568
+
569
+ yield find
570
+ startIndex = index + find.length
571
+ }
572
+ }
573
+
574
+ export const TrimmedBoundaryReplacer: Replacer = function* (content, find) {
575
+ const trimmedFind = find.trim()
576
+
577
+ if (trimmedFind === find) {
578
+ // Already trimmed, no point in trying
579
+ return
580
+ }
581
+
582
+ // Try to find the trimmed version
583
+ if (content.includes(trimmedFind)) {
584
+ yield trimmedFind
585
+ }
586
+
587
+ // Also try finding blocks where trimmed content matches
588
+ const lines = content.split("\n")
589
+ const findLines = find.split("\n")
590
+
591
+ for (let i = 0; i <= lines.length - findLines.length; i++) {
592
+ const block = lines.slice(i, i + findLines.length).join("\n")
593
+
594
+ if (block.trim() === trimmedFind) {
595
+ yield block
596
+ }
597
+ }
598
+ }
599
+
600
+ export const ContextAwareReplacer: Replacer = function* (content, find) {
601
+ const findLines = find.split("\n")
602
+ if (findLines.length < 3) {
603
+ // Need at least 3 lines to have meaningful context
604
+ return
605
+ }
606
+
607
+ // Remove trailing empty line if present
608
+ if (findLines[findLines.length - 1] === "") {
609
+ findLines.pop()
610
+ }
611
+
612
+ const contentLines = content.split("\n")
613
+
614
+ // Extract first and last lines as context anchors
615
+ const firstLine = findLines[0].trim()
616
+ const lastLine = findLines[findLines.length - 1].trim()
617
+
618
+ // Find blocks that start and end with the context anchors
619
+ for (let i = 0; i < contentLines.length; i++) {
620
+ if (contentLines[i].trim() !== firstLine) continue
621
+
622
+ // Look for the matching last line
623
+ for (let j = i + 2; j < contentLines.length; j++) {
624
+ if (contentLines[j].trim() === lastLine) {
625
+ // Found a potential context block
626
+ const blockLines = contentLines.slice(i, j + 1)
627
+ const block = blockLines.join("\n")
628
+
629
+ // Check if the middle content has reasonable similarity
630
+ // (simple heuristic: at least 50% of non-empty lines should match when trimmed)
631
+ if (blockLines.length === findLines.length) {
632
+ let matchingLines = 0
633
+ let totalNonEmptyLines = 0
634
+
635
+ for (let k = 1; k < blockLines.length - 1; k++) {
636
+ const blockLine = blockLines[k].trim()
637
+ const findLine = findLines[k].trim()
638
+
639
+ if (blockLine.length > 0 || findLine.length > 0) {
640
+ totalNonEmptyLines++
641
+ if (blockLine === findLine) {
642
+ matchingLines++
643
+ }
644
+ }
645
+ }
646
+
647
+ if (totalNonEmptyLines === 0 || matchingLines / totalNonEmptyLines >= 0.5) {
648
+ yield block
649
+ break // Only match the first occurrence
650
+ }
651
+ }
652
+ break
653
+ }
654
+ }
655
+ }
656
+ }
657
+
658
+ export function trimDiff(diff: string): string {
659
+ const lines = diff.split("\n")
660
+ const contentLines = lines.filter(
661
+ (line) =>
662
+ (line.startsWith("+") || line.startsWith("-") || line.startsWith(" ")) &&
663
+ !line.startsWith("---") &&
664
+ !line.startsWith("+++"),
665
+ )
666
+
667
+ if (contentLines.length === 0) return diff
668
+
669
+ let min = Infinity
670
+ for (const line of contentLines) {
671
+ const content = line.slice(1)
672
+ if (content.trim().length > 0) {
673
+ const match = content.match(/^(\s*)/)
674
+ if (match) min = Math.min(min, match[1].length)
675
+ }
676
+ }
677
+ if (min === Infinity || min === 0) return diff
678
+ const trimmedLines = lines.map((line) => {
679
+ if (
680
+ (line.startsWith("+") || line.startsWith("-") || line.startsWith(" ")) &&
681
+ !line.startsWith("---") &&
682
+ !line.startsWith("+++")
683
+ ) {
684
+ const prefix = line[0]
685
+ const content = line.slice(1)
686
+ return prefix + content.slice(min)
687
+ }
688
+ return line
689
+ })
690
+
691
+ return trimmedLines.join("\n")
692
+ }
693
+
694
+ export function replace(content: string, oldString: string, newString: string, replaceAll = false): string {
695
+ if (oldString === newString) {
696
+ throw new Error("No changes to apply: oldString and newString are identical.")
697
+ }
698
+ if (oldString === "") {
699
+ throw new Error(
700
+ "oldString cannot be empty when editing an existing file. Provide the exact text to replace, or use write for an intentional full-file replacement.",
701
+ )
702
+ }
703
+
704
+ let notFound = true
705
+
706
+ for (const replacer of [
707
+ SimpleReplacer,
708
+ LineTrimmedReplacer,
709
+ BlockAnchorReplacer,
710
+ WhitespaceNormalizedReplacer,
711
+ IndentationFlexibleReplacer,
712
+ EscapeNormalizedReplacer,
713
+ TrimmedBoundaryReplacer,
714
+ ContextAwareReplacer,
715
+ MultiOccurrenceReplacer,
716
+ ]) {
717
+ for (const search of replacer(content, oldString)) {
718
+ const index = content.indexOf(search)
719
+ if (index === -1) continue
720
+ notFound = false
721
+ if (isDisproportionateMatch(search, oldString)) {
722
+ throw new Error(
723
+ "Refusing replacement because the matched span is much larger than oldString. Re-read the file and provide the full exact oldString for the intended replacement.",
724
+ )
725
+ }
726
+ if (replaceAll) {
727
+ return content.replaceAll(search, newString)
728
+ }
729
+ const lastIndex = content.lastIndexOf(search)
730
+ if (index !== lastIndex) continue
731
+ return content.substring(0, index) + newString + content.substring(index + search.length)
732
+ }
733
+ }
734
+
735
+ if (notFound) {
736
+ throw new Error(
737
+ "Could not find oldString in the file. It must match exactly, including whitespace, indentation, and line endings.",
738
+ )
739
+ }
740
+ throw new Error("Found multiple matches for oldString. Provide more surrounding context to make the match unique.")
741
+ }
742
+
743
+ function isDisproportionateMatch(search: string, oldString: string) {
744
+ const oldLines = oldString.split("\n").length
745
+ const searchLines = search.split("\n").length
746
+ if (searchLines >= Math.max(oldLines + 3, oldLines * 2)) return true
747
+ if (oldLines === 1) return false
748
+ return search.trim().length > Math.max(oldString.trim().length + 500, oldString.trim().length * 4)
749
+ }