keycode-ai 0.0.0-stage → 0.1.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 (366) hide show
  1. package/CHANGELOG.md +101 -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 +33 -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 +990 -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 +4 -0
  47. package/dist/cli/index.js +284 -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 +153 -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 +86 -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 +307 -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 +146 -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/version.d.ts +1 -0
  359. package/dist/version.js +2 -0
  360. package/dist/version.js.map +1 -0
  361. package/dist/web/public/app.js +917 -0
  362. package/dist/web/public/favicon.svg +5 -0
  363. package/dist/web/public/index.html +197 -0
  364. package/dist/web/public/markdown.js +176 -0
  365. package/dist/web/public/styles.css +1245 -0
  366. package/package.json +55 -4
@@ -0,0 +1,206 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { isAbsolute, extname, resolve } from "node:path";
3
+ import { fileURLToPath, pathToFileURL } from "node:url";
4
+ import { z } from "zod";
5
+ import { toolError, toolOk } from "../contracts/tool.js";
6
+ import { LspClient } from "../lsp/client.js";
7
+ import { KeycodeError } from "../util/errors.js";
8
+ import { isInside } from "../util/paths.js";
9
+ export const LspInput = z.object({
10
+ action: z.enum(["diagnostics", "hover", "definition", "references"]),
11
+ file: z.string().min(1),
12
+ line: z.number().int().positive().optional(),
13
+ character: z.number().int().positive().optional(),
14
+ });
15
+ const LANGUAGE_BY_EXTENSION = {
16
+ ".ts": "typescript",
17
+ ".tsx": "typescriptreact",
18
+ ".js": "javascript",
19
+ ".jsx": "javascriptreact",
20
+ ".mjs": "javascript",
21
+ ".cjs": "javascript",
22
+ ".py": "python",
23
+ ".rs": "rust",
24
+ ".go": "go",
25
+ ".java": "java",
26
+ ".c": "c",
27
+ ".h": "c",
28
+ ".cc": "cpp",
29
+ ".cpp": "cpp",
30
+ ".json": "json",
31
+ ".md": "markdown",
32
+ ".css": "css",
33
+ ".html": "html",
34
+ ".sh": "shellscript",
35
+ ".ps1": "powershell",
36
+ };
37
+ const SEVERITY = {
38
+ 1: "error",
39
+ 2: "warning",
40
+ 3: "info",
41
+ 4: "hint",
42
+ };
43
+ function resolveServer(file, servers) {
44
+ const extension = extname(file).toLowerCase();
45
+ const language = LANGUAGE_BY_EXTENSION[extension] ?? extension.replace(".", "");
46
+ const config = servers[language] ?? servers[extension] ?? servers["*"];
47
+ if (!config)
48
+ return null;
49
+ return { language: config.language ?? language, config };
50
+ }
51
+ function renderHover(value) {
52
+ if (value === null || value === undefined)
53
+ return "No hover information.";
54
+ if (typeof value === "string")
55
+ return value;
56
+ if (Array.isArray(value)) {
57
+ return value.map((entry) => renderHover(entry)).join("\n\n");
58
+ }
59
+ if (typeof value === "object") {
60
+ const record = value;
61
+ if (record.contents !== undefined)
62
+ return renderHover(record.contents);
63
+ if (typeof record.value === "string")
64
+ return record.value;
65
+ }
66
+ return JSON.stringify(value);
67
+ }
68
+ function position(range) {
69
+ if (range === null || typeof range !== "object")
70
+ return "";
71
+ const record = range;
72
+ const line = record.start?.line;
73
+ const character = record.start?.character;
74
+ if (typeof line !== "number")
75
+ return "";
76
+ return `:${line + 1}:${typeof character === "number" ? character + 1 : 1}`;
77
+ }
78
+ function renderLocation(value) {
79
+ if (value === null || typeof value !== "object")
80
+ return null;
81
+ const record = value;
82
+ const uri = record.uri ?? record.targetUri;
83
+ if (typeof uri !== "string")
84
+ return null;
85
+ let display = uri;
86
+ try {
87
+ if (uri.startsWith("file:"))
88
+ display = fileURLToPath(uri);
89
+ }
90
+ catch {
91
+ display = uri;
92
+ }
93
+ return `${display}${position(record.targetRange ?? record.range)}`;
94
+ }
95
+ function renderLocations(value) {
96
+ if (value === null || value === undefined)
97
+ return [];
98
+ if (Array.isArray(value))
99
+ return value.flatMap((entry) => renderLocations(entry));
100
+ const single = renderLocation(value);
101
+ return single === null ? [] : [single];
102
+ }
103
+ function errorCode(error) {
104
+ return error instanceof KeycodeError ? error.code : "TOOL_INPUT_INVALID";
105
+ }
106
+ function messageOf(error) {
107
+ return error instanceof Error ? error.message : String(error);
108
+ }
109
+ export function createLspTool(options) {
110
+ const clients = new Map();
111
+ const versions = new Map();
112
+ const roots = options.roots ?? [options.cwd];
113
+ const clientFor = async (language, config) => {
114
+ const existing = clients.get(language);
115
+ if (existing)
116
+ return existing;
117
+ const client = new LspClient({
118
+ command: config.command,
119
+ args: config.args ?? [],
120
+ cwd: options.cwd,
121
+ rootUri: pathToFileURL(options.cwd).href,
122
+ timeoutMs: config.timeoutMs ?? options.timeoutMs ?? 10_000,
123
+ ...(config.initializationOptions === undefined
124
+ ? {}
125
+ : { initializationOptions: config.initializationOptions }),
126
+ });
127
+ await client.start();
128
+ await client.initialize();
129
+ clients.set(language, client);
130
+ return client;
131
+ };
132
+ return {
133
+ name: "LSP",
134
+ description: "Ask a configured language server for diagnostics, hover, definition, or references. Configure servers under \"lsp\" in settings.json, keyed by language id such as typescript or python.",
135
+ input: LspInput,
136
+ readOnly: true,
137
+ concurrency: "exclusive",
138
+ stop() {
139
+ for (const client of clients.values())
140
+ client.stop();
141
+ clients.clear();
142
+ versions.clear();
143
+ },
144
+ async execute(input, ctx) {
145
+ const absolute = isAbsolute(input.file) ? input.file : resolve(ctx.cwd, input.file);
146
+ if (!roots.some((root) => isInside(root, absolute))) {
147
+ return toolError(`PERMISSION_DENIED: ${input.file} is outside the workspace`, {
148
+ code: "PERMISSION_DENIED",
149
+ });
150
+ }
151
+ const target = resolveServer(absolute, options.servers);
152
+ if (target === null) {
153
+ return toolError(`No language server is configured for ${input.file}. Add one under "lsp" in settings.json.`, { code: "TOOL_UNSUPPORTED" });
154
+ }
155
+ try {
156
+ const client = await clientFor(target.language, target.config);
157
+ const uri = pathToFileURL(absolute).href;
158
+ const text = readFileSync(absolute, "utf8");
159
+ const version = versions.get(uri) ?? 0;
160
+ if (version === 0) {
161
+ client.openDocument(uri, target.language, text);
162
+ versions.set(uri, 1);
163
+ }
164
+ else {
165
+ client.updateDocument(uri, text, version + 1);
166
+ versions.set(uri, version + 1);
167
+ }
168
+ if (input.action === "diagnostics") {
169
+ const diagnostics = await client.waitForDiagnostics(uri, target.config.timeoutMs ?? options.timeoutMs ?? 15_000);
170
+ if (diagnostics.length === 0)
171
+ return toolOk(`No diagnostics for ${input.file}.`);
172
+ return toolOk(diagnostics
173
+ .map((diagnostic) => {
174
+ const line = diagnostic.range.start.line + 1;
175
+ const character = diagnostic.range.start.character + 1;
176
+ const severity = SEVERITY[diagnostic.severity ?? 3] ?? "info";
177
+ const source = diagnostic.source ? ` (${diagnostic.source})` : "";
178
+ return `${input.file}:${line}:${character} ${severity}: ${diagnostic.message}${source}`;
179
+ })
180
+ .join("\n"), { count: diagnostics.length });
181
+ }
182
+ if (input.line === undefined || input.character === undefined) {
183
+ return toolError(`${input.action} requires line and character (1-based).`, {
184
+ code: "TOOL_INPUT_INVALID",
185
+ });
186
+ }
187
+ const line = input.line - 1;
188
+ const character = input.character - 1;
189
+ if (input.action === "hover") {
190
+ const hover = await client.hover(uri, line, character);
191
+ return toolOk(renderHover(hover));
192
+ }
193
+ if (input.action === "definition") {
194
+ const definition = renderLocations(await client.definition(uri, line, character));
195
+ return toolOk(definition.length === 0 ? "No definition found." : definition.join("\n"));
196
+ }
197
+ const references = renderLocations(await client.references(uri, line, character));
198
+ return toolOk(references.length === 0 ? "No references found." : references.join("\n"), { count: references.length });
199
+ }
200
+ catch (error) {
201
+ return toolError(`${errorCode(error)}: ${messageOf(error)}`, { code: errorCode(error) });
202
+ }
203
+ },
204
+ };
205
+ }
206
+ //# sourceMappingURL=lsp.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"lsp.js","sourceRoot":"","sources":["../../src/tools/lsp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAsB,MAAM,kBAAkB,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;IACpE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAClD,CAAC,CAAC;AAmBH,MAAM,qBAAqB,GAA2B;IACpD,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,iBAAiB;IACzB,KAAK,EAAE,YAAY;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,YAAY;IACpB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,MAAM;IACb,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,GAAG;IACT,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,KAAK;IACb,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,aAAa;IACpB,MAAM,EAAE,YAAY;CACrB,CAAC;AAEF,MAAM,QAAQ,GAA2B;IACvC,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;CACV,CAAC;AAEF,SAAS,aAAa,CACpB,IAAY,EACZ,OAAwC;IAExC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,qBAAqB,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACvE,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC3D,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,uBAAuB,CAAC;IAC1E,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/D,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;YAAE,OAAO,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvE,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC,KAAK,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,KAA0D,CAAC;IAC1E,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC;IAC1C,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACxC,OAAO,IAAI,IAAI,GAAG,CAAC,IAAI,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC7E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC7D,MAAM,MAAM,GAAG,KAKd,CAAC;IACF,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,IAAI,MAAM,CAAC,SAAS,CAAC;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,OAAO,GAAG,GAAG,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;YAAE,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,GAAG,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,YAAY,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC;AAC3E,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAuB;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAqB,CAAC;IAC7C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE7C,MAAM,SAAS,GAAG,KAAK,EACrB,QAAgB,EAChB,MAAuB,EACH,EAAE;QACtB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvC,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE;YACvB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI;YACxC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM;YAC1D,GAAG,CAAC,MAAM,CAAC,qBAAqB,KAAK,SAAS;gBAC5C,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE,CAAC;SAC7D,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACrB,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,KAAK;QACX,WAAW,EACT,0LAA0L;QAC5L,KAAK,EAAE,QAAQ;QACf,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,WAAW;QACxB,IAAI;YACF,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACrD,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,KAAmB,EAAE,GAAgB;YACjD,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpF,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACpD,OAAO,SAAS,CAAC,sBAAsB,KAAK,CAAC,IAAI,2BAA2B,EAAE;oBAC5E,IAAI,EAAE,mBAAmB;iBAC1B,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;YACxD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;gBACpB,OAAO,SAAS,CACd,wCAAwC,KAAK,CAAC,IAAI,yCAAyC,EAC3F,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAC7B,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;gBAC/D,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC;gBACzC,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;oBAClB,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAChD,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;gBACvB,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;oBAC9C,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;gBACjC,CAAC;gBAED,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;oBACnC,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,kBAAkB,CACjD,GAAG,EACH,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM,CACvD,CAAC;oBACF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;wBAAE,OAAO,MAAM,CAAC,sBAAsB,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;oBACjF,OAAO,MAAM,CACX,WAAW;yBACR,GAAG,CAAC,CAAC,UAAyB,EAAE,EAAE;wBACjC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;wBAC7C,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;wBACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,MAAM,CAAC;wBAC9D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClE,OAAO,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,SAAS,IAAI,QAAQ,KAAK,UAAU,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC;oBAC1F,CAAC,CAAC;yBACD,IAAI,CAAC,IAAI,CAAC,EACb,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,CAC9B,CAAC;gBACJ,CAAC;gBAED,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;oBAC9D,OAAO,SAAS,CAAC,GAAG,KAAK,CAAC,MAAM,yCAAyC,EAAE;wBACzE,IAAI,EAAE,oBAAoB;qBAC3B,CAAC,CAAC;gBACL,CAAC;gBACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC;gBAC5B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC;gBAEtC,IAAI,KAAK,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;oBAC7B,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;oBACvD,OAAO,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;gBACpC,CAAC;gBACD,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;oBAClC,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;oBAClF,OAAO,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1F,CAAC;gBACD,MAAM,UAAU,GAAG,eAAe,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;gBAClF,OAAO,MAAM,CACX,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EACxE,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,CAC7B,CAAC;YACJ,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,SAAS,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC3F,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,19 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const NotebookEditInput: z.ZodObject<{
4
+ notebook_path: z.ZodString;
5
+ cell_id: z.ZodOptional<z.ZodString>;
6
+ new_source: z.ZodOptional<z.ZodString>;
7
+ cell_type: z.ZodOptional<z.ZodEnum<{
8
+ code: "code";
9
+ markdown: "markdown";
10
+ raw: "raw";
11
+ }>>;
12
+ edit_mode: z.ZodDefault<z.ZodEnum<{
13
+ replace: "replace";
14
+ delete: "delete";
15
+ insert: "insert";
16
+ }>>;
17
+ }, z.core.$strip>;
18
+ export type NotebookEditInputType = z.infer<typeof NotebookEditInput>;
19
+ export declare function createNotebookEditTool(): Tool<NotebookEditInputType>;
@@ -0,0 +1,83 @@
1
+ import { readFileSync } from "node:fs";
2
+ import { z } from "zod";
3
+ import { toolError, toolOk } from "../contracts/tool.js";
4
+ import { atomicWrite } from "../util/fsx.js";
5
+ import { guardPath, resolveUserPath } from "./shared.js";
6
+ export const NotebookEditInput = z.object({
7
+ notebook_path: z.string().min(1),
8
+ cell_id: z.string().optional(),
9
+ new_source: z.string().optional(),
10
+ cell_type: z.enum(["code", "markdown", "raw"]).optional(),
11
+ edit_mode: z.enum(["replace", "insert", "delete"]).default("replace"),
12
+ });
13
+ function findIndex(notebook, cellId) {
14
+ if (cellId === undefined || cellId === "")
15
+ return notebook.cells.length - 1;
16
+ const numeric = Number(cellId);
17
+ if (Number.isInteger(numeric) && numeric >= 0 && numeric < notebook.cells.length)
18
+ return numeric;
19
+ return notebook.cells.findIndex((cell) => cell.id === cellId);
20
+ }
21
+ export function createNotebookEditTool() {
22
+ return {
23
+ name: "NotebookEdit",
24
+ description: "Replace, insert, or delete Jupyter notebook cells while preserving outputs and valid ipynb JSON.",
25
+ input: NotebookEditInput,
26
+ readOnly: false,
27
+ concurrency: "exclusive",
28
+ async execute(input, ctx) {
29
+ const path = resolveUserPath(ctx, input.notebook_path);
30
+ const guard = guardPath(ctx, path);
31
+ if (guard)
32
+ return guard;
33
+ let notebook;
34
+ try {
35
+ notebook = JSON.parse(readFileSync(path, "utf8"));
36
+ }
37
+ catch (error) {
38
+ return toolError(`Cannot read notebook ${input.notebook_path}: ${error.message}`);
39
+ }
40
+ if (!Array.isArray(notebook.cells)) {
41
+ return toolError(`${input.notebook_path} is not a valid notebook (missing cells array).`);
42
+ }
43
+ const index = findIndex(notebook, input.cell_id);
44
+ if (input.edit_mode !== "insert" && index === -1) {
45
+ return toolError(`Cell not found: ${input.cell_id ?? "(none)"}`);
46
+ }
47
+ if (input.edit_mode !== "delete" && (input.new_source === undefined || input.new_source.length === 0)) {
48
+ return toolError("new_source is required for replace and insert.");
49
+ }
50
+ if (input.edit_mode === "replace") {
51
+ const cell = notebook.cells[index];
52
+ if (!cell)
53
+ return toolError(`Cell not found: ${input.cell_id ?? ""}`);
54
+ cell.source = input.new_source ?? "";
55
+ if (input.cell_type !== undefined)
56
+ cell.cell_type = input.cell_type;
57
+ }
58
+ else if (input.edit_mode === "insert") {
59
+ const at = index === -1 ? 0 : index + 1;
60
+ const cellType = input.cell_type ?? "code";
61
+ notebook.cells.splice(at, 0, {
62
+ cell_type: cellType,
63
+ source: input.new_source ?? "",
64
+ outputs: cellType === "code" ? [] : undefined,
65
+ metadata: {},
66
+ execution_count: null,
67
+ });
68
+ }
69
+ else {
70
+ notebook.cells.splice(index, 1);
71
+ }
72
+ ctx.onMutation?.([path]);
73
+ try {
74
+ atomicWrite(path, `${JSON.stringify(notebook, null, 2)}\n`);
75
+ }
76
+ catch (error) {
77
+ return toolError(`Failed to write notebook: ${error.message}`);
78
+ }
79
+ return toolOk(`${input.edit_mode} applied to ${input.notebook_path} (${notebook.cells.length} cells).`, { cells: notebook.cells.length, editMode: input.edit_mode });
80
+ },
81
+ };
82
+ }
83
+ //# sourceMappingURL=notebook.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"notebook.js","sourceRoot":"","sources":["../../src/tools/notebook.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 PowerShellInput: z.ZodObject<{
4
+ command: z.ZodString;
5
+ description: z.ZodOptional<z.ZodString>;
6
+ timeout: z.ZodOptional<z.ZodNumber>;
7
+ stdin: z.ZodOptional<z.ZodString>;
8
+ }, z.core.$strip>;
9
+ export type PowerShellInputType = z.infer<typeof PowerShellInput>;
10
+ export declare function createPowerShellTool(): Tool<PowerShellInputType>;
@@ -0,0 +1,83 @@
1
+ import { spawnSync } from "node:child_process";
2
+ import { z } from "zod";
3
+ import { toolError } from "../contracts/tool.js";
4
+ import { runCommand } from "./bash.js";
5
+ import { checkCommand } from "../sandbox/command.js";
6
+ import { capOutput } from "./shared.js";
7
+ export const PowerShellInput = z.object({
8
+ command: z.string().min(1),
9
+ description: z.string().optional(),
10
+ timeout: z.number().int().positive().max(600_000).optional(),
11
+ stdin: z.string().optional(),
12
+ });
13
+ function findPowerShell() {
14
+ if (process.platform !== "win32")
15
+ return null;
16
+ for (const candidate of ["pwsh", "powershell"]) {
17
+ try {
18
+ const result = spawnSync(candidate, ["-NoProfile", "-Command", "exit 0"], {
19
+ windowsHide: true,
20
+ timeout: 5_000,
21
+ });
22
+ if (result.status === 0) {
23
+ return { command: candidate, args: ["-NoLogo", "-NoProfile", "-Command"] };
24
+ }
25
+ }
26
+ catch {
27
+ // Try the next candidate.
28
+ }
29
+ }
30
+ return null;
31
+ }
32
+ export function createPowerShellTool() {
33
+ return {
34
+ name: "PowerShell",
35
+ description: "Run a PowerShell command on Windows. Use Bash on macOS and Linux.",
36
+ input: PowerShellInput,
37
+ readOnly: false,
38
+ concurrency: "exclusive",
39
+ async execute(input, ctx) {
40
+ const shell = findPowerShell();
41
+ if (shell === null) {
42
+ return toolError("TOOL_UNSUPPORTED: PowerShell is only available on Windows.", {
43
+ code: "TOOL_UNSUPPORTED",
44
+ });
45
+ }
46
+ if (ctx.sandbox !== undefined) {
47
+ const guarded = checkCommand(ctx.sandbox, input.command, ctx.cwd);
48
+ if (!guarded.allowed) {
49
+ return toolError(`SANDBOX_DENIED: ${guarded.reason ?? "blocked by the sandbox"}`, {
50
+ code: "SANDBOX_DENIED",
51
+ });
52
+ }
53
+ }
54
+ const result = await runCommand({
55
+ command: shell.command,
56
+ args: [...shell.args, input.command],
57
+ shell: false,
58
+ cwd: ctx.cwd,
59
+ timeoutMs: input.timeout,
60
+ stdin: input.stdin,
61
+ signal: ctx.signal,
62
+ });
63
+ if (result.timedOut) {
64
+ return toolError(`PowerShell timed out after ${input.timeout ?? 120_000} ms.`, {
65
+ code: "TOOL_TIMEOUT",
66
+ });
67
+ }
68
+ let output = result.stdout;
69
+ if (result.stderr.length > 0) {
70
+ output += `${output.length > 0 ? "\n" : ""}[stderr]\n${result.stderr}`;
71
+ }
72
+ if (output.trim() === "")
73
+ output = "(no output)";
74
+ const capped = capOutput(output, ctx, "powershell");
75
+ return {
76
+ ok: result.exitCode === 0,
77
+ content: [{ type: "text", text: capped.text }],
78
+ metadata: { exitCode: result.exitCode, durationMs: result.durationMs },
79
+ };
80
+ },
81
+ };
82
+ }
83
+ //# sourceMappingURL=powershell.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"powershell.js","sourceRoot":"","sources":["../../src/tools/powershell.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,15 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const QuestionInput: z.ZodObject<{
4
+ questions: z.ZodArray<z.ZodObject<{
5
+ question: z.ZodString;
6
+ header: z.ZodString;
7
+ options: z.ZodArray<z.ZodObject<{
8
+ label: z.ZodString;
9
+ description: z.ZodOptional<z.ZodString>;
10
+ }, z.core.$strip>>;
11
+ multiSelect: z.ZodOptional<z.ZodBoolean>;
12
+ }, z.core.$strip>>;
13
+ }, z.core.$strip>;
14
+ export type QuestionInputType = z.infer<typeof QuestionInput>;
15
+ export declare function createQuestionTool(): Tool<QuestionInputType>;
@@ -0,0 +1,50 @@
1
+ import { z } from "zod";
2
+ import { toolError } from "../contracts/tool.js";
3
+ export const QuestionInput = z.object({
4
+ questions: z
5
+ .array(z.object({
6
+ question: z.string().min(1),
7
+ header: z.string().min(1).max(30),
8
+ options: z
9
+ .array(z.object({
10
+ label: z.string().min(1),
11
+ description: z.string().optional(),
12
+ }))
13
+ .min(2)
14
+ .max(4),
15
+ multiSelect: z.boolean().optional(),
16
+ }))
17
+ .min(1)
18
+ .max(4),
19
+ });
20
+ export function createQuestionTool() {
21
+ return {
22
+ name: "AskUserQuestion",
23
+ description: "Ask the user one to four multiple-choice questions. Use when a decision cannot be inferred from the repository.",
24
+ input: QuestionInput,
25
+ readOnly: true,
26
+ concurrency: "exclusive",
27
+ async execute(input, ctx) {
28
+ if (!ctx.askQuestions) {
29
+ return toolError("AskUserQuestion requires an interactive session.", {
30
+ code: "PERMISSION_PROMPT_UNAVAILABLE",
31
+ });
32
+ }
33
+ const result = await ctx.askQuestions(input.questions.map((question) => ({
34
+ question: question.question,
35
+ header: question.header,
36
+ options: question.options,
37
+ multiple: question.multiSelect,
38
+ })));
39
+ if (result.cancelled) {
40
+ return toolError("User cancelled the question.", { code: "USER_CANCELLED" });
41
+ }
42
+ return {
43
+ ok: true,
44
+ content: [{ type: "text", text: JSON.stringify({ answers: result.answers }, null, 2) }],
45
+ metadata: { answers: result.answers },
46
+ };
47
+ },
48
+ };
49
+ }
50
+ //# sourceMappingURL=question.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"question.js","sourceRoot":"","sources":["../../src/tools/question.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAC,MAAM,CAAC;IACpC,SAAS,EAAE,CAAC;SACT,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;QACP,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;aACP,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YACxB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;QACT,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;KACpC,CAAC,CACH;SACA,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;CACV,CAAC,CAAC;AAIH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,WAAW,EACT,iHAAiH;QACnH,KAAK,EAAE,aAAa;QACpB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,WAAW;QACxB,KAAK,CAAC,OAAO,CAAC,KAAwB,EAAE,GAAgB;YACtD,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;gBACtB,OAAO,SAAS,CAAC,kDAAkD,EAAE;oBACnE,IAAI,EAAE,+BAA+B;iBACtC,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CACnC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,QAAQ,EAAE,QAAQ,CAAC,WAAW;aAC/B,CAAC,CAAC,CACJ,CAAC;YACF,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,OAAO,SAAS,CAAC,8BAA8B,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;YAC/E,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACvF,QAAQ,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;aACtC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,10 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const ReadInput: z.ZodObject<{
4
+ file_path: z.ZodString;
5
+ offset: z.ZodOptional<z.ZodNumber>;
6
+ limit: z.ZodOptional<z.ZodNumber>;
7
+ pages: z.ZodOptional<z.ZodString>;
8
+ }, z.core.$strip>;
9
+ export type ReadInputType = z.infer<typeof ReadInput>;
10
+ export declare function createReadTool(): Tool<ReadInputType>;