@within-7/minto 0.1.7 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (601) hide show
  1. package/cli.js +155 -37
  2. package/dist/Tool.js +38 -0
  3. package/dist/Tool.js.map +3 -3
  4. package/dist/commands/agents/AgentsCommand.js +73 -49
  5. package/dist/commands/agents/AgentsCommand.js.map +2 -2
  6. package/dist/commands/agents/constants.js +1 -1
  7. package/dist/commands/agents/constants.js.map +1 -1
  8. package/dist/commands/agents/index.js +1 -1
  9. package/dist/commands/bug.js +74 -7
  10. package/dist/commands/bug.js.map +3 -3
  11. package/dist/commands/clear.js +3 -0
  12. package/dist/commands/clear.js.map +2 -2
  13. package/dist/commands/compact.js +37 -0
  14. package/dist/commands/compact.js.map +2 -2
  15. package/dist/commands/context.js +85 -0
  16. package/dist/commands/context.js.map +7 -0
  17. package/dist/commands/ctx_viz.js +18 -10
  18. package/dist/commands/ctx_viz.js.map +2 -2
  19. package/dist/commands/doctor.js +158 -12
  20. package/dist/commands/doctor.js.map +2 -2
  21. package/dist/commands/export.js +157 -0
  22. package/dist/commands/export.js.map +7 -0
  23. package/dist/commands/mcp-interactive.js +28 -18
  24. package/dist/commands/mcp-interactive.js.map +2 -2
  25. package/dist/commands/model.js +9 -7
  26. package/dist/commands/model.js.map +2 -2
  27. package/dist/commands/permissions.js +87 -0
  28. package/dist/commands/permissions.js.map +7 -0
  29. package/dist/commands/plugin/AddMarketplaceForm.js +3 -2
  30. package/dist/commands/plugin/AddMarketplaceForm.js.map +2 -2
  31. package/dist/commands/plugin/ConfirmDialog.js +2 -1
  32. package/dist/commands/plugin/ConfirmDialog.js.map +2 -2
  33. package/dist/commands/plugin/ErrorView.js +2 -1
  34. package/dist/commands/plugin/ErrorView.js.map +2 -2
  35. package/dist/commands/plugin/InstalledPluginsByMarketplace.js +5 -4
  36. package/dist/commands/plugin/InstalledPluginsByMarketplace.js.map +2 -2
  37. package/dist/commands/plugin/InstalledPluginsManager.js +5 -4
  38. package/dist/commands/plugin/InstalledPluginsManager.js.map +2 -2
  39. package/dist/commands/plugin/MainMenu.js +2 -1
  40. package/dist/commands/plugin/MainMenu.js.map +2 -2
  41. package/dist/commands/plugin/MarketplaceManager.js +5 -4
  42. package/dist/commands/plugin/MarketplaceManager.js.map +2 -2
  43. package/dist/commands/plugin/MarketplaceSelector.js +4 -3
  44. package/dist/commands/plugin/MarketplaceSelector.js.map +2 -2
  45. package/dist/commands/plugin/PlaceholderScreen.js +3 -2
  46. package/dist/commands/plugin/PlaceholderScreen.js.map +2 -2
  47. package/dist/commands/plugin/PluginBrowser.js +6 -5
  48. package/dist/commands/plugin/PluginBrowser.js.map +2 -2
  49. package/dist/commands/plugin/PluginDetailsInstall.js +5 -4
  50. package/dist/commands/plugin/PluginDetailsInstall.js.map +2 -2
  51. package/dist/commands/plugin/PluginDetailsManage.js +4 -3
  52. package/dist/commands/plugin/PluginDetailsManage.js.map +2 -2
  53. package/dist/commands/plugin.js +16 -15
  54. package/dist/commands/plugin.js.map +2 -2
  55. package/dist/commands/quit.js +3 -1
  56. package/dist/commands/quit.js.map +2 -2
  57. package/dist/commands/sandbox.js +105 -0
  58. package/dist/commands/sandbox.js.map +7 -0
  59. package/dist/commands/setup.js +2 -1
  60. package/dist/commands/setup.js.map +2 -2
  61. package/dist/commands/status.js +59 -0
  62. package/dist/commands/status.js.map +7 -0
  63. package/dist/commands/tasks.js +108 -0
  64. package/dist/commands/tasks.js.map +7 -0
  65. package/dist/commands/todos.js +123 -0
  66. package/dist/commands/todos.js.map +7 -0
  67. package/dist/commands/undo.js +245 -0
  68. package/dist/commands/undo.js.map +7 -0
  69. package/dist/commands.js +22 -2
  70. package/dist/commands.js.map +2 -2
  71. package/dist/components/AgentThinkingBlock.js +10 -18
  72. package/dist/components/AgentThinkingBlock.js.map +2 -2
  73. package/dist/components/AsciiLogo.js +7 -8
  74. package/dist/components/AsciiLogo.js.map +2 -2
  75. package/dist/components/AskUserQuestionDialog/AskUserQuestionDialog.js +3 -2
  76. package/dist/components/AskUserQuestionDialog/AskUserQuestionDialog.js.map +2 -2
  77. package/dist/components/AskUserQuestionDialog/QuestionView.js +2 -1
  78. package/dist/components/AskUserQuestionDialog/QuestionView.js.map +2 -2
  79. package/dist/components/BackgroundTasksPanel.js +78 -29
  80. package/dist/components/BackgroundTasksPanel.js.map +2 -2
  81. package/dist/components/BashStreamingProgress.js +24 -0
  82. package/dist/components/BashStreamingProgress.js.map +7 -0
  83. package/dist/components/CollapsibleHint.js +15 -0
  84. package/dist/components/CollapsibleHint.js.map +7 -0
  85. package/dist/components/Config.js +3 -2
  86. package/dist/components/Config.js.map +2 -2
  87. package/dist/components/ConsoleOAuthFlow.js +2 -1
  88. package/dist/components/ConsoleOAuthFlow.js.map +2 -2
  89. package/dist/components/Cost.js +2 -1
  90. package/dist/components/Cost.js.map +2 -2
  91. package/dist/components/FileEditToolUpdatedMessage.js +1 -1
  92. package/dist/components/FileEditToolUpdatedMessage.js.map +2 -2
  93. package/dist/components/HeaderBar.js +13 -8
  94. package/dist/components/HeaderBar.js.map +2 -2
  95. package/dist/components/HistorySearchOverlay.js +4 -3
  96. package/dist/components/HistorySearchOverlay.js.map +2 -2
  97. package/dist/components/HotkeyHelpPanel.js +134 -0
  98. package/dist/components/HotkeyHelpPanel.js.map +7 -0
  99. package/dist/components/InvalidConfigDialog.js +2 -1
  100. package/dist/components/InvalidConfigDialog.js.map +2 -2
  101. package/dist/components/Logo.js +24 -68
  102. package/dist/components/Logo.js.map +2 -2
  103. package/dist/components/MCPServerApprovalDialog.js +2 -1
  104. package/dist/components/MCPServerApprovalDialog.js.map +2 -2
  105. package/dist/components/MCPServerDialogCopy.js +2 -1
  106. package/dist/components/MCPServerDialogCopy.js.map +2 -2
  107. package/dist/components/MCPServerMultiselectDialog.js +2 -1
  108. package/dist/components/MCPServerMultiselectDialog.js.map +2 -2
  109. package/dist/components/Message.js +23 -7
  110. package/dist/components/Message.js.map +3 -3
  111. package/dist/components/MessageSelector.js +4 -3
  112. package/dist/components/MessageSelector.js.map +2 -2
  113. package/dist/components/ModeIndicator.js +2 -1
  114. package/dist/components/ModeIndicator.js.map +2 -2
  115. package/dist/components/ModelConfig.js +20 -6
  116. package/dist/components/ModelConfig.js.map +2 -2
  117. package/dist/components/ModelListManager.js +7 -6
  118. package/dist/components/ModelListManager.js.map +2 -2
  119. package/dist/components/ModelSelector/ModelSelector.js +27 -14
  120. package/dist/components/ModelSelector/ModelSelector.js.map +2 -2
  121. package/dist/components/Onboarding.js +22 -16
  122. package/dist/components/Onboarding.js.map +2 -2
  123. package/dist/components/OperationSummary.js +130 -0
  124. package/dist/components/OperationSummary.js.map +7 -0
  125. package/dist/components/ProgressBar.js +74 -0
  126. package/dist/components/ProgressBar.js.map +7 -0
  127. package/dist/components/PromptInput.js +210 -87
  128. package/dist/components/PromptInput.js.map +2 -2
  129. package/dist/components/RequestStatusIndicator.js +194 -0
  130. package/dist/components/RequestStatusIndicator.js.map +7 -0
  131. package/dist/components/SensitiveFileWarning.js +31 -0
  132. package/dist/components/SensitiveFileWarning.js.map +7 -0
  133. package/dist/components/Spinner.js +141 -27
  134. package/dist/components/Spinner.js.map +2 -2
  135. package/dist/components/SpinnerSymbol.js +21 -27
  136. package/dist/components/SpinnerSymbol.js.map +2 -2
  137. package/dist/components/StreamingBashOutput.js +9 -8
  138. package/dist/components/StreamingBashOutput.js.map +2 -2
  139. package/dist/components/StructuredDiff.js +6 -8
  140. package/dist/components/StructuredDiff.js.map +2 -2
  141. package/dist/components/SubagentBlock.js +5 -3
  142. package/dist/components/SubagentBlock.js.map +2 -2
  143. package/dist/components/SubagentProgress.js +17 -15
  144. package/dist/components/SubagentProgress.js.map +2 -2
  145. package/dist/components/TaskCard.js +30 -24
  146. package/dist/components/TaskCard.js.map +2 -2
  147. package/dist/components/TextInput.js +9 -1
  148. package/dist/components/TextInput.js.map +2 -2
  149. package/dist/components/TodoChangeBlock.js +1 -1
  150. package/dist/components/TodoChangeBlock.js.map +2 -2
  151. package/dist/components/TodoPanel.js +140 -31
  152. package/dist/components/TodoPanel.js.map +3 -3
  153. package/dist/components/TokenCounter.js +74 -0
  154. package/dist/components/TokenCounter.js.map +7 -0
  155. package/dist/components/TokenWarning.js +2 -1
  156. package/dist/components/TokenWarning.js.map +2 -2
  157. package/dist/components/ToolUseLoader.js +2 -2
  158. package/dist/components/ToolUseLoader.js.map +2 -2
  159. package/dist/components/TreeConnector.js +26 -0
  160. package/dist/components/TreeConnector.js.map +7 -0
  161. package/dist/components/TrustDialog.js +2 -1
  162. package/dist/components/TrustDialog.js.map +2 -2
  163. package/dist/components/TurnCompletionIndicator.js +18 -0
  164. package/dist/components/TurnCompletionIndicator.js.map +7 -0
  165. package/dist/components/binary-feedback/BinaryFeedbackView.js +2 -1
  166. package/dist/components/binary-feedback/BinaryFeedbackView.js.map +2 -2
  167. package/dist/components/messages/AssistantTextMessage.js +20 -9
  168. package/dist/components/messages/AssistantTextMessage.js.map +2 -2
  169. package/dist/components/messages/AssistantThinkingMessage.js +18 -3
  170. package/dist/components/messages/AssistantThinkingMessage.js.map +2 -2
  171. package/dist/components/messages/AssistantToolUseMessage.js +17 -10
  172. package/dist/components/messages/AssistantToolUseMessage.js.map +2 -2
  173. package/dist/components/messages/GroupRenderer.js +54 -0
  174. package/dist/components/messages/GroupRenderer.js.map +7 -0
  175. package/dist/components/messages/NestedTasksPreview.js +24 -0
  176. package/dist/components/messages/NestedTasksPreview.js.map +7 -0
  177. package/dist/components/messages/ParallelTasksGroupView.js +93 -0
  178. package/dist/components/messages/ParallelTasksGroupView.js.map +7 -0
  179. package/dist/components/messages/TaskInModuleView.js +218 -0
  180. package/dist/components/messages/TaskInModuleView.js.map +7 -0
  181. package/dist/components/messages/TaskOutputContent.js +56 -0
  182. package/dist/components/messages/TaskOutputContent.js.map +7 -0
  183. package/dist/components/messages/UserPromptMessage.js +2 -2
  184. package/dist/components/messages/UserPromptMessage.js.map +2 -2
  185. package/dist/components/messages/UserToolResultMessage/UserToolSuccessMessage.js +2 -3
  186. package/dist/components/messages/UserToolResultMessage/UserToolSuccessMessage.js.map +2 -2
  187. package/dist/components/permissions/FallbackPermissionRequest.js +4 -4
  188. package/dist/components/permissions/FallbackPermissionRequest.js.map +2 -2
  189. package/dist/components/permissions/FilesystemPermissionRequest/FilesystemPermissionRequest.js +4 -4
  190. package/dist/components/permissions/FilesystemPermissionRequest/FilesystemPermissionRequest.js.map +2 -2
  191. package/dist/constants/colors.js +120 -54
  192. package/dist/constants/colors.js.map +2 -2
  193. package/dist/constants/formatRules.js +102 -0
  194. package/dist/constants/formatRules.js.map +7 -0
  195. package/dist/constants/prompts.js +12 -34
  196. package/dist/constants/prompts.js.map +2 -2
  197. package/dist/constants/symbols.js +64 -6
  198. package/dist/constants/symbols.js.map +2 -2
  199. package/dist/constants/timing.js +5 -0
  200. package/dist/constants/timing.js.map +2 -2
  201. package/dist/constants/toolInputExamples.js +84 -0
  202. package/dist/constants/toolInputExamples.js.map +7 -0
  203. package/dist/core/backupManager.js +321 -0
  204. package/dist/core/backupManager.js.map +7 -0
  205. package/dist/core/config/defaults.js +84 -0
  206. package/dist/core/config/defaults.js.map +7 -0
  207. package/dist/core/config/index.js +111 -0
  208. package/dist/core/config/index.js.map +7 -0
  209. package/dist/core/config/loader.js +221 -0
  210. package/dist/core/config/loader.js.map +7 -0
  211. package/dist/core/config/migrations.js +128 -0
  212. package/dist/core/config/migrations.js.map +7 -0
  213. package/dist/core/config/schema.js +178 -0
  214. package/dist/core/config/schema.js.map +7 -0
  215. package/dist/core/costTracker.js +129 -0
  216. package/dist/core/costTracker.js.map +7 -0
  217. package/dist/core/gitAutoCommit.js +287 -0
  218. package/dist/core/gitAutoCommit.js.map +7 -0
  219. package/dist/core/index.js +8 -0
  220. package/dist/core/index.js.map +7 -0
  221. package/dist/core/operationTracker.js +212 -0
  222. package/dist/core/operationTracker.js.map +7 -0
  223. package/dist/core/permissions/auditLog.js +204 -0
  224. package/dist/core/permissions/auditLog.js.map +7 -0
  225. package/dist/core/permissions/engine/index.js +3 -0
  226. package/dist/core/permissions/engine/index.js.map +7 -0
  227. package/dist/core/permissions/engine/permissionEngine.js +106 -0
  228. package/dist/core/permissions/engine/permissionEngine.js.map +7 -0
  229. package/dist/core/permissions/engine/types.js +1 -0
  230. package/dist/core/permissions/engine/types.js.map +7 -0
  231. package/dist/core/permissions/index.js +84 -0
  232. package/dist/core/permissions/index.js.map +7 -0
  233. package/dist/core/permissions/ruleEngine.js +259 -0
  234. package/dist/core/permissions/ruleEngine.js.map +7 -0
  235. package/dist/core/permissions/rules/allowedToolsRule.js +62 -0
  236. package/dist/core/permissions/rules/allowedToolsRule.js.map +7 -0
  237. package/dist/core/permissions/rules/autoEscalationRule.js +296 -0
  238. package/dist/core/permissions/rules/autoEscalationRule.js.map +7 -0
  239. package/dist/core/permissions/rules/index.js +46 -0
  240. package/dist/core/permissions/rules/index.js.map +7 -0
  241. package/dist/core/permissions/rules/planModeRule.js +55 -0
  242. package/dist/core/permissions/rules/planModeRule.js.map +7 -0
  243. package/dist/core/permissions/rules/projectBoundaryRule.js +173 -0
  244. package/dist/core/permissions/rules/projectBoundaryRule.js.map +7 -0
  245. package/dist/core/permissions/rules/safeModeRule.js +65 -0
  246. package/dist/core/permissions/rules/safeModeRule.js.map +7 -0
  247. package/dist/core/permissions/rules/sensitivePathsRule.js +345 -0
  248. package/dist/core/permissions/rules/sensitivePathsRule.js.map +7 -0
  249. package/dist/core/permissions/types.js +127 -0
  250. package/dist/core/permissions/types.js.map +7 -0
  251. package/dist/core/tokenStats.js +9 -0
  252. package/dist/core/tokenStats.js.map +7 -0
  253. package/dist/core/tokenStatsManager.js +331 -0
  254. package/dist/core/tokenStatsManager.js.map +7 -0
  255. package/dist/core/tools/executor.js +143 -0
  256. package/dist/core/tools/executor.js.map +7 -0
  257. package/dist/core/tools/index.js +15 -0
  258. package/dist/core/tools/index.js.map +7 -0
  259. package/dist/core/tools/registry.js +183 -0
  260. package/dist/core/tools/registry.js.map +7 -0
  261. package/dist/core/tools/types.js +1 -0
  262. package/dist/core/tools/types.js.map +7 -0
  263. package/dist/cost-tracker.js +23 -15
  264. package/dist/cost-tracker.js.map +2 -2
  265. package/dist/entrypoints/cli.js +158 -130
  266. package/dist/entrypoints/cli.js.map +2 -2
  267. package/dist/entrypoints/mcp.js +12 -4
  268. package/dist/entrypoints/mcp.js.map +2 -2
  269. package/dist/history.js +14 -3
  270. package/dist/history.js.map +2 -2
  271. package/dist/hooks/useAgentTokenStats.js +72 -0
  272. package/dist/hooks/useAgentTokenStats.js.map +7 -0
  273. package/dist/hooks/useAgentTranscripts.js +140 -0
  274. package/dist/hooks/useAgentTranscripts.js.map +7 -0
  275. package/dist/hooks/useAnimationSync.js +53 -0
  276. package/dist/hooks/useAnimationSync.js.map +7 -0
  277. package/dist/hooks/useArrowKeyHistory.js +4 -2
  278. package/dist/hooks/useArrowKeyHistory.js.map +2 -2
  279. package/dist/hooks/useCanUseTool.js +3 -1
  280. package/dist/hooks/useCanUseTool.js.map +2 -2
  281. package/dist/hooks/useExitOnCtrlCD.js +9 -5
  282. package/dist/hooks/useExitOnCtrlCD.js.map +2 -2
  283. package/dist/hooks/useHookStatus.js +40 -0
  284. package/dist/hooks/useHookStatus.js.map +7 -0
  285. package/dist/hooks/useLogMessages.js +29 -2
  286. package/dist/hooks/useLogMessages.js.map +2 -2
  287. package/dist/hooks/useMessageGroups.js +43 -0
  288. package/dist/hooks/useMessageGroups.js.map +7 -0
  289. package/dist/hooks/useTerminalSize.js +62 -6
  290. package/dist/hooks/useTerminalSize.js.map +2 -2
  291. package/dist/hooks/useUnifiedCompletion.js +69 -0
  292. package/dist/hooks/useUnifiedCompletion.js.map +2 -2
  293. package/dist/i18n/index.js +109 -0
  294. package/dist/i18n/index.js.map +7 -0
  295. package/dist/i18n/locales/en.js +348 -0
  296. package/dist/i18n/locales/en.js.map +7 -0
  297. package/dist/i18n/locales/index.js +7 -0
  298. package/dist/i18n/locales/index.js.map +7 -0
  299. package/dist/i18n/locales/zh-CN.js +348 -0
  300. package/dist/i18n/locales/zh-CN.js.map +7 -0
  301. package/dist/i18n/types.js +8 -0
  302. package/dist/i18n/types.js.map +7 -0
  303. package/dist/permissions.js +28 -1
  304. package/dist/permissions.js.map +2 -2
  305. package/dist/query.js +253 -21
  306. package/dist/query.js.map +3 -3
  307. package/dist/screens/REPL.js +523 -194
  308. package/dist/screens/REPL.js.map +3 -3
  309. package/dist/services/adapters/chatCompletions.js +3 -1
  310. package/dist/services/adapters/chatCompletions.js.map +2 -2
  311. package/dist/services/adapters/messageNormalizer.js +354 -0
  312. package/dist/services/adapters/messageNormalizer.js.map +7 -0
  313. package/dist/services/adapters/responsesAPI.js +6 -3
  314. package/dist/services/adapters/responsesAPI.js.map +2 -2
  315. package/dist/services/checkpointManager.js +386 -0
  316. package/dist/services/checkpointManager.js.map +7 -0
  317. package/dist/services/claude.js +192 -14
  318. package/dist/services/claude.js.map +3 -3
  319. package/dist/services/compressionService.js +50 -1
  320. package/dist/services/compressionService.js.map +2 -2
  321. package/dist/services/contextMonitor.js +162 -0
  322. package/dist/services/contextMonitor.js.map +7 -0
  323. package/dist/services/customCommands.js +60 -41
  324. package/dist/services/customCommands.js.map +2 -2
  325. package/dist/services/hookExecutor.js +173 -1
  326. package/dist/services/hookExecutor.js.map +2 -2
  327. package/dist/services/intelligentCompactor.js +281 -0
  328. package/dist/services/intelligentCompactor.js.map +7 -0
  329. package/dist/services/lspConfig.js +109 -0
  330. package/dist/services/lspConfig.js.map +7 -0
  331. package/dist/services/mcpClient.js +338 -43
  332. package/dist/services/mcpClient.js.map +2 -2
  333. package/dist/services/modelOrchestrator.js +310 -0
  334. package/dist/services/modelOrchestrator.js.map +7 -0
  335. package/dist/services/openai.js +8 -1
  336. package/dist/services/openai.js.map +2 -2
  337. package/dist/services/outputStyles.js +138 -0
  338. package/dist/services/outputStyles.js.map +7 -0
  339. package/dist/services/plugins/index.js +5 -0
  340. package/dist/services/plugins/index.js.map +7 -0
  341. package/dist/services/plugins/lspServers.js +188 -0
  342. package/dist/services/plugins/lspServers.js.map +7 -0
  343. package/dist/services/plugins/pluginRuntime.js +229 -0
  344. package/dist/services/plugins/pluginRuntime.js.map +7 -0
  345. package/dist/services/plugins/pluginValidation.js +219 -0
  346. package/dist/services/plugins/pluginValidation.js.map +7 -0
  347. package/dist/services/plugins/skillMarketplace.js +556 -0
  348. package/dist/services/plugins/skillMarketplace.js.map +7 -0
  349. package/dist/services/responseStateManager.js +37 -3
  350. package/dist/services/responseStateManager.js.map +2 -2
  351. package/dist/services/sandbox/filesystemBoundary.js +341 -0
  352. package/dist/services/sandbox/filesystemBoundary.js.map +7 -0
  353. package/dist/services/sandbox/index.js +14 -0
  354. package/dist/services/sandbox/index.js.map +7 -0
  355. package/dist/services/sandbox/networkProxy.js +293 -0
  356. package/dist/services/sandbox/networkProxy.js.map +7 -0
  357. package/dist/services/sandbox/sandboxController.js +574 -0
  358. package/dist/services/sandbox/sandboxController.js.map +7 -0
  359. package/dist/services/sandbox/types.js +50 -0
  360. package/dist/services/sandbox/types.js.map +7 -0
  361. package/dist/services/sessionMemory.js +266 -0
  362. package/dist/services/sessionMemory.js.map +7 -0
  363. package/dist/services/taskRouter.js +324 -0
  364. package/dist/services/taskRouter.js.map +7 -0
  365. package/dist/tools/ArchitectTool/ArchitectTool.js +7 -1
  366. package/dist/tools/ArchitectTool/ArchitectTool.js.map +2 -2
  367. package/dist/tools/AskExpertModelTool/AskExpertModelTool.js +6 -2
  368. package/dist/tools/AskExpertModelTool/AskExpertModelTool.js.map +2 -2
  369. package/dist/tools/AskUserQuestionTool/AskUserQuestionTool.js +2 -1
  370. package/dist/tools/AskUserQuestionTool/AskUserQuestionTool.js.map +2 -2
  371. package/dist/tools/BaseTool.js +72 -0
  372. package/dist/tools/BaseTool.js.map +7 -0
  373. package/dist/tools/BashOutputTool/BashOutputToolResultMessage.js +3 -0
  374. package/dist/tools/BashOutputTool/BashOutputToolResultMessage.js.map +2 -2
  375. package/dist/tools/BashTool/BashTool.js +79 -3
  376. package/dist/tools/BashTool/BashTool.js.map +2 -2
  377. package/dist/tools/BashTool/BashToolResultMessage.js +3 -0
  378. package/dist/tools/BashTool/BashToolResultMessage.js.map +2 -2
  379. package/dist/tools/BashTool/OutputLine.js +54 -0
  380. package/dist/tools/BashTool/OutputLine.js.map +2 -2
  381. package/dist/tools/BashTool/prompt.js +336 -3
  382. package/dist/tools/BashTool/prompt.js.map +2 -2
  383. package/dist/tools/FileEditTool/FileEditTool.js +29 -4
  384. package/dist/tools/FileEditTool/FileEditTool.js.map +2 -2
  385. package/dist/tools/FileEditTool/prompt.js +6 -3
  386. package/dist/tools/FileEditTool/prompt.js.map +2 -2
  387. package/dist/tools/FileWriteTool/FileWriteTool.js +5 -5
  388. package/dist/tools/FileWriteTool/FileWriteTool.js.map +2 -2
  389. package/dist/tools/FileWriteTool/prompt.js +4 -2
  390. package/dist/tools/FileWriteTool/prompt.js.map +2 -2
  391. package/dist/tools/GlobTool/GlobTool.js +4 -2
  392. package/dist/tools/GlobTool/GlobTool.js.map +2 -2
  393. package/dist/tools/GrepTool/GrepTool.js +36 -7
  394. package/dist/tools/GrepTool/GrepTool.js.map +2 -2
  395. package/dist/tools/KillShellTool/KillShellToolResultMessage.js +3 -0
  396. package/dist/tools/KillShellTool/KillShellToolResultMessage.js.map +2 -2
  397. package/dist/tools/ListMcpResourcesTool/ListMcpResourcesTool.js +109 -0
  398. package/dist/tools/ListMcpResourcesTool/ListMcpResourcesTool.js.map +7 -0
  399. package/dist/tools/ListMcpResourcesTool/prompt.js +19 -0
  400. package/dist/tools/ListMcpResourcesTool/prompt.js.map +7 -0
  401. package/dist/tools/LspTool/LspTool.js +664 -0
  402. package/dist/tools/LspTool/LspTool.js.map +7 -0
  403. package/dist/tools/LspTool/prompt.js +27 -0
  404. package/dist/tools/LspTool/prompt.js.map +7 -0
  405. package/dist/tools/MCPTool/MCPTool.js +9 -1
  406. package/dist/tools/MCPTool/MCPTool.js.map +2 -2
  407. package/dist/tools/MemoryReadTool/MemoryReadTool.js +19 -6
  408. package/dist/tools/MemoryReadTool/MemoryReadTool.js.map +2 -2
  409. package/dist/tools/MemoryWriteTool/MemoryWriteTool.js +6 -6
  410. package/dist/tools/MemoryWriteTool/MemoryWriteTool.js.map +2 -2
  411. package/dist/tools/MultiEditTool/MultiEditTool.js +19 -2
  412. package/dist/tools/MultiEditTool/MultiEditTool.js.map +2 -2
  413. package/dist/tools/MultiEditTool/prompt.js +5 -3
  414. package/dist/tools/MultiEditTool/prompt.js.map +2 -2
  415. package/dist/tools/NotebookEditTool/NotebookEditTool.js +7 -2
  416. package/dist/tools/NotebookEditTool/NotebookEditTool.js.map +2 -2
  417. package/dist/tools/NotebookReadTool/NotebookReadTool.js.map +2 -2
  418. package/dist/tools/PlanModeTool/EnterPlanModeTool.js +75 -0
  419. package/dist/tools/PlanModeTool/EnterPlanModeTool.js.map +7 -0
  420. package/dist/tools/PlanModeTool/ExitPlanModeTool.js +109 -0
  421. package/dist/tools/PlanModeTool/ExitPlanModeTool.js.map +7 -0
  422. package/dist/tools/PlanModeTool/prompt.js +94 -0
  423. package/dist/tools/PlanModeTool/prompt.js.map +7 -0
  424. package/dist/tools/ReadMcpResourceTool/ReadMcpResourceTool.js +130 -0
  425. package/dist/tools/ReadMcpResourceTool/ReadMcpResourceTool.js.map +7 -0
  426. package/dist/tools/ReadMcpResourceTool/prompt.js +17 -0
  427. package/dist/tools/ReadMcpResourceTool/prompt.js.map +7 -0
  428. package/dist/tools/SkillTool/SkillTool.js +10 -4
  429. package/dist/tools/SkillTool/SkillTool.js.map +2 -2
  430. package/dist/tools/SkillTool/prompt.js +1 -1
  431. package/dist/tools/SkillTool/prompt.js.map +1 -1
  432. package/dist/tools/SlashCommandTool/SlashCommandTool.js +260 -0
  433. package/dist/tools/SlashCommandTool/SlashCommandTool.js.map +7 -0
  434. package/dist/tools/SlashCommandTool/prompt.js +35 -0
  435. package/dist/tools/SlashCommandTool/prompt.js.map +7 -0
  436. package/dist/tools/TaskOutputTool/TaskOutputTool.js +190 -0
  437. package/dist/tools/TaskOutputTool/TaskOutputTool.js.map +7 -0
  438. package/dist/tools/TaskOutputTool/prompt.js +15 -0
  439. package/dist/tools/TaskOutputTool/prompt.js.map +7 -0
  440. package/dist/tools/TaskTool/TaskTool.js +310 -104
  441. package/dist/tools/TaskTool/TaskTool.js.map +2 -2
  442. package/dist/tools/TaskTool/prompt.js.map +2 -2
  443. package/dist/tools/TodoWriteTool/TodoWriteTool.js +42 -77
  444. package/dist/tools/TodoWriteTool/TodoWriteTool.js.map +2 -2
  445. package/dist/tools/URLFetcherTool/URLFetcherTool.js +4 -1
  446. package/dist/tools/URLFetcherTool/URLFetcherTool.js.map +2 -2
  447. package/dist/tools/URLFetcherTool/cache.js +55 -8
  448. package/dist/tools/URLFetcherTool/cache.js.map +2 -2
  449. package/dist/tools.js +31 -2
  450. package/dist/tools.js.map +2 -2
  451. package/dist/types/hooks.js +4 -0
  452. package/dist/types/hooks.js.map +2 -2
  453. package/dist/types/marketplace.js.map +2 -2
  454. package/dist/types/messageGroup.js +36 -0
  455. package/dist/types/messageGroup.js.map +7 -0
  456. package/dist/types/plugin.js.map +2 -2
  457. package/dist/types/thinking.js +1 -0
  458. package/dist/types/thinking.js.map +7 -0
  459. package/dist/utils/BackgroundShellManager.js +136 -39
  460. package/dist/utils/BackgroundShellManager.js.map +2 -2
  461. package/dist/utils/CircuitBreaker.js +242 -0
  462. package/dist/utils/CircuitBreaker.js.map +7 -0
  463. package/dist/utils/MessageBatchBuffer.js +102 -0
  464. package/dist/utils/MessageBatchBuffer.js.map +7 -0
  465. package/dist/utils/PersistentShell.js +151 -1
  466. package/dist/utils/PersistentShell.js.map +2 -2
  467. package/dist/utils/agentLoader.js +1 -23
  468. package/dist/utils/agentLoader.js.map +2 -2
  469. package/dist/utils/agentTranscripts.js +641 -0
  470. package/dist/utils/agentTranscripts.js.map +7 -0
  471. package/dist/utils/animationManager.js +213 -0
  472. package/dist/utils/animationManager.js.map +7 -0
  473. package/dist/utils/animationSync.js +110 -0
  474. package/dist/utils/animationSync.js.map +7 -0
  475. package/dist/utils/ask.js +2 -0
  476. package/dist/utils/ask.js.map +2 -2
  477. package/dist/utils/asyncFile.js +215 -0
  478. package/dist/utils/asyncFile.js.map +7 -0
  479. package/dist/utils/backgroundAgentManager.js +231 -0
  480. package/dist/utils/backgroundAgentManager.js.map +7 -0
  481. package/dist/utils/config.js +108 -10
  482. package/dist/utils/config.js.map +2 -2
  483. package/dist/utils/conversationRecovery.js +19 -0
  484. package/dist/utils/conversationRecovery.js.map +2 -2
  485. package/dist/utils/credentials/CredentialStore.js +1 -0
  486. package/dist/utils/credentials/CredentialStore.js.map +7 -0
  487. package/dist/utils/credentials/EncryptedFileStore.js +157 -0
  488. package/dist/utils/credentials/EncryptedFileStore.js.map +7 -0
  489. package/dist/utils/credentials/index.js +37 -0
  490. package/dist/utils/credentials/index.js.map +7 -0
  491. package/dist/utils/credentials/migration.js +82 -0
  492. package/dist/utils/credentials/migration.js.map +7 -0
  493. package/dist/utils/exit.js +73 -0
  494. package/dist/utils/exit.js.map +7 -0
  495. package/dist/utils/format.js +73 -5
  496. package/dist/utils/format.js.map +2 -2
  497. package/dist/utils/generators.js +76 -6
  498. package/dist/utils/generators.js.map +2 -2
  499. package/dist/utils/globalErrorHandler.js +149 -0
  500. package/dist/utils/globalErrorHandler.js.map +7 -0
  501. package/dist/utils/groupHandlers/index.js +8 -0
  502. package/dist/utils/groupHandlers/index.js.map +7 -0
  503. package/dist/utils/groupHandlers/parallelTasksHandler.js +140 -0
  504. package/dist/utils/groupHandlers/parallelTasksHandler.js.map +7 -0
  505. package/dist/utils/groupHandlers/taskHandler.js +104 -0
  506. package/dist/utils/groupHandlers/taskHandler.js.map +7 -0
  507. package/dist/utils/groupHandlers/types.js +1 -0
  508. package/dist/utils/groupHandlers/types.js.map +7 -0
  509. package/dist/utils/logRotation.js +224 -0
  510. package/dist/utils/logRotation.js.map +7 -0
  511. package/dist/utils/markdown.js +13 -1
  512. package/dist/utils/markdown.js.map +2 -2
  513. package/dist/utils/marketplaceManager.js +3 -5
  514. package/dist/utils/marketplaceManager.js.map +2 -2
  515. package/dist/utils/memSafety.js +264 -0
  516. package/dist/utils/memSafety.js.map +7 -0
  517. package/dist/utils/messageGroupManager.js +274 -0
  518. package/dist/utils/messageGroupManager.js.map +7 -0
  519. package/dist/utils/messages.js +13 -4
  520. package/dist/utils/messages.js.map +2 -2
  521. package/dist/utils/model.js +119 -15
  522. package/dist/utils/model.js.map +3 -3
  523. package/dist/utils/permissions/filesystem.js +162 -6
  524. package/dist/utils/permissions/filesystem.js.map +2 -2
  525. package/dist/utils/plan/planMode.js +143 -0
  526. package/dist/utils/plan/planMode.js.map +7 -0
  527. package/dist/utils/pluginLoader.js +17 -21
  528. package/dist/utils/pluginLoader.js.map +2 -2
  529. package/dist/utils/ripgrep.js +55 -2
  530. package/dist/utils/ripgrep.js.map +2 -2
  531. package/dist/utils/safePath.js +132 -0
  532. package/dist/utils/safePath.js.map +7 -0
  533. package/dist/utils/sanitizeInput.js +32 -0
  534. package/dist/utils/sanitizeInput.js.map +7 -0
  535. package/dist/utils/secureKeyStorage.js +312 -0
  536. package/dist/utils/secureKeyStorage.js.map +7 -0
  537. package/dist/utils/sensitiveFiles.js +125 -0
  538. package/dist/utils/sensitiveFiles.js.map +7 -0
  539. package/dist/utils/session/sessionPlugins.js +67 -0
  540. package/dist/utils/session/sessionPlugins.js.map +7 -0
  541. package/dist/utils/taskDisplayUtils.js +257 -0
  542. package/dist/utils/taskDisplayUtils.js.map +7 -0
  543. package/dist/utils/teamConfig.js +2 -1
  544. package/dist/utils/teamConfig.js.map +2 -2
  545. package/dist/utils/theme.js +6 -6
  546. package/dist/utils/theme.js.map +1 -1
  547. package/dist/utils/todoStorage.js +92 -2
  548. package/dist/utils/todoStorage.js.map +2 -2
  549. package/dist/utils/toolRiskClassification.js +207 -0
  550. package/dist/utils/toolRiskClassification.js.map +7 -0
  551. package/dist/utils/toolTimeout.js +136 -0
  552. package/dist/utils/toolTimeout.js.map +7 -0
  553. package/dist/utils/tooling/safeRender.js +116 -0
  554. package/dist/utils/tooling/safeRender.js.map +7 -0
  555. package/dist/utils/userFriendlyError.js +346 -0
  556. package/dist/utils/userFriendlyError.js.map +7 -0
  557. package/dist/utils/vendor/ripgrep/arm64-darwin/rg +0 -0
  558. package/dist/version.js +2 -2
  559. package/dist/version.js.map +1 -1
  560. package/package.json +17 -5
  561. package/scripts/postinstall.js +128 -38
  562. package/dist/commands/agents.js +0 -2086
  563. package/dist/commands/agents.js.map +0 -7
  564. package/dist/commands/build.js +0 -74
  565. package/dist/commands/build.js.map +0 -7
  566. package/dist/commands/compression.js +0 -57
  567. package/dist/commands/compression.js.map +0 -7
  568. package/dist/commands/listen.js +0 -37
  569. package/dist/commands/listen.js.map +0 -7
  570. package/dist/commands/login.js +0 -37
  571. package/dist/commands/login.js.map +0 -7
  572. package/dist/commands/logout.js +0 -33
  573. package/dist/commands/logout.js.map +0 -7
  574. package/dist/commands/mcp.js +0 -40
  575. package/dist/commands/mcp.js.map +0 -7
  576. package/dist/commands/mcp_refresh.js +0 -40
  577. package/dist/commands/mcp_refresh.js.map +0 -7
  578. package/dist/commands/modelstatus.js +0 -21
  579. package/dist/commands/modelstatus.js.map +0 -7
  580. package/dist/commands/onboarding.js +0 -36
  581. package/dist/commands/onboarding.js.map +0 -7
  582. package/dist/commands/plugin-interactive.js +0 -446
  583. package/dist/commands/plugin-interactive.js.map +0 -7
  584. package/dist/commands/pr_comments.js +0 -61
  585. package/dist/commands/pr_comments.js.map +0 -7
  586. package/dist/commands/release-notes.js +0 -30
  587. package/dist/commands/release-notes.js.map +0 -7
  588. package/dist/commands/review.js +0 -51
  589. package/dist/commands/review.js.map +0 -7
  590. package/dist/components/Bug.js +0 -147
  591. package/dist/components/Bug.js.map +0 -7
  592. package/dist/components/ModelSelector.js +0 -2062
  593. package/dist/components/ModelSelector.js.map +0 -7
  594. package/dist/components/ModelStatusDisplay.js +0 -87
  595. package/dist/components/ModelStatusDisplay.js.map +0 -7
  596. package/dist/entrypoints/cli-wrapper.js +0 -61
  597. package/dist/entrypoints/cli-wrapper.js.map +0 -7
  598. package/dist/hooks/useCancelRequest.js +0 -28
  599. package/dist/hooks/useCancelRequest.js.map +0 -7
  600. package/dist/screens/Doctor.js +0 -22
  601. package/dist/screens/Doctor.js.map +0 -7
@@ -1,8 +1,53 @@
1
1
  const SYMBOLS = {
2
- // Task & Subagent 相关符号
3
- /** Task 工具调用指示器 */
2
+ // ============================================================================
3
+ // 操作类型符号 (Operation Type Symbols)
4
+ // 用于区分不同类型的操作,每种操作有独特的视觉标识
5
+ // ============================================================================
6
+ /** 用户输入提示符 */
7
+ PROMPT: "\u276F",
8
+ /** 工具执行中 */
9
+ TOOL_RUNNING: "\u25D0",
10
+ /** 工具执行成功 */
11
+ TOOL_SUCCESS: "\u2713",
12
+ /** 工具执行失败 */
13
+ TOOL_ERROR: "\u2717",
14
+ /** Todo 状态更新 */
15
+ TODO_UPDATE: "\u23FA",
16
+ /** 并行任务组 */
17
+ PARALLEL_GROUP: "\u25C8",
18
+ /** AI 思考中 */
19
+ THINKING: "\u273B",
20
+ /** AI 输出块 */
21
+ OUTPUT_BLOCK: "\u25CF",
22
+ // ============================================================================
23
+ // 状态后缀符号 (Status Suffix Symbols)
24
+ // 附加在操作末尾,表示当前状态
25
+ // ============================================================================
26
+ /** 进行中后缀 */
27
+ SUFFIX_RUNNING: "\u2026",
28
+ /** 需要注意后缀 */
29
+ SUFFIX_ATTENTION: "!",
30
+ // ============================================================================
31
+ // 结构符号 (Structure Symbols)
32
+ // 用于嵌套层级和树形结构显示
33
+ // ============================================================================
34
+ /** 子项输出连接符 */
35
+ CHILD_OUTPUT: "\u23BF",
36
+ /** 树形中间分支 */
37
+ TREE_BRANCH: "\u251C\u2500",
38
+ /** 树形最后分支 */
39
+ TREE_LAST: "\u2514\u2500",
40
+ /** 树形垂直线 */
41
+ TREE_VERTICAL: "\u2502",
42
+ /** 树形空白对齐 */
43
+ TREE_SPACE: " ",
44
+ // ============================================================================
45
+ // 兼容性保留 (Legacy Compatibility)
46
+ // 保留旧符号名称以兼容现有代码
47
+ // ============================================================================
48
+ /** @deprecated 使用 TODO_UPDATE 替代 */
4
49
  TASK_INDICATOR: "\u23FA",
5
- /** Subagent 状态分支符号 */
50
+ /** @deprecated 使用 CHILD_OUTPUT 替代 */
6
51
  TASK_BRANCH: "\u23BF",
7
52
  // TODO 相关符号 - Claude Code 风格
8
53
  /** 待办事项(pending/in_progress) */
@@ -24,9 +69,21 @@ const SYMBOLS = {
24
69
  THINKING_FRAMES: ["\xB7", "\u2722", "\u273B", "\u2736", "\u2733", "\u273D"],
25
70
  // 省略符号
26
71
  ELLIPSIS: "\u2026",
27
- // 点符号
28
- DOT: "\xB7"
72
+ // 点符号(用于元信息分隔)
73
+ DOT: "\xB7",
74
+ // 元信息分隔符(空格+点+空格)
75
+ META_SEPARATOR: " \xB7 "
29
76
  };
77
+ function getToolStatusSymbol(status) {
78
+ switch (status) {
79
+ case "running":
80
+ return SYMBOLS.TOOL_RUNNING;
81
+ case "success":
82
+ return SYMBOLS.TOOL_SUCCESS;
83
+ case "error":
84
+ return SYMBOLS.TOOL_ERROR;
85
+ }
86
+ }
30
87
  function getStatusSymbol(status) {
31
88
  switch (status) {
32
89
  case "queued":
@@ -45,6 +102,7 @@ function getTodoStatusSymbol(status) {
45
102
  export {
46
103
  SYMBOLS,
47
104
  getStatusSymbol,
48
- getTodoStatusSymbol
105
+ getTodoStatusSymbol,
106
+ getToolStatusSymbol
49
107
  };
50
108
  //# sourceMappingURL=symbols.js.map
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/constants/symbols.ts"],
4
- "sourcesContent": ["/**\n * \u7EC8\u7AEF\u7B26\u53F7\u5B9A\u4E49 - Claude Code CLI \u98CE\u683C\n */\n\nexport const SYMBOLS = {\n // Task & Subagent \u76F8\u5173\u7B26\u53F7\n /** Task \u5DE5\u5177\u8C03\u7528\u6307\u793A\u5668 */\n TASK_INDICATOR: '\u23FA',\n /** Subagent \u72B6\u6001\u5206\u652F\u7B26\u53F7 */\n TASK_BRANCH: '\u23BF',\n\n // TODO \u76F8\u5173\u7B26\u53F7 - Claude Code \u98CE\u683C\n /** \u5F85\u529E\u4E8B\u9879\uFF08pending/in_progress\uFF09 */\n TODO_UNCHECKED: '\u2610',\n /** \u5DF2\u5B8C\u6210\u4E8B\u9879 */\n TODO_CHECKED: '\u2612',\n\n // \u901A\u7528\u72B6\u6001\u7B26\u53F7\n /** \u6210\u529F */\n SUCCESS: '\u2714',\n /** \u9519\u8BEF */\n ERROR: '\u2716',\n /** \u4FE1\u606F */\n INFO: '\u2139',\n /** \u8B66\u544A */\n WARNING: '\u26A0',\n\n // \u52A0\u8F7D\u52A8\u753B\u5E27\uFF08spinner\uFF09\n LOADING_FRAMES: ['\u280B', '\u2819', '\u2839', '\u2838', '\u283C', '\u2834', '\u2826', '\u2827', '\u2807', '\u280F'],\n\n // Claude Code \u98CE\u683C\u7684\u601D\u8003\u52A8\u753B\u5E27\uFF086\u5E27\u5FAA\u73AF\uFF09\n THINKING_FRAMES: ['\u00B7', '\u2722', '\u273B', '\u2736', '\u2733', '\u273D'],\n\n // \u7701\u7565\u7B26\u53F7\n ELLIPSIS: '\u2026',\n\n // \u70B9\u7B26\u53F7\n DOT: '\u00B7',\n} as const\n\n/**\n * \u83B7\u53D6\u72B6\u6001\u5BF9\u5E94\u7684\u7B26\u53F7\n */\nexport function getStatusSymbol(\n status: 'queued' | 'running' | 'completed' | 'error',\n): string {\n switch (status) {\n case 'queued':\n return SYMBOLS.INFO\n case 'running':\n return SYMBOLS.LOADING_FRAMES[0]\n case 'completed':\n return SYMBOLS.SUCCESS\n case 'error':\n return SYMBOLS.ERROR\n }\n}\n\n/**\n * \u83B7\u53D6 TODO \u72B6\u6001\u5BF9\u5E94\u7684\u7B26\u53F7 - Claude Code \u98CE\u683C\n */\nexport function getTodoStatusSymbol(\n status: 'pending' | 'in_progress' | 'completed',\n): string {\n // Claude Code \u53EA\u533A\u5206\u5DF2\u5B8C\u6210\u548C\u672A\u5B8C\u6210\n return status === 'completed' ? SYMBOLS.TODO_CHECKED : SYMBOLS.TODO_UNCHECKED\n}\n"],
5
- "mappings": "AAIO,MAAM,UAAU;AAAA;AAAA;AAAA,EAGrB,gBAAgB;AAAA;AAAA,EAEhB,aAAa;AAAA;AAAA;AAAA,EAIb,gBAAgB;AAAA;AAAA,EAEhB,cAAc;AAAA;AAAA;AAAA,EAId,SAAS;AAAA;AAAA,EAET,OAAO;AAAA;AAAA,EAEP,MAAM;AAAA;AAAA,EAEN,SAAS;AAAA;AAAA,EAGT,gBAAgB,CAAC,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,QAAG;AAAA;AAAA,EAGjE,iBAAiB,CAAC,QAAK,UAAK,UAAK,UAAK,UAAK,QAAG;AAAA;AAAA,EAG9C,UAAU;AAAA;AAAA,EAGV,KAAK;AACP;AAKO,SAAS,gBACd,QACQ;AACR,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ,eAAe,CAAC;AAAA,IACjC,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ;AAAA,EACnB;AACF;AAKO,SAAS,oBACd,QACQ;AAER,SAAO,WAAW,cAAc,QAAQ,eAAe,QAAQ;AACjE;",
4
+ "sourcesContent": ["/**\n * \u7EC8\u7AEF\u7B26\u53F7\u5B9A\u4E49 - Minto REPL \u663E\u793A\u89C4\u8303\n *\n * \u7B26\u53F7\u5206\u4E3A\u4E09\u7C7B\uFF1A\n * 1. \u64CD\u4F5C\u7C7B\u578B\u7B26\u53F7 (OPERATION_*) - \u533A\u5206\u4E0D\u540C\u7C7B\u578B\u7684\u64CD\u4F5C\n * 2. \u72B6\u6001\u7B26\u53F7 (STATUS_*) - \u8868\u793A\u64CD\u4F5C\u7684\u6267\u884C\u72B6\u6001\n * 3. \u7ED3\u6784\u7B26\u53F7 (STRUCTURE_*) - \u7528\u4E8E\u5D4C\u5957\u548C\u5C42\u7EA7\u663E\u793A\n */\n\nexport const SYMBOLS = {\n // ============================================================================\n // \u64CD\u4F5C\u7C7B\u578B\u7B26\u53F7 (Operation Type Symbols)\n // \u7528\u4E8E\u533A\u5206\u4E0D\u540C\u7C7B\u578B\u7684\u64CD\u4F5C\uFF0C\u6BCF\u79CD\u64CD\u4F5C\u6709\u72EC\u7279\u7684\u89C6\u89C9\u6807\u8BC6\n // ============================================================================\n\n /** \u7528\u6237\u8F93\u5165\u63D0\u793A\u7B26 */\n PROMPT: '\u276F',\n /** \u5DE5\u5177\u6267\u884C\u4E2D */\n TOOL_RUNNING: '\u25D0',\n /** \u5DE5\u5177\u6267\u884C\u6210\u529F */\n TOOL_SUCCESS: '\u2713',\n /** \u5DE5\u5177\u6267\u884C\u5931\u8D25 */\n TOOL_ERROR: '\u2717',\n /** Todo \u72B6\u6001\u66F4\u65B0 */\n TODO_UPDATE: '\u23FA',\n /** \u5E76\u884C\u4EFB\u52A1\u7EC4 */\n PARALLEL_GROUP: '\u25C8',\n /** AI \u601D\u8003\u4E2D */\n THINKING: '\u273B',\n /** AI \u8F93\u51FA\u5757 */\n OUTPUT_BLOCK: '\u25CF',\n\n // ============================================================================\n // \u72B6\u6001\u540E\u7F00\u7B26\u53F7 (Status Suffix Symbols)\n // \u9644\u52A0\u5728\u64CD\u4F5C\u672B\u5C3E\uFF0C\u8868\u793A\u5F53\u524D\u72B6\u6001\n // ============================================================================\n\n /** \u8FDB\u884C\u4E2D\u540E\u7F00 */\n SUFFIX_RUNNING: '\u2026',\n /** \u9700\u8981\u6CE8\u610F\u540E\u7F00 */\n SUFFIX_ATTENTION: '!',\n\n // ============================================================================\n // \u7ED3\u6784\u7B26\u53F7 (Structure Symbols)\n // \u7528\u4E8E\u5D4C\u5957\u5C42\u7EA7\u548C\u6811\u5F62\u7ED3\u6784\u663E\u793A\n // ============================================================================\n\n /** \u5B50\u9879\u8F93\u51FA\u8FDE\u63A5\u7B26 */\n CHILD_OUTPUT: '\u23BF',\n /** \u6811\u5F62\u4E2D\u95F4\u5206\u652F */\n TREE_BRANCH: '\u251C\u2500',\n /** \u6811\u5F62\u6700\u540E\u5206\u652F */\n TREE_LAST: '\u2514\u2500',\n /** \u6811\u5F62\u5782\u76F4\u7EBF */\n TREE_VERTICAL: '\u2502',\n /** \u6811\u5F62\u7A7A\u767D\u5BF9\u9F50 */\n TREE_SPACE: ' ',\n\n // ============================================================================\n // \u517C\u5BB9\u6027\u4FDD\u7559 (Legacy Compatibility)\n // \u4FDD\u7559\u65E7\u7B26\u53F7\u540D\u79F0\u4EE5\u517C\u5BB9\u73B0\u6709\u4EE3\u7801\n // ============================================================================\n\n /** @deprecated \u4F7F\u7528 TODO_UPDATE \u66FF\u4EE3 */\n TASK_INDICATOR: '\u23FA',\n /** @deprecated \u4F7F\u7528 CHILD_OUTPUT \u66FF\u4EE3 */\n TASK_BRANCH: '\u23BF',\n\n // TODO \u76F8\u5173\u7B26\u53F7 - Claude Code \u98CE\u683C\n /** \u5F85\u529E\u4E8B\u9879\uFF08pending/in_progress\uFF09 */\n TODO_UNCHECKED: '\u2610',\n /** \u5DF2\u5B8C\u6210\u4E8B\u9879 */\n TODO_CHECKED: '\u2612',\n\n // \u901A\u7528\u72B6\u6001\u7B26\u53F7\n /** \u6210\u529F */\n SUCCESS: '\u2714',\n /** \u9519\u8BEF */\n ERROR: '\u2716',\n /** \u4FE1\u606F */\n INFO: '\u2139',\n /** \u8B66\u544A */\n WARNING: '\u26A0',\n\n // \u52A0\u8F7D\u52A8\u753B\u5E27\uFF08spinner\uFF09\n LOADING_FRAMES: ['\u280B', '\u2819', '\u2839', '\u2838', '\u283C', '\u2834', '\u2826', '\u2827', '\u2807', '\u280F'],\n\n // Claude Code \u98CE\u683C\u7684\u601D\u8003\u52A8\u753B\u5E27\uFF086\u5E27\u5FAA\u73AF\uFF09\n THINKING_FRAMES: ['\u00B7', '\u2722', '\u273B', '\u2736', '\u2733', '\u273D'],\n\n // \u7701\u7565\u7B26\u53F7\n ELLIPSIS: '\u2026',\n\n // \u70B9\u7B26\u53F7\uFF08\u7528\u4E8E\u5143\u4FE1\u606F\u5206\u9694\uFF09\n DOT: '\u00B7',\n\n // \u5143\u4FE1\u606F\u5206\u9694\u7B26\uFF08\u7A7A\u683C+\u70B9+\u7A7A\u683C\uFF09\n META_SEPARATOR: ' \u00B7 ',\n} as const\n\n/**\n * \u5DE5\u5177\u72B6\u6001\u7C7B\u578B\n */\nexport type ToolStatus = 'running' | 'success' | 'error'\n\n/**\n * \u83B7\u53D6\u5DE5\u5177\u72B6\u6001\u5BF9\u5E94\u7684\u7B26\u53F7\n */\nexport function getToolStatusSymbol(status: ToolStatus): string {\n switch (status) {\n case 'running':\n return SYMBOLS.TOOL_RUNNING\n case 'success':\n return SYMBOLS.TOOL_SUCCESS\n case 'error':\n return SYMBOLS.TOOL_ERROR\n }\n}\n\n/**\n * \u83B7\u53D6\u72B6\u6001\u5BF9\u5E94\u7684\u7B26\u53F7\n */\nexport function getStatusSymbol(\n status: 'queued' | 'running' | 'completed' | 'error',\n): string {\n switch (status) {\n case 'queued':\n return SYMBOLS.INFO\n case 'running':\n return SYMBOLS.LOADING_FRAMES[0]\n case 'completed':\n return SYMBOLS.SUCCESS\n case 'error':\n return SYMBOLS.ERROR\n }\n}\n\n/**\n * \u83B7\u53D6 TODO \u72B6\u6001\u5BF9\u5E94\u7684\u7B26\u53F7 - Claude Code \u98CE\u683C\n */\nexport function getTodoStatusSymbol(\n status: 'pending' | 'in_progress' | 'completed',\n): string {\n // Claude Code \u53EA\u533A\u5206\u5DF2\u5B8C\u6210\u548C\u672A\u5B8C\u6210\n return status === 'completed' ? SYMBOLS.TODO_CHECKED : SYMBOLS.TODO_UNCHECKED\n}\n"],
5
+ "mappings": "AASO,MAAM,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOrB,QAAQ;AAAA;AAAA,EAER,cAAc;AAAA;AAAA,EAEd,cAAc;AAAA;AAAA,EAEd,YAAY;AAAA;AAAA,EAEZ,aAAa;AAAA;AAAA,EAEb,gBAAgB;AAAA;AAAA,EAEhB,UAAU;AAAA;AAAA,EAEV,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQd,gBAAgB;AAAA;AAAA,EAEhB,kBAAkB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQlB,cAAc;AAAA;AAAA,EAEd,aAAa;AAAA;AAAA,EAEb,WAAW;AAAA;AAAA,EAEX,eAAe;AAAA;AAAA,EAEf,YAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQZ,gBAAgB;AAAA;AAAA,EAEhB,aAAa;AAAA;AAAA;AAAA,EAIb,gBAAgB;AAAA;AAAA,EAEhB,cAAc;AAAA;AAAA;AAAA,EAId,SAAS;AAAA;AAAA,EAET,OAAO;AAAA;AAAA,EAEP,MAAM;AAAA;AAAA,EAEN,SAAS;AAAA;AAAA,EAGT,gBAAgB,CAAC,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,UAAK,QAAG;AAAA;AAAA,EAGjE,iBAAiB,CAAC,QAAK,UAAK,UAAK,UAAK,UAAK,QAAG;AAAA;AAAA,EAG9C,UAAU;AAAA;AAAA,EAGV,KAAK;AAAA;AAAA,EAGL,gBAAgB;AAClB;AAUO,SAAS,oBAAoB,QAA4B;AAC9D,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ;AAAA,EACnB;AACF;AAKO,SAAS,gBACd,QACQ;AACR,UAAQ,QAAQ;AAAA,IACd,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ,eAAe,CAAC;AAAA,IACjC,KAAK;AACH,aAAO,QAAQ;AAAA,IACjB,KAAK;AACH,aAAO,QAAQ;AAAA,EACnB;AACF;AAKO,SAAS,oBACd,QACQ;AAER,SAAO,WAAW,cAAc,QAAQ,eAAe,QAAQ;AACjE;",
6
6
  "names": []
7
7
  }
@@ -5,6 +5,11 @@ const TIMING = {
5
5
  SHUTDOWN_TIMEOUT_MS: 3e3,
6
6
  CONTEXT_FETCH_TIMEOUT_MS: 3e3,
7
7
  ENV_CHECK_TIMEOUT_MS: 1e3,
8
+ // MCP tool timeouts
9
+ MCP_TOOL_TIMEOUT_MS: 12e4,
10
+ // 2 minutes for MCP tool calls (some searches take time)
11
+ MCP_TOOL_MAX_RETRIES: 2,
12
+ // Retry failed MCP calls up to 2 times
8
13
  // Retry configuration
9
14
  BASE_DELAY_MS: 500,
10
15
  MAX_RETRIES: 3,
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/constants/timing.ts"],
4
- "sourcesContent": ["/**\n * Centralized timing constants for consistent timeout and delay values.\n * Consolidates magic numbers scattered across the codebase.\n */\n\nexport const TIMING = {\n // Network and API timeouts\n CONNECTION_TIMEOUT_MS: 5000,\n HTTP_TIMEOUT_MS: 30000,\n SHUTDOWN_TIMEOUT_MS: 3000,\n CONTEXT_FETCH_TIMEOUT_MS: 3000,\n ENV_CHECK_TIMEOUT_MS: 1000,\n\n // Retry configuration\n BASE_DELAY_MS: 500,\n MAX_RETRIES: 3,\n MAX_DELAY_MS: 32000,\n MAX_SERVER_DELAY_MS: 60000,\n\n // UI notification timeouts\n NOTIFICATION_SHORT_MS: 1000,\n NOTIFICATION_MEDIUM_MS: 2000,\n NOTIFICATION_LONG_MS: 3000,\n NOTIFICATION_VERY_LONG_MS: 5000,\n NOTIFICATION_THRESHOLD_MS: 6000,\n\n // User interaction\n DOUBLE_PRESS_TIMEOUT_MS: 1000,\n HOTKEY_MESSAGE_TIMEOUT_MS: 2000,\n\n // Background operations\n BACKGROUND_POLL_INTERVAL_MS: 1000,\n API_TEST_DELAY_MS: 1000,\n\n // Debug and logging\n LOG_DEDUPE_WINDOW_MS: 5000,\n\n // Cleanup and maintenance\n THIRTY_DAYS_MS: 30 * 24 * 60 * 60 * 1000,\n FILE_TOLERANCE_MS: 100,\n} as const\n\nexport type TimingKey = keyof typeof TIMING\n"],
5
- "mappings": "AAKO,MAAM,SAAS;AAAA;AAAA,EAEpB,uBAAuB;AAAA,EACvB,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,0BAA0B;AAAA,EAC1B,sBAAsB;AAAA;AAAA,EAGtB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAAA,EACd,qBAAqB;AAAA;AAAA,EAGrB,uBAAuB;AAAA,EACvB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA,EAC3B,2BAA2B;AAAA;AAAA,EAG3B,yBAAyB;AAAA,EACzB,2BAA2B;AAAA;AAAA,EAG3B,6BAA6B;AAAA,EAC7B,mBAAmB;AAAA;AAAA,EAGnB,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB,KAAK,KAAK,KAAK,KAAK;AAAA,EACpC,mBAAmB;AACrB;",
4
+ "sourcesContent": ["/**\n * Centralized timing constants for consistent timeout and delay values.\n * Consolidates magic numbers scattered across the codebase.\n */\n\nexport const TIMING = {\n // Network and API timeouts\n CONNECTION_TIMEOUT_MS: 5000,\n HTTP_TIMEOUT_MS: 30000,\n SHUTDOWN_TIMEOUT_MS: 3000,\n CONTEXT_FETCH_TIMEOUT_MS: 3000,\n ENV_CHECK_TIMEOUT_MS: 1000,\n\n // MCP tool timeouts\n MCP_TOOL_TIMEOUT_MS: 120000, // 2 minutes for MCP tool calls (some searches take time)\n MCP_TOOL_MAX_RETRIES: 2, // Retry failed MCP calls up to 2 times\n\n // Retry configuration\n BASE_DELAY_MS: 500,\n MAX_RETRIES: 3,\n MAX_DELAY_MS: 32000,\n MAX_SERVER_DELAY_MS: 60000,\n\n // UI notification timeouts\n NOTIFICATION_SHORT_MS: 1000,\n NOTIFICATION_MEDIUM_MS: 2000,\n NOTIFICATION_LONG_MS: 3000,\n NOTIFICATION_VERY_LONG_MS: 5000,\n NOTIFICATION_THRESHOLD_MS: 6000,\n\n // User interaction\n DOUBLE_PRESS_TIMEOUT_MS: 1000,\n HOTKEY_MESSAGE_TIMEOUT_MS: 2000,\n\n // Background operations\n BACKGROUND_POLL_INTERVAL_MS: 1000,\n API_TEST_DELAY_MS: 1000,\n\n // Debug and logging\n LOG_DEDUPE_WINDOW_MS: 5000,\n\n // Cleanup and maintenance\n THIRTY_DAYS_MS: 30 * 24 * 60 * 60 * 1000,\n FILE_TOLERANCE_MS: 100,\n} as const\n\nexport type TimingKey = keyof typeof TIMING\n"],
5
+ "mappings": "AAKO,MAAM,SAAS;AAAA;AAAA,EAEpB,uBAAuB;AAAA,EACvB,iBAAiB;AAAA,EACjB,qBAAqB;AAAA,EACrB,0BAA0B;AAAA,EAC1B,sBAAsB;AAAA;AAAA,EAGtB,qBAAqB;AAAA;AAAA,EACrB,sBAAsB;AAAA;AAAA;AAAA,EAGtB,eAAe;AAAA,EACf,aAAa;AAAA,EACb,cAAc;AAAA,EACd,qBAAqB;AAAA;AAAA,EAGrB,uBAAuB;AAAA,EACvB,wBAAwB;AAAA,EACxB,sBAAsB;AAAA,EACtB,2BAA2B;AAAA,EAC3B,2BAA2B;AAAA;AAAA,EAG3B,yBAAyB;AAAA,EACzB,2BAA2B;AAAA;AAAA,EAG3B,6BAA6B;AAAA,EAC7B,mBAAmB;AAAA;AAAA,EAGnB,sBAAsB;AAAA;AAAA,EAGtB,gBAAgB,KAAK,KAAK,KAAK,KAAK;AAAA,EACpC,mBAAmB;AACrB;",
6
6
  "names": []
7
7
  }
@@ -0,0 +1,84 @@
1
+ const TOOL_INPUT_EXAMPLES = {
2
+ // File Operations
3
+ Read: '{"file_path": "/path/to/file.txt"}',
4
+ Write: '{"file_path": "/path/to/file.txt", "content": "file contents"}',
5
+ Edit: '{"file_path": "/path/to/file.txt", "old_string": "old text", "new_string": "new text"}',
6
+ MultiEdit: '{"file_path": "/path/to/file.txt", "edits": [{"old_string": "old", "new_string": "new"}]}',
7
+ NotebookEdit: '{"notebook_path": "/path/to/notebook.ipynb", "new_source": "cell source code"}',
8
+ NotebookRead: '{"notebook_path": "/path/to/notebook.ipynb"}',
9
+ // Directory and Search
10
+ Glob: '{"pattern": "**/*.ts", "path": "/optional/search/path"}',
11
+ Grep: '{"pattern": "search_term", "path": "/optional/search/path", "glob": "*.ts"}',
12
+ Ls: '{"path": "/path/to/directory"}',
13
+ // Shell Execution
14
+ Bash: '{"command": "ls -la"}',
15
+ BashOutput: '{"command": "ls -la", "shell_id": "optional_shell_id"}',
16
+ KillShell: '{"shell_id": "shell_id_to_kill"}',
17
+ // Task Management
18
+ Task: '{"prompt": "task description", "description": "short description", "subagent_type": "agent-type"}',
19
+ TodoWrite: '{"todos": [{"subject": "Task name", "description": "Details", "status": "pending"}]}',
20
+ // Web and API
21
+ WebSearch: '{"query": "search query"}',
22
+ URLFetcher: '{"url": "https://example.com", "prompt": "what to extract from page"}',
23
+ // LLM Interactions
24
+ AskExpertModel: '{"model": "model-name", "prompt": "question for expert", "context": "optional context"}',
25
+ AskUserQuestion: '{"question": "question to ask user", "default": "optional default"}',
26
+ // Memory (Anthropic-only)
27
+ MemoryRead: '{"name": "memory_block_name"}',
28
+ MemoryWrite: '{"name": "memory_block_name", "content": "memory content"}',
29
+ // Planning and Reasoning
30
+ Think: '{"reasoning": "your thinking process", "plan": "optional plan"}',
31
+ EnterPlanMode: "{}",
32
+ ExitPlanMode: "{}",
33
+ // Code Intelligence
34
+ Lsp: '{"method": "textDocument/definition", "params": {"position": {"line": 10, "character": 5}}}',
35
+ Skill: '{"skill": "skill_name", "args": "optional arguments"}',
36
+ // MCP Resources
37
+ ListMcpResources: '{"server": "server_name", "uri": "optional_resource_uri", "include": "resource_type"}',
38
+ ReadMcpResource: '{"uri": "resource://path"}'
39
+ };
40
+ const TOOL_DESCRIPTIONS = {
41
+ MultiEdit: 'Allows multiple edits in a single file. The "edits" parameter is an array of edit objects.',
42
+ NotebookEdit: "For Jupyter notebooks. Requires notebook_path and new_source for the cell content.",
43
+ Grep: 'Searches file contents with regex. Optional "glob" parameter filters files by pattern.',
44
+ Task: "Creates a task for an AI agent. subagent_type determines which agent handles the task.",
45
+ URLFetcher: 'Fetches web content. The "prompt" parameter guides what to extract from the page.',
46
+ AskExpertModel: "Queries an alternative LLM model. Useful for specialized tasks requiring different models.",
47
+ Lsp: "Language Server Protocol queries for code intelligence. Method and params depend on LSP spec."
48
+ };
49
+ const PARAMETER_DESCRIPTIONS = {
50
+ Read: {
51
+ file_path: "Must be an absolute file path (e.g., /home/user/file.txt)",
52
+ offset: "Optional line number to start reading from (0-indexed)",
53
+ limit: "Optional number of lines to read from the offset"
54
+ },
55
+ Write: {
56
+ file_path: "Must be an absolute file path (e.g., /home/user/file.txt)",
57
+ content: "The file contents to write"
58
+ },
59
+ Edit: {
60
+ file_path: "Must be an absolute file path (e.g., /home/user/file.txt)",
61
+ old_string: "The exact text to find and replace (must match exactly)",
62
+ new_string: "The text to replace it with"
63
+ },
64
+ Bash: {
65
+ command: "The shell command to execute (will run in current working directory)",
66
+ timeout: "Maximum execution time in milliseconds (max 600000 = 10 minutes)",
67
+ run_in_background: "Set to true to run command without waiting for completion"
68
+ },
69
+ Glob: {
70
+ pattern: "Glob pattern like **/*.ts or src/**/*.{ts,tsx}",
71
+ path: "Directory to search in (optional, defaults to current directory)"
72
+ },
73
+ Grep: {
74
+ pattern: "Regular expression pattern to search for",
75
+ path: "Directory to search in (optional, defaults to current directory)",
76
+ glob: "Additional glob pattern to filter files being searched"
77
+ }
78
+ };
79
+ export {
80
+ PARAMETER_DESCRIPTIONS,
81
+ TOOL_DESCRIPTIONS,
82
+ TOOL_INPUT_EXAMPLES
83
+ };
84
+ //# sourceMappingURL=toolInputExamples.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/constants/toolInputExamples.ts"],
4
+ "sourcesContent": ["/**\n * Tool Input Examples and Descriptions\n *\n * Provides user-friendly examples and descriptions for all tools to help with\n * error messaging when tool input validation fails. Each entry includes:\n * - A canonical example showing required parameters\n * - Optional description for complex tools\n */\n\nexport const TOOL_INPUT_EXAMPLES: Record<string, string> = {\n // File Operations\n Read: '{\"file_path\": \"/path/to/file.txt\"}',\n Write: '{\"file_path\": \"/path/to/file.txt\", \"content\": \"file contents\"}',\n Edit: '{\"file_path\": \"/path/to/file.txt\", \"old_string\": \"old text\", \"new_string\": \"new text\"}',\n MultiEdit:\n '{\"file_path\": \"/path/to/file.txt\", \"edits\": [{\"old_string\": \"old\", \"new_string\": \"new\"}]}',\n NotebookEdit:\n '{\"notebook_path\": \"/path/to/notebook.ipynb\", \"new_source\": \"cell source code\"}',\n NotebookRead: '{\"notebook_path\": \"/path/to/notebook.ipynb\"}',\n\n // Directory and Search\n Glob: '{\"pattern\": \"**/*.ts\", \"path\": \"/optional/search/path\"}',\n Grep: '{\"pattern\": \"search_term\", \"path\": \"/optional/search/path\", \"glob\": \"*.ts\"}',\n Ls: '{\"path\": \"/path/to/directory\"}',\n\n // Shell Execution\n Bash: '{\"command\": \"ls -la\"}',\n BashOutput: '{\"command\": \"ls -la\", \"shell_id\": \"optional_shell_id\"}',\n KillShell: '{\"shell_id\": \"shell_id_to_kill\"}',\n\n // Task Management\n Task: '{\"prompt\": \"task description\", \"description\": \"short description\", \"subagent_type\": \"agent-type\"}',\n TodoWrite:\n '{\"todos\": [{\"subject\": \"Task name\", \"description\": \"Details\", \"status\": \"pending\"}]}',\n\n // Web and API\n WebSearch: '{\"query\": \"search query\"}',\n URLFetcher:\n '{\"url\": \"https://example.com\", \"prompt\": \"what to extract from page\"}',\n\n // LLM Interactions\n AskExpertModel:\n '{\"model\": \"model-name\", \"prompt\": \"question for expert\", \"context\": \"optional context\"}',\n AskUserQuestion:\n '{\"question\": \"question to ask user\", \"default\": \"optional default\"}',\n\n // Memory (Anthropic-only)\n MemoryRead: '{\"name\": \"memory_block_name\"}',\n MemoryWrite: '{\"name\": \"memory_block_name\", \"content\": \"memory content\"}',\n\n // Planning and Reasoning\n Think: '{\"reasoning\": \"your thinking process\", \"plan\": \"optional plan\"}',\n EnterPlanMode: '{}',\n ExitPlanMode: '{}',\n\n // Code Intelligence\n Lsp: '{\"method\": \"textDocument/definition\", \"params\": {\"position\": {\"line\": 10, \"character\": 5}}}',\n Skill: '{\"skill\": \"skill_name\", \"args\": \"optional arguments\"}',\n\n // MCP Resources\n ListMcpResources:\n '{\"server\": \"server_name\", \"uri\": \"optional_resource_uri\", \"include\": \"resource_type\"}',\n ReadMcpResource: '{\"uri\": \"resource://path\"}',\n}\n\n/**\n * Tool Input Descriptions\n *\n * Provides helpful descriptions for complex tools to include in error messages\n */\nexport const TOOL_DESCRIPTIONS: Record<string, string> = {\n MultiEdit:\n 'Allows multiple edits in a single file. The \"edits\" parameter is an array of edit objects.',\n NotebookEdit:\n 'For Jupyter notebooks. Requires notebook_path and new_source for the cell content.',\n Grep: 'Searches file contents with regex. Optional \"glob\" parameter filters files by pattern.',\n Task: 'Creates a task for an AI agent. subagent_type determines which agent handles the task.',\n URLFetcher:\n 'Fetches web content. The \"prompt\" parameter guides what to extract from the page.',\n AskExpertModel:\n 'Queries an alternative LLM model. Useful for specialized tasks requiring different models.',\n Lsp: 'Language Server Protocol queries for code intelligence. Method and params depend on LSP spec.',\n}\n\n/**\n * Parameter Descriptions for Common Tool Parameters\n *\n * Helps provide more specific error messages when particular parameters are invalid\n */\nexport const PARAMETER_DESCRIPTIONS: Record<string, Record<string, string>> = {\n Read: {\n file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n offset: 'Optional line number to start reading from (0-indexed)',\n limit: 'Optional number of lines to read from the offset',\n },\n Write: {\n file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n content: 'The file contents to write',\n },\n Edit: {\n file_path: 'Must be an absolute file path (e.g., /home/user/file.txt)',\n old_string: 'The exact text to find and replace (must match exactly)',\n new_string: 'The text to replace it with',\n },\n Bash: {\n command:\n 'The shell command to execute (will run in current working directory)',\n timeout: 'Maximum execution time in milliseconds (max 600000 = 10 minutes)',\n run_in_background:\n 'Set to true to run command without waiting for completion',\n },\n Glob: {\n pattern: 'Glob pattern like **/*.ts or src/**/*.{ts,tsx}',\n path: 'Directory to search in (optional, defaults to current directory)',\n },\n Grep: {\n pattern: 'Regular expression pattern to search for',\n path: 'Directory to search in (optional, defaults to current directory)',\n glob: 'Additional glob pattern to filter files being searched',\n },\n}\n"],
5
+ "mappings": "AASO,MAAM,sBAA8C;AAAA;AAAA,EAEzD,MAAM;AAAA,EACN,OAAO;AAAA,EACP,MAAM;AAAA,EACN,WACE;AAAA,EACF,cACE;AAAA,EACF,cAAc;AAAA;AAAA,EAGd,MAAM;AAAA,EACN,MAAM;AAAA,EACN,IAAI;AAAA;AAAA,EAGJ,MAAM;AAAA,EACN,YAAY;AAAA,EACZ,WAAW;AAAA;AAAA,EAGX,MAAM;AAAA,EACN,WACE;AAAA;AAAA,EAGF,WAAW;AAAA,EACX,YACE;AAAA;AAAA,EAGF,gBACE;AAAA,EACF,iBACE;AAAA;AAAA,EAGF,YAAY;AAAA,EACZ,aAAa;AAAA;AAAA,EAGb,OAAO;AAAA,EACP,eAAe;AAAA,EACf,cAAc;AAAA;AAAA,EAGd,KAAK;AAAA,EACL,OAAO;AAAA;AAAA,EAGP,kBACE;AAAA,EACF,iBAAiB;AACnB;AAOO,MAAM,oBAA4C;AAAA,EACvD,WACE;AAAA,EACF,cACE;AAAA,EACF,MAAM;AAAA,EACN,MAAM;AAAA,EACN,YACE;AAAA,EACF,gBACE;AAAA,EACF,KAAK;AACP;AAOO,MAAM,yBAAiE;AAAA,EAC5E,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,QAAQ;AAAA,IACR,OAAO;AAAA,EACT;AAAA,EACA,OAAO;AAAA,IACL,WAAW;AAAA,IACX,SAAS;AAAA,EACX;AAAA,EACA,MAAM;AAAA,IACJ,WAAW;AAAA,IACX,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AAAA,EACA,MAAM;AAAA,IACJ,SACE;AAAA,IACF,SAAS;AAAA,IACT,mBACE;AAAA,EACJ;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,EACR;AAAA,EACA,MAAM;AAAA,IACJ,SAAS;AAAA,IACT,MAAM;AAAA,IACN,MAAM;AAAA,EACR;AACF;",
6
+ "names": []
7
+ }
@@ -0,0 +1,321 @@
1
+ import { createHash } from "crypto";
2
+ import { promises as fs } from "fs";
3
+ import { join, dirname } from "path";
4
+ import { homedir } from "os";
5
+ import { CONFIG_BASE_DIR } from "../constants/product.js";
6
+ import {
7
+ existsAsync,
8
+ mkdirAsync,
9
+ readJsonAsync,
10
+ writeJsonAsync,
11
+ readdirAsync,
12
+ unlinkAsync
13
+ } from "../utils/asyncFile.js";
14
+ const MAX_VERSIONS_PER_FILE = 10;
15
+ function getMintoBaseDir() {
16
+ return process.env.MINTO_CONFIG_DIR ?? process.env.CLAUDE_CONFIG_DIR ?? join(homedir(), CONFIG_BASE_DIR);
17
+ }
18
+ function getBackupsDir() {
19
+ return join(getMintoBaseDir(), "backups");
20
+ }
21
+ const BACKUPS_DIR = join(getMintoBaseDir(), "backups");
22
+ const INDEX_FILE = "index.json";
23
+ function getPathHash(filePath) {
24
+ const hash = createHash("sha256").update(filePath).digest("hex");
25
+ return hash.slice(0, 12);
26
+ }
27
+ function getBackupDir(filePath) {
28
+ const pathHash = getPathHash(filePath);
29
+ return join(getBackupsDir(), pathHash);
30
+ }
31
+ function getIndexPath(filePath) {
32
+ return join(getBackupDir(filePath), INDEX_FILE);
33
+ }
34
+ function getVersionPath(filePath, version) {
35
+ return join(getBackupDir(filePath), `v${version}.backup`);
36
+ }
37
+ function detectLineEndings(content) {
38
+ if (content.includes("\r\n")) {
39
+ return "CRLF";
40
+ }
41
+ return "LF";
42
+ }
43
+ function detectEncoding(_content) {
44
+ return "utf8";
45
+ }
46
+ async function createBackup(filePath, oldContent, newContent, operation, description) {
47
+ try {
48
+ const backupDir = getBackupDir(filePath);
49
+ const indexPath = getIndexPath(filePath);
50
+ await mkdirAsync(backupDir, true);
51
+ let index;
52
+ if (await existsAsync(indexPath)) {
53
+ const loaded = await readJsonAsync(indexPath);
54
+ if (loaded) {
55
+ index = loaded;
56
+ } else {
57
+ index = {
58
+ filePath,
59
+ pathHash: getPathHash(filePath),
60
+ createdAt: Date.now(),
61
+ versions: []
62
+ };
63
+ }
64
+ } else {
65
+ index = {
66
+ filePath,
67
+ pathHash: getPathHash(filePath),
68
+ createdAt: Date.now(),
69
+ versions: []
70
+ };
71
+ }
72
+ const contentToBackup = operation === "create" ? null : oldContent;
73
+ const maxVersion = index.versions.length > 0 ? Math.max(...index.versions.map((v) => v.version)) : 0;
74
+ const newVersion = maxVersion + 1;
75
+ const metadata = {
76
+ version: newVersion,
77
+ timestamp: Date.now(),
78
+ operation,
79
+ encoding: contentToBackup ? detectEncoding(contentToBackup) : "utf8",
80
+ lineEndings: contentToBackup ? detectLineEndings(contentToBackup) : "LF",
81
+ size: contentToBackup ? Buffer.byteLength(contentToBackup, "utf8") : 0,
82
+ description
83
+ };
84
+ if (contentToBackup !== null) {
85
+ const versionPath = getVersionPath(filePath, newVersion);
86
+ await fs.writeFile(versionPath, contentToBackup, {
87
+ encoding: metadata.encoding
88
+ });
89
+ }
90
+ index.versions.push(metadata);
91
+ if (index.versions.length > MAX_VERSIONS_PER_FILE) {
92
+ await cleanupOldVersions(filePath, index);
93
+ }
94
+ await writeJsonAsync(indexPath, index);
95
+ return metadata;
96
+ } catch (error) {
97
+ console.error(
98
+ `[BackupManager] Failed to create backup for ${filePath}:`,
99
+ error
100
+ );
101
+ return null;
102
+ }
103
+ }
104
+ async function cleanupOldVersions(filePath, index) {
105
+ index.versions.sort((a, b) => a.version - b.version);
106
+ const toRemove = index.versions.length - MAX_VERSIONS_PER_FILE;
107
+ if (toRemove <= 0) return;
108
+ const versionsToDelete = index.versions.splice(0, toRemove);
109
+ for (const version of versionsToDelete) {
110
+ const versionPath = getVersionPath(filePath, version.version);
111
+ await unlinkAsync(versionPath);
112
+ }
113
+ }
114
+ async function listBackedUpFiles() {
115
+ try {
116
+ const backupsDir = getBackupsDir();
117
+ if (!await existsAsync(backupsDir)) {
118
+ return [];
119
+ }
120
+ const entries = await readdirAsync(backupsDir);
121
+ const summaries = [];
122
+ for (const entry of entries) {
123
+ const indexPath = join(backupsDir, entry, INDEX_FILE);
124
+ if (await existsAsync(indexPath)) {
125
+ const index = await readJsonAsync(indexPath);
126
+ if (index && index.versions.length > 0) {
127
+ const sortedVersions = [...index.versions].sort(
128
+ (a, b) => b.timestamp - a.timestamp
129
+ );
130
+ const mostRecent = sortedVersions[0];
131
+ summaries.push({
132
+ filePath: index.filePath,
133
+ pathHash: index.pathHash,
134
+ versionCount: index.versions.length,
135
+ lastBackupAt: mostRecent.timestamp,
136
+ lastOperation: mostRecent.operation
137
+ });
138
+ }
139
+ }
140
+ }
141
+ summaries.sort((a, b) => b.lastBackupAt - a.lastBackupAt);
142
+ return summaries;
143
+ } catch (error) {
144
+ console.error("[BackupManager] Failed to list backed up files:", error);
145
+ return [];
146
+ }
147
+ }
148
+ async function getBackupVersions(filePath) {
149
+ try {
150
+ const indexPath = getIndexPath(filePath);
151
+ if (!await existsAsync(indexPath)) {
152
+ return [];
153
+ }
154
+ const index = await readJsonAsync(indexPath);
155
+ if (!index) {
156
+ return [];
157
+ }
158
+ return [...index.versions].sort((a, b) => b.version - a.version);
159
+ } catch (error) {
160
+ console.error(
161
+ `[BackupManager] Failed to get versions for ${filePath}:`,
162
+ error
163
+ );
164
+ return [];
165
+ }
166
+ }
167
+ async function getBackupContent(filePath, version) {
168
+ try {
169
+ const indexPath = getIndexPath(filePath);
170
+ if (!await existsAsync(indexPath)) {
171
+ return null;
172
+ }
173
+ const index = await readJsonAsync(indexPath);
174
+ if (!index) {
175
+ return null;
176
+ }
177
+ const versionMeta = index.versions.find((v) => v.version === version);
178
+ if (!versionMeta) {
179
+ return null;
180
+ }
181
+ if (versionMeta.operation === "create" && versionMeta.size === 0) {
182
+ return null;
183
+ }
184
+ const versionPath = getVersionPath(filePath, version);
185
+ if (!await existsAsync(versionPath)) {
186
+ return null;
187
+ }
188
+ const content = await fs.readFile(versionPath, {
189
+ encoding: versionMeta.encoding
190
+ });
191
+ return content;
192
+ } catch (error) {
193
+ console.error(
194
+ `[BackupManager] Failed to get backup content for ${filePath} v${version}:`,
195
+ error
196
+ );
197
+ return null;
198
+ }
199
+ }
200
+ async function restoreBackup(filePath, version) {
201
+ try {
202
+ const content = await getBackupContent(filePath, version);
203
+ const indexPath = getIndexPath(filePath);
204
+ const index = await readJsonAsync(indexPath);
205
+ if (!index) {
206
+ console.error(`[BackupManager] No backup index found for ${filePath}`);
207
+ return false;
208
+ }
209
+ const versionMeta = index.versions.find((v) => v.version === version);
210
+ if (!versionMeta) {
211
+ console.error(
212
+ `[BackupManager] Version ${version} not found for ${filePath}`
213
+ );
214
+ return false;
215
+ }
216
+ if (versionMeta.operation === "create" && content === null) {
217
+ await fs.unlink(filePath);
218
+ return true;
219
+ }
220
+ if (content === null) {
221
+ console.error(
222
+ `[BackupManager] No content found for ${filePath} v${version}`
223
+ );
224
+ return false;
225
+ }
226
+ let currentContent = null;
227
+ try {
228
+ currentContent = await fs.readFile(filePath, "utf8");
229
+ } catch {
230
+ }
231
+ if (currentContent !== null) {
232
+ await createBackup(
233
+ filePath,
234
+ currentContent,
235
+ content,
236
+ "update",
237
+ `Restored from version ${version}`
238
+ );
239
+ }
240
+ const parentDir = dirname(filePath);
241
+ await mkdirAsync(parentDir, true);
242
+ await fs.writeFile(filePath, content, {
243
+ encoding: versionMeta.encoding
244
+ });
245
+ return true;
246
+ } catch (error) {
247
+ console.error(
248
+ `[BackupManager] Failed to restore ${filePath} to v${version}:`,
249
+ error
250
+ );
251
+ return false;
252
+ }
253
+ }
254
+ async function getBackupIndex(filePath) {
255
+ const indexPath = getIndexPath(filePath);
256
+ return await readJsonAsync(indexPath);
257
+ }
258
+ async function deleteAllBackups(filePath) {
259
+ try {
260
+ const backupDir = getBackupDir(filePath);
261
+ if (!await existsAsync(backupDir)) {
262
+ return true;
263
+ }
264
+ const entries = await readdirAsync(backupDir);
265
+ for (const entry of entries) {
266
+ await unlinkAsync(join(backupDir, entry));
267
+ }
268
+ await fs.rmdir(backupDir);
269
+ return true;
270
+ } catch (error) {
271
+ console.error(
272
+ `[BackupManager] Failed to delete backups for ${filePath}:`,
273
+ error
274
+ );
275
+ return false;
276
+ }
277
+ }
278
+ async function getBackupStorageUsage() {
279
+ try {
280
+ const backupsDir = getBackupsDir();
281
+ if (!await existsAsync(backupsDir)) {
282
+ return { totalBytes: 0, fileCount: 0, versionCount: 0 };
283
+ }
284
+ let totalBytes = 0;
285
+ let fileCount = 0;
286
+ let versionCount = 0;
287
+ const entries = await readdirAsync(backupsDir);
288
+ for (const entry of entries) {
289
+ const indexPath = join(backupsDir, entry, INDEX_FILE);
290
+ const index = await readJsonAsync(indexPath);
291
+ if (index) {
292
+ fileCount++;
293
+ versionCount += index.versions.length;
294
+ for (const version of index.versions) {
295
+ totalBytes += version.size;
296
+ }
297
+ }
298
+ }
299
+ return { totalBytes, fileCount, versionCount };
300
+ } catch (error) {
301
+ console.error("[BackupManager] Failed to get storage usage:", error);
302
+ return { totalBytes: 0, fileCount: 0, versionCount: 0 };
303
+ }
304
+ }
305
+ export {
306
+ BACKUPS_DIR,
307
+ MAX_VERSIONS_PER_FILE,
308
+ createBackup,
309
+ deleteAllBackups,
310
+ detectEncoding,
311
+ detectLineEndings,
312
+ getBackupContent,
313
+ getBackupIndex,
314
+ getBackupStorageUsage,
315
+ getBackupVersions,
316
+ getBackupsDir,
317
+ getPathHash,
318
+ listBackedUpFiles,
319
+ restoreBackup
320
+ };
321
+ //# sourceMappingURL=backupManager.js.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../src/core/backupManager.ts"],
4
+ "sourcesContent": ["/**\n * Backup Manager\n *\n * Provides automatic file backup functionality for Minto.\n * Stores file backups in ~/.minto/backups/ with path-hashed directory names.\n * Keeps up to 10 versions per file using LRU eviction.\n *\n * Features:\n * - Automatic backup creation before file operations\n * - Version history with metadata\n * - Easy restoration to any previous version\n * - Encoding and line ending detection\n * - LRU-based cleanup for old versions\n */\n\nimport { createHash } from 'crypto'\nimport { promises as fs } from 'fs'\nimport { join, dirname } from 'path'\nimport { homedir } from 'os'\nimport { CONFIG_BASE_DIR } from '@constants/product'\nimport {\n existsAsync,\n mkdirAsync,\n readJsonAsync,\n writeJsonAsync,\n readdirAsync,\n unlinkAsync,\n} from '../utils/asyncFile'\n\n// ============================================================================\n// Constants\n// ============================================================================\n\n/** Maximum number of versions to keep per file */\nexport const MAX_VERSIONS_PER_FILE = 10\n\n/**\n * Get the base directory for Minto data files\n * Computed dynamically to support test environment overrides\n */\nfunction getMintoBaseDir(): string {\n return (\n process.env.MINTO_CONFIG_DIR ??\n process.env.CLAUDE_CONFIG_DIR ??\n join(homedir(), CONFIG_BASE_DIR)\n )\n}\n\n/**\n * Get the backups directory path\n * Uses a getter function to support dynamic environment configuration\n */\nexport function getBackupsDir(): string {\n return join(getMintoBaseDir(), 'backups')\n}\n\n/** @deprecated Use getBackupsDir() instead - kept for backward compatibility */\nexport const BACKUPS_DIR = join(getMintoBaseDir(), 'backups')\n\n/** Index file name for each backup directory */\nconst INDEX_FILE = 'index.json'\n\n// ============================================================================\n// Types\n// ============================================================================\n\n/**\n * Operation types for backup metadata\n */\nexport type BackupOperation = 'create' | 'update' | 'delete'\n\n/**\n * Line ending types\n */\nexport type LineEnding = 'LF' | 'CRLF'\n\n/**\n * Metadata for a single backup version\n */\nexport interface BackupMetadata {\n /** Version number (1-based, auto-incremented) */\n version: number\n /** Timestamp when backup was created (Unix ms) */\n timestamp: number\n /** Type of operation that triggered the backup */\n operation: BackupOperation\n /** File encoding */\n encoding: BufferEncoding\n /** Line ending style */\n lineEndings: LineEnding\n /** File size in bytes */\n size: number\n /** Optional description of the change */\n description?: string\n}\n\n/**\n * File backup input for creating a new backup\n */\nexport interface FileBackup {\n /** Absolute path to the file */\n filePath: string\n /** Previous content (null for new files) */\n oldContent: string | null\n /** New content (null for deleted files) */\n newContent: string | null\n /** Backup metadata */\n metadata: BackupMetadata\n}\n\n/**\n * Index structure stored in each backup directory\n */\nexport interface BackupIndex {\n /** Original absolute file path */\n filePath: string\n /** SHA256 hash of the path (first 12 chars) */\n pathHash: string\n /** When this file was first backed up */\n createdAt: number\n /** List of backup versions (sorted by version number) */\n versions: BackupMetadata[]\n}\n\n/**\n * Summary of a backed-up file for listing\n */\nexport interface BackupFileSummary {\n /** Original file path */\n filePath: string\n /** Path hash (directory name) */\n pathHash: string\n /** Number of backup versions */\n versionCount: number\n /** Timestamp of most recent backup */\n lastBackupAt: number\n /** Most recent operation */\n lastOperation: BackupOperation\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Generate a path hash for directory naming\n * Uses first 12 characters of SHA256 hash\n */\nexport function getPathHash(filePath: string): string {\n const hash = createHash('sha256').update(filePath).digest('hex')\n return hash.slice(0, 12)\n}\n\n/**\n * Get the backup directory for a file\n */\nfunction getBackupDir(filePath: string): string {\n const pathHash = getPathHash(filePath)\n return join(getBackupsDir(), pathHash)\n}\n\n/**\n * Get the path to the index file for a file's backups\n */\nfunction getIndexPath(filePath: string): string {\n return join(getBackupDir(filePath), INDEX_FILE)\n}\n\n/**\n * Get the path to a specific backup version file\n */\nfunction getVersionPath(filePath: string, version: number): string {\n return join(getBackupDir(filePath), `v${version}.backup`)\n}\n\n/**\n * Detect line endings in content\n */\nexport function detectLineEndings(content: string): LineEnding {\n // Check for CRLF first (Windows)\n if (content.includes('\\r\\n')) {\n return 'CRLF'\n }\n return 'LF'\n}\n\n/**\n * Detect file encoding from content\n * Currently defaults to utf8, but can be extended for binary detection\n */\nexport function detectEncoding(_content: string): BufferEncoding {\n // For now, we assume utf8 for text files\n // Binary file detection would require buffer analysis\n return 'utf8'\n}\n\n// ============================================================================\n// Core Functions\n// ============================================================================\n\n/**\n * Create a backup before file operations\n *\n * @param filePath - Absolute path to the file being modified\n * @param oldContent - Previous content (null for new files)\n * @param newContent - New content (null for deleted files)\n * @param operation - Type of operation (create, update, delete)\n * @param description - Optional description of the change\n * @returns The created backup metadata, or null if backup failed\n */\nexport async function createBackup(\n filePath: string,\n oldContent: string | null,\n newContent: string | null,\n operation: BackupOperation,\n description?: string,\n): Promise<BackupMetadata | null> {\n try {\n const backupDir = getBackupDir(filePath)\n const indexPath = getIndexPath(filePath)\n\n // Ensure backup directory exists\n await mkdirAsync(backupDir, true)\n\n // Load or create index\n let index: BackupIndex\n if (await existsAsync(indexPath)) {\n const loaded = await readJsonAsync<BackupIndex>(indexPath)\n if (loaded) {\n index = loaded\n } else {\n // Corrupted index, recreate\n index = {\n filePath,\n pathHash: getPathHash(filePath),\n createdAt: Date.now(),\n versions: [],\n }\n }\n } else {\n index = {\n filePath,\n pathHash: getPathHash(filePath),\n createdAt: Date.now(),\n versions: [],\n }\n }\n\n // Determine content to backup (old content for updates/deletes, null for creates)\n const contentToBackup = operation === 'create' ? null : oldContent\n\n // Calculate next version number\n const maxVersion =\n index.versions.length > 0\n ? Math.max(...index.versions.map(v => v.version))\n : 0\n const newVersion = maxVersion + 1\n\n // Create metadata\n const metadata: BackupMetadata = {\n version: newVersion,\n timestamp: Date.now(),\n operation,\n encoding: contentToBackup ? detectEncoding(contentToBackup) : 'utf8',\n lineEndings: contentToBackup ? detectLineEndings(contentToBackup) : 'LF',\n size: contentToBackup ? Buffer.byteLength(contentToBackup, 'utf8') : 0,\n description,\n }\n\n // Write backup content if there is content to backup\n if (contentToBackup !== null) {\n const versionPath = getVersionPath(filePath, newVersion)\n await fs.writeFile(versionPath, contentToBackup, {\n encoding: metadata.encoding,\n })\n }\n\n // Add to versions\n index.versions.push(metadata)\n\n // Cleanup old versions if exceeding limit\n if (index.versions.length > MAX_VERSIONS_PER_FILE) {\n await cleanupOldVersions(filePath, index)\n }\n\n // Save updated index\n await writeJsonAsync(indexPath, index)\n\n return metadata\n } catch (error) {\n // Log error but don't throw - backup failure shouldn't block operations\n console.error(\n `[BackupManager] Failed to create backup for ${filePath}:`,\n error,\n )\n return null\n }\n}\n\n/**\n * Clean up old versions when exceeding MAX_VERSIONS_PER_FILE\n * Uses LRU strategy - removes oldest versions first\n */\nasync function cleanupOldVersions(\n filePath: string,\n index: BackupIndex,\n): Promise<void> {\n // Sort by version number (oldest first)\n index.versions.sort((a, b) => a.version - b.version)\n\n // Calculate how many to remove\n const toRemove = index.versions.length - MAX_VERSIONS_PER_FILE\n\n if (toRemove <= 0) return\n\n // Remove oldest versions\n const versionsToDelete = index.versions.splice(0, toRemove)\n\n // Delete the actual backup files\n for (const version of versionsToDelete) {\n const versionPath = getVersionPath(filePath, version.version)\n await unlinkAsync(versionPath)\n }\n}\n\n/**\n * List all files that have backups, sorted by most recent backup\n *\n * @returns Array of backup file summaries, sorted by most recent first\n */\nexport async function listBackedUpFiles(): Promise<BackupFileSummary[]> {\n try {\n const backupsDir = getBackupsDir()\n\n // Check if backups directory exists\n if (!(await existsAsync(backupsDir))) {\n return []\n }\n\n // Read all subdirectories in backups\n const entries = await readdirAsync(backupsDir)\n const summaries: BackupFileSummary[] = []\n\n for (const entry of entries) {\n const indexPath = join(backupsDir, entry, INDEX_FILE)\n\n if (await existsAsync(indexPath)) {\n const index = await readJsonAsync<BackupIndex>(indexPath)\n if (index && index.versions.length > 0) {\n // Get the most recent version\n const sortedVersions = [...index.versions].sort(\n (a, b) => b.timestamp - a.timestamp,\n )\n const mostRecent = sortedVersions[0]\n\n summaries.push({\n filePath: index.filePath,\n pathHash: index.pathHash,\n versionCount: index.versions.length,\n lastBackupAt: mostRecent.timestamp,\n lastOperation: mostRecent.operation,\n })\n }\n }\n }\n\n // Sort by most recent backup first\n summaries.sort((a, b) => b.lastBackupAt - a.lastBackupAt)\n\n return summaries\n } catch (error) {\n console.error('[BackupManager] Failed to list backed up files:', error)\n return []\n }\n}\n\n/**\n * Get all backup versions for a specific file\n *\n * @param filePath - Absolute path to the file\n * @returns Array of backup metadata, sorted by version (newest first)\n */\nexport async function getBackupVersions(\n filePath: string,\n): Promise<BackupMetadata[]> {\n try {\n const indexPath = getIndexPath(filePath)\n\n if (!(await existsAsync(indexPath))) {\n return []\n }\n\n const index = await readJsonAsync<BackupIndex>(indexPath)\n if (!index) {\n return []\n }\n\n // Return sorted by version (newest first)\n return [...index.versions].sort((a, b) => b.version - a.version)\n } catch (error) {\n console.error(\n `[BackupManager] Failed to get versions for ${filePath}:`,\n error,\n )\n return []\n }\n}\n\n/**\n * Get the content of a specific backup version\n *\n * @param filePath - Absolute path to the file\n * @param version - Version number to retrieve\n * @returns The backup content, or null if not found\n */\nexport async function getBackupContent(\n filePath: string,\n version: number,\n): Promise<string | null> {\n try {\n const indexPath = getIndexPath(filePath)\n\n // Check if index exists\n if (!(await existsAsync(indexPath))) {\n return null\n }\n\n // Load index to verify version exists\n const index = await readJsonAsync<BackupIndex>(indexPath)\n if (!index) {\n return null\n }\n\n // Find the version metadata\n const versionMeta = index.versions.find(v => v.version === version)\n if (!versionMeta) {\n return null\n }\n\n // For 'create' operations, there's no previous content\n if (versionMeta.operation === 'create' && versionMeta.size === 0) {\n return null\n }\n\n // Read the backup file\n const versionPath = getVersionPath(filePath, version)\n if (!(await existsAsync(versionPath))) {\n return null\n }\n\n const content = await fs.readFile(versionPath, {\n encoding: versionMeta.encoding,\n })\n\n return content\n } catch (error) {\n console.error(\n `[BackupManager] Failed to get backup content for ${filePath} v${version}:`,\n error,\n )\n return null\n }\n}\n\n/**\n * Restore a file to a specific backup version\n *\n * @param filePath - Absolute path to the file\n * @param version - Version number to restore to\n * @returns True if restoration was successful, false otherwise\n */\nexport async function restoreBackup(\n filePath: string,\n version: number,\n): Promise<boolean> {\n try {\n // Get the backup content\n const content = await getBackupContent(filePath, version)\n\n // Handle the case where content is null (could be a 'create' backup with no previous content)\n const indexPath = getIndexPath(filePath)\n const index = await readJsonAsync<BackupIndex>(indexPath)\n if (!index) {\n console.error(`[BackupManager] No backup index found for ${filePath}`)\n return false\n }\n\n const versionMeta = index.versions.find(v => v.version === version)\n if (!versionMeta) {\n console.error(\n `[BackupManager] Version ${version} not found for ${filePath}`,\n )\n return false\n }\n\n // If this was a 'create' operation, restoring means deleting the file\n if (versionMeta.operation === 'create' && content === null) {\n // The file didn't exist before creation, so \"restoring\" means deleting it\n await fs.unlink(filePath)\n return true\n }\n\n // For other cases, we need content\n if (content === null) {\n console.error(\n `[BackupManager] No content found for ${filePath} v${version}`,\n )\n return false\n }\n\n // Create a backup of current state before restoring\n let currentContent: string | null = null\n try {\n currentContent = await fs.readFile(filePath, 'utf8')\n } catch {\n // File might not exist, that's okay\n }\n\n if (currentContent !== null) {\n await createBackup(\n filePath,\n currentContent,\n content,\n 'update',\n `Restored from version ${version}`,\n )\n }\n\n // Ensure parent directory exists\n const parentDir = dirname(filePath)\n await mkdirAsync(parentDir, true)\n\n // Write the restored content\n await fs.writeFile(filePath, content, {\n encoding: versionMeta.encoding,\n })\n\n return true\n } catch (error) {\n console.error(\n `[BackupManager] Failed to restore ${filePath} to v${version}:`,\n error,\n )\n return false\n }\n}\n\n/**\n * Get the backup index for a file\n * Useful for debugging and advanced operations\n */\nexport async function getBackupIndex(\n filePath: string,\n): Promise<BackupIndex | null> {\n const indexPath = getIndexPath(filePath)\n return await readJsonAsync<BackupIndex>(indexPath)\n}\n\n/**\n * Delete all backups for a specific file\n * Use with caution - this is permanent\n */\nexport async function deleteAllBackups(filePath: string): Promise<boolean> {\n try {\n const backupDir = getBackupDir(filePath)\n\n if (!(await existsAsync(backupDir))) {\n return true // Nothing to delete\n }\n\n // Delete all files in the backup directory\n const entries = await readdirAsync(backupDir)\n for (const entry of entries) {\n await unlinkAsync(join(backupDir, entry))\n }\n\n // Remove the directory itself\n await fs.rmdir(backupDir)\n\n return true\n } catch (error) {\n console.error(\n `[BackupManager] Failed to delete backups for ${filePath}:`,\n error,\n )\n return false\n }\n}\n\n/**\n * Get total backup storage usage in bytes\n */\nexport async function getBackupStorageUsage(): Promise<{\n totalBytes: number\n fileCount: number\n versionCount: number\n}> {\n try {\n const backupsDir = getBackupsDir()\n\n if (!(await existsAsync(backupsDir))) {\n return { totalBytes: 0, fileCount: 0, versionCount: 0 }\n }\n\n let totalBytes = 0\n let fileCount = 0\n let versionCount = 0\n\n const entries = await readdirAsync(backupsDir)\n\n for (const entry of entries) {\n const indexPath = join(backupsDir, entry, INDEX_FILE)\n const index = await readJsonAsync<BackupIndex>(indexPath)\n\n if (index) {\n fileCount++\n versionCount += index.versions.length\n\n // Sum up the sizes from metadata\n for (const version of index.versions) {\n totalBytes += version.size\n }\n }\n }\n\n return { totalBytes, fileCount, versionCount }\n } catch (error) {\n console.error('[BackupManager] Failed to get storage usage:', error)\n return { totalBytes: 0, fileCount: 0, versionCount: 0 }\n }\n}\n"],
5
+ "mappings": "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",
6
+ "names": []
7
+ }