easc-cli 1.1.37 → 1.1.40

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 (412) hide show
  1. package/bin/{opencode → opencode.cjs} +4 -6
  2. package/package.json +15 -120
  3. package/AGENTS.md +0 -27
  4. package/Dockerfile +0 -18
  5. package/README.md +0 -15
  6. package/bunfig.toml +0 -7
  7. package/charity-website/README.md +0 -252
  8. package/charity-website/admin/index.html +0 -299
  9. package/charity-website/package.json +0 -40
  10. package/charity-website/public/index.html +0 -265
  11. package/charity-website/src/css/admin.css +0 -710
  12. package/charity-website/src/css/style.css +0 -741
  13. package/charity-website/src/js/admin.js +0 -743
  14. package/charity-website/src/js/app.js +0 -444
  15. package/parsers-config.ts +0 -253
  16. package/script/build.ts +0 -172
  17. package/script/deploy.ts +0 -96
  18. package/script/publish-registries.ts +0 -187
  19. package/script/publish.ts +0 -70
  20. package/script/schema.ts +0 -47
  21. package/script/seed-e2e.ts +0 -50
  22. package/src/acp/README.md +0 -164
  23. package/src/acp/agent.ts +0 -1285
  24. package/src/acp/session.ts +0 -105
  25. package/src/acp/types.ts +0 -22
  26. package/src/agent/agent.ts +0 -332
  27. package/src/agent/generate.txt +0 -75
  28. package/src/agent/prompt/compaction.txt +0 -12
  29. package/src/agent/prompt/explore.txt +0 -18
  30. package/src/agent/prompt/summary.txt +0 -11
  31. package/src/agent/prompt/title.txt +0 -43
  32. package/src/auth/eliseart.ts +0 -76
  33. package/src/auth/index.ts +0 -73
  34. package/src/bun/index.ts +0 -134
  35. package/src/bus/bus-event.ts +0 -43
  36. package/src/bus/global.ts +0 -10
  37. package/src/bus/index.ts +0 -105
  38. package/src/cli/bootstrap.ts +0 -17
  39. package/src/cli/cmd/account.ts +0 -81
  40. package/src/cli/cmd/acp.ts +0 -69
  41. package/src/cli/cmd/agent.ts +0 -257
  42. package/src/cli/cmd/auth.ts +0 -427
  43. package/src/cli/cmd/cmd.ts +0 -7
  44. package/src/cli/cmd/debug/agent.ts +0 -166
  45. package/src/cli/cmd/debug/config.ts +0 -16
  46. package/src/cli/cmd/debug/file.ts +0 -97
  47. package/src/cli/cmd/debug/index.ts +0 -48
  48. package/src/cli/cmd/debug/lsp.ts +0 -52
  49. package/src/cli/cmd/debug/ripgrep.ts +0 -87
  50. package/src/cli/cmd/debug/scrap.ts +0 -16
  51. package/src/cli/cmd/debug/skill.ts +0 -16
  52. package/src/cli/cmd/debug/snapshot.ts +0 -52
  53. package/src/cli/cmd/export.ts +0 -88
  54. package/src/cli/cmd/generate.ts +0 -38
  55. package/src/cli/cmd/github.ts +0 -1548
  56. package/src/cli/cmd/import.ts +0 -98
  57. package/src/cli/cmd/mcp.ts +0 -827
  58. package/src/cli/cmd/models.ts +0 -77
  59. package/src/cli/cmd/pr.ts +0 -112
  60. package/src/cli/cmd/run.ts +0 -407
  61. package/src/cli/cmd/serve.ts +0 -20
  62. package/src/cli/cmd/session.ts +0 -135
  63. package/src/cli/cmd/stats.ts +0 -402
  64. package/src/cli/cmd/tui/app.tsx +0 -774
  65. package/src/cli/cmd/tui/attach.ts +0 -31
  66. package/src/cli/cmd/tui/component/border.tsx +0 -21
  67. package/src/cli/cmd/tui/component/dialog-agent.tsx +0 -31
  68. package/src/cli/cmd/tui/component/dialog-command.tsx +0 -148
  69. package/src/cli/cmd/tui/component/dialog-mcp.tsx +0 -86
  70. package/src/cli/cmd/tui/component/dialog-model.tsx +0 -234
  71. package/src/cli/cmd/tui/component/dialog-provider.tsx +0 -256
  72. package/src/cli/cmd/tui/component/dialog-session-list.tsx +0 -114
  73. package/src/cli/cmd/tui/component/dialog-session-rename.tsx +0 -31
  74. package/src/cli/cmd/tui/component/dialog-stash.tsx +0 -87
  75. package/src/cli/cmd/tui/component/dialog-status.tsx +0 -164
  76. package/src/cli/cmd/tui/component/dialog-supabase.tsx +0 -102
  77. package/src/cli/cmd/tui/component/dialog-tag.tsx +0 -44
  78. package/src/cli/cmd/tui/component/dialog-theme-list.tsx +0 -50
  79. package/src/cli/cmd/tui/component/logo.tsx +0 -88
  80. package/src/cli/cmd/tui/component/prompt/autocomplete.tsx +0 -653
  81. package/src/cli/cmd/tui/component/prompt/frecency.tsx +0 -89
  82. package/src/cli/cmd/tui/component/prompt/history.tsx +0 -108
  83. package/src/cli/cmd/tui/component/prompt/index.tsx +0 -1182
  84. package/src/cli/cmd/tui/component/prompt/stash.tsx +0 -101
  85. package/src/cli/cmd/tui/component/spinner.tsx +0 -16
  86. package/src/cli/cmd/tui/component/textarea-keybindings.ts +0 -73
  87. package/src/cli/cmd/tui/component/tips.tsx +0 -153
  88. package/src/cli/cmd/tui/component/todo-item.tsx +0 -32
  89. package/src/cli/cmd/tui/context/args.tsx +0 -14
  90. package/src/cli/cmd/tui/context/directory.ts +0 -13
  91. package/src/cli/cmd/tui/context/exit.tsx +0 -23
  92. package/src/cli/cmd/tui/context/helper.tsx +0 -25
  93. package/src/cli/cmd/tui/context/keybind.tsx +0 -101
  94. package/src/cli/cmd/tui/context/kv.tsx +0 -52
  95. package/src/cli/cmd/tui/context/local.tsx +0 -402
  96. package/src/cli/cmd/tui/context/prompt.tsx +0 -18
  97. package/src/cli/cmd/tui/context/route.tsx +0 -46
  98. package/src/cli/cmd/tui/context/sdk.tsx +0 -94
  99. package/src/cli/cmd/tui/context/sync.tsx +0 -445
  100. package/src/cli/cmd/tui/context/theme/aura.json +0 -69
  101. package/src/cli/cmd/tui/context/theme/ayu.json +0 -80
  102. package/src/cli/cmd/tui/context/theme/carbonfox.json +0 -248
  103. package/src/cli/cmd/tui/context/theme/catppuccin-frappe.json +0 -233
  104. package/src/cli/cmd/tui/context/theme/catppuccin-macchiato.json +0 -233
  105. package/src/cli/cmd/tui/context/theme/catppuccin.json +0 -112
  106. package/src/cli/cmd/tui/context/theme/cobalt2.json +0 -228
  107. package/src/cli/cmd/tui/context/theme/cursor.json +0 -249
  108. package/src/cli/cmd/tui/context/theme/dracula.json +0 -219
  109. package/src/cli/cmd/tui/context/theme/everforest.json +0 -241
  110. package/src/cli/cmd/tui/context/theme/flexoki.json +0 -237
  111. package/src/cli/cmd/tui/context/theme/github.json +0 -233
  112. package/src/cli/cmd/tui/context/theme/gruvbox.json +0 -95
  113. package/src/cli/cmd/tui/context/theme/kanagawa.json +0 -77
  114. package/src/cli/cmd/tui/context/theme/lucent-orng.json +0 -237
  115. package/src/cli/cmd/tui/context/theme/material.json +0 -235
  116. package/src/cli/cmd/tui/context/theme/matrix.json +0 -77
  117. package/src/cli/cmd/tui/context/theme/mercury.json +0 -252
  118. package/src/cli/cmd/tui/context/theme/monokai.json +0 -221
  119. package/src/cli/cmd/tui/context/theme/nightowl.json +0 -221
  120. package/src/cli/cmd/tui/context/theme/nord.json +0 -223
  121. package/src/cli/cmd/tui/context/theme/one-dark.json +0 -84
  122. package/src/cli/cmd/tui/context/theme/orng.json +0 -249
  123. package/src/cli/cmd/tui/context/theme/osaka-jade.json +0 -93
  124. package/src/cli/cmd/tui/context/theme/palenight.json +0 -222
  125. package/src/cli/cmd/tui/context/theme/rosepine.json +0 -234
  126. package/src/cli/cmd/tui/context/theme/solarized.json +0 -223
  127. package/src/cli/cmd/tui/context/theme/synthwave84.json +0 -226
  128. package/src/cli/cmd/tui/context/theme/tokyonight.json +0 -243
  129. package/src/cli/cmd/tui/context/theme/vercel.json +0 -245
  130. package/src/cli/cmd/tui/context/theme/vesper.json +0 -218
  131. package/src/cli/cmd/tui/context/theme/zenburn.json +0 -223
  132. package/src/cli/cmd/tui/context/theme.tsx +0 -1152
  133. package/src/cli/cmd/tui/event.ts +0 -48
  134. package/src/cli/cmd/tui/routes/home.tsx +0 -140
  135. package/src/cli/cmd/tui/routes/session/dialog-fork-from-timeline.tsx +0 -64
  136. package/src/cli/cmd/tui/routes/session/dialog-message.tsx +0 -109
  137. package/src/cli/cmd/tui/routes/session/dialog-subagent.tsx +0 -26
  138. package/src/cli/cmd/tui/routes/session/dialog-timeline.tsx +0 -47
  139. package/src/cli/cmd/tui/routes/session/dialog-tool.tsx +0 -63
  140. package/src/cli/cmd/tui/routes/session/footer.tsx +0 -129
  141. package/src/cli/cmd/tui/routes/session/header.tsx +0 -136
  142. package/src/cli/cmd/tui/routes/session/index.tsx +0 -2132
  143. package/src/cli/cmd/tui/routes/session/permission.tsx +0 -495
  144. package/src/cli/cmd/tui/routes/session/question.tsx +0 -435
  145. package/src/cli/cmd/tui/routes/session/sidebar.tsx +0 -313
  146. package/src/cli/cmd/tui/thread.ts +0 -165
  147. package/src/cli/cmd/tui/ui/dialog-alert.tsx +0 -57
  148. package/src/cli/cmd/tui/ui/dialog-confirm.tsx +0 -83
  149. package/src/cli/cmd/tui/ui/dialog-export-options.tsx +0 -204
  150. package/src/cli/cmd/tui/ui/dialog-help.tsx +0 -38
  151. package/src/cli/cmd/tui/ui/dialog-prompt.tsx +0 -77
  152. package/src/cli/cmd/tui/ui/dialog-select.tsx +0 -376
  153. package/src/cli/cmd/tui/ui/dialog.tsx +0 -167
  154. package/src/cli/cmd/tui/ui/link.tsx +0 -28
  155. package/src/cli/cmd/tui/ui/spinner.ts +0 -368
  156. package/src/cli/cmd/tui/ui/toast.tsx +0 -100
  157. package/src/cli/cmd/tui/util/clipboard.ts +0 -160
  158. package/src/cli/cmd/tui/util/editor.ts +0 -32
  159. package/src/cli/cmd/tui/util/signal.ts +0 -7
  160. package/src/cli/cmd/tui/util/terminal.ts +0 -114
  161. package/src/cli/cmd/tui/util/transcript.ts +0 -98
  162. package/src/cli/cmd/tui/worker.ts +0 -152
  163. package/src/cli/cmd/uninstall.ts +0 -357
  164. package/src/cli/cmd/upgrade.ts +0 -73
  165. package/src/cli/cmd/web.ts +0 -81
  166. package/src/cli/error.ts +0 -57
  167. package/src/cli/network.ts +0 -53
  168. package/src/cli/ui.ts +0 -84
  169. package/src/cli/upgrade.ts +0 -25
  170. package/src/command/index.ts +0 -131
  171. package/src/command/template/initialize.txt +0 -10
  172. package/src/command/template/review.txt +0 -99
  173. package/src/config/config.ts +0 -1361
  174. package/src/config/markdown.ts +0 -93
  175. package/src/env/index.ts +0 -26
  176. package/src/file/ignore.ts +0 -83
  177. package/src/file/index.ts +0 -411
  178. package/src/file/ripgrep.ts +0 -407
  179. package/src/file/time.ts +0 -64
  180. package/src/file/watcher.ts +0 -127
  181. package/src/flag/flag.ts +0 -54
  182. package/src/format/formatter.ts +0 -342
  183. package/src/format/index.ts +0 -137
  184. package/src/global/index.ts +0 -55
  185. package/src/id/id.ts +0 -83
  186. package/src/ide/index.ts +0 -76
  187. package/src/index.ts +0 -162
  188. package/src/installation/index.ts +0 -246
  189. package/src/lsp/client.ts +0 -252
  190. package/src/lsp/index.ts +0 -485
  191. package/src/lsp/language.ts +0 -119
  192. package/src/lsp/server.ts +0 -2046
  193. package/src/mcp/auth.ts +0 -135
  194. package/src/mcp/index.ts +0 -931
  195. package/src/mcp/oauth-callback.ts +0 -200
  196. package/src/mcp/oauth-provider.ts +0 -154
  197. package/src/patch/index.ts +0 -680
  198. package/src/permission/arity.ts +0 -163
  199. package/src/permission/index.ts +0 -210
  200. package/src/permission/next.ts +0 -269
  201. package/src/plugin/codex.ts +0 -493
  202. package/src/plugin/copilot.ts +0 -269
  203. package/src/plugin/index.ts +0 -136
  204. package/src/project/bootstrap.ts +0 -35
  205. package/src/project/instance.ts +0 -91
  206. package/src/project/project.ts +0 -339
  207. package/src/project/state.ts +0 -66
  208. package/src/project/vcs.ts +0 -76
  209. package/src/provider/auth.ts +0 -147
  210. package/src/provider/models-macro.ts +0 -11
  211. package/src/provider/models.ts +0 -112
  212. package/src/provider/provider.ts +0 -1435
  213. package/src/provider/sdk/openai-compatible/src/README.md +0 -5
  214. package/src/provider/sdk/openai-compatible/src/index.ts +0 -2
  215. package/src/provider/sdk/openai-compatible/src/openai-compatible-provider.ts +0 -100
  216. package/src/provider/sdk/openai-compatible/src/responses/convert-to-openai-responses-input.ts +0 -303
  217. package/src/provider/sdk/openai-compatible/src/responses/map-openai-responses-finish-reason.ts +0 -22
  218. package/src/provider/sdk/openai-compatible/src/responses/openai-config.ts +0 -18
  219. package/src/provider/sdk/openai-compatible/src/responses/openai-error.ts +0 -22
  220. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-api-types.ts +0 -207
  221. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-language-model.ts +0 -1732
  222. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-prepare-tools.ts +0 -177
  223. package/src/provider/sdk/openai-compatible/src/responses/openai-responses-settings.ts +0 -1
  224. package/src/provider/sdk/openai-compatible/src/responses/tool/code-interpreter.ts +0 -88
  225. package/src/provider/sdk/openai-compatible/src/responses/tool/file-search.ts +0 -128
  226. package/src/provider/sdk/openai-compatible/src/responses/tool/image-generation.ts +0 -115
  227. package/src/provider/sdk/openai-compatible/src/responses/tool/local-shell.ts +0 -65
  228. package/src/provider/sdk/openai-compatible/src/responses/tool/web-search-preview.ts +0 -104
  229. package/src/provider/sdk/openai-compatible/src/responses/tool/web-search.ts +0 -103
  230. package/src/provider/transform.ts +0 -733
  231. package/src/pty/index.ts +0 -232
  232. package/src/question/index.ts +0 -171
  233. package/src/scheduler/index.ts +0 -61
  234. package/src/server/error.ts +0 -36
  235. package/src/server/event.ts +0 -7
  236. package/src/server/mdns.ts +0 -59
  237. package/src/server/routes/config.ts +0 -92
  238. package/src/server/routes/experimental.ts +0 -208
  239. package/src/server/routes/file.ts +0 -197
  240. package/src/server/routes/global.ts +0 -135
  241. package/src/server/routes/mcp.ts +0 -361
  242. package/src/server/routes/permission.ts +0 -68
  243. package/src/server/routes/project.ts +0 -82
  244. package/src/server/routes/provider.ts +0 -165
  245. package/src/server/routes/pty.ts +0 -169
  246. package/src/server/routes/question.ts +0 -98
  247. package/src/server/routes/session.ts +0 -935
  248. package/src/server/routes/tui.ts +0 -379
  249. package/src/server/server.ts +0 -573
  250. package/src/session/compaction.ts +0 -225
  251. package/src/session/index.ts +0 -488
  252. package/src/session/llm.ts +0 -279
  253. package/src/session/message-v2.ts +0 -702
  254. package/src/session/message.ts +0 -189
  255. package/src/session/processor.ts +0 -406
  256. package/src/session/prompt/anthropic-20250930.txt +0 -166
  257. package/src/session/prompt/anthropic.txt +0 -105
  258. package/src/session/prompt/anthropic_spoof.txt +0 -1
  259. package/src/session/prompt/beast.txt +0 -147
  260. package/src/session/prompt/build-switch.txt +0 -5
  261. package/src/session/prompt/codex_header.txt +0 -79
  262. package/src/session/prompt/copilot-gpt-5.txt +0 -143
  263. package/src/session/prompt/gemini.txt +0 -155
  264. package/src/session/prompt/max-steps.txt +0 -16
  265. package/src/session/prompt/plan-reminder-anthropic.txt +0 -67
  266. package/src/session/prompt/plan.txt +0 -26
  267. package/src/session/prompt/qwen.txt +0 -109
  268. package/src/session/prompt.ts +0 -1820
  269. package/src/session/retry.ts +0 -90
  270. package/src/session/revert.ts +0 -108
  271. package/src/session/status.ts +0 -76
  272. package/src/session/summary.ts +0 -150
  273. package/src/session/system.ts +0 -152
  274. package/src/session/todo.ts +0 -37
  275. package/src/share/share-next.ts +0 -200
  276. package/src/share/share.ts +0 -92
  277. package/src/shell/shell.ts +0 -67
  278. package/src/skill/index.ts +0 -1
  279. package/src/skill/skill.ts +0 -136
  280. package/src/snapshot/index.ts +0 -236
  281. package/src/storage/storage.ts +0 -227
  282. package/src/tool/apply_patch.ts +0 -269
  283. package/src/tool/apply_patch.txt +0 -33
  284. package/src/tool/bash.ts +0 -259
  285. package/src/tool/bash.txt +0 -115
  286. package/src/tool/batch.ts +0 -175
  287. package/src/tool/batch.txt +0 -24
  288. package/src/tool/codesearch.ts +0 -132
  289. package/src/tool/codesearch.txt +0 -12
  290. package/src/tool/edit.ts +0 -645
  291. package/src/tool/edit.txt +0 -10
  292. package/src/tool/external-directory.ts +0 -32
  293. package/src/tool/glob.ts +0 -77
  294. package/src/tool/glob.txt +0 -6
  295. package/src/tool/grep.ts +0 -154
  296. package/src/tool/grep.txt +0 -8
  297. package/src/tool/invalid.ts +0 -17
  298. package/src/tool/ls.ts +0 -121
  299. package/src/tool/ls.txt +0 -1
  300. package/src/tool/lsp.ts +0 -96
  301. package/src/tool/lsp.txt +0 -19
  302. package/src/tool/multiedit.ts +0 -46
  303. package/src/tool/multiedit.txt +0 -41
  304. package/src/tool/plan-enter.txt +0 -14
  305. package/src/tool/plan-exit.txt +0 -13
  306. package/src/tool/plan.ts +0 -130
  307. package/src/tool/question.ts +0 -33
  308. package/src/tool/question.txt +0 -10
  309. package/src/tool/read.ts +0 -202
  310. package/src/tool/read.txt +0 -12
  311. package/src/tool/registry.ts +0 -164
  312. package/src/tool/skill.ts +0 -75
  313. package/src/tool/task.ts +0 -188
  314. package/src/tool/task.txt +0 -60
  315. package/src/tool/todo.ts +0 -53
  316. package/src/tool/todoread.txt +0 -14
  317. package/src/tool/todowrite.txt +0 -167
  318. package/src/tool/tool.ts +0 -88
  319. package/src/tool/truncation.ts +0 -106
  320. package/src/tool/webfetch.ts +0 -182
  321. package/src/tool/webfetch.txt +0 -13
  322. package/src/tool/websearch.ts +0 -150
  323. package/src/tool/websearch.txt +0 -14
  324. package/src/tool/write.ts +0 -80
  325. package/src/tool/write.txt +0 -8
  326. package/src/util/archive.ts +0 -16
  327. package/src/util/color.ts +0 -19
  328. package/src/util/context.ts +0 -25
  329. package/src/util/defer.ts +0 -12
  330. package/src/util/eventloop.ts +0 -20
  331. package/src/util/filesystem.ts +0 -93
  332. package/src/util/fn.ts +0 -11
  333. package/src/util/format.ts +0 -20
  334. package/src/util/iife.ts +0 -3
  335. package/src/util/keybind.ts +0 -103
  336. package/src/util/lazy.ts +0 -18
  337. package/src/util/locale.ts +0 -81
  338. package/src/util/lock.ts +0 -98
  339. package/src/util/log.ts +0 -180
  340. package/src/util/queue.ts +0 -32
  341. package/src/util/rpc.ts +0 -66
  342. package/src/util/scrap.ts +0 -10
  343. package/src/util/signal.ts +0 -12
  344. package/src/util/timeout.ts +0 -14
  345. package/src/util/token.ts +0 -7
  346. package/src/util/wildcard.ts +0 -56
  347. package/src/worktree/index.ts +0 -424
  348. package/sst-env.d.ts +0 -9
  349. package/test/acp/event-subscription.test.ts +0 -436
  350. package/test/agent/agent.test.ts +0 -638
  351. package/test/bun.test.ts +0 -53
  352. package/test/cli/github-action.test.ts +0 -129
  353. package/test/cli/github-remote.test.ts +0 -80
  354. package/test/cli/tui/transcript.test.ts +0 -297
  355. package/test/config/agent-color.test.ts +0 -66
  356. package/test/config/config.test.ts +0 -1414
  357. package/test/config/fixtures/empty-frontmatter.md +0 -4
  358. package/test/config/fixtures/frontmatter.md +0 -28
  359. package/test/config/fixtures/no-frontmatter.md +0 -1
  360. package/test/config/markdown.test.ts +0 -192
  361. package/test/file/ignore.test.ts +0 -10
  362. package/test/file/path-traversal.test.ts +0 -198
  363. package/test/fixture/fixture.ts +0 -45
  364. package/test/fixture/lsp/fake-lsp-server.js +0 -77
  365. package/test/ide/ide.test.ts +0 -82
  366. package/test/keybind.test.ts +0 -421
  367. package/test/lsp/client.test.ts +0 -95
  368. package/test/mcp/headers.test.ts +0 -153
  369. package/test/mcp/oauth-browser.test.ts +0 -261
  370. package/test/patch/patch.test.ts +0 -348
  371. package/test/permission/arity.test.ts +0 -33
  372. package/test/permission/next.test.ts +0 -652
  373. package/test/permission-task.test.ts +0 -319
  374. package/test/plugin/codex.test.ts +0 -123
  375. package/test/preload.ts +0 -65
  376. package/test/project/project.test.ts +0 -120
  377. package/test/provider/amazon-bedrock.test.ts +0 -268
  378. package/test/provider/gitlab-duo.test.ts +0 -286
  379. package/test/provider/provider.test.ts +0 -2149
  380. package/test/provider/transform.test.ts +0 -1596
  381. package/test/question/question.test.ts +0 -300
  382. package/test/scheduler.test.ts +0 -73
  383. package/test/server/session-list.test.ts +0 -39
  384. package/test/server/session-select.test.ts +0 -78
  385. package/test/session/compaction.test.ts +0 -293
  386. package/test/session/llm.test.ts +0 -90
  387. package/test/session/message-v2.test.ts +0 -662
  388. package/test/session/retry.test.ts +0 -131
  389. package/test/session/revert-compact.test.ts +0 -285
  390. package/test/session/session.test.ts +0 -71
  391. package/test/skill/skill.test.ts +0 -185
  392. package/test/snapshot/snapshot.test.ts +0 -939
  393. package/test/tool/__snapshots__/tool.test.ts.snap +0 -9
  394. package/test/tool/apply_patch.test.ts +0 -499
  395. package/test/tool/bash.test.ts +0 -320
  396. package/test/tool/external-directory.test.ts +0 -126
  397. package/test/tool/fixtures/large-image.png +0 -0
  398. package/test/tool/fixtures/models-api.json +0 -33453
  399. package/test/tool/grep.test.ts +0 -109
  400. package/test/tool/question.test.ts +0 -105
  401. package/test/tool/read.test.ts +0 -332
  402. package/test/tool/registry.test.ts +0 -76
  403. package/test/tool/truncation.test.ts +0 -159
  404. package/test/util/filesystem.test.ts +0 -39
  405. package/test/util/format.test.ts +0 -59
  406. package/test/util/iife.test.ts +0 -36
  407. package/test/util/lazy.test.ts +0 -50
  408. package/test/util/lock.test.ts +0 -72
  409. package/test/util/timeout.test.ts +0 -21
  410. package/test/util/wildcard.test.ts +0 -75
  411. package/tsconfig.json +0 -16
  412. /package/{script/postinstall.mjs → postinstall.mjs} +0 -0
@@ -1,269 +0,0 @@
1
- import z from "zod"
2
- import * as path from "path"
3
- import * as fs from "fs/promises"
4
- import { Tool } from "./tool"
5
- import { Bus } from "../bus"
6
- import { FileWatcher } from "../file/watcher"
7
- import { Instance } from "../project/instance"
8
- import { Patch } from "../patch"
9
- import { createTwoFilesPatch, diffLines } from "diff"
10
- import { assertExternalDirectory } from "./external-directory"
11
- import { trimDiff } from "./edit"
12
- import { LSP } from "../lsp"
13
- import { Filesystem } from "../util/filesystem"
14
- import DESCRIPTION from "./apply_patch.txt"
15
-
16
- const PatchParams = z.object({
17
- patchText: z.string().describe("The full patch text that describes all changes to be made"),
18
- })
19
-
20
- export const ApplyPatchTool = Tool.define("apply_patch", {
21
- description: DESCRIPTION,
22
- parameters: PatchParams,
23
- async execute(params, ctx) {
24
- if (!params.patchText) {
25
- throw new Error("patchText is required")
26
- }
27
-
28
- // Parse the patch to get hunks
29
- let hunks: Patch.Hunk[]
30
- try {
31
- const parseResult = Patch.parsePatch(params.patchText)
32
- hunks = parseResult.hunks
33
- } catch (error) {
34
- throw new Error(`apply_patch verification failed: ${error}`)
35
- }
36
-
37
- if (hunks.length === 0) {
38
- const normalized = params.patchText.replace(/\r\n/g, "\n").replace(/\r/g, "\n").trim()
39
- if (normalized === "*** Begin Patch\n*** End Patch") {
40
- throw new Error("patch rejected: empty patch")
41
- }
42
- throw new Error("apply_patch verification failed: no hunks found")
43
- }
44
-
45
- // Validate file paths and check permissions
46
- const fileChanges: Array<{
47
- filePath: string
48
- oldContent: string
49
- newContent: string
50
- type: "add" | "update" | "delete" | "move"
51
- movePath?: string
52
- diff: string
53
- additions: number
54
- deletions: number
55
- }> = []
56
-
57
- let totalDiff = ""
58
-
59
- for (const hunk of hunks) {
60
- const filePath = path.resolve(Instance.directory, hunk.path)
61
- await assertExternalDirectory(ctx, filePath)
62
-
63
- switch (hunk.type) {
64
- case "add": {
65
- const oldContent = ""
66
- const newContent =
67
- hunk.contents.length === 0 || hunk.contents.endsWith("\n") ? hunk.contents : `${hunk.contents}\n`
68
- const diff = trimDiff(createTwoFilesPatch(filePath, filePath, oldContent, newContent))
69
-
70
- let additions = 0
71
- let deletions = 0
72
- for (const change of diffLines(oldContent, newContent)) {
73
- if (change.added) additions += change.count || 0
74
- if (change.removed) deletions += change.count || 0
75
- }
76
-
77
- fileChanges.push({
78
- filePath,
79
- oldContent,
80
- newContent,
81
- type: "add",
82
- diff,
83
- additions,
84
- deletions,
85
- })
86
-
87
- totalDiff += diff + "\n"
88
- break
89
- }
90
-
91
- case "update": {
92
- // Check if file exists for update
93
- const stats = await fs.stat(filePath).catch(() => null)
94
- if (!stats || stats.isDirectory()) {
95
- throw new Error(`apply_patch verification failed: Failed to read file to update: ${filePath}`)
96
- }
97
-
98
- const oldContent = await fs.readFile(filePath, "utf-8")
99
- let newContent = oldContent
100
-
101
- // Apply the update chunks to get new content
102
- try {
103
- const fileUpdate = Patch.deriveNewContentsFromChunks(filePath, hunk.chunks)
104
- newContent = fileUpdate.content
105
- } catch (error) {
106
- throw new Error(`apply_patch verification failed: ${error}`)
107
- }
108
-
109
- const diff = trimDiff(createTwoFilesPatch(filePath, filePath, oldContent, newContent))
110
-
111
- let additions = 0
112
- let deletions = 0
113
- for (const change of diffLines(oldContent, newContent)) {
114
- if (change.added) additions += change.count || 0
115
- if (change.removed) deletions += change.count || 0
116
- }
117
-
118
- const movePath = hunk.move_path ? path.resolve(Instance.directory, hunk.move_path) : undefined
119
- await assertExternalDirectory(ctx, movePath)
120
-
121
- fileChanges.push({
122
- filePath,
123
- oldContent,
124
- newContent,
125
- type: hunk.move_path ? "move" : "update",
126
- movePath,
127
- diff,
128
- additions,
129
- deletions,
130
- })
131
-
132
- totalDiff += diff + "\n"
133
- break
134
- }
135
-
136
- case "delete": {
137
- const contentToDelete = await fs.readFile(filePath, "utf-8").catch((error) => {
138
- throw new Error(`apply_patch verification failed: ${error}`)
139
- })
140
- const deleteDiff = trimDiff(createTwoFilesPatch(filePath, filePath, contentToDelete, ""))
141
-
142
- const deletions = contentToDelete.split("\n").length
143
-
144
- fileChanges.push({
145
- filePath,
146
- oldContent: contentToDelete,
147
- newContent: "",
148
- type: "delete",
149
- diff: deleteDiff,
150
- additions: 0,
151
- deletions,
152
- })
153
-
154
- totalDiff += deleteDiff + "\n"
155
- break
156
- }
157
- }
158
- }
159
-
160
- // Check permissions if needed
161
- await ctx.ask({
162
- permission: "edit",
163
- patterns: fileChanges.map((c) => path.relative(Instance.worktree, c.filePath)),
164
- always: ["*"],
165
- metadata: {
166
- diff: totalDiff,
167
- },
168
- })
169
-
170
- // Apply the changes
171
- const changedFiles: string[] = []
172
-
173
- for (const change of fileChanges) {
174
- switch (change.type) {
175
- case "add":
176
- // Create parent directories (recursive: true is safe on existing/root dirs)
177
- await fs.mkdir(path.dirname(change.filePath), { recursive: true })
178
- await fs.writeFile(change.filePath, change.newContent, "utf-8")
179
- changedFiles.push(change.filePath)
180
- break
181
-
182
- case "update":
183
- await fs.writeFile(change.filePath, change.newContent, "utf-8")
184
- changedFiles.push(change.filePath)
185
- break
186
-
187
- case "move":
188
- if (change.movePath) {
189
- // Create parent directories (recursive: true is safe on existing/root dirs)
190
- await fs.mkdir(path.dirname(change.movePath), { recursive: true })
191
- await fs.writeFile(change.movePath, change.newContent, "utf-8")
192
- await fs.unlink(change.filePath)
193
- changedFiles.push(change.movePath)
194
- }
195
- break
196
-
197
- case "delete":
198
- await fs.unlink(change.filePath)
199
- changedFiles.push(change.filePath)
200
- break
201
- }
202
- }
203
-
204
- // Publish file change events
205
- for (const filePath of changedFiles) {
206
- await Bus.publish(FileWatcher.Event.Updated, { file: filePath, event: "change" })
207
- }
208
-
209
- // Notify LSP of file changes and collect diagnostics
210
- for (const change of fileChanges) {
211
- if (change.type === "delete") continue
212
- const target = change.movePath ?? change.filePath
213
- await LSP.touchFile(target, true)
214
- }
215
- const diagnostics = await LSP.diagnostics()
216
-
217
- // Generate output summary
218
- const summaryLines = fileChanges.map((change) => {
219
- if (change.type === "add") {
220
- return `A ${path.relative(Instance.worktree, change.filePath)}`
221
- }
222
- if (change.type === "delete") {
223
- return `D ${path.relative(Instance.worktree, change.filePath)}`
224
- }
225
- const target = change.movePath ?? change.filePath
226
- return `M ${path.relative(Instance.worktree, target)}`
227
- })
228
- let output = `Success. Updated the following files:\n${summaryLines.join("\n")}`
229
-
230
- // Report LSP errors for changed files
231
- const MAX_DIAGNOSTICS_PER_FILE = 20
232
- for (const change of fileChanges) {
233
- if (change.type === "delete") continue
234
- const target = change.movePath ?? change.filePath
235
- const normalized = Filesystem.normalizePath(target)
236
- const issues = diagnostics[normalized] ?? []
237
- const errors = issues.filter((item) => item.severity === 1)
238
- if (errors.length > 0) {
239
- const limited = errors.slice(0, MAX_DIAGNOSTICS_PER_FILE)
240
- const suffix =
241
- errors.length > MAX_DIAGNOSTICS_PER_FILE ? `\n... and ${errors.length - MAX_DIAGNOSTICS_PER_FILE} more` : ""
242
- output += `\n\nLSP errors detected in ${path.relative(Instance.worktree, target)}, please fix:\n<diagnostics file="${target}">\n${limited.map(LSP.Diagnostic.pretty).join("\n")}${suffix}\n</diagnostics>`
243
- }
244
- }
245
-
246
- // Build per-file metadata for UI rendering
247
- const files = fileChanges.map((change) => ({
248
- filePath: change.filePath,
249
- relativePath: path.relative(Instance.worktree, change.movePath ?? change.filePath),
250
- type: change.type,
251
- diff: change.diff,
252
- before: change.oldContent,
253
- after: change.newContent,
254
- additions: change.additions,
255
- deletions: change.deletions,
256
- movePath: change.movePath,
257
- }))
258
-
259
- return {
260
- title: output,
261
- metadata: {
262
- diff: totalDiff,
263
- files,
264
- diagnostics,
265
- },
266
- output,
267
- }
268
- },
269
- })
@@ -1,33 +0,0 @@
1
- Use the `apply_patch` tool to edit files. Your patch language is a stripped‑down, file‑oriented diff format designed to be easy to parse and safe to apply. You can think of it as a high‑level envelope:
2
-
3
- *** Begin Patch
4
- [ one or more file sections ]
5
- *** End Patch
6
-
7
- Within that envelope, you get a sequence of file operations.
8
- You MUST include a header to specify the action you are taking.
9
- Each operation starts with one of three headers:
10
-
11
- *** Add File: <path> - create a new file. Every following line is a + line (the initial contents).
12
- *** Delete File: <path> - remove an existing file. Nothing follows.
13
- *** Update File: <path> - patch an existing file in place (optionally with a rename).
14
-
15
- Example patch:
16
-
17
- ```
18
- *** Begin Patch
19
- *** Add File: hello.txt
20
- +Hello world
21
- *** Update File: src/app.py
22
- *** Move to: src/main.py
23
- @@ def greet():
24
- -print("Hi")
25
- +print("Hello, world!")
26
- *** Delete File: obsolete.txt
27
- *** End Patch
28
- ```
29
-
30
- It is important to remember:
31
-
32
- - You must include a header with your intended action (Add/Delete/Update)
33
- - You must prefix new lines with `+` even when creating a new file
package/src/tool/bash.ts DELETED
@@ -1,259 +0,0 @@
1
- import z from "zod"
2
- import { spawn } from "child_process"
3
- import { Tool } from "./tool"
4
- import path from "path"
5
- import DESCRIPTION from "./bash.txt"
6
- import { Log } from "../util/log"
7
- import { Instance } from "../project/instance"
8
- import { lazy } from "@/util/lazy"
9
- import { Language } from "web-tree-sitter"
10
-
11
- import { $ } from "bun"
12
- import { Filesystem } from "@/util/filesystem"
13
- import { fileURLToPath } from "url"
14
- import { Flag } from "@/flag/flag.ts"
15
- import { Shell } from "@/shell/shell"
16
-
17
- import { BashArity } from "@/permission/arity"
18
- import { Truncate } from "./truncation"
19
-
20
- const MAX_METADATA_LENGTH = 30_000
21
- const DEFAULT_TIMEOUT = Flag.EASC_EXPERIMENTAL_BASH_DEFAULT_TIMEOUT_MS || 2 * 60 * 1000
22
-
23
- export const log = Log.create({ service: "bash-tool" })
24
-
25
- const resolveWasm = (asset: string) => {
26
- if (asset.startsWith("file://")) return fileURLToPath(asset)
27
- if (asset.startsWith("/") || /^[a-z]:/i.test(asset)) return asset
28
- const url = new URL(asset, import.meta.url)
29
- return fileURLToPath(url)
30
- }
31
-
32
- const parser = lazy(async () => {
33
- const { Parser } = await import("web-tree-sitter")
34
- const { default: treeWasm } = await import("web-tree-sitter/tree-sitter.wasm" as string, {
35
- with: { type: "wasm" },
36
- })
37
- const treePath = resolveWasm(treeWasm)
38
- await Parser.init({
39
- locateFile() {
40
- return treePath
41
- },
42
- })
43
- const { default: bashWasm } = await import("tree-sitter-bash/tree-sitter-bash.wasm" as string, {
44
- with: { type: "wasm" },
45
- })
46
- const bashPath = resolveWasm(bashWasm)
47
- const bashLanguage = await Language.load(bashPath)
48
- const p = new Parser()
49
- p.setLanguage(bashLanguage)
50
- return p
51
- })
52
-
53
- // TODO: we may wanna rename this tool so it works better on other shells
54
- export const BashTool = Tool.define("bash", async () => {
55
- const shell = Shell.acceptable()
56
- log.info("bash tool using shell", { shell })
57
-
58
- return {
59
- description: DESCRIPTION.replaceAll("${directory}", Instance.directory)
60
- .replaceAll("${maxLines}", String(Truncate.MAX_LINES))
61
- .replaceAll("${maxBytes}", String(Truncate.MAX_BYTES)),
62
- parameters: z.object({
63
- command: z.string().describe("The command to execute"),
64
- timeout: z.number().describe("Optional timeout in milliseconds").optional(),
65
- workdir: z
66
- .string()
67
- .describe(
68
- `The working directory to run the command in. Defaults to ${Instance.directory}. Use this instead of 'cd' commands.`,
69
- )
70
- .optional(),
71
- description: z
72
- .string()
73
- .describe(
74
- "Clear, concise description of what this command does in 5-10 words. Examples:\nInput: ls\nOutput: Lists files in current directory\n\nInput: git status\nOutput: Shows working tree status\n\nInput: npm install\nOutput: Installs package dependencies\n\nInput: mkdir foo\nOutput: Creates directory 'foo'",
75
- )
76
- .optional(),
77
- }),
78
- async execute(params, ctx) {
79
- const cwd = params.workdir || Instance.directory
80
- if (params.timeout !== undefined && params.timeout < 0) {
81
- throw new Error(`Invalid timeout value: ${params.timeout}. Timeout must be a positive number.`)
82
- }
83
- const timeout = params.timeout ?? DEFAULT_TIMEOUT
84
- const tree = await parser().then((p) => p.parse(params.command))
85
- if (!tree) {
86
- throw new Error("Failed to parse command")
87
- }
88
- const directories = new Set<string>()
89
- if (!Instance.containsPath(cwd)) directories.add(cwd)
90
- const patterns = new Set<string>()
91
- const always = new Set<string>()
92
-
93
- for (const node of tree.rootNode.descendantsOfType("command")) {
94
- if (!node) continue
95
- const command = []
96
- for (let i = 0; i < node.childCount; i++) {
97
- const child = node.child(i)
98
- if (!child) continue
99
- if (
100
- child.type !== "command_name" &&
101
- child.type !== "word" &&
102
- child.type !== "string" &&
103
- child.type !== "raw_string" &&
104
- child.type !== "concatenation"
105
- ) {
106
- continue
107
- }
108
- command.push(child.text)
109
- }
110
-
111
- // not an exhaustive list, but covers most common cases
112
- if (["cd", "rm", "cp", "mv", "mkdir", "touch", "chmod", "chown"].includes(command[0])) {
113
- for (const arg of command.slice(1)) {
114
- if (arg.startsWith("-") || (command[0] === "chmod" && arg.startsWith("+"))) continue
115
- const resolved = await $`realpath ${arg}`
116
- .cwd(cwd)
117
- .quiet()
118
- .nothrow()
119
- .text()
120
- .then((x) => x.trim())
121
- log.info("resolved path", { arg, resolved })
122
- if (resolved) {
123
- // Git Bash on Windows returns Unix-style paths like /c/Users/...
124
- const normalized =
125
- process.platform === "win32" && resolved.match(/^\/[a-z]\//)
126
- ? resolved.replace(/^\/([a-z])\//, (_, drive) => `${drive.toUpperCase()}:\\`).replace(/\//g, "\\")
127
- : resolved
128
- if (!Instance.containsPath(normalized)) directories.add(normalized)
129
- }
130
- }
131
- }
132
-
133
- // cd covered by above check
134
- if (command.length && command[0] !== "cd") {
135
- patterns.add(command.join(" "))
136
- always.add(BashArity.prefix(command).join(" ") + "*")
137
- }
138
- }
139
-
140
- if (directories.size > 0) {
141
- await ctx.ask({
142
- permission: "external_directory",
143
- patterns: Array.from(directories),
144
- always: Array.from(directories).map((x) => path.dirname(x) + "*"),
145
- metadata: {},
146
- })
147
- }
148
-
149
- if (patterns.size > 0) {
150
- await ctx.ask({
151
- permission: "bash",
152
- patterns: Array.from(patterns),
153
- always: Array.from(always),
154
- metadata: {},
155
- })
156
- }
157
-
158
- const proc = spawn(params.command, {
159
- shell,
160
- cwd,
161
- env: {
162
- ...process.env,
163
- },
164
- stdio: ["ignore", "pipe", "pipe"],
165
- detached: process.platform !== "win32",
166
- })
167
-
168
- let output = ""
169
-
170
- // Initialize metadata with empty output
171
- ctx.metadata({
172
- metadata: {
173
- output: "",
174
- description: params.description,
175
- },
176
- })
177
-
178
- const append = (chunk: Buffer) => {
179
- output += chunk.toString()
180
- ctx.metadata({
181
- metadata: {
182
- // truncate the metadata to avoid GIANT blobs of data (has nothing to do w/ what agent can access)
183
- output: output.length > MAX_METADATA_LENGTH ? output.slice(0, MAX_METADATA_LENGTH) + "\n\n..." : output,
184
- description: params.description,
185
- },
186
- })
187
- }
188
-
189
- proc.stdout?.on("data", append)
190
- proc.stderr?.on("data", append)
191
-
192
- let timedOut = false
193
- let aborted = false
194
- let exited = false
195
-
196
- const kill = () => Shell.killTree(proc, { exited: () => exited })
197
-
198
- if (ctx.abort.aborted) {
199
- aborted = true
200
- await kill()
201
- }
202
-
203
- const abortHandler = () => {
204
- aborted = true
205
- void kill()
206
- }
207
-
208
- ctx.abort.addEventListener("abort", abortHandler, { once: true })
209
-
210
- const timeoutTimer = setTimeout(() => {
211
- timedOut = true
212
- void kill()
213
- }, timeout + 100)
214
-
215
- await new Promise<void>((resolve, reject) => {
216
- const cleanup = () => {
217
- clearTimeout(timeoutTimer)
218
- ctx.abort.removeEventListener("abort", abortHandler)
219
- }
220
-
221
- proc.once("exit", () => {
222
- exited = true
223
- cleanup()
224
- resolve()
225
- })
226
-
227
- proc.once("error", (error) => {
228
- exited = true
229
- cleanup()
230
- reject(error)
231
- })
232
- })
233
-
234
- const resultMetadata: string[] = []
235
-
236
- if (timedOut) {
237
- resultMetadata.push(`bash tool terminated command after exceeding timeout ${timeout} ms`)
238
- }
239
-
240
- if (aborted) {
241
- resultMetadata.push("User aborted the command")
242
- }
243
-
244
- if (resultMetadata.length > 0) {
245
- output += "\n\n<bash_metadata>\n" + resultMetadata.join("\n") + "\n</bash_metadata>"
246
- }
247
-
248
- return {
249
- title: params.description || "bash",
250
- metadata: {
251
- output: output.length > MAX_METADATA_LENGTH ? output.slice(0, MAX_METADATA_LENGTH) + "\n\n..." : output,
252
- exit: proc.exitCode,
253
- description: params.description,
254
- },
255
- output,
256
- }
257
- },
258
- }
259
- })
package/src/tool/bash.txt DELETED
@@ -1,115 +0,0 @@
1
- Executes a given bash command in a persistent shell session with optional timeout, ensuring proper handling and security measures.
2
-
3
- All commands run in ${directory} by default. Use the `workdir` parameter if you need to run a command in a different directory. AVOID using `cd <directory> && <command>` patterns - use `workdir` instead.
4
-
5
- IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
6
-
7
- Before executing the command, please follow these steps:
8
-
9
- 1. Directory Verification:
10
- - If the command will create new directories or files, first use `ls` to verify the parent directory exists and is the correct location
11
- - For example, before running "mkdir foo/bar", first use `ls foo` to check that "foo" exists and is the intended parent directory
12
-
13
- 2. Command Execution:
14
- - Always quote file paths that contain spaces with double quotes (e.g., rm "path with spaces/file.txt")
15
- - Examples of proper quoting:
16
- - mkdir "/Users/name/My Documents" (correct)
17
- - mkdir /Users/name/My Documents (incorrect - will fail)
18
- - python "/path/with spaces/script.py" (correct)
19
- - python /path/with spaces/script.py (incorrect - will fail)
20
- - After ensuring proper quoting, execute the command.
21
- - Capture the output of the command.
22
-
23
- Usage notes:
24
- - The command argument is required.
25
- - You can specify an optional timeout in milliseconds. If not specified, commands will time out after 120000ms (2 minutes).
26
- - It is very helpful if you write a clear, concise description of what this command does in 5-10 words.
27
- - If the output exceeds ${maxLines} lines or ${maxBytes} bytes, it will be truncated and the full output will be written to a file. You can use Read with offset/limit to read specific sections or Grep to search the full content. Because of this, you do NOT need to use `head`, `tail`, or other truncation commands to limit output - just run the command directly.
28
-
29
- - Avoid using Bash with the `find`, `grep`, `cat`, `head`, `tail`, `sed`, `awk`, or `echo` commands, unless explicitly instructed or when these commands are truly necessary for the task. Instead, always prefer using the dedicated tools for these commands:
30
- - File search: Use Glob (NOT find or ls)
31
- - Content search: Use Grep (NOT grep or rg)
32
- - Read files: Use Read (NOT cat/head/tail)
33
- - Edit files: Use Edit (NOT sed/awk)
34
- - Write files: Use Write (NOT echo >/cat <<EOF)
35
- - Communication: Output text directly (NOT echo/printf)
36
- - When issuing multiple commands:
37
- - If the commands are independent and can run in parallel, make multiple Bash tool calls in a single message. For example, if you need to run "git status" and "git diff", send a single message with two Bash tool calls in parallel.
38
- - If the commands depend on each other and must run sequentially, use a single Bash call with '&&' to chain them together (e.g., `git add . && git commit -m "message" && git push`). For instance, if one operation must complete before another starts (like mkdir before cp, Write before Bash for git operations, or git add before git commit), run these operations sequentially instead.
39
- - Use ';' only when you need to run commands sequentially but don't care if earlier commands fail
40
- - DO NOT use newlines to separate commands (newlines are ok in quoted strings)
41
- - AVOID using `cd <directory> && <command>`. Use the `workdir` parameter to change directories instead.
42
- <good-example>
43
- Use workdir="/foo/bar" with command: pytest tests
44
- </good-example>
45
- <bad-example>
46
- cd /foo/bar && pytest tests
47
- </bad-example>
48
-
49
- # Committing changes with git
50
-
51
- Only create commits when requested by the user. If unclear, ask first. When the user asks you to create a new git commit, follow these steps carefully:
52
-
53
- Git Safety Protocol:
54
- - NEVER update the git config
55
- - NEVER run destructive/irreversible git commands (like push --force, hard reset, etc) unless the user explicitly requests them
56
- - NEVER skip hooks (--no-verify, --no-gpg-sign, etc) unless the user explicitly requests it
57
- - NEVER run force push to main/master, warn the user if they request it
58
- - Avoid git commit --amend. ONLY use --amend when ALL conditions are met:
59
- (1) User explicitly requested amend, OR commit SUCCEEDED but pre-commit hook auto-modified files that need including
60
- (2) HEAD commit was created by you in this conversation (verify: git log -1 --format='%an %ae')
61
- (3) Commit has NOT been pushed to remote (verify: git status shows "Your branch is ahead")
62
- - CRITICAL: If commit FAILED or was REJECTED by hook, NEVER amend - fix the issue and create a NEW commit
63
- - CRITICAL: If you already pushed to remote, NEVER amend unless user explicitly requests it (requires force push)
64
- - NEVER commit changes unless the user explicitly asks you to. It is VERY IMPORTANT to only commit when explicitly asked, otherwise the user will feel that you are being too proactive.
65
-
66
- 1. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following bash commands in parallel, each using the Bash tool:
67
- - Run a git status command to see all untracked files.
68
- - Run a git diff command to see both staged and unstaged changes that will be committed.
69
- - Run a git log command to see recent commit messages, so that you can follow this repository's commit message style.
70
- 2. Analyze all staged changes (both previously staged and newly added) and draft a commit message:
71
- - Summarize the nature of the changes (eg. new feature, enhancement to an existing feature, bug fix, refactoring, test, docs, etc.). Ensure the message accurately reflects the changes and their purpose (i.e. "add" means a wholly new feature, "update" means an enhancement to an existing feature, "fix" means a bug fix, etc.).
72
- - Do not commit files that likely contain secrets (.env, credentials.json, etc.). Warn the user if they specifically request to commit those files
73
- - Draft a concise (1-2 sentences) commit message that focuses on the "why" rather than the "what"
74
- - Ensure it accurately reflects the changes and their purpose
75
- 3. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following commands:
76
- - Add relevant untracked files to the staging area.
77
- - Create the commit with a message
78
- - Run git status after the commit completes to verify success.
79
- Note: git status depends on the commit completing, so run it sequentially after the commit.
80
- 4. If the commit fails due to pre-commit hook, fix the issue and create a NEW commit (see amend rules above)
81
-
82
- Important notes:
83
- - NEVER run additional commands to read or explore code, besides git bash commands
84
- - NEVER use the TodoWrite or Task tools
85
- - DO NOT push to the remote repository unless the user explicitly asks you to do so
86
- - IMPORTANT: Never use git commands with the -i flag (like git rebase -i or git add -i) since they require interactive input which is not supported.
87
- - If there are no changes to commit (i.e., no untracked files and no modifications), do not create an empty commit
88
-
89
- # Creating pull requests
90
- Use the gh command via the Bash tool for ALL GitHub-related tasks including working with issues, pull requests, checks, and releases. If given a Github URL use the gh command to get the information needed.
91
-
92
- IMPORTANT: When the user asks you to create a pull request, follow these steps carefully:
93
-
94
- 1. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following bash commands in parallel using the Bash tool, in order to understand the current state of the branch since it diverged from the main branch:
95
- - Run a git status command to see all untracked files
96
- - Run a git diff command to see both staged and unstaged changes that will be committed
97
- - Check if the current branch tracks a remote branch and is up to date with the remote, so you know if you need to push to the remote
98
- - Run a git log command and `git diff [base-branch]...HEAD` to understand the full commit history for the current branch (from the time it diverged from the base branch)
99
- 2. Analyze all changes that will be included in the pull request, making sure to look at all relevant commits (NOT just the latest commit, but ALL commits that will be included in the pull request!!!), and draft a pull request summary
100
- 3. You can call multiple tools in a single response. When multiple independent pieces of information are requested and all commands are likely to succeed, run multiple tool calls in parallel for optimal performance. run the following commands in parallel:
101
- - Create new branch if needed
102
- - Push to remote with -u flag if needed
103
- - Create PR using gh pr create with the format below. Use a HEREDOC to pass the body to ensure correct formatting.
104
- <example>
105
- gh pr create --title "the pr title" --body "$(cat <<'EOF'
106
- ## Summary
107
- <1-3 bullet points>
108
- </example>
109
-
110
- Important:
111
- - DO NOT use the TodoWrite or Task tools
112
- - Return the PR URL when you're done, so the user can see it
113
-
114
- # Other common operations
115
- - View comments on a Github PR: gh api repos/foo/bar/pulls/123/comments