@j0hanz/filesystem-context-mcp 1.3.0 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (283) hide show
  1. package/README.md +251 -504
  2. package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.js +1 -1
  3. package/dist/__tests__/lib/file-operations/search-content-edge-cases.test.js.map +1 -1
  4. package/dist/__tests__/lib/file-operations/search-definitions-helpers.test.d.ts +2 -0
  5. package/dist/__tests__/lib/file-operations/search-definitions-helpers.test.d.ts.map +1 -0
  6. package/dist/__tests__/lib/file-operations/search-definitions-helpers.test.js +43 -0
  7. package/dist/__tests__/lib/file-operations/search-definitions-helpers.test.js.map +1 -0
  8. package/dist/__tests__/lib/file-operations/search-definitions.fixtures.d.ts +7 -0
  9. package/dist/__tests__/lib/file-operations/search-definitions.fixtures.d.ts.map +1 -0
  10. package/dist/__tests__/lib/file-operations/search-definitions.fixtures.js +113 -0
  11. package/dist/__tests__/lib/file-operations/search-definitions.fixtures.js.map +1 -0
  12. package/dist/__tests__/lib/file-operations/search-definitions.test.js +1 -112
  13. package/dist/__tests__/lib/file-operations/search-definitions.test.js.map +1 -1
  14. package/dist/__tests__/lib/file-operations/sorting.test.js +15 -40
  15. package/dist/__tests__/lib/file-operations/sorting.test.js.map +1 -1
  16. package/dist/__tests__/lib/path-validation-errors.test.js +1 -1
  17. package/dist/__tests__/lib/path-validation-errors.test.js.map +1 -1
  18. package/dist/__tests__/lib/path-validation.test.js +17 -0
  19. package/dist/__tests__/lib/path-validation.test.js.map +1 -1
  20. package/dist/config/formatting.d.ts +14 -0
  21. package/dist/config/formatting.d.ts.map +1 -0
  22. package/dist/config/formatting.js +34 -0
  23. package/dist/config/formatting.js.map +1 -0
  24. package/dist/config/types.d.ts +3 -97
  25. package/dist/config/types.d.ts.map +1 -1
  26. package/dist/config/types.js.map +1 -1
  27. package/dist/index.js +26 -2
  28. package/dist/index.js.map +1 -1
  29. package/dist/instructions.md +151 -170
  30. package/dist/lib/constants.d.ts +1 -5
  31. package/dist/lib/constants.d.ts.map +1 -1
  32. package/dist/lib/constants.js +19 -15
  33. package/dist/lib/constants.js.map +1 -1
  34. package/dist/lib/errors.d.ts +0 -2
  35. package/dist/lib/errors.d.ts.map +1 -1
  36. package/dist/lib/errors.js +2 -30
  37. package/dist/lib/errors.js.map +1 -1
  38. package/dist/lib/file-operations/analyze-directory.d.ts.map +1 -1
  39. package/dist/lib/file-operations/analyze-directory.js +8 -1
  40. package/dist/lib/file-operations/analyze-directory.js.map +1 -1
  41. package/dist/lib/file-operations/batch-results.d.ts +2 -1
  42. package/dist/lib/file-operations/batch-results.d.ts.map +1 -1
  43. package/dist/lib/file-operations/compute-checksums.d.ts +1 -0
  44. package/dist/lib/file-operations/compute-checksums.d.ts.map +1 -1
  45. package/dist/lib/file-operations/compute-checksums.js +58 -45
  46. package/dist/lib/file-operations/compute-checksums.js.map +1 -1
  47. package/dist/lib/file-operations/directory-tree-builders.d.ts +7 -0
  48. package/dist/lib/file-operations/directory-tree-builders.d.ts.map +1 -0
  49. package/dist/lib/file-operations/directory-tree-builders.js +58 -0
  50. package/dist/lib/file-operations/directory-tree-builders.js.map +1 -0
  51. package/dist/lib/file-operations/directory-tree-helpers.d.ts +0 -5
  52. package/dist/lib/file-operations/directory-tree-helpers.d.ts.map +1 -1
  53. package/dist/lib/file-operations/directory-tree-helpers.js +21 -71
  54. package/dist/lib/file-operations/directory-tree-helpers.js.map +1 -1
  55. package/dist/lib/file-operations/directory-tree.d.ts.map +1 -1
  56. package/dist/lib/file-operations/directory-tree.js +2 -1
  57. package/dist/lib/file-operations/directory-tree.js.map +1 -1
  58. package/dist/lib/file-operations/file-info.d.ts +3 -1
  59. package/dist/lib/file-operations/file-info.d.ts.map +1 -1
  60. package/dist/lib/file-operations/file-info.js +16 -5
  61. package/dist/lib/file-operations/file-info.js.map +1 -1
  62. package/dist/lib/file-operations/get-multiple-file-info.d.ts +1 -1
  63. package/dist/lib/file-operations/get-multiple-file-info.d.ts.map +1 -1
  64. package/dist/lib/file-operations/get-multiple-file-info.js +6 -8
  65. package/dist/lib/file-operations/get-multiple-file-info.js.map +1 -1
  66. package/dist/lib/file-operations/list-directory-entry.d.ts.map +1 -1
  67. package/dist/lib/file-operations/list-directory-entry.js +5 -2
  68. package/dist/lib/file-operations/list-directory-entry.js.map +1 -1
  69. package/dist/lib/file-operations/list-directory-helpers.d.ts +5 -1
  70. package/dist/lib/file-operations/list-directory-helpers.d.ts.map +1 -1
  71. package/dist/lib/file-operations/list-directory-helpers.js +24 -16
  72. package/dist/lib/file-operations/list-directory-helpers.js.map +1 -1
  73. package/dist/lib/file-operations/list-directory.d.ts +1 -0
  74. package/dist/lib/file-operations/list-directory.d.ts.map +1 -1
  75. package/dist/lib/file-operations/list-directory.js +8 -3
  76. package/dist/lib/file-operations/list-directory.js.map +1 -1
  77. package/dist/lib/file-operations/read-media-file.d.ts.map +1 -1
  78. package/dist/lib/file-operations/read-media-file.js +5 -1
  79. package/dist/lib/file-operations/read-media-file.js.map +1 -1
  80. package/dist/lib/file-operations/read-multiple-files.d.ts +8 -0
  81. package/dist/lib/file-operations/read-multiple-files.d.ts.map +1 -1
  82. package/dist/lib/file-operations/read-multiple-files.js +15 -7
  83. package/dist/lib/file-operations/read-multiple-files.js.map +1 -1
  84. package/dist/lib/file-operations/search/engine-stream.d.ts +1 -1
  85. package/dist/lib/file-operations/search/engine-stream.d.ts.map +1 -1
  86. package/dist/lib/file-operations/search/engine-stream.js +21 -5
  87. package/dist/lib/file-operations/search/engine-stream.js.map +1 -1
  88. package/dist/lib/file-operations/search/engine.d.ts.map +1 -1
  89. package/dist/lib/file-operations/search/engine.js +42 -5
  90. package/dist/lib/file-operations/search/engine.js.map +1 -1
  91. package/dist/lib/file-operations/search/file-processor.d.ts.map +1 -1
  92. package/dist/lib/file-operations/search/file-processor.js +94 -54
  93. package/dist/lib/file-operations/search/file-processor.js.map +1 -1
  94. package/dist/lib/file-operations/search/match-strategy.d.ts.map +1 -1
  95. package/dist/lib/file-operations/search/match-strategy.js +2 -1
  96. package/dist/lib/file-operations/search/match-strategy.js.map +1 -1
  97. package/dist/lib/file-operations/search/types.d.ts +1 -0
  98. package/dist/lib/file-operations/search/types.d.ts.map +1 -1
  99. package/dist/lib/file-operations/search-definitions/matchers.d.ts +12 -0
  100. package/dist/lib/file-operations/search-definitions/matchers.d.ts.map +1 -0
  101. package/dist/lib/file-operations/search-definitions/matchers.js +122 -0
  102. package/dist/lib/file-operations/search-definitions/matchers.js.map +1 -0
  103. package/dist/lib/file-operations/search-definitions/patterns.d.ts +14 -0
  104. package/dist/lib/file-operations/search-definitions/patterns.d.ts.map +1 -0
  105. package/dist/lib/file-operations/search-definitions/patterns.js +83 -0
  106. package/dist/lib/file-operations/search-definitions/patterns.js.map +1 -0
  107. package/dist/lib/file-operations/search-definitions.d.ts.map +1 -1
  108. package/dist/lib/file-operations/search-definitions.js +3 -208
  109. package/dist/lib/file-operations/search-definitions.js.map +1 -1
  110. package/dist/lib/file-operations/search-files-helpers.d.ts +2 -2
  111. package/dist/lib/file-operations/search-files-helpers.d.ts.map +1 -1
  112. package/dist/lib/file-operations/search-files-helpers.js +17 -6
  113. package/dist/lib/file-operations/search-files-helpers.js.map +1 -1
  114. package/dist/lib/file-operations/search-files-options.d.ts +4 -2
  115. package/dist/lib/file-operations/search-files-options.d.ts.map +1 -1
  116. package/dist/lib/file-operations/search-files-options.js.map +1 -1
  117. package/dist/lib/file-operations/search-files.d.ts.map +1 -1
  118. package/dist/lib/file-operations/search-files.js +7 -2
  119. package/dist/lib/file-operations/search-files.js.map +1 -1
  120. package/dist/lib/file-operations/sorting.d.ts.map +1 -1
  121. package/dist/lib/file-operations/sorting.js +39 -14
  122. package/dist/lib/file-operations/sorting.js.map +1 -1
  123. package/dist/lib/file-operations.d.ts +0 -5
  124. package/dist/lib/file-operations.d.ts.map +1 -1
  125. package/dist/lib/file-operations.js +0 -5
  126. package/dist/lib/file-operations.js.map +1 -1
  127. package/dist/lib/fs-helpers/concurrency.d.ts +1 -1
  128. package/dist/lib/fs-helpers/concurrency.d.ts.map +1 -1
  129. package/dist/lib/fs-helpers/concurrency.js +37 -3
  130. package/dist/lib/fs-helpers/concurrency.js.map +1 -1
  131. package/dist/lib/fs-helpers/readers/head-file.js +1 -1
  132. package/dist/lib/fs-helpers/readers/head-file.js.map +1 -1
  133. package/dist/lib/fs-helpers/readers/read-buffer.d.ts +2 -0
  134. package/dist/lib/fs-helpers/readers/read-buffer.d.ts.map +1 -0
  135. package/dist/lib/fs-helpers/readers/read-buffer.js +52 -0
  136. package/dist/lib/fs-helpers/readers/read-buffer.js.map +1 -0
  137. package/dist/lib/fs-helpers/readers/read-file-content.d.ts +8 -1
  138. package/dist/lib/fs-helpers/readers/read-file-content.d.ts.map +1 -1
  139. package/dist/lib/fs-helpers/readers/read-file-content.js +30 -6
  140. package/dist/lib/fs-helpers/readers/read-file-content.js.map +1 -1
  141. package/dist/lib/fs-helpers/readers/read-file.d.ts +8 -0
  142. package/dist/lib/fs-helpers/readers/read-file.d.ts.map +1 -1
  143. package/dist/lib/fs-helpers/readers/read-file.js +31 -11
  144. package/dist/lib/fs-helpers/readers/read-file.js.map +1 -1
  145. package/dist/lib/fs-helpers/readers/tail-file.js +1 -1
  146. package/dist/lib/fs-helpers/readers/tail-file.js.map +1 -1
  147. package/dist/lib/path-utils.d.ts +1 -0
  148. package/dist/lib/path-utils.d.ts.map +1 -1
  149. package/dist/lib/path-utils.js +12 -0
  150. package/dist/lib/path-utils.js.map +1 -1
  151. package/dist/lib/path-validation/allowed-directories.d.ts.map +1 -1
  152. package/dist/lib/path-validation/allowed-directories.js +2 -9
  153. package/dist/lib/path-validation/allowed-directories.js.map +1 -1
  154. package/dist/lib/path-validation/errors.js +2 -2
  155. package/dist/lib/path-validation/errors.js.map +1 -1
  156. package/dist/lib/path-validation/validators.d.ts.map +1 -1
  157. package/dist/lib/path-validation/validators.js +3 -1
  158. package/dist/lib/path-validation/validators.js.map +1 -1
  159. package/dist/schemas/common.d.ts +0 -18
  160. package/dist/schemas/common.d.ts.map +1 -1
  161. package/dist/schemas/common.js +0 -10
  162. package/dist/schemas/common.js.map +1 -1
  163. package/dist/schemas/index.d.ts +2 -2
  164. package/dist/schemas/index.d.ts.map +1 -1
  165. package/dist/schemas/index.js +2 -2
  166. package/dist/schemas/index.js.map +1 -1
  167. package/dist/schemas/input-helpers.d.ts +1 -4
  168. package/dist/schemas/input-helpers.d.ts.map +1 -1
  169. package/dist/schemas/input-helpers.js +9 -33
  170. package/dist/schemas/input-helpers.js.map +1 -1
  171. package/dist/schemas/inputs/checksums.d.ts +0 -2
  172. package/dist/schemas/inputs/checksums.d.ts.map +1 -1
  173. package/dist/schemas/inputs/checksums.js +2 -7
  174. package/dist/schemas/inputs/checksums.js.map +1 -1
  175. package/dist/schemas/inputs/directory.d.ts +0 -16
  176. package/dist/schemas/inputs/directory.d.ts.map +1 -1
  177. package/dist/schemas/inputs/directory.js +2 -44
  178. package/dist/schemas/inputs/directory.js.map +1 -1
  179. package/dist/schemas/inputs/read.d.ts +0 -4
  180. package/dist/schemas/inputs/read.d.ts.map +1 -1
  181. package/dist/schemas/inputs/read.js +0 -15
  182. package/dist/schemas/inputs/read.js.map +1 -1
  183. package/dist/schemas/inputs/search.d.ts +1 -12
  184. package/dist/schemas/inputs/search.d.ts.map +1 -1
  185. package/dist/schemas/inputs/search.js +4 -30
  186. package/dist/schemas/inputs/search.js.map +1 -1
  187. package/dist/schemas/inputs.d.ts +3 -4
  188. package/dist/schemas/inputs.d.ts.map +1 -1
  189. package/dist/schemas/inputs.js +3 -4
  190. package/dist/schemas/inputs.js.map +1 -1
  191. package/dist/schemas/output-helpers.d.ts +59 -0
  192. package/dist/schemas/output-helpers.d.ts.map +1 -1
  193. package/dist/schemas/output-helpers.js +31 -0
  194. package/dist/schemas/output-helpers.js.map +1 -1
  195. package/dist/schemas/outputs/checksums.d.ts +4 -4
  196. package/dist/schemas/outputs/checksums.d.ts.map +1 -1
  197. package/dist/schemas/outputs/checksums.js +2 -7
  198. package/dist/schemas/outputs/checksums.js.map +1 -1
  199. package/dist/schemas/outputs/directory.d.ts +68 -230
  200. package/dist/schemas/outputs/directory.d.ts.map +1 -1
  201. package/dist/schemas/outputs/directory.js +14 -32
  202. package/dist/schemas/outputs/directory.js.map +1 -1
  203. package/dist/schemas/outputs/file-info.d.ts +14 -14
  204. package/dist/schemas/outputs/file-info.d.ts.map +1 -1
  205. package/dist/schemas/outputs/file-info.js +4 -31
  206. package/dist/schemas/outputs/file-info.js.map +1 -1
  207. package/dist/schemas/outputs/read.d.ts +141 -46
  208. package/dist/schemas/outputs/read.d.ts.map +1 -1
  209. package/dist/schemas/outputs/read.js +35 -12
  210. package/dist/schemas/outputs/read.js.map +1 -1
  211. package/dist/schemas/outputs/search.d.ts +134 -124
  212. package/dist/schemas/outputs/search.d.ts.map +1 -1
  213. package/dist/schemas/outputs/search.js +33 -35
  214. package/dist/schemas/outputs/search.js.map +1 -1
  215. package/dist/schemas/outputs.d.ts +3 -4
  216. package/dist/schemas/outputs.d.ts.map +1 -1
  217. package/dist/schemas/outputs.js +3 -4
  218. package/dist/schemas/outputs.js.map +1 -1
  219. package/dist/server.d.ts.map +1 -1
  220. package/dist/server.js +4 -1
  221. package/dist/server.js.map +1 -1
  222. package/dist/tools/analyze-directory.d.ts.map +1 -1
  223. package/dist/tools/analyze-directory.js +26 -28
  224. package/dist/tools/analyze-directory.js.map +1 -1
  225. package/dist/tools/compute-checksums.d.ts.map +1 -1
  226. package/dist/tools/compute-checksums.js +13 -21
  227. package/dist/tools/compute-checksums.js.map +1 -1
  228. package/dist/tools/directory-tree.d.ts.map +1 -1
  229. package/dist/tools/directory-tree.js +11 -9
  230. package/dist/tools/directory-tree.js.map +1 -1
  231. package/dist/tools/get-file-info.d.ts.map +1 -1
  232. package/dist/tools/get-file-info.js +8 -44
  233. package/dist/tools/get-file-info.js.map +1 -1
  234. package/dist/tools/get-multiple-file-info.d.ts.map +1 -1
  235. package/dist/tools/get-multiple-file-info.js +13 -55
  236. package/dist/tools/get-multiple-file-info.js.map +1 -1
  237. package/dist/tools/index.d.ts.map +1 -1
  238. package/dist/tools/index.js +0 -10
  239. package/dist/tools/index.js.map +1 -1
  240. package/dist/tools/list-allowed-dirs.d.ts.map +1 -1
  241. package/dist/tools/list-allowed-dirs.js +37 -31
  242. package/dist/tools/list-allowed-dirs.js.map +1 -1
  243. package/dist/tools/list-directory.d.ts.map +1 -1
  244. package/dist/tools/list-directory.js +83 -83
  245. package/dist/tools/list-directory.js.map +1 -1
  246. package/dist/tools/read-file.d.ts.map +1 -1
  247. package/dist/tools/read-file.js +57 -45
  248. package/dist/tools/read-file.js.map +1 -1
  249. package/dist/tools/read-media-file.d.ts.map +1 -1
  250. package/dist/tools/read-media-file.js +8 -6
  251. package/dist/tools/read-media-file.js.map +1 -1
  252. package/dist/tools/read-multiple-files.d.ts.map +1 -1
  253. package/dist/tools/read-multiple-files.js +57 -28
  254. package/dist/tools/read-multiple-files.js.map +1 -1
  255. package/dist/tools/search-content.d.ts.map +1 -1
  256. package/dist/tools/search-content.js +14 -16
  257. package/dist/tools/search-content.js.map +1 -1
  258. package/dist/tools/search-definitions.d.ts.map +1 -1
  259. package/dist/tools/search-definitions.js +11 -8
  260. package/dist/tools/search-definitions.js.map +1 -1
  261. package/dist/tools/search-files.d.ts.map +1 -1
  262. package/dist/tools/search-files.js +61 -45
  263. package/dist/tools/search-files.js.map +1 -1
  264. package/dist/tools/shared/file-info.d.ts +17 -0
  265. package/dist/tools/shared/file-info.d.ts.map +1 -0
  266. package/dist/tools/shared/file-info.js +40 -0
  267. package/dist/tools/shared/file-info.js.map +1 -0
  268. package/dist/tools/shared/formatting.d.ts +5 -0
  269. package/dist/tools/shared/formatting.d.ts.map +1 -1
  270. package/dist/tools/shared/formatting.js +21 -1
  271. package/dist/tools/shared/formatting.js.map +1 -1
  272. package/dist/tools/shared/read-range.d.ts +7 -0
  273. package/dist/tools/shared/read-range.d.ts.map +1 -0
  274. package/dist/tools/shared/read-range.js +22 -0
  275. package/dist/tools/shared/read-range.js.map +1 -0
  276. package/dist/tools/shared/search-formatting.d.ts.map +1 -1
  277. package/dist/tools/shared/search-formatting.js +53 -28
  278. package/dist/tools/shared/search-formatting.js.map +1 -1
  279. package/dist/tools/tool-response.d.ts +22 -0
  280. package/dist/tools/tool-response.d.ts.map +1 -1
  281. package/dist/tools/tool-response.js +30 -0
  282. package/dist/tools/tool-response.js.map +1 -1
  283. package/package.json +2 -1
@@ -1,62 +1,48 @@
1
1
  import * as pathModule from 'node:path';
2
- import { ErrorCode, toRpcError } from '../lib/errors.js';
2
+ import { formatBytes, formatOperationSummary, joinLines, } from '../config/formatting.js';
3
+ import { DEFAULT_LIST_MAX_ENTRIES, DEFAULT_MAX_DEPTH, } from '../lib/constants.js';
4
+ import { ErrorCode } from '../lib/errors.js';
3
5
  import { listDirectory } from '../lib/file-operations.js';
4
6
  import { ListDirectoryInputSchema, ListDirectoryOutputSchema, } from '../schemas/index.js';
5
- import { formatBytes, formatOperationSummary } from './shared/formatting.js';
6
- import { buildToolResponse } from './tool-response.js';
7
+ import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
7
8
  function getExtension(name, isFile) {
8
9
  if (!isFile)
9
10
  return undefined;
10
11
  const ext = pathModule.extname(name);
11
12
  return ext ? ext.slice(1) : undefined;
12
13
  }
13
- function formatDirectoryListing(entries, basePath) {
14
- if (entries.length === 0)
15
- return 'Directory is empty';
16
- const dirs = entries.filter((e) => e.type === 'directory');
17
- const files = entries.filter((e) => e.type !== 'directory');
18
- const lines = [
19
- `Contents of ${basePath}:`,
20
- '',
21
- ...formatDirectoryLines(dirs),
22
- ...formatFileLines(files),
23
- '',
24
- `Total: ${dirs.length} directories, ${files.length} files`,
25
- ];
26
- return lines.join('\n');
27
- }
28
- function formatDirectoryLines(dirs) {
29
- if (dirs.length === 0)
30
- return [];
31
- return [
32
- 'Directories:',
33
- ...dirs.map((dir) => {
34
- const symlink = dir.symlinkTarget ? ` -> ${dir.symlinkTarget}` : '';
35
- return ` [DIR] ${dir.relativePath}${symlink}`;
36
- }),
37
- '',
38
- ];
39
- }
40
- function formatFileLines(files) {
41
- if (files.length === 0)
42
- return [];
43
- return [
44
- 'Files:',
45
- ...files.map((file) => {
46
- const size = file.size !== undefined ? ` (${formatBytes(file.size)})` : '';
47
- const tag = file.type === 'symlink' ? '[LINK]' : '[FILE]';
48
- const symlink = file.symlinkTarget ? ` -> ${file.symlinkTarget}` : '';
49
- return ` ${tag} ${file.relativePath}${size}${symlink}`;
50
- }),
51
- ];
14
+ function formatDirectoryListing(entries, basePath, summary) {
15
+ if (entries.length === 0) {
16
+ if (summary.entriesScanned && summary.entriesScanned > 0) {
17
+ if (summary.entriesVisible === 0) {
18
+ return 'No entries matched visibility filters (hidden/excludePatterns).';
19
+ }
20
+ return 'No entries matched the provided pattern.';
21
+ }
22
+ return 'Empty directory';
23
+ }
24
+ const dirs = entries.filter((e) => e.type === 'directory').length;
25
+ const files = entries.length - dirs;
26
+ const entryLines = entries.map((entry) => {
27
+ if (entry.type === 'directory') {
28
+ const symlink = entry.symlinkTarget ? ` -> ${entry.symlinkTarget}` : '';
29
+ return `[DIR] ${entry.relativePath}${symlink}`;
30
+ }
31
+ const size = entry.size !== undefined ? ` (${formatBytes(entry.size)})` : '';
32
+ const tag = entry.type === 'symlink' ? '[LINK]' : '[FILE]';
33
+ const symlink = entry.symlinkTarget ? ` -> ${entry.symlinkTarget}` : '';
34
+ return `${tag} ${entry.relativePath}${size}${symlink}`;
35
+ });
36
+ const lines = [`${basePath} (${dirs} dirs, ${files} files):`, ...entryLines];
37
+ return joinLines(lines);
52
38
  }
53
39
  const LIST_DIRECTORY_TOOL = {
54
40
  title: 'List Directory',
55
- description: 'List files and subdirectories in a specified path with optional recursive traversal. ' +
56
- 'Returns names (basename), relative paths, types (file/directory/symlink), sizes, and modification dates. ' +
57
- 'Use recursive=true with maxDepth to explore nested structures. ' +
58
- 'Use excludePatterns to skip directories like node_modules, or pattern to include only matching paths. ' +
59
- 'For a visual tree structure, use directory_tree instead.',
41
+ description: 'List entries in a directory with optional recursion. ' +
42
+ 'Returns name (basename), relative path, type (file/directory/symlink), size, and modified date. ' +
43
+ 'Use recursive=true with maxDepth to traverse nested folders. ' +
44
+ 'Use excludePatterns to skip paths, or pattern to include only matches. ' +
45
+ 'Symlinks are not followed; includeSymlinkTargets can show targets.',
60
46
  inputSchema: ListDirectoryInputSchema,
61
47
  outputSchema: ListDirectoryOutputSchema.shape,
62
48
  annotations: {
@@ -66,10 +52,11 @@ const LIST_DIRECTORY_TOOL = {
66
52
  },
67
53
  };
68
54
  function buildStructuredResult(result) {
55
+ const { entries, summary, path } = result;
69
56
  return {
70
57
  ok: true,
71
- path: result.path,
72
- entries: result.entries.map((e) => ({
58
+ path,
59
+ entries: entries.map((e) => ({
73
60
  name: e.name,
74
61
  relativePath: e.relativePath,
75
62
  type: e.type,
@@ -79,54 +66,67 @@ function buildStructuredResult(result) {
79
66
  symlinkTarget: e.symlinkTarget,
80
67
  })),
81
68
  summary: {
82
- totalEntries: result.summary.totalEntries,
83
- totalFiles: result.summary.totalFiles,
84
- totalDirectories: result.summary.totalDirectories,
85
- maxDepthReached: result.summary.maxDepthReached,
86
- truncated: result.summary.truncated,
87
- skippedInaccessible: result.summary.skippedInaccessible,
88
- symlinksNotFollowed: result.summary.symlinksNotFollowed,
69
+ totalEntries: summary.totalEntries,
70
+ totalFiles: summary.totalFiles,
71
+ totalDirectories: summary.totalDirectories,
72
+ maxDepthReached: summary.maxDepthReached,
73
+ truncated: summary.truncated,
74
+ stoppedReason: summary.stoppedReason,
75
+ skippedInaccessible: summary.skippedInaccessible,
76
+ symlinksNotFollowed: summary.symlinksNotFollowed,
77
+ entriesScanned: summary.entriesScanned,
78
+ entriesVisible: summary.entriesVisible,
89
79
  },
90
80
  };
91
81
  }
92
82
  function buildTextResult(result) {
93
- let textOutput = formatDirectoryListing(result.entries, result.path);
94
- if (result.entries.length === 0 && result.summary.totalEntries > 0) {
95
- textOutput +=
96
- '\n(No entries matched the provided pattern/filters, but the directory contains items.)';
97
- }
83
+ const { entries, summary, path } = result;
84
+ let textOutput = formatDirectoryListing(entries, path, summary);
85
+ const truncatedReason = summary.stoppedReason === 'aborted'
86
+ ? 'operation aborted'
87
+ : summary.stoppedReason === 'maxEntries'
88
+ ? `reached max entries limit (${summary.totalEntries} returned)`
89
+ : undefined;
98
90
  textOutput += formatOperationSummary({
99
- truncated: result.summary.truncated,
100
- truncatedReason: `reached max entries limit (${result.summary.totalEntries} returned)`,
101
- tip: 'Increase maxEntries or reduce maxDepth to see more results.',
102
- skippedInaccessible: result.summary.skippedInaccessible,
103
- symlinksNotFollowed: result.summary.symlinksNotFollowed,
91
+ truncated: summary.truncated,
92
+ truncatedReason,
93
+ tip: summary.stoppedReason === 'maxEntries'
94
+ ? 'Increase maxEntries or reduce maxDepth to see more results.'
95
+ : undefined,
96
+ skippedInaccessible: summary.skippedInaccessible,
97
+ symlinksNotFollowed: summary.symlinksNotFollowed,
104
98
  });
105
99
  return textOutput;
106
100
  }
107
- async function handleListDirectory({ path: dirPath, recursive, includeHidden, excludePatterns, maxDepth, maxEntries, sortBy, includeSymlinkTargets, pattern, }) {
108
- const result = await listDirectory(dirPath, {
109
- recursive,
110
- includeHidden,
111
- excludePatterns,
112
- maxDepth,
113
- maxEntries,
114
- sortBy,
115
- includeSymlinkTargets,
101
+ async function handleListDirectory({ path: dirPath, recursive, includeHidden, excludePatterns, maxDepth, maxEntries, sortBy, includeSymlinkTargets, pattern, }, signal) {
102
+ const effectiveOptions = {
103
+ recursive: recursive ?? false,
104
+ includeHidden: includeHidden ?? false,
105
+ excludePatterns: excludePatterns ?? [],
106
+ maxDepth: maxDepth ?? DEFAULT_MAX_DEPTH,
107
+ maxEntries: maxEntries ?? DEFAULT_LIST_MAX_ENTRIES,
108
+ sortBy: sortBy ?? 'name',
109
+ includeSymlinkTargets: includeSymlinkTargets ?? false,
116
110
  pattern,
111
+ };
112
+ const result = await listDirectory(dirPath, {
113
+ recursive: effectiveOptions.recursive,
114
+ includeHidden: effectiveOptions.includeHidden,
115
+ excludePatterns: effectiveOptions.excludePatterns,
116
+ maxDepth: effectiveOptions.maxDepth,
117
+ maxEntries: effectiveOptions.maxEntries,
118
+ sortBy: effectiveOptions.sortBy,
119
+ includeSymlinkTargets: effectiveOptions.includeSymlinkTargets,
120
+ pattern: effectiveOptions.pattern,
121
+ signal,
117
122
  });
118
123
  const structured = buildStructuredResult(result);
124
+ structured.effectiveOptions = effectiveOptions;
119
125
  const textOutput = buildTextResult(result);
120
126
  return buildToolResponse(textOutput, structured);
121
127
  }
122
128
  export function registerListDirectoryTool(server) {
123
- server.registerTool('list_directory', LIST_DIRECTORY_TOOL, async (args) => {
124
- try {
125
- return await handleListDirectory(args);
126
- }
127
- catch (error) {
128
- throw toRpcError(error, ErrorCode.E_NOT_DIRECTORY, args.path);
129
- }
130
- });
129
+ const handler = (args, extra) => withToolErrorHandling(() => handleListDirectory(args, extra.signal), (error) => buildToolErrorResponse(error, ErrorCode.E_NOT_DIRECTORY, args.path));
130
+ server.registerTool('list_directory', LIST_DIRECTORY_TOOL, handler);
131
131
  }
132
132
  //# sourceMappingURL=list-directory.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"list-directory.js","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"list-directory.js","sourceRoot":"","sources":["../../src/tools/list-directory.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmJzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAY5D"}
1
+ {"version":3,"file":"read-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAgKzE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAU5D"}
@@ -1,38 +1,23 @@
1
- import { ErrorCode, McpError, toRpcError } from '../lib/errors.js';
1
+ import { joinLines } from '../config/formatting.js';
2
+ import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
3
+ import { ErrorCode } from '../lib/errors.js';
2
4
  import { readFile } from '../lib/file-operations.js';
3
5
  import { ReadFileInputSchema, ReadFileOutputSchema } from '../schemas/index.js';
4
- import { buildToolResponse } from './tool-response.js';
5
- function buildLineRange(lineStart, lineEnd, filePath) {
6
- const hasLineStart = lineStart !== undefined;
7
- const hasLineEnd = lineEnd !== undefined;
8
- assertLineRangeComplete(hasLineStart, hasLineEnd, filePath);
9
- if (hasLineStart && hasLineEnd)
10
- return { start: lineStart, end: lineEnd };
11
- return undefined;
12
- }
13
- function assertNoMixedRangeOptions(hasHeadTail, hasLineRange, filePath) {
14
- if (!hasHeadTail || !hasLineRange)
15
- return;
16
- throw new McpError(ErrorCode.E_INVALID_INPUT, 'head/tail cannot be combined with lineStart/lineEnd', filePath);
17
- }
18
- function assertLineRangeComplete(hasLineStart, hasLineEnd, filePath) {
19
- if (hasLineStart === hasLineEnd)
20
- return;
21
- const missing = hasLineStart ? 'lineEnd' : 'lineStart';
22
- const provided = hasLineStart ? 'lineStart' : 'lineEnd';
23
- throw new McpError(ErrorCode.E_INVALID_INPUT, `Invalid lineRange: ${provided} requires ${missing} to also be specified`, filePath);
24
- }
6
+ import { assertNoMixedRangeOptions, buildLineRange, } from './shared/read-range.js';
7
+ import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
25
8
  function buildTextResult(result, head, tail) {
26
9
  const note = buildReadFileNote(result, head, tail);
27
- return note ? `${result.content}\n${note}` : result.content;
10
+ return note ? joinLines([result.content, note]) : result.content;
28
11
  }
29
12
  function buildReadFileNote(result, head, tail) {
30
- if (result.truncated) {
31
- return buildTruncatedNote(result, head, tail);
32
- }
33
- return result.totalLines !== undefined
13
+ const rangeNote = buildRangeNote(result);
14
+ const linesNote = result.totalLines !== undefined
34
15
  ? `Total lines: ${result.totalLines}`
35
16
  : undefined;
17
+ if (result.truncated) {
18
+ return joinLines([buildTruncatedNote(result, head, tail), rangeNote, linesNote].filter((value) => Boolean(value)));
19
+ }
20
+ return joinLines([rangeNote, linesNote].filter((value) => Boolean(value)));
36
21
  }
37
22
  function buildTruncatedNote(result, head, tail) {
38
23
  if (result.totalLines !== undefined) {
@@ -46,16 +31,34 @@ function buildTruncatedNote(result, head, tail) {
46
31
  }
47
32
  return undefined;
48
33
  }
34
+ function buildRangeNote(result) {
35
+ if (result.readMode === 'lineRange') {
36
+ if (result.lineStart !== undefined && result.lineEnd !== undefined) {
37
+ return `Showing lines ${result.lineStart}-${result.lineEnd}`;
38
+ }
39
+ }
40
+ return undefined;
41
+ }
49
42
  async function handleReadFile(args) {
50
- assertNoMixedRangeOptions(args.head !== undefined || args.tail !== undefined, args.lineStart !== undefined || args.lineEnd !== undefined, args.path);
43
+ const hasHeadTail = args.head !== undefined || args.tail !== undefined;
44
+ const hasLineRange = args.lineStart !== undefined || args.lineEnd !== undefined;
45
+ assertNoMixedRangeOptions(hasHeadTail, hasLineRange, args.path);
51
46
  const lineRange = buildLineRange(args.lineStart, args.lineEnd, args.path);
52
- const result = await readFile(args.path, {
53
- encoding: args.encoding,
54
- maxSize: args.maxSize,
47
+ const effectiveOptions = {
48
+ encoding: args.encoding ?? 'utf-8',
49
+ maxSize: Math.min(args.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
50
+ skipBinary: args.skipBinary ?? true,
55
51
  lineRange,
56
52
  head: args.head,
57
53
  tail: args.tail,
58
- skipBinary: args.skipBinary,
54
+ };
55
+ const result = await readFile(args.path, {
56
+ encoding: effectiveOptions.encoding,
57
+ maxSize: effectiveOptions.maxSize,
58
+ lineRange: effectiveOptions.lineRange,
59
+ head: effectiveOptions.head,
60
+ tail: effectiveOptions.tail,
61
+ skipBinary: effectiveOptions.skipBinary,
59
62
  });
60
63
  const structured = {
61
64
  ok: true,
@@ -63,6 +66,22 @@ async function handleReadFile(args) {
63
66
  content: result.content,
64
67
  truncated: result.truncated,
65
68
  totalLines: result.totalLines,
69
+ readMode: result.readMode,
70
+ lineStart: result.lineStart,
71
+ lineEnd: result.lineEnd,
72
+ head: result.head,
73
+ tail: result.tail,
74
+ linesRead: result.linesRead,
75
+ hasMoreLines: result.hasMoreLines,
76
+ effectiveOptions: {
77
+ encoding: effectiveOptions.encoding,
78
+ maxSize: effectiveOptions.maxSize,
79
+ skipBinary: effectiveOptions.skipBinary,
80
+ lineStart: args.lineStart,
81
+ lineEnd: args.lineEnd,
82
+ head: args.head,
83
+ tail: args.tail,
84
+ },
66
85
  };
67
86
  const text = buildTextResult(result, args.head, args.tail);
68
87
  return buildToolResponse(text, structured);
@@ -70,11 +89,10 @@ async function handleReadFile(args) {
70
89
  const READ_FILE_TOOL = {
71
90
  title: 'Read File',
72
91
  description: 'Read the text contents of a single file. ' +
73
- 'Supports different encodings and partial reads via head (first N lines), tail (last N lines), ' +
74
- 'or lineStart/lineEnd (specific line range). ' +
75
- 'Use skipBinary=true to reject binary files and prefer read_media_file. ' +
76
- 'For multiple files, use read_multiple_files for efficiency. ' +
77
- 'For binary/media files, use read_media_file instead.',
92
+ 'Supports encodings and partial reads via head (first N lines), tail (last N lines), ' +
93
+ 'or lineStart/lineEnd (specific line range; mutually exclusive with head/tail). ' +
94
+ 'Use skipBinary=true to reject binary files. ' +
95
+ 'For multiple files, use read_multiple_files for efficiency.',
78
96
  inputSchema: ReadFileInputSchema,
79
97
  outputSchema: ReadFileOutputSchema.shape,
80
98
  annotations: {
@@ -84,13 +102,7 @@ const READ_FILE_TOOL = {
84
102
  },
85
103
  };
86
104
  export function registerReadFileTool(server) {
87
- server.registerTool('read_file', READ_FILE_TOOL, async (args) => {
88
- try {
89
- return await handleReadFile(args);
90
- }
91
- catch (error) {
92
- throw toRpcError(error, ErrorCode.E_NOT_FILE, args.path);
93
- }
94
- });
105
+ const handler = (args) => withToolErrorHandling(() => handleReadFile(args), (error) => buildToolErrorResponse(error, ErrorCode.E_NOT_FILE, args.path));
106
+ server.registerTool('read_file', READ_FILE_TOOL, handler);
95
107
  }
96
108
  //# sourceMappingURL=read-file.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../src/tools/read-file.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"read-media-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoEzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYjE"}
1
+ {"version":3,"file":"read-media-file.d.ts","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0EzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYjE"}
@@ -1,7 +1,8 @@
1
- import { ErrorCode, toRpcError } from '../lib/errors.js';
1
+ import { joinLines } from '../config/formatting.js';
2
+ import { ErrorCode } from '../lib/errors.js';
2
3
  import { readMediaFile } from '../lib/file-operations.js';
3
4
  import { ReadMediaFileInputSchema, ReadMediaFileOutputSchema, } from '../schemas/index.js';
4
- import { buildToolResponse } from './tool-response.js';
5
+ import { buildToolErrorResponse, buildToolResponse, } from './tool-response.js';
5
6
  function buildStructuredResult(result) {
6
7
  return {
7
8
  ok: true,
@@ -18,7 +19,7 @@ function buildTextResult(result) {
18
19
  `Size: ${result.size} bytes`,
19
20
  `Data: [base64 encoded, ${result.data.length} characters]`,
20
21
  ];
21
- return textLines.join('\n');
22
+ return joinLines(textLines);
22
23
  }
23
24
  async function handleReadMediaFile({ path, maxSize, }) {
24
25
  const result = await readMediaFile(path, { maxSize });
@@ -38,13 +39,14 @@ const READ_MEDIA_FILE_TOOL = {
38
39
  },
39
40
  };
40
41
  export function registerReadMediaFileTool(server) {
41
- server.registerTool('read_media_file', READ_MEDIA_FILE_TOOL, async (args) => {
42
+ const handler = async (args) => {
42
43
  try {
43
44
  return await handleReadMediaFile(args);
44
45
  }
45
46
  catch (error) {
46
- throw toRpcError(error, ErrorCode.E_NOT_FILE, args.path);
47
+ return buildToolErrorResponse(error, ErrorCode.E_NOT_FILE, args.path);
47
48
  }
48
- });
49
+ };
50
+ server.registerTool('read_media_file', READ_MEDIA_FILE_TOOL, handler);
49
51
  }
50
52
  //# sourceMappingURL=read-media-file.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"read-media-file.js","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,iBAAiB,EAAqB,MAAM,oBAAoB,CAAC;AAK1E,SAAS,qBAAqB,CAC5B,MAAiD;IAEjD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAiD;IAEjD,MAAM,SAAS,GAAG;QAChB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,cAAc,MAAM,CAAC,QAAQ,EAAE;QAC/B,SAAS,MAAM,CAAC,IAAI,QAAQ;QAC5B,0BAA0B,MAAM,CAAC,IAAI,CAAC,MAAM,cAAc;KAC3D,CAAC;IACF,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,EACjC,IAAI,EACJ,OAAO,GAIR;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,iBAAiB,CACtB,eAAe,CAAC,MAAM,CAAC,EACvB,qBAAqB,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,yGAAyG;QACzG,oDAAoD;QACpD,+EAA+E;IACjF,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,EAAE,IAAmB,EAAE,EAAE;QAC5B,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}
1
+ {"version":3,"file":"read-media-file.js","sourceRoot":"","sources":["../../src/tools/read-media-file.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EACL,wBAAwB,EACxB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAGlB,MAAM,oBAAoB,CAAC;AAK5B,SAAS,qBAAqB,CAC5B,MAAiD;IAEjD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CACtB,MAAiD;IAEjD,MAAM,SAAS,GAAG;QAChB,SAAS,MAAM,CAAC,IAAI,EAAE;QACtB,cAAc,MAAM,CAAC,QAAQ,EAAE;QAC/B,SAAS,MAAM,CAAC,IAAI,QAAQ;QAC5B,0BAA0B,MAAM,CAAC,IAAI,CAAC,MAAM,cAAc;KAC3D,CAAC;IACF,OAAO,SAAS,CAAC,SAAS,CAAC,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,mBAAmB,CAAC,EACjC,IAAI,EACJ,OAAO,GAIR;IACC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,iBAAiB,CACtB,eAAe,CAAC,MAAM,CAAC,EACvB,qBAAqB,CAAC,MAAM,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,yGAAyG;QACzG,oDAAoD;QACpD,+EAA+E;IACjF,WAAW,EAAE,wBAAwB;IACrC,YAAY,EAAE,yBAAyB,CAAC,KAAK;IAC7C,WAAW,EAAE;QACX,YAAY,EAAE,IAAI;QAClB,cAAc,EAAE,IAAI;QACpB,aAAa,EAAE,IAAI;KACpB;CACO,CAAC;AAEX,MAAM,UAAU,yBAAyB,CAAC,MAAiB;IACzD,MAAM,OAAO,GAAG,KAAK,EACnB,IAAmB,EAC6B,EAAE;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,OAAO,sBAAsB,CAAC,KAAK,EAAE,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACxE,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,YAAY,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"read-multiple-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA0HzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAYrE"}
1
+ {"version":3,"file":"read-multiple-files.d.ts","sourceRoot":"","sources":["../../src/tools/read-multiple-files.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4KzE,wBAAgB,6BAA6B,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAWrE"}
@@ -1,8 +1,11 @@
1
- import { ErrorCode, McpError, toRpcError } from '../lib/errors.js';
1
+ import { joinLines } from '../config/formatting.js';
2
+ import { MAX_TEXT_FILE_SIZE } from '../lib/constants.js';
3
+ import { ErrorCode } from '../lib/errors.js';
2
4
  import { readMultipleFiles } from '../lib/file-operations.js';
3
5
  import { ReadMultipleFilesInputSchema, ReadMultipleFilesOutputSchema, } from '../schemas/index.js';
4
- import { buildToolResponse } from './tool-response.js';
5
- function buildStructuredResult(results) {
6
+ import { assertLineRangeComplete, assertNoMixedRangeOptions, } from './shared/read-range.js';
7
+ import { buildToolErrorResponse, buildToolResponse, withToolErrorHandling, } from './tool-response.js';
8
+ function buildStructuredResult(results, effectiveOptions) {
6
9
  const succeeded = results.filter((r) => r.content !== undefined).length;
7
10
  const failed = results.filter((r) => r.error !== undefined).length;
8
11
  return {
@@ -13,49 +16,81 @@ function buildStructuredResult(results) {
13
16
  succeeded,
14
17
  failed,
15
18
  },
19
+ effectiveOptions,
16
20
  };
17
21
  }
18
22
  function buildTextResult(results) {
19
- return results.map(formatReadMultipleResult).join('\n');
23
+ return joinLines(results.map(formatReadMultipleResult));
20
24
  }
21
25
  function formatReadMultipleResult(result) {
22
26
  if (result.content !== undefined) {
23
27
  const note = buildReadMultipleNote(result);
24
- return `=== ${result.path} ===\n${result.content}${note}`;
28
+ const rangeNote = buildReadMultipleRangeNote(result);
29
+ const footer = [rangeNote, note].filter((value) => Boolean(value));
30
+ const contentBlock = footer.length
31
+ ? joinLines([result.content, ...footer])
32
+ : result.content;
33
+ return joinLines([`=== ${result.path} ===`, contentBlock]);
25
34
  }
26
- return `=== ${result.path} ===\n[Error: ${result.error ?? 'Unknown error'}]`;
35
+ return joinLines([
36
+ `=== ${result.path} ===`,
37
+ `[Error: ${result.error ?? 'Unknown error'}]`,
38
+ ]);
27
39
  }
28
40
  function buildReadMultipleNote(result) {
29
41
  if (result.truncated !== true)
30
42
  return '';
31
43
  if (result.totalLines !== undefined) {
32
- return `\n[Truncated. Total lines: ${result.totalLines}]`;
44
+ return `[Truncated. Total lines: ${result.totalLines}]`;
33
45
  }
34
- return '\n[Truncated]';
46
+ return '[Truncated]';
35
47
  }
36
- function assertNoMixedRangeOptions(hasHeadTail, hasLineRange, pathLabel) {
37
- if (!hasHeadTail || !hasLineRange)
38
- return;
39
- throw new McpError(ErrorCode.E_INVALID_INPUT, 'head/tail cannot be combined with lineStart/lineEnd', pathLabel);
48
+ function buildReadMultipleRangeNote(result) {
49
+ if (result.readMode === 'lineRange') {
50
+ if (result.lineStart !== undefined && result.lineEnd !== undefined) {
51
+ return `Showing lines ${result.lineStart}-${result.lineEnd}`;
52
+ }
53
+ }
54
+ if (result.readMode === 'head' && result.head !== undefined) {
55
+ return `Showing first ${String(result.head)} lines`;
56
+ }
57
+ if (result.readMode === 'tail' && result.tail !== undefined) {
58
+ return `Showing last ${String(result.tail)} lines`;
59
+ }
60
+ return undefined;
40
61
  }
41
- async function handleReadMultipleFiles(args) {
42
- assertNoMixedRangeOptions(args.head !== undefined || args.tail !== undefined, args.lineStart !== undefined || args.lineEnd !== undefined, args.paths[0] ?? '<paths>');
43
- const results = await readMultipleFiles(args.paths, {
44
- encoding: args.encoding,
45
- maxSize: args.maxSize,
46
- maxTotalSize: args.maxTotalSize,
62
+ async function handleReadMultipleFiles(args, signal) {
63
+ const pathLabel = args.paths[0] ?? '<paths>';
64
+ const hasHeadTail = args.head !== undefined || args.tail !== undefined;
65
+ const hasLineRange = args.lineStart !== undefined || args.lineEnd !== undefined;
66
+ assertLineRangeComplete(args.lineStart, args.lineEnd, pathLabel);
67
+ assertNoMixedRangeOptions(hasHeadTail, hasLineRange, pathLabel);
68
+ const effectiveOptions = {
69
+ encoding: args.encoding ?? 'utf-8',
70
+ maxSize: Math.min(args.maxSize ?? MAX_TEXT_FILE_SIZE, MAX_TEXT_FILE_SIZE),
71
+ maxTotalSize: args.maxTotalSize ?? 100 * 1024 * 1024,
47
72
  head: args.head,
48
73
  tail: args.tail,
49
74
  lineStart: args.lineStart,
50
75
  lineEnd: args.lineEnd,
76
+ };
77
+ const results = await readMultipleFiles(args.paths, {
78
+ encoding: effectiveOptions.encoding,
79
+ maxSize: effectiveOptions.maxSize,
80
+ maxTotalSize: effectiveOptions.maxTotalSize,
81
+ head: effectiveOptions.head,
82
+ tail: effectiveOptions.tail,
83
+ lineStart: effectiveOptions.lineStart,
84
+ lineEnd: effectiveOptions.lineEnd,
85
+ signal,
51
86
  });
52
- return buildToolResponse(buildTextResult(results), buildStructuredResult(results));
87
+ return buildToolResponse(buildTextResult(results), buildStructuredResult(results, effectiveOptions));
53
88
  }
54
89
  const READ_MULTIPLE_FILES_TOOL = {
55
90
  title: 'Read Multiple Files',
56
91
  description: 'Read contents of multiple files in a single operation (parallel processing). ' +
57
92
  'More efficient than calling read_file repeatedly. ' +
58
- 'Individual file errors do not fail the entire operation-each file reports success or error independently. ' +
93
+ 'Individual file errors do not fail the entire operation; each file reports success or error independently. ' +
59
94
  'Supports head/tail or lineStart/lineEnd for reading partial content from all files (mutually exclusive).',
60
95
  inputSchema: ReadMultipleFilesInputSchema,
61
96
  outputSchema: ReadMultipleFilesOutputSchema.shape,
@@ -66,13 +101,7 @@ const READ_MULTIPLE_FILES_TOOL = {
66
101
  },
67
102
  };
68
103
  export function registerReadMultipleFilesTool(server) {
69
- server.registerTool('read_multiple_files', READ_MULTIPLE_FILES_TOOL, async (args) => {
70
- try {
71
- return await handleReadMultipleFiles(args);
72
- }
73
- catch (error) {
74
- throw toRpcError(error, ErrorCode.E_UNKNOWN);
75
- }
76
- });
104
+ const handler = (args, extra) => withToolErrorHandling(() => handleReadMultipleFiles(args, extra.signal), (error) => buildToolErrorResponse(error, ErrorCode.E_UNKNOWN));
105
+ server.registerTool('read_multiple_files', READ_MULTIPLE_FILES_TOOL, handler);
77
106
  }
78
107
  //# sourceMappingURL=read-multiple-files.js.map