@epoch-ai/cli 2.2.5 → 2.2.7

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 (711) hide show
  1. package/.artifacts/unit/junit.xml +2823 -0
  2. package/.project-map/backups/20260530_223453/.project-map.json +90101 -0
  3. package/.project-map/backups/20260530_223507/.project-map.json +90101 -0
  4. package/.project-map/backups/20260530_223512/.project-map.json +90101 -0
  5. package/.project-map/backups/20260530_223512/map.toon +666 -0
  6. package/.project-map/backups/20260530_223516/.project-map.json +90101 -0
  7. package/.project-map/backups/20260530_223516/map.toon +666 -0
  8. package/.project-map/backups/20260530_223520/.project-map.json +90101 -0
  9. package/.project-map/backups/20260530_223520/map.toon +666 -0
  10. package/AGENTS.md +47 -0
  11. package/BUN_SHELL_MIGRATION_PLAN.md +136 -0
  12. package/Dockerfile +18 -0
  13. package/README.md +15 -0
  14. package/bunfig.toml +7 -0
  15. package/drizzle.config.ts +10 -0
  16. package/git +0 -0
  17. package/migration/20260127222353_familiar_lady_ursula/migration.sql +90 -0
  18. package/migration/20260127222353_familiar_lady_ursula/snapshot.json +796 -0
  19. package/migration/20260211171708_add_project_commands/migration.sql +1 -0
  20. package/migration/20260211171708_add_project_commands/snapshot.json +806 -0
  21. package/migration/20260213144116_wakeful_the_professor/migration.sql +11 -0
  22. package/migration/20260213144116_wakeful_the_professor/snapshot.json +897 -0
  23. package/migration/20260225215848_workspace/migration.sql +7 -0
  24. package/migration/20260225215848_workspace/snapshot.json +959 -0
  25. package/migration/20260227213759_add_session_workspace_id/migration.sql +2 -0
  26. package/migration/20260227213759_add_session_workspace_id/snapshot.json +983 -0
  27. package/migration/20260228203230_blue_harpoon/migration.sql +17 -0
  28. package/migration/20260228203230_blue_harpoon/snapshot.json +1102 -0
  29. package/migration/20260303231226_add_workspace_fields/migration.sql +5 -0
  30. package/migration/20260303231226_add_workspace_fields/snapshot.json +1013 -0
  31. package/migration/20260309230000_move_org_to_state/migration.sql +3 -0
  32. package/migration/20260309230000_move_org_to_state/snapshot.json +1156 -0
  33. package/migration/20260312043431_session_message_cursor/migration.sql +4 -0
  34. package/migration/20260312043431_session_message_cursor/snapshot.json +1168 -0
  35. package/migration/20260323234822_events/migration.sql +13 -0
  36. package/migration/20260323234822_events/snapshot.json +1271 -0
  37. package/migration/20260418092949_add_yolo_to_session/migration.sql +2 -0
  38. package/migration/20260418092949_add_yolo_to_session/snapshot.json +1199 -0
  39. package/migration/20260419120000_add_intervention_to_session/migration.sql +2 -0
  40. package/package.json +179 -18
  41. package/parsers-config.ts +290 -0
  42. package/script/build-node.ts +71 -0
  43. package/script/build.ts +255 -0
  44. package/script/check-migrations.ts +16 -0
  45. package/script/fix-node-pty.ts +28 -0
  46. package/script/publish.ts +182 -0
  47. package/script/schema.ts +63 -0
  48. package/script/seed-e2e.ts +60 -0
  49. package/script/upgrade-opentui.ts +64 -0
  50. package/specs/effect-migration.md +310 -0
  51. package/specs/tui-plugins.md +436 -0
  52. package/specs/v2.md +14 -0
  53. package/src/account/account.sql.ts +39 -0
  54. package/src/account/index.ts +465 -0
  55. package/src/account/repo.ts +163 -0
  56. package/src/account/schema.ts +91 -0
  57. package/src/acp/README.md +174 -0
  58. package/src/acp/agent.ts +1847 -0
  59. package/src/acp/session.ts +116 -0
  60. package/src/acp/types.ts +24 -0
  61. package/src/agent/agent.ts +445 -0
  62. package/src/agent/generate.txt +75 -0
  63. package/src/agent/prompt/compaction.txt +15 -0
  64. package/src/agent/prompt/explore.txt +9 -0
  65. package/src/agent/prompt/summary.txt +11 -0
  66. package/src/agent/prompt/title.txt +44 -0
  67. package/src/auth/index.ts +110 -0
  68. package/src/bus/bus-event.ts +40 -0
  69. package/src/bus/global.ts +10 -0
  70. package/src/bus/index.ts +232 -0
  71. package/src/cli/bootstrap.ts +17 -0
  72. package/src/cli/cmd/account.ts +257 -0
  73. package/src/cli/cmd/acp.ts +70 -0
  74. package/src/cli/cmd/agent.ts +245 -0
  75. package/src/cli/cmd/cmd.ts +7 -0
  76. package/src/cli/cmd/db.ts +119 -0
  77. package/src/cli/cmd/debug/agent.ts +167 -0
  78. package/src/cli/cmd/debug/config.ts +16 -0
  79. package/src/cli/cmd/debug/file.ts +97 -0
  80. package/src/cli/cmd/debug/index.ts +48 -0
  81. package/src/cli/cmd/debug/lsp.ts +53 -0
  82. package/src/cli/cmd/debug/ripgrep.ts +87 -0
  83. package/src/cli/cmd/debug/scrap.ts +16 -0
  84. package/src/cli/cmd/debug/skill.ts +16 -0
  85. package/src/cli/cmd/debug/snapshot.ts +52 -0
  86. package/src/cli/cmd/export.ts +89 -0
  87. package/src/cli/cmd/generate.ts +38 -0
  88. package/src/cli/cmd/github.ts +1639 -0
  89. package/src/cli/cmd/import.ts +169 -0
  90. package/src/cli/cmd/mcp.ts +754 -0
  91. package/src/cli/cmd/models.ts +78 -0
  92. package/src/cli/cmd/plug.ts +233 -0
  93. package/src/cli/cmd/pr.ts +127 -0
  94. package/src/cli/cmd/providers.ts +478 -0
  95. package/src/cli/cmd/run.ts +681 -0
  96. package/src/cli/cmd/serve.ts +24 -0
  97. package/src/cli/cmd/session.ts +159 -0
  98. package/src/cli/cmd/stats.ts +410 -0
  99. package/src/cli/cmd/tui/app.tsx +945 -0
  100. package/src/cli/cmd/tui/attach.ts +88 -0
  101. package/src/cli/cmd/tui/component/border.tsx +21 -0
  102. package/src/cli/cmd/tui/component/dialog-agent.tsx +31 -0
  103. package/src/cli/cmd/tui/component/dialog-command.tsx +171 -0
  104. package/src/cli/cmd/tui/component/dialog-console-org.tsx +103 -0
  105. package/src/cli/cmd/tui/component/dialog-mcp.tsx +86 -0
  106. package/src/cli/cmd/tui/component/dialog-model.tsx +190 -0
  107. package/src/cli/cmd/tui/component/dialog-provider.tsx +364 -0
  108. package/src/cli/cmd/tui/component/dialog-session-list.tsx +108 -0
  109. package/src/cli/cmd/tui/component/dialog-session-rename.tsx +31 -0
  110. package/src/cli/cmd/tui/component/dialog-skill.tsx +36 -0
  111. package/src/cli/cmd/tui/component/dialog-stash.tsx +87 -0
  112. package/src/cli/cmd/tui/component/dialog-status.tsx +168 -0
  113. package/src/cli/cmd/tui/component/dialog-tag.tsx +44 -0
  114. package/src/cli/cmd/tui/component/dialog-theme-list.tsx +50 -0
  115. package/src/cli/cmd/tui/component/dialog-variant.tsx +39 -0
  116. package/src/cli/cmd/tui/component/dialog-workspace-list.tsx +320 -0
  117. package/src/cli/cmd/tui/component/error-component.tsx +92 -0
  118. package/src/cli/cmd/tui/component/logo.tsx +85 -0
  119. package/src/cli/cmd/tui/component/plugin-route-missing.tsx +14 -0
  120. package/src/cli/cmd/tui/component/prompt/autocomplete.tsx +672 -0
  121. package/src/cli/cmd/tui/component/prompt/frecency.tsx +90 -0
  122. package/src/cli/cmd/tui/component/prompt/history.tsx +109 -0
  123. package/src/cli/cmd/tui/component/prompt/index.tsx +1348 -0
  124. package/src/cli/cmd/tui/component/prompt/part.ts +16 -0
  125. package/src/cli/cmd/tui/component/prompt/stash.tsx +101 -0
  126. package/src/cli/cmd/tui/component/spinner.tsx +24 -0
  127. package/src/cli/cmd/tui/component/startup-loading.tsx +63 -0
  128. package/src/cli/cmd/tui/component/textarea-keybindings.ts +73 -0
  129. package/src/cli/cmd/tui/component/todo-item.tsx +32 -0
  130. package/src/cli/cmd/tui/component/workspace/dialog-session-list.tsx +151 -0
  131. package/src/cli/cmd/tui/context/args.tsx +15 -0
  132. package/src/cli/cmd/tui/context/directory.ts +13 -0
  133. package/src/cli/cmd/tui/context/exit.tsx +60 -0
  134. package/src/cli/cmd/tui/context/helper.tsx +25 -0
  135. package/src/cli/cmd/tui/context/keybind.tsx +105 -0
  136. package/src/cli/cmd/tui/context/kv.tsx +52 -0
  137. package/src/cli/cmd/tui/context/local.tsx +456 -0
  138. package/src/cli/cmd/tui/context/plugin-keybinds.ts +41 -0
  139. package/src/cli/cmd/tui/context/prompt.tsx +18 -0
  140. package/src/cli/cmd/tui/context/route.tsx +52 -0
  141. package/src/cli/cmd/tui/context/sdk.tsx +115 -0
  142. package/src/cli/cmd/tui/context/sync.tsx +516 -0
  143. package/src/cli/cmd/tui/context/theme/aura.json +69 -0
  144. package/src/cli/cmd/tui/context/theme/ayu.json +80 -0
  145. package/src/cli/cmd/tui/context/theme/carbonfox.json +248 -0
  146. package/src/cli/cmd/tui/context/theme/catppuccin-frappe.json +233 -0
  147. package/src/cli/cmd/tui/context/theme/catppuccin-macchiato.json +233 -0
  148. package/src/cli/cmd/tui/context/theme/catppuccin.json +112 -0
  149. package/src/cli/cmd/tui/context/theme/cobalt2.json +228 -0
  150. package/src/cli/cmd/tui/context/theme/cursor.json +249 -0
  151. package/src/cli/cmd/tui/context/theme/dracula.json +219 -0
  152. package/src/cli/cmd/tui/context/theme/epochcli.json +245 -0
  153. package/src/cli/cmd/tui/context/theme/everforest.json +241 -0
  154. package/src/cli/cmd/tui/context/theme/flexoki.json +237 -0
  155. package/src/cli/cmd/tui/context/theme/github.json +233 -0
  156. package/src/cli/cmd/tui/context/theme/gruvbox.json +242 -0
  157. package/src/cli/cmd/tui/context/theme/kanagawa.json +77 -0
  158. package/src/cli/cmd/tui/context/theme/lucent-orng.json +237 -0
  159. package/src/cli/cmd/tui/context/theme/material.json +235 -0
  160. package/src/cli/cmd/tui/context/theme/matrix.json +77 -0
  161. package/src/cli/cmd/tui/context/theme/mercury.json +252 -0
  162. package/src/cli/cmd/tui/context/theme/monokai.json +221 -0
  163. package/src/cli/cmd/tui/context/theme/nightowl.json +221 -0
  164. package/src/cli/cmd/tui/context/theme/nord.json +223 -0
  165. package/src/cli/cmd/tui/context/theme/one-dark.json +84 -0
  166. package/src/cli/cmd/tui/context/theme/orng.json +249 -0
  167. package/src/cli/cmd/tui/context/theme/osaka-jade.json +93 -0
  168. package/src/cli/cmd/tui/context/theme/palenight.json +222 -0
  169. package/src/cli/cmd/tui/context/theme/rosepine.json +234 -0
  170. package/src/cli/cmd/tui/context/theme/solarized.json +223 -0
  171. package/src/cli/cmd/tui/context/theme/synthwave84.json +226 -0
  172. package/src/cli/cmd/tui/context/theme/tokyonight.json +243 -0
  173. package/src/cli/cmd/tui/context/theme/vercel.json +245 -0
  174. package/src/cli/cmd/tui/context/theme/vesper.json +218 -0
  175. package/src/cli/cmd/tui/context/theme/zenburn.json +223 -0
  176. package/src/cli/cmd/tui/context/theme.tsx +1236 -0
  177. package/src/cli/cmd/tui/context/tui-config.tsx +9 -0
  178. package/src/cli/cmd/tui/event.ts +48 -0
  179. package/src/cli/cmd/tui/feature-plugins/home/footer.tsx +93 -0
  180. package/src/cli/cmd/tui/feature-plugins/home/tips-view.tsx +145 -0
  181. package/src/cli/cmd/tui/feature-plugins/home/tips.tsx +50 -0
  182. package/src/cli/cmd/tui/feature-plugins/sidebar/context.tsx +82 -0
  183. package/src/cli/cmd/tui/feature-plugins/sidebar/files.tsx +62 -0
  184. package/src/cli/cmd/tui/feature-plugins/sidebar/footer.tsx +93 -0
  185. package/src/cli/cmd/tui/feature-plugins/sidebar/lsp.tsx +66 -0
  186. package/src/cli/cmd/tui/feature-plugins/sidebar/mcp.tsx +96 -0
  187. package/src/cli/cmd/tui/feature-plugins/sidebar/todo.tsx +48 -0
  188. package/src/cli/cmd/tui/feature-plugins/system/plugins.tsx +270 -0
  189. package/src/cli/cmd/tui/plugin/api.tsx +397 -0
  190. package/src/cli/cmd/tui/plugin/index.ts +3 -0
  191. package/src/cli/cmd/tui/plugin/internal.ts +27 -0
  192. package/src/cli/cmd/tui/plugin/runtime.ts +1031 -0
  193. package/src/cli/cmd/tui/plugin/slots.tsx +60 -0
  194. package/src/cli/cmd/tui/routes/home.tsx +94 -0
  195. package/src/cli/cmd/tui/routes/session/dialog-fork-from-timeline.tsx +65 -0
  196. package/src/cli/cmd/tui/routes/session/dialog-message.tsx +110 -0
  197. package/src/cli/cmd/tui/routes/session/dialog-subagent.tsx +26 -0
  198. package/src/cli/cmd/tui/routes/session/dialog-timeline.tsx +47 -0
  199. package/src/cli/cmd/tui/routes/session/footer.tsx +91 -0
  200. package/src/cli/cmd/tui/routes/session/index.tsx +2161 -0
  201. package/src/cli/cmd/tui/routes/session/permission.tsx +691 -0
  202. package/src/cli/cmd/tui/routes/session/question.tsx +468 -0
  203. package/src/cli/cmd/tui/routes/session/sidebar.tsx +70 -0
  204. package/src/cli/cmd/tui/routes/session/subagent-footer.tsx +131 -0
  205. package/src/cli/cmd/tui/thread.ts +241 -0
  206. package/src/cli/cmd/tui/ui/dialog-alert.tsx +59 -0
  207. package/src/cli/cmd/tui/ui/dialog-confirm.tsx +89 -0
  208. package/src/cli/cmd/tui/ui/dialog-export-options.tsx +211 -0
  209. package/src/cli/cmd/tui/ui/dialog-help.tsx +40 -0
  210. package/src/cli/cmd/tui/ui/dialog-prompt.tsx +115 -0
  211. package/src/cli/cmd/tui/ui/dialog-select.tsx +417 -0
  212. package/src/cli/cmd/tui/ui/dialog.tsx +192 -0
  213. package/src/cli/cmd/tui/ui/link.tsx +28 -0
  214. package/src/cli/cmd/tui/ui/spinner.ts +368 -0
  215. package/src/cli/cmd/tui/ui/toast.tsx +100 -0
  216. package/src/cli/cmd/tui/util/clipboard.ts +192 -0
  217. package/src/cli/cmd/tui/util/editor.ts +37 -0
  218. package/src/cli/cmd/tui/util/model.ts +23 -0
  219. package/src/cli/cmd/tui/util/provider-origin.ts +20 -0
  220. package/src/cli/cmd/tui/util/scroll.ts +23 -0
  221. package/src/cli/cmd/tui/util/selection.ts +25 -0
  222. package/src/cli/cmd/tui/util/signal.ts +7 -0
  223. package/src/cli/cmd/tui/util/terminal.ts +114 -0
  224. package/src/cli/cmd/tui/util/transcript.ts +112 -0
  225. package/src/cli/cmd/tui/win32.ts +129 -0
  226. package/src/cli/cmd/tui/worker.ts +195 -0
  227. package/src/cli/cmd/uninstall.ts +353 -0
  228. package/src/cli/cmd/upgrade.ts +73 -0
  229. package/src/cli/cmd/web.ts +81 -0
  230. package/src/cli/effect/prompt.ts +25 -0
  231. package/src/cli/error.ts +46 -0
  232. package/src/cli/heap.ts +59 -0
  233. package/src/cli/logo.ts +6 -0
  234. package/src/cli/network.ts +60 -0
  235. package/src/cli/ui.ts +133 -0
  236. package/src/cli/upgrade.ts +31 -0
  237. package/src/command/index.ts +197 -0
  238. package/src/command/template/initialize.txt +66 -0
  239. package/src/command/template/review.txt +101 -0
  240. package/src/config/config.ts +1610 -0
  241. package/src/config/console-state.ts +15 -0
  242. package/src/config/markdown.ts +99 -0
  243. package/src/config/paths.ts +167 -0
  244. package/src/config/tui-migrate.ts +155 -0
  245. package/src/config/tui-schema.ts +37 -0
  246. package/src/config/tui.ts +179 -0
  247. package/src/config/validator.ts +52 -0
  248. package/src/control-plane/adaptors/index.ts +20 -0
  249. package/src/control-plane/adaptors/worktree.ts +42 -0
  250. package/src/control-plane/schema.ts +17 -0
  251. package/src/control-plane/sse.ts +66 -0
  252. package/src/control-plane/types.ts +32 -0
  253. package/src/control-plane/workspace.sql.ts +17 -0
  254. package/src/control-plane/workspace.ts +168 -0
  255. package/src/effect/cross-spawn-spawner.ts +502 -0
  256. package/src/effect/instance-ref.ts +6 -0
  257. package/src/effect/instance-registry.ts +12 -0
  258. package/src/effect/instance-state.ts +82 -0
  259. package/src/effect/run-service.ts +33 -0
  260. package/src/effect/runner.ts +216 -0
  261. package/src/env/index.ts +28 -0
  262. package/src/file/ignore.ts +82 -0
  263. package/src/file/index.ts +686 -0
  264. package/src/file/protected.ts +59 -0
  265. package/src/file/ripgrep.ts +376 -0
  266. package/src/file/time.ts +133 -0
  267. package/src/file/watcher.ts +172 -0
  268. package/src/filesystem/index.ts +236 -0
  269. package/src/flag/flag.ts +157 -0
  270. package/src/format/formatter.ts +413 -0
  271. package/src/format/index.ts +203 -0
  272. package/src/git/index.ts +303 -0
  273. package/src/global/index.ts +54 -0
  274. package/src/id/id.ts +85 -0
  275. package/src/ide/index.ts +74 -0
  276. package/src/index.ts +253 -0
  277. package/src/installation/index.ts +355 -0
  278. package/src/installation/meta.ts +7 -0
  279. package/src/lsp/client.ts +256 -0
  280. package/src/lsp/index.ts +558 -0
  281. package/src/lsp/language.ts +120 -0
  282. package/src/lsp/launch.ts +21 -0
  283. package/src/lsp/server.ts +1968 -0
  284. package/src/mcp/auth.ts +173 -0
  285. package/src/mcp/index.ts +1250 -0
  286. package/src/mcp/oauth-callback.ts +216 -0
  287. package/src/mcp/oauth-provider.ts +185 -0
  288. package/src/mcp/schema-loader.ts +82 -0
  289. package/src/node.ts +1 -0
  290. package/src/npm/index.ts +188 -0
  291. package/src/patch/index.ts +680 -0
  292. package/src/permission/arity.ts +163 -0
  293. package/src/permission/evaluate.ts +15 -0
  294. package/src/permission/index.ts +323 -0
  295. package/src/permission/schema.ts +17 -0
  296. package/src/plugin/cloudflare.ts +67 -0
  297. package/src/plugin/codex.ts +608 -0
  298. package/src/plugin/github-copilot/copilot.ts +361 -0
  299. package/src/plugin/github-copilot/models.ts +144 -0
  300. package/src/plugin/index.ts +288 -0
  301. package/src/plugin/install.ts +439 -0
  302. package/src/plugin/loader.ts +174 -0
  303. package/src/plugin/meta.ts +188 -0
  304. package/src/plugin/shared.ts +323 -0
  305. package/src/project/bootstrap.ts +35 -0
  306. package/src/project/init-files.ts +328 -0
  307. package/src/project/instance.ts +175 -0
  308. package/src/project/project.sql.ts +16 -0
  309. package/src/project/project.ts +519 -0
  310. package/src/project/schema.ts +16 -0
  311. package/src/project/state.ts +70 -0
  312. package/src/project/vcs.ts +240 -0
  313. package/src/provider/auth.ts +253 -0
  314. package/src/provider/error.ts +297 -0
  315. package/src/provider/models.ts +162 -0
  316. package/src/provider/provider.ts +1776 -0
  317. package/src/provider/schema.ts +38 -0
  318. package/src/provider/sdk/copilot/README.md +5 -0
  319. package/src/provider/sdk/copilot/chat/convert-to-openai-compatible-chat-messages.ts +170 -0
  320. package/src/provider/sdk/copilot/chat/get-response-metadata.ts +15 -0
  321. package/src/provider/sdk/copilot/chat/map-openai-compatible-finish-reason.ts +19 -0
  322. package/src/provider/sdk/copilot/chat/openai-compatible-api-types.ts +64 -0
  323. package/src/provider/sdk/copilot/chat/openai-compatible-chat-language-model.ts +814 -0
  324. package/src/provider/sdk/copilot/chat/openai-compatible-chat-options.ts +28 -0
  325. package/src/provider/sdk/copilot/chat/openai-compatible-metadata-extractor.ts +44 -0
  326. package/src/provider/sdk/copilot/chat/openai-compatible-prepare-tools.ts +83 -0
  327. package/src/provider/sdk/copilot/copilot-provider.ts +100 -0
  328. package/src/provider/sdk/copilot/index.ts +2 -0
  329. package/src/provider/sdk/copilot/openai-compatible-error.ts +27 -0
  330. package/src/provider/sdk/copilot/responses/convert-to-openai-responses-input.ts +335 -0
  331. package/src/provider/sdk/copilot/responses/map-openai-responses-finish-reason.ts +22 -0
  332. package/src/provider/sdk/copilot/responses/openai-config.ts +18 -0
  333. package/src/provider/sdk/copilot/responses/openai-error.ts +22 -0
  334. package/src/provider/sdk/copilot/responses/openai-responses-api-types.ts +214 -0
  335. package/src/provider/sdk/copilot/responses/openai-responses-language-model.ts +1769 -0
  336. package/src/provider/sdk/copilot/responses/openai-responses-prepare-tools.ts +173 -0
  337. package/src/provider/sdk/copilot/responses/openai-responses-settings.ts +1 -0
  338. package/src/provider/sdk/copilot/responses/tool/code-interpreter.ts +87 -0
  339. package/src/provider/sdk/copilot/responses/tool/file-search.ts +127 -0
  340. package/src/provider/sdk/copilot/responses/tool/image-generation.ts +114 -0
  341. package/src/provider/sdk/copilot/responses/tool/local-shell.ts +64 -0
  342. package/src/provider/sdk/copilot/responses/tool/web-search-preview.ts +103 -0
  343. package/src/provider/sdk/copilot/responses/tool/web-search.ts +102 -0
  344. package/src/provider/transform.ts +1124 -0
  345. package/src/pty/index.ts +397 -0
  346. package/src/pty/pty.bun.ts +26 -0
  347. package/src/pty/pty.node.ts +27 -0
  348. package/src/pty/pty.ts +25 -0
  349. package/src/pty/schema.ts +17 -0
  350. package/src/question/index.ts +224 -0
  351. package/src/question/schema.ts +17 -0
  352. package/src/server/error.ts +36 -0
  353. package/src/server/event.ts +7 -0
  354. package/src/server/instance.ts +315 -0
  355. package/src/server/mdns.ts +60 -0
  356. package/src/server/middleware.ts +33 -0
  357. package/src/server/projectors.ts +28 -0
  358. package/src/server/proxy.ts +130 -0
  359. package/src/server/router.ts +105 -0
  360. package/src/server/routes/config.ts +92 -0
  361. package/src/server/routes/event.ts +83 -0
  362. package/src/server/routes/experimental.ts +374 -0
  363. package/src/server/routes/file.ts +197 -0
  364. package/src/server/routes/global.ts +312 -0
  365. package/src/server/routes/mcp.ts +225 -0
  366. package/src/server/routes/permission.ts +69 -0
  367. package/src/server/routes/project.ts +118 -0
  368. package/src/server/routes/provider.ts +171 -0
  369. package/src/server/routes/pty.ts +210 -0
  370. package/src/server/routes/question.ts +99 -0
  371. package/src/server/routes/session.ts +984 -0
  372. package/src/server/routes/tui.ts +378 -0
  373. package/src/server/routes/workspace.ts +94 -0
  374. package/src/server/server.ts +353 -0
  375. package/src/session/compaction.ts +86 -0
  376. package/src/session/index.ts +904 -0
  377. package/src/session/instruction.ts +261 -0
  378. package/src/session/llm/monitor.ts +87 -0
  379. package/src/session/llm.ts +1676 -0
  380. package/src/session/message-v2.ts +1082 -0
  381. package/src/session/message.ts +191 -0
  382. package/src/session/overflow.ts +34 -0
  383. package/src/session/processor.ts +635 -0
  384. package/src/session/projectors.ts +136 -0
  385. package/src/session/prompt/build-switch.txt +5 -0
  386. package/src/session/prompt/builder.ts +135 -0
  387. package/src/session/prompt/default.txt +11 -0
  388. package/src/session/prompt/engine.ts +1072 -0
  389. package/src/session/prompt/gemma4.txt +1 -0
  390. package/src/session/prompt/max-steps.txt +16 -0
  391. package/src/session/prompt/orchestrator.ts +426 -0
  392. package/src/session/prompt/plan.txt +28 -0
  393. package/src/session/prompt/qwen.txt +19 -0
  394. package/src/session/prompt/resolver.ts +670 -0
  395. package/src/session/prompt/router.ts +197 -0
  396. package/src/session/prompt/state.ts +96 -0
  397. package/src/session/prompt/types.ts +115 -0
  398. package/src/session/prompt/utils.ts +15 -0
  399. package/src/session/prompt.ts +362 -0
  400. package/src/session/retry.ts +106 -0
  401. package/src/session/revert.ts +176 -0
  402. package/src/session/sanitizer.ts +125 -0
  403. package/src/session/schema.ts +38 -0
  404. package/src/session/session.sql.ts +106 -0
  405. package/src/session/status.ts +102 -0
  406. package/src/session/summary.ts +183 -0
  407. package/src/session/system.ts +79 -0
  408. package/src/session/todo.ts +166 -0
  409. package/src/session/worker.ts +382 -0
  410. package/src/shell/shell.ts +110 -0
  411. package/src/skill/discovery.ts +116 -0
  412. package/src/skill/index.ts +287 -0
  413. package/src/snapshot/index.ts +726 -0
  414. package/src/sql.d.ts +4 -0
  415. package/src/storage/db.bun.ts +8 -0
  416. package/src/storage/db.node.ts +8 -0
  417. package/src/storage/db.ts +174 -0
  418. package/src/storage/json-migration.ts +387 -0
  419. package/src/storage/schema.sql.ts +10 -0
  420. package/src/storage/schema.ts +4 -0
  421. package/src/storage/storage.ts +353 -0
  422. package/src/sync/README.md +179 -0
  423. package/src/sync/event.sql.ts +16 -0
  424. package/src/sync/index.ts +263 -0
  425. package/src/sync/schema.ts +14 -0
  426. package/src/tool/apply_patch.ts +281 -0
  427. package/src/tool/apply_patch.txt +1 -0
  428. package/src/tool/arbitration.txt +5 -0
  429. package/src/tool/bash.ts +494 -0
  430. package/src/tool/bash.txt +2 -0
  431. package/src/tool/batch.ts +183 -0
  432. package/src/tool/batch.txt +1 -0
  433. package/src/tool/codesearch.ts +132 -0
  434. package/src/tool/codesearch.txt +1 -0
  435. package/src/tool/edit.ts +734 -0
  436. package/src/tool/edit.txt +1 -0
  437. package/src/tool/external-directory.ts +46 -0
  438. package/src/tool/glob.ts +73 -0
  439. package/src/tool/glob.txt +2 -0
  440. package/src/tool/grep.ts +156 -0
  441. package/src/tool/grep.txt +2 -0
  442. package/src/tool/invalid.ts +20 -0
  443. package/src/tool/ls.ts +121 -0
  444. package/src/tool/ls.txt +1 -0
  445. package/src/tool/lsp.ts +97 -0
  446. package/src/tool/lsp.txt +1 -0
  447. package/src/tool/multiedit.ts +46 -0
  448. package/src/tool/multiedit.txt +1 -0
  449. package/src/tool/plan-enter.txt +14 -0
  450. package/src/tool/plan-exit.txt +13 -0
  451. package/src/tool/plan.ts +131 -0
  452. package/src/tool/question.ts +46 -0
  453. package/src/tool/question.txt +10 -0
  454. package/src/tool/read.ts +332 -0
  455. package/src/tool/read.txt +1 -0
  456. package/src/tool/registry.ts +288 -0
  457. package/src/tool/revert.ts +37 -0
  458. package/src/tool/schema.ts +17 -0
  459. package/src/tool/skill.ts +105 -0
  460. package/src/tool/task.ts +150 -0
  461. package/src/tool/task.txt +3 -0
  462. package/src/tool/task_complete.ts +21 -0
  463. package/src/tool/tool.ts +112 -0
  464. package/src/tool/truncate.ts +144 -0
  465. package/src/tool/truncation-dir.ts +4 -0
  466. package/src/tool/webfetch.ts +206 -0
  467. package/src/tool/webfetch.txt +1 -0
  468. package/src/tool/websearch.ts +150 -0
  469. package/src/tool/websearch.txt +1 -0
  470. package/src/tool/write.ts +101 -0
  471. package/src/tool/write.txt +1 -0
  472. package/src/util/abort.ts +35 -0
  473. package/src/util/ai-sdk.ts +59 -0
  474. package/src/util/archive.ts +17 -0
  475. package/src/util/color.ts +19 -0
  476. package/src/util/context.ts +25 -0
  477. package/src/util/data-url.ts +9 -0
  478. package/src/util/defer.ts +12 -0
  479. package/src/util/effect-http-client.ts +11 -0
  480. package/src/util/effect-zod.ts +98 -0
  481. package/src/util/error.ts +77 -0
  482. package/src/util/filesystem.ts +245 -0
  483. package/src/util/flock.ts +333 -0
  484. package/src/util/fn.ts +21 -0
  485. package/src/util/format.ts +20 -0
  486. package/src/util/glob.ts +34 -0
  487. package/src/util/hash.ts +7 -0
  488. package/src/util/iife.ts +3 -0
  489. package/src/util/keybind.ts +103 -0
  490. package/src/util/lazy.ts +23 -0
  491. package/src/util/locale.ts +81 -0
  492. package/src/util/lock.ts +98 -0
  493. package/src/util/log-parser.ts +114 -0
  494. package/src/util/log.ts +250 -0
  495. package/src/util/network.ts +23 -0
  496. package/src/util/process.ts +176 -0
  497. package/src/util/queue.ts +32 -0
  498. package/src/util/record.ts +3 -0
  499. package/src/util/rpc.ts +66 -0
  500. package/src/util/schema.ts +53 -0
  501. package/src/util/scrap.ts +10 -0
  502. package/src/util/session-analyzer.ts +331 -0
  503. package/src/util/session-telemetry.ts +91 -0
  504. package/src/util/signal.ts +12 -0
  505. package/src/util/timeout.ts +14 -0
  506. package/src/util/token.ts +7 -0
  507. package/src/util/tokenizer.ts +50 -0
  508. package/src/util/toon.ts +45 -0
  509. package/src/util/update-schema.ts +13 -0
  510. package/src/util/which.ts +14 -0
  511. package/src/util/wildcard.ts +59 -0
  512. package/src/worktree/index.ts +612 -0
  513. package/sst-env.d.ts +10 -0
  514. package/test/AGENTS.md +81 -0
  515. package/test/account/repo.test.ts +326 -0
  516. package/test/account/service.test.ts +393 -0
  517. package/test/acp/agent-interface.test.ts +51 -0
  518. package/test/acp/event-subscription.test.ts +685 -0
  519. package/test/agent/agent.test.ts +716 -0
  520. package/test/auth/auth.test.ts +58 -0
  521. package/test/bus/bus-effect.test.ts +164 -0
  522. package/test/bus/bus-integration.test.ts +87 -0
  523. package/test/bus/bus.test.ts +219 -0
  524. package/test/cli/account.test.ts +26 -0
  525. package/test/cli/cmd/tui/prompt-part.test.ts +47 -0
  526. package/test/cli/github-action.test.ts +198 -0
  527. package/test/cli/github-remote.test.ts +80 -0
  528. package/test/cli/plugin-auth-picker.test.ts +120 -0
  529. package/test/cli/tui/keybind-plugin.test.ts +90 -0
  530. package/test/cli/tui/plugin-add.test.ts +107 -0
  531. package/test/cli/tui/plugin-install.test.ts +89 -0
  532. package/test/cli/tui/plugin-lifecycle.test.ts +225 -0
  533. package/test/cli/tui/plugin-loader-entrypoint.test.ts +492 -0
  534. package/test/cli/tui/plugin-loader-pure.test.ts +72 -0
  535. package/test/cli/tui/plugin-loader.test.ts +752 -0
  536. package/test/cli/tui/plugin-toggle.test.ts +159 -0
  537. package/test/cli/tui/slot-replace.test.tsx +47 -0
  538. package/test/cli/tui/theme-store.test.ts +51 -0
  539. package/test/cli/tui/thread.test.ts +128 -0
  540. package/test/cli/tui/transcript.test.ts +426 -0
  541. package/test/config/agent-color.test.ts +71 -0
  542. package/test/config/config.test.ts +2337 -0
  543. package/test/config/fixtures/empty-frontmatter.md +4 -0
  544. package/test/config/fixtures/frontmatter.md +28 -0
  545. package/test/config/fixtures/markdown-header.md +11 -0
  546. package/test/config/fixtures/no-frontmatter.md +1 -0
  547. package/test/config/fixtures/weird-model-id.md +13 -0
  548. package/test/config/markdown.test.ts +228 -0
  549. package/test/config/tui.test.ts +800 -0
  550. package/test/control-plane/sse.test.ts +56 -0
  551. package/test/effect/cross-spawn-spawner.test.ts +412 -0
  552. package/test/effect/instance-state.test.ts +482 -0
  553. package/test/effect/run-service.test.ts +46 -0
  554. package/test/effect/runner.test.ts +523 -0
  555. package/test/fake/provider.ts +82 -0
  556. package/test/file/fsmonitor.test.ts +62 -0
  557. package/test/file/ignore.test.ts +10 -0
  558. package/test/file/index.test.ts +946 -0
  559. package/test/file/path-traversal.test.ts +198 -0
  560. package/test/file/ripgrep.test.ts +54 -0
  561. package/test/file/time.test.ts +445 -0
  562. package/test/file/watcher.test.ts +247 -0
  563. package/test/filesystem/filesystem.test.ts +319 -0
  564. package/test/fixture/db.ts +11 -0
  565. package/test/fixture/fixture.test.ts +26 -0
  566. package/test/fixture/fixture.ts +172 -0
  567. package/test/fixture/flock-worker.ts +72 -0
  568. package/test/fixture/lsp/fake-lsp-server.js +77 -0
  569. package/test/fixture/plug-worker.ts +93 -0
  570. package/test/fixture/plugin-meta-worker.ts +26 -0
  571. package/test/fixture/skills/agents-sdk/SKILL.md +152 -0
  572. package/test/fixture/skills/agents-sdk/references/callable.md +92 -0
  573. package/test/fixture/skills/cloudflare/SKILL.md +211 -0
  574. package/test/fixture/skills/index.json +6 -0
  575. package/test/fixture/tui-plugin.ts +328 -0
  576. package/test/fixture/tui-runtime.ts +27 -0
  577. package/test/format/format.test.ts +171 -0
  578. package/test/git/git.test.ts +128 -0
  579. package/test/ide/ide.test.ts +82 -0
  580. package/test/installation/installation.test.ts +152 -0
  581. package/test/keybind.test.ts +421 -0
  582. package/test/lib/effect.ts +53 -0
  583. package/test/lib/filesystem.ts +10 -0
  584. package/test/lib/llm-server.ts +794 -0
  585. package/test/lsp/client.test.ts +95 -0
  586. package/test/lsp/index.test.ts +133 -0
  587. package/test/lsp/launch.test.ts +22 -0
  588. package/test/lsp/lifecycle.test.ts +147 -0
  589. package/test/mcp/headers.test.ts +153 -0
  590. package/test/mcp/lifecycle.test.ts +750 -0
  591. package/test/mcp/oauth-auto-connect.test.ts +199 -0
  592. package/test/mcp/oauth-browser.test.ts +249 -0
  593. package/test/mcp/sc-approve-validator.test.ts +431 -0
  594. package/test/memory/abort-leak.test.ts +137 -0
  595. package/test/npm.test.ts +18 -0
  596. package/test/patch/patch.test.ts +348 -0
  597. package/test/permission/arity.test.ts +33 -0
  598. package/test/permission/next.test.ts +1123 -0
  599. package/test/permission-task.test.ts +323 -0
  600. package/test/plugin/auth-override.test.ts +74 -0
  601. package/test/plugin/codex.test.ts +123 -0
  602. package/test/plugin/github-copilot-models.test.ts +117 -0
  603. package/test/plugin/install-concurrency.test.ts +140 -0
  604. package/test/plugin/install.test.ts +570 -0
  605. package/test/plugin/loader-shared.test.ts +1136 -0
  606. package/test/plugin/meta.test.ts +137 -0
  607. package/test/plugin/shared.test.ts +88 -0
  608. package/test/plugin/trigger.test.ts +111 -0
  609. package/test/preload.ts +90 -0
  610. package/test/project/migrate-global.test.ts +140 -0
  611. package/test/project/project.test.ts +459 -0
  612. package/test/project/state.test.ts +115 -0
  613. package/test/project/vcs.test.ts +228 -0
  614. package/test/project/worktree-remove.test.ts +96 -0
  615. package/test/project/worktree.test.ts +173 -0
  616. package/test/provider/amazon-bedrock.test.ts +447 -0
  617. package/test/provider/copilot/convert-to-copilot-messages.test.ts +523 -0
  618. package/test/provider/copilot/copilot-chat-model.test.ts +592 -0
  619. package/test/provider/error.test.ts +49 -0
  620. package/test/provider/gitlab-duo.test.ts +412 -0
  621. package/test/provider/provider.test.ts +2494 -0
  622. package/test/provider/transform.test.ts +2944 -0
  623. package/test/pty/pty-output-isolation.test.ts +141 -0
  624. package/test/pty/pty-session.test.ts +92 -0
  625. package/test/pty/pty-shell.test.ts +59 -0
  626. package/test/question/question.test.ts +453 -0
  627. package/test/server/global-session-list.test.ts +89 -0
  628. package/test/server/project-init-git.test.ts +121 -0
  629. package/test/server/session-actions.test.ts +83 -0
  630. package/test/server/session-list.test.ts +98 -0
  631. package/test/server/session-messages.test.ts +159 -0
  632. package/test/server/session-select.test.ts +84 -0
  633. package/test/session/compaction.test.ts +683 -0
  634. package/test/session/continuity-handover.test.ts +620 -0
  635. package/test/session/deterministic-handover.test.ts +328 -0
  636. package/test/session/doom-protection.test.ts +247 -0
  637. package/test/session/hard-reset.test.ts +179 -0
  638. package/test/session/instruction.test.ts +286 -0
  639. package/test/session/llm/monitor.test.ts +53 -0
  640. package/test/session/llm-sanitizer.test.ts +90 -0
  641. package/test/session/llm-zones-e2e.test.ts +61 -0
  642. package/test/session/llm.test.ts +1308 -0
  643. package/test/session/mcpx-normalization.test.ts +86 -0
  644. package/test/session/mcpx-syntax-recovery.test.ts +28 -0
  645. package/test/session/message-v2.test.ts +957 -0
  646. package/test/session/messages-pagination.test.ts +885 -0
  647. package/test/session/processor-effect.test.ts +805 -0
  648. package/test/session/prompt/builder.test.ts +71 -0
  649. package/test/session/prompt/engine-loop.test.ts +80 -0
  650. package/test/session/prompt/orchestrator.test.ts +108 -0
  651. package/test/session/prompt/resolver.test.ts +211 -0
  652. package/test/session/prompt/router.test.ts +84 -0
  653. package/test/session/prompt/state.test.ts +57 -0
  654. package/test/session/prompt-effect.test.ts +1241 -0
  655. package/test/session/prompt.test.ts +522 -0
  656. package/test/session/refactor-system-zones.test.ts +241 -0
  657. package/test/session/retry.test.ts +232 -0
  658. package/test/session/revert-compact.test.ts +621 -0
  659. package/test/session/sanitizer.test.ts +61 -0
  660. package/test/session/session.test.ts +142 -0
  661. package/test/session/snapshot-tool-race.test.ts +242 -0
  662. package/test/session/structured-output-integration.test.ts +233 -0
  663. package/test/session/structured-output.test.ts +391 -0
  664. package/test/session/system.test.ts +59 -0
  665. package/test/session/telemetry.test.ts +35 -0
  666. package/test/shell/shell.test.ts +73 -0
  667. package/test/skill/discovery.test.ts +116 -0
  668. package/test/skill/skill.test.ts +392 -0
  669. package/test/snapshot/snapshot.test.ts +1404 -0
  670. package/test/storage/db.test.ts +14 -0
  671. package/test/storage/json-migration.test.ts +791 -0
  672. package/test/storage/storage.test.ts +295 -0
  673. package/test/sync/index.test.ts +191 -0
  674. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  675. package/test/tool/apply_patch.test.ts +567 -0
  676. package/test/tool/bash.test.ts +1099 -0
  677. package/test/tool/edit.test.ts +681 -0
  678. package/test/tool/external-directory.test.ts +198 -0
  679. package/test/tool/fixtures/large-image.png +0 -0
  680. package/test/tool/fixtures/models-api.json +65179 -0
  681. package/test/tool/grep.test.ts +111 -0
  682. package/test/tool/question.test.ts +126 -0
  683. package/test/tool/read.test.ts +468 -0
  684. package/test/tool/registry.test.ts +126 -0
  685. package/test/tool/skill.test.ts +167 -0
  686. package/test/tool/task.test.ts +49 -0
  687. package/test/tool/tool-define.test.ts +101 -0
  688. package/test/tool/truncation.test.ts +161 -0
  689. package/test/tool/webfetch.test.ts +101 -0
  690. package/test/tool/write.test.ts +354 -0
  691. package/test/util/data-url.test.ts +14 -0
  692. package/test/util/effect-zod.test.ts +61 -0
  693. package/test/util/error.test.ts +38 -0
  694. package/test/util/filesystem.test.ts +656 -0
  695. package/test/util/flock.test.ts +383 -0
  696. package/test/util/format.test.ts +59 -0
  697. package/test/util/glob.test.ts +164 -0
  698. package/test/util/iife.test.ts +36 -0
  699. package/test/util/lazy.test.ts +50 -0
  700. package/test/util/lock.test.ts +72 -0
  701. package/test/util/log-parser.test.ts +61 -0
  702. package/test/util/module.test.ts +59 -0
  703. package/test/util/process.test.ts +128 -0
  704. package/test/util/telemetry-integration.test.ts +104 -0
  705. package/test/util/timeout.test.ts +21 -0
  706. package/test/util/which.test.ts +100 -0
  707. package/test/util/wildcard.test.ts +90 -0
  708. package/test-regex.js +50 -0
  709. package/tsconfig.json +23 -0
  710. package/LICENSE +0 -21
  711. /package/{postinstall.mjs → script/postinstall.mjs} +0 -0
@@ -0,0 +1,1123 @@
1
+ import { afterEach, test, expect } from "bun:test"
2
+ import os from "os"
3
+ import { Bus } from "../../src/bus"
4
+ import { Permission } from "../../src/permission"
5
+ import { PermissionID } from "../../src/permission/schema"
6
+ import { Instance } from "../../src/project/instance"
7
+ import { tmpdir } from "../fixture/fixture"
8
+ import { MessageID, SessionID } from "../../src/session/schema"
9
+
10
+ afterEach(async () => {
11
+ await Instance.disposeAll()
12
+ })
13
+
14
+ async function rejectAll(message?: string) {
15
+ for (const req of await Permission.list()) {
16
+ await Permission.reply({
17
+ requestID: req.id,
18
+ reply: "reject",
19
+ message,
20
+ })
21
+ }
22
+ }
23
+
24
+ async function waitForPending(count: number) {
25
+ for (let i = 0; i < 20; i++) {
26
+ const list = await Permission.list()
27
+ if (list.length === count) return list
28
+ await Bun.sleep(0)
29
+ }
30
+ return Permission.list()
31
+ }
32
+
33
+ // fromConfig tests
34
+
35
+ test("fromConfig - string value becomes wildcard rule", () => {
36
+ const result = Permission.fromConfig({ bash: "allow" })
37
+ expect(result).toEqual([{ permission: "bash", pattern: "*", action: "allow" }])
38
+ })
39
+
40
+ test("fromConfig - object value converts to rules array", () => {
41
+ const result = Permission.fromConfig({ bash: { "*": "allow", rm: "deny" } })
42
+ expect(result).toEqual([
43
+ { permission: "bash", pattern: "*", action: "allow" },
44
+ { permission: "bash", pattern: "rm", action: "deny" },
45
+ ])
46
+ })
47
+
48
+ test("fromConfig - mixed string and object values", () => {
49
+ const result = Permission.fromConfig({
50
+ bash: { "*": "allow", rm: "deny" },
51
+ edit: "allow",
52
+ webfetch: "ask",
53
+ })
54
+ expect(result).toEqual([
55
+ { permission: "bash", pattern: "*", action: "allow" },
56
+ { permission: "bash", pattern: "rm", action: "deny" },
57
+ { permission: "edit", pattern: "*", action: "allow" },
58
+ { permission: "webfetch", pattern: "*", action: "ask" },
59
+ ])
60
+ })
61
+
62
+ test("fromConfig - empty object", () => {
63
+ const result = Permission.fromConfig({})
64
+ expect(result).toEqual([])
65
+ })
66
+
67
+ test("fromConfig - expands tilde to home directory", () => {
68
+ const result = Permission.fromConfig({ external_directory: { "~/projects/*": "allow" } })
69
+ expect(result).toEqual([{ permission: "external_directory", pattern: `${os.homedir()}/projects/*`, action: "allow" }])
70
+ })
71
+
72
+ test("fromConfig - expands $HOME to home directory", () => {
73
+ const result = Permission.fromConfig({ external_directory: { "$HOME/projects/*": "allow" } })
74
+ expect(result).toEqual([{ permission: "external_directory", pattern: `${os.homedir()}/projects/*`, action: "allow" }])
75
+ })
76
+
77
+ test("fromConfig - expands $HOME without trailing slash", () => {
78
+ const result = Permission.fromConfig({ external_directory: { $HOME: "allow" } })
79
+ expect(result).toEqual([{ permission: "external_directory", pattern: os.homedir(), action: "allow" }])
80
+ })
81
+
82
+ test("fromConfig - does not expand tilde in middle of path", () => {
83
+ const result = Permission.fromConfig({ external_directory: { "/some/~/path": "allow" } })
84
+ expect(result).toEqual([{ permission: "external_directory", pattern: "/some/~/path", action: "allow" }])
85
+ })
86
+
87
+ test("fromConfig - expands exact tilde to home directory", () => {
88
+ const result = Permission.fromConfig({ external_directory: { "~": "allow" } })
89
+ expect(result).toEqual([{ permission: "external_directory", pattern: os.homedir(), action: "allow" }])
90
+ })
91
+
92
+ test("evaluate - matches expanded tilde pattern", () => {
93
+ const ruleset = Permission.fromConfig({ external_directory: { "~/projects/*": "allow" } })
94
+ const result = Permission.evaluate("external_directory", `${os.homedir()}/projects/file.txt`, ruleset)
95
+ expect(result.action).toBe("allow")
96
+ })
97
+
98
+ test("evaluate - matches expanded $HOME pattern", () => {
99
+ const ruleset = Permission.fromConfig({ external_directory: { "$HOME/projects/*": "allow" } })
100
+ const result = Permission.evaluate("external_directory", `${os.homedir()}/projects/file.txt`, ruleset)
101
+ expect(result.action).toBe("allow")
102
+ })
103
+
104
+ // merge tests
105
+
106
+ test("merge - simple concatenation", () => {
107
+ const result = Permission.merge(
108
+ [{ permission: "bash", pattern: "*", action: "allow" }],
109
+ [{ permission: "bash", pattern: "*", action: "deny" }],
110
+ )
111
+ expect(result).toEqual([
112
+ { permission: "bash", pattern: "*", action: "allow" },
113
+ { permission: "bash", pattern: "*", action: "deny" },
114
+ ])
115
+ })
116
+
117
+ test("merge - adds new permission", () => {
118
+ const result = Permission.merge(
119
+ [{ permission: "bash", pattern: "*", action: "allow" }],
120
+ [{ permission: "edit", pattern: "*", action: "deny" }],
121
+ )
122
+ expect(result).toEqual([
123
+ { permission: "bash", pattern: "*", action: "allow" },
124
+ { permission: "edit", pattern: "*", action: "deny" },
125
+ ])
126
+ })
127
+
128
+ test("merge - concatenates rules for same permission", () => {
129
+ const result = Permission.merge(
130
+ [{ permission: "bash", pattern: "foo", action: "ask" }],
131
+ [{ permission: "bash", pattern: "*", action: "deny" }],
132
+ )
133
+ expect(result).toEqual([
134
+ { permission: "bash", pattern: "foo", action: "ask" },
135
+ { permission: "bash", pattern: "*", action: "deny" },
136
+ ])
137
+ })
138
+
139
+ test("merge - multiple rulesets", () => {
140
+ const result = Permission.merge(
141
+ [{ permission: "bash", pattern: "*", action: "allow" }],
142
+ [{ permission: "bash", pattern: "rm", action: "ask" }],
143
+ [{ permission: "edit", pattern: "*", action: "allow" }],
144
+ )
145
+ expect(result).toEqual([
146
+ { permission: "bash", pattern: "*", action: "allow" },
147
+ { permission: "bash", pattern: "rm", action: "ask" },
148
+ { permission: "edit", pattern: "*", action: "allow" },
149
+ ])
150
+ })
151
+
152
+ test("merge - empty ruleset does nothing", () => {
153
+ const result = Permission.merge([{ permission: "bash", pattern: "*", action: "allow" }], [])
154
+ expect(result).toEqual([{ permission: "bash", pattern: "*", action: "allow" }])
155
+ })
156
+
157
+ test("merge - preserves rule order", () => {
158
+ const result = Permission.merge(
159
+ [
160
+ { permission: "edit", pattern: "src/*", action: "allow" },
161
+ { permission: "edit", pattern: "src/secret/*", action: "deny" },
162
+ ],
163
+ [{ permission: "edit", pattern: "src/secret/ok.ts", action: "allow" }],
164
+ )
165
+ expect(result).toEqual([
166
+ { permission: "edit", pattern: "src/*", action: "allow" },
167
+ { permission: "edit", pattern: "src/secret/*", action: "deny" },
168
+ { permission: "edit", pattern: "src/secret/ok.ts", action: "allow" },
169
+ ])
170
+ })
171
+
172
+ test("merge - config permission overrides default ask", () => {
173
+ // Simulates: defaults have "*": "ask", config sets bash: "allow"
174
+ const defaults: Permission.Ruleset = [{ permission: "*", pattern: "*", action: "ask" }]
175
+ const config: Permission.Ruleset = [{ permission: "bash", pattern: "*", action: "allow" }]
176
+ const merged = Permission.merge(defaults, config)
177
+
178
+ // Config's bash allow should override default ask
179
+ expect(Permission.evaluate("bash", "ls", merged).action).toBe("allow")
180
+ // Other permissions should still be ask (from defaults)
181
+ expect(Permission.evaluate("edit", "foo.ts", merged).action).toBe("ask")
182
+ })
183
+
184
+ test("merge - config ask overrides default allow", () => {
185
+ // Simulates: defaults have bash: "allow", config sets bash: "ask"
186
+ const defaults: Permission.Ruleset = [{ permission: "bash", pattern: "*", action: "allow" }]
187
+ const config: Permission.Ruleset = [{ permission: "bash", pattern: "*", action: "ask" }]
188
+ const merged = Permission.merge(defaults, config)
189
+
190
+ // Config's ask should override default allow
191
+ expect(Permission.evaluate("bash", "ls", merged).action).toBe("ask")
192
+ })
193
+
194
+ // evaluate tests
195
+
196
+ test("evaluate - exact pattern match", () => {
197
+ const result = Permission.evaluate("bash", "rm", [{ permission: "bash", pattern: "rm", action: "deny" }])
198
+ expect(result.action).toBe("deny")
199
+ })
200
+
201
+ test("evaluate - wildcard pattern match", () => {
202
+ const result = Permission.evaluate("bash", "rm", [{ permission: "bash", pattern: "*", action: "allow" }])
203
+ expect(result.action).toBe("allow")
204
+ })
205
+
206
+ test("evaluate - last matching rule wins", () => {
207
+ const result = Permission.evaluate("bash", "rm", [
208
+ { permission: "bash", pattern: "*", action: "allow" },
209
+ { permission: "bash", pattern: "rm", action: "deny" },
210
+ ])
211
+ expect(result.action).toBe("deny")
212
+ })
213
+
214
+ test("evaluate - last matching rule wins (wildcard after specific)", () => {
215
+ const result = Permission.evaluate("bash", "rm", [
216
+ { permission: "bash", pattern: "rm", action: "deny" },
217
+ { permission: "bash", pattern: "*", action: "allow" },
218
+ ])
219
+ expect(result.action).toBe("allow")
220
+ })
221
+
222
+ test("evaluate - glob pattern match", () => {
223
+ const result = Permission.evaluate("edit", "src/foo.ts", [{ permission: "edit", pattern: "src/*", action: "allow" }])
224
+ expect(result.action).toBe("allow")
225
+ })
226
+
227
+ test("evaluate - last matching glob wins", () => {
228
+ const result = Permission.evaluate("edit", "src/components/Button.tsx", [
229
+ { permission: "edit", pattern: "src/*", action: "deny" },
230
+ { permission: "edit", pattern: "src/components/*", action: "allow" },
231
+ ])
232
+ expect(result.action).toBe("allow")
233
+ })
234
+
235
+ test("evaluate - order matters for specificity", () => {
236
+ // If more specific rule comes first, later wildcard overrides it
237
+ const result = Permission.evaluate("edit", "src/components/Button.tsx", [
238
+ { permission: "edit", pattern: "src/components/*", action: "allow" },
239
+ { permission: "edit", pattern: "src/*", action: "deny" },
240
+ ])
241
+ expect(result.action).toBe("deny")
242
+ })
243
+
244
+ test("evaluate - unknown permission returns ask", () => {
245
+ const result = Permission.evaluate("unknown_tool", "anything", [
246
+ { permission: "bash", pattern: "*", action: "allow" },
247
+ ])
248
+ expect(result.action).toBe("ask")
249
+ })
250
+
251
+ test("evaluate - empty ruleset returns ask", () => {
252
+ const result = Permission.evaluate("bash", "rm", [])
253
+ expect(result.action).toBe("ask")
254
+ })
255
+
256
+ test("evaluate - no matching pattern returns ask", () => {
257
+ const result = Permission.evaluate("edit", "etc/passwd", [{ permission: "edit", pattern: "src/*", action: "allow" }])
258
+ expect(result.action).toBe("ask")
259
+ })
260
+
261
+ test("evaluate - empty rules array returns ask", () => {
262
+ const result = Permission.evaluate("bash", "rm", [])
263
+ expect(result.action).toBe("ask")
264
+ })
265
+
266
+ test("evaluate - multiple matching patterns, last wins", () => {
267
+ const result = Permission.evaluate("edit", "src/secret.ts", [
268
+ { permission: "edit", pattern: "*", action: "ask" },
269
+ { permission: "edit", pattern: "src/*", action: "allow" },
270
+ { permission: "edit", pattern: "src/secret.ts", action: "deny" },
271
+ ])
272
+ expect(result.action).toBe("deny")
273
+ })
274
+
275
+ test("evaluate - non-matching patterns are skipped", () => {
276
+ const result = Permission.evaluate("edit", "src/foo.ts", [
277
+ { permission: "edit", pattern: "*", action: "ask" },
278
+ { permission: "edit", pattern: "test/*", action: "deny" },
279
+ { permission: "edit", pattern: "src/*", action: "allow" },
280
+ ])
281
+ expect(result.action).toBe("allow")
282
+ })
283
+
284
+ test("evaluate - exact match at end wins over earlier wildcard", () => {
285
+ const result = Permission.evaluate("bash", "/bin/rm", [
286
+ { permission: "bash", pattern: "*", action: "allow" },
287
+ { permission: "bash", pattern: "/bin/rm", action: "deny" },
288
+ ])
289
+ expect(result.action).toBe("deny")
290
+ })
291
+
292
+ test("evaluate - wildcard at end overrides earlier exact match", () => {
293
+ const result = Permission.evaluate("bash", "/bin/rm", [
294
+ { permission: "bash", pattern: "/bin/rm", action: "deny" },
295
+ { permission: "bash", pattern: "*", action: "allow" },
296
+ ])
297
+ expect(result.action).toBe("allow")
298
+ })
299
+
300
+ // wildcard permission tests
301
+
302
+ test("evaluate - wildcard permission matches any permission", () => {
303
+ const result = Permission.evaluate("bash", "rm", [{ permission: "*", pattern: "*", action: "deny" }])
304
+ expect(result.action).toBe("deny")
305
+ })
306
+
307
+ test("evaluate - wildcard permission with specific pattern", () => {
308
+ const result = Permission.evaluate("bash", "rm", [{ permission: "*", pattern: "rm", action: "deny" }])
309
+ expect(result.action).toBe("deny")
310
+ })
311
+
312
+ test("evaluate - glob permission pattern", () => {
313
+ const result = Permission.evaluate("mcp_server_tool", "anything", [
314
+ { permission: "mcp_*", pattern: "*", action: "allow" },
315
+ ])
316
+ expect(result.action).toBe("allow")
317
+ })
318
+
319
+ test("evaluate - specific permission and wildcard permission combined", () => {
320
+ const result = Permission.evaluate("bash", "rm", [
321
+ { permission: "*", pattern: "*", action: "deny" },
322
+ { permission: "bash", pattern: "*", action: "allow" },
323
+ ])
324
+ expect(result.action).toBe("allow")
325
+ })
326
+
327
+ test("evaluate - wildcard permission does not match when specific exists", () => {
328
+ const result = Permission.evaluate("edit", "src/foo.ts", [
329
+ { permission: "*", pattern: "*", action: "deny" },
330
+ { permission: "edit", pattern: "src/*", action: "allow" },
331
+ ])
332
+ expect(result.action).toBe("allow")
333
+ })
334
+
335
+ test("evaluate - multiple matching permission patterns combine rules", () => {
336
+ const result = Permission.evaluate("mcp_dangerous", "anything", [
337
+ { permission: "*", pattern: "*", action: "ask" },
338
+ { permission: "mcp_*", pattern: "*", action: "allow" },
339
+ { permission: "mcp_dangerous", pattern: "*", action: "deny" },
340
+ ])
341
+ expect(result.action).toBe("deny")
342
+ })
343
+
344
+ test("evaluate - wildcard permission fallback for unknown tool", () => {
345
+ const result = Permission.evaluate("unknown_tool", "anything", [
346
+ { permission: "*", pattern: "*", action: "ask" },
347
+ { permission: "bash", pattern: "*", action: "allow" },
348
+ ])
349
+ expect(result.action).toBe("ask")
350
+ })
351
+
352
+ test("evaluate - permission patterns sorted by length regardless of object order", () => {
353
+ // specific permission listed before wildcard, but specific should still win
354
+ const result = Permission.evaluate("bash", "rm", [
355
+ { permission: "bash", pattern: "*", action: "allow" },
356
+ { permission: "*", pattern: "*", action: "deny" },
357
+ ])
358
+ // With flat list, last matching rule wins - so "*" matches bash and wins
359
+ expect(result.action).toBe("deny")
360
+ })
361
+
362
+ test("evaluate - merges multiple rulesets", () => {
363
+ const config: Permission.Ruleset = [{ permission: "bash", pattern: "*", action: "allow" }]
364
+ const approved: Permission.Ruleset = [{ permission: "bash", pattern: "rm", action: "deny" }]
365
+ // approved comes after config, so rm should be denied
366
+ const result = Permission.evaluate("bash", "rm", config, approved)
367
+ expect(result.action).toBe("deny")
368
+ })
369
+
370
+ // disabled tests
371
+
372
+ test("disabled - returns empty set when all tools allowed", () => {
373
+ const result = Permission.disabled(["bash", "edit", "read"], [{ permission: "*", pattern: "*", action: "allow" }])
374
+ expect(result.size).toBe(0)
375
+ })
376
+
377
+ test("disabled - disables tool when denied", () => {
378
+ const result = Permission.disabled(
379
+ ["bash", "edit", "read"],
380
+ [
381
+ { permission: "*", pattern: "*", action: "allow" },
382
+ { permission: "bash", pattern: "*", action: "deny" },
383
+ ],
384
+ )
385
+ expect(result.has("bash")).toBe(true)
386
+ expect(result.has("edit")).toBe(false)
387
+ expect(result.has("read")).toBe(false)
388
+ })
389
+
390
+ test("disabled - disables edit/write/apply_patch/multiedit when edit denied", () => {
391
+ const result = Permission.disabled(
392
+ ["edit", "write", "apply_patch", "multiedit", "bash"],
393
+ [
394
+ { permission: "*", pattern: "*", action: "allow" },
395
+ { permission: "edit", pattern: "*", action: "deny" },
396
+ ],
397
+ )
398
+ expect(result.has("edit")).toBe(true)
399
+ expect(result.has("write")).toBe(true)
400
+ expect(result.has("apply_patch")).toBe(true)
401
+ expect(result.has("multiedit")).toBe(true)
402
+ expect(result.has("bash")).toBe(false)
403
+ })
404
+
405
+ test("disabled - does not disable when partially denied", () => {
406
+ const result = Permission.disabled(
407
+ ["bash"],
408
+ [
409
+ { permission: "bash", pattern: "*", action: "allow" },
410
+ { permission: "bash", pattern: "rm *", action: "deny" },
411
+ ],
412
+ )
413
+ expect(result.has("bash")).toBe(false)
414
+ })
415
+
416
+ test("disabled - does not disable when action is ask", () => {
417
+ const result = Permission.disabled(["bash", "edit"], [{ permission: "*", pattern: "*", action: "ask" }])
418
+ expect(result.size).toBe(0)
419
+ })
420
+
421
+ test("disabled - does not disable when specific allow after wildcard deny", () => {
422
+ // Tool is NOT disabled because a specific allow after wildcard deny means
423
+ // there's at least some usage allowed
424
+ const result = Permission.disabled(
425
+ ["bash"],
426
+ [
427
+ { permission: "bash", pattern: "*", action: "deny" },
428
+ { permission: "bash", pattern: "echo *", action: "allow" },
429
+ ],
430
+ )
431
+ expect(result.has("bash")).toBe(false)
432
+ })
433
+
434
+ test("disabled - does not disable when wildcard allow after deny", () => {
435
+ const result = Permission.disabled(
436
+ ["bash"],
437
+ [
438
+ { permission: "bash", pattern: "rm *", action: "deny" },
439
+ { permission: "bash", pattern: "*", action: "allow" },
440
+ ],
441
+ )
442
+ expect(result.has("bash")).toBe(false)
443
+ })
444
+
445
+ test("disabled - disables multiple tools", () => {
446
+ const result = Permission.disabled(
447
+ ["bash", "edit", "webfetch"],
448
+ [
449
+ { permission: "bash", pattern: "*", action: "deny" },
450
+ { permission: "edit", pattern: "*", action: "deny" },
451
+ { permission: "webfetch", pattern: "*", action: "deny" },
452
+ ],
453
+ )
454
+ expect(result.has("bash")).toBe(true)
455
+ expect(result.has("edit")).toBe(true)
456
+ expect(result.has("webfetch")).toBe(true)
457
+ })
458
+
459
+ test("disabled - wildcard permission denies all tools", () => {
460
+ const result = Permission.disabled(["bash", "edit", "read"], [{ permission: "*", pattern: "*", action: "deny" }])
461
+ expect(result.has("bash")).toBe(true)
462
+ expect(result.has("edit")).toBe(true)
463
+ expect(result.has("read")).toBe(true)
464
+ })
465
+
466
+ test("disabled - specific allow overrides wildcard deny", () => {
467
+ const result = Permission.disabled(
468
+ ["bash", "edit", "read"],
469
+ [
470
+ { permission: "*", pattern: "*", action: "deny" },
471
+ { permission: "bash", pattern: "*", action: "allow" },
472
+ ],
473
+ )
474
+ expect(result.has("bash")).toBe(false)
475
+ expect(result.has("edit")).toBe(true)
476
+ expect(result.has("read")).toBe(true)
477
+ })
478
+
479
+ // ask tests
480
+
481
+ test("ask - resolves immediately when action is allow", async () => {
482
+ await using tmp = await tmpdir({ git: true })
483
+ await Instance.provide({
484
+ directory: tmp.path,
485
+ fn: async () => {
486
+ const result = await Permission.ask({
487
+ sessionID: SessionID.make("session_test"),
488
+ permission: "bash",
489
+ patterns: ["ls"],
490
+ metadata: {},
491
+ always: []
492
+ }, [{ permission: "bash", pattern: "*", action: "allow" }])
493
+ expect(result).toBeUndefined()
494
+ },
495
+ })
496
+ })
497
+
498
+ test("ask - throws RejectedError when action is deny", async () => {
499
+ await using tmp = await tmpdir({ git: true })
500
+ await Instance.provide({
501
+ directory: tmp.path,
502
+ fn: async () => {
503
+ await expect(
504
+ Permission.ask({
505
+ sessionID: SessionID.make("session_test"),
506
+ permission: "bash",
507
+ patterns: ["rm -rf /"],
508
+ metadata: {},
509
+ always: []
510
+ }, [{ permission: "bash", pattern: "*", action: "deny" }]),
511
+ ).rejects.toBeInstanceOf(Permission.DeniedError)
512
+ },
513
+ })
514
+ })
515
+
516
+ test("ask - returns pending promise when action is ask", async () => {
517
+ await using tmp = await tmpdir({ git: true })
518
+ await Instance.provide({
519
+ directory: tmp.path,
520
+ fn: async () => {
521
+ const promise = Permission.ask({
522
+ sessionID: SessionID.make("session_test"),
523
+ permission: "bash",
524
+ patterns: ["ls"],
525
+ metadata: {},
526
+ always: []
527
+ }, [{ permission: "bash", pattern: "*", action: "ask" }])
528
+ // Promise should be pending, not resolved
529
+ expect(promise).toBeInstanceOf(Promise)
530
+ // Don't await - just verify it returns a promise
531
+ await rejectAll()
532
+ await promise.catch(() => {})
533
+ },
534
+ })
535
+ })
536
+
537
+ test("ask - adds request to pending list", async () => {
538
+ await using tmp = await tmpdir({ git: true })
539
+ await Instance.provide({
540
+ directory: tmp.path,
541
+ fn: async () => {
542
+ const ask = Permission.ask({
543
+ sessionID: SessionID.make("session_test"),
544
+ permission: "bash",
545
+ patterns: ["ls"],
546
+ metadata: { cmd: "ls" },
547
+ always: ["ls"],
548
+ tool: {
549
+ messageID: MessageID.make("msg_test"),
550
+ callID: "call_test",
551
+ }
552
+ }, [])
553
+
554
+ const list = await Permission.list()
555
+ expect(list).toHaveLength(1)
556
+ expect(list[0]).toMatchObject({
557
+ sessionID: SessionID.make("session_test"),
558
+ permission: "bash",
559
+ patterns: ["ls"],
560
+ metadata: { cmd: "ls" },
561
+ always: ["ls"],
562
+ tool: {
563
+ messageID: MessageID.make("msg_test"),
564
+ callID: "call_test",
565
+ },
566
+ })
567
+
568
+ await rejectAll()
569
+ await ask.catch(() => {})
570
+ },
571
+ })
572
+ })
573
+
574
+ test("ask - publishes asked event", async () => {
575
+ await using tmp = await tmpdir({ git: true })
576
+ await Instance.provide({
577
+ directory: tmp.path,
578
+ fn: async () => {
579
+ let seen: Permission.Request | undefined
580
+ const unsub = Bus.subscribe(Permission.Event.Asked, (event) => {
581
+ seen = event.properties
582
+ })
583
+
584
+ const ask = Permission.ask({
585
+ sessionID: SessionID.make("session_test"),
586
+ permission: "bash",
587
+ patterns: ["ls"],
588
+ metadata: { cmd: "ls" },
589
+ always: ["ls"],
590
+ tool: {
591
+ messageID: MessageID.make("msg_test"),
592
+ callID: "call_test",
593
+ }
594
+ }, [])
595
+
596
+ expect(await Permission.list()).toHaveLength(1)
597
+ expect(seen).toBeDefined()
598
+ expect(seen).toMatchObject({
599
+ sessionID: SessionID.make("session_test"),
600
+ permission: "bash",
601
+ patterns: ["ls"],
602
+ })
603
+
604
+ unsub()
605
+ await rejectAll()
606
+ await ask.catch(() => {})
607
+ },
608
+ })
609
+ })
610
+
611
+ // reply tests
612
+
613
+ test("reply - once resolves the pending ask", async () => {
614
+ await using tmp = await tmpdir({ git: true })
615
+ await Instance.provide({
616
+ directory: tmp.path,
617
+ fn: async () => {
618
+ const askPromise = Permission.ask({
619
+ id: PermissionID.make("per_test1"),
620
+ sessionID: SessionID.make("session_test"),
621
+ permission: "bash",
622
+ patterns: ["ls"],
623
+ metadata: {},
624
+ always: []
625
+ }, [])
626
+
627
+ await waitForPending(1)
628
+
629
+ await Permission.reply({
630
+ requestID: PermissionID.make("per_test1"),
631
+ reply: "once",
632
+ })
633
+
634
+ await expect(askPromise).resolves.toBeUndefined()
635
+ },
636
+ })
637
+ })
638
+
639
+ test("reply - reject throws RejectedError", async () => {
640
+ await using tmp = await tmpdir({ git: true })
641
+ await Instance.provide({
642
+ directory: tmp.path,
643
+ fn: async () => {
644
+ const askPromise = Permission.ask({
645
+ id: PermissionID.make("per_test2"),
646
+ sessionID: SessionID.make("session_test"),
647
+ permission: "bash",
648
+ patterns: ["ls"],
649
+ metadata: {},
650
+ always: []
651
+ }, [])
652
+
653
+ await waitForPending(1)
654
+
655
+ await Permission.reply({
656
+ requestID: PermissionID.make("per_test2"),
657
+ reply: "reject",
658
+ })
659
+
660
+ await expect(askPromise).rejects.toBeInstanceOf(Permission.RejectedError)
661
+ },
662
+ })
663
+ })
664
+
665
+ test("reply - reject with message throws CorrectedError", async () => {
666
+ await using tmp = await tmpdir({ git: true })
667
+ await Instance.provide({
668
+ directory: tmp.path,
669
+ fn: async () => {
670
+ const ask = Permission.ask({
671
+ id: PermissionID.make("per_test2b"),
672
+ sessionID: SessionID.make("session_test"),
673
+ permission: "bash",
674
+ patterns: ["ls"],
675
+ metadata: {},
676
+ always: []
677
+ }, [])
678
+
679
+ await waitForPending(1)
680
+
681
+ await Permission.reply({
682
+ requestID: PermissionID.make("per_test2b"),
683
+ reply: "reject",
684
+ message: "Use a safer command",
685
+ })
686
+
687
+ const err = await ask.catch((err) => err)
688
+ expect(err).toBeInstanceOf(Permission.CorrectedError)
689
+ expect(err.message).toContain("Use a safer command")
690
+ },
691
+ })
692
+ })
693
+
694
+ test("reply - always persists approval and resolves", async () => {
695
+ await using tmp = await tmpdir({ git: true })
696
+ await Instance.provide({
697
+ directory: tmp.path,
698
+ fn: async () => {
699
+ const askPromise = Permission.ask({
700
+ id: PermissionID.make("per_test3"),
701
+ sessionID: SessionID.make("session_test"),
702
+ permission: "bash",
703
+ patterns: ["ls"],
704
+ metadata: {},
705
+ always: ["ls"]
706
+ }, [])
707
+
708
+ await waitForPending(1)
709
+
710
+ await Permission.reply({
711
+ requestID: PermissionID.make("per_test3"),
712
+ reply: "always",
713
+ })
714
+
715
+ await expect(askPromise).resolves.toBeUndefined()
716
+ },
717
+ })
718
+ // Re-provide to reload state with stored permissions
719
+ await Instance.provide({
720
+ directory: tmp.path,
721
+ fn: async () => {
722
+ // Stored approval should allow without asking
723
+ const result = await Permission.ask({
724
+ sessionID: SessionID.make("session_test2"),
725
+ permission: "bash",
726
+ patterns: ["ls"],
727
+ metadata: {},
728
+ always: []
729
+ }, [])
730
+ expect(result).toBeUndefined()
731
+ },
732
+ })
733
+ })
734
+
735
+ test("reply - reject cancels all pending for same session", async () => {
736
+ await using tmp = await tmpdir({ git: true })
737
+ await Instance.provide({
738
+ directory: tmp.path,
739
+ fn: async () => {
740
+ const askPromise1 = Permission.ask({
741
+ id: PermissionID.make("per_test4a"),
742
+ sessionID: SessionID.make("session_same"),
743
+ permission: "bash",
744
+ patterns: ["ls"],
745
+ metadata: {},
746
+ always: []
747
+ }, [])
748
+
749
+ const askPromise2 = Permission.ask({
750
+ id: PermissionID.make("per_test4b"),
751
+ sessionID: SessionID.make("session_same"),
752
+ permission: "edit",
753
+ patterns: ["foo.ts"],
754
+ metadata: {},
755
+ always: []
756
+ }, [])
757
+
758
+ await waitForPending(2)
759
+
760
+ // Catch rejections before they become unhandled
761
+ const result1 = askPromise1.catch((e) => e)
762
+ const result2 = askPromise2.catch((e) => e)
763
+
764
+ // Reject the first one
765
+ await Permission.reply({
766
+ requestID: PermissionID.make("per_test4a"),
767
+ reply: "reject",
768
+ })
769
+
770
+ // Both should be rejected
771
+ expect(await result1).toBeInstanceOf(Permission.RejectedError)
772
+ expect(await result2).toBeInstanceOf(Permission.RejectedError)
773
+ },
774
+ })
775
+ })
776
+
777
+ test("reply - always resolves matching pending requests in same session", async () => {
778
+ await using tmp = await tmpdir({ git: true })
779
+ await Instance.provide({
780
+ directory: tmp.path,
781
+ fn: async () => {
782
+ const a = Permission.ask({
783
+ id: PermissionID.make("per_test5a"),
784
+ sessionID: SessionID.make("session_same"),
785
+ permission: "bash",
786
+ patterns: ["ls"],
787
+ metadata: {},
788
+ always: ["ls"]
789
+ }, [])
790
+
791
+ const b = Permission.ask({
792
+ id: PermissionID.make("per_test5b"),
793
+ sessionID: SessionID.make("session_same"),
794
+ permission: "bash",
795
+ patterns: ["ls"],
796
+ metadata: {},
797
+ always: []
798
+ }, [])
799
+
800
+ await waitForPending(2)
801
+
802
+ await Permission.reply({
803
+ requestID: PermissionID.make("per_test5a"),
804
+ reply: "always",
805
+ })
806
+
807
+ await expect(a).resolves.toBeUndefined()
808
+ await expect(b).resolves.toBeUndefined()
809
+ expect(await Permission.list()).toHaveLength(0)
810
+ },
811
+ })
812
+ })
813
+
814
+ test("reply - always keeps other session pending", async () => {
815
+ await using tmp = await tmpdir({ git: true })
816
+ await Instance.provide({
817
+ directory: tmp.path,
818
+ fn: async () => {
819
+ const a = Permission.ask({
820
+ id: PermissionID.make("per_test6a"),
821
+ sessionID: SessionID.make("session_a"),
822
+ permission: "bash",
823
+ patterns: ["ls"],
824
+ metadata: {},
825
+ always: ["ls"]
826
+ }, [])
827
+
828
+ const b = Permission.ask({
829
+ id: PermissionID.make("per_test6b"),
830
+ sessionID: SessionID.make("session_b"),
831
+ permission: "bash",
832
+ patterns: ["ls"],
833
+ metadata: {},
834
+ always: []
835
+ }, [])
836
+
837
+ await waitForPending(2)
838
+
839
+ await Permission.reply({
840
+ requestID: PermissionID.make("per_test6a"),
841
+ reply: "always",
842
+ })
843
+
844
+ await expect(a).resolves.toBeUndefined()
845
+ expect((await Permission.list()).map((x) => x.id)).toEqual([PermissionID.make("per_test6b")])
846
+
847
+ await rejectAll()
848
+ await b.catch(() => {})
849
+ },
850
+ })
851
+ })
852
+
853
+ test("reply - publishes replied event", async () => {
854
+ await using tmp = await tmpdir({ git: true })
855
+ await Instance.provide({
856
+ directory: tmp.path,
857
+ fn: async () => {
858
+ const ask = Permission.ask({
859
+ id: PermissionID.make("per_test7"),
860
+ sessionID: SessionID.make("session_test"),
861
+ permission: "bash",
862
+ patterns: ["ls"],
863
+ metadata: {},
864
+ always: []
865
+ }, [])
866
+
867
+ await waitForPending(1)
868
+
869
+ let seen:
870
+ | {
871
+ sessionID: SessionID
872
+ requestID: PermissionID
873
+ reply: Permission.Reply
874
+ }
875
+ | undefined
876
+ const unsub = Bus.subscribe(Permission.Event.Replied, (event) => {
877
+ seen = event.properties
878
+ })
879
+
880
+ await Permission.reply({
881
+ requestID: PermissionID.make("per_test7"),
882
+ reply: "once",
883
+ })
884
+
885
+ await expect(ask).resolves.toBeUndefined()
886
+ expect(seen).toEqual({
887
+ sessionID: SessionID.make("session_test"),
888
+ requestID: PermissionID.make("per_test7"),
889
+ reply: "once",
890
+ })
891
+ unsub()
892
+ },
893
+ })
894
+ })
895
+
896
+ test("permission requests stay isolated by directory", async () => {
897
+ await using one = await tmpdir({ git: true })
898
+ await using two = await tmpdir({ git: true })
899
+
900
+ const a = Instance.provide({
901
+ directory: one.path,
902
+ fn: () =>
903
+ Permission.ask({
904
+ id: PermissionID.make("per_dir_a"),
905
+ sessionID: SessionID.make("session_dir_a"),
906
+ permission: "bash",
907
+ patterns: ["ls"],
908
+ metadata: {},
909
+ always: []
910
+ }, []),
911
+ })
912
+
913
+ const b = Instance.provide({
914
+ directory: two.path,
915
+ fn: () =>
916
+ Permission.ask({
917
+ id: PermissionID.make("per_dir_b"),
918
+ sessionID: SessionID.make("session_dir_b"),
919
+ permission: "bash",
920
+ patterns: ["pwd"],
921
+ metadata: {},
922
+ always: []
923
+ }, []),
924
+ })
925
+
926
+ const onePending = await Instance.provide({
927
+ directory: one.path,
928
+ fn: () => waitForPending(1),
929
+ })
930
+ const twoPending = await Instance.provide({
931
+ directory: two.path,
932
+ fn: () => waitForPending(1),
933
+ })
934
+
935
+ expect(onePending).toHaveLength(1)
936
+ expect(twoPending).toHaveLength(1)
937
+ expect(onePending[0].id).toBe(PermissionID.make("per_dir_a"))
938
+ expect(twoPending[0].id).toBe(PermissionID.make("per_dir_b"))
939
+
940
+ await Instance.provide({
941
+ directory: one.path,
942
+ fn: () => Permission.reply({ requestID: onePending[0].id, reply: "reject" }),
943
+ })
944
+ await Instance.provide({
945
+ directory: two.path,
946
+ fn: () => Permission.reply({ requestID: twoPending[0].id, reply: "reject" }),
947
+ })
948
+
949
+ await a.catch(() => {})
950
+ await b.catch(() => {})
951
+ })
952
+
953
+ test("pending permission rejects on instance dispose", async () => {
954
+ await using tmp = await tmpdir({ git: true })
955
+
956
+ const ask = Instance.provide({
957
+ directory: tmp.path,
958
+ fn: () =>
959
+ Permission.ask({
960
+ id: PermissionID.make("per_dispose"),
961
+ sessionID: SessionID.make("session_dispose"),
962
+ permission: "bash",
963
+ patterns: ["ls"],
964
+ metadata: {},
965
+ always: []
966
+ }, []),
967
+ })
968
+ const result = ask.then(
969
+ () => "resolved" as const,
970
+ (err) => err,
971
+ )
972
+
973
+ await Instance.provide({
974
+ directory: tmp.path,
975
+ fn: async () => {
976
+ const pending = await waitForPending(1)
977
+ expect(pending).toHaveLength(1)
978
+ await Instance.dispose()
979
+ },
980
+ })
981
+
982
+ expect(await result).toBeInstanceOf(Permission.RejectedError)
983
+ })
984
+
985
+ test("pending permission rejects on instance reload", async () => {
986
+ await using tmp = await tmpdir({ git: true })
987
+
988
+ const ask = Instance.provide({
989
+ directory: tmp.path,
990
+ fn: () =>
991
+ Permission.ask({
992
+ id: PermissionID.make("per_reload"),
993
+ sessionID: SessionID.make("session_reload"),
994
+ permission: "bash",
995
+ patterns: ["ls"],
996
+ metadata: {},
997
+ always: []
998
+ }, []),
999
+ })
1000
+ const result = ask.then(
1001
+ () => "resolved" as const,
1002
+ (err) => err,
1003
+ )
1004
+
1005
+ await Instance.provide({
1006
+ directory: tmp.path,
1007
+ fn: async () => {
1008
+ const pending = await waitForPending(1)
1009
+ expect(pending).toHaveLength(1)
1010
+ await Instance.reload({ directory: tmp.path })
1011
+ },
1012
+ })
1013
+
1014
+ expect(await result).toBeInstanceOf(Permission.RejectedError)
1015
+ })
1016
+
1017
+ test("reply - does nothing for unknown requestID", async () => {
1018
+ await using tmp = await tmpdir({ git: true })
1019
+ await Instance.provide({
1020
+ directory: tmp.path,
1021
+ fn: async () => {
1022
+ await Permission.reply({
1023
+ requestID: PermissionID.make("per_unknown"),
1024
+ reply: "once",
1025
+ })
1026
+ expect(await Permission.list()).toHaveLength(0)
1027
+ },
1028
+ })
1029
+ })
1030
+
1031
+ test("ask - checks all patterns and stops on first deny", async () => {
1032
+ await using tmp = await tmpdir({ git: true })
1033
+ await Instance.provide({
1034
+ directory: tmp.path,
1035
+ fn: async () => {
1036
+ await expect(
1037
+ Permission.ask({
1038
+ sessionID: SessionID.make("session_test"),
1039
+ permission: "bash",
1040
+ patterns: ["echo hello", "rm -rf /"],
1041
+ metadata: {},
1042
+ always: []
1043
+ }, [
1044
+ { permission: "bash", pattern: "*", action: "allow" },
1045
+ { permission: "bash", pattern: "rm *", action: "deny" },
1046
+ ]),
1047
+ ).rejects.toBeInstanceOf(Permission.DeniedError)
1048
+ },
1049
+ })
1050
+ })
1051
+
1052
+ test("ask - allows all patterns when all match allow rules", async () => {
1053
+ await using tmp = await tmpdir({ git: true })
1054
+ await Instance.provide({
1055
+ directory: tmp.path,
1056
+ fn: async () => {
1057
+ const result = await Permission.ask({
1058
+ sessionID: SessionID.make("session_test"),
1059
+ permission: "bash",
1060
+ patterns: ["echo hello", "ls -la", "pwd"],
1061
+ metadata: {},
1062
+ always: []
1063
+ }, [{ permission: "bash", pattern: "*", action: "allow" }])
1064
+ expect(result).toBeUndefined()
1065
+ },
1066
+ })
1067
+ })
1068
+
1069
+ test("ask - should deny even when an earlier pattern is ask", async () => {
1070
+ await using tmp = await tmpdir({ git: true })
1071
+ await Instance.provide({
1072
+ directory: tmp.path,
1073
+ fn: async () => {
1074
+ const err = await Permission.ask({
1075
+ sessionID: SessionID.make("session_test"),
1076
+ permission: "bash",
1077
+ patterns: ["echo hello", "rm -rf /"],
1078
+ metadata: {},
1079
+ always: []
1080
+ }, [
1081
+ { permission: "bash", pattern: "echo *", action: "ask" },
1082
+ { permission: "bash", pattern: "rm *", action: "deny" },
1083
+ ]).then(
1084
+ () => undefined,
1085
+ (err) => err,
1086
+ )
1087
+
1088
+ expect(err).toBeInstanceOf(Permission.DeniedError)
1089
+ expect(await Permission.list()).toHaveLength(0)
1090
+ },
1091
+ })
1092
+ })
1093
+
1094
+ test("ask - abort should clear pending request", async () => {
1095
+ await using tmp = await tmpdir({ git: true })
1096
+ await Instance.provide({
1097
+ directory: tmp.path,
1098
+ fn: async () => {
1099
+ const ctl = new AbortController()
1100
+ const ask = Permission.runPromise(
1101
+ (svc) =>
1102
+ svc.ask({
1103
+ sessionID: SessionID.make("session_test"),
1104
+ permission: "bash",
1105
+ patterns: ["ls"],
1106
+ metadata: {},
1107
+ always: []
1108
+ }, [{ permission: "bash", pattern: "*", action: "ask" }]),
1109
+ { signal: ctl.signal },
1110
+ )
1111
+
1112
+ await waitForPending(1)
1113
+ ctl.abort()
1114
+ await ask.catch(() => {})
1115
+
1116
+ try {
1117
+ expect(await Permission.list()).toHaveLength(0)
1118
+ } finally {
1119
+ await rejectAll()
1120
+ }
1121
+ },
1122
+ })
1123
+ })