@vybestack/llxprt-code-core 0.1.18 → 0.1.19-beta

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 (270) hide show
  1. package/README.md +1 -0
  2. package/dist/src/code_assist/converter.d.ts +2 -1
  3. package/dist/src/code_assist/converter.js +1 -1
  4. package/dist/src/code_assist/converter.js.map +1 -1
  5. package/dist/src/code_assist/converter.test.js +48 -1
  6. package/dist/src/code_assist/converter.test.js.map +1 -1
  7. package/dist/src/code_assist/oauth2.js +2 -1
  8. package/dist/src/code_assist/oauth2.js.map +1 -1
  9. package/dist/src/code_assist/server.test.js +4 -1
  10. package/dist/src/code_assist/server.test.js.map +1 -1
  11. package/dist/src/config/config.alwaysAllow.test.d.ts +6 -0
  12. package/dist/src/config/config.alwaysAllow.test.js +84 -0
  13. package/dist/src/config/config.alwaysAllow.test.js.map +1 -0
  14. package/dist/src/config/config.d.ts +80 -1
  15. package/dist/src/config/config.ephemeral.test.d.ts +6 -0
  16. package/dist/src/config/config.ephemeral.test.js +152 -0
  17. package/dist/src/config/config.ephemeral.test.js.map +1 -0
  18. package/dist/src/config/config.js +135 -0
  19. package/dist/src/config/config.js.map +1 -1
  20. package/dist/src/config/config.test.js +8 -0
  21. package/dist/src/config/config.test.js.map +1 -1
  22. package/dist/src/core/client.d.ts +0 -2
  23. package/dist/src/core/client.js +10 -85
  24. package/dist/src/core/client.js.map +1 -1
  25. package/dist/src/core/client.test.js +7 -2
  26. package/dist/src/core/client.test.js.map +1 -1
  27. package/dist/src/core/contentGenerator.js +1 -1
  28. package/dist/src/core/contentGenerator.js.map +1 -1
  29. package/dist/src/core/coreToolScheduler.d.ts +17 -7
  30. package/dist/src/core/coreToolScheduler.js +121 -18
  31. package/dist/src/core/coreToolScheduler.js.map +1 -1
  32. package/dist/src/core/coreToolScheduler.test.js +25 -37
  33. package/dist/src/core/coreToolScheduler.test.js.map +1 -1
  34. package/dist/src/core/geminiChat.d.ts +3 -0
  35. package/dist/src/core/geminiChat.js +17 -13
  36. package/dist/src/core/geminiChat.js.map +1 -1
  37. package/dist/src/core/logger.d.ts +1 -0
  38. package/dist/src/core/logger.js +18 -0
  39. package/dist/src/core/logger.js.map +1 -1
  40. package/dist/src/core/logger.test.js +29 -0
  41. package/dist/src/core/logger.test.js.map +1 -1
  42. package/dist/src/core/loggingContentGenerator.d.ts +24 -0
  43. package/dist/src/core/loggingContentGenerator.js +89 -0
  44. package/dist/src/core/loggingContentGenerator.js.map +1 -0
  45. package/dist/src/core/nonInteractiveToolExecutor.js +21 -1
  46. package/dist/src/core/nonInteractiveToolExecutor.js.map +1 -1
  47. package/dist/src/core/nonInteractiveToolExecutor.test.js +8 -31
  48. package/dist/src/core/nonInteractiveToolExecutor.test.js.map +1 -1
  49. package/dist/src/core/subagent.d.ts +230 -0
  50. package/dist/src/core/subagent.js +453 -0
  51. package/dist/src/core/subagent.js.map +1 -0
  52. package/dist/src/core/subagent.test.d.ts +6 -0
  53. package/dist/src/core/subagent.test.js +519 -0
  54. package/dist/src/core/subagent.test.js.map +1 -0
  55. package/dist/src/hooks/tool-render-suppression-hook.d.ts +16 -0
  56. package/dist/src/hooks/tool-render-suppression-hook.js +26 -0
  57. package/dist/src/hooks/tool-render-suppression-hook.js.map +1 -0
  58. package/dist/src/hooks/tool-render-suppression-hook.test.d.ts +6 -0
  59. package/dist/src/hooks/tool-render-suppression-hook.test.js +59 -0
  60. package/dist/src/hooks/tool-render-suppression-hook.test.js.map +1 -0
  61. package/dist/src/ide/ide-client.d.ts +22 -1
  62. package/dist/src/ide/ide-client.js +161 -17
  63. package/dist/src/ide/ide-client.js.map +1 -1
  64. package/dist/src/ide/ideContext.d.ts +127 -32
  65. package/dist/src/ide/ideContext.js +45 -0
  66. package/dist/src/ide/ideContext.js.map +1 -1
  67. package/dist/src/index.d.ts +5 -0
  68. package/dist/src/index.js +6 -0
  69. package/dist/src/index.js.map +1 -1
  70. package/dist/src/integration-tests/todo-system.test.js +38 -602
  71. package/dist/src/integration-tests/todo-system.test.js.map +1 -1
  72. package/dist/src/providers/IProviderManager.d.ts +5 -0
  73. package/dist/src/providers/LoggingProviderWrapper.d.ts +53 -0
  74. package/dist/src/providers/LoggingProviderWrapper.js +347 -0
  75. package/dist/src/providers/LoggingProviderWrapper.js.map +1 -0
  76. package/dist/src/providers/ProviderManager.d.ts +20 -0
  77. package/dist/src/providers/ProviderManager.js +214 -1
  78. package/dist/src/providers/ProviderManager.js.map +1 -1
  79. package/dist/src/providers/gemini/GeminiProvider.js +5 -5
  80. package/dist/src/providers/gemini/GeminiProvider.js.map +1 -1
  81. package/dist/src/providers/logging/ProviderContentExtractor.d.ts +27 -0
  82. package/dist/src/providers/logging/ProviderContentExtractor.js +198 -0
  83. package/dist/src/providers/logging/ProviderContentExtractor.js.map +1 -0
  84. package/dist/src/providers/logging/ProviderPerformanceTracker.d.ts +43 -0
  85. package/dist/src/providers/logging/ProviderPerformanceTracker.js +98 -0
  86. package/dist/src/providers/logging/ProviderPerformanceTracker.js.map +1 -0
  87. package/dist/src/providers/openai/OpenAIProvider.js +8 -1
  88. package/dist/src/providers/openai/OpenAIProvider.js.map +1 -1
  89. package/dist/src/providers/openai/OpenAIProvider.test.js +106 -0
  90. package/dist/src/providers/openai/OpenAIProvider.test.js.map +1 -1
  91. package/dist/src/providers/types/IProviderConfig.d.ts +5 -0
  92. package/dist/src/providers/types.d.ts +47 -0
  93. package/dist/src/services/git-stats-service.d.ts +32 -0
  94. package/dist/src/services/git-stats-service.js +22 -0
  95. package/dist/src/services/git-stats-service.js.map +1 -0
  96. package/dist/src/services/loopDetectionService.js +10 -6
  97. package/dist/src/services/loopDetectionService.js.map +1 -1
  98. package/dist/src/services/loopDetectionService.test.js +139 -0
  99. package/dist/src/services/loopDetectionService.test.js.map +1 -1
  100. package/dist/src/services/shellExecutionService.js +69 -9
  101. package/dist/src/services/shellExecutionService.js.map +1 -1
  102. package/dist/src/services/shellExecutionService.test.js +8 -0
  103. package/dist/src/services/shellExecutionService.test.js.map +1 -1
  104. package/dist/src/services/todo-context-tracker.d.ts +31 -0
  105. package/dist/src/services/todo-context-tracker.js +45 -0
  106. package/dist/src/services/todo-context-tracker.js.map +1 -0
  107. package/dist/src/services/tool-call-tracker-service.d.ts +52 -0
  108. package/dist/src/services/tool-call-tracker-service.js +170 -0
  109. package/dist/src/services/tool-call-tracker-service.js.map +1 -0
  110. package/dist/src/services/tool-call-tracker-service.test.d.ts +6 -0
  111. package/dist/src/services/tool-call-tracker-service.test.js +99 -0
  112. package/dist/src/services/tool-call-tracker-service.test.js.map +1 -0
  113. package/dist/src/storage/ConversationFileWriter.d.ts +16 -0
  114. package/dist/src/storage/ConversationFileWriter.js +69 -0
  115. package/dist/src/storage/ConversationFileWriter.js.map +1 -0
  116. package/dist/src/telemetry/clearcut-logger/clearcut-logger.d.ts +8 -0
  117. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js +56 -3
  118. package/dist/src/telemetry/clearcut-logger/clearcut-logger.js.map +1 -1
  119. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.d.ts +6 -0
  120. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js +187 -0
  121. package/dist/src/telemetry/clearcut-logger/clearcut-logger.test.js.map +1 -0
  122. package/dist/src/telemetry/clearcut-logger/event-metadata-key.d.ts +5 -1
  123. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js +11 -0
  124. package/dist/src/telemetry/clearcut-logger/event-metadata-key.js.map +1 -1
  125. package/dist/src/telemetry/constants.d.ts +5 -0
  126. package/dist/src/telemetry/constants.js +5 -0
  127. package/dist/src/telemetry/constants.js.map +1 -1
  128. package/dist/src/telemetry/loggers.d.ts +5 -1
  129. package/dist/src/telemetry/loggers.js +87 -1
  130. package/dist/src/telemetry/loggers.js.map +1 -1
  131. package/dist/src/telemetry/loggers.test.circular.js +7 -2
  132. package/dist/src/telemetry/loggers.test.circular.js.map +1 -1
  133. package/dist/src/telemetry/loggers.test.js +7 -2
  134. package/dist/src/telemetry/loggers.test.js.map +1 -1
  135. package/dist/src/telemetry/metrics.d.ts +3 -2
  136. package/dist/src/telemetry/metrics.js +7 -1
  137. package/dist/src/telemetry/metrics.js.map +1 -1
  138. package/dist/src/telemetry/metrics.test.js +50 -0
  139. package/dist/src/telemetry/metrics.test.js.map +1 -1
  140. package/dist/src/telemetry/tool-call-decision.d.ts +13 -0
  141. package/dist/src/telemetry/tool-call-decision.js +29 -0
  142. package/dist/src/telemetry/tool-call-decision.js.map +1 -0
  143. package/dist/src/telemetry/types.d.ts +58 -2
  144. package/dist/src/telemetry/types.js +126 -1
  145. package/dist/src/telemetry/types.js.map +1 -1
  146. package/dist/src/telemetry/uiTelemetry.d.ts +4 -1
  147. package/dist/src/telemetry/uiTelemetry.js +3 -1
  148. package/dist/src/telemetry/uiTelemetry.js.map +1 -1
  149. package/dist/src/telemetry/uiTelemetry.test.js +13 -2
  150. package/dist/src/telemetry/uiTelemetry.test.js.map +1 -1
  151. package/dist/src/test-utils/tools.d.ts +23 -0
  152. package/dist/src/test-utils/tools.js +41 -0
  153. package/dist/src/test-utils/tools.js.map +1 -0
  154. package/dist/src/tools/diffOptions.d.ts +2 -0
  155. package/dist/src/tools/diffOptions.js +28 -0
  156. package/dist/src/tools/diffOptions.js.map +1 -1
  157. package/dist/src/tools/diffOptions.test.d.ts +6 -0
  158. package/dist/src/tools/diffOptions.test.js +119 -0
  159. package/dist/src/tools/diffOptions.test.js.map +1 -0
  160. package/dist/src/tools/edit.d.ts +9 -33
  161. package/dist/src/tools/edit.js +167 -132
  162. package/dist/src/tools/edit.js.map +1 -1
  163. package/dist/src/tools/edit.test.js +124 -50
  164. package/dist/src/tools/edit.test.js.map +1 -1
  165. package/dist/src/tools/glob.d.ts +3 -10
  166. package/dist/src/tools/glob.js +97 -99
  167. package/dist/src/tools/glob.js.map +1 -1
  168. package/dist/src/tools/glob.test.js +37 -26
  169. package/dist/src/tools/glob.test.js.map +1 -1
  170. package/dist/src/tools/grep.d.ts +3 -35
  171. package/dist/src/tools/grep.js +117 -88
  172. package/dist/src/tools/grep.js.map +1 -1
  173. package/dist/src/tools/grep.test.js +36 -22
  174. package/dist/src/tools/grep.test.js.map +1 -1
  175. package/dist/src/tools/mcp-client.d.ts +14 -3
  176. package/dist/src/tools/mcp-client.js +82 -6
  177. package/dist/src/tools/mcp-client.js.map +1 -1
  178. package/dist/src/tools/mcp-client.test.js +337 -2
  179. package/dist/src/tools/mcp-client.test.js.map +1 -1
  180. package/dist/src/tools/memoryTool.d.ts +2 -2
  181. package/dist/src/tools/memoryTool.js +1 -0
  182. package/dist/src/tools/memoryTool.js.map +1 -1
  183. package/dist/src/tools/modifiable-tool.d.ts +8 -5
  184. package/dist/src/tools/modifiable-tool.js +4 -1
  185. package/dist/src/tools/modifiable-tool.js.map +1 -1
  186. package/dist/src/tools/modifiable-tool.test.js +3 -3
  187. package/dist/src/tools/modifiable-tool.test.js.map +1 -1
  188. package/dist/src/tools/read-file.d.ts +4 -6
  189. package/dist/src/tools/read-file.js +87 -46
  190. package/dist/src/tools/read-file.js.map +1 -1
  191. package/dist/src/tools/read-file.test.js +207 -126
  192. package/dist/src/tools/read-file.test.js.map +1 -1
  193. package/dist/src/tools/read-many-files.js +8 -2
  194. package/dist/src/tools/read-many-files.js.map +1 -1
  195. package/dist/src/tools/read-many-files.test.js +16 -0
  196. package/dist/src/tools/read-many-files.test.js.map +1 -1
  197. package/dist/src/tools/shell.test.js +17 -0
  198. package/dist/src/tools/shell.test.js.map +1 -1
  199. package/dist/src/tools/todo-events.d.ts +22 -0
  200. package/dist/src/tools/todo-events.js +24 -0
  201. package/dist/src/tools/todo-events.js.map +1 -0
  202. package/dist/src/tools/todo-pause.d.ts +22 -0
  203. package/dist/src/tools/todo-pause.js +93 -0
  204. package/dist/src/tools/todo-pause.js.map +1 -0
  205. package/dist/src/tools/todo-pause.spec.d.ts +6 -0
  206. package/dist/src/tools/todo-pause.spec.js +287 -0
  207. package/dist/src/tools/todo-pause.spec.js.map +1 -0
  208. package/dist/src/tools/todo-read.js.map +1 -1
  209. package/dist/src/tools/todo-schemas.d.ts +232 -4
  210. package/dist/src/tools/todo-schemas.js +13 -0
  211. package/dist/src/tools/todo-schemas.js.map +1 -1
  212. package/dist/src/tools/todo-schemas.test.js +190 -1
  213. package/dist/src/tools/todo-schemas.test.js.map +1 -1
  214. package/dist/src/tools/todo-store.d.ts +1 -4
  215. package/dist/src/tools/todo-store.js +41 -40
  216. package/dist/src/tools/todo-store.js.map +1 -1
  217. package/dist/src/tools/todo-store.test.js +34 -40
  218. package/dist/src/tools/todo-store.test.js.map +1 -1
  219. package/dist/src/tools/todo-write.d.ts +1 -1
  220. package/dist/src/tools/todo-write.js +84 -47
  221. package/dist/src/tools/todo-write.js.map +1 -1
  222. package/dist/src/tools/todo-write.test.js +23 -9
  223. package/dist/src/tools/todo-write.test.js.map +1 -1
  224. package/dist/src/tools/tool-context.d.ts +2 -0
  225. package/dist/src/tools/tool-error.d.ts +4 -0
  226. package/dist/src/tools/tool-error.js +4 -0
  227. package/dist/src/tools/tool-error.js.map +1 -1
  228. package/dist/src/tools/tool-registry.d.ts +12 -6
  229. package/dist/src/tools/tool-registry.js +19 -4
  230. package/dist/src/tools/tool-registry.js.map +1 -1
  231. package/dist/src/tools/tool-registry.test.js +3 -20
  232. package/dist/src/tools/tool-registry.test.js.map +1 -1
  233. package/dist/src/tools/tools.d.ts +134 -39
  234. package/dist/src/tools/tools.js +115 -10
  235. package/dist/src/tools/tools.js.map +1 -1
  236. package/dist/src/tools/web-search.test.js +1 -0
  237. package/dist/src/tools/web-search.test.js.map +1 -1
  238. package/dist/src/tools/write-file.d.ts +6 -2
  239. package/dist/src/tools/write-file.js +106 -16
  240. package/dist/src/tools/write-file.js.map +1 -1
  241. package/dist/src/tools/write-file.test.js +25 -7
  242. package/dist/src/tools/write-file.test.js.map +1 -1
  243. package/dist/src/types/modelParams.d.ts +4 -0
  244. package/dist/src/utils/environmentContext.d.ts +21 -0
  245. package/dist/src/utils/environmentContext.js +90 -0
  246. package/dist/src/utils/environmentContext.js.map +1 -0
  247. package/dist/src/utils/environmentContext.test.d.ts +6 -0
  248. package/dist/src/utils/environmentContext.test.js +139 -0
  249. package/dist/src/utils/environmentContext.test.js.map +1 -0
  250. package/dist/src/utils/errors.d.ts +3 -0
  251. package/dist/src/utils/errors.js +6 -0
  252. package/dist/src/utils/errors.js.map +1 -1
  253. package/dist/src/utils/fileUtils.d.ts +7 -0
  254. package/dist/src/utils/fileUtils.js +11 -10
  255. package/dist/src/utils/fileUtils.js.map +1 -1
  256. package/dist/src/utils/fileUtils.test.js +1 -4
  257. package/dist/src/utils/fileUtils.test.js.map +1 -1
  258. package/dist/src/utils/filesearch/fileSearch.d.ts +1 -0
  259. package/dist/src/utils/filesearch/fileSearch.js +27 -5
  260. package/dist/src/utils/filesearch/fileSearch.js.map +1 -1
  261. package/dist/src/utils/filesearch/fileSearch.test.js +21 -1
  262. package/dist/src/utils/filesearch/fileSearch.test.js.map +1 -1
  263. package/dist/src/utils/memoryDiscovery.js +4 -1
  264. package/dist/src/utils/memoryDiscovery.js.map +1 -1
  265. package/dist/src/utils/shell-utils.js +14 -2
  266. package/dist/src/utils/shell-utils.js.map +1 -1
  267. package/dist/src/utils/shell-utils.shellReplacement.test.d.ts +6 -0
  268. package/dist/src/utils/shell-utils.shellReplacement.test.js +149 -0
  269. package/dist/src/utils/shell-utils.shellReplacement.test.js.map +1 -0
  270. package/package.json +2 -1
@@ -3,7 +3,7 @@
3
3
  * Copyright 2025 Google LLC
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
- import { BaseTool, ToolLocation, ToolResult } from './tools.js';
6
+ import { BaseDeclarativeTool, ToolInvocation, ToolResult } from './tools.js';
7
7
  import { Config } from '../config/config.js';
8
8
  /**
9
9
  * Parameters for the ReadFile tool
@@ -25,12 +25,10 @@ export interface ReadFileToolParams {
25
25
  /**
26
26
  * Implementation of the ReadFile tool logic
27
27
  */
28
- export declare class ReadFileTool extends BaseTool<ReadFileToolParams, ToolResult> {
28
+ export declare class ReadFileTool extends BaseDeclarativeTool<ReadFileToolParams, ToolResult> {
29
29
  private config;
30
30
  static readonly Name: string;
31
31
  constructor(config: Config);
32
- validateToolParams(params: ReadFileToolParams): string | null;
33
- getDescription(params: ReadFileToolParams): string;
34
- toolLocations(params: ReadFileToolParams): ToolLocation[];
35
- execute(params: ReadFileToolParams, _signal: AbortSignal): Promise<ToolResult>;
32
+ protected validateToolParams(params: ReadFileToolParams): string | null;
33
+ protected createInvocation(params: ReadFileToolParams): ToolInvocation<ReadFileToolParams, ToolResult>;
36
34
  }
@@ -6,18 +6,100 @@
6
6
  import path from 'path';
7
7
  import { SchemaValidator } from '../utils/schemaValidator.js';
8
8
  import { makeRelative, shortenPath } from '../utils/paths.js';
9
- import { BaseTool, Icon } from './tools.js';
9
+ import { BaseDeclarativeTool, BaseToolInvocation, Icon, } from './tools.js';
10
+ import { ToolErrorType } from './tool-error.js';
10
11
  import { Type } from '@google/genai';
11
12
  import { processSingleFileContent, getSpecificMimeType, } from '../utils/fileUtils.js';
12
13
  import { recordFileOperationMetric, FileOperation, } from '../telemetry/metrics.js';
14
+ class ReadFileToolInvocation extends BaseToolInvocation {
15
+ config;
16
+ constructor(config, params) {
17
+ super(params);
18
+ this.config = config;
19
+ }
20
+ getDescription() {
21
+ const relativePath = makeRelative(this.params.absolute_path, this.config.getTargetDir());
22
+ return shortenPath(relativePath);
23
+ }
24
+ toolLocations() {
25
+ return [{ path: this.params.absolute_path, line: this.params.offset }];
26
+ }
27
+ async execute() {
28
+ const result = await processSingleFileContent(this.params.absolute_path, this.config.getTargetDir(), this.params.offset, this.params.limit);
29
+ if (result.error) {
30
+ // Map error messages to ToolErrorType
31
+ let errorType;
32
+ let llmContent;
33
+ // Check error message patterns to determine error type
34
+ if (result.error.includes('File not found') ||
35
+ result.error.includes('does not exist') ||
36
+ result.error.includes('ENOENT')) {
37
+ errorType = ToolErrorType.FILE_NOT_FOUND;
38
+ llmContent =
39
+ 'Could not read file because no file was found at the specified path.';
40
+ }
41
+ else if (result.error.includes('is a directory') ||
42
+ result.error.includes('EISDIR')) {
43
+ errorType = ToolErrorType.INVALID_TOOL_PARAMS;
44
+ llmContent =
45
+ 'Could not read file because the provided path is a directory, not a file.';
46
+ }
47
+ else if (result.error.includes('too large') ||
48
+ result.error.includes('File size exceeds')) {
49
+ errorType = ToolErrorType.FILE_TOO_LARGE;
50
+ llmContent = `Could not read file. ${result.error}`;
51
+ }
52
+ else {
53
+ // Other read errors map to READ_CONTENT_FAILURE
54
+ errorType = ToolErrorType.READ_CONTENT_FAILURE;
55
+ llmContent = `Could not read file. ${result.error}`;
56
+ }
57
+ return {
58
+ llmContent,
59
+ returnDisplay: result.returnDisplay || 'Error reading file',
60
+ error: {
61
+ message: result.error,
62
+ type: errorType,
63
+ },
64
+ };
65
+ }
66
+ let llmContent;
67
+ if (result.isTruncated) {
68
+ const [start, end] = result.linesShown;
69
+ const total = result.originalLineCount;
70
+ const nextOffset = this.params.offset
71
+ ? this.params.offset + end - start + 1
72
+ : end;
73
+ llmContent = `
74
+ IMPORTANT: The file content has been truncated.
75
+ Status: Showing lines ${start}-${end} of ${total} total lines.
76
+ Action: To read more of the file, you can use the 'offset' and 'limit' parameters in a subsequent 'read_file' call. For example, to read the next section of the file, use offset: ${nextOffset}.
77
+
78
+ --- FILE CONTENT (truncated) ---
79
+ ${result.llmContent}`;
80
+ }
81
+ else {
82
+ llmContent = result.llmContent || '';
83
+ }
84
+ const lines = typeof result.llmContent === 'string'
85
+ ? result.llmContent.split('\n').length
86
+ : undefined;
87
+ const mimetype = getSpecificMimeType(this.params.absolute_path);
88
+ recordFileOperationMetric(this.config, FileOperation.READ, lines, mimetype, path.extname(this.params.absolute_path));
89
+ return {
90
+ llmContent,
91
+ returnDisplay: result.returnDisplay || '',
92
+ };
93
+ }
94
+ }
13
95
  /**
14
96
  * Implementation of the ReadFile tool logic
15
97
  */
16
- export class ReadFileTool extends BaseTool {
98
+ export class ReadFileTool extends BaseDeclarativeTool {
17
99
  config;
18
100
  static Name = 'read_file';
19
101
  constructor(config) {
20
- super(ReadFileTool.Name, 'ReadFile', 'Reads and returns the content of a specified file from the local filesystem. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), and PDF files. For text files, it can read specific line ranges.', Icon.FileSearch, {
102
+ super(ReadFileTool.Name, 'ReadFile', `Reads and returns the content of a specified file. If the file is large, the content will be truncated. The tool's response will clearly indicate if truncation has occurred and will provide details on how to read more of the file using the 'offset' and 'limit' parameters. Handles text, images (PNG, JPG, GIF, WEBP, SVG, BMP), and PDF files. For text files, it can read specific line ranges.`, Icon.FileSearch, {
21
103
  properties: {
22
104
  absolute_path: {
23
105
  description: "The absolute path to the file to read (e.g., '/home/user/project/file.txt'). Relative paths are not supported. You must provide an absolute path.",
@@ -63,49 +145,8 @@ export class ReadFileTool extends BaseTool {
63
145
  }
64
146
  return null;
65
147
  }
66
- getDescription(params) {
67
- if (!params ||
68
- typeof params.absolute_path !== 'string' ||
69
- params.absolute_path.trim() === '') {
70
- return `Path unavailable`;
71
- }
72
- const relativePath = makeRelative(params.absolute_path, this.config.getTargetDir());
73
- let description = shortenPath(relativePath);
74
- if (params.offset !== undefined && params.limit !== undefined) {
75
- description += ` (lines ${params.offset + 1}-${params.offset + params.limit})`;
76
- }
77
- else if (params.limit !== undefined) {
78
- description += ` (first ${params.limit} lines)`;
79
- }
80
- return description;
81
- }
82
- toolLocations(params) {
83
- return [{ path: params.absolute_path, line: params.offset }];
84
- }
85
- async execute(params, _signal) {
86
- const validationError = this.validateToolParams(params);
87
- if (validationError) {
88
- return {
89
- llmContent: `Error: Invalid parameters provided. Reason: ${validationError}`,
90
- returnDisplay: validationError,
91
- };
92
- }
93
- const result = await processSingleFileContent(params.absolute_path, this.config.getTargetDir(), params.offset, params.limit);
94
- if (result.error) {
95
- return {
96
- llmContent: result.error, // The detailed error for LLM
97
- returnDisplay: result.returnDisplay || 'Error reading file', // User-friendly error
98
- };
99
- }
100
- const lines = typeof result.llmContent === 'string'
101
- ? result.llmContent.split('\n').length
102
- : undefined;
103
- const mimetype = getSpecificMimeType(params.absolute_path);
104
- recordFileOperationMetric(this.config, FileOperation.READ, lines, mimetype, path.extname(params.absolute_path));
105
- return {
106
- llmContent: result.llmContent || '',
107
- returnDisplay: result.returnDisplay || '',
108
- };
148
+ createInvocation(params) {
149
+ return new ReadFileToolInvocation(this.config, params);
109
150
  }
110
151
  }
111
152
  //# sourceMappingURL=read-file.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/tools/read-file.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,IAAI,EAA4B,MAAM,YAAY,CAAC;AACtE,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,yBAAyB,EACzB,aAAa,GACd,MAAM,yBAAyB,CAAC;AAsBjC;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,QAAwC;IAGpD;IAFpB,MAAM,CAAU,IAAI,GAAW,WAAW,CAAC;IAE3C,YAAoB,MAAc;QAChC,KAAK,CACH,YAAY,CAAC,IAAI,EACjB,UAAU,EACV,qMAAqM,EACrM,IAAI,CAAC,UAAU,EACf;YACE,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,WAAW,EACT,mJAAmJ;oBACrJ,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB;gBACD,MAAM,EAAE;oBACN,WAAW,EACT,8IAA8I;oBAChJ,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB;gBACD,KAAK,EAAE;oBACL,WAAW,EACT,uLAAuL;oBACzL,IAAI,EAAE,IAAI,CAAC,MAAM;iBAClB;aACF;YACD,QAAQ,EAAE,CAAC,eAAe,CAAC;YAC3B,IAAI,EAAE,IAAI,CAAC,MAAM;SAClB,CACF,CAAC;QA3BgB,WAAM,GAAN,MAAM,CAAQ;IA4BlC,CAAC;IAED,kBAAkB,CAAC,MAA0B;QAC3C,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACxE,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,aAAa,CAAC;QACtC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/B,OAAO,iDAAiD,QAAQ,sCAAsC,CAAC;QACzG,CAAC;QAED,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC3D,IAAI,CAAC,gBAAgB,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,gBAAgB,CAAC,cAAc,EAAE,CAAC;YACtD,OAAO,8DAA8D,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAChG,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrD,OAAO,sCAAsC,CAAC;QAChD,CAAC;QACD,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO,iCAAiC,CAAC;QAC3C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACjD,IAAI,WAAW,CAAC,sBAAsB,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAC7D,OAAO,cAAc,QAAQ,2CAA2C,CAAC;QAC3E,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,MAA0B;QACvC,IACE,CAAC,MAAM;YACP,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;YACxC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,EAClC,CAAC;YACD,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QACD,MAAM,YAAY,GAAG,YAAY,CAC/B,MAAM,CAAC,aAAa,EACpB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAC3B,CAAC;QACF,IAAI,WAAW,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC9D,WAAW,IAAI,WAAW,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC;QACjF,CAAC;aAAM,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YACtC,WAAW,IAAI,WAAW,MAAM,CAAC,KAAK,SAAS,CAAC;QAClD,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,aAAa,CAAC,MAA0B;QACtC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,aAAa,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAA0B,EAC1B,OAAoB;QAEpB,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QACxD,IAAI,eAAe,EAAE,CAAC;YACpB,OAAO;gBACL,UAAU,EAAE,+CAA+C,eAAe,EAAE;gBAC5E,aAAa,EAAE,eAAe;aAC/B,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAC3C,MAAM,CAAC,aAAa,EACpB,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,EAC1B,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,KAAK,CACb,CAAC;QAEF,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACjB,OAAO;gBACL,UAAU,EAAE,MAAM,CAAC,KAAK,EAAE,6BAA6B;gBACvD,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,oBAAoB,EAAE,sBAAsB;aACpF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GACT,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;YACnC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM;YACtC,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QAC3D,yBAAyB,CACvB,IAAI,CAAC,MAAM,EACX,aAAa,CAAC,IAAI,EAClB,KAAK,EACL,QAAQ,EACR,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,CAAC,CACnC,CAAC;QAEF,OAAO;YACL,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE;YACnC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;SAC1C,CAAC;IACJ,CAAC"}
1
+ {"version":3,"file":"read-file.js","sourceRoot":"","sources":["../../../src/tools/read-file.ts"],"names":[],"mappings":"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"}