@hubspot/cli 8.3.0-beta.0 → 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 (814) 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/components.js +3 -2
  257. package/lib/projects/config.d.ts +6 -5
  258. package/lib/projects/config.js +7 -38
  259. package/lib/projects/create/index.js +2 -2
  260. package/lib/projects/create/legacy.js +2 -2
  261. package/lib/projects/create/tracking.d.ts +1 -0
  262. package/lib/projects/create/tracking.js +27 -0
  263. package/lib/projects/create/v2.js +5 -5
  264. package/lib/projects/delete.d.ts +13 -0
  265. package/lib/projects/delete.js +206 -0
  266. package/lib/projects/deploy.d.ts +1 -1
  267. package/lib/projects/deploy.js +2 -2
  268. package/lib/projects/installApp.d.ts +58 -0
  269. package/lib/projects/installApp.js +283 -0
  270. package/lib/projects/localDev/AppDevModeInterface.d.ts +0 -3
  271. package/lib/projects/localDev/AppDevModeInterface.js +33 -55
  272. package/lib/projects/localDev/DevSessionManager.d.ts +8 -5
  273. package/lib/projects/localDev/DevSessionManager.js +35 -49
  274. package/lib/projects/localDev/LocalDevLogger.d.ts +4 -0
  275. package/lib/projects/localDev/LocalDevLogger.js +18 -0
  276. package/lib/projects/localDev/LocalDevProcess.d.ts +11 -1
  277. package/lib/projects/localDev/LocalDevProcess.js +104 -19
  278. package/lib/projects/localDev/LocalDevState.d.ts +9 -2
  279. package/lib/projects/localDev/LocalDevState.js +21 -1
  280. package/lib/projects/localDev/LocalDevWatcher.js +1 -1
  281. package/lib/projects/localDev/LocalDevWebsocketServer.d.ts +1 -0
  282. package/lib/projects/localDev/LocalDevWebsocketServer.js +24 -2
  283. package/lib/projects/localDev/UIExtensionsDevModeInterface.js +2 -0
  284. package/lib/projects/localDev/helpers/account.d.ts +1 -7
  285. package/lib/projects/localDev/helpers/account.js +8 -90
  286. package/lib/projects/localDev/helpers/process.d.ts +1 -1
  287. package/lib/projects/localDev/helpers/process.js +4 -10
  288. package/lib/projects/localDev/helpers/project.d.ts +8 -6
  289. package/lib/projects/localDev/helpers/project.js +80 -29
  290. package/lib/projects/localDev/localDevWebsocketServerUtils.d.ts +2 -1
  291. package/lib/projects/localDev/localDevWebsocketServerUtils.js +3 -0
  292. package/lib/projects/npmAuditOnUpload.d.ts +10 -0
  293. package/lib/projects/npmAuditOnUpload.js +73 -0
  294. package/lib/projects/pollProjectBuildAndDeploy.d.ts +5 -1
  295. package/lib/projects/pollProjectBuildAndDeploy.js +3 -2
  296. package/lib/projects/preview.d.ts +7 -0
  297. package/lib/projects/preview.js +48 -0
  298. package/lib/projects/projectInfo.d.ts +5 -0
  299. package/lib/projects/projectInfo.js +82 -0
  300. package/lib/projects/projectProfiles.d.ts +3 -3
  301. package/lib/projects/projectProfiles.js +11 -18
  302. package/lib/projects/release.d.ts +4 -0
  303. package/lib/projects/release.js +90 -0
  304. package/lib/projects/ui.d.ts +1 -0
  305. package/lib/projects/ui.js +14 -0
  306. package/lib/projects/uieLinting.d.ts +23 -3
  307. package/lib/projects/uieLinting.js +134 -28
  308. package/lib/projects/upload.d.ts +17 -3
  309. package/lib/projects/upload.js +65 -14
  310. package/lib/projects/urls.d.ts +0 -1
  311. package/lib/projects/urls.js +6 -13
  312. package/lib/projects/validate.d.ts +18 -0
  313. package/lib/projects/validate.js +142 -0
  314. package/lib/projects/validateLintConfigOnUpload.d.ts +9 -0
  315. package/lib/projects/validateLintConfigOnUpload.js +46 -0
  316. package/lib/projects/workspaces.d.ts +60 -0
  317. package/lib/projects/workspaces.js +404 -0
  318. package/lib/prompts/createApiSamplePrompt.js +4 -0
  319. package/lib/prompts/personalAccessKeyPrompt.d.ts +2 -5
  320. package/lib/prompts/personalAccessKeyPrompt.js +7 -5
  321. package/lib/prompts/projectDevTargetAccountPrompt.d.ts +1 -0
  322. package/lib/prompts/projectDevTargetAccountPrompt.js +13 -2
  323. package/lib/prompts/projectProfilePrompt.d.ts +2 -0
  324. package/lib/prompts/projectProfilePrompt.js +46 -0
  325. package/lib/prompts/projectsLogsPrompt.js +3 -0
  326. package/lib/prompts/promptUtils.js +4 -2
  327. package/lib/prompts/selectAppPrompt.js +1 -0
  328. package/lib/prompts/selectHubDBTablePrompt.js +2 -2
  329. package/lib/prompts/selectPublicAppForMigrationPrompt.js +2 -2
  330. package/lib/prompts/setAsDefaultAccountPrompt.js +2 -1
  331. package/lib/serverlessLogs.js +2 -2
  332. package/lib/testUtils.d.ts +1 -0
  333. package/lib/testUtils.js +14 -0
  334. package/lib/theme/cmsDevServerProcess.d.ts +2 -0
  335. package/lib/theme/cmsDevServerProcess.js +8 -7
  336. package/lib/theme/migrate.js +1 -4
  337. package/lib/ui/SpinniesManager.d.ts +2 -0
  338. package/lib/ui/SpinniesManager.js +34 -10
  339. package/lib/ui/accountTable.d.ts +8 -0
  340. package/lib/ui/accountTable.js +67 -0
  341. package/lib/ui/appLogs.d.ts +32 -0
  342. package/lib/ui/appLogs.js +175 -0
  343. package/lib/ui/index.js +2 -2
  344. package/lib/ui/spinniesUtils.d.ts +0 -1
  345. package/lib/ui/spinniesUtils.js +6 -16
  346. package/lib/ui/supportsColor.d.ts +4 -0
  347. package/lib/ui/supportsColor.js +25 -6
  348. package/lib/usageTracking.d.ts +10 -20
  349. package/lib/usageTracking.js +77 -30
  350. package/lib/yargs/makeWrappedYargsHandler.d.ts +7 -0
  351. package/lib/yargs/makeWrappedYargsHandler.js +179 -0
  352. package/lib/yargs/makeYargsBuilder.d.ts +13 -0
  353. package/lib/yargs/makeYargsBuilder.js +33 -0
  354. package/lib/yargs/parseYargsOrExit.d.ts +4 -0
  355. package/lib/yargs/parseYargsOrExit.js +25 -0
  356. package/lib/yargs/strictEnforceBoolean.d.ts +1 -0
  357. package/lib/yargs/strictEnforceBoolean.js +13 -0
  358. package/lib/yargsUtils.d.ts +3 -16
  359. package/lib/yargsUtils.js +3 -48
  360. package/mcp-server/Tool.d.ts +25 -0
  361. package/mcp-server/Tool.js +83 -0
  362. package/mcp-server/server.js +63 -3
  363. package/mcp-server/tools/cms/HsCreateFunctionTool.d.ts +5 -3
  364. package/mcp-server/tools/cms/HsCreateFunctionTool.js +18 -23
  365. package/mcp-server/tools/cms/HsCreateModuleTool.d.ts +5 -3
  366. package/mcp-server/tools/cms/HsCreateModuleTool.js +21 -26
  367. package/mcp-server/tools/cms/HsCreateTemplateTool.d.ts +5 -3
  368. package/mcp-server/tools/cms/HsCreateTemplateTool.js +16 -16
  369. package/mcp-server/tools/cms/HsFunctionLogsTool.d.ts +5 -3
  370. package/mcp-server/tools/cms/HsFunctionLogsTool.js +17 -16
  371. package/mcp-server/tools/cms/HsListFunctionsTool.d.ts +5 -3
  372. package/mcp-server/tools/cms/HsListFunctionsTool.js +15 -14
  373. package/mcp-server/tools/cms/HsListTool.d.ts +5 -3
  374. package/mcp-server/tools/cms/HsListTool.js +14 -16
  375. package/mcp-server/tools/index.d.ts +3 -2
  376. package/mcp-server/tools/index.js +28 -22
  377. package/mcp-server/tools/project/AddFeatureToProjectTool.d.ts +8 -5
  378. package/mcp-server/tools/project/AddFeatureToProjectTool.js +38 -37
  379. package/mcp-server/tools/project/AuthAccountTool.d.ts +18 -0
  380. package/mcp-server/tools/project/AuthAccountTool.js +88 -0
  381. package/mcp-server/tools/project/CreateProjectTool.d.ts +8 -5
  382. package/mcp-server/tools/project/CreateProjectTool.js +33 -20
  383. package/mcp-server/tools/project/CreateTestAccountTool.d.ts +5 -3
  384. package/mcp-server/tools/project/CreateTestAccountTool.js +42 -31
  385. package/mcp-server/tools/project/DeployProjectTool.d.ts +5 -3
  386. package/mcp-server/tools/project/DeployProjectTool.js +23 -17
  387. package/mcp-server/tools/project/DocFetchTool.d.ts +5 -3
  388. package/mcp-server/tools/project/DocFetchTool.js +8 -6
  389. package/mcp-server/tools/project/DocsSearchTool.d.ts +9 -3
  390. package/mcp-server/tools/project/DocsSearchTool.js +39 -15
  391. package/mcp-server/tools/project/FindProjectsTool.d.ts +15 -0
  392. package/mcp-server/tools/project/FindProjectsTool.js +60 -0
  393. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.d.ts +6 -3
  394. package/mcp-server/tools/project/GetApiUsagePatternsByAppIdTool.js +16 -13
  395. package/mcp-server/tools/project/GetApplicationInfoTool.d.ts +6 -3
  396. package/mcp-server/tools/project/GetApplicationInfoTool.js +19 -14
  397. package/mcp-server/tools/project/GetBuildLogsTool.d.ts +5 -3
  398. package/mcp-server/tools/project/GetBuildLogsTool.js +19 -14
  399. package/mcp-server/tools/project/GetBuildStatusTool.d.ts +6 -3
  400. package/mcp-server/tools/project/GetBuildStatusTool.js +58 -15
  401. package/mcp-server/tools/project/GetConfigValuesTool.d.ts +6 -3
  402. package/mcp-server/tools/project/GetConfigValuesTool.js +20 -13
  403. package/mcp-server/tools/project/GuidedWalkthroughTool.d.ts +5 -3
  404. package/mcp-server/tools/project/GuidedWalkthroughTool.js +4 -6
  405. package/mcp-server/tools/project/KnowledgeSearchTool.d.ts +29 -0
  406. package/mcp-server/tools/project/KnowledgeSearchTool.js +79 -0
  407. package/mcp-server/tools/project/UploadProjectTools.d.ts +5 -3
  408. package/mcp-server/tools/project/UploadProjectTools.js +28 -20
  409. package/mcp-server/tools/project/ValidateProjectTool.d.ts +5 -3
  410. package/mcp-server/tools/project/ValidateProjectTool.js +32 -13
  411. package/mcp-server/tools/project/constants.d.ts +4 -2
  412. package/mcp-server/tools/project/constants.js +5 -1
  413. package/mcp-server/types.d.ts +3 -8
  414. package/mcp-server/types.js +1 -13
  415. package/mcp-server/utils/command.d.ts +26 -2
  416. package/mcp-server/utils/command.js +75 -15
  417. package/mcp-server/utils/config.js +6 -0
  418. package/mcp-server/utils/content.d.ts +3 -2
  419. package/mcp-server/utils/content.js +6 -1
  420. package/mcp-server/utils/elicitation.d.ts +9 -0
  421. package/mcp-server/utils/elicitation.js +35 -0
  422. package/mcp-server/utils/json.d.ts +3 -0
  423. package/mcp-server/utils/json.js +29 -0
  424. package/mcp-server/utils/logger.d.ts +13 -0
  425. package/mcp-server/utils/logger.js +59 -0
  426. package/mcp-server/utils/toolUsageTracking.js +28 -11
  427. package/package.json +37 -28
  428. package/types/AccountTargets.d.ts +37 -0
  429. package/types/AccountTargets.js +12 -0
  430. package/types/Link.d.ts +32 -0
  431. package/types/Link.js +5 -0
  432. package/types/LocalDev.d.ts +15 -2
  433. package/types/PackageJson.d.ts +1 -0
  434. package/types/ProjectComponents.d.ts +2 -1
  435. package/types/Projects.d.ts +25 -5
  436. package/types/Prompts.d.ts +1 -0
  437. package/types/Yargs.d.ts +23 -2
  438. package/ui/components/ActionSection.d.ts +1 -1
  439. package/ui/components/InputField.d.ts +1 -1
  440. package/ui/components/SelectInput.d.ts +1 -1
  441. package/ui/components/StatusIcon.d.ts +1 -1
  442. package/ui/components/Table.d.ts +13 -13
  443. package/ui/components/getStarted/GetStartedFlow.d.ts +1 -1
  444. package/ui/components/getStarted/screens/InstallationScreen.d.ts +1 -1
  445. package/ui/components/getStarted/screens/ProjectSetupScreen.d.ts +1 -1
  446. package/ui/components/getStarted/screens/UploadScreen.d.ts +1 -1
  447. package/api/__tests__/migrate.test.d.ts +0 -1
  448. package/api/__tests__/migrate.test.js +0 -199
  449. package/commands/__tests__/account.test.d.ts +0 -1
  450. package/commands/__tests__/account.test.js +0 -69
  451. package/commands/__tests__/auth.test.d.ts +0 -1
  452. package/commands/__tests__/auth.test.js +0 -43
  453. package/commands/__tests__/cms.test.d.ts +0 -1
  454. package/commands/__tests__/cms.test.js +0 -87
  455. package/commands/__tests__/config.test.d.ts +0 -1
  456. package/commands/__tests__/config.test.js +0 -44
  457. package/commands/__tests__/customObject.test.d.ts +0 -1
  458. package/commands/__tests__/customObject.test.js +0 -68
  459. package/commands/__tests__/doctor.test.d.ts +0 -1
  460. package/commands/__tests__/doctor.test.js +0 -132
  461. package/commands/__tests__/feedback.test.d.ts +0 -1
  462. package/commands/__tests__/feedback.test.js +0 -24
  463. package/commands/__tests__/filemanager.test.d.ts +0 -1
  464. package/commands/__tests__/filemanager.test.js +0 -45
  465. package/commands/__tests__/getStarted.test.d.ts +0 -1
  466. package/commands/__tests__/getStarted.test.js +0 -173
  467. package/commands/__tests__/hubdb.test.d.ts +0 -1
  468. package/commands/__tests__/hubdb.test.js +0 -50
  469. package/commands/__tests__/init.test.d.ts +0 -1
  470. package/commands/__tests__/init.test.js +0 -42
  471. package/commands/__tests__/mcp.test.d.ts +0 -1
  472. package/commands/__tests__/mcp.test.js +0 -46
  473. package/commands/__tests__/open.test.d.ts +0 -1
  474. package/commands/__tests__/open.test.js +0 -58
  475. package/commands/__tests__/project.test.d.ts +0 -1
  476. package/commands/__tests__/project.test.js +0 -125
  477. package/commands/__tests__/sandbox.test.d.ts +0 -1
  478. package/commands/__tests__/sandbox.test.js +0 -44
  479. package/commands/__tests__/secret.test.d.ts +0 -1
  480. package/commands/__tests__/secret.test.js +0 -49
  481. package/commands/__tests__/testAccount.test.d.ts +0 -1
  482. package/commands/__tests__/testAccount.test.js +0 -57
  483. package/commands/__tests__/upgrade.test.d.ts +0 -1
  484. package/commands/__tests__/upgrade.test.js +0 -309
  485. package/commands/account/__tests__/auth.test.d.ts +0 -1
  486. package/commands/account/__tests__/auth.test.js +0 -206
  487. package/commands/account/__tests__/clean.test.d.ts +0 -1
  488. package/commands/account/__tests__/clean.test.js +0 -28
  489. package/commands/account/__tests__/createOverride.test.d.ts +0 -1
  490. package/commands/account/__tests__/createOverride.test.js +0 -32
  491. package/commands/account/__tests__/info.test.d.ts +0 -1
  492. package/commands/account/__tests__/info.test.js +0 -28
  493. package/commands/account/__tests__/list.test.d.ts +0 -1
  494. package/commands/account/__tests__/list.test.js +0 -153
  495. package/commands/account/__tests__/remove.test.d.ts +0 -1
  496. package/commands/account/__tests__/remove.test.js +0 -36
  497. package/commands/account/__tests__/removeOverride.d.ts +0 -1
  498. package/commands/account/__tests__/removeOverride.js +0 -25
  499. package/commands/account/__tests__/rename.test.d.ts +0 -1
  500. package/commands/account/__tests__/rename.test.js +0 -82
  501. package/commands/account/__tests__/use.test.d.ts +0 -1
  502. package/commands/account/__tests__/use.test.js +0 -170
  503. package/commands/app/__tests__/migrate.test.d.ts +0 -1
  504. package/commands/app/__tests__/migrate.test.js +0 -111
  505. package/commands/app/secret/__tests__/add.test.d.ts +0 -1
  506. package/commands/app/secret/__tests__/add.test.js +0 -140
  507. package/commands/app/secret/__tests__/delete.test.d.ts +0 -1
  508. package/commands/app/secret/__tests__/delete.test.js +0 -28
  509. package/commands/app/secret/__tests__/list.test.d.ts +0 -1
  510. package/commands/app/secret/__tests__/list.test.js +0 -25
  511. package/commands/app/secret/__tests__/update.test.d.ts +0 -1
  512. package/commands/app/secret/__tests__/update.test.js +0 -28
  513. package/commands/cms/__tests__/delete.test.d.ts +0 -1
  514. package/commands/cms/__tests__/delete.test.js +0 -39
  515. package/commands/cms/__tests__/fetch.test.d.ts +0 -1
  516. package/commands/cms/__tests__/fetch.test.js +0 -156
  517. package/commands/cms/__tests__/function.test.d.ts +0 -1
  518. package/commands/cms/__tests__/function.test.js +0 -50
  519. package/commands/cms/__tests__/lint.test.d.ts +0 -1
  520. package/commands/cms/__tests__/lint.test.js +0 -33
  521. package/commands/cms/__tests__/list.test.d.ts +0 -1
  522. package/commands/cms/__tests__/list.test.js +0 -42
  523. package/commands/cms/__tests__/module.test.d.ts +0 -1
  524. package/commands/cms/__tests__/module.test.js +0 -45
  525. package/commands/cms/__tests__/mv.test.d.ts +0 -1
  526. package/commands/cms/__tests__/mv.test.js +0 -46
  527. package/commands/cms/__tests__/theme.test.d.ts +0 -1
  528. package/commands/cms/__tests__/theme.test.js +0 -54
  529. package/commands/cms/__tests__/upload.test.d.ts +0 -1
  530. package/commands/cms/__tests__/upload.test.js +0 -312
  531. package/commands/cms/__tests__/watch.test.d.ts +0 -1
  532. package/commands/cms/__tests__/watch.test.js +0 -204
  533. package/commands/cms/function/__tests__/logs.test.d.ts +0 -1
  534. package/commands/cms/function/__tests__/logs.test.js +0 -70
  535. package/commands/cms/theme/__tests__/generate-selectors.test.d.ts +0 -1
  536. package/commands/cms/theme/__tests__/generate-selectors.test.js +0 -28
  537. package/commands/cms/theme/__tests__/marketplace-validate.test.d.ts +0 -1
  538. package/commands/cms/theme/__tests__/marketplace-validate.test.js +0 -36
  539. package/commands/cms/theme/__tests__/preview.test.d.ts +0 -1
  540. package/commands/cms/theme/__tests__/preview.test.js +0 -54
  541. package/commands/customObject/__tests__/create.test.d.ts +0 -1
  542. package/commands/customObject/__tests__/create.test.js +0 -40
  543. package/commands/customObject/__tests__/createSchema.test.d.ts +0 -1
  544. package/commands/customObject/__tests__/createSchema.test.js +0 -28
  545. package/commands/customObject/__tests__/deleteSchema.test.d.ts +0 -1
  546. package/commands/customObject/__tests__/deleteSchema.test.js +0 -42
  547. package/commands/customObject/__tests__/fetch-all-schemas.test.d.ts +0 -1
  548. package/commands/customObject/__tests__/fetch-all-schemas.test.js +0 -41
  549. package/commands/customObject/__tests__/fetchSchema.test.d.ts +0 -1
  550. package/commands/customObject/__tests__/fetchSchema.test.js +0 -45
  551. package/commands/customObject/__tests__/listSchemas.test.d.ts +0 -1
  552. package/commands/customObject/__tests__/listSchemas.test.js +0 -29
  553. package/commands/customObject/__tests__/updateSchema.test.d.ts +0 -1
  554. package/commands/customObject/__tests__/updateSchema.test.js +0 -40
  555. package/commands/filemanager/__tests__/fetch.test.d.ts +0 -1
  556. package/commands/filemanager/__tests__/fetch.test.js +0 -32
  557. package/commands/filemanager/__tests__/upload.test.d.ts +0 -1
  558. package/commands/filemanager/__tests__/upload.test.js +0 -191
  559. package/commands/hubdb/__tests__/clear.test.d.ts +0 -1
  560. package/commands/hubdb/__tests__/clear.test.js +0 -28
  561. package/commands/hubdb/__tests__/create.test.d.ts +0 -1
  562. package/commands/hubdb/__tests__/create.test.js +0 -28
  563. package/commands/hubdb/__tests__/delete.test.d.ts +0 -1
  564. package/commands/hubdb/__tests__/delete.test.js +0 -28
  565. package/commands/hubdb/__tests__/fetch.test.d.ts +0 -1
  566. package/commands/hubdb/__tests__/fetch.test.js +0 -28
  567. package/commands/hubdb/__tests__/list.test.d.ts +0 -1
  568. package/commands/hubdb/__tests__/list.test.js +0 -88
  569. package/commands/mcp/__tests__/setup.test.d.ts +0 -1
  570. package/commands/mcp/__tests__/setup.test.js +0 -26
  571. package/commands/mcp/__tests__/start.test.d.ts +0 -1
  572. package/commands/mcp/__tests__/start.test.js +0 -144
  573. package/commands/project/__tests__/add.test.d.ts +0 -1
  574. package/commands/project/__tests__/add.test.js +0 -107
  575. package/commands/project/__tests__/create.test.d.ts +0 -1
  576. package/commands/project/__tests__/create.test.js +0 -97
  577. package/commands/project/__tests__/deploy.test.d.ts +0 -1
  578. package/commands/project/__tests__/deploy.test.js +0 -307
  579. package/commands/project/__tests__/dev.test.d.ts +0 -1
  580. package/commands/project/__tests__/dev.test.js +0 -273
  581. package/commands/project/__tests__/devUnifiedFlow.test.d.ts +0 -1
  582. package/commands/project/__tests__/devUnifiedFlow.test.js +0 -434
  583. package/commands/project/__tests__/download.test.d.ts +0 -1
  584. package/commands/project/__tests__/download.test.js +0 -39
  585. package/commands/project/__tests__/installDeps.test.d.ts +0 -1
  586. package/commands/project/__tests__/installDeps.test.js +0 -140
  587. package/commands/project/__tests__/lint.test.d.ts +0 -1
  588. package/commands/project/__tests__/lint.test.js +0 -704
  589. package/commands/project/__tests__/list.test.d.ts +0 -1
  590. package/commands/project/__tests__/list.test.js +0 -31
  591. package/commands/project/__tests__/listBuilds.test.d.ts +0 -1
  592. package/commands/project/__tests__/listBuilds.test.js +0 -38
  593. package/commands/project/__tests__/logs.test.d.ts +0 -1
  594. package/commands/project/__tests__/logs.test.js +0 -202
  595. package/commands/project/__tests__/migrate.test.d.ts +0 -1
  596. package/commands/project/__tests__/migrate.test.js +0 -106
  597. package/commands/project/__tests__/open.test.d.ts +0 -1
  598. package/commands/project/__tests__/open.test.js +0 -39
  599. package/commands/project/__tests__/profile.test.d.ts +0 -1
  600. package/commands/project/__tests__/profile.test.js +0 -42
  601. package/commands/project/__tests__/updateDeps.test.d.ts +0 -1
  602. package/commands/project/__tests__/updateDeps.test.js +0 -140
  603. package/commands/project/__tests__/upload.test.d.ts +0 -1
  604. package/commands/project/__tests__/upload.test.js +0 -234
  605. package/commands/project/__tests__/validate.test.d.ts +0 -1
  606. package/commands/project/__tests__/validate.test.js +0 -381
  607. package/commands/project/__tests__/watch.test.d.ts +0 -1
  608. package/commands/project/__tests__/watch.test.js +0 -35
  609. package/commands/project/dev/deprecatedFlow.d.ts +0 -11
  610. package/commands/project/dev/deprecatedFlow.js +0 -135
  611. package/commands/sandbox/__tests__/create.test.d.ts +0 -1
  612. package/commands/sandbox/__tests__/create.test.js +0 -198
  613. package/commands/sandbox/__tests__/delete.test.d.ts +0 -1
  614. package/commands/sandbox/__tests__/delete.test.js +0 -31
  615. package/commands/secret/__tests__/addSecret.test.d.ts +0 -1
  616. package/commands/secret/__tests__/addSecret.test.js +0 -162
  617. package/commands/secret/__tests__/deleteSecret.test.d.ts +0 -1
  618. package/commands/secret/__tests__/deleteSecret.test.js +0 -41
  619. package/commands/secret/__tests__/listSecret.test.d.ts +0 -1
  620. package/commands/secret/__tests__/listSecret.test.js +0 -29
  621. package/commands/secret/__tests__/updateSecret.test.d.ts +0 -1
  622. package/commands/secret/__tests__/updateSecret.test.js +0 -29
  623. package/commands/testAccount/__tests__/create.test.d.ts +0 -1
  624. package/commands/testAccount/__tests__/create.test.js +0 -106
  625. package/commands/testAccount/__tests__/createConfig.test.d.ts +0 -1
  626. package/commands/testAccount/__tests__/createConfig.test.js +0 -32
  627. package/commands/testAccount/__tests__/delete.test.d.ts +0 -1
  628. package/commands/testAccount/__tests__/delete.test.js +0 -29
  629. package/commands/testAccount/__tests__/importData.test.d.ts +0 -1
  630. package/commands/testAccount/__tests__/importData.test.js +0 -92
  631. package/lib/__tests__/CLIWebSocketServer.test.d.ts +0 -1
  632. package/lib/__tests__/CLIWebSocketServer.test.js +0 -252
  633. package/lib/__tests__/accountAuth.test.d.ts +0 -1
  634. package/lib/__tests__/accountAuth.test.js +0 -258
  635. package/lib/__tests__/accountTypes.test.d.ts +0 -1
  636. package/lib/__tests__/accountTypes.test.js +0 -98
  637. package/lib/__tests__/buildAccount.test.d.ts +0 -1
  638. package/lib/__tests__/buildAccount.test.js +0 -211
  639. package/lib/__tests__/cliUpgradeUtils.test.d.ts +0 -1
  640. package/lib/__tests__/cliUpgradeUtils.test.js +0 -131
  641. package/lib/__tests__/commandSuggestion.test.d.ts +0 -1
  642. package/lib/__tests__/commandSuggestion.test.js +0 -121
  643. package/lib/__tests__/commonOpts.test.d.ts +0 -1
  644. package/lib/__tests__/commonOpts.test.js +0 -80
  645. package/lib/__tests__/dependencyManagement.test.d.ts +0 -1
  646. package/lib/__tests__/dependencyManagement.test.js +0 -1067
  647. package/lib/__tests__/developerTestAccounts.test.d.ts +0 -1
  648. package/lib/__tests__/developerTestAccounts.test.js +0 -156
  649. package/lib/__tests__/hasFeature.test.d.ts +0 -1
  650. package/lib/__tests__/hasFeature.test.js +0 -167
  651. package/lib/__tests__/http.test.d.ts +0 -1
  652. package/lib/__tests__/http.test.js +0 -40
  653. package/lib/__tests__/importData.test.d.ts +0 -1
  654. package/lib/__tests__/importData.test.js +0 -98
  655. package/lib/__tests__/npmCli.test.d.ts +0 -1
  656. package/lib/__tests__/npmCli.test.js +0 -84
  657. package/lib/__tests__/oauth.test.d.ts +0 -1
  658. package/lib/__tests__/oauth.test.js +0 -109
  659. package/lib/__tests__/parsing.test.d.ts +0 -1
  660. package/lib/__tests__/parsing.test.js +0 -34
  661. package/lib/__tests__/polling.test.d.ts +0 -1
  662. package/lib/__tests__/polling.test.js +0 -76
  663. package/lib/__tests__/process.test.d.ts +0 -1
  664. package/lib/__tests__/process.test.js +0 -89
  665. package/lib/__tests__/sandboxes.test.d.ts +0 -1
  666. package/lib/__tests__/sandboxes.test.js +0 -128
  667. package/lib/__tests__/serverlessLogs.test.d.ts +0 -1
  668. package/lib/__tests__/serverlessLogs.test.js +0 -163
  669. package/lib/__tests__/usageTracking.test.d.ts +0 -1
  670. package/lib/__tests__/usageTracking.test.js +0 -197
  671. package/lib/__tests__/validation.test.d.ts +0 -1
  672. package/lib/__tests__/validation.test.js +0 -143
  673. package/lib/__tests__/yargsUtils.test.d.ts +0 -1
  674. package/lib/__tests__/yargsUtils.test.js +0 -124
  675. package/lib/app/__tests__/migrate.test.d.ts +0 -1
  676. package/lib/app/__tests__/migrate.test.js +0 -638
  677. package/lib/doctor/__tests__/Diagnosis.test.d.ts +0 -1
  678. package/lib/doctor/__tests__/Diagnosis.test.js +0 -84
  679. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.d.ts +0 -1
  680. package/lib/doctor/__tests__/DiagnosticInfoBuilder.test.js +0 -177
  681. package/lib/doctor/__tests__/Doctor.test.d.ts +0 -1
  682. package/lib/doctor/__tests__/Doctor.test.js +0 -560
  683. package/lib/errorHandlers/__tests__/index.test.d.ts +0 -1
  684. package/lib/errorHandlers/__tests__/index.test.js +0 -278
  685. package/lib/mcp/__tests__/setup.test.d.ts +0 -1
  686. package/lib/mcp/__tests__/setup.test.js +0 -523
  687. package/lib/middleware/__tests__/commandTargetingUtils.test.d.ts +0 -1
  688. package/lib/middleware/__tests__/commandTargetingUtils.test.js +0 -99
  689. package/lib/middleware/__tests__/configMiddleware.test.d.ts +0 -1
  690. package/lib/middleware/__tests__/configMiddleware.test.js +0 -118
  691. package/lib/middleware/__tests__/gitMiddleware.test.d.ts +0 -1
  692. package/lib/middleware/__tests__/gitMiddleware.test.js +0 -43
  693. package/lib/middleware/__tests__/requestMiddleware.test.d.ts +0 -1
  694. package/lib/middleware/__tests__/requestMiddleware.test.js +0 -15
  695. package/lib/middleware/__tests__/usageTrackingMiddleware.test.d.ts +0 -1
  696. package/lib/middleware/__tests__/usageTrackingMiddleware.test.js +0 -44
  697. package/lib/middleware/__tests__/yargsChecksMiddleware.test.d.ts +0 -1
  698. package/lib/middleware/__tests__/yargsChecksMiddleware.test.js +0 -39
  699. package/lib/projects/__tests__/AppDevModeInterface.test.d.ts +0 -1
  700. package/lib/projects/__tests__/AppDevModeInterface.test.js +0 -541
  701. package/lib/projects/__tests__/DevServerManager.test.d.ts +0 -1
  702. package/lib/projects/__tests__/DevServerManager.test.js +0 -185
  703. package/lib/projects/__tests__/DevSessionManager.test.d.ts +0 -1
  704. package/lib/projects/__tests__/DevSessionManager.test.js +0 -250
  705. package/lib/projects/__tests__/LocalDevProcess.test.d.ts +0 -1
  706. package/lib/projects/__tests__/LocalDevProcess.test.js +0 -481
  707. package/lib/projects/__tests__/LocalDevWebsocketServer.test.d.ts +0 -1
  708. package/lib/projects/__tests__/LocalDevWebsocketServer.test.js +0 -231
  709. package/lib/projects/__tests__/ProjectLogsManager.test.d.ts +0 -1
  710. package/lib/projects/__tests__/ProjectLogsManager.test.js +0 -302
  711. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.d.ts +0 -1
  712. package/lib/projects/__tests__/UIExtensionsDevModeInterface.test.js +0 -160
  713. package/lib/projects/__tests__/components.test.d.ts +0 -1
  714. package/lib/projects/__tests__/components.test.js +0 -440
  715. package/lib/projects/__tests__/deploy.test.d.ts +0 -1
  716. package/lib/projects/__tests__/deploy.test.js +0 -231
  717. package/lib/projects/__tests__/localDevProjectHelpers.test.d.ts +0 -1
  718. package/lib/projects/__tests__/localDevProjectHelpers.test.js +0 -120
  719. package/lib/projects/__tests__/platformVersion.test.d.ts +0 -1
  720. package/lib/projects/__tests__/platformVersion.test.js +0 -63
  721. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.d.ts +0 -1
  722. package/lib/projects/__tests__/pollProjectBuildAndDeploy.test.js +0 -328
  723. package/lib/projects/__tests__/projectProfiles.test.d.ts +0 -1
  724. package/lib/projects/__tests__/projectProfiles.test.js +0 -441
  725. package/lib/projects/__tests__/projects.test.d.ts +0 -1
  726. package/lib/projects/__tests__/projects.test.js +0 -58
  727. package/lib/projects/__tests__/structure.test.d.ts +0 -1
  728. package/lib/projects/__tests__/structure.test.js +0 -210
  729. package/lib/projects/__tests__/uieLinting.test.d.ts +0 -1
  730. package/lib/projects/__tests__/uieLinting.test.js +0 -631
  731. package/lib/projects/__tests__/upload.test.d.ts +0 -1
  732. package/lib/projects/__tests__/upload.test.js +0 -183
  733. package/lib/projects/add/__tests__/legacyAddComponent.test.d.ts +0 -1
  734. package/lib/projects/add/__tests__/legacyAddComponent.test.js +0 -245
  735. package/lib/projects/add/__tests__/v2AddComponent.test.d.ts +0 -1
  736. package/lib/projects/add/__tests__/v2AddComponent.test.js +0 -343
  737. package/lib/projects/create/__tests__/legacy.test.d.ts +0 -1
  738. package/lib/projects/create/__tests__/legacy.test.js +0 -72
  739. package/lib/projects/create/__tests__/v2.test.d.ts +0 -1
  740. package/lib/projects/create/__tests__/v2.test.js +0 -257
  741. package/lib/projects/localDev/DevServerManager_DEPRECATED.d.ts +0 -40
  742. package/lib/projects/localDev/DevServerManager_DEPRECATED.js +0 -128
  743. package/lib/projects/localDev/LocalDevManager_DEPRECATED.d.ts +0 -59
  744. package/lib/projects/localDev/LocalDevManager_DEPRECATED.js +0 -387
  745. package/lib/projects/platformVersion.d.ts +0 -9
  746. package/lib/projects/platformVersion.js +0 -39
  747. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.d.ts +0 -1
  748. package/lib/prompts/__tests__/createDeveloperTestAccountConfigPrompt.test.js +0 -157
  749. package/lib/prompts/__tests__/createFunctionPrompt.test.d.ts +0 -1
  750. package/lib/prompts/__tests__/createFunctionPrompt.test.js +0 -129
  751. package/lib/prompts/__tests__/createModulePrompt.test.d.ts +0 -1
  752. package/lib/prompts/__tests__/createModulePrompt.test.js +0 -187
  753. package/lib/prompts/__tests__/createTemplatePrompt.test.d.ts +0 -1
  754. package/lib/prompts/__tests__/createTemplatePrompt.test.js +0 -102
  755. package/lib/prompts/__tests__/downloadProjectPrompt.test.d.ts +0 -1
  756. package/lib/prompts/__tests__/downloadProjectPrompt.test.js +0 -31
  757. package/lib/prompts/__tests__/projectAddPrompt.test.d.ts +0 -1
  758. package/lib/prompts/__tests__/projectAddPrompt.test.js +0 -143
  759. package/lib/prompts/__tests__/projectsLogsPrompt.test.d.ts +0 -1
  760. package/lib/prompts/__tests__/projectsLogsPrompt.test.js +0 -37
  761. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.d.ts +0 -1
  762. package/lib/prompts/__tests__/selectProjectTemplatePrompt.test.js +0 -160
  763. package/lib/theme/__tests__/migrate.test.d.ts +0 -1
  764. package/lib/theme/__tests__/migrate.test.js +0 -247
  765. package/lib/ui/__tests__/SpinniesManager.test.d.ts +0 -1
  766. package/lib/ui/__tests__/SpinniesManager.test.js +0 -488
  767. package/lib/ui/__tests__/removeAnsiCodes.test.d.ts +0 -1
  768. package/lib/ui/__tests__/removeAnsiCodes.test.js +0 -84
  769. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.d.ts +0 -1
  770. package/mcp-server/tools/cms/__tests__/HsCreateFunctionTool.test.js +0 -254
  771. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.d.ts +0 -1
  772. package/mcp-server/tools/cms/__tests__/HsCreateModuleTool.test.js +0 -227
  773. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.d.ts +0 -1
  774. package/mcp-server/tools/cms/__tests__/HsCreateTemplateTool.test.js +0 -208
  775. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.d.ts +0 -1
  776. package/mcp-server/tools/cms/__tests__/HsFunctionLogsTool.test.js +0 -186
  777. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.d.ts +0 -1
  778. package/mcp-server/tools/cms/__tests__/HsListFunctionsTool.test.js +0 -124
  779. package/mcp-server/tools/cms/__tests__/HsListTool.test.d.ts +0 -1
  780. package/mcp-server/tools/cms/__tests__/HsListTool.test.js +0 -124
  781. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.d.ts +0 -1
  782. package/mcp-server/tools/project/__tests__/AddFeatureToProjectTool.test.js +0 -157
  783. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.d.ts +0 -1
  784. package/mcp-server/tools/project/__tests__/CreateProjectTool.test.js +0 -131
  785. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.d.ts +0 -1
  786. package/mcp-server/tools/project/__tests__/CreateTestAccountTool.test.js +0 -461
  787. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.d.ts +0 -1
  788. package/mcp-server/tools/project/__tests__/DeployProjectTool.test.js +0 -125
  789. package/mcp-server/tools/project/__tests__/DocFetchTool.test.d.ts +0 -1
  790. package/mcp-server/tools/project/__tests__/DocFetchTool.test.js +0 -125
  791. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.d.ts +0 -1
  792. package/mcp-server/tools/project/__tests__/DocsSearchTool.test.js +0 -210
  793. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.d.ts +0 -1
  794. package/mcp-server/tools/project/__tests__/GetApiUsagePatternsByAppIdTool.test.js +0 -146
  795. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.d.ts +0 -1
  796. package/mcp-server/tools/project/__tests__/GetApplicationInfoTool.test.js +0 -124
  797. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.d.ts +0 -1
  798. package/mcp-server/tools/project/__tests__/GetBuildLogsTool.test.js +0 -307
  799. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.d.ts +0 -1
  800. package/mcp-server/tools/project/__tests__/GetBuildStatusTool.test.js +0 -242
  801. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.d.ts +0 -1
  802. package/mcp-server/tools/project/__tests__/GetConfigValuesTool.test.js +0 -209
  803. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.d.ts +0 -1
  804. package/mcp-server/tools/project/__tests__/GuidedWalkthroughTool.test.js +0 -158
  805. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.d.ts +0 -1
  806. package/mcp-server/tools/project/__tests__/UploadProjectTools.test.js +0 -187
  807. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.d.ts +0 -1
  808. package/mcp-server/tools/project/__tests__/ValidateProjectTool.test.js +0 -118
  809. package/mcp-server/utils/__tests__/command.test.d.ts +0 -1
  810. package/mcp-server/utils/__tests__/command.test.js +0 -275
  811. package/mcp-server/utils/__tests__/content.test.d.ts +0 -1
  812. package/mcp-server/utils/__tests__/content.test.js +0 -164
  813. package/mcp-server/utils/__tests__/feedbackTracking.test.d.ts +0 -1
  814. 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".');