@dirgha/code 1.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (360) hide show
  1. package/LICENSE +101 -0
  2. package/README.md +674 -0
  3. package/dist/dirgha.mjs +2185 -0
  4. package/dist_v2/acp/index.d.ts +1 -0
  5. package/dist_v2/acp/index.js +2 -0
  6. package/dist_v2/acp/server.d.ts +31 -0
  7. package/dist_v2/acp/server.js +137 -0
  8. package/dist_v2/cli/auth-cmd.d.ts +10 -0
  9. package/dist_v2/cli/auth-cmd.js +69 -0
  10. package/dist_v2/cli/config.d.ts +46 -0
  11. package/dist_v2/cli/config.js +70 -0
  12. package/dist_v2/cli/flags.d.ts +10 -0
  13. package/dist_v2/cli/flags.js +49 -0
  14. package/dist_v2/cli/flows/full-cycle.d.ts +30 -0
  15. package/dist_v2/cli/flows/full-cycle.js +39 -0
  16. package/dist_v2/cli/flows/index.d.ts +2 -0
  17. package/dist_v2/cli/flows/index.js +3 -0
  18. package/dist_v2/cli/flows/tarball.d.ts +10 -0
  19. package/dist_v2/cli/flows/tarball.js +47 -0
  20. package/dist_v2/cli/index.d.ts +4 -0
  21. package/dist_v2/cli/index.js +5 -0
  22. package/dist_v2/cli/interactive.d.ts +21 -0
  23. package/dist_v2/cli/interactive.js +207 -0
  24. package/dist_v2/cli/main.d.ts +10 -0
  25. package/dist_v2/cli/main.js +173 -0
  26. package/dist_v2/cli/models-cmd.d.ts +6 -0
  27. package/dist_v2/cli/models-cmd.js +50 -0
  28. package/dist_v2/cli/setup.d.ts +13 -0
  29. package/dist_v2/cli/setup.js +128 -0
  30. package/dist_v2/cli/slash/account.d.ts +10 -0
  31. package/dist_v2/cli/slash/account.js +59 -0
  32. package/dist_v2/cli/slash/clear.d.ts +8 -0
  33. package/dist_v2/cli/slash/clear.js +15 -0
  34. package/dist_v2/cli/slash/compact.d.ts +7 -0
  35. package/dist_v2/cli/slash/compact.js +13 -0
  36. package/dist_v2/cli/slash/config.d.ts +8 -0
  37. package/dist_v2/cli/slash/config.js +49 -0
  38. package/dist_v2/cli/slash/exit.d.ts +7 -0
  39. package/dist_v2/cli/slash/exit.js +16 -0
  40. package/dist_v2/cli/slash/fleet.d.ts +7 -0
  41. package/dist_v2/cli/slash/fleet.js +22 -0
  42. package/dist_v2/cli/slash/help.d.ts +9 -0
  43. package/dist_v2/cli/slash/help.js +31 -0
  44. package/dist_v2/cli/slash/history.d.ts +7 -0
  45. package/dist_v2/cli/slash/history.js +42 -0
  46. package/dist_v2/cli/slash/index.d.ts +30 -0
  47. package/dist_v2/cli/slash/index.js +52 -0
  48. package/dist_v2/cli/slash/init.d.ts +8 -0
  49. package/dist_v2/cli/slash/init.js +57 -0
  50. package/dist_v2/cli/slash/keys.d.ts +8 -0
  51. package/dist_v2/cli/slash/keys.js +101 -0
  52. package/dist_v2/cli/slash/login.d.ts +10 -0
  53. package/dist_v2/cli/slash/login.js +47 -0
  54. package/dist_v2/cli/slash/memory.d.ts +8 -0
  55. package/dist_v2/cli/slash/memory.js +101 -0
  56. package/dist_v2/cli/slash/mode.d.ts +8 -0
  57. package/dist_v2/cli/slash/mode.js +30 -0
  58. package/dist_v2/cli/slash/models.d.ts +8 -0
  59. package/dist_v2/cli/slash/models.js +73 -0
  60. package/dist_v2/cli/slash/resume.d.ts +8 -0
  61. package/dist_v2/cli/slash/resume.js +24 -0
  62. package/dist_v2/cli/slash/session.d.ts +8 -0
  63. package/dist_v2/cli/slash/session.js +74 -0
  64. package/dist_v2/cli/slash/setup.d.ts +8 -0
  65. package/dist_v2/cli/slash/setup.js +50 -0
  66. package/dist_v2/cli/slash/status.d.ts +7 -0
  67. package/dist_v2/cli/slash/status.js +37 -0
  68. package/dist_v2/cli/slash/theme.d.ts +9 -0
  69. package/dist_v2/cli/slash/theme.js +53 -0
  70. package/dist_v2/cli/slash/types.d.ts +14 -0
  71. package/dist_v2/cli/slash/types.js +9 -0
  72. package/dist_v2/cli/slash/upgrade.d.ts +9 -0
  73. package/dist_v2/cli/slash/upgrade.js +66 -0
  74. package/dist_v2/cli/slash.d.ts +72 -0
  75. package/dist_v2/cli/slash.js +77 -0
  76. package/dist_v2/cli/subcommands/ask.d.ts +17 -0
  77. package/dist_v2/cli/subcommands/ask.js +76 -0
  78. package/dist_v2/cli/subcommands/audit.d.ts +15 -0
  79. package/dist_v2/cli/subcommands/audit.js +128 -0
  80. package/dist_v2/cli/subcommands/chat.d.ts +13 -0
  81. package/dist_v2/cli/subcommands/chat.js +72 -0
  82. package/dist_v2/cli/subcommands/compact.d.ts +14 -0
  83. package/dist_v2/cli/subcommands/compact.js +114 -0
  84. package/dist_v2/cli/subcommands/doctor.d.ts +11 -0
  85. package/dist_v2/cli/subcommands/doctor.js +103 -0
  86. package/dist_v2/cli/subcommands/export-session.d.ts +10 -0
  87. package/dist_v2/cli/subcommands/export-session.js +60 -0
  88. package/dist_v2/cli/subcommands/import-session.d.ts +11 -0
  89. package/dist_v2/cli/subcommands/import-session.js +77 -0
  90. package/dist_v2/cli/subcommands/index.d.ts +40 -0
  91. package/dist_v2/cli/subcommands/index.js +38 -0
  92. package/dist_v2/cli/subcommands/init.d.ts +10 -0
  93. package/dist_v2/cli/subcommands/init.js +74 -0
  94. package/dist_v2/cli/subcommands/keys.d.ts +12 -0
  95. package/dist_v2/cli/subcommands/keys.js +136 -0
  96. package/dist_v2/cli/subcommands/login.d.ts +10 -0
  97. package/dist_v2/cli/subcommands/login.js +60 -0
  98. package/dist_v2/cli/subcommands/logout.d.ts +10 -0
  99. package/dist_v2/cli/subcommands/logout.js +21 -0
  100. package/dist_v2/cli/subcommands/models.d.ts +14 -0
  101. package/dist_v2/cli/subcommands/models.js +144 -0
  102. package/dist_v2/cli/subcommands/setup.d.ts +11 -0
  103. package/dist_v2/cli/subcommands/setup.js +107 -0
  104. package/dist_v2/cli/subcommands/stats.d.ts +13 -0
  105. package/dist_v2/cli/subcommands/stats.js +148 -0
  106. package/dist_v2/cli/subcommands/status.d.ts +14 -0
  107. package/dist_v2/cli/subcommands/status.js +91 -0
  108. package/dist_v2/cli/submit-paper.d.ts +15 -0
  109. package/dist_v2/cli/submit-paper.js +68 -0
  110. package/dist_v2/context/_fts.d.ts +62 -0
  111. package/dist_v2/context/_fts.js +195 -0
  112. package/dist_v2/context/branch.d.ts +18 -0
  113. package/dist_v2/context/branch.js +66 -0
  114. package/dist_v2/context/compaction.d.ts +26 -0
  115. package/dist_v2/context/compaction.js +120 -0
  116. package/dist_v2/context/index.d.ts +5 -0
  117. package/dist_v2/context/index.js +6 -0
  118. package/dist_v2/context/knowledge.d.ts +38 -0
  119. package/dist_v2/context/knowledge.js +146 -0
  120. package/dist_v2/context/memory.d.ts +80 -0
  121. package/dist_v2/context/memory.js +276 -0
  122. package/dist_v2/context/mode.d.ts +25 -0
  123. package/dist_v2/context/mode.js +81 -0
  124. package/dist_v2/context/session.d.ts +56 -0
  125. package/dist_v2/context/session.js +108 -0
  126. package/dist_v2/daemon/index.d.ts +2 -0
  127. package/dist_v2/daemon/index.js +3 -0
  128. package/dist_v2/daemon/protocol.d.ts +73 -0
  129. package/dist_v2/daemon/protocol.js +6 -0
  130. package/dist_v2/daemon/server.d.ts +35 -0
  131. package/dist_v2/daemon/server.js +191 -0
  132. package/dist_v2/eval/index.d.ts +5 -0
  133. package/dist_v2/eval/index.js +6 -0
  134. package/dist_v2/eval/regression.d.ts +14 -0
  135. package/dist_v2/eval/regression.js +106 -0
  136. package/dist_v2/eval/reporter.d.ts +7 -0
  137. package/dist_v2/eval/reporter.js +34 -0
  138. package/dist_v2/eval/swe-bench.d.ts +18 -0
  139. package/dist_v2/eval/swe-bench.js +23 -0
  140. package/dist_v2/eval/terminal-bench.d.ts +13 -0
  141. package/dist_v2/eval/terminal-bench.js +19 -0
  142. package/dist_v2/eval/types.d.ts +36 -0
  143. package/dist_v2/eval/types.js +5 -0
  144. package/dist_v2/fleet/apply-back.d.ts +27 -0
  145. package/dist_v2/fleet/apply-back.js +191 -0
  146. package/dist_v2/fleet/cli-command.d.ts +61 -0
  147. package/dist_v2/fleet/cli-command.js +329 -0
  148. package/dist_v2/fleet/index.d.ts +21 -0
  149. package/dist_v2/fleet/index.js +21 -0
  150. package/dist_v2/fleet/runner.d.ts +28 -0
  151. package/dist_v2/fleet/runner.js +347 -0
  152. package/dist_v2/fleet/tripleshot.d.ts +21 -0
  153. package/dist_v2/fleet/tripleshot.js +222 -0
  154. package/dist_v2/fleet/types.d.ts +193 -0
  155. package/dist_v2/fleet/types.js +24 -0
  156. package/dist_v2/fleet/worktree.d.ts +51 -0
  157. package/dist_v2/fleet/worktree.js +176 -0
  158. package/dist_v2/hooks/index.d.ts +1 -0
  159. package/dist_v2/hooks/index.js +2 -0
  160. package/dist_v2/hooks/registry.d.ts +21 -0
  161. package/dist_v2/hooks/registry.js +40 -0
  162. package/dist_v2/index.d.ts +12 -0
  163. package/dist_v2/index.js +11 -0
  164. package/dist_v2/integrations/arniko-client.d.ts +42 -0
  165. package/dist_v2/integrations/arniko-client.js +86 -0
  166. package/dist_v2/integrations/auth.d.ts +45 -0
  167. package/dist_v2/integrations/auth.js +54 -0
  168. package/dist_v2/integrations/billing.d.ts +71 -0
  169. package/dist_v2/integrations/billing.js +107 -0
  170. package/dist_v2/integrations/bucky-client.d.ts +105 -0
  171. package/dist_v2/integrations/bucky-client.js +76 -0
  172. package/dist_v2/integrations/deploy-client.d.ts +60 -0
  173. package/dist_v2/integrations/deploy-client.js +87 -0
  174. package/dist_v2/integrations/device-auth.d.ts +48 -0
  175. package/dist_v2/integrations/device-auth.js +192 -0
  176. package/dist_v2/integrations/entitlements.d.ts +34 -0
  177. package/dist_v2/integrations/entitlements.js +43 -0
  178. package/dist_v2/integrations/http.d.ts +22 -0
  179. package/dist_v2/integrations/http.js +114 -0
  180. package/dist_v2/integrations/index.d.ts +8 -0
  181. package/dist_v2/integrations/index.js +15 -0
  182. package/dist_v2/intelligence/cost.d.ts +28 -0
  183. package/dist_v2/intelligence/cost.js +58 -0
  184. package/dist_v2/intelligence/error-classifier.d.ts +8 -0
  185. package/dist_v2/intelligence/error-classifier.js +71 -0
  186. package/dist_v2/intelligence/index.d.ts +5 -0
  187. package/dist_v2/intelligence/index.js +6 -0
  188. package/dist_v2/intelligence/prices.d.ts +13 -0
  189. package/dist_v2/intelligence/prices.js +26 -0
  190. package/dist_v2/intelligence/smart-router.d.ts +21 -0
  191. package/dist_v2/intelligence/smart-router.js +59 -0
  192. package/dist_v2/intelligence/telemetry.d.ts +22 -0
  193. package/dist_v2/intelligence/telemetry.js +31 -0
  194. package/dist_v2/kernel/agent-loop.d.ts +32 -0
  195. package/dist_v2/kernel/agent-loop.js +151 -0
  196. package/dist_v2/kernel/event-stream.d.ts +18 -0
  197. package/dist_v2/kernel/event-stream.js +102 -0
  198. package/dist_v2/kernel/index.d.ts +4 -0
  199. package/dist_v2/kernel/index.js +5 -0
  200. package/dist_v2/kernel/message.d.ts +29 -0
  201. package/dist_v2/kernel/message.js +118 -0
  202. package/dist_v2/kernel/types.d.ts +206 -0
  203. package/dist_v2/kernel/types.js +9 -0
  204. package/dist_v2/mcp/client.d.ts +44 -0
  205. package/dist_v2/mcp/client.js +63 -0
  206. package/dist_v2/mcp/index.d.ts +3 -0
  207. package/dist_v2/mcp/index.js +4 -0
  208. package/dist_v2/mcp/tool-bridge.d.ts +11 -0
  209. package/dist_v2/mcp/tool-bridge.js +33 -0
  210. package/dist_v2/mcp/transport.d.ts +29 -0
  211. package/dist_v2/mcp/transport.js +73 -0
  212. package/dist_v2/parity/index.d.ts +3 -0
  213. package/dist_v2/parity/index.js +4 -0
  214. package/dist_v2/parity/mock-openai-compat.d.ts +15 -0
  215. package/dist_v2/parity/mock-openai-compat.js +35 -0
  216. package/dist_v2/parity/runner.d.ts +21 -0
  217. package/dist_v2/parity/runner.js +76 -0
  218. package/dist_v2/parity/scenarios.d.ts +20 -0
  219. package/dist_v2/parity/scenarios.js +70 -0
  220. package/dist_v2/providers/anthropic.d.ts +21 -0
  221. package/dist_v2/providers/anthropic.js +191 -0
  222. package/dist_v2/providers/dispatch.d.ts +11 -0
  223. package/dist_v2/providers/dispatch.js +45 -0
  224. package/dist_v2/providers/fireworks.d.ts +18 -0
  225. package/dist_v2/providers/fireworks.js +44 -0
  226. package/dist_v2/providers/gemini.d.ts +19 -0
  227. package/dist_v2/providers/gemini.js +188 -0
  228. package/dist_v2/providers/http.d.ts +41 -0
  229. package/dist_v2/providers/http.js +188 -0
  230. package/dist_v2/providers/iface.d.ts +18 -0
  231. package/dist_v2/providers/iface.js +18 -0
  232. package/dist_v2/providers/index.d.ts +39 -0
  233. package/dist_v2/providers/index.js +51 -0
  234. package/dist_v2/providers/nvidia.d.ts +27 -0
  235. package/dist_v2/providers/nvidia.js +142 -0
  236. package/dist_v2/providers/ollama.d.ts +15 -0
  237. package/dist_v2/providers/ollama.js +37 -0
  238. package/dist_v2/providers/openai-compat.d.ts +29 -0
  239. package/dist_v2/providers/openai-compat.js +239 -0
  240. package/dist_v2/providers/openai.d.ts +20 -0
  241. package/dist_v2/providers/openai.js +107 -0
  242. package/dist_v2/providers/openrouter.d.ts +24 -0
  243. package/dist_v2/providers/openrouter.js +69 -0
  244. package/dist_v2/safety/approval-bus.d.ts +26 -0
  245. package/dist_v2/safety/approval-bus.js +48 -0
  246. package/dist_v2/safety/audit-log.d.ts +27 -0
  247. package/dist_v2/safety/audit-log.js +71 -0
  248. package/dist_v2/safety/index.d.ts +4 -0
  249. package/dist_v2/safety/index.js +5 -0
  250. package/dist_v2/safety/policy.d.ts +32 -0
  251. package/dist_v2/safety/policy.js +131 -0
  252. package/dist_v2/safety/sandbox/bwrap.d.ts +11 -0
  253. package/dist_v2/safety/sandbox/bwrap.js +52 -0
  254. package/dist_v2/safety/sandbox/iface.d.ts +29 -0
  255. package/dist_v2/safety/sandbox/iface.js +8 -0
  256. package/dist_v2/safety/sandbox/index.d.ts +7 -0
  257. package/dist_v2/safety/sandbox/index.js +8 -0
  258. package/dist_v2/safety/sandbox/landlock.d.ts +17 -0
  259. package/dist_v2/safety/sandbox/landlock.js +26 -0
  260. package/dist_v2/safety/sandbox/noop.d.ts +12 -0
  261. package/dist_v2/safety/sandbox/noop.js +52 -0
  262. package/dist_v2/safety/sandbox/seatbelt.d.ts +11 -0
  263. package/dist_v2/safety/sandbox/seatbelt.js +49 -0
  264. package/dist_v2/safety/sandbox/select.d.ts +6 -0
  265. package/dist_v2/safety/sandbox/select.js +42 -0
  266. package/dist_v2/safety/sandbox/windows.d.ts +13 -0
  267. package/dist_v2/safety/sandbox/windows.js +22 -0
  268. package/dist_v2/skills/index.d.ts +3 -0
  269. package/dist_v2/skills/index.js +4 -0
  270. package/dist_v2/skills/loader.d.ts +38 -0
  271. package/dist_v2/skills/loader.js +102 -0
  272. package/dist_v2/skills/matcher.d.ts +14 -0
  273. package/dist_v2/skills/matcher.js +72 -0
  274. package/dist_v2/skills/runtime.d.ts +13 -0
  275. package/dist_v2/skills/runtime.js +40 -0
  276. package/dist_v2/subagents/delegator.d.ts +36 -0
  277. package/dist_v2/subagents/delegator.js +82 -0
  278. package/dist_v2/subagents/index.d.ts +2 -0
  279. package/dist_v2/subagents/index.js +3 -0
  280. package/dist_v2/subagents/pool.d.ts +18 -0
  281. package/dist_v2/subagents/pool.js +31 -0
  282. package/dist_v2/tools/browser.d.ts +27 -0
  283. package/dist_v2/tools/browser.js +179 -0
  284. package/dist_v2/tools/checkpoint.d.ts +25 -0
  285. package/dist_v2/tools/checkpoint.js +222 -0
  286. package/dist_v2/tools/cron.d.ts +32 -0
  287. package/dist_v2/tools/cron.js +160 -0
  288. package/dist_v2/tools/diff.d.ts +18 -0
  289. package/dist_v2/tools/diff.js +117 -0
  290. package/dist_v2/tools/exec.d.ts +19 -0
  291. package/dist_v2/tools/exec.js +49 -0
  292. package/dist_v2/tools/fs-edit.d.ts +11 -0
  293. package/dist_v2/tools/fs-edit.js +81 -0
  294. package/dist_v2/tools/fs-ls.d.ts +7 -0
  295. package/dist_v2/tools/fs-ls.js +57 -0
  296. package/dist_v2/tools/fs-read.d.ts +7 -0
  297. package/dist_v2/tools/fs-read.js +60 -0
  298. package/dist_v2/tools/fs-write.d.ts +8 -0
  299. package/dist_v2/tools/fs-write.js +46 -0
  300. package/dist_v2/tools/git.d.ts +8 -0
  301. package/dist_v2/tools/git.js +57 -0
  302. package/dist_v2/tools/index.d.ts +25 -0
  303. package/dist_v2/tools/index.js +39 -0
  304. package/dist_v2/tools/multimodal.d.ts +41 -0
  305. package/dist_v2/tools/multimodal.js +381 -0
  306. package/dist_v2/tools/permission.d.ts +27 -0
  307. package/dist_v2/tools/permission.js +43 -0
  308. package/dist_v2/tools/registry.d.ts +44 -0
  309. package/dist_v2/tools/registry.js +62 -0
  310. package/dist_v2/tools/search-glob.d.ts +7 -0
  311. package/dist_v2/tools/search-glob.js +98 -0
  312. package/dist_v2/tools/search-grep.d.ts +7 -0
  313. package/dist_v2/tools/search-grep.js +109 -0
  314. package/dist_v2/tools/shell.d.ts +10 -0
  315. package/dist_v2/tools/shell.js +76 -0
  316. package/dist_v2/tools/task.d.ts +8 -0
  317. package/dist_v2/tools/task.js +37 -0
  318. package/dist_v2/tui/approval.d.ts +7 -0
  319. package/dist_v2/tui/approval.js +55 -0
  320. package/dist_v2/tui/index.d.ts +4 -0
  321. package/dist_v2/tui/index.js +5 -0
  322. package/dist_v2/tui/ink/App.d.ts +39 -0
  323. package/dist_v2/tui/ink/App.js +206 -0
  324. package/dist_v2/tui/ink/components/AtFileComplete.d.ts +25 -0
  325. package/dist_v2/tui/ink/components/AtFileComplete.js +158 -0
  326. package/dist_v2/tui/ink/components/HelpOverlay.d.ts +24 -0
  327. package/dist_v2/tui/ink/components/HelpOverlay.js +130 -0
  328. package/dist_v2/tui/ink/components/InputBox.d.ts +35 -0
  329. package/dist_v2/tui/ink/components/InputBox.js +153 -0
  330. package/dist_v2/tui/ink/components/Logo.d.ts +12 -0
  331. package/dist_v2/tui/ink/components/Logo.js +27 -0
  332. package/dist_v2/tui/ink/components/ModelPicker.d.ts +26 -0
  333. package/dist_v2/tui/ink/components/ModelPicker.js +80 -0
  334. package/dist_v2/tui/ink/components/PasteCollapse.d.ts +36 -0
  335. package/dist_v2/tui/ink/components/PasteCollapse.js +59 -0
  336. package/dist_v2/tui/ink/components/StatusBar.d.ts +18 -0
  337. package/dist_v2/tui/ink/components/StatusBar.js +41 -0
  338. package/dist_v2/tui/ink/components/StreamingText.d.ts +14 -0
  339. package/dist_v2/tui/ink/components/StreamingText.js +11 -0
  340. package/dist_v2/tui/ink/components/ThinkingBlock.d.ts +13 -0
  341. package/dist_v2/tui/ink/components/ThinkingBlock.js +13 -0
  342. package/dist_v2/tui/ink/components/ToolBox.d.ts +20 -0
  343. package/dist_v2/tui/ink/components/ToolBox.js +63 -0
  344. package/dist_v2/tui/ink/components/vim-bindings.d.ts +43 -0
  345. package/dist_v2/tui/ink/components/vim-bindings.js +135 -0
  346. package/dist_v2/tui/ink/index.d.ts +39 -0
  347. package/dist_v2/tui/ink/index.js +47 -0
  348. package/dist_v2/tui/ink/use-event-projection.d.ts +51 -0
  349. package/dist_v2/tui/ink/use-event-projection.js +126 -0
  350. package/dist_v2/tui/ink/use-overlays.d.ts +24 -0
  351. package/dist_v2/tui/ink/use-overlays.js +50 -0
  352. package/dist_v2/tui/renderer.d.ts +19 -0
  353. package/dist_v2/tui/renderer.js +64 -0
  354. package/dist_v2/tui/status-bar.d.ts +12 -0
  355. package/dist_v2/tui/status-bar.js +16 -0
  356. package/dist_v2/tui/theme.d.ts +27 -0
  357. package/dist_v2/tui/theme.js +56 -0
  358. package/dist_v2/utils/json-repair.d.ts +7 -0
  359. package/dist_v2/utils/json-repair.js +45 -0
  360. package/package.json +113 -0
@@ -0,0 +1,81 @@
1
+ /**
2
+ * String-replace edit with exact and fuzzy matching.
3
+ *
4
+ * Exact match is the fast path. When the exact string is missing, the
5
+ * tool falls back to whitespace-normalised matching and, if still
6
+ * ambiguous, returns an error with the candidate contexts so the agent
7
+ * can retry with more specific anchors. This is deterministic and
8
+ * auditable — no "nearest fuzzy match" guessing.
9
+ */
10
+ import { readFile, stat, writeFile } from 'node:fs/promises';
11
+ import { resolve } from 'node:path';
12
+ import { summariseDiff, unifiedDiff } from './diff.js';
13
+ export const fsEditTool = {
14
+ name: 'fs_edit',
15
+ description: 'Replace an exact substring in a file. Fails on ambiguity (multiple matches) unless replaceAll is set. Use larger context around oldString to disambiguate.',
16
+ inputSchema: {
17
+ type: 'object',
18
+ properties: {
19
+ path: { type: 'string' },
20
+ oldString: { type: 'string' },
21
+ newString: { type: 'string' },
22
+ replaceAll: { type: 'boolean' },
23
+ },
24
+ required: ['path', 'oldString', 'newString'],
25
+ },
26
+ requiresApproval: () => true,
27
+ async execute(rawInput, ctx) {
28
+ const input = rawInput;
29
+ const abs = resolve(ctx.cwd, input.path);
30
+ const info = await stat(abs).catch(() => undefined);
31
+ if (!info || !info.isFile())
32
+ return { content: `No such file: ${input.path}`, isError: true };
33
+ const before = await readFile(abs, 'utf8');
34
+ if (input.oldString === input.newString) {
35
+ return { content: 'oldString and newString are identical; nothing to do.', isError: true };
36
+ }
37
+ const exactCount = countOccurrences(before, input.oldString);
38
+ if (exactCount === 0) {
39
+ return {
40
+ content: `oldString not found in ${input.path}. Provide more surrounding context or verify the file.`,
41
+ isError: true,
42
+ };
43
+ }
44
+ if (exactCount > 1 && !input.replaceAll) {
45
+ return {
46
+ content: `oldString matches ${exactCount} locations. Set replaceAll=true, or include more context to disambiguate.`,
47
+ isError: true,
48
+ };
49
+ }
50
+ const after = input.replaceAll
51
+ ? splitJoin(before, input.oldString, input.newString)
52
+ : before.replace(input.oldString, input.newString);
53
+ const diff = unifiedDiff(before, after, { fromLabel: input.path, toLabel: input.path });
54
+ const { added, removed } = summariseDiff(diff);
55
+ await writeFile(abs, after, 'utf8');
56
+ return {
57
+ content: `Edited ${input.path}: ${input.replaceAll ? exactCount : 1} replacement(s) (+${added} / -${removed})`,
58
+ data: { replacements: input.replaceAll ? exactCount : 1, added, removed },
59
+ isError: false,
60
+ metadata: { diff },
61
+ };
62
+ },
63
+ };
64
+ function countOccurrences(haystack, needle) {
65
+ if (needle.length === 0)
66
+ return 0;
67
+ let count = 0;
68
+ let idx = 0;
69
+ for (;;) {
70
+ const found = haystack.indexOf(needle, idx);
71
+ if (found < 0)
72
+ break;
73
+ count++;
74
+ idx = found + needle.length;
75
+ }
76
+ return count;
77
+ }
78
+ function splitJoin(haystack, needle, replacement) {
79
+ return haystack.split(needle).join(replacement);
80
+ }
81
+ //# sourceMappingURL=fs-edit.js.map
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Directory listing, one level deep. Emits a terse `kind name [size]`
3
+ * table so the model has a clear picture of directory contents without
4
+ * spending tokens on noisy metadata.
5
+ */
6
+ import type { Tool } from './registry.js';
7
+ export declare const fsLsTool: Tool;
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Directory listing, one level deep. Emits a terse `kind name [size]`
3
+ * table so the model has a clear picture of directory contents without
4
+ * spending tokens on noisy metadata.
5
+ */
6
+ import { readdir, stat } from 'node:fs/promises';
7
+ import { resolve } from 'node:path';
8
+ // Paths where a blind fs_ls is almost never what the user actually
9
+ // wanted. Typing `fs_ls .` at / or /root spills 100+ unrelated entries
10
+ // into the model's context for no gain. Force a narrower ask.
11
+ const HUGE_ROOTS = new Set(['/', '/root', '/home', '/tmp', '/Users', '/var']);
12
+ export const fsLsTool = {
13
+ name: 'fs_ls',
14
+ description: 'List the entries of a directory, one level deep.',
15
+ inputSchema: {
16
+ type: 'object',
17
+ properties: {
18
+ path: { type: 'string', description: 'Directory to list. Defaults to cwd.' },
19
+ includeHidden: { type: 'boolean', description: 'Include dotfiles.' },
20
+ },
21
+ },
22
+ async execute(rawInput, ctx) {
23
+ const input = rawInput;
24
+ const target = resolve(ctx.cwd, input.path ?? '.');
25
+ if (HUGE_ROOTS.has(target)) {
26
+ return {
27
+ content: `Refusing to list ${target} — too broad. Supply a narrower path, or use search_glob / search_grep with a targeted pattern.`,
28
+ isError: true,
29
+ };
30
+ }
31
+ const info = await stat(target).catch(() => undefined);
32
+ if (!info || !info.isDirectory())
33
+ return { content: `Not a directory: ${input.path ?? '.'}`, isError: true };
34
+ const names = await readdir(target);
35
+ const visible = input.includeHidden ? names : names.filter(n => !n.startsWith('.'));
36
+ visible.sort();
37
+ const rows = [];
38
+ for (const name of visible) {
39
+ const child = resolve(target, name);
40
+ const s = await stat(child).catch(() => undefined);
41
+ if (!s)
42
+ continue;
43
+ if (s.isDirectory())
44
+ rows.push(`dir ${name}/`);
45
+ else if (s.isFile())
46
+ rows.push(`file ${name}\t${s.size}`);
47
+ else
48
+ rows.push(`other ${name}`);
49
+ }
50
+ return {
51
+ content: rows.length > 0 ? rows.join('\n') : '(empty directory)',
52
+ data: { entries: rows.length },
53
+ isError: false,
54
+ };
55
+ },
56
+ };
57
+ //# sourceMappingURL=fs-ls.js.map
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Read a file from disk with optional offset/limit windowing. Binary
3
+ * files are rejected with a clear message; line-based windowing uses
4
+ * cat -n style numbering so the model can cite line numbers reliably.
5
+ */
6
+ import type { Tool } from './registry.js';
7
+ export declare const fsReadTool: Tool;
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Read a file from disk with optional offset/limit windowing. Binary
3
+ * files are rejected with a clear message; line-based windowing uses
4
+ * cat -n style numbering so the model can cite line numbers reliably.
5
+ */
6
+ import { readFile, stat } from 'node:fs/promises';
7
+ import { resolve } from 'node:path';
8
+ const MAX_BYTES = 2 * 1024 * 1024;
9
+ export const fsReadTool = {
10
+ name: 'fs_read',
11
+ description: 'Read a text file from disk. Returns contents with 1-based line numbers. Use offset/limit to page through large files.',
12
+ inputSchema: {
13
+ type: 'object',
14
+ properties: {
15
+ path: { type: 'string', description: 'Absolute or cwd-relative path to the file.' },
16
+ offset: { type: 'integer', minimum: 0, description: 'Line number to start from (0-based).' },
17
+ limit: { type: 'integer', minimum: 1, description: 'Maximum number of lines to return.' },
18
+ },
19
+ required: ['path'],
20
+ },
21
+ async execute(rawInput, ctx) {
22
+ const input = rawInput;
23
+ const abs = resolve(ctx.cwd, input.path);
24
+ const info = await stat(abs).catch(() => undefined);
25
+ if (!info)
26
+ return { content: `No such file: ${input.path}`, isError: true };
27
+ if (!info.isFile())
28
+ return { content: `Not a file: ${input.path}`, isError: true };
29
+ if (info.size > MAX_BYTES) {
30
+ return { content: `File too large (${info.size} bytes, max ${MAX_BYTES}). Use offset/limit.`, isError: true };
31
+ }
32
+ const buffer = await readFile(abs);
33
+ if (isBinary(buffer))
34
+ return { content: `File appears to be binary: ${input.path}`, isError: true };
35
+ const text = buffer.toString('utf8');
36
+ const lines = text.split('\n');
37
+ const offset = input.offset ?? 0;
38
+ const limit = input.limit ?? lines.length;
39
+ const window = lines.slice(offset, offset + limit);
40
+ const numbered = window
41
+ .map((line, idx) => `${String(offset + idx + 1).padStart(6)}\t${line}`)
42
+ .join('\n');
43
+ const truncated = offset + window.length < lines.length;
44
+ return {
45
+ content: numbered,
46
+ data: { lines: window.length, truncated },
47
+ isError: false,
48
+ metadata: { totalLines: lines.length, offset, limit },
49
+ };
50
+ },
51
+ };
52
+ function isBinary(buf) {
53
+ const sample = buf.subarray(0, Math.min(buf.length, 8192));
54
+ for (const byte of sample) {
55
+ if (byte === 0)
56
+ return true;
57
+ }
58
+ return false;
59
+ }
60
+ //# sourceMappingURL=fs-read.js.map
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Write a file to disk, creating parent directories as needed.
3
+ * Returns a unified diff summary so the approval UI can preview the
4
+ * change. Refuses to silently overwrite: the description declares the
5
+ * overwrite contract.
6
+ */
7
+ import type { Tool } from './registry.js';
8
+ export declare const fsWriteTool: Tool;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * Write a file to disk, creating parent directories as needed.
3
+ * Returns a unified diff summary so the approval UI can preview the
4
+ * change. Refuses to silently overwrite: the description declares the
5
+ * overwrite contract.
6
+ */
7
+ import { mkdir, readFile, stat, writeFile } from 'node:fs/promises';
8
+ import { dirname, resolve } from 'node:path';
9
+ import { summariseDiff, unifiedDiff } from './diff.js';
10
+ export const fsWriteTool = {
11
+ name: 'fs_write',
12
+ description: 'Write content to a file. Creates parent directories when createDirs is true. Overwrites existing files.',
13
+ inputSchema: {
14
+ type: 'object',
15
+ properties: {
16
+ path: { type: 'string' },
17
+ content: { type: 'string' },
18
+ createDirs: { type: 'boolean', description: 'Create parent directories if they do not exist.' },
19
+ },
20
+ required: ['path', 'content'],
21
+ },
22
+ requiresApproval: () => true,
23
+ async execute(rawInput, ctx) {
24
+ const input = rawInput;
25
+ const abs = resolve(ctx.cwd, input.path);
26
+ let before = '';
27
+ const existed = await stat(abs).then(() => true).catch(() => false);
28
+ if (existed)
29
+ before = await readFile(abs, 'utf8');
30
+ else if (input.createDirs)
31
+ await mkdir(dirname(abs), { recursive: true });
32
+ const diff = unifiedDiff(before, input.content, { fromLabel: input.path, toLabel: input.path });
33
+ const { added, removed } = summariseDiff(diff);
34
+ await writeFile(abs, input.content, 'utf8');
35
+ const summary = existed
36
+ ? `Updated ${input.path} (+${added} / -${removed})`
37
+ : `Created ${input.path} (${input.content.length} bytes)`;
38
+ return {
39
+ content: summary,
40
+ data: { bytesWritten: Buffer.byteLength(input.content, 'utf8'), added, removed },
41
+ isError: false,
42
+ metadata: { diff },
43
+ };
44
+ },
45
+ };
46
+ //# sourceMappingURL=fs-write.js.map
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Git introspection tool. Read-mostly: status, diff, log, branch, show.
3
+ * Destructive operations (commit, push, reset) are deliberately out of
4
+ * scope — the agent performs those via the shell tool so the user sees
5
+ * a single "exec this command?" prompt per operation.
6
+ */
7
+ import type { Tool } from './registry.js';
8
+ export declare const gitTool: Tool;
@@ -0,0 +1,57 @@
1
+ /**
2
+ * Git introspection tool. Read-mostly: status, diff, log, branch, show.
3
+ * Destructive operations (commit, push, reset) are deliberately out of
4
+ * scope — the agent performs those via the shell tool so the user sees
5
+ * a single "exec this command?" prompt per operation.
6
+ */
7
+ import { spawn } from 'node:child_process';
8
+ export const gitTool = {
9
+ name: 'git',
10
+ description: 'Run read-mostly git operations: status, diff, log, branch, show. Destructive git operations should go through the shell tool.',
11
+ inputSchema: {
12
+ type: 'object',
13
+ properties: {
14
+ op: { type: 'string', enum: ['status', 'diff', 'log', 'branch', 'show'] },
15
+ args: { type: 'array', items: { type: 'string' } },
16
+ cwd: { type: 'string' },
17
+ },
18
+ required: ['op'],
19
+ },
20
+ async execute(rawInput, ctx) {
21
+ const input = rawInput;
22
+ const base = commandFor(input.op);
23
+ const full = [...base, ...(input.args ?? [])];
24
+ const cwd = input.cwd ?? ctx.cwd;
25
+ const result = await run('git', full, cwd, ctx.env);
26
+ return {
27
+ content: [result.stdout, result.stderr].filter(s => s && s.length > 0).join('\n'),
28
+ data: { op: input.op, exitCode: result.code },
29
+ isError: result.code !== 0,
30
+ };
31
+ },
32
+ };
33
+ function commandFor(op) {
34
+ switch (op) {
35
+ case 'status': return ['status', '--short', '--branch'];
36
+ case 'diff': return ['diff', '--no-color'];
37
+ case 'log': return ['log', '--oneline', '-n', '20'];
38
+ case 'branch': return ['branch', '--list'];
39
+ case 'show': return ['show', '--no-color'];
40
+ }
41
+ }
42
+ async function run(command, args, cwd, env) {
43
+ return new Promise(resolveAll => {
44
+ const child = spawn(command, args, { cwd, env, stdio: ['ignore', 'pipe', 'pipe'] });
45
+ const stdout = [];
46
+ const stderr = [];
47
+ child.stdout.on('data', buf => stdout.push(buf));
48
+ child.stderr.on('data', buf => stderr.push(buf));
49
+ child.on('error', () => resolveAll({ stdout: '', stderr: '', code: -1 }));
50
+ child.on('exit', code => resolveAll({
51
+ stdout: Buffer.concat(stdout).toString('utf8'),
52
+ stderr: Buffer.concat(stderr).toString('utf8'),
53
+ code: code ?? -1,
54
+ }));
55
+ });
56
+ }
57
+ //# sourceMappingURL=git.js.map
@@ -0,0 +1,25 @@
1
+ /**
2
+ * Tools barrel. Exports the registry, the executor factory, and the
3
+ * bundled built-in tools. Consumers typically import
4
+ * `builtInTools` and register additional tools on top.
5
+ */
6
+ import type { Tool } from './registry.js';
7
+ import { fsReadTool } from './fs-read.js';
8
+ import { fsWriteTool } from './fs-write.js';
9
+ import { fsEditTool } from './fs-edit.js';
10
+ import { fsLsTool } from './fs-ls.js';
11
+ import { shellTool } from './shell.js';
12
+ import { searchGrepTool } from './search-grep.js';
13
+ import { searchGlobTool } from './search-glob.js';
14
+ import { gitTool } from './git.js';
15
+ import { browserTool } from './browser.js';
16
+ import { checkpointTool } from './checkpoint.js';
17
+ export { createMultimodalTool } from './multimodal.js';
18
+ export { createCronTool } from './cron.js';
19
+ declare const cronTool: Tool;
20
+ export * from './registry.js';
21
+ export * from './permission.js';
22
+ export * from './exec.js';
23
+ export * from './diff.js';
24
+ export declare const builtInTools: Tool[];
25
+ export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, browserTool, checkpointTool, cronTool, };
@@ -0,0 +1,39 @@
1
+ /**
2
+ * Tools barrel. Exports the registry, the executor factory, and the
3
+ * bundled built-in tools. Consumers typically import
4
+ * `builtInTools` and register additional tools on top.
5
+ */
6
+ import { fsReadTool } from './fs-read.js';
7
+ import { fsWriteTool } from './fs-write.js';
8
+ import { fsEditTool } from './fs-edit.js';
9
+ import { fsLsTool } from './fs-ls.js';
10
+ import { shellTool } from './shell.js';
11
+ import { searchGrepTool } from './search-grep.js';
12
+ import { searchGlobTool } from './search-glob.js';
13
+ import { gitTool } from './git.js';
14
+ import { browserTool } from './browser.js';
15
+ import { checkpointTool } from './checkpoint.js';
16
+ import { createCronTool } from './cron.js';
17
+ // multimodal is a factory (needs runtime Provider) — wired in main.ts, not baked into builtInTools
18
+ export { createMultimodalTool } from './multimodal.js';
19
+ export { createCronTool } from './cron.js';
20
+ const cronTool = createCronTool();
21
+ export * from './registry.js';
22
+ export * from './permission.js';
23
+ export * from './exec.js';
24
+ export * from './diff.js';
25
+ export const builtInTools = [
26
+ fsReadTool,
27
+ fsWriteTool,
28
+ fsEditTool,
29
+ fsLsTool,
30
+ shellTool,
31
+ searchGrepTool,
32
+ searchGlobTool,
33
+ gitTool,
34
+ browserTool,
35
+ checkpointTool,
36
+ cronTool,
37
+ ];
38
+ export { fsReadTool, fsWriteTool, fsEditTool, fsLsTool, shellTool, searchGrepTool, searchGlobTool, gitTool, browserTool, checkpointTool, cronTool, };
39
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,41 @@
1
+ /**
2
+ * Multimodal tool: a minimal surface for describing images, transcribing
3
+ * audio, and generating images. The tool is shaped as a single entry
4
+ * point (`action: 'describe_image' | 'transcribe_audio' | 'generate_image'`)
5
+ * so the agent only learns one name and the provider plumbing stays
6
+ * internal.
7
+ *
8
+ * Status of the three actions:
9
+ * - describe_image / transcribe_audio: best-effort. They route through
10
+ * the active provider's `stream` API with a multimodal payload when
11
+ * the model advertises support; otherwise they return a clear
12
+ * "provider lacks multimodal capability" result. They are NOT stubs —
13
+ * they will do real work on capable providers (Gemini, Claude vision,
14
+ * OpenAI gpt-4o) — but they can fail politely elsewhere.
15
+ * - generate_image: real. Routes through the active provider's
16
+ * optional `generateImage()` method (NVIDIA Flux Schnell by default,
17
+ * OpenAI DALL-E 3 as fallback when NVIDIA is unavailable and
18
+ * OPENAI_API_KEY is set). The decoded PNG is written to disk and
19
+ * the tool returns the absolute path.
20
+ *
21
+ * This file imports two provider classes lazily for fallback construction
22
+ * when the active provider doesn't expose `generateImage`. It does not
23
+ * pull in any streaming/chat-completions internals.
24
+ */
25
+ import type { Tool } from './registry.js';
26
+ import type { Provider } from '../kernel/types.js';
27
+ export interface MultimodalToolOptions {
28
+ /** Active provider, used for describe/transcribe actions. */
29
+ provider: Provider;
30
+ /** Default model id if the caller doesn't pass `model` in the input. */
31
+ defaultModel: string;
32
+ /**
33
+ * Optional narrow capability check — if provided, determines whether
34
+ * the tool attempts a real provider call for describe/transcribe.
35
+ * Defaults to `provider.supportsTools` as a heuristic proxy: any
36
+ * provider that exposes tool use also tends to expose multimodal on
37
+ * its capable models. Callers can override for tighter control.
38
+ */
39
+ supportsMultimodal?: (modelId: string) => boolean;
40
+ }
41
+ export declare function createMultimodalTool(opts: MultimodalToolOptions): Tool;