chad-code 1.3.1

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 (338) hide show
  1. package/AGENTS.md +27 -0
  2. package/Dockerfile +18 -0
  3. package/README.md +15 -0
  4. package/README.npm.md +64 -0
  5. package/bin/chad-code +84 -0
  6. package/bunfig.toml +7 -0
  7. package/eslint.config.js +29 -0
  8. package/package.json +107 -0
  9. package/parsers-config.ts +253 -0
  10. package/script/build.ts +167 -0
  11. package/script/postinstall.mjs +122 -0
  12. package/script/publish-registries.ts +187 -0
  13. package/script/publish.ts +93 -0
  14. package/script/schema.ts +47 -0
  15. package/src/acp/README.md +164 -0
  16. package/src/acp/agent.ts +1086 -0
  17. package/src/acp/session.ts +101 -0
  18. package/src/acp/types.ts +22 -0
  19. package/src/agent/agent.ts +253 -0
  20. package/src/agent/generate.txt +75 -0
  21. package/src/agent/prompt/compaction.txt +12 -0
  22. package/src/agent/prompt/explore.txt +18 -0
  23. package/src/agent/prompt/summary.txt +11 -0
  24. package/src/agent/prompt/title.txt +36 -0
  25. package/src/auth/index.ts +70 -0
  26. package/src/bun/index.ts +130 -0
  27. package/src/bus/bus-event.ts +43 -0
  28. package/src/bus/global.ts +10 -0
  29. package/src/bus/index.ts +105 -0
  30. package/src/cli/bootstrap.ts +17 -0
  31. package/src/cli/cmd/acp.ts +69 -0
  32. package/src/cli/cmd/agent.ts +257 -0
  33. package/src/cli/cmd/auth.ts +132 -0
  34. package/src/cli/cmd/cmd.ts +7 -0
  35. package/src/cli/cmd/debug/agent.ts +28 -0
  36. package/src/cli/cmd/debug/config.ts +15 -0
  37. package/src/cli/cmd/debug/file.ts +91 -0
  38. package/src/cli/cmd/debug/index.ts +45 -0
  39. package/src/cli/cmd/debug/lsp.ts +48 -0
  40. package/src/cli/cmd/debug/ripgrep.ts +83 -0
  41. package/src/cli/cmd/debug/scrap.ts +15 -0
  42. package/src/cli/cmd/debug/skill.ts +15 -0
  43. package/src/cli/cmd/debug/snapshot.ts +48 -0
  44. package/src/cli/cmd/export.ts +88 -0
  45. package/src/cli/cmd/generate.ts +38 -0
  46. package/src/cli/cmd/github.ts +32 -0
  47. package/src/cli/cmd/import.ts +98 -0
  48. package/src/cli/cmd/mcp.ts +670 -0
  49. package/src/cli/cmd/models.ts +42 -0
  50. package/src/cli/cmd/pr.ts +112 -0
  51. package/src/cli/cmd/run.ts +374 -0
  52. package/src/cli/cmd/serve.ts +16 -0
  53. package/src/cli/cmd/session.ts +135 -0
  54. package/src/cli/cmd/stats.ts +402 -0
  55. package/src/cli/cmd/tui/app.tsx +705 -0
  56. package/src/cli/cmd/tui/attach.ts +32 -0
  57. package/src/cli/cmd/tui/component/border.tsx +21 -0
  58. package/src/cli/cmd/tui/component/dialog-agent.tsx +31 -0
  59. package/src/cli/cmd/tui/component/dialog-command.tsx +124 -0
  60. package/src/cli/cmd/tui/component/dialog-mcp.tsx +86 -0
  61. package/src/cli/cmd/tui/component/dialog-model.tsx +232 -0
  62. package/src/cli/cmd/tui/component/dialog-provider.tsx +228 -0
  63. package/src/cli/cmd/tui/component/dialog-session-list.tsx +115 -0
  64. package/src/cli/cmd/tui/component/dialog-session-rename.tsx +31 -0
  65. package/src/cli/cmd/tui/component/dialog-stash.tsx +86 -0
  66. package/src/cli/cmd/tui/component/dialog-status.tsx +162 -0
  67. package/src/cli/cmd/tui/component/dialog-tag.tsx +44 -0
  68. package/src/cli/cmd/tui/component/dialog-theme-list.tsx +50 -0
  69. package/src/cli/cmd/tui/component/did-you-know.tsx +85 -0
  70. package/src/cli/cmd/tui/component/logo.tsx +43 -0
  71. package/src/cli/cmd/tui/component/prompt/autocomplete.tsx +654 -0
  72. package/src/cli/cmd/tui/component/prompt/history.tsx +108 -0
  73. package/src/cli/cmd/tui/component/prompt/index.tsx +1078 -0
  74. package/src/cli/cmd/tui/component/prompt/stash.tsx +101 -0
  75. package/src/cli/cmd/tui/component/textarea-keybindings.ts +73 -0
  76. package/src/cli/cmd/tui/component/tips.ts +92 -0
  77. package/src/cli/cmd/tui/component/todo-item.tsx +32 -0
  78. package/src/cli/cmd/tui/context/args.tsx +14 -0
  79. package/src/cli/cmd/tui/context/directory.ts +13 -0
  80. package/src/cli/cmd/tui/context/exit.tsx +23 -0
  81. package/src/cli/cmd/tui/context/helper.tsx +25 -0
  82. package/src/cli/cmd/tui/context/keybind.tsx +101 -0
  83. package/src/cli/cmd/tui/context/kv.tsx +49 -0
  84. package/src/cli/cmd/tui/context/local.tsx +392 -0
  85. package/src/cli/cmd/tui/context/prompt.tsx +18 -0
  86. package/src/cli/cmd/tui/context/route.tsx +46 -0
  87. package/src/cli/cmd/tui/context/sdk.tsx +75 -0
  88. package/src/cli/cmd/tui/context/sync.tsx +384 -0
  89. package/src/cli/cmd/tui/context/theme/aura.json +69 -0
  90. package/src/cli/cmd/tui/context/theme/ayu.json +80 -0
  91. package/src/cli/cmd/tui/context/theme/catppuccin-frappe.json +233 -0
  92. package/src/cli/cmd/tui/context/theme/catppuccin-macchiato.json +233 -0
  93. package/src/cli/cmd/tui/context/theme/catppuccin.json +112 -0
  94. package/src/cli/cmd/tui/context/theme/chad.json +245 -0
  95. package/src/cli/cmd/tui/context/theme/cobalt2.json +228 -0
  96. package/src/cli/cmd/tui/context/theme/cursor.json +249 -0
  97. package/src/cli/cmd/tui/context/theme/dracula.json +219 -0
  98. package/src/cli/cmd/tui/context/theme/everforest.json +241 -0
  99. package/src/cli/cmd/tui/context/theme/flexoki.json +237 -0
  100. package/src/cli/cmd/tui/context/theme/github.json +233 -0
  101. package/src/cli/cmd/tui/context/theme/gruvbox.json +95 -0
  102. package/src/cli/cmd/tui/context/theme/kanagawa.json +77 -0
  103. package/src/cli/cmd/tui/context/theme/lucent-orng.json +227 -0
  104. package/src/cli/cmd/tui/context/theme/material.json +235 -0
  105. package/src/cli/cmd/tui/context/theme/matrix.json +77 -0
  106. package/src/cli/cmd/tui/context/theme/mercury.json +252 -0
  107. package/src/cli/cmd/tui/context/theme/monokai.json +221 -0
  108. package/src/cli/cmd/tui/context/theme/nightowl.json +221 -0
  109. package/src/cli/cmd/tui/context/theme/nord.json +223 -0
  110. package/src/cli/cmd/tui/context/theme/one-dark.json +84 -0
  111. package/src/cli/cmd/tui/context/theme/orng.json +245 -0
  112. package/src/cli/cmd/tui/context/theme/osaka-jade.json +93 -0
  113. package/src/cli/cmd/tui/context/theme/palenight.json +222 -0
  114. package/src/cli/cmd/tui/context/theme/rosepine.json +234 -0
  115. package/src/cli/cmd/tui/context/theme/solarized.json +223 -0
  116. package/src/cli/cmd/tui/context/theme/synthwave84.json +226 -0
  117. package/src/cli/cmd/tui/context/theme/tokyonight.json +243 -0
  118. package/src/cli/cmd/tui/context/theme/vercel.json +245 -0
  119. package/src/cli/cmd/tui/context/theme/vesper.json +218 -0
  120. package/src/cli/cmd/tui/context/theme/zenburn.json +223 -0
  121. package/src/cli/cmd/tui/context/theme.tsx +1137 -0
  122. package/src/cli/cmd/tui/event.ts +46 -0
  123. package/src/cli/cmd/tui/routes/home.tsx +138 -0
  124. package/src/cli/cmd/tui/routes/session/dialog-fork-from-timeline.tsx +64 -0
  125. package/src/cli/cmd/tui/routes/session/dialog-message.tsx +109 -0
  126. package/src/cli/cmd/tui/routes/session/dialog-subagent.tsx +26 -0
  127. package/src/cli/cmd/tui/routes/session/dialog-timeline.tsx +47 -0
  128. package/src/cli/cmd/tui/routes/session/footer.tsx +88 -0
  129. package/src/cli/cmd/tui/routes/session/header.tsx +125 -0
  130. package/src/cli/cmd/tui/routes/session/index.tsx +1814 -0
  131. package/src/cli/cmd/tui/routes/session/permission.tsx +416 -0
  132. package/src/cli/cmd/tui/routes/session/sidebar.tsx +318 -0
  133. package/src/cli/cmd/tui/spawn.ts +48 -0
  134. package/src/cli/cmd/tui/thread.ts +111 -0
  135. package/src/cli/cmd/tui/ui/dialog-alert.tsx +57 -0
  136. package/src/cli/cmd/tui/ui/dialog-confirm.tsx +83 -0
  137. package/src/cli/cmd/tui/ui/dialog-export-options.tsx +204 -0
  138. package/src/cli/cmd/tui/ui/dialog-help.tsx +38 -0
  139. package/src/cli/cmd/tui/ui/dialog-prompt.tsx +77 -0
  140. package/src/cli/cmd/tui/ui/dialog-select.tsx +345 -0
  141. package/src/cli/cmd/tui/ui/dialog.tsx +171 -0
  142. package/src/cli/cmd/tui/ui/link.tsx +28 -0
  143. package/src/cli/cmd/tui/ui/spinner.ts +368 -0
  144. package/src/cli/cmd/tui/ui/toast.tsx +100 -0
  145. package/src/cli/cmd/tui/util/clipboard.ts +127 -0
  146. package/src/cli/cmd/tui/util/editor.ts +32 -0
  147. package/src/cli/cmd/tui/util/signal.ts +7 -0
  148. package/src/cli/cmd/tui/util/terminal.ts +114 -0
  149. package/src/cli/cmd/tui/util/transcript.ts +98 -0
  150. package/src/cli/cmd/tui/worker.ts +68 -0
  151. package/src/cli/cmd/uninstall.ts +344 -0
  152. package/src/cli/cmd/upgrade.ts +67 -0
  153. package/src/cli/cmd/web.ts +73 -0
  154. package/src/cli/error.ts +56 -0
  155. package/src/cli/network.ts +53 -0
  156. package/src/cli/ui.ts +87 -0
  157. package/src/cli/upgrade.ts +25 -0
  158. package/src/command/index.ts +131 -0
  159. package/src/command/template/initialize.txt +10 -0
  160. package/src/command/template/review.txt +97 -0
  161. package/src/config/config.ts +1124 -0
  162. package/src/config/markdown.ts +41 -0
  163. package/src/env/index.ts +26 -0
  164. package/src/file/ignore.ts +83 -0
  165. package/src/file/index.ts +411 -0
  166. package/src/file/ripgrep.ts +402 -0
  167. package/src/file/time.ts +64 -0
  168. package/src/file/watcher.ts +117 -0
  169. package/src/flag/flag.ts +52 -0
  170. package/src/format/formatter.ts +359 -0
  171. package/src/format/index.ts +137 -0
  172. package/src/global/index.ts +55 -0
  173. package/src/id/id.ts +73 -0
  174. package/src/ide/index.ts +77 -0
  175. package/src/index.ts +159 -0
  176. package/src/installation/index.ts +198 -0
  177. package/src/lsp/client.ts +252 -0
  178. package/src/lsp/index.ts +485 -0
  179. package/src/lsp/language.ts +119 -0
  180. package/src/lsp/server.ts +2023 -0
  181. package/src/mcp/auth.ts +135 -0
  182. package/src/mcp/index.ts +874 -0
  183. package/src/mcp/oauth-callback.ts +200 -0
  184. package/src/mcp/oauth-provider.ts +154 -0
  185. package/src/patch/index.ts +622 -0
  186. package/src/permission/arity.ts +163 -0
  187. package/src/permission/index.ts +210 -0
  188. package/src/permission/next.ts +268 -0
  189. package/src/plugin/index.ts +106 -0
  190. package/src/project/bootstrap.ts +31 -0
  191. package/src/project/instance.ts +78 -0
  192. package/src/project/project.ts +263 -0
  193. package/src/project/state.ts +65 -0
  194. package/src/project/vcs.ts +76 -0
  195. package/src/provider/auth.ts +143 -0
  196. package/src/provider/models-macro.ts +4 -0
  197. package/src/provider/models.ts +77 -0
  198. package/src/provider/provider.ts +516 -0
  199. package/src/provider/transform.ts +114 -0
  200. package/src/pty/index.ts +212 -0
  201. package/src/server/error.ts +36 -0
  202. package/src/server/mdns.ts +57 -0
  203. package/src/server/project.ts +79 -0
  204. package/src/server/server.ts +2866 -0
  205. package/src/server/tui.ts +71 -0
  206. package/src/session/compaction.ts +225 -0
  207. package/src/session/index.ts +469 -0
  208. package/src/session/llm.ts +213 -0
  209. package/src/session/message-v2.ts +742 -0
  210. package/src/session/message.ts +189 -0
  211. package/src/session/processor.ts +402 -0
  212. package/src/session/prompt/anthropic-20250930.txt +166 -0
  213. package/src/session/prompt/anthropic.txt +105 -0
  214. package/src/session/prompt/anthropic_spoof.txt +1 -0
  215. package/src/session/prompt/beast.txt +147 -0
  216. package/src/session/prompt/build-switch.txt +5 -0
  217. package/src/session/prompt/codex.txt +318 -0
  218. package/src/session/prompt/copilot-gpt-5.txt +143 -0
  219. package/src/session/prompt/gemini.txt +155 -0
  220. package/src/session/prompt/max-steps.txt +16 -0
  221. package/src/session/prompt/plan-reminder-anthropic.txt +67 -0
  222. package/src/session/prompt/plan.txt +26 -0
  223. package/src/session/prompt/qwen.txt +109 -0
  224. package/src/session/prompt.ts +1621 -0
  225. package/src/session/retry.ts +90 -0
  226. package/src/session/revert.ts +108 -0
  227. package/src/session/status.ts +76 -0
  228. package/src/session/summary.ts +194 -0
  229. package/src/session/system.ts +108 -0
  230. package/src/session/todo.ts +37 -0
  231. package/src/share/share-next.ts +194 -0
  232. package/src/share/share.ts +23 -0
  233. package/src/shell/shell.ts +67 -0
  234. package/src/skill/index.ts +1 -0
  235. package/src/skill/skill.ts +124 -0
  236. package/src/snapshot/index.ts +197 -0
  237. package/src/storage/storage.ts +226 -0
  238. package/src/tool/bash.ts +262 -0
  239. package/src/tool/bash.txt +116 -0
  240. package/src/tool/batch.ts +175 -0
  241. package/src/tool/batch.txt +24 -0
  242. package/src/tool/codesearch.ts +132 -0
  243. package/src/tool/codesearch.txt +12 -0
  244. package/src/tool/edit.ts +655 -0
  245. package/src/tool/edit.txt +10 -0
  246. package/src/tool/glob.ts +75 -0
  247. package/src/tool/glob.txt +6 -0
  248. package/src/tool/grep.ts +132 -0
  249. package/src/tool/grep.txt +8 -0
  250. package/src/tool/invalid.ts +17 -0
  251. package/src/tool/ls.ts +119 -0
  252. package/src/tool/ls.txt +1 -0
  253. package/src/tool/lsp.ts +94 -0
  254. package/src/tool/lsp.txt +19 -0
  255. package/src/tool/multiedit.ts +46 -0
  256. package/src/tool/multiedit.txt +41 -0
  257. package/src/tool/patch.ts +210 -0
  258. package/src/tool/patch.txt +1 -0
  259. package/src/tool/read.ts +191 -0
  260. package/src/tool/read.txt +12 -0
  261. package/src/tool/registry.ts +137 -0
  262. package/src/tool/skill.ts +77 -0
  263. package/src/tool/task.ts +167 -0
  264. package/src/tool/task.txt +60 -0
  265. package/src/tool/todo.ts +53 -0
  266. package/src/tool/todoread.txt +14 -0
  267. package/src/tool/todowrite.txt +167 -0
  268. package/src/tool/tool.ts +73 -0
  269. package/src/tool/webfetch.ts +182 -0
  270. package/src/tool/webfetch.txt +13 -0
  271. package/src/tool/websearch.ts +144 -0
  272. package/src/tool/websearch.txt +11 -0
  273. package/src/tool/write.ts +84 -0
  274. package/src/tool/write.txt +8 -0
  275. package/src/util/archive.ts +16 -0
  276. package/src/util/color.ts +19 -0
  277. package/src/util/context.ts +25 -0
  278. package/src/util/defer.ts +12 -0
  279. package/src/util/eventloop.ts +20 -0
  280. package/src/util/filesystem.ts +83 -0
  281. package/src/util/fn.ts +11 -0
  282. package/src/util/iife.ts +3 -0
  283. package/src/util/keybind.ts +102 -0
  284. package/src/util/lazy.ts +18 -0
  285. package/src/util/locale.ts +81 -0
  286. package/src/util/lock.ts +98 -0
  287. package/src/util/log.ts +180 -0
  288. package/src/util/queue.ts +32 -0
  289. package/src/util/rpc.ts +42 -0
  290. package/src/util/scrap.ts +10 -0
  291. package/src/util/signal.ts +12 -0
  292. package/src/util/timeout.ts +14 -0
  293. package/src/util/token.ts +7 -0
  294. package/src/util/wildcard.ts +54 -0
  295. package/src/worktree/index.ts +217 -0
  296. package/sst-env.d.ts +9 -0
  297. package/test/agent/agent.test.ts +448 -0
  298. package/test/bun.test.ts +53 -0
  299. package/test/cli/github-action.test.ts +129 -0
  300. package/test/cli/github-remote.test.ts +80 -0
  301. package/test/cli/tui/transcript.test.ts +297 -0
  302. package/test/config/agent-color.test.ts +66 -0
  303. package/test/config/config.test.ts +870 -0
  304. package/test/config/markdown.test.ts +89 -0
  305. package/test/file/ignore.test.ts +10 -0
  306. package/test/file/path-traversal.test.ts +115 -0
  307. package/test/fixture/fixture.ts +45 -0
  308. package/test/fixture/lsp/fake-lsp-server.js +77 -0
  309. package/test/ide/ide.test.ts +82 -0
  310. package/test/keybind.test.ts +421 -0
  311. package/test/lsp/client.test.ts +95 -0
  312. package/test/mcp/headers.test.ts +153 -0
  313. package/test/patch/patch.test.ts +348 -0
  314. package/test/permission/arity.test.ts +33 -0
  315. package/test/permission/next.test.ts +652 -0
  316. package/test/preload.ts +63 -0
  317. package/test/project/project.test.ts +120 -0
  318. package/test/provider/amazon-bedrock.test.ts +236 -0
  319. package/test/provider/provider.test.ts +2127 -0
  320. package/test/provider/transform.test.ts +980 -0
  321. package/test/server/session-select.test.ts +78 -0
  322. package/test/session/compaction.test.ts +251 -0
  323. package/test/session/message-v2.test.ts +570 -0
  324. package/test/session/retry.test.ts +131 -0
  325. package/test/session/revert-compact.test.ts +285 -0
  326. package/test/session/session.test.ts +71 -0
  327. package/test/skill/skill.test.ts +185 -0
  328. package/test/snapshot/snapshot.test.ts +939 -0
  329. package/test/tool/__snapshots__/tool.test.ts.snap +9 -0
  330. package/test/tool/bash.test.ts +232 -0
  331. package/test/tool/grep.test.ts +109 -0
  332. package/test/tool/patch.test.ts +261 -0
  333. package/test/tool/read.test.ts +167 -0
  334. package/test/util/iife.test.ts +36 -0
  335. package/test/util/lazy.test.ts +50 -0
  336. package/test/util/timeout.test.ts +21 -0
  337. package/test/util/wildcard.test.ts +55 -0
  338. package/tsconfig.json +16 -0
@@ -0,0 +1,167 @@
1
+ import { describe, expect, test } from "bun:test"
2
+ import path from "path"
3
+ import { ReadTool } from "../../src/tool/read"
4
+ import { Instance } from "../../src/project/instance"
5
+ import { tmpdir } from "../fixture/fixture"
6
+ import { PermissionNext } from "../../src/permission/next"
7
+ import { Agent } from "../../src/agent/agent"
8
+
9
+ const ctx = {
10
+ sessionID: "test",
11
+ messageID: "",
12
+ callID: "",
13
+ agent: "build",
14
+ abort: AbortSignal.any([]),
15
+ metadata: () => {},
16
+ ask: async () => {},
17
+ }
18
+
19
+ describe("tool.read external_directory permission", () => {
20
+ test("allows reading absolute path inside project directory", async () => {
21
+ await using tmp = await tmpdir({
22
+ init: async (dir) => {
23
+ await Bun.write(path.join(dir, "test.txt"), "hello world")
24
+ },
25
+ })
26
+ await Instance.provide({
27
+ directory: tmp.path,
28
+ fn: async () => {
29
+ const read = await ReadTool.init()
30
+ const result = await read.execute({ filePath: path.join(tmp.path, "test.txt") }, ctx)
31
+ expect(result.output).toContain("hello world")
32
+ },
33
+ })
34
+ })
35
+
36
+ test("allows reading file in subdirectory inside project directory", async () => {
37
+ await using tmp = await tmpdir({
38
+ init: async (dir) => {
39
+ await Bun.write(path.join(dir, "subdir", "test.txt"), "nested content")
40
+ },
41
+ })
42
+ await Instance.provide({
43
+ directory: tmp.path,
44
+ fn: async () => {
45
+ const read = await ReadTool.init()
46
+ const result = await read.execute({ filePath: path.join(tmp.path, "subdir", "test.txt") }, ctx)
47
+ expect(result.output).toContain("nested content")
48
+ },
49
+ })
50
+ })
51
+
52
+ test("asks for external_directory permission when reading absolute path outside project", async () => {
53
+ await using outerTmp = await tmpdir({
54
+ init: async (dir) => {
55
+ await Bun.write(path.join(dir, "secret.txt"), "secret data")
56
+ },
57
+ })
58
+ await using tmp = await tmpdir({ git: true })
59
+ await Instance.provide({
60
+ directory: tmp.path,
61
+ fn: async () => {
62
+ const read = await ReadTool.init()
63
+ const requests: Array<Omit<PermissionNext.Request, "id" | "sessionID" | "tool">> = []
64
+ const testCtx = {
65
+ ...ctx,
66
+ ask: async (req: Omit<PermissionNext.Request, "id" | "sessionID" | "tool">) => {
67
+ requests.push(req)
68
+ },
69
+ }
70
+ await read.execute({ filePath: path.join(outerTmp.path, "secret.txt") }, testCtx)
71
+ const extDirReq = requests.find((r) => r.permission === "external_directory")
72
+ expect(extDirReq).toBeDefined()
73
+ expect(extDirReq!.patterns.some((p) => p.includes(outerTmp.path))).toBe(true)
74
+ },
75
+ })
76
+ })
77
+
78
+ test("asks for external_directory permission when reading relative path outside project", async () => {
79
+ await using tmp = await tmpdir({ git: true })
80
+ await Instance.provide({
81
+ directory: tmp.path,
82
+ fn: async () => {
83
+ const read = await ReadTool.init()
84
+ const requests: Array<Omit<PermissionNext.Request, "id" | "sessionID" | "tool">> = []
85
+ const testCtx = {
86
+ ...ctx,
87
+ ask: async (req: Omit<PermissionNext.Request, "id" | "sessionID" | "tool">) => {
88
+ requests.push(req)
89
+ },
90
+ }
91
+ // This will fail because file doesn't exist, but we can check if permission was asked
92
+ await read.execute({ filePath: "../outside.txt" }, testCtx).catch(() => {})
93
+ const extDirReq = requests.find((r) => r.permission === "external_directory")
94
+ expect(extDirReq).toBeDefined()
95
+ },
96
+ })
97
+ })
98
+
99
+ test("does not ask for external_directory permission when reading inside project", async () => {
100
+ await using tmp = await tmpdir({
101
+ git: true,
102
+ init: async (dir) => {
103
+ await Bun.write(path.join(dir, "internal.txt"), "internal content")
104
+ },
105
+ })
106
+ await Instance.provide({
107
+ directory: tmp.path,
108
+ fn: async () => {
109
+ const read = await ReadTool.init()
110
+ const requests: Array<Omit<PermissionNext.Request, "id" | "sessionID" | "tool">> = []
111
+ const testCtx = {
112
+ ...ctx,
113
+ ask: async (req: Omit<PermissionNext.Request, "id" | "sessionID" | "tool">) => {
114
+ requests.push(req)
115
+ },
116
+ }
117
+ await read.execute({ filePath: path.join(tmp.path, "internal.txt") }, testCtx)
118
+ const extDirReq = requests.find((r) => r.permission === "external_directory")
119
+ expect(extDirReq).toBeUndefined()
120
+ },
121
+ })
122
+ })
123
+ })
124
+
125
+ describe("tool.read env file blocking", () => {
126
+ const cases: [string, boolean][] = [
127
+ [".env", true],
128
+ [".env.local", true],
129
+ [".env.production", true],
130
+ [".env.development.local", true],
131
+ [".env.example", false],
132
+ [".envrc", false],
133
+ ["environment.ts", false],
134
+ ]
135
+
136
+ describe.each(["build", "plan"])("agent=%s", (agentName) => {
137
+ test.each(cases)("%s blocked=%s", async (filename, blocked) => {
138
+ await using tmp = await tmpdir({
139
+ init: (dir) => Bun.write(path.join(dir, filename), "content"),
140
+ })
141
+ await Instance.provide({
142
+ directory: tmp.path,
143
+ fn: async () => {
144
+ const agent = await Agent.get(agentName)
145
+ const ctxWithPermissions = {
146
+ ...ctx,
147
+ ask: async (req: Omit<PermissionNext.Request, "id" | "sessionID" | "tool">) => {
148
+ for (const pattern of req.patterns) {
149
+ const rule = PermissionNext.evaluate(req.permission, pattern, agent.permission)
150
+ if (rule.action === "deny") {
151
+ throw new PermissionNext.DeniedError(agent.permission)
152
+ }
153
+ }
154
+ },
155
+ }
156
+ const read = await ReadTool.init()
157
+ const promise = read.execute({ filePath: path.join(tmp.path, filename) }, ctxWithPermissions)
158
+ if (blocked) {
159
+ await expect(promise).rejects.toThrow(PermissionNext.DeniedError)
160
+ } else {
161
+ expect((await promise).output).toContain("content")
162
+ }
163
+ },
164
+ })
165
+ })
166
+ })
167
+ })
@@ -0,0 +1,36 @@
1
+ import { describe, expect, test } from "bun:test"
2
+ import { iife } from "../../src/util/iife"
3
+
4
+ describe("util.iife", () => {
5
+ test("should execute function immediately and return result", () => {
6
+ let called = false
7
+ const result = iife(() => {
8
+ called = true
9
+ return 42
10
+ })
11
+
12
+ expect(called).toBe(true)
13
+ expect(result).toBe(42)
14
+ })
15
+
16
+ test("should work with async functions", async () => {
17
+ let called = false
18
+ const result = await iife(async () => {
19
+ called = true
20
+ return "async result"
21
+ })
22
+
23
+ expect(called).toBe(true)
24
+ expect(result).toBe("async result")
25
+ })
26
+
27
+ test("should handle functions with no return value", () => {
28
+ let called = false
29
+ const result = iife(() => {
30
+ called = true
31
+ })
32
+
33
+ expect(called).toBe(true)
34
+ expect(result).toBeUndefined()
35
+ })
36
+ })
@@ -0,0 +1,50 @@
1
+ import { describe, expect, test } from "bun:test"
2
+ import { lazy } from "../../src/util/lazy"
3
+
4
+ describe("util.lazy", () => {
5
+ test("should call function only once", () => {
6
+ let callCount = 0
7
+ const getValue = () => {
8
+ callCount++
9
+ return "expensive value"
10
+ }
11
+
12
+ const lazyValue = lazy(getValue)
13
+
14
+ expect(callCount).toBe(0)
15
+
16
+ const result1 = lazyValue()
17
+ expect(result1).toBe("expensive value")
18
+ expect(callCount).toBe(1)
19
+
20
+ const result2 = lazyValue()
21
+ expect(result2).toBe("expensive value")
22
+ expect(callCount).toBe(1)
23
+ })
24
+
25
+ test("should preserve the same reference", () => {
26
+ const obj = { value: 42 }
27
+ const lazyObj = lazy(() => obj)
28
+
29
+ const result1 = lazyObj()
30
+ const result2 = lazyObj()
31
+
32
+ expect(result1).toBe(obj)
33
+ expect(result2).toBe(obj)
34
+ expect(result1).toBe(result2)
35
+ })
36
+
37
+ test("should work with different return types", () => {
38
+ const lazyString = lazy(() => "string")
39
+ const lazyNumber = lazy(() => 123)
40
+ const lazyBoolean = lazy(() => true)
41
+ const lazyNull = lazy(() => null)
42
+ const lazyUndefined = lazy(() => undefined)
43
+
44
+ expect(lazyString()).toBe("string")
45
+ expect(lazyNumber()).toBe(123)
46
+ expect(lazyBoolean()).toBe(true)
47
+ expect(lazyNull()).toBe(null)
48
+ expect(lazyUndefined()).toBe(undefined)
49
+ })
50
+ })
@@ -0,0 +1,21 @@
1
+ import { describe, expect, test } from "bun:test"
2
+ import { withTimeout } from "../../src/util/timeout"
3
+
4
+ describe("util.timeout", () => {
5
+ test("should resolve when promise completes before timeout", async () => {
6
+ const fastPromise = new Promise<string>((resolve) => {
7
+ setTimeout(() => resolve("fast"), 10)
8
+ })
9
+
10
+ const result = await withTimeout(fastPromise, 100)
11
+ expect(result).toBe("fast")
12
+ })
13
+
14
+ test("should reject when promise exceeds timeout", async () => {
15
+ const slowPromise = new Promise<string>((resolve) => {
16
+ setTimeout(() => resolve("slow"), 200)
17
+ })
18
+
19
+ await expect(withTimeout(slowPromise, 50)).rejects.toThrow("Operation timed out after 50ms")
20
+ })
21
+ })
@@ -0,0 +1,55 @@
1
+ import { test, expect } from "bun:test"
2
+ import { Wildcard } from "../../src/util/wildcard"
3
+
4
+ test("match handles glob tokens", () => {
5
+ expect(Wildcard.match("file1.txt", "file?.txt")).toBe(true)
6
+ expect(Wildcard.match("file12.txt", "file?.txt")).toBe(false)
7
+ expect(Wildcard.match("foo+bar", "foo+bar")).toBe(true)
8
+ })
9
+
10
+ test("all picks the most specific pattern", () => {
11
+ const rules = {
12
+ "*": "deny",
13
+ "git *": "ask",
14
+ "git status": "allow",
15
+ }
16
+ expect(Wildcard.all("git status", rules)).toBe("allow")
17
+ expect(Wildcard.all("git log", rules)).toBe("ask")
18
+ expect(Wildcard.all("echo hi", rules)).toBe("deny")
19
+ })
20
+
21
+ test("allStructured matches command sequences", () => {
22
+ const rules = {
23
+ "git *": "ask",
24
+ "git status*": "allow",
25
+ }
26
+ expect(Wildcard.allStructured({ head: "git", tail: ["status", "--short"] }, rules)).toBe("allow")
27
+ expect(Wildcard.allStructured({ head: "npm", tail: ["run", "build", "--watch"] }, { "npm run *": "allow" })).toBe(
28
+ "allow",
29
+ )
30
+ expect(Wildcard.allStructured({ head: "ls", tail: ["-la"] }, rules)).toBeUndefined()
31
+ })
32
+
33
+ test("allStructured prioritizes flag-specific patterns", () => {
34
+ const rules = {
35
+ "find *": "allow",
36
+ "find * -delete*": "ask",
37
+ "sort*": "allow",
38
+ "sort -o *": "ask",
39
+ }
40
+ expect(Wildcard.allStructured({ head: "find", tail: ["src", "-delete"] }, rules)).toBe("ask")
41
+ expect(Wildcard.allStructured({ head: "find", tail: ["src", "-print"] }, rules)).toBe("allow")
42
+ expect(Wildcard.allStructured({ head: "sort", tail: ["-o", "out.txt"] }, rules)).toBe("ask")
43
+ expect(Wildcard.allStructured({ head: "sort", tail: ["--reverse"] }, rules)).toBe("allow")
44
+ })
45
+
46
+ test("allStructured handles sed flags", () => {
47
+ const rules = {
48
+ "sed * -i*": "ask",
49
+ "sed -n*": "allow",
50
+ }
51
+ expect(Wildcard.allStructured({ head: "sed", tail: ["-i", "file"] }, rules)).toBe("ask")
52
+ expect(Wildcard.allStructured({ head: "sed", tail: ["-i.bak", "file"] }, rules)).toBe("ask")
53
+ expect(Wildcard.allStructured({ head: "sed", tail: ["-n", "1p", "file"] }, rules)).toBe("allow")
54
+ expect(Wildcard.allStructured({ head: "sed", tail: ["-i", "-n", "/./p", "myfile.txt"] }, rules)).toBe("ask")
55
+ })
package/tsconfig.json ADDED
@@ -0,0 +1,16 @@
1
+ {
2
+ "$schema": "https://json.schemastore.org/tsconfig",
3
+ "extends": "@tsconfig/bun/tsconfig.json",
4
+ "compilerOptions": {
5
+ "jsx": "preserve",
6
+ "jsxImportSource": "@opentui/solid",
7
+ "lib": ["ESNext", "DOM", "DOM.Iterable"],
8
+ "types": [],
9
+ "noUncheckedIndexedAccess": false,
10
+ "customConditions": ["browser"],
11
+ "paths": {
12
+ "@/*": ["./src/*"],
13
+ "@tui/*": ["./src/cli/cmd/tui/*"]
14
+ }
15
+ }
16
+ }