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,188 @@
1
+ import { readFileSync, statSync } from "node:fs";
2
+ import { extname } from "node:path";
3
+ import { inflateSync } from "node:zlib";
4
+ import { z } from "zod";
5
+ import { toolError } from "../contracts/tool.js";
6
+ import { resolveUserPath } from "./shared.js";
7
+ import { isInside } from "../util/paths.js";
8
+ export const ReadInput = z.object({
9
+ file_path: z.string().min(1),
10
+ offset: z.number().int().positive().optional(),
11
+ limit: z.number().int().positive().max(20_000).optional(),
12
+ pages: z.string().optional(),
13
+ });
14
+ const IMAGE_TYPES = {
15
+ ".png": "image/png",
16
+ ".jpg": "image/jpeg",
17
+ ".jpeg": "image/jpeg",
18
+ ".gif": "image/gif",
19
+ ".webp": "image/webp",
20
+ };
21
+ function isBinary(buffer) {
22
+ const sample = buffer.subarray(0, 8_192);
23
+ return sample.includes(0);
24
+ }
25
+ function parsePageRange(range, total) {
26
+ const pages = new Set();
27
+ for (const part of range.split(",")) {
28
+ const trimmed = part.trim();
29
+ if (trimmed === "")
30
+ continue;
31
+ const match = /^(\d+)(?:-(\d+))?$/.exec(trimmed);
32
+ if (!match)
33
+ continue;
34
+ const start = Number(match[1]);
35
+ const end = match[2] === undefined ? start : Number(match[2]);
36
+ for (let page = Math.min(start, end); page <= Math.max(start, end); page += 1) {
37
+ if (page >= 1 && page <= total)
38
+ pages.add(page);
39
+ }
40
+ }
41
+ return [...pages].sort((a, b) => a - b);
42
+ }
43
+ function pdfTextPages(buffer) {
44
+ const text = buffer.toString("latin1");
45
+ const chunks = text.split(/\/Type\s*\/Page(?![s])/).slice(1);
46
+ const pages = [];
47
+ for (const chunk of chunks) {
48
+ const streamMatch = /stream\r?\n([\s\S]*?)\r?\nendstream/.exec(chunk);
49
+ let content = "";
50
+ if (streamMatch?.[1] !== undefined) {
51
+ const raw = Buffer.from(streamMatch[1], "latin1");
52
+ if (/FlateDecode/.test(chunk)) {
53
+ try {
54
+ content = inflateSync(raw).toString("latin1");
55
+ }
56
+ catch {
57
+ content = "";
58
+ }
59
+ }
60
+ else {
61
+ content = streamMatch[1];
62
+ }
63
+ }
64
+ const strings = [];
65
+ for (const match of content.matchAll(/\(((?:\\.|[^\\)])*)\)\s*Tj/g)) {
66
+ if (match[1] !== undefined)
67
+ strings.push(match[1].replace(/\\([()\\])/g, "$1"));
68
+ }
69
+ for (const match of content.matchAll(/\[(.*?)\]\s*TJ/gs)) {
70
+ const inner = match[1] ?? "";
71
+ const parts = [...inner.matchAll(/\(((?:\\.|[^\\)])*)\)/g)].map((item) => item[1] ?? "");
72
+ if (parts.length > 0)
73
+ strings.push(parts.join(""));
74
+ }
75
+ pages.push(strings.join("\n"));
76
+ }
77
+ return pages;
78
+ }
79
+ function renderNotebook(content) {
80
+ const notebook = JSON.parse(content);
81
+ const cells = notebook.cells ?? [];
82
+ return cells
83
+ .map((cell, index) => {
84
+ const source = Array.isArray(cell.source) ? cell.source.join("") : (cell.source ?? "");
85
+ const header = `--- cell ${index + 1} (${cell.cell_type ?? "unknown"}) ---`;
86
+ const outputs = (cell.outputs ?? [])
87
+ .map((output) => {
88
+ if (output.text !== undefined) {
89
+ return Array.isArray(output.text) ? output.text.join("") : output.text;
90
+ }
91
+ const plain = output.data?.["text/plain"];
92
+ return Array.isArray(plain) ? plain.join("") : typeof plain === "string" ? plain : "";
93
+ })
94
+ .filter((value) => value.length > 0)
95
+ .join("\n");
96
+ return outputs.length > 0 ? `${header}\n${source}\n[output]\n${outputs}` : `${header}\n${source}`;
97
+ })
98
+ .join("\n\n");
99
+ }
100
+ export function createReadTool() {
101
+ return {
102
+ name: "Read",
103
+ description: "Read a file from the workspace. Text is returned with line numbers. Supports offsets, images, PDF page ranges, and Jupyter notebooks.",
104
+ input: ReadInput,
105
+ readOnly: true,
106
+ concurrency: "parallel",
107
+ async execute(input, ctx) {
108
+ const path = resolveUserPath(ctx, input.file_path);
109
+ if (!isInside(ctx.cwd, path)) {
110
+ return toolError(`Path outside workspace: ${input.file_path}`);
111
+ }
112
+ let stat;
113
+ try {
114
+ stat = statSync(path);
115
+ }
116
+ catch {
117
+ return toolError(`File not found: ${input.file_path}`);
118
+ }
119
+ if (!stat.isFile())
120
+ return toolError(`${input.file_path} is not a regular file.`);
121
+ const extension = extname(path).toLowerCase();
122
+ if (IMAGE_TYPES[extension]) {
123
+ if (stat.size > 8 * 1024 * 1024)
124
+ return toolError("Image is larger than 8 MB.");
125
+ const data = readFileSync(path).toString("base64");
126
+ ctx.state.readFiles.add(path);
127
+ return {
128
+ ok: true,
129
+ content: [
130
+ { type: "text", text: `Image: ${input.file_path} (${IMAGE_TYPES[extension]}, ${stat.size} bytes)` },
131
+ { type: "image", mime: IMAGE_TYPES[extension], data },
132
+ ],
133
+ display: `Read image ${input.file_path}`,
134
+ };
135
+ }
136
+ let buffer;
137
+ try {
138
+ buffer = readFileSync(path);
139
+ }
140
+ catch (error) {
141
+ return toolError(`Cannot read ${input.file_path}: ${error.message}`);
142
+ }
143
+ if (extension === ".pdf") {
144
+ const pages = pdfTextPages(buffer);
145
+ const selected = input.pages
146
+ ? parsePageRange(input.pages, pages.length)
147
+ : pages.map((_, index) => index + 1);
148
+ const body = selected
149
+ .map((page) => `--- page ${page} ---\n${pages[page - 1] ?? ""}`)
150
+ .join("\n\n");
151
+ ctx.state.readFiles.add(path);
152
+ return {
153
+ ok: true,
154
+ content: [{ type: "text", text: body.length > 0 ? body : "(no extractable text)" }],
155
+ display: `Read PDF ${input.file_path}`,
156
+ };
157
+ }
158
+ if (extension === ".ipynb") {
159
+ ctx.state.readFiles.add(path);
160
+ return {
161
+ ok: true,
162
+ content: [{ type: "text", text: renderNotebook(buffer.toString("utf8")) }],
163
+ display: `Read notebook ${input.file_path}`,
164
+ };
165
+ }
166
+ if (isBinary(buffer)) {
167
+ return toolError(`${input.file_path} appears to be a binary file. Use an image or PDF reader for supported formats.`);
168
+ }
169
+ const text = buffer.toString("utf8");
170
+ const allLines = text.split(/\r?\n/);
171
+ const offset = input.offset ?? 1;
172
+ const limit = input.limit ?? 2_000;
173
+ const selected = allLines.slice(offset - 1, offset - 1 + limit);
174
+ const width = String(offset + selected.length - 1).length;
175
+ const rendered = selected
176
+ .map((line, index) => `${String(offset + index).padStart(width, " ")}\t${line}`)
177
+ .join("\n");
178
+ ctx.state.readFiles.add(path);
179
+ return {
180
+ ok: true,
181
+ content: [{ type: "text", text: rendered }],
182
+ display: `Read ${input.file_path}`,
183
+ metadata: { lines: allLines.length, offset, limit },
184
+ };
185
+ },
186
+ };
187
+ }
188
+ //# sourceMappingURL=read.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/tools/read.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,8 @@
1
+ import type { ToolContext, ToolResult } from "../contracts/tool.js";
2
+ export declare const MAX_TOOL_OUTPUT = 30000;
3
+ export declare function capOutput(text: string, ctx: ToolContext, label: string): {
4
+ text: string;
5
+ spilled: string | null;
6
+ };
7
+ export declare function guardPath(ctx: ToolContext, path: string): ToolResult | null;
8
+ export declare function resolveUserPath(ctx: ToolContext, path: string): string;
@@ -0,0 +1,35 @@
1
+ import { mkdirSync, writeFileSync } from "node:fs";
2
+ import { homedir } from "node:os";
3
+ import { isAbsolute, join, resolve } from "node:path";
4
+ import { toolError } from "../contracts/tool.js";
5
+ import { toolOutputDir, isInside } from "../util/paths.js";
6
+ import { newId } from "../util/ids.js";
7
+ export const MAX_TOOL_OUTPUT = 30_000;
8
+ export function capOutput(text, ctx, label) {
9
+ if (text.length <= MAX_TOOL_OUTPUT)
10
+ return { text, spilled: null };
11
+ const dir = toolOutputDir(ctx.home);
12
+ mkdirSync(dir, { recursive: true });
13
+ const path = join(dir, `${newId(label)}.txt`);
14
+ writeFileSync(path, text);
15
+ const head = text.slice(0, 6_000);
16
+ const tail = text.slice(-3_000);
17
+ return {
18
+ text: `${head}\n\n...[${text.length - 9_000} characters omitted; full output at ${path}]...\n\n${tail}`,
19
+ spilled: path,
20
+ };
21
+ }
22
+ export function guardPath(ctx, path) {
23
+ if (ctx.workspaceRoots.some((root) => isInside(root, path)))
24
+ return null;
25
+ return toolError(`PATH_OUTSIDE_WORKSPACE: ${path} is outside the workspace. Use --add-dir to allow it.`, { code: "PATH_OUTSIDE_WORKSPACE" });
26
+ }
27
+ export function resolveUserPath(ctx, path) {
28
+ if (path === "~")
29
+ return homedir();
30
+ if (path.startsWith("~/") || path.startsWith("~\\")) {
31
+ return resolve(homedir(), path.slice(2));
32
+ }
33
+ return isAbsolute(path) ? path : resolve(ctx.cwd, path);
34
+ }
35
+ //# sourceMappingURL=shared.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/tools/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC;AAEtC,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,GAAgB,EAChB,KAAa;IAEb,IAAI,IAAI,CAAC,MAAM,IAAI,eAAe;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IAChC,OAAO;QACL,IAAI,EAAE,GAAG,IAAI,WAAW,IAAI,CAAC,MAAM,GAAG,KAAK,uCAAuC,IAAI,WAAW,IAAI,EAAE;QACvG,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAgB,EAAE,IAAY;IACtD,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACzE,OAAO,SAAS,CACd,2BAA2B,IAAI,uDAAuD,EACtF,EAAE,IAAI,EAAE,wBAAwB,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAgB,EAAE,IAAY;IAC5D,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,OAAO,EAAE,CAAC;IACnC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC"}
@@ -0,0 +1,9 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ import { type SkillMetadata } from "../extensions/skills.js";
4
+ export declare const SkillInput: z.ZodObject<{
5
+ skill: z.ZodString;
6
+ args: z.ZodOptional<z.ZodString>;
7
+ }, z.core.$strip>;
8
+ export type SkillInputType = z.infer<typeof SkillInput>;
9
+ export declare function createSkillTool(skills: SkillMetadata[]): Tool<SkillInputType>;
@@ -0,0 +1,38 @@
1
+ import { z } from "zod";
2
+ import { toolError, toolOk } from "../contracts/tool.js";
3
+ import { findSkill, loadSkill, renderSkill } from "../extensions/skills.js";
4
+ export const SkillInput = z.object({
5
+ skill: z.string().min(1),
6
+ args: z.string().optional(),
7
+ });
8
+ export function createSkillTool(skills) {
9
+ return {
10
+ name: "Skill",
11
+ description: "Load a skill's instructions by name and apply its allowed-tools restriction to the rest of the turn.",
12
+ input: SkillInput,
13
+ readOnly: true,
14
+ concurrency: "exclusive",
15
+ async execute(input, ctx) {
16
+ const metadata = findSkill(skills, input.skill);
17
+ if (!metadata) {
18
+ return toolError(`Skill not found: ${input.skill}. Use /skills to list available skills.`, {
19
+ code: "TOOL_INPUT_INVALID",
20
+ });
21
+ }
22
+ const skill = loadSkill(metadata);
23
+ const rendered = renderSkill(skill, input.args ?? "");
24
+ ctx.state.metadata.set("skill.name", skill.name);
25
+ if (skill.allowedTools && skill.allowedTools.length > 0) {
26
+ ctx.state.metadata.set("skill.allowedTools", skill.allowedTools);
27
+ }
28
+ else {
29
+ ctx.state.metadata.delete("skill.allowedTools");
30
+ }
31
+ return toolOk(`# Skill: ${skill.name}\n\n${rendered}`, {
32
+ skill: skill.name,
33
+ allowedTools: skill.allowedTools ?? null,
34
+ });
35
+ },
36
+ };
37
+ }
38
+ //# sourceMappingURL=skill.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"skill.js","sourceRoot":"","sources":["../../src/tools/skill.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAsB,MAAM,yBAAyB,CAAC;AAEhG,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,CAAC,MAAM,CAAC;IACjC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACxB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC,CAAC;AAIH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO;QACL,IAAI,EAAE,OAAO;QACb,WAAW,EACT,sGAAsG;QACxG,KAAK,EAAE,UAAU;QACjB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,WAAW;QACxB,KAAK,CAAC,OAAO,CAAC,KAAqB,EAAE,GAAgB;YACnD,MAAM,QAAQ,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,OAAO,SAAS,CAAC,oBAAoB,KAAK,CAAC,KAAK,yCAAyC,EAAE;oBACzF,IAAI,EAAE,oBAAoB;iBAC3B,CAAC,CAAC;YACL,CAAC;YACD,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;YAClC,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACtD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACjD,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxD,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;YACnE,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAClD,CAAC;YACD,OAAO,MAAM,CAAC,YAAY,KAAK,CAAC,IAAI,OAAO,QAAQ,EAAE,EAAE;gBACrD,KAAK,EAAE,KAAK,CAAC,IAAI;gBACjB,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;aACzC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export declare const TaskInput: z.ZodObject<{
4
+ action: z.ZodEnum<{
5
+ output: "output";
6
+ get: "get";
7
+ create: "create";
8
+ list: "list";
9
+ update: "update";
10
+ stop: "stop";
11
+ }>;
12
+ command: z.ZodOptional<z.ZodString>;
13
+ task_id: z.ZodOptional<z.ZodString>;
14
+ status: z.ZodOptional<z.ZodEnum<{
15
+ completed: "completed";
16
+ running: "running";
17
+ stopped: "stopped";
18
+ failed: "failed";
19
+ }>>;
20
+ note: z.ZodOptional<z.ZodString>;
21
+ limit: z.ZodOptional<z.ZodNumber>;
22
+ cwd: z.ZodOptional<z.ZodString>;
23
+ }, z.core.$strip>;
24
+ export type TaskInputType = z.infer<typeof TaskInput>;
25
+ export interface TaskRecord {
26
+ id: string;
27
+ command: string;
28
+ cwd: string;
29
+ pid: number | null;
30
+ startedAt: string;
31
+ status: "running" | "stopped" | "completed" | "failed";
32
+ log: string;
33
+ note?: string | undefined;
34
+ }
35
+ export declare function createTaskTool(): Tool<TaskInputType>;
@@ -0,0 +1,139 @@
1
+ import { spawn, spawnSync } from "node:child_process";
2
+ import { closeSync, existsSync, openSync, readFileSync, readdirSync, 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 { ensureDir } from "../util/fsx.js";
7
+ import { newId } from "../util/ids.js";
8
+ import { tasksDir } from "../util/paths.js";
9
+ export const TaskInput = z.object({
10
+ action: z.enum(["create", "get", "list", "update", "stop", "output"]),
11
+ command: z.string().optional(),
12
+ task_id: z.string().optional(),
13
+ status: z.enum(["running", "stopped", "completed", "failed"]).optional(),
14
+ note: z.string().optional(),
15
+ limit: z.number().int().positive().max(100_000).optional(),
16
+ cwd: z.string().optional(),
17
+ });
18
+ function recordPath(home, id) {
19
+ return join(tasksDir(home), `${id}.json`);
20
+ }
21
+ function readRecord(home, id) {
22
+ const path = recordPath(home, id);
23
+ if (!existsSync(path))
24
+ return null;
25
+ try {
26
+ return JSON.parse(readFileSync(path, "utf8"));
27
+ }
28
+ catch {
29
+ return null;
30
+ }
31
+ }
32
+ function writeRecord(home, record) {
33
+ ensureDir(tasksDir(home));
34
+ writeFileSync(recordPath(home, record.id), JSON.stringify(record, null, 2));
35
+ }
36
+ function killTree(pid) {
37
+ if (process.platform === "win32") {
38
+ spawnSync("taskkill", ["/pid", String(pid), "/T", "/F"], { windowsHide: true });
39
+ }
40
+ else {
41
+ try {
42
+ process.kill(-pid, "SIGKILL");
43
+ }
44
+ catch {
45
+ try {
46
+ process.kill(pid, "SIGKILL");
47
+ }
48
+ catch {
49
+ // Already exited.
50
+ }
51
+ }
52
+ }
53
+ }
54
+ export function createTaskTool() {
55
+ return {
56
+ name: "Task",
57
+ description: "Create, inspect, list, update, stop, and read output from durable background tasks.",
58
+ input: TaskInput,
59
+ readOnly: false,
60
+ concurrency: "exclusive",
61
+ async execute(input, ctx) {
62
+ const dir = tasksDir(ctx.home);
63
+ ensureDir(dir);
64
+ if (input.action === "create") {
65
+ if (!input.command)
66
+ return toolError("command is required for create.");
67
+ const id = newId("task");
68
+ const log = join(dir, `${id}.log`);
69
+ const fd = openSync(log, "a");
70
+ const child = spawn(input.command, {
71
+ cwd: input.cwd ?? ctx.cwd,
72
+ env: process.env,
73
+ shell: true,
74
+ detached: false,
75
+ windowsHide: true,
76
+ stdio: ["ignore", fd, fd],
77
+ });
78
+ closeSync(fd);
79
+ child.unref();
80
+ const record = {
81
+ id,
82
+ command: input.command,
83
+ cwd: input.cwd ?? ctx.cwd,
84
+ pid: child.pid ?? null,
85
+ startedAt: new Date().toISOString(),
86
+ status: "running",
87
+ log,
88
+ };
89
+ writeRecord(ctx.home, record);
90
+ return toolOk(JSON.stringify(record, null, 2), { task: record });
91
+ }
92
+ if (input.action === "list") {
93
+ const records = readdirSync(dir)
94
+ .filter((entry) => entry.endsWith(".json"))
95
+ .map((entry) => readRecord(ctx.home, entry.replace(/\.json$/, "")))
96
+ .filter((record) => record !== null);
97
+ return toolOk(records.length === 0 ? "No tasks." : JSON.stringify(records, null, 2), {
98
+ count: records.length,
99
+ });
100
+ }
101
+ if (!input.task_id)
102
+ return toolError(`task_id is required for ${input.action}.`);
103
+ const record = readRecord(ctx.home, input.task_id);
104
+ if (!record)
105
+ return toolError(`Task not found: ${input.task_id}`);
106
+ if (input.action === "get") {
107
+ return toolOk(JSON.stringify(record, null, 2), { task: record });
108
+ }
109
+ if (input.action === "update") {
110
+ if (input.status)
111
+ record.status = input.status;
112
+ if (input.note)
113
+ record.note = input.note;
114
+ writeRecord(ctx.home, record);
115
+ return toolOk(JSON.stringify(record, null, 2), { task: record });
116
+ }
117
+ if (input.action === "stop") {
118
+ if (record.pid !== null && record.status === "running")
119
+ killTree(record.pid);
120
+ record.status = "stopped";
121
+ writeRecord(ctx.home, record);
122
+ return toolOk(`Stopped task ${record.id}.`, { task: record });
123
+ }
124
+ const limit = input.limit ?? 10_000;
125
+ let output = "";
126
+ try {
127
+ output = readFileSync(record.log, "utf8");
128
+ }
129
+ catch {
130
+ output = "";
131
+ }
132
+ return toolOk(output.length === 0 ? "(no output)" : output.slice(-limit), {
133
+ taskId: record.id,
134
+ bytes: output.length,
135
+ });
136
+ },
137
+ };
138
+ }
139
+ //# sourceMappingURL=tasks.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/tools/tasks.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,27 @@
1
+ import { z } from "zod";
2
+ import type { Tool } from "../contracts/tool.js";
3
+ export interface TodoItem {
4
+ id: string;
5
+ content: string;
6
+ status: "pending" | "in_progress" | "completed";
7
+ priority?: string | undefined;
8
+ }
9
+ export declare const TodoInput: z.ZodObject<{
10
+ todos: z.ZodArray<z.ZodObject<{
11
+ id: z.ZodOptional<z.ZodString>;
12
+ content: z.ZodString;
13
+ status: z.ZodEnum<{
14
+ pending: "pending";
15
+ in_progress: "in_progress";
16
+ completed: "completed";
17
+ }>;
18
+ priority: z.ZodOptional<z.ZodEnum<{
19
+ low: "low";
20
+ medium: "medium";
21
+ high: "high";
22
+ }>>;
23
+ }, z.core.$strip>>;
24
+ }, z.core.$strip>;
25
+ export type TodoInputType = z.infer<typeof TodoInput>;
26
+ export declare function renderTodos(todos: TodoItem[]): string;
27
+ export declare function createTodoTool(): Tool<TodoInputType>;
@@ -0,0 +1,40 @@
1
+ import { z } from "zod";
2
+ import { toolOk } from "../contracts/tool.js";
3
+ import { newId } from "../util/ids.js";
4
+ export const TodoInput = z.object({
5
+ todos: z.array(z.object({
6
+ id: z.string().optional(),
7
+ content: z.string().min(1),
8
+ status: z.enum(["pending", "in_progress", "completed"]),
9
+ priority: z.enum(["high", "medium", "low"]).optional(),
10
+ })),
11
+ });
12
+ export function renderTodos(todos) {
13
+ return todos
14
+ .map((todo) => {
15
+ const mark = todo.status === "completed" ? "[x]" : todo.status === "in_progress" ? "[>]" : "[ ]";
16
+ return `${mark} ${todo.content}${todo.priority ? ` (${todo.priority})` : ""}`;
17
+ })
18
+ .join("\n");
19
+ }
20
+ export function createTodoTool() {
21
+ return {
22
+ name: "TodoWrite",
23
+ description: "Replace the session todo list. Use it to track multi-step work and keep exactly one item in_progress.",
24
+ input: TodoInput,
25
+ readOnly: true,
26
+ concurrency: "exclusive",
27
+ async execute(input, ctx) {
28
+ const todos = input.todos.map((todo) => ({
29
+ id: todo.id ?? newId("todo"),
30
+ content: todo.content,
31
+ status: todo.status,
32
+ ...(todo.priority === undefined ? {} : { priority: todo.priority }),
33
+ }));
34
+ ctx.state.todos = todos;
35
+ const completed = todos.filter((todo) => todo.status === "completed").length;
36
+ return toolOk(`${completed}/${todos.length} complete\n${renderTodos(todos)}`, { todos });
37
+ },
38
+ };
39
+ }
40
+ //# sourceMappingURL=todo.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"todo.js","sourceRoot":"","sources":["../../src/tools/todo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AASvC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,KAAK,CACZ,CAAC,CAAC,MAAM,CAAC;QACP,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,CAAC,CAAC;QACvD,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE;KACvD,CAAC,CACH;CACF,CAAC,CAAC;AAIH,MAAM,UAAU,WAAW,CAAC,KAAiB;IAC3C,OAAO,KAAK;SACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACjG,OAAO,GAAG,IAAI,IAAI,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IAChF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,uGAAuG;QACzG,KAAK,EAAE,SAAS;QAChB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,WAAW;QACxB,KAAK,CAAC,OAAO,CAAC,KAAoB,EAAE,GAAgB;YAClD,MAAM,KAAK,GAAe,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACnD,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC;gBAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;aACpE,CAAC,CAAC,CAAC;YACJ,GAAG,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;YACxB,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,MAAM,CAAC;YAC7E,OAAO,MAAM,CAAC,GAAG,SAAS,IAAI,KAAK,CAAC,MAAM,cAAc,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3F,CAAC;KACF,CAAC;AACJ,CAAC"}
@@ -0,0 +1,15 @@
1
+ export interface WalkOptions {
2
+ cwd: string;
3
+ noIgnore?: boolean | undefined;
4
+ maxEntries?: number | undefined;
5
+ includeDirectories?: boolean | undefined;
6
+ }
7
+ export interface WalkedFile {
8
+ path: string;
9
+ relative: string;
10
+ mtimeMs: number;
11
+ size: number;
12
+ }
13
+ export declare function walkFiles(options: WalkOptions): WalkedFile[];
14
+ export declare function matchGlob(pattern: string, relativePath: string): boolean;
15
+ export declare function toAbsolutePath(cwd: string, path: string): string;