keycode-ai 0.0.0-stage → 0.1.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 (363) hide show
  1. package/CHANGELOG.md +85 -0
  2. package/LICENSE +201 -0
  3. package/README.md +547 -2
  4. package/dist/app/agent.d.ts +126 -0
  5. package/dist/app/agent.js +613 -0
  6. package/dist/app/agent.js.map +1 -0
  7. package/dist/app/commands.d.ts +15 -0
  8. package/dist/app/commands.js +281 -0
  9. package/dist/app/commands.js.map +1 -0
  10. package/dist/app/compact.d.ts +23 -0
  11. package/dist/app/compact.js +75 -0
  12. package/dist/app/compact.js.map +1 -0
  13. package/dist/app/export.d.ts +6 -0
  14. package/dist/app/export.js +56 -0
  15. package/dist/app/export.js.map +1 -0
  16. package/dist/app/factory.d.ts +106 -0
  17. package/dist/app/factory.js +687 -0
  18. package/dist/app/factory.js.map +1 -0
  19. package/dist/app/onboarding.d.ts +6 -0
  20. package/dist/app/onboarding.js +32 -0
  21. package/dist/app/onboarding.js.map +1 -0
  22. package/dist/app/subagent.d.ts +16 -0
  23. package/dist/app/subagent.js +14 -0
  24. package/dist/app/subagent.js.map +1 -0
  25. package/dist/app/trust.d.ts +6 -0
  26. package/dist/app/trust.js +74 -0
  27. package/dist/app/trust.js.map +1 -0
  28. package/dist/app/trustManifest.d.ts +18 -0
  29. package/dist/app/trustManifest.js +171 -0
  30. package/dist/app/trustManifest.js.map +1 -0
  31. package/dist/artifacts/store.d.ts +43 -0
  32. package/dist/artifacts/store.js +159 -0
  33. package/dist/artifacts/store.js.map +1 -0
  34. package/dist/cli/auth.d.ts +7 -0
  35. package/dist/cli/auth.js +68 -0
  36. package/dist/cli/auth.js.map +1 -0
  37. package/dist/cli/doctor.d.ts +19 -0
  38. package/dist/cli/doctor.js +205 -0
  39. package/dist/cli/doctor.js.map +1 -0
  40. package/dist/cli/extra.d.ts +2 -0
  41. package/dist/cli/extra.js +989 -0
  42. package/dist/cli/extra.js.map +1 -0
  43. package/dist/cli/headless.d.ts +20 -0
  44. package/dist/cli/headless.js +224 -0
  45. package/dist/cli/headless.js.map +1 -0
  46. package/dist/cli/index.d.ts +3 -0
  47. package/dist/cli/index.js +283 -0
  48. package/dist/cli/index.js.map +1 -0
  49. package/dist/contracts/message.d.ts +34 -0
  50. package/dist/contracts/message.js +10 -0
  51. package/dist/contracts/message.js.map +1 -0
  52. package/dist/contracts/permissions.d.ts +16 -0
  53. package/dist/contracts/permissions.js +9 -0
  54. package/dist/contracts/permissions.js.map +1 -0
  55. package/dist/contracts/provider.d.ts +65 -0
  56. package/dist/contracts/provider.js +2 -0
  57. package/dist/contracts/provider.js.map +1 -0
  58. package/dist/contracts/session.d.ts +101 -0
  59. package/dist/contracts/session.js +11 -0
  60. package/dist/contracts/session.js.map +1 -0
  61. package/dist/contracts/tool.d.ts +81 -0
  62. package/dist/contracts/tool.js +15 -0
  63. package/dist/contracts/tool.js.map +1 -0
  64. package/dist/core/budget.d.ts +11 -0
  65. package/dist/core/budget.js +22 -0
  66. package/dist/core/budget.js.map +1 -0
  67. package/dist/core/context.d.ts +27 -0
  68. package/dist/core/context.js +92 -0
  69. package/dist/core/context.js.map +1 -0
  70. package/dist/extensions/commands.d.ts +23 -0
  71. package/dist/extensions/commands.js +103 -0
  72. package/dist/extensions/commands.js.map +1 -0
  73. package/dist/extensions/customAgents.d.ts +19 -0
  74. package/dist/extensions/customAgents.js +85 -0
  75. package/dist/extensions/customAgents.js.map +1 -0
  76. package/dist/extensions/frontmatter.d.ts +6 -0
  77. package/dist/extensions/frontmatter.js +73 -0
  78. package/dist/extensions/frontmatter.js.map +1 -0
  79. package/dist/extensions/hooks.d.ts +63 -0
  80. package/dist/extensions/hooks.js +145 -0
  81. package/dist/extensions/hooks.js.map +1 -0
  82. package/dist/extensions/loops.d.ts +27 -0
  83. package/dist/extensions/loops.js +119 -0
  84. package/dist/extensions/loops.js.map +1 -0
  85. package/dist/extensions/plugins.d.ts +29 -0
  86. package/dist/extensions/plugins.js +119 -0
  87. package/dist/extensions/plugins.js.map +1 -0
  88. package/dist/extensions/skills.d.ts +21 -0
  89. package/dist/extensions/skills.js +89 -0
  90. package/dist/extensions/skills.js.map +1 -0
  91. package/dist/extensions/statusline.d.ts +13 -0
  92. package/dist/extensions/statusline.js +30 -0
  93. package/dist/extensions/statusline.js.map +1 -0
  94. package/dist/extensions/styles.d.ts +14 -0
  95. package/dist/extensions/styles.js +79 -0
  96. package/dist/extensions/styles.js.map +1 -0
  97. package/dist/extensions/teams.d.ts +44 -0
  98. package/dist/extensions/teams.js +79 -0
  99. package/dist/extensions/teams.js.map +1 -0
  100. package/dist/extensions/themes.d.ts +25 -0
  101. package/dist/extensions/themes.js +109 -0
  102. package/dist/extensions/themes.js.map +1 -0
  103. package/dist/extensions/workflows.d.ts +28 -0
  104. package/dist/extensions/workflows.js +65 -0
  105. package/dist/extensions/workflows.js.map +1 -0
  106. package/dist/gateway/index.d.ts +25 -0
  107. package/dist/gateway/index.js +125 -0
  108. package/dist/gateway/index.js.map +1 -0
  109. package/dist/integrations/background.d.ts +35 -0
  110. package/dist/integrations/background.js +167 -0
  111. package/dist/integrations/background.js.map +1 -0
  112. package/dist/integrations/browser.d.ts +36 -0
  113. package/dist/integrations/browser.js +80 -0
  114. package/dist/integrations/browser.js.map +1 -0
  115. package/dist/integrations/github.d.ts +44 -0
  116. package/dist/integrations/github.js +72 -0
  117. package/dist/integrations/github.js.map +1 -0
  118. package/dist/integrations/ide.d.ts +29 -0
  119. package/dist/integrations/ide.js +69 -0
  120. package/dist/integrations/ide.js.map +1 -0
  121. package/dist/integrations/import.d.ts +14 -0
  122. package/dist/integrations/import.js +76 -0
  123. package/dist/integrations/import.js.map +1 -0
  124. package/dist/integrations/playwrightDriver.d.ts +8 -0
  125. package/dist/integrations/playwrightDriver.js +70 -0
  126. package/dist/integrations/playwrightDriver.js.map +1 -0
  127. package/dist/integrations/pr.d.ts +23 -0
  128. package/dist/integrations/pr.js +81 -0
  129. package/dist/integrations/pr.js.map +1 -0
  130. package/dist/integrations/remote.d.ts +107 -0
  131. package/dist/integrations/remote.js +636 -0
  132. package/dist/integrations/remote.js.map +1 -0
  133. package/dist/integrations/runner.d.ts +30 -0
  134. package/dist/integrations/runner.js +56 -0
  135. package/dist/integrations/runner.js.map +1 -0
  136. package/dist/integrations/worktrees.d.ts +17 -0
  137. package/dist/integrations/worktrees.js +40 -0
  138. package/dist/integrations/worktrees.js.map +1 -0
  139. package/dist/integrations/ws.d.ts +9 -0
  140. package/dist/integrations/ws.js +102 -0
  141. package/dist/integrations/ws.js.map +1 -0
  142. package/dist/lsp/client.d.ts +51 -0
  143. package/dist/lsp/client.js +251 -0
  144. package/dist/lsp/client.js.map +1 -0
  145. package/dist/mcp/client.d.ts +56 -0
  146. package/dist/mcp/client.js +152 -0
  147. package/dist/mcp/client.js.map +1 -0
  148. package/dist/mcp/management.d.ts +20 -0
  149. package/dist/mcp/management.js +97 -0
  150. package/dist/mcp/management.js.map +1 -0
  151. package/dist/mcp/tools.d.ts +3 -0
  152. package/dist/mcp/tools.js +26 -0
  153. package/dist/mcp/tools.js.map +1 -0
  154. package/dist/notifications/index.d.ts +25 -0
  155. package/dist/notifications/index.js +63 -0
  156. package/dist/notifications/index.js.map +1 -0
  157. package/dist/permissions/audit.d.ts +25 -0
  158. package/dist/permissions/audit.js +58 -0
  159. package/dist/permissions/audit.js.map +1 -0
  160. package/dist/permissions/broker.d.ts +20 -0
  161. package/dist/permissions/broker.js +51 -0
  162. package/dist/permissions/broker.js.map +1 -0
  163. package/dist/permissions/dangerous.d.ts +7 -0
  164. package/dist/permissions/dangerous.js +42 -0
  165. package/dist/permissions/dangerous.js.map +1 -0
  166. package/dist/permissions/pipeline.d.ts +34 -0
  167. package/dist/permissions/pipeline.js +217 -0
  168. package/dist/permissions/pipeline.js.map +1 -0
  169. package/dist/permissions/prompt.d.ts +2 -0
  170. package/dist/permissions/prompt.js +33 -0
  171. package/dist/permissions/prompt.js.map +1 -0
  172. package/dist/permissions/rules.d.ts +7 -0
  173. package/dist/permissions/rules.js +176 -0
  174. package/dist/permissions/rules.js.map +1 -0
  175. package/dist/platform/index.d.ts +16 -0
  176. package/dist/platform/index.js +55 -0
  177. package/dist/platform/index.js.map +1 -0
  178. package/dist/privacy/index.d.ts +27 -0
  179. package/dist/privacy/index.js +98 -0
  180. package/dist/privacy/index.js.map +1 -0
  181. package/dist/providers/anthropic.d.ts +25 -0
  182. package/dist/providers/anthropic.js +225 -0
  183. package/dist/providers/anthropic.js.map +1 -0
  184. package/dist/providers/budget.d.ts +24 -0
  185. package/dist/providers/budget.js +47 -0
  186. package/dist/providers/budget.js.map +1 -0
  187. package/dist/providers/capabilities.d.ts +9 -0
  188. package/dist/providers/capabilities.js +39 -0
  189. package/dist/providers/capabilities.js.map +1 -0
  190. package/dist/providers/credentials.d.ts +21 -0
  191. package/dist/providers/credentials.js +81 -0
  192. package/dist/providers/credentials.js.map +1 -0
  193. package/dist/providers/fake.d.ts +32 -0
  194. package/dist/providers/fake.js +95 -0
  195. package/dist/providers/fake.js.map +1 -0
  196. package/dist/providers/openai.d.ts +27 -0
  197. package/dist/providers/openai.js +243 -0
  198. package/dist/providers/openai.js.map +1 -0
  199. package/dist/providers/presets.d.ts +20 -0
  200. package/dist/providers/presets.js +166 -0
  201. package/dist/providers/presets.js.map +1 -0
  202. package/dist/providers/registry.d.ts +27 -0
  203. package/dist/providers/registry.js +127 -0
  204. package/dist/providers/registry.js.map +1 -0
  205. package/dist/providers/retry.d.ts +22 -0
  206. package/dist/providers/retry.js +69 -0
  207. package/dist/providers/retry.js.map +1 -0
  208. package/dist/providers/sse.d.ts +5 -0
  209. package/dist/providers/sse.js +74 -0
  210. package/dist/providers/sse.js.map +1 -0
  211. package/dist/providers/textProtocol.d.ts +10 -0
  212. package/dist/providers/textProtocol.js +45 -0
  213. package/dist/providers/textProtocol.js.map +1 -0
  214. package/dist/questions/broker.d.ts +16 -0
  215. package/dist/questions/broker.js +40 -0
  216. package/dist/questions/broker.js.map +1 -0
  217. package/dist/sandbox/command.d.ts +20 -0
  218. package/dist/sandbox/command.js +296 -0
  219. package/dist/sandbox/command.js.map +1 -0
  220. package/dist/sandbox/index.d.ts +21 -0
  221. package/dist/sandbox/index.js +32 -0
  222. package/dist/sandbox/index.js.map +1 -0
  223. package/dist/sdk/index.d.ts +14 -0
  224. package/dist/sdk/index.js +57 -0
  225. package/dist/sdk/index.js.map +1 -0
  226. package/dist/sdk/structured.d.ts +7 -0
  227. package/dist/sdk/structured.js +66 -0
  228. package/dist/sdk/structured.js.map +1 -0
  229. package/dist/storage/autoMemory.d.ts +22 -0
  230. package/dist/storage/autoMemory.js +93 -0
  231. package/dist/storage/autoMemory.js.map +1 -0
  232. package/dist/storage/checkpoints.d.ts +15 -0
  233. package/dist/storage/checkpoints.js +86 -0
  234. package/dist/storage/checkpoints.js.map +1 -0
  235. package/dist/storage/memory.d.ts +21 -0
  236. package/dist/storage/memory.js +137 -0
  237. package/dist/storage/memory.js.map +1 -0
  238. package/dist/storage/schema.d.ts +177 -0
  239. package/dist/storage/schema.js +120 -0
  240. package/dist/storage/schema.js.map +1 -0
  241. package/dist/storage/session.d.ts +56 -0
  242. package/dist/storage/session.js +305 -0
  243. package/dist/storage/session.js.map +1 -0
  244. package/dist/storage/settings.d.ts +17 -0
  245. package/dist/storage/settings.js +150 -0
  246. package/dist/storage/settings.js.map +1 -0
  247. package/dist/telemetry/otel.d.ts +21 -0
  248. package/dist/telemetry/otel.js +71 -0
  249. package/dist/telemetry/otel.js.map +1 -0
  250. package/dist/tools/agent.d.ts +13 -0
  251. package/dist/tools/agent.js +45 -0
  252. package/dist/tools/agent.js.map +1 -0
  253. package/dist/tools/artifact.d.ts +31 -0
  254. package/dist/tools/artifact.js +137 -0
  255. package/dist/tools/artifact.js.map +1 -0
  256. package/dist/tools/bash.d.ts +29 -0
  257. package/dist/tools/bash.js +191 -0
  258. package/dist/tools/bash.js.map +1 -0
  259. package/dist/tools/codemode.d.ts +13 -0
  260. package/dist/tools/codemode.js +77 -0
  261. package/dist/tools/codemode.js.map +1 -0
  262. package/dist/tools/edit.d.ts +11 -0
  263. package/dist/tools/edit.js +128 -0
  264. package/dist/tools/edit.js.map +1 -0
  265. package/dist/tools/glob.d.ts +10 -0
  266. package/dist/tools/glob.js +33 -0
  267. package/dist/tools/glob.js.map +1 -0
  268. package/dist/tools/grep.d.ts +20 -0
  269. package/dist/tools/grep.js +143 -0
  270. package/dist/tools/grep.js.map +1 -0
  271. package/dist/tools/index.d.ts +11 -0
  272. package/dist/tools/index.js +47 -0
  273. package/dist/tools/index.js.map +1 -0
  274. package/dist/tools/lsp.d.ts +30 -0
  275. package/dist/tools/lsp.js +206 -0
  276. package/dist/tools/lsp.js.map +1 -0
  277. package/dist/tools/notebook.d.ts +19 -0
  278. package/dist/tools/notebook.js +83 -0
  279. package/dist/tools/notebook.js.map +1 -0
  280. package/dist/tools/powershell.d.ts +10 -0
  281. package/dist/tools/powershell.js +83 -0
  282. package/dist/tools/powershell.js.map +1 -0
  283. package/dist/tools/question.d.ts +15 -0
  284. package/dist/tools/question.js +50 -0
  285. package/dist/tools/question.js.map +1 -0
  286. package/dist/tools/read.d.ts +10 -0
  287. package/dist/tools/read.js +188 -0
  288. package/dist/tools/read.js.map +1 -0
  289. package/dist/tools/shared.d.ts +8 -0
  290. package/dist/tools/shared.js +35 -0
  291. package/dist/tools/shared.js.map +1 -0
  292. package/dist/tools/skill.d.ts +9 -0
  293. package/dist/tools/skill.js +38 -0
  294. package/dist/tools/skill.js.map +1 -0
  295. package/dist/tools/tasks.d.ts +35 -0
  296. package/dist/tools/tasks.js +139 -0
  297. package/dist/tools/tasks.js.map +1 -0
  298. package/dist/tools/todo.d.ts +27 -0
  299. package/dist/tools/todo.js +40 -0
  300. package/dist/tools/todo.js.map +1 -0
  301. package/dist/tools/walk.d.ts +15 -0
  302. package/dist/tools/walk.js +144 -0
  303. package/dist/tools/walk.js.map +1 -0
  304. package/dist/tools/webfetch.d.ts +22 -0
  305. package/dist/tools/webfetch.js +201 -0
  306. package/dist/tools/webfetch.js.map +1 -0
  307. package/dist/tools/websearch.d.ts +33 -0
  308. package/dist/tools/websearch.js +129 -0
  309. package/dist/tools/websearch.js.map +1 -0
  310. package/dist/tools/write.d.ts +8 -0
  311. package/dist/tools/write.js +51 -0
  312. package/dist/tools/write.js.map +1 -0
  313. package/dist/tui/accessibility.d.ts +4 -0
  314. package/dist/tui/accessibility.js +24 -0
  315. package/dist/tui/accessibility.js.map +1 -0
  316. package/dist/tui/app.d.ts +21 -0
  317. package/dist/tui/app.js +280 -0
  318. package/dist/tui/app.js.map +1 -0
  319. package/dist/tui/format.d.ts +22 -0
  320. package/dist/tui/format.js +91 -0
  321. package/dist/tui/format.js.map +1 -0
  322. package/dist/tui/input.d.ts +9 -0
  323. package/dist/tui/input.js +71 -0
  324. package/dist/tui/input.js.map +1 -0
  325. package/dist/tui/permission.d.ts +2 -0
  326. package/dist/tui/permission.js +2 -0
  327. package/dist/tui/permission.js.map +1 -0
  328. package/dist/updates/index.d.ts +33 -0
  329. package/dist/updates/index.js +60 -0
  330. package/dist/updates/index.js.map +1 -0
  331. package/dist/util/clipboard.d.ts +1 -0
  332. package/dist/util/clipboard.js +30 -0
  333. package/dist/util/clipboard.js.map +1 -0
  334. package/dist/util/clock.d.ts +7 -0
  335. package/dist/util/clock.js +6 -0
  336. package/dist/util/clock.js.map +1 -0
  337. package/dist/util/errors.d.ts +19 -0
  338. package/dist/util/errors.js +64 -0
  339. package/dist/util/errors.js.map +1 -0
  340. package/dist/util/fsx.d.ts +4 -0
  341. package/dist/util/fsx.js +35 -0
  342. package/dist/util/fsx.js.map +1 -0
  343. package/dist/util/ids.d.ts +5 -0
  344. package/dist/util/ids.js +17 -0
  345. package/dist/util/ids.js.map +1 -0
  346. package/dist/util/logger.d.ts +13 -0
  347. package/dist/util/logger.js +23 -0
  348. package/dist/util/logger.js.map +1 -0
  349. package/dist/util/paths.d.ts +14 -0
  350. package/dist/util/paths.js +77 -0
  351. package/dist/util/paths.js.map +1 -0
  352. package/dist/util/redact.d.ts +6 -0
  353. package/dist/util/redact.js +44 -0
  354. package/dist/util/redact.js.map +1 -0
  355. package/dist/util/text.d.ts +4 -0
  356. package/dist/util/text.js +23 -0
  357. package/dist/util/text.js.map +1 -0
  358. package/dist/web/public/app.js +917 -0
  359. package/dist/web/public/favicon.svg +5 -0
  360. package/dist/web/public/index.html +197 -0
  361. package/dist/web/public/markdown.js +176 -0
  362. package/dist/web/public/styles.css +1245 -0
  363. package/package.json +55 -4
@@ -0,0 +1,191 @@
1
+ import { spawn, spawnSync } from "node:child_process";
2
+ import { closeSync, openSync, writeFileSync } from "node:fs";
3
+ import { join } from "node:path";
4
+ import { z } from "zod";
5
+ import { toolError, toolOk } from "../contracts/tool.js";
6
+ import { newId } from "../util/ids.js";
7
+ import { ensureDir } from "../util/fsx.js";
8
+ import { tasksDir } from "../util/paths.js";
9
+ import { checkCommand, sandboxSpawn } from "../sandbox/command.js";
10
+ import { capOutput } from "./shared.js";
11
+ export const BashInput = z.object({
12
+ command: z.string().min(1),
13
+ description: z.string().optional(),
14
+ timeout: z.number().int().positive().max(600_000).optional(),
15
+ run_in_background: z.boolean().optional(),
16
+ stdin: z.string().optional(),
17
+ env: z.record(z.string(), z.string()).optional(),
18
+ });
19
+ function killTree(pid) {
20
+ if (process.platform === "win32") {
21
+ spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
22
+ }
23
+ else {
24
+ try {
25
+ process.kill(-pid, "SIGKILL");
26
+ }
27
+ catch {
28
+ try {
29
+ process.kill(pid, "SIGKILL");
30
+ }
31
+ catch {
32
+ // Process already exited.
33
+ }
34
+ }
35
+ }
36
+ }
37
+ export async function runCommand(options) {
38
+ const started = Date.now();
39
+ const timeoutMs = options.timeoutMs ?? 120_000;
40
+ return await new Promise((resolvePromise) => {
41
+ const child = spawn(options.command, options.args ?? [], {
42
+ cwd: options.cwd,
43
+ env: { ...process.env, ...options.env },
44
+ shell: options.shell ?? true,
45
+ windowsHide: true,
46
+ detached: process.platform !== "win32",
47
+ stdio: ["pipe", "pipe", "pipe"],
48
+ });
49
+ let stdout = "";
50
+ let stderr = "";
51
+ let timedOut = false;
52
+ let settled = false;
53
+ const finish = (exitCode) => {
54
+ if (settled)
55
+ return;
56
+ settled = true;
57
+ clearTimeout(timer);
58
+ options.signal?.removeEventListener("abort", onAbort);
59
+ resolvePromise({ stdout, stderr, exitCode, timedOut, durationMs: Date.now() - started });
60
+ };
61
+ const onAbort = () => {
62
+ if (child.pid)
63
+ killTree(child.pid);
64
+ };
65
+ options.signal?.addEventListener("abort", onAbort, { once: true });
66
+ const timer = setTimeout(() => {
67
+ timedOut = true;
68
+ if (child.pid)
69
+ killTree(child.pid);
70
+ }, timeoutMs);
71
+ child.stdout?.on("data", (chunk) => {
72
+ if (stdout.length < 2_000_000)
73
+ stdout += chunk.toString("utf8");
74
+ });
75
+ child.stderr?.on("data", (chunk) => {
76
+ if (stderr.length < 2_000_000)
77
+ stderr += chunk.toString("utf8");
78
+ });
79
+ child.on("error", (error) => {
80
+ stderr += `${stderr.length > 0 ? "\n" : ""}${error.message}`;
81
+ finish(null);
82
+ });
83
+ child.on("close", (code) => finish(code));
84
+ if (options.stdin !== undefined) {
85
+ child.stdin?.end(options.stdin);
86
+ }
87
+ else {
88
+ child.stdin?.end();
89
+ }
90
+ });
91
+ }
92
+ export function createBashTool() {
93
+ return {
94
+ name: "Bash",
95
+ description: "Run a shell command in the session working directory and return its output. Shell state does not persist between calls. Use for builds, tests, and git.",
96
+ input: BashInput,
97
+ readOnly: false,
98
+ concurrency: "exclusive",
99
+ async execute(input, ctx) {
100
+ if (ctx.sandbox !== undefined) {
101
+ const guarded = checkCommand(ctx.sandbox, input.command, ctx.cwd);
102
+ if (!guarded.allowed) {
103
+ return toolError(`SANDBOX_DENIED: ${guarded.reason ?? "blocked by the sandbox"}`, {
104
+ code: "SANDBOX_DENIED",
105
+ });
106
+ }
107
+ }
108
+ const launch = ctx.sandbox === undefined
109
+ ? { command: input.command, args: [], shell: true }
110
+ : sandboxSpawn(ctx.sandbox, input.command, ctx.cwd);
111
+ if (input.run_in_background === true) {
112
+ const id = newId("task");
113
+ const dir = tasksDir(ctx.home);
114
+ ensureDir(dir);
115
+ const logPath = join(dir, `${id}.log`);
116
+ const fd = openSync(logPath, "a");
117
+ const child = spawn(launch.command, launch.args, {
118
+ cwd: ctx.cwd,
119
+ env: { ...process.env, ...input.env },
120
+ shell: launch.shell,
121
+ detached: false,
122
+ windowsHide: true,
123
+ stdio: ["ignore", fd, fd],
124
+ });
125
+ closeSync(fd);
126
+ child.unref();
127
+ const record = {
128
+ id,
129
+ command: input.command,
130
+ cwd: ctx.cwd,
131
+ pid: child.pid ?? null,
132
+ startedAt: new Date().toISOString(),
133
+ status: "running",
134
+ log: logPath,
135
+ };
136
+ writeFileSync(join(dir, `${id}.json`), JSON.stringify(record, null, 2));
137
+ return toolOk(`Background task ${id} started (pid ${child.pid ?? "unknown"}). Log: ${logPath}`, { taskId: id, pid: child.pid ?? null, log: logPath });
138
+ }
139
+ const result = await runCommand({
140
+ command: launch.command,
141
+ args: launch.args,
142
+ shell: launch.shell,
143
+ cwd: ctx.cwd,
144
+ env: input.env,
145
+ timeoutMs: input.timeout,
146
+ stdin: input.stdin,
147
+ signal: ctx.signal,
148
+ });
149
+ if (result.timedOut) {
150
+ return {
151
+ ok: false,
152
+ content: [
153
+ {
154
+ type: "text",
155
+ text: `Command timed out after ${input.timeout ?? 120_000} ms.\n${result.stdout}${result.stderr}`,
156
+ },
157
+ ],
158
+ metadata: { code: "TOOL_TIMEOUT", exitCode: result.exitCode },
159
+ };
160
+ }
161
+ if (ctx.signal.aborted) {
162
+ return {
163
+ ok: false,
164
+ content: [{ type: "text", text: "Command aborted." }],
165
+ metadata: { code: "ABORTED" },
166
+ };
167
+ }
168
+ let output = result.stdout;
169
+ if (result.stderr.length > 0) {
170
+ output += `${output.length > 0 ? "\n" : ""}[stderr]\n${result.stderr}`;
171
+ }
172
+ if (output.trim() === "")
173
+ output = "(no output)";
174
+ if (result.exitCode !== 0) {
175
+ output = `Exit code ${result.exitCode ?? "null"}\n${output}`;
176
+ }
177
+ const capped = capOutput(output, ctx, "bash");
178
+ return {
179
+ ok: result.exitCode === 0,
180
+ content: [{ type: "text", text: capped.text }],
181
+ display: `Bash: ${input.command.slice(0, 80)}`,
182
+ metadata: {
183
+ exitCode: result.exitCode,
184
+ durationMs: result.durationMs,
185
+ ...(capped.spilled === null ? {} : { spilled: capped.spilled }),
186
+ },
187
+ };
188
+ },
189
+ };
190
+ }
191
+ //# sourceMappingURL=bash.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bash.js","sourceRoot":"","sources":["../../src/tools/bash.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const CodeModeInput: z.ZodObject<{
4
+ code: z.ZodString;
5
+ reset: z.ZodOptional<z.ZodBoolean>;
6
+ }, z.core.$strip>;
7
+ export type CodeModeInputType = z.infer<typeof CodeModeInput>;
8
+ export interface CodeModeOptions {
9
+ enabled?: boolean | undefined;
10
+ tools?: Tool[] | undefined;
11
+ timeoutMs?: number | undefined;
12
+ }
13
+ export declare function createCodeModeTool(options?: CodeModeOptions): Tool<CodeModeInputType>;
@@ -0,0 +1,77 @@
1
+ import vm from "node:vm";
2
+ import { z } from "zod";
3
+ import { toolError, toolOk } from "../contracts/tool.js";
4
+ export const CodeModeInput = z.object({
5
+ code: z.string().min(1),
6
+ reset: z.boolean().optional(),
7
+ });
8
+ function withImplicitReturn(code) {
9
+ const trimmed = code.trim();
10
+ const lastSemicolon = trimmed.lastIndexOf(";");
11
+ const head = lastSemicolon === -1 ? "" : trimmed.slice(0, lastSemicolon + 1);
12
+ const tail = (lastSemicolon === -1 ? trimmed : trimmed.slice(lastSemicolon + 1)).trim();
13
+ if (tail.length === 0)
14
+ return trimmed;
15
+ if (/^(return|const|let|var|if|for|while|function|class|throw|try|switch|import|export|\{|\})/.test(tail)) {
16
+ return trimmed;
17
+ }
18
+ return `${head}\nreturn (${tail});`;
19
+ }
20
+ export function createCodeModeTool(options = {}) {
21
+ let context = null;
22
+ let sandbox = null;
23
+ const createSandbox = () => {
24
+ const output = [];
25
+ sandbox = {
26
+ state: {},
27
+ console: { log: (...args) => output.push(args.map((arg) => String(arg)).join(" ")) },
28
+ tools: { call: async () => "" },
29
+ __out: output,
30
+ };
31
+ context = vm.createContext(sandbox, { name: "keycode-codemode" });
32
+ };
33
+ return {
34
+ name: "CodeMode",
35
+ description: "Opt-in persistent JavaScript REPL with a tool bridge, output capture, and reset. Not a security boundary.",
36
+ input: CodeModeInput,
37
+ readOnly: false,
38
+ concurrency: "exclusive",
39
+ async execute(input, ctx) {
40
+ if (options.enabled !== true) {
41
+ return toolError("Code Mode is opt-in. Enable it in settings before calling this tool.", {
42
+ code: "TOOL_UNSUPPORTED",
43
+ });
44
+ }
45
+ if (input.reset || context === null || sandbox === null)
46
+ createSandbox();
47
+ const activeSandbox = sandbox;
48
+ const activeContext = context;
49
+ activeSandbox.__out.length = 0;
50
+ activeSandbox.tools.call = async (name, args) => {
51
+ const tool = options.tools?.find((candidate) => candidate.name === name);
52
+ if (!tool)
53
+ throw new Error(`Unknown tool: ${name}`);
54
+ const result = await tool.execute(args, ctx);
55
+ return result.content
56
+ .map((block) => (block.type === "text" ? block.text : `[${block.type}]`))
57
+ .join("\n");
58
+ };
59
+ try {
60
+ const script = new vm.Script(`(async () => {\n${withImplicitReturn(input.code)}\n})()`, {
61
+ filename: "codemode.js",
62
+ });
63
+ const result = await script.runInContext(activeContext, { timeout: options.timeoutMs ?? 10_000 });
64
+ const output = activeSandbox.__out.join("\n");
65
+ const rendered = result === undefined
66
+ ? ""
67
+ : `=> ${typeof result === "string" ? result : JSON.stringify(result)}`;
68
+ const text = [output, rendered].filter((entry) => entry.length > 0).join("\n");
69
+ return toolOk(text.length > 0 ? text : "(no output)", {});
70
+ }
71
+ catch (error) {
72
+ return toolError(`Code Mode error: ${error.message}`, { code: "TOOL_INPUT_INVALID" });
73
+ }
74
+ },
75
+ };
76
+ }
77
+ //# sourceMappingURL=codemode.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"codemode.js","sourceRoot":"","sources":["../../src/tools/codemode.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const EditInput: z.ZodObject<{
4
+ file_path: z.ZodString;
5
+ old_string: z.ZodString;
6
+ new_string: z.ZodString;
7
+ replace_all: z.ZodOptional<z.ZodBoolean>;
8
+ }, z.core.$strip>;
9
+ export type EditInputType = z.infer<typeof EditInput>;
10
+ export declare function unifiedDiff(path: string, before: string, after: string): string;
11
+ export declare function createEditTool(): Tool<EditInputType>;
@@ -0,0 +1,128 @@
1
+ import { existsSync, readFileSync } from "node:fs";
2
+ import { z } from "zod";
3
+ import { toolError } from "../contracts/tool.js";
4
+ import { atomicWrite } from "../util/fsx.js";
5
+ import { scanSecrets } from "../util/redact.js";
6
+ import { guardPath, resolveUserPath } from "./shared.js";
7
+ export const EditInput = z.object({
8
+ file_path: z.string().min(1),
9
+ old_string: z.string().min(1),
10
+ new_string: z.string(),
11
+ replace_all: z.boolean().optional(),
12
+ });
13
+ function countOccurrences(haystack, needle) {
14
+ let count = 0;
15
+ let index = haystack.indexOf(needle);
16
+ while (index !== -1) {
17
+ count += 1;
18
+ index = haystack.indexOf(needle, index + needle.length);
19
+ }
20
+ return count;
21
+ }
22
+ export function unifiedDiff(path, before, after) {
23
+ const a = before.split(/\r?\n/);
24
+ const b = after.split(/\r?\n/);
25
+ let prefix = 0;
26
+ while (prefix < a.length && prefix < b.length && a[prefix] === b[prefix])
27
+ prefix += 1;
28
+ let suffix = 0;
29
+ while (suffix < a.length - prefix &&
30
+ suffix < b.length - prefix &&
31
+ a[a.length - 1 - suffix] === b[b.length - 1 - suffix]) {
32
+ suffix += 1;
33
+ }
34
+ const context = 2;
35
+ const start = Math.max(0, prefix - context);
36
+ const endA = Math.min(a.length, a.length - suffix + context);
37
+ const endB = Math.min(b.length, b.length - suffix + context);
38
+ const lines = [
39
+ `--- a/${path}`,
40
+ `+++ b/${path}`,
41
+ `@@ -${start + 1},${endA - start} +${start + 1},${endB - start} @@`,
42
+ ];
43
+ for (let index = start; index < prefix; index += 1)
44
+ lines.push(` ${a[index] ?? ""}`);
45
+ for (let index = prefix; index < a.length - suffix; index += 1)
46
+ lines.push(`-${a[index] ?? ""}`);
47
+ for (let index = prefix; index < b.length - suffix; index += 1)
48
+ lines.push(`+${b[index] ?? ""}`);
49
+ for (let index = a.length - suffix; index < endA; index += 1)
50
+ lines.push(` ${a[index] ?? ""}`);
51
+ return lines.join("\n");
52
+ }
53
+ export function createEditTool() {
54
+ return {
55
+ name: "Edit",
56
+ description: "Replace an exact string in a file. The old string must be unique unless replace_all is true. Preserves line endings.",
57
+ input: EditInput,
58
+ readOnly: false,
59
+ concurrency: "exclusive",
60
+ async execute(input, ctx) {
61
+ const path = resolveUserPath(ctx, input.file_path);
62
+ const guard = guardPath(ctx, path);
63
+ if (guard)
64
+ return guard;
65
+ if (!existsSync(path))
66
+ return toolError(`File not found: ${input.file_path}`);
67
+ let before;
68
+ try {
69
+ before = readFileSync(path, "utf8");
70
+ }
71
+ catch (error) {
72
+ return toolError(`Cannot read ${input.file_path}: ${error.message}`);
73
+ }
74
+ const crlf = before.includes("\r\n");
75
+ const oldString = crlf && !input.old_string.includes("\r\n")
76
+ ? input.old_string.replaceAll("\n", "\r\n")
77
+ : input.old_string;
78
+ const newString = crlf && !input.new_string.includes("\r\n")
79
+ ? input.new_string.replaceAll("\n", "\r\n")
80
+ : input.new_string;
81
+ const occurrences = countOccurrences(before, oldString);
82
+ if (occurrences === 0) {
83
+ if (newString.length > 0 && before.includes(newString)) {
84
+ return {
85
+ ok: true,
86
+ content: [
87
+ {
88
+ type: "text",
89
+ text: `No change needed: ${input.file_path} already contains the requested text. Verify with Read, then stop.`,
90
+ },
91
+ ],
92
+ display: `No change needed: ${input.file_path}`,
93
+ metadata: { path, alreadyApplied: true },
94
+ };
95
+ }
96
+ return toolError(`old_string was not found in ${input.file_path}. Re-read the file and match the exact text, including whitespace. If you already applied this change, verify with Read and stop; do not retry the same edit.`);
97
+ }
98
+ if (occurrences > 1 && input.replace_all !== true) {
99
+ return toolError(`old_string appears ${occurrences} times in ${input.file_path}. Include more context to make it unique, or set replace_all.`);
100
+ }
101
+ const after = input.replace_all === true
102
+ ? before.split(oldString).join(newString)
103
+ : before.replace(oldString, newString);
104
+ const beforeCounts = new Map(scanSecrets(before).map((finding) => [finding.kind, finding.count]));
105
+ const introduced = scanSecrets(after).filter((finding) => finding.count > (beforeCounts.get(finding.kind) ?? 0));
106
+ if (introduced.length > 0) {
107
+ return toolError(`SECRET_DETECTED: refusing to write ${input.file_path}; the edit would add ${introduced
108
+ .map((finding) => finding.kind)
109
+ .join(", ")}. Remove the credential or load it from an environment variable.`, { code: "SECRET_DETECTED" });
110
+ }
111
+ ctx.onMutation?.([path]);
112
+ try {
113
+ atomicWrite(path, after);
114
+ }
115
+ catch (error) {
116
+ return toolError(`Failed to write ${input.file_path}: ${error.message}`);
117
+ }
118
+ ctx.state.readFiles.add(path);
119
+ return {
120
+ ok: true,
121
+ content: [{ type: "text", text: unifiedDiff(input.file_path, before, after) }],
122
+ display: `Edited ${input.file_path} (${occurrences} replacement${occurrences === 1 ? "" : "s"})`,
123
+ metadata: { path, replacements: occurrences },
124
+ };
125
+ },
126
+ };
127
+ }
128
+ //# sourceMappingURL=edit.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"edit.js","sourceRoot":"","sources":["../../src/tools/edit.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,10 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const GlobInput: z.ZodObject<{
4
+ pattern: z.ZodString;
5
+ path: z.ZodOptional<z.ZodString>;
6
+ limit: z.ZodOptional<z.ZodNumber>;
7
+ no_ignore: z.ZodOptional<z.ZodBoolean>;
8
+ }, z.core.$strip>;
9
+ export type GlobInputType = z.infer<typeof GlobInput>;
10
+ export declare function createGlobTool(): Tool<GlobInputType>;
@@ -0,0 +1,33 @@
1
+ import { z } from "zod";
2
+ import { toolOk } from "../contracts/tool.js";
3
+ import { matchGlob, toAbsolutePath, walkFiles } from "./walk.js";
4
+ export const GlobInput = z.object({
5
+ pattern: z.string().min(1),
6
+ path: z.string().optional(),
7
+ limit: z.number().int().positive().max(10_000).optional(),
8
+ no_ignore: z.boolean().optional(),
9
+ });
10
+ export function createGlobTool() {
11
+ return {
12
+ name: "Glob",
13
+ description: "Find files by glob pattern. Results are sorted by modification time, newest first. Respects .gitignore and .ignore and skips .git and node_modules by default.",
14
+ input: GlobInput,
15
+ readOnly: true,
16
+ concurrency: "parallel",
17
+ async execute(input, ctx) {
18
+ const base = input.path ? toAbsolutePath(ctx.cwd, input.path) : ctx.cwd;
19
+ const files = walkFiles({
20
+ cwd: base,
21
+ noIgnore: input.no_ignore ?? false,
22
+ maxEntries: 50_000,
23
+ });
24
+ const matches = files
25
+ .filter((file) => matchGlob(input.pattern, file.relative))
26
+ .sort((a, b) => b.mtimeMs - a.mtimeMs)
27
+ .slice(0, input.limit ?? 200);
28
+ const text = matches.length === 0 ? "No files found." : matches.map((file) => file.relative).join("\n");
29
+ return toolOk(text, { count: matches.length, truncated: matches.length === (input.limit ?? 200) });
30
+ },
31
+ };
32
+ }
33
+ //# sourceMappingURL=glob.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"glob.js","sourceRoot":"","sources":["../../src/tools/glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjE,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE;IACzD,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAIH,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,WAAW,EACT,gKAAgK;QAClK,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,UAAU;QACvB,KAAK,CAAC,OAAO,CAAC,KAAoB,EAAE,GAAgB;YAClD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;YACxE,MAAM,KAAK,GAAG,SAAS,CAAC;gBACtB,GAAG,EAAE,IAAI;gBACT,QAAQ,EAAE,KAAK,CAAC,SAAS,IAAI,KAAK;gBAClC,UAAU,EAAE,MAAM;aACnB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,KAAK;iBAClB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;iBACzD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC;iBACrC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;YAEhC,MAAM,IAAI,GACR,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7F,OAAO,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;QACrG,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,20 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const GrepInput: z.ZodObject<{
4
+ pattern: z.ZodString;
5
+ path: z.ZodOptional<z.ZodString>;
6
+ glob: z.ZodOptional<z.ZodString>;
7
+ type: z.ZodOptional<z.ZodString>;
8
+ output_mode: z.ZodOptional<z.ZodEnum<{
9
+ content: "content";
10
+ count: "count";
11
+ files_with_matches: "files_with_matches";
12
+ }>>;
13
+ case_sensitive: z.ZodOptional<z.ZodBoolean>;
14
+ literal: z.ZodOptional<z.ZodBoolean>;
15
+ context: z.ZodOptional<z.ZodNumber>;
16
+ head_limit: z.ZodOptional<z.ZodNumber>;
17
+ no_ignore: z.ZodOptional<z.ZodBoolean>;
18
+ }, z.core.$strip>;
19
+ export type GrepInputType = z.infer<typeof GrepInput>;
20
+ export declare function createGrepTool(): Tool<GrepInputType>;