rird 2.1.231 → 2.3.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 (381) hide show
  1. package/AGENTS.md +86 -0
  2. package/COMPLETED_TEST_SUITE.txt +280 -0
  3. package/Dockerfile +18 -0
  4. package/README.md +397 -6
  5. package/RIRD_ERROR_HANDLING_SUMMARY.md +307 -0
  6. package/TESTING.md +512 -0
  7. package/TEST_IMPLEMENTATION_REPORT.md +463 -0
  8. package/TEST_SUITE.md +307 -0
  9. package/TEST_SUMMARY.txt +380 -0
  10. package/bin/rird-perf.js +37 -0
  11. package/bin/rird.js +43 -8
  12. package/bunfig.toml +4 -0
  13. package/create-wrapper.ps1 +51 -0
  14. package/docs/ARCHITECTURE.md +768 -0
  15. package/docs/CLI_REFERENCE.md +681 -0
  16. package/docs/DOCUMENTATION_MANIFEST.md +392 -0
  17. package/docs/INDEX.md +295 -0
  18. package/docs/PRODUCTION_SETUP.md +633 -0
  19. package/docs/TROUBLESHOOTING.md +914 -0
  20. package/facebook_ads_library.png +0 -0
  21. package/nul +0 -0
  22. package/nul`nif +0 -0
  23. package/package.json +104 -15
  24. package/parsers-config.ts +239 -0
  25. package/rird-1.0.199.tgz +0 -0
  26. package/rird-1.0.205.tgz +0 -0
  27. package/script/build-windows.ts +56 -0
  28. package/script/build.ts +165 -0
  29. package/{postinstall.mjs → script/postinstall.mjs} +47 -68
  30. package/script/publish-registries.ts +187 -0
  31. package/script/publish.ts +85 -0
  32. package/script/schema.ts +47 -0
  33. package/src/acp/README.md +164 -0
  34. package/src/acp/agent.ts +1063 -0
  35. package/src/acp/session.ts +101 -0
  36. package/src/acp/types.ts +22 -0
  37. package/src/agent/agent.ts +367 -0
  38. package/src/agent/generate.txt +75 -0
  39. package/src/agent/prompt/compaction.txt +12 -0
  40. package/src/agent/prompt/explore.txt +18 -0
  41. package/src/agent/prompt/summary.txt +10 -0
  42. package/src/agent/prompt/title.txt +36 -0
  43. package/src/auth/index.ts +70 -0
  44. package/src/bun/index.ts +114 -0
  45. package/src/bus/bus-event.ts +43 -0
  46. package/src/bus/global.ts +10 -0
  47. package/src/bus/index.ts +105 -0
  48. package/src/cli/bootstrap.ts +17 -0
  49. package/src/cli/cmd/acp.ts +104 -0
  50. package/src/cli/cmd/activate.ts +50 -0
  51. package/src/cli/cmd/agent.ts +256 -0
  52. package/src/cli/cmd/auth.ts +412 -0
  53. package/src/cli/cmd/cmd.ts +7 -0
  54. package/src/cli/cmd/debug/config.ts +15 -0
  55. package/src/cli/cmd/debug/file.ts +91 -0
  56. package/src/cli/cmd/debug/index.ts +43 -0
  57. package/src/cli/cmd/debug/lsp.ts +48 -0
  58. package/src/cli/cmd/debug/ripgrep.ts +83 -0
  59. package/src/cli/cmd/debug/scrap.ts +15 -0
  60. package/src/cli/cmd/debug/skill.ts +15 -0
  61. package/src/cli/cmd/debug/snapshot.ts +48 -0
  62. package/src/cli/cmd/export.ts +88 -0
  63. package/src/cli/cmd/generate.ts +38 -0
  64. package/src/cli/cmd/github.ts +1400 -0
  65. package/src/cli/cmd/import.ts +98 -0
  66. package/src/cli/cmd/mcp.ts +654 -0
  67. package/src/cli/cmd/models.ts +68 -0
  68. package/src/cli/cmd/pr.ts +112 -0
  69. package/src/cli/cmd/run.ts +434 -0
  70. package/src/cli/cmd/serve.ts +31 -0
  71. package/src/cli/cmd/session.ts +106 -0
  72. package/src/cli/cmd/stats.ts +298 -0
  73. package/src/cli/cmd/tui/app.tsx +694 -0
  74. package/src/cli/cmd/tui/attach.ts +30 -0
  75. package/src/cli/cmd/tui/component/border.tsx +21 -0
  76. package/src/cli/cmd/tui/component/dialog-agent.tsx +31 -0
  77. package/src/cli/cmd/tui/component/dialog-command.tsx +124 -0
  78. package/src/cli/cmd/tui/component/dialog-mcp.tsx +86 -0
  79. package/src/cli/cmd/tui/component/dialog-model.tsx +236 -0
  80. package/src/cli/cmd/tui/component/dialog-provider.tsx +240 -0
  81. package/src/cli/cmd/tui/component/dialog-session-list.tsx +102 -0
  82. package/src/cli/cmd/tui/component/dialog-session-rename.tsx +31 -0
  83. package/src/cli/cmd/tui/component/dialog-stash.tsx +86 -0
  84. package/src/cli/cmd/tui/component/dialog-status.tsx +162 -0
  85. package/src/cli/cmd/tui/component/dialog-tag.tsx +44 -0
  86. package/src/cli/cmd/tui/component/dialog-theme-list.tsx +50 -0
  87. package/src/cli/cmd/tui/component/did-you-know.tsx +85 -0
  88. package/src/cli/cmd/tui/component/logo.tsx +48 -0
  89. package/src/cli/cmd/tui/component/prompt/autocomplete.tsx +574 -0
  90. package/src/cli/cmd/tui/component/prompt/history.tsx +108 -0
  91. package/src/cli/cmd/tui/component/prompt/index.tsx +1087 -0
  92. package/src/cli/cmd/tui/component/prompt/stash.tsx +101 -0
  93. package/src/cli/cmd/tui/component/tips.ts +27 -0
  94. package/src/cli/cmd/tui/component/todo-item.tsx +32 -0
  95. package/src/cli/cmd/tui/context/args.tsx +14 -0
  96. package/src/cli/cmd/tui/context/directory.ts +13 -0
  97. package/src/cli/cmd/tui/context/exit.tsx +23 -0
  98. package/src/cli/cmd/tui/context/helper.tsx +25 -0
  99. package/src/cli/cmd/tui/context/keybind.tsx +101 -0
  100. package/src/cli/cmd/tui/context/kv.tsx +49 -0
  101. package/src/cli/cmd/tui/context/local.tsx +345 -0
  102. package/src/cli/cmd/tui/context/prompt.tsx +18 -0
  103. package/src/cli/cmd/tui/context/route.tsx +46 -0
  104. package/src/cli/cmd/tui/context/sdk.tsx +74 -0
  105. package/src/cli/cmd/tui/context/sync.tsx +372 -0
  106. package/src/cli/cmd/tui/context/theme/aura.json +69 -0
  107. package/src/cli/cmd/tui/context/theme/ayu.json +80 -0
  108. package/src/cli/cmd/tui/context/theme/catppuccin-frappe.json +233 -0
  109. package/src/cli/cmd/tui/context/theme/catppuccin-macchiato.json +233 -0
  110. package/src/cli/cmd/tui/context/theme/catppuccin.json +112 -0
  111. package/src/cli/cmd/tui/context/theme/cobalt2.json +228 -0
  112. package/src/cli/cmd/tui/context/theme/cursor.json +249 -0
  113. package/src/cli/cmd/tui/context/theme/dracula.json +219 -0
  114. package/src/cli/cmd/tui/context/theme/everforest.json +241 -0
  115. package/src/cli/cmd/tui/context/theme/flexoki.json +237 -0
  116. package/src/cli/cmd/tui/context/theme/github.json +233 -0
  117. package/src/cli/cmd/tui/context/theme/gruvbox.json +95 -0
  118. package/src/cli/cmd/tui/context/theme/kanagawa.json +77 -0
  119. package/src/cli/cmd/tui/context/theme/lucent-orng.json +227 -0
  120. package/src/cli/cmd/tui/context/theme/material.json +235 -0
  121. package/src/cli/cmd/tui/context/theme/matrix.json +77 -0
  122. package/src/cli/cmd/tui/context/theme/mercury.json +252 -0
  123. package/src/cli/cmd/tui/context/theme/monokai.json +221 -0
  124. package/src/cli/cmd/tui/context/theme/nightowl.json +221 -0
  125. package/src/cli/cmd/tui/context/theme/nord.json +223 -0
  126. package/src/cli/cmd/tui/context/theme/one-dark.json +84 -0
  127. package/src/cli/cmd/tui/context/theme/orng.json +245 -0
  128. package/src/cli/cmd/tui/context/theme/palenight.json +222 -0
  129. package/src/cli/cmd/tui/context/theme/rird.json +245 -0
  130. package/src/cli/cmd/tui/context/theme/rosepine.json +234 -0
  131. package/src/cli/cmd/tui/context/theme/solarized.json +223 -0
  132. package/src/cli/cmd/tui/context/theme/synthwave84.json +226 -0
  133. package/src/cli/cmd/tui/context/theme/tokyonight.json +243 -0
  134. package/src/cli/cmd/tui/context/theme/vercel.json +245 -0
  135. package/src/cli/cmd/tui/context/theme/vesper.json +218 -0
  136. package/src/cli/cmd/tui/context/theme/zenburn.json +223 -0
  137. package/src/cli/cmd/tui/context/theme.tsx +1109 -0
  138. package/src/cli/cmd/tui/event.ts +40 -0
  139. package/src/cli/cmd/tui/hooks/use-safe-terminal-dimensions.ts +12 -0
  140. package/src/cli/cmd/tui/routes/home.tsx +138 -0
  141. package/src/cli/cmd/tui/routes/session/dialog-fork-from-timeline.tsx +64 -0
  142. package/src/cli/cmd/tui/routes/session/dialog-message.tsx +109 -0
  143. package/src/cli/cmd/tui/routes/session/dialog-subagent.tsx +26 -0
  144. package/src/cli/cmd/tui/routes/session/dialog-timeline.tsx +47 -0
  145. package/src/cli/cmd/tui/routes/session/footer.tsx +88 -0
  146. package/src/cli/cmd/tui/routes/session/header.tsx +125 -0
  147. package/src/cli/cmd/tui/routes/session/index.tsx +1876 -0
  148. package/src/cli/cmd/tui/routes/session/sidebar.tsx +320 -0
  149. package/src/cli/cmd/tui/spawn.ts +60 -0
  150. package/src/cli/cmd/tui/thread.ts +142 -0
  151. package/src/cli/cmd/tui/ui/dialog-alert.tsx +57 -0
  152. package/src/cli/cmd/tui/ui/dialog-confirm.tsx +83 -0
  153. package/src/cli/cmd/tui/ui/dialog-help.tsx +38 -0
  154. package/src/cli/cmd/tui/ui/dialog-prompt.tsx +77 -0
  155. package/src/cli/cmd/tui/ui/dialog-select.tsx +333 -0
  156. package/src/cli/cmd/tui/ui/dialog.tsx +171 -0
  157. package/src/cli/cmd/tui/ui/spinner.ts +368 -0
  158. package/src/cli/cmd/tui/ui/toast.tsx +100 -0
  159. package/src/cli/cmd/tui/util/clipboard.ts +127 -0
  160. package/src/cli/cmd/tui/util/editor.ts +32 -0
  161. package/src/cli/cmd/tui/util/terminal.ts +146 -0
  162. package/src/cli/cmd/tui/worker.ts +63 -0
  163. package/src/cli/cmd/uninstall.ts +344 -0
  164. package/src/cli/cmd/upgrade.ts +127 -0
  165. package/src/cli/cmd/web.ts +84 -0
  166. package/src/cli/error.ts +69 -0
  167. package/src/cli/ui.ts +101 -0
  168. package/src/cli/upgrade.ts +28 -0
  169. package/src/command/index.ts +80 -0
  170. package/src/command/template/initialize.txt +10 -0
  171. package/src/command/template/review.txt +97 -0
  172. package/src/config/config.ts +994 -0
  173. package/src/config/markdown.ts +41 -0
  174. package/src/env/index.ts +26 -0
  175. package/src/file/ignore.ts +83 -0
  176. package/src/file/index.ts +328 -0
  177. package/src/file/ripgrep.ts +393 -0
  178. package/src/file/time.ts +64 -0
  179. package/src/file/watcher.ts +103 -0
  180. package/src/flag/flag.ts +84 -0
  181. package/src/format/formatter.ts +315 -0
  182. package/src/format/index.ts +137 -0
  183. package/src/global/index.ts +101 -0
  184. package/src/id/id.ts +73 -0
  185. package/src/ide/index.ts +76 -0
  186. package/src/index.ts +297 -0
  187. package/src/index.ts.backup +271 -0
  188. package/src/installation/index.ts +258 -0
  189. package/src/lib/IMPLEMENTATION_NOTES.md +345 -0
  190. package/src/lib/error-handler.ts +225 -0
  191. package/src/lib/error-testing-guide.md +258 -0
  192. package/src/lib/errors.ts +285 -0
  193. package/src/lib/performance.ts +70 -0
  194. package/src/lib/telemetry.ts +282 -0
  195. package/src/lsp/client.ts +229 -0
  196. package/src/lsp/index.ts +485 -0
  197. package/src/lsp/language.ts +116 -0
  198. package/src/lsp/server.ts +1895 -0
  199. package/src/mcp/auth.ts +135 -0
  200. package/src/mcp/index.ts +1117 -0
  201. package/src/mcp/intent-analyzer.ts +376 -0
  202. package/src/mcp/oauth-callback.ts +200 -0
  203. package/src/mcp/oauth-provider.ts +154 -0
  204. package/src/patch/index.ts +632 -0
  205. package/src/permission/index.ts +199 -0
  206. package/src/plugin/index.ts +91 -0
  207. package/src/project/bootstrap.ts +33 -0
  208. package/src/project/instance.ts +78 -0
  209. package/src/project/project.ts +236 -0
  210. package/src/project/state.ts +65 -0
  211. package/src/project/vcs.ts +76 -0
  212. package/src/provider/auth.ts +143 -0
  213. package/src/provider/models-macro.ts +55 -0
  214. package/src/provider/models.ts +161 -0
  215. package/src/provider/provider.ts +1109 -0
  216. package/src/provider/sdk/openai-compatible/src/README.md +5 -0
  217. package/src/provider/sdk/openai-compatible/src/index.ts +2 -0
  218. package/src/provider/sdk/openai-compatible/src/openai-compatible-provider.ts +100 -0
  219. package/src/provider/sdk/openai-compatible/src/responses/convert-to-openai-responses-input.ts +303 -0
  220. package/src/provider/sdk/openai-compatible/src/responses/map-openai-responses-finish-reason.ts +22 -0
  221. package/src/provider/sdk/openai-compatible/src/responses/openai-config.ts +18 -0
  222. package/src/provider/sdk/openai-compatible/src/responses/openai-error.ts +22 -0
  223. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-api-types.ts +207 -0
  224. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-language-model.ts +1713 -0
  225. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-prepare-tools.ts +177 -0
  226. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-settings.ts +1 -0
  227. package/src/provider/sdk/openai-compatible/src/responses/tool/code-interpreter.ts +88 -0
  228. package/src/provider/sdk/openai-compatible/src/responses/tool/file-search.ts +128 -0
  229. package/src/provider/sdk/openai-compatible/src/responses/tool/image-generation.ts +115 -0
  230. package/src/provider/sdk/openai-compatible/src/responses/tool/local-shell.ts +65 -0
  231. package/src/provider/sdk/openai-compatible/src/responses/tool/web-search-preview.ts +104 -0
  232. package/src/provider/sdk/openai-compatible/src/responses/tool/web-search.ts +103 -0
  233. package/src/provider/transform.ts +455 -0
  234. package/src/pty/index.ts +231 -0
  235. package/src/security/guardrails.test.ts +341 -0
  236. package/src/security/guardrails.ts +570 -0
  237. package/src/security/index.ts +19 -0
  238. package/src/server/error.ts +36 -0
  239. package/src/server/project.ts +79 -0
  240. package/src/server/server.ts +2641 -0
  241. package/src/server/tui.ts +71 -0
  242. package/src/session/compaction.ts +228 -0
  243. package/src/session/index.ts +464 -0
  244. package/src/session/llm.ts +201 -0
  245. package/src/session/message-v2.ts +695 -0
  246. package/src/session/message.ts +189 -0
  247. package/src/session/processor.ts +409 -0
  248. package/src/session/prompt/act-switch.txt +5 -0
  249. package/src/session/prompt/anthropic-20250930.txt +166 -0
  250. package/src/session/prompt/anthropic.txt +63 -0
  251. package/src/session/prompt/anthropic_spoof.txt +1 -0
  252. package/src/session/prompt/beast.txt +76 -0
  253. package/src/session/prompt/codex.txt +304 -0
  254. package/src/session/prompt/copilot-gpt-5.txt +137 -0
  255. package/src/session/prompt/gemini.txt +62 -0
  256. package/src/session/prompt/max-steps.txt +16 -0
  257. package/src/session/prompt/plan-reminder-anthropic.txt +35 -0
  258. package/src/session/prompt/plan.txt +24 -0
  259. package/src/session/prompt/polaris.txt +88 -0
  260. package/src/session/prompt/qwen.txt +59 -0
  261. package/src/session/prompt.ts +1552 -0
  262. package/src/session/retry.ts +86 -0
  263. package/src/session/revert.ts +108 -0
  264. package/src/session/sensitive-filter.test.ts +327 -0
  265. package/src/session/sensitive-filter.ts +466 -0
  266. package/src/session/status.ts +76 -0
  267. package/src/session/summary.ts +209 -0
  268. package/src/session/system.ts +122 -0
  269. package/src/session/todo.ts +37 -0
  270. package/src/share/share-next.ts +222 -0
  271. package/src/share/share.ts +87 -0
  272. package/src/shell/shell.ts +67 -0
  273. package/src/skill/index.ts +1 -0
  274. package/src/skill/skill.ts +83 -0
  275. package/src/snapshot/index.ts +197 -0
  276. package/src/storage/storage.ts +226 -0
  277. package/src/tests/agent.test.ts +308 -0
  278. package/src/tests/build-guards.test.ts +267 -0
  279. package/src/tests/config.test.ts +664 -0
  280. package/src/tests/tool-registry.test.ts +589 -0
  281. package/src/tool/bash.ts +314 -0
  282. package/src/tool/bash.txt +158 -0
  283. package/src/tool/batch.ts +175 -0
  284. package/src/tool/batch.txt +24 -0
  285. package/src/tool/codesearch.ts +184 -0
  286. package/src/tool/codesearch.txt +12 -0
  287. package/src/tool/edit.ts +675 -0
  288. package/src/tool/edit.txt +10 -0
  289. package/src/tool/glob.ts +65 -0
  290. package/src/tool/glob.txt +6 -0
  291. package/src/tool/grep.ts +121 -0
  292. package/src/tool/grep.txt +8 -0
  293. package/src/tool/invalid.ts +17 -0
  294. package/src/tool/ls.ts +110 -0
  295. package/src/tool/ls.txt +1 -0
  296. package/src/tool/lsp-diagnostics.ts +26 -0
  297. package/src/tool/lsp-diagnostics.txt +1 -0
  298. package/src/tool/lsp-hover.ts +31 -0
  299. package/src/tool/lsp-hover.txt +1 -0
  300. package/src/tool/lsp.ts +87 -0
  301. package/src/tool/lsp.txt +19 -0
  302. package/src/tool/multiedit.ts +46 -0
  303. package/src/tool/multiedit.txt +41 -0
  304. package/src/tool/patch.ts +233 -0
  305. package/src/tool/patch.txt +1 -0
  306. package/src/tool/read.ts +219 -0
  307. package/src/tool/read.txt +12 -0
  308. package/src/tool/registry.ts +162 -0
  309. package/src/tool/skill.ts +100 -0
  310. package/src/tool/task.ts +136 -0
  311. package/src/tool/task.txt +51 -0
  312. package/src/tool/todo.ts +39 -0
  313. package/src/tool/todoread.txt +14 -0
  314. package/src/tool/todowrite.txt +167 -0
  315. package/src/tool/tool.ts +71 -0
  316. package/src/tool/webfetch.ts +198 -0
  317. package/src/tool/webfetch.txt +13 -0
  318. package/src/tool/websearch.ts +268 -0
  319. package/src/tool/websearch.txt +13 -0
  320. package/src/tool/write.ts +110 -0
  321. package/src/tool/write.txt +8 -0
  322. package/src/util/archive.ts +16 -0
  323. package/src/util/color.ts +19 -0
  324. package/src/util/context.ts +25 -0
  325. package/src/util/defer.ts +12 -0
  326. package/src/util/eventloop.ts +20 -0
  327. package/src/util/filesystem.ts +83 -0
  328. package/src/util/fn.ts +11 -0
  329. package/src/util/iife.ts +3 -0
  330. package/src/util/keybind.ts +102 -0
  331. package/src/util/lazy.ts +11 -0
  332. package/src/util/license.ts +362 -0
  333. package/src/util/locale.ts +81 -0
  334. package/src/util/lock.ts +98 -0
  335. package/src/util/log.ts +180 -0
  336. package/src/util/queue.ts +32 -0
  337. package/src/util/rpc.ts +42 -0
  338. package/src/util/scrap.ts +10 -0
  339. package/src/util/signal.ts +12 -0
  340. package/src/util/timeout.ts +14 -0
  341. package/src/util/token.ts +7 -0
  342. package/src/util/wildcard.ts +54 -0
  343. package/sst-env.d.ts +9 -0
  344. package/test/agent/agent.test.ts +146 -0
  345. package/test/bun.test.ts +53 -0
  346. package/test/cli/cmd/acp.test.ts +144 -0
  347. package/test/cli/cmd/run.test.ts +250 -0
  348. package/test/cli/github-remote.test.ts +80 -0
  349. package/test/config/agent-color.test.ts +66 -0
  350. package/test/config/config.test.ts +536 -0
  351. package/test/config/markdown.test.ts +89 -0
  352. package/test/file/ignore.test.ts +10 -0
  353. package/test/fixture/fixture.ts +37 -0
  354. package/test/fixture/lsp/fake-lsp-server.js +77 -0
  355. package/test/helpers.ts +172 -0
  356. package/test/ide/ide.test.ts +82 -0
  357. package/test/installation/installation.test.ts +143 -0
  358. package/test/keybind.test.ts +421 -0
  359. package/test/lsp/client.test.ts +95 -0
  360. package/test/mcp/headers.test.ts +153 -0
  361. package/test/patch/patch.test.ts +348 -0
  362. package/test/preload.ts +57 -0
  363. package/test/project/project.test.ts +74 -0
  364. package/test/provider/provider.test.ts +74 -0
  365. package/test/provider/transform.test.ts +411 -0
  366. package/test/session/retry.test.ts +111 -0
  367. package/test/session/session.test.ts +71 -0
  368. package/test/skill/skill.test.ts +131 -0
  369. package/test/snapshot/snapshot.test.ts +940 -0
  370. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  371. package/test/tool/bash.test.ts +434 -0
  372. package/test/tool/grep.test.ts +108 -0
  373. package/test/tool/patch.test.ts +259 -0
  374. package/test/tool/read.test.ts +42 -0
  375. package/test/util/iife.test.ts +36 -0
  376. package/test/util/lazy.test.ts +50 -0
  377. package/test/util/license.test.ts +235 -0
  378. package/test/util/timeout.test.ts +21 -0
  379. package/test/util/wildcard.test.ts +55 -0
  380. package/tsconfig.json +16 -0
  381. package/update-versions.ps1 +65 -0
@@ -0,0 +1,632 @@
1
+ import z from "zod"
2
+ import * as path from "path"
3
+ import * as fs from "fs/promises"
4
+ import { Log } from "../util/log"
5
+
6
+ export namespace Patch {
7
+ const log = Log.create({ service: "patch" })
8
+
9
+ // Schema definitions
10
+ export const PatchSchema = z.object({
11
+ patchText: z.string().describe("The full patch text that describes all changes to be made"),
12
+ })
13
+
14
+ export type PatchParams = z.infer<typeof PatchSchema>
15
+
16
+ // Core types matching the Rust implementation
17
+ export interface ApplyPatchArgs {
18
+ patch: string
19
+ hunks: Hunk[]
20
+ workdir?: string
21
+ }
22
+
23
+ export type Hunk =
24
+ | { type: "add"; path: string; contents: string }
25
+ | { type: "delete"; path: string }
26
+ | { type: "update"; path: string; move_path?: string; chunks: UpdateFileChunk[] }
27
+
28
+ export interface UpdateFileChunk {
29
+ old_lines: string[]
30
+ new_lines: string[]
31
+ change_context?: string
32
+ is_end_of_file?: boolean
33
+ }
34
+
35
+ export interface ApplyPatchAction {
36
+ changes: Map<string, ApplyPatchFileChange>
37
+ patch: string
38
+ cwd: string
39
+ }
40
+
41
+ export type ApplyPatchFileChange =
42
+ | { type: "add"; content: string }
43
+ | { type: "delete"; content: string }
44
+ | { type: "update"; unified_diff: string; move_path?: string; new_content: string }
45
+
46
+ export interface AffectedPaths {
47
+ added: string[]
48
+ modified: string[]
49
+ deleted: string[]
50
+ }
51
+
52
+ export enum ApplyPatchError {
53
+ ParseError = "ParseError",
54
+ IoError = "IoError",
55
+ ComputeReplacements = "ComputeReplacements",
56
+ ImplicitInvocation = "ImplicitInvocation",
57
+ }
58
+
59
+ export enum MaybeApplyPatch {
60
+ Body = "Body",
61
+ ShellParseError = "ShellParseError",
62
+ PatchParseError = "PatchParseError",
63
+ NotApplyPatch = "NotApplyPatch",
64
+ }
65
+
66
+ export enum MaybeApplyPatchVerified {
67
+ Body = "Body",
68
+ ShellParseError = "ShellParseError",
69
+ CorrectnessError = "CorrectnessError",
70
+ NotApplyPatch = "NotApplyPatch",
71
+ }
72
+
73
+ // Parser implementation
74
+ function parsePatchHeader(
75
+ lines: string[],
76
+ startIdx: number,
77
+ ): { filePath: string; movePath?: string; nextIdx: number } | null {
78
+ const line = lines[startIdx]
79
+
80
+ if (line.startsWith("*** Add File:")) {
81
+ const colonIndex = line.indexOf(":")
82
+ if (colonIndex === -1) return null
83
+ const filePath = line.substring(colonIndex + 1).trim()
84
+ return filePath ? { filePath, nextIdx: startIdx + 1 } : null
85
+ }
86
+
87
+ if (line.startsWith("*** Delete File:")) {
88
+ const colonIndex = line.indexOf(":")
89
+ if (colonIndex === -1) return null
90
+ const filePath = line.substring(colonIndex + 1).trim()
91
+ return filePath ? { filePath, nextIdx: startIdx + 1 } : null
92
+ }
93
+
94
+ if (line.startsWith("*** Update File:")) {
95
+ const colonIndex = line.indexOf(":")
96
+ if (colonIndex === -1) return null
97
+ const filePath = line.substring(colonIndex + 1).trim()
98
+ let movePath: string | undefined
99
+ let nextIdx = startIdx + 1
100
+
101
+ // Check for move directive
102
+ if (nextIdx < lines.length && lines[nextIdx].startsWith("*** Move to:")) {
103
+ const moveLine = lines[nextIdx]
104
+ const moveColonIndex = moveLine.indexOf(":")
105
+ if (moveColonIndex !== -1) {
106
+ movePath = moveLine.substring(moveColonIndex + 1).trim()
107
+ }
108
+ nextIdx++
109
+ }
110
+
111
+ return filePath ? { filePath, movePath, nextIdx } : null
112
+ }
113
+
114
+ return null
115
+ }
116
+
117
+ function parseUpdateFileChunks(lines: string[], startIdx: number): { chunks: UpdateFileChunk[]; nextIdx: number } {
118
+ const chunks: UpdateFileChunk[] = []
119
+ let i = startIdx
120
+
121
+ while (i < lines.length && !lines[i].startsWith("***")) {
122
+ if (lines[i].startsWith("@@")) {
123
+ // Parse context line
124
+ const contextLine = lines[i].substring(2).trim()
125
+ i++
126
+
127
+ const oldLines: string[] = []
128
+ const newLines: string[] = []
129
+ let isEndOfFile = false
130
+
131
+ // Parse change lines
132
+ while (i < lines.length && !lines[i].startsWith("@@") && !lines[i].startsWith("***")) {
133
+ const changeLine = lines[i]
134
+
135
+ if (changeLine === "*** End of File") {
136
+ isEndOfFile = true
137
+ i++
138
+ break
139
+ }
140
+
141
+ if (changeLine.startsWith(" ")) {
142
+ // Keep line - appears in both old and new
143
+ const content = changeLine.substring(1)
144
+ oldLines.push(content)
145
+ newLines.push(content)
146
+ } else if (changeLine.startsWith("-")) {
147
+ // Remove line - only in old
148
+ oldLines.push(changeLine.substring(1))
149
+ } else if (changeLine.startsWith("+")) {
150
+ // Add line - only in new
151
+ newLines.push(changeLine.substring(1))
152
+ }
153
+
154
+ i++
155
+ }
156
+
157
+ chunks.push({
158
+ old_lines: oldLines,
159
+ new_lines: newLines,
160
+ change_context: contextLine || undefined,
161
+ is_end_of_file: isEndOfFile || undefined,
162
+ })
163
+ } else {
164
+ i++
165
+ }
166
+ }
167
+
168
+ return { chunks, nextIdx: i }
169
+ }
170
+
171
+ function parseAddFileContent(lines: string[], startIdx: number): { content: string; nextIdx: number } {
172
+ let content = ""
173
+ let i = startIdx
174
+
175
+ while (i < lines.length && !lines[i].startsWith("***")) {
176
+ if (lines[i].startsWith("+")) {
177
+ content += lines[i].substring(1) + "\n"
178
+ }
179
+ i++
180
+ }
181
+
182
+ // Remove trailing newline
183
+ if (content.endsWith("\n")) {
184
+ content = content.slice(0, -1)
185
+ }
186
+
187
+ return { content, nextIdx: i }
188
+ }
189
+
190
+ export function parsePatch(patchText: string): { hunks: Hunk[] } {
191
+ const lines = patchText.split("\n")
192
+ const hunks: Hunk[] = []
193
+ let i = 0
194
+
195
+ // Look for Begin/End patch markers
196
+ const beginMarker = "*** Begin Patch"
197
+ const endMarker = "*** End Patch"
198
+
199
+ const beginIdx = lines.findIndex((line) => line.trim() === beginMarker)
200
+ const endIdx = lines.findIndex((line) => line.trim() === endMarker)
201
+
202
+ if (beginIdx === -1 || endIdx === -1 || beginIdx >= endIdx) {
203
+ throw new Error("Invalid patch format: missing Begin/End markers")
204
+ }
205
+
206
+ // Parse content between markers
207
+ i = beginIdx + 1
208
+
209
+ while (i < endIdx) {
210
+ const header = parsePatchHeader(lines, i)
211
+ if (!header) {
212
+ i++
213
+ continue
214
+ }
215
+
216
+ if (lines[i].startsWith("*** Add File:")) {
217
+ const { content, nextIdx } = parseAddFileContent(lines, header.nextIdx)
218
+ hunks.push({
219
+ type: "add",
220
+ path: header.filePath,
221
+ contents: content,
222
+ })
223
+ i = nextIdx
224
+ } else if (lines[i].startsWith("*** Delete File:")) {
225
+ hunks.push({
226
+ type: "delete",
227
+ path: header.filePath,
228
+ })
229
+ i = header.nextIdx
230
+ } else if (lines[i].startsWith("*** Update File:")) {
231
+ const { chunks, nextIdx } = parseUpdateFileChunks(lines, header.nextIdx)
232
+ hunks.push({
233
+ type: "update",
234
+ path: header.filePath,
235
+ move_path: header.movePath,
236
+ chunks,
237
+ })
238
+ i = nextIdx
239
+ } else {
240
+ i++
241
+ }
242
+ }
243
+
244
+ return { hunks }
245
+ }
246
+
247
+ // Apply patch functionality
248
+ export function maybeParseApplyPatch(
249
+ argv: string[],
250
+ ):
251
+ | { type: MaybeApplyPatch.Body; args: ApplyPatchArgs }
252
+ | { type: MaybeApplyPatch.PatchParseError; error: Error }
253
+ | { type: MaybeApplyPatch.NotApplyPatch } {
254
+ const APPLY_PATCH_COMMANDS = ["apply_patch", "applypatch"]
255
+
256
+ // Direct invocation: apply_patch <patch>
257
+ if (argv.length === 2 && APPLY_PATCH_COMMANDS.includes(argv[0])) {
258
+ try {
259
+ const { hunks } = parsePatch(argv[1])
260
+ return {
261
+ type: MaybeApplyPatch.Body,
262
+ args: {
263
+ patch: argv[1],
264
+ hunks,
265
+ },
266
+ }
267
+ } catch (error) {
268
+ return {
269
+ type: MaybeApplyPatch.PatchParseError,
270
+ error: error as Error,
271
+ }
272
+ }
273
+ }
274
+
275
+ // Bash heredoc form: bash -lc 'apply_patch <<"EOF" ...'
276
+ if (argv.length === 3 && argv[0] === "bash" && argv[1] === "-lc") {
277
+ // Simple extraction - in real implementation would need proper bash parsing
278
+ const script = argv[2]
279
+ const heredocMatch = script.match(/apply_patch\s*<<['"](\w+)['"]\s*\n([\s\S]*?)\n\1/)
280
+
281
+ if (heredocMatch) {
282
+ const patchContent = heredocMatch[2]
283
+ try {
284
+ const { hunks } = parsePatch(patchContent)
285
+ return {
286
+ type: MaybeApplyPatch.Body,
287
+ args: {
288
+ patch: patchContent,
289
+ hunks,
290
+ },
291
+ }
292
+ } catch (error) {
293
+ return {
294
+ type: MaybeApplyPatch.PatchParseError,
295
+ error: error as Error,
296
+ }
297
+ }
298
+ }
299
+ }
300
+
301
+ return { type: MaybeApplyPatch.NotApplyPatch }
302
+ }
303
+
304
+ // File content manipulation
305
+ interface ApplyPatchFileUpdate {
306
+ unified_diff: string
307
+ content: string
308
+ }
309
+
310
+ export function deriveNewContentsFromChunks(filePath: string, chunks: UpdateFileChunk[]): ApplyPatchFileUpdate {
311
+ // Read original file content
312
+ let originalContent: string
313
+ try {
314
+ originalContent = require("fs").readFileSync(filePath, "utf-8")
315
+ } catch (error) {
316
+ throw new Error(`Failed to read file ${filePath}: ${error}`)
317
+ }
318
+
319
+ let originalLines = originalContent.split("\n")
320
+
321
+ // Drop trailing empty element for consistent line counting
322
+ if (originalLines.length > 0 && originalLines[originalLines.length - 1] === "") {
323
+ originalLines.pop()
324
+ }
325
+
326
+ const replacements = computeReplacements(originalLines, filePath, chunks)
327
+ let newLines = applyReplacements(originalLines, replacements)
328
+
329
+ // Ensure trailing newline
330
+ if (newLines.length === 0 || newLines[newLines.length - 1] !== "") {
331
+ newLines.push("")
332
+ }
333
+
334
+ const newContent = newLines.join("\n")
335
+
336
+ // Generate unified diff
337
+ const unifiedDiff = generateUnifiedDiff(originalContent, newContent)
338
+
339
+ return {
340
+ unified_diff: unifiedDiff,
341
+ content: newContent,
342
+ }
343
+ }
344
+
345
+ function computeReplacements(
346
+ originalLines: string[],
347
+ filePath: string,
348
+ chunks: UpdateFileChunk[],
349
+ ): Array<[number, number, string[]]> {
350
+ const replacements: Array<[number, number, string[]]> = []
351
+ let lineIndex = 0
352
+
353
+ for (const chunk of chunks) {
354
+ // Handle context-based seeking
355
+ if (chunk.change_context) {
356
+ const contextIdx = seekSequence(originalLines, [chunk.change_context], lineIndex)
357
+ if (contextIdx === -1) {
358
+ throw new Error(`Failed to find context '${chunk.change_context}' in ${filePath}`)
359
+ }
360
+ lineIndex = contextIdx + 1
361
+ }
362
+
363
+ // Handle pure addition (no old lines)
364
+ if (chunk.old_lines.length === 0) {
365
+ const insertionIdx =
366
+ originalLines.length > 0 && originalLines[originalLines.length - 1] === ""
367
+ ? originalLines.length - 1
368
+ : originalLines.length
369
+ replacements.push([insertionIdx, 0, chunk.new_lines])
370
+ continue
371
+ }
372
+
373
+ // Try to match old lines in the file
374
+ let pattern = chunk.old_lines
375
+ let newSlice = chunk.new_lines
376
+ let found = seekSequence(originalLines, pattern, lineIndex)
377
+
378
+ // Retry without trailing empty line if not found
379
+ if (found === -1 && pattern.length > 0 && pattern[pattern.length - 1] === "") {
380
+ pattern = pattern.slice(0, -1)
381
+ if (newSlice.length > 0 && newSlice[newSlice.length - 1] === "") {
382
+ newSlice = newSlice.slice(0, -1)
383
+ }
384
+ found = seekSequence(originalLines, pattern, lineIndex)
385
+ }
386
+
387
+ if (found !== -1) {
388
+ replacements.push([found, pattern.length, newSlice])
389
+ lineIndex = found + pattern.length
390
+ } else {
391
+ throw new Error(`Failed to find expected lines in ${filePath}:\n${chunk.old_lines.join("\n")}`)
392
+ }
393
+ }
394
+
395
+ // Sort replacements by index to apply in order
396
+ replacements.sort((a, b) => a[0] - b[0])
397
+
398
+ return replacements
399
+ }
400
+
401
+ function applyReplacements(lines: string[], replacements: Array<[number, number, string[]]>): string[] {
402
+ // Apply replacements in reverse order to avoid index shifting
403
+ const result = [...lines]
404
+
405
+ for (let i = replacements.length - 1; i >= 0; i--) {
406
+ const [startIdx, oldLen, newSegment] = replacements[i]
407
+
408
+ // Remove old lines
409
+ result.splice(startIdx, oldLen)
410
+
411
+ // Insert new lines
412
+ for (let j = 0; j < newSegment.length; j++) {
413
+ result.splice(startIdx + j, 0, newSegment[j])
414
+ }
415
+ }
416
+
417
+ return result
418
+ }
419
+
420
+ function seekSequence(lines: string[], pattern: string[], startIndex: number): number {
421
+ if (pattern.length === 0) return -1
422
+
423
+ // Simple substring search implementation
424
+ for (let i = startIndex; i <= lines.length - pattern.length; i++) {
425
+ let matches = true
426
+
427
+ for (let j = 0; j < pattern.length; j++) {
428
+ if (lines[i + j] !== pattern[j]) {
429
+ matches = false
430
+ break
431
+ }
432
+ }
433
+
434
+ if (matches) {
435
+ return i
436
+ }
437
+ }
438
+
439
+ return -1
440
+ }
441
+
442
+ function generateUnifiedDiff(oldContent: string, newContent: string): string {
443
+ const oldLines = oldContent.split("\n")
444
+ const newLines = newContent.split("\n")
445
+
446
+ // Simple diff generation - in a real implementation you'd use a proper diff algorithm
447
+ let diff = "@@ -1 +1 @@\n"
448
+
449
+ // Find changes (simplified approach)
450
+ const maxLen = Math.max(oldLines.length, newLines.length)
451
+ let hasChanges = false
452
+
453
+ for (let i = 0; i < maxLen; i++) {
454
+ const oldLine = oldLines[i] || ""
455
+ const newLine = newLines[i] || ""
456
+
457
+ if (oldLine !== newLine) {
458
+ if (oldLine) diff += `-${oldLine}\n`
459
+ if (newLine) diff += `+${newLine}\n`
460
+ hasChanges = true
461
+ } else if (oldLine) {
462
+ diff += ` ${oldLine}\n`
463
+ }
464
+ }
465
+
466
+ return hasChanges ? diff : ""
467
+ }
468
+
469
+ // Apply hunks to filesystem
470
+ export async function applyHunksToFiles(hunks: Hunk[]): Promise<AffectedPaths> {
471
+ if (hunks.length === 0) {
472
+ throw new Error("No files were modified.")
473
+ }
474
+
475
+ const added: string[] = []
476
+ const modified: string[] = []
477
+ const deleted: string[] = []
478
+
479
+ for (const hunk of hunks) {
480
+ switch (hunk.type) {
481
+ case "add":
482
+ // Create parent directories
483
+ const addDir = path.dirname(hunk.path)
484
+ if (addDir !== "." && addDir !== "/") {
485
+ await fs.mkdir(addDir, { recursive: true })
486
+ }
487
+
488
+ await fs.writeFile(hunk.path, hunk.contents, "utf-8")
489
+ added.push(hunk.path)
490
+ log.info(`Added file: ${hunk.path}`)
491
+ break
492
+
493
+ case "delete":
494
+ await fs.unlink(hunk.path)
495
+ deleted.push(hunk.path)
496
+ log.info(`Deleted file: ${hunk.path}`)
497
+ break
498
+
499
+ case "update":
500
+ const fileUpdate = deriveNewContentsFromChunks(hunk.path, hunk.chunks)
501
+
502
+ if (hunk.move_path) {
503
+ // Handle file move
504
+ const moveDir = path.dirname(hunk.move_path)
505
+ if (moveDir !== "." && moveDir !== "/") {
506
+ await fs.mkdir(moveDir, { recursive: true })
507
+ }
508
+
509
+ await fs.writeFile(hunk.move_path, fileUpdate.content, "utf-8")
510
+ await fs.unlink(hunk.path)
511
+ modified.push(hunk.move_path)
512
+ log.info(`Moved file: ${hunk.path} -> ${hunk.move_path}`)
513
+ } else {
514
+ // Regular update
515
+ await fs.writeFile(hunk.path, fileUpdate.content, "utf-8")
516
+ modified.push(hunk.path)
517
+ log.info(`Updated file: ${hunk.path}`)
518
+ }
519
+ break
520
+ }
521
+ }
522
+
523
+ return { added, modified, deleted }
524
+ }
525
+
526
+ // Main patch application function
527
+ export async function applyPatch(patchText: string): Promise<AffectedPaths> {
528
+ const { hunks } = parsePatch(patchText)
529
+ return applyHunksToFiles(hunks)
530
+ }
531
+
532
+ // Async version of maybeParseApplyPatchVerified
533
+ export async function maybeParseApplyPatchVerified(
534
+ argv: string[],
535
+ cwd: string,
536
+ ): Promise<
537
+ | { type: MaybeApplyPatchVerified.Body; action: ApplyPatchAction }
538
+ | { type: MaybeApplyPatchVerified.CorrectnessError; error: Error }
539
+ | { type: MaybeApplyPatchVerified.NotApplyPatch }
540
+ > {
541
+ // Detect implicit patch invocation (raw patch without apply_patch command)
542
+ if (argv.length === 1) {
543
+ try {
544
+ parsePatch(argv[0])
545
+ return {
546
+ type: MaybeApplyPatchVerified.CorrectnessError,
547
+ error: new Error(ApplyPatchError.ImplicitInvocation),
548
+ }
549
+ } catch {
550
+ // Not a patch, continue
551
+ }
552
+ }
553
+
554
+ const result = maybeParseApplyPatch(argv)
555
+
556
+ switch (result.type) {
557
+ case MaybeApplyPatch.Body:
558
+ const { args } = result
559
+ const effectiveCwd = args.workdir ? path.resolve(cwd, args.workdir) : cwd
560
+ const changes = new Map<string, ApplyPatchFileChange>()
561
+
562
+ for (const hunk of args.hunks) {
563
+ const resolvedPath = path.resolve(
564
+ effectiveCwd,
565
+ hunk.type === "update" && hunk.move_path ? hunk.move_path : hunk.path,
566
+ )
567
+
568
+ switch (hunk.type) {
569
+ case "add":
570
+ changes.set(resolvedPath, {
571
+ type: "add",
572
+ content: hunk.contents,
573
+ })
574
+ break
575
+
576
+ case "delete":
577
+ // For delete, we need to read the current content
578
+ const deletePath = path.resolve(effectiveCwd, hunk.path)
579
+ try {
580
+ const content = await fs.readFile(deletePath, "utf-8")
581
+ changes.set(resolvedPath, {
582
+ type: "delete",
583
+ content,
584
+ })
585
+ } catch (error) {
586
+ return {
587
+ type: MaybeApplyPatchVerified.CorrectnessError,
588
+ error: new Error(`Failed to read file for deletion: ${deletePath}`),
589
+ }
590
+ }
591
+ break
592
+
593
+ case "update":
594
+ const updatePath = path.resolve(effectiveCwd, hunk.path)
595
+ try {
596
+ const fileUpdate = deriveNewContentsFromChunks(updatePath, hunk.chunks)
597
+ changes.set(resolvedPath, {
598
+ type: "update",
599
+ unified_diff: fileUpdate.unified_diff,
600
+ move_path: hunk.move_path ? path.resolve(effectiveCwd, hunk.move_path) : undefined,
601
+ new_content: fileUpdate.content,
602
+ })
603
+ } catch (error) {
604
+ return {
605
+ type: MaybeApplyPatchVerified.CorrectnessError,
606
+ error: error as Error,
607
+ }
608
+ }
609
+ break
610
+ }
611
+ }
612
+
613
+ return {
614
+ type: MaybeApplyPatchVerified.Body,
615
+ action: {
616
+ changes,
617
+ patch: args.patch,
618
+ cwd: effectiveCwd,
619
+ },
620
+ }
621
+
622
+ case MaybeApplyPatch.PatchParseError:
623
+ return {
624
+ type: MaybeApplyPatchVerified.CorrectnessError,
625
+ error: result.error,
626
+ }
627
+
628
+ case MaybeApplyPatch.NotApplyPatch:
629
+ return { type: MaybeApplyPatchVerified.NotApplyPatch }
630
+ }
631
+ }
632
+ }