@hubspot/cli 8.3.0-beta.1 → 8.3.0-experimental.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 (813) hide show
  1. package/api/migrate.js +3 -3
  2. package/api/releases.d.ts +39 -0
  3. package/api/releases.js +41 -0
  4. package/bin/cli.js +18 -7
  5. package/bin/hs.js +1 -0
  6. package/bin/hscms.js +1 -0
  7. package/bin/setupColor.d.ts +2 -0
  8. package/bin/setupColor.js +10 -0
  9. package/commands/account/auth.d.ts +6 -3
  10. package/commands/account/auth.js +48 -29
  11. package/commands/account/clean.js +7 -6
  12. package/commands/account/createOverride.js +10 -7
  13. package/commands/account/info.js +36 -17
  14. package/commands/account/link.d.ts +4 -0
  15. package/commands/account/link.js +87 -0
  16. package/commands/account/list.js +32 -76
  17. package/commands/account/remove.js +4 -3
  18. package/commands/account/removeOverride.js +11 -10
  19. package/commands/account/rename.js +5 -6
  20. package/commands/account/unlink.d.ts +4 -0
  21. package/commands/account/unlink.js +68 -0
  22. package/commands/account/use.js +79 -20
  23. package/commands/account.js +4 -0
  24. package/commands/api.d.ts +13 -0
  25. package/commands/api.js +161 -0
  26. package/commands/app/logDetails.d.ts +9 -0
  27. package/commands/app/logDetails.js +86 -0
  28. package/commands/app/logs.d.ts +13 -0
  29. package/commands/app/logs.js +126 -0
  30. package/commands/app/migrate.js +12 -12
  31. package/commands/app/secret/add.js +6 -7
  32. package/commands/app/secret/delete.js +9 -10
  33. package/commands/app/secret/list.js +6 -7
  34. package/commands/app/secret/update.js +8 -9
  35. package/commands/app.js +8 -1
  36. package/commands/auth.js +13 -13
  37. package/commands/cms/app/create.js +9 -5
  38. package/commands/cms/convertFields.js +8 -8
  39. package/commands/cms/delete.js +2 -3
  40. package/commands/cms/fetch.js +7 -7
  41. package/commands/cms/function/create.js +9 -5
  42. package/commands/cms/function/deploy.js +2 -3
  43. package/commands/cms/function/list.js +11 -7
  44. package/commands/cms/function/logs.js +17 -23
  45. package/commands/cms/function/server.js +16 -10
  46. package/commands/cms/getReactModule.js +7 -8
  47. package/commands/cms/lighthouseScore.js +25 -24
  48. package/commands/cms/lint.js +4 -5
  49. package/commands/cms/list.js +5 -6
  50. package/commands/cms/module/create.js +15 -5
  51. package/commands/cms/module/marketplace-validate.js +7 -8
  52. package/commands/cms/mv.js +2 -3
  53. package/commands/cms/template/create.js +10 -6
  54. package/commands/cms/theme/create.js +5 -5
  55. package/commands/cms/theme/generate-selectors.js +5 -4
  56. package/commands/cms/theme/marketplace-validate.js +8 -9
  57. package/commands/cms/theme/preview.js +24 -9
  58. package/commands/cms/upload.js +15 -12
  59. package/commands/cms/watch.js +5 -5
  60. package/commands/cms/webpack/create.js +5 -5
  61. package/commands/completion.js +3 -5
  62. package/commands/config/migrate.js +6 -7
  63. package/commands/config/set.js +29 -11
  64. package/commands/customObject/create.js +4 -5
  65. package/commands/customObject/createSchema.js +6 -8
  66. package/commands/customObject/deleteSchema.js +4 -5
  67. package/commands/customObject/fetchAllSchemas.js +2 -3
  68. package/commands/customObject/fetchSchema.js +2 -3
  69. package/commands/customObject/listSchemas.js +2 -3
  70. package/commands/customObject/updateSchema.js +6 -8
  71. package/commands/doctor.js +8 -8
  72. package/commands/feedback.js +6 -4
  73. package/commands/filemanager/fetch.js +5 -6
  74. package/commands/filemanager/upload.js +5 -5
  75. package/commands/getStarted.js +34 -38
  76. package/commands/hubdb/clear.js +5 -6
  77. package/commands/hubdb/create.js +4 -5
  78. package/commands/hubdb/delete.js +8 -9
  79. package/commands/hubdb/fetch.js +5 -6
  80. package/commands/hubdb/list.d.ts +1 -1
  81. package/commands/hubdb/list.js +23 -22
  82. package/commands/init.js +17 -18
  83. package/commands/mcp/setup.d.ts +2 -0
  84. package/commands/mcp/setup.js +35 -8
  85. package/commands/mcp/start.js +2 -3
  86. package/commands/open.js +4 -5
  87. package/commands/project/add.d.ts +3 -2
  88. package/commands/project/add.js +26 -18
  89. package/commands/project/appInstallStatus.d.ts +5 -0
  90. package/commands/project/appInstallStatus.js +139 -0
  91. package/commands/project/create.d.ts +4 -2
  92. package/commands/project/create.js +64 -23
  93. package/commands/project/delete.d.ts +7 -0
  94. package/commands/project/delete.js +74 -0
  95. package/commands/project/deploy.d.ts +2 -1
  96. package/commands/project/deploy.js +72 -50
  97. package/commands/project/dev/index.d.ts +3 -3
  98. package/commands/project/dev/index.js +47 -90
  99. package/commands/project/dev/unifiedFlow.js +81 -22
  100. package/commands/project/download.d.ts +3 -2
  101. package/commands/project/download.js +26 -14
  102. package/commands/project/info.d.ts +5 -0
  103. package/commands/project/info.js +73 -0
  104. package/commands/project/installApp.d.ts +8 -0
  105. package/commands/project/installApp.js +185 -0
  106. package/commands/project/installDeps.js +17 -11
  107. package/commands/project/lint.js +57 -19
  108. package/commands/project/list.d.ts +3 -2
  109. package/commands/project/list.js +34 -15
  110. package/commands/project/listBuilds.d.ts +3 -2
  111. package/commands/project/listBuilds.js +50 -19
  112. package/commands/project/logs.js +7 -10
  113. package/commands/project/migrate.js +26 -31
  114. package/commands/project/open.js +20 -13
  115. package/commands/project/profile/add.d.ts +2 -1
  116. package/commands/project/profile/add.js +42 -13
  117. package/commands/project/profile/delete.d.ts +1 -1
  118. package/commands/project/profile/delete.js +23 -15
  119. package/commands/project/release/create.d.ts +8 -0
  120. package/commands/project/release/create.js +160 -0
  121. package/commands/project/release/info.d.ts +7 -0
  122. package/commands/project/release/info.js +148 -0
  123. package/commands/project/release/list.d.ts +7 -0
  124. package/commands/project/release/list.js +119 -0
  125. package/commands/project/release/preview.d.ts +9 -0
  126. package/commands/project/release/preview.js +167 -0
  127. package/commands/project/release.d.ts +3 -0
  128. package/commands/project/release.js +26 -0
  129. package/commands/project/updateDeps.js +15 -11
  130. package/commands/project/upload.d.ts +7 -1
  131. package/commands/project/upload.js +159 -35
  132. package/commands/project/validate.d.ts +3 -2
  133. package/commands/project/validate.js +73 -103
  134. package/commands/project/watch.js +27 -29
  135. package/commands/project.js +17 -4
  136. package/commands/sandbox/create.js +15 -15
  137. package/commands/sandbox/delete.js +15 -17
  138. package/commands/secret/addSecret.js +6 -7
  139. package/commands/secret/deleteSecret.js +5 -6
  140. package/commands/secret/listSecret.js +2 -3
  141. package/commands/secret/updateSecret.js +4 -5
  142. package/commands/testAccount/create.d.ts +3 -2
  143. package/commands/testAccount/create.js +29 -25
  144. package/commands/testAccount/createConfig.js +7 -8
  145. package/commands/testAccount/delete.js +27 -18
  146. package/commands/testAccount/importData.d.ts +1 -1
  147. package/commands/testAccount/importData.js +6 -7
  148. package/commands/upgrade.js +11 -10
  149. package/lang/en.d.ts +597 -52
  150. package/lang/en.js +637 -76
  151. package/lib/CLIWebSocketServer.d.ts +5 -3
  152. package/lib/CLIWebSocketServer.js +31 -4
  153. package/lib/accountAuth.d.ts +3 -1
  154. package/lib/accountAuth.js +45 -19
  155. package/lib/accountTargetDiscovery.d.ts +15 -0
  156. package/lib/accountTargetDiscovery.js +175 -0
  157. package/lib/api/usageTracking.d.ts +30 -0
  158. package/lib/api/usageTracking.js +11 -0
  159. package/lib/app/install.d.ts +22 -0
  160. package/lib/app/install.js +42 -0
  161. package/lib/app/logs.d.ts +38 -0
  162. package/lib/app/logs.js +225 -0
  163. package/lib/app/migrate.js +13 -7
  164. package/lib/app/urls.d.ts +2 -0
  165. package/lib/app/urls.js +7 -1
  166. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.d.ts +4 -0
  167. package/lib/auth/awaitPersonalAccessKeyOverWebsocket.js +146 -0
  168. package/lib/buildAccount.js +4 -4
  169. package/lib/cms/serverlessDevRuntime.d.ts +1 -0
  170. package/lib/cms/serverlessDevRuntime.js +72 -0
  171. package/lib/commonOpts.js +6 -2
  172. package/lib/configOptions.d.ts +10 -10
  173. package/lib/configOptions.js +10 -11
  174. package/lib/constants.d.ts +14 -2
  175. package/lib/constants.js +16 -2
  176. package/lib/dependencyManagement.js +10 -17
  177. package/lib/doctor/Diagnosis.js +5 -5
  178. package/lib/doctor/DiagnosticInfoBuilder.d.ts +2 -2
  179. package/lib/doctor/DiagnosticInfoBuilder.js +8 -8
  180. package/lib/doctor/Doctor.d.ts +1 -0
  181. package/lib/doctor/Doctor.js +40 -16
  182. package/lib/errorHandlers/index.js +4 -3
  183. package/lib/errorHandlers/suppressError.js +4 -0
  184. package/lib/errors/ProjectErrors.d.ts +0 -6
  185. package/lib/errors/ProjectErrors.js +0 -12
  186. package/lib/errors/ProjectValidationError.d.ts +2 -1
  187. package/lib/errors/ProjectValidationError.js +3 -1
  188. package/lib/errors/PromptExitError.d.ts +4 -2
  189. package/lib/errors/PromptExitError.js +3 -0
  190. package/lib/filesystem.d.ts +6 -0
  191. package/lib/filesystem.js +9 -0
  192. package/lib/getStartedV2Actions.js +18 -21
  193. package/lib/hasFeature.js +1 -2
  194. package/lib/importData.js +3 -4
  195. package/lib/jsonOutput/accountAuth.d.ts +7 -0
  196. package/lib/jsonOutput/accountAuth.js +6 -0
  197. package/lib/jsonOutput/projectAdd.d.ts +9 -0
  198. package/lib/jsonOutput/projectAdd.js +10 -0
  199. package/lib/jsonOutput/projectAppInstallStatus.d.ts +14 -0
  200. package/lib/jsonOutput/projectAppInstallStatus.js +14 -0
  201. package/lib/jsonOutput/projectCreate.d.ts +8 -0
  202. package/lib/jsonOutput/projectCreate.js +7 -0
  203. package/lib/jsonOutput/projectDeploy.d.ts +5 -0
  204. package/lib/jsonOutput/projectDeploy.js +4 -0
  205. package/lib/jsonOutput/projectDownload.d.ts +7 -0
  206. package/lib/jsonOutput/projectDownload.js +6 -0
  207. package/lib/jsonOutput/projectInfo.d.ts +21 -0
  208. package/lib/jsonOutput/projectInfo.js +19 -0
  209. package/lib/jsonOutput/projectInstallApp.d.ts +11 -0
  210. package/lib/jsonOutput/projectInstallApp.js +10 -0
  211. package/lib/jsonOutput/projectList.d.ts +29 -0
  212. package/lib/jsonOutput/projectList.js +28 -0
  213. package/lib/jsonOutput/projectListBuilds.d.ts +75 -0
  214. package/lib/jsonOutput/projectListBuilds.js +65 -0
  215. package/lib/jsonOutput/projectRelease.d.ts +49 -0
  216. package/lib/jsonOutput/projectRelease.js +44 -0
  217. package/lib/jsonOutput/projectUpload.d.ts +29 -0
  218. package/lib/jsonOutput/projectUpload.js +23 -0
  219. package/lib/jsonOutput/projectValidate.d.ts +36 -0
  220. package/lib/jsonOutput/projectValidate.js +20 -0
  221. package/lib/jsonOutput/testAccountCreate.d.ts +7 -0
  222. package/lib/jsonOutput/testAccountCreate.js +6 -0
  223. package/lib/link/accountTableUtils.d.ts +10 -0
  224. package/lib/link/accountTableUtils.js +39 -0
  225. package/lib/link/index.d.ts +18 -0
  226. package/lib/link/index.js +185 -0
  227. package/lib/link/linkUtils.d.ts +5 -0
  228. package/lib/link/linkUtils.js +49 -0
  229. package/lib/link/prompts.d.ts +7 -0
  230. package/lib/link/prompts.js +126 -0
  231. package/lib/link/renderLinkedAccountsTable.d.ts +2 -0
  232. package/lib/link/renderLinkedAccountsTable.js +14 -0
  233. package/lib/link/warnIfLinkedDirectory.d.ts +1 -0
  234. package/lib/link/warnIfLinkedDirectory.js +9 -0
  235. package/lib/links.js +6 -5
  236. package/lib/mcp/clients.d.ts +13 -0
  237. package/lib/mcp/clients.js +62 -0
  238. package/lib/mcp/promotion.d.ts +3 -0
  239. package/lib/mcp/promotion.js +109 -0
  240. package/lib/mcp/setup.d.ts +8 -2
  241. package/lib/mcp/setup.js +134 -39
  242. package/lib/middleware/autoUpdateMiddleware.js +6 -3
  243. package/lib/middleware/commandTargetingUtils.js +1 -0
  244. package/lib/npm/npmCli.d.ts +1 -0
  245. package/lib/npm/npmCli.js +13 -0
  246. package/lib/npm/packageJson.js +1 -1
  247. package/lib/process.d.ts +1 -1
  248. package/lib/process.js +10 -3
  249. package/lib/projects/ProjectLogsManager.js +7 -7
  250. package/lib/projects/add/legacyAddComponent.d.ts +2 -1
  251. package/lib/projects/add/legacyAddComponent.js +3 -0
  252. package/lib/projects/add/v2AddComponent.d.ts +2 -1
  253. package/lib/projects/add/v2AddComponent.js +7 -1
  254. package/lib/projects/builds.d.ts +2 -0
  255. package/lib/projects/builds.js +22 -0
  256. package/lib/projects/config.d.ts +6 -5
  257. package/lib/projects/config.js +7 -38
  258. package/lib/projects/create/index.js +2 -2
  259. package/lib/projects/create/legacy.js +2 -2
  260. package/lib/projects/create/tracking.d.ts +1 -0
  261. package/lib/projects/create/tracking.js +27 -0
  262. package/lib/projects/create/v2.js +4 -4
  263. package/lib/projects/delete.d.ts +13 -0
  264. package/lib/projects/delete.js +206 -0
  265. package/lib/projects/deploy.d.ts +1 -1
  266. package/lib/projects/deploy.js +2 -2
  267. package/lib/projects/installApp.d.ts +58 -0
  268. package/lib/projects/installApp.js +283 -0
  269. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  270. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  271. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  272. package/lib/projects/localDev/DevSessionManager.js +35 -49
  273. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  274. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  275. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  276. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  277. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  278. package/lib/projects/localDev/LocalDevState.js +21 -1
  279. package/lib/projects/localDev/LocalDevWatcher.js +1 -1
  280. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  281. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  282. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  283. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  284. package/lib/projects/localDev/helpers/account.js +8 -90
  285. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  286. package/lib/projects/localDev/helpers/process.js +4 -10
  287. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  288. package/lib/projects/localDev/helpers/project.js +80 -29
  289. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  290. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  291. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  292. package/lib/projects/npmAuditOnUpload.js +73 -0
  293. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  294. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  295. package/lib/projects/preview.d.ts +7 -0
  296. package/lib/projects/preview.js +48 -0
  297. package/lib/projects/projectInfo.d.ts +5 -0
  298. package/lib/projects/projectInfo.js +82 -0
  299. package/lib/projects/projectProfiles.d.ts +3 -3
  300. package/lib/projects/projectProfiles.js +11 -18
  301. package/lib/projects/release.d.ts +4 -0
  302. package/lib/projects/release.js +90 -0
  303. package/lib/projects/ui.d.ts +1 -0
  304. package/lib/projects/ui.js +14 -0
  305. package/lib/projects/uieLinting.d.ts +23 -3
  306. package/lib/projects/uieLinting.js +134 -28
  307. package/lib/projects/upload.d.ts +17 -3
  308. package/lib/projects/upload.js +65 -14
  309. package/lib/projects/urls.d.ts +0 -1
  310. package/lib/projects/urls.js +6 -13
  311. package/lib/projects/validate.d.ts +18 -0
  312. package/lib/projects/validate.js +142 -0
  313. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  314. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  315. package/lib/projects/workspaces.d.ts +60 -0
  316. package/lib/projects/workspaces.js +404 -0
  317. package/lib/prompts/createApiSamplePrompt.js +4 -0
  318. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  319. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  320. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  321. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  322. package/lib/prompts/projectProfilePrompt.d.ts +2 -0
  323. package/lib/prompts/projectProfilePrompt.js +46 -0
  324. package/lib/prompts/projectsLogsPrompt.js +3 -0
  325. package/lib/prompts/promptUtils.js +4 -2
  326. package/lib/prompts/selectAppPrompt.js +1 -0
  327. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  328. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  329. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  330. package/lib/serverlessLogs.js +2 -2
  331. package/lib/testUtils.d.ts +1 -0
  332. package/lib/testUtils.js +14 -0
  333. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  334. package/lib/theme/cmsDevServerProcess.js +8 -7
  335. package/lib/theme/migrate.js +1 -4
  336. package/lib/ui/SpinniesManager.d.ts +2 -0
  337. package/lib/ui/SpinniesManager.js +34 -10
  338. package/lib/ui/accountTable.d.ts +8 -0
  339. package/lib/ui/accountTable.js +67 -0
  340. package/lib/ui/appLogs.d.ts +32 -0
  341. package/lib/ui/appLogs.js +175 -0
  342. package/lib/ui/index.js +2 -2
  343. package/lib/ui/spinniesUtils.d.ts +0 -1
  344. package/lib/ui/spinniesUtils.js +6 -16
  345. package/lib/ui/supportsColor.d.ts +4 -0
  346. package/lib/ui/supportsColor.js +25 -6
  347. package/lib/usageTracking.d.ts +10 -20
  348. package/lib/usageTracking.js +77 -30
  349. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  350. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  351. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  352. package/lib/yargs/makeYargsBuilder.js +33 -0
  353. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  354. package/lib/yargs/parseYargsOrExit.js +25 -0
  355. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  356. package/lib/yargs/strictEnforceBoolean.js +13 -0
  357. package/lib/yargsUtils.d.ts +3 -16
  358. package/lib/yargsUtils.js +3 -48
  359. package/mcp-server/Tool.d.ts +25 -0
  360. package/mcp-server/Tool.js +83 -0
  361. package/mcp-server/server.js +63 -3
  362. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  363. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  364. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  365. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  366. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  367. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  368. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +5 -3
  369. package/mcp-server/tools/cms/HsFunctionLogsTool.js +17 -16
  370. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  371. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  372. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  373. package/mcp-server/tools/cms/HsListTool.js +14 -16
  374. package/mcp-server/tools/index.d.ts +3 -2
  375. package/mcp-server/tools/index.js +28 -22
  376. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  377. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  378. package/mcp-server/tools/project/AuthAccountTool.d.ts +18 -0
  379. package/mcp-server/tools/project/AuthAccountTool.js +88 -0
  380. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  381. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  382. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  383. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  384. package/mcp-server/tools/project/DeployProjectTool.d.ts +5 -3
  385. package/mcp-server/tools/project/DeployProjectTool.js +23 -17
  386. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  387. package/mcp-server/tools/project/DocFetchTool.js +8 -6
  388. package/mcp-server/tools/project/DocsSearchTool.d.ts +9 -3
  389. package/mcp-server/tools/project/DocsSearchTool.js +39 -15
  390. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  391. package/mcp-server/tools/project/FindProjectsTool.js +60 -0
  392. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +6 -3
  393. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +16 -13
  394. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +6 -3
  395. package/mcp-server/tools/project/GetApplicationInfoTool.js +19 -14
  396. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +5 -3
  397. package/mcp-server/tools/project/GetBuildLogsTool.js +19 -14
  398. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  399. package/mcp-server/tools/project/GetBuildStatusTool.js +58 -15
  400. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +6 -3
  401. package/mcp-server/tools/project/GetConfigValuesTool.js +20 -13
  402. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  403. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  404. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  405. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  406. package/mcp-server/tools/project/UploadProjectTools.d.ts +5 -3
  407. package/mcp-server/tools/project/UploadProjectTools.js +28 -20
  408. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  409. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  410. package/mcp-server/tools/project/constants.d.ts +4 -2
  411. package/mcp-server/tools/project/constants.js +5 -1
  412. package/mcp-server/types.d.ts +3 -8
  413. package/mcp-server/types.js +1 -13
  414. package/mcp-server/utils/command.d.ts +26 -2
  415. package/mcp-server/utils/command.js +75 -15
  416. package/mcp-server/utils/config.js +6 -0
  417. package/mcp-server/utils/content.d.ts +3 -2
  418. package/mcp-server/utils/content.js +6 -1
  419. package/mcp-server/utils/elicitation.d.ts +9 -0
  420. package/mcp-server/utils/elicitation.js +35 -0
  421. package/mcp-server/utils/json.d.ts +3 -0
  422. package/mcp-server/utils/json.js +29 -0
  423. package/mcp-server/utils/logger.d.ts +13 -0
  424. package/mcp-server/utils/logger.js +59 -0
  425. package/mcp-server/utils/toolUsageTracking.js +28 -11
  426. package/package.json +37 -28
  427. package/types/AccountTargets.d.ts +37 -0
  428. package/types/AccountTargets.js +12 -0
  429. package/types/Link.d.ts +32 -0
  430. package/types/Link.js +5 -0
  431. package/types/LocalDev.d.ts +15 -2
  432. package/types/PackageJson.d.ts +1 -0
  433. package/types/ProjectComponents.d.ts +2 -1
  434. package/types/Projects.d.ts +25 -5
  435. package/types/Prompts.d.ts +1 -0
  436. package/types/Yargs.d.ts +23 -2
  437. package/ui/components/ActionSection.d.ts +1 -1
  438. package/ui/components/InputField.d.ts +1 -1
  439. package/ui/components/SelectInput.d.ts +1 -1
  440. package/ui/components/StatusIcon.d.ts +1 -1
  441. package/ui/components/Table.d.ts +13 -13
  442. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  443. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  444. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  445. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  446. package/api/__tests__/migrate.test.d.ts +0 -1
  447. package/api/__tests__/migrate.test.js +0 -199
  448. package/commands/__tests__/account.test.d.ts +0 -1
  449. package/commands/__tests__/account.test.js +0 -69
  450. package/commands/__tests__/auth.test.d.ts +0 -1
  451. package/commands/__tests__/auth.test.js +0 -43
  452. package/commands/__tests__/cms.test.d.ts +0 -1
  453. package/commands/__tests__/cms.test.js +0 -87
  454. package/commands/__tests__/config.test.d.ts +0 -1
  455. package/commands/__tests__/config.test.js +0 -44
  456. package/commands/__tests__/customObject.test.d.ts +0 -1
  457. package/commands/__tests__/customObject.test.js +0 -68
  458. package/commands/__tests__/doctor.test.d.ts +0 -1
  459. package/commands/__tests__/doctor.test.js +0 -132
  460. package/commands/__tests__/feedback.test.d.ts +0 -1
  461. package/commands/__tests__/feedback.test.js +0 -24
  462. package/commands/__tests__/filemanager.test.d.ts +0 -1
  463. package/commands/__tests__/filemanager.test.js +0 -45
  464. package/commands/__tests__/getStarted.test.d.ts +0 -1
  465. package/commands/__tests__/getStarted.test.js +0 -173
  466. package/commands/__tests__/hubdb.test.d.ts +0 -1
  467. package/commands/__tests__/hubdb.test.js +0 -50
  468. package/commands/__tests__/init.test.d.ts +0 -1
  469. package/commands/__tests__/init.test.js +0 -42
  470. package/commands/__tests__/mcp.test.d.ts +0 -1
  471. package/commands/__tests__/mcp.test.js +0 -46
  472. package/commands/__tests__/open.test.d.ts +0 -1
  473. package/commands/__tests__/open.test.js +0 -58
  474. package/commands/__tests__/project.test.d.ts +0 -1
  475. package/commands/__tests__/project.test.js +0 -125
  476. package/commands/__tests__/sandbox.test.d.ts +0 -1
  477. package/commands/__tests__/sandbox.test.js +0 -44
  478. package/commands/__tests__/secret.test.d.ts +0 -1
  479. package/commands/__tests__/secret.test.js +0 -49
  480. package/commands/__tests__/testAccount.test.d.ts +0 -1
  481. package/commands/__tests__/testAccount.test.js +0 -57
  482. package/commands/__tests__/upgrade.test.d.ts +0 -1
  483. package/commands/__tests__/upgrade.test.js +0 -309
  484. package/commands/account/__tests__/auth.test.d.ts +0 -1
  485. package/commands/account/__tests__/auth.test.js +0 -206
  486. package/commands/account/__tests__/clean.test.d.ts +0 -1
  487. package/commands/account/__tests__/clean.test.js +0 -28
  488. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  489. package/commands/account/__tests__/createOverride.test.js +0 -32
  490. package/commands/account/__tests__/info.test.d.ts +0 -1
  491. package/commands/account/__tests__/info.test.js +0 -28
  492. package/commands/account/__tests__/list.test.d.ts +0 -1
  493. package/commands/account/__tests__/list.test.js +0 -153
  494. package/commands/account/__tests__/remove.test.d.ts +0 -1
  495. package/commands/account/__tests__/remove.test.js +0 -36
  496. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  497. package/commands/account/__tests__/removeOverride.js +0 -25
  498. package/commands/account/__tests__/rename.test.d.ts +0 -1
  499. package/commands/account/__tests__/rename.test.js +0 -82
  500. package/commands/account/__tests__/use.test.d.ts +0 -1
  501. package/commands/account/__tests__/use.test.js +0 -170
  502. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  503. package/commands/app/__tests__/migrate.test.js +0 -111
  504. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  505. package/commands/app/secret/__tests__/add.test.js +0 -140
  506. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  507. package/commands/app/secret/__tests__/delete.test.js +0 -28
  508. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  509. package/commands/app/secret/__tests__/list.test.js +0 -25
  510. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  511. package/commands/app/secret/__tests__/update.test.js +0 -28
  512. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  513. package/commands/cms/__tests__/delete.test.js +0 -39
  514. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  515. package/commands/cms/__tests__/fetch.test.js +0 -156
  516. package/commands/cms/__tests__/function.test.d.ts +0 -1
  517. package/commands/cms/__tests__/function.test.js +0 -50
  518. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  519. package/commands/cms/__tests__/lint.test.js +0 -33
  520. package/commands/cms/__tests__/list.test.d.ts +0 -1
  521. package/commands/cms/__tests__/list.test.js +0 -42
  522. package/commands/cms/__tests__/module.test.d.ts +0 -1
  523. package/commands/cms/__tests__/module.test.js +0 -45
  524. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  525. package/commands/cms/__tests__/mv.test.js +0 -46
  526. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  527. package/commands/cms/__tests__/theme.test.js +0 -54
  528. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  529. package/commands/cms/__tests__/upload.test.js +0 -312
  530. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  531. package/commands/cms/__tests__/watch.test.js +0 -204
  532. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  533. package/commands/cms/function/__tests__/logs.test.js +0 -70
  534. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  535. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  536. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  537. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  538. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  539. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  540. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  541. package/commands/customObject/__tests__/create.test.js +0 -40
  542. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  543. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  544. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  545. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  546. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  547. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  548. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  549. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  550. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  551. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  552. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  553. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  554. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  555. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  556. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  557. package/commands/filemanager/__tests__/upload.test.js +0 -191
  558. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  559. package/commands/hubdb/__tests__/clear.test.js +0 -28
  560. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  561. package/commands/hubdb/__tests__/create.test.js +0 -28
  562. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  563. package/commands/hubdb/__tests__/delete.test.js +0 -28
  564. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  565. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  566. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  567. package/commands/hubdb/__tests__/list.test.js +0 -88
  568. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  569. package/commands/mcp/__tests__/setup.test.js +0 -26
  570. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  571. package/commands/mcp/__tests__/start.test.js +0 -144
  572. package/commands/project/__tests__/add.test.d.ts +0 -1
  573. package/commands/project/__tests__/add.test.js +0 -107
  574. package/commands/project/__tests__/create.test.d.ts +0 -1
  575. package/commands/project/__tests__/create.test.js +0 -97
  576. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  577. package/commands/project/__tests__/deploy.test.js +0 -307
  578. package/commands/project/__tests__/dev.test.d.ts +0 -1
  579. package/commands/project/__tests__/dev.test.js +0 -273
  580. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  581. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  582. package/commands/project/__tests__/download.test.d.ts +0 -1
  583. package/commands/project/__tests__/download.test.js +0 -39
  584. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  585. package/commands/project/__tests__/installDeps.test.js +0 -140
  586. package/commands/project/__tests__/lint.test.d.ts +0 -1
  587. package/commands/project/__tests__/lint.test.js +0 -704
  588. package/commands/project/__tests__/list.test.d.ts +0 -1
  589. package/commands/project/__tests__/list.test.js +0 -31
  590. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  591. package/commands/project/__tests__/listBuilds.test.js +0 -38
  592. package/commands/project/__tests__/logs.test.d.ts +0 -1
  593. package/commands/project/__tests__/logs.test.js +0 -202
  594. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  595. package/commands/project/__tests__/migrate.test.js +0 -106
  596. package/commands/project/__tests__/open.test.d.ts +0 -1
  597. package/commands/project/__tests__/open.test.js +0 -39
  598. package/commands/project/__tests__/profile.test.d.ts +0 -1
  599. package/commands/project/__tests__/profile.test.js +0 -42
  600. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  601. package/commands/project/__tests__/updateDeps.test.js +0 -140
  602. package/commands/project/__tests__/upload.test.d.ts +0 -1
  603. package/commands/project/__tests__/upload.test.js +0 -234
  604. package/commands/project/__tests__/validate.test.d.ts +0 -1
  605. package/commands/project/__tests__/validate.test.js +0 -381
  606. package/commands/project/__tests__/watch.test.d.ts +0 -1
  607. package/commands/project/__tests__/watch.test.js +0 -35
  608. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  609. package/commands/project/dev/deprecatedFlow.js +0 -135
  610. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  611. package/commands/sandbox/__tests__/create.test.js +0 -198
  612. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  613. package/commands/sandbox/__tests__/delete.test.js +0 -31
  614. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  615. package/commands/secret/__tests__/addSecret.test.js +0 -162
  616. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  617. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  618. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  619. package/commands/secret/__tests__/listSecret.test.js +0 -29
  620. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  621. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  622. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  623. package/commands/testAccount/__tests__/create.test.js +0 -106
  624. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  625. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  626. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  627. package/commands/testAccount/__tests__/delete.test.js +0 -29
  628. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  629. package/commands/testAccount/__tests__/importData.test.js +0 -92
  630. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  631. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  632. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  633. package/lib/__tests__/accountAuth.test.js +0 -258
  634. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  635. package/lib/__tests__/accountTypes.test.js +0 -98
  636. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  637. package/lib/__tests__/buildAccount.test.js +0 -211
  638. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  639. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  640. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  641. package/lib/__tests__/commandSuggestion.test.js +0 -121
  642. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  643. package/lib/__tests__/commonOpts.test.js +0 -80
  644. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  645. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  646. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  647. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  648. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  649. package/lib/__tests__/hasFeature.test.js +0 -167
  650. package/lib/__tests__/http.test.d.ts +0 -1
  651. package/lib/__tests__/http.test.js +0 -40
  652. package/lib/__tests__/importData.test.d.ts +0 -1
  653. package/lib/__tests__/importData.test.js +0 -98
  654. package/lib/__tests__/npmCli.test.d.ts +0 -1
  655. package/lib/__tests__/npmCli.test.js +0 -84
  656. package/lib/__tests__/oauth.test.d.ts +0 -1
  657. package/lib/__tests__/oauth.test.js +0 -109
  658. package/lib/__tests__/parsing.test.d.ts +0 -1
  659. package/lib/__tests__/parsing.test.js +0 -34
  660. package/lib/__tests__/polling.test.d.ts +0 -1
  661. package/lib/__tests__/polling.test.js +0 -76
  662. package/lib/__tests__/process.test.d.ts +0 -1
  663. package/lib/__tests__/process.test.js +0 -89
  664. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  665. package/lib/__tests__/sandboxes.test.js +0 -128
  666. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  667. package/lib/__tests__/serverlessLogs.test.js +0 -163
  668. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  669. package/lib/__tests__/usageTracking.test.js +0 -197
  670. package/lib/__tests__/validation.test.d.ts +0 -1
  671. package/lib/__tests__/validation.test.js +0 -143
  672. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  673. package/lib/__tests__/yargsUtils.test.js +0 -124
  674. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  675. package/lib/app/__tests__/migrate.test.js +0 -638
  676. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  677. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  678. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  679. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  680. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  681. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  682. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  683. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  684. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  685. package/lib/mcp/__tests__/setup.test.js +0 -523
  686. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  687. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  688. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  689. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  690. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  691. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  692. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  693. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  694. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  695. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  696. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  697. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  698. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  699. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  700. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  701. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  702. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  703. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  704. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  705. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  706. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  707. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  708. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  709. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  710. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  711. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  712. package/lib/projects/__tests__/components.test.d.ts +0 -1
  713. package/lib/projects/__tests__/components.test.js +0 -440
  714. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  715. package/lib/projects/__tests__/deploy.test.js +0 -231
  716. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  717. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  718. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  719. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  720. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  721. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  722. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  723. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  724. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  725. package/lib/projects/__tests__/projects.test.js +0 -58
  726. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  727. package/lib/projects/__tests__/structure.test.js +0 -210
  728. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  729. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  730. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  731. package/lib/projects/__tests__/upload.test.js +0 -183
  732. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  733. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  734. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  735. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  736. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  737. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  738. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  739. package/lib/projects/create/__tests__/v2.test.js +0 -257
  740. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  741. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  742. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  743. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  744. package/lib/projects/platformVersion.d.ts +0 -9
  745. package/lib/projects/platformVersion.js +0 -39
  746. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  747. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  748. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  749. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  750. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  751. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  752. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  753. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  754. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  755. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  756. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  757. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  758. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  759. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  760. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  761. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  762. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  763. package/lib/theme/__tests__/migrate.test.js +0 -247
  764. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  765. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  766. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  767. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  768. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  769. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  770. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  771. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  772. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  773. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  774. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  775. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  776. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  777. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  778. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  779. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  780. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  781. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  782. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  783. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  784. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  785. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  786. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  787. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  788. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  789. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  790. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  791. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  792. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  793. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  794. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  795. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  796. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  797. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  798. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  799. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  800. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  801. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  802. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  803. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  804. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  805. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  806. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  807. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  808. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  809. package/mcp-server/utils/__tests__/command.test.js +0 -275
  810. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  811. package/mcp-server/utils/__tests__/content.test.js +0 -164
  812. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  813. package/mcp-server/utils/__tests__/feedbackTracking.test.js +0 -69
@@ -1,18 +1,30 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
4
3
  import { formatTextContents } from '../../utils/content.js';
5
4
  import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
6
5
  import { fetchProjectBuilds, getBuildStatus, } from '@hubspot/local-dev-lib/api/projects';
7
- import { getProjectConfig, validateProjectConfig, } from '../../../lib/projects/config.js';
6
+ import { getProjectConfig } from '../../../lib/projects/config.js';
8
7
  import moment from 'moment';
9
8
  import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
10
- import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
11
9
  import { setupHubSpotConfig } from '../../utils/config.js';
10
+ import { discoverAccountTargets } from '../../../lib/accountTargetDiscovery.js';
11
+ import { enumField } from '../../utils/elicitation.js';
12
12
  const TOOL_NAME = 'get-build-status';
13
+ function formatAccountChoice(candidate) {
14
+ const name = candidate.accountName || String(candidate.accountId);
15
+ const parts = [`${name} (${candidate.category})`];
16
+ if (candidate.profileName) {
17
+ parts.push(`[profile: ${candidate.profileName}]`);
18
+ }
19
+ return parts.join(' ');
20
+ }
13
21
  const inputSchema = {
14
22
  absoluteProjectPath,
15
23
  absoluteCurrentWorkingDirectory,
24
+ account: z
25
+ .string()
26
+ .optional()
27
+ .describe('Optional: the HubSpot account ID or name to inspect. If omitted and several accounts are available, you will be asked to choose.'),
16
28
  buildId: z
17
29
  .number()
18
30
  .optional()
@@ -104,19 +116,46 @@ function formatBuildDetails(build) {
104
116
  return lines.join('\n');
105
117
  }
106
118
  export class GetBuildStatusTool extends Tool {
107
- constructor(mcpServer) {
108
- super(mcpServer);
119
+ constructor(mcpServer, logger) {
120
+ super(mcpServer, logger, TOOL_NAME);
109
121
  }
110
- async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, buildId, limit, }) {
111
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
112
- await trackToolUsage(TOOL_NAME);
122
+ async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, account, buildId, limit, }) {
123
+ setupHubSpotConfig(absoluteProjectPath);
113
124
  try {
114
- const accountId = getConfigDefaultAccountIfExists()?.accountId;
125
+ const { projectConfig, projectDir } = getProjectConfig(absoluteProjectPath);
126
+ const { candidates, recommended } = await discoverAccountTargets({
127
+ projectDir,
128
+ projectConfig,
129
+ explicitAccount: account,
130
+ });
131
+ let accountId = recommended?.accountId;
132
+ // discoverAccountTargets ignores explicitAccount when the project has
133
+ // profiles, so resolve a re-supplied account against the candidates here.
134
+ if (!accountId && account) {
135
+ const match = candidates.find(candidate => String(candidate.accountId) === account ||
136
+ candidate.accountName === account);
137
+ accountId = match?.accountId;
138
+ }
139
+ if (!accountId && candidates.length > 0) {
140
+ const elicitation = await this.elicit({
141
+ message: 'Select the HubSpot account to use for this project.',
142
+ fields: {
143
+ account: enumField('HubSpot account', 'The account to inspect builds for.', candidates.map(candidate => String(candidate.accountId)), candidates.map(formatAccountChoice)),
144
+ },
145
+ required: ['account'],
146
+ });
147
+ if (elicitation?.action === 'accept' && elicitation.content) {
148
+ accountId = Number(elicitation.content.account);
149
+ }
150
+ }
115
151
  if (!accountId) {
116
- return formatTextContents(absoluteCurrentWorkingDirectory, 'No account ID found. Please run `hs account auth` to configure an account, or set a default account with `hs account use <account>`');
152
+ if (candidates.length > 0) {
153
+ return formatTextContents(absoluteCurrentWorkingDirectory, `Several HubSpot accounts are available. Ask the user which to use, then call get-build-status again with the account argument set to one of: ${candidates
154
+ .map(candidate => `${formatAccountChoice(candidate)} (id ${candidate.accountId})`)
155
+ .join(', ')}.`);
156
+ }
157
+ return formatTextContents(absoluteCurrentWorkingDirectory, 'No account ID found. Call the auth-account tool to authenticate a HubSpot account.');
117
158
  }
118
- const { projectConfig, projectDir } = await getProjectConfig(absoluteProjectPath);
119
- validateProjectConfig(projectConfig, projectDir);
120
159
  const projectName = projectConfig.name;
121
160
  let output;
122
161
  if (buildId) {
@@ -137,6 +176,10 @@ export class GetBuildStatusTool extends Tool {
137
176
  return formatTextContents(absoluteCurrentWorkingDirectory, output);
138
177
  }
139
178
  catch (error) {
179
+ this.logger.debug(TOOL_NAME, {
180
+ message: 'Handler caught error',
181
+ error: error instanceof Error ? error.message : String(error),
182
+ });
140
183
  let errorMessage;
141
184
  if (isHubSpotHttpError(error)) {
142
185
  errorMessage = error.toString();
@@ -153,13 +196,13 @@ export class GetBuildStatusTool extends Tool {
153
196
  register() {
154
197
  return this.mcpServer.registerTool(TOOL_NAME, {
155
198
  title: 'Get HubSpot Projects Build Status and Errors',
156
- description: 'Retrieves build status and error messages for HubSpot projects. When buildId is omitted, shows recent builds with their status(default 3) - use this to find the latest builds when troubleshooting. When buildId is provided, shows detailed error information for that specific build. Displays buildErrorMessage and subbuild failures to help diagnose build issues.',
199
+ description: 'Retrieves build status and error messages for HubSpot projects. When buildId is omitted, shows recent builds with their status(default 3) - use this to find the latest builds when troubleshooting. When buildId is provided, shows detailed error information for that specific build. Displays buildErrorMessage and subbuild failures to help diagnose build issues. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
157
200
  inputSchema,
158
201
  annotations: {
159
202
  readOnlyHint: true,
160
203
  openWorldHint: true,
161
204
  idempotentHint: true,
162
205
  },
163
- }, this.handler);
206
+ }, (input, extra) => this.wrappedHandler(input, extra));
164
207
  }
165
208
  }
@@ -1,15 +1,18 @@
1
- import { TextContentResponse, Tool } from '../../types.js';
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool } from '../../Tool.js';
2
3
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
3
5
  import { z } from 'zod';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteCurrentWorkingDirectory: z.ZodString;
8
+ absoluteProjectPath: z.ZodOptional<z.ZodString>;
6
9
  platformVersion: z.ZodString;
7
10
  featureType: z.ZodString;
8
11
  }, z.core.$strip>;
9
12
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
10
13
  export declare class GetConfigValuesTool extends Tool<InputSchemaType> {
11
- constructor(mcpServer: McpServer);
12
- handler({ platformVersion, featureType, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<TextContentResponse>;
14
+ constructor(mcpServer: McpServer, logger: McpLogger);
15
+ handler({ platformVersion, featureType, absoluteCurrentWorkingDirectory, absoluteProjectPath, }: InputSchemaType): Promise<McpToolResponse>;
13
16
  register(): RegisteredTool;
14
17
  }
15
18
  export {};
@@ -1,14 +1,15 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
3
  import { formatTextContents } from '../../utils/content.js';
4
- import { absoluteCurrentWorkingDirectory } from './constants.js';
4
+ import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
5
5
  import { getIntermediateRepresentationSchema } from '@hubspot/project-parsing-lib/schema';
6
6
  import { mapToInternalType } from '@hubspot/project-parsing-lib/transform';
7
- import { isV2Project } from '../../../lib/projects/platformVersion.js';
8
- import { getConfigDefaultAccountIfExists } from '@hubspot/local-dev-lib/config';
7
+ import { isLegacyProject } from '@hubspot/project-parsing-lib/projects';
9
8
  import { setupHubSpotConfig } from '../../utils/config.js';
9
+ import { discoverAccountTargets } from '../../../lib/accountTargetDiscovery.js';
10
10
  const inputSchema = {
11
11
  absoluteCurrentWorkingDirectory,
12
+ absoluteProjectPath: absoluteProjectPath.optional(),
12
13
  platformVersion: z
13
14
  .string()
14
15
  .describe('The platform version for the project. Located in the hsproject.json file.'),
@@ -22,18 +23,19 @@ const inputSchemaZodObject = z.object({
22
23
  });
23
24
  const toolName = 'get-feature-config-schema';
24
25
  export class GetConfigValuesTool extends Tool {
25
- constructor(mcpServer) {
26
- super(mcpServer);
26
+ constructor(mcpServer, logger) {
27
+ super(mcpServer, logger, toolName);
27
28
  }
28
- async handler({ platformVersion, featureType, absoluteCurrentWorkingDirectory, }) {
29
- setupHubSpotConfig(absoluteCurrentWorkingDirectory);
29
+ async handler({ platformVersion, featureType, absoluteCurrentWorkingDirectory, absoluteProjectPath, }) {
30
+ setupHubSpotConfig(absoluteProjectPath ?? absoluteCurrentWorkingDirectory);
30
31
  try {
31
- if (!isV2Project(platformVersion)) {
32
+ if (isLegacyProject(platformVersion)) {
32
33
  return formatTextContents(`Can only be used on projects with a minimum platformVersion of 2025.2`);
33
34
  }
34
- const accountId = getConfigDefaultAccountIfExists()?.accountId;
35
+ const { recommended } = await discoverAccountTargets();
36
+ const accountId = recommended?.accountId;
35
37
  if (!accountId) {
36
- const authErrorMessage = `No account ID found. Please run \`hs account auth\` to configure an account, or set a default account with \`hs account use <account>\``;
38
+ const authErrorMessage = `No account ID found. Call the auth-account tool to authenticate a HubSpot account.`;
37
39
  return formatTextContents(authErrorMessage);
38
40
  }
39
41
  const schema = await getIntermediateRepresentationSchema({
@@ -46,7 +48,12 @@ export class GetConfigValuesTool extends Tool {
46
48
  return formatTextContents(JSON.stringify({ config: schema[internalComponentType] }));
47
49
  }
48
50
  }
49
- catch (error) { }
51
+ catch (error) {
52
+ this.logger.debug(toolName, {
53
+ message: 'Handler caught error',
54
+ error: error instanceof Error ? error.message : String(error),
55
+ });
56
+ }
50
57
  return formatTextContents(`Unable to locate JSON schema for type ${featureType}`);
51
58
  }
52
59
  register() {
@@ -60,6 +67,6 @@ export class GetConfigValuesTool extends Tool {
60
67
  readOnlyHint: true,
61
68
  openWorldHint: false,
62
69
  },
63
- }, this.handler);
70
+ }, (input, extra) => this.wrappedHandler(input, extra));
64
71
  }
65
72
  }
@@ -1,5 +1,7 @@
1
- import { TextContentResponse, Tool } from '../../types.js';
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool } from '../../Tool.js';
2
3
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
3
5
  import { z } from 'zod';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -12,8 +14,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
12
14
  }, z.core.$strip>;
13
15
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
14
16
  export declare class GuidedWalkthroughTool extends Tool<InputSchemaType> {
15
- constructor(mcpServer: McpServer);
16
- handler({ command, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<TextContentResponse>;
17
+ constructor(mcpServer: McpServer, logger: McpLogger);
18
+ handler({ command, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<McpToolResponse>;
17
19
  register(): RegisteredTool;
18
20
  }
19
21
  export {};
@@ -1,8 +1,7 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
3
  import { execAsync } from '../../utils/command.js';
4
4
  import { formatTextContents } from '../../utils/content.js';
5
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
6
5
  import { absoluteCurrentWorkingDirectory } from './constants.js';
7
6
  import { setupHubSpotConfig } from '../../utils/config.js';
8
7
  const nextCommands = {
@@ -24,12 +23,11 @@ const inputSchemaZodObject = z.object({
24
23
  });
25
24
  const toolName = 'guided-walkthrough-cli';
26
25
  export class GuidedWalkthroughTool extends Tool {
27
- constructor(mcpServer) {
28
- super(mcpServer);
26
+ constructor(mcpServer, logger) {
27
+ super(mcpServer, logger, toolName);
29
28
  }
30
29
  async handler({ command, absoluteCurrentWorkingDirectory, }) {
31
30
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
32
- await trackToolUsage(toolName);
33
31
  if (command) {
34
32
  const { stdout } = await execAsync(`${command} --help`);
35
33
  return formatTextContents(`Display this help output for the user amd wait for them to acknowledge: ${stdout}. ${nextCommands[command] ? `Once they are ready, A good command to look at next is ${nextCommands[command]}` : ''}`);
@@ -45,6 +43,6 @@ export class GuidedWalkthroughTool extends Tool {
45
43
  readOnlyHint: true,
46
44
  openWorldHint: false,
47
45
  },
48
- }, this.handler);
46
+ }, (input, extra) => this.wrappedHandler(input, extra));
49
47
  }
50
48
  }
@@ -0,0 +1,29 @@
1
+ import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
2
+ import { McpLogger } from '../../utils/logger.js';
3
+ import z from 'zod';
4
+ import { McpToolResponse } from '../../types.js';
5
+ import { Tool } from '../../Tool.js';
6
+ declare const inputSchema: {
7
+ absoluteCurrentWorkingDirectory: z.ZodString;
8
+ knowledgeSearchQuery: z.ZodString;
9
+ knowledgeSearchLimit: z.ZodDefault<z.ZodNumber>;
10
+ };
11
+ export interface KnowledgeSearchResponse {
12
+ total: number;
13
+ results: {
14
+ title: string;
15
+ description: string;
16
+ url: string;
17
+ score: number;
18
+ }[];
19
+ }
20
+ type InputSchemaType = z.infer<z.ZodObject<typeof inputSchema>>;
21
+ export declare class KnowledgeSearchTool extends Tool<InputSchemaType> {
22
+ constructor(mcpServer: McpServer, logger: McpLogger);
23
+ protected getTrackingMeta(_input: InputSchemaType): {
24
+ [key: string]: string;
25
+ } | undefined;
26
+ handler({ knowledgeSearchQuery, knowledgeSearchLimit, absoluteCurrentWorkingDirectory, }: InputSchemaType): Promise<McpToolResponse>;
27
+ register(): RegisteredTool;
28
+ }
29
+ export {};
@@ -0,0 +1,79 @@
1
+ import { http } from '@hubspot/local-dev-lib/http/unauthed';
2
+ import z from 'zod';
3
+ import { Tool } from '../../Tool.js';
4
+ import { formatTextContents } from '../../utils/content.js';
5
+ import { absoluteCurrentWorkingDirectory, knowledgeSearchQuery, } from './constants.js';
6
+ import { isHubSpotHttpError } from '@hubspot/local-dev-lib/errors/index';
7
+ import { setupHubSpotConfig } from '../../utils/config.js';
8
+ import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
9
+ const knowledgeSearchLimit = z
10
+ .number()
11
+ .int()
12
+ .min(1)
13
+ .max(20)
14
+ .default(5)
15
+ .describe('Maximum number of results to return.');
16
+ const inputSchema = {
17
+ absoluteCurrentWorkingDirectory,
18
+ knowledgeSearchQuery,
19
+ knowledgeSearchLimit,
20
+ };
21
+ const toolName = 'search-knowledge-base';
22
+ // The HubSpot Knowledge Base (knowledge.hubspot.com) is hosted on the blog
23
+ // system in HubSpot's own portal, so results are scoped by domain and portal.
24
+ const KNOWLEDGE_BASE_DOMAIN = 'knowledge.hubspot.com';
25
+ const KNOWLEDGE_BASE_PORTAL_ID = 53;
26
+ export class KnowledgeSearchTool extends Tool {
27
+ constructor(mcpServer, logger) {
28
+ super(mcpServer, logger, toolName);
29
+ }
30
+ getTrackingMeta(_input) {
31
+ return { mode: 'knowledge-search' };
32
+ }
33
+ async handler({ knowledgeSearchQuery, knowledgeSearchLimit, absoluteCurrentWorkingDirectory, }) {
34
+ setupHubSpotConfig(absoluteCurrentWorkingDirectory);
35
+ try {
36
+ const params = new URLSearchParams({
37
+ term: knowledgeSearchQuery,
38
+ type: 'BLOG_POST',
39
+ domain: KNOWLEDGE_BASE_DOMAIN,
40
+ portalId: String(KNOWLEDGE_BASE_PORTAL_ID),
41
+ limit: String(knowledgeSearchLimit),
42
+ });
43
+ const response = await http.get({
44
+ url: `https://api.hubapi.com/contentsearch/v2/search?${params}`,
45
+ });
46
+ const { total, results } = response.data;
47
+ if (!results || results.length === 0) {
48
+ return formatTextContents('No knowledge base articles found for your query.');
49
+ }
50
+ const formattedResults = results
51
+ .map(result => `**${result.title}**\n${result.description}\nURL: ${result.url}\nScore: ${result.score}\n---\n`)
52
+ .join('\n');
53
+ const successMessage = `Found ${total} results, showing top ${results.length}:\n\n${formattedResults}`;
54
+ return formatTextContents(successMessage);
55
+ }
56
+ catch (error) {
57
+ this.logger.debug(toolName, {
58
+ message: 'Handler caught error',
59
+ error: getErrorMessage(error),
60
+ });
61
+ if (isHubSpotHttpError(error)) {
62
+ return formatTextContents(error.toString());
63
+ }
64
+ const errorMessage = `Error searching the knowledge base: ${getErrorMessage(error)}`;
65
+ return formatTextContents(errorMessage);
66
+ }
67
+ }
68
+ register() {
69
+ return this.mcpServer.registerTool(toolName, {
70
+ title: 'Search HubSpot Knowledge Base',
71
+ description: 'Use this for questions about how to use HubSpot products and features, account and subscription settings, and general product how-to guidance. This searches the HubSpot Knowledge Base (knowledge.hubspot.com) and returns the most relevant help articles, each with a URL. Use `search-docs` instead for developer APIs, SDKs, and platform reference.',
72
+ inputSchema,
73
+ annotations: {
74
+ readOnlyHint: true,
75
+ openWorldHint: true,
76
+ },
77
+ }, (input, extra) => this.wrappedHandler(input, extra));
78
+ }
79
+ }
@@ -1,6 +1,8 @@
1
1
  import z from 'zod';
2
2
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
3
- import { TextContentResponse, Tool } from '../../types.js';
3
+ import { McpLogger } from '../../utils/logger.js';
4
+ import { McpToolResponse } from '../../types.js';
5
+ import { Tool, ToolExtra } from '../../Tool.js';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteProjectPath: z.ZodString;
6
8
  absoluteCurrentWorkingDirectory: z.ZodString;
@@ -9,8 +11,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
9
11
  }, z.z.core.$strip>;
10
12
  type InputSchemaType = z.infer<typeof inputSchemaZodObject>;
11
13
  export declare class UploadProjectTools extends Tool<InputSchemaType> {
12
- constructor(mcpServer: McpServer);
13
- handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, profile, uploadMessage, }: InputSchemaType): Promise<TextContentResponse>;
14
+ constructor(mcpServer: McpServer, logger: McpLogger);
15
+ handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, profile, uploadMessage, }: InputSchemaType, extra?: ToolExtra): Promise<McpToolResponse>;
14
16
  register(): RegisteredTool;
15
17
  }
16
18
  export {};
@@ -2,13 +2,13 @@ import path from 'path';
2
2
  import z from 'zod';
3
3
  import { getAllHsProfiles } from '@hubspot/project-parsing-lib/profiles';
4
4
  import { getProjectConfig } from '../../../lib/projects/config.js';
5
- import { Tool } from '../../types.js';
6
- import { runCommandInDir } from '../../utils/command.js';
5
+ import { Tool } from '../../Tool.js';
7
6
  import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
8
7
  import { formatTextContent, formatTextContents } from '../../utils/content.js';
9
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
10
- import { addFlag } from '../../utils/command.js';
8
+ import { HubSpotCommand } from '../../utils/command.js';
11
9
  import { setupHubSpotConfig } from '../../utils/config.js';
10
+ import { parseCommandJsonOutput } from '../../utils/json.js';
11
+ import { ProjectUploadSchema } from '../../../lib/jsonOutput/projectUpload.js';
12
12
  const inputSchema = {
13
13
  absoluteProjectPath,
14
14
  absoluteCurrentWorkingDirectory,
@@ -17,7 +17,7 @@ const inputSchema = {
17
17
  .describe('A 1 sentence message that concisely describes the changes that are being uploaded.'),
18
18
  profile: z
19
19
  .optional(z.string())
20
- .describe('CRITICAL: If the user has not explicitly specified a profile name, you MUST ask them which profile to use. NEVER automatically choose a profile based on files you see in the directory (e.g., seeing "hsprofile.prod.json" does NOT mean you should use "prod"). The profile to be used for the upload. All projects configured to use profiles must specify a profile when uploading. Profile files have the following format: "hsprofile.<profile>.json".'),
20
+ .describe('The profile to use for the upload. Only required for projects configured with profiles. If the project uses profiles and the user has not specified one, ask them rather than inferring from filenames in the directory. NEVER automatically choose a profile based on files you see. Profile files have the format: "hsprofile.<profile>.json".'),
21
21
  };
22
22
  // eslint-disable-next-line @typescript-eslint/no-unused-vars
23
23
  const inputSchemaZodObject = z.object({
@@ -25,30 +25,34 @@ const inputSchemaZodObject = z.object({
25
25
  });
26
26
  const toolName = 'upload-project';
27
27
  export class UploadProjectTools extends Tool {
28
- constructor(mcpServer) {
29
- super(mcpServer);
28
+ constructor(mcpServer, logger) {
29
+ super(mcpServer, logger, toolName);
30
30
  }
31
- async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, profile, uploadMessage, }) {
31
+ async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, profile, uploadMessage, }, extra) {
32
32
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
33
- await trackToolUsage(toolName);
34
- let command = addFlag('hs project upload', 'force-create', true);
33
+ const command = new HubSpotCommand('project upload', [
34
+ { name: 'force', value: true },
35
+ { name: 'json', value: true },
36
+ ]);
35
37
  const content = [];
36
38
  if (uploadMessage) {
37
- command = addFlag(command, 'message', uploadMessage);
39
+ command.addFlag('message', uploadMessage);
38
40
  }
39
41
  if (profile) {
40
- command = addFlag(command, 'profile', profile);
42
+ command.addFlag('profile', profile);
41
43
  }
42
44
  else {
43
45
  let hasProfiles = false;
44
46
  try {
45
- const { projectConfig } = await getProjectConfig(absoluteProjectPath);
46
- if (projectConfig) {
47
- const profiles = await getAllHsProfiles(path.join(absoluteProjectPath, projectConfig.srcDir));
48
- hasProfiles = profiles.length > 0;
49
- }
47
+ const { projectConfig } = getProjectConfig(absoluteProjectPath);
48
+ const profiles = await getAllHsProfiles(path.join(absoluteProjectPath, projectConfig.srcDir));
49
+ hasProfiles = profiles.length > 0;
50
50
  }
51
51
  catch (e) {
52
+ this.logger.debug(toolName, {
53
+ message: 'Handler caught error checking for profiles',
54
+ error: e instanceof Error ? e.message : String(e),
55
+ });
52
56
  // If any of these checks fail, the safest thing to do is to assume there are no profiles.
53
57
  hasProfiles = false;
54
58
  }
@@ -59,25 +63,29 @@ export class UploadProjectTools extends Tool {
59
63
  if (content.length > 0) {
60
64
  return {
61
65
  content,
66
+ structuredContent: {},
62
67
  };
63
68
  }
64
- const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, command);
69
+ const { stdout, stderr } = await this.runCommand(absoluteProjectPath, command, extra);
65
70
  const response = await formatTextContents(stdout, stderr);
66
71
  // Add reminder about cards needing to be added to views
67
72
  response.content.push(formatTextContent('\nIMPORTANT: If this project contains cards, remember that uploading does NOT make them live automatically. Cards must be manually added to a view in HubSpot to become visible to users.'));
73
+ response.structuredContent =
74
+ parseCommandJsonOutput(stdout, ProjectUploadSchema, this.logger, toolName) ?? {};
68
75
  return response;
69
76
  }
70
77
  register() {
71
78
  return this.mcpServer.registerTool(toolName, {
72
79
  title: 'Upload HubSpot Project',
73
- description: 'DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive. Uploads the HubSpot project in current working directory. If the project does not exist, it will be created. MUST be ran from within the project directory. IMPORTANT: Uploading a project does NOT automatically make cards live or visible to users. Cards must be manually added to a view in HubSpot after upload to become visible.',
80
+ description: 'DO NOT run this tool unless the user specifies they would like to upload the project, it is potentially destructive. Uploads the HubSpot project in current working directory. If the project does not exist, it will be created. MUST be ran from within the project directory. IMPORTANT: Uploading a project does NOT automatically make cards live or visible to users. Cards must be manually added to a view in HubSpot after upload to become visible. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
74
81
  inputSchema,
82
+ outputSchema: ProjectUploadSchema.shape,
75
83
  annotations: {
76
84
  readOnlyHint: false,
77
85
  destructiveHint: true,
78
86
  idempotentHint: true,
79
87
  openWorldHint: true,
80
88
  },
81
- }, this.handler);
89
+ }, (input, extra) => this.wrappedHandler(input, extra));
82
90
  }
83
91
  }
@@ -1,5 +1,7 @@
1
- import { TextContentResponse, Tool } from '../../types.js';
1
+ import { McpToolResponse } from '../../types.js';
2
+ import { Tool, ToolExtra } from '../../Tool.js';
2
3
  import { McpServer, RegisteredTool } from '@modelcontextprotocol/sdk/server/mcp.js';
4
+ import { McpLogger } from '../../utils/logger.js';
3
5
  import { z } from 'zod';
4
6
  declare const inputSchemaZodObject: z.ZodObject<{
5
7
  absoluteProjectPath: z.ZodString;
@@ -7,8 +9,8 @@ declare const inputSchemaZodObject: z.ZodObject<{
7
9
  }, z.core.$strip>;
8
10
  export type CreateProjectInputSchema = z.infer<typeof inputSchemaZodObject>;
9
11
  export declare class ValidateProjectTool extends Tool<CreateProjectInputSchema> {
10
- constructor(mcpServer: McpServer);
11
- handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, }: CreateProjectInputSchema): Promise<TextContentResponse>;
12
+ constructor(mcpServer: McpServer, logger: McpLogger);
13
+ handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, }: CreateProjectInputSchema, extra?: ToolExtra): Promise<McpToolResponse>;
12
14
  register(): RegisteredTool;
13
15
  }
14
16
  export {};
@@ -1,11 +1,12 @@
1
- import { Tool } from '../../types.js';
1
+ import { Tool } from '../../Tool.js';
2
2
  import { z } from 'zod';
3
3
  import { absoluteCurrentWorkingDirectory, absoluteProjectPath, } from './constants.js';
4
- import { runCommandInDir } from '../../utils/command.js';
5
- import { formatTextContents } from '../../utils/content.js';
6
- import { trackToolUsage } from '../../utils/toolUsageTracking.js';
4
+ import { formatTextContents, formatErrorTextContents, } from '../../utils/content.js';
7
5
  import { setupHubSpotConfig } from '../../utils/config.js';
8
6
  import { getErrorMessage } from '../../../lib/errorHandlers/index.js';
7
+ import { HubSpotCommand, getCommandResultsFromError, } from '../../utils/command.js';
8
+ import { parseCommandJsonOutput } from '../../utils/json.js';
9
+ import { ProjectValidateSchema } from '../../../lib/jsonOutput/projectValidate.js';
9
10
  const inputSchema = {
10
11
  absoluteProjectPath,
11
12
  absoluteCurrentWorkingDirectory,
@@ -14,29 +15,47 @@ const inputSchema = {
14
15
  const inputSchemaZodObject = z.object({ ...inputSchema });
15
16
  const toolName = 'validate-project';
16
17
  export class ValidateProjectTool extends Tool {
17
- constructor(mcpServer) {
18
- super(mcpServer);
18
+ constructor(mcpServer, logger) {
19
+ super(mcpServer, logger, toolName);
19
20
  }
20
- async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, }) {
21
+ async handler({ absoluteProjectPath, absoluteCurrentWorkingDirectory, }, extra) {
21
22
  setupHubSpotConfig(absoluteCurrentWorkingDirectory);
22
- await trackToolUsage(toolName);
23
+ const command = new HubSpotCommand('project validate', [
24
+ { name: 'json', value: true },
25
+ ]);
26
+ let stdout = '';
27
+ let stderr = '';
23
28
  try {
24
- const { stdout, stderr } = await runCommandInDir(absoluteProjectPath, 'hs project validate');
25
- return formatTextContents(stdout, stderr);
29
+ ({ stdout, stderr } = await this.runCommand(absoluteProjectPath, command, extra));
26
30
  }
27
31
  catch (error) {
28
- return formatTextContents(getErrorMessage(error));
32
+ this.logger.debug(toolName, {
33
+ message: 'Handler caught error',
34
+ error: getErrorMessage(error),
35
+ });
36
+ ({ stdout, stderr } = getCommandResultsFromError(error));
37
+ if (!stdout) {
38
+ return formatErrorTextContents(getErrorMessage(error));
39
+ }
29
40
  }
41
+ const structuredContent = parseCommandJsonOutput(stdout, ProjectValidateSchema, this.logger, toolName);
42
+ if (!structuredContent) {
43
+ return formatErrorTextContents(stdout, stderr);
44
+ }
45
+ const response = await formatTextContents(stdout, stderr);
46
+ response.structuredContent = structuredContent;
47
+ return response;
30
48
  }
31
49
  register() {
32
50
  return this.mcpServer.registerTool(toolName, {
33
51
  title: 'Validate HubSpot Project',
34
- description: 'Validates the HubSpot project and its configuration files. This tool does not need to be ran before uploading the project',
52
+ description: 'Validates the HubSpot project and its configuration files. This tool does not need to be ran before uploading the project. If you do not know the project path, use the find-projects tool first to locate HubSpot projects in the workspace.',
35
53
  inputSchema,
54
+ outputSchema: ProjectValidateSchema.shape,
36
55
  annotations: {
37
56
  readOnlyHint: true,
38
57
  openWorldHint: false,
39
58
  },
40
- }, this.handler);
59
+ }, (input, extra) => this.wrappedHandler(input, extra));
41
60
  }
42
61
  }
@@ -4,15 +4,17 @@ export declare const absoluteCurrentWorkingDirectory: z.ZodString;
4
4
  export declare const features: z.ZodOptional<z.ZodArray<z.ZodEnum<{
5
5
  card: "card";
6
6
  settings: "settings";
7
+ "crm-bulk-action": "crm-bulk-action";
7
8
  "app-event": "app-event";
8
9
  "workflow-action-tool": "workflow-action-tool";
9
10
  page: "page";
10
11
  webhooks: "webhooks";
11
- "workflow-action": "workflow-action";
12
12
  "app-function": "app-function";
13
- "app-function-endpoint": "app-function-endpoint";
14
13
  "app-object": "app-object";
15
14
  scim: "scim";
15
+ "workflow-action": "workflow-action";
16
+ "app-function-endpoint": "app-function-endpoint";
16
17
  }>>>;
17
18
  export declare const docsSearchQuery: z.ZodString;
18
19
  export declare const docUrl: z.ZodString;
20
+ export declare const knowledgeSearchQuery: z.ZodString;
@@ -18,8 +18,9 @@ export const features = z
18
18
  'app-event',
19
19
  'scim',
20
20
  'page',
21
+ 'crm-bulk-action',
21
22
  ]))
22
- .describe('The features to include in the project, multiple options can be selected. "app-function" is also known as a private serverless function. "app-function-endpoint" is a serverless functions that is publicly accessible via endpoint. "workflow-action" is also known as a custom workflow action. "workflow-action-tool" is also known as agent tools.')
23
+ .describe('The features to include in the project, multiple options can be selected. These are features of a developer-platform app, not CMS website assets. "app-function" is a private serverless function that runs inside the app and is not publicly accessible. It is distinct from a CMS serverless function, which is created with create-cms-function. "app-function-endpoint" is an app serverless function that is publicly accessible via an endpoint. "workflow-action" is also known as a custom workflow action. "workflow-action-tool" is also known as agent tools. "crm-bulk-action" is an app actions extension that lets users act on multiple CRM records at once.')
23
24
  .optional();
24
25
  export const docsSearchQuery = z
25
26
  .string()
@@ -27,3 +28,6 @@ export const docsSearchQuery = z
27
28
  export const docUrl = z
28
29
  .string()
29
30
  .describe('The URL of the HubSpot Developer Documentation to fetch.');
31
+ export const knowledgeSearchQuery = z
32
+ .string()
33
+ .describe('The question to search the general HubSpot Knowledge Base for. Use natural language, for example "how do I set up a workflow" or "what is included in the Marketing Hub Professional plan".');